Source code
Revision control
Copy as Markdown
Other Tools
/**
* Any copyright is dedicated to the Public Domain.
*
* This is a shim for the W3C testharness.js, mapping those of
* its functions that we need to the testing/xpcshell/head.js API.
* This shim does some tests a little differently than the W3C test
* harness; equality comparisons, especially, are less precise.
* The difference does not presently affect any test results.
*
* We use the lower-level do_report_result throughout this file,
* rather than the high-level xpcshell/head.js API that has near
* equivalents for the W3C assert_* functions, because only
* do_report_result allows us to provide Components.stack.caller.
*/
function assert_equals(a, b, msg) {
let text =
msg +
": " +
_wrap_with_quotes_if_necessary(a) +
" == " +
_wrap_with_quotes_if_necessary(b);
do_report_result(a == b, text, Components.stack.caller, false);
}
function assert_not_equals(a, b, msg) {
let text =
msg +
": " +
_wrap_with_quotes_if_necessary(a) +
" != " +
_wrap_with_quotes_if_necessary(b);
do_report_result(a != b, text, Components.stack.caller, false);
}
function assert_array_equals(a, b, msg) {
do_report_result(
a.length == b.length,
msg + ": (length) " + a.length + " == " + b.length,
Components.stack.caller,
false
);
for (let i = 0; i < a.length; ++i) {
if (a[i] !== b[i]) {
do_report_result(
false,
msg +
": [" +
i +
"] " +
_wrap_with_quotes_if_necessary(a[i]) +
" === " +
_wrap_with_quotes_if_necessary(b[i]),
Components.stack.caller,
false
);
}
}
// If we get here, all array elements are equal.
do_report_result(
true,
msg + ": all array elements equal",
Components.stack.caller,
false
);
}
function assert_true(cond, msg) {
do_report_result(
!!cond,
msg + ": " + uneval(cond),
Components.stack.caller,
false
);
}
function assert_throws(ex, func) {
if (!("name" in ex)) {
do_throw(
"first argument to assert_throws must be of the form " +
"{'name': something}"
);
}
let msg = "expected to catch an exception named " + ex.name;
try {
func();
} catch (e) {
if ("name" in e) {
do_report_result(
e.name == ex.name,
msg + ", got " + e.name,
Components.stack.caller,
false
);
} else {
do_report_result(
false,
msg + ", got " + legible_exception(ex),
Components.stack.caller,
false
);
}
return;
}
// Call this here, not in the 'try' clause, so do_report_result's own
// throw doesn't get caught by our 'catch' clause.
do_report_result(
false,
msg + ", but returned normally",
Components.stack.caller,
false
);
}
var tests = [];
function test(func, msg) {
tests.push({
msg,
func,
filename: Components.stack.caller.filename,
});
}
function run_test() {
tests.forEach(function (t) {
info(`test group: ${t.msg}, {source_file: ${t.filename}}`);
t.func();
});
}