Document requirements for module tests

This commit is contained in:
jugglinmike 2016-06-21 12:17:51 -04:00 committed by Leo Balter
parent 1e6cbbf7ba
commit 11d5b4f18b
1 changed files with 26 additions and 1 deletions

View File

@ -75,6 +75,30 @@ semicolon (`;`) and newline character (`\n`):
This must precede any additional text modifications described by test metadata. This must precede any additional text modifications described by test metadata.
### Modules
Test262 includes tests for ECMAScript 2015 module code, denoted by the "module"
metadata flag. Files bearing a name ending in `_FIXTURE.js` should not be
interpreted as standalone tests; they are intended to be referenced by test
files.
All module specifiers used by Test262 begin with the character sequence `./`.
The remaining characters should be interpreted as the name of a file within the
same directory as the file under test. The contents of this file must be
interpreted as UTF-8-encoded text and supplied to the Source Text Module
Record's ParseModule abstract operation. The result of that operation must be
returned by the implementation-defined HostResolveImportedModule directly.
For example, consider a test file located at
`test/language/import/nested/index.js` with the following contents:
```js
import * as ns from './dep.js';
```
Implementers should attempt to resolve this module specifier by loading a file
located at `test/language/import/nested/dep.js`.
## Test Results ## Test Results
By default, tests signal failure by generating an uncaught exception. If By default, tests signal failure by generating an uncaught exception. If
@ -167,7 +191,8 @@ following strings:
In addition, this flag negates the default requirement to execute the test In addition, this flag negates the default requirement to execute the test
both in strict mode and in non-strict mode. In other words, the both in strict mode and in non-strict mode. In other words, the
transformation described by the section titled "Strict Mode" must **not** be transformation described by the section titled "Strict Mode" must **not** be
applied to these tests. applied to these tests. Refer to the section titled "Modules" for more
information on interpreting these tests.
*Example* *Example*