Merge branch 'main' into testing-plan-guide

Author: ioannad

.github/workflows/esmeta-test262.yml

@@ -21,7 +21,7 @@ jobs:
       - name: download esmeta
         run: |
           mkdir -p "${ESMETA_HOME}"
-          git clone --branch v0.4.1 --depth 1 https://github.com/es-meta/esmeta.git "${ESMETA_HOME}"
+          git clone --branch v0.4.2 --depth 1 https://github.com/es-meta/esmeta.git "${ESMETA_HOME}"
           cd "${ESMETA_HOME}" && git submodule update --init --depth 1
       - name: build esmeta
         working-directory: ${{ env.ESMETA_HOME }}

.hgignore

@@ -209,8 +209,9 @@ This key is for boolean properties associated with the test.
 - **raw** - execute the test without any modification (no harness files will be
   included); necessary to test the behavior of directive prologue; implies
   `noStrict`
-- **async** - defer interpretation of test results until after the invocation
-  of the global `$DONE` function
+- **async** - defer interpretation of test results until settlement of an
+  `asyncTest` callback promise or manual invocation of `$DONE`; refer to
+  [Writing Asynchronous Tests](#writing-asynchronous-tests) for details
 - **generated** - informative flag used to denote test files that were
   created procedurally using the project's test generation tool; refer to
   [Procedurally-generated tests](#procedurally-generated-tests)
@@ -346,7 +347,7 @@ Consumers that violate the spec by throwing exceptions for parsing errors at run
 
 An asynchronous test is any test that include the `async` frontmatter flag.
 
-For most asynchronous tests, the `asyncHelpers.js` harness file includes an `asyncTest` method that precludes needing to interact with the test runner via the `$DONE` function. `asyncTest` takes an async function and will ensure that `$DONE` is called properly if the async function returns or throws an exception. For example, a test written using `asyncTest` might look like:
+Most asynchronous tests should include the `asyncHelpers.js` harness file and call its `asyncTest` function **exactly once**, with a callback returning a promise that indicates test failure via rejection and otherwise fulfills upon test conclusion (such as an async function).
 
 ```js
 /*---

CONTRIBUTING.md

@@ -42,6 +42,7 @@ properties of the global scope prior to test execution.
   the test runner. This is used as a communication mechanism for asynchronous
   tests (via the `async` flag, described below).
 - **`$262`** An ordinary object with the following properties:
+  - **`AbstractModuleSource`** - a reference to the `%AbstractModuleSource%` constructor which does not appear as a property of the global object.
   - **`createRealm`** - a function which creates a new [ECMAScript
     Realm](https://tc39.github.io/ecma262/#sec-code-realms),
     defines this API on the new realm's global object, and returns the `$262`
@@ -160,6 +161,12 @@ located at `test/language/import/nested/dep.js`.
 
 Files bearing a name ending in `.json` are intended to be interpreted as JSON.
 
+Implementers should resolve the specifier `<module source>` to a module that
+provides a valid [Module Source](https://tc39.es/proposal-source-phase-imports/#sec-module-source-objects),
+such as a [WebAssembly module](https://webassembly.github.io/esm-integration/js-api/index.html#webassembly-module-record).
+Tests use `<module source>` specifier are guarded with a feature flag
+`source-phase-imports-module-source`.
+
 ### Staging
 
 Tests in the `test/staging/` folder are expected to be executed just like all the other tests, in order to promote interoperability as soon as possible.

INTERPRETING.md

@@ -1,11 +1,11 @@
-The << Software identified by reference to the Ecma Standard* ("Software)">>  is protected by copyright and is being 
+Test262: ECMAScript Test Suite ("Software") is protected by copyright and is being 
 made available under the  "BSD License", included below. This Software may be subject to third party rights (rights 
 from parties other than Ecma International), including patent rights, and no licenses under such third party rights 
 are granted under this license even if the third party concerned is a member of Ecma International.  SEE THE ECMA 
-CODE OF CONDUCT IN PATENT MATTERS AVAILABLE AT http://www.ecma-international.org/memento/codeofconduct.htm FOR 
+CODE OF CONDUCT IN PATENT MATTERS AVAILABLE AT https://www.ecma-international.org/ipr FOR 
 INFORMATION REGARDING THE LICENSING OF PATENT CLAIMS THAT ARE REQUIRED TO IMPLEMENT ECMA INTERNATIONAL STANDARDS*.
 
-Copyright (C) 2012-2013 Ecma International
+Copyright (C) 2012 Ecma International
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without modification, are permitted provided that the 
@@ -25,4 +25,4 @@ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT
 NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH 
 DAMAGE.
 
-* Ecma International Standards hereafter means Ecma International Standards as well as Ecma Technical Reports
+* Ecma International Standards hereafter means Ecma International Standards as well as Ecma Technical Reports

LICENSE

@@ -15,10 +15,6 @@
 # https://github.com/tc39/proposal-intl-locale-info
 Intl.Locale-info
 
-# FinalizationRegistry#cleanupSome
-# https://github.com/tc39/proposal-cleanup-some
-FinalizationRegistry.prototype.cleanupSome
-
 # Intl.NumberFormat V3
 # https://github.com/tc39/proposal-intl-numberformat-v3
 Intl.NumberFormat-v3
@@ -27,32 +23,6 @@ Intl.NumberFormat-v3
 # https://github.com/tc39/proposal-regexp-legacy-features
 legacy-regexp
 
-# Atomics.waitAsync
-# https://github.com/tc39/proposal-atomics-wait-async
-Atomics.waitAsync
-
-# Import Attributes
-# https://github.com/tc39/proposal-import-attributes/
-import-attributes
-
-# Import Assertions (Normative Optional, Deprecated)
-# This feature should not be implemented, but if it is it must
-# respect the specified behavior
-# https://github.com/tc39/proposal-import-attributes/
-import-assertions
-
-# JSON modules
-# https://github.com/tc39/proposal-json-modules
-json-modules
-
-# Resizable Arraybuffer
-# https://github.com/tc39/proposal-resizablearraybuffer
-resizable-arraybuffer
-
-# ArrayBuffer transfer
-# https://github.com/tc39/proposal-arraybuffer-transfer
-arraybuffer-transfer
-
 # Temporal
 # https://github.com/tc39/proposal-temporal
 Temporal
@@ -61,18 +31,10 @@ Temporal
 # https://github.com/tc39/proposal-realms
 ShadowRealm
 
-# Object.groupBy & Map.groupBy
-# https://github.com/tc39/proposal-array-grouping
-array-grouping
-
 # Intl.DurationFormat
 # https://github.com/tc39/proposal-intl-duration-format
 Intl.DurationFormat
 
-# RegExp set notation + properties of strings
-# https://github.com/tc39/proposal-regexp-set-notation
-regexp-v-flag
-
 # Decorators
 # https://github.com/tc39/proposal-decorators
 decorators
@@ -84,34 +46,13 @@ regexp-duplicate-named-groups
 # https://tc39.es/proposal-array-from-async/
 Array.fromAsync
 
-# Well-formed Unicode strings
-# https://github.com/tc39/proposal-is-usv-string
-String.prototype.isWellFormed
-String.prototype.toWellFormed
-
 # JSON.parse with source
 # https://github.com/tc39/proposal-json-parse-with-source
 json-parse-with-source
 
-# Regular expression modifiers
-# https://github.com/tc39/proposal-regexp-modifiers
-regexp-modifiers
-
-# Iterator Helpers
-# https://github.com/tc39/proposal-iterator-helpers
-iterator-helpers
-
-# Promise.withResolvers
-# https://github.com/tc39/proposal-promise-with-resolvers
-promise-with-resolvers
-
-# Promise.try
-# https://github.com/tc39/proposal-promise-try
-promise-try
-
-# Set methods
-# https://github.com/tc39/proposal-set-methods
-set-methods
+# RegExp.escape
+# https://github.com/tc39/proposal-regex-escaping
+RegExp.escape
 
 # Explicit Resource Management
 # https://github.com/tc39/proposal-explicit-resource-management
@@ -121,6 +62,24 @@ explicit-resource-management
 # https://github.com/tc39/proposal-float16array
 Float16Array
 
+# Math.sumPrecise
+# https://github.com/tc39/proposal-math-sum
+Math.sumPrecise
+
+# Source Phase Imports
+## https://github.com/tc39/proposal-source-phase-imports
+source-phase-imports
+## test262 special specifier
+source-phase-imports-module-source
+
+# Uint8Array Base64
+# https://github.com/tc39/proposal-arraybuffer-base64
+uint8array-base64
+
+# Atomics.pause
+# https://github.com/tc39/proposal-atomics-microwait
+Atomics.pause
+
 ## Standard language features
 #
 # Language features that have been included in a published version of the
@@ -138,6 +97,9 @@ Array.prototype.flat
 Array.prototype.flatMap
 Array.prototype.includes
 Array.prototype.values
+Atomics.waitAsync
+array-grouping
+arraybuffer-transfer
 arrow-function
 async-iteration
 async-functions
@@ -182,7 +144,9 @@ Float64Array
 generators
 globalThis
 hashbang
+import-attributes
 import.meta
+iterator-helpers
 Int8Array
 Int16Array
 Int32Array
@@ -200,6 +164,7 @@ Intl.Locale
 Intl.NumberFormat-unified
 Intl.RelativeTimeFormat
 Intl.Segmenter
+json-modules
 json-superset
 let
 logical-assignment-operators
@@ -217,6 +182,8 @@ Promise
 Promise.allSettled
 Promise.any
 Promise.prototype.finally
+promise-with-resolvers
+promise-try
 Proxy
 proxy-missing-checks  # https://github.com/tc39/ecma262/pull/666
 Reflect
@@ -226,20 +193,26 @@ Reflect.setPrototypeOf
 regexp-dotall
 regexp-lookbehind
 regexp-match-indices
+regexp-modifiers
 regexp-named-groups
 regexp-unicode-property-escapes
+regexp-v-flag
+resizable-arraybuffer
 rest-parameters
 Set
+set-methods
 SharedArrayBuffer
 string-trimming
 String.fromCodePoint
 String.prototype.at
 String.prototype.endsWith
 String.prototype.includes
+String.prototype.isWellFormed
 String.prototype.matchAll
 String.prototype.replaceAll
 String.prototype.trimEnd
 String.prototype.trimStart
+String.prototype.toWellFormed
 super
 Symbol
 symbols-as-weakmap-keys