This plugin provides an ability to specify the list of test cases outside of the test function. When the list of test cases is provided then separated test is added to run per each test case. Test case is passed to the test function as a parameter.
Benefits are:
- Test data and test methods are not mixed
- Tests are data driven
- Tests are more DRY
##Download
- qunit-parameterize.js v0.4
- npm : $ npm install qunit-parameterize
- bower : $ bower install qunit-parameterize
##Usage
QUnit
.cases(testCasesList)
.test(title, [expect], callback);####Example
Given test function is:
function sum(a, b) { return a + b; }Then the following code:
QUnit
.cases([
{ a : 2, b : 2, expectedSum : 4 },
{ a : 5, b : 5, expectedSum : 10 },
{ a : 40, b : 2, expectedSum : 42 }
])
.test("Sum test", function(params) {
var actualSum = sum(params.a, params.b);
equal(actualSum, params.expectedSum);
});is eqivalent to:
QUnit.test("Sum test", function() {
var actualSum = sum(2, 2);
equal(actualSum, 4);
});
QUnit.test("Sum test", function() {
var actualSum = sum(5, 5);
equal(actualSum, 10);
});
QUnit.test("Sum test", function() {
var actualSum = sum(40, 2);
equal(actualSum, 42);
});Since v0.4 test fails when empty test cases set (or null or undefined) is provided. See Issue#4 for details.
##Assert parameter
Parameter assert is provided as the second parameter to the test function.
####Example
QUnit
.cases([
{ a : 1, b : 1, expectedSum : 2 }
])
.test("Sum test", function(params, assert) {
var actualSum = sum(params.a, params.b);
assert.equal(actualSum, params.expectedSum);
});##Title suffix
When special parameter 'title' is specifies in test case then test case title is added as suffix to the test title.
####Example
The following code:
QUnit
.cases([
{ title : "100+100", a : 100, b : 100, expectedSum : 200 },
{ title : "5+0", a : 5, b : 0, expectedSum : 5 }
])
.test("Sum test", function(params) {
var actualSum = sum(params.a, params.b);
equal(actualSum, params.expectedSum);
});is equivalent to:
QUnit.test("Sum test[100+100]", function() {
var actualSum = sum(100, 100);
equal(actualSum, 200);
});
QUnit.test("Sum test[5+0]", function() {
var actualSum = sum(5, 0);
equal(actualSum, 5);
});##Chaining (available since v0.2)
For running several tests over the same test data.
####Example
QUnit
.cases([
'.container',
'body .container'
])
.test("Should get a single jquery element", function(param) {
equal($(param).length, 1);
})
.test("Should have class of jquery element", function(param) {
ok($(param).hasClass('container'));
});##Test Cases Generation (available since v0.3)
Test cases can be generated based on provided test data.
###Sequential
Generates the set of test cases based on provided pairs of test data.
####Example
The following code
QUnit
.cases([
{ a : 1 },
{ a : 2 },
{ a : null }
])
.sequential([
{ b : "one" },
{ b : "two" }
])
.test(...);Is equivalent to:
QUnit
.cases([
{ a : 1, b : "one" },
{ a : 2, b : "two" },
{ a : null }
])
.test(...);The total count of test cases is the maximum count of cases from 'cases()' and 'sequential()'.
When some test case should be skipped then 'null' or 'undefined' can be passed at its place:
####Example
The following code
QUnit
.cases([
{ a : 1 },
{ a : 2 },
{ a : null }
])
.sequential([
{ b : "one" },
null,
{ b : "null" }
])produces test cases:
[
{ a : 1, b : "one" },
{ a : 2 },
{ a : null, b : "null" }
]###Combinatorial
Generates the test cases combinations based on provided test data.
####Example
The following code
QUnit
.cases([
{ a : 1 },
{ a : 2 }
])
.combinatorial([
{ b : "X" },
{ b : "Y" }
])produces test cases:
[
{ a : 1, b : "X" },
{ a : 1, b : "Y" },
{ a : 2, b : "X" },
{ a : 2, b : "Y" }
]When 'null' or 'undefined' is passed as test data then original test case is not changed:
####Example
The following code
QUnit
.cases([
{ a : 1 },
{ a : 2 }
])
.combinatorial([
{ b : "X" },
null
])produces test cases:
[
{ a : 1, b : "X" },
{ a : 1 },
{ a : 2, b : "X" },
{ a : 2 }
]###Parameter names conflict resolution
If parameter with the same name is presented in both 'cases()' and in 'sequential()/combinatorial()' then value from 'cases()' is prefered to generate resulting test case:
####Example
The following code
QUnit
.cases([
{ a : 1 },
{ a : 2 }
])
.sequential([
{ a : 3 },
{ a : 4 }
])produces test cases:
[
{ a : 1 },
{ a : 2 }
]###Title Concatenation
If parameter 'title' is presented in both 'cases()' and in 'sequential()/combinatorial()' then resulting 'title' value is a concatenation of both original values:
####Example
The following code
QUnit
.cases([
{ title : "case1", a : 1 },
{ title : "case2", a : 2 }
])
.combinatorial([
{ title : " mix1", b : "X" },
{ title : " mix2", b : "Y" }
])produces test cases:
[
{ title : "case1 mix1", a : 1, b : "X" },
{ title : "case1 mix2", a : 1, b : "Y" },
{ title : "case2 mix1", a : 2, b : "X" },
{ title : "case2 mix2", a : 2, b : "Y" }
]###Chaining Generation
It is possible to apply multiple 'sequential()/combinatorial()' calls to the same test cases set.
####Example
QUnit
.cases([...])
.combinatorial([...])
.sequential([...])
.combinatorial([...])
.sequential([...])
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent