mirror of
https://github.com/roytam1/mozilla45esr.git
synced 2026-05-26 15:39:48 +00:00
b5b03bdced
- Issue #607: new, separate blocklist in caps/ for scripts that can crash the browser, but have no obvious workaround (#609) (5748c7513) - incorporate #608, #609 (256479e9f) - closes #610: M1317422 + tests (f187b2dfe) - #612: M969874 M1525628 (689819e12) - #612: M1019551 (7850b17a7) - #604: M1236639 M1257931 M1256590 M1291543 M1363647 + backbugs (80ece6a15) - #611: M1277475 (0c828a96e) - #611: M1644477 (6ad5c12da) - #611: update TLDs, HSTS (67c056259)
JS Test Suite Readme
====================
The JS test suite is a fairly extensive collection of correctness and regression
tests for the Spidermonkey engine. Two harnesses run these tests: the shell test
harness in this directory and the "reftest" harness built into the browser, used
by Tinderbox. The browser reftests require additional manifest files; these are
generated automatically by the build phase 'package-tests' using the
'--make-manifests' option to jstests.py.
Creating a test
---------------
For general information, see
https://developer.mozilla.org/en-US/docs/SpiderMonkey/Creating_JavaScript_tests
Adding a test
-------------
Drop it in an appropriate directory under the tests directory.
<fineprint> Some names are forbidden. Do not name your test browser.js,
shell.js, jsref.js, template.js, user.js, js-test-driver-begin.js, or
js-test-driver-end.js, or any of the names of the files in supporting/.
</fineprint>
Adjusting when and how a test runs
----------------------------------
Put a comment at the top of the header matching the format:
// |reftest| <failure-type> -- <comment>
Where <failure-type> is a standard reftest <failure-type> string, as documented by:
http://mxr.mozilla.org/mozilla-central/source/layout/tools/reftest/README.txt
Example:
// |reftest| skip-if(!xulRuntime.shell) -- does not always dismiss alert
<fineprint> Either // or /* */ style comments may be used. The entire
comment must appear in the first 512 bytes of the file. The control
string must be in its own comment block. </fineprint>
When adding such comments to individual files is not feasible (e.g., for
imported tests), reftest manifest entries can be added to jstests.list
instead. Combining in-file comments with entries in this manifest file for
the same files is not supported (the one from the manifest file will be
used). Only the following two forms are supported:
<failure-type> include <relative_path>
<failure-type> script <relative_path>
The <type> "include" indicates that <failure-type> should apply to all test
cases within a directory. A statement for a nested directory or script
overrides one for an enclosing directory.
Running tests
-------------
See
https://developer.mozilla.org/en-US/docs/SpiderMonkey/Running_Automated_JavaScript_Tests