/* | |
Distributed under both the W3C Test Suite License [1] and the W3C | |
3-clause BSD License [2]. To contribute to a W3C Test Suite, see the | |
policies and contribution forms [3]. | |
[1] http://www.w3.org/Consortium/Legal/2008/04-testsuite-license | |
[2] http://www.w3.org/Consortium/Legal/2008/03-bsd-license | |
[3] http://www.w3.org/2004/10/27-testcases | |
*/ | |
/* | |
* == Introduction == | |
* | |
* This file provides a framework for writing testcases. It is intended to | |
* provide a convenient API for making common assertions, and to work both | |
* for testing synchronous and asynchronous DOM features in a way that | |
* promotes clear, robust, tests. | |
* | |
* == Basic Usage == | |
* | |
* To use this file, import the script and the testharnessreport script into | |
* the test document: | |
* <script src="/resources/testharness.js"></script> | |
* <script src="/resources/testharnessreport.js"></script> | |
* | |
* Within each file one may define one or more tests. Each test is atomic | |
* in the sense that a single test has a single result (pass/fail/timeout). | |
* Within each test one may have a number of asserts. The test fails at the | |
* first failing assert, and the remainder of the test is (typically) not run. | |
* | |
* If the file containing the tests is a HTML file with an element of id "log" | |
* this will be populated with a table containing the test results after all | |
* the tests have run. | |
* | |
* NOTE: By default tests must be created before the load event fires. For ways | |
* to create tests after the load event, see "Determining when all tests are | |
* complete", below | |
* | |
* == Synchronous Tests == | |
* | |
* To create a synchronous test use the test() function: | |
* | |
* test(test_function, name, properties) | |
* | |
* test_function is a function that contains the code to test. For example a | |
* trivial passing test would be: | |
* | |
* test(function() {assert_true(true)}, "assert_true with true") | |
* | |
* The function passed in is run in the test() call. | |
* | |
* properties is an object that overrides default test properties. The recognised properties | |
* are: | |
* timeout - the test timeout in ms | |
* | |
* e.g. | |
* test(test_function, "Sample test", {timeout:1000}) | |
* | |
* would run test_function with a timeout of 1s. | |
* | |
* == Asynchronous Tests == | |
* | |
* Testing asynchronous features is somewhat more complex since the result of | |
* a test may depend on one or more events or other callbacks. The API provided | |
* for testing these features is indended to be rather low-level but hopefully | |
* applicable to many situations. | |
* | |
* To create a test, one starts by getting a Test object using async_test: | |
* | |
* async_test(name, properties) | |
* | |
* e.g. | |
* var t = async_test("Simple async test") | |
* | |
* Assertions can be added to the test by calling the step method of the test | |
* object with a function containing the test assertions: | |
* | |
* t.step(function() {assert_true(true)}); | |
* | |
* When all the steps are complete, the done() method must be called: | |
* | |
* t.done(); | |
* | |
* The properties argument is identical to that for test(). | |
* | |
* In many cases it is convenient to run a step in response to an event or a | |
* callback. A convenient method of doing this is through the step_func method | |
* which returns a function that, when called runs a test step. For example | |
* | |
* object.some_event = t.step_func(function(e) {assert_true(e.a)}); | |
* | |
* == Making assertions == | |
* | |
* Functions for making assertions start assert_ | |
* The best way to get a list is to look in this file for functions names | |
* matching that pattern. The general signature is | |
* | |
* assert_something(actual, expected, description) | |
* | |
* although not all assertions precisely match this pattern e.g. assert_true | |
* only takes actual and description as arguments. | |
* | |
* The description parameter is used to present more useful error messages when | |
* a test fails | |
* | |
* NOTE: All asserts must be located in a test() or a step of an async_test(). | |
* asserts outside these places won't be detected correctly by the harness | |
* and may cause a file to stop testing. | |
* | |
* == Setup == | |
* | |
* Sometimes tests require non-trivial setup that may fail. For this purpose | |
* there is a setup() function, that may be called with one or two arguments. | |
* The two argument version is: | |
* | |
* setup(func, properties) | |
* | |
* The one argument versions may omit either argument. | |
* func is a function to be run synchronously. setup() becomes a no-op once | |
* any tests have returned results. Properties are global properties of the test | |
* harness. Currently recognised properties are: | |
* | |
* timeout - The time in ms after which the harness should stop waiting for | |
* tests to complete (this is different to the per-test timeout | |
* because async tests do not start their timer until .step is called) | |
* | |
* explicit_done - Wait for an explicit call to done() before declaring all tests | |
* complete (see below) | |
* | |
* output_document - The document to which results should be logged. By default this is | |
* the current document but could be an ancestor document in some cases | |
* e.g. a SVG test loaded in an HTML wrapper | |
* | |
* == Determining when all tests are complete == | |
* | |
* By default the test harness will assume there are no more results to come | |
* when: | |
* 1) There are no Test objects that have been created but not completed | |
* 2) The load event on the document has fired | |
* | |
* This behaviour can be overridden by setting the explicit_done property to true | |
* in a call to setup(). If explicit_done is true, the test harness will not assume | |
* it is done until the global done() function is called. Once done() is called, the | |
* two conditions above apply like normal. | |
* | |
* == Generating tests == | |
* | |
* NOTE: this functionality may be removed | |
* | |
* There are scenarios in which is is desirable to create a large number of | |
* (synchronous) tests that are internally similar but vary in the parameters | |
* used. To make this easier, the generate_tests function allows a single | |
* function to be called with each set of parameters in a list: | |
* | |
* generate_tests(test_function, parameter_lists) | |
* | |
* For example: | |
* | |
* generate_tests(assert_equals, [ | |
* ["Sum one and one", 1+1, 2], | |
* ["Sum one and zero", 1+0, 1] | |
* ]) | |
* | |
* Is equivalent to: | |
* | |
* test(function() {assert_equals(1+1, 2)}, "Sum one and one") | |
* test(function() {assert_equals(1+0, 1)}, "Sum one and zero") | |
* | |
* Note that the first item in each parameter list corresponds to the name of | |
* the test. | |
* | |
* == Callback API == | |
* | |
* The framework provides callbacks corresponding to 3 events: | |
* | |
* start - happens when the first Test is created | |
* result - happens when a test result is recieved | |
* complete - happens when all results are recieved | |
* | |
* The page defining the tests may add callbacks for these events by calling | |
* the following methods: | |
* | |
* add_start_callback(callback) - callback called with no arguments | |
* add_result_callback(callback) - callback called with a test argument | |
* add_completion_callback(callback) - callback called with an array of tests | |
* and an status object | |
* | |
* tests have the following properties: | |
* status: A status code. This can be compared to the PASS, FAIL, TIMEOUT and | |
* NOTRUN properties on the test object | |
* message: A message indicating the reason for failure. In the future this | |
* will always be a string | |
* | |
* The status object gives the overall status of the harness. It has the | |
* following properties: | |
* status: Can be compared to the OK, ERROR and TIMEOUT properties | |
* message: An error message set when the status is ERROR | |
* | |
* == External API == | |
* | |
* In order to collect the results of multiple pages containing tests, the test | |
* harness will, when loaded in a nested browsing context, attempt to call | |
* certain functions in each ancestor browsing context: | |
* | |
* start - start_callback | |
* result - result_callback | |
* complete - completion_callback | |
* | |
* These are given the same arguments as the corresponding internal callbacks | |
* described above. | |
* | |
* == List of assertions == | |
* | |
* assert_true(actual, description) | |
* asserts that /actual/ is strictly true | |
* | |
* assert_false(actual, description) | |
* asserts that /actual/ is strictly false | |
* | |
* assert_equals(actual, expected, description) | |
* asserts that /actual/ is the same value as /expected/ | |
* | |
* assert_not_equals(actual, expected, description) | |
* asserts that /actual/ is a different value to /expected/. Yes, this means | |
* that "expected" is a misnomer | |
* | |
* assert_in_array(actual, expected, description) | |
* asserts that /expected/ is an Array, and /actual/ is equal to one of the | |
* members -- expected.indexOf(actual) != -1 | |
* | |
* assert_array_equals(actual, expected, description) | |
* asserts that /actual/ and /expected/ have the same length and the value of | |
* each indexed property in /actual/ is the strictly equal to the corresponding | |
* property value in /expected/ | |
* | |
* assert_approx_equals(actual, expected, epsilon, description) | |
* asserts that /actual/ is a number within +/- /epsilon/ of /expected/ | |
* | |
* assert_regexp_match(actual, expected, description) | |
* asserts that /actual/ matches the regexp /expected/ | |
* | |
* assert_own_property(object, property_name, description) | |
* assert that object has own property property_name | |
* | |
* assert_inherits(object, property_name, description) | |
* assert that object does not have an own property named property_name | |
* but that property_name is present in the prototype chain for object | |
* | |
* assert_idl_attribute(object, attribute_name, description) | |
* assert that an object that is an instance of some interface has the | |
* attribute attribute_name following the conditions specified by WebIDL | |
* | |
* assert_readonly(object, property_name, description) | |
* assert that property property_name on object is readonly | |
* | |
* assert_throws(code, func, description) | |
* code - a DOMException/RangeException code as a string, e.g. "HIERARCHY_REQUEST_ERR" | |
* func - a function that should throw | |
* | |
* assert that func throws a DOMException or RangeException (as appropriate) | |
* with the given code. If an object is passed for code instead of a string, | |
* checks that the thrown exception has a property called "name" that matches | |
* the property of code called "name". Note, this function will probably be | |
* rewritten sometime to make more sense. | |
* | |
* assert_unreached(description) | |
* asserts if called. Used to ensure that some codepath is *not* taken e.g. | |
* an event does not fire. | |
* | |
* assert_exists(object, property_name, description) | |
* *** deprecated *** | |
* asserts that object has an own property property_name | |
* | |
* assert_not_exists(object, property_name, description) | |
* *** deprecated *** | |
* assert that object does not have own property property_name | |
*/ | |
(function () | |
{ | |
var debug = false; | |
// default timeout is 5 seconds, test can override if needed | |
var settings = { | |
output:true, | |
timeout:5000, | |
test_timeout:2000 | |
}; | |
var xhtml_ns = "http://www.w3.org/1999/xhtml"; | |
// script_prefix is used by Output.prototype.show_results() to figure out | |
// where to get testharness.css from. It's enclosed in an extra closure to | |
// not pollute the library's namespace with variables like "src". | |
var script_prefix = null; | |
(function () | |
{ | |
var scripts = document.getElementsByTagName("script"); | |
for (var i = 0; i < scripts.length; i++) | |
{ | |
if (scripts[i].src) | |
{ | |
var src = scripts[i].src; | |
} | |
else if (scripts[i].href) | |
{ | |
//SVG case | |
var src = scripts[i].href.baseVal; | |
} | |
if (src && src.slice(src.length - "testharness.js".length) === "testharness.js") | |
{ | |
script_prefix = src.slice(0, src.length - "testharness.js".length); | |
break; | |
} | |
} | |
})(); | |
/* | |
* API functions | |
*/ | |
var name_counter = 0; | |
function next_default_name() | |
{ | |
//Don't use document.title to work around an Opera bug in XHTML documents | |
var prefix = document.getElementsByTagName("title").length > 0 ? | |
document.getElementsByTagName("title")[0].firstChild.data : | |
"Untitled"; | |
var suffix = name_counter > 0 ? " " + name_counter : ""; | |
name_counter++; | |
return prefix + suffix; | |
} | |
function test(func, name, properties) | |
{ | |
var test_name = name ? name : next_default_name(); | |
properties = properties ? properties : {}; | |
var test_obj = new Test(test_name, properties); | |
test_obj.step(func); | |
if (test_obj.status === test_obj.NOTRUN) { | |
test_obj.done(); | |
} | |
} | |
function async_test(name, properties) | |
{ | |
var test_name = name ? name : next_default_name(); | |
properties = properties ? properties : {}; | |
var test_obj = new Test(test_name, properties); | |
return test_obj; | |
} | |
function setup(func_or_properties, maybe_properties) | |
{ | |
var func = null; | |
var properties = {}; | |
if (arguments.length === 2) { | |
func = func_or_properties; | |
properties = maybe_properties; | |
} else if (func_or_properties instanceof Function){ | |
func = func_or_properties; | |
} else { | |
properties = func_or_properties; | |
} | |
tests.setup(func, properties); | |
output.setup(properties); | |
} | |
function done() { | |
tests.end_wait(); | |
} | |
function generate_tests(func, args) { | |
forEach(args, function(x) | |
{ | |
var name = x[0]; | |
test(function() | |
{ | |
func.apply(this, x.slice(1)); | |
}, name); | |
}); | |
} | |
function on_event(object, event, callback) | |
{ | |
object.addEventListener(event, callback, false); | |
} | |
expose(test, 'test'); | |
expose(async_test, 'async_test'); | |
expose(generate_tests, 'generate_tests'); | |
expose(setup, 'setup'); | |
expose(done, 'done'); | |
expose(on_event, 'on_event'); | |
/* | |
* Return a string truncated to the given length, with ... added at the end | |
* if it was longer. | |
*/ | |
function truncate(s, len) | |
{ | |
if (s.length > len) { | |
return s.substring(0, len - 3) + "..."; | |
} | |
return s; | |
} | |
function format_string(str) { | |
for (var i = 0; i < 32; i++) { | |
var replace = "\\"; | |
switch (i) { | |
case 0: replace += "0"; break; | |
case 1: replace += "x01"; break; | |
case 2: replace += "x02"; break; | |
case 3: replace += "x03"; break; | |
case 4: replace += "x04"; break; | |
case 5: replace += "x05"; break; | |
case 6: replace += "x06"; break; | |
case 7: replace += "x07"; break; | |
case 8: replace += "b"; break; | |
case 9: replace += "t"; break; | |
case 10: replace += "n"; break; | |
case 11: replace += "v"; break; | |
case 12: replace += "f"; break; | |
case 13: replace += "r"; break; | |
case 14: replace += "x0e"; break; | |
case 15: replace += "x0f"; break; | |
case 16: replace += "x10"; break; | |
case 17: replace += "x11"; break; | |
case 18: replace += "x12"; break; | |
case 19: replace += "x13"; break; | |
case 20: replace += "x14"; break; | |
case 21: replace += "x15"; break; | |
case 22: replace += "x16"; break; | |
case 23: replace += "x17"; break; | |
case 24: replace += "x18"; break; | |
case 25: replace += "x19"; break; | |
case 26: replace += "x1a"; break; | |
case 27: replace += "x1b"; break; | |
case 28: replace += "x1c"; break; | |
case 29: replace += "x1d"; break; | |
case 30: replace += "x1e"; break; | |
case 31: replace += "x1f"; break; | |
} | |
str = str.replace(RegExp(String.fromCharCode(i), "g"), replace); | |
} | |
return str.replace(/"/g, '\\"') | |
} | |
/* | |
* Convert a value to a nice, human-readable string | |
*/ | |
function format_value(val) | |
{ | |
if (Array.isArray(val)) | |
{ | |
return "[" + val.map(format_value).join(", ") + "]"; | |
} | |
switch (typeof val) | |
{ | |
case "string": | |
return '"' + format_string(val) + '"'; | |
case "boolean": | |
case "undefined": | |
return String(val); | |
case "number": | |
// In JavaScript, -0 === 0 and String(-0) == "0", so we have to | |
// special-case. | |
if (val === -0 && 1/val === -Infinity) | |
{ | |
return "-0"; | |
} | |
return String(val); | |
case "object": | |
if (val === null) | |
{ | |
return "null"; | |
} | |
// Special-case Node objects, since those come up a lot in my tests. I | |
// ignore namespaces. I use duck-typing instead of instanceof, because | |
// instanceof doesn't work if the node is from another window (like an | |
// iframe's contentWindow): | |
// http://www.w3.org/Bugs/Public/show_bug.cgi?id=12295 | |
if ("nodeType" in val | |
&& "nodeName" in val | |
&& "nodeValue" in val | |
&& "childNodes" in val) | |
{ | |
switch (val.nodeType) | |
{ | |
case Node.ELEMENT_NODE: | |
var ret = "<" + val.tagName.toLowerCase(); | |
for (var i = 0; i < val.attributes.length; i++) | |
{ | |
ret += " " + val.attributes[i].name + '="' + val.attributes[i].value + '"'; | |
} | |
ret += ">" + val.innerHTML + "</" + val.tagName.toLowerCase() + ">"; | |
return "Element node " + truncate(ret, 60); | |
case Node.TEXT_NODE: | |
return 'Text node "' + truncate(val.data, 60) + '"'; | |
case Node.PROCESSING_INSTRUCTION_NODE: | |
return "ProcessingInstruction node with target " + format_value(truncate(val.target, 60)) + " and data " + format_value(truncate(val.data, 60)); | |
case Node.COMMENT_NODE: | |
return "Comment node <!--" + truncate(val.data, 60) + "-->"; | |
case Node.DOCUMENT_NODE: | |
return "Document node with " + val.childNodes.length + (val.childNodes.length == 1 ? " child" : " children"); | |
case Node.DOCUMENT_TYPE_NODE: | |
return "DocumentType node"; | |
case Node.DOCUMENT_FRAGMENT_NODE: | |
return "DocumentFragment node with " + val.childNodes.length + (val.childNodes.length == 1 ? " child" : " children"); | |
default: | |
return "Node object of unknown type"; | |
} | |
} | |
// Fall through to default | |
default: | |
return typeof val + ' "' + truncate(String(val), 60) + '"'; | |
} | |
} | |
expose(format_value, "format_value"); | |
/* | |
* Assertions | |
*/ | |
function assert_true(actual, description) | |
{ | |
assert(actual === true, "assert_true", description, | |
"expected true got ${actual}", {actual:actual}); | |
}; | |
expose(assert_true, "assert_true"); | |
function assert_false(actual, description) | |
{ | |
assert(actual === false, "assert_false", description, | |
"expected false got ${actual}", {actual:actual}); | |
}; | |
expose(assert_false, "assert_false"); | |
function same_value(x, y) { | |
if (y !== y) | |
{ | |
//NaN case | |
return x !== x; | |
} | |
else if (x === 0 && y === 0) { | |
//Distinguish +0 and -0 | |
return 1/x === 1/y; | |
} | |
else | |
{ | |
//typical case | |
return x === y; | |
} | |
} | |
function assert_equals(actual, expected, description) | |
{ | |
/* | |
* Test if two primitives are equal or two objects | |
* are the same object | |
*/ | |
assert(same_value(actual, expected), "assert_equals", description, | |
"expected ${expected} but got ${actual}", | |
{expected:expected, actual:actual}); | |
}; | |
expose(assert_equals, "assert_equals"); | |
function assert_not_equals(actual, expected, description) | |
{ | |
/* | |
* Test if two primitives are unequal or two objects | |
* are different objects | |
*/ | |
assert(!same_value(actual, expected), "assert_not_equals", description, | |
"got disallowed value ${actual}", | |
{actual:actual}); | |
}; | |
expose(assert_not_equals, "assert_not_equals"); | |
function assert_in_array(actual, expected, description) | |
{ | |
assert(expected.indexOf(actual) != -1, "assert_in_array", description, | |
"value ${actual} not in array ${expected}", | |
{actual:actual, expected:expected}); | |
} | |
expose(assert_in_array, "assert_in_array"); | |
function assert_object_equals(actual, expected, description) | |
{ | |
//This needs to be improved a great deal | |
function check_equal(expected, actual, stack) | |
{ | |
stack.push(actual); | |
var p; | |
for (p in actual) | |
{ | |
assert(expected.hasOwnProperty(p), "assert_object_equals", description, | |
"unexpected property ${p}", {p:p}); | |
if (typeof actual[p] === "object" && actual[p] !== null) | |
{ | |
if (stack.indexOf(actual[p]) === -1) | |
{ | |
check_equal(actual[p], expected[p], stack); | |
} | |
} | |
else | |
{ | |
assert(actual[p] === expected[p], "assert_object_equals", description, | |
"property ${p} expected ${expected} got ${actual}", | |
{p:p, expected:expected, actual:actual}); | |
} | |
} | |
for (p in expected) | |
{ | |
assert(actual.hasOwnProperty(p), | |
"assert_object_equals", description, | |
"expected property ${p} missing", {p:p}); | |
} | |
stack.pop(); | |
} | |
check_equal(actual, expected, []); | |
}; | |
expose(assert_object_equals, "assert_object_equals"); | |
function assert_array_equals(actual, expected, description) | |
{ | |
assert(actual.length === expected.length, | |
"assert_array_equals", description, | |
"lengths differ, expected ${expected} got ${actual}", | |
{expected:expected.length, actual:actual.length}); | |
for (var i=0; i < actual.length; i++) | |
{ | |
assert(actual.hasOwnProperty(i) === expected.hasOwnProperty(i), | |
"assert_array_equals", description, | |
"property ${i}, property expected to be $expected but was $actual", | |
{i:i, expected:expected.hasOwnProperty(i) ? "present" : "missing", | |
actual:actual.hasOwnProperty(i) ? "present" : "missing"}); | |
assert(expected[i] === actual[i], | |
"assert_array_equals", description, | |
"property ${i}, expected ${expected} but got ${actual}", | |
{i:i, expected:expected[i], actual:actual[i]}); | |
} | |
} | |
expose(assert_array_equals, "assert_array_equals"); | |
function assert_approx_equals(actual, expected, epsilon, description) | |
{ | |
/* | |
* Test if two primitive numbers are equal withing +/- epsilon | |
*/ | |
assert(typeof actual === "number", | |
"assert_approx_equals", description, | |
"expected a number but got a ${type_actual}", | |
{type_actual:typeof actual}); | |
assert(Math.abs(actual - expected) <= epsilon, | |
"assert_approx_equals", description, | |
"expected ${expected} +/- ${epsilon} but got ${actual}", | |
{expected:expected, actual:actual, epsilon:epsilon}); | |
}; | |
expose(assert_approx_equals, "assert_approx_equals"); | |
function assert_regexp_match(actual, expected, description) { | |
/* | |
* Test if a string (actual) matches a regexp (expected) | |
*/ | |
assert(expected.test(actual), | |
"assert_regexp_match", description, | |
"expected ${expected} but got ${actual}", | |
{expected:expected, actual:actual}); | |
} | |
expose(assert_regexp_match, "assert_regexp_match"); | |
function _assert_own_property(name) { | |
return function(object, property_name, description) | |
{ | |
assert(object.hasOwnProperty(property_name), | |
name, description, | |
"expected property ${p} missing", {p:property_name}); | |
}; | |
} | |
expose(_assert_own_property("assert_exists"), "assert_exists"); | |
expose(_assert_own_property("assert_own_property"), "assert_own_property"); | |
function assert_not_exists(object, property_name, description) | |
{ | |
assert(!object.hasOwnProperty(property_name), | |
"assert_not_exists", description, | |
"unexpected property ${p} found", {p:property_name}); | |
}; | |
expose(assert_not_exists, "assert_not_exists"); | |
function _assert_inherits(name) { | |
return function (object, property_name, description) | |
{ | |
assert(typeof object === "object", | |
name, description, | |
"provided value is not an object"); | |
assert("hasOwnProperty" in object, | |
name, description, | |
"provided value is an object but has no hasOwnProperty method"); | |
assert(!object.hasOwnProperty(property_name), | |
name, description, | |
"property ${p} found on object expected in prototype chain", | |
{p:property_name}); | |
assert(property_name in object, | |
name, description, | |
"property ${p} not found in prototype chain", | |
{p:property_name}); | |
}; | |
} | |
expose(_assert_inherits("assert_inherits"), "assert_inherits"); | |
expose(_assert_inherits("assert_idl_attribute"), "assert_idl_attribute"); | |
function assert_readonly(object, property_name, description) | |
{ | |
var initial_value = object[property_name]; | |
try { | |
//Note that this can have side effects in the case where | |
//the property has PutForwards | |
object[property_name] = initial_value + "a"; //XXX use some other value here? | |
assert(object[property_name] === initial_value, | |
"assert_readonly", description, | |
"changing property ${p} succeeded", | |
{p:property_name}); | |
} | |
finally | |
{ | |
object[property_name] = initial_value; | |
} | |
}; | |
expose(assert_readonly, "assert_readonly"); | |
function assert_throws(code, func, description) | |
{ | |
try | |
{ | |
func.call(this); | |
assert(false, "assert_throws", description, | |
"${func} did not throw", {func:func}); | |
} | |
catch(e) | |
{ | |
if (e instanceof AssertionError) { | |
throw(e); | |
} | |
if (typeof code === "object") | |
{ | |
assert(typeof e == "object" && "name" in e && e.name == code.name, | |
"assert_throws", description, | |
"${func} threw ${actual} (${actual_name}) expected ${expected} (${expected_name})", | |
{func:func, actual:e, actual_name:e.name, | |
expected:code, | |
expected_name:code.name}); | |
return; | |
} | |
var required_props = {}; | |
required_props.code = { | |
INDEX_SIZE_ERR: 1, | |
HIERARCHY_REQUEST_ERR: 3, | |
WRONG_DOCUMENT_ERR: 4, | |
INVALID_CHARACTER_ERR: 5, | |
NO_MODIFICATION_ALLOWED_ERR: 7, | |
NOT_FOUND_ERR: 8, | |
NOT_SUPPORTED_ERR: 9, | |
INVALID_STATE_ERR: 11, | |
SYNTAX_ERR: 12, | |
INVALID_MODIFICATION_ERR: 13, | |
NAMESPACE_ERR: 14, | |
INVALID_ACCESS_ERR: 15, | |
TYPE_MISMATCH_ERR: 17, | |
SECURITY_ERR: 18, | |
NETWORK_ERR: 19, | |
ABORT_ERR: 20, | |
URL_MISMATCH_ERR: 21, | |
QUOTA_EXCEEDED_ERR: 22, | |
TIMEOUT_ERR: 23, | |
INVALID_NODE_TYPE_ERR: 24, | |
DATA_CLONE_ERR: 25, | |
}[code]; | |
if (required_props.code === undefined) | |
{ | |
throw new AssertionError('Test bug: unrecognized DOMException code "' + code + '" passed to assert_throws()'); | |
} | |
required_props[code] = required_props.code; | |
//Uncomment this when the latest version of every browser | |
//actually implements the spec; otherwise it just creates | |
//zillions of failures. Also do required_props.type. | |
//required_props.name = code; | |
// | |
//We'd like to test that e instanceof the appropriate interface, | |
//but we can't, because we don't know what window it was created | |
//in. It might be an instanceof the appropriate interface on some | |
//unknown other window. TODO: Work around this somehow? | |
assert(typeof e == "object", | |
"assert_throws", description, | |
"${func} threw ${e} with type ${type}, not an object", | |
{func:func, e:e, type:typeof e}); | |
for (var prop in required_props) | |
{ | |
assert(typeof e == "object" && prop in e && e[prop] == required_props[prop], | |
"assert_throws", description, | |
"${func} threw ${e} that is not a DOMException " + code + ": property ${prop} is equal to ${actual}, expected ${expected}", | |
{func:func, e:e, prop:prop, actual:e[prop], expected:required_props[prop]}); | |
} | |
} | |
} | |
expose(assert_throws, "assert_throws"); | |
function assert_unreached(description) { | |
assert(false, "assert_unreached", description, | |
"Reached unreachable code"); | |
} | |
expose(assert_unreached, "assert_unreached"); | |
function Test(name, properties) | |
{ | |
this.name = name; | |
this.status = this.NOTRUN; | |
this.timeout_id = null; | |
this.is_done = false; | |
this.timeout_length = properties.timeout ? properties.timeout : settings.test_timeout; | |
this.message = null; | |
var this_obj = this; | |
this.steps = []; | |
tests.push(this); | |
} | |
Test.prototype = { | |
PASS:0, | |
FAIL:1, | |
TIMEOUT:2, | |
NOTRUN:3 | |
}; | |
Test.prototype.step = function(func, this_obj) | |
{ | |
//In case the test has already failed | |
if (this.status !== this.NOTRUN) | |
{ | |
return; | |
} | |
tests.started = true; | |
if (this.timeout_id === null) { | |
this.set_timeout(); | |
} | |
this.steps.push(func); | |
if (arguments.length === 1) | |
{ | |
this_obj = this; | |
} | |
try | |
{ | |
func.apply(this_obj, Array.prototype.slice.call(arguments, 2)); | |
} | |
catch(e) | |
{ | |
//This can happen if something called synchronously invoked another | |
//step | |
if (this.status !== this.NOTRUN) | |
{ | |
return; | |
} | |
this.status = this.FAIL; | |
this.message = e.message; | |
if (typeof e.stack != "undefined" && typeof e.message == "string") { | |
//Try to make it more informative for some exceptions, at least | |
//in Gecko and WebKit. This results in a stack dump instead of | |
//just errors like "Cannot read property 'parentNode' of null" | |
//or "root is null". Makes it a lot longer, of course. | |
this.message += "(stack: " + e.stack + ")"; | |
} | |
this.done(); | |
if (debug && e.constructor !== AssertionError) { | |
throw e; | |
} | |
} | |
}; | |
Test.prototype.step_func = function(func, this_obj) | |
{ | |
var test_this = this; | |
if (arguments.length === 1) | |
{ | |
this_obj = test_this; | |
} | |
return function() | |
{ | |
test_this.step.apply(test_this, [func, this_obj].concat( | |
Array.prototype.slice.call(arguments))); | |
}; | |
}; | |
Test.prototype.set_timeout = function() | |
{ | |
var this_obj = this; | |
this.timeout_id = setTimeout(function() | |
{ | |
this_obj.timeout(); | |
}, this.timeout_length); | |
}; | |
Test.prototype.timeout = function() | |
{ | |
this.status = this.TIMEOUT; | |
this.timeout_id = null; | |
this.message = "Test timed out"; | |
this.done(); | |
}; | |
Test.prototype.done = function() | |
{ | |
if (this.is_done) { | |
return; | |
} | |
clearTimeout(this.timeout_id); | |
if (this.status === this.NOTRUN) | |
{ | |
this.status = this.PASS; | |
} | |
this.is_done = true; | |
tests.result(this); | |
}; | |
/* | |
* Harness | |
*/ | |
function TestsStatus() | |
{ | |
this.status = null; | |
this.message = null; | |
} | |
TestsStatus.prototype = { | |
OK:0, | |
ERROR:1, | |
TIMEOUT:2 | |
}; | |
function Tests() | |
{ | |
this.tests = []; | |
this.num_pending = 0; | |
this.phases = { | |
INITIAL:0, | |
SETUP:1, | |
HAVE_TESTS:2, | |
HAVE_RESULTS:3, | |
COMPLETE:4 | |
}; | |
this.phase = this.phases.INITIAL; | |
//All tests can't be done until the load event fires | |
this.all_loaded = false; | |
this.wait_for_finish = false; | |
this.processing_callbacks = false; | |
this.timeout_length = settings.timeout; | |
this.timeout_id = null; | |
this.set_timeout(); | |
this.start_callbacks = []; | |
this.test_done_callbacks = []; | |
this.all_done_callbacks = []; | |
this.status = new TestsStatus(); | |
var this_obj = this; | |
on_event(window, "load", | |
function() | |
{ | |
this_obj.all_loaded = true; | |
if (this_obj.all_done()) | |
{ | |
this_obj.complete(); | |
} | |
}); | |
this.properties = {}; | |
} | |
Tests.prototype.setup = function(func, properties) | |
{ | |
if (this.phase >= this.phases.HAVE_RESULTS) | |
{ | |
return; | |
} | |
if (this.phase < this.phases.SETUP) | |
{ | |
this.phase = this.phases.SETUP; | |
} | |
for (var p in properties) | |
{ | |
if (properties.hasOwnProperty(p)) | |
{ | |
this.properties[p] = properties[p]; | |
} | |
} | |
if (properties.timeout) | |
{ | |
this.timeout_length = properties.timeout; | |
this.set_timeout(); | |
} | |
if (properties.explicit_done) | |
{ | |
this.wait_for_finish = true; | |
} | |
if (func) | |
{ | |
try | |
{ | |
func(); | |
} catch(e) | |
{ | |
this.status.status = this.status.ERROR; | |
this.status.message = e; | |
}; | |
} | |
}; | |
Tests.prototype.set_timeout = function() | |
{ | |
var this_obj = this; | |
clearTimeout(this.timeout_id); | |
this.timeout_id = setTimeout(function() { | |
this_obj.timeout(); | |
}, this.timeout_length); | |
}; | |
Tests.prototype.timeout = function() { | |
this.status.status = this.status.TIMEOUT; | |
this.complete(); | |
}; | |
Tests.prototype.end_wait = function() | |
{ | |
this.wait_for_finish = false; | |
if (this.all_done()) { | |
this.complete(); | |
} | |
}; | |
Tests.prototype.push = function(test) | |
{ | |
if (this.phase < this.phases.HAVE_TESTS) { | |
this.notify_start(); | |
} | |
this.num_pending++; | |
this.tests.push(test); | |
}; | |
Tests.prototype.all_done = function() { | |
return (this.all_loaded && this.num_pending === 0 && | |
!this.wait_for_finish && !this.processing_callbacks); | |
}; | |
Tests.prototype.start = function() { | |
this.phase = this.phases.HAVE_TESTS; | |
this.notify_start(); | |
}; | |
Tests.prototype.notify_start = function() { | |
var this_obj = this; | |
forEach (this.start_callbacks, | |
function(callback) | |
{ | |
callback(this_obj.properties); | |
}); | |
forEach(ancestor_windows(), | |
function(w) | |
{ | |
if(w.start_callback) | |
{ | |
try | |
{ | |
w.start_callback(this_obj.properties); | |
} | |
catch(e) | |
{ | |
if (debug) | |
{ | |
throw(e); | |
} | |
} | |
} | |
}); | |
}; | |
Tests.prototype.result = function(test) | |
{ | |
if (this.phase > this.phases.HAVE_RESULTS) | |
{ | |
return; | |
} | |
this.phase = this.phases.HAVE_RESULTS; | |
this.num_pending--; | |
this.notify_result(test); | |
}; | |
Tests.prototype.notify_result = function(test) { | |
var this_obj = this; | |
this.processing_callbacks = true; | |
forEach(this.test_done_callbacks, | |
function(callback) | |
{ | |
callback(test, this_obj); | |
}); | |
forEach(ancestor_windows(), | |
function(w) | |
{ | |
if(w.result_callback) | |
{ | |
try | |
{ | |
w.result_callback(test); | |
} | |
catch(e) | |
{ | |
if(debug) { | |
throw e; | |
} | |
} | |
} | |
}); | |
this.processing_callbacks = false; | |
if (this_obj.all_done()) | |
{ | |
this_obj.complete(); | |
} | |
}; | |
Tests.prototype.complete = function() { | |
if (this.phase === this.phases.COMPLETE) { | |
return; | |
} | |
this.phase = this.phases.COMPLETE; | |
this.notify_complete(); | |
}; | |
Tests.prototype.notify_complete = function() | |
{ | |
clearTimeout(this.timeout_id); | |
var this_obj = this; | |
if (this.status.status === null) | |
{ | |
this.status.status = this.status.OK; | |
} | |
forEach (this.all_done_callbacks, | |
function(callback) | |
{ | |
callback(this_obj.tests, this_obj.status); | |
}); | |
forEach(ancestor_windows(), | |
function(w) | |
{ | |
if(w.completion_callback) | |
{ | |
try | |
{ | |
w.completion_callback(this_obj.tests, this_obj.status); | |
} | |
catch(e) | |
{ | |
if (debug) | |
{ | |
throw e; | |
} | |
} | |
} | |
}); | |
}; | |
var tests = new Tests(); | |
function add_start_callback(callback) { | |
tests.start_callbacks.push(callback); | |
} | |
function add_result_callback(callback) | |
{ | |
tests.test_done_callbacks.push(callback); | |
} | |
function add_completion_callback(callback) | |
{ | |
tests.all_done_callbacks.push(callback); | |
} | |
expose(add_start_callback, 'add_start_callback'); | |
expose(add_result_callback, 'add_result_callback'); | |
expose(add_completion_callback, 'add_completion_callback'); | |
/* | |
* Output listener | |
*/ | |
function Output() { | |
this.output_document = null; | |
this.output_node = null; | |
this.done_count = 0; | |
this.enabled = settings.output; | |
this.phase = this.INITIAL; | |
} | |
Output.prototype.INITIAL = 0; | |
Output.prototype.STARTED = 1; | |
Output.prototype.HAVE_RESULTS = 2; | |
Output.prototype.COMPLETE = 3; | |
Output.prototype.setup = function(properties) { | |
if (this.phase > this.INITIAL) { | |
return; | |
} | |
//If output is disabled in testharnessreport.js the test shouldn't be | |
//able to override that | |
this.enabled = this.enabled && (properties.hasOwnProperty("output") ? | |
properties.output : settings.output); | |
}; | |
Output.prototype.init = function(properties) | |
{ | |
if (this.phase >= this.STARTED) { | |
return; | |
} | |
if (properties.output_document) { | |
this.output_document = properties.output_document; | |
} else { | |
this.output_document = document; | |
} | |
this.phase = this.STARTED; | |
}; | |
Output.prototype.resolve_log = function() | |
{ | |
if (!this.output_document) { | |
return; | |
} | |
var node = this.output_document.getElementById("log"); | |
if (node) { | |
this.output_node = node; | |
} | |
}; | |
Output.prototype.show_status = function(test) | |
{ | |
if (this.phase < this.STARTED) | |
{ | |
this.init(); | |
} | |
if (!this.enabled) | |
{ | |
return; | |
} | |
if (this.phase < this.HAVE_RESULTS) | |
{ | |
this.resolve_log(); | |
this.phase = this.HAVE_RESULTS; | |
} | |
this.done_count++; | |
if (this.output_node) | |
{ | |
if (this.done_count < 100 | |
|| (this.done_count < 1000 && this.done_count % 100 == 0) | |
|| this.done_count % 1000 == 0) { | |
this.output_node.textContent = "Running, " | |
+ this.done_count + " complete, " | |
+ tests.num_pending + " remain"; | |
} | |
} | |
}; | |
Output.prototype.show_results = function (tests, harness_status) | |
{ | |
if (this.phase >= this.COMPLETE) { | |
return; | |
} | |
if (!this.enabled) | |
{ | |
return; | |
} | |
if (!this.output_node) { | |
this.resolve_log(); | |
} | |
this.phase = this.COMPLETE; | |
var log = this.output_node; | |
if (!log) | |
{ | |
return; | |
} | |
var output_document = this.output_document; | |
while (log.lastChild) | |
{ | |
log.removeChild(log.lastChild); | |
} | |
if (script_prefix != null) { | |
var stylesheet = output_document.createElementNS(xhtml_ns, "link"); | |
stylesheet.setAttribute("rel", "stylesheet"); | |
stylesheet.setAttribute("href", script_prefix + "testharness.css"); | |
var heads = output_document.getElementsByTagName("head"); | |
if (heads.length) { | |
heads[0].appendChild(stylesheet); | |
} | |
} | |
var status_text = {}; | |
status_text[Test.prototype.PASS] = "Pass"; | |
status_text[Test.prototype.FAIL] = "Fail"; | |
status_text[Test.prototype.TIMEOUT] = "Timeout"; | |
status_text[Test.prototype.NOTRUN] = "Not Run"; | |
var status_number = {}; | |
forEach(tests, function(test) { | |
var status = status_text[test.status]; | |
if (status_number.hasOwnProperty(status)) | |
{ | |
status_number[status] += 1; | |
} else { | |
status_number[status] = 1; | |
} | |
}); | |
function status_class(status) | |
{ | |
return status.replace(/\s/g, '').toLowerCase(); | |
} | |
var summary_template = ["section", {"id":"summary"}, | |
["h2", {}, "Summary"], | |
["p", {}, "Found ${num_tests} tests"], | |
function(vars) { | |
var rv = [["div", {}]]; | |
var i=0; | |
while (status_text.hasOwnProperty(i)) { | |
if (status_number.hasOwnProperty(status_text[i])) { | |
var status = status_text[i]; | |
rv[0].push(["div", {"class":status_class(status)}, | |
["label", {}, | |
["input", {type:"checkbox", checked:"checked"}], | |
status_number[status] + " " + status]]); | |
} | |
i++; | |
} | |
return rv; | |
}]; | |
log.appendChild(render(summary_template, {num_tests:tests.length}, output_document)); | |
forEach(output_document.querySelectorAll("section#summary label"), | |
function(element) | |
{ | |
on_event(element, "click", | |
function(e) | |
{ | |
if (output_document.getElementById("results") === null) | |
{ | |
e.preventDefault(); | |
return; | |
} | |
var result_class = element.parentNode.getAttribute("class"); | |
var style_element = output_document.querySelector("style#hide-" + result_class); | |
var input_element = element.querySelector("input"); | |
if (!style_element && !input_element.checked) { | |
style_element = output_document.createElementNS(xhtml_ns, "style"); | |
style_element.id = "hide-" + result_class; | |
style_element.innerHTML = "table#results > tbody > tr."+result_class+"{display:none}"; | |
output_document.body.appendChild(style_element); | |
} else if (style_element && input_element.checked) { | |
style_element.parentNode.removeChild(style_element); | |
} | |
}); | |
}); | |
// This use of innerHTML plus manual escaping is not recommended in | |
// general, but is necessary here for performance. Using textContent | |
// on each individual <td> adds tens of seconds of execution time for | |
// large test suites (tens of thousands of tests). | |
function escape_html(s) | |
{ | |
return s.replace(/\&/g, "&") | |
.replace(/</g, "<") | |
.replace(/"/g, """) | |
.replace(/'/g, "'"); | |
} | |
log.appendChild(document.createElement("section")); | |
var html = "<h2>Details</h2><table id='results'>" | |
+ "<thead><tr><th>Result</th><th>Test Name</th><th>Message</th></tr></thead>" | |
+ "<tbody>"; | |
for (var i = 0; i < tests.length; i++) { | |
html += '<tr class="' | |
+ escape_html(status_class(status_text[tests[i].status])) | |
+ '"><td>' | |
+ escape_html(status_text[tests[i].status]) | |
+ "</td><td>" | |
+ escape_html(format_string(tests[i].name)) | |
+ "</td><td>" | |
+ escape_html(tests[i].message ? format_string(tests[i].message) : " ") | |
+ "</td></tr>"; | |
} | |
log.lastChild.innerHTML = html + "</tbody></table>"; | |
}; | |
var output = new Output(); | |
add_start_callback(function (properties) {output.init(properties);}); | |
add_result_callback(function (test) {output.show_status(tests);}); | |
add_completion_callback(function (tests, harness_status) {output.show_results(tests, harness_status);}); | |
/* | |
* Template code | |
* | |
* A template is just a javascript structure. An element is represented as: | |
* | |
* [tag_name, {attr_name:attr_value}, child1, child2] | |
* | |
* the children can either be strings (which act like text nodes), other templates or | |
* functions (see below) | |
* | |
* A text node is represented as | |
* | |
* ["{text}", value] | |
* | |
* String values have a simple substitution syntax; ${foo} represents a variable foo. | |
* | |
* It is possible to embed logic in templates by using a function in a place where a | |
* node would usually go. The function must either return part of a template or null. | |
* | |
* In cases where a set of nodes are required as output rather than a single node | |
* with children it is possible to just use a list | |
* [node1, node2, node3] | |
* | |
* Usage: | |
* | |
* render(template, substitutions) - take a template and an object mapping | |
* variable names to parameters and return either a DOM node or a list of DOM nodes | |
* | |
* substitute(template, substitutions) - take a template and variable mapping object, | |
* make the variable substitutions and return the substituted template | |
* | |
*/ | |
function is_single_node(template) | |
{ | |
return typeof template[0] === "string"; | |
} | |
function substitute(template, substitutions) | |
{ | |
if (typeof template === "function") { | |
var replacement = template(substitutions); | |
if (replacement) | |
{ | |
var rv = substitute(replacement, substitutions); | |
return rv; | |
} | |
else | |
{ | |
return null; | |
} | |
} | |
else if (is_single_node(template)) | |
{ | |
return substitute_single(template, substitutions); | |
} | |
else | |
{ | |
return filter(map(template, function(x) { | |
return substitute(x, substitutions); | |
}), function(x) {return x !== null;}); | |
} | |
} | |
function substitute_single(template, substitutions) | |
{ | |
var substitution_re = /\${([^ }]*)}/g; | |
function do_substitution(input) { | |
var components = input.split(substitution_re); | |
var rv = []; | |
for (var i=0; i<components.length; i+=2) | |
{ | |
rv.push(components[i]); | |
if (components[i+1]) | |
{ | |
rv.push(String(substitutions[components[i+1]])); | |
} | |
} | |
return rv; | |
} | |
var rv = []; | |
rv.push(do_substitution(String(template[0])).join("")); | |
if (template[0] === "{text}") { | |
substitute_children(template.slice(1), rv); | |
} else { | |
substitute_attrs(template[1], rv); | |
substitute_children(template.slice(2), rv); | |
} | |
function substitute_attrs(attrs, rv) | |
{ | |
rv[1] = {}; | |
for (var name in template[1]) | |
{ | |
if (attrs.hasOwnProperty(name)) | |
{ | |
var new_name = do_substitution(name).join(""); | |
var new_value = do_substitution(attrs[name]).join(""); | |
rv[1][new_name] = new_value; | |
}; | |
} | |
} | |
function substitute_children(children, rv) | |
{ | |
for (var i=0; i<children.length; i++) | |
{ | |
if (children[i] instanceof Object) { | |
var replacement = substitute(children[i], substitutions); | |
if (replacement !== null) | |
{ | |
if (is_single_node(replacement)) | |
{ | |
rv.push(replacement); | |
} | |
else | |
{ | |
extend(rv, replacement); | |
} | |
} | |
} | |
else | |
{ | |
extend(rv, do_substitution(String(children[i]))); | |
} | |
} | |
return rv; | |
} | |
return rv; | |
} | |
function make_dom_single(template, doc) | |
{ | |
var output_document = doc || document; | |
if (template[0] === "{text}") | |
{ | |
var element = output_document.createTextNode(""); | |
for (var i=1; i<template.length; i++) | |
{ | |
element.data += template[i]; | |
} | |
} | |
else | |
{ | |
var element = output_document.createElementNS(xhtml_ns, template[0]); | |
for (var name in template[1]) { | |
if (template[1].hasOwnProperty(name)) | |
{ | |
element.setAttribute(name, template[1][name]); | |
} | |
} | |
for (var i=2; i<template.length; i++) | |
{ | |
if (template[i] instanceof Object) | |
{ | |
var sub_element = make_dom(template[i]); | |
element.appendChild(sub_element); | |
} | |
else | |
{ | |
var text_node = output_document.createTextNode(template[i]); | |
element.appendChild(text_node); | |
} | |
} | |
} | |
return element; | |
} | |
function make_dom(template, substitutions, output_document) | |
{ | |
if (is_single_node(template)) | |
{ | |
return make_dom_single(template, output_document); | |
} | |
else | |
{ | |
return map(template, function(x) { | |
return make_dom_single(x, output_document); | |
}); | |
} | |
} | |
function render(template, substitutions, output_document) | |
{ | |
return make_dom(substitute(template, substitutions), output_document); | |
} | |
/* | |
* Utility funcions | |
*/ | |
function assert(expected_true, function_name, description, error, substitutions) | |
{ | |
if (expected_true !== true) | |
{ | |
throw new AssertionError(make_message(function_name, description, | |
error, substitutions)); | |
} | |
} | |
function AssertionError(message) | |
{ | |
this.message = message; | |
} | |
function make_message(function_name, description, error, substitutions) | |
{ | |
for (var p in substitutions) { | |
if (substitutions.hasOwnProperty(p)) { | |
substitutions[p] = format_value(substitutions[p]); | |
} | |
} | |
var node_form = substitute(["{text}", "${function_name}: ${description}" + error], | |
merge({function_name:function_name, | |
description:(description?description + " ":"")}, | |
substitutions)); | |
return node_form.slice(1).join(""); | |
} | |
function filter(array, callable, thisObj) { | |
var rv = []; | |
for (var i=0; i<array.length; i++) | |
{ | |
if (array.hasOwnProperty(i)) | |
{ | |
var pass = callable.call(thisObj, array[i], i, array); | |
if (pass) { | |
rv.push(array[i]); | |
} | |
} | |
} | |
return rv; | |
} | |
function map(array, callable, thisObj) | |
{ | |
var rv = []; | |
rv.length = array.length; | |
for (var i=0; i<array.length; i++) | |
{ | |
if (array.hasOwnProperty(i)) | |
{ | |
rv[i] = callable.call(thisObj, array[i], i, array); | |
} | |
} | |
return rv; | |
} | |
function extend(array, items) | |
{ | |
Array.prototype.push.apply(array, items); | |
} | |
function forEach (array, callback, thisObj) | |
{ | |
for (var i=0; i<array.length; i++) | |
{ | |
if (array.hasOwnProperty(i)) | |
{ | |
callback.call(thisObj, array[i], i, array); | |
} | |
} | |
} | |
function merge(a,b) | |
{ | |
var rv = {}; | |
var p; | |
for (p in a) | |
{ | |
rv[p] = a[p]; | |
} | |
for (p in b) { | |
rv[p] = b[p]; | |
} | |
return rv; | |
} | |
function expose(object, name) | |
{ | |
var components = name.split("."); | |
var target = window; | |
for (var i=0; i<components.length - 1; i++) | |
{ | |
if (!(components[i] in target)) | |
{ | |
target[components[i]] = {}; | |
} | |
target = target[components[i]]; | |
} | |
target[components[components.length - 1]] = object; | |
} | |
function ancestor_windows() { | |
//Get the windows [self ... top] as an array | |
if ("result_cache" in ancestor_windows) | |
{ | |
return ancestor_windows.result_cache; | |
} | |
var rv = [self]; | |
var w = self; | |
while (w != w.parent) | |
{ | |
w = w.parent; | |
rv.push(w); | |
} | |
ancestor_windows.result_cache = rv; | |
return rv; | |
} | |
})(); | |
// vim: set expandtab shiftwidth=4 tabstop=4: |