utest is an easy to use unit testing library for Haxe. It works on all the supported platforms including nodejs.
Install is as easy as:
haxelib install utestIn your main method define the minimal instances needed to run your tests.
import utest.Runner;
import utest.ui.Report;
class TestAll {
public static function main() {
//the long way
var runner = new Runner();
runner.addCase(new TestCase1());
runner.addCase(new TestCase2());
Report.create(runner);
runner.run();
//the short way in case you don't need to handle any specifics
utest.UTest.run([new TestCase1(), new TestCase2()]);
}
}TestCase must extend utest.Test or implement utest.ITest.
TestCase needs to follow some conventions:
- Every test case method name must be prefixed with
testorspec; - If a method is prefixed with
specit is treated as the specification test. Every boolean binary operation will be wrapped inAssert.isTrue()
Following methods could be implemented to setup or teardown:
/**
* This method is executed once before running the first test in the current class.
* If it accepts an argument, it is treated as an asynchronous method.
*/
function setupClass():Void;
function setupClass(async:Async):Void;
/**
* This method is executed before each test.
* If it accepts an argument, it is treated as an asynchronous method.
*/
function setup():Void;
function setup(async:Async):Void;
/**
* This method is executed after each test.
* If it accepts an argument, it is treated as an asynchronous method.
*/
function teardown():Void;
function teardown(async:Async):Void;
/**
* This method is executed once after the last test in the current class is finished.
* If it accepts an argument, it is treated as an asynchronous method.
*/
function teardownClass():Void;
function teardownClass(async:Async):Void;Default timeout for asynchronous methods is 250ms. You can change it by adding @:timeout(500) meta.
To add all test cases from my.pack package use runner.addCases(my.pack). Any module found in my.pack is treated as a test case. That means each module should contain a class implementing utest.ITest and that class should have the same name as the module name.
import utest.Assert;
import utest.Async;
class TestCase extends utest.Test {
var field : String;
//synchronous setup
public function setup() {
field = "some";
}
function testFieldIsSome() {
Assert.equals("some", field);
}
function specField() {
field.charAt(0) == 's';
field.length > 3;
}
//asynchronous teardown
@:timeout(700) //default timeout is 250ms
public function teardown(async:Async) {
field = null; // not really needed
//simulate asynchronous teardown
haxe.Timer.delay(
function() {
//resolve asynchronous action
async.done();
},
500
);
}
}Adding -D UTEST_PATTERN pattern to the compilation flags makes UTest to run only tests which have names matching the pattern. The pattern could be a plain string or a regular expression without delimiters.
Another option is to add UTEST_PATTERN to the environment variables at compile time.
If a test case accepts an argument, that test case is treated as an asynchronous test.
@:timeout(500) //change timeout (default: 250ms)
function testSomething(async:utest.Async) {
// do your async goodness and remember to call `done()` at the end.
haxe.Timer.delay(function() {
Assert.isTrue(true); // put a sensible test here
async.done();
}, 50);
}Assert contains a plethora of methods to perform your tests:
Asserts successfully when the condition is true.
cond The condition to test
msg An optional error message. If not passed a default one will be used
pos Code position where the Assert call has been executed. Don't fill it
unless you know what you are doing.
Asserts successfully when the condition is false.
cond The condition to test
msg An optional error message. If not passed a default one will be used
pos Code position where the Assert call has been executed. Don't fill it
unless you know what you are doing.
Asserts successfully when the value is null.
value The value to test
msg An optional error message. If not passed a default one will be used
pos Code position where the Assert call has been executed. Don't fill it
unless you know what you are doing.
Asserts successfully when the value is not null.
value The value to test
msg An optional error message. If not passed a default one will be used
pos Code position where the Assert call has been executed. Don't fill it
unless you know what you are doing.
Asserts successfully when the 'value' parameter is of the of the passed type 'type'.
value The value to test
type The type to test against
msg An optional error message. If not passed a default one will be used
pos Code position where the Assert call has been executed. Don't fill it
unless you know what you are doing.
Asserts successfully when the value parameter is not the same as the expected one.
Assert.notEquals(10, age);expected The expected value to check against
value The value to test
msg An optional error message. If not passed a default one will be used
pos Code position where the Assert call has been executed. Don't fill it
unless you know what you are doing.
Asserts successfully when the value parameter is equal to the expected one.
Assert.equals(10, age);expected The expected value to check against
value The value to test
msg An optional error message. If not passed a default one will be used
pos Code position where the Assert call has been executed. Don't fill it
unless you know what you are doing.
Asserts successfully when the value parameter does match against the passed EReg instance.
Assert.match(~/x/i, "Haxe");pattern The pattern to match against
value The value to test
msg An optional error message. If not passed a default one will be used
pos Code position where the Assert call has been executed. Don't fill it
unless you know what you are doing.
Same as Assert.equals but considering an approximation error.
Assert.floatEquals(Math.PI, value);expected The expected value to check against
value The value to test
approx The approximation tollerance. Default is 1e-5
msg An optional error message. If not passed a default one will be used
pos Code position where the Assert call has been executed. Don't fill it
unless you know what you are doing.
Check that value is an object with the same fields and values found in expected. The default behavior is to check nested objects in fields recursively.
Assert.same({ name : "utest"}, ob);expected The expected value to check against
value The value to test
recursive States whether or not the test will apply also to sub-objects.
Defaults to true
msg An optional error message. If not passed a default one will be used
pos Code position where the Assert call has been executed. Don't fill it
unless you know what you are doing.
raises(method:Void -> Void, ?type:Class<Dynamic>, ?msgNotThrown : String , ?msgWrongType : String, ?pos : PosInfos)
It is used to test an application that under certain circumstances must react throwing an error. This assert guarantees that the error is of the correct type (or Dynamic if non is specified).
Assert.raises(function() { throw "Error!"; }, String);method A method that generates the exception.
type The type of the expected error. Defaults to Dynamic (catch all).
msgNotThrown An optional error message used when the function fails to raise the expected
exception. If not passed a default one will be used
msgWrongType An optional error message used when the function raises the exception but it is
of a different type than the one expected. If not passed a default one will be used
pos Code position where the Assert call has been executed. Don't fill it
unless you know what you are doing.
@todo test the optional type parameter
Checks that the test value matches at least one of the possibilities.
possibility An array of possible matches
value The value to test
msg An optional error message. If not passed a default one will be used
pos Code position where the Assert call has been executed. Don't fill it
unless you know what you are doing.
Checks that the test array contains the match parameter.
match The element that must be included in the tested array
values The values to test
msg An optional error message. If not passed a default one will be used
pos Code position where the Assert call has been executed. Don't fill it
unless you know what you are doing.
Checks that the test array does not contain the match parameter.
match The element that must NOT be included in the tested array
values The values to test
msg An optional error message. If not passed a default one will be used
pos Code position where the Assert call has been executed. Don't fill it
unless you know what you are doing.
Checks that the expected values is contained in value.
match the string value that must be contained in value
value the value to test
msg An optional error message. If not passed a default one will be used
pos Code position where the Assert call has been executed. Don't fill it
Forces a failure.
msg An optional error message. If not passed a default one will be used
pos Code position where the Assert call has been executed. Don't fill it
unless you know what you are doing.
Creates a warning message.
msg A mandatory message that justifies the warning.
pos Code position where the Assert call has been executed. Don't fill it
You can easily ignore one of tests within specifying @Ignored meta.
class TestCase extends utes.Test {
@Ignored("Ignore this test")
function testIgnoredWithReason() {}
@Ignored
function testIgnoredWithoutReason():Void {}
}