Update web-platform-tests to revision a46616a5b18e83587ddbbed756c7b96cbb4b015d

tests/wpt/web-platform-tests/resources/test/README.md

@@ -0,0 +1,61 @@
+# `testharness.js` test suite
+
+The test suite for the `testharness.js` testing framework.
+
+## Executing Tests
+
+Install the following dependencies:
+
+- [Python 2.7](https://www.python.org/)
+- [the tox Python package](https://tox.readthedocs.io/en/latest/)
+- [the Mozilla Firefox web browser](https://mozilla.org/firefox)
+- [the GeckoDriver server](https://github.com/mozilla/geckodriver)
+
+Once these dependencies are satisfied, the tests may be run from a command line
+by executing the following command from this directory:
+
+    tox
+
+## Authoring Tests
+
+Test cases are expressed as `.html` files located within the `tests/`
+sub-directory. Each test should include the `testharness.js` library with the
+following markup:
+
+    <script src="../../testharness.js"></script>
+    <script src="../../testharnessreport.js"></script>
+
+This should be followed by one or more `<script>` tags that interface with the
+`testharness.js` API in some way. For example:
+
+    <script>
+    test(function() {
+        1 = 1;
+      }, 'This test is expected to fail.');
+    </script>
+
+Finally, each test may include a summary of the expected results as a JSON
+string within a `<script>` tag with an `id` of `"expected"`, e.g.:
+
+    <script type="text/json" id="expected">
+    {
+      "summarized_status": {
+        "message": null,
+        "stack": null,
+        "status_string": "OK"
+      },
+      "summarized_tests": [
+        {
+          "message": "ReferenceError: invalid assignment left-hand side",
+          "name": "Sample HTML5 API Tests",
+          "properties": {},
+          "stack": "(implementation-defined)",
+          "status_string": "FAIL"
+        }
+      ],
+      "type": "complete"
+    }
+    </script>
+
+This is useful to test, for example, whether asserations that should fail or
+throw actually do.