test.exception

Boolean test.exception(code)

Boolean test.exception(code, message)

This function executes the code passed as a string in code, expecting it to raise an exception. If an exception is raised a test result of type PASS is added to the test log and this function returns a true value. Otherwise a test result of type FAIL is added to the test log and a false value is returned.

If the optional message parameter (of type string—e.g., a comment, bug number, or test plan reference) is present, it will be added to the test result no matter whether the test passed or failed.

The testSettings.breakOnFailure property can be used to make the debugger stop in case the given code did not raise an exception.

The testSettings.throwOnFailure property can be used to make this function raise a script exception in case the given code did not raise an exception.