The Dojo Test Stack is a collection of JavaScript modules designed to work together to help you write consistent, high-quality test cases for your JavaScript libraries and applications.
No! Dojo Test Stack uses Dojo but can be used to test any JavaScript code. Its functional testing interface can even be used to test non-JavaScript Web apps if you really want.
This repository is an experimental repository for the next major version of the Dojo Toolkit. Please feel free to start using it as long as you can put up with some API churn until it reaches alpha.
If you need to support IE 6–8, there is also a version of teststack for legacy browsers, but please, for the sake of the kittens, stop supporting those browsers already.
- 100% AMD, 100% Promises/A-based API
- Instant one-off test execution in the browser or Node.js
- Full statement, branch, function, and line code coverage reporting with Istanbul
- Functional testing using the standard WebDriver API with a fluid, promises-wrapped WD.js
- Integration with Sauce Labs for super simple continuous integration
- Tested with Travis CI
- Extensible interfaces (comes with TDD, BDD, and objects)
- Extensible reporters (comes with basic console and WebDriver reporters, lcov and tap output planned)
- Extensible assertions using the Chai Assertion Library
| Feature | Test Stack | QUnit | Mocha | Jasmine | BusterJS | Karma |
|---|---|---|---|---|---|---|
| Code coverage analysis | Yes | No | Yes | No | Extension | Yes |
| True1 browser events | Yes | No | No | No | No | No |
| Native AMD support | Yes | No | No | No | Extension | Extension |
| Stand-alone2 browser support | Yes | Yes | Build required | Build required | No | No |
| Node.js support | Yes | No3 | Yes | Yes | Yes | Yes |
| Any4 assertion library | Yes | No | Yes | No | Yes | N/A |
| Default test interface | TDD, BDD, object | TDD | TDD, BDD, object | BDD | xUnit | N/A |
| Extensible test interfaces | Yes | No | Yes | No | Yes | N/A |
| Extensible reporters | Yes | No | Yes | No | Yes | N/A |
| Asynchronous support | Promises | Globals | Callbacks | Polling | Callbacks | Callbacks |
| Selenium support | Yes | No | No | No | No | No |
| Built-in CI support | Yes | No | No | No | Yes | Yes |
| Built-in Sauce Labs integration | Yes | No | No | No | No | No |
| Built-in Travis CI integration | Yes | No | No | No | No | Yes |
| Grunt support | Yes | 3rd party | 3rd party | 3rd party | 3rd party | 3rd party |
1: True events are not generated by JavaScript within the sandbox, so are able to accurately emulate how a user actually interacts with the application. Synthetic events generated by other test frameworks are limited by browser security restrictions.
2: Stand-alone means that unit tests can be executed in a browser by navigating to a URL without needing any special HTTP server or proxy for support.
3: Some older versions of QUnit can be used in conjunction with a 3rd party module to run on Node.js, but newer versions do not support Node.js and will break even with the use of 3rd party modules.
4: If it throws an error on failure, it works with Test Stack.
dojo2-teststack currently comes with support for 3 different test interface: TDD, BDD, and object. Internally, all interfaces generate the same testing structures, so you can use whichever interface you feel matches your preference.
TDD tests using the Chai Assert API look like this:
define([
'teststack!tdd',
'teststack/chai!assert',
'../Request'
], function (tdd, assert, Request) {
with (tdd) {
suite('demo', function () {
var request,
url = 'https://github.com/csnover/dojo2-teststack';
// before the suite starts
before(function () {
request = new Request();
});
// before each test executes
beforeEach(function () {
request.reset();
});
// after the suite is done
after(function () {
request.cleanup();
});
// multiple methods can be registered and will be executed in order of registration
after(function () {
if (!request.cleaned) {
throw new Error('Request should have been cleaned up after suite execution.');
}
// these methods can be made asynchronous as well by returning a promise
});
// asynchronous test for Promises/A-based interfaces
test('#getUrl (async)', function () {
// `getUrl` returns a promise
return request.getUrl(url).then(function (result) {
assert.equal(result.url, url, 'Result URL should be requested URL');
assert.isTrue(result.data.indexOf('next-generation') > -1, 'Result data should contain term "next-generation"');
});
});
// asynchronous test for callback-based interfaces
test('#getUrlCallback (async)', function () {
// test will time out after 1 second
var dfd = this.async(1000);
// dfd.callback resolves the promise as long as no errors are thrown from within the callback function
request.getUrlCallback(url, dfd.callback(function () {
assert.equal(result.url, url, 'Result URL should be requested URL');
assert.isTrue(result.data.indexOf('next-generation') > -1, 'Result data should contain term "next-generation"');
});
// no need to return the promise; calling `async` makes the test async
});
// nested suites work too
suite('xhr', function () {
// synchronous test
test('sanity check', function () {
assert.ok(request.xhr, 'XHR interface should exist on `xhr` property');
});
});
});
}
});BDD tests using the Chai Expect API:
define([
'teststack!bdd',
'teststack/chai!expect',
'../Request'
], function (bdd, expect, Request) {
with (bdd) {
describe('demo', function () {
var request,
url = 'https://github.com/csnover/dojo2-teststack';
// before the suite starts
before(function () {
request = new Request();
});
// before each test executes
beforeEach(function () {
request.reset();
});
// after the suite is done
after(function () {
request.cleanup();
});
// multiple methods can be registered and will be executed in order of registration
after(function () {
if (!request.cleaned) {
throw new Error('Request should have been cleaned up after suite execution.');
}
// these methods can be made asynchronous as well by returning a promise
});
// asynchronous test for Promises/A-based interfaces
it('should demonstrate a Promises/A-based asynchronous test', function () {
// `getUrl` returns a promise
return request.getUrl(url).then(function (result) {
expect(result.url).to.equal(url);
expect(result.data.indexOf('next-generation') > -1).to.be.true;
});
});
// asynchronous test for callback-based interfaces
it('should demonstrate a callback-based asynchronous test', function () {
// test will time out after 1 second
var dfd = this.async(1000);
// dfd.callback resolves the promise as long as no errors are thrown from within the callback function
request.getUrlCallback(url, dfd.callback(function () {
expect(result.url).to.equal(url);
expect(result.data.indexOf('next-generation') > -1).to.be.true;
});
// no need to return the promise; calling `async` makes the test async
});
// nested suites work too
describe('xhr', function () {
// synchronous test
it('should run a synchronous test', function () {
expect(request.xhr).to.exist;
});
});
});
}
});Object tests using the Chai Assert API:
define([
'teststack!object',
'teststack/chai!assert',
'../Request'
], function (registerSuite, assert, Request) {
var request,
url = 'https://github.com/csnover/dojo2-teststack';
registerSuite({
name: 'demo',
// before the suite starts
before: function () {
request = new Request();
},
// before each test executes
beforeEach: function () {
request.reset();
},
// after the suite is done
after: function () {
request.cleanup();
if (!request.cleaned) {
throw new Error('Request should have been cleaned up after suite execution.');
}
},
// asynchronous test for Promises/A-based interfaces
'#getUrl (async)': function () {
// `getUrl` returns a promise
return request.getUrl(url).then(function (result) {
assert.equal(result.url, url, 'Result URL should be requested URL');
assert.isTrue(result.data.indexOf('next-generation') > -1, 'Result data should contain term "next-generation"');
});
},
// asynchronous test for callback-based interfaces
'#getUrlCallback (async)': function () {
// test will time out after 1 second
var dfd = this.async(1000);
// dfd.callback resolves the promise as long as no errors are thrown from within the callback function
request.getUrlCallback(url, dfd.callback(function () {
assert.equal(result.url, url, 'Result URL should be requested URL');
assert.isTrue(result.data.indexOf('next-generation') > -1, 'Result data should contain term "next-generation"');
});
// no need to return the promise; calling `async` makes the test async
},
// nested suites work too
'xhr': {
// synchronous test
'sanity check': function () {
assert.ok(request.xhr, 'XHR interface should exist on `xhr` property');
}
}
});
});Functional tests are slightly different from normal unit tests because they are executed remotely from the test runner, whereas unit tests are executed directly on the browser under test.
define([
'teststack!object',
'teststack/chai!assert',
'../Request',
'require'
], function (registerSuite, assert, Request, require) {
var request,
url = 'https://github.com/csnover/dojo2-teststack';
registerSuite({
name: 'demo',
'submit form': function () {
return this.remote
.get(require.toUrl('./fixture.html'))
.elementById('operation')
.click()
.type('hello, world')
.end()
.elementById('submit')
.click()
.end()
.waitForElementById('result')
.text()
.then(function (resultText) {
assert.ok(resultText.indexOf('"hello, world" completed successfully') > -1, 'When form is submitted, operation should complete successfully');
});
}
});
});More details on each API can be found in the Wiki.
First:
git clone --recursive https://github.com/csnover/dojo2-teststack.gitas a sibling directory of the package you want to testnpm install --productionfrom thedojo2-teststackdirectory
Then, for a stand-alone browser client:
- Navigate to
http://path/to/dojo2-teststack/client.html?config=mid/of/teststack/config - View console
- Fix bugs
Or, for a stand-alone Node.js client:
- Run
node client.js config=mid/of/teststack/config - View console
- Fix bugs
When running clients directly, you can specify a reporter and one or more suites options to override the options
in the configuration file:
Browser: http://path/to/dojo2-teststack/client.html?config=mid/of/teststack/config&suites=mid/of/suite/a&suites=mid/of/suite/b&reporter=mid/of/custom/reporter
CLI: node client.js config=mid/of/teststack/config suites=mid/of/suite/a suites=mid/of/suite/b reporter=mid/of/custom/reporter
Or, as an amazing fully-featured automated test runner:
- Create a teststack configuration file describing your desired test environment, like the one at https://github.com/csnover/dojo2-teststack/blob/master/test/teststack.js
cd dojo2-teststacknode runner.js config=mid/of/teststack/config- View console
- Fix bugs
…plus CI support:
- Create a
.travis.ymllike the one at https://github.com/csnover/dojo2-teststack/blob/master/.travis.yml - Enable Travis-CI for your GitHub account
- Make a commit
- That’s it! Easy continuous integration is easy.
New BSD License
© 2012–2013 Colin Snover http://zetafleet.com © 2013 SitePen, Inc. http://sitepen.com All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
* Neither the name of The Intern nor the names of its contributors may
be used to endorse or promote products derived from this software
without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE LISTED COPYRIGHT HOLDERS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Released under Dojo Foundation CLA.