Versions Compared
compared with
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Excerpt |
---|
The most basic unit test mode... |
Syntax
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Test("Basic syntax", Test.ANY( ), function() { // assertions, if any, go here }); |
Parameters
No parameters.
Return values
Value | Type | Notes | API Version |
---|---|---|---|
<mode> | Object | The mode object is associated with the unit test defined in the same Test() invocation. | 1.0 |
Effect on test
The test is treated as synchronous and its pass/fail state will be determined as soon as the unit test function has been processed...
Fail conditions
The unit test will fail if any of the following occur:
- One or more Test Assertions fail
- An uncaught exception is thrown
- An ABORT( ) or REQUIRE( ) signal is thrown
Pass conditions
If the test has not failed, it will be deemed to have passed – even if it did not generate any results (eg. no assertions or signals in the test).
Examples
Test.ANY( ) mode is useful when the number of results could vary based on some external factor...
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
var thingsToCheck = ["chat", "include", "playerData"]; Test("Check things", Test.ANY( ), function(settings) { if (settings && settings.length) { settings.forEach(function(thing) { hasNative( thing, thing+" is native?" ); }); } }, thingsToCheck); |
Test.ANY( ) is also useful if you want to use a test as a flag that determines whether other tests run...
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
Test("Check is defined", Test.ANY( ), function() { hasNative( "Check", "Dependency Checker installed?" ); }); Test("Test dependency checker", Test.EXPECT( 1 ), function() { REQUIRE( "Check is defined" ); // will abort if the test above failed Check.provide({file: "testing", ver: 1.0}); ok( Check.has("testing", 1.0), "Dependency successfully provided" ); }); |
Div | ||
---|---|---|
| ||
If you know how many results a test should generate, it's recommended to use Test.EXPECT( ) instead. |
Div | ||||||
---|---|---|---|---|---|---|
| ||||||
Availability
Requires:
|
Div | ||||
---|---|---|---|---|
| ||||
ContentsJump to:
|
Div | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
Test APITopics:
|