You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -299,8 +299,8 @@ function Test262Error(message) {
299
299
300
300
The [Module section of INTERPRETING.md](https://github.com/tc39/test262/blob/HEAD/INTERPRETING.md#modules) states that `_FIXTURE` files will not have Realm modifications applied. In practice, this means that code in `_FIXTURE` files must abide by the following rules:
301
301
302
-
-**MUST NOT** refer to, or make use of any [Test262-Defined Bindings](https://github.com/tc39/test262/blob/HEAD/INTERPRETING.md#test262-defined-bindings) in any way.
303
-
-**MUST NOT** refer to, or make use of any [Host-Defined Functions](https://github.com/tc39/test262/blob/HEAD/INTERPRETING.md#host-defined-functions) in any way.
302
+
-**MUST NOT** refer to, or make use of any [Test262-Defined Bindings](https://github.com/tc39/test262/blob/HEAD/INTERPRETING.md#test262-defined-bindings) in any way.
303
+
-**MUST NOT** refer to, or make use of any [Host-Defined Functions](https://github.com/tc39/test262/blob/HEAD/INTERPRETING.md#host-defined-functions) in any way.
304
304
305
305
## Handling Errors and Negative Test Cases
306
306
@@ -458,14 +458,14 @@ Tests expressed with this convention are built automatically following the sourc
Copy file name to clipboardExpand all lines: INTERPRETING.md
+21-16Lines changed: 21 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -71,13 +71,13 @@ properties of the global scope prior to test execution.
71
71
-**`IsHTMLDDA`** - (present only in implementations that can provide it) an
72
72
object that:
73
73
74
-
1. has an [[IsHTMLDDA]] internal slot, and
75
-
2. when called with no arguments or with the first argument `""` (an empty string) returns `null`.
74
+
1. has an [[IsHTMLDDA]] internal slot, and
75
+
2. when called with no arguments or with the first argument `""` (an empty string) returns `null`.
76
+
77
+
Note: The peculiar second requirement permits testing algorithms when they also call `document.all` with such arguments, so that testing for correct behavior requires knowing how the call behaves. This is rarely necessary.
76
78
77
-
Note: The peculiar second requirement permits testing algorithms when they also call `document.all` with such arguments, so that testing for correct behavior requires knowing how the call behaves. This is rarely necessary.
78
-
79
79
Use this property to test that ECMAScript algorithms aren't mis-implemented to treat `document.all` as being `undefined` or of type Undefined (instead of Object).
80
-
80
+
81
81
**Tests using this function must be tagged with the `IsHTMLDDA` feature so that only hosts supporting this property will run them.**
82
82
-**`agent`** - an ordinary object with the following properties:
83
83
-**`start`** - a function that takes a script source string and runs
@@ -98,10 +98,10 @@ properties of the global scope prior to test execution.
98
98
-**`leaving`** - a function that signals that the agent is done and
99
99
may be terminated (if possible).
100
100
-**`monotonicNow`** - a function that returns a value that conforms to [`DOMHighResTimeStamp`][] and is produced in such a way that its semantics conform to **[Monotonic Clock][]**.
101
-
-**`broadcast`** - a function that takes a SharedArrayBuffer and an
102
-
Int32 or BigInt and broadcasts the two values to all concurrent
103
-
agents. The function blocks until all agents have retrieved the
104
-
message. Note, this assumes that all agents that were started are
101
+
-**`broadcast`** - a function that takes a SharedArrayBuffer and an
102
+
Int32 or BigInt and broadcasts the two values to all concurrent
103
+
agents. The function blocks until all agents have retrieved the
104
+
message. Note, this assumes that all agents that were started are
105
105
still running.
106
106
-**`getReport`** - a function that reads an incoming string from any agent,
107
107
and returns it if it exists, or returns `null` otherwise.
@@ -208,15 +208,15 @@ an exception, or if the name of the thrown exception's constructor does not
208
208
match the specified constructor name, or if the error occurs at a phase that
209
209
differs from the indicated phase, the test must be interpreted as "failing."
210
210
211
-
The **`$DONOTEVALUATE()`** function is for use in tests that include the following meta data:
211
+
The **`$DONOTEVALUATE()`** function is for use in tests that include the following meta data:
212
212
213
213
```
214
214
negative:
215
215
phase: runtime
216
216
type: ReferenceError
217
217
```
218
218
219
-
The definition is considered "runner implementation defined" and no guarantees can be made about its behavior, therefore it is restricted to only tests that meet the criteria described above.
219
+
The definition is considered "runner implementation defined" and no guarantees can be made about its behavior, therefore it is restricted to only tests that meet the criteria described above.
220
220
221
221
*Examples:*
222
222
@@ -258,8 +258,11 @@ export {} from './instn-resolve-empty-export_FIXTURE.js';
258
258
### `includes`
259
259
260
260
One or more files whose content must be evaluated in the test realm's global
261
-
scope prior to test execution. These files are located within the `harness/`
262
-
directory of the Test262 project.
261
+
scope prior to test execution, after the files listed in the
262
+
[Test262-Defined Bindings](#test262-defined-bindings) section and the file
263
+
listed for the `async` flag below.
264
+
They must be included in the order given in the source.
265
+
These files are located within the `harness/` directory of the Test262 project.
263
266
264
267
*Example*
265
268
@@ -348,9 +351,11 @@ following strings:
348
351
```
349
352
350
353
-**`async`** The file `harness/doneprintHandle.js` must be evaluated in the
351
-
test realm's global scope prior to test execution. The test must not be
352
-
considered complete until the implementation-defined `print` function has
353
-
been invoked or some length of time has passed without any such invocation.
354
+
test realm's global scope prior to test execution, after the files listed in
355
+
the [Test262-Defined Bindings](#test262-defined-bindings) section.
356
+
The test must not be considered complete until the implementation-defined
357
+
`print` function has been invoked or some length of time has passed without
358
+
any such invocation.
354
359
In the event of a passing test run, this function will be invoked with the
355
360
string `'Test262:AsyncTestComplete'`. If invoked with a string that is
356
361
prefixed with the character sequence `Test262:AsyncTestFailure:`, the test
0 commit comments