assert_fails

Asserts a function fails; i.e. throws an exception.

Example

Application code

// This will throw a exception.
function bad(): integer {
    return [0][1];
}

Test code

// This test will pass.
function test_bad() {
    rell.test.assert_fails(bad(*));
}

Parameters

Asserts a function fails; i.e. throws an exception; with a given exception message.

Verifies that the given exception message is a substring of the exception thrown by the given function (if thrown).

Example

Application code

// This will throw a exception.
function bad(): integer {
    return [0][1];
}

Test code

// This test will pass.
function test_bad() {
    rell.test.assert_fails("out of bounds", bad(*));
}

Parameters