Draft ECMA-262 / June 25, 2026
ECMAScript® 2027 语言规范
关于本规范
位于 https://tc39.es/ecma262/ 的文档是最准确且最新的 ECMAScript 规范。它
参与本规范
本规范在 GitHub 上借助 ECMAScript 社区的帮助进行开发。有多种方式可以参与本规范的开发：
- GitHub 仓库：https://github.com/tc39/ecma262
- 议题：所有议题、提交新议题
- 拉取请求：所有拉取请求、创建新拉取请求
- 测试套件：Test262
- 编辑：
-
社区：
- Discourse：https://es.discourse.group/
- 聊天：Matrix
- 邮件
列表 归档：https://esdiscuss.org/
有关本文档如何创建的更多信息，请参阅
引言
本 Ecma 标准定义了 ECMAScript 2027 语言。它是 ECMAScript 语言规范的第十八版。ECMAScript 基于若干源头技术，其中最著名的是 JavaScript（Netscape）和 JScript（Microsoft）。该语言由 Netscape 的 Brendan Eich 发明，并首次出现在该公司的 Navigator 2.0 浏览器中。尽管它最广为人知的是嵌入在 Web 浏览器中的语言，但也已被广泛采用在浏览器之外使用，包括服务器和嵌入式应用程序，并已成长为世界上使用最广泛的通用编程语言之一。
ECMAScript 语言规范的开发始于 1996 年 11 月。本 Ecma 标准的第一版由 1997 年 6 月的 Ecma 大会采纳。
该 Ecma 标准根据快速通道程序提交给 ISO/IEC JTC 1 采纳，并于 1998 年 4 月被批准为国际标准 ISO/IEC 16262。1998 年 6 月的 Ecma 大会批准了 ECMA-262 第二版，以使其与 ISO/IEC 16262 完全保持一致。第一版与第二版之间的变更属于编辑性质。
该标准第三版引入了强大的正则表达式、更好的字符串处理、新的控制语句、try/catch 异常处理、对错误更严格的定义、数值输出格式化以及为未来语言发展预留的若干小改动。ECMAScript 标准第三版由 1999 年 12 月的 Ecma 大会采纳，并于 2002 年 6 月以 ISO/IEC 16262:2002 发布。
第三版发布后，ECMAScript 随万维网一起获得了大规模采用，并已成为基本上所有 Web 浏览器都支持的编程语言。曾对 ECMAScript 第四版进行过大量开发工作。然而，该工作并未完成，也未作为 ECMAScript 第四版发布，但其中一部分被纳入了第六版的开发。
ECMAScript 第五版（以 ECMA-262 第 5th 版发布）将浏览器实现中已变得常见的对语言规范的事实解释规范化，并增加了对自第三版发布以来出现的新特性的支持。这些特性包括
第五版根据快速通道程序提交给 ISO/IEC JTC 1 采纳，并被批准为国际标准 ISO/IEC 16262:2011。ECMAScript 标准 5.1 版纳入了少量修正，其文本与 ISO/IEC 16262:2011 相同。5.1 版由 2011 年 6 月的 Ecma 大会采纳。
第六版的集中开发始于 2009 年，当时第五版正在准备发布。不过，在此之前已经有重要的实验和语言增强设计工作，其时间可追溯到 1999 年第三版发布之时。从非常真实的意义上说，第六版的完成是十五年努力的结晶。该版本的目标包括为大型应用程序、库创建以及将 ECMAScript 用作其他语言的编译目标提供更好的支持。其若干主要增强包括模块、类声明、词法块级作用域、迭代器和生成器、用于异步编程的 Promise、解构模式以及正确的尾调用。ECMAScript 内置库得到扩展，以支持额外的数据抽象，包括映射、集合和二进制数值数组，以及对字符串和正则表达式中 Unicode 补充字符的额外支持。内置对象也通过子类化变得可扩展。第六版为常规的、渐进式的语言和库增强奠定了基础。第六版由 2015 年 6 月的大会采纳。
ECMAScript 2016 是在 Ecma TC39 新的年度发布节奏和开放开发流程下发布的第一个 ECMAScript 版本。一个纯文本源文档基于 ECMAScript 2015 源文档构建，用作完全在 GitHub 上进一步开发的基础。在这一标准一年的开发过程中，提交了数百个拉取请求和议题，代表着数千项缺陷修复、编辑修复和其他改进。此外，还开发了大量软件工具以辅助这项工作，包括 Ecmarkup、Ecmarkdown 和 Grammarkdown。ES2016 还Array.prototype 添加了一个名为 includes 的新方法。
ECMAScript 2017 引入了 Async Functions、Shared Memory 和 Atomics，以及较小的语言和库增强、缺陷修复和编辑更新。Async 函数通过为返回 Promise 的函数提供语法，改善了异步编程体验。Shared Memory 和 Atomics 引入了一种新的Object.values、Object.entries 和 Object.getOwnPropertyDescriptors。
ECMAScript 2018 通过 dotAll 标志、命名捕获组、Unicode 属性转义和后行断言。最后，它还
ECMAScript 2019 引入了若干新的内置函数：Array.prototype 上用于扁平化数组的 flat 和 flatMap、用于直接将 Object.entries 的返回值转换为新 Object 的 Object.fromEntries，以及 String.prototype 上作为已广泛实现但非标准的 String.prototype.trimLeft 和 trimRight 内置函数更好命名替代项的 trimStart 和 trimEnd。此外，它还Array.prototype.sort 是稳定排序、要求 JSON.stringify 无论输入如何都返回格式良好的 UTF-8，以及通过要求 Function.prototype.toString 要么返回对应的原始源文本，要么返回标准占位符来澄清该方法。
ECMAScript 2020，第 11th 版，引入了 Strings 的 matchAll 方法，用于为全局正则表达式生成的所有匹配对象产生一个迭代器；import()，一种使用动态说明符异步导入 Modules 的语法；BigInt，一种用于处理任意精度整数的新数字原始值；Promise.allSettled，一种不会短路的新 Promise 组合器；globalThis，一种访问全局 this 值的通用方式；专用于在模块中使用的 export * as ns from 'module' 语法；对 for-in 枚举顺序的标准化增强；import.meta，一种在 Modules 中可用、由
ECMAScript 2021，第 12th 版，引入了 Strings 的 replaceAll 方法；Promise.any，一种当输入值 fulfilled 时短路的 Promise 组合器；AggregateError，一种一次表示多个错误的新 Error 类型；逻辑赋值运算符（??=、&&=、||=）；WeakRef，用于在不阻止目标对象被垃圾回收的情况下引用目标对象；以及 FinalizationRegistry，用于管理当目标对象被垃圾回收时执行的清理操作的注册和注销；数值字面量分隔符（1_000）；并使 Array.prototype.sort 更精确，减少会导致实现定义
ECMAScript 2022，第 13th 版，引入了顶层 await，允许在模块的顶层使用该#x in obj 语法，用于测试对象上是否存在私有字段；通过 /d 标志提供的正则表达式匹配索引，它为匹配的cause 属性，可用于在错误中记录因果链；Strings、Arrays 和 at 方法，允许相对索引；以及 Object.hasOwn，作为 Object.prototype.hasOwnProperty 的便捷替代项。
ECMAScript 2023，第 14th 版，引入了 Array.prototype 和 TypedArray.prototype 上的 toSorted、toReversed、with、findLast 和 findLastIndex 方法，以及 Array.prototype 上的 toSpliced 方法；增加了对文件开头 #! 注释的支持，以更好地便于可执行 ECMAScript 文件；并允许将大多数 Symbols 用作弱集合中的键。
ECMAScript 2024，第 15th 版，添加了用于调整和转移 ArrayBuffers 与 SharedArrayBuffers 的设施；添加了新的 RegExp /v 标志，用于创建具备更高级特性、可处理字符串集合的 RegExps；并引入了用于构造 Promises 的便捷方法 Promise.withResolvers，用于聚合数据的 Object.groupBy 和 Map.groupBy 方法，用于异步等待共享内存变化的 Atomics.waitAsync 方法，以及用于检查并确保字符串只String.prototype.isWellFormed 和 String.prototype.toWellFormed 方法。
ECMAScript 2025，第 16th 版，添加了新的 Iterator Set.prototype 添加了用于执行常见 Set 操作的方法；增加了对导入 JSON modules 以及声明导入模块属性的语法的支持；添加了 RegExp.escape 方法，用于转义字符串以便安全地用于正则表达式；添加了用于在正则表达式内联启用和禁用修饰符标志的语法；添加了 Promise.try 方法，用于调用可能返回也可能不返回 Promise 的函数，并确保结果始终是 Promise；并添加了新的 Float16Array DataView.prototype.getFloat16、DataView.prototype.setFloat16 和 Math.f16round 方法。
ECMAScript 2026，第 17th 版，添加了 Math.sumPrecise，用于对不同量级的 Numbers 可迭代对象求和，同时最小化精度损失；Iterator.concat，用于串接迭代器；Array.fromAsync，用于从 Error.isError，用于识别错误对象；向 Map.prototype 和 WeakMap.prototype 添加了方法，用于在键尚不存在时提供检索期间使用的默认值；向 Uint8Array 添加了方法，用于转换为十六进制和 base64 编码二进制数据的 Strings 以及从这些 Strings 转换回来；向 JSON.parse revivers 添加了一个参数，用于访问匹配的 JSON 源片段；以及 JSON.rawJSON，用于对原始值的 JSON.stringify 输出进行精细控制。
来自许多组织的数十名个人对本版以及之前各版在 Ecma TC39 内的发展作出了非常重要的贡献。此外，一个充满活力的社区已经形成，支持 TC39 的 ECMAScript 工作。该社区审阅了大量草案，提交了数千份缺陷报告，开展了实现实验，贡献了测试套件，并向全球开发者社区普及了 ECMAScript。遗憾的是，要识别并致谢每一位为此作出贡献的个人和组织是不可能的。
Allen Wirfs-Brock
ECMA-262，第 6th 版项目编辑
Brian Terlson
ECMA-262，第 7th 至第 10th 版项目编辑
Jordan Harband
ECMA-262，第 10th 至第 12th 版项目编辑
Kevin Gibbons
ECMA-262，第 12th 至第 17th 版项目编辑
Shu-yu Guo
ECMA-262，第 12th 至第 18th 版项目编辑
Michael Ficarra
ECMA-262，第 12th 至第 18th 版项目编辑
Richard Gibson
ECMA-262，第 18th 版项目编辑
Ron Buckton
ECMA-262，第 18th 版项目编辑
Nicolò Ribaudo
ECMA-262，第 18th 版项目编辑
Linus Groh
ECMA-262，第 18th 版项目编辑
1 范围
本标准定义了 ECMAScript 2027 通用编程语言。
2 一致性
ECMAScript 的一致实现必须提供并支持本规范中描述的所有类型、值、对象、属性、函数以及程序语法和语义。
ECMAScript 的一致实现必须按照最新版 Unicode 标准和 ISO/IEC 10646 解释源文本输入。
ECMAScript 的一致实现若提供应用程序编程接口（API），以支持需要适应不同人类语言和国家所使用的语言与文化惯例的程序，则必须实现与本规范兼容的最新版本 ECMA-402 所定义的接口。
ECMAScript 的一致实现可以提供本规范中描述之外的额外类型、值、对象、属性和函数。尤其是，ECMAScript 的一致实现可以为本规范中描述的对象提供本规范中未描述的属性，以及这些属性的值。
ECMAScript 的一致实现可以支持本规范中未描述的程序和正则表达式语法。尤其是，ECMAScript 的一致实现可以支持使用本规范子条款
ECMAScript 的一致实现不得实现本规范子条款
ECMAScript 的一致实现不得重新定义任何并非实现定义、实现近似或
ECMAScript 的一致实现可以选择实现或不实现 Normative Optional 子条款，除非另有说明。Web 浏览器通常被要求实现所有规范可选子条款。（参见附录
2.1 示例 Normative Optional 条款标题
示例条款内容。
ECMAScript 的一致实现必须实现 Legacy 子条款，除非它们也被标记为 Normative Optional。Legacy 子条款中规定的所有语言特性和行为都具有一个或多个不良特征。然而，它们在现有应用中的持续使用阻止了它们从本规范中移除。这些特性不被视为 ECMAScript 语言核心的一部分。程序员在编写新的 ECMAScript 代码时，不应使用或假定这些特性和行为的存在。
2.2 示例 Legacy 条款标题
示例条款内容。
2.3 示例 Legacy Normative Optional 条款标题
示例条款内容。
3 规范性引用
以下引用文档对于本文档的应用是不可缺少的。对于有日期的引用，仅所引用的版本适用。对于无日期的引用，所引用文档的最新版本（包括任何修订）适用。
Unicode 标准。
https://unicode.org/versions/latest
ISO/IEC 10646，信息技术 — 通用多八位编码字符集（UCS），加上 Amendment 1:2005、Amendment 2:2006、Amendment 3:2008、Amendment 4:2008，以及其他修订和勘误，或其后继版本。
ECMA-402，ECMAScript 国际化 API 规范，具体为与本规范此版本对应的年度版本。
https://www.ecma-international.org/publications-and-standards/standards/ecma-402/
ECMA-404，JSON 数据交换格式。
https://www.ecma-international.org/publications-and-standards/standards/ecma-404/
4 概述
本节
ECMAScript 是一种面向对象的编程语言，用于在
ECMAScript 最初被设计为一种脚本语言使用，但已被广泛用作通用编程语言。脚本语言是一种用于操纵、自定义和自动化既有系统设施的编程语言。在这样的系统中，有用的功能已经通过用户界面可用，而脚本语言是一种将该功能暴露给程序控制的机制。通过这种方式，可以说既有系统提供了由对象和设施构成的
ECMAScript 最初被设计为一种 Web 脚本语言，提供一种机制，用于在浏览器中使 Web 页面生动起来，并作为基于 Web 的客户端-服务器架构的一部分执行服务器计算。ECMAScript 现在被用于为各种
ECMAScript 的使用已超越简单脚本，现在被用于许多不同环境和规模中的全部编程任务范围。随着 ECMAScript 使用范围的扩大，它所提供的特性和设施也随之扩展。ECMAScript 现在是一种功能完备的通用编程语言。
4.1 Web 脚本
Web 浏览器为客户端计算提供 ECMAScript
Web 服务器为服务器端计算提供不同的
每个支持 ECMAScript 的 Web 浏览器和服务器都提供其自身的
4.2 宿主和实现
为辅助将 ECMAScript 集成到
实现是一个外部来源，它进一步定义附录
实现定义的设施，是指其定义无进一步限定地推迟给外部来源的设施。本规范不对特定行为作出任何建议，一致实现可在本规范提出的约束范围内自由选择任何行为。
实现近似的设施，是指其定义推迟给外部来源、同时本规范推荐理想行为的设施。虽然一致实现可在本规范提出的约束范围内自由选择任何行为，但鼓励它们努力近似该理想行为。一些数学操作，例如 Math.exp
宿主是一个外部来源，它进一步定义附录
宿主钩子是整体或部分由外部来源定义的
- 它必须返回
正常完成 或抛出完成。
宿主定义的设施，是指其定义无进一步限定地推迟给外部来源，并列在附录
宿主环境是对所有
4.3 ECMAScript 概述
以下是 ECMAScript 的非正式概述——并未描述该语言的所有部分。此概述不是标准正文的一部分。
ECMAScript 是基于对象的：基本语言和
ECMAScript 定义了一组内置对象，用于完善 ECMAScript 实体的定义。这些内置对象包括Object、Function、Boolean、Symbol 和各种 Error 对象；表示和操纵数值的对象，包括 Math、Number 和 Date；文本处理对象 String 和 RegExp；作为值的索引集合的对象，包括 Array 和九种不同类型的 Typed Arrays，其元素均具有特定的数值数据表示；键控集合，包括 Map 和 Set 对象；支持结构化数据的对象，包括 JSON 对象、ArrayBuffer、SharedArrayBuffer 和 DataView；支持控制抽象的对象，包括生成器函数和 Promise 对象；以及反射对象，包括 Proxy 和 Reflect。
ECMAScript 还定义了一组内置运算符。ECMAScript 运算符包括各种一元运算、乘性运算符、加性运算符、按位移位运算符、关系运算符、相等运算符、二元按位运算符、二元逻辑运算符、赋值运算符以及逗号运算符。
大型 ECMAScript 程序由模块支持，模块允许将程序划分为多个语句和声明序列。每个模块显式标识其使用且需要由其他模块提供的声明，以及其哪些声明可供其他模块使用。
ECMAScript 语法有意类似 Java 语法。ECMAScript 语法较为宽松，以使其可作为易于使用的脚本语言。例如，变量不要求声明其类型，类型也不与属性关联，且已定义函数不要求其声明在文本上出现在对它们的调用之前。
4.3.1 对象
尽管 ECMAScript new Date(2009, 11) 创建一个新的 Date 对象。不使用 new 调用Date() 产生当前日期和时间的字符串表示，而不是对象。
由
在基于类的面向对象语言中，一般来说，状态由实例承载，方法由类承载，而继承只继承结构和行为。在 ECMAScript 中，状态和方法由对象承载，而结构、行为和状态都会被继承。
所有不直接
CF 是一个new 表达式创建了五个对象：cf1、cf2、cf3、cf4 和 cf5。这些对象各自都
不同于大多数基于类的对象语言，可以通过向对象赋值来动态添加属性。也就是说，
虽然 ECMAScript 对象并非内在地基于类，但基于
4.3.2 ECMAScript 的严格变体
ECMAScript 语言承认，某些语言用户可能希望限制他们对该语言中可用某些特性的使用。他们可能出于安全考虑、为避免他们认为易出错的特性、为获得增强的错误检查，或出于他们自行选择的其他原因而这样做。为支持这种可能性，ECMAScript 定义了该语言的严格变体。该语言的严格变体排除常规 ECMAScript 语言的某些特定句法和语义特性，并修改某些特性的详细语义。严格变体还指定了额外的错误条件：在非严格形式语言未指定为错误的情况下，必须通过抛出错误异常来报告这些条件。
ECMAScript 的严格变体通常称为该语言的严格模式。严格模式的选择，以及 ECMAScript 严格模式语法和语义的使用，如
为符合本规范，ECMAScript 实现必须实现本规范定义的完整、不受限制的 ECMAScript 语言以及 ECMAScript 语言的严格变体。此外，实现必须支持将不受限制和严格模式源文本单元组合为单个复合程序。
4.4 术语和定义
为本文档之目的，适用以下术语和定义。
4.4.1 implementation-approximated
4.4.2 implementation-defined
4.4.3 host-defined
与 implementation-defined 相同
编辑上，参见条款
4.4.4 type
如条款
4.4.5 primitive value
如条款
原始值是在语言实现的最低层级直接表示的数据。
4.4.6 object
对象是属性的集合，并具有单个原型对象。该原型可以是
4.4.7 constructor
创建并初始化对象的
4.4.8 prototype
为其他对象提供共享属性的对象
4.4.9 ordinary object
对所有对象必须支持的基本内部方法具有默认行为的对象
4.4.10 exotic object
对一个或多个基本内部方法不具有默认行为的对象
4.4.11 standard object
其语义由本规范定义的对象
4.4.12 built-in object
由 ECMAScript 实现指定并提供的对象
标准内置对象在本规范中定义。ECMAScript 实现可以指定并提供额外种类的内置对象。
4.4.13 undefined value
当变量尚未被赋值时使用的原始值
4.4.14 Undefined type
唯一值为
4.4.15 null value
表示有意缺少任何对象值的原始值
4.4.16 Null type
唯一值为
4.4.17 Boolean value
只有两个 Boolean 值，
4.4.18 Boolean type
由原始值
4.4.19 Boolean object
Boolean 对象通过在 new 表达式中使用 Boolean
4.4.20 String value
作为零个或多个 16 位无符号整数值的
String 值是
4.4.21 String type
所有可能 String 值的集合
4.4.22 String object
4.4.23 Number value
对应于双精度 64 位二进制格式
4.4.24 Number type
所有可能
4.4.25 Number object
4.4.26 Infinity
4.4.27 NaN
作为
4.4.28 BigInt value
对应于任意精度整数值的原始值
4.4.29 BigInt type
所有可能 BigInt 值的集合
4.4.30 BigInt object
4.4.31 Symbol value
表示唯一的非 String Object
4.4.32 Symbol type
所有可能 Symbol 值的集合
4.4.33 Symbol object
4.4.34 function
除其属性外，函数还
4.4.35 built-in function
作为函数的内置对象
内置函数的示例包括 parseInt 和 Math.exp。
4.4.36 built-in constructor
作为
4.4.37 property
对象中将键（String 值或 Symbol 值）与值关联起来的部分
取决于属性的形式，该值可以直接表示为数据值（原始值、对象或
4.4.38 method
作为属性值的函数
当函数作为对象的方法被调用时，该对象会作为其
4.4.39 built-in method
作为内置函数的方法
标准内置方法在本规范中定义。
4.4.40 attribute
定义属性某些特征的内部值
4.4.41 own property
直接
4.4.42 inherited property
对象的属性，其不是自有属性，而是该对象原型的属性（自有或继承）
4.5 本规范的组织
本规范其余部分组织如下：
条款
条款
条款
条款
条款
5 记号约定
5.1 句法和词法语法
5.1.1 上下文无关语法
上下文无关语法由若干产生式组成。每个产生式都有一个称为非终结符的抽象符号作为其左手边，并有零个或多个非终结符和终结符符号构成的序列作为其右手边。对于每种语法，终结符符号取自指定字母表。
链式产生式是指其右手边恰好有一个非终结符符号并伴随零个或多个终结符符号的产生式。
从一个仅由单个特定非终结符组成的句子开始，该非终结符称为目标符号，给定的上下文无关语法指定一种语言，即通过反复将序列中的任意非终结符替换为以该非终结符为左手边的产生式的右手边而可能得到的终结符符号序列的（也许是无限的）集合。
5.1.2 词法语法和 RegExp 语法
ECMAScript 的词法语法在条款
除空白和注释之外的输入元素构成 ECMAScript 句法语法的终结符符号，并称为 ECMAScript token。这些 token 是 ECMAScript 语言的/*…*/ 的注释，不论其是否跨越多行）如果不
ECMAScript 的 RegExp 语法在
词法语法和 RegExp 语法的产生式以两个冒号“::”作为分隔标点来区分。词法语法和 RegExp 语法共享一些产生式。
5.1.3 数值字符串语法
数值字符串语法出现在
数值字符串语法的产生式以三个冒号“:::”作为标点来区分，并且从不用于解析源文本。
5.1.4 句法语法
ECMAScript 的句法语法在条款
当码点流将被解析为 ECMAScript
解析成功时，会构造一棵解析树，即一种根树结构，其中每个节点都是一个 Parse Node。每个 Parse Node 都是语法中某个符号的实例；它表示可从该符号派生出的源文本跨度。解析树的根节点表示整个源文本，是该解析
每次调用解析器都会实例化新的 Parse Nodes，并且即使源文本相同，也绝不会在不同解析之间复用 Parse Nodes。当且仅当 Parse Nodes 表示相同的源文本跨度、是相同语法符号的实例，并且来自同一次解析器调用时，才认为它们是同一 Parse Node。
多次解析同一个 String 会导致不同的 Parse Nodes。例如，考虑：
let str = "1 + 1;";
eval(str);
eval(str);每次对 eval 的调用都会将 str 的值转换为 ECMAScript 源文本，并执行一次独立解析，创建其自身独立的 Parse Nodes 树。即使每次解析都作用于由同一个 String 值派生出的源文本，这些树也是不同的。
句法语法的产生式以仅一个冒号“:”作为标点来区分。
条款
在某些情况下，为避免歧义，句法语法使用广义产生式，这些产生式允许并不构成有效 ECMAScript
- 最初由 p 匹配的 token 序列会以 n 作为
目标符号 重新解析。如果 n 具有语法参数，则这些参数会被设置为 p 最初解析时使用的相同值。 - 如果该 token 序列能够被解析为 n 的单个实例且没有剩余 token，则：
- 我们将该 n 的实例（一个 Parse Node，对给定的 p 唯一）称为“由 p 覆盖的 n”。
- n 及其派生产生式的所有 Early Error 规则也适用于由 p 覆盖的 n。
- 否则（如果解析失败），它是一个早期 Syntax Error。
5.1.5 语法记号
5.1.5.1 终结符符号
在 ECMAScript 语法中，一些终结符符号以 fixed-width 字体显示。它们应完全按所写形式出现在源文本中。以这种方式指定的所有终结符符号码点，都应被理解为来自 Basic Latin 块的相应 Unicode 码点，而不是来自其他 Unicode 范围的任何外观相似码点。终结符符号中的码点不能用 \
在终结符符号为单个 Unicode 码点的语法中（即词法、RegExp 和数值字符串语法），产生式中出现的多个连续定宽码点是一种简单简写，表示同样的码点序列，但写作独立的终结符符号。
例如，产生式：
是以下形式的简写：
相比之下，在句法语法中，连续的一串定宽码点是单个终结符符号。
终结符符号还有另外两种形式：
- 在词法和 RegExp 语法中，没有常规印刷表示的 Unicode 码点，会改以“<ABBREV>”形式显示，其中“ABBREV”是该码点或码点集合的助记名。这些形式在
Unicode 格式控制字符 、空白 和行终止符 中定义。 - 在句法语法中，某些终结符符号（例如
IdentifierName 和RegularExpressionLiteral ）以斜体显示，因为它们指向词法语法中同名的非终结符。
5.1.5.2 非终结符符号和产生式
非终结符符号以斜体显示。非终结符的定义（也称为“产生式”）由被定义的非终结符名称引入，后跟一个或多个冒号。（冒号数量表示该产生式属于哪种语法。）随后的一行或多行给出该非终结符的一个或多个可选右手边。例如，句法定义：
说明非终结符 while，后跟左圆括号 token，后跟
说明
5.1.5.3 可选符号
下标后缀“opt”可能出现在终结符或非终结符之后，表示可选符号。
是以下形式的便捷缩写：
并且：
是以下形式的便捷缩写：
而这又是以下形式的缩写：
因此，在此示例中，非终结符
5.1.5.4 语法参数
产生式可以通过形如“[parameters]”的下标注解进行参数化，该注解可作为后缀出现在产生式所定义的非终结符符号之后。“parameters”可以是单个名称，也可以是由逗号分隔的名称列表。参数化产生式是一组产生式的简写，这组产生式定义参数名的所有组合，并在参数化非终结符符号之后附加以前导下划线开头的参数名。这意味着：
是以下形式的便捷缩写：
并且：
是以下形式的缩写：
多个参数会产生组合数量的产生式，其中并非所有产生式都一定会在完整语法中被引用。
产生式右手边对非终结符的引用也可以被参数化。例如：
等价于说：
并且：
等价于：
非终结符引用可以同时具有参数列表和“opt”后缀。例如：
是以下形式的缩写：
在右手边非终结符引用上用“?”作为参数名前缀，会使该参数值取决于当前产生式左手边符号引用上是否出现该参数名。例如：
是以下形式的缩写：
如果右手边替代项带有前缀“[+parameter]”，则只有在引用该产生式的非终结符符号时使用了该命名参数，该替代项才可用。如果右手边替代项带有前缀“[~parameter]”，则只有在引用该产生式的非终结符符号时未使用该命名参数，该替代项才可用。这意味着：
是以下形式的缩写：
并且：
是以下形式的缩写：
5.1.5.5 one of
当词语“one of”跟在语法定义的冒号之后时，它表示后续一行或多行上的每个终结符符号都是一个可选定义。例如，ECMAScript 的词法语法
它只是以下形式的便捷缩写：
5.1.5.6 [empty]
如果短语“[empty]”出现在产生式右手边，则表示该产生式的右手边不
5.1.5.7 向前看限制
如果短语“[lookahead = seq]”出现在产生式右手边，则表示只有在 token 序列 seq 是紧接其后的输入 token 序列的前缀时，该产生式才可使用。类似地，“[lookahead ∈ set]”，其中 set 是 token 序列的
这些条件可以被否定。“[lookahead ≠ seq]”表示只有在 seq 不是紧接其后的输入 token 序列的前缀时，
作为示例，给定定义：
定义：
匹配字母 n 后跟一个或多个十进制数字且第一个数字为偶数，或者匹配一个后面不跟另一个十进制数字的十进制数字。
注意，当这些短语在句法语法中使用时，可能无法无歧义地识别紧接其后的 token 序列，因为确定后续 token 需要知道在后续位置使用哪个词法
5.1.5.8 [no LineTerminator here]
如果短语“[no
表示如果脚本中 throw token 与
除非受限产生式禁止出现
5.1.5.9 but not
产生式右手边可以使用短语“but not”并随后指明要排除的展开，来指定某些展开不被允许。例如，产生式：
意味着非终结符
5.1.5.10 描述性短语
最后，在列出所有替代项不切实际的情况下，少数非终结符符号由无衬线字体的描述性短语描述：
5.2 算法约定
本规范经常使用编号列表来指定算法步骤。这些算法用于精确指定 ECMAScript 语言构造所要求的语义。这些算法并不意在暗示使用任何特定实现技术。在实践中，可能存在更高效的算法来实现给定特性。
算法可以用一个有序的、逗号分隔的别名名称序列显式参数化，这些别名可在算法步骤中用于引用对应位置传入的实参。可选参数用外层方括号表示（[ , name ]），并且在算法步骤中与必需参数没有区别。rest 参数可以出现在参数列表末尾，以前导省略号表示（, ...name）。rest 参数将必需参数和可选参数之后提供的所有实参捕获到一个
算法步骤可以细分为顺序子步骤。子步骤会缩进，并且自身也可以进一步细分为缩进子步骤。大纲编号约定用于标识子步骤，第一层子步骤用小写字母标号，第二层子步骤用小写罗马数字标号。如果需要超过三层，则这些规则重复，第四层使用数字标号。例如：
- 顶层步骤
- 子步骤。
- 子步骤。
- 子子步骤。
- 子子子步骤
- 子子子子步骤
- 子子子子子步骤
- 子子子子步骤
- 子子子步骤
- 子子步骤。
步骤或子步骤可以写作一个“if”谓词，用其条件控制其子步骤。在这种情况下，只有在该谓词为真时才应用这些子步骤。如果步骤或子步骤以词语“else”开头，则它是同一层级前一个“if”谓词步骤的否定谓词。
步骤可以以“For each”或“Repeat”开头，以指定其子步骤的迭代应用。
以“Assert:”开头的步骤断言其算法的不变条件。这些断言用于明确本来会隐含的算法不变式。类似地，以“NOTE:”开头的步骤为附近步骤提供相关上下文。断言步骤和注记步骤严格而言是信息性的；它们不添加额外的语义要求，因此实现无需检查它们。
算法步骤可以使用形式“Let x be someValue”为任意值声明命名别名。这些别名类似引用，因为 x 和 someValue 都引用相同的底层数据，对任一者的修改对二者均可见。希望避免这种类引用行为的算法步骤应显式复制右手边：“Let x be a copy of someValue” 创建 someValue 的浅拷贝。
别名一经声明，就可以在任何后续步骤中引用，并且不得在声明之前的步骤中引用。别名可以使用形式“Set x to someOtherValue”进行修改。
5.2.1 求值顺序
当复杂表达式出现在算法步骤中时，应理解为按从左到右、从内到外的顺序求值。例如，步骤
- Return A(B(), C.[[D]]) + E(F()).
等价于
- Let tmp1 be B().
- Let tmp2 be C.[[D]].
- Let tmp3 be A(tmp1, tmp2).
- Let tmp4 be F().
- Let tmp5 be E(tmp4).
- Let tmp6 be tmp3 + tmp5.
- Return tmp6.
其中各种 tmpN 别名是临时的，并且只在这些步骤中可见。
5.2.2 抽象操作
为便于在本规范多个部分中使用，一些称为抽象操作的算法会被命名，并以参数化函数形式书写，从而可在其他算法中按名称引用。抽象操作通常使用函数应用风格来引用，例如 OperationName(arg1, arg2)。一些抽象操作被视为类似类的规范抽象的多态派发方法。这类类似方法的抽象操作通常使用方法应用风格引用，例如 someValue.OperationName(arg1, arg2)。
5.2.3 语法制导操作
语法制导操作是一个命名操作，其定义由算法组成，每个算法与某个 ECMAScript 语法中的一个或多个产生式关联。具有多个可选定义的产生式，通常会为每个替代项具有不同的算法。当算法与语法产生式关联时，它可以像引用算法参数一样引用该产生式替代项的终结符和非终结符符号。以这种方式使用时，非终结符符号指的是解析源文本时匹配到的实际替代定义。由某个语法产生式或由它派生出的
当算法与产生式替代项关联时，该替代项通常显示时不带任何“[ ]”语法注解。此类注解只应影响对替代项的句法识别，而不影响该替代项的相关语义。
语法制导操作使用以下算法中步骤
- Let status be SyntaxDirectedOperation of
SomeNonTerminal . - Let someParseNode be the parse of some source text.
- Perform SyntaxDirectedOperation of someParseNode.
- Perform SyntaxDirectedOperation of someParseNode with argument
"value" .
除非另有明确规定，否则所有
但
Runtime Semantics:
- Return
Evaluation ofStatementList .
5.2.4 运行时语义
指定必须在运行时调用的语义的算法称为运行时语义。运行时语义由
5.2.4.1 Completion ( completionRecord )
The abstract operation Completion takes argument completionRecord (a
Assert : completionRecord is aCompletion Record .- Return completionRecord.
5.2.4.2 Throw
在算法步骤中，词语“throw”是返回调用
- If result.[[Error]] is not
none , throw result.[[Error]].
等价于
- If result.[[Error]] is not
none , returnThrowCompletion (result.[[Error]]).
要求抛出特定类型异常的算法步骤会构造要抛出的该类型异常。例如，
- Throw a
TypeError exception.
等价于
- Return
ThrowCompletion (a newly createdTypeError object).
5.2.4.3 解包 Completion Records 的简写
前缀“?”和“!”用作解包
- Let result be ? record.
等价于
Assert : record is aCompletion Record .- If record is an abrupt completion, return record.
- Let result be record.[[Value]].
同样，步骤
- Let result be ! record.
等价于
Assert : record is a normal completion.- Let result be record.[[Value]].
当“?”或“!”在任何其他上下文中使用时，首先应用
- Perform AO(? Other()).
可以重写为
- Let tmp1 be Other().
- Let tmp2 be ? tmp1.
- Perform AO(tmp2).
它又展开为
- Let tmp1 be Other().
Assert : tmp1 is aCompletion Record .- If tmp1 is an abrupt completion, return tmp1.
- Let tmp2 be tmp1.[[Value]].
- Perform AO(tmp2).
5.2.4.4 隐式正常完成
在声明为返回
- 直接返回应用
Completion 、NormalCompletion 、ThrowCompletion 或ReturnCompletion 的结果时 - 直接返回构造
Completion Record 的结果时
如果从这类
- Return
true .
与以下任一形式含义相同
- Return
NormalCompletion (true ).
或
- Let completion be
NormalCompletion (true ). - Return
Completion (completion).
或
- Return
Completion Record { [[Type]]:normal , [[Value]]:true , [[Target]]:empty }.
注意，通过
- Return ? completion.
以下示例会是编辑错误，因为正在返回
- Let completion be
NormalCompletion (true ). - Return completion.
5.2.5 静态语义
上下文无关语法不足以表达所有规则，这些规则定义输入元素流是否形成可被求值的有效 ECMAScript
Static Semantic Rules 具有名称，并且通常使用算法定义。命名的 Static Semantic Rules 与语法产生式关联，而具有多个可选定义的产生式通常会为每个适用的命名静态语义规则的每个替代项具有不同算法。
一种特殊的静态语义规则是 Early Error Rule。Early error 规则定义与特定语法产生式关联的 early error 条件（参见条款
5.2.6 数学操作
本规范引用以下种类的数值：
- 数学值：任意实数，用作默认数值类型。
- 扩展数学值：
数学值 加上 +∞ 和 -∞。 - Numbers：
IEEE 754-2019 binary64（双精度浮点）值。 - BigInts：与任意整数一一对应的
ECMAScript 语言值 。
在本规范语言中，数值使用下标后缀来区分不同的数值种类。下标 𝔽 指 Numbers，下标 ℤ 指 BigInts。不带下标后缀的数值指
一般而言，当本规范引用一个数值时，例如在短语“the length of y”或“the
当术语 integer 在本规范中使用时，除非另有说明，它指的是属于整数集合的
数值运算符如 +、×、= 和 ≥ 指由操作数类型决定的那些操作。当应用于
数学函数
数学函数
数学函数
记号“
短语“the result of clamping x between lower and upper”（其中 x 是
数学函数
数学函数
数学函数
从下界 a 到上界 b 的区间，是一个可能无限、可能为空的同一数值类型的数值集合。每个边界会被描述为
- 从 a（
包含 ）到 b（包含 ）的区间 ，也称为从 a 到 b 的闭区间，包含 同一数值类型中满足 a ≤ x ≤ b 的所有值 x，且不包含 其他值。 - 从 a（
包含 ）到 b（排除）的区间 ，包含 同一数值类型中满足 a ≤ x < b 的所有值 x，且不包含 其他值。 - 从 a（排除）到 b（
包含 ）的区间 ，包含 同一数值类型中满足 a < x ≤ b 的所有值 x，且不包含 其他值。 - 从 a（排除）到 b（排除）的
区间 ，包含 同一数值类型中满足 a < x < b 的所有值 x，且不包含 其他值。
例如，从 1（
5.2.7 值记号
在本规范中，Function.prototype.apply 或 let n = 42;。
5.2.8 同一性
在本规范中，规范值和
从本规范的视角看，词语“is”用于比较两个值是否相等，如“If bool is
从 ECMAScript 语言的视角看，语言值使用
对于规范值，无规范同一性的值示例包括但不限于：
除由
6 ECMAScript 数据类型和值
本规范中的算法会操作各种值，每个值都有一个相关联的类型。可能的值类型正是本条款中定义的那些类型。类型进一步分类为
6.1 ECMAScript 语言类型
ECMAScript 语言类型对应于 ECMAScript 程序员使用 ECMAScript 语言直接操作的值。ECMAScript 语言类型是 Undefined、Null、Boolean、String、Symbol、Number、BigInt 和 Object。ECMAScript 语言值是由 ECMAScript 语言类型刻画的值。
6.1.1 Undefined 类型
Undefined 类型恰好有一个值，称为
6.1.2 Null 类型
Null 类型恰好有一个值，称为
6.1.3 Boolean 类型
Boolean 类型表示具有两个值的逻辑实体，这两个值称为
6.1.4 String 类型
String 类型是所有由零个或多个 16 位无符号整数值（“元素”）组成的有序序列的集合，最大长度为 253 - 1 个元素。String 类型通常用于表示运行中的 ECMAScript 程序里的文本数据，在这种情况下，String 中的每个元素都被视为 UTF-16 码元值。每个元素都被认为在序列中占据一个位置。这些位置使用非负
不解释 String 内容的 ECMAScript 操作不施加进一步语义。解释 String 值的操作将每个元素视为单个 UTF-16 码元。然而，ECMAScript 不限制这些码元的值或它们之间的关系，因此，将 String 内容进一步解释为以 UTF-16 编码的 Unicode 码点序列的操作，必须考虑格式不良的子序列。这类操作会按照以下规则，对数值位于从 0xD800 到 0xDBFF 的
-
既不是
前导代理项 也不是后尾代理项 的码元，会被解释为具有相同值的码点。 -
两个码元组成的序列，其中第一个码元 c1 是
前导代理项 ，第二个码元 c2 是后尾代理项 ，是一个代理对，并被解释为值为 (c1 - 0xD800) × 0x400 + (c2 - 0xDC00) + 0x10000 的码点。（参见11.1.3 ） -
是
前导代理项 或后尾代理项 、但并非代理对 一部分的码元，会被解释为具有相同值的码点。
函数 String.prototype.normalize（参见 String.prototype.localeCompare（参见
此设计背后的理由是，使 Strings 的实现尽可能简单且高性能。如果 ECMAScript 源文本采用 Normalized Form C，则只要字符串字面量不
在本规范中，短语“A、B、... 的字符串连接”（其中每个实参都是 String 值、码元或码元序列）表示一个 String 值，其码元序列是每个实参的码元（按顺序）的连接（按顺序）。
短语“string 从 inclusiveStart 到 exclusiveEnd 的子字符串”（其中 string 是 String 值或码元序列，inclusiveStart 和 exclusiveEnd 是整数）表示由 string 中从索引 inclusiveStart 开始并在索引 exclusiveEnd 之前立即结束的连续码元组成的 String 值（当 inclusiveStart = exclusiveEnd 时为空 String）。如果省略 "to" 后缀，则使用 string 的长度作为 exclusiveEnd 的值。
短语“ASCII 单词字符”表示以下 String 值，该值仅由 Unicode Basic Latin 块中的每个字母和数字以及 U+005F（LOW LINE）组成：
出于历史原因，它对各种算法具有意义。
6.1.4.1 StringIndexOf ( string, searchValue, fromIndex )
The abstract operation StringIndexOf takes arguments string (a String), searchValue (a String), and fromIndex (a non-negative
- 令 length 为 string 的长度。
- 如果 searchValue 为空 String 且 fromIndex ≤ length，则返回 fromIndex。
- 令 searchLength 为 searchValue 的长度。
- 对于满足 fromIndex ≤ i ≤ length - searchLength 的每个整数 i，按升序执行：
- 令 candidate 为 string 从 i 到 i + searchLength 的
子字符串 。 - 如果 candidate 是 searchValue，则返回 i。
- 令 candidate 为 string 从 i 到 i + searchLength 的
- 返回
not-found 。
如果 searchValue 为空 String 且 fromIndex ≤ string 的长度，则该算法返回 fromIndex。空 String 实际上会在字符串内的每个位置被找到，包括最后一个码元之后。
如果 fromIndex + searchValue 的长度 > string 的长度，则该算法始终返回
6.1.4.2 StringLastIndexOf ( string, searchValue, fromIndex )
The abstract operation StringLastIndexOf takes arguments string (a String), searchValue (a String), and fromIndex (a non-negative
- 令 length 为 string 的长度。
- 令 searchLength 为 searchValue 的长度。
- 断言：fromIndex + searchLength ≤ length。
- 对于满足 0 ≤ i ≤ fromIndex 的每个整数 i，按降序执行：
- 令 candidate 为 string 从 i 到 i + searchLength 的
子字符串 。 - 如果 candidate 是 searchValue，则返回 i。
- 令 candidate 为 string 从 i 到 i + searchLength 的
- 返回
not-found 。
如果 searchValue 为空 String，则该算法返回 fromIndex。空 String 实际上会在字符串内的每个位置被找到，包括最后一个码元之后。
6.1.5 Symbol 类型
Symbol 类型是所有可用作 Object
每个 Symbol 都是唯一且不可变的。
每个 Symbol 都有一个不可变的 [[Description]] 内部槽，其值为 String 或
6.1.5.1 众所周知的 Symbols
众所周知的 symbols 是由本规范的算法显式引用的内置 Symbol 值。它们通常用作属性的键，而这些属性的值充当规范算法的扩展点。除非另有规定，众所周知的 symbol 值由所有
在本规范中，使用标准
%Symbol.name%。特别地，曾使用以下名称：@@asyncIterator、@@hasInstance、@@isConcatSpreadable、@@| 规范名称 | [[描述]] | 值和用途 |
|---|---|---|
| %Symbol.asyncDispose% |
|
一个方法，用于在对象上异步执行资源清理。当其await using 声明调用。
|
| %Symbol.asyncIterator% |
|
一个方法，用于返回对象的默认异步迭代器。由 for-await-of 语句的语义调用。
|
| %Symbol.dispose% |
|
一个方法，用于在对象上执行显式资源清理。当其using 声明调用。
|
| %Symbol.hasInstance% |
|
一个方法，用于确定instanceof 运算符的语义调用。
|
| %Symbol.isConcatSpreadable% |
|
一个 Boolean 值属性，如果为 true，则指示对象应由 Array.prototype.concat |
| %Symbol.iterator% |
|
一个方法，用于返回对象的默认迭代器。由 for-of 语句的语义调用。 |
| %Symbol.match% |
|
一个正则表达式方法，用于将正则表达式与字符串进行匹配。由 String.prototype.match |
| %Symbol.matchAll% |
|
一个正则表达式方法，用于返回一个迭代器，该迭代器产出正则表达式与字符串匹配的结果。由 String.prototype.matchAll |
| %Symbol.replace% |
|
一个正则表达式方法，用于替换字符串中匹配的String.prototype.replace |
| %Symbol.search% |
|
一个正则表达式方法，用于返回字符串中与正则表达式匹配的位置索引。由 String.prototype.search |
| %Symbol.species% |
|
一个 function 值属性，它是用于创建派生对象的 |
| %Symbol.split% |
|
一个正则表达式方法，用于在与正则表达式匹配的索引处拆分字符串。由 String.prototype.split |
| %Symbol.toPrimitive% |
|
一个方法，用于将对象转换为对应的原始值。由 |
| %Symbol.toStringTag% |
|
一个 String 值属性，用于创建对象的默认字符串描述。由内置方法 Object.prototype.toString |
| %Symbol.unscopables% |
|
一个 object 值属性，其自身和继承的with 环境绑定中排除的 |
6.1.6 数值类型
ECMAScript 有两个内置数值类型：Number 和 BigInt。以下
由于数值类型通常不能在不损失精度或截断的情况下相互转换，ECMAScript 语言不在这些类型之间提供隐式转换。调用需要另一种类型的函数时，程序员必须显式调用 Number 和 BigInt 函数以在类型之间转换。
ECMAScript 的第一版及后续版本曾为某些运算符提供可能损失精度或截断的隐式数值转换。为了向后兼容，这些遗留隐式转换被保留，但未为 BigInt 提供，以尽量减少程序员出错的机会，并为未来版本中的通用值类型选项留下空间。
6.1.6.1 Number 类型
Number 类型恰好有 18,437,736,874,454,810,627（即 NaN 产生。）在某些实现中，外部代码也许能够检测各种 NaN 值之间的差异，但此类行为是
还有另外两个特殊值，称为 +Infinity（或简单地 Infinity）和 -Infinity 产生。）
其他 18,437,736,874,454,810,624（即
注意，存在 +0（或简单地 0）和 -0 产生。）
这 18,437,736,874,454,810,622（即
其中 18,428,729,675,200,069,632（即
其中 s 为 1 或 -1，m 是从 252（
剩余的 9,007,199,254,740,990（即
其中 s 为 1 或 -1，m 是从 0（排除）到 252（排除）的
注意，所有大小不超过 253 的正整数和负整数都可在 Number 类型中表示。整数 0 在 Number 类型中有两种表示：
如果
在本规范中，短语“x 的Number 值”，其中 x 表示一个精确的实数数学量（甚至可能是 π 这样的无理数），是指按以下方式选择的
+∞ 的
某些 ECMAScript 运算符只处理特定范围内的整数，例如从
6.1.6.1.1 Number::unaryMinus ( number )
The abstract operation Number::unaryMinus takes argument number (a Number) and returns a Number. It performs the following steps when called:
- 如果 number 是
NaN ，则返回NaN 。 - 返回 number 的相反数；也就是说，计算一个大小相同但符号相反的 Number。
6.1.6.1.2 Number::bitwiseNOT ( number )
The abstract operation Number::bitwiseNOT takes argument number (a Number) and returns an
6.1.6.1.3 Number::exponentiate ( base, exponent )
The abstract operation Number::exponentiate takes arguments base (a Number) and exponent (a Number) and returns a Number. 它返回一个实现近似值，表示 base 的 exponent 次幂结果。 It performs the following steps when called:
- 如果 exponent 是
NaN ，则返回NaN 。 - 如果 exponent 是
+0 𝔽 或-0 𝔽，则返回1 𝔽。 - 如果 base 是
NaN ，则返回NaN 。 - 如果 base 是
+∞ 𝔽，则- 如果 exponent >
+0 𝔽，则返回+∞ 𝔽。 - 返回
+0 𝔽。
- 如果 exponent >
- 如果 base 是
-∞ 𝔽，则- 如果 exponent >
+0 𝔽，则- 如果 exponent 是奇数
integral Number ，则返回-∞ 𝔽。 - 返回
+∞ 𝔽。
- 如果 exponent 是奇数
- 如果 exponent 是奇数
integral Number ，则返回-0 𝔽。 - 返回
+0 𝔽。
- 如果 exponent >
- 如果 base 是
+0 𝔽，则- 如果 exponent >
+0 𝔽，则返回+0 𝔽。 - 返回
+∞ 𝔽。
- 如果 exponent >
- 如果 base 是
-0 𝔽，则- 如果 exponent >
+0 𝔽，则- 如果 exponent 是奇数
integral Number ，则返回-0 𝔽。 - 返回
+0 𝔽。
- 如果 exponent 是奇数
- 如果 exponent 是奇数
integral Number ，则返回-∞ 𝔽。 - 返回
+∞ 𝔽。
- 如果 exponent >
- 断言：base 是
有限 的，且既不是+0 𝔽 也不是-0 𝔽。 - 如果 exponent 是
+∞ 𝔽，则 - 如果 exponent 是
-∞ 𝔽，则 - 断言：exponent 是
有限 的，且既不是+0 𝔽 也不是-0 𝔽。 - 如果 base <
-0 𝔽 且 exponent 不是integral Number ，则返回NaN 。 - 返回一个
实现近似的 Number 值 ，表示将ℝ (base) 提升到ℝ (exponent) 次幂的结果。
当 base 为 ** exponent 的结果不同于
6.1.6.1.4 Number::multiply ( x, y )
The abstract operation Number::multiply takes arguments x (a Number) and y (a Number) and returns a Number. 它按照
6.1.6.1.5 Number::divide ( x, y )
The abstract operation Number::divide takes arguments x (a Number) and y (a Number) and returns a Number. 它按照
- 如果 x 是
NaN 或 y 是NaN ，则返回NaN 。 - 如果 x 是
+∞ 𝔽 或-∞ 𝔽，则- 如果 y 是
+∞ 𝔽 或-∞ 𝔽，则返回NaN 。 - 如果 y 是
+0 𝔽 或 y >+0 𝔽，则返回 x。 - 返回 -x。
- 如果 y 是
- 如果 y 是
+∞ 𝔽，则- 如果 x 是
+0 𝔽 或 x >+0 𝔽，则返回+0 𝔽。 - 返回
-0 𝔽。
- 如果 x 是
- 如果 y 是
-∞ 𝔽，则- 如果 x 是
+0 𝔽 或 x >+0 𝔽，则返回-0 𝔽。 - 返回
+0 𝔽。
- 如果 x 是
- 如果 x 是
+0 𝔽 或-0 𝔽，则- 如果 y 是
+0 𝔽 或-0 𝔽，则返回NaN 。 - 如果 y >
+0 𝔽，则返回 x。 - 返回 -x。
- 如果 y 是
- 如果 y 是
+0 𝔽，则- 如果 x >
+0 𝔽，则返回+∞ 𝔽。 - 返回
-∞ 𝔽。
- 如果 x >
- 如果 y 是
-0 𝔽，则- 如果 x >
+0 𝔽，则返回-∞ 𝔽。 - 返回
+∞ 𝔽。
- 如果 x >
- 返回
𝔽 (ℝ (x) /ℝ (y))。
6.1.6.1.6 Number::remainder ( numerator, denominator )
The abstract operation Number::remainder takes arguments numerator (a Number) and denominator (a Number) and returns a Number. 它产生由其操作数的隐含除法得到的余数，其中 numerator 是被除数，denominator 是除数。 It performs the following steps when called:
- 如果 numerator 是
NaN 或 denominator 是NaN ，则返回NaN 。 - 如果 numerator 是
+∞ 𝔽 或-∞ 𝔽，则返回NaN 。 - 如果 denominator 是
+∞ 𝔽 或-∞ 𝔽，则返回 numerator。 - 如果 denominator 是
+0 𝔽 或-0 𝔽，则返回NaN 。 - 如果 numerator 是
+0 𝔽 或-0 𝔽，则返回 numerator。 - 断言：numerator 和 denominator 是
有限 且非零的。 - 令 quotient 为
ℝ (numerator) /ℝ (denominator)。 - 令 truncatedQuotient 为
truncate (quotient)。 - 令 remainder 为
ℝ (numerator) - (ℝ (denominator) × truncatedQuotient)。 - 如果 remainder = 0 且 numerator <
-0 𝔽，则返回-0 𝔽。 - 返回
𝔽 (remainder)。
在 C 和 C++ 中，余数运算符只接受整数操作数；在 ECMAScript 中，它也接受浮点操作数。
% 运算符计算的浮点余数操作的结果，与 % 定义为以类似于 Java 6.1.6.1.7 Number::add ( x, y )
The abstract operation Number::add takes arguments x (a Number) and y (a Number) and returns a Number. 它按照
6.1.6.1.8 Number::subtract ( x, y )
The abstract operation Number::subtract takes arguments x (a Number) and y (a Number) and returns a Number. 它执行减法，产生其操作数之差；x 是被减数，y 是减数。 It performs the following steps when called:
- 返回
Number::add (x,Number::unaryMinus (y))。
x - y 始终产生与 x + (-y) 相同的结果。
6.1.6.1.9 Number::leftShift ( x, y )
The abstract operation Number::leftShift takes arguments x (a Number) and y (a Number) and returns an
6.1.6.1.10 Number::signedRightShift ( x, y )
The abstract operation Number::signedRightShift takes arguments x (a Number) and y (a Number) and returns an
6.1.6.1.11 Number::unsignedRightShift ( x, y )
The abstract operation Number::unsignedRightShift takes arguments x (a Number) and y (a Number) and returns an
6.1.6.1.12 Number::lessThan ( x, y )
The abstract operation Number::lessThan takes arguments x (a Number) and y (a Number) and returns a Boolean or
6.1.6.1.13 Number::equal ( x, y )
The abstract operation Number::equal takes arguments x (a Number) and y (a Number) and returns a Boolean. It performs the following steps when called:
- 如果 x 是
NaN ，则返回false 。 - 如果 y 是
NaN ，则返回false 。 - 如果 x 是 y，则返回
true 。 - 如果 x 是
+0 𝔽 且 y 是-0 𝔽，则返回true 。 - 如果 x 是
-0 𝔽 且 y 是+0 𝔽，则返回true 。 - 返回
false 。
6.1.6.1.14 Number::sameValue ( x, y )
The abstract operation Number::sameValue takes arguments x (a Number) and y (a Number) and returns a Boolean. It performs the following steps when called:
- 如果 x 是
NaN 且 y 是NaN ，则返回true 。 - 如果 x 是
+0 𝔽 且 y 是-0 𝔽，则返回false 。 - 如果 x 是
-0 𝔽 且 y 是+0 𝔽，则返回false 。 - 如果 x 是 y，则返回
true 。 - 返回
false 。
6.1.6.1.15 Number::sameValueZero ( x, y )
The abstract operation Number::sameValueZero takes arguments x (a Number) and y (a Number) and returns a Boolean. It performs the following steps when called:
- 如果 x 是
NaN 且 y 是NaN ，则返回true 。 - 如果 x 是
+0 𝔽 且 y 是-0 𝔽，则返回true 。 - 如果 x 是
-0 𝔽 且 y 是+0 𝔽，则返回true 。 - 如果 x 是 y，则返回
true 。 - 返回
false 。
6.1.6.1.16 NumberBitwiseOp ( op, x, y )
The abstract operation NumberBitwiseOp takes arguments op (&, ^, or |), x (a Number), and y (a Number) and returns an
- 令 leftNumber 为 !
ToInt32 (x)。 - 令 rightNumber 为 !
ToInt32 (y)。 - 令 leftBits 为表示
ℝ (leftNumber) 的 32 位二进制补码位串。 - 令 rightBits 为表示
ℝ (rightNumber) 的 32 位二进制补码位串。 - 如果 op 是
&，则- 令 result 为对 leftBits 和 rightBits 应用按位 AND 操作的结果。
- 否则如果 op 是
^，则- 令 result 为对 leftBits 和 rightBits 应用按位异或（XOR）操作的结果。
- 否则，
- 断言：op 是
|。 - 令 result 为对 leftBits 和 rightBits 应用按位
包含 OR 操作的结果。
- 断言：op 是
- 返回由 32 位二进制补码位串 result 表示的整数的
Number 值 。
6.1.6.1.17 Number::bitwiseAND ( x, y )
The abstract operation Number::bitwiseAND takes arguments x (a Number) and y (a Number) and returns an
- 返回
NumberBitwiseOp (&, x, y)。
6.1.6.1.18 Number::bitwiseXOR ( x, y )
The abstract operation Number::bitwiseXOR takes arguments x (a Number) and y (a Number) and returns an
- 返回
NumberBitwiseOp (^, x, y)。
6.1.6.1.19 Number::bitwiseOR ( x, y )
The abstract operation Number::bitwiseOR takes arguments x (a Number) and y (a Number) and returns an
- 返回
NumberBitwiseOp (|, x, y)。
6.1.6.1.20 Number::toString ( x, radix )
The abstract operation Number::toString takes arguments x (a Number) and radix (an
- 如果 x 是
NaN ，则返回"NaN" 。 - 如果 x 是
+0 𝔽 或-0 𝔽，则返回"0" 。 - 如果 x <
-0 𝔽，则返回"-" 和Number::toString (-x, radix) 的字符串连接 。 - 如果 x 是
+∞ 𝔽，则返回"Infinity" 。 - 令 n、k 和 s 为整数，使得 k ≥ 1，radixk - 1 ≤ s < radixk，
𝔽 (s × radixn - k) 是 x，并且 k 尽可能小。注意，k 是使用基数 radix 表示 s 时的位数，s 不能被 radix 整除，并且 s 的最低有效位不一定由这些条件唯一确定。 - 如果 radix ≠ 10 或 n 位于从 -5 到 21 的
闭区间 内，则 - 注记：在此情况下，输入将使用科学 E 记号表示，例如
1.2e+3。 - 断言：radix 是 10。
- 如果 n < 0，则
- 令 exponentSign 为码元 0x002D（HYPHEN-MINUS）。
- 否则，
- 令 exponentSign 为码元 0x002B（PLUS SIGN）。
- 如果 k = 1，则
- 返回以下项的
字符串连接 ：- s 的十进制表示中最高有效数字的码元
- 码元 0x002E（FULL STOP）
- s 的十进制表示中剩余 k - 1 个数字的码元
- 码元 0x0065（LATIN SMALL LETTER E）
- exponentSign
abs (n - 1) 的十进制表示的码元
ECMAScript 实现者可能会发现 David M. Gay 编写的关于浮点数二进制到十进制转换的论文和代码很有用：
Gay, David M. Correctly Rounded Binary-Decimal and Decimal-Binary Conversions. Numerical Analysis, Manuscript 90-10. AT&T Bell Laboratories (Murray Hill, New Jersey). 30 November 1990. 可获取为
https://ampl.com/_archive/first-website/REFS/rounding.pdf。关联代码可获取为
http://netlib.sandia.gov/fp/dtoa.c 和
http://netlib.sandia.gov/fp/g_fmt.c，也可在各种 netlib 镜像站点找到。
6.1.6.2 BigInt 类型
BigInt 类型表示整数值。该值可以是任意大小，且不限于特定位宽。通常，除非另有说明，操作被设计为返回基于精确数学的答案。对于二元操作，BigInts 表现为二进制补码二进制字符串，负数被视为在左侧无限设置位。
6.1.6.2.1 BigInt::unaryMinus ( bigint )
The abstract operation BigInt::unaryMinus takes argument bigint (a BigInt) and returns a BigInt. It performs the following steps when called:
- 如果 bigint =
0 ℤ，则返回0 ℤ。 - 返回 -bigint。
6.1.6.2.2 BigInt::bitwiseNOT ( bigint )
The abstract operation BigInt::bitwiseNOT takes argument bigint (a BigInt) and returns a BigInt. 它返回 bigint 的一补数。 It performs the following steps when called:
- 返回 -bigint -
1 ℤ。
6.1.6.2.3 BigInt::exponentiate ( base, exponent )
The abstract operation BigInt::exponentiate takes arguments base (a BigInt) and exponent (a BigInt) and returns either a normal completion containing a BigInt or a throw completion. It performs the following steps when called:
- 如果 exponent <
0 ℤ，则抛出RangeError 异常。 - 如果 base =
0 ℤ 且 exponent =0 ℤ，则返回1 ℤ。 - 返回 base 的 exponent 次幂。
6.1.6.2.4 BigInt::multiply ( x, y )
The abstract operation BigInt::multiply takes arguments x (a BigInt) and y (a BigInt) and returns a BigInt. It performs the following steps when called:
- 返回 x × y。
6.1.6.2.5 BigInt::divide ( x, y )
The abstract operation BigInt::divide takes arguments x (a BigInt) and y (a BigInt) and returns either a normal completion containing a BigInt or a throw completion. It performs the following steps when called:
6.1.6.2.6 BigInt::remainder ( numerator, denominator )
The abstract operation BigInt::remainder takes arguments numerator (a BigInt) and denominator (a BigInt) and returns either a normal completion containing a BigInt or a throw completion. It performs the following steps when called:
6.1.6.2.7 BigInt::add ( x, y )
The abstract operation BigInt::add takes arguments x (a BigInt) and y (a BigInt) and returns a BigInt. It performs the following steps when called:
- 返回 x + y。
6.1.6.2.8 BigInt::subtract ( x, y )
The abstract operation BigInt::subtract takes arguments x (a BigInt) and y (a BigInt) and returns a BigInt. It performs the following steps when called:
- 返回 x - y。
6.1.6.2.9 BigInt::leftShift ( x, y )
The abstract operation BigInt::leftShift takes arguments x (a BigInt) and y (a BigInt) and returns a BigInt. It performs the following steps when called:
6.1.6.2.10 BigInt::signedRightShift ( x, y )
The abstract operation BigInt::signedRightShift takes arguments x (a BigInt) and y (a BigInt) and returns a BigInt. It performs the following steps when called:
- 返回
BigInt::leftShift (x, -y)。
6.1.6.2.11 BigInt::unsignedRightShift ( x, y )
The abstract operation BigInt::unsignedRightShift takes arguments x (a BigInt) and y (a BigInt) and returns a throw completion. It performs the following steps when called:
- 抛出
TypeError 异常。
6.1.6.2.12 BigInt::lessThan ( x, y )
The abstract operation BigInt::lessThan takes arguments x (a BigInt) and y (a BigInt) and returns a Boolean. It performs the following steps when called:
6.1.6.2.13 BigInt::equal ( x, y )
The abstract operation BigInt::equal takes arguments x (a BigInt) and y (a BigInt) and returns a Boolean. It performs the following steps when called:
6.1.6.2.14 BinaryAnd ( x, y )
The abstract operation BinaryAnd takes arguments x (0 or 1) and y (0 or 1) and returns 0 or 1. It performs the following steps when called:
- 如果 x = 1 且 y = 1，则返回 1。
- 返回 0。
6.1.6.2.15 BinaryOr ( x, y )
The abstract operation BinaryOr takes arguments x (0 or 1) and y (0 or 1) and returns 0 or 1. It performs the following steps when called:
- 如果 x = 1 或 y = 1，则返回 1。
- 返回 0。
6.1.6.2.16 BinaryXor ( x, y )
The abstract operation BinaryXor takes arguments x (0 or 1) and y (0 or 1) and returns 0 or 1. It performs the following steps when called:
- 如果 x = 1 且 y = 0，则返回 1。
- 如果 x = 0 且 y = 1，则返回 1。
- 返回 0。
6.1.6.2.17 BigIntBitwiseOp ( op, x, y )
The abstract operation BigIntBitwiseOp takes arguments op (&, ^, or |), x (a BigInt), and y (a BigInt) and returns a BigInt. It performs the following steps when called:
- 将 x 设置为
ℝ (x)。 - 将 y 设置为
ℝ (y)。 - 令 result 为 0。
- 令 shift 为 0。
- 重复，直到 (x = 0 或 x = -1) 且 (y = 0 或 y = -1)：
- 令 xDigit 为 x
modulo 2。 - 令 yDigit 为 y
modulo 2。 - 如果 op 是
&，则- 将 result 设置为 result + 2shift ×
BinaryAnd (xDigit, yDigit)。
- 将 result 设置为 result + 2shift ×
- 否则如果 op 是
|，则- 将 result 设置为 result + 2shift ×
BinaryOr (xDigit, yDigit)。
- 将 result 设置为 result + 2shift ×
- 否则，
- 断言：op 是
^。 - 将 result 设置为 result + 2shift ×
BinaryXor (xDigit, yDigit)。
- 断言：op 是
- 将 shift 设置为 shift + 1。
- 将 x 设置为 (x - xDigit) / 2。
- 将 y 设置为 (y - yDigit) / 2。
- 令 xDigit 为 x
- 如果 op 是
&，则 - 否则如果 op 是
|，则 - 否则，
- 如果 signBit ≠ 0，则
- 将 result 设置为 result - 2shift。
- 注记：这会扩展符号。
- 返回 result 的 BigInt 值。
6.1.6.2.18 BigInt::bitwiseAND ( x, y )
The abstract operation BigInt::bitwiseAND takes arguments x (a BigInt) and y (a BigInt) and returns a BigInt. It performs the following steps when called:
- 返回
BigIntBitwiseOp (&, x, y)。
6.1.6.2.19 BigInt::bitwiseXOR ( x, y )
The abstract operation BigInt::bitwiseXOR takes arguments x (a BigInt) and y (a BigInt) and returns a BigInt. It performs the following steps when called:
- 返回
BigIntBitwiseOp (^, x, y)。
6.1.6.2.20 BigInt::bitwiseOR ( x, y )
The abstract operation BigInt::bitwiseOR takes arguments x (a BigInt) and y (a BigInt) and returns a BigInt. It performs the following steps when called:
- 返回
BigIntBitwiseOp (|, x, y)。
6.1.6.2.21 BigInt::toString ( x, radix )
The abstract operation BigInt::toString takes arguments x (a BigInt) and radix (an
- 如果 x <
0 ℤ，则返回"-" 和BigInt::toString (-x, radix) 的字符串连接 。 - 返回由使用基数 radix 表示 x 所组成的 String 值。
6.1.7 Object 类型
Object 类型的每个实例，也简称为“一个 Object”，表示一组属性。每个属性要么是数据属性，要么是访问器属性：
-
数据属性将一个键值与一个
ECMAScript 语言值 以及一组 Boolean 特性相关联。 -
访问器属性将一个键值与一个或两个访问器函数以及一组 Boolean 特性相关联。访问器函数用于存储或取回与该属性相关联的
ECMAScript 语言值 。
对象的属性使用
整数索引是一个
所有对象在逻辑上都是属性的集合，但对象有多种形式，它们在访问和操作其属性时的语义不同。关于对象多种形式的定义，请参见
此外，一些对象是可调用的；这些对象称为函数或
6.1.7.1 属性特性
本规范使用特性来定义和解释 Object 属性的状态，如
| 特性名称 | 它出现于哪类属性 | 值域 | 默认值 | 描述 |
|---|---|---|---|---|
| [[Value]] |
|
一个 |
|
对该属性执行 get 访问时取回的值。 |
| [[Writable]] |
|
一个 Boolean |
|
如果为 |
| [[Get]] |
|
一个 Object 或 |
|
如果该值是 Object，则它必须是 |
| [[Set]] |
|
一个 Object 或 |
|
如果该值是 Object，则它必须是 |
| [[Enumerable]] |
|
一个 Boolean |
|
如果为 |
| [[Configurable]] |
|
一个 Boolean |
|
如果为 |
6.1.7.2 Object 内部方法和内部槽
在 ECMAScript 中，对象的实际语义是通过称为内部方法的算法指定的。ECMAScript 引擎中的每个对象都与一组内部方法相关联，这组内部方法定义其运行时行为。这些内部方法不是 ECMAScript 语言的一部分。它们纯粹为了说明目的由本规范定义。然而，ECMAScript 实现中的每个对象都必须按照与其关联的内部方法所指定的方式行为。完成此事的确切方式由实现决定。
内部方法名是多态的。这意味着在对不同对象值调用一个共同的内部方法名时，它们可能执行不同的算法。被调用内部方法所作用的实际对象是该调用的“目标”。如果在运行时，某个算法的实现尝试使用对象不支持的内部方法，则抛出
内部槽对应于与对象、Symbols 或
所有对象都有一个名为 [[PrivateElements]] 的内部槽，它是
内部方法和内部槽在本规范中使用双中括号 [[ ]] 括起的名称来标识。
普通对象是满足以下所有条件的对象：
-
对于
Table 4 中列出的内部方法，该对象使用10.1 中定义的那些方法。 -
如果该对象具有 [[Call]] 内部方法，则它使用
10.2.1 中定义的方法，或10.3.1 中定义的方法。 -
如果该对象具有 [[Construct]] 内部方法，则它使用
10.2.2 中定义的方法，或10.3.2 中定义的方法。
异质对象是不是
本规范通过这些对象的内部方法识别不同种类的
除形参之外，内部方法始终能够访问作为方法调用目标的对象。
内部方法隐式返回一个
| 内部方法 | 签名 | 描述 |
|---|---|---|
| [[GetPrototypeOf]] | ( ) → Object | Null |
确定为此对象提供继承属性的对象。 |
| [[SetPrototypeOf]] | (Object | Null) → Boolean |
将此对象与另一个提供继承属性的对象相关联。传入 |
| [[IsExtensible]] | ( ) → Boolean | 确定是否允许向此对象添加额外属性。 |
| [[PreventExtensions]] | ( ) → Boolean |
控制是否可以向此对象添加新属性。如果操作成功则返回 |
| [[GetOwnProperty]] |
(propertyKey) → Undefined | |
返回此对象中键为 propertyKey 的自有属性的 |
| [[DefineOwnProperty]] | (propertyKey, propertyDesc) → Boolean |
创建或变更键为 propertyKey 的自有属性，使其具有 propertyDesc 描述的状态。如果该属性被成功创建/更新，则返回 |
| [[HasProperty]] | (propertyKey) → Boolean | 返回一个 Boolean 值，指示此对象是否已经具有键为 propertyKey 的自有属性或继承属性。 |
| [[Get]] | (propertyKey, receiver) → any |
从此对象返回键为 propertyKey 的属性的值。如果必须执行任何 ECMAScript 代码以取回该属性值，则在求值该代码时使用 receiver 作为 |
| [[Set]] | (propertyKey, value, receiver) → Boolean |
将键为 propertyKey 的属性的值设置为 value。如果必须执行任何 ECMAScript 代码以设置该属性值，则在求值该代码时使用 receiver 作为 |
| [[Delete]] | (propertyKey) → Boolean |
从此对象移除键为 propertyKey 的自有属性。如果该属性未被删除且仍然存在，则返回 |
| [[OwnPropertyKeys]] |
( ) → |
返回一个 |
| 内部方法 | 签名 | 描述 |
|---|---|---|
| [[Call]] |
(any, a |
执行与此对象相关联的代码。通过函数调用表达式调用。该内部方法的实参是一个 |
| [[Construct]] |
(a |
创建一个对象。通过 new 运算符或 super 调用来调用。该内部方法的第一个实参是一个 super 调用的实参。第二个实参是 new 运算符最初应用到的对象。实现此内部方法的对象称为 |
6.1.7.3 基本内部方法的不变式
ECMAScript 引擎中对象的内部方法必须符合下方指定的不变式列表。普通 ECMAScript Objects 以及本规范中的所有标准
任何实现提供的
实现不得允许以任何方式绕过这些不变式，例如提供替代接口来实现基本内部方法的功能却不强制执行其不变式。
定义：
- 内部方法的目标是调用该内部方法所作用的对象。
-
如果目标已被观察到从其 [[IsExtensible]] 内部方法返回
false ，或从其 [[PreventExtensions]] 内部方法返回true ，则该目标是不可扩展的。 - 不存在的属性是指在不可扩展目标上不作为自有属性存在的属性。
-
对
SameValue 的所有引用均依照SameValue 算法的定义。
返回值：
任何内部方法返回的值必须是一个
- [[Type]] =
normal ，[[Target]] =empty ，且 [[Value]] = 该内部方法下方所示“正常返回类型”的值，或 - [[Type]] =
throw ，[[Target]] =empty ，且 [[Value]] = 任意ECMAScript 语言值 。
内部方法不得返回
[[GetPrototypeOf]] ( )
- 正常返回类型要么是 Object，要么是 Null。
-
如果 target 是不可扩展的，并且 [[GetPrototypeOf]] 返回值 proto，则对 [[GetPrototypeOf]] 的任何未来调用都应返回与 proto
SameValue 的值。
[[SetPrototypeOf]] ( proto )
- 正常返回类型是 Boolean。
-
如果 target 是不可扩展的，[[SetPrototypeOf]] 必须返回
false ，除非 proto 与该 target 被观察到的 [[GetPrototypeOf]] 值是SameValue 。
[[IsExtensible]] ( )
- 正常返回类型是 Boolean。
-
如果 [[IsExtensible]] 返回
false ，则该 target 上未来对 [[IsExtensible]] 的所有调用都必须返回false 。
[[PreventExtensions]] ( )
- 正常返回类型是 Boolean。
-
如果 [[PreventExtensions]] 返回
true ，则该 target 上未来对 [[IsExtensible]] 的所有调用都必须返回false ，并且该 target 现在被视为不可扩展。
[[GetOwnProperty]] ( propertyKey )
-
正常返回类型要么是
Property Descriptor ，要么是 Undefined。 -
如果返回值是
Property Descriptor ，则它必须是完整填充的 Property Descriptor 。 -
如果 propertyKey 被描述为不可配置、不可写的自有
数据属性 ，则未来对 [[GetOwnProperty]] ( propertyKey ) 的所有调用都必须返回一个Property Descriptor ，其 [[Value]] 与 propertyKey 的 [[Value]] 特性是SameValue 。 -
如果 propertyKey 除 [[Writable]] 和 [[Value]] 之外的特性可能随时间变化，或者该属性可能被删除，则 propertyKey 的 [[Configurable]] 特性必须为
true 。 -
如果 [[Writable]] 特性可能从
false 改为true ，则 [[Configurable]] 特性必须为true 。 -
如果 target 是不可扩展的且 propertyKey 不存在，则该 target 上未来对 [[GetOwnProperty]] (propertyKey) 的所有调用都必须将 propertyKey 描述为不存在（即 [[GetOwnProperty]] (propertyKey) 必须返回
undefined ）。
作为第三个不变式的结果，如果某属性被描述为
[[DefineOwnProperty]] ( propertyKey, propertyDesc )
- 正常返回类型是 Boolean。
-
如果 propertyKey 先前已被观察为 target 的不可配置自有属性，则 [[DefineOwnProperty]] 必须返回
false ，除非满足以下任一条件： -
如果 target 是不可扩展的且 propertyKey 是不存在的自有属性，则 [[DefineOwnProperty]] (propertyKey, propertyDesc) 必须返回
false 。也就是说，不可扩展的目标对象不能用新属性扩展。
[[HasProperty]] ( propertyKey )
[[Get]] ( propertyKey, receiver )
-
正常返回类型是任意
ECMAScript 语言类型 。 -
如果 propertyKey 先前已被观察为 target 的不可配置、不可写、自有
数据属性 ，且其值为 value，则 [[Get]] 必须返回与 valueSameValue 的值。 -
如果 propertyKey 先前已被观察为 target 的不可配置自有
访问器属性 ，且其 [[Get]] 特性为undefined ，则 [[Get]] 操作必须返回undefined 。
[[Set]] ( propertyKey, value, receiver )
- 正常返回类型是 Boolean。
-
如果 propertyKey 先前已被观察为 target 的不可配置、不可写、自有
数据属性 ，则 [[Set]] 必须返回false ，除非 value 与 propertyKey 的 [[Value]] 特性是SameValue 。 -
如果 propertyKey 先前已被观察为 target 的不可配置自有
访问器属性 ，且其 [[Set]] 特性为undefined ，则 [[Set]] 操作必须返回false 。
[[Delete]] ( propertyKey )
[[OwnPropertyKeys]] ( )
-
正常返回类型是
List 。 -
返回的
List 不得包含 任何重复条目。 -
返回的
List 的每个元素都必须是属性键 。 -
返回的
List 必须至少包含 所有先前已被观察到的不可配置自有属性的键。 -
如果 target 是不可扩展的，则返回的
List 必须只包含 使用 [[GetOwnProperty]] 可观察到的 target 的所有自有属性的键。
[[Call]] ( )
-
正常返回类型是任意
ECMAScript 语言类型 。
[[Construct]] ( )
- 正常返回类型是 Object。
- target 还必须具有 [[Call]] 内部方法。
6.1.7.4 众所周知的内在对象
众所周知的内在是由本规范的算法显式引用的内置对象，并且它们通常具有
在本规范中，诸如 %name% 的引用表示与当前
| 内在名称 | 全局名称 | ECMAScript 语言关联 |
|---|---|---|
|
|
|
AggregateError |
|
|
|
Array |
|
|
|
ArrayBuffer |
|
|
|
|
|
|
|
AsyncDisposableStack |
|
|
|
|
|
|
async function 对象的 |
|
|
|
async generator function 对象的 |
|
|
|
async generator 对象的原型（ |
|
|
|
所有标准内置 |
|
|
|
|
Atomics 对象（ |
|
|
|
BigInt |
|
|
|
BigInt64Array |
|
|
|
BigUint64Array |
|
|
|
Boolean |
|
|
|
DataView |
|
|
|
Date |
|
|
|
decodeURI 函数（ |
|
|
|
decodeURIComponent 函数（ |
|
|
|
DisposableStack |
|
|
|
encodeURI 函数（ |
|
|
|
encodeURIComponent 函数（ |
|
|
|
Error |
|
|
|
eval 函数（ |
|
|
|
EvalError |
|
|
|
FinalizationRegistry |
|
|
|
Float16Array |
|
|
|
Float32Array |
|
|
|
Float64Array |
|
|
|
|
|
|
|
Function |
|
|
generator function 对象的 |
|
|
|
generator 对象的原型（ |
|
|
|
|
Int8Array |
|
|
|
Int16Array |
|
|
|
Int32Array |
|
|
|
isFinite 函数（ |
|
|
|
isNaN 函数（ |
|
|
|
Iterator |
|
|
|
|
|
|
|
JSON 对象（ |
|
|
|
Map |
|
|
|
|
|
|
|
Math 对象（ |
|
|
|
Number |
|
|
|
Object |
|
|
|
parseFloat 函数（ |
|
|
|
parseInt 函数（ |
|
|
|
Promise |
|
|
|
Proxy |
|
|
|
RangeError |
|
|
|
ReferenceError |
|
|
|
Reflect 对象（ |
|
|
|
RegExp |
|
|
|
|
|
|
|
Set |
|
|
|
|
|
|
|
SharedArrayBuffer |
|
|
|
String |
|
|
|
|
|
|
|
SuppressedError |
|
|
|
Symbol |
|
|
|
SyntaxError |
|
|
一个无条件抛出 |
|
|
|
所有 typed Array |
|
|
|
|
TypeError |
|
|
|
Uint8Array |
|
|
|
Uint8ClampedArray |
|
|
|
Uint16Array |
|
|
|
Uint32Array |
|
|
|
URIError |
|
|
|
WeakMap |
|
|
|
WeakRef |
|
|
|
WeakSet |
|
|
Iterator.from 返回的 wrapped |
6.2 ECMAScript 规范类型
规范类型对应于在算法中用于描述 ECMAScript 语言构造和
6.2.1 Enum 规范类型
Enums 是规范内部的值，不能从 ECMAScript 代码中直接观察到。Enums 使用
6.2.2 List 和 Record 规范类型
List 类型用于解释 new 表达式、函数调用以及其他需要简单有序值列表的算法中实参列表（参见
当算法在未指定顺序的情况下迭代 List 的元素时，所使用的顺序是该 List 中元素的顺序。
为了本规范中的记号方便，可以使用字面量语法表示一个新的 List 值。例如，« 1, 2 » 定义一个具有两个元素的 List 值，每个元素都初始化为特定值。新的空 List 可以表示为 « »。
在本规范中，短语“A、B、... 的列表连接”（其中每个实参都是可能为空的 List）表示一个新的 List 值，其元素是每个实参的元素（按顺序）的连接（按顺序）。
当应用于 Strings 的 List 时，短语“按字典序码元顺序排序”意味着按每个码元的数值排序，直到较短字符串的长度为止；如果全部相等，则将较短字符串排在较长字符串之前，如
Record 类型用于描述本规范算法中的数据聚合。一个 Record 类型值由一个或多个命名字段组成。每个字段的值是
为了本规范中的记号方便，可以使用类似对象字面量的语法来表示一个 Record 值。例如，{ [[Field1]]: 42, [[Field2]]:
在规范文本和算法中，可以使用点记号来引用 Record 值的特定字段。例如，如果 R 是上一段所示的 record，则 R.[[Field2]] 是“R 中名为 [[Field2]] 的字段”的简写。
常用 Record 字段组合的模式可以被命名，并且该名称可用作字面量 Record 值的前缀，以标识所描述的聚合的具体种类。例如：PropertyDescriptor { [[Value]]: 42, [[Writable]]:
6.2.3 Set 和 Relation 规范类型
Set 类型用于解释
Relation 类型用于解释 Sets 上的约束。Relation 类型的值是其值域中值的有序对的 Sets。例如，Memory 事件上的 Relation 是 Memory 事件的有序对集合。对于 Relation R 以及 R 的值域中的两个值 a 和 b，a R b 是“有序对 (a, b) 是 R 的成员”的简写。当某个 Relation 是满足某些条件的
严格偏序是满足以下条件的 Relation 值 R。
-
对于 R 的域中的所有 a、b 和 c：
- 并非 a R a，并且
- 如果 a R b 且 b R c，则 a R c。
上述两个性质分别称为反自反性和传递性。
严格全序是满足以下条件的 Relation 值 R。
-
对于 R 的域中的所有 a、b 和 c：
- a 是 b，或 a R b，或 b R a，并且
- 并非 a R a，并且
- 如果 a R b 且 b R c，则 a R c。
上述三个性质分别称为全性、反自反性和传递性。
6.2.4 Completion Record 规范类型
Completion Record 规范类型用于解释值和控制流的运行时传播，例如执行非局部控制转移的语句（break、continue、return 和 throw）的行为。
Completion Records 具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Type]] |
|
所发生完成的类型。 |
| [[Value]] |
除 |
所产生的值。 |
| [[Target]] |
String 或 |
定向控制转移的目标标签。 |
以下简写术语有时用于指代 Completion Records。
- 正常完成指任何 [[Type]] 值为
normal 的 Completion Record。 - break 完成指任何 [[Type]] 值为
break 的 Completion Record。 - continue 完成指任何 [[Type]] 值为
continue 的 Completion Record。 - return 完成指任何 [[Type]] 值为
return 的 Completion Record。 - throw 完成指任何 [[Type]] 值为
throw 的 Completion Record。 - 突然完成指任何 [[Type]] 值不是
normal 的 Completion Record。 - 包含某种类型值的正常完成，指在其 [[Value]] 字段中具有该类型值的正常完成。
本规范中定义的可调用对象只返回正常完成或抛出完成。返回任何其他种类的 Completion Record 都被认为是编辑错误。
6.2.4.1 NormalCompletion ( value )
The abstract operation NormalCompletion takes argument value (any value except a
- 返回
Completion Record { [[Type]]:normal , [[Value]]: value, [[Target]]:empty }。
6.2.4.2 ThrowCompletion ( value )
The abstract operation ThrowCompletion takes argument value (an ECMAScript language value) and returns a throw completion. It performs the following steps when called:
- 返回
Completion Record { [[Type]]:throw , [[Value]]: value, [[Target]]:empty }。
6.2.4.3 ReturnCompletion ( value )
The abstract operation ReturnCompletion takes argument value (an ECMAScript language value) and returns a return completion. It performs the following steps when called:
- 返回
Completion Record { [[Type]]:return , [[Value]]: value, [[Target]]:empty }。
6.2.4.4 UpdateEmpty ( completionRecord, value )
The abstract operation UpdateEmpty takes arguments completionRecord (a
- 断言：如果 completionRecord 是
return 完成 或throw 完成 ，则 completionRecord.[[Value]] 不是empty 。 - 如果 completionRecord.[[Value]] 不是
empty ，则返回 ? completionRecord。 - 返回
Completion Record { [[Type]]: completionRecord.[[Type]], [[Value]]: value, [[Target]]: completionRecord.[[Target]] }。
6.2.5 Reference Record 规范类型
Reference Record 类型用于解释 delete、typeof、赋值运算符、super
Reference Record 是已解析名称或（可能尚未解析的）属性绑定；其字段由
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Base]] | 保存绑定的值或 |
|
| [[ReferencedName]] | 绑定的名称。如果 [[Base]] 值是 |
|
| [[Strict]] | Boolean | 如果 |
| [[ThisValue]] | 如果不是 super |
以下
6.2.5.1 IsPropertyReference ( refRecord )
The abstract operation IsPropertyReference takes argument refRecord (a
- 如果 refRecord.[[Base]] 是
unresolvable ，则返回false 。 - 如果 refRecord.[[Base]] 是
Environment Record ，则返回false 。 - 返回
true 。
6.2.5.2 IsUnresolvableReference ( refRecord )
The abstract operation IsUnresolvableReference takes argument refRecord (a
- 如果 refRecord.[[Base]] 是
unresolvable ，则返回true 。 - 返回
false 。
6.2.5.3 IsSuperReference ( refRecord )
The abstract operation IsSuperReference takes argument refRecord (a
- 如果 refRecord.[[ThisValue]] 是
empty ，则返回false 。 - 返回
true 。
6.2.5.4 IsPrivateReference ( refRecord )
The abstract operation IsPrivateReference takes argument refRecord (a
- 如果 refRecord.[[ReferencedName]] 是
Private Name ，则返回true 。 - 返回
false 。
6.2.5.5 GetValue ( refRecord )
The abstract operation GetValue takes argument refRecord (a
- 如果 refRecord 不是
Reference Record ，则返回 refRecord。 - 如果
IsUnresolvableReference (refRecord) 是true ，则抛出ReferenceError 异常。 - 如果
IsPropertyReference (refRecord) 是true ，则- 令 baseObj 为 ?
ToObject (refRecord.[[Base]])。 - 如果
IsPrivateReference (refRecord) 是true ，则- 返回 ?
PrivateGet (baseObj, refRecord.[[ReferencedName]])。
- 返回 ?
- 如果 refRecord.[[ReferencedName]] 不是
属性键 ，则- 将 refRecord.[[ReferencedName]] 设置为 ?
ToPropertyKey (refRecord.[[ReferencedName]])。
- 将 refRecord.[[ReferencedName]] 设置为 ?
- 返回 ? baseObj.[[Get]](refRecord.[[ReferencedName]],
GetThisValue (refRecord))。
- 令 baseObj 为 ?
- 令 base 为 refRecord.[[Base]]。
- 断言：base 是
Environment Record 。 - 返回 ? base.
GetBindingValue (refRecord.[[ReferencedName]], refRecord.[[Strict]])（参见9.1 ）。
6.2.5.6 PutValue ( refRecord, value )
The abstract operation PutValue takes arguments refRecord (a
- 如果 refRecord 不是
Reference Record ，则抛出ReferenceError 异常。 - 如果
IsUnresolvableReference (refRecord) 是true ，则- 如果 refRecord.[[Strict]] 是
true ，则抛出ReferenceError 异常。 - 令 globalObj 为
GetGlobalObject ()。 - 执行 ?
Set (globalObj, refRecord.[[ReferencedName]], value,false )。 - 返回
unused 。
- 如果 refRecord.[[Strict]] 是
- 如果
IsPropertyReference (refRecord) 是true ，则- 令 baseObj 为 ?
ToObject (refRecord.[[Base]])。 - 如果
IsPrivateReference (refRecord) 是true ，则- 返回 ?
PrivateSet (baseObj, refRecord.[[ReferencedName]], value)。
- 返回 ?
- 如果 refRecord.[[ReferencedName]] 不是
属性键 ，则- 将 refRecord.[[ReferencedName]] 设置为 ?
ToPropertyKey (refRecord.[[ReferencedName]])。
- 将 refRecord.[[ReferencedName]] 设置为 ?
- 令 succeeded 为 ? baseObj.[[Set]](refRecord.[[ReferencedName]], value,
GetThisValue (refRecord))。 - 如果 succeeded 是
false 且 refRecord.[[Strict]] 是true ，则抛出TypeError 异常。 - 返回
unused 。
- 令 baseObj 为 ?
- 令 base 为 refRecord.[[Base]]。
- 断言：base 是
Environment Record 。 - 返回 ? base.
SetMutableBinding (refRecord.[[ReferencedName]], value, refRecord.[[Strict]])（参见9.1 ）。
6.2.5.7 GetThisValue ( refRecord )
The abstract operation GetThisValue takes argument refRecord (a
- 断言：
IsPropertyReference (refRecord) 是true 。 - 如果
IsSuperReference (refRecord) 是true ，则返回 refRecord.[[ThisValue]]。 - 返回 refRecord.[[Base]]。
6.2.5.8 InitializeReferencedBinding ( refRecord, value )
The abstract operation InitializeReferencedBinding takes arguments refRecord (a
- 断言：
IsUnresolvableReference (refRecord) 是false 。 - 令 base 为 refRecord.[[Base]]。
- 断言：base 是
Environment Record 。 - 返回 ? base.
InitializeBinding (refRecord.[[ReferencedName]], value)。
6.2.5.9 MakePrivateReference ( baseValue, privateIdentifier )
The abstract operation MakePrivateReference takes arguments baseValue (an ECMAScript language value) and privateIdentifier (a String) and returns a
- 令 privateEnv 为运行中执行上下文的 PrivateEnvironment。
- 断言：privateEnv 不是
null 。 - 令 privateName 为
ResolvePrivateIdentifier (privateEnv, privateIdentifier)。 - 返回
Reference Record { [[Base]]: baseValue, [[ReferencedName]]: privateName, [[Strict]]:true , [[ThisValue]]:empty }。
6.2.6 Property Descriptor 规范类型
Property Descriptor 类型用于解释 Object 属性特性的操作和具象化。Property Descriptor 是具有零个或多个字段的
Property Descriptor 值可以根据某些字段的存在或使用进一步分类为数据 Property Descriptors 和访问器 Property Descriptors。数据 Property Descriptor 是
以下
6.2.6.1 IsAccessorDescriptor ( propertyDesc )
The abstract operation IsAccessorDescriptor takes argument propertyDesc (a
- 如果 propertyDesc 具有 [[Get]] 字段，则返回
true 。 - 如果 propertyDesc 具有 [[Set]] 字段，则返回
true 。 - 返回
false 。
6.2.6.2 IsDataDescriptor ( propertyDesc )
The abstract operation IsDataDescriptor takes argument propertyDesc (a
- 如果 propertyDesc 具有 [[Value]] 字段，则返回
true 。 - 如果 propertyDesc 具有 [[Writable]] 字段，则返回
true 。 - 返回
false 。
6.2.6.3 IsGenericDescriptor ( propertyDesc )
The abstract operation IsGenericDescriptor takes argument propertyDesc (a
- 如果
IsAccessorDescriptor (propertyDesc) 是true ，则返回false 。 - 如果
IsDataDescriptor (propertyDesc) 是true ，则返回false 。 - 返回
true 。
6.2.6.4 FromPropertyDescriptor ( propertyDesc )
The abstract operation FromPropertyDescriptor takes argument propertyDesc (a
- 如果 propertyDesc 是
undefined ，则返回undefined 。 - 令 obj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 断言：obj 是一个可扩展的
普通对象 ，且没有自有属性。 - 如果 propertyDesc 具有 [[Value]] 字段，则
- 执行 !
CreateDataPropertyOrThrow (obj,"value" , propertyDesc.[[Value]])。
- 执行 !
- 如果 propertyDesc 具有 [[Writable]] 字段，则
- 执行 !
CreateDataPropertyOrThrow (obj,"writable" , propertyDesc.[[Writable]])。
- 执行 !
- 如果 propertyDesc 具有 [[Get]] 字段，则
- 执行 !
CreateDataPropertyOrThrow (obj,"get" , propertyDesc.[[Get]])。
- 执行 !
- 如果 propertyDesc 具有 [[Set]] 字段，则
- 执行 !
CreateDataPropertyOrThrow (obj,"set" , propertyDesc.[[Set]])。
- 执行 !
- 如果 propertyDesc 具有 [[Enumerable]] 字段，则
- 执行 !
CreateDataPropertyOrThrow (obj,"enumerable" , propertyDesc.[[Enumerable]])。
- 执行 !
- 如果 propertyDesc 具有 [[Configurable]] 字段，则
- 执行 !
CreateDataPropertyOrThrow (obj,"configurable" , propertyDesc.[[Configurable]])。
- 执行 !
- 返回 obj。
6.2.6.5 ToPropertyDescriptor ( obj )
The abstract operation ToPropertyDescriptor takes argument obj (an ECMAScript language value) and returns either a normal completion containing a
- 如果 obj 不是 Object，则抛出
TypeError 异常。 - 令 propertyDesc 为一个新的
Property Descriptor ，其最初没有字段。 - 令 hasEnumerable 为 ?
HasProperty (obj,"enumerable" )。 - 如果 hasEnumerable 是
true ，则 - 令 hasConfigurable 为 ?
HasProperty (obj,"configurable" )。 - 如果 hasConfigurable 是
true ，则 - 令 hasValue 为 ?
HasProperty (obj,"value" )。 - 如果 hasValue 是
true ，则- 令 value 为 ?
Get (obj,"value" )。 - 将 propertyDesc.[[Value]] 设置为 value。
- 令 value 为 ?
- 令 hasWritable 为 ?
HasProperty (obj,"writable" )。 - 如果 hasWritable 是
true ，则 - 令 hasGet 为 ?
HasProperty (obj,"get" )。 - 如果 hasGet 是
true ，则- 令 getter 为 ?
Get (obj,"get" )。 - 如果
IsCallable (getter) 是false 且 getter 不是undefined ，则抛出TypeError 异常。 - 将 propertyDesc.[[Get]] 设置为 getter。
- 令 getter 为 ?
- 令 hasSet 为 ?
HasProperty (obj,"set" )。 - 如果 hasSet 是
true ，则- 令 setter 为 ?
Get (obj,"set" )。 - 如果
IsCallable (setter) 是false 且 setter 不是undefined ，则抛出TypeError 异常。 - 将 propertyDesc.[[Set]] 设置为 setter。
- 令 setter 为 ?
- 如果 propertyDesc 具有 [[Get]] 字段或 propertyDesc 具有 [[Set]] 字段，则
- 如果 propertyDesc 具有 [[Value]] 字段或 propertyDesc 具有 [[Writable]] 字段，则抛出
TypeError 异常。
- 如果 propertyDesc 具有 [[Value]] 字段或 propertyDesc 具有 [[Writable]] 字段，则抛出
- 返回 propertyDesc。
6.2.6.6 CompletePropertyDescriptor ( propertyDesc )
The abstract operation CompletePropertyDescriptor takes argument propertyDesc (a
- 令 like 为
Record { [[Value]]:undefined , [[Writable]]:false , [[Get]]:undefined , [[Set]]:undefined , [[Enumerable]]:false , [[Configurable]]:false }。 - 如果
IsGenericDescriptor (propertyDesc) 是true 或IsDataDescriptor (propertyDesc) 是true ，则- 如果 propertyDesc 不具有 [[Value]] 字段，则将 propertyDesc.[[Value]] 设置为 like.[[Value]]。
- 如果 propertyDesc 不具有 [[Writable]] 字段，则将 propertyDesc.[[Writable]] 设置为 like.[[Writable]]。
- 否则，
- 如果 propertyDesc 不具有 [[Get]] 字段，则将 propertyDesc.[[Get]] 设置为 like.[[Get]]。
- 如果 propertyDesc 不具有 [[Set]] 字段，则将 propertyDesc.[[Set]] 设置为 like.[[Set]]。
- 如果 propertyDesc 不具有 [[Enumerable]] 字段，则将 propertyDesc.[[Enumerable]] 设置为 like.[[Enumerable]]。
- 如果 propertyDesc 不具有 [[Configurable]] 字段，则将 propertyDesc.[[Configurable]] 设置为 like.[[Configurable]]。
- 返回
unused 。
6.2.7 Environment Record 规范类型
6.2.8 Abstract Closure 规范类型
Abstract Closure 规范类型用于指代算法步骤以及一组值。Abstract Closures 是元值，并使用函数应用样式调用，例如 closure(arg1, arg2)。与
在创建 Abstract Closure 的算法步骤中，使用动词“capture”后跟别名列表来捕获值。创建 Abstract Closure 时，它会捕获当时与每个别名相关联的值。在指定调用 Abstract Closure 时所执行算法的步骤中，每个被捕获的值都由用于捕获该值的别名引用。
如果 Abstract Closure 返回
Abstract Closures 作为其他算法的一部分内联创建，如以下示例所示。
- 令 addend 为 41。
- 令 closure 为一个新的
Abstract Closure ，其形参为 (x)，它捕获 addend，并在被调用时执行以下步骤：- 返回 x + addend。
- 令 value 为 closure(1)。
- 断言：value 是 42。
6.2.9 Data Blocks
Data Block 规范类型用于描述一个由字节大小（8 位）数值组成的、不同且可变的序列。字节值是从 0 到 255 的
为了本规范中的记号方便，可以使用类似数组的语法来访问 Data Block 值的各个字节。此记号将 Data Block 值呈现为一个从 0 开始的
驻留在可由多个
Shared Data Blocks 的语义由
Shared Data Block 事件由
以下
6.2.9.1 CreateByteDataBlock ( size )
The abstract operation CreateByteDataBlock takes argument size (a non-negative
- 如果 size > 253 - 1，则抛出
RangeError 异常。 - 令 dataBlock 为一个由 size 个字节组成的新
Data Block 值。如果无法创建这样的Data Block ，则抛出RangeError 异常。 - 将 dataBlock 的所有字节设置为 0。
- 返回 dataBlock。
6.2.9.2 CreateSharedByteDataBlock ( size )
The abstract operation CreateSharedByteDataBlock takes argument size (a non-negative
- 令 dataBlock 为一个由 size 个字节组成的新
Shared Data Block 值。如果无法创建这样的Shared Data Block ，则抛出RangeError 异常。 - 令 agentRecord 为
周围 agent 的Agent Record 。 - 令 execution 为 agentRecord.[[CandidateExecution]]。
- 令 eventsRecord 为 execution.[[EventsRecords]] 中 [[AgentSignifier]] 为
AgentSignifier () 的Agent Events Record 。 - 令 zero 为 « 0 »。
- 对 dataBlock 的每个索引 index，执行：
- 将
WriteSharedMemory { [[Order]]:init , [[NoTear]]:true , [[Block]]: dataBlock, [[ByteIndex]]: index, [[ElementSize]]: 1, [[Payload]]: zero } 追加到 eventsRecord.[[EventList]]。
- 将
- 返回 dataBlock。
6.2.9.3 CopyDataBlockBytes ( toBlock, toIndex, fromBlock, fromIndex, count )
The abstract operation CopyDataBlockBytes takes arguments toBlock (a
- 断言：fromBlock 和 toBlock 是不同的值。
- 令 fromSize 为 fromBlock 中的字节数。
- 断言：fromIndex + count ≤ fromSize。
- 令 toSize 为 toBlock 中的字节数。
- 断言：toIndex + count ≤ toSize。
- 重复，当 count > 0 时：
- 如果 fromBlock 是
Shared Data Block ，则- 令 agentRecord 为
周围 agent 的Agent Record 。 - 令 execution 为 agentRecord.[[CandidateExecution]]。
- 令 eventsRecord 为 execution.[[EventsRecords]] 中 [[AgentSignifier]] 为
AgentSignifier () 的Agent Events Record 。 - 令 bytes 为一个
List ，其唯一元素是一个非确定性选择的字节值 。 - 注记：在实现中，bytes 是底层硬件上非原子读指令的结果。该非确定性是
内存模型 的语义规定，用于描述弱一致性硬件的可观察行为。 - 令 readEvent 为
ReadSharedMemory { [[Order]]:unordered , [[NoTear]]:true , [[Block]]: fromBlock, [[ByteIndex]]: fromIndex, [[ElementSize]]: 1 }。 - 将 readEvent 追加到 eventsRecord.[[EventList]]。
- 将
Chosen Value Record { [[Event]]: readEvent, [[ChosenValue]]: bytes } 追加到 execution.[[ChosenValues]]。 - 如果 toBlock 是
Shared Data Block ，则- 将
WriteSharedMemory { [[Order]]:unordered , [[NoTear]]:true , [[Block]]: toBlock, [[ByteIndex]]: toIndex, [[ElementSize]]: 1, [[Payload]]: bytes } 追加到 eventsRecord.[[EventList]]。
- 将
- 否则，
- 将 toBlock[toIndex] 设置为 bytes[0]。
- 令 agentRecord 为
- 否则，
- 断言：toBlock 不是
Shared Data Block 。 - 将 toBlock[toIndex] 设置为 fromBlock[fromIndex]。
- 断言：toBlock 不是
- 将 toIndex 设置为 toIndex + 1。
- 将 fromIndex 设置为 fromIndex + 1。
- 将 count 设置为 count - 1。
- 如果 fromBlock 是
- 返回
unused 。
6.2.10 PrivateElement 规范类型
PrivateElement 类型是用于私有类字段、方法和访问器规范的
PrivateElement 类型的值是
| 字段名 | 其存在所对应的 [[Kind]] 字段值 | 值 | 含义 |
|---|---|---|---|
| [[Key]] | 全部 |
|
字段、方法或访问器的名称。 |
| [[Kind]] | 全部 |
|
元素的种类。 |
| [[Value]] |
|
|
字段的值。 |
| [[Get]] |
|
|
私有访问器的 getter。 |
| [[Set]] |
|
|
私有访问器的 setter。 |
6.2.11 ClassFieldDefinition Record 规范类型
ClassFieldDefinition 类型是用于类字段规范的
ClassFieldDefinition 类型的值是
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Name]] |
|
字段的名称。 |
| [[Initializer]] |
ECMAScript |
字段的初始化器，如果有。 |
6.2.12 Private Names
Private Name 规范类型用于描述一个全局唯一值（即使它们在其他方面不可区分，它也不同于任何其他 Private Name），该值表示私有类元素（字段、方法或访问器）的键。每个 Private Name 都有一个不可变的 [[Description]] 内部槽，它是 String。Private Name 可以使用
6.2.13 ClassStaticBlockDefinition Record 规范类型
ClassStaticBlockDefinition Record 是用于封装类静态初始化块可执行代码的
ClassStaticBlockDefinition Records 具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[BodyFunction]] |
ECMAScript |
在类的静态初始化期间要调用的 |
7 抽象操作
这些操作不是 ECMAScript 语言的一部分；它们在此定义仅用于辅助规定 ECMAScript 语言的语义。本规范中还定义了其他更专门的
7.1 类型转换
ECMAScript 语言会根据需要隐式执行自动类型转换。为了阐明某些构造的语义，定义一组转换
7.1.1 ToPrimitive ( input [ , preferredType ] )
The abstract operation ToPrimitive takes argument input (an ECMAScript language value) and optional argument preferredType (
- 如果 input 是 Object，则
- 令 exoticToPrimitive 为 ?
GetMethod (input,%Symbol.toPrimitive% )。 - 如果 exoticToPrimitive 不是
undefined ，则- 如果 preferredType 不存在，则
- 令 hint 为
"default" 。
- 令 hint 为
- 否则如果 preferredType 是
string ，则- 令 hint 为
"string" 。
- 令 hint 为
- 否则，
- 断言：preferredType 是
number 。 - 令 hint 为
"number" 。
- 断言：preferredType 是
- 令 result 为 ?
Call (exoticToPrimitive, input, « hint »)。 - 如果 result 不是 Object，则返回 result。
- 抛出
TypeError 异常。
- 如果 preferredType 不存在，则
- 如果 preferredType 不存在，则将 preferredType 设置为
number 。 - 返回 ?
OrdinaryToPrimitive (input, preferredType)。
- 令 exoticToPrimitive 为 ?
- 返回 input。
当调用 ToPrimitive 时没有提示，它通常表现得好像提示为
7.1.1.1 OrdinaryToPrimitive ( obj, hint )
The abstract operation OrdinaryToPrimitive takes arguments obj (an Object) and hint (
- 如果 hint 是
string ，则- 令 methodNames 为 «
"toString" ,"valueOf" »。
- 令 methodNames 为 «
- 否则，
- 令 methodNames 为 «
"valueOf" ,"toString" »。
- 令 methodNames 为 «
- 对 methodNames 的每个元素 name，执行：
- 令 method 为 ?
Get (obj, name)。 - 如果
IsCallable (method) 是true ，则- 令 result 为 ?
Call (method, obj)。 - 如果 result 不是 Object，则返回 result。
- 令 result 为 ?
- 令 method 为 ?
- 抛出
TypeError 异常。
7.1.2 ToBoolean ( arg )
The abstract operation ToBoolean takes argument arg (an ECMAScript language value) and returns a Boolean. 它将 arg 转换为
- 如果 arg 是 Boolean，则返回 arg。
- 如果 arg 是
undefined 、null 、+0 𝔽、-0 𝔽、NaN 、0 ℤ 或空 String 之一，则返回false 。 - 如果
宿主 是 Web 浏览器，或以其他方式支持[[IsHTMLDDA]] 内部槽 ，则- 如果 arg 是 Object 且 arg 具有 [[IsHTMLDDA]] 内部槽，则返回
false 。
- 如果 arg 是 Object 且 arg 具有 [[IsHTMLDDA]] 内部槽，则返回
- 返回
true 。
7.1.3 ToNumeric ( arg )
The abstract operation ToNumeric takes argument arg (an ECMAScript language value) and returns either a normal completion containing either a Number or a BigInt, or a throw completion. 它返回转换为 Number 或 BigInt 的 arg。 It performs the following steps when called:
- 令 primitiveValue 为 ?
ToPrimitive (arg,number )。 - 如果 primitiveValue 是 BigInt，则返回 primitiveValue。
- 返回 ?
ToNumber (primitiveValue)。
7.1.4 ToNumber ( arg )
The abstract operation ToNumber takes argument arg (an ECMAScript language value) and returns either a normal completion containing a Number or a throw completion. 它将 arg 转换为
- 如果 arg 是 Number，则返回 arg。
- 如果 arg 是 Symbol 或 BigInt，则抛出
TypeError 异常。 - 如果 arg 是
undefined ，则返回NaN 。 - 如果 arg 是
null 或false ，则返回+0 𝔽。 - 如果 arg 是
true ，则返回1 𝔽。 - 如果 arg 是 String，则返回
StringToNumber (arg)。 - 断言：arg 是 Object。
- 令 primitiveValue 为 ?
ToPrimitive (arg,number )。 - 断言：primitiveValue 不是 Object。
- 返回 ?
ToNumber (primitiveValue)。
7.1.4.1 应用于 String 类型的 ToNumber
语法
上面未显式定义的所有文法符号均具有数值字面量的词法文法（
应注意
-
StringNumericLiteral 可以包含 前导和/或尾随空白和/或行终止符。 -
十进制的
StringNumericLiteral 可以具有任意数量的前导0数字。 -
十进制的
StringNumericLiteral 可以包含 +或-以表示其符号。 -
为空或仅
包含 空白的StringNumericLiteral 会被转换为+0 𝔽。 -
Infinity和-Infinity被识别为StringNumericLiteral ，但不被识别为NumericLiteral 。 -
StringNumericLiteral 不能包含 BigIntLiteralSuffix 。 -
StringNumericLiteral 不能包含 NumericLiteralSeparator 。
7.1.4.1.1 StringToNumber ( string )
The abstract operation StringToNumber takes argument string (a String) and returns a Number. It performs the following steps when called:
- 令 literal 为
ParseText (string,StringNumericLiteral )。 - 如果 literal 是错误的
List ，则返回NaN 。 - 返回 literal 的
StringNumericValue 。
7.1.4.1.2 Runtime Semantics: StringNumericValue
The syntax-directed operation StringNumericValue takes no arguments and returns a Number.
将
It is defined piecewise over the following productions:
- 返回
+0 𝔽。
- 返回
𝔽 (NonDecimalIntegerLiteral 的 MV)。
- 令 a 为
StrUnsignedDecimalLiteral 的StringNumericValue 。 - 如果 a 是
+0 𝔽，则返回-0 𝔽。 - 返回 -a。
- 返回
+∞ 𝔽。
- 令 a 为第一个
DecimalDigits 的 MV。 - 如果第二个
DecimalDigits 存在，则- 令 b 为第二个
DecimalDigits 的 MV。 - 令 n 为第二个
DecimalDigits 中码点的数量。
- 令 b 为第二个
- 否则，
- 令 b 为 0。
- 令 n 为 0。
- 如果
ExponentPart 存在，则令 e 为ExponentPart 的 MV；否则令 e 为 0。 - 返回
RoundMVResult ((a + (b × 10-n)) × 10e)。
- 令 b 为
DecimalDigits 的 MV。 - 如果
ExponentPart 存在，则令 e 为ExponentPart 的 MV；否则令 e 为 0。 - 令 n 为
DecimalDigits 中码点的数量。 - 返回
RoundMVResult (b × 10e - n)。
- 令 a 为
DecimalDigits 的 MV。 - 如果
ExponentPart 存在，则令 e 为ExponentPart 的 MV；否则令 e 为 0。 - 返回
RoundMVResult (a × 10e)。
7.1.4.1.3 RoundMVResult ( n )
The abstract operation RoundMVResult takes argument n (a
7.1.5 ToIntegerOrInfinity ( arg )
The abstract operation ToIntegerOrInfinity takes argument arg (an ECMAScript language value) and returns either a normal completion containing either an
7.1.6 ToFixedSizeInteger ( int, signed, bitWidth )
The abstract operation ToFixedSizeInteger takes arguments int (an
- 如果 int = +∞ 或 int = -∞，则返回 0。
- 令 fixedInt 为 int
modulo 2bitWidth。 - 注记：以下步骤不会改变 fixedInt 的二进制补码表示。
- 如果 signed 是
signed 且 fixedInt ≥ 2bitWidth - 1，则将 fixedInt 设置为 fixedInt - 2bitWidth。 - 返回 fixedInt。
ToFixedSizeInteger 是幂等的：对于任意
7.1.7 ToInt32 ( arg )
The abstract operation ToInt32 takes argument arg (an ECMAScript language value) and returns either a normal completion containing an
- 令 int 为 ?
ToIntegerOrInfinity (arg)。 - 返回
𝔽 (ToFixedSizeInteger (int,signed , 32))。
7.1.8 ToUint32 ( arg )
The abstract operation ToUint32 takes argument arg (an ECMAScript language value) and returns either a normal completion containing an
- 令 int 为 ?
ToIntegerOrInfinity (arg)。 - 返回
𝔽 (ToFixedSizeInteger (int,unsigned , 32))。
7.1.9 ToInt16 ( arg )
The abstract operation ToInt16 takes argument arg (an ECMAScript language value) and returns either a normal completion containing an
- 令 int 为 ?
ToIntegerOrInfinity (arg)。 - 返回
𝔽 (ToFixedSizeInteger (int,signed , 16))。
7.1.10 ToUint16 ( arg )
The abstract operation ToUint16 takes argument arg (an ECMAScript language value) and returns either a normal completion containing an
- 令 int 为 ?
ToIntegerOrInfinity (arg)。 - 返回
𝔽 (ToFixedSizeInteger (int,unsigned , 16))。
7.1.11 ToInt8 ( arg )
The abstract operation ToInt8 takes argument arg (an ECMAScript language value) and returns either a normal completion containing an
- 令 int 为 ?
ToIntegerOrInfinity (arg)。 - 返回
𝔽 (ToFixedSizeInteger (int,signed , 8))。
7.1.12 ToUint8 ( arg )
The abstract operation ToUint8 takes argument arg (an ECMAScript language value) and returns either a normal completion containing an
- 令 int 为 ?
ToIntegerOrInfinity (arg)。 - 返回
𝔽 (ToFixedSizeInteger (int,unsigned , 8))。
7.1.13 ToUint8Clamp ( arg )
The abstract operation ToUint8Clamp takes argument arg (an ECMAScript language value) and returns either a normal completion containing an
不同于大多数其他 ECMAScript 整数转换操作，ToUint8Clamp 会对非整数值进行舍入而不是截断。它还使用“舍入到最接近偶数”的平局决策方式，这不同于 Math.round
7.1.14 ToBigInt ( arg )
The abstract operation ToBigInt takes argument arg (an ECMAScript language value) and returns either a normal completion containing a BigInt or a throw completion. 它将 arg 转换为 BigInt 值；如果需要从 Number 进行隐式转换，则抛出。 It performs the following steps when called:
- 令 primitive 为 ?
ToPrimitive (arg,number )。 - 返回 primitive 在
Table 12 中对应的值。
| 实参类型 | 结果 |
|---|---|
| Undefined |
抛出 |
| Null |
抛出 |
| Boolean |
如果 primitive 是 1n；如果 primitive 是 0n。
|
| BigInt | 返回 primitive。 |
| Number |
抛出 |
| String |
|
| Symbol |
抛出 |
7.1.15 StringToBigInt ( string )
The abstract operation StringToBigInt takes argument string (a String) and returns a BigInt or
- 令 literal 为
ParseText (string,StringIntegerLiteral )。 - 如果 literal 是错误的
List ，则返回undefined 。 - 令 mv 为 literal 的 MV。
- 断言：mv 是整数。
- 返回
ℤ (mv)。
7.1.15.1 StringIntegerLiteral 文法
语法
7.1.15.2 Runtime Semantics: MV
-
StringIntegerLiteral ::: StrWhiteSpace opt -
StringIntegerLiteral ::: StrWhiteSpace opt StrIntegerLiteral StrWhiteSpace opt StrIntegerLiteral 的 MV。
7.1.16 ToBigInt64 ( arg )
The abstract operation ToBigInt64 takes argument arg (an ECMAScript language value) and returns either a normal completion containing a BigInt or a throw completion. 它将 arg 转换为 264 个 BigInt 值之一，这些值位于从
- 令 int 为
ℝ (?ToBigInt (arg))。 - 返回
ℤ (ToFixedSizeInteger (int,signed , 64))。
7.1.17 ToBigUint64 ( arg )
The abstract operation ToBigUint64 takes argument arg (an ECMAScript language value) and returns either a normal completion containing a BigInt or a throw completion. 它将 arg 转换为 264 个 BigInt 值之一，这些值位于从
- 令 int 为
ℝ (?ToBigInt (arg))。 - 返回
ℤ (ToFixedSizeInteger (int,unsigned , 64))。
7.1.18 ToString ( arg )
The abstract operation ToString takes argument arg (an ECMAScript language value) and returns either a normal completion containing a String or a throw completion. 它将 arg 转换为
- 如果 arg 是 String，则返回 arg。
- 如果 arg 是 Symbol，则抛出
TypeError 异常。 - 如果 arg 是
undefined ，则返回"undefined" 。 - 如果 arg 是
null ，则返回"null" 。 - 如果 arg 是
true ，则返回"true" 。 - 如果 arg 是
false ，则返回"false" 。 - 如果 arg 是 Number，则返回
Number::toString (arg, 10)。 - 如果 arg 是 BigInt，则返回
BigInt::toString (arg, 10)。 - 断言：arg 是 Object。
- 令 primitiveValue 为 ?
ToPrimitive (arg,string )。 - 断言：primitiveValue 不是 Object。
- 返回 ?
ToString (primitiveValue)。
7.1.19 ToObject ( arg )
The abstract operation ToObject takes argument arg (an ECMAScript language value) and returns either a normal completion containing an Object or a throw completion. 它将 arg 转换为
- 如果 arg 是
undefined 或null ，则抛出TypeError 异常。 - 如果 arg 是 Boolean，则返回一个新的 Boolean 对象，其 [[BooleanData]] 内部槽被设置为 arg。关于 Boolean 对象的描述，参见
20.3 。 - 如果 arg 是 Number，则返回一个新的 Number 对象，其 [[NumberData]] 内部槽被设置为 arg。关于 Number 对象的描述，参见
21.1 。 - 如果 arg 是 String，则返回一个新的 String 对象，其 [[StringData]] 内部槽被设置为 arg。关于 String 对象的描述，参见
22.1 。 - 如果 arg 是 Symbol，则返回一个新的 Symbol 对象，其 [[SymbolData]] 内部槽被设置为 arg。关于 Symbol 对象的描述，参见
20.4 。 - 如果 arg 是 BigInt，则返回一个新的 BigInt 对象，其 [[BigIntData]] 内部槽被设置为 arg。关于 BigInt 对象的描述，参见
21.2 。 - 断言：arg 是 Object。
- 返回 arg。
7.1.20 ToPropertyKey ( arg )
The abstract operation ToPropertyKey takes argument arg (an ECMAScript language value) and returns either a normal completion containing a property key or a throw completion. 它将 arg 转换为可用作
- 令 key 为 ?
ToPrimitive (arg,string )。 - 如果 key 是 Symbol，则
- 返回 key。
- 返回 !
ToString (key)。
7.1.21 ToLength ( arg )
The abstract operation ToLength takes argument arg (an ECMAScript language value) and returns either a normal completion containing a non-negative
- 令 length 为 ?
ToIntegerOrInfinity (arg)。 - 如果 length ≤ 0，则返回
+0 𝔽。 - 返回
𝔽 (min (length, 253 - 1))。
7.1.22 CanonicalNumericIndexString ( arg )
The abstract operation CanonicalNumericIndexString takes argument arg (a String) and returns a Number or
规范数值字符串是任何使 CanonicalNumericIndexString
7.1.23 ToIndex ( arg )
The abstract operation ToIndex takes argument arg (an ECMAScript language value) and returns either a normal completion containing a non-negative
- 令 int 为 ?
ToIntegerOrInfinity (arg)。 - 如果 int 不在从 0 到 253 - 1 的
闭区间 内，则抛出RangeError 异常。 - 返回 int。
7.2 测试和比较操作
7.2.1 RequireObjectCoercible ( arg )
The abstract operation RequireObjectCoercible takes argument arg (an ECMAScript language value) and returns either a normal completion containing
- 如果 arg 是
undefined 或null ，则抛出TypeError 异常。 - 返回
unused 。
7.2.2 IsArray ( arg )
The abstract operation IsArray takes argument arg (an ECMAScript language value) and returns either a normal completion containing a Boolean or a throw completion. It performs the following steps when called:
- 如果 arg 不是 Object，则返回
false 。 - 如果 arg 是
Array 异质对象 ，则返回true 。 - 如果 arg 是
Proxy 异质对象 ，则- 执行 ?
ValidateNonRevokedProxy (arg)。 - 令 proxyTarget 为 arg.[[ProxyTarget]]。
- 返回 ?
IsArray (proxyTarget)。
- 执行 ?
- 返回
false 。
7.2.3 IsCallable ( arg )
The abstract operation IsCallable takes argument arg (an ECMAScript language value) and returns a Boolean. 它确定 arg 是否是具有 [[Call]] 内部方法的可调用函数。 It performs the following steps when called:
- 如果 arg 不是 Object，则返回
false 。 - 如果 arg 具有 [[Call]] 内部方法，则返回
true 。 - 返回
false 。
7.2.4 IsConstructor ( arg )
The abstract operation IsConstructor takes argument arg (an ECMAScript language value) and returns a Boolean. 它确定 arg 是否是具有 [[Construct]] 内部方法的
- 如果 arg 不是 Object，则返回
false 。 - 如果 arg 具有 [[Construct]] 内部方法，则返回
true 。 - 返回
false 。
7.2.5 IsExtensible ( obj )
The abstract operation IsExtensible takes argument obj (an Object) and returns either a normal completion containing a Boolean or a throw completion. 它用于确定是否可以向 obj 添加额外属性。 It performs the following steps when called:
- 返回 ? obj.[[IsExtensible]]()。
7.2.6 IsRegExp ( arg )
The abstract operation IsRegExp takes argument arg (an ECMAScript language value) and returns either a normal completion containing a Boolean or a throw completion. It performs the following steps when called:
- 如果 arg 不是 Object，则返回
false 。 - 令 matcher 为 ?
Get (arg,%Symbol.match% )。 - 如果 matcher 不是
undefined ，则返回ToBoolean (matcher)。 - 如果 arg 具有 [[RegExpMatcher]] 内部槽，则返回
true 。 - 返回
false 。
7.2.7 Static Semantics: IsStringWellFormedUnicode ( string )
The abstract operation IsStringWellFormedUnicode takes argument string (a String) and returns a Boolean. 它按照
- 令 length 为 string 的长度。
- 令 k 为 0。
- 重复，当 k < length 时：
- 令 codePoint 为
CodePointAt (string, k)。 - 如果 codePoint.[[IsUnpairedSurrogate]] 是
true ，则返回false 。 - 将 k 设置为 k + codePoint.[[CodeUnitCount]]。
- 令 codePoint 为
- 返回
true 。
7.2.8 SameType ( x, y )
The abstract operation SameType takes arguments x (an ECMAScript language value) and y (an ECMAScript language value) and returns a Boolean. 它确定两个实参是否属于同一类型。 It performs the following steps when called:
- 如果 x 是
undefined 且 y 是undefined ，则返回true 。 - 如果 x 是
null 且 y 是null ，则返回true 。 - 如果 x 是 Boolean 且 y 是 Boolean，则返回
true 。 - 如果 x 是 Number 且 y 是 Number，则返回
true 。 - 如果 x 是 BigInt 且 y 是 BigInt，则返回
true 。 - 如果 x 是 Symbol 且 y 是 Symbol，则返回
true 。 - 如果 x 是 String 且 y 是 String，则返回
true 。 - 如果 x 是 Object 且 y 是 Object，则返回
true 。 - 返回
false 。
7.2.9 SameValue ( x, y )
The abstract operation SameValue takes arguments x (an ECMAScript language value) and y (an ECMAScript language value) and returns a Boolean. 它确定两个实参是否为同一值。 It performs the following steps when called:
- 如果
SameType (x, y) 是false ，则返回false 。 - 如果 x 是 Number，则
- 返回
Number::sameValue (x, y)。
- 返回
- 返回
SameValueNonNumber (x, y)。
此算法与
7.2.10 SameValueZero ( x, y )
The abstract operation SameValueZero takes arguments x (an ECMAScript language value) and y (an ECMAScript language value) and returns a Boolean. 它确定两个实参是否为同一值（忽略
- 如果
SameType (x, y) 是false ，则返回false 。 - 如果 x 是 Number，则
- 返回
Number::sameValueZero (x, y)。
- 返回
- 返回
SameValueNonNumber (x, y)。
SameValueZero 与
7.2.11 SameValueNonNumber ( x, y )
The abstract operation SameValueNonNumber takes arguments x (an ECMAScript language value, but not a Number) and y (an ECMAScript language value, but not a Number) and returns a Boolean. It performs the following steps when called:
- 断言：
SameType (x, y) 是true 。 - 如果 x 是
undefined 或null ，则返回true 。 - 如果 x 是 BigInt，则
- 返回
BigInt::equal (x, y)。
- 返回
- 如果 x 是 String，则
- 如果 x 和 y 具有相同长度并且相同位置具有相同码元，则返回
true 。 - 返回
false 。
- 如果 x 和 y 具有相同长度并且相同位置具有相同码元，则返回
- 如果 x 是 Boolean，则
- 如果 x 是
true 且 y 是true ，则返回true 。 - 如果 x 是
false 且 y 是false ，则返回true 。 - 返回
false 。
- 如果 x 是
- 注记：所有其他
ECMAScript 语言值 均按身份进行比较。 - 如果 x 是 y，则返回
true 。 - 返回
false 。
7.2.12 IsLessThan ( x, y, leftFirst )
The abstract operation IsLessThan takes arguments x (an ECMAScript language value), y (an ECMAScript language value), and leftFirst (a Boolean) and returns either a normal completion containing either a Boolean or
- 如果 leftFirst 是
true ，则- 令 px 为 ?
ToPrimitive (x,number )。 - 令 py 为 ?
ToPrimitive (y,number )。
- 令 px 为 ?
- 否则，
- 注记：为了保留从左到右的求值顺序，需要反转求值顺序。
- 令 py 为 ?
ToPrimitive (y,number )。 - 令 px 为 ?
ToPrimitive (x,number )。
- 如果 px 是 String 且 py 是 String，则
- 令 lx 为 px 的长度。
- 令 ly 为 py 的长度。
- 对每个满足 0 ≤ i <
min (lx, ly) 的整数 i，按升序执行：- 令 cx 为 px 内索引 i 处码元的数值。
- 令 cy 为 py 内索引 i 处码元的数值。
- 如果 cx < cy，则返回
true 。 - 如果 cx > cy，则返回
false 。
- 如果 lx < ly，则返回
true 。 - 返回
false 。
- 如果 px 是 BigInt 且 py 是 String，则
- 令 ny 为
StringToBigInt (py)。 - 如果 ny 是
undefined ，则返回undefined 。 - 返回
BigInt::lessThan (px, ny)。
- 令 ny 为
- 如果 px 是 String 且 py 是 BigInt，则
- 令 nx 为
StringToBigInt (px)。 - 如果 nx 是
undefined ，则返回undefined 。 - 返回
BigInt::lessThan (nx, py)。
- 令 nx 为
- 注记：因为 px 和 py 是原始值，求值顺序并不重要。
- 令 nx 为 ?
ToNumeric (px)。 - 令 ny 为 ?
ToNumeric (py)。 - 如果
SameType (nx, ny) 是true ，则- 如果 nx 是 Number，则返回
Number::lessThan (nx, ny)。 - 断言：nx 是 BigInt。
- 返回
BigInt::lessThan (nx, ny)。
- 如果 nx 是 Number，则返回
- 断言：nx 是 BigInt 且 ny 是 Number，或 nx 是 Number 且 ny 是 BigInt。
- 如果 nx 是
NaN 或 ny 是NaN ，则返回undefined 。 - 如果 nx 是
-∞ 𝔽 或 ny 是+∞ 𝔽，则返回true 。 - 如果 nx 是
+∞ 𝔽 或 ny 是-∞ 𝔽，则返回false 。 - 如果
ℝ (nx) <ℝ (ny)，则返回true 。 - 返回
false 。
7.2.13 IsLooselyEqual ( x, y )
The abstract operation IsLooselyEqual takes arguments x (an ECMAScript language value) and y (an ECMAScript language value) and returns either a normal completion containing a Boolean or a throw completion. 它提供 == 运算符的语义。 It performs the following steps when called:
- 如果
SameType (x, y) 是true ，则- 返回
IsStrictlyEqual (x, y)。
- 返回
- 如果 x 是
null 且 y 是undefined ，则返回true 。 - 如果 x 是
undefined 且 y 是null ，则返回true 。 - 如果
宿主 是 Web 浏览器，或以其他方式支持[[IsHTMLDDA]] 内部槽 ，则- 如果 x 是 Object，x 具有 [[IsHTMLDDA]] 内部槽，且 y 是
undefined 或null ，则返回true 。 - 如果 x 是
undefined 或null ，y 是 Object，且 y 具有 [[IsHTMLDDA]] 内部槽，则返回true 。
- 如果 x 是 Object，x 具有 [[IsHTMLDDA]] 内部槽，且 y 是
- 如果 x 是 Number 且 y 是 String，则返回 !
IsLooselyEqual (x, !ToNumber (y))。 - 如果 x 是 String 且 y 是 Number，则返回 !
IsLooselyEqual (!ToNumber (x), y)。 - 如果 x 是 BigInt 且 y 是 String，则
- 令 n 为
StringToBigInt (y)。 - 如果 n 是
undefined ，则返回false 。 - 返回 !
IsLooselyEqual (x, n)。
- 令 n 为
- 如果 x 是 String 且 y 是 BigInt，则返回 !
IsLooselyEqual (y, x)。 - 如果 x 是 Boolean，则返回 !
IsLooselyEqual (!ToNumber (x), y)。 - 如果 y 是 Boolean，则返回 !
IsLooselyEqual (x, !ToNumber (y))。 - 如果 x 是 String、Number、BigInt 或 Symbol，且 y 是 Object，则返回 !
IsLooselyEqual (x, ?ToPrimitive (y))。 - 如果 x 是 Object，且 y 是 String、Number、BigInt 或 Symbol，则返回 !
IsLooselyEqual (?ToPrimitive (x), y)。 - 如果 x 是 BigInt 且 y 是 Number，或如果 x 是 Number 且 y 是 BigInt，则
- 返回
false 。
7.2.14 IsStrictlyEqual ( x, y )
The abstract operation IsStrictlyEqual takes arguments x (an ECMAScript language value) and y (an ECMAScript language value) and returns a Boolean. 它提供 === 运算符的语义。 It performs the following steps when called:
- 如果
SameType (x, y) 是false ，则返回false 。 - 如果 x 是 Number，则
- 返回
Number::equal (x, y)。
- 返回
- 返回
SameValueNonNumber (x, y)。
此算法与
7.3 对象上的操作
7.3.1 MakeBasicObject ( internalSlotsList )
The abstract operation MakeBasicObject takes argument internalSlotsList (a
- 将 internalSlotsList 设置为 internalSlotsList 与 « [[PrivateElements]] » 的
列表连接 。 - 令 obj 为一个新创建的对象，它为 internalSlotsList 中的每个名称都有一个内部槽。
- 注记：如
Object 内部方法和内部槽 中所述，除非另有指定，否则每个这类内部槽的初始值都是undefined 。 - 将 obj.[[PrivateElements]] 设置为新的空
List 。 - 将 obj 的基本内部方法设置为
10.1 中指定的默认普通对象 定义。 - 断言：如果调用方不会重写 obj 的 [[GetPrototypeOf]] 和 [[SetPrototypeOf]] 两个基本内部方法，则 internalSlotsList
包含 [[Prototype]]。 - 断言：如果调用方不会重写 obj 的 [[SetPrototypeOf]]、[[IsExtensible]] 和 [[PreventExtensions]] 所有基本内部方法，则 internalSlotsList
包含 [[Extensible]]。 - 如果 internalSlotsList
包含 [[Extensible]]，则将 obj.[[Extensible]] 设置为true 。 - 返回 obj。
在本规范中，
7.3.2 Get ( obj, propertyKey )
The abstract operation Get takes arguments obj (an Object) and propertyKey (a property key) and returns either a normal completion containing an ECMAScript language value or a throw completion. 它用于取回对象的特定属性的值。 It performs the following steps when called:
- 返回 ? obj.[[Get]](propertyKey, obj)。
7.3.3 GetV ( value, propertyKey )
The abstract operation GetV takes arguments value (an ECMAScript language value) and propertyKey (a property key) and returns either a normal completion containing an ECMAScript language value or a throw completion. 它用于取回
- 令 obj 为 ?
ToObject (value)。 - 返回 ? obj.[[Get]](propertyKey, value)。
7.3.4 Set ( obj, propertyKey, value, throw )
The abstract operation Set takes arguments obj (an Object), propertyKey (a property key), value (an ECMAScript language value), and throw (a Boolean) and returns either a normal completion containing
- 令 success 为 ? obj.[[Set]](propertyKey, value, obj)。
- 如果 success 是
false 且 throw 是true ，则抛出TypeError 异常。 - 返回
unused 。
7.3.5 CreateDataProperty ( obj, propertyKey, value )
The abstract operation CreateDataProperty takes arguments obj (an Object), propertyKey (a property key), and value (an ECMAScript language value) and returns either a normal completion containing a Boolean or a throw completion. 它用于创建对象的一个新自有属性。 It performs the following steps when called:
- 令 newDesc 为 PropertyDescriptor { [[Value]]: value, [[Writable]]:
true , [[Enumerable]]:true , [[Configurable]]:true }。 - 返回 ? obj.[[DefineOwnProperty]](propertyKey, newDesc)。
此
7.3.6 CreateDataPropertyOrThrow ( obj, propertyKey, value )
The abstract operation CreateDataPropertyOrThrow takes arguments obj (an Object), propertyKey (a property key), and value (an ECMAScript language value) and returns either a normal completion containing
- 令 success 为 ?
CreateDataProperty (obj, propertyKey, value)。 - 如果 success 是
false ，则抛出TypeError 异常。 - 返回
unused 。
此
7.3.7 CreateNonEnumerableDataPropertyOrThrow ( obj, propertyKey, value )
The abstract operation CreateNonEnumerableDataPropertyOrThrow takes arguments obj (an Object), propertyKey (a property key), and value (an ECMAScript language value) and returns
- 断言：obj 是一个普通、可扩展且没有不可配置属性的对象。
- 令 newDesc 为 PropertyDescriptor { [[Value]]: value, [[Writable]]:
true , [[Enumerable]]:false , [[Configurable]]:true }。 - 执行 !
DefinePropertyOrThrow (obj, propertyKey, newDesc)。 - 返回
unused 。
此
7.3.8 DefinePropertyOrThrow ( obj, propertyKey, propertyDesc )
The abstract operation DefinePropertyOrThrow takes arguments obj (an Object), propertyKey (a property key), and propertyDesc (a
- 令 success 为 ? obj.[[DefineOwnProperty]](propertyKey, propertyDesc)。
- 如果 success 是
false ，则抛出TypeError 异常。 - 返回
unused 。
7.3.9 DeletePropertyOrThrow ( obj, propertyKey )
The abstract operation DeletePropertyOrThrow takes arguments obj (an Object) and propertyKey (a property key) and returns either a normal completion containing
- 令 success 为 ? obj.[[Delete]](propertyKey)。
- 如果 success 是
false ，则抛出TypeError 异常。 - 返回
unused 。
7.3.10 GetMethod ( value, propertyKey )
The abstract operation GetMethod takes arguments value (an ECMAScript language value) and propertyKey (a property key) and returns either a normal completion containing either a function object or
- 令 func 为 ?
GetV (value, propertyKey)。 - 如果 func 是
undefined 或null ，则返回undefined 。 - 如果
IsCallable (func) 是false ，则抛出TypeError 异常。 - 返回 func。
7.3.11 HasProperty ( obj, propertyKey )
The abstract operation HasProperty takes arguments obj (an Object) and propertyKey (a property key) and returns either a normal completion containing a Boolean or a throw completion. 它用于确定对象是否具有指定
- 返回 ? obj.[[HasProperty]](propertyKey)。
7.3.12 HasOwnProperty ( obj, propertyKey )
The abstract operation HasOwnProperty takes arguments obj (an Object) and propertyKey (a property key) and returns either a normal completion containing a Boolean or a throw completion. 它用于确定对象是否具有指定
- 令 propertyDesc 为 ? obj.[[GetOwnProperty]](propertyKey)。
- 如果 propertyDesc 是
undefined ，则返回false 。 - 返回
true 。
7.3.13 Call ( func, thisValue [ , argList ] )
The abstract operation Call takes arguments func (an ECMAScript language value) and thisValue (an ECMAScript language value) and optional argument argList (a
- 如果 argList 不存在，则将 argList 设置为新的空
List 。 - 如果
IsCallable (func) 是false ，则抛出TypeError 异常。 - 返回 ? func.[[Call]](thisValue, argList)。
7.3.14 Construct ( ctor [ , argList [ , newTarget ] ] )
The abstract operation Construct takes argument ctor (a constructor) and optional arguments argList (a
- 如果 newTarget 不存在，则将 newTarget 设置为 ctor。
- 如果 argList 不存在，则将 argList 设置为新的空
List 。 - 返回 ? ctor.[[Construct]](argList, newTarget)。
如果 newTarget 不存在，则此操作等价于：new F(...argumentsList)
7.3.15 SetIntegrityLevel ( obj, level )
The abstract operation SetIntegrityLevel takes arguments obj (an Object) and level (
- 令 status 为 ? obj.[[PreventExtensions]]()。
- 如果 status 是
false ，则返回false 。 - 令 keys 为 ? obj.[[OwnPropertyKeys]]()。
- 如果 level 是
sealed ，则- 对 keys 的每个元素 key，执行：
- 执行 ?
DefinePropertyOrThrow (obj, key, PropertyDescriptor { [[Configurable]]:false })。
- 执行 ?
- 对 keys 的每个元素 key，执行：
- 否则，
- 断言：level 是
frozen 。 - 对 keys 的每个元素 key，执行：
- 令 currentDesc 为 ? obj.[[GetOwnProperty]](key)。
- 如果 currentDesc 不是
undefined ，则- 如果
IsAccessorDescriptor (currentDesc) 是true ，则- 令 propertyDesc 为 PropertyDescriptor { [[Configurable]]:
false }。
- 令 propertyDesc 为 PropertyDescriptor { [[Configurable]]:
- 否则，
- 令 propertyDesc 为 PropertyDescriptor { [[Configurable]]:
false , [[Writable]]:false }。
- 令 propertyDesc 为 PropertyDescriptor { [[Configurable]]:
- 执行 ?
DefinePropertyOrThrow (obj, key, propertyDesc)。
- 如果
- 断言：level 是
- 返回
true 。
7.3.16 TestIntegrityLevel ( obj, level )
The abstract operation TestIntegrityLevel takes arguments obj (an Object) and level (
- 令 extensible 为 ?
IsExtensible (obj)。 - 如果 extensible 是
true ，则返回false 。 - 注记：如果对象是可扩展的，则不会检查其任何属性。
- 令 keys 为 ? obj.[[OwnPropertyKeys]]()。
- 对 keys 的每个元素 key，执行：
- 令 currentDesc 为 ? obj.[[GetOwnProperty]](key)。
- 如果 currentDesc 不是
undefined ，则- 如果 currentDesc.[[Configurable]] 是
true ，则返回false 。 - 如果 level 是
frozen 且IsDataDescriptor (currentDesc) 是true ，则- 如果 currentDesc.[[Writable]] 是
true ，则返回false 。
- 如果 currentDesc.[[Writable]] 是
- 如果 currentDesc.[[Configurable]] 是
- 返回
true 。
7.3.17 CreateArrayFromList ( elements )
The abstract operation CreateArrayFromList takes argument elements (a
- 令 array 为 !
ArrayCreate (0)。 - 令 n 为 0。
- 对 elements 的每个元素 element，执行：
- 执行 !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (n)), element)。 - 将 n 设置为 n + 1。
- 执行 !
- 返回 array。
7.3.18 LengthOfArrayLike ( obj )
The abstract operation LengthOfArrayLike takes argument obj (an Object) and returns either a normal completion containing a non-negative
类数组对象是使此操作返回
7.3.19 CreateListFromArrayLike ( obj [ , validElementTypes ] )
The abstract operation CreateListFromArrayLike takes argument obj (an ECMAScript language value) and optional argument validElementTypes (
- 如果 validElementTypes 不存在，则将 validElementTypes 设置为
all 。 - 如果 obj 不是 Object，则抛出
TypeError 异常。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 令 list 为新的空
List 。 - 令 index 为 0。
- 重复，当 index < length 时：
- 返回 list。
7.3.20 Invoke ( value, propertyKey [ , argList ] )
The abstract operation Invoke takes arguments value (an ECMAScript language value) and propertyKey (a property key) and optional argument argList (a
7.3.21 OrdinaryHasInstance ( ctor, instance )
The abstract operation OrdinaryHasInstance takes arguments ctor (an ECMAScript language value) and instance (an ECMAScript language value) and returns either a normal completion containing a Boolean or a throw completion. 它实现默认算法，用于确定 instance 是否继承自 ctor 提供的实例对象继承路径。 It performs the following steps when called:
- 如果
IsCallable (ctor) 是false ，则返回false 。 - 如果 ctor 具有 [[BoundTargetFunction]] 内部槽，则
- 令 boundCtor 为 ctor.[[BoundTargetFunction]]。
- 返回 ?
InstanceofOperator (instance, boundCtor)。
- 如果 instance 不是 Object，则返回
false 。 - 令 proto 为 ?
Get (ctor,"prototype" )。 - 如果 proto 不是 Object，则抛出
TypeError 异常。 - 重复：
- 将 instance 设置为 ? instance.[[GetPrototypeOf]]()。
- 如果 instance 是
null ，则返回false 。 - 如果
SameValue (proto, instance) 是true ，则返回true 。
7.3.22 SpeciesConstructor ( obj, defaultCtor )
The abstract operation SpeciesConstructor takes arguments obj (an Object) and defaultCtor (a constructor) and returns either a normal completion containing a constructor or a throw completion. 它用于取回应当用来创建派生自 obj 的新对象的
- 令 ctor 为 ?
Get (obj,"constructor" )。 - 如果 ctor 是
undefined ，则返回 defaultCtor。 - 如果 ctor 不是 Object，则抛出
TypeError 异常。 - 令 species 为 ?
Get (ctor,%Symbol.species% )。 - 如果 species 是
undefined 或null ，则返回 defaultCtor。 - 如果
IsConstructor (species) 是true ，则返回 species。 - 抛出
TypeError 异常。
7.3.23 EnumerableOwnProperties ( obj, kind )
The abstract operation EnumerableOwnProperties takes arguments obj (an Object) and kind (
- 令 ownKeys 为 ? obj.[[OwnPropertyKeys]]()。
- 令 results 为新的空
List 。 - 对 ownKeys 的每个元素 key，执行：
- 如果 key 是 String，则
- 令 propertyDesc 为 ? obj.[[GetOwnProperty]](key)。
- 如果 propertyDesc 不是
undefined 且 propertyDesc.[[Enumerable]] 是true ，则- 如果 kind 是
key ，则- 将 key 追加到 results。
- 否则，
- 令 value 为 ?
Get (obj, key)。 - 如果 kind 是
value ，则- 将 value 追加到 results。
- 否则，
- 断言：kind 是
key+value 。 - 令 entry 为
CreateArrayFromList (« key, value »)。 - 将 entry 追加到 results。
- 断言：kind 是
- 令 value 为 ?
- 如果 kind 是
- 如果 key 是 String，则
- 返回 results。
7.3.24 GetFunctionRealm ( func )
The abstract operation GetFunctionRealm takes argument func (a function object) and returns either a normal completion containing a
- 如果 func 具有 [[Realm]] 内部槽，则
- 返回 func.[[Realm]]。
- 如果 func 是
绑定函数异质对象 ，则- 令 boundTargetFunc 为 func.[[BoundTargetFunction]]。
- 返回 ?
GetFunctionRealm (boundTargetFunc)。
- 如果 func 是
Proxy 异质对象 ，则- 执行 ?
ValidateNonRevokedProxy (func)。 - 令 proxyTarget 为 func.[[ProxyTarget]]。
- 断言：proxyTarget 是
函数对象 。 - 返回 ?
GetFunctionRealm (proxyTarget)。
- 执行 ?
- 返回
当前 Realm Record 。
7.3.25 CopyDataProperties ( target, source, excludedItems )
The abstract operation CopyDataProperties takes arguments target (an Object), source (an ECMAScript language value), and excludedItems (a
- 如果 source 是
undefined 或null ，则返回unused 。 - 令 from 为 !
ToObject (source)。 - 令 keys 为 ? from.[[OwnPropertyKeys]]()。
- 对 keys 的每个元素 nextKey，执行：
- 令 excluded 为
false 。 - 对 excludedItems 的每个元素 element，执行：
- 如果
SameValue (element, nextKey) 是true ，则- 将 excluded 设置为
true 。
- 将 excluded 设置为
- 如果
- 如果 excluded 是
false ，则- 令 propertyDesc 为 ? from.[[GetOwnProperty]](nextKey)。
- 如果 propertyDesc 不是
undefined 且 propertyDesc.[[Enumerable]] 是true ，则- 令 propertyValue 为 ?
Get (from, nextKey)。 - 执行 !
CreateDataPropertyOrThrow (target, nextKey, propertyValue)。
- 令 propertyValue 为 ?
- 令 excluded 为
- 返回
unused 。
这里传入的 target 始终是新创建的对象，在抛出错误的情况下无法直接访问。
7.3.26 PrivateElementFind ( obj, privateName )
The abstract operation PrivateElementFind takes arguments obj (an Object) and privateName (a
- 如果 obj.[[PrivateElements]]
包含 一个PrivateElement entry，使得 entry.[[Key]] 是 privateName，则- 返回 entry。
- 返回
empty 。
7.3.27 PrivateFieldAdd ( obj, privateName, value )
The abstract operation PrivateFieldAdd takes arguments obj (an Object), privateName (a
- 如果
宿主 是 Web 浏览器，则- 执行 ?
HostEnsureCanAddPrivateElement (obj)。
- 执行 ?
- 令 entry 为
PrivateElementFind (obj, privateName)。 - 如果 entry 不是
empty ，则抛出TypeError 异常。 - 将
PrivateElement { [[Key]]: privateName, [[Kind]]:field , [[Value]]: value } 追加到 obj.[[PrivateElements]]。 - 返回
unused 。
7.3.28 PrivateMethodOrAccessorAdd ( obj, method )
The abstract operation PrivateMethodOrAccessorAdd takes arguments obj (an Object) and method (a
- 断言：method.[[Kind]] 是
method 或accessor 。 - 如果
宿主 是 Web 浏览器，则- 执行 ?
HostEnsureCanAddPrivateElement (obj)。
- 执行 ?
- 令 entry 为
PrivateElementFind (obj, method.[[Key]])。 - 如果 entry 不是
empty ，则抛出TypeError 异常。 - 将 method 追加到 obj.[[PrivateElements]]。
- 返回
unused 。
私有方法和访问器的值在实例之间共享。此操作不会创建方法或访问器的新副本。
7.3.29 HostEnsureCanAddPrivateElement ( obj )
The host-defined abstract operation HostEnsureCanAddPrivateElement takes argument obj (an Object) and returns either a normal completion containing
HostEnsureCanAddPrivateElement 的实现必须符合以下要求：
- 如果 obj 不是
宿主定义的 异质对象 ，则此抽象操作 必须返回NormalCompletion (unused )，且不执行其他步骤。 - 使用相同实参调用此
抽象操作 的任意两次调用，必须返回同种Completion Record 。
HostEnsureCanAddPrivateElement 的默认实现是返回
7.3.30 PrivateGet ( obj, privateName )
The abstract operation PrivateGet takes arguments obj (an Object) and privateName (a
- 令 entry 为
PrivateElementFind (obj, privateName)。 - 如果 entry 是
empty ，则抛出TypeError 异常。 - 如果 entry.[[Kind]] 是
field 或method ，则- 返回 entry.[[Value]]。
- 断言：entry.[[Kind]] 是
accessor 。 - 如果 entry.[[Get]] 是
undefined ，则抛出TypeError 异常。 - 令 getter 为 entry.[[Get]]。
- 返回 ?
Call (getter, obj)。
7.3.31 PrivateSet ( obj, privateName, value )
The abstract operation PrivateSet takes arguments obj (an Object), privateName (a
- 令 entry 为
PrivateElementFind (obj, privateName)。 - 如果 entry 是
empty ，则抛出TypeError 异常。 - 如果 entry.[[Kind]] 是
method ，则抛出TypeError 异常。 - 如果 entry.[[Kind]] 是
field ，则- 将 entry.[[Value]] 设置为 value。
- 否则，
- 断言：entry.[[Kind]] 是
accessor 。 - 如果 entry.[[Set]] 是
undefined ，则抛出TypeError 异常。 - 令 setter 为 entry.[[Set]]。
- 执行 ?
Call (setter, obj, « value »)。
- 断言：entry.[[Kind]] 是
- 返回
unused 。
7.3.32 DefineField ( receiver, fieldRecord )
The abstract operation DefineField takes arguments receiver (an Object) and fieldRecord (a
- 令 fieldName 为 fieldRecord.[[Name]]。
- 令 initializer 为 fieldRecord.[[Initializer]]。
- 如果 initializer 不是
empty ，则- 令 initValue 为 ?
Call (initializer, receiver)。
- 令 initValue 为 ?
- 否则，
- 令 initValue 为
undefined 。
- 令 initValue 为
- 如果 fieldName 是
Private Name ，则- 执行 ?
PrivateFieldAdd (receiver, fieldName, initValue)。
- 执行 ?
- 否则，
- 断言：fieldName 是
属性键 。 - 执行 ?
CreateDataPropertyOrThrow (receiver, fieldName, initValue)。
- 断言：fieldName 是
- 返回
unused 。
7.3.33 InitializeInstanceElements ( obj, ctor )
The abstract operation InitializeInstanceElements takes arguments obj (an Object) and ctor (an ECMAScript function object or a built-in function object) and returns either a normal completion containing
- 令 methods 为 ctor.[[PrivateMethods]]。
- 对 methods 的每个
PrivateElement method，执行：- 执行 ?
PrivateMethodOrAccessorAdd (obj, method)。
- 执行 ?
- 令 fields 为 ctor.[[Fields]]。
- 对 fields 的每个元素 fieldRecord，执行：
- 执行 ?
DefineField (obj, fieldRecord)。
- 执行 ?
- 返回
unused 。
7.3.34 AddValueToKeyedGroup ( groups, key, value )
The abstract operation AddValueToKeyedGroup takes arguments groups (a
7.3.35 GroupBy ( items, callback, keyCoercion )
The abstract operation GroupBy takes arguments items (an ECMAScript language value), callback (an ECMAScript language value), and keyCoercion (
- 执行 ?
RequireObjectCoercible (items)。 - 如果
IsCallable (callback) 是false ，则抛出TypeError 异常。 - 令 groups 为新的空
List 。 - 令 iteratorRecord 为 ?
GetIterator (items,sync )。 - 令 k 为 0。
- 重复：
- 如果 k ≥ 253 - 1，则
- 令 error 为
ThrowCompletion (一个新创建的TypeError 对象)。 - 返回 ?
IteratorClose (iteratorRecord, error)。
- 令 error 为
- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 是
done ，则- 返回 groups。
- 令 value 为 next。
- 令 key 为
Completion (Call (callback,undefined , « value,𝔽 (k) »))。 IfAbruptCloseIterator (key, iteratorRecord)。- 如果 keyCoercion 是
property ，则- 将 key 设置为
Completion (ToPropertyKey (key))。 IfAbruptCloseIterator (key, iteratorRecord)。
- 将 key 设置为
- 否则，
- 断言：keyCoercion 是
collection 。 - 将 key 设置为
CanonicalizeKeyedCollectionKey (key)。
- 断言：keyCoercion 是
- 执行
AddValueToKeyedGroup (groups, key, value)。 - 将 k 设置为 k + 1。
- 如果 k ≥ 253 - 1，则
7.3.36 GetOptionsObject ( options )
The abstract operation GetOptionsObject takes argument options (an ECMAScript language value) and returns either a normal completion containing an Object or a throw completion. It performs the following steps when called:
- 如果 options 是
undefined ，则- 返回
OrdinaryObjectCreate (null )。
- 返回
- 如果 options 是 Object，则
- 返回 options。
- 抛出
TypeError 异常。
7.3.37 SetterThatIgnoresPrototypeProperties ( thisValue, home, propertyKey, value )
The abstract operation SetterThatIgnoresPrototypeProperties takes arguments thisValue (an ECMAScript language value), home (an Object), propertyKey (a property key), and value (an ECMAScript language value) and returns either a normal completion containing
- 如果 thisValue 不是 Object，则
- 抛出
TypeError 异常。
- 抛出
- 如果
SameValue (thisValue, home) 是true ，则- 注记：在此处抛出会模拟在严格模式代码中对 home 对象上的不可写
数据属性 赋值。 - 抛出
TypeError 异常。
- 注记：在此处抛出会模拟在严格模式代码中对 home 对象上的不可写
- 令 propertyDesc 为 ? thisValue.[[GetOwnProperty]](propertyKey)。
- 如果 propertyDesc 是
undefined ，则- 执行 ?
CreateDataPropertyOrThrow (thisValue, propertyKey, value)。
- 执行 ?
- 否则，
- 执行 ?
Set (thisValue, propertyKey, value,true )。
- 执行 ?
- 返回
unused 。
7.4 迭代器对象上的操作
参见通用迭代接口（
7.4.1 Iterator Records
Iterator Record 是用于封装迭代器或异步迭代器以及 next 方法的
Iterator Records 具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Iterator]] | Object | 符合迭代器接口或异步迭代器接口的对象。 |
| [[NextMethod]] |
|
[[Iterator]] 对象的 next 方法。
|
| [[Done]] | Boolean | 迭代器是否已经完成或已被关闭。 |
7.4.2 GetIteratorDirect ( obj )
The abstract operation GetIteratorDirect takes argument obj (an Object) and returns either a normal completion containing an
- 令 nextMethod 为 ?
Get (obj,"next" )。 - 令 iteratorRecord 为
Iterator Record { [[Iterator]]: obj, [[NextMethod]]: nextMethod, [[Done]]:false }。 - 返回 iteratorRecord。
7.4.3 GetIteratorFromMethod ( obj, method )
The abstract operation GetIteratorFromMethod takes arguments obj (an ECMAScript language value) and method (a function object) and returns either a normal completion containing an
- 令 iterator 为 ?
Call (method, obj)。 - 如果 iterator 不是 Object，则抛出
TypeError 异常。 - 返回 ?
GetIteratorDirect (iterator)。
7.4.4 GetIterator ( obj, kind )
The abstract operation GetIterator takes arguments obj (an ECMAScript language value) and kind (
- 如果 kind 是
async ，则- 令 method 为 ?
GetMethod (obj,%Symbol.asyncIterator% )。 - 如果 method 是
undefined ，则- 令 syncMethod 为 ?
GetMethod (obj,%Symbol.iterator% )。 - 如果 syncMethod 是
undefined ，则抛出TypeError 异常。 - 令 syncIteratorRecord 为 ?
GetIteratorFromMethod (obj, syncMethod)。 - 返回
CreateAsyncFromSyncIterator (syncIteratorRecord)。
- 令 syncMethod 为 ?
- 令 method 为 ?
- 否则，
- 令 method 为 ?
GetMethod (obj,%Symbol.iterator% )。
- 令 method 为 ?
- 如果 method 是
undefined ，则抛出TypeError 异常。 - 返回 ?
GetIteratorFromMethod (obj, method)。
7.4.5 GetIteratorFlattenable ( obj, primitiveHandling )
The abstract operation GetIteratorFlattenable takes arguments obj (an ECMAScript language value) and primitiveHandling (
- 如果 obj 不是 Object，则
- 如果 primitiveHandling 是
reject-primitives ，则抛出TypeError 异常。 - 断言：primitiveHandling 是
iterate-string-primitives 。 - 如果 obj 不是 String，则抛出
TypeError 异常。
- 如果 primitiveHandling 是
- 令 method 为 ?
GetMethod (obj,%Symbol.iterator% )。 - 如果 method 是
undefined ，则- 令 iterator 为 obj。
- 否则，
- 令 iterator 为 ?
Call (method, obj)。
- 令 iterator 为 ?
- 如果 iterator 不是 Object，则抛出
TypeError 异常。 - 返回 ?
GetIteratorDirect (iterator)。
7.4.6 IteratorNext ( iteratorRecord [ , value ] )
The abstract operation IteratorNext takes argument iteratorRecord (an
- 如果 value 不存在，则
- 令 result 为
Completion (Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]]))。
- 令 result 为
- 否则，
- 令 result 为
Completion (Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]], « value »))。
- 令 result 为
- 如果 result 是
throw 完成 ，则- 将 iteratorRecord.[[Done]] 设置为
true 。 - 返回 ? result。
- 将 iteratorRecord.[[Done]] 设置为
- 将 result 设置为 ! result。
- 如果 result 不是 Object，则
- 将 iteratorRecord.[[Done]] 设置为
true 。 - 抛出
TypeError 异常。
- 将 iteratorRecord.[[Done]] 设置为
- 返回 result。
7.4.7 IteratorComplete ( iteratorResult )
The abstract operation IteratorComplete takes argument iteratorResult (an Object) and returns either a normal completion containing a Boolean or a throw completion. It performs the following steps when called:
7.4.8 IteratorValue ( iteratorResult )
The abstract operation IteratorValue takes argument iteratorResult (an Object) and returns either a normal completion containing an ECMAScript language value or a throw completion. It performs the following steps when called:
- 返回 ?
Get (iteratorResult,"value" )。
7.4.9 IteratorStep ( iteratorRecord )
The abstract operation IteratorStep takes argument iteratorRecord (an
- 令 result 为 ?
IteratorNext (iteratorRecord)。 - 令 done 为
Completion (IteratorComplete (result))。 - 如果 done 是
throw 完成 ，则- 将 iteratorRecord.[[Done]] 设置为
true 。 - 返回 ? done。
- 将 iteratorRecord.[[Done]] 设置为
- 将 done 设置为 ! done。
- 如果 done 是
true ，则- 将 iteratorRecord.[[Done]] 设置为
true 。 - 返回
done 。
- 将 iteratorRecord.[[Done]] 设置为
- 返回 result。
7.4.10 IteratorStepValue ( iteratorRecord )
The abstract operation IteratorStepValue takes argument iteratorRecord (an
- 令 result 为 ?
IteratorStep (iteratorRecord)。 - 如果 result 是
done ，则- 返回
done 。
- 返回
- 令 value 为
Completion (IteratorValue (result))。 - 如果 value 是
throw 完成 ，则- 将 iteratorRecord.[[Done]] 设置为
true 。
- 将 iteratorRecord.[[Done]] 设置为
- 返回 ? value。
7.4.11 IteratorClose ( iteratorRecord, completion )
The abstract operation IteratorClose takes arguments iteratorRecord (an
- 断言：iteratorRecord.[[Iterator]] 是 Object。
- 令 iterator 为 iteratorRecord.[[Iterator]]。
- 令 innerResult 为
Completion (GetMethod (iterator,"return" )). - 如果 innerResult 是 normal 完成，则
- 令 return 为 innerResult.[[Value]]。
- 如果 return 是
undefined ，则返回 ? completion。 - 将 innerResult 设置为
Completion (Call (return, iterator))。
- 如果 completion 是
throw 完成 ，则返回 ? completion。 - 如果 innerResult 是
throw 完成 ，则返回 ? innerResult。 - 如果 innerResult.[[Value]] 不是 Object，则抛出
TypeError 异常。 - 返回 ? completion。
7.4.12 IteratorCloseAll ( iterators, completion )
The abstract operation IteratorCloseAll takes arguments iterators (a
- 对 iterators 的每个元素 iterator，按
List 的逆序，执行：- 将 completion 设置为
Completion (IteratorClose (iterator, completion))。
- 将 completion 设置为
- 返回 ? completion。
7.4.13 IfAbruptCloseIterator ( value, iteratorRecord )
IfAbruptCloseIterator 是一系列使用
IfAbruptCloseIterator (value, iteratorRecord).
与以下内容含义相同：
- 断言：value 是
Completion Record 。 - 如果 value 是 abrupt 完成，则返回 ?
IteratorClose (iteratorRecord, value)。 - 将 value 设置为 ! value。
7.4.14 IfAbruptCloseIterators ( value, iteratorRecords )
IfAbruptCloseIterators 是一系列使用
IfAbruptCloseIterators (value, iteratorRecords).
与以下内容含义相同：
- 断言：value 是
Completion Record 。 - 如果 value 是 abrupt 完成，则返回 ?
IteratorCloseAll (iteratorRecords, value)。 - 将 value 设置为 ! value。
7.4.15 AsyncIteratorClose ( iteratorRecord, completion )
The abstract operation AsyncIteratorClose takes arguments iteratorRecord (an
- 断言：iteratorRecord.[[Iterator]] 是 Object。
- 令 iterator 为 iteratorRecord.[[Iterator]]。
- 令 innerResult 为
Completion (GetMethod (iterator,"return" )). - 如果 innerResult 是 normal 完成，则
- 令 return 为 innerResult.[[Value]]。
- 如果 return 是
undefined ，则返回 ? completion。 - 将 innerResult 设置为
Completion (Call (return, iterator))。 - 如果 innerResult 是 normal 完成，则将 innerResult 设置为
Completion (Await (innerResult.[[Value]]))。
- 如果 completion 是
throw 完成 ，则返回 ? completion。 - 如果 innerResult 是
throw 完成 ，则返回 ? innerResult。 - 如果 innerResult.[[Value]] 不是 Object，则抛出
TypeError 异常。 - 返回 ? completion。
7.4.16 IfAbruptCloseAsyncIterator ( value, iteratorRecord )
IfAbruptCloseAsyncIterator 是一系列使用
IfAbruptCloseAsyncIterator (value, iteratorRecord).
与以下内容含义相同：
- 断言：value 是
Completion Record 。 - 如果 value 是 abrupt 完成，则返回 ?
AsyncIteratorClose (iteratorRecord, value)。 - 将 value 设置为 ! value。
7.4.17 CreateIteratorResultObject ( value, done )
The abstract operation CreateIteratorResultObject takes arguments value (an ECMAScript language value) and done (a Boolean) and returns an Object that conforms to the IteratorResult interface. 它创建一个符合
- 令 obj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 !
CreateDataPropertyOrThrow (obj,"value" , value)。 - 执行 !
CreateDataPropertyOrThrow (obj,"done" , done)。 - 返回 obj。
7.4.18 CreateListIteratorRecord ( list )
The abstract operation CreateListIteratorRecord takes argument list (a
- 令 closure 为一个不带形参的新
Abstract Closure ，它捕获 list，并在被调用时执行以下步骤：- 对 list 的每个元素 value，执行：
- 执行 ?
GeneratorYield (CreateIteratorResultObject (value,false ))。
- 执行 ?
- 返回
NormalCompletion (undefined )。
- 对 list 的每个元素 value，执行：
- 令 iterator 为
CreateIteratorFromClosure (closure,empty ,%Iterator.prototype% )。 - 返回
Iterator Record { [[Iterator]]: iterator, [[NextMethod]]: %GeneratorPrototype.next%, [[Done]]:false }。
list 迭代器对象永远不会被 ECMAScript 代码直接访问。
7.4.19 IteratorToList ( iteratorRecord )
The abstract operation IteratorToList takes argument iteratorRecord (an
- 令 values 为新的空
List 。 - 重复：
- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 是
done ，则- 返回 values。
- 将 next 追加到 values。
- 令 next 为 ?
7.5 对可处置对象的操作
参见通用资源管理接口（
7.5.1 DisposableResource 记录
DisposableResource 记录是一个记录值，用于封装一个可处置对象以及用于处置该对象的方法。DisposableResource 记录由
DisposableResource 记录具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[ResourceValue]] |
一个对象或 |
要被处置的值。 |
| [[Kind]] |
|
指示资源是由 using 声明或 DisposableStack 对象添加的（await using 声明或 AsyncDisposableStack 对象添加的（ |
| [[DisposeMethod]] |
一个 |
当资源被处置时，将以 [[ResourceValue]] 作为其 |
7.5.2 AddDisposableResource ( disposableResourceStack, value, kind [ , method ] )
The abstract operation AddDisposableResource takes arguments disposableResourceStack (
- 如果存在 method，则
- 断言：value 是
undefined 。 - 令 resource 为 ?
CreateDisposableResource (undefined , kind, method)。
- 断言：value 是
- 否则，
- 如果 value 是
null 或undefined ，且 kind 是sync-dispose ，则返回unused 。 - 注：当 value 是
null 或undefined ，且 kind 是async-dispose 时，我们会记录该资源已被求值，以确保稍后处置资源时仍将执行Await 。 - 令 resource 为 ?
CreateDisposableResource (value, kind)。
- 如果 value 是
- 将 resource 追加到 disposableResourceStack。
- 返回
unused 。
7.5.3 CreateDisposableResource ( value, kind [ , method ] )
The abstract operation CreateDisposableResource takes arguments value (
- 如果不存在 method，则
- 如果 value 是
null 或undefined ，则- 将 value 设置为
undefined 。 - 将 method 设置为
undefined 。
- 将 value 设置为
- 否则，
- 将 method 设置为 ?
GetDisposeMethod (value, kind)。 - 如果 method 是
undefined ，则抛出TypeError 异常。
- 将 method 设置为 ?
- 如果 value 是
- 返回
DisposableResource 记录 { [[ResourceValue]]: value, [[Kind]]: kind, [[DisposeMethod]]: method }。
7.5.4 GetDisposeMethod ( value, kind )
The abstract operation GetDisposeMethod takes arguments value (
- 如果 value 不是对象，则抛出
TypeError 异常。 - 如果 kind 是
sync-dispose ，则返回 ?GetMethod (value,%Symbol.dispose% )。 - 断言：kind 是
async-dispose 。 - 令 asyncMethod 为 ?
GetMethod (value,%Symbol.asyncDispose% )。 - 如果 asyncMethod 不是
undefined ，则返回 asyncMethod。 - 令 syncMethod 为 ?
GetMethod (value,%Symbol.dispose% )。 - 如果 syncMethod 是
undefined ，则返回undefined 。 - 令 closure 为一个新的抽象闭包，该闭包没有参数，捕获 syncMethod，并在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 result 为
Completion (Call (syncMethod, obj))。 IfAbruptRejectPromise (result, promiseCapability)。- 执行 !
Call (promiseCapability.[[Resolve]],undefined , «undefined »)。 - 返回 promiseCapability.[[Promise]]。
- 令 obj 为
- 注：此函数对用户代码不可观察。它用于确保从同步
%Symbol.dispose%方法返回的 Promise 不会被 awaited，并且同步异常会被转换为被拒绝的 Promise。 - 返回
CreateBuiltinFunction (closure, 0,"" , « »)。
7.5.5 DisposeResources ( disposableResourceStack, completion )
The abstract operation DisposeResources takes arguments disposableResourceStack (
- 令 needsAwait 为
false 。 - 令 hasAwaited 为
false 。 - 令 outputCompletion 为 completion。
- 对 disposableResourceStack 的每个元素 resource，按列表逆序执行
- 令 value 为 resource.[[ResourceValue]]。
- 令 kind 为 resource.[[Kind]]。
- 令 method 为 resource.[[DisposeMethod]]。
- 如果 kind 是
sync-dispose 、needsAwait 是true ，并且 hasAwaited 是false ，则- 执行 !
Await (undefined )。 - 将 needsAwait 设置为
false 。
- 执行 !
- 如果 method 不是
undefined ，则- 令 result 为
Completion (Call (method, value))。 - 如果 result 是
正常完成 且 kind 是async-dispose ，则- 将 result 设置为
Completion (Await (result.[[Value]]))。 - 将 hasAwaited 设置为
true 。
- 将 result 设置为
- 如果 result 是抛出完成，则
- 如果 outputCompletion 是抛出完成，则
- 将 result 设置为 result.[[Value]]。
- 令 suppressed 为 outputCompletion.[[Value]]。
- 令 error 为新创建的
SuppressedError 对象。 - 执行
CreateNonEnumerableDataPropertyOrThrow (error,"error" , result)。 - 执行
CreateNonEnumerableDataPropertyOrThrow (error,"suppressed" , suppressed)。 - 将 outputCompletion 设置为
ThrowCompletion (error)。
- 否则，
- 将 outputCompletion 设置为 result。
- 如果 outputCompletion 是抛出完成，则
- 令 result 为
- 否则，
- 断言：kind 是
async-dispose 。 - 将 needsAwait 设置为
true 。 - 注：这只能表示
await using声明的初始化值为null 或undefined 的情况。
- 断言：kind 是
- 如果 needsAwait 是
true 且 hasAwaited 是false ，则- 执行 !
Await (undefined )。
- 执行 !
- 注：此时 disposableResourceStack 将永远不会再被使用。在实现中可以丢弃 disposableResourceStack 的内容，例如通过垃圾回收。
- 返回 ? outputCompletion。
8 语法制导操作
除本节中定义的操作外，本规范各处还定义了专门的
8.1 Runtime Semantics: Evaluation
The syntax-directed operation Evaluation takes no arguments and returns a
8.2 作用域分析
8.2.1 Static Semantics: BoundNames
The syntax-directed operation BoundNames takes no arguments and returns a
It is defined piecewise over the following productions:
- 返回一个
List ，其唯一元素是Identifier 的StringValue 。
- 返回 «
"yield" »。
- 返回 «
"await" »。
- 返回
BindingList 的BoundNames 。
- 返回
BindingList 的BoundNames 。
- 令 names1 为
BindingList 的BoundNames 。 - 令 names2 为
LexicalBinding 的BoundNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回
BindingIdentifier 的BoundNames 。
- 返回
BindingPattern 的BoundNames 。
- 令 names1 为
VariableDeclarationList 的BoundNames 。 - 令 names2 为
VariableDeclaration 的BoundNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回
BindingIdentifier 的BoundNames 。
- 返回
BindingPattern 的BoundNames 。
- 返回一个新的空
List 。
- 令 names1 为
BindingPropertyList 的BoundNames 。 - 令 names2 为
BindingRestProperty 的BoundNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回一个新的空
List 。
- 返回
BindingRestElement 的BoundNames 。
- 返回
BindingElementList 的BoundNames 。
- 令 names1 为
BindingElementList 的BoundNames 。 - 令 names2 为
BindingRestElement 的BoundNames 。 - 返回 names1 和 names2 的
列表连接 。
- 令 names1 为
BindingPropertyList 的BoundNames 。 - 令 names2 为
BindingProperty 的BoundNames 。 - 返回 names1 和 names2 的
列表连接 。
- 令 names1 为
BindingElementList 的BoundNames 。 - 令 names2 为
BindingElisionElement 的BoundNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回
BindingElement 的BoundNames 。
- 返回
BindingElement 的BoundNames 。
- 返回
BindingIdentifier 的BoundNames 。
- 返回
BindingPattern 的BoundNames 。
- 返回
ForBinding 的BoundNames 。
- 返回
BindingIdentifier 的BoundNames 。
- 返回 «
"*default*" »。
- 返回一个新的空
List 。
- 令 names1 为
FormalParameterList 的BoundNames 。 - 令 names2 为
FunctionRestParameter 的BoundNames 。 - 返回 names1 和 names2 的
列表连接 。
- 令 names1 为
FormalParameterList 的BoundNames 。 - 令 names2 为
FormalParameter 的BoundNames 。 - 返回 names1 和 names2 的
列表连接 。
- 令 formals 为
CoverParenthesizedExpressionAndArrowParameterList 所覆盖的 ArrowFormalParameters 。 - 返回 formals 的
BoundNames 。
- 返回
BindingIdentifier 的BoundNames 。
- 返回 «
"*default*" »。
- 返回
BindingIdentifier 的BoundNames 。
- 返回 «
"*default*" »。
- 返回
BindingIdentifier 的BoundNames 。
- 返回 «
"*default*" »。
- 返回
BindingIdentifier 的BoundNames 。
- 返回 «
"*default*" »。
- 令 head 为
CoverCallExpressionAndAsyncArrowHead 所覆盖的 AsyncArrowHead 。 - 返回 head 的
BoundNames 。
- 返回
ImportClause 的BoundNames 。
- 返回一个新的空
List 。
- 令 names1 为
ImportedDefaultBinding 的BoundNames 。 - 令 names2 为
NameSpaceImport 的BoundNames 。 - 返回 names1 和 names2 的
列表连接 。
- 令 names1 为
ImportedDefaultBinding 的BoundNames 。 - 令 names2 为
NamedImports 的BoundNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回一个新的空
List 。
- 令 names1 为
ImportsList 的BoundNames 。 - 令 names2 为
ImportSpecifier 的BoundNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回
ImportedBinding 的BoundNames 。
- 返回一个新的空
List 。
- 返回
VariableStatement 的BoundNames 。
- 返回
Declaration 的BoundNames 。
- 令 declNames 为
HoistableDeclaration 的BoundNames 。 - 如果 declNames 不
包含 元素"*default*" ，则将"*default*" 追加到 declNames。 - 返回 declNames。
- 令 declNames 为
ClassDeclaration 的BoundNames 。 - 如果 declNames 不
包含 元素"*default*" ，则将"*default*" 追加到 declNames。 - 返回 declNames。
- 返回 «
"*default*" »。
8.2.2 Static Semantics: DeclarationPart
The syntax-directed operation DeclarationPart takes no arguments and returns a
- 返回
ClassDeclaration 。
8.2.3 Static Semantics: IsConstantDeclaration
The syntax-directed operation IsConstantDeclaration takes no arguments and returns a Boolean. It is defined piecewise over the following productions:
- 返回
false 。
- 返回
true 。
- 返回
true 。
- 返回
false 。
- 返回
false 。
- 返回
false 。
无需将 export default
8.2.4 Static Semantics: IsUsingDeclaration
The syntax-directed operation IsUsingDeclaration takes no arguments and returns Boolean. It is defined piecewise over the following productions:
- 返回
false 。
- 返回
true 。
- 返回
false 。
- 返回
true 。
- 返回
false 。
- 返回
false 。
8.2.5 Static Semantics: IsAwaitUsingDeclaration
The syntax-directed operation IsAwaitUsingDeclaration takes no arguments and returns Boolean. It is defined piecewise over the following productions:
- 返回
false 。
- 返回
false 。
- 返回
true 。
- 返回
false 。
- 返回
false 。
- 返回
true 。
- 返回
false 。
- 返回
false 。
8.2.6 Static Semantics: LexicallyDeclaredNames
The syntax-directed operation LexicallyDeclaredNames takes no arguments and returns a
- 返回一个新的空
List 。
- 令 names1 为
StatementList 的LexicallyDeclaredNames 。 - 令 names2 为
StatementListItem 的LexicallyDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 如果
Statement 是Statement : LabelledStatement LabelledStatement 的LexicallyDeclaredNames 。 - 返回一个新的空
List 。
- 返回
Declaration 的BoundNames 。
- 返回一个新的空
List 。
- 如果第一个
CaseClauses 存在，则令 names1 为第一个CaseClauses 的LexicallyDeclaredNames 。 - 否则，令 names1 为一个新的空
List 。 - 令 names2 为
DefaultClause 的LexicallyDeclaredNames 。 - 如果第二个
CaseClauses 存在，则令 names3 为第二个CaseClauses 的LexicallyDeclaredNames 。 - 否则，令 names3 为一个新的空
List 。 - 返回 names1、names2 和 names3 的
列表连接 。
- 令 names1 为
CaseClauses 的LexicallyDeclaredNames 。 - 令 names2 为
CaseClause 的LexicallyDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 如果
StatementList 存在，则返回StatementList 的LexicallyDeclaredNames 。 - 返回一个新的空
List 。
- 如果
StatementList 存在，则返回StatementList 的LexicallyDeclaredNames 。 - 返回一个新的空
List 。
- 返回一个新的空
List 。
- 返回一个新的空
List 。
- 返回一个新的空
List 。
- 返回一个新的空
List 。
- 返回一个新的空
List 。
- 返回一个新的空
List 。
在
- 令 names1 为
ModuleItemList 的LexicallyDeclaredNames 。 - 令 names2 为
ModuleItem 的LexicallyDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回
ImportDeclaration 的BoundNames 。
- 如果
ExportDeclaration 是exportVariableStatement ，则返回一个新的空List 。 - 返回
ExportDeclaration 的BoundNames 。
在
8.2.7 Static Semantics: LexicallyScopedDeclarations
The syntax-directed operation LexicallyScopedDeclarations takes no arguments and returns a
- 令 decls1 为
StatementList 的LexicallyScopedDeclarations 。 - 令 decls2 为
StatementListItem 的LexicallyScopedDeclarations 。 - 返回 decls1 和 decls2 的
列表连接 。
- 如果
Statement 是Statement : LabelledStatement LabelledStatement 的LexicallyScopedDeclarations 。 - 返回一个新的空
List 。
- 返回一个
List ，其唯一元素是Declaration 的DeclarationPart 。
- 返回一个新的空
List 。
- 如果第一个
CaseClauses 存在，则令 decls1 为第一个CaseClauses 的LexicallyScopedDeclarations 。 - 否则，令 decls1 为一个新的空
List 。 - 令 decls2 为
DefaultClause 的LexicallyScopedDeclarations 。 - 如果第二个
CaseClauses 存在，则令 decls3 为第二个CaseClauses 的LexicallyScopedDeclarations 。 - 否则，令 decls3 为一个新的空
List 。 - 返回 decls1、decls2 和 decls3 的
列表连接 。
- 令 decls1 为
CaseClauses 的LexicallyScopedDeclarations 。 - 令 decls2 为
CaseClause 的LexicallyScopedDeclarations 。 - 返回 decls1 和 decls2 的
列表连接 。
- 如果
StatementList 存在，则返回StatementList 的LexicallyScopedDeclarations 。 - 返回一个新的空
List 。
- 如果
StatementList 存在，则返回StatementList 的LexicallyScopedDeclarations 。 - 返回一个新的空
List 。
- 返回一个新的空
List 。
- 返回 «
FunctionDeclaration »。
- 返回一个新的空
List 。
- 返回一个新的空
List 。
- 返回一个新的空
List 。
- 返回一个新的空
List 。
- 返回一个新的空
List 。
- 返回一个新的空
List 。
- 令 decls1 为
ModuleItemList 的LexicallyScopedDeclarations 。 - 令 decls2 为
ModuleItem 的LexicallyScopedDeclarations 。 - 返回 decls1 和 decls2 的
列表连接 。
- 返回一个新的空
List 。
- 返回一个新的空
List 。
- 返回一个
List ，其唯一元素是Declaration 的DeclarationPart 。
- 返回一个
List ，其唯一元素是HoistableDeclaration 的DeclarationPart 。
- 返回一个
List ，其唯一元素是ClassDeclaration 。
- 返回一个
List ，其唯一元素是此ExportDeclaration 。
8.2.8 Static Semantics: VarDeclaredNames
The syntax-directed operation VarDeclaredNames takes no arguments and returns a
- 返回一个新的空
List 。
- 返回一个新的空
List 。
- 令 names1 为
StatementList 的VarDeclaredNames 。 - 令 names2 为
StatementListItem 的VarDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回一个新的空
List 。
- 令 names1 为第一个
Statement 的VarDeclaredNames 。 - 令 names2 为第二个
Statement 的VarDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回
Statement 的VarDeclaredNames 。
- 返回
Statement 的VarDeclaredNames 。
- 返回
Statement 的VarDeclaredNames 。
- 返回
Statement 的VarDeclaredNames 。
- 令 names1 为
VariableDeclarationList 的BoundNames 。 - 令 names2 为
Statement 的VarDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回
Statement 的VarDeclaredNames 。
- 返回
Statement 的VarDeclaredNames 。
- 令 names1 为
ForBinding 的BoundNames 。 - 令 names2 为
Statement 的VarDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
本节由附录
- 返回
Statement 的VarDeclaredNames 。
- 返回
CaseBlock 的VarDeclaredNames 。
- 返回一个新的空
List 。
- 如果第一个
CaseClauses 存在，则令 names1 为第一个CaseClauses 的VarDeclaredNames 。 - 否则，令 names1 为一个新的空
List 。 - 令 names2 为
DefaultClause 的VarDeclaredNames 。 - 如果第二个
CaseClauses 存在，则令 names3 为第二个CaseClauses 的VarDeclaredNames 。 - 否则，令 names3 为一个新的空
List 。 - 返回 names1、names2 和 names3 的
列表连接 。
- 令 names1 为
CaseClauses 的VarDeclaredNames 。 - 令 names2 为
CaseClause 的VarDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 如果
StatementList 存在，则返回StatementList 的VarDeclaredNames 。 - 返回一个新的空
List 。
- 如果
StatementList 存在，则返回StatementList 的VarDeclaredNames 。 - 返回一个新的空
List 。
- 返回
LabelledItem 的VarDeclaredNames 。
- 返回一个新的空
List 。
- 令 names1 为
Block 的VarDeclaredNames 。 - 令 names2 为
Catch 的VarDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 令 names1 为
Block 的VarDeclaredNames 。 - 令 names2 为
Finally 的VarDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 令 names1 为
Block 的VarDeclaredNames 。 - 令 names2 为
Catch 的VarDeclaredNames 。 - 令 names3 为
Finally 的VarDeclaredNames 。 - 返回 names1、names2 和 names3 的
列表连接 。
- 返回
Block 的VarDeclaredNames 。
- 返回一个新的空
List 。
- 返回一个新的空
List 。
- 返回一个新的空
List 。
- 返回一个新的空
List 。
- 返回一个新的空
List 。
- 令 names1 为
ModuleItemList 的VarDeclaredNames 。 - 令 names2 为
ModuleItem 的VarDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回一个新的空
List 。
- 如果
ExportDeclaration 是exportVariableStatement ，则返回ExportDeclaration 的BoundNames 。 - 返回一个新的空
List 。
8.2.9 Static Semantics: VarScopedDeclarations
The syntax-directed operation VarScopedDeclarations takes no arguments and returns a
- 返回一个新的空
List 。
- 返回一个新的空
List 。
- 令 decls1 为
StatementList 的VarScopedDeclarations 。 - 令 decls2 为
StatementListItem 的VarScopedDeclarations 。 - 返回 decls1 和 decls2 的
列表连接 。
- 返回一个新的空
List 。
- 返回 «
VariableDeclaration »。
- 令 decls1 为
VariableDeclarationList 的VarScopedDeclarations 。 - 返回 decls1 与 «
VariableDeclaration » 的列表连接 。
- 令 decls1 为第一个
Statement 的VarScopedDeclarations 。 - 令 decls2 为第二个
Statement 的VarScopedDeclarations 。 - 返回 decls1 和 decls2 的
列表连接 。
- 令 decls1 为
VariableDeclarationList 的VarScopedDeclarations 。 - 令 decls2 为
Statement 的VarScopedDeclarations 。 - 返回 decls1 和 decls2 的
列表连接 。
- 令 decls1 为 «
ForBinding »。 - 令 decls2 为
Statement 的VarScopedDeclarations 。 - 返回 decls1 和 decls2 的
列表连接 。
本节由附录
- 返回一个新的空
List 。
- 如果第一个
CaseClauses 存在，则令 decls1 为第一个CaseClauses 的VarScopedDeclarations 。 - 否则，令 decls1 为一个新的空
List 。 - 令 decls2 为
DefaultClause 的VarScopedDeclarations 。 - 如果第二个
CaseClauses 存在，则令 decls3 为第二个CaseClauses 的VarScopedDeclarations 。 - 否则，令 decls3 为一个新的空
List 。 - 返回 decls1、decls2 和 decls3 的
列表连接 。
- 令 decls1 为
CaseClauses 的VarScopedDeclarations 。 - 令 decls2 为
CaseClause 的VarScopedDeclarations 。 - 返回 decls1 和 decls2 的
列表连接 。
- 如果
StatementList 存在，则返回StatementList 的VarScopedDeclarations 。 - 返回一个新的空
List 。
- 如果
StatementList 存在，则返回StatementList 的VarScopedDeclarations 。 - 返回一个新的空
List 。
- 返回一个新的空
List 。
- 令 decls1 为
Block 的VarScopedDeclarations 。 - 令 decls2 为
Catch 的VarScopedDeclarations 。 - 返回 decls1 和 decls2 的
列表连接 。
- 令 decls1 为
Block 的VarScopedDeclarations 。 - 令 decls2 为
Finally 的VarScopedDeclarations 。 - 返回 decls1 和 decls2 的
列表连接 。
- 令 decls1 为
Block 的VarScopedDeclarations 。 - 令 decls2 为
Catch 的VarScopedDeclarations 。 - 令 decls3 为
Finally 的VarScopedDeclarations 。 - 返回 decls1、decls2 和 decls3 的
列表连接 。
- 返回
Block 的VarScopedDeclarations 。
- 返回一个新的空
List 。
- 返回一个新的空
List 。
- 返回一个新的空
List 。
- 返回一个新的空
List 。
- 返回一个新的空
List 。
- 返回一个新的空
List 。
- 令 decls1 为
ModuleItemList 的VarScopedDeclarations 。 - 令 decls2 为
ModuleItem 的VarScopedDeclarations 。 - 返回 decls1 和 decls2 的
列表连接 。
- 返回一个新的空
List 。
- 如果
ExportDeclaration 是exportVariableStatement ，则返回VariableStatement 的VarScopedDeclarations 。 - 返回一个新的空
List 。
8.2.10 Static Semantics: TopLevelLexicallyDeclaredNames
The syntax-directed operation TopLevelLexicallyDeclaredNames takes no arguments and returns a
- 令 names1 为
StatementList 的TopLevelLexicallyDeclaredNames 。 - 令 names2 为
StatementListItem 的TopLevelLexicallyDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回一个新的空
List 。
- 如果
Declaration 是Declaration : HoistableDeclaration - 返回一个新的空
List 。
- 返回一个新的空
- 返回
Declaration 的BoundNames 。
在函数或脚本的顶层，函数声明会被像 var 声明一样处理，而不是像词法声明一样处理。
8.2.11 Static Semantics: TopLevelLexicallyScopedDeclarations
The syntax-directed operation TopLevelLexicallyScopedDeclarations takes no arguments and returns a
- 令 decls1 为
StatementList 的TopLevelLexicallyScopedDeclarations 。 - 令 decls2 为
StatementListItem 的TopLevelLexicallyScopedDeclarations 。 - 返回 decls1 和 decls2 的
列表连接 。
- 返回一个新的空
List 。
- 如果
Declaration 是Declaration : HoistableDeclaration - 返回一个新的空
List 。
- 返回一个新的空
- 返回 «
Declaration »。
8.2.12 Static Semantics: TopLevelVarDeclaredNames
The syntax-directed operation TopLevelVarDeclaredNames takes no arguments and returns a
- 令 names1 为
StatementList 的TopLevelVarDeclaredNames 。 - 令 names2 为
StatementListItem 的TopLevelVarDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 如果
Declaration 是Declaration : HoistableDeclaration - 返回一个新的空
List 。
- 如果
Statement 是Statement : LabelledStatement Statement 的TopLevelVarDeclaredNames 。 - 返回
Statement 的VarDeclaredNames 。
在函数或脚本的顶层，内部函数声明会被像 var 声明一样处理。
- 如果
Statement 是Statement : LabelledStatement Statement 的TopLevelVarDeclaredNames 。 - 返回
Statement 的VarDeclaredNames 。
8.2.13 Static Semantics: TopLevelVarScopedDeclarations
The syntax-directed operation TopLevelVarScopedDeclarations takes no arguments and returns a
- 令 decls1 为
StatementList 的TopLevelVarScopedDeclarations 。 - 令 decls2 为
StatementListItem 的TopLevelVarScopedDeclarations 。 - 返回 decls1 和 decls2 的
列表连接 。
- 如果
Statement 是Statement : LabelledStatement Statement 的TopLevelVarScopedDeclarations 。 - 返回
Statement 的VarScopedDeclarations 。
- 如果
Declaration 是Declaration : HoistableDeclaration - 令 decl 为
HoistableDeclaration 的DeclarationPart 。 - 返回 « decl »。
- 令 decl 为
- 返回一个新的空
List 。
- 如果
Statement 是Statement : LabelledStatement Statement 的TopLevelVarScopedDeclarations 。 - 返回
Statement 的VarScopedDeclarations 。
- 返回 «
FunctionDeclaration »。
8.3 标签
8.3.1 Static Semantics: ContainsDuplicateLabels
The syntax-directed operation ContainsDuplicateLabels takes argument labelSet (a
- 返回
false 。
- 令 hasDuplicates 为
StatementList 带实参 labelSet 的ContainsDuplicateLabels 。 - 如果 hasDuplicates 是
true ，则返回true 。 - 返回
StatementListItem 带实参 labelSet 的ContainsDuplicateLabels 。
- 令 hasDuplicate 为第一个
Statement 带实参 labelSet 的ContainsDuplicateLabels 。 - 如果 hasDuplicate 是
true ，则返回true 。 - 返回第二个
Statement 带实参 labelSet 的ContainsDuplicateLabels 。
- 返回
Statement 带实参 labelSet 的ContainsDuplicateLabels 。
- 返回
Statement 带实参 labelSet 的ContainsDuplicateLabels 。
- 返回
Statement 带实参 labelSet 的ContainsDuplicateLabels 。
- 返回
Statement 带实参 labelSet 的ContainsDuplicateLabels 。
- 返回
Statement 带实参 labelSet 的ContainsDuplicateLabels 。
本节由附录
- 返回
Statement 带实参 labelSet 的ContainsDuplicateLabels 。
- 返回
CaseBlock 带实参 labelSet 的ContainsDuplicateLabels 。
- 返回
false 。
- 如果第一个
CaseClauses 存在，则- 如果第一个
CaseClauses 带实参 labelSet 的ContainsDuplicateLabels 是true ，则返回true 。
- 如果第一个
- 如果
DefaultClause 带实参 labelSet 的ContainsDuplicateLabels 是true ，则返回true 。 - 如果第二个
CaseClauses 不存在，则返回false 。 - 返回第二个
CaseClauses 带实参 labelSet 的ContainsDuplicateLabels 。
- 令 hasDuplicates 为
CaseClauses 带实参 labelSet 的ContainsDuplicateLabels 。 - 如果 hasDuplicates 是
true ，则返回true 。 - 返回
CaseClause 带实参 labelSet 的ContainsDuplicateLabels 。
- 如果
StatementList 存在，则返回StatementList 带实参 labelSet 的ContainsDuplicateLabels 。 - 返回
false 。
- 如果
StatementList 存在，则返回StatementList 带实参 labelSet 的ContainsDuplicateLabels 。 - 返回
false 。
- 令 label 为
LabelIdentifier 的StringValue 。 - 如果 labelSet
包含 label，则返回true 。 - 令 newLabelSet 为 labelSet 与 « label » 的
列表连接 。 - 返回
LabelledItem 带实参 newLabelSet 的ContainsDuplicateLabels 。
- 返回
false 。
- 令 hasDuplicates 为
Block 带实参 labelSet 的ContainsDuplicateLabels 。 - 如果 hasDuplicates 是
true ，则返回true 。 - 返回
Catch 带实参 labelSet 的ContainsDuplicateLabels 。
- 令 hasDuplicates 为
Block 带实参 labelSet 的ContainsDuplicateLabels 。 - 如果 hasDuplicates 是
true ，则返回true 。 - 返回
Finally 带实参 labelSet 的ContainsDuplicateLabels 。
- 如果
Block 带实参 labelSet 的ContainsDuplicateLabels 是true ，则返回true 。 - 如果
Catch 带实参 labelSet 的ContainsDuplicateLabels 是true ，则返回true 。 - 返回
Finally 带实参 labelSet 的ContainsDuplicateLabels 。
- 返回
Block 带实参 labelSet 的ContainsDuplicateLabels 。
- 返回
false 。
- 返回
false 。
- 令 hasDuplicates 为
ModuleItemList 带实参 labelSet 的ContainsDuplicateLabels 。 - 如果 hasDuplicates 是
true ，则返回true 。 - 返回
ModuleItem 带实参 labelSet 的ContainsDuplicateLabels 。
- 返回
false 。
8.3.2 Static Semantics: ContainsUndefinedBreakTarget
The syntax-directed operation ContainsUndefinedBreakTarget takes argument labelSet (a
- 返回
false 。
- 令 hasUndefinedLabels 为
StatementList 带实参 labelSet 的ContainsUndefinedBreakTarget 。 - 如果 hasUndefinedLabels 是
true ，则返回true 。 - 返回
StatementListItem 带实参 labelSet 的ContainsUndefinedBreakTarget 。
- 令 hasUndefinedLabels 为第一个
Statement 带实参 labelSet 的ContainsUndefinedBreakTarget 。 - 如果 hasUndefinedLabels 是
true ，则返回true 。 - 返回第二个
Statement 带实参 labelSet 的ContainsUndefinedBreakTarget 。
- 返回
Statement 带实参 labelSet 的ContainsUndefinedBreakTarget 。
- 返回
Statement 带实参 labelSet 的ContainsUndefinedBreakTarget 。
- 返回
Statement 带实参 labelSet 的ContainsUndefinedBreakTarget 。
- 返回
Statement 带实参 labelSet 的ContainsUndefinedBreakTarget 。
- 返回
Statement 带实参 labelSet 的ContainsUndefinedBreakTarget 。
本节由附录
- 返回
false 。
- 如果 labelSet
包含 LabelIdentifier 的StringValue ，则返回false 。 - 返回
true 。
- 返回
Statement 带实参 labelSet 的ContainsUndefinedBreakTarget 。
- 返回
CaseBlock 带实参 labelSet 的ContainsUndefinedBreakTarget 。
- 返回
false 。
- 如果第一个
CaseClauses 存在，则- 如果第一个
CaseClauses 带实参 labelSet 的ContainsUndefinedBreakTarget 是true ，则返回true 。
- 如果第一个
- 如果
DefaultClause 带实参 labelSet 的ContainsUndefinedBreakTarget 是true ，则返回true 。 - 如果第二个
CaseClauses 不存在，则返回false 。 - 返回第二个
CaseClauses 带实参 labelSet 的ContainsUndefinedBreakTarget 。
- 令 hasUndefinedLabels 为
CaseClauses 带实参 labelSet 的ContainsUndefinedBreakTarget 。 - 如果 hasUndefinedLabels 是
true ，则返回true 。 - 返回
CaseClause 带实参 labelSet 的ContainsUndefinedBreakTarget 。
- 如果
StatementList 存在，则返回StatementList 带实参 labelSet 的ContainsUndefinedBreakTarget 。 - 返回
false 。
- 如果
StatementList 存在，则返回StatementList 带实参 labelSet 的ContainsUndefinedBreakTarget 。 - 返回
false 。
- 令 label 为
LabelIdentifier 的StringValue 。 - 令 newLabelSet 为 labelSet 与 « label » 的
列表连接 。 - 返回
LabelledItem 带实参 newLabelSet 的ContainsUndefinedBreakTarget 。
- 返回
false 。
- 令 hasUndefinedLabels 为
Block 带实参 labelSet 的ContainsUndefinedBreakTarget 。 - 如果 hasUndefinedLabels 是
true ，则返回true 。 - 返回
Catch 带实参 labelSet 的ContainsUndefinedBreakTarget 。
- 令 hasUndefinedLabels 为
Block 带实参 labelSet 的ContainsUndefinedBreakTarget 。 - 如果 hasUndefinedLabels 是
true ，则返回true 。 - 返回
Finally 带实参 labelSet 的ContainsUndefinedBreakTarget 。
- 如果
Block 带实参 labelSet 的ContainsUndefinedBreakTarget 是true ，则返回true 。 - 如果
Catch 带实参 labelSet 的ContainsUndefinedBreakTarget 是true ，则返回true 。 - 返回
Finally 带实参 labelSet 的ContainsUndefinedBreakTarget 。
- 返回
Block 带实参 labelSet 的ContainsUndefinedBreakTarget 。
- 返回
false 。
- 返回
false 。
- 令 hasUndefinedLabels 为
ModuleItemList 带实参 labelSet 的ContainsUndefinedBreakTarget 。 - 如果 hasUndefinedLabels 是
true ，则返回true 。 - 返回
ModuleItem 带实参 labelSet 的ContainsUndefinedBreakTarget 。
- 返回
false 。
8.3.3 Static Semantics: ContainsUndefinedContinueTarget
The syntax-directed operation ContainsUndefinedContinueTarget takes arguments iterationSet (a
- 返回
false 。
- 返回
BlockStatement 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。
- 令 newIterationSet 为 iterationSet 和 labelSet 的
列表连接 。 - 返回
IterationStatement 带实参 newIterationSet 和 « » 的ContainsUndefinedContinueTarget 。
- 令 hasUndefinedLabels 为
StatementList 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。 - 如果 hasUndefinedLabels 是
true ，则返回true 。 - 返回
StatementListItem 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。
- 令 hasUndefinedLabels 为第一个
Statement 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。 - 如果 hasUndefinedLabels 是
true ，则返回true 。 - 返回第二个
Statement 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。
- 返回
Statement 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。
- 返回
Statement 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。
- 返回
Statement 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。
- 返回
Statement 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。
- 返回
Statement 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。
本节由附录
- 返回
false 。
- 如果 iterationSet
包含 LabelIdentifier 的StringValue ，则返回false 。 - 返回
true 。
- 返回
Statement 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。
- 返回
CaseBlock 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。
- 返回
false 。
- 如果第一个
CaseClauses 存在，则- 如果第一个
CaseClauses 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 是true ，则返回true 。
- 如果第一个
- 如果
DefaultClause 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 是true ，则返回true 。 - 如果第二个
CaseClauses 不存在，则返回false 。 - 返回第二个
CaseClauses 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。
- 令 hasUndefinedLabels 为
CaseClauses 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。 - 如果 hasUndefinedLabels 是
true ，则返回true 。 - 返回
CaseClause 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。
- 如果
StatementList 存在，则返回StatementList 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。 - 返回
false 。
- 如果
StatementList 存在，则返回StatementList 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。 - 返回
false 。
- 令 label 为
LabelIdentifier 的StringValue 。 - 令 newLabelSet 为 labelSet 与 « label » 的
列表连接 。 - 返回
LabelledItem 带实参 iterationSet 和 newLabelSet 的ContainsUndefinedContinueTarget 。
- 返回
false 。
- 令 hasUndefinedLabels 为
Block 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。 - 如果 hasUndefinedLabels 是
true ，则返回true 。 - 返回
Catch 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。
- 令 hasUndefinedLabels 为
Block 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。 - 如果 hasUndefinedLabels 是
true ，则返回true 。 - 返回
Finally 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。
- 如果
Block 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 是true ，则返回true 。 - 如果
Catch 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 是true ，则返回true 。 - 返回
Finally 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。
- 返回
Block 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。
- 返回
false 。
- 返回
false 。
- 令 hasUndefinedLabels 为
ModuleItemList 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。 - 如果 hasUndefinedLabels 是
true ，则返回true 。 - 返回
ModuleItem 带实参 iterationSet 和 « » 的ContainsUndefinedContinueTarget 。
- 返回
false 。
8.4 函数名称推断
8.4.1 Static Semantics: HasName
The syntax-directed operation HasName takes no arguments and returns a Boolean. It is defined piecewise over the following productions:
- 令 expr 为
CoverParenthesizedExpressionAndArrowParameterList 所覆盖的 ParenthesizedExpression 。 - 如果 expr 的
IsFunctionDefinition 是false ，则返回false 。 - 返回 expr 的
HasName 。
- 返回
false 。
- 返回
true 。
8.4.2 Static Semantics: IsFunctionDefinition
The syntax-directed operation IsFunctionDefinition takes no arguments and returns a Boolean. It is defined piecewise over the following productions:
- 令 expr 为
CoverParenthesizedExpressionAndArrowParameterList 所覆盖的 ParenthesizedExpression 。 - 返回 expr 的
IsFunctionDefinition 。
- 返回
false 。
- 返回
true 。
8.4.3 Static Semantics: IsAnonymousFunctionDefinition ( expr )
The abstract operation IsAnonymousFunctionDefinition takes argument expr (an
- 如果 expr 的
IsFunctionDefinition 是false ，则返回false 。 - 令 hasName 为 expr 的
HasName 。 - 如果 hasName 是
true ，则返回false 。 - 返回
true 。
8.4.4 Static Semantics: IsIdentifierRef
The syntax-directed operation IsIdentifierRef takes no arguments and returns a Boolean. It is defined piecewise over the following productions:
- 返回
true 。
- 返回
false 。
8.4.5 Runtime Semantics: NamedEvaluation
The syntax-directed operation NamedEvaluation takes argument name (a property key or a
- 令 expr 为
CoverParenthesizedExpressionAndArrowParameterList 所覆盖的 ParenthesizedExpression 。 - 返回 ? expr 带实参 name 的
NamedEvaluation 。
- 断言：
IsAnonymousFunctionDefinition (Expression ) 是true 。 - 返回 ?
Expression 带实参 name 的NamedEvaluation 。
- 返回
FunctionExpression 带实参 name 的InstantiateOrdinaryFunctionExpression 。
- 返回
GeneratorExpression 带实参 name 的InstantiateGeneratorFunctionExpression 。
- 返回
AsyncFunctionExpression 带实参 name 的InstantiateAsyncFunctionExpression 。
- 返回
ArrowFunction 带实参 name 的InstantiateArrowFunctionExpression 。
- 返回
AsyncArrowFunction 带实参 name 的InstantiateAsyncArrowFunctionExpression 。
- 令 sourceText 为
ClassExpression 所匹配的源文本 。 - 返回 ?
ClassTail 带实参undefined 、name 和 sourceText 的ClassDefinitionEvaluation 。
8.5 Contains
8.5.1 Static Semantics: Contains
The syntax-directed operation Contains takes argument symbol (a grammar symbol) and returns a Boolean.
本规范中未在下方列出的每个文法产生式替代项，都隐式具有以下 Contains 的默认定义：
- 对此
Parse Node 的每个子节点 child，执行：- 如果 child 是 symbol 的实例，则返回
true 。 - 如果 child 是非终结符的实例，则
- 令 contained 为 child
Contains symbol 的结果。 - 如果 contained 是
true ，则返回true 。
- 令 contained 为 child
- 如果 child 是 symbol 的实例，则返回
- 返回
false 。
- 返回
false 。
依赖子结构的
- 如果 symbol 是
ClassBody ，则返回true 。 - 如果 symbol 是
ClassHeritage ，则- 如果
ClassHeritage 存在，则返回true 。 - 返回
false 。
- 如果
- 如果
ClassHeritage 存在，则- 如果
ClassHeritage Contains symbol 是true ，则返回true 。
- 如果
- 返回
ClassBody 带实参 symbol 的ComputedPropertyContains 的结果。
依赖子结构的
- 返回
false 。
依赖子结构的static 初始化块内部。
- 如果 symbol 不是
NewTarget 、SuperProperty 、SuperCall 、super或this之一，则返回false 。 - 如果
ArrowParameters Contains symbol 是true ，则返回true 。 - 返回
ConciseBody Contains symbol。
- 令 formals 为
CoverParenthesizedExpressionAndArrowParameterList 所覆盖的 ArrowFormalParameters 。 - 返回 formals
Contains symbol。
- 如果 symbol 不是
NewTarget 、SuperProperty 、SuperCall 、super或this之一，则返回false 。 - 返回
AsyncConciseBody Contains symbol。
- 如果 symbol 不是
NewTarget 、SuperProperty 、SuperCall 、super或this之一，则返回false 。 - 令 head 为
CoverCallExpressionAndAsyncArrowHead 所覆盖的 AsyncArrowHead 。 - 如果 head
Contains symbol 是true ，则返回true 。 - 返回
AsyncConciseBody Contains symbol。
Contains 用于检测 new.target、this 和 super 用法。
- 如果 symbol 是
MethodDefinition ，则返回true 。 - 返回
MethodDefinition 带实参 symbol 的ComputedPropertyContains 的结果。
- 返回
false 。
- 如果
MemberExpression Contains symbol 是true ，则返回true 。 - 返回
false 。
- 如果 symbol 是
ReservedWord super，则返回true 。 - 返回
false 。
- 如果
CallExpression Contains symbol 是true ，则返回true 。 - 返回
false 。
- 返回
false 。
- 如果
OptionalChain Contains symbol 是true ，则返回true 。 - 返回
false 。
8.5.2 Static Semantics: ComputedPropertyContains
The syntax-directed operation ComputedPropertyContains takes argument symbol (a grammar symbol) and returns a Boolean. It is defined piecewise over the following productions:
- 返回
false 。
- 返回
ComputedPropertyName Contains symbol 的结果。
- 返回
ClassElementName 带实参 symbol 的ComputedPropertyContains 的结果。
- 返回
ClassElementName 带实参 symbol 的ComputedPropertyContains 的结果。
- 返回
ClassElementName 带实参 symbol 的ComputedPropertyContains 的结果。
- 令 inList 为
ClassElementList 带实参 symbol 的ComputedPropertyContains 。 - 如果 inList 是
true ，则返回true 。 - 返回
ClassElement 带实参 symbol 的ComputedPropertyContains 的结果。
- 返回
false 。
- 返回
false 。
- 返回
ClassElementName 带实参 symbol 的ComputedPropertyContains 的结果。
- 返回
ClassElementName 带实参 symbol 的ComputedPropertyContains 的结果。
8.6 杂项
这些操作在整个规范的多个地方使用。
8.6.1 Runtime Semantics: InstantiateFunctionObject
The syntax-directed operation InstantiateFunctionObject takes arguments envRecord (an
- 返回
FunctionDeclaration 带实参 envRecord 和 privateEnv 的InstantiateOrdinaryFunctionObject 。
- 返回
GeneratorDeclaration 带实参 envRecord 和 privateEnv 的InstantiateGeneratorFunctionObject 。
- 返回
AsyncGeneratorDeclaration 带实参 envRecord 和 privateEnv 的InstantiateAsyncGeneratorFunctionObject 。
- 返回
AsyncFunctionDeclaration 带实参 envRecord 和 privateEnv 的InstantiateAsyncFunctionObject 。
8.6.2 Runtime Semantics: BindingInitialization
The syntax-directed operation BindingInitialization takes arguments value (an ECMAScript language value) and envRecord (an
It is defined piecewise over the following productions:
- 令 name 为
Identifier 的StringValue 。 - 返回 ?
InitializeBoundName (name, value, envRecord)。
- 返回 ?
InitializeBoundName ("yield" , value, envRecord)。
- 返回 ?
InitializeBoundName ("await" , value, envRecord)。
- 执行 ?
RequireObjectCoercible (value)。 - 返回 ?
ObjectBindingPattern 带实参 value 和 envRecord 的BindingInitialization 。
- 令 iteratorRecord 为 ?
GetIterator (value,sync )。 - 令 result 为
Completion (ArrayBindingPattern 带实参 iteratorRecord 和 envRecord 的IteratorBindingInitialization )。 - 如果 iteratorRecord.[[Done]] 是
false ，则返回 ?IteratorClose (iteratorRecord, result)。 - 返回 ? result。
- 返回
unused 。
- 执行 ?
BindingPropertyList 带实参 value 和 envRecord 的PropertyBindingInitialization 。 - 返回
unused 。
- 令 excludedNames 为新的空
List 。 - 返回 ?
BindingRestProperty 带实参 value、envRecord 和 excludedNames 的RestBindingInitialization 。
- 令 excludedNames 为 ?
BindingPropertyList 带实参 value 和 envRecord 的PropertyBindingInitialization 。 - 返回 ?
BindingRestProperty 带实参 value、envRecord 和 excludedNames 的RestBindingInitialization 。
8.6.2.1 InitializeBoundName ( name, value, envRecord )
The abstract operation InitializeBoundName takes arguments name (a String), value (an ECMAScript language value), and envRecord (an
- 如果 envRecord 不是
undefined ，则- 执行 ! envRecord.
InitializeBinding (name, value)。 - 返回
unused 。
- 执行 ! envRecord.
- 令 lhs 为 ?
ResolveBinding (name)。 - 返回 ?
PutValue (lhs, value)。
8.6.3 Runtime Semantics: IteratorBindingInitialization
The syntax-directed operation IteratorBindingInitialization takes arguments iteratorRecord (an
It is defined piecewise over the following productions:
- 返回
unused 。
- 返回 ?
Elision 带实参 iteratorRecord 的IteratorDestructuringAssignmentEvaluation 。
- 如果
Elision 存在，则- 执行 ?
Elision 带实参 iteratorRecord 的IteratorDestructuringAssignmentEvaluation 。
- 执行 ?
- 返回 ?
BindingRestElement 带实参 iteratorRecord 和 envRecord 的IteratorBindingInitialization 。
- 执行 ?
BindingElementList 带实参 iteratorRecord 和 envRecord 的IteratorBindingInitialization 。 - 返回 ?
Elision 带实参 iteratorRecord 的IteratorDestructuringAssignmentEvaluation 。
- 执行 ?
BindingElementList 带实参 iteratorRecord 和 envRecord 的IteratorBindingInitialization 。 - 如果
Elision 存在，则- 执行 ?
Elision 带实参 iteratorRecord 的IteratorDestructuringAssignmentEvaluation 。
- 执行 ?
- 返回 ?
BindingRestElement 带实参 iteratorRecord 和 envRecord 的IteratorBindingInitialization 。
- 执行 ?
BindingElementList 带实参 iteratorRecord 和 envRecord 的IteratorBindingInitialization 。 - 返回 ?
BindingElisionElement 带实参 iteratorRecord 和 envRecord 的IteratorBindingInitialization 。
- 执行 ?
Elision 带实参 iteratorRecord 的IteratorDestructuringAssignmentEvaluation 。 - 返回 ?
BindingElement 带实参 iteratorRecord 和 envRecord 的IteratorBindingInitialization 。
- 令 bindingId 为
BindingIdentifier 的StringValue 。 - 令 lhs 为 ?
ResolveBinding (bindingId, envRecord)。 - 令 v 为
undefined 。 - 如果 iteratorRecord.[[Done]] 是
false ，则- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 不是
done ，则- 将 v 设置为 next。
- 令 next 为 ?
- 如果
Initializer 存在且 v 是undefined ，则- 如果
IsAnonymousFunctionDefinition (Initializer ) 是true ，则- 将 v 设置为 ?
Initializer 带实参 bindingId 的NamedEvaluation 。
- 将 v 设置为 ?
- 否则，
- 令 defaultValue 为 ?
Initializer 的Evaluation 。 - 将 v 设置为 ?
GetValue (defaultValue)。
- 令 defaultValue 为 ?
- 如果
- 如果 envRecord 是
undefined ，则返回 ?PutValue (lhs, v)。 - 返回 ?
InitializeReferencedBinding (lhs, v)。
- 令 v 为
undefined 。 - 如果 iteratorRecord.[[Done]] 是
false ，则- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 不是
done ，则- 将 v 设置为 next。
- 令 next 为 ?
- 如果
Initializer 存在且 v 是undefined ，则- 令 defaultValue 为 ?
Initializer 的Evaluation 。 - 将 v 设置为 ?
GetValue (defaultValue)。
- 令 defaultValue 为 ?
- 返回 ?
BindingPattern 带实参 v 和 envRecord 的BindingInitialization 。
- 令 lhs 为 ?
ResolveBinding (BindingIdentifier 的StringValue , envRecord)。 - 令 array 为 !
ArrayCreate (0)。 - 令 n 为 0。
- 重复，
- 令 next 为
done 。 - 如果 iteratorRecord.[[Done]] 是
false ，则- 将 next 设置为 ?
IteratorStepValue (iteratorRecord)。
- 将 next 设置为 ?
- 如果 next 是
done ，则- 如果 envRecord 是
undefined ，则返回 ?PutValue (lhs, array)。 - 返回 ?
InitializeReferencedBinding (lhs, array)。
- 如果 envRecord 是
- 执行 !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (n)), next)。 - 将 n 设置为 n + 1。
- 令 next 为
- 令 array 为 !
ArrayCreate (0)。 - 令 n 为 0。
- 重复，
- 令 next 为
done 。 - 如果 iteratorRecord.[[Done]] 是
false ，则- 将 next 设置为 ?
IteratorStepValue (iteratorRecord)。
- 将 next 设置为 ?
- 如果 next 是
done ，则- 返回 ?
BindingPattern 带实参 array 和 envRecord 的BindingInitialization 。
- 返回 ?
- 执行 !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (n)), next)。 - 将 n 设置为 n + 1。
- 令 next 为
- 返回
unused 。
- 执行 ?
FormalParameterList 带实参 iteratorRecord 和 envRecord 的IteratorBindingInitialization 。 - 返回 ?
FunctionRestParameter 带实参 iteratorRecord 和 envRecord 的IteratorBindingInitialization 。
- 执行 ?
FormalParameterList 带实参 iteratorRecord 和 envRecord 的IteratorBindingInitialization 。 - 返回 ?
FormalParameter 带实参 iteratorRecord 和 envRecord 的IteratorBindingInitialization 。
- 令 v 为
undefined 。 - 断言：iteratorRecord.[[Done]] 是
false 。 - 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 不是
done ，则- 将 v 设置为 next。
- 返回 ?
BindingIdentifier 带实参 v 和 envRecord 的BindingInitialization 。
- 令 formals 为
CoverParenthesizedExpressionAndArrowParameterList 所覆盖的 ArrowFormalParameters 。 - 返回 ? formals 带实参 iteratorRecord 和 envRecord 的
IteratorBindingInitialization 。
- 令 v 为
undefined 。 - 断言：iteratorRecord.[[Done]] 是
false 。 - 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 不是
done ，则- 将 v 设置为 next。
- 返回 ?
BindingIdentifier 带实参 v 和 envRecord 的BindingInitialization 。
8.6.4 Static Semantics: AssignmentTargetType
The syntax-directed operation AssignmentTargetType takes no arguments and returns
- 如果
IsStrict (thisIdentifierReference ) 是true 且Identifier 的StringValue 是"eval" 或"arguments" ，则返回invalid 。 - 返回
simple 。
- 返回
simple 。
- 令 expr 为
CoverParenthesizedExpressionAndArrowParameterList 所覆盖的 ParenthesizedExpression 。 - 返回 expr 的
AssignmentTargetType 。
- 如果
宿主 是 Web 浏览器，或以其他方式支持函数调用赋值目标的运行时错误 ，且IsStrict (thisCallExpression ) 是false ，则- 返回
web-compat 。
- 返回
- 返回
invalid 。
- 返回
invalid 。
8.6.5 Static Semantics: PropName
The syntax-directed operation PropName takes no arguments and returns a String or
- 返回
empty 。
- 返回
PropertyName 的PropName 。
- 返回
IdentifierName 的StringValue 。
- 返回
StringLiteral 的SV 。
- 令 number 为
NumericLiteral 的NumericValue 。 - 返回 !
ToString (number)。
- 返回
empty 。
- 返回
ClassElementName 的PropName 。
- 返回
ClassElementName 的PropName 。
- 返回
ClassElementName 的PropName 。
- 返回
empty 。
- 返回
empty 。
- 返回
ClassElementName 的PropName 。
- 返回
ClassElementName 的PropName 。
- 返回
empty 。
8.6.6 Static Semantics: ContainsUsing
The syntax-directed operation ContainsUsing takes no arguments and returns Boolean. It is defined piecewise over the following productions:
- 如果派生的
StatementList 的ContainsUsing 是true ，则返回true 。 - 如果
StatementListItem 的ContainsUsing 是true ，则返回true 。 - 返回
false 。
- 返回
false 。
- 如果
Declaration 的IsUsingDeclaration 是true ，则返回true 。 - 如果
Declaration 的IsAwaitUsingDeclaration 是true ，则返回true 。 - 返回
false 。
9 可执行代码与执行上下文
9.1 环境记录
Environment Record 是一种规范类型，用于基于 ECMAScript 代码的词法嵌套结构，定义
每个 Environment Record 都有一个 [[OuterEnv]] 字段，它要么是
Environment Records 纯粹是规范机制，并不需要对应于 ECMAScript 实现中的任何特定工件。ECMAScript 程序不可能直接访问或操纵这类值。
9.1.1 Environment Record 类型层级结构
-
-
Declarative Environment Record 用于定义 ECMAScript 语言句法元素的效果，例如FunctionDeclaration 、VariableDeclaration 和Catch 子句，它们将标识符绑定直接关联到ECMAScript 语言值 。-
Function Environment Record 对应于 ECMAScript函数对象 的调用，并包含 该函数内顶层声明的绑定。它可以建立一个新的this绑定。它还捕获支持super方法调用所需的状态。 -
Module Environment Record 包含 Module 顶层声明的绑定。它还包含 由该Module 显式导入的绑定。其 [[OuterEnv]] 是一个Global Environment Record 。
-
-
Object Environment Record 用于定义 ECMAScript 元素（例如WithStatement ）的效果，这些元素将标识符绑定关联到某个对象的属性。 -
Global Environment Record 用于Script 全局声明。它没有外层环境；其 [[OuterEnv]] 是null 。它可以预先填充标识符绑定，并包含 一个关联的全局对象 ，该对象的属性提供全局环境的一些标识符绑定。随着 ECMAScript 代码的执行，可以向全局对象 添加额外属性，并且初始属性可以被修改。
-
| 方法 | 目的 | 定义 |
|---|---|---|
| HasBinding ( name ) | The abstract method HasBinding takes argument name (a String) and returns either a normal completion containing a Boolean or a throw completion. 它确定 |
它在以下类型中有具体定义：
|
| CreateMutableBinding ( name, deletable ) | The abstract method CreateMutableBinding takes arguments name (a String) and deletable (a Boolean) and returns either a normal completion containing |
它在以下类型中有具体定义：
|
| CreateImmutableBinding ( name, strict ) | The abstract method CreateImmutableBinding takes arguments name (a String) and strict (a Boolean) and returns either a normal completion containing |
它在以下类型中有具体定义：
|
| InitializeBinding ( name, value ) | The abstract method InitializeBinding takes arguments name (a String) and value (an ECMAScript language value) and returns either a normal completion containing |
它在以下类型中有具体定义：
|
| SetMutableBinding ( name, value, strict ) | The abstract method SetMutableBinding takes arguments name (a String), value (an ECMAScript language value), and strict (a Boolean) and returns either a normal completion containing |
它在以下类型中有具体定义：
|
| GetBindingValue ( name, strict ) | The abstract method GetBindingValue takes arguments name (a String) and strict (a Boolean) and returns either a normal completion containing an ECMAScript language value or a throw completion. 它从 |
它在以下类型中有具体定义：
|
| DeleteBinding ( name ) | The abstract method DeleteBinding takes argument name (a String) and returns either a normal completion containing a Boolean or a throw completion. 它从 |
它在以下类型中有具体定义：
|
| HasThisBinding ( ) | The abstract method HasThisBinding takes no arguments and returns a Boolean. 它确定this 绑定。如果它建立了则返回 |
它在以下类型中有具体定义：
|
| GetThisBinding ( ) | The abstract method GetThisBinding takes no arguments and returns either a normal completion containing an ECMAScript language value or a throw completion. 它返回此this 绑定的值。如果 this 绑定尚未初始化，则抛出 |
它在以下类型中有具体定义：
|
| HasSuperBinding ( ) | The abstract method HasSuperBinding takes no arguments and returns a Boolean. 它确定super 方法绑定。如果它建立了则返回 |
它在以下类型中有具体定义：
|
| WithBaseObject ( ) | The abstract method WithBaseObject takes no arguments and returns an Object or with 语句相关联，则返回 with 对象。否则，返回 |
它在以下类型中有具体定义：
|
9.1.1.1 声明式环境记录
每个 Declarative Environment Record 都与一个 ECMAScript 程序作用域相关联，该作用域
每个声明式环境记录也都有一个 [[DisposableResourceStack]] 字段，其中using 声明和 await using 声明跟踪，并且必须在构造该环境记录的求值步骤完成时被处置。
9.1.1.1.1 HasBinding ( name )
The
- 如果 envRecord 具有 name 的绑定，则返回
true 。 - 返回
false 。
9.1.1.1.2 CreateMutableBinding ( name, deletable )
The
- 断言：envRecord 尚不具有 name 的绑定。
- 在 envRecord 中为 name 创建一个可变绑定，并记录它未被初始化。如果 deletable 是
true ，则记录新创建的绑定可以由后续的DeleteBinding 调用删除。 - 返回
unused 。
9.1.1.1.3 CreateImmutableBinding ( name, strict )
The
- 断言：envRecord 尚不具有 name 的绑定。
- 在 envRecord 中为 name 创建一个不可变绑定，并记录它未被初始化。如果 strict 是
true ，则记录新创建的绑定是严格绑定。 - 返回
unused 。
9.1.1.1.4 InitializeBinding ( name, value )
The
- 断言：envRecord 必须具有 name 的未初始化绑定。
- 将 envRecord 中 name 的绑定值设置为 value。
记录 envRecord 中 name 的绑定已经被初始化。- 返回
unused 。
9.1.1.1.5 SetMutableBinding ( name, value, strict )
The
- 如果 envRecord 不具有 name 的绑定，则
- 如果 strict 是
true ，则抛出ReferenceError 异常。 - 执行 ! envRecord.
CreateMutableBinding (name,true )。 - 执行 ! envRecord.
InitializeBinding (name, value)。 - 返回
unused 。
- 如果 strict 是
- 如果 envRecord 中 name 的绑定是严格绑定，则将 strict 设置为
true 。 - 如果 envRecord 中 name 的绑定尚未被初始化，则
- 抛出
ReferenceError 异常。
- 抛出
- 否则如果 envRecord 中 name 的绑定是可变绑定，则
- 将其绑定值更改为 value。
- 否则，
- 断言：这是一次尝试更改不可变绑定的值。
- 如果 strict 是
true ，则抛出TypeError 异常。
- 返回
unused 。
导致在步骤
function f() { eval("var x; x = (delete x, 0);"); }9.1.1.1.6 GetBindingValue ( name, strict )
The
- 断言：envRecord 具有 name 的绑定。
- 如果 envRecord 中 name 的绑定是未初始化绑定，则抛出
ReferenceError 异常。 - 返回 envRecord 中当前绑定到 name 的值。
9.1.1.1.7 DeleteBinding ( name )
The
- 断言：envRecord 具有 name 的绑定。
- 如果 envRecord 中 name 的绑定不能被删除，则返回
false 。 - 从 envRecord 中移除 name 的绑定。
- 返回
true 。
9.1.1.1.8 HasThisBinding ( )
The
- 返回
false 。
常规的 this 绑定。
9.1.1.1.9 GetThisBinding ( )
9.1.1.1.10 HasSuperBinding ( )
The
- 返回
false 。
常规的 super 绑定。
9.1.1.1.11 WithBaseObject ( )
The
- 返回
undefined 。
9.1.1.2 对象环境记录
每个 Object Environment Record 都与一个称为其绑定对象的对象相关联。Object Environment Record 绑定一组字符串标识符名称，这些名称直接对应于其绑定对象的
为 with 语句（
Object Environment Records 具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[BindingObject]] | an Object |
此 |
| [[IsWithEnvironment]] | a Boolean |
指示此 with 语句创建。
|
9.1.1.2.1 HasBinding ( name )
The
- 令 bindingObj 为 envRecord.[[BindingObject]]。
- 令 foundBinding 为 ?
HasProperty (bindingObj, name)。 - 如果 foundBinding 是
false ，则返回false 。 - 如果 envRecord.[[IsWithEnvironment]] 是
false ，则返回true 。 - 令 unscopables 为 ?
Get (bindingObj,%Symbol.unscopables% )。 - 如果 unscopables 是 Object，则
- 返回
true 。
9.1.1.2.2 CreateMutableBinding ( name, deletable )
The
- 令 bindingObj 为 envRecord.[[BindingObject]]。
- 执行 ?
DefinePropertyOrThrow (bindingObj, name, PropertyDescriptor { [[Value]]:undefined , [[Writable]]:true , [[Enumerable]]:true , [[Configurable]]: deletable })。 - 返回
unused 。
通常 envRecord 不会具有 name 的绑定，但如果它确实具有，则
9.1.1.2.3 CreateImmutableBinding ( name, strict )
9.1.1.2.4 InitializeBinding ( name, value )
The
- 执行 ? envRecord.
SetMutableBinding (name, value,false )。 - 返回
unused 。
在本规范中，
9.1.1.2.5 SetMutableBinding ( name, value, strict )
The
- 令 bindingObj 为 envRecord.[[BindingObject]]。
- 令 stillExists 为 ?
HasProperty (bindingObj, name)。 - 如果 stillExists 是
false 且 strict 是true ，则抛出ReferenceError 异常。 - 执行 ?
Set (bindingObj, name, value, strict)。 - 返回
unused 。
9.1.1.2.6 GetBindingValue ( name, strict )
The
- 令 bindingObj 为 envRecord.[[BindingObject]]。
- 令 value 为 ?
HasProperty (bindingObj, name)。 - 如果 value 是
false ，则- 如果 strict 是
false ，则返回undefined 。 - 抛出
ReferenceError 异常。
- 如果 strict 是
- 返回 ?
Get (bindingObj, name)。
9.1.1.2.7 DeleteBinding ( name )
The
- 令 bindingObj 为 envRecord.[[BindingObject]]。
- 返回 ? bindingObj.[[Delete]](name)。
9.1.1.2.8 HasThisBinding ( )
The
- 返回
false 。
this 绑定。
9.1.1.2.9 GetThisBinding ( )
9.1.1.2.10 HasSuperBinding ( )
The
- 返回
false 。
super 绑定。
9.1.1.2.11 WithBaseObject ( )
The
- 如果 envRecord.[[IsWithEnvironment]] 是
true ，则返回 envRecord.[[BindingObject]]。 - 返回
undefined 。
9.1.1.3 函数环境记录
Function Environment Record 是一种 this 绑定。如果一个函数不是 super，则它的 Function Environment Record 还super 方法调用的状态。
Function Environment Records 具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[ThisValue]] | an ECMAScript language value |
这是此函数调用所使用的 |
| [[ThisBindingStatus]] |
|
如果值是 |
| [[FunctionObject]] | an ECMAScript function object |
其调用导致此 |
| [[NewTarget]] |
a constructor or |
如果此 |
Function Environment Records 支持
9.1.1.3.1 BindThisValue ( envRecord, value )
The abstract operation BindThisValue takes arguments envRecord (a
- 断言：envRecord.[[ThisBindingStatus]] 不是
lexical 。 - 如果 envRecord.[[ThisBindingStatus]] 是
initialized ，则抛出ReferenceError 异常。 - 将 envRecord.[[ThisValue]] 设置为 value。
- 将 envRecord.[[ThisBindingStatus]] 设置为
initialized 。 - 返回
unused 。
9.1.1.3.2 HasThisBinding ( )
The
- 如果 envRecord.[[ThisBindingStatus]] 是
lexical ，则返回false 。 - 返回
true 。
9.1.1.3.3 GetThisBinding ( )
The
- 断言：envRecord.[[ThisBindingStatus]] 不是
lexical 。 - 如果 envRecord.[[ThisBindingStatus]] 是
uninitialized ，则抛出ReferenceError 异常。 - 返回 envRecord.[[ThisValue]]。
9.1.1.3.4 HasSuperBinding ( )
The
- 如果 envRecord.[[ThisBindingStatus]] 是
lexical ，则返回false 。 - 如果 envRecord.[[FunctionObject]].[[HomeObject]] 是
undefined ，则返回false 。 - 返回
true 。
9.1.1.3.5 GetSuperBase ( envRecord )
The abstract operation GetSuperBase takes argument envRecord (a super 属性访问的基对象。值
- 令 home 为 envRecord.[[FunctionObject]].[[HomeObject]]。
- 如果 home 是
undefined ，则返回undefined 。 - 断言：home 是
普通对象 。 - 返回 ! home.[[GetPrototypeOf]]()。
9.1.1.4 全局环境记录
Global Environment Record 用于表示由在共同
Global Environment Record 在逻辑上是一个单一记录，但在规范中被指定为封装
属性可以直接在
Global Environment Records 具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[ObjectRecord]] |
an |
绑定对象是 |
| [[GlobalThisValue]] | an Object |
在全局作用域中由 this 返回的值。 |
| [[DeclarativeRecord]] |
a |
|
9.1.1.4.1 HasBinding ( name )
The
- 令 declRecord 为 envRecord.[[DeclarativeRecord]]。
- 如果 ! declRecord.
HasBinding (name) 是true ，则返回true 。 - 令 objRecord 为 envRecord.[[ObjectRecord]]。
- 返回 ? objRecord.
HasBinding (name)。
9.1.1.4.2 CreateMutableBinding ( name, deletable )
The
- 令 declRecord 为 envRecord.[[DeclarativeRecord]]。
- 如果 ! declRecord.
HasBinding (name) 是true ，则抛出TypeError 异常。 - 返回 ! declRecord.
CreateMutableBinding (name, deletable)。
9.1.1.4.3 CreateImmutableBinding ( name, strict )
The
- 令 declRecord 为 envRecord.[[DeclarativeRecord]]。
- 如果 ! declRecord.
HasBinding (name) 是true ，则抛出TypeError 异常。 - 返回 ! declRecord.
CreateImmutableBinding (name, strict)。
9.1.1.4.4 InitializeBinding ( name, value )
The
- 令 declRecord 为 envRecord.[[DeclarativeRecord]]。
- 如果 ! declRecord.
HasBinding (name) 是true ，则- 返回 ! declRecord.
InitializeBinding (name, value)。
- 返回 ! declRecord.
- 断言：如果绑定存在，它必须在
Object Environment Record 中。 - 令 objRecord 为 envRecord.[[ObjectRecord]]。
- 返回 ? objRecord.
InitializeBinding (name, value)。
9.1.1.4.5 SetMutableBinding ( name, value, strict )
The
- 令 declRecord 为 envRecord.[[DeclarativeRecord]]。
- 如果 ! declRecord.
HasBinding (name) 是true ，则- 返回 ? declRecord.
SetMutableBinding (name, value, strict)。
- 返回 ? declRecord.
- 令 objRecord 为 envRecord.[[ObjectRecord]]。
- 返回 ? objRecord.
SetMutableBinding (name, value, strict)。
9.1.1.4.6 GetBindingValue ( name, strict )
The
- 令 declRecord 为 envRecord.[[DeclarativeRecord]]。
- 如果 ! declRecord.
HasBinding (name) 是true ，则- 返回 ? declRecord.
GetBindingValue (name, strict)。
- 返回 ? declRecord.
- 令 objRecord 为 envRecord.[[ObjectRecord]]。
- 返回 ? objRecord.
GetBindingValue (name, strict)。
9.1.1.4.7 DeleteBinding ( name )
The
- 令 declRecord 为 envRecord.[[DeclarativeRecord]]。
- 如果 ! declRecord.
HasBinding (name) 是true ，则- 返回 ! declRecord.
DeleteBinding (name)。
- 返回 ! declRecord.
- 令 objRecord 为 envRecord.[[ObjectRecord]]。
- 令 globalObj 为 objRecord.[[BindingObject]]。
- 令 existingProperty 为 ?
HasOwnProperty (globalObj, name)。 - 如果 existingProperty 是
true ，则- 返回 ? objRecord.
DeleteBinding (name)。
- 返回 ? objRecord.
- 返回
true 。
9.1.1.4.8 HasThisBinding ( )
The
- 返回
true 。
this 绑定。
9.1.1.4.9 GetThisBinding ( )
The
- 返回 envRecord.[[GlobalThisValue]]。
9.1.1.4.10 HasSuperBinding ( )
The
- 返回
false 。
super 绑定。
9.1.1.4.11 WithBaseObject ( )
The
- 返回
undefined 。
9.1.1.4.12 HasLexicalDeclaration ( envRecord, name )
The abstract operation HasLexicalDeclaration takes arguments envRecord (a
- 令 declRecord 为 envRecord.[[DeclarativeRecord]]。
- 返回 ! declRecord.
HasBinding (name)。
9.1.1.4.13 HasRestrictedGlobalProperty ( envRecord, name )
The abstract operation HasRestrictedGlobalProperty takes arguments envRecord (a
- 令 objRecord 为 envRecord.[[ObjectRecord]]。
- 令 globalObj 为 objRecord.[[BindingObject]]。
- 令 existingProperty 为 ? globalObj.[[GetOwnProperty]](name)。
- 如果 existingProperty 是
undefined ，则返回false 。 - 如果 existingProperty.[[Configurable]] 是
true ，则返回false 。 - 返回
true 。
9.1.1.4.14 CanDeclareGlobalVar ( envRecord, name )
The abstract operation CanDeclareGlobalVar takes arguments envRecord (a
- 令 objRecord 为 envRecord.[[ObjectRecord]]。
- 令 globalObj 为 objRecord.[[BindingObject]]。
- 令 hasProperty 为 ?
HasOwnProperty (globalObj, name)。 - 如果 hasProperty 是
true ，则返回true 。 - 返回 ?
IsExtensible (globalObj)。
9.1.1.4.15 CanDeclareGlobalFunction ( envRecord, name )
The abstract operation CanDeclareGlobalFunction takes arguments envRecord (a
- 令 objRecord 为 envRecord.[[ObjectRecord]]。
- 令 globalObj 为 objRecord.[[BindingObject]]。
- 令 existingProperty 为 ? globalObj.[[GetOwnProperty]](name)。
- 如果 existingProperty 是
undefined ，则返回 ?IsExtensible (globalObj)。 - 如果 existingProperty.[[Configurable]] 是
true ，则返回true 。 - 如果
IsDataDescriptor (existingProperty) 是true 且 existingProperty 具有特性值 { [[Writable]]:true , [[Enumerable]]:true }，则返回true 。 - 返回
false 。
9.1.1.4.16 CreateGlobalVarBinding ( envRecord, name, deletable )
The abstract operation CreateGlobalVarBinding takes arguments envRecord (a
- 令 objRecord 为 envRecord.[[ObjectRecord]]。
- 令 globalObj 为 objRecord.[[BindingObject]]。
- 令 hasProperty 为 ?
HasOwnProperty (globalObj, name)。 - 令 extensible 为 ?
IsExtensible (globalObj)。 - 如果 hasProperty 是
false 且 extensible 是true ，则- 执行 ? objRecord.
CreateMutableBinding (name, deletable)。 - 执行 ? objRecord.
InitializeBinding (name,undefined )。
- 执行 ? objRecord.
- 返回
unused 。
9.1.1.4.17 CreateGlobalFunctionBinding ( envRecord, name, value, deletable )
The abstract operation CreateGlobalFunctionBinding takes arguments envRecord (a
- 令 objRecord 为 envRecord.[[ObjectRecord]]。
- 令 globalObj 为 objRecord.[[BindingObject]]。
- 令 existingProperty 为 ? globalObj.[[GetOwnProperty]](name)。
- 如果 existingProperty 是
undefined 或 existingProperty.[[Configurable]] 是true ，则- 令 propertyDesc 为 PropertyDescriptor { [[Value]]: value, [[Writable]]:
true , [[Enumerable]]:true , [[Configurable]]: deletable }。
- 令 propertyDesc 为 PropertyDescriptor { [[Value]]: value, [[Writable]]:
- 否则，
- 令 propertyDesc 为 PropertyDescriptor { [[Value]]: value }。
- 执行 ?
DefinePropertyOrThrow (globalObj, name, propertyDesc)。 - 执行 ?
Set (globalObj, name, value,false )。 - 返回
unused 。
全局函数声明总是表示为
9.1.1.5 模块环境记录
Module Environment Record 是一种
Module Environment Records 支持
9.1.1.5.1 GetBindingValue ( name, strict )
The
- 断言：strict 是
true 。 - 断言：envRecord 具有 name 的绑定。
- 如果 name 的绑定是间接绑定，则
- 令 module 和 targetName 为创建 name 的此绑定时提供的间接值。
- 令 targetEnv 为 module.[[Environment]]。
- 如果 targetEnv 是
empty ，则抛出ReferenceError 异常。 - 返回 ? targetEnv.
GetBindingValue (targetName,true )。
- 如果 envRecord 中 name 的绑定是未初始化绑定，则抛出
ReferenceError 异常。 - 返回 envRecord 中当前绑定到 name 的值。
strict 将始终是
9.1.1.5.2 DeleteBinding ( name )
9.1.1.5.3 HasThisBinding ( )
The
- 返回
true 。
this 绑定。
9.1.1.5.4 GetThisBinding ( )
The
- 返回
undefined 。
9.1.1.5.5 CreateImportBinding ( envRecord, name, targetModule, targetName )
The abstract operation CreateImportBinding takes arguments envRecord (a
- 断言：envRecord 尚不具有 name 的绑定。
- 断言：当 targetModule.[[Environment]] 被实例化时，它将具有 targetName 的直接绑定。
- 在 envRecord 中为 name 创建一个不可变间接绑定，该绑定引用 targetModule 和 targetName 作为其目标绑定，并记录该绑定已被初始化。
- 返回
unused 。
9.1.2 Environment Record 操作
以下
9.1.2.1 GetIdentifierReference ( envRecord, name, strict )
The abstract operation GetIdentifierReference takes arguments envRecord (an
- 如果 envRecord 是
null ，则- 返回
Reference Record { [[Base]]:unresolvable , [[ReferencedName]]: name, [[Strict]]: strict, [[ThisValue]]:empty }。
- 返回
- 令 exists 为 ? envRecord.
HasBinding (name)。 - 如果 exists 是
true ，则- 返回
Reference Record { [[Base]]: envRecord, [[ReferencedName]]: name, [[Strict]]: strict, [[ThisValue]]:empty }。
- 返回
- 令 outer 为 envRecord.[[OuterEnv]]。
- 返回 ?
GetIdentifierReference (outer, name, strict)。
9.1.2.2 NewDeclarativeEnvironment ( outerEnv )
The abstract operation NewDeclarativeEnvironment takes argument outerEnv (an
- 令 envRecord 为一个不
包含 任何绑定的新声明式环境记录。 - 将 envRecord.[[OuterEnv]] 设置为 outerEnv。
- 将 envRecord.[[DisposableResourceStack]] 设置为一个新的空列表。
- 返回 envRecord。
9.1.2.3 NewObjectEnvironment ( obj, isWithEnv, outerEnv )
The abstract operation NewObjectEnvironment takes arguments obj (an Object), isWithEnv (a Boolean), and outerEnv (an
- 令 envRecord 为一个新的
Object Environment Record 。 - 将 envRecord.[[BindingObject]] 设置为 obj。
- 将 envRecord.[[IsWithEnvironment]] 设置为 isWithEnv。
- 将 envRecord.[[OuterEnv]] 设置为 outerEnv。
- 返回 envRecord。
9.1.2.4 NewFunctionEnvironment ( func, newTarget )
The abstract operation NewFunctionEnvironment takes arguments func (an ECMAScript function object) and newTarget (an Object or
- 令 envRecord 为一个不
包含 任何绑定的新函数环境记录。 - 将 envRecord.[[FunctionObject]] 设置为 func。
- 如果 func.[[ThisMode]] 是
lexical ，则将 envRecord.[[ThisBindingStatus]] 设置为lexical 。 - 否则，将 envRecord.[[ThisBindingStatus]] 设置为
uninitialized 。 - 将 envRecord.[[NewTarget]] 设置为 newTarget。
- 将 envRecord.[[OuterEnv]] 设置为 func.[[Environment]]。
- 将 envRecord.[[DisposableResourceStack]] 设置为一个新的空列表。
- 返回 envRecord。
9.1.2.5 NewGlobalEnvironment ( obj, thisValue )
The abstract operation NewGlobalEnvironment takes arguments obj (an Object) and thisValue (an Object) and returns a
- 令 objRecord 为
NewObjectEnvironment (obj,false ,null )。 - 令 declRecord 为
NewDeclarativeEnvironment (null )。 - 令 envRecord 为一个新的
Global Environment Record 。 - 将 envRecord.[[ObjectRecord]] 设置为 objRecord。
- 将 envRecord.[[GlobalThisValue]] 设置为 thisValue。
- 将 envRecord.[[DeclarativeRecord]] 设置为 declRecord。
- 将 envRecord.[[OuterEnv]] 设置为
null 。 - 返回 envRecord。
9.1.2.6 NewModuleEnvironment ( outerEnv )
The abstract operation NewModuleEnvironment takes argument outerEnv (a
- 令 envRecord 为一个不
包含 任何绑定的新模块环境记录。 - 将 envRecord.[[OuterEnv]] 设置为 outerEnv。
- 将 envRecord.[[DisposableResourceStack]] 设置为一个新的空列表。
- 返回 envRecord。
9.2 PrivateEnvironment Records
PrivateEnvironment Record 是一种规范机制，用于基于 ECMAScript 代码中
每个
| 字段名 | 值类型 | 含义 |
|---|---|---|
| [[OuterPrivateEnvironment]] |
a |
最近的 |
| [[Names]] |
a |
此类声明的 |
9.2.1 PrivateEnvironment Record 操作
以下
9.2.1.1 NewPrivateEnvironment ( outerPrivateEnv )
The abstract operation NewPrivateEnvironment takes argument outerPrivateEnv (a
- 令 names 为一个新的空
List 。 - 返回
PrivateEnvironment Record { [[OuterPrivateEnvironment]]: outerPrivateEnv, [[Names]]: names }。
9.2.1.2 ResolvePrivateIdentifier ( privateEnv, identifier )
The abstract operation ResolvePrivateIdentifier takes arguments privateEnv (a
- 令 names 为 privateEnv.[[Names]]。
- 对 names 的每个
Private Name privateName，执行：- 如果 privateName.[[Description]] 是 identifier，则
- 返回 privateName。
- 如果 privateName.[[Description]] 是 identifier，则
- 令 outerPrivateEnv 为 privateEnv.[[OuterPrivateEnvironment]]。
- 断言：outerPrivateEnv 不是
null 。 - 返回
ResolvePrivateIdentifier (outerPrivateEnv, identifier)。
9.3 Realms
所有 ECMAScript 代码在被求值之前都必须与一个 realm 相关联。从概念上讲，一个
在本规范中，
| 字段名 | 值 | 含义 |
|---|---|---|
| [[AgentSignifier]] |
an |
拥有此 |
| [[Intrinsics]] |
a |
与此 |
| [[GlobalObject]] | an Object |
此 |
| [[GlobalEnv]] |
a |
此 |
| [[TemplateMap]] |
a |
模板对象会使用其 一旦某个 |
| [[LoadedModules]] |
a |
从此
如 import() 表达式时使用。
|
| [[HostDefined]] |
anything (default value is |
保留给需要将额外信息与 |
9.3.1 InitializeHostDefinedRealm ( )
The abstract operation InitializeHostDefinedRealm takes no arguments and returns either a normal completion containing
- 令 realm 为一个新的
Realm Record 。 - 执行
CreateIntrinsics (realm)。 - 将 realm.[[AgentSignifier]] 设置为
AgentSignifier ()。 - 将 realm.[[TemplateMap]] 设置为一个新的空
List 。 - 令 newContext 为一个新的执行上下文。
- 将 newContext 的 Function 设置为
null 。 - 将 newContext 的
Realm 设置为 realm。 - 将 newContext 的 ScriptOrModule 设置为
null 。 - 将 newContext 压入执行上下文栈；newContext 现在是运行中执行上下文。
- 如果
宿主 要求使用特定对象作为 realm 的全局对象 ，则- 令 global 为以
宿主 定义方式创建的这种对象。
- 令 global 为以
- 否则，
- 令 global 为
OrdinaryObjectCreate (realm.[[Intrinsics]].[[%Object.prototype% ]])。
- 令 global 为
- 如果
宿主 要求 realm 的全局作用域中的this绑定返回全局对象 以外的对象，则- 令 thisValue 为以
宿主 定义方式创建的这种对象。
- 令 thisValue 为以
- 否则，
- 令 thisValue 为 global。
- 将 realm.[[GlobalObject]] 设置为 global。
- 将 realm.[[GlobalEnv]] 设置为
NewGlobalEnvironment (global, thisValue)。 - 执行 ?
SetDefaultGlobalBindings (realm)。 - 在 global 上创建任何
宿主定义的 全局对象 属性。 - 返回
unused 。
9.3.2 CreateIntrinsics ( realmRecord )
The abstract operation CreateIntrinsics takes argument realmRecord (a
- 将 realmRecord.[[Intrinsics]] 设置为一个新的
Record 。 - 使用
Table 6 中列出的值设置 realmRecord.[[Intrinsics]] 的字段。字段名是该表“Intrinsic Name”列中列出的名称。每个字段的值都是一个新的对象值，并按照19 到28 各条款中每个对象的规范所定义的属性值完全且递归地填充。所有对象属性值都是新创建的对象值。所有作为内置函数对象 的值都通过执行CreateBuiltinFunction (steps, length, name, slots, realmRecord, proto, async) 创建，其中 steps 是本规范提供的该函数的定义，name 是该函数"name" 属性的初始值，length 是该函数"length" 属性的初始值，slots 是该函数指定内部槽的名称列表（如果有），proto 是该函数 [[Prototype]] 内部槽的指定值，且如果该函数被描述为“async”则 async 为true ，否则为false 。固有对象及其属性的创建必须进行排序，以避免依赖尚未创建的对象。 - 执行
AddRestrictedFunctionProperties (realmRecord.[[Intrinsics]].[[%Function.prototype% ]], realmRecord)。 - 返回
unused 。
9.3.3 SetDefaultGlobalBindings ( realmRecord )
The abstract operation SetDefaultGlobalBindings takes argument realmRecord (a
- 令 global 为 realmRecord.[[GlobalObject]]。
- 对条款
19 中指定的 Global Object 的每个属性，执行：- 令 name 为该
属性名 的 String 值。 - 令 propertyDesc 为该属性的完全填充的数据
Property Descriptor ，其中包含 该属性的指定特性。对于19.2 、19.3 或19.4 中列出的属性，[[Value]] 特性的值是来自 realmRecord 的对应固有对象。 - 执行 ?
DefinePropertyOrThrow (global, name, propertyDesc)。
- 令 name 为该
- 返回
unused 。
9.4 执行上下文
execution context 是一种规范装置，ECMAScript 实现使用它跟踪代码的运行时求值。在任意时刻，每个
execution context stack 用于跟踪执行上下文。运行中执行上下文始终是此栈的顶层元素。每当控制从与当前运行中执行上下文关联的可执行代码转移到不与该执行上下文关联的可执行代码时，就会创建一个新的执行上下文。新创建的执行上下文被压入栈中，并成为运行中执行上下文。
执行上下文
| 组件 | 目的 |
|---|---|
| code evaluation state | 执行、暂停和恢复与此执行上下文关联的代码求值所需的任何状态。 |
| Function |
如果此执行上下文正在求值一个 |
|
|
关联代码访问 ECMAScript 资源所来自的 |
| ScriptOrModule |
关联代码所源自的 |
运行中执行上下文对代码的求值，可以在本规范中定义的各个点被暂停。一旦运行中执行上下文被暂停，另一个不同的执行上下文就可以成为运行中执行上下文并开始求值其代码。在之后的某个时间，被暂停的执行上下文可以再次成为运行中执行上下文，并在它此前被暂停的位置继续求值其代码。运行中执行上下文状态在执行上下文之间的转移通常以类似栈的后进先出方式发生。然而，某些 ECMAScript 特性需要运行中执行上下文的非 LIFO 转移。
运行中执行上下文的
ECMAScript 代码执行上下文具有
| 组件 | 目的 |
|---|---|
| LexicalEnvironment |
标识用于解析此执行上下文内代码所产生的标识符引用的 |
| VariableEnvironment |
标识保存此执行上下文内由 |
| PrivateEnvironment |
标识保存最近 |
执行上下文的 LexicalEnvironment 和 VariableEnvironment 组件始终是
表示 Generators 求值的执行上下文具有
| 组件 | 目的 |
|---|---|
| Generator | 此执行上下文正在求值的 Generator。 |
在大多数情况下，本规范中的算法只直接操纵运行中执行上下文（执行上下文栈的顶端）。因此，当术语 “LexicalEnvironment” 和 “VariableEnvironment” 未加限定地使用时，它们指的是运行中执行上下文的这些组件。
执行上下文纯粹是一种规范机制，并不需要对应于 ECMAScript 实现中的任何特定工件。ECMAScript 代码不可能直接访问或观察执行上下文。
9.4.1 GetActiveScriptOrModule ( )
The abstract operation GetActiveScriptOrModule takes no arguments and returns a
- 如果执行上下文栈为空，则返回
null 。 - 令 executionContext 为执行上下文栈中 ScriptOrModule 组件不是
null 的最顶层执行上下文。 - 如果不存在这样的执行上下文，则返回
null 。 - 返回 executionContext 的 ScriptOrModule。
9.4.2 ResolveBinding ( name [ , envRecord ] )
The abstract operation ResolveBinding takes argument name (a String) and optional argument envRecord (an
- 如果 envRecord 不存在或 envRecord 是
undefined ，则- 将 envRecord 设置为运行中执行上下文的 LexicalEnvironment。
- 断言：envRecord 是
Environment Record 。 - 令 strict 为
IsStrict (正在求值的句法产生式)。 - 返回 ?
GetIdentifierReference (envRecord, name, strict)。
ResolveBinding 的结果始终是 [[ReferencedName]] 字段为 name 的
9.4.3 GetThisEnvironment ( )
The abstract operation GetThisEnvironment takes no arguments and returns an this 绑定的
- 令 envRecord 为运行中执行上下文的 LexicalEnvironment。
- 重复，
- 令 exists 为 envRecord.
HasThisBinding ()。 - 如果 exists 是
true ，则返回 envRecord。 - 令 outer 为 envRecord.[[OuterEnv]]。
- 断言：outer 不是
null 。 - 将 envRecord 设置为 outer。
- 令 exists 为 envRecord.
步骤 this 绑定的全局环境结束。
9.4.4 ResolveThisBinding ( )
The abstract operation ResolveThisBinding takes no arguments and returns either a normal completion containing an ECMAScript language value or a throw completion. 它使用运行中执行上下文的 LexicalEnvironment 确定this 的绑定。 It performs the following steps when called:
- 令 envRecord 为
GetThisEnvironment ()。 - 返回 ? envRecord.
GetThisBinding ()。
9.4.5 GetNewTarget ( )
The abstract operation GetNewTarget takes no arguments and returns an Object or
- 令 envRecord 为
GetThisEnvironment ()。 - 断言：envRecord 具有 [[NewTarget]] 字段。
- 返回 envRecord.[[NewTarget]]。
9.4.6 GetGlobalObject ( )
The abstract operation GetGlobalObject takes no arguments and returns an Object. 它返回当前运行中执行上下文使用的
- 令 currentRealm 为
当前 Realm Record 。 - 返回 currentRealm.[[GlobalObject]]。
9.4.7 RunSuspendedContext ( context, completionRecord )
The abstract operation RunSuspendedContext takes arguments context (an
- 令 callerContext 为运行中执行上下文。
- 暂停 callerContext。
- 将 context 压入执行上下文栈；context 现在是运行中执行上下文。
- 使用 completionRecord 作为导致其暂停的操作的结果，恢复 context 的暂停求值。令 result 为恢复的计算返回的
Completion Record 。 - 断言：当我们到达此步骤时，context 已经从执行上下文栈中移除，并且 callerContext 再次成为运行中执行上下文。
- 返回
Completion (result)。
9.4.8 RunCallerContext ( value )
The abstract operation RunCallerContext takes argument value (一个
- 令 genContext 为运行中的执行上下文。
- 从执行上下文栈中移除 genContext，并将位于执行上下文栈顶部的执行上下文恢复为运行中的执行上下文。
- 令 callerContext 为运行中的执行上下文。
- 恢复 callerContext，传入
NormalCompletion (value)。 - 注：上述步骤将控制转移给 callerContext 并暂停。使其解除暂停并让控制继续到此算法后续步骤的唯一方式，是再次恢复 genContext，而这可能永远不会发生。
- 断言：genContext 是运行中的执行上下文。
- 令 result 为 genContext 刚刚被恢复时所用的完成记录。
- 返回
Completion (result)。
9.5 作业和用于将作业入队的宿主操作
Job 是一个不带形参的
- 在将来的某个时间点，当为该 job 调度的
agent 中没有运行中上下文且该agent 的执行上下文栈为空时，实现必须：- 执行任何
宿主定义的 准备步骤。 调用 该Job Abstract Closure 。- 执行任何
宿主定义的 清理步骤，之后执行上下文栈必须为空。
- 执行任何
- 在任意时间点，一个
agent 中只能有一个Job 正在主动经历求值。 - 一旦某个
Job 的求值开始，它必须运行至完成，然后一个agent 中的任何其他Job 才能开始求值。 Abstract Closure 必须返回 normal completion，并实现其自身的错误处理。
在任意特定时间，如果以下所有条件均为真，则 scriptOrModule（
GetActiveScriptOrModule () 是 scriptOrModule。- 如果 scriptOrModule 是
Script Record 或Module Record ，则令 executionContext 为执行上下文栈中 ScriptOrModule 组件为 scriptOrModule 的最顶层执行上下文。executionContext 的Realm 组件是 scriptOrModule.[[Realm]]。
在任意特定时间，如果以下所有条件均为真，则某次执行已准备好求值 ECMAScript 代码：
- 执行上下文栈不为空。
- 执行上下文栈最顶层执行上下文的
Realm 组件是Realm Record 。
特定种类的
9.5.1 JobCallback Records
JobCallback Record 是一个
例如，WHATWG HTML 规范（https://html.spec.whatwg.org/）使用
JobCallback Records 具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Callback]] | a function object |
当 |
| [[HostDefined]] |
anything (default value is |
保留给 |
9.5.2 HostMakeJobCallback ( callback )
The host-defined abstract operation HostMakeJobCallback takes argument callback (a function object) and returns a
HostMakeJobCallback 的实现必须符合以下要求：
- 它必须返回一个
JobCallback Record ，其 [[Callback]] 字段为 callback。
HostMakeJobCallback 的默认实现在被调用时执行以下步骤：
- 返回
JobCallback Record { [[Callback]]: callback, [[HostDefined]]:empty }。
不是 Web 浏览器的 ECMAScript
这在回调被传给负责最终调度并运行它的函数时调用。例如，promise.then(thenAction) 在调用 Promise.prototype.then 时对 thenAction 调用 MakeJobCallback，而不是在调度 reaction
9.5.3 HostCallJobCallback ( jobCallback, thisValue, argList )
The host-defined abstract operation HostCallJobCallback takes arguments jobCallback (a
HostCallJobCallback 的实现必须符合以下要求：
- 它必须执行并返回
Call (jobCallback.[[Callback]], thisValue, argList) 的结果。
HostCallJobCallback 的默认实现在被调用时执行以下步骤：
- 断言：
IsCallable (jobCallback.[[Callback]]) 是true 。 - 返回 ?
Call (jobCallback.[[Callback]], thisValue, argList)。
不是 Web 浏览器的 ECMAScript
9.5.4 HostEnqueueGenericJob ( job, realm )
The host-defined abstract operation HostEnqueueGenericJob takes arguments job (a
HostEnqueueGenericJob 的实现必须符合
9.5.5 HostEnqueuePromiseJob ( job, realm )
The host-defined abstract operation HostEnqueuePromiseJob takes arguments job (a
HostEnqueuePromiseJob 的实现必须符合
- 如果 realm 不是
null ，则每次调用 job 时，实现必须执行实现定义的 步骤，使得在 job 调用时执行已准备好求值 ECMAScript 代码 。 - 令 scriptOrModule 为调用 HostEnqueuePromiseJob 时的
GetActiveScriptOrModule ()。如果 realm 不是null ，则每次调用 job 时，实现必须执行实现定义的 步骤，使得在 job 调用时 scriptOrModule 是活动脚本或模块 。 Jobs 必须按调度它们的 HostEnqueuePromiseJob 调用的相同顺序运行。
9.5.6 HostEnqueueTimeoutJob ( timeoutJob, realm, milliseconds )
The host-defined abstract operation HostEnqueueTimeoutJob takes arguments timeoutJob (a
HostEnqueueTimeoutJob 的实现必须符合
9.6 Agents
agent
例如，某些 Web 浏览器会在一个浏览器窗口的多个不相关标签页之间共享单个
当
agent signifier 是一个全局唯一的不透明值，用于标识
| 字段名称 | 值 | 含义 |
|---|---|---|
| [[LittleEndian]] | 一个布尔值 | 当算法 |
| [[CanBlock]] | 一个布尔值 | 确定该代理是否可以阻塞。 |
| [[Signifier]] | 一个代理标识符 | 在其代理集群中唯一标识该代理。 |
| [[IsLockFree1]] | 一个布尔值 | 如果对一 |
| [[IsLockFree2]] | 一个布尔值 | 如果对两 |
| [[IsLockFree8]] | 一个布尔值 | 如果对八 |
| [[CandidateExecution]] | 一个候选执行记录 | 见 |
| [[KeptAlive]] | 一个由对象或 Symbol 组成的列表 | 最初是一个新的空列表，表示要保持活动直到当前 |
| [[ModuleAsyncEvaluationCount]] | 一个整数 | 最初为 0，用于为异步模块或具有异步依赖项的模块的 [[AsyncEvaluationOrder]] 字段分配唯一的递增值。 |
| [[GlobalSymbolRegistry]] | 一个 |
最初是一个新的空列表，表示由 |
[[LittleEndian]]、[[Signifier]]、[[IsLockFree1]]、[[IsLockFree2]] 和 [[IsLockFree8]] 的值不能改变。
[[GlobalSymbolRegistry]] 列表只能追加，且绝不会被重新赋值。
[[IsLockFree1]]、[[IsLockFree2]] 和 [[IsLockFree8]] 的值不一定由硬件决定，也可以反映会随时间以及 ECMAScript 实现而变化的实现选择。
没有 [[IsLockFree4]] 字段：4 字节原子操作始终是免锁的。
在实践中，如果某个原子操作使用任何类型的锁来实现，则该操作不是免锁的。免锁并不意味着无等待：完成一个免锁原子操作可能需要多少机器步骤没有上界。
大小为 n 的原子访问是免锁的，并不意味着大小为 n 的非原子访问的（感知）原子性有任何保证；具体而言，非原子访问仍可能作为若干独立内存访问的序列执行。详情参见
9.6.1 AgentSignifier ( )
The abstract operation AgentSignifier takes no arguments and returns an
- 令 agentRecord 为
周围 agent 的Agent Record 。 - 返回 agentRecord.[[Signifier]]。
9.6.2 AgentCanSuspend ( )
The abstract operation AgentCanSuspend takes no arguments and returns a Boolean. It performs the following steps when called:
- 令 agentRecord 为
周围 agent 的Agent Record 。 - 返回 agentRecord.[[CanBlock]]。
在某些环境中，允许给定
9.6.3 IncrementModuleAsyncEvaluationCount ( )
The abstract operation IncrementModuleAsyncEvaluationCount takes no arguments and returns a non-negative
- 令 agentRecord 为
周围 agent 的Agent Record 。 - 令 count 为 agentRecord.[[ModuleAsyncEvaluationCount]]。
- 将 agentRecord.[[ModuleAsyncEvaluationCount]] 设置为 count + 1。
- 返回 count。
此值仅用于跟踪待处理模块之间的相对求值顺序。只要没有待处理模块，实现就可以不可观察地将 [[ModuleAsyncEvaluationCount]] 重置为 0。
9.7 Agent Clusters
agent cluster 是可以通过对共享内存进行操作来通信的最大
每个
cluster 内的所有
如果一个 agent cluster 内不同
cluster 内的所有
cluster 内的所有
嵌入环境可以在
前述限制的目的，是避免
该限制的含义是，在嵌入环境中，不属于同一暂停/唤醒集体的
嵌入环境可以在 agent cluster 的其他
以下每个规范值，以及从它们传递可达的值，都恰好属于一个 agent cluster。
在一个 cluster 中任何
一个 agent cluster 中的所有
agent cluster 是一种规范机制，并不需要对应于 ECMAScript 实现中的任何特定工件。
9.8 前向进展
一个
当
实现必须确保：
- 每个具有专用
执行线程 的未阻塞agent 最终取得前向进展 - 在共享
执行线程 的一组agents 中，某个agent 最终取得前向进展 - 一个
agent 不会导致另一个agent 变为阻塞，除非通过提供阻塞的显式 API。
9.9 WeakRef 和 FinalizationRegistry 目标的处理模型
9.9.1 目标
本规范不保证任何对象或符号会被垃圾回收。不存活的对象或符号可能在很长时间之后被释放，或者永远不会被释放。因此，本规范在描述由垃圾回收触发的行为时使用术语“may”。
-
当调用
WeakRef.prototype.deref时，其所指对象（如果没有返回undefined ）会被保持存活，使得后续的同步访问也返回相同值。当使用ClearKeptObjects 抽象操作 完成同步工作时，此列表会被重置。 -
当用
FinalizationRegistry 注册的对象或符号变得不可达时，在同步 ECMAScript 执行完成之后，最终可能会调用该FinalizationRegistry 的 cleanup callback。FinalizationRegistry cleanup 通过CleanupFinalizationRegistry 抽象操作 执行。
这两个动作（
某些 ECMAScript 实现
9.9.2 活性
对于某组对象和/或符号 objSet，相对于 objSet 的一次假想的 WeakRef-oblivious 执行，是这样一种执行：
在求值期间的任何时刻，如果满足以下任一条件，则一组对象和/或符号 objSet 被认为是 live：
-
objSet 中的任何元素
包含 在任何agent 的 [[KeptAlive]]List 中。 -
存在一次相对于 objSet 的有效未来假想
WeakRef -oblivious 执行，该执行观察到 objSet 中任何值的身份。
对象或符号出现在某个字段、内部槽或属性中，并不意味着该值是 live。例如，如果所讨论的值永远不会被传回程序，则它不能被观察到。
WeakMap 中的键、WeakSet 的成员，以及
上述定义意味着，如果 WeakMap 中的某个键不是 live，则其对应值也不一定是 live。
9.9.3 执行
在任意时间，如果一组对象和/或符号 objSet 不是
- 对 objSet 的每个元素 value，执行：
- 对每个
WeakRef ref，如果 ref.[[WeakRefTarget]] 是 value，则执行：- 将 ref.[[WeakRefTarget]] 设置为
empty 。
- 将 ref.[[WeakRefTarget]] 设置为
- 对每个
FinalizationRegistry finalizationRegistry，如果 finalizationRegistry.[[Cells]]包含 一个Record cell，使得 cell.[[WeakRefTarget]] 是 value，则执行：- 将 cell.[[WeakRefTarget]] 设置为
empty 。 - 令 enqueueCleanup 为一个
实现定义的 选择，其值为true 或false 。 - 如果 enqueueCleanup 是
true ，则执行HostEnqueueFinalizationRegistryCleanupJob (finalizationRegistry)。
- 将 cell.[[WeakRefTarget]] 设置为
- 对每个 WeakMap map，如果 map.[[WeakMapData]]
包含 一个Record entry，使得 entry.[[Key]] 是 value，则执行：- 将 entry.[[Key]] 设置为
empty 。 - 将 entry.[[Value]] 设置为
empty 。
- 将 entry.[[Key]] 设置为
- 对每个 WeakSet set，如果 set.[[WeakSetData]]
包含 value，则执行：- 将 set.[[WeakSetData]] 中值为 value 的元素替换为一个值为
empty 的元素。
- 将 set.[[WeakSetData]] 中值为 value 的元素替换为一个值为
- 对每个
本条款与 liveness 的定义一起，规定了实现可以对
可以访问对象而不观察其身份。允许对身份未被观察的非逃逸对象的属性进行诸如死变量消除和标量替换之类的优化。因此，这些优化被允许以可观察方式清空指向这类对象的
另一方面，如果某个对象的身份是可观察的，并且该对象位于
由于调用
9.9.4 宿主钩子
9.9.4.1 HostEnqueueFinalizationRegistryCleanupJob ( finalizationRegistry )
The host-defined abstract operation HostEnqueueFinalizationRegistryCleanupJob takes argument finalizationRegistry (a
令 cleanupJob 为一个不带形参的新
- 令 cleanupResult 为
Completion (CleanupFinalizationRegistry (finalizationRegistry))。 - 如果 cleanupResult 是 abrupt completion，则执行任何
宿主定义的 步骤来报告错误。 - 返回
unused 。
HostEnqueueFinalizationRegistryCleanupJob 的实现会调度 cleanupJob 在将来某个时间执行，如果可能的话。它还必须符合
9.10 ClearKeptObjects ( )
The abstract operation ClearKeptObjects takes no arguments and returns
- 令 agentRecord 为
周围 agent 的Agent Record 。 - 将 agentRecord.[[KeptAlive]] 设置为一个新的空
List 。 - 返回
unused 。
9.11 AddToKeptObjects ( value )
The abstract operation AddToKeptObjects takes argument value (an Object or a Symbol) and returns
- 令 agentRecord 为
周围 agent 的Agent Record 。 - 将 value 追加到 agentRecord.[[KeptAlive]]。
- 返回
unused 。
9.12 CleanupFinalizationRegistry ( finalizationRegistry )
The abstract operation CleanupFinalizationRegistry takes argument finalizationRegistry (a
- 断言：finalizationRegistry 具有 [[Cells]] 和 [[CleanupCallback]] 内部槽。
- 令 callback 为 finalizationRegistry.[[CleanupCallback]]。
- 当 finalizationRegistry.[[Cells]]
包含 一个Record cell，使得 cell.[[WeakRefTarget]] 是empty 时，实现可以执行以下步骤：- 选择任意这样的 cell。
- 从 finalizationRegistry.[[Cells]] 中移除 cell。
- 执行 ?
HostCallJobCallback (callback,undefined , « cell.[[HeldValue]] »)。
- 返回
unused 。
9.13 CanBeHeldWeakly ( arg )
The abstract operation CanBeHeldWeakly takes argument arg (an ECMAScript language value) and returns a Boolean. 当且仅当 arg 适合用作弱引用时，它返回
- 如果 arg 是 Object，则返回
true 。 - 如果 arg 是 Symbol 且
KeyForSymbol (arg) 是undefined ，则返回true 。 - 返回
false 。
没有
10 普通对象与异质对象行为
10.1 普通对象内部方法与内部槽
所有
每个
在以下算法描述中，假设 obj 是
每个
10.1.1 [[GetPrototypeOf]] ( )
The [[GetPrototypeOf]] internal method of 一个
- 返回
OrdinaryGetPrototypeOf (obj)。
10.1.1.1 OrdinaryGetPrototypeOf ( obj )
The abstract operation OrdinaryGetPrototypeOf takes argument obj (an Object) and returns an Object or
- 返回 obj.[[Prototype]]。
10.1.2 [[SetPrototypeOf]] ( proto )
The [[SetPrototypeOf]] internal method of 一个
- 返回
OrdinarySetPrototypeOf (obj, proto)。
10.1.2.1 OrdinarySetPrototypeOf ( obj, proto )
The abstract operation OrdinarySetPrototypeOf takes arguments obj (an Object) and proto (an Object or
- 令 current 为 obj.[[Prototype]]。
- 如果
SameValue (proto, current) 是true ，则返回true 。 - 令 extensible 为 obj.[[Extensible]]。
- 如果 extensible 是
false ，则返回false 。 - 令 cursor 为 proto。
- 令 done 为
false 。 - 重复，当 done 是
false 时， - 将 obj.[[Prototype]] 设置为 proto。
- 返回
true 。
10.1.3 [[IsExtensible]] ( )
The [[IsExtensible]] internal method of 一个
- 返回
OrdinaryIsExtensible (obj)。
10.1.3.1 OrdinaryIsExtensible ( obj )
The abstract operation OrdinaryIsExtensible takes argument obj (an Object) and returns a Boolean. It performs the following steps when called:
- 返回 obj.[[Extensible]]。
10.1.4 [[PreventExtensions]] ( )
The [[PreventExtensions]] internal method of 一个
- 返回
OrdinaryPreventExtensions (obj)。
10.1.4.1 OrdinaryPreventExtensions ( obj )
The abstract operation OrdinaryPreventExtensions takes argument obj (an Object) and returns
- 将 obj.[[Extensible]] 设置为
false 。 - 返回
true 。
10.1.5 [[GetOwnProperty]] ( propertyKey )
The [[GetOwnProperty]] internal method of 一个
- 返回
OrdinaryGetOwnProperty (obj, propertyKey)。
10.1.5.1 OrdinaryGetOwnProperty ( obj, propertyKey )
The abstract operation OrdinaryGetOwnProperty takes arguments obj (an Object) and propertyKey (a property key) and returns a
- 如果 obj 没有键为 propertyKey 的自有属性，则返回
undefined 。 - 令 propertyDesc 为一个新创建且不含字段的
Property Descriptor 。 - 令 ownProperty 为 obj 中键为 propertyKey 的自有属性。
- 如果 ownProperty 是
数据属性 ，则- 将 propertyDesc.[[Value]] 设置为 ownProperty 的 [[Value]] 特性的值。
- 将 propertyDesc.[[Writable]] 设置为 ownProperty 的 [[Writable]] 特性的值。
- 否则，
- 断言：ownProperty 是
访问器属性 。 - 将 propertyDesc.[[Get]] 设置为 ownProperty 的 [[Get]] 特性的值。
- 将 propertyDesc.[[Set]] 设置为 ownProperty 的 [[Set]] 特性的值。
- 断言：ownProperty 是
- 将 propertyDesc.[[Enumerable]] 设置为 ownProperty 的 [[Enumerable]] 特性的值。
- 将 propertyDesc.[[Configurable]] 设置为 ownProperty 的 [[Configurable]] 特性的值。
- 返回 propertyDesc。
10.1.6 [[DefineOwnProperty]] ( propertyKey, propertyDesc )
The [[DefineOwnProperty]] internal method of 一个
- 返回 ?
OrdinaryDefineOwnProperty (obj, propertyKey, propertyDesc)。
10.1.6.1 OrdinaryDefineOwnProperty ( obj, propertyKey, propertyDesc )
The abstract operation OrdinaryDefineOwnProperty takes arguments obj (an Object), propertyKey (a property key), and propertyDesc (a
- 令 current 为 ? obj.[[GetOwnProperty]](propertyKey)。
- 令 extensible 为 ?
IsExtensible (obj)。 - 返回
ValidateAndApplyPropertyDescriptor (obj, propertyKey, extensible, propertyDesc, current)。
10.1.6.2 IsCompatiblePropertyDescriptor ( extensible, propertyDesc, current )
The abstract operation IsCompatiblePropertyDescriptor takes arguments extensible (a Boolean), propertyDesc (a
- 返回
ValidateAndApplyPropertyDescriptor (undefined ,"" , extensible, propertyDesc, current)。
10.1.6.3 ValidateAndApplyPropertyDescriptor ( obj, propertyKey, extensible, propertyDesc, current )
The abstract operation ValidateAndApplyPropertyDescriptor takes arguments obj (an Object or
- 断言：propertyKey 是
属性键 。 - 如果 current 是
undefined ，则- 如果 extensible 是
false ，则返回false 。 - 如果 obj 是
undefined ，则返回true 。 - 如果
IsAccessorDescriptor (propertyDesc) 是true ，则 - 否则，
- 返回
true 。
- 如果 extensible 是
- 断言：current 是一个完全填充的
Property Descriptor 。 - 如果 propertyDesc 没有任何字段，则返回
true 。 - 如果 current.[[Configurable]] 是
false ，则- 如果 propertyDesc 具有 [[Configurable]] 字段且 propertyDesc.[[Configurable]] 是
true ，则返回false 。 - 如果 propertyDesc 具有 [[Enumerable]] 字段且 propertyDesc.[[Enumerable]] 不是 current.[[Enumerable]]，则返回
false 。 - 如果
IsGenericDescriptor (propertyDesc) 是false 且IsAccessorDescriptor (propertyDesc) 不是IsAccessorDescriptor (current)，则返回false 。 - 如果
IsAccessorDescriptor (current) 是true ，则 - 否则如果 current.[[Writable]] 是
false ，则
- 如果 propertyDesc 具有 [[Configurable]] 字段且 propertyDesc.[[Configurable]] 是
- 如果 obj 不是
undefined ，则- 如果
IsDataDescriptor (current) 是true 且IsAccessorDescriptor (propertyDesc) 是true ，则- 如果 propertyDesc 具有 [[Configurable]] 字段，则令 configurable 为 propertyDesc.[[Configurable]]；否则令 configurable 为 current.[[Configurable]]。
- 如果 propertyDesc 具有 [[Enumerable]] 字段，则令 enumerable 为 propertyDesc.[[Enumerable]]；否则令 enumerable 为 current.[[Enumerable]]。
- 将对象 obj 的名为 propertyKey 的属性替换为一个
访问器属性 ，其 [[Configurable]] 和 [[Enumerable]] 特性分别被设置为 configurable 和 enumerable，且其 [[Get]] 和 [[Set]] 特性被设置为 propertyDesc 中对应字段的值（如果 propertyDesc 具有该字段），否则设置为该特性的默认值 。
- 否则如果
IsAccessorDescriptor (current) 是true 且IsDataDescriptor (propertyDesc) 是true ，则- 如果 propertyDesc 具有 [[Configurable]] 字段，则令 configurable 为 propertyDesc.[[Configurable]]；否则令 configurable 为 current.[[Configurable]]。
- 如果 propertyDesc 具有 [[Enumerable]] 字段，则令 enumerable 为 propertyDesc.[[Enumerable]]；否则令 enumerable 为 current.[[Enumerable]]。
- 将对象 obj 的名为 propertyKey 的属性替换为一个
数据属性 ，其 [[Configurable]] 和 [[Enumerable]] 特性分别被设置为 configurable 和 enumerable，且其 [[Value]] 和 [[Writable]] 特性被设置为 propertyDesc 中对应字段的值（如果 propertyDesc 具有该字段），否则设置为该特性的默认值 。
- 否则，
- 对 propertyDesc 的每个字段名 fieldName，将对象 obj 的名为 propertyKey 的属性中名为 fieldName 的特性设置为 propertyDesc 的 fieldName 字段的值。
- 如果
- 返回
true 。
10.1.7 [[HasProperty]] ( propertyKey )
The [[HasProperty]] internal method of 一个
- 返回 ?
OrdinaryHasProperty (obj, propertyKey)。
10.1.7.1 OrdinaryHasProperty ( obj, propertyKey )
The abstract operation OrdinaryHasProperty takes arguments obj (an Object) and propertyKey (a property key) and returns either a normal completion containing a Boolean or a throw completion. It performs the following steps when called:
- 令 hasOwn 为 ? obj.[[GetOwnProperty]](propertyKey)。
- 如果 hasOwn 不是
undefined ，则返回true 。 - 令 parent 为 ? obj.[[GetPrototypeOf]]()。
- 如果 parent 不是
null ，则- 返回 ? parent.[[HasProperty]](propertyKey)。
- 返回
false 。
10.1.8 [[Get]] ( propertyKey, receiver )
The [[Get]] internal method of 一个
- 返回 ?
OrdinaryGet (obj, propertyKey, receiver)。
10.1.8.1 OrdinaryGet ( obj, propertyKey, receiver )
The abstract operation OrdinaryGet takes arguments obj (an Object), propertyKey (a property key), and receiver (an ECMAScript language value) and returns either a normal completion containing an ECMAScript language value or a throw completion. It performs the following steps when called:
- 令 propertyDesc 为 ? obj.[[GetOwnProperty]](propertyKey)。
- 如果 propertyDesc 是
undefined ，则- 令 parent 为 ? obj.[[GetPrototypeOf]]()。
- 如果 parent 是
null ，则返回undefined 。 - 返回 ? parent.[[Get]](propertyKey, receiver)。
- 如果
IsDataDescriptor (propertyDesc) 是true ，则返回 propertyDesc.[[Value]]。 - 断言：
IsAccessorDescriptor (propertyDesc) 是true 。 - 令 getter 为 propertyDesc.[[Get]]。
- 如果 getter 是
undefined ，则返回undefined 。 - 返回 ?
Call (getter, receiver)。
10.1.9 [[Set]] ( propertyKey, value, receiver )
The [[Set]] internal method of 一个
- 返回 ?
OrdinarySet (obj, propertyKey, value, receiver)。
10.1.9.1 OrdinarySet ( obj, propertyKey, value, receiver )
The abstract operation OrdinarySet takes arguments obj (an Object), propertyKey (a property key), value (an ECMAScript language value), and receiver (an ECMAScript language value) and returns either a normal completion containing a Boolean or a throw completion. It performs the following steps when called:
- 令 ownDesc 为 ? obj.[[GetOwnProperty]](propertyKey)。
- 返回 ?
OrdinarySetWithOwnDescriptor (obj, propertyKey, value, receiver, ownDesc)。
10.1.9.2 OrdinarySetWithOwnDescriptor ( obj, propertyKey, value, receiver, ownDesc )
The abstract operation OrdinarySetWithOwnDescriptor takes arguments obj (an Object), propertyKey (a property key), value (an ECMAScript language value), receiver (an ECMAScript language value), and ownDesc (a
- 如果 ownDesc 是
undefined ，则- 令 parent 为 ? obj.[[GetPrototypeOf]]()。
- 如果 parent 不是
null ，则返回 ? parent.[[Set]](propertyKey, value, receiver)。 - 将 ownDesc 设置为 PropertyDescriptor { [[Value]]:
undefined , [[Writable]]:true , [[Enumerable]]:true , [[Configurable]]:true }。
- 如果
IsDataDescriptor (ownDesc) 是true ，则- 如果 ownDesc.[[Writable]] 是
false ，则返回false 。 - 如果 receiver 不是 Object，则返回
false 。 - 令 existingDesc 为 ? receiver.[[GetOwnProperty]](propertyKey)。
- 如果 existingDesc 是
undefined ，则- 断言：receiver 当前没有属性 propertyKey。
- 返回 ?
CreateDataProperty (receiver, propertyKey, value)。
- 如果
IsAccessorDescriptor (existingDesc) 是true ，则返回false 。 - 如果 existingDesc.[[Writable]] 是
false ，则返回false 。 - 令 valueDesc 为 PropertyDescriptor { [[Value]]: value }。
- 返回 ? receiver.[[DefineOwnProperty]](propertyKey, valueDesc)。
- 如果 ownDesc.[[Writable]] 是
- 断言：
IsAccessorDescriptor (ownDesc) 是true 。 - 令 setter 为 ownDesc.[[Set]]。
- 如果 setter 是
undefined ，则返回false 。 - 执行 ?
Call (setter, receiver, « value »)。 - 返回
true 。
10.1.10 [[Delete]] ( propertyKey )
The [[Delete]] internal method of 一个
- 返回 ?
OrdinaryDelete (obj, propertyKey)。
10.1.10.1 OrdinaryDelete ( obj, propertyKey )
The abstract operation OrdinaryDelete takes arguments obj (an Object) and propertyKey (a property key) and returns either a normal completion containing a Boolean or a throw completion. It performs the following steps when called:
- 令 propertyDesc 为 ? obj.[[GetOwnProperty]](propertyKey)。
- 如果 propertyDesc 是
undefined ，则返回true 。 - 如果 propertyDesc.[[Configurable]] 是
true ，则- 从 obj 中移除名称为 propertyKey 的自有属性。
- 返回
true 。
- 返回
false 。
10.1.11 [[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of 一个
- 返回
OrdinaryOwnPropertyKeys (obj)。
10.1.11.1 OrdinaryOwnPropertyKeys ( obj )
The abstract operation OrdinaryOwnPropertyKeys takes argument obj (an Object) and returns a
- 令 keys 为一个新的空
List 。 - 对 obj 的每个自有
属性键 propertyKey，如果 propertyKey 是数组索引 ，则按升序数值索引顺序，执行：- 将 propertyKey 追加到 keys。
- 对 obj 的每个自有
属性键 propertyKey，如果 propertyKey 是 String 且 propertyKey 不是数组索引 ，则按属性创建的升序时间顺序，执行：- 将 propertyKey 追加到 keys。
- 对 obj 的每个自有
属性键 propertyKey，如果 propertyKey 是 Symbol，则按属性创建的升序时间顺序，执行：- 将 propertyKey 追加到 keys。
- 返回 keys。
10.1.12 OrdinaryObjectCreate ( proto [ , additionalInternalSlotsList ] )
The abstract operation OrdinaryObjectCreate takes argument proto (an Object or
- 令 internalSlotsList 为 « [[Prototype]], [[Extensible]] »。
- 如果 additionalInternalSlotsList 存在，则将 internalSlotsList 设置为 internalSlotsList 和 additionalInternalSlotsList 的
列表连接 。 - 令 obj 为
MakeBasicObject (internalSlotsList)。 - 将 obj.[[Prototype]] 设置为 proto。
- 返回 obj。
尽管 OrdinaryObjectCreate 几乎只是调用
10.1.13 OrdinaryCreateFromConstructor ( ctor, intrinsicDefaultProto [ , internalSlotsList ] )
The abstract operation OrdinaryCreateFromConstructor takes arguments ctor (a function object) and intrinsicDefaultProto (a String) and optional argument internalSlotsList (a
- 断言：intrinsicDefaultProto 是本规范中某个固有对象的名称。对应对象必须是预期用作对象 [[Prototype]] 值的固有对象。
- 令 proto 为 ?
GetPrototypeFromConstructor (ctor, intrinsicDefaultProto)。 - 如果 internalSlotsList 存在，则令 slots 为 internalSlotsList。
- 否则，令 slots 为一个新的空
List 。 - 返回
OrdinaryObjectCreate (proto, slots)。
10.1.14 GetPrototypeFromConstructor ( ctor, intrinsicDefaultProto )
The abstract operation GetPrototypeFromConstructor takes arguments ctor (a function object) and intrinsicDefaultProto (a String) and returns either a normal completion containing an Object or a throw completion. 它确定应当用于创建与特定
- 断言：intrinsicDefaultProto 是本规范中某个固有对象的名称。对应对象必须是预期用作对象 [[Prototype]] 值的固有对象。
- 令 proto 为 ?
Get (ctor,"prototype" )。 - 如果 proto 不是 Object，则
- 令 realm 为 ?
GetFunctionRealm (ctor)。 - 将 proto 设置为 realm 中名为 intrinsicDefaultProto 的固有对象。
- 令 realm 为 ?
- 返回 proto。
如果 ctor 不提供 [[Prototype]] 值，则所使用的默认值从 ctor 函数的
10.1.15 RequireInternalSlot ( obj, internalSlot )
The abstract operation RequireInternalSlot takes arguments obj (an ECMAScript language value) and internalSlot (an internal slot name) and returns either a normal completion containing
- 如果 obj 不是 Object，则抛出
TypeError 异常。 - 如果 obj 没有 internalSlot 内部槽，则抛出
TypeError 异常。 - 返回
unused 。
10.2 ECMAScript 函数对象
ECMAScript
除了 [[Extensible]] 和 [[Prototype]] 之外，ECMAScript
| 内部槽 | 类型 | 描述 |
|---|---|---|
| [[Environment]] |
an |
函数闭合于其上的 |
| [[PrivateEnvironment]] |
a |
函数闭合于其上的、用于 |
| [[FormalParameters]] |
a |
定义该函数形式参数列表的源文本的根解析节点。 |
| [[ECMAScriptCode]] |
a |
定义该函数体的源文本的根解析节点。 |
| [[ConstructorKind]] |
|
该函数是否为派生类 |
| [[Realm]] |
a |
函数被创建所在的 |
| [[ScriptOrModule]] |
a |
函数被创建所在的脚本或模块。 |
| [[ThisMode]] |
|
定义如何解释该函数的形式参数和代码体内的 this 引用。this 引用词法包围函数的 |
| [[Strict]] | a Boolean |
如果这是 |
| [[HomeObject]] |
an Object or |
如果该函数使用 super，则这是一个对象，其 [[GetPrototypeOf]] 提供 super 属性查找开始所在的对象。
|
| [[SourceText]] | a sequence of Unicode code points |
定义该函数的 |
| [[Fields]] |
a |
如果该函数是一个类，则这是表示该类的非静态字段及对应初始化器的 |
| [[PrivateMethods]] |
a |
如果该函数是一个类，则这是表示该类的非静态私有方法和访问器的列表。 |
| [[ClassFieldInitializerName]] |
a String, a Symbol, a |
如果该函数作为类字段的初始化器创建，则为该字段的 |
| [[IsClassConstructor]] | a Boolean |
指示该函数是否为类 |
所有 ECMAScript
10.2.1 [[Call]] ( thisArg, argList )
The [[Call]] internal method of an ECMAScript function object func takes arguments thisArg (an ECMAScript language value) and argList (a
- 令 callerContext 为运行中执行上下文。
- 令 calleeContext 为
PrepareForOrdinaryCall (func,undefined )。 - 断言：calleeContext 现在是运行中执行上下文。
- 如果 func.[[IsClassConstructor]] 是
true ，则- 令 error 为新创建的
TypeError 对象。 - 注：error 在 calleeContext 中、使用 func 的关联
Realm Record 创建。 - 从执行上下文栈中移除 calleeContext，并将 callerContext 恢复为运行中执行上下文。
- 抛出 error。
- 令 error 为新创建的
- 执行
OrdinaryCallBindThis (func, calleeContext, thisArg)。 - 令 result 为
Completion (OrdinaryCallEvaluateBody (func, argList))。 - 从执行上下文栈中移除 calleeContext，并将 callerContext 恢复为运行中执行上下文。
- 如果 result 是 return completion，则返回 result.[[Value]]。
- 断言：result 是 throw completion。
- 返回 ? result。
当 calleeContext 在步骤
10.2.1.1 PrepareForOrdinaryCall ( func, newTarget )
The abstract operation PrepareForOrdinaryCall takes arguments func (an ECMAScript function object) and newTarget (an Object or
- 令 callerContext 为运行中执行上下文。
- 令 calleeContext 为新的
ECMAScript 代码执行上下文 。 - 将 calleeContext 的 Function 设置为 func。
- 令 calleeRealm 为 func.[[Realm]]。
- 将 calleeContext 的
Realm 设置为 calleeRealm。 - 将 calleeContext 的 ScriptOrModule 设置为 func.[[ScriptOrModule]]。
- 令 localEnv 为
NewFunctionEnvironment (func, newTarget)。 - 将 calleeContext 的 LexicalEnvironment 设置为 localEnv。
- 将 calleeContext 的 VariableEnvironment 设置为 localEnv。
- 将 calleeContext 的 PrivateEnvironment 设置为 func.[[PrivateEnvironment]]。
- 如果 callerContext 尚未暂停，则暂停 callerContext。
- 将 calleeContext 压入执行上下文栈；calleeContext 现在是运行中执行上下文。
- 注：此点之后产生的任何异常对象都与 calleeRealm 相关联。
- 返回 calleeContext。
10.2.1.2 OrdinaryCallBindThis ( func, calleeContext, thisArg )
The abstract operation OrdinaryCallBindThis takes arguments func (an ECMAScript function object), calleeContext (an
- 令 thisMode 为 func.[[ThisMode]]。
- 如果 thisMode 是
lexical ，则返回unused 。 - 令 calleeRealm 为 func.[[Realm]]。
- 令 localEnv 为 calleeContext 的 LexicalEnvironment。
- 如果 thisMode 是
strict ，则- 令 thisValue 为 thisArg。
- 否则，
- 如果 thisArg 是
undefined 或null ，则- 令 globalEnv 为 calleeRealm.[[GlobalEnv]]。
- 断言：globalEnv 是
Global Environment Record 。 - 令 thisValue 为 globalEnv.[[GlobalThisValue]]。
- 否则，
- 如果 thisArg 是
- 断言：localEnv 是
Function Environment Record 。 - 断言：下一步绝不会返回 abrupt completion，因为 localEnv.[[ThisBindingStatus]] 不是
initialized 。 - 执行 !
BindThisValue (localEnv, thisValue)。 - 返回
unused 。
10.2.1.3 Runtime Semantics: EvaluateBody
The syntax-directed operation EvaluateBody takes arguments func (an ECMAScript function object) and argList (a
- 返回 ?
FunctionBody 带实参 func 和 argList 的EvaluateFunctionBody 。
- 返回 ?
ConciseBody 带实参 func 和 argList 的EvaluateConciseBody 。
- 返回 ?
GeneratorBody 带实参 func 和 argList 的EvaluateGeneratorBody 。
- 返回 ?
AsyncGeneratorBody 带实参 func 和 argList 的EvaluateAsyncGeneratorBody 。
- 返回 ?
AsyncFunctionBody 带实参 func 和 argList 的EvaluateAsyncFunctionBody 。
- 返回 ?
AsyncConciseBody 带实参 func 和 argList 的EvaluateAsyncConciseBody 。
- 断言：argList 为空。
- 断言：func.[[ClassFieldInitializerName]] 不是
empty 。 - 如果
IsAnonymousFunctionDefinition (AssignmentExpression ) 是true ，则- 令 value 为 ?
Initializer 带实参 func.[[ClassFieldInitializerName]] 的NamedEvaluation 。
- 令 value 为 ?
- 否则，
- 令 rhs 为 ?
AssignmentExpression 的Evaluation 。 - 令 value 为 ?
GetValue (rhs)。
- 令 rhs 为 ?
- 返回
ReturnCompletion (value)。
即使字段初始化器构成函数边界，调用
- 断言：argList 为空。
- 返回 ?
ClassStaticBlockBody 带实参 func 的EvaluateClassStaticBlockBody 。
10.2.1.4 OrdinaryCallEvaluateBody ( func, argList )
The abstract operation OrdinaryCallEvaluateBody takes arguments func (an ECMAScript function object) and argList (a
- 返回 ? func.[[ECMAScriptCode]] 带实参 func 和 argList 的
EvaluateBody 。
10.2.2 [[Construct]] ( argList, newTarget )
The [[Construct]] internal method of an ECMAScript function object func takes arguments argList (a
- 令 callerContext 为运行中执行上下文。
- 令 kind 为 func.[[ConstructorKind]]。
- 如果 kind 是
base ，则- 令 thisArg 为 ?
OrdinaryCreateFromConstructor (newTarget,"%Object.prototype%" )。
- 令 thisArg 为 ?
- 令 calleeContext 为
PrepareForOrdinaryCall (func, newTarget)。 - 断言：calleeContext 现在是运行中执行上下文。
- 如果 kind 是
base ，则- 执行
OrdinaryCallBindThis (func, calleeContext, thisArg)。 - 令 initializeResult 为
Completion (InitializeInstanceElements (thisArg, func))。 - 如果 initializeResult 是 abrupt completion，则
- 从执行上下文栈中移除 calleeContext，并将 callerContext 恢复为运行中执行上下文。
- 返回 ? initializeResult。
- 执行
- 令 ctorEnv 为 calleeContext 的 LexicalEnvironment。
- 令 result 为
Completion (OrdinaryCallEvaluateBody (func, argList))。 - 从执行上下文栈中移除 calleeContext，并将 callerContext 恢复为运行中执行上下文。
- 如果 result 是 throw completion，则
- 返回 ? result。
- 断言：result 是 return completion。
- 如果 result.[[Value]] 是 Object，则返回 result.[[Value]]。
- 如果 kind 是
base ，则返回 thisArg。 - 如果 result.[[Value]] 不是
undefined ，则抛出TypeError 异常。 - 令 thisBinding 为 ? ctorEnv.
GetThisBinding ()。 - 断言：thisBinding 是 Object。
- 返回 thisBinding。
10.2.3 OrdinaryFunctionCreate ( proto, sourceText, paramList, body, thisMode, envRecord, privateEnv )
The abstract operation OrdinaryFunctionCreate takes arguments proto (an Object), sourceText (a sequence of Unicode code points), paramList (a
- 令 internalSlotsList 为
Table 26 中列出的内部槽。 - 令 func 为
OrdinaryObjectCreate (proto, internalSlotsList)。 - 将 func.[[Call]] 设置为
10.2.1 中指定的定义。 - 将 func.[[SourceText]] 设置为 sourceText。
- 将 func.[[FormalParameters]] 设置为 paramList。
- 将 func.[[ECMAScriptCode]] 设置为 body。
- 令 strict 为
IsStrict (body)。 - 将 func.[[Strict]] 设置为 strict。
- 如果 thisMode 是
lexical-this ，则将 func.[[ThisMode]] 设置为lexical 。 - 否则如果 strict 是
true ，则将 func.[[ThisMode]] 设置为strict 。 - 否则，将 func.[[ThisMode]] 设置为
global 。 - 将 func.[[IsClassConstructor]] 设置为
false 。 - 将 func.[[Environment]] 设置为 envRecord。
- 将 func.[[PrivateEnvironment]] 设置为 privateEnv。
- 将 func.[[ScriptOrModule]] 设置为
GetActiveScriptOrModule ()。 - 将 func.[[Realm]] 设置为
当前 Realm Record 。 - 将 func.[[HomeObject]] 设置为
undefined 。 - 将 func.[[Fields]] 设置为一个新的空
List 。 - 将 func.[[PrivateMethods]] 设置为一个新的空
List 。 - 将 func.[[ClassFieldInitializerName]] 设置为
empty 。 - 令 length 为 paramList 的
ExpectedArgumentCount 。 - 执行
SetFunctionLength (func, length)。 - 返回 func。
10.2.4 AddRestrictedFunctionProperties ( func, realm )
The abstract operation AddRestrictedFunctionProperties takes arguments func (a function object) and realm (a
- 断言：realm.[[Intrinsics]].[[
%ThrowTypeError% ]] 存在且已被初始化。 - 令 thrower 为 realm.[[Intrinsics]].[[
%ThrowTypeError% ]]。 - 执行 !
DefinePropertyOrThrow (func,"caller" , PropertyDescriptor { [[Get]]: thrower, [[Set]]: thrower, [[Enumerable]]:false , [[Configurable]]:true })。 - 执行 !
DefinePropertyOrThrow (func,"arguments" , PropertyDescriptor { [[Get]]: thrower, [[Set]]: thrower, [[Enumerable]]:false , [[Configurable]]:true })。 - 返回
unused 。
10.2.4.1 %ThrowTypeError% ( )
此函数是 %ThrowTypeError% 固有对象。
它在被调用时执行以下步骤：
- 抛出
TypeError 异常。
此函数的 [[Extensible]] 内部槽的值为
此函数的
此函数的
10.2.5 MakeConstructor ( func [ , writableProto [ , proto ] ] )
The abstract operation MakeConstructor takes argument func (an ECMAScript function object or a built-in function object) and optional arguments writableProto (a Boolean) and proto (an Object) and returns
- 如果 func 是 ECMAScript
函数对象 ，则- 断言：
IsConstructor (func) 是false 。 - 断言：func 是一个可扩展对象，且没有
"prototype" 自有属性。 - 将 func.[[Construct]] 设置为
10.2.2 中指定的定义。
- 断言：
- 否则，
- 将 func.[[Construct]] 设置为
10.3.2 中指定的定义。
- 将 func.[[Construct]] 设置为
- 将 func.[[ConstructorKind]] 设置为
base 。 - 如果 writableProto 不存在，则将 writableProto 设置为
true 。 - 如果 proto 不存在，则
- 将 proto 设置为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 !
DefinePropertyOrThrow (proto,"constructor" , PropertyDescriptor { [[Value]]: func, [[Writable]]: writableProto, [[Enumerable]]:false , [[Configurable]]:true })。
- 将 proto 设置为
- 执行 !
DefinePropertyOrThrow (func,"prototype" , PropertyDescriptor { [[Value]]: proto, [[Writable]]: writableProto, [[Enumerable]]:false , [[Configurable]]:false })。 - 返回
unused 。
10.2.6 MakeClassConstructor ( func )
The abstract operation MakeClassConstructor takes argument func (an ECMAScript function object) and returns
- 断言：func.[[IsClassConstructor]] 是
false 。 - 将 func.[[IsClassConstructor]] 设置为
true 。 - 返回
unused 。
10.2.7 MakeMethod ( func, homeObj )
The abstract operation MakeMethod takes arguments func (an ECMAScript function object) and homeObj (an Object) and returns
- 断言：homeObj 是
普通对象 。 - 将 func.[[HomeObject]] 设置为 homeObj。
- 返回
unused 。
10.2.8 DefineMethodProperty ( homeObj, name, closure, enumerable )
The abstract operation DefineMethodProperty takes arguments homeObj (an Object), name (a property key or
- 断言：homeObj 是普通的、可扩展的对象。
- 如果 name 是
Private Name ，则返回PrivateElement { [[Key]]: name, [[Kind]]:method , [[Value]]: closure }。 - 令 propertyDesc 为 PropertyDescriptor { [[Value]]: closure, [[Writable]]:
true , [[Enumerable]]: enumerable, [[Configurable]]:true }。 - 执行 ?
DefinePropertyOrThrow (homeObj, name, propertyDesc)。 - 注：
DefinePropertyOrThrow 仅在尝试定义 name 为"prototype" 的类静态方法时返回 abrupt completion。 - 返回
unused 。
10.2.9 SetFunctionName ( func, name [ , prefix ] )
The abstract operation SetFunctionName takes arguments func (a function object) and name (a property key or
- 断言：func 是可扩展对象，且没有
"name" 自有属性。 - 如果 name 是 Symbol，则
- 令 description 为 name.[[Description]]。
- 如果 description 是
undefined ，则将 name 设置为空 String。 - 否则，将 name 设置为
"[" 、description 和"]" 的字符串连接 。
- 否则如果 name 是
Private Name ，则- 将 name 设置为 name.[[Description]]。
- 如果 func 具有 [[InitialName]] 内部槽，则
- 将 func.[[InitialName]] 设置为 name。
- 如果 prefix 存在，则
- 执行 !
DefinePropertyOrThrow (func,"name" , PropertyDescriptor { [[Value]]: name, [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:true })。 - 返回
unused 。
10.2.10 SetFunctionLength ( func, length )
The abstract operation SetFunctionLength takes arguments func (a function object) and length (a non-negative
- 断言：func 是可扩展对象，且没有
"length" 自有属性。 - 执行 !
DefinePropertyOrThrow (func,"length" , PropertyDescriptor { [[Value]]:𝔽 (length), [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:true })。 - 返回
unused 。
10.2.11 FunctionDeclarationInstantiation ( func, argList )
The abstract operation FunctionDeclarationInstantiation takes arguments func (an ECMAScript function object) and argList (a
当为求值 ECMAScript 函数建立执行上下文时，会创建新的
它在被调用时执行以下步骤：
- 令 calleeContext 为正在运行的执行上下文。
- 令 code 为 func.[[ECMAScriptCode]]。
- 令 strict 为 func.[[Strict]]。
- 令 formals 为 func.[[FormalParameters]]。
- 令 paramNames 为 formals 的
BoundNames 。 - 如果 paramNames 有任何重复条目，令 hasDuplicates 为
true ；否则令 hasDuplicates 为false 。 - 令 simpleParamList 为 formals 的
IsSimpleParameterList 。 - 令 hasParamExprs 为 formals 的
ContainsExpression 。 - 令 variableNames 为 code 的
VarDeclaredNames 。 - 令 variableDecls 为 code 的
VarScopedDeclarations 。 - 令 lexicalNames 为 code 的
LexicallyDeclaredNames 。 - 令 funcNames 为一个新的空
List 。 - 令 funcsToInitialize 为一个新的空
List 。 - 对 variableDecls 的每个元素 variableDecl，按
List 的逆序执行：- 如果 variableDecl 既不是
VariableDeclaration 、也不是ForBinding 、也不是BindingIdentifier ，则- 断言：variableDecl 是
FunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 或AsyncGeneratorDeclaration 。 - 令 funcName 为 variableDecl 的
BoundNames 的唯一元素。 - 如果 funcNames 不
包含 funcName，则- 将 funcName 作为 funcNames 的第一个元素插入。
- 注：如果同一名称有多个函数声明，则使用最后一个声明。
- 将 variableDecl 作为 funcsToInitialize 的第一个元素插入。
- 断言：variableDecl 是
- 如果 variableDecl 既不是
- 令 argumentsObjNeeded 为
true 。 - 如果 func.[[ThisMode]] 是
lexical ，则- 注：箭头函数永远没有 arguments 对象。
- 将 argumentsObjNeeded 设为
false 。
- 否则，如果 paramNames
包含 "arguments" ，则- 将 argumentsObjNeeded 设为
false 。
- 将 argumentsObjNeeded 设为
- 否则，如果 hasParamExprs 为
false ，则 - 如果 strict 为
true 或 hasParamExprs 为false ，则- 注：参数只需要一个
Environment Record ，因为严格模式代码中对eval的调用不能创建在eval外部可见的新绑定。 - 令 envRecord 为 calleeContext 的 LexicalEnvironment。
- 注：参数只需要一个
- 否则，
- 注：需要一个单独的
Environment Record ，以确保在形式参数列表中的直接 eval 调用所创建的绑定位于声明参数的环境之外。 - 令 calleeEnv 为 calleeContext 的 LexicalEnvironment。
- 令 envRecord 为
NewDeclarativeEnvironment (calleeEnv)。 - 断言：calleeContext 的 VariableEnvironment 与 calleeEnv 是同一个
Environment Record 。 - 将 calleeContext 的 LexicalEnvironment 设为 envRecord。
- 注：需要一个单独的
- 对 paramNames 的每个 String paramName，执行：
- 令 alreadyDeclared 为 ! envRecord.
HasBinding (paramName)。 - 注：
早期错误 确保重复的参数名称只能出现在没有参数默认值或剩余参数的非严格函数 中。 - 如果 alreadyDeclared 为
false ，则- 执行 ! envRecord.
CreateMutableBinding (paramName,false )。 - 如果 hasDuplicates 为
true ，则- 执行 ! envRecord.
InitializeBinding (paramName,undefined )。
- 执行 ! envRecord.
- 执行 ! envRecord.
- 令 alreadyDeclared 为 ! envRecord.
- 如果 argumentsObjNeeded 为
true ，则- 如果 strict 为
true 或 simpleParamList 为false ，则- 令 argumentsObj 为
CreateUnmappedArgumentsObject (argList)。
- 令 argumentsObj 为
- 否则，
- 注：映射 arguments 对象只为没有 rest 参数、任何参数默认值初始化器或任何解构参数的
非严格函数 提供。 - 令 argumentsObj 为
CreateMappedArgumentsObject (func, formals, argList, envRecord)。
- 注：映射 arguments 对象只为没有 rest 参数、任何参数默认值初始化器或任何解构参数的
- 如果 strict 为
true ，则- 执行 ! envRecord.
CreateImmutableBinding ("arguments" ,false )。 - 注：在严格模式代码中，
早期错误 会阻止尝试向此绑定赋值，因此其可变性不可观察。
- 执行 ! envRecord.
- 否则，
- 执行 ! envRecord.
CreateMutableBinding ("arguments" ,false )。
- 执行 ! envRecord.
- 执行 ! envRecord.
InitializeBinding ("arguments" , argumentsObj)。 - 令 paramBindings 为 paramNames 与 «
"arguments" » 的列表连接 。
- 如果 strict 为
- 否则，
- 令 paramBindings 为 paramNames。
- 令 iteratorRecord 为
CreateListIteratorRecord (argList)。 - 如果 hasDuplicates 为
true ，则- 令 usedEnv 为
undefined 。
- 令 usedEnv 为
- 否则，
- 令 usedEnv 为 envRecord。
- 注：以下步骤不能返回
ReturnCompletion ，因为这种完成在表达式位置出现的唯一方式是使用YieldExpression ，而早期错误 规则在15.5.1 和15.6.1 中禁止其出现在参数列表中。 - 使用参数 iteratorRecord 和 usedEnv 执行 ? formals 的
IteratorBindingInitialization 。 - 如果 hasParamExprs 为
false ，则- 注：参数和顶层 vars 只需要一个
Environment Record 。 - 令 instantiatedVariableNames 为
List paramBindings 的副本。 - 对 variableNames 的每个元素 name，执行：
- 如果 instantiatedVariableNames 不
包含 name，则- 将 name 追加到 instantiatedVariableNames。
- 执行 ! envRecord.
CreateMutableBinding (name,false )。 - 执行 ! envRecord.
InitializeBinding (name,undefined )。
- 如果 instantiatedVariableNames 不
- 令 variableEnv 为 envRecord。
- 注：参数和顶层 vars 只需要一个
- 否则，
- 注：需要一个单独的
Environment Record ，以确保由形式参数列表中的表达式创建的闭包看不到函数体中的声明。 - 令 variableEnv 为
NewDeclarativeEnvironment (envRecord)。 - 将 calleeContext 的 VariableEnvironment 设为 variableEnv。
- 令 instantiatedVariableNames 为一个新的空
List 。 - 对 variableNames 的每个元素 name，执行：
- 如果 instantiatedVariableNames 不
包含 name，则- 将 name 追加到 instantiatedVariableNames。
- 执行 ! variableEnv.
CreateMutableBinding (name,false )。 - 如果 paramBindings 不
包含 name 或 funcNames包含 name，则- 令 initialValue 为
undefined 。
- 令 initialValue 为
- 否则，
- 令 initialValue 为 ! envRecord.
GetBindingValue (name,false )。
- 令 initialValue 为 ! envRecord.
- 执行 ! variableEnv.
InitializeBinding (name, initialValue)。 - 注：与形式参数同名的 var 最初具有与相应已初始化参数相同的值。
- 如果 instantiatedVariableNames 不
- 注：需要一个单独的
- 如果 strict 为
true ，则- 令 lexicalEnv 为 variableEnv。
- 否则，
- 如果
宿主 是 Web 浏览器，或以其他方式支持块级函数声明的 Web 遗留兼容性语义 ，则- 对每个
FunctionDeclaration funcDecl，其直接包含 在任何Block 、CaseClause 或DefaultClause x 的StatementList 中，且 codeContains x 为true ，执行：- 令 funcName 为 funcDecl 的
BindingIdentifier 的StringValue 。 - 如果将
FunctionDeclaration funcDecl 替换为以 funcName 作为BindingIdentifier 的VariableStatement 不会为 func 产生任何早期错误 ，并且 paramNames 不包含 funcName，则- 注：只有当 funcName 既不是 VarDeclaredName、形式参数名称，也不是另一个
FunctionDeclaration 的名称时，才在此处实例化 funcName 的 var 绑定。 - 如果 instantiatedVariableNames 不
包含 funcName 且 funcName 不是"arguments" ，则- 执行 ! variableEnv.
CreateMutableBinding (funcName,false )。 - 执行 ! variableEnv.
InitializeBinding (funcName,undefined )。 - 将 funcName 追加到 instantiatedVariableNames。
- 执行 ! variableEnv.
- 当
FunctionDeclaration funcDecl 被求值时，执行以下步骤以取代15.2.6 中提供的FunctionDeclaration Evaluation 算法：- 令 funcEnv 为正在运行的执行上下文的 VariableEnvironment。
- 令 blockEnv 为正在运行的执行上下文的 LexicalEnvironment。
- 令 funcObj 为 ! blockEnv.
GetBindingValue (funcName,false )。 - 执行 ! funcEnv.
SetMutableBinding (funcName, funcObj,false )。 - 返回
unused 。
- 注：只有当 funcName 既不是 VarDeclaredName、形式参数名称，也不是另一个
- 令 funcName 为 funcDecl 的
- 对每个
- 令 lexicalEnv 为
NewDeclarativeEnvironment (variableEnv)。 - 注：
非严格函数 为顶层词法声明使用单独的Environment Record ，使得直接 eval 可以确定 eval 代码引入的任何 var 作用域声明是否与既有的顶层词法作用域声明冲突。严格函数 不需要这样做，因为严格的直接 eval 总是将所有声明放入新的Environment Record 。
- 如果
- 将 calleeContext 的 LexicalEnvironment 设为 lexicalEnv。
- 令 lexicalDecls 为 code 的
LexicallyScopedDeclarations 。 - 对 lexicalDecls 的每个元素 lexicalDecl，执行：
- 注：词法声明的名称不能与函数/生成器声明、形式参数或 var 名称相同。词法声明的名称仅在此处实例化，但不初始化。
- 对 lexicalDecl 的
BoundNames 的每个元素 name，执行：- 如果 lexicalDecl 的
IsConstantDeclaration 为true ，则- 执行 ! lexicalEnv.
CreateImmutableBinding (name,true )。
- 执行 ! lexicalEnv.
- 否则，
- 执行 ! lexicalEnv.
CreateMutableBinding (name,false )。
- 执行 ! lexicalEnv.
- 如果 lexicalDecl 的
- 令 privateEnv 为 calleeContext 的 PrivateEnvironment。
- 对 funcsToInitialize 的每个
Parse Node funcDecl，执行：- 令 funcName 为 funcDecl 的
BoundNames 的唯一元素。 - 令 funcObj 为使用参数 lexicalEnv 和 privateEnv 对 funcDecl 执行
InstantiateFunctionObject 的结果。 - 执行 ! variableEnv.
SetMutableBinding (funcName, funcObj,false )。
- 令 funcName 为 funcDecl 的
- 返回
unused 。
10.3 内置函数对象
内置
除了每个
- [[Realm]]，一个
Realm Record ，表示该函数被创建所在的realm 。 - [[InitialName]]，一个 String，是该函数的初始名称。它由
20.2.3.5 使用。 - [[Async]]，一个 Boolean，指示该函数在
BuiltinCallOrConstruct 中是否具有 async 函数调用和构造行为。
除非另有指定，内置
内置
当且仅当内置
实现可以提供本规范未定义的附加内置
10.3.1 [[Call]] ( thisArg, argList )
The [[Call]] internal method of a built-in function object func takes arguments thisArg (an ECMAScript language value) and argList (a
- 返回 ?
BuiltinCallOrConstruct (func, thisArg, argList,undefined )。
10.3.2 [[Construct]] ( argList, newTarget )
The [[Construct]] internal method of a built-in function object func（当该方法存在时） takes arguments argList (a
- 令 result 为 ?
BuiltinCallOrConstruct (func,uninitialized , argList, newTarget)。 - 断言：result 是 Object。
- 返回 result。
10.3.3 BuiltinCallOrConstruct ( func, thisArg, argList, newTarget )
The abstract operation BuiltinCallOrConstruct takes arguments func (a built-in function object), thisArg (an ECMAScript language value or
- 令 callerContext 为运行中执行上下文。
- 如果 callerContext 尚未暂停，则暂停 callerContext。
- 令 calleeContext 为一个新的执行上下文。
- 将 calleeContext 的 Function 设置为 func。
- 令 calleeRealm 为 func.[[Realm]]。
- 将 calleeContext 的
Realm 设置为 calleeRealm。 - 将 calleeContext 的 ScriptOrModule 设置为
null 。 - 执行 calleeContext 的任何必要的实现定义初始化。
- 将 calleeContext 压入执行上下文栈；calleeContext 现在是运行中执行上下文。
- 如果 func.[[Async]] 是
true ，则- 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 resultsClosure 为一个不带形参的新
Abstract Closure ，它捕获 func、thisArg、argList 和 newTarget，并在被调用时执行以下步骤：- 令 result 为
Completion Record ，其是以符合 func 规范的方式求值 func 的结果。如果 thisArg 是uninitialized ，则this 值未初始化；否则 thisArg 提供this 值。argList 提供命名形参。newTarget 提供 NewTarget 值。 - 注：如果 func 在本文档中定义，则“func 的规范”是通过算法步骤或其他方式为其指定的行为。
- 返回
Completion (result)。
- 令 result 为
- 执行
AsyncFunctionStart (promiseCapability, resultsClosure)。 - 从执行上下文栈中移除 calleeContext，并将 callerContext 恢复为运行中执行上下文。
- 返回 promiseCapability.[[Promise]]。
- 令 promiseCapability 为 !
- 令 result 为
Completion Record ，其是以符合 func 规范的方式求值 func 的结果。如果 thisArg 是uninitialized ，则this 值未初始化；否则 thisArg 提供this 值。argList 提供命名形参。newTarget 提供 NewTarget 值。 - 注：如果 func 在本文档中定义，则“func 的规范”是通过算法步骤或其他方式为其指定的行为。
- 从执行上下文栈中移除 calleeContext，并将 callerContext 恢复为运行中执行上下文。
- 返回 ? result。
当 calleeContext 从执行上下文栈中移除时，如果它已暂停并被可访问的 Generator 保留以供稍后恢复，则不得销毁它。
10.3.4 CreateBuiltinFunction ( behaviour, length, name, additionalInternalSlotsList [ , realm [ , proto [ , prefix [ , async ] ] ] ] )
The abstract operation CreateBuiltinFunction takes arguments behaviour (an
- 如果 realm 不存在，则将 realm 设置为
当前 Realm Record 。 - 如果 proto 不存在，则将 proto 设置为 realm.[[Intrinsics]].[[
%Function.prototype% ]]。 - 如果 async 不存在，则将 async 设置为
false 。 - 令 internalSlotsList 为一个
List ，其中包含 10.3 对即将创建的内置函数对象 所要求的所有内部槽的名称。 - 将 additionalInternalSlotsList 的元素追加到 internalSlotsList。
- 令 func 为一个新的内置
函数对象 ，当被调用时，它使用所提供实参作为 behaviour 指定的相应形参的值，执行 behaviour 描述的动作。新的函数对象 具有名称为 internalSlotsList 元素的内部槽，以及一个 [[InitialName]] 内部槽。 - 将 func.[[Async]] 设置为 async。
- 将 func.[[Prototype]] 设置为 proto。
- 将 func.[[Extensible]] 设置为
true 。 - 将 func.[[Realm]] 设置为 realm。
- 将 func.[[InitialName]] 设置为
null 。 - 执行
SetFunctionLength (func, length)。 - 如果 prefix 不存在，则
- 执行
SetFunctionName (func, name)。
- 执行
- 否则，
- 执行
SetFunctionName (func, name, prefix)。
- 执行
- 返回 func。
本规范中定义的每个内置函数都是通过调用 CreateBuiltinFunction
10.4 内置异质对象内部方法与内部槽
本规范定义了若干种内置
10.4.1 绑定函数异质对象
如果一个对象的 [[Call]] 和（如果适用）[[Construct]] 内部方法使用以下实现，且其其他基本内部方法使用
| 内部槽 | 类型 | 描述 |
|---|---|---|
| [[BoundTargetFunction]] | a callable Object |
被包装的 |
| [[BoundThis]] | an ECMAScript language value |
调用被包装函数时始终作为 |
| [[BoundArguments]] |
a |
一个值列表，其元素用作对被包装函数的任何调用的最前面的实参。 |
10.4.1.1 [[Call]] ( thisArg, argList )
The [[Call]] internal method of a bound function exotic object func takes arguments thisArg (an ECMAScript language value) and argList (a
10.4.1.2 [[Construct]] ( argList, newTarget )
The [[Construct]] internal method of a bound function exotic object func takes arguments argList (a
- 令 target 为 func.[[BoundTargetFunction]]。
- 断言：
IsConstructor (target) 是true 。 - 令 boundArgs 为 func.[[BoundArguments]]。
- 令 args 为 boundArgs 和 argList 的
列表连接 。 - 如果
SameValue (func, newTarget) 是true ，则将 newTarget 设置为 target。 - 返回 ?
Construct (target, args, newTarget)。
10.4.1.3 BoundFunctionCreate ( targetFunc, boundThis, boundArgs )
The abstract operation BoundFunctionCreate takes arguments targetFunc (a function object), boundThis (an ECMAScript language value), and boundArgs (a
- 令 proto 为 ? targetFunc.[[GetPrototypeOf]]()。
- 令 internalSlotsList 为 « [[Prototype]], [[Extensible]] » 和
Table 27 中列出的内部槽的列表连接 。 - 令 obj 为
MakeBasicObject (internalSlotsList)。 - 将 obj.[[Prototype]] 设置为 proto。
- 按照
10.4.1.1 中指定的方式设置 obj.[[Call]]。 - 如果
IsConstructor (targetFunc) 是true ，则- 按照
10.4.1.2 中指定的方式设置 obj.[[Construct]]。
- 按照
- 将 obj.[[BoundTargetFunction]] 设置为 targetFunc。
- 将 obj.[[BoundThis]] 设置为 boundThis。
- 将 obj.[[BoundArguments]] 设置为 boundArgs。
- 返回 obj。
10.4.2 数组异质对象
Array 是一种对
如果一个对象的 [[DefineOwnProperty]] 内部方法使用以下实现，且其其他基本内部方法使用
10.4.2.1 [[DefineOwnProperty]] ( propertyKey, propertyDesc )
The [[DefineOwnProperty]] internal method of an Array exotic object array takes arguments propertyKey (a property key) and propertyDesc (a
- 如果 propertyKey 是
"length" ，则返回 ?ArraySetLength (array, propertyDesc)。 - 如果 propertyKey 是
数组索引 ，则- 令 lengthDesc 为
OrdinaryGetOwnProperty (array,"length" )。 - 断言：lengthDesc 不是
undefined 。 - 断言：
IsDataDescriptor (lengthDesc) 是true 。 - 断言：lengthDesc.[[Configurable]] 是
false 。 - 令 length 为 lengthDesc.[[Value]]。
- 断言：length 是非负整数 Number。
- 令 index 为 !
ToUint32 (propertyKey)。 - 如果 index ≥ length 且 lengthDesc.[[Writable]] 是
false ，则返回false 。 - 令 succeeded 为 !
OrdinaryDefineOwnProperty (array, propertyKey, propertyDesc)。 - 如果 succeeded 是
false ，则返回false 。 - 如果 index ≥ length，则
- 将 lengthDesc.[[Value]] 设置为 index +
1 𝔽。 - 将 succeeded 设置为 !
OrdinaryDefineOwnProperty (array,"length" , lengthDesc)。 - 断言：succeeded 是
true 。
- 将 lengthDesc.[[Value]] 设置为 index +
- 返回
true 。
- 令 lengthDesc 为
- 返回 ?
OrdinaryDefineOwnProperty (array, propertyKey, propertyDesc)。
10.4.2.2 ArrayCreate ( length [ , proto ] )
The abstract operation ArrayCreate takes argument length (a non-negative
- 如果 length > 232 - 1，则抛出
RangeError 异常。 - 如果 proto 不存在，则将 proto 设置为
%Array.prototype% 。 - 令 array 为
MakeBasicObject (« [[Prototype]], [[Extensible]] »)。 - 将 array.[[Prototype]] 设置为 proto。
- 按照
10.4.2.1 中指定的方式设置 array.[[DefineOwnProperty]]。 - 执行 !
OrdinaryDefineOwnProperty (array,"length" , PropertyDescriptor { [[Value]]:𝔽 (length), [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 array。
10.4.2.3 ArraySpeciesCreate ( originalArray, length )
The abstract operation ArraySpeciesCreate takes arguments originalArray (an Object) and length (a non-negative
- 令 isArray 为 ?
IsArray (originalArray)。 - 如果 isArray 是
false ，则返回 ?ArrayCreate (length)。 - 令 ctor 为 ?
Get (originalArray,"constructor" )。 - 如果
IsConstructor (ctor) 是true ，则- 令 thisRealm 为
当前 Realm Record 。 - 令 ctorRealm 为 ?
GetFunctionRealm (ctor)。 - 如果 thisRealm 和 ctorRealm 不是同一个
Realm Record ，则
- 令 thisRealm 为
- 如果 ctor 是 Object，则
- 将 ctor 设置为 ?
Get (ctor,%Symbol.species% )。 - 如果 ctor 是
null ，则将 ctor 设置为undefined 。
- 将 ctor 设置为 ?
- 如果 ctor 是
undefined ，则返回 ?ArrayCreate (length)。 - 如果
IsConstructor (ctor) 是false ，则抛出TypeError 异常。 - 返回 ?
Construct (ctor, «𝔽 (length) »)。
10.4.2.4 ArraySetLength ( array, propertyDesc )
The abstract operation ArraySetLength takes arguments array (an Array) and propertyDesc (a
- 如果 propertyDesc 不具有 [[Value]] 字段，则
- 返回 !
OrdinaryDefineOwnProperty (array,"length" , propertyDesc)。
- 返回 !
- 令 newLengthDesc 为 propertyDesc 的副本。
- 令 newLength 为 ?
ToUint32 (propertyDesc.[[Value]])。 - 令 numberLength 为 ?
ToNumber (propertyDesc.[[Value]])。 - 如果
SameValueZero (newLength, numberLength) 是false ，则抛出RangeError 异常。 - 将 newLengthDesc.[[Value]] 设置为 newLength。
- 令 oldLengthDesc 为
OrdinaryGetOwnProperty (array,"length" )。 - 断言：oldLengthDesc 不是
undefined 。 - 断言：
IsDataDescriptor (oldLengthDesc) 是true 。 - 断言：oldLengthDesc.[[Configurable]] 是
false 。 - 令 oldLength 为 oldLengthDesc.[[Value]]。
- 如果 newLength ≥ oldLength，则
- 返回 !
OrdinaryDefineOwnProperty (array,"length" , newLengthDesc)。
- 返回 !
- 如果 oldLengthDesc.[[Writable]] 是
false ，则返回false 。 - 如果 newLengthDesc 不具有 [[Writable]] 字段，或 newLengthDesc.[[Writable]] 是
true ，则- 令 newWritable 为
true 。
- 令 newWritable 为
- 否则，
- 注：将 [[Writable]] 特性设置为
false 会被推迟，以防某些元素无法删除。 - 令 newWritable 为
false 。 - 将 newLengthDesc.[[Writable]] 设置为
true 。
- 注：将 [[Writable]] 特性设置为
- 令 succeeded 为 !
OrdinaryDefineOwnProperty (array,"length" , newLengthDesc)。 - 如果 succeeded 是
false ，则返回false 。 - 对 array 的每个自有
属性键 propertyKey，如果 propertyKey 是数组索引 且 !ToUint32 (propertyKey) ≥ newLength，则按降序数值索引顺序，执行：- 令 deleteSucceeded 为 ! array.[[Delete]](propertyKey)。
- 如果 deleteSucceeded 是
false ，则- 将 newLengthDesc.[[Value]] 设置为 !
ToUint32 (propertyKey) +1 𝔽。 - 如果 newWritable 是
false ，则将 newLengthDesc.[[Writable]] 设置为false 。 - 执行 !
OrdinaryDefineOwnProperty (array,"length" , newLengthDesc)。 - 返回
false 。
- 将 newLengthDesc.[[Value]] 设置为 !
- 如果 newWritable 是
false ，则- 将 succeeded 设置为 !
OrdinaryDefineOwnProperty (array,"length" , PropertyDescriptor { [[Writable]]:false })。 - 断言：succeeded 是
true 。
- 将 succeeded 设置为 !
- 返回
true 。
10.4.3 字符串异质对象
String 对象是一种
如果一个对象的 [[GetOwnProperty]]、[[DefineOwnProperty]] 和 [[OwnPropertyKeys]] 内部方法使用以下实现，且其其他基本内部方法使用
10.4.3.1 [[GetOwnProperty]] ( propertyKey )
The [[GetOwnProperty]] internal method of a String exotic object string takes argument propertyKey (a property key) and returns a normal completion containing either a
- 令 propertyDesc 为
OrdinaryGetOwnProperty (string, propertyKey)。 - 如果 propertyDesc 不是
undefined ，则返回 propertyDesc。 - 返回
StringGetOwnProperty (string, propertyKey)。
10.4.3.2 [[DefineOwnProperty]] ( propertyKey, propertyDesc )
The [[DefineOwnProperty]] internal method of a String exotic object string takes arguments propertyKey (a property key) and propertyDesc (a
- 令 stringDesc 为
StringGetOwnProperty (string, propertyKey)。 - 如果 stringDesc 不是
undefined ，则- 令 extensible 为 string.[[Extensible]]。
- 返回
IsCompatiblePropertyDescriptor (extensible, propertyDesc, stringDesc)。
- 返回 !
OrdinaryDefineOwnProperty (string, propertyKey, propertyDesc)。
10.4.3.3 [[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of a String exotic object obj takes no arguments and returns a normal completion containing a
- 令 keys 为新的空
List 。 - 令 string 为 obj.[[StringData]]。
- 断言：string 是 String。
- 令 length 为 string 的长度。
- 对每个整数 i，使得 0 ≤ i < length，按升序，执行：
- 对 obj 的每个自有
属性键 propertyKey，如果 propertyKey 是数组索引 且 !ToIntegerOrInfinity (propertyKey) ≥ length，则按升序数值索引顺序，执行：- 将 propertyKey 追加到 keys。
- 对 obj 的每个自有
属性键 propertyKey，如果 propertyKey 是 String 且 propertyKey 不是数组索引 ，则按属性创建的升序时间顺序，执行：- 将 propertyKey 追加到 keys。
- 对 obj 的每个自有
属性键 propertyKey，如果 propertyKey 是 Symbol，则按属性创建的升序时间顺序，执行：- 将 propertyKey 追加到 keys。
- 返回 keys。
10.4.3.4 StringCreate ( value, proto )
The abstract operation StringCreate takes arguments value (a String) and proto (an Object) and returns a String exotic object. 它用于指定新
- 令 string 为
MakeBasicObject (« [[Prototype]], [[Extensible]], [[StringData]] »)。 - 将 string.[[Prototype]] 设置为 proto。
- 将 string.[[StringData]] 设置为 value。
- 按照
10.4.3.1 中指定的方式设置 string.[[GetOwnProperty]]。 - 按照
10.4.3.2 中指定的方式设置 string.[[DefineOwnProperty]]。 - 按照
10.4.3.3 中指定的方式设置 string.[[OwnPropertyKeys]]。 - 令 length 为 value 的长度。
- 执行 !
DefinePropertyOrThrow (string,"length" , PropertyDescriptor { [[Value]]:𝔽 (length), [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 string。
10.4.3.5 StringGetOwnProperty ( string, propertyKey )
The abstract operation StringGetOwnProperty takes arguments string (an Object that has a [[StringData]] internal slot) and propertyKey (a property key) and returns a
- 如果 propertyKey 不是 String，则返回
undefined 。 - 令 numericIndex 为
CanonicalNumericIndexString (propertyKey)。 - 如果 numericIndex 不是整数 Number，则返回
undefined 。 - 如果 numericIndex 是
-0 𝔽 或 numericIndex <-0 𝔽，则返回undefined 。 - 令 stringData 为 string.[[StringData]]。
- 断言：stringData 是 String。
- 令 length 为 stringData 的长度。
- 如果
ℝ (numericIndex) ≥ length，则返回undefined 。 - 令 resultString 为 stringData 中从
ℝ (numericIndex) 到ℝ (numericIndex) + 1 的子字符串 。 - 返回 PropertyDescriptor { [[Value]]: resultString, [[Writable]]:
false , [[Enumerable]]:true , [[Configurable]]:false }。
10.4.4 arguments 异质对象
大多数 ECMAScript 函数都会向其代码提供 arguments 对象。取决于函数定义的特征，其 arguments 对象要么是
如果一个对象的内部方法使用以下实现，其中此处未指定的方法使用
虽然
Object.prototype.toString（
ParameterMap 对象及其属性值用作指定 arguments 对象与实参绑定对应关系的装置。ParameterMap 对象以及作为其属性值的对象不能从 ECMAScript 代码直接观察到。ECMAScript 实现不需要实际创建或使用这些对象来实现指定语义。
普通 arguments 对象定义了一个名为
ECMAScript 的
10.4.4.1 [[GetOwnProperty]] ( propertyKey )
The [[GetOwnProperty]] internal method of an arguments exotic object args takes argument propertyKey (a property key) and returns a normal completion containing either a
- 令 propertyDesc 为
OrdinaryGetOwnProperty (args, propertyKey)。 - 如果 propertyDesc 是
undefined ，则返回undefined 。 - 令 map 为 args.[[ParameterMap]]。
- 令 isMapped 为 !
HasOwnProperty (map, propertyKey)。 - 如果 isMapped 是
true ，则- 将 propertyDesc.[[Value]] 设置为 !
Get (map, propertyKey)。
- 将 propertyDesc.[[Value]] 设置为 !
- 返回 propertyDesc。
10.4.4.2 [[DefineOwnProperty]] ( propertyKey, propertyDesc )
The [[DefineOwnProperty]] internal method of an arguments exotic object args takes arguments propertyKey (a property key) and propertyDesc (a
- 令 map 为 args.[[ParameterMap]]。
- 令 isMapped 为 !
HasOwnProperty (map, propertyKey)。 - 令 newArgDesc 为 propertyDesc。
- 如果 isMapped 是
true 且IsDataDescriptor (propertyDesc) 是true ，则- 如果 propertyDesc 不具有 [[Value]] 字段，propertyDesc 具有 [[Writable]] 字段，并且 propertyDesc.[[Writable]] 是
false ，则- 将 newArgDesc 设置为 propertyDesc 的副本。
- 将 newArgDesc.[[Value]] 设置为 !
Get (map, propertyKey)。
- 如果 propertyDesc 不具有 [[Value]] 字段，propertyDesc 具有 [[Writable]] 字段，并且 propertyDesc.[[Writable]] 是
- 令 allowed 为 !
OrdinaryDefineOwnProperty (args, propertyKey, newArgDesc)。 - 如果 allowed 是
false ，则返回false 。 - 如果 isMapped 是
true ，则- 如果
IsAccessorDescriptor (propertyDesc) 是true ，则- 执行 ! map.[[Delete]](propertyKey)。
- 否则，
- 如果 propertyDesc 具有 [[Value]] 字段，则
- 断言：以下 Set 会成功，因为由 arguments 对象映射的形式参数始终可写。
- 执行 !
Set (map, propertyKey, propertyDesc.[[Value]],false )。
- 如果 propertyDesc 具有 [[Writable]] 字段且 propertyDesc.[[Writable]] 是
false ，则- 执行 ! map.[[Delete]](propertyKey)。
- 如果 propertyDesc 具有 [[Value]] 字段，则
- 如果
- 返回
true 。
10.4.4.3 [[Get]] ( propertyKey, receiver )
The [[Get]] internal method of an arguments exotic object args takes arguments propertyKey (a property key) and receiver (an ECMAScript language value) and returns either a normal completion containing an ECMAScript language value or a throw completion. It performs the following steps when called:
- 令 map 为 args.[[ParameterMap]]。
- 令 isMapped 为 !
HasOwnProperty (map, propertyKey)。 - 如果 isMapped 是
false ，则返回 ?OrdinaryGet (args, propertyKey, receiver)。 - 断言：map
包含 propertyKey 的形式参数映射。 - 返回 !
Get (map, propertyKey)。
10.4.4.4 [[Set]] ( propertyKey, value, receiver )
The [[Set]] internal method of an arguments exotic object args takes arguments propertyKey (a property key), value (an ECMAScript language value), and receiver (an ECMAScript language value) and returns either a normal completion containing a Boolean or a throw completion. It performs the following steps when called:
- 如果
SameValue (args, receiver) 是false ，则- 令 isMapped 为
false 。
- 令 isMapped 为
- 否则，
- 令 map 为 args.[[ParameterMap]]。
- 令 isMapped 为 !
HasOwnProperty (map, propertyKey)。
- 如果 isMapped 是
true ，则- 断言：以下 Set 会成功，因为由 arguments 对象映射的形式参数始终可写。
- 执行 !
Set (map, propertyKey, value,false )。
- 返回 ?
OrdinarySet (args, propertyKey, value, receiver)。
10.4.4.5 [[Delete]] ( propertyKey )
The [[Delete]] internal method of an arguments exotic object args takes argument propertyKey (a property key) and returns either a normal completion containing a Boolean or a throw completion. It performs the following steps when called:
- 令 map 为 args.[[ParameterMap]]。
- 令 isMapped 为 !
HasOwnProperty (map, propertyKey)。 - 令 result 为 ?
OrdinaryDelete (args, propertyKey)。 - 如果 result 是
true 且 isMapped 是true ，则- 执行 ! map.[[Delete]](propertyKey)。
- 返回 result。
10.4.4.6 CreateUnmappedArgumentsObject ( argList )
The abstract operation CreateUnmappedArgumentsObject takes argument argList (a
- 令 length 为 argList 中元素的数量。
- 令 obj 为
OrdinaryObjectCreate (%Object.prototype% , « [[ParameterMap]] »)。 - 将 obj.[[ParameterMap]] 设置为
undefined 。 - 执行 !
DefinePropertyOrThrow (obj,"length" , PropertyDescriptor { [[Value]]:𝔽 (length), [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true })。 - 令 index 为 0。
- 重复，当 index < length 时，
- 令 value 为 argList[index]。
- 执行 !
CreateDataPropertyOrThrow (obj, !ToString (𝔽 (index)), value)。 - 将 index 设置为 index + 1。
- 执行 !
DefinePropertyOrThrow (obj,%Symbol.iterator% , PropertyDescriptor { [[Value]]: %Array.prototype.values%, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true })。 - 执行 !
DefinePropertyOrThrow (obj,"callee" , PropertyDescriptor { [[Get]]:%ThrowTypeError% , [[Set]]:%ThrowTypeError% , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 obj。
10.4.4.7 CreateMappedArgumentsObject ( func, formals, argList, envRecord )
The abstract operation CreateMappedArgumentsObject takes arguments func (an ECMAScript function object), formals (a
- 断言：formals 不
包含 rest 参数、任何绑定模式或任何初始化器。它可以包含 重复标识符。 - 令 length 为 argList 中元素的数量。
- 令 obj 为
MakeBasicObject (« [[Prototype]], [[Extensible]], [[ParameterMap]] »)。 - 按照
10.4.4.1 中指定的方式设置 obj.[[GetOwnProperty]]。 - 按照
10.4.4.2 中指定的方式设置 obj.[[DefineOwnProperty]]。 - 按照
10.4.4.3 中指定的方式设置 obj.[[Get]]。 - 按照
10.4.4.4 中指定的方式设置 obj.[[Set]]。 - 按照
10.4.4.5 中指定的方式设置 obj.[[Delete]]。 - 将 obj.[[Prototype]] 设置为
%Object.prototype% 。 - 令 map 为
OrdinaryObjectCreate (null )。 - 将 obj.[[ParameterMap]] 设置为 map。
- 令 paramNames 为 formals 的
BoundNames 。 - 令 paramCount 为 paramNames 中元素的数量。
- 令 index 为 0。
- 重复，当 index < length 时，
- 令 value 为 argList[index]。
- 执行 !
CreateDataPropertyOrThrow (obj, !ToString (𝔽 (index)), value)。 - 将 index 设置为 index + 1。
- 执行 !
DefinePropertyOrThrow (obj,"length" , PropertyDescriptor { [[Value]]:𝔽 (length), [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true })。 - 令 mappedNames 为新的空
List 。 - 将 index 设置为 paramCount - 1。
- 重复，当 index ≥ 0 时，
- 令 name 为 paramNames[index]。
- 如果 mappedNames 不
包含 name，则- 将 name 追加到 mappedNames。
- 如果 index < length，则
- 令 getter 为
MakeArgGetter (name, envRecord)。 - 令 setter 为
MakeArgSetter (name, envRecord)。 - 执行 ! map.[[DefineOwnProperty]](!
ToString (𝔽 (index)), PropertyDescriptor { [[Set]]: setter, [[Get]]: getter, [[Enumerable]]:false , [[Configurable]]:true })。
- 令 getter 为
- 将 index 设置为 index - 1。
- 执行 !
DefinePropertyOrThrow (obj,%Symbol.iterator% , PropertyDescriptor { [[Value]]: %Array.prototype.values%, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true })。 - 执行 !
DefinePropertyOrThrow (obj,"callee" , PropertyDescriptor { [[Value]]: func, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true })。 - 返回 obj。
10.4.4.7.1 MakeArgGetter ( name, envRecord )
The abstract operation MakeArgGetter takes arguments name (a String) and envRecord (an
- 令 getterClosure 为一个不带形参的新
Abstract Closure ，它捕获 name 和 envRecord，并在被调用时执行以下步骤：- 返回
NormalCompletion (! envRecord.GetBindingValue (name,false ))。
- 返回
- 令 getter 为
CreateBuiltinFunction (getterClosure, 0,"" , « »)。 - 注：getter 永远不能被 ECMAScript 代码直接访问。
- 返回 getter。
10.4.4.7.2 MakeArgSetter ( name, envRecord )
The abstract operation MakeArgSetter takes arguments name (a String) and envRecord (an
- 令 setterClosure 为一个具有形参 (value) 的新
Abstract Closure ，它捕获 name 和 envRecord，并在被调用时执行以下步骤：- 返回
NormalCompletion (! envRecord.SetMutableBinding (name, value,false ))。
- 返回
- 令 setter 为
CreateBuiltinFunction (setterClosure, 1,"" , « »)。 - 注：setter 永远不能被 ECMAScript 代码直接访问。
- 返回 setter。
10.4.5 TypedArray 异质对象
因为对于任何 Number n，
如果一个对象的 [[PreventExtensions]]、[[GetOwnProperty]]、[[HasProperty]]、[[DefineOwnProperty]]、[[Get]]、[[Set]]、[[Delete]] 和 [[OwnPropertyKeys]] 内部方法使用本节中的定义，且其其他基本内部方法使用
10.4.5.1 [[PreventExtensions]] ( )
The [[PreventExtensions]] internal method of a
- 注：
6.1.7.3 中指定的与可扩展性相关的不变量，不允许此方法在 obj 可以获得（或失去后重新获得）属性时返回true ；当其底层 buffer 被调整大小时，具有整数索引 名称的属性可能发生这种情况。 - 如果
IsTypedArrayFixedLength (obj) 是false ，则返回false 。 - 返回
OrdinaryPreventExtensions (obj)。
10.4.5.2 [[GetOwnProperty]] ( propertyKey )
The [[GetOwnProperty]] internal method of a
- 如果 propertyKey 是 String，则
- 令 numericIndex 为
CanonicalNumericIndexString (propertyKey)。 - 如果 numericIndex 不是
undefined ，则- 令 value 为
TypedArrayGetElement (obj, numericIndex)。 - 如果 value 是
undefined ，则返回undefined 。 - 返回 PropertyDescriptor { [[Value]]: value, [[Writable]]:
true , [[Enumerable]]:true , [[Configurable]]:true }。
- 令 value 为
- 令 numericIndex 为
- 返回
OrdinaryGetOwnProperty (obj, propertyKey)。
10.4.5.3 [[HasProperty]] ( propertyKey )
The [[HasProperty]] internal method of a
- 如果 propertyKey 是 String，则
- 令 numericIndex 为
CanonicalNumericIndexString (propertyKey)。 - 如果 numericIndex 不是
undefined ，则返回IsValidIntegerIndex (obj, numericIndex)。
- 令 numericIndex 为
- 返回 ?
OrdinaryHasProperty (obj, propertyKey)。
10.4.5.4 [[DefineOwnProperty]] ( propertyKey, propertyDesc )
The [[DefineOwnProperty]] internal method of a
- 如果 propertyKey 是 String，则
- 令 numericIndex 为
CanonicalNumericIndexString (propertyKey)。 - 如果 numericIndex 不是
undefined ，则- 如果
IsValidIntegerIndex (obj, numericIndex) 是false ，则返回false 。 - 如果 propertyDesc 具有 [[Configurable]] 字段且 propertyDesc.[[Configurable]] 是
false ，则返回false 。 - 如果 propertyDesc 具有 [[Enumerable]] 字段且 propertyDesc.[[Enumerable]] 是
false ，则返回false 。 - 如果
IsAccessorDescriptor (propertyDesc) 是true ，则返回false 。 - 如果 propertyDesc 具有 [[Writable]] 字段且 propertyDesc.[[Writable]] 是
false ，则返回false 。 - 如果 propertyDesc 具有 [[Value]] 字段，则执行 ?
TypedArraySetElement (obj, numericIndex, propertyDesc.[[Value]])。 - 返回
true 。
- 如果
- 令 numericIndex 为
- 返回 !
OrdinaryDefineOwnProperty (obj, propertyKey, propertyDesc)。
10.4.5.5 [[Get]] ( propertyKey, receiver )
The [[Get]] internal method of a
- 如果 propertyKey 是 String，则
- 令 numericIndex 为
CanonicalNumericIndexString (propertyKey)。 - 如果 numericIndex 不是
undefined ，则- 返回
TypedArrayGetElement (obj, numericIndex)。
- 返回
- 令 numericIndex 为
- 返回 ?
OrdinaryGet (obj, propertyKey, receiver)。
10.4.5.6 [[Set]] ( propertyKey, value, receiver )
The [[Set]] internal method of a
- 如果 propertyKey 是 String，则
- 令 numericIndex 为
CanonicalNumericIndexString (propertyKey)。 - 如果 numericIndex 不是
undefined ，则- 如果
SameValue (obj, receiver) 是true ，则- 执行 ?
TypedArraySetElement (obj, numericIndex, value)。 - 返回
true 。
- 执行 ?
- 如果
IsValidIntegerIndex (obj, numericIndex) 是false ，则返回true 。
- 如果
- 令 numericIndex 为
- 返回 ?
OrdinarySet (obj, propertyKey, value, receiver)。
10.4.5.7 [[Delete]] ( propertyKey )
The [[Delete]] internal method of a
- 如果 propertyKey 是 String，则
- 令 numericIndex 为
CanonicalNumericIndexString (propertyKey)。 - 如果 numericIndex 不是
undefined ，则- 如果
IsValidIntegerIndex (obj, numericIndex) 是false ，则返回true 。 - 返回
false 。
- 如果
- 令 numericIndex 为
- 返回 !
OrdinaryDelete (obj, propertyKey)。
10.4.5.8 [[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of a
- 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst )。 - 令 keys 为新的空
List 。 - 如果
IsTypedArrayOutOfBounds (taRecord) 是false ，则- 令 length 为
TypedArrayLength (taRecord)。 - 对每个整数 i，使得 0 ≤ i < length，按升序，执行：
- 令 length 为
- 对 obj 的每个自有
属性键 propertyKey，如果 propertyKey 是 String 且 propertyKey 不是整数索引 ，则按属性创建的升序时间顺序，执行：- 将 propertyKey 追加到 keys。
- 对 obj 的每个自有
属性键 propertyKey，如果 propertyKey 是 Symbol，则按属性创建的升序时间顺序，执行：- 将 propertyKey 追加到 keys。
- 返回 keys。
10.4.5.9 TypedArray With Buffer Witness Records
TypedArray With Buffer Witness Record 是一个
TypedArray With Buffer Witness Records 具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Object]] |
a |
其 buffer 的字节长度被加载的 |
| [[CachedBufferByteLength]] |
a non-negative |
创建该 |
10.4.5.10 MakeTypedArrayWithBufferWitnessRecord ( obj, order )
The abstract operation MakeTypedArrayWithBufferWitnessRecord takes arguments obj (a
- 令 buffer 为 obj.[[ViewedArrayBuffer]]。
- 如果
IsDetachedBuffer (buffer) 是true ，则- 令 byteLength 为
detached 。
- 令 byteLength 为
- 否则，
- 令 byteLength 为
ArrayBufferByteLength (buffer, order)。
- 令 byteLength 为
- 返回
TypedArray With Buffer Witness Record { [[Object]]: obj, [[CachedBufferByteLength]]: byteLength }。
10.4.5.11 TypedArrayCreate ( proto )
The abstract operation TypedArrayCreate takes argument proto (an Object) and returns a
- 令 internalSlotsList 为 « [[Prototype]], [[Extensible]], [[ViewedArrayBuffer]], [[TypedArrayName]], [[ContentType]], [[ByteLength]], [[ByteOffset]], [[ArrayLength]] »。
- 令 ta 为
MakeBasicObject (internalSlotsList)。 - 按照
10.4.5.1 中指定的方式设置 ta.[[PreventExtensions]]。 - 按照
10.4.5.2 中指定的方式设置 ta.[[GetOwnProperty]]。 - 按照
10.4.5.3 中指定的方式设置 ta.[[HasProperty]]。 - 按照
10.4.5.4 中指定的方式设置 ta.[[DefineOwnProperty]]。 - 按照
10.4.5.5 中指定的方式设置 ta.[[Get]]。 - 按照
10.4.5.6 中指定的方式设置 ta.[[Set]]。 - 按照
10.4.5.7 中指定的方式设置 ta.[[Delete]]。 - 按照
10.4.5.8 中指定的方式设置 ta.[[OwnPropertyKeys]]。 - 将 ta.[[Prototype]] 设置为 proto。
- 返回 ta。
10.4.5.12 TypedArrayByteLength ( taRecord )
The abstract operation TypedArrayByteLength takes argument taRecord (a
- 断言：
IsTypedArrayOutOfBounds (taRecord) 是false 。 - 令 obj 为 taRecord.[[Object]]。
- 如果 obj.[[ByteLength]] 不是
auto ，则返回 obj.[[ByteLength]]。 - 令 length 为
TypedArrayLength (taRecord)。 - 令 elementSize 为
TypedArrayElementSize (obj)。 - 注：返回的字节长度始终是 elementSize 的整数倍，即使底层 buffer 已被调整为非整数倍。
- 返回 length × elementSize。
10.4.5.13 TypedArrayLength ( taRecord )
The abstract operation TypedArrayLength takes argument taRecord (a
- 断言：
IsTypedArrayOutOfBounds (taRecord) 是false 。 - 令 obj 为 taRecord.[[Object]]。
- 如果 obj.[[ArrayLength]] 不是
auto ，则返回 obj.[[ArrayLength]]。 - 断言：
IsFixedLengthArrayBuffer (obj.[[ViewedArrayBuffer]]) 是false 。 - 令 byteOffset 为 obj.[[ByteOffset]]。
- 令 elementSize 为
TypedArrayElementSize (obj)。 - 令 byteLength 为 taRecord.[[CachedBufferByteLength]]。
- 断言：byteLength 不是
detached 。 - 返回
floor ((byteLength - byteOffset) / elementSize)。
10.4.5.14 IsTypedArrayOutOfBounds ( taRecord )
The abstract operation IsTypedArrayOutOfBounds takes argument taRecord (a
- 令 obj 为 taRecord.[[Object]]。
- 令 bufferByteLength 为 taRecord.[[CachedBufferByteLength]]。
- 如果
IsDetachedBuffer (obj.[[ViewedArrayBuffer]]) 是true ，则- 断言：bufferByteLength 是
detached 。 - 返回
true 。
- 断言：bufferByteLength 是
- 断言：bufferByteLength 是非负整数。
- 令 byteOffsetStart 为 obj.[[ByteOffset]]。
- 如果 obj.[[ArrayLength]] 是
auto ，则- 令 byteOffsetEnd 为 bufferByteLength。
- 否则，
- 令 elementSize 为
TypedArrayElementSize (obj)。 - 令 arrayByteLength 为 obj.[[ArrayLength]] × elementSize。
- 令 byteOffsetEnd 为 byteOffsetStart + arrayByteLength。
- 令 elementSize 为
- 注：[[ByteOffset]] 为 bufferByteLength 的 0 长度
TypedArray 不被视为越界。 - 如果 byteOffsetStart > bufferByteLength 或 byteOffsetEnd > bufferByteLength，则返回
true 。 - 返回
false 。
10.4.5.15 IsTypedArrayFixedLength ( obj )
The abstract operation IsTypedArrayFixedLength takes argument obj (a
- 如果 obj.[[ArrayLength]] 是
auto ，则返回false 。 - 令 buffer 为 obj.[[ViewedArrayBuffer]]。
- 如果
IsFixedLengthArrayBuffer (buffer) 是false 且IsSharedArrayBuffer (buffer) 是false ，则返回false 。 - 返回
true 。
10.4.5.16 IsValidIntegerIndex ( obj, index )
The abstract operation IsValidIntegerIndex takes arguments obj (a
- 如果
IsDetachedBuffer (obj.[[ViewedArrayBuffer]]) 是true ，则返回false 。 - 如果 index 不是整数 Number，则返回
false 。 - 如果 index 是
-0 𝔽 或 index <-0 𝔽，则返回false 。 - 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (obj,unordered )。 - 注：当 obj 的后备 buffer 是
可增长 SharedArrayBuffer 时，边界检查不是同步操作。 - 如果
IsTypedArrayOutOfBounds (taRecord) 是true ，则返回false 。 - 令 length 为
TypedArrayLength (taRecord)。 - 如果
ℝ (index) ≥ length，则返回false 。 - 返回
true 。
10.4.5.17 TypedArrayGetElement ( obj, index )
The abstract operation TypedArrayGetElement takes arguments obj (a
- 如果
IsValidIntegerIndex (obj, index) 是false ，则返回undefined 。 - 令 offset 为 obj.[[ByteOffset]]。
- 令 elementSize 为
TypedArrayElementSize (obj)。 - 令 byteIndexInBuffer 为 (
ℝ (index) × elementSize) + offset。 - 令 elementType 为
TypedArrayElementType (obj)。 - 返回
GetValueFromBuffer (obj.[[ViewedArrayBuffer]], byteIndexInBuffer, elementType,true ,unordered )。
10.4.5.18 TypedArraySetElement ( obj, index, value )
The abstract operation TypedArraySetElement takes arguments obj (a
- 如果 obj.[[ContentType]] 是
bigint ，则令 number 为 ?ToBigInt (value)。 - 否则，令 number 为 ?
ToNumber (value)。 - 如果
IsValidIntegerIndex (obj, index) 是true ，则- 令 offset 为 obj.[[ByteOffset]]。
- 令 elementSize 为
TypedArrayElementSize (obj)。 - 令 byteIndexInBuffer 为 (
ℝ (index) × elementSize) + offset。 - 令 elementType 为
TypedArrayElementType (obj)。 - 执行
SetValueInBuffer (obj.[[ViewedArrayBuffer]], byteIndexInBuffer, elementType, number,true ,unordered )。
- 返回
unused 。
此操作总是表现为成功，但当尝试写入超过
10.4.5.19 IsArrayBufferViewOutOfBounds ( obj )
The abstract operation IsArrayBufferViewOutOfBounds takes argument obj (a
- 如果 obj 具有 [[DataView]] 内部槽，则
- 令 viewRecord 为
MakeDataViewWithBufferWitnessRecord (obj,seq-cst )。 - 返回
IsViewOutOfBounds (viewRecord)。
- 令 viewRecord 为
- 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst )。 - 返回
IsTypedArrayOutOfBounds (taRecord)。
10.4.6 模块命名空间异质对象
export * 导出项间接导出的任何绑定。每个 String 值自有
如果一个对象的 [[GetPrototypeOf]]、[[SetPrototypeOf]]、[[IsExtensible]]、[[PreventExtensions]]、[[GetOwnProperty]]、[[DefineOwnProperty]]、[[HasProperty]]、[[Get]]、[[Set]]、[[Delete]] 和 [[OwnPropertyKeys]] 内部方法使用本节中的定义，且其其他基本内部方法使用
| 内部槽 | 类型 | 描述 |
|---|---|---|
| [[Module]] |
a |
此命名空间所暴露导出的 |
| [[Exports]] |
a |
一个 |
10.4.6.1 [[GetPrototypeOf]] ( )
The [[GetPrototypeOf]] internal method of a module namespace exotic object takes no arguments and returns a normal completion containing
- 返回
null 。
10.4.6.2 [[SetPrototypeOf]] ( proto )
The [[SetPrototypeOf]] internal method of a module namespace exotic object obj takes argument proto (an Object or
- 返回 !
SetImmutablePrototype (obj, proto)。
10.4.6.3 [[IsExtensible]] ( )
The [[IsExtensible]] internal method of a module namespace exotic object takes no arguments and returns a normal completion containing
- 返回
false 。
10.4.6.4 [[PreventExtensions]] ( )
The [[PreventExtensions]] internal method of a module namespace exotic object takes no arguments and returns a normal completion containing
- 返回
true 。
10.4.6.5 [[GetOwnProperty]] ( propertyKey )
The [[GetOwnProperty]] internal method of a module namespace exotic object obj takes argument propertyKey (a property key) and returns either a normal completion containing either a
- 如果 propertyKey 是 Symbol，则返回
OrdinaryGetOwnProperty (obj, propertyKey)。 - 令 exports 为 obj.[[Exports]]。
- 如果 exports 不
包含 propertyKey，则返回undefined 。 - 令 value 为 ? obj.[[Get]](propertyKey, obj)。
- 返回 PropertyDescriptor { [[Value]]: value, [[Writable]]:
true , [[Enumerable]]:true , [[Configurable]]:false }。
10.4.6.6 [[DefineOwnProperty]] ( propertyKey, propertyDesc )
The [[DefineOwnProperty]] internal method of a module namespace exotic object obj takes arguments propertyKey (a property key) and propertyDesc (a
- 如果 propertyKey 是 Symbol，则返回 !
OrdinaryDefineOwnProperty (obj, propertyKey, propertyDesc)。 - 令 current 为 ? obj.[[GetOwnProperty]](propertyKey)。
- 如果 current 是
undefined ，则返回false 。 - 如果 propertyDesc 具有 [[Configurable]] 字段且 propertyDesc.[[Configurable]] 是
true ，则返回false 。 - 如果 propertyDesc 具有 [[Enumerable]] 字段且 propertyDesc.[[Enumerable]] 是
false ，则返回false 。 - 如果
IsAccessorDescriptor (propertyDesc) 是true ，则返回false 。 - 如果 propertyDesc 具有 [[Writable]] 字段且 propertyDesc.[[Writable]] 是
false ，则返回false 。 - 如果 propertyDesc 具有 [[Value]] 字段，则返回
SameValue (propertyDesc.[[Value]], current.[[Value]])。 - 返回
true 。
10.4.6.7 [[HasProperty]] ( propertyKey )
The [[HasProperty]] internal method of a module namespace exotic object obj takes argument propertyKey (a property key) and returns a normal completion containing a Boolean. It performs the following steps when called:
- 如果 propertyKey 是 Symbol，则返回 !
OrdinaryHasProperty (obj, propertyKey)。 - 令 exports 为 obj.[[Exports]]。
- 如果 exports
包含 propertyKey，则返回true 。 - 返回
false 。
10.4.6.8 [[Get]] ( propertyKey, receiver )
The [[Get]] internal method of a module namespace exotic object obj takes arguments propertyKey (a property key) and receiver (an ECMAScript language value) and returns either a normal completion containing an ECMAScript language value or a throw completion. It performs the following steps when called:
- 如果 propertyKey 是 Symbol，则
- 返回 !
OrdinaryGet (obj, propertyKey, receiver)。
- 返回 !
- 令 exports 为 obj.[[Exports]]。
- 如果 exports 不
包含 propertyKey，则返回undefined 。 - 令 module 为 obj.[[Module]]。
- 令 binding 为 module.
ResolveExport (propertyKey)。 - 断言：binding 是
ResolvedBinding Record 。 - 令 targetModule 为 binding.[[Module]]。
- 断言：targetModule 不是
undefined 。 - 如果 binding.[[BindingName]] 是
namespace ，则- 返回
GetModuleNamespace (targetModule)。
- 返回
- 令 targetEnv 为 targetModule.[[Environment]]。
- 如果 targetEnv 是
empty ，则抛出ReferenceError 异常。 - 返回 ? targetEnv.
GetBindingValue (binding.[[BindingName]],true )。
10.4.6.9 [[Set]] ( propertyKey, value, receiver )
The [[Set]] internal method of a module namespace exotic object takes arguments propertyKey (a property key), value (an ECMAScript language value), and receiver (an ECMAScript language value) and returns a normal completion containing
- 返回
false 。
10.4.6.10 [[Delete]] ( propertyKey )
The [[Delete]] internal method of a module namespace exotic object obj takes argument propertyKey (a property key) and returns a normal completion containing a Boolean. It performs the following steps when called:
- 如果 propertyKey 是 Symbol，则
- 返回 !
OrdinaryDelete (obj, propertyKey)。
- 返回 !
- 令 exports 为 obj.[[Exports]]。
- 如果 exports
包含 propertyKey，则返回false 。 - 返回
true 。
10.4.6.11 [[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of a module namespace exotic object obj takes no arguments and returns a normal completion containing a
- 令 exports 为 obj.[[Exports]]。
- 令 symbolKeys 为
OrdinaryOwnPropertyKeys (obj)。 - 返回 exports 和 symbolKeys 的
列表连接 。
10.4.6.12 ModuleNamespaceCreate ( module, exports )
The abstract operation ModuleNamespaceCreate takes arguments module (a
- 断言：module.[[Namespace]] 是
empty 。 - 令 internalSlotsList 为
Table 29 中列出的内部槽。 - 令 namespace 为
MakeBasicObject (internalSlotsList)。 - 将 namespace 的基本内部方法设置为
10.4.6 中指定的定义。 - 将 namespace.[[Module]] 设置为 module。
- 令 sortedExports 为一个
List ，其元素是 exports 的元素，按词典序代码单元顺序排序。 - 将 namespace.[[Exports]] 设置为 sortedExports。
- 创建 namespace 的自有属性，对应于
28.3 中的定义。 - 将 module.[[Namespace]] 设置为 namespace。
- 返回 namespace。
10.4.7 不可变原型异质对象
如果一个对象的 [[SetPrototypeOf]] 内部方法使用以下实现，则该对象是不可变原型异质对象。（其其他基本内部方法可以使用任何实现，取决于所讨论的具体
10.4.7.1 [[SetPrototypeOf]] ( proto )
The [[SetPrototypeOf]] internal method of an immutable prototype exotic object obj takes argument proto (an Object or
- 返回 ?
SetImmutablePrototype (obj, proto)。
10.4.7.2 SetImmutablePrototype ( obj, proto )
The abstract operation SetImmutablePrototype takes arguments obj (an Object) and proto (an Object or
- 令 current 为 ? obj.[[GetPrototypeOf]]()。
- 如果
SameValue (proto, current) 是true ，则返回true 。 - 返回
false 。
10.5 Proxy 对象内部方法与内部槽
Proxy 对象是一种
如果一个对象的基本内部方法（包括 [[Call]] 和 [[Construct]]，如果适用）使用本节中的定义，则该对象是 Proxy 异质对象。这些内部方法由
| 内部方法 | Handler 方法 |
|---|---|
| [[GetPrototypeOf]] |
getPrototypeOf
|
| [[SetPrototypeOf]] |
setPrototypeOf
|
| [[IsExtensible]] |
isExtensible
|
| [[PreventExtensions]] |
preventExtensions
|
| [[GetOwnProperty]] |
getOwnPropertyDescriptor
|
| [[DefineOwnProperty]] |
defineProperty
|
| [[HasProperty]] |
has
|
| [[Get]] |
get
|
| [[Set]] |
set
|
| [[Delete]] |
deleteProperty
|
| [[OwnPropertyKeys]] |
ownKeys
|
| [[Call]] |
apply
|
| [[Construct]] |
construct
|
当调用 handler 方法以提供 Proxy 对象内部方法的实现时，会将该 proxy 的 target 对象作为形参传递给 handler 方法。proxy 的 handler 对象不一定具有与每个基本内部方法对应的方法。如果 handler 对象没有与内部陷阱对应的方法，则在 proxy 上调用内部方法会导致在该 proxy 的 target 对象上调用对应的内部方法。
Proxy 对象的 [[ProxyHandler]] 和 [[ProxyTarget]] 内部槽总是在对象创建时初始化，并且通常不能被修改。有些 Proxy 对象以允许它们随后被撤销的方式创建。当 proxy 被撤销时，其 [[ProxyHandler]] 和 [[ProxyTarget]] 内部槽被设置为
由于 Proxy 对象允许由任意 ECMAScript 代码提供内部方法的实现，因此可以定义其 handler 方法违反
在以下算法描述中，假设 obj 是 ECMAScript Proxy 对象，propertyKey 是
10.5.1 [[GetPrototypeOf]] ( )
The [[GetPrototypeOf]] internal method of a Proxy exotic object obj takes no arguments and returns either a normal completion containing either an Object or
- 执行 ?
ValidateNonRevokedProxy (obj)。 - 令 target 为 obj.[[ProxyTarget]]。
- 令 handler 为 obj.[[ProxyHandler]]。
- 断言：handler 是 Object。
- 令 trap 为 ?
GetMethod (handler,"getPrototypeOf" )。 - 如果 trap 是
undefined ，则- 返回 ? target.[[GetPrototypeOf]]()。
- 令 handlerProto 为 ?
Call (trap, handler, « target »)。 - 如果 handlerProto 不是 Object 且 handlerProto 不是
null ，则抛出TypeError 异常。 - 令 extensibleTarget 为 ?
IsExtensible (target)。 - 如果 extensibleTarget 是
true ，则返回 handlerProto。 - 令 targetProto 为 ? target.[[GetPrototypeOf]]()。
- 如果
SameValue (handlerProto, targetProto) 是false ，则抛出TypeError 异常。 - 返回 handlerProto。
Proxy 对象的 [[GetPrototypeOf]] 会强制执行以下不变量：
-
[[GetPrototypeOf]] 的结果必须是 Object 或
null 。 - 如果 target 对象不可扩展，则应用于 Proxy 对象的 [[GetPrototypeOf]] 必须返回与应用于该 Proxy 对象的 target 对象的 [[GetPrototypeOf]] 相同的值。
10.5.2 [[SetPrototypeOf]] ( proto )
The [[SetPrototypeOf]] internal method of a Proxy exotic object obj takes argument proto (an Object or
- 执行 ?
ValidateNonRevokedProxy (obj)。 - 令 target 为 obj.[[ProxyTarget]]。
- 令 handler 为 obj.[[ProxyHandler]]。
- 断言：handler 是 Object。
- 令 trap 为 ?
GetMethod (handler,"setPrototypeOf" )。 - 如果 trap 是
undefined ，则- 返回 ? target.[[SetPrototypeOf]](proto)。
- 令 boolTrapResult 为
ToBoolean (?Call (trap, handler, « target, proto »))。 - 如果 boolTrapResult 是
false ，则返回false 。 - 令 extensibleTarget 为 ?
IsExtensible (target)。 - 如果 extensibleTarget 是
true ，则返回true 。 - 令 targetProto 为 ? target.[[GetPrototypeOf]]()。
- 如果
SameValue (proto, targetProto) 是false ，则抛出TypeError 异常。 - 返回
true 。
Proxy 对象的 [[SetPrototypeOf]] 会强制执行以下不变量：
- [[SetPrototypeOf]] 的结果是 Boolean 值。
- 如果 target 对象不可扩展，则实参值必须与应用于 target 对象的 [[GetPrototypeOf]] 的结果相同。
10.5.3 [[IsExtensible]] ( )
The [[IsExtensible]] internal method of a Proxy exotic object obj takes no arguments and returns either a normal completion containing a Boolean or a throw completion. It performs the following steps when called:
- 执行 ?
ValidateNonRevokedProxy (obj)。 - 令 target 为 obj.[[ProxyTarget]]。
- 令 handler 为 obj.[[ProxyHandler]]。
- 断言：handler 是 Object。
- 令 trap 为 ?
GetMethod (handler,"isExtensible" )。 - 如果 trap 是
undefined ，则- 返回 ?
IsExtensible (target)。
- 返回 ?
- 令 boolTrapResult 为
ToBoolean (?Call (trap, handler, « target »))。 - 令 targetResult 为 ?
IsExtensible (target)。 - 如果 boolTrapResult 不是 targetResult，则抛出
TypeError 异常。 - 返回 boolTrapResult。
Proxy 对象的 [[IsExtensible]] 会强制执行以下不变量：
- [[IsExtensible]] 的结果是 Boolean 值。
- 应用于 Proxy 对象的 [[IsExtensible]] 必须返回与以相同实参应用于该 Proxy 对象的 target 对象的 [[IsExtensible]] 相同的值。
10.5.4 [[PreventExtensions]] ( )
The [[PreventExtensions]] internal method of a Proxy exotic object obj takes no arguments and returns either a normal completion containing a Boolean or a throw completion. It performs the following steps when called:
- 执行 ?
ValidateNonRevokedProxy (obj)。 - 令 target 为 obj.[[ProxyTarget]]。
- 令 handler 为 obj.[[ProxyHandler]]。
- 断言：handler 是 Object。
- 令 trap 为 ?
GetMethod (handler,"preventExtensions" )。 - 如果 trap 是
undefined ，则- 返回 ? target.[[PreventExtensions]]()。
- 令 boolTrapResult 为
ToBoolean (?Call (trap, handler, « target »))。 - 如果 boolTrapResult 是
true ，则- 令 extensibleTarget 为 ?
IsExtensible (target)。 - 如果 extensibleTarget 是
true ，则抛出TypeError 异常。
- 令 extensibleTarget 为 ?
- 返回 boolTrapResult。
Proxy 对象的 [[PreventExtensions]] 会强制执行以下不变量：
- [[PreventExtensions]] 的结果是 Boolean 值。
-
应用于 Proxy 对象的 [[PreventExtensions]] 只有在应用于该 Proxy 对象的 target 对象的 [[IsExtensible]] 是
false 时才会返回true 。
10.5.5 [[GetOwnProperty]] ( propertyKey )
The [[GetOwnProperty]] internal method of a Proxy exotic object obj takes argument propertyKey (a property key) and returns either a normal completion containing either a
- 执行 ?
ValidateNonRevokedProxy (obj)。 - 令 target 为 obj.[[ProxyTarget]]。
- 令 handler 为 obj.[[ProxyHandler]]。
- 断言：handler 是 Object。
- 令 trap 为 ?
GetMethod (handler,"getOwnPropertyDescriptor" )。 - 如果 trap 是
undefined ，则- 返回 ? target.[[GetOwnProperty]](propertyKey)。
- 令 trapResultObj 为 ?
Call (trap, handler, « target, propertyKey »)。 - 如果 trapResultObj 不是 Object 且 trapResultObj 不是
undefined ，则抛出TypeError 异常。 - 令 targetDesc 为 ? target.[[GetOwnProperty]](propertyKey)。
- 如果 trapResultObj 是
undefined ，则- 如果 targetDesc 是
undefined ，则返回undefined 。 - 如果 targetDesc.[[Configurable]] 是
false ，则抛出TypeError 异常。 - 令 extensibleTarget 为 ?
IsExtensible (target)。 - 如果 extensibleTarget 是
false ，则抛出TypeError 异常。 - 返回
undefined 。
- 如果 targetDesc 是
- 令 extensibleTarget 为 ?
IsExtensible (target)。 - 令 resultDesc 为 ?
ToPropertyDescriptor (trapResultObj)。 - 执行
CompletePropertyDescriptor (resultDesc)。 - 令 valid 为
IsCompatiblePropertyDescriptor (extensibleTarget, resultDesc, targetDesc)。 - 如果 valid 是
false ，则抛出TypeError 异常。 - 如果 resultDesc.[[Configurable]] 是
false ，则- 如果 targetDesc 是
undefined 或 targetDesc.[[Configurable]] 是true ，则- 抛出
TypeError 异常。
- 抛出
- 如果 resultDesc 具有 [[Writable]] 字段且 resultDesc.[[Writable]] 是
false ，则- 断言：targetDesc 具有 [[Writable]] 字段。
- 如果 targetDesc.[[Writable]] 是
true ，则抛出TypeError 异常。
- 如果 targetDesc 是
- 返回 resultDesc。
Proxy 对象的 [[GetOwnProperty]] 会强制执行以下不变量：
-
[[GetOwnProperty]] 的结果必须是
Property Descriptor 或undefined 。 - 如果属性作为 target 对象的不可配置自有属性存在，则不能将该属性报告为不存在。
- 如果属性作为不可扩展 target 对象的自有属性存在，则不能将该属性报告为不存在。
- 如果属性不是 target 对象的自有属性且 target 对象不可扩展，则不能将该属性报告为存在。
- 除非属性作为 target 对象的不可配置自有属性存在，否则不能将该属性报告为不可配置。
- 除非属性作为 target 对象的不可配置、不可写自有属性存在，否则不能将该属性同时报告为不可配置且不可写。
10.5.6 [[DefineOwnProperty]] ( propertyKey, propertyDesc )
The [[DefineOwnProperty]] internal method of a Proxy exotic object obj takes arguments propertyKey (a property key) and propertyDesc (a
- 执行 ?
ValidateNonRevokedProxy (obj)。 - 令 target 为 obj.[[ProxyTarget]]。
- 令 handler 为 obj.[[ProxyHandler]]。
- 断言：handler 是 Object。
- 令 trap 为 ?
GetMethod (handler,"defineProperty" )。 - 如果 trap 是
undefined ，则- 返回 ? target.[[DefineOwnProperty]](propertyKey, propertyDesc)。
- 令 propertyDescObj 为
FromPropertyDescriptor (propertyDesc)。 - 令 boolTrapResult 为
ToBoolean (?Call (trap, handler, « target, propertyKey, propertyDescObj »))。 - 如果 boolTrapResult 是
false ，则返回false 。 - 令 targetDesc 为 ? target.[[GetOwnProperty]](propertyKey)。
- 令 extensibleTarget 为 ?
IsExtensible (target)。 - 如果 propertyDesc 具有 [[Configurable]] 字段且 propertyDesc.[[Configurable]] 是
false ，则- 令 settingConfigFalse 为
true 。
- 令 settingConfigFalse 为
- 否则，
- 令 settingConfigFalse 为
false 。
- 令 settingConfigFalse 为
- 如果 targetDesc 是
undefined ，则- 如果 extensibleTarget 是
false ，则抛出TypeError 异常。 - 如果 settingConfigFalse 是
true ，则抛出TypeError 异常。
- 如果 extensibleTarget 是
- 否则，
- 如果
IsCompatiblePropertyDescriptor (extensibleTarget, propertyDesc, targetDesc) 是false ，则抛出TypeError 异常。 - 如果 settingConfigFalse 是
true 且 targetDesc.[[Configurable]] 是true ，则抛出TypeError 异常。 - 如果
IsDataDescriptor (targetDesc) 是true 、targetDesc.[[Configurable]] 是false ，且 targetDesc.[[Writable]] 是true ，则- 如果 propertyDesc 具有 [[Writable]] 字段且 propertyDesc.[[Writable]] 是
false ，则抛出TypeError 异常。
- 如果 propertyDesc 具有 [[Writable]] 字段且 propertyDesc.[[Writable]] 是
- 如果
- 返回
true 。
Proxy 对象的 [[DefineOwnProperty]] 会强制执行以下不变量：
- [[DefineOwnProperty]] 的结果是 Boolean 值。
- 如果 target 对象不可扩展，则不能添加属性。
- 除非 target 对象存在对应的不可配置自有属性，否则属性不能是不可配置的。
- 除非 target 对象存在对应的不可配置、不可写自有属性，否则不可配置属性不能是不可写的。
-
如果属性有对应的 target 对象属性，则使用 [[DefineOwnProperty]] 将该属性的
Property Descriptor 应用于 target 对象不会抛出异常。
10.5.7 [[HasProperty]] ( propertyKey )
The [[HasProperty]] internal method of a Proxy exotic object obj takes argument propertyKey (a property key) and returns either a normal completion containing a Boolean or a throw completion. It performs the following steps when called:
- 执行 ?
ValidateNonRevokedProxy (obj)。 - 令 target 为 obj.[[ProxyTarget]]。
- 令 handler 为 obj.[[ProxyHandler]]。
- 断言：handler 是 Object。
- 令 trap 为 ?
GetMethod (handler,"has" )。 - 如果 trap 是
undefined ，则- 返回 ? target.[[HasProperty]](propertyKey)。
- 令 boolTrapResult 为
ToBoolean (?Call (trap, handler, « target, propertyKey »))。 - 如果 boolTrapResult 是
false ，则- 令 targetDesc 为 ? target.[[GetOwnProperty]](propertyKey)。
- 如果 targetDesc 不是
undefined ，则- 如果 targetDesc.[[Configurable]] 是
false ，则抛出TypeError 异常。 - 令 extensibleTarget 为 ?
IsExtensible (target)。 - 如果 extensibleTarget 是
false ，则抛出TypeError 异常。
- 如果 targetDesc.[[Configurable]] 是
- 返回 boolTrapResult。
Proxy 对象的 [[HasProperty]] 会强制执行以下不变量：
- [[HasProperty]] 的结果是 Boolean 值。
- 如果属性作为 target 对象的不可配置自有属性存在，则不能将该属性报告为不存在。
- 如果属性作为 target 对象的自有属性存在且 target 对象不可扩展，则不能将该属性报告为不存在。
10.5.8 [[Get]] ( propertyKey, receiver )
The [[Get]] internal method of a Proxy exotic object obj takes arguments propertyKey (a property key) and receiver (an ECMAScript language value) and returns either a normal completion containing an ECMAScript language value or a throw completion. It performs the following steps when called:
- 执行 ?
ValidateNonRevokedProxy (obj)。 - 令 target 为 obj.[[ProxyTarget]]。
- 令 handler 为 obj.[[ProxyHandler]]。
- 断言：handler 是 Object。
- 令 trap 为 ?
GetMethod (handler,"get" )。 - 如果 trap 是
undefined ，则- 返回 ? target.[[Get]](propertyKey, receiver)。
- 令 trapResult 为 ?
Call (trap, handler, « target, propertyKey, receiver »)。 - 令 targetDesc 为 ? target.[[GetOwnProperty]](propertyKey)。
- 如果 targetDesc 不是
undefined 且 targetDesc.[[Configurable]] 是false ，则- 如果
IsDataDescriptor (targetDesc) 是true 且 targetDesc.[[Writable]] 是false ，则- 如果
SameValue (trapResult, targetDesc.[[Value]]) 是false ，则抛出TypeError 异常。
- 如果
- 如果
IsAccessorDescriptor (targetDesc) 是true 且 targetDesc.[[Get]] 是undefined ，则- 如果 trapResult 不是
undefined ，则抛出TypeError 异常。
- 如果 trapResult 不是
- 如果
- 返回 trapResult。
10.5.9 [[Set]] ( propertyKey, value, receiver )
The [[Set]] internal method of a Proxy exotic object obj takes arguments propertyKey (a property key), value (an ECMAScript language value), and receiver (an ECMAScript language value) and returns either a normal completion containing a Boolean or a throw completion. It performs the following steps when called:
- 执行 ?
ValidateNonRevokedProxy (obj)。 - 令 target 为 obj.[[ProxyTarget]]。
- 令 handler 为 obj.[[ProxyHandler]]。
- 断言：handler 是 Object。
- 令 trap 为 ?
GetMethod (handler,"set" )。 - 如果 trap 是
undefined ，则- 返回 ? target.[[Set]](propertyKey, value, receiver)。
- 令 boolTrapResult 为
ToBoolean (?Call (trap, handler, « target, propertyKey, value, receiver »))。 - 如果 boolTrapResult 是
false ，则返回false 。 - 令 targetDesc 为 ? target.[[GetOwnProperty]](propertyKey)。
- 如果 targetDesc 不是
undefined 且 targetDesc.[[Configurable]] 是false ，则- 如果
IsDataDescriptor (targetDesc) 是true 且 targetDesc.[[Writable]] 是false ，则- 如果
SameValue (value, targetDesc.[[Value]]) 是false ，则抛出TypeError 异常。
- 如果
- 如果
IsAccessorDescriptor (targetDesc) 是true ，则- 如果 targetDesc.[[Set]] 是
undefined ，则抛出TypeError 异常。
- 如果 targetDesc.[[Set]] 是
- 如果
- 返回
true 。
10.5.10 [[Delete]] ( propertyKey )
The [[Delete]] internal method of a Proxy exotic object obj takes argument propertyKey (a property key) and returns either a normal completion containing a Boolean or a throw completion. It performs the following steps when called:
- 执行 ?
ValidateNonRevokedProxy (obj)。 - 令 target 为 obj.[[ProxyTarget]]。
- 令 handler 为 obj.[[ProxyHandler]]。
- 断言：handler 是 Object。
- 令 trap 为 ?
GetMethod (handler,"deleteProperty" )。 - 如果 trap 是
undefined ，则- 返回 ? target.[[Delete]](propertyKey)。
- 令 boolTrapResult 为
ToBoolean (?Call (trap, handler, « target, propertyKey »))。 - 如果 boolTrapResult 是
false ，则返回false 。 - 令 targetDesc 为 ? target.[[GetOwnProperty]](propertyKey)。
- 如果 targetDesc 是
undefined ，则返回true 。 - 如果 targetDesc.[[Configurable]] 是
false ，则抛出TypeError 异常。 - 令 extensibleTarget 为 ?
IsExtensible (target)。 - 如果 extensibleTarget 是
false ，则抛出TypeError 异常。 - 返回
true 。
Proxy 对象的 [[Delete]] 会强制执行以下不变量：
- [[Delete]] 的结果是 Boolean 值。
- 如果属性作为 target 对象的不可配置自有属性存在，则不能将该属性报告为已删除。
- 如果属性作为 target 对象的自有属性存在且 target 对象不可扩展，则不能将该属性报告为已删除。
10.5.11 [[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of a Proxy exotic object obj takes no arguments and returns either a normal completion containing a
- 执行 ?
ValidateNonRevokedProxy (obj)。 - 令 target 为 obj.[[ProxyTarget]]。
- 令 handler 为 obj.[[ProxyHandler]]。
- 断言：handler 是 Object。
- 令 trap 为 ?
GetMethod (handler,"ownKeys" )。 - 如果 trap 是
undefined ，则- 返回 ? target.[[OwnPropertyKeys]]()。
- 令 trapResultArray 为 ?
Call (trap, handler, « target »)。 - 令 trapResult 为 ?
CreateListFromArrayLike (trapResultArray,property-key )。 - 如果 trapResult
包含 任何重复项，则抛出TypeError 异常。 - 令 extensibleTarget 为 ?
IsExtensible (target)。 - 令 targetKeys 为 ? target.[[OwnPropertyKeys]]()。
- 断言：targetKeys 是
属性键 的List 。 - 断言：targetKeys 不
包含 重复项。 - 令 targetConfigurableKeys 为新的空
List 。 - 令 targetNonconfigurableKeys 为新的空
List 。 - 对 targetKeys 的每个元素 key，执行：
- 令 propertyDesc 为 ? target.[[GetOwnProperty]](key)。
- 如果 propertyDesc 不是
undefined 且 propertyDesc.[[Configurable]] 是false ，则- 将 key 追加到 targetNonconfigurableKeys。
- 否则，
- 将 key 追加到 targetConfigurableKeys。
- 如果 extensibleTarget 是
true 且 targetNonconfigurableKeys 为空，则- 返回 trapResult。
- 令 uncheckedResultKeys 为一个
List ，其元素是 trapResult 的元素。 - 对 targetNonconfigurableKeys 的每个元素 key，执行：
- 如果 uncheckedResultKeys 不
包含 key，则抛出TypeError 异常。 - 从 uncheckedResultKeys 中移除 key。
- 如果 uncheckedResultKeys 不
- 如果 extensibleTarget 是
true ，则返回 trapResult。 - 对 targetConfigurableKeys 的每个元素 key，执行：
- 如果 uncheckedResultKeys 不
包含 key，则抛出TypeError 异常。 - 从 uncheckedResultKeys 中移除 key。
- 如果 uncheckedResultKeys 不
- 如果 uncheckedResultKeys 不为空，则抛出
TypeError 异常。 - 返回 trapResult。
10.5.12 [[Call]] ( thisArg, argList )
The [[Call]] internal method of a Proxy exotic object obj takes arguments thisArg (an ECMAScript language value) and argList (a
- 执行 ?
ValidateNonRevokedProxy (obj)。 - 令 target 为 obj.[[ProxyTarget]]。
- 令 handler 为 obj.[[ProxyHandler]]。
- 断言：handler 是 Object。
- 令 trap 为 ?
GetMethod (handler,"apply" )。 - 如果 trap 是
undefined ，则- 返回 ?
Call (target, thisArg, argList)。
- 返回 ?
- 令 argArray 为
CreateArrayFromList (argList)。 - 返回 ?
Call (trap, handler, « target, thisArg, argArray »)。
只有当
10.5.13 [[Construct]] ( argList, newTarget )
The [[Construct]] internal method of a Proxy exotic object obj takes arguments argList (a
- 执行 ?
ValidateNonRevokedProxy (obj)。 - 令 target 为 obj.[[ProxyTarget]]。
- 断言：
IsConstructor (target) 是true 。 - 令 handler 为 obj.[[ProxyHandler]]。
- 断言：handler 是 Object。
- 令 trap 为 ?
GetMethod (handler,"construct" )。 - 如果 trap 是
undefined ，则- 返回 ?
Construct (target, argList, newTarget)。
- 返回 ?
- 令 argArray 为
CreateArrayFromList (argList)。 - 令 newObj 为 ?
Call (trap, handler, « target, argArray, newTarget »)。 - 如果 newObj 不是 Object，则抛出
TypeError 异常。 - 返回 newObj。
只有当
Proxy 对象的 [[Construct]] 会强制执行以下不变量：
- [[Construct]] 的结果必须是 Object。
10.5.14 ValidateNonRevokedProxy ( proxy )
The abstract operation ValidateNonRevokedProxy takes argument proxy (a Proxy exotic object) and returns either a normal completion containing
- 如果 proxy.[[ProxyTarget]] 是
null ，则抛出TypeError 异常。 - 断言：proxy.[[ProxyHandler]] 不是
null 。 - 返回
unused 。
10.5.15 ProxyCreate ( target, handler )
The abstract operation ProxyCreate takes arguments target (an ECMAScript language value) and handler (an ECMAScript language value) and returns either a normal completion containing a Proxy exotic object or a throw completion. 它用于指定新 Proxy 对象的创建。 It performs the following steps when called:
- 如果 target 不是 Object，则抛出
TypeError 异常。 - 如果 handler 不是 Object，则抛出
TypeError 异常。 - 令 proxy 为
MakeBasicObject (« [[ProxyHandler]], [[ProxyTarget]] »)。 - 将 proxy 的基本内部方法（[[Call]] 和 [[Construct]] 除外）设置为
10.5 中指定的定义。 - 如果
IsCallable (target) 是true ，则- 按照
10.5.12 中指定的方式设置 proxy.[[Call]]。 - 如果
IsConstructor (target) 是true ，则- 按照
10.5.13 中指定的方式设置 proxy.[[Construct]]。
- 按照
- 按照
- 将 proxy.[[ProxyTarget]] 设置为 target。
- 将 proxy.[[ProxyHandler]] 设置为 handler。
- 返回 proxy。
11 ECMAScript 语言：源文本
11.1 源文本
语法
ECMAScript source text 是一系列 Unicode 码点。从 U+0000 到 U+10FFFF 的所有 Unicode 码点值，包括代理码点，都可以在 ECMAScript 语法允许的位置出现在 ECMAScript 源文本中。用于存储和交换 ECMAScript 源文本的实际编码与本规范无关。无论外部源文本编码如何，符合规范的 ECMAScript 实现都会像处理等价的
组合字符序列的组成部分会被当作单独的 Unicode 码点处理，即使用户可能认为整个序列是单个字符。
在字符串字面量、正则表达式字面量、模板字面量和标识符中，任何 Unicode 码点也可以使用显式表示码点数值的 Unicode 转义序列表达。在注释内，这种转义序列实际上会作为注释的一部分被忽略。
ECMAScript 在 Unicode 转义序列的行为上不同于 Java 编程语言。例如，在 Java 程序中，如果 Unicode 转义序列 \u000A 出现在单行注释内，它会被解释为行终止符（Unicode 码点 U+000A 是 LINE FEED (LF)），因此下一个码点不是注释的一部分。类似地，如果 Unicode 转义序列 \u000A 出现在 Java 程序的字符串字面量内，它同样会被解释为行终止符，而这是字符串字面量中不允许的——必须写成 \n 而不是 \u000A，才能使 LINE FEED (LF) 成为字符串字面量值的一部分。在 ECMAScript 程序中，出现在注释内的 Unicode 转义序列永远不会被解释，因此不能促成注释的终止。类似地，出现在 ECMAScript 程序的字符串字面量内的 Unicode 转义序列始终会构成该字面量的一部分，且永远不会被解释为行终止符或可能终止该字符串字面量的码点。
11.1.1 Static Semantics: UTF16EncodeCodePoint ( codePoint )
The abstract operation UTF16EncodeCodePoint takes argument codePoint (a Unicode code point) and returns a String. It performs the following steps when called:
11.1.2 Static Semantics: CodePointsToString ( text )
The abstract operation CodePointsToString takes argument text (a sequence of Unicode code points) and returns a String. 它将 text 转换为 String 值，如
- 令 result 为空 String。
- 对 text 的每个码点 codePoint，执行：
- 将 result 设置为 result 和
UTF16EncodeCodePoint (codePoint) 的字符串连接 。
- 将 result 设置为 result 和
- 返回 result。
11.1.3 Static Semantics: UTF16SurrogatePairToCodePoint ( lead, trail )
The abstract operation UTF16SurrogatePairToCodePoint takes arguments lead (a code unit) and trail (a code unit) and returns a code point. 将形成 UTF-16
- 断言：lead 是前导代理，且 trail 是后尾代理。
- 令 codePoint 为 (lead - 0xD800) × 0x400 + (trail - 0xDC00) + 0x10000。
- 返回码点 codePoint。
11.1.4 Static Semantics: CodePointAt ( string, position )
The abstract operation CodePointAt takes arguments string (a String) and position (a non-negative
- 令 size 为 string 的长度。
- 断言：position ≥ 0 且 position < size。
- 令 first 为 string 内索引 position 处的代码单元。
- 令 codePoint 为其数值是 first 的数值的码点。
- 如果 first 既不是前导代理也不是后尾代理，则
- 返回
Record { [[CodePoint]]: codePoint, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]:false }。
- 返回
- 如果 first 是后尾代理，或 position + 1 = size，则
- 返回
Record { [[CodePoint]]: codePoint, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]:true }。
- 返回
- 令 second 为 string 内索引 position + 1 处的代码单元。
- 如果 second 不是后尾代理，则
- 返回
Record { [[CodePoint]]: codePoint, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]:true }。
- 返回
- 将 codePoint 设置为
UTF16SurrogatePairToCodePoint (first, second)。 - 返回
Record { [[CodePoint]]: codePoint, [[CodeUnitCount]]: 2, [[IsUnpairedSurrogate]]:false }。
11.1.5 Static Semantics: StringToCodePoints ( string )
The abstract operation StringToCodePoints takes argument string (a String) and returns a
- 令 codePoints 为新的空
List 。 - 令 size 为 string 的长度。
- 令 position 为 0。
- 重复，当 position < size 时，
- 令 codePoint 为
CodePointAt (string, position)。 - 将 codePoint.[[CodePoint]] 追加到 codePoints。
- 将 position 设置为 position + codePoint.[[CodeUnitCount]]。
- 令 codePoint 为
- 返回 codePoints。
11.1.6 Static Semantics: ParseText ( sourceText, goalSymbol )
The abstract operation ParseText takes arguments sourceText (a String or a sequence of Unicode code points) and goalSymbol (a nonterminal in one of the ECMAScript grammars) and returns a
- 如果 sourceText 是 String，则将 sourceText 设置为
StringToCodePoints (sourceText)。 - 尝试使用 goalSymbol 作为
目标符号 解析 sourceText，并分析解析结果以查找任何早期错误 条件。解析和早期错误 检测可以以实现定义的 方式交错进行。 - 如果解析成功且未发现
早期错误 ，则返回由解析产生的解析树根部的Parse Node （goalSymbol 的实例）。 - 返回一个
包含 一个或多个SyntaxError 对象的List ，这些对象表示解析错误和/或早期错误 。如果存在多个解析错误或早期错误 ，则列表中错误对象的数量和顺序是实现定义的 ，但至少必须存在一个。
另请参见条款
11.2 源代码的类型
ECMAScript 代码有四种类型：
-
Global code 是被当作 ECMAScript
Script 处理的源文本。特定Script 的 global code 不包括作为FunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 、AsyncArrowFunction 、ClassDeclaration 或ClassExpression 的一部分解析的任何源文本。 -
Eval code 是提供给内置
eval函数的源文本。更精确地说，如果内置eval函数的形参是 String，则它会被当作 ECMAScriptScript 处理。特定eval调用的 eval code 是该Script 的 global code 部分。 -
Function code 是被解析以提供 ECMAScript
函数对象 的 [[ECMAScriptCode]] 和 [[FormalParameters]] 内部槽（参见10.2 ）的值的源文本。特定 ECMAScript 函数的 function code 不包括作为嵌套FunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 、AsyncArrowFunction 、ClassDeclaration 或ClassExpression 的 function code 解析的任何源文本。此外，如果上面提到的源文本被解析为：
FunctionDeclaration 或FunctionExpression 的FormalParameters 和FunctionBody ，GeneratorDeclaration 或GeneratorExpression 的FormalParameters 和GeneratorBody ，AsyncFunctionDeclaration 或AsyncFunctionExpression 的FormalParameters 和AsyncFunctionBody ，或AsyncGeneratorDeclaration 或AsyncGeneratorExpression 的FormalParameters 和AsyncGeneratorBody ，
则由该声明或表达式的
BindingIdentifier （如果有）匹配的源文本 也包含 在对应函数的 function code 中。 -
Module code 是作为
ModuleBody 提供的代码的源文本。它是在模块初始化时直接求值的代码。特定模块的 module code 不包括作为嵌套FunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 、AsyncArrowFunction 、ClassDeclaration 或ClassExpression 的一部分解析的任何源文本。
将
11.2.1 指令序言和 Use Strict 指令
Directive Prologue 是出现在
Use Strict Directive 是 "use strict" 或 'use strict'。
11.2.2 严格模式代码
ECMAScript 句法单元可以使用不受限模式或严格模式语法和语义（
-
如果 global code 以
包含 Use Strict Directive 的Directive Prologue 开头，则它是 strict mode code。 -
Module code 始终是 strict mode code。 -
ClassDeclaration 或ClassExpression 的所有部分都是 strict mode code。 -
如果 eval code 以
包含 Use Strict Directive 的Directive Prologue 开头，或者如果对eval的调用是包含 在 strict mode code 中的direct eval ，则它是 strict mode code。 -
如果关联的
FunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 或AsyncArrowFunction 包含 在 strict mode code 中，或者如果产生该函数 [[ECMAScriptCode]] 内部槽值的代码以包含 Use Strict Directive 的Directive Prologue 开头，则 function code 是 strict mode code。 -
作为实参提供给内置 Function、Generator、AsyncFunction 和 AsyncGenerator
构造函数 的 function code，如果最后一个实参是一个 String，且在处理时是一个以包含 Use Strict Directive 的Directive Prologue 开头的FunctionBody ，则它是 strict mode code。
不是 strict mode code 的 ECMAScript 代码称为 non-strict code。
11.2.2.1 Static Semantics: IsStrict ( parseNode )
The abstract operation IsStrict takes argument parseNode (a
- 如果 parseNode
匹配的源文本 是strict mode code ，则返回true 。 - 返回
false 。
11.2.3 非 ECMAScript 函数
ECMAScript 实现可以支持对函数
12 ECMAScript 语言：词法语法
ECMAScript
在若干情况下，词法输入元素的识别会对消费这些输入元素的句法语法上下文敏感。这要求词法语法具有多个
使用多个词法目标可确保不存在会影响自动分号插入的词法歧义。例如，不存在同时允许前导除法或除法赋值，以及前导
a = b
/hi/g.exec(c).map(d);其中
a = b / hi / g.exec(c).map(d);语法
12.1 Unicode 格式控制字符
Unicode 格式控制字符（即 Unicode 字符数据库中类别为 “Cf” 的字符，例如 LEFT-TO-RIGHT MARK 或 RIGHT-TO-LEFT MARK）是在缺少用于此目的的更高级协议（例如标记语言）时，用于控制一段文本格式的控制码。
允许格式控制字符出现在源文本中，有助于编辑和显示。所有格式控制字符都可以在注释中使用，也可以在字符串字面量、模板字面量和正则表达式字面量中使用。
U+FEFF (ZERO WIDTH NO-BREAK SPACE) 是一种格式控制字符，主要用于文本开头，以标记其为 Unicode 并允许检测文本的编码和字节顺序。用于此目的的 <ZWNBSP> 字符有时也可能出现在文本开头之后，例如作为连接文件的结果。在 ECMAScript 源文本中，在注释、字符串字面量、模板字面量和正则表达式字面量之外，<ZWNBSP> 码点会被当作空白字符处理（参见
12.2 空白
空白码点用于提高源文本可读性，并将 token（不可分割的词法单元）彼此分隔开，但除此之外并不重要。空白码点可以出现在任意两个 token 之间，也可以出现在输入的开头或结尾。空白码点可以出现在
ECMAScript 空白码点列于
| 码点 | 名称 | 缩写 |
|---|---|---|
U+0009
|
CHARACTER TABULATION | <TAB> |
U+000B
|
LINE TABULATION | <VT> |
U+000C
|
FORM FEED (FF) | <FF> |
U+FEFF
|
ZERO WIDTH NO-BREAK SPACE | <ZWNBSP> |
| 一般类别 “Space_Separator” 中的任何码点 | <USP> |
U+0020 (SPACE) 和 U+00A0 (NO-BREAK SPACE) 码点是 <USP> 的一部分。
除了
语法
12.3 行终止符
与空白码点类似，行终止符码点用于提高源文本可读性，并将 token（不可分割的词法单元）彼此分隔开。不过，与空白码点不同，行终止符会对句法语法的行为产生一些影响。一般而言，行终止符可以出现在任意两个 token 之间，但句法语法在少数位置禁止它们出现。行终止符还会影响自动分号插入过程（
行终止符可以出现在
行终止符\s 类匹配的空白码点集合内。
ECMAScript 行终止符码点列于
| 码点 | Unicode 名称 | 缩写 |
|---|---|---|
U+000A
|
LINE FEED (LF) | <LF> |
U+000D
|
CARRIAGE RETURN (CR) | <CR> |
U+2028
|
LINE SEPARATOR | <LS> |
U+2029
|
PARAGRAPH SEPARATOR | <PS> |
只有
语法
12.4 注释
注释可以是单行或多行。多行注释不能嵌套。
因为单行注释可以// 标记到行尾的所有码点组成。不过，行尾的
注释的行为类似于空白，并会被丢弃；但如果
语法
本节中的若干产生式在
12.5 Hashbang 注释
Hashbang 注释对位置敏感，并且像其他类型的注释一样，会从句法语法的输入元素流中丢弃。
语法
12.6 Tokens
语法
12.7 名称和关键字
本标准指定了特定码点的添加：U+0024 (DOLLAR SIGN) 和 U+005F (LOW LINE) 允许出现在
语法
非终结符
非终结符 _。
具有 Unicode 属性 “ID_Start” 和 “ID_Continue” 的码点集合分别包括具有 Unicode 属性 “Other_ID_Start” 和 “Other_ID_Continue” 的码点。
12.7.1 标识符名称
Unicode 转义序列允许出现在 \ 不贡献任何码点。\
根据 Unicode 标准规范等价的两个
12.7.1.1 Static Semantics: 早期错误
-
如果
UnicodeEscapeSequence 的IdentifierCodePoint 不是由IdentifierStartChar 词法语法产生式匹配的某个 Unicode 码点，则为语法错误。
-
如果
UnicodeEscapeSequence 的IdentifierCodePoint 不是由IdentifierPartChar 词法语法产生式匹配的某个 Unicode 码点，则为语法错误。
12.7.1.2 Static Semantics: IdentifierCodePoints
The syntax-directed operation IdentifierCodePoints takes no arguments and returns a
- 令 codePoint 为
IdentifierStart 的IdentifierCodePoint 。 - 返回 « codePoint »。
- 令 codePoints 为派生的
IdentifierName 的IdentifierCodePoints 。 - 令 codePoint 为
IdentifierPart 的IdentifierCodePoint 。 - 返回 codePoints 和 « codePoint » 的
列表连接 。
12.7.1.3 Static Semantics: IdentifierCodePoint
The syntax-directed operation IdentifierCodePoint takes no arguments and returns a code point. It is defined piecewise over the following productions:
- 返回由
IdentifierStartChar 匹配的码点。
- 返回由
IdentifierPartChar 匹配的码点。
- 返回其数值为
Hex4Digits 的 MV 的码点。
- 返回其数值为
CodePoint 的 MV 的码点。
12.7.2 关键字和保留字
关键字是一个匹配 fixed width 字体字面出现在某个句法产生式中。ECMAScript 的关键字包括 if、while、async、await 以及许多其他关键字。
保留字是不能用作标识符的 if 和 while 是保留字。await 只在 async 函数和模块内部保留。async 不是保留字；它可以不受限制地用作变量名或语句标签。
本规范使用语法产生式和await 和 yield 外，都无条件保留。await 和 yield 的例外在
-
始终允许作为标识符且不是关键字的名称，例如
Math、window、toString和_； -
永远不允许作为标识符的名称，即下方列出的
ReservedWord ，但不包括await和yield； -
上下文允许作为标识符的名称，即
await和yield； -
在严格模式代码中，上下文禁止作为标识符的名称：
let、static、implements、interface、package、private、protected和public； -
始终允许作为标识符，但也在某些句法产生式中、在不允许
Identifier 的位置作为关键字出现的名称：as、async、from、get、meta、of、set和target。
术语 条件关键字或 上下文关键字 有时用于指代落入后三类的关键字，因此它们在某些上下文中可用作标识符，而在其他上下文中可用作关键字。
语法
根据 \
\ els\u{65} 来声明一个名为 “else” 的变量。
enum 目前在本规范中未用作关键字。它是未来保留字，预留用于未来语言扩展中的关键字。
类似地，implements、interface、package、private、protected 和 public 是严格模式代码中的未来保留字。
12.8 标点符
语法
12.9 字面量
12.9.1 Null 字面量
语法
12.9.2 Boolean 字面量
语法
12.9.3 数值字面量
语法
紧跟在
例如：3in 是错误，而不是两个输入元素 3 和 in。
12.9.3.1 Static Semantics: 早期错误
- 如果
IsStrict (this production) 是true ，则为语法错误。
12.9.3.2 Static Semantics: MV
数值字面量表示
-
DecimalLiteral :: DecimalIntegerLiteral . DecimalDigits DecimalIntegerLiteral 的 MV 加上（DecimalDigits 的 MV × 10-n），其中 n 是DecimalDigits 中码点的数量，不包括所有NumericLiteralSeparator 的出现。 -
DecimalLiteral :: DecimalIntegerLiteral . ExponentPart DecimalIntegerLiteral 的 MV × 10e，其中 e 是ExponentPart 的 MV。 -
DecimalLiteral :: DecimalIntegerLiteral . DecimalDigits ExponentPart DecimalIntegerLiteral 的 MV 加上（DecimalDigits 的 MV × 10-n））× 10e，其中 n 是DecimalDigits 中码点的数量，不包括所有NumericLiteralSeparator 的出现，且 e 是ExponentPart 的 MV。 -
DecimalLiteral :: . DecimalDigits DecimalDigits 的 MV × 10-n，其中 n 是DecimalDigits 中码点的数量，不包括所有NumericLiteralSeparator 的出现。 -
DecimalLiteral :: . DecimalDigits ExponentPart DecimalDigits 的 MV × 10e - n，其中 n 是DecimalDigits 中码点的数量，不包括所有NumericLiteralSeparator 的出现，且 e 是ExponentPart 的 MV。 -
DecimalLiteral :: DecimalIntegerLiteral ExponentPart DecimalIntegerLiteral 的 MV × 10e，其中 e 是ExponentPart 的 MV。 -
DecimalIntegerLiteral :: 0 -
DecimalIntegerLiteral :: NonZeroDigit NumericLiteralSeparator opt DecimalDigits NonZeroDigit 的 MV × 10n）加上DecimalDigits 的 MV，其中 n 是DecimalDigits 中码点的数量，不包括所有NumericLiteralSeparator 的出现。 -
DecimalDigits :: DecimalDigits DecimalDigit DecimalDigits 的 MV × 10）加上DecimalDigit 的 MV。 -
DecimalDigits :: DecimalDigits NumericLiteralSeparator DecimalDigit DecimalDigits 的 MV × 10）加上DecimalDigit 的 MV。 -
ExponentPart :: ExponentIndicator SignedInteger SignedInteger 的 MV。 -
SignedInteger :: - DecimalDigits DecimalDigits 的 MV 的相反数。 -
DecimalDigit :: 0 HexDigit :: 0 OctalDigit :: 0 LegacyOctalEscapeSequence :: 0 BinaryDigit :: 0 -
DecimalDigit :: 1 NonZeroDigit :: 1 HexDigit :: 1 OctalDigit :: 1 BinaryDigit :: 1 -
DecimalDigit :: 2 NonZeroDigit :: 2 HexDigit :: 2 OctalDigit :: 2 -
DecimalDigit :: 3 NonZeroDigit :: 3 HexDigit :: 3 OctalDigit :: 3 -
DecimalDigit :: 4 NonZeroDigit :: 4 HexDigit :: 4 OctalDigit :: 4 -
DecimalDigit :: 5 NonZeroDigit :: 5 HexDigit :: 5 OctalDigit :: 5 -
DecimalDigit :: 6 NonZeroDigit :: 6 HexDigit :: 6 OctalDigit :: 6 -
DecimalDigit :: 7 NonZeroDigit :: 7 HexDigit :: 7 OctalDigit :: 7 -
DecimalDigit :: 8 NonZeroDigit :: 8 NonOctalDigit :: 8 HexDigit :: 8 -
DecimalDigit :: 9 NonZeroDigit :: 9 NonOctalDigit :: 9 HexDigit :: 9 -
HexDigit :: a HexDigit :: A -
HexDigit :: b HexDigit :: B -
HexDigit :: c HexDigit :: C -
HexDigit :: d HexDigit :: D -
HexDigit :: e HexDigit :: E -
HexDigit :: f HexDigit :: F -
BinaryDigits :: BinaryDigits BinaryDigit BinaryDigits 的 MV × 2）加上BinaryDigit 的 MV。 -
BinaryDigits :: BinaryDigits NumericLiteralSeparator BinaryDigit BinaryDigits 的 MV × 2）加上BinaryDigit 的 MV。 -
OctalDigits :: OctalDigits OctalDigit OctalDigits 的 MV × 8）加上OctalDigit 的 MV。 -
OctalDigits :: OctalDigits NumericLiteralSeparator OctalDigit OctalDigits 的 MV × 8）加上OctalDigit 的 MV。 -
LegacyOctalIntegerLiteral :: LegacyOctalIntegerLiteral OctalDigit LegacyOctalIntegerLiteral 的 MV 乘以 8）加上OctalDigit 的 MV。 -
NonOctalDecimalIntegerLiteral :: LegacyOctalLikeDecimalIntegerLiteral NonOctalDigit LegacyOctalLikeDecimalIntegerLiteral 的 MV 乘以 10）加上NonOctalDigit 的 MV。 -
NonOctalDecimalIntegerLiteral :: NonOctalDecimalIntegerLiteral DecimalDigit NonOctalDecimalIntegerLiteral 的 MV 乘以 10）加上DecimalDigit 的 MV。 -
LegacyOctalLikeDecimalIntegerLiteral :: LegacyOctalLikeDecimalIntegerLiteral OctalDigit LegacyOctalLikeDecimalIntegerLiteral 的 MV 乘以 10）加上OctalDigit 的 MV。 -
HexDigits :: HexDigits HexDigit HexDigits 的 MV × 16）加上HexDigit 的 MV。 -
HexDigits :: HexDigits NumericLiteralSeparator HexDigit HexDigits 的 MV × 16）加上HexDigit 的 MV。
12.9.3.3 Static Semantics: NumericValue
The syntax-directed operation NumericValue takes no arguments and returns a Number or a BigInt. It is defined piecewise over the following productions:
- 返回
RoundMVResult (DecimalLiteral 的 MV)。
- 返回
𝔽 (NonDecimalIntegerLiteral 的 MV)。
- 返回
𝔽 (LegacyOctalIntegerLiteral 的 MV)。
- 返回
NonDecimalIntegerLiteral 的 MV 对应的 BigInt 值。
- 返回
0 ℤ。
- 返回
NonZeroDigit 的 MV 对应的 BigInt 值。
- 令 n 为
DecimalDigits 中码点的数量，不包括所有NumericLiteralSeparator 的出现。 - 令 mv 为（
NonZeroDigit 的 MV × 10n）加上DecimalDigits 的 MV。 - 返回
ℤ (mv)。
12.9.4 字符串字面量
字符串字面量是 0 个或多个
语法
非终结符
<LF> 和 <CR> 不能出现在字符串字面量中，除非作为 \n 或 \u000A 这样的转义序列。
12.9.4.1 Static Semantics: 早期错误
- 如果
IsStrict (this production) 是true ，则为语法错误。
字符串字面量可能出现在使包围代码进入
function invalid() { "\7"; "use strict"; }12.9.4.2 Static Semantics: SV
The syntax-directed operation SV takes no arguments and returns a String.
字符串字面量表示
-
StringLiteral :: " " -
StringLiteral :: ' ' -
DoubleStringCharacters :: DoubleStringCharacter DoubleStringCharacters DoubleStringCharacter 的 SV 和DoubleStringCharacters 的 SV 的字符串连接 。 -
SingleStringCharacters :: SingleStringCharacter SingleStringCharacters SingleStringCharacter 的 SV 和SingleStringCharacters 的 SV 的字符串连接 。 -
DoubleStringCharacter :: SourceCharacter but not one of " or\ orLineTerminator SourceCharacter 匹配的码点执行UTF16EncodeCodePoint 的结果。 -
DoubleStringCharacter :: <LS> -
DoubleStringCharacter :: <PS> -
DoubleStringCharacter :: LineContinuation -
SingleStringCharacter :: SourceCharacter but not one of ' or\ orLineTerminator SourceCharacter 匹配的码点执行UTF16EncodeCodePoint 的结果。 -
SingleStringCharacter :: <LS> -
SingleStringCharacter :: <PS> -
SingleStringCharacter :: LineContinuation -
EscapeSequence :: 0 -
CharacterEscapeSequence :: SingleEscapeCharacter SingleEscapeCharacter 根据Table 33 确定。
| 转义序列 | 代码单元值 | Unicode 字符名称 | 符号 |
|---|---|---|---|
\b
|
0x0008
|
BACKSPACE | <BS> |
\t
|
0x0009
|
CHARACTER TABULATION | <HT> |
\n
|
0x000A
|
LINE FEED (LF) | <LF> |
\v
|
0x000B
|
LINE TABULATION | <VT> |
\f
|
0x000C
|
FORM FEED (FF) | <FF> |
\r
|
0x000D
|
CARRIAGE RETURN (CR) | <CR> |
\"
|
0x0022
|
QUOTATION MARK |
"
|
\'
|
0x0027
|
APOSTROPHE |
'
|
\\
|
0x005C
|
REVERSE SOLIDUS |
\
|
-
NonEscapeCharacter :: SourceCharacter but not one of EscapeCharacter orLineTerminator SourceCharacter 匹配的码点执行UTF16EncodeCodePoint 的结果。 -
EscapeSequence :: LegacyOctalEscapeSequence LegacyOctalEscapeSequence 的 MV。 -
NonOctalDecimalEscapeSequence :: 8 -
NonOctalDecimalEscapeSequence :: 9 -
HexEscapeSequence :: x HexDigit HexDigit HexEscapeSequence 的 MV。 -
Hex4Digits :: HexDigit HexDigit HexDigit HexDigit Hex4Digits 的 MV。 -
UnicodeEscapeSequence :: u{ CodePoint } CodePoint 的 MV 执行UTF16EncodeCodePoint 的结果。 -
TemplateEscapeSequence :: 0
12.9.4.3 Static Semantics: MV
-
LegacyOctalEscapeSequence :: ZeroToThree OctalDigit ZeroToThree 的 MV）加上OctalDigit 的 MV。 -
LegacyOctalEscapeSequence :: FourToSeven OctalDigit FourToSeven 的 MV）加上OctalDigit 的 MV。 -
LegacyOctalEscapeSequence :: ZeroToThree OctalDigit OctalDigit ZeroToThree 的 MV）加上（8 乘以第一个OctalDigit 的 MV）再加上第二个OctalDigit 的 MV。 -
ZeroToThree :: 0 -
ZeroToThree :: 1 -
ZeroToThree :: 2 -
ZeroToThree :: 3 -
FourToSeven :: 4 -
FourToSeven :: 5 -
FourToSeven :: 6 -
FourToSeven :: 7 -
HexEscapeSequence :: x HexDigit HexDigit HexDigit 的 MV）加上第二个HexDigit 的 MV。 -
Hex4Digits :: HexDigit HexDigit HexDigit HexDigit HexDigit 的 MV）加上（0x100 × 第二个HexDigit 的 MV）加上（0x10 × 第三个HexDigit 的 MV）再加上第四个HexDigit 的 MV。
12.9.5 正则表达式字面量
下面的产生式描述正则表达式字面量的语法，并由输入元素扫描器用于查找正则表达式字面量的结束位置。随后，构成
实现可以扩展
语法
正则表达式字面量不得为空；代码单元序列 // 会开始单行注释，而不是表示空正则表达式字面量。要指定空正则表达式，请使用：/(?:)/。
12.9.5.1 Static Semantics: BodyText
The syntax-directed operation BodyText takes no arguments and returns source text. It is defined piecewise over the following productions:
- 返回被识别为
RegularExpressionBody 的源文本。
12.9.5.2 Static Semantics: FlagText
The syntax-directed operation FlagText takes no arguments and returns source text. It is defined piecewise over the following productions:
- 返回被识别为
RegularExpressionFlags 的源文本。
12.9.6 模板字面量词法组件
语法
12.9.6.1 Static Semantics: TV
The syntax-directed operation TV takes no arguments and returns a String or
-
NoSubstitutionTemplate :: ` ` -
TemplateHead :: ` ${ -
TemplateMiddle :: } ${ -
TemplateTail :: } ` -
如果
TemplateCharacter 的 TV 是undefined 或TemplateCharacters 的 TV 是undefined ，则TemplateCharacters :: TemplateCharacter TemplateCharacters undefined 。否则，它是TemplateCharacter 的 TV 和TemplateCharacters 的 TV 的字符串连接 。 -
TemplateCharacter :: SourceCharacter but not one of ` or\ or$ orLineTerminator SourceCharacter 匹配的码点执行UTF16EncodeCodePoint 的结果。 -
TemplateCharacter :: $ -
TemplateCharacter :: \ TemplateEscapeSequence TemplateEscapeSequence 的SV 。 -
TemplateCharacter :: \ NotEscapeSequence undefined 。 -
TemplateCharacter :: LineTerminatorSequence LineTerminatorSequence 的TRV 。 -
LineContinuation :: \ LineTerminatorSequence
12.9.6.2 Static Semantics: TRV
The syntax-directed operation TRV takes no arguments and returns a String. 模板字面量组件由 TRV 解释为
-
NoSubstitutionTemplate :: ` ` -
TemplateHead :: ` ${ -
TemplateMiddle :: } ${ -
TemplateTail :: } ` -
TemplateCharacters :: TemplateCharacter TemplateCharacters TemplateCharacter 的 TRV 和TemplateCharacters 的 TRV 的字符串连接 。 -
TemplateCharacter :: SourceCharacter but not one of ` or\ or$ orLineTerminator SourceCharacter 匹配的码点执行UTF16EncodeCodePoint 的结果。 -
TemplateCharacter :: $ -
TemplateCharacter :: \ TemplateEscapeSequence TemplateEscapeSequence 的 TRV 的字符串连接 。 -
TemplateCharacter :: \ NotEscapeSequence NotEscapeSequence 的 TRV 的字符串连接 。 -
TemplateEscapeSequence :: 0 -
NotEscapeSequence :: 0 DecimalDigit DecimalDigit 的 TRV 的字符串连接 。 -
NotEscapeSequence :: x [lookahead ∉ HexDigit ] -
NotEscapeSequence :: x HexDigit [lookahead ∉ HexDigit ]HexDigit 的 TRV 的字符串连接 。 -
NotEscapeSequence :: u [lookahead ∉ HexDigit ][lookahead ≠ { ] -
NotEscapeSequence :: u HexDigit [lookahead ∉ HexDigit ]HexDigit 的 TRV 的字符串连接 。 -
NotEscapeSequence :: u HexDigit HexDigit [lookahead ∉ HexDigit ]HexDigit 的 TRV 和第二个HexDigit 的 TRV 的字符串连接 。 -
NotEscapeSequence :: u HexDigit HexDigit HexDigit [lookahead ∉ HexDigit ]HexDigit 的 TRV、第二个HexDigit 的 TRV 和第三个HexDigit 的 TRV 的字符串连接 。 -
NotEscapeSequence :: u { [lookahead ∉ HexDigit ]字符串连接 。 -
NotEscapeSequence :: u { NotCodePoint [lookahead ∉ HexDigit ]NotCodePoint 的 TRV 的字符串连接 。 -
NotEscapeSequence :: u { CodePoint [lookahead ∉ HexDigit ][lookahead ≠ } ]CodePoint 的 TRV 的字符串连接 。 -
DecimalDigit :: one of 0 1 2 3 4 5 6 7 8 9 UTF16EncodeCodePoint 的结果。 -
CharacterEscapeSequence :: NonEscapeCharacter NonEscapeCharacter 的SV 。 -
SingleEscapeCharacter :: one of ' " \ b f n r t v UTF16EncodeCodePoint 的结果。 -
HexEscapeSequence :: x HexDigit HexDigit HexDigit 的 TRV 和第二个HexDigit 的 TRV 的字符串连接 。 -
UnicodeEscapeSequence :: u Hex4Digits Hex4Digits 的 TRV 的字符串连接 。 -
UnicodeEscapeSequence :: u{ CodePoint } CodePoint 的 TRV 和代码单元 0x007D (RIGHT CURLY BRACKET) 的字符串连接 。 -
Hex4Digits :: HexDigit HexDigit HexDigit HexDigit HexDigit 的 TRV、第二个HexDigit 的 TRV、第三个HexDigit 的 TRV 和第四个HexDigit 的 TRV 的字符串连接 。 -
HexDigits :: HexDigits HexDigit HexDigits 的 TRV 和HexDigit 的 TRV 的字符串连接 。 -
HexDigit :: one of 0 1 2 3 4 5 6 7 8 9 a b c d e f A B C D E F UTF16EncodeCodePoint 的结果。 -
LineContinuation :: \ LineTerminatorSequence LineTerminatorSequence 的 TRV 的字符串连接 。 -
LineTerminatorSequence :: <LF> -
LineTerminatorSequence :: <CR> -
LineTerminatorSequence :: <LS> -
LineTerminatorSequence :: <PS> -
LineTerminatorSequence :: <CR> <LF>
12.10 自动分号插入
大多数 ECMAScript 语句和声明必须以分号终止。这类分号始终可以显式出现在源文本中。不过，为了方便，在某些情况下，这类分号可以从源文本中省略。对这些情况的描述方式是：在这些情况下，分号会被自动插入到源代码 token 流中。
12.10.1 自动分号插入规则
在以下规则中，“token” 指的是使用当前词法
分号插入有三条基本规则：
-
当源文本从左到右解析时，遇到一个不被语法任何产生式允许的 token（称为违规 token）时，如果以下一个或多个条件为真，则会在该违规 token 之前自动插入一个分号：
-
违规 token 与前一个 token 之间至少由一个
LineTerminator 分隔。 -
违规 token 是
}。 -
前一个 token 是
)，且插入的分号随后会被解析为 do-while 语句（14.7.2 ）的终止分号。
-
违规 token 与前一个 token 之间至少由一个
- 当源文本从左到右解析时，如果遇到 token 输入流的结尾，且解析器无法将输入 token 流解析为目标非终结符的单个实例，则会在输入流末尾自动插入一个分号。
-
当源文本从左到右解析时，如果遇到一个被语法某个产生式允许的 token，但该产生式是受限产生式，且该 token 会成为受限产生式中标注 “[no
LineTerminator here]” 后紧跟的终结符或非终结符的第一个 token（因此这样的 token 称为受限 token），并且该受限 token 与前一个 token 之间至少由一个LineTerminator 分隔，则会在该受限 token 之前自动插入一个分号。
不过，前述规则还有一个额外的覆盖条件：如果插入的分号随后会被解析为空语句，或者该分号会成为 for 语句头部中的两个分号之一（参见
以下是语法中仅有的受限产生式：
这些受限产生式的实际效果如下：
-
当在解析器会将
++或--标记视为后缀运算符的位置遇到该标记，并且前一个标记与++或--标记之间至少出现了一个LineTerminator 时，会在++或--标记之前自动插入分号。 -
当遇到
using标记，并且在IdentifierName 标记之前遇到LineTerminator 时，会在using标记之后自动插入分号。 -
当遇到
continue、break、return、throw或yield标记，并且在下一个标记之前遇到LineTerminator 时，会在continue、break、return、throw或yield标记之后自动插入分号。 -
当箭头函数形参后面在
=>标记之前跟着LineTerminator 时，会自动插入分号，并且该标点符会导致语法错误。 -
当
async标记后面在function、IdentifierName 或(标记之前跟着LineTerminator 时，会自动插入分号，并且async标记不会被视为与后续标记属于同一个表达式或类元素。 -
当
async标记后面在*标记之前跟着LineTerminator 时，会自动插入分号，并且该标点符会导致语法错误。
由此给 ECMAScript 程序员得出的实际建议是：
-
后缀
++或--运算符应与其操作数位于同一行。 -
using声明中的BindingList 应与using标记在同一行开始。 -
return或throw语句中的Expression ，或者yield表达式中的AssignmentExpression ，应与return、throw或yield标记在同一行开始。 -
break或continue语句中的LabelIdentifier 应与break或continue标记位于同一行。 -
箭头函数形参的末尾及其
=>应位于同一行。 -
异步函数或方法之前的
async标记应与紧随其后的标记位于同一行。
12.10.2 自动分号插入示例
本节为非规范性内容。源文本
{ 1 2 } 3即使使用自动分号插入规则，也不是 ECMAScript 语法中的有效句子。相比之下，源文本
{ 1
2 } 3同样不是有效的 ECMAScript 句子，但会通过自动分号插入转换为以下内容：
{ 1
;2 ;} 3;这是有效的 ECMAScript 句子。
源文本
for (a; b
)不是有效的 ECMAScript 句子，并且不会被自动分号插入改变，因为该分号是 for 语句头部所需的。自动分号插入永远不会插入 for 语句头部中的两个分号之一。
源文本
return
a + b会通过自动分号插入转换为以下内容：
return;
a + b;表达式 a + b 不会被当作 return 语句要返回的值，因为 return 分隔开。
源文本
a = b
++c会通过自动分号插入转换为以下内容：
a = b;
++c;token ++ 不会被当作应用于变量 b 的后缀运算符，因为 b 和 ++ 之间出现了
源文本
if (a > b)
else c = d不是有效的 ECMAScript 句子，并且不会在 else token 之前通过自动分号插入改变，即使在该点没有语法产生式适用，因为自动插入的分号随后会被解析为空语句。
源文本
a = b + c
(d + e).print()不会通过自动分号插入转换，因为第二行开头的带括号表达式可以被解释为函数调用的实参列表：
a = b + c(d + e).print()在赋值语句必须以左括号开头的情况下，程序员最好在前一个语句末尾提供显式分号，而不是依赖自动分号插入。
12.10.3 自动分号插入的有趣情形
本节为非规范性内容。ECMAScript 程序可以通过依赖自动分号插入，以很少分号的风格编写。如上所述，分号并不会在每个换行处插入，而且自动分号插入可能依赖跨越行终止符的多个 token。
随着新的句法特性加入 ECMAScript，可能会添加额外的语法产生式，使依赖自动分号插入且位于这些产生式之前的行在解析时改变语法产生式。
就本节而言，如果某个自动分号插入情形是一个可能插入也可能不插入分号的位置，取决于它之前的源文本，则该情形被认为是有趣的。本节其余部分描述此 ECMAScript 版本中若干自动分号插入的有趣情形。
12.10.3.1 语句列表中自动分号插入的有趣情形
在
- 左括号（
(）。没有分号时，两行会一起被当作CallExpression 处理。 - 左方括号（
[）。没有分号时，两行会一起被当作属性访问，而不是ArrayLiteral 或ArrayAssignmentPattern 。 - 模板字面量（
`）。没有分号时，两行会一起被解释为带标签 Template（13.3.11 ），其中前一个表达式作为MemberExpression 。 - 一元
+或-。没有分号时，两行会一起被解释为对应二元运算符的使用。 - RegExp 字面量。没有分号时，两行可能会改为被解析为
/MultiplicativeOperator ，例如当该 RegExp 有 flags 时。
12.10.3.2 自动分号插入和 “[no LineTerminator here]” 的情形
本节为非规范性内容。
ECMAScript
本节其余部分描述此 ECMAScript 版本中若干使用 “[no
12.10.3.2.1 带有可选操作数和 “[no LineTerminator here]” 的语法产生式列表
UpdateExpression 。ContinueStatement 。BreakStatement 。ReturnStatement 。YieldExpression 。- 异步函数定义（
15.8 ）与函数定义（15.2 ）的关系
13 ECMAScript 语言：表达式
13.1 标识符
语法
语法中允许 yield 和 await 作为
let
await 0;13.1.1 Static Semantics: 早期错误
-
如果
IsStrict (this production) 是true ，且Identifier 的StringValue 是"arguments" 或"eval" ，则为语法错误。
-
如果
IsStrict (this production) 是true ，则为语法错误。
- 如果此产生式具有 [Yield] 参数，则为语法错误。
- 如果此产生式具有 [Await] 参数，则为语法错误。
-
如果此产生式具有 [Yield] 参数，且
Identifier 的StringValue 是"yield" ，则为语法错误。 -
如果此产生式具有 [Await] 参数，且
Identifier 的StringValue 是"await" ，则为语法错误。
-
如果
IsStrict (this phrase) 是true ，且IdentifierName 的StringValue 是"implements" 、"interface" 、"let" 、"package" 、"private" 、"protected" 、"public" 、"static" 或"yield" 之一，则为语法错误。 -
如果句法语法的
目标符号 是Module ，且IdentifierName 的StringValue 是"await" ，则为语法错误。 -
如果
IdentifierName 的StringValue 是除yield或await之外任意ReservedWord 的StringValue ，则为语法错误。
13.1.2 Static Semantics: StringValue
The syntax-directed operation StringValue takes no arguments and returns a String. It is defined piecewise over the following productions:
- 令 idTextUnescaped 为
IdentifierName 的IdentifierCodePoints 。 - 返回
CodePointsToString (idTextUnescaped)。
- 返回
"yield" 。
- 返回
"await" 。
- 返回
IdentifierName 的StringValue 。
- 返回 0x0023 (NUMBER SIGN) 和
IdentifierName 的StringValue 的字符串连接 。
- 返回
StringLiteral 的SV 。
13.1.3 Runtime Semantics: Evaluation
- 返回 ?
ResolveBinding (Identifier 的StringValue )。
- 返回 ?
ResolveBinding ("yield" )。
- 返回 ?
ResolveBinding ("await" )。
求值
在非严格代码中，yield 可以用作标识符。求值 yield 的绑定。
13.2 主表达式
语法
补充语法
当处理产生式的实例
时，使用以下语法细化
13.2.1 this 关键字
13.2.1.1 Runtime Semantics: Evaluation
- 返回 ?
ResolveThisBinding ()。
13.2.2 标识符引用
关于
13.2.3 字面量
语法
13.2.3.1 Runtime Semantics: Evaluation
- 返回
null 。
- 如果
BooleanLiteral 是 tokenfalse，则返回false 。 - 如果
BooleanLiteral 是 tokentrue，则返回true 。
- 返回
12.9.3 中定义的NumericLiteral 的NumericValue 。
- 返回
12.9.4.2 中定义的StringLiteral 的SV 。
13.2.4 数组初始化器
数组元素可以在元素列表的开头、中间或结尾被省略。每当元素列表中的逗号前面没有
语法
13.2.4.1 Runtime Semantics: ArrayAccumulation
The syntax-directed operation ArrayAccumulation takes arguments array (an Array) and nextIndex (an
- 返回以 array 和 (nextIndex + 1) 为实参执行
Elision 的ArrayAccumulation 的结果。
- 如果存在
Elision ，则- 将 nextIndex 设置为以 array 和 nextIndex 为实参执行
Elision 的ArrayAccumulation 的结果。
- 将 nextIndex 设置为以 array 和 nextIndex 为实参执行
- 令 initResult 为 ?
AssignmentExpression 的Evaluation 。 - 令 initValue 为 ?
GetValue (initResult)。 - 执行 !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (nextIndex)), initValue)。 - 返回 nextIndex + 1。
- 如果存在
Elision ，则- 将 nextIndex 设置为以 array 和 nextIndex 为实参执行
Elision 的ArrayAccumulation 的结果。
- 将 nextIndex 设置为以 array 和 nextIndex 为实参执行
- 返回以 array 和 nextIndex 为实参执行
SpreadElement 的ArrayAccumulation 的结果。
- 将 nextIndex 设置为以 array 和 nextIndex 为实参执行派生的
ElementList 的ArrayAccumulation 的结果。 - 如果存在
Elision ，则- 将 nextIndex 设置为以 array 和 nextIndex 为实参执行
Elision 的ArrayAccumulation 的结果。
- 将 nextIndex 设置为以 array 和 nextIndex 为实参执行
- 令 initResult 为 ?
AssignmentExpression 的Evaluation 。 - 令 initValue 为 ?
GetValue (initResult)。 - 执行 !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (nextIndex)), initValue)。 - 返回 nextIndex + 1。
- 将 nextIndex 设置为以 array 和 nextIndex 为实参执行派生的
ElementList 的ArrayAccumulation 的结果。 - 如果存在
Elision ，则- 将 nextIndex 设置为以 array 和 nextIndex 为实参执行
Elision 的ArrayAccumulation 的结果。
- 将 nextIndex 设置为以 array 和 nextIndex 为实参执行
- 返回以 array 和 nextIndex 为实参执行
SpreadElement 的ArrayAccumulation 的结果。
- 令 spreadRef 为 ?
AssignmentExpression 的Evaluation 。 - 令 spreadObj 为 ?
GetValue (spreadRef)。 - 令 iteratorRecord 为 ?
GetIterator (spreadObj,sync )。 - 重复：
- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 是
done ，则返回 nextIndex。 - 执行 !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (nextIndex)), next)。 - 将 nextIndex 设置为 nextIndex + 1。
- 令 next 为 ?
使用
13.2.4.2 Runtime Semantics: Evaluation
- 令 array 为 !
ArrayCreate (0)。 - 如果存在
Elision ，则- 执行 ? 以 array 和 0 为实参执行
Elision 的ArrayAccumulation 。
- 执行 ? 以 array 和 0 为实参执行
- 返回 array。
- 令 array 为 !
ArrayCreate (0)。 - 执行 ? 以 array 和 0 为实参执行
ElementList 的ArrayAccumulation 。 - 返回 array。
- 令 array 为 !
ArrayCreate (0)。 - 令 nextIndex 为 ? 以 array 和 0 为实参执行
ElementList 的ArrayAccumulation 。 - 如果存在
Elision ，则- 执行 ? 以 array 和 nextIndex 为实参执行
Elision 的ArrayAccumulation 。
- 执行 ? 以 array 和 nextIndex 为实参执行
- 返回 array。
13.2.5 对象初始化器
对象初始化器是描述 Object 初始化的表达式，它以类似字面量的形式编写。它是由花括号包围的、零个或多个
语法
在某些上下文中，
13.2.5.1 Static Semantics: 早期错误
-
如果
MethodDefinition 的HasDirectSuper 是true ，则为语法错误。 -
如果
MethodDefinition 的PrivateBoundIdentifiers 不为空，则为语法错误。
除了描述实际对象初始化器之外，
- 如果此产生式匹配到任何源文本，则为语法错误。
此产生式存在是为了让
-
如果
PropertyDefinitionList 的PropertyNameList 包含 任何"__proto__" 的重复项，且这些项中至少有两个是从形式为PropertyDefinition : PropertyName : AssignmentExpression ObjectLiteral 包含 在正为ParseJSON 解析的Script 内（参见ParseJSON 的步骤3 ），则不应用此规则。
13.2.5.2 Static Semantics: IsComputedPropertyKey
The syntax-directed operation IsComputedPropertyKey takes no arguments and returns a Boolean. It is defined piecewise over the following productions:
- 返回
false 。
- 返回
true 。
13.2.5.3 Static Semantics: PropertyDefinitionNodes
The syntax-directed operation PropertyDefinitionNodes takes no arguments and returns a
- 返回一个新的空
List 。
- 返回 «
PropertyDefinition »。
- 令 head 为派生的
PropertyDefinitionList 的PropertyDefinitionNodes 。 - 返回 head 和 «
PropertyDefinition » 的列表连接 。
13.2.5.4 Static Semantics: PropertyNameList
The syntax-directed operation PropertyNameList takes no arguments and returns a
- 令 propertyName 为
PropertyDefinition 的PropName 。 - 如果 propertyName 是
empty ，则返回一个新的空List 。 - 返回 « propertyName »。
- 令 list 为
PropertyDefinitionList 的PropertyNameList 。 - 令 propertyName 为
PropertyDefinition 的PropName 。 - 如果 propertyName 是
empty ，则返回 list。 - 返回 list 和 « propertyName » 的
列表连接 。
13.2.5.5 Runtime Semantics: Evaluation
- 令 obj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 ? 以 obj 为实参执行
PropertyDefinitionList 的PropertyDefinitionEvaluation 。 - 返回 obj。
- 返回
IdentifierName 的StringValue 。
- 返回
StringLiteral 的SV 。
- 令 number 为
NumericLiteral 的NumericValue 。 - 返回 !
ToString (number)。
- 令 exprValue 为 ?
AssignmentExpression 的Evaluation 。 - 令 propertyName 为 ?
GetValue (exprValue)。 - 返回 ?
ToPropertyKey (propertyName)。
13.2.5.6 Runtime Semantics: PropertyDefinitionEvaluation
The syntax-directed operation PropertyDefinitionEvaluation takes argument obj (an Object) and returns either a normal completion containing
- 执行 ? 以 obj 为实参执行
PropertyDefinitionList 的PropertyDefinitionEvaluation 。 - 执行 ? 以 obj 为实参执行
PropertyDefinition 的PropertyDefinitionEvaluation 。 - 返回
unused 。
- 令 exprValue 为 ?
AssignmentExpression 的Evaluation 。 - 令 fromValue 为 ?
GetValue (exprValue)。 - 令 excludedNames 为新的空
List 。 - 执行 ?
CopyDataProperties (obj, fromValue, excludedNames)。 - 返回
unused 。
- 令 propertyName 为
IdentifierReference 的StringValue 。 - 令 exprValue 为 ?
IdentifierReference 的Evaluation 。 - 令 propertyValue 为 ?
GetValue (exprValue)。 - 断言：obj 是一个普通的、可扩展的对象，且没有不可配置属性。
- 执行 !
CreateDataPropertyOrThrow (obj, propertyName, propertyValue)。 - 返回
unused 。
- 令 propertyKey 为 ?
PropertyName 的Evaluation 。 - 如果此
PropertyDefinition 包含 在正为ParseJSON 求值的Script 内（参见ParseJSON 的步骤6 ），则- 令 isProtoSetter 为
false 。
- 令 isProtoSetter 为
- 否则，如果 propertyKey 是
"__proto__" 且PropertyName 的IsComputedPropertyKey 是false ，则- 令 isProtoSetter 为
true 。
- 令 isProtoSetter 为
- 否则，
- 令 isProtoSetter 为
false 。
- 令 isProtoSetter 为
- 如果
IsAnonymousFunctionDefinition (AssignmentExpression ) 是true 且 isProtoSetter 是false ，则- 令 propertyValue 为 ? 以 propertyKey 为实参执行
AssignmentExpression 的NamedEvaluation 。
- 令 propertyValue 为 ? 以 propertyKey 为实参执行
- 否则，
- 令 exprValueRef 为 ?
AssignmentExpression 的Evaluation 。 - 令 propertyValue 为 ?
GetValue (exprValueRef)。
- 令 exprValueRef 为 ?
- 如果 isProtoSetter 是
true ，则- 如果 propertyValue 是 Object 或 propertyValue 是
null ，则- 执行 ! obj.[[SetPrototypeOf]](propertyValue)。
- 返回
unused 。
- 如果 propertyValue 是 Object 或 propertyValue 是
- 断言：obj 是一个普通的、可扩展的对象，且没有不可配置属性。
- 执行 !
CreateDataPropertyOrThrow (obj, propertyKey, propertyValue)。 - 返回
unused 。
- 执行 ? 以 obj 和
true 为实参执行MethodDefinition 的MethodDefinitionEvaluation 。 - 返回
unused 。
13.2.6 函数定义表达式
关于
关于
关于
关于
关于
13.2.7 正则表达式字面量
语法
参见
13.2.7.1 Static Semantics: 早期错误
-
如果
IsValidRegularExpressionLiteral (RegularExpressionLiteral ) 是false ，则为语法错误。
13.2.7.2 Static Semantics: IsValidRegularExpressionLiteral ( literal )
The abstract operation IsValidRegularExpressionLiteral takes argument literal (a
- 令 flags 为 literal 的
FlagText 。 - 如果 flags
包含 除d、g、i、m、s、u、v或y之外的任何码点，则返回false 。 - 如果 flags
包含 任何出现次数超过一次的码点，则返回false 。 - 如果 flags
包含 u，则令 u 为true ；否则令 u 为false 。 - 如果 flags
包含 v，则令 v 为true ；否则令 v 为false 。 - 令 patternText 为 literal 的
BodyText 。 - 如果 u 是
false 且 v 是false ，则- 令 stringValue 为
CodePointsToString (patternText)。 - 将 patternText 设置为将 stringValue 的每个 16 位元素解释为 Unicode BMP 码点所得的码点序列。不会对这些元素应用 UTF-16 解码。
- 令 stringValue 为
- 令 parseResult 为
ParsePattern (patternText, u, v)。 - 如果 parseResult 是
Parse Node ，则返回true 。 - 返回
false 。
13.2.7.3 Runtime Semantics: Evaluation
- 令 pattern 为
CodePointsToString (RegularExpressionLiteral 的BodyText )。 - 令 flags 为
CodePointsToString (RegularExpressionLiteral 的FlagText )。 - 返回 !
RegExpCreate (pattern, flags)。
13.2.8 模板字面量
语法
13.2.8.1 Static Semantics: 早期错误
-
如果未设置 [Tagged] 参数且
NoSubstitutionTemplate Contains NotEscapeSequence ，则为语法错误。
-
如果以
false 为实参的TemplateLiteral 的TemplateStrings 中元素数量大于或等于 232，则为语法错误。
-
如果未设置 [Tagged] 参数且
TemplateHead Contains NotEscapeSequence ，则为语法错误。
-
如果未设置 [Tagged] 参数且
TemplateTail Contains NotEscapeSequence ，则为语法错误。
-
如果未设置 [Tagged] 参数且
TemplateMiddle Contains NotEscapeSequence ，则为语法错误。
13.2.8.2 Static Semantics: TemplateStrings
The syntax-directed operation TemplateStrings takes argument raw (a Boolean) and returns a
- 返回 «
TemplateString (NoSubstitutionTemplate , raw) »。
- 令 head 为 «
TemplateString (TemplateHead , raw) »。 - 令 tail 为以 raw 为实参的
TemplateSpans 的TemplateStrings 。 - 返回 head 和 tail 的
列表连接 。
- 返回 «
TemplateString (TemplateTail , raw) »。
- 令 middle 为以 raw 为实参的
TemplateMiddleList 的TemplateStrings 。 - 令 tail 为 «
TemplateString (TemplateTail , raw) »。 - 返回 middle 和 tail 的
列表连接 。
- 返回 «
TemplateString (TemplateMiddle , raw) »。
- 令 front 为以 raw 为实参的
TemplateMiddleList 的TemplateStrings 。 - 令 last 为 «
TemplateString (TemplateMiddle , raw) »。 - 返回 front 和 last 的
列表连接 。
13.2.8.3 Static Semantics: TemplateString ( templateToken, raw )
The abstract operation TemplateString takes arguments templateToken (a
如果 raw 是
13.2.8.4 GetTemplateObject ( templateLiteral )
The abstract operation GetTemplateObject takes argument templateLiteral (a
- 令 realm 为
当前 Realm Record 。 - 令 templateRegistry 为 realm.[[TemplateMap]]。
- 对 templateRegistry 的每个元素 element，执行：
- 如果 element.[[Site]] 与 templateLiteral 是同一个
Parse Node ，则- 返回 element.[[Array]]。
- 如果 element.[[Site]] 与 templateLiteral 是同一个
- 令 rawStrings 为以
true 为实参的 templateLiteral 的TemplateStrings 。 - 断言：rawStrings 是 Strings 的
List 。 - 令 cookedStrings 为以
false 为实参的 templateLiteral 的TemplateStrings 。 - 令 count 为
List cookedStrings 中元素的数量。 - 断言：count ≤ 232 - 1。
- 令 template 为 !
ArrayCreate (count)。 - 令 rawObj 为 !
ArrayCreate (count)。 - 令 index 为 0。
- 重复，当 index < count 时，
- 令 propertyKey 为 !
ToString (𝔽 (index))。 - 令 cookedValue 为 cookedStrings[index]。
- 执行 !
DefinePropertyOrThrow (template, propertyKey, PropertyDescriptor { [[Value]]: cookedValue, [[Writable]]:false , [[Enumerable]]:true , [[Configurable]]:false })。 - 令 rawValue 为 String 值 rawStrings[index]。
- 执行 !
DefinePropertyOrThrow (rawObj, propertyKey, PropertyDescriptor { [[Value]]: rawValue, [[Writable]]:false , [[Enumerable]]:true , [[Configurable]]:false })。 - 将 index 设置为 index + 1。
- 令 propertyKey 为 !
- 执行 !
SetIntegrityLevel (rawObj,frozen )。 - 执行 !
DefinePropertyOrThrow (template,"raw" , PropertyDescriptor { [[Value]]: rawObj, [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:false })。 - 执行 !
SetIntegrityLevel (template,frozen )。 - 将
Record { [[Site]]: templateLiteral, [[Array]]: template } 追加到 realm.[[TemplateMap]]。 - 返回 template。
创建模板对象不会导致 abrupt completion。
本规范的未来版本可能会定义模板对象的附加不可枚举属性。
13.2.8.5 Runtime Semantics: SubstitutionEvaluation
The syntax-directed operation SubstitutionEvaluation takes no arguments and returns either a normal completion containing a
- 返回一个新的空
List 。
- 令 subRef 为 ?
Expression 的Evaluation 。 - 令 sub 为 ?
GetValue (subRef)。 - 返回 « sub »。
- 令 preceding 为 ?
TemplateMiddleList 的SubstitutionEvaluation 。 - 令 nextRef 为 ?
Expression 的Evaluation 。 - 令 next 为 ?
GetValue (nextRef)。 - 返回 preceding 和 « next » 的
列表连接 。
13.2.8.6 Runtime Semantics: Evaluation
- 返回
12.9.6 中定义的NoSubstitutionTemplate 的TV 。
- 令 head 为
12.9.6 中定义的TemplateHead 的TV 。 - 令 subRef 为 ?
Expression 的Evaluation 。 - 令 sub 为 ?
GetValue (subRef)。 - 令 middle 为 ?
ToString (sub)。 - 令 tail 为 ?
TemplateSpans 的Evaluation 。 - 返回 head、middle 和 tail 的
字符串连接 。
应用于 String.prototype.concat，而不是 + 运算符。
- 返回
12.9.6 中定义的TemplateTail 的TV 。
- 令 head 为 ?
TemplateMiddleList 的Evaluation 。 - 令 tail 为
12.9.6 中定义的TemplateTail 的TV 。 - 返回 head 和 tail 的
字符串连接 。
- 令 head 为
12.9.6 中定义的TemplateMiddle 的TV 。 - 令 subRef 为 ?
Expression 的Evaluation 。 - 令 sub 为 ?
GetValue (subRef)。 - 令 middle 为 ?
ToString (sub)。 - 返回 head 和 middle 的
字符串连接 。
应用于 String.prototype.concat，而不是 + 运算符。
- 令 rest 为 ?
TemplateMiddleList 的Evaluation 。 - 令 middle 为
12.9.6 中定义的TemplateMiddle 的TV 。 - 令 subRef 为 ?
Expression 的Evaluation 。 - 令 sub 为 ?
GetValue (subRef)。 - 令 last 为 ?
ToString (sub)。 - 返回 rest、middle 和 last 的
字符串连接 。
应用于 String.prototype.concat，而不是 + 运算符。
13.2.9 分组运算符
13.2.9.1 Static Semantics: 早期错误
13.2.9.2 Runtime Semantics: Evaluation
- 令 expr 为由
CoverParenthesizedExpressionAndArrowParameterList 覆盖的 ParenthesizedExpression 。 - 返回 ? expr 的
Evaluation 。
- 返回 ?
Expression 的Evaluation 。这可能是 Reference 类型。
此算法不会对 delete 和 typeof 等运算符可以应用于带括号表达式。
13.3 左手边表达式
语法
补充语法
当处理产生式的实例
时，使用以下语法细化
13.3.1 静态语义
13.3.1.1 Static Semantics: 早期错误
- 如果此产生式匹配到任何源文本，则为语法错误。
此产生式存在是为了防止自动分号插入规则（
a?.b
`c`从而避免其被解释为两个有效语句。其目的是保持与没有可选链的类似代码一致：
a.b
`c`这是一个有效语句，且不会应用自动分号插入。
13.3.2 属性访问器
属性通过名称访问，使用点号记法：
或方括号记法：
点号记法由以下句法转换解释：
在行为上等同于
并且类似地
在行为上等同于
其中 <identifier-name-string> 是
13.3.2.1 Runtime Semantics: Evaluation
- 令 baseRef 为 ?
MemberExpression 的Evaluation 。 - 令 baseValue 为 ?
GetValue (baseRef)。 - 令 strict 为
IsStrict (thisMemberExpression )。 - 返回 ?
EvaluatePropertyAccessWithExpressionKey (baseValue,Expression , strict)。
- 令 baseRef 为 ?
MemberExpression 的Evaluation 。 - 令 baseValue 为 ?
GetValue (baseRef)。 - 令 strict 为
IsStrict (thisMemberExpression )。 - 返回
EvaluatePropertyAccessWithIdentifierKey (baseValue,IdentifierName , strict)。
- 令 baseRef 为 ?
MemberExpression 的Evaluation 。 - 令 baseValue 为 ?
GetValue (baseRef)。 - 令 fieldNameString 为
PrivateIdentifier 的StringValue 。 - 返回
MakePrivateReference (baseValue, fieldNameString)。
- 令 baseRef 为 ?
CallExpression 的Evaluation 。 - 令 baseValue 为 ?
GetValue (baseRef)。 - 令 strict 为
IsStrict (thisCallExpression )。 - 返回 ?
EvaluatePropertyAccessWithExpressionKey (baseValue,Expression , strict)。
- 令 baseRef 为 ?
CallExpression 的Evaluation 。 - 令 baseValue 为 ?
GetValue (baseRef)。 - 令 strict 为
IsStrict (thisCallExpression )。 - 返回
EvaluatePropertyAccessWithIdentifierKey (baseValue,IdentifierName , strict)。
- 令 baseRef 为 ?
CallExpression 的Evaluation 。 - 令 baseValue 为 ?
GetValue (baseRef)。 - 令 fieldNameString 为
PrivateIdentifier 的StringValue 。 - 返回
MakePrivateReference (baseValue, fieldNameString)。
13.3.3 EvaluatePropertyAccessWithExpressionKey ( baseValue, expr, strict )
The abstract operation EvaluatePropertyAccessWithExpressionKey takes arguments baseValue (an ECMAScript language value), expr (an
- 令 propertyNameRef 为 ? expr 的
Evaluation 。 - 令 propertyNameValue 为 ?
GetValue (propertyNameRef)。 - 注：在大多数情况下，
ToPropertyKey 会在此步骤之后立即对 propertyNameValue 执行。不过，在a[b] = c的情况下，它要到c求值之后才会执行。 - 返回
Reference Record { [[Base]]: baseValue, [[ReferencedName]]: propertyNameValue, [[Strict]]: strict, [[ThisValue]]:empty }。
13.3.4 EvaluatePropertyAccessWithIdentifierKey ( baseValue, identifierName, strict )
The abstract operation EvaluatePropertyAccessWithIdentifierKey takes arguments baseValue (an ECMAScript language value), identifierName (an
- 令 propertyNameString 为 identifierName 的
StringValue 。 - 返回
Reference Record { [[Base]]: baseValue, [[ReferencedName]]: propertyNameString, [[Strict]]: strict, [[ThisValue]]:empty }。
13.3.5 new 运算符
13.3.5.1 Runtime Semantics: Evaluation
- 返回 ?
EvaluateNew (NewExpression ,empty )。
- 返回 ?
EvaluateNew (MemberExpression ,Arguments )。
13.3.5.1.1 EvaluateNew ( constructExpr, argumentsNode )
The abstract operation EvaluateNew takes arguments constructExpr (a
- 令 ref 为 ? constructExpr 的
Evaluation 。 - 令 ctor 为 ?
GetValue (ref)。 - 如果 argumentsNode 是
empty ，则- 令 argList 为一个新的空
List 。
- 令 argList 为一个新的空
- 否则，
- 令 argList 为 ? argumentsNode 的
ArgumentListEvaluation 。
- 令 argList 为 ? argumentsNode 的
- 如果
IsConstructor (ctor) 是false ，则抛出TypeError 异常。 - 返回 ?
Construct (ctor, argList)。
13.3.6 函数调用
13.3.6.1 Runtime Semantics: Evaluation
- 令 expr 为由
CoverCallExpressionAndAsyncArrowHead 覆盖的 CallMemberExpression 。 - 令 memberExpr 为 expr 的
MemberExpression 。 - 令 args 为 expr 的
Arguments 。 - 令 ref 为 ? memberExpr 的
Evaluation 。 - 令 func 为 ?
GetValue (ref)。 - 如果 ref 是
Reference Record ，IsPropertyReference (ref) 是false ，且 ref.[[ReferencedName]] 是"eval" ，则- 如果
SameValue (func,%eval% ) 是true ，则- 令 argList 为 ? args 的
ArgumentListEvaluation 。 - 如果 argList 没有元素，则返回
undefined 。 - 令 evalArg 为 argList 的第一个元素。
- 如果
IsStrict (thisCallExpression ) 是true ，则令 strictCaller 为true ；否则令 strictCaller 为false 。 - 返回 ?
PerformEval (evalArg, strictCaller,true )。
- 令 argList 为 ? args 的
- 如果
- 令 thisCall 为此
CallExpression 。 - 令 tailCall 为
IsInTailPosition (thisCall)。 - 返回 ?
EvaluateCall (func, ref, args, tailCall)。
执行步骤
- 令 ref 为 ?
CallExpression 的Evaluation 。 - 令 func 为 ?
GetValue (ref)。 - 令 thisCall 为此
CallExpression 。 - 令 tailCall 为
IsInTailPosition (thisCall)。 - 返回 ?
EvaluateCall (func, ref,Arguments , tailCall)。
13.3.6.2 EvaluateCall ( func, thisValueRef, argumentListNode, tailPosition )
The abstract operation EvaluateCall takes arguments func (an ECMAScript language value), thisValueRef (an ECMAScript language value or a
- 如果 thisValueRef 是
Reference Record ，则- 如果
IsPropertyReference (thisValueRef) 是true ，则- 令 thisValue 为
GetThisValue (thisValueRef)。
- 令 thisValue 为
- 否则，
- 令 refEnv 为 thisValueRef.[[Base]]。
- 断言：refEnv 是
Environment Record 。 - 令 thisValue 为 refEnv.
WithBaseObject ()。
- 如果
- 否则，
- 令 thisValue 为
undefined 。
- 令 thisValue 为
- 令 argList 为 ? argumentListNode 的
ArgumentListEvaluation 。 - 如果 func 不是 Object，则抛出
TypeError 异常。 - 如果
IsCallable (func) 是false ，则抛出TypeError 异常。 - 如果 tailPosition 是
true ，则执行PrepareForTailCall ()。 - 返回 ?
Call (func, thisValue, argList)。
13.3.7 super 关键字
13.3.7.1 Runtime Semantics: Evaluation
- 令 envRecord 为
GetThisEnvironment ()。 - 令 actualThis 为 ? envRecord.
GetThisBinding ()。 - 令 propertyNameRef 为 ?
Expression 的Evaluation 。 - 令 propertyNameValue 为 ?
GetValue (propertyNameRef)。 - 令 strict 为
IsStrict (thisSuperProperty )。 - 注：在大多数情况下，
ToPropertyKey 会在此步骤之后立即对 propertyNameValue 执行。不过，在super[b] = c的情况下，它要到c求值之后才会执行。 - 返回
MakeSuperPropertyReference (actualThis, propertyNameValue, strict)。
- 令 envRecord 为
GetThisEnvironment ()。 - 令 actualThis 为 ? envRecord.
GetThisBinding ()。 - 令 propertyKey 为
IdentifierName 的StringValue 。 - 令 strict 为
IsStrict (thisSuperProperty )。 - 返回
MakeSuperPropertyReference (actualThis, propertyKey, strict)。
- 令 newTarget 为
GetNewTarget ()。 - 断言：newTarget 是 constructor。
- 令 superCtor 为
GetSuperConstructor ()。 - 令 argList 为 ?
Arguments 的ArgumentListEvaluation 。 - 如果
IsConstructor (superCtor) 是false ，则抛出TypeError 异常。 - 令 result 为 ?
Construct (superCtor, argList, newTarget)。 - 令 thisER 为
GetThisEnvironment ()。 - 断言：thisER 是
Function Environment Record 。 - 执行 ?
BindThisValue (thisER, result)。 - 令 funcObj 为 thisER.[[FunctionObject]]。
- 断言：funcObj 是 ECMAScript
函数对象 。 - 执行 ?
InitializeInstanceElements (result, funcObj)。 - 返回 result。
13.3.7.2 GetSuperConstructor ( )
The abstract operation GetSuperConstructor takes no arguments and returns an Object or
- 令 envRecord 为
GetThisEnvironment ()。 - 断言：envRecord 是
Function Environment Record 。 - 令 activeFunc 为 envRecord.[[FunctionObject]]。
- 断言：activeFunc 是 ECMAScript
函数对象 。 - 令 superCtor 为 ! activeFunc.[[GetPrototypeOf]]()。
- 返回 superCtor。
13.3.7.3 MakeSuperPropertyReference ( actualThis, propertyKey, strict )
The abstract operation MakeSuperPropertyReference takes arguments actualThis (an ECMAScript language value), propertyKey (an ECMAScript language value), and strict (a Boolean) and returns a
- 令 envRecord 为
GetThisEnvironment ()。 - 断言：envRecord.
HasSuperBinding () 是true 。 - 断言：envRecord 是
Function Environment Record 。 - 令 baseValue 为
GetSuperBase (envRecord)。 - 返回
Reference Record { [[Base]]: baseValue, [[ReferencedName]]: propertyKey, [[Strict]]: strict, [[ThisValue]]: actualThis }。
13.3.8 实参列表
求值实参列表会产生一个值的
13.3.8.1 Runtime Semantics: ArgumentListEvaluation
The syntax-directed operation ArgumentListEvaluation takes no arguments and returns either a normal completion containing a
- 返回一个新的空
List 。
- 令 ref 为 ?
AssignmentExpression 的Evaluation 。 - 令 arg 为 ?
GetValue (ref)。 - 返回 « arg »。
- 令 list 为一个新的空
List 。 - 令 spreadRef 为 ?
AssignmentExpression 的Evaluation 。 - 令 spreadObj 为 ?
GetValue (spreadRef)。 - 令 iteratorRecord 为 ?
GetIterator (spreadObj,sync )。 - 重复：
- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 是
done ，则返回 list。 - 将 next 追加到 list。
- 令 next 为 ?
- 令 precedingArgs 为 ?
ArgumentList 的ArgumentListEvaluation 。 - 令 ref 为 ?
AssignmentExpression 的Evaluation 。 - 令 arg 为 ?
GetValue (ref)。 - 返回 precedingArgs 和 « arg » 的
列表连接 。
- 令 precedingArgs 为 ?
ArgumentList 的ArgumentListEvaluation 。 - 令 spreadRef 为 ?
AssignmentExpression 的Evaluation 。 - 令 iteratorRecord 为 ?
GetIterator (?GetValue (spreadRef),sync )。 - 重复：
- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 是
done ，则返回 precedingArgs。 - 将 next 追加到 precedingArgs。
- 令 next 为 ?
- 令 templateLiteral 为此
TemplateLiteral 。 - 令 siteObj 为
GetTemplateObject (templateLiteral)。 - 返回 « siteObj »。
- 令 templateLiteral 为此
TemplateLiteral 。 - 令 siteObj 为
GetTemplateObject (templateLiteral)。 - 令 remaining 为 ?
SubstitutionTemplate 的ArgumentListEvaluation 。 - 返回 « siteObj » 和 remaining 的
列表连接 。
- 令 firstSubRef 为 ?
Expression 的Evaluation 。 - 令 firstSub 为 ?
GetValue (firstSubRef)。 - 令 restSub 为 ?
TemplateSpans 的SubstitutionEvaluation 。 - 断言：restSub 是一个可能为空的
List 。 - 返回 « firstSub » 和 restSub 的
列表连接 。
13.3.9 可选链
?. 开头。13.3.9.1 Runtime Semantics: Evaluation
- 令 baseRef 为 ?
MemberExpression 的Evaluation 。 - 令 baseValue 为 ?
GetValue (baseRef)。 - 如果 baseValue 是
undefined 或null ，则- 返回
undefined 。
- 返回
- 返回 ? 以 baseValue 和 baseRef 为实参执行
OptionalChain 的ChainEvaluation 。
- 令 baseRef 为 ?
CallExpression 的Evaluation 。 - 令 baseValue 为 ?
GetValue (baseRef)。 - 如果 baseValue 是
undefined 或null ，则- 返回
undefined 。
- 返回
- 返回 ? 以 baseValue 和 baseRef 为实参执行
OptionalChain 的ChainEvaluation 。
- 令 baseRef 为 ?
OptionalExpression 的Evaluation 。 - 令 baseValue 为 ?
GetValue (baseRef)。 - 如果 baseValue 是
undefined 或null ，则- 返回
undefined 。
- 返回
- 返回 ? 以 baseValue 和 baseRef 为实参执行
OptionalChain 的ChainEvaluation 。
13.3.9.2 Runtime Semantics: ChainEvaluation
The syntax-directed operation ChainEvaluation takes arguments baseValue (an ECMAScript language value) and baseRef (an ECMAScript language value or a
- 令 thisChain 为此
OptionalChain 。 - 令 tailCall 为
IsInTailPosition (thisChain)。 - 返回 ?
EvaluateCall (baseValue, baseRef,Arguments , tailCall)。
- 令 strict 为
IsStrict (thisOptionalChain )。 - 返回 ?
EvaluatePropertyAccessWithExpressionKey (baseValue,Expression , strict)。
- 令 strict 为
IsStrict (thisOptionalChain )。 - 返回
EvaluatePropertyAccessWithIdentifierKey (baseValue,IdentifierName , strict)。
- 令 fieldNameString 为
PrivateIdentifier 的StringValue 。 - 返回
MakePrivateReference (baseValue, fieldNameString)。
- 令 optionalChain 为
OptionalChain 。 - 令 newRef 为 ? 以 baseValue 和 baseRef 为实参执行 optionalChain 的
ChainEvaluation 。 - 令 newValue 为 ?
GetValue (newRef)。 - 令 thisChain 为此
OptionalChain 。 - 令 tailCall 为
IsInTailPosition (thisChain)。 - 返回 ?
EvaluateCall (newValue, newRef,Arguments , tailCall)。
- 令 optionalChain 为
OptionalChain 。 - 令 newRef 为 ? 以 baseValue 和 baseRef 为实参执行 optionalChain 的
ChainEvaluation 。 - 令 newValue 为 ?
GetValue (newRef)。 - 令 strict 为
IsStrict (thisOptionalChain )。 - 返回 ?
EvaluatePropertyAccessWithExpressionKey (newValue,Expression , strict)。
- 令 optionalChain 为
OptionalChain 。 - 令 newRef 为 ? 以 baseValue 和 baseRef 为实参执行 optionalChain 的
ChainEvaluation 。 - 令 newValue 为 ?
GetValue (newRef)。 - 令 strict 为
IsStrict (thisOptionalChain )。 - 返回
EvaluatePropertyAccessWithIdentifierKey (newValue,IdentifierName , strict)。
- 令 optionalChain 为
OptionalChain 。 - 令 newRef 为 ? 以 baseValue 和 baseRef 为实参执行 optionalChain 的
ChainEvaluation 。 - 令 newValue 为 ?
GetValue (newRef)。 - 令 fieldNameString 为
PrivateIdentifier 的StringValue 。 - 返回
MakePrivateReference (newValue, fieldNameString)。
13.3.10 Import 调用
13.3.10.1 Runtime Semantics: Evaluation
- 返回 ?
EvaluateImportCall (第一个AssignmentExpression , 第二个AssignmentExpression )。
13.3.10.2 EvaluateImportCall ( specifierExpr [ , optionsExpr ] )
The abstract operation EvaluateImportCall takes argument specifierExpr (a
- 令 referrer 为
GetActiveScriptOrModule ()。 - 如果 referrer 是
null ，则将 referrer 设置为当前 Realm Record 。 - 令 specifierRef 为 ? specifierExpr 的
Evaluation 。 - 令 specifier 为 ?
GetValue (specifierRef)。 - 如果 optionsExpr 存在，则
- 令 optionsRef 为 ? optionsExpr 的
Evaluation 。 - 令 options 为 ?
GetValue (optionsRef)。
- 令 optionsRef 为 ? optionsExpr 的
- 否则，
- 令 options 为
undefined 。
- 令 options 为
- 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 specifierString 为
Completion (ToString (specifier))。 IfAbruptRejectPromise (specifierString, promiseCapability)。- 令 attrs 为新的空
List 。 - 如果 options 不是
undefined ，则- 如果 options 不是 Object，则
- 执行 !
Call (promiseCapability.[[Reject]],undefined , « 一个新创建的TypeError 对象 »)。 - 返回 promiseCapability.[[Promise]]。
- 执行 !
- 令 attrsObj 为
Completion (Get (options,"with" )))。 IfAbruptRejectPromise (attrsObj, promiseCapability)。- 如果 attrsObj 不是
undefined ，则- 如果 attrsObj 不是 Object，则
- 执行 !
Call (promiseCapability.[[Reject]],undefined , « 一个新创建的TypeError 对象 »)。 - 返回 promiseCapability.[[Promise]]。
- 执行 !
- 令 entries 为
Completion (EnumerableOwnProperties (attrsObj,key+value ))。 IfAbruptRejectPromise (entries, promiseCapability)。- 对 entries 的每个元素 entry，执行：
- 令 key 为 !
Get (entry,"0" )。 - 令 value 为 !
Get (entry,"1" )。 - 如果 key 是 String，则
- 如果 value 不是 String，则
- 执行 !
Call (promiseCapability.[[Reject]],undefined , « 一个新创建的TypeError 对象 »)。 - 返回 promiseCapability.[[Promise]]。
- 执行 !
- 将
ImportAttribute Record { [[Key]]: key, [[Value]]: value } 追加到 attrs。
- 如果 value 不是 String，则
- 令 key 为 !
- 如果 attrsObj 不是 Object，则
- 如果
AllImportAttributesSupported (attrs) 是false ，则- 执行 !
Call (promiseCapability.[[Reject]],undefined , « 一个新创建的TypeError 对象 »)。 - 返回 promiseCapability.[[Promise]]。
- 执行 !
- 按照 attrs 的 [[Key]] 字段的词典序对 attrs 进行排序，并将每个这种字段的值视为 UTF-16 代码单元值序列。注：此排序唯一可观察之处在于，
宿主 被禁止基于属性枚举顺序改变行为。
- 如果 options 不是 Object，则
- 令 moduleRequest 为一个新的
ModuleRequest Record { [[Specifier]]: specifierString, [[Attributes]]: attrs }。 - 执行
HostLoadImportedModule (referrer, moduleRequest,empty , promiseCapability)。 - 返回 promiseCapability.[[Promise]]。
13.3.10.3 ContinueDynamicImport ( promiseCapability, moduleCompletion )
The abstract operation ContinueDynamicImport takes arguments promiseCapability (a import()
- 如果 moduleCompletion 是 abrupt completion，则
- 执行 !
Call (promiseCapability.[[Reject]],undefined , « moduleCompletion.[[Value]] »)。 - 返回
unused 。
- 执行 !
- 令 module 为 moduleCompletion.[[Value]]。
- 令 loadPromise 为 module.
LoadRequestedModules ()。 - 令 rejectedClosure 为一个具有形参 (reason) 的新
Abstract Closure ，它捕获 promiseCapability，并在被调用时执行以下步骤：- 执行 !
Call (promiseCapability.[[Reject]],undefined , « reason »)。 - 返回
NormalCompletion (undefined )。
- 执行 !
- 令 onRejected 为
CreateBuiltinFunction (rejectedClosure, 1,"" , « »)。 - 令 linkAndEvaluateClosure 为一个不带形参的新
Abstract Closure ，它捕获 module、promiseCapability 和 onRejected，并在被调用时执行以下步骤：- 令 link 为
Completion (module.Link ())。 - 如果 link 是 abrupt completion，则
- 执行 !
Call (promiseCapability.[[Reject]],undefined , « link.[[Value]] »)。 - 返回
NormalCompletion (undefined )。
- 执行 !
- 令 evaluatePromise 为 module.
Evaluate ()。 - 令 fulfilledClosure 为一个不带形参的新
Abstract Closure ，它捕获 module 和 promiseCapability，并在被调用时执行以下步骤：- 令 namespace 为
GetModuleNamespace (module)。 - 执行 !
Call (promiseCapability.[[Resolve]],undefined , « namespace »)。 - 返回
NormalCompletion (undefined )。
- 令 namespace 为
- 令 onFulfilled 为
CreateBuiltinFunction (fulfilledClosure, 0,"" , « »)。 - 执行
PerformPromiseThen (evaluatePromise, onFulfilled, onRejected)。 - 返回
unused 。
- 令 link 为
- 令 linkAndEvaluate 为
CreateBuiltinFunction (linkAndEvaluateClosure, 0,"" , « »)。 - 执行
PerformPromiseThen (loadPromise, linkAndEvaluate, onRejected)。 - 返回
unused 。
13.3.11 带标签模板
带标签模板是一种函数调用，其中该调用的实参派生自
13.3.11.1 Runtime Semantics: Evaluation
- 令 tagRef 为 ?
MemberExpression 的Evaluation 。 - 令 tagFunc 为 ?
GetValue (tagRef)。 - 令 thisCall 为此
MemberExpression 。 - 令 tailCall 为
IsInTailPosition (thisCall)。 - 返回 ?
EvaluateCall (tagFunc, tagRef,TemplateLiteral , tailCall)。
- 令 tagRef 为 ?
CallExpression 的Evaluation 。 - 令 tagFunc 为 ?
GetValue (tagRef)。 - 令 thisCall 为此
CallExpression 。 - 令 tailCall 为
IsInTailPosition (thisCall)。 - 返回 ?
EvaluateCall (tagFunc, tagRef,TemplateLiteral , tailCall)。
13.3.12 元属性
13.3.12.1 Runtime Semantics: Evaluation
- 返回
GetNewTarget ()。
- 令 module 为
GetActiveScriptOrModule ()。 - 断言：module 是
Source Text Module Record 。 - 令 importMeta 为 module.[[ImportMeta]]。
- 如果 importMeta 是
empty ，则- 将 importMeta 设置为
OrdinaryObjectCreate (null )。 - 令 importMetaValues 为
HostGetImportMetaProperties (module)。 - 对 importMetaValues 的每个
Record { [[Key]], [[Value]] } entry，执行：- 执行 !
CreateDataPropertyOrThrow (importMeta, entry.[[Key]], entry.[[Value]])。
- 执行 !
- 执行
HostFinalizeImportMeta (importMeta, module)。 - 将 module.[[ImportMeta]] 设置为 importMeta。
- 返回 importMeta。
- 将 importMeta 设置为
- 断言：importMeta 是 Object。
- 返回 importMeta。
13.3.12.1.1 HostGetImportMetaProperties ( moduleRecord )
The host-defined abstract operation HostGetImportMetaProperties takes argument moduleRecord (a import.meta 返回的对象提供
HostGetImportMetaProperties 的默认实现是返回一个新的空
13.3.12.1.2 HostFinalizeImportMeta ( importMeta, moduleRecord )
The host-defined abstract operation HostFinalizeImportMeta takes arguments importMeta (an Object) and moduleRecord (a import.meta 返回的对象。
多数
HostFinalizeImportMeta 的默认实现是返回
13.4 更新表达式
语法
13.4.1 Static Semantics: 早期错误
-
如果
LeftHandSideExpression 的AssignmentTargetType 是invalid ，则为早期语法错误。
-
如果
UnaryExpression 的AssignmentTargetType 是invalid ，则为早期语法错误。
13.4.2 后缀递增运算符
13.4.2.1 Runtime Semantics: Evaluation
- 令 lhs 为 ?
LeftHandSideExpression 的Evaluation 。 - 如果
LeftHandSideExpression 的AssignmentTargetType 是web-compat ，则抛出ReferenceError 异常。 - 令 oldValue 为 ?
ToNumeric (?GetValue (lhs))。 - 如果 oldValue 是 Number，则
- 令 newValue 为
Number::add (oldValue,1 𝔽)。
- 令 newValue 为
- 否则，
- 断言：oldValue 是 BigInt。
- 令 newValue 为
BigInt::add (oldValue,1 ℤ)。
- 执行 ?
PutValue (lhs, newValue)。 - 返回 oldValue。
13.4.3 后缀递减运算符
13.4.3.1 Runtime Semantics: Evaluation
- 令 lhs 为 ?
LeftHandSideExpression 的Evaluation 。 - 如果
LeftHandSideExpression 的AssignmentTargetType 是web-compat ，则抛出ReferenceError 异常。 - 令 oldValue 为 ?
ToNumeric (?GetValue (lhs))。 - 如果 oldValue 是 Number，则
- 令 newValue 为
Number::subtract (oldValue,1 𝔽)。
- 令 newValue 为
- 否则，
- 断言：oldValue 是 BigInt。
- 令 newValue 为
BigInt::subtract (oldValue,1 ℤ)。
- 执行 ?
PutValue (lhs, newValue)。 - 返回 oldValue。
13.4.4 前缀递增运算符
13.4.4.1 Runtime Semantics: Evaluation
- 令 expr 为 ?
UnaryExpression 的Evaluation 。 - 如果
UnaryExpression 的AssignmentTargetType 是web-compat ，则抛出ReferenceError 异常。 - 令 oldValue 为 ?
ToNumeric (?GetValue (expr))。 - 如果 oldValue 是 Number，则
- 令 newValue 为
Number::add (oldValue,1 𝔽)。
- 令 newValue 为
- 否则，
- 断言：oldValue 是 BigInt。
- 令 newValue 为
BigInt::add (oldValue,1 ℤ)。
- 执行 ?
PutValue (expr, newValue)。 - 返回 newValue。
13.4.5 前缀递减运算符
13.4.5.1 Runtime Semantics: Evaluation
- 令 expr 为 ?
UnaryExpression 的Evaluation 。 - 如果
UnaryExpression 的AssignmentTargetType 是web-compat ，则抛出ReferenceError 异常。 - 令 oldValue 为 ?
ToNumeric (?GetValue (expr))。 - 如果 oldValue 是 Number，则
- 令 newValue 为
Number::subtract (oldValue,1 𝔽)。
- 令 newValue 为
- 否则，
- 断言：oldValue 是 BigInt。
- 令 newValue 为
BigInt::subtract (oldValue,1 ℤ)。
- 执行 ?
PutValue (expr, newValue)。 - 返回 newValue。
13.5 一元运算符
语法
补充语法
在处理产生式
的实例时，
13.5.1 delete 运算符
13.5.1.1 Static Semantics: 早期错误
-
如果
IsStrict (theUnaryExpression ) 是true ，且派生的UnaryExpression 是PrimaryExpression : IdentifierReference MemberExpression : MemberExpression . PrivateIdentifier CallExpression : CallExpression . PrivateIdentifier OptionalChain : ?. PrivateIdentifier OptionalChain : OptionalChain . PrivateIdentifier -
如果派生的
UnaryExpression 是
PrimaryExpression : CoverParenthesizedExpressionAndArrowParameterList
并且CoverParenthesizedExpressionAndArrowParameterList 最终派生出一个短语，当该短语用于替代UnaryExpression 时，会根据这些规则产生语法错误，则为语法错误。此规则会递归应用。
最后一条规则意味着，像 delete (((foo))) 这样的表达式会因为第一条规则的递归应用而产生
13.5.1.2 Runtime Semantics: Evaluation
- 令 ref 为 ?
UnaryExpression 的Evaluation 。 - 如果 ref 不是
Reference Record ，则返回true 。 - 如果
IsUnresolvableReference (ref) 是true ，则- 断言：ref.[[Strict]] 是
false 。 - 返回
true 。
- 断言：ref.[[Strict]] 是
- 如果
IsPropertyReference (ref) 是true ，则- 断言：
IsPrivateReference (ref) 是false 。 - 如果
IsSuperReference (ref) 是true ，则抛出ReferenceError 异常。 - 令 baseObj 为 ?
ToObject (ref.[[Base]])。 - 如果 ref.[[ReferencedName]] 不是
属性键 ，则- 将 ref.[[ReferencedName]] 设置为 ?
ToPropertyKey (ref.[[ReferencedName]])。
- 将 ref.[[ReferencedName]] 设置为 ?
- 令 deleteStatus 为 ? baseObj.[[Delete]](ref.[[ReferencedName]])。
- 如果 deleteStatus 是
false 且 ref.[[Strict]] 是true ，则抛出TypeError 异常。 - 返回 deleteStatus。
- 断言：
- 令 base 为 ref.[[Base]]。
- 断言：base 是
Environment Record 。 - 返回 ? base.
DeleteBinding (ref.[[ReferencedName]])。
当 delete 运算符出现在严格模式代码中时，如果其 delete 运算符出现在严格模式代码中，且要删除的属性具有 { [[Configurable]]:
13.5.2 void 运算符
13.5.2.1 Runtime Semantics: Evaluation
- 令 expr 为 ?
UnaryExpression 的Evaluation 。 - 执行 ?
GetValue (expr)。 - 返回
undefined 。
即使其值未被使用，也必须调用
13.5.3 typeof 运算符
13.5.3.1 Runtime Semantics: Evaluation
- 令 value 为 ?
UnaryExpression 的Evaluation 。 - 如果 value 是
Reference Record ，则- 如果
IsUnresolvableReference (value) 是true ，则返回"undefined" 。
- 如果
- 将 value 设置为 ?
GetValue (value)。 - 如果 value 是
undefined ，则返回"undefined" 。 - 如果 value 是
null ，则返回"object" 。 - 如果 value 是 String，则返回
"string" 。 - 如果 value 是 Symbol，则返回
"symbol" 。 - 如果 value 是 Boolean，则返回
"boolean" 。 - 如果 value 是 Number，则返回
"number" 。 - 如果 value 是 BigInt，则返回
"bigint" 。 - 断言：value 是 Object。
- 如果
宿主 是 Web 浏览器，或以其他方式支持[[IsHTMLDDA]] 内部槽 ，则- 如果 value 具有 [[IsHTMLDDA]] 内部槽，则返回
"undefined" 。
- 如果 value 具有 [[IsHTMLDDA]] 内部槽，则返回
- 如果 value 具有 [[Call]] 内部方法，则返回
"function" 。 - 返回
"object" 。
13.5.4 一元 + 运算符
一元 + 运算符将其操作数转换为
13.5.4.1 Runtime Semantics: Evaluation
- 令 expr 为 ?
UnaryExpression 的Evaluation 。 - 返回 ?
ToNumber (?GetValue (expr))。
13.5.5 一元 - 运算符
一元 - 运算符将其操作数转换为数值，然后对其取负。对
13.5.5.1 Runtime Semantics: Evaluation
- 令 expr 为 ?
UnaryExpression 的Evaluation 。 - 令 oldValue 为 ?
ToNumeric (?GetValue (expr))。 - 如果 oldValue 是 Number，则返回
Number::unaryMinus (oldValue)。 - 断言：oldValue 是 BigInt。
- 返回
BigInt::unaryMinus (oldValue)。
13.5.6 按位 NOT 运算符（~）
13.5.6.1 Runtime Semantics: Evaluation
- 令 expr 为 ?
UnaryExpression 的Evaluation 。 - 令 oldValue 为 ?
ToNumeric (?GetValue (expr))。 - 如果 oldValue 是 Number，则返回
Number::bitwiseNOT (oldValue)。 - 断言：oldValue 是 BigInt。
- 返回
BigInt::bitwiseNOT (oldValue)。
13.5.7 逻辑 NOT 运算符（!）
13.5.7.1 Runtime Semantics: Evaluation
- 令 expr 为 ?
UnaryExpression 的Evaluation 。 - 令 oldValue 为
ToBoolean (?GetValue (expr))。 - 如果 oldValue 是
true ，则返回false 。 - 返回
true 。
13.6 幂运算符
语法
13.6.1 Runtime Semantics: Evaluation
13.7 乘法类运算符
语法
*运算符执行乘法，产生其操作数的乘积。/运算符执行除法，产生其操作数的商。%运算符从隐含的除法中产生其操作数的余数。
13.7.1 Runtime Semantics: Evaluation
- 令 opText 为由
MultiplicativeOperator 匹配的源文本 。 - 返回 ?
EvaluateStringOrNumericBinaryExpression (MultiplicativeExpression , opText,ExponentiationExpression )。
13.8 加性运算符
语法
13.8.1 加法运算符（+）
加法运算符执行
13.8.1.1 Runtime Semantics: Evaluation
13.8.2 减法运算符（-）
- 运算符执行减法，产生其操作数的差。
13.8.2.1 Runtime Semantics: Evaluation
13.9 按位移位运算符
语法
13.9.1 左移运算符（<<）
按右操作数指定的数量，对左操作数执行按位左移操作。
13.9.1.1 Runtime Semantics: Evaluation
13.9.2 带符号右移运算符（>>）
按右操作数指定的数量，对左操作数执行符号填充的按位右移操作。
13.9.2.1 Runtime Semantics: Evaluation
13.9.3 无符号右移运算符（>>>）
按右操作数指定的数量，对左操作数执行零填充的按位右移操作。
13.9.3.1 Runtime Semantics: Evaluation
13.10 关系运算符
求值关系运算符的结果始终是
语法
需要 [In] 语法参数，以避免将关系表达式中的 in 运算符与 for 语句中的 in 运算符混淆。
13.10.1 Runtime Semantics: Evaluation
- 令 leftRef 为 ?
RelationalExpression 的Evaluation 。 - 令 leftValue 为 ?
GetValue (leftRef)。 - 令 rightRef 为 ?
ShiftExpression 的Evaluation 。 - 令 rightValue 为 ?
GetValue (rightRef)。 - 令 result 为 ?
IsLessThan (leftValue, rightValue,true )。 - 如果 result 是
undefined ，则返回false 。 - 返回 result。
- 令 leftRef 为 ?
RelationalExpression 的Evaluation 。 - 令 leftValue 为 ?
GetValue (leftRef)。 - 令 rightRef 为 ?
ShiftExpression 的Evaluation 。 - 令 rightValue 为 ?
GetValue (rightRef)。 - 令 result 为 ?
IsLessThan (rightValue, leftValue,false )。 - 如果 result 是
undefined ，则返回false 。 - 返回 result。
- 令 leftRef 为 ?
RelationalExpression 的Evaluation 。 - 令 leftValue 为 ?
GetValue (leftRef)。 - 令 rightRef 为 ?
ShiftExpression 的Evaluation 。 - 令 rightValue 为 ?
GetValue (rightRef)。 - 令 result 为 ?
IsLessThan (rightValue, leftValue,false )。 - 如果 result 是
true 或undefined ，则返回false 。 - 返回
true 。
- 令 leftRef 为 ?
RelationalExpression 的Evaluation 。 - 令 leftValue 为 ?
GetValue (leftRef)。 - 令 rightRef 为 ?
ShiftExpression 的Evaluation 。 - 令 rightValue 为 ?
GetValue (rightRef)。 - 令 result 为 ?
IsLessThan (leftValue, rightValue,true )。 - 如果 result 是
true 或undefined ，则返回false 。 - 返回
true 。
- 令 leftRef 为 ?
RelationalExpression 的Evaluation 。 - 令 leftValue 为 ?
GetValue (leftRef)。 - 令 rightRef 为 ?
ShiftExpression 的Evaluation 。 - 令 rightValue 为 ?
GetValue (rightRef)。 - 返回 ?
InstanceofOperator (leftValue, rightValue)。
- 令 leftRef 为 ?
RelationalExpression 的Evaluation 。 - 令 leftValue 为 ?
GetValue (leftRef)。 - 令 rightRef 为 ?
ShiftExpression 的Evaluation 。 - 令 rightValue 为 ?
GetValue (rightRef)。 - 如果 rightValue 不是 Object，则抛出
TypeError 异常。 - 返回 ?
HasProperty (rightValue, ?ToPropertyKey (leftValue))。
- 令 privateIdentifier 为
PrivateIdentifier 的StringValue 。 - 令 rightRef 为 ?
ShiftExpression 的Evaluation 。 - 令 rightValue 为 ?
GetValue (rightRef)。 - 如果 rightValue 不是 Object，则抛出
TypeError 异常。 - 令 privateEnv 为运行中的执行上下文的 PrivateEnvironment。
- 断言：privateEnv 不是
null 。 - 令 privateName 为
ResolvePrivateIdentifier (privateEnv, privateIdentifier)。 - 如果
PrivateElementFind (rightValue, privateName) 是empty ，则返回false 。 - 返回
true 。
13.10.2 InstanceofOperator ( value, target )
The abstract operation InstanceofOperator takes arguments value (an ECMAScript language value) and target (an ECMAScript language value) and returns either a normal completion containing a Boolean or a throw completion. 它实现用于确定 value 是否为 target 实例的通用算法：要么咨询 target 的
- 如果 target 不是 Object，则抛出
TypeError 异常。 - 令 instOfHandler 为 ?
GetMethod (target,%Symbol.hasInstance% )。 - 如果 instOfHandler 不是
undefined ，则 - 如果
IsCallable (target) 是false ，则抛出TypeError 异常。 - 返回 ?
OrdinaryHasInstance (target, value)。
步骤 instanceof 运算符语义。如果对象没有定义或继承 instanceof 语义。
13.11 相等运算符
求值相等运算符的结果始终是
语法
13.11.1 Runtime Semantics: Evaluation
- 令 leftRef 为 ?
EqualityExpression 的Evaluation 。 - 令 leftValue 为 ?
GetValue (leftRef)。 - 令 rightRef 为 ?
RelationalExpression 的Evaluation 。 - 令 rightValue 为 ?
GetValue (rightRef)。 - 返回 ?
IsLooselyEqual (rightValue, leftValue)。
- 令 leftRef 为 ?
EqualityExpression 的Evaluation 。 - 令 leftValue 为 ?
GetValue (leftRef)。 - 令 rightRef 为 ?
RelationalExpression 的Evaluation 。 - 令 rightValue 为 ?
GetValue (rightRef)。 - 令 result 为 ?
IsLooselyEqual (rightValue, leftValue)。 - 如果 result 是
true ，则返回false 。 - 返回
true 。
- 令 leftRef 为 ?
EqualityExpression 的Evaluation 。 - 令 leftValue 为 ?
GetValue (leftRef)。 - 令 rightRef 为 ?
RelationalExpression 的Evaluation 。 - 令 rightValue 为 ?
GetValue (rightRef)。 - 返回
IsStrictlyEqual (rightValue, leftValue)。
- 令 leftRef 为 ?
EqualityExpression 的Evaluation 。 - 令 leftValue 为 ?
GetValue (leftRef)。 - 令 rightRef 为 ?
RelationalExpression 的Evaluation 。 - 令 rightValue 为 ?
GetValue (rightRef)。 - 令 result 为
IsStrictlyEqual (rightValue, leftValue)。 - 如果 result 是
true ，则返回false 。 - 返回
true 。
相等运算符维持以下不变量：
-
A != B等价于!(A == B)。 -
A == B等价于B == A，但A和B的求值顺序除外。
相等运算符并不总是具有传递性。例如，可能有两个不同的 String 对象，每个都表示相同的 String 值；每个 String 对象都会被 == 运算符认为等于该 String 值，但这两个 String 对象彼此并不相等。例如：
-
new String("a") == "a"和"a" == new String("a")都是true 。 -
new String("a") == new String("a")是false 。
String 的比较使用对代码单元值序列的简单相等性测试。不会尝试使用 Unicode 规范中定义的更复杂、面向语义的字符或字符串相等性和
13.12 二元按位运算符
语法
13.12.1 Runtime Semantics: Evaluation
13.13 二元逻辑运算符
语法
&& 或 || 运算符产生的值不一定是
13.13.1 Runtime Semantics: Evaluation
- 令 leftRef 为 ?
LogicalANDExpression 的Evaluation 。 - 令 leftValue 为 ?
GetValue (leftRef)。 - 如果
ToBoolean (leftValue) 是false ，则返回 leftValue。 - 令 rightRef 为 ?
BitwiseORExpression 的Evaluation 。 - 返回 ?
GetValue (rightRef)。
- 令 leftRef 为 ?
LogicalORExpression 的Evaluation 。 - 令 leftValue 为 ?
GetValue (leftRef)。 - 如果
ToBoolean (leftValue) 是true ，则返回 leftValue。 - 令 rightRef 为 ?
LogicalANDExpression 的Evaluation 。 - 返回 ?
GetValue (rightRef)。
- 令 leftRef 为 ?
CoalesceExpressionHead 的Evaluation 。 - 令 leftValue 为 ?
GetValue (leftRef)。 - 如果 leftValue 既不是
undefined 也不是null ，则返回 leftValue。 - 令 rightRef 为 ?
BitwiseORExpression 的Evaluation 。 - 返回 ?
GetValue (rightRef)。
13.14 条件运算符（? :）
语法
ECMAScript 中
13.14.1 Runtime Semantics: Evaluation
- 令 leftRef 为 ?
ShortCircuitExpression 的Evaluation 。 - 令 leftValue 为
ToBoolean (?GetValue (leftRef))。 - 如果 leftValue 是
true ，则- 令 trueRef 为 ? 第一个
AssignmentExpression 的Evaluation 。 - 返回 ?
GetValue (trueRef)。
- 令 trueRef 为 ? 第一个
- 令 falseRef 为 ? 第二个
AssignmentExpression 的Evaluation 。 - 返回 ?
GetValue (falseRef)。
13.15 赋值运算符
语法
13.15.1 Static Semantics: 早期错误
-
如果
LeftHandSideExpression 是ObjectLiteral 或ArrayLiteral ，则LeftHandSideExpression 必须覆盖一个AssignmentPattern 。 -
如果
LeftHandSideExpression 既不是ObjectLiteral 也不是ArrayLiteral ，且LeftHandSideExpression 的AssignmentTargetType 是invalid ，则为语法错误。
-
如果
LeftHandSideExpression 的AssignmentTargetType 是invalid ，则为语法错误。
-
如果
LeftHandSideExpression 的AssignmentTargetType 不是simple ，则为语法错误。
13.15.2 Runtime Semantics: Evaluation
- 如果
LeftHandSideExpression 既不是ObjectLiteral 也不是ArrayLiteral ，则- 令 leftRef 为 ?
LeftHandSideExpression 的Evaluation 。 - 如果
LeftHandSideExpression 的AssignmentTargetType 是web-compat ，则抛出ReferenceError 异常。 - 如果
IsAnonymousFunctionDefinition (AssignmentExpression ) 是true 且LeftHandSideExpression 的IsIdentifierRef 是true ，则- 令 lhs 为
LeftHandSideExpression 的StringValue 。 - 令 rightValue 为 ? 以 lhs 为实参执行
AssignmentExpression 的NamedEvaluation 。
- 令 lhs 为
- 否则，
- 令 rightRef 为 ?
AssignmentExpression 的Evaluation 。 - 令 rightValue 为 ?
GetValue (rightRef)。
- 令 rightRef 为 ?
- 执行 ?
PutValue (leftRef, rightValue)。 - 返回 rightValue。
- 令 leftRef 为 ?
- 令 assignmentPattern 为由
LeftHandSideExpression 覆盖的 AssignmentPattern 。 - 令 rightRef 为 ?
AssignmentExpression 的Evaluation 。 - 令 rightValue 为 ?
GetValue (rightRef)。 - 执行 ? 以 rightValue 为实参执行 assignmentPattern 的
DestructuringAssignmentEvaluation 。 - 返回 rightValue。
- 令 leftRef 为 ?
LeftHandSideExpression 的Evaluation 。 - 如果
LeftHandSideExpression 的AssignmentTargetType 是web-compat ，则抛出ReferenceError 异常。 - 令 leftValue 为 ?
GetValue (leftRef)。 - 令 rightRef 为 ?
AssignmentExpression 的Evaluation 。 - 令 rightValue 为 ?
GetValue (rightRef)。 - 令 assignmentOpText 为由
AssignmentOperator 匹配的源文本 。 - 令 opText 为下表中与 assignmentOpText 关联的 Unicode 码点序列：
assignmentOpText opText **=***=*/=/%=%+=+-=-<<=<<>>=>>>>>=>>>&=&^=^|=| - 令 result 为 ?
ApplyStringOrNumericBinaryOperator (leftValue, opText, rightValue)。 - 执行 ?
PutValue (leftRef, result)。 - 返回 result。
- 令 leftRef 为 ?
LeftHandSideExpression 的Evaluation 。 - 令 leftValue 为 ?
GetValue (leftRef)。 - 如果
ToBoolean (leftValue) 是false ，则返回 leftValue。 - 如果
IsAnonymousFunctionDefinition (AssignmentExpression ) 是true 且LeftHandSideExpression 的IsIdentifierRef 是true ，则- 令 lhs 为
LeftHandSideExpression 的StringValue 。 - 令 rightValue 为 ? 以 lhs 为实参执行
AssignmentExpression 的NamedEvaluation 。
- 令 lhs 为
- 否则，
- 令 rightRef 为 ?
AssignmentExpression 的Evaluation 。 - 令 rightValue 为 ?
GetValue (rightRef)。
- 令 rightRef 为 ?
- 执行 ?
PutValue (leftRef, rightValue)。 - 返回 rightValue。
- 令 leftRef 为 ?
LeftHandSideExpression 的Evaluation 。 - 令 leftValue 为 ?
GetValue (leftRef)。 - 如果
ToBoolean (leftValue) 是true ，则返回 leftValue。 - 如果
IsAnonymousFunctionDefinition (AssignmentExpression ) 是true 且LeftHandSideExpression 的IsIdentifierRef 是true ，则- 令 lhs 为
LeftHandSideExpression 的StringValue 。 - 令 rightValue 为 ? 以 lhs 为实参执行
AssignmentExpression 的NamedEvaluation 。
- 令 lhs 为
- 否则，
- 令 rightRef 为 ?
AssignmentExpression 的Evaluation 。 - 令 rightValue 为 ?
GetValue (rightRef)。
- 令 rightRef 为 ?
- 执行 ?
PutValue (leftRef, rightValue)。 - 返回 rightValue。
- 令 leftRef 为 ?
LeftHandSideExpression 的Evaluation 。 - 令 leftValue 为 ?
GetValue (leftRef)。 - 如果 leftValue 既不是
undefined 也不是null ，则返回 leftValue。 - 如果
IsAnonymousFunctionDefinition (AssignmentExpression ) 是true 且LeftHandSideExpression 的IsIdentifierRef 是true ，则- 令 lhs 为
LeftHandSideExpression 的StringValue 。 - 令 rightValue 为 ? 以 lhs 为实参执行
AssignmentExpression 的NamedEvaluation 。
- 令 lhs 为
- 否则，
- 令 rightRef 为 ?
AssignmentExpression 的Evaluation 。 - 令 rightValue 为 ?
GetValue (rightRef)。
- 令 rightRef 为 ?
- 执行 ?
PutValue (leftRef, rightValue)。 - 返回 rightValue。
13.15.3 ApplyStringOrNumericBinaryOperator ( leftValue, opText, rightValue )
The abstract operation ApplyStringOrNumericBinaryOperator takes arguments leftValue (an ECMAScript language value), opText (**, *, /, %, +, -, <<, >>, >>>, &, ^, or |), and rightValue (an ECMAScript language value) and returns either a normal completion containing either a String, a BigInt, or a Number, or a throw completion. It performs the following steps when called:
- 如果 opText 是
+，则- 令 leftPrimitive 为 ?
ToPrimitive (leftValue)。 - 令 rightPrimitive 为 ?
ToPrimitive (rightValue)。 - 如果 leftPrimitive 是 String 或 rightPrimitive 是 String，则
- 将 leftValue 设置为 leftPrimitive。
- 将 rightValue 设置为 rightPrimitive。
- 令 leftPrimitive 为 ?
- 注：在此处，它必须是数值操作。
- 令 leftNumber 为 ?
ToNumeric (leftValue)。 - 令 rightNumber 为 ?
ToNumeric (rightValue)。 - 如果
SameType (leftNumber, rightNumber) 是false ，则抛出TypeError 异常。 - 如果 leftNumber 是 BigInt，则
- 如果 opText 是
**，则返回 ?BigInt::exponentiate (leftNumber, rightNumber)。 - 如果 opText 是
/，则返回 ?BigInt::divide (leftNumber, rightNumber)。 - 如果 opText 是
%，则返回 ?BigInt::remainder (leftNumber, rightNumber)。 - 如果 opText 是
>>>，则返回 ?BigInt::unsignedRightShift (leftNumber, rightNumber)。 - 令 operation 为下表中与 opText 关联的
抽象操作 ：opText operation *BigInt::multiply +BigInt::add -BigInt::subtract <<BigInt::leftShift >>BigInt::signedRightShift &BigInt::bitwiseAND ^BigInt::bitwiseXOR |BigInt::bitwiseOR
- 如果 opText 是
- 否则，
- 断言：leftNumber 是 Number。
- 令 operation 为下表中与 opText 关联的
抽象操作 ：opText operation **Number::exponentiate *Number::multiply /Number::divide %Number::remainder +Number::add -Number::subtract <<Number::leftShift >>Number::signedRightShift >>>Number::unsignedRightShift &Number::bitwiseAND ^Number::bitwiseXOR |Number::bitwiseOR
- 返回 operation(leftNumber, rightNumber)。
在步骤
步骤
13.15.4 EvaluateStringOrNumericBinaryExpression ( leftOperand, opText, rightOperand )
The abstract operation EvaluateStringOrNumericBinaryExpression takes arguments leftOperand (a **, *, /, %, +, -, <<, >>, >>>, &, ^, or |), and rightOperand (a
- 令 leftRef 为 ? leftOperand 的
Evaluation 。 - 令 leftValue 为 ?
GetValue (leftRef)。 - 令 rightRef 为 ? rightOperand 的
Evaluation 。 - 令 rightValue 为 ?
GetValue (rightRef)。 - 返回 ?
ApplyStringOrNumericBinaryOperator (leftValue, opText, rightValue)。
13.15.5 解构赋值
补充语法
在某些情况下，当处理产生式的实例
时，使用以下语法细化
13.15.5.1 Static Semantics: 早期错误
-
如果
IdentifierReference 的AssignmentTargetType 不是simple ，则为语法错误。
-
如果
DestructuringAssignmentTarget 是ArrayLiteral 或ObjectLiteral ，则为语法错误。
-
如果
LeftHandSideExpression 是ObjectLiteral 或ArrayLiteral ，则LeftHandSideExpression 必须覆盖一个AssignmentPattern 。 -
如果
LeftHandSideExpression 既不是ObjectLiteral 也不是ArrayLiteral ，且LeftHandSideExpression 的AssignmentTargetType 不是simple ，则为语法错误。
13.15.5.2 Runtime Semantics: DestructuringAssignmentEvaluation
The syntax-directed operation DestructuringAssignmentEvaluation takes argument value (an ECMAScript language value) and returns either a normal completion containing
- 执行 ?
RequireObjectCoercible (value)。 - 返回
unused 。
- 执行 ?
RequireObjectCoercible (value)。 - 执行 ? 以 value 为实参执行
AssignmentPropertyList 的PropertyDestructuringAssignmentEvaluation 。 - 返回
unused 。
- 执行 ?
RequireObjectCoercible (value)。 - 令 excludedNames 为新的空
List 。 - 返回 ? 以 value 和 excludedNames 为实参执行
AssignmentRestProperty 的RestDestructuringAssignmentEvaluation 。
- 执行 ?
RequireObjectCoercible (value)。 - 令 excludedNames 为 ? 以 value 为实参执行
AssignmentPropertyList 的PropertyDestructuringAssignmentEvaluation 。 - 返回 ? 以 value 和 excludedNames 为实参执行
AssignmentRestProperty 的RestDestructuringAssignmentEvaluation 。
- 令 iteratorRecord 为 ?
GetIterator (value,sync )。 - 返回 ?
IteratorClose (iteratorRecord,NormalCompletion (unused ))。
- 令 iteratorRecord 为 ?
GetIterator (value,sync )。 - 令 result 为
Completion (以 iteratorRecord 为实参执行Elision 的IteratorDestructuringAssignmentEvaluation )。 - 如果 iteratorRecord.[[Done]] 是
false ，则返回 ?IteratorClose (iteratorRecord, result)。 - 返回 result。
- 令 iteratorRecord 为 ?
GetIterator (value,sync )。 - 如果存在
Elision ，则- 令 status 为
Completion (以 iteratorRecord 为实参执行Elision 的IteratorDestructuringAssignmentEvaluation )。 - 如果 status 是 abrupt completion，则
- 断言：iteratorRecord.[[Done]] 是
true 。 - 返回 ? status。
- 断言：iteratorRecord.[[Done]] 是
- 令 status 为
- 令 result 为
Completion (以 iteratorRecord 为实参执行AssignmentRestElement 的IteratorDestructuringAssignmentEvaluation )。 - 如果 iteratorRecord.[[Done]] 是
false ，则返回 ?IteratorClose (iteratorRecord, result)。 - 返回 result。
- 令 iteratorRecord 为 ?
GetIterator (value,sync )。 - 令 result 为
Completion (以 iteratorRecord 为实参执行AssignmentElementList 的IteratorDestructuringAssignmentEvaluation )。 - 如果 iteratorRecord.[[Done]] 是
false ，则返回 ?IteratorClose (iteratorRecord, result)。 - 返回 result。
- 令 iteratorRecord 为 ?
GetIterator (value,sync )。 - 令 status 为
Completion (以 iteratorRecord 为实参执行AssignmentElementList 的IteratorDestructuringAssignmentEvaluation )。 - 如果 status 是 abrupt completion，则
- 如果 iteratorRecord.[[Done]] 是
false ，则返回 ?IteratorClose (iteratorRecord, status)。 - 返回 ? status。
- 如果 iteratorRecord.[[Done]] 是
- 如果存在
Elision ，则- 将 status 设置为
Completion (以 iteratorRecord 为实参执行Elision 的IteratorDestructuringAssignmentEvaluation )。 - 如果 status 是 abrupt completion，则
- 断言：iteratorRecord.[[Done]] 是
true 。 - 返回 ? status。
- 断言：iteratorRecord.[[Done]] 是
- 将 status 设置为
- 如果存在
AssignmentRestElement ，则- 将 status 设置为
Completion (以 iteratorRecord 为实参执行AssignmentRestElement 的IteratorDestructuringAssignmentEvaluation )。
- 将 status 设置为
- 如果 iteratorRecord.[[Done]] 是
false ，则返回 ?IteratorClose (iteratorRecord, status)。 - 返回 ? status。
13.15.5.3 Runtime Semantics: PropertyDestructuringAssignmentEvaluation
The syntax-directed operation PropertyDestructuringAssignmentEvaluation takes argument value (an ECMAScript language value) and returns either a normal completion containing a
- 令 propertyNames 为 ? 以 value 为实参执行
AssignmentPropertyList 的PropertyDestructuringAssignmentEvaluation 。 - 令 nextNames 为 ? 以 value 为实参执行
AssignmentProperty 的PropertyDestructuringAssignmentEvaluation 。 - 返回 propertyNames 和 nextNames 的
列表连接 。
- 令 propertyName 为
IdentifierReference 的StringValue 。 - 令 leftRef 为 ?
ResolveBinding (propertyName)。 - 将 value 设置为 ?
GetV (value, propertyName)。 - 如果存在
Initializer 且 value 是undefined ，则- 如果
IsAnonymousFunctionDefinition (Initializer ) 是true ，则- 将 value 设置为 ? 以 propertyName 为实参执行
Initializer 的NamedEvaluation 。
- 将 value 设置为 ? 以 propertyName 为实参执行
- 否则，
- 令 defaultValue 为 ?
Initializer 的Evaluation 。 - 将 value 设置为 ?
GetValue (defaultValue)。
- 令 defaultValue 为 ?
- 如果
- 执行 ?
PutValue (leftRef, value)。 - 返回 « propertyName »。
- 令 name 为 ?
PropertyName 的Evaluation 。 - 执行 ? 以 value 和 name 为实参执行
AssignmentElement 的KeyedDestructuringAssignmentEvaluation 。 - 返回 « name »。
13.15.5.4 Runtime Semantics: RestDestructuringAssignmentEvaluation
The syntax-directed operation RestDestructuringAssignmentEvaluation takes arguments value (an ECMAScript language value) and excludedNames (a
- 令 leftRef 为 ?
DestructuringAssignmentTarget 的Evaluation 。 - 令 restObj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 ?
CopyDataProperties (restObj, value, excludedNames)。 - 返回 ?
PutValue (leftRef, restObj)。
13.15.5.5 Runtime Semantics: IteratorDestructuringAssignmentEvaluation
The syntax-directed operation IteratorDestructuringAssignmentEvaluation takes argument iteratorRecord (an
- 返回 ? 以 iteratorRecord 为实参执行
AssignmentElisionElement 的IteratorDestructuringAssignmentEvaluation 。
- 执行 ? 以 iteratorRecord 为实参执行
AssignmentElementList 的IteratorDestructuringAssignmentEvaluation 。 - 返回 ? 以 iteratorRecord 为实参执行
AssignmentElisionElement 的IteratorDestructuringAssignmentEvaluation 。
- 返回 ? 以 iteratorRecord 为实参执行
AssignmentElement 的IteratorDestructuringAssignmentEvaluation 。
- 执行 ? 以 iteratorRecord 为实参执行
Elision 的IteratorDestructuringAssignmentEvaluation 。 - 返回 ? 以 iteratorRecord 为实参执行
AssignmentElement 的IteratorDestructuringAssignmentEvaluation 。
- 如果 iteratorRecord.[[Done]] 是
false ，则- 执行 ?
IteratorStep (iteratorRecord)。
- 执行 ?
- 返回
unused 。
- 执行 ? 以 iteratorRecord 为实参执行
Elision 的IteratorDestructuringAssignmentEvaluation 。 - 如果 iteratorRecord.[[Done]] 是
false ，则- 执行 ?
IteratorStep (iteratorRecord)。
- 执行 ?
- 返回
unused 。
- 如果
DestructuringAssignmentTarget 既不是ObjectLiteral 也不是ArrayLiteral ，则- 令 leftRef 为 ?
DestructuringAssignmentTarget 的Evaluation 。
- 令 leftRef 为 ?
- 令 value 为
undefined 。 - 如果 iteratorRecord.[[Done]] 是
false ，则- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 不是
done ，则- 将 value 设置为 next。
- 令 next 为 ?
- 如果存在
Initializer 且 value 是undefined ，则- 如果
IsAnonymousFunctionDefinition (Initializer ) 是true 且DestructuringAssignmentTarget 的IsIdentifierRef 是true ，则- 令 target 为
DestructuringAssignmentTarget 的StringValue 。 - 令 v 为 ? 以 target 为实参执行
Initializer 的NamedEvaluation 。
- 令 target 为
- 否则，
- 令 defaultValue 为 ?
Initializer 的Evaluation 。 - 令 v 为 ?
GetValue (defaultValue)。
- 令 defaultValue 为 ?
- 如果
- 否则，
- 令 v 为 value。
- 如果
DestructuringAssignmentTarget 是ObjectLiteral 或ArrayLiteral ，则- 令 nestedAssignmentPattern 为由
DestructuringAssignmentTarget 覆盖的 AssignmentPattern 。 - 返回 ? 以 v 为实参执行 nestedAssignmentPattern 的
DestructuringAssignmentEvaluation 。
- 令 nestedAssignmentPattern 为由
- 返回 ?
PutValue (leftRef, v)。
通过在访问迭代器或求值
- 如果
DestructuringAssignmentTarget 既不是ObjectLiteral 也不是ArrayLiteral ，则- 令 leftRef 为 ?
DestructuringAssignmentTarget 的Evaluation 。
- 令 leftRef 为 ?
- 令 array 为 !
ArrayCreate (0)。 - 令 n 为 0。
- 重复，当 iteratorRecord.[[Done]] 是
false 时，- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 不是
done ，则- 执行 !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (n)), next)。 - 将 n 设置为 n + 1。
- 执行 !
- 令 next 为 ?
- 如果
DestructuringAssignmentTarget 既不是ObjectLiteral 也不是ArrayLiteral ，则- 返回 ?
PutValue (leftRef, array)。
- 返回 ?
- 令 nestedAssignmentPattern 为由
DestructuringAssignmentTarget 覆盖的 AssignmentPattern 。 - 返回 ? 以 array 为实参执行 nestedAssignmentPattern 的
DestructuringAssignmentEvaluation 。
13.15.5.6 Runtime Semantics: KeyedDestructuringAssignmentEvaluation
The syntax-directed operation KeyedDestructuringAssignmentEvaluation takes arguments value (an ECMAScript language value) and propertyName (a property key) and returns either a normal completion containing
- 如果
DestructuringAssignmentTarget 既不是ObjectLiteral 也不是ArrayLiteral ，则- 令 leftRef 为 ?
DestructuringAssignmentTarget 的Evaluation 。
- 令 leftRef 为 ?
- 将 value 设置为 ?
GetV (value, propertyName)。 - 如果存在
Initializer 且 value 是undefined ，则- 如果
IsAnonymousFunctionDefinition (Initializer ) 是true 且DestructuringAssignmentTarget 的IsIdentifierRef 是true ，则- 令 target 为
DestructuringAssignmentTarget 的StringValue 。 - 令 rhsValue 为 ? 以 target 为实参执行
Initializer 的NamedEvaluation 。
- 令 target 为
- 否则，
- 令 defaultValue 为 ?
Initializer 的Evaluation 。 - 令 rhsValue 为 ?
GetValue (defaultValue)。
- 令 defaultValue 为 ?
- 如果
- 否则，
- 令 rhsValue 为 value。
- 如果
DestructuringAssignmentTarget 是ObjectLiteral 或ArrayLiteral ，则- 令 assignmentPattern 为由
DestructuringAssignmentTarget 覆盖的 AssignmentPattern 。 - 返回 ? 以 rhsValue 为实参执行 assignmentPattern 的
DestructuringAssignmentEvaluation 。
- 令 assignmentPattern 为由
- 返回 ?
PutValue (leftRef, rhsValue)。
13.16 逗号运算符（,）
语法
13.16.1 Runtime Semantics: Evaluation
- 令 leftRef 为 ?
Expression 的Evaluation 。 - 执行 ?
GetValue (leftRef)。 - 令 rightRef 为 ?
AssignmentExpression 的Evaluation 。 - 返回 ?
GetValue (rightRef)。
即使其值未被使用，也必须调用
14 ECMAScript 语言：语句和声明
语法
14.1 语句语义
14.1.1 Runtime Semantics: Evaluation
- 返回
empty 。
- 返回 ?
FunctionDeclaration 的Evaluation 。
- 令 newLabelSet 为新的空
List 。 - 返回 ? 以 newLabelSet 为实参执行此
BreakableStatement 的LabelledEvaluation 。
14.2 块
语法
14.2.1 Static Semantics: 早期错误
-
如果
StatementList 的LexicallyDeclaredNames 包含 任何重复项，则为语法错误，除非宿主 是 Web 浏览器，或以其他方式支持块级函数声明的 Web 遗留兼容性语义 ，并且以下两个条件都为真：IsStrict (this production) 是false 。- 这些重复项只由 FunctionDeclarations 绑定。
-
如果
StatementList 的LexicallyDeclaredNames 的任何元素也出现在StatementList 的VarDeclaredNames 中，则为语法错误。
14.2.2 Runtime Semantics: Evaluation
- 返回
empty 。
- 令 oldEnv 为运行中执行上下文的 LexicalEnvironment。
- 令 blockEnv 为
NewDeclarativeEnvironment (oldEnv)。 - 执行
BlockDeclarationInstantiation (StatementList , blockEnv)。 - 将运行中执行上下文的 LexicalEnvironment 设置为 blockEnv。
- 令 blockValue 为
Completion (StatementList 的求值)。 - 将 blockValue 设置为
Completion (DisposeResources (blockEnv.[[DisposableResourceStack]], blockValue))。 - 将运行中执行上下文的 LexicalEnvironment 设置为 oldEnv。
- 返回 ? blockValue。
无论控制如何离开
- 令 sl 为 ?
StatementList 的Evaluation 。 - 令 s 为
Completion (StatementListItem 的Evaluation )。 - 返回 ?
UpdateEmpty (s, sl)。
eval 函数的调用都会返回值 1：
eval("1;;;;;")
eval("1;{}")
eval("1;var a;")14.2.3 BlockDeclarationInstantiation ( code, envRecord )
The abstract operation BlockDeclarationInstantiation takes arguments code (a
当求值
它在被调用时执行以下步骤：
- 令 decls 为 code 的
LexicallyScopedDeclarations 。 - 令 privateEnv 为正在运行的执行上下文的 PrivateEnvironment。
- 对 decls 的每个元素 decl，执行：
- 对 decl 的
BoundNames 的每个元素 name，执行：- 如果 decl 的
IsConstantDeclaration 为true ，则- 执行 ! envRecord.
CreateImmutableBinding (name,true )。
- 执行 ! envRecord.
- 否则，
- 如果
宿主 是 Web 浏览器，或以其他方式支持块级函数声明的 Web 遗留兼容性语义 ，则- 如果 ! envRecord.
HasBinding (name) 为false ，则- 执行 ! envRecord.
CreateMutableBinding (name,false )。
- 执行 ! envRecord.
- 如果 ! envRecord.
- 否则，
- 执行 ! envRecord.
CreateMutableBinding (name,false )。
- 执行 ! envRecord.
- 如果
- 如果 decl 的
- 如果 decl 是
FunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 或AsyncGeneratorDeclaration ，则- 令 funcName 为 decl 的
BoundNames 的唯一元素。 - 令 funcObj 为使用参数 envRecord 和 privateEnv 对 decl 执行
InstantiateFunctionObject 的结果。 - 如果
宿主 是 Web 浏览器，或以其他方式支持块级函数声明的 Web 遗留兼容性语义 ，则- 如果 envRecord 中 funcName 的绑定是未初始化绑定，则
- 执行 ! envRecord.
InitializeBinding (funcName, funcObj)。
- 执行 ! envRecord.
- 否则，
- 断言：decl 是
FunctionDeclaration 。 - 执行 ! envRecord.
SetMutableBinding (funcName, funcObj,false )。
- 断言：decl 是
- 如果 envRecord 中 funcName 的绑定是未初始化绑定，则
- 否则，
- 执行 ! envRecord.
InitializeBinding (funcName, funcObj)。
- 执行 ! envRecord.
- 令 funcName 为 decl 的
- 对 decl 的
- 返回
unused 。
14.3 声明和变量语句
14.3.1 Let、Const、Using 和 Await Using 声明
let、const、using 和 await using 声明定义的变量，其作用域为运行中执行上下文的 LexicalEnvironment。这些变量会在其let 声明中的
语法
补充语法
在处理产生式
的实例时，
14.3.1.1 Static Semantics: 早期错误
-
如果
BindingList 的BoundNames 包含 "let" ，则为语法错误。 -
如果
BindingList 的BoundNames 包含 任何重复项，则为语法错误。
-
如果
BindingList 的BoundNames 包含 "let" ，则为语法错误。 -
如果
BindingList 的BoundNames 包含 任何重复项，则为语法错误。
CoverAwaitExpressionAndAwaitUsingDeclarationHead 必须覆盖一个AwaitUsingDeclarationHead 。-
如果
BindingList 的BoundNames 包含 "let" ，则为语法错误。 -
如果
BindingList 的BoundNames 包含 任何重复项，则为语法错误。
-
如果
Initializer 不存在，且包含 此LexicalBinding 的LexicalDeclaration 的IsConstantDeclaration 为true ，则为语法错误。
14.3.1.2 Runtime Semantics: 求值
- 执行以
normal 为参数的BindingList 的 ?BindingEvaluation 。 - 返回
empty 。
- 执行以
sync-dispose 为参数的BindingList 的 ?BindingEvaluation 。 - 返回
empty 。
- 执行以
async-dispose 为参数的BindingList 的 ?BindingEvaluation 。 - 返回
empty 。
14.3.1.3 Runtime Semantics: BindingEvaluation
The syntax-directed operation BindingEvaluation takes argument kind (
- 执行以 kind 为参数的派生
BindingList 的 ?BindingEvaluation 。 - 返回以 kind 为参数的
LexicalBinding 的 ?BindingEvaluation 。
- 断言：kind 是
normal 。 - 令 lhs 为 !
ResolveBinding (BindingIdentifier 的StringValue )。 - 执行 !
InitializeReferencedBinding (lhs,undefined )。 - 返回
unused 。
一条const、using 或 await using 声明中。
- 令 bindingId 为
BindingIdentifier 的StringValue 。 - 令 lhs 为 !
ResolveBinding (bindingId)。 - 如果
IsAnonymousFunctionDefinition (Initializer ) 是true ，则- 令 value 为以 bindingId 为参数的
Initializer 的 ?NamedEvaluation 。
- 令 value 为以 bindingId 为参数的
- 否则，
- 令 rhs 为
Initializer 的 ?Evaluation 。 - 令 value 为 ?
GetValue (rhs)。
- 令 rhs 为
- 如果 kind 不是
normal ，则- 断言：
IsUnresolvableReference (lhs) 是false 。 - 令 base 为 lhs.[[Base]]。
- 断言：base 是声明式环境记录。
- 执行 ?
AddDisposableResource (base.[[DisposableResourceStack]], value, kind)。
- 断言：
- 执行 ?
InitializeReferencedBinding (lhs, value)。 - 返回
unused 。
- 断言：kind 是
normal 。 - 令 rhs 为
Initializer 的 ?Evaluation 。 - 令 value 为 ?
GetValue (rhs)。 - 令 envRecord 为运行中执行上下文的 LexicalEnvironment。
- 返回以 value 和 envRecord 为参数的
BindingPattern 的 ?BindingInitialization 。
14.3.2 变量语句
var 语句声明的变量，其作用域限定在运行中的执行上下文的 VariableEnvironment 内。var 变量会在其所在
语法
14.3.2.1 Runtime Semantics: Evaluation
- 执行 ?
VariableDeclarationList 的Evaluation 。 - 返回
empty 。
- 执行 ?
VariableDeclarationList 的Evaluation 。 - 返回 ?
VariableDeclaration 的Evaluation 。
- 返回
empty 。
- 令 bindingId 为
BindingIdentifier 的StringValue 。 - 令 lhs 为 ?
ResolveBinding (bindingId)。 - 如果
IsAnonymousFunctionDefinition (Initializer ) 是true ，则- 令 value 为 ? 以 bindingId 为实参执行
Initializer 的NamedEvaluation 。
- 令 value 为 ? 以 bindingId 为实参执行
- 否则，
- 令 rhs 为 ?
Initializer 的Evaluation 。 - 令 value 为 ?
GetValue (rhs)。
- 令 rhs 为 ?
- 执行 ?
PutValue (lhs, value)。 - 返回
empty 。
如果
- 令 rhs 为 ?
Initializer 的Evaluation 。 - 令 rightValue 为 ?
GetValue (rhs)。 - 返回 ? 以 rightValue 和
undefined 为实参执行BindingPattern 的BindingInitialization 。
14.3.3 解构绑定模式
语法
14.3.3.1 Runtime Semantics: PropertyBindingInitialization
The syntax-directed operation PropertyBindingInitialization takes arguments value (an ECMAScript language value) and envRecord (an
- 令 boundNames 为 ? 以 value 和 envRecord 为实参执行
BindingPropertyList 的PropertyBindingInitialization 。 - 令 nextNames 为 ? 以 value 和 envRecord 为实参执行
BindingProperty 的PropertyBindingInitialization 。 - 返回 boundNames 和 nextNames 的
列表连接 。
- 令 name 为
SingleNameBinding 的BoundNames 的唯一元素。 - 执行 ? 以 value、envRecord 和 name 为实参执行
SingleNameBinding 的KeyedBindingInitialization 。 - 返回 « name »。
- 令 propertyKey 为 ?
PropertyName 的Evaluation 。 - 执行 ? 以 value、envRecord 和 propertyKey 为实参执行
BindingElement 的KeyedBindingInitialization 。 - 返回 « propertyKey »。
14.3.3.2 Runtime Semantics: RestBindingInitialization
The syntax-directed operation RestBindingInitialization takes arguments value (an ECMAScript language value), envRecord (an
- 令 lhs 为 ?
ResolveBinding (BindingIdentifier 的StringValue , envRecord)。 - 令 restObj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 ?
CopyDataProperties (restObj, value, excludedNames)。 - 如果 envRecord 是
undefined ，则返回 ?PutValue (lhs, restObj)。 - 返回 ?
InitializeReferencedBinding (lhs, restObj)。
14.3.3.3 Runtime Semantics: KeyedBindingInitialization
The syntax-directed operation KeyedBindingInitialization takes arguments value (an ECMAScript language value), envRecord (an
It is defined piecewise over the following productions:
- 将 value 设置为 ?
GetV (value, propertyName)。 - 如果存在
Initializer 且 value 是undefined ，则- 令 defaultValue 为 ?
Initializer 的Evaluation 。 - 将 value 设置为 ?
GetValue (defaultValue)。
- 令 defaultValue 为 ?
- 返回 ? 以 value 和 envRecord 为实参执行
BindingPattern 的BindingInitialization 。
- 令 bindingId 为
BindingIdentifier 的StringValue 。 - 令 lhs 为 ?
ResolveBinding (bindingId, envRecord)。 - 将 value 设置为 ?
GetV (value, propertyName)。 - 如果存在
Initializer 且 value 是undefined ，则- 如果
IsAnonymousFunctionDefinition (Initializer ) 是true ，则- 将 value 设置为 ? 以 bindingId 为实参执行
Initializer 的NamedEvaluation 。
- 将 value 设置为 ? 以 bindingId 为实参执行
- 否则，
- 令 defaultValue 为 ?
Initializer 的Evaluation 。 - 将 value 设置为 ?
GetValue (defaultValue)。
- 令 defaultValue 为 ?
- 如果
- 如果 envRecord 是
undefined ，则返回 ?PutValue (lhs, value)。 - 返回 ?
InitializeReferencedBinding (lhs, value)。
14.4 空语句
语法
14.4.1 Runtime Semantics: Evaluation
- 返回
empty 。
14.5 表达式语句
语法
function 或 class async function 开始，因为这会使它与 let [ 开始，因为这会使它与首个 let
14.5.1 Runtime Semantics: Evaluation
- 令 exprRef 为 ?
Expression 的Evaluation 。 - 返回 ?
GetValue (exprRef)。
14.6 if 语句
语法
else] 以通常方式解决经典的“悬挂 else”问题。也就是说，当关联哪个 if 的选择除此之外存在歧义时，else 会与候选 if 中最近的（最内层的）那个关联14.6.1 Static Semantics: 早期错误
-
如果
IsLabelledFunction (第一个Statement ) 是true ，则为语法错误。 -
如果
IsLabelledFunction (第二个Statement ) 是true ，则为语法错误。
-
如果
IsLabelledFunction (Statement ) 是true ，则为语法错误。
只有在实现了
14.6.2 Runtime Semantics: Evaluation
- 令 exprRef 为 ?
Expression 的Evaluation 。 - 令 exprValue 为
ToBoolean (?GetValue (exprRef))。 - 如果 exprValue 是
true ，则- 令 stmtCompletion 为
Completion (第一个Statement 的Evaluation )。
- 令 stmtCompletion 为
- 否则，
- 令 stmtCompletion 为
Completion (第二个Statement 的Evaluation )。
- 令 stmtCompletion 为
- 返回 ?
UpdateEmpty (stmtCompletion,undefined )。
- 令 exprRef 为 ?
Expression 的Evaluation 。 - 令 exprValue 为
ToBoolean (?GetValue (exprRef))。 - 如果 exprValue 是
false ，则返回undefined 。 - 令 stmtCompletion 为
Completion (Statement 的Evaluation )。 - 返回 ?
UpdateEmpty (stmtCompletion,undefined )。
14.7 迭代语句
语法
14.7.1 语义
14.7.1.1 LoopContinues ( completion, labelSet )
The abstract operation LoopContinues takes arguments completion (a
- 如果 completion 是 normal completion，则返回
true 。 - 如果 completion 不是 continue completion，则返回
false 。 - 如果 completion.[[Target]] 是
empty ，则返回true 。 - 如果 labelSet
包含 completion.[[Target]]，则返回true 。 - 返回
false 。
在
14.7.1.2 Runtime Semantics: LoopEvaluation
The syntax-directed operation LoopEvaluation takes argument labelSet (a
- 返回 ? 以 labelSet 为实参执行
DoWhileStatement 的DoWhileLoopEvaluation 。
- 返回 ? 以 labelSet 为实参执行
WhileStatement 的WhileLoopEvaluation 。
- 返回 ? 以 labelSet 为实参执行
ForStatement 的ForLoopEvaluation 。
- 返回 ? 以 labelSet 为实参执行
ForInOfStatement 的ForInOfLoopEvaluation 。
14.7.2 do-while 语句
语法
14.7.2.1 Static Semantics: 早期错误
-
如果
IsLabelledFunction (Statement ) 是true ，则为语法错误。
只有在实现了
14.7.2.2 Runtime Semantics: DoWhileLoopEvaluation
The syntax-directed operation DoWhileLoopEvaluation takes argument labelSet (a
- 令 iterationResult 为
undefined 。 - 重复：
- 令 stmtResult 为
Completion (Statement 的Evaluation )。 - 如果
LoopContinues (stmtResult, labelSet) 是false ，则返回 ?UpdateEmpty (stmtResult, iterationResult)。 - 如果 stmtResult.[[Value]] 不是
empty ，则将 iterationResult 设置为 stmtResult.[[Value]]。 - 令 exprRef 为 ?
Expression 的Evaluation 。 - 令 exprValue 为 ?
GetValue (exprRef)。 - 如果
ToBoolean (exprValue) 是false ，则返回 iterationResult。
- 令 stmtResult 为
14.7.3 while 语句
语法
14.7.3.1 Static Semantics: 早期错误
-
如果
IsLabelledFunction (Statement ) 是true ，则为语法错误。
只有在实现了
14.7.3.2 Runtime Semantics: WhileLoopEvaluation
The syntax-directed operation WhileLoopEvaluation takes argument labelSet (a
- 令 iterationResult 为
undefined 。 - 重复：
- 令 exprRef 为 ?
Expression 的Evaluation 。 - 令 exprValue 为 ?
GetValue (exprRef)。 - 如果
ToBoolean (exprValue) 是false ，则返回 iterationResult。 - 令 stmtResult 为
Completion (Statement 的Evaluation )。 - 如果
LoopContinues (stmtResult, labelSet) 是false ，则返回 ?UpdateEmpty (stmtResult, iterationResult)。 - 如果 stmtResult.[[Value]] 不是
empty ，则将 iterationResult 设置为 stmtResult.[[Value]]。
- 令 exprRef 为 ?
14.7.4 for 语句
语法
14.7.4.1 Static Semantics: 早期错误
-
如果
IsLabelledFunction (Statement ) 是true ，则为语法错误。
只有在实现了
-
如果
LexicalDeclaration 的BoundNames 的任何元素也出现在Statement 的VarDeclaredNames 中，则为语法错误。
14.7.4.2 Runtime Semantics: ForLoopEvaluation
The syntax-directed operation ForLoopEvaluation takes argument labelSet (a
- 如果存在第一个
Expression ，则- 令 exprRef 为 ? 第一个
Expression 的Evaluation 。 - 执行 ?
GetValue (exprRef)。
- 令 exprRef 为 ? 第一个
- 如果存在第二个
Expression ，则令 test 为第二个Expression ；否则令 test 为empty 。 - 如果存在第三个
Expression ，则令 increment 为第三个Expression ；否则令 increment 为empty 。 - 返回 ?
ForBodyEvaluation (test, increment,Statement , « », labelSet)。
- 执行 ?
VariableDeclarationList 的Evaluation 。 - 如果存在第一个
Expression ，则令 test 为第一个Expression ；否则令 test 为empty 。 - 如果存在第二个
Expression ，则令 increment 为第二个Expression ；否则令 increment 为empty 。 - 返回 ?
ForBodyEvaluation (test, increment,Statement , « », labelSet)。
- 令 oldEnv 为运行中执行上下文的 LexicalEnvironment。
- 令 loopEnv 为
NewDeclarativeEnvironment (oldEnv)。 - 令 isConst 为
LexicalDeclaration 的IsConstantDeclaration 。 - 令 boundNames 为
LexicalDeclaration 的BoundNames 。 - 对 boundNames 的每个元素 name，执行
- 如果 isConst 是
true ，则- 执行 ! loopEnv.
CreateImmutableBinding (name,true )。
- 执行 ! loopEnv.
- 否则，
- 执行 ! loopEnv.
CreateMutableBinding (name,false )。
- 执行 ! loopEnv.
- 如果 isConst 是
- 将运行中执行上下文的 LexicalEnvironment 设置为 loopEnv。
- 令 forDecl 为
Completion (LexicalDeclaration 的求值)。 - 如果 forDecl 是突兀完成，则
- 将 forDecl 设置为
Completion (DisposeResources (loopEnv.[[DisposableResourceStack]], forDecl))。 - 断言：forDecl 是突兀完成。
- 将运行中执行上下文的 LexicalEnvironment 设置为 oldEnv。
- 返回 ? forDecl。
- 将 forDecl 设置为
- 如果 isConst 是
false ，则令 perIterationLets 为 boundNames；否则令 perIterationLets 为一个新的空列表。 - 如果第一个
Expression 存在，则令 test 为第一个Expression ；否则令 test 为empty 。 - 如果第二个
Expression 存在，则令 increment 为第二个Expression ；否则令 increment 为empty 。 - 令 bodyResult 为
Completion (ForBodyEvaluation (test, increment,Statement , perIterationLets, labelSet))。 - 将 bodyResult 设置为
Completion (DisposeResources (loopEnv.[[DisposableResourceStack]], bodyResult))。 - 断言：如果 bodyResult 是
正常完成 ，则 bodyResult.[[Value]] 不是empty 。 - 将运行中执行上下文的 LexicalEnvironment 设置为 oldEnv。
- 返回 ? bodyResult。
14.7.4.3 ForBodyEvaluation ( test, increment, stmt, perIterationBindings, labelSet )
The abstract operation ForBodyEvaluation takes arguments test (an
- 令 iterationResult 为
undefined 。 - 执行 ?
CreatePerIterationEnvironment (perIterationBindings)。 - 重复：
- 如果 test 不是
empty ，则- 令 testRef 为 ? test 的
Evaluation 。 - 令 testValue 为 ?
GetValue (testRef)。 - 如果
ToBoolean (testValue) 是false ，则返回 iterationResult。
- 令 testRef 为 ? test 的
- 令 result 为
Completion (stmt 的Evaluation )。 - 如果
LoopContinues (result, labelSet) 是false ，则返回 ?UpdateEmpty (result, iterationResult)。 - 如果 result.[[Value]] 不是
empty ，则将 iterationResult 设置为 result.[[Value]]。 - 执行 ?
CreatePerIterationEnvironment (perIterationBindings)。 - 如果 increment 不是
empty ，则- 令 incRef 为 ? increment 的
Evaluation 。 - 执行 ?
GetValue (incRef)。
- 令 incRef 为 ? increment 的
- 如果 test 不是
14.7.4.4 CreatePerIterationEnvironment ( perIterationBindings )
The abstract operation CreatePerIterationEnvironment takes argument perIterationBindings (a
- 如果 perIterationBindings 有任何元素，则
- 令 lastIterationEnv 为正在运行的执行上下文的 LexicalEnvironment。
- 令 outer 为 lastIterationEnv.[[OuterEnv]]。
- 断言：outer 不是
null 。 - 令 thisIterationEnv 为
NewDeclarativeEnvironment (outer)。 - 对 perIterationBindings 的每个元素 name，执行：
- 执行 ! thisIterationEnv.
CreateMutableBinding (name,false )。 - 令 lastValue 为 ? lastIterationEnv.
GetBindingValue (name,true )。 - 执行 ! thisIterationEnv.
InitializeBinding (name, lastValue)。
- 执行 ! thisIterationEnv.
- 将正在运行的执行上下文的 LexicalEnvironment 设为 thisIterationEnv。
- 返回
unused 。
14.7.5 for-in、for-of 和 for-await-of 语句
语法
本节由附录
14.7.5.1 Static Semantics: 早期错误
-
如果
IsLabelledFunction (Statement ) 是true ，则为语法错误。
只有在实现了
-
如果
LeftHandSideExpression 是ObjectLiteral 或ArrayLiteral ，则LeftHandSideExpression 必须覆盖一个AssignmentPattern 。 -
如果
LeftHandSideExpression 既不是ObjectLiteral 也不是ArrayLiteral ，且LeftHandSideExpression 的AssignmentTargetType 是invalid ，则为语法错误。
-
如果
ForDeclaration 的BoundNames 包含 "let" ，则为语法错误。 -
如果
ForDeclaration 的BoundNames 的任何元素也出现在Statement 的VarDeclaredNames 中，则为语法错误。 -
如果
ForDeclaration 的BoundNames 包含 任何重复项，则为语法错误。
14.7.5.2 Static Semantics: IsDestructuring
The syntax-directed operation IsDestructuring takes no arguments and returns a Boolean. It is defined piecewise over the following productions:
- 如果
PrimaryExpression 是ObjectLiteral 或ArrayLiteral ，则返回true 。 - 返回
false 。
- 返回
false 。
- 返回
ForBinding 的IsDestructuring 。
- 返回
false 。
- 返回
true 。
本节由附录
14.7.5.3 Runtime Semantics: ForDeclarationBindingInitialization
The syntax-directed operation ForDeclarationBindingInitialization takes arguments value (an ECMAScript language value) and envRecord (an
- 返回 ? 以 value 和 envRecord 为实参执行
ForBinding 的BindingInitialization 。
- 抛出
SyntaxError 异常。
14.7.5.4 Runtime Semantics: ForDeclarationBindingInstantiation
The syntax-directed operation ForDeclarationBindingInstantiation takes argument envRecord (a
- 对
ForBinding 的BoundNames 的每个元素 name，执行：- 如果
LetOrConst 的IsConstantDeclaration 是true ，则- 执行 ! envRecord.
CreateImmutableBinding (name,true )。
- 执行 ! envRecord.
- 否则，
- 执行 ! envRecord.
CreateMutableBinding (name,false )。
- 执行 ! envRecord.
- 如果
- 返回
unused 。
- 对
ForBinding 的BoundNames 的每个元素 name，执行- 执行 ! envRecord.
CreateImmutableBinding (name,true )。
- 执行 ! envRecord.
- 返回
unused 。
14.7.5.5 Runtime Semantics: ForInOfLoopEvaluation
The syntax-directed operation ForInOfLoopEvaluation takes argument labelSet (a
- 令 keyResult 为 ?
ForIn/OfHeadEvaluation (« »,Expression ,enumerate )。 - 返回 ?
ForIn/OfBodyEvaluation (LeftHandSideExpression ,Statement , keyResult,enumerate ,assignment , labelSet)。
- 令 keyResult 为 ?
ForIn/OfHeadEvaluation (« »,Expression ,enumerate )。 - 返回 ?
ForIn/OfBodyEvaluation (ForBinding ,Statement , keyResult,enumerate ,var-binding , labelSet)。
- 令 keyResult 为 ?
ForIn/OfHeadEvaluation (ForDeclaration 的BoundNames ,Expression ,enumerate )。 - 返回 ?
ForIn/OfBodyEvaluation (ForDeclaration ,Statement , keyResult,enumerate ,lexical-binding , labelSet)。
- 令 keyResult 为 ?
ForIn/OfHeadEvaluation (« »,AssignmentExpression ,iterate )。 - 返回 ?
ForIn/OfBodyEvaluation (LeftHandSideExpression ,Statement , keyResult,iterate ,assignment , labelSet)。
- 令 keyResult 为 ?
ForIn/OfHeadEvaluation (« »,AssignmentExpression ,iterate )。 - 返回 ?
ForIn/OfBodyEvaluation (ForBinding ,Statement , keyResult,iterate ,var-binding , labelSet)。
- 令 keyResult 为 ?
ForIn/OfHeadEvaluation (ForDeclaration 的BoundNames ,AssignmentExpression ,iterate )。 - 返回 ?
ForIn/OfBodyEvaluation (ForDeclaration ,Statement , keyResult,iterate ,lexical-binding , labelSet)。
- 令 keyResult 为 ?
ForIn/OfHeadEvaluation (« »,AssignmentExpression ,async-iterate )。 - 返回 ?
ForIn/OfBodyEvaluation (LeftHandSideExpression ,Statement , keyResult,iterate ,assignment , labelSet,async )。
- 令 keyResult 为 ?
ForIn/OfHeadEvaluation (« »,AssignmentExpression ,async-iterate )。 - 返回 ?
ForIn/OfBodyEvaluation (ForBinding ,Statement , keyResult,iterate ,var-binding , labelSet,async )。
- 令 keyResult 为 ?
ForIn/OfHeadEvaluation (ForDeclaration 的BoundNames ,AssignmentExpression ,async-iterate )。 - 返回 ?
ForIn/OfBodyEvaluation (ForDeclaration ,Statement , keyResult,iterate ,lexical-binding , labelSet,async )。
本节由附录
14.7.5.6 ForIn/OfHeadEvaluation ( uninitializedBoundNames, expr, iterationKind )
The abstract operation ForIn/OfHeadEvaluation takes arguments uninitializedBoundNames (a
- 令 oldEnv 为运行中的执行上下文的 LexicalEnvironment。
- 如果 uninitializedBoundNames 不是空的，则
- 断言：uninitializedBoundNames 没有重复项。
- 令 newEnv 为
NewDeclarativeEnvironment (oldEnv)。 - 对 uninitializedBoundNames 的每个 String name，执行：
- 执行 ! newEnv.
CreateMutableBinding (name,false )。
- 执行 ! newEnv.
- 将运行中的执行上下文的 LexicalEnvironment 设置为 newEnv。
- 令 exprRef 为
Completion (expr 的Evaluation )。 - 将运行中的执行上下文的 LexicalEnvironment 设置为 oldEnv。
- 令 exprValue 为 ?
GetValue (? exprRef)。 - 如果 iterationKind 是
enumerate ，则- 如果 exprValue 是
undefined 或null ，则- 返回
Completion Record { [[Type]]:break , [[Value]]:empty , [[Target]]:empty }。
- 返回
- 令 obj 为 !
ToObject (exprValue)。 - 令 iterator 为
EnumerateObjectProperties (obj)。 - 令 nextMethod 为 !
GetV (iterator,"next" )。 - 返回
Iterator Record { [[Iterator]]: iterator, [[NextMethod]]: nextMethod, [[Done]]:false }。
- 如果 exprValue 是
- 断言：iterationKind 是
iterate 或async-iterate 。 - 如果 iterationKind 是
async-iterate ，则令 iteratorKind 为async 。 - 否则，令 iteratorKind 为
sync 。 - 返回 ?
GetIterator (exprValue, iteratorKind)。
14.7.5.7 ForIn/OfBodyEvaluation ( lhs, stmt, iteratorRecord, iterationKind, lhsKind, labelSet [ , iteratorKind ] )
The abstract operation ForIn/OfBodyEvaluation takes arguments lhs (a
- 如果 iteratorKind 不存在，则将 iteratorKind 设置为
sync 。 - 令 oldEnv 为运行中执行上下文的 LexicalEnvironment。
- 令 iterationResult 为
undefined 。 - 如果 lhsKind 是
lexical-binding ，则- 断言：lhs 是一个
ForDeclaration 。 - 如果 lhs 的
IsAwaitUsingDeclaration 是true ，则- 令 declarationKind 为
async-dispose 。
- 令 declarationKind 为
- 否则如果 lhs 的
IsUsingDeclaration 是true ，则- 令 declarationKind 为
sync-dispose 。
- 令 declarationKind 为
- 否则，
- 令 declarationKind 为
normal 。
- 令 declarationKind 为
- 断言：lhs 是一个
- 否则，
- 令 declarationKind 为
normal 。
- 令 declarationKind 为
- 令 destructuring 为 lhs 的
IsDestructuring 。 - 如果 destructuring 是
true 且 lhsKind 是assignment ，则- 断言：lhs 是一个
LeftHandSideExpression 。 - 令 assignmentPattern 为 lhs 所
覆盖的 AssignmentPattern 。
- 断言：lhs 是一个
- 重复，
- 令 nextResult 为 ?
Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]])。 - 如果 iteratorKind 是
async ，则将 nextResult 设置为 ?Await (nextResult)。 - 如果 nextResult 不是对象，则抛出
TypeError 异常。 - 令 done 为 ?
IteratorComplete (nextResult)。 - 如果 done 是
true ，则返回 iterationResult。 - 令 nextValue 为 ?
IteratorValue (nextResult)。 - 如果 lhsKind 是
assignment 或var-binding ，则- 如果 destructuring 是
true ，则- 如果 lhsKind 是
assignment ，则- 令 status 为以 nextValue 为参数的 assignmentPattern 的
DestructuringAssignmentEvaluation 的Completion 。
- 令 status 为以 nextValue 为参数的 assignmentPattern 的
- 否则，
- 断言：lhsKind 是
var-binding 。 - 断言：lhs 是一个
ForBinding 。 - 令 status 为以 nextValue 和
undefined 为参数的 lhs 的BindingInitialization 的Completion 。
- 断言：lhsKind 是
- 如果 lhsKind 是
- 否则，
- 令 lhsRef 为 lhs 的求值的
Completion 。（它可能会被重复求值。） - 如果 lhsKind 是
assignment 且 lhs 的AssignmentTargetType 是web-compat ，则抛出ReferenceError 异常。 - 如果 lhsRef 是突兀完成，则
- 令 status 为 lhsRef。
- 否则，
- 令 status 为
Completion (PutValue (lhsRef.[[Value]], nextValue))。
- 令 status 为
- 令 lhsRef 为 lhs 的求值的
- 令 iterationEnv 为
undefined 。
- 如果 destructuring 是
- 否则，
- 断言：lhsKind 是
lexical-binding 。 - 断言：lhs 是一个
ForDeclaration 。 - 令 iterationEnv 为
NewDeclarativeEnvironment (oldEnv)。 - 执行以 iterationEnv 为参数的 lhs 的
ForDeclarationBindingInstantiation 。 - 将运行中执行上下文的 LexicalEnvironment 设置为 iterationEnv。
- 如果 destructuring 是
true ，则- 令 status 为以 nextValue 和 iterationEnv 为参数的 lhs 的
ForDeclarationBindingInitialization 的Completion 。
- 令 status 为以 nextValue 和 iterationEnv 为参数的 lhs 的
- 否则，
- 断言：lhs 绑定单个名称。
- 令 lhsName 为 lhs 的
BoundNames 的唯一元素。 - 令 lhsRef 为 !
ResolveBinding (lhsName)。 - 如果 declarationKind 不是
normal ，则- 断言：
IsUnresolvableReference (lhsRef) 是false 。 - 令 base 为 lhsRef.[[Base]]。
- 断言：base 是声明式环境记录。
- 令 status 为
Completion (AddDisposableResource (base.[[DisposableResourceStack]], nextValue, declarationKind))。
- 断言：
- 否则，
- 令 status 为
NormalCompletion (unused )。
- 令 status 为
- 如果 status 是
正常完成 ，则- 将 status 设置为
Completion (InitializeReferencedBinding (lhsRef, nextValue))。
- 将 status 设置为
- 断言：lhsKind 是
- 如果 status 是突兀完成，则
- 如果 iterationEnv 不是
undefined ，则- 将 status 设置为
Completion (DisposeResources (iterationEnv.[[DisposableResourceStack]], status))。 - 断言：status 是突兀完成。
- 将 status 设置为
- 将运行中执行上下文的 LexicalEnvironment 设置为 oldEnv。
- 如果 iterationKind 是
enumerate ，则返回 ? status。 - 断言：iterationKind 是
iterate 。 - 如果 iteratorKind 是
async ，则返回 ?AsyncIteratorClose (iteratorRecord, status)。 - 返回 ?
IteratorClose (iteratorRecord, status)。
- 如果 iterationEnv 不是
- 令 result 为 stmt 的求值的
Completion 。 - 如果 iterationEnv 不是
undefined ，则- 将 result 设置为
Completion (DisposeResources (iterationEnv.[[DisposableResourceStack]], result))。
- 将 result 设置为
- 将运行中执行上下文的 LexicalEnvironment 设置为 oldEnv。
- 如果
LoopContinues (result, labelSet) 是false ，则- 将 status 设置为
Completion (UpdateEmpty (result, iterationResult))。 - 如果 iterationKind 是
enumerate ，则返回 ? status。 - 断言：iterationKind 是
iterate 。 - 如果 iteratorKind 是
async ，则返回 ?AsyncIteratorClose (iteratorRecord, status)。 - 返回 ?
IteratorClose (iteratorRecord, status)。
- 将 status 设置为
- 如果 result.[[Value]] 不是
empty ，则将 iterationResult 设置为 result.[[Value]]。
- 令 nextResult 为 ?
14.7.5.8 Runtime Semantics: Evaluation
- 令 bindingId 为
BindingIdentifier 的StringValue 。 - 返回 ?
ResolveBinding (bindingId)。
14.7.5.9 EnumerateObjectProperties ( obj )
The abstract operation EnumerateObjectProperties takes argument obj (an Object) and returns an
- 返回一个迭代器对象，其
next方法会遍历 obj 的可枚举属性中所有 String 值键。该迭代器对象永远不能被 ECMAScript 代码直接访问。枚举属性的机制和顺序未指定，但必须符合下面指定的规则。
该迭代器的 throw 和 return 方法是 next 方法会处理对象属性，以确定是否应将next 方法处理某个属性之前被删除的属性会被忽略。如果在枚举期间向目标对象添加新属性，则不保证新添加的属性会在活动枚举中被处理。在任意枚举中，一个next 方法返回一次。
枚举目标对象的属性包括递归地枚举其原型、原型的原型，依此类推；但如果某个原型的属性与迭代器的 next 方法已经处理过的属性同名，则不会处理该原型属性。在确定原型对象的某个属性是否已经被处理过时，不考虑 [[Enumerable]] 特性的值。原型对象的可枚举
此外，如果 obj 及其原型链中的任何对象都不是
- obj 或其原型链中某个对象的 [[Prototype]] 内部槽的值发生变化，
- 从 obj 或其原型链中的某个对象移除了属性，
- 向 obj 的原型链中的某个对象添加了属性，或
- obj 或其原型链中某个对象的某个属性的 [[Enumerable]] 特性值发生变化。
ECMAScript 实现不要求直接实现
以下是一个符合这些规则的 ECMAScript 生成器函数的信息性定义：
function* EnumerateObjectProperties(obj) {
const visited = new Set();
for (const key of Reflect.ownKeys(obj)) {
if (typeof key === "symbol") continue;
const desc = Reflect.getOwnPropertyDescriptor(obj, key);
if (desc) {
visited.add(key);
if (desc.enumerable) yield key;
}
}
const proto = Reflect.getPrototypeOf(obj);
if (proto === null) return;
for (const protoKey of EnumerateObjectProperties(proto)) {
if (!visited.has(protoKey)) yield protoKey;
}
}14.7.5.10 For-In 迭代器对象
For-In Iterator 是一个表示对某个特定对象进行某次特定迭代的对象。For-In Iterator 对象永远不能被 ECMAScript 代码直接访问；它们的存在只是为了说明
14.7.5.10.1 CreateForInIterator ( obj )
The abstract operation CreateForInIterator takes argument obj (an Object) and returns a
- 令 iterator 为
OrdinaryObjectCreate (%ForInIteratorPrototype% , « [[Object]], [[ObjectWasVisited]], [[VisitedKeys]], [[RemainingKeys]] »)。 - 将 iterator.[[Object]] 设置为 obj。
- 将 iterator.[[ObjectWasVisited]] 设置为
false 。 - 将 iterator.[[VisitedKeys]] 设置为新的空
List 。 - 将 iterator.[[RemainingKeys]] 设置为新的空
List 。 - 返回 iterator。
14.7.5.10.2 %ForInIteratorPrototype% 对象
%ForInIteratorPrototype% 对象：
- 具有由所有
For-In Iterator 对象继承的属性。 - 是
普通对象 。 - 具有一个 [[Prototype]] 内部槽，其值为
%Iterator.prototype% 。 - 永远不能被 ECMAScript 代码直接访问。
- 具有以下属性：
14.7.5.10.2.1 %ForInIteratorPrototype%.next ( )
- 令 iterator 为
this 值。 - 断言：iterator 是 Object。
- 断言：iterator 具有
For-In Iterator 实例的所有内部槽（14.7.5.10.3 ）。 - 令 obj 为 iterator.[[Object]]。
- 重复：
- 如果 iterator.[[ObjectWasVisited]] 是
false ，则- 令 keys 为 ? obj.[[OwnPropertyKeys]]()。
- 对 keys 的每个元素 key，执行：
- 如果 key 是 String，则
- 将 key 追加到 iterator.[[RemainingKeys]]。
- 如果 key 是 String，则
- 将 iterator.[[ObjectWasVisited]] 设置为
true 。
- 重复，当 iterator.[[RemainingKeys]] 不是空时，
- 令 key 为 iterator.[[RemainingKeys]] 的第一个元素。
- 从 iterator.[[RemainingKeys]] 移除第一个元素。
- 如果 iterator.[[VisitedKeys]] 不
包含 key，则- 令 propertyDesc 为 ? obj.[[GetOwnProperty]](key)。
- 如果 propertyDesc 不是
undefined ，则- 将 key 追加到 iterator.[[VisitedKeys]]。
- 如果 propertyDesc.[[Enumerable]] 是
true ，则返回CreateIteratorResultObject (key,false )。
- 将 obj 设置为 ? obj.[[GetPrototypeOf]]()。
- 将 iterator.[[Object]] 设置为 obj。
- 将 iterator.[[ObjectWasVisited]] 设置为
false 。 - 如果 obj 是
null ，则返回CreateIteratorResultObject (undefined ,true )。
- 如果 iterator.[[ObjectWasVisited]] 是
14.7.5.10.3 For-In Iterator 实例的属性
| 内部槽 | 类型 | 描述 |
|---|---|---|
| [[Object]] | Object | 其属性正被迭代的 Object 值。 |
| [[ObjectWasVisited]] | Boolean |
如果迭代器已在 [[Object]] 上调用 [[OwnPropertyKeys]]，则为 |
| [[VisitedKeys]] |
Strings 的 |
此迭代器到目前为止已经发出的值。 |
| [[RemainingKeys]] |
Strings 的 |
在迭代其原型的属性（如果其原型不是 |
14.8 continue 语句
语法
14.8.1 Static Semantics: 早期错误
-
如果此
ContinueStatement 没有直接或间接地嵌套在IterationStatement 内（但不能跨越函数或static初始化块边界），则为语法错误。
14.8.2 Runtime Semantics: Evaluation
- 返回
Completion Record { [[Type]]:continue , [[Value]]:empty , [[Target]]:empty }。
- 令 label 为
LabelIdentifier 的StringValue 。 - 返回
Completion Record { [[Type]]:continue , [[Value]]:empty , [[Target]]: label }。
14.9 break 语句
语法
14.9.1 Static Semantics: 早期错误
-
如果此
BreakStatement 没有直接或间接地嵌套在IterationStatement 或SwitchStatement 内（但不能跨越函数或static初始化块边界），则为语法错误。
14.9.2 Runtime Semantics: Evaluation
- 返回
Completion Record { [[Type]]:break , [[Value]]:empty , [[Target]]:empty }。
- 令 label 为
LabelIdentifier 的StringValue 。 - 返回
Completion Record { [[Type]]:break , [[Value]]:empty , [[Target]]: label }。
14.10 return 语句
语法
return 语句会使函数停止执行，并且在大多数情况下向调用者返回一个值。如果省略 return 语句实际上可能不会向调用者返回值。例如，在 try 块中，return 语句的 finally 块期间被另一个
14.10.1 Runtime Semantics: Evaluation
- 返回
ReturnCompletion (undefined )。
- 令 exprRef 为 ?
Expression 的Evaluation 。 - 令 exprValue 为 ?
GetValue (exprRef)。 - 如果
GetGeneratorKind () 是async ，则将 exprValue 设置为 ?Await (exprValue)。 - 返回
ReturnCompletion (exprValue)。
14.11 with 语句
语法
with 语句会把一个计算所得对象的
14.11.1 Static Semantics: 早期错误
-
如果
IsStrict (this production) 是true ，则为语法错误。 -
如果
IsLabelledFunction (Statement ) 是true ，则为语法错误。
只有在实现了
14.11.2 Runtime Semantics: Evaluation
- 令 value 为 ?
Expression 的Evaluation 。 - 令 obj 为 ?
ToObject (?GetValue (value))。 - 令 oldEnv 为运行中的执行上下文的 LexicalEnvironment。
- 令 newEnv 为
NewObjectEnvironment (obj,true , oldEnv)。 - 将运行中的执行上下文的 LexicalEnvironment 设置为 newEnv。
- 令 stmtCompletion 为
Completion (Statement 的Evaluation )。 - 将运行中的执行上下文的 LexicalEnvironment 设置为 oldEnv。
- 返回 ?
UpdateEmpty (stmtCompletion,undefined )。
无论控制如何离开嵌入的
14.12 switch 语句
语法
14.12.1 Static Semantics: 早期错误
-
如果
CaseBlock 的LexicallyDeclaredNames 包含 任何重复项，则为语法错误，除非宿主 是 Web 浏览器，或以其他方式支持块级函数声明的 Web 遗留兼容性语义 ，并且以下两个条件都为真：IsStrict (this production) 是false 。- 这些重复项只由 FunctionDeclarations 绑定。
-
如果
CaseBlock 的LexicallyDeclaredNames 的任何元素也出现在CaseBlock 的VarDeclaredNames 中，则为语法错误。
-
如果
StatementList 的ContainsUsing 是true ，则为语法错误。
-
如果
StatementList 的ContainsUsing 是true ，则为语法错误。
14.12.2 Runtime Semantics: CaseBlockEvaluation
The syntax-directed operation CaseBlockEvaluation takes argument input (an ECMAScript language value) and returns either a normal completion containing an ECMAScript language value or an abrupt completion. It is defined piecewise over the following productions:
- 返回
undefined 。
- 令 resultValue 为
undefined 。 - 令 caseClauses 为
CaseClauses 中按源文本顺序排列的CaseClause 项的List 。 - 令 found 为
false 。 - 对 caseClauses 的每个
CaseClause clause，执行：- 如果 found 是
false ，则- 将 found 设置为 ?
CaseClauseIsSelected (clause, input)。
- 将 found 设置为 ?
- 如果 found 是
true ，则- 令 completion 为
Completion (clause 的Evaluation )。 - 如果 completion.[[Value]] 不是
empty ，则将 resultValue 设置为 completion.[[Value]]。 - 如果 completion 是 abrupt completion，则返回 ?
UpdateEmpty (completion, resultValue)。
- 令 completion 为
- 如果 found 是
- 返回 resultValue。
- 令 resultValue 为
undefined 。 - 如果存在第一个
CaseClauses ，则- 令 caseClauses 为第一个
CaseClauses 中按源文本顺序排列的CaseClause 项的List 。
- 令 caseClauses 为第一个
- 否则，
- 令 caseClauses 为新的空
List 。
- 令 caseClauses 为新的空
- 令 found 为
false 。 - 对 caseClauses 的每个
CaseClause clause，执行：- 如果 found 是
false ，则- 将 found 设置为 ?
CaseClauseIsSelected (clause, input)。
- 将 found 设置为 ?
- 如果 found 是
true ，则- 令 completion 为
Completion (clause 的Evaluation )。 - 如果 completion.[[Value]] 不是
empty ，则将 resultValue 设置为 completion.[[Value]]。 - 如果 completion 是 abrupt completion，则返回 ?
UpdateEmpty (completion, resultValue)。
- 令 completion 为
- 如果 found 是
- 令 foundInB 为
false 。 - 如果存在第二个
CaseClauses ，则- 令 secondCaseClauses 为第二个
CaseClauses 中按源文本顺序排列的CaseClause 项的List 。
- 令 secondCaseClauses 为第二个
- 否则，
- 令 secondCaseClauses 为新的空
List 。
- 令 secondCaseClauses 为新的空
- 如果 found 是
false ，则- 对 secondCaseClauses 的每个
CaseClause clause，执行：- 如果 foundInB 是
false ，则- 将 foundInB 设置为 ?
CaseClauseIsSelected (clause, input)。
- 将 foundInB 设置为 ?
- 如果 foundInB 是
true ，则- 令 completion 为
Completion (CaseClause clause 的Evaluation )。 - 如果 completion.[[Value]] 不是
empty ，则将 resultValue 设置为 completion.[[Value]]。 - 如果 completion 是 abrupt completion，则返回 ?
UpdateEmpty (completion, resultValue)。
- 令 completion 为
- 如果 foundInB 是
- 对 secondCaseClauses 的每个
- 如果 foundInB 是
true ，则返回 resultValue。 - 令 defaultR 为
Completion (DefaultClause 的Evaluation )。 - 如果 defaultR.[[Value]] 不是
empty ，则将 resultValue 设置为 defaultR.[[Value]]。 - 如果 defaultR 是 abrupt completion，则返回 ?
UpdateEmpty (defaultR, resultValue)。 - 注：以下是对第二个
CaseClauses 的另一次完整迭代。 - 对 secondCaseClauses 的每个
CaseClause clause，执行：- 令 completion 为
Completion (CaseClause clause 的Evaluation )。 - 如果 completion.[[Value]] 不是
empty ，则将 resultValue 设置为 completion.[[Value]]。 - 如果 completion 是 abrupt completion，则返回 ?
UpdateEmpty (completion, resultValue)。
- 令 completion 为
- 返回 resultValue。
14.12.3 CaseClauseIsSelected ( caseClauseNode, input )
The abstract operation CaseClauseIsSelected takes arguments caseClauseNode (a
- 断言：caseClauseNode 是产生式
CaseClause : case Expression : StatementList opt - 令 exprRef 为 ? caseClauseNode 的
Expression 的Evaluation 。 - 令 clauseSelector 为 ?
GetValue (exprRef)。 - 返回
IsStrictlyEqual (input, clauseSelector)。
此操作不会执行 caseClauseNode 的
14.12.4 Runtime Semantics: Evaluation
- 令 exprRef 为
Expression 的 ?Evaluation 。 - 令 switchValue 为 ?
GetValue (exprRef)。 - 令 oldEnv 为运行中执行上下文的 LexicalEnvironment。
- 令 blockEnv 为
NewDeclarativeEnvironment (oldEnv)。 - 执行
BlockDeclarationInstantiation (CaseBlock , blockEnv)。 - 将运行中执行上下文的 LexicalEnvironment 设置为 blockEnv。
- 令 blockResult 为以 switchValue 为参数的
CaseBlock 的CaseBlockEvaluation 的Completion 。 - 断言：blockEnv.[[DisposableResourceStack]] 是一个空列表。
- 将运行中执行上下文的 LexicalEnvironment 设置为 oldEnv。
- 返回 blockResult。
无论控制如何离开
- 返回
empty 。
- 返回 ?
StatementList 的Evaluation 。
- 返回
empty 。
- 返回 ?
StatementList 的Evaluation 。
14.13 带标签语句
语法
break 和 continue 语句结合使用。ECMAScript 没有 goto 语句。一个
14.13.1 Static Semantics: 早期错误
14.13.2 Static Semantics: IsLabelledFunction ( stmt )
The abstract operation IsLabelledFunction takes argument stmt (a
- 如果 stmt 不是
LabelledStatement ，则返回false 。 - 令 item 为 stmt 的
LabelledItem 。 - 如果 item 是
LabelledItem : FunctionDeclaration true 。 - 令 subStmt 为 item 的
Statement 。 - 返回
IsLabelledFunction (subStmt)。
14.13.3 Runtime Semantics: Evaluation
- 返回 ? 以 « » 为实参执行此
LabelledStatement 的LabelledEvaluation 。
14.13.4 Runtime Semantics: LabelledEvaluation
The syntax-directed operation LabelledEvaluation takes argument labelSet (a
- 令 stmtResult 为
Completion (以 labelSet 为实参执行IterationStatement 的LoopEvaluation )。 - 如果 stmtResult 是 break completion，则
- 如果 stmtResult.[[Target]] 是
empty ，则- 如果 stmtResult.[[Value]] 是
empty ，则将 stmtResult 设置为NormalCompletion (undefined )。 - 否则，将 stmtResult 设置为
NormalCompletion (stmtResult.[[Value]])。
- 如果 stmtResult.[[Value]] 是
- 如果 stmtResult.[[Target]] 是
- 返回 ? stmtResult。
- 令 stmtResult 为
Completion (SwitchStatement 的Evaluation )。 - 如果 stmtResult 是 break completion，则
- 如果 stmtResult.[[Target]] 是
empty ，则- 如果 stmtResult.[[Value]] 是
empty ，则将 stmtResult 设置为NormalCompletion (undefined )。 - 否则，将 stmtResult 设置为
NormalCompletion (stmtResult.[[Value]])。
- 如果 stmtResult.[[Value]] 是
- 如果 stmtResult.[[Target]] 是
- 返回 ? stmtResult。
- 令 label 为
LabelIdentifier 的StringValue 。 - 令 newLabelSet 为 labelSet 和 « label » 的
列表连接 。 - 令 stmtResult 为
Completion (以 newLabelSet 为实参执行LabelledItem 的LabelledEvaluation )。 - 如果 stmtResult 是 break completion 且 stmtResult.[[Target]] 是 label，则
- 将 stmtResult 设置为
NormalCompletion (stmtResult.[[Value]])。
- 将 stmtResult 设置为
- 返回 ? stmtResult。
- 返回 ?
FunctionDeclaration 的Evaluation 。
- 返回 ?
Statement 的Evaluation 。
14.14 throw 语句
语法
14.14.1 Runtime Semantics: Evaluation
- 令 exprRef 为 ?
Expression 的Evaluation 。 - 令 exprValue 为 ?
GetValue (exprRef)。 - 抛出 exprValue。
14.15 try 语句
语法
try 语句包围一段代码块，其中可能发生异常条件，例如运行时错误或 throw 语句。catch 子句提供异常处理代码。当 catch 子句捕获异常时，其
14.15.1 Static Semantics: 早期错误
-
如果
CatchParameter 的BoundNames 包含 任何重复元素，则为语法错误。 -
如果
CatchParameter 的BoundNames 的任何元素也出现在Block 的LexicallyDeclaredNames 中，则为语法错误。 -
如果
CatchParameter 的BoundNames 的任何元素也出现在Block 的VarDeclaredNames 中，则为语法错误，除非CatchParameter 是CatchParameter : BindingIdentifier 宿主 是 Web 浏览器或以其他方式支持Catch 块中的 VariableStatement 。
14.15.2 Runtime Semantics: CatchClauseEvaluation
The syntax-directed operation CatchClauseEvaluation takes argument thrownValue (an ECMAScript language value) and returns either a normal completion containing either an ECMAScript language value or
- 令 oldEnv 为运行中的执行上下文的 LexicalEnvironment。
- 令 catchEnv 为
NewDeclarativeEnvironment (oldEnv)。 - 对
CatchParameter 的BoundNames 的每个元素 argName，执行：- 执行 ! catchEnv.
CreateMutableBinding (argName,false )。
- 执行 ! catchEnv.
- 将运行中的执行上下文的 LexicalEnvironment 设置为 catchEnv。
- 令 status 为
Completion (以 thrownValue 和 catchEnv 为实参执行CatchParameter 的BindingInitialization )。 - 如果 status 是 abrupt completion，则
- 将运行中的执行上下文的 LexicalEnvironment 设置为 oldEnv。
- 返回 ? status。
- 令 blockCompletion 为
Completion (Block 的Evaluation )。 - 将运行中的执行上下文的 LexicalEnvironment 设置为 oldEnv。
- 返回 ? blockCompletion。
- 返回 ?
Block 的Evaluation 。
无论控制如何离开
14.15.3 Runtime Semantics: Evaluation
- 令 blockResult 为
Completion (Block 的Evaluation )。 - 如果 blockResult 是 throw completion，则令 catchResult 为
Completion (以 blockResult.[[Value]] 为实参执行Catch 的CatchClauseEvaluation )。 - 否则，令 catchResult 为 blockResult。
- 返回 ?
UpdateEmpty (catchResult,undefined )。
- 令 blockResult 为
Completion (Block 的Evaluation )。 - 令 finallyResult 为
Completion (Finally 的Evaluation )。 - 如果 finallyResult 是 normal completion，则将 finallyResult 设置为 blockResult。
- 返回 ?
UpdateEmpty (finallyResult,undefined )。
- 令 blockResult 为
Completion (Block 的Evaluation )。 - 如果 blockResult 是 throw completion，则令 catchResult 为
Completion (以 blockResult.[[Value]] 为实参执行Catch 的CatchClauseEvaluation )。 - 否则，令 catchResult 为 blockResult。
- 令 finallyResult 为
Completion (Finally 的Evaluation )。 - 如果 finallyResult 是 normal completion，则将 finallyResult 设置为 catchResult。
- 返回 ?
UpdateEmpty (finallyResult,undefined )。
14.16 debugger 语句
语法
14.16.1 Runtime Semantics: Evaluation
求值
- 如果
实现定义的 调试设施可用且已启用，则- 执行一个
实现定义的 调试动作。 - 返回一个新的实现定义
Completion Record 。
- 执行一个
- 返回
empty 。
15 ECMAScript 语言：函数和类
15.1 参数列表
语法
15.1.1 Static Semantics: 早期错误
-
如果
FormalParameters 的BoundNames 包含 任何重复元素，则为语法错误。
-
如果
FormalParameterList 的IsSimpleParameterList 是false ，且FormalParameterList 的BoundNames 包含 任何重复元素，则为语法错误。
同一个
15.1.2 Static Semantics: ContainsExpression
The syntax-directed operation ContainsExpression takes no arguments and returns a Boolean. It is defined piecewise over the following productions:
- 返回
false 。
- 返回
false 。
- 令 has 为
BindingElementList 的ContainsExpression 。 - 如果 has 是
true ，则返回true 。 - 返回
BindingRestElement 的ContainsExpression 。
- 令 has 为
BindingPropertyList 的ContainsExpression 。 - 如果 has 是
true ，则返回true 。 - 返回
BindingProperty 的ContainsExpression 。
- 令 has 为
BindingElementList 的ContainsExpression 。 - 如果 has 是
true ，则返回true 。 - 返回
BindingElisionElement 的ContainsExpression 。
- 令 has 为
PropertyName 的IsComputedPropertyKey 。 - 如果 has 是
true ，则返回true 。 - 返回
BindingElement 的ContainsExpression 。
- 返回
true 。
- 返回
false 。
- 返回
true 。
- 返回
false 。
- 返回
false 。
- 如果
FormalParameterList 的ContainsExpression 是true ，则返回true 。 - 返回
FunctionRestParameter 的ContainsExpression 。
- 如果
FormalParameterList 的ContainsExpression 是true ，则返回true 。 - 返回
FormalParameter 的ContainsExpression 。
- 返回
false 。
- 令 formals 为由
CoverParenthesizedExpressionAndArrowParameterList 覆盖的 ArrowFormalParameters 。 - 返回 formals 的
ContainsExpression 。
- 返回
false 。
15.1.3 Static Semantics: IsSimpleParameterList
The syntax-directed operation IsSimpleParameterList takes no arguments and returns a Boolean. It is defined piecewise over the following productions:
- 返回
false 。
- 返回
false 。
- 返回
true 。
- 返回
false 。
- 返回
true 。
- 返回
false 。
- 返回
false 。
- 如果
FormalParameterList 的IsSimpleParameterList 是false ，则返回false 。 - 返回
FormalParameter 的IsSimpleParameterList 。
- 返回
true 。
- 令 formals 为由
CoverParenthesizedExpressionAndArrowParameterList 覆盖的 ArrowFormalParameters 。 - 返回 formals 的
IsSimpleParameterList 。
- 返回
true 。
- 令 head 为由
CoverCallExpressionAndAsyncArrowHead 覆盖的 AsyncArrowHead 。 - 返回 head 的
IsSimpleParameterList 。
15.1.4 Static Semantics: HasInitializer
The syntax-directed operation HasInitializer takes no arguments and returns a Boolean. It is defined piecewise over the following productions:
- 返回
false 。
- 返回
true 。
- 返回
false 。
- 返回
true 。
- 如果
FormalParameterList 的HasInitializer 是true ，则返回true 。 - 返回
FormalParameter 的HasInitializer 。
15.1.5 Static Semantics: ExpectedArgumentCount
The syntax-directed operation ExpectedArgumentCount takes no arguments and returns a non-negative
- 返回 0。
- 如果
FormalParameter 的HasInitializer 是true ，则返回 0。 - 返回 1。
- 令 count 为
FormalParameterList 的ExpectedArgumentCount 。 - 如果
FormalParameterList 的HasInitializer 是true ，或FormalParameter 的HasInitializer 是true ，则返回 count。 - 返回 count + 1。
- 返回 1。
- 令 formals 为由
CoverParenthesizedExpressionAndArrowParameterList 覆盖的 ArrowFormalParameters 。 - 返回 formals 的
ExpectedArgumentCount 。
- 如果
FormalParameter 的HasInitializer 是true ，则返回 0。 - 返回 1。
- 返回 1。
15.2 函数定义
语法
15.2.1 Static Semantics: 早期错误
-
如果
IsStrict (FormalParameters ) 是true ，则应用UniqueFormalParameters : FormalParameters 早期错误 规则。 -
如果存在
BindingIdentifier 且IsStrict (BindingIdentifier ) 是true ，并且BindingIdentifier 的StringValue 是"eval" 或"arguments" ，则为语法错误。 -
如果
FunctionBody 的FunctionBodyContainsUseStrict 是true ，且FormalParameters 的IsSimpleParameterList 是false ，则为语法错误。 -
如果
FormalParameters 的BoundNames 的任何元素也出现在FunctionBody 的LexicallyDeclaredNames 中，则为语法错误。 -
如果
FormalParameters Contains SuperProperty 是true ，则为语法错误。 -
如果
FunctionBody Contains SuperProperty 是true ，则为语法错误。 -
如果
FormalParameters Contains SuperCall 是true ，则为语法错误。 -
如果
FunctionBody Contains SuperCall 是true ，则为语法错误。
-
如果
FunctionStatementList 的LexicallyDeclaredNames 包含 任何重复项，则为语法错误。 -
如果
FunctionStatementList 的LexicallyDeclaredNames 的任何元素也出现在FunctionStatementList 的VarDeclaredNames 中，则为语法错误。 -
如果以 « » 为实参执行
FunctionStatementList 的ContainsDuplicateLabels 是true ，则为语法错误。 -
如果以 « » 为实参执行
FunctionStatementList 的ContainsUndefinedBreakTarget 是true ，则为语法错误。 -
如果以 « » 和 « » 为实参执行
FunctionStatementList 的ContainsUndefinedContinueTarget 是true ，则为语法错误。
15.2.2 Static Semantics: FunctionBodyContainsUseStrict
The syntax-directed operation FunctionBodyContainsUseStrict takes no arguments and returns a Boolean. It is defined piecewise over the following productions:
- 如果
FunctionBody 的Directive Prologue 包含 Use Strict Directive ，则返回true 。 - 返回
false 。
15.2.3 Runtime Semantics: EvaluateFunctionBody
The syntax-directed operation EvaluateFunctionBody takes arguments funcObj (an ECMAScript function object) and argList (a
- 执行 ?
FunctionDeclarationInstantiation (funcObj, argList)。 - 执行 ?
FunctionStatementList 的Evaluation 。 - 注：如果前一步产生了 normal completion，则求值是通过越过
FunctionStatementList 末尾而完成的。 - 返回
ReturnCompletion (undefined )。
15.2.4 Runtime Semantics: InstantiateOrdinaryFunctionObject
The syntax-directed operation InstantiateOrdinaryFunctionObject takes arguments envRecord (an
- 令 name 为
BindingIdentifier 的StringValue 。 - 令 sourceText 为由
FunctionDeclaration 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText,FormalParameters ,FunctionBody ,non-lexical-this , envRecord, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 执行
MakeConstructor (closure)。 - 返回 closure。
- 令 sourceText 为由
FunctionDeclaration 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText,FormalParameters ,FunctionBody ,non-lexical-this , envRecord, privateEnv)。 - 执行
SetFunctionName (closure,"default" )。 - 执行
MakeConstructor (closure)。 - 返回 closure。
匿名 export default 声明的一部分出现，因此其函数代码始终是严格模式代码。
15.2.5 Runtime Semantics: InstantiateOrdinaryFunctionExpression
The syntax-directed operation InstantiateOrdinaryFunctionExpression takes optional argument name (a property key or a
- 如果 name 不存在，则将 name 设置为空 String。
- 令 envRecord 为运行中的执行上下文的 LexicalEnvironment。
- 令 privateEnv 为运行中的执行上下文的 PrivateEnvironment。
- 令 sourceText 为由
FunctionExpression 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText,FormalParameters ,FunctionBody ,non-lexical-this , envRecord, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 执行
MakeConstructor (closure)。 - 返回 closure。
- 断言：name 不存在。
- 将 name 设置为
BindingIdentifier 的StringValue 。 - 令 outerEnv 为运行中的执行上下文的 LexicalEnvironment。
- 令 funcEnv 为
NewDeclarativeEnvironment (outerEnv)。 - 执行 ! funcEnv.
CreateImmutableBinding (name,false )。 - 令 privateEnv 为运行中的执行上下文的 PrivateEnvironment。
- 令 sourceText 为由
FunctionExpression 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText,FormalParameters ,FunctionBody ,non-lexical-this , funcEnv, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 执行
MakeConstructor (closure)。 - 执行 ! funcEnv.
InitializeBinding (name, closure)。 - 返回 closure。
15.2.6 Runtime Semantics: Evaluation
- 返回
empty 。
在
- 返回
empty 。
对于使用
- 返回
undefined 。
- 令 result 为
StatementList 的求值的Completion 。 - 令 env 为运行中执行上下文的 LexicalEnvironment。
- 断言：env 是声明式环境记录。
- 返回 ?
DisposeResources (env.[[DisposableResourceStack]], result)。
15.3 箭头函数定义
语法
补充语法
当处理产生式的实例
时，使用以下语法细化
15.3.1 Static Semantics: 早期错误
-
如果
ArrowParameters Contains YieldExpression 是true ，则为语法错误。 -
如果
ArrowParameters Contains AwaitExpression 是true ，则为语法错误。 -
如果
ConciseBody 的ConciseBodyContainsUseStrict 是true ，且ArrowParameters 的IsSimpleParameterList 是false ，则为语法错误。 -
如果
ArrowParameters 的BoundNames 的任何元素也出现在ConciseBody 的LexicallyDeclaredNames 中，则为语法错误。
15.3.2 Static Semantics: ConciseBodyContainsUseStrict
The syntax-directed operation ConciseBodyContainsUseStrict takes no arguments and returns a Boolean. It is defined piecewise over the following productions:
- 返回
false 。
15.3.3 Runtime Semantics: EvaluateConciseBody
The syntax-directed operation EvaluateConciseBody takes arguments funcObj (an ECMAScript function object) and argList (a
- 执行 ?
FunctionDeclarationInstantiation (funcObj, argList)。 - 返回 ?
ExpressionBody 的Evaluation 。
15.3.4 Runtime Semantics: InstantiateArrowFunctionExpression
The syntax-directed operation InstantiateArrowFunctionExpression takes optional argument name (a property key or a
- 如果 name 不存在，则将 name 设置为空 String。
- 令 envRecord 为运行中的执行上下文的 LexicalEnvironment。
- 令 privateEnv 为运行中的执行上下文的 PrivateEnvironment。
- 令 sourceText 为由
ArrowFunction 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText,ArrowParameters ,ConciseBody ,lexical-this , envRecord, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 返回 closure。
arguments、super、this 或 new.target 定义局部绑定。arguments、super、this 或 new.target 的任何引用，都必须解析到词法外层环境中的绑定。通常，这会是紧邻外层函数的 Function Environment。即使 super 的引用，步骤 super 的 super 所必需的状态可通过
15.3.5 Runtime Semantics: Evaluation
- 令 exprRef 为 ?
AssignmentExpression 的Evaluation 。 - 令 exprValue 为 ?
GetValue (exprRef)。 - 返回
ReturnCompletion (exprValue)。
15.4 方法定义
语法
15.4.1 Static Semantics: 早期错误
-
如果
FunctionBody 的FunctionBodyContainsUseStrict 是true ，且UniqueFormalParameters 的IsSimpleParameterList 是false ，则为语法错误。 -
如果
UniqueFormalParameters 的BoundNames 的任何元素也出现在FunctionBody 的LexicallyDeclaredNames 中，则为语法错误。
-
如果
PropertySetParameterList 的BoundNames 包含 任何重复元素，则为语法错误。 -
如果
FunctionBody 的FunctionBodyContainsUseStrict 是true ，且PropertySetParameterList 的IsSimpleParameterList 是false ，则为语法错误。 -
如果
PropertySetParameterList 的BoundNames 的任何元素也出现在FunctionBody 的LexicallyDeclaredNames 中，则为语法错误。
15.4.2 Static Semantics: HasDirectSuper
The syntax-directed operation HasDirectSuper takes no arguments and returns a Boolean. It is defined piecewise over the following productions:
- 如果
UniqueFormalParameters Contains SuperCall 是true ，则返回true 。 - 返回
FunctionBody Contains SuperCall 。
- 如果
PropertySetParameterList Contains SuperCall 是true ，则返回true 。 - 返回
FunctionBody Contains SuperCall 。
- 如果
UniqueFormalParameters Contains SuperCall 是true ，则返回true 。 - 返回
GeneratorBody Contains SuperCall 。
- 如果
UniqueFormalParameters Contains SuperCall 是true ，则返回true 。 - 返回
AsyncGeneratorBody Contains SuperCall 。
- 如果
UniqueFormalParameters Contains SuperCall 是true ，则返回true 。 - 返回
AsyncFunctionBody Contains SuperCall 。
15.4.3 Static Semantics: SpecialMethod
The syntax-directed operation SpecialMethod takes no arguments and returns a Boolean. It is defined piecewise over the following productions:
- 返回
false 。
- 返回
true 。
15.4.4 Runtime Semantics: DefineMethod
The syntax-directed operation DefineMethod takes argument obj (an Object) and optional argument proto (an Object) and returns either a normal completion containing a
- 令 propertyKey 为 ?
ClassElementName 的Evaluation 。 - 令 envRecord 为运行中的执行上下文的 LexicalEnvironment。
- 令 privateEnv 为运行中的执行上下文的 PrivateEnvironment。
- 如果 proto 不存在，则将 proto 设置为
%Function.prototype% 。 - 令 sourceText 为由
MethodDefinition 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (proto, sourceText,UniqueFormalParameters ,FunctionBody ,non-lexical-this , envRecord, privateEnv)。 - 执行
MakeMethod (closure, obj)。 - 返回
Record { [[Key]]: propertyKey, [[Closure]]: closure }。
15.4.5 Runtime Semantics: MethodDefinitionEvaluation
The syntax-directed operation MethodDefinitionEvaluation takes arguments obj (an Object) and enumerable (a Boolean) and returns either a normal completion containing either a
- 令 methodDef 为 ? 以 obj 为实参执行
MethodDefinition 的DefineMethod 。 - 执行
SetFunctionName (methodDef.[[Closure]], methodDef.[[Key]])。 - 返回 ?
DefineMethodProperty (obj, methodDef.[[Key]], methodDef.[[Closure]], enumerable)。
- 令 propertyKey 为 ?
ClassElementName 的Evaluation 。 - 令 envRecord 为运行中的执行上下文的 LexicalEnvironment。
- 令 privateEnv 为运行中的执行上下文的 PrivateEnvironment。
- 令 sourceText 为由
MethodDefinition 匹配的源文本 。 - 令 formalParamList 为产生式
FormalParameters : [empty] - 令 closure 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText, formalParamList,FunctionBody ,non-lexical-this , envRecord, privateEnv)。 - 执行
MakeMethod (closure, obj)。 - 执行
SetFunctionName (closure, propertyKey,"get" )。 - 如果 propertyKey 是
Private Name ，则- 返回
PrivateElement { [[Key]]: propertyKey, [[Kind]]:accessor , [[Get]]: closure, [[Set]]:undefined }。
- 返回
- 令 propertyDesc 为 PropertyDescriptor { [[Get]]: closure, [[Enumerable]]: enumerable, [[Configurable]]:
true }。 - 执行 ?
DefinePropertyOrThrow (obj, propertyKey, propertyDesc)。 - 返回
unused 。
- 令 propertyKey 为 ?
ClassElementName 的Evaluation 。 - 令 envRecord 为运行中的执行上下文的 LexicalEnvironment。
- 令 privateEnv 为运行中的执行上下文的 PrivateEnvironment。
- 令 sourceText 为由
MethodDefinition 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText,PropertySetParameterList ,FunctionBody ,non-lexical-this , envRecord, privateEnv)。 - 执行
MakeMethod (closure, obj)。 - 执行
SetFunctionName (closure, propertyKey,"set" )。 - 如果 propertyKey 是
Private Name ，则- 返回
PrivateElement { [[Key]]: propertyKey, [[Kind]]:accessor , [[Get]]:undefined , [[Set]]: closure }。
- 返回
- 令 propertyDesc 为 PropertyDescriptor { [[Set]]: closure, [[Enumerable]]: enumerable, [[Configurable]]:
true }。 - 执行 ?
DefinePropertyOrThrow (obj, propertyKey, propertyDesc)。 - 返回
unused 。
- 令 propertyKey 为 ?
ClassElementName 的Evaluation 。 - 令 envRecord 为运行中的执行上下文的 LexicalEnvironment。
- 令 privateEnv 为运行中的执行上下文的 PrivateEnvironment。
- 令 sourceText 为由
GeneratorMethod 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,UniqueFormalParameters ,GeneratorBody ,non-lexical-this , envRecord, privateEnv)。 - 执行
MakeMethod (closure, obj)。 - 执行
SetFunctionName (closure, propertyKey)。 - 令 proto 为
OrdinaryObjectCreate (%GeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: proto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 ?
DefineMethodProperty (obj, propertyKey, closure, enumerable)。
- 令 propertyKey 为 ?
ClassElementName 的Evaluation 。 - 令 envRecord 为运行中的执行上下文的 LexicalEnvironment。
- 令 privateEnv 为运行中的执行上下文的 PrivateEnvironment。
- 令 sourceText 为由
AsyncGeneratorMethod 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,UniqueFormalParameters ,AsyncGeneratorBody ,non-lexical-this , envRecord, privateEnv)。 - 执行
MakeMethod (closure, obj)。 - 执行
SetFunctionName (closure, propertyKey)。 - 令 proto 为
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: proto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 ?
DefineMethodProperty (obj, propertyKey, closure, enumerable)。
- 令 propertyKey 为 ?
ClassElementName 的Evaluation 。 - 令 envRecord 为运行中的执行上下文的 LexicalEnvironment。
- 令 privateEnv 为运行中的执行上下文的 PrivateEnvironment。
- 令 sourceText 为由
AsyncMethod 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,UniqueFormalParameters ,AsyncFunctionBody ,non-lexical-this , envRecord, privateEnv)。 - 执行
MakeMethod (closure, obj)。 - 执行
SetFunctionName (closure, propertyKey)。 - 返回 ?
DefineMethodProperty (obj, propertyKey, closure, enumerable)。
15.5 生成器函数定义
语法
紧跟在 yield 之后的句法上下文需要使用
15.5.1 Static Semantics: 早期错误
-
如果
GeneratorMethod 的HasDirectSuper 是true ，则为语法错误。 -
如果
UniqueFormalParameters Contains YieldExpression 是true ，则为语法错误。 -
如果
GeneratorBody 的FunctionBodyContainsUseStrict 是true ，且UniqueFormalParameters 的IsSimpleParameterList 是false ，则为语法错误。 -
如果
UniqueFormalParameters 的BoundNames 的任何元素也出现在GeneratorBody 的LexicallyDeclaredNames 中，则为语法错误。
-
如果
IsStrict (FormalParameters ) 是true ，则应用UniqueFormalParameters : FormalParameters 早期错误 规则。 -
如果存在
BindingIdentifier 且IsStrict (BindingIdentifier ) 是true ，并且BindingIdentifier 的StringValue 是"eval" 或"arguments" ，则为语法错误。 -
如果
GeneratorBody 的FunctionBodyContainsUseStrict 是true ，且FormalParameters 的IsSimpleParameterList 是false ，则为语法错误。 -
如果
FormalParameters 的BoundNames 的任何元素也出现在GeneratorBody 的LexicallyDeclaredNames 中，则为语法错误。 -
如果
FormalParameters Contains YieldExpression 是true ，则为语法错误。 -
如果
FormalParameters Contains SuperProperty 是true ，则为语法错误。 -
如果
GeneratorBody Contains SuperProperty 是true ，则为语法错误。 -
如果
FormalParameters Contains SuperCall 是true ，则为语法错误。 -
如果
GeneratorBody Contains SuperCall 是true ，则为语法错误。
15.5.2 Runtime Semantics: EvaluateGeneratorBody
The syntax-directed operation EvaluateGeneratorBody takes arguments funcObj (an ECMAScript function object) and argList (a
- 执行 ?
FunctionDeclarationInstantiation (funcObj, argList)。 - 令 gen 为 ?
OrdinaryCreateFromConstructor (funcObj,"%GeneratorPrototype%" , « [[GeneratorState]], [[GeneratorContext]], [[GeneratorBrand]] »)。 - 将 gen.[[GeneratorBrand]] 设置为
empty 。 - 将 gen.[[GeneratorState]] 设置为
suspended-start 。 - 执行
GeneratorStart (gen,FunctionBody )。 - 返回
ReturnCompletion (gen)。
15.5.3 Runtime Semantics: InstantiateGeneratorFunctionObject
The syntax-directed operation InstantiateGeneratorFunctionObject takes arguments envRecord (an
- 令 name 为
BindingIdentifier 的StringValue 。 - 令 sourceText 为由
GeneratorDeclaration 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,FormalParameters ,GeneratorBody ,non-lexical-this , envRecord, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 令 proto 为
OrdinaryObjectCreate (%GeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: proto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 closure。
- 令 sourceText 为由
GeneratorDeclaration 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,FormalParameters ,GeneratorBody ,non-lexical-this , envRecord, privateEnv)。 - 执行
SetFunctionName (closure,"default" )。 - 令 proto 为
OrdinaryObjectCreate (%GeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: proto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 closure。
匿名 export default 声明的一部分出现，因此其函数代码始终是严格模式代码。
15.5.4 Runtime Semantics: InstantiateGeneratorFunctionExpression
The syntax-directed operation InstantiateGeneratorFunctionExpression takes optional argument name (a property key or a
- 如果 name 不存在，则将 name 设置为空 String。
- 令 envRecord 为运行中的执行上下文的 LexicalEnvironment。
- 令 privateEnv 为运行中的执行上下文的 PrivateEnvironment。
- 令 sourceText 为由
GeneratorExpression 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,FormalParameters ,GeneratorBody ,non-lexical-this , envRecord, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 令 proto 为
OrdinaryObjectCreate (%GeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: proto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 closure。
- 断言：name 不存在。
- 将 name 设置为
BindingIdentifier 的StringValue 。 - 令 outerEnv 为运行中的执行上下文的 LexicalEnvironment。
- 令 funcEnv 为
NewDeclarativeEnvironment (outerEnv)。 - 执行 ! funcEnv.
CreateImmutableBinding (name,false )。 - 令 privateEnv 为运行中的执行上下文的 PrivateEnvironment。
- 令 sourceText 为由
GeneratorExpression 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,FormalParameters ,GeneratorBody ,non-lexical-this , funcEnv, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 令 proto 为
OrdinaryObjectCreate (%GeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: proto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 执行 ! funcEnv.
InitializeBinding (name, closure)。 - 返回 closure。
15.5.5 Runtime Semantics: Evaluation
- 返回 ?
Yield (undefined )。
- 令 exprRef 为 ?
AssignmentExpression 的Evaluation 。 - 令 value 为 ?
GetValue (exprRef)。 - 返回 ?
Yield (value)。
- 令 genKind 为
GetGeneratorKind ()。 - 断言：genKind 是
sync 或async 。 - 令 exprRef 为 ?
AssignmentExpression 的Evaluation 。 - 令 value 为 ?
GetValue (exprRef)。 - 令 iteratorRecord 为 ?
GetIterator (value, genKind)。 - 令 iterator 为 iteratorRecord.[[Iterator]]。
- 令 received 为
NormalCompletion (undefined )。 - 重复：
- 如果 received 是 normal completion，则
- 令 innerResult 为 ?
Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]], « received.[[Value]] »)。 - 如果 genKind 是
async ，则将 innerResult 设置为 ?Await (innerResult)。 - 如果 innerResult 不是 Object，则抛出
TypeError 异常。 - 令 done 为 ?
IteratorComplete (innerResult)。 - 如果 done 是
true ，则- 返回 ?
IteratorValue (innerResult)。
- 返回 ?
- 如果 genKind 是
async ，则将 received 设置为Completion (AsyncGeneratorYield (?IteratorValue (innerResult)))。 - 否则，将 received 设置为
Completion (GeneratorYield (innerResult))。
- 令 innerResult 为 ?
- 否则如果 received 是 throw completion，则
- 令 throw 为 ?
GetMethod (iterator,"throw" )。 - 如果 throw 不是
undefined ，则- 令 innerResult 为 ?
Call (throw, iterator, « received.[[Value]] »)。 - 如果 genKind 是
async ，则将 innerResult 设置为 ?Await (innerResult)。 - 注：来自内部迭代器
throw方法的异常会被传播。来自内部throw方法的 normal completion 会以类似于内部next的方式处理。 - 如果 innerResult 不是 Object，则抛出
TypeError 异常。 - 令 done 为 ?
IteratorComplete (innerResult)。 - 如果 done 是
true ，则- 返回 ?
IteratorValue (innerResult)。
- 返回 ?
- 如果 genKind 是
async ，则将 received 设置为Completion (AsyncGeneratorYield (?IteratorValue (innerResult)))。 - 否则，将 received 设置为
Completion (GeneratorYield (innerResult))。
- 令 innerResult 为 ?
- 否则，
- 注：如果 iterator 没有
throw方法，这个 throw 将会终止yield*循环。但首先我们需要给 iterator 一个清理的机会。 - 令 closeCompletion 为
NormalCompletion (empty )。 - 如果 genKind 是
async ，则执行 ?AsyncIteratorClose (iteratorRecord, closeCompletion)。 - 否则，执行 ?
IteratorClose (iteratorRecord, closeCompletion)。 - 注：下一步会抛出
TypeError ，以表明存在yield*协议违规：iterator 没有throw方法。 - 抛出
TypeError 异常。
- 注：如果 iterator 没有
- 令 throw 为 ?
- 否则，
- 断言：received 是 return completion。
- 令 return 为 ?
GetMethod (iterator,"return" )。 - 如果 return 是
undefined ，则- 令 receivedValue 为 received.[[Value]]。
- 如果 genKind 是
async ，则- 将 receivedValue 设置为 ?
Await (receivedValue)。
- 将 receivedValue 设置为 ?
- 返回
ReturnCompletion (receivedValue)。
- 令 innerReturnResult 为 ?
Call (return, iterator, « received.[[Value]] »)。 - 如果 genKind 是
async ，则将 innerReturnResult 设置为 ?Await (innerReturnResult)。 - 如果 innerReturnResult 不是 Object，则抛出
TypeError 异常。 - 令 done 为 ?
IteratorComplete (innerReturnResult)。 - 如果 done 是
true ，则- 令 returnedValue 为 ?
IteratorValue (innerReturnResult)。 - 返回
ReturnCompletion (returnedValue)。
- 令 returnedValue 为 ?
- 如果 genKind 是
async ，则将 received 设置为Completion (AsyncGeneratorYield (?IteratorValue (innerReturnResult)))。 - 否则，将 received 设置为
Completion (GeneratorYield (innerReturnResult))。
- 如果 received 是 normal completion，则
15.6 异步生成器函数定义
语法
15.6.1 Static Semantics: 早期错误
- 如果
AsyncGeneratorMethod 的HasDirectSuper 是true ，则为语法错误。 - 如果
UniqueFormalParameters Contains YieldExpression 是true ，则为语法错误。 - 如果
UniqueFormalParameters Contains AwaitExpression 是true ，则为语法错误。 - 如果
AsyncGeneratorBody 的FunctionBodyContainsUseStrict 是true ，且UniqueFormalParameters 的IsSimpleParameterList 是false ，则为语法错误。 - 如果
UniqueFormalParameters 的BoundNames 的任何元素也出现在AsyncGeneratorBody 的LexicallyDeclaredNames 中，则为语法错误。
- 如果
IsStrict (FormalParameters ) 是true ，则应用UniqueFormalParameters : FormalParameters 早期错误 规则。 - 如果存在
BindingIdentifier 且IsStrict (BindingIdentifier ) 是true ，并且BindingIdentifier 的StringValue 是"eval" 或"arguments" ，则为语法错误。 - 如果
AsyncGeneratorBody 的FunctionBodyContainsUseStrict 是true ，且FormalParameters 的IsSimpleParameterList 是false ，则为语法错误。 - 如果
FormalParameters 的BoundNames 的任何元素也出现在AsyncGeneratorBody 的LexicallyDeclaredNames 中，则为语法错误。 - 如果
FormalParameters Contains YieldExpression 是true ，则为语法错误。 - 如果
FormalParameters Contains AwaitExpression 是true ，则为语法错误。 - 如果
FormalParameters Contains SuperProperty 是true ，则为语法错误。 - 如果
AsyncGeneratorBody Contains SuperProperty 是true ，则为语法错误。 - 如果
FormalParameters Contains SuperCall 是true ，则为语法错误。 - 如果
AsyncGeneratorBody Contains SuperCall 是true ，则为语法错误。
15.6.2 Runtime Semantics: EvaluateAsyncGeneratorBody
The syntax-directed operation EvaluateAsyncGeneratorBody takes arguments funcObj (an ECMAScript function object) and argList (a
- 执行 ?
FunctionDeclarationInstantiation (funcObj, argList)。 - 令 gen 为 ?
OrdinaryCreateFromConstructor (funcObj,"%AsyncGeneratorPrototype%" , « [[AsyncGeneratorState]], [[AsyncGeneratorContext]], [[AsyncGeneratorQueue]], [[GeneratorBrand]] »)。 - 将 gen.[[GeneratorBrand]] 设置为
empty 。 - 将 gen.[[AsyncGeneratorState]] 设置为
suspended-start 。 - 执行
AsyncGeneratorStart (gen,FunctionBody )。 - 返回
ReturnCompletion (gen)。
15.6.3 Runtime Semantics: InstantiateAsyncGeneratorFunctionObject
The syntax-directed operation InstantiateAsyncGeneratorFunctionObject takes arguments envRecord (an
- 令 name 为
BindingIdentifier 的StringValue 。 - 令 sourceText 为由
AsyncGeneratorDeclaration 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,FormalParameters ,AsyncGeneratorBody ,non-lexical-this , envRecord, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 令 proto 为
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: proto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 closure。
- 令 sourceText 为由
AsyncGeneratorDeclaration 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,FormalParameters ,AsyncGeneratorBody ,non-lexical-this , envRecord, privateEnv)。 - 执行
SetFunctionName (closure,"default" )。 - 令 proto 为
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: proto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 closure。
匿名 export default 声明的一部分出现。
15.6.4 Runtime Semantics: InstantiateAsyncGeneratorFunctionExpression
The syntax-directed operation InstantiateAsyncGeneratorFunctionExpression takes optional argument name (a property key or a
- 如果 name 不存在，则将 name 设置为空 String。
- 令 envRecord 为运行中的执行上下文的 LexicalEnvironment。
- 令 privateEnv 为运行中的执行上下文的 PrivateEnvironment。
- 令 sourceText 为由
AsyncGeneratorExpression 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,FormalParameters ,AsyncGeneratorBody ,non-lexical-this , envRecord, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 令 proto 为
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: proto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 closure。
- 断言：name 不存在。
- 将 name 设置为
BindingIdentifier 的StringValue 。 - 令 outerEnv 为运行中的执行上下文的 LexicalEnvironment。
- 令 funcEnv 为
NewDeclarativeEnvironment (outerEnv)。 - 执行 ! funcEnv.
CreateImmutableBinding (name,false )。 - 令 privateEnv 为运行中的执行上下文的 PrivateEnvironment。
- 令 sourceText 为由
AsyncGeneratorExpression 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,FormalParameters ,AsyncGeneratorBody ,non-lexical-this , funcEnv, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 令 proto 为
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: proto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 执行 ! funcEnv.
InitializeBinding (name, closure)。 - 返回 closure。
15.6.5 Runtime Semantics: Evaluation
15.7 类定义
语法
类定义始终是严格模式代码。
15.7.1 Static Semantics: 早期错误
-
如果不存在
ClassHeritage ，且以下算法返回true ，则为语法错误：- 令 ctor 为
ClassBody 的ConstructorMethod 。 - 如果 ctor 是
empty ，则返回false 。 - 返回 ctor 的
HasDirectSuper 。
- 令 ctor 为
-
如果
ClassElementList 的PrototypePropertyNameList 包含 超过一次"constructor" ，则为语法错误。 -
如果
ClassElementList 的PrivateBoundIdentifiers 包含 任何重复项，则为语法错误，除非该名称一次用于 getter 且一次用于 setter，并且没有用于其他条目，而且 getter 和 setter 要么都是 static，要么都不是 static。
-
如果
MethodDefinition 的PropName 不是"constructor" ，且MethodDefinition 的HasDirectSuper 是true ，则为语法错误。 -
如果
MethodDefinition 的PropName 是"constructor" ，且MethodDefinition 的SpecialMethod 是true ，则为语法错误。
-
如果
MethodDefinition 的HasDirectSuper 是true ，则为语法错误。 -
如果
MethodDefinition 的PropName 是"prototype" ，则为语法错误。
- 如果
FieldDefinition 的PropName 是"constructor" ，则为语法错误。
-
如果
FieldDefinition 的PropName 是"prototype" 或"constructor" ，则为语法错误。
- 如果存在
Initializer 且Initializer 的ContainsArguments 是true ，则为语法错误。 - 如果存在
Initializer 且Initializer Contains SuperCall 是true ，则为语法错误。
- 如果
PrivateIdentifier 的StringValue 是"#constructor" ，则为语法错误。
-
如果
ClassStaticBlockStatementList 的LexicallyDeclaredNames 包含 任何重复项，则为语法错误。 -
如果
ClassStaticBlockStatementList 的LexicallyDeclaredNames 的任何元素也出现在ClassStaticBlockStatementList 的VarDeclaredNames 中，则为语法错误。 -
如果以 « » 为实参执行
ClassStaticBlockStatementList 的ContainsDuplicateLabels 是true ，则为语法错误。 -
如果以 « » 为实参执行
ClassStaticBlockStatementList 的ContainsUndefinedBreakTarget 是true ，则为语法错误。 -
如果以 « » 和 « » 为实参执行
ClassStaticBlockStatementList 的ContainsUndefinedContinueTarget 是true ，则为语法错误。 -
如果
ClassStaticBlockStatementList 的ContainsArguments 是true ，则为语法错误。 -
如果
ClassStaticBlockStatementList Contains SuperCall 是true ，则为语法错误。 -
如果
ClassStaticBlockStatementList Contains await是true ，则为语法错误。
15.7.2 Static Semantics: ClassElementKind
The syntax-directed operation ClassElementKind takes no arguments and returns
- 如果
MethodDefinition 的PropName 是"constructor" ，则返回constructor-method 。 - 返回
non-constructor-method 。
- 返回
non-constructor-method 。
- 返回
non-constructor-method 。
- 返回
empty 。
15.7.3 Static Semantics: ConstructorMethod
The syntax-directed operation ConstructorMethod takes no arguments and returns a
- 如果
ClassElement 的ClassElementKind 是constructor-method ，则返回ClassElement 。 - 返回
empty 。
- 令 head 为
ClassElementList 的ConstructorMethod 。 - 如果 head 不是
empty ，则返回 head。 - 如果
ClassElement 的ClassElementKind 是constructor-method ，则返回ClassElement 。 - 返回
empty 。
15.7.4 Static Semantics: IsStatic
The syntax-directed operation IsStatic takes no arguments and returns a Boolean. It is defined piecewise over the following productions:
- 返回
false 。
- 返回
true 。
- 返回
false 。
- 返回
true 。
- 返回
true 。
- 返回
false 。
15.7.5 Static Semantics: NonConstructorElements
The syntax-directed operation NonConstructorElements takes no arguments and returns a
- 如果
ClassElement 的ClassElementKind 是non-constructor-method ，则- 返回 «
ClassElement »。
- 返回 «
- 返回新的空
List 。
- 令 list 为
ClassElementList 的NonConstructorElements 。 - 如果
ClassElement 的ClassElementKind 是non-constructor-method ，则- 将
ClassElement 追加到 list。
- 将
- 返回 list。
15.7.6 Static Semantics: PrototypePropertyNameList
The syntax-directed operation PrototypePropertyNameList takes no arguments and returns a
- 令 propertyName 为
ClassElement 的PropName 。 - 如果 propertyName 是
empty ，则返回新的空List 。 - 如果
ClassElement 的IsStatic 是true ，则返回新的空List 。 - 返回 « propertyName »。
- 令 list 为
ClassElementList 的PrototypePropertyNameList 。 - 令 propertyName 为
ClassElement 的PropName 。 - 如果 propertyName 是
empty ，则返回 list。 - 如果
ClassElement 的IsStatic 是true ，则返回 list。 - 返回 list 和 « propertyName » 的
列表连接 。
15.7.7 Static Semantics: AllPrivateIdentifiersValid
The syntax-directed operation AllPrivateIdentifiersValid takes argument names (a
本规范中未在下面列出的每个语法产生式替代项，都隐式具有以下 AllPrivateIdentifiersValid 的默认定义：
- 对此
Parse Node 的每个子节点 child，执行：- 如果 child 是一个非终结符的实例，则
- 如果以 names 为实参执行 child 的
AllPrivateIdentifiersValid 是false ，则返回false 。
- 如果以 names 为实参执行 child 的
- 如果 child 是一个非终结符的实例，则
- 返回
true 。
- 如果 names
包含 PrivateIdentifier 的StringValue ，则- 返回以 names 为实参执行
MemberExpression 的AllPrivateIdentifiersValid 。
- 返回以 names 为实参执行
- 返回
false 。
- 如果 names
包含 PrivateIdentifier 的StringValue ，则- 返回以 names 为实参执行
CallExpression 的AllPrivateIdentifiersValid 。
- 返回以 names 为实参执行
- 返回
false 。
- 如果 names
包含 PrivateIdentifier 的StringValue ，则返回true 。 - 返回
false 。
- 如果 names
包含 PrivateIdentifier 的StringValue ，则- 返回以 names 为实参执行
OptionalChain 的AllPrivateIdentifiersValid 。
- 返回以 names 为实参执行
- 返回
false 。
- 令 newNames 为 names 和
ClassBody 的PrivateBoundIdentifiers 的列表连接 。 - 返回以 newNames 为实参执行
ClassElementList 的AllPrivateIdentifiersValid 。
- 如果 names
包含 PrivateIdentifier 的StringValue ，则- 返回以 names 为实参执行
ShiftExpression 的AllPrivateIdentifiersValid 。
- 返回以 names 为实参执行
- 返回
false 。
15.7.8 Static Semantics: PrivateBoundIdentifiers
The syntax-directed operation PrivateBoundIdentifiers takes no arguments and returns a
- 返回一个
List ，其唯一元素为PrivateIdentifier 的StringValue 。
- 返回新的空
List 。
- 令 names1 为
ClassElementList 的PrivateBoundIdentifiers 。 - 令 names2 为
ClassElement 的PrivateBoundIdentifiers 。 - 返回 names1 和 names2 的
列表连接 。
15.7.9 Static Semantics: ContainsArguments
The syntax-directed operation ContainsArguments takes no arguments and returns a Boolean.
本规范中未在下面列出的每个语法产生式替代项，都隐式具有以下 ContainsArguments 的默认定义：
- 对此
Parse Node 的每个子节点 child，执行：- 如果 child 是一个非终结符的实例，则
- 如果 child 的
ContainsArguments 是true ，则返回true 。
- 如果 child 的
- 如果 child 是一个非终结符的实例，则
- 返回
false 。
- 如果
Identifier 的StringValue 是"arguments" ，则返回true 。 - 返回
false 。
- 返回
false 。
15.7.10 Runtime Semantics: ClassFieldDefinitionEvaluation
The syntax-directed operation ClassFieldDefinitionEvaluation takes argument homeObj (an Object) and returns either a normal completion containing a
- 令 name 为 ?
ClassElementName 的Evaluation 。 - 如果存在
Initializer ，则- 令 formalParamList 为产生式
FormalParameters : [empty] - 令 envRecord 为运行中的执行上下文的 LexicalEnvironment。
- 令 privateEnv 为运行中的执行上下文的 PrivateEnvironment。
- 令 sourceText 为空的 Unicode 码点序列。
- 令 initializer 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText, formalParamList,Initializer ,non-lexical-this , envRecord, privateEnv)。 - 执行
MakeMethod (initializer, homeObj)。 - 将 initializer.[[ClassFieldInitializerName]] 设置为 name。
- 令 formalParamList 为产生式
- 否则，
- 令 initializer 为
empty 。
- 令 initializer 为
- 返回
ClassFieldDefinition Record { [[Name]]: name, [[Initializer]]: initializer }。
15.7.11 Runtime Semantics: ClassStaticBlockDefinitionEvaluation
The syntax-directed operation ClassStaticBlockDefinitionEvaluation takes argument homeObj (an Object) and returns a
- 令 lexicalEnv 为正在运行的执行上下文的 LexicalEnvironment。
- 令 privateEnv 为正在运行的执行上下文的 PrivateEnvironment。
- 令 sourceText 为空的 Unicode 码点序列。
- 令 formalParams 为产生式
FormalParameters : [empty] - 令 bodyFunc 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText, formalParams,ClassStaticBlockBody ,non-lexical-this , lexicalEnv, privateEnv)。 - 执行
MakeMethod (bodyFunc, homeObj)。 - 返回
ClassStaticBlockDefinition Record { [[BodyFunction]]: bodyFunc }。
15.7.12 Runtime Semantics: EvaluateClassStaticBlockBody
The syntax-directed operation EvaluateClassStaticBlockBody takes argument funcObj (an ECMAScript function object) and returns a return completion or a throw completion. It is defined piecewise over the following productions:
- 断言：funcObj 是由
ClassStaticBlockDefinitionEvaluation 步骤5 创建的合成函数。 - 执行 !
FunctionDeclarationInstantiation (funcObj, « »)。 - 令 result 为
ClassStaticBlockStatementList 的求值的Completion 。 - 令 envRecord 为运行中执行上下文的 LexicalEnvironment。
- 断言：envRecord 是声明式环境记录。
- 执行 ?
DisposeResources (envRecord.[[DisposableResourceStack]], result)。 - 返回
ReturnCompletion (undefined )。
15.7.13 Runtime Semantics: ClassElementEvaluation
The syntax-directed operation ClassElementEvaluation takes argument obj (an Object) and returns either a normal completion containing either a
- 返回 ? 以 obj 为实参执行
FieldDefinition 的ClassFieldDefinitionEvaluation 。
- 返回 ? 以 obj 和
false 为实参执行MethodDefinition 的MethodDefinitionEvaluation 。
- 返回以 obj 为实参执行
ClassStaticBlock 的ClassStaticBlockDefinitionEvaluation 。
- 返回
unused 。
15.7.14 Runtime Semantics: ClassDefinitionEvaluation
The syntax-directed operation ClassDefinitionEvaluation takes arguments classBinding (a String or
为了便于规范表述，私有方法和访问器与私有字段一起
例如，实现可以将实例私有方法直接与其对应的 this 值运行。然后，在对象上查找实例私有方法就包括检查定义该方法的类构造器是否已用于初始化该对象，然后返回与该
这不同于私有字段：由于字段初始化器可能在类实例化期间抛出异常，所以单个对象可能只具有给定类的私有字段的某个真子集，因此私有字段通常必须被单独跟踪。
It is defined piecewise over the following productions:
- 令 envRecord 为正在运行的执行上下文的 LexicalEnvironment。
- 令 classEnv 为
NewDeclarativeEnvironment (envRecord)。 - 如果 classBinding 不是
undefined ，则- 执行 ! classEnv.
CreateImmutableBinding (classBinding,true )。
- 执行 ! classEnv.
- 令 outerPrivateEnv 为正在运行的执行上下文的 PrivateEnvironment。
- 令 classPrivateEnv 为
NewPrivateEnvironment (outerPrivateEnv)。 - 如果
ClassBody 存在，则- 对
ClassBody 的PrivateBoundIdentifiers 的每个 String description，执行：- 如果 classPrivateEnv.[[Names]]
包含 一个Private Name privateName，使得 privateName.[[Description]] 是 description，则- 断言：这只可能用于 getter/setter 对。
- 否则，
- 令 name 为一个新的
Private Name ，其 [[Description]] 为 description。 - 将 name 追加到 classPrivateEnv.[[Names]]。
- 令 name 为一个新的
- 如果 classPrivateEnv.[[Names]]
- 对
- 如果
ClassHeritage 不存在，则- 令 protoParent 为
%Object.prototype% 。 - 令 ctorParent 为
%Function.prototype% 。
- 令 protoParent 为
- 否则，
- 将正在运行的执行上下文的 LexicalEnvironment 设为 classEnv。
- 注：在对
ClassHeritage 求值时，正在运行的执行上下文的 PrivateEnvironment 是 outerPrivateEnv。 - 令 superclassRef 为
ClassHeritage 的Completion (Evaluation )。 - 将正在运行的执行上下文的 LexicalEnvironment 设为 envRecord。
- 令 superclass 为 ?
GetValue (? superclassRef)。 - 如果 superclass 为
null ，则- 令 protoParent 为
null 。 - 令 ctorParent 为
%Function.prototype% 。
- 令 protoParent 为
- 否则，如果
IsConstructor (superclass) 为false ，则- 抛出一个
TypeError 异常。
- 抛出一个
- 否则，
- 令 protoParent 为 ?
Get (superclass,"prototype" )。 - 如果 protoParent 不是 Object 且 protoParent 不是
null ，则抛出一个TypeError 异常。 - 令 ctorParent 为 superclass。
- 令 protoParent 为 ?
- 令 proto 为
OrdinaryObjectCreate (protoParent)。 - 如果
ClassBody 不存在，则令 ctor 为empty 。 - 否则，令 ctor 为
ClassBody 的ConstructorMethod 。 - 将正在运行的执行上下文的 LexicalEnvironment 设为 classEnv。
- 将正在运行的执行上下文的 PrivateEnvironment 设为 classPrivateEnv。
- 如果 ctor 为
empty ，则- 令 defaultCtor 为一个新的
Abstract Closure ，它没有参数、不捕获任何内容，并在被调用时执行以下步骤：- 令 args 为由 [[Call]] 或 [[Construct]] 传递给此函数的参数
List 。 - 如果 NewTarget 为
undefined ，则抛出一个TypeError 异常。 - 令 ctorFunc 为
活动函数对象 。 - 如果 ctorFunc.[[ConstructorKind]] 为
derived ，则- 注：此分支的行为类似于
constructor(...args) { super(...args); }。最显著的区别是，虽然前述 ECMAScript 源文本可观察地调用%Array.prototype%上的%Symbol.iterator% 方法，但此函数不会。 - 令 func 为 ! ctorFunc.[[GetPrototypeOf]]()。
- 如果
IsConstructor (func) 为false ，则抛出一个TypeError 异常。 - 令 result 为 ?
Construct (func, args, NewTarget)。
- 注：此分支的行为类似于
- 否则，
- 注：此分支的行为类似于
constructor() {}。 - 令 result 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%Object.prototype%" )。
- 注：此分支的行为类似于
- 执行 ?
InitializeInstanceElements (result, ctorFunc)。 - 返回
NormalCompletion (result)。
- 令 args 为由 [[Call]] 或 [[Construct]] 传递给此函数的参数
- 令 ctorFunc 为
CreateBuiltinFunction (defaultCtor, 0, className, « [[ConstructorKind]], [[SourceText]], [[PrivateMethods]], [[Fields]] »,当前 Realm Record , ctorParent)。
- 令 defaultCtor 为一个新的
- 否则，
- 令 ctorInfo 为以 proto 和 ctorParent 为参数对 ctor 执行 !
DefineMethod 的结果。 - 令 ctorFunc 为 ctorInfo.[[Closure]]。
- 执行
MakeClassConstructor (ctorFunc)。 - 执行
SetFunctionName (ctorFunc, className)。
- 令 ctorInfo 为以 proto 和 ctorParent 为参数对 ctor 执行 !
- 将 ctorFunc.[[SourceText]] 设为 sourceText。
- 执行
MakeConstructor (ctorFunc,false , proto)。 - 如果
ClassHeritage 存在，则将 ctorFunc.[[ConstructorKind]] 设为derived 。 - 执行 !
DefineMethodProperty (proto,"constructor" , ctorFunc,false )。 - 如果
ClassBody 不存在，则令 classElements 为一个新的空List 。 - 否则，令 classElements 为
ClassBody 的NonConstructorElements 。 - 令 instancePrivateMethods 为一个新的空
List 。 - 令 staticPrivateMethods 为一个新的空
List 。 - 令 instanceFields 为一个新的空
List 。 - 令 staticElements 为一个新的空
List 。 - 对 classElements 的每个
ClassElement classElement，执行：- 如果 classElement 的
IsStatic 为false ，则- 令 element 为以 proto 为参数对 classElement 执行
ClassElementEvaluation 的Completion 。
- 令 element 为以 proto 为参数对 classElement 执行
- 否则，
- 令 element 为以 ctorFunc 为参数对 classElement 执行
ClassElementEvaluation 的Completion 。
- 令 element 为以 ctorFunc 为参数对 classElement 执行
- 如果 element 是一个
突然完成 ，则- 将正在运行的执行上下文的 LexicalEnvironment 设为 envRecord。
- 将正在运行的执行上下文的 PrivateEnvironment 设为 outerPrivateEnv。
- 返回 ? element。
- 将 element 设为 ! element。
- 如果 element 是
PrivateElement ，则- 断言：element.[[Kind]] 为
method 或accessor 。 - 如果 classElement 的
IsStatic 为false ，则令 container 为 instancePrivateMethods。 - 否则，令 container 为 staticPrivateMethods。
- 如果 container
包含 一个PrivateElement existingElement，使得 existingElement.[[Key]] 是 element.[[Key]]，则- 断言：element.[[Kind]] 和 existingElement.[[Kind]] 都为
accessor 。 - 如果 element.[[Get]] 为
undefined ，则- 令 combined 为
PrivateElement { [[Key]]: element.[[Key]], [[Kind]]:accessor , [[Get]]: existingElement.[[Get]], [[Set]]: element.[[Set]] }。
- 令 combined 为
- 否则，
- 令 combined 为
PrivateElement { [[Key]]: element.[[Key]], [[Kind]]:accessor , [[Get]]: element.[[Get]], [[Set]]: existingElement.[[Set]] }。
- 令 combined 为
- 用 combined 替换 container 中的 existingElement。
- 断言：element.[[Kind]] 和 existingElement.[[Kind]] 都为
- 否则，
- 将 element 追加到 container。
- 断言：element.[[Kind]] 为
- 否则，如果 element 是
ClassFieldDefinition Record ，则- 如果 classElement 的
IsStatic 为false ，则将 element 追加到 instanceFields。 - 否则，将 element 追加到 staticElements。
- 如果 classElement 的
- 否则，如果 element 是
ClassStaticBlockDefinition Record ，则- 将 element 追加到 staticElements。
- 如果 classElement 的
- 将正在运行的执行上下文的 LexicalEnvironment 设为 envRecord。
- 如果 classBinding 不是
undefined ，则- 执行 ! classEnv.
InitializeBinding (classBinding, ctorFunc)。
- 执行 ! classEnv.
- 将 ctorFunc.[[PrivateMethods]] 设为 instancePrivateMethods。
- 将 ctorFunc.[[Fields]] 设为 instanceFields。
- 对 staticPrivateMethods 的每个
PrivateElement method，执行：- 执行 !
PrivateMethodOrAccessorAdd (ctorFunc, method)。
- 执行 !
- 对 staticElements 的每个元素 elementRecord，执行：
- 如果 elementRecord 是
ClassFieldDefinition Record ，则- 令 result 为
Completion (DefineField (ctorFunc, elementRecord))。
- 令 result 为
- 否则，
- 断言：elementRecord 是
ClassStaticBlockDefinition Record 。 - 令 result 为
Completion (Call (elementRecord.[[BodyFunction]], ctorFunc))。
- 断言：elementRecord 是
- 如果 result 是一个
突然完成 ，则- 将正在运行的执行上下文的 PrivateEnvironment 设为 outerPrivateEnv。
- 返回 ? result。
- 如果 elementRecord 是
- 将正在运行的执行上下文的 PrivateEnvironment 设为 outerPrivateEnv。
- 返回 ctorFunc。
15.7.15 Runtime Semantics: BindingClassDeclarationEvaluation
The syntax-directed operation BindingClassDeclarationEvaluation takes no arguments and returns either a normal completion containing a function object or an abrupt completion. It is defined piecewise over the following productions:
- 令 className 为
BindingIdentifier 的StringValue 。 - 令 sourceText 为由
ClassDeclaration 匹配的源文本 。 - 令 value 为 ? 以 className、className 和 sourceText 为实参执行
ClassTail 的ClassDefinitionEvaluation 。 - 令 envRecord 为运行中的执行上下文的 LexicalEnvironment。
- 执行 ?
InitializeBoundName (className, value, envRecord)。 - 返回 value。
- 令 sourceText 为由
ClassDeclaration 匹配的源文本 。 - 返回 ? 以
undefined 、"default" 和 sourceText 为实参执行ClassTail 的ClassDefinitionEvaluation 。
15.7.16 Runtime Semantics: Evaluation
- 执行 ? 此
ClassDeclaration 的BindingClassDeclarationEvaluation 。 - 返回
empty 。
- 令 sourceText 为由
ClassExpression 匹配的源文本 。 - 返回 ? 以
undefined 、空 String 和 sourceText 为实参执行ClassTail 的ClassDefinitionEvaluation 。
- 令 className 为
BindingIdentifier 的StringValue 。 - 令 sourceText 为由
ClassExpression 匹配的源文本 。 - 返回 ? 以 className、className 和 sourceText 为实参执行
ClassTail 的ClassDefinitionEvaluation 。
- 令 privateIdentifier 为
PrivateIdentifier 的StringValue 。 - 令 privateEnvRecord 为运行中的执行上下文的 PrivateEnvironment。
- 令 names 为 privateEnvRecord.[[Names]]。
- 断言：names 中恰有一个元素是其 [[Description]] 为 privateIdentifier 的
Private Name 。 - 令 privateName 为 names 中其 [[Description]] 为 privateIdentifier 的
Private Name 。 - 返回 privateName。
- 返回
undefined 。
15.8 异步函数定义
语法
当 [Await] 参数存在时，await 会被解析为
- 在
AsyncFunctionBody 中。 - 在
AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 或AsyncGeneratorExpression 的FormalParameters 中。此位置的AwaitExpression 会通过静态语义 成为语法错误。 - 在
Module 中。
当 await 可以被解析为标识符。这包括以下上下文：
不同于
15.8.1 Static Semantics: 早期错误
- 如果
AsyncFunctionBody 的FunctionBodyContainsUseStrict 是true ，且UniqueFormalParameters 的IsSimpleParameterList 是false ，则为语法错误。 - 如果
AsyncMethod 的HasDirectSuper 是true ，则为语法错误。 - 如果
UniqueFormalParameters Contains AwaitExpression 是true ，则为语法错误。 - 如果
UniqueFormalParameters 的BoundNames 的任何元素也出现在AsyncFunctionBody 的LexicallyDeclaredNames 中，则为语法错误。
- 如果
AsyncFunctionBody 的FunctionBodyContainsUseStrict 是true ，且FormalParameters 的IsSimpleParameterList 是false ，则为语法错误。 - 如果
FormalParameters Contains AwaitExpression 是true ，则为语法错误。 - 如果
IsStrict (FormalParameters ) 是true ，则应用UniqueFormalParameters : FormalParameters 早期错误 规则。 - 如果存在
BindingIdentifier 且IsStrict (BindingIdentifier ) 是true ，并且BindingIdentifier 的StringValue 是"eval" 或"arguments" ，则为语法错误。 - 如果
FormalParameters 的BoundNames 的任何元素也出现在AsyncFunctionBody 的LexicallyDeclaredNames 中，则为语法错误。 - 如果
FormalParameters Contains SuperProperty 是true ，则为语法错误。 - 如果
AsyncFunctionBody Contains SuperProperty 是true ，则为语法错误。 - 如果
FormalParameters Contains SuperCall 是true ，则为语法错误。 - 如果
AsyncFunctionBody Contains SuperCall 是true ，则为语法错误。
15.8.2 Runtime Semantics: InstantiateAsyncFunctionObject
The syntax-directed operation InstantiateAsyncFunctionObject takes arguments envRecord (an
- 令 name 为
BindingIdentifier 的StringValue 。 - 令 sourceText 为由
AsyncFunctionDeclaration 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,FormalParameters ,AsyncFunctionBody ,non-lexical-this , envRecord, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 返回 closure。
- 令 sourceText 为由
AsyncFunctionDeclaration 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,FormalParameters ,AsyncFunctionBody ,non-lexical-this , envRecord, privateEnv)。 - 执行
SetFunctionName (closure,"default" )。 - 返回 closure。
15.8.3 Runtime Semantics: InstantiateAsyncFunctionExpression
The syntax-directed operation InstantiateAsyncFunctionExpression takes optional argument name (a property key or a
- 如果 name 不存在，则将 name 设置为空 String。
- 令 envRecord 为运行中的执行上下文的 LexicalEnvironment。
- 令 privateEnv 为运行中的执行上下文的 PrivateEnvironment。
- 令 sourceText 为由
AsyncFunctionExpression 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,FormalParameters ,AsyncFunctionBody ,non-lexical-this , envRecord, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 返回 closure。
- 断言：name 不存在。
- 将 name 设置为
BindingIdentifier 的StringValue 。 - 令 outerEnv 为运行中的执行上下文的 LexicalEnvironment。
- 令 funcEnv 为
NewDeclarativeEnvironment (outerEnv)。 - 执行 ! funcEnv.
CreateImmutableBinding (name,false )。 - 令 privateEnv 为运行中的执行上下文的 PrivateEnvironment。
- 令 sourceText 为由
AsyncFunctionExpression 匹配的源文本 。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,FormalParameters ,AsyncFunctionBody ,non-lexical-this , funcEnv, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 执行 ! funcEnv.
InitializeBinding (name, closure)。 - 返回 closure。
15.8.4 Runtime Semantics: EvaluateAsyncFunctionBody
The syntax-directed operation EvaluateAsyncFunctionBody takes arguments funcObj (an ECMAScript function object) and argList (a
- 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 completion 为
Completion (FunctionDeclarationInstantiation (funcObj, argList))。 - 如果 completion 是 abrupt completion，则
- 执行 !
Call (promiseCapability.[[Reject]],undefined , « completion.[[Value]] »)。
- 执行 !
- 否则，
- 执行
AsyncFunctionStart (promiseCapability,FunctionBody )。
- 执行
- 返回
ReturnCompletion (promiseCapability.[[Promise]])。
15.8.5 Runtime Semantics: Evaluation
- 令 expr 为
CoverAwaitExpressionAndAwaitUsingDeclarationHead 所覆盖的 AwaitExpression 。 - 返回 expr 的 ?
Evaluation 。
- 令 exprRef 为 ?
UnaryExpression 的Evaluation 。 - 令 value 为 ?
GetValue (exprRef)。 - 返回 ?
Await (value)。
15.9 异步箭头函数定义
语法
补充语法
当处理产生式的实例
时，使用以下语法细化
15.9.1 Static Semantics: 早期错误
- 如果
AsyncArrowBindingIdentifier 的BoundNames 的任何元素也出现在AsyncConciseBody 的LexicallyDeclaredNames 中，则为语法错误。
CoverCallExpressionAndAsyncArrowHead 必须覆盖一个AsyncArrowHead 。- 如果
CoverCallExpressionAndAsyncArrowHead Contains YieldExpression 是true ，则为语法错误。 - 如果
CoverCallExpressionAndAsyncArrowHead Contains AwaitExpression 是true ，则为语法错误。 - 如果
CoverCallExpressionAndAsyncArrowHead 的BoundNames 的任何元素也出现在AsyncConciseBody 的LexicallyDeclaredNames 中，则为语法错误。 - 如果
AsyncConciseBody 的AsyncConciseBodyContainsUseStrict 是true ，且CoverCallExpressionAndAsyncArrowHead 的IsSimpleParameterList 是false ，则为语法错误。
15.9.2 Static Semantics: AsyncConciseBodyContainsUseStrict
The syntax-directed operation AsyncConciseBodyContainsUseStrict takes no arguments and returns a Boolean. It is defined piecewise over the following productions:
- 返回
false 。
15.9.3 Runtime Semantics: EvaluateAsyncConciseBody
The syntax-directed operation EvaluateAsyncConciseBody takes arguments funcObj (an ECMAScript function object) and argList (a
- 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 completion 为
Completion (FunctionDeclarationInstantiation (funcObj, argList))。 - 如果 completion 是 abrupt completion，则
- 执行 !
Call (promiseCapability.[[Reject]],undefined , « completion.[[Value]] »)。
- 执行 !
- 否则，
- 执行
AsyncFunctionStart (promiseCapability,ExpressionBody )。
- 执行
- 返回
ReturnCompletion (promiseCapability.[[Promise]])。
15.9.4 Runtime Semantics: InstantiateAsyncArrowFunctionExpression
The syntax-directed operation InstantiateAsyncArrowFunctionExpression takes optional argument name (a property key or a
- 如果 name 不存在，则将 name 设置为空 String。
- 令 envRecord 为运行中的执行上下文的 LexicalEnvironment。
- 令 privateEnv 为运行中的执行上下文的 PrivateEnvironment。
- 令 sourceText 为由
AsyncArrowFunction 匹配的源文本 。 - 令 params 为
AsyncArrowBindingIdentifier 。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText, params,AsyncConciseBody ,lexical-this , envRecord, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 返回 closure。
- 如果 name 不存在，则将 name 设置为空 String。
- 令 envRecord 为运行中的执行上下文的 LexicalEnvironment。
- 令 privateEnv 为运行中的执行上下文的 PrivateEnvironment。
- 令 sourceText 为由
AsyncArrowFunction 匹配的源文本 。 - 令 head 为由
CoverCallExpressionAndAsyncArrowHead 覆盖的 AsyncArrowHead 。 - 令 params 为 head 的
ArrowFormalParameters 。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText, params,AsyncConciseBody ,lexical-this , envRecord, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 返回 closure。
15.9.5 Runtime Semantics: Evaluation
15.10 尾位置调用
15.10.1 Static Semantics: IsInTailPosition ( call )
The abstract operation IsInTailPosition takes argument call (a
- 如果
IsStrict (call) 是false ，则返回false 。 - 如果 call 未
包含 在FunctionBody 、ConciseBody 或AsyncConciseBody 中，则返回false 。 - 令 body 为最紧密
包含 call 的FunctionBody 、ConciseBody 或AsyncConciseBody 。 - 如果 body 是
GeneratorBody 的FunctionBody ，则返回false 。 - 如果 body 是
AsyncFunctionBody 的FunctionBody ，则返回false 。 - 如果 body 是
AsyncGeneratorBody 的FunctionBody ，则返回false 。 - 如果 body 是
AsyncConciseBody ，则返回false 。 - 返回以 call 为实参执行 body 的
HasCallInTailPosition 的结果。
尾位置调用只在严格模式代码中定义，这是因为一种常见的非标准语言扩展（见
15.10.2 Static Semantics: HasCallInTailPosition
The syntax-directed operation HasCallInTailPosition takes argument call (a
call 是一个解析节点，表示源文本的一个特定范围。当以下算法将 call 与另一个解析节点进行比较时，这是在测试它们是否表示同一段源文本。
紧跟着返回调用结果的
在同一个 using 声明或 await using 声明会阻止该调用成为可能的尾位置调用。
It is defined piecewise over the following productions:
- 令 has 为以 call 为参数的派生
StatementList 的HasCallInTailPosition 。 - 如果 has 是
true ，则返回true 。 - 如果派生
StatementList 的ContainsUsing 是true ，则返回false 。 - 返回以 call 为参数的
StatementListItem 的HasCallInTailPosition 。
- 返回
false 。
- 令 has 为以 call 为实参执行第一个
Statement 的HasCallInTailPosition 。 - 如果 has 是
true ，则返回true 。 - 返回以 call 为实参执行第二个
Statement 的HasCallInTailPosition 。
- 返回以 call 为实参执行
Statement 的HasCallInTailPosition 。
- 返回以 call 为实参执行
LabelledItem 的HasCallInTailPosition 。
- 返回以 call 为实参执行
Expression 的HasCallInTailPosition 。
- 返回以 call 为实参执行
CaseBlock 的HasCallInTailPosition 。
- 令 has 为
false 。 - 如果存在第一个
CaseClauses ，则将 has 设置为以 call 为实参执行第一个CaseClauses 的HasCallInTailPosition 。 - 如果 has 是
true ，则返回true 。 - 将 has 设置为以 call 为实参执行
DefaultClause 的HasCallInTailPosition 。 - 如果 has 是
true ，则返回true 。 - 如果存在第二个
CaseClauses ，则将 has 设置为以 call 为实参执行第二个CaseClauses 的HasCallInTailPosition 。 - 返回 has。
- 令 has 为以 call 为实参执行
CaseClauses 的HasCallInTailPosition 。 - 如果 has 是
true ，则返回true 。 - 返回以 call 为实参执行
CaseClause 的HasCallInTailPosition 。
- 如果存在
StatementList ，则返回以 call 为实参执行StatementList 的HasCallInTailPosition 。 - 返回
false 。
- 返回以 call 为实参执行
Catch 的HasCallInTailPosition 。
- 返回以 call 为实参执行
Finally 的HasCallInTailPosition 。
- 返回以 call 为实参执行
Block 的HasCallInTailPosition 。
- 返回
false 。
- 返回以 call 为实参执行
AssignmentExpression 的HasCallInTailPosition 。
- 令 has 为以 call 为实参执行第一个
AssignmentExpression 的HasCallInTailPosition 。 - 如果 has 是
true ，则返回true 。 - 返回以 call 为实参执行第二个
AssignmentExpression 的HasCallInTailPosition 。
- 返回以 call 为实参执行
BitwiseORExpression 的HasCallInTailPosition 。
- 返回以 call 为实参执行
LogicalANDExpression 的HasCallInTailPosition 。
- 返回以 call 为实参执行
BitwiseORExpression 的HasCallInTailPosition 。
- 如果此
CallExpression 是 call，则返回true 。 - 返回
false 。
- 返回以 call 为实参执行
OptionalChain 的HasCallInTailPosition 。
- 返回
false 。
- 如果此
OptionalChain 是 call，则返回true 。 - 返回
false 。
- 如果此
MemberExpression 是 call，则返回true 。 - 返回
false 。
- 令 expr 为由
CoverParenthesizedExpressionAndArrowParameterList 覆盖的 ParenthesizedExpression 。 - 返回以 call 为实参执行 expr 的
HasCallInTailPosition 。
- 返回以 call 为实参执行
Expression 的HasCallInTailPosition 。
15.10.3 PrepareForTailCall ( )
The abstract operation PrepareForTailCall takes no arguments and returns
- 断言：当前执行上下文随后不会再用于求值任何 ECMAScript 代码或内置函数。在调用此
抽象操作 之后对 Call 的调用，会在执行任何此类求值之前创建并压入一个新的执行上下文。 - 丢弃与当前执行上下文关联的所有资源。
- 返回
unused 。
尾位置调用必须在调用目标函数之前释放与当前正在执行的函数执行上下文关联的任何临时内部资源，或者重用这些资源以支持目标函数。
例如，尾位置调用使实现的激活记录栈增长的量，应仅为目标函数激活记录大小超出调用函数激活记录大小的部分。如果目标函数的激活记录更小，则栈的总大小应减少。
16 ECMAScript 语言：脚本和模块
16.1 脚本
语法
16.1.1 Static Semantics: 早期错误
-
如果
ScriptBody 的LexicallyDeclaredNames 包含 任何重复项，则为语法错误。 -
如果
ScriptBody 的LexicallyDeclaredNames 的任何元素也出现在ScriptBody 的VarDeclaredNames 中，则为语法错误。
-
如果
StatementList Contains super，则为语法错误，除非包含 super的源文本是正在由直接 eval 处理的 eval 代码。直接 eval 内super的其他早期错误 规则定义在19.2.1.1 中。 -
如果
StatementList Contains NewTarget ，则为语法错误，除非包含 NewTarget 的源文本是正在由直接 eval 处理的 eval 代码。直接 eval 中NewTarget 的其他早期错误 规则定义在19.2.1.1 中。 -
如果以 « » 为实参执行
StatementList 的ContainsDuplicateLabels 是true ，则为语法错误。 -
如果以 « » 为实参执行
StatementList 的ContainsUndefinedBreakTarget 是true ，则为语法错误。 -
如果以 « » 和 « » 为实参执行
StatementList 的ContainsUndefinedContinueTarget 是true ，则为语法错误。 -
如果以 « » 为实参执行
StatementList 的AllPrivateIdentifiersValid 是false ，则为语法错误，除非包含 ScriptBody 的源文本是正在由直接 eval 处理的 eval 代码。 -
如果
StatementList 的ContainsUsing 是true ，则为语法错误。
16.1.2 Static Semantics: ScriptIsStrict
The syntax-directed operation ScriptIsStrict takes no arguments and returns a Boolean. It is defined piecewise over the following productions:
- 如果存在
ScriptBody 且ScriptBody 的Directive Prologue 包含 Use Strict Directive ，则返回true 。 - 返回
false 。
16.1.3 Runtime Semantics: Evaluation
- 返回
undefined 。
16.1.4 Script Record
Script Record 封装关于正在求值的脚本的信息。每个 script record 都
| 字段名 | 值类型 | 含义 |
|---|---|---|
| [[Realm]] |
a |
创建此脚本所在的 |
| [[ECMAScriptCode]] |
a |
解析此脚本源文本的结果。 |
| [[LoadedModules]] |
a |
从此脚本导入的说明符字符串到已解析 |
| [[HostDefined]] |
anything（默认值为 |
为需要把附加信息与脚本关联起来的 |
16.1.5 ParseScript ( sourceText, realm, hostDefined )
The abstract operation ParseScript takes arguments sourceText (a String or a sequence of Unicode code points), realm (a
- 令 script 为
ParseText (sourceText,Script )。 - 如果 script 是错误列表，则返回 script。
- 返回
Script Record { [[Realm]]: realm, [[ECMAScriptCode]]: script, [[LoadedModules]]: « », [[HostDefined]]: hostDefined }。
实现可以在对脚本源文本求值 ParseScript 之前解析脚本源文本并分析其
16.1.6 ScriptEvaluation ( scriptRecord )
The abstract operation ScriptEvaluation takes argument scriptRecord (a
- 令 globalEnv 为 scriptRecord.[[Realm]].[[GlobalEnv]]。
- 令 scriptContext 为一个新的
ECMAScript 代码执行上下文 。 - 将 scriptContext 的 Function 设置为
null 。 - 将 scriptContext 的
Realm 设置为 scriptRecord.[[Realm]]。 - 将 scriptContext 的 ScriptOrModule 设置为 scriptRecord。
- 将 scriptContext 的 VariableEnvironment 设置为 globalEnv。
- 将 scriptContext 的 LexicalEnvironment 设置为 globalEnv。
- 将 scriptContext 的 PrivateEnvironment 设置为
null 。 - 挂起运行中的执行上下文。
- 将 scriptContext 压入执行上下文栈；scriptContext 现在是运行中的执行上下文。
- 令 scriptNode 为 scriptRecord.[[ECMAScriptCode]]。
- 令 result 为
Completion (GlobalDeclarationInstantiation (scriptNode, globalEnv))。 - 如果 result 是 normal completion，则
- 将 result 设置为
Completion (scriptNode 的Evaluation )。 - 如果 result 是 normal completion 且 result.[[Value]] 是
empty ，则- 将 result 设置为
NormalCompletion (undefined )。
- 将 result 设置为
- 将 result 设置为
- 挂起 scriptContext 并将其从执行上下文栈中移除。
- 断言：执行上下文栈不是空的。
- 恢复当前位于执行上下文栈顶部的上下文作为运行中的执行上下文。
- 返回 ? result。
16.1.7 GlobalDeclarationInstantiation ( script, envRecord )
The abstract operation GlobalDeclarationInstantiation takes arguments script (a
当为求值脚本而建立执行上下文时，声明会在当前全局环境中实例化。代码中声明的每个全局绑定都会被实例化。
它在被调用时执行以下步骤：
- 令 lexicalNames 为 script 的
LexicallyDeclaredNames 。 - 令 variableNames 为 script 的
VarDeclaredNames 。 - 对 lexicalNames 的每个元素 name，执行：
- 如果
HasLexicalDeclaration (envRecord, name) 为true ，则抛出一个SyntaxError 异常。 - 令 hasRestrictedGlobal 为 ?
HasRestrictedGlobalProperty (envRecord, name)。 - 注：全局
var和function绑定（由非严格直接 eval 引入的那些绑定除外）是不可配置的，因此是受限制的全局属性。 - 如果 hasRestrictedGlobal 为
true ，则抛出一个SyntaxError 异常。
- 如果
- 对 variableNames 的每个元素 name，执行：
- 如果
HasLexicalDeclaration (envRecord, name) 为true ，则抛出一个SyntaxError 异常。
- 如果
- 令 variableDecls 为 script 的
VarScopedDeclarations 。 - 令 funcsToInitialize 为一个新的空
List 。 - 令 declaredFuncNames 为一个新的空
List 。 - 对 variableDecls 的每个元素 variableDecl，按
List 的逆序执行：- 如果 variableDecl 不是
VariableDeclaration 、ForBinding 或BindingIdentifier 中的任一者，则- 断言：variableDecl 是
FunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 或AsyncGeneratorDeclaration 。 - 注：如果同一名称有多个函数声明，则使用最后一个声明。
- 令 funcName 为 variableDecl 的
BoundNames 的唯一元素。 - 如果 declaredFuncNames 不
包含 funcName，则- 令 funcDefinable 为 ?
CanDeclareGlobalFunction (envRecord, funcName)。 - 如果 funcDefinable 为
false ，则抛出一个TypeError 异常。 - 将 funcName 追加到 declaredFuncNames。
- 将 variableDecl 作为 funcsToInitialize 的第一个元素插入。
- 令 funcDefinable 为 ?
- 断言：variableDecl 是
- 如果 variableDecl 不是
- 令 declaredVariableNames 为一个新的空
List 。 - 对 variableDecls 的每个元素 variableDecl，执行：
- 如果 variableDecl 是
VariableDeclaration 、ForBinding 或BindingIdentifier 中的任一者，则- 对 variableDecl 的
BoundNames 的每个 String name，执行：- 如果 declaredFuncNames 不
包含 name，则- 令 variableDefinable 为 ?
CanDeclareGlobalVar (envRecord, name)。 - 如果 variableDefinable 为
false ，则抛出一个TypeError 异常。 - 如果 declaredVariableNames 不
包含 name，则- 将 name 追加到 declaredVariableNames。
- 令 variableDefinable 为 ?
- 如果 declaredFuncNames 不
- 对 variableDecl 的
- 如果 variableDecl 是
- 注：如果
全局对象 是普通对象 ，则在此算法步骤之后不会发生异常终止。但是，如果全局对象 是Proxy 异质对象 ，它可能表现出会导致以下某些步骤中发生异常终止的行为。 - 如果
宿主 是 Web 浏览器，或以其他方式支持块级函数声明的 Web 遗留兼容性语义 ，则- 令 strict 为 script 的
ScriptIsStrict 。 - 如果 strict 为
false ，则- 令 declaredFuncOrVariableNames 为 declaredFuncNames 和 declaredVariableNames 的
列表连接 。 - 对每个
FunctionDeclaration funcDecl，其直接包含 在任何Block 、CaseClause 或DefaultClause x 的StatementList 中，且 scriptContains x 为true ，执行：- 令 funcName 为 funcDecl 的
BindingIdentifier 的StringValue 。 - 如果将
FunctionDeclaration funcDecl 替换为以 funcName 作为BindingIdentifier 的VariableStatement 不会为 script 产生任何早期错误 ，则- 如果
HasLexicalDeclaration (envRecord, funcName) 为false ，则- 令 funcDefinable 为 ?
CanDeclareGlobalVar (envRecord, funcName)。 - 如果 funcDefinable 为
true ，则- 注：只有当 funcName 既不是 VarDeclaredName、也不是另一个
FunctionDeclaration 的名称时，才在此处实例化 funcName 的 var 绑定。 - 如果 declaredFuncOrVariableNames 不
包含 funcName，则- 执行 ?
CreateGlobalVarBinding (envRecord, funcName,false )。 - 将 funcName 追加到 declaredFuncOrVariableNames。
- 执行 ?
- 当
FunctionDeclaration funcDecl 被求值时，执行以下步骤以取代15.2.6 中提供的FunctionDeclaration Evaluation 算法：- 令 globalEnv 为正在运行的执行上下文的 VariableEnvironment。
- 令 blockEnv 为正在运行的执行上下文的 LexicalEnvironment。
- 令 funcObj 为 ! blockEnv.
GetBindingValue (funcName,false )。 - 执行 ? globalEnv.
SetMutableBinding (funcName, funcObj,false )。 - 返回
unused 。
- 注：只有当 funcName 既不是 VarDeclaredName、也不是另一个
- 令 funcDefinable 为 ?
- 如果
- 令 funcName 为 funcDecl 的
- 令 declaredFuncOrVariableNames 为 declaredFuncNames 和 declaredVariableNames 的
- 令 strict 为 script 的
- 令 lexicalDecls 为 script 的
LexicallyScopedDeclarations 。 - 令 privateEnv 为
null 。 - 对 lexicalDecls 的每个元素 lexicalDecl，执行：
- 注：词法声明的名称仅在此处实例化，但不初始化。
- 对 lexicalDecl 的
BoundNames 的每个元素 name，执行：- 如果 lexicalDecl 的
IsConstantDeclaration 为true ，则- 执行 ? envRecord.
CreateImmutableBinding (name,true )。
- 执行 ? envRecord.
- 否则，
- 执行 ? envRecord.
CreateMutableBinding (name,false )。
- 执行 ? envRecord.
- 如果 lexicalDecl 的
- 对 funcsToInitialize 的每个
Parse Node funcDecl，执行：- 令 funcName 为 funcDecl 的
BoundNames 的唯一元素。 - 令 funcObj 为使用参数 envRecord 和 privateEnv 对 funcDecl 执行
InstantiateFunctionObject 的结果。 - 执行 ?
CreateGlobalFunctionBinding (envRecord, funcName, funcObj,false )。
- 令 funcName 为 funcDecl 的
- 对 declaredVariableNames 的每个 String variableName，执行：
- 执行 ?
CreateGlobalVarBinding (envRecord, variableName,false )。
- 执行 ?
- 返回
unused 。
不同于显式 var 或函数声明，直接在
16.2 模块
语法
16.2.1 模块语义
16.2.1.1 Static Semantics: 早期错误
-
如果
ModuleItemList 的LexicallyDeclaredNames 包含 任何重复项，则为语法错误。 -
如果
ModuleItemList 的LexicallyDeclaredNames 的任何元素也出现在ModuleItemList 的VarDeclaredNames 中，则为语法错误。 -
如果
ModuleItemList 的ExportedNames 包含 任何重复项，则为语法错误。 -
如果
ModuleItemList 的ExportedBindings 的任何元素没有同时出现在ModuleItemList 的VarDeclaredNames 或LexicallyDeclaredNames 中，则为语法错误。 -
如果
ModuleItemList Contains super，则为语法错误。 -
如果
ModuleItemList Contains NewTarget ，则为语法错误。 -
如果以 « » 为实参执行
ModuleItemList 的ContainsDuplicateLabels 是true ，则为语法错误。 -
如果以 « » 为实参执行
ModuleItemList 的ContainsUndefinedBreakTarget 是true ，则为语法错误。 -
如果以 « » 和 « » 为实参执行
ModuleItemList 的ContainsUndefinedContinueTarget 是true ，则为语法错误。 -
如果以 « » 为实参执行
ModuleItemList 的AllPrivateIdentifiersValid 是false ，则为语法错误。
重复 export default
- 如果
IsStringWellFormedUnicode (StringLiteral 的SV ) 是false ，则为语法错误。
16.2.1.2 Static Semantics: ImportedLocalNames ( importEntries )
The abstract operation ImportedLocalNames takes argument importEntries (a
- 令 localNames 为一个新的空
List 。 - 对 importEntries 的每个
ImportEntry Record importEntry，执行：- 将 importEntry.[[LocalName]] 追加到 localNames。
- 返回 localNames。
16.2.1.3 ModuleRequest Record
ModuleRequest Record 表示带有给定导入属性的导入模块请求。它由以下字段组成：
| 字段名 | 值类型 | 含义 |
|---|---|---|
| [[Specifier]] | a String | 模块说明符 |
| [[Attributes]] |
a |
导入属性 |
LoadedModuleRequest Record 表示导入模块的请求以及所得的
| 字段名 | 值类型 | 含义 |
|---|---|---|
| [[Specifier]] | a String | 模块说明符 |
| [[Attributes]] |
a |
导入属性 |
| [[Module]] |
a |
与此模块请求对应的已加载模块 |
ImportAttribute Record 由以下字段组成：
| 字段名 | 值类型 | 含义 |
|---|---|---|
| [[Key]] | a String |
|
| [[Value]] | a String | 属性值 |
16.2.1.3.1 ModuleRequestsEqual ( x, y )
The abstract operation ModuleRequestsEqual takes arguments x (a
- 如果 x.[[Specifier]] 不是 y.[[Specifier]]，则返回
false 。 - 令 xAttrs 为 x.[[Attributes]]。
- 令 yAttrs 为 y.[[Attributes]]。
- 令 xAttrsCount 为 xAttrs 中元素的数量。
- 令 yAttrsCount 为 yAttrs 中元素的数量。
- 如果 xAttrsCount ≠ yAttrsCount，则返回
false 。 - 对 xAttrs 的每个
ImportAttribute Record xAttr，执行：- 如果 yAttrs 不
包含 一个ImportAttribute Record yAttr，使得 xAttr.[[Key]] 是 yAttr.[[Key]] 且 xAttr.[[Value]] 是 yAttr.[[Value]]，则返回false 。
- 如果 yAttrs 不
- 返回
true 。
16.2.1.4 Static Semantics: ModuleRequests
The syntax-directed operation ModuleRequests takes no arguments and returns a
- 返回新的空
List 。
- 返回
ModuleItem 的ModuleRequests 。
- 令 requests 为
ModuleItemList 的ModuleRequests 。 - 令 additionalRequests 为
ModuleItem 的ModuleRequests 。 - 对 additionalRequests 的每个
ModuleRequest Record moduleRequest，执行：- 如果 requests 不
包含 这样的ModuleRequest Record otherModuleRequest，使得ModuleRequestsEqual (moduleRequest, otherModuleRequest) 为true ，则- 将 moduleRequest 追加到 requests。
- 如果 requests 不
- 返回 requests。
- 返回新的空
List 。
- 令 specifier 为
FromClause 的SV 。 - 返回一个
List ，其唯一元素为ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: « » }。
- 令 specifier 为
FromClause 的SV 。 - 令 attrs 为
WithClause 的WithClauseToAttributes 。 - 返回一个
List ，其唯一元素为ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: attrs }。
- 令 specifier 为
ModuleSpecifier 的SV 。 - 返回一个
List ，其唯一元素为ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: « » }。
- 令 specifier 为
ModuleSpecifier 的SV 。 - 令 attrs 为
WithClause 的WithClauseToAttributes 。 - 返回一个
List ，其唯一元素为ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: attrs }。
- 令 specifier 为
FromClause 的SV 。 - 返回一个
List ，其唯一元素为ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: « » }。
- 令 specifier 为
FromClause 的SV 。 - 令 attrs 为
WithClause 的WithClauseToAttributes 。 - 返回一个
List ，其唯一元素为ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: attrs }。
- 返回新的空
List 。
16.2.1.5 抽象 Module Record
Module Record 封装关于单个模块的导入和导出的结构信息。此信息用于链接一组相互连接模块的导入和导出。Module Record
出于规范目的，Module Record 值是
Module Record 定义
| 字段名 | 值类型 | 含义 |
|---|---|---|
| [[Realm]] |
a |
创建此模块所在的 |
| [[Environment]] |
a |
|
| [[Namespace]] |
an Object or |
如果已为此模块创建 Module Namespace Object（ |
| [[HostDefined]] |
anything（默认值为 |
为需要把附加信息与模块关联起来的 |
| 方法 | 目的 | 定义 |
|---|---|---|
| LoadRequestedModules ( [ hostDefined ] ) | The abstract method LoadRequestedModules takes optional argument hostDefined (anything) and returns a Promise. 它通过递归加载所有依赖项，为模块链接做准备。 |
在本规范内，它在以下类型中有定义； |
| GetExportedNames ( [ exportStarSet ] ) | The abstract method GetExportedNames takes optional argument exportStarSet (a 它返回从此模块直接或间接导出的所有名称的列表。 在调用此方法之前， |
在本规范内，它在以下类型中有定义； |
| ResolveExport ( exportName [ , resolveSet ] ) | The abstract method ResolveExport takes argument exportName (a String) and optional argument resolveSet (a 它返回此模块导出名称的绑定。绑定由 ResolvedBinding Record 表示，其形式为 { [[Module]]: 每次以特定的 exportName、resolveSet 参数对调用此操作时，都必须返回相同的结果。 在调用此方法之前， |
在本规范内，它在以下类型中有定义； |
| Link ( ) | The abstract method Link takes no arguments and returns either a normal completion containing 它通过传递地解析所有模块依赖项并创建 在调用此方法之前， |
在本规范内，它在以下类型中有定义； |
| Evaluate ( ) | The abstract method Evaluate takes no arguments and returns a Promise. 它返回一个用于此模块及其依赖项求值的 promise，该 promise 会在成功求值时或已经成功求值过时兑现，并在求值错误或已经求值失败过时拒绝。如果 promise 被拒绝，期望 在调用此方法之前， |
在本规范内，它在以下类型中有定义； |
16.2.1.5.1 EvaluateModuleSync ( module )
The abstract operation EvaluateModuleSync takes argument module (a
- 断言：module 不是
Cyclic Module Record 。 - 令 promise 为 module.
Evaluate ()。 - 断言：promise.[[PromiseState]] 是
fulfilled 或rejected 。 - 如果 promise.[[PromiseState]] 是
rejected ，则- 如果 promise.[[PromiseIsHandled]] 是
false ，则执行HostPromiseRejectionTracker (promise,"handle" )。 - 将 promise.[[PromiseIsHandled]] 设置为
true 。 - 抛出 promise.[[PromiseResult]]。
- 如果 promise.[[PromiseIsHandled]] 是
- 返回
unused 。
16.2.1.6 Cyclic Module Record
Cyclic Module Record 用于表示关于某个模块的信息，该模块可以与作为
除了
| 字段名 | 值类型 | 含义 |
|---|---|---|
| [[Status]] |
|
初始为 |
| [[EvaluationError]] |
a throw completion or |
表示求值期间发生的异常的 throw completion。如果没有发生异常，或 [[Status]] 不是 |
| [[DFSAncestorIndex]] |
an |
仅在 |
| [[RequestedModules]] |
a |
与此模块中导入关联的 |
| [[LoadedModules]] |
a |
从由此 |
| [[CycleRoot]] |
a |
循环中第一个被访问的模块，即强连通分量的根 DFS 祖先。对于不在循环中的模块，这将是该模块自身。一旦 |
| [[HasTLA]] | a Boolean |
此模块是否单独异步（例如，如果它是 |
| [[AsyncEvaluationOrder]] |
|
此字段最初设置为 |
| [[TopLevelCapability]] |
a |
如果此模块是某个循环的 [[CycleRoot]]，且该循环中的某个模块调用了 |
| [[AsyncParentModules]] |
a |
如果此模块或某个依赖项具有 [[HasTLA]] |
| [[PendingAsyncDependencies]] |
an |
如果此模块有任何异步依赖项，则此字段跟踪此模块剩余要执行的异步依赖模块数量。具有异步依赖项的模块会在此字段达到 0 且没有执行错误时执行。 |
除了
| 方法 | 目的 | 定义 |
|---|---|---|
| InitializeEnvironment ( ) | The abstract method InitializeEnvironment takes no arguments and returns either a normal completion containing |
在本规范内，它在以下类型中有定义； |
| ExecuteModule ( [ capability ] ) | The abstract method ExecuteModule takes optional argument capability (a |
在本规范内，它在以下类型中有定义； |
GraphLoadingState Record 是一个
| 字段名 | 值类型 | 含义 |
|---|---|---|
| [[PromiseCapability]] |
a |
加载过程结束时要 resolve 的 promise。 |
| [[IsLoading]] | a Boolean | 如果加载过程尚未结束（既没有成功，也没有出错），则为 true。 |
| [[PendingModulesCount]] |
a non-negative |
它跟踪待处理的 |
| [[Visited]] |
a |
它是当前加载过程中已经加载的 |
| [[HostDefined]] |
anything (default value is |
它 |
16.2.1.6.1 Module Record 抽象方法的实现
以下是
16.2.1.6.1.1 LoadRequestedModules ( [ hostDefined ] )
The
- 如果 hostDefined 不存在，则将 hostDefined 设置为
empty 。 - 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 state 为
GraphLoadingState Record { [[IsLoading]]:true , [[PendingModulesCount]]: 1, [[Visited]]: « », [[PromiseCapability]]: promiseCapability, [[HostDefined]]: hostDefined }。 - 执行
InnerModuleLoading (state, module)。 - 返回 promiseCapability.[[Promise]]。
<link rel="preload" as="..."> 标签设置正确的 fetch destination。
import() 表达式永远不会设置 hostDefined 参数。
16.2.1.6.1.1.1 InnerModuleLoading ( state, module )
The abstract operation InnerModuleLoading takes arguments state (a
- 断言：state.[[IsLoading]] 是
true 。 - 如果 module 是
Cyclic Module Record ，module.[[Status]] 是new ，并且 state.[[Visited]] 不包含 module，则- 将 module 追加到 state.[[Visited]]。
- 令 requestedModulesCount 为 module.[[RequestedModules]] 中元素的数量。
- 将 state.[[PendingModulesCount]] 设置为 state.[[PendingModulesCount]] + requestedModulesCount。
- 对 module.[[RequestedModules]] 的每个
ModuleRequest Record request，执行：- 如果
AllImportAttributesSupported (request.[[Attributes]]) 是false ，则- 令 error 为
ThrowCompletion (一个新创建的SyntaxError 对象)。 - 执行
ContinueModuleLoading (state, error)。
- 令 error 为
- 否则，如果 module.[[LoadedModules]]
包含 一个LoadedModuleRequest Record record，使得ModuleRequestsEqual (record, request) 是true ，则- 执行
InnerModuleLoading (state, record.[[Module]])。
- 执行
- 否则，
- 执行
HostLoadImportedModule (module, request, state.[[HostDefined]], state)。 - 注：
HostLoadImportedModule 将调用FinishLoadingImportedModule ，后者会通过ContinueModuleLoading 重新进入图加载过程。
- 执行
- 如果 state.[[IsLoading]] 是
false ，则返回unused 。
- 如果
- 断言：state.[[PendingModulesCount]] ≥ 1。
- 将 state.[[PendingModulesCount]] 设置为 state.[[PendingModulesCount]] - 1。
- 如果 state.[[PendingModulesCount]] = 0，则
- 将 state.[[IsLoading]] 设置为
false 。 - 对 state.[[Visited]] 的每个
Cyclic Module Record loaded，执行：- 如果 loaded.[[Status]] 是
new ，则将 loaded.[[Status]] 设置为unlinked 。
- 如果 loaded.[[Status]] 是
- 执行 !
Call (state.[[PromiseCapability]].[[Resolve]],undefined , «undefined »)。
- 将 state.[[IsLoading]] 设置为
- 返回
unused 。
16.2.1.6.1.1.2 ContinueModuleLoading ( state, moduleCompletion )
The abstract operation ContinueModuleLoading takes arguments state (a
- 如果 state.[[IsLoading]] 是
false ，则返回unused 。 - 如果 moduleCompletion 是 normal completion，则
- 执行
InnerModuleLoading (state, moduleCompletion.[[Value]])。
- 执行
- 否则，
- 将 state.[[IsLoading]] 设置为
false 。 - 执行 !
Call (state.[[PromiseCapability]].[[Reject]],undefined , « moduleCompletion.[[Value]] »)。
- 将 state.[[IsLoading]] 设置为
- 返回
unused 。
16.2.1.6.1.2 Link ( )
The
- 断言：module.[[Status]] 是
unlinked 、linked 、evaluating-async 或evaluated 之一。 - 令 stack 为一个新的空
List 。 - 令 result 为
Completion (InnerModuleLinking (module, stack, 0))。 - 如果 result 是一个
突然完成 ，则- 对 stack 的每个
Cyclic Module Record requiredModule，执行：- 断言：requiredModule.[[Status]] 为
linking 。 - 将 requiredModule.[[Status]] 设为
unlinked 。
- 断言：requiredModule.[[Status]] 为
- 断言：module.[[Status]] 为
unlinked 。 - 返回 ? result。
- 对 stack 的每个
- 断言：module.[[Status]] 是
linked 、evaluating-async 或evaluated 之一。 - 断言：stack 为空。
- 返回
unused 。
16.2.1.6.1.2.1 InnerModuleLinking ( module, stack, index )
The abstract operation InnerModuleLinking takes arguments module (a
- 如果 module 不是
Cyclic Module Record ，则- 执行 ? module.
Link ()。 - 返回 index。
- 执行 ? module.
- 如果 module.[[Status]] 是
linking 、linked 、evaluating-async 或evaluated 之一，则- 返回 index。
- 断言：module.[[Status]] 是
unlinked 。 - 将 module.[[Status]] 设置为
linking 。 - 令 moduleIndex 为 index。
- 将 module.[[DFSAncestorIndex]] 设置为 index。
- 将 index 设置为 index + 1。
- 将 module 追加到 stack。
- 对 module.[[RequestedModules]] 的每个
ModuleRequest Record request，执行：- 令 requiredModule 为
GetImportedModule (module, request)。 - 将 index 设置为 ?
InnerModuleLinking (requiredModule, stack, index)。 - 如果 requiredModule 是
Cyclic Module Record ，则
- 令 requiredModule 为
- 执行 ? module.
InitializeEnvironment ()。 - 断言：module 在 stack 中恰好出现一次。
- 断言：module.[[DFSAncestorIndex]] ≤ moduleIndex。
- 如果 module.[[DFSAncestorIndex]] = moduleIndex，则
- 令 done 为
false 。 - 重复，只要 done 是
false ，- 令 requiredModule 为 stack 的最后一个元素。
- 移除 stack 的最后一个元素。
- 断言：requiredModule 是
Cyclic Module Record 。 - 将 requiredModule.[[Status]] 设置为
linked 。 - 如果 requiredModule 和 module 是同一个
Module Record ，则将 done 设置为true 。
- 令 done 为
- 返回 index。
16.2.1.6.1.3 Evaluate ( )
The
- 断言：对
Evaluate 的此调用不会与周围 agent 内对Evaluate 的另一个调用同时发生。 - 断言：module.[[Status]] 是
linked 、evaluating-async 或evaluated 之一。 - 如果 module.[[Status]] 为
evaluating-async 或evaluated ，则- 如果 module.[[CycleRoot]] 不是
empty ，则- 将 module 设为 module.[[CycleRoot]]。
- 否则，
- 断言：module.[[Status]] 为
evaluated ，且 module.[[EvaluationError]] 是一个 throw completion。
- 断言：module.[[Status]] 为
- 如果 module.[[CycleRoot]] 不是
- 如果 module.[[TopLevelCapability]] 不是
empty ，则- 返回 module.[[TopLevelCapability]].[[Promise]]。
- 令 stack 为一个新的空
List 。 - 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 将 module.[[TopLevelCapability]] 设为 promiseCapability。
- 令 result 为
Completion (InnerModuleEvaluation (module, stack, 0))。 - 如果 result 是一个
突然完成 ，则- 对 stack 的每个
Cyclic Module Record requiredModule，执行：- 断言：requiredModule.[[Status]] 为
evaluating 。 - 将 requiredModule.[[Status]] 设为
evaluated 。 - 将 requiredModule.[[EvaluationError]] 设为 result。
- 断言：requiredModule.[[Status]] 为
- 断言：module.[[Status]] 为
evaluated 。 - 断言：module.[[EvaluationError]] 和 result 是同一个
Completion Record 。 - 执行 !
Call (promiseCapability.[[Reject]],undefined , « result.[[Value]] »)。
- 对 stack 的每个
- 否则，
- 断言：module.[[Status]] 为
evaluating-async 或evaluated 。 - 断言：module.[[EvaluationError]] 为
empty 。 - 如果 module.[[Status]] 为
evaluated ，则- 断言：module.[[AsyncEvaluationOrder]] 为
unset 或done 。 - 注：当且仅当 module 已经被求值且该求值是异步的，module.[[AsyncEvaluationOrder]] 才为
done 。 - 执行 !
Call (promiseCapability.[[Resolve]],undefined , «undefined »)。
- 断言：module.[[AsyncEvaluationOrder]] 为
- 断言：stack 为空。
- 断言：module.[[Status]] 为
- 返回 promiseCapability.[[Promise]]。
16.2.1.6.1.3.1 InnerModuleEvaluation ( module, stack, index )
The abstract operation InnerModuleEvaluation takes arguments module (a
- 如果 module 不是
Cyclic Module Record ，则- 执行 ?
EvaluateModuleSync (module)。 - 返回 index。
- 执行 ?
- 如果 module.[[Status]] 是
evaluating-async 或evaluated ，则- 如果 module.[[EvaluationError]] 是
empty ，则返回 index。 - 返回 ? module.[[EvaluationError]]。
- 如果 module.[[EvaluationError]] 是
- 如果 module.[[Status]] 是
evaluating ，则返回 index。 - 断言：module.[[Status]] 是
linked 。 - 将 module.[[Status]] 设置为
evaluating 。 - 令 moduleIndex 为 index。
- 将 module.[[DFSAncestorIndex]] 设置为 index。
- 将 module.[[PendingAsyncDependencies]] 设置为 0。
- 将 index 设置为 index + 1。
- 将 module 追加到 stack。
- 对 module.[[RequestedModules]] 的每个
ModuleRequest Record request，执行：- 令 requiredModule 为
GetImportedModule (module, request)。 - 将 index 设置为 ?
InnerModuleEvaluation (requiredModule, stack, index)。 - 如果 requiredModule 是
Cyclic Module Record ，则- 断言：requiredModule.[[Status]] 是
evaluating 、evaluating-async 或evaluated 之一。 - 断言：当且仅当 stack
包含 requiredModule 时，requiredModule.[[Status]] 是evaluating 。 - 如果 requiredModule.[[Status]] 是
evaluating ，则- 将 module.[[DFSAncestorIndex]] 设置为
min (module.[[DFSAncestorIndex]], requiredModule.[[DFSAncestorIndex]])。
- 将 module.[[DFSAncestorIndex]] 设置为
- 否则，
- 将 requiredModule 设置为 requiredModule.[[CycleRoot]]。
- 断言：requiredModule.[[Status]] 是
evaluating-async 或evaluated 。 - 如果 requiredModule.[[EvaluationError]] 不是
empty ，则返回 ? requiredModule.[[EvaluationError]]。
- 如果 requiredModule.[[AsyncEvaluationOrder]] 是整数，则
- 将 module.[[PendingAsyncDependencies]] 设置为 module.[[PendingAsyncDependencies]] + 1。
- 将 module 追加到 requiredModule.[[AsyncParentModules]]。
- 断言：requiredModule.[[Status]] 是
- 令 requiredModule 为
- 如果 module.[[PendingAsyncDependencies]] > 0 或 module.[[HasTLA]] 是
true ，则- 断言：module.[[AsyncEvaluationOrder]] 是
unset 。 - 将 module.[[AsyncEvaluationOrder]] 设置为
IncrementModuleAsyncEvaluationCount ()。 - 如果 module.[[PendingAsyncDependencies]] = 0，则执行
ExecuteAsyncModule (module)。
- 断言：module.[[AsyncEvaluationOrder]] 是
- 否则，
- 执行 ? module.
ExecuteModule ()。
- 执行 ? module.
- 断言：module 在 stack 中恰好出现一次。
- 断言：module.[[DFSAncestorIndex]] ≤ moduleIndex。
- 如果 module.[[DFSAncestorIndex]] = moduleIndex，则
- 令 done 为
false 。 - 重复，只要 done 是
false ，- 令 requiredModule 为 stack 的最后一个元素。
- 移除 stack 的最后一个元素。
- 断言：requiredModule 是
Cyclic Module Record 。 - 断言：requiredModule.[[AsyncEvaluationOrder]] 是整数或
unset 。 - 如果 requiredModule.[[AsyncEvaluationOrder]] 是
unset ，则将 requiredModule.[[Status]] 设置为evaluated 。 - 否则，将 requiredModule.[[Status]] 设置为
evaluating-async 。 - 如果 requiredModule 和 module 是同一个
Module Record ，则将 done 设置为true 。 - 将 requiredModule.[[CycleRoot]] 设置为 module。
- 令 done 为
- 返回 index。
模块在被 InnerModuleEvaluation 遍历期间是
当异步循环不处于
16.2.1.6.1.3.2 ExecuteAsyncModule ( module )
The abstract operation ExecuteAsyncModule takes argument module (a
- 断言：module.[[Status]] 是
evaluating 或evaluating-async 。 - 断言：module.[[HasTLA]] 是
true 。 - 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 fulfilledClosure 为一个新的
Abstract Closure ，它没有参数、捕获 module，并在被调用时执行以下步骤：- 执行
AsyncModuleExecutionFulfilled (module)。 - 返回
NormalCompletion (undefined )。
- 执行
- 令 onFulfilled 为
CreateBuiltinFunction (fulfilledClosure, 0,"" , « »)。 - 令 rejectedClosure 为一个新的
Abstract Closure ，它具有参数 (error)、捕获 module，并在被调用时执行以下步骤：- 执行
AsyncModuleExecutionRejected (module, error)。 - 返回
NormalCompletion (undefined )。
- 执行
- 令 onRejected 为
CreateBuiltinFunction (rejectedClosure, 0,"" , « »)。 - 执行
PerformPromiseThen (promiseCapability.[[Promise]], onFulfilled, onRejected)。 - 执行 ! module.
ExecuteModule (promiseCapability)。 - 返回
unused 。
16.2.1.6.1.3.3 GatherAvailableAncestors ( module, execList )
The abstract operation GatherAvailableAncestors takes arguments module (a
- 对 module.[[AsyncParentModules]] 的每个
Cyclic Module Record ancestorModule，执行：- 如果 execList 不
包含 ancestorModule 且 ancestorModule.[[CycleRoot]].[[EvaluationError]] 是empty ，则- 断言：ancestorModule.[[Status]] 是
evaluating-async 。 - 断言：ancestorModule.[[EvaluationError]] 是
empty 。 - 断言：ancestorModule.[[AsyncEvaluationOrder]] 是整数。
- 断言：ancestorModule.[[PendingAsyncDependencies]] > 0。
- 将 ancestorModule.[[PendingAsyncDependencies]] 设置为 ancestorModule.[[PendingAsyncDependencies]] - 1。
- 如果 ancestorModule.[[PendingAsyncDependencies]] = 0，则
- 将 ancestorModule 追加到 execList。
- 如果 ancestorModule.[[HasTLA]] 是
false ，则执行GatherAvailableAncestors (ancestorModule, execList)。
- 断言：ancestorModule.[[Status]] 是
- 如果 execList 不
- 返回
unused 。
当根 module 的异步执行被 fulfilled 时，此函数会确定能够在此完成时一起同步执行的模块列表，并将其填充到 execList 中。
16.2.1.6.1.3.4 AsyncModuleExecutionFulfilled ( module )
The abstract operation AsyncModuleExecutionFulfilled takes argument module (a
- 如果 module.[[Status]] 是
evaluated ，则- 断言：module.[[EvaluationError]] 不是
empty 。 - 返回
unused 。
- 断言：module.[[EvaluationError]] 不是
- 断言：module.[[Status]] 是
evaluating-async 。 - 断言：module.[[AsyncEvaluationOrder]] 是整数。
- 断言：module.[[EvaluationError]] 是
empty 。 - 将 module.[[AsyncEvaluationOrder]] 设置为
done 。 - 将 module.[[Status]] 设置为
evaluated 。 - 如果 module.[[TopLevelCapability]] 不是
empty ，则- 断言：module.[[CycleRoot]] 和 module 是同一个
Module Record 。 - 执行 !
Call (module.[[TopLevelCapability]].[[Resolve]],undefined , «undefined »)。
- 断言：module.[[CycleRoot]] 和 module 是同一个
- 令 execList 为新的空
List 。 - 执行
GatherAvailableAncestors (module, execList)。 - 断言：execList 的所有元素的 [[AsyncEvaluationOrder]] 字段都被设置为整数，[[PendingAsyncDependencies]] 字段被设置为 0，且 [[EvaluationError]] 字段被设置为
empty 。 - 令 sortedExecList 为一个
List ，其元素是 execList 的元素，按它们的 [[AsyncEvaluationOrder]] 字段升序排序。 - 对 sortedExecList 的每个
Cyclic Module Record ancestorModule，执行：- 如果 ancestorModule.[[Status]] 是
evaluated ，则- 断言：ancestorModule.[[EvaluationError]] 不是
empty 。
- 断言：ancestorModule.[[EvaluationError]] 不是
- 否则，如果 ancestorModule.[[HasTLA]] 是
true ，则- 执行
ExecuteAsyncModule (ancestorModule)。
- 执行
- 否则，
- 令 result 为
Completion (ancestorModule.ExecuteModule ())。 - 如果 result 是 abrupt completion，则
- 执行
AsyncModuleExecutionRejected (ancestorModule, result.[[Value]])。
- 执行
- 否则，
- 将 ancestorModule.[[AsyncEvaluationOrder]] 设置为
done 。 - 将 ancestorModule.[[Status]] 设置为
evaluated 。 - 如果 ancestorModule.[[TopLevelCapability]] 不是
empty ，则- 断言：ancestorModule.[[CycleRoot]] 和 ancestorModule 是同一个
Module Record 。 - 执行 !
Call (ancestorModule.[[TopLevelCapability]].[[Resolve]],undefined , «undefined »)。
- 断言：ancestorModule.[[CycleRoot]] 和 ancestorModule 是同一个
- 将 ancestorModule.[[AsyncEvaluationOrder]] 设置为
- 令 result 为
- 如果 ancestorModule.[[Status]] 是
- 返回
unused 。
16.2.1.6.1.3.5 AsyncModuleExecutionRejected ( module, error )
The abstract operation AsyncModuleExecutionRejected takes arguments module (a
- 如果 module.[[Status]] 是
evaluated ，则- 断言：module.[[EvaluationError]] 不是
empty 。 - 返回
unused 。
- 断言：module.[[EvaluationError]] 不是
- 断言：module.[[Status]] 是
evaluating-async 。 - 断言：module.[[AsyncEvaluationOrder]] 是整数。
- 断言：module.[[EvaluationError]] 是
empty 。 - 将 module.[[EvaluationError]] 设置为
ThrowCompletion (error)。 - 将 module.[[Status]] 设置为
evaluated 。 - 将 module.[[AsyncEvaluationOrder]] 设置为
done 。 - 注：module.[[AsyncEvaluationOrder]] 被设置为
done ，是为了与AsyncModuleExecutionFulfilled 保持对称。在InnerModuleEvaluation 中，当模块的 [[EvaluationError]] 内部槽不是empty 时，模块的 [[AsyncEvaluationOrder]] 内部槽的值不会被使用。 - 如果 module.[[TopLevelCapability]] 不是
empty ，则- 断言：module.[[CycleRoot]] 和 module 是同一个
Module Record 。 - 执行 !
Call (module.[[TopLevelCapability]].[[Reject]],undefined , « error »)。
- 断言：module.[[CycleRoot]] 和 module 是同一个
- 对 module.[[AsyncParentModules]] 的每个
Cyclic Module Record ancestorModule，执行：- 执行
AsyncModuleExecutionRejected (ancestorModule, error)。
- 执行
- 返回
unused 。
16.2.1.6.2 Cyclic Module Record 图示例
本非规范性小节给出一些常见模块图的链接和求值的一系列示例，并特别关注错误如何发生。
首先考虑以下简单模块图：
我们先假设没有错误条件。当
接下来考虑在成功调用 A.
最后，考虑在成功调用
现在考虑另一种类型的错误条件：
在此场景中，模块 A 声明了对某个其他模块的依赖，但不存在该模块的
这里加载、链接和求值错误之间的差异，是由于以下特性：
- 求值必须只执行一次，因为它可能产生副作用；因此，记住求值是否已经执行非常重要，即使执行失败也如此。（在错误情况下，同时记住异常也是有意义的，因为否则后续
Evaluate () 调用将不得不合成一个新的异常。） - 另一方面，链接没有副作用，因此即使失败，也可以在以后重试而没有问题。
- 加载与
宿主 紧密交互，并且对某些宿主 来说，允许用户重试失败的加载可能是可取的（例如，如果失败是由临时网络状况不佳引起的）。
现在，考虑一个带有循环的模块图：
这里我们假设入口点是模块 A，因此
然后
在循环模块图求值阶段的成功情况下，也会发生类似的过程。
现在考虑 A 有链接错误的情况；例如，它尝试从 C 导入一个不存在的绑定。在这种情况下，上述步骤仍会发生，包括第二次在 A 上调用
或者，考虑 A 有求值错误的情况；例如，其源代码抛出异常。在这种情况下，上述步骤的求值时类比仍会发生，包括第二次在 A 上调用 await 或依赖顶层 await 的模块，通过
最后，考虑一个带有循环且所有模块都异步完成的模块图：
加载和链接按之前一样发生，并且所有模块最终的 [[Status]] 都设置为
调用 A.
|
字段
|
A | B | C | D | E |
|---|---|---|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 | 0 | 0 | 4 |
| [[Status]] | |||||
| [[AsyncEvaluationOrder]] | 4 | 1 | 3 | 0 | 2 |
| [[AsyncParentModules]] | « » | « A » | « A » | « B, C » | « C » |
| [[PendingAsyncDependencies]] | 2（B 和 C） | 1（D） | 2（D 和 E） | 0 | 0 |
让我们假设 E 最先完成执行。当这发生时，会调用
|
字段
|
C | E |
|---|---|---|
| [[DFSAncestorIndex]] | 0 | 4 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | 3 | |
| [[AsyncParentModules]] | « A » | « C » |
| [[PendingAsyncDependencies]] | 1（D） | 0 |
D 接下来完成（因为它是唯一仍在执行的模块）。当这发生时，会再次调用 await，则可能与 B 并行）。更新后的模块字段如
|
字段
|
B | C | D |
|---|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 | 0 |
| [[Status]] | |||
| [[AsyncEvaluationOrder]] | 1 | 3 | |
| [[AsyncParentModules]] | « A » | « A » | « B, C » |
| [[PendingAsyncDependencies]] | 0 | 0 | 0 |
让我们假设 C 接下来完成执行。当这发生时，会再次调用
|
字段
|
A | C |
|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | 4 | |
| [[AsyncParentModules]] | « » | « A » |
| [[PendingAsyncDependencies]] | 1（B） | 0 |
然后，B 完成执行。当这发生时，会再次调用
|
字段
|
A | B |
|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | 4 | |
| [[AsyncParentModules]] | « » | « A » |
| [[PendingAsyncDependencies]] | 0 | 0 |
最后，A 完成执行。当这发生时，会再次调用
|
字段
|
A |
|---|---|
| [[DFSAncestorIndex]] | 0 |
| [[Status]] | |
| [[AsyncEvaluationOrder]] | |
| [[AsyncParentModules]] | « » |
| [[PendingAsyncDependencies]] | 0 |
或者，考虑一个失败情况，其中 C 执行失败，并在 B 完成执行之前返回错误。当这发生时，会调用
|
字段
|
A | C |
|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | ||
| [[AsyncParentModules]] | « » | « A » |
| [[PendingAsyncDependencies]] | 1（B） | 0 |
| [[EvaluationError]] | C 的求值错误 |
由于 C 会以 C 的错误在 A 上调用
|
字段
|
A |
|---|---|
| [[DFSAncestorIndex]] | 0 |
| [[Status]] | |
| [[AsyncEvaluationOrder]] | |
| [[AsyncParentModules]] | « » |
| [[PendingAsyncDependencies]] | 0 |
| [[EvaluationError]] | C 的 |
然后，B 完成执行且没有错误。当这发生时，会再次调用
|
字段
|
A | B |
|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | 4 | 1 |
| [[AsyncParentModules]] | « » | « A » |
| [[PendingAsyncDependencies]] | 0 | 0 |
| [[EvaluationError]] | C 的 |
16.2.1.7 Source Text Module Record
Source Text Module Record 用于表示关于从 ECMAScript 源文本（
除了
| 字段名 | 值类型 | 含义 |
|---|---|---|
| [[ECMAScriptCode]] |
a |
使用 |
| [[Context]] |
an |
与此模块关联的执行上下文。直到模块环境被初始化之前，它都是 |
| [[ImportMeta]] |
an Object or |
通过 import.meta 元属性暴露的对象。直到 ECMAScript 代码访问它之前，它都是 |
| [[ImportEntries]] |
a |
从此模块代码派生出的 |
| [[LocalExportEntries]] |
a |
从此模块代码派生出的 |
| [[IndirectExportEntries]] |
a |
从此模块代码派生出的 export * as namespace 声明的导出。
|
| [[StarExportEntries]] |
a |
从此模块代码派生出的 export * 声明，但不包括 export * as namespace 声明。
|
ImportEntry Record 是摘要化关于单个声明式导入的信息的
| 字段名 | 值类型 | 含义 |
|---|---|---|
| [[ModuleRequest]] |
a |
表示 |
| [[ImportName]] |
a String or |
所需绑定由 [[ModuleRequest]] 标识的模块导出时使用的名称。值 |
| [[LocalName]] | a String | 在导入模块内部本地访问导入值时使用的名称。 |
| Import 语句形式 | [[ModuleRequest]] | [[ImportName]] | [[LocalName]] |
|---|---|---|---|
import v from "mod";
|
|
|
|
import * as ns from "mod";
|
|
|
|
import {x} from "mod";
|
|
|
|
import {x as v} from "mod";
|
|
|
|
import "mod";
|
不会创建 |
||
ExportEntry Record 是摘要化关于单个声明式导出的信息的
| 字段名 | 值类型 | 含义 |
|---|---|---|
| [[ExportName]] |
a String or |
此绑定被此模块导出时使用的名称。 |
| [[ModuleRequest]] |
a |
表示 |
| [[ImportName]] |
a String, |
所需绑定由 [[ModuleRequest]] 标识的模块导出时使用的名称。如果 export * as ns from "mod" 声明。export * from "mod" 声明。
|
| [[LocalName]] |
a String or |
在导入模块内部本地访问被导出值时使用的名称。如果被导出的值不能从模块内部本地访问，则为 |
| Export 语句形式 | [[ExportName]] | [[ModuleRequest]] | [[ImportName]] | [[LocalName]] |
|---|---|---|---|---|
export var v;
|
|
|
|
|
export default function f() {}
|
|
|
|
|
export default function () {}
|
|
|
|
|
export default 42;
|
|
|
|
|
export {x};
|
|
|
|
|
export {v as x};
|
|
|
|
|
export {x} from "mod";
|
|
|
|
|
export {v as x} from "mod";
|
|
|
|
|
export * from "mod";
|
|
|
|
|
export * as ns from "mod";
|
|
|
|
|
以下定义指定
16.2.1.7.1 ParseModule ( sourceText, realm, hostDefined )
The abstract operation ParseModule takes arguments sourceText (a String or a sequence of Unicode code points), realm (a
- 令 body 为
ParseText (sourceText,Module )。 - 如果 body 是错误
List ，则返回 body。 - 令 requestedModules 为 body 的
ModuleRequests 。 - 令 importEntries 为 body 的
ImportEntries 。 - 令 importedBoundNames 为
ImportedLocalNames (importEntries)。 - 令 indirectExportEntries 为一个新的空
List 。 - 令 localExportEntries 为一个新的空
List 。 - 令 starExportEntries 为一个新的空
List 。 - 令 exportEntries 为 body 的
ExportEntries 。 - 对 exportEntries 的每个
ExportEntry Record exportEntry，执行：- 如果 exportEntry.[[ModuleRequest]] 为
null ，则- 如果 importedBoundNames 不
包含 exportEntry.[[LocalName]]，则- 将 exportEntry 追加到 localExportEntries。
- 否则，
- 注：当导出最初从另一个模块导入的绑定或命名空间对象时，会重写
ExportEntry Record ，使其匹配该绑定或命名空间对象若直接从原始模块重新导出、而不是先导入再导出时所具有的形式。这允许通过export * from以同一名称两次导出同一绑定或命名空间所产生的冲突被忽略，而不是在Source Text Module Records 的 ResolveExport 具体方法 的步骤9.e.iii 中被视为歧义。 - 令 importEntry 为 importEntries 中 [[LocalName]] 为 exportEntry.[[LocalName]] 的元素。
- 将
ExportEntry Record { [[ModuleRequest]]: importEntry.[[ModuleRequest]], [[ImportName]]: importEntry.[[ImportName]], [[LocalName]]:null , [[ExportName]]: exportEntry.[[ExportName]] } 追加到 indirectExportEntries。
- 注：当导出最初从另一个模块导入的绑定或命名空间对象时，会重写
- 如果 importedBoundNames 不
- 否则，如果 exportEntry.[[ImportName]] 为
all-but-default ，则- 断言：exportEntry.[[ExportName]] 为
null 。 - 将 exportEntry 追加到 starExportEntries。
- 断言：exportEntry.[[ExportName]] 为
- 否则，
- 将 exportEntry 追加到 indirectExportEntries。
- 如果 exportEntry.[[ModuleRequest]] 为
- 令 async 为 body
Contains await。 - 返回
Source Text Module Record { [[Realm]]: realm, [[Environment]]:empty , [[Namespace]]:empty , [[CycleRoot]]:empty , [[HasTLA]]: async, [[AsyncEvaluationOrder]]:unset , [[TopLevelCapability]]:empty , [[AsyncParentModules]]: « », [[PendingAsyncDependencies]]:empty , [[Status]]:new , [[EvaluationError]]:empty , [[HostDefined]]: hostDefined, [[ECMAScriptCode]]: body, [[Context]]:empty , [[ImportMeta]]:empty , [[RequestedModules]]: requestedModules, [[LoadedModules]]: « », [[ImportEntries]]: importEntries, [[LocalExportEntries]]: localExportEntries, [[IndirectExportEntries]]: indirectExportEntries, [[StarExportEntries]]: starExportEntries, [[DFSAncestorIndex]]:empty }。
实现可以在对模块源文本求值 ParseModule 之前解析模块源文本并分析其
16.2.1.7.2 Module Record 抽象方法的实现
以下是
16.2.1.7.2.1 GetExportedNames ( [ exportStarSet ] )
The
- 断言：module.[[Status]] 不是
new 。 - 如果 exportStarSet 不存在，则将 exportStarSet 设为一个新的空
List 。 - 如果 exportStarSet
包含 module，则- 断言：我们已到达
export *循环的起点。 - 返回一个新的空
List 。
- 断言：我们已到达
- 将 module 追加到 exportStarSet。
- 令 exportedNames 为一个新的空
List 。 - 对 module.[[LocalExportEntries]] 的每个
ExportEntry Record exportEntry，执行：- 断言：module 为此导出提供直接绑定。
- 断言：exportEntry.[[ExportName]] 不是
null 。 - 将 exportEntry.[[ExportName]] 追加到 exportedNames。
- 对 module.[[IndirectExportEntries]] 的每个
ExportEntry Record exportEntry，执行：- 断言：module 为此导入一个特定绑定。
- 断言：exportEntry.[[ExportName]] 不是
null 。 - 将 exportEntry.[[ExportName]] 追加到 exportedNames。
- 对 module.[[StarExportEntries]] 的每个
ExportEntry Record exportEntry，执行：- 断言：exportEntry.[[ModuleRequest]] 不是
null 。 - 令 requestedModule 为
GetImportedModule (module, exportEntry.[[ModuleRequest]])。 - 令 starNames 为 requestedModule.
GetExportedNames (exportStarSet)。 - 对 starNames 的每个元素 name，执行：
- 如果 name 不是
"default" ，则- 如果 exportedNames 不
包含 name，则- 将 name 追加到 exportedNames。
- 如果 exportedNames 不
- 如果 name 不是
- 断言：exportEntry.[[ModuleRequest]] 不是
- 返回 exportedNames。
16.2.1.7.2.2 ResolveExport ( exportName [ , resolveSet ] )
The
如果找到定义模块，则返回
It performs the following steps when called:
- 断言：module.[[Status]] 不是
new 。 - 如果 resolveSet 不存在，则将 resolveSet 设为一个新的空
List 。 - 对 resolveSet 的每个
Record { [[Module]], [[ExportName]] } record，执行：- 如果 module 和 record.[[Module]] 是同一个
Module Record ，且 exportName 是 record.[[ExportName]]，则- 断言：这是一个循环导入请求。
- 返回
null 。
- 如果 module 和 record.[[Module]] 是同一个
- 将
Record { [[Module]]: module, [[ExportName]]: exportName } 追加到 resolveSet。 - 对 module.[[LocalExportEntries]] 的每个
ExportEntry Record exportEntry，执行：- 如果 exportEntry.[[ExportName]] 是 exportName，则
- 断言：module 为此导出提供直接绑定。
- 返回
ResolvedBinding Record { [[Module]]: module, [[BindingName]]: exportEntry.[[LocalName]] }。
- 如果 exportEntry.[[ExportName]] 是 exportName，则
- 对 module.[[IndirectExportEntries]] 的每个
ExportEntry Record exportEntry，执行：- 如果 exportEntry.[[ExportName]] 是 exportName，则
- 断言：exportEntry.[[ModuleRequest]] 不是
null 。 - 令 importedModule 为
GetImportedModule (module, exportEntry.[[ModuleRequest]])。 - 如果 exportEntry.[[ImportName]] 为
namespace ，则- 断言：module 不为此导出提供直接绑定。
- 返回
ResolvedBinding Record { [[Module]]: importedModule, [[BindingName]]:namespace }。
- 断言：module 为此导入一个特定绑定。
- 断言：exportEntry.[[ImportName]] 是一个 String。
- 返回 importedModule.
ResolveExport (exportEntry.[[ImportName]], resolveSet)。
- 断言：exportEntry.[[ModuleRequest]] 不是
- 如果 exportEntry.[[ExportName]] 是 exportName，则
- 如果 exportName 是
"default" ，则- 断言：此模块未显式定义
default导出。 - 返回
null 。 - 注：
default导出不能由export * from "mod"声明提供。
- 断言：此模块未显式定义
- 令 starResolution 为
null 。 - 对 module.[[StarExportEntries]] 的每个
ExportEntry Record exportEntry，执行：- 断言：exportEntry.[[ModuleRequest]] 不是
null 。 - 令 importedModule 为
GetImportedModule (module, exportEntry.[[ModuleRequest]])。 - 令 resolution 为 importedModule.
ResolveExport (exportName, resolveSet)。 - 如果 resolution 为
ambiguous ，则返回ambiguous 。 - 如果 resolution 不是
null ，则- 断言：resolution 是一个
ResolvedBinding Record 。 - 如果 starResolution 为
null ，则- 将 starResolution 设为 resolution。
- 否则，
- 断言：存在多个
包含 所请求名称的*导出。 - 如果 resolution.[[Module]] 和 starResolution.[[Module]] 不是同一个
Module Record ，则返回ambiguous 。 - 如果 resolution.[[BindingName]] 不是 starResolution.[[BindingName]]，则返回
ambiguous 。
- 断言：存在多个
- 断言：resolution 是一个
- 断言：exportEntry.[[ModuleRequest]] 不是
- 返回 starResolution。
16.2.1.7.3 Cyclic Module Record 抽象方法的实现
以下是
16.2.1.7.3.1 InitializeEnvironment ( )
The
- 对 module.[[IndirectExportEntries]] 的每个
ExportEntry Record exportEntry，执行：- 断言：exportEntry.[[ExportName]] 不是
null 。 - 令 resolution 为 module.
ResolveExport (exportEntry.[[ExportName]])。 - 如果 resolution 为
null 或ambiguous ，则抛出一个SyntaxError 异常。 - 断言：resolution 是一个
ResolvedBinding Record 。
- 断言：exportEntry.[[ExportName]] 不是
- 断言：来自 module 的所有具名导出都是可解析的。
- 令 realm 为 module.[[Realm]]。
- 断言：realm 不是
undefined 。 - 令 envRecord 为
NewModuleEnvironment (realm.[[GlobalEnv]])。 - 将 module.[[Environment]] 设为 envRecord。
- 对 module.[[ImportEntries]] 的每个
ImportEntry Record importEntry，执行：- 令 importedModule 为
GetImportedModule (module, importEntry.[[ModuleRequest]])。 - 如果 importEntry.[[ImportName]] 为
namespace ，则- 令 namespace 为
GetModuleNamespace (importedModule)。 - 执行 ! envRecord.
CreateImmutableBinding (importEntry.[[LocalName]],true )。 - 执行 ! envRecord.
InitializeBinding (importEntry.[[LocalName]], namespace)。
- 令 namespace 为
- 否则，
- 断言：importEntry.[[ImportName]] 是一个 String。
- 令 resolution 为 importedModule.
ResolveExport (importEntry.[[ImportName]])。 - 如果 resolution 为
null 或ambiguous ，则抛出一个SyntaxError 异常。 - 如果 resolution.[[BindingName]] 为
namespace ，则- 令 namespace 为
GetModuleNamespace (resolution.[[Module]])。 - 执行 ! envRecord.
CreateImmutableBinding (importEntry.[[LocalName]],true )。 - 执行 ! envRecord.
InitializeBinding (importEntry.[[LocalName]], namespace)。
- 令 namespace 为
- 否则，
- 执行
CreateImportBinding (envRecord, importEntry.[[LocalName]], resolution.[[Module]], resolution.[[BindingName]])。
- 执行
- 令 importedModule 为
- 令 moduleContext 为一个新的
ECMAScript 代码执行上下文 。 - 将 moduleContext 的 Function 设为
null 。 - 断言：module.[[Realm]] 不是
undefined 。 - 将 moduleContext 的
Realm 设为 module.[[Realm]]。 - 将 moduleContext 的 ScriptOrModule 设为 module。
- 将 moduleContext 的 VariableEnvironment 设为 module.[[Environment]]。
- 将 moduleContext 的 LexicalEnvironment 设为 module.[[Environment]]。
- 将 moduleContext 的 PrivateEnvironment 设为
null 。 - 将 module.[[Context]] 设为 moduleContext。
- 将 moduleContext 推入执行上下文栈；moduleContext 现在是正在运行的执行上下文。
- 令 code 为 module.[[ECMAScriptCode]]。
- 令 variableDecls 为 code 的
VarScopedDeclarations 。 - 令 declaredVariableNames 为一个新的空
List 。 - 对 variableDecls 的每个元素 variableDecl，执行：
- 对 variableDecl 的
BoundNames 的每个元素 name，执行：- 如果 declaredVariableNames 不
包含 name，则- 执行 ! envRecord.
CreateMutableBinding (name,false )。 - 执行 ! envRecord.
InitializeBinding (name,undefined )。 - 将 name 追加到 declaredVariableNames。
- 执行 ! envRecord.
- 如果 declaredVariableNames 不
- 对 variableDecl 的
- 令 lexicalDecls 为 code 的
LexicallyScopedDeclarations 。 - 令 privateEnv 为
null 。 - 对 lexicalDecls 的每个元素 lexicalDecl，执行：
- 对 lexicalDecl 的
BoundNames 的每个元素 name，执行：- 如果 lexicalDecl 的
IsConstantDeclaration 为true ，则- 执行 ! envRecord.
CreateImmutableBinding (name,true )。
- 执行 ! envRecord.
- 否则，
- 执行 ! envRecord.
CreateMutableBinding (name,false )。
- 执行 ! envRecord.
- 如果 lexicalDecl 是
FunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 或AsyncGeneratorDeclaration ，则- 令 funcObj 为使用参数 envRecord 和 privateEnv 对 lexicalDecl 执行
InstantiateFunctionObject 的结果。 - 执行 ! envRecord.
InitializeBinding (name, funcObj)。
- 令 funcObj 为使用参数 envRecord 和 privateEnv 对 lexicalDecl 执行
- 如果 lexicalDecl 的
- 对 lexicalDecl 的
- 从执行上下文栈中移除 moduleContext。
- 返回
unused 。
16.2.1.7.3.2 ExecuteModule ( [ capability ] )
The
- 断言：module 已被链接，并且其模块环境中的声明已被实例化。
- 令 moduleContext 为 module.[[Context]]。
- 如果 module.[[HasTLA]] 是
false ，则- 断言：capability 不存在。
- 令 env 为 module.[[Environment]]。
- 挂起运行中执行上下文。
- 将 moduleContext 推入执行上下文栈；moduleContext 现在是运行中执行上下文。
- 令 result 为 module.[[ECMAScriptCode]] 的求值的
Completion 。 - 将 result 设置为
Completion (DisposeResources (env.[[DisposableResourceStack]], result))。 - 挂起 moduleContext，并将其从执行上下文栈中移除。
- 恢复当前位于执行上下文栈顶部的上下文作为运行中执行上下文。
- 如果 result 是突兀完成，则
- 返回 ? result。
- 否则，
- 断言：capability 是 PromiseCapability 记录。
- 执行
AsyncBlockStart (capability, module.[[ECMAScriptCode]], moduleContext)。
- 返回
unused 。
16.2.1.8 Synthetic Module Record
Synthetic Module Record 用于表示由规范定义的模块相关信息。其导出名称在创建时静态定义，而其对应值可以随时间通过
除了
| 字段名 | 值类型 | 含义 |
|---|---|---|
| [[ExportNames]] | a |
模块的导出名称。此列表不 |
| [[EvaluationSteps]] | an |
在求值模块时要执行的初始化逻辑，以 |
16.2.1.8.1 CreateDefaultExportSyntheticModule ( defaultExport )
The abstract operation CreateDefaultExportSyntheticModule takes argument defaultExport (an ECMAScript language value) and returns a
- 令 realm 为
当前 Realm Record 。 - 令 setDefaultExport 为一个新的
Abstract Closure ，它具有参数 (module)、捕获 defaultExport，并在被调用时执行以下步骤：- 执行
SetSyntheticModuleExport (module,"default" , defaultExport)。 - 返回
NormalCompletion (unused )。
- 执行
- 返回
Synthetic Module Record { [[Realm]]: realm, [[Environment]]:empty , [[Namespace]]:empty , [[HostDefined]]:undefined , [[ExportNames]]: «"default" », [[EvaluationSteps]]: setDefaultExport }。
16.2.1.8.2 ParseJSONModule ( source )
The abstract operation ParseJSONModule takes argument source (a String) and returns either a normal completion containing a
- 令 parseResult 为 ?
ParseJSON (source)。 - 返回
CreateDefaultExportSyntheticModule (parseResult.[[Value]])。
16.2.1.8.3 SetSyntheticModuleExport ( module, exportName, exportValue )
The abstract operation SetSyntheticModuleExport takes arguments module (a
- 断言：module.[[ExportNames]]
包含 exportName。 - 令 envRecord 为 module.[[Environment]]。
- 断言：envRecord 不是
empty 。 - 执行 ! envRecord.
SetMutableBinding (exportName, exportValue,true )。 - 返回
unused 。
16.2.1.8.4 Module Record 抽象方法的实现
以下是
16.2.1.8.4.1 LoadRequestedModules ( [ hostDefined ] )
The
- 注：此
LoadRequestedModules 的实现不使用 hostDefined。 - 返回 !
PromiseResolve (%Promise% ,undefined )。
16.2.1.8.4.2 GetExportedNames ( [ exportStarSet ] )
The
- 注：此
GetExportedNames 的实现不使用 exportStarSet。 - 返回 module.[[ExportNames]]。
16.2.1.8.4.3 ResolveExport ( exportName [ , resolveSet ] )
The
- 注：此
ResolveExport 的实现不使用 resolveSet。 - 如果 module.[[ExportNames]] 不
包含 exportName，则返回null 。 - 返回
ResolvedBinding Record { [[Module]]: module, [[BindingName]]: exportName }。
16.2.1.8.4.4 Link ( )
The
- 令 realm 为 module.[[Realm]]。
- 令 envRecord 为
NewModuleEnvironment (realm.[[GlobalEnv]])。 - 将 module.[[Environment]] 设置为 envRecord。
- 对 module.[[ExportNames]] 的每个 String exportName，执行：
- 执行 ! envRecord.
CreateMutableBinding (exportName,false )。 - 执行 ! envRecord.
InitializeBinding (exportName,undefined )。
- 执行 ! envRecord.
- 返回
NormalCompletion (unused )。
16.2.1.8.4.5 Evaluate ( )
The
- 令 moduleContext 为新的
ECMAScript 代码执行上下文 。 - 将 moduleContext 的 Function 设置为
null 。 - 将 moduleContext 的
Realm 设置为 module.[[Realm]]。 - 将 moduleContext 的 ScriptOrModule 设置为 module。
- 将 moduleContext 的 VariableEnvironment 设置为 module.[[Environment]]。
- 将 moduleContext 的 LexicalEnvironment 设置为 module.[[Environment]]。
- 挂起运行中的执行上下文。
- 将 moduleContext 压入执行上下文栈；moduleContext 现在是运行中的执行上下文。
- 令 steps 为 module.[[EvaluationSteps]]。
- 令 result 为
Completion (steps(module))。 - 挂起 moduleContext 并将其从执行上下文栈中移除。
- 恢复当前位于执行上下文栈顶部的上下文作为运行中的执行上下文。
- 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 IfAbruptRejectPromise (result, promiseCapability)。- 执行 !
Call (promiseCapability.[[Resolve]],undefined , «undefined »)。 - 返回 promiseCapability.[[Promise]]。
16.2.1.9 GetImportedModule ( referrer, request )
The abstract operation GetImportedModule takes arguments referrer (a
- 令 records 为一个
List ，它由 referrer.[[LoadedModules]] 的每个LoadedModuleRequest Record r 组成，且ModuleRequestsEqual (r, request) 是true 。 - 断言：records 恰好有一个元素，因为在调用此
抽象操作 之前，LoadRequestedModules 已经在 referrer 上成功完成。 - 令 record 为 records 的唯一元素。
- 返回 record.[[Module]]。
16.2.1.10 HostLoadImportedModule ( referrer, moduleRequest, hostDefined, payload )
The host-defined abstract operation HostLoadImportedModule takes arguments referrer (a
referrer 可以是
<button type="button" onclick="import('./foo.mjs')">Click me</button>则在 import()
HostLoadImportedModule 的实现必须符合以下要求：
-
宿主环境 必须执行FinishLoadingImportedModule (referrer, moduleRequest, payload, result)，其中 result 要么是包含 已加载Module Record 的 normal completion，要么是 throw completion，并且可以同步或异步执行。 -
如果此操作以两个 (referrer, moduleRequest) pair 多次调用，且满足：
- 第一个 referrer 与第二个 referrer 相同；
ModuleRequestsEqual (第一个 moduleRequest, 第二个 moduleRequest) 是true ；
并且它执行
FinishLoadingImportedModule (referrer, moduleRequest, payload, result)，其中 result 是 normal completion，则它每次都必须用相同的 result 执行FinishLoadingImportedModule (referrer, moduleRequest, payload, result)。 -
如果 moduleRequest.[[Attributes]] 有一个条目 entry，使得 entry.[[Key]] 是
"type" 且 entry.[[Value]] 是"json" ，则当宿主环境 执行FinishLoadingImportedModule (referrer, moduleRequest, payload, result) 时，result 必须要么是调用ParseJSONModule 返回的Completion Record ，要么是 throw completion。 -
该操作必须把 payload 视为 opaque 值，并将其传递给
FinishLoadingImportedModule 。
实际执行的过程由
16.2.1.11 FinishLoadingImportedModule ( referrer, moduleRequest, payload, result )
The abstract operation FinishLoadingImportedModule takes arguments referrer (a
- 如果 result 是 normal completion，则
- 如果 referrer.[[LoadedModules]]
包含 一个LoadedModuleRequest Record record，使得ModuleRequestsEqual (record, moduleRequest) 是true ，则- 断言：record.[[Module]] 和 result.[[Value]] 是同一个
Module Record 。
- 断言：record.[[Module]] 和 result.[[Value]] 是同一个
- 否则，
- 将
LoadedModuleRequest Record { [[Specifier]]: moduleRequest.[[Specifier]], [[Attributes]]: moduleRequest.[[Attributes]], [[Module]]: result.[[Value]] } 追加到 referrer.[[LoadedModules]]。
- 将
- 如果 referrer.[[LoadedModules]]
- 如果 payload 是
GraphLoadingState Record ，则- 执行
ContinueModuleLoading (payload, result)。
- 执行
- 否则，
- 执行
ContinueDynamicImport (payload, result)。
- 执行
- 返回
unused 。
16.2.1.12 AllImportAttributesSupported ( attrs )
The abstract operation AllImportAttributesSupported takes argument attrs (a
- 令 supported 为
HostGetSupportedImportAttributes ()。 - 对 attrs 的每个
ImportAttribute Record attr，执行：- 如果 supported 不
包含 attr.[[Key]]，则返回false 。
- 如果 supported 不
- 返回
true 。
16.2.1.12.1 HostGetSupportedImportAttributes ( )
The host-defined abstract operation HostGetSupportedImportAttributes takes no arguments and returns a
HostGetSupportedImportAttributes 的实现必须符合以下要求：
HostGetSupportedImportAttributes 的默认实现是返回新的空
16.2.1.13 GetModuleNamespace ( module )
The abstract operation GetModuleNamespace takes argument module (an instance of a concrete subclass of
- 断言：如果 module 是
Cyclic Module Record ，则 module.[[Status]] 不是new 或unlinked 。 - 令 namespace 为 module.[[Namespace]]。
- 如果 namespace 是
empty ，则- 令 exportedNames 为 module.
GetExportedNames ()。 - 令 unambiguousNames 为新的空
List 。 - 对 exportedNames 的每个元素 name，执行：
- 令 resolution 为 module.
ResolveExport (name)。 - 如果 resolution 是
ResolvedBinding Record ，则将 name 追加到 unambiguousNames。
- 令 resolution 为 module.
- 将 namespace 设置为
ModuleNamespaceCreate (module, unambiguousNames)。
- 令 exportedNames 为 module.
- 返回 namespace。
GetModuleNamespace 永远不会抛出。相反，无法解析的名称只是在此时从 namespace 中排除。它们稍后会导致真正的链接错误，除非它们全都是未在任何地方被显式请求的 ambiguous 星号导出。
16.2.1.14 Runtime Semantics: Evaluation
- 返回
undefined 。
- 令 result 为
Completion (ModuleItemList 的Evaluation )。 - 如果 result 是 normal completion 且 result.[[Value]] 是
empty ，则- 返回
undefined 。
- 返回
- 返回 ? result。
- 令 sl 为 ?
ModuleItemList 的Evaluation 。 - 令 s 为
Completion (ModuleItem 的Evaluation )。 - 返回 ?
UpdateEmpty (s, sl)。
- 返回
empty 。
16.2.2 导入
语法
16.2.2.1 Static Semantics: 早期错误
-
如果
ImportDeclaration 的BoundNames 包含 任何重复项，则为语法错误。
-
如果
WithClause 的WithClauseToAttributes 有两个不同的条目 a 和 b，使得 a.[[Key]] 是 b.[[Key]]，则为语法错误。
16.2.2.2 Static Semantics: ImportEntries
The syntax-directed operation ImportEntries takes no arguments and returns a
- 返回新的空
List 。
- 令 entries1 为
ModuleItemList 的ImportEntries 。 - 令 entries2 为
ModuleItem 的ImportEntries 。 - 返回 entries1 和 entries2 的
列表连接 。
- 返回新的空
List 。
- 令 module 为
ImportDeclaration 的ModuleRequests 的唯一元素。 - 返回以 module 为实参执行
ImportClause 的ImportEntriesForModule 。
- 返回新的空
List 。
16.2.2.3 Static Semantics: ImportEntriesForModule
The syntax-directed operation ImportEntriesForModule takes argument module (a
- 令 entries1 为以 module 为实参执行
ImportedDefaultBinding 的ImportEntriesForModule 。 - 令 entries2 为以 module 为实参执行
NameSpaceImport 的ImportEntriesForModule 。 - 返回 entries1 和 entries2 的
列表连接 。
- 令 entries1 为以 module 为实参执行
ImportedDefaultBinding 的ImportEntriesForModule 。 - 令 entries2 为以 module 为实参执行
NamedImports 的ImportEntriesForModule 。 - 返回 entries1 和 entries2 的
列表连接 。
- 令 localName 为
ImportedBinding 的BoundNames 的唯一元素。 - 令 defaultEntry 为
ImportEntry Record { [[ModuleRequest]]: module, [[ImportName]]:"default" , [[LocalName]]: localName }。 - 返回 « defaultEntry »。
- 令 localName 为
ImportedBinding 的StringValue 。 - 令 entry 为
ImportEntry Record { [[ModuleRequest]]: module, [[ImportName]]:namespace , [[LocalName]]: localName }。 - 返回 « entry »。
- 返回新的空
List 。
- 令 specs1 为以 module 为实参执行
ImportsList 的ImportEntriesForModule 。 - 令 specs2 为以 module 为实参执行
ImportSpecifier 的ImportEntriesForModule 。 - 返回 specs1 和 specs2 的
列表连接 。
- 令 localName 为
ImportedBinding 的BoundNames 的唯一元素。 - 令 entry 为
ImportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: localName, [[LocalName]]: localName }。 - 返回 « entry »。
- 令 importName 为
ModuleExportName 的StringValue 。 - 令 localName 为
ImportedBinding 的StringValue 。 - 令 entry 为
ImportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: importName, [[LocalName]]: localName }。 - 返回 « entry »。
16.2.2.4 Static Semantics: WithClauseToAttributes
The syntax-directed operation WithClauseToAttributes takes no arguments and returns a
- 返回新的空
List 。
- 令 attrs 为
WithEntries 的WithClauseToAttributes 。 - 根据 attrs 的 [[Key]] 字段的字典序对 attrs 排序，把每个此类字段的值视为 UTF-16 码元值序列。注：此排序唯一可观察之处在于，
宿主 被禁止基于枚举属性的顺序来改变行为。 - 返回 attrs。
- 令 key 为
AttributeKey 的PropName 。 - 令 entry 为
ImportAttribute Record { [[Key]]: key, [[Value]]:StringLiteral 的SV }。 - 返回 « entry »。
- 令 key 为
AttributeKey 的PropName 。 - 令 entry 为
ImportAttribute Record { [[Key]]: key, [[Value]]:StringLiteral 的SV }。 - 令 rest 为
WithEntries 的WithClauseToAttributes 。 - 返回 « entry » 和 rest 的
列表连接 。
16.2.3 导出
语法
16.2.3.1 Static Semantics: 早期错误
-
如果
NamedExports 的ReferencedBindings 包含 任何StringLiteral ，则为语法错误。 -
对
NamedExports 的ReferencedBindings 中的每个IdentifierName n：如果 n 的StringValue 是ReservedWord ，或 n 的StringValue 是"implements" 、"interface" 、"let" 、"package" 、"private" 、"protected" 、"public" 或"static" 之一，则为语法错误。
上述规则意味着
16.2.3.2 Static Semantics: ExportedBindings
The syntax-directed operation ExportedBindings takes no arguments and returns a
ExportedBindings 是与
It is defined piecewise over the following productions:
- 令 names1 为
ModuleItemList 的ExportedBindings 。 - 令 names2 为
ModuleItem 的ExportedBindings 。 - 返回 names1 和 names2 的
列表连接 。
- 返回新的空
List 。
- 返回新的空
List 。
- 返回
NamedExports 的ExportedBindings 。
- 返回
VariableStatement 的BoundNames 。
- 返回
Declaration 的BoundNames 。
- 返回此
ExportDeclaration 的BoundNames 。
- 返回新的空
List 。
- 令 names1 为
ExportsList 的ExportedBindings 。 - 令 names2 为
ExportSpecifier 的ExportedBindings 。 - 返回 names1 和 names2 的
列表连接 。
- 返回一个
List ，其唯一元素为ModuleExportName 的StringValue 。
- 返回一个
List ，其唯一元素为第一个ModuleExportName 的StringValue 。
16.2.3.3 Static Semantics: ExportedNames
The syntax-directed operation ExportedNames takes no arguments and returns a
ExportedNames 是外部可见名称，
It is defined piecewise over the following productions:
- 令 names1 为
ModuleItemList 的ExportedNames 。 - 令 names2 为
ModuleItem 的ExportedNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回新的空
List 。
- 返回新的空
List 。
- 返回一个
List ，其唯一元素为ModuleExportName 的StringValue 。
- 返回
NamedExports 的ExportedNames 。
- 返回
VariableStatement 的BoundNames 。
- 返回
Declaration 的BoundNames 。
- 返回 «
"default" »。
- 返回新的空
List 。
- 令 names1 为
ExportsList 的ExportedNames 。 - 令 names2 为
ExportSpecifier 的ExportedNames 。 - 返回 names1 和 names2 的
列表连接 。
- 返回一个
List ，其唯一元素为ModuleExportName 的StringValue 。
- 返回一个
List ，其唯一元素为第二个ModuleExportName 的StringValue 。
16.2.3.4 Static Semantics: ExportEntries
The syntax-directed operation ExportEntries takes no arguments and returns a
- 返回新的空
List 。
- 令 entries1 为
ModuleItemList 的ExportEntries 。 - 令 entries2 为
ModuleItem 的ExportEntries 。 - 返回 entries1 和 entries2 的
列表连接 。
- 返回新的空
List 。
- 令 module 为
ExportDeclaration 的ModuleRequests 的唯一元素。 - 返回以 module 为实参执行
ExportFromClause 的ExportEntriesForModule 。
- 返回以
null 为实参执行NamedExports 的ExportEntriesForModule 。
- 令 entries 为新的空
List 。 - 令 names 为
VariableStatement 的BoundNames 。 - 对 names 的每个元素 name，执行：
- 将
ExportEntry Record { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]: name, [[ExportName]]: name } 追加到 entries。
- 将
- 返回 entries。
- 令 entries 为新的空
List 。 - 令 names 为
Declaration 的BoundNames 。 - 对 names 的每个元素 name，执行：
- 将
ExportEntry Record { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]: name, [[ExportName]]: name } 追加到 entries。
- 将
- 返回 entries。
- 令 names 为
HoistableDeclaration 的BoundNames 。 - 令 localName 为 names 的唯一元素。
- 返回一个
List ，其唯一元素为新的ExportEntry Record { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]: localName, [[ExportName]]:"default" }。
- 令 names 为
ClassDeclaration 的BoundNames 。 - 令 localName 为 names 的唯一元素。
- 返回一个
List ，其唯一元素为新的ExportEntry Record { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]: localName, [[ExportName]]:"default" }。
- 令 entry 为
ExportEntry Record { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]:"*default*" , [[ExportName]]:"default" }。 - 返回 « entry »。
16.2.3.5 Static Semantics: ExportEntriesForModule
The syntax-directed operation ExportEntriesForModule takes argument module (a
- 令 entry 为
ExportEntry Record { [[ModuleRequest]]: module, [[ImportName]]:all-but-default , [[LocalName]]:null , [[ExportName]]:null }。 - 返回 « entry »。
- 令 exportName 为
ModuleExportName 的StringValue 。 - 令 entry 为
ExportEntry Record { [[ModuleRequest]]: module, [[ImportName]]:namespace , [[LocalName]]:null , [[ExportName]]: exportName }。 - 返回 « entry »。
- 返回新的空
List 。
- 令 specs1 为以 module 为实参执行
ExportsList 的ExportEntriesForModule 。 - 令 specs2 为以 module 为实参执行
ExportSpecifier 的ExportEntriesForModule 。 - 返回 specs1 和 specs2 的
列表连接 。
- 令 sourceName 为
ModuleExportName 的StringValue 。 - 如果 module 是
null ，则- 令 localName 为 sourceName。
- 令 importName 为
null 。
- 否则，
- 令 localName 为
null 。 - 令 importName 为 sourceName。
- 令 localName 为
- 返回一个
List ，其唯一元素为新的ExportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: importName, [[LocalName]]: localName, [[ExportName]]: sourceName }。
- 令 sourceName 为第一个
ModuleExportName 的StringValue 。 - 令 exportName 为第二个
ModuleExportName 的StringValue 。 - 如果 module 是
null ，则- 令 localName 为 sourceName。
- 令 importName 为
null 。
- 否则，
- 令 localName 为
null 。 - 令 importName 为 sourceName。
- 令 localName 为
- 返回一个
List ，其唯一元素为新的ExportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: importName, [[LocalName]]: localName, [[ExportName]]: exportName }。
16.2.3.6 Static Semantics: ReferencedBindings
The syntax-directed operation ReferencedBindings takes no arguments and returns a
- 返回新的空
List 。
- 令 names1 为
ExportsList 的ReferencedBindings 。 - 令 names2 为
ExportSpecifier 的ReferencedBindings 。 - 返回 names1 和 names2 的
列表连接 。
- 返回第一个
ModuleExportName 的ReferencedBindings 。
- 返回一个
List ，其唯一元素为IdentifierName 。
- 返回一个
List ，其唯一元素为StringLiteral 。
16.2.3.7 Runtime Semantics: Evaluation
- 返回
empty 。
- 返回 ?
VariableStatement 的Evaluation 。
- 返回 ?
Declaration 的Evaluation 。
- 返回 ?
HoistableDeclaration 的Evaluation 。
- 令 value 为 ?
ClassDeclaration 的BindingClassDeclarationEvaluation 。 - 令 className 为
ClassDeclaration 的BoundNames 的唯一元素。 - 如果 className 是
"*default*" ，则- 令 envRecord 为运行中执行上下文的 LexicalEnvironment。
- 执行 ?
InitializeBoundName ("*default*" , value, envRecord)。
- 返回
empty 。
- 如果
IsAnonymousFunctionDefinition (AssignmentExpression ) 是true ，则- 令 value 为以
"default" 为实参执行AssignmentExpression 的 ?NamedEvaluation 。
- 令 value 为以
- 否则，
- 令 rhs 为 ?
AssignmentExpression 的Evaluation 。 - 令 value 为 ?
GetValue (rhs)。
- 令 rhs 为 ?
- 令 envRecord 为运行中执行上下文的 LexicalEnvironment。
- 执行 ?
InitializeBoundName ("*default*" , value, envRecord)。 - 返回
empty 。
17 错误处理和语言扩展
实现必须在相关 ECMAScript 语言构造被求值时报告大多数错误。早期错误是可以在eval 时报告，并阻止该 eval 代码求值。所有不是
实现必须把本规范“Static Semantics:
即使编译器能够证明某个构造在任何情况下都无法不出错地执行，实现也不得把其他种类的错误当作
实现应按规定报告所有错误，但以下情况除外：
-
除
17.1 中所限制的情况外，宿主 或实现可以扩展Script 语法、Module 语法，以及正则表达式模式或标志语法。为允许这一点，所有允许抛出SyntaxError 的操作（例如调用eval、使用正则表达式字面量，或使用 Function 或 RegExp 构造器），在遇到对脚本语法或正则表达式模式或标志语法的宿主 定义扩展时，都允许展现宿主 定义行为，而不是抛出SyntaxError 。 -
除
17.1 中所限制的情况外，宿主 或实现可以提供本规范所描述之外的附加类型、值、对象、属性和函数。这可能导致某些构造（例如在全局作用域中查找变量）展现宿主 定义行为，而不是抛出错误（例如ReferenceError ）。
17.1 禁止的扩展
实现不得以下列方式扩展本规范：
-
使用严格模式代码中的句法构造器定义的 ECMAScript
函数对象 ，不得创建名为"caller" 或"arguments" 的自身属性。对于使用ArrowFunction 、MethodDefinition 、GeneratorDeclaration 、GeneratorExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、ClassDeclaration 、ClassExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 或AsyncArrowFunction 定义的函数对象 ，无论该定义是否包含 在严格模式代码中，也不得创建此类自身属性。内置函数、使用 Function 构造器创建的严格函数 、使用 Generator 构造器创建的生成器函数、使用 AsyncFunction 构造器创建的异步函数，以及使用bind方法创建的函数，也不得创建此类自身属性。 -
如果实现用名为
"caller" 的自身属性扩展任何函数对象 ，则使用 [[Get]] 或 [[GetOwnProperty]] 观察到的该属性的值不得是严格函数 对象。如果它是访问器属性 ，则作为该属性 [[Get]] 特性值的函数在被调用时绝不能返回严格函数 。 -
mapped 或 unmapped arguments 对象都不得创建名为
"caller" 的自身属性。 -
在 ECMA-402 中规定的内置方法（例如名为
toLocaleString的方法）的行为，不得以 ECMA-402 规定之外的方式扩展。 -
22.2.1 和B.1.2 中的 RegExp 模式文法，在存在 [UnicodeMode] 文法参数时，不得被扩展为把任何源字符 A-Z 或 a-z 识别为IdentityEscape 。[+UnicodeMode] -
句法文法不得以任何允许记号
:紧接在与BindingIdentifier 非终结符号匹配的源文本 之后的方式扩展。 -
处理严格模式代码时，实现不得放宽
12.9.3.1 的早期错误 规则。 -
TemplateEscapeSequence 不得被扩展为包含 12.9.4 中定义的LegacyOctalEscapeSequence 或NonOctalDecimalEscapeSequence 。 -
处理严格模式代码时，不得支持
B.3.1 、B.3.2 、B.3.3 和B.3.5 中定义的扩展。 -
按
Module 目标符号 解析时，不得支持B.1.1 中定义的词法文法扩展。 -
ImportCall 不得被扩展。
18 ECMAScript 标准内置对象
每当 ECMAScript
除非另有规定，可作为函数调用的内置对象是具有
许多内置对象是函数：它们可以用实参调用。其中一些还同时是构造器：它们是旨在与 new 运算符一起使用的函数。对于每个内置函数，本规范描述该函数所需的实参以及该new 表达式所返回的特定对象实例的属性。
除非特定函数的描述中另有规定，如果内置函数或构造器给定的实参数少于规定该函数所需的实参数，则该函数或构造器应表现得完全像已给定足够的附加实参一样，每个此类实参都是
除非特定函数的描述中另有规定，如果所描述的内置函数或构造器给定的实参数多于规定该函数所允许的实参数，则额外实参会由调用求值，然后被该函数忽略。但是，只要该行为不是仅仅以存在额外实参为前提而抛出
鼓励向内置函数集合添加附加能力的实现通过添加新函数，而不是向现有函数添加新参数来做到这一点。
除非另有规定，每个内置函数和每个内置构造器都具有 Function.prototype 的初始值（
除非另有规定，每个内置原型对象都具有 Object.prototype 的初始值（
如果本规范通过算法步骤定义内置构造器的行为，则这就是其在 [[Call]] 和 [[Construct]] 两种情况下的行为。如果此类算法需要区分这两种情况，它会检查 NewTarget 是否为
未被识别为构造器的内置
不是构造器的内置
本规范中定义的每个内置函数都是通过调用
每个内置
例如，作为
除非另有规定，内置
每个内置
对于
除非另有规定，内置
条款
条款
19 全局对象
全局对象：
- 在控制进入任何执行上下文之前创建。
- 没有 [[Construct]] 内部方法；它不能作为构造器与
new运算符一起使用。 - 没有 [[Call]] 内部方法；它不能作为函数调用。
- 具有一个 [[Prototype]] 内部槽，其值由
宿主 定义。 - 除了本规范中定义的属性之外，还可以具有
宿主 定义属性。这可以包括一个其值为全局对象自身的属性。
19.1 全局对象的值属性
19.1.1 globalThis
此属性具有特性 { [[Writable]]:
19.1.2 Infinity
此属性具有特性 { [[Writable]]:
19.1.3 NaN
此属性具有特性 { [[Writable]]:
19.1.4 undefined
此属性具有特性 { [[Writable]]:
19.2 全局对象的函数属性
19.2.1 eval ( source )
此函数是 %eval% 内在对象。
它在被调用时执行以下步骤：
- 返回 ?
PerformEval (source,false ,false )。
19.2.1.1 PerformEval ( source, strictCaller, direct )
The abstract operation PerformEval takes arguments source (an ECMAScript language value), strictCaller (a Boolean), and direct (a Boolean) and returns either a normal completion containing an ECMAScript language value or a throw completion. It performs the following steps when called:
- 断言：如果 direct 是
false ，则 strictCaller 也是false 。 - 如果 source 不是 String，则返回 source。
- 令 evalRealm 为
当前 Realm Record 。 - 注：在直接 eval 的情况下，evalRealm 是
eval调用者以及eval函数自身的realm 。 - 执行 ?
HostEnsureCanCompileStrings (evalRealm, « », source, direct)。 - 令 inFunc 为
false 。 - 令 inMethod 为
false 。 - 令 inDerivedCtor 为
false 。 - 令 inClassFieldInitializer 为
false 。 - 如果 direct 是
true ，则- 令 thisEnvRecord 为
GetThisEnvironment ()。 - 如果 thisEnvRecord 是
Function Environment Record ，则- 令 func 为 thisEnvRecord.[[FunctionObject]]。
- 将 inFunc 设置为
true 。 - 将 inMethod 设置为 thisEnvRecord.
HasSuperBinding ()。 - 如果 func.[[ConstructorKind]] 是
derived ，则将 inDerivedCtor 设置为true 。 - 令 classFieldInitializerName 为 func.[[ClassFieldInitializerName]]。
- 如果 classFieldInitializerName 不是
empty ，则将 inClassFieldInitializer 设置为true 。
- 令 thisEnvRecord 为
- 按
实现定义的 顺序执行以下子步骤，可能会交错执行解析和错误检测：- 令 script 为
ParseText (source,Script )。 - 如果 script 是错误列表，则抛出
SyntaxError 异常。 - 如果 script
Contains ScriptBody 是false ，则返回undefined 。 - 令 body 为 script 的
ScriptBody 。 - 如果 inFunc 是
false 且 bodyContains NewTarget ，则抛出SyntaxError 异常。 - 如果 inMethod 是
false 且 bodyContains SuperProperty ，则抛出SyntaxError 异常。 - 如果 inDerivedCtor 是
false 且 bodyContains SuperCall ，则抛出SyntaxError 异常。 - 如果 inClassFieldInitializer 是
true 且 body 的ContainsArguments 是true ，则抛出SyntaxError 异常。
- 令 script 为
- 如果 strictCaller 是
true ，则令 strictEval 为true 。 - 否则，令 strictEval 为 script 的
ScriptIsStrict 。 - 令 runningContext 为运行中的执行上下文。
- 注：如果 direct 是
true ，则 runningContext 将是执行直接 eval 的执行上下文。如果 direct 是false ，则 runningContext 将是eval函数调用的执行上下文。 - 如果 direct 是
true ，则- 令 lexicalEnv 为
NewDeclarativeEnvironment (runningContext 的 LexicalEnvironment)。 - 令 variableEnv 为 runningContext 的 VariableEnvironment。
- 令 privateEnv 为 runningContext 的 PrivateEnvironment。
- 令 lexicalEnv 为
- 否则，
- 令 lexicalEnv 为
NewDeclarativeEnvironment (evalRealm.[[GlobalEnv]])。 - 令 variableEnv 为 evalRealm.[[GlobalEnv]]。
- 令 privateEnv 为
null 。
- 令 lexicalEnv 为
- 如果 strictEval 是
true ，则将 variableEnv 设置为 lexicalEnv。 - 如果 runningContext 尚未挂起，则挂起 runningContext。
- 令 evalContext 为新的
ECMAScript 代码执行上下文 。 - 将 evalContext 的 Function 设置为
null 。 - 将 evalContext 的
Realm 设置为 evalRealm。 - 将 evalContext 的 ScriptOrModule 设置为 runningContext 的 ScriptOrModule。
- 将 evalContext 的 VariableEnvironment 设置为 variableEnv。
- 将 evalContext 的 LexicalEnvironment 设置为 lexicalEnv。
- 将 evalContext 的 PrivateEnvironment 设置为 privateEnv。
- 将 evalContext 压入执行上下文栈；evalContext 现在是运行中的执行上下文。
- 令 result 为
Completion (EvalDeclarationInstantiation (body, variableEnv, lexicalEnv, privateEnv, strictEval))。 - 如果 result 是 normal completion，则
- 将 result 设置为
Completion (body 的Evaluation )。
- 将 result 设置为
- 如果 result 是 normal completion 且 result.[[Value]] 是
empty ，则- 将 result 设置为
NormalCompletion (undefined )。
- 将 result 设置为
- 挂起 evalContext 并将其从执行上下文栈中移除。
- 恢复当前位于执行上下文栈顶部的上下文作为运行中的执行上下文。
- 返回 ? result。
如果调用 eval 的调用上下文代码或 eval 代码任一者是严格模式代码，则 eval 代码不能在调用上下文的变量环境中实例化变量或函数绑定。相反，此类绑定会在一个仅对 eval 代码可访问的新 VariableEnvironment 中实例化。由 let、const 或 class 声明引入的绑定总是在新的 LexicalEnvironment 中实例化。
19.2.1.2 HostEnsureCanCompileStrings ( calleeRealm, paramStrings, bodyString, direct )
The host-defined abstract operation HostEnsureCanCompileStrings takes arguments calleeRealm (a
paramStrings 表示在使用某个函数构造器时，会被连接在一起以构建参数列表的字符串。bodyString 表示函数体，或传给 eval 调用的字符串。
direct 表示该求值是否为直接 eval。
HostEnsureCanCompileStrings 的默认实现是返回
19.2.1.3 EvalDeclarationInstantiation ( body, variableEnv, lexicalEnv, privateEnv, strict )
The abstract operation EvalDeclarationInstantiation takes arguments body (a
- 令 variableNames 为 body 的
VarDeclaredNames 。 - 令 variableDecls 为 body 的
VarScopedDeclarations 。 - 如果 strict 为
false ，则- 如果 variableEnv 是一个
Global Environment Record ，则- 对 variableNames 的每个元素 name，执行：
- 如果
HasLexicalDeclaration (variableEnv, name) 为true ，则抛出一个SyntaxError 异常。 - 注：
eval不会创建会被全局词法声明遮蔽的全局 var 声明。
- 如果
- 对 variableNames 的每个元素 name，执行：
- 令 thisEnv 为 lexicalEnv。
- 断言：以下循环将会终止。
- 重复，直到 thisEnv 和 variableEnv 是同一个
Environment Record ，- 如果 thisEnv 不是
Object Environment Record ，则- 注：with 语句的环境不能
包含 任何词法声明，因此不需要检查 var/let 提升冲突。 - 对 variableNames 的每个元素 name，执行：
- 如果 ! thisEnv.
HasBinding (name) 为true ，则- 如果
宿主 是 Web 浏览器，或以其他方式支持Catch 块中的 VariableStatement ，则- 如果 thisEnv 不是
Catch 子句的Environment Record ，则抛出一个SyntaxError 异常。
- 如果 thisEnv 不是
- 否则，
- 抛出一个
SyntaxError 异常。
- 抛出一个
- 如果
- 注：直接 eval 不会把 var 声明提升到同名词法声明之上。
- 如果 ! thisEnv.
- 注：with 语句的环境不能
- 将 thisEnv 设为 thisEnv.[[OuterEnv]]。
- 如果 thisEnv 不是
- 如果 variableEnv 是一个
- 令 privateIdentifiers 为一个新的空
List 。 - 令 pointer 为 privateEnv。
- 重复，直到 pointer 为
null ，- 对 pointer.[[Names]] 的每个
Private Name binding，执行：- 如果 privateIdentifiers 不
包含 binding.[[Description]]，则将 binding.[[Description]] 追加到 privateIdentifiers。
- 如果 privateIdentifiers 不
- 将 pointer 设为 pointer.[[OuterPrivateEnvironment]]。
- 对 pointer.[[Names]] 的每个
- 如果以 privateIdentifiers 为参数对 body 执行
AllPrivateIdentifiersValid 的结果为false ，则抛出一个SyntaxError 异常。 - 令 funcsToInitialize 为一个新的空
List 。 - 令 declaredFuncNames 为一个新的空
List 。 - 对 variableDecls 的每个元素 variableDecl，按
List 的逆序执行：- 如果 variableDecl 不是
VariableDeclaration 、ForBinding 或BindingIdentifier 中的任一者，则- 断言：variableDecl 是
FunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 或AsyncGeneratorDeclaration 。 - 注：如果同一名称有多个函数声明，则使用最后一个声明。
- 令 funcName 为 variableDecl 的
BoundNames 的唯一元素。 - 如果 declaredFuncNames 不
包含 funcName，则- 如果 variableEnv 是一个
Global Environment Record ，则- 令 funcDefinable 为 ?
CanDeclareGlobalFunction (variableEnv, funcName)。 - 如果 funcDefinable 为
false ，则抛出一个TypeError 异常。
- 令 funcDefinable 为 ?
- 将 funcName 追加到 declaredFuncNames。
- 将 variableDecl 作为 funcsToInitialize 的第一个元素插入。
- 如果 variableEnv 是一个
- 断言：variableDecl 是
- 如果 variableDecl 不是
- 令 declaredVariableNames 为一个新的空
List 。 - 对 variableDecls 的每个元素 variableDecl，执行：
- 如果 variableDecl 是
VariableDeclaration 、ForBinding 或BindingIdentifier 中的任一者，则- 对 variableDecl 的
BoundNames 的每个 String name，执行：- 如果 declaredFuncNames 不
包含 name，则- 如果 variableEnv 是一个
Global Environment Record ，则- 令 variableDefinable 为 ?
CanDeclareGlobalVar (variableEnv, name)。 - 如果 variableDefinable 为
false ，则抛出一个TypeError 异常。
- 令 variableDefinable 为 ?
- 如果 declaredVariableNames 不
包含 name，则- 将 name 追加到 declaredVariableNames。
- 如果 variableEnv 是一个
- 如果 declaredFuncNames 不
- 对 variableDecl 的
- 如果 variableDecl 是
- 如果 strict 为
false ，且宿主 是 Web 浏览器，或以其他方式支持块级函数声明的 Web 遗留兼容性语义 ，则- 令 declaredFuncOrVariableNames 为 declaredFuncNames 和 declaredVariableNames 的
列表连接 。 - 对每个
FunctionDeclaration funcDecl，其直接包含 在任何Block 、CaseClause 或DefaultClause x 的StatementList 中，且 bodyContains x 为true ，执行：- 令 funcName 为 funcDecl 的
BindingIdentifier 的StringValue 。 - 如果将
FunctionDeclaration funcDecl 替换为以 funcName 作为BindingIdentifier 的VariableStatement 不会为 body 产生任何早期错误 ，则- 令 bindingExists 为
false 。 - 将 thisEnv 设为 lexicalEnv。
- 断言：以下循环将会终止。
- 重复，直到 thisEnv 为 variableEnv，
- 如果 thisEnv 不是
Object Environment Record ，则- 如果 ! thisEnv.
HasBinding (funcName) 为true ，则- 如果
宿主 是 Web 浏览器，或以其他方式支持Catch 块中的 VariableStatement ，则- 如果 thisEnv 不是
Catch 子句的Environment Record ，则将 bindingExists 设为true 。
- 如果 thisEnv 不是
- 否则，
- 将 bindingExists 设为
true 。
- 将 bindingExists 设为
- 如果
- 如果 ! thisEnv.
- 将 thisEnv 设为 thisEnv.[[OuterEnv]]。
- 如果 thisEnv 不是
- 如果 bindingExists 为
false 且 variableEnv 是一个Global Environment Record ，则- 如果
HasLexicalDeclaration (variableEnv, funcName) 为false ，则- 令 funcDefinable 为 ?
CanDeclareGlobalVar (variableEnv, funcName)。
- 令 funcDefinable 为 ?
- 否则，
- 令 funcDefinable 为
false 。
- 令 funcDefinable 为
- 如果
- 否则，
- 令 funcDefinable 为
true 。
- 令 funcDefinable 为
- 如果 bindingExists 为
false 且 funcDefinable 为true ，则- 如果 declaredFuncOrVariableNames 不
包含 funcName，则- 如果 variableEnv 是一个
Global Environment Record ，则- 执行 ?
CreateGlobalVarBinding (variableEnv, funcName,true )。
- 执行 ?
- 否则，
- 将 bindingExists 设为 ! variableEnv.
HasBinding (funcName)。 - 如果 bindingExists 为
false ，则- 执行 ! variableEnv.
CreateMutableBinding (funcName,true )。 - 执行 ! variableEnv.
InitializeBinding (funcName,undefined )。
- 执行 ! variableEnv.
- 将 bindingExists 设为 ! variableEnv.
- 将 funcName 追加到 declaredFuncOrVariableNames。
- 如果 variableEnv 是一个
- 当
FunctionDeclaration funcDecl 被求值时，执行以下步骤以取代15.2.6 中提供的FunctionDeclaration Evaluation 算法：- 令 globalEnv 为正在运行的执行上下文的 VariableEnvironment。
- 令 blockEnv 为正在运行的执行上下文的 LexicalEnvironment。
- 令 funcObj 为 ! blockEnv.
GetBindingValue (funcName,false )。 - 执行 ? globalEnv.
SetMutableBinding (funcName, funcObj,false )。 - 返回
unused 。
- 如果 declaredFuncOrVariableNames 不
- 令 bindingExists 为
- 令 funcName 为 funcDecl 的
- 令 declaredFuncOrVariableNames 为 declaredFuncNames 和 declaredVariableNames 的
- 注：除非 variableEnv 是
Global Environment Record 且全局对象 是Proxy 异质对象 ，否则在此算法步骤之后不会发生异常终止。 - 令 lexicalDecls 为 body 的
LexicallyScopedDeclarations 。 - 对 lexicalDecls 的每个元素 lexicalDecl，执行：
- 注：词法声明的名称仅在此处实例化，但不初始化。
- 对 lexicalDecl 的
BoundNames 的每个元素 name，执行：- 如果 lexicalDecl 的
IsConstantDeclaration 为true ，则- 执行 ? lexicalEnv.
CreateImmutableBinding (name,true )。
- 执行 ? lexicalEnv.
- 否则，
- 执行 ? lexicalEnv.
CreateMutableBinding (name,false )。
- 执行 ? lexicalEnv.
- 如果 lexicalDecl 的
- 对 funcsToInitialize 的每个
Parse Node funcDecl，执行：- 令 funcName 为 funcDecl 的
BoundNames 的唯一元素。 - 令 funcObj 为使用参数 lexicalEnv 和 privateEnv 对 funcDecl 执行
InstantiateFunctionObject 的结果。 - 如果 variableEnv 是一个
Global Environment Record ，则- 执行 ?
CreateGlobalFunctionBinding (variableEnv, funcName, funcObj,true )。
- 执行 ?
- 否则，
- 令 bindingExists 为 ! variableEnv.
HasBinding (funcName)。 - 如果 bindingExists 为
false ，则- 注：由于步骤
14 之前的验证，以下调用不能返回突然完成 。 - 执行 ! variableEnv.
CreateMutableBinding (funcName,true )。 - 执行 ! variableEnv.
InitializeBinding (funcName, funcObj)。
- 注：由于步骤
- 否则，
- 执行 ! variableEnv.
SetMutableBinding (funcName, funcObj,false )。
- 执行 ! variableEnv.
- 令 bindingExists 为 ! variableEnv.
- 令 funcName 为 funcDecl 的
- 对 declaredVariableNames 的每个 String variableName，执行：
- 如果 variableEnv 是一个
Global Environment Record ，则- 执行 ?
CreateGlobalVarBinding (variableEnv, variableName,true )。
- 执行 ?
- 否则，
- 令 bindingExists 为 ! variableEnv.
HasBinding (variableName)。 - 如果 bindingExists 为
false ，则- 注：由于步骤
14 之前的验证，以下调用不能返回突然完成 。 - 执行 ! variableEnv.
CreateMutableBinding (variableName,true )。 - 执行 ! variableEnv.
InitializeBinding (variableName,undefined )。
- 注：由于步骤
- 令 bindingExists 为 ! variableEnv.
- 如果 variableEnv 是一个
- 返回
unused 。
19.2.2 isFinite ( value )
此函数是 %isFinite% 内在对象。
它在被调用时执行以下步骤：
19.2.3 isNaN ( value )
此函数是 %isNaN% 内在对象。
它在被调用时执行以下步骤：
- 令 number 为 ?
ToNumber (value)。 - 如果 number 是
NaN ，则返回true 。 - 返回
false 。
ECMAScript 代码测试值 X 是否为 X !== X 的表达式。当且仅当 X 是
19.2.4 parseFloat ( string )
此函数通过把 string 实参的内容解释为十进制字面量来产生一个
它是 %parseFloat% 内在对象。
它在被调用时执行以下步骤：
- 令 inputString 为 ?
ToString (string)。 - 令 trimmedString 为 !
TrimString (inputString,start )。 - 令 trimmed 为
StringToCodePoints (trimmedString)。 - 令 trimmedPrefix 为 trimmed 中满足
StrDecimalLiteral 语法的最长前缀，它可以是 trimmed 自身。如果不存在这样的前缀，则返回NaN 。 - 令 parsedNumber 为
ParseText (trimmedPrefix,StrDecimalLiteral )。 - 断言：parsedNumber 是
Parse Node 。 - 返回 parsedNumber 的
StringNumericValue 。
此函数可能只把 string 的前导部分解释为
19.2.5 parseInt ( string, radix )
此函数根据指定的 radix 解释 string 的内容，产生一个整数 Number。string 中的前导空白会被忽略。如果 radix 强制转换为 0（例如当其为
它是 %parseInt% 内在对象。
它在被调用时执行以下步骤：
- 令 inputString 为 ?
ToString (string)。 - 令 trimmedString 为 !
TrimString (inputString,start )。 - 令 sign 为 1。
- 如果 trimmedString 不为空且 trimmedString 的第一个码元是码元 0x002D（HYPHEN-MINUS），则将 sign 设置为 -1。
- 如果 trimmedString 不为空且 trimmedString 的第一个码元是码元 0x002B（PLUS SIGN）或码元 0x002D（HYPHEN-MINUS），则将 trimmedString 设置为 trimmedString 从索引 1 开始的
子字符串 。 - 令 radixMV 为
ℝ (?ToInt32 (radix))。 - 令 stripPrefix 为
true 。 - 如果 radixMV ≠ 0，则
- 如果 radixMV < 2 或 radixMV > 36，则返回
NaN 。 - 如果 radixMV ≠ 16，则将 stripPrefix 设置为
false 。
- 如果 radixMV < 2 或 radixMV > 36，则返回
- 否则，
- 将 radixMV 设置为 10。
- 如果 stripPrefix 是
true ，则- 如果 trimmedString 的长度 ≥ 2 且 trimmedString 的前两个码元是
"0x" 或"0X" ，则- 将 trimmedString 设置为 trimmedString 从索引 2 开始的
子字符串 。 - 将 radixMV 设置为 16。
- 将 trimmedString 设置为 trimmedString 从索引 2 开始的
- 如果 trimmedString 的长度 ≥ 2 且 trimmedString 的前两个码元是
- 如果 trimmedString
包含 不是 radix-radixMV 数字的码元，则令 end 为 trimmedString 中第一个此类码元的索引；否则令 end 为 trimmedString 的长度。 - 令 numberString 为 trimmedString 从 0 到 end 的
子字符串 。 - 如果 numberString 为空，则返回
NaN 。 - 令 mathInt 为 numberString 以 radix-radixMV 记号表示的整数值，使用字母 A 到 Z 以及 a 到 z 表示值为 10 到 35 的数字。（但是，如果 radixMV = 10 且 numberString
包含 超过 20 个有效数字，则实现可以选择把第 20 个之后的每个有效数字替换为 0 数字；并且如果 radixMV 不是 2、4、8、10、16 或 32 之一，则 mathInt 可以是表示 numberString 以 radix-radixMV 记号所表示整数值的实现近似整数。） - 如果 mathInt = 0，则
- 如果 sign = -1，则返回
-0 𝔽。 - 返回
+0 𝔽。
- 如果 sign = -1，则返回
- 返回
𝔽 (sign × mathInt)。
此函数可能只把 string 的前导部分解释为整数值；它会忽略任何不能解释为整数记号一部分的码元，并且不会给出任何此类码元已被忽略的指示。
19.2.6 URI 处理函数
统一资源标识符（Uniform Resource Identifiers，URI）是标识资源（例如网页或文件）以及在 Internet 上访问这些资源所用传输协议（例如 HTTP 或 FTP）的 String。除了本节所述用于编码和解码 URI 的函数外，ECMAScript 语言自身不提供任何使用 URI 的支持。encodeURI 和 decodeURI 旨在处理完整 URI；它们假定任何encodeURIComponent 和 decodeURIComponent 旨在处理 URI 的各个组成部分；它们假定任何
ECMAScript 的许多实现提供了操作网页的附加函数和方法；这些函数超出了本标准的范围。
19.2.6.1 decodeURI ( encodedURI )
此函数计算 URI 的新版本，其中每个可能由 encodeURI 函数引入的转义序列和 UTF-8 编码都会被替换为其所表示码点的 UTF-16 编码。不会替换不可能由 encodeURI 引入的转义序列。
它是 %decodeURI% 内在对象。
它在被调用时执行以下步骤：
19.2.6.2 decodeURIComponent ( encodedURIComponent )
此函数计算 URI 的新版本，其中每个可能由 encodeURIComponent 函数引入的转义序列和 UTF-8 编码都会被替换为其所表示码点的 UTF-16 编码。
它是 %decodeURIComponent% 内在对象。
它在被调用时执行以下步骤：
19.2.6.3 encodeURI ( uri )
此函数计算 UTF-16 编码（
它是 %encodeURI% 内在对象。
它在被调用时执行以下步骤：
19.2.6.4 encodeURIComponent ( uriComponent )
此函数计算 UTF-16 编码（
它是 %encodeURIComponent% 内在对象。
它在被调用时执行以下步骤：
19.2.6.5 Encode ( string, extraUnescaped )
The abstract operation Encode takes arguments string (a String) and extraUnescaped (a String) and returns either a normal completion containing a String or a throw completion. 它执行 URI 编码和转义，将 string 解释为
- 令 length 为 string 的长度。
- 令 result 为空 String。
- 令 alwaysUnescaped 为
ASCII 单词字符 和"-.!~*'()" 的字符串连接 。 - 令 unescapedSet 为 alwaysUnescaped 和 extraUnescaped 的
字符串连接 。 - 令 k 为 0。
- 重复，只要 k < length，
- 令 codeUnit 为 string 中索引 k 处的码元。
- 如果 unescapedSet
包含 codeUnit，则- 将 k 设置为 k + 1。
- 将 result 设置为 result 和 codeUnit 的
字符串连接 。
- 否则，
- 令 codePoint 为
CodePointAt (string, k)。 - 如果 codePoint.[[IsUnpairedSurrogate]] 是
true ，则抛出URIError 异常。 - 将 k 设置为 k + codePoint.[[CodeUnitCount]]。
- 令 octets 为对 codePoint.[[CodePoint]] 应用 UTF-8 转换所得的八位字节
List 。 - 对 octets 的每个元素 octet，执行：
- 令 codePoint 为
- 返回 result。
由于百分号编码用于表示单个八位字节，一个码点可以表示为多个连续转义序列（其 8 位 UTF-8 码元各一个）。
19.2.6.6 Decode ( string, preserveEscapeSet )
The abstract operation Decode takes arguments string (a String) and preserveEscapeSet (a String) and returns either a normal completion containing a String or a throw completion. 它执行 URI 反转义和解码，并保留与 preserveEscapeSet 中的基本拉丁字符对应的任何转义序列。 It performs the following steps when called:
- 令 length 为 string 的长度。
- 令 result 为空 String。
- 令 k 为 0。
- 重复，只要 k < length，
- 令 codeUnit 为 string 中索引 k 处的码元。
- 令 segment 为 codeUnit。
- 如果 codeUnit 是码元 0x0025（PERCENT SIGN），则
- 如果 k + 3 > length，则抛出
URIError 异常。 - 令 escape 为 string 从 k 到 k + 3 的
子字符串 。 - 令 firstOctet 为
ParseHexOctet (string, k + 1)。 - 如果 firstOctet 不是整数，则抛出
URIError 异常。 - 将 k 设置为 k + 2。
- 令 n 为 firstOctet 中前导 1 位的数量。
- 如果 n = 0，则
- 令 asciiChar 为数值为 firstOctet 的码元。
- 如果 preserveEscapeSet
包含 asciiChar，则将 segment 设置为 escape；否则将 segment 设置为 asciiChar。
- 否则，
- 如果 n = 1 或 n > 4，则抛出
URIError 异常。 - 令 octets 为 « firstOctet »。
- 令 j 为 1。
- 重复，只要 j < n，
- 将 k 设置为 k + 1。
- 如果 k + 3 > length，则抛出
URIError 异常。 - 如果 string 中索引 k 处的码元不是码元 0x0025（PERCENT SIGN），则抛出
URIError 异常。 - 令 continuationByte 为
ParseHexOctet (string, k + 1)。 - 如果 continuationByte 不是整数，则抛出
URIError 异常。 - 将 continuationByte 追加到 octets。
- 将 k 设置为 k + 2。
- 将 j 设置为 j + 1。
- 断言：octets 的长度是 n。
- 如果 octets 不
包含 某个 Unicode 码点的有效 UTF-8 编码，则抛出URIError 异常。 - 令 codePoint 为对 octets 应用 UTF-8 转换所得的码点，即从八位字节
List 到 21 位值。 - 将 segment 设置为
UTF16EncodeCodePoint (codePoint)。
- 如果 n = 1 或 n > 4，则抛出
- 如果 k + 3 > length，则抛出
- 将 result 设置为 result 和 segment 的
字符串连接 。 - 将 k 设置为 k + 1。
- 返回 result。
RFC 3629 禁止解码无效的 UTF-8 八位字节序列。例如，无效序列 0xC0 0x80 不得解码为码元 0x0000。Decode 算法的实现遇到此类无效序列时必须抛出
19.2.6.7 ParseHexOctet ( string, position )
The abstract operation ParseHexOctet takes arguments string (a String) and position (a non-negative
- 令 length 为 string 的长度。
- 断言：position + 2 ≤ length。
- 令 hexDigits 为 string 从 position 到 position + 2 的
子字符串 。 - 令 parseResult 为
ParseText (hexDigits,HexDigits )。[~Sep] - 如果 parseResult 不是
Parse Node ，则返回 parseResult。 - 令 n 为 parseResult 的 MV。
- 断言：n 在从 0 到 255 的
闭区间 内。 - 返回 n。
19.3 全局对象的构造器属性
19.3.1 AggregateError ( . . . )
见
19.3.2 Array ( . . . )
见
19.3.3 ArrayBuffer ( . . . )
见
19.3.4 AsyncDisposableStack ( . . . )
见
19.3.5 BigInt ( . . . )
见
19.3.6 BigInt64Array ( . . . )
见
19.3.7 BigUint64Array ( . . . )
见
19.3.8 Boolean ( . . . )
见
19.3.9 DataView ( . . . )
见
19.3.10 Date ( . . . )
见
19.3.11 DisposableStack ( . . . )
见
19.3.12 Error ( . . . )
见
19.3.13 EvalError ( . . . )
见
19.3.14 FinalizationRegistry ( . . . )
见
19.3.15 Float16Array ( . . . )
见
19.3.16 Float32Array ( . . . )
见
19.3.17 Float64Array ( . . . )
见
19.3.18 Function ( . . . )
见
19.3.19 Int8Array ( . . . )
见
19.3.20 Int16Array ( . . . )
见
19.3.21 Int32Array ( . . . )
见
19.3.22 Iterator ( . . . )
见
19.3.23 Map ( . . . )
见
19.3.24 Number ( . . . )
见
19.3.25 Object ( . . . )
见
19.3.26 Promise ( . . . )
见
19.3.27 Proxy ( . . . )
见
19.3.28 RangeError ( . . . )
见
19.3.29 ReferenceError ( . . . )
见
19.3.30 RegExp ( . . . )
见
19.3.31 Set ( . . . )
见
19.3.32 SharedArrayBuffer ( . . . )
见
19.3.33 String ( . . . )
见
19.3.34 SuppressedError ( . . . )
见
19.3.35 Symbol ( . . . )
见
19.3.36 SyntaxError ( . . . )
见
19.3.37 TypeError ( . . . )
见
19.3.38 Uint8Array ( . . . )
见
19.3.39 Uint8ClampedArray ( . . . )
见
19.3.40 Uint16Array ( . . . )
见
19.3.41 Uint32Array ( . . . )
见
19.3.42 URIError ( . . . )
见
19.3.43 WeakMap ( . . . )
见
19.3.44 WeakRef ( . . . )
见
19.3.45 WeakSet ( . . . )
见
19.4 全局对象的其他属性
19.4.1 Atomics
见
19.4.2 JSON
见
19.4.3 Math
见
19.4.4 Reflect
见
20 基本对象
20.1 Object 对象
20.1.1 Object 构造器
Object 构造器：
- 是 %Object%。
- 是
全局对象 的"Object" 属性的初始值。 - 在作为构造器调用时创建一个新的
普通对象 。 - 在作为函数而非构造器调用时执行类型转换。
- 可以用作类定义的
extends子句的值。
20.1.1.1 Object ( value )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 既不是
undefined ，也不是活动函数对象 ，则- 返回 ?
OrdinaryCreateFromConstructor (NewTarget,"%Object.prototype%" )。
- 返回 ?
- 如果 value 是
undefined 或null ，则返回OrdinaryObjectCreate (%Object.prototype% )。 - 返回 !
ToObject (value)。
20.1.2 Object 构造器的属性
Object 构造器：
- 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下附加属性：
20.1.2.1 Object.assign ( target, ...sources )
此函数把一个或多个源对象的所有可枚举自身属性的值复制到 target 对象。
它在被调用时执行以下步骤：
此函数的
20.1.2.2 Object.create ( proto, properties )
此函数创建一个具有指定原型的新对象。
它在被调用时执行以下步骤：
- 如果 proto 不是 Object 且 proto 不是
null ，则抛出TypeError 异常。 - 令 obj 为
OrdinaryObjectCreate (proto)。 - 如果 properties 不是
undefined ，则- 返回 ?
ObjectDefineProperties (obj, properties)。
- 返回 ?
- 返回 obj。
20.1.2.3 Object.defineProperties ( obj, properties )
此函数为对象添加自身属性和/或更新现有自身属性的特性。
它在被调用时执行以下步骤：
- 如果 obj 不是 Object，则抛出
TypeError 异常。 - 返回 ?
ObjectDefineProperties (obj, properties)。
20.1.2.3.1 ObjectDefineProperties ( obj, properties )
The abstract operation ObjectDefineProperties takes arguments obj (an Object) and properties (an ECMAScript language value) and returns either a normal completion containing an Object or a throw completion. It performs the following steps when called:
- 将 properties 设置为 ?
ToObject (properties)。 - 令 keys 为 ? properties.[[OwnPropertyKeys]]()。
- 令 propertyDescs 为新的空
List 。 - 对 keys 的每个元素 nextKey，执行：
- 令 currentPropertyDesc 为 ? properties.[[GetOwnProperty]](nextKey)。
- 如果 currentPropertyDesc 不是
undefined 且 currentPropertyDesc.[[Enumerable]] 是true ，则- 令 propertyDescObj 为 ?
Get (properties, nextKey)。 - 令 propertyDesc 为 ?
ToPropertyDescriptor (propertyDescObj)。 - 将
Record { [[Key]]: nextKey, [[Descriptor]]: propertyDesc } 追加到 propertyDescs。
- 令 propertyDescObj 为 ?
- 对 propertyDescs 的每个元素 property，执行：
- 执行 ?
DefinePropertyOrThrow (obj, property.[[Key]], property.[[Descriptor]])。
- 执行 ?
- 返回 obj。
20.1.2.4 Object.defineProperty ( obj, key, attrs )
此函数为对象添加一个自身属性和/或更新一个现有自身属性的特性。
它在被调用时执行以下步骤：
- 如果 obj 不是 Object，则抛出
TypeError 异常。 - 令 propertyKey 为 ?
ToPropertyKey (key)。 - 令 propertyDesc 为 ?
ToPropertyDescriptor (attrs)。 - 执行 ?
DefinePropertyOrThrow (obj, propertyKey, propertyDesc)。 - 返回 obj。
20.1.2.5 Object.entries ( obj )
此函数在被调用时执行以下步骤：
- 令 coerced 为 ?
ToObject (obj)。 - 令 entryList 为 ?
EnumerableOwnProperties (coerced,key+value )。 - 返回
CreateArrayFromList (entryList)。
20.1.2.6 Object.freeze ( obj )
此函数在被调用时执行以下步骤：
- 如果 obj 不是 Object，则返回 obj。
- 令 status 为 ?
SetIntegrityLevel (obj,frozen )。 - 如果 status 是
false ，则抛出TypeError 异常。 - 返回 obj。
20.1.2.7 Object.fromEntries ( iterable )
此函数在被调用时执行以下步骤：
- 执行 ?
RequireObjectCoercible (iterable)。 - 令 obj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 断言：obj 是一个可扩展、没有自身属性的
普通对象 。 - 令 closure 为一个新的
Abstract Closure ，它具有参数 (key, value)、捕获 obj，并在被调用时执行以下步骤：- 令 propertyKey 为 ?
ToPropertyKey (key)。 - 执行 !
CreateDataPropertyOrThrow (obj, propertyKey, value)。 - 返回
NormalCompletion (undefined )。
- 令 propertyKey 为 ?
- 令 adder 为
CreateBuiltinFunction (closure, 2,"" , « »)。 - 返回 ?
AddEntriesFromIterable (obj, iterable, adder)。
20.1.2.8 Object.getOwnPropertyDescriptor ( obj, key )
此函数在被调用时执行以下步骤：
- 令 coerced 为 ?
ToObject (obj)。 - 令 propertyKey 为 ?
ToPropertyKey (key)。 - 令 propertyDesc 为 ? coerced.[[GetOwnProperty]](propertyKey)。
- 返回
FromPropertyDescriptor (propertyDesc)。
20.1.2.9 Object.getOwnPropertyDescriptors ( obj )
此函数在被调用时执行以下步骤：
- 令 coerced 为 ?
ToObject (obj)。 - 令 ownKeys 为 ? coerced.[[OwnPropertyKeys]]()。
- 令 descs 为
OrdinaryObjectCreate (%Object.prototype% )。 - 对 ownKeys 的每个元素 key，执行：
- 令 propertyDesc 为 ? coerced.[[GetOwnProperty]](key)。
- 令 propertyDescObj 为
FromPropertyDescriptor (propertyDesc)。 - 如果 propertyDescObj 不是
undefined ，则执行 !CreateDataPropertyOrThrow (descs, key, propertyDescObj)。
- 返回 descs。
20.1.2.10 Object.getOwnPropertyNames ( obj )
此函数在被调用时执行以下步骤：
- 返回
CreateArrayFromList (?GetOwnPropertyKeys (obj,string ))。
20.1.2.11 Object.getOwnPropertySymbols ( obj )
此函数在被调用时执行以下步骤：
- 返回
CreateArrayFromList (?GetOwnPropertyKeys (obj,symbol ))。
20.1.2.11.1 GetOwnPropertyKeys ( value, type )
The abstract operation GetOwnPropertyKeys takes arguments value (an ECMAScript language value) and type (
20.1.2.12 Object.getPrototypeOf ( obj )
此函数在被调用时执行以下步骤：
- 令 coerced 为 ?
ToObject (obj)。 - 返回 ? coerced.[[GetPrototypeOf]]()。
20.1.2.13 Object.groupBy ( items, callback )
callback 应该是一个接受两个实参的函数。groupBy 会按升序对 items 中的每个元素调用一次 callback，并构造一个新对象。callback 返回的每个值都会被强制转换为
callback 会带两个实参调用：元素的值和元素的索引。
groupBy 的返回值是一个不继承自
此函数在被调用时执行以下步骤：
- 令 groups 为 ?
GroupBy (items, callback,property )。 - 令 obj 为
OrdinaryObjectCreate (null )。 - 对 groups 的每个
Record { [[Key]], [[Elements]] } group，执行：- 令 elements 为
CreateArrayFromList (group.[[Elements]])。 - 执行 !
CreateDataPropertyOrThrow (obj, group.[[Key]], elements)。
- 令 elements 为
- 返回 obj。
20.1.2.14 Object.hasOwn ( obj, key )
此函数在被调用时执行以下步骤：
- 令 coerced 为 ?
ToObject (obj)。 - 令 propertyKey 为 ?
ToPropertyKey (key)。 - 返回 ?
HasOwnProperty (coerced, propertyKey)。
20.1.2.15 Object.is ( value1, value2 )
此函数在被调用时执行以下步骤：
- 返回
SameValue (value1, value2)。
20.1.2.16 Object.isExtensible ( obj )
此函数在被调用时执行以下步骤：
- 如果 obj 不是 Object，则返回
false 。 - 返回 ?
IsExtensible (obj)。
20.1.2.17 Object.isFrozen ( obj )
此函数在被调用时执行以下步骤：
- 如果 obj 不是 Object，则返回
true 。 - 返回 ?
TestIntegrityLevel (obj,frozen )。
20.1.2.18 Object.isSealed ( obj )
此函数在被调用时执行以下步骤：
- 如果 obj 不是 Object，则返回
true 。 - 返回 ?
TestIntegrityLevel (obj,sealed )。
20.1.2.19 Object.keys ( obj )
此函数在被调用时执行以下步骤：
- 令 coerced 为 ?
ToObject (obj)。 - 令 keyList 为 ?
EnumerableOwnProperties (coerced,key )。 - 返回
CreateArrayFromList (keyList)。
20.1.2.20 Object.preventExtensions ( obj )
此函数在被调用时执行以下步骤：
- 如果 obj 不是 Object，则返回 obj。
- 令 status 为 ? obj.[[PreventExtensions]]()。
- 如果 status 是
false ，则抛出TypeError 异常。 - 返回 obj。
20.1.2.21 Object.prototype
Object.prototype 的初始值是
此属性具有特性 { [[Writable]]:
20.1.2.22 Object.seal ( obj )
此函数在被调用时执行以下步骤：
- 如果 obj 不是 Object，则返回 obj。
- 令 status 为 ?
SetIntegrityLevel (obj,sealed )。 - 如果 status 是
false ，则抛出TypeError 异常。 - 返回 obj。
20.1.2.23 Object.setPrototypeOf ( obj, proto )
此函数在被调用时执行以下步骤：
- 执行 ?
RequireObjectCoercible (obj)。 - 如果 proto 不是 Object 且 proto 不是
null ，则抛出TypeError 异常。 - 如果 obj 不是 Object，则返回 obj。
- 令 status 为 ? obj.[[SetPrototypeOf]](proto)。
- 如果 status 是
false ，则抛出TypeError 异常。 - 返回 obj。
20.1.2.24 Object.values ( obj )
此函数在被调用时执行以下步骤：
- 令 coerced 为 ?
ToObject (obj)。 - 令 valueList 为 ?
EnumerableOwnProperties (coerced,value )。 - 返回
CreateArrayFromList (valueList)。
20.1.3 Object 原型对象的属性
Object 原型对象：
- 是 %Object.prototype%。
- 具有一个 [[Extensible]] 内部槽，其值为
true 。 - 具有为
普通对象 定义的内部方法，但 [[SetPrototypeOf]] 方法除外，其定义见10.4.7.1 。（因此，它是一个不可变原型奇异对象。） - 具有一个 [[Prototype]] 内部槽，其值为
null 。
20.1.3.1 Object.prototype.constructor
Object.prototype.constructor 的初始值是
20.1.3.2 Object.prototype.hasOwnProperty ( value )
此方法在被调用时执行以下步骤：
- 令 propertyKey 为 ?
ToPropertyKey (value)。 - 令 obj 为 ?
ToObject (this value)。 - 返回 ?
HasOwnProperty (obj, propertyKey)。
20.1.3.3 Object.prototype.isPrototypeOf ( value )
此方法在被调用时执行以下步骤：
20.1.3.4 Object.prototype.propertyIsEnumerable ( value )
此方法在被调用时执行以下步骤：
- 令 propertyKey 为 ?
ToPropertyKey (value)。 - 令 obj 为 ?
ToObject (this value)。 - 令 propertyDesc 为 ? obj.[[GetOwnProperty]](propertyKey)。
- 如果 propertyDesc 是
undefined ，则返回false 。 - 返回 propertyDesc.[[Enumerable]]。
此方法不考虑原型链中的对象。
20.1.3.5 Object.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
此方法在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 返回 ?
Invoke (thisValue,"toString" )。
此方法的可选参数未被使用，但旨在对应于 ECMA-402 toLocaleString 方法所使用的参数模式。不
此方法为没有区域设置敏感 toString 行为的对象提供一个通用 toLocaleString 实现。Array、Number、Date 和 toLocaleString 方法。
ECMA-402 有意不为此默认实现提供替代项。
20.1.3.6 Object.prototype.toString ( )
此方法在被调用时执行以下步骤：
- 如果
this value 是undefined ，则返回"[object Undefined]" 。 - 如果
this value 是null ，则返回"[object Null]" 。 - 令 obj 为 !
ToObject (this value)。 - 令 isArray 为 ?
IsArray (obj)。 - 如果 isArray 是
true ，则令 builtinTag 为"Array" 。 - 否则，如果 obj 具有 [[ParameterMap]] 内部槽，则令 builtinTag 为
"Arguments" 。 - 否则，如果 obj 具有 [[Call]] 内部方法，则令 builtinTag 为
"Function" 。 - 否则，如果 obj 具有 [[ErrorData]] 内部槽，则令 builtinTag 为
"Error" 。 - 否则，如果 obj 具有 [[BooleanData]] 内部槽，则令 builtinTag 为
"Boolean" 。 - 否则，如果 obj 具有 [[NumberData]] 内部槽，则令 builtinTag 为
"Number" 。 - 否则，如果 obj 具有 [[StringData]] 内部槽，则令 builtinTag 为
"String" 。 - 否则，如果 obj 具有 [[DateValue]] 内部槽，则令 builtinTag 为
"Date" 。 - 否则，如果 obj 具有 [[RegExpMatcher]] 内部槽，则令 builtinTag 为
"RegExp" 。 - 否则，令 builtinTag 为
"Object" 。 - 令 tag 为 ?
Get (obj,%Symbol.toStringTag% )。 - 如果 tag 不是 String，则将 tag 设置为 builtinTag。
- 返回
"[object " 、tag 和"]" 的字符串连接 。
从历史上看，此方法偶尔用于访问 [[Class]] 内部槽的 String 值，该内部槽在本规范先前版本中用作各种内置对象的标称类型标签。上述 toString 定义保留了旧代码的兼容性，这些旧代码把 toString 用作针对那些特定种类内置对象的测试。它并不为其他种类的内置对象或程序定义对象提供可靠的类型测试机制。此外，程序可以以会使这类旧式类型测试的可靠性失效的方式使用
20.1.3.7 Object.prototype.valueOf ( )
此方法在被调用时执行以下步骤：
- 返回 ?
ToObject (this value)。
20.1.3.8 Object.prototype.__proto__
Object.prototype.__proto__ 是一个
20.1.3.8.1 get Object.prototype.__proto__
[[Get]] 特性的值是一个不需要实参的内置函数。它在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 返回 ? obj.[[GetPrototypeOf]]()。
20.1.3.8.2 set Object.prototype.__proto__
[[Set]] 特性的值是一个接受实参 proto 的内置函数。它在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 如果 proto 不是 Object 且 proto 不是
null ，则返回undefined 。 - 如果 thisValue 不是 Object，则返回
undefined 。 - 令 status 为 ? thisValue.[[SetPrototypeOf]](proto)。
- 如果 status 是
false ，则抛出TypeError 异常。 - 返回
undefined 。
20.1.3.9 遗留 Object.prototype 访问器方法
20.1.3.9.1 Object.prototype.__defineGetter__ ( key, getter )
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 如果
IsCallable (getter) 是false ，则抛出TypeError 异常。 - 令 propertyDesc 为 PropertyDescriptor { [[Get]]: getter, [[Enumerable]]:
true , [[Configurable]]:true }。 - 令 propertyKey 为 ?
ToPropertyKey (key)。 - 执行 ?
DefinePropertyOrThrow (obj, propertyKey, propertyDesc)。 - 返回
undefined 。
20.1.3.9.2 Object.prototype.__defineSetter__ ( key, setter )
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 如果
IsCallable (setter) 是false ，则抛出TypeError 异常。 - 令 propertyDesc 为 PropertyDescriptor { [[Set]]: setter, [[Enumerable]]:
true , [[Configurable]]:true }。 - 令 propertyKey 为 ?
ToPropertyKey (key)。 - 执行 ?
DefinePropertyOrThrow (obj, propertyKey, propertyDesc)。 - 返回
undefined 。
20.1.3.9.3 Object.prototype.__lookupGetter__ ( key )
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 propertyKey 为 ?
ToPropertyKey (key)。 - 重复，
- 令 propertyDesc 为 ? obj.[[GetOwnProperty]](propertyKey)。
- 如果 propertyDesc 不是
undefined ，则- 如果
IsAccessorDescriptor (propertyDesc) 是true ，则返回 propertyDesc.[[Get]]。 - 返回
undefined 。
- 如果
- 将 obj 设置为 ? obj.[[GetPrototypeOf]]()。
- 如果 obj 是
null ，则返回undefined 。
20.1.3.9.4 Object.prototype.__lookupSetter__ ( key )
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 propertyKey 为 ?
ToPropertyKey (key)。 - 重复，
- 令 propertyDesc 为 ? obj.[[GetOwnProperty]](propertyKey)。
- 如果 propertyDesc 不是
undefined ，则- 如果
IsAccessorDescriptor (propertyDesc) 是true ，则返回 propertyDesc.[[Set]]。 - 返回
undefined 。
- 如果
- 将 obj 设置为 ? obj.[[GetPrototypeOf]]()。
- 如果 obj 是
null ，则返回undefined 。
20.1.4 Object 实例的属性
除了从
20.2 Function 对象
20.2.1 Function 构造器
Function 构造器：
- 是 %Function%。
- 是
全局对象 的"Function" 属性的初始值。 - 在作为函数而非构造器调用时创建并初始化一个新的
函数对象 。因此，函数调用Function(…)等价于带有相同实参的对象创建表达式new Function(…)。 - 可以用作类定义的
extends子句的值。意图继承指定 Function 行为的子类构造器必须包含 对 Function 构造器的super调用，以创建并初始化具有内置函数行为所需内部槽的子类实例。所有用于定义函数对象 的 ECMAScript 句法形式都会创建 Function 实例。除了内置 GeneratorFunction、AsyncFunction 和 AsyncGeneratorFunction 子类外，没有句法手段可以创建 Function 子类的实例。
20.2.1.1 Function ( ...paramArgs, bodyArg )
最后一个实参（如果有）指定函数的主体（可执行代码）；此前的任何实参指定形式参数。
此函数在被调用时执行以下步骤：
- 令 ctor 为
活动函数对象 。 - 如果 bodyArg 不存在，则将 bodyArg 设置为空 String。
- 返回 ?
CreateDynamicFunction (ctor, NewTarget,normal , paramArgs, bodyArg)。
可以但不必为要指定的每个形式参数提供一个实参。例如，以下三个表达式都会产生相同结果：
new Function("a", "b", "c", "return a+b+c")
new Function("a, b, c", "return a+b+c")
new Function("a,b", "c", "return a+b+c")20.2.1.1.1 CreateDynamicFunction ( ctor, newTarget, kind, paramArgs, bodyArg )
The abstract operation CreateDynamicFunction takes arguments ctor (a constructor), newTarget (a constructor or new 的构造器。paramArgs 和 bodyArg 反映传给 ctor 的实参值。 It performs the following steps when called:
- 如果 newTarget 是
undefined ，则将 newTarget 设置为 ctor。 - 如果 kind 是
normal ，则- 令 prefix 为
"function" 。 - 令 exprGrammar 为文法符号
FunctionExpression 。 - 令 bodyGrammar 为文法符号
FunctionBody 。[~Yield, ~Await] - 令 paramGrammar 为文法符号
FormalParameters 。[~Yield, ~Await] - 令 fallbackProto 为
"%Function.prototype%" 。
- 令 prefix 为
- 否则，如果 kind 是
generator ，则- 令 prefix 为
"function*" 。 - 令 exprGrammar 为文法符号
GeneratorExpression 。 - 令 bodyGrammar 为文法符号
GeneratorBody 。 - 令 paramGrammar 为文法符号
FormalParameters 。[+Yield, ~Await] - 令 fallbackProto 为
"%GeneratorFunction.prototype%" 。
- 令 prefix 为
- 否则，如果 kind 是
async ，则- 令 prefix 为
"async function" 。 - 令 exprGrammar 为文法符号
AsyncFunctionExpression 。 - 令 bodyGrammar 为文法符号
AsyncFunctionBody 。 - 令 paramGrammar 为文法符号
FormalParameters 。[~Yield, +Await] - 令 fallbackProto 为
"%AsyncFunction.prototype%" 。
- 令 prefix 为
- 否则，
- 断言：kind 是
async-generator 。 - 令 prefix 为
"async function*" 。 - 令 exprGrammar 为文法符号
AsyncGeneratorExpression 。 - 令 bodyGrammar 为文法符号
AsyncGeneratorBody 。 - 令 paramGrammar 为文法符号
FormalParameters 。[+Yield, +Await] - 令 fallbackProto 为
"%AsyncGeneratorFunction.prototype%" 。
- 断言：kind 是
- 令 argCount 为 paramArgs 中元素的数量。
- 令 paramStrings 为新的空
List 。 - 对 paramArgs 的每个元素 arg，执行：
- 将 ?
ToString (arg) 追加到 paramStrings。
- 将 ?
- 令 bodyString 为 ?
ToString (bodyArg)。 - 令 currentRealm 为
当前 Realm Record 。 - 执行 ?
HostEnsureCanCompileStrings (currentRealm, paramStrings, bodyString,false )。 - 令 paramString 为空 String。
- 如果 argCount > 0，则
- 将 paramString 设置为 paramStrings[0]。
- 令 k 为 1。
- 重复，只要 k < argCount，
- 令 nextArgString 为 paramStrings[k]。
- 将 paramString 设置为 paramString、
"," （逗号）和 nextArgString 的字符串连接 。 - 将 k 设置为 k + 1。
- 令 bodyParseString 为 0x000A（LINE FEED）、bodyString 和 0x000A（LINE FEED）的
字符串连接 。 - 令 sourceString 为 prefix、
" anonymous(" 、paramString、0x000A（LINE FEED）、") {" 、bodyParseString 和"}" 的字符串连接 。 - 令 sourceText 为
StringToCodePoints (sourceString)。 - 令 params 为
ParseText (paramString, paramGrammar)。 - 如果 params 是错误列表，则抛出
SyntaxError 异常。 - 令 body 为
ParseText (bodyParseString, bodyGrammar)。 - 如果 body 是错误列表，则抛出
SyntaxError 异常。 - 注：参数和主体会分别解析，以确保它们各自单独有效。例如，
new Function("/*", "*/ ) {")不会求值为一个函数。 - 注：如果到达此步骤，则 sourceText 必须具有 exprGrammar 的语法（尽管其逆命题不成立）。接下来两个步骤的目的是强制执行任何直接适用于 exprGrammar 的
早期错误 规则。 - 令 expr 为
ParseText (sourceText, exprGrammar)。 - 如果 expr 是错误列表，则抛出
SyntaxError 异常。 - 令 funcProto 为 ?
GetPrototypeFromConstructor (newTarget, fallbackProto)。 - 令 envRecord 为 currentRealm.[[GlobalEnv]]。
- 令 privateEnv 为
null 。 - 令 func 为
OrdinaryFunctionCreate (funcProto, sourceText, params, body,non-lexical-this , envRecord, privateEnv)。 - 执行
SetFunctionName (func,"anonymous" )。 - 如果 kind 是
generator ，则- 令 protoProto 为
OrdinaryObjectCreate (%GeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (func,"prototype" , PropertyDescriptor { [[Value]]: protoProto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。
- 令 protoProto 为
- 否则，如果 kind 是
async-generator ，则- 令 protoProto 为
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (func,"prototype" , PropertyDescriptor { [[Value]]: protoProto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。
- 令 protoProto 为
- 否则，如果 kind 是
normal ，则- 执行
MakeConstructor (func)。
- 执行
- 注：kind 为
async 的函数不可构造，并且没有 [[Construct]] 内部方法或"prototype" 属性。 - 返回 func。
CreateDynamicFunction 会在它创建的任何 kind 不是
20.2.2 Function 构造器的属性
Function 构造器：
- 自身是一个内置
函数对象 。 - 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有一个
"length" 属性，其值为1 𝔽。 - 具有以下属性：
20.2.2.1 Function.prototype
Function.prototype 的值是
此属性具有特性 { [[Writable]]:
20.2.3 Function 原型对象的属性
Function 原型对象：
- 是 %Function.prototype%。
- 自身是一个内置
函数对象 。 - 接受任何实参，并在被调用时返回
undefined 。 - 没有 [[Construct]] 内部方法；它不能作为构造器与
new运算符一起使用。 - 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 没有
"prototype" 属性。 - 具有一个
"length" 属性，其值为+0 𝔽。 - 具有一个
"name" 属性，其值为空 String。
Function 原型对象被规定为
20.2.3.1 Function.prototype.apply ( thisArg, argArray )
此方法在被调用时执行以下步骤：
- 令 func 为
this value。 - 如果
IsCallable (func) 是false ，则抛出TypeError 异常。 - 如果 argArray 是
undefined 或null ，则- 执行
PrepareForTailCall ()。 - 返回 ?
Call (func, thisArg)。
- 执行
- 令 argList 为 ?
CreateListFromArrayLike (argArray)。 - 执行
PrepareForTailCall ()。 - 返回 ?
Call (func, thisArg, argList)。
如果 func 是箭头函数或绑定函数奇异对象，则 thisArg 会在步骤
20.2.3.2 Function.prototype.bind ( thisArg, ...args )
此方法在被调用时执行以下步骤：
- 令 target 为
this value。 - 如果
IsCallable (target) 是false ，则抛出TypeError 异常。 - 令 boundFunc 为 ?
BoundFunctionCreate (target, thisArg, args)。 - 令 length 为 0。
- 令 targetHasLength 为 ?
HasOwnProperty (target,"length" )。 - 如果 targetHasLength 是
true ，则- 令 targetLength 为 ?
Get (target,"length" )。 - 如果 targetLength 是 Number，则
- 如果 targetLength 是
+∞ 𝔽，则- 将 length 设置为 +∞。
- 否则，如果 targetLength 是
-∞ 𝔽，则- 将 length 设置为 0。
- 否则，
- 令 targetLengthAsInt 为 !
ToIntegerOrInfinity (targetLength)。 - 断言：targetLengthAsInt 是
有限 的。 - 令 argCount 为 args 中元素的数量。
- 将 length 设置为
max (targetLengthAsInt - argCount, 0)。
- 令 targetLengthAsInt 为 !
- 如果 targetLength 是
- 令 targetLength 为 ?
- 执行
SetFunctionLength (boundFunc, length)。 - 令 targetName 为 ?
Get (target,"name" )。 - 如果 targetName 不是 String，则将 targetName 设置为空 String。
- 执行
SetFunctionName (boundFunc, targetName,"bound" )。 - 返回 boundFunc。
使用 Function.prototype.bind 创建的 Function 对象是奇异对象。它们也没有
如果 target 是箭头函数或绑定函数奇异对象，则传给此方法的 thisArg 不会被后续对 func 的调用使用。
20.2.3.3 Function.prototype.call ( thisArg, ...args )
此方法在被调用时执行以下步骤：
- 令 func 为
this value。 - 如果
IsCallable (func) 是false ，则抛出TypeError 异常。 - 执行
PrepareForTailCall ()。 - 返回 ?
Call (func, thisArg, args)。
如果 func 是箭头函数或绑定函数奇异对象，则 thisArg 会在步骤
20.2.3.4 Function.prototype.constructor
Function.prototype.constructor 的初始值是
20.2.3.5 Function.prototype.toString ( )
此方法在被调用时执行以下步骤：
- 令 func 为
this value。 - 如果 func 是 Object，func 具有 [[SourceText]] 内部槽，func.[[SourceText]] 是 Unicode 码点序列，且
HostHasSourceTextAvailable (func) 是true ，则- 返回
CodePointsToString (func.[[SourceText]])。
- 返回
- 如果 func 是
内置函数对象 ，则返回 func 的实现定义 String 源代码表示。该表示必须具有NativeFunction 的语法。此外，如果 func 具有 [[InitialName]] 内部槽，且 func.[[InitialName]] 是 String，则返回的 String 中会匹配NativeFunctionAccessor opt PropertyName 的部分必须是 func.[[InitialName]]。 - 如果 func 是 Object 且
IsCallable (func) 是true ，则返回 func 的实现定义 String 源代码表示。该表示必须具有NativeFunction 的语法。 - 抛出
TypeError 异常。
20.2.3.6 Function.prototype [ %Symbol.hasInstance% ] ( value )
此方法在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 返回 ?
OrdinaryHasInstance (thisValue, value)。
此属性具有特性 { [[Writable]]:
这是大多数函数继承的 %Symbol.hasInstance% 默认实现。instanceof 运算符会调用 %Symbol.hasInstance% 来确定某个值是否为特定构造器的实例。诸如
v instanceof F的表达式会求值为
F[%Symbol.hasInstance%](v)构造器函数可以通过在该函数上暴露不同的 %Symbol.hasInstance% 方法，来控制哪些对象会被 instanceof 识别为其实例。
此属性不可写且不可配置，以防止可能被用于全局暴露绑定函数目标函数的篡改。
此方法的
20.2.4 Function 实例
每个 Function 实例都是 ECMAScript Function.prototype.bind 方法（
Function 实例具有以下属性：
20.2.4.1 length
20.2.4.2 name
没有由本规范为其关联上下文名称的匿名
20.2.4.3 prototype
可以用作构造器的 Function 实例具有
此属性具有特性 { [[Writable]]:
使用 Function.prototype.bind 创建的 Function 对象，或通过求值
20.2.5 HostHasSourceTextAvailable ( func )
The host-defined abstract operation HostHasSourceTextAvailable takes argument func (a function object) and returns a Boolean. 它允许
HostHasSourceTextAvailable 的实现必须符合以下要求：
- 它必须相对于其参数是确定性的。每次用特定 func 作为实参调用它时，都必须返回相同结果。
HostHasSourceTextAvailable 的默认实现是返回
20.3 Boolean 对象
20.3.1 Boolean 构造器
Boolean 构造器：
- 是 %Boolean%。
- 是
全局对象 的"Boolean" 属性的初始值。 - 在作为构造器调用时创建并初始化一个新的 Boolean 对象。
- 在作为函数而非构造器调用时执行类型转换。
- 可以用作类定义的
extends子句的值。意图继承指定 Boolean 行为的子类构造器必须包含 对 Boolean 构造器的super调用，以创建并初始化带有 [[BooleanData]] 内部槽的子类实例。
20.3.1.1 Boolean ( value )
此函数在被调用时执行以下步骤：
- 令 bool 为
ToBoolean (value)。 - 如果 NewTarget 是
undefined ，则返回 bool。 - 令 obj 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%Boolean.prototype%" , « [[BooleanData]] »)。 - 将 obj.[[BooleanData]] 设置为 bool。
- 返回 obj。
20.3.2 Boolean 构造器的属性
Boolean 构造器：
- 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
20.3.2.1 Boolean.prototype
Boolean.prototype 的初始值是
此属性具有特性 { [[Writable]]:
20.3.3 Boolean 原型对象的属性
Boolean 原型对象：
- 是 %Boolean.prototype%。
- 是
普通对象 。 - 自身是 Boolean 对象；它具有一个 [[BooleanData]] 内部槽，其值为
false 。 - 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。
20.3.3.1 Boolean.prototype.constructor
Boolean.prototype.constructor 的初始值是
20.3.3.2 Boolean.prototype.toString ( )
此方法在被调用时执行以下步骤：
- 令 bool 为 ?
ThisBooleanValue (this value)。 - 如果 bool 是
true ，则返回"true" 。 - 返回
"false" 。
20.3.3.3 Boolean.prototype.valueOf ( )
此方法在被调用时执行以下步骤：
- 返回 ?
ThisBooleanValue (this value)。
20.3.3.3.1 ThisBooleanValue ( arg )
The abstract operation ThisBooleanValue takes argument arg (an ECMAScript language value) and returns either a normal completion containing a Boolean or a throw completion. It performs the following steps when called:
- 如果 arg 是 Boolean，则返回 arg。
- 如果 arg 是 Object 且 arg 具有 [[BooleanData]] 内部槽，则
- 令 bool 为 arg.[[BooleanData]]。
- 断言：bool 是 Boolean。
- 返回 bool。
- 抛出
TypeError 异常。
20.3.4 Boolean 实例的属性
Boolean 实例是继承自
20.4 Symbol 对象
20.4.1 Symbol 构造器
Symbol 构造器：
- 是 %Symbol%。
- 是
全局对象 的"Symbol" 属性的初始值。 - 在作为函数调用时返回一个新的 Symbol 值。
- 并非旨在与
new运算符一起使用。 - 并非旨在被子类化。
- 可以用作类定义的
extends子句的值，但对其进行super调用会导致异常。
20.4.1.1 Symbol ( [ description ] )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 不是
undefined ，则抛出TypeError 异常。 - 如果 description 是
undefined ，则令 descString 为undefined 。 - 否则，令 descString 为 ?
ToString (description)。 - 返回一个新的 Symbol，其 [[Description]] 为 descString。
20.4.2 Symbol 构造器的属性
Symbol 构造器：
- 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
20.4.2.1 Symbol.asyncIterator
Symbol.asyncIterator 的初始值是知名 symbol
此属性具有特性 { [[Writable]]:
20.4.2.2 Symbol.for ( key )
此函数在被调用时执行以下步骤：
- 令 stringKey 为 ?
ToString (key)。 - 令 agentRecord 为周围代理的代理记录。
- 令 globalSymbolRegistry 为 agentRecord.[[GlobalSymbolRegistry]]。
- 对 globalSymbolRegistry 的每个元素 element，执行
- 如果 element.[[Key]] 是 stringKey，则返回 element.[[Symbol]]。
- 断言：globalSymbolRegistry 当前不
包含 stringKey 的条目。 - 令 newSymbol 为一个新的 Symbol，其 [[Description]] 为 stringKey。
- 将
GlobalSymbolRegistry 记录 { [[Key]]: stringKey, [[Symbol]]: newSymbol } 追加到 globalSymbolRegistry。 - 返回 newSymbol。
20.4.2.3 Symbol.hasInstance
Symbol.hasInstance 的初始值是知名 symbol
此属性具有特性 { [[Writable]]:
20.4.2.4 Symbol.isConcatSpreadable
Symbol.isConcatSpreadable 的初始值是知名 symbol
此属性具有特性 { [[Writable]]:
20.4.2.5 Symbol.iterator
Symbol.iterator 的初始值是知名 symbol
此属性具有特性 { [[Writable]]:
20.4.2.6 Symbol.keyFor ( symbol )
此函数在被调用时执行以下步骤：
- 如果 symbol 不是 Symbol，则抛出
TypeError 异常。 - 返回
KeyForSymbol (symbol)。
20.4.2.7 Symbol.match
Symbol.match 的初始值是知名 symbol
此属性具有特性 { [[Writable]]:
20.4.2.8 Symbol.matchAll
Symbol.matchAll 的初始值是知名 symbol
此属性具有特性 { [[Writable]]:
20.4.2.9 Symbol.prototype
Symbol.prototype 的初始值是
此属性具有特性 { [[Writable]]:
20.4.2.10 Symbol.replace
Symbol.replace 的初始值是知名 symbol
此属性具有特性 { [[Writable]]:
20.4.2.11 Symbol.search
Symbol.search 的初始值是知名 symbol
此属性具有特性 { [[Writable]]:
20.4.2.12 Symbol.species
Symbol.species 的初始值是知名 symbol
此属性具有特性 { [[Writable]]:
20.4.2.13 Symbol.split
Symbol.split 的初始值是知名 symbol
此属性具有特性 { [[Writable]]:
20.4.2.14 Symbol.toPrimitive
Symbol.toPrimitive 的初始值是知名 symbol
此属性具有特性 { [[Writable]]:
20.4.2.15 Symbol.toStringTag
Symbol.toStringTag 的初始值是知名 symbol
此属性具有特性 { [[Writable]]:
20.4.2.16 Symbol.unscopables
Symbol.unscopables 的初始值是知名 symbol
此属性具有特性 { [[Writable]]:
20.4.3 Symbol 原型对象的属性
Symbol 原型对象：
- 是 %Symbol.prototype%。
- 是
普通对象 。 - 不是 Symbol 实例，并且没有 [[SymbolData]] 内部槽。
- 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。
20.4.3.1 Symbol.prototype.constructor
Symbol.prototype.constructor 的初始值是
20.4.3.2 get Symbol.prototype.description
Symbol.prototype.description 是一个
- 令 symbol 为 ?
ThisSymbolValue (this value)。 - 返回 symbol.[[Description]]。
20.4.3.3 Symbol.prototype.toString ( )
此方法在被调用时执行以下步骤：
- 令 symbol 为 ?
ThisSymbolValue (this value)。 - 返回
SymbolDescriptiveString (symbol)。
20.4.3.3.1 SymbolDescriptiveString ( symbol )
The abstract operation SymbolDescriptiveString takes argument symbol (a Symbol) and returns a String. It performs the following steps when called:
- 令 description 为 symbol.[[Description]]。
- 如果 description 为
undefined ，则将 description 设为空 String。 - 断言：description 是一个 String。
- 返回
"Symbol(" 、description 和")" 的字符串连接 。
20.4.3.4 Symbol.prototype.valueOf ( )
此方法在被调用时执行以下步骤：
- 返回 ?
ThisSymbolValue (this value)。
20.4.3.4.1 ThisSymbolValue ( arg )
The abstract operation ThisSymbolValue takes argument arg (an ECMAScript language value) and returns either a normal completion containing a Symbol or a throw completion. It performs the following steps when called:
- 如果 arg 是 Symbol，则返回 arg。
- 如果 arg 是 Object 且 arg 具有 [[SymbolData]] 内部槽，则
- 令 symbol 为 arg.[[SymbolData]]。
- 断言：symbol 是 Symbol。
- 返回 symbol。
- 抛出
TypeError 异常。
20.4.3.5 Symbol.prototype [ %Symbol.toPrimitive% ] ( hint )
此方法由 ECMAScript 语言运算符调用，用于把 Symbol 对象转换为原始值。
它在被调用时执行以下步骤：
- 返回 ?
ThisSymbolValue (this value)。
该实参会被忽略。
此属性具有特性 { [[Writable]]:
此方法的
20.4.3.6 Symbol.prototype [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
20.4.4 Symbol 实例的属性
Symbol 实例是继承自
20.4.5 Symbol 的抽象操作
20.4.5.1 GlobalSymbolRegistry 记录
GlobalSymbolRegistry 记录是一个记录值，用于将一个字符串键与通过
GlobalSymbolRegistry 记录具有
| 字段名称 | 值 | 用法 |
|---|---|---|
| [[Key]] | 一个字符串 | 一个用于全局标识 Symbol 的字符串键。 |
| [[Symbol]] | 一个 Symbol | 一个可从任何 |
20.4.5.2 KeyForSymbol ( symbol )
The abstract operation KeyForSymbol takes argument symbol (a Symbol) and returns a String or
20.5 Error 对象
运行时错误发生时，Error 对象的实例会作为异常被抛出。Error 对象也可以作为用户定义异常类的基对象。
当 ECMAScript 实现检测到运行时错误时，它会抛出
20.5.1 Error 构造器
Error 构造器：
- 是 %Error%。
- 是
全局对象 的"Error" 属性的初始值。 - 在作为函数而非构造器调用时创建并初始化一个新的 Error 对象。因此，函数调用
Error(…)等价于带有相同实参的对象创建表达式new Error(…)。 - 可以用作类定义的
extends子句的值。意图继承指定 Error 行为的子类构造器必须包含 对 Error 构造器的super调用，以创建并初始化带有 [[ErrorData]] 内部槽的子类实例。
20.5.1.1 Error ( message [ , options ] )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 是
undefined ，则令 newTarget 为活动函数对象 ；否则令 newTarget 为 NewTarget。 - 令 obj 为 ?
OrdinaryCreateFromConstructor (newTarget,"%Error.prototype%" , « [[ErrorData]] »)。 - 如果 message 不是
undefined ，则- 令 messageString 为 ?
ToString (message)。 - 执行
CreateNonEnumerableDataPropertyOrThrow (obj,"message" , messageString)。
- 令 messageString 为 ?
- 执行 ?
InstallErrorCause (obj, options)。 - 返回 obj。
20.5.2 Error 构造器的属性
Error 构造器：
- 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
20.5.2.1 Error.isError ( arg )
此函数在被调用时执行以下步骤：
- 如果 arg 不是 Object，则返回
false 。 - 如果 arg 没有 [[ErrorData]] 内部槽，则返回
false 。 - 返回
true 。
20.5.2.2 Error.prototype
Error.prototype 的初始值是
此属性具有特性 { [[Writable]]:
20.5.3 Error 原型对象的属性
Error 原型对象：
- 是 %Error.prototype%。
- 是
普通对象 。 - 不是 Error 实例，并且没有 [[ErrorData]] 内部槽。
- 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。
20.5.3.1 Error.prototype.constructor
Error.prototype.constructor 的初始值是
20.5.3.2 Error.prototype.message
Error.prototype.message 的初始值是空 String。
20.5.3.3 Error.prototype.name
Error.prototype.name 的初始值是
20.5.3.4 Error.prototype.toString ( )
此方法在被调用时执行以下步骤：
- 令 obj 为
this value。 - 如果 obj 不是 Object，则抛出
TypeError 异常。 - 令 name 为 ?
Get (obj,"name" )。 - 如果 name 是
undefined ，则将 name 设置为"Error" ；否则将 name 设置为 ?ToString (name)。 - 令 message 为 ?
Get (obj,"message" )。 - 如果 message 是
undefined ，则将 message 设置为空 String；否则将 message 设置为 ?ToString (message)。 - 如果 name 是空 String，则返回 message。
- 如果 message 是空 String，则返回 name。
- 返回 name、码元 0x003A（COLON）、码元 0x0020（SPACE）和 message 的
字符串连接 。
20.5.4 Error 实例的属性
Error 实例是Object.prototype.toString 和 Error.isError 中将 Error、AggregateError、SuppressedError 和 NativeError 实例识别为 Error 对象。
20.5.5 本标准使用的原生错误类型
当检测到运行时错误时，会抛出以下某个 NativeError 对象的新实例，或者 AggregateError 对象或 SuppressedError 对象的新实例。所有 NativeError 对象共享相同结构，如
20.5.5.1 EvalError
EvalError 构造器是 %EvalError%。
此异常当前未在本规范中使用。此对象保留是为了与本规范先前版本兼容。
20.5.5.2 RangeError
RangeError 构造器是 %RangeError%。
表示一个不在允许值集合或范围内的值。
20.5.5.3 ReferenceError
ReferenceError 构造器是 %ReferenceError%。
表示检测到了无效引用。
20.5.5.4 SyntaxError
SyntaxError 构造器是 %SyntaxError%。
表示发生了解析错误。
20.5.5.5 TypeError
TypeError 构造器是 %TypeError%。
当其他 NativeError 对象都不能适当地指示失败原因时，TypeError 用于表示未成功的操作。
20.5.5.6 URIError
URIError 构造器是 %URIError%。
表示某个全局 URI 处理函数以与其定义不兼容的方式被使用。
20.5.6 NativeError 对象结构
这些对象中的每一个都具有如下所述的结构，仅在用作构造器名称的名称以及原型对象的
对于每个错误对象，定义中对 NativeError 的引用应替换为来自
20.5.6.1 NativeError 构造器
每个 NativeError 构造器：
- 在作为函数而非构造器调用时创建并初始化一个新的 NativeError 对象。把该对象作为函数调用等价于以相同实参把它作为构造器调用。因此，函数调用
NativeError(…)等价于带有相同实参的对象创建表达式new NativeError(…)。 - 可以用作类定义的
extends子句的值。意图继承指定 NativeError 行为的子类构造器必须包含 对 NativeError 构造器的super调用，以创建并初始化带有 [[ErrorData]] 内部槽的子类实例。
20.5.6.1.1 NativeError ( message [ , options ] )
每个 NativeError 函数在被调用时执行以下步骤：
- 如果 NewTarget 是
undefined ，则令 newTarget 为活动函数对象 ；否则令 newTarget 为 NewTarget。 - 令 obj 为 ?
OrdinaryCreateFromConstructor (newTarget,"%NativeError.prototype%" , « [[ErrorData]] »)。 - 如果 message 不是
undefined ，则- 令 messageString 为 ?
ToString (message)。 - 执行
CreateNonEnumerableDataPropertyOrThrow (obj,"message" , messageString)。
- 令 messageString 为 ?
- 执行 ?
InstallErrorCause (obj, options)。 - 返回 obj。
步骤
20.5.6.2 NativeError 构造器的属性
每个 NativeError 构造器：
- 具有一个 [[Prototype]] 内部槽，其值为
%Error% 。 - 具有一个
"name" 属性，其值为 String 值"NativeError" 。 - 具有以下属性：
20.5.6.2.1 NativeError.prototype
NativeError.prototype 的初始值是一个 NativeError 原型对象（
此属性具有特性 { [[Writable]]:
20.5.6.3 NativeError 原型对象的属性
每个 NativeError 原型对象：
- 是
普通对象 。 - 不是 Error 实例，并且没有 [[ErrorData]] 内部槽。
- 具有一个 [[Prototype]] 内部槽，其值为
%Error.prototype% 。
20.5.6.3.1 NativeError.prototype.constructor
给定 NativeError 构造器的原型的
20.5.6.3.2 NativeError.prototype.message
给定 NativeError 构造器的原型的
20.5.6.3.3 NativeError.prototype.name
给定 NativeError 构造器的原型的
20.5.6.4 NativeError 实例的属性
NativeError 实例是Object.prototype.toString（Error.isError（
20.5.7 AggregateError 对象
20.5.7.1 AggregateError 构造器
AggregateError 构造器：
- 是 %AggregateError%。
- 是
全局对象 的"AggregateError" 属性的初始值。 - 在作为函数而非构造器调用时创建并初始化一个新的 AggregateError 对象。因此，函数调用
AggregateError(…)等价于带有相同实参的对象创建表达式new AggregateError(…)。 - 可以用作类定义的
extends子句的值。意图继承指定 AggregateError 行为的子类构造器必须包含 对 AggregateError 构造器的super调用，以创建并初始化带有 [[ErrorData]] 内部槽的子类实例。
20.5.7.1.1 AggregateError ( errors, message [ , options ] )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 是
undefined ，则令 newTarget 为活动函数对象 ；否则令 newTarget 为 NewTarget。 - 令 obj 为 ?
OrdinaryCreateFromConstructor (newTarget,"%AggregateError.prototype%" , « [[ErrorData]] »)。 - 如果 message 不是
undefined ，则- 令 messageString 为 ?
ToString (message)。 - 执行
CreateNonEnumerableDataPropertyOrThrow (obj,"message" , messageString)。
- 令 messageString 为 ?
- 执行 ?
InstallErrorCause (obj, options)。 - 令 errorsList 为 ?
IteratorToList (?GetIterator (errors,sync ))。 - 执行 !
DefinePropertyOrThrow (obj,"errors" , PropertyDescriptor { [[Configurable]]:true , [[Enumerable]]:false , [[Writable]]:true , [[Value]]:CreateArrayFromList (errorsList) })。 - 返回 obj。
20.5.7.2 AggregateError 构造器的属性
AggregateError 构造器：
- 具有一个 [[Prototype]] 内部槽，其值为
%Error% 。 - 具有以下属性：
20.5.7.2.1 AggregateError.prototype
AggregateError.prototype 的初始值是
此属性具有特性 { [[Writable]]:
20.5.7.3 AggregateError 原型对象的属性
AggregateError 原型对象：
- 是 %AggregateError.prototype%。
- 是
普通对象 。 - 不是 Error 实例或 AggregateError 实例，并且没有 [[ErrorData]] 内部槽。
- 具有一个 [[Prototype]] 内部槽，其值为
%Error.prototype% 。
20.5.7.3.1 AggregateError.prototype.constructor
AggregateError.prototype.constructor 的初始值是
20.5.7.3.2 AggregateError.prototype.message
AggregateError.prototype.message 的初始值是空 String。
20.5.7.3.3 AggregateError.prototype.name
AggregateError.prototype.name 的初始值是
20.5.7.4 AggregateError 实例的属性
AggregateError 实例是Object.prototype.toString（Error.isError（
20.5.8 SuppressedError 对象
20.5.8.1 SuppressedError 构造函数
SuppressedError
- 是 %SuppressedError%。
- 是
全局对象 的"SuppressedError" 属性的初始值。 - 在作为函数而非
构造函数 调用时，创建并初始化一个新的 SuppressedError 对象。因此，函数调用SuppressedError(…)等价于带有相同实参的对象创建表达式new SuppressedError(…)。 - 可用作类定义的
extends子句的值。意图继承指定 SuppressedError 行为的子类构造函数 ，必须包含 一次对 SuppressedError构造函数 的super调用，以创建并初始化带有 [[ErrorData]] 内部槽的子类实例。
20.5.8.1.1 SuppressedError ( error, suppressed, message )
调用此函数时，它执行以下步骤：
- 如果 NewTarget 是
undefined ，则令 newTarget 为活动函数对象 ；否则令 newTarget 为 NewTarget。 - 令 obj 为 ?
OrdinaryCreateFromConstructor (newTarget,"%SuppressedError.prototype%" , « [[ErrorData]] »)。 - 如果 message 不是
undefined ，则- 令 messageString 为 ?
ToString (message)。 - 执行
CreateNonEnumerableDataPropertyOrThrow (obj,"message" , messageString)。
- 令 messageString 为 ?
- 执行
CreateNonEnumerableDataPropertyOrThrow (obj,"error" , error)。 - 执行
CreateNonEnumerableDataPropertyOrThrow (obj,"suppressed" , suppressed)。 - 返回 obj。
20.5.8.2 SuppressedError 构造函数的属性
SuppressedError
- 具有一个值为
%Error% 的 [[Prototype]] 内部槽。 - 具有以下属性：
20.5.8.2.1 SuppressedError.prototype
SuppressedError.prototype 的初始值是
此属性具有特性 { [[Writable]]:
20.5.8.3 SuppressedError 原型对象的属性
SuppressedError 原型对象：
- 是 %SuppressedError.prototype%。
- 是一个
普通对象 。 - 不是 Error 实例，也不是 SuppressedError 实例，并且没有 [[ErrorData]] 内部槽。
- 具有一个值为
%Error.prototype% 的 [[Prototype]] 内部槽。
20.5.8.3.1 SuppressedError.prototype.constructor
SuppressedError.prototype.constructor 的初始值是
20.5.8.3.2 SuppressedError.prototype.message
SuppressedError.prototype.message 的初始值是空 String。
20.5.8.3.3 SuppressedError.prototype.name
SuppressedError.prototype.name 的初始值是
20.5.8.4 SuppressedError 实例的属性
SuppressedError 实例是Object.prototype.toString 和 Error.isError 中将 Error、AggregateError、SuppressedError 和 NativeError 实例识别为 Error 对象。
20.5.9 Error 对象的抽象操作
20.5.9.1 InstallErrorCause ( obj, options )
The abstract operation InstallErrorCause takes arguments obj (an Object) and options (an ECMAScript language value) and returns either a normal completion containing
- 如果 options 是 Object 且 ?
HasProperty (options,"cause" ) 是true ，则- 令 cause 为 ?
Get (options,"cause" )。 - 执行
CreateNonEnumerableDataPropertyOrThrow (obj,"cause" , cause)。
- 令 cause 为 ?
- 返回
unused 。
21 数字和日期
21.1 Number 对象
21.1.1 Number 构造器
Number 构造器：
- 是 %Number%。
- 是
全局对象 的"Number" 属性的初始值。 - 在作为构造器调用时创建并初始化一个新的 Number 对象。
- 在作为函数而非构造器调用时执行类型转换。
- 可以用作类定义的
extends子句的值。意图继承指定 Number 行为的子类构造器必须包含 对 Number 构造器的super调用，以创建并初始化带有 [[NumberData]] 内部槽的子类实例。
21.1.1.1 Number ( value )
此函数在被调用时执行以下步骤：
- 如果 value 存在，则
- 否则，
- 令 n 为
+0 𝔽。
- 令 n 为
- 如果 NewTarget 是
undefined ，则返回 n。 - 令 obj 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%Number.prototype%" , « [[NumberData]] »)。 - 将 obj.[[NumberData]] 设置为 n。
- 返回 obj。
21.1.2 Number 构造器的属性
Number 构造器：
- 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
21.1.2.1 Number.EPSILON
Number.EPSILON 的值是 1 与可表示为
此属性具有特性 { [[Writable]]:
21.1.2.2 Number.isFinite ( number )
此函数在被调用时执行以下步骤：
- 如果 number 不是 Number，则返回
false 。 - 如果 number 不是
有限 的，则返回false 。 - 返回
true 。
21.1.2.3 Number.isInteger ( number )
此函数在被调用时执行以下步骤：
- 如果 number 是整数 Number，则返回
true 。 - 返回
false 。
21.1.2.4 Number.isNaN ( number )
此函数在被调用时执行以下步骤：
- 如果 number 不是 Number，则返回
false 。 - 如果 number 是
NaN ，则返回true 。 - 返回
false 。
此函数不同于全局 isNaN 函数（
21.1.2.5 Number.isSafeInteger ( number )
此函数在被调用时执行以下步骤：
21.1.2.6 Number.MAX_SAFE_INTEGER
由于 Number.MAX_SAFE_INTEGER 的整数的 9007199254740992 和 9007199254740993 都会求值为
Number.MAX_SAFE_INTEGER 的值是
此属性具有特性 { [[Writable]]:
21.1.2.7 Number.MAX_VALUE
Number.MAX_VALUE 的值是
此属性具有特性 { [[Writable]]:
21.1.2.8 Number.MIN_SAFE_INTEGER
由于 Number.MIN_SAFE_INTEGER 的整数的 -9007199254740992 和 -9007199254740993 都会求值为
Number.MIN_SAFE_INTEGER 的值是
此属性具有特性 { [[Writable]]:
21.1.2.9 Number.MIN_VALUE
Number.MIN_VALUE 的值是
在 Number.MIN_VALUE 的值必须是该实现实际可表示的最小非零正值。
此属性具有特性 { [[Writable]]:
21.1.2.10 Number.NaN
Number.NaN 的值是
此属性具有特性 { [[Writable]]:
21.1.2.11 Number.NEGATIVE_INFINITY
Number.NEGATIVE_INFINITY 的值是
此属性具有特性 { [[Writable]]:
21.1.2.12 Number.parseFloat ( string )
21.1.2.13 Number.parseInt ( string, radix )
21.1.2.14 Number.POSITIVE_INFINITY
Number.POSITIVE_INFINITY 的值是
此属性具有特性 { [[Writable]]:
21.1.2.15 Number.prototype
Number.prototype 的初始值是
此属性具有特性 { [[Writable]]:
21.1.3 Number 原型对象的属性
Number 原型对象：
- 是 %Number.prototype%。
- 是
普通对象 。 - 自身是 Number 对象；它具有一个 [[NumberData]] 内部槽，其值为
+0 𝔽。 - 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。
除非另有明确说明，下文定义的 Number 原型对象的方法不是泛型的，传给它们的
在某个方法的规范中，短语“this Number value”指以该方法调用的
21.1.3.1 Number.prototype.constructor
Number.prototype.constructor 的初始值是
21.1.3.2 Number.prototype.toExponential ( fractionDigits )
此方法返回一个 String，其中
它在被调用时执行以下步骤：
- 令 number 为 ?
ThisNumberValue (this value)。 - 令 fractionCount 为 ?
ToIntegerOrInfinity (fractionDigits)。 - 断言：如果 fractionDigits 是
undefined ，则 fractionCount 是 0。 - 如果 number 不是
有限 的，则返回Number::toString (number, 10)。 - 如果 fractionCount < 0 或 fractionCount > 100，则抛出
RangeError 异常。 - 将 number 设置为
ℝ (number)。 - 令 sign 为空 String。
- 如果 number < 0，则
- 将 sign 设置为
"-" 。 - 将 number 设置为 -number。
- 将 sign 设置为
- 如果 number = 0，则
- 令 significand 为由 fractionCount + 1 个码元 0x0030（DIGIT ZERO）组成的 String 值。
- 令 exponent 为 0。
- 否则，
- 如果 fractionDigits 不是
undefined ，则- 令 exponent 和 intSignificand 为这样的整数：10fractionCount ≤ intSignificand < 10fractionCount + 1，并且 intSignificand × 10exponent - fractionCount - number 尽可能接近零。如果存在两组这样的 exponent 和 intSignificand，则选择使 intSignificand × 10exponent - fractionCount 较大的那组 exponent 和 intSignificand。
- 否则，
- 令 significand 为由 intSignificand 的十进制表示的数字组成的 String 值（按顺序，且没有前导零）。
- 如果 fractionDigits 不是
- 如果 fractionCount ≠ 0，则
- 令 intPart 为 significand 的第一个码元。
- 令 fractionalPart 为 significand 的其他 fractionCount 个码元。
- 将 significand 设置为 intPart、
"." 和 fractionalPart 的字符串连接 。
- 如果 exponent = 0，则
- 令 exponentSign 为
"+" 。 - 令 exponentDigits 为
"0" 。
- 令 exponentSign 为
- 否则，
- 如果 exponent > 0，则
- 令 exponentSign 为
"+" 。
- 令 exponentSign 为
- 否则，
- 断言：exponent < 0。
- 令 exponentSign 为
"-" 。 - 将 exponent 设置为 -exponent。
- 令 exponentDigits 为由 exponent 的十进制表示的数字组成的 String 值（按顺序，且没有前导零）。
- 如果 exponent > 0，则
- 将 significand 设置为 significand、
"e" 、exponentSign 和 exponentDigits 的字符串连接 。 - 返回 sign 和 significand 的
字符串连接 。
对于提供比上述规则所要求更精确转换的实现，建议使用步骤
21.1.3.3 Number.prototype.toFixed ( fractionDigits )
此方法返回一个 String，其中
它在被调用时执行以下步骤：
- 令 number 为 ?
ThisNumberValue (this value)。 - 令 fractionCount 为 ?
ToIntegerOrInfinity (fractionDigits)。 - 断言：如果 fractionDigits 是
undefined ，则 fractionCount 是 0。 - 如果 fractionCount 不是
有限 的，则抛出RangeError 异常。 - 如果 fractionCount < 0 或 fractionCount > 100，则抛出
RangeError 异常。 - 如果 number 不是
有限 的，则返回Number::toString (number, 10)。 - 将 number 设置为
ℝ (number)。 - 令 sign 为空 String。
- 如果 number < 0，则
- 将 sign 设置为
"-" 。 - 将 number 设置为 -number。
- 将 sign 设置为
- 如果 number ≥ 1021，则
- 否则，
- 令 intValue 为这样的整数：intValue / 10fractionCount - number 尽可能接近零。如果存在两个这样的 intValue，则选择较大的 intValue。
- 如果 intValue = 0，则令 digitString 为
"0" ；否则令 digitString 为由 intValue 的十进制表示的数字组成的 String 值（按顺序，且没有前导零）。 - 如果 fractionCount ≠ 0，则
- 令 digitCount 为 digitString 的长度。
- 如果 digitCount ≤ fractionCount，则
- 令 zeroPad 为由 fractionCount + 1 - digitCount 个码元 0x0030（DIGIT ZERO）组成的 String 值。
- 将 digitString 设置为 zeroPad 和 digitString 的
字符串连接 。 - 将 digitCount 设置为 fractionCount + 1。
- 令 intPart 为 digitString 的前 digitCount - fractionCount 个码元。
- 令 fractionalPart 为 digitString 的其他 fractionCount 个码元。
- 将 digitString 设置为 intPart、
"." 和 fractionalPart 的字符串连接 。
- 返回 sign 和 digitString 的
字符串连接 。
对于某些值，toFixed 的输出可能比 toString 更精确，因为 toString 只打印足以把该数字与相邻
(1000000000000000128).toString() 返回
(1000000000000000128).toFixed(0) 返回
21.1.3.4 Number.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
此方法产生一个 String 值，表示根据toString 相同的结果。
此方法可选参数的含义在 ECMA-402 规范中定义；不
21.1.3.5 Number.prototype.toPrecision ( precision )
此方法返回一个 String，其中
它在被调用时执行以下步骤：
- 令 number 为 ?
ThisNumberValue (this value)。 - 如果 precision 是
undefined ，则返回 !ToString (number)。 - 令 precisionCount 为 ?
ToIntegerOrInfinity (precision)。 - 如果 number 不是
有限 的，则返回Number::toString (number, 10)。 - 如果 precisionCount < 1 或 precisionCount > 100，则抛出
RangeError 异常。 - 将 number 设置为
ℝ (number)。 - 令 sign 为空 String。
- 如果 number < 0，则
- 将 sign 设置为码元 0x002D（HYPHEN-MINUS）。
- 将 number 设置为 -number。
- 如果 number = 0，则
- 令 significand 为由 precisionCount 个码元 0x0030（DIGIT ZERO）组成的 String 值。
- 令 exponent 为 0。
- 否则，
- 令 exponent 和 intSignificand 为这样的整数：10precisionCount - 1 ≤ intSignificand < 10precisionCount，并且 intSignificand × 10exponent - precisionCount + 1 - number 尽可能接近零。如果存在两组这样的 exponent 和 intSignificand，则选择使 intSignificand × 10exponent - precisionCount + 1 较大的那组 exponent 和 intSignificand。
- 令 significand 为由 intSignificand 的十进制表示的数字组成的 String 值（按顺序，且没有前导零）。
- 如果 exponent < -6 或 exponent ≥ precisionCount，则
- 断言：exponent ≠ 0。
- 如果 precisionCount ≠ 1，则
- 令 intPart 为 significand 的第一个码元。
- 令 fractionalPart 为 significand 的其他 precisionCount - 1 个码元。
- 将 significand 设置为 intPart、
"." 和 fractionalPart 的字符串连接 。
- 如果 exponent > 0，则
- 令 exponentSign 为码元 0x002B（PLUS SIGN）。
- 否则，
- 断言：exponent < 0。
- 令 exponentSign 为码元 0x002D（HYPHEN-MINUS）。
- 将 exponent 设置为 -exponent。
- 令 exponentDigits 为由 exponent 的十进制表示的数字组成的 String 值（按顺序，且没有前导零）。
- 返回 sign、significand、码元 0x0065（LATIN SMALL LETTER E）、exponentSign 和 exponentDigits 的
字符串连接 。
- 如果 exponent = precisionCount - 1，则返回 sign 和 significand 的
字符串连接 。 - 如果 exponent ≥ 0，则
- 将 significand 设置为 significand 的前 exponent + 1 个码元、码元 0x002E（FULL STOP）和 significand 的剩余 precisionCount - (exponent + 1) 个码元的
字符串连接 。
- 将 significand 设置为 significand 的前 exponent + 1 个码元、码元 0x002E（FULL STOP）和 significand 的剩余 precisionCount - (exponent + 1) 个码元的
- 否则，
- 将 significand 设置为码元 0x0030（DIGIT ZERO）、码元 0x002E（FULL STOP）、-(exponent + 1) 个码元 0x0030（DIGIT ZERO）和 String significand 的
字符串连接 。
- 将 significand 设置为码元 0x0030（DIGIT ZERO）、码元 0x002E（FULL STOP）、-(exponent + 1) 个码元 0x0030（DIGIT ZERO）和 String significand 的
- 返回 sign 和 significand 的
字符串连接 。
21.1.3.6 Number.prototype.toString ( [ radix ] )
此方法在被调用时执行以下步骤：
- 令 x 为 ?
ThisNumberValue (this value)。 - 如果 radix 是
undefined ，则令 radixMV 为 10。 - 否则，令 radixMV 为 ?
ToIntegerOrInfinity (radix)。 - 如果 radixMV 不在从 2 到 36 的
闭区间 内，则抛出RangeError 异常。 - 返回
Number::toString (x, radixMV)。
此方法不是泛型的；如果其
此方法的
21.1.3.7 Number.prototype.valueOf ( )
- 返回 ?
ThisNumberValue (this value)。
21.1.3.7.1 ThisNumberValue ( arg )
The abstract operation ThisNumberValue takes argument arg (an ECMAScript language value) and returns either a normal completion containing a Number or a throw completion. It performs the following steps when called:
- 如果 arg 是 Number，则返回 arg。
- 如果 arg 是 Object 且 arg 具有 [[NumberData]] 内部槽，则
- 令 number 为 arg.[[NumberData]]。
- 断言：number 是 Number。
- 返回 number。
- 抛出
TypeError 异常。
21.1.4 Number 实例的属性
Number 实例是继承自
21.2 BigInt 对象
21.2.1 BigInt 构造器
BigInt 构造器：
- 是 %BigInt%。
- 是
全局对象 的"BigInt" 属性的初始值。 - 在作为函数而非构造器调用时执行类型转换。
- 并非旨在与
new运算符一起使用或被子类化。它可以用作类定义的extends子句的值，但对 BigInt 构造器进行super调用会导致异常。
21.2.1.1 BigInt ( value )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 不是
undefined ，则抛出TypeError 异常。 - 令 primitive 为 ?
ToPrimitive (value,number )。 - 如果 primitive 是 Number，则返回 ?
NumberToBigInt (primitive)。 - 返回 ?
ToBigInt (primitive)。
21.2.1.1.1 NumberToBigInt ( number )
The abstract operation NumberToBigInt takes argument number (a Number) and returns either a normal completion containing a BigInt or a throw completion. It performs the following steps when called:
21.2.2 BigInt 构造器的属性
BigInt 构造器：
- 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
21.2.2.1 BigInt.asIntN ( bits, bigint )
此函数在被调用时执行以下步骤：
21.2.2.2 BigInt.asUintN ( bits, bigint )
此函数在被调用时执行以下步骤：
21.2.2.3 BigInt.prototype
BigInt.prototype 的初始值是
此属性具有特性 { [[Writable]]:
21.2.3 BigInt 原型对象的属性
BigInt 原型对象：
- 是 %BigInt.prototype%。
- 是
普通对象 。 - 不是 BigInt 对象；它没有 [[BigIntData]] 内部槽。
- 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。
在某个方法的规范中，短语“this BigInt value”指以该方法调用的
21.2.3.1 BigInt.prototype.constructor
BigInt.prototype.constructor 的初始值是
21.2.3.2 BigInt.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
此方法产生一个 String 值，表示根据toString 相同的结果。
此方法可选参数的含义在 ECMA-402 规范中定义；不
21.2.3.3 BigInt.prototype.toString ( [ radix ] )
此方法在被调用时执行以下步骤：
- 令 x 为 ?
ThisBigIntValue (this value)。 - 如果 radix 是
undefined ，则令 radixMV 为 10。 - 否则，令 radixMV 为 ?
ToIntegerOrInfinity (radix)。 - 如果 radixMV 不在从 2 到 36 的
闭区间 内，则抛出RangeError 异常。 - 返回
BigInt::toString (x, radixMV)。
此方法不是泛型的；如果其
21.2.3.4 BigInt.prototype.valueOf ( )
- 返回 ?
ThisBigIntValue (this value)。
21.2.3.4.1 ThisBigIntValue ( arg )
The abstract operation ThisBigIntValue takes argument arg (an ECMAScript language value) and returns either a normal completion containing a BigInt or a throw completion. It performs the following steps when called:
- 如果 arg 是 BigInt，则返回 arg。
- 如果 arg 是 Object 且 arg 具有 [[BigIntData]] 内部槽，则
- 断言：arg.[[BigIntData]] 是 BigInt。
- 返回 arg.[[BigIntData]]。
- 抛出
TypeError 异常。
21.2.3.5 BigInt.prototype [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
21.2.4 BigInt 实例的属性
BigInt 实例是继承自
21.3 Math 对象
Math 对象：
- 是 %Math%。
- 是
全局对象 的"Math" 属性的初始值。 - 是
普通对象 。 - 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 不是
函数对象 。 - 没有 [[Construct]] 内部方法；它不能作为构造器与
new运算符一起使用。 - 没有 [[Call]] 内部方法；它不能作为函数调用。
在本规范中，短语“the Number value for x”具有
21.3.1 Math 对象的值属性
21.3.1.1 Math.E
e（自然对数的底）的
此属性具有特性 { [[Writable]]:
21.3.1.2 Math.LN10
10 的自然对数的
此属性具有特性 { [[Writable]]:
21.3.1.3 Math.LN2
2 的自然对数的
此属性具有特性 { [[Writable]]:
21.3.1.4 Math.LOG10E
e（自然对数的底）的以 10 为底的对数的
此属性具有特性 { [[Writable]]:
Math.LOG10E 的值约为 Math.LN10 值的倒数。
21.3.1.5 Math.LOG2E
e（自然对数的底）的以 2 为底的对数的
此属性具有特性 { [[Writable]]:
Math.LOG2E 的值约为 Math.LN2 值的倒数。
21.3.1.6 Math.PI
π（圆的周长与直径之比）的
此属性具有特性 { [[Writable]]:
21.3.1.7 Math.SQRT1_2
½ 的平方根的
此属性具有特性 { [[Writable]]:
Math.SQRT1_2 的值约为 Math.SQRT2 值的倒数。
21.3.1.8 Math.SQRT2
2 的平方根的
此属性具有特性 { [[Writable]]:
21.3.1.9 Math [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
21.3.2 Math 对象的函数属性
函数 acos、acosh、asin、asinh、atan、atanh、atan2、cbrt、cos、cosh、exp、expm1、hypot、log、log1p、log2、log10、pow、random、sin、sinh、tan 和 tanh 的行为在这里没有精确规定，除了要求对于某些表示相关边界情况的实参值给出特定结果。对于其他实参值，这些函数旨在计算熟悉数学函数结果的近似值，但在近似算法的选择上允许一定的自由度。总体意图是，实现者应能够在给定硬件平台上为 ECMAScript 使用与该平台上 C 程序员可用的相同数学库。
尽管算法的选择留给实现，但建议（而非本标准规定）实现使用 fdlibm 中fdlibm 是 Sun Microsystems 的可自由分发数学库（http://www.netlib.org/fdlibm）。
21.3.2.1 Math.abs ( x )
此函数返回 x 的绝对值；结果具有与 x 相同的大小，但符号为正。
它在被调用时执行以下步骤：
- 令 n 为 ?
ToNumber (x)。 - 如果 n 是
NaN ，则返回NaN 。 - 如果 n 是
-0 𝔽，则返回+0 𝔽。 - 如果 n 是
-∞ 𝔽，则返回+∞ 𝔽。 - 如果 n <
-0 𝔽，则返回 -n。 - 返回 n。
21.3.2.2 Math.acos ( x )
此函数返回 x 的反余弦。结果以弧度表示，并位于从
它在被调用时执行以下步骤：
21.3.2.3 Math.acosh ( x )
此函数返回 x 的反双曲余弦。
它在被调用时执行以下步骤：
21.3.2.4 Math.asin ( x )
此函数返回 x 的反正弦。结果以弧度表示，并位于从
它在被调用时执行以下步骤：
21.3.2.5 Math.asinh ( x )
此函数返回 x 的反双曲正弦。
它在被调用时执行以下步骤：
21.3.2.6 Math.atan ( x )
此函数返回 x 的反正切。结果以弧度表示，并位于从
它在被调用时执行以下步骤：
21.3.2.7 Math.atanh ( x )
此函数返回 x 的反双曲正切。
它在被调用时执行以下步骤：
21.3.2.8 Math.atan2 ( y, x )
此函数返回实参 y 和 x 的商
它在被调用时执行以下步骤：
- 令 ny 为 ?
ToNumber (y)。 - 令 nx 为 ?
ToNumber (x)。 - 如果 ny 是
NaN 或 nx 是NaN ，则返回NaN 。 - 如果 ny 是
+∞ 𝔽，则 - 如果 ny 是
-∞ 𝔽，则 - 如果 ny 是
+0 𝔽，则- 如果 nx >
+0 𝔽 或 nx 是+0 𝔽，则返回+0 𝔽。 - 返回表示 π 的实现近似
Number 值 。
- 如果 nx >
- 如果 ny 是
-0 𝔽，则- 如果 nx >
+0 𝔽 或 nx 是+0 𝔽，则返回-0 𝔽。 - 返回表示 -π 的实现近似
Number 值 。
- 如果 nx >
- 断言：ny 是
有限 的，并且既不是+0 𝔽 也不是-0 𝔽。 - 如果 ny >
+0 𝔽，则 - 如果 ny <
-0 𝔽，则 - 断言：nx 是
有限 的，并且既不是+0 𝔽 也不是-0 𝔽。 - 令 result 为
abs (ℝ (ny) /ℝ (nx)) 的反正切。 - 如果 nx <
-0 𝔽，则- 如果 ny >
+0 𝔽，则将 result 设置为 π - result。 - 否则，将 result 设置为 -π + result。
- 如果 ny >
- 否则，
- 如果 ny <
-0 𝔽，则将 result 设置为 -result。
- 如果 ny <
- 返回表示 result 的实现近似
Number 值 。
21.3.2.9 Math.cbrt ( x )
此函数返回 x 的立方根。
它在被调用时执行以下步骤：
21.3.2.10 Math.ceil ( x )
此函数返回不小于 x 的最小（最接近 -∞ 的）整数
它在被调用时执行以下步骤：
Math.ceil(x) 的值与 -Math.floor(-x) 的值相同。
21.3.2.11 Math.clz32 ( x )
此函数在被调用时执行以下步骤：
如果 n 是
21.3.2.12 Math.cos ( x )
此函数返回 x 的余弦。实参以弧度表示。
它在被调用时执行以下步骤：
21.3.2.13 Math.cosh ( x )
此函数返回 x 的双曲余弦。
它在被调用时执行以下步骤：
Math.cosh(x) 的值与 (Math.exp(x) + Math.exp(-x)) / 2 的值相同。
21.3.2.14 Math.exp ( x )
此函数返回 x 的指数函数（e 的 x 次幂，其中 e 是自然对数的底）。
它在被调用时执行以下步骤：
21.3.2.15 Math.expm1 ( x )
此函数返回从 x 的指数函数（e 的 x 次幂，其中 e 是自然对数的底）中减去 1 的结果。即使 x 的值接近 0，也会以准确的方式计算该结果。
它在被调用时执行以下步骤：
21.3.2.16 Math.floor ( x )
此函数返回不大于 x 的最大（最接近 +∞ 的）整数
它在被调用时执行以下步骤：
Math.floor(x) 的值与 -Math.ceil(-x) 的值相同。
21.3.2.17 Math.fround ( x )
此函数在被调用时执行以下步骤：
- 令 n 为 ?
ToNumber (x)。 - 如果 n 是
NaN ，则返回NaN 。 - 如果 n 是
+0 𝔽、-0 𝔽、+∞ 𝔽 或-∞ 𝔽 之一，则返回 n。 - 令 n32 为使用 roundTiesToEven 模式把 n 转换为
IEEE 754-2019 binary32 格式的结果。 - 令 n64 为把 n32 转换为
IEEE 754-2019 binary64 格式的结果。 - 返回与 n64 对应的 ECMAScript
Number 值 。
21.3.2.18 Math.f16round ( x )
此函数在被调用时执行以下步骤：
- 令 n 为 ?
ToNumber (x)。 - 如果 n 是
NaN ，则返回NaN 。 - 如果 n 是
+0 𝔽、-0 𝔽、+∞ 𝔽 或-∞ 𝔽 之一，则返回 n。 - 令 n16 为使用 roundTiesToEven 模式把 n 转换为
IEEE 754-2019 binary16 格式的结果。 - 令 n64 为把 n16 转换为
IEEE 754-2019 binary64 格式的结果。 - 返回与 n64 对应的 ECMAScript
Number 值 。
此操作不同于先转换为 binary32 再转换为 binary16，因为存在双重舍入的可能性：例如考虑数字 k =
并非所有平台都提供从 binary64 转换到 binary16 的原生支持。有多种库可以提供此功能，包括 MIT 许可的 half 库。另一种做法是先在 roundTiesToEven 下从 binary64 转换到 binary32，然后检查该结果是否可能导致不正确的双重舍入。可以通过调整 binary32 值的尾数来显式处理这些情况，使其成为在 roundTiesToOdd 下执行初始转换会产生的值。然后在 roundTiesToEven 下把调整后的值转换为 binary16，就会产生正确值。
21.3.2.19 Math.hypot ( ...args )
给定零个或多个实参，此函数返回其实参平方和的平方根。
它在被调用时执行以下步骤：
- 令 coerced 为新的空
List 。 - 对 args 的每个元素 arg，执行：
- 令 n 为 ?
ToNumber (arg)。 - 将 n 追加到 coerced。
- 令 n 为 ?
- 对 coerced 的每个元素 number，执行：
- 如果 number 是
+∞ 𝔽 或-∞ 𝔽，则返回+∞ 𝔽。
- 如果 number 是
- 令 onlyZero 为
true 。 - 对 coerced 的每个元素 number，执行：
- 如果 number 是
NaN ，则返回NaN 。 - 如果 number 既不是
+0 𝔽 也不是-0 𝔽，则将 onlyZero 设置为false 。
- 如果 number 是
- 如果 onlyZero 是
true ，则返回+0 𝔽。 - 返回表示 coerced 中各元素
数学值 平方和的平方根的实现近似Number 值 。
此函数的
当此函数以两个或更多实参调用时，实现应注意避免朴素实现中容易发生的上溢和下溢所导致的精度损失。
21.3.2.20 Math.imul ( x, y )
此函数在被调用时执行以下步骤：
21.3.2.21 Math.log ( x )
此函数返回 x 的自然对数。
它在被调用时执行以下步骤：
21.3.2.22 Math.log1p ( x )
此函数返回 1 + x 的自然对数。即使 x 的值接近零，也会以准确的方式计算该结果。
它在被调用时执行以下步骤：
21.3.2.23 Math.log10 ( x )
此函数返回 x 的以 10 为底的对数。
它在被调用时执行以下步骤：
21.3.2.24 Math.log2 ( x )
此函数返回 x 的以 2 为底的对数。
它在被调用时执行以下步骤：
21.3.2.25 Math.max ( ...args )
给定零个或多个实参，此函数对每个实参调用
它在被调用时执行以下步骤：
用于确定最大值的值比较使用
此函数的
21.3.2.26 Math.min ( ...args )
给定零个或多个实参，此函数对每个实参调用
它在被调用时执行以下步骤：
用于确定最小值的值比较使用
此函数的
21.3.2.27 Math.pow ( base, exponent )
此函数在被调用时执行以下步骤：
- 将 base 设置为 ?
ToNumber (base)。 - 将 exponent 设置为 ?
ToNumber (exponent)。 - 返回
Number::exponentiate (base, exponent)。
21.3.2.28 Math.random ( )
此函数返回一个符号为正、大于或等于
为不同 Math.random 函数，必须从连续调用中产生不同的值序列。
21.3.2.29 Math.round ( x )
此函数返回最接近 x 且为整数的
它在被调用时执行以下步骤：
Math.round(3.5) 返回 4，但 Math.round(-3.5) 返回 -3。
Math.round(x) 的值不总是与 Math.floor(x + 0.5) 的值相同。当 x 是 x 小于 Math.round(x) 返回 Math.floor(x + 0.5) 返回 x + 0.5 时的内部舍入，Math.round(x) 也可能不同于 Math.floor(x + 0.5) 的值。
21.3.2.30 Math.sign ( x )
此函数返回 x 的符号，指示 x 是正、负还是零。
它在被调用时执行以下步骤：
- 令 n 为 ?
ToNumber (x)。 - 如果 n 是
NaN 、+0 𝔽 或-0 𝔽 之一，则返回 n。 - 如果 n <
-0 𝔽，则返回-1 𝔽。 - 返回
1 𝔽。
21.3.2.31 Math.sin ( x )
此函数返回 x 的正弦。实参以弧度表示。
它在被调用时执行以下步骤：
21.3.2.32 Math.sinh ( x )
此函数返回 x 的双曲正弦。
它在被调用时执行以下步骤：
Math.sinh(x) 的值与 (Math.exp(x) - Math.exp(-x)) / 2 的值相同。
21.3.2.33 Math.sqrt ( x )
此函数返回 x 的平方根。
它在被调用时执行以下步骤：
21.3.2.34 Math.sumPrecise ( items )
给定一个 Numbers 的可迭代对象，此函数对可迭代对象中的每个值求和，并返回其和。如果任何值不是 Number，则抛出
它在被调用时执行以下步骤：
- 执行 ?
RequireObjectCoercible (items)。 - 令 iteratorRecord 为 ?
GetIterator (items,sync )。 - 令 state 为
minus-zero 。 - 令 sum 为 0。
- 令 count 为 0。
- 令 next 为
not-started 。 - 重复，只要 next 不是
done ，- 将 next 设置为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 不是
done ，则- 如果 count ≥ 253 - 1，则
- 注：在实践中不预计会达到此步骤，
包含 它只是为了使实现可以依赖输入为“合理大小”而不违反本规范。 - 令 error 为
ThrowCompletion (一个新创建的RangeError 对象)。 - 返回 ?
IteratorClose (iteratorRecord, error)。
- 注：在实践中不预计会达到此步骤，
- 如果 next 不是 Number，则
- 令 error 为
ThrowCompletion (一个新创建的TypeError 对象)。 - 返回 ?
IteratorClose (iteratorRecord, error)。
- 令 error 为
- 令 n 为 next。
- 如果 state 不是
not-a-number ，则- 如果 n 是
NaN ，则- 将 state 设置为
not-a-number 。
- 将 state 设置为
- 否则，如果 n 是
+∞ 𝔽，则- 如果 state 是
minus-infinity ，则将 state 设置为not-a-number 。 - 否则，将 state 设置为
plus-infinity 。
- 如果 state 是
- 否则，如果 n 是
-∞ 𝔽，则- 如果 state 是
plus-infinity ，则将 state 设置为not-a-number 。 - 否则，将 state 设置为
minus-infinity 。
- 如果 state 是
- 否则，如果 n 不是
-0 𝔽 且 state 是minus-zero 或finite ，则- 将 state 设置为
finite 。 - 将 sum 设置为 sum +
ℝ (n)。
- 将 state 设置为
- 如果 n 是
- 将 count 设置为 count + 1。
- 如果 count ≥ 253 - 1，则
- 将 next 设置为 ?
- 如果 state 是
not-a-number ，则返回NaN 。 - 如果 state 是
plus-infinity ，则返回+∞ 𝔽。 - 如果 state 是
minus-infinity ，则返回-∞ 𝔽。 - 如果 state 是
minus-zero ，则返回-0 𝔽。 - 返回
𝔽 (sum)。
sum 的值可以通过多种算法在不使用任意精度算术的情况下计算。其中一种是 Jonathan Richard Shewchuk 在 Adaptive Precision Floating-Point Arithmetic and Fast Robust Geometric Predicates 中给出的“Grow-Expansion”算法。一个更新的算法见“Fast exact summation using small and large superaccumulators”，其代码可在 https://gitlab.com/radfordneal/xsum 获得。
21.3.2.35 Math.tan ( x )
此函数返回 x 的正切。实参以弧度表示。
它在被调用时执行以下步骤：
21.3.2.36 Math.tanh ( x )
此函数返回 x 的双曲正切。
它在被调用时执行以下步骤：
Math.tanh(x) 的值与 (Math.exp(x) - Math.exp(-x)) / (Math.exp(x) + Math.exp(-x)) 的值相同。
21.3.2.37 Math.trunc ( x )
此函数返回数字 x 的整数部分，移除任何小数位。如果 x 已经是整数，则结果为 x。
它在被调用时执行以下步骤：
21.4 Date 对象
21.4.1 Date 对象概述以及抽象操作定义
以下
21.4.1.1 时间值和时间范围
ECMAScript 中的时间度量类似于 POSIX 中的时间度量，特别是共享以预推格里高利历、UTC 1970 年 1 月 1 日开始时的午夜作为 epoch，并且把每一天都计为正好 86,400 秒（每秒长度为 1000 毫秒）的定义。
ECMAScript 时间值是 Number，要么是表示毫秒精度的时间瞬间的
时间值不考虑 UTC 闰秒——没有表示正闰秒内瞬间的时间值，并且存在表示因负闰秒而从 UTC 时间线移除的瞬间的时间值。不过，时间值的定义仍然产生与 UTC 的分段对齐，仅在闰秒边界处存在不连续，并且在闰秒之外差值为零。
Number 可以精确表示从 -9,007,199,254,740,992 到 9,007,199,254,740,992 的所有整数（
UTC 1970 年 1 月 1 日开始时午夜的精确时刻由时间值
在预推格里高利历中，闰年正是那些可被 4 整除并且可被 400 整除或不能被 100 整除的年份。
预推格里高利历的 400 年周期
21.4.1.2 时间相关常量
以下各节中的算法会引用这些常量。
21.4.1.3 Day ( tv )
The abstract operation Day takes argument tv (a finite time value) and returns an
21.4.1.4 TimeWithinDay ( tv )
The abstract operation TimeWithinDay takes argument tv (a finite time value) and returns an
21.4.1.5 DaysInYear ( y )
The abstract operation DaysInYear takes argument y (an
21.4.1.6 DayFromYear ( y )
The abstract operation DayFromYear takes argument y (an
- 令 ry 为
ℝ (y)。 - 注：在以下步骤中，numberYears1、numberYears4、numberYears100 和 numberYears400 分别表示在
epoch 与年份 y 开始之间出现的、可被 1、4、100 和 400 整除的年份数。如果 y 早于epoch ，则该数为负。 - 令 numberYears1 为 (ry - 1970)。
- 令 numberYears4 为
floor ((ry - 1969) / 4)。 - 令 numberYears100 为
floor ((ry - 1901) / 100)。 - 令 numberYears400 为
floor ((ry - 1601) / 400)。 - 返回
𝔽 (365 × numberYears1 + numberYears4 - numberYears100 + numberYears400)。
21.4.1.7 TimeFromYear ( y )
The abstract operation TimeFromYear takes argument y (an
- 返回
msPerDay ×DayFromYear (y)。
21.4.1.8 YearFromTime ( tv )
The abstract operation YearFromTime takes argument tv (a finite time value) and returns an
- 返回最大的整数 Number y（最接近 +∞），使得
TimeFromYear (y) ≤ tv。
21.4.1.9 DayWithinYear ( tv )
The abstract operation DayWithinYear takes argument tv (a finite time value) and returns an
- 返回
Day (tv) -DayFromYear (YearFromTime (tv))。
21.4.1.10 InLeapYear ( tv )
The abstract operation InLeapYear takes argument tv (a finite time value) and returns
- 如果
DaysInYear (YearFromTime (tv)) 是366 𝔽，则返回1 𝔽。 - 返回
+0 𝔽。
21.4.1.11 MonthFromTime ( tv )
The abstract operation MonthFromTime takes argument tv (a finite time value) and returns an
- 令 inLeapYear 为
InLeapYear (tv)。 - 令 dayWithinYear 为
DayWithinYear (tv)。 - 如果 dayWithinYear <
31 𝔽，则返回+0 𝔽。 - 如果 dayWithinYear <
59 𝔽 + inLeapYear，则返回1 𝔽。 - 如果 dayWithinYear <
90 𝔽 + inLeapYear，则返回2 𝔽。 - 如果 dayWithinYear <
120 𝔽 + inLeapYear，则返回3 𝔽。 - 如果 dayWithinYear <
151 𝔽 + inLeapYear，则返回4 𝔽。 - 如果 dayWithinYear <
181 𝔽 + inLeapYear，则返回5 𝔽。 - 如果 dayWithinYear <
212 𝔽 + inLeapYear，则返回6 𝔽。 - 如果 dayWithinYear <
243 𝔽 + inLeapYear，则返回7 𝔽。 - 如果 dayWithinYear <
273 𝔽 + inLeapYear，则返回8 𝔽。 - 如果 dayWithinYear <
304 𝔽 + inLeapYear，则返回9 𝔽。 - 如果 dayWithinYear <
334 𝔽 + inLeapYear，则返回10 𝔽。 - 断言：dayWithinYear <
365 𝔽 + inLeapYear。 - 返回
11 𝔽。
21.4.1.12 DateFromTime ( tv )
The abstract operation DateFromTime takes argument tv (a finite time value) and returns an
- 令 inLeapYear 为
InLeapYear (tv)。 - 令 dayWithinYear 为
DayWithinYear (tv)。 - 令 month 为
MonthFromTime (tv)。 - 如果 month 是
+0 𝔽，则返回 dayWithinYear +1 𝔽。 - 如果 month 是
1 𝔽，则返回 dayWithinYear -30 𝔽。 - 如果 month 是
2 𝔽，则返回 dayWithinYear -58 𝔽 - inLeapYear。 - 如果 month 是
3 𝔽，则返回 dayWithinYear -89 𝔽 - inLeapYear。 - 如果 month 是
4 𝔽，则返回 dayWithinYear -119 𝔽 - inLeapYear。 - 如果 month 是
5 𝔽，则返回 dayWithinYear -150 𝔽 - inLeapYear。 - 如果 month 是
6 𝔽，则返回 dayWithinYear -180 𝔽 - inLeapYear。 - 如果 month 是
7 𝔽，则返回 dayWithinYear -211 𝔽 - inLeapYear。 - 如果 month 是
8 𝔽，则返回 dayWithinYear -242 𝔽 - inLeapYear。 - 如果 month 是
9 𝔽，则返回 dayWithinYear -272 𝔽 - inLeapYear。 - 如果 month 是
10 𝔽，则返回 dayWithinYear -303 𝔽 - inLeapYear。 - 断言：month 是
11 𝔽。 - 返回 dayWithinYear -
333 𝔽 - inLeapYear。
21.4.1.13 WeekDay ( tv )
The abstract operation WeekDay takes argument tv (a finite time value) and returns an
21.4.1.14 HourFromTime ( tv )
The abstract operation HourFromTime takes argument tv (a finite time value) and returns an
21.4.1.15 MinFromTime ( tv )
The abstract operation MinFromTime takes argument tv (a finite time value) and returns an
- 返回
𝔽 (floor (ℝ (tv /msPerMinute ))modulo MinutesPerHour )。
21.4.1.16 SecFromTime ( tv )
The abstract operation SecFromTime takes argument tv (a finite time value) and returns an
- 返回
𝔽 (floor (ℝ (tv /msPerSecond ))modulo SecondsPerMinute )。
21.4.1.17 msFromTime ( tv )
The abstract operation msFromTime takes argument tv (a finite time value) and returns an
- 返回
𝔽 (ℝ (tv)modulo ℝ (msPerSecond ))。
21.4.1.18 GetUTCEpochNanoseconds ( year, month, day, hour, minute, second, millisecond, microsecond, nanosecond )
The abstract operation GetUTCEpochNanoseconds takes arguments year (an
21.4.1.19 时区标识符
ECMAScript 中的时区由时区标识符表示，它们是完全由从 0x0000 到 0x007F
主时区标识符是某个可用命名时区的首选标识符。 非主时区标识符是某个可用命名时区的标识符，且不是主时区标识符。 可用命名时区标识符要么是主时区标识符，要么是非主时区标识符。 每个可用命名时区标识符都恰好关联到一个可用命名时区。 每个可用命名时区都恰好关联到一个主时区标识符，并关联到零个或更多非主时区标识符。
ECMAScript 实现必须支持标识符为
遵循 ECMA-402 国际化 API 规范中所述时区要求的实现称为时区感知。
时区感知实现必须支持与 IANA Time Zone Database 的 Zone 和
21.4.1.20 GetNamedTimeZoneEpochNanoseconds ( timeZoneIdentifier, year, month, day, hour, minute, second, millisecond, microsecond, nanosecond )
The implementation-defined abstract operation GetNamedTimeZoneEpochNanoseconds takes arguments timeZoneIdentifier (a String), year (an
当输入表示的本地时间因负时区转换而出现多次（例如夏令时结束时，或因时区规则变更而时区偏移减少时），返回的
GetNamedTimeZoneEpochNanoseconds 的默认实现（用于不
- 断言：timeZoneIdentifier 是
"UTC" 。 - 令 epochNanoseconds 为
GetUTCEpochNanoseconds (year, month, day, hour, minute, second, millisecond, microsecond, nanosecond)。 - 返回 « epochNanoseconds »。
要求
America/New_York 中 2017 年 11 月 5 日凌晨 1:30 会重复两次，因此 GetNamedTimeZoneEpochNanoseconds(
America/New_York 中 2017 年 3 月 12 日凌晨 2:30 不存在，因此 GetNamedTimeZoneEpochNanoseconds(
21.4.1.21 GetNamedTimeZoneOffsetNanoseconds ( timeZoneIdentifier, epochNanoseconds )
The implementation-defined abstract operation GetNamedTimeZoneOffsetNanoseconds takes arguments timeZoneIdentifier (a String) and epochNanoseconds (a BigInt) and returns an
返回的整数表示由 timeZoneIdentifier 标识的命名时区，在相对于
GetNamedTimeZoneOffsetNanoseconds 的默认实现（用于不
- 断言：timeZoneIdentifier 是
"UTC" 。 - 返回 0。
时区偏移值可以为正，也可以为负。
21.4.1.22 Time Zone Identifier Record
Time Zone Identifier Record 是一种
Time Zone Identifier Record 具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Identifier]] | a String | 实现支持的 |
| [[PrimaryIdentifier]] | a String | [[Identifier]] 解析到的 |
如果 [[Identifier]] 是
21.4.1.23 AvailableNamedTimeZoneIdentifiers ( )
The implementation-defined abstract operation AvailableNamedTimeZoneIdentifiers takes no arguments and returns a
- 如果实现不
包含 任何时区的本地政治规则，则- 返回 «
Time Zone Identifier Record { [[Identifier]]:"UTC" , [[PrimaryIdentifier]]:"UTC" } »。
- 返回 «
- 令 identifiers 为唯一
可用命名时区标识符 的List ，按字典序码元顺序 排序。 - 令 result 为新的空
List 。 - 对 identifiers 的每个元素 identifier，执行：
- 令 primary 为 identifier。
- 如果 identifier 是此实现中的
非主时区标识符 ，且 identifier 不是"UTC" ，则 - 令 record 为
Time Zone Identifier Record { [[Identifier]]: identifier, [[PrimaryIdentifier]]: primary }。 - 将 record 追加到 result。
- 断言：result
包含 一个Time Zone Identifier Record record，使得 record.[[Identifier]] 是"UTC" 且 record.[[PrimaryIdentifier]] 是"UTC" 。 - 返回 result。
21.4.1.24 SystemTimeZoneIdentifier ( )
The implementation-defined abstract operation SystemTimeZoneIdentifier takes no arguments and returns a String.
它返回一个表示
为确保实现通常在 Date 对象方法中提供的功能水平，建议 SystemTimeZoneIdentifier 返回与
例如，如果
21.4.1.25 LocalTime ( tv )
The abstract operation LocalTime takes argument tv (a finite time value) and returns an
- 令 systemTimeZoneIdentifier 为
SystemTimeZoneIdentifier ()。 - 如果
IsTimeZoneOffsetString (systemTimeZoneIdentifier) 是true ，则- 令 offsetNs 为
ParseTimeZoneOffsetString (systemTimeZoneIdentifier)。
- 令 offsetNs 为
- 否则，
- 令 offsetNs 为
GetNamedTimeZoneOffsetNanoseconds (systemTimeZoneIdentifier,ℤ (ℝ (tv) × 106))。
- 令 offsetNs 为
- 令 offsetMs 为
truncate (offsetNs / 106)。 - 返回 tv +
𝔽 (offsetMs)。
如果实现内没有本地时间 tv 的政治规则，则结果为 tv，因为
要求
21.4.1.26 UTC ( t )
The abstract operation UTC takes argument t (a Number) and returns a time value.
它将 t 从本地时间转换为 UTC
- 如果 t 不是
有限 的，则返回NaN 。 - 令 systemTimeZoneIdentifier 为
SystemTimeZoneIdentifier ()。 - 如果
IsTimeZoneOffsetString (systemTimeZoneIdentifier) 是true ，则- 令 offsetNs 为
ParseTimeZoneOffsetString (systemTimeZoneIdentifier)。
- 令 offsetNs 为
- 否则，
- 令 possibleInstants 为
GetNamedTimeZoneEpochNanoseconds (systemTimeZoneIdentifier,ℝ (YearFromTime (t)),ℝ (MonthFromTime (t)) + 1,ℝ (DateFromTime (t)),ℝ (HourFromTime (t)),ℝ (MinFromTime (t)),ℝ (SecFromTime (t)),ℝ (msFromTime (t)), 0, 0)。 - 注：以下步骤确保当 t 表示在负时区转换处重复多次的本地时间（例如夏令时结束时，或因时区规则变更而时区偏移减少时）或在正时区转换处被跳过的本地时间（例如夏令时开始时，或因时区规则变更而时区偏移增加时）时，t 会使用转换之前的时区偏移来解释。
- 如果 possibleInstants 非空，则
- 令 disambiguatedInstant 为 possibleInstants[0]。
- 否则，
- 注：t 表示在正时区转换处被跳过的本地时间（例如由于夏令时开始或时区规则变更增加 UTC 偏移）。
- 令 possibleInstantsBefore 为
GetNamedTimeZoneEpochNanoseconds (systemTimeZoneIdentifier,ℝ (YearFromTime (tBefore)),ℝ (MonthFromTime (tBefore)) + 1,ℝ (DateFromTime (tBefore)),ℝ (HourFromTime (tBefore)),ℝ (MinFromTime (tBefore)),ℝ (SecFromTime (tBefore)),ℝ (msFromTime (tBefore)), 0, 0)，其中 tBefore 是小于 t 且使 possibleInstantsBefore 非空的最大整数 Number（即，tBefore 表示转换前的最后一个本地时间）。 - 令 disambiguatedInstant 为 possibleInstantsBefore 的最后一个元素。
- 令 offsetNs 为
GetNamedTimeZoneOffsetNanoseconds (systemTimeZoneIdentifier, disambiguatedInstant)。
- 令 possibleInstants 为
- 令 offsetMs 为
truncate (offsetNs / 106)。 - 返回 t -
𝔽 (offsetMs)。
输入 t 名义上是
如果实现内没有本地时间 t 的政治规则，则结果为 t，因为
要求
America/New_York 中 2017 年 11 月 5 日凌晨 1:30 会重复两次（向后回退），但它必须被解释为 UTC-04 的凌晨 1:30，而不是 UTC-05 的凌晨 1:30。
在 UTC(
America/New_York 中 2017 年 3 月 12 日凌晨 2:30 不存在，但它必须被解释为 UTC-05 的凌晨 2:30（等价于 UTC-04 的凌晨 3:30）。
在 UTC(
21.4.1.27 MakeTime ( hour, min, sec, ms )
The abstract operation MakeTime takes arguments hour (a Number), min (a Number), sec (a Number), and ms (a Number) and returns a Number. 它计算毫秒数。 It performs the following steps when called:
- 如果 hour 不是
有限 的、min 不是有限 的、sec 不是有限 的，或 ms 不是有限 的，则返回NaN 。 - 令 h 为
𝔽 (!ToIntegerOrInfinity (hour))。 - 令 m 为
𝔽 (!ToIntegerOrInfinity (min))。 - 令 s 为
𝔽 (!ToIntegerOrInfinity (sec))。 - 令 milli 为
𝔽 (!ToIntegerOrInfinity (ms))。 - 返回 ((h ×
msPerHour + m ×msPerMinute ) + s ×msPerSecond ) + milli。
MakeTime 中的算术是浮点算术，不满足结合律，因此操作必须按正确顺序执行。
21.4.1.28 MakeDay ( year, month, date )
The abstract operation MakeDay takes arguments year (a Number), month (a Number), and date (a Number) and returns a finite Number or
- 如果 year 不是
有限 的、month 不是有限 的，或 date 不是有限 的，则返回NaN 。 - 令 y 为
𝔽 (!ToIntegerOrInfinity (year))。 - 令 m 为
𝔽 (!ToIntegerOrInfinity (month))。 - 令 dt 为
𝔽 (!ToIntegerOrInfinity (date))。 - 令 ym 为 y +
𝔽 (floor (ℝ (m) / 12))。 - 如果 ym 不是
有限 的，则返回NaN 。 - 令 mn 为
𝔽 (ℝ (m)modulo 12)。 - 找到一个
有限 时间值 tv，使得YearFromTime (tv) 是 ym，MonthFromTime (tv) 是 mn，并且DateFromTime (tv) 是1 𝔽；但如果这不可能（因为某个实参超出范围），则返回NaN 。 - 返回
Day (tv) + dt -1 𝔽。
21.4.1.29 MakeDate ( day, time )
The abstract operation MakeDate takes arguments day (a Number) and time (a Number) and returns a finite Number or
21.4.1.30 MakeFullYear ( year )
The abstract operation MakeFullYear takes argument year (a Number) and returns an
- 如果 year 是
NaN 、+∞ 𝔽 或-∞ 𝔽 之一，则返回NaN 。 - 令 truncated 为 !
ToIntegerOrInfinity (year)。 - 如果 truncated 在从 0 到 99 的
闭区间 内，则返回1900 𝔽 +𝔽 (truncated)。 - 返回
𝔽 (truncated)。
21.4.1.31 TimeClip ( time )
The abstract operation TimeClip takes argument time (a Number) and returns a time value. 它计算毫秒数。 It performs the following steps when called:
- 如果 time 不是
有限 的，则返回NaN 。 - 如果
abs (ℝ (time)) > 8.64 × 1015，则返回NaN 。 - 返回
𝔽 (!ToIntegerOrInfinity (time))。
21.4.1.32 日期时间字符串格式
ECMAScript 定义了一种基于 ISO 8601 日历日期扩展格式的简化形式的日期时间字符串交换格式。格式如下：YYYY-MM-DDTHH:mm:ss.sssZ
其中各元素如下：
YYYY
|
是预推格里高利历中的年份，表示为从 0000 到 9999 的四位十进制数字，或表示为一个 |
-
|
|
MM
|
是一年中的月份，表示为从 01（一月）到 12（十二月）的两位十进制数字。 |
DD
|
是月份中的日期，表示为从 01 到 31 的两位十进制数字。 |
T
|
|
HH
|
是自午夜以来已经过去的完整小时数，表示为从 00 到 24 的两位十进制数字。 |
:
|
|
mm
|
是自小时开始以来的完整分钟数，表示为从 00 到 59 的两位十进制数字。 |
ss
|
是自分钟开始以来的完整秒数，表示为从 00 到 59 的两位十进制数字。 |
.
|
|
sss
|
是自秒开始以来的完整毫秒数，表示为三位十进制数字。 |
Z
|
是 UTC 偏移表示，指定为 HH:mm（ |
此格式包括仅日期形式：
YYYY
YYYY-MM
YYYY-MM-DD
它还包括“日期时间”形式，该形式由上述某个仅日期形式立即后跟以下某个时间形式组成，并可选择附加 UTC 偏移表示：
THH:mm
THH:mm:ss
THH:mm:ss.sss
由于每天都以午夜开始并以午夜结束，记法 00:00 和 24:00 可用于区分可与一个日期关联的两个午夜。这意味着以下两个记法指代完全相同的时间点：1995-02-04T24:00 和 1995-02-05T00:00。后一种形式作为“日历日结束”的这种解释与 ISO 8601 一致，尽管该规范将其保留用于描述时间
不存在指定 CET、EST 等民用时区缩写的国际标准，并且有时同一个缩写甚至会用于两个非常不同的时区。因此，ISO 8601 和此格式都指定时区偏移的数字表示。
21.4.1.32.1 扩展年份
覆盖相对于 1970 年 1 月 1 日向前或向后约 273,790 年的完整Date.parse
带扩展年份的 date-
| -271821-04-20T00:00:00Z | 公元前 271822 年 |
| -000001-01-01T00:00:00Z | 公元前 2 年 |
| +000000-01-01T00:00:00Z | 公元前 1 年 |
| +000001-01-01T00:00:00Z | 公元 1 年 |
| +001970-01-01T00:00:00Z | 公元 1970 年 |
| +002009-12-15T00:00:00Z | 公元 2009 年 |
| +275760-09-13T00:00:00Z | 公元 275760 年 |
21.4.1.33 时区偏移字符串格式
ECMAScript 定义了一种派生自 ISO 8601 的 UTC 偏移字符串交换格式。 该格式由以下文法描述。
语法
21.4.1.33.1 IsTimeZoneOffsetString ( offsetString )
The abstract operation IsTimeZoneOffsetString takes argument offsetString (a String) and returns a Boolean. 返回值指示 offsetString 是否符合
21.4.1.33.2 ParseTimeZoneOffsetString ( offsetString )
The abstract operation ParseTimeZoneOffsetString takes argument offsetString (a String) and returns an
- 令 parseResult 为
ParseText (offsetString,UTCOffset )。 - 断言：parseResult 不是错误列表。
- 断言：parseResult
包含 一个ASCIISign Parse Node 。 - 令 parsedSign 为 parseResult 中
包含 的ASCIISign Parse Node 所匹配的源文本 。 - 如果 parsedSign 是单个码点 U+002D（HYPHEN-MINUS），则
- 令 sign 为 -1。
- 否则，
- 令 sign 为 1。
- 注：下面
StringToNumber 的应用不会损失精度，因为每个被解析的值都保证是足够短的十进制数字字符串。 - 断言：parseResult
包含 一个Hour Parse Node 。 - 令 parsedHours 为 parseResult 中
包含 的Hour Parse Node 所匹配的源文本 。 - 令 hours 为
ℝ (StringToNumber (CodePointsToString (parsedHours)))。 - 如果 parseResult 不
包含 MinuteSecond Parse Node ，则- 令 minutes 为 0。
- 否则，
- 令 parsedMinutes 为 parseResult 中
包含 的第一个MinuteSecond Parse Node 所匹配的源文本 。 - 令 minutes 为
ℝ (StringToNumber (CodePointsToString (parsedMinutes)))。
- 令 parsedMinutes 为 parseResult 中
- 如果 parseResult 不
包含 两个MinuteSecond Parse Node ，则- 令 seconds 为 0。
- 否则，
- 令 parsedSeconds 为 parseResult 中
包含 的第二个MinuteSecond Parse Node 所匹配的源文本 。 - 令 seconds 为
ℝ (StringToNumber (CodePointsToString (parsedSeconds)))。
- 令 parsedSeconds 为 parseResult 中
- 如果 parseResult 不
包含 TemporalDecimalFraction Parse Node ，则- 令 nanoseconds 为 0。
- 否则，
- 令 parsedFraction 为 parseResult 中
包含 的TemporalDecimalFraction Parse Node 所匹配的源文本 。 - 令 fraction 为
CodePointsToString (parsedFraction) 和"000000000" 的字符串连接 。 - 令 nanosecondsString 为 fraction 从 1 到 10 的
子字符串 。 - 令 nanoseconds 为
ℝ (StringToNumber (nanosecondsString))。
- 令 parsedFraction 为 parseResult 中
- 返回 sign × (((hours × 60 + minutes) × 60 + seconds) × 109 + nanoseconds)。
21.4.2 Date 构造器
Date 构造器：
- 是 %Date%。
- 是
全局对象 的"Date" 属性的初始值。 - 在作为构造器调用时创建并初始化一个新的 Date。
- 在作为函数而非构造器调用时返回表示当前时间（UTC）的 String。
- 是一个其行为取决于其实参数量和类型的函数。
- 可以用作类定义的
extends子句的值。意图继承指定 Date 行为的子类构造器必须包含 对 Date 构造器的super调用，以创建并初始化具有 [[DateValue]] 内部槽的子类实例。
21.4.2.1 Date ( ...values )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 是
undefined ，则- 令 now 为标识当前时间的
时间值 （UTC）。 - 返回
ToDateString (now)。
- 令 now 为标识当前时间的
- 令 numberOfArgs 为 values 中元素的数量。
- 如果 numberOfArgs = 0，则
- 令 dv 为标识当前时间的
时间值 （UTC）。
- 令 dv 为标识当前时间的
- 否则，如果 numberOfArgs = 1，则
- 令 value 为 values[0]。
- 如果 value 是 Object 且 value 具有 [[DateValue]] 内部槽，则
- 令 tv 为 value.[[DateValue]]。
- 否则，
- 令 v 为 ?
ToPrimitive (value)。 - 如果 v 是 String，则
- 断言：下一步永远不会返回 abrupt completion，因为 v 是 String。
- 令 tv 为把 v 解析为日期的结果，其方式与
parse方法（21.4.3.2 ）完全相同。
- 否则，
- 令 tv 为 ?
ToNumber (v)。
- 令 tv 为 ?
- 令 v 为 ?
- 令 dv 为
TimeClip (tv)。
- 否则，
- 断言：numberOfArgs ≥ 2。
- 令 y 为 ?
ToNumber (values[0])。 - 令 m 为 ?
ToNumber (values[1])。 - 如果 numberOfArgs > 2，则令 dt 为 ?
ToNumber (values[2])；否则令 dt 为1 𝔽。 - 如果 numberOfArgs > 3，则令 h 为 ?
ToNumber (values[3])；否则令 h 为+0 𝔽。 - 如果 numberOfArgs > 4，则令 min 为 ?
ToNumber (values[4])；否则令 min 为+0 𝔽。 - 如果 numberOfArgs > 5，则令 s 为 ?
ToNumber (values[5])；否则令 s 为+0 𝔽。 - 如果 numberOfArgs > 6，则令 milli 为 ?
ToNumber (values[6])；否则令 milli 为+0 𝔽。 - 令 yr 为
MakeFullYear (y)。 - 令 finalDate 为
MakeDate (MakeDay (yr, m, dt),MakeTime (h, min, s, milli))。 - 令 dv 为
TimeClip (UTC (finalDate))。
- 令 obj 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%Date.prototype%" , « [[DateValue]] »)。 - 将 obj.[[DateValue]] 设置为 dv。
- 返回 obj。
21.4.3 Date 构造器的属性
Date 构造器：
- 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有一个
"length" 属性，其值为7 𝔽。 - 具有以下属性：
21.4.3.1 Date.now ( )
此函数返回表示调用发生时 UTC 日期和时间的
21.4.3.2 Date.parse ( string )
此函数对其实参应用
如果该 String 符合MM 或 DD 元素缺失时，使用 HH、mm 或 ss 元素缺失时，使用 sss 元素缺失时，使用
如果 x 是在 ECMAScript 某个特定实现中其毫秒数量为零的任何 Date，则在所有被引用属性都具有其初始值时，以下所有表达式都应在该实现中产生相同的数值：
x.valueOf()
Date.parse(x.toString())
Date.parse(x.toUTCString())
Date.parse(x.toISOString())然而，表达式
Date.parse(x.toLocaleString())不要求产生与前三个表达式相同的 toString 或 toUTCString 方法产生的 String 值时，此函数产生的值是由
21.4.3.3 Date.prototype
Date.prototype 的初始值是
此属性具有特性 { [[Writable]]:
21.4.3.4 Date.UTC ( year [ , month [ , date [ , hours [ , minutes [ , seconds [ , ms ] ] ] ] ] ] )
此函数在被调用时执行以下步骤：
- 令 y 为 ?
ToNumber (year)。 - 如果 month 存在，则令 m 为 ?
ToNumber (month)；否则令 m 为+0 𝔽。 - 如果 date 存在，则令 dt 为 ?
ToNumber (date)；否则令 dt 为1 𝔽。 - 如果 hours 存在，则令 h 为 ?
ToNumber (hours)；否则令 h 为+0 𝔽。 - 如果 minutes 存在，则令 min 为 ?
ToNumber (minutes)；否则令 min 为+0 𝔽。 - 如果 seconds 存在，则令 s 为 ?
ToNumber (seconds)；否则令 s 为+0 𝔽。 - 如果 ms 存在，则令 milli 为 ?
ToNumber (ms)；否则令 milli 为+0 𝔽。 - 令 yr 为
MakeFullYear (y)。 - 返回
TimeClip (MakeDate (MakeDay (yr, m, dt),MakeTime (h, min, s, milli)))。
此函数的
此函数与 Date 构造器有两点不同：它返回一个作为 Number 的
21.4.4 Date 原型对象的属性
Date 原型对象：
- 是 %Date.prototype%。
- 自身是
普通对象 。 - 不是 Date 实例，并且没有 [[DateValue]] 内部槽。
- 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。
除非另有明确定义，下文定义的 Date 原型对象方法不是泛型的，并且传给它们的
21.4.4.1 Date.prototype.constructor
Date.prototype.constructor 的初始值是
21.4.4.2 Date.prototype.getDate ( )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 如果 tv 是
NaN ，则返回NaN 。 - 返回
DateFromTime (LocalTime (tv))。
21.4.4.3 Date.prototype.getDay ( )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 如果 tv 是
NaN ，则返回NaN 。 - 返回
WeekDay (LocalTime (tv))。
21.4.4.4 Date.prototype.getFullYear ( )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 如果 tv 是
NaN ，则返回NaN 。 - 返回
YearFromTime (LocalTime (tv))。
21.4.4.5 Date.prototype.getHours ( )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 如果 tv 是
NaN ，则返回NaN 。 - 返回
HourFromTime (LocalTime (tv))。
21.4.4.6 Date.prototype.getMilliseconds ( )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 如果 tv 是
NaN ，则返回NaN 。 - 返回
msFromTime (LocalTime (tv))。
21.4.4.7 Date.prototype.getMinutes ( )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 如果 tv 是
NaN ，则返回NaN 。 - 返回
MinFromTime (LocalTime (tv))。
21.4.4.8 Date.prototype.getMonth ( )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 如果 tv 是
NaN ，则返回NaN 。 - 返回
MonthFromTime (LocalTime (tv))。
21.4.4.9 Date.prototype.getSeconds ( )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 如果 tv 是
NaN ，则返回NaN 。 - 返回
SecFromTime (LocalTime (tv))。
21.4.4.10 Date.prototype.getTime ( )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 返回 dateObj.[[DateValue]]。
21.4.4.11 Date.prototype.getTimezoneOffset ( )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 如果 tv 是
NaN ，则返回NaN 。 - 返回 (tv -
LocalTime (tv)) /msPerMinute 。
21.4.4.12 Date.prototype.getUTCDate ( )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 如果 tv 是
NaN ，则返回NaN 。 - 返回
DateFromTime (tv)。
21.4.4.13 Date.prototype.getUTCDay ( )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 如果 tv 是
NaN ，则返回NaN 。 - 返回
WeekDay (tv)。
21.4.4.14 Date.prototype.getUTCFullYear ( )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 如果 tv 是
NaN ，则返回NaN 。 - 返回
YearFromTime (tv)。
21.4.4.15 Date.prototype.getUTCHours ( )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 如果 tv 是
NaN ，则返回NaN 。 - 返回
HourFromTime (tv)。
21.4.4.16 Date.prototype.getUTCMilliseconds ( )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 如果 tv 是
NaN ，则返回NaN 。 - 返回
msFromTime (tv)。
21.4.4.17 Date.prototype.getUTCMinutes ( )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 如果 tv 是
NaN ，则返回NaN 。 - 返回
MinFromTime (tv)。
21.4.4.18 Date.prototype.getUTCMonth ( )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 如果 tv 是
NaN ，则返回NaN 。 - 返回
MonthFromTime (tv)。
21.4.4.19 Date.prototype.getUTCSeconds ( )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 如果 tv 是
NaN ，则返回NaN 。 - 返回
SecFromTime (tv)。
21.4.4.20 Date.prototype.setDate ( date )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 令 dt 为 ?
ToNumber (date)。 - 如果 tv 是
NaN ，则返回NaN 。 - 将 tv 设置为
LocalTime (tv)。 - 令 newDate 为
MakeDate (MakeDay (YearFromTime (tv),MonthFromTime (tv), dt),TimeWithinDay (tv))。 - 令 u 为
TimeClip (UTC (newDate))。 - 将 dateObj.[[DateValue]] 设置为 u。
- 返回 u。
21.4.4.21 Date.prototype.setFullYear ( year [ , month [ , date ] ] )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 令 y 为 ?
ToNumber (year)。 - 如果 tv 是
NaN ，则将 tv 设置为+0 𝔽；否则将 tv 设置为LocalTime (tv)。 - 如果 month 存在，则令 m 为 ?
ToNumber (month)；否则令 m 为MonthFromTime (tv)。 - 如果 date 存在，则令 dt 为 ?
ToNumber (date)；否则令 dt 为DateFromTime (tv)。 - 令 newDate 为
MakeDate (MakeDay (y, m, dt),TimeWithinDay (tv))。 - 令 u 为
TimeClip (UTC (newDate))。 - 将 dateObj.[[DateValue]] 设置为 u。
- 返回 u。
此方法的
如果 month 不存在，此方法表现得仿佛 month 存在且其值为 getMonth()。如果 date 不存在，它表现得仿佛 date 存在且其值为 getDate()。
21.4.4.22 Date.prototype.setHours ( hour [ , min [ , sec [ , ms ] ] ] )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 令 h 为 ?
ToNumber (hour)。 - 如果 min 存在，则令 m 为 ?
ToNumber (min)。 - 如果 sec 存在，则令 s 为 ?
ToNumber (sec)。 - 如果 ms 存在，则令 milli 为 ?
ToNumber (ms)。 - 如果 tv 是
NaN ，则返回NaN 。 - 将 tv 设置为
LocalTime (tv)。 - 如果 min 不存在，则令 m 为
MinFromTime (tv)。 - 如果 sec 不存在，则令 s 为
SecFromTime (tv)。 - 如果 ms 不存在，则令 milli 为
msFromTime (tv)。 - 令 date 为
MakeDate (Day (tv),MakeTime (h, m, s, milli))。 - 令 u 为
TimeClip (UTC (date))。 - 将 dateObj.[[DateValue]] 设置为 u。
- 返回 u。
此方法的
如果 min 不存在，此方法表现得仿佛 min 存在且其值为 getMinutes()。如果 sec 不存在，它表现得仿佛 sec 存在且其值为 getSeconds()。如果 ms 不存在，它表现得仿佛 ms 存在且其值为 getMilliseconds()。
21.4.4.23 Date.prototype.setMilliseconds ( ms )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 将 ms 设置为 ?
ToNumber (ms)。 - 如果 tv 是
NaN ，则返回NaN 。 - 将 tv 设置为
LocalTime (tv)。 - 令 time 为
MakeTime (HourFromTime (tv),MinFromTime (tv),SecFromTime (tv), ms)。 - 令 u 为
TimeClip (UTC (MakeDate (Day (tv), time)))。 - 将 dateObj.[[DateValue]] 设置为 u。
- 返回 u。
21.4.4.24 Date.prototype.setMinutes ( min [ , sec [ , ms ] ] )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 令 m 为 ?
ToNumber (min)。 - 如果 sec 存在，则令 s 为 ?
ToNumber (sec)。 - 如果 ms 存在，则令 milli 为 ?
ToNumber (ms)。 - 如果 tv 是
NaN ，则返回NaN 。 - 将 tv 设置为
LocalTime (tv)。 - 如果 sec 不存在，则令 s 为
SecFromTime (tv)。 - 如果 ms 不存在，则令 milli 为
msFromTime (tv)。 - 令 date 为
MakeDate (Day (tv),MakeTime (HourFromTime (tv), m, s, milli))。 - 令 u 为
TimeClip (UTC (date))。 - 将 dateObj.[[DateValue]] 设置为 u。
- 返回 u。
此方法的
如果 sec 不存在，此方法表现得仿佛 sec 存在且其值为 getSeconds()。如果 ms 不存在，它表现得仿佛 ms 存在且其值为 getMilliseconds()。
21.4.4.25 Date.prototype.setMonth ( month [ , date ] )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 令 m 为 ?
ToNumber (month)。 - 如果 date 存在，则令 dt 为 ?
ToNumber (date)。 - 如果 tv 是
NaN ，则返回NaN 。 - 将 tv 设置为
LocalTime (tv)。 - 如果 date 不存在，则令 dt 为
DateFromTime (tv)。 - 令 newDate 为
MakeDate (MakeDay (YearFromTime (tv), m, dt),TimeWithinDay (tv))。 - 令 u 为
TimeClip (UTC (newDate))。 - 将 dateObj.[[DateValue]] 设置为 u。
- 返回 u。
此方法的
如果 date 不存在，此方法表现得仿佛 date 存在且其值为 getDate()。
21.4.4.26 Date.prototype.setSeconds ( sec [ , ms ] )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 令 s 为 ?
ToNumber (sec)。 - 如果 ms 存在，则令 milli 为 ?
ToNumber (ms)。 - 如果 tv 是
NaN ，则返回NaN 。 - 将 tv 设置为
LocalTime (tv)。 - 如果 ms 不存在，则令 milli 为
msFromTime (tv)。 - 令 date 为
MakeDate (Day (tv),MakeTime (HourFromTime (tv),MinFromTime (tv), s, milli))。 - 令 u 为
TimeClip (UTC (date))。 - 将 dateObj.[[DateValue]] 设置为 u。
- 返回 u。
此方法的
如果 ms 不存在，此方法表现得仿佛 ms 存在且其值为 getMilliseconds()。
21.4.4.27 Date.prototype.setTime ( time )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 t 为 ?
ToNumber (time)。 - 令 v 为
TimeClip (t)。 - 将 dateObj.[[DateValue]] 设置为 v。
- 返回 v。
21.4.4.28 Date.prototype.setUTCDate ( date )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 令 dt 为 ?
ToNumber (date)。 - 如果 tv 是
NaN ，则返回NaN 。 - 令 newDate 为
MakeDate (MakeDay (YearFromTime (tv),MonthFromTime (tv), dt),TimeWithinDay (tv))。 - 令 v 为
TimeClip (newDate)。 - 将 dateObj.[[DateValue]] 设置为 v。
- 返回 v。
21.4.4.29 Date.prototype.setUTCFullYear ( year [ , month [ , date ] ] )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 如果 tv 是
NaN ，则将 tv 设置为+0 𝔽。 - 令 y 为 ?
ToNumber (year)。 - 如果 month 存在，则令 m 为 ?
ToNumber (month)；否则令 m 为MonthFromTime (tv)。 - 如果 date 存在，则令 dt 为 ?
ToNumber (date)；否则令 dt 为DateFromTime (tv)。 - 令 newDate 为
MakeDate (MakeDay (y, m, dt),TimeWithinDay (tv))。 - 令 v 为
TimeClip (newDate)。 - 将 dateObj.[[DateValue]] 设置为 v。
- 返回 v。
此方法的
如果 month 不存在，此方法表现得仿佛 month 存在且其值为 getUTCMonth()。如果 date 不存在，它表现得仿佛 date 存在且其值为 getUTCDate()。
21.4.4.30 Date.prototype.setUTCHours ( hour [ , min [ , sec [ , ms ] ] ] )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 令 h 为 ?
ToNumber (hour)。 - 如果 min 存在，则令 m 为 ?
ToNumber (min)。 - 如果 sec 存在，则令 s 为 ?
ToNumber (sec)。 - 如果 ms 存在，则令 milli 为 ?
ToNumber (ms)。 - 如果 tv 是
NaN ，则返回NaN 。 - 如果 min 不存在，则令 m 为
MinFromTime (tv)。 - 如果 sec 不存在，则令 s 为
SecFromTime (tv)。 - 如果 ms 不存在，则令 milli 为
msFromTime (tv)。 - 令 date 为
MakeDate (Day (tv),MakeTime (h, m, s, milli))。 - 令 v 为
TimeClip (date)。 - 将 dateObj.[[DateValue]] 设置为 v。
- 返回 v。
此方法的
如果 min 不存在，此方法表现得仿佛 min 存在且其值为 getUTCMinutes()。如果 sec 不存在，它表现得仿佛 sec 存在且其值为 getUTCSeconds()。如果 ms 不存在，它表现得仿佛 ms 存在且其值为 getUTCMilliseconds()。
21.4.4.31 Date.prototype.setUTCMilliseconds ( ms )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 将 ms 设置为 ?
ToNumber (ms)。 - 如果 tv 是
NaN ，则返回NaN 。 - 令 time 为
MakeTime (HourFromTime (tv),MinFromTime (tv),SecFromTime (tv), ms)。 - 令 v 为
TimeClip (MakeDate (Day (tv), time))。 - 将 dateObj.[[DateValue]] 设置为 v。
- 返回 v。
21.4.4.32 Date.prototype.setUTCMinutes ( min [ , sec [ , ms ] ] )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 令 m 为 ?
ToNumber (min)。 - 如果 sec 存在，则令 s 为 ?
ToNumber (sec)。 - 如果 ms 存在，则令 milli 为 ?
ToNumber (ms)。 - 如果 tv 是
NaN ，则返回NaN 。 - 如果 sec 不存在，则令 s 为
SecFromTime (tv)。 - 如果 ms 不存在，则令 milli 为
msFromTime (tv)。 - 令 date 为
MakeDate (Day (tv),MakeTime (HourFromTime (tv), m, s, milli))。 - 令 v 为
TimeClip (date)。 - 将 dateObj.[[DateValue]] 设置为 v。
- 返回 v。
此方法的
如果 sec 不存在，此方法表现得仿佛 sec 存在且其值为 getUTCSeconds()。如果 ms 不存在，它表现得仿佛 ms 存在且其值为 getUTCMilliseconds() 返回的值。
21.4.4.33 Date.prototype.setUTCMonth ( month [ , date ] )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 令 m 为 ?
ToNumber (month)。 - 如果 date 存在，则令 dt 为 ?
ToNumber (date)。 - 如果 tv 是
NaN ，则返回NaN 。 - 如果 date 不存在，则令 dt 为
DateFromTime (tv)。 - 令 newDate 为
MakeDate (MakeDay (YearFromTime (tv), m, dt),TimeWithinDay (tv))。 - 令 v 为
TimeClip (newDate)。 - 将 dateObj.[[DateValue]] 设置为 v。
- 返回 v。
此方法的
如果 date 不存在，此方法表现得仿佛 date 存在且其值为 getUTCDate()。
21.4.4.34 Date.prototype.setUTCSeconds ( sec [ , ms ] )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 令 s 为 ?
ToNumber (sec)。 - 如果 ms 存在，则令 milli 为 ?
ToNumber (ms)。 - 如果 tv 是
NaN ，则返回NaN 。 - 如果 ms 不存在，则令 milli 为
msFromTime (tv)。 - 令 date 为
MakeDate (Day (tv),MakeTime (HourFromTime (tv),MinFromTime (tv), s, milli))。 - 令 v 为
TimeClip (date)。 - 将 dateObj.[[DateValue]] 设置为 v。
- 返回 v。
此方法的
如果 ms 不存在，此方法表现得仿佛 ms 存在且其值为 getUTCMilliseconds()。
21.4.4.35 Date.prototype.toDateString ( )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 如果 tv 是
NaN ，则返回"Invalid Date" 。 - 令 t 为
LocalTime (tv)。 - 返回
DateString (t)。
21.4.4.36 Date.prototype.toISOString ( )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 如果 tv 是
NaN ，则抛出RangeError 异常。 - 断言：tv 是整数 Number。
- 如果 tv 对应于不能在
日期时间字符串格式 中表示的年份，则抛出RangeError 异常。 - 返回 tv 在 UTC 时间尺度上的
日期时间字符串格式 中的 String 表示，包括所有格式元素和 UTC 偏移表示"Z" 。
21.4.4.37 Date.prototype.toJSON ( key )
此方法提供 Date 的 String 表示，以供 JSON.stringify（
它在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 tv 为 ?
ToPrimitive (obj,number )。 - 如果 tv 是 Number 且 tv 不是
有限 的，则返回null 。 - 返回 ?
Invoke (obj,"toISOString" )。
该实参会被忽略。
此方法有意设计为泛型的；它不要求其 toISOString 方法。
21.4.4.38 Date.prototype.toLocaleDateString ( [ reserved1 [ , reserved2 ] ] )
此方法返回一个 String 值。该 String 的内容由实现定义，但旨在以方便且人类可读的形式表示当前时区中 Date 的“日期”部分，并对应于
此方法可选参数的含义在 ECMA-402 规范中定义；不
21.4.4.39 Date.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
此方法返回一个 String 值。该 String 的内容由实现定义，但旨在以方便且人类可读的形式表示当前时区中的 Date，并对应于
此方法可选参数的含义在 ECMA-402 规范中定义；不
21.4.4.40 Date.prototype.toLocaleTimeString ( [ reserved1 [ , reserved2 ] ] )
此方法返回一个 String 值。该 String 的内容由实现定义，但旨在以方便且人类可读的形式表示当前时区中 Date 的“时间”部分，并对应于
此方法可选参数的含义在 ECMA-402 规范中定义；不
21.4.4.41 Date.prototype.toString ( )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 返回
ToDateString (tv)。
对于任何 Date d，如果 d.[[DateValue]] 可被 1000 整除，则 Date.parse(d.toString()) 的结果 = d.valueOf()。见
此方法不是泛型的；如果其
21.4.4.41.1 TimeString ( tv )
The abstract operation TimeString takes argument tv (a Number, but not
- 令 hour 为
ToZeroPaddedDecimalString (ℝ (HourFromTime (tv)), 2)。 - 令 minute 为
ToZeroPaddedDecimalString (ℝ (MinFromTime (tv)), 2)。 - 令 second 为
ToZeroPaddedDecimalString (ℝ (SecFromTime (tv)), 2)。 - 返回 hour、
":" 、minute、":" 、second、码元 0x0020（SPACE）和"GMT" 的字符串连接 。
21.4.4.41.2 DateString ( tv )
The abstract operation DateString takes argument tv (a Number, but not
- 令 weekday 为
Table 61 中 Number 为WeekDay (tv) 的条目的 Name。 - 令 month 为
Table 62 中 Number 为MonthFromTime (tv) 的条目的 Name。 - 令 day 为
ToZeroPaddedDecimalString (ℝ (DateFromTime (tv)), 2)。 - 令 yv 为
YearFromTime (tv)。 - 如果 yv 是
+0 𝔽 或 yv >+0 𝔽，则令 yearSign 为空 String；否则令 yearSign 为"-" 。 - 令 paddedYear 为
ToZeroPaddedDecimalString (abs (ℝ (yv)), 4)。 - 返回 weekday、码元 0x0020（SPACE）、month、码元 0x0020（SPACE）、day、码元 0x0020（SPACE）、yearSign 和 paddedYear 的
字符串连接 。
| Number | Name |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Number | Name |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
21.4.4.41.3 TimeZoneString ( tv )
The abstract operation TimeZoneString takes argument tv (an
- 令 systemTimeZoneIdentifier 为
SystemTimeZoneIdentifier ()。 - 如果
IsTimeZoneOffsetString (systemTimeZoneIdentifier) 是true ，则- 令 offsetNs 为
ParseTimeZoneOffsetString (systemTimeZoneIdentifier)。
- 令 offsetNs 为
- 否则，
- 令 offsetNs 为
GetNamedTimeZoneOffsetNanoseconds (systemTimeZoneIdentifier,ℤ (ℝ (tv) × 106))。
- 令 offsetNs 为
- 令 offset 为
𝔽 (truncate (offsetNs / 106))。 - 如果 offset 是
+0 𝔽 或 offset >+0 𝔽，则- 令 offsetSign 为
"+" 。 - 令 absOffset 为 offset。
- 令 offsetSign 为
- 否则，
- 令 offsetSign 为
"-" 。 - 令 absOffset 为 -offset。
- 令 offsetSign 为
- 令 offsetMin 为
ToZeroPaddedDecimalString (ℝ (MinFromTime (absOffset)), 2)。 - 令 offsetHour 为
ToZeroPaddedDecimalString (ℝ (HourFromTime (absOffset)), 2)。 - 令 tzName 为一个由
实现定义的 字符串，它要么是空 String，要么是码元 0x0020（SPACE）、码元 0x0028（LEFT PARENTHESIS）、一个由实现定义的 时区名称和码元 0x0029（RIGHT PARENTHESIS）的字符串连接 。 - 返回 offsetSign、offsetHour、offsetMin 和 tzName 的
字符串连接 。
21.4.4.41.4 ToDateString ( tv )
The abstract operation ToDateString takes argument tv (an
- 如果 tv 是
NaN ，则返回"Invalid Date" 。 - 令 localTime 为
LocalTime (tv)。 - 返回
DateString (localTime)、码元 0x0020（SPACE）、TimeString (localTime) 和TimeZoneString (tv) 的字符串连接 。
21.4.4.42 Date.prototype.toTimeString ( )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 如果 tv 是
NaN ，则返回"Invalid Date" 。 - 令 localTime 为
LocalTime (tv)。 - 返回
TimeString (localTime) 和TimeZoneString (tv) 的字符串连接 。
21.4.4.43 Date.prototype.toUTCString ( )
此方法返回一个 String 值，表示与 HTTP-date，并泛化为支持 ECMAScript Date 所支持的完整时间范围。
它在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 如果 tv 是
NaN ，则返回"Invalid Date" 。 - 令 weekday 为
Table 61 中 Number 为WeekDay (tv) 的条目的 Name。 - 令 month 为
Table 62 中 Number 为MonthFromTime (tv) 的条目的 Name。 - 令 day 为
ToZeroPaddedDecimalString (ℝ (DateFromTime (tv)), 2)。 - 令 yv 为
YearFromTime (tv)。 - 如果 yv 是
+0 𝔽 或 yv >+0 𝔽，则令 yearSign 为空 String；否则令 yearSign 为"-" 。 - 令 paddedYear 为
ToZeroPaddedDecimalString (abs (ℝ (yv)), 4)。 - 返回 weekday、
"," 、码元 0x0020（SPACE）、day、码元 0x0020（SPACE）、month、码元 0x0020（SPACE）、yearSign、paddedYear、码元 0x0020（SPACE）和TimeString (tv) 的字符串连接 。
21.4.4.44 Date.prototype.valueOf ( )
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this value。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 返回 dateObj.[[DateValue]]。
21.4.4.45 Date.prototype [ %Symbol.toPrimitive% ] ( hint )
此方法由 ECMAScript 语言运算符调用，用于将 Date 转换为原始值。hint 的允许值是
它在被调用时执行以下步骤：
- 令 obj 为
this value。 - 如果 obj 不是 Object，则抛出
TypeError 异常。 - 如果 hint 是
"string" 或"default" ，则- 令 tryFirst 为
string 。
- 令 tryFirst 为
- 否则，如果 hint 是
"number" ，则- 令 tryFirst 为
number 。
- 令 tryFirst 为
- 否则，
- 抛出
TypeError 异常。
- 抛出
- 返回 ?
OrdinaryToPrimitive (obj, tryFirst)。
此属性具有特性 { [[Writable]]:
此方法的
21.4.5 Date 实例的属性
Date 实例是继承自
22 文本处理
22.1 String 对象
22.1.1 String 构造器
String 构造器：
- 是 %String%。
- 是
全局对象 的"String" 属性的初始值。 - 在作为构造器调用时创建并初始化一个新的 String 对象。
- 在作为函数而非构造器调用时执行类型转换。
- 可以用作类定义的
extends子句的值。意图继承指定 String 行为的子类构造器必须包含 对 String 构造器的super调用，以创建并初始化具有 [[StringData]] 内部槽的子类实例。
22.1.1.1 String ( value )
此函数在被调用时执行以下步骤：
- 如果 value 不存在，则
- 令 string 为空 String。
- 否则，
- 如果 NewTarget 是
undefined 且 value 是 Symbol，则返回SymbolDescriptiveString (value)。 - 令 string 为 ?
ToString (value)。
- 如果 NewTarget 是
- 如果 NewTarget 是
undefined ，则返回 string。 - 返回
StringCreate (string, ?GetPrototypeFromConstructor (NewTarget,"%String.prototype%" ))。
22.1.2 String 构造器的属性
String 构造器：
- 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
22.1.2.1 String.fromCharCode ( ...codeUnits )
此函数可以用任意数量的实参调用，这些实参构成 rest 参数 codeUnits。
它在被调用时执行以下步骤：
此函数的
22.1.2.2 String.fromCodePoint ( ...codePoints )
此函数可以用任意数量的实参调用，这些实参构成 rest 参数 codePoints。
它在被调用时执行以下步骤：
此函数的
22.1.2.3 String.prototype
String.prototype 的初始值是
此属性具有特性 { [[Writable]]:
22.1.2.4 String.raw ( template, ...substitutions )
此函数可以用可变数量的实参调用。第一个实参是 template，其余实参构成
它在被调用时执行以下步骤：
- 令 substitutionCount 为 substitutions 中元素的数量。
- 令 cooked 为 ?
ToObject (template)。 - 令 literals 为 ?
ToObject (?Get (cooked,"raw" ))。 - 令 literalCount 为 ?
LengthOfArrayLike (literals)。 - 如果 literalCount ≤ 0，则返回空 String。
- 令 result 为空 String。
- 令 nextIndex 为 0。
- 重复，
22.1.3 String 原型对象的属性
String 原型对象：
- 是 %String.prototype%。
- 是 String 奇异对象，并具有为这类对象指定的内部方法。
- 具有一个 [[StringData]] 内部槽，其值为空 String。
- 具有一个
"length" 属性，其初始值为+0 𝔽，并且其特性为 { [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:false }。 - 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。
除非另有明确说明，下文定义的 String 原型对象的方法不是泛型的，并且传给它们的
22.1.3.1 String.prototype.at ( index )
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 令 string 为 ?
ToString (thisValue)。 - 令 length 为 string 的长度。
- 令 relativeIndex 为 ?
ToIntegerOrInfinity (index)。 - 如果 relativeIndex ≥ 0，则
- 令 k 为 relativeIndex。
- 否则，
- 令 k 为 length + relativeIndex。
- 如果 k < 0 或 k ≥ length，则返回
undefined 。 - 返回 string 从 k 到 k + 1 的
子字符串 。
22.1.3.2 String.prototype.charAt ( position )
此方法返回一个单元素 String，
如果 pos 是整数 Number，则 x.charAt(pos) 的结果等价于 x.substring(pos, pos + 1) 的结果。
此方法在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 令 string 为 ?
ToString (thisValue)。 - 将 position 设置为 ?
ToIntegerOrInfinity (position)。 - 令 size 为 string 的长度。
- 如果 position < 0 或 position ≥ size，则返回空 String。
- 返回 string 从 position 到 position + 1 的
子字符串 。
此方法有意设计为泛型的；它不要求其
22.1.3.3 String.prototype.charCodeAt ( position )
此方法返回一个 Number（一个小于 216 的非负整数 Number），它是将此对象转换为 String 后所得 String 中索引 position 处码元的数值。如果该索引处没有元素，则结果为
此方法在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 令 string 为 ?
ToString (thisValue)。 - 将 position 设置为 ?
ToIntegerOrInfinity (position)。 - 令 size 为 string 的长度。
- 如果 position < 0 或 position ≥ size，则返回
NaN 。 - 返回 String string 中索引 position 处码元的数值对应的
Number 值 。
此方法有意设计为泛型的；它不要求其
22.1.3.4 String.prototype.codePointAt ( position )
此方法在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 令 string 为 ?
ToString (thisValue)。 - 将 position 设置为 ?
ToIntegerOrInfinity (position)。 - 令 size 为 string 的长度。
- 如果 position < 0 或 position ≥ size，则返回
undefined 。 - 令 codePoint 为
CodePointAt (string, position)。 - 返回
𝔽 (codePoint.[[CodePoint]])。
此方法有意设计为泛型的；它不要求其
22.1.3.5 String.prototype.concat ( ...args )
调用此方法时，它返回一个 String 值，该值由
此方法在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 令 string 为 ?
ToString (thisValue)。 - 令 result 为 string。
- 对 args 的每个元素 next，执行：
- 返回 result。
此方法的
此方法有意设计为泛型的；它不要求其
22.1.3.6 String.prototype.constructor
String.prototype.constructor 的初始值是
22.1.3.7 String.prototype.endsWith ( searchString [ , endPosition ] )
此方法在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 令 string 为 ?
ToString (thisValue)。 - 令 isRegexp 为 ?
IsRegExp (searchString)。 - 如果 isRegexp 是
true ，则抛出TypeError 异常。 - 将 searchString 设置为 ?
ToString (searchString)。 - 令 length 为 string 的长度。
- 如果 endPosition 是
undefined ，则令 position 为 length；否则令 position 为 ?ToIntegerOrInfinity (endPosition)。 - 令 end 为将 position 夹在 0 与 length 之间的结果。
- 令 searchLength 为 searchString 的长度。
- 如果 searchLength = 0，则返回
true 。 - 令 start 为 end - searchLength。
- 如果 start < 0，则返回
false 。 - 令 substring 为 string 从 start 到 end 的
子字符串 。 - 如果 substring 是 searchString，则返回
true 。 - 返回
false 。
指定当第一个实参是 RegExp 时抛出异常，是为了允许未来版本定义允许这类实参值的扩展。
此方法有意设计为泛型的；它不要求其
22.1.3.8 String.prototype.includes ( searchString [ , position ] )
此方法在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 令 string 为 ?
ToString (thisValue)。 - 令 isRegexp 为 ?
IsRegExp (searchString)。 - 如果 isRegexp 是
true ，则抛出TypeError 异常。 - 将 searchString 设置为 ?
ToString (searchString)。 - 令 positionInt 为 ?
ToIntegerOrInfinity (position)。 - 断言：如果 position 是
undefined ，则 positionInt 是 0。 - 令 length 为 string 的长度。
- 令 start 为将 positionInt 夹在 0 与 length 之间的结果。
- 令 index 为
StringIndexOf (string, searchString, start)。 - 如果 index 是
not-found ，则返回false 。 - 返回
true 。
如果 searchString 作为将此对象转换为 String 的结果的
指定当第一个实参是 RegExp 时抛出异常，是为了允许未来版本定义允许这类实参值的扩展。
此方法有意设计为泛型的；它不要求其
22.1.3.9 String.prototype.indexOf ( searchString [ , position ] )
如果 searchString 作为将此对象转换为 String 的结果的
此方法在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 令 string 为 ?
ToString (thisValue)。 - 将 searchString 设置为 ?
ToString (searchString)。 - 令 positionInt 为 ?
ToIntegerOrInfinity (position)。 - 断言：如果 position 是
undefined ，则 positionInt 是 0。 - 令 length 为 string 的长度。
- 令 start 为将 positionInt 夹在 0 与 length 之间的结果。
- 令 result 为
StringIndexOf (string, searchString, start)。 - 如果 result 是
not-found ，则返回-1 𝔽。 - 返回
𝔽 (result)。
此方法有意设计为泛型的；它不要求其
22.1.3.10 String.prototype.isWellFormed ( )
此方法在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 令 string 为 ?
ToString (thisValue)。 - 返回
IsStringWellFormedUnicode (string)。
22.1.3.11 String.prototype.lastIndexOf ( searchString [ , position ] )
如果 searchString 作为将此对象转换为 String 的结果的
此方法在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 令 string 为 ?
ToString (thisValue)。 - 将 searchString 设置为 ?
ToString (searchString)。 - 令 numberPosition 为 ?
ToNumber (position)。 - 断言：如果 position 是
undefined ，则 numberPosition 是NaN 。 - 如果 numberPosition 是
NaN ，则将 position 设置为 +∞；否则将 position 设置为 !ToIntegerOrInfinity (numberPosition)。 - 令 length 为 string 的长度。
- 令 searchLength 为 searchString 的长度。
- 如果 length < searchLength，则返回
-1 𝔽。 - 令 start 为将 position 夹在 0 与 length - searchLength 之间的结果。
- 令 result 为
StringLastIndexOf (string, searchString, start)。 - 如果 result 是
not-found ，则返回-1 𝔽。 - 返回
𝔽 (result)。
此方法有意设计为泛型的；它不要求其
22.1.3.12 String.prototype.localeCompare ( that [ , reserved1 [ , reserved2 ] ] )
此方法返回一个非
在执行比较之前，此方法执行以下步骤以准备 Strings：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 令 string 为 ?
ToString (thisValue)。 - 令 thatValue 为 ?
ToString (that)。
此方法的可选第二和第三参数的含义在 ECMA-402 规范中定义；不
实际返回值由实现定义，以允许在其中编码额外信息，但当此方法被视为两个实参的方法时，它必须是一个一致的比较器，定义所有 Strings 集合上的全序。此方法还必须识别并遵守 Unicode Standard 中的规范等价，包括在比较可区分但规范等价的 Strings 时返回
此方法本身不适合直接作为 Array.prototype.sort 的实参，因为后者要求一个二元函数。
此方法可以依赖 ECMAScript 环境从
// Å ANGSTROM SIGN vs.
// Å LATIN CAPITAL LETTER A + COMBINING RING ABOVE
"\u212B".localeCompare("A\u030A")
// Ω OHM SIGN vs.
// Ω GREEK CAPITAL LETTER OMEGA
"\u2126".localeCompare("\u03A9")
// ṩ LATIN SMALL LETTER S WITH DOT BELOW AND DOT ABOVE vs.
// ṩ LATIN SMALL LETTER S + COMBINING DOT ABOVE + COMBINING DOT BELOW
"\u1E69".localeCompare("s\u0307\u0323")
// ḍ̇ LATIN SMALL LETTER D WITH DOT ABOVE + COMBINING DOT BELOW vs.
// ḍ̇ LATIN SMALL LETTER D WITH DOT BELOW + COMBINING DOT ABOVE
"\u1E0B\u0323".localeCompare("\u1E0D\u0307")
// 가 HANGUL CHOSEONG KIYEOK + HANGUL JUNGSEONG A vs.
// 가 HANGUL SYLLABLE GA
"\u1100\u1161".localeCompare("\uAC00")关于规范等价的定义和讨论，见 Unicode Standard 第 2 章和第 3 章，以及 Unicode Standard Annex #15, Unicode Normalization Forms 和 Unicode Technical Note #5, Canonical Equivalence in Applications。另见 Unicode Technical Standard #10, Unicode Collation Algorithm。
建议此方法不应遵守 Unicode Standard 第 3 章第 3.7 节中定义的 Unicode 兼容等价或兼容分解。
此方法有意设计为泛型的；它不要求其
22.1.3.13 String.prototype.match ( regexpOrPattern )
此方法在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 如果 regexpOrPattern 是 Object，则
- 令 matcher 为 ?
GetMethod (regexpOrPattern,%Symbol.match% )。 - 如果 matcher 不是
undefined ，则- 返回 ?
Call (matcher, regexpOrPattern, « thisValue »)。
- 返回 ?
- 令 matcher 为 ?
- 令 string 为 ?
ToString (thisValue)。 - 令 regexp 为 ?
RegExpCreate (regexpOrPattern,undefined )。 - 返回 ?
Invoke (regexp,%Symbol.match% , « string »)。
此方法有意设计为泛型的；它不要求其
22.1.3.14 String.prototype.matchAll ( regexpOrPattern )
此方法对表示
它在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 如果 regexpOrPattern 是 Object，则
- 令 isRegexp 为 ?
IsRegExp (regexpOrPattern)。 - 如果 isRegexp 是
true ，则- 令 flags 为 ?
Get (regexpOrPattern,"flags" )。 - 执行 ?
RequireObjectCoercible (flags)。 - 如果 ?
ToString (flags) 不包含 "g" ，则抛出TypeError 异常。
- 令 flags 为 ?
- 令 matcher 为 ?
GetMethod (regexpOrPattern,%Symbol.matchAll% )。 - 如果 matcher 不是
undefined ，则- 返回 ?
Call (matcher, regexpOrPattern, « thisValue »)。
- 返回 ?
- 令 isRegexp 为 ?
- 令 string 为 ?
ToString (thisValue)。 - 令 regexp 为 ?
RegExpCreate (regexpOrPattern,"g" )。 - 返回 ?
Invoke (regexp,%Symbol.matchAll% , « string »)。
String.prototype.split，String.prototype.matchAll 被设计为通常不改变其输入。22.1.3.15 String.prototype.normalize ( [ form ] )
此方法在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 令 string 为 ?
ToString (thisValue)。 - 如果 form 是
undefined ，则将 form 设置为"NFC" 。 - 否则，将 form 设置为 ?
ToString (form)。 - 如果 form 不是
"NFC" 、"NFD" 、"NFKC" 或"NFKD" 之一，则抛出RangeError 异常。 - 令 normal 为 String 值，它是按照 最新 Unicode Standard, Normalization Forms 中指定的方式，把 string 规范化为由 form 命名的规范化形式所得的结果。
- 返回 normal。
此方法有意设计为泛型的；它不要求其
22.1.3.16 String.prototype.padEnd ( maxLength [ , fillString ] )
此方法在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 返回 ?
StringPaddingBuiltinsImpl (thisValue, maxLength, fillString,end )。
22.1.3.17 String.prototype.padStart ( maxLength [ , fillString ] )
此方法在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 返回 ?
StringPaddingBuiltinsImpl (thisValue, maxLength, fillString,start )。
22.1.3.17.1 StringPaddingBuiltinsImpl ( thisValue, maxLength, fillString, placement )
The abstract operation StringPaddingBuiltinsImpl takes arguments thisValue (an ECMAScript language value), maxLength (an ECMAScript language value), fillString (an ECMAScript language value), and placement (
- 令 string 为 ?
ToString (thisValue)。 - 令 intMaxLength 为
ℝ (?ToLength (maxLength))。 - 令 stringLength 为 string 的长度。
- 如果 intMaxLength ≤ stringLength，则返回 string。
- 如果 fillString 是
undefined ，则将 fillString 设置为仅由码元 0x0020（SPACE）组成的 String 值。 - 否则，将 fillString 设置为 ?
ToString (fillString)。 - 返回
StringPad (string, intMaxLength, fillString, placement)。
22.1.3.17.2 StringPad ( string, maxLength, fillString, placement )
The abstract operation StringPad takes arguments string (a String), maxLength (a non-negative
- 令 stringLength 为 string 的长度。
- 如果 maxLength ≤ stringLength，则返回 string。
- 如果 fillString 是空 String，则返回 string。
- 令 fillLength 为 maxLength - stringLength。
- 令 truncatedStringFiller 为由 fillString 的重复连接组成并截断到长度 fillLength 的 String 值。
- 如果 placement 是
start ，则返回 truncatedStringFiller 和 string 的字符串连接 。 - 返回 string 和 truncatedStringFiller 的
字符串连接 。
实参 maxLength 会被夹住，使其不能小于 string 的长度。
实参 fillString 默认为
22.1.3.17.3 ToZeroPaddedDecimalString ( n, minLength )
The abstract operation ToZeroPaddedDecimalString takes arguments n (a non-negative
- 令 string 为 n 的 String 表示，格式化为十进制数。
- 返回
StringPad (string, minLength,"0" ,start )。
22.1.3.18 String.prototype.repeat ( count )
此方法在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 令 string 为 ?
ToString (thisValue)。 - 令 n 为 ?
ToIntegerOrInfinity (count)。 - 如果 n < 0 或 n = +∞，则抛出
RangeError 异常。 - 如果 n = 0，则返回空 String。
- 返回由 string 的 n 个副本连接在一起构成的 String 值。
此方法创建由
此方法有意设计为泛型的；它不要求其
22.1.3.19 String.prototype.replace ( searchValue, replaceValue )
此方法在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 如果 searchValue 是 Object，则
- 令 replacer 为 ?
GetMethod (searchValue,%Symbol.replace% )。 - 如果 replacer 不是
undefined ，则- 返回 ?
Call (replacer, searchValue, « thisValue, replaceValue »)。
- 返回 ?
- 令 replacer 为 ?
- 令 string 为 ?
ToString (thisValue)。 - 令 searchString 为 ?
ToString (searchValue)。 - 令 functionalReplace 为
IsCallable (replaceValue)。 - 如果 functionalReplace 是
false ，则- 将 replaceValue 设置为 ?
ToString (replaceValue)。
- 将 replaceValue 设置为 ?
- 令 searchLength 为 searchString 的长度。
- 令 position 为
StringIndexOf (string, searchString, 0)。 - 如果 position 是
not-found ，则返回 string。 - 令 preceding 为 string 从 0 到 position 的
子字符串 。 - 令 following 为 string 从 position + searchLength 起的
子字符串 。 - 如果 functionalReplace 是
true ，则 - 否则，
- 断言：replaceValue 是 String。
- 令 captures 为新的空
List 。 - 令 replacement 为 !
GetSubstitution (searchString, string, position, captures,undefined , replaceValue)。
- 返回 preceding、replacement 和 following 的
字符串连接 。
此方法有意设计为泛型的；它不要求其
22.1.3.19.1 GetSubstitution ( matched, string, position, captures, namedCaptures, replacementTemplate )
The abstract operation GetSubstitution takes arguments matched (a String), string (a String), position (a non-negative
- 令 stringLength 为 string 的长度。
- 断言：position ≤ stringLength。
- 令 result 为空 String。
- 令 templateRemainder 为 replacementTemplate。
- 重复，只要 templateRemainder 不是空 String，
- 注：以下步骤分离 ref（templateRemainder 的前缀），确定 refReplacement（其替换），然后把该替换追加到 result。
- 如果 templateRemainder 以
"$$" 开头，则- 令 ref 为
"$$" 。 - 令 refReplacement 为
"$" 。
- 令 ref 为
- 否则，如果 templateRemainder 以
"$`" 开头，则- 令 ref 为
"$`" 。 - 令 refReplacement 为 string 从 0 到 position 的
子字符串 。
- 令 ref 为
- 否则，如果 templateRemainder 以
"$&" 开头，则- 令 ref 为
"$&" 。 - 令 refReplacement 为 matched。
- 令 ref 为
- 否则，如果 templateRemainder 以
"$'" （0x0024（DOLLAR SIGN）后跟 0x0027（APOSTROPHE））开头，则- 令 ref 为
"$'" 。 - 令 matchLength 为 matched 的长度。
- 令 tailPosition 为 position + matchLength。
- 令 refReplacement 为 string 从
min (tailPosition, stringLength) 起的子字符串 。 - 注：只有当此
抽象操作 由%RegExp.prototype% 的固有%Symbol.replace% 方法在其"exec" 属性不是固有 %RegExp.prototype.exec% 的对象上调用时，tailPosition 才可能超过 stringLength。
- 令 ref 为
- 否则，如果 templateRemainder 以
"$" 后跟 1 个或更多十进制数字开头，则- 如果 templateRemainder 以
"$" 后跟 2 个或更多十进制数字开头，则令 digitCount 为 2；否则令 digitCount 为 1。 - 令 digits 为 templateRemainder 从 1 到 1 + digitCount 的
子字符串 。 - 令 index 为
ℝ (StringToNumber (digits))。 - 断言：0 ≤ index ≤ 99。
- 令 captureLength 为 captures 中元素的数量。
- 如果 index > captureLength 且 digitCount = 2，则
- 注：当两位替换模式指定了超出捕获组数量的索引时，它会被视为一位替换模式，后跟一个字面数字。
- 将 digitCount 设置为 1。
- 将 digits 设置为 digits 从 0 到 1 的
子字符串 。 - 将 index 设置为
ℝ (StringToNumber (digits))。
- 令 ref 为 templateRemainder 从 0 到 1 + digitCount 的
子字符串 。 - 如果 1 ≤ index ≤ captureLength，则
- 令 capture 为 captures[index - 1]。
- 如果 capture 是
undefined ，则- 令 refReplacement 为空 String。
- 否则，
- 令 refReplacement 为 capture。
- 否则，
- 令 refReplacement 为 ref。
- 如果 templateRemainder 以
- 否则，如果 templateRemainder 以
"$<" 开头，则- 令 gtPosition 为
StringIndexOf (templateRemainder,">" , 0)。 - 如果 gtPosition 是
not-found 或 namedCaptures 是undefined ，则- 令 ref 为
"$<" 。 - 令 refReplacement 为 ref。
- 令 ref 为
- 否则，
- 令 gtPosition 为
- 否则，
- 令 ref 为 templateRemainder 从 0 到 1 的
子字符串 。 - 令 refReplacement 为 ref。
- 令 ref 为 templateRemainder 从 0 到 1 的
- 令 refLength 为 ref 的长度。
- 将 templateRemainder 设置为 templateRemainder 从 refLength 起的
子字符串 。 - 将 result 设置为 result 和 refReplacement 的
字符串连接 。
- 返回 result。
22.1.3.20 String.prototype.replaceAll ( searchValue, replaceValue )
此方法在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 如果 searchValue 是 Object，则
- 令 isRegexp 为 ?
IsRegExp (searchValue)。 - 如果 isRegexp 是
true ，则- 令 flags 为 ?
Get (searchValue,"flags" )。 - 执行 ?
RequireObjectCoercible (flags)。 - 如果 ?
ToString (flags) 不包含 "g" ，则抛出TypeError 异常。
- 令 flags 为 ?
- 令 replacer 为 ?
GetMethod (searchValue,%Symbol.replace% )。 - 如果 replacer 不是
undefined ，则- 返回 ?
Call (replacer, searchValue, « thisValue, replaceValue »)。
- 返回 ?
- 令 isRegexp 为 ?
- 令 string 为 ?
ToString (thisValue)。 - 令 searchString 为 ?
ToString (searchValue)。 - 令 functionalReplace 为
IsCallable (replaceValue)。 - 如果 functionalReplace 是
false ，则- 将 replaceValue 设置为 ?
ToString (replaceValue)。
- 将 replaceValue 设置为 ?
- 令 searchLength 为 searchString 的长度。
- 令 advanceBy 为
max (1, searchLength)。 - 令 matchPositions 为新的空
List 。 - 令 position 为
StringIndexOf (string, searchString, 0)。 - 重复，只要 position 不是
not-found ，- 将 position 追加到 matchPositions。
- 将 position 设置为
StringIndexOf (string, searchString, position + advanceBy)。
- 令 endOfLastMatch 为 0。
- 令 result 为空 String。
- 对 matchPositions 的每个元素 matchPosition，执行：
- 令 preserved 为 string 从 endOfLastMatch 到 matchPosition 的
子字符串 。 - 如果 functionalReplace 是
true ，则 - 否则，
- 断言：replaceValue 是 String。
- 令 captures 为新的空
List 。 - 令 replacement 为 !
GetSubstitution (searchString, string, matchPosition, captures,undefined , replaceValue)。
- 将 result 设置为 result、preserved 和 replacement 的
字符串连接 。 - 将 endOfLastMatch 设置为 matchPosition + searchLength。
- 令 preserved 为 string 从 endOfLastMatch 到 matchPosition 的
- 如果 endOfLastMatch < string 的长度，则
- 返回 result。
22.1.3.21 String.prototype.search ( regexpOrPattern )
此方法在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 如果 regexpOrPattern 是 Object，则
- 令 searcher 为 ?
GetMethod (regexpOrPattern,%Symbol.search% )。 - 如果 searcher 不是
undefined ，则- 返回 ?
Call (searcher, regexpOrPattern, « thisValue »)。
- 返回 ?
- 令 searcher 为 ?
- 令 string 为 ?
ToString (thisValue)。 - 令 regexp 为 ?
RegExpCreate (regexpOrPattern,undefined )。 - 返回 ?
Invoke (regexp,%Symbol.search% , « string »)。
此方法有意设计为泛型的；它不要求其
22.1.3.22 String.prototype.slice ( start, end )
此方法返回将此对象转换为 String 后所得结果的一个
它在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 令 string 为 ?
ToString (thisValue)。 - 令 length 为 string 的长度。
- 令 intStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 intStart = -∞，则令 from 为 0。
- 否则，如果 intStart < 0，则令 from 为
max (length + intStart, 0)。 - 否则，令 from 为
min (intStart, length)。 - 如果 end 是
undefined ，则令 intEnd 为 length；否则令 intEnd 为 ?ToIntegerOrInfinity (end)。 - 如果 intEnd = -∞，则令 to 为 0。
- 否则，如果 intEnd < 0，则令 to 为
max (length + intEnd, 0)。 - 否则，令 to 为
min (intEnd, length)。 - 如果 from ≥ to，则返回空 String。
- 返回 string 从 from 到 to 的
子字符串 。
此方法有意设计为泛型的；它不要求其
22.1.3.23 String.prototype.split ( separator, limit )
此方法返回一个 Array，其中存储了将此对象转换为 String 后所得结果的各个
它在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 如果 separator 是 Object，则
- 令 splitter 为 ?
GetMethod (separator,%Symbol.split% )。 - 如果 splitter 不是
undefined ，则- 返回 ?
Call (splitter, separator, « thisValue, limit »)。
- 返回 ?
- 令 splitter 为 ?
- 令 string 为 ?
ToString (thisValue)。 - 如果 limit 是
undefined ，则令 lim 为 232 - 1；否则令 lim 为ℝ (?ToUint32 (limit))。 - 令 separatorString 为 ?
ToString (separator)。 - 如果 lim = 0，则
- 返回
CreateArrayFromList (« »)。
- 返回
- 如果 separator 是
undefined ，则- 返回
CreateArrayFromList (« string »)。
- 返回
- 令 separatorLength 为 separatorString 的长度。
- 如果 separatorLength = 0，则
- 令 stringLength 为 string 的长度。
- 令 outLength 为将 lim 夹在 0 与 stringLength 之间的结果。
- 令 head 为 string 从 0 到 outLength 的
子字符串 。 - 令 codeUnits 为由 head 的各元素码元序列组成的
List 。 - 返回
CreateArrayFromList (codeUnits)。
- 如果 string 是空 String，则返回
CreateArrayFromList (« string »)。 - 令 substrings 为新的空
List 。 - 令 searchStart 为 0。
- 令 matchIndex 为
StringIndexOf (string, separatorString, 0)。 - 重复，只要 matchIndex 不是
not-found ，- 令 substring 为 string 从 searchStart 到 matchIndex 的
子字符串 。 - 将 substring 追加到 substrings。
- 如果 substrings 中元素的数量是 lim，则返回
CreateArrayFromList (substrings)。 - 将 searchStart 设置为 matchIndex + separatorLength。
- 将 matchIndex 设置为
StringIndexOf (string, separatorString, searchStart)。
- 令 substring 为 string 从 searchStart 到 matchIndex 的
- 令 substring 为 string 从 searchStart 起的
子字符串 。 - 将 substring 追加到 substrings。
- 返回
CreateArrayFromList (substrings)。
separator 的值可以是空 String。在这种情况下，separator 不匹配输入 String 开头或结尾处的空
如果
如果 separator 是
此方法有意设计为泛型的；它不要求其
22.1.3.24 String.prototype.startsWith ( searchString [ , position ] )
此方法在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 令 string 为 ?
ToString (thisValue)。 - 令 isRegexp 为 ?
IsRegExp (searchString)。 - 如果 isRegexp 是
true ，则抛出TypeError 异常。 - 将 searchString 设置为 ?
ToString (searchString)。 - 令 length 为 string 的长度。
- 如果 position 是
undefined ，则将 position 设置为 0；否则将 position 设置为 ?ToIntegerOrInfinity (position)。 - 令 start 为将 position 夹在 0 与 length 之间的结果。
- 令 searchLength 为 searchString 的长度。
- 如果 searchLength = 0，则返回
true 。 - 令 end 为 start + searchLength。
- 如果 end > length，则返回
false 。 - 令 substring 为 string 从 start 到 end 的
子字符串 。 - 如果 substring 是 searchString，则返回
true 。 - 返回
false 。
指定当第一个实参是 RegExp 时抛出异常，是为了允许未来版本定义允许这类实参值的扩展。
此方法有意设计为泛型的；它不要求其
22.1.3.25 String.prototype.substring ( start, end )
此方法返回将此对象转换为 String 后所得结果的一个
如果任一实参是
如果 start 严格大于 end，则交换二者。
它在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 令 string 为 ?
ToString (thisValue)。 - 令 length 为 string 的长度。
- 令 intStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 end 是
undefined ，则令 intEnd 为 length；否则令 intEnd 为 ?ToIntegerOrInfinity (end)。 - 令 finalStart 为将 intStart 夹在 0 与 length 之间的结果。
- 令 finalEnd 为将 intEnd 夹在 0 与 length 之间的结果。
- 令 from 为
min (finalStart, finalEnd)。 - 令 to 为
max (finalStart, finalEnd)。 - 返回 string 从 from 到 to 的
子字符串 。
此方法有意设计为泛型的；它不要求其
22.1.3.26 String.prototype.toLocaleLowerCase ( [ reserved1 [ , reserved2 ] ] )
此方法将 String 值解释为 UTF-16 编码码点序列，如
它的工作方式与 toLowerCase 完全相同，只是它旨在产生与
此方法可选参数的含义在 ECMA-402 规范中定义；不
此方法有意设计为泛型的；它不要求其
22.1.3.27 String.prototype.toLocaleUpperCase ( [ reserved1 [ , reserved2 ] ] )
此方法将 String 值解释为 UTF-16 编码码点序列，如
它的工作方式与 toUpperCase 完全相同，只是它旨在产生与
此方法可选参数的含义在 ECMA-402 规范中定义；不
此方法有意设计为泛型的；它不要求其
22.1.3.28 String.prototype.toLowerCase ( )
此方法将 String 值解释为 UTF-16 编码码点序列，如
它在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 令 string 为 ?
ToString (thisValue)。 - 令 sText 为
StringToCodePoints (string)。 - 令 lowerText 为按照 Unicode Default Case Conversion 算法对 sText 执行 toLowercase 的结果。
- 令 lowercaseString 为
CodePointsToString (lowerText)。 - 返回 lowercaseString。
结果必须根据 Unicode Character Database 中的区域设置无关大小写映射派生（这明确不仅包括文件 UnicodeData.txt，还包括随附文件 SpecialCasing.txt 中所有区域设置无关的映射）。
某些码点的大小写映射可能产生多个码点。在这种情况下，结果 String 的长度可能与源 String 不同。由于 toUpperCase 和 toLowerCase 都具有上下文敏感行为，这两个方法并不对称。换句话说，s.toUpperCase().toLowerCase() 不一定等于 s.toLowerCase()。
此方法有意设计为泛型的；它不要求其
22.1.3.29 String.prototype.toString ( )
此方法在被调用时执行以下步骤：
- 返回 ?
ThisStringValue (this value)。
对于 String 对象，此方法恰好返回与 valueOf 方法相同的内容。
22.1.3.30 String.prototype.toUpperCase ( )
此方法将 String 值解释为 UTF-16 编码码点序列，如
它的行为与 String.prototype.toLowerCase 完全相同，只是 String 使用 Unicode Default Case Conversion 的 toUppercase 算法进行映射。
此方法有意设计为泛型的；它不要求其
22.1.3.31 String.prototype.toWellFormed ( )
此方法返回此对象的 String 表示，其中所有不属于
它在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 执行 ?
RequireObjectCoercible (thisValue)。 - 令 string 为 ?
ToString (thisValue)。 - 令 stringLength 为 string 的长度。
- 令 k 为 0。
- 令 result 为空 String。
- 重复，只要 k < stringLength，
- 令 codePoint 为
CodePointAt (string, k)。 - 如果 codePoint.[[IsUnpairedSurrogate]] 是
true ，则- 将 result 设置为 result 和 0xFFFD（REPLACEMENT CHARACTER）的
字符串连接 。
- 将 result 设置为 result 和 0xFFFD（REPLACEMENT CHARACTER）的
- 否则，
- 将 result 设置为 result 和
UTF16EncodeCodePoint (codePoint.[[CodePoint]]) 的字符串连接 。
- 将 result 设置为 result 和
- 将 k 设置为 k + codePoint.[[CodeUnitCount]]。
- 令 codePoint 为
- 返回 result。
22.1.3.32 String.prototype.trim ( )
此方法将 String 值解释为 UTF-16 编码码点序列，如
它在被调用时执行以下步骤：
- 令 thisValue 为
this value。 - 返回 ?
TrimString (thisValue,start+end )。
此方法有意设计为泛型的；它不要求其
22.1.3.32.1 TrimString ( arg, where )
The abstract operation TrimString takes arguments arg (an ECMAScript language value) and where (
- 执行 ?
RequireObjectCoercible (arg)。 - 令 string 为 ?
ToString (arg)。 - 如果 where 是
start ，则- 令 trimmedString 为 string 的副本并移除其前导空白。
- 否则，如果 where 是
end ，则- 令 trimmedString 为 string 的副本并移除其尾随空白。
- 否则，
- 断言：where 是
start+end 。 - 令 trimmedString 为 string 的副本并移除其前导和尾随空白。
- 断言：where 是
- 返回 trimmedString。
空白的定义是
22.1.3.33 String.prototype.trimEnd ( )
此方法将 String 值解释为 UTF-16 编码码点序列，如
它在被调用时执行以下步骤：
- 令 string 为
this value。 - 返回 ?
TrimString (string,end )。
此方法有意设计为泛型的；它不要求其
22.1.3.34 String.prototype.trimStart ( )
此方法将 String 值解释为 UTF-16 编码码点序列，如
它在被调用时执行以下步骤：
- 令 string 为
this value。 - 返回 ?
TrimString (string,start )。
此方法有意设计为泛型的；它不要求其
22.1.3.35 String.prototype.valueOf ( )
此方法在被调用时执行以下步骤：
- 返回 ?
ThisStringValue (this value)。
22.1.3.35.1 ThisStringValue ( arg )
The abstract operation ThisStringValue takes argument arg (an ECMAScript language value) and returns either a normal completion containing a String or a throw completion. It performs the following steps when called:
- 如果 arg 是 String，则返回 arg。
- 如果 arg 是 Object 且 arg 具有 [[StringData]] 内部槽，则
- 令 string 为 arg.[[StringData]]。
- 断言：string 是 String。
- 返回 string。
- 抛出
TypeError 异常。
22.1.3.36 String.prototype [ %Symbol.iterator% ] ( )
此方法返回一个迭代器对象，该对象迭代 String 值的码点，并将每个码点作为 String 值返回。
它在被调用时执行以下步骤：
- 令 string 为
this value。 - 执行 ?
RequireObjectCoercible (string)。 - 将 string 设置为 ?
ToString (string)。 - 令 closure 为一个新的无参数
Abstract Closure ，它捕获 string，并在被调用时执行以下步骤：- 令 length 为 string 的长度。
- 令 position 为 0。
- 重复，只要 position < length，
- 令 codePoint 为
CodePointAt (string, position)。 - 令 nextIndex 为 position + codePoint.[[CodeUnitCount]]。
- 令 resultString 为 string 从 position 到 nextIndex 的
子字符串 。 - 将 position 设置为 nextIndex。
- 执行 ?
GeneratorYield (CreateIteratorResultObject (resultString,false ))。
- 令 codePoint 为
- 返回
NormalCompletion (unused )。
- 返回
CreateIteratorFromClosure (closure,"%StringIteratorPrototype%" ,%StringIteratorPrototype% )。
此方法的
22.1.4 String 实例的属性
String 实例是 String 奇异对象，并具有为这类对象指定的内部方法。String 实例继承自
String 实例具有一个
22.1.4.1 length
此 String 对象所表示的 String 值中的元素数量。
一旦 String 对象被初始化，此属性就不再变化。它具有特性 { [[Writable]]:
22.1.5 String Iterator 对象
String Iterator 是表示对某个特定 String 实例对象的某次特定迭代的对象。String Iterator 对象没有具名构造器。相反，String Iterator 对象通过调用 String 实例对象的某些方法创建。
22.1.5.1 %StringIteratorPrototype% 对象
%StringIteratorPrototype% 对象：
- 具有由所有
String Iterator 对象继承的属性。 - 是
普通对象 。 - 具有一个 [[Prototype]] 内部槽，其值为
%Iterator.prototype% 。 - 具有以下属性：
22.1.5.1.1 %StringIteratorPrototype%.next ( )
- 返回 ?
GeneratorResume (this value,empty ,"%StringIteratorPrototype%" )。
22.1.5.1.2 %StringIteratorPrototype% [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
22.2 RegExp（正则表达式）对象
RegExp 对象
正则表达式的形式和功能以 Perl 5 编程语言中的正则表达式设施为模型。
22.2.1 模式
RegExp 构造器会把以下文法应用于输入的 pattern String。如果该文法不能把该 String 解释为
语法
对于每个 \u u u u \u
这里的前两行等价于 CharacterClass。
本节中的若干产生式在
22.2.1.1 Static Semantics: 早期错误
本节在
-
如果
CountLeftCapturingParensWithin (Pattern ) ≥ 232 - 1，则为语法错误。 -
如果
Pattern 包含 两个不同的GroupSpecifier x 和 y，使得 x 的CapturingGroupName 与 y 的CapturingGroupName 相同，并且MightBothParticipate (x, y) 是true ，则为语法错误。
-
如果第一个
DecimalDigits 的 MV 严格大于第二个DecimalDigits 的 MV，则为语法错误。
-
如果
RegularExpressionModifiers 匹配的源文本 包含 同一个码点超过一次，则为语法错误。
-
如果第一个
RegularExpressionModifiers 匹配的源文本 和第二个RegularExpressionModifiers 匹配的源文本 都为空，则为语法错误。 -
如果第一个
RegularExpressionModifiers 匹配的源文本 包含 同一个码点超过一次，则为语法错误。 -
如果第二个
RegularExpressionModifiers 匹配的源文本 包含 同一个码点超过一次，则为语法错误。 -
如果第一个
RegularExpressionModifiers 匹配的源文本 中的任何码点也包含 在第二个RegularExpressionModifiers 匹配的源文本 中，则为语法错误。
-
如果
GroupSpecifiersThatMatch (GroupName ) 为空，则为语法错误。
-
如果
DecimalEscape 的CapturingGroupNumber 严格大于CountLeftCapturingParensWithin (包含 AtomEscape 的Pattern )，则为语法错误。
-
如果第一个
ClassAtom 的IsCharacterClass 是true ，或第二个ClassAtom 的IsCharacterClass 是true ，则为语法错误。 -
如果第一个
ClassAtom 的IsCharacterClass 是false ，第二个ClassAtom 的IsCharacterClass 是false ，并且第一个ClassAtom 的CharacterValue 严格大于第二个ClassAtom 的CharacterValue ，则为语法错误。
-
如果
ClassAtomNoDash 的IsCharacterClass 是true ，或ClassAtom 的IsCharacterClass 是true ，则为语法错误。 -
如果
ClassAtomNoDash 的IsCharacterClass 是false ，ClassAtom 的IsCharacterClass 是false ，并且ClassAtomNoDash 的CharacterValue 严格大于ClassAtom 的CharacterValue ，则为语法错误。
-
如果
RegExpUnicodeEscapeSequence 的CharacterValue 不是IdentifierStartChar 词法文法产生式匹配的某个码点的数值，则为语法错误。
-
如果
RegExpIdentifierStart 的RegExpIdentifierCodePoint 未被UnicodeIDStart 词法文法产生式匹配，则为语法错误。
-
如果
RegExpUnicodeEscapeSequence 的CharacterValue 不是IdentifierPartChar 词法文法产生式匹配的某个码点的数值，则为语法错误。
-
如果
RegExpIdentifierPart 的RegExpIdentifierCodePoint 未被UnicodeIDContinue 词法文法产生式匹配，则为语法错误。
-
如果
UnicodePropertyName 匹配的源文本 不是Unicode 属性名 ，也不是Table 65 的 “Property name and aliases ” 列中列出的属性别名，则为语法错误。 -
如果
UnicodePropertyValue 匹配的源文本 不是PropertyValueAliases.txt中列出的、由UnicodePropertyName 匹配的源文本 给出的 Unicode 属性或属性别名的属性值或属性值别名，则为语法错误。
-
如果
LoneUnicodePropertyNameOrValue 匹配的源文本 既不是PropertyValueAliases.txt中列出的 General_Category (gc) 属性的 Unicode 属性值或属性值别名，也不是Table 66 的 “Property name and aliases ” 列中列出的二元属性或二元属性别名，也不是Table 67 的 “Property name ” 列中列出的字符串二元属性，则为语法错误。 -
如果外围
Pattern 不具有 [UnicodeSetsMode] 参数，并且LoneUnicodePropertyNameOrValue 匹配的源文本 是Table 67 的 “Property name ” 列中列出的字符串二元属性，则为语法错误。
-
如果
UnicodePropertyValueExpression 的MayContainStrings 是true ，则为语法错误。
-
如果
ClassContents 的MayContainStrings 是true ，则为语法错误。
-
如果
ClassContents 的MayContainStrings 是true ，则为语法错误。
-
如果第一个
ClassSetCharacter 的CharacterValue 严格大于第二个ClassSetCharacter 的CharacterValue ，则为语法错误。
22.2.1.2 Static Semantics: CountLeftCapturingParensWithin ( parseNode )
The abstract operation CountLeftCapturingParensWithin takes argument parseNode (a ( 终结符匹配的任意 ( 模式字符。
本节在
It performs the following steps when called:
- 断言：parseNode 是
RegExp Pattern 文法 中某个产生式的实例。 - 返回 parseNode 内
包含 的Atom :: ( GroupSpecifier opt Disjunction ) Parse Node 的数量。
22.2.1.3 Static Semantics: CountLeftCapturingParensBefore ( parseNode )
The abstract operation CountLeftCapturingParensBefore takes argument parseNode (a
本节在
It performs the following steps when called:
- 断言：parseNode 是
RegExp Pattern 文法 中某个产生式的实例。 - 令 pattern 为
包含 parseNode 的Pattern 。 - 返回 pattern 内
包含 的、出现在 parseNode 之前或包含 parseNode 的Atom :: ( GroupSpecifier opt Disjunction ) Parse Node 的数量。
22.2.1.4 Static Semantics: MightBothParticipate ( x, y )
The abstract operation MightBothParticipate takes arguments x (a
- 断言：x 和 y 具有相同的外围
Pattern 。 - 如果外围
Pattern 包含 一个Disjunction :: Alternative | Disjunction Parse Node ，使得 x包含 在Alternative 内而 y包含 在派生的Disjunction 内，或者 x包含 在派生的Disjunction 内而 y包含 在Alternative 内，则返回false 。 - 返回
true 。
22.2.1.5 Static Semantics: CapturingGroupNumber
The syntax-directed operation CapturingGroupNumber takes no arguments and returns a positive
本节在
It is defined piecewise over the following productions:
- 返回
NonZeroDigit 的 MV。
- 令 n 为
DecimalDigits 中码点的数量。 - 返回（
NonZeroDigit 的 MV × 10n 加上DecimalDigits 的 MV）。
“
22.2.1.6 Static Semantics: IsCharacterClass
The syntax-directed operation IsCharacterClass takes no arguments and returns a Boolean.
本节在
It is defined piecewise over the following productions:
- 返回
false 。
- 返回
true 。
22.2.1.7 Static Semantics: CharacterValue
The syntax-directed operation CharacterValue takes no arguments and returns a non-negative
本节在
It is defined piecewise over the following productions:
- 返回 U+002D（HYPHEN-MINUS）的数值。
- 令 codePoint 为
SourceCharacter 匹配的码点。 - 返回 codePoint 的数值。
- 返回 U+0008（BACKSPACE）的数值。
- 返回 U+002D（HYPHEN-MINUS）的数值。
- 返回依据
Table 63 得到的数值。
| ControlEscape | 数值 | 码点 | Unicode 名称 | 符号 |
|---|---|---|---|---|
t
|
9 |
U+0009
|
CHARACTER TABULATION | <HT> |
n
|
10 |
U+000A
|
LINE FEED (LF) | <LF> |
v
|
11 |
U+000B
|
LINE TABULATION | <VT> |
f
|
12 |
U+000C
|
FORM FEED (FF) | <FF> |
r
|
13 |
U+000D
|
CARRIAGE RETURN (CR) | <CR> |
- 令 codePoint 为
AsciiLetter 匹配的码点。 - 令 i 为 codePoint 的数值。
- 返回 i 除以 32 的余数。
- 返回 U+0000（NULL）的数值。
\0 表示 <NUL> 字符，并且其后不能跟十进制数字。
- 返回
HexEscapeSequence 的 MV。
- 令 lead 为
HexLeadSurrogate 的CharacterValue 。 - 令 trail 为
HexTrailSurrogate 的CharacterValue 。 - 令 codePoint 为
UTF16SurrogatePairToCodePoint (lead, trail)。 - 返回 codePoint 的数值。
- 返回
Hex4Digits 的 MV。
- 返回
CodePoint 的 MV。
- 返回
Hex4Digits 的 MV。
- 令 codePoint 为
IdentityEscape 匹配的码点。 - 返回 codePoint 的数值。
- 令 codePoint 为
SourceCharacter 匹配的码点。 - 返回 codePoint 的数值。
- 令 codePoint 为
ClassSetReservedPunctuator 匹配的码点。 - 返回 codePoint 的数值。
- 返回 U+0008（BACKSPACE）的数值。
22.2.1.8 Static Semantics: MayContainStrings
The syntax-directed operation MayContainStrings takes no arguments and returns a Boolean. It is defined piecewise over the following productions:
- 返回
false 。
- 如果
LoneUnicodePropertyNameOrValue 匹配的源文本 是Table 67 的 “Property name ” 列中列出的字符串二元属性，则返回true 。 - 返回
false 。
- 如果
ClassUnion 存在，则返回ClassUnion 的MayContainStrings 。 - 返回
false 。
- 如果
ClassSetOperand 的MayContainStrings 是true ，则返回true 。 - 如果
ClassUnion 存在，则返回ClassUnion 的MayContainStrings 。 - 返回
false 。
- 如果第一个
ClassSetOperand 的MayContainStrings 是false ，则返回false 。 - 如果第二个
ClassSetOperand 的MayContainStrings 是false ，则返回false 。 - 返回
true 。
- 如果
ClassIntersection 的MayContainStrings 是false ，则返回false 。 - 如果
ClassSetOperand 的MayContainStrings 是false ，则返回false 。 - 返回
true 。
- 返回第一个
ClassSetOperand 的MayContainStrings 。
- 如果
ClassString 的MayContainStrings 是true ，则返回true 。 - 返回
ClassStringDisjunctionContents 的MayContainStrings 。
- 返回
true 。
- 如果
NonEmptyClassString 存在，则返回true 。 - 返回
false 。
22.2.1.9 Static Semantics: GroupSpecifiersThatMatch ( thisGroupName )
The abstract operation GroupSpecifiersThatMatch takes argument thisGroupName (a
- 令 name 为 thisGroupName 的
CapturingGroupName 。 - 令 pattern 为
包含 thisGroupName 的Pattern 。 - 令 result 为新的空
List 。 - 对 pattern
包含 的每个GroupSpecifier groupSpecifier，执行：- 如果 groupSpecifier 的
CapturingGroupName 是 name，则- 将 groupSpecifier 追加到 result。
- 如果 groupSpecifier 的
- 返回 result。
22.2.1.10 Static Semantics: CapturingGroupName
The syntax-directed operation CapturingGroupName takes no arguments and returns a String. It is defined piecewise over the following productions:
- 令 idTextUnescaped 为
RegExpIdentifierName 的RegExpIdentifierCodePoints 。 - 返回
CodePointsToString (idTextUnescaped)。
22.2.1.11 Static Semantics: RegExpIdentifierCodePoints
The syntax-directed operation RegExpIdentifierCodePoints takes no arguments and returns a
- 令 codePoint 为
RegExpIdentifierStart 的RegExpIdentifierCodePoint 。 - 返回 « codePoint »。
- 令 codePoints 为派生的
RegExpIdentifierName 的RegExpIdentifierCodePoints 。 - 令 codePoint 为
RegExpIdentifierPart 的RegExpIdentifierCodePoint 。 - 返回 codePoints 和 « codePoint » 的
列表连接 。
22.2.1.12 Static Semantics: RegExpIdentifierCodePoint
The syntax-directed operation RegExpIdentifierCodePoint takes no arguments and returns a code point. It is defined piecewise over the following productions:
- 返回
IdentifierStartChar 匹配的码点。
- 返回
IdentifierPartChar 匹配的码点。
- 返回其数值为
RegExpUnicodeEscapeSequence 的CharacterValue 的码点。
- 令 lead 为一个码元，其数值为
UnicodeLeadSurrogate 匹配的码点的数值。 - 令 trail 为一个码元，其数值为
UnicodeTrailSurrogate 匹配的码点的数值。 - 返回
UTF16SurrogatePairToCodePoint (lead, trail)。
22.2.2 模式语义
正则表达式模式会使用下文描述的过程转换为
如果 u 也不v，则它是 BMP 模式。否则，它是 Unicode 模式。BMP 模式会匹配被解释为由 16 位值序列组成的 String，这些 16 位值是 Basic Multilingual Plane 范围内的 Unicode 码点。Unicode 模式会匹配被解释为由使用 UTF-16 编码的 Unicode 码点组成的 String。在描述 BMP 模式行为的上下文中，“字符”指单个 16 位 Unicode BMP 码点。在描述 Unicode 模式行为的上下文中，“字符”指 UTF-16 编码的码点（
例如，考虑一个在源文本中表示为单个非 BMP 字符 U+1D11E（MUSICAL SYMBOL G CLEF）的模式。如果解释为 Unicode 模式，它将是一个由单个码点 U+1D11E 组成的单元素（字符）
模式作为 ECMAScript String 值传给 RegExp 构造器，其中非 BMP 字符以 UTF-16 编码。例如，单个字符 MUSICAL SYMBOL G CLEF 模式，表示为 String 值时，是一个长度为 2 的 String，其元素是码元 0xD834 和 0xDD1E。因此，将其处理为由两个模式字符组成的 BMP 模式时，不需要进一步转换该字符串。然而，将其处理为 Unicode 模式时，必须使用
实现实际上可以不执行这种到 UTF-16 或从 UTF-16 的转换，但本规范的语义要求模式匹配的结果必须如同执行了这种转换一样。
22.2.2.1 记法
下列描述使用以下内部数据结构：
-
CharSetElement 是以下两个实体之一：
-
如果 regexpRecord.[[UnicodeSets]] 是
false ，则 CharSetElement 是上述 Pattern Semantics 意义上的一个字符。 -
如果 regexpRecord.[[UnicodeSets]] 是
true ，则 CharSetElement 是一个序列，其元素是上述 Pattern Semantics 意义上的字符。这包括空序列、一个字符的序列以及多于一个字符的序列。为方便起见，在处理这种 CharSetElement 时，单个字符可与一个字符的序列互换对待。
-
如果 regexpRecord.[[UnicodeSets]] 是
- CharSet 是 CharSetElement 的数学集合。
-
CaptureRange 是
Record { [[StartIndex]], [[EndIndex]] }，表示 capture 中包含 的字符范围，其中 [[StartIndex]] 是表示该范围在 input 中开始索引（包含 ）的整数，[[EndIndex]] 是表示该范围在 input 中结束索引（不包含 ）的整数。对于任何CaptureRange ，这些索引都必须满足不变量 [[StartIndex]] ≤ [[EndIndex]]。 -
MatchState 是
Record { [[Input]], [[EndIndex]], [[Captures]] }，其中 [[Input]] 是表示被匹配 String 的字符List ，[[EndIndex]] 是整数，[[Captures]] 是值的List ，对应模式中每个左捕获括号 各一个。MatchState 用于在正则表达式匹配算法中表示部分匹配状态。[[EndIndex]] 是目前为止由模式匹配到的最后一个输入字符索引加一，而 [[Captures]] 保存捕获括号的结果。[[Captures]] 的第 nth 个元素要么是表示第 nth 组捕获括号所捕获字符范围的CaptureRange ，要么是undefined ，如果第 nth 组捕获括号尚未到达。由于回溯，在匹配过程中任意时刻都可能使用许多MatchState 。 -
MatcherContinuation 是一个
Abstract Closure ，它接受一个MatchState 实参，并返回MatchState 或failure 。MatcherContinuation 会尝试从其MatchState 实参给定的中间状态开始，把模式剩余部分（由该 closure 的捕获值指定）与 input 进行匹配。如果匹配成功，MatcherContinuation 返回其到达的最终MatchState ；如果匹配失败，MatcherContinuation 返回failure 。 -
Matcher 是一个
Abstract Closure ，它接受两个实参——一个MatchState 和一个MatcherContinuation ——并返回MatchState 或failure 。Matcher 会尝试从其MatchState 实参给定的中间状态开始，把模式的中间子模式（由该 closure 的捕获值指定）与MatchState 的 [[Input]] 进行匹配。MatcherContinuation 实参应是匹配模式其余部分的 closure。在匹配模式的子模式以获得新的MatchState 后，Matcher 随后会在该新的MatchState 上调用MatcherContinuation ，以测试模式的其余部分是否也能匹配。如果可以，Matcher 返回MatcherContinuation 返回的MatchState ；如果不可以，Matcher 可以在其选择点尝试不同选择，反复调用MatcherContinuation ，直到成功或所有可能性都已耗尽。
22.2.2.1.1 RegExp Record
RegExp Record 是一种
它具有以下字段：
| 字段名 | 值 | 含义 |
|---|---|---|
| [[IgnoreCase]] | a Boolean | 指示 RegExp 的 flags 中是否出现 |
| [[Multiline]] | a Boolean | 指示 RegExp 的 flags 中是否出现 |
| [[DotAll]] | a Boolean | 指示 RegExp 的 flags 中是否出现 |
| [[Unicode]] | a Boolean | 指示 RegExp 的 flags 中是否出现 |
| [[UnicodeSets]] | a Boolean | 指示 RegExp 的 flags 中是否出现 |
| [[CapturingGroupsCount]] | a non-negative |
RegExp 模式中的 |
22.2.2.2 Runtime Semantics: CompilePattern
The syntax-directed operation CompilePattern takes argument regexpRecord (a
- 令 m 为以 regexpRecord 和
forward 为实参执行Disjunction 的CompileSubpattern 。 - 返回一个新的
Abstract Closure ，其参数为 (input, index)，捕获 regexpRecord 和 m，并在被调用时执行以下步骤：- 断言：input 是字符
List 。 - 断言：0 ≤ index ≤ input 中的元素数量。
- 令 c 为新的
MatcherContinuation ，其参数为 (y)，不捕获任何内容，并在被调用时执行以下步骤：- 断言：y 是
MatchState 。 - 返回 y。
- 断言：y 是
- 令 capability 为由 regexpRecord.[[CapturingGroupsCount]] 个
undefined 值组成的List ，索引从 1 到 regexpRecord.[[CapturingGroupsCount]]。 - 令 x 为
MatchState { [[Input]]: input, [[EndIndex]]: index, [[Captures]]: capability }。 - 返回 m(x, c)。
- 断言：input 是字符
Pattern 会编译为
22.2.2.3 Runtime Semantics: CompileSubpattern
The syntax-directed operation CompileSubpattern takes arguments regexpRecord (a
本节在
It is defined piecewise over the following productions:
- 令 m1 为以 regexpRecord 和 direction 为实参执行
Alternative 的CompileSubpattern 。 - 令 m2 为以 regexpRecord 和 direction 为实参执行
Disjunction 的CompileSubpattern 。 - 返回
MatchTwoAlternatives (m1, m2)。
| 正则表达式运算符分隔两个 alternatives。模式首先尝试匹配左侧 | 跳过的模式部分中的任何捕获括号都会产生
/a|ab/.exec("abc")返回结果
/((a)|(ab))((c)|(bc))/.exec("abc")返回数组
["abc", "a", "a", undefined, "bc", undefined, "bc"]而不是
["abc", "ab", undefined, "ab", "c", "c", undefined]尝试两个 alternatives 的顺序与 direction 的值无关。
- 返回
EmptyMatcher ()。
- 令 m1 为以 regexpRecord 和 direction 为实参执行
Alternative 的CompileSubpattern 。 - 令 m2 为以 regexpRecord 和 direction 为实参执行
Term 的CompileSubpattern 。 - 返回
MatchSequence (m1, m2, direction)。
连续的
- 返回以 regexpRecord 为实参执行
Assertion 的CompileAssertion 。
所得
- 返回以 regexpRecord 和 direction 为实参执行
Atom 的CompileAtom 。
- 令 m 为以 regexpRecord 和 direction 为实参执行
Atom 的CompileAtom 。 - 令 q 为
Quantifier 的CompileQuantifier 。 - 断言：q.[[Min]] ≤ q.[[Max]]。
- 令 parenIndex 为
CountLeftCapturingParensBefore (Term )。 - 令 parenCount 为
CountLeftCapturingParensWithin (Atom )。 - 返回一个新的
Matcher ，其参数为 (x, c)，捕获 m、q、parenIndex 和 parenCount，并在被调用时执行以下步骤：- 断言：x 是
MatchState 。 - 断言：c 是
MatcherContinuation 。 - 返回
RepeatMatcher (m, q.[[Min]], q.[[Max]], q.[[Greedy]], x, c, parenIndex, parenCount)。
- 断言：x 是
22.2.2.3.1 RepeatMatcher ( m, min, max, greedy, matchState, continue, parenIndex, parenCount )
The abstract operation RepeatMatcher takes arguments m (a
- 如果 max = 0，则返回 continue(matchState)。
- 令 d 为新的
MatcherContinuation ，其参数为 (y)，捕获 m、min、max、greedy、matchState、continue、parenIndex 和 parenCount，并在被调用时执行以下步骤：- 断言：y 是
MatchState 。 - 如果 min = 0 且 y.[[EndIndex]] = matchState.[[EndIndex]]，则返回
failure 。 - 如果 min = 0，则令 min2 为 0；否则令 min2 为 min - 1。
- 如果 max = +∞，则令 max2 为 +∞；否则令 max2 为 max - 1。
- 返回
RepeatMatcher (m, min2, max2, greedy, y, continue, parenIndex, parenCount)。
- 断言：y 是
- 令 capability 为 matchState.[[Captures]] 的副本。
- 对从 parenIndex + 1 到 parenIndex + parenCount 的
闭区间 内的每个整数 k，将 capability[k] 设置为undefined 。 - 令 input 为 matchState.[[Input]]。
- 令 e 为 matchState.[[EndIndex]]。
- 令 xr 为
MatchState { [[Input]]: input, [[EndIndex]]: e, [[Captures]]: capability }。 - 如果 min ≠ 0，则返回 m(xr, d)。
- 如果 greedy 是
false ，则- 令 z 为 continue(matchState)。
- 如果 z 不是
failure ，则返回 z。 - 返回 m(xr, d)。
- 令 z 为 m(xr, d)。
- 如果 z 不是
failure ，则返回 z。 - 返回 continue(matchState)。
后跟
如果
比较
/a[a-z]{2,4}/.exec("abcdefghi")其返回
/a[a-z]{2,4}?/.exec("abcdefghi")其返回
还可考虑
/(aa|aabaac|ba|b|c)*/.exec("aabaac")按照上述选择点顺序，它返回数组
["aaba", "ba"]而不是以下任一：
["aabaac", "aabaac"]
["aabaac", "c"]上述选择点顺序可用于编写一个计算两个数（以一元记法表示）最大公约数的正则表达式。以下示例计算 10 和 15 的 gcd：
"aaaaaaaaaa,aaaaaaaaaaaaaaa".replace(/^(a+)\1*,\1+$/, "$1")其返回一元记法的 gcd
22.2.2.3.2 EmptyMatcher ( )
The abstract operation EmptyMatcher takes no arguments and returns a
- 返回一个新的
Matcher ，其参数为 (matchState, continue)，不捕获任何内容，并在被调用时执行以下步骤：- 断言：matchState 是
MatchState 。 - 断言：continue 是
MatcherContinuation 。 - 返回 continue(matchState)。
- 断言：matchState 是
22.2.2.3.3 MatchTwoAlternatives ( m1, m2 )
The abstract operation MatchTwoAlternatives takes arguments m1 (a
- 返回一个新的
Matcher ，其参数为 (matchState, continue)，捕获 m1 和 m2，并在被调用时执行以下步骤：- 断言：matchState 是
MatchState 。 - 断言：continue 是
MatcherContinuation 。 - 令 result 为 m1(matchState, continue)。
- 如果 result 不是
failure ，则返回 result。 - 返回 m2(matchState, continue)。
- 断言：matchState 是
22.2.2.3.4 MatchSequence ( m1, m2, direction )
The abstract operation MatchSequence takes arguments m1 (a
- 如果 direction 是
forward ，则- 返回一个新的
Matcher ，其参数为 (matchState, continue)，捕获 m1 和 m2，并在被调用时执行以下步骤：- 断言：matchState 是
MatchState 。 - 断言：continue 是
MatcherContinuation 。 - 令 d 为新的
MatcherContinuation ，其参数为 (y)，捕获 continue 和 m2，并在被调用时执行以下步骤：- 断言：y 是
MatchState 。 - 返回 m2(y, continue)。
- 断言：y 是
- 返回 m1(matchState, d)。
- 断言：matchState 是
- 返回一个新的
- 断言：direction 是
backward 。 - 返回一个新的
Matcher ，其参数为 (matchState, continue)，捕获 m1 和 m2，并在被调用时执行以下步骤：- 断言：matchState 是
MatchState 。 - 断言：continue 是
MatcherContinuation 。 - 令 d 为新的
MatcherContinuation ，其参数为 (y)，捕获 continue 和 m1，并在被调用时执行以下步骤：- 断言：y 是
MatchState 。 - 返回 m1(y, continue)。
- 断言：y 是
- 返回 m2(matchState, d)。
- 断言：matchState 是
22.2.2.4 Runtime Semantics: CompileAssertion
The syntax-directed operation CompileAssertion takes argument regexpRecord (a
本节在
It is defined piecewise over the following productions:
- 返回一个新的
Matcher ，其参数为 (matchState, continue)，捕获 regexpRecord，并在被调用时执行以下步骤：- 断言：matchState 是
MatchState 。 - 断言：continue 是
MatcherContinuation 。 - 令 input 为 matchState.[[Input]]。
- 令 e 为 matchState.[[EndIndex]]。
- 如果 e = 0，或者如果 regexpRecord.[[Multiline]] 是
true 且字符 input[e - 1] 被LineTerminator 匹配，则- 返回 continue(matchState)。
- 返回
failure 。
- 断言：matchState 是
即使 y 标志与模式一起使用，^ 也始终只匹配 input 开头，或（如果 regexpRecord.[[Multiline]] 是
- 返回一个新的
Matcher ，其参数为 (matchState, continue)，捕获 regexpRecord，并在被调用时执行以下步骤：- 断言：matchState 是
MatchState 。 - 断言：continue 是
MatcherContinuation 。 - 令 input 为 matchState.[[Input]]。
- 令 e 为 matchState.[[EndIndex]]。
- 令 inputLength 为 input 中的元素数量。
- 如果 e = inputLength，或者如果 regexpRecord.[[Multiline]] 是
true 且字符 input[e] 被LineTerminator 匹配，则- 返回 continue(matchState)。
- 返回
failure 。
- 断言：matchState 是
- 返回一个新的
Matcher ，其参数为 (matchState, continue)，捕获 regexpRecord，并在被调用时执行以下步骤：- 断言：matchState 是
MatchState 。 - 断言：continue 是
MatcherContinuation 。 - 令 input 为 matchState.[[Input]]。
- 令 e 为 matchState.[[EndIndex]]。
- 令 a 为
IsWordChar (regexpRecord, input, e - 1)。 - 令 b 为
IsWordChar (regexpRecord, input, e)。 - 如果 a 是
true 且 b 是false ，或者如果 a 是false 且 b 是true ，则返回 continue(matchState)。 - 返回
failure 。
- 断言：matchState 是
- 返回一个新的
Matcher ，其参数为 (matchState, continue)，捕获 regexpRecord，并在被调用时执行以下步骤：- 断言：matchState 是
MatchState 。 - 断言：continue 是
MatcherContinuation 。 - 令 input 为 matchState.[[Input]]。
- 令 e 为 matchState.[[EndIndex]]。
- 令 a 为
IsWordChar (regexpRecord, input, e - 1)。 - 令 b 为
IsWordChar (regexpRecord, input, e)。 - 如果 a 是
true 且 b 是true ，或者如果 a 是false 且 b 是false ，则返回 continue(matchState)。 - 返回
failure 。
- 断言：matchState 是
- 令 m 为以 regexpRecord 和
forward 为实参执行Disjunction 的CompileSubpattern 。 - 返回一个新的
Matcher ，其参数为 (matchState, continue)，捕获 m，并在被调用时执行以下步骤：- 断言：matchState 是
MatchState 。 - 断言：continue 是
MatcherContinuation 。 - 令 d 为新的
MatcherContinuation ，其参数为 (y)，不捕获任何内容，并在被调用时执行以下步骤：- 断言：y 是
MatchState 。 - 返回 y。
- 断言：y 是
- 令 result 为 m(matchState, d)。
- 如果 result 是
failure ，则返回failure 。 - 断言：result 是
MatchState 。 - 令 capability 为 result.[[Captures]]。
- 令 input 为 matchState.[[Input]]。
- 令 xe 为 matchState.[[EndIndex]]。
- 令 z 为
MatchState { [[Input]]: input, [[EndIndex]]: xe, [[Captures]]: capability }。 - 返回 continue(z)。
- 断言：matchState 是
形式 (?= ) 指定零宽正向先行断言。为了使其成功，(?= 形式（这种不寻常行为继承自 Perl）。只有当
例如，
/(?=(a+))/.exec("baaabac")匹配第一个 b 后紧接的空 String，因此返回数组：
["", "aaa"]为说明不会回溯进入先行断言，请考虑：
/(?=(a+))a*b\1/.exec("baaabac")此表达式返回
["aba", "a"]而不是：
["aaaba", "a"]- 令 m 为以 regexpRecord 和
forward 为实参执行Disjunction 的CompileSubpattern 。 - 返回一个新的
Matcher ，其参数为 (matchState, continue)，捕获 m，并在被调用时执行以下步骤：- 断言：matchState 是
MatchState 。 - 断言：continue 是
MatcherContinuation 。 - 令 d 为新的
MatcherContinuation ，其参数为 (y)，不捕获任何内容，并在被调用时执行以下步骤：- 断言：y 是
MatchState 。 - 返回 y。
- 断言：y 是
- 令 result 为 m(matchState, d)。
- 如果 result 不是
failure ，则返回failure 。 - 返回 continue(matchState)。
- 断言：matchState 是
形式 (?! ) 指定零宽负向先行断言。为了使其成功，
/(.*?)a(?!(a+)b\2c)\2(.*)/.exec("baaabaac")会寻找一个 a，其后不紧跟某个正数 n 个 a、一个 b、另一个 n 个 a（由第一个 \2 指定）以及一个 c。第二个 \2 位于负向先行断言之外，因此它与
["baaabaac", "ba", undefined, "abaac"]- 令 m 为以 regexpRecord 和
backward 为实参执行Disjunction 的CompileSubpattern 。 - 返回一个新的
Matcher ，其参数为 (matchState, continue)，捕获 m，并在被调用时执行以下步骤：- 断言：matchState 是
MatchState 。 - 断言：continue 是
MatcherContinuation 。 - 令 d 为新的
MatcherContinuation ，其参数为 (y)，不捕获任何内容，并在被调用时执行以下步骤：- 断言：y 是
MatchState 。 - 返回 y。
- 断言：y 是
- 令 result 为 m(matchState, d)。
- 如果 result 是
failure ，则返回failure 。 - 断言：result 是
MatchState 。 - 令 capability 为 result.[[Captures]]。
- 令 input 为 matchState.[[Input]]。
- 令 xe 为 matchState.[[EndIndex]]。
- 令 z 为
MatchState { [[Input]]: input, [[EndIndex]]: xe, [[Captures]]: capability }。 - 返回 continue(z)。
- 断言：matchState 是
- 令 m 为以 regexpRecord 和
backward 为实参执行Disjunction 的CompileSubpattern 。 - 返回一个新的
Matcher ，其参数为 (matchState, continue)，捕获 m，并在被调用时执行以下步骤：- 断言：matchState 是
MatchState 。 - 断言：continue 是
MatcherContinuation 。 - 令 d 为新的
MatcherContinuation ，其参数为 (y)，不捕获任何内容，并在被调用时执行以下步骤：- 断言：y 是
MatchState 。 - 返回 y。
- 断言：y 是
- 令 result 为 m(matchState, d)。
- 如果 result 不是
failure ，则返回failure 。 - 返回 continue(matchState)。
- 断言：matchState 是
22.2.2.4.1 IsWordChar ( regexpRecord, input, e )
The abstract operation IsWordChar takes arguments regexpRecord (a
- 令 inputLength 为 input 中的元素数量。
- 如果 e = -1 或 e = inputLength，则返回
false 。 - 令 char 为字符 input[e]。
- 如果
WordCharacters (regexpRecord)包含 char，则返回true 。 - 返回
false 。
22.2.2.5 Runtime Semantics: CompileQuantifier
The syntax-directed operation CompileQuantifier takes no arguments and returns a
- 令 qp 为
QuantifierPrefix 的CompileQuantifierPrefix 。 - 返回
Record { [[Min]]: qp.[[Min]], [[Max]]: qp.[[Max]], [[Greedy]]:true }。
- 令 qp 为
QuantifierPrefix 的CompileQuantifierPrefix 。 - 返回
Record { [[Min]]: qp.[[Min]], [[Max]]: qp.[[Max]], [[Greedy]]:false }。
22.2.2.6 Runtime Semantics: CompileQuantifierPrefix
The syntax-directed operation CompileQuantifierPrefix takes no arguments and returns a
- 返回
Record { [[Min]]: 0, [[Max]]: +∞ }。
- 返回
Record { [[Min]]: 1, [[Max]]: +∞ }。
- 返回
Record { [[Min]]: 0, [[Max]]: 1 }。
- 令 i 为
DecimalDigits 的 MV（见12.9.3 ）。 - 返回
Record { [[Min]]: i, [[Max]]: i }。
- 令 i 为
DecimalDigits 的 MV。 - 返回
Record { [[Min]]: i, [[Max]]: +∞ }。
- 令 i 为第一个
DecimalDigits 的 MV。 - 令 j 为第二个
DecimalDigits 的 MV。 - 返回
Record { [[Min]]: i, [[Max]]: j }。
22.2.2.7 Runtime Semantics: CompileAtom
The syntax-directed operation CompileAtom takes arguments regexpRecord (a
本节在
It is defined piecewise over the following productions:
- 令 char 为
PatternCharacter 匹配的字符。 - 令 charSet 为
包含 字符 char 的单元素CharSet 。 - 返回
CharacterSetMatcher (regexpRecord, charSet,false , direction)。
- 令 charSet 为
AllCharacters (regexpRecord)。 - 如果 regexpRecord.[[DotAll]] 不是
true ，则- 从 charSet 中移除所有与
LineTerminator 产生式右侧码点对应的字符。
- 从 charSet 中移除所有与
- 返回
CharacterSetMatcher (regexpRecord, charSet,false , direction)。
- 令 cc 为以 regexpRecord 为实参执行
CharacterClass 的CompileCharacterClass 。 - 令 cs 为 cc.[[CharSet]]。
- 如果 regexpRecord.[[UnicodeSets]] 是
false ，或 cs 的每个CharSetElement 都由单个字符组成（包括 cs 为空的情况），则返回CharacterSetMatcher (regexpRecord, cs, cc.[[Invert]], direction)。 - 断言：cc.[[Invert]] 是
false 。 - 令 listOfMatchers 为空
Matcher List 。 - 对 cs 中
包含 多于 1 个字符的每个CharSetElement s，按长度降序迭代，执行：- 令 cs2 为
包含 s 最后一个码点的单元素CharSet 。 - 令 m2 为
CharacterSetMatcher (regexpRecord, cs2,false , direction)。 - 对 s 中每个码点 c1，从其倒数第二个码点开始向后迭代，执行：
- 令 cs1 为
包含 c1 的单元素CharSet 。 - 令 m1 为
CharacterSetMatcher (regexpRecord, cs1,false , direction)。 - 将 m2 设置为
MatchSequence (m1, m2, direction)。
- 令 cs1 为
- 将 m2 追加到 listOfMatchers。
- 令 cs2 为
- 令 singles 为
包含 cs 中所有由单个字符组成的CharSetElement 的CharSet 。 - 将
CharacterSetMatcher (regexpRecord, singles,false , direction) 追加到 listOfMatchers。 - 如果 cs
包含 空字符序列，则将EmptyMatcher () 追加到 listOfMatchers。 - 令 m2 为 listOfMatchers 中最后一个
Matcher 。 - 对 listOfMatchers 的每个
Matcher m1，从倒数第二个元素开始向后迭代，执行：- 将 m2 设置为
MatchTwoAlternatives (m1, m2)。
- 将 m2 设置为
- 返回 m2。
- 令 m 为以 regexpRecord 和 direction 为实参执行
Disjunction 的CompileSubpattern 。 - 令 parenIndex 为
CountLeftCapturingParensBefore (Atom )。 - 返回一个新的
Matcher ，其参数为 (x, c)，捕获 direction、m 和 parenIndex，并在被调用时执行以下步骤：- 断言：x 是
MatchState 。 - 断言：c 是
MatcherContinuation 。 - 令 d 为新的
MatcherContinuation ，其参数为 (y)，捕获 x、c、direction 和 parenIndex，并在被调用时执行以下步骤：- 断言：y 是
MatchState 。 - 令 capability 为 y.[[Captures]] 的副本。
- 令 input 为 x.[[Input]]。
- 令 xe 为 x.[[EndIndex]]。
- 令 ye 为 y.[[EndIndex]]。
- 如果 direction 是
forward ，则- 断言：xe ≤ ye。
- 令 r 为
CaptureRange { [[StartIndex]]: xe, [[EndIndex]]: ye }。
- 否则，
- 断言：direction 是
backward 。 - 断言：ye ≤ xe。
- 令 r 为
CaptureRange { [[StartIndex]]: ye, [[EndIndex]]: xe }。
- 断言：direction 是
- 将 capability[parenIndex + 1] 设置为 r。
- 令 z 为
MatchState { [[Input]]: input, [[EndIndex]]: ye, [[Captures]]: capability }。 - 返回 c(z)。
- 断言：y 是
- 返回 m(x, d)。
- 断言：x 是
形式为 ( ) 的括号既用于把 \ 后跟非零十进制数）、在替换 String 中被引用，或作为从正则表达式匹配 (?: )。
- 令 addModifiers 为
RegularExpressionModifiers 匹配的源文本 。 - 令 removeModifiers 为空 String。
- 令 modifiedRer 为
UpdateModifiers (regexpRecord,CodePointsToString (addModifiers), removeModifiers)。 - 返回以 modifiedRer 和 direction 为实参执行
Disjunction 的CompileSubpattern 。
- 令 addModifiers 为第一个
RegularExpressionModifiers 匹配的源文本 。 - 令 removeModifiers 为第二个
RegularExpressionModifiers 匹配的源文本 。 - 令 modifiedRer 为
UpdateModifiers (regexpRecord,CodePointsToString (addModifiers),CodePointsToString (removeModifiers))。 - 返回以 modifiedRer 和 direction 为实参执行
Disjunction 的CompileSubpattern 。
- 令 n 为
DecimalEscape 的CapturingGroupNumber 。 - 断言：n ≤ regexpRecord.[[CapturingGroupsCount]]。
- 返回
BackreferenceMatcher (regexpRecord, « n », direction)。
形式为 \ 后跟非零十进制数 n 的转义序列，会匹配第 nth 组捕获括号的结果（
- 令 charValue 为
CharacterEscape 的CharacterValue 。 - 令 char 为其字符值为 charValue 的字符。
- 令 charSet 为
包含 字符 char 的单元素CharSet 。 - 返回
CharacterSetMatcher (regexpRecord, charSet,false , direction)。
- 令 cs 为以 regexpRecord 为实参执行
CharacterClassEscape 的CompileToCharSet 。 - 如果 regexpRecord.[[UnicodeSets]] 是
false ，或 cs 的每个CharSetElement 都由单个字符组成（包括 cs 为空的情况），则返回CharacterSetMatcher (regexpRecord, cs,false , direction)。 - 令 listOfMatchers 为空
Matcher List 。 - 对 cs 中
包含 多于 1 个字符的每个CharSetElement s，按长度降序迭代，执行：- 令 cs2 为
包含 s 最后一个码点的单元素CharSet 。 - 令 m2 为
CharacterSetMatcher (regexpRecord, cs2,false , direction)。 - 对 s 中每个码点 c1，从其倒数第二个码点开始向后迭代，执行：
- 令 cs1 为
包含 c1 的单元素CharSet 。 - 令 m1 为
CharacterSetMatcher (regexpRecord, cs1,false , direction)。 - 将 m2 设置为
MatchSequence (m1, m2, direction)。
- 令 cs1 为
- 将 m2 追加到 listOfMatchers。
- 令 cs2 为
- 令 singles 为
包含 cs 中所有由单个字符组成的CharSetElement 的CharSet 。 - 将
CharacterSetMatcher (regexpRecord, singles,false , direction) 追加到 listOfMatchers。 - 如果 cs
包含 空字符序列，则将EmptyMatcher () 追加到 listOfMatchers。 - 令 m2 为 listOfMatchers 中最后一个
Matcher 。 - 对 listOfMatchers 的每个
Matcher m1，从倒数第二个元素开始向后迭代，执行：- 将 m2 设置为
MatchTwoAlternatives (m1, m2)。
- 将 m2 设置为
- 返回 m2。
- 令 matchingGroupSpecifiers 为
GroupSpecifiersThatMatch (GroupName )。 - 令 parenIndices 为新的空
List 。 - 对 matchingGroupSpecifiers 的每个
GroupSpecifier groupSpecifier，执行：- 令 parenIndex 为
CountLeftCapturingParensBefore (groupSpecifier)。 - 将 parenIndex 追加到 parenIndices。
- 令 parenIndex 为
- 返回
BackreferenceMatcher (regexpRecord, parenIndices, direction)。
22.2.2.7.1 CharacterSetMatcher ( regexpRecord, charSet, invert, direction )
The abstract operation CharacterSetMatcher takes arguments regexpRecord (a
- 如果 regexpRecord.[[UnicodeSets]] 是
true ，则- 断言：invert 是
false 。 - 断言：charSet 的每个
CharSetElement 都由单个字符组成。
- 断言：invert 是
- 返回一个新的
Matcher ，其参数为 (x, c)，捕获 regexpRecord、charSet、invert 和 direction，并在被调用时执行以下步骤：- 断言：x 是
MatchState 。 - 断言：c 是
MatcherContinuation 。 - 令 input 为 x.[[Input]]。
- 令 endIndex 为 x.[[EndIndex]]。
- 如果 direction 是
forward ，则令 f 为 endIndex + 1。 - 否则，令 f 为 endIndex - 1。
- 令 inputLength 为 input 中的元素数量。
- 如果 f < 0 或 f > inputLength，则返回
failure 。 - 令 index 为
min (endIndex, f)。 - 令 char 为字符 input[index]。
- 令 cc 为
Canonicalize (regexpRecord, char)。 - 如果 charSet 中存在一个
CharSetElement ，它恰好包含 一个字符 a，并且Canonicalize (regexpRecord, a) 是 cc，则令 found 为true ；否则令 found 为false 。 - 如果 invert 是
false 且 found 是false ，则返回failure 。 - 如果 invert 是
true 且 found 是true ，则返回failure 。 - 令 capability 为 x.[[Captures]]。
- 令 y 为
MatchState { [[Input]]: input, [[EndIndex]]: f, [[Captures]]: capability }。 - 返回 c(y)。
- 断言：x 是
22.2.2.7.2 BackreferenceMatcher ( regexpRecord, ns, direction )
The abstract operation BackreferenceMatcher takes arguments regexpRecord (a
- 返回一个新的
Matcher ，其参数为 (x, c)，捕获 regexpRecord、ns 和 direction，并在被调用时执行以下步骤：- 断言：x 是
MatchState 。 - 断言：c 是
MatcherContinuation 。 - 令 input 为 x.[[Input]]。
- 令 capability 为 x.[[Captures]]。
- 令 r 为
undefined 。 - 对 ns 的每个整数 n，执行：
- 如果 capability[n] 不是
undefined ，则- 断言：r 是
undefined 。 - 将 r 设置为 capability[n]。
- 断言：r 是
- 如果 capability[n] 不是
- 如果 r 是
undefined ，则返回 c(x)。 - 令 endIndex 为 x.[[EndIndex]]。
- 令 rs 为 r.[[StartIndex]]。
- 令 re 为 r.[[EndIndex]]。
- 令 length 为 re - rs。
- 如果 direction 是
forward ，则令 f 为 endIndex + length。 - 否则，令 f 为 endIndex - length。
- 令 inputLength 为 input 中的元素数量。
- 如果 f < 0 或 f > inputLength，则返回
failure 。 - 令 g 为
min (endIndex, f)。 - 如果存在从 0（
包含 ）到 length（不包含 ）区间 内的整数 i，使得Canonicalize (regexpRecord, input[rs + i]) 不是Canonicalize (regexpRecord, input[g + i])，则返回failure 。 - 令 y 为
MatchState { [[Input]]: input, [[EndIndex]]: f, [[Captures]]: capability }。 - 返回 c(y)。
- 断言：x 是
22.2.2.7.3 Canonicalize ( regexpRecord, char )
The abstract operation Canonicalize takes arguments regexpRecord (a
- 如果
HasEitherUnicodeFlag (regexpRecord) 是true 且 regexpRecord.[[IgnoreCase]] 是true ，则- 如果 Unicode Character Database 的文件
CaseFolding.txt为 char 提供 simple 或 common case folding 映射，则返回把该映射应用于 char 的结果。 - 返回 char。
- 如果 Unicode Character Database 的文件
- 如果 regexpRecord.[[IgnoreCase]] 是
false ，则返回 char。 - 断言：char 是 UTF-16 码元。
- 令 codePoint 为其数值为 char 的数值的码点。
- 令 u 为依据 Unicode Default Case Conversion 算法的 toUppercase(« codePoint »)。
- 令 uString 为
CodePointsToString (u)。 - 如果 uString 的长度 ≠ 1，则返回 char。
- 令 codeUnit 为 uString 的单个码元元素。
- 如果 char 的数值 ≥ 128 且 codeUnit 的数值 < 128，则返回 char。
- 返回 codeUnit。
在 ß（U+00DF LATIN SMALL LETTER SHARP S）映射为 ss 或 SS。不过，它可能把 Basic Latin 块之外的码点映射到其中的码点——例如，ſ（U+017F LATIN SMALL LETTER LONG S）会 case-fold 为 s（U+0073 LATIN SMALL LETTER S），而 K（U+212A KELVIN SIGN）会 case-fold 为 k（U+006B LATIN SMALL LETTER K）。/[a-z]/ui 的正则表达式匹配。
在 Ω（U+2126 OHM SIGN）会被 toUppercase 映射为其自身，但会被 toCasefold 映射为 ω（U+03C9 GREEK SMALL LETTER OMEGA），同时 Ω（U+03A9 GREEK CAPITAL LETTER OMEGA）也是如此，因此 /[ω]/ui 和 /[\u03A9]/ui 匹配，但不会被 /[ω]/i 或 /[\u03A9]/i 匹配。此外，Basic Latin 块之外的码点不会被映射到其中的码点，因此诸如 /[a-z]/i 匹配。
22.2.2.7.4 UpdateModifiers ( regexpRecord, add, remove )
The abstract operation UpdateModifiers takes arguments regexpRecord (a
- 断言：add 和 remove 没有共同元素。
- 令 ignoreCase 为 regexpRecord.[[IgnoreCase]]。
- 令 multiline 为 regexpRecord.[[Multiline]]。
- 令 dotAll 为 regexpRecord.[[DotAll]]。
- 令 unicode 为 regexpRecord.[[Unicode]]。
- 令 unicodeSets 为 regexpRecord.[[UnicodeSets]]。
- 令 capturingGroupsCount 为 regexpRecord.[[CapturingGroupsCount]]。
- 如果 remove
包含 "i" ，则将 ignoreCase 设置为false 。 - 否则，如果 add
包含 "i" ，则将 ignoreCase 设置为true 。 - 如果 remove
包含 "m" ，则将 multiline 设置为false 。 - 否则，如果 add
包含 "m" ，则将 multiline 设置为true 。 - 如果 remove
包含 "s" ，则将 dotAll 设置为false 。 - 否则，如果 add
包含 "s" ，则将 dotAll 设置为true 。 - 返回
RegExp Record { [[IgnoreCase]]: ignoreCase, [[Multiline]]: multiline, [[DotAll]]: dotAll, [[Unicode]]: unicode, [[UnicodeSets]]: unicodeSets, [[CapturingGroupsCount]]: capturingGroupsCount }。
22.2.2.8 Runtime Semantics: CompileCharacterClass
The syntax-directed operation CompileCharacterClass takes argument regexpRecord (a
- 令 charSet 为以 regexpRecord 为实参执行
ClassContents 的CompileToCharSet 。 - 返回
Record { [[CharSet]]: charSet, [[Invert]]:false }。
- 令 charSet 为以 regexpRecord 为实参执行
ClassContents 的CompileToCharSet 。 - 如果 regexpRecord.[[UnicodeSets]] 是
true ，则- 返回
Record { [[CharSet]]:CharacterComplement (regexpRecord, charSet), [[Invert]]:false }。
- 返回
- 返回
Record { [[CharSet]]: charSet, [[Invert]]:true }。
22.2.2.9 Runtime Semantics: CompileToCharSet
The syntax-directed operation CompileToCharSet takes argument regexpRecord (a
本节在
It is defined piecewise over the following productions:
- 返回空
CharSet 。
- 令 charSet 为以 regexpRecord 为实参执行
ClassAtom 的CompileToCharSet 。 - 令 otherSet 为以 regexpRecord 为实参执行
NonemptyClassRangesNoDash 的CompileToCharSet 。 - 返回
CharSet charSet 和 otherSet 的并集。
- 令 charSet 为以 regexpRecord 为实参执行第一个
ClassAtom 的CompileToCharSet 。 - 令 otherSet 为以 regexpRecord 为实参执行第二个
ClassAtom 的CompileToCharSet 。 - 令 remainingSet 为以 regexpRecord 为实参执行
ClassContents 的CompileToCharSet 。 - 令 rangeSet 为
CharacterRange (charSet, otherSet)。 - 返回 rangeSet 和 remainingSet 的并集。
- 令 charSet 为以 regexpRecord 为实参执行
ClassAtomNoDash 的CompileToCharSet 。 - 令 otherSet 为以 regexpRecord 为实参执行
NonemptyClassRangesNoDash 的CompileToCharSet 。 - 返回
CharSet charSet 和 otherSet 的并集。
- 令 charSet 为以 regexpRecord 为实参执行
ClassAtomNoDash 的CompileToCharSet 。 - 令 otherSet 为以 regexpRecord 为实参执行
ClassAtom 的CompileToCharSet 。 - 令 remainingSet 为以 regexpRecord 为实参执行
ClassContents 的CompileToCharSet 。 - 令 rangeSet 为
CharacterRange (charSet, otherSet)。 - 返回 rangeSet 和 remainingSet 的并集。
即使模式忽略大小写，范围两端的大小写对于确定哪些字符属于该范围也是重要的。因此，例如，模式 /[E-F]/i 只匹配字母 E、F、e 和 f，而模式 /[E-f]/i 会匹配 Unicode Basic Latin 块中的所有大写和小写字母，以及符号 [, \, ], ^, _ 和 `。
- 字符可以被按字面处理，也可以表示一个范围。如果它是
- 返回
包含 SourceCharacter 匹配的字符的CharSet 。
- 令 charValue 为此
ClassEscape 的CharacterValue 。 - 令 char 为其字符值为 charValue 的字符。
- 返回
包含 单个字符 char 的CharSet 。
\b、\B 和反向引用除外。在 \b 表示退格字符，而 \B 和反向引用会引发错误。在
- 令 charSet 为
CharacterClassEscape :: d CharSet 。 - 返回
CharacterComplement (regexpRecord, charSet)。
- 返回
包含 与WhiteSpace 或LineTerminator 产生式右侧码点对应的所有字符的CharSet 。
- 令 charSet 为
CharacterClassEscape :: s CharSet 。 - 返回
CharacterComplement (regexpRecord, charSet)。
- 返回
MaybeSimpleCaseFolding (regexpRecord,WordCharacters (regexpRecord))。
- 令 charSet 为
CharacterClassEscape :: w CharSet 。 - 返回
CharacterComplement (regexpRecord, charSet)。
- 返回以 regexpRecord 为实参执行
UnicodePropertyValueExpression 的CompileToCharSet 。
- 令 charSet 为以 regexpRecord 为实参执行
UnicodePropertyValueExpression 的CompileToCharSet 。 - 断言：charSet 只
包含 单个码点。 - 返回
CharacterComplement (regexpRecord, charSet)。
- 令 ps 为
UnicodePropertyName 匹配的源文本 。 - 令 p 为
UnicodeMatchProperty (regexpRecord, ps)。 - 断言：p 是
Table 65 的 “Property name and aliases ” 列中列出的Unicode 属性名 或属性别名。 - 令 vs 为
UnicodePropertyValue 匹配的源文本 。 - 令 v 为
UnicodeMatchPropertyValue (p, vs)。 - 令 charSet 为
包含 所有 Unicode 码点的CharSet ，这些码点的字符数据库定义包含 值为 v 的属性 p。 - 返回
MaybeSimpleCaseFolding (regexpRecord, charSet)。
- 令 s 为
LoneUnicodePropertyNameOrValue 匹配的源文本 。 - 如果
UnicodeMatchPropertyValue (General_Category, s) 是PropertyValueAliases.txt中列出的 General_Category (gc) 属性的 Unicode 属性值或属性值别名，则 - 令 p 为
UnicodeMatchProperty (regexpRecord, s)。 - 断言：p 是
Table 66 的 “Property name and aliases ” 列中列出的二元 Unicode 属性或二元属性别名，或是Table 67 的 “Property name ” 列中列出的字符串二元 Unicode 属性。 - 令 charSet 为
包含 所有CharSetElement 的CharSet ，这些元素的字符数据库定义包含 值为 “True” 的属性 p。 - 返回
MaybeSimpleCaseFolding (regexpRecord, charSet)。
- 令 charSet 为以 regexpRecord 为实参执行
ClassSetRange 的CompileToCharSet 。 - 如果
ClassUnion 存在，则- 令 otherSet 为以 regexpRecord 为实参执行
ClassUnion 的CompileToCharSet 。 - 返回
CharSet charSet 和 otherSet 的并集。
- 令 otherSet 为以 regexpRecord 为实参执行
- 返回 charSet。
- 令 charSet 为以 regexpRecord 为实参执行
ClassSetOperand 的CompileToCharSet 。 - 如果
ClassUnion 存在，则- 令 otherSet 为以 regexpRecord 为实参执行
ClassUnion 的CompileToCharSet 。 - 返回
CharSet charSet 和 otherSet 的并集。
- 令 otherSet 为以 regexpRecord 为实参执行
- 返回 charSet。
- 令 charSet 为以 regexpRecord 为实参执行第一个
ClassSetOperand 的CompileToCharSet 。 - 令 otherSet 为以 regexpRecord 为实参执行第二个
ClassSetOperand 的CompileToCharSet 。 - 返回
CharSet charSet 和 otherSet 的交集。
- 令 charSet 为以 regexpRecord 为实参执行
ClassIntersection 的CompileToCharSet 。 - 令 otherSet 为以 regexpRecord 为实参执行
ClassSetOperand 的CompileToCharSet 。 - 返回
CharSet charSet 和 otherSet 的交集。
- 令 charSet 为以 regexpRecord 为实参执行第一个
ClassSetOperand 的CompileToCharSet 。 - 令 otherSet 为以 regexpRecord 为实参执行第二个
ClassSetOperand 的CompileToCharSet 。 - 返回
包含 charSet 中不是 otherSet 的CharSetElement 的那些CharSetElement 的CharSet 。
- 令 charSet 为以 regexpRecord 为实参执行
ClassSubtraction 的CompileToCharSet 。 - 令 otherSet 为以 regexpRecord 为实参执行
ClassSetOperand 的CompileToCharSet 。 - 返回
包含 charSet 中不是 otherSet 的CharSetElement 的那些CharSetElement 的CharSet 。
- 令 charSet 为以 regexpRecord 为实参执行第一个
ClassSetCharacter 的CompileToCharSet 。 - 令 otherSet 为以 regexpRecord 为实参执行第二个
ClassSetCharacter 的CompileToCharSet 。 - 返回
MaybeSimpleCaseFolding (regexpRecord,CharacterRange (charSet, otherSet))。
结果通常会由两个或更多范围组成。当 UnicodeSets 是
- 令 charSet 为以 regexpRecord 为实参执行
ClassSetCharacter 的CompileToCharSet 。 - 返回
MaybeSimpleCaseFolding (regexpRecord, charSet)。
- 令 charSet 为以 regexpRecord 为实参执行
ClassStringDisjunction 的CompileToCharSet 。 - 返回
MaybeSimpleCaseFolding (regexpRecord, charSet)。
- 返回以 regexpRecord 为实参执行
NestedClass 的CompileToCharSet 。
- 返回以 regexpRecord 为实参执行
ClassContents 的CompileToCharSet 。
- 令 charSet 为以 regexpRecord 为实参执行
ClassContents 的CompileToCharSet 。 - 返回
CharacterComplement (regexpRecord, charSet)。
- 返回以 regexpRecord 为实参执行
CharacterClassEscape 的CompileToCharSet 。
- 返回以 regexpRecord 为实参执行
ClassStringDisjunctionContents 的CompileToCharSet 。
- 令 s 为以 regexpRecord 为实参执行
ClassString 的CompileClassSetString 。 - 返回
包含 一个字符串 s 的CharSet 。
- 令 s 为以 regexpRecord 为实参执行
ClassString 的CompileClassSetString 。 - 令 charSet 为
包含 一个字符串 s 的CharSet 。 - 令 otherSet 为以 regexpRecord 为实参执行
ClassStringDisjunctionContents 的CompileToCharSet 。 - 返回
CharSet charSet 和 otherSet 的并集。
- 令 charValue 为此
ClassSetCharacter 的CharacterValue 。 - 令 char 为其字符值为 charValue 的字符。
- 返回
包含 单个字符 char 的CharSet 。
22.2.2.9.1 CharacterRange ( charSet, otherSet )
The abstract operation CharacterRange takes arguments charSet (a
22.2.2.9.2 HasEitherUnicodeFlag ( regexpRecord )
The abstract operation HasEitherUnicodeFlag takes argument regexpRecord (a
- 如果 regexpRecord.[[Unicode]] 是
true 或 regexpRecord.[[UnicodeSets]] 是true ，则返回true 。 - 返回
false 。
22.2.2.9.3 WordCharacters ( regexpRecord )
The abstract operation WordCharacters takes argument regexpRecord (a \b、\B、\w 和 \W 的目的而被视为“word characters”的字符。 It performs the following steps when called:
- 令 basicWordChars 为
包含 ASCII word characters 中每个字符的CharSet 。 - 令 extraWordChars 为
包含 所有字符 c 的CharSet ，使得 c 不在 basicWordChars 中但Canonicalize (regexpRecord, c) 在 basicWordChars 中。 - 断言：除非
HasEitherUnicodeFlag (regexpRecord) 是true 且 regexpRecord.[[IgnoreCase]] 是true ，否则 extraWordChars 为空。 - 返回 basicWordChars 和 extraWordChars 的并集。
22.2.2.9.4 AllCharacters ( regexpRecord )
The abstract operation AllCharacters takes argument regexpRecord (a
- 如果 regexpRecord.[[UnicodeSets]] 是
true 且 regexpRecord.[[IgnoreCase]] 是true ，则- 返回
包含 所有没有 Simple Case Folding 映射（即scf (c)=c）的 Unicode 码点 c 的CharSet 。
- 返回
- 如果
HasEitherUnicodeFlag (regexpRecord) 是true ，则 - 返回
包含 所有码元值的CharSet 。
22.2.2.9.5 MaybeSimpleCaseFolding ( regexpRecord, charSet )
The abstract operation MaybeSimpleCaseFolding takes arguments regexpRecord (a CaseFolding.txt 中的 Simple Case Folding（
- 如果 regexpRecord.[[UnicodeSets]] 是
false 或 regexpRecord.[[IgnoreCase]] 是false ，则返回 charSet。 - 令 otherSet 为新的空
CharSet 。 - 对 charSet 的每个
CharSetElement s，执行：- 令 t 为空字符序列。
- 对 s 中的每个单一码点 codePoint，执行：
- 将
scf (codePoint) 追加到 t。
- 将
- 将 t 添加到 otherSet。
- 返回 otherSet。
22.2.2.9.6 CharacterComplement ( regexpRecord, complement )
The abstract operation CharacterComplement takes arguments regexpRecord (a
- 令 charSet 为
AllCharacters (regexpRecord)。 - 返回
包含 charSet 中不是 complement 的CharSetElement 的那些CharSetElement 的CharSet 。
22.2.2.9.7 UnicodeMatchProperty ( regexpRecord, p )
The abstract operation UnicodeMatchProperty takes arguments regexpRecord (a
实现必须支持
例如，Script_Extensions（scx（属性别名）是有效的，但 script_extensions 或 Scx 不是。
所列属性形成了 UTS18 RL1.2 所要求内容的超集。
这些表中条目的拼写（包括大小写）与 Unicode Character Database 文件 PropertyAliases.txt 中使用的拼写一致。该文件中的精确拼写保证稳定。
General_Category |
General_Category |
gc |
|
Script |
Script |
sc |
|
Script_Extensions |
Script_Extensions |
scx |
ASCII |
ASCII |
ASCII_Hex_Digit |
ASCII_Hex_Digit |
AHex |
|
Alphabetic |
Alphabetic |
Alpha |
|
Any |
Any |
Assigned |
Assigned |
Bidi_Control |
Bidi_Control |
Bidi_C |
|
Bidi_Mirrored |
Bidi_Mirrored |
Bidi_M |
|
Case_Ignorable |
Case_Ignorable |
CI |
|
Cased |
Cased |
Changes_When_Casefolded |
Changes_When_Casefolded |
CWCF |
|
Changes_When_Casemapped |
Changes_When_Casemapped |
CWCM |
|
Changes_When_Lowercased |
Changes_When_Lowercased |
CWL |
|
Changes_When_NFKC_Casefolded |
Changes_When_NFKC_Casefolded |
CWKCF |
|
Changes_When_Titlecased |
Changes_When_Titlecased |
CWT |
|
Changes_When_Uppercased |
Changes_When_Uppercased |
CWU |
|
Dash |
Dash |
Default_Ignorable_Code_Point |
Default_Ignorable_Code_Point |
DI |
|
Deprecated |
Deprecated |
Dep |
|
Diacritic |
Diacritic |
Dia |
|
Emoji |
Emoji |
Emoji_Component |
Emoji_Component |
EComp |
|
Emoji_Modifier |
Emoji_Modifier |
EMod |
|
Emoji_Modifier_Base |
Emoji_Modifier_Base |
EBase |
|
Emoji_Presentation |
Emoji_Presentation |
EPres |
|
Extended_Pictographic |
Extended_Pictographic |
ExtPict |
|
Extender |
Extender |
Ext |
|
Grapheme_Base |
Grapheme_Base |
Gr_Base |
|
Grapheme_Extend |
Grapheme_Extend |
Gr_Ext |
|
Hex_Digit |
Hex_Digit |
Hex |
|
IDS_Binary_Operator |
IDS_Binary_Operator |
IDSB |
|
IDS_Trinary_Operator |
IDS_Trinary_Operator |
IDST |
|
ID_Continue |
ID_Continue |
IDC |
|
ID_Start |
ID_Start |
IDS |
|
Ideographic |
Ideographic |
Ideo |
|
Join_Control |
Join_Control |
Join_C |
|
Logical_Order_Exception |
Logical_Order_Exception |
LOE |
|
Lowercase |
Lowercase |
Lower |
|
Math |
Math |
Noncharacter_Code_Point |
Noncharacter_Code_Point |
NChar |
|
Pattern_Syntax |
Pattern_Syntax |
Pat_Syn |
|
Pattern_White_Space |
Pattern_White_Space |
Pat_WS |
|
Quotation_Mark |
Quotation_Mark |
QMark |
|
Radical |
Radical |
Regional_Indicator |
Regional_Indicator |
RI |
|
Sentence_Terminal |
Sentence_Terminal |
STerm |
|
Soft_Dotted |
Soft_Dotted |
SD |
|
Terminal_Punctuation |
Terminal_Punctuation |
Term |
|
Unified_Ideograph |
Unified_Ideograph |
UIdeo |
|
Uppercase |
Uppercase |
Upper |
|
Variation_Selector |
Variation_Selector |
VS |
|
White_Space |
White_Space |
space |
|
XID_Continue |
XID_Continue |
XIDC |
|
XID_Start |
XID_Start |
XIDS |
Basic_Emoji |
Emoji_Keycap_Sequence |
RGI_Emoji_Modifier_Sequence |
RGI_Emoji_Flag_Sequence |
RGI_Emoji_Tag_Sequence |
RGI_Emoji_ZWJ_Sequence |
RGI_Emoji |
22.2.2.9.8 UnicodeMatchPropertyValue ( p, v )
The abstract operation UnicodeMatchPropertyValue takes arguments p (
- 断言：p 是
Table 65 的 “Canonical property name ” 列中列出的规范、非别名Unicode property name 。 - 断言：v 是
PropertyValueAliases.txt中列出的 Unicode 属性 p 的属性值或属性值别名。 - 令 value 为对应行的 “Canonical property value” 列中给出的 v 的规范属性值。
- 返回 Unicode 码点
List value。
实现必须支持 PropertyValueAliases.txt 中针对
例如，Xpeo 和 Old_Persian 是有效的 Script_Extensions 值，但 xpeo 和 Old Persian 不是。
此算法不同于 UAX44 中列出的符号值匹配规则：大小写、Is 前缀。
22.2.2.10 Runtime Semantics: CompileClassSetString
The syntax-directed operation CompileClassSetString takes argument regexpRecord (a
- 返回空字符序列。
- 返回以 regexpRecord 为实参执行
NonEmptyClassString 的CompileClassSetString 。
- 令 cs 为以 regexpRecord 为实参执行
ClassSetCharacter 的CompileToCharSet 。 - 令 s1 为字符序列，它是 cs 中的单个
CharSetElement 。 - 如果
NonEmptyClassString 存在，则- 令 s2 为以 regexpRecord 为实参执行
NonEmptyClassString 的CompileClassSetString 。 - 返回 s1 和 s2 的连接。
- 令 s2 为以 regexpRecord 为实参执行
- 返回 s1。
22.2.3 RegExp 创建的抽象操作
22.2.3.1 RegExpCreate ( pattern, flags )
The abstract operation RegExpCreate takes arguments pattern (an ECMAScript language value) and flags (a String or
- 令 obj 为 !
RegExpAlloc (%RegExp% )。 - 返回 ?
RegExpInitialize (obj, pattern, flags)。
22.2.3.2 RegExpAlloc ( newTarget )
The abstract operation RegExpAlloc takes argument newTarget (a constructor) and returns either a normal completion containing an Object or a throw completion. It performs the following steps when called:
- 令 obj 为 ?
OrdinaryCreateFromConstructor (newTarget,"%RegExp.prototype%" , « [[OriginalSource]], [[OriginalFlags]], [[RegExpRecord]], [[RegExpMatcher]] »)。 - 执行 !
DefinePropertyOrThrow (obj,"lastIndex" , PropertyDescriptor { [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 obj。
22.2.3.3 RegExpInitialize ( obj, pattern, flags )
The abstract operation RegExpInitialize takes arguments obj (an Object), pattern (an ECMAScript language value), and flags (an ECMAScript language value) and returns either a normal completion containing an Object or a throw completion. It performs the following steps when called:
- 如果 pattern 是
undefined ，则将 pattern 设置为空 String。 - 否则，将 pattern 设置为 ?
ToString (pattern)。 - 如果 flags 是
undefined ，则将 flags 设置为空 String。 - 否则，将 flags 设置为 ?
ToString (flags)。 - 如果 flags
包含 除"d" 、"g" 、"i" 、"m" 、"s" 、"u" 、"v" 或"y" 之外的任何码元，则抛出SyntaxError 异常。 - 如果 flags
包含 任何码元超过一次，则抛出SyntaxError 异常。 - 如果 flags
包含 "i" ，则令 i 为true ；否则令 i 为false 。 - 如果 flags
包含 "m" ，则令 m 为true ；否则令 m 为false 。 - 如果 flags
包含 "s" ，则令 s 为true ；否则令 s 为false 。 - 如果 flags
包含 "u" ，则令 u 为true ；否则令 u 为false 。 - 如果 flags
包含 "v" ，则令 v 为true ；否则令 v 为false 。 - 如果 u 是
true 或 v 是true ，则- 令 patternText 为
StringToCodePoints (pattern)。
- 令 patternText 为
- 否则，
- 令 patternText 为将 pattern 的每个 16 位元素解释为 Unicode BMP 码点的结果。不会对这些元素应用 UTF-16 解码。
- 令 parseResult 为
ParsePattern (patternText, u, v)。 - 如果 parseResult 是非空的
SyntaxError 对象List ，则抛出SyntaxError 异常。 - 断言：parseResult 是
Pattern Parse Node 。 - 将 obj.[[OriginalSource]] 设置为 pattern。
- 将 obj.[[OriginalFlags]] 设置为 flags。
- 令 capturingGroupsCount 为
CountLeftCapturingParensWithin (parseResult)。 - 令 regexpRecord 为
RegExp Record { [[IgnoreCase]]: i, [[Multiline]]: m, [[DotAll]]: s, [[Unicode]]: u, [[UnicodeSets]]: v, [[CapturingGroupsCount]]: capturingGroupsCount }。 - 将 obj.[[RegExpRecord]] 设置为 regexpRecord。
- 将 obj.[[RegExpMatcher]] 设置为以 regexpRecord 为实参执行 parseResult 的
CompilePattern 。 - 执行 ?
Set (obj,"lastIndex" ,+0 𝔽,true )。 - 返回 obj。
22.2.3.4 Static Semantics: ParsePattern ( patternText, u, v )
The abstract operation ParsePattern takes arguments patternText (a sequence of Unicode code points), u (a Boolean), and v (a Boolean) and returns a
本节在
It performs the following steps when called:
- 如果 v 是
true 且 u 是true ，则 - 否则，如果 v 是
true ，则 - 否则，如果 u 是
true ，则 - 否则，
- 返回 parseResult。
22.2.4 RegExp 构造器
RegExp 构造器：
- 是 %RegExp%。
- 是
全局对象 的"RegExp" 属性的初始值。 - 在作为构造器调用时创建并初始化一个新的 RegExp 对象。
- 在作为函数而非构造器调用时，返回一个新的 RegExp 对象，或者如果唯一实参是 RegExp 对象，则返回该实参自身。
- 可以用作类定义的
extends子句的值。意图继承指定 RegExp 行为的子类构造器必须包含 对 RegExp 构造器的super调用，以创建并初始化具有必要内部槽的子类实例。
22.2.4.1 RegExp ( patternOrRegexp, flags )
此函数在被调用时执行以下步骤：
- 令 patternIsRegExp 为 ?
IsRegExp (patternOrRegexp)。 - 如果 NewTarget 是
undefined ，则 - 否则，
- 令 newTarget 为 NewTarget。
- 如果 patternOrRegexp 是 Object 且 patternOrRegexp 具有 [[RegExpMatcher]] 内部槽，则
- 令 patternSource 为 patternOrRegexp.[[OriginalSource]]。
- 如果 flags 是
undefined ，则将 flags 设置为 patternOrRegexp.[[OriginalFlags]]。
- 否则，如果 patternIsRegExp 是
true ，则 - 否则，
- 令 patternSource 为 patternOrRegexp。
- 令 obj 为 ?
RegExpAlloc (newTarget)。 - 返回 ?
RegExpInitialize (obj, patternSource, flags)。
如果 pattern 使用
22.2.5 RegExp 构造器的属性
RegExp 构造器：
- 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
22.2.5.1 RegExp.escape ( string )
此函数返回 string 的副本，其中正则表达式
它在被调用时执行以下步骤：
- 如果 string 不是 String，则抛出
TypeError 异常。 - 令 escaped 为空 String。
- 令 codePointList 为
StringToCodePoints (string)。 - 对 codePointList 的每个码点 codePoint，执行：
- 如果 escaped 为空 String 且 codePoint 被
DecimalDigit 或AsciiLetter 匹配，则- 注：转义开头的数字可确保输出对应于可在
\0字符转义或诸如\1的DecimalEscape 之后使用的模式文本，并且仍匹配 string，而不是被解释为前一个转义序列的扩展。转义开头的 ASCII 字母对\c之后的上下文也有同样作用。 - 令 numericValue 为 codePoint 的数值。
- 令 hex 为
Number::toString (𝔽 (numericValue), 16)。 - 断言：hex 的长度为 2。
- 将 escaped 设置为码元 0x005C（REVERSE SOLIDUS）、
"x" 和 hex 的字符串连接 。
- 注：转义开头的数字可确保输出对应于可在
- 否则，
- 将 escaped 设置为 escaped 和
EncodeForRegExpEscape (codePoint) 的字符串连接 。
- 将 escaped 设置为 escaped 和
- 如果 escaped 为空 String 且 codePoint 被
- 返回 escaped。
尽管名称相似，RegExp.escape 并不执行相似的操作。前者转义模式以便表示为字符串，而此函数转义字符串以便表示在模式内部。
22.2.5.1.1 EncodeForRegExpEscape ( codePoint )
The abstract operation EncodeForRegExpEscape takes argument codePoint (a code point) and returns a String. 它返回一个表示
- 如果 codePoint 被
SyntaxCharacter 匹配，或 codePoint 是 U+002F（SOLIDUS），则- 返回 0x005C（REVERSE SOLIDUS）和
UTF16EncodeCodePoint (codePoint) 的字符串连接 。
- 返回 0x005C（REVERSE SOLIDUS）和
- 如果 codePoint 是
Table 63 的 “Code Point” 列中列出的码点，则 - 令 otherPunctuators 为
",-=<>#&!%:;@~'`" 和码元 0x0022（QUOTATION MARK）的字符串连接 。 - 令 toEscape 为
StringToCodePoints (otherPunctuators)。 - 如果 toEscape
包含 codePoint，codePoint 被WhiteSpace 或LineTerminator 匹配，或 codePoint 与前导代理或尾随代理具有相同数值，则- 令 codePointNumber 为 codePoint 的数值。
- 如果 codePointNumber ≤ 0xFF，则
- 令 hex 为
Number::toString (𝔽 (codePointNumber), 16)。 - 返回码元 0x005C（REVERSE SOLIDUS）、
"x" 和StringPad (hex, 2,"0" ,start ) 的字符串连接 。
- 令 hex 为
- 令 escaped 为空 String。
- 令 codeUnits 为
UTF16EncodeCodePoint (codePoint)。 - 对 codeUnits 的每个码元 codeUnit，执行：
- 将 escaped 设置为 escaped 和
UnicodeEscape (codeUnit) 的字符串连接 。
- 将 escaped 设置为 escaped 和
- 返回 escaped。
- 返回
UTF16EncodeCodePoint (codePoint)。
22.2.5.2 RegExp.prototype
RegExp.prototype 的初始值是
此属性具有特性 { [[Writable]]:
22.2.5.3 get RegExp [ %Symbol.species% ]
RegExp[%Symbol.species%] 是
- 返回
this 值。
此函数的
RegExp 原型方法通常使用其
22.2.6 RegExp 原型对象的属性
RegExp 原型对象：
- 是 %RegExp.prototype%。
- 是
普通对象 。 - 不是 RegExp 实例，并且没有 [[RegExpMatcher]] 内部槽，也没有 RegExp 实例对象的任何其他内部槽。
- 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。
RegExp 原型对象自身没有
22.2.6.1 RegExp.prototype.constructor
RegExp.prototype.constructor 的初始值是
22.2.6.2 RegExp.prototype.exec ( string )
此方法在 string 中搜索正则表达式模式的出现位置，并返回
它在被调用时执行以下步骤：
- 令 regexp 为
this 值。 - 执行 ?
RequireInternalSlot (regexp, [[RegExpMatcher]])。 - 将 string 设置为 ?
ToString (string)。 - 返回 ?
RegExpBuiltinExec (regexp, string)。
22.2.6.3 get RegExp.prototype.dotAll
RegExp.prototype.dotAll 是
- 令 regexp 为
this 值。 - 令 codeUnit 为码元 0x0073（LATIN SMALL LETTER S）。
- 返回 ?
RegExpHasFlag (regexp, codeUnit)。
22.2.6.4 get RegExp.prototype.flags
RegExp.prototype.flags 是
- 令 regexp 为
this 值。 - 如果 regexp 不是 Object，则抛出
TypeError 异常。 - 令 codeUnits 为新的空
List 。 - 令 hasIndices 为
ToBoolean (?Get (regexp,"hasIndices" )). - 如果 hasIndices 是
true ，则将码元 0x0064（LATIN SMALL LETTER D）追加到 codeUnits。 - 令 global 为
ToBoolean (?Get (regexp,"global" )). - 如果 global 是
true ，则将码元 0x0067（LATIN SMALL LETTER G）追加到 codeUnits。 - 令 ignoreCase 为
ToBoolean (?Get (regexp,"ignoreCase" )). - 如果 ignoreCase 是
true ，则将码元 0x0069（LATIN SMALL LETTER I）追加到 codeUnits。 - 令 multiline 为
ToBoolean (?Get (regexp,"multiline" )). - 如果 multiline 是
true ，则将码元 0x006D（LATIN SMALL LETTER M）追加到 codeUnits。 - 令 dotAll 为
ToBoolean (?Get (regexp,"dotAll" )). - 如果 dotAll 是
true ，则将码元 0x0073（LATIN SMALL LETTER S）追加到 codeUnits。 - 令 unicode 为
ToBoolean (?Get (regexp,"unicode" )). - 如果 unicode 是
true ，则将码元 0x0075（LATIN SMALL LETTER U）追加到 codeUnits。 - 令 unicodeSets 为
ToBoolean (?Get (regexp,"unicodeSets" )). - 如果 unicodeSets 是
true ，则将码元 0x0076（LATIN SMALL LETTER V）追加到 codeUnits。 - 令 sticky 为
ToBoolean (?Get (regexp,"sticky" )). - 如果 sticky 是
true ，则将码元 0x0079（LATIN SMALL LETTER Y）追加到 codeUnits。 - 返回一个 String 值，其码元是
List codeUnits 的元素。如果 codeUnits 没有元素，则返回空 String。
22.2.6.4.1 RegExpHasFlag ( regexp, codeUnit )
The abstract operation RegExpHasFlag takes arguments regexp (an ECMAScript language value) and codeUnit (a code unit) and returns either a normal completion containing either a Boolean or
- 如果 regexp 不是 Object，则抛出
TypeError 异常。 - 如果 regexp 没有 [[OriginalFlags]] 内部槽，则
- 如果
SameValue (regexp,%RegExp.prototype% ) 是true ，则返回undefined 。 - 抛出
TypeError 异常。
- 如果
- 令 flags 为 regexp.[[OriginalFlags]]。
- 如果 flags
包含 codeUnit，则返回true 。 - 返回
false 。
22.2.6.5 get RegExp.prototype.global
RegExp.prototype.global 是
- 令 regexp 为
this 值。 - 令 codeUnit 为码元 0x0067（LATIN SMALL LETTER G）。
- 返回 ?
RegExpHasFlag (regexp, codeUnit)。
22.2.6.6 get RegExp.prototype.hasIndices
RegExp.prototype.hasIndices 是
- 令 regexp 为
this 值。 - 令 codeUnit 为码元 0x0064（LATIN SMALL LETTER D）。
- 返回 ?
RegExpHasFlag (regexp, codeUnit)。
22.2.6.7 get RegExp.prototype.ignoreCase
RegExp.prototype.ignoreCase 是
- 令 regexp 为
this 值。 - 令 codeUnit 为码元 0x0069（LATIN SMALL LETTER I）。
- 返回 ?
RegExpHasFlag (regexp, codeUnit)。
22.2.6.8 RegExp.prototype [ %Symbol.match% ] ( string )
此方法在被调用时执行以下步骤：
- 令 regexp 为
this 值。 - 如果 regexp 不是 Object，则抛出
TypeError 异常。 - 将 string 设置为 ?
ToString (string)。 - 令 flags 为 ?
ToString (?Get (regexp,"flags" ))。 - 如果 flags 不
包含 "g" ，则返回 ?RegExpExec (regexp, string)。 - 如果 flags
包含 "u" 或 flags包含 "v" ，则令 fullUnicode 为true ；否则令 fullUnicode 为false 。 - 执行 ?
Set (regexp,"lastIndex" ,+0 𝔽,true )。 - 令 array 为 !
ArrayCreate (0)。 - 令 matchCount 为 0。
- 重复，
- 令 result 为 ?
RegExpExec (regexp, string)。 - 如果 result 是
null ，则- 如果 matchCount = 0，则返回
null 。 - 返回 array。
- 如果 matchCount = 0，则返回
- 令 matchString 为 ?
ToString (?Get (result,"0" ))。 - 执行 !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (matchCount)), matchString)。 - 如果 matchString 为空 String，则
- 将 matchCount 设置为 matchCount + 1。
- 令 result 为 ?
此方法的
22.2.6.9 RegExp.prototype [ %Symbol.matchAll% ] ( string )
此方法在被调用时执行以下步骤：
- 令 regexp 为
this 值。 - 如果 regexp 不是 Object，则抛出
TypeError 异常。 - 将 string 设置为 ?
ToString (string)。 - 令 speciesCtor 为 ?
SpeciesConstructor (regexp,%RegExp% )。 - 令 flags 为 ?
ToString (?Get (regexp,"flags" ))。 - 令 matcher 为 ?
Construct (speciesCtor, « regexp, flags »)。 - 令 lastIndex 为 ?
ToLength (?Get (regexp,"lastIndex" )). - 执行 ?
Set (matcher,"lastIndex" , lastIndex,true )。 - 如果 flags
包含 "g" ，则令 global 为true 。 - 否则，令 global 为
false 。 - 如果 flags
包含 "u" 或 flags包含 "v" ，则令 fullUnicode 为true 。 - 否则，令 fullUnicode 为
false 。 - 返回
CreateRegExpStringIterator (matcher, string, global, fullUnicode)。
此方法的
22.2.6.10 get RegExp.prototype.multiline
RegExp.prototype.multiline 是
- 令 regexp 为
this 值。 - 令 codeUnit 为码元 0x006D（LATIN SMALL LETTER M）。
- 返回 ?
RegExpHasFlag (regexp, codeUnit)。
22.2.6.11 RegExp.prototype [ %Symbol.replace% ] ( string, replaceValue )
此方法在被调用时执行以下步骤：
- 令 regexp 为
this 值。 - 如果 regexp 不是 Object，则抛出
TypeError 异常。 - 将 string 设置为 ?
ToString (string)。 - 令 stringLength 为 string 的长度。
- 令 functionalReplace 为
IsCallable (replaceValue)。 - 如果 functionalReplace 是
false ，则- 将 replaceValue 设置为 ?
ToString (replaceValue)。
- 将 replaceValue 设置为 ?
- 令 flags 为 ?
ToString (?Get (regexp,"flags" ))。 - 如果 flags
包含 "g" ，则令 global 为true ；否则令 global 为false 。 - 如果 global 是
true ，则- 执行 ?
Set (regexp,"lastIndex" ,+0 𝔽,true )。
- 执行 ?
- 令 results 为新的空
List 。 - 令 done 为
false 。 - 重复，只要 done 是
false ，- 令 result 为 ?
RegExpExec (regexp, string)。 - 如果 result 是
null ，则- 将 done 设置为
true 。
- 将 done 设置为
- 否则，
- 令 result 为 ?
- 令 accumulatedResult 为空 String。
- 令 nextSourcePosition 为 0。
- 对 results 的每个元素 result，执行：
- 令 resultLength 为 ?
LengthOfArrayLike (result)。 - 令 capturesCount 为
max (resultLength - 1, 0)。 - 令 matched 为 ?
ToString (?Get (result,"0" ))。 - 令 matchLength 为 matched 的长度。
- 令 position 为 ?
ToIntegerOrInfinity (?Get (result,"index" ))。 - 将 position 设置为将 position 夹在 0 与 stringLength 之间的结果。
- 令 captures 为新的空
List 。 - 令 captureNumber 为 1。
- 重复，只要 captureNumber ≤ capturesCount，
- 令 capture 为 ?
Get (result, !ToString (𝔽 (captureNumber)))。 - 如果 capture 不是
undefined ，则- 将 capture 设置为 ?
ToString (capture)。
- 将 capture 设置为 ?
- 将 capture 追加到 captures。
- 注：当 captureNumber = 1 时，前一步把第一个元素放入 captures（索引为 0）。更一般地，第 captureNumberth 个 capture（第 captureNumberth 组捕获括号捕获的字符）位于 captures[captureNumber - 1]。
- 将 captureNumber 设置为 captureNumber + 1。
- 令 capture 为 ?
- 令 namedCaptures 为 ?
Get (result,"groups" )。 - 如果 functionalReplace 是
true ，则 - 否则，
- 如果 namedCaptures 不是
undefined ，则- 将 namedCaptures 设置为 ?
ToObject (namedCaptures)。
- 将 namedCaptures 设置为 ?
- 令 replacementString 为 ?
GetSubstitution (matched, string, position, captures, namedCaptures, replaceValue)。
- 如果 namedCaptures 不是
- 如果 position ≥ nextSourcePosition，则
- 令 resultLength 为 ?
- 如果 nextSourcePosition ≥ stringLength，则返回 accumulatedResult。
- 返回 accumulatedResult 和 string 从 nextSourcePosition 起的
子字符串 的字符串连接 。
此方法的
22.2.6.12 RegExp.prototype [ %Symbol.search% ] ( string )
此方法在被调用时执行以下步骤：
- 令 regexp 为
this 值。 - 如果 regexp 不是 Object，则抛出
TypeError 异常。 - 将 string 设置为 ?
ToString (string)。 - 令 previousLastIndex 为 ?
Get (regexp,"lastIndex" )。 - 如果 previousLastIndex 不是
+0 𝔽，则- 执行 ?
Set (regexp,"lastIndex" ,+0 𝔽,true )。
- 执行 ?
- 令 result 为 ?
RegExpExec (regexp, string)。 - 令 currentLastIndex 为 ?
Get (regexp,"lastIndex" )。 - 如果
SameValue (currentLastIndex, previousLastIndex) 是false ，则- 执行 ?
Set (regexp,"lastIndex" , previousLastIndex,true )。
- 执行 ?
- 如果 result 是
null ，则返回-1 𝔽。 - 返回 ?
Get (result,"index" )。
此方法的
执行搜索时会忽略此 RegExp 对象的
22.2.6.13 get RegExp.prototype.source
RegExp.prototype.source 是
- 令 regexp 为
this 值。 - 如果 regexp 不是 Object，则抛出
TypeError 异常。 - 如果 regexp 没有 [[OriginalSource]] 内部槽，则
- 如果
SameValue (regexp,%RegExp.prototype% ) 是true ，则返回"(?:)" 。 - 抛出
TypeError 异常。
- 如果
- 断言：regexp 具有 [[OriginalFlags]] 内部槽。
- 令 source 为 regexp.[[OriginalSource]]。
- 令 flags 为 regexp.[[OriginalFlags]]。
- 返回
EscapeRegExpPattern (source, flags)。
22.2.6.13.1 EscapeRegExpPattern ( pattern, flags )
The abstract operation EscapeRegExpPattern takes arguments pattern (a String) and flags (a String) and returns a String. It performs the following steps when called:
- 如果 flags
包含 "v" ，则- 令 patternSymbol 为
Pattern 。[+UnicodeMode, +UnicodeSetsMode]
- 令 patternSymbol 为
- 否则，如果 flags
包含 "u" ，则- 令 patternSymbol 为
Pattern 。[+UnicodeMode, ~UnicodeSetsMode]
- 令 patternSymbol 为
- 否则，
- 令 patternSymbol 为
Pattern 。[~UnicodeMode, ~UnicodeSetsMode]
- 令 patternSymbol 为
- 令 escapedPattern 为一个 String，其形式为等价于 pattern 的 patternSymbol，pattern 被解释为 UTF-16 编码的 Unicode 码点（
6.1.4 ），其中某些码点按下文描述进行转义。escapedPattern 可以与 pattern 不同，也可以不不同；然而，把 escapedPattern 作为 patternSymbol 求值所产生的Abstract Closure 必须与构造对象的 [[RegExpMatcher]] 内部槽给出的Abstract Closure 行为相同。使用相同的 pattern 和 flags 值多次调用此抽象操作 ，必须产生相同结果。 - 模式中出现的码点
/或任何LineTerminator 应根据需要在 escapedPattern 中被转义，以确保"/" 、escapedPattern、"/" 和 flags 的字符串连接 可以（在适当的词法上下文中）被解析为与构造的正则表达式行为相同的RegularExpressionLiteral 。例如，如果 pattern 是"/" ，则 escapedPattern 可以是"\/" 或"\u002F" 等，但不能是"/" ，因为后跟 flags 的///会被解析为SingleLineComment ，而不是RegularExpressionLiteral 。如果 pattern 是空 String，则可通过令 escapedPattern 为"(?:)" 来满足本规范。 - 返回 escapedPattern。
尽管名称相似，RegExp.escape 和 EscapeRegExpPattern 并不执行相似的操作。前者转义字符串以便表示在模式内部，而此函数转义模式以便表示为字符串。
22.2.6.14 RegExp.prototype [ %Symbol.split% ] ( string, limit )
此方法返回一个 Array，其中存储了将 string 转换为 String 后所得结果的各个
/a*?/[Symbol.split]("ab") 求值为数组 ["a", "b"]，而 /a*/[Symbol.split]("ab") 求值为数组 ["","b"]。）
如果 string 是（或转换为）空 String，则结果取决于正则表达式是否能匹配空 String。如果可以，结果数组不
如果正则表达式
/<(\/)?([^<>]+)>/[Symbol.split]("A<B>bold</B>and<CODE>coded</CODE>")求值为数组
["A", undefined, "B", "bold", "/", "B", "and", undefined, "CODE", "coded", "/", "CODE", ""]如果 limit 不是
此方法在被调用时执行以下步骤：
- 令 regexp 为
this 值。 - 如果 regexp 不是 Object，则抛出
TypeError 异常。 - 将 string 设置为 ?
ToString (string)。 - 令 speciesCtor 为 ?
SpeciesConstructor (regexp,%RegExp% )。 - 令 flags 为 ?
ToString (?Get (regexp,"flags" ))。 - 如果 flags
包含 "u" 或 flags包含 "v" ，则令 unicodeMatching 为true 。 - 否则，令 unicodeMatching 为
false 。 - 如果 flags
包含 "y" ，则令 newFlags 为 flags。 - 否则，令 newFlags 为 flags 和
"y" 的字符串连接 。 - 令 splitter 为 ?
Construct (speciesCtor, « regexp, newFlags »)。 - 令 array 为 !
ArrayCreate (0)。 - 令 lengthA 为 0。
- 如果 limit 是
undefined ，则令 lim 为 232 - 1；否则令 lim 为ℝ (?ToUint32 (limit))。 - 如果 lim = 0，则返回 array。
- 如果 string 为空 String，则
- 令 matchResult 为 ?
RegExpExec (splitter, string)。 - 如果 matchResult 不是
null ，则返回 array。 - 执行 !
CreateDataPropertyOrThrow (array,"0" , string)。 - 返回 array。
- 令 matchResult 为 ?
- 令 size 为 string 的长度。
- 令 lastMatchEnd 为 0。
- 令 searchIndex 为 lastMatchEnd。
- 重复，只要 searchIndex < size，
- 执行 ?
Set (splitter,"lastIndex" ,𝔽 (searchIndex),true )。 - 令 matchResult 为 ?
RegExpExec (splitter, string)。 - 如果 matchResult 是
null ，则- 将 searchIndex 设置为
AdvanceStringIndex (string, searchIndex, unicodeMatching)。
- 将 searchIndex 设置为
- 否则，
- 令 matchEnd 为
ℝ (?ToLength (?Get (splitter,"lastIndex" ))). - 将 matchEnd 设置为
min (matchEnd, size)。 - 如果 matchEnd = lastMatchEnd，则
- 将 searchIndex 设置为
AdvanceStringIndex (string, searchIndex, unicodeMatching)。
- 将 searchIndex 设置为
- 否则，
- 令 substring 为 string 从 lastMatchEnd 到 searchIndex 的
子字符串 。 - 执行 !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (lengthA)), substring)。 - 将 lengthA 设置为 lengthA + 1。
- 如果 lengthA = lim，则返回 array。
- 将 lastMatchEnd 设置为 matchEnd。
- 令 numberOfCaptures 为 ?
LengthOfArrayLike (matchResult)。 - 将 numberOfCaptures 设置为
max (numberOfCaptures - 1, 0)。 - 令 captureIndex 为 1。
- 重复，只要 captureIndex ≤ numberOfCaptures，
- 将 searchIndex 设置为 lastMatchEnd。
- 令 substring 为 string 从 lastMatchEnd 到 searchIndex 的
- 令 matchEnd 为
- 执行 ?
- 令 substring 为 string 从 lastMatchEnd 到 size 的
子字符串 。 - 执行 !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (lengthA)), substring)。 - 返回 array。
此方法的
此方法会忽略此 RegExp 对象的
22.2.6.15 get RegExp.prototype.sticky
RegExp.prototype.sticky 是
- 令 regexp 为
this 值。 - 令 codeUnit 为码元 0x0079（LATIN SMALL LETTER Y）。
- 返回 ?
RegExpHasFlag (regexp, codeUnit)。
22.2.6.16 RegExp.prototype.test ( string )
此方法在被调用时执行以下步骤：
- 令 regexp 为
this 值。 - 如果 regexp 不是 Object，则抛出
TypeError 异常。 - 将 string 设置为 ?
ToString (string)。 - 令 match 为 ?
RegExpExec (regexp, string)。 - 如果 match 是
null ，则返回false 。 - 返回
true 。
22.2.6.17 RegExp.prototype.toString ( )
返回的 String 具有
22.2.6.18 get RegExp.prototype.unicode
RegExp.prototype.unicode 是
- 令 regexp 为
this 值。 - 令 codeUnit 为码元 0x0075（LATIN SMALL LETTER U）。
- 返回 ?
RegExpHasFlag (regexp, codeUnit)。
22.2.6.19 get RegExp.prototype.unicodeSets
RegExp.prototype.unicodeSets 是
- 令 regexp 为
this 值。 - 令 codeUnit 为码元 0x0076（LATIN SMALL LETTER V）。
- 返回 ?
RegExpHasFlag (regexp, codeUnit)。
22.2.7 RegExp 匹配的抽象操作
22.2.7.1 RegExpExec ( regexp, string )
The abstract operation RegExpExec takes arguments regexp (an Object) and string (a String) and returns either a normal completion containing either an Object or
- 令 exec 为 ?
Get (regexp,"exec" )。 - 如果
IsCallable (exec) 是true ，则- 令 result 为 ?
Call (exec, regexp, « string »)。 - 如果 result 不是 Object 且 result 不是
null ，则抛出TypeError 异常。 - 返回 result。
- 令 result 为 ?
- 执行 ?
RequireInternalSlot (regexp, [[RegExpMatcher]])。 - 返回 ?
RegExpBuiltinExec (regexp, string)。
如果未找到可调用的
22.2.7.2 RegExpBuiltinExec ( regexp, string )
The abstract operation RegExpBuiltinExec takes arguments regexp (an initialized RegExp instance) and string (a String) and returns either a normal completion containing either an Array exotic object or
- 令 length 为 string 的长度。
- 令 lastIndex 为
ℝ (?ToLength (!Get (regexp,"lastIndex" )))。 - 令 flags 为 regexp.[[OriginalFlags]]。
- 如果 flags
包含 "g" ，则令 global 为true ；否则令 global 为false 。 - 如果 flags
包含 "y" ，则令 sticky 为true ；否则令 sticky 为false 。 - 如果 flags
包含 "d" ，则令 hasIndices 为true ；否则令 hasIndices 为false 。 - 如果 global 是
false 且 sticky 是false ，则将 lastIndex 设置为 0。 - 令 matcher 为 regexp.[[RegExpMatcher]]。
- 如果 flags
包含 "u" 或 flags包含 "v" ，则令 fullUnicode 为true ；否则令 fullUnicode 为false 。 - 令 matchSucceeded 为
false 。 - 如果 fullUnicode 是
true ，则令 input 为StringToCodePoints (string)；否则令 input 为一个List ，其元素是 string 的元素所对应的码元。 - 注：input 的每个元素都被视为一个字符。
- 重复，只要 matchSucceeded 是
false ，- 如果 lastIndex > length，则
- 如果 global 是
true 或 sticky 是true ，则- 执行 ?
Set (regexp,"lastIndex" ,+0 𝔽,true )。
- 执行 ?
- 返回
null 。
- 如果 global 是
- 令 inputIndex 为 input 中的索引，该索引对应从 string 的元素 lastIndex 获得的字符。
- 令 result 为 matcher(input, inputIndex)。
- 如果 result 是
failure ，则- 如果 sticky 是
true ，则- 执行 ?
Set (regexp,"lastIndex" ,+0 𝔽,true )。 - 返回
null 。
- 执行 ?
- 将 lastIndex 设置为
AdvanceStringIndex (string, lastIndex, fullUnicode)。
- 如果 sticky 是
- 否则，
- 断言：result 是
MatchState 。 - 将 matchSucceeded 设置为
true 。
- 断言：result 是
- 如果 lastIndex > length，则
- 令 endIndex 为 result.[[EndIndex]]。
- 如果 fullUnicode 是
true ，则将 endIndex 设置为GetStringIndex (string, endIndex)。 - 如果 global 是
true 或 sticky 是true ，则 - 令 capturingGroupsCount 为 result.[[Captures]] 中元素的数量。
- 断言：capturingGroupsCount = regexp.[[RegExpRecord]].[[CapturingGroupsCount]]。
- 断言：capturingGroupsCount < 232 - 1。
- 令 array 为 !
ArrayCreate (capturingGroupsCount + 1)。 - 断言：array 的
"length" 属性的数学值 是 capturingGroupsCount + 1。 - 执行 !
CreateDataPropertyOrThrow (array,"index" ,𝔽 (lastIndex))。 - 执行 !
CreateDataPropertyOrThrow (array,"input" , string)。 - 令 match 为
Match Record { [[StartIndex]]: lastIndex, [[EndIndex]]: endIndex }。 - 令 indices 为新的空
List 。 - 令 groupNames 为新的空
List 。 - 将 match 追加到 indices。
- 令 matchedSubstring 为
GetMatchString (string, match)。 - 执行 !
CreateDataPropertyOrThrow (array,"0" , matchedSubstring)。 - 如果 regexp
包含 任何GroupName ，则- 令 groups 为
OrdinaryObjectCreate (null )。 - 令 hasGroups 为
true 。
- 令 groups 为
- 否则，
- 令 groups 为
undefined 。 - 令 hasGroups 为
false 。
- 令 groups 为
- 执行 !
CreateDataPropertyOrThrow (array,"groups" , groups)。 - 令 matchedGroupNames 为新的空
List 。 - 对每个满足 1 ≤ i ≤ capturingGroupsCount 的整数 i，按升序执行：
- 令 capture 为 result.[[Captures]] 的第 ith 个元素。
- 如果 capture 是
undefined ，则- 令 capturedValue 为
undefined 。 - 将
undefined 追加到 indices。
- 令 capturedValue 为
- 否则，
- 令 captureStart 为 capture.[[StartIndex]]。
- 令 captureEnd 为 capture.[[EndIndex]]。
- 如果 fullUnicode 是
true ，则- 将 captureStart 设置为
GetStringIndex (string, captureStart)。 - 将 captureEnd 设置为
GetStringIndex (string, captureEnd)。
- 将 captureStart 设置为
- 令 captureRecord 为
Match Record { [[StartIndex]]: captureStart, [[EndIndex]]: captureEnd }。 - 令 capturedValue 为
GetMatchString (string, captureRecord)。 - 将 captureRecord 追加到 indices。
- 执行 !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (i)), capturedValue)。 - 如果 regexp 的第 ith 个 capture 使用
GroupName 定义，则- 令 groupName 为该
GroupName 的CapturingGroupName 。 - 如果 matchedGroupNames
包含 groupName，则- 断言：capturedValue 是
undefined 。 - 将
undefined 追加到 groupNames。
- 断言：capturedValue 是
- 否则，
- 如果 capturedValue 不是
undefined ，则将 groupName 追加到 matchedGroupNames。 - 注：如果有多个名为 groupName 的组，则此时 groups 可能已经有一个 groupName 属性。不过，由于 groups 是
普通对象 ，并且其属性全都是可写的数据属性 ，因此对CreateDataPropertyOrThrow 的调用仍然保证会成功。 - 执行 !
CreateDataPropertyOrThrow (groups, groupName, capturedValue)。 - 将 groupName 追加到 groupNames。
- 如果 capturedValue 不是
- 令 groupName 为该
- 否则，
- 将
undefined 追加到 groupNames。
- 将
- 如果 hasIndices 是
true ，则- 令 indicesArray 为
MakeMatchIndicesIndexPairArray (string, indices, groupNames, hasGroups)。 - 执行 !
CreateDataPropertyOrThrow (array,"indices" , indicesArray)。
- 令 indicesArray 为
- 返回 array。
22.2.7.3 AdvanceStringIndex ( string, index, unicode )
The abstract operation AdvanceStringIndex takes arguments string (a String), index (a non-negative
- 断言：index ≤ 253 - 1。
- 如果 unicode 是
false ，则返回 index + 1。 - 令 length 为 string 的长度。
- 如果 index + 1 ≥ length，则返回 index + 1。
- 令 codePoint 为
CodePointAt (string, index)。 - 返回 index + codePoint.[[CodeUnitCount]]。
22.2.7.4 GetStringIndex ( string, codePointIndex )
The abstract operation GetStringIndex takes arguments string (a String) and codePointIndex (a non-negative
- 如果 string 为空 String，则返回 0。
- 令 length 为 string 的长度。
- 令 codeUnitCount 为 0。
- 令 codePointCount 为 0。
- 重复，只要 codeUnitCount < length，
- 如果 codePointCount = codePointIndex，则返回 codeUnitCount。
- 令 codePoint 为
CodePointAt (string, codeUnitCount)。 - 将 codeUnitCount 设置为 codeUnitCount + codePoint.[[CodeUnitCount]]。
- 将 codePointCount 设置为 codePointCount + 1。
- 返回 length。
22.2.7.5 Match Record
Match Record 是一种
Match Record 具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[StartIndex]] | a non-negative |
从字符串开头起计数，匹配开始处（ |
| [[EndIndex]] | an |
从字符串开头起计数，匹配结束处（不 |
22.2.7.6 GetMatchString ( string, match )
The abstract operation GetMatchString takes arguments string (a String) and match (a
- 断言：match.[[StartIndex]] ≤ match.[[EndIndex]] ≤ string 的长度。
- 返回 string 从 match.[[StartIndex]] 到 match.[[EndIndex]] 的
子字符串 。
22.2.7.7 GetMatchIndexPair ( string, match )
The abstract operation GetMatchIndexPair takes arguments string (a String) and match (a
- 断言：match.[[StartIndex]] ≤ match.[[EndIndex]] ≤ string 的长度。
- 返回
CreateArrayFromList («𝔽 (match.[[StartIndex]]),𝔽 (match.[[EndIndex]]) »)。
22.2.7.8 MakeMatchIndicesIndexPairArray ( string, indices, groupNames, hasGroups )
The abstract operation MakeMatchIndicesIndexPairArray takes arguments string (a String), indices (a
- 令 n 为 indices 中元素的数量。
- 断言：n < 232 - 1。
- 断言：groupNames 有 n - 1 个元素。
- 注：groupNames
List 包含 与 indicesList 中从 indices[1] 开始对齐的元素。 - 令 array 为 !
ArrayCreate (n)。 - 如果 hasGroups 是
true ，则- 令 groups 为
OrdinaryObjectCreate (null )。
- 令 groups 为
- 否则，
- 令 groups 为
undefined 。
- 令 groups 为
- 执行 !
CreateDataPropertyOrThrow (array,"groups" , groups)。 - 对每个满足 0 ≤ i < n 的整数 i，按升序执行：
- 令 matchIndices 为 indices[i]。
- 如果 matchIndices 不是
undefined ，则- 令 matchIndexPair 为
GetMatchIndexPair (string, matchIndices)。
- 令 matchIndexPair 为
- 否则，
- 令 matchIndexPair 为
undefined 。
- 令 matchIndexPair 为
- 执行 !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (i)), matchIndexPair)。 - 如果 i > 0，则
- 令 name 为 groupNames[i - 1]。
- 如果 name 不是
undefined ，则- 断言：groups 不是
undefined 。 - 注：如果有多个名为 name 的组，则此时 groups 可能已经有一个 name 属性。不过，由于 groups 是
普通对象 ，并且其属性全都是可写的数据属性 ，因此对CreateDataPropertyOrThrow 的调用仍然保证会成功。 - 执行 !
CreateDataPropertyOrThrow (groups, name, matchIndexPair)。
- 断言：groups 不是
- 返回 array。
22.2.8 RegExp 实例的属性
RegExp 实例是
RegExp 实例还具有以下属性：
22.2.8.1 lastIndex
22.2.9 RegExp String Iterator 对象
RegExp String Iterator 是表示对某个特定 String 实例对象进行特定迭代，并与某个特定 RegExp 实例对象匹配的对象。RegExp String Iterator 对象没有具名构造器。相反，RegExp String Iterator 对象通过调用 RegExp 实例对象的某些方法创建。
22.2.9.1 CreateRegExpStringIterator ( regexp, string, global, fullUnicode )
The abstract operation CreateRegExpStringIterator takes arguments regexp (an Object), string (a String), global (a Boolean), and fullUnicode (a Boolean) and returns an Object. It performs the following steps when called:
- 令 iterator 为
OrdinaryObjectCreate (%RegExpStringIteratorPrototype% , « [[IteratingRegExp]], [[IteratedString]], [[Global]], [[Unicode]], [[Done]] »)。 - 将 iterator.[[IteratingRegExp]] 设置为 regexp。
- 将 iterator.[[IteratedString]] 设置为 string。
- 将 iterator.[[Global]] 设置为 global。
- 将 iterator.[[Unicode]] 设置为 fullUnicode。
- 将 iterator.[[Done]] 设置为
false 。 - 返回 iterator。
22.2.9.2 %RegExpStringIteratorPrototype% 对象
%RegExpStringIteratorPrototype% 对象：
- 具有由所有
RegExp String Iterator 对象继承的属性。 - 是
普通对象 。 - 具有一个 [[Prototype]] 内部槽，其值为
%Iterator.prototype% 。 - 具有以下属性：
22.2.9.2.1 %RegExpStringIteratorPrototype%.next ( )
- 令 iteratorObj 为
this 值。 - 如果 iteratorObj 不是 Object，则抛出
TypeError 异常。 - 如果 iteratorObj 不具有
RegExp String Iterator Object Instance 的所有内部槽（见22.2.9.3 ），则抛出TypeError 异常。 - 如果 iteratorObj.[[Done]] 是
true ，则- 返回
CreateIteratorResultObject (undefined ,true )。
- 返回
- 令 regexp 为 iteratorObj.[[IteratingRegExp]]。
- 令 string 为 iteratorObj.[[IteratedString]]。
- 令 global 为 iteratorObj.[[Global]]。
- 令 fullUnicode 为 iteratorObj.[[Unicode]]。
- 令 match 为 ?
RegExpExec (regexp, string)。 - 如果 match 是
null ，则- 将 iteratorObj.[[Done]] 设置为
true 。 - 返回
CreateIteratorResultObject (undefined ,true )。
- 将 iteratorObj.[[Done]] 设置为
- 如果 global 是
false ，则- 将 iteratorObj.[[Done]] 设置为
true 。 - 返回
CreateIteratorResultObject (match,false )。
- 将 iteratorObj.[[Done]] 设置为
- 令 matchString 为 ?
ToString (?Get (match,"0" ))。 - 如果 matchString 为空 String，则
- 返回
CreateIteratorResultObject (match,false )。
22.2.9.2.2 %RegExpStringIteratorPrototype% [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
22.2.9.3 RegExp String Iterator 实例的属性
| 内部槽 | 类型 | 描述 |
|---|---|---|
| [[IteratingRegExp]] | an Object | 用于迭代的正则表达式。 |
| [[IteratedString]] | a String | 正在迭代的 String 值。 |
| [[Global]] | a Boolean | 指示 [[IteratingRegExp]] 是否为全局。 |
| [[Unicode]] | a Boolean | 指示 [[IteratingRegExp]] 是否处于 Unicode 模式。 |
| [[Done]] | a Boolean | 指示迭代是否完成。 |
23 索引集合
23.1 Array 对象
Array 是奇异对象，会对某一类
23.1.1 Array 构造器
Array 构造器：
- 是 %Array%。
- 是
全局对象 的"Array" 属性的初始值。 - 在作为构造器调用时创建并初始化一个新的 Array。
- 在作为函数而非构造器调用时，也会创建并初始化一个新的 Array。因此，函数调用
Array(…)等价于使用相同实参的对象创建表达式new Array(…)。 - 是一个其行为会根据实参数量和类型而不同的函数。
- 可以用作类定义的
extends子句的值。意图继承奇异 Array 行为的子类构造器必须包含 对 Array 构造器的super调用，以初始化作为 Array 奇异对象的子类实例。不过，大多数Array.prototype方法都是泛型方法，并不依赖其this 值是 Array 奇异对象。
23.1.1.1 Array ( ...values )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 是
undefined ，则令 newTarget 为活动函数对象 ；否则令 newTarget 为 NewTarget。 - 令 proto 为 ?
GetPrototypeFromConstructor (newTarget,"%Array.prototype%" )。 - 令 numberOfArgs 为 values 中元素的数量。
- 如果 numberOfArgs = 0，则返回 !
ArrayCreate (0, proto)。 - 如果 numberOfArgs = 1，则
- 令 length 为 values[0]。
- 令 array 为 !
ArrayCreate (0, proto)。 - 如果 length 不是 Number，则
- 执行 !
CreateDataPropertyOrThrow (array,"0" , length)。 - 令 intLength 为
1 𝔽。
- 执行 !
- 否则，
- 令 intLength 为 !
ToUint32 (length)。 - 如果
SameValueZero (intLength, length) 是false ，则抛出RangeError 异常。
- 令 intLength 为 !
- 执行 !
Set (array,"length" , intLength,true )。 - 返回 array。
- 断言：numberOfArgs ≥ 2。
- 令 array 为 ?
ArrayCreate (numberOfArgs, proto)。 - 令 k 为 0。
- 重复，只要 k < numberOfArgs，
- 令 propertyKey 为 !
ToString (𝔽 (k))。 - 令 itemK 为 values[k]。
- 执行 !
CreateDataPropertyOrThrow (array, propertyKey, itemK)。 - 将 k 设置为 k + 1。
- 令 propertyKey 为 !
- 断言：array 的
"length" 属性的数学值 是 numberOfArgs。 - 返回 array。
23.1.2 Array 构造器的属性
Array 构造器：
- 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有一个
"length" 属性，其值为1 𝔽。 - 具有以下属性：
23.1.2.1 Array.from ( items [ , mapper [ , thisArg ] ] )
此函数在被调用时执行以下步骤：
- 令 ctor 为
this 值。 - 如果 mapper 是
undefined ，则- 令 mapping 为
false 。
- 令 mapping 为
- 否则，
- 如果
IsCallable (mapper) 是false ，则抛出TypeError 异常。 - 令 mapping 为
true 。
- 如果
- 令 usingIterator 为 ?
GetMethod (items,%Symbol.iterator% )。 - 如果 usingIterator 不是
undefined ，则- 如果
IsConstructor (ctor) 是true ，则- 令 array 为 ?
Construct (ctor)。
- 令 array 为 ?
- 否则，
- 令 array 为 !
ArrayCreate (0)。
- 令 array 为 !
- 令 iteratorRecord 为 ?
GetIteratorFromMethod (items, usingIterator)。 - 令 k 为 0。
- 重复，
- 如果 k ≥ 253 - 1，则
- 令 error 为
ThrowCompletion (一个新创建的TypeError 对象)。 - 返回 ?
IteratorClose (iteratorRecord, error)。
- 令 error 为
- 令 propertyKey 为 !
ToString (𝔽 (k))。 - 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 是
done ，则 - 如果 mapping 是
true ，则- 令 mappedValue 为
Completion (Call (mapper, thisArg, « next,𝔽 (k) »))。 IfAbruptCloseIterator (mappedValue, iteratorRecord)。
- 令 mappedValue 为
- 否则，
- 令 mappedValue 为 next。
- 令 defineStatus 为
Completion (CreateDataPropertyOrThrow (array, propertyKey, mappedValue))。 IfAbruptCloseIterator (defineStatus, iteratorRecord)。- 将 k 设置为 k + 1。
- 如果 k ≥ 253 - 1，则
- 如果
- 注：items 不可迭代，因此假定它是一个
类数组对象 。 - 令 arrayLike 为 !
ToObject (items)。 - 令 length 为 ?
LengthOfArrayLike (arrayLike)。 - 如果
IsConstructor (ctor) 是true ，则 - 否则，
- 令 array 为 ?
ArrayCreate (length)。
- 令 array 为 ?
- 令 k 为 0。
- 重复，只要 k < length，
- 执行 ?
Set (array,"length" ,𝔽 (length),true )。 - 返回 array。
此方法是有意设计为泛型的工厂方法；它不要求其
23.1.2.2 Array.fromAsync ( items [ , mapper [ , thisArg ] ] )
此 async 函数在被调用时执行以下步骤：
- 令 ctor 为
this 值。 - 令 mapping 为
false 。 - 如果 mapper 不是
undefined ，则- 如果
IsCallable (mapper) 是false ，则抛出TypeError 异常。 - 将 mapping 设置为
true 。
- 如果
- 令 iteratorRecord 为
undefined 。 - 令 usingAsyncIterator 为 ?
GetMethod (items,%Symbol.asyncIterator% )。 - 如果 usingAsyncIterator 是
undefined ，则- 令 usingSyncIterator 为 ?
GetMethod (items,%Symbol.iterator% )。 - 如果 usingSyncIterator 不是
undefined ，则- 将 iteratorRecord 设置为
CreateAsyncFromSyncIterator (?GetIteratorFromMethod (items, usingSyncIterator))。
- 将 iteratorRecord 设置为
- 令 usingSyncIterator 为 ?
- 否则，
- 将 iteratorRecord 设置为 ?
GetIteratorFromMethod (items, usingAsyncIterator)。
- 将 iteratorRecord 设置为 ?
- 如果 iteratorRecord 不是
undefined ，则- 如果
IsConstructor (ctor) 是true ，则- 令 array 为 ?
Construct (ctor)。
- 令 array 为 ?
- 否则，
- 令 array 为 !
ArrayCreate (0)。
- 令 array 为 !
- 令 k 为 0。
- 重复，
- 如果 k ≥ 253 - 1，则
- 令 error 为
ThrowCompletion (一个新创建的TypeError 对象)。 - 返回 ?
AsyncIteratorClose (iteratorRecord, error)。
- 令 error 为
- 令 propertyKey 为 !
ToString (𝔽 (k))。 - 令 nextResult 为 ?
Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]])。 - 将 nextResult 设置为 ?
Await (nextResult)。 - 如果 nextResult 不是 Object，则抛出
TypeError 异常。 - 令 done 为 ?
IteratorComplete (nextResult)。 - 如果 done 是
true ，则 - 令 nextValue 为 ?
IteratorValue (nextResult)。 - 如果 mapping 是
true ，则- 令 mappedValue 为
Completion (Call (mapper, thisArg, « nextValue,𝔽 (k) »))。 IfAbruptCloseAsyncIterator (mappedValue, iteratorRecord)。- 将 mappedValue 设置为
Completion (Await (mappedValue))。 IfAbruptCloseAsyncIterator (mappedValue, iteratorRecord)。
- 令 mappedValue 为
- 否则，
- 令 mappedValue 为 nextValue。
- 令 defineStatus 为
Completion (CreateDataPropertyOrThrow (array, propertyKey, mappedValue))。 IfAbruptCloseAsyncIterator (defineStatus, iteratorRecord)。- 将 k 设置为 k + 1。
- 如果 k ≥ 253 - 1，则
- 如果
- 否则，
- 注：items 既不是异步可迭代也不是可迭代，因此假定它是一个
类数组对象 。 - 令 arrayLike 为 !
ToObject (items)。 - 令 length 为 ?
LengthOfArrayLike (arrayLike)。 - 如果
IsConstructor (ctor) 是true ，则 - 否则，
- 令 array 为 ?
ArrayCreate (length)。
- 令 array 为 ?
- 令 k 为 0。
- 重复，只要 k < length，
- 令 propertyKey 为 !
ToString (𝔽 (k))。 - 令 kValue 为 ?
Get (arrayLike, propertyKey)。 - 将 kValue 设置为 ?
Await (kValue)。 - 如果 mapping 是
true ，则 - 否则，
- 令 mappedValue 为 kValue。
- 执行 ?
CreateDataPropertyOrThrow (array, propertyKey, mappedValue)。 - 将 k 设置为 k + 1。
- 令 propertyKey 为 !
- 执行 ?
Set (array,"length" ,𝔽 (length),true )。 - 返回 array。
- 注：items 既不是异步可迭代也不是可迭代，因此假定它是一个
此方法是有意设计为泛型的工厂方法；它不要求其
23.1.2.3 Array.isArray ( arg )
此函数在被调用时执行以下步骤：
- 返回 ?
IsArray (arg)。
23.1.2.4 Array.of ( ...items )
此方法在被调用时执行以下步骤：
- 令 length 为 items 中元素的数量。
- 令 lengthNumber 为
𝔽 (length)。 - 令 ctor 为
this 值。 - 如果
IsConstructor (ctor) 是true ，则- 令 array 为 ?
Construct (ctor, « lengthNumber »)。
- 令 array 为 ?
- 否则，
- 令 array 为 ?
ArrayCreate (length)。
- 令 array 为 ?
- 令 k 为 0。
- 重复，只要 k < length，
- 令 kValue 为 items[k]。
- 令 propertyKey 为 !
ToString (𝔽 (k))。 - 执行 ?
CreateDataPropertyOrThrow (array, propertyKey, kValue)。 - 将 k 设置为 k + 1。
- 执行 ?
Set (array,"length" , lengthNumber,true )。 - 返回 array。
此方法是有意设计为泛型的工厂方法；它不要求其
23.1.2.5 Array.prototype
Array.prototype 的值是
此属性具有特性 { [[Writable]]:
23.1.2.6 get Array [ %Symbol.species% ]
Array[%Symbol.species%] 是
- 返回
this 值。
此函数的
Array 原型方法通常使用其
23.1.3 Array 原型对象的属性
Array 原型对象：
- 是 %Array.prototype%。
- 是 Array 奇异对象，并具有为这类对象指定的内部方法。
- 具有一个
"length" 属性，其初始值为+0 𝔽，并且其特性为 { [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }。 - 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。
Array 原型对象被指定为 Array 奇异对象，是为了确保与 ECMAScript 2015 规范之前创建的 ECMAScript 代码兼容。
23.1.3.1 Array.prototype.at ( index )
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 令 relativeIndex 为 ?
ToIntegerOrInfinity (index)。 - 如果 relativeIndex ≥ 0，则
- 令 k 为 relativeIndex。
- 否则，
- 令 k 为 length + relativeIndex。
- 如果 k < 0 或 k ≥ length，则返回
undefined 。 - 返回 ?
Get (obj, !ToString (𝔽 (k)))。
23.1.3.2 Array.prototype.concat ( ...items )
此方法返回一个数组，其中
它在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 array 为 ?
ArraySpeciesCreate (obj, 0)。 - 令 nextIndex 为 0。
- 将 obj 前置到 items。
- 对 items 的每个元素 item，执行：
- 令 spreadable 为 ?
IsConcatSpreadable (item)。 - 如果 spreadable 是
true ，则- 令 length 为 ?
LengthOfArrayLike (item)。 - 如果 nextIndex + length > 253 - 1，则抛出
TypeError 异常。 - 令 sourceIndex 为 0。
- 重复，只要 sourceIndex < length，
- 令 propertyKey 为 !
ToString (𝔽 (sourceIndex))。 - 令 exists 为 ?
HasProperty (item, propertyKey)。 - 如果 exists 是
true ，则- 令 subElement 为 ?
Get (item, propertyKey)。 - 执行 ?
CreateDataPropertyOrThrow (array, !ToString (𝔽 (nextIndex)), subElement)。
- 令 subElement 为 ?
- 将 nextIndex 设置为 nextIndex + 1。
- 将 sourceIndex 设置为 sourceIndex + 1。
- 令 propertyKey 为 !
- 令 length 为 ?
- 否则，
- 注：item 会作为单个项添加，而不是被展开。
- 如果 nextIndex ≥ 253 - 1，则抛出
TypeError 异常。 - 执行 ?
CreateDataPropertyOrThrow (array, !ToString (𝔽 (nextIndex)), item)。 - 将 nextIndex 设置为 nextIndex + 1。
- 令 spreadable 为 ?
- 执行 ?
Set (array,"length" ,𝔽 (nextIndex),true )。 - 返回 array。
此方法的
步骤
此方法有意设计为泛型的；它不要求其
23.1.3.2.1 IsConcatSpreadable ( obj )
The abstract operation IsConcatSpreadable takes argument obj (an ECMAScript language value) and returns either a normal completion containing a Boolean or a throw completion. It performs the following steps when called:
- 如果 obj 不是 Object，则返回
false 。 - 令 spreadable 为 ?
Get (obj,%Symbol.isConcatSpreadable% )。 - 如果 spreadable 不是
undefined ，则返回ToBoolean (spreadable)。 - 返回 ?
IsArray (obj)。
23.1.3.3 Array.prototype.constructor
Array.prototype.constructor 的初始值是
23.1.3.4 Array.prototype.copyWithin ( target, start [ , end ] )
end 实参是可选的。如果未提供，则使用
如果 target 为负，则将其视为
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 令 relativeTarget 为 ?
ToIntegerOrInfinity (target)。 - 如果 relativeTarget = -∞，则令 to 为 0。
- 否则，如果 relativeTarget < 0，则令 to 为
max (length + relativeTarget, 0)。 - 否则，令 to 为
min (relativeTarget, length)。 - 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 relativeStart = -∞，则令 from 为 0。
- 否则，如果 relativeStart < 0，则令 from 为
max (length + relativeStart, 0)。 - 否则，令 from 为
min (relativeStart, length)。 - 如果 end 是
undefined ，则令 relativeEnd 为 length；否则令 relativeEnd 为 ?ToIntegerOrInfinity (end)。 - 如果 relativeEnd = -∞，则令 final 为 0。
- 否则，如果 relativeEnd < 0，则令 final 为
max (length + relativeEnd, 0)。 - 否则，令 final 为
min (relativeEnd, length)。 - 令 count 为
min (final - from, length - to)。 - 如果 from < to 且 to < from + count，则
- 令 direction 为 -1。
- 将 from 设置为 from + count - 1。
- 将 to 设置为 to + count - 1。
- 否则，
- 令 direction 为 1。
- 重复，只要 count > 0，
- 令 fromKey 为 !
ToString (𝔽 (from))。 - 令 toKey 为 !
ToString (𝔽 (to))。 - 令 fromPresent 为 ?
HasProperty (obj, fromKey)。 - 如果 fromPresent 是
true ，则 - 否则，
- 断言：fromPresent 是
false 。 - 执行 ?
DeletePropertyOrThrow (obj, toKey)。
- 断言：fromPresent 是
- 将 from 设置为 from + direction。
- 将 to 设置为 to + direction。
- 将 count 设置为 count - 1。
- 令 fromKey 为 !
- 返回 obj。
此方法有意设计为泛型的；它不要求其
23.1.3.5 Array.prototype.entries ( )
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 返回
CreateArrayIterator (obj,key+value )。
23.1.3.6 Array.prototype.every ( callback [ , thisArg ] )
callback 应当是一个接受三个实参并返回可强制转换为 Boolean 值的值的函数。every 会按升序为数组中每个存在的元素调用一次 callback，直到找到一个 callback 返回 every 立即返回 every 返回
如果提供了 thisArg 参数，则它会被用作每次调用 callback 时的
callback 会以三个实参调用：元素的值、元素的索引，以及正在遍历的对象。
every 不会直接改变调用它的对象，但该对象可能会被对 callback 的调用改变。
every 处理的元素范围会在第一次调用 callback 之前确定。在对 every 的调用开始之后追加到数组中的元素，不会被 callback 访问。如果数组中已有元素被改变，传给 callback 的值将是 every 访问它们时的值；在对 every 的调用开始之后且被访问之前被删除的元素不会被访问。every 的行为类似于数学中的“对于所有”量词。特别是，对于空数组，它返回
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 如果
IsCallable (callback) 是false ，则抛出TypeError 异常。 - 令 k 为 0。
- 重复，只要 k < length，
- 返回
true 。
此方法有意设计为泛型的；它不要求其
23.1.3.7 Array.prototype.fill ( value [ , start [ , end ] ] )
start 实参是可选的。如果未提供，则使用
end 实参是可选的。如果未提供，则使用
如果 start 为负，则将其视为
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 relativeStart = -∞，则令 k 为 0。
- 否则，如果 relativeStart < 0，则令 k 为
max (length + relativeStart, 0)。 - 否则，令 k 为
min (relativeStart, length)。 - 如果 end 是
undefined ，则令 relativeEnd 为 length；否则令 relativeEnd 为 ?ToIntegerOrInfinity (end)。 - 如果 relativeEnd = -∞，则令 final 为 0。
- 否则，如果 relativeEnd < 0，则令 final 为
max (length + relativeEnd, 0)。 - 否则，令 final 为
min (relativeEnd, length)。 - 重复，只要 k < final，
- 返回 obj。
此方法有意设计为泛型的；它不要求其
23.1.3.8 Array.prototype.filter ( callback [ , thisArg ] )
callback 应当是一个接受三个实参并返回可强制转换为 Boolean 值的值的函数。filter 会按升序为数组中每个元素调用一次 callback，并构造一个
如果提供了 thisArg 参数，则它会被用作每次调用 callback 时的
callback 会以三个实参调用：元素的值、元素的索引，以及正在遍历的对象。
filter 不会直接改变调用它的对象，但该对象可能会被对 callback 的调用改变。
filter 处理的元素范围会在第一次调用 callback 之前确定。在对 filter 的调用开始之后追加到数组中的元素，不会被 callback 访问。如果数组中已有元素被改变，传给 callback 的值将是 filter 访问它们时的值；在对 filter 的调用开始之后且被访问之前被删除的元素不会被访问。
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 如果
IsCallable (callback) 是false ，则抛出TypeError 异常。 - 令 array 为 ?
ArraySpeciesCreate (obj, 0)。 - 令 k 为 0。
- 令 to 为 0。
- 重复，只要 k < length，
- 令 propertyKey 为 !
ToString (𝔽 (k))。 - 令 kPresent 为 ?
HasProperty (obj, propertyKey)。 - 如果 kPresent 是
true ，则 - 将 k 设置为 k + 1。
- 令 propertyKey 为 !
- 返回 array。
此方法有意设计为泛型的；它不要求其
23.1.3.9 Array.prototype.find ( predicate [ , thisArg ] )
此方法会按索引升序为数组的每个元素调用一次 predicate，直到找到一个 predicate 返回会被强制转换为 find 立即返回该元素值。否则，find 返回
更多信息见
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 令 findRecord 为 ?
FindViaPredicate (obj, length,ascending , predicate, thisArg)。 - 返回 findRecord.[[Value]]。
此方法有意设计为泛型的；它不要求其
23.1.3.10 Array.prototype.findIndex ( predicate [ , thisArg ] )
此方法会按索引升序为数组的每个元素调用一次 predicate，直到找到一个 predicate 返回会被强制转换为 findIndex 立即返回该元素值的索引。否则，findIndex 返回 -1。
更多信息见
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 令 findRecord 为 ?
FindViaPredicate (obj, length,ascending , predicate, thisArg)。 - 返回 findRecord.[[Index]]。
此方法有意设计为泛型的；它不要求其
23.1.3.11 Array.prototype.findLast ( predicate [ , thisArg ] )
此方法会按索引降序为数组的每个元素调用一次 predicate，直到找到一个 predicate 返回会被强制转换为 findLast 立即返回该元素值。否则，findLast 返回
更多信息见
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 令 findRecord 为 ?
FindViaPredicate (obj, length,descending , predicate, thisArg)。 - 返回 findRecord.[[Value]]。
此方法有意设计为泛型的；它不要求其
23.1.3.12 Array.prototype.findLastIndex ( predicate [ , thisArg ] )
此方法会按索引降序为数组的每个元素调用一次 predicate，直到找到一个 predicate 返回会被强制转换为 findLastIndex 立即返回该元素值的索引。否则，findLastIndex 返回 -1。
更多信息见
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 令 findRecord 为 ?
FindViaPredicate (obj, length,descending , predicate, thisArg)。 - 返回 findRecord.[[Index]]。
此方法有意设计为泛型的；它不要求其
23.1.3.12.1 FindViaPredicate ( obj, length, direction, predicate, thisArg )
The abstract operation FindViaPredicate takes arguments obj (an Object), length (a non-negative
obj 应当是
predicate 应当是一个函数。为数组的某个元素调用时，会传入三个实参：元素的值、元素的索引，以及正在遍历的对象。其返回值会被强制转换为 Boolean 值。
thisArg 会被用作每次调用 predicate 时的
此操作不会直接改变调用它的对象，但该对象可能会被对 predicate 的调用改变。
处理的元素范围会在第一次调用 predicate 之前、即遍历开始前确定。在此之后追加到数组中的元素不会被 predicate 访问。如果数组中已有元素被改变，传给 predicate 的值将是此操作访问它们时的值。在遍历开始之后且被访问之前被删除的元素仍会被访问，并且要么从原型查找，要么为
It performs the following steps when called:
- 如果
IsCallable (predicate) 是false ，则抛出TypeError 异常。 - 如果 direction 是
ascending ，则 - 否则，
- 对 indices 的每个整数 k，执行：
- 返回
Record { [[Index]]:-1 𝔽, [[Value]]:undefined }。
23.1.3.13 Array.prototype.flat ( [ depth ] )
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 sourceLength 为 ?
LengthOfArrayLike (obj)。 - 令 depthNumber 为 1。
- 如果 depth 不是
undefined ，则- 将 depthNumber 设置为 ?
ToIntegerOrInfinity (depth)。 - 如果 depthNumber < 0，则将 depthNumber 设置为 0。
- 将 depthNumber 设置为 ?
- 令 array 为 ?
ArraySpeciesCreate (obj, 0)。 - 执行 ?
FlattenIntoArray (array, obj, sourceLength, 0, depthNumber)。 - 返回 array。
23.1.3.13.1 FlattenIntoArray ( target, source, sourceLength, start, depth [ , mapperFunc [ , thisArg ] ] )
The abstract operation FlattenIntoArray takes arguments target (an Object), source (an Object), sourceLength (a non-negative
- 断言：如果 mapperFunc 存在，则
IsCallable (mapperFunc) 是true ，thisArg 存在，且 depth 是 1。 - 令 targetIndex 为 start。
- 令 sourceIndex 为
+0 𝔽。 - 重复，只要
ℝ (sourceIndex) < sourceLength，- 令 propertyKey 为 !
ToString (sourceIndex)。 - 令 exists 为 ?
HasProperty (source, propertyKey)。 - 如果 exists 是
true ，则- 令 element 为 ?
Get (source, propertyKey)。 - 如果 mapperFunc 存在，则
- 将 element 设置为 ?
Call (mapperFunc, thisArg, « element, sourceIndex, source »)。
- 将 element 设置为 ?
- 令 shouldFlatten 为
false 。 - 如果 depth > 0，则
- 将 shouldFlatten 设置为 ?
IsArray (element)。
- 将 shouldFlatten 设置为 ?
- 如果 shouldFlatten 是
true ，则- 如果 depth = +∞，则令 newDepth 为 +∞。
- 否则，令 newDepth 为 depth - 1。
- 令 elementLength 为 ?
LengthOfArrayLike (element)。 - 将 targetIndex 设置为 ?
FlattenIntoArray (target, element, elementLength, targetIndex, newDepth)。
- 否则，
- 如果 targetIndex ≥ 253 - 1，则抛出
TypeError 异常。 - 执行 ?
CreateDataPropertyOrThrow (target, !ToString (𝔽 (targetIndex)), element)。 - 将 targetIndex 设置为 targetIndex + 1。
- 如果 targetIndex ≥ 253 - 1，则抛出
- 令 element 为 ?
- 将 sourceIndex 设置为 sourceIndex +
1 𝔽。
- 令 propertyKey 为 !
- 返回 targetIndex。
23.1.3.14 Array.prototype.flatMap ( mapperFunc [ , thisArg ] )
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 sourceLength 为 ?
LengthOfArrayLike (obj)。 - 如果
IsCallable (mapperFunc) 是false ，则抛出TypeError 异常。 - 令 array 为 ?
ArraySpeciesCreate (obj, 0)。 - 执行 ?
FlattenIntoArray (array, obj, sourceLength, 0, 1, mapperFunc, thisArg)。 - 返回 array。
23.1.3.15 Array.prototype.forEach ( callback [ , thisArg ] )
callback 应当是一个接受三个实参的函数。forEach 会按升序为数组中每个存在的元素调用一次 callback。callback 只会对数组中实际存在的元素调用；不会对数组中缺失的元素调用。
如果提供了 thisArg 参数，则它会被用作每次调用 callback 时的
callback 会以三个实参调用：元素的值、元素的索引，以及正在遍历的对象。
forEach 不会直接改变调用它的对象，但该对象可能会被对 callback 的调用改变。
forEach 处理的元素范围会在第一次调用 callback 之前确定。在对 forEach 的调用开始之后追加到数组中的元素，不会被 callback 访问。如果数组中已有元素被改变，传给 callback 的值将是 forEach 访问它们时的值；在对 forEach 的调用开始之后且被访问之前被删除的元素不会被访问。
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 如果
IsCallable (callback) 是false ，则抛出TypeError 异常。 - 令 k 为 0。
- 重复，只要 k < length，
- 返回
undefined 。
此方法有意设计为泛型的；它不要求其
23.1.3.16 Array.prototype.includes ( searchElement [ , fromIndex ] )
此方法使用
可选第二实参 fromIndex 默认为
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 如果 length = 0，则返回
false 。 - 令 startIndex 为 ?
ToIntegerOrInfinity (fromIndex)。 - 断言：如果 fromIndex 是
undefined ，则 startIndex 是 0。 - 如果 startIndex = +∞，则返回
false 。 - 如果 startIndex = -∞，则将 startIndex 设置为 0。
- 如果 startIndex ≥ 0，则
- 令 k 为 startIndex。
- 否则，
- 令 k 为 length + startIndex。
- 如果 k < 0，则将 k 设置为 0。
- 重复，只要 k < length，
- 令 elementK 为 ?
Get (obj, !ToString (𝔽 (k)))。 - 如果
SameValueZero (searchElement, elementK) 是true ，则返回true 。 - 将 k 设置为 k + 1。
- 令 elementK 为 ?
- 返回
false 。
此方法有意设计为泛型的；它不要求其
此方法有意在两个方面不同于类似的 indexOf 方法。首先，它使用
23.1.3.17 Array.prototype.indexOf ( searchElement [ , fromIndex ] )
此方法使用
可选第二实参 fromIndex 默认为
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 如果 length = 0，则返回
-1 𝔽。 - 令 startIndex 为 ?
ToIntegerOrInfinity (fromIndex)。 - 断言：如果 fromIndex 是
undefined ，则 startIndex 是 0。 - 如果 startIndex = +∞，则返回
-1 𝔽。 - 如果 startIndex = -∞，则将 startIndex 设置为 0。
- 如果 startIndex ≥ 0，则
- 令 k 为 startIndex。
- 否则，
- 令 k 为 length + startIndex。
- 如果 k < 0，则将 k 设置为 0。
- 重复，只要 k < length，
- 令 propertyKey 为 !
ToString (𝔽 (k))。 - 令 kPresent 为 ?
HasProperty (obj, propertyKey)。 - 如果 kPresent 是
true ，则- 令 elementK 为 ?
Get (obj, propertyKey)。 - 如果
IsStrictlyEqual (searchElement, elementK) 是true ，则返回𝔽 (k)。
- 令 elementK 为 ?
- 将 k 设置为 k + 1。
- 令 propertyKey 为 !
- 返回
-1 𝔽。
此方法有意设计为泛型的；它不要求其
23.1.3.18 Array.prototype.join ( separator )
此方法将数组的元素转换为 String，然后将这些 String 连接起来，并由 separator 的出现分隔。如果未提供 separator，则使用单个逗号作为 separator。
它在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 如果 separator 是
undefined ，则令 sep 为"," 。 - 否则，令 sep 为 ?
ToString (separator)。 - 令 result 为空 String。
- 令 k 为 0。
- 重复，只要 k < length，
- 返回 result。
此方法有意设计为泛型的；它不要求其
23.1.3.19 Array.prototype.keys ( )
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 返回
CreateArrayIterator (obj,key )。
23.1.3.20 Array.prototype.lastIndexOf ( searchElement [ , fromIndex ] )
此方法使用
可选第二实参 fromIndex 默认为数组长度减一（即搜索整个数组）。如果它大于或等于数组长度，则会搜索整个数组。如果它小于
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 如果 length = 0，则返回
-1 𝔽。 - 如果 fromIndex 存在，则令 startIndex 为 ?
ToIntegerOrInfinity (fromIndex)；否则令 startIndex 为 length - 1。 - 如果 startIndex = -∞，则返回
-1 𝔽。 - 如果 startIndex ≥ 0，则
- 令 k 为
min (startIndex, length - 1)。
- 令 k 为
- 否则，
- 令 k 为 length + startIndex。
- 重复，只要 k ≥ 0，
- 令 propertyKey 为 !
ToString (𝔽 (k))。 - 令 kPresent 为 ?
HasProperty (obj, propertyKey)。 - 如果 kPresent 是
true ，则- 令 elementK 为 ?
Get (obj, propertyKey)。 - 如果
IsStrictlyEqual (searchElement, elementK) 是true ，则返回𝔽 (k)。
- 令 elementK 为 ?
- 将 k 设置为 k - 1。
- 令 propertyKey 为 !
- 返回
-1 𝔽。
此方法有意设计为泛型的；它不要求其
23.1.3.21 Array.prototype.map ( callback [ , thisArg ] )
callback 应当是一个接受三个实参的函数。map 会按升序为数组中每个元素调用一次 callback，并根据结果构造一个新的 Array。callback 只会对数组中实际存在的元素调用；不会对数组中缺失的元素调用。
如果提供了 thisArg 参数，则它会被用作每次调用 callback 时的
callback 会以三个实参调用：元素的值、元素的索引，以及正在遍历的对象。
map 不会直接改变调用它的对象，但该对象可能会被对 callback 的调用改变。
map 处理的元素范围会在第一次调用 callback 之前确定。在对 map 的调用开始之后追加到数组中的元素，不会被 callback 访问。如果数组中已有元素被改变，传给 callback 的值将是 map 访问它们时的值；在对 map 的调用开始之后且被访问之前被删除的元素不会被访问。
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 如果
IsCallable (callback) 是false ，则抛出TypeError 异常。 - 令 array 为 ?
ArraySpeciesCreate (obj, length)。 - 令 k 为 0。
- 重复，只要 k < length，
- 令 propertyKey 为 !
ToString (𝔽 (k))。 - 令 kPresent 为 ?
HasProperty (obj, propertyKey)。 - 如果 kPresent 是
true ，则- 令 kValue 为 ?
Get (obj, propertyKey)。 - 令 mappedValue 为 ?
Call (callback, thisArg, « kValue,𝔽 (k), obj »)。 - 执行 ?
CreateDataPropertyOrThrow (array, propertyKey, mappedValue)。
- 令 kValue 为 ?
- 将 k 设置为 k + 1。
- 令 propertyKey 为 !
- 返回 array。
此方法有意设计为泛型的；它不要求其
23.1.3.22 Array.prototype.pop ( )
此方法移除数组的最后一个元素并返回它。
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 如果 length = 0，则
- 执行 ?
Set (obj,"length" ,+0 𝔽,true )。 - 返回
undefined 。
- 执行 ?
- 断言：length > 0。
- 令 newLength 为
𝔽 (length - 1)。 - 令 index 为 !
ToString (newLength)。 - 令 element 为 ?
Get (obj, index)。 - 执行 ?
DeletePropertyOrThrow (obj, index)。 - 执行 ?
Set (obj,"length" , newLength,true )。 - 返回 element。
此方法有意设计为泛型的；它不要求其
23.1.3.23 Array.prototype.push ( ...items )
此方法按实参出现的顺序将它们追加到数组末尾。它返回数组的新长度。
此方法在被调用时执行以下步骤：
此方法的
此方法有意设计为泛型的；它不要求其
23.1.3.24 Array.prototype.reduce ( callback [ , initialValue ] )
callback 应当是一个接受四个实参的函数。reduce 会按升序为数组中每个存在的元素调用一次 callback，除非提供了 initialValue，否则会跳过第一个元素。
callback 会以四个实参调用：previousValue（前一次调用 callback 所得的值）、currentValue（当前元素的值）、currentIndex，以及正在遍历的对象。首次调用 callback 时，previousValue 和 currentValue 可以是两组值之一。如果调用 reduce 时提供了 initialValue，则 previousValue 将是 initialValue，currentValue 将是数组中的第一个值。如果未提供 initialValue，则 previousValue 将是数组中的第一个值，currentValue 将是第二个值。如果数组不
reduce 不会直接改变调用它的对象，但该对象可能会被对 callback 的调用改变。
reduce 处理的元素范围会在第一次调用 callback 之前确定。在对 reduce 的调用开始之后追加到数组中的元素，不会被 callback 访问。如果数组中已有元素被改变，传给 callback 的值将是 reduce 访问它们时的值；在对 reduce 的调用开始之后且被访问之前被删除的元素不会被访问。
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 如果
IsCallable (callback) 是false ，则抛出TypeError 异常。 - 如果 length = 0 且 initialValue 不存在，则抛出
TypeError 异常。 - 令 k 为 0。
- 令 accumulator 为
undefined 。 - 如果 initialValue 存在，则
- 将 accumulator 设置为 initialValue。
- 否则，
- 令 kPresent 为
false 。 - 重复，只要 kPresent 是
false 且 k < length，- 令 propertyKey 为 !
ToString (𝔽 (k))。 - 将 kPresent 设置为 ?
HasProperty (obj, propertyKey)。 - 如果 kPresent 是
true ，则- 将 accumulator 设置为 ?
Get (obj, propertyKey)。
- 将 accumulator 设置为 ?
- 将 k 设置为 k + 1。
- 令 propertyKey 为 !
- 如果 kPresent 是
false ，则抛出TypeError 异常。
- 令 kPresent 为
- 重复，只要 k < length，
- 返回 accumulator。
此方法有意设计为泛型的；它不要求其
23.1.3.25 Array.prototype.reduceRight ( callback [ , initialValue ] )
callback 应当是一个接受四个实参的函数。reduceRight 会按降序为数组中每个存在的元素调用一次 callback，除非提供了 initialValue，否则会跳过第一次调用。
callback 会以四个实参调用：previousValue（前一次调用 callback 所得的值）、currentValue（当前元素的值）、currentIndex，以及正在遍历的对象。首次调用该函数时，previousValue 和 currentValue 可以是两组值之一。如果调用 reduceRight 时提供了 initialValue，则 previousValue 将是 initialValue，currentValue 将是数组中的最后一个值。如果未提供 initialValue，则 previousValue 将是数组中的最后一个值，currentValue 将是倒数第二个值。如果数组不
reduceRight 不会直接改变调用它的对象，但该对象可能会被对 callback 的调用改变。
reduceRight 处理的元素范围会在第一次调用 callback 之前确定。在对 reduceRight 的调用开始之后追加到数组中的元素，不会被 callback 访问。如果数组中已有元素被 callback 改变，传给 callback 的值将是 reduceRight 访问它们时的值；在对 reduceRight 的调用开始之后且被访问之前被删除的元素不会被访问。
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 如果
IsCallable (callback) 是false ，则抛出TypeError 异常。 - 如果 length = 0 且 initialValue 不存在，则抛出
TypeError 异常。 - 令 k 为 length - 1。
- 令 accumulator 为
undefined 。 - 如果 initialValue 存在，则
- 将 accumulator 设置为 initialValue。
- 否则，
- 令 kPresent 为
false 。 - 重复，只要 kPresent 是
false 且 k ≥ 0，- 令 propertyKey 为 !
ToString (𝔽 (k))。 - 将 kPresent 设置为 ?
HasProperty (obj, propertyKey)。 - 如果 kPresent 是
true ，则- 将 accumulator 设置为 ?
Get (obj, propertyKey)。
- 将 accumulator 设置为 ?
- 将 k 设置为 k - 1。
- 令 propertyKey 为 !
- 如果 kPresent 是
false ，则抛出TypeError 异常。
- 令 kPresent 为
- 重复，只要 k ≥ 0，
- 返回 accumulator。
此方法有意设计为泛型的；它不要求其
23.1.3.26 Array.prototype.reverse ( )
此方法重新排列数组元素，以反转它们的顺序。它返回反转后的数组。
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 令 middle 为
floor (length / 2)。 - 令 lower 为 0。
- 重复，只要 lower ≠ middle，
- 令 upper 为 length - lower - 1。
- 令 upperP 为 !
ToString (𝔽 (upper))。 - 令 lowerP 为 !
ToString (𝔽 (lower))。 - 令 lowerExists 为 ?
HasProperty (obj, lowerP)。 - 如果 lowerExists 是
true ，则- 令 lowerValue 为 ?
Get (obj, lowerP)。
- 令 lowerValue 为 ?
- 令 upperExists 为 ?
HasProperty (obj, upperP)。 - 如果 upperExists 是
true ，则- 令 upperValue 为 ?
Get (obj, upperP)。
- 令 upperValue 为 ?
- 如果 lowerExists 是
true 且 upperExists 是true ，则 - 否则，如果 lowerExists 是
false 且 upperExists 是true ，则- 执行 ?
Set (obj, lowerP, upperValue,true )。 - 执行 ?
DeletePropertyOrThrow (obj, upperP)。
- 执行 ?
- 否则，如果 lowerExists 是
true 且 upperExists 是false ，则- 执行 ?
DeletePropertyOrThrow (obj, lowerP)。 - 执行 ?
Set (obj, upperP, lowerValue,true )。
- 执行 ?
- 否则，
- 断言：lowerExists 和 upperExists 都是
false 。 - 注：不需要任何操作。
- 断言：lowerExists 和 upperExists 都是
- 将 lower 设置为 lower + 1。
- 返回 obj。
此方法有意设计为泛型的；它不要求其
23.1.3.27 Array.prototype.shift ( )
此方法移除数组的第一个元素并返回它。
它在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 如果 length = 0，则
- 执行 ?
Set (obj,"length" ,+0 𝔽,true )。 - 返回
undefined 。
- 执行 ?
- 令 first 为 ?
Get (obj,"0" )。 - 令 k 为 1。
- 重复，只要 k < length，
- 令 from 为 !
ToString (𝔽 (k))。 - 令 to 为 !
ToString (𝔽 (k - 1))。 - 令 fromPresent 为 ?
HasProperty (obj, from)。 - 如果 fromPresent 是
true ，则 - 否则，
- 断言：fromPresent 是
false 。 - 执行 ?
DeletePropertyOrThrow (obj, to)。
- 断言：fromPresent 是
- 将 k 设置为 k + 1。
- 令 from 为 !
- 执行 ?
DeletePropertyOrThrow (obj, !ToString (𝔽 (length - 1)))。 - 执行 ?
Set (obj,"length" ,𝔽 (length - 1),true )。 - 返回 first。
此方法有意设计为泛型的；它不要求其
23.1.3.28 Array.prototype.slice ( start, end )
此方法返回一个数组，其中
它在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 relativeStart = -∞，则令 k 为 0。
- 否则，如果 relativeStart < 0，则令 k 为
max (length + relativeStart, 0)。 - 否则，令 k 为
min (relativeStart, length)。 - 如果 end 是
undefined ，则令 relativeEnd 为 length；否则令 relativeEnd 为 ?ToIntegerOrInfinity (end)。 - 如果 relativeEnd = -∞，则令 final 为 0。
- 否则，如果 relativeEnd < 0，则令 final 为
max (length + relativeEnd, 0)。 - 否则，令 final 为
min (relativeEnd, length)。 - 令 count 为
max (final - k, 0)。 - 令 array 为 ?
ArraySpeciesCreate (obj, count)。 - 令 resultIndex 为 0。
- 重复，只要 k < final，
- 令 propertyKey 为 !
ToString (𝔽 (k))。 - 令 kPresent 为 ?
HasProperty (obj, propertyKey)。 - 如果 kPresent 是
true ，则- 令 kValue 为 ?
Get (obj, propertyKey)。 - 执行 ?
CreateDataPropertyOrThrow (array, !ToString (𝔽 (resultIndex)), kValue)。
- 令 kValue 为 ?
- 将 k 设置为 k + 1。
- 将 resultIndex 设置为 resultIndex + 1。
- 令 propertyKey 为 !
- 执行 ?
Set (array,"length" ,𝔽 (resultIndex),true )。 - 返回 array。
步骤
此方法有意设计为泛型的；它不要求其
23.1.3.29 Array.prototype.some ( callback [ , thisArg ] )
callback 应当是一个接受三个实参并返回可强制转换为 Boolean 值的值的函数。some 会按升序为数组中每个存在的元素调用一次 callback，直到找到一个 callback 返回 some 立即返回 some 返回
如果提供了 thisArg 参数，则它会被用作每次调用 callback 时的
callback 会以三个实参调用：元素的值、元素的索引，以及正在遍历的对象。
some 不会直接改变调用它的对象，但该对象可能会被对 callback 的调用改变。
some 处理的元素范围会在第一次调用 callback 之前确定。在对 some 的调用开始之后追加到数组中的元素，不会被 callback 访问。如果数组中已有元素被改变，传给 callback 的值将是 some 访问它们时的值；在对 some 的调用开始之后且被访问之前被删除的元素不会被访问。some 的行为类似于数学中的“存在”量词。特别是，对于空数组，它返回
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 如果
IsCallable (callback) 是false ，则抛出TypeError 异常。 - 令 k 为 0。
- 重复，只要 k < length，
- 返回
false 。
此方法有意设计为泛型的；它不要求其
23.1.3.30 Array.prototype.sort ( comparator )
此方法对该数组的元素排序。如果 comparator 不是
它在被调用时执行以下步骤：
- 如果 comparator 不是
undefined 且IsCallable (comparator) 是false ，则抛出TypeError 异常。 - 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 令 sortCompare 为一个新的
Abstract Closure ，其参数为 (x, y)，捕获 comparator，并在被调用时执行以下步骤：- 返回 ?
CompareArrayElements (x, y, comparator)。
- 返回 ?
- 令 sortedList 为 ?
SortIndexedProperties (obj, length, sortCompare,skip-holes )。 - 令 itemCount 为 sortedList 中元素的数量。
- 令 j 为 0。
- 重复，只要 j < itemCount，
- 注：步骤
5 中对SortIndexedProperties 的调用使用skip-holes 。剩余索引会被删除，以保留在排序中被检测到并排除的空洞数量。 - 重复，只要 j < length，
- 执行 ?
DeletePropertyOrThrow (obj, !ToString (𝔽 (j)))。 - 将 j 设置为 j + 1。
- 执行 ?
- 返回 obj。
由于不存在的属性值总是比较为大于
此方法有意设计为泛型的；它不要求其
23.1.3.30.1 SortIndexedProperties ( obj, length, sortCompare, holes )
The abstract operation SortIndexedProperties takes arguments obj (an Object), length (a non-negative
- 令 items 为新的空
List 。 - 令 k 为 0。
- 重复，只要 k < length，
- 令 propertyKey 为 !
ToString (𝔽 (k))。 - 如果 holes 是
skip-holes ，则- 令 kRead 为 ?
HasProperty (obj, propertyKey)。
- 令 kRead 为 ?
- 否则，
- 断言：holes 是
read-through-holes 。 - 令 kRead 为
true 。
- 断言：holes 是
- 如果 kRead 是
true ，则- 令 kValue 为 ?
Get (obj, propertyKey)。 - 将 kValue 追加到 items。
- 令 kValue 为 ?
- 将 k 设置为 k + 1。
- 令 propertyKey 为 !
- 使用
实现定义的 对 sortCompare 的调用序列对 items 排序。如果任何这样的调用返回突然完成 ，则在执行任何进一步的 sortCompare 调用之前停止，并返回该Completion Record 。 - 返回 items。
排序顺序是上述算法的步骤
除非
-
必须存在某个小于 itemCount 的非负整数的数学排列 π，使得对每个小于 itemCount 的非负整数 j，元素
old[j] 与new[π(j)] 完全相同。 -
然后，对所有小于 itemCount 的非负整数 j 和 k，如果
ℝ (sortCompare(old[j], old[k])) < 0π(j) < π(k) 。 -
并且，对所有满足 j < k < itemCount 的非负整数 j 和 k，如果
ℝ (sortCompare(old[j], old[k])) = 0π(j) < π(k) ；即，排序是稳定的。
这里，记法
如果对集合 values 中所有值 a、b 和 c（可以是同一个值）都满足以下要求，则
-
给定特定的一对值 a 和 b 作为两个实参时，调用 comparator(a, b) 总是返回相同的值 v。此外，v 是 Number，且 v 不是
NaN 。注意，这意味着对于给定的一对 a 和 b，a <C b、a =C b 和 a >C b 中恰好有一个为 true。 - 调用 comparator(a, b) 不会修改 obj 或 obj 原型链上的任何对象。
- a =C a（自反性）
- 如果 a =C b，则 b =C a（对称性）
- 如果 a =C b 且 b =C c，则 a =C c（=C 的传递性）
- 如果 a <C b 且 b <C c，则 a <C c（<C 的传递性）
- 如果 a >C b 且 b >C c，则 a >C c（>C 的传递性）
上述条件是确保 comparator 将集合 values 划分为等价类，且这些等价类被全序排列的充要条件。
23.1.3.30.2 CompareArrayElements ( x, y, comparator )
The abstract operation CompareArrayElements takes arguments x (an ECMAScript language value), y (an ECMAScript language value), and comparator (a function object or
- 如果 x 是
undefined 且 y 是undefined ，则返回+0 𝔽。 - 如果 x 是
undefined ，则返回1 𝔽。 - 如果 y 是
undefined ，则返回-1 𝔽。 - 如果 comparator 不是
undefined ，则 - 令 xString 为 ?
ToString (x)。 - 令 yString 为 ?
ToString (y)。 - 令 xSmaller 为 !
IsLessThan (xString, yString,true )。 - 如果 xSmaller 是
true ，则返回-1 𝔽。 - 令 ySmaller 为 !
IsLessThan (yString, xString,true )。 - 如果 ySmaller 是
true ，则返回1 𝔽。 - 返回
+0 𝔽。
23.1.3.31 Array.prototype.splice ( start, deleteCount, ...items )
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 relativeStart = -∞，则令 actualStart 为 0。
- 否则，如果 relativeStart < 0，则令 actualStart 为
max (length + relativeStart, 0)。 - 否则，令 actualStart 为
min (relativeStart, length)。 - 令 itemCount 为 items 中元素的数量。
- 如果 start 不存在，则
- 令 actualDeleteCount 为 0。
- 否则，如果 deleteCount 不存在，则
- 令 actualDeleteCount 为 length - actualStart。
- 否则，
- 令 dc 为 ?
ToIntegerOrInfinity (deleteCount)。 - 令 actualDeleteCount 为将 dc 夹在 0 与 length - actualStart 之间的结果。
- 令 dc 为 ?
- 如果 length + itemCount - actualDeleteCount > 253 - 1，则抛出
TypeError 异常。 - 令 deletedArray 为 ?
ArraySpeciesCreate (obj, actualDeleteCount)。 - 令 k 为 0。
- 重复，只要 k < actualDeleteCount，
- 令 from 为 !
ToString (𝔽 (actualStart + k))。 - 如果 ?
HasProperty (obj, from) 是true ，则- 令 fromValue 为 ?
Get (obj, from)。 - 执行 ?
CreateDataPropertyOrThrow (deletedArray, !ToString (𝔽 (k)), fromValue)。
- 令 fromValue 为 ?
- 将 k 设置为 k + 1。
- 令 from 为 !
- 执行 ?
Set (deletedArray,"length" ,𝔽 (actualDeleteCount),true )。 - 如果 itemCount < actualDeleteCount，则
- 将 k 设置为 actualStart。
- 重复，只要 k < (length - actualDeleteCount)，
- 令 from 为 !
ToString (𝔽 (k + actualDeleteCount))。 - 令 to 为 !
ToString (𝔽 (k + itemCount))。 - 如果 ?
HasProperty (obj, from) 是true ，则 - 否则，
- 执行 ?
DeletePropertyOrThrow (obj, to)。
- 执行 ?
- 将 k 设置为 k + 1。
- 令 from 为 !
- 将 k 设置为 length。
- 重复，只要 k > (length - actualDeleteCount + itemCount)，
- 执行 ?
DeletePropertyOrThrow (obj, !ToString (𝔽 (k - 1)))。 - 将 k 设置为 k - 1。
- 执行 ?
- 否则，如果 itemCount > actualDeleteCount，则
- 将 k 设置为 (length - actualDeleteCount)。
- 重复，只要 k > actualStart，
- 令 from 为 !
ToString (𝔽 (k + actualDeleteCount - 1))。 - 令 to 为 !
ToString (𝔽 (k + itemCount - 1))。 - 如果 ?
HasProperty (obj, from) 是true ，则 - 否则，
- 执行 ?
DeletePropertyOrThrow (obj, to)。
- 执行 ?
- 将 k 设置为 k - 1。
- 令 from 为 !
- 将 k 设置为 actualStart。
- 对 items 的每个元素 item，执行：
- 执行 ?
Set (obj,"length" ,𝔽 (length - actualDeleteCount + itemCount),true )。 - 返回 deletedArray。
此方法有意设计为泛型的；它不要求其
23.1.3.32 Array.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
ECMA-402 第一版没有
此方法可选参数的含义在 ECMA-402 规范中定义；不
此方法在被调用时执行以下步骤：
- 令 array 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (array)。 - 令 separator 为适用于
宿主环境 当前区域设置的实现定义的 列表分隔符 String 值（例如", " ）。 - 令 result 为空 String。
- 令 k 为 0。
- 重复，只要 k < length，
- 返回 result。
此方法有意设计为泛型的；它不要求其
23.1.3.33 Array.prototype.toReversed ( )
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 令 array 为 ?
ArrayCreate (length)。 - 令 k 为 0。
- 重复，只要 k < length，
- 返回 array。
23.1.3.34 Array.prototype.toSorted ( comparator )
此方法在被调用时执行以下步骤：
- 如果 comparator 不是
undefined 且IsCallable (comparator) 是false ，则抛出TypeError 异常。 - 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 令 array 为 ?
ArrayCreate (length)。 - 令 sortCompare 为一个新的
Abstract Closure ，其参数为 (x, y)，捕获 comparator，并在被调用时执行以下步骤：- 返回 ?
CompareArrayElements (x, y, comparator)。
- 返回 ?
- 令 sortedList 为 ?
SortIndexedProperties (obj, length, sortCompare,read-through-holes )。 - 令 j 为 0。
- 重复，只要 j < length，
- 执行 !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (j)), sortedList[j])。 - 将 j 设置为 j + 1。
- 执行 !
- 返回 array。
23.1.3.35 Array.prototype.toSpliced ( start, skipCount, ...items )
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 relativeStart = -∞，则令 actualStart 为 0。
- 否则，如果 relativeStart < 0，则令 actualStart 为
max (length + relativeStart, 0)。 - 否则，令 actualStart 为
min (relativeStart, length)。 - 令 insertCount 为 items 中元素的数量。
- 如果 start 不存在，则
- 令 actualSkipCount 为 0。
- 否则，如果 skipCount 不存在，则
- 令 actualSkipCount 为 length - actualStart。
- 否则，
- 令 sc 为 ?
ToIntegerOrInfinity (skipCount)。 - 令 actualSkipCount 为将 sc 夹在 0 与 length - actualStart 之间的结果。
- 令 sc 为 ?
- 令 newLength 为 length + insertCount - actualSkipCount。
- 如果 newLength > 253 - 1，则抛出
TypeError 异常。 - 令 newArray 为 ?
ArrayCreate (newLength)。 - 令 writeIndex 为 0。
- 令 readIndex 为 actualStart + actualSkipCount。
- 重复，只要 writeIndex < actualStart，
- 令 propertyKey 为 !
ToString (𝔽 (writeIndex))。 - 令 iValue 为 ?
Get (obj, propertyKey)。 - 执行 !
CreateDataPropertyOrThrow (newArray, propertyKey, iValue)。 - 将 writeIndex 设置为 writeIndex + 1。
- 令 propertyKey 为 !
- 对 items 的每个元素 item，执行：
- 令 propertyKey 为 !
ToString (𝔽 (writeIndex))。 - 执行 !
CreateDataPropertyOrThrow (newArray, propertyKey, item)。 - 将 writeIndex 设置为 writeIndex + 1。
- 令 propertyKey 为 !
- 重复，只要 writeIndex < newLength，
- 返回 newArray。
23.1.3.36 Array.prototype.toString ( )
此方法在被调用时执行以下步骤：
- 令 array 为 ?
ToObject (this value)。 - 令 func 为 ?
Get (array,"join" )。 - 如果
IsCallable (func) 是false ，则将 func 设置为内部函数 %Object.prototype.toString%。 - 返回 ?
Call (func, array)。
此方法有意设计为泛型的；它不要求其
23.1.3.37 Array.prototype.unshift ( ...items )
此方法把实参前置到数组开头，使它们在数组中的顺序与它们在实参列表中出现的顺序相同。
它在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 令 argCount 为 items 中元素的数量。
- 如果 argCount > 0，则
- 如果 length + argCount > 253 - 1，则抛出
TypeError 异常。 - 令 k 为 length。
- 重复，只要 k > 0，
- 令 from 为 !
ToString (𝔽 (k - 1))。 - 令 to 为 !
ToString (𝔽 (k + argCount - 1))。 - 令 fromPresent 为 ?
HasProperty (obj, from)。 - 如果 fromPresent 是
true ，则 - 否则，
- 断言：fromPresent 是
false 。 - 执行 ?
DeletePropertyOrThrow (obj, to)。
- 断言：fromPresent 是
- 将 k 设置为 k - 1。
- 令 from 为 !
- 令 j 为
+0 𝔽。 - 对 items 的每个元素 item，执行：
- 如果 length + argCount > 253 - 1，则抛出
- 执行 ?
Set (obj,"length" ,𝔽 (length + argCount),true )。 - 返回
𝔽 (length + argCount)。
此方法的
此方法有意设计为泛型的；它不要求其
23.1.3.38 Array.prototype.values ( )
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 返回
CreateArrayIterator (obj,value )。
23.1.3.39 Array.prototype.with ( index, value )
此方法在被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (this value)。 - 令 length 为 ?
LengthOfArrayLike (obj)。 - 令 relativeIndex 为 ?
ToIntegerOrInfinity (index)。 - 如果 relativeIndex ≥ 0，则令 actualIndex 为 relativeIndex。
- 否则，令 actualIndex 为 length + relativeIndex。
- 如果 actualIndex ≥ length 或 actualIndex < 0，则抛出
RangeError 异常。 - 令 array 为 ?
ArrayCreate (length)。 - 令 k 为 0。
- 重复，只要 k < length，
- 令 propertyKey 为 !
ToString (𝔽 (k))。 - 如果 k = actualIndex，则令 fromValue 为 value。
- 否则，令 fromValue 为 ?
Get (obj, propertyKey)。 - 执行 !
CreateDataPropertyOrThrow (array, propertyKey, fromValue)。 - 将 k 设置为 k + 1。
- 令 propertyKey 为 !
- 返回 array。
23.1.3.40 Array.prototype [ %Symbol.iterator% ] ( )
23.1.3.41 Array.prototype [ %Symbol.unscopables% ]
- 令 unscopableList 为
OrdinaryObjectCreate (null )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"at" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"copyWithin" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"entries" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"fill" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"find" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"findIndex" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"findLast" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"findLastIndex" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"flat" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"flatMap" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"includes" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"keys" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"toReversed" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"toSorted" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"toSpliced" ,true )。 - 执行 !
CreateDataPropertyOrThrow (unscopableList,"values" ,true )。 - 返回 unscopableList。
此属性具有特性 { [[Writable]]:
23.1.4 Array 实例的属性
Array 实例是 Array 奇异对象，并具有为这类对象指定的内部方法。Array 实例继承自
Array 实例具有一个
23.1.4.1 length
Array 实例的
23.1.5 Array Iterator 对象
Array Iterator 是表示对某个特定 Array 实例对象进行特定迭代的对象。Array Iterator 对象没有具名构造器。相反，Array Iterator 对象通过调用 Array 实例对象的某些方法创建。
23.1.5.1 CreateArrayIterator ( array, kind )
The abstract operation CreateArrayIterator takes arguments array (an Object) and kind (
- 令 iterator 为
OrdinaryObjectCreate (%ArrayIteratorPrototype% , « [[IteratedArrayLike]], [[ArrayLikeNextIndex]], [[ArrayLikeIterationKind]] »)。 - 将 iterator.[[IteratedArrayLike]] 设置为 array。
- 将 iterator.[[ArrayLikeNextIndex]] 设置为 0。
- 将 iterator.[[ArrayLikeIterationKind]] 设置为 kind。
- 返回 iterator。
23.1.5.2 %ArrayIteratorPrototype% 对象
%ArrayIteratorPrototype% 对象：
- 具有由所有
Array Iterator 对象继承的属性。 - 是
普通对象 。 - 具有一个 [[Prototype]] 内部槽，其值为
%Iterator.prototype% 。 - 具有以下属性：
23.1.5.2.1 %ArrayIteratorPrototype%.next ( )
- 令 iteratorObj 为
this 值。 - 如果 iteratorObj 不是 Object，则抛出
TypeError 异常。 - 如果 iteratorObj 不具有
Array Iterator Instance（23.1.5.3 ）的所有内部槽，则抛出TypeError 异常。 - 令 array 为 iteratorObj.[[IteratedArrayLike]]。
- 如果 array 是
undefined ，则返回CreateIteratorResultObject (undefined ,true )。 - 令 index 为 iteratorObj.[[ArrayLikeNextIndex]]。
- 令 kind 为 iteratorObj.[[ArrayLikeIterationKind]]。
- 如果 array 具有 [[TypedArrayName]] 内部槽，则
- 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (array,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (taRecord) 是true ，则抛出TypeError 异常。 - 令 length 为
TypedArrayLength (taRecord)。
- 令 taRecord 为
- 否则，
- 令 length 为 ?
LengthOfArrayLike (array)。
- 令 length 为 ?
- 如果 index ≥ length，则
- 将 iteratorObj.[[IteratedArrayLike]] 设置为
undefined 。 - 返回
CreateIteratorResultObject (undefined ,true )。
- 将 iteratorObj.[[IteratedArrayLike]] 设置为
- 将 iteratorObj.[[ArrayLikeNextIndex]] 设置为 index + 1。
- 令 indexNumber 为
𝔽 (index)。 - 如果 kind 是
key ，则- 令 result 为 indexNumber。
- 否则，
- 令 elementKey 为 !
ToString (indexNumber)。 - 令 elementValue 为 ?
Get (array, elementKey)。 - 如果 kind 是
value ，则- 令 result 为 elementValue。
- 否则，
- 断言：kind 是
key+value 。 - 令 result 为
CreateArrayFromList (« indexNumber, elementValue »)。
- 断言：kind 是
- 令 elementKey 为 !
- 返回
CreateIteratorResultObject (result,false )。
23.1.5.2.2 %ArrayIteratorPrototype% [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
23.1.5.3 Array Iterator 实例的属性
| 内部槽 | 类型 | 描述 |
|---|---|---|
| [[IteratedArrayLike]] |
an Object or |
正在迭代的 |
| [[ArrayLikeNextIndex]] |
a non-negative |
此迭代器将要检查的下一个元素的 |
| [[ArrayLikeIterationKind]] |
|
标识迭代的每个元素返回什么内容的值。 |
23.2 TypedArray 对象
TypedArray 呈现底层二进制数据缓冲区（
| 构造器名称和固有对象 | 元素类型 | 元素大小 | 转换操作 | 描述 |
|---|---|---|---|---|
|
Int8Array %Int8Array% |
|
1 |
|
8 位二进制补码有符号整数 |
|
Uint8Array %Uint8Array% |
|
1 |
|
8 位无符号整数 |
|
Uint8ClampedArray %Uint8ClampedArray% |
|
1 |
|
8 位无符号整数（夹取转换） |
|
Int16Array %Int16Array% |
|
2 |
|
16 位二进制补码有符号整数 |
|
Uint16Array %Uint16Array% |
|
2 |
|
16 位无符号整数 |
|
Int32Array %Int32Array% |
|
4 |
|
32 位二进制补码有符号整数 |
|
Uint32Array %Uint32Array% |
|
4 |
|
32 位无符号整数 |
|
BigInt64Array %BigInt64Array% |
|
8 |
|
64 位二进制补码有符号整数 |
|
BigUint64Array %BigUint64Array% |
|
8 |
|
64 位无符号整数 |
|
Float16Array %Float16Array% |
|
2 | 16 位 IEEE 浮点数 | |
|
Float32Array %Float32Array% |
|
4 | 32 位 IEEE 浮点数 | |
|
Float64Array %Float64Array% |
|
8 | 64 位 IEEE 浮点数 |
在下面的定义中，对 TypedArray 的引用应替换为上表中的相应构造器名称。
23.2.1 %TypedArray% 固有对象
%TypedArray% 固有对象：
- 是所有 TypedArray 构造器对象都从中继承的构造器
函数对象 。 - 连同其对应的原型对象，提供由所有 TypedArray 构造器及其实例继承的公共属性。
- 没有全局名称，也不作为
全局对象 的属性出现。 - 充当各种 TypedArray 构造器的抽象超类。
- 在被调用时会抛出错误，因为它是抽象类构造器。TypedArray 构造器不会对它执行
super调用。
23.2.1.1 %TypedArray% ( )
此函数在被调用时执行以下步骤：
- 抛出
TypeError 异常。
此函数的
23.2.2 %TypedArray% 固有对象的属性
- 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有一个
"name" 属性，其值为"TypedArray" 。 - 具有以下属性：
23.2.2.1 %TypedArray%.from ( source [ , mapper [ , thisArg ] ] )
此方法在被调用时执行以下步骤：
- 令 ctor 为
this 值。 - 如果
IsConstructor (ctor) 是false ，则抛出TypeError 异常。 - 如果 mapper 是
undefined ，则- 令 mapping 为
false 。
- 令 mapping 为
- 否则，
- 如果
IsCallable (mapper) 是false ，则抛出TypeError 异常。 - 令 mapping 为
true 。
- 如果
- 令 usingIterator 为 ?
GetMethod (source,%Symbol.iterator% )。 - 如果 usingIterator 不是
undefined ，则- 令 values 为 ?
IteratorToList (?GetIteratorFromMethod (source, usingIterator))。 - 令 length 为 values 中元素的数量。
- 令 targetObj 为 ?
TypedArrayCreateFromConstructor (ctor, «𝔽 (length) »)。 - 令 k 为 0。
- 重复，只要 k < length，
- 断言：values 现在是空
List 。 - 返回 targetObj。
- 令 values 为 ?
- 注：source 不是可迭代对象，因此假定它已经是一个
类数组对象 。 - 令 arrayLike 为 !
ToObject (source)。 - 令 length 为 ?
LengthOfArrayLike (arrayLike)。 - 令 targetObj 为 ?
TypedArrayCreateFromConstructor (ctor, «𝔽 (length) »)。 - 令 k 为 0。
- 重复，只要 k < length，
- 返回 targetObj。
23.2.2.2 %TypedArray%.of ( ...items )
此方法在被调用时执行以下步骤：
- 令 length 为 items 中元素的数量。
- 令 ctor 为
this 值。 - 如果
IsConstructor (ctor) 是false ，则抛出TypeError 异常。 - 令 newObj 为 ?
TypedArrayCreateFromConstructor (ctor, «𝔽 (length) »)。 - 令 k 为 0。
- 重复，只要 k < length，
- 返回 newObj。
23.2.2.3 %TypedArray%.prototype
.prototype 的初始值是
此属性具有特性 { [[Writable]]:
23.2.2.4 get %TypedArray% [ %Symbol.species% ]
[%Symbol.species%] 是
- 返回
this 值。
此函数的
23.2.3 %TypedArray% 原型对象的属性
%TypedArray% 原型对象：
- 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是 %TypedArray.prototype%。
- 是
普通对象 。 - 没有 [[ViewedArrayBuffer]]，也没有任何其他 TypedArray 实例对象专有的内部槽。
23.2.3.1 %TypedArray%.prototype.at ( index )
- 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 令 relativeIndex 为 ?
ToIntegerOrInfinity (index)。 - 如果 relativeIndex ≥ 0，则
- 令 k 为 relativeIndex。
- 否则，
- 令 k 为 length + relativeIndex。
- 如果 k < 0 或 k ≥ length，则返回
undefined 。 - 返回 !
Get (obj, !ToString (𝔽 (k)))。
23.2.3.2 get %TypedArray%.prototype.buffer
.prototype.buffer 是
- 令 obj 为
this 值。 - 执行 ?
RequireInternalSlot (obj, [[TypedArrayName]])。 - 断言：obj 具有 [[ViewedArrayBuffer]] 内部槽。
- 令 buffer 为 obj.[[ViewedArrayBuffer]]。
- 返回 buffer。
23.2.3.3 get %TypedArray%.prototype.byteLength
.prototype.byteLength 是
- 令 obj 为
this 值。 - 执行 ?
RequireInternalSlot (obj, [[TypedArrayName]])。 - 断言：obj 具有 [[ViewedArrayBuffer]] 内部槽。
- 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (taRecord) 是true ，则返回+0 𝔽。 - 令 size 为
TypedArrayByteLength (taRecord)。 - 返回
𝔽 (size)。
23.2.3.4 get %TypedArray%.prototype.byteOffset
.prototype.byteOffset 是
- 令 obj 为
this 值。 - 执行 ?
RequireInternalSlot (obj, [[TypedArrayName]])。 - 断言：obj 具有 [[ViewedArrayBuffer]] 内部槽。
- 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (taRecord) 是true ，则返回+0 𝔽。 - 令 offset 为 obj.[[ByteOffset]]。
- 返回
𝔽 (offset)。
23.2.3.5 %TypedArray%.prototype.constructor
.prototype.constructor 的初始值是
23.2.3.6 %TypedArray%.prototype.copyWithin ( target, start [ , end ] )
此方法的实参解释和使用方式与 Array.prototype.copyWithin 相同。
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 令 relativeTarget 为 ?
ToIntegerOrInfinity (target)。 - 如果 relativeTarget = -∞，则令 targetIndex 为 0。
- 否则，如果 relativeTarget < 0，则令 targetIndex 为
max (length + relativeTarget, 0)。 - 否则，令 targetIndex 为
min (relativeTarget, length)。 - 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 relativeStart = -∞，则令 startIndex 为 0。
- 否则，如果 relativeStart < 0，则令 startIndex 为
max (length + relativeStart, 0)。 - 否则，令 startIndex 为
min (relativeStart, length)。 - 如果 end 是
undefined ，则令 relativeEnd 为 length；否则令 relativeEnd 为 ?ToIntegerOrInfinity (end)。 - 如果 relativeEnd = -∞，则令 endIndex 为 0。
- 否则，如果 relativeEnd < 0，则令 endIndex 为
max (length + relativeEnd, 0)。 - 否则，令 endIndex 为
min (relativeEnd, length)。 - 令 count 为
min (endIndex - startIndex, length - targetIndex)。 - 如果 count > 0，则
- 注：复制必须以保留源数据的位级编码的方式执行。
- 令 buffer 为 obj.[[ViewedArrayBuffer]]。
- 将 taRecord 设置为
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (taRecord) 是true ，则抛出TypeError 异常。 - 将 length 设置为
TypedArrayLength (taRecord)。 - 注：上述步骤的副作用可能已经减小 obj 的大小；在这种情况下，复制应继续处理仍适用的最长前缀。
- 将 count 设置为
min (count, length - startIndex, length - targetIndex)。 - 令 elementSize 为
TypedArrayElementSize (obj)。 - 令 byteOffset 为 obj.[[ByteOffset]]。
- 令 toByteIndex 为 (targetIndex × elementSize) + byteOffset。
- 令 fromByteIndex 为 (startIndex × elementSize) + byteOffset。
- 令 countBytes 为 count × elementSize。
- 如果 fromByteIndex < toByteIndex 且 toByteIndex < fromByteIndex + countBytes，则
- 令 direction 为 -1。
- 将 fromByteIndex 设置为 fromByteIndex + countBytes - 1。
- 将 toByteIndex 设置为 toByteIndex + countBytes - 1。
- 否则，
- 令 direction 为 1。
- 重复，只要 countBytes > 0，
- 令 value 为
GetValueFromBuffer (buffer, fromByteIndex,uint8 ,true ,unordered )。 - 执行
SetValueInBuffer (buffer, toByteIndex,uint8 , value,true ,unordered )。 - 将 fromByteIndex 设置为 fromByteIndex + direction。
- 将 toByteIndex 设置为 toByteIndex + direction。
- 将 countBytes 设置为 countBytes - 1。
- 令 value 为
- 返回 obj。
23.2.3.7 %TypedArray%.prototype.entries ( )
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 执行 ?
ValidateTypedArray (obj,seq-cst )。 - 返回
CreateArrayIterator (obj,key+value )。
23.2.3.8 %TypedArray%.prototype.every ( callback [ , thisArg ] )
此方法的实参解释和使用方式与 Array.prototype.every 相同。
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 如果
IsCallable (callback) 是false ，则抛出TypeError 异常。 - 令 k 为 0。
- 重复，只要 k < length，
- 返回
true 。
此方法不是泛型的。
23.2.3.9 %TypedArray%.prototype.fill ( value [ , start [ , end ] ] )
此方法的实参解释和使用方式与 Array.prototype.fill 相同。
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 如果 obj.[[ContentType]] 是
bigint ，则将 value 设置为 ?ToBigInt (value)。 - 否则，将 value 设置为 ?
ToNumber (value)。 - 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 relativeStart = -∞，则令 startIndex 为 0。
- 否则，如果 relativeStart < 0，则令 startIndex 为
max (length + relativeStart, 0)。 - 否则，令 startIndex 为
min (relativeStart, length)。 - 如果 end 是
undefined ，则令 relativeEnd 为 length；否则令 relativeEnd 为 ?ToIntegerOrInfinity (end)。 - 如果 relativeEnd = -∞，则令 endIndex 为 0。
- 否则，如果 relativeEnd < 0，则令 endIndex 为
max (length + relativeEnd, 0)。 - 否则，令 endIndex 为
min (relativeEnd, length)。 - 将 taRecord 设置为
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (taRecord) 是true ，则抛出TypeError 异常。 - 将 length 设置为
TypedArrayLength (taRecord)。 - 将 endIndex 设置为
min (endIndex, length)。 - 令 k 为 startIndex。
- 重复，只要 k < endIndex，
- 返回 obj。
23.2.3.10 %TypedArray%.prototype.filter ( callback [ , thisArg ] )
此方法的实参解释和使用方式与 Array.prototype.filter 相同。
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 如果
IsCallable (callback) 是false ，则抛出TypeError 异常。 - 令 kept 为新的空
List 。 - 令 captured 为 0。
- 令 k 为 0。
- 重复，只要 k < length，
- 令 result 为 ?
TypedArraySpeciesCreate (obj, «𝔽 (captured) »)。 - 令 n 为 0。
- 对 kept 的每个元素 element，执行：
- 返回 result。
此方法不是泛型的。
23.2.3.11 %TypedArray%.prototype.find ( predicate [ , thisArg ] )
此方法的实参解释和使用方式与 Array.prototype.find 相同。
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 令 findRecord 为 ?
FindViaPredicate (obj, length,ascending , predicate, thisArg)。 - 返回 findRecord.[[Value]]。
此方法不是泛型的。
23.2.3.12 %TypedArray%.prototype.findIndex ( predicate [ , thisArg ] )
此方法的实参解释和使用方式与 Array.prototype.findIndex 相同。
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 令 findRecord 为 ?
FindViaPredicate (obj, length,ascending , predicate, thisArg)。 - 返回 findRecord.[[Index]]。
此方法不是泛型的。
23.2.3.13 %TypedArray%.prototype.findLast ( predicate [ , thisArg ] )
此方法的实参解释和使用方式与 Array.prototype.findLast 相同。
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 令 findRecord 为 ?
FindViaPredicate (obj, length,descending , predicate, thisArg)。 - 返回 findRecord.[[Value]]。
此方法不是泛型的。
23.2.3.14 %TypedArray%.prototype.findLastIndex ( predicate [ , thisArg ] )
此方法的实参解释和使用方式与 Array.prototype.findLastIndex 相同。
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 令 findRecord 为 ?
FindViaPredicate (obj, length,descending , predicate, thisArg)。 - 返回 findRecord.[[Index]]。
此方法不是泛型的。
23.2.3.15 %TypedArray%.prototype.forEach ( callback [ , thisArg ] )
此方法的实参解释和使用方式与 Array.prototype.forEach 相同。
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 如果
IsCallable (callback) 是false ，则抛出TypeError 异常。 - 令 k 为 0。
- 重复，只要 k < length，
- 返回
undefined 。
此方法不是泛型的。
23.2.3.16 %TypedArray%.prototype.includes ( searchElement [ , fromIndex ] )
此方法的实参解释和使用方式与 Array.prototype.includes 相同。
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 如果 length = 0，则返回
false 。 - 令 n 为 ?
ToIntegerOrInfinity (fromIndex)。 - 断言：如果 fromIndex 是
undefined ，则 n 是 0。 - 如果 n = +∞，则返回
false 。 - 如果 n = -∞，则将 n 设置为 0。
- 如果 n ≥ 0，则
- 令 k 为 n。
- 否则，
- 令 k 为 length + n。
- 如果 k < 0，则将 k 设置为 0。
- 重复，只要 k < length，
- 令 elementK 为 !
Get (obj, !ToString (𝔽 (k)))。 - 如果
SameValueZero (searchElement, elementK) 是true ，则返回true 。 - 将 k 设置为 k + 1。
- 令 elementK 为 !
- 返回
false 。
此方法不是泛型的。
23.2.3.17 %TypedArray%.prototype.indexOf ( searchElement [ , fromIndex ] )
此方法的实参解释和使用方式与 Array.prototype.indexOf 相同。
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 如果 length = 0，则返回
-1 𝔽。 - 令 n 为 ?
ToIntegerOrInfinity (fromIndex)。 - 断言：如果 fromIndex 是
undefined ，则 n 是 0。 - 如果 n = +∞，则返回
-1 𝔽。 - 如果 n = -∞，则将 n 设置为 0。
- 如果 n ≥ 0，则
- 令 k 为 n。
- 否则，
- 令 k 为 length + n。
- 如果 k < 0，则将 k 设置为 0。
- 重复，只要 k < length，
- 令 propertyKey 为 !
ToString (𝔽 (k))。 - 令 kPresent 为 !
HasProperty (obj, propertyKey)。 - 如果 kPresent 是
true ，则- 令 elementK 为 !
Get (obj, propertyKey)。 - 如果
IsStrictlyEqual (searchElement, elementK) 是true ，则返回𝔽 (k)。
- 令 elementK 为 !
- 将 k 设置为 k + 1。
- 令 propertyKey 为 !
- 返回
-1 𝔽。
此方法不是泛型的。
23.2.3.18 %TypedArray%.prototype.join ( separator )
此方法的实参解释和使用方式与 Array.prototype.join 相同。
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 如果 separator 是
undefined ，则令 sep 为"," 。 - 否则，令 sep 为 ?
ToString (separator)。 - 令 result 为空 String。
- 令 k 为 0。
- 重复，只要 k < length，
- 返回 result。
此方法不是泛型的。
23.2.3.19 %TypedArray%.prototype.keys ( )
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 执行 ?
ValidateTypedArray (obj,seq-cst )。 - 返回
CreateArrayIterator (obj,key )。
23.2.3.20 %TypedArray%.prototype.lastIndexOf ( searchElement [ , fromIndex ] )
此方法的实参解释和使用方式与 Array.prototype.lastIndexOf 相同。
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 如果 length = 0，则返回
-1 𝔽。 - 如果 fromIndex 存在，则令 n 为 ?
ToIntegerOrInfinity (fromIndex)；否则令 n 为 length - 1。 - 如果 n = -∞，则返回
-1 𝔽。 - 如果 n ≥ 0，则
- 令 k 为
min (n, length - 1)。
- 令 k 为
- 否则，
- 令 k 为 length + n。
- 重复，只要 k ≥ 0，
- 令 propertyKey 为 !
ToString (𝔽 (k))。 - 令 kPresent 为 !
HasProperty (obj, propertyKey)。 - 如果 kPresent 是
true ，则- 令 elementK 为 !
Get (obj, propertyKey)。 - 如果
IsStrictlyEqual (searchElement, elementK) 是true ，则返回𝔽 (k)。
- 令 elementK 为 !
- 将 k 设置为 k - 1。
- 令 propertyKey 为 !
- 返回
-1 𝔽。
此方法不是泛型的。
23.2.3.21 get %TypedArray%.prototype.length
.prototype.length 是
- 令 obj 为
this 值。 - 执行 ?
RequireInternalSlot (obj, [[TypedArrayName]])。 - 断言：obj 具有 [[ViewedArrayBuffer]] 和 [[ArrayLength]] 内部槽。
- 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (taRecord) 是true ，则返回+0 𝔽。 - 令 length 为
TypedArrayLength (taRecord)。 - 返回
𝔽 (length)。
此函数不是泛型的。
23.2.3.22 %TypedArray%.prototype.map ( callback [ , thisArg ] )
此方法的实参解释和使用方式与 Array.prototype.map 相同。
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 如果
IsCallable (callback) 是false ，则抛出TypeError 异常。 - 令 result 为 ?
TypedArraySpeciesCreate (obj, «𝔽 (length) »)。 - 令 k 为 0。
- 重复，只要 k < length，
- 返回 result。
此方法不是泛型的。
23.2.3.23 %TypedArray%.prototype.reduce ( callback [ , initialValue ] )
此方法的实参解释和使用方式与 Array.prototype.reduce 相同。
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 如果
IsCallable (callback) 是false ，则抛出TypeError 异常。 - 如果 length = 0 且 initialValue 不存在，则抛出
TypeError 异常。 - 令 k 为 0。
- 令 accumulator 为
undefined 。 - 如果 initialValue 存在，则
- 将 accumulator 设置为 initialValue。
- 否则，
- 重复，只要 k < length，
- 返回 accumulator。
此方法不是泛型的。
23.2.3.24 %TypedArray%.prototype.reduceRight ( callback [ , initialValue ] )
此方法的实参解释和使用方式与 Array.prototype.reduceRight 相同。
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 如果
IsCallable (callback) 是false ，则抛出TypeError 异常。 - 如果 length = 0 且 initialValue 不存在，则抛出
TypeError 异常。 - 令 k 为 length - 1。
- 令 accumulator 为
undefined 。 - 如果 initialValue 存在，则
- 将 accumulator 设置为 initialValue。
- 否则，
- 重复，只要 k ≥ 0，
- 返回 accumulator。
此方法不是泛型的。
23.2.3.25 %TypedArray%.prototype.reverse ( )
此方法的实参解释和使用方式与 Array.prototype.reverse 相同。
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 令 middle 为
floor (length / 2)。 - 令 lower 为 0。
- 重复，只要 lower ≠ middle，
- 返回 obj。
此方法不是泛型的。
23.2.3.26 %TypedArray%.prototype.set ( source [ , offset ] )
此方法会在此 TypedArray 中设置多个值，并从 source 读取这些值。细节会根据 source 的类型而不同。可选的 offset 值指示在此 TypedArray 中写入值的第一个元素索引。如果省略，则假定为 0。
它在被调用时执行以下步骤：
- 令 target 为
this 值。 - 执行 ?
RequireInternalSlot (target, [[TypedArrayName]])。 - 断言：target 具有 [[ViewedArrayBuffer]] 内部槽。
- 令 targetOffset 为 ?
ToIntegerOrInfinity (offset)。 - 如果 targetOffset < 0，则抛出
RangeError 异常。 - 如果 source 是具有 [[TypedArrayName]] 内部槽的 Object，则
- 执行 ?
SetTypedArrayFromTypedArray (target, targetOffset, source)。
- 执行 ?
- 否则，
- 执行 ?
SetTypedArrayFromArrayLike (target, targetOffset, source)。
- 执行 ?
- 返回
undefined 。
此方法不是泛型的。
23.2.3.26.1 SetTypedArrayFromArrayLike ( target, targetOffset, source )
The abstract operation SetTypedArrayFromArrayLike takes arguments target (a
- 令 targetRecord 为
MakeTypedArrayWithBufferWitnessRecord (target,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (targetRecord) 是true ，则抛出TypeError 异常。 - 令 targetLength 为
TypedArrayLength (targetRecord)。 - 将 source 设置为 ?
ToObject (source)。 - 令 sourceLength 为 ?
LengthOfArrayLike (source)。 - 如果 targetOffset = +∞，则抛出
RangeError 异常。 - 如果 sourceLength + targetOffset > targetLength，则抛出
RangeError 异常。 - 令 k 为 0。
- 重复，只要 k < sourceLength，
- 令 propertyKey 为 !
ToString (𝔽 (k))。 - 令 value 为 ?
Get (source, propertyKey)。 - 令 targetIndex 为
𝔽 (targetOffset + k)。 - 执行 ?
TypedArraySetElement (target, targetIndex, value)。 - 将 k 设置为 k + 1。
- 令 propertyKey 为 !
- 返回
unused 。
23.2.3.26.2 SetTypedArrayFromTypedArray ( target, targetOffset, source )
The abstract operation SetTypedArrayFromTypedArray takes arguments target (a
- 令 targetBuffer 为 target.[[ViewedArrayBuffer]]。
- 令 targetRecord 为
MakeTypedArrayWithBufferWitnessRecord (target,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (targetRecord) 是true ，则抛出TypeError 异常。 - 令 targetLength 为
TypedArrayLength (targetRecord)。 - 令 sourceBuffer 为 source.[[ViewedArrayBuffer]]。
- 令 sourceRecord 为
MakeTypedArrayWithBufferWitnessRecord (source,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (sourceRecord) 是true ，则抛出TypeError 异常。 - 令 sourceLength 为
TypedArrayLength (sourceRecord)。 - 令 targetType 为
TypedArrayElementType (target)。 - 令 targetElementSize 为
TypedArrayElementSize (target)。 - 令 targetByteOffset 为 target.[[ByteOffset]]。
- 令 sourceType 为
TypedArrayElementType (source)。 - 令 sourceElementSize 为
TypedArrayElementSize (source)。 - 令 sourceByteOffset 为 source.[[ByteOffset]]。
- 如果 targetOffset = +∞，则抛出
RangeError 异常。 - 如果 sourceLength + targetOffset > targetLength，则抛出
RangeError 异常。 - 如果 target.[[ContentType]] 不是 source.[[ContentType]]，则抛出
TypeError 异常。 - 如果
IsSharedArrayBuffer (sourceBuffer) 是true ，IsSharedArrayBuffer (targetBuffer) 是true ，且 sourceBuffer.[[ArrayBufferData]] 是 targetBuffer.[[ArrayBufferData]]，则令 sameSharedArrayBuffer 为true ；否则令 sameSharedArrayBuffer 为false 。 - 如果
SameValue (sourceBuffer, targetBuffer) 是true 或 sameSharedArrayBuffer 是true ，则- 令 sourceByteLength 为
TypedArrayByteLength (sourceRecord)。 - 将 sourceBuffer 设置为 ?
CloneArrayBuffer (sourceBuffer, sourceByteOffset, sourceByteLength)。 - 令 sourceByteIndex 为 0。
- 令 sourceByteLength 为
- 否则，
- 令 sourceByteIndex 为 sourceByteOffset。
- 令 targetByteIndex 为 (targetOffset × targetElementSize) + targetByteOffset。
- 令 limit 为 targetByteIndex + (targetElementSize × sourceLength)。
- 如果 sourceType 是 targetType，则
- 注：传输必须以保留源数据的位级编码的方式执行。
- 重复，只要 targetByteIndex < limit，
- 令 value 为
GetValueFromBuffer (sourceBuffer, sourceByteIndex,uint8 ,true ,unordered )。 - 执行
SetValueInBuffer (targetBuffer, targetByteIndex,uint8 , value,true ,unordered )。 - 将 sourceByteIndex 设置为 sourceByteIndex + 1。
- 将 targetByteIndex 设置为 targetByteIndex + 1。
- 令 value 为
- 否则，
- 重复，只要 targetByteIndex < limit，
- 令 value 为
GetValueFromBuffer (sourceBuffer, sourceByteIndex, sourceType,true ,unordered )。 - 执行
SetValueInBuffer (targetBuffer, targetByteIndex, targetType, value,true ,unordered )。 - 将 sourceByteIndex 设置为 sourceByteIndex + sourceElementSize。
- 将 targetByteIndex 设置为 targetByteIndex + targetElementSize。
- 令 value 为
- 重复，只要 targetByteIndex < limit，
- 返回
unused 。
23.2.3.27 %TypedArray%.prototype.slice ( start, end )
此方法的实参解释和使用方式与 Array.prototype.slice 相同。
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 sourceArrayLength 为
TypedArrayLength (taRecord)。 - 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 relativeStart = -∞，则令 startIndex 为 0。
- 否则，如果 relativeStart < 0，则令 startIndex 为
max (sourceArrayLength + relativeStart, 0)。 - 否则，令 startIndex 为
min (relativeStart, sourceArrayLength)。 - 如果 end 是
undefined ，则令 relativeEnd 为 sourceArrayLength；否则令 relativeEnd 为 ?ToIntegerOrInfinity (end)。 - 如果 relativeEnd = -∞，则令 endIndex 为 0。
- 否则，如果 relativeEnd < 0，则令 endIndex 为
max (sourceArrayLength + relativeEnd, 0)。 - 否则，令 endIndex 为
min (relativeEnd, sourceArrayLength)。 - 令 countBytes 为
max (endIndex - startIndex, 0)。 - 令 resultArray 为 ?
TypedArraySpeciesCreate (obj, «𝔽 (countBytes) »)。 - 如果 countBytes > 0，则
- 将 taRecord 设置为
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (taRecord) 是true ，则抛出TypeError 异常。 - 将 endIndex 设置为
min (endIndex,TypedArrayLength (taRecord))。 - 将 countBytes 设置为
max (endIndex - startIndex, 0)。 - 令 sourceType 为
TypedArrayElementType (obj)。 - 令 targetType 为
TypedArrayElementType (resultArray)。 - 如果 sourceType 是 targetType，则
- 注：传输必须以保留源数据的位级编码的方式执行。
- 令 sourceBuffer 为 obj.[[ViewedArrayBuffer]]。
- 令 targetBuffer 为 resultArray.[[ViewedArrayBuffer]]。
- 令 elementSize 为
TypedArrayElementSize (obj)。 - 令 sourceByteOffset 为 obj.[[ByteOffset]]。
- 令 sourceByteIndex 为 (startIndex × elementSize) + sourceByteOffset。
- 令 targetByteIndex 为 resultArray.[[ByteOffset]]。
- 令 endByteIndex 为 targetByteIndex + (countBytes × elementSize)。
- 重复，只要 targetByteIndex < endByteIndex，
- 令 value 为
GetValueFromBuffer (sourceBuffer, sourceByteIndex,uint8 ,true ,unordered )。 - 执行
SetValueInBuffer (targetBuffer, targetByteIndex,uint8 , value,true ,unordered )。 - 将 sourceByteIndex 设置为 sourceByteIndex + 1。
- 将 targetByteIndex 设置为 targetByteIndex + 1。
- 令 value 为
- 否则，
- 将 taRecord 设置为
- 返回 resultArray。
此方法不是泛型的。
23.2.3.28 %TypedArray%.prototype.some ( callback [ , thisArg ] )
此方法的实参解释和使用方式与 Array.prototype.some 相同。
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 如果
IsCallable (callback) 是false ，则抛出TypeError 异常。 - 令 k 为 0。
- 重复，只要 k < length，
- 返回
false 。
此方法不是泛型的。
23.2.3.29 %TypedArray%.prototype.sort ( comparator )
这是一个不同的方法；除下文所述外，它实现与 Array.prototype.sort 相同的要求。此方法的实现可以利用这样的知识进行优化：
此方法不是泛型的。
它在被调用时执行以下步骤：
- 如果 comparator 不是
undefined 且IsCallable (comparator) 是false ，则抛出TypeError 异常。 - 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 注：以下闭包执行数值比较，而不是
23.1.3.30 中使用的字符串比较。 - 令 sortCompare 为一个新的
Abstract Closure ，其参数为 (x, y)，捕获 comparator，并在被调用时执行以下步骤：- 返回 ?
CompareTypedArrayElements (x, y, comparator)。
- 返回 ?
- 令 sortedList 为 ?
SortIndexedProperties (obj, length, sortCompare,read-through-holes )。 - 令 j 为 0。
- 重复，只要 j < length，
- 返回 obj。
由于
23.2.3.30 %TypedArray%.prototype.subarray ( start, end )
此方法返回一个新的 TypedArray，其元素类型是此 TypedArray 的元素类型，其 ArrayBuffer 是此 TypedArray 的 ArrayBuffer，并引用从 start（
它在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 执行 ?
RequireInternalSlot (obj, [[TypedArrayName]])。 - 断言：obj 具有 [[ViewedArrayBuffer]] 内部槽。
- 令 buffer 为 obj.[[ViewedArrayBuffer]]。
- 令 sourceRecord 为
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (sourceRecord) 是true ，则- 令 sourceLength 为 0。
- 否则，
- 令 sourceLength 为
TypedArrayLength (sourceRecord)。
- 令 sourceLength 为
- 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 relativeStart = -∞，则令 startIndex 为 0。
- 否则，如果 relativeStart < 0，则令 startIndex 为
max (sourceLength + relativeStart, 0)。 - 否则，令 startIndex 为
min (relativeStart, sourceLength)。 - 令 elementSize 为
TypedArrayElementSize (obj)。 - 令 sourceByteOffset 为 obj.[[ByteOffset]]。
- 令 beginByteOffset 为 sourceByteOffset + (startIndex × elementSize)。
- 如果 obj.[[ArrayLength]] 是
auto 且 end 是undefined ，则- 令 argList 为 « buffer,
𝔽 (beginByteOffset) »。
- 令 argList 为 « buffer,
- 否则，
- 如果 end 是
undefined ，则令 relativeEnd 为 sourceLength；否则令 relativeEnd 为 ?ToIntegerOrInfinity (end)。 - 如果 relativeEnd = -∞，则令 endIndex 为 0。
- 否则，如果 relativeEnd < 0，则令 endIndex 为
max (sourceLength + relativeEnd, 0)。 - 否则，令 endIndex 为
min (relativeEnd, sourceLength)。 - 令 newLength 为
max (endIndex - startIndex, 0)。 - 令 argList 为 « buffer,
𝔽 (beginByteOffset),𝔽 (newLength) »。
- 如果 end 是
- 返回 ?
TypedArraySpeciesCreate (obj, argList)。
此方法不是泛型的。
23.2.3.31 %TypedArray%.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
这是一个不同的方法，它实现与 Array.prototype.toLocaleString 相同的算法，不同之处在于调用
此方法不是泛型的。在对算法求值之前，以
如果 ECMAScript 实现Array.prototype.toLocaleString 算法。
23.2.3.32 %TypedArray%.prototype.toReversed ( )
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 令 resultArray 为 ?
TypedArrayCreateSameType (obj, length)。 - 令 k 为 0。
- 重复，只要 k < length，
- 返回 resultArray。
23.2.3.33 %TypedArray%.prototype.toSorted ( comparator )
此方法在被调用时执行以下步骤：
- 如果 comparator 不是
undefined 且IsCallable (comparator) 是false ，则抛出TypeError 异常。 - 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 令 resultArray 为 ?
TypedArrayCreateSameType (obj, length)。 - 注：以下闭包执行数值比较，而不是
23.1.3.34 中使用的字符串比较。 - 令 sortCompare 为一个新的
Abstract Closure ，其参数为 (x, y)，捕获 comparator，并在被调用时执行以下步骤：- 返回 ?
CompareTypedArrayElements (x, y, comparator)。
- 返回 ?
- 令 sortedList 为 ?
SortIndexedProperties (obj, length, sortCompare,read-through-holes )。 - 令 j 为 0。
- 重复，只要 j < length，
- 返回 resultArray。
23.2.3.34 %TypedArray%.prototype.toString ( )
23.2.3.35 %TypedArray%.prototype.values ( )
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 执行 ?
ValidateTypedArray (obj,seq-cst )。 - 返回
CreateArrayIterator (obj,value )。
23.2.3.36 %TypedArray%.prototype.with ( index, value )
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (obj,seq-cst )。 - 令 length 为
TypedArrayLength (taRecord)。 - 令 relativeIndex 为 ?
ToIntegerOrInfinity (index)。 - 如果 relativeIndex ≥ 0，则令 actualIndex 为 relativeIndex。
- 否则，令 actualIndex 为 length + relativeIndex。
- 如果 obj.[[ContentType]] 是
bigint ，则令 numericValue 为 ?ToBigInt (value)。 - 否则，令 numericValue 为 ?
ToNumber (value)。 - 如果
IsValidIntegerIndex (obj,𝔽 (actualIndex)) 是false ，则抛出RangeError 异常。 - 令 resultArray 为 ?
TypedArrayCreateSameType (obj, length)。 - 令 k 为 0。
- 重复，只要 k < length，
- 返回 resultArray。
23.2.3.37 %TypedArray%.prototype [ %Symbol.iterator% ] ( )
23.2.3.38 get %TypedArray%.prototype [ %Symbol.toStringTag% ]
.prototype[%Symbol.toStringTag%] 是
- 令 obj 为
this 值。 - 如果 obj 不是 Object，则返回
undefined 。 - 如果 obj 不具有 [[TypedArrayName]] 内部槽，则返回
undefined 。 - 令 name 为 obj.[[TypedArrayName]]。
- 断言：name 是 String。
- 返回 name。
此属性具有特性 { [[Enumerable]]:
此函数的
23.2.4 TypedArray 对象的抽象操作
23.2.4.1 TypedArrayCreateFromConstructor ( ctor, argList )
The abstract operation TypedArrayCreateFromConstructor takes arguments ctor (a constructor) and argList (a
- 令 ta 为 ?
Construct (ctor, argList)。 - 令 taRecord 为 ?
ValidateTypedArray (ta,seq-cst )。 - 断言：ta 具有
TypedArray 实例的属性 中提到的所有内部槽。 - 如果 argList 中元素的数量是 1，且 argList[0] 是 Number，则
- 如果
IsTypedArrayOutOfBounds (taRecord) 是true ，则抛出TypeError 异常。 - 令 length 为
TypedArrayLength (taRecord)。 - 如果 length <
ℝ (argList[0])，则抛出TypeError 异常。
- 如果
- 返回 ta。
23.2.4.2 TypedArrayCreateSameType ( exemplar, length )
The abstract operation TypedArrayCreateSameType takes arguments exemplar (a
- 令 ctor 为
Table 71 中与构造器名称 exemplar.[[TypedArrayName]] 关联的固有对象。 - 令 result 为 ?
TypedArrayCreateFromConstructor (ctor, «𝔽 (length) »)。 - 断言：result 具有 [[TypedArrayName]] 和 [[ContentType]] 内部槽。
- 断言：result.[[ContentType]] 是 exemplar.[[ContentType]]。
- 返回 result。
23.2.4.3 TypedArraySpeciesCreate ( exemplar, argList )
The abstract operation TypedArraySpeciesCreate takes arguments exemplar (a
- 令 defaultCtor 为
Table 71 中与构造器名称 exemplar.[[TypedArrayName]] 关联的固有对象。 - 令 ctor 为 ?
SpeciesConstructor (exemplar, defaultCtor)。 - 令 result 为 ?
TypedArrayCreateFromConstructor (ctor, argList)。 - 如果 result.[[ContentType]] 不是 exemplar.[[ContentType]]，则抛出
TypeError 异常。 - 返回 result。
23.2.4.4 ValidateTypedArray ( obj, order )
The abstract operation ValidateTypedArray takes arguments obj (an ECMAScript language value) and order (
- 执行 ?
RequireInternalSlot (obj, [[TypedArrayName]])。 - 断言：obj 具有 [[ViewedArrayBuffer]] 内部槽。
- 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (obj, order)。 - 如果
IsTypedArrayOutOfBounds (taRecord) 是true ，则抛出TypeError 异常。 - 返回 taRecord。
23.2.4.5 TypedArrayElementSize ( obj )
The abstract operation TypedArrayElementSize takes argument obj (a
- 返回
Table 71 中为 obj.[[TypedArrayName]] 指定的 Element Size 值。
23.2.4.6 TypedArrayElementType ( obj )
The abstract operation TypedArrayElementType takes argument obj (a
- 返回
Table 71 中为 obj.[[TypedArrayName]] 指定的 Element Type 值。
23.2.4.7 CompareTypedArrayElements ( x, y, comparator )
The abstract operation CompareTypedArrayElements takes arguments x (a Number or a BigInt), y (a Number or a BigInt), and comparator (a function object or
- 断言：x 是 Number 且 y 是 Number，或 x 是 BigInt 且 y 是 BigInt。
- 如果 comparator 不是
undefined ，则 - 如果 x 是
NaN 且 y 是NaN ，则返回+0 𝔽。 - 如果 x 是
NaN ，则返回1 𝔽。 - 如果 y 是
NaN ，则返回-1 𝔽。 - 如果 x < y，则返回
-1 𝔽。 - 如果 x > y，则返回
1 𝔽。 - 如果 x 是
-0 𝔽 且 y 是+0 𝔽，则返回-1 𝔽。 - 如果 x 是
+0 𝔽 且 y 是-0 𝔽，则返回1 𝔽。 - 返回
+0 𝔽。
23.2.5 TypedArray 构造器
每个 TypedArray 构造器：
- 是具有下述结构的固有对象，除非另有说明，否则只是在
Table 71 中使用的构造器名称不同，而不是使用 TypedArray。 - 是一个其行为会根据实参数量和类型而不同的函数。调用 TypedArray 的实际行为取决于传给它的实参的数量和种类。
- 不意图作为函数调用，并且在以这种方式调用时会抛出异常。
- 可以用作类定义的
extends子句的值。打算继承指定 TypedArray 行为的子类构造函数 ，必须包含 一次对 TypedArray构造函数 的super调用，以创建并初始化子类实例，使其具备支持%TypedArray% .prototype的内置方法所必需的内部状态。
23.2.5.1 TypedArray ( ...args )
每个 TypedArray 构造器在被调用时执行以下步骤：
- 如果 NewTarget 是
undefined ，则抛出TypeError 异常。 - 令 ctorName 为
Table 71 中为此 TypedArray 构造器指定的 Constructor Name 值的 String 值。 - 令 proto 为
"%TypedArray.prototype%"。 - 令 numberOfArgs 为 args 中元素的数量。
- 如果 numberOfArgs = 0，则返回 ?
AllocateTypedArray (ctorName, NewTarget, proto, 0)。 - 令 firstArg 为 args[0]。
- 如果 firstArg 是 Object，则
- 令 obj 为 ?
AllocateTypedArray (ctorName, NewTarget, proto)。 - 如果 firstArg 具有 [[TypedArrayName]] 内部槽，则
- 执行 ?
InitializeTypedArrayFromTypedArray (obj, firstArg)。
- 执行 ?
- 否则，如果 firstArg 具有 [[ArrayBufferData]] 内部槽，则
- 如果 numberOfArgs > 1，则令 byteOffset 为 args[1]；否则令 byteOffset 为
undefined 。 - 如果 numberOfArgs > 2，则令 length 为 args[2]；否则令 length 为
undefined 。 - 执行 ?
InitializeTypedArrayFromArrayBuffer (obj, firstArg, byteOffset, length)。
- 如果 numberOfArgs > 1，则令 byteOffset 为 args[1]；否则令 byteOffset 为
- 否则，
- 断言：firstArg 是 Object，且 firstArg 既不具有 [[TypedArrayName]] 也不具有 [[ArrayBufferData]] 内部槽。
- 令 usingIterator 为 ?
GetMethod (firstArg,%Symbol.iterator% )。 - 如果 usingIterator 不是
undefined ，则- 令 values 为 ?
IteratorToList (?GetIteratorFromMethod (firstArg, usingIterator))。 - 执行 ?
InitializeTypedArrayFromList (obj, values)。
- 令 values 为 ?
- 否则，
- 注：firstArg 不是可迭代对象，因此假定它已经是一个
类数组对象 。 - 执行 ?
InitializeTypedArrayFromArrayLike (obj, firstArg)。
- 注：firstArg 不是可迭代对象，因此假定它已经是一个
- 返回 obj。
- 令 obj 为 ?
- 断言：firstArg 不是 Object。
- 令 elementLength 为 ?
ToIndex (firstArg)。 - 返回 ?
AllocateTypedArray (ctorName, NewTarget, proto, elementLength)。
23.2.5.1.1 AllocateTypedArray ( ctorName, newTarget, defaultProto [ , length ] )
The abstract operation AllocateTypedArray takes arguments ctorName (a String which is the name of a
- 令 proto 为 ?
GetPrototypeFromConstructor (newTarget, defaultProto)。 - 令 obj 为
TypedArrayCreate (proto)。 - 断言：obj.[[ViewedArrayBuffer]] 是
undefined 。 - 将 obj.[[TypedArrayName]] 设置为 ctorName。
- 如果 ctorName 是
"BigInt64Array" 或"BigUint64Array" ，则将 obj.[[ContentType]] 设置为bigint 。 - 否则，将 obj.[[ContentType]] 设置为
number 。 - 如果 length 不存在，则
- 将 obj.[[ByteLength]] 设置为 0。
- 将 obj.[[ByteOffset]] 设置为 0。
- 将 obj.[[ArrayLength]] 设置为 0。
- 否则，
- 执行 ?
AllocateTypedArrayBuffer (obj, length)。
- 执行 ?
- 返回 obj。
23.2.5.1.2 InitializeTypedArrayFromTypedArray ( obj, sourceArray )
The abstract operation InitializeTypedArrayFromTypedArray takes arguments obj (a
- 令 sourceData 为 sourceArray.[[ViewedArrayBuffer]]。
- 令 elementType 为
TypedArrayElementType (obj)。 - 令 elementSize 为
TypedArrayElementSize (obj)。 - 令 sourceType 为
TypedArrayElementType (sourceArray)。 - 令 sourceElementSize 为
TypedArrayElementSize (sourceArray)。 - 令 sourceByteOffset 为 sourceArray.[[ByteOffset]]。
- 令 sourceRecord 为
MakeTypedArrayWithBufferWitnessRecord (sourceArray,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (sourceRecord) 是true ，则抛出TypeError 异常。 - 令 elementLength 为
TypedArrayLength (sourceRecord)。 - 令 byteLength 为 elementSize × elementLength。
- 如果 elementType 是 sourceType，则
- 令 data 为 ?
CloneArrayBuffer (sourceData, sourceByteOffset, byteLength)。
- 令 data 为 ?
- 否则，
- 令 data 为 ?
AllocateArrayBuffer (%ArrayBuffer% , byteLength)。 - 如果 sourceArray.[[ContentType]] 不是 obj.[[ContentType]]，则抛出
TypeError 异常。 - 令 sourceByteIndex 为 sourceByteOffset。
- 令 targetByteIndex 为 0。
- 令 count 为 elementLength。
- 重复，只要 count > 0，
- 令 value 为
GetValueFromBuffer (sourceData, sourceByteIndex, sourceType,true ,unordered )。 - 执行
SetValueInBuffer (data, targetByteIndex, elementType, value,true ,unordered )。 - 将 sourceByteIndex 设置为 sourceByteIndex + sourceElementSize。
- 将 targetByteIndex 设置为 targetByteIndex + elementSize。
- 将 count 设置为 count - 1。
- 令 value 为
- 令 data 为 ?
- 将 obj.[[ViewedArrayBuffer]] 设置为 data。
- 将 obj.[[ByteLength]] 设置为 byteLength。
- 将 obj.[[ByteOffset]] 设置为 0。
- 将 obj.[[ArrayLength]] 设置为 elementLength。
- 返回
unused 。
23.2.5.1.3 InitializeTypedArrayFromArrayBuffer ( obj, buffer, byteOffset, length )
The abstract operation InitializeTypedArrayFromArrayBuffer takes arguments obj (a
- 令 elementSize 为
TypedArrayElementSize (obj)。 - 令 offset 为 ?
ToIndex (byteOffset)。 - 如果 offset 模 elementSize ≠ 0，则抛出
RangeError 异常。 - 令 bufferIsFixedLength 为
IsFixedLengthArrayBuffer (buffer)。 - 如果 length 不是
undefined ，则- 令 newLength 为 ?
ToIndex (length)。
- 令 newLength 为 ?
- 如果
IsDetachedBuffer (buffer) 是true ，则抛出TypeError 异常。 - 令 bufferByteLength 为
ArrayBufferByteLength (buffer,seq-cst )。 - 如果 length 是
undefined 且 bufferIsFixedLength 是false ，则- 如果 offset > bufferByteLength，则抛出
RangeError 异常。 - 将 obj.[[ByteLength]] 设置为
auto 。 - 将 obj.[[ArrayLength]] 设置为
auto 。
- 如果 offset > bufferByteLength，则抛出
- 否则，
- 如果 length 是
undefined ，则- 如果 bufferByteLength 模 elementSize ≠ 0，则抛出
RangeError 异常。 - 令 newByteLength 为 bufferByteLength - offset。
- 如果 newByteLength < 0，则抛出
RangeError 异常。
- 如果 bufferByteLength 模 elementSize ≠ 0，则抛出
- 否则，
- 令 newByteLength 为 newLength × elementSize。
- 如果 offset + newByteLength > bufferByteLength，则抛出
RangeError 异常。
- 将 obj.[[ByteLength]] 设置为 newByteLength。
- 将 obj.[[ArrayLength]] 设置为 newByteLength / elementSize。
- 如果 length 是
- 将 obj.[[ViewedArrayBuffer]] 设置为 buffer。
- 将 obj.[[ByteOffset]] 设置为 offset。
- 返回
unused 。
23.2.5.1.4 InitializeTypedArrayFromList ( obj, values )
The abstract operation InitializeTypedArrayFromList takes arguments obj (a
- 令 length 为 values 中元素的数量。
- 执行 ?
AllocateTypedArrayBuffer (obj, length)。 - 令 k 为 0。
- 重复，只要 k < length，
- 断言：values 现在是空
List 。 - 返回
unused 。
23.2.5.1.5 InitializeTypedArrayFromArrayLike ( obj, arrayLike )
The abstract operation InitializeTypedArrayFromArrayLike takes arguments obj (a
- 令 length 为 ?
LengthOfArrayLike (arrayLike)。 - 执行 ?
AllocateTypedArrayBuffer (obj, length)。 - 令 k 为 0。
- 重复，只要 k < length，
- 返回
unused 。
23.2.5.1.6 AllocateTypedArrayBuffer ( obj, length )
The abstract operation AllocateTypedArrayBuffer takes arguments obj (a
- 断言：obj.[[ViewedArrayBuffer]] 是
undefined 。 - 令 elementSize 为
TypedArrayElementSize (obj)。 - 令 byteLength 为 elementSize × length。
- 令 data 为 ?
AllocateArrayBuffer (%ArrayBuffer% , byteLength)。 - 将 obj.[[ViewedArrayBuffer]] 设置为 data。
- 将 obj.[[ByteLength]] 设置为 byteLength。
- 将 obj.[[ByteOffset]] 设置为 0。
- 将 obj.[[ArrayLength]] 设置为 length。
- 返回
unused 。
23.2.6 TypedArray 构造器的属性
每个 TypedArray 构造器：
- 具有一个 [[Prototype]] 内部槽，其值为
%TypedArray% 。 - 具有一个
"length" 属性，其值为3 𝔽。 - 具有一个
"name" 属性，其值是在Table 71 中为其指定的构造器名称的 String 值。 - 具有以下属性：
23.2.6.1 TypedArray.BYTES_PER_ELEMENT
TypedArray.BYTES_PER_ELEMENT 的值是
此属性具有特性 { [[Writable]]:
23.2.6.2 TypedArray.prototype
TypedArray.prototype 的初始值是对应的 TypedArray 原型固有对象（
此属性具有特性 { [[Writable]]:
23.2.7 TypedArray 原型对象的属性
每个 TypedArray 原型对象：
- 具有一个 [[Prototype]] 内部槽，其值为
%TypedArray.prototype% 。 - 是
普通对象 。 - 没有 [[ViewedArrayBuffer]]，也没有任何其他 TypedArray 实例对象专有的内部槽。
23.2.7.1 TypedArray.prototype.BYTES_PER_ELEMENT
TypedArray.prototype.BYTES_PER_ELEMENT 的值是
此属性具有特性 { [[Writable]]:
23.2.7.2 TypedArray.prototype.constructor
给定 TypedArray 构造器的原型的
23.2.8 TypedArray 实例的属性
TypedArray 实例是
23.3 Uint8Array 对象
Uint8Array 是上文所述 TypedArray 的一种特定类型。此外，Uint8Array 构造器（
23.3.1 Uint8Array 构造器的额外属性
23.3.1.1 Uint8Array.fromBase64 ( string [ , options ] )
- 如果 string 不是 String，则抛出
TypeError 异常。 - 令 opts 为 ?
GetOptionsObject (options)。 - 令 alphabet 为 ?
Get (opts,"alphabet" )。 - 如果 alphabet 是
undefined ，则将 alphabet 设置为"base64" 。 - 如果 alphabet 既不是
"base64" 也不是"base64url" ，则抛出TypeError 异常。 - 令 lastChunkHandling 为 ?
Get (opts,"lastChunkHandling" )。 - 如果 lastChunkHandling 是
undefined ，则将 lastChunkHandling 设置为"loose" 。 - 如果 lastChunkHandling 不是
"loose" 、"strict" 或"stop-before-partial" 之一，则抛出TypeError 异常。 - 令 result 为
FromBase64 (string, alphabet, lastChunkHandling)。 - 如果 result.[[Error]] 不是
none ，则- 抛出 result.[[Error]]。
- 令 resultLength 为 result.[[Bytes]] 中元素的数量。
- 令 ta 为 ?
AllocateTypedArray ("Uint8Array" ,%Uint8Array% ,"%Uint8Array.prototype%" , resultLength)。 - 断言：ta.[[ViewedArrayBuffer]].[[ArrayBufferByteLength]] 是 result.[[Bytes]] 中元素的数量。
- 将 ta.[[ViewedArrayBuffer]].[[ArrayBufferData]] 的每个索引处的值设置为 result.[[Bytes]] 中对应索引处的值。
- 返回 ta。
23.3.1.2 Uint8Array.fromHex ( string )
- 如果 string 不是 String，则抛出
TypeError 异常。 - 令 result 为
FromHex (string)。 - 如果 result.[[Error]] 不是
none ，则- 抛出 result.[[Error]]。
- 令 resultLength 为 result.[[Bytes]] 中元素的数量。
- 令 ta 为 ?
AllocateTypedArray ("Uint8Array" ,%Uint8Array% ,"%Uint8Array.prototype%" , resultLength)。 - 断言：ta.[[ViewedArrayBuffer]].[[ArrayBufferByteLength]] 是 result.[[Bytes]] 中元素的数量。
- 将 ta.[[ViewedArrayBuffer]].[[ArrayBufferData]] 的每个索引处的值设置为 result.[[Bytes]] 中对应索引处的值。
- 返回 ta。
23.3.2 Uint8Array 原型对象的额外属性
23.3.2.1 Uint8Array.prototype.setFromBase64 ( string [ , options ] )
- 令 into 为
this 值。 - 执行 ?
ValidateUint8Array (into)。 - 如果 string 不是 String，则抛出
TypeError 异常。 - 令 opts 为 ?
GetOptionsObject (options)。 - 令 alphabet 为 ?
Get (opts,"alphabet" )。 - 如果 alphabet 是
undefined ，则将 alphabet 设置为"base64" 。 - 如果 alphabet 既不是
"base64" 也不是"base64url" ，则抛出TypeError 异常。 - 令 lastChunkHandling 为 ?
Get (opts,"lastChunkHandling" )。 - 如果 lastChunkHandling 是
undefined ，则将 lastChunkHandling 设置为"loose" 。 - 如果 lastChunkHandling 不是
"loose" 、"strict" 或"stop-before-partial" 之一，则抛出TypeError 异常。 - 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (into,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (taRecord) 是true ，则抛出TypeError 异常。 - 令 byteLength 为
TypedArrayLength (taRecord)。 - 令 result 为
FromBase64 (string, alphabet, lastChunkHandling, byteLength)。 - 令 bytes 为 result.[[Bytes]]。
- 令 written 为 bytes 中元素的数量。
- 注：
FromBase64 不调用任何用户代码，因此支撑 into 的 ArrayBuffer 不可能已被分离或缩小。 - 断言：written ≤ byteLength。
- 执行
SetUint8ArrayBytes (into, bytes)。 - 如果 result.[[Error]] 不是
none ，则- 抛出 result.[[Error]]。
- 令 resultObj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 !
CreateDataPropertyOrThrow (resultObj,"read" ,𝔽 (result.[[Read]]))。 - 执行 !
CreateDataPropertyOrThrow (resultObj,"written" ,𝔽 (written))。 - 返回 resultObj。
23.3.2.2 Uint8Array.prototype.setFromHex ( string )
- 令 into 为
this 值。 - 执行 ?
ValidateUint8Array (into)。 - 如果 string 不是 String，则抛出
TypeError 异常。 - 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (into,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (taRecord) 是true ，则抛出TypeError 异常。 - 令 byteLength 为
TypedArrayLength (taRecord)。 - 令 result 为
FromHex (string, byteLength)。 - 令 bytes 为 result.[[Bytes]]。
- 令 written 为 bytes 中元素的数量。
- 注：
FromHex 不调用任何用户代码，因此支撑 into 的 ArrayBuffer 不可能已被分离或缩小。 - 断言：written ≤ byteLength。
- 执行
SetUint8ArrayBytes (into, bytes)。 - 如果 result.[[Error]] 不是
none ，则- 抛出 result.[[Error]]。
- 令 resultObj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 !
CreateDataPropertyOrThrow (resultObj,"read" ,𝔽 (result.[[Read]]))。 - 执行 !
CreateDataPropertyOrThrow (resultObj,"written" ,𝔽 (written))。 - 返回 resultObj。
23.3.2.3 Uint8Array.prototype.toBase64 ( [ options ] )
- 令 obj 为
this 值。 - 执行 ?
ValidateUint8Array (obj)。 - 令 opts 为 ?
GetOptionsObject (options)。 - 令 alphabet 为 ?
Get (opts,"alphabet" )。 - 如果 alphabet 是
undefined ，则将 alphabet 设置为"base64" 。 - 如果 alphabet 既不是
"base64" 也不是"base64url" ，则抛出TypeError 异常。 - 令 omitPadding 为
ToBoolean (?Get (opts,"omitPadding" ))。 - 令 toEncode 为 ?
GetUint8ArrayBytes (obj)。 - 如果 alphabet 是
"base64" ，则 - 否则，
- 返回
CodePointsToString (outAscii)。
23.3.2.4 Uint8Array.prototype.toHex ( )
- 令 obj 为
this 值。 - 执行 ?
ValidateUint8Array (obj)。 - 令 toEncode 为 ?
GetUint8ArrayBytes (obj)。 - 令 out 为空 String。
- 对 toEncode 的每个字节 byte，执行：
- 令 hex 为
Number::toString (𝔽 (byte), 16)。 - 将 hex 设置为
StringPad (hex, 2,"0" ,start )。 - 将 out 设置为 out 和 hex 的
字符串连接 。
- 令 hex 为
- 返回 out。
23.3.3 Uint8Array 对象的抽象操作
23.3.3.1 ValidateUint8Array ( ta )
The abstract operation ValidateUint8Array takes argument ta (an ECMAScript language value) and returns either a normal completion containing
- 执行 ?
RequireInternalSlot (ta, [[TypedArrayName]])。 - 如果 ta.[[TypedArrayName]] 不是
"Uint8Array" ，则抛出TypeError 异常。 - 返回
unused 。
23.3.3.2 GetUint8ArrayBytes ( ta )
The abstract operation GetUint8ArrayBytes takes argument ta (a Uint8Array) and returns either a normal completion containing a
- 令 buffer 为 ta.[[ViewedArrayBuffer]]。
- 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (ta,seq-cst )。 - 如果
IsTypedArrayOutOfBounds (taRecord) 是true ，则抛出TypeError 异常。 - 令 length 为
TypedArrayLength (taRecord)。 - 令 byteOffset 为 ta.[[ByteOffset]]。
- 令 bytes 为新的空
List 。 - 令 index 为 0。
- 重复，只要 index < length，
- 令 byteIndex 为 byteOffset + index。
- 令 byte 为
ℝ (GetValueFromBuffer (buffer, byteIndex,uint8 ,true ,unordered ))。 - 将 byte 追加到 bytes。
- 将 index 设置为 index + 1。
- 返回 bytes。
23.3.3.3 SetUint8ArrayBytes ( into, bytes )
The abstract operation SetUint8ArrayBytes takes arguments into (a Uint8Array) and bytes (a
- 令 offset 为 into.[[ByteOffset]]。
- 令 length 为 bytes 中元素的数量。
- 令 index 为 0。
- 重复，只要 index < length，
- 令 byte 为 bytes[index]。
- 令 byteIndexInBuffer 为 index + offset。
- 执行
SetValueInBuffer (into.[[ViewedArrayBuffer]], byteIndexInBuffer,uint8 ,𝔽 (byte),true ,unordered )。 - 将 index 设置为 index + 1。
- 返回
unused 。
23.3.3.4 SkipAsciiWhitespace ( string, index )
The abstract operation SkipAsciiWhitespace takes arguments string (a String) and index (a non-negative
- 令 length 为 string 的长度。
- 重复，只要 index < length，
- 令 char 为 string 中索引 index 处的码元。
- 如果 char 不是 0x0009（TAB）、0x000A（LF）、0x000C（FF）、0x000D（CR）或 0x0020（SPACE）之一，则
- 返回 index。
- 将 index 设置为 index + 1。
- 返回 index。
23.3.3.5 DecodeFinalBase64Chunk ( chunk, throwOnExtraBits )
The abstract operation DecodeFinalBase64Chunk takes arguments chunk (a String of length 2 or 3) and throwOnExtraBits (a Boolean) and returns either a normal completion containing a
- 令 chunkLength 为 chunk 的长度。
- 如果 chunkLength = 2，则
- 将 chunk 设置为 chunk 和
"AA" 的字符串连接 。
- 将 chunk 设置为 chunk 和
- 否则，
- 断言：chunkLength 是 3。
- 将 chunk 设置为 chunk 和
"A" 的字符串连接 。
- 令 bytes 为
DecodeFullLengthBase64Chunk (chunk)。 - 如果 chunkLength = 2，则
- 如果 throwOnExtraBits 是
true 且 bytes[1] ≠ 0，则抛出SyntaxError 异常。 - 返回 « bytes[0] »。
- 如果 throwOnExtraBits 是
- 如果 throwOnExtraBits 是
true 且 bytes[2] ≠ 0，则抛出SyntaxError 异常。 - 返回 « bytes[0], bytes[1] »。
23.3.3.6 DecodeFullLengthBase64Chunk ( chunk )
The abstract operation DecodeFullLengthBase64Chunk takes argument chunk (a String of length 4) and returns a
标准 base64 字母表是
23.3.3.7 FromBase64 ( string, alphabet, lastChunkHandling [ , maxLength ] )
The abstract operation FromBase64 takes arguments string (a String), alphabet (
- 如果 maxLength 不存在，则
- 将 maxLength 设置为 253 - 1。
- 注：因为输入是 String，String 的长度被限制为 253 - 1 个字符，并且输出所需的字节数不超过输入的字符数，所以这个限制永远不可能达到。不过，为了编辑上的方便，这里使用一个
有限 值作为 maxLength。
- 注：下方算法中验证和解码的顺序不可观察。鼓励实现以最高效的任意顺序执行它们，也可以将验证与解码交错执行。
- 如果 maxLength = 0，则
- 返回
Record { [[Read]]: 0, [[Bytes]]: « », [[Error]]:none }。
- 返回
- 令 read 为 0。
- 令 bytes 为新的空
List 。 - 令 chunk 为空 String。
- 令 chunkLength 为 0。
- 令 index 为 0。
- 令 length 为 string 的长度。
- 重复，
- 断言：bytes 中元素的数量可被 3 整除。
- 将 index 设置为
SkipAsciiWhitespace (string, index)。 - 如果 index = length，则
- 如果 chunkLength > 0，则
- 如果 lastChunkHandling 是
"stop-before-partial" ，则- 返回
Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]:none }。
- 返回
- 如果 lastChunkHandling 是
"strict" ，则- 令 error 为新创建的
SyntaxError 对象。 - 返回
Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }。
- 令 error 为新创建的
- 断言：lastChunkHandling 是
"loose" 。 - 如果 chunkLength = 1，则
- 令 error 为新创建的
SyntaxError 对象。 - 返回
Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }。
- 令 error 为新创建的
- 将 bytes 设置为 bytes 和 !
DecodeFinalBase64Chunk (chunk,false ) 的列表连接 。
- 如果 lastChunkHandling 是
- 返回
Record { [[Read]]: length, [[Bytes]]: bytes, [[Error]]:none }。
- 如果 chunkLength > 0，则
- 令 char 为 string 从 index 到 index + 1 的
子字符串 。 - 将 index 设置为 index + 1。
- 如果 char 是
"=" ，则- 如果 chunkLength < 2，则
- 令 error 为新创建的
SyntaxError 对象。 - 返回
Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }。
- 令 error 为新创建的
- 将 index 设置为
SkipAsciiWhitespace (string, index)。 - 如果 chunkLength = 2，则
- 如果 index = length，则
- 将 char 设置为 string 从 index 到 index + 1 的
子字符串 。 - 如果 char 是
"=" ，则- 将 index 设置为
SkipAsciiWhitespace (string, index + 1)。
- 将 index 设置为
- 如果 index < length，则
- 令 error 为新创建的
SyntaxError 对象。 - 返回
Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }。
- 令 error 为新创建的
- 如果 lastChunkHandling 是
"strict" ，则令 throwOnExtraBits 为true ；否则令 throwOnExtraBits 为false 。 - 令 decodeResult 为
Completion (DecodeFinalBase64Chunk (chunk, throwOnExtraBits))。 - 如果 decodeResult 是
突然完成 ，则- 令 error 为 decodeResult.[[Value]]。
- 返回
Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }。
- 将 bytes 设置为 bytes 和 ! decodeResult 的
列表连接 。 - 返回
Record { [[Read]]: length, [[Bytes]]: bytes, [[Error]]:none }。
- 如果 chunkLength < 2，则
- 如果 alphabet 是
"base64url" ，则- 如果 char 是
"+" 或"/" ，则- 令 error 为新创建的
SyntaxError 对象。 - 返回
Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }。
- 令 error 为新创建的
- 否则，如果 char 是
"-" ，则- 将 char 设置为
"+" 。
- 将 char 设置为
- 否则，如果 char 是
"_" ，则- 将 char 设置为
"/" 。
- 将 char 设置为
- 如果 char 是
- 如果 char 的唯一码元不是
标准 base64 字母表 的元素，则- 令 error 为新创建的
SyntaxError 对象。 - 返回
Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }。
- 令 error 为新创建的
- 令 remaining 为 maxLength - bytes 中元素的数量。
- 如果 remaining = 1 且 chunkLength = 2，或如果 remaining = 2 且 chunkLength = 3，则
- 返回
Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]:none }。
- 返回
- 将 chunk 设置为 chunk 和 char 的
字符串连接 。 - 将 chunkLength 设置为 chunk 的长度。
- 如果 chunkLength = 4，则
- 将 bytes 设置为 bytes 和
DecodeFullLengthBase64Chunk (chunk) 的列表连接 。 - 将 chunk 设置为空 String。
- 将 chunkLength 设置为 0。
- 将 read 设置为 index。
- 如果 bytes 中元素的数量 = maxLength，则
- 返回
Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]:none }。
- 返回
- 将 bytes 设置为 bytes 和
23.3.3.8 FromHex ( string [ , maxLength ] )
The abstract operation FromHex takes argument string (a String) and optional argument maxLength (a non-negative
- 如果 maxLength 不存在，则将 maxLength 设置为 253 - 1。
- 令 length 为 string 的长度。
- 令 bytes 为新的空
List 。 - 令 read 为 0。
- 如果 length 模 2 ≠ 0，则
- 令 error 为新创建的
SyntaxError 对象。 - 返回
Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }。
- 令 error 为新创建的
- 重复，只要 read < length 且 bytes 中元素的数量 < maxLength，
- 返回
Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]:none }。
24 键控集合
24.1 Map 对象
Map 是键/值对的集合，其中键和值都可以是任意
Map 必须使用哈希表或其他机制来实现，这些机制平均而言提供的访问时间相对于集合中元素数量是次线性的。本规范中使用的数据结构仅用于描述 Map 所要求的可观察语义。它并不旨在作为可行的实现模型。
24.1.1 Map 构造器
Map 构造器：
- 是 %Map%。
- 是
全局对象 的"Map" 属性的初始值。 - 在作为构造器调用时创建并初始化一个新的 Map。
- 不意图作为函数调用，并且以这种方式调用时会抛出异常。
- 可以用作类定义的
extends子句中的值。打算继承指定 Map 行为的子类构造函数 ，必须包含 一次对 Map构造函数 的super调用，以创建并初始化子类实例，使其具备支持Map.prototype的内置方法所必需的内部状态。
24.1.1.1 Map ( [ iterable ] )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 是
undefined ，则抛出TypeError 异常。 - 令 map 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%Map.prototype%" , « [[MapData]] »)。 - 将 map.[[MapData]] 设置为新的空
List 。 - 如果 iterable 是
undefined 或null ，则返回 map。 - 令 adder 为 ?
Get (map,"set" )。 - 如果
IsCallable (adder) 是false ，则抛出TypeError 异常。 - 返回 ?
AddEntriesFromIterable (map, iterable, adder)。
如果存在参数 iterable，则它预期为实现了
24.1.1.2 AddEntriesFromIterable ( target, iterable, adder )
The abstract operation AddEntriesFromIterable takes arguments target (an Object), iterable (an ECMAScript language value, but not
- 令 iteratorRecord 为 ?
GetIterator (iterable,sync )。 - 重复，
- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 是
done ，则返回 target。 - 如果 next 不是 Object，则
- 令 error 为
ThrowCompletion (一个新创建的TypeError 对象)。 - 返回 ?
IteratorClose (iteratorRecord, error)。
- 令 error 为
- 令 key 为
Completion (Get (next,"0" ))。 IfAbruptCloseIterator (key, iteratorRecord)。- 令 value 为
Completion (Get (next,"1" ))。 IfAbruptCloseIterator (value, iteratorRecord)。- 令 status 为
Completion (Call (adder, target, « key, value »))。 IfAbruptCloseIterator (status, iteratorRecord)。
- 令 next 为 ?
参数 iterable 预期为实现了
24.1.2 Map 构造器的属性
Map 构造器：
- 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
24.1.2.1 Map.groupBy ( items, callback )
callback 应当是一个接受两个实参的函数。groupBy 会按升序为 items 中的每个元素调用一次 callback，并构造一个新的 Map。callback 返回的每个值都用作 Map 中的键。对于每个这样的键，结果 Map 都有一个条目，其键为该键，其值为一个数组，
callback 会以两个实参调用：元素的值和元素的索引。
groupBy 的返回值是一个 Map。
此函数在被调用时执行以下步骤：
24.1.2.2 Map.prototype
Map.prototype 的初始值是
此属性具有特性 { [[Writable]]:
24.1.2.3 get Map [ %Symbol.species% ]
Map[%Symbol.species%] 是
- 返回
this 值。
此函数的
创建派生集合对象的方法应调用
24.1.3 Map 原型对象的属性
Map 原型对象：
- 是 %Map.prototype%。
- 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是
普通对象 。 - 没有 [[MapData]] 内部槽。
24.1.3.1 Map.prototype.clear ( )
此方法在被调用时执行以下步骤：
- 令 map 为
this 值。 - 执行 ?
RequireInternalSlot (map, [[MapData]])。 - 对 map.[[MapData]] 的每个
Record { [[Key]], [[Value]] } entry，执行：- 将 entry.[[Key]] 设置为
empty 。 - 将 entry.[[Value]] 设置为
empty 。
- 将 entry.[[Key]] 设置为
- 返回
undefined 。
现有的 [[MapData]]
24.1.3.2 Map.prototype.constructor
Map.prototype.constructor 的初始值是
24.1.3.3 Map.prototype.delete ( key )
此方法在被调用时执行以下步骤：
- 令 map 为
this 值。 - 执行 ?
RequireInternalSlot (map, [[MapData]])。 - 将 key 设置为
CanonicalizeKeyedCollectionKey (key)。 - 对 map.[[MapData]] 的每个
Record { [[Key]], [[Value]] } entry，执行：- 如果 entry.[[Key]] 不是
empty 且SameValue (entry.[[Key]], key) 是true ，则- 将 entry.[[Key]] 设置为
empty 。 - 将 entry.[[Value]] 设置为
empty 。 - 返回
true 。
- 将 entry.[[Key]] 设置为
- 如果 entry.[[Key]] 不是
- 返回
false 。
值
24.1.3.4 Map.prototype.entries ( )
此方法在被调用时执行以下步骤：
- 令 map 为
this 值。 - 返回 ?
CreateMapIterator (map,key+value )。
24.1.3.5 Map.prototype.forEach ( callback [ , thisArg ] )
此方法在被调用时执行以下步骤：
- 令 map 为
this 值。 - 执行 ?
RequireInternalSlot (map, [[MapData]])。 - 如果
IsCallable (callback) 是false ，则抛出TypeError 异常。 - 令 entries 为 map.[[MapData]]。
- 令 entriesCount 为 entries 中元素的数量。
- 令 index 为 0。
- 重复，只要 index < entriesCount，
- 令 entry 为 entries[index]。
- 将 index 设置为 index + 1。
- 如果 entry.[[Key]] 不是
empty ，则- 执行 ?
Call (callback, thisArg, « entry.[[Value]], entry.[[Key]], map »)。 - 注：entries 中元素的数量可能已在 callback 执行期间增加。
- 将 entriesCount 设置为 entries 中元素的数量。
- 执行 ?
- 返回
undefined 。
callback 应当是一个接受三个实参的函数。forEach 会按键插入顺序，为 Map 中存在的每个键/值对调用一次 callback。callback 只会为 Map 中实际存在的键调用；不会为已经从 Map 中删除的键调用。
如果提供了 thisArg 参数，则它会被用作每次调用 callback 时的
callback 会以三个实参调用：项的值、项的键，以及正在遍历的 Map。
forEach 不会直接改变调用它的对象，但该对象可能会被对 callback 的调用改变。Map 的 [[MapData]] 的每个条目只会被访问一次。在对 forEach 的调用开始之后添加的新键会被访问。如果某个键在被访问后被删除，然后又在 forEach 调用完成前重新添加，则该键会再次被访问。在对 forEach 的调用开始之后且被访问之前删除的键不会被访问，除非该键在 forEach 调用完成前再次被添加。
24.1.3.6 Map.prototype.get ( key )
此方法在被调用时执行以下步骤：
- 令 map 为
this 值。 - 执行 ?
RequireInternalSlot (map, [[MapData]])。 - 将 key 设置为
CanonicalizeKeyedCollectionKey (key)。 - 对 map.[[MapData]] 的每个
Record { [[Key]], [[Value]] } entry，执行：- 如果 entry.[[Key]] 不是
empty 且SameValue (entry.[[Key]], key) 是true ，则返回 entry.[[Value]]。
- 如果 entry.[[Key]] 不是
- 返回
undefined 。
24.1.3.7 Map.prototype.getOrInsert ( key, value )
此方法在被调用时执行以下步骤：
- 令 map 为
this 值。 - 执行 ?
RequireInternalSlot (map, [[MapData]])。 - 将 key 设置为
CanonicalizeKeyedCollectionKey (key)。 - 对 map.[[MapData]] 的每个
Record { [[Key]], [[Value]] } entry，执行：- 如果 entry.[[Key]] 不是
empty 且SameValue (entry.[[Key]], key) 是true ，则返回 entry.[[Value]]。
- 如果 entry.[[Key]] 不是
- 令 entry 为
Record { [[Key]]: key, [[Value]]: value }。 - 将 entry 追加到 map.[[MapData]]。
- 返回 value。
24.1.3.8 Map.prototype.getOrInsertComputed ( key, callback )
此方法在被调用时执行以下步骤：
- 令 map 为
this 值。 - 执行 ?
RequireInternalSlot (map, [[MapData]])。 - 如果
IsCallable (callback) 是false ，则抛出TypeError 异常。 - 将 key 设置为
CanonicalizeKeyedCollectionKey (key)。 - 对 map.[[MapData]] 的每个
Record { [[Key]], [[Value]] } entry，执行：- 如果 entry.[[Key]] 不是
empty 且SameValue (entry.[[Key]], key) 是true ，则返回 entry.[[Value]]。
- 如果 entry.[[Key]] 不是
- 令 value 为 ?
Call (callback,undefined , « key »)。 - 注：Map 可能已在 callback 执行期间被修改。
- 对 map.[[MapData]] 的每个
Record { [[Key]], [[Value]] } entry，执行：- 如果 entry.[[Key]] 不是
empty 且SameValue (entry.[[Key]], key) 是true ，则- 将 entry.[[Value]] 设置为 value。
- 返回 value。
- 如果 entry.[[Key]] 不是
- 令 entry 为
Record { [[Key]]: key, [[Value]]: value }。 - 将 entry 追加到 map.[[MapData]]。
- 返回 value。
24.1.3.9 Map.prototype.has ( key )
此方法在被调用时执行以下步骤：
- 令 map 为
this 值。 - 执行 ?
RequireInternalSlot (map, [[MapData]])。 - 将 key 设置为
CanonicalizeKeyedCollectionKey (key)。 - 对 map.[[MapData]] 的每个
Record { [[Key]], [[Value]] } entry，执行：- 如果 entry.[[Key]] 不是
empty 且SameValue (entry.[[Key]], key) 是true ，则返回true 。
- 如果 entry.[[Key]] 不是
- 返回
false 。
24.1.3.10 Map.prototype.keys ( )
此方法在被调用时执行以下步骤：
- 令 map 为
this 值。 - 返回 ?
CreateMapIterator (map,key )。
24.1.3.11 Map.prototype.set ( key, value )
此方法在被调用时执行以下步骤：
- 令 map 为
this 值。 - 执行 ?
RequireInternalSlot (map, [[MapData]])。 - 将 key 设置为
CanonicalizeKeyedCollectionKey (key)。 - 对 map.[[MapData]] 的每个
Record { [[Key]], [[Value]] } entry，执行：- 如果 entry.[[Key]] 不是
empty 且SameValue (entry.[[Key]], key) 是true ，则- 将 entry.[[Value]] 设置为 value。
- 返回 map。
- 如果 entry.[[Key]] 不是
- 令 entry 为
Record { [[Key]]: key, [[Value]]: value }。 - 将 entry 追加到 map.[[MapData]]。
- 返回 map。
24.1.3.12 get Map.prototype.size
Map.prototype.size 是
- 令 map 为
this 值。 - 执行 ?
RequireInternalSlot (map, [[MapData]])。 - 令 count 为 0。
- 对 map.[[MapData]] 的每个
Record { [[Key]], [[Value]] } entry，执行：- 如果 entry.[[Key]] 不是
empty ，则将 count 设置为 count + 1。
- 如果 entry.[[Key]] 不是
- 返回
𝔽 (count)。
24.1.3.13 Map.prototype.values ( )
此方法在被调用时执行以下步骤：
- 令 map 为
this 值。 - 返回 ?
CreateMapIterator (map,value )。
24.1.3.14 Map.prototype [ %Symbol.iterator% ] ( )
24.1.3.15 Map.prototype [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
24.1.4 Map 实例的属性
24.1.5 Map Iterator 对象
Map Iterator 是表示对某个特定 Map 实例对象进行特定迭代的对象。Map Iterator 对象没有具名构造器。相反，Map Iterator 对象通过调用 Map 实例对象的某些方法创建。
24.1.5.1 CreateMapIterator ( map, kind )
The abstract operation CreateMapIterator takes arguments map (an ECMAScript language value) and kind (
- 执行 ?
RequireInternalSlot (map, [[MapData]])。 - 令 closure 为一个新的无参数
Abstract Closure ，它捕获 map 和 kind，并在被调用时执行以下步骤：- 令 entries 为 map.[[MapData]]。
- 令 index 为 0。
- 令 entriesCount 为 entries 中元素的数量。
- 重复，只要 index < entriesCount，
- 令 entry 为 entries[index]。
- 将 index 设置为 index + 1。
- 如果 entry.[[Key]] 不是
empty ，则- 如果 kind 是
key ，则- 令 result 为 entry.[[Key]]。
- 否则，如果 kind 是
value ，则- 令 result 为 entry.[[Value]]。
- 否则，
- 断言：kind 是
key+value 。 - 令 result 为
CreateArrayFromList (« entry.[[Key]], entry.[[Value]] »)。
- 断言：kind 是
- 执行 ?
GeneratorYield (CreateIteratorResultObject (result,false ))。 - 注：当此
抽象操作 的执行因GeneratorYield 而暂停时，entries 中元素的数量可能已经增加。 - 将 entriesCount 设置为 entries 中元素的数量。
- 如果 kind 是
- 返回
NormalCompletion (unused )。
- 返回
CreateIteratorFromClosure (closure,"%MapIteratorPrototype%" ,%MapIteratorPrototype% )。
24.1.5.2 %MapIteratorPrototype% 对象
%MapIteratorPrototype% 对象：
- 具有由所有
Map Iterator 对象继承的属性。 - 是
普通对象 。 - 具有一个 [[Prototype]] 内部槽，其值为
%Iterator.prototype% 。 - 具有以下属性：
24.1.5.2.1 %MapIteratorPrototype%.next ( )
- 返回 ?
GeneratorResume (this value,empty ,"%MapIteratorPrototype%" )。
24.1.5.2.2 %MapIteratorPrototype% [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
24.2 Set 对象
Set 对象是
Set 对象必须使用哈希表或其他机制来实现，这些机制平均而言提供的访问时间相对于集合中元素数量是次线性的。本规范中使用的数据结构仅用于描述 Set 对象所要求的可观察语义。它并不旨在作为可行的实现模型。
24.2.1 Set 对象的抽象操作
24.2.1.1 Set Record
Set Record 是一种
Set Record 具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[SetObject]] | an Object | Set 或类似对象。 |
| [[Size]] |
a non-negative |
对象报告的大小。 |
| [[Has]] | a function object |
对象的 has 方法。
|
| [[Keys]] | a function object |
对象的 keys 方法。
|
24.2.1.2 GetSetRecord ( obj )
The abstract operation GetSetRecord takes argument obj (an ECMAScript language value) and returns either a normal completion containing a
- 如果 obj 不是 Object，则抛出
TypeError 异常。 - 令 rawSize 为 ?
Get (obj,"size" )。 - 令 numberSize 为 ?
ToNumber (rawSize)。 - 注：如果 rawSize 是
undefined ，则 numberSize 将是NaN 。 - 如果 numberSize 是
NaN ，则抛出TypeError 异常。 - 令 intSize 为 !
ToIntegerOrInfinity (numberSize)。 - 如果 intSize < 0，则抛出
RangeError 异常。 - 令 has 为 ?
Get (obj,"has" )。 - 如果
IsCallable (has) 是false ，则抛出TypeError 异常。 - 令 keys 为 ?
Get (obj,"keys" )。 - 如果
IsCallable (keys) 是false ，则抛出TypeError 异常。 - 返回新的
Set Record { [[SetObject]]: obj, [[Size]]: intSize, [[Has]]: has, [[Keys]]: keys }。
24.2.1.3 SetDataHas ( setData, value )
The abstract operation SetDataHas takes arguments setData (a
- 如果
SetDataIndex (setData, value) 是not-found ，则返回false 。 - 返回
true 。
24.2.1.4 SetDataIndex ( setData, value )
The abstract operation SetDataIndex takes arguments setData (a
- 将 value 设置为
CanonicalizeKeyedCollectionKey (value)。 - 令 size 为 setData 中元素的数量。
- 令 index 为 0。
- 重复，只要 index < size，
- 令 element 为 setData[index]。
- 如果 element 不是
empty 且 element 是 value，则- 返回 index。
- 将 index 设置为 index + 1。
- 返回
not-found 。
24.2.1.5 SetDataSize ( setData )
The abstract operation SetDataSize takes argument setData (a
- 令 count 为 0。
- 对 setData 的每个元素 element，执行：
- 如果 element 不是
empty ，则将 count 设置为 count + 1。
- 如果 element 不是
- 返回 count。
24.2.2 Set 构造器
Set 构造器：
- 是 %Set%。
- 是
全局对象 的"Set" 属性的初始值。 - 在作为构造器调用时创建并初始化一个新的
Set 对象 。 - 不意图作为函数调用，并且以这种方式调用时会抛出异常。
- 可以用作类定义的
extends子句中的值。打算继承指定 Set 行为的子类构造函数 ，必须包含 一次对 Set构造函数 的super调用，以创建并初始化子类实例，使其具备支持Set.prototype的内置方法所必需的内部状态。
24.2.2.1 Set ( [ iterable ] )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 是
undefined ，则抛出TypeError 异常。 - 令 set 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%Set.prototype%" , « [[SetData]] »)。 - 将 set.[[SetData]] 设置为新的空
List 。 - 如果 iterable 是
undefined 或null ，则返回 set。 - 令 adder 为 ?
Get (set,"add" )。 - 如果
IsCallable (adder) 是false ，则抛出TypeError 异常。 - 令 iteratorRecord 为 ?
GetIterator (iterable,sync )。 - 重复，
- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 是
done ，则返回 set。 - 令 status 为
Completion (Call (adder, set, « next »))。 IfAbruptCloseIterator (status, iteratorRecord)。
- 令 next 为 ?
24.2.3 Set 构造器的属性
Set 构造器：
- 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
24.2.3.1 Set.prototype
Set.prototype 的初始值是
此属性具有特性 { [[Writable]]:
24.2.3.2 get Set [ %Symbol.species% ]
Set[%Symbol.species%] 是
- 返回
this 值。
此函数的
创建派生集合对象的方法应调用
24.2.4 Set 原型对象的属性
Set 原型对象：
- 是 %Set.prototype%。
- 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是
普通对象 。 - 没有 [[SetData]] 内部槽。
24.2.4.1 Set.prototype.add ( value )
此方法在被调用时执行以下步骤：
- 令 set 为
this 值。 - 执行 ?
RequireInternalSlot (set, [[SetData]])。 - 将 value 设置为
CanonicalizeKeyedCollectionKey (value)。 - 对 set.[[SetData]] 的每个元素 entry，执行：
- 如果 entry 不是
empty 且SameValue (entry, value) 是true ，则- 返回 set。
- 如果 entry 不是
- 将 value 追加到 set.[[SetData]]。
- 返回 set。
24.2.4.2 Set.prototype.clear ( )
此方法在被调用时执行以下步骤：
- 令 set 为
this 值。 - 执行 ?
RequireInternalSlot (set, [[SetData]])。 - 对 set.[[SetData]] 的每个元素 entry，执行：
- 将 set.[[SetData]] 中值为 entry 的元素替换为值为
empty 的元素。
- 将 set.[[SetData]] 中值为 entry 的元素替换为值为
- 返回
undefined 。
现有的 [[SetData]]
24.2.4.3 Set.prototype.constructor
Set.prototype.constructor 的初始值是
24.2.4.4 Set.prototype.delete ( value )
此方法在被调用时执行以下步骤：
- 令 set 为
this 值。 - 执行 ?
RequireInternalSlot (set, [[SetData]])。 - 将 value 设置为
CanonicalizeKeyedCollectionKey (value)。 - 对 set.[[SetData]] 的每个元素 entry，执行：
- 如果 entry 不是
empty 且SameValue (entry, value) 是true ，则- 将 set.[[SetData]] 中值为 entry 的元素替换为值为
empty 的元素。 - 返回
true 。
- 将 set.[[SetData]] 中值为 entry 的元素替换为值为
- 如果 entry 不是
- 返回
false 。
值
24.2.4.5 Set.prototype.difference ( other )
此方法在被调用时执行以下步骤：
- 令 set 为
this 值。 - 执行 ?
RequireInternalSlot (set, [[SetData]])。 - 令 otherRecord 为 ?
GetSetRecord (other)。 - 令 resultSetData 为 set.[[SetData]] 的一个副本。
- 如果
SetDataSize (set.[[SetData]]) ≤ otherRecord.[[Size]]，则 - 否则，
- 令 keysIterator 为 ?
GetIteratorFromMethod (otherRecord.[[SetObject]], otherRecord.[[Keys]])。 - 令 next 为
not-started 。 - 重复，只要 next 不是
done ，- 将 next 设置为 ?
IteratorStepValue (keysIterator)。 - 如果 next 不是
done ，则- 将 next 设置为
CanonicalizeKeyedCollectionKey (next)。 - 令 valueIndex 为
SetDataIndex (resultSetData, next)。 - 如果 valueIndex 不是
not-found ，则- 将 resultSetData[valueIndex] 设置为
empty 。
- 将 resultSetData[valueIndex] 设置为
- 将 next 设置为
- 将 next 设置为 ?
- 令 keysIterator 为 ?
- 令 result 为
OrdinaryObjectCreate (%Set.prototype% , « [[SetData]] »)。 - 将 result.[[SetData]] 设置为 resultSetData。
- 返回 result。
24.2.4.6 Set.prototype.entries ( )
此方法在被调用时执行以下步骤：
- 令 set 为
this 值。 - 返回 ?
CreateSetIterator (set,key+value )。
出于迭代目的，Set 看起来类似于每个条目的键和值相同的 Map。
24.2.4.7 Set.prototype.forEach ( callback [ , thisArg ] )
此方法在被调用时执行以下步骤：
- 令 set 为
this 值。 - 执行 ?
RequireInternalSlot (set, [[SetData]])。 - 如果
IsCallable (callback) 是false ，则抛出TypeError 异常。 - 令 entries 为 set.[[SetData]]。
- 令 entriesCount 为 entries 中元素的数量。
- 令 index 为 0。
- 重复，只要 index < entriesCount，
- 令 entry 为 entries[index]。
- 将 index 设置为 index + 1。
- 如果 entry 不是
empty ，则- 执行 ?
Call (callback, thisArg, « entry, entry, set »)。 - 注：entries 中元素的数量可能已在 callback 执行期间增加。
- 将 entriesCount 设置为 entries 中元素的数量。
- 执行 ?
- 返回
undefined 。
callback 应当是一个接受三个实参的函数。forEach 会按值插入顺序，为
如果提供了 thisArg 参数，则它会被用作每次调用 callback 时的
callback 会以三个实参调用：前两个实参是 Set 中
callback 会以三个实参调用，是为了与 Map 和 Array 的 forEach 方法所使用的回调函数保持一致。对于 Set，每个项值都被视为键和值。
forEach 不会直接改变调用它的对象，但该对象可能会被对 callback 的调用改变。
每个值通常只会被访问一次。但是，如果某个值在被访问后被删除，然后又在 forEach 调用完成前重新添加，则该值会再次被访问。在对 forEach 的调用开始之后且被访问之前删除的值不会被访问，除非该值在 forEach 调用完成前再次被添加。在对 forEach 的调用开始之后添加的新值会被访问。
24.2.4.8 Set.prototype.has ( value )
此方法在被调用时执行以下步骤：
- 令 set 为
this 值。 - 执行 ?
RequireInternalSlot (set, [[SetData]])。 - 将 value 设置为
CanonicalizeKeyedCollectionKey (value)。 - 对 set.[[SetData]] 的每个元素 entry，执行：
- 如果 entry 不是
empty 且SameValue (entry, value) 是true ，则返回true 。
- 如果 entry 不是
- 返回
false 。
24.2.4.9 Set.prototype.intersection ( other )
此方法在被调用时执行以下步骤：
- 令 set 为
this 值。 - 执行 ?
RequireInternalSlot (set, [[SetData]])。 - 令 otherRecord 为 ?
GetSetRecord (other)。 - 令 resultSetData 为新的空
List 。 - 如果
SetDataSize (set.[[SetData]]) ≤ otherRecord.[[Size]]，则- 令 thisSize 为 set.[[SetData]] 中元素的数量。
- 令 index 为 0。
- 重复，只要 index < thisSize，
- 令 entry 为 set.[[SetData]][index]。
- 将 index 设置为 index + 1。
- 如果 entry 不是
empty ，则- 令 inOther 为
ToBoolean (?Call (otherRecord.[[Has]], otherRecord.[[SetObject]], « entry »))。 - 如果 inOther 是
true ，则- 注：先前对 otherRecord.[[Has]] 的调用可能会移除并重新添加 set.[[SetData]] 的一个元素，这可能导致同一个元素在此次迭代期间被访问两次。
- 如果
SetDataHas (resultSetData, entry) 是false ，则- 将 entry 追加到 resultSetData。
- 注：set.[[SetData]] 中元素的数量可能已在 otherRecord.[[Has]] 执行期间增加。
- 将 thisSize 设置为 set.[[SetData]] 中元素的数量。
- 令 inOther 为
- 否则，
- 令 keysIterator 为 ?
GetIteratorFromMethod (otherRecord.[[SetObject]], otherRecord.[[Keys]])。 - 令 next 为
not-started 。 - 重复，只要 next 不是
done ，- 将 next 设置为 ?
IteratorStepValue (keysIterator)。 - 如果 next 不是
done ，则- 将 next 设置为
CanonicalizeKeyedCollectionKey (next)。 - 令 inThis 为
SetDataHas (set.[[SetData]], next)。 - 如果 inThis 是
true ，则- 注：因为 other 是任意对象，它的
"keys" 迭代器可能会多次产生相同的值。 - 如果
SetDataHas (resultSetData, next) 是false ，则- 将 next 追加到 resultSetData。
- 注：因为 other 是任意对象，它的
- 将 next 设置为
- 将 next 设置为 ?
- 令 keysIterator 为 ?
- 令 result 为
OrdinaryObjectCreate (%Set.prototype% , « [[SetData]] »)。 - 将 result.[[SetData]] 设置为 resultSetData。
- 返回 result。
24.2.4.10 Set.prototype.isDisjointFrom ( other )
此方法在被调用时执行以下步骤：
- 令 set 为
this 值。 - 执行 ?
RequireInternalSlot (set, [[SetData]])。 - 令 otherRecord 为 ?
GetSetRecord (other)。 - 如果
SetDataSize (set.[[SetData]]) ≤ otherRecord.[[Size]]，则- 令 thisSize 为 set.[[SetData]] 中元素的数量。
- 令 index 为 0。
- 重复，只要 index < thisSize，
- 否则，
- 令 keysIterator 为 ?
GetIteratorFromMethod (otherRecord.[[SetObject]], otherRecord.[[Keys]])。 - 令 next 为
not-started 。 - 重复，只要 next 不是
done ，- 将 next 设置为 ?
IteratorStepValue (keysIterator)。 - 如果 next 不是
done ，则- 如果
SetDataHas (set.[[SetData]], next) 是true ，则- 执行 ?
IteratorClose (keysIterator,NormalCompletion (unused ))。 - 返回
false 。
- 执行 ?
- 如果
- 将 next 设置为 ?
- 令 keysIterator 为 ?
- 返回
true 。
24.2.4.11 Set.prototype.isSubsetOf ( other )
此方法在被调用时执行以下步骤：
- 令 set 为
this 值。 - 执行 ?
RequireInternalSlot (set, [[SetData]])。 - 令 otherRecord 为 ?
GetSetRecord (other)。 - 如果
SetDataSize (set.[[SetData]]) > otherRecord.[[Size]]，则返回false 。 - 令 thisSize 为 set.[[SetData]] 中元素的数量。
- 令 index 为 0。
- 重复，只要 index < thisSize，
- 返回
true 。
24.2.4.12 Set.prototype.isSupersetOf ( other )
此方法在被调用时执行以下步骤：
- 令 set 为
this 值。 - 执行 ?
RequireInternalSlot (set, [[SetData]])。 - 令 otherRecord 为 ?
GetSetRecord (other)。 - 如果
SetDataSize (set.[[SetData]]) < otherRecord.[[Size]]，则返回false 。 - 令 keysIterator 为 ?
GetIteratorFromMethod (otherRecord.[[SetObject]], otherRecord.[[Keys]])。 - 令 next 为
not-started 。 - 重复，只要 next 不是
done ，- 将 next 设置为 ?
IteratorStepValue (keysIterator)。 - 如果 next 不是
done ，则- 如果
SetDataHas (set.[[SetData]], next) 是false ，则- 执行 ?
IteratorClose (keysIterator,NormalCompletion (unused ))。 - 返回
false 。
- 执行 ?
- 如果
- 将 next 设置为 ?
- 返回
true 。
24.2.4.13 Set.prototype.keys ( )
出于迭代目的，Set 看起来类似于每个条目的键和值相同的 Map。
24.2.4.14 get Set.prototype.size
Set.prototype.size 是
- 令 set 为
this 值。 - 执行 ?
RequireInternalSlot (set, [[SetData]])。 - 令 size 为
SetDataSize (set.[[SetData]])。 - 返回
𝔽 (size)。
24.2.4.15 Set.prototype.symmetricDifference ( other )
此方法在被调用时执行以下步骤：
- 令 set 为
this 值。 - 执行 ?
RequireInternalSlot (set, [[SetData]])。 - 令 otherRecord 为 ?
GetSetRecord (other)。 - 令 keysIterator 为 ?
GetIteratorFromMethod (otherRecord.[[SetObject]], otherRecord.[[Keys]])。 - 令 resultSetData 为 set.[[SetData]] 的一个副本。
- 令 next 为
not-started 。 - 重复，只要 next 不是
done ，- 将 next 设置为 ?
IteratorStepValue (keysIterator)。 - 如果 next 不是
done ，则- 将 next 设置为
CanonicalizeKeyedCollectionKey (next)。 - 令 resultIndex 为
SetDataIndex (resultSetData, next)。 - 如果 resultIndex 是
not-found ，则令 alreadyInResult 为false ；否则令 alreadyInResult 为true 。 - 如果
SetDataHas (set.[[SetData]], next) 是true ，则- 如果 alreadyInResult 是
true ，则将 resultSetData[resultIndex] 设置为empty 。
- 如果 alreadyInResult 是
- 否则，
- 如果 alreadyInResult 是
false ，则将 next 追加到 resultSetData。
- 如果 alreadyInResult 是
- 将 next 设置为
- 将 next 设置为 ?
- 令 result 为
OrdinaryObjectCreate (%Set.prototype% , « [[SetData]] »)。 - 将 result.[[SetData]] 设置为 resultSetData。
- 返回 result。
24.2.4.16 Set.prototype.union ( other )
此方法在被调用时执行以下步骤：
- 令 set 为
this 值。 - 执行 ?
RequireInternalSlot (set, [[SetData]])。 - 令 otherRecord 为 ?
GetSetRecord (other)。 - 令 keysIterator 为 ?
GetIteratorFromMethod (otherRecord.[[SetObject]], otherRecord.[[Keys]])。 - 令 resultSetData 为 set.[[SetData]] 的一个副本。
- 令 next 为
not-started 。 - 重复，只要 next 不是
done ，- 将 next 设置为 ?
IteratorStepValue (keysIterator)。 - 如果 next 不是
done ，则- 将 next 设置为
CanonicalizeKeyedCollectionKey (next)。 - 如果
SetDataHas (resultSetData, next) 是false ，则- 将 next 追加到 resultSetData。
- 将 next 设置为
- 将 next 设置为 ?
- 令 result 为
OrdinaryObjectCreate (%Set.prototype% , « [[SetData]] »)。 - 将 result.[[SetData]] 设置为 resultSetData。
- 返回 result。
24.2.4.17 Set.prototype.values ( )
此方法在被调用时执行以下步骤：
- 令 set 为
this 值。 - 返回 ?
CreateSetIterator (set,value )。
24.2.4.18 Set.prototype [ %Symbol.iterator% ] ( )
24.2.4.19 Set.prototype [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
24.2.5 Set 实例的属性
24.2.6 Set Iterator 对象
Set Iterator 是具有下文所定义结构的
24.2.6.1 CreateSetIterator ( set, kind )
The abstract operation CreateSetIterator takes arguments set (an ECMAScript language value) and kind (
- 执行 ?
RequireInternalSlot (set, [[SetData]])。 - 令 closure 为一个新的无参数
Abstract Closure ，它捕获 set 和 kind，并在被调用时执行以下步骤：- 令 index 为 0。
- 令 entries 为 set.[[SetData]]。
- 令 entriesCount 为 entries 中元素的数量。
- 重复，只要 index < entriesCount，
- 令 entry 为 entries[index]。
- 将 index 设置为 index + 1。
- 如果 entry 不是
empty ，则- 如果 kind 是
key+value ，则- 令 result 为
CreateArrayFromList (« entry, entry »)。 - 执行 ?
GeneratorYield (CreateIteratorResultObject (result,false ))。
- 令 result 为
- 否则，
- 断言：kind 是
value 。 - 执行 ?
GeneratorYield (CreateIteratorResultObject (entry,false ))。
- 断言：kind 是
- 注：当此
抽象操作 的执行因GeneratorYield 而暂停时，entries 中元素的数量可能已经增加。 - 将 entriesCount 设置为 entries 中元素的数量。
- 如果 kind 是
- 返回
NormalCompletion (unused )。
- 返回
CreateIteratorFromClosure (closure,"%SetIteratorPrototype%" ,%SetIteratorPrototype% )。
24.2.6.2 %SetIteratorPrototype% 对象
%SetIteratorPrototype% 对象：
- 具有由所有
Set Iterator 对象继承的属性。 - 是
普通对象 。 - 具有一个 [[Prototype]] 内部槽，其值为
%Iterator.prototype% 。 - 具有以下属性：
24.2.6.2.1 %SetIteratorPrototype%.next ( )
- 返回 ?
GeneratorResume (this value,empty ,"%SetIteratorPrototype%" )。
24.2.6.2.2 %SetIteratorPrototype% [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
24.3 WeakMap 对象
WeakMap 是键/值对的集合，其中键是对象和/或 symbol，值可以是任意
实现可以在 WeakMap 的某个键/值对变得不可访问的时间与该键/值对从 WeakMap 中移除的时间之间施加任意确定的延迟。如果这种延迟对 ECMAScript 程序可观察，它将成为可能影响程序执行的不确定性来源。因此，ECMAScript 实现不得提供任何手段来观察 WeakMap 的某个键，除非观察者需要提供被观察的键。
WeakMap 必须使用哈希表或其他机制来实现，这些机制平均而言提供的访问时间相对于集合中键/值对数量是次线性的。本规范中使用的数据结构仅用于描述 WeakMap 所要求的可观察语义。它并不旨在作为可行的实现模型。
WeakMap 和 WeakSet 旨在提供一种机制，用于以不会“泄漏”内存资源的方式，将状态动态关联到对象或 symbol；也就是说，如果没有 WeakMap 或 WeakSet 实例，该对象或 symbol 原本会变得不可访问，并受到实现的垃圾回收机制进行资源回收。可以通过使用 WeakMap 或 WeakSet 实例到键的反向每对象/symbol 映射来实现这一特性。或者，每个 WeakMap 或 WeakSet 实例可以在内部存储其键和值数据，但这种方法需要 WeakMap 或 WeakSet 实现与垃圾回收器之间的协调。以下参考资料描述了可能对 WeakMap 和 WeakSet 的实现有用的机制：
Barry Hayes. 1997. Ephemerons: a new finalization mechanism. In Proceedings of the 12th ACM SIGPLAN conference on Object-oriented programming, systems, languages, and applications (OOPSLA '97), A. Michael Berman (Ed.). ACM, New York, NY, USA, 176-183, http://doi.acm.org/10.1145/263698.263733.
Alexandra Barros, Roberto Ierusalimschy, Eliminating Cycles in Weak Tables. Journal of Universal Computer Science - J.UCS, vol. 14, no. 21, pp. 3481-3497, 2008, http://www.jucs.org/jucs_14_21/eliminating_cycles_in_weak
24.3.1 WeakMap 构造器
WeakMap 构造器：
- 是 %WeakMap%。
- 是
全局对象 的"WeakMap" 属性的初始值。 - 在作为构造器调用时创建并初始化一个新的 WeakMap。
- 不意图作为函数调用，并且以这种方式调用时会抛出异常。
- 可以用作类定义的
extends子句中的值。打算继承指定 WeakMap 行为的子类构造函数 ，必须包含 一次对 WeakMap构造函数 的super调用，以创建并初始化子类实例，使其具备支持WeakMap.prototype的内置方法所必需的内部状态。
24.3.1.1 WeakMap ( [ iterable ] )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 是
undefined ，则抛出TypeError 异常。 - 令 map 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%WeakMap.prototype%" , « [[WeakMapData]] »)。 - 将 map.[[WeakMapData]] 设置为新的空
List 。 - 如果 iterable 是
undefined 或null ，则返回 map。 - 令 adder 为 ?
Get (map,"set" )。 - 如果
IsCallable (adder) 是false ，则抛出TypeError 异常。 - 返回 ?
AddEntriesFromIterable (map, iterable, adder)。
如果存在参数 iterable，则它预期为实现了
24.3.2 WeakMap 构造器的属性
WeakMap 构造器：
- 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
24.3.2.1 WeakMap.prototype
WeakMap.prototype 的初始值是
此属性具有特性 { [[Writable]]:
24.3.3 WeakMap 原型对象的属性
WeakMap 原型对象：
- 是 %WeakMap.prototype%。
- 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是
普通对象 。 - 没有 [[WeakMapData]] 内部槽。
24.3.3.1 WeakMap.prototype.constructor
WeakMap.prototype.constructor 的初始值是
24.3.3.2 WeakMap.prototype.delete ( key )
此方法在被调用时执行以下步骤：
- 令 weakMap 为
this 值。 - 执行 ?
RequireInternalSlot (weakMap, [[WeakMapData]])。 - 如果
CanBeHeldWeakly (key) 是false ，则返回false 。 - 对 weakMap.[[WeakMapData]] 的每个
Record { [[Key]], [[Value]] } entry，执行：- 如果 entry.[[Key]] 不是
empty 且SameValue (entry.[[Key]], key) 是true ，则- 将 entry.[[Key]] 设置为
empty 。 - 将 entry.[[Value]] 设置为
empty 。 - 返回
true 。
- 将 entry.[[Key]] 设置为
- 如果 entry.[[Key]] 不是
- 返回
false 。
值
24.3.3.3 WeakMap.prototype.get ( key )
此方法在被调用时执行以下步骤：
- 令 weakMap 为
this 值。 - 执行 ?
RequireInternalSlot (weakMap, [[WeakMapData]])。 - 如果
CanBeHeldWeakly (key) 是false ，则返回undefined 。 - 对 weakMap.[[WeakMapData]] 的每个
Record { [[Key]], [[Value]] } entry，执行：- 如果 entry.[[Key]] 不是
empty 且SameValue (entry.[[Key]], key) 是true ，则返回 entry.[[Value]]。
- 如果 entry.[[Key]] 不是
- 返回
undefined 。
24.3.3.4 WeakMap.prototype.getOrInsert ( key, value )
此方法在被调用时执行以下步骤：
- 令 weakMap 为
this 值。 - 执行 ?
RequireInternalSlot (weakMap, [[WeakMapData]])。 - 如果
CanBeHeldWeakly (key) 是false ，则抛出TypeError 异常。 - 对 weakMap.[[WeakMapData]] 的每个
Record { [[Key]], [[Value]] } entry，执行：- 如果 entry.[[Key]] 不是
empty 且SameValue (entry.[[Key]], key) 是true ，则返回 entry.[[Value]]。
- 如果 entry.[[Key]] 不是
- 令 entry 为
Record { [[Key]]: key, [[Value]]: value }。 - 将 entry 追加到 weakMap.[[WeakMapData]]。
- 返回 value。
24.3.3.5 WeakMap.prototype.getOrInsertComputed ( key, callback )
此方法在被调用时执行以下步骤：
- 令 weakMap 为
this 值。 - 执行 ?
RequireInternalSlot (weakMap, [[WeakMapData]])。 - 如果
CanBeHeldWeakly (key) 是false ，则抛出TypeError 异常。 - 如果
IsCallable (callback) 是false ，则抛出TypeError 异常。 - 对 weakMap.[[WeakMapData]] 的每个
Record { [[Key]], [[Value]] } entry，执行：- 如果 entry.[[Key]] 不是
empty 且SameValue (entry.[[Key]], key) 是true ，则返回 entry.[[Value]]。
- 如果 entry.[[Key]] 不是
- 令 value 为 ?
Call (callback,undefined , « key »)。 - 注：WeakMap 可能已在 callback 执行期间被修改。
- 对 weakMap.[[WeakMapData]] 的每个
Record { [[Key]], [[Value]] } entry，执行：- 如果 entry.[[Key]] 不是
empty 且SameValue (entry.[[Key]], key) 是true ，则- 将 entry.[[Value]] 设置为 value。
- 返回 value。
- 如果 entry.[[Key]] 不是
- 令 entry 为
Record { [[Key]]: key, [[Value]]: value }。 - 将 entry 追加到 weakMap.[[WeakMapData]]。
- 返回 value。
24.3.3.6 WeakMap.prototype.has ( key )
此方法在被调用时执行以下步骤：
- 令 weakMap 为
this 值。 - 执行 ?
RequireInternalSlot (weakMap, [[WeakMapData]])。 - 如果
CanBeHeldWeakly (key) 是false ，则返回false 。 - 对 weakMap.[[WeakMapData]] 的每个
Record { [[Key]], [[Value]] } entry，执行：- 如果 entry.[[Key]] 不是
empty 且SameValue (entry.[[Key]], key) 是true ，则返回true 。
- 如果 entry.[[Key]] 不是
- 返回
false 。
24.3.3.7 WeakMap.prototype.set ( key, value )
此方法在被调用时执行以下步骤：
- 令 weakMap 为
this 值。 - 执行 ?
RequireInternalSlot (weakMap, [[WeakMapData]])。 - 如果
CanBeHeldWeakly (key) 是false ，则抛出TypeError 异常。 - 对 weakMap.[[WeakMapData]] 的每个
Record { [[Key]], [[Value]] } entry，执行：- 如果 entry.[[Key]] 不是
empty 且SameValue (entry.[[Key]], key) 是true ，则- 将 entry.[[Value]] 设置为 value。
- 返回 weakMap。
- 如果 entry.[[Key]] 不是
- 令 entry 为
Record { [[Key]]: key, [[Value]]: value }。 - 将 entry 追加到 weakMap.[[WeakMapData]]。
- 返回 weakMap。
24.3.3.8 WeakMap.prototype [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
24.3.4 WeakMap 实例的属性
WeakMap 实例是
24.4 WeakSet 对象
WeakSet 是对象和/或 symbol 的集合。一个不同的对象或 symbol 在 WeakSet 的集合中只能作为元素出现一次。可以查询 WeakSet，以查看它是否
实现可以在 WeakSet 中
WeakSet 必须使用哈希表或其他机制来实现，这些机制平均而言提供的访问时间相对于集合中元素数量是次线性的。本规范中使用的数据结构仅用于描述 WeakSet 所要求的可观察语义。它并不旨在作为可行的实现模型。
见
24.4.1 WeakSet 构造器
WeakSet 构造器：
- 是 %WeakSet%。
- 是
全局对象 的"WeakSet" 属性的初始值。 - 在作为构造器调用时创建并初始化一个新的 WeakSet。
- 不意图作为函数调用，并且以这种方式调用时会抛出异常。
- 可以用作类定义的
extends子句中的值。打算继承指定 WeakSet 行为的子类构造函数 ，必须包含 一次对 WeakSet构造函数 的super调用，以创建并初始化子类实例，使其具备支持WeakSet.prototype的内置方法所必需的内部状态。
24.4.1.1 WeakSet ( [ iterable ] )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 是
undefined ，则抛出TypeError 异常。 - 令 set 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%WeakSet.prototype%" , « [[WeakSetData]] »)。 - 将 set.[[WeakSetData]] 设置为新的空
List 。 - 如果 iterable 是
undefined 或null ，则返回 set。 - 令 adder 为 ?
Get (set,"add" )。 - 如果
IsCallable (adder) 是false ，则抛出TypeError 异常。 - 令 iteratorRecord 为 ?
GetIterator (iterable,sync )。 - 重复，
- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 是
done ，则返回 set。 - 令 status 为
Completion (Call (adder, set, « next »))。 IfAbruptCloseIterator (status, iteratorRecord)。
- 令 next 为 ?
24.4.2 WeakSet 构造器的属性
WeakSet 构造器：
- 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
24.4.2.1 WeakSet.prototype
WeakSet.prototype 的初始值是
此属性具有特性 { [[Writable]]:
24.4.3 WeakSet 原型对象的属性
WeakSet 原型对象：
- 是 %WeakSet.prototype%。
- 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是
普通对象 。 - 没有 [[WeakSetData]] 内部槽。
24.4.3.1 WeakSet.prototype.add ( value )
此方法在被调用时执行以下步骤：
- 令 weakSet 为
this 值。 - 执行 ?
RequireInternalSlot (weakSet, [[WeakSetData]])。 - 如果
CanBeHeldWeakly (value) 是false ，则抛出TypeError 异常。 - 对 weakSet.[[WeakSetData]] 的每个元素 entry，执行：
- 如果 entry 不是
empty 且SameValue (entry, value) 是true ，则- 返回 weakSet。
- 如果 entry 不是
- 将 value 追加到 weakSet.[[WeakSetData]]。
- 返回 weakSet。
24.4.3.2 WeakSet.prototype.constructor
WeakSet.prototype.constructor 的初始值是
24.4.3.3 WeakSet.prototype.delete ( value )
此方法在被调用时执行以下步骤：
- 令 weakSet 为
this 值。 - 执行 ?
RequireInternalSlot (weakSet, [[WeakSetData]])。 - 如果
CanBeHeldWeakly (value) 是false ，则返回false 。 - 对 weakSet.[[WeakSetData]] 的每个元素 entry，执行：
- 如果 entry 不是
empty 且SameValue (entry, value) 是true ，则- 将 weakSet.[[WeakSetData]] 中值为 entry 的元素替换为值为
empty 的元素。 - 返回
true 。
- 将 weakSet.[[WeakSetData]] 中值为 entry 的元素替换为值为
- 如果 entry 不是
- 返回
false 。
值
24.4.3.4 WeakSet.prototype.has ( value )
此方法在被调用时执行以下步骤：
- 令 weakSet 为
this 值。 - 执行 ?
RequireInternalSlot (weakSet, [[WeakSetData]])。 - 如果
CanBeHeldWeakly (value) 是false ，则返回false 。 - 对 weakSet.[[WeakSetData]] 的每个元素 entry，执行：
- 如果 entry 不是
empty 且SameValue (entry, value) 是true ，则返回true 。
- 如果 entry 不是
- 返回
false 。
24.4.3.5 WeakSet.prototype [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
24.4.4 WeakSet 实例的属性
WeakSet 实例是
24.5 键控集合的抽象操作
24.5.1 CanonicalizeKeyedCollectionKey ( key )
The abstract operation CanonicalizeKeyedCollectionKey takes argument key (an ECMAScript language value) and returns an ECMAScript language value. It performs the following steps when called:
- 如果 key 是
-0 𝔽，则返回+0 𝔽。 - 返回 key。
25 结构化数据
25.1 ArrayBuffer 对象
25.1.1 表示法
本节、
读-改-写修改函数是一个数学函数，表示为一个
- 它们以原子方式执行其所有算法步骤。
- 它们的各个算法步骤不可观察。
为帮助验证读-改-写修改函数的算法步骤构成纯粹的数学函数，推荐采用以下编辑约定：
- 它们不直接访问任何语言值或规范值，也不通过被调用的
抽象操作 和Abstract Closure 间接访问任何语言值或规范值，但其参数和捕获的值除外。 - 它们不直接或间接调用返回
Completion Record 的抽象操作 和Abstract Closure 。 - 它们不返回
Completion Record 。
25.1.2 定长和可调整大小的 ArrayBuffer 对象
定长 ArrayBuffer 是创建后字节长度不能改变的 ArrayBuffer。
可调整大小的 ArrayBuffer 是创建后字节长度可以通过调用
创建哪种 ArrayBuffer 对象取决于传给
25.1.3 ArrayBuffer 对象的抽象操作
25.1.3.1 AllocateArrayBuffer ( ctor, byteLength [ , maxByteLength ] )
The abstract operation AllocateArrayBuffer takes arguments ctor (a constructor) and byteLength (a non-negative
- 令 slots 为 « [[ArrayBufferData]], [[ArrayBufferByteLength]], [[ArrayBufferDetachKey]] »。
- 如果存在 maxByteLength 且 maxByteLength 不是
empty ，则令 allocatingResizableBuffer 为true ；否则令 allocatingResizableBuffer 为false 。 - 如果 allocatingResizableBuffer 是
true ，则- 如果 byteLength > maxByteLength，则抛出
RangeError 异常。 - 将 [[ArrayBufferMaxByteLength]] 追加到 slots。
- 如果 byteLength > maxByteLength，则抛出
- 令 obj 为 ?
OrdinaryCreateFromConstructor (ctor,"%ArrayBuffer.prototype%" , slots)。 - 令 block 为 ?
CreateByteDataBlock (byteLength)。 - 将 obj.[[ArrayBufferData]] 设置为 block。
- 将 obj.[[ArrayBufferByteLength]] 设置为 byteLength。
- 如果 allocatingResizableBuffer 是
true ，则- 如果无法创建由 maxByteLength 个字节组成的
Data Block block，则抛出RangeError 异常。 - 注：
可调整大小的 ArrayBuffer 被设计为可用原地增长实现。例如，如果虚拟内存无法预先保留，实现可以抛出异常。 - 将 obj.[[ArrayBufferMaxByteLength]] 设置为 maxByteLength。
- 如果无法创建由 maxByteLength 个字节组成的
- 返回 obj。
25.1.3.2 ArrayBufferByteLength ( arrayBuffer, order )
The abstract operation ArrayBufferByteLength takes arguments arrayBuffer (an ArrayBuffer or SharedArrayBuffer) and order (
- 如果
IsGrowableSharedArrayBuffer (arrayBuffer) 是true ，则- 令 bufferByteLengthBlock 为 arrayBuffer.[[ArrayBufferByteLengthData]]。
- 令 rawLength 为
GetRawBytesFromSharedBlock (bufferByteLengthBlock, 0,biguint64 ,true , order)。 - 令 agentRecord 为 surrounding
agent 的Agent Record 。 - 令 isLittleEndian 为 agentRecord.[[LittleEndian]]。
- 返回
ℝ (RawBytesToNumeric (biguint64 , rawLength, isLittleEndian))。
- 断言：
IsDetachedBuffer (arrayBuffer) 是false 。 - 返回 arrayBuffer.[[ArrayBufferByteLength]]。
25.1.3.3 ArrayBufferCopyAndDetach ( arrayBuffer, newLength, preserveResizability )
The abstract operation ArrayBufferCopyAndDetach takes arguments arrayBuffer (an ECMAScript language value), newLength (an ECMAScript language value), and preserveResizability (
- 执行 ?
RequireInternalSlot (arrayBuffer, [[ArrayBufferData]])。 - 如果
IsSharedArrayBuffer (arrayBuffer) 是true ，则抛出TypeError 异常。 - 如果 newLength 是
undefined ，则- 令 newByteLength 为 arrayBuffer.[[ArrayBufferByteLength]]。
- 否则，
- 令 newByteLength 为 ?
ToIndex (newLength)。
- 令 newByteLength 为 ?
- 如果
IsDetachedBuffer (arrayBuffer) 是true ，则抛出TypeError 异常。 - 如果 preserveResizability 是
preserve-resizability 且IsFixedLengthArrayBuffer (arrayBuffer) 是false ，则- 令 newMaxByteLength 为 arrayBuffer.[[ArrayBufferMaxByteLength]]。
- 否则，
- 令 newMaxByteLength 为
empty 。
- 令 newMaxByteLength 为
- 如果 arrayBuffer.[[ArrayBufferDetachKey]] 不是
undefined ，则抛出TypeError 异常。 - 令 newBuffer 为 ?
AllocateArrayBuffer (%ArrayBuffer% , newByteLength, newMaxByteLength)。 - 令 copyLength 为
min (newByteLength, arrayBuffer.[[ArrayBufferByteLength]])。 - 令 fromBlock 为 arrayBuffer.[[ArrayBufferData]]。
- 令 toBlock 为 newBuffer.[[ArrayBufferData]]。
- 执行
CopyDataBlockBytes (toBlock, 0, fromBlock, 0, copyLength)。 - 注：新
Data Block 的创建以及从旧Data Block 的复制都不可观察。实现可以将此方法实现为零复制移动或realloc。 - 执行 !
DetachArrayBuffer (arrayBuffer)。 - 返回 newBuffer。
25.1.3.4 IsDetachedBuffer ( arrayBuffer )
The abstract operation IsDetachedBuffer takes argument arrayBuffer (an ArrayBuffer or a SharedArrayBuffer) and returns a Boolean. It performs the following steps when called:
- 如果 arrayBuffer.[[ArrayBufferData]] 是
null ，则返回true 。 - 返回
false 。
25.1.3.5 DetachArrayBuffer ( arrayBuffer [ , key ] )
The abstract operation DetachArrayBuffer takes argument arrayBuffer (an ArrayBuffer) and optional argument key (anything) and returns either a normal completion containing
- 断言：
IsSharedArrayBuffer (arrayBuffer) 是false 。 - 如果 key 不存在，则将 key 设置为
undefined 。 - 如果 arrayBuffer.[[ArrayBufferDetachKey]] 不是 key，则抛出
TypeError 异常。 - 将 arrayBuffer.[[ArrayBufferData]] 设置为
null 。 - 将 arrayBuffer.[[ArrayBufferByteLength]] 设置为 0。
- 返回
unused 。
分离 ArrayBuffer 实例会解除用作其后备存储的
25.1.3.6 CloneArrayBuffer ( sourceBuffer, sourceByteOffset, sourceLength )
The abstract operation CloneArrayBuffer takes arguments sourceBuffer (an ArrayBuffer or a SharedArrayBuffer), sourceByteOffset (a non-negative
- 断言：
IsDetachedBuffer (sourceBuffer) 是false 。 - 令 targetBuffer 为 ?
AllocateArrayBuffer (%ArrayBuffer% , sourceLength)。 - 令 sourceBlock 为 sourceBuffer.[[ArrayBufferData]]。
- 令 targetBlock 为 targetBuffer.[[ArrayBufferData]]。
- 执行
CopyDataBlockBytes (targetBlock, 0, sourceBlock, sourceByteOffset, sourceLength)。 - 返回 targetBuffer。
25.1.3.7 GetArrayBufferMaxByteLengthOption ( options )
The abstract operation GetArrayBufferMaxByteLengthOption takes argument options (an ECMAScript language value) and returns either a normal completion containing either a non-negative
25.1.3.8 HostResizeArrayBuffer ( buffer, newByteLength )
The host-defined abstract operation HostResizeArrayBuffer takes arguments buffer (an ArrayBuffer) and newByteLength (a non-negative
HostResizeArrayBuffer 的实现必须符合以下要求：
HostResizeArrayBuffer 的默认实现是返回
25.1.3.9 IsFixedLengthArrayBuffer ( arrayBuffer )
The abstract operation IsFixedLengthArrayBuffer takes argument arrayBuffer (an ArrayBuffer or a SharedArrayBuffer) and returns a Boolean. It performs the following steps when called:
- 如果 arrayBuffer 具有 [[ArrayBufferMaxByteLength]] 内部槽，则返回
false 。 - 返回
true 。
25.1.3.10 IsUnsignedElementType ( type )
The abstract operation IsUnsignedElementType takes argument type (a
- 如果 type 是
uint8 、uint8clamped 、uint16 、uint32 或biguint64 之一，则返回true 。 - 返回
false 。
25.1.3.11 IsUnclampedIntegerElementType ( type )
The abstract operation IsUnclampedIntegerElementType takes argument type (a
- 如果 type 是
int8 、uint8 、int16 、uint16 、int32 或uint32 之一，则返回true 。 - 返回
false 。
25.1.3.12 IsBigIntElementType ( type )
The abstract operation IsBigIntElementType takes argument type (a
- 如果 type 是
biguint64 或bigint64 ，则返回true 。 - 返回
false 。
25.1.3.13 IsNoTearConfiguration ( type, order )
The abstract operation IsNoTearConfiguration takes arguments type (a
- 如果
IsUnclampedIntegerElementType (type) 是true ，则返回true 。 - 如果
IsBigIntElementType (type) 是true 且 order 既不是init 也不是unordered ，则返回true 。 - 返回
false 。
25.1.3.14 RawBytesToNumeric ( type, rawBytes, isLittleEndian )
The abstract operation RawBytesToNumeric takes arguments type (a
- 令 elementSize 为
Table 71 中为 Element Type type 指定的 Element Size 值。 - 如果 isLittleEndian 是
false ，则反转 rawBytes 的元素顺序。 - 如果 type 是
float16 ，则- 令 value 为 rawBytes 的字节元素连接后并解释为
IEEE 754-2019 binary16 值的小端位串编码。 - 如果 value 是 NaN，则返回
NaN 。 - 返回与 value 对应的
Number 值 。
- 令 value 为 rawBytes 的字节元素连接后并解释为
- 如果 type 是
float32 ，则- 令 value 为 rawBytes 的字节元素连接后并解释为
IEEE 754-2019 binary32 值的小端位串编码。 - 如果 value 是 NaN，则返回
NaN 。 - 返回与 value 对应的
Number 值 。
- 令 value 为 rawBytes 的字节元素连接后并解释为
- 如果 type 是
float64 ，则- 令 value 为 rawBytes 的字节元素连接后并解释为
IEEE 754-2019 binary64 值的小端位串编码。 - 如果 value 是 NaN，则返回
NaN 。 - 返回与 value 对应的
Number 值 。
- 令 value 为 rawBytes 的字节元素连接后并解释为
- 如果
IsUnsignedElementType (type) 是true ，则- 令 intValue 为 rawBytes 的字节元素连接后并解释为无符号小端二进制数的位串编码。
- 否则，
- 令 intValue 为 rawBytes 的字节元素连接后并解释为位长为 elementSize × 8 的二进制小端二进制补码数的位串编码。
- 如果
IsBigIntElementType (type) 是true ，则返回与 intValue 对应的 BigInt 值。 - 返回与 intValue 对应的
Number 值 。
25.1.3.15 GetRawBytesFromSharedBlock ( block, byteIndex, type, isTypedArray, order )
The abstract operation GetRawBytesFromSharedBlock takes arguments block (a
- 令 elementSize 为
Table 71 中为 Element Type type 指定的 Element Size 值。 - 令 agentRecord 为 surrounding
agent 的Agent Record 。 - 令 execution 为 agentRecord.[[CandidateExecution]]。
- 令 eventsRecord 为 execution.[[EventsRecords]] 中 [[AgentSignifier]] 为
AgentSignifier () 的Agent Events Record 。 - 如果 isTypedArray 是
true 且IsNoTearConfiguration (type, order) 是true ，则令 noTear 为true ；否则令 noTear 为false 。 - 令 rawValue 为长度为 elementSize 的
List ，其元素为非确定性选择的字节值 。 - 注：在实现中，rawValue 是底层硬件上的非原子或原子读取指令的结果。非确定性是
内存模型 的一项语义规定，用于描述弱一致性硬件的可观察行为。 - 令 readEvent 为
ReadSharedMemory { [[Order]]: order, [[NoTear]]: noTear, [[Block]]: block, [[ByteIndex]]: byteIndex, [[ElementSize]]: elementSize }。 - 将 readEvent 追加到 eventsRecord.[[EventList]]。
- 将
Chosen Value Record { [[Event]]: readEvent, [[ChosenValue]]: rawValue } 追加到 execution.[[ChosenValues]]。 - 返回 rawValue。
25.1.3.16 GetValueFromBuffer ( arrayBuffer, byteIndex, type, isTypedArray, order [ , isLittleEndian ] )
The abstract operation GetValueFromBuffer takes arguments arrayBuffer (an ArrayBuffer or SharedArrayBuffer), byteIndex (a non-negative
- 断言：
IsDetachedBuffer (arrayBuffer) 是false 。 - 断言：arrayBuffer 中从 byteIndex 开始有足够的字节来表示 type 的值。
- 令 block 为 arrayBuffer.[[ArrayBufferData]]。
- 令 elementSize 为
Table 71 中为 Element Type type 指定的 Element Size 值。 - 如果
IsSharedArrayBuffer (arrayBuffer) 是true ，则- 断言：block 是
Shared Data Block 。 - 令 rawValue 为
GetRawBytesFromSharedBlock (block, byteIndex, type, isTypedArray, order)。
- 断言：block 是
- 否则，
- 断言：rawValue 中元素的数量是 elementSize。
- 如果 isLittleEndian 不存在，则
- 令 agentRecord 为 surrounding
agent 的Agent Record 。 - 将 isLittleEndian 设置为 agentRecord.[[LittleEndian]]。
- 令 agentRecord 为 surrounding
- 返回
RawBytesToNumeric (type, rawValue, isLittleEndian)。
25.1.3.17 NumericToRawBytes ( type, value, isLittleEndian )
The abstract operation NumericToRawBytes takes arguments type (a
- 如果 type 是
float16 ，则- 令 rawBytes 为一个
List ，其元素是使用 roundTiesToEven 模式将 value 转换为IEEE 754-2019 binary16 格式所得的 2 个字节。这些字节按小端顺序排列。如果 value 是NaN ，则 rawBytes 可以设置为任意实现所选择的IEEE 754-2019 binary16 格式 NaN 编码。实现必须始终为每个实现可区分的NaN 值选择相同的编码。
- 令 rawBytes 为一个
- 否则，如果 type 是
float32 ，则- 令 rawBytes 为一个
List ，其元素是使用 roundTiesToEven 模式将 value 转换为IEEE 754-2019 binary32 格式所得的 4 个字节。这些字节按小端顺序排列。如果 value 是NaN ，则 rawBytes 可以设置为任意实现所选择的IEEE 754-2019 binary32 格式 NaN 编码。实现必须始终为每个实现可区分的NaN 值选择相同的编码。
- 令 rawBytes 为一个
- 否则，如果 type 是
float64 ，则- 令 rawBytes 为一个
List ，其元素是 value 的IEEE 754-2019 binary64 格式编码的 8 个字节。这些字节按小端顺序排列。如果 value 是NaN ，则 rawBytes 可以设置为任意实现所选择的IEEE 754-2019 binary64 格式 NaN 编码。实现必须始终为每个实现可区分的NaN 值选择相同的编码。
- 令 rawBytes 为一个
- 否则，
- 令 n 为
Table 71 中为 Element Type type 指定的 Element Size 值。 - 令 conversionOperation 为
Table 71 中 Element Type type 的 “Conversion Operation” 列所命名的抽象操作 。 - 令 intValue 为
ℝ (! conversionOperation(value))。 - 如果 intValue ≥ 0，则
- 令 rawBytes 为一个
List ，其元素是 intValue 的 n 字节二进制编码。这些字节按小端顺序排列。
- 令 rawBytes 为一个
- 否则，
- 令 rawBytes 为一个
List ，其元素是 intValue 的 n 字节二进制补码编码。这些字节按小端顺序排列。
- 令 rawBytes 为一个
- 令 n 为
- 如果 isLittleEndian 是
false ，则反转 rawBytes 的元素顺序。 - 返回 rawBytes。
25.1.3.18 SetValueInBuffer ( arrayBuffer, byteIndex, type, value, isTypedArray, order [ , isLittleEndian ] )
The abstract operation SetValueInBuffer takes arguments arrayBuffer (an ArrayBuffer or SharedArrayBuffer), byteIndex (a non-negative
- 断言：
IsDetachedBuffer (arrayBuffer) 是false 。 - 断言：arrayBuffer 中从 byteIndex 开始有足够的字节来表示 type 的值。
- 断言：如果
IsBigIntElementType (type) 是true ，则 value 是 BigInt；否则，value 是 Number。 - 令 block 为 arrayBuffer.[[ArrayBufferData]]。
- 令 elementSize 为
Table 71 中为 Element Type type 指定的 Element Size 值。 - 令 agentRecord 为 surrounding
agent 的Agent Record 。 - 如果 isLittleEndian 不存在，则
- 将 isLittleEndian 设置为 agentRecord.[[LittleEndian]]。
- 令 rawBytes 为
NumericToRawBytes (type, value, isLittleEndian)。 - 如果
IsSharedArrayBuffer (arrayBuffer) 是true ，则- 令 execution 为 agentRecord.[[CandidateExecution]]。
- 令 eventsRecord 为 execution.[[EventsRecords]] 中 [[AgentSignifier]] 为
AgentSignifier () 的Agent Events Record 。 - 如果 isTypedArray 是
true 且IsNoTearConfiguration (type, order) 是true ，则令 noTear 为true ；否则令 noTear 为false 。 - 将
WriteSharedMemory { [[Order]]: order, [[NoTear]]: noTear, [[Block]]: block, [[ByteIndex]]: byteIndex, [[ElementSize]]: elementSize, [[Payload]]: rawBytes } 追加到 eventsRecord.[[EventList]]。
- 否则，
- 将 rawBytes 的各个字节存储到 block 中，从 block[byteIndex] 开始。
- 返回
unused 。
25.1.3.19 GetModifySetValueInBuffer ( arrayBuffer, byteIndex, type, value, op )
The abstract operation GetModifySetValueInBuffer takes arguments arrayBuffer (an ArrayBuffer or a SharedArrayBuffer), byteIndex (a non-negative
- 断言：
IsDetachedBuffer (arrayBuffer) 是false 。 - 断言：arrayBuffer 中从 byteIndex 开始有足够的字节来表示 type 的值。
- 断言：如果
IsBigIntElementType (type) 是true ，则 value 是 BigInt；否则，value 是 Number。 - 令 block 为 arrayBuffer.[[ArrayBufferData]]。
- 令 elementSize 为
Table 71 中为 Element Type type 指定的 Element Size 值。 - 令 agentRecord 为 surrounding
agent 的Agent Record 。 - 令 isLittleEndian 为 agentRecord.[[LittleEndian]]。
- 令 rawBytes 为
NumericToRawBytes (type, value, isLittleEndian)。 - 如果
IsSharedArrayBuffer (arrayBuffer) 是true ，则- 令 execution 为 agentRecord.[[CandidateExecution]]。
- 令 eventsRecord 为 execution.[[EventsRecords]] 中 [[AgentSignifier]] 为
AgentSignifier () 的Agent Events Record 。 - 令 rawBytesRead 为长度为 elementSize 的
List ，其元素为非确定性选择的字节值 。 - 注：在实现中，rawBytesRead 是底层硬件上的 load-link、load-exclusive，或读-改-写指令的一个操作数的结果。非确定性是
内存模型 的一项语义规定，用于描述弱一致性硬件的可观察行为。 - 令 rmwEvent 为
ReadModifyWriteSharedMemory { [[Order]]:seq-cst , [[NoTear]]:true , [[Block]]: block, [[ByteIndex]]: byteIndex, [[ElementSize]]: elementSize, [[Payload]]: rawBytes, [[ModifyOp]]: op }。 - 将 rmwEvent 追加到 eventsRecord.[[EventList]]。
- 将
Chosen Value Record { [[Event]]: rmwEvent, [[ChosenValue]]: rawBytesRead } 追加到 execution.[[ChosenValues]]。
- 否则，
- 令 rawBytesRead 为长度为 elementSize 的
List ，其元素是从 block[byteIndex] 开始的 elementSize 个字节序列。 - 令 rawBytesModified 为 op(rawBytesRead, rawBytes)。
- 将 rawBytesModified 的各个字节存储到 block 中，从 block[byteIndex] 开始。
- 令 rawBytesRead 为长度为 elementSize 的
- 返回
RawBytesToNumeric (type, rawBytesRead, isLittleEndian)。
25.1.4 ArrayBuffer 构造器
ArrayBuffer 构造器：
- 是 %ArrayBuffer%。
- 是
全局对象 的"ArrayBuffer" 属性的初始值。 - 在作为构造器调用时创建并初始化一个新的 ArrayBuffer。
- 不意图作为函数调用，并且以这种方式调用时会抛出异常。
- 可以用作类定义的
extends子句的值。打算继承指定 ArrayBuffer 行为的子类构造函数 ，必须包含 一次对 ArrayBuffer构造函数 的super调用，以创建并初始化子类实例，使其具备支持ArrayBuffer.prototype的内置方法所必需的内部状态。
25.1.4.1 ArrayBuffer ( length [ , options ] )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 是
undefined ，则抛出TypeError 异常。 - 令 byteLength 为 ?
ToIndex (length)。 - 令 requestedMaxByteLength 为 ?
GetArrayBufferMaxByteLengthOption (options)。 - 返回 ?
AllocateArrayBuffer (NewTarget, byteLength, requestedMaxByteLength)。
25.1.5 ArrayBuffer 构造器的属性
ArrayBuffer 构造器：
- 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
25.1.5.1 ArrayBuffer.isView ( arg )
此函数在被调用时执行以下步骤：
- 如果 arg 不是 Object，则返回
false 。 - 如果 arg 具有 [[ViewedArrayBuffer]] 内部槽，则返回
true 。 - 返回
false 。
25.1.5.2 ArrayBuffer.prototype
ArrayBuffer.prototype 的初始值是
此属性具有特性 { [[Writable]]:
25.1.5.3 get ArrayBuffer [ %Symbol.species% ]
ArrayBuffer[%Symbol.species%] 是
- 返回
this 值。
此函数的
25.1.6 ArrayBuffer 原型对象的属性
ArrayBuffer 原型对象：
- 是 %ArrayBuffer.prototype%。
- 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是
普通对象 。 - 没有 [[ArrayBufferData]] 或 [[ArrayBufferByteLength]] 内部槽。
25.1.6.1 get ArrayBuffer.prototype.byteLength
ArrayBuffer.prototype.byteLength 是
- 令 obj 为
this 值。 - 执行 ?
RequireInternalSlot (obj, [[ArrayBufferData]])。 - 如果
IsSharedArrayBuffer (obj) 是true ，则抛出TypeError 异常。 - 如果
IsDetachedBuffer (obj) 是true ，则返回+0 𝔽。 - 令 length 为 obj.[[ArrayBufferByteLength]]。
- 返回
𝔽 (length)。
25.1.6.2 ArrayBuffer.prototype.constructor
ArrayBuffer.prototype.constructor 的初始值是
25.1.6.3 get ArrayBuffer.prototype.detached
ArrayBuffer.prototype.detached 是
- 令 obj 为
this 值。 - 执行 ?
RequireInternalSlot (obj, [[ArrayBufferData]])。 - 如果
IsSharedArrayBuffer (obj) 是true ，则抛出TypeError 异常。 - 返回
IsDetachedBuffer (obj)。
25.1.6.4 get ArrayBuffer.prototype.maxByteLength
ArrayBuffer.prototype.maxByteLength 是
- 令 obj 为
this 值。 - 执行 ?
RequireInternalSlot (obj, [[ArrayBufferData]])。 - 如果
IsSharedArrayBuffer (obj) 是true ，则抛出TypeError 异常。 - 如果
IsDetachedBuffer (obj) 是true ，则返回+0 𝔽。 - 如果
IsFixedLengthArrayBuffer (obj) 是true ，则- 令 length 为 obj.[[ArrayBufferByteLength]]。
- 否则，
- 令 length 为 obj.[[ArrayBufferMaxByteLength]]。
- 返回
𝔽 (length)。
25.1.6.5 get ArrayBuffer.prototype.resizable
ArrayBuffer.prototype.resizable 是
- 令 obj 为
this 值。 - 执行 ?
RequireInternalSlot (obj, [[ArrayBufferData]])。 - 如果
IsSharedArrayBuffer (obj) 是true ，则抛出TypeError 异常。 - 如果
IsFixedLengthArrayBuffer (obj) 是false ，则返回true 。 - 返回
false 。
25.1.6.6 ArrayBuffer.prototype.resize ( newLength )
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 执行 ?
RequireInternalSlot (obj, [[ArrayBufferMaxByteLength]])。 - 如果
IsSharedArrayBuffer (obj) 是true ，则抛出TypeError 异常。 - 令 newByteLength 为 ?
ToIndex (newLength)。 - 如果
IsDetachedBuffer (obj) 是true ，则抛出TypeError 异常。 - 如果 newByteLength > obj.[[ArrayBufferMaxByteLength]]，则抛出
RangeError 异常。 - 令 hostHandled 为 ?
HostResizeArrayBuffer (obj, newByteLength)。 - 如果 hostHandled 是
handled ，则返回undefined 。 - 令 oldBlock 为 obj.[[ArrayBufferData]]。
- 令 newBlock 为 ?
CreateByteDataBlock (newByteLength)。 - 令 copyLength 为
min (newByteLength, obj.[[ArrayBufferByteLength]])。 - 执行
CopyDataBlockBytes (newBlock, 0, oldBlock, 0, copyLength)。 - 注：新
Data Block 的创建以及从旧Data Block 的复制都不可观察。实现可以将此方法实现为原地增长或缩小。 - 将 obj.[[ArrayBufferData]] 设置为 newBlock。
- 将 obj.[[ArrayBufferByteLength]] 设置为 newByteLength。
- 返回
undefined 。
25.1.6.7 ArrayBuffer.prototype.slice ( start, end )
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 执行 ?
RequireInternalSlot (obj, [[ArrayBufferData]])。 - 如果
IsSharedArrayBuffer (obj) 是true ，则抛出TypeError 异常。 - 如果
IsDetachedBuffer (obj) 是true ，则抛出TypeError 异常。 - 令 length 为 obj.[[ArrayBufferByteLength]]。
- 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 relativeStart = -∞，则令 first 为 0。
- 否则，如果 relativeStart < 0，则令 first 为
max (length + relativeStart, 0)。 - 否则，令 first 为
min (relativeStart, length)。 - 如果 end 是
undefined ，则令 relativeEnd 为 length；否则令 relativeEnd 为 ?ToIntegerOrInfinity (end)。 - 如果 relativeEnd = -∞，则令 final 为 0。
- 否则，如果 relativeEnd < 0，则令 final 为
max (length + relativeEnd, 0)。 - 否则，令 final 为
min (relativeEnd, length)。 - 令 newLength 为
max (final - first, 0)。 - 令 ctor 为 ?
SpeciesConstructor (obj,%ArrayBuffer% )。 - 令 new 为 ?
Construct (ctor, «𝔽 (newLength) »)。 - 执行 ?
RequireInternalSlot (new, [[ArrayBufferData]])。 - 如果
IsSharedArrayBuffer (new) 是true ，则抛出TypeError 异常。 - 如果
IsDetachedBuffer (new) 是true ，则抛出TypeError 异常。 - 如果
SameValue (new, obj) 是true ，则抛出TypeError 异常。 - 如果 new.[[ArrayBufferByteLength]] < newLength，则抛出
TypeError 异常。 - 注：上述步骤的副作用可能已分离或调整 obj 的大小。
- 如果
IsDetachedBuffer (obj) 是true ，则抛出TypeError 异常。 - 令 fromBuf 为 obj.[[ArrayBufferData]]。
- 令 toBuf 为 new.[[ArrayBufferData]]。
- 令 currentLength 为 obj.[[ArrayBufferByteLength]]。
- 如果 first < currentLength，则
- 令 count 为
min (newLength, currentLength - first)。 - 执行
CopyDataBlockBytes (toBuf, 0, fromBuf, first, count)。
- 令 count 为
- 返回 new。
25.1.6.8 ArrayBuffer.prototype.transfer ( [ newLength ] )
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 返回 ?
ArrayBufferCopyAndDetach (obj, newLength,preserve-resizability )。
25.1.6.9 ArrayBuffer.prototype.transferToFixedLength ( [ newLength ] )
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 返回 ?
ArrayBufferCopyAndDetach (obj, newLength,fixed-length )。
25.1.6.10 ArrayBuffer.prototype [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
25.1.7 ArrayBuffer 实例的属性
ArrayBuffer 实例继承自
[[ArrayBufferData]] 为
[[ArrayBufferDetachKey]] 被设置为除
25.1.8 可调整大小 ArrayBuffer 指南
以下是面向使用可调整大小 ArrayBuffer 的 ECMAScript 程序员的指南。
我们建议尽可能在程序的部署环境中进行测试。不同硬件设备之间可用物理内存的数量差异很大。同样，虚拟内存子系统在不同硬件设备以及操作系统之间也差异很大。一个在 64 位桌面 Web 浏览器上运行而没有内存不足错误的应用，在 32 位移动 Web 浏览器上可能会耗尽内存。
在为可调整大小 ArrayBuffer 选择
请注意，成功构造具有特定最大大小的可调整大小 ArrayBuffer，并不保证未来调整大小会成功。
以下是面向实现可调整大小 ArrayBuffer 的 ECMAScript 实现者的指南。
可调整大小 ArrayBuffer 可以实现为调整大小时复制、通过预先保留虚拟内存进行原地增长，或根据构造器的
如果
如果
25.2 SharedArrayBuffer 对象
25.2.1 定长和可增长的 SharedArrayBuffer 对象
定长 SharedArrayBuffer 是创建后字节长度不能改变的 SharedArrayBuffer。
可增长 SharedArrayBuffer 是创建后字节长度可以通过调用
创建哪种 SharedArrayBuffer 对象取决于传给
25.2.2 SharedArrayBuffer 对象的抽象操作
25.2.2.1 AllocateSharedArrayBuffer ( ctor, byteLength [ , maxByteLength ] )
The abstract operation AllocateSharedArrayBuffer takes arguments ctor (a constructor) and byteLength (a non-negative
- 令 slots 为 « [[ArrayBufferData]] »。
- 如果存在 maxByteLength 且 maxByteLength 不是
empty ，则令 allocatingGrowableBuffer 为true ；否则令 allocatingGrowableBuffer 为false 。 - 如果 allocatingGrowableBuffer 是
true ，则- 如果 byteLength > maxByteLength，则抛出
RangeError 异常。 - 将 [[ArrayBufferByteLengthData]] 和 [[ArrayBufferMaxByteLength]] 追加到 slots。
- 如果 byteLength > maxByteLength，则抛出
- 否则，
- 将 [[ArrayBufferByteLength]] 追加到 slots。
- 令 obj 为 ?
OrdinaryCreateFromConstructor (ctor,"%SharedArrayBuffer.prototype%" , slots)。 - 如果 allocatingGrowableBuffer 是
true ，则令 allocLength 为 maxByteLength；否则令 allocLength 为 byteLength。 - 令 block 为 ?
CreateSharedByteDataBlock (allocLength)。 - 将 obj.[[ArrayBufferData]] 设置为 block。
- 如果 allocatingGrowableBuffer 是
true ，则- 断言：byteLength ≤ maxByteLength。
- 令 byteLengthBlock 为 ?
CreateSharedByteDataBlock (8)。 - 执行
SetValueInBuffer (byteLengthBlock, 0,biguint64 ,ℤ (byteLength),true ,seq-cst )。 - 将 obj.[[ArrayBufferByteLengthData]] 设置为 byteLengthBlock。
- 将 obj.[[ArrayBufferMaxByteLength]] 设置为 maxByteLength。
- 否则，
- 将 obj.[[ArrayBufferByteLength]] 设置为 byteLength。
- 返回 obj。
25.2.2.2 IsSharedArrayBuffer ( obj )
The abstract operation IsSharedArrayBuffer takes argument obj (an ArrayBuffer or a SharedArrayBuffer) and returns a Boolean. 它测试一个对象是否为 SharedArrayBuffer。 It performs the following steps when called:
- 如果 obj.[[ArrayBufferData]] 是
Shared Data Block ，则返回true 。 - 返回
false 。
25.2.2.3 IsGrowableSharedArrayBuffer ( obj )
The abstract operation IsGrowableSharedArrayBuffer takes argument obj (an ArrayBuffer or a SharedArrayBuffer) and returns a Boolean. 它测试一个对象是否为可增长的 SharedArrayBuffer。 It performs the following steps when called:
- 如果
IsSharedArrayBuffer (obj) 是true 且 obj 具有 [[ArrayBufferByteLengthData]] 内部槽，则返回true 。 - 返回
false 。
25.2.2.4 HostGrowSharedArrayBuffer ( buffer, newByteLength )
The host-defined abstract operation HostGrowSharedArrayBuffer takes arguments buffer (a SharedArrayBuffer) and newByteLength (a non-negative
HostGrowSharedArrayBuffer 的实现必须符合以下要求：
- 如果该
抽象操作 未以unhandled 正常完成 ，并且 newByteLength < buffer 的当前字节长度或 newByteLength > buffer.[[ArrayBufferMaxByteLength]]，则抛出RangeError 异常。 - 令 agentRecord 为 surrounding
agent 的Agent Record 。令 isLittleEndian 为 agentRecord.[[LittleEndian]]。如果该抽象操作 以handled 正常完成 ，则会向 surroundingagent 的candidate execution 添加一个WriteSharedMemory 或ReadModifyWriteSharedMemory 事件，其 [[Order]] 为seq-cst ，[[Payload]] 为NumericToRawBytes (biguint64 , newByteLength, isLittleEndian)，[[Block]] 为 buffer.[[ArrayBufferByteLengthData]]，[[ByteIndex]] 为 0，且 [[ElementSize]] 为 8，其添加方式使得对SharedArrayBuffer.prototype.grow ( newLength ) 的竞态调用不会“丢失”，即不会悄然什么都不做。
上面的第二项要求有意对如何或何时读取 buffer 的当前字节长度保持模糊。由于字节长度必须通过底层硬件上的原子读-改-写操作来更新，使用 load-link/store-conditional 或 load-exclusive/store-exclusive 指令对的架构可能希望让成对指令在指令流中保持接近。因此，
这与
HostGrowSharedArrayBuffer 的默认实现是返回
25.2.3 SharedArrayBuffer 构造器
SharedArrayBuffer 构造器：
- 是 %SharedArrayBuffer%。
- 是
全局对象 的"SharedArrayBuffer" 属性的初始值，如果该属性存在（见下文）。 - 在作为构造器调用时创建并初始化一个新的 SharedArrayBuffer。
- 不意图作为函数调用，并且以这种方式调用时会抛出异常。
- 可以用作类定义的
extends子句的值。打算继承指定 SharedArrayBuffer 行为的子类构造函数 ，必须包含 一次对 SharedArrayBuffer构造函数 的super调用，以创建并初始化子类实例，使其具备支持SharedArrayBuffer.prototype的内置方法所必需的内部状态。
每当
不同于 ArrayBuffer，SharedArrayBuffer 不能被分离，其内部 [[ArrayBufferData]] 槽永远不会是
25.2.3.1 SharedArrayBuffer ( length [ , options ] )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 是
undefined ，则抛出TypeError 异常。 - 令 byteLength 为 ?
ToIndex (length)。 - 令 requestedMaxByteLength 为 ?
GetArrayBufferMaxByteLengthOption (options)。 - 返回 ?
AllocateSharedArrayBuffer (NewTarget, byteLength, requestedMaxByteLength)。
25.2.4 SharedArrayBuffer 构造器的属性
SharedArrayBuffer 构造器：
- 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
25.2.4.1 SharedArrayBuffer.prototype
SharedArrayBuffer.prototype 的初始值是
此属性具有特性 { [[Writable]]:
25.2.4.2 get SharedArrayBuffer [ %Symbol.species% ]
SharedArrayBuffer[%Symbol.species%] 是
- 返回
this 值。
此函数的
25.2.5 SharedArrayBuffer 原型对象的属性
SharedArrayBuffer 原型对象：
- 是 %SharedArrayBuffer.prototype%。
- 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是
普通对象 。 - 没有 [[ArrayBufferData]] 或 [[ArrayBufferByteLength]] 内部槽。
25.2.5.1 get SharedArrayBuffer.prototype.byteLength
SharedArrayBuffer.prototype.byteLength 是
- 令 obj 为
this 值。 - 执行 ?
RequireInternalSlot (obj, [[ArrayBufferData]])。 - 如果
IsSharedArrayBuffer (obj) 是false ，则抛出TypeError 异常。 - 令 length 为
ArrayBufferByteLength (obj,seq-cst )。 - 返回
𝔽 (length)。
25.2.5.2 SharedArrayBuffer.prototype.constructor
SharedArrayBuffer.prototype.constructor 的初始值是
25.2.5.3 SharedArrayBuffer.prototype.grow ( newLength )
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 执行 ?
RequireInternalSlot (obj, [[ArrayBufferMaxByteLength]])。 - 如果
IsSharedArrayBuffer (obj) 是false ，则抛出TypeError 异常。 - 令 newByteLength 为 ?
ToIndex (newLength)。 - 令 hostHandled 为 ?
HostGrowSharedArrayBuffer (obj, newByteLength)。 - 如果 hostHandled 是
handled ，则返回undefined 。 - 令 agentRecord 为 surrounding
agent 的Agent Record 。 - 令 isLittleEndian 为 agentRecord.[[LittleEndian]]。
- 令 byteLengthBlock 为 obj.[[ArrayBufferByteLengthData]]。
- 令 currentByteLengthRawBytes 为
GetRawBytesFromSharedBlock (byteLengthBlock, 0,biguint64 ,true ,seq-cst )。 - 令 newByteLengthRawBytes 为
NumericToRawBytes (biguint64 ,ℤ (newByteLength), isLittleEndian)。 - 重复，
- 注：这是一个 compare-and-exchange 循环，用于确保同一缓冲区的并行竞态增长被完全排序，不会丢失，也不会悄然什么都不做。如果它能够尝试无
争用 地增长，则循环退出。 - 令 currentByteLength 为
ℝ (RawBytesToNumeric (biguint64 , currentByteLengthRawBytes, isLittleEndian))。 - 如果 newByteLength = currentByteLength，则返回
undefined 。 - 如果 newByteLength < currentByteLength 或 newByteLength > obj.[[ArrayBufferMaxByteLength]]，则抛出
RangeError 异常。 - 令 byteLengthDelta 为 newByteLength - currentByteLength。
- 如果无法创建由 byteLengthDelta 个字节组成的新
Shared Data Block 值，则抛出RangeError 异常。 - 注：这里不会构造并使用新的
Shared Data Block 。可增长 SharedArrayBuffer 的可观察行为通过在构造时分配最大大小的Shared Data Block 来指定，此步骤捕获了运行内存不足的实现必须抛出RangeError 的要求。 - 令 readByteLengthRawBytes 为
AtomicCompareExchangeInSharedBlock (byteLengthBlock, 0, 8, currentByteLengthRawBytes, newByteLengthRawBytes)。 - 如果
ByteListEqual (readByteLengthRawBytes, currentByteLengthRawBytes) 是true ，则返回undefined 。 - 将 currentByteLengthRawBytes 设置为 readByteLengthRawBytes。
- 注：这是一个 compare-and-exchange 循环，用于确保同一缓冲区的并行竞态增长被完全排序，不会丢失，也不会悄然什么都不做。如果它能够尝试无
禁止 compare-exchange 更新长度时出现伪失败。如果新长度的边界检查通过且实现未内存不足，则总会向
对 SharedArrayBuffer.prototype.grow 的并行调用是完全排序的。例如，考虑两个竞态调用：sab.grow(10) 和 sab.grow(20)。这两个调用中保证有一个会赢得竞态。即使 sab.grow(20) 先发生，对 sab.grow(10) 的调用也绝不会缩小 sab；在这种情况下，它会改为抛出 RangeError。
25.2.5.4 get SharedArrayBuffer.prototype.growable
SharedArrayBuffer.prototype.growable 是
- 令 obj 为
this 值。 - 执行 ?
RequireInternalSlot (obj, [[ArrayBufferData]])。 - 如果
IsSharedArrayBuffer (obj) 是false ，则抛出TypeError 异常。 - 如果
IsFixedLengthArrayBuffer (obj) 是false ，则返回true 。 - 返回
false 。
25.2.5.5 get SharedArrayBuffer.prototype.maxByteLength
SharedArrayBuffer.prototype.maxByteLength 是
- 令 obj 为
this 值。 - 执行 ?
RequireInternalSlot (obj, [[ArrayBufferData]])。 - 如果
IsSharedArrayBuffer (obj) 是false ，则抛出TypeError 异常。 - 如果
IsFixedLengthArrayBuffer (obj) 是true ，则- 令 length 为 obj.[[ArrayBufferByteLength]]。
- 否则，
- 令 length 为 obj.[[ArrayBufferMaxByteLength]]。
- 返回
𝔽 (length)。
25.2.5.6 SharedArrayBuffer.prototype.slice ( start, end )
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 执行 ?
RequireInternalSlot (obj, [[ArrayBufferData]])。 - 如果
IsSharedArrayBuffer (obj) 是false ，则抛出TypeError 异常。 - 令 length 为
ArrayBufferByteLength (obj,seq-cst )。 - 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 relativeStart = -∞，则令 first 为 0。
- 否则，如果 relativeStart < 0，则令 first 为
max (length + relativeStart, 0)。 - 否则，令 first 为
min (relativeStart, length)。 - 如果 end 是
undefined ，则令 relativeEnd 为 length；否则令 relativeEnd 为 ?ToIntegerOrInfinity (end)。 - 如果 relativeEnd = -∞，则令 final 为 0。
- 否则，如果 relativeEnd < 0，则令 final 为
max (length + relativeEnd, 0)。 - 否则，令 final 为
min (relativeEnd, length)。 - 令 newLength 为
max (final - first, 0)。 - 令 ctor 为 ?
SpeciesConstructor (obj,%SharedArrayBuffer% )。 - 令 new 为 ?
Construct (ctor, «𝔽 (newLength) »)。 - 执行 ?
RequireInternalSlot (new, [[ArrayBufferData]])。 - 如果
IsSharedArrayBuffer (new) 是false ，则抛出TypeError 异常。 - 如果 new.[[ArrayBufferData]] 是 obj.[[ArrayBufferData]]，则抛出
TypeError 异常。 - 如果
ArrayBufferByteLength (new,seq-cst ) < newLength，则抛出TypeError 异常。 - 令 fromBuf 为 obj.[[ArrayBufferData]]。
- 令 toBuf 为 new.[[ArrayBufferData]]。
- 执行
CopyDataBlockBytes (toBuf, 0, fromBuf, first, newLength)。 - 返回 new。
25.2.5.7 SharedArrayBuffer.prototype [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
25.2.6 SharedArrayBuffer 实例的属性
SharedArrayBuffer 实例继承自
SharedArrayBuffer 实例不同于 ArrayBuffer 实例，它们永远不会被分离。
25.2.7 可增长 SharedArrayBuffer 指南
以下是面向使用
我们建议尽可能在程序的部署环境中进行测试。不同硬件设备之间可用物理内存的数量差异很大。同样，虚拟内存子系统在不同硬件设备以及操作系统之间也差异很大。一个在 64 位桌面 Web 浏览器上运行而没有内存不足错误的应用，在 32 位移动 Web 浏览器上可能会耗尽内存。
在为
请注意，成功构造具有特定最大大小的
并非所有对u8[idx]）边界检查的长度加载不是同步性的。通常，在没有显式同步的情况下，一个属性访问在边界内并不意味着同一 length 与 byteLength getter 对长度进行的显式加载是同步性的。由内置方法为检查
以下是面向实现
我们建议将
由于增长操作可以与
增长后的内存必须从其创建的那一刻起表现为零填充，包括对于并行的任何竞态访问也是如此。这可以通过按需零填充的虚拟内存页实现，或者在手动清零内存时通过谨慎同步来实现。
对
实践中，在没有虚拟内存的
25.3 DataView 对象
25.3.1 DataView 对象的抽象操作
25.3.1.1 DataView With Buffer Witness Record
DataView With Buffer Witness Record 是一种
DataView With Buffer Witness Record 具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Object]] | a DataView | 加载其缓冲区字节长度的 DataView 对象。 |
| [[CachedBufferByteLength]] |
a non-negative |
创建该 |
25.3.1.2 MakeDataViewWithBufferWitnessRecord ( obj, order )
The abstract operation MakeDataViewWithBufferWitnessRecord takes arguments obj (a DataView) and order (
- 令 buffer 为 obj.[[ViewedArrayBuffer]]。
- 如果
IsDetachedBuffer (buffer) 是true ，则- 令 byteLength 为
detached 。
- 令 byteLength 为
- 否则，
- 令 byteLength 为
ArrayBufferByteLength (buffer, order)。
- 令 byteLength 为
- 返回
DataView With Buffer Witness Record { [[Object]]: obj, [[CachedBufferByteLength]]: byteLength }。
25.3.1.3 GetViewByteLength ( viewRecord )
The abstract operation GetViewByteLength takes argument viewRecord (a
- 断言：
IsViewOutOfBounds (viewRecord) 是false 。 - 令 view 为 viewRecord.[[Object]]。
- 如果 view.[[ByteLength]] 不是
auto ，则返回 view.[[ByteLength]]。 - 断言：
IsFixedLengthArrayBuffer (view.[[ViewedArrayBuffer]]) 是false 。 - 令 byteOffset 为 view.[[ByteOffset]]。
- 令 byteLength 为 viewRecord.[[CachedBufferByteLength]]。
- 断言：byteLength 不是
detached 。 - 返回 byteLength - byteOffset。
25.3.1.4 IsViewOutOfBounds ( viewRecord )
The abstract operation IsViewOutOfBounds takes argument viewRecord (a
- 令 view 为 viewRecord.[[Object]]。
- 令 bufferByteLength 为 viewRecord.[[CachedBufferByteLength]]。
- 如果
IsDetachedBuffer (view.[[ViewedArrayBuffer]]) 是true ，则- 断言：bufferByteLength 是
detached 。 - 返回
true 。
- 断言：bufferByteLength 是
- 断言：bufferByteLength 是非负整数。
- 令 byteOffsetStart 为 view.[[ByteOffset]]。
- 如果 view.[[ByteLength]] 是
auto ，则- 令 byteOffsetEnd 为 bufferByteLength。
- 否则，
- 令 byteOffsetEnd 为 byteOffsetStart + view.[[ByteLength]]。
- 注：[[ByteOffset]] 为 bufferByteLength 的 0 长度 DataView 不被视为越界。
- 如果 byteOffsetStart > bufferByteLength 或 byteOffsetEnd > bufferByteLength，则返回
true 。 - 返回
false 。
25.3.1.5 GetViewValue ( view, requestIndex, isLittleEndian, type )
The abstract operation GetViewValue takes arguments view (an ECMAScript language value), requestIndex (an ECMAScript language value), isLittleEndian (an ECMAScript language value), and type (a
- 执行 ?
RequireInternalSlot (view, [[DataView]])。 - 断言：view 具有 [[ViewedArrayBuffer]] 内部槽。
- 令 getIndex 为 ?
ToIndex (requestIndex)。 - 将 isLittleEndian 设置为
ToBoolean (isLittleEndian)。 - 令 viewOffset 为 view.[[ByteOffset]]。
- 令 viewRecord 为
MakeDataViewWithBufferWitnessRecord (view,unordered )。 - 注：当 view 的后备缓冲区是
可增长 SharedArrayBuffer 时，边界检查不是同步操作。 - 如果
IsViewOutOfBounds (viewRecord) 是true ，则抛出TypeError 异常。 - 令 viewSize 为
GetViewByteLength (viewRecord)。 - 令 elementSize 为
Table 71 中为 Element Type type 指定的 Element Size 值。 - 如果 getIndex + elementSize > viewSize，则抛出
RangeError 异常。 - 令 bufferIndex 为 getIndex + viewOffset。
- 返回
GetValueFromBuffer (view.[[ViewedArrayBuffer]], bufferIndex, type,false ,unordered , isLittleEndian)。
25.3.1.6 SetViewValue ( view, requestIndex, isLittleEndian, type, value )
The abstract operation SetViewValue takes arguments view (an ECMAScript language value), requestIndex (an ECMAScript language value), isLittleEndian (an ECMAScript language value), type (a
- 执行 ?
RequireInternalSlot (view, [[DataView]])。 - 断言：view 具有 [[ViewedArrayBuffer]] 内部槽。
- 令 getIndex 为 ?
ToIndex (requestIndex)。 - 如果
IsBigIntElementType (type) 是true ，则令 number 为 ?ToBigInt (value)。 - 否则，令 number 为 ?
ToNumber (value)。 - 将 isLittleEndian 设置为
ToBoolean (isLittleEndian)。 - 令 viewOffset 为 view.[[ByteOffset]]。
- 令 viewRecord 为
MakeDataViewWithBufferWitnessRecord (view,unordered )。 - 注：当 view 的后备缓冲区是
可增长 SharedArrayBuffer 时，边界检查不是同步操作。 - 如果
IsViewOutOfBounds (viewRecord) 是true ，则抛出TypeError 异常。 - 令 viewSize 为
GetViewByteLength (viewRecord)。 - 令 elementSize 为
Table 71 中为 Element Type type 指定的 Element Size 值。 - 如果 getIndex + elementSize > viewSize，则抛出
RangeError 异常。 - 令 bufferIndex 为 getIndex + viewOffset。
- 执行
SetValueInBuffer (view.[[ViewedArrayBuffer]], bufferIndex, type, number,false ,unordered , isLittleEndian)。 - 返回
undefined 。
25.3.2 DataView 构造器
DataView 构造器：
- 是 %DataView%。
- 是
全局对象 的"DataView" 属性的初始值。 - 在作为构造器调用时创建并初始化一个新的 DataView。
- 不意图作为函数调用，并且以这种方式调用时会抛出异常。
- 可以用作类定义的
extends子句的值。打算继承指定 DataView 行为的子类构造函数 ，必须包含 一次对 DataView构造函数 的super调用，以创建并初始化子类实例，使其具备支持DataView.prototype的内置方法所必需的内部状态。
25.3.2.1 DataView ( buffer [ , byteOffset [ , byteLength ] ] )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 是
undefined ，则抛出TypeError 异常。 - 执行 ?
RequireInternalSlot (buffer, [[ArrayBufferData]])。 - 令 offset 为 ?
ToIndex (byteOffset)。 - 如果
IsDetachedBuffer (buffer) 是true ，则抛出TypeError 异常。 - 令 bufferByteLength 为
ArrayBufferByteLength (buffer,seq-cst )。 - 如果 offset > bufferByteLength，则抛出
RangeError 异常。 - 令 bufferIsFixedLength 为
IsFixedLengthArrayBuffer (buffer)。 - 如果 byteLength 是
undefined ，则- 如果 bufferIsFixedLength 是
true ，则- 令 viewByteLength 为 bufferByteLength - offset。
- 否则，
- 令 viewByteLength 为
auto 。
- 令 viewByteLength 为
- 如果 bufferIsFixedLength 是
- 否则，
- 令 viewByteLength 为 ?
ToIndex (byteLength)。 - 如果 offset + viewByteLength > bufferByteLength，则抛出
RangeError 异常。
- 令 viewByteLength 为 ?
- 令 obj 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%DataView.prototype%" , « [[DataView]], [[ViewedArrayBuffer]], [[ByteLength]], [[ByteOffset]] »)。 - 如果
IsDetachedBuffer (buffer) 是true ，则抛出TypeError 异常。 - 将 bufferByteLength 设置为
ArrayBufferByteLength (buffer,seq-cst )。 - 如果 offset > bufferByteLength，则抛出
RangeError 异常。 - 如果 byteLength 不是
undefined ，则- 如果 offset + viewByteLength > bufferByteLength，则抛出
RangeError 异常。
- 如果 offset + viewByteLength > bufferByteLength，则抛出
- 将 obj.[[ViewedArrayBuffer]] 设置为 buffer。
- 将 obj.[[ByteLength]] 设置为 viewByteLength。
- 将 obj.[[ByteOffset]] 设置为 offset。
- 返回 obj。
25.3.3 DataView 构造器的属性
DataView 构造器：
- 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
25.3.3.1 DataView.prototype
DataView.prototype 的初始值是
此属性具有特性 { [[Writable]]:
25.3.4 DataView 原型对象的属性
DataView 原型对象：
- 是 %DataView.prototype%。
- 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是
普通对象 。 - 没有 [[DataView]]、[[ViewedArrayBuffer]]、[[ByteLength]] 或 [[ByteOffset]] 内部槽。
25.3.4.1 get DataView.prototype.buffer
DataView.prototype.buffer 是
- 令 obj 为
this 值。 - 执行 ?
RequireInternalSlot (obj, [[DataView]])。 - 断言：obj 具有 [[ViewedArrayBuffer]] 内部槽。
- 令 buffer 为 obj.[[ViewedArrayBuffer]]。
- 返回 buffer。
25.3.4.2 get DataView.prototype.byteLength
DataView.prototype.byteLength 是
- 令 obj 为
this 值。 - 执行 ?
RequireInternalSlot (obj, [[DataView]])。 - 断言：obj 具有 [[ViewedArrayBuffer]] 内部槽。
- 令 viewRecord 为
MakeDataViewWithBufferWitnessRecord (obj,seq-cst )。 - 如果
IsViewOutOfBounds (viewRecord) 是true ，则抛出TypeError 异常。 - 令 size 为
GetViewByteLength (viewRecord)。 - 返回
𝔽 (size)。
25.3.4.3 get DataView.prototype.byteOffset
DataView.prototype.byteOffset 是
- 令 obj 为
this 值。 - 执行 ?
RequireInternalSlot (obj, [[DataView]])。 - 断言：obj 具有 [[ViewedArrayBuffer]] 内部槽。
- 令 viewRecord 为
MakeDataViewWithBufferWitnessRecord (obj,seq-cst )。 - 如果
IsViewOutOfBounds (viewRecord) 是true ，则抛出TypeError 异常。 - 令 offset 为 obj.[[ByteOffset]]。
- 返回
𝔽 (offset)。
25.3.4.4 DataView.prototype.constructor
DataView.prototype.constructor 的初始值是
25.3.4.5 DataView.prototype.getBigInt64 ( byteOffset [ , littleEndian ] )
此方法在被调用时执行以下步骤：
- 令 view 为
this 值。 - 返回 ?
GetViewValue (view, byteOffset, littleEndian,bigint64 )。
25.3.4.6 DataView.prototype.getBigUint64 ( byteOffset [ , littleEndian ] )
此方法在被调用时执行以下步骤：
- 令 view 为
this 值。 - 返回 ?
GetViewValue (view, byteOffset, littleEndian,biguint64 )。
25.3.4.7 DataView.prototype.getFloat16 ( byteOffset [ , littleEndian ] )
此方法在被调用时执行以下步骤：
- 令 view 为
this 值。 - 如果 littleEndian 不存在，则将 littleEndian 设置为
false 。 - 返回 ?
GetViewValue (view, byteOffset, littleEndian,float16 )。
25.3.4.8 DataView.prototype.getFloat32 ( byteOffset [ , littleEndian ] )
此方法在被调用时执行以下步骤：
- 令 view 为
this 值。 - 如果 littleEndian 不存在，则将 littleEndian 设置为
false 。 - 返回 ?
GetViewValue (view, byteOffset, littleEndian,float32 )。
25.3.4.9 DataView.prototype.getFloat64 ( byteOffset [ , littleEndian ] )
此方法在被调用时执行以下步骤：
- 令 view 为
this 值。 - 如果 littleEndian 不存在，则将 littleEndian 设置为
false 。 - 返回 ?
GetViewValue (view, byteOffset, littleEndian,float64 )。
25.3.4.10 DataView.prototype.getInt8 ( byteOffset )
此方法在被调用时执行以下步骤：
- 令 view 为
this 值。 - 返回 ?
GetViewValue (view, byteOffset,true ,int8 )。
25.3.4.11 DataView.prototype.getInt16 ( byteOffset [ , littleEndian ] )
此方法在被调用时执行以下步骤：
- 令 view 为
this 值。 - 如果 littleEndian 不存在，则将 littleEndian 设置为
false 。 - 返回 ?
GetViewValue (view, byteOffset, littleEndian,int16 )。
25.3.4.12 DataView.prototype.getInt32 ( byteOffset [ , littleEndian ] )
此方法在被调用时执行以下步骤：
- 令 view 为
this 值。 - 如果 littleEndian 不存在，则将 littleEndian 设置为
false 。 - 返回 ?
GetViewValue (view, byteOffset, littleEndian,int32 )。
25.3.4.13 DataView.prototype.getUint8 ( byteOffset )
此方法在被调用时执行以下步骤：
- 令 view 为
this 值。 - 返回 ?
GetViewValue (view, byteOffset,true ,uint8 )。
25.3.4.14 DataView.prototype.getUint16 ( byteOffset [ , littleEndian ] )
此方法在被调用时执行以下步骤：
- 令 view 为
this 值。 - 如果 littleEndian 不存在，则将 littleEndian 设置为
false 。 - 返回 ?
GetViewValue (view, byteOffset, littleEndian,uint16 )。
25.3.4.15 DataView.prototype.getUint32 ( byteOffset [ , littleEndian ] )
此方法在被调用时执行以下步骤：
- 令 view 为
this 值。 - 如果 littleEndian 不存在，则将 littleEndian 设置为
false 。 - 返回 ?
GetViewValue (view, byteOffset, littleEndian,uint32 )。
25.3.4.16 DataView.prototype.setBigInt64 ( byteOffset, value [ , littleEndian ] )
此方法在被调用时执行以下步骤：
- 令 view 为
this 值。 - 返回 ?
SetViewValue (view, byteOffset, littleEndian,bigint64 , value)。
25.3.4.17 DataView.prototype.setBigUint64 ( byteOffset, value [ , littleEndian ] )
此方法在被调用时执行以下步骤：
- 令 view 为
this 值。 - 返回 ?
SetViewValue (view, byteOffset, littleEndian,biguint64 , value)。
25.3.4.18 DataView.prototype.setFloat16 ( byteOffset, value [ , littleEndian ] )
此方法在被调用时执行以下步骤：
- 令 view 为
this 值。 - 如果 littleEndian 不存在，则将 littleEndian 设置为
false 。 - 返回 ?
SetViewValue (view, byteOffset, littleEndian,float16 , value)。
25.3.4.19 DataView.prototype.setFloat32 ( byteOffset, value [ , littleEndian ] )
此方法在被调用时执行以下步骤：
- 令 view 为
this 值。 - 如果 littleEndian 不存在，则将 littleEndian 设置为
false 。 - 返回 ?
SetViewValue (view, byteOffset, littleEndian,float32 , value)。
25.3.4.20 DataView.prototype.setFloat64 ( byteOffset, value [ , littleEndian ] )
此方法在被调用时执行以下步骤：
- 令 view 为
this 值。 - 如果 littleEndian 不存在，则将 littleEndian 设置为
false 。 - 返回 ?
SetViewValue (view, byteOffset, littleEndian,float64 , value)。
25.3.4.21 DataView.prototype.setInt8 ( byteOffset, value )
此方法在被调用时执行以下步骤：
- 令 view 为
this 值。 - 返回 ?
SetViewValue (view, byteOffset,true ,int8 , value)。
25.3.4.22 DataView.prototype.setInt16 ( byteOffset, value [ , littleEndian ] )
此方法在被调用时执行以下步骤：
- 令 view 为
this 值。 - 如果 littleEndian 不存在，则将 littleEndian 设置为
false 。 - 返回 ?
SetViewValue (view, byteOffset, littleEndian,int16 , value)。
25.3.4.23 DataView.prototype.setInt32 ( byteOffset, value [ , littleEndian ] )
此方法在被调用时执行以下步骤：
- 令 view 为
this 值。 - 如果 littleEndian 不存在，则将 littleEndian 设置为
false 。 - 返回 ?
SetViewValue (view, byteOffset, littleEndian,int32 , value)。
25.3.4.24 DataView.prototype.setUint8 ( byteOffset, value )
此方法在被调用时执行以下步骤：
- 令 view 为
this 值。 - 返回 ?
SetViewValue (view, byteOffset,true ,uint8 , value)。
25.3.4.25 DataView.prototype.setUint16 ( byteOffset, value [ , littleEndian ] )
此方法在被调用时执行以下步骤：
- 令 view 为
this 值。 - 如果 littleEndian 不存在，则将 littleEndian 设置为
false 。 - 返回 ?
SetViewValue (view, byteOffset, littleEndian,uint16 , value)。
25.3.4.26 DataView.prototype.setUint32 ( byteOffset, value [ , littleEndian ] )
此方法在被调用时执行以下步骤：
- 令 view 为
this 值。 - 如果 littleEndian 不存在，则将 littleEndian 设置为
false 。 - 返回 ?
SetViewValue (view, byteOffset, littleEndian,uint32 , value)。
25.3.4.27 DataView.prototype [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
25.3.5 DataView 实例的属性
DataView 实例是
[[DataView]] 内部槽的值在本规范中不被使用。该内部槽的单纯存在用于在规范中识别使用 DataView 构造器创建的对象。
25.4 Atomics 对象
Atomics 对象：
- 是 %Atomics%。
- 是
全局对象 的"Atomics" 属性的初始值。 - 是
普通对象 。 - 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 没有 [[Construct]] 内部方法；它不能作为构造器与
new操作符一起使用。 - 没有 [[Call]] 内部方法；它不能作为函数调用。
Atomics 对象提供在共享内存数组单元上不可分割地（原子地）操作的函数，以及让
有关在 ECMAScript 中编程和实现共享内存的信息性指南，请参阅
25.4.1 Waiter Record
Waiter Record 是一种 Atomics.wait 或 Atomics.waitAsync 的某次特定调用。
Waiter Record 具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[AgentSignifier]] |
an |
调用了 Atomics.wait 或 Atomics.waitAsync 的 |
| [[PromiseCapability]] |
a |
如果表示对 Atomics.waitAsync 的调用，则为所得的 promise，否则为 |
| [[TimeoutTime]] |
a non-negative |
可以触发超时的最早时间；使用 |
| [[Result]] |
|
调用的返回值。 |
25.4.2 WaiterList Record
WaiterList Record 用于解释通过 Atomics.wait、Atomics.waitAsync 和 Atomics.notify 对
WaiterList Record 具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Waiters]] |
a |
在与此 WaiterList 关联的位置上等待的 Atomics.wait 或 Atomics.waitAsync 调用。
|
| [[MostRecentLeaveEvent]] |
a |
最近一次离开其 |
WaiterList 中可以有多个具有相同
每个 WaiterList Record 都有一个临界区，用于在求值期间控制对该 WaiterList Record 的独占访问。同一时间只能有一个
25.4.3 Atomics 的抽象操作
25.4.3.1 ValidateIntegerTypedArray ( ta, waitable )
The abstract operation ValidateIntegerTypedArray takes arguments ta (an ECMAScript language value) and waitable (a Boolean) and returns either a normal completion containing a
- 令 taRecord 为 ?
ValidateTypedArray (ta,unordered )。 - 注：当 ta 的后备缓冲区是
可增长 SharedArrayBuffer 时，边界检查不是同步操作。 - 如果 waitable 是
true ，则- 如果 ta.[[TypedArrayName]] 既不是
"Int32Array" 也不是"BigInt64Array" ，则抛出TypeError 异常。
- 如果 ta.[[TypedArrayName]] 既不是
- 否则，
- 令 type 为
TypedArrayElementType (ta)。 - 如果
IsUnclampedIntegerElementType (type) 是false 且IsBigIntElementType (type) 是false ，则抛出TypeError 异常。
- 令 type 为
- 返回 taRecord。
25.4.3.2 ValidateAtomicAccess ( taRecord, requestIndex )
The abstract operation ValidateAtomicAccess takes arguments taRecord (a
- 令 length 为
TypedArrayLength (taRecord)。 - 令 accessIndex 为 ?
ToIndex (requestIndex)。 - 断言：accessIndex ≥ 0。
- 如果 accessIndex ≥ length，则抛出
RangeError 异常。 - 令 ta 为 taRecord.[[Object]]。
- 令 elementSize 为
TypedArrayElementSize (ta)。 - 令 offset 为 ta.[[ByteOffset]]。
- 返回 (accessIndex × elementSize) + offset。
25.4.3.3 ValidateAtomicAccessOnIntegerTypedArray ( ta, requestIndex )
The abstract operation ValidateAtomicAccessOnIntegerTypedArray takes arguments ta (an ECMAScript language value) and requestIndex (an ECMAScript language value) and returns either a normal completion containing a non-negative
- 令 taRecord 为 ?
ValidateIntegerTypedArray (ta,false )。 - 返回 ?
ValidateAtomicAccess (taRecord, requestIndex)。
25.4.3.4 RevalidateAtomicAccess ( ta, byteIndexInBuffer )
The abstract operation RevalidateAtomicAccess takes arguments ta (a
- 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (ta,unordered )。 - 注：当 ta 的后备缓冲区是
可增长 SharedArrayBuffer 时，边界检查不是同步操作。 - 如果
IsTypedArrayOutOfBounds (taRecord) 是true ，则抛出TypeError 异常。 - 断言：byteIndexInBuffer ≥ ta.[[ByteOffset]]。
- 如果 byteIndexInBuffer ≥ taRecord.[[CachedBufferByteLength]]，则抛出
RangeError 异常。 - 返回
unused 。
25.4.3.5 GetWaiterList ( block, i )
The abstract operation GetWaiterList takes arguments block (a
- 断言：i 和 i + 3 是 block 内存内的有效字节偏移量。
- 返回由对 (block, i) 引用的
WaiterList Record 。
25.4.3.6 EnterCriticalSection ( waiterList )
The abstract operation EnterCriticalSection takes argument waiterList (a
- 断言：surrounding
agent 不在任何WaiterList Record 的临界区 中。 - 等待直到没有
agent 位于 waiterList 的临界区 中，然后进入 waiterList 的临界区 （不允许任何其他agent 进入）。 - 如果 waiterList.[[MostRecentLeaveEvent]] 不是
empty ，则- 注：至少进入过一次
临界区 的 waiterList 具有由LeaveCriticalSection 设置的Synchronize 事件。 - 令 agentRecord 为 surrounding
agent 的Agent Record 。 - 令 execution 为 agentRecord.[[CandidateExecution]]。
- 令 eventsRecord 为 execution.[[EventsRecords]] 中 [[AgentSignifier]] 为
AgentSignifier () 的Agent Events Record 。 - 令 enterEvent 为新的
Synchronize 事件。 - 将 enterEvent 追加到 eventsRecord.[[EventList]]。
- 将 (waiterList.[[MostRecentLeaveEvent]], enterEvent) 追加到 eventsRecord.[[AgentSynchronizesWith]]。
- 注：至少进入过一次
- 返回
unused 。
当试图进入
25.4.3.7 LeaveCriticalSection ( waiterList )
The abstract operation LeaveCriticalSection takes argument waiterList (a
- 断言：surrounding
agent 位于 waiterList 的临界区 中。 - 令 agentRecord 为 surrounding
agent 的Agent Record 。 - 令 execution 为 agentRecord.[[CandidateExecution]]。
- 令 eventsRecord 为 execution.[[EventsRecords]] 中 [[AgentSignifier]] 为
AgentSignifier () 的Agent Events Record 。 - 令 leaveEvent 为新的
Synchronize 事件。 - 将 leaveEvent 追加到 eventsRecord.[[EventList]]。
- 将 waiterList.[[MostRecentLeaveEvent]] 设置为 leaveEvent。
- 离开 waiterList 的
临界区 。 - 返回
unused 。
25.4.3.8 AddWaiter ( waiterList, waiterRecord )
The abstract operation AddWaiter takes arguments waiterList (a
- 断言：surrounding
agent 位于 waiterList 的临界区 中。 - 断言：waiterList.[[Waiters]] 中不存在 [[PromiseCapability]] 字段为 waiterRecord.[[PromiseCapability]] 且 [[AgentSignifier]] 字段为 waiterRecord.[[AgentSignifier]] 的
Waiter Record 。 - 将 waiterRecord 追加到 waiterList.[[Waiters]]。
- 返回
unused 。
25.4.3.9 RemoveWaiter ( waiterList, waiterRecord )
The abstract operation RemoveWaiter takes arguments waiterList (a
25.4.3.10 RemoveWaiters ( waiterList, count )
The abstract operation RemoveWaiters takes arguments waiterList (a
25.4.3.11 SuspendThisAgent ( waiterList, waiterRecord )
The abstract operation SuspendThisAgent takes arguments waiterList (a
- 断言：surrounding
agent 位于 waiterList 的临界区 中。 - 断言：waiterList.[[Waiters]]
包含 waiterRecord。 - 令 thisAgent 为
AgentSignifier ()。 - 断言：waiterRecord.[[AgentSignifier]] 是 thisAgent。
- 断言：waiterRecord.[[PromiseCapability]] 是
blocking 。 - 断言：
AgentCanSuspend () 是true 。 - 执行
LeaveCriticalSection (waiterList) 并挂起 surroundingagent ，直到时间为 waiterRecord.[[TimeoutTime]]，以一种组合操作的方式执行，使得在退出临界区 之后但在挂起生效之前到达的通知不会丢失。surroundingagent 只能因超时或因另一个agent 以 waiterList 和 thisAgent 为实参调用NotifyWaiter （即通过调用Atomics.notify）而从挂起中唤醒。 - 执行
EnterCriticalSection (waiterList)。 - 返回
unused 。
25.4.3.12 NotifyWaiter ( waiterList, waiterRecord )
The abstract operation NotifyWaiter takes arguments waiterList (a
- 断言：surrounding
agent 位于 waiterList 的临界区 中。 - 如果 waiterRecord.[[PromiseCapability]] 是
blocking ，则- 将 signifier 为 waiterRecord.[[AgentSignifier]] 的
agent 从挂起中唤醒。 - 注：这会使
agent 在SuspendThisAgent 中恢复执行。
- 将 signifier 为 waiterRecord.[[AgentSignifier]] 的
- 否则，如果
AgentSignifier () 是 waiterRecord.[[AgentSignifier]]，则- 令 promiseCapability 为 waiterRecord.[[PromiseCapability]]。
- 执行 !
Call (promiseCapability.[[Resolve]],undefined , « waiterRecord.[[Result]] »)。
- 否则，
- 执行
EnqueueResolveInAgentJob (waiterRecord.[[AgentSignifier]], waiterRecord.[[PromiseCapability]], waiterRecord.[[Result]])。
- 执行
- 返回
unused 。
25.4.3.13 EnqueueResolveInAgentJob ( agentSignifier, promiseCapability, resolution )
The abstract operation EnqueueResolveInAgentJob takes arguments agentSignifier (an
- 令 resolveJob 为一个新的无参数
Job Abstract Closure ，它捕获 agentSignifier、promiseCapability 和 resolution，并在被调用时执行以下步骤：- 断言：
AgentSignifier () 是 agentSignifier。 - 执行 !
Call (promiseCapability.[[Resolve]],undefined , « resolution »)。 - 返回
unused 。
- 断言：
- 令 realmInTargetAgent 为 !
GetFunctionRealm (promiseCapability.[[Resolve]])。 - 断言：agentSignifier 是 realmInTargetAgent.[[AgentSignifier]]。
- 执行
HostEnqueueGenericJob (resolveJob, realmInTargetAgent)。 - 返回
unused 。
25.4.3.14 DoWait ( mode, ta, index, value, timeout )
The abstract operation DoWait takes arguments mode (
- 令 taRecord 为 ?
ValidateIntegerTypedArray (ta,true )。 - 令 buffer 为 taRecord.[[Object]].[[ViewedArrayBuffer]]。
- 如果
IsSharedArrayBuffer (buffer) 是false ，则抛出TypeError 异常。 - 令 byteIndexInBuffer 为 ?
ValidateAtomicAccess (taRecord, index)。 - 令 arrayTypeName 为 ta.[[TypedArrayName]]。
- 如果 arrayTypeName 是
"BigInt64Array" ，则令 expected 为 ?ToBigInt64 (value)。 - 否则，令 expected 为 ?
ToInt32 (value)。 - 令 timeoutNumber 为 ?
ToNumber (timeout)。 - 如果 timeoutNumber 是
NaN 或+∞ 𝔽，则令 realTimeout 为 +∞。 - 否则，如果 timeoutNumber 是
-∞ 𝔽，则令 realTimeout 为 0。 - 否则，令 realTimeout 为
max (ℝ (timeoutNumber), 0)。 - 如果 mode 是
sync 且AgentCanSuspend () 是false ，则抛出TypeError 异常。 - 令 block 为 buffer.[[ArrayBufferData]]。
- 令 waiterList 为
GetWaiterList (block, byteIndexInBuffer)。 - 如果 mode 是
sync ，则- 令 promiseCapability 为
blocking 。 - 令 resultObj 为
undefined 。
- 令 promiseCapability 为
- 否则，
- 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 resultObj 为
OrdinaryObjectCreate (%Object.prototype% )。
- 令 promiseCapability 为 !
- 执行
EnterCriticalSection (waiterList)。 - 令 elementType 为
TypedArrayElementType (ta)。 - 令 witness 为
GetValueFromBuffer (buffer, byteIndexInBuffer, elementType,true ,seq-cst )。 - 如果 expected ≠ witness，则
- 执行
LeaveCriticalSection (waiterList)。 - 如果 mode 是
sync ，则返回"not-equal" 。 - 执行 !
CreateDataPropertyOrThrow (resultObj,"async" ,false )。 - 执行 !
CreateDataPropertyOrThrow (resultObj,"value" ,"not-equal" )。 - 返回 resultObj。
- 执行
- 如果 realTimeout = 0 且 mode 是
async ，则- 注：同步的立即超时没有特殊处理。异步的立即超时具有特殊处理，以便快速失败并避免不必要的 Promise job。
- 执行
LeaveCriticalSection (waiterList)。 - 执行 !
CreateDataPropertyOrThrow (resultObj,"async" ,false )。 - 执行 !
CreateDataPropertyOrThrow (resultObj,"value" ,"timed-out" )。 - 返回 resultObj。
- 令 thisAgent 为
AgentSignifier ()。 - 令 now 为标识当前时间的
时间值 （UTC）。 - 令 additionalTimeout 为
实现定义的 非负数学值 。 - 令 timeoutTime 为
ℝ (now) + realTimeout + additionalTimeout。 - 注：当 realTimeout 是 +∞ 时，timeoutTime 也是 +∞。
- 令 waiterRecord 为新的
Waiter Record { [[AgentSignifier]]: thisAgent, [[PromiseCapability]]: promiseCapability, [[TimeoutTime]]: timeoutTime, [[Result]]:"ok" }。 - 执行
AddWaiter (waiterList, waiterRecord)。 - 如果 mode 是
sync ，则- 执行
SuspendThisAgent (waiterList, waiterRecord)。
- 执行
- 否则，如果 timeoutTime 是
有限 的，则- 执行
EnqueueAtomicsWaitAsyncTimeoutJob (waiterList, waiterRecord)。
- 执行
- 执行
LeaveCriticalSection (waiterList)。 - 如果 mode 是
sync ，则返回 waiterRecord.[[Result]]。 - 执行 !
CreateDataPropertyOrThrow (resultObj,"async" ,true )。 - 执行 !
CreateDataPropertyOrThrow (resultObj,"value" , promiseCapability.[[Promise]])。 - 返回 resultObj。
additionalTimeout 允许实现根据需要填充超时，例如为了降低功耗或粗化计时器分辨率以缓解定时攻击。此值在不同 DoWait 调用之间可以不同。
25.4.3.15 EnqueueAtomicsWaitAsyncTimeoutJob ( waiterList, waiterRecord )
The abstract operation EnqueueAtomicsWaitAsyncTimeoutJob takes arguments waiterList (a
- 令 timeoutJob 为一个新的无参数
Job Abstract Closure ，它捕获 waiterList 和 waiterRecord，并在被调用时执行以下步骤：- 执行
EnterCriticalSection (waiterList)。 - 如果 waiterList.[[Waiters]]
包含 waiterRecord，则- 令 timeOfJobExecution 为标识当前时间的
时间值 （UTC）。 - 断言：
ℝ (timeOfJobExecution) ≥ waiterRecord.[[TimeoutTime]]（忽略时间值 的潜在非单调性）。 - 将 waiterRecord.[[Result]] 设置为
"timed-out" 。 - 执行
RemoveWaiter (waiterList, waiterRecord)。 - 执行
NotifyWaiter (waiterList, waiterRecord)。
- 令 timeOfJobExecution 为标识当前时间的
- 执行
LeaveCriticalSection (waiterList)。 - 返回
unused 。
- 执行
- 令 now 为标识当前时间的
时间值 （UTC）。 - 令 currentRealm 为
当前 Realm Record 。 - 执行
HostEnqueueTimeoutJob (timeoutJob, currentRealm,𝔽 (waiterRecord.[[TimeoutTime]]) - now)。 - 返回
unused 。
25.4.3.16 AtomicCompareExchangeInSharedBlock ( block, byteIndexInBuffer, elementSize, expectedBytes, replacementBytes )
The abstract operation AtomicCompareExchangeInSharedBlock takes arguments block (a
- 令 agentRecord 为 surrounding
agent 的Agent Record 。 - 令 execution 为 agentRecord.[[CandidateExecution]]。
- 令 eventsRecord 为 execution.[[EventsRecords]] 中 [[AgentSignifier]] 为
AgentSignifier () 的Agent Events Record 。 - 令 rawBytesRead 为长度为 elementSize 的
List ，其元素为非确定性选择的字节值 。 - 注：在实现中，rawBytesRead 是底层硬件上的 load-link、load-exclusive，或读-改-写指令的一个操作数的结果。非确定性是
内存模型 的一项语义规定，用于描述弱一致性硬件的可观察行为。 - 注：期望值与读取值的比较在
读-改-写修改函数 之外执行，以避免在期望值不等于读取值时产生不必要的强同步。 - 如果
ByteListEqual (rawBytesRead, expectedBytes) 是true ，则- 令 second 为一个新的
读-改-写修改函数 ，其参数为 (oldBytes, newBytes)，不捕获任何内容，并在被调用时以原子方式执行以下步骤：- 返回 newBytes。
- 令 event 为
ReadModifyWriteSharedMemory { [[Order]]:seq-cst , [[NoTear]]:true , [[Block]]: block, [[ByteIndex]]: byteIndexInBuffer, [[ElementSize]]: elementSize, [[Payload]]: replacementBytes, [[ModifyOp]]: second }。
- 令 second 为一个新的
- 否则，
- 令 event 为
ReadSharedMemory { [[Order]]:seq-cst , [[NoTear]]:true , [[Block]]: block, [[ByteIndex]]: byteIndexInBuffer, [[ElementSize]]: elementSize }。
- 令 event 为
- 将 event 追加到 eventsRecord.[[EventList]]。
- 将
Chosen Value Record { [[Event]]: event, [[ChosenValue]]: rawBytesRead } 追加到 execution.[[ChosenValues]]。 - 返回 rawBytesRead。
25.4.3.17 AtomicReadModifyWrite ( ta, index, value, op )
The abstract operation AtomicReadModifyWrite takes arguments ta (an ECMAScript language value), index (an ECMAScript language value), value (an ECMAScript language value), and op (a read-modify-write modification function) and returns either a normal completion containing either a Number or a BigInt, or a throw completion. op 接受两个
- 令 byteIndexInBuffer 为 ?
ValidateAtomicAccessOnIntegerTypedArray (ta, index)。 - 如果 ta.[[ContentType]] 是
bigint ，则令 coerced 为 ?ToBigInt (value)。 - 否则，令 coerced 为
𝔽 (?ToIntegerOrInfinity (value))。 - 执行 ?
RevalidateAtomicAccess (ta, byteIndexInBuffer)。 - 令 buffer 为 ta.[[ViewedArrayBuffer]]。
- 令 elementType 为
TypedArrayElementType (ta)。 - 返回
GetModifySetValueInBuffer (buffer, byteIndexInBuffer, elementType, coerced, op)。
25.4.3.18 ByteListBitwiseOp ( op, xBytes, yBytes )
The abstract operation ByteListBitwiseOp takes arguments op (&, ^, or |), xBytes (a
- 断言：xBytes 和 yBytes 具有相同数量的元素。
- 令 result 为新的空
List 。 - 令 i 为 0。
- 对 xBytes 的每个元素 xByte，执行：
- 令 yByte 为 yBytes[i]。
- 如果 op 是
&，则- 令 resultByte 为对 xByte 和 yByte 应用按位 AND 操作的结果。
- 否则，如果 op 是
^，则- 令 resultByte 为对 xByte 和 yByte 应用按位异或（XOR）操作的结果。
- 否则，
- 断言：op 是
|。 - 令 resultByte 为对 xByte 和 yByte 应用按位
包含 OR 操作的结果。
- 断言：op 是
- 将 i 设置为 i + 1。
- 将 resultByte 追加到 result。
- 返回 result。
25.4.3.19 ByteListEqual ( xBytes, yBytes )
The abstract operation ByteListEqual takes arguments xBytes (a
- 如果 xBytes 和 yBytes 没有相同数量的元素，则返回
false 。 - 令 i 为 0。
- 对 xBytes 的每个元素 xByte，执行：
- 令 yByte 为 yBytes[i]。
- 如果 xByte ≠ yByte，则返回
false 。 - 将 i 设置为 i + 1。
- 返回
true 。
25.4.4 Atomics.add ( ta, index, value )
此函数在被调用时执行以下步骤：
- 令 add 为一个新的
读-改-写修改函数 ，其参数为 (xBytes, yBytes)，捕获 ta，并在被调用时以原子方式执行以下步骤：- 令 type 为
TypedArrayElementType (ta)。 - 令 agentRecord 为 surrounding
agent 的Agent Record 。 - 令 isLittleEndian 为 agentRecord.[[LittleEndian]]。
- 令 x 为
RawBytesToNumeric (type, xBytes, isLittleEndian)。 - 令 y 为
RawBytesToNumeric (type, yBytes, isLittleEndian)。 - 如果 x 是 Number，则
- 令 sum 为
Number::add (x, y)。
- 令 sum 为
- 否则，
- 断言：x 是 BigInt。
- 令 sum 为
BigInt::add (x, y)。
- 令 sumBytes 为
NumericToRawBytes (type, sum, isLittleEndian)。 - 断言：sumBytes、xBytes 和 yBytes 具有相同数量的元素。
- 返回 sumBytes。
- 令 type 为
- 返回 ?
AtomicReadModifyWrite (ta, index, value, add)。
25.4.5 Atomics.and ( ta, index, value )
此函数在被调用时执行以下步骤：
- 令 and 为一个新的
读-改-写修改函数 ，其参数为 (xBytes, yBytes)，不捕获任何内容，并在被调用时以原子方式执行以下步骤：- 返回
ByteListBitwiseOp (&, xBytes, yBytes)。
- 返回
- 返回 ?
AtomicReadModifyWrite (ta, index, value, and)。
25.4.6 Atomics.compareExchange ( ta, index, expectedValue, replacementValue )
此函数在被调用时执行以下步骤：
- 令 byteIndexInBuffer 为 ?
ValidateAtomicAccessOnIntegerTypedArray (ta, index)。 - 令 buffer 为 ta.[[ViewedArrayBuffer]]。
- 令 block 为 buffer.[[ArrayBufferData]]。
- 如果 ta.[[ContentType]] 是
bigint ，则 - 否则，
- 令 expected 为
𝔽 (?ToIntegerOrInfinity (expectedValue))。 - 令 replacement 为
𝔽 (?ToIntegerOrInfinity (replacementValue))。
- 令 expected 为
- 执行 ?
RevalidateAtomicAccess (ta, byteIndexInBuffer)。 - 令 elementType 为
TypedArrayElementType (ta)。 - 令 elementSize 为
TypedArrayElementSize (ta)。 - 令 agentRecord 为 surrounding
agent 的Agent Record 。 - 令 isLittleEndian 为 agentRecord.[[LittleEndian]]。
- 令 expectedBytes 为
NumericToRawBytes (elementType, expected, isLittleEndian)。 - 令 replacementBytes 为
NumericToRawBytes (elementType, replacement, isLittleEndian)。 - 如果
IsSharedArrayBuffer (buffer) 是true ，则- 令 rawBytesRead 为
AtomicCompareExchangeInSharedBlock (block, byteIndexInBuffer, elementSize, expectedBytes, replacementBytes)。
- 令 rawBytesRead 为
- 否则，
- 令 rawBytesRead 为长度为 elementSize 的
List ，其元素是从 block[byteIndexInBuffer] 开始的 elementSize 个字节序列。 - 如果
ByteListEqual (rawBytesRead, expectedBytes) 是true ，则- 将 replacementBytes 的各个字节存储到 block 中，从 block[byteIndexInBuffer] 开始。
- 令 rawBytesRead 为长度为 elementSize 的
- 返回
RawBytesToNumeric (elementType, rawBytesRead, isLittleEndian)。
25.4.7 Atomics.exchange ( ta, index, value )
此函数在被调用时执行以下步骤：
- 令 second 为一个新的
读-改-写修改函数 ，其参数为 (oldBytes, newBytes)，不捕获任何内容，并在被调用时以原子方式执行以下步骤：- 返回 newBytes。
- 返回 ?
AtomicReadModifyWrite (ta, index, value, second)。
25.4.8 Atomics.isLockFree ( size )
此函数在被调用时执行以下步骤：
- 令 n 为 ?
ToIntegerOrInfinity (size)。 - 令 agentRecord 为 surrounding
agent 的Agent Record 。 - 如果 n = 1，则返回 agentRecord.[[IsLockFree1]]。
- 如果 n = 2，则返回 agentRecord.[[IsLockFree2]]。
- 如果 n = 4，则返回
true 。 - 如果 n = 8，则返回 agentRecord.[[IsLockFree8]]。
- 返回
false 。
此函数是一种优化原语。直觉是，如果原子原语（compareExchange、load、store、add、sub、and、or、xor 或 exchange）在大小为 n 字节的数据上的原子步骤，会在 surrounding Atomics.isLockFree(n) 将返回
Atomics.isLockFree(4) 总是返回
无论此函数返回的值如何，所有原子操作都保证是原子的。例如，它们绝不会有可见操作发生在该操作中间（例如，“tearing”）。
25.4.9 Atomics.load ( ta, index )
此函数在被调用时执行以下步骤：
- 令 byteIndexInBuffer 为 ?
ValidateAtomicAccessOnIntegerTypedArray (ta, index)。 - 执行 ?
RevalidateAtomicAccess (ta, byteIndexInBuffer)。 - 令 buffer 为 ta.[[ViewedArrayBuffer]]。
- 令 elementType 为
TypedArrayElementType (ta)。 - 返回
GetValueFromBuffer (buffer, byteIndexInBuffer, elementType,true ,seq-cst )。
25.4.10 Atomics.notify ( ta, index, count )
此函数会通知一些正在等待队列中休眠的代理。
调用时，它执行以下步骤：
- 令 taRecord 为 ?
ValidateIntegerTypedArray (ta,true )。 - 令 byteIndexInBuffer 为 ?
ValidateAtomicAccess (taRecord, index)。 - 如果 count 是
undefined ，则- 将 count 设置为 +∞。
- 否则，
- 令 intCount 为 ?
ToIntegerOrInfinity (count)。 - 将 count 设置为
max (intCount, 0)。
- 令 intCount 为 ?
- 令 buffer 为 ta.[[ViewedArrayBuffer]]。
- 令 block 为 buffer.[[ArrayBufferData]]。
- 如果
IsSharedArrayBuffer (buffer) 为false ，则返回+0 𝔽。 - 令 waiterList 为
GetWaiterList (block, byteIndexInBuffer)。 - 执行
EnterCriticalSection (waiterList)。 - 令 waiters 为
RemoveWaiters (waiterList, count)。 - 对 waiters 的每个元素 waiterRecord，执行
- 执行
NotifyWaiter (waiterList, waiterRecord)。
- 执行
- 执行
LeaveCriticalSection (waiterList)。 - 令 waitersCount 为 waiters 中元素的数量。
- 返回
𝔽 (waitersCount)。
25.4.11 Atomics.or ( ta, index, value )
此函数在调用时执行以下步骤：
- 令 or 为一个新的读-修改-写修改函数，它具有参数 (xBytes, yBytes)，不捕获任何内容，并在被调用时原子地执行以下步骤：
- 返回
ByteListBitwiseOp (|, xBytes, yBytes)。
- 返回
- 返回 ?
AtomicReadModifyWrite (ta, index, value, or)。
25.4.12 Atomics.pause ( )
此函数向 CPU 提供一个提示，表明程序正在等待某个值时进行自旋循环。
调用时，它执行以下步骤：
- 如果 ECMAScript 实现的执行环境支持向操作系统或 CPU 发出当前正在执行的代码处于自旋等待循环中的信号，则发送该信号。
- 返回
undefined 。
此方法是为实现自旋等待循环的程序设计的，例如互斥锁内部的自旋锁快速路径，用于向 CPU 提供一个提示，表明它正在等待某个值时自旋。除计时外，它没有可观察的行为。
如果底层架构的最佳实践建议在自旋循环中使用 pause 或 yield 指令，则期望实现实现这样的指令。例如，Intel 优化手册建议使用 pause 指令。
鼓励实现对暂停的最长时间设置内部上限，其量级为数十到数百纳秒。
由于函数调用的开销，在优化编译器中对此方法的内联调用等待的时间与非内联调用不同，是合理的。
25.4.13 Atomics.store ( ta, index, value )
此函数在调用时执行以下步骤：
- 令 byteIndexInBuffer 为 ?
ValidateAtomicAccessOnIntegerTypedArray (ta, index)。 - 如果 ta.[[ContentType]] 是
bigint ，则令 coerced 为 ?ToBigInt (value)。 - 否则，令 coerced 为
𝔽 (?ToIntegerOrInfinity (value))。 - 执行 ?
RevalidateAtomicAccess (ta, byteIndexInBuffer)。 - 令 buffer 为 ta.[[ViewedArrayBuffer]]。
- 令 elementType 为
TypedArrayElementType (ta)。 - 执行
SetValueInBuffer (buffer, byteIndexInBuffer, elementType, coerced,true ,seq-cst )。 - 返回 coerced。
25.4.14 Atomics.sub ( ta, index, value )
此函数在调用时执行以下步骤：
- 令 subtract 为一个新的读-修改-写修改函数，它具有参数 (xBytes, yBytes)，捕获 ta，并在被调用时原子地执行以下步骤：
- 令 type 为
TypedArrayElementType (ta)。 - 令 agentRecord 为周围代理的代理记录。
- 令 isLittleEndian 为 agentRecord.[[LittleEndian]]。
- 令 x 为
RawBytesToNumeric (type, xBytes, isLittleEndian)。 - 令 y 为
RawBytesToNumeric (type, yBytes, isLittleEndian)。 - 如果 x 是一个 Number，则
- 令 difference 为
Number::subtract (x, y)。
- 令 difference 为
- 否则，
- 断言：x 是一个 BigInt。
- 令 difference 为
BigInt::subtract (x, y)。
- 令 differenceBytes 为
NumericToRawBytes (type, difference, isLittleEndian)。 - 断言：differenceBytes、xBytes 和 yBytes 具有相同数量的元素。
- 返回 differenceBytes。
- 令 type 为
- 返回 ?
AtomicReadModifyWrite (ta, index, value, subtract)。
25.4.15 Atomics.wait ( ta, index, value, timeout )
此函数将周围代理放入等待队列并将其挂起，直到收到通知或等待超时为止，返回一个用于区分这些情况的字符串。
调用时，它执行以下步骤：
- 返回 ?
DoWait (sync , ta, index, value, timeout)。
25.4.16 Atomics.waitAsync ( ta, index, value, timeout )
此函数返回一个 Promise，该 Promise 会在调用代理收到通知或达到超时时解析。
调用时，它执行以下步骤：
- 返回 ?
DoWait (async , ta, index, value, timeout)。
25.4.17 Atomics.xor ( ta, index, value )
此函数在调用时执行以下步骤：
- 令 xor 为一个新的读-修改-写修改函数，它具有参数 (xBytes, yBytes)，不捕获任何内容，并在被调用时原子地执行以下步骤：
- 返回
ByteListBitwiseOp (^, xBytes, yBytes)。
- 返回
- 返回 ?
AtomicReadModifyWrite (ta, index, value, xor)。
25.4.18 Atomics [ %Symbol.toStringTag% ]
此属性具有属性特性 { [[Writable]]:
25.5 JSON 对象
JSON 对象：
- 是 %JSON%。
- 是
全局对象 的"JSON" 属性的初始值。 - 是
普通对象 。 包含 两个函数parse和stringify，用于解析和构造 JSON 文本。- 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 没有 [[Construct]] 内部方法；它不能作为构造器与
new操作符一起使用。 - 没有 [[Call]] 内部方法；它不能作为函数调用。
JSON 数据交换格式定义于 ECMA-404。本规范中使用的 JSON 交换格式正是 ECMA-404 所描述的格式。JSON.parse 和 JSON.stringify 的符合实现必须支持 ECMA-404 规范中描述的确切交换格式，不得对该格式进行任何删除或扩展。
25.5.1 JSON.isRawJSON ( obj )
此函数在被调用时执行以下步骤：
- 如果 obj 是 Object 且 obj 具有 [[IsRawJSON]] 内部槽，则返回
true 。 - 返回
false 。
25.5.2 JSON.parse ( text [ , reviver ] )
此函数解析 JSON 文本（JSON 格式的 String）并产生
可选的 reviver 参数是一个可以过滤和转换结果的函数。对于解析产生的每个值，都会以三个实参（关联的
- 令 jsonString 为 ?
ToString (text)。 - 令 parseResult 为 ?
ParseJSON (jsonString)。 - 令 unfiltered 为 parseResult.[[Value]]。
- 如果
IsCallable (reviver) 是false ，则返回 unfiltered。 - 令 root 为
OrdinaryObjectCreate (%Object.prototype% )。 - 令 rootName 为空 String。
- 执行 !
CreateDataPropertyOrThrow (root, rootName, unfiltered)。 - 令 snapshot 为
CreateJSONParseRecord (parseResult.[[ParseNode]], rootName, unfiltered)。 - 返回 ?
InternalizeJSONProperty (root, rootName, reviver, snapshot)。
此函数的
25.5.2.1 ParseJSON ( text )
The abstract operation ParseJSON takes argument text (a String) and returns either a normal completion containing a
- 如果
StringToCodePoints (text) 不是 ECMA-404 中指定的有效 JSON 文本，则抛出SyntaxError 异常。 - 令 scriptString 为
"(" 、text 和");" 的字符串连接 。 - 令 script 为
ParseText (scriptString,Script )。 - 注：
13.2.5.1 中定义的早期错误 规则对上述ParseText 调用具有特殊处理。 - 断言：script 是
Parse Node 。 - 令 result 为 ! script 的
Evaluation 。 - 注：
13.2.5.6 中定义的PropertyDefinitionEvaluation 语义对上述求值具有特殊处理。 - 断言：result 是 String、Number、Boolean、由
ArrayLiteral 或ObjectLiteral 定义的 Object，或null 。 - 返回
Record { [[ParseNode]]: script, [[Value]]: result }。
符合实现的 JSON.parse 不允许扩展 JSON 语法。如果实现希望支持修改或扩展的 JSON 交换格式，则必须通过定义不同的解析函数来实现。
有效 JSON 文本是 ECMAScript
不过，由于
在对象中存在重复 name String 的情况下，同一键的词法上在前的值应被覆盖。
25.5.2.2 JSON Parse Record
JSON Parse Record 是一种
JSON Parse Record 具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[ParseNode]] | a |
上下文 |
| [[Key]] | a property name | 与 [[Value]] 关联的 |
| [[Value]] | an ECMAScript language value | 由 [[ParseNode]] 求值产生的值。 |
| [[Elements]] | a |
如果 [[Value]] 是 Array，则它 |
| [[Entries]] | a |
如果 [[Value]] 是非 Array Object，则它 |
25.5.2.3 CreateJSONParseRecord ( parseNode, key, value )
The abstract operation CreateJSONParseRecord takes arguments parseNode (a
- 令 typedValueNode 为
ShallowestContainedJSONValue (parseNode)。 - 断言：typedValueNode 不是
empty 。 - 令 elements 为新的空
List 。 - 令 entries 为新的空
List 。 - 如果 value 是 Object，则
- 令 isArray 为 !
IsArray (value)。 - 如果 isArray 是
true ，则- 断言：typedValueNode 是
ArrayLiteral Parse Node 。 - 令 contentNodes 为 typedValueNode 的
JSONArrayLiteralContentNodes 。 - 令 length 为 contentNodes 中元素的数量。
- 令 valueLength 为 !
LengthOfArrayLike (value)。 - 断言：valueLength 是 length。
- 令 index 为 0。
- 重复，只要 index < length，
- 令 propertyName 为 !
ToString (𝔽 (index))。 - 令 elementParseRecord 为
CreateJSONParseRecord (contentNodes[index], propertyName, !Get (value, propertyName))。 - 将 elementParseRecord 追加到 elements。
- 将 index 设置为 index + 1。
- 令 propertyName 为 !
- 断言：typedValueNode 是
- 否则，
- 断言：typedValueNode 是
ObjectLiteral Parse Node 。 - 令 propertyNodes 为 typedValueNode 的
PropertyDefinitionNodes 。 - 注：因为 value 是从 JSON 文本产生且尚未被修改，所以它的所有
属性键 都是 String，并且会被穷尽枚举。 - 令 keys 为 !
EnumerableOwnProperties (value,key )。 - 对 keys 的每个 String propertyKey，执行：
- 注：当 JSON 文本为单个对象指定多个具有相同名称的 name/value 对（例如
{"a":"lost","a":"kept"}）时，所得 ECMAScript 对象对应属性的值由具有该名称的最后一对指定。 - 令 propertyDefinition 为
empty 。 - 对 propertyNodes 的每个
Parse Node propertyNode，执行：- 令 propertyName 为 propertyNode 的
PropName 。 - 如果 propertyName 是 propertyKey，则将 propertyDefinition 设置为 propertyNode。
- 令 propertyName 为 propertyNode 的
- 断言：propertyDefinition 是
PropertyDefinition : PropertyName : AssignmentExpression - 令 propertyValueNode 为 propertyDefinition 的
AssignmentExpression 。 - 令 entryParseRecord 为
CreateJSONParseRecord (propertyValueNode, propertyKey, !Get (value, propertyKey))。 - 将 entryParseRecord 追加到 entries。
- 注：当 JSON 文本为单个对象指定多个具有相同名称的 name/value 对（例如
- 断言：typedValueNode 是
- 令 isArray 为 !
- 否则，
- 断言：typedValueNode 既不是
ArrayLiteral Parse Node ，也不是ObjectLiteral Parse Node 。
- 断言：typedValueNode 既不是
- 返回
JSON Parse Record { [[ParseNode]]: typedValueNode, [[Key]]: key, [[Value]]: value, [[Elements]]: elements, [[Entries]]: entries }。
25.5.2.4 InternalizeJSONProperty ( holder, name, reviver, parseRecord )
The abstract operation InternalizeJSONProperty takes arguments holder (an Object), name (a String), reviver (a function object), and parseRecord (a
此算法有意在 [[Delete]] 或
它在被调用时执行以下步骤：
- 令 value 为 ?
Get (holder, name)。 - 令 context 为
OrdinaryObjectCreate (%Object.prototype% )。 - 如果 parseRecord 是
JSON Parse Record 且SameValue (parseRecord.[[Value]], value) 是true ，则- 如果 value 不是 Object，则
- 令 parseNode 为 parseRecord.[[ParseNode]]。
- 断言：parseNode 既不是
ArrayLiteral Parse Node ，也不是ObjectLiteral Parse Node 。 - 令 sourceText 为 parseNode
匹配的源文本 。 - 执行 !
CreateDataPropertyOrThrow (context,"source" ,CodePointsToString (sourceText))。
- 令 elementRecords 为 parseRecord.[[Elements]]。
- 令 entryRecords 为 parseRecord.[[Entries]]。
- 如果 value 不是 Object，则
- 否则，
- 如果 value 是 Object，则
- 令 isArray 为 ?
IsArray (value)。 - 如果 isArray 是
true ，则- 令 elementRecordsLength 为 elementRecords 中元素的数量。
- 令 length 为 ?
LengthOfArrayLike (value)。 - 令 index 为 0。
- 重复，只要 index < length，
- 令 propertyKey 为 !
ToString (𝔽 (index))。 - 如果 index < elementRecordsLength，则令 elementRecord 为 elementRecords[index]；否则令 elementRecord 为
empty 。 - 令 newElement 为 ?
InternalizeJSONProperty (value, propertyKey, reviver, elementRecord)。 - 如果 newElement 是
undefined ，则- 执行 ? value.[[Delete]](propertyKey)。
- 否则，
- 执行 ?
CreateDataProperty (value, propertyKey, newElement)。
- 执行 ?
- 将 index 设置为 index + 1。
- 令 propertyKey 为 !
- 否则，
- 令 keys 为 ?
EnumerableOwnProperties (value,key )。 - 对 keys 的每个 String propertyKey，执行：
- 如果存在 entryRecords 的元素 entry 使得 entry.[[Key]] 是 propertyKey，则令 entryRecord 为 entry；否则令 entryRecord 为
empty 。 - 令 newElement 为 ?
InternalizeJSONProperty (value, propertyKey, reviver, entryRecord)。 - 如果 newElement 是
undefined ，则- 执行 ? value.[[Delete]](propertyKey)。
- 否则，
- 执行 ?
CreateDataProperty (value, propertyKey, newElement)。
- 执行 ?
- 如果存在 entryRecords 的元素 entry 使得 entry.[[Key]] 是 propertyKey，则令 entryRecord 为 entry；否则令 entryRecord 为
- 令 keys 为 ?
- 令 isArray 为 ?
- 返回 ?
Call (reviver, holder, « name, value, context »)。
25.5.2.5 Static Semantics: ShallowestContainedJSONValue ( root )
The abstract operation ShallowestContainedJSONValue takes argument root (a
- 令 activeFunc 为
活动函数对象 。 - 断言：activeFunc 是
JSON.parse内置函数对象 （见JSON.parse ）。 - 令 types 为 «
NullLiteral ,BooleanLiteral ,NumericLiteral ,StringLiteral ,ArrayLiteral ,ObjectLiteral ,UnaryExpression »。 - 令 unaryExpr 为
empty 。 - 令 queue 为 « root »。
- 重复，只要 queue 不为空，
- 令 candidate 为 queue 的第一个元素。
- 从 queue 中移除第一个元素。
- 令 queuedChildren 为
false 。 - 对 types 的每个非终结符 type，执行：
- 如果 candidate 是 type 的实例，则
- 注：在 JSON 语法中，
numbertoken 可以表示负值。在 ECMAScript 中，取负表示为一元操作，其中UnaryExpression 解析为-后跟派生的UnaryExpression 。 - 如果 type 是
UnaryExpression ，则- 如果 candidate 的父节点不是
UnaryExpression Parse Node ，则将 unaryExpr 设置为 candidate。
- 如果 candidate 的父节点不是
- 否则，如果 type 是
NumericLiteral ，则- 断言：candidate
包含 在 unaryExpr 中。 - 返回 unaryExpr。
- 断言：candidate
- 否则，
- 返回 candidate。
- 注：在 JSON 语法中，
- 如果 queuedChildren 是
false 、candidate 是非终结符的实例，且 candidateContains type 是true ，则
- 如果 candidate 是 type 的实例，则
- 返回
empty 。
25.5.2.6 Static Semantics: JSONArrayLiteralContentNodes
The syntax-directed operation JSONArrayLiteralContentNodes takes no arguments and returns a
- 断言：
Elision 不存在。 - 如果
ElementList 不存在，则返回新的空List 。 - 返回
ElementList 的JSONArrayLiteralContentNodes 。
- 断言：
Elision 不存在。 - 返回 «
AssignmentExpression »。
- 断言：
Elision 不存在。 - 令 elements 为派生的
ElementList 的JSONArrayLiteralContentNodes 。 - 返回 elements 和 «
AssignmentExpression » 的列表连接 。
- 注：ECMA-404 中指定的 JSON 文本不
包含 SpreadElement 。 - 断言：永远不会到达此步骤。
25.5.3 JSON.rawJSON ( text )
此函数返回一个表示字符串、数字、布尔值或 null 值的原始 JSON 文本的对象。
- 令 jsonString 为 ?
ToString (text)。 - 如果 jsonString 是空 String，则抛出
SyntaxError 异常。 - 如果 jsonString 的第一个码元既不是 ASCII 小写字母码元（0x0061 到 0x007A，
包含 ）、ASCII 数字码元（0x0030 到 0x0039，包含 ）、0x0022（QUOTATION MARK），也不是 0x002D（HYPHEN-MINUS），则抛出SyntaxError 异常。 - 如果 jsonString 的最后一个码元既不是 ASCII 小写字母码元（0x0061 到 0x007A，
包含 ）、ASCII 数字码元（0x0030 到 0x0039，包含 ），也不是 0x0022（QUOTATION MARK），则抛出SyntaxError 异常。 - 令 parseResult 为 ?
ParseJSON (jsonString)。 - 断言：parseResult.[[Value]] 是 String、Number、Boolean 或
null 。 - 令 internalSlotsList 为 « [[IsRawJSON]] »。
- 令 obj 为
OrdinaryObjectCreate (null , internalSlotsList)。 - 执行 !
CreateDataPropertyOrThrow (obj,"rawJSON" , jsonString)。 - 执行 !
SetIntegrityLevel (obj,frozen )。 - 返回 obj。
25.5.4 JSON.stringify ( value [ , replacer [ , space ] ] )
此函数返回一个以 UTF-16 编码 JSON 格式表示
它在被调用时执行以下步骤：
- 令 stack 为新的空
List 。 - 令 indent 为空 String。
- 令 propertyList 为
undefined 。 - 令 replacerFunc 为
undefined 。 - 如果 replacer 是 Object，则
- 如果
IsCallable (replacer) 是true ，则- 将 replacerFunc 设置为 replacer。
- 否则，
- 令 isArray 为 ?
IsArray (replacer)。 - 如果 isArray 是
true ，则- 将 propertyList 设置为新的空
List 。 - 令 length 为 ?
LengthOfArrayLike (replacer)。 - 令 k 为 0。
- 重复，只要 k < length，
- 令 propertyKey 为 !
ToString (𝔽 (k))。 - 令 propertyValue 为 ?
Get (replacer, propertyKey)。 - 令 item 为
undefined 。 - 如果 propertyValue 是 String，则
- 将 item 设置为 propertyValue。
- 否则，如果 propertyValue 是 Number，则
- 将 item 设置为 !
ToString (propertyValue)。
- 将 item 设置为 !
- 否则，如果 propertyValue 是 Object，则
- 如果 propertyValue 具有 [[StringData]] 或 [[NumberData]] 内部槽，则将 item 设置为 ?
ToString (propertyValue)。
- 如果 propertyValue 具有 [[StringData]] 或 [[NumberData]] 内部槽，则将 item 设置为 ?
- 如果 item 不是
undefined 且 propertyList 不包含 item，则- 将 item 追加到 propertyList。
- 将 k 设置为 k + 1。
- 令 propertyKey 为 !
- 将 propertyList 设置为新的空
- 令 isArray 为 ?
- 如果
- 如果 space 是 Object，则
- 如果 space 是 Number，则
- 令 spaceMV 为 !
ToIntegerOrInfinity (space)。 - 将 spaceMV 设置为
min (10, spaceMV)。 - 如果 spaceMV < 1，则令 gap 为空 String；否则令 gap 为
包含 spaceMV 个码元 0x0020（SPACE）的 String 值。
- 令 spaceMV 为 !
- 否则，如果 space 是 String，则
- 如果 space 的长度 ≤ 10，则令 gap 为 space；否则令 gap 为 space 从 0 到 10 的
子字符串 。
- 如果 space 的长度 ≤ 10，则令 gap 为 space；否则令 gap 为 space 从 0 到 10 的
- 否则，
- 令 gap 为空 String。
- 令 wrapper 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 !
CreateDataPropertyOrThrow (wrapper, 空 String, value)。 - 令 state 为
JSON Serialization Record { [[ReplacerFunction]]: replacerFunc, [[Stack]]: stack, [[Indent]]: indent, [[Gap]]: gap, [[PropertyList]]: propertyList }。 - 返回 ?
SerializeJSONProperty (state, 空 String, wrapper)。
此函数的
JSON 结构允许嵌套到任意深度，但它们必须是无环的。如果 value 是或
a = [];
a[0] = a;
my_text = JSON.stringify(a); // 这必须抛出 TypeError。符号性原始值按如下方式渲染：
-
null 值在 JSON 文本中渲染为 String 值"null" 。 -
undefined 值不会被渲染。 -
true 值在 JSON 文本中渲染为 String 值"true" 。 -
false 值在 JSON 文本中渲染为 String 值"false" 。
String 值用 QUOTATION MARK (") 码元包裹。码元 " 和 \ 用 \ 前缀转义。控制字符码元替换为转义序列 \uHHHH，或较短形式 \b（BACKSPACE）、\f（FORM FEED）、\n（LINE FEED）、\r（CARRIAGE RETURN）、\t（CHARACTER TABULATION）。
没有 JSON 表示的值（例如
对象渲染为 U+007B（LEFT CURLY BRACKET），后跟零个或多个属性，这些属性以 U+002C（COMMA）分隔，并以 U+007D（RIGHT CURLY BRACKET）闭合。属性是表示
25.5.4.1 JSON Serialization Record
JSON Serialization Record 是一种
JSON Serialization Record 具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[ReplacerFunction]] | a function object or |
可以为对象属性提供替换值的函数（来自 JSON.stringify 的 replacer 参数）。 |
| [[PropertyList]] | either a |
序列化非数组对象时要 |
| [[Gap]] | a String | 缩进单位（来自 JSON.stringify 的 space 参数）。 |
| [[Stack]] | a |
正在序列化过程中的嵌套对象集合。用于检测循环结构。 |
| [[Indent]] | a String | 当前缩进。 |
25.5.4.2 SerializeJSONProperty ( state, key, holder )
The abstract operation SerializeJSONProperty takes arguments state (a
- 令 value 为 ?
Get (holder, key)。 - 如果 value 是 Object 或 value 是 BigInt，则
- 令 toJSON 为 ?
GetV (value,"toJSON" )。 - 如果
IsCallable (toJSON) 是true ，则- 将 value 设置为 ?
Call (toJSON, value, « key »)。
- 将 value 设置为 ?
- 令 toJSON 为 ?
- 如果 state.[[ReplacerFunction]] 不是
undefined ，则- 将 value 设置为 ?
Call (state.[[ReplacerFunction]], holder, « key, value »)。
- 将 value 设置为 ?
- 如果 value 是 Object，则
- 如果 value 具有 [[IsRawJSON]] 内部槽，则
- 令 rawJSON 为 !
Get (value,"rawJSON" )。 - 断言：rawJSON 是 String。
- 返回 rawJSON。
- 令 rawJSON 为 !
- 如果 value 具有 [[NumberData]] 内部槽，则
- 将 value 设置为 ?
ToNumber (value)。
- 将 value 设置为 ?
- 否则，如果 value 具有 [[StringData]] 内部槽，则
- 将 value 设置为 ?
ToString (value)。
- 将 value 设置为 ?
- 否则，如果 value 具有 [[BooleanData]] 内部槽，则
- 将 value 设置为 value.[[BooleanData]]。
- 否则，如果 value 具有 [[BigIntData]] 内部槽，则
- 将 value 设置为 value.[[BigIntData]]。
- 如果 value 具有 [[IsRawJSON]] 内部槽，则
- 如果 value 是
null ，则返回"null" 。 - 如果 value 是
true ，则返回"true" 。 - 如果 value 是
false ，则返回"false" 。 - 如果 value 是 String，则返回
QuoteJSONString (value)。 - 如果 value 是 Number，则
- 如果 value 是 BigInt，则抛出
TypeError 异常。 - 如果 value 是 Object 且
IsCallable (value) 是false ，则- 令 isArray 为 ?
IsArray (value)。 - 如果 isArray 是
true ，则- 返回 ?
SerializeJSONArray (state, value)。
- 返回 ?
- 返回 ?
SerializeJSONObject (state, value)。
- 令 isArray 为 ?
- 返回
undefined 。
25.5.4.3 QuoteJSONString ( value )
The abstract operation QuoteJSONString takes argument value (a String) and returns a String. 它用 0x0022（QUOTATION MARK）码元包裹 value，并转义其中的某些其他码元。此操作将 value 解释为 UTF-16 编码码点的序列，如
- 令 product 为仅由码元 0x0022（QUOTATION MARK）组成的 String 值。
- 对
StringToCodePoints (value) 的每个码点 codePoint，执行：- 如果 codePoint 列于
Table 78 的 “Code Point” 列中，则- 将 product 设置为 product 与对应行的 “Escape Sequence” 列中为 codePoint 指定的转义序列的
字符串连接 。
- 将 product 设置为 product 与对应行的 “Escape Sequence” 列中为 codePoint 指定的转义序列的
- 否则，如果 codePoint 的数值小于 0x0020（SPACE），或 codePoint 的数值与 leading surrogate 或 trailing surrogate 的数值相同，则
- 令 unit 为数值等于 codePoint 数值的码元。
- 将 product 设置为 product 和
UnicodeEscape (unit) 的字符串连接 。
- 否则，
- 将 product 设置为 product 和
UTF16EncodeCodePoint (codePoint) 的字符串连接 。
- 将 product 设置为 product 和
- 如果 codePoint 列于
- 将 product 设置为 product 和码元 0x0022（QUOTATION MARK）的
字符串连接 。 - 返回 product。
| 码点 | Unicode 字符名称 | 转义序列 |
|---|---|---|
| U+0008 | BACKSPACE |
\b
|
| U+0009 | CHARACTER TABULATION |
\t
|
| U+000A | LINE FEED (LF) |
\n
|
| U+000C | FORM FEED (FF) |
\f
|
| U+000D | CARRIAGE RETURN (CR) |
\r
|
| U+0022 | QUOTATION MARK |
\"
|
| U+005C | REVERSE SOLIDUS |
\\
|
25.5.4.4 UnicodeEscape ( codeUnit )
The abstract operation UnicodeEscape takes argument codeUnit (a code unit) and returns a String. 它将 codeUnit 表示为 Unicode 转义序列。 It performs the following steps when called:
25.5.4.5 SerializeJSONObject ( state, value )
The abstract operation SerializeJSONObject takes arguments state (a
- 如果 state.[[Stack]]
包含 value，则抛出TypeError 异常，因为该结构是循环的。 - 将 value 追加到 state.[[Stack]]。
- 令 stepBack 为 state.[[Indent]]。
- 将 state.[[Indent]] 设置为 state.[[Indent]] 和 state.[[Gap]] 的
字符串连接 。 - 如果 state.[[PropertyList]] 不是
undefined ，则- 令 keys 为 state.[[PropertyList]]。
- 否则，
- 令 keys 为 ?
EnumerableOwnProperties (value,key )。
- 令 keys 为 ?
- 令 partial 为新的空
List 。 - 对 keys 的每个元素 propertyKey，执行：
- 令 stringP 为 ?
SerializeJSONProperty (state, propertyKey, value)。 - 如果 stringP 不是
undefined ，则- 令 member 为
QuoteJSONString (propertyKey)。 - 将 member 设置为 member 和
":" 的字符串连接 。 - 如果 state.[[Gap]] 不是空 String，则
- 将 member 设置为 member 和码元 0x0020（SPACE）的
字符串连接 。
- 将 member 设置为 member 和码元 0x0020（SPACE）的
- 将 member 设置为 member 和 stringP 的
字符串连接 。 - 将 member 追加到 partial。
- 令 member 为
- 令 stringP 为 ?
- 如果 partial 为空，则
- 令 final 为
"{}" 。
- 令 final 为
- 否则，
- 如果 state.[[Gap]] 是空 String，则
- 令 properties 为通过连接 partial 的所有元素 String 形成的 String 值，相邻每对 String 之间以码元 0x002C（COMMA）分隔。逗号既不插入在第一个 String 之前，也不插入在最后一个 String 之后。
- 令 final 为
"{" 、properties 和"}" 的字符串连接 。
- 否则，
- 令 separator 为码元 0x002C（COMMA）、码元 0x000A（LINE FEED）和 state.[[Indent]] 的
字符串连接 。 - 令 properties 为通过连接 partial 的所有元素 String 形成的 String 值，相邻每对 String 之间以 separator 分隔。separator String 既不插入在第一个 String 之前，也不插入在最后一个 String 之后。
- 令 final 为
"{" 、码元 0x000A（LINE FEED）、state.[[Indent]]、properties、码元 0x000A（LINE FEED）、stepBack 和"}" 的字符串连接 。
- 令 separator 为码元 0x002C（COMMA）、码元 0x000A（LINE FEED）和 state.[[Indent]] 的
- 如果 state.[[Gap]] 是空 String，则
- 移除 state.[[Stack]] 的最后一个元素。
- 将 state.[[Indent]] 设置为 stepBack。
- 返回 final。
25.5.4.6 SerializeJSONArray ( state, value )
The abstract operation SerializeJSONArray takes arguments state (a
- 如果 state.[[Stack]]
包含 value，则抛出TypeError 异常，因为该结构是循环的。 - 将 value 追加到 state.[[Stack]]。
- 令 stepBack 为 state.[[Indent]]。
- 将 state.[[Indent]] 设置为 state.[[Indent]] 和 state.[[Gap]] 的
字符串连接 。 - 令 partial 为新的空
List 。 - 令 length 为 ?
LengthOfArrayLike (value)。 - 令 index 为 0。
- 重复，只要 index < length，
- 令 stringP 为 ?
SerializeJSONProperty (state, !ToString (𝔽 (index)), value)。 - 如果 stringP 是
undefined ，则- 将
"null" 追加到 partial。
- 将
- 否则，
- 将 stringP 追加到 partial。
- 将 index 设置为 index + 1。
- 令 stringP 为 ?
- 如果 partial 为空，则
- 令 final 为
"[]" 。
- 令 final 为
- 否则，
- 如果 state.[[Gap]] 是空 String，则
- 令 properties 为通过连接 partial 的所有元素 String 形成的 String 值，相邻每对 String 之间以码元 0x002C（COMMA）分隔。逗号既不插入在第一个 String 之前，也不插入在最后一个 String 之后。
- 令 final 为
"[" 、properties 和"]" 的字符串连接 。
- 否则，
- 令 separator 为码元 0x002C（COMMA）、码元 0x000A（LINE FEED）和 state.[[Indent]] 的
字符串连接 。 - 令 properties 为通过连接 partial 的所有元素 String 形成的 String 值，相邻每对 String 之间以 separator 分隔。separator String 既不插入在第一个 String 之前，也不插入在最后一个 String 之后。
- 令 final 为
"[" 、码元 0x000A（LINE FEED）、state.[[Indent]]、properties、码元 0x000A（LINE FEED）、stepBack 和"]" 的字符串连接 。
- 令 separator 为码元 0x002C（COMMA）、码元 0x000A（LINE FEED）和 state.[[Indent]] 的
- 如果 state.[[Gap]] 是空 String，则
- 移除 state.[[Stack]] 的最后一个元素。
- 将 state.[[Indent]] 设置为 stepBack。
- 返回 final。
25.5.5 JSON [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
26 内存管理
26.1 WeakRef 对象
26.1.1 WeakRef 构造器
WeakRef 构造器：
- 是 %WeakRef%。
-
是
全局对象 的"WeakRef" 属性的初始值。 - 在作为构造器调用时创建并初始化一个新的 WeakRef。
- 不意图作为函数调用，并且以这种方式调用时会抛出异常。
-
可以用作类定义的
extends子句中的值。打算继承指定WeakRef行为的子类构造函数 ，必须包含 一次对WeakRef构造函数 的super调用，以创建并初始化子类实例，使其具备支持WeakRef.prototype的内置方法所必需的内部状态。
26.1.1.1 WeakRef ( target )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 是
undefined ，则抛出TypeError 异常。 - 如果
CanBeHeldWeakly (target) 是false ，则抛出TypeError 异常。 - 令 weakRef 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%WeakRef.prototype%" , « [[WeakRefTarget]] »)。 - 执行
AddToKeptObjects (target)。 - 将 weakRef.[[WeakRefTarget]] 设置为 target。
- 返回 weakRef。
26.1.2 WeakRef 构造器的属性
-
具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
26.1.2.1 WeakRef.prototype
WeakRef.prototype 的初始值是
此属性具有特性 { [[Writable]]:
26.1.3 WeakRef 原型对象的属性
WeakRef 原型对象：
- 是 %WeakRef.prototype%。
-
具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是
普通对象 。 - 没有 [[WeakRefTarget]] 内部槽。
26.1.3.1 WeakRef.prototype.constructor
WeakRef.prototype.constructor 的初始值是
26.1.3.2 WeakRef.prototype.deref ( )
此方法在被调用时执行以下步骤：
- 令 weakRef 为
this 值。 - 执行 ?
RequireInternalSlot (weakRef, [[WeakRefTarget]])。 - 返回
WeakRefDeref (weakRef)。
如果
let target = { foo() {} };
let weakRef = new WeakRef(target);
// ... later ...
if (weakRef.deref()) {
weakRef.deref().foo();
}在上面的示例中，如果第一次 deref 求值结果不是
26.1.3.3 WeakRef.prototype [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
26.1.4 WeakRef 抽象操作
26.1.4.1 WeakRefDeref ( weakRef )
The abstract operation WeakRefDeref takes argument weakRef (a
- 令 target 为 weakRef.[[WeakRefTarget]]。
- 如果 target 不是
empty ，则- 执行
AddToKeptObjects (target)。 - 返回 target。
- 执行
- 返回
undefined 。
此
26.1.5 WeakRef 实例的属性
26.2 FinalizationRegistry 对象
26.2.1 FinalizationRegistry 构造器
FinalizationRegistry 构造器：
- 是 %FinalizationRegistry%。
-
是
全局对象 的"FinalizationRegistry" 属性的初始值。 - 在作为构造器调用时创建并初始化一个新的 FinalizationRegistry。
- 不意图作为函数调用，并且以这种方式调用时会抛出异常。
-
可以用作类定义的
extends子句中的值。打算继承指定FinalizationRegistry行为的子类构造函数 ，必须包含 一次对FinalizationRegistry构造函数 的super调用，以创建并初始化子类实例，使其具备支持FinalizationRegistry.prototype的内置方法所必需的内部状态。
26.2.1.1 FinalizationRegistry ( cleanupCallback )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 为
undefined ，则抛出一个TypeError 异常。 - 如果
IsCallable (cleanupCallback) 为false ，则抛出一个TypeError 异常。 - 令 finalizationRegistry 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%FinalizationRegistry.prototype%" , « [[Realm]], [[CleanupCallback]], [[Cells]] »)。 - 令 activeFunc 为
活动函数对象 。 - 将 finalizationRegistry.[[Realm]] 设为 activeFunc.[[Realm]]。
- 将 finalizationRegistry.[[CleanupCallback]] 设为
HostMakeJobCallback (cleanupCallback)。 - 将 finalizationRegistry.[[Cells]] 设为一个新的空
List 。 - 返回 finalizationRegistry。
26.2.2 FinalizationRegistry 构造器的属性
-
具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
26.2.2.1 FinalizationRegistry.prototype
FinalizationRegistry.prototype 的初始值是
此属性具有特性 { [[Writable]]:
26.2.3 FinalizationRegistry 原型对象的属性
FinalizationRegistry 原型对象：
- 是 %FinalizationRegistry.prototype%。
-
具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是
普通对象 。 - 没有 [[Cells]] 和 [[CleanupCallback]] 内部槽。
26.2.3.1 FinalizationRegistry.prototype.constructor
FinalizationRegistry.prototype.constructor 的初始值是
26.2.3.2 FinalizationRegistry.prototype.register ( target, heldValue [ , unregisterToken ] )
此方法在被调用时执行以下步骤：
- 令 finalizationRegistry 为
this 值。 - 执行 ?
RequireInternalSlot (finalizationRegistry, [[Cells]])。 - 如果
CanBeHeldWeakly (target) 是false ，则抛出TypeError 异常。 - 如果
SameValue (target, heldValue) 是true ，则抛出TypeError 异常。 - 如果
CanBeHeldWeakly (unregisterToken) 是false ，则- 如果 unregisterToken 不是
undefined ，则抛出TypeError 异常。 - 将 unregisterToken 设置为
empty 。
- 如果 unregisterToken 不是
- 令 cell 为
Record { [[WeakRefTarget]]: target, [[HeldValue]]: heldValue, [[UnregisterToken]]: unregisterToken }。 - 将 cell 追加到 finalizationRegistry.[[Cells]]。
- 返回
undefined 。
根据本规范中的算法和定义，当 finalizationRegistry.[[Cells]]
26.2.3.3 FinalizationRegistry.prototype.unregister ( unregisterToken )
此方法在被调用时执行以下步骤：
- 令 finalizationRegistry 为
this 值。 - 执行 ?
RequireInternalSlot (finalizationRegistry, [[Cells]])。 - 如果
CanBeHeldWeakly (unregisterToken) 是false ，则抛出TypeError 异常。 - 令 removed 为
false 。 - 对 finalizationRegistry.[[Cells]] 的每个
Record { [[WeakRefTarget]], [[HeldValue]], [[UnregisterToken]] } cell，执行：- 如果 cell.[[UnregisterToken]] 不是
empty 且SameValue (cell.[[UnregisterToken]], unregisterToken) 是true ，则- 从 finalizationRegistry.[[Cells]] 中移除 cell。
- 将 removed 设置为
true 。
- 如果 cell.[[UnregisterToken]] 不是
- 返回 removed。
26.2.3.4 FinalizationRegistry.prototype [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
26.2.4 FinalizationRegistry 实例的属性
27 控制抽象对象
27.1 迭代
27.1.1 通用迭代接口
接口是一组
27.1.1.1 Iterable 接口
iterable 接口
| 属性 | 值 | 要求 |
|---|---|---|
%Symbol.iterator%
|
返回 |
返回的对象必须符合 |
27.1.1.2 Iterator 接口
实现 iterator 接口的对象必须
| 属性 | 值 | 要求 |
|---|---|---|
|
|
返回 IteratorResult 对象的函数 |
返回的对象必须符合 next 方法的调用已返回一个 next 方法的所有调用也应返回一个 |
可以向 next 函数传递实参，但其解释和有效性取决于目标 iterator。for-of 语句和其他 iterator 的常见使用者不会传递任何实参，因此预期以这种方式使用的 iterator 对象必须准备好处理无实参调用的情况。
| 属性 | 值 | 要求 |
|---|---|---|
|
|
返回 IteratorResult 对象的函数 |
返回的对象必须符合 next 方法调用。返回的 IteratorResult 对象通常会有一个值为 return 方法的实参。不过，此要求不会被强制执行。
|
|
|
返回 IteratorResult 对象的函数 |
返回的对象必须符合 throw 作为实参传入的值。如果该方法没有 throw，则返回的 IteratorResult 对象通常会有一个值为 |
通常，这些方法的调用者应在调用前检查其是否存在。某些 ECMAScript 语言特性，包括 for-of、yield* 和数组解构，会在执行存在性检查后调用这些方法。大多数接受
27.1.1.3 Async Iterable 接口
async iterable 接口
| 属性 | 值 | 要求 |
|---|---|---|
%Symbol.asyncIterator% |
返回 |
返回的对象必须符合 |
27.1.1.4 Async Iterator 接口
实现 async iterator 接口的对象必须
| 属性 | 值 | 要求 |
|---|---|---|
| 返回 IteratorResult 对象 promise 的函数 |
返回的 promise 在被兑现时，必须以符合 此外，作为兑现值的 IteratorResult 对象应具有一个 |
可以向 next 函数传递实参，但其解释和有效性取决于目标 async iterator。for-await-of 语句和其他 async iterator 的常见使用者不会传递任何实参，因此预期以这种方式使用的 async iterator 对象必须准备好处理无实参调用的情况。
| 属性 | 值 | 要求 |
|---|---|---|
| 返回 IteratorResult 对象 promise 的函数 |
返回的 promise 在被兑现时，必须以符合 此外，作为兑现值的 IteratorResult 对象应具有一个 |
|
| 返回 IteratorResult 对象 promise 的函数 |
返回的 promise 在被兑现时，必须以符合 如果返回的 promise 被兑现，则 IteratorResult 对象兑现值通常会有一个值为 |
通常，这些方法的调用者应在调用前检查其是否存在。某些 ECMAScript 语言特性，包括 for-await-of 和 yield*，会在执行存在性检查后调用这些方法。
27.1.1.5 IteratorResult 接口
IteratorResult 接口
| 属性 | 值 | 要求 |
|---|---|---|
|
|
Boolean |
这是 next 方法调用的结果状态。如果已到达 |
|
|
|
如果 done 是 |
27.1.2 Iterator Helper 对象
Iterator Helper 对象是一种
27.1.2.1 %IteratorHelperPrototype% 对象
%IteratorHelperPrototype% 对象：
- 具有由所有
Iterator Helper 对象 继承的属性。 - 是
普通对象 。 - 具有一个 [[Prototype]] 内部槽，其值为
%Iterator.prototype% 。 - 具有以下属性：
27.1.2.1.1 %IteratorHelperPrototype%.next ( )
- 返回 ?
GeneratorResume (this 值,undefined ,"Iterator Helper" )。
27.1.2.1.2 %IteratorHelperPrototype%.return ( )
- 令 obj 为
this 值。 - 执行 ?
RequireInternalSlot (obj, [[UnderlyingIterators]])。 - 断言：obj 具有 [[GeneratorState]] 内部槽。
- 如果 obj.[[GeneratorState]] 是
suspended-start ，则- 将 obj.[[GeneratorState]] 设置为
completed 。 - 注：一旦 generator 进入 completed 状态，它就永远不会离开该状态，其关联执行上下文也永远不会恢复。此时可以丢弃与 obj 关联的任何执行状态。
- 执行 ?
IteratorCloseAll (obj.[[UnderlyingIterators]],NormalCompletion (unused ))。 - 返回
CreateIteratorResultObject (undefined ,true )。
- 将 obj.[[GeneratorState]] 设置为
- 令 completion 为
ReturnCompletion (undefined )。 - 返回 ?
GeneratorResumeAbrupt (obj, completion,"Iterator Helper" )。
27.1.2.1.3 %IteratorHelperPrototype% [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
27.1.3 Iterator 对象
27.1.3.1 Iterator 构造器
Iterator 构造器：
- 是 %Iterator%。
- 是
全局对象 的"Iterator" 属性的初始值。 - 被设计为可子类化。它可以用作类定义的
extends 子句的值。
27.1.3.1.1 Iterator ( )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 是
undefined 或活动函数对象 ，则抛出TypeError 异常。 - 返回 ?
OrdinaryCreateFromConstructor (NewTarget,"%Iterator.prototype%" )。
27.1.3.2 Iterator 构造器的属性
- 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
27.1.3.2.1 Iterator.concat ( ...items )
- 令 iterables 为新的空
List 。 - 对 items 的每个元素 item，执行：
- 如果 item 不是 Object，则抛出
TypeError 异常。 - 令 method 为 ?
GetMethod (item,%Symbol.iterator% )。 - 如果 method 是
undefined ，则抛出TypeError 异常。 - 将
Record { [[OpenMethod]]: method, [[Iterable]]: item } 追加到 iterables。
- 如果 item 不是 Object，则抛出
- 令 closure 为一个新的无参数
Abstract Closure ，它捕获 iterables，并在被调用时执行以下步骤：- 对 iterables 的每个
Record iterable，执行：- 令 iterator 为 ?
Call (iterable.[[OpenMethod]], iterable.[[Iterable]])。 - 如果 iterator 不是 Object，则抛出
TypeError 异常。 - 令 iteratorRecord 为 ?
GetIteratorDirect (iterator)。 - 令 innerAlive 为
true 。 - 重复，只要 innerAlive 是
true ，- 令 innerValue 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 innerValue 是
done ，则- 将 innerAlive 设置为
false 。
- 将 innerAlive 设置为
- 否则，
- 令 completion 为
Completion (Yield (innerValue))。 - 如果 completion 是 abrupt completion，则
- 返回 ?
IteratorClose (iteratorRecord, completion)。
- 返回 ?
- 令 completion 为
- 令 innerValue 为 ?
- 令 iterator 为 ?
- 返回
ReturnCompletion (undefined )。
- 对 iterables 的每个
- 令 gen 为
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterators]] »)。 - 将 gen.[[UnderlyingIterators]] 设置为新的空
List 。 - 返回 gen。
27.1.3.2.2 Iterator.from ( obj )
- 令 iteratorRecord 为 ?
GetIteratorFlattenable (obj,iterate-string-primitives )。 - 令 hasInstance 为 ?
OrdinaryHasInstance (%Iterator% , iteratorRecord.[[Iterator]])。 - 如果 hasInstance 是
true ，则- 返回 iteratorRecord.[[Iterator]]。
- 令 wrapper 为
OrdinaryObjectCreate (%WrapForValidIteratorPrototype% , « [[Iterated]] »)。 - 将 wrapper.[[Iterated]] 设置为 iteratorRecord。
- 返回 wrapper。
27.1.3.2.2.1 %WrapForValidIteratorPrototype% 对象
%WrapForValidIteratorPrototype% 对象：
- 是
普通对象 。 - 具有一个 [[Prototype]] 内部槽，其值为
%Iterator.prototype% 。
27.1.3.2.2.1.1 %WrapForValidIteratorPrototype%.next ( )
- 令 obj 为
this 值。 - 执行 ?
RequireInternalSlot (obj, [[Iterated]])。 - 令 iteratorRecord 为 obj.[[Iterated]]。
- 返回 ?
Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]])。
27.1.3.2.2.1.2 %WrapForValidIteratorPrototype%.return ( )
- 令 obj 为
this 值。 - 执行 ?
RequireInternalSlot (obj, [[Iterated]])。 - 令 iterator 为 obj.[[Iterated]].[[Iterator]]。
- 断言：iterator 是 Object。
- 令 returnMethod 为 ?
GetMethod (iterator,"return" )。 - 如果 returnMethod 是
undefined ，则- 返回
CreateIteratorResultObject (undefined ,true )。
- 返回
- 返回 ?
Call (returnMethod, iterator)。
27.1.3.2.3 Iterator.prototype
Iterator.prototype 的初始值是
此属性具有特性 { [[Writable]]:
27.1.3.2.4 Iterator.zip ( iterables [ , options ] )
此函数在被调用时执行以下步骤：
- 如果 iterables 不是 Object，则抛出
TypeError 异常。 - 将 options 设置为 ?
GetOptionsObject (options)。 - 令 mode 为 ?
Get (options,"mode" )。 - 如果 mode 是
undefined ，则将 mode 设置为"shortest" 。 - 如果 mode 不是
"shortest" 、"longest" 或"strict" 之一，则抛出TypeError 异常。 - 令 paddingOption 为
undefined 。 - 如果 mode 是
"longest" ，则- 将 paddingOption 设置为 ?
Get (options,"padding" )。 - 如果 paddingOption 不是
undefined 且 paddingOption 不是 Object，则抛出TypeError 异常。
- 将 paddingOption 设置为 ?
- 令 iters 为新的空
List 。 - 令 padding 为新的空
List 。 - 令 inputIter 为 ?
GetIterator (iterables,sync )。 - 令 next 为
not-started 。 - 重复，只要 next 不是
done ，- 将 next 设置为
Completion (IteratorStepValue (inputIter))。 IfAbruptCloseIterators (next, iters)。- 如果 next 不是
done ，则- 令 iter 为
Completion (GetIteratorFlattenable (next,reject-primitives ))。 - 令 needClosing 为 « inputIter » 和 iters 的
列表连接 。 IfAbruptCloseIterators (iter, needClosing)。- 将 iter 追加到 iters。
- 令 iter 为
- 将 next 设置为
- 令 iterCount 为 iters 中元素的数量。
- 如果 mode 是
"longest" ，则- 如果 paddingOption 是
undefined ，则- 重复 iterCount 次：
- 将
undefined 追加到 padding。
- 将
- 重复 iterCount 次：
- 否则，
- 令 paddingIter 为
Completion (GetIterator (paddingOption,sync ))。 IfAbruptCloseIterators (paddingIter, iters)。- 令 usingIterator 为
true 。 - 重复 iterCount 次：
- 如果 usingIterator 是
true ，则- 将 next 设置为
Completion (IteratorStepValue (paddingIter))。 IfAbruptCloseIterators (next, iters)。- 如果 next 是
done ，则- 将 usingIterator 设置为
false 。
- 将 usingIterator 设置为
- 否则，
- 将 next 追加到 padding。
- 将 next 设置为
- 如果 usingIterator 是
false ，则将undefined 追加到 padding。
- 如果 usingIterator 是
- 如果 usingIterator 是
true ，则- 令 completion 为
Completion (IteratorClose (paddingIter,NormalCompletion (unused )))。 IfAbruptCloseIterators (completion, iters)。
- 令 completion 为
- 令 paddingIter 为
- 如果 paddingOption 是
- 令 finishResults 为一个新的
Abstract Closure ，其参数为 (results)，不捕获任何内容，并在被调用时执行以下步骤：- 返回
CreateArrayFromList (results)。
- 返回
- 返回
IteratorZip (iters, mode, padding, finishResults)。
27.1.3.2.5 Iterator.zipKeyed ( iterables [ , options ] )
此函数在被调用时执行以下步骤：
- 如果 iterables 不是 Object，则抛出
TypeError 异常。 - 将 options 设置为 ?
GetOptionsObject (options)。 - 令 mode 为 ?
Get (options,"mode" )。 - 如果 mode 是
undefined ，则将 mode 设置为"shortest" 。 - 如果 mode 不是
"shortest" 、"longest" 或"strict" 之一，则抛出TypeError 异常。 - 令 paddingOption 为
undefined 。 - 如果 mode 是
"longest" ，则- 将 paddingOption 设置为 ?
Get (options,"padding" )。 - 如果 paddingOption 不是
undefined 且 paddingOption 不是 Object，则抛出TypeError 异常。
- 将 paddingOption 设置为 ?
- 令 iters 为新的空
List 。 - 令 padding 为新的空
List 。 - 令 allKeys 为 ? iterables.[[OwnPropertyKeys]]()。
- 令 keys 为新的空
List 。 - 对 allKeys 的每个元素 key，执行：
- 令 propertyDesc 为
Completion (iterables.[[GetOwnProperty]](key))。 IfAbruptCloseIterators (propertyDesc, iters)。- 如果 propertyDesc 不是
undefined 且 propertyDesc.[[Enumerable]] 是true ，则- 令 value 为
Completion (Get (iterables, key))。 IfAbruptCloseIterators (value, iters)。- 如果 value 不是
undefined ，则- 将 key 追加到 keys。
- 令 iter 为
Completion (GetIteratorFlattenable (value,reject-primitives ))。 IfAbruptCloseIterators (iter, iters)。- 将 iter 追加到 iters。
- 令 value 为
- 令 propertyDesc 为
- 令 iterCount 为 iters 中元素的数量。
- 如果 mode 是
"longest" ，则- 如果 paddingOption 是
undefined ，则- 重复 iterCount 次：
- 将
undefined 追加到 padding。
- 将
- 重复 iterCount 次：
- 否则，
- 对 keys 的每个元素 key，执行：
- 令 value 为
Completion (Get (paddingOption, key))。 IfAbruptCloseIterators (value, iters)。- 将 value 追加到 padding。
- 令 value 为
- 对 keys 的每个元素 key，执行：
- 如果 paddingOption 是
- 令 finishResults 为一个新的
Abstract Closure ，其参数为 (results)，捕获 keys 和 iterCount，并在被调用时执行以下步骤：- 令 obj 为
OrdinaryObjectCreate (null )。 - 对满足 0 ≤ i < iterCount 的每个整数 i，按升序执行：
- 执行 !
CreateDataPropertyOrThrow (obj, keys[i], results[i])。
- 执行 !
- 返回 obj。
- 令 obj 为
- 返回
IteratorZip (iters, mode, padding, finishResults)。
27.1.3.3 Iterator 原型对象的属性
Iterator 原型对象：
- 是 %Iterator.prototype%。
- 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是
普通对象 。
本规范中定义的所有实现
以下表达式是 ECMAScript 代码访问 %Iterator.prototype% 对象的一种方式：
Object.getPrototypeOf(Object.getPrototypeOf([][Symbol.iterator]()))27.1.3.3.1 Iterator.prototype.constructor
Iterator.prototype.constructor 是
27.1.3.3.1.1 get Iterator.prototype.constructor
[[Get]] 特性的值是一个不需要实参的内置函数。它在被调用时执行以下步骤：
- 返回
%Iterator% 。
27.1.3.3.1.2 set Iterator.prototype.constructor
[[Set]] 特性的值是一个接受实参 v 的内置函数。它在被调用时执行以下步骤：
- 执行 ?
SetterThatIgnoresPrototypeProperties (this 值,%Iterator.prototype% ,"constructor" , v)。 - 返回
undefined 。
不同于大多数内置原型上的
27.1.3.3.2 Iterator.prototype.drop ( limit )
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 如果 obj 不是 Object，则抛出
TypeError 异常。 - 令 iterated 为
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false }。 - 令 numberLimit 为
Completion (ToNumber (limit))。 IfAbruptCloseIterator (numberLimit, iterated)。- 如果 numberLimit 是
NaN ，则- 令 error 为
ThrowCompletion (一个新创建的RangeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 令 intLimit 为 !
ToIntegerOrInfinity (numberLimit)。 - 如果 intLimit < 0，则
- 令 error 为
ThrowCompletion (一个新创建的RangeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 将 iterated 设置为 ?
GetIteratorDirect (obj)。 - 令 closure 为一个新的无参数
Abstract Closure ，它捕获 iterated 和 intLimit，并在被调用时执行以下步骤：- 令 remaining 为 intLimit。
- 重复，只要 remaining > 0，
- 如果 remaining ≠ +∞，则
- 将 remaining 设置为 remaining - 1。
- 令 next 为 ?
IteratorStep (iterated)。 - 如果 next 是
done ，则返回ReturnCompletion (undefined )。
- 如果 remaining ≠ +∞，则
- 重复，
- 令 value 为 ?
IteratorStepValue (iterated)。 - 如果 value 是
done ，则返回ReturnCompletion (undefined )。 - 令 completion 为
Completion (Yield (value))。 IfAbruptCloseIterator (completion, iterated)。
- 令 value 为 ?
- 令 result 为
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterators]] »)。 - 将 result.[[UnderlyingIterators]] 设置为 « iterated »。
- 返回 result。
27.1.3.3.3 Iterator.prototype.every ( predicate )
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 如果 obj 不是 Object，则抛出
TypeError 异常。 - 令 iterated 为
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false }。 - 如果
IsCallable (predicate) 是false ，则- 令 error 为
ThrowCompletion (一个新创建的TypeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 将 iterated 设置为 ?
GetIteratorDirect (obj)。 - 令 counter 为 0。
- 重复，
- 令 value 为 ?
IteratorStepValue (iterated)。 - 如果 value 是
done ，则返回true 。 - 令 result 为
Completion (Call (predicate,undefined , « value,𝔽 (counter) »))。 IfAbruptCloseIterator (result, iterated)。- 如果
ToBoolean (result) 是false ，则返回 ?IteratorClose (iterated,NormalCompletion (false ))。 - 将 counter 设置为 counter + 1。
- 令 value 为 ?
27.1.3.3.4 Iterator.prototype.filter ( predicate )
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 如果 obj 不是 Object，则抛出
TypeError 异常。 - 令 iterated 为
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false }。 - 如果
IsCallable (predicate) 是false ，则- 令 error 为
ThrowCompletion (一个新创建的TypeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 将 iterated 设置为 ?
GetIteratorDirect (obj)。 - 令 closure 为一个新的无参数
Abstract Closure ，它捕获 iterated 和 predicate，并在被调用时执行以下步骤：- 令 counter 为 0。
- 重复，
- 令 value 为 ?
IteratorStepValue (iterated)。 - 如果 value 是
done ，则返回ReturnCompletion (undefined )。 - 令 selected 为
Completion (Call (predicate,undefined , « value,𝔽 (counter) »))。 IfAbruptCloseIterator (selected, iterated)。- 如果
ToBoolean (selected) 是true ，则- 令 completion 为
Completion (Yield (value))。 IfAbruptCloseIterator (completion, iterated)。
- 令 completion 为
- 将 counter 设置为 counter + 1。
- 令 value 为 ?
- 令 result 为
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterators]] »)。 - 将 result.[[UnderlyingIterators]] 设置为 « iterated »。
- 返回 result。
27.1.3.3.5 Iterator.prototype.find ( predicate )
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 如果 obj 不是 Object，则抛出
TypeError 异常。 - 令 iterated 为
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false }。 - 如果
IsCallable (predicate) 是false ，则- 令 error 为
ThrowCompletion (一个新创建的TypeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 将 iterated 设置为 ?
GetIteratorDirect (obj)。 - 令 counter 为 0。
- 重复，
- 令 value 为 ?
IteratorStepValue (iterated)。 - 如果 value 是
done ，则返回undefined 。 - 令 result 为
Completion (Call (predicate,undefined , « value,𝔽 (counter) »))。 IfAbruptCloseIterator (result, iterated)。- 如果
ToBoolean (result) 是true ，则返回 ?IteratorClose (iterated,NormalCompletion (value))。 - 将 counter 设置为 counter + 1。
- 令 value 为 ?
27.1.3.3.6 Iterator.prototype.flatMap ( mapper )
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 如果 obj 不是 Object，则抛出
TypeError 异常。 - 令 iterated 为
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false }。 - 如果
IsCallable (mapper) 是false ，则- 令 error 为
ThrowCompletion (一个新创建的TypeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 将 iterated 设置为 ?
GetIteratorDirect (obj)。 - 令 closure 为一个新的无参数
Abstract Closure ，它捕获 iterated 和 mapper，并在被调用时执行以下步骤：- 令 counter 为 0。
- 重复，
- 令 value 为 ?
IteratorStepValue (iterated)。 - 如果 value 是
done ，则返回ReturnCompletion (undefined )。 - 令 mapped 为
Completion (Call (mapper,undefined , « value,𝔽 (counter) »))。 IfAbruptCloseIterator (mapped, iterated)。- 令 innerIterator 为
Completion (GetIteratorFlattenable (mapped,reject-primitives ))。 IfAbruptCloseIterator (innerIterator, iterated)。- 令 innerAlive 为
true 。 - 重复，只要 innerAlive 是
true ，- 令 innerValue 为
Completion (IteratorStepValue (innerIterator))。 IfAbruptCloseIterator (innerValue, iterated)。- 如果 innerValue 是
done ，则- 将 innerAlive 设置为
false 。
- 将 innerAlive 设置为
- 否则，
- 令 completion 为
Completion (Yield (innerValue))。 - 如果 completion 是 abrupt completion，则
- 令 backupCompletion 为
Completion (IteratorClose (innerIterator, completion))。 IfAbruptCloseIterator (backupCompletion, iterated)。- 返回 ?
IteratorClose (iterated, completion)。
- 令 backupCompletion 为
- 令 completion 为
- 令 innerValue 为
- 将 counter 设置为 counter + 1。
- 令 value 为 ?
- 令 result 为
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterators]] »)。 - 将 result.[[UnderlyingIterators]] 设置为 « iterated »。
- 返回 result。
27.1.3.3.7 Iterator.prototype.forEach ( procedure )
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 如果 obj 不是 Object，则抛出
TypeError 异常。 - 令 iterated 为
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false }。 - 如果
IsCallable (procedure) 是false ，则- 令 error 为
ThrowCompletion (一个新创建的TypeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 将 iterated 设置为 ?
GetIteratorDirect (obj)。 - 令 counter 为 0。
- 重复，
- 令 value 为 ?
IteratorStepValue (iterated)。 - 如果 value 是
done ，则返回undefined 。 - 令 result 为
Completion (Call (procedure,undefined , « value,𝔽 (counter) »))。 IfAbruptCloseIterator (result, iterated)。- 将 counter 设置为 counter + 1。
- 令 value 为 ?
27.1.3.3.8 Iterator.prototype.map ( mapper )
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 如果 obj 不是 Object，则抛出
TypeError 异常。 - 令 iterated 为
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false }。 - 如果
IsCallable (mapper) 是false ，则- 令 error 为
ThrowCompletion (一个新创建的TypeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 将 iterated 设置为 ?
GetIteratorDirect (obj)。 - 令 closure 为一个新的无参数
Abstract Closure ，它捕获 iterated 和 mapper，并在被调用时执行以下步骤：- 令 counter 为 0。
- 重复，
- 令 value 为 ?
IteratorStepValue (iterated)。 - 如果 value 是
done ，则返回ReturnCompletion (undefined )。 - 令 mapped 为
Completion (Call (mapper,undefined , « value,𝔽 (counter) »))。 IfAbruptCloseIterator (mapped, iterated)。- 令 completion 为
Completion (Yield (mapped))。 IfAbruptCloseIterator (completion, iterated)。- 将 counter 设置为 counter + 1。
- 令 value 为 ?
- 令 result 为
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterators]] »)。 - 将 result.[[UnderlyingIterators]] 设置为 « iterated »。
- 返回 result。
27.1.3.3.9 Iterator.prototype.reduce ( reducer [ , initialValue ] )
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 如果 obj 不是 Object，则抛出
TypeError 异常。 - 令 iterated 为
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false }。 - 如果
IsCallable (reducer) 是false ，则- 令 error 为
ThrowCompletion (一个新创建的TypeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 将 iterated 设置为 ?
GetIteratorDirect (obj)。 - 如果 initialValue 不存在，则
- 令 accumulator 为 ?
IteratorStepValue (iterated)。 - 如果 accumulator 是
done ，则抛出TypeError 异常。 - 令 counter 为 1。
- 令 accumulator 为 ?
- 否则，
- 令 accumulator 为 initialValue。
- 令 counter 为 0。
- 重复，
- 令 value 为 ?
IteratorStepValue (iterated)。 - 如果 value 是
done ，则返回 accumulator。 - 令 result 为
Completion (Call (reducer,undefined , « accumulator, value,𝔽 (counter) »))。 IfAbruptCloseIterator (result, iterated)。- 将 accumulator 设置为 result。
- 将 counter 设置为 counter + 1。
- 令 value 为 ?
27.1.3.3.10 Iterator.prototype.some ( predicate )
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 如果 obj 不是 Object，则抛出
TypeError 异常。 - 令 iterated 为
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false }。 - 如果
IsCallable (predicate) 是false ，则- 令 error 为
ThrowCompletion (一个新创建的TypeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 将 iterated 设置为 ?
GetIteratorDirect (obj)。 - 令 counter 为 0。
- 重复，
- 令 value 为 ?
IteratorStepValue (iterated)。 - 如果 value 是
done ，则返回false 。 - 令 result 为
Completion (Call (predicate,undefined , « value,𝔽 (counter) »))。 IfAbruptCloseIterator (result, iterated)。- 如果
ToBoolean (result) 是true ，则返回 ?IteratorClose (iterated,NormalCompletion (true ))。 - 将 counter 设置为 counter + 1。
- 令 value 为 ?
27.1.3.3.11 Iterator.prototype.take ( limit )
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 如果 obj 不是 Object，则抛出
TypeError 异常。 - 令 iterated 为
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false }。 - 令 numberLimit 为
Completion (ToNumber (limit))。 IfAbruptCloseIterator (numberLimit, iterated)。- 如果 numberLimit 是
NaN ，则- 令 error 为
ThrowCompletion (一个新创建的RangeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 令 intLimit 为 !
ToIntegerOrInfinity (numberLimit)。 - 如果 intLimit < 0，则
- 令 error 为
ThrowCompletion (一个新创建的RangeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 将 iterated 设置为 ?
GetIteratorDirect (obj)。 - 令 closure 为一个新的无参数
Abstract Closure ，它捕获 iterated 和 intLimit，并在被调用时执行以下步骤：- 令 remaining 为 intLimit。
- 重复，
- 如果 remaining = 0，则
- 返回 ?
IteratorClose (iterated,ReturnCompletion (undefined ))。
- 返回 ?
- 如果 remaining ≠ +∞，则
- 将 remaining 设置为 remaining - 1。
- 令 value 为 ?
IteratorStepValue (iterated)。 - 如果 value 是
done ，则返回ReturnCompletion (undefined )。 - 令 completion 为
Completion (Yield (value))。 IfAbruptCloseIterator (completion, iterated)。
- 如果 remaining = 0，则
- 令 result 为
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterators]] »)。 - 将 result.[[UnderlyingIterators]] 设置为 « iterated »。
- 返回 result。
27.1.3.3.12 Iterator.prototype.toArray ( )
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 如果 obj 不是 Object，则抛出
TypeError 异常。 - 令 iterated 为 ?
GetIteratorDirect (obj)。 - 令 items 为新的空
List 。 - 重复，
- 令 value 为 ?
IteratorStepValue (iterated)。 - 如果 value 是
done ，则返回CreateArrayFromList (items)。 - 将 value 追加到 items。
- 令 value 为 ?
27.1.3.3.13 Iterator.prototype [ %Symbol.dispose% ] ( )
调用此方法时，它执行以下步骤：
此方法的
27.1.3.3.14 Iterator.prototype [ %Symbol.iterator% ] ( )
此函数在被调用时执行以下步骤：
- 返回
this 值。
此函数的
27.1.3.3.15 Iterator.prototype [ %Symbol.toStringTag% ]
Iterator.prototype[%Symbol.toStringTag%] 是
27.1.3.3.15.1 get Iterator.prototype [ %Symbol.toStringTag% ]
[[Get]] 特性的值是一个不需要实参的内置函数。它在被调用时执行以下步骤：
- 返回
"Iterator" 。
27.1.3.3.15.2 set Iterator.prototype [ %Symbol.toStringTag% ]
[[Set]] 特性的值是一个接受实参 v 的内置函数。它在被调用时执行以下步骤：
- 执行 ?
SetterThatIgnoresPrototypeProperties (this 值,%Iterator.prototype% ,%Symbol.toStringTag% , v)。 - 返回
undefined 。
不同于大多数内置原型上的
27.1.3.4 Iterator 的抽象操作
27.1.3.4.1 IteratorZip ( iters, mode, padding, finishResults )
The abstract operation IteratorZip takes arguments iters (a
- 令 iterCount 为 iters 中元素的数量。
- 令 openIters 为 iters 的副本。
- 令 closure 为一个新的无参数
Abstract Closure ，它捕获 iters、iterCount、openIters、mode、padding 和 finishResults，并在被调用时执行以下步骤：- 如果 iterCount = 0，则返回
ReturnCompletion (undefined )。 - 重复，
- 令 results 为新的空
List 。 - 断言：openIters 不是空。
- 对满足 0 ≤ i < iterCount 的每个整数 i，按升序执行：
- 令 iter 为 iters[i]。
- 如果 iter 是
null ，则- 断言：mode 是
"longest" 。 - 令 result 为 padding[i]。
- 断言：mode 是
- 否则，
- 令 result 为
Completion (IteratorStepValue (iter))。 - 如果 result 是 abrupt completion，则
- 从 openIters 中移除 iter。
- 返回 ?
IteratorCloseAll (openIters, result)。
- 将 result 设置为 ! result。
- 如果 result 是
done ，则- 从 openIters 中移除 iter。
- 如果 mode 是
"shortest" ，则- 返回 ?
IteratorCloseAll (openIters,ReturnCompletion (undefined ))。
- 返回 ?
- 否则，如果 mode 是
"strict" ，则- 如果 i ≠ 0，则
- 返回 ?
IteratorCloseAll (openIters,ThrowCompletion (一个新创建的TypeError 对象))。
- 返回 ?
- 对满足 1 ≤ k < iterCount 的每个整数 k，按升序执行：
- 断言：iters[k] 不是
null 。 - 令 open 为
Completion (IteratorStep (iters[k]))。 - 如果 open 是 abrupt completion，则
- 从 openIters 中移除 iters[k]。
- 返回 ?
IteratorCloseAll (openIters, open)。
- 将 open 设置为 ! open。
- 如果 open 是
done ，则- 从 openIters 中移除 iters[k]。
- 否则，
- 返回 ?
IteratorCloseAll (openIters,ThrowCompletion (一个新创建的TypeError 对象))。
- 返回 ?
- 断言：iters[k] 不是
- 返回
ReturnCompletion (undefined )。
- 如果 i ≠ 0，则
- 否则，
- 断言：mode 是
"longest" 。 - 如果 openIters 为空，则返回
ReturnCompletion (undefined )。 - 将 iters[i] 设置为
null 。 - 将 result 设置为 padding[i]。
- 断言：mode 是
- 令 result 为
- 将 result 追加到 results。
- 将 results 设置为 finishResults(results)。
- 令 completion 为
Completion (Yield (results))。 IfAbruptCloseIterators (completion, openIters)。
- 令 results 为新的空
- 如果 iterCount = 0，则返回
- 令 gen 为
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterators]] »)。 - 将 gen.[[UnderlyingIterators]] 设置为 openIters。
- 返回 gen。
27.1.4 %AsyncIteratorPrototype% 对象
%AsyncIteratorPrototype% 对象：
- 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是
普通对象 。
本规范中定义的所有实现
27.1.4.1 %AsyncIteratorPrototype% [ %Symbol.asyncDispose% ] ( )
调用此方法时，它执行以下步骤：
- 令 obj 为
this 值。 - 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 return 为
Completion (GetMethod (obj,"return" ))。 IfAbruptRejectPromise (return, promiseCapability)。- 如果 return 是
undefined ，则- 执行 !
Call (promiseCapability.[[Resolve]],undefined , «undefined »)。
- 执行 !
- 否则，
- 令 result 为
Completion (Call (return, obj, « »))。 IfAbruptRejectPromise (result, promiseCapability)。- 令 resultWrapper 为
Completion (PromiseResolve (%Promise% , result))。 IfAbruptRejectPromise (resultWrapper, promiseCapability)。- 令 unwrap 为一个新的抽象闭包，该闭包没有参数，不捕获任何内容，并在被调用时执行以下步骤：
- 返回
undefined 。
- 返回
- 令 onFulfilled 为
CreateBuiltinFunction (unwrap, 1,"" , « »)。 - 执行
PerformPromiseThen (resultWrapper, onFulfilled,undefined , promiseCapability)。
- 令 result 为
- 返回 promiseCapability.[[Promise]]。
此方法的
27.1.4.2 %AsyncIteratorPrototype% [ %Symbol.asyncIterator% ] ( )
此函数在被调用时执行以下步骤：
- 返回
this 值。
此函数的
27.1.5 Async-from-Sync Iterator 对象
Async-from-Sync Iterator 对象是一种
27.1.5.1 CreateAsyncFromSyncIterator ( syncIteratorRecord )
The abstract operation CreateAsyncFromSyncIterator takes argument syncIteratorRecord (an
- 令 asyncIterator 为
OrdinaryObjectCreate (%AsyncFromSyncIteratorPrototype% , « [[SyncIteratorRecord]] »)。 - 将 asyncIterator.[[SyncIteratorRecord]] 设置为 syncIteratorRecord。
- 令 nextMethod 为 !
Get (asyncIterator,"next" )。 - 令 iteratorRecord 为
Iterator Record { [[Iterator]]: asyncIterator, [[NextMethod]]: nextMethod, [[Done]]:false }。 - 返回 iteratorRecord。
27.1.5.2 %AsyncFromSyncIteratorPrototype% 对象
%AsyncFromSyncIteratorPrototype% 对象：
- 具有由所有
Async-from-Sync Iterator 对象 继承的属性。 - 是
普通对象 。 - 具有一个 [[Prototype]] 内部槽，其值为
%AsyncIteratorPrototype% 。 - ECMAScript 代码永远无法直接访问它。
- 具有以下属性：
27.1.5.2.1 %AsyncFromSyncIteratorPrototype%.next ( [ value ] )
- 令 obj 为
this 值。 - 断言：obj 是具有 [[SyncIteratorRecord]] 内部槽的 Object。
- 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 syncIteratorRecord 为 obj.[[SyncIteratorRecord]]。
- 如果 value 存在，则
- 令 result 为
Completion (IteratorNext (syncIteratorRecord, value))。
- 令 result 为
- 否则，
- 令 result 为
Completion (IteratorNext (syncIteratorRecord))。
- 令 result 为
IfAbruptRejectPromise (result, promiseCapability)。- 返回
AsyncFromSyncIteratorContinuation (result, promiseCapability, syncIteratorRecord,true )。
27.1.5.2.2 %AsyncFromSyncIteratorPrototype%.return ( [ value ] )
- 令 obj 为
this 值。 - 断言：obj 是具有 [[SyncIteratorRecord]] 内部槽的 Object。
- 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 syncIteratorRecord 为 obj.[[SyncIteratorRecord]]。
- 令 syncIterator 为 syncIteratorRecord.[[Iterator]]。
- 令 return 为
Completion (GetMethod (syncIterator,"return" ))。 IfAbruptRejectPromise (return, promiseCapability)。- 如果 return 是
undefined ，则- 令 iteratorResult 为
CreateIteratorResultObject (value,true )。 - 执行 !
Call (promiseCapability.[[Resolve]],undefined , « iteratorResult »)。 - 返回 promiseCapability.[[Promise]]。
- 令 iteratorResult 为
- 如果 value 存在，则
- 令 result 为
Completion (Call (return, syncIterator, « value »))。
- 令 result 为
- 否则，
- 令 result 为
Completion (Call (return, syncIterator))。
- 令 result 为
IfAbruptRejectPromise (result, promiseCapability)。- 如果 result 不是 Object，则
- 执行 !
Call (promiseCapability.[[Reject]],undefined , « 一个新创建的TypeError 对象 »)。 - 返回 promiseCapability.[[Promise]]。
- 执行 !
- 返回
AsyncFromSyncIteratorContinuation (result, promiseCapability, syncIteratorRecord,false )。
27.1.5.2.3 %AsyncFromSyncIteratorPrototype%.throw ( [ value ] )
- 令 obj 为
this 值。 - 断言：obj 是具有 [[SyncIteratorRecord]] 内部槽的 Object。
- 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 syncIteratorRecord 为 obj.[[SyncIteratorRecord]]。
- 令 syncIterator 为 syncIteratorRecord.[[Iterator]]。
- 令 throw 为
Completion (GetMethod (syncIterator,"throw" ))。 IfAbruptRejectPromise (throw, promiseCapability)。- 如果 throw 是
undefined ，则- 注：如果 syncIterator 没有
throw方法，则关闭它，使其在我们拒绝 capability 之前有机会进行清理。 - 令 closeCompletion 为
NormalCompletion (empty )。 - 令 result 为
Completion (IteratorClose (syncIteratorRecord, closeCompletion))。 IfAbruptRejectPromise (result, promiseCapability)。- 注：下一步抛出
TypeError ，以指示存在协议违例：syncIterator 没有throw方法。 - 注：如果关闭 syncIterator 没有抛出异常，则该操作的结果会被忽略，即使它产生一个被拒绝的 promise。
- 执行 !
Call (promiseCapability.[[Reject]],undefined , « 一个新创建的TypeError 对象 »)。 - 返回 promiseCapability.[[Promise]]。
- 注：如果 syncIterator 没有
- 如果 value 存在，则
- 令 result 为
Completion (Call (throw, syncIterator, « value »))。
- 令 result 为
- 否则，
- 令 result 为
Completion (Call (throw, syncIterator))。
- 令 result 为
IfAbruptRejectPromise (result, promiseCapability)。- 如果 result 不是 Object，则
- 执行 !
Call (promiseCapability.[[Reject]],undefined , « 一个新创建的TypeError 对象 »)。 - 返回 promiseCapability.[[Promise]]。
- 执行 !
- 返回
AsyncFromSyncIteratorContinuation (result, promiseCapability, syncIteratorRecord,true )。
27.1.5.3 Async-from-Sync Iterator 实例的属性
Async-from-Sync
| 内部槽 | 类型 | 描述 |
|---|---|---|
| [[SyncIteratorRecord]] |
|
表示正在被适配的原始同步 |
27.1.5.4 AsyncFromSyncIteratorContinuation ( result, promiseCapability, syncIteratorRecord, closeOnRejection )
The abstract operation AsyncFromSyncIteratorContinuation takes arguments result (an Object), promiseCapability (a
- 注：由于 promiseCapability 派生自固有
%Promise% ，因此下面使用IfAbruptRejectPromise 所导致的对 promiseCapability.[[Reject]] 的调用保证不会抛出。 - 令 done 为
Completion (IteratorComplete (result))。 IfAbruptRejectPromise (done, promiseCapability)。- 令 value 为
Completion (IteratorValue (result))。 IfAbruptRejectPromise (value, promiseCapability)。- 令 valueWrapper 为
Completion (PromiseResolve (%Promise% , value))。 - 如果 valueWrapper 是 abrupt completion，done 是
false ，且 closeOnRejection 是true ，则- 将 valueWrapper 设置为
Completion (IteratorClose (syncIteratorRecord, valueWrapper))。
- 将 valueWrapper 设置为
IfAbruptRejectPromise (valueWrapper, promiseCapability)。- 令 unwrap 为一个新的
Abstract Closure ，其参数为 (v)，捕获 done，并在被调用时执行以下步骤：- 返回
CreateIteratorResultObject (v, done)。
- 返回
- 令 onFulfilled 为
CreateBuiltinFunction (unwrap, 1,"" , « »)。 - 注：onFulfilled 用于在处理 IteratorResult 对象的
"value" 属性时等待其值（如果它是 promise），并将结果重新包装到新的“已解包”IteratorResult 对象中。 - 如果 done 是
true 或 closeOnRejection 是false ，则- 令 onRejected 为
undefined 。
- 令 onRejected 为
- 否则，
- 令 closeIterator 为一个新的
Abstract Closure ，其参数为 (error)，捕获 syncIteratorRecord，并在被调用时执行以下步骤：- 返回 ?
IteratorClose (syncIteratorRecord,ThrowCompletion (error))。
- 返回 ?
- 令 onRejected 为
CreateBuiltinFunction (closeIterator, 1,"" , « »)。 - 注：当 IteratorResult 对象所产生的
"value" 属性是被拒绝的 promise 时，onRejected 用于关闭Iterator 。
- 令 closeIterator 为一个新的
- 执行
PerformPromiseThen (valueWrapper, onFulfilled, onRejected, promiseCapability)。 - 返回 promiseCapability.[[Promise]]。
27.2 资源管理
27.2.1 通用资源管理接口
27.2.1.1 Disposable 接口
Disposable 接口
| 属性 | 值 | 要求 |
|---|---|---|
%Symbol.dispose%
|
一个 |
调用此方法会通知 对同一个对象多次调用此方法时，应避免对已经处置的资源重复执行清理逻辑，并且不应抛出异常，即使第一次调用时曾抛出异常也是如此。不过，此要求不会被强制执行。 当通过 |
27.2.1.2 AsyncDisposable 接口
AsyncDisposable 接口
| 属性 | 值 | 要求 |
|---|---|---|
%Symbol.asyncDispose%
|
一个返回 promise 的 |
调用此方法会通知 对同一个对象多次调用此方法时，应避免对已经处置的资源重复执行清理逻辑，并且不应抛出异常或返回被拒绝的 promise，即使第一次调用时曾抛出异常或返回被拒绝的 promise 也是如此。不过，此要求不会被强制执行。 当通过 |
27.3 DisposableStack 对象
DisposableStack 是一个对象，可用于容纳一个或多个应一起处置的资源。
任何 DisposableStack 对象都处于两个互斥状态之一：已处置或待处理。当且仅当既未对可处置栈 d 调用 d.dispose()，也未对其调用 d.move() 时，d 是待处理的。
27.3.1 DisposableStack 构造函数
DisposableStack
- 是 %DisposableStack%。
- 是
全局对象 的"DisposableStack" 属性的初始值。 - 在作为
构造函数 调用时，创建并初始化一个新的 DisposableStack。 - 不旨在作为函数调用，并且在以这种方式调用时会抛出异常。
- 可用作类定义的
extends子句中的值。意图继承指定 DisposableStack 行为的子类构造函数 ，必须包含 一次对 DisposableStack构造函数 的super调用，以创建并初始化带有必要内部状态的子类实例，从而支持DisposableStack.prototype的内置方法。
27.3.1.1 DisposableStack ( )
调用此函数时，它执行以下步骤：
- 如果 NewTarget 是
undefined ，则抛出TypeError 异常。 - 令 disposableStack 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%DisposableStack.prototype%" , « [[DisposableState]], [[DisposableResourceStack]] »)。 - 将 disposableStack.[[DisposableState]] 设置为
pending 。 - 将 disposableStack.[[DisposableResourceStack]] 设置为一个新的空列表。
- 返回 disposableStack。
27.3.2 DisposableStack 构造函数的属性
DisposableStack
- 具有一个值为
%Function.prototype% 的 [[Prototype]] 内部槽。 - 具有以下属性：
27.3.2.1 DisposableStack.prototype
DisposableStack.prototype 的初始值是
此属性具有特性 { [[Writable]]:
27.3.3 DisposableStack 原型对象的属性
DisposableStack 原型对象：
- 是 %DisposableStack.prototype%。
- 具有一个值为
%Object.prototype% 的 [[Prototype]] 内部槽。 - 是一个
普通对象 。 - 没有 [[DisposableState]] 内部槽，也没有 DisposableStack 实例的任何其他内部槽。
27.3.3.1 DisposableStack.prototype.adopt ( value, onDispose )
调用此方法时，它执行以下步骤：
- 令 disposableStack 为
this 值。 - 执行 ?
RequireInternalSlot (disposableStack, [[DisposableState]])。 - 如果 disposableStack.[[DisposableState]] 是
disposed ，则抛出ReferenceError 异常。 - 如果
IsCallable (onDispose) 是false ，则抛出TypeError 异常。 - 令 closure 为一个新的抽象闭包，该闭包没有参数，捕获 value 和 onDispose，并在被调用时执行以下步骤：
- 返回 ?
Call (onDispose,undefined , « value »)。
- 返回 ?
- 令 func 为
CreateBuiltinFunction (closure, 0,"" , « »)。 - 执行 ?
AddDisposableResource (disposableStack.[[DisposableResourceStack]],undefined ,sync-dispose , func)。 - 返回 value。
27.3.3.2 DisposableStack.prototype.constructor
DisposableStack.prototype.constructor 的初始值是
27.3.3.3 DisposableStack.prototype.defer ( onDispose )
调用此方法时，它执行以下步骤：
- 令 disposableStack 为
this 值。 - 执行 ?
RequireInternalSlot (disposableStack, [[DisposableState]])。 - 如果 disposableStack.[[DisposableState]] 是
disposed ，则抛出ReferenceError 异常。 - 如果
IsCallable (onDispose) 是false ，则抛出TypeError 异常。 - 执行 ?
AddDisposableResource (disposableStack.[[DisposableResourceStack]],undefined ,sync-dispose , onDispose)。 - 返回
undefined 。
27.3.3.4 DisposableStack.prototype.dispose ( )
调用此方法时，它执行以下步骤：
- 令 disposableStack 为
this 值。 - 执行 ?
RequireInternalSlot (disposableStack, [[DisposableState]])。 - 如果 disposableStack.[[DisposableState]] 是
disposed ，则返回undefined 。 - 将 disposableStack.[[DisposableState]] 设置为
disposed 。 - 返回 ?
DisposeResources (disposableStack.[[DisposableResourceStack]],NormalCompletion (undefined ))。
27.3.3.5 get DisposableStack.prototype.disposed
DisposableStack.prototype.disposed 是一个
- 令 disposableStack 为
this 值。 - 执行 ?
RequireInternalSlot (disposableStack, [[DisposableState]])。 - 如果 disposableStack.[[DisposableState]] 是
disposed ，则返回true 。 - 返回
false 。
27.3.3.6 DisposableStack.prototype.move ( )
调用此方法时，它执行以下步骤：
- 令 disposableStack 为
this 值。 - 执行 ?
RequireInternalSlot (disposableStack, [[DisposableState]])。 - 如果 disposableStack.[[DisposableState]] 是
disposed ，则抛出ReferenceError 异常。 - 令 newDisposableStack 为 ?
OrdinaryCreateFromConstructor (%DisposableStack% ,"%DisposableStack.prototype%" , « [[DisposableState]], [[DisposableResourceStack]] »)。 - 将 newDisposableStack.[[DisposableState]] 设置为
pending 。 - 将 newDisposableStack.[[DisposableResourceStack]] 设置为 disposableStack.[[DisposableResourceStack]]。
- 将 disposableStack.[[DisposableResourceStack]] 设置为一个新的空列表。
- 将 disposableStack.[[DisposableState]] 设置为
disposed 。 - 返回 newDisposableStack。
27.3.3.7 DisposableStack.prototype.use ( value )
调用此方法时，它执行以下步骤：
- 令 disposableStack 为
this 值。 - 执行 ?
RequireInternalSlot (disposableStack, [[DisposableState]])。 - 如果 disposableStack.[[DisposableState]] 是
disposed ，则抛出ReferenceError 异常。 - 执行 ?
AddDisposableResource (disposableStack.[[DisposableResourceStack]], value,sync-dispose )。 - 返回 value。
27.3.3.8 DisposableStack.prototype [ %Symbol.dispose% ] ( )
%Symbol.dispose% 属性的初始值是 %DisposableStack.prototype.dispose%，定义于
27.3.3.9 DisposableStack.prototype [ %Symbol.toStringTag% ]
%Symbol.toStringTag% 属性的初始值是 String 值
此属性具有特性 { [[Writable]]:
27.3.4 DisposableStack 实例的属性
DisposableStack 实例是
| 内部槽 | 类型 | 描述 |
|---|---|---|
| [[DisposableState]] |
|
支配可处置栈将如何响应对其 %Symbol.dispose% 方法的传入调用。
|
| [[DisposableResourceStack]] |
一个 |
在可处置栈被处置时要处置的资源。资源按其初始化顺序添加，并按相反顺序处置。 |
27.4 AsyncDisposableStack 对象
AsyncDisposableStack 是一个对象，可用于容纳一个或多个应一起异步处置的资源。
任何 AsyncDisposableStack 对象都处于两个互斥状态之一：已处置或待处理。当且仅当既未对异步可处置栈 d 调用 d.disposeAsync()，也未对其调用 d.move() 时，d 是待处理的。
27.4.1 AsyncDisposableStack 构造函数
AsyncDisposableStack
- 是 %AsyncDisposableStack%。
- 是
全局对象 的"AsyncDisposableStack" 属性的初始值。 - 在作为
构造函数 调用时，创建并初始化一个新的 AsyncDisposableStack。 - 不旨在作为函数调用，并且在以这种方式调用时会抛出异常。
- 可用作类定义的
extends子句中的值。意图继承指定 AsyncDisposableStack 行为的子类构造函数 ，必须包含 一次对 AsyncDisposableStack构造函数 的super调用，以创建并初始化带有必要内部状态的子类实例，从而支持AsyncDisposableStack.prototype的内置方法。
27.4.1.1 AsyncDisposableStack ( )
调用此函数时，它执行以下步骤：
- 如果 NewTarget 是
undefined ，则抛出TypeError 异常。 - 令 asyncDisposableStack 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%AsyncDisposableStack.prototype%" , « [[AsyncDisposableState]], [[DisposableResourceStack]] »)。 - 将 asyncDisposableStack.[[AsyncDisposableState]] 设置为
pending 。 - 将 asyncDisposableStack.[[DisposableResourceStack]] 设置为一个新的空列表。
- 返回 asyncDisposableStack。
27.4.2 AsyncDisposableStack 构造函数的属性
AsyncDisposableStack
- 具有一个值为
%Function.prototype% 的 [[Prototype]] 内部槽。 - 具有以下属性：
27.4.2.1 AsyncDisposableStack.prototype
AsyncDisposableStack.prototype 的初始值是
此属性具有特性 { [[Writable]]:
27.4.3 AsyncDisposableStack 原型对象的属性
AsyncDisposableStack 原型对象：
- 是 %AsyncDisposableStack.prototype%。
- 具有一个值为
%Object.prototype% 的 [[Prototype]] 内部槽。 - 是一个
普通对象 。 - 没有 [[AsyncDisposableState]] 内部槽，也没有 AsyncDisposableStack 实例的任何其他内部槽。
27.4.3.1 AsyncDisposableStack.prototype.adopt ( value, onDisposeAsync )
调用此方法时，它执行以下步骤：
- 令 asyncDisposableStack 为
this 值。 - 执行 ?
RequireInternalSlot (asyncDisposableStack, [[AsyncDisposableState]])。 - 如果 asyncDisposableStack.[[AsyncDisposableState]] 是
disposed ，则抛出ReferenceError 异常。 - 如果
IsCallable (onDisposeAsync) 是false ，则抛出TypeError 异常。 - 令 closure 为一个新的抽象闭包，该闭包没有参数，捕获 value 和 onDisposeAsync，并在被调用时执行以下步骤：
- 返回 ?
Call (onDisposeAsync,undefined , « value »)。
- 返回 ?
- 令 func 为
CreateBuiltinFunction (closure, 0,"" , « »)。 - 执行 ?
AddDisposableResource (asyncDisposableStack.[[DisposableResourceStack]],undefined ,async-dispose , func)。 - 返回 value。
27.4.3.2 AsyncDisposableStack.prototype.constructor
AsyncDisposableStack.prototype.constructor 的初始值是
27.4.3.3 AsyncDisposableStack.prototype.defer ( onDisposeAsync )
调用此方法时，它执行以下步骤：
- 令 asyncDisposableStack 为
this 值。 - 执行 ?
RequireInternalSlot (asyncDisposableStack, [[AsyncDisposableState]])。 - 如果 asyncDisposableStack.[[AsyncDisposableState]] 是
disposed ，则抛出ReferenceError 异常。 - 如果
IsCallable (onDisposeAsync) 是false ，则抛出TypeError 异常。 - 执行 ?
AddDisposableResource (asyncDisposableStack.[[DisposableResourceStack]],undefined ,async-dispose , onDisposeAsync)。 - 返回
undefined 。
27.4.3.4 AsyncDisposableStack.prototype.disposeAsync ( )
调用此 async 方法时，它执行以下步骤：
- 令 asyncDisposableStack 为
this 值。 - 执行 ?
RequireInternalSlot (asyncDisposableStack, [[AsyncDisposableState]])。 - 如果 asyncDisposableStack.[[AsyncDisposableState]] 是
disposed ，则返回undefined 。 - 将 asyncDisposableStack.[[AsyncDisposableState]] 设置为
disposed 。 - 返回 ?
DisposeResources (asyncDisposableStack.[[DisposableResourceStack]],NormalCompletion (undefined ))。
27.4.3.5 get AsyncDisposableStack.prototype.disposed
AsyncDisposableStack.prototype.disposed 是一个
- 令 asyncDisposableStack 为
this 值。 - 执行 ?
RequireInternalSlot (asyncDisposableStack, [[AsyncDisposableState]])。 - 如果 asyncDisposableStack.[[AsyncDisposableState]] 是
disposed ，则返回true 。 - 返回
false 。
27.4.3.6 AsyncDisposableStack.prototype.move ( )
调用此方法时，它执行以下步骤：
- 令 asyncDisposableStack 为
this 值。 - 执行 ?
RequireInternalSlot (asyncDisposableStack, [[AsyncDisposableState]])。 - 如果 asyncDisposableStack.[[AsyncDisposableState]] 是
disposed ，则抛出ReferenceError 异常。 - 令 newAsyncDisposableStack 为 ?
OrdinaryCreateFromConstructor (%AsyncDisposableStack% ,"%AsyncDisposableStack.prototype%" , « [[AsyncDisposableState]], [[DisposableResourceStack]] »)。 - 将 newAsyncDisposableStack.[[AsyncDisposableState]] 设置为
pending 。 - 将 newAsyncDisposableStack.[[DisposableResourceStack]] 设置为 asyncDisposableStack.[[DisposableResourceStack]]。
- 将 asyncDisposableStack.[[DisposableResourceStack]] 设置为一个新的空列表。
- 将 asyncDisposableStack.[[AsyncDisposableState]] 设置为
disposed 。 - 返回 newAsyncDisposableStack。
27.4.3.7 AsyncDisposableStack.prototype.use ( value )
调用此方法时，它执行以下步骤：
- 令 asyncDisposableStack 为
this 值。 - 执行 ?
RequireInternalSlot (asyncDisposableStack, [[AsyncDisposableState]])。 - 如果 asyncDisposableStack.[[AsyncDisposableState]] 是
disposed ，则抛出ReferenceError 异常。 - 执行 ?
AddDisposableResource (asyncDisposableStack.[[DisposableResourceStack]], value,async-dispose )。 - 返回 value。
27.4.3.8 AsyncDisposableStack.prototype [ %Symbol.asyncDispose% ] ( )
%Symbol.asyncDispose% 属性的初始值是 %AsyncDisposableStack.prototype.disposeAsync%，定义于
27.4.3.9 AsyncDisposableStack.prototype [ %Symbol.toStringTag% ]
%Symbol.toStringTag% 属性的初始值是 String 值
此属性具有特性 { [[Writable]]:
27.4.4 AsyncDisposableStack 实例的属性
AsyncDisposableStack 实例是
| 内部槽 | 类型 | 描述 |
|---|---|---|
| [[AsyncDisposableState]] |
|
支配可处置栈将如何响应对其 %Symbol.asyncDispose% 方法的传入调用。
|
| [[DisposableResourceStack]] |
一个 |
在可处置栈被处置时要处置的资源。资源按其初始化顺序添加，并按相反顺序处置。 |
27.5 Promise 对象
Promise 是一种对象，用作延迟（并且可能是异步的）计算最终结果的占位符。
任何 Promise 都处于三种互斥状态之一：已兑现、已拒绝和待定：
-
如果
p.then(f, r)会立即入队一个Job 来调用函数f，则 promisep已兑现。 -
如果
p.then(f, r)会立即入队一个Job 来调用函数r，则 promisep已拒绝。 - 如果 promise 既未兑现也未拒绝，则它是待定的。
如果 promise 不是待定的，即如果它已兑现或已拒绝，则称该 promise 已敲定。
如果 promise 已敲定，或者它已被“锁定”为匹配另一个 promise 的状态，则该 promise 是已解决的。尝试解决或拒绝一个已解决的 promise 没有效果。如果 promise 不是已解决的，则它是未解决的。未解决的 promise 总是处于待定状态。已解决的 promise 可以是待定、已兑现或已拒绝。
27.5.1 Promise 抽象操作
27.5.1.1 PromiseCapability Record
PromiseCapability Record 是一种
PromiseCapability Record 具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Promise]] | Object | 可用作 promise 的对象。 |
| [[Resolve]] | function object | 用于解决给定 promise 的函数。 |
| [[Reject]] | function object | 用于拒绝给定 promise 的函数。 |
27.5.1.1.1 IfAbruptRejectPromise ( value, capability )
IfAbruptRejectPromise 是一系列使用
IfAbruptRejectPromise (value, capability)。
与以下内容含义相同：
- 断言：value 是
Completion Record 。 - 如果 value 是 abrupt completion，则
- 执行 ?
Call (capability.[[Reject]],undefined , « value.[[Value]] »)。 - 返回 capability.[[Promise]]。
- 执行 ?
- 将 value 设置为 ! value。
27.5.1.2 PromiseReaction Record
PromiseReaction Record 是一种
PromiseReaction Record 具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Capability]] |
|
此 |
| [[Type]] |
|
当 [[Handler]] 是 |
| [[Handler]] |
|
应应用于传入值的函数，其返回值将支配派生 promise 会发生什么。如果 [[Handler]] 是 |
27.5.1.3 CreateResolvingFunctions ( toResolve )
The abstract operation CreateResolvingFunctions takes argument toResolve (a Promise) and returns a
- 令 promiseOrEmpty 为
Record { [[Value]]: toResolve }。 - 令 resolveSteps 为一个新的
Abstract Closure ，其参数为 (resolution)，捕获 promiseOrEmpty，并在被调用时执行以下步骤：- 如果 promiseOrEmpty.[[Value]] 是
empty ，则返回undefined 。 - 令 promise 为 promiseOrEmpty.[[Value]]。
- 将 promiseOrEmpty.[[Value]] 设置为
empty 。 - 如果
SameValue (resolution, promise) 是true ，则- 令 selfResolutionError 为一个新创建的
TypeError 对象。 - 执行
RejectPromise (promise, selfResolutionError)。 - 返回
undefined 。
- 令 selfResolutionError 为一个新创建的
- 如果 resolution 不是 Object，则
- 执行
FulfillPromise (promise, resolution)。 - 返回
undefined 。
- 执行
- 令 then 为
Completion (Get (resolution,"then" ))。 - 如果 then 是 abrupt completion，则
- 执行
RejectPromise (promise, then.[[Value]])。 - 返回
undefined 。
- 执行
- 令 thenAction 为 then.[[Value]]。
- 如果
IsCallable (thenAction) 是false ，则- 执行
FulfillPromise (promise, resolution)。 - 返回
undefined 。
- 执行
- 令 thenJobCallback 为
HostMakeJobCallback (thenAction)。 - 令 job 为
NewPromiseResolveThenableJob (promise, resolution, thenJobCallback)。 - 执行
HostEnqueuePromiseJob (job.[[Job]], job.[[Realm]])。 - 返回
undefined 。
- 如果 promiseOrEmpty.[[Value]] 是
- 令 resolve 为
CreateBuiltinFunction (resolveSteps, 1,"" , « »)。 - 令 rejectSteps 为一个新的
Abstract Closure ，其参数为 (reason)，捕获 promiseOrEmpty，并在被调用时执行以下步骤：- 如果 promiseOrEmpty.[[Value]] 是
empty ，则返回undefined 。 - 令 promise 为 promiseOrEmpty.[[Value]]。
- 将 promiseOrEmpty.[[Value]] 设置为
empty 。 - 执行
RejectPromise (promise, reason)。 - 返回
undefined 。
- 如果 promiseOrEmpty.[[Value]] 是
- 令 reject 为
CreateBuiltinFunction (rejectSteps, 1,"" , « »)。 - 返回
Record { [[Resolve]]: resolve, [[Reject]]: reject }。
27.5.1.4 FulfillPromise ( promise, value )
The abstract operation FulfillPromise takes arguments promise (a Promise) and value (an ECMAScript language value) and returns
- 断言：promise.[[PromiseState]] 是
pending 。 - 令 reactions 为 promise.[[PromiseFulfillReactions]]。
- 将 promise.[[PromiseResult]] 设置为 value。
- 将 promise.[[PromiseFulfillReactions]] 设置为
undefined 。 - 将 promise.[[PromiseRejectReactions]] 设置为
undefined 。 - 将 promise.[[PromiseState]] 设置为
fulfilled 。 - 执行
TriggerPromiseReactions (reactions, value)。 - 返回
unused 。
27.5.1.5 NewPromiseCapability ( ctor )
The abstract operation NewPromiseCapability takes argument ctor (an ECMAScript language value) and returns either a normal completion containing a resolve 和 reject 函数。该 promise 加上 resolve 和 reject 函数用于初始化新的
- 如果
IsConstructor (ctor) 是false ，则抛出TypeError 异常。 - 注：假定 ctor 是支持 Promise 构造器参数约定的
构造函数 （见27.5.3.1 ）。 - 令 resolvingFuncs 为
Record { [[Resolve]]:undefined , [[Reject]]:undefined }。 - 令 executorClosure 为一个新的
Abstract Closure ，其参数为 (resolve, reject)，捕获 resolvingFuncs，并在被调用时执行以下步骤：- 如果 resolvingFuncs.[[Resolve]] 不是
undefined ，则抛出TypeError 异常。 - 如果 resolvingFuncs.[[Reject]] 不是
undefined ，则抛出TypeError 异常。 - 将 resolvingFuncs.[[Resolve]] 设置为 resolve。
- 将 resolvingFuncs.[[Reject]] 设置为 reject。
- 返回
NormalCompletion (undefined )。
- 如果 resolvingFuncs.[[Resolve]] 不是
- 令 executor 为
CreateBuiltinFunction (executorClosure, 2,"" , « »)。 - 令 promise 为 ?
Construct (ctor, « executor »)。 - 如果
IsCallable (resolvingFuncs.[[Resolve]]) 是false ，则抛出TypeError 异常。 - 如果
IsCallable (resolvingFuncs.[[Reject]]) 是false ，则抛出TypeError 异常。 - 返回
PromiseCapability Record { [[Promise]]: promise, [[Resolve]]: resolvingFuncs.[[Resolve]], [[Reject]]: resolvingFuncs.[[Reject]] }。
此
27.5.1.6 IsPromise ( arg )
The abstract operation IsPromise takes argument arg (an ECMAScript language value) and returns a Boolean. 它检查对象上的 promise 品牌。 It performs the following steps when called:
- 如果 arg 不是 Object，则返回
false 。 - 如果 arg 没有 [[PromiseState]] 内部槽，则返回
false 。 - 返回
true 。
27.5.1.7 RejectPromise ( promise, reason )
The abstract operation RejectPromise takes arguments promise (a Promise) and reason (an ECMAScript language value) and returns
- 断言：promise.[[PromiseState]] 是
pending 。 - 令 reactions 为 promise.[[PromiseRejectReactions]]。
- 将 promise.[[PromiseResult]] 设置为 reason。
- 将 promise.[[PromiseFulfillReactions]] 设置为
undefined 。 - 将 promise.[[PromiseRejectReactions]] 设置为
undefined 。 - 将 promise.[[PromiseState]] 设置为
rejected 。 - 如果 promise.[[PromiseIsHandled]] 是
false ，则执行HostPromiseRejectionTracker (promise,"reject" )。 - 执行
TriggerPromiseReactions (reactions, reason)。 - 返回
unused 。
27.5.1.8 TriggerPromiseReactions ( reactions, arg )
The abstract operation TriggerPromiseReactions takes arguments reactions (a
- 对 reactions 的每个元素 reaction，执行：
- 令 job 为
NewPromiseReactionJob (reaction, arg)。 - 执行
HostEnqueuePromiseJob (job.[[Job]], job.[[Realm]])。
- 令 job 为
- 返回
unused 。
27.5.1.9 HostPromiseRejectionTracker ( promise, operation )
The host-defined abstract operation HostPromiseRejectionTracker takes arguments promise (a Promise) and operation (
HostPromiseRejectionTracker 的默认实现是返回
HostPromiseRejectionTracker 在两种场景中被调用：
- 当 promise 在没有任何 handler 的情况下被拒绝时，它会以 operation 实参设置为
"reject" 被调用。 - 当第一次向已拒绝的 promise 添加 handler 时，它会以 operation 实参设置为
"handle" 被调用。
HostPromiseRejectionTracker 的典型实现可能会尝试向开发者通知未处理的拒绝，同时也会小心地在这类先前通知之后因附加新 handler 而失效时通知开发者。
如果 operation 是
27.5.2 Promise Job
27.5.2.1 NewPromiseReactionJob ( reaction, arg )
The abstract operation NewPromiseReactionJob takes arguments reaction (a
- 令 job 为一个新的无参数
Job Abstract Closure ，它捕获 reaction 和 arg，并在被调用时执行以下步骤：- 令 promiseCapability 为 reaction.[[Capability]]。
- 令 type 为 reaction.[[Type]]。
- 令 handler 为 reaction.[[Handler]]。
- 如果 handler 是
empty ，则- 如果 type 是
fulfill ，则- 令 handlerResult 为
NormalCompletion (arg)。
- 令 handlerResult 为
- 否则，
- 断言：type 是
reject 。 - 令 handlerResult 为
ThrowCompletion (arg)。
- 断言：type 是
- 如果 type 是
- 否则，
- 令 handlerResult 为
Completion (HostCallJobCallback (handler,undefined , « arg »))。
- 令 handlerResult 为
- 如果 promiseCapability 是
undefined ，则- 断言：handlerResult 不是 abrupt completion。
- 返回
empty 。
- 断言：promiseCapability 是
PromiseCapability Record 。 - 如果 handlerResult 是 abrupt completion，则
- 返回 ?
Call (promiseCapability.[[Reject]],undefined , « handlerResult.[[Value]] »)。
- 返回 ?
- 返回 ?
Call (promiseCapability.[[Resolve]],undefined , « handlerResult.[[Value]] »)。
- 令 handlerRealm 为
null 。 - 如果 reaction.[[Handler]] 不是
empty ，则- 令 getHandlerRealmResult 为
Completion (GetFunctionRealm (reaction.[[Handler]].[[Callback]]))。 - 如果 getHandlerRealmResult 是 normal completion，则将 handlerRealm 设置为 getHandlerRealmResult.[[Value]]。
- 否则，将 handlerRealm 设置为
当前 Realm Record 。 - 注：除非 handler 是
undefined ，否则 handlerRealm 永远不是null 。当 handler 是已撤销 Proxy 且没有 ECMAScript 代码运行时，handlerRealm 用于创建错误对象。
- 令 getHandlerRealmResult 为
- 返回
Record { [[Job]]: job, [[Realm]]: handlerRealm }。
27.5.2.2 NewPromiseResolveThenableJob ( promiseToResolve, thenable, then )
The abstract operation NewPromiseResolveThenableJob takes arguments promiseToResolve (a Promise), thenable (an Object), and then (a
- 令 job 为一个新的无参数
Job Abstract Closure ，它捕获 promiseToResolve、thenable 和 then，并在被调用时执行以下步骤：- 令 resolvingFuncs 为
CreateResolvingFunctions (promiseToResolve)。 - 令 thenCallResult 为
Completion (HostCallJobCallback (then, thenable, « resolvingFuncs.[[Resolve]], resolvingFuncs.[[Reject]] »))。 - 如果 thenCallResult 是 abrupt completion，则
- 返回 ?
Call (resolvingFuncs.[[Reject]],undefined , « thenCallResult.[[Value]] »)。
- 返回 ?
- 返回 ! thenCallResult。
- 令 resolvingFuncs 为
- 令 getThenRealmResult 为
Completion (GetFunctionRealm (then.[[Callback]]))。 - 如果 getThenRealmResult 是 normal completion，则令 thenRealm 为 getThenRealmResult.[[Value]]。
- 否则，令 thenRealm 为
当前 Realm Record 。 - 注：thenRealm 永远不是
null 。当 then.[[Callback]] 是已撤销 Proxy 且没有代码运行时，thenRealm 用于创建错误对象。 - 返回
Record { [[Job]]: job, [[Realm]]: thenRealm }。
27.5.3 Promise 构造器
Promise 构造器：
- 是 %Promise%。
- 是
全局对象 的"Promise" 属性的初始值。 - 在作为构造器调用时创建并初始化一个新的 Promise。
- 不意图作为函数调用，并且以这种方式调用时会抛出异常。
- 可以用作类定义的
extends子句中的值。打算继承指定 Promise 行为的子类构造函数 ，必须包含 一次对 Promise构造函数 的super调用，以创建并初始化子类实例，使其具备支持Promise和Promise.prototype的内置方法所必需的内部状态。
27.5.3.1 Promise ( executor )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 是
undefined ，则抛出TypeError 异常。 - 如果
IsCallable (executor) 是false ，则抛出TypeError 异常。 - 令 promise 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%Promise.prototype%" , « [[PromiseState]], [[PromiseResult]], [[PromiseFulfillReactions]], [[PromiseRejectReactions]], [[PromiseIsHandled]] »)。 - 将 promise.[[PromiseState]] 设置为
pending 。 - 将 promise.[[PromiseResult]] 设置为
empty 。 - 将 promise.[[PromiseFulfillReactions]] 设置为新的空
List 。 - 将 promise.[[PromiseRejectReactions]] 设置为新的空
List 。 - 将 promise.[[PromiseIsHandled]] 设置为
false 。 - 令 resolvingFuncs 为
CreateResolvingFunctions (promise)。 - 令 completion 为
Completion (Call (executor,undefined , « resolvingFuncs.[[Resolve]], resolvingFuncs.[[Reject]] »))。 - 如果 completion 是 abrupt completion，则
- 执行 ?
Call (resolvingFuncs.[[Reject]],undefined , « completion.[[Value]] »)。
- 执行 ?
- 返回 promise。
executor 实参必须是 function object。它被调用以启动和报告此 Promise 所表示的可能延迟动作的完成情况。executor 以两个实参调用：resolve 和 reject。这些函数可由 executor 函数使用，以报告延迟计算的最终完成或失败。从 executor 函数返回并不表示延迟动作已完成，而只表示最终执行该延迟动作的请求已被接受。
传给 executor 函数的 resolve 函数接受单个实参。executor 代码最终可以调用 resolve 函数，以指示它希望解决关联的 Promise。传给 resolve 函数的实参表示延迟动作的最终值，可以是实际的兑现值，也可以是另一个 promise，如果该 promise 被兑现，则它将提供该值。
传给 executor 函数的 reject 函数接受单个实参。executor 代码最终可以调用 reject 函数，以指示关联的 Promise 被拒绝且永远不会被兑现。传给 reject 函数的实参用作该 promise 的拒绝值。通常它会是 Error 对象。
Promise 构造器传给 executor 函数的 resolve 和 reject 函数具有实际解决和拒绝关联 promise 的能力。子类可以有不同的构造器行为，传入自定义的 resolve 和 reject 值。
27.5.4 Promise 构造器的属性
Promise 构造器：
- 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
27.5.4.1 Promise.all ( iterable )
此函数返回一个新的 promise，该 promise 以所传 promise 的兑现值数组兑现，或者以第一个被拒绝的所传 promise 的理由拒绝。它在运行此算法时会将所传
- 令 ctor 为
this 值。 - 令 promiseCapability 为 ?
NewPromiseCapability (ctor)。 - 令 promiseResolve 为
Completion (GetPromiseResolve (ctor))。 IfAbruptRejectPromise (promiseResolve, promiseCapability)。- 令 iteratorRecord 为
Completion (GetIterator (iterable,sync ))。 IfAbruptRejectPromise (iteratorRecord, promiseCapability)。- 令 result 为
Completion (PerformPromiseAll (iteratorRecord, ctor, promiseCapability, promiseResolve))。 - 如果 result 是 abrupt completion，则
- 如果 iteratorRecord.[[Done]] 是
false ，则将 result 设置为Completion (IteratorClose (iteratorRecord, result))。 IfAbruptRejectPromise (result, promiseCapability)。
- 如果 iteratorRecord.[[Done]] 是
- 返回 ! result。
此函数要求其
27.5.4.1.1 GetPromiseResolve ( promiseCtor )
The abstract operation GetPromiseResolve takes argument promiseCtor (a constructor) and returns either a normal completion containing a function object or a throw completion. It performs the following steps when called:
- 令 promiseResolve 为 ?
Get (promiseCtor,"resolve" )。 - 如果
IsCallable (promiseResolve) 是false ，则抛出TypeError 异常。 - 返回 promiseResolve。
27.5.4.1.2 PerformPromiseAll ( iteratorRecord, ctor, resultCapability, promiseResolve )
The abstract operation PerformPromiseAll takes arguments iteratorRecord (an
- 令 values 为新的空
List 。 - 注：remainingElementsCount 从 1 而不是 0 开始，以确保 resultCapability.[[Resolve]] 只被调用一次，即使存在行为不当的
"then" 在输入iterator 耗尽之前调用传入的回调。 - 令 remainingElementsCount 为
Record { [[Value]]: 1 }。 - 令 index 为 0。
- 重复，
- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 是
done ，则- 将 remainingElementsCount.[[Value]] 设置为 remainingElementsCount.[[Value]] - 1。
- 如果 remainingElementsCount.[[Value]] = 0，则
- 令 valuesArray 为
CreateArrayFromList (values)。 - 执行 ?
Call (resultCapability.[[Resolve]],undefined , « valuesArray »)。
- 令 valuesArray 为
- 返回 resultCapability.[[Promise]]。
- 将
undefined 追加到 values。 - 令 nextPromise 为 ?
Call (promiseResolve, ctor, « next »)。 - 令 fulfilledSteps 为一个新的
Abstract Closure ，其参数为 (value)，捕获 values、resultCapability 和 remainingElementsCount，并在被调用时执行以下步骤：- 令 activeFunc 为
活动函数对象 。 - 如果 activeFunc.[[AlreadyCalled]] 是
true ，则返回undefined 。 - 将 activeFunc.[[AlreadyCalled]] 设置为
true 。 - 令 thisIndex 为 activeFunc.[[Index]]。
- 将 values[thisIndex] 设置为 value。
- 将 remainingElementsCount.[[Value]] 设置为 remainingElementsCount.[[Value]] - 1。
- 如果 remainingElementsCount.[[Value]] = 0，则
- 令 valuesArray 为
CreateArrayFromList (values)。 - 返回 ?
Call (resultCapability.[[Resolve]],undefined , « valuesArray »)。
- 令 valuesArray 为
- 返回
undefined 。
- 令 activeFunc 为
- 令 onFulfilled 为
CreateBuiltinFunction (fulfilledSteps, 1,"" , « [[AlreadyCalled]], [[Index]] »)。 - 将 onFulfilled.[[AlreadyCalled]] 设置为
false 。 - 将 onFulfilled.[[Index]] 设置为 index。
- 将 index 设置为 index + 1。
- 将 remainingElementsCount.[[Value]] 设置为 remainingElementsCount.[[Value]] + 1。
- 执行 ?
Invoke (nextPromise,"then" , « onFulfilled, resultCapability.[[Reject]] »)。
- 令 next 为 ?
27.5.4.2 Promise.allSettled ( iterable )
此函数返回一个 promise，该 promise 会以 promise 状态快照数组兑现，但只有在所有原始 promise 都已敲定，即变为已兑现或已拒绝之后才会兑现。它在运行此算法时会将所传
- 令 ctor 为
this 值。 - 令 promiseCapability 为 ?
NewPromiseCapability (ctor)。 - 令 promiseResolve 为
Completion (GetPromiseResolve (ctor))。 IfAbruptRejectPromise (promiseResolve, promiseCapability)。- 令 iteratorRecord 为
Completion (GetIterator (iterable,sync ))。 IfAbruptRejectPromise (iteratorRecord, promiseCapability)。- 令 result 为
Completion (PerformPromiseAllSettled (iteratorRecord, ctor, promiseCapability, promiseResolve))。 - 如果 result 是 abrupt completion，则
- 如果 iteratorRecord.[[Done]] 是
false ，则将 result 设置为Completion (IteratorClose (iteratorRecord, result))。 IfAbruptRejectPromise (result, promiseCapability)。
- 如果 iteratorRecord.[[Done]] 是
- 返回 ! result。
此函数要求其
27.5.4.2.1 PerformPromiseAllSettled ( iteratorRecord, ctor, resultCapability, promiseResolve )
The abstract operation PerformPromiseAllSettled takes arguments iteratorRecord (an
- 令 values 为新的空
List 。 - 注：remainingElementsCount 从 1 而不是 0 开始，以确保 resultCapability.[[Resolve]] 只被调用一次，即使存在行为不当的
"then" 在输入iterator 耗尽之前调用传入的某个回调。 - 令 remainingElementsCount 为
Record { [[Value]]: 1 }。 - 令 index 为 0。
- 重复，
- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 是
done ，则- 将 remainingElementsCount.[[Value]] 设置为 remainingElementsCount.[[Value]] - 1。
- 如果 remainingElementsCount.[[Value]] = 0，则
- 令 valuesArray 为
CreateArrayFromList (values)。 - 执行 ?
Call (resultCapability.[[Resolve]],undefined , « valuesArray »)。
- 令 valuesArray 为
- 返回 resultCapability.[[Promise]]。
- 将
undefined 追加到 values。 - 令 nextPromise 为 ?
Call (promiseResolve, ctor, « next »)。 - 令 alreadyCalled 为
Record { [[Value]]:false }。 - 令 fulfilledSteps 为一个新的
Abstract Closure ，其参数为 (value)，捕获 values、resultCapability 和 remainingElementsCount，并在被调用时执行以下步骤：- 令 activeFunc 为
活动函数对象 。 - 如果 activeFunc.[[AlreadyCalled]].[[Value]] 是
true ，则返回undefined 。 - 将 activeFunc.[[AlreadyCalled]].[[Value]] 设置为
true 。 - 令 obj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 !
CreateDataPropertyOrThrow (obj,"status" ,"fulfilled" )。 - 执行 !
CreateDataPropertyOrThrow (obj,"value" , value)。 - 令 thisIndex 为 activeFunc.[[Index]]。
- 将 values[thisIndex] 设置为 obj。
- 将 remainingElementsCount.[[Value]] 设置为 remainingElementsCount.[[Value]] - 1。
- 如果 remainingElementsCount.[[Value]] = 0，则
- 令 valuesArray 为
CreateArrayFromList (values)。 - 返回 ?
Call (resultCapability.[[Resolve]],undefined , « valuesArray »)。
- 令 valuesArray 为
- 返回
undefined 。
- 令 activeFunc 为
- 令 onFulfilled 为
CreateBuiltinFunction (fulfilledSteps, 1,"" , « [[AlreadyCalled]], [[Index]] »)。 - 将 onFulfilled.[[AlreadyCalled]] 设置为 alreadyCalled。
- 将 onFulfilled.[[Index]] 设置为 index。
- 令 rejectedSteps 为一个新的
Abstract Closure ，其参数为 (error)，捕获 values、resultCapability 和 remainingElementsCount，并在被调用时执行以下步骤：- 令 activeFunc 为
活动函数对象 。 - 如果 activeFunc.[[AlreadyCalled]].[[Value]] 是
true ，则返回undefined 。 - 将 activeFunc.[[AlreadyCalled]].[[Value]] 设置为
true 。 - 令 obj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 !
CreateDataPropertyOrThrow (obj,"status" ,"rejected" )。 - 执行 !
CreateDataPropertyOrThrow (obj,"reason" , error)。 - 令 thisIndex 为 activeFunc.[[Index]]。
- 将 values[thisIndex] 设置为 obj。
- 将 remainingElementsCount.[[Value]] 设置为 remainingElementsCount.[[Value]] - 1。
- 如果 remainingElementsCount.[[Value]] = 0，则
- 令 valuesArray 为
CreateArrayFromList (values)。 - 返回 ?
Call (resultCapability.[[Resolve]],undefined , « valuesArray »)。
- 令 valuesArray 为
- 返回
undefined 。
- 令 activeFunc 为
- 令 onRejected 为
CreateBuiltinFunction (rejectedSteps, 1,"" , « [[AlreadyCalled]], [[Index]] »)。 - 将 onRejected.[[AlreadyCalled]] 设置为 alreadyCalled。
- 将 onRejected.[[Index]] 设置为 index。
- 将 index 设置为 index + 1。
- 将 remainingElementsCount.[[Value]] 设置为 remainingElementsCount.[[Value]] + 1。
- 执行 ?
Invoke (nextPromise,"then" , « onFulfilled, onRejected »)。
- 令 next 为 ?
27.5.4.3 Promise.any ( iterable )
此函数返回一个 promise，该 promise 由第一个被兑现的给定 promise 兑现；或者如果所有给定 promise 都被拒绝，则以持有拒绝理由的 AggregateError 拒绝。它在运行此算法时会将所传
- 令 ctor 为
this 值。 - 令 promiseCapability 为 ?
NewPromiseCapability (ctor)。 - 令 promiseResolve 为
Completion (GetPromiseResolve (ctor))。 IfAbruptRejectPromise (promiseResolve, promiseCapability)。- 令 iteratorRecord 为
Completion (GetIterator (iterable,sync ))。 IfAbruptRejectPromise (iteratorRecord, promiseCapability)。- 令 result 为
Completion (PerformPromiseAny (iteratorRecord, ctor, promiseCapability, promiseResolve))。 - 如果 result 是 abrupt completion，则
- 如果 iteratorRecord.[[Done]] 是
false ，则将 result 设置为Completion (IteratorClose (iteratorRecord, result))。 IfAbruptRejectPromise (result, promiseCapability)。
- 如果 iteratorRecord.[[Done]] 是
- 返回 ! result。
此函数要求其 Promise 构造器参数约定的
27.5.4.3.1 PerformPromiseAny ( iteratorRecord, ctor, resultCapability, promiseResolve )
The abstract operation PerformPromiseAny takes arguments iteratorRecord (an
- 令 errors 为新的空
List 。 - 注：remainingElementsCount 从 1 而不是 0 开始，以确保 resultCapability.[[Reject]] 只被调用一次，即使存在行为不当的
"then" 在输入iterator 耗尽之前调用传入的回调。 - 令 remainingElementsCount 为
Record { [[Value]]: 1 }。 - 令 index 为 0。
- 重复，
- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 是
done ，则- 将 remainingElementsCount.[[Value]] 设置为 remainingElementsCount.[[Value]] - 1。
- 如果 remainingElementsCount.[[Value]] = 0，则
- 令 aggregateError 为一个新创建的
AggregateError 对象。 - 执行 !
DefinePropertyOrThrow (aggregateError,"errors" , PropertyDescriptor { [[Configurable]]:true , [[Enumerable]]:false , [[Writable]]:true , [[Value]]:CreateArrayFromList (errors) })。 - 执行 ?
Call (resultCapability.[[Reject]],undefined , « aggregateError »)。
- 令 aggregateError 为一个新创建的
- 返回 resultCapability.[[Promise]]。
- 将
undefined 追加到 errors。 - 令 nextPromise 为 ?
Call (promiseResolve, ctor, « next »)。 - 令 rejectedSteps 为一个新的
Abstract Closure ，其参数为 (error)，捕获 errors、resultCapability 和 remainingElementsCount，并在被调用时执行以下步骤：- 令 activeFunc 为
活动函数对象 。 - 如果 activeFunc.[[AlreadyCalled]] 是
true ，则返回undefined 。 - 将 activeFunc.[[AlreadyCalled]] 设置为
true 。 - 令 thisIndex 为 activeFunc.[[Index]]。
- 将 errors[thisIndex] 设置为 error。
- 将 remainingElementsCount.[[Value]] 设置为 remainingElementsCount.[[Value]] - 1。
- 如果 remainingElementsCount.[[Value]] = 0，则
- 令 aggregateError 为一个新创建的
AggregateError 对象。 - 执行 !
DefinePropertyOrThrow (aggregateError,"errors" , PropertyDescriptor { [[Configurable]]:true , [[Enumerable]]:false , [[Writable]]:true , [[Value]]:CreateArrayFromList (errors) })。 - 返回 ?
Call (resultCapability.[[Reject]],undefined , « aggregateError »)。
- 令 aggregateError 为一个新创建的
- 返回
undefined 。
- 令 activeFunc 为
- 令 onRejected 为
CreateBuiltinFunction (rejectedSteps, 1,"" , « [[AlreadyCalled]], [[Index]] »)。 - 将 onRejected.[[AlreadyCalled]] 设置为
false 。 - 将 onRejected.[[Index]] 设置为 index。
- 将 index 设置为 index + 1。
- 将 remainingElementsCount.[[Value]] 设置为 remainingElementsCount.[[Value]] + 1。
- 执行 ?
Invoke (nextPromise,"then" , « resultCapability.[[Resolve]], onRejected »)。
- 令 next 为 ?
27.5.4.4 Promise.prototype
Promise.prototype 的初始值是
此属性具有特性 { [[Writable]]:
27.5.4.5 Promise.race ( iterable )
此函数返回一个新的 promise，其敲定方式与第一个被敲定的所传 promise 相同。它在运行此算法时会将所传 iterable 的所有元素解决为 promise。
- 令 ctor 为
this 值。 - 令 promiseCapability 为 ?
NewPromiseCapability (ctor)。 - 令 promiseResolve 为
Completion (GetPromiseResolve (ctor))。 IfAbruptRejectPromise (promiseResolve, promiseCapability)。- 令 iteratorRecord 为
Completion (GetIterator (iterable,sync ))。 IfAbruptRejectPromise (iteratorRecord, promiseCapability)。- 令 result 为
Completion (PerformPromiseRace (iteratorRecord, ctor, promiseCapability, promiseResolve))。 - 如果 result 是 abrupt completion，则
- 如果 iteratorRecord.[[Done]] 是
false ，则将 result 设置为Completion (IteratorClose (iteratorRecord, result))。 IfAbruptRejectPromise (result, promiseCapability)。
- 如果 iteratorRecord.[[Done]] 是
- 返回 ! result。
如果 iterable 实参不产生任何值，或者如果 iterable 产生的 promise 都永远不敲定，则此方法返回的待定 promise 永远不会被敲定。
此函数期望其 resolve 方法。
27.5.4.5.1 PerformPromiseRace ( iteratorRecord, ctor, resultCapability, promiseResolve )
The abstract operation PerformPromiseRace takes arguments iteratorRecord (an
- 重复，
- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 是
done ，则- 返回 resultCapability.[[Promise]]。
- 令 nextPromise 为 ?
Call (promiseResolve, ctor, « next »)。 - 执行 ?
Invoke (nextPromise,"then" , « resultCapability.[[Resolve]], resultCapability.[[Reject]] »)。
- 令 next 为 ?
27.5.4.6 Promise.reject ( reason )
此函数返回一个以传入实参拒绝的新 promise。
- 令 ctor 为
this 值。 - 令 promiseCapability 为 ?
NewPromiseCapability (ctor)。 - 执行 ?
Call (promiseCapability.[[Reject]],undefined , « reason »)。 - 返回 promiseCapability.[[Promise]]。
此函数期望其
27.5.4.7 Promise.resolve ( resolution )
此函数要么返回一个以所传实参解决的新 promise，要么如果该实参是由此构造器产生的 promise，则返回该实参自身。
- 令 ctor 为
this 值。 - 如果 ctor 不是 Object，则抛出
TypeError 异常。 - 返回 ?
PromiseResolve (ctor, resolution)。
此函数期望其
27.5.4.7.1 PromiseResolve ( ctor, resolution )
The abstract operation PromiseResolve takes arguments ctor (an Object) and resolution (an ECMAScript language value) and returns either a normal completion containing an Object or a throw completion. 它返回一个以 resolution 解决的新 promise。 It performs the following steps when called:
- 如果
IsPromise (resolution) 是true ，则 - 令 promiseCapability 为 ?
NewPromiseCapability (ctor)。 - 执行 ?
Call (promiseCapability.[[Resolve]],undefined , « resolution »)。 - 返回 promiseCapability.[[Promise]]。
27.5.4.8 Promise.try ( callback, ...args )
此函数在被调用时执行以下步骤：
- 令 ctor 为
this 值。 - 如果 ctor 不是 Object，则抛出
TypeError 异常。 - 令 promiseCapability 为 ?
NewPromiseCapability (ctor)。 - 令 status 为
Completion (Call (callback,undefined , args))。 - 如果 status 是 abrupt completion，则
- 执行 ?
Call (promiseCapability.[[Reject]],undefined , « status.[[Value]] »)。
- 执行 ?
- 否则，
- 执行 ?
Call (promiseCapability.[[Resolve]],undefined , « status.[[Value]] »)。
- 执行 ?
- 返回 promiseCapability.[[Promise]]。
此函数期望其
27.5.4.9 Promise.withResolvers ( )
此函数返回一个具有三个属性的对象：一个新的 promise，以及与其关联的 resolve 和 reject 函数。
- 令 ctor 为
this 值。 - 令 promiseCapability 为 ?
NewPromiseCapability (ctor)。 - 令 obj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 !
CreateDataPropertyOrThrow (obj,"promise" , promiseCapability.[[Promise]])。 - 执行 !
CreateDataPropertyOrThrow (obj,"resolve" , promiseCapability.[[Resolve]])。 - 执行 !
CreateDataPropertyOrThrow (obj,"reject" , promiseCapability.[[Reject]])。 - 返回 obj。
27.5.4.10 get Promise [ %Symbol.species% ]
Promise[%Symbol.species%] 是
- 返回
this 值。
此函数的
Promise 原型方法通常使用其
27.5.5 Promise 原型对象的属性
Promise 原型对象：
- 是 %Promise.prototype%。
- 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是
普通对象 。 - 没有 [[PromiseState]] 内部槽，也没有 Promise 实例的任何其他内部槽。
27.5.5.1 Promise.prototype.catch ( onRejected )
此方法在被调用时执行以下步骤：
- 令 promise 为
this 值。 - 返回 ?
Invoke (promise,"then" , «undefined , onRejected »)。
27.5.5.2 Promise.prototype.constructor
Promise.prototype.constructor 的初始值是
27.5.5.3 Promise.prototype.finally ( onFinally )
此方法在被调用时执行以下步骤：
- 令 promise 为
this 值。 - 如果 promise 不是 Object，则抛出
TypeError 异常。 - 令 ctor 为 ?
SpeciesConstructor (promise,%Promise% )。 - 断言：
IsConstructor (ctor) 是true 。 - 如果
IsCallable (onFinally) 是false ，则- 令 thenFinally 为 onFinally。
- 令 catchFinally 为 onFinally。
- 否则，
- 令 thenFinallyClosure 为一个新的
Abstract Closure ，其参数为 (value)，捕获 onFinally 和 ctor，并在被调用时执行以下步骤：- 令 result 为 ?
Call (onFinally,undefined )。 - 令 p 为 ?
PromiseResolve (ctor, result)。 - 令 returnValue 为一个新的无参数
Abstract Closure ，它捕获 value，并在被调用时执行以下步骤：- 返回
NormalCompletion (value)。
- 返回
- 令 valueThunk 为
CreateBuiltinFunction (returnValue, 0,"" , « »)。 - 返回 ?
Invoke (p,"then" , « valueThunk »)。
- 令 result 为 ?
- 令 thenFinally 为
CreateBuiltinFunction (thenFinallyClosure, 1,"" , « »)。 - 令 catchFinallyClosure 为一个新的
Abstract Closure ，其参数为 (reason)，捕获 onFinally 和 ctor，并在被调用时执行以下步骤：- 令 result 为 ?
Call (onFinally,undefined )。 - 令 p 为 ?
PromiseResolve (ctor, result)。 - 令 throwReason 为一个新的无参数
Abstract Closure ，它捕获 reason，并在被调用时执行以下步骤：- 抛出 reason。
- 令 thrower 为
CreateBuiltinFunction (throwReason, 0,"" , « »)。 - 返回 ?
Invoke (p,"then" , « thrower »)。
- 令 result 为 ?
- 令 catchFinally 为
CreateBuiltinFunction (catchFinallyClosure, 1,"" , « »)。
- 令 thenFinallyClosure 为一个新的
- 返回 ?
Invoke (promise,"then" , « thenFinally, catchFinally »)。
27.5.5.4 Promise.prototype.then ( onFulfilled, onRejected )
此方法在被调用时执行以下步骤：
- 令 promise 为
this 值。 - 如果
IsPromise (promise) 是false ，则抛出TypeError 异常。 - 令 ctor 为 ?
SpeciesConstructor (promise,%Promise% )。 - 令 resultCapability 为 ?
NewPromiseCapability (ctor)。 - 返回
PerformPromiseThen (promise, onFulfilled, onRejected, resultCapability)。
27.5.5.4.1 PerformPromiseThen ( promise, onFulfilled, onRejected [ , resultCapability ] )
The abstract operation PerformPromiseThen takes arguments promise (a Promise), onFulfilled (an ECMAScript language value), and onRejected (an ECMAScript language value) and optional argument resultCapability (a
- 断言：
IsPromise (promise) 是true 。 - 如果 resultCapability 不存在，则
- 将 resultCapability 设置为
undefined 。
- 将 resultCapability 设置为
- 如果
IsCallable (onFulfilled) 是false ，则- 令 onFulfilledJobCallback 为
empty 。
- 令 onFulfilledJobCallback 为
- 否则，
- 令 onFulfilledJobCallback 为
HostMakeJobCallback (onFulfilled)。
- 令 onFulfilledJobCallback 为
- 如果
IsCallable (onRejected) 是false ，则- 令 onRejectedJobCallback 为
empty 。
- 令 onRejectedJobCallback 为
- 否则，
- 令 onRejectedJobCallback 为
HostMakeJobCallback (onRejected)。
- 令 onRejectedJobCallback 为
- 令 fulfillReaction 为
PromiseReaction Record { [[Capability]]: resultCapability, [[Type]]:fulfill , [[Handler]]: onFulfilledJobCallback }。 - 令 rejectReaction 为
PromiseReaction Record { [[Capability]]: resultCapability, [[Type]]:reject , [[Handler]]: onRejectedJobCallback }。 - 如果 promise.[[PromiseState]] 是
pending ，则- 将 fulfillReaction 追加到 promise.[[PromiseFulfillReactions]]。
- 将 rejectReaction 追加到 promise.[[PromiseRejectReactions]]。
- 否则，如果 promise.[[PromiseState]] 是
fulfilled ，则- 令 value 为 promise.[[PromiseResult]]。
- 令 fulfillJob 为
NewPromiseReactionJob (fulfillReaction, value)。 - 执行
HostEnqueuePromiseJob (fulfillJob.[[Job]], fulfillJob.[[Realm]])。
- 否则，
- 断言：promise.[[PromiseState]] 是
rejected 。 - 令 reason 为 promise.[[PromiseResult]]。
- 如果 promise.[[PromiseIsHandled]] 是
false ，则执行HostPromiseRejectionTracker (promise,"handle" )。 - 令 rejectJob 为
NewPromiseReactionJob (rejectReaction, reason)。 - 执行
HostEnqueuePromiseJob (rejectJob.[[Job]], rejectJob.[[Realm]])。
- 断言：promise.[[PromiseState]] 是
- 将 promise.[[PromiseIsHandled]] 设置为
true 。 - 如果 resultCapability 是
undefined ，则返回undefined 。 - 返回 resultCapability.[[Promise]]。
27.5.5.5 Promise.prototype [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
27.5.6 Promise 实例的属性
Promise 实例是
| 内部槽 | 类型 | 描述 |
|---|---|---|
| [[PromiseState]] |
|
支配 promise 将如何对传入的 then 方法调用作出反应。
|
| [[PromiseResult]] |
|
promise 已被兑现或拒绝所用的值（如果有）。当且仅当 [[PromiseState]] 是 |
| [[PromiseFulfillReactions]] |
|
当/如果 promise 从 |
| [[PromiseRejectReactions]] |
|
当/如果 promise 从 |
| [[PromiseIsHandled]] | Boolean | 指示 promise 是否曾经具有兑现或拒绝 handler；用于未处理拒绝跟踪。 |
27.6 GeneratorFunction 对象
GeneratorFunction 是通常通过求值
27.6.1 GeneratorFunction 构造器
GeneratorFunction 构造器：
- 是 %GeneratorFunction%。
- 是
Function的子类。 - 在作为函数而不是构造器调用时创建并初始化一个新的 GeneratorFunction。因此，函数调用
GeneratorFunction (…)等价于具有相同实参的对象创建表达式new GeneratorFunction (…)。 - 可以用作类定义的
extends子句的值。意图继承指定 GeneratorFunction 行为的子类构造器，必须包含 对 GeneratorFunction 构造器的super调用，以创建并初始化具有内置 GeneratorFunction 行为所需内部槽的子类实例。所有用于定义 generator function 对象的 ECMAScript 语法形式都会创建 GeneratorFunction 的直接实例。没有语法方式可以创建 GeneratorFunction 子类的实例。
27.6.1.1 GeneratorFunction ( ...paramArgs, bodyArg )
最后一个实参（如果有）指定 generator function 的主体（可执行代码）；任何在前的实参指定形式参数。
此函数在被调用时执行以下步骤：
- 令 activeFunc 为
活动函数对象 。 - 如果 bodyArg 不存在，则将 bodyArg 设置为空 String。
- 返回 ?
CreateDynamicFunction (activeFunc, NewTarget,generator , paramArgs, bodyArg)。
见
27.6.2 GeneratorFunction 构造器的属性
GeneratorFunction 构造器：
- 是继承自 Function 构造器的标准内置
函数对象 。 - 具有一个 [[Prototype]] 内部槽，其值为
%Function% 。 - 具有一个
"length" 属性，其值为1 𝔽。 - 具有一个
"name" 属性，其值为"GeneratorFunction" 。 - 具有以下属性：
27.6.2.1 GeneratorFunction.prototype
GeneratorFunction.prototype 的初始值是
此属性具有特性 { [[Writable]]:
27.6.3 GeneratorFunction 原型对象的属性
GeneratorFunction 原型对象：
- 是 %GeneratorFunction.prototype%（见
Figure 6 ）。 - 是
普通对象 。 - 不是
函数对象 ，并且没有 [[ECMAScriptCode]] 内部槽，也没有Table 26 或Table 94 中列出的任何其他内部槽。 - 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。
27.6.3.1 GeneratorFunction.prototype.constructor
GeneratorFunction.prototype.constructor 的初始值是
此属性具有特性 { [[Writable]]:
27.6.3.2 GeneratorFunction.prototype.prototype
GeneratorFunction.prototype.prototype 的初始值是
此属性具有特性 { [[Writable]]:
27.6.3.3 GeneratorFunction.prototype [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
27.6.4 GeneratorFunction 实例
每个 GeneratorFunction 实例都是 ECMAScript
每个 GeneratorFunction 实例具有以下自有属性：
27.6.4.1 length
27.6.4.2 name
27.6.4.3 prototype
每当创建一个 GeneratorFunction 实例时，还会创建另一个
此属性具有特性 { [[Writable]]:
不同于 Function 实例，作为 GeneratorFunction 的
27.7 AsyncGeneratorFunction 对象
AsyncGeneratorFunction 是通常通过求值
27.7.1 AsyncGeneratorFunction 构造器
AsyncGeneratorFunction 构造器：
- 是 %AsyncGeneratorFunction%。
- 是
Function的子类。 - 在作为函数而不是构造器调用时创建并初始化一个新的 AsyncGeneratorFunction。因此，函数调用
AsyncGeneratorFunction (...)等价于具有相同实参的对象创建表达式new AsyncGeneratorFunction (...)。 - 可以用作类定义的
extends子句的值。意图继承指定 AsyncGeneratorFunction 行为的子类构造器，必须包含 对 AsyncGeneratorFunction 构造器的super调用，以创建并初始化具有内置 AsyncGeneratorFunction 行为所需内部槽的子类实例。所有用于定义 async generator function 对象的 ECMAScript 语法形式都会创建 AsyncGeneratorFunction 的直接实例。没有语法方式可以创建 AsyncGeneratorFunction 子类的实例。
27.7.1.1 AsyncGeneratorFunction ( ...paramArgs, bodyArg )
最后一个实参（如果有）指定 async generator function 的主体（可执行代码）；任何在前的实参指定形式参数。
此函数在被调用时执行以下步骤：
- 令 activeFunc 为
活动函数对象 。 - 如果 bodyArg 不存在，则将 bodyArg 设置为空 String。
- 返回 ?
CreateDynamicFunction (activeFunc, NewTarget,async-generator , paramArgs, bodyArg)。
见
27.7.2 AsyncGeneratorFunction 构造器的属性
AsyncGeneratorFunction 构造器：
- 是继承自 Function 构造器的标准内置
函数对象 。 - 具有一个 [[Prototype]] 内部槽，其值为
%Function% 。 - 具有一个
"length" 属性，其值为1 𝔽。 - 具有一个
"name" 属性，其值为"AsyncGeneratorFunction" 。 - 具有以下属性：
27.7.2.1 AsyncGeneratorFunction.prototype
AsyncGeneratorFunction.prototype 的初始值是
此属性具有特性 { [[Writable]]:
27.7.3 AsyncGeneratorFunction 原型对象的属性
AsyncGeneratorFunction 原型对象：
- 是 %AsyncGeneratorFunction.prototype%。
- 是
普通对象 。 - 不是
函数对象 ，并且没有 [[ECMAScriptCode]] 内部槽，也没有Table 26 或Table 95 中列出的任何其他内部槽。 - 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。
27.7.3.1 AsyncGeneratorFunction.prototype.constructor
AsyncGeneratorFunction.prototype.constructor 的初始值是
此属性具有特性 { [[Writable]]:
27.7.3.2 AsyncGeneratorFunction.prototype.prototype
AsyncGeneratorFunction.prototype.prototype 的初始值是
此属性具有特性 { [[Writable]]:
27.7.3.3 AsyncGeneratorFunction.prototype [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
27.7.4 AsyncGeneratorFunction 实例
每个 AsyncGeneratorFunction 实例都是 ECMAScript
每个 AsyncGeneratorFunction 实例具有以下自有属性：
27.7.4.1 length
此属性具有特性 { [[Writable]]:
27.7.4.2 name
27.7.4.3 prototype
每当创建一个 AsyncGeneratorFunction 实例时，还会创建另一个
此属性具有特性 { [[Writable]]:
不同于 function 实例，作为 AsyncGeneratorFunction 的
27.8 Generator 对象
Generator 通过调用 generator function 创建，并且同时符合
Generator 实例直接继承创建该实例的 generator function 的
27.8.1 %GeneratorPrototype% 对象
%GeneratorPrototype% 对象：
- 是 %GeneratorFunction.prototype.prototype%。
- 是
普通对象 。 - 不是 Generator 实例，并且没有 [[GeneratorState]] 内部槽。
- 具有一个 [[Prototype]] 内部槽，其值为
%Iterator.prototype% 。 - 具有由所有 Generator 实例间接继承的属性。
27.8.1.1 %GeneratorPrototype%.constructor
.constructor 的初始值是
此属性具有特性 { [[Writable]]:
27.8.1.2 %GeneratorPrototype%.next ( value )
- 返回 ?
GeneratorResume (this 值, value,empty )。
27.8.1.3 %GeneratorPrototype%.return ( value )
此方法在被调用时执行以下步骤：
- 令 gen 为
this 值。 - 令 completion 为
ReturnCompletion (value)。 - 返回 ?
GeneratorResumeAbrupt (gen, completion,empty )。
27.8.1.4 %GeneratorPrototype%.throw ( exception )
此方法在被调用时执行以下步骤：
- 令 gen 为
this 值。 - 令 completion 为
ThrowCompletion (exception)。 - 返回 ?
GeneratorResumeAbrupt (gen, completion,empty )。
27.8.1.5 %GeneratorPrototype% [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
27.8.2 Generator 实例的属性
Generator 实例最初创建时具有
| 内部槽 | 类型 | 描述 |
|---|---|---|
| [[GeneratorState]] |
|
generator 的当前执行状态。 |
| [[GeneratorContext]] |
|
执行此 generator 的代码时使用的执行上下文。 |
| [[GeneratorBrand]] |
String 或 |
用于区分不同种类 generator 的品牌。由 ECMAScript 源文本声明的 generator 的 [[GeneratorBrand]] 始终是 |
27.8.3 Generator 抽象操作
27.8.3.1 GeneratorStart ( gen, genBody )
The abstract operation GeneratorStart takes arguments gen (a Generator) and genBody (a
- 断言：gen.[[GeneratorState]] 是
suspended-start 。 - 令 genContext 为运行中的执行上下文。
- 将 genContext 的 Generator 组件设置为 gen。
- 令 closure 为一个新的无参数
Abstract Closure ，它捕获 genBody，并在被调用时执行以下步骤：- 令 acGenContext 为运行中的执行上下文。
- 令 acGen 为 acGenContext 的 Generator 组件。
- 如果 genBody 是
Parse Node ，则- 令 result 为 genBody 的求值的
Completion 。
- 令 result 为 genBody 的求值的
- 否则，
- 断言：genBody 是无参数
Abstract Closure 。 - 令 result 为
Completion (genBody())。
- 断言：genBody 是无参数
- 断言：如果我们返回到这里，则该 generator 要么抛出了异常，要么执行了隐式或显式 return。
- 从执行上下文栈中移除 acGenContext，并将执行上下文栈顶部的执行上下文恢复为运行中的执行上下文。
- 将 acGen.[[GeneratorState]] 设置为
completed 。 - 注：一旦 generator 进入
completed 状态，它就永远不会离开该状态，其关联执行上下文也永远不会恢复。此时可以丢弃与 acGen 关联的任何执行状态。 - 如果 result 是 normal completion，则
- 令 resultValue 为
undefined 。
- 令 resultValue 为
- 否则，如果 result 是 return completion，则
- 令 resultValue 为 result.[[Value]]。
- 否则，
- 断言：result 是 throw completion。
- 返回 ? result。
- 返回
NormalCompletion (CreateIteratorResultObject (resultValue,true ))。
- 设置 genContext 的代码求值状态，使得当该执行上下文恢复求值时，将以无实参调用 closure。
- 将 gen.[[GeneratorContext]] 设置为 genContext。
- 返回
unused 。
27.8.3.2 GeneratorValidate ( gen, genBrand )
The abstract operation GeneratorValidate takes arguments gen (an ECMAScript language value) and genBrand (a String or
- 执行 ?
RequireInternalSlot (gen, [[GeneratorState]])。 - 执行 ?
RequireInternalSlot (gen, [[GeneratorBrand]])。 - 如果 gen.[[GeneratorBrand]] 不是 genBrand，则抛出
TypeError 异常。 - 断言：gen 具有 [[GeneratorContext]] 内部槽。
- 令 state 为 gen.[[GeneratorState]]。
- 如果 state 是
executing ，则抛出TypeError 异常。 - 返回 state。
27.8.3.3 GeneratorResume ( gen, value, genBrand )
The abstract operation GeneratorResume takes arguments gen (an ECMAScript language value), value (an ECMAScript language value or
- 令 state 为 ?
GeneratorValidate (gen, genBrand)。 - 如果 state 是
completed ，则返回CreateIteratorResultObject (undefined ,true )。 - 断言：state 是
suspended-start 或suspended-yield 。 - 令 genContext 为 gen.[[GeneratorContext]]。
- 将 gen.[[GeneratorState]] 设置为
executing 。 - 返回 ?
RunSuspendedContext (genContext,NormalCompletion (value))。
27.8.3.4 GeneratorResumeAbrupt ( gen, abruptCompletion, genBrand )
The abstract operation GeneratorResumeAbrupt takes arguments gen (an ECMAScript language value), abruptCompletion (a return completion or a throw completion), and genBrand (a String or
- 令 state 为 ?
GeneratorValidate (gen, genBrand)。 - 如果 state 是
suspended-start ，则- 将 gen.[[GeneratorState]] 设置为
completed 。 - 注：一旦 generator 进入
completed 状态，它就永远不会离开该状态，其关联执行上下文也永远不会恢复。此时可以丢弃与 gen 关联的任何执行状态。 - 将 state 设置为
completed 。
- 将 gen.[[GeneratorState]] 设置为
- 如果 state 是
completed ，则- 如果 abruptCompletion 是 return completion，则
- 返回
CreateIteratorResultObject (abruptCompletion.[[Value]],true )。
- 返回
- 返回 ? abruptCompletion。
- 如果 abruptCompletion 是 return completion，则
- 断言：state 是
suspended-yield 。 - 令 genContext 为 gen.[[GeneratorContext]]。
- 将 gen.[[GeneratorState]] 设置为
executing 。 - 返回 ?
RunSuspendedContext (genContext, abruptCompletion)。
27.8.3.5 GetGeneratorKind ( )
The abstract operation GetGeneratorKind takes no arguments and returns
- 令 genContext 为运行中的执行上下文。
- 如果 genContext 没有 Generator 组件，则返回
non-generator 。 - 令 gen 为 genContext 的 Generator 组件。
- 如果 gen 具有 [[AsyncGeneratorState]] 内部槽，则返回
async 。 - 返回
sync 。
27.8.3.6 GeneratorYield ( iteratorResult )
The abstract operation GeneratorYield takes argument iteratorResult (an Object that conforms to the IteratorResult interface) and returns either a normal completion containing an ECMAScript language value or an abrupt completion. It performs the following steps when called:
- 令 genContext 为运行中的执行上下文。
- 断言：genContext 是一个生成器的执行上下文。
- 令 gen 为 genContext 的 Generator 组件的值。
- 断言：
GetGeneratorKind () 是sync 。 - 将 gen.[[GeneratorState]] 设置为
suspended-yield 。 - 返回 ?
RunCallerContext (iteratorResult)。
27.8.3.7 Yield ( arg )
The abstract operation Yield takes argument arg (an ECMAScript language value) and returns either a normal completion containing an ECMAScript language value or an abrupt completion. It performs the following steps when called:
- 令 genKind 为
GetGeneratorKind ()。 - 如果 genKind 是
async ，则返回 ?AsyncGeneratorYield (?Await (arg))。 - 返回 ?
GeneratorYield (CreateIteratorResultObject (arg,false ))。
27.8.3.8 CreateIteratorFromClosure ( closure, genBrand, genProto [ , extraSlots ] )
The abstract operation CreateIteratorFromClosure takes arguments closure (an
- 注：closure 可以
包含 Yield 操作的使用，以产生 IteratorResult 对象。 - 如果 extraSlots 不存在，则将 extraSlots 设置为新的空
List 。 - 令 internalSlotsList 为 extraSlots 和 « [[GeneratorState]], [[GeneratorContext]], [[GeneratorBrand]] » 的
列表连接 。 - 令 gen 为
OrdinaryObjectCreate (genProto, internalSlotsList)。 - 将 gen.[[GeneratorBrand]] 设置为 genBrand。
- 将 gen.[[GeneratorState]] 设置为
suspended-start 。 - 令 callerContext 为运行中的执行上下文。
- 令 calleeContext 为新的执行上下文。
- 将 calleeContext 的 Function 设置为
null 。 - 将 calleeContext 的
Realm 设置为当前 Realm Record 。 - 将 calleeContext 的 ScriptOrModule 设置为 callerContext 的 ScriptOrModule。
- 如果 callerContext 尚未挂起，则挂起 callerContext。
- 将 calleeContext 压入执行上下文栈；calleeContext 现在是运行中的执行上下文。
- 执行
GeneratorStart (gen, closure)。 - 从执行上下文栈中移除 calleeContext，并将 callerContext 恢复为运行中的执行上下文。
- 返回 gen。
27.9 AsyncGenerator 对象
AsyncGenerator 通过调用 async generator function 创建，并且同时符合
AsyncGenerator 实例直接继承创建该实例的 async generator function 的
27.9.1 %AsyncGeneratorPrototype% 对象
%AsyncGeneratorPrototype% 对象：
- 是 %AsyncGeneratorFunction.prototype.prototype%。
- 是
普通对象 。 - 不是 AsyncGenerator 实例，并且没有 [[AsyncGeneratorState]] 内部槽。
- 具有一个 [[Prototype]] 内部槽，其值为
%AsyncIteratorPrototype% 。 - 具有由所有 AsyncGenerator 实例间接继承的属性。
27.9.1.1 %AsyncGeneratorPrototype%.constructor
.constructor 的初始值是
此属性具有特性 { [[Writable]]:
27.9.1.2 %AsyncGeneratorPrototype%.next ( value )
- 令 gen 为
this 值。 - 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 result 为
Completion (AsyncGeneratorValidate (gen,empty ))。 IfAbruptRejectPromise (result, promiseCapability)。- 令 state 为 gen.[[AsyncGeneratorState]]。
- 如果 state 是
completed ，则- 令 iteratorResult 为
CreateIteratorResultObject (undefined ,true )。 - 执行 !
Call (promiseCapability.[[Resolve]],undefined , « iteratorResult »)。 - 返回 promiseCapability.[[Promise]]。
- 令 iteratorResult 为
- 令 completion 为
NormalCompletion (value)。 - 执行
AsyncGeneratorEnqueue (gen, completion, promiseCapability)。 - 如果 state 是
suspended-start 或suspended-yield ，则- 执行
AsyncGeneratorResume (gen, completion)。
- 执行
- 否则，
- 断言：state 是
executing 或draining-queue 。
- 断言：state 是
- 返回 promiseCapability.[[Promise]]。
27.9.1.3 %AsyncGeneratorPrototype%.return ( value )
- 令 gen 为
this 值。 - 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 result 为
Completion (AsyncGeneratorValidate (gen,empty ))。 IfAbruptRejectPromise (result, promiseCapability)。- 令 completion 为
ReturnCompletion (value)。 - 执行
AsyncGeneratorEnqueue (gen, completion, promiseCapability)。 - 令 state 为 gen.[[AsyncGeneratorState]]。
- 如果 state 是
suspended-start 或completed ，则- 将 gen.[[AsyncGeneratorState]] 设置为
draining-queue 。 - 执行
AsyncGeneratorAwaitReturn (gen)。
- 将 gen.[[AsyncGeneratorState]] 设置为
- 否则，如果 state 是
suspended-yield ，则- 执行
AsyncGeneratorResume (gen, completion)。
- 执行
- 否则，
- 断言：state 是
executing 或draining-queue 。
- 断言：state 是
- 返回 promiseCapability.[[Promise]]。
27.9.1.4 %AsyncGeneratorPrototype%.throw ( exception )
- 令 gen 为
this 值。 - 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 result 为
Completion (AsyncGeneratorValidate (gen,empty ))。 IfAbruptRejectPromise (result, promiseCapability)。- 令 state 为 gen.[[AsyncGeneratorState]]。
- 如果 state 是
suspended-start ，则- 将 gen.[[AsyncGeneratorState]] 设置为
completed 。 - 将 state 设置为
completed 。
- 将 gen.[[AsyncGeneratorState]] 设置为
- 如果 state 是
completed ，则- 执行 !
Call (promiseCapability.[[Reject]],undefined , « exception »)。 - 返回 promiseCapability.[[Promise]]。
- 执行 !
- 令 completion 为
ThrowCompletion (exception)。 - 执行
AsyncGeneratorEnqueue (gen, completion, promiseCapability)。 - 如果 state 是
suspended-yield ，则- 执行
AsyncGeneratorResume (gen, completion)。
- 执行
- 否则，
- 断言：state 是
executing 或draining-queue 。
- 断言：state 是
- 返回 promiseCapability.[[Promise]]。
27.9.1.5 %AsyncGeneratorPrototype% [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
27.9.2 AsyncGenerator 实例的属性
AsyncGenerator 实例最初创建时具有下面描述的内部槽：
| 内部槽 | 类型 | 描述 |
|---|---|---|
| [[AsyncGeneratorState]] | async generator 的当前执行状态。 | |
| [[AsyncGeneratorContext]] | 执行此 async generator 的代码时使用的执行上下文。 | |
| [[AsyncGeneratorQueue]] | 表示恢复 async generator 请求的 |
|
| [[GeneratorBrand]] | String 或 |
用于区分不同种类 async generator 的品牌。由 ECMAScript 源文本声明的 async generator 的 [[GeneratorBrand]] 始终是 |
27.9.3 AsyncGenerator 抽象操作
27.9.3.1 AsyncGeneratorRequest Record
AsyncGeneratorRequest 是一种
它们具有以下字段：
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Completion]] | 应用来恢复 async generator 的 |
|
| [[Capability]] | 与此请求关联的 promise capability。 |
27.9.3.2 AsyncGeneratorStart ( gen, genBody )
The abstract operation AsyncGeneratorStart takes arguments gen (an AsyncGenerator) and genBody (a
- 断言：gen.[[AsyncGeneratorState]] 是
suspended-start 。 - 令 genContext 为运行中的执行上下文。
- 将 genContext 的 Generator 组件设置为 gen。
- 令 closure 为一个新的无参数
Abstract Closure ，它捕获 genBody，并在被调用时执行以下步骤：- 令 acGenContext 为运行中的执行上下文。
- 令 acGen 为 acGenContext 的 Generator 组件。
- 如果 genBody 是
Parse Node ，则- 令 result 为 genBody 的求值的
Completion 。
- 令 result 为 genBody 的求值的
- 否则，
- 断言：genBody 是无参数
Abstract Closure 。 - 令 result 为
Completion (genBody())。
- 断言：genBody 是无参数
- 断言：如果我们返回到这里，则该 async generator 要么抛出了异常，要么执行了隐式或显式 return。
- 从执行上下文栈中移除 acGenContext，并将执行上下文栈顶部的执行上下文恢复为运行中的执行上下文。
- 将 acGen.[[AsyncGeneratorState]] 设置为
draining-queue 。 - 如果 result 是 normal completion，则将 result 设置为
NormalCompletion (undefined )。 - 如果 result 是 return completion，则将 result 设置为
NormalCompletion (result.[[Value]])。 - 执行
AsyncGeneratorCompleteStep (acGen, result,true )。 - 执行
AsyncGeneratorDrainQueue (acGen)。 - 返回
NormalCompletion (undefined )。
- 设置 genContext 的代码求值状态，使得当该执行上下文恢复求值时，将以无实参调用 closure。
- 将 gen.[[AsyncGeneratorContext]] 设置为 genContext。
- 将 gen.[[AsyncGeneratorQueue]] 设置为新的空
List 。 - 返回
unused 。
27.9.3.3 AsyncGeneratorValidate ( gen, genBrand )
The abstract operation AsyncGeneratorValidate takes arguments gen (an ECMAScript language value) and genBrand (a String or
- 执行 ?
RequireInternalSlot (gen, [[AsyncGeneratorContext]])。 - 执行 ?
RequireInternalSlot (gen, [[AsyncGeneratorState]])。 - 执行 ?
RequireInternalSlot (gen, [[AsyncGeneratorQueue]])。 - 如果 gen.[[GeneratorBrand]] 不是 genBrand，则抛出
TypeError 异常。 - 返回
unused 。
27.9.3.4 AsyncGeneratorEnqueue ( gen, completion, promiseCapability )
The abstract operation AsyncGeneratorEnqueue takes arguments gen (an AsyncGenerator), completion (a
- 令 request 为
AsyncGeneratorRequest { [[Completion]]: completion, [[Capability]]: promiseCapability }。 - 将 request 追加到 gen.[[AsyncGeneratorQueue]]。
- 返回
unused 。
27.9.3.5 AsyncGeneratorCompleteStep ( gen, completion, done [ , realm ] )
The abstract operation AsyncGeneratorCompleteStep takes arguments gen (an AsyncGenerator), completion (a
- 断言：gen.[[AsyncGeneratorQueue]] 不是空。
- 令 next 为 gen.[[AsyncGeneratorQueue]] 的第一个元素。
- 从 gen.[[AsyncGeneratorQueue]] 中移除第一个元素。
- 令 promiseCapability 为 next.[[Capability]]。
- 令 value 为 completion.[[Value]]。
- 如果 completion 是 throw completion，则
- 执行 !
Call (promiseCapability.[[Reject]],undefined , « value »)。
- 执行 !
- 否则，
- 断言：completion 是 normal completion。
- 如果 realm 存在，则
- 令 oldRealm 为运行中的执行上下文的
Realm 。 - 将运行中的执行上下文的
Realm 设置为 realm。 - 令 iteratorResult 为
CreateIteratorResultObject (value, done)。 - 将运行中的执行上下文的
Realm 设置为 oldRealm。
- 令 oldRealm 为运行中的执行上下文的
- 否则，
- 令 iteratorResult 为
CreateIteratorResultObject (value, done)。
- 令 iteratorResult 为
- 执行 !
Call (promiseCapability.[[Resolve]],undefined , « iteratorResult »)。
- 返回
unused 。
27.9.3.6 AsyncGeneratorResume ( gen, completion )
The abstract operation AsyncGeneratorResume takes arguments gen (an AsyncGenerator) and completion (a
- 断言：gen.[[AsyncGeneratorState]] 是
suspended-start 或suspended-yield 。 - 令 genContext 为 gen.[[AsyncGeneratorContext]]。
- 将 gen.[[AsyncGeneratorState]] 设置为
executing 。 - 执行 !
RunSuspendedContext (genContext, completion)。 - 返回
unused 。
27.9.3.7 AsyncGeneratorUnwrapYieldResumption ( resumptionValue )
The abstract operation AsyncGeneratorUnwrapYieldResumption takes argument resumptionValue (a
- 如果 resumptionValue 不是 return completion，则返回 ? resumptionValue。
- 令 awaited 为
Completion (Await (resumptionValue.[[Value]]))。 - 如果 awaited 是 throw completion，则返回 ? awaited。
- 断言：awaited 是 normal completion。
- 返回
ReturnCompletion (awaited.[[Value]])。
27.9.3.8 AsyncGeneratorYield ( arg )
The abstract operation AsyncGeneratorYield takes argument arg (an ECMAScript language value) and returns either a normal completion containing an ECMAScript language value or an abrupt completion. It performs the following steps when called:
- 令 genContext 为运行中的执行上下文。
- 断言：genContext 是一个生成器的执行上下文。
- 令 gen 为 genContext 的 Generator 组件的值。
- 断言：
GetGeneratorKind () 是async 。 - 令 completion 为
NormalCompletion (arg)。 - 断言：执行上下文栈至少有两个元素。
- 令 previousContext 为执行上下文栈中从栈顶数第二个元素。
- 令 previousRealm 为 previousContext 的
Realm 。 - 执行
AsyncGeneratorCompleteStep (gen, completion,false , previousRealm)。 - 令 queue 为 gen.[[AsyncGeneratorQueue]]。
- 如果 queue 非空，则
- 注：执行会继续，而不会挂起该生成器。
- 令 toYield 为 queue 的第一个元素。
- 令 resumptionValue 为
Completion (toYield.[[Completion]])。 - 返回 ?
AsyncGeneratorUnwrapYieldResumption (resumptionValue)。
- 将 gen.[[AsyncGeneratorState]] 设置为
suspended-yield 。 - 令 resumptionValue 为
Completion (RunCallerContext (undefined ))。 - 返回 ?
AsyncGeneratorUnwrapYieldResumption (resumptionValue)。
27.9.3.9 AsyncGeneratorAwaitReturn ( gen )
The abstract operation AsyncGeneratorAwaitReturn takes argument gen (an AsyncGenerator) and returns
- 断言：gen.[[AsyncGeneratorState]] 是
draining-queue 。 - 令 queue 为 gen.[[AsyncGeneratorQueue]]。
- 断言：queue 不是空。
- 令 next 为 queue 的第一个元素。
- 令 completion 为
Completion (next.[[Completion]])。 - 断言：completion 是 return completion。
- 令 promiseCompletion 为
Completion (PromiseResolve (%Promise% , completion.[[Value]]))。 - 如果 promiseCompletion 是 abrupt completion，则
- 执行
AsyncGeneratorCompleteStep (gen, promiseCompletion,true )。 - 执行
AsyncGeneratorDrainQueue (gen)。 - 返回
unused 。
- 执行
- 断言：promiseCompletion 是 normal completion。
- 令 promise 为 promiseCompletion.[[Value]]。
- 令 fulfilledClosure 为一个新的
Abstract Closure ，其参数为 (value)，捕获 gen，并在被调用时执行以下步骤：- 断言：gen.[[AsyncGeneratorState]] 是
draining-queue 。 - 令 result 为
NormalCompletion (value)。 - 执行
AsyncGeneratorCompleteStep (gen, result,true )。 - 执行
AsyncGeneratorDrainQueue (gen)。 - 返回
NormalCompletion (undefined )。
- 断言：gen.[[AsyncGeneratorState]] 是
- 令 onFulfilled 为
CreateBuiltinFunction (fulfilledClosure, 1,"" , « »)。 - 令 rejectedClosure 为一个新的
Abstract Closure ，其参数为 (reason)，捕获 gen，并在被调用时执行以下步骤：- 断言：gen.[[AsyncGeneratorState]] 是
draining-queue 。 - 令 result 为
ThrowCompletion (reason)。 - 执行
AsyncGeneratorCompleteStep (gen, result,true )。 - 执行
AsyncGeneratorDrainQueue (gen)。 - 返回
NormalCompletion (undefined )。
- 断言：gen.[[AsyncGeneratorState]] 是
- 令 onRejected 为
CreateBuiltinFunction (rejectedClosure, 1,"" , « »)。 - 执行
PerformPromiseThen (promise, onFulfilled, onRejected)。 - 返回
unused 。
27.9.3.10 AsyncGeneratorDrainQueue ( gen )
The abstract operation AsyncGeneratorDrainQueue takes argument gen (an AsyncGenerator) and returns
- 断言：gen.[[AsyncGeneratorState]] 是
draining-queue 。 - 令 queue 为 gen.[[AsyncGeneratorQueue]]。
- 重复，只要 queue 不是空，
- 令 next 为 queue 的第一个元素。
- 令 completion 为
Completion (next.[[Completion]])。 - 如果 completion 是 return completion，则
- 执行
AsyncGeneratorAwaitReturn (gen)。 - 返回
unused 。
- 执行
- 如果 completion 是 normal completion，则
- 将 completion 设置为
NormalCompletion (undefined )。
- 将 completion 设置为
- 执行
AsyncGeneratorCompleteStep (gen, completion,true )。
- 将 gen.[[AsyncGeneratorState]] 设置为
completed 。 - 返回
unused 。
27.10 AsyncFunction 对象
AsyncFunction 是通常通过求值
27.10.1 AsyncFunction 构造器
AsyncFunction 构造器：
- 是 %AsyncFunction%。
- 是
Function的子类。 - 在作为函数而不是构造器调用时创建并初始化一个新的 AsyncFunction。因此，函数调用
AsyncFunction(…)等价于具有相同实参的对象创建表达式new AsyncFunction(…)。 - 可以用作类定义的
extends子句的值。意图继承指定 AsyncFunction 行为的子类构造器，必须包含 对 AsyncFunction 构造器的super调用，以创建并初始化具有内置 async function 行为所需内部槽的子类实例。所有用于定义 async function 对象的 ECMAScript 语法形式都会创建 AsyncFunction 的直接实例。没有语法方式可以创建 AsyncFunction 子类的实例。
27.10.1.1 AsyncFunction ( ...paramArgs, bodyArg )
最后一个实参（如果有）指定 async function 的主体（可执行代码）。任何在前的实参指定形式参数。
此函数在被调用时执行以下步骤：
- 令 activeFunc 为
活动函数对象 。 - 如果 bodyArg 不存在，则将 bodyArg 设置为空 String。
- 返回 ?
CreateDynamicFunction (activeFunc, NewTarget,async , paramArgs, bodyArg)。
27.10.2 AsyncFunction 构造器的属性
AsyncFunction 构造器：
- 是继承自 Function 构造器的标准内置
函数对象 。 - 具有一个 [[Prototype]] 内部槽，其值为
%Function% 。 - 具有一个
"length" 属性，其值为1 𝔽。 - 具有一个
"name" 属性，其值为"AsyncFunction" 。 - 具有以下属性：
27.10.2.1 AsyncFunction.prototype
AsyncFunction.prototype 的初始值是
此属性具有特性 { [[Writable]]:
27.10.3 AsyncFunction 原型对象的属性
AsyncFunction 原型对象：
- 是 %AsyncFunction.prototype%。
- 是
普通对象 。 - 不是
函数对象 ，并且没有 [[ECMAScriptCode]] 内部槽，也没有Table 26 中列出的任何其他内部槽。 - 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。
27.10.3.1 AsyncFunction.prototype.constructor
AsyncFunction.prototype.constructor 的初始值是
此属性具有特性 { [[Writable]]:
27.10.3.2 AsyncFunction.prototype [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
27.10.4 AsyncFunction 实例
每个 AsyncFunction 实例都是 ECMAScript
每个 AsyncFunction 实例具有以下自有属性：
27.10.4.1 length
27.10.4.2 name
27.10.5 Async Function 的抽象操作
27.10.5.1 AsyncFunctionStart ( promiseCapability, asyncFuncBody )
The abstract operation AsyncFunctionStart takes arguments promiseCapability (a
- 令 runningContext 为运行中的执行上下文。
- 令 asyncContext 为 runningContext 的副本。
- 注：复制执行状态是
AsyncBlockStart 恢复其执行所必需的。恢复一个当前正在执行的上下文是未良定义的。 - 执行
AsyncBlockStart (promiseCapability, asyncFuncBody, asyncContext)。 - 返回
unused 。
27.10.5.2 AsyncBlockStart ( promiseCapability, asyncBody, asyncContext )
The abstract operation AsyncBlockStart takes arguments promiseCapability (a
- 令 closure 为一个新的无参数
Abstract Closure ，它捕获 promiseCapability 和 asyncBody，并在被调用时执行以下步骤：- 令 acAsyncContext 为运行中的执行上下文。
- 如果 asyncBody 是
Parse Node ，则- 令 result 为 asyncBody 的求值的
Completion 。
- 令 result 为 asyncBody 的求值的
- 否则，
- 断言：asyncBody 是无参数
Abstract Closure 。 - 令 result 为
Completion (asyncBody())。
- 断言：asyncBody 是无参数
- 断言：如果我们返回到这里，则该 async function 要么抛出了异常，要么执行了隐式或显式 return；所有等待都已完成。
- 从执行上下文栈中移除 acAsyncContext，并将执行上下文栈顶部的执行上下文恢复为运行中的执行上下文。
- 如果 result 是 normal completion，则
- 执行 !
Call (promiseCapability.[[Resolve]],undefined , «undefined »)。
- 执行 !
- 否则，如果 result 是 return completion，则
- 执行 !
Call (promiseCapability.[[Resolve]],undefined , « result.[[Value]] »)。
- 执行 !
- 否则，
- 断言：result 是 throw completion。
- 执行 !
Call (promiseCapability.[[Reject]],undefined , « result.[[Value]] »)。
- 返回
NormalCompletion (unused )。
- 设置 asyncContext 的代码求值状态，使得当该执行上下文恢复求值时，将以无实参调用 closure。
- 令 result 为 !
RunSuspendedContext (asyncContext,NormalCompletion (empty ))。 - 断言：result 是
unused 。 - 注：result 值的可能来源是
Await ，或者如果 async function 没有等待任何内容，则为上面的步骤1.i 。 - 返回
unused 。
27.10.5.3 Await ( arg )
The abstract operation Await takes argument arg (an ECMAScript language value) and returns either a normal completion containing either an ECMAScript language value or
- 令 asyncContext 为运行中的执行上下文。
- 令 promise 为 ?
PromiseResolve (%Promise% , arg)。 - 令 fulfilledClosure 为一个新的抽象闭包，其参数为 (v)，它捕获 asyncContext 并在被调用时执行以下步骤：
- 执行
Completion (RunSuspendedContext (asyncContext,NormalCompletion (v)))。 - 注：
RunSuspendedContext 返回的完成记录会被有意忽略。 - 返回
NormalCompletion (undefined )。
- 执行
- 令 onFulfilled 为
CreateBuiltinFunction (fulfilledClosure, 1,"" , « »)。 - 令 rejectedClosure 为一个新的抽象闭包，其参数为 (reason)，它捕获 asyncContext 并在被调用时执行以下步骤：
- 执行
Completion (RunSuspendedContext (asyncContext,ThrowCompletion (reason)))。 - 注：
RunSuspendedContext 返回的完成记录会被有意忽略。 - 返回
NormalCompletion (undefined )。
- 执行
- 令 onRejected 为
CreateBuiltinFunction (rejectedClosure, 1,"" , « »)。 - 执行
PerformPromiseThen (promise, onFulfilled, onRejected)。 - 返回 ?
RunCallerContext (empty )。
28 反射
28.1 Reflect 对象
Reflect 对象：
- 是 %Reflect%。
- 是
全局对象 的"Reflect" 属性的初始值。 - 是
普通对象 。 - 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 不是
函数对象 。 - 没有 [[Construct]] 内部方法；不能与
new运算符一起用作构造器。 - 没有 [[Call]] 内部方法；不能作为函数调用。
28.1.1 Reflect.apply ( target, thisArg, args )
此函数在被调用时执行以下步骤：
- 如果
IsCallable (target) 是false ，则抛出TypeError 异常。 - 令 argList 为 ?
CreateListFromArrayLike (args)。 - 执行
PrepareForTailCall ()。 - 返回 ?
Call (target, thisArg, argList)。
28.1.2 Reflect.construct ( target, args [ , newTarget ] )
此函数在被调用时执行以下步骤：
- 如果
IsConstructor (target) 是false ，则抛出TypeError 异常。 - 如果 newTarget 不存在，则将 newTarget 设置为 target。
- 否则，如果
IsConstructor (newTarget) 是false ，则抛出TypeError 异常。 - 令 argList 为 ?
CreateListFromArrayLike (args)。 - 返回 ?
Construct (target, argList, newTarget)。
28.1.3 Reflect.defineProperty ( target, key, attrs )
此函数在被调用时执行以下步骤：
- 如果 target 不是 Object，则抛出
TypeError 异常。 - 令 propertyKey 为 ?
ToPropertyKey (key)。 - 令 propertyDesc 为 ?
ToPropertyDescriptor (attrs)。 - 返回 ? target.[[DefineOwnProperty]](propertyKey, propertyDesc)。
28.1.4 Reflect.deleteProperty ( target, key )
此函数在被调用时执行以下步骤：
- 如果 target 不是 Object，则抛出
TypeError 异常。 - 令 propertyKey 为 ?
ToPropertyKey (key)。 - 返回 ? target.[[Delete]](propertyKey)。
28.1.5 Reflect.get ( target, key [ , receiver ] )
此函数在被调用时执行以下步骤：
- 如果 target 不是 Object，则抛出
TypeError 异常。 - 令 propertyKey 为 ?
ToPropertyKey (key)。 - 如果 receiver 不存在，则
- 将 receiver 设置为 target。
- 返回 ? target.[[Get]](propertyKey, receiver)。
28.1.6 Reflect.getOwnPropertyDescriptor ( target, key )
此函数在被调用时执行以下步骤：
- 如果 target 不是 Object，则抛出
TypeError 异常。 - 令 propertyKey 为 ?
ToPropertyKey (key)。 - 令 propertyDesc 为 ? target.[[GetOwnProperty]](propertyKey)。
- 返回
FromPropertyDescriptor (propertyDesc)。
28.1.7 Reflect.getPrototypeOf ( target )
此函数在被调用时执行以下步骤：
- 如果 target 不是 Object，则抛出
TypeError 异常。 - 返回 ? target.[[GetPrototypeOf]]()。
28.1.8 Reflect.has ( target, key )
此函数在被调用时执行以下步骤：
- 如果 target 不是 Object，则抛出
TypeError 异常。 - 令 propertyKey 为 ?
ToPropertyKey (key)。 - 返回 ? target.[[HasProperty]](propertyKey)。
28.1.9 Reflect.isExtensible ( target )
此函数在被调用时执行以下步骤：
- 如果 target 不是 Object，则抛出
TypeError 异常。 - 返回 ? target.[[IsExtensible]]()。
28.1.10 Reflect.ownKeys ( target )
此函数在被调用时执行以下步骤：
- 如果 target 不是 Object，则抛出
TypeError 异常。 - 令 keys 为 ? target.[[OwnPropertyKeys]]()。
- 返回
CreateArrayFromList (keys)。
28.1.11 Reflect.preventExtensions ( target )
此函数在被调用时执行以下步骤：
- 如果 target 不是 Object，则抛出
TypeError 异常。 - 返回 ? target.[[PreventExtensions]]()。
28.1.12 Reflect.set ( target, key, value [ , receiver ] )
此函数在被调用时执行以下步骤：
- 如果 target 不是 Object，则抛出
TypeError 异常。 - 令 propertyKey 为 ?
ToPropertyKey (key)。 - 如果 receiver 不存在，则
- 将 receiver 设置为 target。
- 返回 ? target.[[Set]](propertyKey, value, receiver)。
28.1.13 Reflect.setPrototypeOf ( target, proto )
此函数在被调用时执行以下步骤：
- 如果 target 不是 Object，则抛出
TypeError 异常。 - 如果 proto 不是 Object 且 proto 不是
null ，则抛出TypeError 异常。 - 返回 ? target.[[SetPrototypeOf]](proto)。
28.1.14 Reflect [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
28.2 Proxy 对象
28.2.1 Proxy 构造器
Proxy 构造器：
- 是 %Proxy%。
- 是
全局对象 的"Proxy" 属性的初始值。 - 在作为构造器调用时创建并初始化一个新的 Proxy 对象。
- 不意图作为函数调用，并且以这种方式调用时会抛出异常。
28.2.1.1 Proxy ( target, handler )
此函数在被调用时执行以下步骤：
- 如果 NewTarget 是
undefined ，则抛出TypeError 异常。 - 返回 ?
ProxyCreate (target, handler)。
28.2.2 Proxy 构造器的属性
Proxy 构造器：
- 具有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 没有
"prototype" 属性，因为 Proxy 对象没有需要初始化的 [[Prototype]] 内部槽。 - 具有以下属性：
28.2.2.1 Proxy.revocable ( target, handler )
此函数创建一个可撤销的 Proxy 对象。
它在被调用时执行以下步骤：
- 令 proxy 为 ?
ProxyCreate (target, handler)。 - 令 revokerClosure 为一个新的
Abstract Closure ，它没有参数、不捕获任何内容，并在被调用时执行以下步骤：- 令 activeFunc 为
活动函数对象 。 - 令 revocableProxy 为 activeFunc.[[RevocableProxy]]。
- 如果 revocableProxy 为
null ，则返回NormalCompletion (undefined )。 - 将 activeFunc.[[RevocableProxy]] 设为
null 。 - 断言：revocableProxy 是一个
Proxy 异质对象 。 - 将 revocableProxy.[[ProxyTarget]] 设为
null 。 - 将 revocableProxy.[[ProxyHandler]] 设为
null 。 - 返回
NormalCompletion (undefined )。
- 令 activeFunc 为
- 令 revoker 为
CreateBuiltinFunction (revokerClosure, 0,"" , « [[RevocableProxy]] »)。 - 将 revoker.[[RevocableProxy]] 设为 proxy。
- 令 result 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 !
CreateDataPropertyOrThrow (result,"proxy" , proxy)。 - 执行 !
CreateDataPropertyOrThrow (result,"revoke" , revoker)。 - 返回 result。
28.3 Module Namespace 对象
Module Namespace Object 是一种 module namespace exotic object，它提供对模块导出绑定的运行时基于属性的访问。Module Namespace Object 没有
除了
28.3.1 %Symbol.toStringTag%
此属性具有特性 { [[Writable]]:
29 内存模型
内存一致性模型，或称内存模型，指定
内存模型被定义为对在求值期间由 SharedArrayBuffer 上的
29.1 内存模型基础
共享内存访问（读和写）分为两组：原子访问和数据访问，定义如下。原子访问是顺序一致的，即，在一个
不支持弱于顺序一致且强于无序的排序，例如 release-acquire。
Shared Data Block event 是 ReadSharedMemory、WriteSharedMemory 或 ReadModifyWriteSharedMemory
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Order]] | ||
| [[NoTear]] | Boolean | 此事件是否允许从与此事件 |
| [[Block]] | 该事件操作的块。 | |
| [[ByteIndex]] | 非负整数 | [[Block]] 中该读的字节地址。 |
| [[ElementSize]] | 非负整数 | 该读的大小。 |
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Order]] | ||
| [[NoTear]] | Boolean | 此事件是否允许被与此事件 |
| [[Block]] | 该事件操作的块。 | |
| [[ByteIndex]] | 非负整数 | [[Block]] 中该写的字节地址。 |
| [[ElementSize]] | 非负整数 | 该写的大小。 |
| [[Payload]] | 将被其他事件读取的 |
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Order]] | 读-改-写事件总是顺序一致的。 | |
| [[NoTear]] | 读-改-写事件不能撕裂。 | |
| [[Block]] | 该事件操作的块。 | |
| [[ByteIndex]] | 非负整数 | [[Block]] 中该读-改-写的字节地址。 |
| [[ElementSize]] | 非负整数 | 该读-改-写的大小。 |
| [[Payload]] | 要传给 [[ModifyOp]] 的 |
|
| [[ModifyOp]] | 一个 |
共享数据块事件由
令共享数据块事件 e 的内存范围为从 e.[[ByteIndex]]（
应予以考虑的postMessage）、启动和停止代理，以及通过共享内存以外的通道在代理集群内进行通信。对于某个特定执行 execution，这些事件由
在候选执行内，事件按下面定义的关系排序。
29.2 Agent Events Record
Agent Events Record 是具有以下字段的
| 字段名 | 值 | 含义 |
|---|---|---|
| [[AgentSignifier]] | 其求值产生了此排序的 |
|
| [[EventList]] | Memory event 的 |
在求值期间，事件被追加到该 |
| [[AgentSynchronizesWith]] | 由操作语义引入的 |
29.3 Chosen Value Record
Chosen Value Record 是具有以下字段的
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Event]] | 为此 chosen value 引入的 |
|
| [[ChosenValue]] | 在求值期间非确定性选择的字节。 |
29.4 Candidate Execution
| 字段名 | 值 | 含义 |
|---|---|---|
| [[EventsRecords]] | 将 |
|
| [[ChosenValues]] | 将 |
空 candidate execution 是其字段为空
29.5 内存模型的抽象操作
29.5.1 EventSet ( execution )
The abstract operation EventSet takes argument execution (a
- 令 events 为空 Set。
- 对 execution.[[EventsRecords]] 的每个
Agent Events Record eventsRecord，执行：- 对 eventsRecord.[[EventList]] 的每个 Memory event event，执行：
- 将 event 添加到 events。
- 对 eventsRecord.[[EventList]] 的每个 Memory event event，执行：
- 返回 events。
29.5.2 SharedDataBlockEventSet ( execution )
The abstract operation SharedDataBlockEventSet takes argument execution (a
- 令 events 为空 Set。
- 对
EventSet (execution) 的每个 Memory event event，执行：- 如果 event 是
Shared Data Block event ，则将 event 添加到 events。
- 如果 event 是
- 返回 events。
29.5.3 HostEventSet ( execution )
The abstract operation HostEventSet takes argument execution (a
- 返回一个新的 Set，其中
包含 EventSet (execution) 中所有不在SharedDataBlockEventSet (execution) 中的元素。
29.5.4 ComposeWriteEventBytes ( execution, byteIndex, writes )
The abstract operation ComposeWriteEventBytes takes arguments execution (a
- 令 byteLocation 为 byteIndex。
- 令 bytesRead 为新的空
List 。 - 对 writes 的每个元素 writeEvent，执行：
- 断言：writeEvent 的
内存范围 包含 byteLocation。 - 令 payloadIndex 为 byteLocation - writeEvent.[[ByteIndex]]。
- 如果 writeEvent 是
WriteSharedMemory event，则- 令 byte 为 writeEvent.[[Payload]][payloadIndex]。
- 否则，
- 断言：writeEvent 是
ReadModifyWriteSharedMemory event。 - 令 bytes 为
ValueOfReadEvent (execution, writeEvent)。 - 令 bytesModified 为 writeEvent.[[ModifyOp]](bytes, writeEvent.[[Payload]])。
- 令 byte 为 bytesModified[payloadIndex]。
- 断言：writeEvent 是
- 将 byte 追加到 bytesRead。
- 将 byteLocation 设置为 byteLocation + 1。
- 断言：writeEvent 的
- 返回 bytesRead。
读-改-写修改 [[ModifyOp]] 由 Atomics 对象上引入
此
29.5.5 ValueOfReadEvent ( execution, readEvent )
The abstract operation ValueOfReadEvent takes arguments execution (a
- 令 writes 为 execution 中的
reads-bytes-from (readEvent)。 - 断言：writes 是长度等于 readEvent.[[ElementSize]] 的
WriteSharedMemory 或ReadModifyWriteSharedMemory event 的List 。 - 返回
ComposeWriteEventBytes (execution, readEvent.[[ByteIndex]], writes)。
29.6 Candidate Execution 的关系
以下关系和数学函数以特定
29.6.1 is-agent-order-before
对于
- 对于事件 eventA 和 eventB，如果在 execution.[[EventsRecords]] 中存在某个
Agent Events Record eventsRecord，使得 eventsRecord.[[EventList]] 同时包含 eventA 和 eventB，并且 eventA 在 eventsRecord.[[EventList]] 的List 顺序中位于 eventB 之前，则 eventA 在 execution 中 is-agent-order-before eventB。
29.6.2 reads-bytes-from
对于
-
对于
SharedDataBlockEventSet (execution) 中的每个ReadSharedMemory 或ReadModifyWriteSharedMemory event readEvent，execution 中的 reads-bytes-from(readEvent) 是长度为 readEvent.[[ElementSize]] 的List ，其元素是WriteSharedMemory 或ReadModifyWriteSharedMemory event writes，使得以下全部为真。
29.6.3 reads-from
对于
- 对于事件 readEvent 和 writeEvent，如果
SharedDataBlockEventSet (execution) 同时包含 readEvent 和 writeEvent，并且 execution 中的reads-bytes-from (readEvent)包含 writeEvent，则 readEvent 在 execution 中 reads-from writeEvent。
29.6.4 host-synchronizes-with
对于
- 如果 eventA 在 execution 中 host-synchronizes-with eventB，则
HostEventSet (execution)包含 eventA 和 eventB。 - 在 execution 中，host-synchronizes-with 与
is-agent-order-before 的并集中没有环。
对于
此关系允许postMessage。
29.6.5 synchronizes-with
对于
-
对于事件 readEvent 和 writeEvent，如果 readEvent 在 execution 中
reads-from writeEvent，readEvent.[[Order]] 是seq-cst ，writeEvent.[[Order]] 是seq-cst ，且 readEvent 和 writeEvent 具有相等的内存范围 ，则 writeEvent 在 execution 中 synchronizes-with readEvent。 -
对 execution.[[EventsRecords]] 的每个元素 eventsRecord，以下为真。
- 对于事件 eventA 和 eventB，如果 eventsRecord.[[AgentSynchronizesWith]]
包含 (eventA, eventB)，则 eventA 在 execution 中 synchronizes-with eventB。
- 对于事件 eventA 和 eventB，如果 eventsRecord.[[AgentSynchronizesWith]]
- 对于事件 eventA 和 eventB，如果 eventA 在 execution 中
host-synchronizes-with eventB，则 eventA 在 execution 中 synchronizes-with eventB。
由于
在
在
对于
29.6.6 happens-before
对于
-
对于事件 eventA 和 eventB，如果以下任一条件为真，则 eventA 在 execution 中 happens-before eventB。
- eventA 在 execution 中
is-agent-order-before eventB。 - eventA 在 execution 中
synchronizes-with eventB。 SharedDataBlockEventSet (execution) 同时包含 eventA 和 eventB，eventA.[[Order]] 是init ，且 eventA 和 eventB 具有重叠的内存范围 。- 存在事件 eventC，使得 eventA 在 execution 中 happens-before eventC，并且 eventC 在 execution 中 happens-before eventB。
- eventA 在 execution 中
因为 happens-before 是
29.7 有效执行的属性
29.7.1 有效的 Chosen Read
如果以下算法返回
- 对
SharedDataBlockEventSet (execution) 的每个ReadSharedMemory 或ReadModifyWriteSharedMemory event readEvent，执行：- 令 chosenValueRecord 为 execution.[[ChosenValues]] 中其 [[Event]] 字段为 readEvent 的元素。
- 令 chosenValue 为 chosenValueRecord.[[ChosenValue]]。
- 令 readValue 为
ValueOfReadEvent (execution, readEvent)。 - 令 chosenLength 为 chosenValue 中元素的数量。
- 令 readLength 为 readValue 中元素的数量。
- 如果 chosenLength ≠ readLength，则
- 返回
false 。
- 返回
- 如果对于从 0（含）到 chosenLength（不含）
区间 内的某个整数 i，chosenValue[i] ≠ readValue[i]，则- 返回
false 。
- 返回
- 返回
true 。
29.7.2 相干读
如果以下算法返回
- 对
SharedDataBlockEventSet (execution) 的每个ReadSharedMemory 或ReadModifyWriteSharedMemory event readEvent，执行：- 令 writes 为 execution 中的
reads-bytes-from (readEvent)。 - 令 byteLocation 为 readEvent.[[ByteIndex]]。
- 对 writes 的每个元素 writeEvent，执行：
- 如果 readEvent 在 execution 中
happens-before writeEvent，则- 返回
false 。
- 返回
- 如果存在一个
WriteSharedMemory 或ReadModifyWriteSharedMemory event value，其内存范围 包含 byteLocation，使得 writeEvent 在 execution 中happens-before value，且 value 在 execution 中happens-before readEvent，则- 返回
false 。
- 返回
- 将 byteLocation 设置为 byteLocation + 1。
- 如果 readEvent 在 execution 中
- 令 writes 为 execution 中的
- 返回
true 。
29.7.3 无撕裂读
如果以下算法返回
- 对
SharedDataBlockEventSet (execution) 的每个ReadSharedMemory 或ReadModifyWriteSharedMemory event readEvent，执行：- 如果 readEvent.[[NoTear]] 是
true ，则- 断言：readEvent.[[ByteIndex]] 除以 readEvent.[[ElementSize]] 的余数为 0。
- 对满足如下条件的每个 Memory event writeEvent 执行：readEvent 在 execution 中
reads-from writeEvent，并且 writeEvent.[[NoTear]] 是true ：- 如果 readEvent 和 writeEvent 具有相等的
内存范围 ，并且存在 Memory event value，使得 value 和 writeEvent 具有相等的内存范围 ，value.[[NoTear]] 是true ，writeEvent 和 value 不是同一个Shared Data Block event ，且 readEvent 在 execution 中reads-from value，则- 返回
false 。
- 返回
- 如果 readEvent 和 writeEvent 具有相等的
- 如果 readEvent.[[NoTear]] 是
- 返回
true 。
当
直观地说，此要求表示，当通过整数
29.7.4 顺序一致的原子操作
对于
- 对于事件 eventA 和 eventB，如果 eventA 在 execution 中
happens-before eventB，则 eventA 在 execution 中 is-memory-order-before eventB。 -
对于满足 readEvent 在 execution 中
reads-from writeEvent 的事件 readEvent 和 writeEvent，SharedDataBlockEventSet (execution) 中不存在WriteSharedMemory 或ReadModifyWriteSharedMemory event value，使得 value.[[Order]] 是seq-cst ，writeEvent 在 execution 中 is-memory-order-before value，value 在 execution 中 is-memory-order-before readEvent，并且以下任一条件为真。- writeEvent 在 execution 中
synchronizes-with readEvent，并且 value 和 readEvent 具有相等的内存范围 。 - writeEvent
happens-before readEvent 且 value 在 execution 中happens-before readEvent，writeEvent.[[Order]] 是seq-cst ，并且 writeEvent 和 value 具有相等的内存范围 。 - writeEvent
happens-before readEvent 且 writeEvent 在 execution 中happens-before value，readEvent.[[Order]] 是seq-cst ，并且 value 和 readEvent 具有相等的内存范围 。
Note 1 此条款额外约束相等
内存范围 上的seq-cst 事件。 - writeEvent 在 execution 中
-
对于
SharedDataBlockEventSet (execution) 中的每个WriteSharedMemory 或ReadModifyWriteSharedMemory event writeEvent，如果 writeEvent.[[Order]] 是seq-cst ，则不存在无限多个ReadSharedMemory 或ReadModifyWriteSharedMemory event，它们在SharedDataBlockEventSet (execution) 中具有相等的内存范围 ，并且在 memory-order 中位于 writeEvent 之前。Note 2
如果
虽然 is-memory-order-before
29.7.5 有效执行
如果以下全部为真，则
宿主 为 execution 提供host-synchronizes-with 关系。- execution 允许存在作为
严格偏序 的happens-before 关系。 - execution 具有有效的 chosen read。
- execution 具有相干读。
- execution 具有无撕裂读。
- execution 具有顺序一致的原子操作。
所有程序至少有一个有效执行。
29.8 竞争
对于 execution execution，以及
- 如果 eventA 和 eventB 不是同一个
Shared Data Block event ，则- 如果并非 eventA 在 execution 中
happens-before eventB 且 eventB 在 execution 中happens-before eventA，则- 如果 eventA 是
WriteSharedMemory 或ReadModifyWriteSharedMemory event，eventB 是WriteSharedMemory 或ReadModifyWriteSharedMemory event，并且 eventA 和 eventB 没有不相交的内存范围 ，则- 返回
true 。
- 返回
- 如果 eventA 在 execution 中
reads-from eventB，或 eventB 在 execution 中reads-from eventA，则- 返回
true 。
- 返回
- 如果 eventA 是
- 如果并非 eventA 在 execution 中
- 返回
false 。
29.9 数据竞争
对于 execution execution，以及
29.10 数据竞争自由
如果 execution execution 中不存在两个在
如果程序的所有执行都是数据竞争自由的，则该程序是数据竞争自由的。
29.11 共享内存指南
以下是针对使用共享内存的 ECMAScript 程序员的指南。
我们建议保持程序
更一般地，即使程序不是
以下是针对为使用共享内存的程序编写编译器转换的 ECMAScript 实现者的指南。
最好允许大多数在单
令 agent-order slice 为与单个
令
在没有共享内存的情况下对 agent-order slice 有效的任何转换，在存在共享内存的情况下也是有效的，但有以下例外。
-
原子操作刻在石头上：程序转换不得导致任何 [[Order]] 为
seq-cst 的Shared Data Block event 从is-agent-order-before 关系中移除，也不得导致它们相互重排序，或在 agent-order slice 内与 [[Order]] 为unordered 的事件重排序。（实践中，对重排序的禁止会迫使编译器假定每个
seq-cst 操作都是同步，并包含 在最终的is-memory-order-before 关系中；在没有跨agent 程序分析的情况下，它通常也必须这样假定。它还会迫使编译器假定每个 callee 对 memory-order 的影响未知的调用都可能包含 seq-cst 操作。） -
读必须稳定：任何给定的共享内存读在一次执行中只能观察到单个值。
（例如，如果程序中语义上单个读被执行多次，则随后允许程序只观察到所读取值中的一个。称为 rematerialization 的转换可能违反此规则。）
-
写必须稳定：所有对共享内存的可观察写都必须源自一次执行中的程序语义。
（例如，转换不得引入某些可观察写，例如通过在较大位置上使用读-改-写操作来写入较小数据、向内存写入程序不可能写入的值，或将刚读取的值写回其读取位置，而该位置在读取之后可能已被另一个
agent 覆写。） -
可能读取值必须非空：程序转换不能导致共享内存读的可能读取值变为空。
（反直觉地，此规则实际上限制了对写的转换，因为写在
内存模型 中具有作用力，就其能被read event 读取而言。例如，写可以在两个seq-cst 操作之间移动、合并，有时也可重排序，但转换不得移除每个更新某个位置的写；必须保留某个写。）
仍然有效的转换示例包括：合并来自同一位置的多个非原子读、重排序非原子读、引入推测性非原子读、合并对同一位置的多个非原子写、重排序对不同位置的非原子写，以及即使影响终止也将非原子读提升出循环。通常要注意，别名化的
以下是针对为共享内存访问生成机器代码的 ECMAScript 实现者的指南。
对于LOCK 前缀的指令、ARM 上的 load-exclusive/store-exclusive 指令，以及 Power 上的 load-link/store-conditional 指令。
具体而言，
- 假定程序中的每个原子操作都是必要的。
- 原子操作永远不会彼此重排，也不会与非原子操作重排。
- 始终假定函数会执行原子操作。
- 原子操作绝不会实现为在更大数据上的读-改-写操作；如果平台没有适当大小的原子操作，则实现为非无锁原子操作。（我们已经假定每个平台都具有所有相关大小的普通内存访问操作。）
朴素代码生成使用以下模式：
- 常规 load 和 store 编译为单个 load 和 store 指令。
- 无锁原子 load 和 store 编译为完整（顺序一致）栅栏、常规 load 或 store，以及完整栅栏。
- 无锁原子读-改-写访问编译为完整栅栏、原子读-改-写指令序列，以及完整栅栏。
- 非无锁原子操作编译为获取 spinlock、完整栅栏、一系列非原子 load 和 store 指令、完整栅栏，以及释放 spinlock。
只要某个
在遵守
- 存在明显的平台相关改进，可以移除冗余栅栏。例如，在 x86 上，无锁原子 load 和 store 周围的栅栏总是可以省略，除了 store 之后的栅栏；并且无锁读-改-写指令不需要栅栏，因为这些都使用带
LOCK前缀的指令。在许多平台上存在几种强度的栅栏，并且可以在某些上下文中使用较弱栅栏而不破坏顺序一致性。 - 大多数现代平台都支持 ECMAScript 原子操作所需所有数据大小的无锁原子操作。如果需要非无锁原子操作，围绕原子操作主体的栅栏通常可以折叠到加锁和解锁步骤中。对于非无锁原子操作，最简单的解决方案是每个 SharedArrayBuffer 使用一个锁字。
- 还存在更复杂的平台相关局部改进，需要一些代码分析。例如，两个背靠背栅栏通常与单个栅栏具有相同效果，因此如果为连续的两个原子操作生成代码，只需用单个栅栏分隔它们。在 x86 上，甚至可以省略分隔原子 store 的单个栅栏，因为 store 之后的栅栏只用于将该 store 与后续 load 分隔开。
Annex A (informative) 语法摘要
A.1 词法语法
A.2 表达式
当处理该产生式的一个实例时
当处理该产生式的一个实例时
在处理产生式
的实例时，
在某些情形下，当处理该产生式的一个实例时
A.3 语句
在处理产生式
的实例时，
A.4 函数和类
当处理该产生式的一个实例时
当处理该产生式的一个实例时
A.5 脚本和模块
A.6 Number 转换
所有未由
A.7 时区偏移字符串格式
A.8 正则表达式
对于每个 \u u \u u
Annex B (normative) Web 浏览器的附加 ECMAScript 特性
当 ECMAScript
本附录中定义的一些特性在本附录中规定，另一些则在本文档主体中规定。
当某个特性在主体中规定时，它影响本文档的每个位置都会在彩色框中用“
本附录描述 Web 浏览器 ECMAScript
这些特性不被视为核心 ECMAScript 语言的一部分。程序员在编写新的 ECMAScript 代码时，不应使用或假定这些特性和行为的存在。除非实现是 Web 浏览器的一部分，或需要运行 Web 浏览器会遇到的同一类遗留 ECMAScript 代码，否则不鼓励 ECMAScript 实现实现这些特性。
B.1 附加语法
B.1.1 类 HTML 注释
语法
类似于
B.1.2 正则表达式模式
这种替代模式语法和语义只改变 BMP 模式的语法和语义。以下语法扩展
语法
当相同的左侧同时以 [+UnicodeMode] 和 [~UnicodeMode] 守卫出现时，是为了控制消歧优先级。
B.1.2.1 Static Semantics: 早期错误
- 如果任何源文本被此产生式匹配，则为语法错误。
此外，以下产生式的规则通过添加高亮文本进行修改：
-
如果第一个
ClassAtom 的IsCharacterClass 为true ，或第二个ClassAtom 的IsCharacterClass 为true 并且此产生式具有 [UnicodeMode] 参数，则为语法错误。 -
如果第一个
ClassAtom 的IsCharacterClass 为false ，第二个ClassAtom 的IsCharacterClass 为false ，且第一个ClassAtom 的CharacterValue 严格大于第二个ClassAtom 的CharacterValue ，则为语法错误。
-
如果
ClassAtomNoDash 的IsCharacterClass 为true ，或ClassAtom 的IsCharacterClass 为true 并且此产生式具有 [UnicodeMode] 参数，则为语法错误。 -
如果
ClassAtomNoDash 的IsCharacterClass 为false ，ClassAtom 的IsCharacterClass 为false ，且ClassAtomNoDash 的CharacterValue 严格大于ClassAtom 的CharacterValue ，则为语法错误。
B.1.2.2 Static Semantics: CountLeftCapturingParensWithin 和 CountLeftCapturingParensBefore
在
B.1.2.3 Static Semantics: IsCharacterClass
- 返回
false 。
B.1.2.4 Static Semantics: CharacterValue
- 返回 U+005C（REVERSE SOLIDUS）的数值。
- 令 codePoint 为由
ClassControlLetter 匹配的代码点。 - 令 i 为 codePoint 的数值。
- 返回 i 除以 32 的余数。
- 返回
LegacyOctalEscapeSequence 的 MV（见12.9.4.3 ）。
B.1.2.5 Runtime Semantics: CompileSubpattern
B.1.2.6 Runtime Semantics: CompileAssertion
B.1.2.7 Runtime Semantics: CompileAtom
除
- 令 charSet 为
包含 单个字符\U+005C（REVERSE SOLIDUS）的CharSet 。 - 返回
CharacterSetMatcher (regexpRecord, charSet,false , direction)。
- 令 char 为
ExtendedPatternCharacter 表示的字符。 - 令 charSet 为
包含 字符 char 的单元素CharSet 。 - 返回
CharacterSetMatcher (regexpRecord, charSet,false , direction)。
B.1.2.8 Runtime Semantics: CompileToCharSet
以下两个规则替换
- 令 charSet 为以 regexpRecord 为实参的第一个
ClassAtom 的CompileToCharSet 。 - 令 otherSet 为以 regexpRecord 为实参的第二个
ClassAtom 的CompileToCharSet 。 - 令 remainingSet 为以 regexpRecord 为实参的
ClassContents 的CompileToCharSet 。 - 令 rangeSet 为
CharacterRangeOrUnion (regexpRecord, charSet, otherSet)。 - 返回 rangeSet 和 remainingSet 的并集。
- 令 charSet 为以 regexpRecord 为实参的
ClassAtomNoDash 的CompileToCharSet 。 - 令 otherSet 为以 regexpRecord 为实参的
ClassAtom 的CompileToCharSet 。 - 令 remainingSet 为以 regexpRecord 为实参的
ClassContents 的CompileToCharSet 。 - 令 rangeSet 为
CharacterRangeOrUnion (regexpRecord, charSet, otherSet)。 - 返回 rangeSet 和 remainingSet 的并集。
此外，以下规则被添加到
- 令 charValue 为此
ClassEscape 的CharacterValue 。 - 令 char 为字符值为 charValue 的字符。
- 返回
包含 单个字符 char 的CharSet 。
\c 到达，其中该序列后面没有可接受的控制字符。B.1.2.8.1 CharacterRangeOrUnion ( regexpRecord, charSet, otherSet )
The abstract operation CharacterRangeOrUnion takes arguments regexpRecord (a
- 如果
HasEitherUnicodeFlag (regexpRecord) 是false ，则 - 返回
CharacterRange (charSet, otherSet)。
B.1.2.9 Static Semantics: ParsePattern ( patternText, u, v )
- 如果 v 是
true 且 u 是true ，则 - 否则，如果 v 是
true ，则 - 否则，如果 u 是
true ，则 - 否则，
- 返回 parseResult。
B.2 附加内置属性
当 ECMAScript
B.2.1 全局对象的附加属性
| 固有对象名称 | 全局名称 | ECMAScript 语言关联 |
|---|---|---|
|
|
|
escape 函数（ |
|
|
|
unescape 函数（ |
B.2.1.1 escape ( string )
此函数是
替换数值小于或等于 0x00FF 的代码单元时，使用形式为 %xx 的两位转义序列。替换数值严格大于 0x00FF 的代码单元时，使用形式为 %uxxxx 的四位转义序列。
它是 %escape% 固有对象。
它在被调用时执行以下步骤：
- 将 string 设置为 ?
ToString (string)。 - 令 length 为 string 的长度。
- 令 result 为空 String。
- 令 unescapedSet 为 ASCII word characters 和
"@*+-./" 的字符串连接 。 - 令 k 为 0。
- 重复，只要 k < length，
- 返回 result。
该编码部分基于 RFC 1738 中描述的编码，但本标准中规定的整个编码在上文中描述，不考虑 RFC 1738 的内容。此编码不反映 RFC 3986 对 RFC 1738 所作的变更。
B.2.1.2 unescape ( string )
此函数是escape 函数引入的转义序列都会被替换为它所表示的代码单元。
它是 %unescape% 固有对象。
它在被调用时执行以下步骤：
- 将 string 设置为 ?
ToString (string)。 - 令 length 为 string 的长度。
- 令 result 为空 String。
- 令 k 为 0。
- 重复，只要 k < length，
- 令 codeUnit 为 string 中索引 k 处的代码单元。
- 如果 codeUnit 是代码单元 0x0025（PERCENT SIGN），则
- 令 hexDigits 为空 String。
- 令 optionalAdvance 为 0。
- 如果 k + 5 < length 且 string 中索引 k + 1 处的代码单元是代码单元 0x0075（LATIN SMALL LETTER U），则
- 将 hexDigits 设置为 string 从 k + 2 到 k + 6 的子串。
- 将 optionalAdvance 设置为 5。
- 否则，如果 k + 3 ≤ length，则
- 将 hexDigits 设置为 string 从 k + 1 到 k + 3 的子串。
- 将 optionalAdvance 设置为 2。
- 令 parseResult 为
ParseText (hexDigits,HexDigits )。[~Sep] - 如果 parseResult 是
Parse Node ，则- 令 codeUnitNumber 为 parseResult 的 MV。
- 将 codeUnit 设置为其数值为 codeUnitNumber 的代码单元。
- 将 k 设置为 k + optionalAdvance。
- 将 result 设置为 result 和 codeUnit 的
字符串连接 。 - 将 k 设置为 k + 1。
- 返回 result。
B.2.2 String.prototype 对象的附加属性
B.2.2.1 String.prototype.substr ( start, length )
此方法返回将
它在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 执行 ?
RequireObjectCoercible (obj)。 - 令 string 为 ?
ToString (obj)。 - 令 size 为 string 的长度。
- 令 intStart 为 ?
ToIntegerOrInfinity (start)。 - 如果 intStart = -∞，则将 intStart 设置为 0。
- 否则，如果 intStart < 0，则将 intStart 设置为
max (size + intStart, 0)。 - 否则，将 intStart 设置为
min (intStart, size)。 - 如果 length 是
undefined ，则令 intLength 为 size；否则令 intLength 为 ?ToIntegerOrInfinity (length)。 - 将 intLength 设置为把 intLength 夹在 0 和 size 之间的结果。
- 令 intEnd 为
min (intStart + intLength, size)。 - 返回 string 从 intStart 到 intEnd 的子串。
此方法有意为泛型方法；它不要求其
B.2.2.2 String.prototype.anchor ( name )
此方法在被调用时执行以下步骤：
- 令 string 为
this 值。 - 返回 ?
CreateHTML (string,"a" ,"name" , name)。
B.2.2.2.1 CreateHTML ( contents, tag, attr, attrValue )
The abstract operation CreateHTML takes arguments contents (an ECMAScript language value), tag (a String), attr (a String), and attrValue (an ECMAScript language value) and returns either a normal completion containing a String or a throw completion. It performs the following steps when called:
- 执行 ?
RequireObjectCoercible (contents)。 - 令 contentsString 为 ?
ToString (contents)。 - 令 part1 为
"<" 和 tag 的字符串连接 。 - 如果 attr 不是空 String，则
- 令 attrValueString 为 ?
ToString (attrValue)。 - 令 escapedAttrValue 为与 attrValueString 相同的 String 值，但 attrValueString 中每个代码单元 0x0022（QUOTATION MARK）的出现都被替换为六个代码单元序列
""" 。 - 将 part1 设置为以下各项的
字符串连接 ：- part1
- 代码单元 0x0020（SPACE）
- attr
- 代码单元 0x003D（EQUALS SIGN）
- 代码单元 0x0022（QUOTATION MARK）
- escapedAttrValue
- 代码单元 0x0022（QUOTATION MARK）
- 令 attrValueString 为 ?
- 令 part2 为 part1 和
">" 的字符串连接 。 - 令 part3 为 part2 和 contentsString 的
字符串连接 。 - 令 part4 为 part3、
"</" 、tag 和">" 的字符串连接 。 - 返回 part4。
B.2.2.3 String.prototype.big ( )
此方法在被调用时执行以下步骤：
- 令 string 为
this 值。 - 返回 ?
CreateHTML (string,"big" ,"" ,"" )。
B.2.2.4 String.prototype.blink ( )
此方法在被调用时执行以下步骤：
- 令 string 为
this 值。 - 返回 ?
CreateHTML (string,"blink" ,"" ,"" )。
B.2.2.5 String.prototype.bold ( )
此方法在被调用时执行以下步骤：
- 令 string 为
this 值。 - 返回 ?
CreateHTML (string,"b" ,"" ,"" )。
B.2.2.6 String.prototype.fixed ( )
此方法在被调用时执行以下步骤：
- 令 string 为
this 值。 - 返回 ?
CreateHTML (string,"tt" ,"" ,"" )。
B.2.2.7 String.prototype.fontcolor ( colour )
此方法在被调用时执行以下步骤：
- 令 string 为
this 值。 - 返回 ?
CreateHTML (string,"font" ,"color" , colour)。
B.2.2.8 String.prototype.fontsize ( size )
此方法在被调用时执行以下步骤：
- 令 string 为
this 值。 - 返回 ?
CreateHTML (string,"font" ,"size" , size)。
B.2.2.9 String.prototype.italics ( )
此方法在被调用时执行以下步骤：
- 令 string 为
this 值。 - 返回 ?
CreateHTML (string,"i" ,"" ,"" )。
B.2.2.10 String.prototype.link ( url )
此方法在被调用时执行以下步骤：
- 令 string 为
this 值。 - 返回 ?
CreateHTML (string,"a" ,"href" , url)。
B.2.2.11 String.prototype.small ( )
此方法在被调用时执行以下步骤：
- 令 string 为
this 值。 - 返回 ?
CreateHTML (string,"small" ,"" ,"" )。
B.2.2.12 String.prototype.strike ( )
此方法在被调用时执行以下步骤：
- 令 string 为
this 值。 - 返回 ?
CreateHTML (string,"strike" ,"" ,"" )。
B.2.2.13 String.prototype.sub ( )
此方法在被调用时执行以下步骤：
- 令 string 为
this 值。 - 返回 ?
CreateHTML (string,"sub" ,"" ,"" )。
B.2.2.14 String.prototype.sup ( )
此方法在被调用时执行以下步骤：
- 令 string 为
this 值。 - 返回 ?
CreateHTML (string,"sup" ,"" ,"" )。
B.2.2.15 String.prototype.trimLeft ( )
首选属性
B.2.2.16 String.prototype.trimRight ( )
首选属性
B.2.3 Date.prototype 对象的附加属性
B.2.3.1 Date.prototype.getYear ( )
几乎所有用途都首选 getFullYear 方法，因为它避免了“2000 年问题”。
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this 值。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 tv 为 dateObj.[[DateValue]]。
- 如果 tv 是
NaN ，则返回NaN 。 - 返回
YearFromTime (LocalTime (tv)) -1900 𝔽。
B.2.3.2 Date.prototype.setYear ( year )
几乎所有用途都首选 setFullYear 方法，因为它避免了“2000 年问题”。
此方法在被调用时执行以下步骤：
- 令 dateObj 为
this 值。 - 执行 ?
RequireInternalSlot (dateObj, [[DateValue]])。 - 令 time 为 dateObj.[[DateValue]]。
- 令 year 为 ?
ToNumber (year)。 - 如果 time 是
NaN ，则将 time 设置为+0 𝔽；否则将 time 设置为LocalTime (time)。 - 令 fullYear 为
MakeFullYear (year)。 - 令 day 为
MakeDay (fullYear,MonthFromTime (time),DateFromTime (time))。 - 令 date 为
MakeDate (day,TimeWithinDay (time))。 - 令 utcTimestamp 为
TimeClip (UTC (date))。 - 将 dateObj.[[DateValue]] 设置为 utcTimestamp。
- 返回 utcTimestamp。
B.2.3.3 Date.prototype.toGMTString ( )
首选 toUTCString 方法。此方法主要是为与旧代码兼容而提供。
B.2.4 RegExp.prototype 对象的附加属性
B.2.4.1 RegExp.prototype.compile ( pattern, flags )
此方法在被调用时执行以下步骤：
- 令 obj 为
this 值。 - 执行 ?
RequireInternalSlot (obj, [[RegExpMatcher]])。 - 如果 pattern 是 Object 且 pattern 具有 [[RegExpMatcher]] 内部槽，则
- 如果 flags 不是
undefined ，则抛出TypeError 异常。 - 将 flags 设置为 pattern.[[OriginalFlags]]。
- 将 pattern 设置为 pattern.[[OriginalSource]]。
- 如果 flags 不是
- 返回 ?
RegExpInitialize (obj, pattern, flags)。
此方法用新的模式和标志完全重新初始化
B.3 其他附加特性
B.3.1 带标签的函数声明
在 ECMAScript 2015 之前，
B.3.2 块级函数声明的 Web 遗留兼容性语义
在 ECMAScript 2015 之前，ECMAScript 规范没有定义
-
函数在单个块内声明并且只在该块内引用。
-
一个或多个
FunctionDeclaration 出现在外围函数 g 的函数代码中，其BindingIdentifier 是名称 f，并且该声明嵌套在Block 内。 -
g 的函数代码中没有其他不是
var声明的 f 声明。 -
作为
IdentifierReference 的 f 的所有出现都位于包含 f 声明的Block 的StatementList 内。
-
一个或多个
-
函数在单个
Block 内声明并可能使用，但也被一个不包含 在同一Block 内的内部函数定义引用。-
一个或多个
FunctionDeclaration 出现在外围函数 g 的函数代码中，其BindingIdentifier 是名称 f，并且该声明嵌套在Block 内。 -
g 的函数代码中没有其他不是
var声明的 f 声明。 -
作为
IdentifierReference 的 f 可能出现在包含 f 声明的Block 的StatementList 内。 -
在嵌套于 g 内的另一个函数 h 中，至少有一次作为
IdentifierReference 的 f 出现，并且没有其他 f 声明遮蔽来自 h 内部的对 f 的引用。 - h 的所有调用都发生在 f 的声明已被求值之后。
-
一个或多个
-
函数在单个块内声明并可能使用，但也在后续块中被引用。
-
一个或多个
FunctionDeclaration 出现在外围函数 g 的函数代码中，其BindingIdentifier 是名称 f，并且该声明嵌套在Block 内。 -
g 的函数代码中没有其他不是
var声明的 f 声明。 -
作为
IdentifierReference 的 f 可能出现在包含 f 声明的Block 的StatementList 内。 -
g 的函数代码中至少有一次作为
IdentifierReference 的 f 出现，其词法位置位于包含 f 声明的Block 之后。
-
一个或多个
第一个用例与 ECMAScript 2015 为
第二和第三个用例的 ECMAScript 2015 可互操作性要求对条款
如果 ECMAScript 实现具有报告诊断警告消息的机制，则当代码
此特性在以下位置涉及特殊语义：
14.2.1 中Block : { StatementList } 早期错误 规则14.12.1 中SwitchStatement : switch ( Expression ) CaseBlock 早期错误 规则FunctionDeclarationInstantiation 中的步骤32.a BlockDeclarationInstantiation 中的步骤3.a.ii.1 BlockDeclarationInstantiation 中的步骤3.b.iii GlobalDeclarationInstantiation 中的步骤12 EvalDeclarationInstantiation 中的步骤13
B.3.3 IfStatement 语句子句中的 FunctionDeclaration
以下内容扩充
此产生式仅在解析非严格代码时适用。被此产生式
B.3.4 Catch 块中的 VariableStatement
在此特性中，var 声明，其绑定的名称也由
运行时，这类绑定在 VariableDeclarationEnvironment 中实例化。它们不会遮蔽由 var 声明的 var 绑定。
此修改后的行为也适用于var 和 function 声明。此变更通过修改
B.3.5 ForIn 语句头中的初始化器
以下内容扩充
此产生式仅在解析非严格代码时适用。
- 返回以 labelSet 为实参的
Statement 的ContainsDuplicateLabels 。
- 返回以 labelSet 为实参的
Statement 的ContainsUndefinedBreakTarget 。
- 返回以 iterationSet 和 « » 为实参的
Statement 的ContainsUndefinedContinueTarget 。
- 返回
false 。
- 令 names1 为
BindingIdentifier 的BoundNames 。 - 令 names2 为
Statement 的VarDeclaredNames 。 - 返回 names1 和 names2 的
列表连接 。
- 令 decls1 为 «
BindingIdentifier »。 - 令 decls2 为
Statement 的VarScopedDeclarations 。 - 返回 decls1 和 decls2 的
列表连接 。
- 令 bindingId 为
BindingIdentifier 的StringValue 。 - 令 lhs 为 ?
ResolveBinding (bindingId)。 - 如果
IsAnonymousFunctionDefinition (Initializer ) 是true ，则- 令 value 为以 bindingId 为实参的
Initializer 的NamedEvaluation 。
- 令 value 为以 bindingId 为实参的
- 否则，
- 令 rhs 为 ?
Initializer 的求值。 - 令 value 为 ?
GetValue (rhs)。
- 令 rhs 为 ?
- 执行 ?
PutValue (lhs, value)。 - 令 keyResult 为 ?
ForIn/OfHeadEvaluation (« »,Expression ,enumerate )。 - 返回 ?
ForIn/OfBodyEvaluation (BindingIdentifier ,Statement , keyResult,enumerate ,var-binding , labelSet)。
B.3.6 [[IsHTMLDDA]] 内部槽
[[IsHTMLDDA]] 内部槽可以存在于typeof 运算符
具有 [[IsHTMLDDA]] 内部槽的对象永远不会由本规范创建。然而，Web 浏览器中的 document.all 对象是一个具有此槽的document.all 除外。
此特性在以下位置涉及特殊语义：
ToBoolean 中的步骤3 IsLooselyEqual 中的步骤4 typeof的求值语义中的步骤12
B.3.7 HostMakeJobCallback 中的非默认行为
B.3.8 HostEnsureCanAddPrivateElement 中的非默认行为
B.3.9 函数调用赋值目标的运行时错误
当函数调用（
当赋值目标是 = 或 ??=、&&=、||=）。
见
Annex C (informative) ECMAScript 的严格模式
严格模式限制和例外
-
implements、interface、let、package、private、protected、public、static和yield在严格模式代码中是保留字 。（12.7.2 ）。 -
合规实现处理严格模式代码时，必须禁止产生式
NumericLiteral :: LegacyOctalIntegerLiteral DecimalIntegerLiteral :: NonOctalDecimalIntegerLiteral -
合规实现处理严格模式代码时，必须禁止产生式
EscapeSequence :: LegacyOctalEscapeSequence EscapeSequence :: NonOctalDecimalEscapeSequence -
对未声明标识符或其他不可解析引用的赋值不会在
全局对象 中创建属性。当简单赋值出现在严格模式代码中时，其LeftHandSideExpression 不得求值为不可解析 Reference。如果是，则抛出ReferenceError 异常（6.2.5.6 ）。LeftHandSideExpression 也不得是对具有特性值 { [[Writable]]:false } 的数据属性 、具有特性值 { [[Set]]:undefined } 的访问器属性 ，或其 [[Extensible]] 内部槽为false 的对象的不存在属性的引用。在这些情况下，会抛出TypeError异常（13.15 ）。 -
StringValue 为"eval" 或"arguments" 的IdentifierReference 不得作为赋值运算符的LeftHandSideExpression （13.15 ），也不得作为UpdateExpression （13.4 ），也不得作为 Prefix Increment（13.4.4 ）或 Prefix Decrement（13.4.5 ）运算符所操作的UnaryExpression 。 -
严格函数 的 Arguments 对象定义了一个不可配置的访问器属性 "callee" ，访问该属性会抛出TypeError 异常（10.4.4.6 ）。 -
严格函数 的 Arguments 对象不会动态共享其数组索引 属性值与其函数的对应形式参数绑定。（10.4.4 ）。 -
对于
严格函数 ，如果创建了 arguments 对象，则本地标识符arguments到该 arguments 对象的绑定是不可变的，因此不得作为赋值表达式的目标。（10.2.11 ）。 -
如果严格模式代码中的
BindingIdentifier 的StringValue 是"eval" 或"arguments" ，则为SyntaxError （13.1.1 ）。 -
严格模式 eval 代码不能在 eval 调用者的变量环境中实例化变量或函数。相反，会创建一个新的变量环境，并使用该环境为 eval 代码进行声明绑定实例化（
19.2.1 ）。 -
如果
this 在严格模式代码中被求值，则this 值不会被强制转换为对象。this 值为undefined 或null 时，不会被转换为全局对象 ，原始值也不会被转换为包装对象。通过函数调用传递的this 值（包括使用Function.prototype.apply和Function.prototype.call进行的调用）不会把传递的this 值强制转换为对象（10.2.1.2 、20.2.3.1 、20.2.3.3 ）。 -
当
delete运算符出现在严格模式代码中时，如果其UnaryExpression 是对变量、函数实参或函数名的直接引用，则会抛出SyntaxError （13.5.1.1 ）。 -
当
delete运算符出现在严格模式代码中时，如果要删除的属性具有特性 { [[Configurable]]:false } 或以其他方式不能被删除，则会抛出TypeError （13.5.1.2 ）。 -
严格模式代码不得
包含 WithStatement 。在这种上下文中出现WithStatement 是SyntaxError （14.11.1 ）。 -
如果
CatchParameter 出现在严格模式代码中，且CatchParameter 的BoundNames 包含 eval或arguments，则为SyntaxError （14.15.1 ）。 -
如果同一个
BindingIdentifier 在严格函数 的FormalParameters 中出现多次，则为SyntaxError 。尝试使用 Function、Generator 或 AsyncFunction 构造器创建这类函数也是SyntaxError （15.2.1 、20.2.1.1.1 ）。 -
实现不得扩展
严格函数 中函数实例名为"caller" 或"arguments" 的属性的含义，除本规范定义的含义之外。
Annex D (informative) 宿主分层点
D.1 宿主钩子
D.2 宿主定义字段
[[IsHTMLDDA]]：见
D.3 宿主定义对象
D.4 运行 Job
调用
D.5 Exotic Object 的内部方法
对于本规范中未规定的任何 exotic object，
D.6 内置对象和方法
本规范中未定义的任何内置对象和方法，除非受
Annex E (informative) ECMAScript 2015 中可能影响兼容性的修正和澄清
Date.prototype.toString 返回的值。ECMAScript 2015 规定结果为 String 值
/。
String.prototype.match 和 String.prototype.replace 的规范在模式实参是设置了 global 标志的 RegExp 值的情况下是不正确的。先前规范规定，对于每次尝试匹配模式，如果 lastIndex 没有变化，则应将其递增 1。正确行为是，只有当模式匹配空 String 时，才应将 lastIndex 递增 1。
Array.prototype.sort 如何解释 comparator 返回的
Annex F (informative) 引入与先前版本不兼容性的新增和变更
Space_Separator（Zs）类别移到 Format（Cf）类别（自 Unicode 6.3.0 起），该字符在 ECMAScript 2015 中因此被视为空白。这会导致空白敏感方法的行为不同。例如，"\u180E".trim().length 在先前版本中为 0，但在 ECMAScript 2016 及更高版本中为 1。此外，ECMAScript 2017 强制要求始终使用 Unicode Standard 的最新版本。
let 开头、后跟 token [ 的
( token 后立即跟随 token 序列 let [，则 let 被视为
let [，则 let 被视为
in
var 声明，则为
eval，其 eval 代码var 或 FunctionDeclaration 声明，则会抛出运行时
Object.freeze 的实参不是对象，则将其视为没有自有属性的不可扩展
Object.getOwnPropertyDescriptor 的实参不是对象，则会尝试使用
Object.getOwnPropertyNames 的实参不是对象，则会尝试使用
Object.getPrototypeOf 的实参不是对象，则会尝试使用
Object.isExtensible 的实参不是对象，则将其视为没有自有属性的不可扩展
Object.isFrozen 的实参不是对象，则将其视为没有自有属性的不可扩展
Object.isSealed 的实参不是对象，则将其视为没有自有属性的不可扩展
Object.keys 的实参不是对象，则会尝试使用
Object.preventExtensions 的实参不是对象，则将其视为没有自有属性的不可扩展
Object.seal 的实参不是对象，则将其视为没有自有属性的不可扩展
String.prototype.localeCompare 函数必须将根据 Unicode Standard 规范等价的 String 视为相同。在先前版本中，实现被允许忽略规范等价性，而可以改用按位比较。
String.prototype.trim 方法被定义为识别可能存在于 Unicode BMP 之外的空白代码点。然而，截至 Unicode 7 尚未定义这类代码点。在先前版本中，这类代码点不会被识别为空白。
Atomics.wake 被重命名为 Atomics.notify，以避免与 Atomics.wait 混淆。
await 入队的 then() 调用和 await 表达式之间的解决顺序上产生可观察差异。
参考文献
-
IEEE 754-2019：浮点算术 IEEE 标准。Institute of Electrical and Electronic Engineers，纽约（2019）
Note IEEE 754-2008 和 IEEE 754-2019 之间没有影响 ECMA-262 规范的规范性变更。
- Unicode Standard，可见于 <https://unicode.org/versions/latest>
- Unicode Technical Note #5：应用中的规范等价性，可见于 <https://unicode.org/notes/tn5/>
- Unicode Technical Standard #10：Unicode 排序算法，可见于 <https://unicode.org/reports/tr10/>
- Unicode Standard Annex #15，Unicode 规范化形式，可见于 <https://unicode.org/reports/tr15/>
- Unicode Standard Annex #18：Unicode 正则表达式，可见于 <https://unicode.org/reports/tr18/>
-
Unicode Standard Annex #24：Unicode
Script属性，可见于 <https://unicode.org/reports/tr24/> - Unicode Standard Annex #31，Unicode 标识符和模式语法，可见于 <https://unicode.org/reports/tr31/>
- Unicode Standard Annex #44：Unicode 字符数据库，可见于 <https://unicode.org/reports/tr44/>
- Unicode Technical Standard #51：Unicode Emoji，可见于 <https://unicode.org/reports/tr51/>
- IANA 时区数据库，可见于 <https://www.iana.org/time-zones>
- ISO 8601:2004(E) 数据元素和交换格式 — 信息交换 — 日期和时间的表示
- RFC 1738 “统一资源定位符（URL）”，可见于 <https://tools.ietf.org/html/rfc1738>
- RFC 2396 “统一资源标识符（URI）：通用语法”，可见于 <https://tools.ietf.org/html/rfc2396>
- RFC 3629 “UTF-8，ISO 10646 的一种转换格式”，可见于 <https://tools.ietf.org/html/rfc3629>
- RFC 7231 “超文本传输协议（HTTP/1.1）：语义和内容”，可见于 <https://tools.ietf.org/html/rfc7231>
跋
本规范在 GitHub 上以一种名为 Ecmarkup 的纯文本源格式编写。Ecmarkup 是一种 HTML 和 Markdown 方言，提供用于以纯文本编写 Ecma 规范并将规范处理为功能完整的 HTML 呈现的框架和工具集，其呈现遵循本文档的编辑约定。Ecmarkup 构建于并集成了其他一些格式和技术，包括用于定义语法的 Grammarkdown，以及用于编写算法步骤的 Ecmarkdown。本规范的 PDF 呈现使用打印样式表生成，该样式表利用了 CSS Paged Media 规范，并使用 PrinceXML 进行转换。
本规范的先前版本使用 Word 编写——构成本版基础的 Ecmarkup 源文本，是通过自动转换工具将 ECMAScript 2015 Word 文档转换为 Ecmarkup 而生成的。
Copyright & Software License
Ecma International
Rue du Rhone 114
CH-1204 Geneva
Tel: +41 22 849 6000
Fax: +41 22 849 6001
Web: https://ecma-international.org/
Copyright Notice
ALTERNATIVE COPYRIGHT NOTICE AND COPYRIGHT LICENSE
© 2026 Ecma International
By obtaining and/or copying this work, you (the licensee) agree that you have read, understood, and will comply with the following terms and conditions.
Permission under Ecma’s copyright to copy, modify, prepare derivative works of, and distribute this work, with or without modification, for any purpose and without fee or royalty is hereby granted, provided that you include the following on ALL copies of the work or portions thereof, including modifications:
(i) The full text of this COPYRIGHT NOTICE AND COPYRIGHT LICENSE in a location viewable to users of the redistributed or derivative work.
(ii) Any pre-existing intellectual property disclaimers, notices, or terms and conditions. If none exist, the Ecma alternative copyright notice should be included.
(iii) Notice of any changes or modifications, through a copyright statement on
the document such as “This document includes material copied from or
derived from ECMAScript® 2027 语言规范 https://tc39.es/ecma262/.
Copyright © Ecma International.”
Disclaimers
THIS WORK IS PROVIDED “AS IS,” AND COPYRIGHT HOLDERS MAKE NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE DOCUMENT WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.
COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE DOCUMENT.
The name and trademarks of copyright holders may NOT be used in advertising or publicity pertaining to the work without specific, written prior permission. Title to copyright in this work will at all times remain with copyright holders.
Software License
All Software contained in this document ("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 https://ecma-international.org/memento/codeofconduct.htm FOR INFORMATION REGARDING THE LICENSING OF PATENT CLAIMS THAT ARE REQUIRED TO IMPLEMENT ECMA INTERNATIONAL STANDARDS.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
- Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
- Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
- Neither the name of the authors nor Ecma International may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE ECMA INTERNATIONAL "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ECMA INTERNATIONAL BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.