ColdBox HMVC Documentation
Master ClassVideo TrainingCommunitySupport
Search…
6.x
Introduction
Intro
Release History
About This Book
Author
For Newbies
60 Minute Quick Start
Getting Started
Getting Started Guide
Installation
Conventions
Configuration
The Basics
Request Context
Routing
Event Handlers
Layouts & Views
Models
Interceptors
HMVC
Modules
Testing
Testing Quick Start
Testing ColdBox Applications
Test Harness
ColdBox Testing Classes
Common Testing Methods
Integration Testing
Interceptor Testing
Model Object Testing
Tips & Tricks
Digging Deeper
Async Programming
ColdBox Proxy
Controller Decorator
Flash RAM
HTML Helper
REST Handler
Request Context Decorator
Recipes
Scheduled Tasks
Architecture Concepts
What is MVC
What is ColdBox
How ColdBox Works
Testing Concepts
External links
Source code
Issue tracker
LogBox
CacheBox
WireBox
Powered By GitBook
Testing ColdBox Applications
One of the best things you can do when you develop software applications is TEST! I know nobody likes it, but hey, you need to do it right? With the advocation of frameworks today, you get all these great tools to build your software applications, but how do you test your framework code. ColdBox has revolutionized testing HMVC and framework code, since you can unit test your event handlers, interceptors, model objects and even do integration testing and true BDD (Behavior Driven Development) and test your entire application with no browser at all.
ColdBox has already all the hooks in place to provide Behavior and Test Driven Development via TestBox and mocking/stubbing capabilities via MockBox.
TestBox is a testing framework for ColdFusion (CFML) that is based on BDD (Behavior Driven Development) for providing a clean obvious syntax for writing tests. It also includes MockBox for mocking and stubbing.
TestBox is included with all ColdBox templates.

Installing TestBox

TestBox already comes defined in the box.json of all ColdBox application templates. However, if you have a custom ColdBox app or a custom template, then you can easily install it via CommandBox:
// stable
install testbox --saveDev
​
// bleeding edge
install [email protected] --saveDev
The --saveDev flag tells CommandBox to save TestBox locally only for testing purposes as it will not be used to send TestBox for production (http://commandbox.ortusbooks.com/content/packages/dependencies.html)
Please also note that CommandBox ships with tons of commands for interacting with TestBox and ColdBox testing classes. You can explore them by issuing the following commands or viewing the latest CommandBox API Docs (http://apidocs.ortussolutions.com/commandbox/current)
# testbox namespace help
testbox help
​
# generations
testbox create help
​
# run tests
testbox run help
​
# Watch your files and execute the tests if they change
testbox watch
​
# coldbox creation help
coldbox create help

Benefits

It might be that testing is tedious and takes time to get into the flow of Behavior/Test Driven Development. However, there are incredible benefits to testing:
  • Can improve code quality
  • Quick error discovery
  • Code confidence via immediate verification
  • Can expose high coupling
  • Encourages refactoring to produce testable code
  • Testing is all about behavior and expectations
Our recommendation is to do BDD and integration testing first. Unit testing is important but it is more important to verify that your requirements are met.

Resources

Testing - Previous
Testing Quick Start
Next
Test Harness
Last modified 3yr ago
Copy link
Edit on GitHub
Outline
Installing TestBox
Benefits
Resources