mirror of https://github.com/tc39/test262.git
INTERPRETING.md: make IsHTMLDDA easier to read
This commit is contained in:
parent
1d142259bc
commit
78ba9101df
|
@ -1,3 +1,4 @@
|
||||||
|
|
||||||
# Interpreting Test262 Tests
|
# Interpreting Test262 Tests
|
||||||
|
|
||||||
All tests are declared as text files located within this project's `test`
|
All tests are declared as text files located within this project's `test`
|
||||||
|
@ -66,15 +67,16 @@ properties of the global scope prior to test execution.
|
||||||
- **`gc`** - a function that wraps the host's garbage collection invocation mechanism, if such a capability exists. Must throw an exception if no capability exists. This is necessary for testing the semantics of any feature that relies on garbage collection, e.g. the `WeakRef` API.
|
- **`gc`** - a function that wraps the host's garbage collection invocation mechanism, if such a capability exists. Must throw an exception if no capability exists. This is necessary for testing the semantics of any feature that relies on garbage collection, e.g. the `WeakRef` API.
|
||||||
- **`global`** - a reference to the global object on which `$262` was initially defined
|
- **`global`** - a reference to the global object on which `$262` was initially defined
|
||||||
- **`IsHTMLDDA`** - (present only in implementations that can provide it) an
|
- **`IsHTMLDDA`** - (present only in implementations that can provide it) an
|
||||||
object that 1) has an [[IsHTMLDDA]] internal slot, and 2) when called with
|
object that:
|
||||||
no arguments or with the single argument `""` returns `null`. Use this
|
|
||||||
property to test that ECMAScript algorithms aren't mis-implemented to treat
|
1. has an [[IsHTMLDDA]] internal slot, and
|
||||||
`document.all` as being `undefined` or of type Undefined (instead of
|
2. when called with no arguments or with the single argument `""` (an empty string) returns `null`.
|
||||||
Object). (The peculiar second requirement permits testing algorithms when
|
|
||||||
they also call `document.all` with such arguments, so that testing for
|
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.
|
||||||
correct behavior requires knowing how the call behaves. This is rarely
|
|
||||||
necessary.) Tests using this function must be tagged with the `IsHTMLDDA`
|
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).
|
||||||
feature so that only hosts supporting this property will run them.
|
|
||||||
|
**Tests using this function must be tagged with the `IsHTMLDDA` feature so that only hosts supporting this property will run them.**
|
||||||
- **`agent`** - an ordinary object with the following properties:
|
- **`agent`** - an ordinary object with the following properties:
|
||||||
- **`start`** - a function that takes a script source string and runs
|
- **`start`** - a function that takes a script source string and runs
|
||||||
the script in a concurrent agent. Will block until that agent is
|
the script in a concurrent agent. Will block until that agent is
|
||||||
|
|
Loading…
Reference in New Issue