Draft ECMA-262 / September 16, 2025
ECMAScript® 2026 语言规范
关于本规范
位于 https://tc39.es/ecma262/ 的文档是最准确且最新的 ECMAScript 规范。它包含了最近年度快照的内容，以及自该快照以来所有已完成的 提案（即已在 提案流程中达到第 4 阶段，并且已在多个实现中落地、将在下一次实际修订中包含的提案）。
如何参与规范制定
本规范在 GitHub 上由 ECMAScript 社区协作开发。您可以通过以下几种方式参与本规范的制定：
- GitHub 仓库：https://github.com/tc39/ecma262
- 问题反馈：所有问题，提交新问题
- 拉取请求：所有拉取请求，创建新拉取请求
- 测试套件：Test262
- 编辑：
-
社区：
- Discourse: https://es.discourse.group/
- 聊天：Matrix
- 邮件
列表 存档：https://esdiscuss.org/
更多关于本文件创建方式的信息请参阅
简介
本 Ecma 标准定义了 ECMAScript 2026 语言，这是 ECMAScript 语言规范的第十七版。自1997年第一版发布以来，ECMAScript已发展为全球使用最广泛的通用编程语言之一。它最著名的应用是在网页浏览器中嵌入的语言，但也在服务器和嵌入式应用中被广泛采用。
ECMAScript 基于多种起源技术，其中最知名的是 JavaScript（Netscape）和 JScript（Microsoft）。该语言由 Brendan Eich 在 Netscape 发明，并首次出现在该公司 Navigator 2.0 浏览器中。随后，Netscape 的所有浏览器以及 Microsoft 从 Internet Explorer 3.0 起的所有浏览器均支持该语言。
ECMAScript 语言规范的开发始于 1996 年 11 月。该 Ecma 标准的第一版由 Ecma 大会在 1997 年 6 月通过。
该 Ecma 标准按快速通道程序提交至 ISO/IEC JTC 1，并于 1998 年 4 月获批为国际标准 ISO/IEC 16262。Ecma 大会于 1998 年 6 月批准了 ECMA-262 的第二版，以确保其与 ISO/IEC 16262 完全一致。第一版与第二版之间的更改仅为编辑性质。
标准的第三版引入了强大的正则表达式、更好的字符串处理、新的控制语句、try/catch 异常处理、更严格的错误定义、数字输出格式，以及为未来语言发展做出的细微调整。第三版由 Ecma 大会于 1999 年 12 月通过，并作为 ISO/IEC 16262:2002 于 2002 年 6 月发布。
第三版发布后，ECMAScript 在万维网环境下得到广泛采用，成为几乎所有浏览器支持的编程语言。曾有大量工作投入到 ECMAScript 第四版的开发中，但该工作最终未完成并未以第四版发布，部分内容被融入到第六版的开发中。
ECMAScript 第五版（作为 ECMA-262 第 5 版发布）规范化了已成为浏览器实现间通用的语言解释方式，并加入了自第三版发布以来出现的新特性。这些特性包括
第五版按快速通道程序提交至 ISO/IEC JTC 1，并获批为国际标准 ISO/IEC 16262:2011。ECMAScript 标准第 5.1 版包含了细微修正，与 ISO/IEC 16262:2011 的文本一致。5.1 版由 Ecma 大会于 2011 年 6 月通过。
第六版的集中开发始于 2009 年，在第五版准备发布期间。但在此之前，自 1999 年第三版发布起，已进行了大量实验和语言增强设计。实际上，第六版的完成是十五年努力的结晶。本版目标包括更好地支持大型应用、库创建，以及将 ECMAScript 作为其他语言编译目标。主要增强包括模块、类声明、词法块作用域、迭代器和生成器、异步编程的 Promise、解构模式和尾调用优化。内置库扩展以支持更多数据抽象，如 Map、Set 和二进制数值数组，并进一步支持字符串和正则表达式中的 Unicode 补充字符。内置对象也可以通过子类化进行扩展。第六版为语言和库的常规、增量性增强奠定了基础。第六版由 2015 年 6 月的大会通过。
ECMAScript 2016 是 Ecma TC39 新的年度发布节奏和开放开发流程下发布的首个 ECMAScript 版本。基础文档由 ECMAScript 2015 的源文档转换成纯文本格式，并在 GitHub 上持续开发。在本标准开发期间，提交了数百个拉取请求和问题，修复了数千个错误、编辑问题和其他改进。此外，开发了许多软件工具以支持此过程，包括 Ecmarkup、Ecmarkdown 和 Grammarkdown。ES2016 还新增了指数运算符和 Array.prototype 的 includes 方法。
ECMAScript 2017 引入了异步函数、共享内存和原子操作，以及多项语言和库的增强、错误修复和编辑更新。异步函数通过提供 Promise 返回函数的语法改善了异步编程体验。共享内存和原子操作引入了新的Object.values、Object.entries 和 Object.getOwnPropertyDescriptors。
ECMAScript 2018 引入了通过异步迭代器协议和异步生成器实现的异步迭代支持。还新增了四种正则表达式特性：dotAll 标志、命名捕获组、Unicode 属性转义和后行断言。最后还包括对象剩余和展开属性。
ECMAScript 2019 新增了几种内置函数：用于数组扁平化的 Array.prototype 上的 flat 和 flatMap，用于直接将 Object.entries 的返回值转为新对象的 Object.fromEntries，以及作为更合理命名替代的 String.prototype 上的 trimStart 和 trimEnd（替代广泛实现但未标准化的 String.prototype.trimLeft 和 trimRight）。此外还包括对语法和语义的细微更新。语法更新包括可选的 catch 绑定参数以及在字符串字面量中允许 U+2028（行分隔符）和 U+2029（段分隔符），以与 JSON 保持一致。其他更新包括要求 Array.prototype.sort 必须为稳定排序，要求 JSON.stringify 无论输入如何都返回格式正确的 UTF-8，以及明确要求 Function.prototype.toString 返回相应的原始源代码或标准占位符。
ECMAScript 2020，第 11 版，引入了字符串的 matchAll 方法，可通过全局正则表达式生成所有匹配对象的迭代器；import()，一种可动态指定异步导入模块的语法；BigInt，用于任意精度整数的新数值原语；Promise.allSettled，一种不会短路的 Promise 组合器；globalThis，一种通用访问全局 this 的方式；模块内专用的 export * as ns from 'module' 语法；for-in import.meta 对象，可包含关于模块的上下文信息；以及为“空值”(
ECMAScript 2021，第 12 版，引入了字符串的 replaceAll 方法；Promise.any，一种在输入值满足条件时短路的 Promise 组合器；AggregateError，用于同时表示多个错误的新错误类型；逻辑赋值运算符（??=, &&=, ||=）；WeakRef，用于引用目标对象但不阻止其被垃圾回收，以及 FinalizationRegistry，用于注册和注销在目标对象被垃圾回收时执行的清理操作；数字字面量分隔符（如 1_000）；并且 Array.prototype.sort 更加精确，减少了实现定义排序结果的情况。
ECMAScript 2022，第 13 版，引入了顶层 await，允许在模块顶层使用该关键字；新增类元素：公有和私有实例字段、静态字段、私有实例方法和访问器、私有静态方法和访问器；类中的静态块，用于每个类的初始化；#x in obj 语法，用于检测对象上的私有字段是否存在；正则表达式匹配索引（通过 /d 标志），可提供匹配子字符串的起止索引；错误对象的 cause 属性，可用于记录错误因果链；字符串、数组和 at 方法，实现相对索引；以及 Object.hasOwn，作为更方便的 Object.prototype.hasOwnProperty 替代方案。
ECMAScript 2023，第 14 版，在 Array.prototype 和 TypedArray.prototype 上新增了 toSorted、toReversed、with、findLast 和 findLastIndex 方法，并在 Array.prototype 上新增了 toSpliced 方法；支持文件开头的 #! 注释，以更好地支持可执行 ECMAScript 文件；允许在弱集合中使用大多数 Symbol 作为键。
ECMAScript 2024，第 15 版，增加了 ArrayBuffer 和 SharedArrayBuffer 的动态调整大小和转移功能；新增了用于处理字符串集合的高级特性的新正则表达式 /v 标志；引入了便捷构造 Promise 的 Promise.withResolvers 方法，数据聚合的 Object.groupBy 和 Map.groupBy 方法，异步等待共享内存变更的 Atomics.waitAsync 方法，以及用于检测和保证字符串仅包含格式正确 Unicode 的 String.prototype.isWellFormed 和 String.prototype.toWellFormed 方法。
ECMAScript 2025，第 16 版，新增了带有相关静态方法和原型方法的全局 Iterator，用于迭代器操作；为 Set.prototype 增加了常用集合操作方法；支持导入 JSON 模块，以及声明导入模块属性的语法；新增了用于安全处理字符串的 RegExp.escape 方法；支持在正则表达式中内联启用和禁用修饰符标志的语法；新增了用于处理可能返回 Promise 或非 Promise 的函数并确保返回值始终是 Promise 的 Promise.try 方法；并新增了新的 Float16Array 类型数组及相关的 DataView.prototype.getFloat16、DataView.prototype.setFloat16 和 Math.f16round 方法。
有数十位代表众多机构的个人在 Ecma TC39 中为本版及以往版本的开发做出了重要贡献。此外，支持 TC39 ECMAScript 工作的社区也日益活跃。该社区审查了大量草案，提交了成千上万个错误报告，进行了实现实验，贡献了测试套件，并向全球开发者介绍 ECMAScript。遗憾的是，无法逐一列举和感谢每一位做出贡献的个人和机构。
Allen Wirfs-Brock
ECMA-262，第 6 版项目编辑
Brian Terlson
ECMA-262，第 7–10 版项目编辑
Jordan Harband
ECMA-262，第 10–12 版项目编辑
Shu-yu Guo
ECMA-262，第 12–16 版项目编辑
Michael Ficarra
ECMA-262，第 12–16 版项目编辑
Kevin Gibbons
ECMA-262，第 12–16 版项目编辑
1 范围
本标准定义了 ECMAScript 2026 通用编程语言。
2 一致性
符合规范的 ECMAScript 实现必须提供并支持本规范中描述的所有类型、值、对象、属性、函数，以及程序的语法和语义。
符合规范的 ECMAScript 实现必须按照最新版 Unicode 标准和 ISO/IEC 10646 的要求解释源文本输入。
符合规范的 ECMAScript 实现如果提供支持不同语言和国家的语言习惯和文化规范的应用程序编程接口（API），则必须实现与本规范兼容的最新版 ECMA-402 所定义的接口。
符合规范的 ECMAScript 实现可以提供本规范未描述的其他类型、值、对象、属性和函数。特别地，符合规范的 ECMAScript 实现可以为本规范所描述的对象提供未在本规范中描述的属性，以及这些属性的值。
符合规范的 ECMAScript 实现可以支持本规范未描述的程序和正则表达式语法。特别地，符合规范的 ECMAScript 实现可以支持使用本规范
符合规范的 ECMAScript 实现不得实现本规范
符合规范的 ECMAScript 实现不得重新定义任何非
符合规范的 ECMAScript 实现可以选择实现或不实现 规范性可选 子条款，除非另有说明。通常情况下，网页浏览器要求实现所有规范性可选子条款。（参见附录
2.1 规范性可选条款标题示例
条款内容示例。
符合规范的 ECMAScript 实现必须实现 遗留 子条款，除非它们也被标记为规范性可选。遗留子条款中指定的所有语言特性和行为都具有一个或多个不理想的特性，但由于现有应用仍在使用，无法从规范中移除这些特性。这些特性不属于 ECMAScript 语言核心。编程人员在编写新的 ECMAScript 代码时不应使用或假定这些特性和行为的存在。
2.2 遗留条款标题示例
条款内容示例。
2.3 遗留规范性可选条款标题示例
条款内容示例。
3 规范性引用文件
下列引用文件对于本文件的应用是不可或缺的。对于有日期的引用，仅适用于所引用的版本；对于无日期的引用，适用于引用文件的最新版本（包括任何修订）。
Unicode 标准。
https://unicode.org/versions/latest
ISO/IEC 10646，《信息技术——通用多字节编码字符集（UCS）》，包括修订1:2005、修订2:2006、修订3:2008、修订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 最初设计为脚本语言，但现已广泛用作通用编程语言。脚本语言是用于操作、定制和自动化现有系统功能的编程语言。在此类系统中，实用功能通常通过用户界面提供，脚本语言则是让程序能够控制这些功能的机制。这样，现有系统就提供了对象和机制组成的
ECMAScript 最初设计为Web 脚本语言，用于在浏览器中为 Web 页面赋予动态行为，并在基于 Web 的客户端-服务器架构中执行服务器端计算。如今，ECMAScript 被用于为多种
ECMAScript 的使用已超越简单脚本，现在在许多环境和规模下用于各类编程任务。随着 ECMAScript 应用范围的扩大，其所提供的特性和机制也不断丰富。ECMAScript 现已成为功能完备的通用编程语言。
4.1 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 Array；用于键值集合的 Map 和 Set；用于结构化数据的对象，如 JSON、ArrayBuffer、SharedArrayBuffer 和 DataView；用于控制抽象的对象，如生成器函数和 Promise；以及用于反射的对象，如 Proxy 和 Reflect。
ECMAScript 还定义了一组内建运算符。ECMAScript 运算符包括各类一元运算、乘法运算、加法运算、位移运算、关系运算、相等运算、二元位运算、二元逻辑运算、赋值运算和逗号运算。
大型 ECMAScript 程序通过模块得到支持，允许将程序划分为多个语句和声明序列。每个模块明确标识需要由其他模块提供的声明，以及哪些声明可供其他模块使用。
ECMAScript 的语法有意与 Java 语法相似。ECMAScript 的语法较为宽松，便于其作为易用的脚本语言。例如，变量无需声明类型，属性也无类型约束，定义的函数无需在调用前出现在文本中。
4.3.1 对象
尽管 ECMAScript 包含类定义语法，但 ECMAScript 对象本质上不是 C++、Smalltalk 或 Java 那样的类基础对象。对象可以通过多种方式创建，包括字面量方式或通过new Date(2009, 11) 创建一个新的 Date 对象。直接调用Date() 返回当前日期和时间的字符串而不是对象。
每个由
在基于类的面向对象语言中，状态通常由实例承载，方法由类承载，继承仅限结构和行为。而在 ECMAScript 中，状态和方法都由对象承载，结构、行为和状态都可继承。
所有未直接拥有其原型属性的对象共享该属性及其值。图1对此进行了说明：
CF 是一个new 表达式创建了五个对象：cf1、cf2、cf3、cf4 和 cf5。每个对象都包含名为
与多数基于类的对象语言不同，可以通过为对象赋值动态添加属性。即，
虽然 ECMAScript 对象本质上不是类基础，但基于通用的
4.3.2 ECMAScript 的严格模式变体
ECMAScript 语言考虑到部分用户可能希望限制语言中的某些特性使用。这样做可能出于安全考虑、避免易出错特性、获得更强的错误检查或其他原因。为此，ECMAScript 定义了语言的严格模式变体。严格模式变体排除了常规 ECMAScript 语言中的部分特定语法和语义特性，并对部分特性进行了详细语义修改。严格模式还规定了在非严格模式下不视为错误的情况下必须抛出错误异常的额外错误条件。
ECMAScript 的严格模式变体通常被称为语言的严格模式。严格模式的选择及语法和语义的使用在单个 ECMAScript 源文本单元级进行，如
为符合本规范，ECMAScript 实现必须实现本规范定义的完整的非受限 ECMAScript 语言和严格模式变体，并支持将非受限和严格模式源文本单元组合为单一复合程序。
4.4 术语和定义
本文件的目的所涉及的术语和定义如下。
4.4.1 实现近似
4.4.2 实现自定义
4.4.3 宿主自定义
编辑说明，见
4.4.4 类型
如
4.4.5 原始值
属于 Undefined、Null、Boolean、Number、BigInt、Symbol 或
原始值是由语言实现直接在最低层级表示的数据项。
4.4.6 对象
属于
对象是属性集合，并且有唯一的原型对象。原型可以为
4.4.7 构造函数
用于创建和初始化对象的
4.4.8 原型
为其他对象提供共享属性的对象
4.4.9 普通对象
具有所有对象必须支持的基本内部方法默认行为的对象
4.4.10 特殊对象
在一个或多个基本内部方法上不具有默认行为的对象
4.4.11 标准对象
其语义由本规范定义的对象
4.4.12 内建对象
由 ECMAScript 实现指定并提供的对象
标准内建对象由本规范定义。ECMAScript 实现可以指定和提供其他类型的内建对象。
4.4.13 undefined 值
在变量未赋值时使用的原始值
4.4.14 Undefined 类型
其唯一值为
4.4.15 null 值
表示有意无对象值的原始值
4.4.16 Null 类型
其唯一值为
4.4.17 Boolean 值
属于
只有两个 Boolean 值，
4.4.18 Boolean 类型
由原始值
4.4.19 Boolean 对象
属于
Boolean 对象通过在 new 表达式中使用 Boolean
4.4.20 String 值
为
String 值属于
4.4.21 String 类型
所有可能的 String 值的集合
4.4.22 String 对象
属于
4.4.23 Number 值
与双精度 64 位二进制格式
Number 值属于
4.4.24 Number 类型
所有可能的 Number 值集合，包括
4.4.25 Number 对象
属于
4.4.26 Infinity
为正无穷值的 Number 值
4.4.27 NaN
为
4.4.28 BigInt 值
对应于任意精度整数值的原始值
4.4.29 BigInt 类型
所有可能的
4.4.30 BigInt 对象
4.4.31 Symbol 值
表示唯一、非 String 对象
4.4.32 Symbol 类型
所有可能的 Symbol 值集合
4.4.33 Symbol 对象
4.4.34 函数
属于
函数除具有属性外，还包含可执行代码和状态，决定调用时的行为。函数代码可能用 ECMAScript 编写，也可能不是。
4.4.35 内建函数
为函数的内建对象
内建函数示例包括 parseInt 和 Math.exp。
4.4.36 内建构造函数
为
4.4.37 属性
对象的一部分，将键（String 值或 Symbol 值）与值关联
根据属性形式，值可以直接表示为数据值（原始值、对象或
4.4.38 方法
作为属性值的函数
当函数作为对象的方法调用时，该对象作为
4.4.39 内建方法
为内建函数的方法
标准内建方法由本规范定义。
4.4.40 特性
定义属性某些特性的内部值
4.4.41 自身属性
直接由对象包含的属性
4.4.42 继承属性
不是对象自身属性但属于对象原型（自身或继承）的属性
4.5 本规范的结构
本规范余下内容组织如下：
5 符号约定
5.1 句法和词法文法
5.1.1 上下文无关文法
上下文无关文法由若干产生式组成。每个产生式都有一个抽象符号，称为非终结符，作为其左部，以及由零个或多个非终结符和终结符组成的序列，作为其右部。对于每个文法，终结符来自指定的字母表。
链式产生式是指其右部恰好只有一个非终结符和零个或多个终结符的产生式。
从一个仅包含单一特殊非终结符的句子开始，称为目标符号，给定的上下文无关文法定义了一个语言，即通过不断将序列中的任意非终结符替换为以该非终结符为左部的某个产生式的右部，最终可能得到的所有终结符序列的集合（可能是无限的）。
5.1.2 词法和正则表达式文法
ECMAScript 的词法文法见
除空白和注释外的输入元素构成 ECMAScript 句法文法的终结符，被称为 ECMAScript 标记。这些标记包括 ECMAScript 语言的保留字、标识符、字面量和标点符号。此外，行终止符虽然不是标记，但也成为输入元素流的一部分，引导自动分号插入过程（/*…*/ 的注释，无论是否跨越多行）如果不包含行终止符，则同样被丢弃；但若包含一个或多个行终止符，则被替换为一个单一行终止符，后者成为句法文法输入元素流的一部分。
ECMAScript 的正则表达式文法见
词法和正则表达式文法的产生式以两个冒号“::”作为分隔标志。词法文法和正则表达式文法共享部分产生式。
5.1.3 数值字符串文法
数值字符串文法见
数值字符串文法的产生式以三个冒号“:::”为标点，并从不用于解析源文本。
5.1.4 句法文法
ECMAScript 的句法文法见
当要将码点流解析为 ECMAScript 的
解析成功时会构建一个解析树，即以根为起点的树结构，每个节点为一个解析节点。每个解析节点是文法符号的一个实例，表示可由该符号导出的源文本片段。解析树的根节点，代表整个源文本，是解析
每次解析器调用都会实例化新的解析节点，即使解析的源文本完全相同，解析节点也不会复用。只有当解析节点代表同一源文本片段、是同一文法符号的实例且来源于同一次解析器调用时，才认为它们是同一个解析节点。
多次解析同一个字符串会得到不同的解析节点。例如：
let str = "1 + 1;";
eval(str);
eval(str);每次调用 eval 都会将 str 的值转换为 ECMAScript 源文本，并进行独立解析，生成各自独立的解析节点树。即使每次解析的源文本都来自同一个字符串值，树结构也是不同的。
句法文法的产生式以单个冒号“:”作为标点。
在
为避免歧义，句法文法在某些情况下使用了广义产生式，允许不形成有效 ECMAScript
5.1.5 文法记号
5.1.5.1 终结符号
在 ECMAScript 文法中，部分终结符以 等宽字体 展示。这些符号应在源文本中完全按原样出现。此类终结符指定的所有码点均应理解为基本拉丁区（Basic Latin block）中对应的 Unicode 码点，不包括其他 Unicode 区段中外观相似的码点。终结符中的码点不能用 \
在以单个 Unicode 码点为终结符的文法（即词法、正则和数值字符串文法）中，产生式中连续出现的多个等宽码点是一种简写，表示同样顺序的独立终结符。
例如如下产生式：
是如下写法的简写：
而在句法文法中，连续的等宽码点则视为单一终结符。
终结符还可以有两种形式：
- 在词法和正则文法中，无传统印刷表示的 Unicode 码点以“<ABBREV>”形式展示，其中“ABBREV”是该码点或码点集的助记符。这些形式在
Unicode 格式控制字符 (Unicode Format-Control Characters) 、空白 (White Space) 和行终止符 (Line Terminators) 中定义。 - 在句法文法中，某些终结符（如
IdentifierName 和RegularExpressionLiteral ）以斜体显示，表示它们引用词法文法中同名非终结符。
5.1.5.2 非终结符号和产生式
非终结符以斜体展示。非终结符的定义（也称“产生式”）由被定义的非终结符名称后跟一个或多个冒号引出。（冒号数量表明该产生式属于哪种文法。）随后为该非终结符的一个或多个备选右部。例如，句法定义：
说明非终结符 while，后跟左括号标记，再跟
说明
5.1.5.3 可选符号
下标后缀“opt”用于终结符或非终结符之后，表示该符号为可选。包含可选符号的备选实际上指定了两个右部：一个省略可选元素，一个包含可选元素。即：
是如下写法的简写：
同理：
是如下写法的简写：
进一步简写为：
所以在此例中，非终结符
5.1.5.4 文法参数
产生式可以通过下标标注“[参数]”进行参数化，该标注可作为产生式定义的非终结符后缀。“参数”可以是单个名称或以逗号分隔的名称列表。参数化产生式是对一组产生式的简写，定义了所有参数名称组合，组合名以下划线为前缀，附加到参数化非终结符后。即：
是如下写法的简写：
同理：
是如下写法的简写：
多个参数会生成组合数量的产生式，但完整文法中并不一定全部引用。
产生式右部对非终结符的引用也可以参数化。例如：
等价于：
而：
等价于：
非终结符引用可以同时有参数列表和“opt”后缀。例如：
简写为：
在右部非终结符引用上用“?”作为参数名前缀，使该参数取值依赖于当前产生式左部符号引用是否出现该参数。例如：
是如下写法的简写：
如果右部备选以“[+参数]”为前缀，表示仅当引用产生式非终结符时使用了该参数名才可用该备选。如果以“[~参数]”为前缀，则仅在未使用该参数名时可用该备选。即：
简写为：
同理：
简写为：
5.1.5.5 one of
当“one of”出现在文法定义中的冒号后，表示后续每个终结符都是一个备选定义。例如 ECMAScript 的词法文法包含如下产生式：
实际上是如下简写：
5.1.5.6 [empty]
如果“[empty]”出现在产生式右部，表示该产生式右部不包含任何终结符或非终结符。
5.1.5.7 前瞻限制
若“[lookahead = seq]”出现在产生式右部，表示只有当标记序列 seq 是紧跟输入标记序列的前缀时，才能使用该产生式。同理，“[lookahead ∈ set]”，其中 set 为
这些条件可以取反。“[lookahead ≠ seq]”表示只有当 seq 不是紧跟输入标记序列的前缀时才能使用该产生式，而“[lookahead ∉ set]”表示只有当集合中无元素是紧跟输入标记序列的前缀时才能使用该产生式。
例如，给定如下定义：
则如下定义：
匹配字符 n 后跟一个或多个十进制数字，且首位为偶数，或匹配一个十进制数字且后面不再有十进制数字。
注意，这些短语用于句法文法时，可能无法明确识别紧跟的标记序列，因为确定后续标记需要知道后续使用哪个词法
5.1.5.8 [此处无 LineTerminator ]
若“[no
表示若在脚本中的 throw 标记和
除非受限产生式禁止出现
5.1.5.9 but not
产生式右部可用“but not”短语指定某些扩展不允许。例如如下产生式：
表示非终结符
5.1.5.10 描述性短语
最后，少数非终结符用无衬线字体描述性短语来说明，当
5.2 算法约定
规范经常使用编号列表来指定算法步骤。这些算法用于精确定义 ECMAScript 语言结构所需的语义。算法并不意味着必须采用任何特定的实现技术。实际应用中，可能有更高效的算法可用于实现某个特性。
算法可以显式使用有序、逗号分隔的别名序列进行参数化，在算法步骤中可以通过这些别名引用对应位置传入的参数。可选参数用括号（[ , name ]）标记，在算法步骤中与必选参数没有区别。参数列表末尾可以出现剩余参数，用前置省略号（, ...name）标记。剩余参数会将所有必选和可选参数之后传入的参数收集到一个
算法步骤可以细分为顺序子步骤。子步骤缩进显示，并且自身可以进一步划分为缩进子步骤。大纲编号用于标识子步骤：第一层使用小写字母，第二层使用小写罗马数字。如需超过三层，则第四层用数字编号。例如：
- 顶层步骤
- 子步骤。
- 子步骤。
- 子子步骤。
- 子子子步骤
- 子子子子步骤
- 子子子子子步骤
- 子子子子步骤
- 子子子步骤
- 子子步骤。
某个步骤或子步骤可以写成“if”条件，控制其子步骤。此时，只有条件为真时才执行子步骤。如果步骤或子步骤以“else”开头，则表示该条件是同级前一个“if”条件的否定。
步骤可以指定对子步骤的迭代应用。
以“Assert:”开头的步骤表示断言该算法的不变条件。这样的断言用于显式表达本应隐含的算法不变量，不增加语义要求，因此实现无需检查。它们仅用于澄清算法。
算法步骤可以用“Let x be someValue”声明命名别名。这些别名类似引用，即 x 和 someValue 都引用相同的数据，对任一的修改都可见。若算法步骤希望避免引用行为，应显式复制右侧值：“Let x be a copy of someValue”会创建 someValue 的浅复制。
别名声明后可在后续步骤引用，但不可在声明前引用。别名可用“Set x to someOtherValue”进行赋值。
5.2.1 抽象操作
为便于在规范多个部分中使用，部分算法（称为抽象操作）采用命名并参数化的函数形式书写，以便在其他算法中通过名称引用。抽象操作通常以函数调用形式引用，如 OperationName(arg1, arg2)。有些抽象操作作为类似类的规范抽象的多态分派方法对待，这类方法通常以 someValue.OperationName(arg1, arg2) 形式引用。
5.2.2 语法导向操作
语法导向操作是指以名称定义、由若干算法组成，并与 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" .
除非另有说明，所有
但 Evaluation 操作未与该产生式关联算法，则此时 Evaluation 操作隐含如下关联：
- Return Evaluation of
StatementList .
5.2.3 运行时语义
指定运行时必须调用的语义的算法称为运行时语义。运行时语义通过
5.2.3.1 Completion ( completionRecord )
The abstract operation Completion takes argument completionRecord (a
Assert : completionRecord 是Completion Record 。- Return completionRecord.
5.2.3.2 抛出异常
算法步骤如：
- Throw a
TypeError exception.
与如下语句含义相同：
- Return
ThrowCompletion (a newly createdTypeError object).
5.2.3.3 ReturnIfAbrupt
算法步骤如：
ReturnIfAbrupt (argument).
与如下语句含义相同：
Assert : argument 是Completion Record 。- 如果 argument 是
异常完成 ，则返回Completion (argument)。 - 否则，将 argument 设为 argument.[[Value]]。
算法步骤如：
ReturnIfAbrupt (AbstractOperation()).
与如下语句含义相同：
- Let hygienicTemp be AbstractOperation().
Assert : hygienicTemp 是Completion Record 。- 如果 hygienicTemp 是
异常完成 ，则返回Completion (hygienicTemp)。 - 否则，将 hygienicTemp 设为 hygienicTemp.[[Value]]。
其中 hygienicTemp 仅在 ReturnIfAbrupt 相关步骤中可见且为临时变量。
算法步骤如：
- Let result be AbstractOperation(
ReturnIfAbrupt (argument)).
与如下语句含义相同：
Assert : argument 是Completion Record 。- 如果 argument 是
异常完成 ，则返回Completion (argument)。 - 否则，将 argument 设为 argument.[[Value]]。
- Let result be AbstractOperation(argument)。
5.2.3.4 ReturnIfAbrupt 简记法
? 表示应对返回的
- ? OperationName().
等价于：
ReturnIfAbrupt (OperationName()).
类似地，方法调用风格：
- ? someValue.OperationName().
等价于：
ReturnIfAbrupt (someValue.OperationName()).
类似地，前缀 ! 表示后续抽象或
- Let val be ! OperationName().
等价于：
! 或 ? 使用此简记法：
- Perform ! SyntaxDirectedOperation of
NonTerminal 。
5.2.3.5 隐式正常完成
对于声明为返回
- 直接返回
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.4 静态语义
上下文无关文法无法表达所有判断输入元素流是否能组成可求值的有效 ECMAScript
静态语义规则有名称，通常用算法定义。命名静态语义规则与文法产生式关联，具有多个备选定义的产生式通常为每个备选和每个适用的命名静态语义规则定义独立算法。
一种特殊的静态语义规则是早期错误规则。
5.2.5 数学运算
规范涉及以下数值类型：
- 数学值：任意实数，作为默认数值类型。
- 扩展数学值：
数学值 加上 +∞ 和 -∞。 - Numbers：
IEEE 754-2019 binary64（双精度浮点数）值。 - BigInts：
ECMAScript 语言值 ，一一对应表示任意整数。
在规范语言中，不同数值类型通过下标后缀区分。下标 𝔽 表示 Numbers，下标 ℤ 表示 BigInts。无下标后缀的数值表示
一般来说，规范提及数值时，如“y 的长度”或“四个十六进制数字表示的整数”，未显式说明数值类型时，指的是
规范中的integer指数学上的整数，除非另有说明。integral Number指
如 +、×、=、≥ 等数值运算符，具体操作取决于操作数类型。用于
数学函数
数学函数
记号“
“将 x 限制在 lower 与 upper 之间”（x 为
数学函数
数学函数
数学函数
区间从下界 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（闭）到 2（开）
5.2.6 值记号
本规范中，Function.prototype.apply 或 let n = 42;）区分开。
5.2.7 同一性
本规范中，规范值和
在规范角度，“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 程序中的文本数据，此时每个元素都被视为一个 UTF-16 码元值。每个元素被认为在序列中占据一个位置，这些位置用非负
未解释字符串内容的 ECMAScript 操作不施加进一步语义。解释字符串值的操作则将每个元素视为单个 UTF-16 码元。然而，ECMAScript 不限制这些码元的值或相互关系，因此进一步将字符串内容解释为 UTF-16 编码的 Unicode 码点序列时，必须考虑不规范的子序列。此类操作会对数值在
-
既不是
前导代理 也不是后导代理 的码元，按其数值解释为码点。 -
两个码元组成的序列，第一个码元 c1 为
前导代理 ，第二个码元 c2 为后导代理 ，则为一个代理对，按码点值 (c1 - 0xD800) × 0x400 + (c2 - 0xDC00) + 0x10000 解释。（见11.1.3 ） -
独立的
前导代理 或后导代理 码元（未作为代理对 的一部分），按其数值解释为码点。
可使用 String.prototype.normalize（见 String.prototype.localeCompare（见
该设计的理由是使字符串实现尽量简单且高效。如果 ECMAScript 源文本为标准化形式 C，则字符串字面量也一定是标准化的，只要其中不包含 Unicode 转义序列。
在本规范中，“the string-concatenation of A, B, ...”（每个参数为字符串值、码元或码元序列）表示顺序连接每个参数的码元后得到的字符串值。
“the substring of S from inclusiveStart to exclusiveEnd”（S 为字符串值或码元序列，inclusiveStart 和 exclusiveEnd 为整数）表示从索引 inclusiveStart 到紧邻索引 exclusiveEnd 之前的顺序码元组成的字符串值（当 inclusiveStart = exclusiveEnd 时为空字符串）。若省略 "to" 后缀，则 exclusiveEnd 取 S 的长度。
“the ASCII word characters”表示如下字符串值，仅包含 Unicode 基本拉丁区的所有字母和数字以及 U+005F（下划线）：
出于历史原因，在多种算法中具有特殊意义。
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
- 令 len 为 string 的长度。
- 如果 searchValue 是空字符串且 fromIndex ≤ len，返回 fromIndex。
- 令 searchLen 为 searchValue 的长度。
- 对每个满足 fromIndex ≤ i ≤ len - searchLen 的整数 i，按升序执行
- 令 candidate 为 string 从 i 到 i + searchLen 的子串。
- 如果 candidate 等于 searchValue，返回 i。
- 返回
not-found 。
如果 searchValue 是空字符串且 fromIndex ≤ string 的长度，则返回 fromIndex。空字符串在字符串的每个位置都可找到，包括最后一个码元之后。
如果 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
- 令 len 为 string 的长度。
- 令 searchLen 为 searchValue 的长度。
Assert : fromIndex + searchLen ≤ len。- 对每个满足 0 ≤ i ≤ fromIndex 的整数 i，按降序执行
- 令 candidate 为 string 从 i 到 i + searchLen 的子串。
- 如果 candidate 等于 searchValue，返回 i。
- 返回
not-found 。
如果 searchValue 是空字符串，则算法返回 fromIndex。空字符串在字符串的每个位置都可找到，包括最后一个码元之后。
6.1.5 Symbol 类型
Symbol 类型是所有可用作对象
每个 Symbol 都是唯一且不可变的。
每个 Symbol 都有一个不可变的 [[Description]] 内部槽，其值为字符串或
6.1.5.1 知名 Symbol
知名 Symbol 是规范算法明确引用的内建 Symbol 值。它们通常用作
在本规范中，知名 Symbol 使用标准的
| 规范名称 | [[Description]] | 值及用途 |
|---|---|---|
| %Symbol.asyncIterator% |
|
返回对象默认异步迭代器的方法。由 for-await-of 语句语义调用。
|
| %Symbol.hasInstance% |
|
判断instanceof 运算符语义调用。
|
| %Symbol.isConcatSpreadable% |
|
一个布尔属性，若为 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% |
|
一个函数属性，是用于创建派生对象的 |
| %Symbol.split% |
|
正则表达式方法，用于在匹配索引处分割字符串。由 String.prototype.split |
| %Symbol.toPrimitive% |
|
将对象转换为对应原始值的方法。由 ToPrimitive |
| %Symbol.toStringTag% |
|
用于创建对象默认字符串描述的字符串属性。通过内建方法 Object.prototype.toString |
| %Symbol.unscopables% |
|
一个对象属性，其自身和继承的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，但这种行为由实现定义；对于 ECMAScript 代码，所有
还有两个特殊值，称为 +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 是
剩下的 9,007,199,254,740,990 个值（即
其中 s 为 1 或 -1，m 是 (0, 252)
注意，所有绝对值不超过 253 的正负整数都能用 Number 类型表示。整数 0 在 Number 类型中有两种表示：
在本规范中，“x 的 Number 值”表示 x 是某个精确的数学实数（甚至可能是无理数如 π），其 Number 值按如下方式选取：取所有
+∞ 的 Number 值为
某些 ECMAScript 运算符只处理范围特定的整数，比如 [-231, 231 - 1] 或 [0, 216 - 1]。这些运算符接受任意 Number 类型值，但会先将其转换为预期范围的整数。具体转换见
6.1.6.1.1 Number::unaryMinus ( x )
The abstract operation Number::unaryMinus takes argument x (一个 Number) and returns 一个 Number. It performs the following steps when called:
- 如果 x 是
NaN ，返回NaN 。 - 返回 x 的相反数；即生成一个数值，大小相同，符号相反。
6.1.6.1.2 Number::bitwiseNOT ( x )
The abstract operation Number::bitwiseNOT takes argument x (一个 Number) and returns 一个整数 Number. It performs the following steps when called:
6.1.6.1.3 Number::exponentiate ( base, exponent )
The abstract operation Number::exponentiate takes arguments base (一个 Number) and exponent (一个 Number) and returns 一个 Number. 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 是奇数整数 Number，返回
-∞ 𝔽；否则返回+∞ 𝔽。
- 如果 exponent 是奇数整数 Number，返回
- 否则：
- 如果 exponent 是奇数整数 Number，返回
-0 𝔽；否则返回+0 𝔽。
- 如果 exponent 是奇数整数 Number，返回
- 如果 exponent >
- 如果 base 是
+0 𝔽：- 如果 exponent >
+0 𝔽，返回+0 𝔽；否则返回+∞ 𝔽。
- 如果 exponent >
- 如果 base 是
-0 𝔽：- 如果 exponent >
+0 𝔽：- 如果 exponent 是奇数整数 Number，返回
-0 𝔽；否则返回+0 𝔽。
- 如果 exponent 是奇数整数 Number，返回
- 否则：
- 如果 exponent 是奇数整数 Number，返回
-∞ 𝔽；否则返回+∞ 𝔽。
- 如果 exponent 是奇数整数 Number，返回
- 如果 exponent >
- 断言：base 是
有限 值且不是+0 𝔽 也不是-0 𝔽。 - 如果 exponent 是
+∞ 𝔽： - 如果 exponent 是
-∞ 𝔽： - 断言：exponent 是
有限 值且不是+0 𝔽 也不是-0 𝔽。 - 如果 base <
-0 𝔽 且 exponent 不是整数 Number，返回NaN 。 - 返回一个
实现近似 的 Number 值，表示ℝ (base) 的ℝ (exponent) 次幂。
当 base 为 ** exponent 的结果与
6.1.6.1.4 Number::multiply ( x, y )
The abstract operation Number::multiply takes arguments x (一个 Number) and y (一个 Number) and returns 一个 Number. It performs the following steps when called:
6.1.6.1.5 Number::divide ( x, y )
The abstract operation Number::divide takes arguments x (一个 Number) and y (一个 Number) and returns 一个 Number. It performs the following steps when called:
- 如果 x 或 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 ( n, d )
The abstract operation Number::remainder takes arguments n (一个 Number) and d (一个 Number) and returns 一个 Number. It performs the following steps when called:
C 和 C++ 的余数运算符只接受整数操作数；而 ECMAScript 也接受浮点数操作数。
% 的结果与 % 运算针对浮点数时的行为类似于 Java 6.1.6.1.7 Number::add ( x, y )
The abstract operation Number::add takes arguments x (一个 Number) and y (一个 Number) and returns 一个 Number. It performs the following steps when called:
6.1.6.1.8 Number::subtract ( x, y )
The abstract operation Number::subtract takes arguments x (一个 Number) and y (一个 Number) and returns 一个 Number. 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 (一个 Number) and y (一个 Number) and returns 一个整数 Number. It performs the following steps when called:
6.1.6.1.10 Number::signedRightShift ( x, y )
The abstract operation Number::signedRightShift takes arguments x (一个 Number) and y (一个 Number) and returns 一个整数 Number. It performs the following steps when called:
6.1.6.1.11 Number::unsignedRightShift ( x, y )
The abstract operation Number::unsignedRightShift takes arguments x (一个 Number) and y (一个 Number) and returns 一个整数 Number. It performs the following steps when called:
6.1.6.1.12 Number::lessThan ( x, y )
The abstract operation Number::lessThan takes arguments x (一个 Number) and y (一个 Number) and returns Boolean 或
6.1.6.1.13 Number::equal ( x, y )
The abstract operation Number::equal takes arguments x (一个 Number) and y (一个 Number) and returns 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 (一个 Number) and y (一个 Number) and returns Boolean. It performs the following steps when called:
- 如果 x 和 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 (一个 Number) and y (一个 Number) and returns Boolean. It performs the following steps when called:
- 如果 x 和 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 (&, ^, 或 |), x (一个 Number), and y (一个 Number) and returns 一个整数 Number. It performs the following steps when called:
6.1.6.1.17 Number::bitwiseAND ( x, y )
The abstract operation Number::bitwiseAND takes arguments x (一个 Number) and y (一个 Number) and returns 一个整数 Number. It performs the following steps when called:
- 返回
NumberBitwiseOp (&, x, y)。
6.1.6.1.18 Number::bitwiseXOR ( x, y )
The abstract operation Number::bitwiseXOR takes arguments x (一个 Number) and y (一个 Number) and returns 一个整数 Number. It performs the following steps when called:
- 返回
NumberBitwiseOp (^, x, y)。
6.1.6.1.19 Number::bitwiseOR ( x, y )
The abstract operation Number::bitwiseOR takes arguments x (一个 Number) and y (一个 Number) and returns 一个整数 Number. It performs the following steps when called:
- 返回
NumberBitwiseOp (|, x, y)。
6.1.6.1.20 Number::toString ( x, radix )
The abstract operation Number::toString takes arguments x (一个 Number) and radix (2 到 36 之间的整数) and returns 一个字符串. It performs the following steps when called:
- 如果 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 整除，且最低位未必唯一。 - 如果 radix ≠ 10 或 n 在 -5 到 21 的
区间 内：- 如果 n ≥ k：
- 返回拼接字符串：
- 用基数 radix 表示 s 的 k 位数字
- n - k 个 0x0030（数字零）码位
- 返回拼接字符串：
- 否则如 n > 0：
- 返回拼接字符串：
- 用基数 radix 表示 s 的最高 n 位数字
- 0x002E（英文句点）
- 剩余 k - n 位数字
- 返回拼接字符串：
- 否则：
- 断言：n ≤ 0。
- 返回拼接字符串：
- 0x0030（数字零）码位
- 0x002E（英文句点）
- -n 个 0x0030（数字零）码位
- 用基数 radix 表示 s 的 k 位数字
- 如果 n ≥ k：
- 注意：此时输入会用科学 E 记数法表示，如
1.2e+3。 - 断言：radix 为 10。
- 如果 n < 0：
- 令 exponentSign 为 0x002D（减号）。
- 否则：
- 令 exponentSign 为 0x002B（加号）。
- 如果 k = 1：
- 返回拼接字符串：
- s 的单一数字码位
- 0x0065（小写字母 e）
- exponentSign
abs (n - 1) 的十进制表示码位
- 返回拼接字符串：
- 返回拼接字符串：
- s 十进制表示的最高位数字码位
- 0x002E（英文句点）
- s 十进制表示的剩余 k - 1 位码位
- 0x0065（小写字母 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). 1990 年 11 月 30 日。参见
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 类型表示整数值。该值可以为任意大小，不受特定位宽限制。通常，除非另有说明，相关操作都设计为返回精确的数学答案。对于二元运算，BigInt 被视为二进制补码字符串，负数则被视为左边有无限个被置位的位。
6.1.6.2.1 BigInt::unaryMinus ( x )
The abstract operation BigInt::unaryMinus takes argument x (一个 BigInt) and returns 一个 BigInt. It performs the following steps when called:
- 如果 x =
0 ℤ，返回0 ℤ。 - 返回 -x。
6.1.6.2.2 BigInt::bitwiseNOT ( x )
The abstract operation BigInt::bitwiseNOT takes argument x (一个 BigInt) and returns 一个 BigInt. It performs the following steps when called:
- 返回 -x -
1 ℤ。
6.1.6.2.3 BigInt::exponentiate ( base, exponent )
The abstract operation BigInt::exponentiate takes arguments base (一个 BigInt) and exponent (一个 BigInt) and returns 正常返回一个 BigInt 或抛出异常. 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 (一个 BigInt) and y (一个 BigInt) and returns 一个 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 (一个 BigInt) and y (一个 BigInt) and returns 正常返回一个 BigInt 或抛出异常. It performs the following steps when called:
6.1.6.2.6 BigInt::remainder ( n, d )
The abstract operation BigInt::remainder takes arguments n (一个 BigInt) and d (一个 BigInt) and returns 正常返回一个 BigInt 或抛出异常. It performs the following steps when called:
6.1.6.2.7 BigInt::add ( x, y )
The abstract operation BigInt::add takes arguments x (一个 BigInt) and y (一个 BigInt) and returns 一个 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 (一个 BigInt) and y (一个 BigInt) and returns 一个 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 (一个 BigInt) and y (一个 BigInt) and returns 一个 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 (一个 BigInt) and y (一个 BigInt) and returns 一个 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 (一个 BigInt) and y (一个 BigInt) and returns 抛出异常. 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 (一个 BigInt) and y (一个 BigInt) and returns 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 (一个 BigInt) and y (一个 BigInt) and returns Boolean. It performs the following steps when called:
6.1.6.2.14 BinaryAnd ( x, y )
The abstract operation BinaryAnd takes arguments x (0 或 1) and y (0 或 1) and returns 0 或 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 或 1) and y (0 或 1) and returns 0 或 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 或 1) and y (0 或 1) and returns 0 或 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 (&, ^, 或 |), x (一个 BigInt), and y (一个 BigInt) and returns 一个 BigInt. It performs the following steps when called:
6.1.6.2.18 BigInt::bitwiseAND ( x, y )
The abstract operation BigInt::bitwiseAND takes arguments x (一个 BigInt) and y (一个 BigInt) and returns 一个 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 (一个 BigInt) and y (一个 BigInt) and returns 一个 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 (一个 BigInt) and y (一个 BigInt) and returns 一个 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 (一个 BigInt) and radix (2 到 36 之间的整数) and returns 一个字符串. It performs the following steps when called:
- 如果 x <
0 ℤ，返回"-" 和BigInt::toString (-x, radix) 的拼接字符串。 - 返回用基数 radix 表示 x 的字符串值。
6.1.7 对象类型
每个 Object 类型的实例，也简称为“对象”，表示一组属性的集合。每个属性要么是数据属性，要么是访问器属性：
-
数据属性将一个键值与一个
ECMAScript 语言值 以及一组布尔属性关联起来。 -
访问器属性将一个键值与一个或两个访问器函数以及一组布尔属性关联起来。访问器函数用于存储或获取与该属性相关联的
ECMAScript 语言值 。
对象的属性通过
整数索引是
所有对象在逻辑上都是属性的集合，但对象有多种形式，不同形式在访问和操作属性时语义有所区别。参见
此外，某些对象可调用，被称为函数或
6.1.7.1 属性特性
本规范使用属性（attributes）来定义和解释对象属性的状态，详见
| 特性名称 | 适用属性类型 | 值域 | 默认值 | 描述 |
|---|---|---|---|---|
| [[Value]] |
|
一个 |
|
通过 get 访问属性时获得的值。 |
| [[Writable]] |
|
布尔值 |
|
如果为 |
| [[Get]] |
|
对象或 |
|
如果值是对象，则必须为 |
| [[Set]] |
|
对象或 |
|
如果值是对象，则必须为 |
| [[Enumerable]] |
|
布尔值 |
|
如果为 |
| [[Configurable]] |
|
布尔值 |
|
如果为 |
6.1.7.2 对象的内部方法与内部槽
ECMAScript 中对象的实际语义通过称为内部方法的算法来定义。每个 ECMAScript 引擎中的对象都关联一组内部方法，定义其运行时行为。这些内部方法不是 ECMAScript 语言的一部分，仅供规范说明之用。但 ECMAScript 的每个对象都必须符合其关联的内部方法的行为，具体实现方式由实现决定。
内部方法名称是多态的。意味着不同对象值在调用相同内部方法名时可以执行不同的算法。被调用的实际对象是该方法的“目标”。如果在运行时算法实现尝试使用一个对象未支持的内部方法，则抛出
内部槽对应于与对象、Symbol 或私有名称关联的内部状态，被 ECMAScript 规范的各种算法使用。内部槽不是对象属性，也不会被继承。根据具体内部槽的规定，这些状态可以是任意 ECMAScript 类型值或特定 ECMAScript 规范类型值。除非另有说明，内部槽在创建对象、Symbol 或私有名称时分配，不能动态添加。除非另有说明，内部槽的初始值是
所有对象都有名为 [[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, PropertyDescriptor) → Boolean |
创建或更改自身属性（键为 propertyKey），使其状态与 PropertyDescriptor 描述一致。成功时返回 |
| [[HasProperty]] | (propertyKey) → Boolean | 返回布尔值，表示此对象是否已有自身或继承属性，其键为 propertyKey。 |
| [[Get]] | (propertyKey, Receiver) → any |
获取此对象中键为 propertyKey 的属性值。若需执行 ECMAScript 代码以获取属性值，则 Receiver 作为 |
| [[Set]] | (propertyKey, value, Receiver) → Boolean |
将键为 propertyKey 的属性值设为 value。若需执行 ECMAScript 代码以设置属性值，则 Receiver 作为 |
| [[Delete]] | (propertyKey) → Boolean |
删除自身 |
| [[OwnPropertyKeys]] |
( ) → |
返回对象所有自身 |
6.1.7.3 基本内部方法的不变量
ECMAScript 引擎中的对象的内部方法必须符合下列不变量。普通 ECMAScript 对象以及本规范中的所有标准
任何实现提供的
实现不得以任何方式绕过这些不变量，比如提供不强制不变量的方法接口来实现基本内部方法。
定义：
- 内部方法的目标是调用该内部方法的对象。
-
如果目标的 [[IsExtensible]] 方法返回
false 或 [[PreventExtensions]] 方法返回true ，则称为不可扩展。 - 不存在属性指在不可扩展目标对象上不存在的自身属性。
-
所有对
SameValue 的引用均依照SameValue 算法定义。
返回值：
任何内部方法返回的值必须是一个
- [[Type]] =
normal ，[[Target]] =empty ，[[Value]] = 该内部方法下方“正常返回类型”对应的值，或 - [[Type]] =
throw ，[[Target]] =empty ，[[Value]] = 任意ECMAScript 语言值 。
内部方法不得返回 continue、break 或 return 类型的
[[GetPrototypeOf]] ( )
- 正常返回类型为 Object 或 Null。
-
如果目标为不可扩展，且 [[GetPrototypeOf]] 返回值 V，则未来对 [[GetPrototypeOf]] 的调用都应返回与 V
SameValue 的值。
[[SetPrototypeOf]] ( V )
- 正常返回类型为 Boolean。
-
如果目标为不可扩展，[[SetPrototypeOf]] 必须返回
false ，除非 V 与目标已观察到的 [[GetPrototypeOf]] 值SameValue 。
[[IsExtensible]] ( )
- 正常返回类型为 Boolean。
-
如果 [[IsExtensible]] 返回
false ，则未来对目标的所有 [[IsExtensible]] 调用都必须返回false 。
[[PreventExtensions]] ( )
- 正常返回类型为 Boolean。
-
如果 [[PreventExtensions]] 返回
true ，则未来对目标的所有 [[IsExtensible]] 调用都必须返回false ，且目标被视为不可扩展。
[[GetOwnProperty]] ( P )
-
正常返回类型为
Property Descriptor 或 Undefined。 -
如果返回值为
Property Descriptor ，必须是完整的Property Descriptor 。 -
如果 P 被描述为不可配置、不可写的自身
数据属性 ，则未来对 [[GetOwnProperty]] ( P ) 的所有调用都必须返回 [[Value]] 与 P 的 [[Value]] 属性SameValue 的Property Descriptor 。 -
如果 P 除 [[Writable]] 和 [[Value]] 外的属性可能随时间变化，或属性可能被删除，则 P 的 [[Configurable]] 属性必须为
true 。 -
如果 [[Writable]] 属性可能从
false 变为true ，则 [[Configurable]] 属性必须为true 。 -
如果目标为不可扩展且 P 不存在，则未来对目标的所有 [[GetOwnProperty]] (P) 调用都必须描述 P 为不存在（即返回
undefined ）。
由第三条不变量可知，如果某属性被描述为
[[DefineOwnProperty]] ( P, Desc )
- 正常返回类型为 Boolean。
-
除非满足以下之一，否则 [[DefineOwnProperty]] 必须返回
false ，如果 P 已被观察为目标的不可配置自身属性： -
如果目标为不可扩展且 P 是不存在的自身属性，则 [[DefineOwnProperty]] (P, Desc) 必须返回
false 。即不可扩展对象不能添加新属性。
[[HasProperty]] ( P )
- 正常返回类型为 Boolean。
-
如果 P 已被观察为目标的不可配置自身数据或
访问器属性 ，则 [[HasProperty]] 必须返回true 。
[[Get]] ( P, Receiver )
-
正常返回类型为任意
ECMAScript 语言类型 。 -
如果 P 已被观察为目标的不可配置、不可写自身
数据属性 且值为 V，则 [[Get]] 必须返回与 VSameValue 的值。 -
如果 P 已被观察为目标的不可配置自身
访问器属性 且 [[Get]] 属性为undefined ，则 [[Get]] 操作必须返回undefined 。
[[Set]] ( P, V, Receiver )
- 正常返回类型为 Boolean。
-
如果 P 已被观察为目标的不可配置、不可写自身
数据属性 ，则除非 V 与 P 的 [[Value]] 属性SameValue ，[[Set]] 必须返回false 。 -
如果 P 已被观察为目标的不可配置自身
访问器属性 且 [[Set]] 属性为undefined ，则 [[Set]] 操作必须返回false 。
[[Delete]] ( P )
- 正常返回类型为 Boolean。
-
如果 P 已被观察为目标的不可配置自身数据或
访问器属性 ，则 [[Delete]] 必须返回false 。
[[OwnPropertyKeys]] ( )
-
正常返回类型为
List 。 -
返回的
List 不能有重复项。 -
返回的
List 的每个元素必须是属性键 。 -
返回的
List 至少含有所有已观察到的不可配置自身属性的键。 -
如果目标为不可扩展，则返回的
List 只能包含所有可通过 [[GetOwnProperty]] 观察到的自身属性键 。
[[Call]] ( )
-
正常返回类型为任意
ECMAScript 语言类型 。
[[Construct]] ( )
- 正常返回类型为 Object。
- 目标还必须有 [[Call]] 内部方法。
6.1.7.4 知名内置对象
知名内置对象是本规范的算法显式引用的内置对象，通常具有特定于“域”（
在本规范中，%name% 表示当前域关联的对应名称的内置对象。%name.a.b% 表示在执行任何 ECMAScript 代码之前，访问内置对象 %name% 的属性 "a"，再访问该属性的 "b" 属性。当前域和其内置对象的确定见
| 内置名称 | 全局名称 | ECMAScript 语言关联 |
|---|---|---|
|
|
AggregateError
|
AggregateError |
|
|
Array
|
Array |
|
|
ArrayBuffer
|
ArrayBuffer |
|
|
数组迭代器对象的原型（参见 |
|
|
|
Async-from-Sync 迭代器对象的原型（参见 |
|
|
|
async |
|
|
|
async 生成器 |
|
|
|
async 生成器对象的原型（参见 |
|
|
|
所有标准内置 async 迭代器对象的间接继承对象 | |
|
|
Atomics
|
Atomics 对象（参见 |
|
|
BigInt
|
BigInt |
|
|
BigInt64Array
|
BigInt64Array |
|
|
BigUint64Array
|
BigUint64Array |
|
|
Boolean
|
Boolean |
|
|
DataView
|
DataView |
|
|
Date
|
Date |
|
|
decodeURI
|
decodeURI 函数（参见 |
|
|
decodeURIComponent
|
decodeURIComponent 函数（参见 |
|
|
encodeURI
|
encodeURI 函数（参见 |
|
|
encodeURIComponent
|
encodeURIComponent 函数（参见 |
|
|
Error
|
Error |
|
|
eval
|
eval 函数（参见 |
|
|
EvalError
|
EvalError |
|
|
FinalizationRegistry
|
|
|
|
Float16Array
|
Float16Array |
|
|
Float32Array
|
Float32Array |
|
|
Float64Array
|
Float64Array |
|
|
For-In 迭代器对象的原型（参见 |
|
|
|
Function
|
Function |
|
|
生成器 |
|
|
|
生成器对象的原型（参见 |
|
|
|
Int8Array
|
Int8Array |
|
|
Int16Array
|
Int16Array |
|
|
Int32Array
|
Int32Array |
|
|
isFinite
|
isFinite 函数（参见 |
|
|
isNaN
|
isNaN 函数（参见 |
|
|
Iterator
|
Iterator |
|
|
|
|
|
|
JSON
|
JSON 对象（参见 |
|
|
Map
|
Map |
|
|
Map 迭代器对象的原型（参见 |
|
|
|
Math
|
Math 对象（参见 |
|
|
Number
|
Number |
|
|
Object
|
Object |
|
|
parseFloat
|
parseFloat 函数（参见 |
|
|
parseInt
|
parseInt 函数（参见 |
|
|
Promise
|
Promise |
|
|
Proxy
|
Proxy |
|
|
RangeError
|
RangeError |
|
|
ReferenceError
|
ReferenceError |
|
|
Reflect
|
Reflect 对象（参见 |
|
|
RegExp
|
RegExp |
|
|
正则表达式字符串迭代器对象的原型（参见 |
|
|
|
Set
|
Set |
|
|
Set 迭代器对象的原型（参见 |
|
|
|
SharedArrayBuffer
|
SharedArrayBuffer |
|
|
String
|
String |
|
|
字符串迭代器对象的原型（参见 |
|
|
|
Symbol
|
Symbol |
|
|
SyntaxError
|
SyntaxError |
|
|
一个 |
|
|
|
所有类型化数组 |
|
|
|
TypeError
|
TypeError |
|
|
Uint8Array
|
Uint8Array |
|
|
Uint8ClampedArray
|
Uint8ClampedArray |
|
|
Uint16Array
|
Uint16Array |
|
|
Uint32Array
|
Uint32Array |
|
|
URIError
|
URIError |
|
|
WeakMap
|
WeakMap |
|
|
WeakRef
|
|
|
|
WeakSet
|
WeakSet |
|
|
Iterator.from 返回的包装迭代器对象的原型（参见 |
更多条目见
6.2 ECMAScript 规范类型
规范类型对应于算法中用于描述 ECMAScript 语言结构和
6.2.1 枚举规范类型
枚举是规范内部使用的值，不能被 ECMAScript 代码直接观察。枚举用
6.2.2 List 和 Record 规范类型
List 类型用于解释参数列表（参见 new 表达式、函数调用以及需要简单有序值列表的其他算法中的求值。List 类型的值就是包含各个值的有序元素序列，序列长度可任意。List 的元素可用 0 起始的索引随机访问。为方便记号，可用类似数组的语法访问 List 元素。例如，arguments[2] 表示 List arguments 的第 3 个元素。
当算法遍历 List 元素但未指定顺序时，使用 List 元素的原有顺序。
在本规范中，为方便记号，可用字面量语法表达新的 List 值。例如，« 1, 2 » 定义了一个有两个元素的 List 值，每个元素初始化为特定值。空 List 可写作 « »。
在本规范中，“A、B... 的列表拼接”（每个参数都是可能为空的 List）表示一个新 List，其元素是各参数元素（按顺序）拼接而成。
对于字符串 List，“按字典序码位顺序排序”意指按较短字符串长度以内各码位的数值排序，如相等则短字符串排前，详见
Record 类型用于规范算法中的数据聚合。Record 类型值由一个或多个具名字段组成，每个字段的值为
在规范中，为方便记号，可用类似对象字面量的语法表达 Record 值。例如，{ [[Field1]]: 42, [[Field2]]:
在规范文本和算法中，可用点号表示法引用 Record 的某个字段。例如，若 R 为上文的 Record，则 R.[[Field2]] 表示“R 的 [[Field2]] 字段”。
常用字段组合的 Record 可以命名，并作为字面量前缀，以标识描述的聚合类型。例如：PropertyDescriptor { [[Value]]: 42, [[Writable]]:
6.2.3 Set 和 Relation 规范类型
Set 类型用于说明
Relation 类型用于说明集合上的约束。Relation 类型值是其值域上的有序对集合。例如，事件上的 Relation 是事件有序对的集合。若 Relation R，值域中的 a 和 b，则 a R b 表示有序对 (a, b) 属于 R。Relation 是满足某些条件的最小 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 Record 包含
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Type]] |
|
发生的完成类型。 |
| [[Value]] |
除 |
产生的值。 |
| [[Target]] |
字符串或 |
用于定向控制转移的目标标签。 |
下列术语有时用于指代 Completion Record：
- 正常完成指 [[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]] 字段为该类型值的正常完成。
规范中定义的可调用对象只返回正常完成或 throw 完成。返回其他类型的 Completion Record 属于编辑错误。
6.2.4.1 NormalCompletion ( value )
The abstract operation NormalCompletion takes argument value (除
- 返回
Completion Record { [[Type]]:normal , [[Value]]: value, [[Target]]:empty }。
6.2.4.2 ThrowCompletion ( value )
The abstract operation ThrowCompletion takes argument value (一个
- 返回
Completion Record { [[Type]]:throw , [[Value]]: value, [[Target]]:empty }。
6.2.4.3 ReturnCompletion ( value )
The abstract operation ReturnCompletion takes argument value (一个
- 返回
Completion Record { [[Type]]:return , [[Value]]: value, [[Target]]:empty }。
6.2.4.4 UpdateEmpty ( completionRecord, value )
The abstract operation UpdateEmpty takes arguments completionRecord (一个
- 断言：若 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。
Reference Record 是已解析的名称或（可能尚未解析的）属性绑定；其字段定义见
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Base]] | 一个 |
持有绑定的值或 |
| [[ReferencedName]] | 一个 |
绑定的名称。若 [[Base]] 为 |
| [[Strict]] | 布尔值 | 若 |
| [[ThisValue]] | 一个 |
若非 super 关键字表达的属性绑定，称为 Super Reference Record，其 [[Base]] 不会是 |
本规范使用以下
6.2.5.1 IsPropertyReference ( V )
The abstract operation IsPropertyReference takes argument V (一个
- 若 V.[[Base]] 为
unresolvable ，返回false 。 - 若 V.[[Base]] 为
Environment Record ，返回false ；否则返回true 。
6.2.5.2 IsUnresolvableReference ( V )
The abstract operation IsUnresolvableReference takes argument V (一个
- 若 V.[[Base]] 为
unresolvable ，返回true ；否则返回false 。
6.2.5.3 IsSuperReference ( V )
The abstract operation IsSuperReference takes argument V (一个
- 若 V.[[ThisValue]] 非
empty ，返回true ；否则返回false 。
6.2.5.4 IsPrivateReference ( V )
The abstract operation IsPrivateReference takes argument V (一个
- 若 V.[[ReferencedName]] 是
Private Name ，返回true ；否则返回false 。
6.2.5.5 GetValue ( V )
The abstract operation GetValue takes argument V (一个
- 若 V 不是
Reference Record ，返回 V。 - 若
IsUnresolvableReference (V) 为true ，抛出ReferenceError 异常。 - 若
IsPropertyReference (V) 为true ，- 令 baseObj 为 ?
ToObject (V.[[Base]])。 - 若
IsPrivateReference (V) 为true ，- 返回 ?
PrivateGet (baseObj, V.[[ReferencedName]])。
- 返回 ?
- 若 V.[[ReferencedName]] 不是
属性键 ，- 令 V.[[ReferencedName]] 为 ?
ToPropertyKey (V.[[ReferencedName]])。
- 令 V.[[ReferencedName]] 为 ?
- 返回 ? baseObj.[[Get]](V.[[ReferencedName]],
GetThisValue (V))。
- 令 baseObj 为 ?
- 否则，
- 令 base 为 V.[[Base]]。
- 断言：base 是
Environment Record 。 - 返回 ? base.GetBindingValue(V.[[ReferencedName]], V.[[Strict]])（参见
9.1 ）。
6.2.5.6 PutValue ( V, W )
The abstract operation PutValue takes arguments V (一个
- 若 V 不是
Reference Record ，抛出ReferenceError 异常。 - 若
IsUnresolvableReference (V) 为true ，- 若 V.[[Strict]] 为
true ，抛出ReferenceError 异常。 - 令 globalObj 为
GetGlobalObject ()。 - 执行 ?
Set (globalObj, V.[[ReferencedName]], W,false )。 - 返回
unused 。
- 若 V.[[Strict]] 为
- 若
IsPropertyReference (V) 为true ，- 令 baseObj 为 ?
ToObject (V.[[Base]])。 - 若
IsPrivateReference (V) 为true ，- 返回 ?
PrivateSet (baseObj, V.[[ReferencedName]], W)。
- 返回 ?
- 若 V.[[ReferencedName]] 不是
属性键 ，- 令 V.[[ReferencedName]] 为 ?
ToPropertyKey (V.[[ReferencedName]])。
- 令 V.[[ReferencedName]] 为 ?
- 令 succeeded 为 ? baseObj.[[Set]](V.[[ReferencedName]], W,
GetThisValue (V))。 - 若 succeeded 为
false 且 V.[[Strict]] 为true ，抛出TypeError 异常。 - 返回
unused 。
- 令 baseObj 为 ?
- 否则，
- 令 base 为 V.[[Base]]。
- 断言：base 是
Environment Record 。 - 返回 ? base.SetMutableBinding(V.[[ReferencedName]], W, V.[[Strict]])（参见
9.1 ）。
6.2.5.7 GetThisValue ( V )
The abstract operation GetThisValue takes argument V (一个
- 断言：
IsPropertyReference (V) 为true 。 - 若
IsSuperReference (V) 为true ，返回 V.[[ThisValue]]；否则返回 V.[[Base]]。
6.2.5.8 InitializeReferencedBinding ( V, W )
The abstract operation InitializeReferencedBinding takes arguments V (一个
- 断言：
IsUnresolvableReference (V) 为false 。 - 令 base 为 V.[[Base]]。
- 断言：base 是
Environment Record 。 - 返回 ? base.InitializeBinding(V.[[ReferencedName]], W)。
6.2.5.9 MakePrivateReference ( baseValue, privateIdentifier )
The abstract operation MakePrivateReference takes arguments baseValue (一个
- 令 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 类型用于解释对象属性特性的操作及具现。Property Descriptor 是一个包含零个或多个字段的
Property Descriptor 值可根据某些字段的存在或用途进一步分为数据 Property Descriptor 和访问器 Property Descriptor。包含 [[Value]] 或 [[Writable]] 字段的为数据 Property Descriptor；包含 [[Get]] 或 [[Set]] 字段的为访问器 Property Descriptor。任意 Property Descriptor 都可包含 [[Enumerable]] 和 [[Configurable]] 字段。Property Descriptor 值不能同时为数据和访问器 Property Descriptor，但可以两者都不是（此时为通用 Property Descriptor）。完全填充的 Property Descriptor指为访问器 Property Descriptor 或数据 Property Descriptor 且已定义所有对应字段（见
本规范用以下
6.2.6.1 IsAccessorDescriptor ( Desc )
The abstract operation IsAccessorDescriptor takes argument Desc (一个
- 若 Desc 有 [[Get]] 字段，返回
true 。 - 若 Desc 有 [[Set]] 字段，返回
true 。 - 返回
false 。
6.2.6.2 IsDataDescriptor ( Desc )
The abstract operation IsDataDescriptor takes argument Desc (一个
- 若 Desc 有 [[Value]] 字段，返回
true 。 - 若 Desc 有 [[Writable]] 字段，返回
true 。 - 返回
false 。
6.2.6.3 IsGenericDescriptor ( Desc )
The abstract operation IsGenericDescriptor takes argument Desc (一个
- 若
IsAccessorDescriptor (Desc) 为true ，返回false 。 - 若
IsDataDescriptor (Desc) 为true ，返回false 。 - 返回
true 。
6.2.6.4 FromPropertyDescriptor ( Desc )
The abstract operation FromPropertyDescriptor takes argument Desc (一个
- 若 Desc 为
undefined ，返回undefined 。 - 令 obj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 断言：obj 是可扩展的
普通对象 且无自身属性。 - 若 Desc 有 [[Value]] 字段，
- 执行 !
CreateDataPropertyOrThrow (obj,"value" , Desc.[[Value]])。
- 执行 !
- 若 Desc 有 [[Writable]] 字段，
- 执行 !
CreateDataPropertyOrThrow (obj,"writable" , Desc.[[Writable]])。
- 执行 !
- 若 Desc 有 [[Get]] 字段，
- 执行 !
CreateDataPropertyOrThrow (obj,"get" , Desc.[[Get]])。
- 执行 !
- 若 Desc 有 [[Set]] 字段，
- 执行 !
CreateDataPropertyOrThrow (obj,"set" , Desc.[[Set]])。
- 执行 !
- 若 Desc 有 [[Enumerable]] 字段，
- 执行 !
CreateDataPropertyOrThrow (obj,"enumerable" , Desc.[[Enumerable]])。
- 执行 !
- 若 Desc 有 [[Configurable]] 字段，
- 执行 !
CreateDataPropertyOrThrow (obj,"configurable" , Desc.[[Configurable]])。
- 执行 !
- 返回 obj。
6.2.6.5 ToPropertyDescriptor ( Obj )
The abstract operation ToPropertyDescriptor takes argument Obj (一个
- 若 Obj 不是对象，抛出
TypeError 异常。 - 令 desc 为一个初始无字段的新
Property Descriptor 。 - 令 hasEnumerable 为 ?
HasProperty (Obj,"enumerable" )。 - 若 hasEnumerable 为
true ， - 令 hasConfigurable 为 ?
HasProperty (Obj,"configurable" )。 - 若 hasConfigurable 为
true ， - 令 hasValue 为 ?
HasProperty (Obj,"value" )。 - 若 hasValue 为
true ，- 令 value 为 ?
Get (Obj,"value" )。 - 设置 desc.[[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 异常。 - 设置 desc.[[Get]] 为 getter。
- 令 getter 为 ?
- 令 hasSet 为 ?
HasProperty (Obj,"set" )。 - 若 hasSet 为
true ，- 令 setter 为 ?
Get (Obj,"set" )。 - 若
IsCallable (setter) 为false 且 setter 不为undefined ，抛出TypeError 异常。 - 设置 desc.[[Set]] 为 setter。
- 令 setter 为 ?
- 若 desc 有 [[Get]] 字段或 [[Set]] 字段，
- 若 desc 有 [[Value]] 字段或 [[Writable]] 字段，抛出
TypeError 异常。
- 若 desc 有 [[Value]] 字段或 [[Writable]] 字段，抛出
- 返回 desc。
6.2.6.6 CompletePropertyDescriptor ( Desc )
The abstract operation CompletePropertyDescriptor takes argument Desc (一个
- 令 like 为
Record { [[Value]]:undefined , [[Writable]]:false , [[Get]]:undefined , [[Set]]:undefined , [[Enumerable]]:false , [[Configurable]]:false }。 - 若
IsGenericDescriptor (Desc) 为true 或IsDataDescriptor (Desc) 为true ，- 若 Desc 无 [[Value]] 字段，设置 Desc.[[Value]] 为 like.[[Value]]。
- 若 Desc 无 [[Writable]] 字段，设置 Desc.[[Writable]] 为 like.[[Writable]]。
- 否则，
- 若 Desc 无 [[Get]] 字段，设置 Desc.[[Get]] 为 like.[[Get]]。
- 若 Desc 无 [[Set]] 字段，设置 Desc.[[Set]] 为 like.[[Set]]。
- 若 Desc 无 [[Enumerable]] 字段，设置 Desc.[[Enumerable]] 为 like.[[Enumerable]]。
- 若 Desc 无 [[Configurable]] 字段，设置 Desc.[[Configurable]] 为 like.[[Configurable]]。
- 返回
unused 。
6.2.7 Environment Record 规范类型
6.2.8 Abstract Closure 规范类型
Abstract Closure 规范类型用于引用算法步骤及一组值。Abstract Closure 是元值，用函数调用风格如 closure(arg1, arg2) 调用。和
创建 Abstract Closure 的算法步骤，用 “capture” 和别名列表描述需捕获的值。创建时，按别名捕获当时关联的值。指定 Abstract Closure 被调用时的算法步骤时，每个捕获值都用其别名引用。
若 Abstract Closure 返回
Abstract Closure 通常作为其他算法的一部分内联创建，示例如下：
- 令 addend 为 41。
- 令 closure 为新建
Abstract Closure ，参数 (x)，捕获 addend，调用时执行以下步骤：- 返回 x + addend。
- 令 val 为 closure(1)。
- 断言：val 为 42。
6.2.9 数据块
Data Block 规范类型用于描述一段独立且可变的字节（8 位）数值序列。字节值是 0 到 255 的整数。Data Block 值创建时拥有固定数量字节，每个初始值为 0。
在规范中，为方便记号，可用类似数组的语法访问 Data Block 的各字节。该记号将 Data Block 视为 0 起始
可被多个 agent 并发引用的驻留于内存的数据块称为 Shared Data Block。Shared Data Block 有一个用于相等性测试的无地址身份：它不是绑定到任何进程的虚拟地址，而是与所代表的内存位置集合绑定。只有包含的内存位置集合相等，两数据块才相等，否则不等且其集合交集为空。Shared Data Block 可与 Data Block 区分。
Shared Data Block 的语义由
Shared Data Block 事件由
本规范用以下
6.2.9.1 CreateByteDataBlock ( size )
The abstract operation CreateByteDataBlock takes argument size (非负整数) and returns 返回包含
- 若 size > 253 - 1，抛出
RangeError 异常。 - 令 db 为由 size 字节组成的新
Data Block 值。若无法创建该Data Block ，抛出RangeError 异常。 - 将 db 的所有字节设为 0。
- 返回 db。
6.2.9.2 CreateSharedByteDataBlock ( size )
The abstract operation CreateSharedByteDataBlock takes argument size (非负整数) and returns 返回包含
- 令 db 为由 size 字节组成的新
Shared Data Block 值。若无法创建该Shared Data Block ，抛出RangeError 异常。 - 令 execution 为当前 agent 的
Agent Record 的 [[CandidateExecution]] 字段。 - 令 eventsRecord 为 execution.[[EventsRecords]] 中 [[AgentSignifier]] 为
AgentSignifier () 的Agent Events Record 。 - 令 zero 为 « 0 »。
- 对 db 的每个索引 i，
- 将
WriteSharedMemory { [[Order]]:init , [[NoTear]]:true , [[Block]]: db, [[ByteIndex]]: i, [[ElementSize]]: 1, [[Payload]]: zero } 添加到 eventsRecord.[[EventList]]。
- 将
- 返回 db。
6.2.9.3 CopyDataBlockBytes ( toBlock, toIndex, fromBlock, fromIndex, count )
The abstract operation CopyDataBlockBytes takes arguments toBlock (
- 断言：fromBlock 和 toBlock 是不同值。
- 令 fromSize 为 fromBlock 的字节数。
- 断言：fromIndex + count ≤ fromSize。
- 令 toSize 为 toBlock 的字节数。
- 断言：toIndex + count ≤ toSize。
- 当 count > 0 时重复：
- 若 fromBlock 是
Shared Data Block ，- 令 execution 为当前 agent 的
Agent Record 的 [[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]。
- 令 execution 为当前 agent 的
- 否则，
- 断言：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 Name
Private Name 规范类型用于描述全局唯一值（即使与其他 Private Name 外观一致也不同），用于表示私有类元素（字段、方法或访问器）的键。每个 Private Name 有不可变的 [[Description]] 内部槽，为字符串。Private Name 可通过
6.2.13 ClassStaticBlockDefinition Record 规范类型
ClassStaticBlockDefinition Record 是用于封装类静态初始化块可执行代码的
ClassStaticBlockDefinition Record 包含
| 字段名 | 值 | 含义 |
|---|---|---|
| [[BodyFunction]] |
一个 ECMAScript |
类静态初始化时要调用的 |
7 抽象操作 (Abstract Operations)
这些操作不属于 ECMAScript 语言本身；它们仅在此定义，用于辅助描述 ECMAScript 语言语义。本规范其余部分还定义了其他更专业的
7.1 类型转换 (Type Conversion)
ECMAScript 语言会按需隐式执行自动类型转换。为澄清某些结构的语义，有必要定义一组转换类
7.1.1
ToPrimitive (
input: 一个 ECMAScript 语言值,
可选 preferredType: string 或 number ,
): 返回包含一个 ECMAScript 语言值的正常完成或一个抛出完成
The abstract operation UNKNOWN takes UNPARSEABLE ARGUMENTS. 将参数 input 转换为非 Object 的类型。如果一个对象可以转换为多个不同的原始类型，它可利用可选提示 preferredType 来偏向该类型。 It performs the following steps when called:
- 如果 input 是一个 Object，则
- 令 exoticToPrim 为 ?
GetMethod (input,%Symbol.toPrimitive% )。 - 如果 exoticToPrim 不为
undefined ，则- 如果 preferredType 不存在，
- 令 hint 为
"default" 。
- 令 hint 为
- 否则如果 preferredType 是
string ，- 令 hint 为
"string" 。
- 令 hint 为
- 否则，
- 断言：preferredType 是
number 。 - 令 hint 为
"number" 。
- 断言：preferredType 是
- 令 result 为 ? Call(exoticToPrim, input, « hint »)。
- 如果 result 不是一个 Object，返回 result。
- 抛出
TypeError 异常。
- 如果 preferredType 不存在，
- 如果 preferredType 不存在，令 preferredType 为
number 。 - 返回 ?
OrdinaryToPrimitive (input, preferredType)。
- 令 exoticToPrim 为 ?
- 返回 input。
当 ToPrimitive 未带 hint 被调用时，一般表现为 hint 为
7.1.1.1 OrdinaryToPrimitive ( O, hint )
The abstract operation OrdinaryToPrimitive takes arguments O (一个 Object) and hint (
- 如果 hint 是
string ，则- 令 methodNames 为 «
"toString" ,"valueOf" »。
- 令 methodNames 为 «
- 否则，
- 令 methodNames 为 «
"valueOf" ,"toString" »。
- 令 methodNames 为 «
- 对于 methodNames 的每个元素 name，执行
- 令 method 为 ?
Get (O, name)。 - 如果
IsCallable (method) 是true ，则- 令 result 为 ? Call(method, O)。
- 如果 result 不是一个 Object，返回 result。
- 令 method 为 ?
- 抛出
TypeError 异常。
7.1.2 ToBoolean ( argument )
The abstract operation ToBoolean takes argument argument (一个
- 如果 argument 是 Boolean，返回 argument。
- 如果 argument 是
undefined 、null 、+0 𝔽、-0 𝔽、NaN 、0 ℤ 或空字符串，返回false 。 - Normative Optional如果
宿主 是 web 浏览器或支持[[IsHTMLDDA]] 内部槽 ，则- 如果 argument
是 Object 且具有 [[IsHTMLDDA]] 内部槽，返回false 。
- 如果 argument
- 返回
true 。
7.1.3 ToNumeric ( value )
The abstract operation ToNumeric takes argument value (一个
7.1.4 ToNumber ( argument )
The abstract operation ToNumber takes argument argument (一个
- 如果 argument
是 Number ，返回 argument。 - 如果 argument 是 Symbol 或 BigInt，抛出
TypeError 异常。 - 如果 argument 是
undefined ，返回NaN 。 - 如果 argument 是
null 或false ，返回+0 𝔽。 - 如果 argument 是
true ，返回1 𝔽。 - 如果 argument 是 String，返回
StringToNumber (argument)。 - 断言：argument 是一个 Object。
- 令 primValue 为 ? ToPrimitive(argument,
number )。 - 断言：primValue
不是 Object 。 - 返回 ?
ToNumber (primValue)。
7.1.4.1 应用于 String 类型的 ToNumber
Syntax
未在上方显式定义的语法符号，采用数字字面量词法语法 (
需要注意
StringNumericLiteral 可包含前导和/或尾随空白及/或行终止符。- 十进制的
StringNumericLiteral 可以有任意数量的前导0。 - 十进制的
StringNumericLiteral 可以包含+或-来表示符号。 - 空的或只含空白的
StringNumericLiteral 被转换为+0 𝔽。 Infinity和-Infinity被识别为StringNumericLiteral 而非NumericLiteral 。StringNumericLiteral 不能包含BigIntLiteralSuffix 。StringNumericLiteral 不能包含NumericLiteralSeparator 。
7.1.4.1.1 StringToNumber ( str )
The abstract operation StringToNumber takes argument str (一个 String) and returns 一个 Number. It performs the following steps when called:
- 令 literal 为 ParseText(str,
StringNumericLiteral )。 - 如果 literal 是一个错误列表，返回
NaN 。 - 返回 literal 的 StringNumericValue。
7.1.4.1.2 运行时语义：StringNumericValue
The syntax-directed operation
将
It is defined piecewise over the following productions:
- 返回
+0 𝔽。
- 返回
StrNumericLiteral 的 StringNumericValue。
- 返回
𝔽 (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 为其 MV；否则令 e 为 0。 - 返回
RoundMVResult ((a + (b × 10-n)) × 10e)。
- 令 b 为
DecimalDigits 的 MV。 - 如果
ExponentPart 存在，令 e 为其 MV；否则令 e 为 0。 - 令 n 为
DecimalDigits 的码点数量。 - 返回
RoundMVResult (b × 10e - n)。
- 令 a 为
DecimalDigits 的 MV。 - 如果
ExponentPart 存在，令 e 为其 MV；否则令 e 为 0。 - 返回
RoundMVResult (a × 10e)。
7.1.4.1.3 RoundMVResult ( n )
The abstract operation RoundMVResult takes argument n (一个
7.1.5 ToIntegerOrInfinity ( argument )
The abstract operation ToIntegerOrInfinity takes argument argument (一个
7.1.6 ToInt32 ( argument )
The abstract operation ToInt32 takes argument argument (一个
基于上述定义：
- ToInt32 是幂等的：对其输出再次应用结果不变。
- 对所有 x，ToInt32(
ToUint32 (x)) 与 ToInt32(x) 相同。（为保持此性质，+∞ 𝔽 与-∞ 𝔽 被映射为+0 𝔽。） - ToInt32 将
-0 𝔽 映射为+0 𝔽。
7.1.7 ToUint32 ( argument )
The abstract operation ToUint32 takes argument argument (一个
7.1.8 ToInt16 ( argument )
The abstract operation ToInt16 takes argument argument (一个
7.1.9 ToUint16 ( argument )
The abstract operation ToUint16 takes argument argument (一个
7.1.10 ToInt8 ( argument )
The abstract operation ToInt8 takes argument argument (一个
7.1.11 ToUint8 ( argument )
The abstract operation ToUint8 takes argument argument (一个
7.1.12 ToUint8Clamp ( argument )
The abstract operation ToUint8Clamp takes argument argument (一个
不同于大多数整数转换操作，ToUint8Clamp 会四舍五入而不是截断非整数值，它使用“round half to even”平分舍入规则，不同于 Math.round
7.1.13 ToBigInt ( argument )
The abstract operation ToBigInt takes argument argument (一个
- 令 prim 为 ? ToPrimitive(argument,
number )。 - 返回 prim 在
Table 12 中对应的值。
| 参数类型 | 结果 |
|---|---|
| Undefined |
抛出 |
| Null |
抛出 |
| Boolean |
若 prim 为 1n，若为 0n。
|
| BigInt | 返回 prim。 |
| Number |
抛出 |
| String |
|
| Symbol |
抛出 |
7.1.14 StringToBigInt ( str )
The abstract operation StringToBigInt takes argument str (一个 String) and returns 一个 BigInt 或
- 令 literal 为 ParseText(str,
StringIntegerLiteral )。 - 如果 literal 是一个错误列表，返回
undefined 。 - 令 mv 为 literal 的 MV。
- 断言：mv 是整数。
- 返回
ℤ (mv)。
7.1.14.1 StringIntegerLiteral 语法
Syntax
7.1.14.2 运行时语义：MV
-
StringIntegerLiteral ::: StrWhiteSpace opt -
StringIntegerLiteral ::: StrWhiteSpace opt StrIntegerLiteral StrWhiteSpace opt StrIntegerLiteral 的 MV。
7.1.15 ToBigInt64 ( argument )
The abstract operation ToBigInt64 takes argument argument (一个
7.1.16 ToBigUint64 ( argument )
The abstract operation ToBigUint64 takes argument argument (一个
7.1.17 ToString ( argument )
The abstract operation ToString takes argument argument (一个
- 如果 argument 是 String，返回 argument。
- 如果 argument 是 Symbol，抛出
TypeError 异常。 - 如果 argument 是
undefined ，返回"undefined" 。 - 如果 argument 是
null ，返回"null" 。 - 如果 argument 是
true ，返回"true" 。 - 如果 argument 是
false ，返回"false" 。 - 如果 argument
是 Number ，返回Number::toString (argument, 10)。 - 如果 argument
是 BigInt ，返回BigInt::toString (argument, 10)。 - 断言：argument
是 Object 。 - 令 primValue 为 ? ToPrimitive(argument,
string )。 - 断言：primValue
不是 Object 。 - 返回 ?
ToString (primValue)。
7.1.18 ToObject ( argument )
The abstract operation ToObject takes argument argument (一个
- 如果 argument 是
undefined 或null ，抛出TypeError 异常。 - 如果 argument 是 Boolean，返回一个新 Boolean 对象，其 [[BooleanData]] 内部槽设为 argument。详见
20.3 。 - 如果 argument
是 Number ，返回一个新 Number 对象，其 [[NumberData]] 设为 argument。详见21.1 。 - 如果 argument 是 String，返回一个新 String 对象，其 [[StringData]] 设为 argument。详见
22.1 。 - 如果 argument 是 Symbol，返回一个新 Symbol 对象，其 [[SymbolData]] 设为 argument。详见
20.4 。 - 如果 argument
是 BigInt ，返回一个新 BigInt 对象，其 [[BigIntData]] 设为 argument。详见21.2 。 - 断言：argument 是一个 Object。
- 返回 argument。
7.1.19 ToPropertyKey ( argument )
The abstract operation ToPropertyKey takes argument argument (一个
- 令 key 为 ? ToPrimitive(argument,
string )。 - 如果 key 是 Symbol，则
- 返回 key。
- 返回 !
ToString (key)。
7.1.20 ToLength ( argument )
The abstract operation ToLength takes argument argument (一个
- 令 len 为 ?
ToIntegerOrInfinity (argument)。 - 如果 len ≤ 0，返回
+0 𝔽。 - 返回
𝔽 (min (len, 253 - 1))。
7.1.21 CanonicalNumericIndexString ( argument )
The abstract operation CanonicalNumericIndexString takes argument argument (一个 String) and returns 一个 Number 或
规范数值字符串是对其执行 CanonicalNumericIndexString
7.1.22 ToIndex ( value )
The abstract operation ToIndex takes argument value (一个
- 令 integer 为 ?
ToIntegerOrInfinity (value)。 - 如果 integer 不在 0 到 253 - 1（含）内，抛出
RangeError 异常。 - 返回 integer。
7.2 测试与比较操作 (Testing and Comparison Operations)
7.2.1 RequireObjectCoercible ( argument )
The abstract operation RequireObjectCoercible takes argument argument (一个
- 如果 argument 是
undefined 或null ，抛出TypeError 异常。 - 返回
unused 。
7.2.2 IsArray ( argument )
The abstract operation IsArray takes argument argument (一个
- 如果 argument
不是 Object ，返回false 。 - 如果 argument 是 Array exotic object，返回
true 。 - 如果 argument 是 Proxy exotic object，则
- 执行 ?
ValidateNonRevokedProxy (argument)。 - 令 proxyTarget 为 argument.[[ProxyTarget]]。
- 返回 ?
IsArray (proxyTarget)。
- 执行 ?
- 返回
false 。
7.2.3 IsCallable ( argument )
The abstract operation IsCallable takes argument argument (一个
- 如果 argument
不是 Object ，返回false 。 - 如果 argument 具有 [[Call]] 内部方法，返回
true 。 - 返回
false 。
7.2.4 IsConstructor ( argument )
The abstract operation IsConstructor takes argument argument (一个
- 如果 argument
不是 Object ，返回false 。 - 如果 argument 具有 [[Construct]] 内部方法，返回
true 。 - 返回
false 。
7.2.5 IsExtensible ( O )
The abstract operation IsExtensible takes argument O (一个 Object) and returns 返回包含 Boolean 的
- 返回 ? O.[[IsExtensible]]()。
7.2.6 IsRegExp ( argument )
The abstract operation IsRegExp takes argument argument (一个
- 如果 argument
不是 Object ，返回false 。 - 令 matcher 为 ?
Get (argument,%Symbol.match% )。 - 如果 matcher 不为
undefined ，返回ToBoolean (matcher)。 - 如果 argument 有 [[RegExpMatcher]] 内部槽，返回
true 。 - 返回
false 。
7.2.7 静态语义: IsStringWellFormedUnicode ( string: 一个 String, ): 一个 Boolean
The abstract operation UNKNOWN takes UNPARSEABLE ARGUMENTS. 将 string 视为 UTF-16 编码的代码点序列（见
- 令 len 为 string 的长度。
- 令 k 为 0。
- 循环，当 k < len，
- 令 cp 为 CodePointAt(string, k)。
- 如果 cp.[[IsUnpairedSurrogate]] 是
true ，返回false 。 - 设 k 为 k + cp.[[CodeUnitCount]]。
- 返回
true 。
7.2.8 SameType ( x, y )
The abstract operation SameType takes arguments x (一个
7.2.9 SameValue ( x, y )
The abstract operation SameValue takes arguments x (一个
- 如果
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 (一个
- 如果
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 (一个
- 断言：
SameType (x, y) 为true 。 - 如果 x 是
undefined 或null ，返回true 。 - 如果 x
是 BigInt ，则- 返回
BigInt::equal (x, y)。
- 返回
- 如果 x 是 String，则
- 如果 x 与 y 长度相同且相同位置的代码单元相同，返回
true ；否则返回false 。
- 如果 x 与 y 长度相同且相同位置的代码单元相同，返回
- 如果 x 是 Boolean，则
- 若都为
true 或都为false ，返回true ；否则返回false 。
- 若都为
- NOTE: 其他
ECMAScript 语言值 按身份比较。 - 如果 x 是 y，返回
true ；否则返回false 。
7.2.12 IsLessThan ( x, y, LeftFirst )
The abstract operation IsLessThan takes arguments x (一个
- 如果 LeftFirst 为
true ，则- 令 px 为 ? ToPrimitive(x,
number )。 - 令 py 为 ? ToPrimitive(y,
number )。
- 令 px 为 ? ToPrimitive(x,
- 否则，
- NOTE: 需反转求值顺序以保持自左向右求值。
- 令 py 为 ? ToPrimitive(y,
number )。 - 令 px 为 ? ToPrimitive(x,
number )。
- 如果 px 是 String 且 py 是 String，则
- 令 lx 为 px 的长度。
- 令 ly 为 py 的长度。
- 对每个整数 i，0 ≤ i <
min (lx, ly) 递增：- 令 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 为
- NOTE: 因 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
- 如果 nx
- 断言：nx
是 BigInt 且 ny是 Number ，或 nx是 Number 且 ny是 BigInt 。 - 如果 nx 或 ny 是
NaN ，返回undefined 。 - 如果 nx 是
-∞ 𝔽 或 ny 是+∞ 𝔽，返回true 。 - 如果 nx 是
+∞ 𝔽 或 ny 是-∞ 𝔽，返回false 。 - 如果
ℝ (nx) <ℝ (ny)，返回true ；否则返回false 。
- 如果 px
字符串比较使用 UTF-16 代码单元的简单字典序，不使用 Unicode 中更复杂的按语义等价或排序规则。因此按 Unicode 标准规范等价但不同规范化形式的字符串可能判定为不相等；含
7.2.13 IsLooselyEqual ( x, y )
The abstract operation IsLooselyEqual takes arguments x (一个 == 运算符的语义。 It performs the following steps when called:
- 如果
SameType (x, y) 为true ，则- 返回
IsStrictlyEqual (x, y)。
- 返回
- 如果 x 是
null 且 y 是undefined ，返回true 。 - 如果 x 是
undefined 且 y 是null ，返回true 。 - Normative Optional若
宿主 是 web 浏览器或支持[[IsHTMLDDA]] 内部槽 ：- 若 x
是 Object 、具有 [[IsHTMLDDA]] 且 y 是undefined 或null ，返回true 。 - 若 x 是
undefined 或null ，y 是具有 [[IsHTMLDDA]] 的 Object，返回true 。
- 若 x
- 如果 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 (一个 === 运算符的语义。 It performs the following steps when called:
- 如果
SameType (x, y) 为false ，返回false 。 - 如果 x
是 Number ，则- 返回
Number::equal (x, y)。
- 返回
- 返回
SameValueNonNumber (x, y)。
该算法与
7.3 对象操作 (Operations on Objects)
7.3.1 MakeBasicObject ( internalSlotsList )
The abstract operation MakeBasicObject takes argument internalSlotsList (一个内部槽名称的
- 将 internalSlotsList 设为其与 « [[PrivateElements]] » 的
列表拼接 。 - 令 obj 为一个新创建的对象，对 internalSlotsList 中每个名称建一个内部槽。
- NOTE: 如
对象的内部方法与内部槽 所述，除非另有说明，每个内部槽初始值为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 ( O, P )
The abstract operation Get takes arguments O (一个 Object) and P (一个
- 返回 ? O.[[Get]](P, O)。
7.3.3 GetV ( V, P )
The abstract operation GetV takes arguments V (一个
- 令 O 为 ?
ToObject (V)。 - 返回 ? O.[[Get]](P, V)。
7.3.4 Set ( O, P, V, Throw )
The abstract operation Set takes arguments O (一个 Object), P (一个
- 令 success 为 ? O.[[Set]](P, V, O)。
- 若 success 为
false 且 Throw 为true ，抛出TypeError 。 - 返回
unused 。
7.3.5 CreateDataProperty ( O, P, V )
The abstract operation CreateDataProperty takes arguments O (一个 Object), P (一个
- 令 newDesc 为 PropertyDescriptor { [[Value]]: V, [[Writable]]:
true , [[Enumerable]]:true , [[Configurable]]:true }。 - 返回 ? O.[[DefineOwnProperty]](P, newDesc)。
此操作创建的属性特性与语言赋值运算符新建属性时的默认特性相同。通常该属性不存在；若已存在且不可配置，或 O 不可扩展，则 [[DefineOwnProperty]] 返回
7.3.6 CreateDataPropertyOrThrow ( O, P, V )
The abstract operation CreateDataPropertyOrThrow takes arguments O (一个 Object), P (一个
- 令 success 为 ?
CreateDataProperty (O, P, V)。 - 若 success 为
false ，抛出TypeError 。 - 返回
unused 。
与
7.3.7 CreateNonEnumerableDataPropertyOrThrow ( O, P, V )
The abstract operation CreateNonEnumerableDataPropertyOrThrow takes arguments O (一个 Object), P (一个
- 断言：O 是可扩展、
普通对象 ，且无不可配置属性。 - 令 newDesc 为 PropertyDescriptor { [[Value]]: V, [[Writable]]:
true , [[Enumerable]]:false , [[Configurable]]:true }。 - 执行 !
DefinePropertyOrThrow (O, P, newDesc)。 - 返回
unused 。
特性与赋值运算符默认值相同，唯独 [[Enumerable]] 为
7.3.8 DefinePropertyOrThrow ( O, P, desc )
The abstract operation DefinePropertyOrThrow takes arguments O (一个 Object), P (一个
- 令 success 为 ? O.[[DefineOwnProperty]](P, desc)。
- 若 success 为
false ，抛出TypeError 。 - 返回
unused 。
7.3.9 DeletePropertyOrThrow ( O, P )
The abstract operation DeletePropertyOrThrow takes arguments O (一个 Object) and P (一个
- 令 success 为 ? O.[[Delete]](P)。
- 若 success 为
false ，抛出TypeError 。 - 返回
unused 。
7.3.10 GetMethod ( V, P )
The abstract operation GetMethod takes arguments V (一个
- 令 func 为 ?
GetV (V, P)。 - 如果 func 是
undefined 或null ，返回undefined 。 - 如果
IsCallable (func) 为false ，抛出TypeError 。 - 返回 func。
7.3.11 HasProperty ( O, P )
The abstract operation HasProperty takes arguments O (一个 Object) and P (一个
- 返回 ? O.[[HasProperty]](P)。
7.3.12 HasOwnProperty ( O, P )
The abstract operation HasOwnProperty takes arguments O (一个 Object) and P (一个
- 令 desc 为 ? O.[[GetOwnProperty]](P)。
- 如果 desc 是
undefined ，返回false 。 - 返回
true 。
7.3.13 Call ( F: 一个 ECMAScript 语言值, V: 一个 ECMAScript 语言值, 可选 argumentsList: 一个 ECMAScript 语言值的 List, ): 返回包含一个 ECMAScript 语言值的正常完成或抛出完成
The abstract operation UNKNOWN takes UNPARSEABLE ARGUMENTS. 调用
- 若 argumentsList 不存在，设其为新空
List 。 - 若
IsCallable (F) 为false ，抛出TypeError 。 - 返回 ? F.[[Call]](V, argumentsList)。
7.3.14 Construct ( F: 一个 constructor, 可选 argumentsList: ECMAScript 语言值 List, 可选 newTarget: 一个 constructor, ): 返回包含一个 Object 的正常完成或抛出完成
The abstract operation UNKNOWN takes UNPARSEABLE ARGUMENTS. 调用
- 若 newTarget 不存在，设为 F。
- 若 argumentsList 不存在，设为新空
List 。 - 返回 ? F.[[Construct]](argumentsList, newTarget)。
若 newTarget 不存在，等价于：new F(...argumentsList)。
7.3.15 SetIntegrityLevel ( O, level )
The abstract operation SetIntegrityLevel takes arguments O (一个 Object) and level (
- 令 status 为 ? O.[[PreventExtensions]]()。
- 若 status 为
false ，返回false 。 - 令 keys 为 ? O.[[OwnPropertyKeys]]()。
- 如果 level 为
sealed ，则- 对 keys 中每个 k：
- 执行 ?
DefinePropertyOrThrow (O, k, PropertyDescriptor { [[Configurable]]:false })。
- 执行 ?
- 对 keys 中每个 k：
- 否则，
- 断言：level 为
frozen 。 - 对 keys 中每个 k：
- 令 currentDesc 为 ? O.[[GetOwnProperty]](k)。
- 若 currentDesc 不为
undefined ，则- 如果
IsAccessorDescriptor (currentDesc) 为true ，- 令 desc 为 PropertyDescriptor { [[Configurable]]:
false }。
- 令 desc 为 PropertyDescriptor { [[Configurable]]:
- 否则，
- 令 desc 为 PropertyDescriptor { [[Configurable]]:
false , [[Writable]]:false }。
- 令 desc 为 PropertyDescriptor { [[Configurable]]:
- 执行 ?
DefinePropertyOrThrow (O, k, desc)。
- 如果
- 断言：level 为
- 返回
true 。
7.3.16 TestIntegrityLevel ( O, level )
The abstract operation TestIntegrityLevel takes arguments O (一个 Object) and level (
- 令 extensible 为 ?
IsExtensible (O)。 - 若 extensible 为
true ，返回false 。 - NOTE: 若对象可扩展，不检查属性。
- 令 keys 为 ? O.[[OwnPropertyKeys]]()。
- 对 keys 中每个 k：
- 令 currentDesc 为 ? O.[[GetOwnProperty]](k)。
- 若 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 (一个
- 令 array 为 !
ArrayCreate (0)。 - 令 n 为 0。
- 对 elements 中每个 e：
- 执行 !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (n)), e)。 - 设 n 为 n + 1。
- 执行 !
- 返回 array。
7.3.18 LengthOfArrayLike ( obj )
The abstract operation LengthOfArrayLike takes argument obj (一个 Object) and returns 返回包含非负整数的
类数组对象 指此操作能
7.3.19
CreateListFromArrayLike (
obj: 一个 ECMAScript 语言值,
可选 validElementTypes: all 或 property-key ,
): 返回包含 ECMAScript 语言值 List 的正常完成或抛出完成
The abstract operation UNKNOWN takes UNPARSEABLE ARGUMENTS. 创建一个
- 若 validElementTypes 不存在，设为
all 。 - 若 obj
不是 Object ，抛出TypeError 。 - 令 len 为 ?
LengthOfArrayLike (obj)。 - 令 list 为新空
List 。 - 令 index 为 0。
- 当 index < len：
- 返回 list。
7.3.20 Invoke ( V: 一个 ECMAScript 语言值, P: 一个属性键, 可选 argumentsList: ECMAScript 语言值 List, ): 返回包含一个 ECMAScript 语言值的正常完成或抛出完成
The abstract operation UNKNOWN takes UNPARSEABLE ARGUMENTS. 调用一个
7.3.21 OrdinaryHasInstance ( C, O )
The abstract operation OrdinaryHasInstance takes arguments C (一个
- 若
IsCallable (C) 为false ，返回false 。 - 若 C 有 [[BoundTargetFunction]] 内部槽，则
- 令 BC 为 C.[[BoundTargetFunction]]。
- 返回 ?
InstanceofOperator (O, BC)。
- 若 O
不是 Object ，返回false 。 - 令 P 为 ?
Get (C,"prototype" )。 - 若 P
不是 Object ，抛出TypeError 。 - 循环：
- 设 O 为 ? O.[[GetPrototypeOf]]()。
- 若 O 是
null ，返回false 。 - 若
SameValue (P, O) 为true ，返回true 。
7.3.22 SpeciesConstructor ( O, defaultConstructor )
The abstract operation SpeciesConstructor takes arguments O (一个 Object) and defaultConstructor (一个 constructor) and returns 返回包含 constructor 的
- 令 C 为 ?
Get (O,"constructor" )。 - 若 C 是
undefined ，返回 defaultConstructor。 - 若 C
不是 Object ，抛出TypeError 。 - 令 S 为 ?
Get (C,%Symbol.species% )。 - 若 S 是
undefined 或null ，返回 defaultConstructor。 - 若
IsConstructor (S) 为true ，返回 S。 - 抛出
TypeError 。
7.3.23 EnumerableOwnProperties ( O, kind )
The abstract operation EnumerableOwnProperties takes arguments O (一个 Object) and kind (
- 令 ownKeys 为 ? O.[[OwnPropertyKeys]]()。
- 令 results 为新空
List 。 - 对 ownKeys 中每个 key：
- 如果 key 是 String，则
- 令 desc 为 ? O.[[GetOwnProperty]](key)。
- 若 desc 不为
undefined 且 desc.[[Enumerable]] 为true ，则- 如果 kind 为
key ，- 将 key 加入 results。
- 否则，
- 令 value 为 ?
Get (O, key)。 - 若 kind 为
value ，- 将 value 加入 results。
- 否则，
- 断言：kind 为
key+value 。 - 令 entry 为
CreateArrayFromList (« key, value »)。 - 将 entry 加入 results。
- 断言：kind 为
- 令 value 为 ?
- 如果 kind 为
- 如果 key 是 String，则
- 返回 results。
7.3.24 GetFunctionRealm ( obj )
The abstract operation GetFunctionRealm takes argument obj (一个
- 若 obj 有 [[Realm]] 内部槽，
- 返回 obj.[[Realm]]。
- 若 obj 是绑定函数
特殊对象 ，- 令 boundTargetFunction 为 obj.[[BoundTargetFunction]]。
- 返回 ?
GetFunctionRealm (boundTargetFunction)。
- 若 obj 是 Proxy
特殊对象 ，- 执行 ?
ValidateNonRevokedProxy (obj)。 - 令 proxyTarget 为 obj.[[ProxyTarget]]。
- 断言：proxyTarget 是
函数对象 。 - 返回 ?
GetFunctionRealm (proxyTarget)。
- 执行 ?
- 返回
当前 Realm Record 。
7.3.25 CopyDataProperties ( target, source, excludedItems )
The abstract operation CopyDataProperties takes arguments target (一个 Object), source (一个
- 如果 source 是
undefined 或null ，返回unused 。 - 令 from 为 !
ToObject (source)。 - 令 keys 为 ? from.[[OwnPropertyKeys]]()。
- 对 keys 中每个 nextKey：
- 令 excluded 为
false 。 - 对 excludedItems 中每个 e：
- 若
SameValue (e, nextKey) 为true ，- 设 excluded 为
true 。
- 设 excluded 为
- 若
- 若 excluded 为
false ，则- 令 desc 为 ? from.[[GetOwnProperty]](nextKey)。
- 若 desc 不为
undefined 且 desc.[[Enumerable]] 为true ，- 令 propValue 为 ?
Get (from, nextKey)。 - 执行 !
CreateDataPropertyOrThrow (target, nextKey, propValue)。
- 令 propValue 为 ?
- 令 excluded 为
- 返回
unused 。
此处的 target 总是新创建且在抛错情况下不可被直接访问。
7.3.26 PrivateElementFind ( O, P )
The abstract operation PrivateElementFind takes arguments O (一个 Object) and P (一个
- 如果 O.[[PrivateElements]] 包含
PrivateElement pe 且 pe.[[Key]] 是 P，- 返回 pe。
- 返回
empty 。
7.3.27 PrivateFieldAdd ( O, P, value )
The abstract operation PrivateFieldAdd takes arguments O (一个 Object), P (一个
- 若
宿主 是 web 浏览器，- 执行 ?
HostEnsureCanAddPrivateElement (O)。
- 执行 ?
- 令 entry 为
PrivateElementFind (O, P)。 - 若 entry 不为
empty ，抛出TypeError 。 - 将
PrivateElement { [[Key]]: P, [[Kind]]:field , [[Value]]: value } 附加到 O.[[PrivateElements]]。 - 返回
unused 。
7.3.28 PrivateMethodOrAccessorAdd ( O, method )
The abstract operation PrivateMethodOrAccessorAdd takes arguments O (一个 Object) and method (一个
- 断言：method.[[Kind]] 是
method 或accessor 。 - 若
宿主 是 web 浏览器，- 执行 ?
HostEnsureCanAddPrivateElement (O)。
- 执行 ?
- 令 entry 为
PrivateElementFind (O, method.[[Key]])。 - 若 entry 不为
empty ，抛出TypeError 。 - 将 method 附加到 O.[[PrivateElements]]。
- 返回
unused 。
私有方法与访问器的值在实例之间共享，不会为每个实例复制。
7.3.29 HostEnsureCanAddPrivateElement ( O )
The host-defined abstract operation HostEnsureCanAddPrivateElement takes argument O (一个 Object) and returns 返回包含
实现需符合：
- 若 O 不是
宿主 定义的特殊对象 ，则返回NormalCompletion (unused ) 且不做其它步骤。 - 对相同参数的两次调用返回同种
Completion Record 。
默认实现为返回
仅由作为 web 浏览器的 ECMAScript
7.3.30 PrivateGet ( O, P )
The abstract operation PrivateGet takes arguments O (一个 Object) and P (一个
- 令 entry 为
PrivateElementFind (O, P)。 - 若 entry 是
empty ，抛出TypeError 。 - 若 entry.[[Kind]] 是
field 或method ，- 返回 entry.[[Value]]。
- 断言：entry.[[Kind]] 是
accessor 。 - 若 entry.[[Get]] 是
undefined ，抛出TypeError 。 - 令 getter 为 entry.[[Get]]。
- 返回 ? Call(getter, O)。
7.3.31 PrivateSet ( O, P, value )
The abstract operation PrivateSet takes arguments O (一个 Object), P (一个
- 令 entry 为
PrivateElementFind (O, P)。 - 若 entry 是
empty ，抛出TypeError 。 - 若 entry.[[Kind]] 是
field ，则- 设 entry.[[Value]] 为 value。
- 否则如果 entry.[[Kind]] 是
method ，- 抛出
TypeError 。
- 抛出
- 否则，
- 断言：entry.[[Kind]] 是
accessor 。 - 若 entry.[[Set]] 是
undefined ，抛出TypeError 。 - 令 setter 为 entry.[[Set]]。
- 执行 ? Call(setter, O, « value »)。
- 断言：entry.[[Kind]] 是
- 返回
unused 。
7.3.32 DefineField ( receiver, fieldRecord )
The abstract operation DefineField takes arguments receiver (一个 Object) and fieldRecord (一个
- 令 fieldName 为 fieldRecord.[[Name]]。
- 令 initializer 为 fieldRecord.[[Initializer]]。
- 如果 initializer 不是
empty ，- 令 initValue 为 ? Call(initializer, receiver)。
- 否则，
- 令 initValue 为
undefined 。
- 令 initValue 为
- 若 fieldName 是
Private Name ，- 执行 ?
PrivateFieldAdd (receiver, fieldName, initValue)。
- 执行 ?
- 否则，
- 断言：fieldName 是
属性键 。 - 执行 ?
CreateDataPropertyOrThrow (receiver, fieldName, initValue)。
- 断言：fieldName 是
- 返回
unused 。
7.3.33 InitializeInstanceElements ( O, constructor )
The abstract operation InitializeInstanceElements takes arguments O (一个 Object) and constructor (一个 ECMAScript
- 令 methods 为 constructor.[[PrivateMethods]]。
- 对 methods 中每个
PrivateElement method：- 执行 ?
PrivateMethodOrAccessorAdd (O, method)。
- 执行 ?
- 令 fields 为 constructor.[[Fields]]。
- 对 fields 中每个 fieldRecord：
- 执行 ?
DefineField (O, fieldRecord)。
- 执行 ?
- 返回
unused 。
7.3.34 AddValueToKeyedGroup ( groups, key, value )
The abstract operation AddValueToKeyedGroup takes arguments groups (一个包含 [[Key]] (
7.3.35 GroupBy ( items, callback, keyCoercion )
The abstract operation GroupBy takes arguments items (一个
- 执行 ?
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 SetterThatIgnoresPrototypeProperties ( thisValue, home, p, v )
The abstract operation SetterThatIgnoresPrototypeProperties takes arguments thisValue (一个
- 如果 thisValue
不是 Object ，- 抛出
TypeError 。
- 抛出
- 如果
SameValue (thisValue, home) 为true ，- NOTE: 此处抛出模拟在严格模式下给 home 不可写
数据属性 赋值。 - 抛出
TypeError 。
- NOTE: 此处抛出模拟在严格模式下给 home 不可写
- 令 desc 为 ? thisValue.[[GetOwnProperty]](p)。
- 若 desc 是
undefined ，- 执行 ?
CreateDataPropertyOrThrow (thisValue, p, v)。
- 执行 ?
- 否则，
- 执行 ?
Set (thisValue, p, v,true )。
- 执行 ?
- 返回
unused 。
7.4 迭代器对象操作 (Operations on Iterator Objects)
参见通用迭代接口 (
7.4.1 Iterator Records
Iterator Record 是一个 next 方法。
Iterator Record 拥有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Iterator]] | 一个 Object | 符合迭代器或异步迭代器接口的对象。 |
| [[NextMethod]] |
一个 |
[[Iterator]] 对象的 next 方法。
|
| [[Done]] | 一个 Boolean | 迭代器是否已完成或被关闭。 |
7.4.2 GetIteratorDirect ( obj )
The abstract operation GetIteratorDirect takes argument obj (一个 Object) and returns 返回包含
- 令 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 (一个
- 令 iterator 为 ? Call(method, obj)。
- 若 iterator
不是 Object ，抛出TypeError 。 - 返回 ?
GetIteratorDirect (iterator)。
7.4.4 GetIterator ( obj, kind )
The abstract operation GetIterator takes arguments obj (一个
- 若 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 (一个
- 若 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
不是 Object ，抛出TypeError 。 - 返回 ?
GetIteratorDirect (iterator)。
7.4.6 IteratorNext ( iteratorRecord: 一个 Iterator Record, 可选 value: 一个 ECMAScript 语言值, ): 返回包含一个 Object 的正常完成或抛出完成
The abstract operation UNKNOWN takes UNPARSEABLE ARGUMENTS. It performs the following steps when called:
- 如果 value 不存在，
- 令 result 为
Completion (Call(iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]]))。
- 令 result 为
- 否则，
- 令 result 为
Completion (Call(iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]], « value »))。
- 令 result 为
- 若 result 是 throw completion，
- 设 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 (一个 Object) and returns 返回包含 Boolean 的
7.4.8 IteratorValue ( iteratorResult )
The abstract operation IteratorValue takes argument iteratorResult (一个 Object) and returns 返回包含一个
- 返回 ?
Get (iteratorResult,"value" )。
7.4.9 IteratorStep ( iteratorRecord )
The abstract operation IteratorStep takes argument iteratorRecord (一个
- 令 result 为 ? IteratorNext(iteratorRecord)。
- 令 done 为
Completion (IteratorComplete (result))。 - 若 done 是 throw completion，
- 设 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 (一个
- 令 result 为 ?
IteratorStep (iteratorRecord)。 - 若 result 是
done ，- 返回
done 。
- 返回
- 令 value 为
Completion (IteratorValue (result))。 - 若 value 是 throw completion，
- 设 iteratorRecord.[[Done]] 为
true 。
- 设 iteratorRecord.[[Done]] 为
- 返回 ? value。
7.4.11 IteratorClose ( iteratorRecord, completion )
The abstract operation IteratorClose takes arguments iteratorRecord (一个
- 断言：iteratorRecord.[[Iterator]]
是 Object 。 - 令 iterator 为 iteratorRecord.[[Iterator]]。
- 令 innerResult 为
Completion (GetMethod (iterator,"return" ))。 - 若 innerResult 是 normal completion，
- 令 return 为 innerResult.[[Value]]。
- 若 return 是
undefined ，返回 ? completion。 - 设 innerResult 为
Completion (Call(return, iterator))。
- 若 completion 是 throw completion，返回 ? completion。
- 若 innerResult 是 throw completion，返回 ? innerResult。
- 若 innerResult.[[Value]]
不是 Object ，抛出TypeError 。 - 返回 ? completion。
7.4.12 IfAbruptCloseIterator ( value, iteratorRecord )
IfAbruptCloseIterator 是使用
IfAbruptCloseIterator (value, iteratorRecord)。
等价于：
- 断言：value 是
Completion Record 。 - 若 value 是 abrupt completion，返回 ?
IteratorClose (iteratorRecord, value)。 - 否则，设 value 为 ! value。
7.4.13 AsyncIteratorClose ( iteratorRecord, completion )
The abstract operation AsyncIteratorClose takes arguments iteratorRecord (一个
- 断言：iteratorRecord.[[Iterator]]
是 Object 。 - 令 iterator 为 iteratorRecord.[[Iterator]]。
- 令 innerResult 为
Completion (GetMethod (iterator,"return" ))。 - 若 innerResult 是 normal completion，
- 令 return 为 innerResult.[[Value]]。
- 若 return 是
undefined ，返回 ? completion。 - 设 innerResult 为
Completion (Call(return, iterator))。 - 若 innerResult 是 normal completion，设其为
Completion (Await (innerResult.[[Value]]))。
- 若 completion 是 throw completion，返回 ? completion。
- 若 innerResult 是 throw completion，返回 ? innerResult。
- 若 innerResult.[[Value]]
不是 Object ，抛出TypeError 。 - 返回 ? completion。
7.4.14 CreateIteratorResultObject ( value, done )
The abstract operation CreateIteratorResultObject takes arguments value (一个
- 令 obj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 !
CreateDataPropertyOrThrow (obj,"value" , value)。 - 执行 !
CreateDataPropertyOrThrow (obj,"done" , done)。 - 返回 obj。
7.4.15 CreateListIteratorRecord ( list )
The abstract operation CreateListIteratorRecord takes argument list (一个
- 令 closure 为一个新建的
Abstract Closure （无参数），捕获 list，被调用时：- 对 list 中每个 E：
- 执行 ?
GeneratorYield (CreateIteratorResultObject (E,false ))。
- 执行 ?
- 返回
NormalCompletion (undefined )。
- 对 list 中每个 E：
- 令 iterator 为
CreateIteratorFromClosure (closure,empty ,%Iterator.prototype% )。 - 返回
Iterator Record { [[Iterator]]: iterator, [[NextMethod]]: %GeneratorPrototype.next%, [[Done]]:false }。
该列表迭代器对象对 ECMAScript 代码不可直接访问。
7.4.16 IteratorToList ( iteratorRecord )
The abstract operation IteratorToList takes argument iteratorRecord (一个
- 令 values 为新空
List 。 - 循环：
- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 若 next 是
done ，- 返回 values。
- 将 next 加入 values。
- 令 next 为 ?
8 语法指引操作 (Syntax-Directed Operations)
除了本节定义的操作外，规范其余部分还定义了许多专门的语法指引操作。
8.1 运行时语义：Evaluation
The syntax-directed operation
8.2 作用域分析 (Scope Analysis)
8.2.1 静态语义：BoundNames
The syntax-directed operation
It is defined piecewise over the following productions:
- 返回仅含
Identifier 的 StringValue 的列表。
- 返回 «
"yield" »。
- 返回 «
"await" »。
- 返回
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。
- 返回一个新的空列表。
- 令 names1 为
BindingPropertyList 的 BoundNames。 - 令 names2 为
BindingRestProperty 的 BoundNames。 - 返回 names1 与 names2 的
列表拼接 。
- 返回一个新的空列表。
- 返回
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*" »。
- 返回一个新的空列表。
- 令 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。
- 返回一个新的空列表。
- 令 names1 为
ImportedDefaultBinding 的 BoundNames。 - 令 names2 为
NameSpaceImport 的 BoundNames。 - 返回 names1 与 names2 的
列表拼接 。
- 令 names1 为
ImportedDefaultBinding 的 BoundNames。 - 令 names2 为
NamedImports 的 BoundNames。 - 返回 names1 与 names2 的
列表拼接 。
- 返回一个新的空列表。
- 令 names1 为
ImportsList 的 BoundNames。 - 令 names2 为
ImportSpecifier 的 BoundNames。 - 返回 names1 与 names2 的
列表拼接 。
- 返回
ImportedBinding 的 BoundNames。
- 返回一个新的空列表。
- 返回
VariableStatement 的 BoundNames。
- 返回
Declaration 的 BoundNames。
- 令 declarationNames 为
HoistableDeclaration 的 BoundNames。 - 若 declarationNames 不含
"*default*" ，将"*default*" 添加到 declarationNames。 - 返回 declarationNames。
- 令 declarationNames 为
ClassDeclaration 的 BoundNames。 - 若 declarationNames 不含
"*default*" ，将"*default*" 添加到 declarationNames。 - 返回 declarationNames。
- 返回 «
"*default*" »。
8.2.2 静态语义：DeclarationPart
The syntax-directed operation
- 返回
ClassDeclaration 。
8.2.3 静态语义：IsConstantDeclaration
The syntax-directed operation
- 返回
LetOrConst 的 IsConstantDeclaration。
- 返回
false 。
- 返回
true 。
- 返回
false 。
- 返回
false 。
- 返回
false 。
无需将 export default
8.2.4 静态语义：LexicallyDeclaredNames
The syntax-directed operation
- 返回一个新的空列表。
- 令 names1 为
StatementList 的 LexicallyDeclaredNames。 - 令 names2 为
StatementListItem 的 LexicallyDeclaredNames。 - 返回 names1 与 names2 的
列表拼接 。
- 若
Statement 为Statement : LabelledStatement LabelledStatement 的 LexicallyDeclaredNames。 - 返回一个新的空列表。
- 返回
Declaration 的 BoundNames。
- 返回一个新的空列表。
- 若第一个
CaseClauses 存在，令 names1 为其 LexicallyDeclaredNames；否则 names1 为新空列表。 - 令 names2 为
DefaultClause 的 LexicallyDeclaredNames。 - 若第二个
CaseClauses 存在，令 names3 为其 LexicallyDeclaredNames；否则 names3 为新空列表。 - 返回 names1、names2、names3 的
列表拼接 。
- 令 names1 为
CaseClauses 的 LexicallyDeclaredNames。 - 令 names2 为
CaseClause 的 LexicallyDeclaredNames。 - 返回 names1 与 names2 的
列表拼接 。
- 若
StatementList 存在，返回其 LexicallyDeclaredNames。 - 返回一个新的空列表。
- 若
StatementList 存在，返回其 LexicallyDeclaredNames。 - 返回一个新的空列表。
- 返回
LabelledItem 的 LexicallyDeclaredNames。
- 返回一个新的空列表。
- 返回
FunctionDeclaration 的 BoundNames。
- 返回一个新的空列表。
- 返回
StatementList 的 TopLevelLexicallyDeclaredNames。
- 返回一个新的空列表。
- 返回
StatementList 的 TopLevelLexicallyDeclaredNames。
- 返回一个新的空列表。
- 返回一个新的空列表。
- 返回一个新的空列表。
- 返回
StatementList 的 TopLevelLexicallyDeclaredNames。
- 令 names1 为
ModuleItemList 的 LexicallyDeclaredNames。 - 令 names2 为
ModuleItem 的 LexicallyDeclaredNames。 - 返回 names1 与 names2 的
列表拼接 。
- 返回
ImportDeclaration 的 BoundNames。
- 若
ExportDeclaration 为exportVariableStatement ，返回一个新的空列表。 - 返回
ExportDeclaration 的 BoundNames。
- 返回
StatementListItem 的 LexicallyDeclaredNames。
8.2.5 静态语义：LexicallyScopedDeclarations
The syntax-directed operation
- 令 declarations1 为
StatementList 的 LexicallyScopedDeclarations。 - 令 declarations2 为
StatementListItem 的 LexicallyScopedDeclarations。 - 返回 declarations1 与 declarations2 的
列表拼接 。
- 若
Statement 为Statement : LabelledStatement LabelledStatement 的 LexicallyScopedDeclarations。 - 返回一个新的空列表。
- 返回仅含
Declaration 的 DeclarationPart 的列表。
- 返回一个新的空列表。
- 若第一个
CaseClauses 存在，令 declarations1 为其 LexicallyScopedDeclarations；否则 declarations1 为新空列表。 - 令 declarations2 为
DefaultClause 的 LexicallyScopedDeclarations。 - 若第二个
CaseClauses 存在，令 declarations3 为其 LexicallyScopedDeclarations；否则 declarations3 为新空列表。 - 返回 declarations1、declarations2、declarations3 的
列表拼接 。
- 令 declarations1 为
CaseClauses 的 LexicallyScopedDeclarations。 - 令 declarations2 为
CaseClause 的 LexicallyScopedDeclarations。 - 返回 declarations1 与 declarations2 的
列表拼接 。
- 若
StatementList 存在，返回其 LexicallyScopedDeclarations。 - 返回一个新的空列表。
- 若
StatementList 存在，返回其 LexicallyScopedDeclarations。 - 返回一个新的空列表。
- 返回
LabelledItem 的 LexicallyScopedDeclarations。
- 返回一个新的空列表。
- 返回 «
FunctionDeclaration »。
- 返回一个新的空列表。
- 返回
StatementList 的 TopLevelLexicallyScopedDeclarations。
- 返回一个新的空列表。
- 返回
StatementList 的 TopLevelLexicallyScopedDeclarations。
- 返回一个新的空列表。
- 返回一个新的空列表。
- 返回一个新的空列表。
- 返回
StatementList 的 TopLevelLexicallyScopedDeclarations。
- 返回一个新的空列表。
- 令 declarations1 为
ModuleItemList 的 LexicallyScopedDeclarations。 - 令 declarations2 为
ModuleItem 的 LexicallyScopedDeclarations。 - 返回 declarations1 与 declarations2 的
列表拼接 。
- 返回一个新的空列表。
- 返回一个新的空列表。
- 返回仅含
Declaration 的 DeclarationPart 的列表。
- 返回仅含
HoistableDeclaration 的 DeclarationPart 的列表。
- 返回仅含
ClassDeclaration 的列表。
- 返回仅含本
ExportDeclaration 的列表。
8.2.6 静态语义：VarDeclaredNames
The syntax-directed operation
- 返回一个新的空列表。
- 返回一个新的空列表。
- 令 names1 为
StatementList 的 VarDeclaredNames。 - 令 names2 为
StatementListItem 的 VarDeclaredNames。 - 返回 names1 与 names2 的
列表拼接 。
- 返回一个新的空列表。
- 返回
VariableDeclarationList 的 BoundNames。
- 返回
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。
- 返回一个新的空列表。
- 若第一个
CaseClauses 存在，令 names1 为其 VarDeclaredNames；否则 names1 为新空列表。 - 令 names2 为
DefaultClause 的 VarDeclaredNames。 - 若第二个
CaseClauses 存在，令 names3 为其 VarDeclaredNames；否则 names3 为新空列表。 - 返回 names1、names2、names3 的
列表拼接 。
- 令 names1 为
CaseClauses 的 VarDeclaredNames。 - 令 names2 为
CaseClause 的 VarDeclaredNames。 - 返回 names1 与 names2 的
列表拼接 。
- 若
StatementList 存在，返回其 VarDeclaredNames。 - 返回一个新的空列表。
- 若
StatementList 存在，返回其 VarDeclaredNames。 - 返回一个新的空列表。
- 返回
LabelledItem 的 VarDeclaredNames。
- 返回一个新的空列表。
- 返回
Block 的 VarDeclaredNames。
- 返回一个新的空列表。
- 返回
StatementList 的 TopLevelVarDeclaredNames。
- 返回一个新的空列表。
- 返回
StatementList 的 TopLevelVarDeclaredNames。
- 返回一个新的空列表。
- 返回一个新的空列表。
- 返回一个新的空列表。
- 返回
StatementList 的 TopLevelVarDeclaredNames。
- 令 names1 为
ModuleItemList 的 VarDeclaredNames。 - 令 names2 为
ModuleItem 的 VarDeclaredNames。 - 返回 names1 与 names2 的
列表拼接 。
- 返回一个新的空列表。
- 若
ExportDeclaration 为exportVariableStatement ，返回ExportDeclaration 的 BoundNames。 - 返回一个新的空列表。
8.2.7 静态语义：VarScopedDeclarations
The syntax-directed operation
- 返回一个新的空列表。
- 返回一个新的空列表。
- 令 declarations1 为
StatementList 的 VarScopedDeclarations。 - 令 declarations2 为
StatementListItem 的 VarScopedDeclarations。 - 返回 declarations1 与 declarations2 的
列表拼接 。
- 返回一个新的空列表。
- 返回 «
VariableDeclaration »。
- 令 declarations1 为
VariableDeclarationList 的 VarScopedDeclarations。 - 返回 declarations1 与 «
VariableDeclaration » 的列表拼接 。
- 返回
Statement 的 VarScopedDeclarations。
- 返回
Statement 的 VarScopedDeclarations。
- 返回
Statement 的 VarScopedDeclarations。
- 返回
Statement 的 VarScopedDeclarations。
- 令 declarations1 为
VariableDeclarationList 的 VarScopedDeclarations。 - 令 declarations2 为
Statement 的 VarScopedDeclarations。 - 返回 declarations1 与 declarations2 的
列表拼接 。
- 返回
Statement 的 VarScopedDeclarations。
- 返回
Statement 的 VarScopedDeclarations。
- 令 declarations1 为 «
ForBinding »。 - 令 declarations2 为
Statement 的 VarScopedDeclarations。 - 返回 declarations1 与 declarations2 的
列表拼接 。
本节由附件
- 返回
Statement 的 VarScopedDeclarations。
- 返回
CaseBlock 的 VarScopedDeclarations。
- 返回一个新的空列表。
- 若第一个
CaseClauses 存在，令 declarations1 为其 VarScopedDeclarations；否则 declarations1 为新空列表。 - 令 declarations2 为
DefaultClause 的 VarScopedDeclarations。 - 若第二个
CaseClauses 存在，令 declarations3 为其 VarScopedDeclarations；否则 declarations3 为新空列表。 - 返回 declarations1、declarations2、declarations3 的
列表拼接 。
- 令 declarations1 为
CaseClauses 的 VarScopedDeclarations。 - 令 declarations2 为
CaseClause 的 VarScopedDeclarations。 - 返回 declarations1 与 declarations2 的
列表拼接 。
- 若
StatementList 存在，返回其 VarScopedDeclarations。 - 返回一个新的空列表。
- 若
StatementList 存在，返回其 VarScopedDeclarations。 - 返回一个新的空列表。
- 返回
LabelledItem 的 VarScopedDeclarations。
- 返回一个新的空列表。
- 返回
Block 的 VarScopedDeclarations。
- 返回一个新的空列表。
- 返回
StatementList 的 TopLevelVarScopedDeclarations。
- 返回一个新的空列表。
- 返回
StatementList 的 TopLevelVarScopedDeclarations。
- 返回一个新的空列表。
- 返回一个新的空列表。
- 返回一个新的空列表。
- 返回
StatementList 的 TopLevelVarScopedDeclarations。
- 返回一个新的空列表。
- 令 declarations1 为
ModuleItemList 的 VarScopedDeclarations。 - 令 declarations2 为
ModuleItem 的 VarScopedDeclarations。 - 返回 declarations1 与 declarations2 的
列表拼接 。
- 返回一个新的空列表。
- 若
ExportDeclaration 为exportVariableStatement ，返回VariableStatement 的 VarScopedDeclarations。 - 返回一个新的空列表。
8.2.8 静态语义：TopLevelLexicallyDeclaredNames
The syntax-directed operation
- 令 names1 为
StatementList 的 TopLevelLexicallyDeclaredNames。 - 令 names2 为
StatementListItem 的 TopLevelLexicallyDeclaredNames。 - 返回 names1 与 names2 的
列表拼接 。
- 返回一个新的空列表。
- 若
Declaration 为Declaration : HoistableDeclaration - 返回一个新的空列表。
- 返回
Declaration 的 BoundNames。
函数或脚本顶层中，函数声明按 var 声明而非词法声明处理。
8.2.9 静态语义：TopLevelLexicallyScopedDeclarations
The syntax-directed operation
- 令 declarations1 为
StatementList 的 TopLevelLexicallyScopedDeclarations。 - 令 declarations2 为
StatementListItem 的 TopLevelLexicallyScopedDeclarations。 - 返回 declarations1 与 declarations2 的
列表拼接 。
- 返回一个新的空列表。
- 若
Declaration 为Declaration : HoistableDeclaration - 返回一个新的空列表。
- 返回 «
Declaration »。
8.2.10 静态语义：TopLevelVarDeclaredNames
The syntax-directed operation
- 令 names1 为
StatementList 的 TopLevelVarDeclaredNames。 - 令 names2 为
StatementListItem 的 TopLevelVarDeclaredNames。 - 返回 names1 与 names2 的
列表拼接 。
- 若
Declaration 为Declaration : HoistableDeclaration - 返回
HoistableDeclaration 的 BoundNames。
- 返回
- 返回一个新的空列表。
- 若
Statement 为Statement : LabelledStatement Statement 的 TopLevelVarDeclaredNames。 - 返回
Statement 的 VarDeclaredNames。
函数或脚本顶层的内部函数声明按 var 声明处理。
- 返回
LabelledItem 的 TopLevelVarDeclaredNames。
- 若
Statement 为Statement : LabelledStatement Statement 的 TopLevelVarDeclaredNames。 - 返回
Statement 的 VarDeclaredNames。
- 返回
FunctionDeclaration 的 BoundNames。
8.2.11 静态语义：TopLevelVarScopedDeclarations
The syntax-directed operation
- 令 declarations1 为
StatementList 的 TopLevelVarScopedDeclarations。 - 令 declarations2 为
StatementListItem 的 TopLevelVarScopedDeclarations。 - 返回 declarations1 与 declarations2 的
列表拼接 。
- 若
Statement 为Statement : LabelledStatement Statement 的 TopLevelVarScopedDeclarations。 - 返回
Statement 的 VarScopedDeclarations。
- 若
Declaration 为Declaration : HoistableDeclaration - 令 declaration 为
HoistableDeclaration 的 DeclarationPart。 - 返回 « declaration »。
- 令 declaration 为
- 返回一个新的空列表。
- 返回
LabelledItem 的 TopLevelVarScopedDeclarations。
- 若
Statement 为Statement : LabelledStatement Statement 的 TopLevelVarScopedDeclarations。 - 返回
Statement 的 VarScopedDeclarations。
- 返回 «
FunctionDeclaration »。
8.3 标签 (Labels)
8.3.1 静态语义：ContainsDuplicateLabels
The syntax-directed operation
- 返回
false 。
- 令 hasDuplicates 为
StatementList 的 ContainsDuplicateLabels（参数 labelSet）。 - 若 hasDuplicates 为
true ，返回true 。 - 返回
StatementListItem 的 ContainsDuplicateLabels（参数 labelSet）。
- 返回
Statement 的 ContainsDuplicateLabels（参数 labelSet）。
- 返回
Statement 的 ContainsDuplicateLabels（参数 labelSet）。
- 返回
Statement 的 ContainsDuplicateLabels（参数 labelSet）。
- 返回
Statement 的 ContainsDuplicateLabels（参数 labelSet）。
- 返回
Statement 的 ContainsDuplicateLabels（参数 labelSet）。
本节由附录
- 返回
Statement 的 ContainsDuplicateLabels（参数 labelSet）。
- 返回
CaseBlock 的 ContainsDuplicateLabels（参数 labelSet）。
- 返回
false 。
- 若第一个
CaseClauses 存在，则- 若第一个
CaseClauses 的 ContainsDuplicateLabels（参数 labelSet）为true ，返回true 。
- 若第一个
- 若
DefaultClause 的 ContainsDuplicateLabels（参数 labelSet）为true ，返回true 。 - 若第二个
CaseClauses 不存在，返回false 。 - 返回第二个
CaseClauses 的 ContainsDuplicateLabels（参数 labelSet）。
- 令 hasDuplicates 为
CaseClauses 的 ContainsDuplicateLabels（参数 labelSet）。 - 若 hasDuplicates 为
true ，返回true 。 - 返回
CaseClause 的 ContainsDuplicateLabels（参数 labelSet）。
- 若
StatementList 存在，返回其 ContainsDuplicateLabels（参数 labelSet）。 - 返回
false 。
- 若
StatementList 存在，返回其 ContainsDuplicateLabels（参数 labelSet）。 - 返回
false 。
- 令 label 为
LabelIdentifier 的 StringValue。 - 若 labelSet 包含 label，返回
true 。 - 令 newLabelSet 为 labelSet 与 « label » 的
列表拼接 。 - 返回
LabelledItem 的 ContainsDuplicateLabels（参数 newLabelSet）。
- 返回
false 。
- 返回
Block 的 ContainsDuplicateLabels（参数 labelSet）。
- 返回
false 。
- 返回
false 。
- 令 hasDuplicates 为
ModuleItemList 的 ContainsDuplicateLabels（参数 labelSet）。 - 若 hasDuplicates 为
true ，返回true 。 - 返回
ModuleItem 的 ContainsDuplicateLabels（参数 labelSet）。
- 返回
false 。
8.3.2 静态语义：ContainsUndefinedBreakTarget
The syntax-directed operation
- 返回
false 。
- 令 hasUndefinedLabels 为
StatementList 的 ContainsUndefinedBreakTarget（参数 labelSet）。 - 若 hasUndefinedLabels 为
true ，返回true 。 - 返回
StatementListItem 的 ContainsUndefinedBreakTarget（参数 labelSet）。
- 返回
Statement 的 ContainsUndefinedBreakTarget（参数 labelSet）。
- 返回
Statement 的 ContainsUndefinedBreakTarget（参数 labelSet）。
- 返回
Statement 的 ContainsUndefinedBreakTarget（参数 labelSet）。
- 返回
Statement 的 ContainsUndefinedBreakTarget（参数 labelSet）。
- 返回
Statement 的 ContainsUndefinedBreakTarget（参数 labelSet）。
本节由附录
- 返回
false 。
- 若 labelSet 不包含
LabelIdentifier 的 StringValue，返回true 。 - 返回
false 。
- 返回
Statement 的 ContainsUndefinedBreakTarget（参数 labelSet）。
- 返回
CaseBlock 的 ContainsUndefinedBreakTarget（参数 labelSet）。
- 返回
false 。
- 若第一个
CaseClauses 存在，则- 若第一个
CaseClauses 的 ContainsUndefinedBreakTarget（参数 labelSet）为true ，返回true 。
- 若第一个
- 若
DefaultClause 的 ContainsUndefinedBreakTarget（参数 labelSet）为true ，返回true 。 - 若第二个
CaseClauses 不存在，返回false 。 - 返回第二个
CaseClauses 的 ContainsUndefinedBreakTarget（参数 labelSet）。
- 令 hasUndefinedLabels 为
CaseClauses 的 ContainsUndefinedBreakTarget（参数 labelSet）。 - 若 hasUndefinedLabels 为
true ，返回true 。 - 返回
CaseClause 的 ContainsUndefinedBreakTarget（参数 labelSet）。
- 若
StatementList 存在，返回其 ContainsUndefinedBreakTarget（参数 labelSet）。 - 返回
false 。
- 若
StatementList 存在，返回其 ContainsUndefinedBreakTarget（参数 labelSet）。 - 返回
false 。
- 令 label 为
LabelIdentifier 的 StringValue。 - 令 newLabelSet 为 labelSet 与 « label » 的
列表拼接 。 - 返回
LabelledItem 的 ContainsUndefinedBreakTarget（参数 newLabelSet）。
- 返回
false 。
- 返回
Block 的 ContainsUndefinedBreakTarget（参数 labelSet）。
- 返回
false 。
- 返回
false 。
- 令 hasUndefinedLabels 为
ModuleItemList 的 ContainsUndefinedBreakTarget（参数 labelSet）。 - 若 hasUndefinedLabels 为
true ，返回true 。 - 返回
ModuleItem 的 ContainsUndefinedBreakTarget（参数 labelSet）。
- 返回
false 。
8.3.3 静态语义：ContainsUndefinedContinueTarget
The syntax-directed operation
- 返回
false 。
- 返回
BlockStatement 的 ContainsUndefinedContinueTarget（参数 iterationSet 与 « »）。
- 令 newIterationSet 为 iterationSet 与 labelSet 的
列表拼接 。 - 返回
IterationStatement 的 ContainsUndefinedContinueTarget（参数 newIterationSet 与 « »）。
- 令 hasUndefinedLabels 为
StatementList 的 ContainsUndefinedContinueTarget（参数 iterationSet 与 « »）。 - 若 hasUndefinedLabels 为
true ，返回true 。 - 返回
StatementListItem 的 ContainsUndefinedContinueTarget（参数 iterationSet 与 « »）。
- 返回
Statement 的 ContainsUndefinedContinueTarget（参数 iterationSet 与 « »）。
- 返回
Statement 的 ContainsUndefinedContinueTarget（参数 iterationSet 与 « »）。
- 返回
Statement 的 ContainsUndefinedContinueTarget（参数 iterationSet 与 « »）。
- 返回
Statement 的 ContainsUndefinedContinueTarget（参数 iterationSet 与 « »）。
- 返回
Statement 的 ContainsUndefinedContinueTarget（参数 iterationSet 与 « »）。
本节由附录
- 返回
false 。
- 若 iterationSet 不包含
LabelIdentifier 的 StringValue，返回true 。 - 返回
false 。
- 返回
Statement 的 ContainsUndefinedContinueTarget（参数 iterationSet 与 « »）。
- 返回
CaseBlock 的 ContainsUndefinedContinueTarget（参数 iterationSet 与 « »）。
- 返回
false 。
- 若第一个
CaseClauses 存在，则- 若第一个
CaseClauses 的 ContainsUndefinedContinueTarget（参数 iterationSet 与 « »）为true ，返回true 。
- 若第一个
- 若
DefaultClause 的 ContainsUndefinedContinueTarget（参数 iterationSet 与 « »）为true ，返回true 。 - 若第二个
CaseClauses 不存在，返回false 。 - 返回第二个
CaseClauses 的 ContainsUndefinedContinueTarget（参数 iterationSet 与 « »）。
- 令 hasUndefinedLabels 为
CaseClauses 的 ContainsUndefinedContinueTarget（参数 iterationSet 与 « »）。 - 若 hasUndefinedLabels 为
true ，返回true 。 - 返回
CaseClause 的 ContainsUndefinedContinueTarget（参数 iterationSet 与 « »）。
- 若
StatementList 存在，返回其 ContainsUndefinedContinueTarget（参数 iterationSet 与 « »）。 - 返回
false 。
- 若
StatementList 存在，返回其 ContainsUndefinedContinueTarget（参数 iterationSet 与 « »）。 - 返回
false 。
- 令 label 为
LabelIdentifier 的 StringValue。 - 令 newLabelSet 为 labelSet 与 « label » 的
列表拼接 。 - 返回
LabelledItem 的 ContainsUndefinedContinueTarget（参数 iterationSet 与 newLabelSet）。
- 返回
false 。
- 返回
Block 的 ContainsUndefinedContinueTarget（参数 iterationSet 与 « »）。
- 返回
false 。
- 返回
false 。
- 令 hasUndefinedLabels 为
ModuleItemList 的 ContainsUndefinedContinueTarget（参数 iterationSet 与 « »）。 - 若 hasUndefinedLabels 为
true ，返回true 。 - 返回
ModuleItem 的 ContainsUndefinedContinueTarget（参数 iterationSet 与 « »）。
- 返回
false 。
8.4 函数名称推断 (Function Name Inference)
8.4.1 静态语义：HasName
The syntax-directed operation
- 令 expr 为
CoverParenthesizedExpressionAndArrowParameterList 所覆盖 的ParenthesizedExpression 。 - 如果 expr 的 IsFunctionDefinition 为
false ，返回false 。 - 返回 expr 的 HasName。
- 返回
false 。
- 返回
true 。
8.4.2 静态语义：IsFunctionDefinition
The syntax-directed operation
- 令 expr 为
CoverParenthesizedExpressionAndArrowParameterList 所覆盖 的ParenthesizedExpression 。 - 返回 expr 的 IsFunctionDefinition。
- 返回
false 。
- 返回
true 。
8.4.3 静态语义：IsAnonymousFunctionDefinition ( expr )
The abstract operation
- 如果 expr 的 IsFunctionDefinition 为
false ，返回false 。 - 令 hasName 为 expr 的 HasName。
- 如果 hasName 为
true ，返回false 。 - 返回
true 。
8.4.4 静态语义：IsIdentifierRef
The syntax-directed operation
- 返回
true 。
- 返回
false 。
8.4.5 运行时语义：NamedEvaluation
The syntax-directed operation
- 令 expr 为
CoverParenthesizedExpressionAndArrowParameterList 所覆盖 的ParenthesizedExpression 。 - 返回 ? expr 的 NamedEvaluation（参数 name）。
- 断言：IsAnonymousFunctionDefinition(
Expression ) 为true 。 - 返回 ?
Expression 的 NamedEvaluation（参数 name）。
- 返回
FunctionExpression 的 InstantiateOrdinaryFunctionExpression（参数 name）。
- 返回
GeneratorExpression 的 InstantiateGeneratorFunctionExpression（参数 name）。
- 返回
AsyncGeneratorExpression 的 InstantiateAsyncGeneratorFunctionExpression（参数 name）。
- 返回
AsyncFunctionExpression 的 InstantiateAsyncFunctionExpression（参数 name）。
- 返回
ArrowFunction 的 InstantiateArrowFunctionExpression（参数 name）。
- 返回
AsyncArrowFunction 的 InstantiateAsyncArrowFunctionExpression（参数 name）。
- 令 sourceText 为
ClassExpression 匹配的源文本。 - 返回 ?
ClassTail 的 ClassDefinitionEvaluation（参数undefined , name, sourceText）。
8.5 Contains
8.5.1 静态语义：Contains
The syntax-directed operation
本规范中未列于下表的每个语法产生式替代都隐式具有如下默认的 Contains 定义：
- 对该
解析节点 的每个子节点 child，执行- 若 child 是 symbol 的一个实例，返回
true 。 - 若 child 是一个非终结符实例，则
- 令 contained 为 child Contains symbol 的结果。
- 若 contained 为
true ，返回true 。
- 若 child 是 symbol 的一个实例，返回
- 返回
false 。
- 返回
false 。
依赖子结构的
- 如果 symbol 是
ClassBody ，返回true 。 - 如果 symbol 是
ClassHeritage ，则- 若
ClassHeritage 存在，返回true ；否则返回false 。
- 若
- 若
ClassHeritage 存在，则- 若
ClassHeritage Contains symbol 为true ，返回true 。
- 若
- 返回
ClassBody 的 ComputedPropertyContains（参数 symbol）结果。
依赖子结构的
- 返回
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 的 ComputedPropertyContains（参数 symbol）结果。
- 返回
false 。
- 若
MemberExpression Contains symbol 为true ，返回true 。 - 返回
false 。
- 若 symbol 是保留字
super，返回true 。 - 返回
false 。
- 若
CallExpression Contains symbol 为true ，返回true 。 - 返回
false 。
- 返回
false 。
- 若
OptionalChain Contains symbol 为true ，返回true 。 - 返回
false 。
8.5.2 静态语义：ComputedPropertyContains
The syntax-directed operation
- 返回
false 。
- 返回
ComputedPropertyName Contains symbol 的结果。
- 返回
ClassElementName 的 ComputedPropertyContains（参数 symbol）结果。
- 返回
ClassElementName 的 ComputedPropertyContains（参数 symbol）结果。
- 返回
ClassElementName 的 ComputedPropertyContains（参数 symbol）结果。
- 令 inList 为
ClassElementList 的 ComputedPropertyContains（参数 symbol）。 - 若 inList 为
true ，返回true 。 - 返回
ClassElement 的 ComputedPropertyContains（参数 symbol）结果。
- 返回
false 。
- 返回
false 。
- 返回
ClassElementName 的 ComputedPropertyContains（参数 symbol）结果。
- 返回
ClassElementName 的 ComputedPropertyContains（参数 symbol）结果。
8.6 其它 (Miscellaneous)
这些操作在规范的多个位置被使用。
8.6.1 运行时语义：InstantiateFunctionObject
The syntax-directed operation
- 返回
FunctionDeclaration 的 InstantiateOrdinaryFunctionObject（参数 env 与 privateEnv）。
- 返回
GeneratorDeclaration 的 InstantiateGeneratorFunctionObject（参数 env 与 privateEnv）。
- 返回
AsyncGeneratorDeclaration 的 InstantiateAsyncGeneratorFunctionObject（参数 env 与 privateEnv）。
- 返回
AsyncFunctionDeclaration 的 InstantiateAsyncFunctionObject（参数 env 与 privateEnv）。
8.6.2 运行时语义：BindingInitialization
The syntax-directed operation
It is defined piecewise over the following productions:
- 令 name 为
Identifier 的 StringValue。 - 返回 ?
InitializeBoundName (name, value, environment)。
- 返回 ?
InitializeBoundName ("yield" , value, environment)。
- 返回 ?
InitializeBoundName ("await" , value, environment)。
- 执行 ?
RequireObjectCoercible (value)。 - 返回 ?
ObjectBindingPattern 的 BindingInitialization（参数 value, environment）。
- 令 iteratorRecord 为 ?
GetIterator (value,sync )。 - 令 result 为
Completion (ArrayBindingPattern 的 IteratorBindingInitialization（参数 iteratorRecord, environment）)。 - 如果 iteratorRecord.[[Done]] 为
false ，返回 ?IteratorClose (iteratorRecord, result)。 - 返回 ? result。
- 返回
unused 。
- 执行 ?
BindingPropertyList 的 PropertyBindingInitialization（参数 value, environment）。 - 返回
unused 。
- 令 excludedNames 为新的空列表。
- 返回 ?
BindingRestProperty 的 RestBindingInitialization（参数 value, environment, excludedNames）。
- 令 excludedNames 为 ?
BindingPropertyList 的 PropertyBindingInitialization（参数 value, environment）。 - 返回 ?
BindingRestProperty 的 RestBindingInitialization（参数 value, environment, excludedNames）。
8.6.2.1 InitializeBoundName ( name, value, environment )
The abstract operation InitializeBoundName takes arguments name (一个 String), value (一个
- 如果 environment 不为
undefined ，则- 执行 ! environment.InitializeBinding(name, value)。
- 返回
unused 。
- 否则，
- 令 lhs 为 ?
ResolveBinding (name)。 - 返回 ?
PutValue (lhs, value)。
- 令 lhs 为 ?
8.6.3 运行时语义：IteratorBindingInitialization
The syntax-directed operation
当 environment 为
It is defined piecewise over the following productions:
- 返回
unused 。
- 返回 ?
Elision 的 IteratorDestructuringAssignmentEvaluation（参数 iteratorRecord）。
- 如果
Elision 存在，则- 执行 ?
Elision 的 IteratorDestructuringAssignmentEvaluation（参数 iteratorRecord）。
- 执行 ?
- 返回 ?
BindingRestElement 的 IteratorBindingInitialization（参数 iteratorRecord, environment）。
- 执行 ?
BindingElementList 的 IteratorBindingInitialization（参数 iteratorRecord, environment）。 - 返回 ?
Elision 的 IteratorDestructuringAssignmentEvaluation（参数 iteratorRecord）。
- 执行 ?
BindingElementList 的 IteratorBindingInitialization（参数 iteratorRecord, environment）。 - 如果
Elision 存在，则- 执行 ?
Elision 的 IteratorDestructuringAssignmentEvaluation（参数 iteratorRecord）。
- 执行 ?
- 返回 ?
BindingRestElement 的 IteratorBindingInitialization（参数 iteratorRecord, environment）。
- 执行 ?
BindingElementList 的 IteratorBindingInitialization（参数 iteratorRecord, environment）。 - 返回 ?
BindingElisionElement 的 IteratorBindingInitialization（参数 iteratorRecord, environment）。
- 执行 ?
Elision 的 IteratorDestructuringAssignmentEvaluation（参数 iteratorRecord）。 - 返回 ?
BindingElement 的 IteratorBindingInitialization（参数 iteratorRecord, environment）。
- 令 bindingId 为
BindingIdentifier 的 StringValue。 - 令 lhs 为 ?
ResolveBinding (bindingId, environment)。 - 令 v 为
undefined 。 - 如果 iteratorRecord.[[Done]] 为
false ，则- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 不是
done ，则- 设 v 为 next。
- 令 next 为 ?
- 如果
Initializer 存在且 v 为undefined ，则- 如果 IsAnonymousFunctionDefinition(
Initializer ) 为true ，则- 设 v 为 ?
Initializer 的 NamedEvaluation（参数 bindingId）。
- 设 v 为 ?
- 否则，
- 令 defaultValue 为 ?
Initializer 的 Evaluation。 - 设 v 为 ?
GetValue (defaultValue)。
- 令 defaultValue 为 ?
- 如果 IsAnonymousFunctionDefinition(
- 如果 environment 为
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 的 BindingInitialization（参数 v, environment）。
- 令 lhs 为 ?
ResolveBinding (StringValue ofBindingIdentifier , environment)。 - 令 A 为 !
ArrayCreate (0)。 - 令 n 为 0。
- 重复，
- 令 next 为
done 。 - 如果 iteratorRecord.[[Done]] 为
false ，则- 设 next 为 ?
IteratorStepValue (iteratorRecord)。
- 设 next 为 ?
- 如果 next 是
done ，则- 如果 environment 为
undefined ，返回 ?PutValue (lhs, A)。 - 返回 ?
InitializeReferencedBinding (lhs, A)。
- 如果 environment 为
- 执行 !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (n)), next)。 - 设 n 为 n + 1。
- 令 next 为
- 令 A 为 !
ArrayCreate (0)。 - 令 n 为 0。
- 重复，
- 令 next 为
done 。 - 如果 iteratorRecord.[[Done]] 为
false ，则- 设 next 为 ?
IteratorStepValue (iteratorRecord)。
- 设 next 为 ?
- 如果 next 是
done ，则- 返回 ?
BindingPattern 的 BindingInitialization（参数 A, environment）。
- 返回 ?
- 执行 !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (n)), next)。 - 设 n 为 n + 1。
- 令 next 为
- 返回
unused 。
- 执行 ?
FormalParameterList 的 IteratorBindingInitialization（参数 iteratorRecord, environment）。 - 返回 ?
FunctionRestParameter 的 IteratorBindingInitialization（参数 iteratorRecord, environment）。
- 执行 ?
FormalParameterList 的 IteratorBindingInitialization（参数 iteratorRecord, environment）。 - 返回 ?
FormalParameter 的 IteratorBindingInitialization（参数 iteratorRecord, environment）。
- 令 v 为
undefined 。 - 断言：iteratorRecord.[[Done]] 为
false 。 - 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 不是
done ，则- 设 v 为 next。
- 返回 ?
BindingIdentifier 的 BindingInitialization（参数 v, environment）。
- 令 formals 为
CoverParenthesizedExpressionAndArrowParameterList 所覆盖 的ArrowFormalParameters 。 - 返回 ? formals 的 IteratorBindingInitialization（参数 iteratorRecord, environment）。
- 令 v 为
undefined 。 - 断言：iteratorRecord.[[Done]] 为
false 。 - 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 不是
done ，则- 设 v 为 next。
- 返回 ?
BindingIdentifier 的 BindingInitialization（参数 v, environment）。
8.6.4 静态语义：AssignmentTargetType
The syntax-directed operation
- 如果 IsStrict(this
IdentifierReference ) 为true 且Identifier 的 StringValue 是"eval" 或"arguments" ，返回invalid 。 - 返回
simple 。
- 返回
simple 。
- 令 expr 为
CoverParenthesizedExpressionAndArrowParameterList 所覆盖 的ParenthesizedExpression 。 - 返回 expr 的 AssignmentTargetType。
- Normative Optional如果
宿主 是 Web 浏览器或以其他方式支持函数调用赋值目标的运行时错误 且 IsStrict(thisCallExpression ) 为false ，则- 返回
web-compat 。
- 返回
- 返回
invalid 。
- 返回
invalid 。
8.6.5 静态语义：PropName
The syntax-directed operation
- 返回
IdentifierReference 的 StringValue。
- 返回
empty 。
- 返回
PropertyName 的 PropName。
- 返回
IdentifierName 的 StringValue。
- 返回
StringLiteral 的 SV。
- 令 nbr 为
NumericLiteral 的 NumericValue。 - 返回 !
ToString (nbr)。
- 返回
empty 。
- 返回
ClassElementName 的 PropName。
- 返回
ClassElementName 的 PropName。
- 返回
ClassElementName 的 PropName。
- 返回
empty 。
- 返回
empty 。
- 返回
ClassElementName 的 PropName。
- 返回
ClassElementName 的 PropName。
- 返回
empty 。
9 可执行代码与执行上下文 (Executable Code and Execution Contexts)
9.1 环境记录 (Environment Records)
Environment Record 是一种规范类型，用于基于 ECMAScript 代码的词法嵌套结构，将
每个 Environment Record 都有一个 [[OuterEnv]] 字段，其值为
Environment Record 纯属规范机制，不需要对应到 ECMAScript 实现中的任何具体产物。ECMAScript 程序无法直接访问或操纵这些值。
9.1.1 Environment Record 类型层次 (The Environment Record Type Hierarchy)
可以将
-
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 用于定义类似WithStatement 那样把标识符绑定关联到某对象属性的 ECMAScript 元素的效果。 -
Global Environment Record 用于Script 的全局声明。它没有外层环境；其 [[OuterEnv]] 为null 。它可被预填充标识符绑定，并包含一个关联的全局对象，该对象的属性提供部分全局环境的标识符绑定。随着 ECMAScript 代码执行，可以向全局对象增加属性或修改初始属性。
-
| 方法 | 目的 |
|---|---|
| HasBinding(N) |
判断 |
| CreateMutableBinding(N, D) |
创建一个新的、未初始化的可变绑定。字符串 N 为名称文本。若布尔参数 D 为 |
| CreateImmutableBinding(N, S) |
创建新的、未初始化的不可变绑定。字符串 N 为名称文本。若 S 为 |
| InitializeBinding(N, V) |
为已存在但未初始化的绑定设置值。N 为名称文本，V 为任意 |
| SetMutableBinding(N, V, S) |
为已存在的可变绑定设置值 V。S 为布尔标记；若 S 为 |
| GetBindingValue(N, S) |
返回已存在绑定的值。S 标记引用是否源自严格模式（或需要严格语义）。若 S 为 |
| DeleteBinding(N) |
删除名称为 N 的绑定。存在则移除并返回 |
| HasThisBinding() |
判断是否建立 this 绑定；是返回 |
| HasSuperBinding() |
判断是否建立 super 方法绑定；是返回 |
| WithBaseObject() |
若该 with 语句关联则返回其对象；否则返回 |
9.1.1.1 声明式环境记录 (Declarative Environment Records)
每个 Declarative Environment Record 与一个 ECMAScript 程序作用域关联，该作用域包含变量、常量、let、class、module、import 以及（或）函数声明。Declarative Environment Record 绑定其作用域内声明定义的标识符集合。
9.1.1.1.1 HasBinding ( N )
The HasBinding concrete method of takes argument N (一个 String) and returns 一个包含 Boolean 的
- 若 envRec 对 N 有绑定，返回
true 。 - 返回
false 。
9.1.1.1.2 CreateMutableBinding ( N, D )
The CreateMutableBinding concrete method of takes arguments N (一个 String) and D (一个 Boolean) and returns 一个包含
- 断言：envRec 尚无 N 绑定。
- 在 envRec 中创建 N 的可变绑定并记录其未初始化。若 D 为
true ，记录该绑定可被后续 DeleteBinding 删除。 - 返回
unused 。
9.1.1.1.3 CreateImmutableBinding ( N, S )
The CreateImmutableBinding concrete method of takes arguments N (一个 String) and S (一个 Boolean) and returns 一个包含
- 断言：envRec 尚无 N 绑定。
- 在 envRec 中创建 N 的不可变绑定并记录其未初始化。若 S 为
true ，记录其为严格绑定。 - 返回
unused 。
9.1.1.1.4 InitializeBinding ( N, V )
The InitializeBinding concrete method of takes arguments N (一个 String) and V (一个
- 断言：envRec 必须有 N 的未初始化绑定。
- 将 envRec 中 N 的绑定值设为 V。
记录 envRec 中 N 的绑定已被初始化。- 返回
unused 。
9.1.1.1.5 SetMutableBinding ( N, V, S )
The SetMutableBinding concrete method of takes arguments N (一个 String), V (一个
- 若 envRec 无 N 绑定，则
- 若 S 为
true ，抛ReferenceError 。 - 执行 ! envRec.CreateMutableBinding(N,
true )。 - 执行 ! envRec.InitializeBinding(N, V)。
- 返回
unused 。
- 若 S 为
- 若 envRec 中 N 的绑定是严格绑定，将 S 设为
true 。 - 若 envRec 中 N 的绑定尚未初始化，则
- 抛
ReferenceError 。
- 抛
- 否则若为可变绑定，
- 将其值改为 V。
- 否则，
- 断言：正在尝试修改不可变绑定的值。
- 若 S 为
true ，抛TypeError 。
- 返回
unused 。
导致在步骤
function f() { eval("var x; x = (delete x, 0);"); }9.1.1.1.6 GetBindingValue ( N, S )
The GetBindingValue concrete method of takes arguments N (一个 String) and S (一个 Boolean) and returns 一个包含
- 断言：envRec 有 N 的绑定。
- 若其为未初始化绑定，抛
ReferenceError 。 - 返回当前绑定于 N 的值。
9.1.1.1.7 DeleteBinding ( N )
The DeleteBinding concrete method of takes argument N (一个 String) and returns 一个包含 Boolean 的
- 断言：envRec 有 N 的绑定。
- 若该绑定不可删除，返回
false 。 - 从 envRec 移除该绑定。
- 返回
true 。
9.1.1.1.8 HasThisBinding ( )
The HasThisBinding concrete method of takes no arguments and returns
- 返回
false 。
普通 this 绑定。
9.1.1.1.9 HasSuperBinding ( )
The HasSuperBinding concrete method of takes no arguments and returns
- 返回
false 。
普通 super 绑定。
9.1.1.1.10 WithBaseObject ( )
The WithBaseObject concrete method of takes no arguments and returns
- 返回
undefined 。
9.1.1.2 对象环境记录 (Object Environment Records)
每个 Object Environment Record 关联一个称为其 binding object 的对象。它绑定该对象
为 with 语句（
Object Environment Record 具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[BindingObject]] | 一个 Object |
此 |
| [[IsWithEnvironment]] | 一个 Boolean |
指示该记录是否为 with 语句创建。
|
9.1.1.2.1 HasBinding ( N )
The HasBinding concrete method of takes argument N (一个 String) and returns 一个包含 Boolean 的
- 令 bindingObject 为 envRec.[[BindingObject]]。
- 令 foundBinding 为 ?
HasProperty (bindingObject, N)。 - 若 foundBinding 为
false ，返回false 。 - 若 envRec.[[IsWithEnvironment]] 为
false ，返回true 。 - 令 unscopables 为 ?
Get (bindingObject,%Symbol.unscopables% )。 - 若 unscopables
是 Object ，则 - 返回
true 。
9.1.1.2.2 CreateMutableBinding ( N, D )
The CreateMutableBinding concrete method of takes arguments N (一个 String) and D (一个 Boolean) and returns 一个包含
- 令 bindingObject 为 envRec.[[BindingObject]]。
- 执行 ?
DefinePropertyOrThrow (bindingObject, N, PropertyDescriptor { [[Value]]:undefined , [[Writable]]:true , [[Enumerable]]:true , [[Configurable]]: D })。 - 返回
unused 。
通常 envRec 不会已有 N 绑定；若已存在，
9.1.1.2.3 CreateImmutableBinding ( N, S )
9.1.1.2.4 InitializeBinding ( N, V )
The InitializeBinding concrete method of takes arguments N (一个 String) and V (一个
- 执行 ? envRec.SetMutableBinding(N, V,
false )。 - 返回
unused 。
在本规范中，对
9.1.1.2.5 SetMutableBinding ( N, V, S )
The SetMutableBinding concrete method of takes arguments N (一个 String), V (一个
- 令 bindingObject 为 envRec.[[BindingObject]]。
- 令 stillExists 为 ?
HasProperty (bindingObject, N)。 - 若 stillExists 为
false 且 S 为true ，抛ReferenceError 。 - 执行 ?
Set (bindingObject, N, V, S)。 - 返回
unused 。
9.1.1.2.6 GetBindingValue ( N, S )
The GetBindingValue concrete method of takes arguments N (一个 String) and S (一个 Boolean) and returns 一个包含
- 令 bindingObject 为 envRec.[[BindingObject]]。
- 令 value 为 ?
HasProperty (bindingObject, N)。 - 若 value 为
false ，则- 若 S 为
false ，返回undefined ；否则抛ReferenceError 。
- 若 S 为
- 返回 ?
Get (bindingObject, N)。
9.1.1.2.7 DeleteBinding ( N )
The DeleteBinding concrete method of takes argument N (一个 String) and returns 一个包含 Boolean 的
- 令 bindingObject 为 envRec.[[BindingObject]]。
- 返回 ? bindingObject.[[Delete]](N)。
9.1.1.2.8 HasThisBinding ( )
The HasThisBinding concrete method of takes no arguments and returns
- 返回
false 。
this 绑定。
9.1.1.2.9 HasSuperBinding ( )
The HasSuperBinding concrete method of takes no arguments and returns
- 返回
false 。
super 绑定。
9.1.1.2.10 WithBaseObject ( )
The WithBaseObject concrete method of takes no arguments and returns 一个 Object 或
- 若 envRec.[[IsWithEnvironment]] 为
true ，返回 envRec.[[BindingObject]]。 - 否则返回
undefined 。
9.1.1.3 函数环境记录 (Function Environment Records)
Function Environment Record 是一个 this 绑定。若一个非 super，其 Function Environment Record 也包含执行 super 方法调用所需的状态。
Function Environment Record 有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[ThisValue]] |
一个 |
此次函数调用使用的 |
| [[ThisBindingStatus]] |
|
若为 |
| [[FunctionObject]] |
一个 ECMAScript |
其调用导致此 |
| [[NewTarget]] |
一个 constructor 或 |
若由 [[Construct]] 创建，则为该内部方法 newTarget 参数；否则为 |
Function Environment Record 支持
| 方法 | 目的 |
|---|---|
| GetThisBinding() |
返回该 this 绑定值，若尚未初始化则抛 |
9.1.1.3.1 BindThisValue ( envRec, V )
The abstract operation BindThisValue takes arguments envRec (一个
- 断言：envRec.[[ThisBindingStatus]] 不为
lexical 。 - 若 envRec.[[ThisBindingStatus]] 为
initialized ，抛ReferenceError 。 - 设 envRec.[[ThisValue]] 为 V。
- 设 envRec.[[ThisBindingStatus]] 为
initialized 。 - 返回
unused 。
9.1.1.3.2 HasThisBinding ( )
The HasThisBinding concrete method of takes no arguments and returns 一个 Boolean. It performs the following steps when called:
- 若 envRec.[[ThisBindingStatus]] 为
lexical ，返回false ；否则返回true 。
9.1.1.3.3 HasSuperBinding ( )
The HasSuperBinding concrete method of takes no arguments and returns 一个 Boolean. It performs the following steps when called:
- 若 envRec.[[ThisBindingStatus]] 为
lexical ，返回false 。 - 若 envRec.[[FunctionObject]].[[HomeObject]] 为
undefined ，返回false ；否则返回true 。
9.1.1.3.4 GetThisBinding ( )
The GetThisBinding concrete method of takes no arguments and returns 一个包含
- 断言：envRec.[[ThisBindingStatus]] 不为
lexical 。 - 若 envRec.[[ThisBindingStatus]] 为
uninitialized ，抛ReferenceError 。 - 返回 envRec.[[ThisValue]]。
9.1.1.3.5 GetSuperBase ( envRec )
The abstract operation GetSuperBase takes argument envRec (一个
- 令 home 为 envRec.[[FunctionObject]].[[HomeObject]]。
- 若 home 为
undefined ，返回undefined 。 - 断言：home 是
普通对象 。 - 返回 ! home.[[GetPrototypeOf]]()。
9.1.1.4 全局环境记录 (Global Environment Records)
Global Environment Record 表示在同一
Global Environment Record 在逻辑上是单一记录，但被描述为封装一个
可以直接在全局对象上创建属性，因此 Object 组件可能同时包含通过声明显式创建的绑定与作为全局对象属性隐式创建的绑定。为区分通过声明显式创建的绑定，Global Environment Record 维护使用
Global Environment Record 具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[ObjectRecord]] |
一个 |
绑定对象是全局对象，包含全局内置绑定以及全局代码中 |
| [[GlobalThisValue]] | 一个 Object |
全局作用域中 this 返回的值； |
| [[DeclarativeRecord]] |
一个 |
|
| 方法 | 目的 |
|---|---|
| GetThisBinding() |
返回该 this 绑定。
|
9.1.1.4.1 HasBinding ( N )
The HasBinding concrete method of takes argument N (一个 String) and returns 一个包含 Boolean 的
- 令 DclRec 为 envRec.[[DeclarativeRecord]]。
- 若 ! DclRec.HasBinding(N) 为
true ，返回true 。 - 令 ObjRec 为 envRec.[[ObjectRecord]]。
- 返回 ? ObjRec.HasBinding(N)。
9.1.1.4.2 CreateMutableBinding ( N, D )
The CreateMutableBinding concrete method of takes arguments N (一个 String) and D (一个 Boolean) and returns 一个包含
- 令 DclRec 为 envRec.[[DeclarativeRecord]]。
- 若 ! DclRec.HasBinding(N) 为
true ，抛TypeError 。 - 返回 ! DclRec.CreateMutableBinding(N, D)。
9.1.1.4.3 CreateImmutableBinding ( N, S )
The CreateImmutableBinding concrete method of takes arguments N (一个 String) and S (一个 Boolean) and returns 一个包含
- 令 DclRec 为 envRec.[[DeclarativeRecord]]。
- 若 ! DclRec.HasBinding(N) 为
true ，抛TypeError 。 - 返回 ! DclRec.CreateImmutableBinding(N, S)。
9.1.1.4.4 InitializeBinding ( N, V )
The InitializeBinding concrete method of takes arguments N (一个 String) and V (一个
- 令 DclRec 为 envRec.[[DeclarativeRecord]]。
- 若 ! DclRec.HasBinding(N) 为
true ，则- 返回 ! DclRec.InitializeBinding(N, V)。
- 断言：若存在绑定则位于
Object Environment Record 中。 - 令 ObjRec 为 envRec.[[ObjectRecord]]。
- 返回 ? ObjRec.InitializeBinding(N, V)。
9.1.1.4.5 SetMutableBinding ( N, V, S )
The SetMutableBinding concrete method of takes arguments N (一个 String), V (一个
- 令 DclRec 为 envRec.[[DeclarativeRecord]]。
- 若 ! DclRec.HasBinding(N) 为
true ，则- 返回 ? DclRec.SetMutableBinding(N, V, S)。
- 令 ObjRec 为 envRec.[[ObjectRecord]]。
- 返回 ? ObjRec.SetMutableBinding(N, V, S)。
9.1.1.4.6 GetBindingValue ( N, S )
The GetBindingValue concrete method of takes arguments N (一个 String) and S (一个 Boolean) and returns 一个包含
- 令 DclRec 为 envRec.[[DeclarativeRecord]]。
- 若 ! DclRec.HasBinding(N) 为
true ，则- 返回 ? DclRec.GetBindingValue(N, S)。
- 令 ObjRec 为 envRec.[[ObjectRecord]]。
- 返回 ? ObjRec.GetBindingValue(N, S)。
9.1.1.4.7 DeleteBinding ( N )
The DeleteBinding concrete method of takes argument N (一个 String) and returns 一个包含 Boolean 的
- 令 DclRec 为 envRec.[[DeclarativeRecord]]。
- 若 ! DclRec.HasBinding(N) 为
true ，则- 返回 ! DclRec.DeleteBinding(N)。
- 令 ObjRec 为 envRec.[[ObjectRecord]]。
- 令 globalObject 为 ObjRec.[[BindingObject]]。
- 令 existingProp 为 ?
HasOwnProperty (globalObject, N)。 - 若 existingProp 为
true ，则- 返回 ? ObjRec.DeleteBinding(N)。
- 返回
true 。
9.1.1.4.8 HasThisBinding ( )
The HasThisBinding concrete method of takes no arguments and returns
- 返回
true 。
this 绑定。
9.1.1.4.9 HasSuperBinding ( )
The HasSuperBinding concrete method of takes no arguments and returns
- 返回
false 。
super 绑定。
9.1.1.4.10 WithBaseObject ( )
The WithBaseObject concrete method of takes no arguments and returns
- 返回
undefined 。
9.1.1.4.11 GetThisBinding ( )
The GetThisBinding concrete method of takes no arguments and returns 一个包含 Object 的
- 返回 envRec.[[GlobalThisValue]]。
9.1.1.4.12 HasLexicalDeclaration ( envRec, N )
The abstract operation HasLexicalDeclaration takes arguments envRec (一个
- 令 DclRec 为 envRec.[[DeclarativeRecord]]。
- 返回 ! DclRec.HasBinding(N)。
9.1.1.4.13 HasRestrictedGlobalProperty ( envRec, N )
The abstract operation HasRestrictedGlobalProperty takes arguments envRec (一个
- 令 ObjRec 为 envRec.[[ObjectRecord]]。
- 令 globalObject 为 ObjRec.[[BindingObject]]。
- 令 existingProp 为 ? globalObject.[[GetOwnProperty]](N)。
- 若 existingProp 为
undefined ，返回false 。 - 若 existingProp.[[Configurable]] 为
true ，返回false 。 - 返回
true 。
可直接在全局对象上存在非声明创建的属性。不能创建与全局对象不可配置属性同名的全局词法绑定，例如
9.1.1.4.14 CanDeclareGlobalVar ( envRec, N )
The abstract operation CanDeclareGlobalVar takes arguments envRec (一个
- 令 ObjRec 为 envRec.[[ObjectRecord]]。
- 令 globalObject 为 ObjRec.[[BindingObject]]。
- 令 hasProperty 为 ?
HasOwnProperty (globalObject, N)。 - 若 hasProperty 为
true ，返回true 。 - 返回 ?
IsExtensible (globalObject)。
9.1.1.4.15 CanDeclareGlobalFunction ( envRec, N )
The abstract operation CanDeclareGlobalFunction takes arguments envRec (一个
- 令 ObjRec 为 envRec.[[ObjectRecord]]。
- 令 globalObject 为 ObjRec.[[BindingObject]]。
- 令 existingProp 为 ? globalObject.[[GetOwnProperty]](N)。
- 若 existingProp 为
undefined ，返回 ?IsExtensible (globalObject)。 - 若 existingProp.[[Configurable]] 为
true ，返回true 。 - 若
IsDataDescriptor (existingProp) 为true 且 existingProp 具属性 { [[Writable]]:true , [[Enumerable]]:true }，返回true 。 - 返回
false 。
9.1.1.4.16 CreateGlobalVarBinding ( envRec, N, D )
The abstract operation CreateGlobalVarBinding takes arguments envRec (一个
- 令 ObjRec 为 envRec.[[ObjectRecord]]。
- 令 globalObject 为 ObjRec.[[BindingObject]]。
- 令 hasProperty 为 ?
HasOwnProperty (globalObject, N)。 - 令 extensible 为 ?
IsExtensible (globalObject)。 - 若 hasProperty 为
false 且 extensible 为true ，则- 执行 ? ObjRec.CreateMutableBinding(N, D)。
- 执行 ? ObjRec.InitializeBinding(N,
undefined )。
- 返回
unused 。
9.1.1.4.17 CreateGlobalFunctionBinding ( envRec, N, V, D )
The abstract operation CreateGlobalFunctionBinding takes arguments envRec (一个
- 令 ObjRec 为 envRec.[[ObjectRecord]]。
- 令 globalObject 为 ObjRec.[[BindingObject]]。
- 令 existingProp 为 ? globalObject.[[GetOwnProperty]](N)。
- 若 existingProp 为
undefined 或其 [[Configurable]] 为true ，则- 令 desc 为 PropertyDescriptor { [[Value]]: V, [[Writable]]:
true , [[Enumerable]]:true , [[Configurable]]: D }。
- 令 desc 为 PropertyDescriptor { [[Value]]: V, [[Writable]]:
- 否则，
- 令 desc 为 PropertyDescriptor { [[Value]]: V }。
- 执行 ?
DefinePropertyOrThrow (globalObject, N, desc)。 - 执行 ?
Set (globalObject, N, V,false )。 - 返回
unused 。
全局函数声明总以全局对象自有属性表示；若可行，重配置为标准属性集。步骤
9.1.1.5 模块环境记录 (Module Environment Records)
Module Environment Record 是一个
Module Environment Record 支持
| 方法 | 目的 |
|---|---|
| GetThisBinding() |
返回该 this 绑定值。
|
9.1.1.5.1 GetBindingValue ( N, S )
The GetBindingValue concrete method of takes arguments N (一个 String) and S (一个 Boolean) and returns 一个包含
- 断言：S 为
true 。 - 断言：envRec 有 N 绑定。
- 若 N 的绑定是间接绑定，则
- 令 M 与 N2 为创建该绑定时提供的间接值。
- 令 targetEnv 为 M.[[Environment]]。
- 若 targetEnv 为
empty ，抛ReferenceError 。 - 返回 ? targetEnv.GetBindingValue(N2,
true )。
- 若 envRec 中 N 的绑定为未初始化，抛
ReferenceError 。 - 返回当前绑定于 N 的值。
S 始终为
9.1.1.5.2 DeleteBinding ( N )
9.1.1.5.3 HasThisBinding ( )
The HasThisBinding concrete method of takes no arguments and returns
- 返回
true 。
this 绑定。
9.1.1.5.4 GetThisBinding ( )
The GetThisBinding concrete method of takes no arguments and returns 一个包含
- 返回
undefined 。
9.1.1.5.5 CreateImportBinding ( envRec, N, M, N2 )
The abstract operation CreateImportBinding takes arguments envRec (一个
- 断言：envRec 尚无 N 绑定。
- 断言：当 M.[[Environment]] 实例化时会有 N2 的直接绑定。
- 在 envRec 中创建引用 M 与 N2 的不可变间接绑定并记录其已初始化。
- 返回
unused 。
9.1.2 环境记录操作 (Environment Record Operations)
下列
9.1.2.1 GetIdentifierReference ( env, name, strict )
The abstract operation GetIdentifierReference takes arguments env (一个
- 若 env 为
null ，则- 返回
Reference Record { [[Base]]:unresolvable , [[ReferencedName]]: name, [[Strict]]: strict, [[ThisValue]]:empty }。
- 返回
- 令 exists 为 ? env.HasBinding(name)。
- 若 exists 为
true ，则- 返回
Reference Record { [[Base]]: env, [[ReferencedName]]: name, [[Strict]]: strict, [[ThisValue]]:empty }。
- 返回
- 否则，
- 令 outer 为 env.[[OuterEnv]]。
- 返回 ?
GetIdentifierReference (outer, name, strict)。
9.1.2.2 NewDeclarativeEnvironment ( E )
The abstract operation NewDeclarativeEnvironment takes argument E (一个
- 令 env 为一个不含绑定的新
Declarative Environment Record 。 - 设 env.[[OuterEnv]] 为 E。
- 返回 env。
9.1.2.3 NewObjectEnvironment ( O, W, E )
The abstract operation NewObjectEnvironment takes arguments O (一个 Object), W (一个 Boolean), and E (一个
- 令 env 为一个新
Object Environment Record 。 - 设 env.[[BindingObject]] 为 O。
- 设 env.[[IsWithEnvironment]] 为 W。
- 设 env.[[OuterEnv]] 为 E。
- 返回 env。
9.1.2.4 NewFunctionEnvironment ( F, newTarget )
The abstract operation NewFunctionEnvironment takes arguments F (一个 ECMAScript
- 令 env 为一个不含绑定的新
Function Environment Record 。 - 设 env.[[FunctionObject]] 为 F。
- 若 F.[[ThisMode]] 为
lexical ，设 env.[[ThisBindingStatus]] 为lexical 。 - 否则设 env.[[ThisBindingStatus]] 为
uninitialized 。 - 设 env.[[NewTarget]] 为 newTarget。
- 设 env.[[OuterEnv]] 为 F.[[Environment]]。
- 返回 env。
9.1.2.5 NewGlobalEnvironment ( G, thisValue )
The abstract operation NewGlobalEnvironment takes arguments G (一个 Object) and thisValue (一个 Object) and returns 一个
- 令 objRec 为
NewObjectEnvironment (G,false ,null )。 - 令 dclRec 为
NewDeclarativeEnvironment (null )。 - 令 env 为一个新
Global Environment Record 。 - 设 env.[[ObjectRecord]] 为 objRec。
- 设 env.[[GlobalThisValue]] 为 thisValue。
- 设 env.[[DeclarativeRecord]] 为 dclRec。
- 设 env.[[OuterEnv]] 为
null 。 - 返回 env。
9.1.2.6 NewModuleEnvironment ( E )
The abstract operation NewModuleEnvironment takes argument E (一个
- 令 env 为一个不含绑定的新
Module Environment Record 。 - 设 env.[[OuterEnv]] 为 E。
- 返回 env。
9.2 PrivateEnvironment 记录 (PrivateEnvironment Records)
PrivateEnvironment Record 是一种规范机制，用于基于 ECMAScript 代码中
每个
| 字段名 | 值类型 | 含义 |
|---|---|---|
| [[OuterPrivateEnvironment]] |
一个 |
最近包围的 class 的 |
| [[Names]] |
一个 |
该 class 声明的 |
9.2.1 PrivateEnvironment Record 操作 (PrivateEnvironment Record Operations)
以下
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 pn，执行- 若 pn.[[Description]] 为 identifier，则
- 返回 pn。
- 若 pn.[[Description]] 为 identifier，则
- 令 outerPrivateEnv 为 privateEnv.[[OuterPrivateEnvironment]]。
- 断言：outerPrivateEnv 不为
null 。 - 返回
ResolvePrivateIdentifier (outerPrivateEnv, identifier)。
9.3 Realm
在被求值之前，所有 ECMAScript 代码都必须与一个 realm 相关联。概念上，
在本规范中，一个
| 字段名 | 值 | 含义 |
|---|---|---|
| [[AgentSignifier]] | 一个 agent 标识符 |
拥有该 |
| [[Intrinsics]] |
一个 |
与该 |
| [[GlobalObject]] | 一个 Object |
该 |
| [[GlobalEnv]] |
一个 |
该 |
| [[TemplateMap]] |
一个 |
模板对象按 一旦某 Parse Node 变为不可达，对应 [[Array]] 也不可达；实现移除该对条目将不可观察。 |
| [[LoadedModules]] |
一个 |
从该
如 import() 表达式时使用。
|
| [[HostDefined]] |
任意 (默认值为 |
为需要与 |
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 ( realmRec )
The abstract operation CreateIntrinsics takes argument realmRec (a
- 将 realmRec.[[Intrinsics]] 设为一个新的
Record 。 - 按
Table 6 中的值设置 realmRec.[[Intrinsics]] 的字段。字段名为该表第一列列出的名称。每个字段的值为一个根据19 至28 中各对象规范完全递归填充属性值的新对象。所有对象属性值均为新创建对象。所有内置函数对象 通过执行CreateBuiltinFunction (steps, length, name, slots, realmRec, prototype) 创建，其中 steps 是本规范给出的该函数定义，name 是函数"name" 属性初始值，length 是函数"length" 属性初始值，slots 是函数指定内部槽名称列表（若有），prototype 是指定的 [[Prototype]] 内部槽值。内在对象及其属性的创建顺序必须避免依赖尚未创建的对象。 - 执行
AddRestrictedFunctionProperties (realmRec.[[Intrinsics]].[[%Function.prototype% ]], realmRec)。 - 返回
unused 。
9.3.3 SetDefaultGlobalBindings ( realmRec )
The abstract operation SetDefaultGlobalBindings takes argument realmRec (a
9.4 执行上下文 (Execution Contexts)
execution context 是规范装置，用于跟踪 ECMAScript 实现对代码的运行时求值。在任意时刻，每个 agent 最多只有一个实际执行代码的执行上下文，称为该 agent 的 运行执行上下文 (running execution context)。本规范中所有对运行执行上下文的引用均指当前 agent 的运行执行上下文。
执行上下文栈 (execution context stack) 用于跟踪执行上下文。运行执行上下文始终是该栈的顶部元素。当控制从当前运行执行上下文关联的可执行代码转移到不与其关联的可执行代码时，会创建一个新的执行上下文。新执行上下文被压入栈顶并成为运行执行上下文。
执行上下文包含跟踪其关联代码执行进度所需的实现特定状态。每个执行上下文至少具有
| 组成部分 | 目的 |
|---|---|
| code evaluation state | 执行、暂停与恢复该上下文关联代码求值所需的任意状态。 |
| Function |
若该上下文正在求值某 |
|
|
关联代码访问 ECMAScript 资源所用的 |
| ScriptOrModule |
关联代码来源的 |
运行执行上下文对代码的求值可在本规范定义的各种点被挂起。一旦挂起，另一个执行上下文可成为运行执行上下文并开始求值其代码。之后某个时间，被挂起的执行上下文可再次成为运行执行上下文并从之前挂起的位置继续。运行执行上下文在不同上下文间的转换通常按堆栈后进先出方式，但某些 ECMAScript 特性需要非 LIFO 的转换。
运行执行上下文
ECMAScript 代码执行上下文 具有
| 组成部分 | 目的 |
|---|---|
| LexicalEnvironment |
标识用于解析该上下文中代码标识符引用的 |
| VariableEnvironment |
标识在该上下文中由 |
| PrivateEnvironment |
标识持有最近包围 class 中 |
执行上下文的 LexicalEnvironment 与 VariableEnvironment 组成部分始终是
表示 Generator 求值的执行上下文具有
| 组成部分 | 目的 |
|---|---|
| Generator | 该执行上下文正在求值的 Generator。 |
大多数情况下，只有运行执行上下文（执行上下文栈顶）被本规范内算法直接操作。因此当未限定使用 “LexicalEnvironment” 与 “VariableEnvironment” 时，指的是运行执行上下文的那些组成部分。
执行上下文纯属规范机制，不必对应 ECMAScript 实现中的具体实体。ECMAScript 代码无法直接访问或观察执行上下文。
9.4.1 GetActiveScriptOrModule ( )
The abstract operation GetActiveScriptOrModule takes no arguments and returns a Script
- 若执行上下文栈为空，返回
null 。 - 令 ec 为执行上下文栈顶端第一个其 ScriptOrModule 组成部分不为
null 的执行上下文。 - 若不存在此执行上下文，返回
null ；否则返回 ec 的 ScriptOrModule。
9.4.2 ResolveBinding ( name [ , env ] )
The abstract operation ResolveBinding takes argument name (a String) and optional argument env (an
- 若 env 未提供或 env 为
undefined ，则- 设 env 为运行执行上下文的 LexicalEnvironment。
- 断言：env 是一个
Environment Record 。 - 令 strict 为正被求值的语法产生式的 IsStrict 结果。
- 返回 ?
GetIdentifierReference (env, name, strict)。
ResolveBinding 的结果始终是一个 [[ReferencedName]] 字段为 name 的
9.4.3 GetThisEnvironment ( )
The abstract operation GetThisEnvironment takes no arguments and returns an this 绑定的
- 令 env 为运行执行上下文的 LexicalEnvironment。
- 重复，
- 令 exists 为 env.HasThisBinding()。
- 若 exists 为
true ，返回 env。 - 令 outer 为 env.[[OuterEnv]]。
- 断言：outer 不为
null 。 - 设 env 为 outer。
步骤 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:
- 令 envRec 为
GetThisEnvironment ()。 - 返回 ? envRec.GetThisBinding()。
9.4.5 GetNewTarget ( )
The abstract operation GetNewTarget takes no arguments and returns an Object or
- 令 envRec 为
GetThisEnvironment ()。 - 断言：envRec 有 [[NewTarget]] 字段。
- 返回 envRec.[[NewTarget]]。
9.4.6 GetGlobalObject ( )
The abstract operation GetGlobalObject takes no arguments and returns an Object. 返回当前运行执行上下文使用的全局对象。 It performs the following steps when called:
- 令 currentRealm 为
当前 Realm Record 。 - 返回 currentRealm.[[GlobalObject]]。
9.5 作业 (Jobs) 以及用于入队作业的宿主操作
Job（作业） 是一个无参数的抽象闭包（
作业由 ECMAScript
- 在未来某个时间点，当相应 agent 中没有正在运行的上下文且该 agent 的执行上下文栈为空时，实现必须：
- 在一个 agent 中任意时间只能有一个 Job 正在被求值。
- 一旦开始求值某个 Job，在该 agent 中必须先运行至完成，之后才可开始另一个 Job 的求值。
- 该抽象闭包必须返回一个
正常完成 （normal completion），并自行处理错误。
在任意时间，若下列条件全部成立，则 scriptOrModule（一个 Script
GetActiveScriptOrModule () 的结果为 scriptOrModule。- 若 scriptOrModule 是 Script
Record 或Module Record ，令 ec 为执行上下文栈顶端第一个其 ScriptOrModule 组成部分为 scriptOrModule 的执行上下文。ec 的Realm 组成部分为 scriptOrModule.[[Realm]]。
在任意时间，若以下条件全部成立，则某次执行已准备好求值 ECMAScript 代码 (prepared to evaluate ECMAScript code)：
- 执行上下文栈不为空。
- 执行上下文栈顶端执行上下文的
Realm 组成部分是一个Realm Record 。
特定种类的 Job 还有额外的一致性要求。
9.5.1 JobCallback 记录 (JobCallback Records)
JobCallback Record 是用于存储一个
例如，WHATWG HTML 规范（https://html.spec.whatwg.org/）使用该
JobCallback Record 具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Callback]] |
一个 |
当该 Job 被调用时要调用的函数。 |
| [[HostDefined]] |
任意（默认值 |
保留给 |
9.5.2 HostMakeJobCallback ( callback )
The host-defined abstract operation HostMakeJobCallback takes argument callback (a function object) and returns a
HostMakeJobCallback 的实现必须符合以下要求：
- 它必须返回一个 [[Callback]] 字段为 callback 的
JobCallback Record 。
HostMakeJobCallback 的默认实现被调用时执行下列步骤：
- 返回
JobCallback Record { [[Callback]]: callback, [[HostDefined]]:empty }。
不是 Web 浏览器的 ECMAScript
调用发生在回调被传入负责最终调度并运行它的函数之时。例如，promise.then(thenAction) 在调用 Promise.prototype.then 时对 thenAction 调用 MakeJobCallback，而不是在调度 reaction Job 时。
9.5.3 HostCallJobCallback ( jobCallback, V, argumentsList )
The host-defined abstract operation HostCallJobCallback takes arguments jobCallback (a
HostCallJobCallback 的实现必须符合以下要求：
- 它必须执行并返回 Call(jobCallback.[[Callback]], V, argumentsList) 的结果。
HostCallJobCallback 的默认实现被调用时执行下列步骤：
- 断言：
IsCallable (jobCallback.[[Callback]]) 为true 。 - 返回 ? Call(jobCallback.[[Callback]], V, argumentsList)。
不是 Web 浏览器的 ECMAScript
9.5.4 HostEnqueueGenericJob ( job, realm )
The host-defined abstract operation HostEnqueueGenericJob takes arguments job (a Job
HostEnqueueGenericJob 的实现必须符合
9.5.5 HostEnqueuePromiseJob ( job, realm )
The host-defined abstract operation HostEnqueuePromiseJob takes arguments job (a Job
HostEnqueuePromiseJob 的实现必须符合
- 若 realm 不为
null ，则每次 job 被调用时，实现必须执行实现定义步骤，使得在 job 调用时执行已准备好求值 ECMAScript 代码。 - 令 scriptOrModule 为调用 HostEnqueuePromiseJob 时的
GetActiveScriptOrModule ()。若 realm 不为null ，则每次 job 被调用时，实现必须执行实现定义步骤，使得在 job 调用时 scriptOrModule 为活动脚本或模块。 - 作业必须按调度它们的各次 HostEnqueuePromiseJob 调用的顺序运行。
由
9.5.6 HostEnqueueTimeoutJob ( timeoutJob, realm, milliseconds )
The host-defined abstract operation HostEnqueueTimeoutJob takes arguments timeoutJob (a Job
HostEnqueueTimeoutJob 的实现必须符合
9.6 Agents（代理）
agent（代理） 由一组 ECMAScript 执行上下文、一个执行上下文栈、一个运行执行上下文、一个 Agent Record 以及一个 执行线程 (executing thread) 组成。除执行线程外，agent 的各组成部分只属于该 agent 本身。
agent 的执行线程独立于其它 agent 在其执行上下文上执行算法步骤；但是一个执行线程可被多个 agent 共享，前提是共享该线程的 agent 中没有其
例如，一些 Web 浏览器会在多个互不相关的标签页间共享单一执行线程。
当一个 agent 的执行线程在执行算法步骤时，该 agent 就是这些步骤的 包围 agent (surrounding agent)。这些步骤通过该包围 agent 访问其持有的规范级执行对象：运行执行上下文、执行上下文栈以及
agent signifier（代理标识符） 是用于标识一个 Agent 的全局唯一不透明值。
| 字段名 | 值 | 含义 |
|---|---|---|
| [[LittleEndian]] | a Boolean | 用于算法 |
| [[CanBlock]] | a Boolean | 决定该 agent 是否可以阻塞。 |
| [[Signifier]] | an agent signifier | 在其 agent 集群内唯一标识该 agent。 |
| [[IsLockFree1]] | a Boolean | 若对单 |
| [[IsLockFree2]] | a Boolean | 若对双 |
| [[IsLockFree8]] | a Boolean | 若对八 |
| [[CandidateExecution]] | a |
参见 |
| [[KeptAlive]] | a |
初始为空 |
| [[ModuleAsyncEvaluationCount]] | an |
初始为 0，用于为异步或具有异步依赖的模块的 [[AsyncEvaluationOrder]] 字段分配递增唯一值。 |
一旦 [[Signifier]]、[[IsLockFree1]] 与 [[IsLockFree2]] 的值被 agent 集群中的任一 agent 观察到，它们就不可更改。
[[IsLockFree1]] 与 [[IsLockFree2]] 的值不一定由硬件决定，也可反映可能随时间与实现而变的实现选择。
没有 [[IsLockFree4]] 字段：4 字节原子操作总是无锁。
实际上，如果某原子操作用任何形式的锁实现，该操作就不是无锁的。无锁不意味着无等待（wait-free）：完成一个无锁原子操作需要的机器步骤数没有上界。
某大小 n 的原子访问无锁并不意味着对同大小 n 的非原子访问具备（感知的）原子性；具体来说，非原子访问仍可能分解为多个独立的内存访问。详见
agent 是规范机制，不需对应 ECMAScript 实现中的实际产物。
9.6.1 AgentSignifier ( )
The abstract operation AgentSignifier takes no arguments and returns an agent signifier. It performs the following steps when called:
- 令 AR 为包围 agent 的
Agent Record 。 - 返回 AR.[[Signifier]]。
9.6.2 AgentCanSuspend ( )
The abstract operation AgentCanSuspend takes no arguments and returns a Boolean. It performs the following steps when called:
- 令 AR 为包围 agent 的
Agent Record 。 - 返回 AR.[[CanBlock]]。
在某些环境中，对某个 agent 来说暂停可能并不合适。例如，在 Web 浏览器环境中，可能不允许暂停文档的主事件处理线程，但允许 worker 的事件处理线程暂停。
9.6.3 IncrementModuleAsyncEvaluationCount ( )
The abstract operation IncrementModuleAsyncEvaluationCount takes no arguments and returns an
- 令 AR 为包围 agent 的
Agent Record 。 - 令 count 为 AR.[[ModuleAsyncEvaluationCount]]。
- 设 AR.[[ModuleAsyncEvaluationCount]] 为 count + 1。
- 返回 count。
该值仅用于追踪待定模块之间的相对求值顺序。实现可在没有待定模块时不可观察地将 [[ModuleAsyncEvaluationCount]] 重置为 0。
9.7 Agent Clusters（代理集群）
agent cluster（代理集群） 是能够通过操作共享内存进行通信的最大化的一组 agent。
不同 agent 内的程序可能通过未指明的方式共享内存。至少，共享内存可包含 SharedArrayBuffer 的底层存储。
可能存在只能通过消息传递通信而不能共享内存的 agent；它们永远不在同一个 agent cluster 中。
每个 agent 恰好属于一个 agent cluster。
集群中的 agent 不必在某个时间点全部“活着”。如果 agent A 创建了 agent B，随后 A 终止，而 B 又创建 agent C，如果 A 可以与 B 共享某些内存且 B 可以与 C 共享某些内存，则三个 agent 仍在同一集群。
同一集群内所有 agent 在其各自
若集群中不同 agent 的 [[LittleEndian]] 值不同，就难以在多字节数据上使用共享内存。
同一集群内所有 agent 在其 [[IsLockFree1]] 字段上必须具有相同值；[[IsLockFree2]] 字段同理。
同一集群内所有 agent 在其 [[Signifier]] 字段上必须具有不同值。
嵌入环境可在 agent 不知情或不配合的情况下停用（停止前向进展）或激活（恢复前向进展）一个 agent。若这样做，不得使集群中某些 agent 长期保持激活而另一些被无限期停用。
上述限制的目的是避免某个 agent 因另一个被停用的 agent 而死锁或饥饿。例如，若一个生命周期独立于任何窗口文档的 HTML shared worker 被允许与这样一个独立文档的 dedicated worker 共享内存，而该文档及其 dedicated worker 被停用时 dedicated worker 持有某个锁（如文档被推入窗口历史），随后 shared worker 尝试获取该锁，那么 shared worker 会被阻塞直到 dedicated worker 被重新激活（如果会的话）。同时其它试图从其它窗口访问该 shared worker 的 worker 会饥饿。
该限制意味着无法在不属于同一“暂停/唤醒”集体的 agent 之间共享内存。
嵌入环境可以在未提前通知或未获得集群内其它 agent 协作的情况下终止某个 agent。若某 agent 的终止不是其自身或集群内其它 agent 的程序化行为，而是由集群外部因素导致，则嵌入环境必须在两个策略中择一：要么终止该集群所有 agent，要么提供可靠的 API 让集群内 agent 协调，以便至少一个仍存活的成员能够检测到该终止，并且终止数据中包含足以标识被终止 agent 的信息。
此类终止的例子包括：操作系统或用户终止在独立进程中运行的 agent；当按 agent 资源统计显示某 agent 失控时，嵌入环境终止与其它 agent 在同一进程内运行的该 agent。
下列每个规范值以及从它们可传递抵达的值，恰好属于一个 agent cluster：
在集群中任何 agent 求值任意 ECMAScript 代码之前，集群中所有 agent 的
同一 agent cluster 中所有 agent 在其
agent cluster 是规范机制，不需对应 ECMAScript 实现中的实际产物。
9.8 Forward Progress（前向进展）
某 agent 取得前向进展 (make forward progress) 指其执行根据本规范的一次求值步骤。
当一个 agent 的运行执行上下文同步且无限期地等待外部事件时，该 agent 变为 阻塞 (blocked)。只有
实现必须确保：
- 每个拥有专用执行线程且未阻塞的 agent 最终取得前向进展
- 共享一个执行线程的一组 agent 中，总有一个 agent 最终取得前向进展
- 一个 agent 不得导致另一个 agent 阻塞，除非通过提供阻塞的显式 API
这一点与
9.9 WeakRef 与 FinalizationRegistry 目标的处理模型
9.9.1 目标 (Objectives)
本规范不保证任何对象或 symbol 会被垃圾回收。非存活的对象或 symbol 可能在很长时间后才被释放，甚至永不释放。基于此，本规范在描述被垃圾回收触发的行为时使用 “may”。
-
当调用
WeakRef.prototype.deref时，该引用对象（若未返回undefined ）被保持存活，以便后续同步访问也返回相同值。该列表在使用ClearKeptObjects 抽象操作 完成同步工作后被重置。 -
当某个已注册到
FinalizationRegistry 的对象或 symbol 变得不可达后，在同步 ECMAScript 执行完成后，最终可能调用该FinalizationRegistry 的清理回调。FinalizationRegistry 的清理通过CleanupFinalizationRegistry 抽象操作 执行。
上述两个动作（
一些 ECMAScript 实现包含在后台（包括 ECMAScript 空闲时）运行的垃圾回收器。让
9.9.2 存活性 (Liveness)
对于一组对象和/或 symbol S，相对于 S 的一次 假设的 WeakRef-oblivious（弱引用无感） 执行是指：任何将其 referent 属于 S 的
在求值任意时刻，若下列任一条件成立，则对象和/或 symbol 集合 S 被视为 live（存活）：
-
S 中任一元素包含于任一 agent 的 [[KeptAlive]]
List 中。 -
存在相对于 S 的某个未来合法的假设
WeakRef -oblivious 执行，在其中观察到 S 中任一值的身份。
对象或 symbol 出现在某字段、内部槽或属性中并不意味着该值存活。例如若该值从未被返回给程序，则不可被观察。
这适用于 WeakMap 的键、WeakSet 的成员，以及
上述定义意味着：若 WeakMap 中的某键不存活，则其对应的值也不必定存活。
9.9.3 执行 (Execution)
在任意时刻，若一组对象和/或 symbol S 不存活，ECMAScript 实现可原子地执行以下步骤：
- 对于 S 的每个元素 value，执行
- 对每个
WeakRef ref（ref.[[WeakRefTarget]] 为 value），执行- 设 ref.[[WeakRefTarget]] 为
empty 。
- 设 ref.[[WeakRefTarget]] 为
- 对每个
FinalizationRegistry fg（fg.[[Cells]] 含有记录 cell 且 cell.[[WeakRefTarget]] 为 value），执行- 设 cell.[[WeakRefTarget]] 为
empty 。 - 可选：执行
HostEnqueueFinalizationRegistryCleanupJob (fg)。
- 设 cell.[[WeakRefTarget]] 为
- 对每个 WeakMap map（map.[[WeakMapData]] 含有记录 r 且 r.[[Key]] 为 value），执行
- 设 r.[[Key]] 为
empty 。 - 设 r.[[Value]] 为
empty 。
- 设 r.[[Key]] 为
- 对每个 WeakSet set（set.[[WeakSetData]] 含有 value），执行
- 将 set.[[WeakSetData]] 中值为 value 的元素替换为值为
empty 的元素。
- 将 set.[[WeakSetData]] 中值为 value 的元素替换为值为
- 对每个
结合存活性的定义，本条款规定了实现可针对
可能存在在不观察对象身份的情况下访问对象的情形。诸如死变量消除、对非逃逸对象属性的标量替换等优化在对象身份未被观察时允许进行。因此，这些优化可在可观察范围内清空指向此类对象的
另一方面，若对象身份可被观察且该对象位于某
由于调用
9.9.4 宿主挂钩 (Host Hooks)
9.9.4.1 HostEnqueueFinalizationRegistryCleanupJob ( finalizationRegistry )
The host-defined abstract operation HostEnqueueFinalizationRegistryCleanupJob takes argument finalizationRegistry (a
令 cleanupJob 为一个无参数的新 Job 抽象闭包，它捕获 finalizationRegistry 并在被调用时执行以下步骤：
- 令 cleanupResult 为
Completion (CleanupFinalizationRegistry (finalizationRegistry))。 - 若 cleanupResult 为
异常完成 ，执行任意宿主 定义步骤以报告错误。 - 返回
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]] 含有某记录 cell 且 cell.[[WeakRefTarget]] 为
empty 时，实现可以执行以下步骤：- 任选一个这样的 cell。
- 从 finalizationRegistry.[[Cells]] 中移除 cell。
- 执行 ?
HostCallJobCallback (callback,undefined , « cell.[[HeldValue]] »)。
- 返回
unused 。
9.13 CanBeHeldWeakly ( v )
The abstract operation CanBeHeldWeakly takes argument v (an ECMAScript language value) and returns a Boolean. 当且仅当 v 适合作为弱引用使用时返回
- 若 v 是一个 Object，返回
true 。 - 若 v 是一个 Symbol 且
KeyForSymbol (v) 为undefined ，返回true 。 - 返回
false 。
没有
10 普通与特异（Exotic）对象的行为 (Ordinary and Exotic Objects Behaviours)
10.1 普通对象的内部方法与内部槽 (Ordinary Object Internal Methods and Internal Slots)
所有
每个
在下面的算法描述中，假设 O 是一个
每个
10.1.1 [[GetPrototypeOf]] ( )
The [[GetPrototypeOf]] internal method of 一个
- 返回
OrdinaryGetPrototypeOf (O)。
10.1.1.1 OrdinaryGetPrototypeOf ( O )
The abstract operation OrdinaryGetPrototypeOf takes argument O (an Object) and returns an Object or
- 返回 O.[[Prototype]]。
10.1.2 [[SetPrototypeOf]] ( V )
The [[SetPrototypeOf]] internal method of 一个
- 返回
OrdinarySetPrototypeOf (O, V)。
10.1.2.1 OrdinarySetPrototypeOf ( O, V )
The abstract operation OrdinarySetPrototypeOf takes arguments O (an Object) and V (an Object or
- 令 current 为 O.[[Prototype]]。
- 若
SameValue (V, current) 为true ，返回true 。 - 令 extensible 为 O.[[Extensible]]。
- 若 extensible 为
false ，返回false 。 - 令 p 为 V。
- 令 done 为
false 。 - 当 done 为
false 重复， - 设 O.[[Prototype]] 为 V。
- 返回
true 。
10.1.3 [[IsExtensible]] ( )
The [[IsExtensible]] internal method of 一个
- 返回
OrdinaryIsExtensible (O)。
10.1.3.1 OrdinaryIsExtensible ( O )
The abstract operation OrdinaryIsExtensible takes argument O (an Object) and returns a Boolean. It performs the following steps when called:
- 返回 O.[[Extensible]]。
10.1.4 [[PreventExtensions]] ( )
The [[PreventExtensions]] internal method of 一个
- 返回
OrdinaryPreventExtensions (O)。
10.1.4.1 OrdinaryPreventExtensions ( O )
The abstract operation OrdinaryPreventExtensions takes argument O (an Object) and returns
- 将 O.[[Extensible]] 设为
false 。 - 返回
true 。
10.1.5 [[GetOwnProperty]] ( P )
The [[GetOwnProperty]] internal method of 一个
- 返回
OrdinaryGetOwnProperty (O, P)。
10.1.5.1 OrdinaryGetOwnProperty ( O, P )
The abstract operation OrdinaryGetOwnProperty takes arguments O (an Object) and P (a property key) and returns a
- 若 O 不存在键为 P 的自身属性，返回
undefined 。 - 令 D 为一个新建的无字段
Property Descriptor 。 - 令 X 为 O 的键为 P 的自身属性。
- 若 X 是
数据属性 ，则- 设 D.[[Value]] 为 X 的 [[Value]] 特性的值。
- 设 D.[[Writable]] 为 X 的 [[Writable]] 特性的值。
- 否则，
- 断言：X 是
访问器属性 。 - 设 D.[[Get]] 为 X 的 [[Get]] 特性的值。
- 设 D.[[Set]] 为 X 的 [[Set]] 特性的值。
- 断言：X 是
- 设 D.[[Enumerable]] 为 X 的 [[Enumerable]] 特性的值。
- 设 D.[[Configurable]] 为 X 的 [[Configurable]] 特性的值。
- 返回 D。
10.1.6 [[DefineOwnProperty]] ( P, Desc )
The [[DefineOwnProperty]] internal method of 一个
- 返回 ?
OrdinaryDefineOwnProperty (O, P, Desc)。
10.1.6.1 OrdinaryDefineOwnProperty ( O, P, Desc )
The abstract operation OrdinaryDefineOwnProperty takes arguments O (an Object), P (a property key), and Desc (a
- 令 current 为 ? O.[[GetOwnProperty]](P)。
- 令 extensible 为 ?
IsExtensible (O)。 - 返回
ValidateAndApplyPropertyDescriptor (O, P, extensible, Desc, current)。
10.1.6.2 IsCompatiblePropertyDescriptor ( Extensible, Desc, Current )
The abstract operation IsCompatiblePropertyDescriptor takes arguments Extensible (a Boolean), Desc (a
- 返回
ValidateAndApplyPropertyDescriptor (undefined ,"" , Extensible, Desc, Current)。
10.1.6.3 ValidateAndApplyPropertyDescriptor ( O, P, extensible, Desc, current )
The abstract operation ValidateAndApplyPropertyDescriptor takes arguments O (an Object or
- 断言：P 是一个
属性键 。 - 若 current 为
undefined ，则- 若 extensible 为
false ，返回false 。 - 若 O 为
undefined ，返回true 。 - 若
IsAccessorDescriptor (Desc) 为true ，则 - 否则，
- 返回
true 。
- 若 extensible 为
- 断言：current 为一个
完全填充的 Property Descriptor 。 - 若 Desc 不含任何字段，返回
true 。 - 若 current.[[Configurable]] 为
false ，则- 若 Desc 含 [[Configurable]] 且 Desc.[[Configurable]] 为
true ，返回false 。 - 若 Desc 含 [[Enumerable]] 且 Desc.[[Enumerable]] 不等于 current.[[Enumerable]]，返回
false 。 - 若
IsGenericDescriptor (Desc) 为false 且IsAccessorDescriptor (Desc) 不等于IsAccessorDescriptor (current)，返回false 。 - 若
IsAccessorDescriptor (current) 为true ，则 - 否则若 current.[[Writable]] 为
false ，则
- 若 Desc 含 [[Configurable]] 且 Desc.[[Configurable]] 为
- 若 O 不为
undefined ，则- 若
IsDataDescriptor (current) 为true 且IsAccessorDescriptor (Desc) 为true ，则- 若 Desc 含 [[Configurable]]，令 configurable 为 Desc.[[Configurable]]；否则令 configurable 为 current.[[Configurable]]。
- 若 Desc 含 [[Enumerable]]，令 enumerable 为 Desc.[[Enumerable]]；否则令 enumerable 为 current.[[Enumerable]]。
- 用一个
访问器属性 替换对象 O 上名为 P 的属性，其 [[Configurable]]、[[Enumerable]] 分别设为 configurable、enumerable，其 [[Get]]、[[Set]] 特性若 Desc 含该字段则取其值，否则取该特性的默认值 。
- 否则若
IsAccessorDescriptor (current) 为true 且IsDataDescriptor (Desc) 为true ，则- 若 Desc 含 [[Configurable]]，令 configurable 为 Desc.[[Configurable]]；否则令 configurable 为 current.[[Configurable]]。
- 若 Desc 含 [[Enumerable]]，令 enumerable 为 Desc.[[Enumerable]]；否则令 enumerable 为 current.[[Enumerable]]。
- 用一个
数据属性 替换对象 O 上名为 P 的属性，其 [[Configurable]]、[[Enumerable]] 分别设为 configurable、enumerable，其 [[Value]]、[[Writable]] 特性若 Desc 含该字段则取其值，否则取该特性的默认值 。
- 否则，
- 对 Desc 的每个字段，将对象 O 上名为 P 的属性对应特性设为该字段的值。
- 若
- 返回
true 。
10.1.7 [[HasProperty]] ( P )
The [[HasProperty]] internal method of 一个
- 返回 ?
OrdinaryHasProperty (O, P)。
10.1.7.1 OrdinaryHasProperty ( O, P )
The abstract operation OrdinaryHasProperty takes arguments O (an Object) and P (a property key) and returns either a normal completion containing a Boolean or a throw completion. It performs the following steps when called:
- 令 hasOwn 为 ? O.[[GetOwnProperty]](P)。
- 若 hasOwn 不为
undefined ，返回true 。 - 令 parent 为 ? O.[[GetPrototypeOf]]()。
- 若 parent 不为
null ，则- 返回 ? parent.[[HasProperty]](P)。
- 返回
false 。
10.1.8 [[Get]] ( P, Receiver )
The [[Get]] internal method of 一个
- 返回 ?
OrdinaryGet (O, P, Receiver)。
10.1.8.1 OrdinaryGet ( O, P, Receiver )
The abstract operation OrdinaryGet takes arguments O (an Object), P (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:
- 令 desc 为 ? O.[[GetOwnProperty]](P)。
- 若 desc 为
undefined ，则- 令 parent 为 ? O.[[GetPrototypeOf]]()。
- 若 parent 为
null ，返回undefined 。 - 返回 ? parent.[[Get]](P, Receiver)。
- 若
IsDataDescriptor (desc) 为true ，返回 desc.[[Value]]。 - 断言：
IsAccessorDescriptor (desc) 为true 。 - 令 getter 为 desc.[[Get]]。
- 若 getter 为
undefined ，返回undefined 。 - 返回 ? Call(getter, Receiver)。
10.1.9 [[Set]] ( P, V, Receiver )
The [[Set]] internal method of 一个
- 返回 ?
OrdinarySet (O, P, V, Receiver)。
10.1.9.1 OrdinarySet ( O, P, V, Receiver )
The abstract operation OrdinarySet takes arguments O (an Object), P (a property key), V (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 为 ? O.[[GetOwnProperty]](P)。
- 返回 ?
OrdinarySetWithOwnDescriptor (O, P, V, Receiver, ownDesc)。
10.1.9.2 OrdinarySetWithOwnDescriptor ( O, P, V, Receiver, ownDesc )
The abstract operation OrdinarySetWithOwnDescriptor takes arguments O (an Object), P (a property key), V (an ECMAScript language value), Receiver (an ECMAScript language value), and ownDesc (a
- 若 ownDesc 为
undefined ，则- 令 parent 为 ? O.[[GetPrototypeOf]]()。
- 若 parent 不为
null ，则- 返回 ? parent.[[Set]](P, V, Receiver)。
- 否则，
- 将 ownDesc 设为 PropertyDescriptor { [[Value]]:
undefined , [[Writable]]:true , [[Enumerable]]:true , [[Configurable]]:true }。
- 将 ownDesc 设为 PropertyDescriptor { [[Value]]:
- 若
IsDataDescriptor (ownDesc) 为true ，则- 若 ownDesc.[[Writable]] 为
false ，返回false 。 - 若 Receiver
不是 Object ，返回false 。 - 令 existingDescriptor 为 ? Receiver.[[GetOwnProperty]](P)。
- 若 existingDescriptor 不为
undefined ，则- 若
IsAccessorDescriptor (existingDescriptor) 为true ，返回false 。 - 若 existingDescriptor.[[Writable]] 为
false ，返回false 。 - 令 valueDesc 为 PropertyDescriptor { [[Value]]: V }。
- 返回 ? Receiver.[[DefineOwnProperty]](P, valueDesc)。
- 若
- 否则，
- 断言：Receiver 目前没有属性 P。
- 返回 ?
CreateDataProperty (Receiver, P, V)。
- 若 ownDesc.[[Writable]] 为
- 断言：
IsAccessorDescriptor (ownDesc) 为true 。 - 令 setter 为 ownDesc.[[Set]]。
- 若 setter 为
undefined ，返回false 。 - 执行 ? Call(setter, Receiver, « V »)。
- 返回
true 。
10.1.10 [[Delete]] ( P )
The [[Delete]] internal method of 一个
- 返回 ?
OrdinaryDelete (O, P)。
10.1.10.1 OrdinaryDelete ( O, P )
The abstract operation OrdinaryDelete takes arguments O (an Object) and P (a property key) and returns either a normal completion containing a Boolean or a throw completion. It performs the following steps when called:
- 令 desc 为 ? O.[[GetOwnProperty]](P)。
- 若 desc 为
undefined ，返回true 。 - 若 desc.[[Configurable]] 为
true ，则- 从 O 中移除名为 P 的自身属性。
- 返回
true 。
- 返回
false 。
10.1.11 [[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of 一个
- 返回
OrdinaryOwnPropertyKeys (O)。
10.1.11.1 OrdinaryOwnPropertyKeys ( O )
The abstract operation OrdinaryOwnPropertyKeys takes argument O (an Object) and returns a
10.1.12 OrdinaryObjectCreate ( proto [ , additionalInternalSlotsList ] )
The abstract operation OrdinaryObjectCreate takes argument proto (an Object or
- 令 internalSlotsList 为 « [[Prototype]], [[Extensible]] »。
- 若 additionalInternalSlotsList 存在，将 internalSlotsList 设为 internalSlotsList 与 additionalInternalSlotsList 的列表连接。
- 令 O 为
MakeBasicObject (internalSlotsList)。 - 将 O.[[Prototype]] 设为 proto。
- 返回 O。
尽管 OrdinaryObjectCreate 除调用
10.1.13 OrdinaryCreateFromConstructor ( constructor, intrinsicDefaultProto [ , internalSlotsList ] )
The abstract operation OrdinaryCreateFromConstructor takes arguments constructor (a function object) and intrinsicDefaultProto (a String) and optional argument internalSlotsList (a
- 断言：intrinsicDefaultProto 是本规范对某内在对象的名称；对应对象必须是用作 [[Prototype]] 值的内在对象。
- 令 proto 为 ?
GetPrototypeFromConstructor (constructor, intrinsicDefaultProto)。 - 若 internalSlotsList 存在，令 slotsList 为 internalSlotsList。
- 否则，令 slotsList 为一个新的空
List 。 - 返回
OrdinaryObjectCreate (proto, slotsList)。
10.1.14 GetPrototypeFromConstructor ( constructor, intrinsicDefaultProto )
The abstract operation GetPrototypeFromConstructor takes arguments constructor (a function object) and intrinsicDefaultProto (a String) and returns either a normal completion containing an Object or a throw completion. 决定与特定
- 断言：intrinsicDefaultProto 是本规范对某内在对象的名称；对应对象必须是用作对象 [[Prototype]] 值的内在对象。
- 令 proto 为 ?
Get (constructor,"prototype" )。 - 若 proto
不是 Object ，则- 令 realm 为 ?
GetFunctionRealm (constructor)。 - 将 proto 设为 realm 中名为 intrinsicDefaultProto 的内在对象。
- 令 realm 为 ?
- 返回 proto。
若 constructor 未提供 [[Prototype]] 值，则使用的默认值取自 constructor 函数所属的
10.1.15 RequireInternalSlot ( O, internalSlot )
The abstract operation RequireInternalSlot takes arguments O (an ECMAScript language value) and internalSlot (an internal slot name) and returns either a normal completion containing
- 若 O
不是 Object ，抛出TypeError 异常。 - 若 O 不具有内部槽 internalSlot，抛出
TypeError 异常。 - 返回
unused 。
10.2 ECMAScript 函数对象 (ECMAScript Function Objects)
ECMAScript
除 [[Extensible]] 与 [[Prototype]] 之外，ECMAScript
| 内部槽 (Internal Slot) | 类型 (Type) | 描述 (Description) |
|---|---|---|
| [[Environment]] |
an |
函数闭包所捕获的 |
| [[PrivateEnvironment]] |
a |
函数闭包所捕获的 |
| [[FormalParameters]] | a Parse Node |
定义函数形式参数列表的源文本根 |
| [[ECMAScriptCode]] | a Parse Node |
定义函数函数体的源文本根 |
| [[ConstructorKind]] |
|
指示该函数是否为派生类构造器。 |
| [[Realm]] |
a |
函数被创建时所在的 |
| [[ScriptOrModule]] |
a Script |
函数被创建所在的脚本或模块。 |
| [[ThisMode]] |
|
定义在函数形式参数与函数体内 this 引用如何解释。this 引用词法包围函数的 |
| [[Strict]] | a Boolean |
若该函数为严格函数则为 |
| [[HomeObject]] | an Object |
若函数使用 super，此槽为其 super 属性查找起始的对象（通过该对象的 [[GetPrototypeOf]]）。
|
| [[SourceText]] | a sequence of Unicode code points |
定义该函数的 |
| [[Fields]] |
a |
若该函数是一个 class，则此列表为该类的非静态字段及其初始化器的记录。 |
| [[PrivateMethods]] |
a |
若该函数是一个 class，则此列表表示该类的非静态私有方法与访问器。 |
| [[ClassFieldInitializerName]] |
a String, a Symbol, a |
若函数作为类字段的初始化器创建，则为对该字段进行 NamedEvaluation 所使用的名称；否则为 |
| [[IsClassConstructor]] | a Boolean |
指示该函数是否为类构造器。（若为 |
所有 ECMAScript
10.2.1 [[Call]] ( thisArgument, argumentsList )
The [[Call]] internal method of 一个 ECMAScript
- 令 callerContext 为当前运行执行上下文。
- 令 calleeContext 为
PrepareForOrdinaryCall (F,undefined )。 - 断言：calleeContext 现在是运行执行上下文。
- 若 F.[[IsClassConstructor]] 为
true ，则- 令 error 为一个新创建的
TypeError 对象。 - NOTE: error 在 calleeContext 中、使用 F 关联的
Realm Record 创建。 - 从执行上下文栈移除 calleeContext 并恢复 callerContext 为运行执行上下文。
- 返回
ThrowCompletion (error)。
- 令 error 为一个新创建的
- 执行
OrdinaryCallBindThis (F, calleeContext, thisArgument)。 - 令 result 为
Completion (OrdinaryCallEvaluateBody (F, argumentsList))。 - 从执行上下文栈移除 calleeContext 并恢复 callerContext 为运行执行上下文。
- 若 result 是一个 return completion，返回 result.[[Value]]。
- 断言：result 是一个 throw completion。
- 返回 ? result。
当在步骤
10.2.1.1 PrepareForOrdinaryCall ( F, newTarget )
The abstract operation PrepareForOrdinaryCall takes arguments F (an ECMAScript function object) and newTarget (an Object or
- 令 callerContext 为当前运行执行上下文。
- 令 calleeContext 为一个新的
ECMAScript 代码执行上下文 。 - 将 calleeContext 的 Function 设为 F。
- 令 calleeRealm 为 F.[[Realm]]。
- 将 calleeContext 的
Realm 设为 calleeRealm。 - 将 calleeContext 的 ScriptOrModule 设为 F.[[ScriptOrModule]]。
- 令 localEnv 为
NewFunctionEnvironment (F, newTarget)。 - 将 calleeContext 的 LexicalEnvironment 设为 localEnv。
- 将 calleeContext 的 VariableEnvironment 设为 localEnv。
- 将 calleeContext 的 PrivateEnvironment 设为 F.[[PrivateEnvironment]]。
- 若 callerContext 尚未被挂起，则挂起 callerContext。
- 将 calleeContext 压入执行上下文栈；calleeContext 现在是运行执行上下文。
- NOTE: 之后产生的任何异常对象与 calleeRealm 关联。
- 返回 calleeContext。
10.2.1.2 OrdinaryCallBindThis ( F, calleeContext, thisArgument )
The abstract operation OrdinaryCallBindThis takes arguments F (an ECMAScript function object), calleeContext (an
- 令 thisMode 为 F.[[ThisMode]]。
- 若 thisMode 为
lexical ，返回unused 。 - 令 calleeRealm 为 F.[[Realm]]。
- 令 localEnv 为 calleeContext 的 LexicalEnvironment。
- 若 thisMode 为
strict ，则- 令 thisValue 为 thisArgument。
- 否则，
- 若 thisArgument 是
undefined 或null ，则- 令 globalEnv 为 calleeRealm.[[GlobalEnv]]。
- 断言：globalEnv 是一个
Global Environment Record 。 - 令 thisValue 为 globalEnv.[[GlobalThisValue]]。
- 否则，
- 若 thisArgument 是
- 断言：localEnv 是一个
Function Environment Record 。 - 断言：下一步不会返回一个 abrupt completion，因为 localEnv.[[ThisBindingStatus]] 不是
initialized 。 - 执行 !
BindThisValue (localEnv, thisValue)。 - 返回
unused 。
10.2.1.3 运行时语义：EvaluateBody
The syntax-directed operation
- Return ? EvaluateFunctionBody of
FunctionBody with arguments functionObject and argumentsList.
- Return ? EvaluateConciseBody of
ConciseBody with arguments functionObject and argumentsList.
- Return ? EvaluateGeneratorBody of
GeneratorBody with arguments functionObject and argumentsList.
- Return ? EvaluateAsyncGeneratorBody of
AsyncGeneratorBody with arguments functionObject and argumentsList.
- Return ? EvaluateAsyncFunctionBody of
AsyncFunctionBody with arguments functionObject and argumentsList.
- Return ? EvaluateAsyncConciseBody of
AsyncConciseBody with arguments functionObject and argumentsList.
Assert : argumentsList is empty.Assert : functionObject.[[ClassFieldInitializerName]] is notempty .- If IsAnonymousFunctionDefinition(
AssignmentExpression ) istrue , then- Let value be ? NamedEvaluation of
Initializer with argument functionObject.[[ClassFieldInitializerName]].
- Let value be ? NamedEvaluation of
- Else,
- Let rhs be ? Evaluation of
AssignmentExpression . - Let value be ?
GetValue (rhs).
- Let rhs be ? Evaluation of
- Return
ReturnCompletion (value).
尽管字段初始化器构成了函数边界，调用
Assert : argumentsList is empty.- Return ? EvaluateClassStaticBlockBody of
ClassStaticBlockBody with argument functionObject.
10.2.1.4 OrdinaryCallEvaluateBody ( F, argumentsList )
The abstract operation OrdinaryCallEvaluateBody takes arguments F (an ECMAScript function object) and argumentsList (a
- Return ? EvaluateBody of F.[[ECMAScriptCode]] with arguments F and argumentsList.
10.2.2 [[Construct]] ( argumentsList, newTarget )
The [[Construct]] internal method of 一个 ECMAScript
- 令 callerContext 为当前运行执行上下文。
- 令 kind 为 F.[[ConstructorKind]]。
- 若 kind 为
base ，则- 令 thisArgument 为 ?
OrdinaryCreateFromConstructor (newTarget,"%Object.prototype%" )。
- 令 thisArgument 为 ?
- 令 calleeContext 为
PrepareForOrdinaryCall (F, newTarget)。 - 断言：calleeContext 现在是运行执行上下文。
- 若 kind 为
base ，则- 执行
OrdinaryCallBindThis (F, calleeContext, thisArgument)。 - 令 initializeResult 为
Completion (InitializeInstanceElements (thisArgument, F))。 - 若 initializeResult 是一个 abrupt completion，则
- 从执行上下文栈移除 calleeContext 并恢复 callerContext 为运行执行上下文。
- 返回 ? initializeResult。
- 执行
- 令 constructorEnv 为 calleeContext 的 LexicalEnvironment。
- 令 result 为
Completion (OrdinaryCallEvaluateBody (F, argumentsList))。 - 从执行上下文栈移除 calleeContext 并恢复 callerContext 为运行执行上下文。
- 若 result 是一个 throw completion，则
- 返回 ? result。
- 断言：result 是一个 return completion。
- 若 result.[[Value]] 是一个 Object，返回 result.[[Value]]。
- 若 kind 为
base ，返回 thisArgument。 - 若 result.[[Value]] 不是
undefined ，抛出TypeError 异常。 - 令 thisBinding 为 ? constructorEnv.GetThisBinding()。
- 断言：thisBinding 是一个 Object。
- 返回 thisBinding。
10.2.3 OrdinaryFunctionCreate ( functionPrototype, sourceText, ParameterList, Body, thisMode, env, privateEnv )
The abstract operation OrdinaryFunctionCreate takes arguments functionPrototype (an Object), sourceText (a sequence of Unicode code points), ParameterList (a Parse Node), Body (a Parse Node), thisMode (
- 令 internalSlotsList 为
Table 28 中列出的内部槽。 - 令 F 为
OrdinaryObjectCreate (functionPrototype, internalSlotsList)。 - 将 F.[[Call]] 设为
10.2.1 中指定的定义。 - 将 F.[[SourceText]] 设为 sourceText。
- 将 F.[[FormalParameters]] 设为 ParameterList。
- 将 F.[[ECMAScriptCode]] 设为 Body。
- 令 Strict 为 IsStrict(Body)。
- 将 F.[[Strict]] 设为 Strict。
- 若 thisMode 为
lexical-this ，将 F.[[ThisMode]] 设为lexical 。 - 否则若 Strict 为
true ，将 F.[[ThisMode]] 设为strict 。 - 否则，将 F.[[ThisMode]] 设为
global 。 - 将 F.[[IsClassConstructor]] 设为
false 。 - 将 F.[[Environment]] 设为 env。
- 将 F.[[PrivateEnvironment]] 设为 privateEnv。
- 将 F.[[ScriptOrModule]] 设为
GetActiveScriptOrModule ()。 - 将 F.[[Realm]] 设为
当前 Realm Record 。 - 将 F.[[HomeObject]] 设为
undefined 。 - 将 F.[[Fields]] 设为一个新的空
List 。 - 将 F.[[PrivateMethods]] 设为一个新的空
List 。 - 将 F.[[ClassFieldInitializerName]] 设为
empty 。 - 令 len 为 ParameterList 的 ExpectedArgumentCount。
- 执行
SetFunctionLength (F, len)。 - 返回 F。
10.2.4 AddRestrictedFunctionProperties ( F, realm )
The abstract operation AddRestrictedFunctionProperties takes arguments F (a function object) and realm (a
- 断言：realm.[[Intrinsics]].[[
%ThrowTypeError% ]] 存在并已初始化。 - 令 thrower 为 realm.[[Intrinsics]].[[
%ThrowTypeError% ]]。 - 执行 !
DefinePropertyOrThrow (F,"caller" , PropertyDescriptor { [[Get]]: thrower, [[Set]]: thrower, [[Enumerable]]:false , [[Configurable]]:true })。 - 执行 !
DefinePropertyOrThrow (F,"arguments" , PropertyDescriptor { [[Get]]: thrower, [[Set]]: thrower, [[Enumerable]]:false , [[Configurable]]:true })。 - 返回
unused 。
10.2.4.1 %ThrowTypeError% ( )
该函数是 %ThrowTypeError% 内在对象。
它是一个匿名内置
当被调用时执行以下步骤：
- 抛出
TypeError 异常。
此函数的 [[Extensible]] 内部槽的值为
该函数的
该函数的
10.2.5 MakeConstructor ( F [ , writablePrototype [ , prototype ] ] )
The abstract operation MakeConstructor takes argument F (an ECMAScript function object or a built-in function object) and optional arguments writablePrototype (a Boolean) and prototype (an Object) and returns
- 若 F 是 ECMAScript
函数对象 ，则- 断言：
IsConstructor (F) 为false 。 - 断言：F 是一个可扩展对象且无
"prototype" 自身属性。 - 将 F.[[Construct]] 设为
10.2.2 中指定的定义。
- 断言：
- 否则，
- 将 F.[[Construct]] 设为
10.3.2 中指定的定义。
- 将 F.[[Construct]] 设为
- 将 F.[[ConstructorKind]] 设为
base 。 - 若未提供 writablePrototype，将 writablePrototype 设为
true 。 - 若未提供 prototype，则
- 将 prototype 设为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 !
DefinePropertyOrThrow (prototype,"constructor" , PropertyDescriptor { [[Value]]: F, [[Writable]]: writablePrototype, [[Enumerable]]:false , [[Configurable]]:true })。
- 将 prototype 设为
- 执行 !
DefinePropertyOrThrow (F,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]: writablePrototype, [[Enumerable]]:false , [[Configurable]]:false })。 - 返回
unused 。
10.2.6 MakeClassConstructor ( F )
The abstract operation MakeClassConstructor takes argument F (an ECMAScript function object) and returns
- 断言：F.[[IsClassConstructor]] 为
false 。 - 将 F.[[IsClassConstructor]] 设为
true 。 - 返回
unused 。
10.2.7 MakeMethod ( F, homeObject )
The abstract operation MakeMethod takes arguments F (an ECMAScript function object) and homeObject (an Object) and returns
- 断言：homeObject 是一个
普通对象 。 - 将 F.[[HomeObject]] 设为 homeObject。
- 返回
unused 。
10.2.8 DefineMethodProperty ( homeObject, key, closure, enumerable )
The abstract operation DefineMethodProperty takes arguments homeObject (an Object), key (a property key or
- 断言：homeObject 是一个普通、可扩展对象。
- 若 key 是一个
Private Name ，则- 返回
PrivateElement { [[Key]]: key, [[Kind]]:method , [[Value]]: closure }。
- 返回
- 否则，
- 令 desc 为 PropertyDescriptor { [[Value]]: closure, [[Writable]]:
true , [[Enumerable]]: enumerable, [[Configurable]]:true }。 - 执行 ?
DefinePropertyOrThrow (homeObject, key, desc)。 - NOTE:
DefinePropertyOrThrow 只有在尝试定义 key 为"prototype" 的类静态方法时才会返回一个 abrupt completion。 - 返回
unused 。
- 令 desc 为 PropertyDescriptor { [[Value]]: closure, [[Writable]]:
10.2.9 SetFunctionName ( F, name [ , prefix ] )
The abstract operation SetFunctionName takes arguments F (a function object) and name (a property key or
- 断言：F 是一个可扩展对象，且没有
"name" 自身属性。 - 若 name 是一个 Symbol，则
- 令 description 为 name.[[Description]]。
- 若 description 为
undefined ，将 name 设为空字符串。 - 否则，将 name 设为
"[" 、description、" ]" 的字符串连接。
- 否则若 name 是一个
Private Name ，则- 将 name 设为 name.[[Description]]。
- 若 F 具有 [[InitialName]] 内部槽，则
- 将 F.[[InitialName]] 设为 name。
- 若提供了 prefix，则
- 将 name 设为 prefix、代码单元 0x0020 (SPACE)、name 的字符串连接。
- 若 F 具有 [[InitialName]] 内部槽，则
- NOTE: 下述步骤中的选择在本
抽象操作 每次执行时独立决定。 - 可选地，将 F.[[InitialName]] 设为 name。
- NOTE: 下述步骤中的选择在本
- 执行 !
DefinePropertyOrThrow (F,"name" , PropertyDescriptor { [[Value]]: name, [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:true })。 - 返回
unused 。
10.2.10 SetFunctionLength ( F, length )
The abstract operation SetFunctionLength takes arguments F (a function object) and length (a non-negative
- 断言：F 是一个可扩展对象，且没有
"length" 自身属性。 - 执行 !
DefinePropertyOrThrow (F,"length" , PropertyDescriptor { [[Value]]:𝔽 (length), [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:true })。 - 返回
unused 。
10.2.11 FunctionDeclarationInstantiation ( func, argumentsList )
The abstract operation FunctionDeclarationInstantiation takes arguments func (an ECMAScript function object) and argumentsList (a
当为求值一个 ECMAScript 函数建立执行上下文时，会创建一个新的
被调用时执行以下步骤：
- 令 calleeContext 为当前运行执行上下文。
- 令 code 为 func.[[ECMAScriptCode]]。
- 令 strict 为 func.[[Strict]]。
- 令 formals 为 func.[[FormalParameters]]。
- 令 parameterNames 为 formals 的 BoundNames。
- 若 parameterNames 含有任意重复项，令 hasDuplicates 为
true ；否则令其为false 。 - 令 simpleParameterList 为 IsSimpleParameterList of formals。
- 令 hasParameterExpressions 为 ContainsExpression of formals。
- 令 varNames 为 code 的 VarDeclaredNames。
- 令 varDeclarations 为 code 的 VarScopedDeclarations。
- 令 lexicalNames 为 code 的 LexicallyDeclaredNames。
- 令 functionNames 为一个新的空
List 。 - 令 functionsToInitialize 为一个新的空
List 。 - 依逆序遍历 varDeclarations 中每个元素 d，执行
- 若 d 既不是
VariableDeclaration 也不是ForBinding 也不是BindingIdentifier ，则- 断言：d 是
FunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 或AsyncGeneratorDeclaration 之一。 - 令 fn 为 d 的 BoundNames 唯一元素。
- 若 functionNames 不包含 fn，则
- 将 fn 插入 functionNames 首部。
- NOTE: 若同名函数声明出现多次，使用最后一个声明。
- 将 d 插入 functionsToInitialize 首部。
- 断言：d 是
- 若 d 既不是
- 令 argumentsObjectNeeded 为
true 。 - 若 func.[[ThisMode]] 为
lexical ，则- NOTE: 箭头函数永远没有 arguments 对象。
- 将 argumentsObjectNeeded 设为
false 。
- 否则若 parameterNames 包含
"arguments" ，则- 将 argumentsObjectNeeded 设为
false 。
- 将 argumentsObjectNeeded 设为
- 否则若 hasParameterExpressions 为
false ，则- 若 functionNames 包含
"arguments" 或 lexicalNames 包含"arguments" ，则- 将 argumentsObjectNeeded 设为
false 。
- 将 argumentsObjectNeeded 设为
- 若 functionNames 包含
- 若 strict 为
true 或 hasParameterExpressions 为false ，则- NOTE: 参数只需一个
Environment Record ，因为严格模式代码中的eval调用不能创建对外可见的新绑定。 - 令 env 为 calleeContext 的 LexicalEnvironment。
- NOTE: 参数只需一个
- 否则，
- NOTE: 需要单独的
Environment Record 以确保形式参数列表中的直接 eval 创建的绑定不在参数声明的环境内。 - 令 calleeEnv 为 calleeContext 的 LexicalEnvironment。
- 令 env 为
NewDeclarativeEnvironment (calleeEnv)。 - 断言：calleeContext 的 VariableEnvironment 与 calleeEnv 相同。
- 将 calleeContext 的 LexicalEnvironment 设为 env。
- NOTE: 需要单独的
- 对 parameterNames 中每个字符串 paramName，执行
- 令 alreadyDeclared 为 ! env.HasBinding(paramName)。
- NOTE: 早期错误确保重复参数名只可出现在无参数默认值或 rest 参数的非严格函数中。
- 若 alreadyDeclared 为
false ，则- 执行 ! env.CreateMutableBinding(paramName,
false )。 - 若 hasDuplicates 为
true ，则- 执行 ! env.InitializeBinding(paramName,
undefined )。
- 执行 ! env.InitializeBinding(paramName,
- 执行 ! env.CreateMutableBinding(paramName,
- 若 argumentsObjectNeeded 为
true ，则- 若 strict 为
true 或 simpleParameterList 为false ，则- 令 ao 为
CreateUnmappedArgumentsObject (argumentsList)。
- 令 ao 为
- 否则，
- NOTE: 仅对没有 rest 参数、没有任何参数默认值初始化器、且无解构参数的非严格函数提供映射 arguments 对象。
- 令 ao 为
CreateMappedArgumentsObject (func, formals, argumentsList, env)。
- 若 strict 为
true ，则- 执行 ! env.CreateImmutableBinding(
"arguments" ,false )。 - NOTE: 严格模式代码的早期错误阻止对该绑定的赋值，因此其可变性不可观察。
- 执行 ! env.CreateImmutableBinding(
- 否则，
- 执行 ! env.CreateMutableBinding(
"arguments" ,false )。
- 执行 ! env.CreateMutableBinding(
- 执行 ! env.InitializeBinding(
"arguments" , ao)。 - 令 parameterBindings 为 parameterNames 与 «
"arguments" » 的列表连接。
- 若 strict 为
- 否则，
- 令 parameterBindings 为 parameterNames。
- 令 iteratorRecord 为
CreateListIteratorRecord (argumentsList)。 - 若 hasDuplicates 为
true ，则- 令 usedEnv 为
undefined 。
- 令 usedEnv 为
- 否则，
- 令 usedEnv 为 env。
- NOTE: 下列步骤不会返回
ReturnCompletion ，因为在表达式位置唯一产生此类完成的方式是使用YieldExpression ，而其在参数列表中已由15.5.1 与15.6.1 的早期错误规则 禁止。 - 执行 ? IteratorBindingInitialization of formals with arguments iteratorRecord and usedEnv。
- 若 hasParameterExpressions 为
false ，则- NOTE: 参数与顶层 var 只需一个
Environment Record 。 - 令 instantiatedVarNames 为 parameterBindings 的拷贝。
- 对 varNames 中每个元素 n，执行
- 若 instantiatedVarNames 不含 n，则
- 将 n 追加至 instantiatedVarNames。
- 执行 ! env.CreateMutableBinding(n,
false )。 - 执行 ! env.InitializeBinding(n,
undefined )。
- 若 instantiatedVarNames 不含 n，则
- 令 varEnv 为 env。
- NOTE: 参数与顶层 var 只需一个
- 否则，
- NOTE: 需要单独的
Environment Record 以确保形式参数列表中的表达式创建的闭包无法见到函数体内的声明。 - 令 varEnv 为
NewDeclarativeEnvironment (env)。 - 将 calleeContext 的 VariableEnvironment 设为 varEnv。
- 令 instantiatedVarNames 为一个新的空
List 。 - 对 varNames 中每个元素 n，执行
- 若 instantiatedVarNames 不含 n，则
- 将 n 追加至 instantiatedVarNames。
- 执行 ! varEnv.CreateMutableBinding(n,
false )。 - 若 parameterBindings 不含 n，或 functionNames 含 n，则
- 令 initialValue 为
undefined 。
- 令 initialValue 为
- 否则，
- 令 initialValue 为 ! env.GetBindingValue(n,
false )。
- 令 initialValue 为 ! env.GetBindingValue(n,
- 执行 ! varEnv.InitializeBinding(n, initialValue)。
- NOTE: 与形式参数同名的 var 最初具有与对应已初始化参数相同的值。
- 若 instantiatedVarNames 不含 n，则
- NOTE: 需要单独的
- 若 strict 为
true ，则- 令 lexEnv 为 varEnv。
- 否则，
- Normative Optional若
宿主 是 Web 浏览器或以其它方式支持块级函数声明 Web 历史兼容语义 ，则- 对任意
Block 、CaseClause 、DefaultClause x 的StatementList 中直接包含，且 code Contains x 为true 的每个FunctionDeclaration f，执行- 令 F 为 f 的
BindingIdentifier 的 StringValue。 - 若用以 F 为
BindingIdentifier 的VariableStatement 替换该FunctionDeclaration f 不会为 func 产生早期错误，且 parameterNames 不含 F，则- NOTE: 仅当 F 既不是 VarDeclaredName、也不是形式参数名、也不是另一个
FunctionDeclaration 时才在此实例化 F 的 var 绑定。 - 若 instantiatedVarNames 不含 F 且 F 不是
"arguments" ，则- 执行 ! varEnv.CreateMutableBinding(F,
false )。 - 执行 ! varEnv.InitializeBinding(F,
undefined )。 - 将 F 追加至 instantiatedVarNames。
- 执行 ! varEnv.CreateMutableBinding(F,
- 当
FunctionDeclaration f 被求值时，用以下步骤取代15.2.6 中的FunctionDeclaration Evaluation 算法：- 令 fEnv 为当前运行执行上下文的 VariableEnvironment。
- 令 bEnv 为当前运行执行上下文的 LexicalEnvironment。
- 令 fObj 为 ! bEnv.GetBindingValue(F,
false )。 - 执行 ! fEnv.SetMutableBinding(F, fObj,
false )。 - 返回
unused 。
- NOTE: 仅当 F 既不是 VarDeclaredName、也不是形式参数名、也不是另一个
- 令 F 为 f 的
- 对任意
- 令 lexEnv 为
NewDeclarativeEnvironment (varEnv)。 - NOTE: 非严格函数为顶层词法声明使用一个单独的
Environment Record ，以便直接 eval 能确定 eval 代码引入的 var 作用域声明是否与预先存在的顶层词法作用域声明冲突。严格函数不需要此步骤，因为严格直接 eval 总是将所有声明放入新的Environment Record 。
- 将 calleeContext 的 LexicalEnvironment 设为 lexEnv。
- 令 lexDeclarations 为 code 的 LexicallyScopedDeclarations。
- 对 lexDeclarations 中每个元素 d，执行
- NOTE: 词法声明的名字不可能与函数/生成器声明、形式参数或 var 名相同。词法声明的名字在此仅被实例化但未初始化。
- 对 d 的 BoundNames 中每个元素 dn，执行
- 若 IsConstantDeclaration of d 为
true ，则- 执行 ! lexEnv.CreateImmutableBinding(dn,
true )。
- 执行 ! lexEnv.CreateImmutableBinding(dn,
- 否则，
- 执行 ! lexEnv.CreateMutableBinding(dn,
false )。
- 执行 ! lexEnv.CreateMutableBinding(dn,
- 若 IsConstantDeclaration of d 为
- 令 privateEnv 为 calleeContext 的 PrivateEnvironment。
- 对 functionsToInitialize 中每个 Parse Node f，执行
- 令 fn 为 f 的 BoundNames 唯一元素。
- 令 fo 为 InstantiateFunctionObject of f with arguments lexEnv and privateEnv。
- 执行 ! varEnv.SetMutableBinding(fn, fo,
false )。
- 返回
unused 。
10.3 内置函数对象 (Built-in Function Objects)
内置
除每个
- [[Realm]]：一个
Realm Record ，表示创建该函数的realm 。 - [[InitialName]]：一个 String，函数的初始名称，被
20.2.3.5 使用。
内置
内置
仅当被描述为 “constructor” 或本规范中的某个算法显式设置其 [[Construct]] 内部方法时，内置
实现可以提供未在本规范中定义的额外内置
10.3.1 [[Call]] ( thisArgument, argumentsList )
The [[Call]] internal method of 内置
- 返回 ?
BuiltinCallOrConstruct (F, thisArgument, argumentsList,undefined )。
10.3.2 [[Construct]] ( argumentsList, newTarget )
The [[Construct]] internal method of 内置
- 令 result 为 ?
BuiltinCallOrConstruct (F,uninitialized , argumentsList, newTarget)。 - 断言：result 是一个 Object。
- 返回 result。
10.3.3 BuiltinCallOrConstruct ( F, thisArgument, argumentsList, newTarget )
The abstract operation BuiltinCallOrConstruct takes arguments F (a built-in function object), thisArgument (an ECMAScript language value or
- 令 callerContext 为正在运行的执行上下文。
- 若 callerContext 尚未被挂起，则挂起 callerContext。
- 令 calleeContext 为一个新的执行上下文。
- 将 calleeContext 的 Function 设为 F。
- 令 calleeRealm 为 F.[[Realm]]。
- 将 calleeContext 的
Realm 设为 calleeRealm。 - 将 calleeContext 的 ScriptOrModule 设为
null 。 - 执行任何实现定义的、对 calleeContext 必要的初始化。
- 将 calleeContext 压入执行上下文栈；calleeContext 现在为运行执行上下文。
- 令 result 为 对 F 的求值 且符合其规范描述的完成记录结果。若 thisArgument 为
uninitialized ，则this 值未初始化；否则由 thisArgument 提供this 值。argumentsList 提供具名参数。newTarget 提供 NewTarget 值。 - 注：若 F 在本文档中定义，其“规范描述”即通过算法步骤或其他方式给出的行为。
- 将 calleeContext 自执行上下文栈移除并恢复 callerContext 为运行执行上下文。
- 返回 ? result。
当 calleeContext 被自执行上下文栈移除时，若其已被可访问的 Generator 挂起并被保留以供后续恢复，则不得销毁它。
10.3.4 CreateBuiltinFunction ( behaviour, length, name, additionalInternalSlotsList [ , realm [ , prototype [ , prefix ] ] ] )
The abstract operation CreateBuiltinFunction takes arguments behaviour (an
- 若未提供 realm，则将 realm 设为
当前 Realm Record 。 - 若未提供 prototype，则将 prototype 设为 realm.[[Intrinsics]].[[
%Function.prototype% ]]。 - 令 internalSlotsList 为包含
10.3 要求的全部内部槽名称的列表，用于即将创建的内置函数对象 。 - 将 additionalInternalSlotsList 的各元素追加到 internalSlotsList。
- 令 func 为一个新的内置
函数对象 ；当被调用时，使用所提供实参作为 behaviour 指定的对应形参值执行 behaviour 描述的动作。该新函数对象 具有名称为 internalSlotsList 各元素的内部槽，以及一个 [[InitialName]] 内部槽。 - 将 func.[[Prototype]] 设为 prototype。
- 将 func.[[Extensible]] 设为
true 。 - 将 func.[[Realm]] 设为 realm。
- 将 func.[[InitialName]] 设为
null 。 - 执行
SetFunctionLength (func, length)。 - 若未提供 prefix，则
- 执行
SetFunctionName (func, name)。
- 执行
- 否则，
- 执行
SetFunctionName (func, name, prefix)。
- 执行
- 返回 func。
本规范中定义的每个内置函数均通过调用 CreateBuiltinFunction
10.4 内置特异对象的内部方法与内部槽 (Built-in Exotic Object Internal Methods and Slots)
本规范定义了多种内置特异对象。除少数特定情形外，它们与
10.4.1 绑定函数特异对象 (Bound Function Exotic Objects)
若对象的 [[Call]] 与（若适用）[[Construct]] 内部方法使用以下实现，且其他基本内部方法使用
| Internal Slot | Type | Description |
|---|---|---|
| [[BoundTargetFunction]] | a callable Object |
被包装的 |
| [[BoundThis]] | an ECMAScript language value |
调用被包装函数时始终作为 |
| [[BoundArguments]] |
a |
在任何调用中用作被包装函数前置实参的值列表。 |
10.4.1.1 [[Call]] ( thisArgument, argumentsList )
The [[Call]] internal method of
- 令 target 为 F.[[BoundTargetFunction]]。
- 令 boundThis 为 F.[[BoundThis]]。
- 令 boundArgs 为 F.[[BoundArguments]]。
- 令 args 为 boundArgs 与 argumentsList 的列表连接。
- 返回 ? Call(target, boundThis, args)。
10.4.1.2 [[Construct]] ( argumentsList, newTarget )
The [[Construct]] internal method of
- 令 target 为 F.[[BoundTargetFunction]]。
- 断言：
IsConstructor (target) 为true 。 - 令 boundArgs 为 F.[[BoundArguments]]。
- 令 args 为 boundArgs 与 argumentsList 的列表连接。
- 若
SameValue (F, newTarget) 为true ，则将 newTarget 设为 target。 - 返回 ? Construct(target, args, newTarget)。
10.4.1.3 BoundFunctionCreate ( targetFunction, boundThis, boundArgs )
The abstract operation BoundFunctionCreate takes arguments targetFunction (a function object), boundThis (an ECMAScript language value), and boundArgs (a
- 令 proto 为 ? targetFunction.[[GetPrototypeOf]]()。
- 令 internalSlotsList 为 « [[Prototype]], [[Extensible]] » 与
Table 29 中内部槽列表的连接。 - 令 obj 为
MakeBasicObject (internalSlotsList)。 - 将 obj.[[Prototype]] 设为 proto。
- 按
10.4.1.1 所述设置 obj.[[Call]]。 - 若
IsConstructor (targetFunction) 为true ，则- 按
10.4.1.2 所述设置 obj.[[Construct]]。
- 按
- 将 obj.[[BoundTargetFunction]] 设为 targetFunction。
- 将 obj.[[BoundThis]] 设为 boundThis。
- 将 obj.[[BoundArguments]] 设为 boundArgs。
- 返回 obj。
10.4.2 数组特异对象 (Array Exotic Objects)
Array 是对
若对象的 [[DefineOwnProperty]] 内部方法使用以下实现，且其其它基本内部方法使用
10.4.2.1 [[DefineOwnProperty]] ( P, Desc )
The [[DefineOwnProperty]] internal method of
- 若 P 为
"length" ，则- 返回 ?
ArraySetLength (A, Desc)。
- 返回 ?
- 否则若 P 是
数组索引 ，则- 令 lengthDesc 为
OrdinaryGetOwnProperty (A,"length" )。 - 断言：lengthDesc 不为
undefined 。 - 断言：
IsDataDescriptor (lengthDesc) 为true 。 - 断言：lengthDesc.[[Configurable]] 为
false 。 - 令 length 为 lengthDesc.[[Value]]。
- 断言：length 是非负整数 Number。
- 令 index 为 !
ToUint32 (P)。 - 若 index ≥ length 且 lengthDesc.[[Writable]] 为
false ，返回false 。 - 令 succeeded 为 !
OrdinaryDefineOwnProperty (A, P, Desc)。 - 若 succeeded 为
false ，返回false 。 - 若 index ≥ length，则
- 将 lengthDesc.[[Value]] 设为 index +
1 𝔽。 - 将 succeeded 设为 !
OrdinaryDefineOwnProperty (A,"length" , lengthDesc)。 - 断言：succeeded 为
true 。
- 将 lengthDesc.[[Value]] 设为 index +
- 返回
true 。
- 令 lengthDesc 为
- 返回 ?
OrdinaryDefineOwnProperty (A, P, Desc)。
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% 。 - 令 A 为
MakeBasicObject (« [[Prototype]], [[Extensible]] »)。 - 将 A.[[Prototype]] 设为 proto。
- 按
10.4.2.1 规定设置 A.[[DefineOwnProperty]]。 - 执行 !
OrdinaryDefineOwnProperty (A,"length" , PropertyDescriptor { [[Value]]:𝔽 (length), [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 A。
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)。 - 令 C 为 ?
Get (originalArray,"constructor" )。 - 若
IsConstructor (C) 为true ，则- 令 thisRealm 为
当前 Realm Record 。 - 令 realmC 为 ?
GetFunctionRealm (C)。 - 若 thisRealm 与 realmC 不是同一
Realm Record ，则
- 令 thisRealm 为
- 若 C 是一个 Object，则
- 将 C 设为 ?
Get (C,%Symbol.species% )。 - 若 C 为
null ，将 C 设为undefined 。
- 将 C 设为 ?
- 若 C 为
undefined ，返回 ?ArrayCreate (length)。 - 若
IsConstructor (C) 为false ，抛出TypeError 异常。 - 返回 ? Construct(C, «
𝔽 (length) »)。
10.4.2.4 ArraySetLength ( A, Desc )
The abstract operation ArraySetLength takes arguments A (an Array) and Desc (a
- 若 Desc 不含 [[Value]] 字段，则
- 返回 !
OrdinaryDefineOwnProperty (A,"length" , Desc)。
- 返回 !
- 令 newLenDesc 为 Desc 的拷贝。
- 令 newLen 为 ?
ToUint32 (Desc.[[Value]])。 - 令 numberLen 为 ?
ToNumber (Desc.[[Value]])。 - 若
SameValueZero (newLen, numberLen) 为false ，抛出RangeError 异常。 - 将 newLenDesc.[[Value]] 设为 newLen。
- 令 oldLenDesc 为
OrdinaryGetOwnProperty (A,"length" )。 - 断言：oldLenDesc 不为
undefined 。 - 断言：
IsDataDescriptor (oldLenDesc) 为true 。 - 断言：oldLenDesc.[[Configurable]] 为
false 。 - 令 oldLen 为 oldLenDesc.[[Value]]。
- 若 newLen ≥ oldLen，则
- 返回 !
OrdinaryDefineOwnProperty (A,"length" , newLenDesc)。
- 返回 !
- 若 oldLenDesc.[[Writable]] 为
false ，返回false 。 - 若 newLenDesc 无 [[Writable]] 字段或 newLenDesc.[[Writable]] 为
true ，则- 令 newWritable 为
true 。
- 令 newWritable 为
- 否则，
- 注：若某些元素无法删除，则延迟将 [[Writable]] 设为
false 。 - 令 newWritable 为
false 。 - 将 newLenDesc.[[Writable]] 设为
true 。
- 注：若某些元素无法删除，则延迟将 [[Writable]] 设为
- 令 succeeded 为 !
OrdinaryDefineOwnProperty (A,"length" , newLenDesc)。 - 若 succeeded 为
false ，返回false 。 - 对 A 的每个自身
属性键 P，若 P 是数组索引 且 !ToUint32 (P) ≥ newLen，按递减数值索引顺序：- 令 deleteSucceeded 为 ! A.[[Delete]](P)。
- 若 deleteSucceeded 为
false ，则- 将 newLenDesc.[[Value]] 设为 !
ToUint32 (P) +1 𝔽。 - 若 newWritable 为
false ，将 newLenDesc.[[Writable]] 设为false 。 - 执行 !
OrdinaryDefineOwnProperty (A,"length" , newLenDesc)。 - 返回
false 。
- 将 newLenDesc.[[Value]] 设为 !
- 若 newWritable 为
false ，则- 将 succeeded 设为 !
OrdinaryDefineOwnProperty (A,"length" , PropertyDescriptor { [[Writable]]:false })。 - 断言：succeeded 为
true 。
- 将 succeeded 设为 !
- 返回
true 。
10.4.3 字符串特异对象 (String Exotic Objects)
String 对象是封装一个 String 值并暴露与该值中各代码单元元素对应的虚拟
若对象的 [[GetOwnProperty]]、[[DefineOwnProperty]] 与 [[OwnPropertyKeys]] 内部方法使用以下实现，且其他基本内部方法使用
10.4.3.1 [[GetOwnProperty]] ( P )
The [[GetOwnProperty]] internal method of
- 令 desc 为
OrdinaryGetOwnProperty (S, P)。 - 若 desc 不为
undefined ，返回 desc。 - 返回
StringGetOwnProperty (S, P)。
10.4.3.2 [[DefineOwnProperty]] ( P, Desc )
The [[DefineOwnProperty]] internal method of
- 令 stringDesc 为
StringGetOwnProperty (S, P)。 - 若 stringDesc 不为
undefined ，则- 令 extensible 为 S.[[Extensible]]。
- 返回
IsCompatiblePropertyDescriptor (extensible, Desc, stringDesc)。
- 返回 !
OrdinaryDefineOwnProperty (S, P, Desc)。
10.4.3.3 [[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of
10.4.3.4 StringCreate ( value, prototype )
The abstract operation StringCreate takes arguments value (a String) and prototype (an Object) and returns 一个
- 令 S 为
MakeBasicObject (« [[Prototype]], [[Extensible]], [[StringData]] »)。 - 将 S.[[Prototype]] 设为 prototype。
- 将 S.[[StringData]] 设为 value。
- 按
10.4.3.1 规定设置 S.[[GetOwnProperty]]。 - 按
10.4.3.2 规定设置 S.[[DefineOwnProperty]]。 - 按
10.4.3.3 规定设置 S.[[OwnPropertyKeys]]。 - 令 length 为 value 的长度。
- 执行 !
DefinePropertyOrThrow (S,"length" , PropertyDescriptor { [[Value]]:𝔽 (length), [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 S。
10.4.3.5 StringGetOwnProperty ( S, P )
The abstract operation StringGetOwnProperty takes arguments S (an Object that has a [[StringData]] internal slot) and P (a property key) and returns 一个
- 若 P 不是 String，返回
undefined 。 - 令 index 为
CanonicalNumericIndexString (P)。 - 若 index 不是整数 Number，返回
undefined 。 - 若 index 为
-0 𝔽 或 index <-0 𝔽，返回undefined 。 - 令 str 为 S.[[StringData]]。
- 断言：str 是 String。
- 令 len 为 str 的长度。
- 若
ℝ (index) ≥ len，返回undefined 。 - 令 resultStr 为从
ℝ (index) 到ℝ (index) + 1 的 str 子串。 - 返回 PropertyDescriptor { [[Value]]: resultStr, [[Writable]]:
false , [[Enumerable]]:true , [[Configurable]]:false }。
10.4.4 Arguments 特异对象 (Arguments Exotic Objects)
大多数 ECMAScript 函数向其代码提供一个 arguments 对象。依据函数定义特征，该对象要么是
若对象的内部方法按以下实现（未指明者使用
虽
Object.prototype.toString (
ParameterMap 对象及其属性值是描述 arguments 对象与参数绑定对应关系的机制；它们对 ECMAScript 代码不可直接观察，实现无需实际创建。
普通 arguments 对象定义一个名为
历史上
10.4.4.1 [[GetOwnProperty]] ( P )
The [[GetOwnProperty]] internal method of
- 令 desc 为
OrdinaryGetOwnProperty (args, P)。 - 若 desc 为
undefined ，返回undefined 。 - 令 map 为 args.[[ParameterMap]]。
- 令 isMapped 为 !
HasOwnProperty (map, P)。 - 若 isMapped 为
true ，则- 将 desc.[[Value]] 设为 !
Get (map, P)。
- 将 desc.[[Value]] 设为 !
- 返回 desc。
10.4.4.2 [[DefineOwnProperty]] ( P, Desc )
The [[DefineOwnProperty]] internal method of
- 令 map 为 args.[[ParameterMap]]。
- 令 isMapped 为 !
HasOwnProperty (map, P)。 - 令 newArgDesc 为 Desc。
- 若 isMapped 为
true 且IsDataDescriptor (Desc) 为true ，则- 若 Desc 不含 [[Value]] 字段、含 [[Writable]] 字段且 Desc.[[Writable]] 为
false ，则- 将 newArgDesc 设为 Desc 的拷贝。
- 将 newArgDesc.[[Value]] 设为 !
Get (map, P)。
- 若 Desc 不含 [[Value]] 字段、含 [[Writable]] 字段且 Desc.[[Writable]] 为
- 令 allowed 为 !
OrdinaryDefineOwnProperty (args, P, newArgDesc)。 - 若 allowed 为
false ，返回false 。 - 若 isMapped 为
true ，则- 若
IsAccessorDescriptor (Desc) 为true ，则- 执行 ! map.[[Delete]](P)。
- 否则，
- 若 Desc 含 [[Value]] 字段，则
- 断言：下面的 Set 会成功，因为被映射的形式参数总是可写。
- 执行 !
Set (map, P, Desc.[[Value]],false )。
- 若 Desc 含 [[Writable]] 字段且 Desc.[[Writable]] 为
false ，则- 执行 ! map.[[Delete]](P)。
- 若 Desc 含 [[Value]] 字段，则
- 若
- 返回
true 。
10.4.4.3 [[Get]] ( P, Receiver )
The [[Get]] internal method of
- 令 map 为 args.[[ParameterMap]]。
- 令 isMapped 为 !
HasOwnProperty (map, P)。 - 若 isMapped 为
false ，则- 返回 ?
OrdinaryGet (args, P, Receiver)。
- 返回 ?
- 否则，
- 断言：map 包含 P 的形式参数映射。
- 返回 !
Get (map, P)。
10.4.4.4 [[Set]] ( P, V, Receiver )
The [[Set]] internal method of
- 若
SameValue (args, Receiver) 为false ，则- 令 isMapped 为
false 。
- 令 isMapped 为
- 否则，
- 令 map 为 args.[[ParameterMap]]。
- 令 isMapped 为 !
HasOwnProperty (map, P)。
- 若 isMapped 为
true ，则- 断言：以下 Set 会成功，因为被映射形式参数总是可写。
- 执行 !
Set (map, P, V,false )。
- 返回 ?
OrdinarySet (args, P, V, Receiver)。
10.4.4.5 [[Delete]] ( P )
The [[Delete]] internal method of
- 令 map 为 args.[[ParameterMap]]。
- 令 isMapped 为 !
HasOwnProperty (map, P)。 - 令 result 为 ?
OrdinaryDelete (args, P)。 - 若 result 为
true 且 isMapped 为true ，则- 执行 ! map.[[Delete]](P)。
- 返回 result。
10.4.4.6 CreateUnmappedArgumentsObject ( argumentsList )
The abstract operation CreateUnmappedArgumentsObject takes argument argumentsList (a
- 令 len 为 argumentsList 中元素个数。
- 令 obj 为
OrdinaryObjectCreate (%Object.prototype% , « [[ParameterMap]] »)。 - 将 obj.[[ParameterMap]] 设为
undefined 。 - 执行 !
DefinePropertyOrThrow (obj,"length" , PropertyDescriptor { [[Value]]:𝔽 (len), [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true })。 - 令 index 为 0。
- 当 index < len 重复：
- 令 val 为 argumentsList[index]。
- 执行 !
CreateDataPropertyOrThrow (obj, !ToString (𝔽 (index)), val)。 - 将 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, argumentsList, env )
The abstract operation CreateMappedArgumentsObject takes arguments func (an Object), formals (a Parse Node), argumentsList (a
- 断言：formals 不含 rest 参数、任何绑定模式或初始化器；可包含重复标识符。
- 令 len 为 argumentsList 元素个数。
- 令 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。
- 令 parameterNames 为 formals 的 BoundNames。
- 令 numberOfParameters 为 parameterNames 元素个数。
- 令 index 为 0。
- 当 index < len 重复：
- 令 val 为 argumentsList[index]。
- 执行 !
CreateDataPropertyOrThrow (obj, !ToString (𝔽 (index)), val)。 - 将 index 设为 index + 1。
- 执行 !
DefinePropertyOrThrow (obj,"length" , PropertyDescriptor { [[Value]]:𝔽 (len), [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true })。 - 令 mappedNames 为新空列表。
- 将 index 设为 numberOfParameters - 1。
- 当 index ≥ 0 重复：
- 令 name 为 parameterNames[index]。
- 若 mappedNames 不含 name，则
- 追加 name 至 mappedNames。
- 若 index < len，则
- 令 g 为
MakeArgGetter (name, env)。 - 令 p 为
MakeArgSetter (name, env)。 - 执行 ! map.[[DefineOwnProperty]](!
ToString (𝔽 (index)), PropertyDescriptor { [[Set]]: p, [[Get]]: g, [[Enumerable]]:false , [[Configurable]]:true })。
- 令 g 为
- 将 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, env )
The abstract operation MakeArgGetter takes arguments name (a String) and env (an
- 令 getterClosure 为一个新的无参数
Abstract Closure ，捕获 name 与 env，调用时执行：- 返回
NormalCompletion (! env.GetBindingValue(name,false ))。
- 返回
- 令 getter 为
CreateBuiltinFunction (getterClosure, 0,"" , « »)。 - 注：getter 不会被 ECMAScript 代码直接访问。
- 返回 getter。
10.4.4.7.2 MakeArgSetter ( name, env )
The abstract operation MakeArgSetter takes arguments name (a String) and env (an
- 令 setterClosure 为一个带参数 (value) 的新
Abstract Closure ，捕获 name 与 env，调用时执行：- 返回
NormalCompletion (! env.SetMutableBinding(name, value,false ))。
- 返回
- 令 setter 为
CreateBuiltinFunction (setterClosure, 1,"" , « »)。 - 注：setter 不会被 ECMAScript 代码直接访问。
- 返回 setter。
10.4.5 TypedArray 特异对象 (TypedArray Exotic Objects)
若对象的 [[PreventExtensions]]、[[GetOwnProperty]]、[[HasProperty]]、[[DefineOwnProperty]]、[[Get]]、[[Set]]、[[Delete]]、[[OwnPropertyKeys]] 内部方法使用本节定义，且其它基本内部方法使用
10.4.5.1 [[PreventExtensions]] ( )
The [[PreventExtensions]] internal method of
- 注：
6.1.7.3 中的可扩展性不变式不允许在 O 仍可能获得（或失去后再获得）属性时返回true ；当底层缓冲区重分配且涉及整数索引 属性时可能发生该情况。 - 若
IsTypedArrayFixedLength (O) 为false ，返回false 。 - 返回
OrdinaryPreventExtensions (O)。
10.4.5.2 [[GetOwnProperty]] ( P )
The [[GetOwnProperty]] internal method of
- 若 P 是 String，则
- 令 numericIndex 为
CanonicalNumericIndexString (P)。 - 若 numericIndex 不为
undefined ，则- 令 value 为
TypedArrayGetElement (O, numericIndex)。 - 若 value 为
undefined ，返回undefined 。 - 返回 PropertyDescriptor { [[Value]]: value, [[Writable]]:
true , [[Enumerable]]:true , [[Configurable]]:true }。
- 令 value 为
- 令 numericIndex 为
- 返回
OrdinaryGetOwnProperty (O, P)。
10.4.5.3 [[HasProperty]] ( P )
The [[HasProperty]] internal method of
- 若 P 是 String，则
- 令 numericIndex 为
CanonicalNumericIndexString (P)。 - 若 numericIndex 不为
undefined ，返回IsValidIntegerIndex (O, numericIndex)。
- 令 numericIndex 为
- 返回 ?
OrdinaryHasProperty (O, P)。
10.4.5.4 [[DefineOwnProperty]] ( P, Desc )
The [[DefineOwnProperty]] internal method of
- 若 P 是 String，则
- 令 numericIndex 为
CanonicalNumericIndexString (P)。 - 若 numericIndex 不为
undefined ，则- 若
IsValidIntegerIndex (O, numericIndex) 为false ，返回false 。 - 若 Desc 有 [[Configurable]] 且为
false ，返回false 。 - 若 Desc 有 [[Enumerable]] 且为
false ，返回false 。 - 若
IsAccessorDescriptor (Desc) 为true ，返回false 。 - 若 Desc 有 [[Writable]] 且为
false ，返回false 。 - 若 Desc 有 [[Value]] 字段，执行 ?
TypedArraySetElement (O, numericIndex, Desc.[[Value]])。 - 返回
true 。
- 若
- 令 numericIndex 为
- 返回 !
OrdinaryDefineOwnProperty (O, P, Desc)。
10.4.5.5 [[Get]] ( P, Receiver )
The [[Get]] internal method of
- 若 P 是 String，则
- 令 numericIndex 为
CanonicalNumericIndexString (P)。 - 若 numericIndex 不为
undefined ，则- 返回
TypedArrayGetElement (O, numericIndex)。
- 返回
- 令 numericIndex 为
- 返回 ?
OrdinaryGet (O, P, Receiver)。
10.4.5.6 [[Set]] ( P, V, Receiver )
The [[Set]] internal method of
- 若 P 是 String，则
- 令 numericIndex 为
CanonicalNumericIndexString (P)。 - 若 numericIndex 不为
undefined ，则- 若
SameValue (O, Receiver) 为true ，则- 执行 ?
TypedArraySetElement (O, numericIndex, V)。 - 返回
true 。
- 执行 ?
- 若
IsValidIntegerIndex (O, numericIndex) 为false ，返回true 。
- 若
- 令 numericIndex 为
- 返回 ?
OrdinarySet (O, P, V, Receiver)。
10.4.5.7 [[Delete]] ( P )
The [[Delete]] internal method of
- 若 P 是 String，则
- 令 numericIndex 为
CanonicalNumericIndexString (P)。 - 若 numericIndex 不为
undefined ，则- 若
IsValidIntegerIndex (O, numericIndex) 为false ，返回true ；否则返回false 。
- 若
- 令 numericIndex 为
- 返回 !
OrdinaryDelete (O, P)。
10.4.5.8 [[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of
- 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst )。 - 令 keys 为新空列表。
- 若
IsTypedArrayOutOfBounds (taRecord) 为false ，则- 令 length 为
TypedArrayLength (taRecord)。 - 对每个整数 i（0 ≤ i < length，升序）：
- 令 length 为
- 对 O 的每个自身
属性键 P（P 为 String 且不是整数索引 ，按创建时间升序）：- 追加 P 至 keys。
- 对 O 的每个自身
属性键 P（P 为 Symbol，按创建时间升序）：- 追加 P 至 keys。
- 返回 keys。
10.4.5.9 带缓冲区见证记录的 TypedArray (TypedArray With Buffer Witness Records)
TypedArray With Buffer Witness Record 是用于封装一个
其字段列于
| Field Name | Value | Meaning |
|---|---|---|
| [[Object]] |
a |
其缓冲区字节长度被加载的 |
| [[CachedBufferByteLength]] |
a non-negative |
记录创建时对象 [[ViewedArrayBuffer]] 的字节长度。 |
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 ( prototype )
The abstract operation TypedArrayCreate takes argument prototype (an Object) and returns 一个
- 令 internalSlotsList 为 « [[Prototype]], [[Extensible]], [[ViewedArrayBuffer]], [[TypedArrayName]], [[ContentType]], [[ByteLength]], [[ByteOffset]], [[ArrayLength]] »。
- 令 A 为
MakeBasicObject (internalSlotsList)。 - 按
10.4.5.1 设置 A.[[PreventExtensions]]。 - 按
10.4.5.2 设置 A.[[GetOwnProperty]]。 - 按
10.4.5.3 设置 A.[[HasProperty]]。 - 按
10.4.5.4 设置 A.[[DefineOwnProperty]]。 - 按
10.4.5.5 设置 A.[[Get]]。 - 按
10.4.5.6 设置 A.[[Set]]。 - 按
10.4.5.7 设置 A.[[Delete]]。 - 按
10.4.5.8 设置 A.[[OwnPropertyKeys]]。 - 将 A.[[Prototype]] 设为 prototype。
- 返回 A。
10.4.5.12 TypedArrayByteLength ( taRecord )
The abstract operation TypedArrayByteLength takes argument taRecord (a
- 若
IsTypedArrayOutOfBounds (taRecord) 为true ，返回 0。 - 令 length 为
TypedArrayLength (taRecord)。 - 若 length = 0，返回 0。
- 令 O 为 taRecord.[[Object]]。
- 若 O.[[ByteLength]] 不为
auto ，返回 O.[[ByteLength]]。 - 令 elementSize 为
TypedArrayElementSize (O)。 - 返回 length × elementSize。
10.4.5.13 TypedArrayLength ( taRecord )
The abstract operation TypedArrayLength takes argument taRecord (a
- 断言：
IsTypedArrayOutOfBounds (taRecord) 为false 。 - 令 O 为 taRecord.[[Object]]。
- 若 O.[[ArrayLength]] 不为
auto ，返回 O.[[ArrayLength]]。 - 断言：
IsFixedLengthArrayBuffer (O.[[ViewedArrayBuffer]]) 为false 。 - 令 byteOffset 为 O.[[ByteOffset]]。
- 令 elementSize 为
TypedArrayElementSize (O)。 - 令 byteLength 为 taRecord.[[CachedBufferByteLength]]。
- 断言：byteLength 不为
detached 。 - 返回
floor ((byteLength - byteOffset) / elementSize)。
10.4.5.14 IsTypedArrayOutOfBounds ( taRecord )
The abstract operation IsTypedArrayOutOfBounds takes argument taRecord (a
- 令 O 为 taRecord.[[Object]]。
- 令 bufferByteLength 为 taRecord.[[CachedBufferByteLength]]。
- 断言：
IsDetachedBuffer (O.[[ViewedArrayBuffer]]) 为true 当且仅当 bufferByteLength 为detached 。 - 若 bufferByteLength 为
detached ，返回true 。 - 令 byteOffsetStart 为 O.[[ByteOffset]]。
- 若 O.[[ArrayLength]] 为
auto ，则- 令 byteOffsetEnd 为 bufferByteLength。
- 否则，
- 令 elementSize 为
TypedArrayElementSize (O)。 - 令 byteOffsetEnd 为 byteOffsetStart + O.[[ArrayLength]] × elementSize。
- 令 elementSize 为
- 若 byteOffsetStart > bufferByteLength 或 byteOffsetEnd > bufferByteLength，返回
true 。 - 注：长度为 0 的
TypedArray 不视为越界。 - 返回
false 。
10.4.5.15 IsTypedArrayFixedLength ( O )
The abstract operation IsTypedArrayFixedLength takes argument O (a
- 若 O.[[ArrayLength]] 为
auto ，返回false 。 - 令 buffer 为 O.[[ViewedArrayBuffer]]。
- 若
IsFixedLengthArrayBuffer (buffer) 为false 且IsSharedArrayBuffer (buffer) 为false ，返回false 。 - 返回
true 。
10.4.5.16 IsValidIntegerIndex ( O, index )
The abstract operation IsValidIntegerIndex takes arguments O (a
- 若
IsDetachedBuffer (O.[[ViewedArrayBuffer]]) 为true ，返回false 。 - 若 index 不是整数 Number，返回
false 。 - 若 index 为
-0 𝔽 或 index <-0 𝔽，返回false 。 - 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (O,unordered )。 - 注：当 O 的底层缓冲是
可增长 SharedArrayBuffer 时，边界检查不是同步操作。 - 若
IsTypedArrayOutOfBounds (taRecord) 为true ，返回false 。 - 令 length 为
TypedArrayLength (taRecord)。 - 若
ℝ (index) ≥ length，返回false 。 - 返回
true 。
10.4.5.17 TypedArrayGetElement ( O, index )
The abstract operation TypedArrayGetElement takes arguments O (a
- 若
IsValidIntegerIndex (O, index) 为false ，返回undefined 。 - 令 offset 为 O.[[ByteOffset]]。
- 令 elementSize 为
TypedArrayElementSize (O)。 - 令 byteIndexInBuffer 为 (
ℝ (index) × elementSize) + offset。 - 令 elementType 为
TypedArrayElementType (O)。 - 返回
GetValueFromBuffer (O.[[ViewedArrayBuffer]], byteIndexInBuffer, elementType,true ,unordered )。
10.4.5.18 TypedArraySetElement ( O, index, value )
The abstract operation TypedArraySetElement takes arguments O (a
- 若 O.[[ContentType]] 为
bigint ，令 numValue 为 ?ToBigInt (value)；否则令 numValue 为 ?ToNumber (value)。 - 若
IsValidIntegerIndex (O, index) 为true ，则- 令 offset 为 O.[[ByteOffset]]。
- 令 elementSize 为
TypedArrayElementSize (O)。 - 令 byteIndexInBuffer 为 (
ℝ (index) × elementSize) + offset。 - 令 elementType 为
TypedArrayElementType (O)。 - 执行
SetValueInBuffer (O.[[ViewedArrayBuffer]], byteIndexInBuffer, elementType, numValue,true ,unordered )。
- 返回
unused 。
此操作表面上总是成功；当写入越界或底层 ArrayBuffer 已分离时不产生效果。
10.4.5.19 IsArrayBufferViewOutOfBounds ( O )
The abstract operation IsArrayBufferViewOutOfBounds takes argument O (a
- 若 O 具有 [[DataView]] 内部槽，则
- 令 viewRecord 为
MakeDataViewWithBufferWitnessRecord (O,seq-cst )。 - 返回
IsViewOutOfBounds (viewRecord)。
- 令 viewRecord 为
- 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst )。 - 返回
IsTypedArrayOutOfBounds (taRecord)。
10.4.6 模块命名空间特异对象 (Module Namespace Exotic Objects)
export * 间接导出的绑定。每个字符串键属性的键即对应导出绑定名的 StringValue。这些是其全部字符串键属性。每个此类属性特性为 { [[Writable]]:
若对象的 [[GetPrototypeOf]]、[[SetPrototypeOf]]、[[IsExtensible]]、[[PreventExtensions]]、[[GetOwnProperty]]、[[DefineOwnProperty]]、[[HasProperty]]、[[Get]]、[[Set]]、[[Delete]]、[[OwnPropertyKeys]] 内部方法使用本节定义，且其它基本内部方法使用
| Internal Slot | Type | Description |
|---|---|---|
| [[Module]] |
a |
此命名空间暴露其导出的 |
| [[Exports]] |
a |
作为该对象自身属性暴露的导出名称字符串列表，按字典序代码单元顺序排序。 |
10.4.6.1 [[GetPrototypeOf]] ( )
The [[GetPrototypeOf]] internal method of
- 返回
null 。
10.4.6.2 [[SetPrototypeOf]] ( V )
The [[SetPrototypeOf]] internal method of
- 返回 !
SetImmutablePrototype (O, V)。
10.4.6.3 [[IsExtensible]] ( )
The [[IsExtensible]] internal method of
- 返回
false 。
10.4.6.4 [[PreventExtensions]] ( )
The [[PreventExtensions]] internal method of
- 返回
true 。
10.4.6.5 [[GetOwnProperty]] ( P )
The [[GetOwnProperty]] internal method of
- 若 P 是 Symbol，返回
OrdinaryGetOwnProperty (O, P)。 - 令 exports 为 O.[[Exports]]。
- 若 exports 不含 P，返回
undefined 。 - 令 value 为 ? O.[[Get]](P, O)。
- 返回 PropertyDescriptor { [[Value]]: value, [[Writable]]:
true , [[Enumerable]]:true , [[Configurable]]:false }。
10.4.6.6 [[DefineOwnProperty]] ( P, Desc )
The [[DefineOwnProperty]] internal method of
- 若 P 是 Symbol，返回 !
OrdinaryDefineOwnProperty (O, P, Desc)。 - 令 current 为 ? O.[[GetOwnProperty]](P)。
- 若 current 为
undefined ，返回false 。 - 若 Desc 有 [[Configurable]] 且为
true ，返回false 。 - 若 Desc 有 [[Enumerable]] 且为
false ，返回false 。 - 若
IsAccessorDescriptor (Desc) 为true ，返回false 。 - 若 Desc 有 [[Writable]] 且为
false ，返回false 。 - 若 Desc 有 [[Value]] 字段，返回
SameValue (Desc.[[Value]], current.[[Value]])。 - 返回
true 。
10.4.6.7 [[HasProperty]] ( P )
The [[HasProperty]] internal method of
- 若 P 是 Symbol，返回 !
OrdinaryHasProperty (O, P)。 - 令 exports 为 O.[[Exports]]。
- 若 exports 含 P，返回
true 。 - 返回
false 。
10.4.6.8 [[Get]] ( P, Receiver )
The [[Get]] internal method of
- 若 P 是 Symbol，则
- 返回 !
OrdinaryGet (O, P, Receiver)。
- 返回 !
- 令 exports 为 O.[[Exports]]。
- 若 exports 不含 P，返回
undefined 。 - 令 m 为 O.[[Module]]。
- 令 binding 为 m.ResolveExport(P)。
- 断言：binding 是
ResolvedBinding Record 。 - 令 targetModule 为 binding.[[Module]]。
- 断言：targetModule 不为
undefined 。 - 若 binding.[[BindingName]] 为
namespace ，则- 返回
GetModuleNamespace (targetModule)。
- 返回
- 令 targetEnv 为 targetModule.[[Environment]]。
- 若 targetEnv 为
empty ，抛出ReferenceError 异常。 - 返回 ? targetEnv.GetBindingValue(binding.[[BindingName]],
true )。
ResolveExport 无副作用；对相同参数组合多次调用结果必须一致。实现可预先计算或缓存每个命名空间对象 [[Exports]] 的 ResolveExport 结果。
10.4.6.9 [[Set]] ( P, V, Receiver )
The [[Set]] internal method of
- 返回
false 。
10.4.6.10 [[Delete]] ( P )
The [[Delete]] internal method of
- 若 P 是 Symbol，则
- 返回 !
OrdinaryDelete (O, P)。
- 返回 !
- 令 exports 为 O.[[Exports]]。
- 若 exports 含 P，返回
false 。 - 返回
true 。
10.4.6.11 [[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of
- 令 exports 为 O.[[Exports]]。
- 令 symbolKeys 为
OrdinaryOwnPropertyKeys (O)。 - 返回 exports 与 symbolKeys 的列表连接结果。
10.4.6.12 ModuleNamespaceCreate ( module, exports )
The abstract operation ModuleNamespaceCreate takes arguments module (a
- 断言：module.[[Namespace]] 为
empty 。 - 令 internalSlotsList 为
Table 31 中列出的内部槽列表。 - 令 M 为
MakeBasicObject (internalSlotsList)。 - 将 M 的基本内部方法设为
10.4.6 中的定义。 - 将 M.[[Module]] 设为 module。
- 令 sortedExports 为对 exports 元素按字典序代码单元排序后的列表。
- 将 M.[[Exports]] 设为 sortedExports。
- 创建 M 的自身属性以对应
28.3 中的定义。 - 将 module.[[Namespace]] 设为 M。
- 返回 M。
10.4.7 不可变原型特异对象 (Immutable Prototype Exotic Objects)
若对象的 [[SetPrototypeOf]] 内部方法使用以下实现（其它基本内部方法可视具体对象采用任意实现），则该对象是 不可变原型特异对象。
与其它特异对象不同，
10.4.7.1 [[SetPrototypeOf]] ( V )
The [[SetPrototypeOf]] internal method of
- 返回 ?
SetImmutablePrototype (O, V)。
10.4.7.2 SetImmutablePrototype ( O, V )
The abstract operation SetImmutablePrototype takes arguments O (an Object) and V (an Object or
- 令 current 为 ? O.[[GetPrototypeOf]]()。
- 若
SameValue (V, current) 为true ，返回true 。 - 返回
false 。
10.5 Proxy 对象的内部方法与内部槽 (Proxy Object Internal Methods and Internal Slots)
Proxy 对象是一种特异对象，其关键内部方法部分由 ECMAScript 代码实现。每个 Proxy 对象都有名为 [[ProxyHandler]] 的内部槽。[[ProxyHandler]] 的值要么是一个对象（称为该 proxy 的 handler 对象），要么是
若一个对象的关键内部方法（若适用包括 [[Call]] 与 [[Construct]]）使用本节的定义，则该对象为 Proxy 特异对象。这些内部方法在
| 内部方法 (Internal Method) | 处理器方法 (Handler Method) |
|---|---|
| [[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 对象不一定具备每个关键内部方法对应的 trap；如果缺少对应 trap，则在 proxy 上调用该内部方法会转发到 target 对象上的对应内部方法。
Proxy 对象的 [[ProxyHandler]] 与 [[ProxyTarget]] 内部槽在创建时总被初始化，通常不可再修改。某些 Proxy 被创建为可随后被 撤销（revoked）。当一个 proxy 被撤销时，其 [[ProxyHandler]] 与 [[ProxyTarget]] 被设为
由于 Proxy 允许内部方法实现由任意 ECMAScript 代码提供，可能定义出其 handler 方法违反
以下算法中，假设 O 为一个 ECMAScript Proxy 对象，P 为
10.5.1 [[GetPrototypeOf]] ( )
The [[GetPrototypeOf]] internal method of
- 执行 ?
ValidateNonRevokedProxy (O)。 - 令 target 为 O.[[ProxyTarget]]。
- 令 handler 为 O.[[ProxyHandler]]。
- 断言：handler 是一个 Object。
- 令 trap 为 ?
GetMethod (handler,"getPrototypeOf" )。 - 若 trap 为
undefined ，则- 返回 ? target.[[GetPrototypeOf]]()。
- 令 handlerProto 为 ? Call(trap, handler, « target »)。
- 若 handlerProto 既
不是 Object 且也不是null ，抛出TypeError 异常。 - 令 extensibleTarget 为 ?
IsExtensible (target)。 - 若 extensibleTarget 为
true ，返回 handlerProto。 - 令 targetProto 为 ? target.[[GetPrototypeOf]]()。
- 若
SameValue (handlerProto, targetProto) 为false ，抛出TypeError 异常。 - 返回 handlerProto。
Proxy 的 [[GetPrototypeOf]] 强制以下不变式：
-
结果必须
是 Object 或null 。 - 若 target 不可扩展，对 Proxy 调用 [[GetPrototypeOf]] 的结果须与对其 target 调用的结果相同。
10.5.2 [[SetPrototypeOf]] ( V )
The [[SetPrototypeOf]] internal method of
- 执行 ?
ValidateNonRevokedProxy (O)。 - 令 target 为 O.[[ProxyTarget]]。
- 令 handler 为 O.[[ProxyHandler]]。
- 断言：handler 是一个 Object。
- 令 trap 为 ?
GetMethod (handler,"setPrototypeOf" )。 - 若 trap 为
undefined ，则- 返回 ? target.[[SetPrototypeOf]](V)。
- 令 booleanTrapResult 为
ToBoolean (? Call(trap, handler, « target, V »))。 - 若 booleanTrapResult 为
false ，返回false 。 - 令 extensibleTarget 为 ?
IsExtensible (target)。 - 若 extensibleTarget 为
true ，返回true 。 - 令 targetProto 为 ? target.[[GetPrototypeOf]]()。
- 若
SameValue (V, targetProto) 为false ，抛出TypeError 异常。 - 返回
true 。
Proxy 的 [[SetPrototypeOf]] 强制以下不变式：
- 结果是一个 Boolean。
- 若 target 不可扩展，参数值必须与对 target 调用 [[GetPrototypeOf]] 的结果相同。
10.5.3 [[IsExtensible]] ( )
The [[IsExtensible]] internal method of
- 执行 ?
ValidateNonRevokedProxy (O)。 - 令 target 为 O.[[ProxyTarget]]。
- 令 handler 为 O.[[ProxyHandler]]。
- 断言：handler 是一个 Object。
- 令 trap 为 ?
GetMethod (handler,"isExtensible" )。 - 若 trap 为
undefined ，则- 返回 ?
IsExtensible (target)。
- 返回 ?
- 令 booleanTrapResult 为
ToBoolean (? Call(trap, handler, « target »))。 - 令 targetResult 为 ?
IsExtensible (target)。 - 若 booleanTrapResult 不等于 targetResult，抛出
TypeError 异常。 - 返回 booleanTrapResult。
Proxy 的 [[IsExtensible]] 强制以下不变式：
- 结果是 Boolean。
- 对 Proxy 的调用结果必须与对其 target 的调用结果一致。
10.5.4 [[PreventExtensions]] ( )
The [[PreventExtensions]] internal method of
- 执行 ?
ValidateNonRevokedProxy (O)。 - 令 target 为 O.[[ProxyTarget]]。
- 令 handler 为 O.[[ProxyHandler]]。
- 断言：handler 是一个 Object。
- 令 trap 为 ?
GetMethod (handler,"preventExtensions" )。 - 若 trap 为
undefined ，则- 返回 ? target.[[PreventExtensions]]()。
- 令 booleanTrapResult 为
ToBoolean (? Call(trap, handler, « target »))。 - 若 booleanTrapResult 为
true ，则- 令 extensibleTarget 为 ?
IsExtensible (target)。 - 若 extensibleTarget 为
true ，抛出TypeError 异常。
- 令 extensibleTarget 为 ?
- 返回 booleanTrapResult。
Proxy 的 [[PreventExtensions]] 强制以下不变式：
- 结果是 Boolean。
-
仅当 target 的 [[IsExtensible]] 为
false 时才可返回true 。
10.5.5 [[GetOwnProperty]] ( P )
The [[GetOwnProperty]] internal method of
- 执行 ?
ValidateNonRevokedProxy (O)。 - 令 target 为 O.[[ProxyTarget]]。
- 令 handler 为 O.[[ProxyHandler]]。
- 断言：handler 是一个 Object。
- 令 trap 为 ?
GetMethod (handler,"getOwnPropertyDescriptor" )。 - 若 trap 为
undefined ，则- 返回 ? target.[[GetOwnProperty]](P)。
- 令 trapResultObj 为 ? Call(trap, handler, « target, P »)。
- 若 trapResultObj
不是 Object 且也不是undefined ，抛出TypeError 异常。 - 令 targetDesc 为 ? target.[[GetOwnProperty]](P)。
- 若 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]] 强制以下不变式：
-
结果必须
是 Object 或undefined 。 - 若 target 上存在一个不可配置自身属性，不得报告其不存在。
- 若 target 不可扩展且存在该自身属性，不得报告其不存在。
- 若 target 不可扩展且不存在该自身属性，不得报告其存在。
- 不得报告某属性为不可配置，除非它在 target 上为不可配置自身属性。
- 不得同时报告某属性为不可配置且不可写，除非它在 target 上为不可配置且不可写自身属性。
10.5.6 [[DefineOwnProperty]] ( P, Desc )
The [[DefineOwnProperty]] internal method of
- 执行 ?
ValidateNonRevokedProxy (O)。 - 令 target 为 O.[[ProxyTarget]]。
- 令 handler 为 O.[[ProxyHandler]]。
- 断言：handler 是一个 Object。
- 令 trap 为 ?
GetMethod (handler,"defineProperty" )。 - 若 trap 为
undefined ，则- 返回 ? target.[[DefineOwnProperty]](P, Desc)。
- 令 descObj 为
FromPropertyDescriptor (Desc)。 - 令 booleanTrapResult 为
ToBoolean (? Call(trap, handler, « target, P, descObj »))。 - 若 booleanTrapResult 为
false ，返回false 。 - 令 targetDesc 为 ? target.[[GetOwnProperty]](P)。
- 令 extensibleTarget 为 ?
IsExtensible (target)。 - 若 Desc 含 [[Configurable]] 且 Desc.[[Configurable]] 为
false ，则- 令 settingConfigFalse 为
true 。
- 令 settingConfigFalse 为
- 否则，
- 令 settingConfigFalse 为
false 。
- 令 settingConfigFalse 为
- 若 targetDesc 为
undefined ，则- 若 extensibleTarget 为
false ，抛出TypeError 异常。 - 若 settingConfigFalse 为
true ，抛出TypeError 异常。
- 若 extensibleTarget 为
- 否则，
- 若
IsCompatiblePropertyDescriptor (extensibleTarget, Desc, targetDesc) 为false ，抛出TypeError 异常。 - 若 settingConfigFalse 为
true 且 targetDesc.[[Configurable]] 为true ，抛出TypeError 异常。 - 若
IsDataDescriptor (targetDesc) 为true 且 targetDesc.[[Configurable]] 为false 且 targetDesc.[[Writable]] 为true ，则- 若 Desc 含 [[Writable]] 且 Desc.[[Writable]] 为
false ，抛出TypeError 异常。
- 若 Desc 含 [[Writable]] 且 Desc.[[Writable]] 为
- 若
- 返回
true 。
Proxy 的 [[DefineOwnProperty]] 强制以下不变式：
- 结果为 Boolean。
- 若 target 不可扩展，不得添加新属性。
- 不得创建不可配置属性，除非 target 上已有对应不可配置自身属性。
- 不得创建既不可配置又不可写属性，除非 target 上已有对应不可配置且不可写自身属性。
- 若属性在 target 上已有对应属性，则用给定描述符通过 [[DefineOwnProperty]] 作用于 target 不会抛出异常。
10.5.7 [[HasProperty]] ( P )
The [[HasProperty]] internal method of
- 执行 ?
ValidateNonRevokedProxy (O)。 - 令 target 为 O.[[ProxyTarget]]。
- 令 handler 为 O.[[ProxyHandler]]。
- 断言：handler 是一个 Object。
- 令 trap 为 ?
GetMethod (handler,"has" )。 - 若 trap 为
undefined ，则- 返回 ? target.[[HasProperty]](P)。
- 令 booleanTrapResult 为
ToBoolean (? Call(trap, handler, « target, P »))。 - 若 booleanTrapResult 为
false ，则- 令 targetDesc 为 ? target.[[GetOwnProperty]](P)。
- 若 targetDesc 不为
undefined ，则- 若 targetDesc.[[Configurable]] 为
false ，抛出TypeError 异常。 - 令 extensibleTarget 为 ?
IsExtensible (target)。 - 若 extensibleTarget 为
false ，抛出TypeError 异常。
- 若 targetDesc.[[Configurable]] 为
- 返回 booleanTrapResult。
Proxy 的 [[HasProperty]] 强制以下不变式：
- 结果为 Boolean。
- 若 target 上存在不可配置自身属性，不得报告其不存在。
- 若 target 不可扩展且存在该自身属性，不得报告其不存在。
10.5.8 [[Get]] ( P, Receiver )
The [[Get]] internal method of
- 执行 ?
ValidateNonRevokedProxy (O)。 - 令 target 为 O.[[ProxyTarget]]。
- 令 handler 为 O.[[ProxyHandler]]。
- 断言：handler 是一个 Object。
- 令 trap 为 ?
GetMethod (handler,"get" )。 - 若 trap 为
undefined ，则- 返回 ? target.[[Get]](P, Receiver)。
- 令 trapResult 为 ? Call(trap, handler, « target, P, Receiver »)。
- 令 targetDesc 为 ? target.[[GetOwnProperty]](P)。
- 若 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]] ( P, V, Receiver )
The [[Set]] internal method of
- 执行 ?
ValidateNonRevokedProxy (O)。 - 令 target 为 O.[[ProxyTarget]]。
- 令 handler 为 O.[[ProxyHandler]]。
- 断言：handler 是一个 Object。
- 令 trap 为 ?
GetMethod (handler,"set" )。 - 若 trap 为
undefined ，则- 返回 ? target.[[Set]](P, V, Receiver)。
- 令 booleanTrapResult 为
ToBoolean (? Call(trap, handler, « target, P, V, Receiver »))。 - 若 booleanTrapResult 为
false ，返回false 。 - 令 targetDesc 为 ? target.[[GetOwnProperty]](P)。
- 若 targetDesc 不为
undefined 且 targetDesc.[[Configurable]] 为false ，则- 若
IsDataDescriptor (targetDesc) 为true 且 targetDesc.[[Writable]] 为false ，则- 若
SameValue (V, targetDesc.[[Value]]) 为false ，抛出TypeError 异常。
- 若
- 若
IsAccessorDescriptor (targetDesc) 为true ，则- 若 targetDesc.[[Set]] 为
undefined ，抛出TypeError 异常。
- 若 targetDesc.[[Set]] 为
- 若
- 返回
true 。
10.5.10 [[Delete]] ( P )
The [[Delete]] internal method of
- 执行 ?
ValidateNonRevokedProxy (O)。 - 令 target 为 O.[[ProxyTarget]]。
- 令 handler 为 O.[[ProxyHandler]]。
- 断言：handler 是一个 Object。
- 令 trap 为 ?
GetMethod (handler,"deleteProperty" )。 - 若 trap 为
undefined ，则- 返回 ? target.[[Delete]](P)。
- 令 booleanTrapResult 为
ToBoolean (? Call(trap, handler, « target, P »))。 - 若 booleanTrapResult 为
false ，返回false 。 - 令 targetDesc 为 ? target.[[GetOwnProperty]](P)。
- 若 targetDesc 为
undefined ，返回true 。 - 若 targetDesc.[[Configurable]] 为
false ，抛出TypeError 异常。 - 令 extensibleTarget 为 ?
IsExtensible (target)。 - 若 extensibleTarget 为
false ，抛出TypeError 异常。 - 返回
true 。
Proxy 的 [[Delete]] 强制以下不变式：
- 结果为 Boolean。
- 若属性在 target 上是不可配置自身属性，不得报告其已删除。
- 若属性在 target 上是自身属性且 target 不可扩展，不得报告其已删除。
10.5.11 [[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of
- 执行 ?
ValidateNonRevokedProxy (O)。 - 令 target 为 O.[[ProxyTarget]]。
- 令 handler 为 O.[[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 是
属性键 列表。 - 断言：targetKeys 不含重复项。
- 令 targetConfigurableKeys 为新空列表。
- 令 targetNonconfigurableKeys 为新空列表。
- 对 targetKeys 中每个元素 key：
- 令 desc 为 ? target.[[GetOwnProperty]](key)。
- 若 desc 不为
undefined 且 desc.[[Configurable]] 为false ，则- 将 key 追加至 targetNonconfigurableKeys。
- 否则，
- 将 key 追加至 targetConfigurableKeys。
- 若 extensibleTarget 为
true 且 targetNonconfigurableKeys 为空，则- 返回 trapResult。
- 令 uncheckedResultKeys 为包含 trapResult 各元素的新列表。
- 对 targetNonconfigurableKeys 中每个 key：
- 若 uncheckedResultKeys 不含 key，抛出
TypeError 异常。 - 从 uncheckedResultKeys 移除 key。
- 若 uncheckedResultKeys 不含 key，抛出
- 若 extensibleTarget 为
true ，返回 trapResult。 - 对 targetConfigurableKeys 中每个 key：
- 若 uncheckedResultKeys 不含 key，抛出
TypeError 异常。 - 从 uncheckedResultKeys 移除 key。
- 若 uncheckedResultKeys 不含 key，抛出
- 若 uncheckedResultKeys 非空，抛出
TypeError 异常。 - 返回 trapResult。
10.5.12 [[Call]] ( thisArgument, argumentsList )
The [[Call]] internal method of
- 执行 ?
ValidateNonRevokedProxy (O)。 - 令 target 为 O.[[ProxyTarget]]。
- 令 handler 为 O.[[ProxyHandler]]。
- 断言：handler 是一个 Object。
- 令 trap 为 ?
GetMethod (handler,"apply" )。 - 若 trap 为
undefined ，则- 返回 ? Call(target, thisArgument, argumentsList)。
- 令 argArray 为
CreateArrayFromList (argumentsList)。 - 返回 ? Call(trap, handler, « target, thisArgument, argArray »)。
仅当 [[ProxyTarget]] 初始值是一个具有 [[Call]] 内部方法的对象时，
10.5.13 [[Construct]] ( argumentsList, newTarget )
The [[Construct]] internal method of
- 执行 ?
ValidateNonRevokedProxy (O)。 - 令 target 为 O.[[ProxyTarget]]。
- 断言：
IsConstructor (target) 为true 。 - 令 handler 为 O.[[ProxyHandler]]。
- 断言：handler 是一个 Object。
- 令 trap 为 ?
GetMethod (handler,"construct" )。 - 若 trap 为
undefined ，则- 返回 ? Construct(target, argumentsList, newTarget)。
- 令 argArray 为
CreateArrayFromList (argumentsList)。 - 令 newObj 为 ? Call(trap, handler, « target, argArray, newTarget »)。
- 若 newObj
不是 Object ，抛出TypeError 异常。 - 返回 newObj。
仅当 [[ProxyTarget]] 初始值是一个具有 [[Construct]] 内部方法的对象时，
Proxy 的 [[Construct]] 强制以下不变式：
- 结果必须是一个 Object。
10.5.14 ValidateNonRevokedProxy ( proxy )
The abstract operation ValidateNonRevokedProxy takes argument proxy (a Proxy exotic object) and returns 返回一个包含
- 若 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 返回一个包含
- 若 target
不是 Object ，抛出TypeError 异常。 - 若 handler
不是 Object ，抛出TypeError 异常。 - 令 P 为
MakeBasicObject (« [[ProxyHandler]], [[ProxyTarget]] »)。 - 设置 P 的关键内部方法（除 [[Call]] 与 [[Construct]]）为
10.5 中的定义。 - 若
IsCallable (target) 为true ，则- 按
10.5.12 设置 P.[[Call]]。 - 若
IsConstructor (target) 为true ，则- 按
10.5.13 设置 P.[[Construct]]。
- 按
- 按
- 将 P.[[ProxyTarget]] 设为 target。
- 将 P.[[ProxyHandler]] 设为 handler。
- 返回 P。
11 ECMAScript 语言：源码文本 (ECMAScript Language: Source Text)
11.1 源码文本 (Source Text)
语法 (Syntax)
ECMAScript 源码文本 (ECMAScript source text) 是一串 Unicode 码点。所有从 U+0000 到 U+10FFFF 的 Unicode 码点值（包括代理项码点 surrogate code points）在 ECMAScript 语法允许的地方都可以出现在 ECMAScript 源码文本中。用于存储与交换 ECMAScript 源码文本的实际编码方式与本规范无关。无论外部源码的字符编码为何，符合规范的 ECMAScript 实现都按其等价的
组合字符序列 (combining character sequence) 的各组成部分被分别当作单独的 Unicode 码点对待，即便用户可能把整个序列视为一个字符。
在字符串字面量、正则表达式字面量、模板字面量与标识符中，任意 Unicode 码点也可以通过显式表示其数值的 Unicode 转义序列来书写。在注释中，这样的转义序列被视为注释的一部分而等效忽略。
在 Unicode 转义序列的行为上，ECMAScript 与 Java 编程语言不同。在 Java 程序中，如果 Unicode 转义序列 \u000A（例如）出现在单行注释内，它会被解释为行终止符（U+000A 是 LINE FEED (LF)），因此下一个码点不再属于该注释。同样地，如果 \u000A 出现在 Java 的字符串字面量中，它也被视为行终止符；行终止符不允许出现在字符串字面量内部——必须写作 \n 而不是 \u000A 才能使 LF 成为字符串值的一部分。在 ECMAScript 程序中，注释里的 Unicode 转义序列从不被解释，因此不会导致注释终止。类似地，ECMAScript 程序中字符串字面量里的 Unicode 转义序列始终贡献其字面意义，绝不会被解释成行终止符或可能终止字符串字面量的码点。
11.1.1 静态语义：UTF16EncodeCodePoint ( cp )
The abstract operation
11.1.2 静态语义：CodePointsToString ( text )
The abstract operation
- 令 result 为空字符串。
- 对 text 的每个码点 cp，执行
- 将 result 设为 result 与 UTF16EncodeCodePoint(cp) 的字符串连接。
- 返回 result。
11.1.3 静态语义：UTF16SurrogatePairToCodePoint ( lead, trail )
The abstract operation
- 断言：lead 是
前导代理 项 (leading surrogate) 且 trail 是尾随代理项 (trailing surrogate)。 - 令 cp 为 (lead - 0xD800) × 0x400 + (trail - 0xDC00) + 0x10000。
- 返回码点 cp。
11.1.4 静态语义：CodePointAt ( string, position )
The abstract operation
- 令 size 为 string 的长度。
- 断言：position ≥ 0 且 position < size。
- 令 first 为 string 中索引 position 的代码单元。
- 令 cp 为数值等于 first 数值的码点。
- 若 first 既不是
前导代理 项也不是尾随代理项，则- 返回
Record { [[CodePoint]]: cp, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]:false }。
- 返回
- 若 first 是尾随代理项或 position + 1 = size，则
- 返回
Record { [[CodePoint]]: cp, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]:true }。
- 返回
- 令 second 为 string 中索引 position + 1 的代码单元。
- 若 second 不是尾随代理项，则
- 返回
Record { [[CodePoint]]: cp, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]:true }。
- 返回
- 将 cp 设为 UTF16SurrogatePairToCodePoint(first, second)。
- 返回
Record { [[CodePoint]]: cp, [[CodeUnitCount]]: 2, [[IsUnpairedSurrogate]]:false }。
11.1.5 静态语义：StringToCodePoints ( string )
The abstract operation
- 令 codePoints 为一个新的空
List 。 - 令 size 为 string 的长度。
- 令 position 为 0。
- 当 position < size 循环：
- 令 cp 为 CodePointAt(string, position)。
- 将 cp.[[CodePoint]] 追加到 codePoints。
- 将 position 设为 position + cp.[[CodeUnitCount]]。
- 返回 codePoints。
11.1.6 静态语义：ParseText ( sourceText, goalSymbol )
The abstract operation
- 若 sourceText 是 String，则将 sourceText 设为 StringToCodePoints(sourceText)。
- 试图以 goalSymbol 为
目标符号 解析 sourceText，并分析解析结果中的任何提前错误 (early error) 条件。解析与提前错误检测可按实现自定义 方式交错进行。 - 若解析成功且未发现提前错误，返回解析生成的 parse tree 根部的 Parse Node（goalSymbol 的一个实例）。
- 否则，返回一个包含一个或多个
SyntaxError 对象的List ，表示语法错误和/或提前错误。若存在多个错误，其数量与顺序由实现定义，但至少要有一个。
考虑某段文本在某处有一个提前错误，在其后又有语法错误。一个先解析后检测提前错误的实现可能只报告语法错误而未继续提前错误阶段。一个交错实现可能报告提前错误而不再寻找语法错误。第三种实现可能两者都报告。以上行为都符合规范。
另见
11.2 源码类型 (Types of Source Code)
ECMAScript 代码有四种类型：
-
全局代码 (Global code) 是作为 ECMAScript
Script 处理的源码文本。某个Script 的全局代码不包含被解析为FunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 、AsyncArrowFunction 、ClassDeclaration 或ClassExpression 的任何源码。 -
Eval 代码 (Eval code) 是传给内置
eval函数的源码文本。更精确地说，如果传给内置eval的参数是 String，则其被视作 ECMAScriptScript 。一次特定eval调用的 eval 代码即该Script 的全局代码部分。 -
函数代码 (Function code) 是被解析以提供 ECMAScript
函数对象 [[ECMAScriptCode]] 与 [[FormalParameters]] 内部槽（见10.2 ）值的源码。某个函数的函数代码不包含被解析为内嵌FunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 、AsyncArrowFunction 、ClassDeclaration 或ClassExpression 的源码。此外，如果上述引用的源码被解析为：
FunctionDeclaration 或FunctionExpression 的FormalParameters 与FunctionBody ，GeneratorDeclaration 或GeneratorExpression 的FormalParameters 与GeneratorBody ，AsyncFunctionDeclaration 或AsyncFunctionExpression 的FormalParameters 与AsyncFunctionBody ，或AsyncGeneratorDeclaration 或AsyncGeneratorExpression 的FormalParameters 与AsyncGeneratorBody ，
则该声明或表达式的
BindingIdentifier （若存在）所匹配的源码文本也包含在对应函数的函数代码中。 -
模块代码 (Module code) 是作为
ModuleBody 提供的源码文本。它是在模块初始化时被直接求值的代码。某个模块的模块代码不包含被解析为内嵌FunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 、AsyncArrowFunction 、ClassDeclaration 或ClassExpression 的源码。
将
11.2.1 指令序言与 Use Strict 指令 (Directive Prologues and the Use Strict Directive)
指令序言 (Directive Prologue) 是出现在
Use Strict 指令 (Use Strict Directive) 是指令序言中的一个 "use strict" 或 'use strict'。Use Strict 指令不允许包含
指令序言可包含多个 Use Strict 指令；实现可以在发生这种情况时发出警告。
指令序言中的
11.2.2 严格模式代码 (Strict Mode Code)
一个 ECMAScript 语法单元可以用不受限模式或严格模式语法与语义处理 (
- 若全局代码以包含 Use Strict 指令的指令序言开始，则该全局代码为严格模式代码。
- 模块代码始终是严格模式代码。
-
ClassDeclaration 或ClassExpression 的所有部分都是严格模式代码。 -
若 eval 代码以包含 Use Strict 指令的指令序言开始，或对
eval的直接调用位于严格模式代码中，则该 eval 代码为严格模式代码。 -
若关联的
FunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 或AsyncArrowFunction 处于严格模式代码中，或其 [[ECMAScriptCode]] 内部槽值所来源的代码以包含 Use Strict 指令的指令序言开始，则函数代码为严格模式代码。 -
若作为内置 Function、Generator、AsyncFunction、AsyncGenerator 构造器的参数提供的函数代码的最后一个参数是 String，且其作为
FunctionBody 处理后以包含 Use Strict 指令的指令序言开始，则该函数代码为严格模式代码。
不是严格模式代码的 ECMAScript 代码称为 非严格代码 (non-strict code)。
11.2.2.1 静态语义：IsStrict ( node )
The abstract operation
- 若 node 匹配的源码文本是严格模式代码，返回
true ；否则返回false 。
11.2.3 非 ECMAScript 函数 (Non-ECMAScript Functions)
ECMAScript 实现可以支持求值其执行行为以
12 ECMAScript 语言：词法语法 (ECMAScript Language: Lexical Grammar)
ECMAScript
在若干情形下，词法输入元素的识别会对消费这些输入元素的句法语法上下文敏感，因此词法语法需要多个
使用多个词法目标可确保不存在会影响自动分号插入的词法二义性。例如，没有任何句法语境同时允许以除法或除法赋值开头以及以
a = b
/hi/g.exec(c).map(d);当一个
a = b / hi / g.exec(c).map(d);Syntax
12.1 Unicode 格式控制字符 (Unicode Format-Control Characters)
Unicode 格式控制字符（即 Unicode 字符数据库中类别 “Cf” 的字符，例如 LEFT-TO-RIGHT MARK 或 RIGHT-TO-LEFT MARK）是用于在缺乏更高层协议（如标记语言）时控制一段文本排版的控制码。
允许在源码文本中使用格式控制字符有助于编辑与显示。所有格式控制字符可出现在注释中，以及字符串字面量、模板字面量和正则表达式字面量中。
U+FEFF (ZERO WIDTH NO-BREAK SPACE) 是一种主要用于文本开头以标记其为 Unicode 并允许检测编码与字节序的格式控制字符。用于该目的的 <ZWNBSP> 字符有时也可能在文本开头之后出现，例如连接文件的结果。在 ECMAScript 源码文本中，除注释、字符串字面量、模板字面量和正则表达式字面量外，<ZWNBSP> 码点被视为空白字符（见
12.2 空白 (White Space)
空白码点用于提升源码可读性并分隔记号（不可再分的词法单元），除此之外没有意义。空白码点可出现在任意两个记号之间以及输入开头或结尾。空白码点可出现在
ECMAScript 的空白码点列于
| Code Points | 名称 (Name) | 缩写 (Abbreviation) |
|---|---|---|
U+0009
|
CHARACTER TABULATION | <TAB> |
U+000B
|
LINE TABULATION | <VT> |
U+000C
|
FORM FEED (FF) | <FF> |
U+FEFF
|
ZERO WIDTH NO-BREAK SPACE | <ZWNBSP> |
| any code point in general category “Space_Separator” | <USP> |
U+0020 (SPACE) 与 U+00A0 (NO-BREAK SPACE) 码点属于 <USP>。
除
Syntax
12.3 行终止符 (Line Terminators)
与空白码点类似，行终止符码点用于提升源码可读性并分隔记号。但与空白码点不同，行终止符会对句法语法行为产生影响。一般而言，行终止符可出现在任意两个记号之间，但也有少数位置为句法语法所禁止。行终止符还影响自动分号插入过程（见
行终止符包含在正则表达式 \s 类所匹配的空白码点集合中。
ECMAScript 行终止符码点列于
| Code Point | Unicode 名称 (Unicode Name) | 缩写 (Abbreviation) |
|---|---|---|
U+000A
|
LINE FEED (LF) | <LF> |
U+000D
|
CARRIAGE RETURN (CR) | <CR> |
U+2028
|
LINE SEPARATOR | <LS> |
U+2029
|
PARAGRAPH SEPARATOR | <PS> |
只有
Syntax
12.4 注释 (Comments)
注释可以是单行或多行。多行注释不能嵌套。
由于单行注释可包含除 // 标记到该行末端的全部码点。然而，行末的
注释的行为类似空白并被丢弃；但若
Syntax
本节若干产生式在
12.5 Hashbang 注释 (Hashbang Comments)
Hashbang 注释对位置敏感，并且与其它类型注释一样从句法语法的输入元素流中被丢弃。
Syntax
12.6 记号 (Tokens)
Syntax
12.7 名称与关键字 (Names and Keywords)
本标准特别增加：U+0024 (DOLLAR SIGN) 与 U+005F (LOW LINE) 可在
Syntax
非终结符
非终结符 _。
具有 Unicode 属性 “ID_Start” 与 “ID_Continue” 的码点集合分别包含具有 “Other_ID_Start” 与 “Other_ID_Continue” 属性的码点。
12.7.1 标识符名称 (Identifier Names)
\ 不贡献码点。\
两个根据 Unicode 标准规范等价的
12.7.1.1 静态语义：早期错误 (Static Semantics: Early Errors)
-
若
UnicodeEscapeSequence 的 IdentifierCodePoint 不是IdentifierStartChar 词法产生式匹配的某个 Unicode 码点，则为语法错误。
-
若
UnicodeEscapeSequence 的 IdentifierCodePoint 不是IdentifierPartChar 词法产生式匹配的某个 Unicode 码点，则为语法错误。
12.7.1.2 静态语义：IdentifierCodePoints
The syntax-directed operation
- 令 cp 为
IdentifierStart 的 IdentifierCodePoint。 - 返回 « cp »。
- 令 cps 为所派生
IdentifierName 的 IdentifierCodePoints。 - 令 cp 为
IdentifierPart 的 IdentifierCodePoint。 - 返回 cps 与 « cp » 的列表连接。
12.7.1.3 静态语义：IdentifierCodePoint
The syntax-directed operation
- 返回
IdentifierStartChar 匹配的码点。
- 返回
IdentifierPartChar 匹配的码点。
- 返回数值为
Hex4Digits 的 MV 的码点。
- 返回数值为
CodePoint 的 MV 的码点。
12.7.2 关键字与保留字 (Keywords and Reserved Words)
关键字 (keyword) 是匹配 if、while、async、await 等。
保留字 (reserved word) 是不能用作标识符的 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。
条件关键字 (conditional keyword) 或 上下文关键字 (contextual keyword) 常用于指代后三类，它们在某些上下文可作标识符，在另一些上下文作关键字。
Syntax
依据 \
\ els\u{65} 来声明名为 “else” 的变量。
enum 当前尚未作为关键字使用。它是一个未来保留字，为未来语言扩展保留。
同样地，implements、interface、package、private、protected、public 在严格模式中是未来保留字。
12.8 标点符号 (Punctuators)
Syntax
12.9 字面量 (Literals)
12.9.1 Null 字面量 (Null Literals)
Syntax
12.9.2 布尔字面量 (Boolean Literals)
Syntax
12.9.3 数值字面量 (Numeric Literals)
Syntax
例如：3in 是错误，而不是两个输入元素 3 与 in。
12.9.3.1 静态语义：早期错误 (Static Semantics: Early Errors)
- 若 IsStrict(this production) 为
true 则为语法错误。
12.9.3.2 静态语义：MV (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 同上。 -
DecimalLiteral :: . DecimalDigits ExponentPart DecimalDigits 的 MV × 10e - n，n 同上，e 为ExponentPart 的 MV。 -
DecimalLiteral :: DecimalIntegerLiteral ExponentPart DecimalIntegerLiteral 的 MV × 10e。 -
DecimalIntegerLiteral :: 0 -
DecimalIntegerLiteral :: NonZeroDigit NumericLiteralSeparator opt DecimalDigits NonZeroDigit 的 MV × 10n) +DecimalDigits 的 MV，n 同上。 -
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 -
OctalDigits :: OctalDigits OctalDigit OctalDigits 的 MV × 8) +OctalDigit 的 MV。 -
OctalDigits :: OctalDigits NumericLiteralSeparator OctalDigit -
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
12.9.3.3 静态语义：NumericValue
The syntax-directed operation
- 返回
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 字符串字面量 (String Literals)
字符串字面量是 0 个或更多 Unicode 码点，被单引号或双引号包围。Unicode 码点也可用转义序列表达。除闭合引号码点、U+005C (REVERSE SOLIDUS)、U+000D (CARRIAGE RETURN)、U+000A (LINE FEED) 外，所有码点都可直接出现在字符串字面量中。任何码点都可以转义形式出现。字符串字面量求值为 ECMAScript String 值。生成这些 String 值时 Unicode 码点按
Syntax
非终结符
<LF> 与 <CR> 不能出现在字符串字面量中，除非作为 \n 或 \u000A 等转义序列。
12.9.4.1 静态语义：早期错误 (Static Semantics: Early Errors)
- 若 IsStrict(this production) 为
true 则为语法错误。
字符串字面量可能位于使封闭代码进入
function invalid() { "\7"; "use strict"; }12.9.4.2 静态语义：SV
The syntax-directed operation
字符串字面量表示
-
StringLiteral :: " " -
StringLiteral :: ' ' -
DoubleStringCharacters :: DoubleStringCharacter DoubleStringCharacters DoubleStringCharacter 的 SV 与DoubleStringCharacters 的 SV 的字符串连接。 -
SingleStringCharacters :: SingleStringCharacter SingleStringCharacters -
DoubleStringCharacter :: SourceCharacter but not one of " or\ orLineTerminator SourceCharacter 匹配码点执行 UTF16EncodeCodePoint 的结果。 -
DoubleStringCharacter :: <LS> -
DoubleStringCharacter :: <PS> -
DoubleStringCharacter :: LineContinuation -
SingleStringCharacter :: SourceCharacter but not one of ' or\ orLineTerminator -
SingleStringCharacter :: <LS> -
SingleStringCharacter :: <PS> -
SingleStringCharacter :: LineContinuation -
EscapeSequence :: 0 -
CharacterEscapeSequence :: SingleEscapeCharacter Table 35 中确定数值的代码单元。
| 转义序列 (Escape Sequence) | 代码单元值 (Code Unit Value) | Unicode 字符名 (Unicode Character Name) | 符号 (Symbol) |
|---|---|---|---|
\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 -
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 静态语义：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 正则表达式字面量 (Regular Expression Literals)
下列产生式描述正则表达式字面量的语法，供输入元素扫描器定位字面量结束。由
实现可扩展
Syntax
正则字面量不能为空；序列 // 表示单行注释而不是空正则。若需空正则，使用 /(?:)/。
12.9.5.1 静态语义：BodyText
The syntax-directed operation
- 返回识别为
RegularExpressionBody 的源码文本。
12.9.5.2 静态语义：FlagText
The syntax-directed operation
- 返回识别为
RegularExpressionFlags 的源码文本。
12.9.6 模板字面量词法组件 (Template Literal Lexical Components)
Syntax
12.9.6.1 静态语义：TV
The syntax-directed operation
-
NoSubstitutionTemplate :: ` ` -
TemplateHead :: ` ${ -
TemplateMiddle :: } ${ -
TemplateTail :: } ` -
TemplateCharacters :: TemplateCharacter TemplateCharacters undefined 则为undefined ；否则为二者字符串连接。 -
TemplateCharacter :: SourceCharacter but not one of ` or\ or$ orLineTerminator -
TemplateCharacter :: $ -
TemplateCharacter :: \ TemplateEscapeSequence TemplateEscapeSequence 的 SV。 -
TemplateCharacter :: \ NotEscapeSequence undefined 。 -
TemplateCharacter :: LineTerminatorSequence LineTerminatorSequence 的 TRV。 -
LineContinuation :: \ LineTerminatorSequence
12.9.6.2 静态语义：TRV
The syntax-directed operation
-
NoSubstitutionTemplate :: ` ` -
TemplateHead :: ` ${ -
TemplateMiddle :: } ${ -
TemplateTail :: } ` -
TemplateCharacters :: TemplateCharacter TemplateCharacters -
TemplateCharacter :: SourceCharacter but not one of ` or\ or$ orLineTerminator -
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 的连接。 -
NotEscapeSequence :: u HexDigit HexDigit HexDigit [lookahead ∉ HexDigit ]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 -
CharacterEscapeSequence :: NonEscapeCharacter NonEscapeCharacter 的 SV。 -
SingleEscapeCharacter :: one of ' " \ b f n r t v -
HexEscapeSequence :: x HexDigit HexDigit HexDigit TRV 的连接。 -
UnicodeEscapeSequence :: u Hex4Digits Hex4Digits TRV 的连接。 -
UnicodeEscapeSequence :: u{ CodePoint } CodePoint TRV、0x007D 的连接。 -
Hex4Digits :: HexDigit HexDigit HexDigit HexDigit 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 -
LineContinuation :: \ LineTerminatorSequence LineTerminatorSequence TRV 连接。 -
LineTerminatorSequence :: <LF> -
LineTerminatorSequence :: <CR> -
LineTerminatorSequence :: <LS> -
LineTerminatorSequence :: <PS> -
LineTerminatorSequence :: <CR> <LF>
TV 不包含
12.10 自动分号插入 (Automatic Semicolon Insertion)
大多数 ECMAScript 语句与声明必须以分号结束。此类分号可在源码中显式出现。为方便起见，在某些情形下可以省略；在这些情形中，认为分号被自动插入到源码记号流中。
12.10.1 自动分号插入的规则 (Rules of Automatic Semicolon Insertion)
下列规则中，“token” 指根据
分号插入有三条基本规则：
-
当从左到右解析源码时遇到一个不被任何语法产生式允许的记号（称为 违规记号 (offending token)）时，如果满足以下任一条件，则在其前自动插入分号：
-
违规记号与前一个记号之间至少有一个
LineTerminator 。 -
违规记号是
}。 -
前一个记号是
)，且插入的分号会被解析为 do-while 语句（14.7.2 ）的结束分号。
-
违规记号与前一个记号之间至少有一个
- 当从左到右解析时，如果到达输入记号流末尾且解析器无法将其解析为目标非终结符的单一实例，则在末尾自动插入分号。
-
当从左到右解析时遇到的记号在某个产生式中被允许，但该产生式是受限产生式 (restricted production) 且该记号将成为紧随 “[no
LineTerminator here]” 注解之后的终结符或非终结符的首记号（故称为受限记号），且受限记号与前一记号之间至少有一个LineTerminator ，则在该受限记号前自动插入分号。
然而，上述规则受一个额外for 语句（见
以下是语法中唯一的受限产生式：
这些受限产生式的实际效果：
-
当遇到可被解析为后缀
++或--运算符的记号，且其与前一记号之间至少有一个LineTerminator ，则在该运算符前自动插入分号。 -
当遇到
continue、break、return、throw或yield，且其后一个记号前存在LineTerminator ，则在该关键字后自动插入分号。 -
当箭头函数参数后紧跟的
=>前出现LineTerminator 时，自动插入分号并导致该=>处语法错误。 -
当
async后在期望的function、IdentifierName 或(之前出现LineTerminator ，自动插入分号且后续不再与该async归为同一表达式或类元素。 -
当
async后在期望的*之前出现LineTerminator ，自动插入分号并导致该标点语法错误。
对程序员的实践建议：
-
后缀
++/--应与其操作数位于同一行。 -
return、throw语句中的Expression 或yield表达式中的AssignmentExpression 应与关键字位于同一行。 -
break、continue语句中的LabelIdentifier 应与各自关键字在同一行。 -
箭头函数参数部分结尾与
=>应位于同一行。 -
异步函数或方法前的
async应与紧随其后的记号在同一行。
12.10.2 自动分号插入示例 (Examples of Automatic Semicolon Insertion)
本节为非规范性内容。源码
{ 1 2 } 3即便考虑自动分号插入规则，也不是有效 ECMAScript 语句。相比之下，源码
{ 1
2 } 3也不是有效语句，但会被自动分号插入转换为：
{ 1
;2 ;} 3;其为有效语句。
源码
for (a; b
)不是有效语句，且不会被修改，因为分号对 for 头部必要；自动分号插入不会插入 for 头部的两个分号之一。
源码
return
a + b被转换为：
return;
a + b;a + b 不作为 return 语句返回值，因为 return 分隔。
源码
a = b
++c转换为：
a = b;
++c;++ 不作为应用于 b 的后缀运算符，因为 b 与 ++ 之间存在
源码
if (a > b)
else c = d不是有效语句，且在 else 前不会自动插入分号，即便此处没有适用的语法产生式，因为插入分号会形成空语句。
源码
a = b + c
(d + e).print()不会 被转换，因为第二行以括号表达式开始可被解释为函数调用的实参列表：
a = b + c(d + e).print()若赋值语句必须以左括号开始，建议在前一语句末尾显式写分号，而不是依赖自动分号插入。
12.10.3 自动分号插入的有趣情形 (Interesting Cases of Automatic Semicolon Insertion)
本节为非规范性内容。ECMAScript 程序可以通过依赖自动分号插入以极少分号的风格编写。如前述，分号不会在每个换行处插入，并且插入可能依赖跨行的多个记号。
随着新语法特性的加入，可能增加新的产生式，使之前依赖自动分号插入的行在解析时改变其产生式。
本节中，若某处是否插入分号取决于其前源码，则视为“有趣”情形。剩余内容描述本版本 ECMAScript 中若干此类情形。
12.10.3.1 语句列表中的自动分号插入有趣情形 (Interesting Cases ... in Statement Lists)
在
- 左括号 (
()。缺少分号会将两行合并为CallExpression 。 - 左方括号 (
[)。缺少分号会解析为属性访问而非ArrayLiteral 或ArrayAssignmentPattern 。 - 模板字面量 (
`)。缺少分号会合并为带前一个表达式为MemberExpression 的标签模板（13.3.11 ）。 - 一元
+或-。缺少分号会被解释为相应二元运算的一部分。 - 正则表达式字面量。缺少分号时，若正则含标志，可能被解析为
/MultiplicativeOperator 。
12.10.3.2 与 “[no LineTerminator here]” 相关的自动分号插入情形 (Cases ... “[no LineTerminator here]”)
本节为非规范性内容。
ECMAScript 包含含 “[no
本节其余内容描述本版本中使用 “[no
12.10.3.2.1 含可选操作数与 “[no LineTerminator here]” 的产生式列表
UpdateExpression 。ContinueStatement 。BreakStatement 。ReturnStatement 。YieldExpression 。- 异步函数定义（
15.8 ）与函数定义（15.2 ）的关系。
13 ECMAScript 语言：表达式 (ECMAScript Language: Expressions)
13.1 标识符 (Identifiers)
语法 (Syntax)
yield 与 await 在语法中被允许作为
let
await 0;13.1.1 静态语义：早期错误 (Static Semantics: Early Errors)
-
若 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 等于某ReservedWord 的 StringValue 且该ReservedWord 不是yield或await，则为语法错误。
13.1.2 静态语义：StringValue
The syntax-directed operation
- 令 idTextUnescaped 为
IdentifierName 的 IdentifierCodePoints。 - 返回 CodePointsToString(idTextUnescaped)。
- 返回
"yield" 。
- 返回
"await" 。
- 返回
IdentifierName 的 StringValue。
- 返回 0x0023 (NUMBER SIGN) 与
IdentifierName 的 StringValue 的字符串连接。
- 返回
StringLiteral 的 SV。
13.1.3 运行时语义：求值 (Runtime Semantics: Evaluation)
- 返回 ?
ResolveBinding (StringValue ofIdentifier )。
- 返回 ?
ResolveBinding ("yield" )。
- 返回 ?
ResolveBinding ("await" )。
对一个
在非严格代码中，关键字 yield 可以作为标识符使用。对该 yield 的绑定，好像它是一个普通
13.2 基础表达式 (Primary Expression)
语法 (Syntax)
补充语法 (Supplemental Syntax)
当处理产生式实例：
时，使用如下语法细化对
13.2.1 this 关键字 (The this Keyword)
13.2.1.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 返回 ?
ResolveThisBinding ()。
13.2.2 标识符引用 (Identifier Reference)
关于
13.2.3 字面量 (Literals)
语法 (Syntax)
13.2.3.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 返回
null 。
- 若
BooleanLiteral 为记号false，返回false 。 - 若
BooleanLiteral 为记号true，返回true 。
- 返回
12.9.3 中定义的NumericLiteral 的 NumericValue。
- 返回
12.9.4.2 中定义的StringLiteral 的 SV。
13.2.4 数组初始化器 (Array Initializer)
数组元素可在列表的开头、中间或结尾省略。若元素列表中的一个逗号未被
语法 (Syntax)
13.2.4.1 运行时语义：ArrayAccumulation : 返回一个含整数的正常完成或一个突然完成
The syntax-directed operation UNKNOWN takes UNPARSEABLE ARGUMENTS. It is defined piecewise over the following productions:
- 返回 ? ArrayAccumulation of
Elision with arguments array and (nextIndex + 1)。
- 若存在
Elision ，则- 将 nextIndex 设为 ? ArrayAccumulation of
Elision ，参数 array 与 nextIndex。
- 将 nextIndex 设为 ? ArrayAccumulation of
- 令 initResult 为 ? Evaluation of
AssignmentExpression 。 - 令 initValue 为 ?
GetValue (initResult)。 - 执行 !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (nextIndex)), initValue)。 - 返回 nextIndex + 1。
- 若存在
Elision ，则- 将 nextIndex 设为 ? ArrayAccumulation of
Elision ，参数 array 与 nextIndex。
- 将 nextIndex 设为 ? ArrayAccumulation of
- 返回 ? ArrayAccumulation of
SpreadElement ，参数 array 与 nextIndex。
- 将 nextIndex 设为 ? ArrayAccumulation of
ElementList ，参数 array 与 nextIndex。 - 若存在
Elision ，则- 将 nextIndex 设为 ? ArrayAccumulation of
Elision ，参数 array 与 nextIndex。
- 将 nextIndex 设为 ? ArrayAccumulation of
- 令 initResult 为 ? Evaluation of
AssignmentExpression 。 - 令 initValue 为 ?
GetValue (initResult)。 - 执行 !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (nextIndex)), initValue)。 - 返回 nextIndex + 1。
- 将 nextIndex 设为 ? ArrayAccumulation of
ElementList ，参数 array 与 nextIndex。 - 若存在
Elision ，则- 将 nextIndex 设为 ? ArrayAccumulation of
Elision ，参数 array 与 nextIndex。
- 将 nextIndex 设为 ? ArrayAccumulation of
- 返回 ? ArrayAccumulation of
SpreadElement ，参数 array 与 nextIndex。
- 令 spreadRef 为 ? Evaluation of
AssignmentExpression 。 - 令 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 ，则- 执行 ? ArrayAccumulation of
Elision ，参数 array 与 0。
- 执行 ? ArrayAccumulation of
- 返回 array。
- 令 array 为 !
ArrayCreate (0)。 - 执行 ? ArrayAccumulation of
ElementList ，参数 array 与 0。 - 返回 array。
- 令 array 为 !
ArrayCreate (0)。 - 令 nextIndex 为 ? ArrayAccumulation of
ElementList ，参数 array 与 0。 - 若存在
Elision ，则- 执行 ? ArrayAccumulation of
Elision ，参数 array 与 nextIndex。
- 执行 ? ArrayAccumulation of
- 返回 array。
13.2.5 对象初始化器 (Object Initializer)
对象初始化器是描述对象初始化的表达式，其形式类似字面量。它是零个或多个
语法 (Syntax)
在某些上下文中，
13.2.5.1 静态语义：早期错误 (Static Semantics: Early Errors)
-
若 HasDirectSuper(
MethodDefinition ) 为true 则为语法错误。 -
若
MethodDefinition 的 PrivateBoundIdentifiers 非空则为语法错误。
除了描述实际对象初始化器，
- 若有源码匹配该产生式则为语法错误。
该产生式存在是为了让
-
若
PropertyDefinitionList 的 PropertyNameList 含有"__proto__" 的重复条目，且其中至少两个来自形如PropertyDefinition : PropertyName : AssignmentExpression ObjectLiteral 位于为ParseJSON 解析的Script 中（见ParseJSON 的3 步骤），不适用此规则。
PropertyNameList 返回的列表不包含通过
13.2.5.2 静态语义：IsComputedPropertyKey
The syntax-directed operation
- 返回
false 。
- 返回
true 。
13.2.5.3 静态语义：PropertyNameList
The syntax-directed operation
- 令 propName 为
PropertyDefinition 的 PropName。 - 若 propName 为
empty ，返回空新列表。 - 返回 « propName »。
- 令 list 为
PropertyDefinitionList 的 PropertyNameList。 - 令 propName 为
PropertyDefinition 的 PropName。 - 若 propName 为
empty ，返回 list。 - 返回 list 与 « propName » 的列表连接。
13.2.5.4 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 obj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 ? PropertyDefinitionEvaluation of
PropertyDefinitionList ，参数 obj。 - 返回 obj。
- 返回
IdentifierName 的 StringValue。
- 返回
StringLiteral 的 SV。
- 令 nbr 为
NumericLiteral 的 NumericValue。 - 返回 !
ToString (nbr)。
- 令 exprValue 为 ? Evaluation of
AssignmentExpression 。 - 令 propName 为 ?
GetValue (exprValue)。 - 返回 ?
ToPropertyKey (propName)。
13.2.5.5 运行时语义：PropertyDefinitionEvaluation : 返回含 unused 的正常完成或一个突然完成
The syntax-directed operation UNKNOWN takes UNPARSEABLE ARGUMENTS. It is defined piecewise over the following productions:
- 执行 ? PropertyDefinitionEvaluation of
PropertyDefinitionList ，参数 object。 - 执行 ? PropertyDefinitionEvaluation of
PropertyDefinition ，参数 object。 - 返回
unused 。
- 令 exprValue 为 ? Evaluation of
AssignmentExpression 。 - 令 fromValue 为 ?
GetValue (exprValue)。 - 令 excludedNames 为新空列表。
- 执行 ?
CopyDataProperties (object, fromValue, excludedNames)。 - 返回
unused 。
- 令 propName 为
IdentifierReference 的 StringValue。 - 令 exprValue 为 ? Evaluation of
IdentifierReference 。 - 令 propValue 为 ?
GetValue (exprValue)。 - 断言：object 是普通、可扩展且无不可配置属性的对象。
- 执行 !
CreateDataPropertyOrThrow (object, propName, propValue)。 - 返回
unused 。
- 令 propKey 为 ? Evaluation of
PropertyName 。 - 若此
PropertyDefinition 位于为ParseJSON 求值的Script 中（见ParseJSON 的6 步骤），则- 令 isProtoSetter 为
false 。
- 令 isProtoSetter 为
- 否则若 propKey 为
"__proto__" 且 IsComputedPropertyKey(PropertyName ) 为false ，则- 令 isProtoSetter 为
true 。
- 令 isProtoSetter 为
- 否则，
- 令 isProtoSetter 为
false 。
- 令 isProtoSetter 为
- 若 IsAnonymousFunctionDefinition(
AssignmentExpression ) 为true 且 isProtoSetter 为false ，则- 令 propValue 为 ? NamedEvaluation of
AssignmentExpression ，参数 propKey。
- 令 propValue 为 ? NamedEvaluation of
- 否则，
- 令 exprValueRef 为 ? Evaluation of
AssignmentExpression 。 - 令 propValue 为 ?
GetValue (exprValueRef)。
- 令 exprValueRef 为 ? Evaluation of
- 若 isProtoSetter 为
true ，则- 若 propValue
是 Object 或 propValue 为null ，则- 执行 ! object.[[SetPrototypeOf]](propValue)。
- 返回
unused 。
- 若 propValue
- 断言：object 是普通、可扩展且无不可配置属性的对象。
- 执行 !
CreateDataPropertyOrThrow (object, propKey, propValue)。 - 返回
unused 。
- 执行 ? MethodDefinitionEvaluation of
MethodDefinition ，参数 object 和true 。 - 返回
unused 。
13.2.6 定义函数的表达式 (Function Defining Expressions)
见
见
见
见
13.2.7 正则表达式字面量 (Regular Expression Literals)
语法 (Syntax)
见
13.2.7.1 静态语义：早期错误 (Static Semantics: Early Errors)
-
若 IsValidRegularExpressionLiteral(
RegularExpressionLiteral ) 为false 则为语法错误。
13.2.7.2 静态语义：IsValidRegularExpressionLiteral ( literal )
The abstract operation
- 令 flags 为 literal 的 FlagText。
- 若 flags 含有除
d、g、i、m、s、u、v、y之外任意码点，或某码点出现多次，返回false 。 - 若 flags 含
u，设 u 为true ；否则false 。 - 若 flags 含
v，设 v 为true ；否则false 。 - 令 patternText 为 literal 的 BodyText。
- 若 u 为
false 且 v 为false ，则- 令 stringValue 为 CodePointsToString(patternText)。
- 将 patternText 设为解释 stringValue 的每个 16 位元素为 Unicode BMP 码点后的码点序列（不执行 UTF-16 解码组合）。
- 令 parseResult 为 ParsePattern(patternText, u, v)。
- 若 parseResult 是 Parse Node，返回
true ；否则返回false 。
13.2.7.3 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 pattern 为 CodePointsToString(BodyText of
RegularExpressionLiteral )。 - 令 flags 为 CodePointsToString(FlagText of
RegularExpressionLiteral )。 - 返回 !
RegExpCreate (pattern, flags)。
13.2.8 模板字面量 (Template Literals)
语法 (Syntax)
13.2.8.1 静态语义：早期错误 (Static Semantics: Early Errors)
-
若未设置 [Tagged] 参数且
NoSubstitutionTemplate ContainsNotEscapeSequence ，则为语法错误。
-
若以
false 为参数的TemplateLiteral 的 TemplateStrings 中元素数 ≥ 232，则为语法错误。
-
若未设置 [Tagged] 参数且
TemplateHead ContainsNotEscapeSequence ，则为语法错误。
-
若未设置 [Tagged] 参数且
TemplateTail ContainsNotEscapeSequence ，则为语法错误。
-
若未设置 [Tagged] 参数且
TemplateMiddle ContainsNotEscapeSequence ，则为语法错误。
13.2.8.2 静态语义：TemplateStrings : 一个由 String 或 undefined 组成的列表
The syntax-directed operation UNKNOWN takes UNPARSEABLE ARGUMENTS. It is defined piecewise over the following productions:
- 返回 « TemplateString(
NoSubstitutionTemplate , raw) »。
- 令 head 为 « TemplateString(
TemplateHead , raw) »。 - 令 tail 为
TemplateSpans 的 TemplateStrings，参数 raw。 - 返回 head 与 tail 的列表连接。
- 返回 « TemplateString(
TemplateTail , raw) »。
- 令 middle 为
TemplateMiddleList 的 TemplateStrings，参数 raw。 - 令 tail 为 « TemplateString(
TemplateTail , raw) »。 - 返回 middle 与 tail 的列表连接。
- 返回 « TemplateString(
TemplateMiddle , raw) »。
- 令 front 为
TemplateMiddleList 的 TemplateStrings，参数 raw。 - 令 last 为 « TemplateString(
TemplateMiddle , raw) »。 - 返回 front 与 last 的列表连接。
13.2.8.3
静态语义：TemplateString (Static Semantics: TemplateString) (
templateToken: 一个 NoSubstitutionTemplate 、TemplateHead 、TemplateMiddle 或 TemplateTail Parse Node,
raw: Boolean,
): 一个 String 或 undefined
The abstract operation UNKNOWN takes UNPARSEABLE ARGUMENTS. It performs the following steps when called:
- 若 raw 为
true ，则- 令 string 为 templateToken 的 TRV。
- 否则，
- 令 string 为 templateToken 的 TV。
- 返回 string。
若 raw 为
13.2.8.4 GetTemplateObject ( templateLiteral )
The abstract operation GetTemplateObject takes argument templateLiteral (一个 Parse Node) and returns 一个 Array. It performs the following steps when called:
- 令 realm 为
当前 Realm Record 。 - 令 templateRegistry 为 realm.[[TemplateMap]]。
- 对 templateRegistry 中每个元素 e：
- 若 e.[[Site]] 与 templateLiteral 是同一 Parse Node，则
- 返回 e.[[Array]]。
- 若 e.[[Site]] 与 templateLiteral 是同一 Parse Node，则
- 令 rawStrings 为 templateLiteral 的 TemplateStrings，参数
true 。 - 断言：rawStrings 是 String 列表。
- 令 cookedStrings 为 templateLiteral 的 TemplateStrings，参数
false 。 - 令 count 为 cookedStrings 元素数量。
- 断言：count ≤ 232 - 1。
- 令 template 为 !
ArrayCreate (count)。 - 令 rawObj 为 !
ArrayCreate (count)。 - 令 index 为 0。
- 当 index < count 重复：
- 令 prop 为 !
ToString (𝔽 (index))。 - 令 cookedValue 为 cookedStrings[index]。
- 执行 !
DefinePropertyOrThrow (template, prop, PropertyDescriptor { [[Value]]: cookedValue, [[Writable]]:false , [[Enumerable]]:true , [[Configurable]]:false })。 - 令 rawValue 为 rawStrings[index] 的 String 值。
- 执行 !
DefinePropertyOrThrow (rawObj, prop, PropertyDescriptor { [[Value]]: rawValue, [[Writable]]:false , [[Enumerable]]:true , [[Configurable]]:false })。 - 将 index 设为 index + 1。
- 令 prop 为 !
- 执行 !
SetIntegrityLevel (rawObj,frozen )。 - 执行 !
DefinePropertyOrThrow (template,"raw" , PropertyDescriptor { [[Value]]: rawObj, [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:false })。 - 执行 !
SetIntegrityLevel (template,frozen )。 - 将记录 { [[Site]]: templateLiteral, [[Array]]: template } 附加到 realm.[[TemplateMap]]。
- 返回 template。
创建模板对象不会导致突然完成。
同一
规范未来版本可能为模板对象定义额外不可
13.2.8.5 运行时语义：SubstitutionEvaluation
The syntax-directed operation
- 返回新的空列表。
- 返回 ? SubstitutionEvaluation of
TemplateMiddleList 。
- 令 subRef 为 ? Evaluation of
Expression 。 - 令 sub 为 ?
GetValue (subRef)。 - 返回 « sub »。
- 令 preceding 为 ? SubstitutionEvaluation of
TemplateMiddleList 。 - 令 nextRef 为 ? Evaluation of
Expression 。 - 令 next 为 ?
GetValue (nextRef)。 - 返回 preceding 与 « next » 的列表连接。
13.2.8.6 运行时语义：求值 (Runtime Semantics: Evaluation)
- 返回
12.9.6 中定义的NoSubstitutionTemplate 的 TV。
- 令 head 为
12.9.6 中定义的TemplateHead 的 TV。 - 令 subRef 为 ? Evaluation of
Expression 。 - 令 sub 为 ?
GetValue (subRef)。 - 令 middle 为 ?
ToString (sub)。 - 令 tail 为 ? Evaluation of
TemplateSpans 。 - 返回 head、middle 与 tail 的字符串连接。
对 String.prototype.concat 而非 + 运算符。
- 返回
12.9.6 中定义的TemplateTail 的 TV。
- 令 head 为 ? Evaluation of
TemplateMiddleList 。 - 令 tail 为
12.9.6 中定义的TemplateTail 的 TV。 - 返回 head 与 tail 的字符串连接。
- 令 head 为
12.9.6 中定义的TemplateMiddle 的 TV。 - 令 subRef 为 ? Evaluation of
Expression 。 - 令 sub 为 ?
GetValue (subRef)。 - 令 middle 为 ?
ToString (sub)。 - 返回 head 与 middle 的字符串连接。
对 String.prototype.concat 而非 + 运算符。
- 令 rest 为 ? Evaluation of
TemplateMiddleList 。 - 令 middle 为
12.9.6 中定义的TemplateMiddle 的 TV。 - 令 subRef 为 ? Evaluation of
Expression 。 - 令 sub 为 ?
GetValue (subRef)。 - 令 last 为 ?
ToString (sub)。 - 返回 rest、middle、last 的字符串连接。
对 String.prototype.concat 而非 + 运算符。
13.2.9 分组运算符 (The Grouping Operator)
13.2.9.1 静态语义：早期错误 (Static Semantics: Early Errors)
13.2.9.2 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 expr 为
CoverParenthesizedExpressionAndArrowParameterList 所覆盖 的ParenthesizedExpression 。 - 返回 ? Evaluation of expr。
- 返回 ? Evaluation of
Expression 。其结果可能是 Reference 类型。
该算法不对 delete、typeof 等运算符。
13.3 左值表达式 (Left-Hand-Side Expressions)
语法 (Syntax)
补充语法 (Supplemental Syntax)
当处理产生式实例：
时，使用下列语法细化对
13.3.1 静态语义 (Static Semantics)
13.3.1.1 静态语义：早期错误 (Static Semantics: Early Errors)
- 若有源码匹配该产生式则为语法错误。
该产生式存在是为了阻止自动分号插入规则（
a?.b
`c`使其被解释为两个合法语句。其目的在于与没有可选链的类似代码保持一致：
a.b
`c`后者是一个合法语句，且自动分号插入不适用。
13.3.2 属性访问器 (Property Accessors)
属性按名称访问，可以使用点号表示法：
也可以使用方括号表示法：
点号表示法可以通过以下句法转换来解释：
其行为与
相同；类似地
其行为与
相同，其中 <identifier-name-string> 为
13.3.2.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 baseReference 为 ? Evaluation of
MemberExpression 。 - 令 baseValue 为 ?
GetValue (baseReference)。 - 令 strict 为 IsStrict(this
MemberExpression )。 - 返回 ?
EvaluatePropertyAccessWithExpressionKey (baseValue,Expression , strict)。
- 令 baseReference 为 ? Evaluation of
MemberExpression 。 - 令 baseValue 为 ?
GetValue (baseReference)。 - 令 strict 为 IsStrict(this
MemberExpression )。 - 返回
EvaluatePropertyAccessWithIdentifierKey (baseValue,IdentifierName , strict)。
- 令 baseReference 为 ? Evaluation of
MemberExpression 。 - 令 baseValue 为 ?
GetValue (baseReference)。 - 令 fieldNameString 为
PrivateIdentifier 的 StringValue。 - 返回
MakePrivateReference (baseValue, fieldNameString)。
- 令 baseReference 为 ? Evaluation of
CallExpression 。 - 令 baseValue 为 ?
GetValue (baseReference)。 - 令 strict 为 IsStrict(this
CallExpression )。 - 返回 ?
EvaluatePropertyAccessWithExpressionKey (baseValue,Expression , strict)。
- 令 baseReference 为 ? Evaluation of
CallExpression 。 - 令 baseValue 为 ?
GetValue (baseReference)。 - 令 strict 为 IsStrict(this
CallExpression )。 - 返回
EvaluatePropertyAccessWithIdentifierKey (baseValue,IdentifierName , strict)。
- 令 baseReference 为 ? Evaluation of
CallExpression 。 - 令 baseValue 为 ?
GetValue (baseReference)。 - 令 fieldNameString 为
PrivateIdentifier 的 StringValue。 - 返回
MakePrivateReference (baseValue, fieldNameString)。
13.3.3 EvaluatePropertyAccessWithExpressionKey ( baseValue, expression, strict )
The abstract operation EvaluatePropertyAccessWithExpressionKey takes arguments baseValue (一个
- 令 propertyNameReference 为 ? Evaluation of expression。
- 令 propertyNameValue 为 ?
GetValue (propertyNameReference)。 - 注：在大多数情况下，会在此步骤后立即对 propertyNameValue 执行
ToPropertyKey 。但在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 (一个
- 令 propertyNameString 为 identifierName 的 StringValue。
- 返回
Reference Record { [[Base]]: baseValue, [[ReferencedName]]: propertyNameString, [[Strict]]: strict, [[ThisValue]]:empty }。
13.3.5 new 运算符 (The new Operator)
13.3.5.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 返回 ?
EvaluateNew (NewExpression ,empty )。
- 返回 ?
EvaluateNew (MemberExpression ,Arguments )。
13.3.5.1.1 EvaluateNew ( constructExpr, arguments )
The abstract operation EvaluateNew takes arguments constructExpr (一个
- 令 ref 为 ? Evaluation of constructExpr。
- 令 constructor 为 ?
GetValue (ref)。 - 若 arguments 为
empty ，则- 令 argList 为新空列表。
- 否则，
- 令 argList 为 ? ArgumentListEvaluation of arguments。
- 若
IsConstructor (constructor) 为false ，抛出TypeError 异常。 - 返回 ? Construct(constructor, argList)。
13.3.6 函数调用 (Function Calls)
13.3.6.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 expr 为
CoverCallExpressionAndAsyncArrowHead 覆盖 的CallMemberExpression 。 - 令 memberExpr 为 expr 的
MemberExpression 。 - 令 arguments 为 expr 的
Arguments 。 - 令 ref 为 ? Evaluation of memberExpr。
- 令 func 为 ?
GetValue (ref)。 - 若 ref 是
Reference Record ，IsPropertyReference (ref) 为false ，且 ref.[[ReferencedName]] 为"eval" ，则- 若
SameValue (func,%eval% ) 为true ，则- 令 argList 为 ? ArgumentListEvaluation of arguments。
- 若 argList 无元素，返回
undefined 。 - 令 evalArg 为 argList 的第一个元素。
- 若 IsStrict(this
CallExpression ) 为true ，令 strictCaller 为true ；否则为false 。 - 返回 ?
PerformEval (evalArg, strictCaller,true )。
- 若
- 令 thisCall 为 this
CallExpression 。 - 令 tailCall 为 IsInTailPosition(thisCall)。
- 返回 ?
EvaluateCall (func, ref, arguments, tailCall)。
执行步骤
- 令 ref 为 ? Evaluation of
CallExpression 。 - 令 func 为 ?
GetValue (ref)。 - 令 thisCall 为 this
CallExpression 。 - 令 tailCall 为 IsInTailPosition(thisCall)。
- 返回 ?
EvaluateCall (func, ref,Arguments , tailCall)。
13.3.6.2 EvaluateCall ( func, ref, arguments, tailPosition )
The abstract operation EvaluateCall takes arguments func (一个
- 若 ref 是
Reference Record ，则- 若
IsPropertyReference (ref) 为true ，则- 令 thisValue 为
GetThisValue (ref)。
- 令 thisValue 为
- 否则，
- 令 refEnv 为 ref.[[Base]]。
- 断言：refEnv 是一个
Environment Record 。 - 令 thisValue 为 refEnv.WithBaseObject()。
- 若
- 否则，
- 令 thisValue 为
undefined 。
- 令 thisValue 为
- 令 argList 为 ? ArgumentListEvaluation of arguments。
- 若 func
不是 Object ，抛出TypeError 异常。 - 若
IsCallable (func) 为false ，抛出TypeError 异常。 - 若 tailPosition 为
true ，执行PrepareForTailCall ()。 - 返回 ? Call(func, thisValue, argList)。
13.3.7 super 关键字 (The super Keyword)
13.3.7.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 env 为
GetThisEnvironment ()。 - 令 actualThis 为 ? env.GetThisBinding()。
- 令 propertyNameReference 为 ? Evaluation of
Expression 。 - 令 propertyNameValue 为 ?
GetValue (propertyNameReference)。 - 令 strict 为 IsStrict(this
SuperProperty )。 - 注：在大多数情况下，会在此步骤后立即对 propertyNameValue 执行
ToPropertyKey 。但在super[b] = c的情形下，会延迟到c求值后。 - 返回
MakeSuperPropertyReference (actualThis, propertyNameValue, strict)。
- 令 env 为
GetThisEnvironment ()。 - 令 actualThis 为 ? env.GetThisBinding()。
- 令 propertyKey 为
IdentifierName 的 StringValue。 - 令 strict 为 IsStrict(this
SuperProperty )。 - 返回
MakeSuperPropertyReference (actualThis, propertyKey, strict)。
- 令 newTarget 为
GetNewTarget ()。 - 断言：newTarget 是一个
构造函数 。 - 令 func 为
GetSuperConstructor ()。 - 令 argList 为 ? ArgumentListEvaluation of
Arguments 。 - 若
IsConstructor (func) 为false ，抛出TypeError 异常。 - 令 result 为 ? Construct(func, argList, newTarget)。
- 令 thisER 为
GetThisEnvironment ()。 - 断言：thisER 是一个
Function Environment Record 。 - 执行 ?
BindThisValue (thisER, result)。 - 令 F 为 thisER.[[FunctionObject]]。
- 断言：F 是一个 ECMAScript
函数对象 。 - 执行 ?
InitializeInstanceElements (result, F)。 - 返回 result。
13.3.7.2 GetSuperConstructor ( )
The abstract operation GetSuperConstructor takes no arguments and returns 一个
- 令 envRec 为
GetThisEnvironment ()。 - 断言：envRec 是一个
Function Environment Record 。 - 令 activeFunction 为 envRec.[[FunctionObject]]。
- 断言：activeFunction 是一个 ECMAScript
函数对象 。 - 令 superConstructor 为 ! activeFunction.[[GetPrototypeOf]]()。
- 返回 superConstructor。
13.3.7.3 MakeSuperPropertyReference ( actualThis, propertyKey, strict )
The abstract operation MakeSuperPropertyReference takes arguments actualThis (一个
- 令 env 为
GetThisEnvironment ()。 - 断言：env.HasSuperBinding() 为
true 。 - 断言：env 是一个
Function Environment Record 。 - 令 baseValue 为
GetSuperBase (env)。 - 返回
Reference Record { [[Base]]: baseValue, [[ReferencedName]]: propertyKey, [[Strict]]: strict, [[ThisValue]]: actualThis }。
13.3.8 参数列表 (Argument Lists)
对参数列表的求值会产生一个值的
13.3.8.1 运行时语义：ArgumentListEvaluation
The syntax-directed operation
- 返回一个新的空列表。
- 令 ref 为 ? Evaluation of
AssignmentExpression 。 - 令 arg 为 ?
GetValue (ref)。 - 返回 « arg »。
- 令 list 为新空列表。
- 令 spreadRef 为 ? Evaluation of
AssignmentExpression 。 - 令 spreadObj 为 ?
GetValue (spreadRef)。 - 令 iteratorRecord 为 ?
GetIterator (spreadObj,sync )。 - 重复，
- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 若 next 为
done ，返回 list。 - 将 next 追加到 list。
- 令 next 为 ?
- 令 precedingArgs 为 ? ArgumentListEvaluation of
ArgumentList 。 - 令 ref 为 ? Evaluation of
AssignmentExpression 。 - 令 arg 为 ?
GetValue (ref)。 - 返回 precedingArgs 与 « arg » 的列表连接。
- 令 precedingArgs 为 ? ArgumentListEvaluation of
ArgumentList 。 - 令 spreadRef 为 ? Evaluation of
AssignmentExpression 。 - 令 iteratorRecord 为 ?
GetIterator (?GetValue (spreadRef),sync )。 - 重复，
- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 若 next 为
done ，返回 precedingArgs。 - 将 next 追加到 precedingArgs。
- 令 next 为 ?
- 令 templateLiteral 为 this
TemplateLiteral 。 - 令 siteObj 为
GetTemplateObject (templateLiteral)。 - 返回 « siteObj »。
- 令 templateLiteral 为 this
TemplateLiteral 。 - 令 siteObj 为
GetTemplateObject (templateLiteral)。 - 令 remaining 为 ? ArgumentListEvaluation of
SubstitutionTemplate 。 - 返回 « siteObj » 与 remaining 的列表连接。
- 令 firstSubRef 为 ? Evaluation of
Expression 。 - 令 firstSub 为 ?
GetValue (firstSubRef)。 - 令 restSub 为 ? SubstitutionEvaluation of
TemplateSpans 。 - 断言：restSub 是一个可为空的列表。
- 返回 « firstSub » 与 restSub 的列表连接。
13.3.9 可选链 (Optional Chains)
?. 记号开始。13.3.9.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 baseReference 为 ? Evaluation of
MemberExpression 。 - 令 baseValue 为 ?
GetValue (baseReference)。 - 若 baseValue 是
undefined 或null ，则- 返回
undefined 。
- 返回
- 返回 ? ChainEvaluation of
OptionalChain ，参数 baseValue 与 baseReference。
- 令 baseReference 为 ? Evaluation of
CallExpression 。 - 令 baseValue 为 ?
GetValue (baseReference)。 - 若 baseValue 是
undefined 或null ，则- 返回
undefined 。
- 返回
- 返回 ? ChainEvaluation of
OptionalChain ，参数 baseValue 与 baseReference。
- 令 baseReference 为 ? Evaluation of
OptionalExpression 。 - 令 baseValue 为 ?
GetValue (baseReference)。 - 若 baseValue 是
undefined 或null ，则- 返回
undefined 。
- 返回
- 返回 ? ChainEvaluation of
OptionalChain ，参数 baseValue 与 baseReference。
13.3.9.2 运行时语义：ChainEvaluation : 返回一个含 ECMAScript 语言值或 Reference Record 的正常完成，或一个突然完成
The syntax-directed operation UNKNOWN takes UNPARSEABLE ARGUMENTS. It is defined piecewise over the following productions:
- 令 thisChain 为 this
OptionalChain 。 - 令 tailCall 为 IsInTailPosition(thisChain)。
- 返回 ?
EvaluateCall (baseValue, baseReference,Arguments , tailCall)。
- 令 strict 为 IsStrict(this
OptionalChain )。 - 返回 ?
EvaluatePropertyAccessWithExpressionKey (baseValue,Expression , strict)。
- 令 strict 为 IsStrict(this
OptionalChain )。 - 返回
EvaluatePropertyAccessWithIdentifierKey (baseValue,IdentifierName , strict)。
- 令 fieldNameString 为
PrivateIdentifier 的 StringValue。 - 返回
MakePrivateReference (baseValue, fieldNameString)。
- 令 optionalChain 为
OptionalChain 。 - 令 newReference 为 ? ChainEvaluation of optionalChain，参数 baseValue 与 baseReference。
- 令 newValue 为 ?
GetValue (newReference)。 - 令 thisChain 为 this
OptionalChain 。 - 令 tailCall 为 IsInTailPosition(thisChain)。
- 返回 ?
EvaluateCall (newValue, newReference,Arguments , tailCall)。
- 令 optionalChain 为
OptionalChain 。 - 令 newReference 为 ? ChainEvaluation of optionalChain，参数 baseValue 与 baseReference。
- 令 newValue 为 ?
GetValue (newReference)。 - 令 strict 为 IsStrict(this
OptionalChain )。 - 返回 ?
EvaluatePropertyAccessWithExpressionKey (newValue,Expression , strict)。
- 令 optionalChain 为
OptionalChain 。 - 令 newReference 为 ? ChainEvaluation of optionalChain，参数 baseValue 与 baseReference。
- 令 newValue 为 ?
GetValue (newReference)。 - 令 strict 为 IsStrict(this
OptionalChain )。 - 返回
EvaluatePropertyAccessWithIdentifierKey (newValue,IdentifierName , strict)。
- 令 optionalChain 为
OptionalChain 。 - 令 newReference 为 ? ChainEvaluation of optionalChain，参数 baseValue 与 baseReference。
- 令 newValue 为 ?
GetValue (newReference)。 - 令 fieldNameString 为
PrivateIdentifier 的 StringValue。 - 返回
MakePrivateReference (newValue, fieldNameString)。
13.3.10 Import 调用 (Import Calls)
13.3.10.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 返回 ? EvaluateImportCall(
AssignmentExpression )。
- 返回 ? EvaluateImportCall(第一个
AssignmentExpression , 第二个AssignmentExpression )。
13.3.10.2 EvaluateImportCall ( specifierExpression: 一个 Parse Node, 可选 optionsExpression: 一个 Parse Node, ): 返回一个含 Promise 的正常完成或一个突然完成
The abstract operation UNKNOWN takes UNPARSEABLE ARGUMENTS. It performs the following steps when called:
- 令 referrer 为
GetActiveScriptOrModule ()。 - 若 referrer 为
null ，将 referrer 设为当前 Realm Record 。 - 令 specifierRef 为 ? Evaluation of specifierExpression。
- 令 specifier 为 ?
GetValue (specifierRef)。 - 若存在 optionsExpression，则
- 令 optionsRef 为 ? Evaluation of optionsExpression。
- 令 options 为 ?
GetValue (optionsRef)。
- 否则，
- 令 options 为
undefined 。
- 令 options 为
- 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 specifierString 为
Completion (ToString (specifier))。 IfAbruptRejectPromise (specifierString, promiseCapability)。- 令 attributes 为新空列表。
- 若 options 不为
undefined ，则- 若 options
不是 Object ，则- 执行 ! Call(promiseCapability.[[Reject]],
undefined , « 新建的TypeError 对象 »)。 - 返回 promiseCapability.[[Promise]]。
- 执行 ! Call(promiseCapability.[[Reject]],
- 令 attributesObj 为
Completion (Get (options,"with" ))。 IfAbruptRejectPromise (attributesObj, promiseCapability)。- 若 attributesObj 不为
undefined ，则- 若 attributesObj
不是 Object ，则- 执行 ! Call(promiseCapability.[[Reject]],
undefined , « 新建的TypeError 对象 »)。 - 返回 promiseCapability.[[Promise]]。
- 执行 ! Call(promiseCapability.[[Reject]],
- 令 entries 为
Completion (EnumerableOwnProperties (attributesObj,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]]。
- 执行 ! Call(promiseCapability.[[Reject]],
- 将
ImportAttribute Record { [[Key]]: key, [[Value]]: value } 追加到 attributes。
- 若 value 不是 String，则
- 令 key 为 !
- 若 attributesObj
- 若
AllImportAttributesSupported (attributes) 为false ，则- 执行 ! Call(promiseCapability.[[Reject]],
undefined , « 新建的TypeError 对象 »)。 - 返回 promiseCapability.[[Promise]]。
- 执行 ! Call(promiseCapability.[[Reject]],
- 按 [[Key]] 字段字典序（将字段值视为 UTF-16 代码单元序列）对 attributes 排序。注：排序唯一可观察之处是
宿主 被禁止基于枚举 顺序改变行为。
- 若 options
- 令 moduleRequest 为新
ModuleRequest Record { [[Specifier]]: specifierString, [[Attributes]]: attributes }。 - 执行
HostLoadImportedModule (referrer, moduleRequest,empty , promiseCapability)。 - 返回 promiseCapability.[[Promise]]。
13.3.10.3 ContinueDynamicImport ( promiseCapability, moduleCompletion )
The abstract operation ContinueDynamicImport takes arguments promiseCapability (一个 import()
- 若 moduleCompletion 是突然完成，则
- 执行 ! Call(promiseCapability.[[Reject]],
undefined , « moduleCompletion.[[Value]] »)。 - 返回
unused 。
- 执行 ! Call(promiseCapability.[[Reject]],
- 令 module 为 moduleCompletion.[[Value]]。
- 令 loadPromise 为 module.LoadRequestedModules()。
- 令 rejectedClosure 为带参数 (reason)、捕获 promiseCapability 的新抽象闭包，调用时执行：
- 执行 ! Call(promiseCapability.[[Reject]],
undefined , « reason »)。 - 返回
NormalCompletion (undefined )。
- 执行 ! Call(promiseCapability.[[Reject]],
- 令 onRejected 为
CreateBuiltinFunction (rejectedClosure, 1,"" , « »)。 - 令 linkAndEvaluateClosure 为无参数、捕获 module、promiseCapability、onRejected 的新抽象闭包，调用时执行：
- 令 link 为
Completion (module.Link())。 - 若 link 是突然完成，则
- 执行 ! Call(promiseCapability.[[Reject]],
undefined , « link.[[Value]] »)。 - 返回
NormalCompletion (undefined )。
- 执行 ! Call(promiseCapability.[[Reject]],
- 令 evaluatePromise 为 module.Evaluate()。
- 令 fulfilledClosure 为无参数、捕获 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 带标签模板 (Tagged Templates)
带标签模板是一个函数调用，其调用参数来源于
13.3.11.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 tagRef 为 ? Evaluation of
MemberExpression 。 - 令 tagFunc 为 ?
GetValue (tagRef)。 - 令 thisCall 为 this
MemberExpression 。 - 令 tailCall 为 IsInTailPosition(thisCall)。
- 返回 ?
EvaluateCall (tagFunc, tagRef,TemplateLiteral , tailCall)。
- 令 tagRef 为 ? Evaluation of
CallExpression 。 - 令 tagFunc 为 ?
GetValue (tagRef)。 - 令 thisCall 为 this
CallExpression 。 - 令 tailCall 为 IsInTailPosition(thisCall)。
- 返回 ?
EvaluateCall (tagFunc, tagRef,TemplateLiteral , tailCall)。
13.3.12 元属性 (Meta Properties)
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]] } p：- 执行 !
CreateDataPropertyOrThrow (importMeta, p.[[Key]], p.[[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 (一个 import.meta 返回的对象提供
HostGetImportMetaProperties 的默认实现是返回一个新的空列表。
13.3.12.1.2 HostFinalizeImportMeta ( importMeta, moduleRecord )
The host-defined abstract operation HostFinalizeImportMeta takes arguments importMeta (一个 Object) and moduleRecord (一个 import.meta 返回的对象暴露给 ECMAScript 代码。
大多数
HostFinalizeImportMeta 的默认实现是返回
13.4 更新表达式 (Update Expressions)
语法 (Syntax)
13.4.1 静态语义：早期错误 (Static Semantics: Early Errors)
-
若
LeftHandSideExpression 的 AssignmentTargetType 为invalid ，则属于早期语法错误。
-
若
UnaryExpression 的 AssignmentTargetType 为invalid ，则属于早期语法错误。
13.4.2 后缀自增运算符 (Postfix Increment Operator)
13.4.2.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 lhs 为 ? Evaluation of
LeftHandSideExpression 。 - 若
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 后缀自减运算符 (Postfix Decrement Operator)
13.4.3.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 lhs 为 ? Evaluation of
LeftHandSideExpression 。 - 若
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 前缀自增运算符 (Prefix Increment Operator)
13.4.4.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 expr 为 ? Evaluation of
UnaryExpression 。 - 若
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 前缀自减运算符 (Prefix Decrement Operator)
13.4.5.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 expr 为 ? Evaluation of
UnaryExpression 。 - 若
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 一元运算符 (Unary Operators)
语法 (Syntax)
13.5.1 delete 运算符 (The delete Operator)
13.5.1.1 静态语义：早期错误 (Static Semantics: Early Errors)
-
若 IsStrict(
UnaryExpression ) 为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 为 ? Evaluation of
UnaryExpression 。 - 若 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 运算符，如果其
13.5.2 void 运算符 (The void Operator)
13.5.2.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 expr 为 ? Evaluation of
UnaryExpression 。 - 执行 ?
GetValue (expr)。 - 返回
undefined 。
必须调用
13.5.3 typeof 运算符 (The typeof Operator)
13.5.3.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 val 为 ? Evaluation of
UnaryExpression 。 - 若 val 是
Reference Record ，则- 若
IsUnresolvableReference (val) 为true ，返回"undefined" 。
- 若
- 设 val 为 ?
GetValue (val)。 - 若 val 为
undefined ，返回"undefined" 。 - 若 val 为
null ，返回"object" 。 - 若 val 为 String，返回
"string" 。 - 若 val 为 Symbol，返回
"symbol" 。 - 若 val 为 Boolean，返回
"boolean" 。 - 若 val 为 Number，返回
"number" 。 - 若 val 为 BigInt，返回
"bigint" 。 - 断言：val 为 Object。
- Normative Optional若
宿主 是 web 浏览器或否则支持[[IsHTMLDDA]] 内部槽 ，则- 若 val 拥有 [[IsHTMLDDA]] 内部槽，返回
"undefined" 。
- 若 val 拥有 [[IsHTMLDDA]] 内部槽，返回
- 若 val 拥有 [[Call]] 内部方法，返回
"function" 。 - 返回
"object" 。
13.5.4 一元 + 运算符 (Unary + Operator)
一元 + 运算符将其操作数转换为
13.5.4.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 expr 为 ? Evaluation of
UnaryExpression 。 - 返回 ?
ToNumber (?GetValue (expr))。
13.5.5 一元 - 运算符 (Unary - Operator)
一元 - 运算符将其操作数先转换为数值再取相反数。对
13.5.5.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 expr 为 ? Evaluation of
UnaryExpression 。 - 令 oldValue 为 ?
ToNumeric (?GetValue (expr))。 - 若 oldValue
是 Number ，则- 返回
Number::unaryMinus (oldValue)。
- 返回
- 否则，
- 断言：oldValue 为 BigInt。
- 返回
BigInt::unaryMinus (oldValue)。
13.5.6 按位取反运算符 (Bitwise NOT Operator ~)
13.5.6.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 expr 为 ? Evaluation of
UnaryExpression 。 - 令 oldValue 为 ?
ToNumeric (?GetValue (expr))。 - 若 oldValue
是 Number ，则- 返回
Number::bitwiseNOT (oldValue)。
- 返回
- 否则，
- 断言：oldValue 为 BigInt。
- 返回
BigInt::bitwiseNOT (oldValue)。
13.5.7 逻辑非运算符 (Logical NOT Operator !)
13.5.7.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 expr 为 ? Evaluation of
UnaryExpression 。 - 令 oldValue 为
ToBoolean (?GetValue (expr))。 - 若 oldValue 为
true ，返回false 。 - 返回
true 。
13.6 幂运算符 (Exponentiation Operator)
语法 (Syntax)
13.6.1 运行时语义：求值 (Runtime Semantics: Evaluation)
13.7 乘法类运算符 (Multiplicative Operators)
语法 (Syntax)
*运算符执行乘法，产生其操作数的乘积。/运算符执行除法，产生其操作数的商。%运算符产生隐含除法后的余数。
13.7.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 opText 为
MultiplicativeOperator 匹配的源文本。 - 返回 ?
EvaluateStringOrNumericBinaryExpression (MultiplicativeExpression , opText,ExponentiationExpression )。
13.8 加法类运算符 (Additive Operators)
语法 (Syntax)
13.8.1 加法运算符 (The Addition Operator +)
加法运算符执行字符串连接或数值加法。
13.8.1.1 运行时语义：求值 (Runtime Semantics: Evaluation)
13.8.2 减法运算符 (The Subtraction Operator -)
- 运算符执行减法，产生操作数之差。
13.8.2.1 运行时语义：求值 (Runtime Semantics: Evaluation)
13.9 位移运算符 (Bitwise Shift Operators)
语法 (Syntax)
13.9.1 左移运算符 (The Left Shift Operator <<)
对左操作数按右操作数指定的位数执行按位左移。
13.9.1.1 运行时语义：求值 (Runtime Semantics: Evaluation)
13.9.2 带符号右移运算符 (The Signed Right Shift Operator >>)
对左操作数按右操作数指定的位数执行带符号（符号位填充）按位右移。
13.9.2.1 运行时语义：求值 (Runtime Semantics: Evaluation)
13.9.3 无符号右移运算符 (The Unsigned Right Shift Operator >>>)
对左操作数按右操作数指定的位数执行零填充按位右移。
13.9.3.1 运行时语义：求值 (Runtime Semantics: Evaluation)
13.10 关系运算符 (Relational Operators)
关系运算符求值结果总是 Boolean，表示操作数之间关系是否成立。
语法 (Syntax)
[In] 语法参数用于避免把关系表达式中的 in 运算符与 for 语句中的 in 混淆。
13.10.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 lRef 为 ? Evaluation of
RelationalExpression 。 - 令 lVal 为 ?
GetValue (lRef)。 - 令 rRef 为 ? Evaluation of
ShiftExpression 。 - 令 rVal 为 ?
GetValue (rRef)。 - 令 r 为 ?
IsLessThan (lVal, rVal,true )。 - 若 r 为
undefined ，返回false ；否则返回 r。
- 令 lRef 为 ? Evaluation of
RelationalExpression 。 - 令 lVal 为 ?
GetValue (lRef)。 - 令 rRef 为 ? Evaluation of
ShiftExpression 。 - 令 rVal 为 ?
GetValue (rRef)。 - 令 r 为 ?
IsLessThan (rVal, lVal,false )。 - 若 r 为
undefined ，返回false ；否则返回 r。
- 令 lRef 为 ? Evaluation of
RelationalExpression 。 - 令 lVal 为 ?
GetValue (lRef)。 - 令 rRef 为 ? Evaluation of
ShiftExpression 。 - 令 rVal 为 ?
GetValue (rRef)。 - 令 r 为 ?
IsLessThan (rVal, lVal,false )。 - 若 r 为
true 或undefined ，返回false ；否则返回true 。
- 令 lRef 为 ? Evaluation of
RelationalExpression 。 - 令 lVal 为 ?
GetValue (lRef)。 - 令 rRef 为 ? Evaluation of
ShiftExpression 。 - 令 rVal 为 ?
GetValue (rRef)。 - 令 r 为 ?
IsLessThan (lVal, rVal,true )。 - 若 r 为
true 或undefined ，返回false ；否则返回true 。
- 令 lRef 为 ? Evaluation of
RelationalExpression 。 - 令 lVal 为 ?
GetValue (lRef)。 - 令 rRef 为 ? Evaluation of
ShiftExpression 。 - 令 rVal 为 ?
GetValue (rRef)。 - 返回 ?
InstanceofOperator (lVal, rVal)。
- 令 lRef 为 ? Evaluation of
RelationalExpression 。 - 令 lVal 为 ?
GetValue (lRef)。 - 令 rRef 为 ? Evaluation of
ShiftExpression 。 - 令 rVal 为 ?
GetValue (rRef)。 - 若 rVal
不是 Object ，抛出TypeError 异常。 - 返回 ?
HasProperty (rVal, ?ToPropertyKey (lVal))。
- 令 privateIdentifier 为
PrivateIdentifier 的 StringValue。 - 令 rRef 为 ? Evaluation of
ShiftExpression 。 - 令 rVal 为 ?
GetValue (rRef)。 - 若 rVal
不是 Object ，抛出TypeError 异常。 - 令 privateEnv 为正在运行的执行上下文的 PrivateEnvironment。
- 断言：privateEnv 非
null 。 - 令 privateName 为
ResolvePrivateIdentifier (privateEnv, privateIdentifier)。 - 若
PrivateElementFind (rVal, privateName) 非empty ，返回true 。 - 返回
false 。
13.10.2 InstanceofOperator ( V, target )
The abstract operation InstanceofOperator takes arguments V (an ECMAScript language value) and target (an ECMAScript language value) and returns 返回一个含 Boolean 的
- 若 target
不是 Object ，抛出TypeError 异常。 - 令 instOfHandler 为 ?
GetMethod (target,%Symbol.hasInstance% )。 - 若 instOfHandler 不为
undefined ，则- 返回
ToBoolean (? Call(instOfHandler, target, « V »))。
- 返回
- 若
IsCallable (target) 为false ，抛出TypeError 异常。 - 返回 ?
OrdinaryHasInstance (target, V)。
步骤 instanceof 语义的版本。若对象未定义或继承该方法，则使用默认语义。
13.11 相等运算符 (Equality Operators)
相等运算符求值结果总是 Boolean，表示两操作数之间命名关系是否成立。
语法 (Syntax)
13.11.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 lRef 为 ? Evaluation of
EqualityExpression 。 - 令 lVal 为 ?
GetValue (lRef)。 - 令 rRef 为 ? Evaluation of
RelationalExpression 。 - 令 rVal 为 ?
GetValue (rRef)。 - 返回 ?
IsLooselyEqual (rVal, lVal)。
- 令 lRef 为 ? Evaluation of
EqualityExpression 。 - 令 lVal 为 ?
GetValue (lRef)。 - 令 rRef 为 ? Evaluation of
RelationalExpression 。 - 令 rVal 为 ?
GetValue (rRef)。 - 令 r 为 ?
IsLooselyEqual (rVal, lVal)。 - 若 r 为
true ，返回false ；否则返回true 。
- 令 lRef 为 ? Evaluation of
EqualityExpression 。 - 令 lVal 为 ?
GetValue (lRef)。 - 令 rRef 为 ? Evaluation of
RelationalExpression 。 - 令 rVal 为 ?
GetValue (rRef)。 - 返回
IsStrictlyEqual (rVal, lVal)。
- 令 lRef 为 ? Evaluation of
EqualityExpression 。 - 令 lVal 为 ?
GetValue (lRef)。 - 令 rRef 为 ? Evaluation of
RelationalExpression 。 - 令 rVal 为 ?
GetValue (rRef)。 - 令 r 为
IsStrictlyEqual (rVal, lVal)。 - 若 r 为
true ，返回false ；否则返回true 。
基于上述定义：
- 可通过
`${a}` == `${b}`强制字符串比较。 - 可通过
+a == +b强制数值比较。 - 可通过
!a == !b强制布尔比较。
相等运算符保持以下不变式：
A != B等价于!(A == B)。A == B等价于B == A，除求值顺序外。
相等运算符并非总是传递。例如可能存在两个不同的 String 对象，各表示相同的字符串值；它们分别与该字符串字面值 == 为 == 为
new String("a") == "a"与"a" == new String("a")均为true 。new String("a") == new String("a")为false 。
字符串比较对代码单元序列执行简单相等测试，不使用 Unicode 规范中更复杂的语义性字符/字符串等价与排序定义。故按 Unicode 标准正则等价的字符串值可能测试为不等；此算法假设两者已规范化。
13.12 二元按位运算符 (Binary Bitwise Operators)
语法 (Syntax)
13.12.1 运行时语义：求值 (Runtime Semantics: Evaluation)
13.13 二元逻辑运算符 (Binary Logical Operators)
语法 (Syntax)
&& 与 || 运算符产生的值不一定是 Boolean，而总是两个操作数表达式之一的值。
13.13.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 lRef 为 ? Evaluation of
LogicalANDExpression 。 - 令 lVal 为 ?
GetValue (lRef)。 - 若
ToBoolean (lVal) 为false ，返回 lVal。 - 令 rRef 为 ? Evaluation of
BitwiseORExpression 。 - 返回 ?
GetValue (rRef)。
- 令 lRef 为 ? Evaluation of
LogicalORExpression 。 - 令 lVal 为 ?
GetValue (lRef)。 - 若
ToBoolean (lVal) 为true ，返回 lVal。 - 令 rRef 为 ? Evaluation of
LogicalANDExpression 。 - 返回 ?
GetValue (rRef)。
- 令 lRef 为 ? Evaluation of
CoalesceExpressionHead 。 - 令 lVal 为 ?
GetValue (lRef)。 - 若 lVal 为
undefined 或null ，则- 令 rRef 为 ? Evaluation of
BitwiseORExpression 。 - 返回 ?
GetValue (rRef)。
- 令 rRef 为 ? Evaluation of
- 否则，
- 返回 lVal。
13.14 条件运算符 ( ? : ) (Conditional Operator ( ? : ))
语法 (Syntax)
ECMAScript 中
13.14.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 lRef 为 ? Evaluation of
ShortCircuitExpression 。 - 令 lVal 为
ToBoolean (?GetValue (lRef))。 - 若 lVal 为
true ，则- 令 trueRef 为 ? Evaluation of 第一个
AssignmentExpression 。 - 返回 ?
GetValue (trueRef)。
- 令 trueRef 为 ? Evaluation of 第一个
- 否则，
- 令 falseRef 为 ? Evaluation of 第二个
AssignmentExpression 。 - 返回 ?
GetValue (falseRef)。
- 令 falseRef 为 ? Evaluation of 第二个
13.15 赋值运算符 (Assignment Operators)
语法 (Syntax)
13.15.1 静态语义：早期错误 (Static Semantics: Early Errors)
-
若
LeftHandSideExpression 是ObjectLiteral 或ArrayLiteral ，则LeftHandSideExpression 必须覆盖 一个AssignmentPattern 。 -
若
LeftHandSideExpression 既不是ObjectLiteral 也不是ArrayLiteral ，且其 AssignmentTargetType 为invalid ，则为语法错误。
-
若
LeftHandSideExpression 的 AssignmentTargetType 为invalid ，则为语法错误。
-
若
LeftHandSideExpression 的 AssignmentTargetType 不是simple ，则为语法错误。
13.15.2 运行时语义：求值 (Runtime Semantics: Evaluation)
- 若
LeftHandSideExpression 既不是ObjectLiteral 也不是ArrayLiteral ，则- 令 lRef 为 ? Evaluation of
LeftHandSideExpression 。 - 若
LeftHandSideExpression 的 AssignmentTargetType 为web-compat ，抛出ReferenceError 异常。 - 若 IsAnonymousFunctionDefinition(
AssignmentExpression ) 为true 且 IsIdentifierRef ofLeftHandSideExpression 为true ，则- 令 lhs 为
LeftHandSideExpression 的 StringValue。 - 令 rVal 为 ? NamedEvaluation of
AssignmentExpression ，参数 lhs。
- 令 lhs 为
- 否则，
- 令 rRef 为 ? Evaluation of
AssignmentExpression 。 - 令 rVal 为 ?
GetValue (rRef)。
- 令 rRef 为 ? Evaluation of
- 执行 ?
PutValue (lRef, rVal)。 - 返回 rVal。
- 令 lRef 为 ? Evaluation of
- 令 assignmentPattern 为
LeftHandSideExpression 覆盖 的AssignmentPattern 。 - 令 rRef 为 ? Evaluation of
AssignmentExpression 。 - 令 rVal 为 ?
GetValue (rRef)。 - 执行 ? DestructuringAssignmentEvaluation of assignmentPattern，参数 rVal。
- 返回 rVal。
- 令 lRef 为 ? Evaluation of
LeftHandSideExpression 。 - 若
LeftHandSideExpression 的 AssignmentTargetType 为web-compat ，抛出ReferenceError 异常。 - 令 lVal 为 ?
GetValue (lRef)。 - 令 rRef 为 ? Evaluation of
AssignmentExpression 。 - 令 rVal 为 ?
GetValue (rRef)。 - 令 assignmentOpText 为
AssignmentOperator 所匹配的源文本。 - 令 opText 为下表中与 assignmentOpText 关联的 Unicode 码点序列：
assignmentOpText opText **=***=*/=/%=%+=+-=-<<=<<>>=>>>>>=>>>&=&^=^|=| - 令 r 为 ?
ApplyStringOrNumericBinaryOperator (lVal, opText, rVal)。 - 执行 ?
PutValue (lRef, r)。 - 返回 r。
- 令 lRef 为 ? Evaluation of
LeftHandSideExpression 。 - 令 lVal 为 ?
GetValue (lRef)。 - 若
ToBoolean (lVal) 为false ，返回 lVal。 - 若 IsAnonymousFunctionDefinition(
AssignmentExpression ) 为true 且 IsIdentifierRef ofLeftHandSideExpression 为true ，则- 令 lhs 为
LeftHandSideExpression 的 StringValue。 - 令 rVal 为 ? NamedEvaluation of
AssignmentExpression ，参数 lhs。
- 令 lhs 为
- 否则，
- 令 rRef 为 ? Evaluation of
AssignmentExpression 。 - 令 rVal 为 ?
GetValue (rRef)。
- 令 rRef 为 ? Evaluation of
- 执行 ?
PutValue (lRef, rVal)。 - 返回 rVal。
- 令 lRef 为 ? Evaluation of
LeftHandSideExpression 。 - 令 lVal 为 ?
GetValue (lRef)。 - 若
ToBoolean (lVal) 为true ，返回 lVal。 - 若 IsAnonymousFunctionDefinition(
AssignmentExpression ) 为true 且 IsIdentifierRef ofLeftHandSideExpression 为true ，则- 令 lhs 为
LeftHandSideExpression 的 StringValue。 - 令 rVal 为 ? NamedEvaluation of
AssignmentExpression ，参数 lhs。
- 令 lhs 为
- 否则，
- 令 rRef 为 ? Evaluation of
AssignmentExpression 。 - 令 rVal 为 ?
GetValue (rRef)。
- 令 rRef 为 ? Evaluation of
- 执行 ?
PutValue (lRef, rVal)。 - 返回 rVal。
- 令 lRef 为 ? Evaluation of
LeftHandSideExpression 。 - 令 lVal 为 ?
GetValue (lRef)。 - 若 lVal 既不是
undefined 也不是null ，返回 lVal。 - 若 IsAnonymousFunctionDefinition(
AssignmentExpression ) 为true 且 IsIdentifierRef ofLeftHandSideExpression 为true ，则- 令 lhs 为
LeftHandSideExpression 的 StringValue。 - 令 rVal 为 ? NamedEvaluation of
AssignmentExpression ，参数 lhs。
- 令 lhs 为
- 否则，
- 令 rRef 为 ? Evaluation of
AssignmentExpression 。 - 令 rVal 为 ?
GetValue (rRef)。
- 令 rRef 为 ? Evaluation of
- 执行 ?
PutValue (lRef, rVal)。 - 返回 rVal。
13.15.3 ApplyStringOrNumericBinaryOperator ( lVal, opText, rVal )
The abstract operation ApplyStringOrNumericBinaryOperator takes arguments lVal (一个 **, *, /, %, +, -, <<, >>, >>>, &, ^, 或 |), and rVal (一个
- 若 opText 是
+，则 - 注：此时必为数值运算。
- 令 lNum 为 ?
ToNumeric (lVal)。 - 令 rNum 为 ?
ToNumeric (rVal)。 - 若
SameType (lNum, rNum) 为false ，抛出TypeError 异常。 - 若 lNum 为 BigInt，则
- 若 opText 为
**，返回 ?BigInt::exponentiate (lNum, rNum)。 - 若 opText 为
/，返回 ?BigInt::divide (lNum, rNum)。 - 若 opText 为
%，返回 ?BigInt::remainder (lNum, rNum)。 - 若 opText 为
>>>，返回 ?BigInt::unsignedRightShift (lNum, rNum)。 - 令 operation 为下表中与 opText 关联的
抽象操作 ：opText operation *BigInt::multiply +BigInt::add -BigInt::subtract <<BigInt::leftShift >>BigInt::signedRightShift &BigInt::bitwiseAND ^BigInt::bitwiseXOR |BigInt::bitwiseOR
- 若 opText 为
- 否则，
- 断言：lNum 为 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(lNum, rNum)。
步骤
13.15.4 EvaluateStringOrNumericBinaryExpression ( leftOperand, opText, rightOperand )
The abstract operation EvaluateStringOrNumericBinaryExpression takes arguments leftOperand (一个 Parse Node), opText (一个 Unicode 码点序列), and rightOperand (一个 Parse Node) and returns 返回一个含 String、BigInt 或 Number 的
- 令 lRef 为 ? Evaluation of leftOperand。
- 令 lVal 为 ?
GetValue (lRef)。 - 令 rRef 为 ? Evaluation of rightOperand。
- 令 rVal 为 ?
GetValue (rRef)。 - 返回 ?
ApplyStringOrNumericBinaryOperator (lVal, opText, rVal)。
13.15.5 解构赋值 (Destructuring Assignment)
补充语法 (Supplemental Syntax)
在处理产生式实例：
时，对
13.15.5.1 静态语义：早期错误 (Static Semantics: Early Errors)
-
若
IdentifierReference 的 AssignmentTargetType 不是simple ，则为语法错误。
-
若
DestructuringAssignmentTarget 是ArrayLiteral 或ObjectLiteral ，则为语法错误。
-
若
LeftHandSideExpression 是ObjectLiteral 或ArrayLiteral ，则其必须覆盖 一个AssignmentPattern 。 -
若
LeftHandSideExpression 既不是ObjectLiteral 也不是ArrayLiteral ，且其 AssignmentTargetType 不是simple ，则为语法错误。
13.15.5.2 运行时语义：DestructuringAssignmentEvaluation
The syntax-directed operation
- 执行 ?
RequireObjectCoercible (value)。 - 返回
unused 。
- 执行 ?
RequireObjectCoercible (value)。 - 执行 ? PropertyDestructuringAssignmentEvaluation of
AssignmentPropertyList ，参数 value。 - 返回
unused 。
- 执行 ?
RequireObjectCoercible (value)。 - 令 excludedNames 为新空列表。
- 返回 ? RestDestructuringAssignmentEvaluation of
AssignmentRestProperty ，参数 value 与 excludedNames。
- 执行 ?
RequireObjectCoercible (value)。 - 令 excludedNames 为 ? PropertyDestructuringAssignmentEvaluation of
AssignmentPropertyList ，参数 value。 - 返回 ? RestDestructuringAssignmentEvaluation of
AssignmentRestProperty ，参数 value 与 excludedNames。
- 令 iteratorRecord 为 ?
GetIterator (value,sync )。 - 返回 ?
IteratorClose (iteratorRecord,NormalCompletion (unused ))。
- 令 iteratorRecord 为 ?
GetIterator (value,sync )。 - 令 result 为
Completion (IteratorDestructuringAssignmentEvaluation ofElision ，参数 iteratorRecord)。 - 若 iteratorRecord.[[Done]] 为
false ，返回 ?IteratorClose (iteratorRecord, result)。 - 返回 result。
- 令 iteratorRecord 为 ?
GetIterator (value,sync )。 - 若存在
Elision ，则- 令 status 为
Completion (IteratorDestructuringAssignmentEvaluation ofElision ，参数 iteratorRecord)。 - 若 status 是突然完成，则
- 断言：iteratorRecord.[[Done]] 为
true 。 - 返回 ? status。
- 断言：iteratorRecord.[[Done]] 为
- 令 status 为
- 令 result 为
Completion (IteratorDestructuringAssignmentEvaluation ofAssignmentRestElement ，参数 iteratorRecord)。 - 若 iteratorRecord.[[Done]] 为
false ，返回 ?IteratorClose (iteratorRecord, result)。 - 返回 result。
- 令 iteratorRecord 为 ?
GetIterator (value,sync )。 - 令 result 为
Completion (IteratorDestructuringAssignmentEvaluation ofAssignmentElementList ，参数 iteratorRecord)。 - 若 iteratorRecord.[[Done]] 为
false ，返回 ?IteratorClose (iteratorRecord, result)。 - 返回 result。
- 令 iteratorRecord 为 ?
GetIterator (value,sync )。 - 令 status 为
Completion (IteratorDestructuringAssignmentEvaluation ofAssignmentElementList ，参数 iteratorRecord)。 - 若 status 是突然完成，则
- 若 iteratorRecord.[[Done]] 为
false ，返回 ?IteratorClose (iteratorRecord, status)。 - 返回 ? status。
- 若 iteratorRecord.[[Done]] 为
- 若存在
Elision ，则- 设 status 为
Completion (IteratorDestructuringAssignmentEvaluation ofElision ，参数 iteratorRecord)。 - 若 status 是突然完成，则
- 断言：iteratorRecord.[[Done]] 为
true 。 - 返回 ? status。
- 断言：iteratorRecord.[[Done]] 为
- 设 status 为
- 若存在
AssignmentRestElement ，则- 设 status 为
Completion (IteratorDestructuringAssignmentEvaluation ofAssignmentRestElement ，参数 iteratorRecord)。
- 设 status 为
- 若 iteratorRecord.[[Done]] 为
false ，返回 ?IteratorClose (iteratorRecord, status)。 - 返回 ? status。
13.15.5.3 运行时语义：PropertyDestructuringAssignmentEvaluation
The syntax-directed operation
- 令 propertyNames 为 ? PropertyDestructuringAssignmentEvaluation of
AssignmentPropertyList ，参数 value。 - 令 nextNames 为 ? PropertyDestructuringAssignmentEvaluation of
AssignmentProperty ，参数 value。 - 返回 propertyNames 与 nextNames 的列表连接。
- 令 P 为
IdentifierReference 的 StringValue。 - 令 lRef 为 ?
ResolveBinding (P)。 - 令 v 为 ?
GetV (value, P)。 - 若存在
Initializer 且 v 为undefined ，则- 若 IsAnonymousFunctionDefinition(
Initializer ) 为true ，则- 设 v 为 ? NamedEvaluation of
Initializer ，参数 P。
- 设 v 为 ? NamedEvaluation of
- 否则，
- 令 defaultValue 为 ? Evaluation of
Initializer 。 - 设 v 为 ?
GetValue (defaultValue)。
- 令 defaultValue 为 ? Evaluation of
- 若 IsAnonymousFunctionDefinition(
- 执行 ?
PutValue (lRef, v)。 - 返回 « P »。
- 令 name 为 ? Evaluation of
PropertyName 。 - 执行 ? KeyedDestructuringAssignmentEvaluation of
AssignmentElement ，参数 value 与 name。 - 返回 « name »。
13.15.5.4 运行时语义：RestDestructuringAssignmentEvaluation
The syntax-directed operation
- 令 lRef 为 ? Evaluation of
DestructuringAssignmentTarget 。 - 令 restObj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 ?
CopyDataProperties (restObj, value, excludedNames)。 - 返回 ?
PutValue (lRef, restObj)。
13.15.5.5 运行时语义：IteratorDestructuringAssignmentEvaluation
The syntax-directed operation
- 返回 ? IteratorDestructuringAssignmentEvaluation of
AssignmentElisionElement ，参数 iteratorRecord。
- 执行 ? IteratorDestructuringAssignmentEvaluation of
AssignmentElementList ，参数 iteratorRecord。 - 返回 ? IteratorDestructuringAssignmentEvaluation of
AssignmentElisionElement ，参数 iteratorRecord。
- 返回 ? IteratorDestructuringAssignmentEvaluation of
AssignmentElement ，参数 iteratorRecord。
- 执行 ? IteratorDestructuringAssignmentEvaluation of
Elision ，参数 iteratorRecord。 - 返回 ? IteratorDestructuringAssignmentEvaluation of
AssignmentElement ，参数 iteratorRecord。
- 若 iteratorRecord.[[Done]] 为
false ，则- 执行 ?
IteratorStep (iteratorRecord)。
- 执行 ?
- 返回
unused 。
- 执行 ? IteratorDestructuringAssignmentEvaluation of
Elision ，参数 iteratorRecord。 - 若 iteratorRecord.[[Done]] 为
false ，则- 执行 ?
IteratorStep (iteratorRecord)。
- 执行 ?
- 返回
unused 。
- 若
DestructuringAssignmentTarget 既不是ObjectLiteral 也不是ArrayLiteral ，则- 令 lRef 为 ? Evaluation of
DestructuringAssignmentTarget 。
- 令 lRef 为 ? Evaluation of
- 令 value 为
undefined 。 - 若 iteratorRecord.[[Done]] 为
false ，则- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 若 next 非
done ，则- 设 value 为 next。
- 令 next 为 ?
- 若存在
Initializer 且 value 为undefined ，则- 若 IsAnonymousFunctionDefinition(
Initializer ) 为true 且 IsIdentifierRef ofDestructuringAssignmentTarget 为true ，则- 令 target 为
DestructuringAssignmentTarget 的 StringValue。 - 令 v 为 ? NamedEvaluation of
Initializer ，参数 target。
- 令 target 为
- 否则，
- 令 defaultValue 为 ? Evaluation of
Initializer 。 - 令 v 为 ?
GetValue (defaultValue)。
- 令 defaultValue 为 ? Evaluation of
- 若 IsAnonymousFunctionDefinition(
- 否则，
- 令 v 为 value。
- 若
DestructuringAssignmentTarget 是ObjectLiteral 或ArrayLiteral ，则- 令 nestedAssignmentPattern 为
DestructuringAssignmentTarget 覆盖 的AssignmentPattern 。 - 返回 ? DestructuringAssignmentEvaluation of nestedAssignmentPattern，参数 v。
- 令 nestedAssignmentPattern 为
- 返回 ?
PutValue (lRef, v)。
通过在访问迭代器或求
- 若
DestructuringAssignmentTarget 既不是ObjectLiteral 也不是ArrayLiteral ，则- 令 lRef 为 ? Evaluation of
DestructuringAssignmentTarget 。
- 令 lRef 为 ? Evaluation of
- 令 A 为 !
ArrayCreate (0)。 - 令 n 为 0。
- 当 iteratorRecord.[[Done]] 为
false 重复，- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 若 next 非
done ，则- 执行 !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (n)), next)。 - 设 n 为 n + 1。
- 执行 !
- 令 next 为 ?
- 若
DestructuringAssignmentTarget 既不是ObjectLiteral 也不是ArrayLiteral ，则- 返回 ?
PutValue (lRef, A)。
- 返回 ?
- 令 nestedAssignmentPattern 为
DestructuringAssignmentTarget 覆盖 的AssignmentPattern 。 - 返回 ? DestructuringAssignmentEvaluation of nestedAssignmentPattern，参数 A。
13.15.5.6 运行时语义：KeyedDestructuringAssignmentEvaluation
The syntax-directed operation
- 若
DestructuringAssignmentTarget 既不是ObjectLiteral 也不是ArrayLiteral ，则- 令 lRef 为 ? Evaluation of
DestructuringAssignmentTarget 。
- 令 lRef 为 ? Evaluation of
- 令 v 为 ?
GetV (value, propertyName)。 - 若存在
Initializer 且 v 为undefined ，则- 若 IsAnonymousFunctionDefinition(
Initializer ) 为true 且 IsIdentifierRef ofDestructuringAssignmentTarget 为true ，则- 令 target 为
DestructuringAssignmentTarget 的 StringValue。 - 令 rhsValue 为 ? NamedEvaluation of
Initializer ，参数 target。
- 令 target 为
- 否则，
- 令 defaultValue 为 ? Evaluation of
Initializer 。 - 令 rhsValue 为 ?
GetValue (defaultValue)。
- 令 defaultValue 为 ? Evaluation of
- 若 IsAnonymousFunctionDefinition(
- 否则，
- 令 rhsValue 为 v。
- 若
DestructuringAssignmentTarget 是ObjectLiteral 或ArrayLiteral ，则- 令 assignmentPattern 为
DestructuringAssignmentTarget 覆盖 的AssignmentPattern 。 - 返回 ? DestructuringAssignmentEvaluation of assignmentPattern，参数 rhsValue。
- 令 assignmentPattern 为
- 返回 ?
PutValue (lRef, rhsValue)。
13.16 逗号运算符 ( , )
语法 (Syntax)
13.16.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 lRef 为 ? Evaluation of
Expression 。 - 执行 ?
GetValue (lRef)。 - 令 rRef 为 ? Evaluation of
AssignmentExpression 。 - 返回 ?
GetValue (rRef)。
必须调用
14 ECMAScript 语言：语句与声明 (ECMAScript Language: Statements and Declarations)
语法 (Syntax)
14.1 语句语义 (Statement Semantics)
14.1.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 返回
empty .
- 返回 ? Evaluation of
FunctionDeclaration .
- 令 newLabelSet 为新空
List 。 - 返回 ? LabelledEvaluation of 此
BreakableStatement ，参数 newLabelSet。
14.2 块 (Block)
语法 (Syntax)
14.2.1 静态语义：早期错误 (Static Semantics: Early Errors)
-
若
StatementList 的 LexicallyDeclaredNames 含有重复条目则为语法错误；除非宿主 是 web 浏览器或支持块级函数声明 Web 历史兼容语义 且以下两条件同时为真：- IsStrict(this production) 为
false 。 - 重复条目仅由 FunctionDeclarations 绑定。
- IsStrict(this production) 为
-
若
StatementList 的 LexicallyDeclaredNames 中任一元素也出现在其 VarDeclaredNames 中，则为语法错误。
14.2.2 运行时语义：求值 (Runtime Semantics: Evaluation)
- 返回
empty 。
- 令 oldEnv 为当前执行上下文的 LexicalEnvironment。
- 令 blockEnv 为
NewDeclarativeEnvironment (oldEnv)。 - 执行
BlockDeclarationInstantiation (StatementList , blockEnv)。 - 将当前执行上下文的 LexicalEnvironment 设为 blockEnv。
- 令 blockValue 为
Completion (Evaluation ofStatementList )。 - 将当前执行上下文的 LexicalEnvironment 设回 oldEnv。
- 返回 ? blockValue。
无论控制如何离开
- 令 sl 为 ? Evaluation of
StatementList 。 - 令 s 为
Completion (Evaluation ofStatementListItem )。 - 返回 ?
UpdateEmpty (s, sl)。
eval 的调用都返回 1：
eval("1;;;;;")
eval("1;{}")
eval("1;var a;")14.2.3 BlockDeclarationInstantiation ( code, env )
The abstract operation BlockDeclarationInstantiation takes arguments code (一个 Parse Node) and env (一个
当求值一个
调用时执行以下步骤：
- 令 declarations 为 code 的 LexicallyScopedDeclarations。
- 令 privateEnv 为当前执行上下文的 PrivateEnvironment。
- 对 declarations 中每个元素 d：
- 对 d 的 BoundNames 每个元素 dn：
- 若 IsConstantDeclaration of d 为
true ，则- 执行 ! env.CreateImmutableBinding(dn,
true )。
- 执行 ! env.CreateImmutableBinding(dn,
- 否则，
- Normative Optional若
宿主 是 web 浏览器或支持块级函数声明 Web 历史兼容语义 ，则- 若 ! env.HasBinding(dn) 为
false ，执行 ! env.CreateMutableBinding(dn,false )。
- 若 ! env.HasBinding(dn) 为
- 否则，
- 执行 ! env.CreateMutableBinding(dn,
false )。
- 执行 ! env.CreateMutableBinding(dn,
- 若 IsConstantDeclaration of d 为
- 若 d 是
FunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 或AsyncGeneratorDeclaration ，则- 令 fn 为 d 的唯一 BoundName。
- 令 fo 为 InstantiateFunctionObject of d，参数 env 与 privateEnv。
- Normative Optional若
宿主 是 web 浏览器或支持块级函数声明 Web 历史兼容语义 ，则- 若 env 中 fn 的绑定是未初始化，执行 ! env.InitializeBinding(fn, fo)。
- 否则，
- 断言：d 是
FunctionDeclaration 。 - 执行 ! env.SetMutableBinding(fn, fo,
false )。
- 断言：d 是
- 否则，
- 执行 ! env.InitializeBinding(fn, fo)。
- 对 d 的 BoundNames 每个元素 dn：
- 返回
unused 。
14.3 声明与变量语句 (Declarations and the Variable Statement)
14.3.1 Let 与 Const 声明 (Let and Const Declarations)
let 与 const 声明的变量作用域为当前执行上下文的 LexicalEnvironment。变量在其包含的 let 声明中无
语法 (Syntax)
14.3.1.1 静态语义：早期错误 (Static Semantics: Early Errors)
-
若
BindingList 的 BoundNames 含"let" ，语法错误。 -
若
BindingList 的 BoundNames 含重复条目，语法错误。
-
若未出现
Initializer 且包含该LexicalBinding 的LexicalDeclaration 的 IsConstantDeclaration 为true ，语法错误。
14.3.1.2 运行时语义：求值 (Runtime Semantics: Evaluation)
- 执行 ? Evaluation of
BindingList 。 - 返回
empty 。
- 执行 ? Evaluation of
BindingList 。 - 返回 ? Evaluation of
LexicalBinding 。
- 令 lhs 为 !
ResolveBinding (StringValue ofBindingIdentifier )。 - 执行 !
InitializeReferencedBinding (lhs,undefined )。 - 返回
empty 。
const 声明中。
- 令 bindingId 为
BindingIdentifier 的 StringValue。 - 令 lhs 为 !
ResolveBinding (bindingId)。 - 若 IsAnonymousFunctionDefinition(
Initializer ) 为true ，则- 令 value 为 ? NamedEvaluation of
Initializer ，参数 bindingId。
- 令 value 为 ? NamedEvaluation of
- 否则，
- 令 rhs 为 ? Evaluation of
Initializer 。 - 令 value 为 ?
GetValue (rhs)。
- 令 rhs 为 ? Evaluation of
- 执行 !
InitializeReferencedBinding (lhs, value)。 - 返回
empty 。
- 令 rhs 为 ? Evaluation of
Initializer 。 - 令 value 为 ?
GetValue (rhs)。 - 令 env 为当前执行上下文的 LexicalEnvironment。
- 返回 ? BindingInitialization of
BindingPattern ，参数 value 与 env。
14.3.2 变量语句 (Variable Statement)
var 声明的变量作用域为当前执行上下文的 VariableEnvironment。此类变量在其环境记录实例化时创建并初始化为
语法 (Syntax)
14.3.2.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 执行 ? Evaluation of
VariableDeclarationList 。 - 返回
empty 。
- 执行 ? Evaluation of
VariableDeclarationList 。 - 返回 ? Evaluation of
VariableDeclaration 。
- 返回
empty 。
- 令 bindingId 为
BindingIdentifier 的 StringValue。 - 令 lhs 为 ?
ResolveBinding (bindingId)。 - 若 IsAnonymousFunctionDefinition(
Initializer ) 为true ，则- 令 value 为 ? NamedEvaluation of
Initializer ，参数 bindingId。
- 令 value 为 ? NamedEvaluation of
- 否则，
- 令 rhs 为 ? Evaluation of
Initializer 。 - 令 value 为 ?
GetValue (rhs)。
- 令 rhs 为 ? Evaluation of
- 执行 ?
PutValue (lhs, value)。 - 返回
empty 。
若
- 令 rhs 为 ? Evaluation of
Initializer 。 - 令 rVal 为 ?
GetValue (rhs)。 - 返回 ? BindingInitialization of
BindingPattern ，参数 rVal 与undefined 。
14.3.3 解构绑定模式 (Destructuring Binding Patterns)
语法 (Syntax)
14.3.3.1 运行时语义：PropertyBindingInitialization
The syntax-directed operation
- 令 boundNames 为 ? PropertyBindingInitialization of
BindingPropertyList ，参数 value 与 environment。 - 令 nextNames 为 ? PropertyBindingInitialization of
BindingProperty ，参数 value 与 environment。 - 返回列表连接 boundNames 与 nextNames。
- 令 name 为
SingleNameBinding 的 BoundNames 唯一元素。 - 执行 ? KeyedBindingInitialization of
SingleNameBinding ，参数 value、environment、name。 - 返回 « name »。
- 令 P 为 ? Evaluation of
PropertyName 。 - 执行 ? KeyedBindingInitialization of
BindingElement ，参数 value、environment、P。 - 返回 « P »。
14.3.3.2 运行时语义：RestBindingInitialization
The syntax-directed operation
- 令 lhs 为 ?
ResolveBinding (StringValue ofBindingIdentifier , environment)。 - 令 restObj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 ?
CopyDataProperties (restObj, value, excludedNames)。 - 若 environment 为
undefined ，返回 ?PutValue (lhs, restObj)。 - 返回 ?
InitializeReferencedBinding (lhs, restObj)。
14.3.3.3 运行时语义：KeyedBindingInitialization
The syntax-directed operation
当 environment 传
It is defined piecewise over the following productions:
- 令 v 为 ?
GetV (value, propertyName)。 - 若存在
Initializer 且 v 为undefined ，则- 令 defaultValue 为 ? Evaluation of
Initializer 。 - 设 v 为 ?
GetValue (defaultValue)。
- 令 defaultValue 为 ? Evaluation of
- 返回 ? BindingInitialization of
BindingPattern ，参数 v 与 environment。
- 令 bindingId 为
BindingIdentifier 的 StringValue。 - 令 lhs 为 ?
ResolveBinding (bindingId, environment)。 - 令 v 为 ?
GetV (value, propertyName)。 - 若存在
Initializer 且 v 为undefined ，则- 若 IsAnonymousFunctionDefinition(
Initializer ) 为true ，则- 设 v 为 ? NamedEvaluation of
Initializer ，参数 bindingId。
- 设 v 为 ? NamedEvaluation of
- 否则，
- 令 defaultValue 为 ? Evaluation of
Initializer 。 - 设 v 为 ?
GetValue (defaultValue)。
- 令 defaultValue 为 ? Evaluation of
- 若 IsAnonymousFunctionDefinition(
- 若 environment 为
undefined ，返回 ?PutValue (lhs, v)。 - 返回 ?
InitializeReferencedBinding (lhs, v)。
14.4 空语句 (Empty Statement)
语法 (Syntax)
14.4.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 返回
empty 。
14.5 表达式语句 (Expression Statement)
语法 (Syntax)
{ 开始以避免与 function 或 class 开头以避免与 async function 开头避免与 let [ 开头避免与以数组绑定模式为首绑定的 let
14.5.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 exprRef 为 ? Evaluation of
Expression 。 - 返回 ?
GetValue (exprRef)。
14.6 if 语句 (The if Statement)
语法 (Syntax)
else] 以传统方式解决“悬挂的 else”问题：当关联的 if 有歧义时，将 else 归属最近的尚未匹配的 if。14.6.1 静态语义：早期错误 (Static Semantics: Early Errors)
- 若 IsLabelledFunction(
Statement ) 为true ，语法错误。
仅当实现了
14.6.2 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 exprRef 为 ? Evaluation of
Expression 。 - 令 exprValue 为
ToBoolean (?GetValue (exprRef))。 - 若 exprValue 为
true ，则- 令 stmtCompletion 为
Completion (Evaluation of 第一个Statement )。
- 令 stmtCompletion 为
- 否则，
- 令 stmtCompletion 为
Completion (Evaluation of 第二个Statement )。
- 令 stmtCompletion 为
- 返回 ?
UpdateEmpty (stmtCompletion,undefined )。
- 令 exprRef 为 ? Evaluation of
Expression 。 - 令 exprValue 为
ToBoolean (?GetValue (exprRef))。 - 若 exprValue 为
false ，返回undefined 。 - 否则，
- 令 stmtCompletion 为
Completion (Evaluation ofStatement )。 - 返回 ?
UpdateEmpty (stmtCompletion,undefined )。
- 令 stmtCompletion 为
14.7 迭代语句 (Iteration Statements)
语法 (Syntax)
14.7.1 语义 (Semantics)
14.7.1.1 LoopContinues ( completion, labelSet )
The abstract operation LoopContinues takes arguments completion (一个
- 若 completion 是 normal 完成，返回
true 。 - 若 completion 不是
continue 完成 ，返回false 。 - 若 completion.[[Target]] 为
empty ，返回true 。 - 若 labelSet 含 completion.[[Target]]，返回
true 。- 返回
false 。
- 返回
在
14.7.1.2 运行时语义：LoopEvaluation
The syntax-directed operation
- 返回 ? DoWhileLoopEvaluation of
DoWhileStatement ，参数 labelSet。
- 返回 ? WhileLoopEvaluation of
WhileStatement ，参数 labelSet。
- 返回 ? ForLoopEvaluation of
ForStatement ，参数 labelSet。
- 返回 ? ForInOfLoopEvaluation of
ForInOfStatement ，参数 labelSet。
14.7.2 do-while 语句 (The do-while Statement)
语法 (Syntax)
14.7.2.1 静态语义：早期错误 (Static Semantics: Early Errors)
- 若 IsLabelledFunction(
Statement ) 为true ，语法错误。
仅当实现了
14.7.2.2 运行时语义：DoWhileLoopEvaluation
The syntax-directed operation
- 令 V 为
undefined 。 - 重复，
- 令 stmtResult 为
Completion (Evaluation ofStatement )。 - 若
LoopContinues (stmtResult, labelSet) 为false ，返回 ?UpdateEmpty (stmtResult, V)。 - 若 stmtResult.[[Value]] 非
empty ，令 V = 该值。 - 令 exprRef 为 ? Evaluation of
Expression 。 - 令 exprValue 为 ?
GetValue (exprRef)。 - 若
ToBoolean (exprValue) 为false ，返回 V。
- 令 stmtResult 为
14.7.3 while 语句 (The while Statement)
语法 (Syntax)
14.7.3.1 静态语义：早期错误 (Static Semantics: Early Errors)
- 若 IsLabelledFunction(
Statement ) 为true ，语法错误。
仅当实现了
14.7.3.2 运行时语义：WhileLoopEvaluation
The syntax-directed operation
- 令 V 为
undefined 。 - 重复，
- 令 exprRef 为 ? Evaluation of
Expression 。 - 令 exprValue 为 ?
GetValue (exprRef)。 - 若
ToBoolean (exprValue) 为false ，返回 V。 - 令 stmtResult 为
Completion (Evaluation ofStatement )。 - 若
LoopContinues (stmtResult, labelSet) 为false ，返回 ?UpdateEmpty (stmtResult, V)。 - 若 stmtResult.[[Value]] 非
empty ，设 V 为该值。
- 令 exprRef 为 ? Evaluation of
14.7.4 for 语句 (The for Statement)
语法 (Syntax)
14.7.4.1 静态语义：早期错误 (Static Semantics: Early Errors)
- 若 IsLabelledFunction(
Statement ) 为true ，语法错误。
仅当实现
- 若
LexicalDeclaration 的 BoundNames 中任一元素出现在Statement 的 VarDeclaredNames 中，语法错误。
14.7.4.2 运行时语义：ForLoopEvaluation
The syntax-directed operation
- 若首个
Expression 存在，令 exprRef 为其求值；执行 ?GetValue (exprRef)。 - 若第二个存在，令 test 为该表达式，否则
empty 。 - 若第三个存在，令 increment 为该表达式，否则
empty 。 - 返回 ?
ForBodyEvaluation (test, increment,Statement , « », labelSet)。
- 执行 ? Evaluation of
VariableDeclarationList 。 - 若首个
Expression 存在令 test = 它，否则empty 。 - 若第二个
Expression 存在令 increment = 它，否则empty 。 - 返回 ?
ForBodyEvaluation (test, increment,Statement , « », labelSet)。
- 令 oldEnv 为当前执行上下文的 LexicalEnvironment。
- 令 loopEnv 为
NewDeclarativeEnvironment (oldEnv)。 - 令 isConst 为
LexicalDeclaration 的 IsConstantDeclaration。 - 令 boundNames 为
LexicalDeclaration 的 BoundNames。 - 对 boundNames 中每个 dn：
- 若 isConst 为
true ，执行 ! loopEnv.CreateImmutableBinding(dn,true )。 - 否则执行 ! loopEnv.CreateMutableBinding(dn,
false )。
- 若 isConst 为
- 设置当前执行上下文 LexicalEnvironment 为 loopEnv。
- 令 forDcl 为
Completion (Evaluation ofLexicalDeclaration )。 - 若 forDcl 为突然完成：
- 恢复 LexicalEnvironment 为 oldEnv。
- 返回 ? forDcl。
- 若 isConst 为
false ，令 perIterationLets = boundNames；否则为空列表。 - 若首个
Expression 存在令 test 为其，否则empty 。 - 若第二个
Expression 存在令 increment 为其，否则empty 。 - 令 bodyResult 为
Completion (ForBodyEvaluation (test, increment,Statement , perIterationLets, labelSet))。 - 恢复 LexicalEnvironment 为 oldEnv。
- 返回 ? bodyResult。
14.7.4.3 ForBodyEvaluation ( test, increment, stmt, perIterationBindings, labelSet )
The abstract operation ForBodyEvaluation takes arguments test (
- 令 V =
undefined 。 - 执行 ?
CreatePerIterationEnvironment (perIterationBindings)。 - 重复：
- 若 test 非
empty ： - 令 result 为
Completion (Evaluation of stmt)。 - 若
LoopContinues (result, labelSet) 为false ，返回 ?UpdateEmpty (result, V)。 - 若 result.[[Value]] 非
empty ，设 V 为该值。 - 执行 ?
CreatePerIterationEnvironment (perIterationBindings)。 - 若 increment 非
empty ：- 令 incRef 为 ? Evaluation of increment。
- 执行 ?
GetValue (incRef)。
- 若 test 非
14.7.4.4 CreatePerIterationEnvironment ( perIterationBindings )
The abstract operation CreatePerIterationEnvironment takes argument perIterationBindings (字符串列表) and returns 返回
- 若 perIterationBindings 非空：
- 令 lastIterationEnv 为当前执行上下文的 LexicalEnvironment。
- 令 outer 为 lastIterationEnv.[[OuterEnv]]。
- 断言 outer 非
null 。 - 令 thisIterationEnv 为
NewDeclarativeEnvironment (outer)。 - 对 perIterationBindings 中每个 bn：
- 执行 ! thisIterationEnv.CreateMutableBinding(bn,
false )。 - 令 lastValue 为 ? lastIterationEnv.GetBindingValue(bn,
true )。 - 执行 ! thisIterationEnv.InitializeBinding(bn, lastValue)。
- 执行 ! thisIterationEnv.CreateMutableBinding(bn,
- 将当前 LexicalEnvironment 设为 thisIterationEnv。
- 返回
unused 。
14.7.5 for-in、for-of 与 for-await-of 语句
语法 (Syntax)
本节由附录
14.7.5.1 静态语义：早期错误 (Static Semantics: Early Errors)
- 若 IsLabelledFunction(
Statement ) 为true ，语法错误。
仅在实现
- 若
LeftHandSideExpression 为ObjectLiteral 或ArrayLiteral ，其必须覆盖 一个AssignmentPattern 。 - 否则若其 AssignmentTargetType 为
invalid ，语法错误。
- 若
ForDeclaration 的 BoundNames 含"let" ，语法错误。 - 若 BoundNames 的任一元素出现在
Statement 的 VarDeclaredNames 中，语法错误。 - 若 BoundNames 含重复条目，语法错误。
14.7.5.2 静态语义：IsDestructuring
The syntax-directed operation
- 若
PrimaryExpression 是ObjectLiteral 或ArrayLiteral ，返回true 。 - 否则返回
false 。
- 返回
false 。
- 返回 IsDestructuring of
ForBinding 。
- 返回
false 。
- 返回
true 。
本节由附录
14.7.5.3 运行时语义：ForDeclarationBindingInitialization
The syntax-directed operation
It is defined piecewise over the following productions:
- 返回 ? BindingInitialization of
ForBinding ，参数 value 与 environment。
14.7.5.4 运行时语义：ForDeclarationBindingInstantiation
The syntax-directed operation
- 对
ForBinding 的 BoundNames 每个 name：- 若 IsConstantDeclaration of
LetOrConst 为true ，执行 ! environment.CreateImmutableBinding(name,true )。 - 否则执行 ! environment.CreateMutableBinding(name,
false )。
- 若 IsConstantDeclaration of
- 返回
unused 。
14.7.5.5 运行时语义：ForInOfLoopEvaluation
The syntax-directed operation
- 令 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 (BoundNames ofForDeclaration ,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 (BoundNames ofForDeclaration ,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 (BoundNames ofForDeclaration ,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 (字符串列表), expr (
- 令 oldEnv 为当前执行上下文 LexicalEnvironment。
- 若 uninitializedBoundNames 非空：
- 断言无重复。
- 令 newEnv 为
NewDeclarativeEnvironment (oldEnv)。 - 对每个 name 执行 ! newEnv.CreateMutableBinding(name,
false )。 - 设置当前 LexicalEnvironment 为 newEnv。
- 令 exprRef 为
Completion (Evaluation of expr)。 - 恢复 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 。 - 若为
async-iterate 则 iteratorKind =async 否则sync 。 - 返回 ?
GetIterator (exprValue, iteratorKind)。
- 断言 iterationKind 为
14.7.5.7
ForIn/OfBodyEvaluation (
lhs: Parse Node,
stmt: Statement Parse Node,
iteratorRecord: Iterator Record,
iterationKind: enumerate 或 iterate ,
lhsKind: assignment / var-binding / lexical-binding ,
labelSet: 字符串列表,
可选 iteratorKind: sync / async ,
): 正常或突然完成
The abstract operation UNKNOWN takes UNPARSEABLE ARGUMENTS. It performs the following steps when called:
- 若未给出 iteratorKind，设为
sync 。 - 令 oldEnv 为当前 LexicalEnvironment。
- 令 V =
undefined 。 - 令 destructuring = IsDestructuring of lhs。
- 若 destructuring 为
true 且 lhsKind 为assignment ：- 断言 lhs 是
LeftHandSideExpression 。 - 令 assignmentPattern 为其
覆盖 的AssignmentPattern 。
- 断言 lhs 是
- 循环：
- 令 nextResult = ? Call(iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]])。
- 若 iteratorKind 为
async ，设 nextResult = ?Await (nextResult)。 - 若 nextResult 非 Object 抛
TypeError 。 - 令 done = ?
IteratorComplete (nextResult)。 - 若 done 为
true ，返回 V。 - 令 nextValue = ?
IteratorValue (nextResult)。 - 若 lhsKind 为
assignment 或var-binding ：- 若 destructuring 为
true ：- 若 lhsKind 为
assignment ：- 令 status =
Completion (DestructuringAssignmentEvaluation of assignmentPattern，参数 nextValue)。
- 令 status =
- 否则 (var-binding)：
- 断言 lhs 为
ForBinding 。 - 令 status =
Completion (BindingInitialization of lhs, 参数 nextValue 与undefined )。
- 断言 lhs 为
- 若 lhsKind 为
- 否则：
- 令 lhsRef =
Completion (Evaluation of lhs)（可重复求值）。 - 若 lhsKind 为
assignment 且 AssignmentTargetType 为web-compat 抛ReferenceError 。 - 若 lhsRef 为突然完成则 status = lhsRef；否则 status =
Completion (PutValue (lhsRef.[[Value]], nextValue))。
- 令 lhsRef =
- 若 destructuring 为
- 否则 (lexical-binding)：
- 断言 lhs 为
ForDeclaration 。 - 令 iterationEnv =
NewDeclarativeEnvironment (oldEnv)。 - 执行 ForDeclarationBindingInstantiation of lhs 参数 iterationEnv。
- 设当前 LexicalEnvironment = iterationEnv。
- 若 destructuring 为
true ：- status =
Completion (ForDeclarationBindingInitialization of lhs, 参数 nextValue 与 iterationEnv)。
- status =
- 否则：
- 断言 lhs 绑定单一名字。
- 令 lhsName 为唯一 BoundName。
- 令 lhsRef = !
ResolveBinding (lhsName)。 - status =
Completion (InitializeReferencedBinding (lhsRef, nextValue))。
- 断言 lhs 为
- 若 status 为突然完成：
- 恢复 LexicalEnvironment 为 oldEnv。
- 若 iteratorKind 为
async 返回 ?AsyncIteratorClose (iteratorRecord, status)。 - 若 iterationKind 为
enumerate 返回 ? status。 - 否则返回 ?
IteratorClose (iteratorRecord, status)。
- 令 result 为
Completion (Evaluation of stmt)。 - 恢复 LexicalEnvironment 为 oldEnv。
- 若
LoopContinues (result, labelSet) 为false ：- 若 iterationKind 为
enumerate 返回 ?UpdateEmpty (result, V)。 - 否则：
- 设 status =
Completion (UpdateEmpty (result, V))。 - 若 iteratorKind 为
async 返回 ?AsyncIteratorClose (iteratorRecord, status)。 - 返回 ?
IteratorClose (iteratorRecord, status)。
- 设 status =
- 若 iterationKind 为
- 若 result.[[Value]] 非
empty ，设 V = 该值。
14.7.5.8 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 bindingId 为
BindingIdentifier 的 StringValue。 - 返回 ?
ResolveBinding (bindingId)。
14.7.5.9 EnumerateObjectProperties ( O )
The abstract operation EnumerateObjectProperties takes argument O (一个 Object) and returns 一个迭代器对象. It performs the following steps when called:
迭代器的 throw 与 return 方法为 next 决定是否返回一个
另外，若 O 及其原型链均非 Proxy /
- 原型链中任意对象的 [[Prototype]] 发生变化；
- O 或其原型链某对象删除属性；
- 原型链某对象新增属性；
- O 或原型链某对象属性的 [[Enumerable]] 值改变。
实现无需直接实现
下列生成器函数是符合规则的示例：
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 Objects)
For-In Iterator 表示对特定对象的一次具体迭代，不能被脚本直接访问，仅用于描述
14.7.5.10.1 CreateForInIterator ( object )
The abstract operation CreateForInIterator takes argument object (一个 Object) and returns 一个
- 令 iterator =
OrdinaryObjectCreate (%ForInIteratorPrototype% , « [[Object]], [[ObjectWasVisited]], [[VisitedKeys]], [[RemainingKeys]] »)。 - iterator.[[Object]] ← object。
- iterator.[[ObjectWasVisited]] ←
false 。 - iterator.[[VisitedKeys]] ← 空
List 。 - iterator.[[RemainingKeys]] ← 空
List 。 - 返回 iterator。
14.7.5.10.2 %ForInIteratorPrototype% 对象
%ForInIteratorPrototype% 对象：
- 其属性被所有
For-In Iterator 对象继承； - 是
普通对象 ； - [[Prototype]] 为
%Iterator.prototype% ； - 不可被脚本直接访问；
- 具有如下属性：
14.7.5.10.2.1 %ForInIteratorPrototype%.next ( )
- 令 O 为
this 。 - 断言 O
是 Object 。 - 断言 O 具
For-In Iterator 所有内部槽。 - 令 object = O.[[Object]]。
- 重复：
- 若 O.[[ObjectWasVisited]] 为
false ：- 令 keys = ? object.[[OwnPropertyKeys]]()。
- 对 keys 每个 key：
- 若 key 是 String，追加到 O.[[RemainingKeys]]。
- 设 O.[[ObjectWasVisited]] =
true 。
- 当 O.[[RemainingKeys]] 非空重复：
- 令 r 为首元素。
- 移除之。
- 若 O.[[VisitedKeys]] 不含 r：
- 令 desc = ? object.[[GetOwnProperty]](r)。
- 若 desc 非
undefined ：- 追加 r 至 O.[[VisitedKeys]]。
- 若 desc.[[Enumerable]] 为
true ，返回CreateIteratorResultObject (r,false )。
- 设 object = ? object.[[GetPrototypeOf]]()。
- 设 O.[[Object]] = object。
- 设 O.[[ObjectWasVisited]] =
false 。 - 若 object 为
null ，返回CreateIteratorResultObject (undefined ,true )。
- 若 O.[[ObjectWasVisited]] 为
14.7.5.10.3 For-In 迭代器实例属性 (Properties of For-In Iterator Instances)
实例为
| 内部槽 | 类型 | 描述 |
|---|---|---|
| [[Object]] | Object | 被 |
| [[ObjectWasVisited]] | Boolean | 若已在 [[Object]] 上调用 [[OwnPropertyKeys]] 则 |
| [[VisitedKeys]] | 字符串列表 | 迄今已发出的键。 |
| [[RemainingKeys]] | 字符串列表 | 当前对象剩余未发出的键（在遍历原型链之前）。 |
14.8 continue 语句 (The continue Statement)
语法 (Syntax)
14.8.1 静态语义：早期错误 (Static Semantics: Early Errors)
- 若该
ContinueStatement 未（直接或间接且不跨函数或static初始化块）嵌套于IterationStatement ，语法错误。
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 语句 (The break Statement)
语法 (Syntax)
14.9.1 静态语义：早期错误 (Static Semantics: Early Errors)
- 若该
BreakStatement 未（直接或间接且不跨函数或static初始化块）嵌套于IterationStatement 或SwitchStatement ，语法错误。
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 语句 (The return Statement)
语法 (Syntax)
return 语句使函数终止执行并（大多数情况下）向调用者返回值；若省略 try/finally）中，返回值可能被之后的
14.10.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- 返回
ReturnCompletion (undefined )。
- 令 exprRef 为 ? Evaluation of
Expression 。 - 令 exprValue 为 ?
GetValue (exprRef)。 - 若
GetGeneratorKind () 为async ，设 exprValue = ?Await (exprValue)。 - 返回
ReturnCompletion (exprValue)。
14.11 with 语句 (The with Statement)
语法 (Syntax)
with 语句把对象环境记录加入当前词法环境，然后使用扩展环境执行语句，结束后恢复原环境。
14.11.1 静态语义：早期错误 (Static Semantics: Early Errors)
- 若 IsStrict(this production) 为
true ，语法错误。 - 若 IsLabelledFunction(
Statement ) 为true ，语法错误。
仅在实现
14.11.2 运行时语义：求值 (Runtime Semantics: Evaluation)
- 令 val 为 ? Evaluation of
Expression 。 - 令 obj 为 ?
ToObject (?GetValue (val))。 - 令 oldEnv 为当前 LexicalEnvironment。
- 令 newEnv 为
NewObjectEnvironment (obj,true , oldEnv)。 - 设置当前 LexicalEnvironment 为 newEnv。
- 令 C 为
Completion (Evaluation ofStatement )。 - 恢复 LexicalEnvironment 为 oldEnv。
- 返回 ?
UpdateEmpty (C,undefined )。
无论
14.12 switch 语句 (The switch Statement)
语法 (Syntax)
14.12.1 静态语义：早期错误 (Static Semantics: Early Errors)
-
若
CaseBlock 的 LexicallyDeclaredNames 含重复条目则语法错误；除非宿主 是 web 浏览器或支持块级函数声明 Web 历史兼容语义 且：- IsStrict(this production) 为
false ； - 重复条目仅由 FunctionDeclarations 绑定。
- IsStrict(this production) 为
- 若
CaseBlock 的 LexicallyDeclaredNames 与其 VarDeclaredNames 有交集，语法错误。
14.12.2 运行时语义：CaseBlockEvaluation
The syntax-directed operation
- 返回
undefined 。
- V ←
undefined 。 - A ← 按源码顺序的
CaseClause 列表。 - found ←
false 。 - 对每个 C ∈ A：
- 若 found 为
false ，设 found ← ?CaseClauseIsSelected (C, input)。 - 若 found 为
true ：- R ←
Completion (Evaluation of C)。 - 若 R.[[Value]] 非
empty ，V ← R.[[Value]]。 - 若 R 为突然完成，返回 ?
UpdateEmpty (R, V)。
- R ←
- 若 found 为
- 返回 V。
- V ←
undefined 。 - 若首个
CaseClauses 存在，A ← 其CaseClause 列表；否则空列表。 - found ←
false 。 - 对 A 中每个 C：
- 若 found 为
false ，found ← ?CaseClauseIsSelected (C, input)。 - 若 found 为
true ：- R ←
Completion (Evaluation of C)。 - 若 R.[[Value]] 非
empty ，V ← R.[[Value]]。 - 若 R 为突然完成，返回 ?
UpdateEmpty (R, V)。
- R ←
- 若 found 为
- foundInB ←
false 。 - 若第二个
CaseClauses 存在，B ← 其列表；否则空列表。 - 若 found 为
false ：- 对 B 中每个 C：
- 若 foundInB 为
false ，foundInB ← ?CaseClauseIsSelected (C, input)。 - 若 foundInB 为
true ：- R ←
Completion (Evaluation of C)。 - 若 R.[[Value]] 非
empty ，V ← R.[[Value]]。 - 若 R 为突然完成，返回 ?
UpdateEmpty (R, V)。
- R ←
- 若 foundInB 为
- 对 B 中每个 C：
- 若 foundInB 为
true ，返回 V。 - defaultR ←
Completion (Evaluation ofDefaultClause )。 - 若 defaultR.[[Value]] 非
empty ，V ← defaultR.[[Value]]。 - 若 defaultR 为突然完成，返回 ?
UpdateEmpty (defaultR, V)。 - 注：以下再次遍历 B。
- 对 B 中每个 C：
- R ←
Completion (Evaluation of C)。 - 若 R.[[Value]] 非
empty ，V ← R.[[Value]]。 - 若 R 为突然完成，返回 ?
UpdateEmpty (R, V)。
- R ←
- 返回 V。
14.12.3 CaseClauseIsSelected ( C, input )
The abstract operation CaseClauseIsSelected takes arguments C (
- 断言 C 为产生式
CaseClause : case Expression : StatementList opt - 令 exprRef 为 ? Evaluation of C 的
Expression 。 - 令 clauseSelector 为 ?
GetValue (exprRef)。 - 返回
IsStrictlyEqual (input, clauseSelector)。
该操作不执行 C 的
14.12.4 运行时语义：求值 (Runtime Semantics: Evaluation)
- exprRef ← ? Evaluation of
Expression 。 - switchValue ← ?
GetValue (exprRef)。 - oldEnv ← 当前 LexicalEnvironment。
- blockEnv ←
NewDeclarativeEnvironment (oldEnv)。 - 执行
BlockDeclarationInstantiation (CaseBlock , blockEnv)。 - 设置 LexicalEnvironment = blockEnv。
- R ←
Completion (CaseBlockEvaluation ofCaseBlock , 参数 switchValue)。 - 恢复 LexicalEnvironment = oldEnv。
- 返回 R。
无论控制如何离开
- 返回
empty 。
- 返回 ? Evaluation of
StatementList 。
- 返回
empty 。
- 返回 ? Evaluation of
StatementList 。
14.13 带标签语句 (Labelled Statements)
语法 (Syntax)
break / continue；语言无 goto。标签递归嵌套形成“当前标签集合”。
14.13.1 静态语义：早期错误 (Static Semantics: Early Errors)
14.13.2 静态语义：IsLabelledFunction ( stmt )
The abstract operation
- 若 stmt 不是
LabelledStatement ，返回false 。 - 令 item 为其
LabelledItem 。 - 若 item 是
LabelledItem : FunctionDeclaration true 。 - 令 subStmt 为 item 的
Statement 。 - 返回 IsLabelledFunction(subStmt)。
14.13.3 运行时语义：求值 (Runtime Semantics: Evaluation)
- 返回 ? LabelledEvaluation of 此
LabelledStatement ，参数 « »。
14.13.4 运行时语义：LabelledEvaluation
The syntax-directed operation
- stmtResult ←
Completion (LoopEvaluation ofIterationStatement , 参数 labelSet)。 - 若 stmtResult 是
break 完成 ：- 且 stmtResult.[[Target]] 为
empty ：- 若 stmtResult.[[Value]] 为
empty ，设其为NormalCompletion (undefined )；否则设为其值的NormalCompletion 。
- 若 stmtResult.[[Value]] 为
- 且 stmtResult.[[Target]] 为
- 返回 ? stmtResult。
- stmtResult ←
Completion (Evaluation ofSwitchStatement )。 - 若为 break 且 [[Target]] 为
empty ：- 若 [[Value]] 为
empty 设为NormalCompletion (undefined ) 否则为该值。
- 若 [[Value]] 为
- 返回 ? stmtResult。
- label ← StringValue of
LabelIdentifier 。 - newLabelSet ← 连接 labelSet 与 « label »。
- stmtResult ←
Completion (LabelledEvaluation ofLabelledItem , 参数 newLabelSet)。 - 若 stmtResult 是 break 且 [[Target]] 为 label，则设为
NormalCompletion (stmtResult.[[Value]])。 - 返回 ? stmtResult。
- 返回 ? Evaluation of
FunctionDeclaration 。
- 返回 ? Evaluation of
Statement 。
14.14 throw 语句 (The throw Statement)
语法 (Syntax)
14.14.1 运行时语义：求值 (Runtime Semantics: Evaluation)
- exprRef ← ? Evaluation of
Expression 。 - exprValue ← ?
GetValue (exprRef)。 - 返回
ThrowCompletion (exprValue)。
14.15 try 语句 (The try Statement)
语法 (Syntax)
try 语句封装可能发生异常的代码块；catch 提供处理逻辑；被捕获异常绑定到
14.15.1 静态语义：早期错误 (Static Semantics: Early Errors)
CatchParameter 的 BoundNames 若含重复，语法错误。- 若其任一元素出现在
Block 的 LexicallyDeclaredNames 中，语法错误。 - 若其任一元素出现在
Block 的 VarDeclaredNames 中语法错误；除非CatchParameter 为CatchParameter : BindingIdentifier 宿主 为 web 浏览器或支持Catch 块中的 VariableStatements 。
14.15.2 运行时语义：CatchClauseEvaluation
The syntax-directed operation
- oldEnv ← 当前 LexicalEnvironment。
- catchEnv ←
NewDeclarativeEnvironment (oldEnv)。 - 对
CatchParameter 的 BoundNames 中每个 argName：- 执行 ! catchEnv.CreateMutableBinding(argName,
false )。
- 执行 ! catchEnv.CreateMutableBinding(argName,
- 设置 LexicalEnvironment = catchEnv。
- status ←
Completion (BindingInitialization ofCatchParameter ，参数 thrownValue 与 catchEnv)。 - 若 status 为突然完成：
- 恢复 LexicalEnvironment = oldEnv。
- 返回 ? status。
- B ←
Completion (Evaluation ofBlock )。 - 恢复 LexicalEnvironment = oldEnv。
- 返回 ? B。
- 返回 ? Evaluation of
Block 。
无论
14.15.3 运行时语义：求值 (Runtime Semantics: Evaluation)
- B ←
Completion (Evaluation ofBlock )。 - 若 B 为
throw 完成 ，C ←Completion (CatchClauseEvaluation ofCatch , 参数 B.[[Value]])；否则 C ← B。 - 返回 ?
UpdateEmpty (C,undefined )。
- B ←
Completion (Evaluation ofBlock )。 - F ←
Completion (Evaluation ofFinally )。 - 若 F 为 normal，设 F ← B。
- 返回 ?
UpdateEmpty (F,undefined )。
- B ←
Completion (Evaluation ofBlock )。 - 若 B 为 throw，C ←
Completion (CatchClauseEvaluation ofCatch , 参数 B.[[Value]])；否则 C ← B。 - F ←
Completion (Evaluation ofFinally )。 - 若 F 为 normal，设 F ← C。
- 返回 ?
UpdateEmpty (F,undefined )。
14.16 debugger 语句 (The debugger Statement)
语法 (Syntax)
14.16.1 运行时语义：求值 (Runtime Semantics: Evaluation)
求值
- 若实现定义的调试设施可用且启用：
- 执行实现定义调试动作。
- 返回实现定义的新
Completion Record 。
- 否则返回
empty 。
15 ECMAScript 语言：函数与类 (ECMAScript Language: Functions and Classes)
15.1 参数列表 (Parameter Lists)
语法 (Syntax)
15.1.1 静态语义：早期错误 (Static Semantics: Early Errors)
-
如果
FormalParameters 的 BoundNames 包含任意重复元素，则为语法错误。
-
如果
FormalParameterList 的 IsSimpleParameterList 为false 且其 BoundNames 含有任意重复元素，则为语法错误。
同一个
15.1.2 静态语义：ContainsExpression
The syntax-directed operation
- 返回
false 。
- 返回 ContainsExpression of
BindingPropertyList 。
- 返回
false 。
- 返回 ContainsExpression of
BindingRestElement 。
- 返回 ContainsExpression of
BindingElementList 。
- 令 has 为 ContainsExpression of
BindingElementList 。 - 如果 has 为
true ，返回true 。 - 返回 ContainsExpression of
BindingRestElement 。
- 令 has 为 ContainsExpression of
BindingPropertyList 。 - 如果 has 为
true ，返回true 。 - 返回 ContainsExpression of
BindingProperty 。
- 令 has 为 ContainsExpression of
BindingElementList 。 - 如果 has 为
true ，返回true 。 - 返回 ContainsExpression of
BindingElisionElement 。
- 返回 ContainsExpression of
BindingElement 。
- 令 has 为 IsComputedPropertyKey of
PropertyName 。 - 如果 has 为
true ，返回true 。 - 返回 ContainsExpression of
BindingElement 。
- 返回
true 。
- 返回
false 。
- 返回
true 。
- 返回
false 。
- 返回 ContainsExpression of
BindingPattern 。
- 返回
false 。
- 如果 ContainsExpression of
FormalParameterList 为true ，返回true 。 - 返回 ContainsExpression of
FunctionRestParameter 。
- 如果 ContainsExpression of
FormalParameterList 为true ，返回true 。 - 返回 ContainsExpression of
FormalParameter 。
- 返回
false 。
- 令 formals 为由
CoverParenthesizedExpressionAndArrowParameterList 覆盖 的ArrowFormalParameters 。 - 返回 ContainsExpression of formals。
- 返回
false 。
15.1.3 静态语义：IsSimpleParameterList
The syntax-directed operation
- 返回
false 。
- 返回
false 。
- 返回
true 。
- 返回
false 。
- 返回
true 。
- 返回
false 。
- 返回
false 。
- 如果 IsSimpleParameterList of
FormalParameterList 为false ，返回false 。 - 返回 IsSimpleParameterList of
FormalParameter 。
- 返回 IsSimpleParameterList of
BindingElement 。
- 返回
true 。
- 令 formals 为由
CoverParenthesizedExpressionAndArrowParameterList 覆盖 的ArrowFormalParameters 。 - 返回 IsSimpleParameterList of formals。
- 返回
true 。
- 令 head 为由
CoverCallExpressionAndAsyncArrowHead 覆盖 的AsyncArrowHead 。 - 返回 IsSimpleParameterList of head。
15.1.4 静态语义：HasInitializer
The syntax-directed operation
- 返回
false 。
- 返回
true 。
- 返回
false 。
- 返回
true 。
- 如果 HasInitializer of
FormalParameterList 为true ，返回true 。 - 返回 HasInitializer of
FormalParameter 。
15.1.5 静态语义：ExpectedArgumentCount
The syntax-directed operation
- 返回 0。
- 返回
FormalParameterList 的 ExpectedArgumentCount。
- 如果 HasInitializer of
FormalParameter 为true ，返回 0。 - 返回 1。
- 令 count 为
FormalParameterList 的 ExpectedArgumentCount。 - 如果 HasInitializer of
FormalParameterList 为true 或 HasInitializer ofFormalParameter 为true ，返回 count。 - 返回 count + 1。
- 返回 1。
- 令 formals 为由
CoverParenthesizedExpressionAndArrowParameterList 覆盖 的ArrowFormalParameters 。 - 返回 formals 的 ExpectedArgumentCount。
- 如果 HasInitializer of
FormalParameter 为true ，返回 0。 - 返回 1。
- 返回 1。
15.2 函数定义 (Function Definitions)
语法 (Syntax)
15.2.1 静态语义：早期错误 (Static Semantics: Early Errors)
-
若 IsStrict(
FormalParameters ) 为true ，则应用UniqueFormalParameters : FormalParameters 早期错误规则 。 -
若出现
BindingIdentifier 且 IsStrict(BindingIdentifier ) 为true ，并且其 StringValue 为"eval" 或"arguments" ，则为语法错误。 -
若 FunctionBodyContainsUseStrict(
FunctionBody ) 为true 且 IsSimpleParameterList(FormalParameters ) 为false ，则为语法错误。 -
若
FormalParameters 的 BoundNames 中任一元素也出现在FunctionBody 的 LexicallyDeclaredNames 中，则为语法错误。 -
若
FormalParameters ContainsSuperProperty 为true ，则为语法错误。 -
若
FunctionBody ContainsSuperProperty 为true ，则为语法错误。 -
若
FormalParameters ContainsSuperCall 为true ，则为语法错误。 -
若
FunctionBody ContainsSuperCall 为true ，则为语法错误。
-
若
FunctionStatementList 的 LexicallyDeclaredNames 含有重复条目，则为语法错误。 -
若
FunctionStatementList 的 LexicallyDeclaredNames 中任一元素也出现在其 VarDeclaredNames 中，则为语法错误。 -
若 ContainsDuplicateLabels(
FunctionStatementList , « ») 为true ，则为语法错误。 -
若 ContainsUndefinedBreakTarget(
FunctionStatementList , « ») 为true ，则为语法错误。 -
若 ContainsUndefinedContinueTarget(
FunctionStatementList , « », « ») 为true ，则为语法错误。
15.2.2 静态语义：FunctionBodyContainsUseStrict
The syntax-directed operation
- 若
FunctionBody 的指令序言 (Directive Prologue) 含有 Use Strict 指令，返回true ；否则返回false 。
15.2.3 运行时语义：EvaluateFunctionBody
The syntax-directed operation
- 执行 ?
FunctionDeclarationInstantiation (functionObject, argumentsList)。 - 执行 ? Evaluation of
FunctionStatementList 。 - 注：若上一步产生
正常完成 ，则求值已到达FunctionStatementList 末尾。 - 返回
ReturnCompletion (undefined )。
15.2.4 运行时语义：InstantiateOrdinaryFunctionObject
The syntax-directed operation
- 令 name 为
BindingIdentifier 的 StringValue。 - 令 sourceText 为
FunctionDeclaration 匹配的源文本。 - 令 F 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText,FormalParameters ,FunctionBody ,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (F, name)。 - 执行
MakeConstructor (F)。 - 返回 F。
- 令 sourceText 为
FunctionDeclaration 匹配的源文本。 - 令 F 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText,FormalParameters ,FunctionBody ,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (F,"default" )。 - 执行
MakeConstructor (F)。 - 返回 F。
匿名 export default 声明的一部分，其函数代码因此总是严格模式代码。
15.2.5 运行时语义：InstantiateOrdinaryFunctionExpression : 一个 ECMAScript 函数对象
The syntax-directed operation UNKNOWN takes UNPARSEABLE ARGUMENTS. It is defined piecewise over the following productions:
- 若 name 不存在，设 name 为
"" 。 - 令 env 为当前执行上下文的 LexicalEnvironment。
- 令 privateEnv 为当前执行上下文的 PrivateEnvironment。
- 令 sourceText 为
FunctionExpression 匹配的源文本。 - 令 closure 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText,FormalParameters ,FunctionBody ,non-lexical-this , env, 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 。
- 返回 InstantiateOrdinaryFunctionExpression of
FunctionExpression 。
每个通过
- 返回
undefined 。
15.3 箭头函数定义 (Arrow Function Definitions)
语法 (Syntax)
补充语法 (Supplemental Syntax)
当处理产生式实例：
时，使用以下语法细化对
15.3.1 静态语义：早期错误 (Static Semantics: Early Errors)
-
若
ArrowParameters ContainsYieldExpression 为true ，则为语法错误。 -
若
ArrowParameters ContainsAwaitExpression 为true ，则为语法错误。 -
若 ConciseBodyContainsUseStrict(
ConciseBody ) 为true 且 IsSimpleParameterList(ArrowParameters ) 为false ，则为语法错误。 -
若
ArrowParameters 的 BoundNames 中任一元素也出现在ConciseBody 的 LexicallyDeclaredNames 中，则为语法错误。
15.3.2 静态语义：ConciseBodyContainsUseStrict
The syntax-directed operation
- 返回
false 。
- 返回 FunctionBodyContainsUseStrict(
FunctionBody )。
15.3.3 运行时语义：EvaluateConciseBody
The syntax-directed operation
- 执行 ?
FunctionDeclarationInstantiation (functionObject, argumentsList)。 - 返回 ? Evaluation of
ExpressionBody 。
15.3.4 运行时语义：InstantiateArrowFunctionExpression : 一个 ECMAScript 函数对象
The syntax-directed operation UNKNOWN takes UNPARSEABLE ARGUMENTS. It is defined piecewise over the following productions:
- 若 name 不存在，设 name 为
"" 。 - 令 env 为当前执行上下文的 LexicalEnvironment。
- 令 privateEnv 为当前执行上下文的 PrivateEnvironment。
- 令 sourceText 为
ArrowFunction 匹配的源文本。 - 令 closure 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText,ArrowParameters ,ConciseBody ,lexical-this , env, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 返回 closure。
arguments、super、this 或 new.target 定义局部绑定；在其内部的此类引用必须解析为词法外层环境中的绑定。尽管 super，但步骤 super 的 super 所需状态通过捕获的 env 可用。
15.3.5 运行时语义：求值 (Runtime Semantics: Evaluation)
- 返回 InstantiateArrowFunctionExpression of
ArrowFunction 。
- 令 exprRef 为 ? Evaluation of
AssignmentExpression 。 - 令 exprValue 为 ?
GetValue (exprRef)。 - 返回
ReturnCompletion (exprValue)。
15.4 方法定义 (Method Definitions)
语法 (Syntax)
15.4.1 静态语义：早期错误 (Static Semantics: Early Errors)
-
若 FunctionBodyContainsUseStrict(
FunctionBody ) 为true 且 IsSimpleParameterList(UniqueFormalParameters ) 为false ，则为语法错误。 -
若
UniqueFormalParameters 的 BoundNames 中任一元素也出现在FunctionBody 的 LexicallyDeclaredNames 中，则为语法错误。
-
若
PropertySetParameterList 的 BoundNames 含重复元素，则为语法错误。 -
若 FunctionBodyContainsUseStrict(
FunctionBody ) 为true 且 IsSimpleParameterList(PropertySetParameterList ) 为false ，则为语法错误。 -
若
PropertySetParameterList 的 BoundNames 中任一元素也出现在FunctionBody 的 LexicallyDeclaredNames 中，则为语法错误。
15.4.2 静态语义：HasDirectSuper
The syntax-directed operation
- 若
UniqueFormalParameters ContainsSuperCall 为true ，返回true 。 - 返回
FunctionBody ContainsSuperCall 。
- 返回
FunctionBody ContainsSuperCall 。
- 若
PropertySetParameterList ContainsSuperCall 为true ，返回true 。 - 返回
FunctionBody ContainsSuperCall 。
- 若
UniqueFormalParameters ContainsSuperCall 为true ，返回true 。 - 返回
GeneratorBody ContainsSuperCall 。
- 若
UniqueFormalParameters ContainsSuperCall 为true ，返回true 。 - 返回
AsyncGeneratorBody ContainsSuperCall 。
- 若
UniqueFormalParameters ContainsSuperCall 为true ，返回true 。 - 返回
AsyncFunctionBody ContainsSuperCall 。
15.4.3 静态语义：SpecialMethod
The syntax-directed operation
- 返回
false 。
- 返回
true 。
15.4.4 运行时语义：DefineMethod : 正常完成（含 [[Key]] 与 [[Closure]] 字段的 Record）或突然完成
The syntax-directed operation UNKNOWN takes UNPARSEABLE ARGUMENTS. It is defined piecewise over the following productions:
- 令 propKey 为 ? Evaluation of
ClassElementName 。 - 令 env 为当前执行上下文的 LexicalEnvironment。
- 令 privateEnv 为当前执行上下文的 PrivateEnvironment。
- 若 functionPrototype 存在，令 prototype = functionPrototype；否则令 prototype =
%Function.prototype% 。 - 令 sourceText 为
MethodDefinition 匹配的源文本。 - 令 closure 为
OrdinaryFunctionCreate (prototype, sourceText,UniqueFormalParameters ,FunctionBody ,non-lexical-this , env, privateEnv)。 - 执行
MakeMethod (closure, object)。 - 返回
Record { [[Key]]: propKey, [[Closure]]: closure }。
15.4.5 运行时语义：MethodDefinitionEvaluation
The syntax-directed operation
- 令 methodDef 为 ? DefineMethod of
MethodDefinition ，参数 object。 - 执行
SetFunctionName (methodDef.[[Closure]], methodDef.[[Key]])。 - 返回 ?
DefineMethodProperty (object, methodDef.[[Key]], methodDef.[[Closure]], enumerable)。
- 令 propKey 为 ? Evaluation of
ClassElementName 。 - 令 env 为当前执行上下文的 LexicalEnvironment。
- 令 privateEnv 为当前执行上下文的 PrivateEnvironment。
- 令 sourceText 为
MethodDefinition 匹配的源文本。 - 令 formalParameterList 为产生式
FormalParameters : [empty] - 令 closure 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText, formalParameterList,FunctionBody ,non-lexical-this , env, privateEnv)。 - 执行
MakeMethod (closure, object)。 - 执行
SetFunctionName (closure, propKey,"get" )。 - 若 propKey 是
Private Name ，则- 返回
PrivateElement { [[Key]]: propKey, [[Kind]]:accessor , [[Get]]: closure, [[Set]]:undefined }。
- 返回
- 否则，
- 令 desc 为 PropertyDescriptor { [[Get]]: closure, [[Enumerable]]: enumerable, [[Configurable]]:
true }。 - 执行 ?
DefinePropertyOrThrow (object, propKey, desc)。 - 返回
unused 。
- 令 desc 为 PropertyDescriptor { [[Get]]: closure, [[Enumerable]]: enumerable, [[Configurable]]:
- 令 propKey 为 ? Evaluation of
ClassElementName 。 - 令 env 为当前执行上下文的 LexicalEnvironment。
- 令 privateEnv 为当前执行上下文的 PrivateEnvironment。
- 令 sourceText 为
MethodDefinition 匹配的源文本。 - 令 closure 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText,PropertySetParameterList ,FunctionBody ,non-lexical-this , env, privateEnv)。 - 执行
MakeMethod (closure, object)。 - 执行
SetFunctionName (closure, propKey,"set" )。 - 若 propKey 是
Private Name ，则- 返回
PrivateElement { [[Key]]: propKey, [[Kind]]:accessor , [[Get]]:undefined , [[Set]]: closure }。
- 返回
- 否则，
- 令 desc 为 PropertyDescriptor { [[Set]]: closure, [[Enumerable]]: enumerable, [[Configurable]]:
true }。 - 执行 ?
DefinePropertyOrThrow (object, propKey, desc)。 - 返回
unused 。
- 令 desc 为 PropertyDescriptor { [[Set]]: closure, [[Enumerable]]: enumerable, [[Configurable]]:
- 令 propKey 为 ? Evaluation of
ClassElementName 。 - 令 env 为当前执行上下文的 LexicalEnvironment。
- 令 privateEnv 为当前执行上下文的 PrivateEnvironment。
- 令 sourceText 为
GeneratorMethod 匹配的源文本。 - 令 closure 为
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,UniqueFormalParameters ,GeneratorBody ,non-lexical-this , env, privateEnv)。 - 执行
MakeMethod (closure, object)。 - 执行
SetFunctionName (closure, propKey)。 - 令 prototype 为
OrdinaryObjectCreate (%GeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 ?
DefineMethodProperty (object, propKey, closure, enumerable)。
- 令 propKey 为 ? Evaluation of
ClassElementName 。 - 令 env 为当前执行上下文的 LexicalEnvironment。
- 令 privateEnv 为当前执行上下文的 PrivateEnvironment。
- 令 sourceText 为
AsyncGeneratorMethod 匹配的源文本。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,UniqueFormalParameters ,AsyncGeneratorBody ,non-lexical-this , env, privateEnv)。 - 执行
MakeMethod (closure, object)。 - 执行
SetFunctionName (closure, propKey)。 - 令 prototype 为
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 ?
DefineMethodProperty (object, propKey, closure, enumerable)。
- 令 propKey 为 ? Evaluation of
ClassElementName 。 - 令 env 为当前执行上下文的 LexicalEnvironment。
- 令 privateEnv 为当前执行上下文的 PrivateEnvironment。
- 令 sourceText 为
AsyncMethod 匹配的源文本。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,UniqueFormalParameters ,AsyncFunctionBody ,non-lexical-this , env, privateEnv)。 - 执行
MakeMethod (closure, object)。 - 执行
SetFunctionName (closure, propKey)。 - 返回 ?
DefineMethodProperty (object, propKey, closure, enumerable)。
15.5 生成器函数定义 (Generator Function Definitions)
语法 (Syntax)
yield 后紧随的语法上下文需要使用
15.5.1 静态语义：早期错误 (Static Semantics: Early Errors)
-
若 HasDirectSuper(
GeneratorMethod ) 为true ，则为语法错误。 -
若
UniqueFormalParameters ContainsYieldExpression 为true ，则为语法错误。 -
若 FunctionBodyContainsUseStrict(
GeneratorBody ) 为true 且 IsSimpleParameterList(UniqueFormalParameters ) 为false ，则为语法错误。 -
若
UniqueFormalParameters 的 BoundNames 任一元素也出现在GeneratorBody 的 LexicallyDeclaredNames 中，则为语法错误。
-
若 IsStrict(
FormalParameters ) 为true ，则应用UniqueFormalParameters : FormalParameters 早期错误规则 。 -
若出现
BindingIdentifier 且 IsStrict(BindingIdentifier ) 为true ，其 StringValue 为"eval" 或"arguments" 则语法错误。 -
若 FunctionBodyContainsUseStrict(
GeneratorBody ) 为true 且 IsSimpleParameterList(FormalParameters ) 为false ，则为语法错误。 -
若
FormalParameters 的 BoundNames 任一元素也出现在GeneratorBody 的 LexicallyDeclaredNames 中，则为语法错误。 -
若
FormalParameters ContainsYieldExpression 为true ，则为语法错误。 -
若
FormalParameters ContainsSuperProperty 为true ，则为语法错误。 -
若
GeneratorBody ContainsSuperProperty 为true ，则为语法错误。 -
若
FormalParameters ContainsSuperCall 为true ，则为语法错误。 -
若
GeneratorBody ContainsSuperCall 为true ，则为语法错误。
15.5.2 运行时语义：EvaluateGeneratorBody
The syntax-directed operation
- 执行 ?
FunctionDeclarationInstantiation (functionObject, argumentsList)。 - 令 G 为 ?
OrdinaryCreateFromConstructor (functionObject,"%GeneratorPrototype%" , « [[GeneratorState]], [[GeneratorContext]], [[GeneratorBrand]] »)。 - 设 G.[[GeneratorBrand]] 为
empty 。 - 设 G.[[GeneratorState]] 为
suspended-start 。 - 执行
GeneratorStart (G,FunctionBody )。 - 返回
ReturnCompletion (G)。
15.5.3 运行时语义：InstantiateGeneratorFunctionObject
The syntax-directed operation
- 令 name 为
BindingIdentifier 的 StringValue。 - 令 sourceText 为
GeneratorDeclaration 匹配的源文本。 - 令 F 为
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,FormalParameters ,GeneratorBody ,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (F, name)。 - 令 prototype 为
OrdinaryObjectCreate (%GeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (F,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 F。
- 令 sourceText 为
GeneratorDeclaration 匹配的源文本。 - 令 F 为
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,FormalParameters ,GeneratorBody ,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (F,"default" )。 - 令 prototype 为
OrdinaryObjectCreate (%GeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (F,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 F。
匿名 export default 声明的一部分，因此其函数代码总是严格模式代码。
15.5.4 运行时语义：InstantiateGeneratorFunctionExpression : 一个 ECMAScript 函数对象
The syntax-directed operation UNKNOWN takes UNPARSEABLE ARGUMENTS. It is defined piecewise over the following productions:
- 若 name 不存在，设 name 为
"" 。 - 令 env 为当前执行上下文的 LexicalEnvironment。
- 令 privateEnv 为当前执行上下文的 PrivateEnvironment。
- 令 sourceText 为
GeneratorExpression 匹配的源文本。 - 令 closure 为
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,FormalParameters ,GeneratorBody ,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 令 prototype 为
OrdinaryObjectCreate (%GeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[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)。 - 令 prototype 为
OrdinaryObjectCreate (%GeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 执行 ! funcEnv.InitializeBinding(name, closure)。
- 返回 closure。
15.5.5 运行时语义：求值 (Runtime Semantics: Evaluation)
- 返回 InstantiateGeneratorFunctionExpression of
GeneratorExpression 。
- 返回 ?
Yield (undefined )。
- 令 exprRef 为 ? Evaluation of
AssignmentExpression 。 - 令 value 为 ?
GetValue (exprRef)。 - 返回 ?
Yield (value)。
- 令 generatorKind 为
GetGeneratorKind ()。 - 断言：generatorKind 为
sync 或async 。 - 令 exprRef 为 ? Evaluation of
AssignmentExpression 。 - 令 value 为 ?
GetValue (exprRef)。 - 令 iteratorRecord 为 ?
GetIterator (value, generatorKind)。 - 令 iterator 为 iteratorRecord.[[Iterator]]。
- 令 received 为
NormalCompletion (undefined )。 - 重复，
- 若 received 为 normal completion，则
- 令 innerResult 为 ? Call(iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]], « received.[[Value]] »)。
- 若 generatorKind 为
async ，设 innerResult 为 ?Await (innerResult)。 - 若 innerResult
不是 Object ，抛出TypeError 异常。 - 令 done 为 ?
IteratorComplete (innerResult)。 - 若 done 为
true ，则- 返回 ?
IteratorValue (innerResult)。
- 返回 ?
- 若 generatorKind 为
async ，设 received 为Completion (AsyncGeneratorYield (?IteratorValue (innerResult)))。 - 否则，设 received 为
Completion (GeneratorYield (innerResult))。
- 否则若 received 为 throw completion，则
- 令 throw 为 ?
GetMethod (iterator,"throw" )。 - 若 throw 非
undefined ，则- 令 innerResult 为 ? Call(throw, iterator, « received.[[Value]] »)。
- 若 generatorKind 为
async ，设 innerResult 为 ?Await (innerResult)。 - 注：内部迭代器
throw方法抛出的异常会被传播。其正常完成 与内部next类似处理。 - 若 innerResult
不是 Object ，抛出TypeError 异常。 - 令 done 为 ?
IteratorComplete (innerResult)。 - 若 done 为
true ，则- 返回 ?
IteratorValue (innerResult)。
- 返回 ?
- 若 generatorKind 为
async ，设 received 为Completion (AsyncGeneratorYield (?IteratorValue (innerResult)))。 - 否则设 received 为
Completion (GeneratorYield (innerResult))。
- 否则，
- 注：若 iterator 不具有
throw方法，则该抛出将终止yield*循环。但需先给予 iterator 清理机会。 - 令 closeCompletion 为
NormalCompletion (empty )。 - 若 generatorKind 为
async ，执行 ?AsyncIteratorClose (iteratorRecord, closeCompletion)。 - 否则，执行 ?
IteratorClose (iteratorRecord, closeCompletion)。 - 注：下一步抛出
TypeError 以指示yield*协议违规：iterator 无throw方法。 - 抛出
TypeError 异常。
- 注：若 iterator 不具有
- 令 throw 为 ?
- 否则，
- 断言：received 是 return completion。
- 令 return 为 ?
GetMethod (iterator,"return" )。 - 若 return 为
undefined ，则- 设 value 为 received.[[Value]]。
- 若 generatorKind 为
async ，则- 设 value 为 ?
Await (value)。
- 设 value 为 ?
- 返回
ReturnCompletion (value)。
- 令 innerReturnResult 为 ? Call(return, iterator, « received.[[Value]] »)。
- 若 generatorKind 为
async ，设 innerReturnResult 为 ?Await (innerReturnResult)。 - 若 innerReturnResult
不是 Object ，抛出TypeError 异常。 - 令 done 为 ?
IteratorComplete (innerReturnResult)。 - 若 done 为
true ，则- 设 value 为 ?
IteratorValue (innerReturnResult)。 - 返回
ReturnCompletion (value)。
- 设 value 为 ?
- 若 generatorKind 为
async ，设 received 为Completion (AsyncGeneratorYield (?IteratorValue (innerReturnResult)))。 - 否则设 received 为
Completion (GeneratorYield (innerReturnResult))。
- 若 received 为 normal completion，则
15.6 异步生成器函数定义 (Async Generator Function Definitions)
语法 (Syntax)
15.6.1 静态语义：早期错误 (Static Semantics: Early Errors)
- 若 HasDirectSuper(
AsyncGeneratorMethod ) 为true ，语法错误。 - 若
UniqueFormalParameters ContainsYieldExpression 为true ，语法错误。 - 若
UniqueFormalParameters ContainsAwaitExpression 为true ，语法错误。 - 若 FunctionBodyContainsUseStrict(
AsyncGeneratorBody ) 为true 且 IsSimpleParameterList(UniqueFormalParameters ) 为false ，语法错误。 - 若
UniqueFormalParameters 的 BoundNames 任一元素也出现在AsyncGeneratorBody 的 LexicallyDeclaredNames 中，语法错误。
- 若 IsStrict(
FormalParameters ) 为true ，应用UniqueFormalParameters : FormalParameters 早期错误规则 。 - 若出现
BindingIdentifier 且 IsStrict(BindingIdentifier ) 为true 且其 StringValue 为"eval" 或"arguments" ，语法错误。 - 若 FunctionBodyContainsUseStrict(
AsyncGeneratorBody ) 为true 且 IsSimpleParameterList(FormalParameters ) 为false ，语法错误。 - 若
FormalParameters 的 BoundNames 任一元素也出现在AsyncGeneratorBody 的 LexicallyDeclaredNames 中，语法错误。 - 若
FormalParameters ContainsYieldExpression 为true ，语法错误。 - 若
FormalParameters ContainsAwaitExpression 为true ，语法错误。 - 若
FormalParameters ContainsSuperProperty 为true ，语法错误。 - 若
AsyncGeneratorBody ContainsSuperProperty 为true ，语法错误。 - 若
FormalParameters ContainsSuperCall 为true ，语法错误。 - 若
AsyncGeneratorBody ContainsSuperCall 为true ，语法错误。
15.6.2 运行时语义：EvaluateAsyncGeneratorBody
The syntax-directed operation
- 执行 ?
FunctionDeclarationInstantiation (functionObject, argumentsList)。 - 令 generator 为 ?
OrdinaryCreateFromConstructor (functionObject,"%AsyncGeneratorPrototype%" , « [[AsyncGeneratorState]], [[AsyncGeneratorContext]], [[AsyncGeneratorQueue]], [[GeneratorBrand]] »)。 - 设 generator.[[GeneratorBrand]] 为
empty 。 - 设 generator.[[AsyncGeneratorState]] 为
suspended-start 。 - 执行
AsyncGeneratorStart (generator,FunctionBody )。 - 返回
ReturnCompletion (generator)。
15.6.3 运行时语义：InstantiateAsyncGeneratorFunctionObject
The syntax-directed operation
- 令 name 为
BindingIdentifier 的 StringValue。 - 令 sourceText 为
AsyncGeneratorDeclaration 匹配的源文本。 - 令 F 为
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,FormalParameters ,AsyncGeneratorBody ,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (F, name)。 - 令 prototype 为
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (F,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 F。
- 令 sourceText 为
AsyncGeneratorDeclaration 匹配的源文本。 - 令 F 为
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,FormalParameters ,AsyncGeneratorBody ,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (F,"default" )。 - 令 prototype 为
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (F,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 返回 F。
匿名 export default 声明中。
15.6.4 运行时语义：InstantiateAsyncGeneratorFunctionExpression : 一个 ECMAScript 函数对象
The syntax-directed operation UNKNOWN takes UNPARSEABLE ARGUMENTS. It is defined piecewise over the following productions:
- 若 name 不存在，设 name 为
"" 。 - 令 env 为当前执行上下文的 LexicalEnvironment。
- 令 privateEnv 为当前执行上下文的 PrivateEnvironment。
- 令 sourceText 为
AsyncGeneratorExpression 匹配的源文本。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,FormalParameters ,AsyncGeneratorBody ,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 令 prototype 为
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[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)。 - 令 prototype 为
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。 - 执行 ! funcEnv.InitializeBinding(name, closure)。
- 返回 closure。
15.6.5 运行时语义：求值 (Runtime Semantics: Evaluation)
- 返回 InstantiateAsyncGeneratorFunctionExpression of
AsyncGeneratorExpression 。
15.7 类定义 (Class Definitions)
语法 (Syntax)
类定义始终是严格模式代码。
15.7.1 静态语义：早期错误 (Static Semantics: Early Errors)
-
若未出现
ClassHeritage 且下述算法返回true ，则为语法错误：- 令 constructor 为
ClassBody 的 ConstructorMethod。 - 若 constructor 为
empty ，返回false 。 - 返回 HasDirectSuper(constructor)。
- 令 constructor 为
-
若
ClassElementList 的 PrototypePropertyNameList 中出现多于一次"constructor" ，则语法错误。 -
若
ClassElementList 的 PrivateBoundIdentifiers 含有重复条目（除非该名称仅用作一次 getter 与一次 setter 且不出现其他条目，且二者同为 static 或同为非 static），则语法错误。
-
若
MethodDefinition 的 PropName 不是"constructor" 且 HasDirectSuper(MethodDefinition ) 为true ，则语法错误。 -
若
MethodDefinition 的 PropName 为"constructor" 且 SpecialMethod(MethodDefinition ) 为true ，则语法错误。
-
若 HasDirectSuper(
MethodDefinition ) 为true ，则语法错误。 -
若
MethodDefinition 的 PropName 为"prototype" ，则语法错误。
FieldDefinition 的 PropName 若为"constructor" 则语法错误。
-
FieldDefinition 的 PropName 若为"prototype" 或"constructor" 则语法错误。
- 若存在
Initializer 且 ContainsArguments(Initializer ) 为true ，语法错误。 - 若存在
Initializer 且Initializer ContainsSuperCall 为true ，语法错误。
- 若
PrivateIdentifier 的 StringValue 为"#constructor" ，则语法错误。
-
若
ClassStaticBlockStatementList 的 LexicallyDeclaredNames 含有重复条目，语法错误。 - 若其 LexicallyDeclaredNames 任一元素也出现在 VarDeclaredNames 中，语法错误。
-
若 ContainsDuplicateLabels(
ClassStaticBlockStatementList , « ») 为true ，语法错误。 -
若 ContainsUndefinedBreakTarget(
ClassStaticBlockStatementList , « ») 为true ，语法错误。 -
若 ContainsUndefinedContinueTarget(
ClassStaticBlockStatementList , « », « ») 为true ，语法错误。 -
若 ContainsArguments(
ClassStaticBlockStatementList ) 为true ，语法错误。 -
若
ClassStaticBlockStatementList ContainsSuperCall 为true ，语法错误。 -
若
ClassStaticBlockStatementList Containsawait为true ，语法错误。
15.7.2 静态语义：ClassElementKind
The syntax-directed operation
- 若
MethodDefinition 的 PropName 为"constructor" ，返回constructor-method 。 - 返回
non-constructor-method 。
- 返回
non-constructor-method 。
- 返回
non-constructor-method 。
- 返回
empty 。
15.7.3 静态语义：ConstructorMethod
The syntax-directed operation
- 若
ClassElement 的 ClassElementKind 为constructor-method ，返回ClassElement 。 - 返回
empty 。
- 令 head 为
ClassElementList 的 ConstructorMethod。 - 若 head 非
empty ，返回 head。 - 若
ClassElement 的 ClassElementKind 为constructor-method ，返回ClassElement 。 - 返回
empty 。
15.7.4 静态语义：IsStatic
The syntax-directed operation
- 返回
false 。
- 返回
true 。
- 返回
false 。
- 返回
true 。
- 返回
true 。
- 返回
false 。
15.7.5 静态语义：NonConstructorElements
The syntax-directed operation
- 若
ClassElement 的 ClassElementKind 为non-constructor-method ，则- 返回 «
ClassElement »。
- 返回 «
- 返回新空列表。
- 令 list 为
ClassElementList 的 NonConstructorElements。 - 若
ClassElement 的 ClassElementKind 为non-constructor-method ，则- 将
ClassElement 追加至 list 末尾。
- 将
- 返回 list。
15.7.6 静态语义：PrototypePropertyNameList
The syntax-directed operation
- 令 propName 为
ClassElement 的 PropName。 - 若 propName 为
empty ，返回新空列表。 - 若 IsStatic(
ClassElement ) 为true ，返回新空列表。 - 返回 « propName »。
- 令 list 为
ClassElementList 的 PrototypePropertyNameList。 - 令 propName 为
ClassElement 的 PropName。 - 若 propName 为
empty ，返回 list。 - 若 IsStatic(
ClassElement ) 为true ，返回 list。 - 返回 列表连接(list, « propName »)。
15.7.7 静态语义：AllPrivateIdentifiersValid
The syntax-directed operation
本规范中未列出的所有产生式替代都隐式具有如下默认定义：
- 对该
解析节点 的每个子节点 child：- 若 child 是非终结符实例，则
- 若 AllPrivateIdentifiersValid(child, names) 为
false ，返回false 。
- 若 AllPrivateIdentifiersValid(child, names) 为
- 若 child 是非终结符实例，则
- 返回
true 。
- 若 names 包含
PrivateIdentifier 的 StringValue，则- 返回 AllPrivateIdentifiersValid(
MemberExpression , names)。
- 返回 AllPrivateIdentifiersValid(
- 返回
false 。
- 若 names 包含
PrivateIdentifier 的 StringValue，则- 返回 AllPrivateIdentifiersValid(
CallExpression , names)。
- 返回 AllPrivateIdentifiersValid(
- 返回
false 。
- 若 names 包含
PrivateIdentifier 的 StringValue，返回true 。 - 返回
false 。
- 若 names 包含
PrivateIdentifier 的 StringValue，则- 返回 AllPrivateIdentifiersValid(
OptionalChain , names)。
- 返回 AllPrivateIdentifiersValid(
- 返回
false 。
- 令 newNames 为 names 与
ClassBody 的 PrivateBoundIdentifiers 的列表连接。 - 返回 AllPrivateIdentifiersValid(
ClassElementList , newNames)。
- 若 names 包含
PrivateIdentifier 的 StringValue，则- 返回 AllPrivateIdentifiersValid(
ShiftExpression , names)。
- 返回 AllPrivateIdentifiersValid(
- 返回
false 。
15.7.8 静态语义：PrivateBoundIdentifiers
The syntax-directed operation
- 返回
ClassElementName 的 PrivateBoundIdentifiers。
- 返回仅包含
PrivateIdentifier 的 StringValue 的列表。
- 返回新空列表。
- 令 names1 为
ClassElementList 的 PrivateBoundIdentifiers。 - 令 names2 为
ClassElement 的 PrivateBoundIdentifiers。 - 返回 列表连接(names1, names2)。
- 返回
ClassElementName 的 PrivateBoundIdentifiers。
15.7.9 静态语义：ContainsArguments
The syntax-directed operation
本规范中未列出的产生式替代默认使用以下定义：
- 对该节点的每个子节点 child：
- 若 child 是非终结符实例：
- 若 ContainsArguments(child) 为
true ，返回true 。
- 若 ContainsArguments(child) 为
- 若 child 是非终结符实例：
- 返回
false 。
- 若
Identifier 的 StringValue 为"arguments" ，返回true 。 - 返回
false 。
- 返回
false 。
- 返回 ContainsArguments(
ClassElementName )。
15.7.10 运行时语义：ClassFieldDefinitionEvaluation
The syntax-directed operation
- 令 name 为 ? Evaluation of
ClassElementName 。 - 若存在
Initializer ，则- 令 formalParameterList 为产生式
FormalParameters : [empty] - 令 env 为当前执行上下文的 LexicalEnvironment。
- 令 privateEnv 为当前执行上下文的 PrivateEnvironment。
- 令 sourceText 为空的 Unicode 码点序列。
- 令 initializer 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText, formalParameterList,Initializer ,non-lexical-this , env, privateEnv)。 - 执行
MakeMethod (initializer, homeObject)。 - 设 initializer.[[ClassFieldInitializerName]] 为 name。
- 令 formalParameterList 为产生式
- 否则，
- 令 initializer 为
empty 。
- 令 initializer 为
- 返回
ClassFieldDefinition Record { [[Name]]: name, [[Initializer]]: initializer }。
15.7.11 运行时语义：ClassStaticBlockDefinitionEvaluation
The syntax-directed operation
- 令 lex 为当前执行上下文的 LexicalEnvironment。
- 令 privateEnv 为当前执行上下文的 PrivateEnvironment。
- 令 sourceText 为空的 Unicode 码点序列。
- 令 formalParameters 为产生式
FormalParameters : [empty] - 令 bodyFunction 为
OrdinaryFunctionCreate (%Function.prototype% , sourceText, formalParameters,ClassStaticBlockBody ,non-lexical-this , lex, privateEnv)。 - 执行
MakeMethod (bodyFunction, homeObject)。 - 返回
ClassStaticBlockDefinition Record { [[BodyFunction]]: bodyFunction }。
15.7.12 运行时语义：EvaluateClassStaticBlockBody
The syntax-directed operation
- 断言：functionObject 是由 ClassStaticBlockDefinitionEvaluation 步骤
5 创建的合成函数。 - 执行 !
FunctionDeclarationInstantiation (functionObject, « »)。 - 执行 ? Evaluation of
ClassStaticBlockStatementList 。 - 返回
ReturnCompletion (undefined )。
15.7.13 运行时语义：ClassElementEvaluation
The syntax-directed operation
- 返回 ? ClassFieldDefinitionEvaluation(
FieldDefinition , object)。
- 返回 ? MethodDefinitionEvaluation(
MethodDefinition , object,false )。
- 返回 ClassStaticBlockDefinitionEvaluation(
ClassStaticBlock , object)。
- 返回
unused 。
15.7.14 运行时语义：ClassDefinitionEvaluation
The syntax-directed operation
为便于规范说明，私有方法与访问器与私有字段一起被包含在类实例的 [[PrivateElements]] 槽中。然而，任意给定对象要么拥有该类定义的全部私有方法与访问器，要么一个也没有。该特性被设计为允许实现选择不对每个方法或访问器单独跟踪的策略来实现私有方法与访问器。
例如，实现可以将实例私有方法直接与其对应的 this 值运行。随后在对象上查找一个实例私有方法的过程即是检查定义该方法的类
这不同于私有字段：由于字段初始化器在类实例化期间可能抛出，单个对象可能只拥有某个类私有字段的真子集，因此一般必须单独跟踪私有字段。
It is defined piecewise over the following productions:
- 令 env 为正在运行的执行上下文的 LexicalEnvironment。
- 令 classEnv 为
NewDeclarativeEnvironment (env)。 - 若 classBinding 不为
undefined ，则- 执行 ! classEnv.CreateImmutableBinding(classBinding,
true )。
- 执行 ! classEnv.CreateImmutableBinding(classBinding,
- 令 outerPrivateEnvironment 为正在运行的执行上下文的 PrivateEnvironment。
- 令 classPrivateEnvironment 为
NewPrivateEnvironment (outerPrivateEnvironment)。 - 若存在
ClassBody ，则- 对
ClassBody 的 PrivateBoundIdentifiers 中每个字符串 dn：- 若 classPrivateEnvironment.[[Names]] 包含
Private Name pn 且 pn.[[Description]] 为 dn，则- 断言：仅 getter/setter 成对时可能。
- 否则，
- 令 name 为新的
Private Name ，[[Description]] 为 dn。 - 将 name 追加至 classPrivateEnvironment.[[Names]]。
- 令 name 为新的
- 若 classPrivateEnvironment.[[Names]] 包含
- 对
- 若不存在
ClassHeritage ，则- 令 protoParent 为
%Object.prototype% 。 - 令 constructorParent 为
%Function.prototype% 。
- 令 protoParent 为
- 否则，
- 将正在运行执行上下文的 LexicalEnvironment 设为 classEnv。
- 注：计算
ClassHeritage 时运行执行上下文的 PrivateEnvironment 为 outerPrivateEnvironment。 - 令 superclassRef 为
Completion (Evaluation ofClassHeritage )。 - 将运行执行上下文的 LexicalEnvironment 设回 env。
- 令 superclass 为 ?
GetValue (? superclassRef)。 - 若 superclass 为
null ，则- 令 protoParent 为
null 。 - 令 constructorParent 为
%Function.prototype% 。
- 令 protoParent 为
- 否则若
IsConstructor (superclass) 为false ，则- 抛出
TypeError 异常。
- 抛出
- 否则，
- 令 proto 为
OrdinaryObjectCreate (protoParent)。 - 若不存在
ClassBody ，令 constructor 为empty 。 - 否则，令 constructor 为
ClassBody 的 ConstructorMethod。 - 将运行执行上下文的 LexicalEnvironment 设为 classEnv。
- 将运行执行上下文的 PrivateEnvironment 设为 classPrivateEnvironment。
- 若 constructor 为
empty ，则- 令 defaultConstructor 为一个不带参数且不捕获任何内容的新抽象闭包，被调用时执行：
- 令 args 为通过 [[Call]] 或 [[Construct]] 传给此函数的参数列表。
- 若 NewTarget 为
undefined ，抛出TypeError 异常。 - 令 F 为活动
函数对象 。 - 若 F.[[ConstructorKind]] 为
derived ，则- 注：此分支行为类似
constructor(...args) { super(...args); }。最显著区别是上述 ECMAScript 源码会可观察地调用%Array.prototype%上的%Symbol.iterator% 方法，而此函数不会。 - 令 func 为 ! F.[[GetPrototypeOf]]()。
- 若
IsConstructor (func) 为false ，抛出TypeError 异常。 - 令 result 为 ? Construct(func, args, NewTarget)。
- 注：此分支行为类似
- 否则，
- 注：此分支类似
constructor() {}。 - 令 result 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%Object.prototype%" )。
- 注：此分支类似
- 执行 ?
InitializeInstanceElements (result, F)。 - 返回
NormalCompletion (result)。
- 令 F 为
CreateBuiltinFunction (defaultConstructor, 0, className, « [[ConstructorKind]], [[SourceText]] »,当前 Realm Record , constructorParent)。
- 令 defaultConstructor 为一个不带参数且不捕获任何内容的新抽象闭包，被调用时执行：
- 否则，
- 令 constructorInfo 为 ! DefineMethod of constructor，参数 proto 与 constructorParent。
- 令 F 为 constructorInfo.[[Closure]]。
- 执行
MakeClassConstructor (F)。 - 执行
SetFunctionName (F, className)。
- 设 F.[[SourceText]] 为 sourceText。
- 执行
MakeConstructor (F,false , proto)。 - 若存在
ClassHeritage ，设 F.[[ConstructorKind]] 为derived 。 - 执行 !
DefineMethodProperty (proto,"constructor" , F,false )。 - 若不存在
ClassBody ，令 elements 为新空List 。 - 否则，令 elements 为
ClassBody 的 NonConstructorElements。 - 令 instancePrivateMethods、staticPrivateMethods、instanceFields、staticElements 各为新空
List 。 - 对 elements 中每个
ClassElement e：- 若 IsStatic of e 为
false ，则- 令 element 为
Completion (ClassElementEvaluation of e，参数 proto)。
- 令 element 为
- 否则，
- 令 element 为
Completion (ClassElementEvaluation of e，参数 F)。
- 令 element 为
- 若 element 是突然完成，
- 将运行执行上下文的 LexicalEnvironment 设为 env。
- 将运行执行上下文的 PrivateEnvironment 设为 outerPrivateEnvironment。
- 返回 ? element。
- 设 element 为 ! element。
- 若 element 是
PrivateElement ，则- 断言：element.[[Kind]] 为
method 或accessor 。 - 若 IsStatic of e 为
false ，令 container 为 instancePrivateMethods；否则令其为 staticPrivateMethods。 - 若 container 中存在
PrivateElement pe 且 pe.[[Key]] 为 element.[[Key]]，则- 断言：element.[[Kind]] 与 pe.[[Kind]] 均为
accessor 。 - 若 element.[[Get]] 为
undefined ，则- 令 combined 为
PrivateElement { [[Key]]: element.[[Key]], [[Kind]]:accessor , [[Get]]: pe.[[Get]], [[Set]]: element.[[Set]] }。
- 令 combined 为
- 否则，
- 令 combined 为
PrivateElement { [[Key]]: element.[[Key]], [[Kind]]:accessor , [[Get]]: element.[[Get]], [[Set]]: pe.[[Set]] }。
- 令 combined 为
- 用 combined 替换 container 中的 pe。
- 断言：element.[[Kind]] 与 pe.[[Kind]] 均为
- 否则，
- 追加 element 至 container。
- 断言：element.[[Kind]] 为
- 否则若 element 是
ClassFieldDefinition Record ，则- 若 IsStatic of e 为
false ，将 element 追加至 instanceFields；否则追加至 staticElements。
- 若 IsStatic of e 为
- 否则若 element 是
ClassStaticBlockDefinition Record ，则- 追加 element 至 staticElements。
- 若 IsStatic of e 为
- 将运行执行上下文的 LexicalEnvironment 设回 env。
- 若 classBinding 不为
undefined ，则- 执行 ! classEnv.InitializeBinding(classBinding, F)。
- 设 F.[[PrivateMethods]] 为 instancePrivateMethods。
- 设 F.[[Fields]] 为 instanceFields。
- 对 staticPrivateMethods 中每个
PrivateElement method：- 执行 !
PrivateMethodOrAccessorAdd (F, method)。
- 执行 !
- 对 staticElements 中每个元素 elementRecord：
- 若 elementRecord 是
ClassFieldDefinition Record ，则- 令 result 为
Completion (DefineField (F, elementRecord))。
- 令 result 为
- 否则，
- 断言：elementRecord 是
ClassStaticBlockDefinition Record 。 - 令 result 为
Completion (Call(elementRecord.[[BodyFunction]], F))。
- 断言：elementRecord 是
- 若 result 为突然完成，
- 将运行执行上下文的 PrivateEnvironment 设为 outerPrivateEnvironment。
- 返回 ? result。
- 若 elementRecord 是
- 将运行执行上下文的 PrivateEnvironment 设为 outerPrivateEnvironment。
- 返回 F。
15.7.15 运行时语义：BindingClassDeclarationEvaluation
The syntax-directed operation
- 令 className 为
BindingIdentifier 的 StringValue。 - 令 sourceText 为
ClassDeclaration 匹配的源文本。 - 令 value 为 ? ClassDefinitionEvaluation of
ClassTail ，参数 className、className 与 sourceText。 - 令 env 为正在运行的执行上下文的 LexicalEnvironment。
- 执行 ?
InitializeBoundName (className, value, env)。 - 返回 value。
- 令 sourceText 为
ClassDeclaration 匹配的源文本。 - 返回 ? ClassDefinitionEvaluation of
ClassTail ，参数undefined 、"default" 与 sourceText。
15.7.16 运行时语义：求值 (Runtime Semantics: Evaluation)
- 执行 ? BindingClassDeclarationEvaluation of 此
ClassDeclaration 。 - 返回
empty 。
- 令 sourceText 为
ClassExpression 匹配的源文本。 - 返回 ? ClassDefinitionEvaluation of
ClassTail ，参数undefined 、"" 与 sourceText。
- 令 className 为
BindingIdentifier 的 StringValue。 - 令 sourceText 为
ClassExpression 匹配的源文本。 - 返回 ? ClassDefinitionEvaluation of
ClassTail ，参数 className、className 与 sourceText。
- 令 privateIdentifier 为
PrivateIdentifier 的 StringValue。 - 令 privateEnvRec 为运行执行上下文的 PrivateEnvironment。
- 令 names 为 privateEnvRec.[[Names]]。
- 断言：names 中恰有一个
Private Name 的 [[Description]] 为 privateIdentifier。 - 令 privateName 为 names 中 [[Description]] 为 privateIdentifier 的
Private Name 。 - 返回 privateName。
- 返回
undefined 。
15.8 异步函数定义 (Async Function Definitions)
语法 (Syntax)
当 [Await] 参数存在时，await 被解析为
- 在
AsyncFunctionBody 中。 - 在
AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 或AsyncGeneratorExpression 的FormalParameters 中。该位置的AwaitExpression 通过静态语义 为语法错误。 - 在一个
Module 中。
当 await 可以被解析为标识符。包括以下情形：
- 在
AsyncFunctionBody 或上述各类FormalParameters 之外的任意位置。 - 在
FunctionExpression 、GeneratorExpression 或AsyncGeneratorExpression 的BindingIdentifier 中。
不同于
15.8.1 静态语义：早期错误 (Static Semantics: Early Errors)
- 若 FunctionBodyContainsUseStrict(
AsyncFunctionBody ) 为true 且 IsSimpleParameterList(UniqueFormalParameters ) 为false ，语法错误。 - 若 HasDirectSuper(
AsyncMethod ) 为true ，语法错误。 - 若
UniqueFormalParameters ContainsAwaitExpression 为true ，语法错误。 - 若
UniqueFormalParameters 的 BoundNames 任一元素也出现在AsyncFunctionBody 的 LexicallyDeclaredNames 中，语法错误。
- 若 FunctionBodyContainsUseStrict(
AsyncFunctionBody ) 为true 且 IsSimpleParameterList(FormalParameters ) 为false ，语法错误。 - 若
FormalParameters ContainsAwaitExpression 为true ，语法错误。 - 若 IsStrict(
FormalParameters ) 为true ，应用UniqueFormalParameters : FormalParameters 早期错误规则 。 - 若存在
BindingIdentifier 且 IsStrict(BindingIdentifier ) 为true 且其 StringValue 为"eval" 或"arguments" ，语法错误。 - 若
FormalParameters 的 BoundNames 任一元素也出现在AsyncFunctionBody 的 LexicallyDeclaredNames 中，语法错误。 - 若
FormalParameters ContainsSuperProperty 为true ，语法错误。 - 若
AsyncFunctionBody ContainsSuperProperty 为true ，语法错误。 - 若
FormalParameters ContainsSuperCall 为true ，语法错误。 - 若
AsyncFunctionBody ContainsSuperCall 为true ，语法错误。
15.8.2 运行时语义：InstantiateAsyncFunctionObject
The syntax-directed operation
- 令 name 为
BindingIdentifier 的 StringValue。 - 令 sourceText 为
AsyncFunctionDeclaration 匹配的源文本。 - 令 F 为
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,FormalParameters ,AsyncFunctionBody ,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (F, name)。 - 返回 F。
- 令 sourceText 为
AsyncFunctionDeclaration 匹配的源文本。 - 令 F 为
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,FormalParameters ,AsyncFunctionBody ,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (F,"default" )。 - 返回 F。
15.8.3 运行时语义：InstantiateAsyncFunctionExpression : 一个 ECMAScript 函数对象
The syntax-directed operation UNKNOWN takes UNPARSEABLE ARGUMENTS. It is defined piecewise over the following productions:
- 若 name 不存在，设 name 为
"" 。 - 令 env 为运行执行上下文的 LexicalEnvironment。
- 令 privateEnv 为运行执行上下文的 PrivateEnvironment。
- 令 sourceText 为
AsyncFunctionExpression 匹配的源文本。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,FormalParameters ,AsyncFunctionBody ,non-lexical-this , env, 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 运行时语义：EvaluateAsyncFunctionBody
The syntax-directed operation
- 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 completion 为
Completion (FunctionDeclarationInstantiation (functionObject, argumentsList))。 - 若 completion 是突然完成，则
- 执行 ! Call(promiseCapability.[[Reject]],
undefined , « completion.[[Value]] »)。
- 执行 ! Call(promiseCapability.[[Reject]],
- 否则，
- 执行
AsyncFunctionStart (promiseCapability,FunctionBody )。
- 执行
- 返回
ReturnCompletion (promiseCapability.[[Promise]])。
15.8.5 运行时语义：求值 (Runtime Semantics: Evaluation)
- 返回 InstantiateAsyncFunctionExpression of
AsyncFunctionExpression 。
- 令 exprRef 为 ? Evaluation of
UnaryExpression 。 - 令 value 为 ?
GetValue (exprRef)。 - 返回 ?
Await (value)。
15.9 异步箭头函数定义 (Async Arrow Function Definitions)
语法 (Syntax)
补充语法 (Supplemental Syntax)
处理产生式实例：
时，对
15.9.1 静态语义：早期错误 (Static Semantics: Early Errors)
- 若
AsyncArrowBindingIdentifier 的 BoundNames 任一元素也出现在AsyncConciseBody 的 LexicallyDeclaredNames 中，则为语法错误。
CoverCallExpressionAndAsyncArrowHead 必须覆盖 一个AsyncArrowHead 。- 若
CoverCallExpressionAndAsyncArrowHead ContainsYieldExpression 为true ，则为语法错误。 - 若
CoverCallExpressionAndAsyncArrowHead ContainsAwaitExpression 为true ，则为语法错误。 - 若
CoverCallExpressionAndAsyncArrowHead 的 BoundNames 任一元素也出现在AsyncConciseBody 的 LexicallyDeclaredNames 中，则为语法错误。 - 若 AsyncConciseBodyContainsUseStrict(
AsyncConciseBody ) 为true 且 IsSimpleParameterList(CoverCallExpressionAndAsyncArrowHead ) 为false ，则为语法错误。
15.9.2 静态语义：AsyncConciseBodyContainsUseStrict
The syntax-directed operation
- 返回
false 。
- 返回 FunctionBodyContainsUseStrict(
AsyncFunctionBody )。
15.9.3 运行时语义：EvaluateAsyncConciseBody
The syntax-directed operation
- 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 completion 为
Completion (FunctionDeclarationInstantiation (functionObject, argumentsList))。 - 若 completion 为突然完成，则
- 执行 ! Call(promiseCapability.[[Reject]],
undefined , « completion.[[Value]] »)。
- 执行 ! Call(promiseCapability.[[Reject]],
- 否则，
- 执行
AsyncFunctionStart (promiseCapability,ExpressionBody )。
- 执行
- 返回
ReturnCompletion (promiseCapability.[[Promise]])。
15.9.4 运行时语义：InstantiateAsyncArrowFunctionExpression : 一个 ECMAScript 函数对象
The syntax-directed operation UNKNOWN takes UNPARSEABLE ARGUMENTS. It is defined piecewise over the following productions:
- 若 name 不存在，设 name 为
"" 。 - 令 env 为当前执行上下文的 LexicalEnvironment。
- 令 privateEnv 为当前执行上下文的 PrivateEnvironment。
- 令 sourceText 为
AsyncArrowFunction 匹配的源文本。 - 令 parameters 为
AsyncArrowBindingIdentifier 。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText, parameters,AsyncConciseBody ,lexical-this , env, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 返回 closure。
- 若 name 不存在，设 name 为
"" 。 - 令 env 为当前执行上下文的 LexicalEnvironment。
- 令 privateEnv 为当前执行上下文的 PrivateEnvironment。
- 令 sourceText 为
AsyncArrowFunction 匹配的源文本。 - 令 head 为
CoverCallExpressionAndAsyncArrowHead 覆盖 的AsyncArrowHead 。 - 令 parameters 为 head 的
ArrowFormalParameters 。 - 令 closure 为
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText, parameters,AsyncConciseBody ,lexical-this , env, privateEnv)。 - 执行
SetFunctionName (closure, name)。 - 返回 closure。
15.9.5 运行时语义：求值 (Runtime Semantics: Evaluation)
- 返回 InstantiateAsyncArrowFunctionExpression of
AsyncArrowFunction 。
15.10 尾位置调用 (Tail Position Calls)
15.10.1 静态语义：IsInTailPosition ( call )
The abstract operation
- 若 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 。 - 返回 HasCallInTailPosition(body, call) 的结果。
尾位置调用仅在严格模式代码中定义，这是因为存在常见的非标准语言扩展（参见
15.10.2 静态语义：HasCallInTailPosition
The syntax-directed operation
紧随其后的 return
It is defined piecewise over the following productions:
- 令 has 为 HasCallInTailPosition(
StatementList , call)。 - 若 has 为
true ，返回true 。 - 返回 HasCallInTailPosition(
StatementListItem , call)。
- 返回
false 。
- 返回 HasCallInTailPosition(
Statement , call)。
- 返回 HasCallInTailPosition(
LabelledItem , call)。
- 返回 HasCallInTailPosition(
Expression , call)。
- 返回 HasCallInTailPosition(
CaseBlock , call)。
- 令 has 为
false 。 - 若首个
CaseClauses 存在，设 has 为 HasCallInTailPosition(首个CaseClauses , call)。 - 若 has 为
true ，返回true 。 - 设 has 为 HasCallInTailPosition(
DefaultClause , call)。 - 若 has 为
true ，返回true 。 - 若第二个
CaseClauses 存在，设 has 为 HasCallInTailPosition(第二个CaseClauses , call)。 - 返回 has。
- 令 has 为 HasCallInTailPosition(
CaseClauses , call)。 - 若 has 为
true ，返回true 。 - 返回 HasCallInTailPosition(
CaseClause , call)。
- 若
StatementList 存在，返回 HasCallInTailPosition(StatementList , call)。 - 返回
false 。
- 返回 HasCallInTailPosition(
Catch , call)。
- 返回 HasCallInTailPosition(
Finally , call)。
- 返回 HasCallInTailPosition(
Block , call)。
- 返回
false 。
- 返回 HasCallInTailPosition(
AssignmentExpression , call)。
- 令 has 为第一个
AssignmentExpression 的 HasCallInTailPosition(call)。 - 若 has 为
true ，返回true 。 - 返回第二个
AssignmentExpression 的 HasCallInTailPosition(call)。
- 返回 HasCallInTailPosition(
BitwiseORExpression , call)。
- 返回 HasCallInTailPosition(
LogicalANDExpression , call)。
- 返回 HasCallInTailPosition(
BitwiseORExpression , call)。
- 若此
CallExpression 即 call，返回true 。 - 返回
false 。
- 返回 HasCallInTailPosition(
OptionalChain , call)。
- 返回
false 。
- 若此
OptionalChain 即 call，返回true 。 - 返回
false 。
- 若此
MemberExpression 即 call，返回true 。 - 返回
false 。
- 令 expr 为
CoverParenthesizedExpressionAndArrowParameterList 覆盖 的ParenthesizedExpression 。 - 返回 HasCallInTailPosition(expr, call)。
- 返回 HasCallInTailPosition(
Expression , call)。
15.10.3 PrepareForTailCall ( )
The abstract operation PrepareForTailCall takes no arguments and returns
- 断言：当前执行上下文在后续不会再用于求值任意 ECMAScript 代码或内建函数。调用本
抽象操作 之后的 Call 调用将在进行任何此类求值前创建并压入一个新的执行上下文。 - 丢弃与当前执行上下文关联的所有资源。
- 返回
unused 。
尾位置调用必须在调用目标函数前释放与当前正在执行的函数执行上下文关联的任何瞬态内部资源，或复用这些资源以支持目标函数。
例如，尾位置调用应当只按“目标函数激活记录大小减去调用方激活记录大小”的差额增长实现的激活记录栈；若目标函数的激活记录更小，则栈总大小应减小。
16 ECMAScript 语言：脚本与模块
16.1 脚本 (Scripts)
语法 (Syntax)
16.1.1 静态语义：早期错误 (Static Semantics: Early Errors)
-
若
ScriptBody 的 LexicallyDeclaredNames 含有任意重复条目，则为语法错误。 -
若
ScriptBody 的 LexicallyDeclaredNames 中任一元素也出现在ScriptBody 的 VarDeclaredNames 中，则为语法错误。
-
若
StatementList Containssuper为true （除非包含super的源文本为正通过直接 eval 处理的 eval 代码），则为语法错误。直接 eval 中super的额外早期错误规则 定义在19.2.1.1 。 -
若
StatementList ContainsNewTarget 为true （除非包含NewTarget 的源文本为正通过直接 eval 处理的 eval 代码），则为语法错误。直接 eval 中NewTarget 的额外早期错误规则 定义在19.2.1.1 。 -
若 ContainsDuplicateLabels(
StatementList , « ») 为true ，则为语法错误。 -
若 ContainsUndefinedBreakTarget(
StatementList , « ») 为true ，则为语法错误。 -
若 ContainsUndefinedContinueTarget(
StatementList , « », « ») 为true ，则为语法错误。 -
若 AllPrivateIdentifiersValid(
StatementList , « ») 为false （除非包含ScriptBody 的源文本为正通过直接 eval 处理的 eval 代码），则为语法错误。
16.1.2 静态语义：ScriptIsStrict
The syntax-directed operation
- 若
ScriptBody 存在且ScriptBody 的指令序言包含 Use Strict 指令，返回true ；否则返回false 。
16.1.3 运行时语义：求值 (Runtime Semantics: Evaluation)
- 返回
undefined 。
16.1.4 脚本记录 (Script Records)
脚本记录封装了正被求值的脚本的信息。每个
| 字段名 | 值类型 | 含义 |
|---|---|---|
| [[Realm]] |
一个 |
此脚本被创建时所在的领域。 |
| [[ECMAScriptCode]] |
一个 |
解析此脚本源文本的结果。 |
| [[LoadedModules]] |
|
从此脚本导入的说明符字符串到已解析的 |
| [[HostDefined]] |
任意类型（默认值为 |
为需要将额外信息与脚本关联的 |
16.1.5 ParseScript ( sourceText, realm, hostDefined )
The abstract operation ParseScript takes arguments sourceText (ECMAScript 源文本), realm (一个
实现可以在对该脚本源文本求值 ParseScript 之前解析脚本源文本并分析早期错误条件。然而，任何错误的报告必须推迟到本规范实际对该源文本执行 ParseScript 的时候。
16.1.6 ScriptEvaluation ( scriptRecord )
The abstract operation ScriptEvaluation takes argument scriptRecord (一个 Script
- 令 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 现在成为正在运行的执行上下文。
- 令 script 为 scriptRecord.[[ECMAScriptCode]]。
- 令 result 为
Completion (GlobalDeclarationInstantiation (script, globalEnv))。 - 若 result 为
正常完成 ，则- 设 result 为
Completion (Evaluation of script)。 - 若 result 为
正常完成 且 result.[[Value]] 为empty ，则- 设 result 为
NormalCompletion (undefined )。
- 设 result 为
- 设 result 为
- 暂停 scriptContext 并从执行上下文栈中移除它。
- 断言：执行上下文栈非空。
- 恢复现在位于执行上下文栈顶的上下文作为正在运行的执行上下文。
- 返回 ? result。
16.1.7 GlobalDeclarationInstantiation ( script, env )
The abstract operation GlobalDeclarationInstantiation takes arguments script (一个
当为求值脚本建立执行上下文时，声明在当前全局环境中实例化。代码中声明的每个全局绑定都被实例化。
被调用时执行以下步骤：
- 令 lexNames 为 script 的 LexicallyDeclaredNames。
- 令 varNames 为 script 的 VarDeclaredNames。
- 对 lexNames 的每个元素 name：
- 若
HasLexicalDeclaration (env, name) 为true ，抛出SyntaxError 异常。 - 令 hasRestrictedGlobal 为 ?
HasRestrictedGlobalProperty (env, name)。 - 注：全局
var和function绑定（除了由非严格直接 eval 引入的那些）是不可配置的，因此是受限的全局属性。 - 若 hasRestrictedGlobal 为
true ，抛出SyntaxError 异常。
- 若
- 对 varNames 的每个元素 name：
- 若
HasLexicalDeclaration (env, name) 为true ，抛出SyntaxError 异常。
- 若
- 令 varDeclarations 为 script 的 VarScopedDeclarations。
- 令 functionsToInitialize 为新的空列表。
- 令 declaredFunctionNames 为新的空列表。
- 对 varDeclarations 的每个元素 d，以反向列表顺序：
- 若 d 既不是
VariableDeclaration 、ForBinding 也不是BindingIdentifier ，则- 断言：d 是
FunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 或AsyncGeneratorDeclaration 。 - 注：若同一名称有多个函数声明，使用最后的声明。
- 令 fn 为 d 的 BoundNames 的唯一元素。
- 若 declaredFunctionNames 不包含 fn，则
- 令 fnDefinable 为 ?
CanDeclareGlobalFunction (env, fn)。 - 若 fnDefinable 为
false ，抛出TypeError 异常。 - 将 fn 追加到 declaredFunctionNames。
- 将 d 插入为 functionsToInitialize 的第一个元素。
- 令 fnDefinable 为 ?
- 断言：d 是
- 若 d 既不是
- 令 declaredVarNames 为新的空列表。
- 对 varDeclarations 的每个元素 d：
- 若 d 是
VariableDeclaration 、ForBinding 或BindingIdentifier ，则- 对 d 的 BoundNames 中每个字符串 vn：
- 若 declaredFunctionNames 不包含 vn，则
- 令 vnDefinable 为 ?
CanDeclareGlobalVar (env, vn)。 - 若 vnDefinable 为
false ，抛出TypeError 异常。 - 若 declaredVarNames 不包含 vn，则
- 将 vn 追加到 declaredVarNames。
- 令 vnDefinable 为 ?
- 若 declaredFunctionNames 不包含 vn，则
- 对 d 的 BoundNames 中每个字符串 vn：
- 若 d 是
- 注：若全局对象是
普通对象 ，此算法步骤之后不会发生异常终止。然而，若全局对象是 Proxy 异域对象，它可能表现出在某些后续步骤中导致异常终止的行为。 - Normative Optional若
宿主 是 Web 浏览器或以其他方式支持块级函数声明 Web 历史兼容语义 ，则- 令 strict 为 ScriptIsStrict(script)。
- 若 strict 为
false ，则- 令 declaredFunctionOrVarNames 为 declaredFunctionNames 和 declaredVarNames 的列表连接。
- 对直接包含在任意
Block 、CaseClause 或DefaultClause x 的StatementList 中的每个FunctionDeclaration f（使得 script Contains x 为true ）：- 令 F 为 f 的
BindingIdentifier 的 StringValue。 - 若将
FunctionDeclaration f 替换为以 F 作为BindingIdentifier 的VariableStatement 不会为 script 产生任何早期错误，则- 若
HasLexicalDeclaration (env, F) 为false ，则- 令 fnDefinable 为 ?
CanDeclareGlobalVar (env, F)。 - 若 fnDefinable 为
true ，则- 注：F 的 var 绑定仅在它既不是 VarDeclaredName 也不是另一个
FunctionDeclaration 的名称时才在此实例化。 - 若 declaredFunctionOrVarNames 不包含 F，则
- 执行 ?
CreateGlobalVarBinding (env, F,false )。 - 将 F 追加到 declaredFunctionOrVarNames。
- 执行 ?
- 当
FunctionDeclaration f 被求值时，执行以下步骤而不是15.2.6 中提供的FunctionDeclaration 求值算法：- 令 gEnv 为正在运行的执行上下文的 VariableEnvironment。
- 令 bEnv 为正在运行的执行上下文的 LexicalEnvironment。
- 令 fObj 为 ! bEnv.GetBindingValue(F,
false )。 - 执行 ? gEnv.SetMutableBinding(F, fObj,
false )。 - 返回
unused 。
- 注：F 的 var 绑定仅在它既不是 VarDeclaredName 也不是另一个
- 令 fnDefinable 为 ?
- 若
- 令 F 为 f 的
- 令 lexDeclarations 为 script 的 LexicallyScopedDeclarations。
- 令 privateEnv 为
null 。 - 对 lexDeclarations 的每个元素 d：
- 注：词法声明的名称仅在此实例化但不初始化。
- 对 d 的 BoundNames 的每个元素 dn：
- 若 IsConstantDeclaration(d) 为
true ，则- 执行 ? env.CreateImmutableBinding(dn,
true )。
- 执行 ? env.CreateImmutableBinding(dn,
- 否则，
- 执行 ? env.CreateMutableBinding(dn,
false )。
- 执行 ? env.CreateMutableBinding(dn,
- 若 IsConstantDeclaration(d) 为
- 对 functionsToInitialize 的每个
解析节点 f：- 令 fn 为 f 的 BoundNames 的唯一元素。
- 令 fo 为 InstantiateFunctionObject(f, env, privateEnv)。
- 执行 ?
CreateGlobalFunctionBinding (env, fn, fo,false )。
- 对 declaredVarNames 的每个字符串 vn：
- 执行 ?
CreateGlobalVarBinding (env, vn,false )。
- 执行 ?
- 返回
unused 。
与显式的 var 或 function 声明不同，直接在全局对象上创建的属性会产生可能被 let/const/class 声明遮蔽的全局绑定。
16.2 模块 (Modules)
语法 (Syntax)
16.2.1 模块语义 (Module Semantics)
16.2.1.1 静态语义：早期错误 (Static Semantics: Early Errors)
-
若
ModuleItemList 的 LexicallyDeclaredNames 包含任何重复条目，则为语法错误。 -
若
ModuleItemList 的 LexicallyDeclaredNames 中的任何元素也出现在ModuleItemList 的 VarDeclaredNames 中，则为语法错误。 -
若
ModuleItemList 的 ExportedNames 包含任何重复条目，则为语法错误。 -
若
ModuleItemList 的 ExportedBindings 中的任何元素也不出现在ModuleItemList 的 VarDeclaredNames 或 LexicallyDeclaredNames 中，则为语法错误。 -
若
ModuleItemList Containssuper，则为语法错误。 -
若
ModuleItemList ContainsNewTarget ，则为语法错误。 -
若 ContainsDuplicateLabels(
ModuleItemList , « ») 为true ，则为语法错误。 -
若 ContainsUndefinedBreakTarget(
ModuleItemList , « ») 为true ，则为语法错误。 -
若 ContainsUndefinedContinueTarget(
ModuleItemList , « », « ») 为true ，则为语法错误。 -
若 AllPrivateIdentifiersValid(
ModuleItemList , « ») 为false ，则为语法错误。
重复 ExportedNames 规则意味着在 export default
- 若 IsStringWellFormedUnicode(SV of
StringLiteral ) 为false ，则为语法错误。
16.2.1.2 静态语义：ImportedLocalNames ( importEntries )
The abstract operation
- 令 localNames 为新的空列表。
- 对于 importEntries 的每个 ImportEntry
Record i：- 将 i.[[LocalName]] 追加到 localNames。
- 返回 localNames。
16.2.1.3 ModuleRequest 记录 (ModuleRequest Records)
ModuleRequest Record 表示使用给定导入属性导入模块的请求。它由以下字段组成：
| 字段名 | 值类型 | 含义 |
|---|---|---|
| [[Specifier]] | 字符串 | 模块说明符 |
| [[Attributes]] |
|
导入属性 |
LoadedModuleRequest Record 表示导入模块的请求以及生成的
| 字段名 | 值类型 | 含义 |
|---|---|---|
| [[Specifier]] | 字符串 | 模块说明符 |
| [[Attributes]] |
|
导入属性 |
| [[Module]] |
|
对应此模块请求的已加载模块 |
ImportAttribute Record 由以下字段组成：
| 字段名 | 值类型 | 含义 |
|---|---|---|
| [[Key]] | 字符串 |
|
| [[Value]] | 字符串 | 属性值 |
16.2.1.3.1 ModuleRequestsEqual ( left, right )
The abstract operation ModuleRequestsEqual takes arguments left (
- 若 left.[[Specifier]] 不是 right.[[Specifier]]，返回
false 。 - 令 leftAttrs 为 left.[[Attributes]]。
- 令 rightAttrs 为 right.[[Attributes]]。
- 令 leftAttrsCount 为 leftAttrs 中元素的数量。
- 令 rightAttrsCount 为 rightAttrs 中元素的数量。
- 若 leftAttrsCount ≠ rightAttrsCount，返回
false 。 - 对于 leftAttrs 的每个
ImportAttribute Record l：- 若 rightAttrs 不包含满足 l.[[Key]] 是 r.[[Key]] 且 l.[[Value]] 是 r.[[Value]] 的
ImportAttribute Record r，返回false 。
- 若 rightAttrs 不包含满足 l.[[Key]] 是 r.[[Key]] 且 l.[[Value]] 是 r.[[Value]] 的
- 返回
true 。
16.2.1.4 静态语义：ModuleRequests
The syntax-directed operation
- 返回新的空列表。
- 返回
ModuleItem 的 ModuleRequests。
- 令 requests 为
ModuleItemList 的 ModuleRequests。 - 令 additionalRequests 为
ModuleItem 的 ModuleRequests。 - 对于 additionalRequests 的每个
ModuleRequest Record mr：- 若 requests 不包含满足
ModuleRequestsEqual (mr, mr2) 为true 的ModuleRequest Record mr2，则- 将 mr 追加到 requests。
- 若 requests 不包含满足
- 返回 requests。
- 返回新的空列表。
- 令 specifier 为
FromClause 的 SV。 - 返回唯一元素为
ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: « » } 的列表。
- 令 specifier 为
FromClause 的 SV。 - 令 attributes 为 WithClauseToAttributes of
WithClause 。 - 返回唯一元素为
ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: attributes } 的列表。
- 令 specifier 为
ModuleSpecifier 的 SV。 - 返回唯一元素为
ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: « » } 的列表。
- 令 specifier 为
ModuleSpecifier 的 SV。 - 令 attributes 为 WithClauseToAttributes of
WithClause 。 - 返回唯一元素为
ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: attributes } 的列表。
- 令 specifier 为
FromClause 的 SV。 - 返回唯一元素为
ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: « » } 的列表。
- 令 specifier 为
FromClause 的 SV。 - 令 attributes 为 WithClauseToAttributes of
WithClause 。 - 返回唯一元素为
ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: attributes } 的列表。
- 返回新的空列表。
16.2.1.5 抽象模块记录 (Abstract Module Records)
Module Record 封装了关于单个模块导入和导出的结构信息。这些信息用于链接连接模块集合的导入和导出。Module Record 包含四个仅在求值模块时使用的字段。
出于规范目的，Module Record 值是
Module Record 定义了
| 字段名 | 值类型 | 含义 |
|---|---|---|
| [[Realm]] |
|
创建此模块的领域。 |
| [[Environment]] |
|
包含此模块顶级绑定的 |
| [[Namespace]] |
Object 或 |
Module Namespace Object（ |
| [[HostDefined]] |
任意类型（默认值为 |
为需要将附加信息与模块关联的 |
| 方法 | 目的 |
|---|---|
| LoadRequestedModules([hostDefined]) |
通过递归加载所有依赖项来准备模块以进行链接，并返回一个 promise。 |
| GetExportedNames([exportStarSet]) |
返回从此模块直接或间接导出的所有名称的列表。 在调用此方法之前，LoadRequestedModules 必须已成功完成。 |
| ResolveExport(exportName [, resolveSet]) |
返回此模块导出的名称的绑定。绑定由 ResolvedBinding Record 表示，形式为 { [[Module]]: 每次使用特定 exportName、resolveSet 对作为参数调用此操作时，必须返回相同结果。 在调用此方法之前，LoadRequestedModules 必须已成功完成。 |
| Link() |
通过传递性地解析所有模块依赖项并创建 在调用此方法之前，LoadRequestedModules 必须已成功完成。 |
| Evaluate() |
返回此模块及其依赖项求值的 promise，在成功求值或已成功求值时解决，在求值错误或已求值失败时拒绝。如果 promise 被拒绝，期望 在调用此方法之前，Link 必须已成功完成。 |
16.2.1.5.1 EvaluateModuleSync ( module )
The abstract operation EvaluateModuleSync takes argument module (
- 断言：module 不是 Cyclic
Module Record 。 - 令 promise 为 module.Evaluate()。
- 断言：promise.[[PromiseState]] 为
fulfilled 或rejected 。 - 若 promise.[[PromiseState]] 为
rejected ，则- 若 promise.[[PromiseIsHandled]] 为
false ，执行HostPromiseRejectionTracker (promise,"handle" )。 - 设 promise.[[PromiseIsHandled]] 为
true 。 - 返回
ThrowCompletion (promise.[[PromiseResult]])。
- 若 promise.[[PromiseIsHandled]] 为
- 返回
unused 。
16.2.1.6 循环模块记录 (Cyclic Module Records)
Cyclic Module Record（循环模块记录） 用于表示一个模块与其它同属 Cyclic
除
| 字段名 (Field Name) | 值类型 (Value Type) | 含义 (Meaning) |
|---|---|---|
| [[Status]] |
|
初始为 |
| [[EvaluationError]] |
throw completion 或 |
表示求值期间发生的异常的 throw completion。若无异常或 [[Status]] 不是 |
| [[DFSAncestorIndex]] |
整数或 |
仅在 Link 与 Evaluate 过程中使用的辅助字段。若 [[Status]] 为 |
| [[RequestedModules]] |
|
与该模块中的 import 相关联的 |
| [[LoadedModules]] |
|
将此记录所代表模块使用的说明符字符串（及相对导入属性）映射到解析得到的 |
| [[CycleRoot]] |
Cyclic |
环的首个访问模块，即强连通分量（SCC）的深度优先根祖先。对不在环中的模块，该字段为其自身。Evaluate 完成后，模块的 [[DFSAncestorIndex]] 等于其 [[CycleRoot]] 的深度优先遍历索引。 |
| [[HasTLA]] | Boolean |
该模块自身是否为异步（例如包含顶层 await 的 Source Text |
| [[AsyncEvaluationOrder]] |
|
初始为 |
| [[TopLevelCapability]] |
|
若此模块是某个环的 [[CycleRoot]] 且对该环中某模块调用了 Evaluate()，此字段保存该整体求值的 PromiseCapability，用于完成 Evaluate() 返回的 Promise。除非对依赖发起顶层 Evaluate()，否则依赖的该字段为 |
| [[AsyncParentModules]] |
Cyclic |
若此模块或其依赖具有 [[HasTLA]] |
| [[PendingAsyncDependencies]] |
整数或 |
若该模块有异步依赖，此值跟踪剩余尚未执行完成的异步依赖模块数量。计数降至 0 且无执行错误时，该模块执行。 |
除
| 方法 (Method) | 目的 (Purpose) |
|---|---|
| InitializeEnvironment() |
初始化模块的 |
| ExecuteModule([promiseCapability]) |
在其执行上下文内求值模块代码。若模块 [[HasTLA]] 为 |
GraphLoadingState Record（图加载状态记录） 是包含模块图加载流程信息的记录，用于在
| 字段名 (Field Name) | 值类型 (Value Type) | 含义 (Meaning) |
|---|---|---|
| [[PromiseCapability]] |
|
加载流程完成时要 resolve 的 promise。 |
| [[IsLoading]] | Boolean |
若加载流程尚未成功或失败完成则为 |
| [[PendingModulesCount]] | 非负整数 |
跟踪未完成 |
| [[Visited]] |
Cyclic |
已在本次加载过程中加载的循环模块集合，用于避免循环依赖无限循环。 |
| [[HostDefined]] |
任意（默认 |
自 |
16.2.1.6.1 模块记录抽象方法的具体实现 (Implementation of Module Record Abstract Methods)
以下为循环模块记录对
16.2.1.6.1.1 LoadRequestedModules ( [ hostDefined ] )
The LoadRequestedModules concrete method of Cyclic
- 若 hostDefined 未传入，令 hostDefined 为
empty 。 - 令 pc 为 !
NewPromiseCapability (%Promise% )。 - 令 state 为 GraphLoadingState
Record { [[IsLoading]]:true , [[PendingModulesCount]]: 1, [[Visited]]: « », [[PromiseCapability]]: pc, [[HostDefined]]: hostDefined }。 - 执行
InnerModuleLoading (state, module)。 - 返回 pc.[[Promise]]。
<link rel="preload" as="..."> 设置正确的 fetch destination。import() 表达式不会设置该参数。
16.2.1.6.1.1.1 InnerModuleLoading ( state, module )
The abstract operation InnerModuleLoading takes arguments state (GraphLoadingState
- 断言：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 ，设其为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 (GraphLoadingState
- 若 state.[[IsLoading]] 为
false ，返回unused 。 - 若 moduleCompletion 为
正常完成 ，则- 执行
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 Link concrete method of Cyclic
- 断言：module.[[Status]] 属于
unlinked ,linked ,evaluating-async ,evaluated 之一。 - 令 stack 为新空列表。
- 令 result 为
Completion (InnerModuleLinking (module, stack, 0))。 - 若 result 为突然完成，则
- 对 stack 中每个 Cyclic
Module Record m：- 断言：m.[[Status]] 为
linking 。 - 设 m.[[Status]] =
unlinked 。
- 断言：m.[[Status]] 为
- 断言：module.[[Status]] 为
unlinked 。 - 返回 ? result。
- 对 stack 中每个 Cyclic
- 断言：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 (
- 若 module 不是 Cyclic
Module Record ，则- 执行 ? module.Link()。
- 返回 index。
- 若 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 ，则- 断言：其 [[Status]] 属于
linking ,linked ,evaluating-async ,evaluated 。 - 断言：requiredModule.[[Status]] 为
linking 当且仅当 stack 含有它。 - 若为
linking ，则- 设 module.[[DFSAncestorIndex]] =
min (module.[[DFSAncestorIndex]], requiredModule.[[DFSAncestorIndex]])。
- 设 module.[[DFSAncestorIndex]] =
- 断言：其 [[Status]] 属于
- 令 requiredModule =
- 执行 ? module.InitializeEnvironment()。
- 断言：module 在 stack 中仅出现一次。
- 断言：module.[[DFSAncestorIndex]] ≤ moduleIndex。
- 若 module.[[DFSAncestorIndex]] = moduleIndex，则
- 令 done =
false 。 - 当 done 为
false 循环：- 令 requiredModule 为 stack 最末元素。
- 移除该末元素。
- 断言：requiredModule 为 Cyclic
Module Record 。 - 设 requiredModule.[[Status]] =
linked 。 - 若 requiredModule 与 module 相同，设 done =
true 。
- 令 done =
- 返回 index。
16.2.1.6.1.3 Evaluate ( )
The Evaluate concrete method of Cyclic
- 断言：本次 Evaluate 调用未与同代理内另一 Evaluate 并发。
- 断言：module.[[Status]] 属于
linked ,evaluating-async ,evaluated 。 - 若 [[Status]] 为
evaluating-async 或evaluated ，令 module = module.[[CycleRoot]]。 - 若 module.[[TopLevelCapability]] 非
empty ，返回其 [[Promise]]。 - 令 stack 为新空列表。
- 令 capability = !
NewPromiseCapability (%Promise% )。 - 设 module.[[TopLevelCapability]] = capability。
- 令 result =
Completion (InnerModuleEvaluation (module, stack, 0))。 - 若 result 为突然完成，则
- 对 stack 中每个 Cyclic
Module Record m：- 断言：m.[[Status]] 为
evaluating 。 - 断言：m.[[AsyncEvaluationOrder]] 为
unset 。 - 设 m.[[Status]] =
evaluated 。 - 设 m.[[EvaluationError]] = result。
- 断言：m.[[Status]] 为
- 断言：module.[[Status]] 为
evaluated 。 - 断言：module.[[EvaluationError]] 与 result 为同一
Completion Record 。 - 执行 ! Call(capability.[[Reject]],
undefined , « result.[[Value]] »)。
- 对 stack 中每个 Cyclic
- 否则，
- 断言：module.[[Status]] 为
evaluating-async 或evaluated 。 - 断言：module.[[EvaluationError]] 为
empty 。 - 若 module.[[Status]] 为
evaluated ，则- 注：表示同步完成求值。
- 断言：module.[[AsyncEvaluationOrder]] 为
unset 。 - 执行 ! Call(capability.[[Resolve]],
undefined , «undefined »)。
- 断言：stack 为空。
- 断言：module.[[Status]] 为
- 返回 capability.[[Promise]]。
16.2.1.6.1.3.1 InnerModuleEvaluation ( module, stack, index )
The abstract operation InnerModuleEvaluation takes arguments module (
- 若 module 非 Cyclic
Module Record ，则- 执行 ?
EvaluateModuleSync (module)。 - 返回 index。
- 执行 ?
- 若 module.[[Status]] 为
evaluating-async 或evaluated ，则- 若 [[EvaluationError]] 为
empty ，返回 index。 - 否则返回 ? module.[[EvaluationError]]。
- 若 [[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 ，则- 断言：其 [[Status]] 属于
evaluating ,evaluating-async ,evaluated 。 - 断言：当且仅当 stack 含其时状态为
evaluating 。 - 若为
evaluating ，设 module.[[DFSAncestorIndex]] =min (两者索引)。 - 否则，
- 设 requiredModule = requiredModule.[[CycleRoot]]。
- 断言：其 [[Status]] 为
evaluating-async 或evaluated 。 - 若其 [[EvaluationError]] 非
empty ，返回 ? 该错误。
- 若 requiredModule.[[AsyncEvaluationOrder]] 为整数，则
- 设 module.[[PendingAsyncDependencies]] += 1。
- 将 module 追加至 requiredModule.[[AsyncParentModules]]。
- 断言：其 [[Status]] 属于
- 令 requiredModule =
- 若 module.[[PendingAsyncDependencies]] > 0 或 [[HasTLA]] 为
true ，则- 断言：module.[[AsyncEvaluationOrder]] 为
unset 。 - 设 module.[[AsyncEvaluationOrder]] =
IncrementModuleAsyncEvaluationCount ()。 - 若 module.[[PendingAsyncDependencies]] = 0，执行
ExecuteAsyncModule (module)。
- 断言：module.[[AsyncEvaluationOrder]] 为
- 否则，
- 执行 ? module.ExecuteModule()。
- 断言：module 在 stack 中仅出现一次。
- 断言：module.[[DFSAncestorIndex]] ≤ moduleIndex。
- 若 module.[[DFSAncestorIndex]] = moduleIndex，则
- 令 done =
false 。 - 当 done 为
false ：- 令 requiredModule 为 stack 最末元素并移除。
- 断言：其为 Cyclic
Module Record 。 - 断言：其 [[AsyncEvaluationOrder]] 为整数或
unset 。 - 若为
unset ，设其 [[Status]] =evaluated ；否则设为evaluating-async 。 - 若与 module 相同，设 done =
true 。 - 设 requiredModule.[[CycleRoot]] = module。
- 令 done =
- 返回 index。
模块在 InnerModuleEvaluation 遍历时为
依赖某异步环的模块在该环不处于
16.2.1.6.1.3.2 ExecuteAsyncModule ( module )
The abstract operation ExecuteAsyncModule takes argument module (Cyclic
- 断言：module.[[Status]] 为
evaluating 或evaluating-async 。 - 断言：module.[[HasTLA]] 为
true 。 - 令 capability = !
NewPromiseCapability (%Promise% )。 - 令 fulfilledClosure 为捕获 module 的无参抽象闭包，调用时：
- 执行
AsyncModuleExecutionFulfilled (module)。 - 返回
NormalCompletion (undefined )。
- 执行
- 令 onFulfilled =
CreateBuiltinFunction (fulfilledClosure, 0,"" , « »)。 - 令 rejectedClosure 为捕获 module 的抽象闭包（参数 error）：
- 执行
AsyncModuleExecutionRejected (module, error)。 - 返回
NormalCompletion (undefined )。
- 执行
- 令 onRejected =
CreateBuiltinFunction (rejectedClosure, 0,"" , « »)。 - 执行
PerformPromiseThen (capability.[[Promise]], onFulfilled, onRejected)。 - 执行 ! module.ExecuteModule(capability)。
- 返回
unused 。
16.2.1.6.1.3.3 GatherAvailableAncestors ( module, execList )
The abstract operation GatherAvailableAncestors takes arguments module (Cyclic
- 对 module.[[AsyncParentModules]] 中每个 Cyclic
Module Record m：- 若 execList 不含 m 且 m.[[CycleRoot]].[[EvaluationError]] 为
empty ，则- 断言：m.[[Status]] 为
evaluating-async 。 - 断言：m.[[EvaluationError]] 为
empty 。 - 断言：m.[[AsyncEvaluationOrder]] 为整数。
- 断言：m.[[PendingAsyncDependencies]] > 0。
- 设 m.[[PendingAsyncDependencies]] = m.[[PendingAsyncDependencies]] - 1。
- 若其为 0，则
- 将 m 追加至 execList。
- 若 m.[[HasTLA]] 为
false ，执行GatherAvailableAncestors (m, execList)。
- 断言：m.[[Status]] 为
- 若 execList 不含 m 且 m.[[CycleRoot]].[[EvaluationError]] 为
- 返回
unused 。
当根 module 的异步执行 fulfilled 时，此函数确定可同步继续执行的模块集合，填入 execList。
16.2.1.6.1.3.4 AsyncModuleExecutionFulfilled ( module )
The abstract operation AsyncModuleExecutionFulfilled takes argument module (Cyclic
- 若 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 为同一记录。
- 执行 ! Call(module.[[TopLevelCapability]].[[Resolve]],
undefined , «undefined »)。
- 令 execList 为新空列表。
- 执行
GatherAvailableAncestors (module, execList)。 - 断言：execList 各元素之 [[AsyncEvaluationOrder]] 为整数、[[PendingAsyncDependencies]] 为 0、[[EvaluationError]] 为
empty 。 - 令 sortedExecList 为按 [[AsyncEvaluationOrder]] 升序排序的 execList 拷贝。
- 对 sortedExecList 每个 Cyclic
Module Record m：- 若 m.[[Status]] 为
evaluated ，断言其 [[EvaluationError]] 非empty 。 - 否则若 m.[[HasTLA]] 为
true ，执行ExecuteAsyncModule (m)。 - 否则，
- 令 result = m.ExecuteModule()。
- 若 result 为突然完成，执行
AsyncModuleExecutionRejected (m, result.[[Value]])。 - 否则，
- 设 m.[[AsyncEvaluationOrder]] =
done 。 - 设 m.[[Status]] =
evaluated 。 - 若 m.[[TopLevelCapability]] 非
empty ：- 断言：m.[[CycleRoot]] 与 m 相同。
- 执行 ! Call(m.[[TopLevelCapability]].[[Resolve]],
undefined , «undefined »)。
- 设 m.[[AsyncEvaluationOrder]] =
- 若 m.[[Status]] 为
- 返回
unused 。
16.2.1.6.1.3.5 AsyncModuleExecutionRejected ( module, error )
The abstract operation AsyncModuleExecutionRejected takes arguments module (Cyclic
- 若 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 。 - 注：出于与
AsyncModuleExecutionFulfilled 对称，在出现错误时也设为done ；当 [[EvaluationError]] 非empty 时，其 [[AsyncEvaluationOrder]] 不再使用。 - 对 module.[[AsyncParentModules]] 中每个 Cyclic
Module Record m：- 执行
AsyncModuleExecutionRejected (m, error)。
- 执行
- 若 module.[[TopLevelCapability]] 非
empty ，则- 断言：module.[[CycleRoot]] 与 module 相同。
- 执行 ! Call(module.[[TopLevelCapability]].[[Reject]],
undefined , « error »)。
- 返回
unused 。
16.2.1.6.2 循环模块记录图示例 (Example Cyclic Module Record Graphs)
本非规范性章节展示若干常见模块图的链接与求值示例，重点说明错误如何出现。
先看一个简单模块图：
假设无错误：
若在成功的 A.LoadRequestedModules() 之后出现链接错误：例如
若在成功 Link() 后出现求值错误：例如 C 求值成功但 B 中代码抛出异常，则 A.Evaluate() 返回被拒绝的 Promise；异常记录在 A 与 B 的 [[EvaluationError]]，二者变为
接着看一个无法解析模块的情形：
此时 A 依赖的模块不存在（
加载、链接与求值错误的差异：
现在看一个包含环的模块图：
以 A 为入口，LoadRequestedModules 触发对 B 与 C 的加载；因循环再次访问 A 时不再重复。成功后所有模块状态同时从
随后 Link 通过 DFS 对环进行
若 A 存在链接错误（如从 C 导入不存在的绑定），第二次回到 A 时提前返回，但最终在 InitializeEnvironment（调用 C.ResolveExport 后）抛出
若 A 存在求值错误（源码抛异常），则求值阶段对应逻辑使 A 与仍
最后看一个所有模块异步完成的循环图：
加载与链接后全部为
调用 A.Evaluate()：A、B、D 设为
|
字段 / 模块
|
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 完成：D 设为
| 字段
|
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 设为
| 字段
|
A |
|---|---|
| [[DFSAncestorIndex]] | 0 |
| [[Status]] | |
| [[AsyncEvaluationOrder]] | |
| [[AsyncParentModules]] | « » |
| [[PendingAsyncDependencies]] | 0 |
若失败：假设 C 先执行出错，在
| 字段
|
A | C |
|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | ||
| [[AsyncParentModules]] | « » | « A » |
| [[PendingAsyncDependencies]] | 1 (B) | 0 |
| [[EvaluationError]] | C 的求值错误 |
A 也被拒绝并记录相同错误；见
| 字段
|
A |
|---|---|
| [[DFSAncestorIndex]] | 0 |
| [[Status]] | |
| [[AsyncEvaluationOrder]] | |
| [[AsyncParentModules]] | « » |
| [[PendingAsyncDependencies]] | 0 |
| [[EvaluationError]] | C 的 Evaluation Error |
若随后 B
| 字段
|
A | B |
|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | 4 | 1 |
| [[AsyncParentModules]] | « » | « A » |
| [[PendingAsyncDependencies]] | 0 | 0 |
| [[EvaluationError]] | C 的 Evaluation Error |
16.2.1.7 源码文本模块记录 (Source Text Module Records)
Source Text Module Record（源码文本模块记录） 表示由 ECMAScript 源文本（
该记录可与其它
除
| 字段名 | 值类型 | 含义 |
|---|---|---|
| [[ECMAScriptCode]] | Parse Node |
以 |
| [[Context]] |
|
与模块关联的执行上下文；在环境初始化前为 |
| [[ImportMeta]] |
Object 或 |
通过 import.meta 暴露的对象；首次访问前为 |
| [[ImportEntries]] |
ImportEntry |
源码导入语句解析出的 ImportEntry 列表。 |
| [[LocalExportEntries]] |
ExportEntry |
对应模块内部声明的导出。 |
| [[IndirectExportEntries]] |
ExportEntry |
对应重导出的导入或 export * as namespace 的导出。
|
| [[StarExportEntries]] |
ExportEntry |
对应 export *（不含 export * as namespace）的导出。
|
ImportEntry Record（导入项记录） 汇总单个声明式导入的信息，其字段见
| 字段名 | 值类型 | 含义 |
|---|---|---|
| [[ModuleRequest]] |
|
表示 |
| [[ImportName]] |
String 或 |
目标模块中导出的绑定名称。 |
| [[LocalName]] | String | 在本模块中访问该导入值的局部名字。 |
| 导入语句形式 | [[ModuleRequest]] | [[ImportName]] | [[LocalName]] |
|---|---|---|---|
import v from "mod";
|
|
|
|
import * as ns from "mod";
|
|
|
|
import {x} from "mod";
|
|
|
|
import {x as v} from "mod";
|
|
|
|
import "mod";
|
不创建 ImportEntry |
||
ExportEntry Record（导出项记录） 汇总单个声明式导出信息，字段见
| 字段名 | 值类型 | 含义 |
|---|---|---|
| [[ExportName]] |
String 或 |
对外导出的名称。 |
| [[ModuleRequest]] |
|
表示 |
| [[ImportName]] |
String、 |
从 [[ModuleRequest]] 指定模块导出的绑定名；export * as ns 用 export * 用 |
| [[LocalName]] |
String 或 |
在本模块内部访问该导出值的名字；若非本地可访问则为 |
| 导出语句形式 | [[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";
|
|
|
|
|
以下定义 Source Text
16.2.1.7.1 ParseModule ( sourceText, realm, hostDefined )
The abstract operation ParseModule takes arguments sourceText (ECMAScript 源文本), realm (
- 令 body = ParseText(sourceText,
Module )。 - 若 body 为错误列表，返回之。
- 令 requestedModules = ModuleRequests(body)。
- 令 importEntries = ImportEntries(body)。
- 令 importedBoundNames = ImportedLocalNames(importEntries)。
- 令 indirectExportEntries、localExportEntries、starExportEntries 各为新空列表。
- 令 exportEntries = ExportEntries(body)。
- 对 exportEntries 每个 ExportEntry
Record ee：- 若 ee.[[ModuleRequest]] 为
null ，则- 若 importedBoundNames 不含 ee.[[LocalName]]，追加 ee 至 localExportEntries。
- 否则，
- 令 ie 为 importEntries 中 [[LocalName]] 等于该名的元素。
- 若 ie.[[ImportName]] 为
namespace-object ，- 注：重导出模块命名空间对象。
- 追加 ee 至 localExportEntries。
- 否则：
- 注：重导出单一名称。
- 追加 ExportEntry { [[ModuleRequest]]: ie.[[ModuleRequest]], [[ImportName]]: ie.[[ImportName]], [[LocalName]]:
null , [[ExportName]]: ee.[[ExportName]] } 至 indirectExportEntries。
- 否则若 ee.[[ImportName]] 为
all-but-default ：- 断言：ee.[[ExportName]] 为
null 。 - 追加 ee 至 starExportEntries。
- 断言：ee.[[ExportName]] 为
- 否则追加 ee 至 indirectExportEntries。
- 若 ee.[[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 模块记录抽象方法实现 (Implementation of Module Record Abstract Methods)
以下为 Source Text
16.2.1.7.2.1 GetExportedNames ( [ exportStarSet ] )
The GetExportedNames concrete method of Source Text
- 断言：module.[[Status]] 非
new 。 - 若 exportStarSet 未传入，设为新空列表。
- 若 exportStarSet 含 module：
- 断言：达到
export *循环起点。 - 返回新空列表。
- 断言：达到
- 追加 module 至 exportStarSet。
- 令 exportedNames 为新空列表。
- 对 module.[[LocalExportEntries]] 每个 e：
- 断言：存在直接绑定。
- 断言：e.[[ExportName]] 非
null 。 - 追加该名称。
- 对 module.[[IndirectExportEntries]] 每个 e：
- 断言：导入特定绑定。
- 追加 e.[[ExportName]]。
- 对 module.[[StarExportEntries]] 每个 e：
- 断言：e.[[ModuleRequest]] 非
null 。 - 令 requestedModule =
GetImportedModule (module, e.[[ModuleRequest]])。 - 令 starNames = requestedModule.GetExportedNames(exportStarSet)。
- 对 starNames 每个 n：
- 若 n 非
"default" 且 exportedNames 不含 n，则追加。
- 若 n 非
- 断言：e.[[ModuleRequest]] 非
- 返回 exportedNames。
GetExportedNames 不过滤或抛出模糊的星号再导出绑定。
16.2.1.7.2.2 ResolveExport ( exportName [ , resolveSet ] )
The ResolveExport concrete method of Source Text
尝试解析导出名称到定义的模块与局部绑定名。若是命名空间导出且无本地绑定，则 [[BindingName]] 为
It performs the following steps when called:
- 断言：module.[[Status]] 非
new 。 - 若 resolveSet 未传入，设为新空列表。
- 若 resolveSet 中存在记录与 (module, exportName) 相同：
- 断言：循环导出请求。
- 返回
null 。
- 追加 { [[Module]]: module, [[ExportName]]: exportName } 至 resolveSet。
- 遍历 [[LocalExportEntries]]：
- 若匹配 exportName，返回 { [[Module]]: module, [[BindingName]]: e.[[LocalName]] }。
- 遍历 [[IndirectExportEntries]]：
- 若匹配：
- 断言有 [[ModuleRequest]]。
- 令 importedModule =
GetImportedModule (module, e.[[ModuleRequest]])。 - 若 e.[[ImportName]] 为
all ：- 返回 { [[Module]]: importedModule, [[BindingName]]:
namespace }。
- 返回 { [[Module]]: importedModule, [[BindingName]]:
- 否则返回 importedModule.ResolveExport(e.[[ImportName]], resolveSet)。
- 若匹配：
- 若 exportName 为
"default" ：- 返回
null 。（默认导出不会由export * from提供）
- 返回
- 令 starResolution =
null 。 - 遍历 [[StarExportEntries]]：
- 令 importedModule =
GetImportedModule (... )。 - 令 resolution = importedModule.ResolveExport(exportName, resolveSet)。
- 若
ambiguous 返回ambiguous 。 - 若非
null ：- 若 starResolution 为
null ，设之。 - 否则若模块不同或 BindingName 不兼容（含命名空间冲突）返回
ambiguous 。
- 若 starResolution 为
- 令 importedModule =
- 返回 starResolution。
16.2.1.7.3 循环模块记录抽象方法的实现 (Implementation of Cyclic Module Record Abstract Methods)
以下为 Source Text
16.2.1.7.3.1 InitializeEnvironment ( )
The InitializeEnvironment concrete method of Source Text
- 对 module.[[IndirectExportEntries]] 每个 e：
- 断言 e.[[ExportName]] 非
null 。 - 令 resolution = module.ResolveExport(e.[[ExportName]])。
- 若为
null 或ambiguous 抛SyntaxError 。
- 断言 e.[[ExportName]] 非
- 断言所有命名导出可解析。
- 令 realm = module.[[Realm]]。
- 断言非
undefined 。 - 令 env =
NewModuleEnvironment (realm.[[GlobalEnv]])。 - 设 module.[[Environment]] = env。
- 对 module.[[ImportEntries]] 每个 in：
- 令 importedModule =
GetImportedModule (... )。 - 若 in.[[ImportName]] 为
namespace-object ：- 令 namespace =
GetModuleNamespace (importedModule)。 - ! CreateImmutableBinding + InitializeBinding。
- 令 namespace =
- 否则：
- 令 resolution = importedModule.ResolveExport(in.[[ImportName]])。
- 若
null 或ambiguous 抛SyntaxError 。 - 若 resolution.[[BindingName]] 为
namespace ：- 获取命名空间并绑定。
- 否则
CreateImportBinding 。
- 令 importedModule =
- 创建执行上下文 moduleContext 并关联环境。
- 推入执行上下文栈并获取 code。
- 处理 VarScopedDeclarations：为每个唯一变量创建并初始化
undefined 。 - 处理 LexicallyScopedDeclarations：创建（可变或不可变）绑定；若是函数类声明，实例化
函数对象 并初始化绑定。 - 弹出执行上下文。
- 返回
unused 。
16.2.1.7.3.2 ExecuteModule ( [ capability ] )
The ExecuteModule concrete method of Source Text
- 创建新执行上下文 moduleContext 并关联 module.[[Environment]]。
- 暂停当前执行上下文。
- 若 module.[[HasTLA]] 为
false ：- 断言 capability 未提供。
- 推入 moduleContext。
- 令 result =
Completion (Evaluation of module.[[ECMAScriptCode]])。 - 弹出并恢复上层上下文。
- 若 result 为突然完成，返回 ? result。
- 否则：
- 断言 capability 存在。
- 执行
AsyncBlockStart (capability, module.[[ECMAScriptCode]], moduleContext)。
- 返回
unused 。
16.2.1.8 合成模块记录 (Synthetic Module Records)
Synthetic Module Record（合成模块记录） 表示由规范定义的模块，其导出名称在创建时静态确定，但值可通过
除
| 字段名 | 值类型 | 含义 |
|---|---|---|
| [[ExportNames]] | 字符串列表 | 模块的导出名称；无重复。 |
| [[EvaluationSteps]] | 抽象闭包 | 求值期间的初始化逻辑，以模块自身为唯一参数；不得修改 [[ExportNames]]；可返回突然完成。 |
16.2.1.8.1 CreateDefaultExportSyntheticModule ( defaultExport )
The abstract operation CreateDefaultExportSyntheticModule takes argument defaultExport (
- 令 realm 为
当前 Realm Record 。 - 令 setDefaultExport 为捕获 defaultExport 的抽象闭包(module)：
- 执行
SetSyntheticModuleExport (module,"default" , defaultExport)。 - 返回
NormalCompletion (unused )。
- 执行
- 返回 { [[Realm]]: realm, [[Environment]]:
empty , [[Namespace]]:empty , [[HostDefined]]:undefined , [[ExportNames]]: «"default" », [[EvaluationSteps]]: setDefaultExport } 的 SyntheticModule Record 。
16.2.1.8.2 ParseJSONModule ( source )
The abstract operation ParseJSONModule takes argument source (String) and returns
- 令 json = ?
ParseJSON (source)。 - 返回
CreateDefaultExportSyntheticModule (json)。
16.2.1.8.3 SetSyntheticModuleExport ( module, exportName, exportValue )
The abstract operation SetSyntheticModuleExport takes arguments module (Synthetic
- 断言：module.[[ExportNames]] 含 exportName。
- 令 envRec = module.[[Environment]]。
- 断言：envRec 非
empty 。 - 执行 envRec.SetMutableBinding(exportName, exportValue,
true )。 - 返回
unused 。
16.2.1.8.4 模块记录抽象方法实现 (Implementation of Module Record Abstract Methods)
以下为合成模块记录对
16.2.1.8.4.1 LoadRequestedModules ( )
The LoadRequestedModules concrete method of Synthetic
- 返回 !
PromiseResolve (%Promise% ,undefined )。
16.2.1.8.4.2 GetExportedNames ( )
The GetExportedNames concrete method of Synthetic
- 返回 module.[[ExportNames]]。
16.2.1.8.4.3 ResolveExport ( exportName )
The ResolveExport concrete method of Synthetic
- 若不含 exportName，返回
null 。 - 返回 { [[Module]]: module, [[BindingName]]: exportName }。
16.2.1.8.4.4 Link ( )
The Link concrete method of Synthetic
- 令 realm = module.[[Realm]]。
- 令 env =
NewModuleEnvironment (realm.[[GlobalEnv]])。 - 设 module.[[Environment]] = env。
- 对 module.[[ExportNames]] 每个 exportName：
- ! CreateMutableBinding + InitializeBinding(exportName,
undefined )。
- ! CreateMutableBinding + InitializeBinding(exportName,
- 返回
NormalCompletion (unused )。
16.2.1.8.4.5 Evaluate ( )
The Evaluate concrete method of Synthetic
- 创建执行上下文 moduleContext 并关联环境。
- 暂停当前执行上下文并推入 moduleContext。
- 令 steps = module.[[EvaluationSteps]]。
- 令 result =
Completion (steps(module))。 - 弹出 moduleContext 并恢复。
- 令 pc = !
NewPromiseCapability (%Promise% )。 IfAbruptRejectPromise (result, pc)。- 执行 ! Call(pc.[[Resolve]],
undefined , «undefined »)。 - 返回 pc.[[Promise]]。
16.2.1.9 GetImportedModule ( referrer, request )
The abstract operation GetImportedModule takes arguments referrer (Cyclic
- 令 records 为 referrer.[[LoadedModules]] 中满足
ModuleRequestsEqual (r, request) 为true 的LoadedModuleRequest Record 列表。 - 断言：records 恰有一个元素。
- 令 record 为其唯一元素。
- 返回 record.[[Module]]。
16.2.1.10 HostLoadImportedModule ( referrer, moduleRequest, hostDefined, payload )
The host-defined abstract operation HostLoadImportedModule takes arguments referrer (Script
在浏览器中，用户点击：
<button type="button" onclick="import('./foo.mjs')">Click me</button>执行 import() 时可能没有活动脚本或模块（执行上下文栈顶 ScriptOrModule 为
HostLoadImportedModule 的实现需满足：
-
必须（同步或异步）执行
FinishLoadingImportedModule (referrer, moduleRequest, payload, result)，其中 result 为正常完成 （含Module Record ）或 throw completion。 -
若多次以相同 referrer 且
ModuleRequestsEqual 为true 的 moduleRequest 调用，且第一次以正常完成 result 调用FinishLoadingImportedModule ，则后续必须以同一 result 调用。 -
若 moduleRequest.[[Attributes]] 存在键
"type" 、值"json" 的条目，则调用FinishLoadingImportedModule 时 result 必须为ParseJSONModule 返回的Completion 或 throw completion。 -
必须将 payload 视为不透明值原样传递给
FinishLoadingImportedModule 。
实际过程由
16.2.1.11 FinishLoadingImportedModule ( referrer, moduleRequest, payload, result )
The abstract operation FinishLoadingImportedModule takes arguments referrer (一个 Script
- 如果 result 是
正常完成 ，则- 如果 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 ( attributes )
The abstract operation AllImportAttributesSupported takes argument attributes (
- 令 supported 为
HostGetSupportedImportAttributes ()。 - 对 attributes 的每个
ImportAttribute Record attribute：- 如果 supported 不包含 attribute.[[Key]]，返回
false 。
- 如果 supported 不包含 attribute.[[Key]]，返回
- 返回
true 。
16.2.1.12.1 HostGetSupportedImportAttributes ( )
The host-defined abstract operation HostGetSupportedImportAttributes takes no arguments and returns 字符串列表. 允许
HostGetSupportedImportAttributes 的实现必须符合以下要求：
- 必须返回一个字符串列表，每个字符串表示一个受支持的属性。
- 每次调用都必须返回同一个包含相同内容且顺序相同的列表。
默认实现返回一个新的空列表。
16.2.1.13 GetModuleNamespace ( module )
The abstract operation GetModuleNamespace takes argument module (
- 断言：若 module 是 Cyclic
Module Record ，则 module.[[Status]] 不为new 或unlinked 。 - 令 namespace 为 module.[[Namespace]]。
- 如果 namespace 为
empty ，则- 令 exportedNames 为 module.GetExportedNames()。
- 令 unambiguousNames 为新的空列表。
- 对 exportedNames 的每个元素 name：
- 令 resolution 为 module.ResolveExport(name)。
- 如果 resolution 是
ResolvedBinding Record ，将 name 追加到 unambiguousNames。
- 设 namespace 为
ModuleNamespaceCreate (module, unambiguousNames)。
- 返回 namespace。
GetModuleNamespace 不会抛出异常。不可解析的名称此时直接排除；除非它们全是未被显式请求的歧义星号导出，否则稍后会导致真实的链接错误。
16.2.1.14 运行时语义：求值 (Runtime Semantics: Evaluation)
- 返回
undefined 。
- 令 result 为
Completion (Evaluation ofModuleItemList )。 - 如果 result 是
正常完成 且 result.[[Value]] 为empty ，则- 返回
undefined 。
- 返回
- 返回 ? result。
- 令 sl 为 ? Evaluation of
ModuleItemList 。 - 令 s 为
Completion (Evaluation ofModuleItem )。 - 返回 ?
UpdateEmpty (s, sl)。
- 返回
empty 。
16.2.2 导入 (Imports)
语法 (Syntax)
16.2.2.1 静态语义：早期错误 (Static Semantics: Early Errors)
-
若
ImportDeclaration 的 BoundNames 含有任意重复条目，则为语法错误。
-
若
WithClause 的 WithClauseToAttributes 具有两个不同条目 a 与 b 且 a.[[Key]] 为 b.[[Key]]，则为语法错误。
16.2.2.2 静态语义：ImportEntries
The syntax-directed operation
- 返回新的空列表。
- 令 entries1 为
ModuleItemList 的 ImportEntries。 - 令 entries2 为
ModuleItem 的 ImportEntries。 - 返回 entries1 与 entries2 的列表连接。
- 返回新的空列表。
- 令 module 为
ImportDeclaration 的 ModuleRequests 的唯一元素。 - 返回
ImportClause 的 ImportEntriesForModule，参数 module。
- 返回新的空列表。
16.2.2.3 静态语义：ImportEntriesForModule
The syntax-directed operation
- 令 entries1 为
ImportedDefaultBinding 的 ImportEntriesForModule，参数 module。 - 令 entries2 为
NameSpaceImport 的 ImportEntriesForModule，参数 module。 - 返回 entries1 与 entries2 的列表连接。
- 令 entries1 为
ImportedDefaultBinding 的 ImportEntriesForModule，参数 module。 - 令 entries2 为
NamedImports 的 ImportEntriesForModule，参数 module。 - 返回 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-object , [[LocalName]]: localName }。 - 返回 « entry »。
- 返回新的空列表。
- 令 specs1 为
ImportsList 的 ImportEntriesForModule，参数 module。 - 令 specs2 为
ImportSpecifier 的 ImportEntriesForModule，参数 module。 - 返回 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 静态语义：WithClauseToAttributes
The syntax-directed operation
- 返回新的空列表。
- 令 attributes 为
WithEntries 的 WithClauseToAttributes。 - 按其 [[Key]] 字段的字典序（视各字段值为 UTF-16 代码单元序列）对 attributes 排序。注：该排序的可观察性仅体现在
宿主 被禁止基于枚举 顺序改变行为。 - 返回 attributes。
- 令 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 导出 (Exports)
语法 (Syntax)
16.2.3.1 静态语义：早期错误 (Static Semantics: Early Errors)
-
若
NamedExports 的 ReferencedBindings 包含任意StringLiteral ，则为语法错误。 -
对于
NamedExports 的 ReferencedBindings 中每个IdentifierName n：若 n 的 StringValue 是ReservedWord ，或其值是"implements" 、"interface" 、"let" 、"package" 、"private" 、"protected" 、"public" 、"static" 之一，则为语法错误。
上述规则意味着
16.2.3.2 静态语义：ExportedBindings
The syntax-directed operation
ExportedBindings 是一个
It is defined piecewise over the following productions:
- 令 names1 为
ModuleItemList 的 ExportedBindings。 - 令 names2 为
ModuleItem 的 ExportedBindings。 - 返回 names1 与 names2 的列表连接。
- 返回新的空列表。
- 返回新的空列表。
- 返回
NamedExports 的 ExportedBindings。
- 返回
VariableStatement 的 BoundNames。
- 返回
Declaration 的 BoundNames。
- 返回此
ExportDeclaration 的 BoundNames。
- 返回新的空列表。
- 令 names1 为
ExportsList 的 ExportedBindings。 - 令 names2 为
ExportSpecifier 的 ExportedBindings。 - 返回 names1 与 names2 的列表连接。
- 返回仅含
ModuleExportName 的 StringValue 的列表。
- 返回仅含第一个
ModuleExportName 的 StringValue 的列表。
16.2.3.3 静态语义：ExportedNames
The syntax-directed operation
ExportedNames 是
It is defined piecewise over the following productions:
- 令 names1 为
ModuleItemList 的 ExportedNames。 - 令 names2 为
ModuleItem 的 ExportedNames。 - 返回 names1 与 names2 的列表连接。
- 返回
ExportDeclaration 的 ExportedNames。
- 返回新的空列表。
- 返回
ExportFromClause 的 ExportedNames。
- 返回新的空列表。
- 返回仅含
ModuleExportName 的 StringValue 的列表。
- 返回
NamedExports 的 ExportedNames。
- 返回
VariableStatement 的 BoundNames。
- 返回
Declaration 的 BoundNames。
- 返回 «
"default" »。
- 返回新的空列表。
- 令 names1 为
ExportsList 的 ExportedNames。 - 令 names2 为
ExportSpecifier 的 ExportedNames。 - 返回 names1 与 names2 的列表连接。
- 返回仅含
ModuleExportName 的 StringValue 的列表。
- 返回仅含第二个
ModuleExportName 的 StringValue 的列表。
16.2.3.4 静态语义：ExportEntries
The syntax-directed operation
- 返回新的空列表。
- 令 entries1 为
ModuleItemList 的 ExportEntries。 - 令 entries2 为
ModuleItem 的 ExportEntries。 - 返回 entries1 与 entries2 的列表连接。
- 返回新的空列表。
- 令 module 为
ExportDeclaration 的 ModuleRequests 的唯一元素。 - 返回
ExportFromClause 的 ExportEntriesForModule，参数 module。
- 返回
NamedExports 的 ExportEntriesForModule，参数null 。
- 令 entries 为新的空列表。
- 令 names 为
VariableStatement 的 BoundNames。 - 对 names 中每个 name：
- 将 ExportEntry
Record { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]: name, [[ExportName]]: name } 追加至 entries。
- 将 ExportEntry
- 返回 entries。
- 令 entries 为新的空列表。
- 令 names 为
Declaration 的 BoundNames。 - 对 names 中每个 name：
- 将 ExportEntry
Record { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]: name, [[ExportName]]: name } 追加至 entries。
- 将 ExportEntry
- 返回 entries。
- 令 names 为
HoistableDeclaration 的 BoundNames。 - 令 localName 为 names 的唯一元素。
- 返回唯一元素为新 ExportEntry
Record { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]: localName, [[ExportName]]:"default" } 的列表。
- 令 names 为
ClassDeclaration 的 BoundNames。 - 令 localName 为 names 的唯一元素。
- 返回唯一元素为新 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 静态语义：ExportEntriesForModule
The syntax-directed operation
- 令 entry 为 ExportEntry
Record { [[ModuleRequest]]: module, [[ImportName]]:all-but-default , [[LocalName]]:null , [[ExportName]]:null }。 - 返回 « entry »。
- 令 exportName 为
ModuleExportName 的 StringValue。 - 令 entry 为 ExportEntry
Record { [[ModuleRequest]]: module, [[ImportName]]:all , [[LocalName]]:null , [[ExportName]]: exportName }。 - 返回 « entry »。
- 返回新的空列表。
- 令 specs1 为
ExportsList 的 ExportEntriesForModule，参数 module。 - 令 specs2 为
ExportSpecifier 的 ExportEntriesForModule，参数 module。 - 返回 specs1 与 specs2 的列表连接。
- 令 sourceName 为
ModuleExportName 的 StringValue。 - 若 module 为
null ，则- 令 localName 为 sourceName。
- 令 importName 为
null 。
- 否则，
- 令 localName 为
null 。 - 令 importName 为 sourceName。
- 令 localName 为
- 返回仅含新 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 为
- 返回仅含新 ExportEntry
Record { [[ModuleRequest]]: module, [[ImportName]]: importName, [[LocalName]]: localName, [[ExportName]]: exportName } 的列表。
16.2.3.6 静态语义：ReferencedBindings
The syntax-directed operation
- 返回新的空列表。
- 令 names1 为
ExportsList 的 ReferencedBindings。 - 令 names2 为
ExportSpecifier 的 ReferencedBindings。 - 返回 names1 与 names2 的列表连接。
- 返回第一个
ModuleExportName 的 ReferencedBindings。
- 返回仅含该
IdentifierName 的列表。
- 返回仅含该
StringLiteral 的列表。
16.2.3.7 运行时语义：求值 (Runtime Semantics: Evaluation)
- 返回
empty 。
- 返回 ? 对
VariableStatement 的 Evaluation。
- 返回 ? 对
Declaration 的 Evaluation。
- 返回 ? 对
HoistableDeclaration 的 Evaluation。
- 令 value 为 ? 对
ClassDeclaration 的 BindingClassDeclarationEvaluation。 - 令 className 为
ClassDeclaration 的 BoundNames 的唯一元素。 - 若 className 为
"*default*" ，则- 令 env 为正在运行的执行上下文的 LexicalEnvironment。
- 执行 ?
InitializeBoundName ("*default*" , value, env)。
- 返回
empty 。
- 若 IsAnonymousFunctionDefinition(
AssignmentExpression ) 为true ，则- 令 value 为 ? NamedEvaluation(
AssignmentExpression ,"default" )。
- 令 value 为 ? NamedEvaluation(
- 否则，
- 令 rhs 为 ? Evaluation(
AssignmentExpression )。 - 令 value 为 ?
GetValue (rhs)。
- 令 rhs 为 ? Evaluation(
- 令 env 为正在运行的执行上下文的 LexicalEnvironment。
- 执行 ?
InitializeBoundName ("*default*" , value, env)。 - 返回
empty 。
17 错误处理与语言扩展 (Error Handling and Language Extensions)
实现必须在相关 ECMAScript 语言结构被求值时报告大多数错误。early error（早期错误） 是指可在包含该错误的 eval 时报告，并阻止 eval 代码的求值。所有不是早期错误的错误都是运行时错误。
实现必须将本规范各 “Static Semantics: Early Errors” 子小节中列出的条件的任何出现作为早期错误报告。
实现不得将其他类型的错误视为早期错误，即使编译器可以证明某个结构在任何情况下都无法无错执行。此类情形下实现可以发出早期警告，但不应在相关结构真正执行之前报告该错误。
实现应按规范报告所有错误，但以下情况除外：
-
除
17.1 的限制外，宿主 或实现可以扩展Script 语法、Module 语法，以及正则表达式模式或标志语法。为允许这一点，所有允许抛出SyntaxError 的操作（例如调用eval、使用正则字面量，或使用 Function 或 RegExp 构造器）在遇到宿主 定义的脚本语法或正则模式/标志语法扩展时，允许表现为宿主 定义行为而不是抛出SyntaxError 。 -
除
17.1 的限制外，宿主 或实现可以提供规范未描述的额外类型、值、对象、属性和函数。这可能导致某些结构（如在全局作用域查找变量）表现为宿主 定义行为，而不是抛出（例如ReferenceError ）错误。
17.1 禁止的扩展 (Forbidden Extensions)
实现不得以下述方式扩展本规范：
-
严格模式代码中用语法构造器定义的 ECMAScript
函数对象 不得被创建为拥有名为"caller" 或"arguments" 的自身属性。对于使用ArrowFunction 、MethodDefinition 、GeneratorDeclaration 、GeneratorExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、ClassDeclaration 、ClassExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 或AsyncArrowFunction 定义的函数对象 ，无论其定义是否位于严格模式代码中，也不得创建此类自身属性。内建函数、使用 Function 构造器创建的严格函数、使用 Generator 构造器创建的生成器函数、使用 AsyncFunction 构造器创建的异步函数以及通过bind方法创建的函数亦不得具有这些自身属性。 -
若实现为任意
函数对象 扩展了名为"caller" 的自身属性，则通过 [[Get]] 或 [[GetOwnProperty]] 观察到的该属性的值不得是严格函数对象 。若它是访问器属性 ，其 [[Get]] 属性值的函数在被调用时绝不能返回严格函数。 -
映射或非映射的 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 Standard Built-in Objects)
当任意 ECMAScript
除非另有说明，可作为函数调用的内建对象是具有
许多内建对象是函数：它们可带参数调用。其中一些还是构造器：它们旨在与 new 运算符一起使用。对于每个内建函数，本规范描述该函数所需的参数及new 表达式返回的特定对象实例的属性。
除非在特定函数的描述中另有说明，如果给内建函数或构造器的实参少于其规范要求的数量，则该函数或构造器的行为与补足缺失的参数（每个缺失参数为
除非在特定函数的描述中另有说明，如果调用所描述的内建函数或构造器时提供的参数多于其允许的数量，多余的参数会被求值但随后被函数忽略。但是，实现可针对这些参数定义实现特定行为，只要该行为不只是因为存在额外参数而抛出
为向内建函数集合添加额外能力的实现，鼓励通过添加新函数而非为现有函数增加新参数来实现。
除非另有说明，每个内建函数与每个内建构造器的 [[Prototype]] 内部槽值为 Function.prototype（
除非另有说明，每个内建原型对象（除 Object.prototype（
若本规范通过算法步骤定义了某内建构造器的行为，则该行为同时适用于 [[Call]] 与 [[Construct]]。若该算法需要区分两种情形，它通过检测 NewTarget 是否为
未标识为构造器的内建
未作为构造器的内建
本规范中定义的每个内建函数（包括构造器）均通过调用
每个内建
例如，
除非另有说明，内建
每个内建
对
除非另有说明，内建
19 全局对象 (The Global Object)
global object（全局对象）：
- 在进入任意执行上下文之前创建。
- 没有 [[Construct]] 内部方法；不能被
new作为构造器使用。 - 没有 [[Call]] 内部方法；不能作为函数调用。
- 具有
宿主 定义值的 [[Prototype]] 内部槽。 - 除规范定义的属性外，可以有
宿主 定义属性。这可以包括值为全局对象自身的属性。
19.1 全局对象的值属性 (Value Properties of the Global Object)
19.1.1 globalThis
该属性具有特性 { [[Writable]]:
19.1.2 Infinity
Infinity 的值为
19.1.3 NaN
NaN 的值为
19.1.4 undefined
undefined 的值为
19.2 全局对象的函数属性 (Function Properties of the Global Object)
19.2.1 eval ( x )
此函数是 %eval% 本源对象。
调用时执行以下步骤：
- 返回 ?
PerformEval (x,false ,false )。
19.2.1.1 PerformEval ( x, strictCaller, direct )
The abstract operation PerformEval takes arguments x (一个
- 断言：若 direct 为
false ，则 strictCaller 也为false 。 - 若 x 不是 String，返回 x。
- 令 evalRealm 为
当前 Realm Record 。 - 注：直接 eval 情况下，evalRealm 同时是调用
eval的调用者与eval函数自身的realm 。 - 执行 ?
HostEnsureCanCompileStrings (evalRealm, « », x, direct)。 - 令 inFunction 为
false 。 - 令 inMethod 为
false 。 - 令 inDerivedConstructor 为
false 。 - 令 inClassFieldInitializer 为
false 。 - 若 direct 为
true ，则- 令 thisEnvRec =
GetThisEnvironment ()。 - 若 thisEnvRec 是
Function Environment Record ，则- 令 F = thisEnvRec.[[FunctionObject]]。
- 设 inFunction 为
true 。 - 设 inMethod 为 thisEnvRec.HasSuperBinding()。
- 若 F.[[ConstructorKind]] 为
derived ，设 inDerivedConstructor 为true 。 - 令 classFieldInitializerName 为 F.[[ClassFieldInitializerName]]。
- 若 classFieldInitializerName 非
empty ，设 inClassFieldInitializer 为true 。
- 令 thisEnvRec =
- 按实现定义顺序执行以下子步骤，可交织解析与错误检测：
- 令 script 为 ParseText(x,
Script )。 - 若 script 为错误列表，抛出
SyntaxError 。 - 若 script Contains
ScriptBody 为false ，返回undefined 。 - 令 body 为 script 的
ScriptBody 。 - 若 inFunction 为
false 且 body ContainsNewTarget ，抛出SyntaxError 。 - 若 inMethod 为
false 且 body ContainsSuperProperty ，抛出SyntaxError 。 - 若 inDerivedConstructor 为
false 且 body ContainsSuperCall ，抛出SyntaxError 。 - 若 inClassFieldInitializer 为
true 且 ContainsArguments(body) 为true ，抛出SyntaxError 。
- 令 script 为 ParseText(x,
- 若 strictCaller 为
true ，令 strictEval 为true 。 - 否则，令 strictEval 为 ScriptIsStrict(script)。
- 令 runningContext 为正在运行的执行上下文。
- 注：若 direct 为
true ，runningContext 是执行直接 eval 的上下文；否则为eval调用的执行上下文。 - 若 direct 为
true ，则- 令 lexEnv =
NewDeclarativeEnvironment (runningContext.LexicalEnvironment)。 - 令 varEnv = runningContext.VariableEnvironment。
- 令 privateEnv = runningContext.PrivateEnvironment。
- 令 lexEnv =
- 否则，
- 令 lexEnv =
NewDeclarativeEnvironment (evalRealm.[[GlobalEnv]])。 - 令 varEnv = evalRealm.[[GlobalEnv]]。
- 令 privateEnv =
null 。
- 令 lexEnv =
- 若 strictEval 为
true ，设 varEnv = lexEnv。 - 若 runningContext 尚未被暂停，则暂停之。
- 令 evalContext 为新的
ECMAScript 代码执行上下文 。 - 设其 Function 为
null 。 - 设其
Realm 为 evalRealm。 - 设其 ScriptOrModule 为 runningContext.ScriptOrModule。
- 设其 VariableEnvironment 为 varEnv。
- 设其 LexicalEnvironment 为 lexEnv。
- 设其 PrivateEnvironment 为 privateEnv。
- 压入 evalContext；其成为正在运行的执行上下文。
- 令 result =
Completion (EvalDeclarationInstantiation (body, varEnv, lexEnv, privateEnv, strictEval))。 - 若 result 为
正常完成 ，则- 设 result =
Completion (Evaluation of body)。
- 设 result =
- 若 result 为
正常完成 且 result.[[Value]] 为empty ，则- 设 result =
NormalCompletion (undefined )。
- 设 result =
- 暂停 evalContext 并将其移出执行上下文栈。
- 恢复当前栈顶上下文。
- 返回 ? result。
若调用者代码或 eval 代码为严格模式代码，eval 代码不得在调用上下文的变量环境中实例化变量或函数绑定；此时这些绑定在新建的 VariableEnvironment 中实例化，仅对 eval 代码可见。由 let、const、class 声明引入的绑定总是在新 LexicalEnvironment 中实例化。
19.2.1.2 HostEnsureCanCompileStrings ( calleeRealm, parameterStrings, bodyString, direct )
The host-defined abstract operation HostEnsureCanCompileStrings takes arguments calleeRealm (
parameterStrings 表示使用函数构造器时会被连接以构造参数列表的字符串。bodyString 表示函数体或传递给 eval 的字符串。
direct 表示是否为直接 eval。
默认实现返回
19.2.1.3 EvalDeclarationInstantiation ( body, varEnv, lexEnv, privateEnv, strict )
The abstract operation EvalDeclarationInstantiation takes arguments body (
- 令 varNames 为 body 的 VarDeclaredNames。
- 令 varDeclarations 为 body 的 VarScopedDeclarations。
- 若 strict 为
false ，则- 若 varEnv 是
Global Environment Record ，则- 对 varNames 每个 name：
- 若
HasLexicalDeclaration (varEnv, name) 为true ，抛SyntaxError 。 - 注：
eval不会创建会被全局词法声明遮蔽的全局 var 声明。
- 若
- 对 varNames 每个 name：
- 令 thisEnv = lexEnv。
- 断言：以下循环会终止。
- 重复，条件：thisEnv 且 thisEnv 与 varEnv 不同：
- 若 thisEnv
不是 Object Environment Record ，则- 注：with 语句环境不含词法声明，因此不需检查 var/let 提升冲突。
- 对 varNames 每个 name：
- 若 ! thisEnv.HasBinding(name) 为
true ，则- Normative Optional若
宿主 为浏览器或支持Catch 块中的 VariableStatements ：- 若 thisEnv 不是
Catch 子句的Environment Record ，抛SyntaxError 。
- 若 thisEnv 不是
- 否则，抛
SyntaxError 。
- 注：直接 eval 不会将 var 声明提升越过同名词法声明。
- 若 ! thisEnv.HasBinding(name) 为
- 设 thisEnv 为 thisEnv.[[OuterEnv]]。
- 若 thisEnv
- 若 varEnv 是
- 令 privateIdentifiers 为新空列表。
- 令 pointer = privateEnv。
- 重复，条件：pointer 非
null ：- 对 pointer.[[Names]] 每个
Private Name binding：- 若 privateIdentifiers 不含 binding.[[Description]]，追加之。
- 设 pointer = pointer.[[OuterPrivateEnvironment]]。
- 对 pointer.[[Names]] 每个
- 若 AllPrivateIdentifiersValid(body, privateIdentifiers) 为
false ，抛SyntaxError 。 - 令 functionsToInitialize 为新空列表。
- 令 declaredFunctionNames 为新空列表。
- 逆序遍历 varDeclarations 中每个 d：
- 若 d 不是
VariableDeclaration 、ForBinding 或BindingIdentifier ，则- 断言：d 为
FunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 或AsyncGeneratorDeclaration 。 - 注：若同名多次函数声明，最后一个生效。
- 令 fn 为其 BoundNames 唯一元素。
- 若 declaredFunctionNames 不含 fn，则
- 若 varEnv 是
Global Environment Record ，则- 令 fnDefinable = ?
CanDeclareGlobalFunction (varEnv, fn)。 - 若 fnDefinable 为
false ，抛TypeError 。
- 令 fnDefinable = ?
- 追加 fn 至 declaredFunctionNames。
- 将 d 插入 functionsToInitialize 首位。
- 若 varEnv 是
- 断言：d 为
- 若 d 不是
- 令 declaredVarNames 为新空列表。
- 遍历 varDeclarations 中每个 d：
- 若 d 是
VariableDeclaration 、ForBinding 或BindingIdentifier ，则- 对其 BoundNames 每个字符串 vn：
- 若 declaredFunctionNames 不含 vn，则
- 若 varEnv 是
Global Environment Record ，则- 令 vnDefinable = ?
CanDeclareGlobalVar (varEnv, vn)。 - 若 vnDefinable 为
false ，抛TypeError 。
- 令 vnDefinable = ?
- 若 declaredVarNames 不含 vn，则追加之。
- 若 varEnv 是
- 若 declaredFunctionNames 不含 vn，则
- 对其 BoundNames 每个字符串 vn：
- 若 d 是
- Normative Optional若 strict 为
false 且宿主 为浏览器或支持块级函数声明 Web 历史兼容语义 ，则- 令 declaredFunctionOrVarNames 为 declaredFunctionNames 与 declaredVarNames 的连接。
- 对每个直接包含于任何
Block 、CaseClause 或DefaultClause 的StatementList 中、且使 body Contains 该子节点为true 的FunctionDeclaration f：- 令 F 为其
BindingIdentifier 的 StringValue。 - 若将 f 替换为以 F 为
BindingIdentifier 的VariableStatement 不会为 body 产生早期错误，则- 令 bindingExists 为
false 。 - 设 thisEnv = lexEnv。
- 断言：以下循环终止。
- 重复，条件：thisEnv ≠ varEnv：
- 若 thisEnv
不是 Object Environment Record ，则- 若 ! thisEnv.HasBinding(F) 为
true ，则- Normative Optional若
宿主 为浏览器或支持Catch 块中的 VariableStatements ：- 若 thisEnv 不是
Catch 子句的Environment Record ，设 bindingExists 为true 。
- 若 thisEnv 不是
- 否则设 bindingExists 为
true 。
- 若 ! thisEnv.HasBinding(F) 为
- 设 thisEnv = thisEnv.[[OuterEnv]]。
- 若 thisEnv
- 若 bindingExists 为
false 且 varEnv 是Global Environment Record ，则- 若
HasLexicalDeclaration (varEnv, F) 为false ，则- 令 fnDefinable = ?
CanDeclareGlobalVar (varEnv, F)。
- 令 fnDefinable = ?
- 否则设 fnDefinable 为
false 。
- 若
- 否则，
- 设 fnDefinable 为
true 。
- 设 fnDefinable 为
- 若 bindingExists 为
false 且 fnDefinable 为true ，则- 若 declaredFunctionOrVarNames 不含 F，则
- 若 varEnv 是
Global Environment Record ，则- 执行 ?
CreateGlobalVarBinding (varEnv, F,true )。
- 执行 ?
- 否则，
- 设 bindingExists = ! varEnv.HasBinding(F)。
- 若 bindingExists 为
false ，则- 执行 ! varEnv.CreateMutableBinding(F,
true )。 - 执行 ! varEnv.InitializeBinding(F,
undefined )。
- 执行 ! varEnv.CreateMutableBinding(F,
- 追加 F 至 declaredFunctionOrVarNames。
- 若 varEnv 是
- 当
FunctionDeclaration f 被求值时，执行以下步骤替代15.2.6 中的求值算法：- 令 gEnv 为正在运行执行上下文的 VariableEnvironment。
- 令 bEnv 为正在运行执行上下文的 LexicalEnvironment。
- 令 fObj 为 ! bEnv.GetBindingValue(F,
false )。 - 执行 ? gEnv.SetMutableBinding(F, fObj,
false )。 - 返回
unused 。
- 若 declaredFunctionOrVarNames 不含 F，则
- 令 bindingExists 为
- 令 F 为其
- 注：除非 varEnv 为
Global Environment Record 且全局对象为 Proxy 异域对象，此后不再出现异常终止。 - 令 lexDeclarations 为 body 的 LexicallyScopedDeclarations。
- 对 lexDeclarations 每个 d：
- 注：词法声明名此处仅实例化，未初始化。
- 对 d 的 BoundNames 每个 dn：
- 若 IsConstantDeclaration(d) 为
true ，执行 ? lexEnv.CreateImmutableBinding(dn,true )。 - 否则执行 ? lexEnv.CreateMutableBinding(dn,
false )。
- 若 IsConstantDeclaration(d) 为
- 对 functionsToInitialize 每个
解析节点 f：- 令 fn 为其 BoundNames 唯一元素。
- 令 fo 为 InstantiateFunctionObject(f, lexEnv, privateEnv)。
- 若 varEnv 是
Global Environment Record ，则- 执行 ?
CreateGlobalFunctionBinding (varEnv, fn, fo,true )。
- 执行 ?
- 否则，
- 令 bindingExists = ! varEnv.HasBinding(fn)。
- 若
false ：- 注：因前置验证，不会异常。
- 执行 ! varEnv.CreateMutableBinding(fn,
true )。 - 执行 ! varEnv.InitializeBinding(fn, fo)。
- 否则执行 ! varEnv.SetMutableBinding(fn, fo,
false )。
- 对 declaredVarNames 每个字符串 vn：
- 若 varEnv 是
Global Environment Record ，则- 执行 ?
CreateGlobalVarBinding (varEnv, vn,true )。
- 执行 ?
- 否则，
- 令 bindingExists = ! varEnv.HasBinding(vn)。
- 若
false ：- 注：因前置验证不异常。
- 执行 ! varEnv.CreateMutableBinding(vn,
true )。 - 执行 ! varEnv.InitializeBinding(vn,
undefined )。
- 若 varEnv 是
- 返回
unused 。
19.2.2 isFinite ( number )
此函数是 %isFinite% 本源对象。
调用时执行：
19.2.3 isNaN ( number )
此函数是 %isNaN% 本源对象。
调用时执行：
- 令 num = ?
ToNumber (number)。 - 若 num 为
NaN ，返回true 。 - 否则返回
false 。
在 ECMAScript 中检测值 X 是否为 X !== X；仅当且仅当 X 为
19.2.4 parseFloat ( string )
该函数根据对参数 string 内容按十进制字面量的解释产生一个 Number 值。
它是 %parseFloat% 本源对象。
调用时执行：
- 令 inputString = ?
ToString (string)。 - 令 trimmedString = !
TrimString (inputString,start )。 - 令 trimmed = StringToCodePoints(trimmedString)。
- 令 trimmedPrefix 为 trimmed 的最长前缀，满足
StrDecimalLiteral 语法，可能等于 trimmed 本身。若不存在，返回NaN 。 - 令 parsedNumber = ParseText(trimmedPrefix,
StrDecimalLiteral )。 - 断言：parsedNumber 为
解析节点 。 - 返回 parsedNumber 的 StringNumericValue。
该函数可能仅将 string 的前导部分解释为 Number；忽略无法视为十进制字面量部分的代码单元，且不会指示有代码单元被忽略。
19.2.5 parseInt ( string, radix )
该函数依据指定 radix 对 string 内容的解释产生一个整数 Number。忽略 string 前导空白。若 radix 强制为 0（如其为
它是 %parseInt% 本源对象。
调用时执行：
- 令 inputString = ?
ToString (string)。 - 令 S = !
TrimString (inputString,start )。 - 令 sign = 1。
- 若 S 非空且首代码单元为 0x002D，设 sign = -1。
- 若 S 非空且首代码单元为 0x002B 或 0x002D，设 S 为去掉首单元的子串。
- 令 R =
ℝ (?ToInt32 (radix))。 - 令 stripPrefix =
true 。 - 若 R ≠ 0，则
- 若 R < 2 或 R > 36，返回
NaN 。 - 若 R ≠ 16，设 stripPrefix =
false 。
- 若 R < 2 或 R > 36，返回
- 否则设 R = 10。
- 若 stripPrefix 为
true ，则- 若 S 长度 ≥ 2 且前两代码单元为
"0x" 或"0X" ，则- 设 S 为从索引 2 起子串。
- 设 R = 16。
- 若 S 长度 ≥ 2 且前两代码单元为
- 若 S 含有非基数 R 数字的代码单元，令 end 为首此类代码单元索引；否则 end 为 S 长度。
- 令 Z = S 从 0 到 end 的子串。
- 若 Z 为空，返回
NaN 。 - 令 mathInt 为以基数-R 表示 Z 的整数值，使用字母 A-Z / a-z 表示 10 到 35。（但若 R = 10 且 Z 含超过 20 个有效数字，实现可将第 21 位及之后替换为 0；若 R 不在 {2,4,8,10,16,32}，mathInt 可为
实现近似 值。） - 若 mathInt = 0，则
- 若 sign = -1，返回
-0 𝔽。 - 返回
+0 𝔽。
- 若 sign = -1，返回
- 返回
𝔽 (sign × mathInt)。
该函数可能仅将 string 的前导部分解释为整数；忽略无法视为整数表示的代码单元，且不会给出被忽略的提示。
19.2.6 URI 处理函数 (URI Handling Functions)
统一资源标识符（URI）是识别资源（如网页或文件）及其访问传输协议（如 HTTP、FTP）的字符串。ECMAScript 语言本身除提供按本节描述进行 URI 编解码的函数外，不提供使用 URI 的支持。encodeURI 与 decodeURI 针对完整 URI；它们假设保留字符具特殊含义（如作为分隔符），故不编码它们。encodeURIComponent 与 decodeURIComponent 针对 URI 的各个组成部分；它们假设保留字符代表文本，需编码以在该组成部分成为完整 URI 的一部分时避免特殊含义。
保留字符集合基于 RFC 2396，未反映较新的 RFC 3986 所引入的变化。
许多 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 (字符串) and extraUnescaped (字符串) and returns
- 令 len 为 string 长度。
- 令 R 为空字符串。
- 令 alwaysUnescaped 为 ASCII 单词字符与
"-.!~*'()" 的串联。 - 令 unescapedSet = alwaysUnescaped 与 extraUnescaped 的串联。
- 令 k = 0。
- 重复，条件：k < len：
- 令 C 为 string 索引 k 的代码单元。
- 若 unescapedSet 包含 C，则
- k ← k + 1。
- R ← R 与 C 串联。
- 否则，
- 令 cp = CodePointAt(string, k)。
- 若 cp.[[IsUnpairedSurrogate]] 为
true ，抛URIError 。 - k ← k + cp.[[CodeUnitCount]]。
- 令 Octets 为将 cp.[[CodePoint]] 进行 UTF-8 转换得到的八位组列表。
- 对 Octets 每个 octet：
- 令 hex 为 octet 的大写十六进制字符串。
- R ← R 与
"%" 及StringPad (hex, 2,"0" ,start ) 串联。
- 返回 R。
因百分号编码表示单个八位组，一个码点可能由多个连续转义序列（其 UTF-8 各字节）表示。
19.2.6.6 Decode ( string, preserveEscapeSet )
The abstract operation Decode takes arguments string (字符串) and preserveEscapeSet (字符串) and returns
- 令 len 为 string 长度。
- 令 R 为空字符串。
- 令 k = 0。
- 重复，条件：k < len：
- 令 C 为 string 索引 k 的代码单元。
- 令 S = C。
- 若 C 为 0x0025，则
- 若 k + 3 > len，抛
URIError 。 - 令 escape 为从 k 到 k + 3 的子串。
- 令 B =
ParseHexOctet (string, k + 1)。 - 若 B 非整数，抛
URIError 。 - k ← k + 2。
- 令 n 为 B 中前导 1 比特数。
- 若 n = 0，则
- 令 asciiChar 为数值 B 的代码单元。
- 若 preserveEscapeSet 包含 asciiChar，设 S = escape；否则 S = asciiChar。
- 否则，
- 若 n = 1 或 n > 4，抛
URIError 。 - 令 Octets = « B »。
- 令 j = 1。
- 重复，条件：j < n：
- k ← k + 1。
- 若 k + 3 > len，抛
URIError 。 - 若索引 k 代码单元不是 0x0025，抛
URIError 。 - 令 continuationByte =
ParseHexOctet (string, k + 1)。 - 若其非整数，抛
URIError 。 - 追加 continuationByte 至 Octets。
- k ← k + 2。
- j ← j + 1。
- 断言：Octets 长度为 n。
- 若 Octets 不含有效 UTF-8 编码，抛
URIError 。 - 令 V 为对 Octets 应用 UTF-8 转换得到的码点。
- 设 S = UTF16EncodeCodePoint(V)。
- 若 n = 1 或 n > 4，抛
- 若 k + 3 > len，抛
- R ← R 与 S 串联。
- k ← k + 1。
- 返回 R。
RFC 3629 禁止解码无效 UTF-8 序列。例如，无效序列 0xC0 0x80 不得解码为 0x0000。Decode 算法的实现遇到此类无效序列必须抛
19.2.6.7 ParseHexOctet ( string, position )
The abstract operation ParseHexOctet takes arguments string (字符串) and position (非负整数) and returns 非负整数或非空
19.3 全局对象的构造器属性 (Constructor Properties of the Global Object)
19.3.1 AggregateError ( . . . )
见
19.3.2 Array ( . . . )
见
19.3.3 ArrayBuffer ( . . . )
见
19.3.4 BigInt ( . . . )
见
19.3.5 BigInt64Array ( . . . )
见
19.3.6 BigUint64Array ( . . . )
见
19.3.7 Boolean ( . . . )
见
19.3.8 DataView ( . . . )
见
19.3.9 Date ( . . . )
见
19.3.10 Error ( . . . )
见
19.3.11 EvalError ( . . . )
见
19.3.12 FinalizationRegistry ( . . . )
见
19.3.13 Float16Array ( . . . )
见
19.3.14 Float32Array ( . . . )
见
19.3.15 Float64Array ( . . . )
见
19.3.16 Function ( . . . )
见
19.3.17 Int8Array ( . . . )
见
19.3.18 Int16Array ( . . . )
见
19.3.19 Int32Array ( . . . )
见
19.3.20 Iterator ( . . . )
见
19.3.21 Map ( . . . )
见
19.3.22 Number ( . . . )
见
19.3.23 Object ( . . . )
见
19.3.24 Promise ( . . . )
见
19.3.25 Proxy ( . . . )
见
19.3.26 RangeError ( . . . )
见
19.3.27 ReferenceError ( . . . )
见
19.3.28 RegExp ( . . . )
见
19.3.29 Set ( . . . )
见
19.3.30 SharedArrayBuffer ( . . . )
见
19.3.31 String ( . . . )
见
19.3.32 Symbol ( . . . )
见
19.3.33 SyntaxError ( . . . )
见
19.3.34 TypeError ( . . . )
见
19.3.35 Uint8Array ( . . . )
见
19.3.36 Uint8ClampedArray ( . . . )
见
19.3.37 Uint16Array ( . . . )
见
19.3.38 Uint32Array ( . . . )
见
19.3.39 URIError ( . . . )
见
19.3.40 WeakMap ( . . . )
见
19.3.41 WeakRef ( . . . )
见
19.3.42 WeakSet ( . . . )
见
19.4 全局对象的其他属性 (Other Properties of the Global Object)
19.4.1 Atomics
见
19.4.2 JSON
见
19.4.3 Math
见
19.4.4 Reflect
见
20 基础对象 (Fundamental Objects)
20.1 Object 对象 (Object Objects)
20.1.1 Object 构造函数 (The Object Constructor)
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 构造函数的属性 (Properties of the Object Constructor)
Object
- 拥有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 有
"length" 属性，其值为1 𝔽。 - 具有以下附加属性：
20.1.2.1 Object.assign ( target, ...sources )
该函数将一个或多个源对象自身的可
调用时执行以下步骤：
- 令 to 为 ?
ToObject (target)。 - 如果只传入一个参数，返回 to。
- 对 sources 中每个元素 nextSource，执行
- 如果 nextSource 既不是
undefined 也不是null ，则
- 如果 nextSource 既不是
- 返回 to。
此函数的
20.1.2.2 Object.create ( O, Properties )
该函数创建一个具有指定原型的新对象。
调用时执行以下步骤：
- 如果 O
不是 Object 且 O 不是null ，抛出TypeError 异常。 - 令 obj 为
OrdinaryObjectCreate (O)。 - 如果 Properties 不是
undefined ，则- 返回 ?
ObjectDefineProperties (obj, Properties)。
- 返回 ?
- 返回 obj。
20.1.2.3 Object.defineProperties ( O, Properties )
该函数为对象添加自有属性和/或更新已有自有属性的特性。
调用时执行以下步骤：
- 如果 O
不是 Object ，抛出TypeError 异常。 - 返回 ?
ObjectDefineProperties (O, Properties)。
20.1.2.3.1 ObjectDefineProperties ( O, Properties )
The abstract operation ObjectDefineProperties takes arguments O (an Object) and Properties (an ECMAScript language value) and returns 一个包含 Object 的
- 令 props 为 ?
ToObject (Properties)。 - 令 keys 为 ? props.[[OwnPropertyKeys]]()。
- 令 descriptors 为一个新的空列表。
- 对 keys 中每个元素 nextKey，执行
- 令 propDesc 为 ? props.[[GetOwnProperty]](nextKey)。
- 如果 propDesc 不为
undefined 且 propDesc.[[Enumerable]] 为true ，则- 令 descObj 为 ?
Get (props, nextKey)。 - 令 desc 为 ?
ToPropertyDescriptor (descObj)。 - 将记录 { [[Key]]: nextKey, [[Descriptor]]: desc } 追加到 descriptors。
- 令 descObj 为 ?
- 对 descriptors 中每个元素 property，执行
- 执行 ?
DefinePropertyOrThrow (O, property.[[Key]], property.[[Descriptor]])。
- 执行 ?
- 返回 O。
20.1.2.4 Object.defineProperty ( O, P, Attributes )
该函数为对象添加一个自有属性和/或更新已有自有属性的特性。
调用时执行以下步骤：
- 如果 O
不是 Object ，抛出TypeError 异常。 - 令 key 为 ?
ToPropertyKey (P)。 - 令 desc 为 ?
ToPropertyDescriptor (Attributes)。 - 执行 ?
DefinePropertyOrThrow (O, key, desc)。 - 返回 O。
20.1.2.5 Object.entries ( O )
该函数被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (O)。 - 令 entryList 为 ?
EnumerableOwnProperties (obj,key+value )。 - 返回
CreateArrayFromList (entryList)。
20.1.2.6 Object.freeze ( O )
该函数被调用时执行以下步骤：
- 如果 O
不是 Object ，返回 O。 - 令 status 为 ?
SetIntegrityLevel (O,frozen )。 - 如果 status 为
false ，抛出TypeError 异常。 - 返回 O。
20.1.2.7 Object.fromEntries ( iterable )
该函数被调用时执行以下步骤：
- 执行 ?
RequireObjectCoercible (iterable)。 - 令 obj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 断言：obj 是一个可扩展且无自有属性的
普通对象 。 - 令 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 ( O, P )
该函数被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (O)。 - 令 key 为 ?
ToPropertyKey (P)。 - 令 desc 为 ? obj.[[GetOwnProperty]](key)。
- 返回
FromPropertyDescriptor (desc)。
20.1.2.9 Object.getOwnPropertyDescriptors ( O )
该函数被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (O)。 - 令 ownKeys 为 ? obj.[[OwnPropertyKeys]]()。
- 令 descriptors 为
OrdinaryObjectCreate (%Object.prototype% )。 - 对 ownKeys 中每个元素 key，执行
- 令 desc 为 ? obj.[[GetOwnProperty]](key)。
- 令 descriptor 为
FromPropertyDescriptor (desc)。 - 如果 descriptor 不为
undefined ，执行 !CreateDataPropertyOrThrow (descriptors, key, descriptor)。
- 返回 descriptors。
20.1.2.10 Object.getOwnPropertyNames ( O )
该函数被调用时执行以下步骤：
- 返回
CreateArrayFromList (?GetOwnPropertyKeys (O,string ))。
20.1.2.11 Object.getOwnPropertySymbols ( O )
该函数被调用时执行以下步骤：
- 返回
CreateArrayFromList (?GetOwnPropertyKeys (O,symbol ))。
20.1.2.11.1 GetOwnPropertyKeys ( O, type )
The abstract operation GetOwnPropertyKeys takes arguments O (an ECMAScript language value) and type (
- 令 obj 为 ?
ToObject (O)。 - 令 keys 为 ? obj.[[OwnPropertyKeys]]()。
- 令 nameList 为一个新的空列表。
- 对 keys 中每个元素 nextKey，执行
- 如果 nextKey 是 Symbol 且 type 为
symbol ，或 nextKey 是 String 且 type 为string ，则- 将 nextKey 追加到 nameList。
- 如果 nextKey 是 Symbol 且 type 为
- 返回 nameList。
20.1.2.12 Object.getPrototypeOf ( O )
该函数被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (O)。 - 返回 ? obj.[[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 中每个记录 { [[Key]], [[Elements]] } g，执行
- 令 elements 为
CreateArrayFromList (g.[[Elements]])。 - 执行 !
CreateDataPropertyOrThrow (obj, g.[[Key]], elements)。
- 令 elements 为
- 返回 obj。
20.1.2.14 Object.hasOwn ( O, P )
该函数被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (O)。 - 令 key 为 ?
ToPropertyKey (P)。 - 返回 ?
HasOwnProperty (obj, key)。
20.1.2.15 Object.is ( value1, value2 )
该函数被调用时执行以下步骤：
- 返回
SameValue (value1, value2)。
20.1.2.16 Object.isExtensible ( O )
该函数被调用时执行以下步骤：
- 如果 O
不是 Object ，返回false 。 - 返回 ?
IsExtensible (O)。
20.1.2.17 Object.isFrozen ( O )
该函数被调用时执行以下步骤：
- 如果 O
不是 Object ，返回true 。 - 返回 ?
TestIntegrityLevel (O,frozen )。
20.1.2.18 Object.isSealed ( O )
该函数被调用时执行以下步骤：
- 如果 O
不是 Object ，返回true 。 - 返回 ?
TestIntegrityLevel (O,sealed )。
20.1.2.19 Object.keys ( O )
该函数被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (O)。 - 令 keyList 为 ?
EnumerableOwnProperties (obj,key )。 - 返回
CreateArrayFromList (keyList)。
20.1.2.20 Object.preventExtensions ( O )
该函数被调用时执行以下步骤：
- 如果 O
不是 Object ，返回 O。 - 令 status 为 ? O.[[PreventExtensions]]()。
- 如果 status 为
false ，抛出TypeError 异常。 - 返回 O。
20.1.2.21 Object.prototype
Object.prototype 的初始值
该属性具有特性 { [[Writable]]:
20.1.2.22 Object.seal ( O )
该函数被调用时执行以下步骤：
- 如果 O
不是 Object ，返回 O。 - 令 status 为 ?
SetIntegrityLevel (O,sealed )。 - 如果 status 为
false ，抛出TypeError 异常。 - 返回 O。
20.1.2.23 Object.setPrototypeOf ( O, proto )
该函数被调用时执行以下步骤：
- 执行 ?
RequireObjectCoercible (O)。 - 如果 proto
不是 Object 且 proto 不是null ，抛出TypeError 异常。 - 如果 O
不是 Object ，返回 O。 - 令 status 为 ? O.[[SetPrototypeOf]](proto)。
- 如果 status 为
false ，抛出TypeError 异常。 - 返回 O。
20.1.2.24 Object.values ( O )
该函数被调用时执行以下步骤：
- 令 obj 为 ?
ToObject (O)。 - 令 valueList 为 ?
EnumerableOwnProperties (obj,value )。 - 返回
CreateArrayFromList (valueList)。
20.1.3 Object 原型对象的属性 (Properties of the Object Prototype 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 ( V )
该方法被调用时执行以下步骤：
- 令 P 为 ?
ToPropertyKey (V)。 - 令 O 为 ?
ToObject (this value)。 - 返回 ?
HasOwnProperty (O, P)。
20.1.3.3 Object.prototype.isPrototypeOf ( V )
该方法被调用时执行以下步骤：
20.1.3.4 Object.prototype.propertyIsEnumerable ( V )
该方法被调用时执行以下步骤：
- 令 P 为 ?
ToPropertyKey (V)。 - 令 O 为 ?
ToObject (this value)。 - 令 desc 为 ? O.[[GetOwnProperty]](P)。
- 如果 desc 是
undefined ，返回false 。 - 返回 desc.[[Enumerable]]。
此方法不考虑原型链上的对象。
20.1.3.5 Object.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 返回 ? Invoke(O,
"toString" )。
此方法的可选参数未使用，其存在旨在与 ECMA-402 toLocaleString 方法所使用的参数模式一致。不包含 ECMA-402 支持的实现不得将这些参数位置用于其他目的。
该方法为没有本地化敏感 toString 行为的对象提供通用 toLocaleString 实现。Array、Number、Date 和 toLocaleString 方法。
ECMA-402 有意不为此默认实现提供替代方案。
20.1.3.6 Object.prototype.toString ( )
该方法被调用时执行以下步骤：
- 如果
this 值为undefined ，返回"[object Undefined]" 。 - 如果
this 值为null ，返回"[object Null]" 。 - 令 O 为 !
ToObject (this value)。 - 令 isArray 为 ?
IsArray (O)。 - 如果 isArray 为
true ，令 builtinTag 为"Array" 。 - 否则如果 O 有 [[ParameterMap]] 内部槽，令 builtinTag 为
"Arguments" 。 - 否则如果 O 具有 [[Call]] 内部方法，令 builtinTag 为
"Function" 。 - 否则如果 O 有 [[ErrorData]] 内部槽，令 builtinTag 为
"Error" 。 - 否则如果 O 有 [[BooleanData]] 内部槽，令 builtinTag 为
"Boolean" 。 - 否则如果 O 有 [[NumberData]] 内部槽，令 builtinTag 为
"Number" 。 - 否则如果 O 有 [[StringData]] 内部槽，令 builtinTag 为
"String" 。 - 否则如果 O 有 [[DateValue]] 内部槽，令 builtinTag 为
"Date" 。 - 否则如果 O 有 [[RegExpMatcher]] 内部槽，令 builtinTag 为
"RegExp" 。 - 否则，令 builtinTag 为
"Object" 。 - 令 tag 为 ?
Get (O,%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]] 特性的值是一个不需要参数的内建函数。被调用时执行：
- 令 O 为 ?
ToObject (this value)。 - 返回 ? O.[[GetPrototypeOf]]()。
20.1.3.8.2 set Object.prototype.__proto__
[[Set]] 特性的值是一个接受参数 proto 的内建函数。被调用时执行：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 如果 proto
不是 Object 且 proto 不是null ，返回undefined 。 - 如果 O
不是 Object ，返回undefined 。 - 令 status 为 ? O.[[SetPrototypeOf]](proto)。
- 如果 status 为
false ，抛出TypeError 异常。 - 返回
undefined 。
20.1.3.9 遗留 Object.prototype 访问器方法 (Legacy Object.prototype Accessor Methods)
20.1.3.9.1 Object.prototype.__defineGetter__ ( P, getter )
该方法被调用时执行以下步骤：
- 令 O 为 ?
ToObject (this value)。 - 如果
IsCallable (getter) 为false ，抛出TypeError 异常。 - 令 desc 为 PropertyDescriptor { [[Get]]: getter, [[Enumerable]]:
true , [[Configurable]]:true }。 - 令 key 为 ?
ToPropertyKey (P)。 - 执行 ?
DefinePropertyOrThrow (O, key, desc)。 - 返回
undefined 。
20.1.3.9.2 Object.prototype.__defineSetter__ ( P, setter )
该方法被调用时执行以下步骤：
- 令 O 为 ?
ToObject (this value)。 - 如果
IsCallable (setter) 为false ，抛出TypeError 异常。 - 令 desc 为 PropertyDescriptor { [[Set]]: setter, [[Enumerable]]:
true , [[Configurable]]:true }。 - 令 key 为 ?
ToPropertyKey (P)。 - 执行 ?
DefinePropertyOrThrow (O, key, desc)。 - 返回
undefined 。
20.1.3.9.3 Object.prototype.__lookupGetter__ ( P )
该方法被调用时执行以下步骤：
- 令 O 为 ?
ToObject (this value)。 - 令 key 为 ?
ToPropertyKey (P)。 - 重复，
- 令 desc 为 ? O.[[GetOwnProperty]](key)。
- 如果 desc 不为
undefined ，则- 如果
IsAccessorDescriptor (desc) 为true ，返回 desc.[[Get]]。 - 返回
undefined 。
- 如果
- 设 O 为 ? O.[[GetPrototypeOf]]()。
- 如果 O 为
null ，返回undefined 。
20.1.3.9.4 Object.prototype.__lookupSetter__ ( P )
该方法被调用时执行以下步骤：
- 令 O 为 ?
ToObject (this value)。 - 令 key 为 ?
ToPropertyKey (P)。 - 重复，
- 令 desc 为 ? O.[[GetOwnProperty]](key)。
- 如果 desc 不为
undefined ，则- 如果
IsAccessorDescriptor (desc) 为true ，返回 desc.[[Set]]。 - 返回
undefined 。
- 如果
- 设 O 为 ? O.[[GetPrototypeOf]]()。
- 如果 O 为
null ，返回undefined 。
20.1.4 Object 实例的属性 (Properties of Object Instances)
Object 实例除继承自
20.2 Function 对象 (Function Objects)
20.2.1 Function 构造函数 (The Function Constructor)
Function
- 是 %Function%。
- 是全局对象
"Function" 属性的初始值。 - 作为函数而非
构造函数 调用时创建并初始化一个新的函数对象 。因此函数调用Function(…)等价于使用相同参数的对象创建表达式new Function(…)。 - 可用作类定义
extends子句取值。打算继承规定 Function 行为的子类构造函数 必须包含对 Function构造函数 的super调用，以创建并初始化一个具有内建函数行为所需内部槽的子类实例。所有 ECMAScript 语法形式定义的函数对象 都是 Function 的实例。除内建 GeneratorFunction、AsyncFunction、AsyncGeneratorFunction 子类外，没有语法方式可创建 Function 子类实例。
20.2.1.1 Function ( ...parameterArgs, bodyArg )
最后一个参数（若存在）指定函数体（可执行代码）；之前的任何参数指定形式参数。
该函数被调用时执行以下步骤：
- 令 C 为活动
函数对象 。 - 如果 bodyArg 未传入，设 bodyArg 为空字符串。
- 返回 ?
CreateDynamicFunction (C, NewTarget,normal , parameterArgs, 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 ( constructor, newTarget, kind, parameterArgs, bodyArg )
The abstract operation CreateDynamicFunction takes arguments constructor (a constructor), newTarget (a constructor or new 应用于的
- 如果 newTarget 是
undefined ，设 newTarget 为 constructor。 - 如果 kind 是
normal ，则- 令 prefix 为
"function" 。 - 令 exprSym 为语法符号
FunctionExpression 。 - 令 bodySym 为语法符号
FunctionBody 。[~Yield, ~Await] - 令 parameterSym 为语法符号
FormalParameters 。[~Yield, ~Await] - 令 fallbackProto 为
"%Function.prototype%" 。
- 令 prefix 为
- 否则如果 kind 是
generator ，则- 令 prefix 为
"function*" 。 - 令 exprSym 为
GeneratorExpression 。 - 令 bodySym 为
GeneratorBody 。 - 令 parameterSym 为
FormalParameters 。[+Yield, ~Await] - 令 fallbackProto 为
"%GeneratorFunction.prototype%" 。
- 令 prefix 为
- 否则如果 kind 是
async ，则- 令 prefix 为
"async function" 。 - 令 exprSym 为
AsyncFunctionExpression 。 - 令 bodySym 为
AsyncFunctionBody 。 - 令 parameterSym 为
FormalParameters 。[~Yield, +Await] - 令 fallbackProto 为
"%AsyncFunction.prototype%" 。
- 令 prefix 为
- 否则，
- 断言：kind 为
async-generator 。 - 令 prefix 为
"async function*" 。 - 令 exprSym 为
AsyncGeneratorExpression 。 - 令 bodySym 为
AsyncGeneratorBody 。 - 令 parameterSym 为
FormalParameters 。[+Yield, +Await] - 令 fallbackProto 为
"%AsyncGeneratorFunction.prototype%" 。
- 断言：kind 为
- 令 argCount 为 parameterArgs 元素个数。
- 令 parameterStrings 为一个新的空列表。
- 对 parameterArgs 中每个元素 arg，执行
- 追加 ?
ToString (arg) 到 parameterStrings。
- 追加 ?
- 令 bodyString 为 ?
ToString (bodyArg)。 - 令 currentRealm 为
当前 Realm Record 。 - 执行 ?
HostEnsureCanCompileStrings (currentRealm, parameterStrings, bodyString,false )。 - 令 P 为空字符串。
- 如果 argCount > 0，则
- 设 P 为 parameterStrings[0]。
- 令 k 为 1。
- 当 k < argCount，重复
- 令 nextArgString 为 parameterStrings[k]。
- 设 P 为 P、
"," 与 nextArgString 的串联。 - 设 k 为 k + 1。
- 令 bodyParseString 为 0x000A、bodyString、0x000A 的串联。
- 令 sourceString 为 prefix、
" anonymous(" 、P、0x000A、") {" 、bodyParseString、"}" 的串联。 - 令 sourceText 为 StringToCodePoints(sourceString)。
- 令 parameters 为 ParseText(P, parameterSym)。
- 如果 parameters 是错误列表，抛出
SyntaxError 异常。 - 令 body 为 ParseText(bodyParseString, bodySym)。
- 如果 body 是错误列表，抛出
SyntaxError 异常。 - 注：参数和主体分开解析以保证各自单独有效。例如，
new Function("/*", "*/ ) {")不会求值为函数。 - 注：如果到达此步骤，sourceText 必定具有 exprSym 的语法（但反向不成立）。接下来两步的目的在于强制任何直接适用于 exprSym 的
早期错误规则 。 - 令 expr 为 ParseText(sourceText, exprSym)。
- 如果 expr 是错误列表，抛出
SyntaxError 异常。 - 令 proto 为 ?
GetPrototypeFromConstructor (newTarget, fallbackProto)。 - 令 env 为 currentRealm.[[GlobalEnv]]。
- 令 privateEnv 为
null 。 - 令 F 为
OrdinaryFunctionCreate (proto, sourceText, parameters, body,non-lexical-this , env, privateEnv)。 - 执行
SetFunctionName (F,"anonymous" )。 - 如果 kind 是
generator ，则- 令 prototype 为
OrdinaryObjectCreate (%GeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (F,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。
- 令 prototype 为
- 否则如果 kind 是
async-generator ，则- 令 prototype 为
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )。 - 执行 !
DefinePropertyOrThrow (F,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })。
- 令 prototype 为
- 否则如果 kind 是
normal ，则- 执行
MakeConstructor (F)。
- 执行
- 注：kind 为
async 的函数是不可构造的，不具有 [[Construct]] 内部方法或"prototype" 属性。 - 返回 F。
CreateDynamicFunction 会在它创建的、kind 不是
20.2.2 Function 构造函数的属性 (Properties of the Function Constructor)
Function
- 其自身是一个内建
函数对象 。 - 拥有 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 有
"length" 属性，其值为1 𝔽。 - 具有以下属性：
20.2.2.1 Function.prototype
Function.prototype 的值是
该属性具有特性 { [[Writable]]:
20.2.3 Function 原型对象的属性 (Properties of the Function Prototype Object)
Function 原型对象：
- 是 %Function.prototype%。
- 其自身是一个内建
函数对象 。 - 接受任意参数并在调用时返回
undefined 。 - 没有 [[Construct]] 内部方法；不能被
new用作构造器。 - 具有 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 没有
"prototype" 属性。 - 有
"length" 属性，其值为+0 𝔽。 - 有
"name" 属性，其值为空字符串。
将 Function 原型对象指定为
20.2.3.1 Function.prototype.apply ( thisArg, argArray )
该方法被调用时执行以下步骤：
- 令 func 为
this 值。 - 如果
IsCallable (func) 为false ，抛出TypeError 异常。 - 如果 argArray 是
undefined 或null ，则- 执行
PrepareForTailCall ()。 - 返回 ? Call(func, thisArg)。
- 执行
- 令 argList 为 ? CreateListFromArrayLike(argArray)。
- 执行
PrepareForTailCall ()。 - 返回 ? Call(func, thisArg, argList)。
thisArg 值未经修改地作为
如果 func 是箭头函数或绑定函数奇异对象，那么在步骤
20.2.3.2 Function.prototype.bind ( thisArg, ...args )
该方法被调用时执行以下步骤：
- 令 Target 为
this 值。 - 如果
IsCallable (Target) 为false ，抛出TypeError 异常。 - 令 F 为 ?
BoundFunctionCreate (Target, thisArg, args)。 - 令 L 为 0。
- 令 targetHasLength 为 ?
HasOwnProperty (Target,"length" )。 - 如果 targetHasLength 为
true ，则- 令 targetLen 为 ?
Get (Target,"length" )。 - 如果 targetLen
是 Number ，则- 如果 targetLen 是
+∞ 𝔽，则- 设 L 为 +∞。
- 否则如果 targetLen 是
-∞ 𝔽，则- 设 L 为 0。
- 否则，
- 令 targetLenAsInt 为 !
ToIntegerOrInfinity (targetLen)。 - 断言：targetLenAsInt 为
有限 值。 - 令 argCount 为 args 中元素数量。
- 设 L 为
max (targetLenAsInt - argCount, 0)。
- 令 targetLenAsInt 为 !
- 如果 targetLen 是
- 令 targetLen 为 ?
- 执行
SetFunctionLength (F, L)。 - 令 targetName 为 ?
Get (Target,"name" )。 - 如果 targetName 不是 String，设 targetName 为空字符串。
- 执行
SetFunctionName (F, targetName,"bound" )。 - 返回 F。
使用 Function.prototype.bind 创建的
如果 Target 是箭头函数或绑定函数奇异对象，则后续对 F 的调用不会使用该方法传入的 thisArg。
20.2.3.3 Function.prototype.call ( thisArg, ...args )
该方法被调用时执行以下步骤：
- 令 func 为
this 值。 - 如果
IsCallable (func) 为false ，抛出TypeError 异常。 - 执行
PrepareForTailCall ()。 - 返回 ? Call(func, thisArg, args)。
thisArg 值未经修改地作为
如果 func 是箭头函数或绑定函数奇异对象，则在步骤
20.2.3.4 Function.prototype.constructor
Function.prototype.constructor 的初始值是
20.2.3.5 Function.prototype.toString ( )
该方法被调用时执行以下步骤：
- 令 func 为
this 值。 - 如果 func
是 Object ，且 func 有 [[SourceText]] 内部槽，func.[[SourceText]] 是 Unicode 码点序列，且HostHasSourceTextAvailable (func) 为true ，则- 返回 CodePointsToString(func.[[SourceText]])。
- 如果 func 是一个
内建函数对象 ，返回实现定义的 func 的字符串源码表示。该表示必须具有NativeFunction 的语法。此外，如果 func 有 [[InitialName]] 内部槽且其为 String，则返回字符串中可被NativeFunctionAccessor opt PropertyName 匹配的部分必须为 func.[[InitialName]]。 - 如果 func
是 Object 且IsCallable (func) 为true ，返回实现定义的、具有NativeFunction 语法的 func 字符串源码表示。 - 抛出
TypeError 异常。
20.2.3.6 Function.prototype [ %Symbol.hasInstance% ] ( V )
该方法被调用时执行以下步骤：
- 令 F 为
this 值。 - 返回 ?
OrdinaryHasInstance (F, V)。
该属性具有特性 { [[Writable]]:
该属性不可写且不可配置，以防篡改从而可全局暴露绑定函数的目标函数。
此方法的
20.2.4 Function 实例 (Function Instances)
每个 Function 实例都是一个 ECMAScript Function.prototype.bind 方法 (
Function 实例具有以下属性：
20.2.4.1 length
20.2.4.2 name
未被本规范赋予上下文名称的匿名
20.2.4.3 prototype
可作为
该属性具有特性 { [[Writable]]:
使用 Function.prototype.bind 创建的
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 对象 (Boolean Objects)
20.3.1 Boolean 构造函数 (The Boolean Constructor)
Boolean
- 是 %Boolean%。
- 是全局对象
"Boolean" 属性的初始值。 - 作为
构造函数 调用时创建并初始化一个新的 Boolean 对象。 - 作为函数调用而非
构造函数 调用时执行类型转换。 - 可用作类定义
extends子句的取值。打算继承指定 Boolean 行为的子类构造函数 必须包含对 Boolean构造函数 的super调用，以创建并初始化具有 [[BooleanData]] 内部槽的子类实例。
20.3.1.1 Boolean ( value )
该函数被调用时执行以下步骤：
- 令 b 为
ToBoolean (value)。 - 如果 NewTarget 是
undefined ，返回 b。 - 令 O 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%Boolean.prototype%" , « [[BooleanData]] »)。 - 设 O.[[BooleanData]] 为 b。
- 返回 O。
20.3.2 Boolean 构造函数的属性 (Properties of the Boolean Constructor)
Boolean
- 有 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
20.3.2.1 Boolean.prototype
Boolean.prototype 的初始值是
该属性具有特性 { [[Writable]]:
20.3.3 Boolean 原型对象的属性 (Properties of the Boolean Prototype Object)
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 ( )
该方法被调用时执行以下步骤：
- 令 b 为 ?
ThisBooleanValue (this value)。 - 如果 b 为
true ，返回"true" ；否则返回"false" 。
20.3.3.3 Boolean.prototype.valueOf ( )
该方法被调用时执行以下步骤：
- 返回 ?
ThisBooleanValue (this value)。
20.3.3.3.1 ThisBooleanValue ( value )
The abstract operation ThisBooleanValue takes argument value (an ECMAScript language value) and returns 一个包含 Boolean 的
- 如果 value 是 Boolean，返回 value。
- 如果 value
是 Object 且 value 有 [[BooleanData]] 内部槽，则- 令 b 为 value.[[BooleanData]]。
- 断言：b 是 Boolean。
- 返回 b。
- 抛出
TypeError 异常。
20.3.4 Boolean 实例的属性 (Properties of Boolean Instances)
Boolean 实例是继承自
20.4 Symbol 对象 (Symbol Objects)
20.4.1 Symbol 构造函数 (The Symbol Constructor)
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 构造函数的属性 (Properties of the Symbol Constructor)
Symbol
- 有 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
20.4.2.1 Symbol.asyncIterator
Symbol.asyncIterator 的初始值是著名符号
该属性具有特性 { [[Writable]]:
20.4.2.2 Symbol.for ( key )
该函数被调用时执行以下步骤：
- 令 stringKey 为 ?
ToString (key)。 - 对 GlobalSymbolRegistry 列表中每个元素 e，执行
- 如果 e.[[Key]] 是 stringKey，返回 e.[[Symbol]]。
- 断言：GlobalSymbolRegistry 列表当前不包含 stringKey 的条目。
- 令 newSymbol 为一个新 Symbol，其 [[Description]] 为 stringKey。
- 将记录 { [[Key]]: stringKey, [[Symbol]]: newSymbol } 追加到 GlobalSymbolRegistry 列表。
- 返回 newSymbol。
GlobalSymbolRegistry List 是一个可追加的全局可用列表，所有
20.4.2.3 Symbol.hasInstance
Symbol.hasInstance 的初始值是著名符号
该属性具有特性 { [[Writable]]:
20.4.2.4 Symbol.isConcatSpreadable
Symbol.isConcatSpreadable 的初始值是著名符号
该属性具有特性 { [[Writable]]:
20.4.2.5 Symbol.iterator
Symbol.iterator 的初始值是著名符号
该属性具有特性 { [[Writable]]:
20.4.2.6 Symbol.keyFor ( sym )
该函数被调用时执行以下步骤：
- 如果 sym 不是 Symbol，抛出
TypeError 异常。 - 返回
KeyForSymbol (sym)。
20.4.2.7 Symbol.match
Symbol.match 的初始值是著名符号
该属性具有特性 { [[Writable]]:
20.4.2.8 Symbol.matchAll
Symbol.matchAll 的初始值是著名符号
该属性具有特性 { [[Writable]]:
20.4.2.9 Symbol.prototype
Symbol.prototype 的初始值是
该属性具有特性 { [[Writable]]:
20.4.2.10 Symbol.replace
Symbol.replace 的初始值是著名符号
该属性具有特性 { [[Writable]]:
20.4.2.11 Symbol.search
Symbol.search 的初始值是著名符号
该属性具有特性 { [[Writable]]:
20.4.2.12 Symbol.species
Symbol.species 的初始值是著名符号
该属性具有特性 { [[Writable]]:
20.4.2.13 Symbol.split
Symbol.split 的初始值是著名符号
该属性具有特性 { [[Writable]]:
20.4.2.14 Symbol.toPrimitive
Symbol.toPrimitive 的初始值是著名符号
该属性具有特性 { [[Writable]]:
20.4.2.15 Symbol.toStringTag
Symbol.toStringTag 的初始值是著名符号
该属性具有特性 { [[Writable]]:
20.4.2.16 Symbol.unscopables
Symbol.unscopables 的初始值是著名符号
该属性具有特性 { [[Writable]]:
20.4.3 Symbol 原型对象的属性 (Properties of the Symbol Prototype Object)
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 是一个
- 令 s 为
this 值。 - 令 sym 为 ?
ThisSymbolValue (s)。 - 返回 sym.[[Description]]。
20.4.3.3 Symbol.prototype.toString ( )
该方法被调用时执行以下步骤：
- 令 sym 为 ?
ThisSymbolValue (this value)。 - 返回
SymbolDescriptiveString (sym)。
20.4.3.3.1 SymbolDescriptiveString ( sym )
The abstract operation SymbolDescriptiveString takes argument sym (a Symbol) and returns a String. It performs the following steps when called:
- 令 desc 为 sym.[[Description]]。
- 如果 desc 为
undefined ，设 desc 为空字符串。 - 断言：desc 是 String。
- 返回
"Symbol(" 、desc、")" 的串联。
20.4.3.4 Symbol.prototype.valueOf ( )
该方法被调用时执行以下步骤：
- 返回 ?
ThisSymbolValue (this value)。
20.4.3.4.1 ThisSymbolValue ( value )
The abstract operation ThisSymbolValue takes argument value (an ECMAScript language value) and returns 一个包含 Symbol 的
- 如果 value 是 Symbol，返回 value。
- 如果 value
是 Object 且 value 有 [[SymbolData]] 内部槽，则- 令 s 为 value.[[SymbolData]]。
- 断言：s 是 Symbol。
- 返回 s。
- 抛出
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 实例的属性 (Properties of Symbol Instances)
Symbol 实例是继承自
20.4.5 Symbol 的抽象操作 (Abstract Operations for Symbols)
20.4.5.1 KeyForSymbol ( sym )
The abstract operation KeyForSymbol takes argument sym (a Symbol) and returns a String or
- 对 GlobalSymbolRegistry 列表中每个元素 e，执行
- 如果
SameValue (e.[[Symbol]], sym) 为true ，返回 e.[[Key]]。
- 如果
- 断言：GlobalSymbolRegistry 列表当前不包含 sym 的条目。
- 返回
undefined 。
20.5 Error 对象 (Error Objects)
Error 对象的实例在运行时错误发生时作为异常被抛出。Error 对象也可作为用户自定义异常类的基类。
当 ECMAScript 实现检测到运行时错误时，它会抛出
20.5.1 Error 构造函数 (The Error Constructor)
Error
- 是 %Error%。
- 是全局对象
"Error" 属性的初始值。 - 作为函数而非
构造函数 调用时创建并初始化一个新的 Error 对象。因此函数调用Error(…)等价于使用相同参数的对象创建表达式new Error(…)。 - 可用作类定义
extends子句的取值。打算继承指定 Error 行为的子类构造函数 必须包含对 Error构造函数 的super调用，以创建并初始化具有 [[ErrorData]] 内部槽的子类实例。
20.5.1.1 Error ( message [ , options ] )
该函数被调用时执行以下步骤：
- 如果 NewTarget 是
undefined ，令 newTarget 为活动函数对象 ；否则令 newTarget 为 NewTarget。 - 令 O 为 ?
OrdinaryCreateFromConstructor (newTarget,"%Error.prototype%" , « [[ErrorData]] »)。 - 如果 message 不是
undefined ，则- 令 msg 为 ?
ToString (message)。 - 执行
CreateNonEnumerableDataPropertyOrThrow (O,"message" , msg)。
- 令 msg 为 ?
- 执行 ?
InstallErrorCause (O, options)。 - 返回 O。
20.5.2 Error 构造函数的属性 (Properties of the Error Constructor)
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 原型对象的属性 (Properties of the Error Prototype Object)
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 的初始值是空字符串。
20.5.3.3 Error.prototype.name
Error.prototype.name 的初始值是
20.5.3.4 Error.prototype.toString ( )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 如果 O
不是 Object ，抛出TypeError 异常。 - 令 name 为 ?
Get (O,"name" )。 - 如果 name 是
undefined ，设 name 为"Error" ；否则设 name 为 ?ToString (name)。 - 令 msg 为 ?
Get (O,"message" )。 - 如果 msg 是
undefined ，设 msg 为空字符串；否则设 msg 为 ?ToString (msg)。 - 如果 name 是空字符串，返回 msg。
- 如果 msg 是空字符串，返回 name。
- 返回 name、0x003A (COLON)、0x0020 (SPACE) 与 msg 的字符串拼接。
20.5.4 Error 实例的属性 (Properties of Error Instances)
Error 实例是继承自 Object.prototype.toString (Error.isError (
20.5.5 本标准使用的原生错误类型 (Native Error Types Used in This Standard)
检测到运行时错误时，会抛出以下 NativeError 对象之一或 AggregateError 对象的新实例。所有 NativeError 对象共享相同结构，如
20.5.5.1 EvalError
EvalError
该异常当前未在本规范中使用。此对象保留用于与先前版本规范的兼容性。
20.5.5.2 RangeError
RangeError
表示一个值不在允许值集合或范围之内。
20.5.5.3 ReferenceError
ReferenceError
表示检测到无效引用。
20.5.5.4 SyntaxError
SyntaxError
表示发生了一个解析错误。
20.5.5.5 TypeError
TypeError
TypeError 用于指示一次操作失败，且其他 NativeError 对象都不适合作为失败原因的指示。
20.5.5.6 URIError
URIError
表示一个全局 URI 处理函数被以与其定义不兼容的方式使用。
20.5.6 NativeError 对象结构 (NativeError Object Structure)
这些对象各自具有下面描述的结构，唯一区别在于使用的
对于每个错误对象，定义中对 NativeError 的引用应替换为
20.5.6.1 NativeError 构造函数 (The NativeError Constructors)
每个 NativeError
- 作为函数而非
构造函数 调用时创建并初始化一个新的 NativeError 对象。以函数形式调用等价于以相同参数作为构造函数 调用。因此函数调用NativeError(…)等价于对象创建表达式new NativeError(…)。 - 可用作类定义
extends子句的取值。子类构造函数 若打算继承指定 NativeError 行为，必须包含对 NativeError构造函数 的super调用，以创建并初始化具有 [[ErrorData]] 内部槽的子类实例。
20.5.6.1.1 NativeError ( message [ , options ] )
每个 NativeError 函数被调用时执行以下步骤：
- 如果 NewTarget 是
undefined ，令 newTarget 为活动函数对象 ；否则令 newTarget 为 NewTarget。 - 令 O 为 ?
OrdinaryCreateFromConstructor (newTarget,"%NativeError.prototype%", « [[ErrorData]] »)。 - 如果 message 不是
undefined ，则- 令 msg 为 ?
ToString (message)。 - 执行
CreateNonEnumerableDataPropertyOrThrow (O,"message" , msg)。
- 令 msg 为 ?
- 执行 ?
InstallErrorCause (O, options)。 - 返回 O。
在步骤
20.5.6.2 NativeError 构造函数的属性 (Properties of the NativeError Constructors)
每个 NativeError
- 有 [[Prototype]] 内部槽，其值为
%Error% 。 - 有
"name" 属性，其值为 String 值"NativeError" 。 - 具有以下属性：
20.5.6.2.1 NativeError.prototype
NativeError.prototype 的初始值是一个 NativeError 原型对象 (
该属性具有特性 { [[Writable]]:
20.5.6.3 NativeError 原型对象的属性 (Properties of the NativeError Prototype Objects)
每个 NativeError 原型对象：
- 是一个
普通对象 。 - 不是 Error 实例且没有 [[ErrorData]] 内部槽。
- 具有 [[Prototype]] 内部槽，其值为
%Error.prototype% 。
20.5.6.3.1 NativeError.prototype.constructor
20.5.6.3.2 NativeError.prototype.message
给定 NativeError
20.5.6.3.3 NativeError.prototype.name
给定 NativeError
20.5.6.4 NativeError 实例的属性 (Properties of NativeError Instances)
NativeError 实例是继承自其 NativeError 原型对象的Object.prototype.toString (Error.isError (
20.5.7 AggregateError 对象 (AggregateError Objects)
20.5.7.1 AggregateError 构造函数 (The AggregateError Constructor)
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。 - 令 O 为 ?
OrdinaryCreateFromConstructor (newTarget,"%AggregateError.prototype%" , « [[ErrorData]] »)。 - 如果 message 不为
undefined ，则- 令 msg 为 ?
ToString (message)。 - 执行
CreateNonEnumerableDataPropertyOrThrow (O,"message" , msg)。
- 令 msg 为 ?
- 执行 ?
InstallErrorCause (O, options)。 - 令 errorsList 为 ?
IteratorToList (?GetIterator (errors,sync ))。 - 执行 !
DefinePropertyOrThrow (O,"errors" , PropertyDescriptor { [[Configurable]]:true , [[Enumerable]]:false , [[Writable]]:true , [[Value]]:CreateArrayFromList (errorsList) })。 - 返回 O。
20.5.7.2 AggregateError 构造函数的属性 (Properties of the AggregateError Constructor)
AggregateError
- 具有 [[Prototype]] 内部槽，其值为
%Error% 。 - 具有以下属性：
20.5.7.2.1 AggregateError.prototype
AggregateError.prototype 的初始值是
该属性具有特性 { [[Writable]]:
20.5.7.3 AggregateError 原型对象的属性 (Properties of the AggregateError Prototype Object)
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 的初始值是空字符串。
20.5.7.3.3 AggregateError.prototype.name
AggregateError.prototype.name 的初始值是
20.5.7.4 AggregateError 实例的属性 (Properties of AggregateError Instances)
AggregateError 实例是继承自其 Object.prototype.toString (Error.isError (
20.5.8 Error 对象的抽象操作 (Abstract Operations for Error Objects)
20.5.8.1 InstallErrorCause ( O, options )
The abstract operation InstallErrorCause takes arguments O (an Object) and options (an ECMAScript language value) and returns 一个包含
- 如果 options
是 Object 且 ?HasProperty (options,"cause" ) 为true ，则- 令 cause 为 ?
Get (options,"cause" )。 - 执行
CreateNonEnumerableDataPropertyOrThrow (O,"cause" , cause)。
- 令 cause 为 ?
- 返回
unused 。
21 数字与日期 (Numbers and Dates)
21.1 Number 对象 (Number Objects)
21.1.1 Number 构造函数 (The Number Constructor)
Number
- 是 %Number%。
- 是全局对象
"Number" 属性的初始值。 - 作为
构造函数 调用时创建并初始化一个新的 Number 对象。 - 作为函数而非
构造函数 调用时执行一次类型转换。 - 可用作类定义的
extends子句取值。想要继承指定 Number 行为的子类构造函数 必须包含对 Number构造函数 的super调用，以创建并初始化带有 [[NumberData]] 内部槽的子类实例。
21.1.1.1 Number ( value )
该函数被调用时执行以下步骤：
- 如果提供了 value，则
- 否则，
- 令 n 为
+0 𝔽。
- 令 n 为
- 如果 NewTarget 是
undefined ，返回 n。 - 令 O 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%Number.prototype%" , « [[NumberData]] »)。 - 设 O.[[NumberData]] 为 n。
- 返回 O。
21.1.2 Number 构造函数的属性 (Properties of the Number Constructor)
Number
- 有 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
21.1.2.1 Number.EPSILON
Number.EPSILON 的值
该属性具有特性 { [[Writable]]:
21.1.2.2 Number.isFinite ( number )
该函数被调用时执行以下步骤：
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 )
整数 n 是“安全整数 (safe integer)”当且仅当 n 的 Number 值不与任何其他整数的 Number 值相同。
该函数被调用时执行以下步骤：
21.1.2.6 Number.MAX_SAFE_INTEGER
由于 Number.MAX_SAFE_INTEGER 的整数的 Number 值至少与另一个整数共享。此类大幅度整数因此不是 9007199254740992 与 9007199254740993 都求值为 Number 值
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 的整数的 Number 值至少与另一个整数共享。此类大幅度整数因此不是 -9007199254740992 与 -9007199254740993 都求值为 Number 值
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 原型对象的属性 (Properties of the Number Prototype Object)
Number 原型对象：
- 是 %Number.prototype%。
- 是一个
普通对象 。 - 其自身是一个 Number 对象；具有值为
+0 𝔽 的 [[NumberData]] 内部槽。 - 具有 [[Prototype]] 内部槽，其值为
%Object.prototype% 。
除非明确另行说明，下面定义的 Number 原型对象的方法不是通用的；传递给它们的
在某个方法的规范中，“this Number 值”指调用
21.1.3.1 Number.prototype.constructor
Number.prototype.constructor 的初始值是
21.1.3.2 Number.prototype.toExponential ( fractionDigits )
该方法返回一个 String，内容为此 Number 值按十进制指数表示法表示，尾数小数点前一位，且小数点后有 fractionDigits 位。如果 fractionDigits 为
被调用时执行以下步骤：
- 令 x 为 ?
ThisNumberValue (this value)。 - 令 f 为 ?
ToIntegerOrInfinity (fractionDigits)。 - 断言：若 fractionDigits 为
undefined ，则 f 为 0。 - 如果 x 不是
有限 值，返回Number::toString (x, 10)。 - 如果 f < 0 或 f > 100，抛出
RangeError 异常。 - 设 x 为
ℝ (x)。 - 令 s 为空字符串。
- 若 x < 0，则
- 设 s 为
"-" 。 - 设 x 为 -x。
- 设 s 为
- 若 x = 0，则
- 令 m 为包含 f + 1 个代码单元 0x0030 (DIGIT ZERO) 的 String。
- 令 e 为 0。
- 否则，
- 若 fractionDigits 不为
undefined ，则- 令 e 与 n 为整数，满足 10f ≤ n < 10f + 1 且 n × 10e - f - x 尽可能接近 0。若存在两个满足条件的 (e, n)，选择使 n × 10e - f 较大的那一组。
- 否则，
- 令 m 为 n 十进制表示的数字（按顺序，无前导零）组成的 String。
- 若 fractionDigits 不为
- 若 f ≠ 0，则
- 令 a 为 m 的第一个代码单元。
- 令 b 为 m 的其余 f 个代码单元。
- 设 m 为 a、
"." 、b 的串联。
- 若 e = 0，则
- 令 c 为
"+" 。 - 令 d 为
"0" 。
- 令 c 为
- 否则，
- 若 e > 0，则
- 令 c 为
"+" 。
- 令 c 为
- 否则，
- 断言：e < 0。
- 令 c 为
"-" 。 - 设 e 为 -e。
- 令 d 为 e 十进制表示数字（按顺序，无前导零）组成的 String。
- 若 e > 0，则
- 设 m 为 m、
"e" 、c、d 的串联。 - 返回 s 与 m 的串联。
21.1.3.3 Number.prototype.toFixed ( fractionDigits )
该方法返回一个 String，内容为此 Number 值按十进制定点表示法表示，在小数点后有 fractionDigits 位。如果 fractionDigits 为
被调用时执行以下步骤：
- 令 x 为 ?
ThisNumberValue (this value)。 - 令 f 为 ?
ToIntegerOrInfinity (fractionDigits)。 - 断言：若 fractionDigits 为
undefined ，则 f 为 0。 - 如果 f 不是
有限 值，抛出RangeError 异常。 - 如果 f < 0 或 f > 100，抛出
RangeError 异常。 - 如果 x 不是
有限 值，返回Number::toString (x, 10)。 - 设 x 为
ℝ (x)。 - 令 s 为空字符串。
- 若 x < 0，则
- 设 s 为
"-" 。 - 设 x 为 -x。
- 设 s 为
- 若 x ≥ 1021，则
- 否则，
- 令 n 为整数，使得 n / 10f - x 尽可能接近 0。若有两个这样的 n，取较大的。
- 若 n = 0，令 m 为
"0" ；否则令 m 为 n 十进制表示数字（按顺序，无前导零）组成的 String。 - 若 f ≠ 0，则
- 令 k 为 m 的长度。
- 若 k ≤ f，则
- 令 z 为包含 f + 1 - k 个代码单元 0x0030 (DIGIT ZERO) 的 String。
- 设 m 为 z 与 m 的串联。
- 设 k 为 f + 1。
- 令 a 为 m 的前 k - f 个代码单元。
- 令 b 为 m 其余 f 个代码单元。
- 设 m 为 a、
"." 、b 的串联。
- 返回 s 与 m 的串联。
toFixed 的输出在某些值上可能比 toString 更精确，因为 toString 只打印区分该数字与相邻 Number 值所需的有效数字。例如：
(1000000000000000128).toString() 返回
(1000000000000000128).toFixed(0) 返回
21.1.3.4 Number.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
包含 ECMA-402 国际化 API 的 ECMAScript 实现必须按 ECMA-402 规范实现此方法。若实现不包含 ECMA-402 API，则使用下列规范：
此方法生成一个 String，表示此 Number 值，按toString 相同的结果。
此方法可选参数的意义在 ECMA-402 规范中定义；不包含 ECMA-402 支持的实现不得将这些参数位置用于其他目的。
21.1.3.5 Number.prototype.toPrecision ( precision )
该方法返回一个 String，内容为此 Number 值：要么使用十进制指数表示法（尾数小数点前 1 位，后面有
被调用时执行以下步骤：
- 令 x 为 ?
ThisNumberValue (this value)。 - 如果 precision 为
undefined ，返回 !ToString (x)。 - 令 p 为 ?
ToIntegerOrInfinity (precision)。 - 如果 x 不是
有限 值，返回Number::toString (x, 10)。 - 如果 p < 1 或 p > 100，抛出
RangeError 异常。 - 设 x 为
ℝ (x)。 - 令 s 为空字符串。
- 若 x < 0，则
- 设 s 为代码单元 0x002D (HYPHEN-MINUS)。
- 设 x 为 -x。
- 若 x = 0，则
- 令 m 为包含 p 个代码单元 0x0030 (DIGIT ZERO) 的 String。
- 令 e 为 0。
- 否则，
- 令 e 与 n 为整数，满足 10p - 1 ≤ n < 10p 且 n × 10e - p + 1 - x 尽可能接近 0。若存在两个满足条件的 (e, n)，选择使 n × 10e - p + 1 较大的那一组。
- 令 m 为 n 十进制表示数字（按顺序，无前导零）组成的 String。
- 若 e < -6 或 e ≥ p，则
- 断言：e ≠ 0。
- 若 p ≠ 1，则
- 令 a 为 m 的第一个代码单元。
- 令 b 为 m 的其余 p - 1 个代码单元。
- 设 m 为 a、
"." 、b 的串联。
- 若 e > 0，则
- 令 c 为代码单元 0x002B (PLUS SIGN)。
- 否则，
- 断言：e < 0。
- 令 c 为代码单元 0x002D (HYPHEN-MINUS)。
- 设 e 为 -e。
- 令 d 为 e 十进制表示数字（按顺序，无前导零）组成的 String。
- 返回 s、m、代码单元 0x0065 (LATIN SMALL LETTER E)、c、d 的串联。
- 若 e = p - 1，返回 s 与 m 的串联。
- 若 e ≥ 0，则
- 设 m 为：m 的前 e + 1 个代码单元、代码单元 0x002E (FULL STOP)、以及剩余 p - (e + 1) 个代码单元的串联。
- 否则，
- 设 m 为：代码单元 0x0030 (DIGIT ZERO)、代码单元 0x002E (FULL STOP)、-(e + 1) 个代码单元 0x0030 (DIGIT ZERO)、以及字符串 m 的串联。
- 返回 s 与 m 的串联。
21.1.3.6 Number.prototype.toString ( [ radix ] )
可选的 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 ( value )
The abstract operation ThisNumberValue takes argument value (an ECMAScript language value) and returns 一个包含 Number 的
21.1.4 Number 实例的属性 (Properties of Number Instances)
Number 实例是继承自
21.2 BigInt 对象 (BigInt Objects)
21.2.1 BigInt 构造函数 (The BigInt Constructor)
BigInt
- 是 %BigInt%。
- 是全局对象
"BigInt" 属性的初始值。 - 作为函数而非
构造函数 调用时执行类型转换。 - 不打算与
new运算符一起使用，也不打算被子类化。它可用作类定义extends子句的取值，但对 BigInt构造函数 的super调用将导致异常。
21.2.1.1 BigInt ( value )
该函数被调用时执行以下步骤：
- 如果 NewTarget 不为
undefined ，抛出TypeError 异常。 - 令 prim 为 ? ToPrimitive(value,
number )。 - 如果 prim
是 Number ，返回 ?NumberToBigInt (prim)。 - 否则，返回 ?
ToBigInt (prim)。
21.2.1.1.1 NumberToBigInt ( number )
The abstract operation NumberToBigInt takes argument number (a Number) and returns 要么是包含一个 BigInt 的
21.2.2 BigInt 构造函数的属性 (Properties of the BigInt Constructor)
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 原型对象的属性 (Properties of the BigInt Prototype Object)
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 ] ] )
包含 ECMA-402 国际化 API 的 ECMAScript 实现必须按 ECMA-402 规范实现此方法。如果实现不包含 ECMA-402 API，则使用以下规范：
该方法生成一个表示此 toString 相同的结果。
此方法可选参数的意义由 ECMA-402 规范定义；不包含 ECMA-402 支持的实现不得将这些参数位置用于其他用途。
21.2.3.3 BigInt.prototype.toString ( [ radix ] )
可选的 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 ( value )
The abstract operation ThisBigIntValue takes argument value (an ECMAScript language value) and returns 要么是包含一个 BigInt 的
21.2.3.5 BigInt.prototype [ %Symbol.toStringTag% ]
该属性具有特性 { [[Writable]]:
21.2.4 BigInt 实例的属性 (Properties of BigInt Instances)
BigInt 实例是继承自
21.3 Math 对象 (The Math Object)
Math 对象：
- 是 %Math%。
- 是全局对象
"Math" 属性的初始值。 - 是一个
普通对象 。 - 有 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 不是
函数对象 。 - 没有 [[Construct]] 内部方法；不能与
new一起作为构造函数 使用。 - 没有 [[Call]] 内部方法；不能作为函数调用。
在本规范中，短语 “the Number value for x” 有在
21.3.1 Math 对象的值属性 (Value Properties of the Math Object)
21.3.1.1 Math.E
自然对数的底 e 的 Number 值，约为 2.7182818284590452354。
该属性具有特性 { [[Writable]]:
21.3.1.2 Math.LN10
10 的自然对数的 Number 值，约为 2.302585092994046。
该属性具有特性 { [[Writable]]:
21.3.1.3 Math.LN2
2 的自然对数的 Number 值，约为 0.6931471805599453。
该属性具有特性 { [[Writable]]:
21.3.1.4 Math.LOG10E
e 的常用对数（以 10 为底）的 Number 值，约为 0.4342944819032518。
该属性具有特性 { [[Writable]]:
Math.LOG10E 的值约等于 Math.LN10 值的倒数。
21.3.1.5 Math.LOG2E
e 的以 2 为底的对数的 Number 值，约为 1.4426950408889634。
该属性具有特性 { [[Writable]]:
Math.LOG2E 的值约等于 Math.LN2 值的倒数。
21.3.1.6 Math.PI
圆周率 π 的 Number 值，即圆的周长与直径之比，约为 3.1415926535897932。
该属性具有特性 { [[Writable]]:
21.3.1.7 Math.SQRT1_2
1/2 的平方根的 Number 值，约为 0.7071067811865476。
该属性具有特性 { [[Writable]]:
Math.SQRT1_2 的值约等于 Math.SQRT2 值的倒数。
21.3.1.8 Math.SQRT2
2 的平方根的 Number 值，约为 1.4142135623730951。
该属性具有特性 { [[Writable]]:
21.3.1.9 Math [ %Symbol.toStringTag% ]
该属性具有特性 { [[Writable]]:
21.3.2 Math 对象的函数属性 (Function Properties of the Math Object)
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 程序员可用的同一数学库。
虽然算法选择留给实现，但（非标准要求地）推荐实现使用 Sun Microsystems 的可自由发布数学库 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 𝔽。 - 令 r 为
abs (ℝ (ny) /ℝ (nx)) 的反正切。 - 如果 nx <
-0 𝔽，则- 如果 ny >
+0 𝔽，设 r = π - r。 - 否则，设 r = -π + r。
- 如果 ny >
- 否则，
- 如果 ny <
-0 𝔽，设 r = -r。
- 如果 ny <
- 返回一个
实现近似 的 Number，表示 r。
21.3.2.9 Math.cbrt ( x )
返回 x 的立方根。
被调用时执行以下步骤：
21.3.2.10 Math.ceil ( x )
返回不小于 x 的最小（最接近 -∞）整数 Number 值。若 x 已是整数 Number，则结果为 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 )
返回指数函数 ex（e 为自然对数的底）。
被调用时执行以下步骤：
21.3.2.15 Math.expm1 ( x )
返回指数函数 ex 减 1 的结果（e 为自然对数的底）。即使 x 接近 0 也应保持精确。
被调用时执行以下步骤：
21.3.2.16 Math.floor ( x )
返回不大于 x 的最大（最接近 +∞）整数 Number 值。若 x 已是整数 Number，则结果为 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 为将 n 按 roundTiesToEven 模式转换为
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 为将 n 按 roundTiesToEven 模式转换为
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 为一个新的空列表。
- 对 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 𝔽。 - 返回一个
实现近似 的 Number，表示 coerced 各元素数学值 平方和的平方根。
此函数的
实现应注意避免在具有两个或更多参数时出现朴素实现易触发的溢出与下溢导致的精度丢失。
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 接近 0 也要求精确。
被调用时执行以下步骤：
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 )
给定零个或多个参数，对每个参数执行
被调用时执行以下步骤：
- 令 coerced 为一个新的空列表。
- 对 args 中每个元素 arg，执行
- 令 n 为 ?
ToNumber (arg)。 - 追加 n 到 coerced。
- 令 n 为 ?
- 令 highest 为
-∞ 𝔽。 - 对 coerced 中每个元素 number，执行
- 如果 number 是
NaN ，返回NaN 。 - 如果 number 是
+0 𝔽 且 highest 是-0 𝔽，设 highest 为+0 𝔽。 - 如果 number > highest，设 highest 为 number。
- 如果 number 是
- 返回 highest。
确定最大值的比较使用
此函数的
21.3.2.26 Math.min ( ...args )
给定零个或多个参数，对每个参数执行
被调用时执行以下步骤：
- 令 coerced 为一个新的空列表。
- 对 args 中每个元素 arg，执行
- 令 n 为 ?
ToNumber (arg)。 - 追加 n 到 coerced。
- 令 n 为 ?
- 令 lowest 为
+∞ 𝔽。 - 对 coerced 中每个元素 number，执行
- 如果 number 是
NaN ，返回NaN 。 - 如果 number 是
-0 𝔽 且 lowest 是+0 𝔽，设 lowest 为-0 𝔽。 - 如果 number < lowest，设 lowest 为 number。
- 如果 number 是
- 返回 lowest。
确定最大值的比较使用
此函数的
21.3.2.27 Math.pow ( base, exponent )
该函数被调用时执行以下步骤：
- 将 base 设为 ?
ToNumber (base)。 - 将 exponent 设为 ?
ToNumber (exponent)。 - 返回
Number::exponentiate (base, exponent)。
21.3.2.28 Math.random ( )
返回一个具有正号的 Number，值 ≥
21.3.2.29 Math.round ( x )
返回最接近 x 的整数 Number 值；若有两个整数同样接近 x，结果为更靠近 +∞ 的那个。若 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 时的内部舍入也可能使结果不同。
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 )
给定一个由 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 的时间度量类似，特别是在使用前推的公历、以 1970 年 1 月 1 日 UTC 零点为 纪元，以及每一天精确包含 86,400 秒（每秒为 1000 毫秒）的定义上。
ECMAScript 的 时间值 是一个 Number，要么是表示某一时刻的
时间值不考虑 UTC 闰秒——没有表示正闰秒内时刻的时间值，也有表示因负闰秒从 UTC 时间线移除的时刻的时间值。但时间值的定义仍然与 UTC 分段对齐，只有在闰秒边界处有不连续，非闰秒时为零差异。
Number 能精确表示从 -9,007,199,254,740,992 到 9,007,199,254,740,992 的所有整数（见
1970 年 1 月 1 日 UTC 零点的精确时刻由时间值
在前推的公历中，闰年是能被 4 整除且（能被 400 整除或不能被 100 整除）的年份。
前推的公历 400 年周期包含 97 个闰年，平均每年为 365.2425 天，即 31,556,952,000 毫秒。因此用毫秒精度 Number 可精确表示的最大范围约为距 1970 年前后 -285,426 到 285,426 年。按本节时间值的更小支持范围约为距 1970 年前后 -273,790 到 273,790 年。
21.4.1.2 时间相关常量
这些常量会被后续章节中的算法引用。
21.4.1.3 Day ( t )
The abstract operation Day takes argument t (
21.4.1.4 TimeWithinDay ( t )
The abstract operation TimeWithinDay takes argument t (
21.4.1.5 DaysInYear ( y )
The abstract operation DaysInYear takes argument y (整数 Number) and returns
- 令 ry 为
ℝ (y)。 - 若 (ry 模 400) = 0，返回
366 𝔽。 - 若 (ry 模 100) = 0，返回
365 𝔽。 - 若 (ry 模 4) = 0，返回
366 𝔽。 - 返回
365 𝔽。
21.4.1.6 DayFromYear ( y )
The abstract operation DayFromYear takes argument y (整数 Number) and returns 整数 Number. It performs the following steps when called:
- 令 ry 为
ℝ (y)。 - 注：下列步骤中，numYears1、numYears4、numYears100、numYears400 表示自
纪元 至 y 年首之间能被 1、4、100、400 整除的年份数。若 y 在纪元 之前则为负数。 - 令 numYears1 为 (ry - 1970)。
- 令 numYears4 为
floor ((ry - 1969) / 4)。 - 令 numYears100 为
floor ((ry - 1901) / 100)。 - 令 numYears400 为
floor ((ry - 1601) / 400)。 - 返回
𝔽 (365 × numYears1 + numYears4 - numYears100 + numYears400)。
21.4.1.7 TimeFromYear ( y )
The abstract operation TimeFromYear takes argument y (整数 Number) and returns
- 返回
msPerDay ×DayFromYear (y)。
21.4.1.8 YearFromTime ( t )
The abstract operation YearFromTime takes argument t (
- 返回满足
TimeFromYear (y) ≤ t 的最大整数 Number y（最接近 +∞）。
21.4.1.9 DayWithinYear ( t )
The abstract operation DayWithinYear takes argument t (
- 返回
Day (t) -DayFromYear (YearFromTime (t))。
21.4.1.10 InLeapYear ( t )
The abstract operation InLeapYear takes argument t (
- 若
DaysInYear (YearFromTime (t)) 为366 𝔽，则返回1 𝔽；否则返回+0 𝔽。
21.4.1.11 MonthFromTime ( t )
The abstract operation MonthFromTime takes argument t (
- 令 inLeapYear 为
InLeapYear (t)。 - 令 dayWithinYear 为
DayWithinYear (t)。 - 若 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 ( t )
The abstract operation DateFromTime takes argument t (
- 令 inLeapYear 为
InLeapYear (t)。 - 令 dayWithinYear 为
DayWithinYear (t)。 - 令 month 为
MonthFromTime (t)。 - 若 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 ( t )
The abstract operation WeekDay takes argument t (
21.4.1.14 HourFromTime ( t )
The abstract operation HourFromTime takes argument t (
- 返回
𝔽 (floor (ℝ (t /msPerHour )) 模HoursPerDay )。
21.4.1.15 MinFromTime ( t )
The abstract operation MinFromTime takes argument t (
- 返回
𝔽 (floor (ℝ (t /msPerMinute )) 模MinutesPerHour )。
21.4.1.16 SecFromTime ( t )
The abstract operation SecFromTime takes argument t (
- 返回
𝔽 (floor (ℝ (t /msPerSecond )) 模SecondsPerMinute )。
21.4.1.17 msFromTime ( t )
The abstract operation msFromTime takes argument t (
- 返回
𝔽 (ℝ (t) 模ℝ (msPerSecond ))。
21.4.1.18 GetUTCEpochNanoseconds ( year, month, day, hour, minute, second, millisecond, microsecond, nanosecond )
The abstract operation GetUTCEpochNanoseconds takes arguments year (整数), month (
21.4.1.19 时区标识符
ECMAScript 中的时区由 时区标识符 表示，是完全由码元在 0x0000 到 0x007F
主时区标识符是可用命名时区的首选标识符。 非主时区标识符是可用命名时区的非主标识符。 可用命名时区标识符是主时区标识符或非主时区标识符中的一种。 每个可用命名时区标识符只关联一个可用命名时区。 每个可用命名时区只关联一个主时区标识符和零个或多个非主时区标识符。
ECMAScript 实现必须支持标识符为
遵循 ECMA-402 国际化 API 规范描述的时区要求的实现称为 具备时区感知。
具备时区感知的实现必须支持与 IANA 时区数据库的 Zone 和 Link 名称相对应的可用命名时区，并且仅支持这些名称。
在具备时区感知的实现中，主时区标识符是 Zone 名称，非主时区标识符是 Link 名称（除非被 ECMA-402 规范中的
21.4.1.20 GetNamedTimeZoneEpochNanoseconds ( timeZoneIdentifier, year, month, day, hour, minute, second, millisecond, microsecond, nanosecond )
The implementation-defined abstract operation GetNamedTimeZoneEpochNanoseconds takes arguments timeZoneIdentifier (字符串), year (整数), month (
当输入表示由于负时区变更（如夏令时结束或时区规则调整导致偏移减少）而某本地时间出现多次时，返回的列表会有多个元素，并按数值升序排序。 当输入表示由于正时区变更（如夏令时开始或时区规则调整导致偏移增加）而某本地时间被跳过时，返回的列表为空。 否则返回的列表只有一个元素。
未包含任何时区本地规则的 ECMAScript 实现的默认实现步骤如下：
- 断言：timeZoneIdentifier 为
"UTC" 。 - 令 epochNanoseconds 为
GetUTCEpochNanoseconds (year, month, day, hour, minute, second, millisecond, microsecond, nanosecond)。 - 返回 « epochNanoseconds »。
时区感知实现（也推荐所有实现）需使用 IANA 时区数据库 https://www.iana.org/time-zones/ 的时区信息。
2017 年 11 月 5 日 1:30 AM 在 America/New_York 出现两次，因此 GetNamedTimeZoneEpochNanoseconds(
2017 年 3 月 12 日 2:30 AM 在 America/New_York 不存在，因此 GetNamedTimeZoneEpochNanoseconds(
21.4.1.21 GetNamedTimeZoneOffsetNanoseconds ( timeZoneIdentifier, epochNanoseconds )
The implementation-defined abstract operation GetNamedTimeZoneOffsetNanoseconds takes arguments timeZoneIdentifier (字符串) and epochNanoseconds (BigInt) and returns 整数.
返回的整数表示由 timeZoneIdentifier 标识的命名时区，在与 epochNanoseconds 相对应的时刻相对
未包含任何时区本地规则的 ECMAScript 实现的默认实现步骤如下：
- 断言：timeZoneIdentifier 为
"UTC" 。 - 返回 0。
时区偏移值可能为正或负。
21.4.1.22 时区标识符记录
时区标识符记录是用于描述
时区标识符记录具有
若 [[Identifier]] 是
21.4.1.23 AvailableNamedTimeZoneIdentifiers ( )
The implementation-defined abstract operation AvailableNamedTimeZoneIdentifiers takes no arguments and returns
21.4.1.24 SystemTimeZoneIdentifier ( )
The implementation-defined abstract operation SystemTimeZoneIdentifier takes no arguments and returns 字符串. It performs the following steps when called:
为确保实现常见 Date 对象方法的功能，建议 SystemTimeZoneIdentifier 返回
例如，若
21.4.1.25 LocalTime ( t )
The abstract operation LocalTime takes argument t (
- 令 systemTimeZoneIdentifier 为
SystemTimeZoneIdentifier ()。 - 如果
IsTimeZoneOffsetString (systemTimeZoneIdentifier) 为true ，- 令 offsetNs 为
ParseTimeZoneOffsetString (systemTimeZoneIdentifier)。
- 令 offsetNs 为
- 否则，
- 令 offsetNs 为
GetNamedTimeZoneOffsetNanoseconds (systemTimeZoneIdentifier,ℤ (ℝ (t) × 106))。
- 令 offsetNs 为
- 令 offsetMs 为
truncate (offsetNs / 106)。 - 返回 t +
𝔽 (offsetMs)。
若实现无法获得本地时间 t 的政治规则，则结果为 t，因为
时区感知实现（也推荐所有实现）需使用 IANA 时区数据库 https://www.iana.org/time-zones/ 的时区信息。
21.4.1.26 UTC ( t )
The abstract operation UTC takes argument t (Number) and returns
- 若 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 表示在正时区变更时被跳过的本地时间（如夏令时开始或时区调整增大）。
- 令 possibleInstantsBefore 为
GetNamedTimeZoneEpochNanoseconds (systemTimeZoneIdentifier,ℝ (YearFromTime (tBefore)),ℝ (MonthFromTime (tBefore)) + 1,ℝ (DateFromTime (tBefore)),ℝ (HourFromTime (tBefore)),ℝ (MinFromTime (tBefore)),ℝ (SecFromTime (tBefore)),ℝ (msFromTime (tBefore)), 0, 0)，其中 tBefore 为小于 t 的最大整数 Number，且 possibleInstantsBefore 非空（即 tBefore 为变更前的最后本地时间）。 - 令 disambiguatedInstant 为 possibleInstantsBefore 的最后一项。
- 令 offsetNs 为
GetNamedTimeZoneOffsetNanoseconds (systemTimeZoneIdentifier, disambiguatedInstant)。
- 令 possibleInstants 为
- 令 offsetMs 为
truncate (offsetNs / 106)。 - 返回 t -
𝔽 (offsetMs)。
输入 t 名义上为
若实现无法获得本地时间 t 的政治规则，则结果为 t，因为
时区感知实现（也推荐所有实现）需使用 IANA 时区数据库 https://www.iana.org/time-zones/ 的时区信息。
2017 年 11 月 5 日 1:30 AM 在 America/New_York 出现两次（回拨），但应按 UTC-04 而不是 UTC-05 解释。
在 UTC(
2017 年 3 月 12 日 2:30 AM 在 America/New_York 不存在，但应按 UTC-05（等价于 UTC-04 的 3:30 AM）解释。
在 UTC(
21.4.1.27 MakeTime ( hour, min, sec, ms )
The abstract operation MakeTime takes arguments hour (Number), min (Number), sec (Number), and ms (Number) and returns 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 (Number), month (Number), and date (Number) and returns Number. It performs the following steps when called:
- 若 year、month、date 任一非
有限 ，返回NaN 。 - 令 y 为
𝔽 (!ToIntegerOrInfinity (year))。 - 令 m 为
𝔽 (!ToIntegerOrInfinity (month))。 - 令 dt 为
𝔽 (!ToIntegerOrInfinity (date))。 - 令 ym 为 y +
𝔽 (floor (ℝ (m) / 12))。 - 若 ym 非
有限 ，返回NaN 。 - 令 mn 为
𝔽 (ℝ (m) 模 12)。 - 找到
YearFromTime (t) 为 ym、MonthFromTime (t) 为 mn、DateFromTime (t) 为1 𝔽 的有限 时间值 t；若不可行（如参数越界），返回NaN 。 - 返回
Day (t) + dt -1 𝔽。
21.4.1.29 MakeDate ( day, time )
The abstract operation MakeDate takes arguments day (Number) and time (Number) and returns Number. It performs the following steps when called:
21.4.1.30 MakeFullYear ( year )
The abstract operation MakeFullYear takes argument year (Number) and returns 整数 Number 或
- 若 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 (Number) and returns Number. 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（1月）到 12（12月）。 |
DD
|
日期，两位十进制数字，01 到 31。 |
T
|
|
HH
|
自零点起经过的完整小时数，两位十进制数字，00 到 24。 |
:
|
|
mm
|
小时开始起经过的完整分钟数，两位十进制数字，00 到 59。 |
ss
|
分钟开始起经过的完整秒数，两位十进制数字，00 到 59。 |
.
|
|
sss
|
秒开始起经过的完整毫秒数，三位十进制数字。 |
Z
|
UTC 偏移表示，HH:mm（用于表示本地时间领先或落后 UTC，属于 |
该格式还包括仅日期形式：
YYYY
YYYY-MM
YYYY-MM-DD
也包括“日期-时间”形式，即上述日期形式紧接以下时间形式之一并可选加偏移：
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 扩展年份
Date.parse
扩展年份示例：
| -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 定义了用于 UTC 偏移的字符串交换格式，源自 ISO 8601。 格式描述如下语法。
语法
21.4.1.33.1 IsTimeZoneOffsetString ( offsetString )
The abstract operation IsTimeZoneOffsetString takes argument offsetString (字符串) and returns 布尔值. It performs the following steps when called:
- 令 parseResult 为 ParseText(offsetString,
UTCOffset )。 - 若 parseResult 为错误列表，返回
false 。 - 返回
true 。
21.4.1.33.2 ParseTimeZoneOffsetString ( offsetString )
The abstract operation ParseTimeZoneOffsetString takes argument offsetString (字符串) and returns 整数. It performs the following steps when called:
- 令 parseResult 为 ParseText(offsetString,
UTCOffset )。 - 断言：parseResult 非错误列表。
- 断言：parseResult 包含
ASCIISign 解析节点 。 - 令 parsedSign 为 parseResult 内
ASCIISign 解析节点 匹配的源文本。 - 若 parsedSign 为 U+002D（连字符），
- 令 sign 为 -1。
- 否则，
- 令 sign 为 1。
- 注：下列
StringToNumber 应用不会丢精度，因为每个解析值均为短数字字符串。 - 断言：parseResult 包含
Hour 解析节点 。 - 令 parsedHours 为 parseResult 内
Hour 解析节点 匹配的源文本。 - 令 hours 为
ℝ (StringToNumber (CodePointsToString(parsedHours)))。 - 若 parseResult 不含
MinuteSecond 解析节点 ，- 令 minutes 为 0。
- 否则，
- 令 parsedMinutes 为 parseResult 内第一个
MinuteSecond 解析节点 匹配的源文本。 - 令 minutes 为
ℝ (StringToNumber (CodePointsToString(parsedMinutes)))。
- 令 parsedMinutes 为 parseResult 内第一个
- 若 parseResult 不含两个
MinuteSecond 解析节点 ，- 令 seconds 为 0。
- 否则，
- 令 parsedSeconds 为 parseResult 内第二个
MinuteSecond 解析节点 匹配的源文本。 - 令 seconds 为
ℝ (StringToNumber (CodePointsToString(parsedSeconds)))。
- 令 parsedSeconds 为 parseResult 内第二个
- 若 parseResult 不含
TemporalDecimalFraction 解析节点 ，- 令 nanoseconds 为 0。
- 否则，
- 令 parsedFraction 为 parseResult 内
TemporalDecimalFraction 解析节点 匹配的源文本。 - 令 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）的字符串。 - 是一个行为根据参数数量和类型不同而不同的函数。
- 可用作类定义的
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，
- 否则，
- 断言：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))。
- 令 O 为 ?
OrdinaryCreateFromConstructor (NewTarget,"%Date.prototype%" , « [[DateValue]] »)。 - 设置 O.[[DateValue]] 为 dv。
- 返回 O。
21.4.3 Date 构造函数的属性
Date
- 拥有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 拥有一个
"length" 属性，其值为7 𝔽。 - 拥有以下属性：
21.4.3.1 Date.now ( )
此函数返回调用时发生的 UTC 日期和时间的
21.4.3.2 Date.parse ( 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())不要求与前三个表达式产生相同的数值，并且通常当此函数接收到任何不符合 Date Time String Format（toString 或 toUTCString 方法产生的字符串值时，其产生的数值是实现定义的。
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)))。
此函数的
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 ( )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，返回NaN 。 - 返回
DateFromTime (LocalTime (t))。
21.4.4.3 Date.prototype.getDay ( )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，返回NaN 。 - 返回
WeekDay (LocalTime (t))。
21.4.4.4 Date.prototype.getFullYear ( )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，返回NaN 。 - 返回
YearFromTime (LocalTime (t))。
21.4.4.5 Date.prototype.getHours ( )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，返回NaN 。 - 返回
HourFromTime (LocalTime (t))。
21.4.4.6 Date.prototype.getMilliseconds ( )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，返回NaN 。 - 返回
msFromTime (LocalTime (t))。
21.4.4.7 Date.prototype.getMinutes ( )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，返回NaN 。 - 返回
MinFromTime (LocalTime (t))。
21.4.4.8 Date.prototype.getMonth ( )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，返回NaN 。 - 返回
MonthFromTime (LocalTime (t))。
21.4.4.9 Date.prototype.getSeconds ( )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，返回NaN 。 - 返回
SecFromTime (LocalTime (t))。
21.4.4.10 Date.prototype.getTime ( )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 返回 dateObject.[[DateValue]]。
21.4.4.11 Date.prototype.getTimezoneOffset ( )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，返回NaN 。 - 返回 (t -
LocalTime (t)) /msPerMinute 。
21.4.4.12 Date.prototype.getUTCDate ( )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，返回NaN 。 - 返回
DateFromTime (t)。
21.4.4.13 Date.prototype.getUTCDay ( )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，返回NaN 。 - 返回
WeekDay (t)。
21.4.4.14 Date.prototype.getUTCFullYear ( )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，返回NaN 。 - 返回
YearFromTime (t)。
21.4.4.15 Date.prototype.getUTCHours ( )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，返回NaN 。 - 返回
HourFromTime (t)。
21.4.4.16 Date.prototype.getUTCMilliseconds ( )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，返回NaN 。 - 返回
msFromTime (t)。
21.4.4.17 Date.prototype.getUTCMinutes ( )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，返回NaN 。 - 返回
MinFromTime (t)。
21.4.4.18 Date.prototype.getUTCMonth ( )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，返回NaN 。 - 返回
MonthFromTime (t)。
21.4.4.19 Date.prototype.getUTCSeconds ( )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，返回NaN 。 - 返回
SecFromTime (t)。
21.4.4.20 Date.prototype.setDate ( date )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 令 dt 为 ?
ToNumber (date)。 - 如果 t 为
NaN ，返回NaN 。 - 设置 t 为
LocalTime (t)。 - 令 newDate 为
MakeDate (MakeDay (YearFromTime (t),MonthFromTime (t), dt),TimeWithinDay (t))。 - 令 u 为
TimeClip (UTC (newDate))。 - 设置 dateObject.[[DateValue]] 为 u。
- 返回 u。
21.4.4.21 Date.prototype.setFullYear ( year [ , month [ , date ] ] )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 令 y 为 ?
ToNumber (year)。 - 如果 t 为
NaN ，设置 t 为+0 𝔽；否则设置 t 为LocalTime (t)。 - 如果 month 未传入，令 m 为
MonthFromTime (t)；否则令 m 为 ?ToNumber (month)。 - 如果 date 未传入，令 dt 为
DateFromTime (t)；否则令 dt 为 ?ToNumber (date)。 - 令 newDate 为
MakeDate (MakeDay (y, m, dt),TimeWithinDay (t))。 - 令 u 为
TimeClip (UTC (newDate))。 - 设置 dateObject.[[DateValue]] 为 u。
- 返回 u。
该方法的
如果未传入 month，该方法表现为 month 取 getMonth() 的值。如果未传入 date，则表现为 date 取 getDate() 的值。
21.4.4.22 Date.prototype.setHours ( hour [ , min [ , sec [ , ms ] ] ] )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 令 h 为 ?
ToNumber (hour)。 - 如果传入 min，令 m 为 ?
ToNumber (min)。 - 如果传入 sec，令 s 为 ?
ToNumber (sec)。 - 如果传入 ms，令 milli 为 ?
ToNumber (ms)。 - 如果 t 为
NaN ，返回NaN 。 - 设置 t 为
LocalTime (t)。 - 如果 min 未传入，令 m 为
MinFromTime (t)。 - 如果 sec 未传入，令 s 为
SecFromTime (t)。 - 如果 ms 未传入，令 milli 为
msFromTime (t)。 - 令 date 为
MakeDate (Day (t),MakeTime (h, m, s, milli))。 - 令 u 为
TimeClip (UTC (date))。 - 设置 dateObject.[[DateValue]] 为 u。
- 返回 u。
该方法的
如果未传入 min，该方法表现为 min 取 getMinutes() 的值。如果未传入 sec，表现为 sec 取 getSeconds() 的值。如果未传入 ms，表现为 ms 取 getMilliseconds() 的值。
21.4.4.23 Date.prototype.setMilliseconds ( ms )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 设置 ms 为 ?
ToNumber (ms)。 - 如果 t 为
NaN ，返回NaN 。 - 设置 t 为
LocalTime (t)。 - 令 time 为
MakeTime (HourFromTime (t),MinFromTime (t),SecFromTime (t), ms)。 - 令 u 为
TimeClip (UTC (MakeDate (Day (t), time)))。 - 设置 dateObject.[[DateValue]] 为 u。
- 返回 u。
21.4.4.24 Date.prototype.setMinutes ( min [ , sec [ , ms ] ] )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 令 m 为 ?
ToNumber (min)。 - 如果传入 sec，令 s 为 ?
ToNumber (sec)。 - 如果传入 ms，令 milli 为 ?
ToNumber (ms)。 - 如果 t 为
NaN ，返回NaN 。 - 设置 t 为
LocalTime (t)。 - 如果 sec 未传入，令 s 为
SecFromTime (t)。 - 如果 ms 未传入，令 milli 为
msFromTime (t)。 - 令 date 为
MakeDate (Day (t),MakeTime (HourFromTime (t), m, s, milli))。 - 令 u 为
TimeClip (UTC (date))。 - 设置 dateObject.[[DateValue]] 为 u。
- 返回 u。
该方法的
如果未传入 sec，该方法表现为 sec 取 getSeconds() 的值。如果未传入 ms，表现为 ms 取 getMilliseconds() 的值。
21.4.4.25 Date.prototype.setMonth ( month [ , date ] )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 令 m 为 ?
ToNumber (month)。 - 如果传入 date，令 dt 为 ?
ToNumber (date)。 - 如果 t 为
NaN ，返回NaN 。 - 设置 t 为
LocalTime (t)。 - 如果 date 未传入，令 dt 为
DateFromTime (t)。 - 令 newDate 为
MakeDate (MakeDay (YearFromTime (t), m, dt),TimeWithinDay (t))。 - 令 u 为
TimeClip (UTC (newDate))。 - 设置 dateObject.[[DateValue]] 为 u。
- 返回 u。
该方法的
如果未传入 date，该方法表现为 date 取 getDate() 的值。
21.4.4.26 Date.prototype.setSeconds ( sec [ , ms ] )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 令 s 为 ?
ToNumber (sec)。 - 如果传入 ms，令 milli 为 ?
ToNumber (ms)。 - 如果 t 为
NaN ，返回NaN 。 - 设置 t 为
LocalTime (t)。 - 如果 ms 未传入，令 milli 为
msFromTime (t)。 - 令 date 为
MakeDate (Day (t),MakeTime (HourFromTime (t),MinFromTime (t), s, milli))。 - 令 u 为
TimeClip (UTC (date))。 - 设置 dateObject.[[DateValue]] 为 u。
- 返回 u。
该方法的
如果未传入 ms，该方法表现为 ms 取 getMilliseconds() 的值。
21.4.4.27 Date.prototype.setTime ( time )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 ?
ToNumber (time)。 - 令 v 为
TimeClip (t)。 - 设置 dateObject.[[DateValue]] 为 v。
- 返回 v。
21.4.4.28 Date.prototype.setUTCDate ( date )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 令 dt 为 ?
ToNumber (date)。 - 如果 t 为
NaN ，返回NaN 。 - 令 newDate 为
MakeDate (MakeDay (YearFromTime (t),MonthFromTime (t), dt),TimeWithinDay (t))。 - 令 v 为
TimeClip (newDate)。 - 设置 dateObject.[[DateValue]] 为 v。
- 返回 v。
21.4.4.29 Date.prototype.setUTCFullYear ( year [ , month [ , date ] ] )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 如果 t 为
NaN ，设置 t 为+0 𝔽。 - 令 y 为 ?
ToNumber (year)。 - 如果 month 未传入，令 m 为
MonthFromTime (t)；否则令 m 为 ?ToNumber (month)。 - 如果 date 未传入，令 dt 为
DateFromTime (t)；否则令 dt 为 ?ToNumber (date)。 - 令 newDate 为
MakeDate (MakeDay (y, m, dt),TimeWithinDay (t))。 - 令 v 为
TimeClip (newDate)。 - 设置 dateObject.[[DateValue]] 为 v。
- 返回 v。
该方法的
如果未传入 month，该方法表现为 month 取 getUTCMonth() 的值。如果未传入 date，则表现为 date 取 getUTCDate() 的值。
21.4.4.30 Date.prototype.setUTCHours ( hour [ , min [ , sec [ , ms ] ] ] )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 令 h 为 ?
ToNumber (hour)。 - 如果传入 min，令 m 为 ?
ToNumber (min)。 - 如果传入 sec，令 s 为 ?
ToNumber (sec)。 - 如果传入 ms，令 milli 为 ?
ToNumber (ms)。 - 如果 t 为
NaN ，返回NaN 。 - 如果 min 未传入，令 m 为
MinFromTime (t)。 - 如果 sec 未传入，令 s 为
SecFromTime (t)。 - 如果 ms 未传入，令 milli 为
msFromTime (t)。 - 令 date 为
MakeDate (Day (t),MakeTime (h, m, s, milli))。 - 令 v 为
TimeClip (date)。 - 设置 dateObject.[[DateValue]] 为 v。
- 返回 v。
该方法的
如果未传入 min，该方法表现为 min 取 getUTCMinutes() 的值。如果未传入 sec，表现为 sec 取 getUTCSeconds() 的值。如果未传入 ms，表现为 ms 取 getUTCMilliseconds() 的值。
21.4.4.31 Date.prototype.setUTCMilliseconds ( ms )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 设置 ms 为 ?
ToNumber (ms)。 - 如果 t 为
NaN ，返回NaN 。 - 令 time 为
MakeTime (HourFromTime (t),MinFromTime (t),SecFromTime (t), ms)。 - 令 v 为
TimeClip (MakeDate (Day (t), time))。 - 设置 dateObject.[[DateValue]] 为 v。
- 返回 v。
21.4.4.32 Date.prototype.setUTCMinutes ( min [ , sec [ , ms ] ] )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 令 m 为 ?
ToNumber (min)。 - 如果传入 sec，令 s 为 ?
ToNumber (sec)。 - 如果传入 ms，令 milli 为 ?
ToNumber (ms)。 - 如果 t 为
NaN ，返回NaN 。 - 如果 sec 未传入，令 s 为
SecFromTime (t)。 - 如果 ms 未传入，令 milli 为
msFromTime (t)。 - 令 date 为
MakeDate (Day (t),MakeTime (HourFromTime (t), m, s, milli))。 - 令 v 为
TimeClip (date)。 - 设置 dateObject.[[DateValue]] 为 v。
- 返回 v。
该方法的
如果未传入 sec，该方法表现为 sec 取 getUTCSeconds() 的值。如果未传入 ms，表现为 ms 取 getUTCMilliseconds() 的值。
21.4.4.33 Date.prototype.setUTCMonth ( month [ , date ] )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 令 m 为 ?
ToNumber (month)。 - 如果传入 date，令 dt 为 ?
ToNumber (date)。 - 如果 t 为
NaN ，返回NaN 。 - 如果 date 未传入，令 dt 为
DateFromTime (t)。 - 令 newDate 为
MakeDate (MakeDay (YearFromTime (t), m, dt),TimeWithinDay (t))。 - 令 v 为
TimeClip (newDate)。 - 设置 dateObject.[[DateValue]] 为 v。
- 返回 v。
该方法的
如果未传入 date，该方法表现为 date 取 getUTCDate() 的值。
21.4.4.34 Date.prototype.setUTCSeconds ( sec [ , ms ] )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 令 s 为 ?
ToNumber (sec)。 - 如果传入 ms，令 milli 为 ?
ToNumber (ms)。 - 如果 t 为
NaN ，返回NaN 。 - 如果 ms 未传入，令 milli 为
msFromTime (t)。 - 令 date 为
MakeDate (Day (t),MakeTime (HourFromTime (t),MinFromTime (t), s, milli))。 - 令 v 为
TimeClip (date)。 - 设置 dateObject.[[DateValue]] 为 v。
- 返回 v。
该方法的
如果未传入 ms，该方法表现为 ms 取 getUTCMilliseconds() 的值。
21.4.4.35 Date.prototype.toDateString ( )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 tv 为 dateObject.[[DateValue]]。
- 如果 tv 为
NaN ，返回"Invalid Date" 。 - 令 t 为
LocalTime (tv)。 - 返回
DateString (t)。
21.4.4.36 Date.prototype.toISOString ( )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 tv 为 dateObject.[[DateValue]]。
- 如果 tv 为
NaN ，抛出RangeError 异常。 - 断言：tv 是整数类型的数字。
- 如果 tv 对应的年份无法在
Date Time String Format 中表示，抛出RangeError 异常。 - 返回 tv 在 UTC 时间轴上的
Date Time String Format 字符串表示，包括所有格式元素和 UTC 偏移表示"Z" 。
21.4.4.37 Date.prototype.toJSON ( key )
此方法为 JSON.stringify (
调用此方法时，执行以下步骤：
参数会被忽略。
此方法有意设计为泛型；它不要求其 toISOString 方法。
21.4.4.38 Date.prototype.toLocaleDateString ( [ reserved1 [ , reserved2 ] ] )
包含 ECMA-402 国际化 API 的 ECMAScript 实现必须按照 ECMA-402 规范实现此方法。如果 ECMAScript 实现不包含 ECMA-402 API，则使用以下规范：
此方法返回一个字符串值。字符串内容由实现定义，但旨在以主机环境当前区域设置的习惯用法，以便捷、易读的方式表示当前时区中的 Date 的“日期”部分。
此方法的可选参数含义在 ECMA-402 规范中定义；不支持 ECMA-402 的实现不得在这些参数位置使用其他含义。
21.4.4.39 Date.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
包含 ECMA-402 国际化 API 的 ECMAScript 实现必须按照 ECMA-402 规范实现此方法。如果 ECMAScript 实现不包含 ECMA-402 API，则使用以下规范：
此方法返回一个字符串值。字符串内容由实现定义，但旨在以主机环境当前区域设置的习惯用法，以便捷、易读的方式表示当前时区中的 Date。
此方法的可选参数含义在 ECMA-402 规范中定义；不支持 ECMA-402 的实现不得在这些参数位置使用其他含义。
21.4.4.40 Date.prototype.toLocaleTimeString ( [ reserved1 [ , reserved2 ] ] )
包含 ECMA-402 国际化 API 的 ECMAScript 实现必须按照 ECMA-402 规范实现此方法。如果 ECMAScript 实现不包含 ECMA-402 API，则使用以下规范：
此方法返回一个字符串值。字符串内容由实现定义，但旨在以主机环境当前区域设置的习惯用法，以便捷、易读的方式表示当前时区中的 Date 的“时间”部分。
此方法的可选参数含义在 ECMA-402 规范中定义；不支持 ECMA-402 的实现不得在这些参数位置使用其他含义。
21.4.4.41 Date.prototype.toString ( )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 tv 为 dateObject.[[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 (一个数字，但不是
- 令 hour 为
ToZeroPaddedDecimalString (ℝ (HourFromTime (tv)), 2)。 - 令 minute 为
ToZeroPaddedDecimalString (ℝ (MinFromTime (tv)), 2)。 - 令 second 为
ToZeroPaddedDecimalString (ℝ (SecFromTime (tv)), 2)。 - 返回 hour、
":" 、minute、":" 、second、码元 0x0020（空格）、"GMT" 的字符串拼接结果。
21.4.4.41.2 DateString ( tv )
The abstract operation DateString takes argument tv (一个数字，但不是
- 令 weekday 为
Table 63 中WeekDay (tv) 的 Name。 - 令 month 为
Table 64 中MonthFromTime (tv) 的 Name。 - 令 day 为
ToZeroPaddedDecimalString (ℝ (DateFromTime (tv)), 2)。 - 令 yv 为
YearFromTime (tv)。 - 如果 yv 为
+0 𝔽 或 yv >+0 𝔽，令 yearSign 为空字符串；否则令 yearSign 为"-" 。 - 令 paddedYear 为
ToZeroPaddedDecimalString (abs (ℝ (yv)), 4)。 - 返回 weekday、码元 0x0020（空格）、month、码元 0x0020（空格）、day、码元 0x0020（空格）、yearSign、paddedYear 的字符串拼接结果。
| Number | Name |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Number | Name |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
21.4.4.41.3 TimeZoneString ( tv )
The abstract operation TimeZoneString takes argument tv (一个整数类型的数字) and returns 一个字符串. It performs the following steps when called:
- 令 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 为实现定义的字符串，可以为空字符串，也可以是码元 0x0020（空格）、码元 0x0028（左括号）、实现定义的时区名称和码元 0x0029（右括号）拼接的字符串。
- 返回 offsetSign、offsetHour、offsetMin、tzName 的字符串拼接结果。
21.4.4.41.4 ToDateString ( tv )
The abstract operation ToDateString takes argument tv (一个整数类型的数字或
- 如果 tv 为
NaN ，返回"Invalid Date" 。 - 令 t 为
LocalTime (tv)。 - 返回
DateString (t)、码元 0x0020（空格）、TimeString (t)、TimeZoneString (tv) 的字符串拼接结果。
21.4.4.42 Date.prototype.toTimeString ( )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 tv 为 dateObject.[[DateValue]]。
- 如果 tv 为
NaN ，返回"Invalid Date" 。 - 令 t 为
LocalTime (tv)。 - 返回
TimeString (t) 和TimeZoneString (tv) 的字符串拼接结果。
21.4.4.43 Date.prototype.toUTCString ( )
此方法返回一个字符串值，表示与
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 tv 为 dateObject.[[DateValue]]。
- 如果 tv 为
NaN ，返回"Invalid Date" 。 - 令 weekday 为
Table 63 中WeekDay (tv) 的 Name。 - 令 month 为
Table 64 中MonthFromTime (tv) 的 Name。 - 令 day 为
ToZeroPaddedDecimalString (ℝ (DateFromTime (tv)), 2)。 - 令 yv 为
YearFromTime (tv)。 - 如果 yv 为
+0 𝔽 或 yv >+0 𝔽，令 yearSign 为空字符串；否则令 yearSign 为"-" 。 - 令 paddedYear 为
ToZeroPaddedDecimalString (abs (ℝ (yv)), 4)。 - 返回 weekday、
"," 、码元 0x0020（空格）、day、码元 0x0020（空格）、month、码元 0x0020（空格）、yearSign、paddedYear、码元 0x0020（空格）、TimeString (tv) 的字符串拼接结果。
21.4.4.44 Date.prototype.valueOf ( )
调用此方法时，执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 返回 dateObject.[[DateValue]]。
21.4.4.45 Date.prototype [ %Symbol.toPrimitive% ] ( hint )
此方法由 ECMAScript 语言运算符调用，用于将 Date 转换为原始值。hint 的允许值为
调用此方法时，执行以下步骤：
- 令 O 为
this 值。 - 如果 O 不是对象，抛出
TypeError 异常。 - 如果 hint 是
"string" 或"default" ，- 令 tryFirst 为
string 。
- 令 tryFirst 为
- 否则如果 hint 是
"number" ，- 令 tryFirst 为
number 。
- 令 tryFirst 为
- 否则，
- 抛出
TypeError 异常。
- 抛出
- 返回 ?
OrdinaryToPrimitive (O, 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，则
- 令 s 为空字符串。
- 否则，
- 如果 NewTarget 为
undefined 且 value 是一个 Symbol，返回SymbolDescriptiveString (value)。 - 令 s 为 ?
ToString (value)。
- 如果 NewTarget 为
- 如果 NewTarget 为
undefined ，返回 s。 - 返回
StringCreate (s, ?GetPrototypeFromConstructor (NewTarget,"%String.prototype%" ))。
22.1.2 String 构造函数的属性
String
- 有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
22.1.2.1 String.fromCharCode ( ...codeUnits )
此函数可用任意数量的参数调用，这些参数组成剩余参数 codeUnits。
调用时执行以下步骤：
该函数的
22.1.2.2 String.fromCodePoint ( ...codePoints )
此函数可用任意数量的参数调用，这些参数组成剩余参数 codePoints。
调用时执行以下步骤：
该函数的
22.1.2.3 String.prototype
String.prototype 的初始值是
该属性具有 { [[Writable]]:
22.1.2.4 String.raw ( template, ...substitutions )
此函数可用可变数量参数调用。第一个参数为 template，其余参数构成列表 substitutions。
调用时执行以下步骤：
- 令 substitutionCount 为 substitutions 中元素数量。
- 令 cooked 为 ?
ToObject (template)。 - 令 literals 为 ?
ToObject (?Get (cooked,"raw" ))。 - 令 literalCount 为 ?
LengthOfArrayLike (literals)。 - 若 literalCount ≤ 0，返回空字符串。
- 令 R 为空字符串。
- 令 nextIndex 为 0。
- 重复，
- 令 nextLiteralVal 为 ?
Get (literals, !ToString (𝔽 (nextIndex)))。 - 令 nextLiteral 为 ?
ToString (nextLiteralVal)。 - 将 R 设为 R 与 nextLiteral 的字符串拼接。
- 若 nextIndex + 1 = literalCount，返回 R。
- 若 nextIndex < substitutionCount，则
- 令 nextSubVal 为 substitutions[nextIndex]。
- 令 nextSub 为 ?
ToString (nextSubVal)。 - 将 R 设为 R 与 nextSub 的字符串拼接。
- 将 nextIndex 设为 nextIndex + 1。
- 令 nextLiteralVal 为 ?
此函数旨在作为标记模板（
22.1.3 String 原型对象的属性
String 原型对象：
- 是 %String.prototype%。
- 是一个 String 特异（exotic）对象，并具有为此类对象指定的内部方法。
- 有一个 [[StringData]] 内部槽，其值为空字符串。
- 有一个
"length" 属性，其初始值为+0 𝔽，属性为 { [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:false }。 - 有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。
除非另有明确说明，下面定义的 String 原型对象的方法不是泛型的，传入的
22.1.3.1 String.prototype.at ( index )
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 令 S 为 ?
ToString (O)。 - 令 len 为 S 的长度。
- 令 relativeIndex 为 ?
ToIntegerOrInfinity (index)。 - 如果 relativeIndex ≥ 0，则
- 令 k 为 relativeIndex。
- 否则，
- 令 k 为 len + relativeIndex。
- 若 k < 0 或 k ≥ len，返回
undefined 。 - 返回 S 中从 k 到 k + 1 的子串。
22.1.3.2 String.prototype.charAt ( pos )
该方法返回一个包含在将此对象转换为 String 后所得字符串中索引 pos 处代码单元的单元素字符串。如果该索引处无元素，则结果为空字符串。结果是 String 值，而非 String 对象。
如果 pos 是整数数值，则 x.charAt(pos) 的结果等价于 x.substring(pos, pos + 1) 的结果。
调用该方法时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 令 S 为 ?
ToString (O)。 - 令 position 为 ?
ToIntegerOrInfinity (pos)。 - 令 size 为 S 的长度。
- 若 position < 0 或 position ≥ size，返回空字符串。
- 返回 S 中从 position 到 position + 1 的子串。
该方法特意设计为泛型；其
22.1.3.3 String.prototype.charCodeAt ( pos )
该方法返回一个 Number（非负整数且小于 216），表示在将此对象转换为 String 后得到的字符串中索引 pos 处代码单元的数值。如果该索引处无元素，结果为
调用该方法时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 令 S 为 ?
ToString (O)。 - 令 position 为 ?
ToIntegerOrInfinity (pos)。 - 令 size 为 S 的长度。
- 若 position < 0 或 position ≥ size，返回
NaN 。 - 返回在字符串 S 中索引 position 处代码单元的数值对应的 Number 值。
该方法特意设计为泛型；其
22.1.3.4 String.prototype.codePointAt ( pos )
调用该方法时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 令 S 为 ?
ToString (O)。 - 令 position 为 ?
ToIntegerOrInfinity (pos)。 - 令 size 为 S 的长度。
- 若 position < 0 或 position ≥ size，返回
undefined 。 - 令 cp 为 CodePointAt(S, position)。
- 返回
𝔽 (cp.[[CodePoint]])。
该方法特意设计为泛型；其
22.1.3.5 String.prototype.concat ( ...args )
调用此方法时，它返回一个由
调用该方法时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 令 S 为 ?
ToString (O)。 - 令 R 为 S。
- 对于 args 中的每个元素 next，执行
- 令 nextString 为 ?
ToString (next)。 - 将 R 设为 R 与 nextString 的字符串拼接。
- 令 nextString 为 ?
- 返回 R。
该方法的
该方法特意设计为泛型；其
22.1.3.6 String.prototype.constructor
String.prototype.constructor 的初始值是
22.1.3.7 String.prototype.endsWith ( searchString [ , endPosition ] )
调用该方法时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 令 S 为 ?
ToString (O)。 - 令 isRegExp 为 ?
IsRegExp (searchString)。 - 若 isRegExp 为
true ，抛出TypeError 异常。 - 令 searchStr 为 ?
ToString (searchString)。 - 令 len 为 S 的长度。
- 若 endPosition 为
undefined ，令 pos 为 len；否则令 pos 为 ?ToIntegerOrInfinity (endPosition)。 - 令 end 为将 pos 钳制在 0 和 len 之间的结果。
- 令 searchLength 为 searchStr 的长度。
- 若 searchLength = 0，返回
true 。 - 令 start 为 end - searchLength。
- 若 start < 0，返回
false 。 - 令 substring 为 S 中从 start 到 end 的子串。
- 若 substring 是 searchStr，返回
true 。 - 返回
false 。
若 searchString（转为 String） 的代码单元序列与该对象（转为 String）在 endPosition - length(this) 处开始的对应代码单元相同，则此方法返回
当第一个参数是 RegExp 时抛出异常是为了允许未来版本定义允许此类参数值的扩展。
该方法特意设计为泛型；其
22.1.3.8 String.prototype.includes ( searchString [ , position ] )
调用该方法时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 令 S 为 ?
ToString (O)。 - 令 isRegExp 为 ?
IsRegExp (searchString)。 - 若 isRegExp 为
true ，抛出TypeError 异常。 - 令 searchStr 为 ?
ToString (searchString)。 - 令 pos 为 ?
ToIntegerOrInfinity (position)。 - 断言：如果 position 为
undefined ，则 pos 为 0。 - 令 len 为 S 的长度。
- 令 start 为将 pos 钳制在 0 和 len 之间的结果。
- 令 index 为
StringIndexOf (S, searchStr, start)。 - 若 index 为
not-found ，返回false 。 - 返回
true 。
如果 searchString 作为
当第一个参数是 RegExp 时抛出异常是为了允许未来版本定义允许此类参数值的扩展。
该方法特意设计为泛型；其
22.1.3.9 String.prototype.indexOf ( searchString [ , position ] )
如果 searchString 作为
调用该方法时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 令 S 为 ?
ToString (O)。 - 令 searchStr 为 ?
ToString (searchString)。 - 令 pos 为 ?
ToIntegerOrInfinity (position)。 - 断言：如果 position 为
undefined ，则 pos 为 0。 - 令 len 为 S 的长度。
- 令 start 为将 pos 钳制在 0 和 len 之间的结果。
- 令 result 为
StringIndexOf (S, searchStr, start)。 - 若 result 为
not-found ，返回-1 𝔽。 - 返回
𝔽 (result)。
该方法特意设计为泛型；其
22.1.3.10 String.prototype.isWellFormed ( )
调用该方法时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 令 S 为 ?
ToString (O)。 - 返回 IsStringWellFormedUnicode(S)。
22.1.3.11 String.prototype.lastIndexOf ( searchString [ , position ] )
如果 searchString 作为
调用该方法时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 令 S 为 ?
ToString (O)。 - 令 searchStr 为 ?
ToString (searchString)。 - 令 numPos 为 ?
ToNumber (position)。 - 断言：若 position 为
undefined ，则 numPos 为NaN 。 - 若 numPos 为
NaN ，令 pos 为 +∞；否则令 pos 为 !ToIntegerOrInfinity (numPos)。 - 令 len 为 S 的长度。
- 令 searchLen 为 searchStr 的长度。
- 令 start 为将 pos 钳制在 0 和 len - searchLen 之间的结果。
- 令 result 为
StringLastIndexOf (S, searchStr, start)。 - 若 result 为
not-found ，返回-1 𝔽。 - 返回
𝔽 (result)。
该方法特意设计为泛型；其
22.1.3.12 String.prototype.localeCompare ( that [ , reserved1 [ , reserved2 ] ] )
包含 ECMA-402 国际化 API 的 ECMAScript 实现必须按 ECMA-402 的规范实现此方法。若不包含，则使用下述规范：
此方法返回一个非
在执行比较前，此方法进行以下准备步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 令 S 为 ?
ToString (O)。 - 令 thatValue 为 ?
ToString (that)。
第二与第三可选参数的含义在 ECMA-402 规范中定义；不包含 ECMA-402 支持的实现不得为这些参数位置赋予其他含义。
实际返回值是实现定义的，以允许编码附加信息；但是当该方法视作二元比较器使用时，必须定义所有字符串集合上的一个总排序。该方法还必须识别并遵循 Unicode 标准中的规范等价（canonical equivalence），包括在比较可区分但规范等价的字符串时返回
该方法本身不适合作为 Array.prototype.sort 的参数，因为后者需要一个二元函数。
该方法可依赖
// Å 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 标准第 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 标准第 3 章第 3.7 节中定义的兼容等价或兼容分解。
该方法特意设计为泛型；其
22.1.3.13 String.prototype.match ( regexp )
调用该方法时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 若 regexp 既不是
undefined 也不是null ，则- 令 matcher 为 ?
GetMethod (regexp,%Symbol.match% )。 - 若 matcher 不为
undefined ，则- 返回 ? Call(matcher, regexp, « O »)。
- 令 matcher 为 ?
- 令 S 为 ?
ToString (O)。 - 令 rx 为 ?
RegExpCreate (regexp,undefined )。 - 返回 ? Invoke(rx,
%Symbol.match% , « S »)。
该方法特意设计为泛型；其
22.1.3.14 String.prototype.matchAll ( regexp )
该方法对表示
调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 若 regexp 既不是
undefined 也不是null ，则- 令 isRegExp 为 ?
IsRegExp (regexp)。 - 若 isRegExp 为
true ，则- 令 flags 为 ?
Get (regexp,"flags" )。 - 执行 ?
RequireObjectCoercible (flags)。 - 若 ?
ToString (flags) 不包含"g" ，抛出TypeError 异常。
- 令 flags 为 ?
- 令 matcher 为 ?
GetMethod (regexp,%Symbol.matchAll% )。 - 若 matcher 不为
undefined ，则- 返回 ? Call(matcher, regexp, « O »)。
- 令 isRegExp 为 ?
- 令 S 为 ?
ToString (O)。 - 令 rx 为 ?
RegExpCreate (regexp,"g" )。 - 返回 ? Invoke(rx,
%Symbol.matchAll% , « S »)。
String.prototype.split 相似，String.prototype.matchAll 被设计为通常不修改其输入。22.1.3.15 String.prototype.normalize ( [ form ] )
调用该方法时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 令 S 为 ?
ToString (O)。 - 若 form 为
undefined ，令 f 为"NFC" 。 - 否则，令 f 为 ?
ToString (form)。 - 若 f 不在
"NFC" 、"NFD" 、"NFKC" 、"NFKD" 之一中，抛出RangeError 异常。 - 令 ns 为将 S 归一化为由 f 命名的标准化形式所得的字符串值（参见 最新 Unicode 标准 - 归一化形式）。
- 返回 ns。
该方法特意设计为泛型；其
22.1.3.16 String.prototype.padEnd ( maxLength [ , fillString ] )
调用该方法时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 返回 ?
StringPaddingBuiltinsImpl (O, maxLength, fillString,end )。
22.1.3.17 String.prototype.padStart ( maxLength [ , fillString ] )
调用该方法时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 返回 ?
StringPaddingBuiltinsImpl (O, maxLength, fillString,start )。
22.1.3.17.1 StringPaddingBuiltinsImpl ( O, maxLength, fillString, placement )
The abstract operation StringPaddingBuiltinsImpl takes arguments O (一个
22.1.3.17.2 StringPad ( S, maxLength, fillString, placement )
The abstract operation StringPad takes arguments S (一个字符串), maxLength (非负整数), fillString (一个字符串), and placement (
- 令 stringLength 为 S 的长度。
- 若 maxLength ≤ stringLength，返回 S。
- 若 fillString 为空字符串，返回 S。
- 令 fillLen 为 maxLength - stringLength。
- 令 truncatedStringFiller 为由重复拼接 fillString 直至截断到长度 fillLen 得到的字符串。
- 若 placement 为
start ，返回 truncatedStringFiller 与 S 的字符串拼接。 - 否则，返回 S 与 truncatedStringFiller 的字符串拼接。
参数 maxLength 会被钳制，使其不小于 S 的长度。
参数 fillString 的默认值为
22.1.3.17.3 ToZeroPaddedDecimalString ( n, minLength )
The abstract operation ToZeroPaddedDecimalString takes arguments n (非负整数) and minLength (非负整数) and returns 一个字符串. It performs the following steps when called:
- 令 S 为 n 的十进制格式字符串表示。
- 返回
StringPad (S, minLength,"0" ,start )。
22.1.3.18 String.prototype.repeat ( count )
调用该方法时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 令 S 为 ?
ToString (O)。 - 令 n 为 ?
ToIntegerOrInfinity (count)。 - 若 n < 0 或 n = +∞，抛出
RangeError 异常。 - 若 n = 0，返回空字符串。
- 返回由 n 个 S 依次拼接而成的字符串值。
此方法创建一个字符串值，其内容为
该方法特意设计为泛型；其
22.1.3.19 String.prototype.replace ( searchValue, replaceValue )
调用该方法时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 若 searchValue 既非
undefined 也非null ，则- 令 replacer 为 ?
GetMethod (searchValue,%Symbol.replace% )。 - 若 replacer 不为
undefined ，则- 返回 ? Call(replacer, searchValue, « O, replaceValue »)。
- 令 replacer 为 ?
- 令 string 为 ?
ToString (O)。 - 令 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 为字符串。
- 令 captures 为一个新的空列表。
- 令 replacement 为 !
GetSubstitution (searchString, string, position, captures,undefined , replaceValue)。
- 返回 preceding、replacement、following 的字符串拼接。
该方法特意设计为泛型；其
22.1.3.19.1 GetSubstitution ( matched, str, position, captures, namedCaptures, replacementTemplate )
The abstract operation GetSubstitution takes arguments matched (字符串), str (字符串), position (非负整数), captures (由字符串或
- 令 stringLength 为 str 的长度。
- 断言：position ≤ stringLength。
- 令 result 为空字符串。
- 令 templateRemainder 为 replacementTemplate。
- 当 templateRemainder 非空字符串时重复，
- 注：下列步骤提取 ref（templateRemainder 的前缀）、确定 refReplacement（其替换），然后将替换附加到 result。
- 若 templateRemainder 以
"$$" 开头，则- 令 ref 为
"$$" 。 - 令 refReplacement 为
"$" 。
- 令 ref 为
- 否则若以
"$`" 开头，则- 令 ref 为
"$`" 。 - 令 refReplacement 为 str 中从 0 到 position 的子串。
- 令 ref 为
- 否则若以
"$&" 开头，则- 令 ref 为
"$&" 。 - 令 refReplacement 为 matched。
- 令 ref 为
- 否则若以
"$'" （0x0024 (DOLLAR SIGN) 后接 0x0027 (APOSTROPHE)）开头，则- 令 ref 为
"$'" 。 - 令 matchLength 为 matched 的长度。
- 令 tailPos 为 position + matchLength。
- 令 refReplacement 为 str 中从
min (tailPos, stringLength) 起的子串。 - 注：tailPos 仅当此
抽象操作 由%RegExp.prototype% 的本征%Symbol.replace% 方法被一个"exec" 属性非其本征 %RegExp.prototype.exec% 的对象调用时才可能超过 stringLength。
- 令 ref 为
- 否则若以
"$" 后接 1 个或多个十进制数字开头，则- 若以
"$" 后接至少 2 个十进制数字开头，令 digitCount 为 2；否则令 digitCount 为 1。 - 令 digits 为 templateRemainder 中从 1 到 1 + digitCount 的子串。
- 令 index 为
ℝ (StringToNumber (digits))。 - 断言：0 ≤ index ≤ 99。
- 令 captureLen 为 captures 的元素数量。
- 若 index > captureLen 且 digitCount = 2，则
- 注：当两位数字替换模式指定的索引超过捕获组数量时，它被视为一位数字替换模式后随一个字面数字。
- 将 digitCount 设为 1。
- 将 digits 设为 digits 中从 0 到 1 的子串。
- 将 index 设为
ℝ (StringToNumber (digits))。
- 令 ref 为 templateRemainder 中从 0 到 1 + digitCount 的子串。
- 若 1 ≤ index ≤ captureLen，则
- 令 capture 为 captures[index - 1]。
- 若 capture 为
undefined ，则- 令 refReplacement 为空字符串。
- 否则，
- 令 refReplacement 为 capture。
- 否则，
- 令 refReplacement 为 ref。
- 若以
- 否则若以
"$<" 开头，则- 令 gtPos 为
StringIndexOf (templateRemainder,">" , 0)。 - 若 gtPos 为
not-found 或 namedCaptures 为undefined ，则- 令 ref 为
"$<" 。 - 令 refReplacement 为 ref。
- 令 ref 为
- 否则，
- 令 gtPos 为
- 否则，
- 令 ref 为 templateRemainder 中从 0 到 1 的子串。
- 令 refReplacement 为 ref。
- 令 refLength 为 ref 的长度。
- 将 templateRemainder 设为其从 refLength 起的子串。
- 将 result 设为 result 与 refReplacement 的字符串拼接。
- 返回 result。
22.1.3.20 String.prototype.replaceAll ( searchValue, replaceValue )
调用该方法时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 若 searchValue 既非
undefined 也非null ，则- 令 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, « O, replaceValue »)。
- 令 isRegExp 为 ?
- 令 string 为 ?
ToString (O)。 - 令 searchString 为 ?
ToString (searchValue)。 - 令 functionalReplace 为
IsCallable (replaceValue)。 - 若 functionalReplace 为
false ，则- 将 replaceValue 设为 ?
ToString (replaceValue)。
- 将 replaceValue 设为 ?
- 令 searchLength 为 searchString 长度。
- 令 advanceBy 为
max (1, searchLength)。 - 令 matchPositions 为新的空列表。
- 令 position 为
StringIndexOf (string, searchString, 0)。 - 当 position 非
not-found 时重复，- 将 position 附加到 matchPositions。
- 将 position 设为
StringIndexOf (string, searchString, position + advanceBy)。
- 令 endOfLastMatch 为 0。
- 令 result 为空字符串。
- 对于 matchPositions 中的每个元素 p，执行
- 令 preserved 为 string 中从 endOfLastMatch 到 p 的子串。
- 若 functionalReplace 为
true ，则 - 否则，
- 断言：replaceValue 为字符串。
- 令 captures 为新的空列表。
- 令 replacement 为 !
GetSubstitution (searchString, string, p, captures,undefined , replaceValue)。
- 将 result 设为 result、preserved、replacement 的字符串拼接。
- 将 endOfLastMatch 设为 p + searchLength。
- 若 endOfLastMatch < string 的长度，则
- 将 result 设为 result 与 string 中从 endOfLastMatch 起的子串的字符串拼接。
- 返回 result。
22.1.3.21 String.prototype.search ( regexp )
调用该方法时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 若 regexp 既非
undefined 也非null ，则- 令 searcher 为 ?
GetMethod (regexp,%Symbol.search% )。 - 若 searcher 不为
undefined ，则- 返回 ? Call(searcher, regexp, « O »)。
- 令 searcher 为 ?
- 令 string 为 ?
ToString (O)。 - 令 rx 为 ?
RegExpCreate (regexp,undefined )。 - 返回 ? Invoke(rx,
%Symbol.search% , « string »)。
该方法特意设计为泛型；其
22.1.3.22 String.prototype.slice ( start, end )
该方法返回将此对象转换为字符串后的
调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 令 S 为 ?
ToString (O)。 - 令 len 为 S 的长度。
- 令 intStart 为 ?
ToIntegerOrInfinity (start)。 - 若 intStart = -∞，令 from 为 0。
- 否则若 intStart < 0，令 from 为
max (len + intStart, 0)。 - 否则，令 from 为
min (intStart, len)。 - 若 end 为
undefined ，令 intEnd 为 len；否则令 intEnd 为 ?ToIntegerOrInfinity (end)。 - 若 intEnd = -∞，令 to 为 0。
- 否则若 intEnd < 0，令 to 为
max (len + intEnd, 0)。 - 否则，令 to 为
min (intEnd, len)。 - 若 from ≥ to，返回空字符串。
- 返回 S 中从 from 到 to 的子串。
该方法特意设计为泛型；其
22.1.3.23 String.prototype.split ( separator, limit )
该方法返回一个数组，其中存放了将此对象转换为字符串后的子串。子串通过自左向右查找 separator 的出现确定；这些出现本身不包含在结果数组的任一字符串中，而是用来分割字符串值。separator 的值可以是任意长度的字符串，也可以是一个对象（如具有
调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 若 separator 既非
undefined 也非null ，则- 令 splitter 为 ?
GetMethod (separator,%Symbol.split% )。 - 若 splitter 不为
undefined ，则- 返回 ? Call(splitter, separator, « O, limit »)。
- 令 splitter 为 ?
- 令 S 为 ?
ToString (O)。 - 若 limit 为
undefined ，令 lim 为 232 - 1；否则令 lim 为ℝ (?ToUint32 (limit))。 - 令 R 为 ?
ToString (separator)。 - 若 lim = 0，则
- 返回
CreateArrayFromList (« »)。
- 返回
- 若 separator 为
undefined ，则- 返回
CreateArrayFromList (« S »)。
- 返回
- 令 separatorLength 为 R 的长度。
- 若 separatorLength = 0，则
- 令 strLen 为 S 的长度。
- 令 outLen 为将 lim 钳制在 0 与 strLen 之间的结果。
- 令 head 为 S 中从 0 到 outLen 的子串。
- 令 codeUnits 为 head 代码单元序列组成的列表。
- 返回
CreateArrayFromList (codeUnits)。
- 若 S 为空字符串，返回
CreateArrayFromList (« S »)。 - 令 substrings 为新的空列表。
- 令 i 为 0。
- 令 j 为
StringIndexOf (S, R, 0)。 - 当 j 非
not-found 时重复，- 令 T 为 S 中从 i 到 j 的子串。
- 将 T 添加至 substrings。
- 若 substrings 的元素个数为 lim，返回
CreateArrayFromList (substrings)。 - 将 i 设为 j + separatorLength。
- 将 j 设为
StringIndexOf (S, R, i)。
- 令 T 为 S 中自 i 起的子串。
- 将 T 添加至 substrings。
- 返回
CreateArrayFromList (substrings)。
separator 的值可以为空字符串。在此情况下，separator 不匹配输入字符串开始或末尾的空
如果
若 separator 为
该方法特意设计为泛型；其
22.1.3.24 String.prototype.startsWith ( searchString [ , position ] )
调用该方法时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 令 S 为 ?
ToString (O)。 - 令 isRegExp 为 ?
IsRegExp (searchString)。 - 若 isRegExp 为
true ，抛出TypeError 异常。 - 令 searchStr 为 ?
ToString (searchString)。 - 令 len 为 S 的长度。
- 若 position 为
undefined ，令 pos 为 0；否则令 pos 为 ?ToIntegerOrInfinity (position)。 - 令 start 为将 pos 钳制在 0 与 len 之间的结果。
- 令 searchLength 为 searchStr 的长度。
- 若 searchLength = 0，返回
true 。 - 令 end 为 start + searchLength。
- 若 end > len，返回
false 。 - 令 substring 为 S 中从 start 到 end 的子串。
- 若 substring 是 searchStr，返回
true 。 - 返回
false 。
若 searchString（转换为 String）的代码单元序列与该对象（转换为 String）从索引 position 开始的对应代码单元相同，则该方法返回
当第一个参数是 RegExp 时抛出异常是为了允许未来版本扩展允许此类参数值。
该方法特意设计为泛型；其
22.1.3.25 String.prototype.substring ( start, end )
该方法返回将此对象转换为字符串后，从索引 start 开始到（但不包含）索引 end（或 end 为
若任一参数为
若 start 严格大于 end，则交换它们。
调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 令 S 为 ?
ToString (O)。 - 令 len 为 S 的长度。
- 令 intStart 为 ?
ToIntegerOrInfinity (start)。 - 若 end 为
undefined ，令 intEnd 为 len；否则令 intEnd 为 ?ToIntegerOrInfinity (end)。 - 令 finalStart 为将 intStart 钳制在 0 与 len 之间的结果。
- 令 finalEnd 为将 intEnd 钳制在 0 与 len 之间的结果。
- 令 from 为
min (finalStart, finalEnd)。 - 令 to 为
max (finalStart, finalEnd)。 - 返回 S 中从 from 到 to 的子串。
该方法特意设计为泛型；其
22.1.3.26 String.prototype.toLocaleLowerCase ( [ reserved1 [ , reserved2 ] ] )
包含 ECMA-402 国际化 API 的 ECMAScript 实现必须按 ECMA-402 规范实现此方法。若不包含，则使用以下规范：
此方法将一个字符串值视为 UTF-16 编码代码点序列，参见
其行为与 toLowerCase 相同，但意在生成与
该方法可选参数的含义在 ECMA-402 中定义；未包含 ECMA-402 支持的实现不得对这些参数位置赋予其他含义。
该方法特意设计为泛型；其
22.1.3.27 String.prototype.toLocaleUpperCase ( [ reserved1 [ , reserved2 ] ] )
包含 ECMA-402 国际化 API 的 ECMAScript 实现必须按 ECMA-402 规范实现此方法。若不包含，则使用以下规范：
此方法将字符串值视为 UTF-16 编码代码点序列（参见
其行为与 toUpperCase 相同，但意在生成与
该方法可选参数含义由 ECMA-402 规范定义；未包含 ECMA-402 支持的实现不得赋予其他含义。
该方法特意设计为泛型；其
22.1.3.28 String.prototype.toLowerCase ( )
此方法将字符串值视为 UTF-16 编码代码点序列（参见
调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 令 S 为 ?
ToString (O)。 - 令 sText 为 StringToCodePoints(S)。
- 令 lowerText 为依据 Unicode 默认大小写转换算法对 sText 执行 toLowercase 的结果。
- 令 L 为 CodePointsToString(lowerText)。
- 返回 L。
结果必须依据 Unicode 字符数据库中的与区域无关的大小写映射获得（明确包括 UnicodeData.txt 文件以及伴随的 SpecialCasing.txt 中所有与区域无关的映射）。
某些代码点的大小写映射会产生多个代码点。在此情况下结果字符串长度可能不同于源字符串。由于 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 ( )
此方法将字符串值视为 UTF-16 编码代码点序列（参见
其行为与 String.prototype.toLowerCase 相同，只是字符串使用 Unicode 默认大小写转换中的 toUppercase 算法映射。
该方法特意设计为泛型；其
22.1.3.31 String.prototype.toWellFormed ( )
该方法返回此对象的字符串表示，其中所有不成对的前导或
调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 令 S 为 ?
ToString (O)。 - 令 strLen 为 S 的长度。
- 令 k 为 0。
- 令 result 为空字符串。
- 当 k < strLen 时重复，
- 令 cp 为 CodePointAt(S, k)。
- 若 cp.[[IsUnpairedSurrogate]] 为
true ，则- 将 result 设为 result 与 0xFFFD (REPLACEMENT CHARACTER) 的字符串拼接。
- 否则，
- 将 result 设为 result 与 UTF16EncodeCodePoint(cp.[[CodePoint]]) 的字符串拼接。
- 将 k 设为 k + cp.[[CodeUnitCount]]。
- 返回 result。
22.1.3.32 String.prototype.trim ( )
该方法将字符串值视为 UTF-16 编码代码点序列（参见
调用时执行以下步骤：
- 令 S 为
this 值。 - 返回 ?
TrimString (S,start+end )。
该方法特意设计为泛型；其
22.1.3.32.1 TrimString ( string, where )
The abstract operation TrimString takes arguments string (一个
- 执行 ?
RequireObjectCoercible (string)。 - 令 S 为 ?
ToString (string)。 - 若 where 为
start ，则- 令 T 为移除前导空白后的 S 副本。
- 否则若 where 为
end ，则- 令 T 为移除尾随空白后的 S 副本。
- 否则，
- 断言：where 为
start+end 。 - 令 T 为移除前后空白后的 S 副本。
- 断言：where 为
- 返回 T。
空白的定义为
22.1.3.33 String.prototype.trimEnd ( )
该方法将字符串值视为 UTF-16 编码代码点序列（参见
调用时执行以下步骤：
- 令 S 为
this 值。 - 返回 ?
TrimString (S,end )。
该方法特意设计为泛型；其
22.1.3.34 String.prototype.trimStart ( )
该方法将字符串值视为 UTF-16 编码代码点序列（参见
调用时执行以下步骤：
- 令 S 为
this 值。 - 返回 ?
TrimString (S,start )。
该方法特意设计为泛型；其
22.1.3.35 String.prototype.valueOf ( )
调用该方法时执行以下步骤：
- 返回 ?
ThisStringValue (this value)。
22.1.3.35.1 ThisStringValue ( value )
The abstract operation ThisStringValue takes argument value (一个
- 若 value 是字符串，返回 value。
- 若 value 是对象且具有 [[StringData]] 内部槽，则
- 令 s 为 value.[[StringData]]。
- 断言：s 为字符串。
- 返回 s。
- 抛出
TypeError 异常。
22.1.3.36 String.prototype [ %Symbol.iterator% ] ( )
该方法返回一个迭代器对象，该对象按字符串值的代码点进行迭代，并将每个代码点作为字符串值返回。
调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 令 s 为 ?
ToString (O)。 - 令 closure 为一个不带参数的新抽象闭包，捕获 s，调用时执行：
- 令 len 为 s 的长度。
- 令 position 为 0。
- 当 position < len 时重复，
- 令 cp 为 CodePointAt(s, position)。
- 令 nextIndex 为 position + cp.[[CodeUnitCount]]。
- 令 resultString 为 s 中从 position 到 nextIndex 的子串。
- 将 position 设为 nextIndex。
- 执行 ?
GeneratorYield (CreateIteratorResultObject (resultString,false ))。
- 返回
NormalCompletion (unused )。
- 返回
CreateIteratorFromClosure (closure,"%StringIteratorPrototype%" ,%StringIteratorPrototype% )。
该方法的
22.1.4 String 实例的属性
String 实例是 String 特异对象，并具有为此类对象指定的内部方法。String 实例从
String 实例有一个
22.1.4.1 length
该 String 对象表示的字符串值中的元素数量。
一旦 String 对象初始化，该属性不再变化。其属性为 { [[Writable]]:
22.1.5 String 迭代器对象
String Iterator 是表示某个特定 String 实例对象上的一次特定迭代的对象。String Iterator 对象没有命名
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 对象包含一个正则表达式以及其相关的标志（flags）。
正则表达式的形式和功能参考 Perl 5 编程语言中的正则表达式机制。
22.2.1 模式（Patterns）
RegExp
语法（Syntax）
对于每个 \u u \u u
此处前两行等价于 CharacterClass。
本节中的若干产生式在
22.2.1.1 静态语义：早期错误（Early Errors）
本节在
-
若 CountLeftCapturingParensWithin(
Pattern ) ≥ 232 - 1，则为语法错误（Syntax Error）。 -
若
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 严格大于包含该AtomEscape 的Pattern 中 CountLeftCapturingParensWithin 的结果，则为语法错误。
-
若第一个
ClassAtom 的 IsCharacterClass 为true 或第二个ClassAtom 的 IsCharacterClass 为true ，则为语法错误。 -
若两者 IsCharacterClass 均为
false 且第一个ClassAtom 的 CharacterValue 严格大于第二个ClassAtom 的 CharacterValue，则为语法错误。
-
若
ClassAtomNoDash 的 IsCharacterClass 为true 或ClassAtom 的 IsCharacterClass 为true ，则为语法错误。 -
若二者 IsCharacterClass 均为
false 且ClassAtomNoDash 的 CharacterValue 严格大于ClassAtom 的 CharacterValue，则为语法错误。
-
若
RegExpUnicodeEscapeSequence 的 CharacterValue 不是IdentifierStartChar 词法语法产生式所匹配的某个代码点的数值，则为语法错误。
-
若
RegExpIdentifierStart 的 RegExpIdentifierCodePoint 未被UnicodeIDStart 词法语法产生式匹配，则为语法错误。
-
若
RegExpUnicodeEscapeSequence 的 CharacterValue 不是IdentifierPartChar 词法语法产生式所匹配的某个代码点的数值，则为语法错误。
-
若
RegExpIdentifierPart 的 RegExpIdentifierCodePoint 未被UnicodeIDContinue 词法语法产生式匹配，则为语法错误。
-
若
UnicodePropertyName 匹配的源文本不是Table 67 “Property name and aliases” 列所列出的 Unicode属性名 或属性别名，则为语法错误。 -
若
UnicodePropertyValue 匹配的源文本不是PropertyValueAliases.txt中针对该UnicodePropertyName 源文本所给 Unicode 属性（或其别名）的属性值或属性值别名，则为语法错误。
-
若
LoneUnicodePropertyNameOrValue 匹配的源文本既不是PropertyValueAliases.txt中 General_Category (gc) 属性的属性值或其别名，也不是Table 68 “Property name and aliases” 列中列出的二进制属性或其别名，也不是Table 69 “Property name” 列中列出的字符串二进制属性，则为语法错误。 -
若封闭的
Pattern 不具有 [UnicodeSetsMode] 参数，且LoneUnicodePropertyNameOrValue 匹配的源文本是Table 69 “Property name” 列中列出的字符串二进制属性，则为语法错误。
-
若该
UnicodePropertyValueExpression 的 MayContainStrings 为true ，则为语法错误。
-
若该
ClassContents 的 MayContainStrings 为true ，则为语法错误。
-
若该
ClassContents 的 MayContainStrings 为true ，则为语法错误。
-
若第一个
ClassSetCharacter 的 CharacterValue 严格大于第二个ClassSetCharacter 的 CharacterValue，则为语法错误。
22.2.1.2 静态语义：CountLeftCapturingParensWithin ( node )
The abstract operation ( 终结符匹配的任意 ( 模式字符。
本节在
It performs the following steps when called:
- 断言：node 是
RegExp 模式语法 中某个产生式实例。 - 返回 node 内包含的
Atom :: ( GroupSpecifier opt Disjunction ) 解析节点 的数量。
22.2.1.3 静态语义：CountLeftCapturingParensBefore ( node )
The abstract operation
本节在
It performs the following steps when called:
- 断言：node 是
RegExp 模式语法 中某个产生式实例。 - 令 pattern 为包含 node 的
Pattern 。 - 返回 pattern 中所有
Atom :: ( GroupSpecifier opt Disjunction ) 解析节点 里，出现在 node 之前或包含 node 的那些的数量。
22.2.1.4 静态语义：MightBothParticipate ( x, y )
The abstract operation
- 断言：x 与 y 具有相同的封闭
Pattern 。 - 若封闭
Pattern 中存在一个Disjunction :: Alternative | Disjunction 解析节点 ，使得 x 位于该Alternative 内而 y 位于其派生的Disjunction 内，或 x 位于派生的Disjunction 而 y 位于该Alternative 内，则返回false 。 - 返回
true 。
22.2.1.5 静态语义：CapturingGroupNumber
The syntax-directed operation
本节在
It is defined piecewise over the following productions:
- 返回
NonZeroDigit 的 MV。
- 令 n 为
DecimalDigits 中代码点数量。 - 返回 (
NonZeroDigit 的 MV × 10n 加上DecimalDigits 的 MV)。
“
22.2.1.6 静态语义：IsCharacterClass
The syntax-directed operation
本节在
It is defined piecewise over the following productions:
- 返回
false 。
- 返回
true 。
22.2.1.7 静态语义：CharacterValue
The syntax-directed operation
本节在
It is defined piecewise over the following productions:
- 返回 U+002D（连字号 HYPHEN-MINUS）的数值。
- 令 ch 为
SourceCharacter 匹配的代码点。 - 返回 ch 的数值。
- 返回 U+0008（BACKSPACE）的数值。
- 返回 U+002D（连字号 HYPHEN-MINUS）的数值。
- 按
Table 65 返回对应数值。
| 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> |
- 令 ch 为
AsciiLetter 匹配的代码点。 - 令 i 为 ch 的数值。
- 返回 i 除以 32 的余数。
- 返回 U+0000（NULL）的数值。
\0 表示 <NUL> 字符，且后面不能跟十进制数字。
- 返回
HexEscapeSequence 的 MV。
- 令 lead 为
HexLeadSurrogate 的 CharacterValue。 - 令 trail 为
HexTrailSurrogate 的 CharacterValue。 - 令 cp 为 UTF16SurrogatePairToCodePoint(lead, trail)。
- 返回 cp 的数值。
- 返回
Hex4Digits 的 MV。
- 返回
CodePoint 的 MV。
- 返回
Hex4Digits 的 MV。
- 令 ch 为
IdentityEscape 匹配的代码点。 - 返回 ch 的数值。
- 令 ch 为
SourceCharacter 匹配的代码点。 - 返回 ch 的数值。
- 令 ch 为
ClassSetReservedPunctuator 匹配的代码点。 - 返回 ch 的数值。
- 返回 U+0008（BACKSPACE）的数值。
22.2.1.8 静态语义：MayContainStrings
The syntax-directed operation
- 返回
false 。
- 若
LoneUnicodePropertyNameOrValue 匹配的源文本是Table 69 “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。
- 返回该
ClassSubtraction 的 MayContainStrings。
- 若该
ClassString 的 MayContainStrings 为true ，返回true 。 - 返回该
ClassStringDisjunctionContents 的 MayContainStrings。
- 返回
true 。
- 返回该
NonEmptyClassString 的 MayContainStrings。
- 若
NonEmptyClassString 存在，返回true 。 - 返回
false 。
22.2.1.9 静态语义：GroupSpecifiersThatMatch ( thisGroupName )
The abstract operation
- 令 name 为 thisGroupName 的 CapturingGroupName。
- 令 pattern 为包含 thisGroupName 的
Pattern 。 - 令 result 为新的空列表。
- 对 pattern 中的每个
GroupSpecifier gs，执行- 若 gs 的 CapturingGroupName 为 name，则
- 将 gs 追加至 result。
- 若 gs 的 CapturingGroupName 为 name，则
- 返回 result。
22.2.1.10 静态语义：CapturingGroupName
The syntax-directed operation
- 令 idTextUnescaped 为
RegExpIdentifierName 的 RegExpIdentifierCodePoints。 - 返回 CodePointsToString(idTextUnescaped)。
22.2.1.11 静态语义：RegExpIdentifierCodePoints
The syntax-directed operation
- 令 cp 为
RegExpIdentifierStart 的 RegExpIdentifierCodePoint。 - 返回 « cp »。
- 令 cps 为派生的
RegExpIdentifierName 的 RegExpIdentifierCodePoints。 - 令 cp 为
RegExpIdentifierPart 的 RegExpIdentifierCodePoint。 - 返回 cps 与 « cp » 的
列表拼接 。
22.2.1.12 静态语义：RegExpIdentifierCodePoint
The syntax-directed operation
- 返回
IdentifierStartChar 匹配的代码点。
- 返回
IdentifierPartChar 匹配的代码点。
- 返回其数值为
RegExpUnicodeEscapeSequence 的 CharacterValue 的代码点。
- 令 lead 为数值等于
UnicodeLeadSurrogate 匹配代码点数值的代码单元。 - 令 trail 为数值等于
UnicodeTrailSurrogate 匹配代码点数值的代码单元。 - 返回 UTF16SurrogatePairToCodePoint(lead, trail)。
22.2.2 模式语义（Pattern Semantics）
正则表达式模式通过下述过程被转换为一个抽象闭包（
一个 u 且不包含 v 时是一个 BMP 模式；否则是一个 Unicode 模式。BMP 模式针对被解释为由一系列 16 位值组成的字符串进行匹配，这些 16 位值是在基本多文种平面范围内的 Unicode 代码点。Unicode 模式针对被解释为由 UTF-16 编码的 Unicode 代码点组成的字符串进行匹配。在描述 BMP 模式行为的语境中，“character（字符）”指单个 16 位 Unicode BMP 代码点；在描述 Unicode 模式行为的语境中，“character” 指一个 UTF-16 编码的代码点（
例如，考虑一个在源文本中表示为单个非 BMP 字符 U+1D11E（MUSICAL SYMBOL G CLEF）的模式。作为 Unicode 模式解释时，它将是一个只含该代码点 U+1D11E 的单元素（字符）列表。然而，作为 BMP 模式解释时，它首先被 UTF-16 编码，产生一个包含代码单元 0xD834 和 0xDD1E 的双元素列表。
模式以 ECMAScript 字符串值的形式传给 RegExp
实现也许实际上不会执行这些到 UTF-16 之间的转换，但本规范语义要求匹配结果等效于执行了这些转换。
22.2.2.1 记号（Notation）
下述描述使用以下内部数据结构：
-
CharSetElement 是下列两种实体之一：
-
若 rer.[[UnicodeSets]] 为
false ，则 CharSetElement 是前述“模式语义”意义里的一个字符。 -
若 rer.[[UnicodeSets]] 为
true ，则 CharSetElement 是一个序列，其元素为前述“模式语义”意义里的字符。包含空序列、单字符序列以及多字符序列。为方便起见，处理此类 CharSetElement 时，单个字符与单字符序列可互换视之。
-
若 rer.[[UnicodeSets]] 为
- CharSet 是 CharSetElement 的数学集合。
-
CaptureRange 是一个记录 { [[StartIndex]], [[EndIndex]] }，表示一次捕获中包含的字符范围；[[StartIndex]] 是表示范围在 Input 中起始索引（含）的整数，[[EndIndex]] 是表示范围在 Input 中结束索引（不含）的整数。任意
CaptureRange 必须满足 [[StartIndex]] ≤ [[EndIndex]] 的不变量。 -
MatchState 是记录 { [[Input]], [[EndIndex]], [[Captures]] }，其中 [[Input]] 是表示被匹配字符串的字符列表，[[EndIndex]] 是一个整数，[[Captures]] 是一个值列表，对应模式中每个
左捕获括号 。MatchState 用于在正则表达式匹配算法中表示部分匹配状态。[[EndIndex]] 是当前模式已匹配的最后一个输入字符索引加 1；[[Captures]] 保存捕获括号的结果。[[Captures]] 的第 n 个元素要么是表示第 n 个捕获括号所捕获字符范围的CaptureRange ，要么在该捕获括号尚未到达时为undefined 。由于回溯，匹配过程中任意时刻可能存在多个MatchState 。 -
MatcherContinuation 是一个抽象闭包，接收一个
MatchState 参数，返回一个MatchState 或failure 。该闭包尝试从其MatchState 参数给出的中间状态起，将剩余（由闭包捕获的值指定）的模式部分与 Input 匹配。若匹配成功，返回达到的最终MatchState ；失败则返回failure 。 -
Matcher 是一个抽象闭包，接收两个参数——一个
MatchState 和一个MatcherContinuation ——返回一个MatchState 或failure 。Matcher 尝试从其MatchState 参数给出的中间状态起，将模式的一个中间子模式（由闭包捕获值指定）与该MatchState 的 [[Input]] 匹配。MatcherContinuation 参数应为匹配剩余模式的闭包。匹配子模式得到新的MatchState 后，Matcher 调用MatcherContinuation 测试剩余模式是否也能匹配。若可以，返回该MatcherContinuation 返回的MatchState ；否则Matcher 可以在其选择点尝试不同选择，不断调用MatcherContinuation ，直到成功或所有可能性耗尽。
22.2.2.1.1 RegExp 记录（RegExp Records）
RegExp 记录 是一个记录值，用于存储编译（并可能在匹配）过程中需要的 RegExp 信息。
其具有以下字段：
22.2.2.2 运行时语义：CompilePattern
The syntax-directed operation
- 令 m 为
Disjunction 的 CompileSubpattern，参数为 rer 与forward 。 - 返回一个新的抽象闭包，具参数 (Input, index)，捕获 rer 与 m，被调用时执行：
- 断言：Input 是字符列表。
- 断言：0 ≤ index ≤ Input 元素数量。
- 令 c 为新的
MatcherContinuation ，参数 (y)，捕获无，其执行：- 断言：y 是
MatchState 。 - 返回 y。
- 断言：y 是
- 令 cap 为一个长度为 rer.[[CapturingGroupsCount]] 的列表，索引 1..rer.[[CapturingGroupsCount]]，初值皆为
undefined 。 - 令 x 为
MatchState { [[Input]]: Input, [[EndIndex]]: index, [[Captures]]: cap }。 - 返回 m(x, c)。
一个 Pattern 编译成抽象闭包值。随后
22.2.2.3 运行时语义：CompileSubpattern
The syntax-directed operation
本节在
It is defined piecewise over the following productions:
- 令 m1 为
Alternative 的 CompileSubpattern，参数 rer 与 direction。 - 令 m2 为
Disjunction 的 CompileSubpattern，参数 rer 与 direction。 - 返回
MatchTwoAlternatives (m1, m2)。
| 运算符分隔两个候选。模式先尝试匹配左侧 | 跳过的部分中的捕获括号产生
/a|ab/.exec("abc")返回
/((a)|(ab))((c)|(bc))/.exec("abc")返回数组
["abc", "a", "a", undefined, "bc", undefined, "bc"]而非
["abc", "ab", undefined, "ab", "c", "c", undefined]两候选的尝试顺序与 direction 的值无关。
- 返回
EmptyMatcher ()。
- 令 m1 为
Alternative 的 CompileSubpattern，参数 rer 与 direction。 - 令 m2 为
Term 的 CompileSubpattern，参数 rer 与 direction。 - 返回
MatchSequence (m1, m2, direction)。
相邻的
- 返回
Assertion 的 CompileAssertion，参数 rer。
结果
- 返回
Atom 的 CompileAtom，参数 rer 与 direction。
- 令 m 为
Atom 的 CompileAtom，参数 rer 与 direction。 - 令 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, x, c, parenIndex, parenCount )
The abstract operation RepeatMatcher takes arguments m (一个
- 若 max = 0，返回 c(x)。
- 令 d 为新的
MatcherContinuation ，参数 (y)，捕获 m、min、max、greedy、x、c、parenIndex、parenCount，其执行：- 断言：y 是
MatchState 。 - 若 min = 0 且 y.[[EndIndex]] = x.[[EndIndex]]，返回
failure 。 - 若 min = 0，令 min2 为 0；否则令 min2 为 min - 1。
- 若 max = +∞，令 max2 为 +∞；否则令 max2 为 max - 1。
- 返回
RepeatMatcher (m, min2, max2, greedy, y, c, parenIndex, parenCount)。
- 断言：y 是
- 令 cap 为 x.[[Captures]] 的拷贝。
- 对
区间 parenIndex + 1 至 parenIndex + parenCount（含）内每个整数 k，设 cap[k] 为undefined 。 - 令 Input 为 x.[[Input]]。
- 令 e 为 x.[[EndIndex]]。
- 令 xr 为
MatchState { [[Input]]: Input, [[EndIndex]]: e, [[Captures]]: cap }。 - 若 min ≠ 0，返回 m(xr, d)。
- 若 greedy 为
false ，则- 令 z 为 c(x)。
- 若 z 不为
failure ，返回 z。 - 返回 m(xr, d)。
- 令 z 为 m(xr, d)。
- 若 z 不为
failure ，返回 z。 - 返回 c(x)。
若
比较：
/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 一个
- 返回新的
Matcher ，参数 (x, c)，捕获无，执行：- 断言：x 是
MatchState 。 - 断言：c 是
MatcherContinuation 。 - 返回 c(x)。
- 断言：x 是
22.2.2.3.3 MatchTwoAlternatives ( m1, m2 )
The abstract operation MatchTwoAlternatives takes arguments m1 (一个
- 返回新的
Matcher ，参数 (x, c)，捕获 m1 与 m2，执行：- 断言：x 是
MatchState 。 - 断言：c 是
MatcherContinuation 。 - 令 r 为 m1(x, c)。
- 若 r 不为
failure ，返回 r。 - 返回 m2(x, c)。
- 断言：x 是
22.2.2.3.4 MatchSequence ( m1, m2, direction )
The abstract operation MatchSequence takes arguments m1 (一个
- 若 direction 为
forward ，则- 返回新的
Matcher ，参数 (x, c)，捕获 m1、m2，执行：- 断言：x 是
MatchState 。 - 断言：c 是
MatcherContinuation 。 - 令 d 为新的
MatcherContinuation ，参数 (y)，捕获 c、m2，执行：- 断言：y 是
MatchState 。 - 返回 m2(y, c)。
- 断言：y 是
- 返回 m1(x, d)。
- 断言：x 是
- 返回新的
- 否则，
- 断言：direction 为
backward 。 - 返回新的
Matcher ，参数 (x, c)，捕获 m1、m2，执行：- 断言：x 是
MatchState 。 - 断言：c 是
MatcherContinuation 。 - 令 d 为新的
MatcherContinuation ，参数 (y)，捕获 c、m1，执行：- 断言：y 是
MatchState 。 - 返回 m1(y, c)。
- 断言：y 是
- 返回 m2(x, d)。
- 断言：x 是
- 断言：direction 为
22.2.2.4 运行时语义：CompileAssertion
The syntax-directed operation
本节在
It is defined piecewise over the following productions:
- 返回新的
Matcher ，参数 (x, c)，捕获 rer，执行：- 断言：x 是
MatchState 。 - 断言：c 是
MatcherContinuation 。 - 令 Input 为 x.[[Input]]。
- 令 e 为 x.[[EndIndex]]。
- 若 e = 0，或 (rer.[[Multiline]] 为
true 且字符 Input[e - 1] 被LineTerminator 匹配)，则- 返回 c(x)。
- 返回
failure 。
- 断言：x 是
即使使用 y 标志，^ 也只匹配 Input 的开始，或（若 rer.[[Multiline]] 为
- 返回新的
Matcher ，参数 (x, c)，捕获 rer，执行：- 断言：x 是
MatchState 。 - 断言：c 是
MatcherContinuation 。 - 令 Input 为 x.[[Input]]。
- 令 e 为 x.[[EndIndex]]。
- 令 InputLength 为 Input 元素数量。
- 若 e = InputLength，或 (rer.[[Multiline]] 为
true 且字符 Input[e] 被LineTerminator 匹配)，- 返回 c(x)。
- 返回
failure 。
- 断言：x 是
- 返回新的
Matcher ，参数 (x, c)，捕获 rer，执行：- 断言：x 是
MatchState 。 - 断言：c 是
MatcherContinuation 。 - 令 Input 为 x.[[Input]]。
- 令 e 为 x.[[EndIndex]]。
- 令 a 为
IsWordChar (rer, Input, e - 1)。 - 令 b 为
IsWordChar (rer, Input, e)。 - 若 (a 为
true 且 b 为false ) 或 (a 为false 且 b 为true )，返回 c(x)。 - 返回
failure 。
- 断言：x 是
- 返回新的
Matcher ，参数 (x, c)，捕获 rer，执行：- 断言：x 是
MatchState 。 - 断言：c 是
MatcherContinuation 。 - 令 Input 为 x.[[Input]]。
- 令 e 为 x.[[EndIndex]]。
- 令 a 为
IsWordChar (rer, Input, e - 1)。 - 令 b 为
IsWordChar (rer, Input, e)。 - 若 (a 为
true 且 b 为true ) 或 (a 为false 且 b 为false )，返回 c(x)。 - 返回
failure 。
- 断言：x 是
- 令 m 为
Disjunction 的 CompileSubpattern，参数 rer 与forward 。 - 返回新的
Matcher ，参数 (x, c)，捕获 m，执行：- 断言：x 是
MatchState 。 - 断言：c 是
MatcherContinuation 。 - 令 d 为新的
MatcherContinuation ，参数 (y)，捕获无，执行：- 断言：y 是
MatchState 。 - 返回 y。
- 断言：y 是
- 令 r 为 m(x, d)。
- 若 r 为
failure ，返回failure 。 - 断言：r 是
MatchState 。 - 令 cap 为 r.[[Captures]]。
- 令 Input 为 x.[[Input]]。
- 令 xe 为 x.[[EndIndex]]。
- 令 z 为
MatchState { [[Input]]: Input, [[EndIndex]]: xe, [[Captures]]: cap }。 - 返回 c(z)。
- 断言：x 是
(?= ) 是零宽正向先行断言。其成功要求 (?= 形式进行回溯（此异常行为源自 Perl）。仅当
例如：
/(?=(a+))/.exec("baaabac")在首个 b 之后的空字符串处匹配，返回：
["", "aaa"]为说明缺少回溯，考虑：
/(?=(a+))a*b\1/.exec("baaabac")该表达式返回
["aba", "a"]而非：
["aaaba", "a"]- 令 m 为
Disjunction 的 CompileSubpattern，参数 rer 与forward 。 - 返回新的
Matcher ，参数 (x, c)，捕获 m，执行：- 断言：x 是
MatchState 。 - 断言：c 是
MatcherContinuation 。 - 令 d 为新的
MatcherContinuation ，参数 (y)，捕获无，执行：- 断言：y 是
MatchState 。 - 返回 y。
- 断言：y 是
- 令 r 为 m(x, d)。
- 若 r 不为
failure ，返回failure 。 - 返回 c(x)。
- 断言：x 是
(?! ) 是零宽负向先行断言。其成功要求
/(.*?)a(?!(a+)b\2c)\2(.*)/.exec("baaabaac")寻找一个 a，其后不紧跟着若干（正数 n）个 a、一个 b、再 n 个 a（由第一个 \2 指定）以及一个 c。第二个 \2 在负向先行外，匹配
["baaabaac", "ba", undefined, "abaac"]- 令 m 为
Disjunction 的 CompileSubpattern，参数 rer 与backward 。 - 返回新的
Matcher ，参数 (x, c)，捕获 m，执行：- 断言：x 是
MatchState 。 - 断言：c 是
MatcherContinuation 。 - 令 d 为新的
MatcherContinuation ，参数 (y)，捕获无，执行：- 断言：y 是
MatchState 。 - 返回 y。
- 断言：y 是
- 令 r 为 m(x, d)。
- 若 r 为
failure ，返回failure 。 - 断言：r 是
MatchState 。 - 令 cap 为 r.[[Captures]]。
- 令 Input 为 x.[[Input]]。
- 令 xe 为 x.[[EndIndex]]。
- 令 z 为
MatchState { [[Input]]: Input, [[EndIndex]]: xe, [[Captures]]: cap }。 - 返回 c(z)。
- 断言：x 是
- 令 m 为
Disjunction 的 CompileSubpattern，参数 rer 与backward 。 - 返回新的
Matcher ，参数 (x, c)，捕获 m，执行：- 断言：x 是
MatchState 。 - 断言：c 是
MatcherContinuation 。 - 令 d 为新的
MatcherContinuation ，参数 (y)，捕获无，执行：- 断言：y 是
MatchState 。 - 返回 y。
- 断言：y 是
- 令 r 为 m(x, d)。
- 若 r 不为
failure ，返回failure 。 - 返回 c(x)。
- 断言：x 是
22.2.2.4.1 IsWordChar ( rer, Input, e )
The abstract operation IsWordChar takes arguments rer (一个
- 令 InputLength 为 Input 元素数量。
- 若 e = -1 或 e = InputLength，返回
false 。 - 令 c 为字符 Input[e]。
- 若
WordCharacters (rer) 包含 c，返回true 。 - 返回
false 。
22.2.2.5 运行时语义：CompileQuantifier
The syntax-directed operation
- 令 qp 为
QuantifierPrefix 的 CompileQuantifierPrefix。 - 返回记录 { [[Min]]: qp.[[Min]], [[Max]]: qp.[[Max]], [[Greedy]]:
true }。
- 令 qp 为
QuantifierPrefix 的 CompileQuantifierPrefix。 - 返回记录 { [[Min]]: qp.[[Min]], [[Max]]: qp.[[Max]], [[Greedy]]:
false }。
22.2.2.6 运行时语义：CompileQuantifierPrefix
The syntax-directed operation
- 返回记录 { [[Min]]: 0, [[Max]]: +∞ }。
- 返回记录 { [[Min]]: 1, [[Max]]: +∞ }。
- 返回记录 { [[Min]]: 0, [[Max]]: 1 }。
- 令 i 为
DecimalDigits 的 MV（参见12.9.3 ）。 - 返回记录 { [[Min]]: i, [[Max]]: i }。
- 令 i 为
DecimalDigits 的 MV。 - 返回记录 { [[Min]]: i, [[Max]]: +∞ }。
- 令 i 为第一组
DecimalDigits 的 MV。 - 令 j 为第二组
DecimalDigits 的 MV。 - 返回记录 { [[Min]]: i, [[Max]]: j }。
22.2.2.7 运行时语义：CompileAtom
The syntax-directed operation
本节在
It is defined piecewise over the following productions:
- 令 ch 为
PatternCharacter 匹配的字符。 - 令 A 为包含字符 ch 的单元素
CharSet 。 - 返回
CharacterSetMatcher (rer, A,false , direction)。
- 令 A 为
AllCharacters (rer)。 - 若 rer.[[DotAll]] 不为
true ，则- 从 A 中移除所有对应
LineTerminator 产生式右侧代码点的字符。
- 从 A 中移除所有对应
- 返回
CharacterSetMatcher (rer, A,false , direction)。
- 令 cc 为
CharacterClass 的 CompileCharacterClass，参数 rer。 - 令 cs 为 cc.[[CharSet]]。
- 若 rer.[[UnicodeSets]] 为
false ，或 cs 的每个CharSetElement 都是单字符（包括 cs 为空），返回CharacterSetMatcher (rer, cs, cc.[[Invert]], direction)。 - 断言：cc.[[Invert]] 为
false 。 - 令 lm 为空的
Matcher 列表。 - 对 cs 中每个包含超过 1 个字符的
CharSetElement s（按长度降序）：- 令 cs2 为仅含 s 最后代码点的单元素
CharSet 。 - 令 m2 为
CharacterSetMatcher (rer, cs2,false , direction)。 - 对 s 中每个代码点 c1（从倒数第二个向前迭代）：
- 令 cs1 为仅含 c1 的单元素
CharSet 。 - 令 m1 为
CharacterSetMatcher (rer, cs1,false , direction)。 - 设 m2 为
MatchSequence (m1, m2, direction)。
- 令 cs1 为仅含 c1 的单元素
- 将 m2 追加入 lm。
- 令 cs2 为仅含 s 最后代码点的单元素
- 令 singles 为包含 cs 中所有单字符
CharSetElement 的CharSet 。 - 将
CharacterSetMatcher (rer, singles,false , direction) 追加入 lm。 - 若 cs 含空字符序列，将
EmptyMatcher () 追加入 lm。 - 令 m2 为 lm 中最后一个
Matcher 。 - 对 lm 中每个
Matcher m1（自倒数第二个向前）：- 设 m2 为
MatchTwoAlternatives (m1, m2)。
- 设 m2 为
- 返回 m2。
- 令 m 为
Disjunction 的 CompileSubpattern，参数 rer 与 direction。 - 令 parenIndex 为 CountLeftCapturingParensBefore(
Atom )。 - 返回新
Matcher ，参数 (x, c)，捕获 direction、m、parenIndex，执行：- 断言：x 是
MatchState 。 - 断言：c 是
MatcherContinuation 。 - 令 d 为新的
MatcherContinuation ，参数 (y)，捕获 x、c、direction、parenIndex，执行：- 断言：y 是
MatchState 。 - 令 cap 为 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 为
- 设 cap[parenIndex + 1] = r。
- 令 z 为
MatchState { [[Input]]: Input, [[EndIndex]]: ye, [[Captures]]: cap }。 - 返回 c(z)。
- 断言：y 是
- 返回 m(x, d)。
- 断言：x 是
( ) 形式的括号既分组 \ 加非零十进制数）、替换字符串引用，或作为正则匹配抽象闭包返回数组的一部分。若要禁止捕获行为，使用 (?: )。
- 令 addModifiers 为
RegularExpressionModifiers 匹配的源文本。 - 令 removeModifiers 为空字符串。
- 令 modifiedRer 为
UpdateModifiers (rer, CodePointsToString(addModifiers), removeModifiers)。 - 返回
Disjunction 的 CompileSubpattern，参数 modifiedRer 与 direction。
- 令 addModifiers 为第一个
RegularExpressionModifiers 匹配的源文本。 - 令 removeModifiers 为第二个
RegularExpressionModifiers 匹配的源文本。 - 令 modifiedRer 为
UpdateModifiers (rer, CodePointsToString(addModifiers), CodePointsToString(removeModifiers))。 - 返回
Disjunction 的 CompileSubpattern，参数 modifiedRer 与 direction。
- 令 n 为
DecimalEscape 的 CapturingGroupNumber。 - 断言：n ≤ rer.[[CapturingGroupsCount]]。
- 返回
BackreferenceMatcher (rer, « n », direction)。
\ 后随非零十进制数字 n 的转义序列匹配第 n 组捕获括号的结果（
- 令 cv 为
CharacterEscape 的 CharacterValue。 - 令 ch 为字符值为 cv 的字符。
- 令 A 为包含 ch 的单元素
CharSet 。- 返回
CharacterSetMatcher (rer, A,false , direction)。
- 返回
- 令 cs 为
CharacterClassEscape 的 CompileToCharSet，参数 rer。 - 若 rer.[[UnicodeSets]] 为
false ，或 cs 的每个CharSetElement 都是单字符（含空），返回CharacterSetMatcher (rer, cs,false , direction)。 - 令 lm 为空
Matcher 列表。 - 对 cs 中每个含多于 1 字符的
CharSetElement s（按长度降序）：- 令 cs2 为仅含 s 最后代码点的单元素
CharSet 。 - 令 m2 为
CharacterSetMatcher (rer, cs2,false , direction)。 - 对 s 中每个代码点 c1（自倒数第二个向前）：
- 令 cs1 为仅含 c1 的
CharSet 。 - 令 m1 为
CharacterSetMatcher (rer, cs1,false , direction)。 - 设 m2 为
MatchSequence (m1, m2, direction)。
- 令 cs1 为仅含 c1 的
- 将 m2 追加入 lm。
- 令 cs2 为仅含 s 最后代码点的单元素
- 令 singles 为包含 cs 中所有单字符元素的
CharSet 。 - 将
CharacterSetMatcher (rer, singles,false , direction) 追加入 lm。 - 若 cs 含空序列，将
EmptyMatcher () 追加入 lm。 - 令 m2 为 lm 最末
Matcher 。 - 对 lm 中每个 m1（自倒数第二向前）：
- 设 m2 为
MatchTwoAlternatives (m1, m2)。
- 设 m2 为
- 返回 m2。
- 令 matchingGroupSpecifiers 为 GroupSpecifiersThatMatch(
GroupName )。 - 令 parenIndices 为新空列表。
- 对 matchingGroupSpecifiers 中每个
GroupSpecifier groupSpecifier：- 令 parenIndex 为 CountLeftCapturingParensBefore(groupSpecifier)。
- 将 parenIndex 追加入 parenIndices。
- 返回
BackreferenceMatcher (rer, parenIndices, direction)。
22.2.2.7.1 CharacterSetMatcher ( rer, A, invert, direction )
The abstract operation CharacterSetMatcher takes arguments rer (一个
- 若 rer.[[UnicodeSets]] 为
true ，则- 断言：invert 为
false 。 - 断言：A 的每个
CharSetElement 皆为单字符。
- 断言：invert 为
- 返回新的
Matcher ，参数 (x, c)，捕获 rer、A、invert、direction，执行：- 断言：x 是
MatchState 。 - 断言：c 是
MatcherContinuation 。 - 令 Input 为 x.[[Input]]。
- 令 e 为 x.[[EndIndex]]。
- 若 direction 为
forward ，令 f = e + 1。 - 否则令 f = e - 1。
- 令 InputLength 为 Input 元素数量。
- 若 f < 0 或 f > InputLength，返回
failure 。 - 令 index =
min (e, f)。 - 令 ch 为字符 Input[index]。
- 令 cc =
Canonicalize (rer, ch)。 - 若存在 A 中某
CharSetElement 含恰一字符 a 且Canonicalize (rer, a) = cc，令 found =true ；否则 found =false 。 - 若 invert =
false 且 found =false ，返回failure 。 - 若 invert =
true 且 found =true ，返回failure 。 - 令 cap 为 x.[[Captures]]。
- 令 y 为
MatchState { [[Input]]: Input, [[EndIndex]]: f, [[Captures]]: cap }。 - 返回 c(y)。
- 断言：x 是
22.2.2.7.2 BackreferenceMatcher ( rer, ns, direction )
The abstract operation BackreferenceMatcher takes arguments rer (一个
- 返回新的
Matcher ，参数 (x, c)，捕获 rer、ns、direction，执行：- 断言：x 是
MatchState 。 - 断言：c 是
MatcherContinuation 。 - 令 Input 为 x.[[Input]]。
- 令 cap 为 x.[[Captures]]。
- 令 r 为
undefined 。 - 对 ns 中每个整数 n：
- 若 cap[n] 不为
undefined ，则- 断言：r 为
undefined 。 - 设 r = cap[n]。
- 断言：r 为
- 若 cap[n] 不为
- 若 r 为
undefined ，返回 c(x)。 - 令 e 为 x.[[EndIndex]]。
- 令 rs 为 r.[[StartIndex]]。
- 令 re 为 r.[[EndIndex]]。
- 令 len = re - rs。
- 若 direction 为
forward ，令 f = e + len；否则 f = e - len。 - 令 InputLength 为 Input 元素数量。
- 若 f < 0 或 f > InputLength，返回
failure 。 - 令 g =
min (e, f)。 - 若存在
区间 [0, len) 内整数 i 使Canonicalize (rer, Input[rs + i]) ≠Canonicalize (rer, Input[g + i])，返回failure 。 - 令 y 为
MatchState { [[Input]]: Input, [[EndIndex]]: f, [[Captures]]: cap }。 - 返回 c(y)。
- 断言：x 是
22.2.2.7.3 Canonicalize ( rer, ch )
The abstract operation Canonicalize takes arguments rer (一个
- 若
HasEitherUnicodeFlag (rer) 为true 且 rer.[[IgnoreCase]] 为true ，则- 若 Unicode 字符数据库文件
CaseFolding.txt为 ch 提供简单或常用大小写折叠映射，则返回应用该映射后的 ch。 - 返回 ch。
- 若 Unicode 字符数据库文件
- 若 rer.[[IgnoreCase]] 为
false ，返回 ch。 - 断言：ch 是 UTF-16 代码单元。
- 令 cp 为数值等于 ch 数值的代码点。
- 令 u 为根据 Unicode 默认大小写转换算法 toUppercase(« cp ») 的结果。
- 令 uStr 为 CodePointsToString(u)。
- 若 uStr 长度 ≠ 1，返回 ch。
- 令 cu 为 uStr 的单个代码单元。
- 若 ch 数值 ≥ 128 且 cu 数值 < 128，返回 ch。
- 返回 cu。
在 ß 映射到 ss/SS。但可将非 Basic Latin 代码点映射到该块内，如 ſ 折叠到 s，K 折叠到 k。包含这些代码点的字符串可被 /[a-z]/ui 匹配。
在 Ω 被 toUppercase 映射为自身，但 toCasefold 映射为 ω，与 Ω 一起；因此 /[ω]/ui 与 /[\u03A9]/ui 匹配，却不被 /[ω]/i 或 /[\u03A9]/i 匹配。且无 Basic Latin 外代码点映射进该块，所以 /[a-z]/i 匹配。
22.2.2.7.4 UpdateModifiers ( rer, add, remove )
The abstract operation UpdateModifiers takes arguments rer (一个
- 断言：add 与 remove 不含共同元素。
- 令 ignoreCase = rer.[[IgnoreCase]]。
- 令 multiline = rer.[[Multiline]]。
- 令 dotAll = rer.[[DotAll]]。
- 令 unicode = rer.[[Unicode]]。
- 令 unicodeSets = rer.[[UnicodeSets]]。
- 令 capturingGroupsCount = rer.[[CapturingGroupsCount]]。
- 若 remove 含
"i" ，设 ignoreCase =false ；否则若 add 含"i" ，设其为true 。 - 若 remove 含
"m" ，设 multiline =false ；否则若 add 含"m" ，设其为true 。 - 若 remove 含
"s" ，设 dotAll =false ；否则若 add 含"s" ，设其为true 。 - 返回
RegExp 记录 { [[IgnoreCase]]: ignoreCase, [[Multiline]]: multiline, [[DotAll]]: dotAll, [[Unicode]]: unicode, [[UnicodeSets]]: unicodeSets, [[CapturingGroupsCount]]: capturingGroupsCount }。
22.2.2.8 运行时语义：CompileCharacterClass
The syntax-directed operation
- 令 A 为
ClassContents 的 CompileToCharSet，参数 rer。 - 返回记录 { [[CharSet]]: A, [[Invert]]:
false }。
- 令 A 为
ClassContents 的 CompileToCharSet，参数 rer。 - 若 rer.[[UnicodeSets]] 为
true ，则- 返回记录 { [[CharSet]]:
CharacterComplement (rer, A), [[Invert]]:false }。
- 返回记录 { [[CharSet]]:
- 返回记录 { [[CharSet]]: A, [[Invert]]:
true }。
22.2.2.9 运行时语义：CompileToCharSet
The syntax-directed operation
本节在
It is defined piecewise over the following productions:
- 返回空
CharSet 。
- 令 A 为
ClassAtom 的 CompileToCharSet，参数 rer。 - 令 B 为
NonemptyClassRangesNoDash 的 CompileToCharSet，参数 rer。 - 返回 A 与 B 的并集。
- 令 A 为第一个
ClassAtom 的 CompileToCharSet，参数 rer。 - 令 B 为第二个
ClassAtom 的 CompileToCharSet，参数 rer。 - 令 C 为
ClassContents 的 CompileToCharSet，参数 rer。 - 令 D 为
CharacterRange (A, B)。 - 返回 D 与 C 的并集。
- 令 A 为
ClassAtomNoDash 的 CompileToCharSet，参数 rer。 - 令 B 为
NonemptyClassRangesNoDash 的 CompileToCharSet，参数 rer。 - 返回 A 与 B 的并集。
- 令 A 为
ClassAtomNoDash 的 CompileToCharSet，参数 rer。 - 令 B 为
ClassAtom 的 CompileToCharSet，参数 rer。 - 令 C 为
ClassContents 的 CompileToCharSet，参数 rer。 - 令 D 为
CharacterRange (A, B)。 - 返回 D 与 C 的并集。
即便模式忽略大小写，范围两端大小写仍影响范围所含字符。例如 /[E-F]/i 只匹配 E、F、e、f，而 /[E-f]/i 匹配 Basic Latin 中所有大小写字母以及符号 [, \, ], ^, _, `。
- 可字面或作范围界定符。位于
- 返回含单字符
-U+002D 的CharSet 。
- 返回含
SourceCharacter 匹配字符的CharSet 。
- 令 cv 为此
ClassEscape 的 CharacterValue。 - 令 c 为字符值为 cv 的字符。
- 返回含单字符 c 的
CharSet 。
\b、\B、反向引用外的其他正则转义。在 \b 表示退格，\B 与反向引用报错；在
- 返回含字符
0..9的十元素CharSet 。
- 令 S 为
CharacterClassEscape :: d CharSet 。 - 返回
CharacterComplement (rer, S)。
- 返回含
WhiteSpace 或LineTerminator 产生式右侧代码点对应字符的CharSet 。
- 令 S 为
CharacterClassEscape :: s CharSet 。 - 返回
CharacterComplement (rer, S)。
- 返回
MaybeSimpleCaseFolding (rer,WordCharacters (rer))。
- 令 S 为
CharacterClassEscape :: w CharSet 。 - 返回
CharacterComplement (rer, S)。
- 返回
UnicodePropertyValueExpression 的 CompileToCharSet，参数 rer。
- 令 S 为
UnicodePropertyValueExpression 的 CompileToCharSet，参数 rer。 - 断言：S 仅含单代码点。
- 返回
CharacterComplement (rer, S)。
- 令 ps 为
UnicodePropertyName 匹配的源文本。 - 令 p 为
UnicodeMatchProperty (rer, ps)。 - 断言：p 是
Table 67 “Property name and aliases” 列列出的属性名 或别名。 - 令 vs 为
UnicodePropertyValue 匹配的源文本。 - 令 v 为
UnicodeMatchPropertyValue (p, vs)。 - 令 A 为含所有在字符数据库定义中具属性 p 且值 v 的 Unicode 代码点的
CharSet 。 - 返回
MaybeSimpleCaseFolding (rer, A)。
- 令 s 为
LoneUnicodePropertyNameOrValue 匹配的源文本。 - 若
UnicodeMatchPropertyValue (General_Category, s) 为 General_Category 属性的属性值或别名（见PropertyValueAliases.txt），则- 返回含字符数据库中属性 “General_Category” = s 的所有 Unicode 代码点的
CharSet 。
- 返回含字符数据库中属性 “General_Category” = s 的所有 Unicode 代码点的
- 令 p 为
UnicodeMatchProperty (rer, s)。 - 断言：p 是
Table 68 “Property name and aliases” 列列出的二进制属性或别名，或Table 69 “Property name” 列列出的字符串二进制属性。 - 令 A 为含所有字符数据库定义中属性 p = “True” 的
CharSetElement 的CharSet 。 - 返回
MaybeSimpleCaseFolding (rer, A)。
- 令 A 为
ClassSetRange 的 CompileToCharSet，参数 rer。 - 若
ClassUnion 存在，则- 令 B 为
ClassUnion 的 CompileToCharSet，参数 rer。 - 返回 A ∪ B。
- 令 B 为
- 返回 A。
- 令 A 为
ClassSetOperand 的 CompileToCharSet，参数 rer。 - 若
ClassUnion 存在，则- 令 B 为
ClassUnion 的 CompileToCharSet，参数 rer。 - 返回 A ∪ B。
- 令 B 为
- 返回 A。
- 令 A 为第一个
ClassSetOperand 的 CompileToCharSet，参数 rer。 - 令 B 为第二个
ClassSetOperand 的 CompileToCharSet，参数 rer。 - 返回 A ∩ B。
- 令 A 为
ClassIntersection 的 CompileToCharSet，参数 rer。 - 令 B 为
ClassSetOperand 的 CompileToCharSet，参数 rer。 - 返回 A ∩ B。
- 令 A 为第一个
ClassSetOperand 的 CompileToCharSet，参数 rer。 - 令 B 为第二个
ClassSetOperand 的 CompileToCharSet，参数 rer。 - 返回含 A 中不在 B 中的元素的
CharSet 。
- 令 A 为
ClassSubtraction 的 CompileToCharSet，参数 rer。 - 令 B 为
ClassSetOperand 的 CompileToCharSet，参数 rer。 - 返回含 A 中不在 B 中元素的
CharSet 。
- 令 A 为第一个
ClassSetCharacter 的 CompileToCharSet，参数 rer。 - 令 B 为第二个
ClassSetCharacter 的 CompileToCharSet，参数 rer。 - 返回
MaybeSimpleCaseFolding (rer,CharacterRange (A, B))。
结果通常由多段范围组成。当 UnicodeSets 与 IgnoreCase 同为
- 令 A 为
ClassSetCharacter 的 CompileToCharSet，参数 rer。 - 返回
MaybeSimpleCaseFolding (rer, A)。
- 令 A 为
ClassStringDisjunction 的 CompileToCharSet，参数 rer。 - 返回
MaybeSimpleCaseFolding (rer, A)。
- 返回
NestedClass 的 CompileToCharSet，参数 rer。
- 返回
ClassContents 的 CompileToCharSet，参数 rer。
- 令 A 为
ClassContents 的 CompileToCharSet，参数 rer。 - 返回
CharacterComplement (rer, A)。
- 返回
CharacterClassEscape 的 CompileToCharSet，参数 rer。
- 返回
ClassStringDisjunctionContents 的 CompileToCharSet，参数 rer。
- 令 s 为
ClassString 的 CompileClassSetString，参数 rer。 - 返回含唯一字符串 s 的
CharSet 。
- 令 s 为
ClassString 的 CompileClassSetString，参数 rer。 - 令 A 为含字符串 s 的
CharSet 。 - 令 B 为
ClassStringDisjunctionContents 的 CompileToCharSet，参数 rer。 - 返回 A 与 B 的并集。
- 令 cv 为此
ClassSetCharacter 的 CharacterValue。 - 令 c 为字符值为 cv 的字符。
- 返回含单字符 c 的
CharSet 。
- 返回含单字符 U+0008 (BACKSPACE) 的
CharSet 。
22.2.2.9.1 CharacterRange ( A, B )
The abstract operation CharacterRange takes arguments A (一个
- 断言：A 与 B 各含恰一字符。
- 令 a 为 A 中该字符。
- 令 b 为 B 中该字符。
- 令 i 为 a 的字符值。
- 令 j 为 b 的字符值。
- 断言：i ≤ j。
- 返回含所有字符值位于 [i, j] 间（含）的字符集合的
CharSet 。
22.2.2.9.2 HasEitherUnicodeFlag ( rer )
The abstract operation HasEitherUnicodeFlag takes argument rer (一个
- 若 rer.[[Unicode]] 为
true 或 rer.[[UnicodeSets]] 为true ，- 返回
true 。
- 返回
- 返回
false 。
22.2.2.9.3 WordCharacters ( rer )
The abstract operation WordCharacters takes argument rer (一个 \b、\B、\w、\W 之“单词字符”的
- 令 basicWordChars 为含所有 ASCII 单词字符的
CharSet 。 - 令 extraWordChars 为
CharSet ，包含所有不在 basicWordChars 中但Canonicalize (rer, c) 在其中的字符 c。 - 断言：除非
HasEitherUnicodeFlag (rer) 为true 且 rer.[[IgnoreCase]] 为true ，否则 extraWordChars 为空。 - 返回 basicWordChars 与 extraWordChars 的并集。
22.2.2.9.4 AllCharacters ( rer )
The abstract operation AllCharacters takes argument rer (一个
- 若 rer.[[UnicodeSets]] 为
true 且 rer.[[IgnoreCase]] 为true ，则- 返回含所有 Unicode 代码点 c 且其 Simple Case Folding 映射为空（
scf (c) = c）的CharSet 。
- 返回含所有 Unicode 代码点 c 且其 Simple Case Folding 映射为空（
- 否则若
HasEitherUnicodeFlag (rer) 为true ，- 返回含所有代码点值的
CharSet 。
- 返回含所有代码点值的
- 否则，
- 返回含所有代码单元值的
CharSet 。
- 返回含所有代码单元值的
22.2.2.9.5 MaybeSimpleCaseFolding ( rer, A )
The abstract operation MaybeSimpleCaseFolding takes arguments rer (一个
- 若 rer.[[UnicodeSets]] 为
false 或 rer.[[IgnoreCase]] 为false ，返回 A。 - 令 B 为新空
CharSet 。 - 对 A 的每个
CharSetElement s：- 令 t 为空字符序列。
- 对 s 中每个单代码点 cp：
- 追加
scf (cp) 至 t。
- 追加
- 将 t 加入 B。
- 返回 B。
22.2.2.9.6 CharacterComplement ( rer, S )
The abstract operation CharacterComplement takes arguments rer (一个
- 令 A 为
AllCharacters (rer)。 - 返回含 A 中不在 S 中的
CharSetElement 的CharSet 。
22.2.2.9.7 UnicodeMatchProperty ( rer, p )
The abstract operation UnicodeMatchProperty takes arguments rer (一个
实现必须支持
例如，Script_Extensions 与 scx 有效，但 script_extensions 或 Scx 无效。
列出属性集合为 UTS18 RL1.2 要求的超集。
表中条目拼写（含大小写）与 Unicode 字符数据库 PropertyAliases.txt 保持一致，并遵守其稳定性保证。
| Property name and aliases | Canonical property name |
|---|---|
General_Category |
General_Category |
gc |
|
Script |
Script |
sc |
|
Script_Extensions |
Script_Extensions |
scx |
| Property name and aliases | Canonical property name |
|---|---|
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 |
| Property name |
|---|
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 (ECMAScript 源文本) and v (ECMAScript 源文本) and returns 一个 Unicode 属性值. It performs the following steps when called:
- 断言：p 为
Table 67 “Canonical property name” 列列出的规范非别名属性名 。 - 断言：v 是文件
PropertyValueAliases.txt中属性 p 的属性值或别名。 - 令 value 为该行 “Canonical property value” 列中 v 的规范属性值。
- 返回 Unicode 代码点列表 value。
实现必须支持 PropertyValueAliases.txt 中针对
例如，Xpeo 与 Old_Persian 是有效的 Script_Extensions 值，而 xpeo 与 Old Persian 无效。
该算法不同于 UAX44 中符号值匹配规则：不会忽略大小写、空白、U+002D、U+005F，也不支持 Is 前缀。
22.2.2.10 运行时语义：CompileClassSetString
The syntax-directed operation
- 返回空字符序列。
- 返回
NonEmptyClassString 的 CompileClassSetString，参数 rer。
- 令 cs 为
ClassSetCharacter 的 CompileToCharSet，参数 rer。 - 令 s1 为 cs 的单个
CharSetElement 所对应的字符序列。 - 若
NonEmptyClassString 存在，则- 令 s2 为
NonEmptyClassString 的 CompileClassSetString，参数 rer。 - 返回 s1 与 s2 的连接。
- 令 s2 为
- 返回 s1。
22.2.3 用于创建 RegExp 的抽象操作（Abstract Operations for RegExp Creation）
22.2.3.1 RegExpCreate ( P, F )
The abstract operation RegExpCreate takes arguments P (一个
- 令 obj 为 !
RegExpAlloc (%RegExp% )。 - 返回 ?
RegExpInitialize (obj, P, F)。
22.2.3.2 RegExpAlloc ( newTarget )
The abstract operation RegExpAlloc takes argument newTarget (一个
- 令 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 (一个对象), pattern (一个
- 如果 pattern 是
undefined ，令 P 为空字符串。 - 否则，令 P 为 ?
ToString (pattern)。 - 如果 flags 是
undefined ，令 F 为空字符串。 - 否则，令 F 为 ?
ToString (flags)。 - 如果 F 包含
"d" 、"g" 、"i" 、"m" 、"s" 、"u" 、"v" 、"y" 之外的任一代码单元，或 F 中任一代码单元出现多于一次，抛出SyntaxError 异常。 - 如果 F 包含
"i" ，令 i 为true ；否则令 i 为false 。 - 如果 F 包含
"m" ，令 m 为true ；否则令 m 为false 。 - 如果 F 包含
"s" ，令 s 为true ；否则令 s 为false 。 - 如果 F 包含
"u" ，令 u 为true ；否则令 u 为false 。 - 如果 F 包含
"v" ，令 v 为true ；否则令 v 为false 。 - 如果 u 为
true 或 v 为true ，则- 令 patternText 为 StringToCodePoints(P)。
- 否则，
- 令 patternText 为将 P 的每个 16 位元素按 Unicode BMP 代码点解释的结果。不会对这些元素应用 UTF-16 解码。
- 令 parseResult 为 ParsePattern(patternText, u, v)。
- 如果 parseResult 是一个非空
SyntaxError 对象列表，抛出SyntaxError 异常。 - 断言：parseResult 是一个
Pattern 解析节点 。 - 设 obj.[[OriginalSource]] 为 P。
- 设 obj.[[OriginalFlags]] 为 F。
- 令 capturingGroupsCount 为 CountLeftCapturingParensWithin(parseResult)。
- 令 rer 为
RegExp 记录 { [[IgnoreCase]]: i, [[Multiline]]: m, [[DotAll]]: s, [[Unicode]]: u, [[UnicodeSets]]: v, [[CapturingGroupsCount]]: capturingGroupsCount }。 - 设 obj.[[RegExpRecord]] 为 rer。
- 设 obj.[[RegExpMatcher]] 为 CompilePattern of parseResult with argument rer。
- 执行 ?
Set (obj,"lastIndex" ,+0 𝔽,true )。 - 返回 obj。
22.2.3.4 静态语义：ParsePattern ( patternText, u, v )
The abstract operation
本节在
It performs the following steps when called:
- 如果 v 为
true 且 u 为true ，则- 令 parseResult 为包含一个或多个
SyntaxError 对象的列表。
- 令 parseResult 为包含一个或多个
- 否则如果 v 为
true ，则- 令 parseResult 为 ParseText(patternText,
Pattern )。[+UnicodeMode, +UnicodeSetsMode, +NamedCaptureGroups]
- 令 parseResult 为 ParseText(patternText,
- 否则如果 u 为
true ，则- 令 parseResult 为 ParseText(patternText,
Pattern )。[+UnicodeMode, ~UnicodeSetsMode, +NamedCaptureGroups]
- 令 parseResult 为 ParseText(patternText,
- 否则，
- 令 parseResult 为 ParseText(patternText,
Pattern )。[~UnicodeMode, ~UnicodeSetsMode, +NamedCaptureGroups]
- 令 parseResult 为 ParseText(patternText,
- 返回 parseResult。
22.2.4 RegExp 构造函数（The RegExp Constructor）
RegExp
- 是 %RegExp%。
- 是全局对象
"RegExp" 属性的初始值。 - 作为
构造函数 调用时创建并初始化一个新的 RegExp 对象。 - 作为函数（而非
构造函数 ）调用时，返回一个新的 RegExp 对象，或在唯一参数本身是 RegExp 对象时返回该参数。 - 可用作类定义
extends子句的值。打算继承指定 RegExp 行为的子类构造函数 必须包含对 RegExp构造函数 的super调用，以创建并初始化带有所需内部槽的子类实例。
22.2.4.1 RegExp ( pattern, flags )
调用该函数时执行以下步骤：
- 令 patternIsRegExp 为 ?
IsRegExp (pattern)。 - 如果 NewTarget 为
undefined ，则 - 否则，
- 令 newTarget 为 NewTarget。
- 如果 pattern 是一个对象且具有 [[RegExpMatcher]] 内部槽，则
- 令 P 为 pattern.[[OriginalSource]]。
- 如果 flags 是
undefined ，令 F 为 pattern.[[OriginalFlags]]。 - 否则，令 F 为 flags。
- 否则如果 patternIsRegExp 为
true ，则 - 否则，
- 令 P 为 pattern。
- 令 F 为 flags。
- 令 O 为 ?
RegExpAlloc (newTarget)。 - 返回 ?
RegExpInitialize (O, P, F)。
如果以
22.2.5 RegExp 构造函数的属性（Properties of the RegExp Constructor）
RegExp
- 有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
22.2.5.1 RegExp.escape ( S )
该函数返回 S 的一个拷贝，其中在正则表达式
调用时执行以下步骤：
- 如果 S 不是字符串，抛出
TypeError 异常。 - 令 escaped 为空字符串。
- 令 cpList 为 StringToCodePoints(S)。
- 对 cpList 中的每个代码点 cp，执行
- 如果 escaped 为空字符串且 cp 被
DecimalDigit 或AsciiLetter 匹配，则- 注：转义前导数字确保输出对应的模式文本可在
\0字符转义或DecimalEscape （如\1）之后使用并仍匹配 S，而不是被解释为前一转义序列的延伸。转义前导 ASCII 字母在\c后的情境中亦如此。 - 令 numericValue 为 cp 的数值。
- 令 hex 为
Number::toString (𝔽 (numericValue), 16)。 - 断言：hex 的长度为 2。
- 设 escaped 为 代码单元 0x005C (REVERSE SOLIDUS)、
"x" 与 hex 的字符串拼接。
- 注：转义前导数字确保输出对应的模式文本可在
- 否则，
- 设 escaped 为 escaped 与
EncodeForRegExpEscape (cp) 的字符串拼接。
- 设 escaped 为 escaped 与
- 如果 escaped 为空字符串且 cp 被
- 返回 escaped。
尽管名字相似，RegExp.escape 所做的事情并不相同。前者转义一个模式以便作为字符串表示，而此函数转义一个字符串以便在模式内部表示。
22.2.5.1.1 EncodeForRegExpEscape ( cp )
The abstract operation EncodeForRegExpEscape takes argument cp (一个代码点) and returns 一个字符串. 返回一个用于匹配 cp 的
- 如果 cp 被
SyntaxCharacter 匹配或 cp 是 U+002F (SOLIDUS)，则- 返回 0x005C (REVERSE SOLIDUS) 与 UTF16EncodeCodePoint(cp) 的字符串拼接。
- 否则如果 cp 是
Table 65 “Code Point” 列所列出的代码点，则- 返回 0x005C (REVERSE SOLIDUS) 与该行 “ControlEscape” 列中字符串的拼接。
- 令 otherPunctuators 为
",-=<>#&!%:;@~'`" 与代码单元 0x0022 (QUOTATION MARK) 的字符串拼接。 - 令 toEscape 为 StringToCodePoints(otherPunctuators)。
- 如果 toEscape 包含 cp，或 cp 被
WhiteSpace 或LineTerminator 匹配，或 cp 数值与前导代理 或尾随代理相同，则- 令 cpNum 为 cp 的数值。
- 如果 cpNum ≤ 0xFF，则
- 令 hex 为
Number::toString (𝔽 (cpNum), 16)。 - 返回 代码单元 0x005C (REVERSE SOLIDUS)、
"x" 与StringPad (hex, 2,"0" ,start ) 的字符串拼接。
- 令 hex 为
- 令 escaped 为空字符串。
- 令 codeUnits 为 UTF16EncodeCodePoint(cp)。
- 对 codeUnits 中的每个代码单元 cu，执行
- 设 escaped 为 escaped 与
UnicodeEscape (cu) 的字符串拼接。
- 设 escaped 为 escaped 与
- 返回 escaped。
- 返回 UTF16EncodeCodePoint(cp)。
22.2.5.2 RegExp.prototype
RegExp.prototype 的初始值是
该属性具有 { [[Writable]]:
22.2.5.3 get RegExp [ %Symbol.species% ]
RegExp[%Symbol.species%] 是一个存取器属性，其 set 访问器函数为
- 返回
this 值。
此函数的
RegExp 原型方法通常使用其
22.2.6 RegExp 原型对象的属性（Properties of the RegExp Prototype Object）
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 中搜索一次正则表达式模式的出现，并返回包含匹配结果的数组；若 string 未匹配则返回
调用时执行以下步骤：
- 令 R 为
this 值。 - 执行 ?
RequireInternalSlot (R, [[RegExpMatcher]])。 - 令 S 为 ?
ToString (string)。 - 返回 ?
RegExpBuiltinExec (R, S)。
22.2.6.3 get RegExp.prototype.dotAll
RegExp.prototype.dotAll 是一个存取器属性，其 set 访问器函数为
- 令 R 为
this 值。 - 令 cu 为代码单元 0x0073 (LATIN SMALL LETTER S)。
- 返回 ?
RegExpHasFlag (R, cu)。
22.2.6.4 get RegExp.prototype.flags
RegExp.prototype.flags 是一个存取器属性，其 set 访问器函数为
- 令 R 为
this 值。 - 如果 R 不是对象，抛出
TypeError 异常。 - 令 codeUnits 为新的空列表。
- 令 hasIndices 为
ToBoolean (?Get (R,"hasIndices" ))。 - 如果 hasIndices 为
true ，将代码单元 0x0064 (LATIN SMALL LETTER D) 追加到 codeUnits。 - 令 global 为
ToBoolean (?Get (R,"global" ))。 - 如果 global 为
true ，将代码单元 0x0067 (LATIN SMALL LETTER G) 追加到 codeUnits。 - 令 ignoreCase 为
ToBoolean (?Get (R,"ignoreCase" ))。 - 如果 ignoreCase 为
true ，将代码单元 0x0069 (LATIN SMALL LETTER I) 追加到 codeUnits。 - 令 multiline 为
ToBoolean (?Get (R,"multiline" ))。 - 如果 multiline 为
true ，将代码单元 0x006D (LATIN SMALL LETTER M) 追加到 codeUnits。 - 令 dotAll 为
ToBoolean (?Get (R,"dotAll" ))。 - 如果 dotAll 为
true ，将代码单元 0x0073 (LATIN SMALL LETTER S) 追加到 codeUnits。 - 令 unicode 为
ToBoolean (?Get (R,"unicode" ))。 - 如果 unicode 为
true ，将代码单元 0x0075 (LATIN SMALL LETTER U) 追加到 codeUnits。 - 令 unicodeSets 为
ToBoolean (?Get (R,"unicodeSets" ))。 - 如果 unicodeSets 为
true ，将代码单元 0x0076 (LATIN SMALL LETTER V) 追加到 codeUnits。 - 令 sticky 为
ToBoolean (?Get (R,"sticky" ))。 - 如果 sticky 为
true ，将代码单元 0x0079 (LATIN SMALL LETTER Y) 追加到 codeUnits。 - 返回代码单元为 codeUnits 列表元素的字符串值。若 codeUnits 为空，则返回空字符串。
22.2.6.4.1 RegExpHasFlag ( R, codeUnit )
The abstract operation RegExpHasFlag takes arguments R (一个
- 如果 R 不是对象，抛出
TypeError 异常。 - 如果 R 没有 [[OriginalFlags]] 内部槽，则
- 如果
SameValue (R,%RegExp.prototype% ) 为true ，返回undefined 。 - 否则，抛出
TypeError 异常。
- 如果
- 令 flags 为 R.[[OriginalFlags]]。
- 如果 flags 包含 codeUnit，返回
true 。 - 返回
false 。
22.2.6.5 get RegExp.prototype.global
RegExp.prototype.global 是一个存取器属性，其 set 访问器函数为
- 令 R 为
this 值。 - 令 cu 为代码单元 0x0067 (LATIN SMALL LETTER G)。
- 返回 ?
RegExpHasFlag (R, cu)。
22.2.6.6 get RegExp.prototype.hasIndices
RegExp.prototype.hasIndices 是一个存取器属性，其 set 访问器函数为
- 令 R 为
this 值。 - 令 cu 为代码单元 0x0064 (LATIN SMALL LETTER D)。
- 返回 ?
RegExpHasFlag (R, cu)。
22.2.6.7 get RegExp.prototype.ignoreCase
RegExp.prototype.ignoreCase 是一个存取器属性，其 set 访问器函数为
- 令 R 为
this 值。 - 令 cu 为代码单元 0x0069 (LATIN SMALL LETTER I)。
- 返回 ?
RegExpHasFlag (R, cu)。
22.2.6.8 RegExp.prototype [ %Symbol.match% ] ( string )
调用该方法时执行以下步骤：
- 令 rx 为
this 值。 - 如果 rx 不是对象，抛出
TypeError 异常。 - 令 S 为 ?
ToString (string)。 - 令 flags 为 ?
ToString (?Get (rx,"flags" ))。 - 如果 flags 不包含
"g" ，则- 返回 ?
RegExpExec (rx, S)。
- 返回 ?
- 否则，
- 如果 flags 包含
"u" 或 flags 包含"v" ，令 fullUnicode 为true ；否则令 fullUnicode 为false 。 - 执行 ?
Set (rx,"lastIndex" ,+0 𝔽,true )。 - 令 A 为 !
ArrayCreate (0)。 - 令 n 为 0。
- 重复，
- 令 result 为 ?
RegExpExec (rx, S)。 - 如果 result 为
null ，则- 如果 n = 0，返回
null 。 - 返回 A。
- 如果 n = 0，返回
- 否则，
- 令 result 为 ?
- 如果 flags 包含
该方法的
22.2.6.9 RegExp.prototype [ %Symbol.matchAll% ] ( string )
调用该方法时执行以下步骤：
- 令 R 为
this 值。 - 如果 R 不是对象，抛出
TypeError 异常。 - 令 S 为 ?
ToString (string)。 - 令 C 为 ?
SpeciesConstructor (R,%RegExp% )。 - 令 flags 为 ?
ToString (?Get (R,"flags" ))。 - 令 matcher 为 ? Construct(C, « R, flags »)。
- 令 lastIndex 为 ?
ToLength (?Get (R,"lastIndex" ))。 - 执行 ?
Set (matcher,"lastIndex" , lastIndex,true )。 - 如果 flags 包含
"g" ，令 global 为true 。 - 否则，令 global 为
false 。 - 如果 flags 包含
"u" 或 flags 包含"v" ，令 fullUnicode 为true 。 - 否则，令 fullUnicode 为
false 。 - 返回
CreateRegExpStringIterator (matcher, S, global, fullUnicode)。
该方法的
22.2.6.10 get RegExp.prototype.multiline
RegExp.prototype.multiline 是一个存取器属性，其 set 访问器函数为
- 令 R 为
this 值。 - 令 cu 为代码单元 0x006D (LATIN SMALL LETTER M)。
- 返回 ?
RegExpHasFlag (R, cu)。
22.2.6.11 RegExp.prototype [ %Symbol.replace% ] ( string, replaceValue )
调用该方法时执行以下步骤：
- 令 rx 为
this 值。 - 如果 rx 不是对象，抛出
TypeError 异常。 - 令 S 为 ?
ToString (string)。 - 令 lengthS 为 S 的长度。
- 令 functionalReplace 为
IsCallable (replaceValue)。 - 如果 functionalReplace 为
false ，则- 将 replaceValue 设为 ?
ToString (replaceValue)。
- 将 replaceValue 设为 ?
- 令 flags 为 ?
ToString (?Get (rx,"flags" ))。 - 如果 flags 包含
"g" ，令 global 为true ；否则令 global 为false 。 - 如果 global 为
true ，则- 执行 ?
Set (rx,"lastIndex" ,+0 𝔽,true )。
- 执行 ?
- 令 results 为新的空列表。
- 令 done 为
false 。 - 当 done 为
false 时重复，- 令 result 为 ?
RegExpExec (rx, S)。 - 如果 result 为
null ，则- 设 done 为
true 。
- 设 done 为
- 否则，
- 将 result 追加到 results。
- 如果 global 为
false ，则- 设 done 为
true 。
- 设 done 为
- 否则，
- 令 result 为 ?
- 令 accumulatedResult 为空字符串。
- 令 nextSourcePosition 为 0。
- 对 results 中的每个元素 result，执行
- 令 resultLength 为 ?
LengthOfArrayLike (result)。 - 令 nCaptures 为
max (resultLength - 1, 0)。 - 令 matched 为 ?
ToString (?Get (result,"0" ))。 - 令 matchLength 为 matched 的长度。
- 令 position 为 ?
ToIntegerOrInfinity (?Get (result,"index" ))。 - 将 position 钳制到 0 与 lengthS 之间。
- 令 captures 为新的空列表。
- 令 n 为 1。
- 当 n ≤ nCaptures 时重复，
- 令 namedCaptures 为 ?
Get (result,"groups" )。 - 如果 functionalReplace 为
true ，则 - 否则，
- 如果 namedCaptures 不为
undefined ，则- 设 namedCaptures 为 ?
ToObject (namedCaptures)。
- 设 namedCaptures 为 ?
- 令 replacementString 为 ?
GetSubstitution (matched, S, position, captures, namedCaptures, replaceValue)。
- 如果 namedCaptures 不为
- 如果 position ≥ nextSourcePosition，则
- 注：position 通常不应后移；若后移，说明存在行为不良的 RegExp 子类或通过访问触发副作用更改 rx 的 global 标志或其他特性。在此类情况下，对应替换被忽略。
- 设 accumulatedResult 为 accumulatedResult、S 的子串（从 nextSourcePosition 到 position）、replacementString 的串联。
- 设 nextSourcePosition 为 position + matchLength。
- 令 resultLength 为 ?
- 如果 nextSourcePosition ≥ lengthS，返回 accumulatedResult。
- 返回 accumulatedResult 与 S 自 nextSourcePosition 起子串的拼接。
该方法的
22.2.6.12 RegExp.prototype [ %Symbol.search% ] ( string )
调用该方法时执行以下步骤：
- 令 rx 为
this 值。 - 如果 rx 不是对象，抛出
TypeError 异常。 - 令 S 为 ?
ToString (string)。 - 令 previousLastIndex 为 ?
Get (rx,"lastIndex" )。 - 如果 previousLastIndex 不是
+0 𝔽，则- 执行 ?
Set (rx,"lastIndex" ,+0 𝔽,true )。
- 执行 ?
- 令 result 为 ?
RegExpExec (rx, S)。 - 令 currentLastIndex 为 ?
Get (rx,"lastIndex" )。 - 如果
SameValue (currentLastIndex, previousLastIndex) 为false ，则- 执行 ?
Set (rx,"lastIndex" , previousLastIndex,true )。
- 执行 ?
- 如果 result 为
null ，返回-1 𝔽。 - 返回 ?
Get (result,"index" )。
该方法的
执行搜索时忽略该 RegExp 对象的
22.2.6.13 get RegExp.prototype.source
RegExp.prototype.source 是一个存取器属性，其 set 访问器函数为
- 令 R 为
this 值。 - 如果 R 不是对象，抛出
TypeError 异常。 - 如果 R 没有 [[OriginalSource]] 内部槽，则
- 如果
SameValue (R,%RegExp.prototype% ) 为true ，返回"(?:)" 。 - 否则，抛出
TypeError 异常。
- 如果
- 断言：R 具有 [[OriginalFlags]] 内部槽。
- 令 src 为 R.[[OriginalSource]]。
- 令 flags 为 R.[[OriginalFlags]]。
- 返回
EscapeRegExpPattern (src, flags)。
22.2.6.13.1 EscapeRegExpPattern ( P, F )
The abstract operation EscapeRegExpPattern takes arguments P (一个字符串) and F (一个字符串) and returns 一个字符串. It performs the following steps when called:
- 如果 F 包含
"v" ，则- 令 patternSymbol 为
Pattern 。[+UnicodeMode, +UnicodeSetsMode]
- 令 patternSymbol 为
- 否则如果 F 包含
"u" ，则- 令 patternSymbol 为
Pattern 。[+UnicodeMode, ~UnicodeSetsMode]
- 令 patternSymbol 为
- 否则，
- 令 patternSymbol 为
Pattern 。[~UnicodeMode, ~UnicodeSetsMode]
- 令 patternSymbol 为
- 令 S 为一种 patternSymbol 形式的字符串，该字符串等价于将 P 按 UTF-16 编码的 Unicode 代码点解释（
6.1.4 ）后对特定代码点按下述规则转义得到的结果。S 可能与 P 相同或不同；但对 S 作为 patternSymbol 求值得到的抽象闭包必须与构造对象 [[RegExpMatcher]] 内部槽给出的抽象闭包行为一致。对同一 P 与 F 的多次调用必须产生相同结果。 - 模式中出现的
/或任何LineTerminator 必须在 S 中按需转义，以确保"/" 、S、"/" 与 F 的字符串拼接（在适当词法上下文中）可被解析为与所构造正则表达式行为一致的RegularExpressionLiteral 。例如，如果 P 是"/" ，则 S 可以是"\/" 或"\u002F" 等，但不能是"/" ，因为///后随 F 会被解析为SingleLineComment 而非RegularExpressionLiteral 。如果 P 是空字符串，本规范可通过让 S 为"(?:)" 来满足。 - 返回 S。
尽管名字相似，RegExp.escape 与 EscapeRegExpPattern 所做事情不同。前者转义一个字符串以用于模式内部，后者转义一个模式以作为字符串表示。
22.2.6.14 RegExp.prototype [ %Symbol.split% ] ( string, limit )
该方法返回一个数组，数组中存放将 string 转为字符串结果的各子串。子串通过自左向右搜索
/a*?/[Symbol.split]("ab") 结果为 ["a", "b"]，而 /a*/[Symbol.split]("ab") 结果为 ["","b"]。）
如果 string 是（或转换为）空字符串，结果取决于正则是否能匹配空字符串。若能，结果数组无元素；否则结果数组含一个元素，即空字符串。
如果正则包含捕获括号，则每次匹配 separator 时捕获括号的结果（包括
/<(\/)?([^<>]+)>/[Symbol.split]("A<B>bold</B>and<CODE>coded</CODE>")计算结果为数组
["A", undefined, "B", "bold", "/", "B", "and", undefined, "CODE", "coded", "/", "CODE", ""]如果 limit 不为
调用该方法时执行以下步骤：
- 令 rx 为
this 值。 - 如果 rx 不是对象，抛出
TypeError 异常。 - 令 S 为 ?
ToString (string)。 - 令 C 为 ?
SpeciesConstructor (rx,%RegExp% )。 - 令 flags 为 ?
ToString (?Get (rx,"flags" ))。 - 如果 flags 包含
"u" 或 flags 包含"v" ，令 unicodeMatching 为true 。 - 否则，令 unicodeMatching 为
false 。 - 如果 flags 包含
"y" ，令 newFlags 为 flags。 - 否则，令 newFlags 为 flags 与
"y" 的串联。 - 令 splitter 为 ? Construct(C, « rx, newFlags »)。
- 令 A 为 !
ArrayCreate (0)。 - 令 lengthA 为 0。
- 如果 limit 是
undefined ，令 lim 为 232 - 1；否则令 lim 为ℝ (?ToUint32 (limit))。 - 如果 lim = 0，返回 A。
- 如果 S 是空字符串，则
- 令 z 为 ?
RegExpExec (splitter, S)。 - 如果 z 不为
null ，返回 A。 - 执行 !
CreateDataPropertyOrThrow (A,"0" , S)。 - 返回 A。
- 令 z 为 ?
- 令 size 为 S 的长度。
- 令 p 为 0。
- 令 q 为 p。
- 当 q < size 时重复，
- 执行 ?
Set (splitter,"lastIndex" ,𝔽 (q),true )。 - 令 z 为 ?
RegExpExec (splitter, S)。 - 如果 z 为
null ，则- 设 q 为
AdvanceStringIndex (S, q, unicodeMatching)。
- 设 q 为
- 否则，
- 令 e 为
ℝ (?ToLength (?Get (splitter,"lastIndex" )))。 - 设 e 为
min (e, size)。 - 如果 e = p，则
- 设 q 为
AdvanceStringIndex (S, q, unicodeMatching)。
- 设 q 为
- 否则，
- 令 T 为 S 从 p 到 q 的子串。
- 执行 !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (lengthA)), T)。 - 设 lengthA 为 lengthA + 1。
- 如果 lengthA = lim，返回 A。
- 设 p 为 e。
- 令 numberOfCaptures 为 ?
LengthOfArrayLike (z)。 - 设 numberOfCaptures 为
max (numberOfCaptures - 1, 0)。 - 令 i 为 1。
- 当 i ≤ numberOfCaptures 时重复，
- 设 q 为 p。
- 令 e 为
- 执行 ?
- 令 T 为 S 从 p 到 size 的子串。
- 执行 !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (lengthA)), T)。 - 返回 A。
该方法的
该方法忽略此 RegExp 对象的
22.2.6.15 get RegExp.prototype.sticky
RegExp.prototype.sticky 是一个存取器属性，其 set 访问器函数为
- 令 R 为
this 值。 - 令 cu 为代码单元 0x0079 (LATIN SMALL LETTER Y)。
- 返回 ?
RegExpHasFlag (R, cu)。
22.2.6.16 RegExp.prototype.test ( S )
调用该方法时执行以下步骤：
- 令 R 为
this 值。 - 如果 R 不是对象，抛出
TypeError 异常。 - 令 string 为 ?
ToString (S)。 - 令 match 为 ?
RegExpExec (R, string)。 - 如果 match 不为
null ，返回true ；否则返回false 。
22.2.6.17 RegExp.prototype.toString ( )
返回的字符串形式为
22.2.6.18 get RegExp.prototype.unicode
RegExp.prototype.unicode 是一个存取器属性，其 set 访问器函数为
- 令 R 为
this 值。 - 令 cu 为代码单元 0x0075 (LATIN SMALL LETTER U)。
- 返回 ?
RegExpHasFlag (R, cu)。
22.2.6.19 get RegExp.prototype.unicodeSets
RegExp.prototype.unicodeSets 是一个存取器属性，其 set 访问器函数为
- 令 R 为
this 值。 - 令 cu 为代码单元 0x0076 (LATIN SMALL LETTER V)。
- 返回 ?
RegExpHasFlag (R, cu)。
22.2.7 用于 RegExp 匹配的抽象操作（Abstract Operations for RegExp Matching）
22.2.7.1 RegExpExec ( R, S )
The abstract operation RegExpExec takes arguments R (一个对象) and S (一个字符串) and returns 包含对象或
- 令 exec 为 ?
Get (R,"exec" )。 - 如果
IsCallable (exec) 为true ，则- 令 result 为 ? Call(exec, R, « S »)。
- 如果 result 不是对象且不为
null ，抛出TypeError 异常。 - 返回 result。
- 执行 ?
RequireInternalSlot (R, [[RegExpMatcher]])。 - 返回 ?
RegExpBuiltinExec (R, S)。
如果未找到可调用的
22.2.7.2 RegExpBuiltinExec ( R, S )
The abstract operation RegExpBuiltinExec takes arguments R (一个已初始化的 RegExp 实例) and S (一个字符串) and returns 包含
- 令 length 为 S 的长度。
- 令 lastIndex 为
ℝ (?ToLength (!Get (R,"lastIndex" )))。 - 令 flags 为 R.[[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 为 R.[[RegExpMatcher]]。
- 如果 flags 包含
"u" 或 flags 包含"v" ，令 fullUnicode 为true ；否则令 fullUnicode 为false 。 - 令 matchSucceeded 为
false 。 - 如果 fullUnicode 为
true ，令 input 为 StringToCodePoints(S)；否则令 input 为一个列表，其元素为 S 的代码单元。 - 注：input 的每个元素都被视为一个字符。
- 当 matchSucceeded 为
false 时重复，- 如果 lastIndex > length，则
- 如果 global 为
true 或 sticky 为true ，则- 执行 ?
Set (R,"lastIndex" ,+0 𝔽,true )。
- 执行 ?
- 返回
null 。
- 如果 global 为
- 令 inputIndex 为对应 S 第 lastIndex 个元素的字符在 input 中的索引。
- 令 r 为 matcher(input, inputIndex)。
- 如果 r 为
failure ，则- 如果 sticky 为
true ，则- 执行 ?
Set (R,"lastIndex" ,+0 𝔽,true )。 - 返回
null 。
- 执行 ?
- 设 lastIndex 为
AdvanceStringIndex (S, lastIndex, fullUnicode)。
- 如果 sticky 为
- 否则，
- 断言：r 是
MatchState 。 - 设 matchSucceeded 为
true 。
- 断言：r 是
- 如果 lastIndex > length，则
- 令 e 为 r.[[EndIndex]]。
- 如果 fullUnicode 为
true ，设 e 为GetStringIndex (S, e)。 - 如果 global 为
true 或 sticky 为true ，则 - 令 n 为 r.[[Captures]] 中的元素数量。
- 断言：n = R.[[RegExpRecord]].[[CapturingGroupsCount]]。
- 断言：n < 232 - 1。
- 令 A 为 !
ArrayCreate (n + 1)。 - 断言：A 的
"length" 属性的数学值 为 n + 1。 - 执行 !
CreateDataPropertyOrThrow (A,"index" ,𝔽 (lastIndex))。 - 执行 !
CreateDataPropertyOrThrow (A,"input" , S)。 - 令 match 为
Match 记录 { [[StartIndex]]: lastIndex, [[EndIndex]]: e }。 - 令 indices 为新的空列表。
- 令 groupNames 为新的空列表。
- 将 match 追加到 indices。
- 令 matchedSubstr 为
GetMatchString (S, match)。 - 执行 !
CreateDataPropertyOrThrow (A,"0" , matchedSubstr)。 - 如果 R 包含任意
GroupName ，则- 令 groups 为
OrdinaryObjectCreate (null )。 - 令 hasGroups 为
true 。
- 令 groups 为
- 否则，
- 令 groups 为
undefined 。 - 令 hasGroups 为
false 。
- 令 groups 为
- 执行 !
CreateDataPropertyOrThrow (A,"groups" , groups)。 - 令 matchedGroupNames 为新的空列表。
- 对每个整数 i（1 ≤ i ≤ n，升序），执行
- 令 captureI 为 r.[[Captures]] 的第 i 个元素。
- 如果 captureI 为
undefined ，则- 令 capturedValue 为
undefined 。 - 将
undefined 追加到 indices。
- 令 capturedValue 为
- 否则，
- 令 captureStart 为 captureI.[[StartIndex]]。
- 令 captureEnd 为 captureI.[[EndIndex]]。
- 如果 fullUnicode 为
true ，则- 设 captureStart 为
GetStringIndex (S, captureStart)。 - 设 captureEnd 为
GetStringIndex (S, captureEnd)。
- 设 captureStart 为
- 令 capture 为
Match 记录 { [[StartIndex]]: captureStart, [[EndIndex]]: captureEnd }。 - 令 capturedValue 为
GetMatchString (S, capture)。 - 将 capture 追加到 indices。
- 执行 !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (i)), capturedValue)。 - 如果 R 的第 i 个捕获是用
GroupName 定义的，则- 令 s 为该
GroupName 的 CapturingGroupName。 - 如果 matchedGroupNames 包含 s，则
- 断言：capturedValue 为
undefined 。 - 将
undefined 追加到 groupNames。
- 断言：capturedValue 为
- 否则，
- 如果 capturedValue 不为
undefined ，将 s 追加到 matchedGroupNames。 - 注：若多个组名为 s，groups 此时可能已有 s 属性；但由于 groups 是所有属性皆可写的
数据属性 的普通对象 ，CreateDataPropertyOrThrow 调用仍保证成功。 - 执行 !
CreateDataPropertyOrThrow (groups, s, capturedValue)。 - 将 s 追加到 groupNames。
- 如果 capturedValue 不为
- 令 s 为该
- 否则，
- 将
undefined 追加到 groupNames。
- 将
- 如果 hasIndices 为
true ，则- 令 indicesArray 为
MakeMatchIndicesIndexPairArray (S, indices, groupNames, hasGroups)。 - 执行 !
CreateDataPropertyOrThrow (A,"indices" , indicesArray)。
- 令 indicesArray 为
- 返回 A。
22.2.7.3 AdvanceStringIndex ( S, index, unicode )
The abstract operation AdvanceStringIndex takes arguments S (一个字符串), index (一个非负整数), and unicode (一个布尔值) and returns 一个整数. It performs the following steps when called:
- 断言：index ≤ 253 - 1。
- 如果 unicode 为
false ，返回 index + 1。 - 令 length 为 S 的长度。
- 如果 index + 1 ≥ length，返回 index + 1。
- 令 cp 为 CodePointAt(S, index)。
- 返回 index + cp.[[CodeUnitCount]]。
22.2.7.4 GetStringIndex ( S, codePointIndex )
The abstract operation GetStringIndex takes arguments S (一个字符串) and codePointIndex (一个非负整数) and returns 一个非负整数. 按
- 如果 S 是空字符串，返回 0。
- 令 len 为 S 的长度。
- 令 codeUnitCount 为 0。
- 令 codePointCount 为 0。
- 当 codeUnitCount < len 时重复，
- 如果 codePointCount = codePointIndex，返回 codeUnitCount。
- 令 cp 为 CodePointAt(S, codeUnitCount)。
- 设 codeUnitCount 为 codeUnitCount + cp.[[CodeUnitCount]]。
- 设 codePointCount 为 codePointCount + 1。
- 返回 len。
22.2.7.5 匹配记录（Match Records）
Match 记录 是用于封装正则匹配或捕获起止索引的记录值。
Match 记录具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[StartIndex]] | 一个非负整数 | 从字符串起始处开始（含）匹配开始的代码单元数量。 |
| [[EndIndex]] | 一个 ≥ [[StartIndex]] 的整数 | 从字符串起始处开始匹配结束（不含）位置的代码单元数量。 |
22.2.7.6 GetMatchString ( S, match )
The abstract operation GetMatchString takes arguments S (一个字符串) and match (一个
- 断言：match.[[StartIndex]] ≤ match.[[EndIndex]] ≤ S 的长度。
- 返回 S 中从 match.[[StartIndex]] 到 match.[[EndIndex]] 的子串。
22.2.7.7 GetMatchIndexPair ( S, match )
The abstract operation GetMatchIndexPair takes arguments S (一个字符串) and match (一个
- 断言：match.[[StartIndex]] ≤ match.[[EndIndex]] ≤ S 的长度。
- 返回
CreateArrayFromList («𝔽 (match.[[StartIndex]]),𝔽 (match.[[EndIndex]]) »)。
22.2.7.8 MakeMatchIndicesIndexPairArray ( S, indices, groupNames, hasGroups )
The abstract operation MakeMatchIndicesIndexPairArray takes arguments S (一个字符串), indices (一个由
- 令 n 为 indices 的元素数量。
- 断言：n < 232 - 1。
- 断言：groupNames 有 n - 1 个元素。
- 注：groupNames 列表的元素与 indices 列表自 indices[1] 起对齐。
- 令 A 为 !
ArrayCreate (n)。 - 如果 hasGroups 为
true ，则- 令 groups 为
OrdinaryObjectCreate (null )。
- 令 groups 为
- 否则，
- 令 groups 为
undefined 。
- 令 groups 为
- 执行 !
CreateDataPropertyOrThrow (A,"groups" , groups)。 - 对每个整数 i（0 ≤ i < n，升序），执行
- 令 matchIndices 为 indices[i]。
- 如果 matchIndices 不为
undefined ，则- 令 matchIndexPair 为
GetMatchIndexPair (S, matchIndices)。
- 令 matchIndexPair 为
- 否则，
- 令 matchIndexPair 为
undefined 。
- 令 matchIndexPair 为
- 执行 !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (i)), matchIndexPair)。 - 如果 i > 0，则
- 令 s 为 groupNames[i - 1]。
- 如果 s 不为
undefined ，则- 断言：groups 不为
undefined 。 - 注：若多个组名为 s，groups 此时可能已有 s 属性；但由于 groups 是所有属性皆可写的
数据属性 的普通对象 ，CreateDataPropertyOrThrow 调用仍保证成功。 - 执行 !
CreateDataPropertyOrThrow (groups, s, matchIndexPair)。
- 断言：groups 不为
- 返回 A。
22.2.8 RegExp 实例的属性（Properties of RegExp Instances）
RegExp 实例是
在 ECMAScript 2015 之前，RegExp 实例被指定为拥有自身RegExp.prototype 的存取器属性。
RegExp 实例还具有以下属性：
22.2.8.1 lastIndex
22.2.9 RegExp 字符串迭代器对象
RegExp String Iterator 是一个对象，表示针对某个特定 String 实例对象、以某个特定 RegExp 实例对象进行匹配时的特定迭代过程。RegExp String Iterator 对象没有命名
22.2.9.1 CreateRegExpStringIterator ( R, S, global, fullUnicode )
The abstract operation CreateRegExpStringIterator takes arguments R (一个对象), S (一个字符串), global (一个布尔值), and fullUnicode (一个布尔值) and returns 一个对象. It performs the following steps when called:
- 令 iterator 为
OrdinaryObjectCreate (%RegExpStringIteratorPrototype% , « [[IteratingRegExp]], [[IteratedString]], [[Global]], [[Unicode]], [[Done]] »)。 - 设 iterator.[[IteratingRegExp]] 为 R。
- 设 iterator.[[IteratedString]] 为 S。
- 设 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 ( )
- 令 O 为
this 值。 - 若 O 不是对象，抛出
TypeError 异常。 - 若 O 不具有
RegExp String Iterator 对象实例的全部内部槽（见22.2.9.3 ），抛出TypeError 异常。 - 若 O.[[Done]] 为
true ，则- 返回
CreateIteratorResultObject (undefined ,true )。
- 返回
- 令 R 为 O.[[IteratingRegExp]]。
- 令 S 为 O.[[IteratedString]]。
- 令 global 为 O.[[Global]]。
- 令 fullUnicode 为 O.[[Unicode]]。
- 令 match 为 ?
RegExpExec (R, S)。 - 若 match 为
null ，则- 设 O.[[Done]] 为
true 。 - 返回
CreateIteratorResultObject (undefined ,true )。
- 设 O.[[Done]] 为
- 若 global 为
false ，则- 设 O.[[Done]] 为
true 。 - 返回
CreateIteratorResultObject (match,false )。
- 设 O.[[Done]] 为
- 令 matchStr 为 ?
ToString (?Get (match,"0" ))。 - 若 matchStr 为空字符串，则
- 返回
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 | 当前被迭代的字符串值。 |
| [[Global]] | a Boolean | 指示 [[IteratingRegExp]] 是否为全局模式。 |
| [[Unicode]] | a Boolean | 指示 [[IteratingRegExp]] 是否处于 Unicode 模式。 |
| [[Done]] | a Boolean | 指示迭代是否完成。 |
23 索引集合（Indexed Collections）
23.1 Array 对象
Array 是一种对某类
23.1.1 Array 构造函数
Array
- 是 %Array%。
- 是全局对象
"Array" 属性的初始值。 - 作为
构造函数 调用时创建并初始化一个新的 Array。 - 作为函数（而非
构造函数 ）调用时同样创建并初始化一个新的 Array。因此函数调用Array(…)等价于使用相同参数的对象创建表达式new Array(…)。 - 其行为随参数数量与类型不同而不同。
- 可用作类定义
extends子句的值。打算继承数组异质行为的子类构造函数 必须包含对 Array构造函数 的super调用，以初始化作为数组异质对象的子类实例。但大多数Array.prototype方法是泛型的，不依赖其this 为数组异质对象。
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，则
- 令 len 为 values[0]。
- 令 array 为 !
ArrayCreate (0, proto)。 - 若 len
不是 Number ，则- 执行 !
CreateDataPropertyOrThrow (array,"0" , len)。 - 令 intLen 为
1 𝔽。
- 执行 !
- 否则，
- 令 intLen 为 !
ToUint32 (len)。 - 若
SameValueZero (intLen, len) 为false ，抛出RangeError 异常。
- 令 intLen 为 !
- 执行 !
Set (array,"length" , intLen,true )。 - 返回 array。
- 否则，
- 断言：numberOfArgs ≥ 2。
- 令 array 为 ?
ArrayCreate (numberOfArgs, proto)。 - 令 k 为 0。
- 当 k < numberOfArgs 时重复，
- 令 Pk 为 !
ToString (𝔽 (k))。 - 令 itemK 为 values[k]。
- 执行 !
CreateDataPropertyOrThrow (array, Pk, itemK)。 - 令 k = k + 1。
- 令 Pk 为 !
- 断言：array 的
"length" 属性数学值 为 numberOfArgs。 - 返回 array。
23.1.2 Array 构造函数的属性
Array
- 具有 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有
"length" 属性，其值为1 𝔽。 - 具有以下属性：
23.1.2.1 Array.from ( items [ , mapper [ , thisArg ] ] )
此方法被调用时执行以下步骤：
- 令 C 为
this 值。 - 若 mapper 为
undefined ，则- 令 mapping 为
false 。
- 令 mapping 为
- 否则，
- 若
IsCallable (mapper) 为false ，抛出TypeError 异常。 - 令 mapping 为
true 。
- 若
- 令 usingIterator 为 ?
GetMethod (items,%Symbol.iterator% )。 - 若 usingIterator 不为
undefined ，则- 若
IsConstructor (C) 为true ，则- 令 A 为 ? Construct(C)。
- 否则，
- 令 A 为 !
ArrayCreate (0)。
- 令 A 为 !
- 令 iteratorRecord 为 ?
GetIteratorFromMethod (items, usingIterator)。 - 令 k 为 0。
- 重复，
- 若 k ≥ 253 - 1，则
- 令 error 为
ThrowCompletion (新建的TypeError 对象)。 - 返回 ?
IteratorClose (iteratorRecord, error)。
- 令 error 为
- 令 Pk 为 !
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 (A, Pk, mappedValue))。 IfAbruptCloseIterator (defineStatus, iteratorRecord)。- 令 k = k + 1。
- 若 k ≥ 253 - 1，则
- 若
- 注：items 不可迭代，假定为
类数组对象 。 - 令 arrayLike 为 !
ToObject (items)。 - 令 len 为 ?
LengthOfArrayLike (arrayLike)。 - 若
IsConstructor (C) 为true ，则- 令 A 为 ? Construct(C, «
𝔽 (len) »)。
- 令 A 为 ? Construct(C, «
- 否则，
- 令 A 为 ?
ArrayCreate (len)。
- 令 A 为 ?
- 令 k 为 0。
- 当 k < len 时重复，
- 令 Pk 为 !
ToString (𝔽 (k))。 - 令 kValue 为 ?
Get (arrayLike, Pk)。 - 若 mapping 为
true ，则- 令 mappedValue 为 ? Call(mapper, thisArg, « kValue,
𝔽 (k) »)。
- 令 mappedValue 为 ? Call(mapper, thisArg, « kValue,
- 否则，
- 令 mappedValue 为 kValue。
- 执行 ?
CreateDataPropertyOrThrow (A, Pk, mappedValue)。 - 令 k = k + 1。
- 令 Pk 为 !
- 执行 ?
Set (A,"length" ,𝔽 (len),true )。 - 返回 A。
23.1.2.2 Array.isArray ( arg )
此函数被调用时执行以下步骤：
- 返回 ?
IsArray (arg)。
23.1.2.3 Array.of ( ...items )
此方法被调用时执行以下步骤：
- 令 len 为 items 中元素数量。
- 令 lenNumber 为
𝔽 (len)。 - 令 C 为
this 值。 - 若
IsConstructor (C) 为true ，则- 令 A 为 ? Construct(C, « lenNumber »)。
- 否则，
- 令 A 为 ?
ArrayCreate (len)。
- 令 A 为 ?
- 令 k 为 0。
- 当 k < len 时重复，
- 令 kValue 为 items[k]。
- 令 Pk 为 !
ToString (𝔽 (k))。 - 执行 ?
CreateDataPropertyOrThrow (A, Pk, kValue)。 - 令 k = k + 1。
- 执行 ?
Set (A,"length" , lenNumber,true )。 - 返回 A。
23.1.2.4 Array.prototype
Array.prototype 的值是
该属性具有 { [[Writable]]:
23.1.2.5 get Array [ %Symbol.species% ]
Array[%Symbol.species%] 是一个存取器属性，其 set 访问器为
- 返回
this 值。
该函数
Array 原型方法通常使用其
23.1.3 Array 原型对象的属性
Array 原型对象：
- 是 %Array.prototype%。
- 是一个 Array 异质对象，具有该类对象规定的内部方法。
- 有
"length" 属性，其初始值为+0 𝔽，属性特性为 { [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }。 - 具有 [[Prototype]] 内部槽，其值为
%Object.prototype% 。
指定为数组异质对象以保持与 ECMAScript 2015 之前代码的兼容性。
23.1.3.1 Array.prototype.at ( index )
- 令 O 为 ?
ToObject (this value)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 令 relativeIndex 为 ?
ToIntegerOrInfinity (index)。 - 若 relativeIndex ≥ 0，则
- 令 k = relativeIndex。
- 否则，
- 令 k = len + relativeIndex。
- 若 k < 0 或 k ≥ len，返回
undefined 。 - 返回 ?
Get (O, !ToString (𝔽 (k)))。
23.1.3.2 Array.prototype.concat ( ...items )
返回一个数组，包含对象自身元素后接各参数的数组元素。
调用时执行：
- 令 O 为 ?
ToObject (this value)。 - 令 A 为 ?
ArraySpeciesCreate (O, 0)。 - 令 n = 0。
- 将 O 前置到 items。
- 对 items 中每个元素 E：
- 令 spreadable 为 ?
IsConcatSpreadable (E)。 - 若 spreadable 为
true ，- 令 len 为 ?
LengthOfArrayLike (E)。 - 若 n + len > 253 - 1，抛出
TypeError 。 - 令 k = 0。
- 当 k < len：
- 令 Pk 为 !
ToString (𝔽 (k))。 - 令 exists 为 ?
HasProperty (E, Pk)。 - 若 exists 为
true ，- 令 subElement 为 ?
Get (E, Pk)。 - 执行 ?
CreateDataPropertyOrThrow (A, !ToString (𝔽 (n)), subElement)。
- 令 subElement 为 ?
- 令 n = n + 1。
- 令 k = k + 1。
- 令 Pk 为 !
- 令 len 为 ?
- 否则，
- 注：E 作为单个元素添加。
- 若 n ≥ 253 - 1，抛出
TypeError 。 - 执行 ?
CreateDataPropertyOrThrow (A, !ToString (𝔽 (n)), E)。 - 令 n = n + 1。
- 令 spreadable 为 ?
- 执行 ?
Set (A,"length" ,𝔽 (n),true )。 - 返回 A。
此方法
显式设置
本方法为泛型；
23.1.3.2.1 IsConcatSpreadable ( O )
The abstract operation IsConcatSpreadable takes argument O (an ECMAScript language value) and returns 包含布尔值的
- 若 O 不是对象，返回
false 。 - 令 spreadable 为 ?
Get (O,%Symbol.isConcatSpreadable% )。 - 若 spreadable 不为
undefined ，返回ToBoolean (spreadable)。 - 返回 ?
IsArray (O)。
23.1.3.3 Array.prototype.constructor
Array.prototype.constructor 的初始值为
23.1.3.4 Array.prototype.copyWithin ( target, start [ , end ] )
end 可选；缺省使用
负的 target / start / end 分别视为
调用时执行：
- 令 O 为 ?
ToObject (this value)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 令 relativeTarget 为 ?
ToIntegerOrInfinity (target)。 - 若 relativeTarget = -∞，令 to = 0。
- 否则若 relativeTarget < 0，令 to =
max (len + relativeTarget, 0)。 - 否则令 to =
min (relativeTarget, len)。 - 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 若 relativeStart = -∞，令 from = 0。
- 否则若 relativeStart < 0，令 from =
max (len + relativeStart, 0)。 - 否则令 from =
min (relativeStart, len)。 - 若 end 为
undefined ，令 relativeEnd = len；否则令 relativeEnd = ?ToIntegerOrInfinity (end)。 - 若 relativeEnd = -∞，令 final = 0。
- 否则若 relativeEnd < 0，令 final =
max (len + relativeEnd, 0)。 - 否则令 final =
min (relativeEnd, len)。 - 令 count =
min (final - from, len - 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 (O, fromKey)。 - 若 fromPresent 为
true ， - 否则
- 执行 ?
DeletePropertyOrThrow (O, toKey)。
- 执行 ?
- from += direction。
- to += direction。
- count -= 1。
- 令 fromKey = !
- 返回 O。
方法为泛型，可转移到其它对象。
23.1.3.5 Array.prototype.entries ( )
调用时执行：
- 令 O 为 ?
ToObject (this value)。 - 返回
CreateArrayIterator (O,key+value )。
23.1.3.6 Array.prototype.every ( callback [ , thisArg ] )
依次（升序）对存在的元素调用 callback，若遇到返回
执行步骤：
- 令 O 为 ?
ToObject (this value)。 - 令 len 为 ?
LengthOfArrayLike (O)。 - 若
IsCallable (callback) 为false ，抛出TypeError 。 - 令 k = 0。
- 当 k < len：
- 返回
true 。
泛型方法，可转移使用。
23.1.3.7 Array.prototype.fill ( value [ , start [ , end ] ] )
start 缺省
执行步骤：
- O = ?
ToObject (this value)。 - len = ?
LengthOfArrayLike (O)。 - relativeStart = ?
ToIntegerOrInfinity (start)。 - 若 relativeStart = -∞，k = 0；否则若 < 0，k =
max (len + relativeStart, 0)；否则 k =min (relativeStart, len)。 - 若 end 为
undefined ，relativeEnd = len；否则 relativeEnd = ?ToIntegerOrInfinity (end)。 - 若 relativeEnd = -∞，final = 0；否则若 < 0，final =
max (len + relativeEnd, 0)；否则 final =min (relativeEnd, len)。 - 当 k < final：
- 返回 O。
泛型方法。
23.1.3.8 Array.prototype.filter ( callback [ , thisArg ] )
对现有元素调用 callback，收集返回
执行步骤：
- O = ?
ToObject (this value)。 - len = ?
LengthOfArrayLike (O)。 - 若
IsCallable (callback) 为false 抛TypeError 。 - A = ?
ArraySpeciesCreate (O, 0)。 - k = 0；to = 0。
- 当 k < len：
- Pk = !
ToString (𝔽 (k))。 - kPresent = ?
HasProperty (O, Pk)。 - 若 kPresent：
- k++。
- Pk = !
- 返回 A。
泛型。
23.1.3.9 Array.prototype.find ( predicate [ , thisArg ] )
升序查找首个使 predicate 结果为真值的元素，找不到返回
执行步骤：
- O = ?
ToObject (this value)。 - len = ?
LengthOfArrayLike (O)。 - findRec = ?
FindViaPredicate (O, len,ascending , predicate, thisArg)。 - 返回 findRec.[[Value]]。
泛型。
23.1.3.10 Array.prototype.findIndex ( predicate [ , thisArg ] )
升序查找首个满足谓词的索引，未找到返回 -1。
执行：
- O = ?
ToObject (this value)。 - len = ?
LengthOfArrayLike (O)。 - findRec = ?
FindViaPredicate (O, len,ascending , predicate, thisArg)。 - 返回 findRec.[[Index]]。
泛型。
23.1.3.11 Array.prototype.findLast ( predicate [ , thisArg ] )
降序查找首个满足谓词的元素，未找到返回
执行：
- O = ?
ToObject (this value)。 - len = ?
LengthOfArrayLike (O)。 - findRec = ?
FindViaPredicate (O, len,descending , predicate, thisArg)。 - 返回 findRec.[[Value]]。
泛型。
23.1.3.12 Array.prototype.findLastIndex ( predicate [ , thisArg ] )
降序查找首个满足谓词的索引，未找到返回 -1。
执行：
- O = ?
ToObject (this value)。 - len = ?
LengthOfArrayLike (O)。 - findRec = ?
FindViaPredicate (O, len,descending , predicate, thisArg)。 - 返回 findRec.[[Index]]。
泛型。
23.1.3.12.1 FindViaPredicate ( O, len, direction, predicate, thisArg )
The abstract operation FindViaPredicate takes arguments O (an Object), len (a non-negative
遍历 O 的索引（升序或降序）调用 predicate，返回首个真值对应的索引与值；若无则索引
predicate 接收 (元素值, 索引, 被遍历对象)。
thisArg 作为
不直接修改 O；predicate 可修改。
遍历范围在开始前确定；新增元素不访问；修改元素按访问时值；删除后再访问的仍按原序列访问（
It performs the following steps when called:
- 若
IsCallable (predicate) 为false 抛TypeError 。 - 若 direction 为
ascending ，- 令 indices 为 [0, …, len-1] 升序列表。
- 否则，
- 令 indices 为 [0, …, len-1] 降序列表。
- 对 indices 中每个整数 k：
- 返回 { [[Index]]:
-1 𝔽, [[Value]]:undefined }。
23.1.3.13 Array.prototype.flat ( [ depth ] )
调用时执行：
- O = ?
ToObject (this value)。 - sourceLen = ?
LengthOfArrayLike (O)。 - depthNum = 1。
- 若 depth 非
undefined ：- depthNum = ?
ToIntegerOrInfinity (depth)。 - 若 depthNum < 0，设为 0。
- depthNum = ?
- A = ?
ArraySpeciesCreate (O, 0)。 - ? FlattenIntoArray(A, O, sourceLen, 0, depthNum)。
- 返回 A。
23.1.3.13.1 FlattenIntoArray ( target: an Object, source: an Object, sourceLen: a non-negative integer, start: a non-negative integer, depth: a non-negative integer or +∞, optional mapperFunction: a function object, optional thisArg: an ECMAScript language value, ): either a normal completion containing a non-negative integer or a throw completion
- 断言：若提供 mapperFunction，则
IsCallable (mapperFunction) 为true ，thisArg 存在且 depth = 1。 - targetIndex = start。
- sourceIndex =
+0 𝔽。 - 当
ℝ (sourceIndex) < sourceLen：- P = !
ToString (sourceIndex)。 - exists = ?
HasProperty (source, P)。 - 若 exists：
- element = ?
Get (source, P)。 - 若有 mapperFunction：element = ? Call(mapperFunction, thisArg, « element, sourceIndex, source »)。
- shouldFlatten =
false 。 - 若 depth > 0：shouldFlatten = ?
IsArray (element)。 - 若 shouldFlatten：
- 若 depth = +∞，newDepth = +∞；否则 newDepth = depth - 1。
- elementLen = ?
LengthOfArrayLike (element)。 - targetIndex = ? FlattenIntoArray(target, element, elementLen, targetIndex, newDepth)。
- 否则：
- 若 targetIndex ≥ 253 - 1 抛
TypeError 。 - ?
CreateDataPropertyOrThrow (target, !ToString (𝔽 (targetIndex)), element)。 - targetIndex++。
- 若 targetIndex ≥ 253 - 1 抛
- element = ?
- sourceIndex +=
1 𝔽。
- P = !
- 返回 targetIndex。
23.1.3.14 Array.prototype.flatMap ( mapperFunction [ , thisArg ] )
执行步骤：
- O = ?
ToObject (this value)。 - sourceLen = ?
LengthOfArrayLike (O)。 - 若
IsCallable (mapperFunction) 为false 抛TypeError 。 - A = ?
ArraySpeciesCreate (O, 0)。 - ? FlattenIntoArray(A, O, sourceLen, 0, 1, mapperFunction, thisArg)。
- 返回 A。
23.1.3.15 Array.prototype.forEach ( callback [ , thisArg ] )
对存在元素升序调用 callback，不返回聚合值，缺失元素略过。
步骤：
- O = ?
ToObject (this value)。 - len = ?
LengthOfArrayLike (O)。 - 若
IsCallable (callback) 为false 抛TypeError 。 - k = 0。
- 当 k < len：
- Pk = !
ToString (𝔽 (k))。 - kPresent = ?
HasProperty (O, Pk)。 - 若 kPresent：
- k++。
- Pk = !
- 返回
undefined 。
泛型。
23.1.3.16 Array.prototype.includes ( searchElement [ , fromIndex ] )
使用
步骤：
- O = ?
ToObject (this value)。 - len = ?
LengthOfArrayLike (O)。 - 若 len = 0 返回
false 。 - n = ?
ToIntegerOrInfinity (fromIndex)。 - 断言：若 fromIndex 为
undefined ，n = 0。 - 若 n = +∞ 返回
false ；若 n = -∞ 令 n = 0。 - 若 n ≥ 0：k = n；否则 k = len + n，若 k < 0 则 k = 0。
- 当 k < len：
- elementK = ?
Get (O, !ToString (𝔽 (k)))。 - 若
SameValueZero (searchElement, elementK) 为true 返回true 。 - k++。
- elementK = ?
- 返回
false 。
泛型。
区别于 indexOf：使用
23.1.3.17 Array.prototype.indexOf ( searchElement [ , fromIndex ] )
使用
fromIndex 缺省
步骤：
- O = ?
ToObject (this value)。 - len = ?
LengthOfArrayLike (O)。 - 若 len = 0 返回
-1 𝔽。 - n = ?
ToIntegerOrInfinity (fromIndex)。 - 断言：fromIndex 为
undefined 时 n = 0。 - 若 n = +∞ 返回
-1 𝔽；若 n = -∞ 置 0。 - 若 n ≥ 0：k = n；否则 k = len + n，若 k < 0 则 0。
- 当 k < len：
- Pk = !
ToString (𝔽 (k))。 - kPresent = ?
HasProperty (O, Pk)。 - 若 kPresent：
- elementK = ?
Get (O, Pk)。 - 若
IsStrictlyEqual (searchElement, elementK) 为true 返回𝔽 (k)。
- elementK = ?
- k++。
- Pk = !
- 返回
-1 𝔽。
泛型。
23.1.3.18 Array.prototype.join ( separator )
将元素转换为字符串并用分隔符拼接；缺省分隔符为逗号。
步骤：
泛型。
23.1.3.19 Array.prototype.keys ( )
步骤：
- O = ?
ToObject (this value)。 - 返回
CreateArrayIterator (O,key )。
23.1.3.20 Array.prototype.lastIndexOf ( searchElement [ , fromIndex ] )
自右向左使用
步骤：
- O = ?
ToObject (this value)。 - len = ?
LengthOfArrayLike (O)。 - 若 len = 0 返回
-1 𝔽。 - 若提供 fromIndex，n = ?
ToIntegerOrInfinity (fromIndex)；否则 n = len - 1。 - 若 n = -∞ 返回
-1 𝔽。 - 若 n ≥ 0：k =
min (n, len - 1)；否则 k = len + n。 - 当 k ≥ 0：
- Pk = !
ToString (𝔽 (k))。 - kPresent = ?
HasProperty (O, Pk)。 - 若 kPresent：
- elementK = ?
Get (O, Pk)。 - 若
IsStrictlyEqual (searchElement, elementK) 为true 返回𝔽 (k)。
- elementK = ?
- k--。
- Pk = !
- 返回
-1 𝔽。
泛型。
23.1.3.21 Array.prototype.map ( callback [ , thisArg ] )
升序对存在元素调用 callback，生成新数组。
步骤：
- O = ?
ToObject (this value)。 - len = ?
LengthOfArrayLike (O)。 - 若
IsCallable (callback) 为false 抛TypeError 。 - A = ?
ArraySpeciesCreate (O, len)。 - k = 0。
- 当 k < len：
- Pk = !
ToString (𝔽 (k))。 - kPresent = ?
HasProperty (O, Pk)。 - 若 kPresent：
- kValue = ?
Get (O, Pk)。 - mappedValue = ? Call(callback, thisArg, « kValue,
𝔽 (k), O »)。 - ?
CreateDataPropertyOrThrow (A, Pk, mappedValue)。
- kValue = ?
- k++。
- Pk = !
- 返回 A。
泛型。
23.1.3.22 Array.prototype.pop ( )
移除并返回最后一个元素。
步骤：
- O = ?
ToObject (this value)。 - len = ?
LengthOfArrayLike (O)。 - 若 len = 0：
- ?
Set (O,"length" ,+0 𝔽,true )。 - 返回
undefined 。
- ?
- 否则：
- 令 newLen =
𝔽 (len - 1)。 - index = !
ToString (newLen)。 - element = ?
Get (O, index)。 - ?
DeletePropertyOrThrow (O, index)。 - ?
Set (O,"length" , newLen,true )。 - 返回 element。
- 令 newLen =
泛型。
23.1.3.23 Array.prototype.push ( ...items )
将参数按顺序追加到末尾，返回新长度。
步骤：
此方法
泛型。
23.1.3.24 Array.prototype.reduce ( callback [ , initialValue ] )
从左到右归约；若未提供 initialValue，使用首个存在元素作为累加器起始；空数组且无初始值抛
步骤：
- O = ?
ToObject (this value)。 - len = ?
LengthOfArrayLike (O)。 - 若
IsCallable (callback) 为false 抛TypeError 。 - 若 len = 0 且无 initialValue 抛
TypeError 。 - k = 0；accumulator =
undefined 。 - 若提供 initialValue：accumulator = initialValue。
- 否则：
- kPresent =
false 。 - 当 !kPresent 且 k < len：
- Pk = !
ToString (𝔽 (k))。 - kPresent = ?
HasProperty (O, Pk)。 - 若 kPresent：accumulator = ?
Get (O, Pk)。 - k++。
- Pk = !
- 若 !kPresent 抛
TypeError 。
- kPresent =
- 当 k < len：
- Pk = !
ToString (𝔽 (k))。 - kPresent = ?
HasProperty (O, Pk)。 - 若 kPresent：
- k++。
- Pk = !
- 返回 accumulator。
泛型。
23.1.3.25 Array.prototype.reduceRight ( callback [ , initialValue ] )
从右向左归约，规则同 reduce 但方向相反。
步骤：
- O = ?
ToObject (this value)，len = ?LengthOfArrayLike (O)。 - 若
IsCallable (callback) 为false 抛TypeError 。 - 若 len = 0 且无 initialValue 抛
TypeError 。 - k = len - 1；accumulator =
undefined 。 - 若有初始值：accumulator = initialValue。
- 否则：
- kPresent =
false 。 - 当 !kPresent 且 k ≥ 0：
- Pk = !
ToString (𝔽 (k))。 - kPresent = ?
HasProperty (O, Pk)。 - 若 kPresent：accumulator = ?
Get (O, Pk)。 - k--。
- Pk = !
- 若 !kPresent 抛
TypeError 。
- kPresent =
- 当 k ≥ 0：
- Pk = !
ToString (𝔽 (k))。 - kPresent = ?
HasProperty (O, Pk)。 - 若 kPresent：
- k--。
- Pk = !
- 返回 accumulator。
泛型。
23.1.3.26 Array.prototype.reverse ( )
就地反转顺序并返回该对象。
步骤：
- O = ?
ToObject (this value)，len = ?LengthOfArrayLike (O)。 - middle =
floor (len/2)，lower = 0。 - 当 lower ≠ middle：
- upper = len - lower - 1。
- upperP = !
ToString (𝔽 (upper))，lowerP = !ToString (𝔽 (lower))。 - lowerExists = ?
HasProperty (O, lowerP)；若真：lowerValue = ?Get (O, lowerP)。 - upperExists = ?
HasProperty (O, upperP)；若真：upperValue = ?Get (O, upperP)。 - 若二者皆真：交换；仅上真：下设上并删上；仅下真：删下并设上；皆假：无操作。
- lower++。
- 返回 O。
泛型。
23.1.3.27 Array.prototype.shift ( )
移除首元素并返回。
步骤：
- O = ?
ToObject (this value)，len = ?LengthOfArrayLike (O)。 - 若 len = 0：?
Set (O,"length" ,+0 𝔽,true )；返回undefined 。 - first = ?
Get (O,"0" )。 - k = 1。
- 当 k < len：
- ?
DeletePropertyOrThrow (O, !ToString (𝔽 (len-1)))。 - ?
Set (O,"length" ,𝔽 (len-1),true )。 - 返回 first。
泛型。
23.1.3.28 Array.prototype.slice ( start, end )
返回从 start（含）到 end（不含）之间的浅拷贝；负值按长度偏移。
步骤：
- O = ?
ToObject (this value)，len = ?LengthOfArrayLike (O)。 - relativeStart = ?
ToIntegerOrInfinity (start)。 - 若 = -∞，k = 0；否则若 <0，k =
max (len+relativeStart,0)；否则 k =min (relativeStart, len)。 - relativeEnd = (end 是
undefined ? len : ?ToIntegerOrInfinity (end))。 - 若 relativeEnd = -∞，final = 0；若 <0，final =
max (len+relativeEnd,0)；否则 final =min (relativeEnd, len)。 - count =
max (final - k, 0)。 - A = ?
ArraySpeciesCreate (O, count)。 - n = 0。
- 当 k < final：
- Pk = !
ToString (𝔽 (k))。 - kPresent = ?
HasProperty (O, Pk)。 - 若真：kValue = ?
Get (O, Pk)；?CreateDataPropertyOrThrow (A, !ToString (𝔽 (n)), kValue)。 - k++；n++。
- Pk = !
- ?
Set (A,"length" ,𝔽 (n),true )。 - 返回 A。
显式设置长度确保非内置数组时正确。
泛型。
23.1.3.29 Array.prototype.some ( callback [ , thisArg ] )
升序测试是否存在使 callback 为真值的元素；空数组返回
步骤：
- O = ?
ToObject (this value)，len = ?LengthOfArrayLike (O)。 - 若
IsCallable (callback) 为false 抛TypeError 。 - k = 0。
- 当 k < len：
- 返回
false 。
泛型。
23.1.3.30 Array.prototype.sort ( comparator )
对数组元素排序；若提供 comparator，必须可调用并按返回值符号决定顺序。
步骤：
- 若 comparator 非
undefined 且不可调用，抛TypeError 。 - obj = ?
ToObject (this value)。 - len = ?
LengthOfArrayLike (obj)。 - SortCompare = 抽象闭包(x, y)：? CompareArrayElements(x, y, comparator)。
- sortedList = ? SortIndexedProperties(obj, len, SortCompare,
skip-holes )。 - itemCount = sortedList 长度。
- j = 0。
- 当 j < itemCount：
- 注：跳过空洞后删除剩余索引以保留空洞数量。
- 当 j < len：
- ?
DeletePropertyOrThrow (obj, !ToString (𝔽 (j)))。 - j++。
- ?
- 返回 obj。
泛型。
23.1.3.30.1
SortIndexedProperties (
obj: an Object,
len: a non-negative integer,
SortCompare: an Abstract Closure with two parameters,
holes: skip-holes or read-through-holes ,
): either a normal completion containing a List of ECMAScript language values or a throw completion
- items = 空列表；k = 0。
- 当 k < len：
- Pk = !
ToString (𝔽 (k))。 - 若 holes =
skip-holes ：kRead = ?HasProperty (obj, Pk)；否则 kRead =true 。 - 若 kRead：kValue = ?
Get (obj, Pk)；追加 kValue。 - k++。
- Pk = !
- 以实现定义次序使用 SortCompare 排序 items；若出现 abrupt 完成即停止并返回。
- 返回 items。
排序顺序是上述算法步骤
除非指定
-
存在某个对小于 itemCount 的非负整数的数学排列 π，使得对每个小于 itemCount 的非负整数 j，元素
old[j] 与new[π(j)] 完全相同。 -
然后对所有非负整数 j 和 k（各自小于 itemCount），如果
ℝ (SortCompare(old[j], old[k])) < 0π(j) < π(k) 。 -
并且对于所有满足 j < k < itemCount 的非负整数 j 与 k，如果
ℝ (SortCompare(old[j], old[k])) = 0π(j) < π(k) ；即排序是稳定的。
这里记号
若一个抽象闭包或函数 comparator 对一组值 S 满足下述所有要求，则称其为该集合的一个一致的比较器。对集合 S 中（可能相同）的所有值 a、b、c，记号
-
调用 comparator(a, b) 时，对于特定的值对 a 与 b 总是返回相同的值 v。此外，v 是一个 Number，且 v 不是
NaN 。注意这意味着对于给定的 a 与 b，a <C b、a =C b、a >C b 三者中恰有一个为真。 - 调用 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 将集合 S 划分为等价类，并且这些等价类是全序的。
23.1.3.30.2
CompareArrayElements (
x: an ECMAScript language value,
y: an ECMAScript language value,
comparator: a function object or undefined ,
): either a normal completion containing a Number or an abrupt completion
- 若 x 与 y 均
undefined 返回+0 𝔽。 - 若 x 为
undefined 返回1 𝔽。 - 若 y 为
undefined 返回-1 𝔽。 - 若 comparator 非
undefined ：- v = ?
ToNumber (? Call(comparator,undefined , « x, y »))。 - 若 v 为
NaN 返回+0 𝔽。 - 返回 v。
- v = ?
- 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 )
从 start 删除 deleteCount 个元素并以 items 插入，返回被删除元素数组。
步骤：
- O = ?
ToObject (this value)；len = ?LengthOfArrayLike (O)。 - relativeStart = ?
ToIntegerOrInfinity (start)。 - 若 = -∞，actualStart = 0；否则若 <0，actualStart =
max (len+relativeStart,0)；否则 =min (relativeStart, len)。 - itemCount = items 长度。
- 若 start 不存在：actualDeleteCount = 0。
- 否则若 deleteCount 不存在：actualDeleteCount = len - actualStart。
- 否则 dc = ?
ToIntegerOrInfinity (deleteCount)；actualDeleteCount = clamp(dc, 0, len - actualStart)。 - 若 len + itemCount - actualDeleteCount > 253-1 抛
TypeError 。 - A = ?
ArraySpeciesCreate (O, actualDeleteCount)。 - k = 0。当 k < actualDeleteCount：
- from = !
ToString (𝔽 (actualStart + k))。 - 若 ?
HasProperty (O, from)：- fromValue = ?
Get (O, from)。 - ?
CreateDataPropertyOrThrow (A, !ToString (𝔽 (k)), fromValue)。
- fromValue = ?
- k++。
- from = !
- ?
Set (A,"length" ,𝔽 (actualDeleteCount),true )。 - 若 itemCount < actualDeleteCount：
- k = actualStart。
- 当 k < (len - actualDeleteCount)：
- k = len。
- 当 k > (len - actualDeleteCount + itemCount)：
- ?
DeletePropertyOrThrow (O, !ToString (𝔽 (k-1)))。 - k--。
- ?
- 否则若 itemCount > actualDeleteCount：
- k = actualStart。
- 对每个 E ∈ items：?
Set (O, !ToString (𝔽 (k)), E,true )；k++。 - ?
Set (O,"length" ,𝔽 (len - actualDeleteCount + itemCount),true )。 - 返回 A。
显式设置长度确保非内置数组仍正确。
泛型。
23.1.3.32 Array.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
支持 ECMA-402 的实现按其规范实现；否则使用此处规范。两个可选参数的意义由 ECMA-402 定义，未实现该 API 时不得另作他用。
ECMA-402 第一版未替换此方法的规范。
步骤：
与 toString 类似，但使用区域化的元素表示与分隔符。
泛型。
23.1.3.33 Array.prototype.toReversed ( )
返回一个新数组，其元素为原数组的反向拷贝。
- O = ?
ToObject (this value)，len = ?LengthOfArrayLike (O)。 - A = ?
ArrayCreate (len)。 - k = 0。
- 当 k < len：
- 返回 A。
23.1.3.34 Array.prototype.toSorted ( comparator )
返回排序后的新数组（不修改原数组）。
- 若 comparator 非
undefined 且不可调用，抛TypeError 。 - O = ?
ToObject (this value)，len = ?LengthOfArrayLike (O)。 - A = ?
ArrayCreate (len)。 - SortCompare = 抽象闭包(x, y)：? CompareArrayElements(x, y, comparator)。
- sortedList = ? SortIndexedProperties(O, len, SortCompare,
read-through-holes )。 - j = 0。
- 当 j < len：
- !
CreateDataPropertyOrThrow (A, !ToString (𝔽 (j)), sortedList[j])。 - j++。
- !
- 返回 A。
23.1.3.35 Array.prototype.toSpliced ( start, skipCount, ...items )
返回应用类 splice 操作后的新数组（不修改原数组）。
- O = ?
ToObject (this value)，len = ?LengthOfArrayLike (O)。 - relativeStart = ?
ToIntegerOrInfinity (start)。 - 若 = -∞，actualStart = 0；否则若 <0，actualStart =
max (len+relativeStart,0)；否则 actualStart =min (relativeStart, len)。 - insertCount = items 长度。
- 若 start 不存在：actualSkipCount = 0；否则若 skipCount 不存在：actualSkipCount = len - actualStart；否则 sc = ?
ToIntegerOrInfinity (skipCount)；actualSkipCount = clamp(sc, 0, len-actualStart)。 - newLen = len + insertCount - actualSkipCount。
- 若 newLen > 253-1 抛
TypeError 。 - A = ?
ArrayCreate (newLen)。 - i = 0；r = actualStart + actualSkipCount。
- 当 i < actualStart：
- Pi = !
ToString (𝔽 (i))。 - iValue = ?
Get (O, Pi)。 - !
CreateDataPropertyOrThrow (A, Pi, iValue)。 - i++。
- Pi = !
- 对 items 中每个 E：
- Pi = !
ToString (𝔽 (i))。 - !
CreateDataPropertyOrThrow (A, Pi, E)。 - i++。
- Pi = !
- 当 i < newLen：
- 返回 A。
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 )
将参数插入开头并保持顺序，返回新长度。
步骤：
- O = ?
ToObject (this value)；len = ?LengthOfArrayLike (O)。 - argCount = items 长度。
- 若 argCount > 0：
- ?
Set (O,"length" ,𝔽 (len + argCount),true )。 - 返回
𝔽 (len + argCount)。
此方法
泛型。
23.1.3.38 Array.prototype.values ( )
步骤：
- O = ?
ToObject (this value)。 - 返回
CreateArrayIterator (O,value )。
23.1.3.39 Array.prototype.with ( index, value )
返回替换给定索引后的新数组（不修改原数组）。
- O = ?
ToObject (this value)；len = ?LengthOfArrayLike (O)。 - relativeIndex = ?
ToIntegerOrInfinity (index)。 - 若 relativeIndex ≥ 0：actualIndex = relativeIndex；否则 actualIndex = len + relativeIndex。
- 若 actualIndex ≥ len 或 actualIndex < 0 抛
RangeError 。 - A = ?
ArrayCreate (len)。 - k = 0。
- 当 k < len：
- Pk = !
ToString (𝔽 (k))。 - 若 k = actualIndex：fromValue = value；否则 fromValue = ?
Get (O, Pk)。 - !
CreateDataPropertyOrThrow (A, Pk, fromValue)。 - k++。
- Pk = !
- 返回 A。
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]]:
这些名称在 ES2015 前不是标准 Array.prototype 自有属性；在 with 语句中应忽略以避免遮蔽外层绑定。
23.1.4 Array 实例的属性
Array 实例是数组异质对象，具有对应内部方法，并继承自 Array 原型。
Array 实例具有
23.1.4.1 length
初始属性特性：{ [[Writable]]:
减小
23.1.5 Array 迭代器对象
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 ( )
- O =
this 。 - 若 O 非对象抛
TypeError 。 - 若 O 不具备数组迭代器实例全部内部槽抛
TypeError 。 - array = O.[[IteratedArrayLike]]。
- 若 array 为
undefined 返回CreateIteratorResultObject (undefined ,true )。 - index = O.[[ArrayLikeNextIndex]]。
- kind = O.[[ArrayLikeIterationKind]]。
- 若 array 具有 [[TypedArrayName]]：
- taRecord =
MakeTypedArrayWithBufferWitnessRecord (array,seq-cst )。 - 若
IsTypedArrayOutOfBounds (taRecord) 为true 抛TypeError 。 - len =
TypedArrayLength (taRecord)。
- taRecord =
- 否则 len = ?
LengthOfArrayLike (array)。 - 若 index ≥ len：
- 设 O.[[IteratedArrayLike]] =
undefined 。 - 返回
CreateIteratorResultObject (undefined ,true )。
- 设 O.[[IteratedArrayLike]] =
- 设 O.[[ArrayLikeNextIndex]] = index + 1。
- indexNumber =
𝔽 (index)。 - 若 kind =
key ：result = indexNumber。 - 否则：
- elementKey = !
ToString (indexNumber)。 - elementValue = ?
Get (array, elementKey)。 - 若 kind =
value ：result = elementValue；否则（断言key+value ）result =CreateArrayFromList (« indexNumber, elementValue »)。
- elementKey = !
- 返回
CreateIteratorResultObject (result,false )。
23.1.5.2.2 %ArrayIteratorPrototype% [ %Symbol.toStringTag% ]
属性特性：{ [[Writable]]:
23.1.5.3 Array 迭代器实例的属性
Array 迭代器实例继承自内在对象
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 ] ] )
该方法被调用时执行以下步骤：
- 令 C 为
this 值。 - 若
IsConstructor (C) 为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))。 - 令 len 为 values 中元素的数量。
- 令 targetObj 为 ?
TypedArrayCreateFromConstructor (C, «𝔽 (len) »)。 - 令 k 为 0。
- 当 k < len 重复，
- 断言：values 现在为空列表。
- 返回 targetObj。
- 令 values 为 ?
- 注：source 不是可迭代对象，因此假定其已为
类数组对象 。 - 令 arrayLike 为 !
ToObject (source)。 - 令 len 为 ?
LengthOfArrayLike (arrayLike)。 - 令 targetObj 为 ?
TypedArrayCreateFromConstructor (C, «𝔽 (len) »)。 - 令 k 为 0。
- 当 k < len 重复，
- 返回 targetObj。
23.2.2.2 %TypedArray%.of ( ...items )
该方法被调用时执行以下步骤：
- 令 len 为 items 中元素的数量。
- 令 C 为
this 值。 - 若
IsConstructor (C) 为false ，抛出TypeError 异常。 - 令 newObj 为 ?
TypedArrayCreateFromConstructor (C, «𝔽 (len) »)。 - 令 k 为 0。
- 当 k < len 重复，
- 返回 newObj。
23.2.2.3 %TypedArray%.prototype
.prototype 的初始值是
该属性特性为 { [[Writable]]:
23.2.2.4 get %TypedArray% [ %Symbol.species% ]
[%Symbol.species%] 是一个存取器属性，其 set 访问器函数为
- 返回
this 值。
该函数
23.2.3 %TypedArray% 原型对象的属性
%TypedArray% 原型对象：
- 具有 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是 %TypedArray.prototype%。
- 是一个
普通对象 。 - 没有 [[ViewedArrayBuffer]] 或其他特定于 TypedArray 实例对象的内部槽。
23.2.3.1 %TypedArray%.prototype.at ( index )
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 令 relativeIndex 为 ?
ToIntegerOrInfinity (index)。 - 若 relativeIndex ≥ 0，则
- 令 k = relativeIndex。
- 否则，
- 令 k = len + relativeIndex。
- 若 k < 0 或 k ≥ len，返回
undefined 。 - 返回 !
Get (O, !ToString (𝔽 (k)))。
23.2.3.2 get %TypedArray%.prototype.buffer
.prototype.buffer 是一个存取器属性，其 set 访问器函数为
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[TypedArrayName]])。 - 断言：O 具有 [[ViewedArrayBuffer]] 内部槽。
- 令 buffer 为 O.[[ViewedArrayBuffer]]。
- 返回 buffer。
23.2.3.3 get %TypedArray%.prototype.byteLength
.prototype.byteLength 是一个存取器属性，其 set 访问器函数为
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[TypedArrayName]])。 - 断言：O 具有 [[ViewedArrayBuffer]] 内部槽。
- 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst )。 - 令 size 为
TypedArrayByteLength (taRecord)。 - 返回
𝔽 (size)。
23.2.3.4 get %TypedArray%.prototype.byteOffset
.prototype.byteOffset 是一个存取器属性，其 set 访问器函数为
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[TypedArrayName]])。 - 断言：O 具有 [[ViewedArrayBuffer]] 内部槽。
- 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst )。 - 若
IsTypedArrayOutOfBounds (taRecord) 为true ，返回+0 𝔽。 - 令 offset 为 O.[[ByteOffset]]。
- 返回
𝔽 (offset)。
23.2.3.5 %TypedArray%.prototype.constructor
.prototype.constructor 的初始值为
23.2.3.6 %TypedArray%.prototype.copyWithin ( target, start [ , end ] )
此方法参数的解释与用法与 Array.prototype.copyWithin 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 令 relativeTarget 为 ?
ToIntegerOrInfinity (target)。 - 若 relativeTarget = -∞，令 targetIndex = 0。
- 否则若 relativeTarget < 0，令 targetIndex =
max (len + relativeTarget, 0)。 - 否则令 targetIndex =
min (relativeTarget, len)。 - 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 若 relativeStart = -∞，令 startIndex = 0。
- 否则若 relativeStart < 0，令 startIndex =
max (len + relativeStart, 0)。 - 否则令 startIndex =
min (relativeStart, len)。 - 若 end 为
undefined ，令 relativeEnd = len；否则令 relativeEnd = ?ToIntegerOrInfinity (end)。 - 若 relativeEnd = -∞，令 endIndex = 0。
- 否则若 relativeEnd < 0，令 endIndex =
max (len + relativeEnd, 0)。 - 否则令 endIndex =
min (relativeEnd, len)。 - 令 count 为
min (endIndex - startIndex, len - targetIndex)。 - 若 count > 0，则
- 注：复制必须以保持源数据位级编码的方式进行。
- 令 buffer 为 O.[[ViewedArrayBuffer]]。
- 设 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst )。 - 若
IsTypedArrayOutOfBounds (taRecord) 为true ，抛出TypeError 异常。 - 设 len 为
TypedArrayLength (taRecord)。 - 令 elementSize 为
TypedArrayElementSize (O)。 - 令 byteOffset 为 O.[[ByteOffset]]。
- 令 bufferByteLimit 为 (len × elementSize) + 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 重复，
- 若 fromByteIndex < bufferByteLimit 且 toByteIndex < bufferByteLimit，则
- 令 value 为
GetValueFromBuffer (buffer, fromByteIndex,uint8 ,true ,unordered )。 - 执行
SetValueInBuffer (buffer, toByteIndex,uint8 , value,true ,unordered )。 - 设 fromByteIndex = fromByteIndex + direction。
- 设 toByteIndex = toByteIndex + direction。
- 设 countBytes = countBytes - 1。
- 令 value 为
- 否则，
- 设 countBytes = 0。
- 若 fromByteIndex < bufferByteLimit 且 toByteIndex < bufferByteLimit，则
- 返回 O。
23.2.3.7 %TypedArray%.prototype.entries ( )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
ValidateTypedArray (O,seq-cst )。 - 返回
CreateArrayIterator (O,key+value )。
23.2.3.8 %TypedArray%.prototype.every ( callback [ , thisArg ] )
该方法参数的解释与用法与 Array.prototype.every 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 若
IsCallable (callback) 为false ，抛出TypeError 异常。 - 令 k = 0。
- 当 k < len 重复，
- 返回
true 。
该方法不是泛型。
23.2.3.9 %TypedArray%.prototype.fill ( value [ , start [ , end ] ] )
该方法参数的解释与用法与 Array.prototype.fill 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 若 O.[[ContentType]] 为
bigint ，设 value 为 ?ToBigInt (value)。 - 否则，设 value 为 ?
ToNumber (value)。 - 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 若 relativeStart = -∞，令 startIndex = 0。
- 否则若 relativeStart < 0，令 startIndex =
max (len + relativeStart, 0)。 - 否则令 startIndex =
min (relativeStart, len)。 - 若 end 为
undefined ，令 relativeEnd = len；否则令 relativeEnd = ?ToIntegerOrInfinity (end)。 - 若 relativeEnd = -∞，令 endIndex = 0。
- 否则若 relativeEnd < 0，令 endIndex =
max (len + relativeEnd, 0)。 - 否则令 endIndex =
min (relativeEnd, len)。 - 设 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst )。 - 若
IsTypedArrayOutOfBounds (taRecord) 为true ，抛出TypeError 异常。 - 设 len 为
TypedArrayLength (taRecord)。 - 设 endIndex =
min (endIndex, len)。 - 令 k = startIndex。
- 当 k < endIndex 重复，
- 返回 O。
23.2.3.10 %TypedArray%.prototype.filter ( callback [ , thisArg ] )
该方法参数的解释与用法与 Array.prototype.filter 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 若
IsCallable (callback) 为false ，抛出TypeError 异常。 - 令 kept 为一个新的空列表。
- 令 captured 为 0。
- 令 k 为 0。
- 当 k < len 重复，
- 令 A 为 ?
TypedArraySpeciesCreate (O, «𝔽 (captured) »)。 - 令 n = 0。
- 对 kept 中每个元素 e：
- 返回 A。
该方法不是泛型。
23.2.3.11 %TypedArray%.prototype.find ( predicate [ , thisArg ] )
该方法参数的解释与用法与 Array.prototype.find 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 令 findRec 为 ?
FindViaPredicate (O, len,ascending , predicate, thisArg)。 - 返回 findRec.[[Value]]。
该方法不是泛型。
23.2.3.12 %TypedArray%.prototype.findIndex ( predicate [ , thisArg ] )
该方法参数的解释与用法与 Array.prototype.findIndex 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 令 findRec 为 ?
FindViaPredicate (O, len,ascending , predicate, thisArg)。 - 返回 findRec.[[Index]]。
该方法不是泛型。
23.2.3.13 %TypedArray%.prototype.findLast ( predicate [ , thisArg ] )
该方法参数的解释与用法与 Array.prototype.findLast 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 令 findRec 为 ?
FindViaPredicate (O, len,descending , predicate, thisArg)。 - 返回 findRec.[[Value]]。
该方法不是泛型。
23.2.3.14 %TypedArray%.prototype.findLastIndex ( predicate [ , thisArg ] )
该方法参数的解释与用法与 Array.prototype.findLastIndex 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 令 findRec 为 ?
FindViaPredicate (O, len,descending , predicate, thisArg)。 - 返回 findRec.[[Index]]。
该方法不是泛型。
23.2.3.15 %TypedArray%.prototype.forEach ( callback [ , thisArg ] )
该方法参数的解释与用法与 Array.prototype.forEach 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 若
IsCallable (callback) 为false ，抛出TypeError 异常。 - 令 k = 0。
- 当 k < len 重复，
- 返回
undefined 。
该方法不是泛型。
23.2.3.16 %TypedArray%.prototype.includes ( searchElement [ , fromIndex ] )
该方法参数的解释与用法与 Array.prototype.includes 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 若 len = 0，返回
false 。 - 令 n 为 ?
ToIntegerOrInfinity (fromIndex)。 - 断言：若 fromIndex 为
undefined ，则 n 为 0。 - 若 n = +∞，返回
false 。 - 否则若 n = -∞，设 n = 0。
- 若 n ≥ 0，则
- 令 k = n。
- 否则，
- 令 k = len + n。
- 若 k < 0，设 k = 0。
- 当 k < len 重复，
- 令 elementK 为 !
Get (O, !ToString (𝔽 (k)))。 - 若
SameValueZero (searchElement, elementK) 为true ，返回true 。 - 设 k = k + 1。
- 令 elementK 为 !
- 返回
false 。
该方法不是泛型。
23.2.3.17 %TypedArray%.prototype.indexOf ( searchElement [ , fromIndex ] )
该方法参数的解释与用法与 Array.prototype.indexOf 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 若 len = 0，返回
-1 𝔽。 - 令 n 为 ?
ToIntegerOrInfinity (fromIndex)。 - 断言：若 fromIndex 为
undefined ，则 n 为 0。 - 若 n = +∞，返回
-1 𝔽。 - 否则若 n = -∞，设 n = 0。
- 若 n ≥ 0，则
- 令 k = n。
- 否则，
- 令 k = len + n。
- 若 k < 0，设 k = 0。
- 当 k < len 重复，
- 令 Pk = !
ToString (𝔽 (k))。 - 令 kPresent = !
HasProperty (O, Pk)。 - 若 kPresent 为
true ，则- 令 elementK = !
Get (O, Pk)。 - 若
IsStrictlyEqual (searchElement, elementK) 为true ，返回𝔽 (k)。
- 令 elementK = !
- 设 k = k + 1。
- 令 Pk = !
- 返回
-1 𝔽。
该方法不是泛型。
23.2.3.18 %TypedArray%.prototype.join ( separator )
该方法参数的解释与用法与 Array.prototype.join 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 若 separator 为
undefined ，令 sep ="," 。 - 否则，令 sep = ?
ToString (separator)。 - 令 R 为空字符串。
- 令 k = 0。
- 当 k < len 重复，
- 返回 R。
该方法不是泛型。
23.2.3.19 %TypedArray%.prototype.keys ( )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
ValidateTypedArray (O,seq-cst )。 - 返回
CreateArrayIterator (O,key )。
23.2.3.20 %TypedArray%.prototype.lastIndexOf ( searchElement [ , fromIndex ] )
该方法参数的解释与用法与 Array.prototype.lastIndexOf 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 若 len = 0，返回
-1 𝔽。 - 若提供 fromIndex，令 n 为 ?
ToIntegerOrInfinity (fromIndex)；否则令 n = len - 1。 - 若 n = -∞，返回
-1 𝔽。 - 若 n ≥ 0，则
- 令 k =
min (n, len - 1)。
- 令 k =
- 否则，
- 令 k = len + n。
- 当 k ≥ 0 重复，
- 令 Pk = !
ToString (𝔽 (k))。 - 令 kPresent = !
HasProperty (O, Pk)。 - 若 kPresent 为
true ，则- 令 elementK = !
Get (O, Pk)。 - 若
IsStrictlyEqual (searchElement, elementK) 为true ，返回𝔽 (k)。
- 令 elementK = !
- 设 k = k - 1。
- 令 Pk = !
- 返回
-1 𝔽。
该方法不是泛型。
23.2.3.21 get %TypedArray%.prototype.length
.prototype.length 是一个存取器属性，其 set 访问器函数为
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[TypedArrayName]])。 - 断言：O 具有 [[ViewedArrayBuffer]] 与 [[ArrayLength]] 内部槽。
- 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst )。 - 若
IsTypedArrayOutOfBounds (taRecord) 为true ，返回+0 𝔽。 - 令 length 为
TypedArrayLength (taRecord)。 - 返回
𝔽 (length)。
该函数不是泛型。
23.2.3.22 %TypedArray%.prototype.map ( callback [ , thisArg ] )
该方法参数的解释与用法与 Array.prototype.map 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 若
IsCallable (callback) 为false ，抛出TypeError 异常。 - 令 A 为 ?
TypedArraySpeciesCreate (O, «𝔽 (len) »)。 - 令 k = 0。
- 当 k < len 重复，
- 返回 A。
该方法不是泛型。
23.2.3.23 %TypedArray%.prototype.reduce ( callback [ , initialValue ] )
该方法参数的解释与用法与 Array.prototype.reduce 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 若
IsCallable (callback) 为false ，抛出TypeError 异常。 - 若 len = 0 且 initialValue 不存在，抛出
TypeError 异常。 - 令 k = 0。
- 令 accumulator =
undefined 。 - 若存在 initialValue，则
- 设 accumulator = initialValue。
- 否则，
- 当 k < len 重复，
- 返回 accumulator。
该方法不是泛型。
23.2.3.24 %TypedArray%.prototype.reduceRight ( callback [ , initialValue ] )
该方法参数的解释与用法与 Array.prototype.reduceRight 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 若
IsCallable (callback) 为false ，抛出TypeError 异常。 - 若 len = 0 且 initialValue 不存在，抛出
TypeError 异常。 - 令 k = len - 1。
- 令 accumulator =
undefined 。 - 若存在 initialValue，则
- 设 accumulator = initialValue。
- 否则，
- 当 k ≥ 0 重复，
- 返回 accumulator。
该方法不是泛型。
23.2.3.25 %TypedArray%.prototype.reverse ( )
该方法参数的解释与用法与 Array.prototype.reverse 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 令 middle =
floor (len / 2)。 - 令 lower = 0。
- 当 lower ≠ middle 重复，
- 返回 O。
该方法不是泛型。
23.2.3.26 %TypedArray%.prototype.set ( source [ , offset ] )
该方法在此 TypedArray 中设置多个值，从 source 读取这些值。具体细节依据 source 的类型不同而不同。可选的 offset 指定开始写入的首个元素索引。如省略则视为 0。
其被调用时执行以下步骤：
- 令 target 为
this 值。 - 执行 ?
RequireInternalSlot (target, [[TypedArrayName]])。 - 断言：target 具有 [[ViewedArrayBuffer]] 内部槽。
- 令 targetOffset 为 ?
ToIntegerOrInfinity (offset)。 - 若 targetOffset < 0，抛出
RangeError 异常。 - 若 source 是具有 [[TypedArrayName]] 内部槽的对象，则
- 执行 ?
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)。 - 令 src 为 ?
ToObject (source)。 - 令 srcLength 为 ?
LengthOfArrayLike (src)。 - 若 targetOffset = +∞，抛出
RangeError 异常。 - 若 srcLength + targetOffset > targetLength，抛出
RangeError 异常。 - 令 k = 0。
- 当 k < srcLength 重复，
- 令 Pk = !
ToString (𝔽 (k))。 - 令 value = ?
Get (src, Pk)。 - 令 targetIndex =
𝔽 (targetOffset + k)。 - 执行 ?
TypedArraySetElement (target, targetIndex, value)。 - 设 k = k + 1。
- 令 Pk = !
- 返回
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)。 - 令 srcBuffer 为 source.[[ViewedArrayBuffer]]。
- 令 srcRecord 为
MakeTypedArrayWithBufferWitnessRecord (source,seq-cst )。 - 若
IsTypedArrayOutOfBounds (srcRecord) 为true ，抛出TypeError 异常。 - 令 srcLength 为
TypedArrayLength (srcRecord)。 - 令 targetType 为
TypedArrayElementType (target)。 - 令 targetElementSize 为
TypedArrayElementSize (target)。 - 令 targetByteOffset 为 target.[[ByteOffset]]。
- 令 srcType 为
TypedArrayElementType (source)。 - 令 srcElementSize 为
TypedArrayElementSize (source)。 - 令 srcByteOffset 为 source.[[ByteOffset]]。
- 若 targetOffset = +∞，抛出
RangeError 异常。 - 若 srcLength + targetOffset > targetLength，抛出
RangeError 异常。 - 若 target.[[ContentType]] 不等于 source.[[ContentType]]，抛出
TypeError 异常。 - 若
IsSharedArrayBuffer (srcBuffer) 为true 、IsSharedArrayBuffer (targetBuffer) 为true 且 srcBuffer.[[ArrayBufferData]] 为 targetBuffer.[[ArrayBufferData]]，令 sameSharedArrayBuffer =true ；否则令 sameSharedArrayBuffer =false 。 - 若
SameValue (srcBuffer, targetBuffer) 为true 或 sameSharedArrayBuffer 为true ，则- 令 srcByteLength 为
TypedArrayByteLength (srcRecord)。 - 设 srcBuffer 为 ?
CloneArrayBuffer (srcBuffer, srcByteOffset, srcByteLength)。 - 令 srcByteIndex = 0。
- 令 srcByteLength 为
- 否则，
- 令 srcByteIndex = srcByteOffset。
- 令 targetByteIndex = (targetOffset × targetElementSize) + targetByteOffset。
- 令 limit = targetByteIndex + (targetElementSize × srcLength)。
- 若 srcType 是 targetType，则
- 注：复制必须保持源数据的位级编码。
- 当 targetByteIndex < limit 重复，
- 令 value 为
GetValueFromBuffer (srcBuffer, srcByteIndex,uint8 ,true ,unordered )。 - 执行
SetValueInBuffer (targetBuffer, targetByteIndex,uint8 , value,true ,unordered )。 - 设 srcByteIndex = srcByteIndex + 1。
- 设 targetByteIndex = targetByteIndex + 1。
- 令 value 为
- 否则，
- 当 targetByteIndex < limit 重复，
- 令 value 为
GetValueFromBuffer (srcBuffer, srcByteIndex, srcType,true ,unordered )。 - 执行
SetValueInBuffer (targetBuffer, targetByteIndex, targetType, value,true ,unordered )。 - 设 srcByteIndex = srcByteIndex + srcElementSize。
- 设 targetByteIndex = targetByteIndex + targetElementSize。
- 令 value 为
- 当 targetByteIndex < limit 重复，
- 返回
unused 。
23.2.3.27 %TypedArray%.prototype.slice ( start, end )
该方法参数的解释与用法与 Array.prototype.slice 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 srcArrayLength 为
TypedArrayLength (taRecord)。 - 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 若 relativeStart = -∞，令 startIndex = 0。
- 否则若 relativeStart < 0，令 startIndex =
max (srcArrayLength + relativeStart, 0)。 - 否则令 startIndex =
min (relativeStart, srcArrayLength)。 - 若 end 为
undefined ，令 relativeEnd = srcArrayLength；否则令 relativeEnd = ?ToIntegerOrInfinity (end)。 - 若 relativeEnd = -∞，令 endIndex = 0。
- 否则若 relativeEnd < 0，令 endIndex =
max (srcArrayLength + relativeEnd, 0)。 - 否则令 endIndex =
min (relativeEnd, srcArrayLength)。 - 令 countBytes =
max (endIndex - startIndex, 0)。 - 令 A 为 ?
TypedArraySpeciesCreate (O, «𝔽 (countBytes) »)。 - 若 countBytes > 0，则
- 设 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst )。 - 若
IsTypedArrayOutOfBounds (taRecord) 为true ，抛出TypeError 异常。 - 设 endIndex =
min (endIndex,TypedArrayLength (taRecord))。 - 设 countBytes =
max (endIndex - startIndex, 0)。 - 令 srcType =
TypedArrayElementType (O)。 - 令 targetType =
TypedArrayElementType (A)。 - 若 srcType 是 targetType，则
- 注：传输必须保持源数据的位级编码。
- 令 srcBuffer = O.[[ViewedArrayBuffer]]。
- 令 targetBuffer = A.[[ViewedArrayBuffer]]。
- 令 elementSize =
TypedArrayElementSize (O)。 - 令 srcByteOffset = O.[[ByteOffset]]。
- 令 srcByteIndex = (startIndex × elementSize) + srcByteOffset。
- 令 targetByteIndex = A.[[ByteOffset]]。
- 令 endByteIndex = targetByteIndex + (countBytes × elementSize)。
- 当 targetByteIndex < endByteIndex 重复，
- 令 value 为
GetValueFromBuffer (srcBuffer, srcByteIndex,uint8 ,true ,unordered )。 - 执行
SetValueInBuffer (targetBuffer, targetByteIndex,uint8 , value,true ,unordered )。 - 设 srcByteIndex = srcByteIndex + 1。
- 设 targetByteIndex = targetByteIndex + 1。
- 令 value 为
- 否则，
- 设 taRecord 为
- 返回 A。
该方法不是泛型。
23.2.3.28 %TypedArray%.prototype.some ( callback [ , thisArg ] )
该方法参数的解释与用法与 Array.prototype.some 相同。
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 若
IsCallable (callback) 为false ，抛出TypeError 异常。 - 令 k = 0。
- 当 k < len 重复，
- 返回
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 )。 - 令 len 为
TypedArrayLength (taRecord)。 - 注：以下闭包执行数值比较而非
23.1.3.30 中使用的字符串比较。 - 令 SortCompare 为具有参数 (x, y) 并捕获 comparator 的新抽象闭包，调用时执行：
- 返回 ?
CompareTypedArrayElements (x, y, comparator)。
- 返回 ?
- 令 sortedList 为 ? SortIndexedProperties(obj, len, SortCompare,
read-through-holes )。 - 令 j = 0。
- 当 j < len 重复，
- 返回 obj。
因为
23.2.3.30 %TypedArray%.prototype.subarray ( start, end )
该方法返回一个新的 TypedArray，其元素类型与该 TypedArray 相同，其 ArrayBuffer 为该 TypedArray 的 ArrayBuffer，引用从 start（含）到 end（不含）
其被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[TypedArrayName]])。 - 断言：O 具有 [[ViewedArrayBuffer]] 内部槽。
- 令 buffer 为 O.[[ViewedArrayBuffer]]。
- 令 srcRecord 为
MakeTypedArrayWithBufferWitnessRecord (O,seq-cst )。 - 若
IsTypedArrayOutOfBounds (srcRecord) 为true ，则- 令 srcLength = 0。
- 否则，
- 令 srcLength =
TypedArrayLength (srcRecord)。
- 令 srcLength =
- 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 若 relativeStart = -∞，令 startIndex = 0。
- 否则若 relativeStart < 0，令 startIndex =
max (srcLength + relativeStart, 0)。 - 否则令 startIndex =
min (relativeStart, srcLength)。 - 令 elementSize 为
TypedArrayElementSize (O)。 - 令 srcByteOffset 为 O.[[ByteOffset]]。
- 令 beginByteOffset = srcByteOffset + (startIndex × elementSize)。
- 若 O.[[ArrayLength]] 为
auto 且 end 为undefined ，则- 令 argumentsList 为 « buffer,
𝔽 (beginByteOffset) »。
- 令 argumentsList 为 « buffer,
- 否则，
- 若 end 为
undefined ，令 relativeEnd = srcLength；否则令 relativeEnd = ?ToIntegerOrInfinity (end)。 - 若 relativeEnd = -∞，令 endIndex = 0。
- 否则若 relativeEnd < 0，令 endIndex =
max (srcLength + relativeEnd, 0)。 - 否则令 endIndex =
min (relativeEnd, srcLength)。 - 令 newLength =
max (endIndex - startIndex, 0)。 - 令 argumentsList = « buffer,
𝔽 (beginByteOffset),𝔽 (newLength) »。
- 若 end 为
- 返回 ?
TypedArraySpeciesCreate (O, argumentsList)。
该方法不是泛型。
23.2.3.31 %TypedArray%.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
这是一个不同的方法，实现与 Array.prototype.toLocaleString 的算法相同，只是用
该方法不是泛型。在求值算法前，使用
若 ECMAScript 实现包含 ECMA-402 国际化 API，则该方法基于 ECMA-402 规范中 Array.prototype.toLocaleString 的算法。
23.2.3.32 %TypedArray%.prototype.toReversed ( )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 令 A 为 ?
TypedArrayCreateSameType (O, len)。 - 令 k = 0。
- 当 k < len 重复，
- 返回 A。
23.2.3.33 %TypedArray%.prototype.toSorted ( comparator )
该方法被调用时执行以下步骤：
- 若 comparator 不为
undefined 且IsCallable (comparator) 为false ，抛出TypeError 异常。 - 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 令 A 为 ?
TypedArrayCreateSameType (O, len)。 - 注：以下闭包执行数值比较，而非
23.1.3.34 中使用的字符串比较。 - 令 SortCompare 为具有参数 (x, y) 并捕获 comparator 的新抽象闭包，调用时执行：
- 返回 ?
CompareTypedArrayElements (x, y, comparator)。
- 返回 ?
- 令 sortedList 为 ? SortIndexedProperties(O, len, SortCompare,
read-through-holes )。 - 令 j = 0。
- 当 j < len 重复，
- 返回 A。
23.2.3.34 %TypedArray%.prototype.toString ( )
23.2.3.35 %TypedArray%.prototype.values ( )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
ValidateTypedArray (O,seq-cst )。 - 返回
CreateArrayIterator (O,value )。
23.2.3.36 %TypedArray%.prototype.with ( index, value )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 令 taRecord 为 ?
ValidateTypedArray (O,seq-cst )。 - 令 len 为
TypedArrayLength (taRecord)。 - 令 relativeIndex 为 ?
ToIntegerOrInfinity (index)。 - 若 relativeIndex ≥ 0，令 actualIndex = relativeIndex。
- 否则，令 actualIndex = len + relativeIndex。
- 若 O.[[ContentType]] 为
bigint ，令 numericValue = ?ToBigInt (value)。 - 否则，令 numericValue = ?
ToNumber (value)。 - 若
IsValidIntegerIndex (O,𝔽 (actualIndex)) 为false ，抛出RangeError 异常。 - 令 A 为 ?
TypedArrayCreateSameType (O, len)。 - 令 k = 0。
- 当 k < len 重复，
- 返回 A。
23.2.3.37 %TypedArray%.prototype [ %Symbol.iterator% ] ( )
23.2.3.38 get %TypedArray%.prototype [ %Symbol.toStringTag% ]
.prototype[%Symbol.toStringTag%] 是一个存取器属性，其 set 访问器函数为
- 令 O 为
this 值。 - 若 O 不是对象，返回
undefined 。 - 若 O 不具有 [[TypedArrayName]] 内部槽，返回
undefined 。 - 令 name = O.[[TypedArrayName]]。
- 断言：name 是一个字符串。
- 返回 name。
该属性特性为 { [[Enumerable]]:
该函数
23.2.4 TypedArray 对象的抽象操作
23.2.4.1 TypedArrayCreateFromConstructor ( constructor, argumentList )
The abstract operation TypedArrayCreateFromConstructor takes arguments constructor (a constructor) and argumentList (a
- 令 newTypedArray 为 ? Construct(constructor, argumentList)。
- 令 taRecord 为 ?
ValidateTypedArray (newTypedArray,seq-cst )。 - 断言：newTypedArray 具有
TypedArray 实例的属性 中提及的所有内部槽。 - 若 argumentList 中元素数量为 1 且 argumentList[0]
是 Number ，则- 若
IsTypedArrayOutOfBounds (taRecord) 为true ，抛出TypeError 异常。 - 令 length 为
TypedArrayLength (taRecord)。 - 若 length <
ℝ (argumentList[0])，抛出TypeError 异常。
- 若
- 返回 newTypedArray。
23.2.4.2 TypedArrayCreateSameType ( exemplar, length )
The abstract operation TypedArrayCreateSameType takes arguments exemplar (a
- 令 constructor 为与 exemplar.[[TypedArrayName]] 的
构造函数 名称关联的内在对象，见Table 73 。 - 令 result 为 ?
TypedArrayCreateFromConstructor (constructor, «𝔽 (length) »)。 - 断言：result 具有 [[TypedArrayName]] 与 [[ContentType]] 内部槽。
- 断言：result.[[ContentType]] 为 exemplar.[[ContentType]]。
- 返回 result。
23.2.4.3 TypedArraySpeciesCreate ( exemplar, argumentList )
The abstract operation TypedArraySpeciesCreate takes arguments exemplar (a
- 令 defaultConstructor 为与 exemplar.[[TypedArrayName]] 的
构造函数 名称关联的内在对象，见Table 73 。 - 令 constructor 为 ?
SpeciesConstructor (exemplar, defaultConstructor)。 - 令 result 为 ?
TypedArrayCreateFromConstructor (constructor, argumentList)。 - 若 result.[[ContentType]] 不为 exemplar.[[ContentType]]，抛出
TypeError 异常。 - 返回 result。
23.2.4.4 ValidateTypedArray ( O, order )
The abstract operation ValidateTypedArray takes arguments O (an ECMAScript language value) and order (
- 执行 ?
RequireInternalSlot (O, [[TypedArrayName]])。 - 断言：O 具有 [[ViewedArrayBuffer]] 内部槽。
- 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (O, order)。 - 若
IsTypedArrayOutOfBounds (taRecord) 为true ，抛出TypeError 异常。 - 返回 taRecord。
23.2.4.5 TypedArrayElementSize ( O )
The abstract operation TypedArrayElementSize takes argument O (a
- 返回在
Table 73 中为 O.[[TypedArrayName]] 指定的元素大小值。
23.2.4.6 TypedArrayElementType ( O )
The abstract operation TypedArrayElementType takes argument O (a
- 返回在
Table 73 中为 O.[[TypedArrayName]] 指定的元素类型值。
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 与 y 同为 Number，或 x 与 y 同为 BigInt。
- 若 comparator 不为
undefined ，则- 令 v 为 ?
ToNumber (? Call(comparator,undefined , « x, y »))。 - 若 v 为
NaN ，返回+0 𝔽。 - 返回 v。
- 令 v 为 ?
- 若 x 和 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 73 中用作构造函数 名的名称不同于 TypedArray。 - 是其行为根据参数数量与类型而不同的函数。一次 TypedArray 调用的实际行为取决于传入的参数数量与种类。
- 不应作为函数被调用，若以此方式调用将抛出异常。
- 可作为类定义
extends子句的值。意在继承所规定 TypedArray 行为的子类构造函数 必须包含对 TypedArray构造函数 的super调用，以使用支持%TypedArray% .prototype内置方法所需的内部状态创建并初始化子类实例。
23.2.5.1 TypedArray ( ...args )
每个 TypedArray
- 若 NewTarget 为
undefined ，抛出TypeError 异常。 - 令 constructorName 为此 TypedArray
构造函数 在Table 73 中指定的构造函数 名称的字符串值。 - 令 proto 为
"%TypedArray.prototype%"。 - 令 numberOfArgs 为 args 中元素的数量。
- 若 numberOfArgs = 0，则
- 返回 ?
AllocateTypedArray (constructorName, NewTarget, proto, 0)。
- 返回 ?
- 否则，
- 令 firstArgument = args[0]。
- 若 firstArgument 是对象，则
- 令 O 为 ?
AllocateTypedArray (constructorName, NewTarget, proto)。 - 若 firstArgument 具有 [[TypedArrayName]] 内部槽，则
- 执行 ?
InitializeTypedArrayFromTypedArray (O, firstArgument)。
- 执行 ?
- 否则若 firstArgument 具有 [[ArrayBufferData]] 内部槽，则
- 若 numberOfArgs > 1，令 byteOffset = args[1]；否则 byteOffset =
undefined 。 - 若 numberOfArgs > 2，令 length = args[2]；否则 length =
undefined 。 - 执行 ?
InitializeTypedArrayFromArrayBuffer (O, firstArgument, byteOffset, length)。
- 若 numberOfArgs > 1，令 byteOffset = args[1]；否则 byteOffset =
- 否则，
- 断言：firstArgument 是对象且不具有 [[TypedArrayName]] 或 [[ArrayBufferData]]。
- 令 usingIterator = ?
GetMethod (firstArgument,%Symbol.iterator% )。 - 若 usingIterator 不为
undefined ，则- 令 values = ?
IteratorToList (?GetIteratorFromMethod (firstArgument, usingIterator))。 - 执行 ?
InitializeTypedArrayFromList (O, values)。
- 令 values = ?
- 否则，
- 注：firstArgument 不是可迭代对象，因此假定其已为
类数组对象 。 - 执行 ?
InitializeTypedArrayFromArrayLike (O, firstArgument)。
- 注：firstArgument 不是可迭代对象，因此假定其已为
- 返回 O。
- 令 O 为 ?
- 否则，
- 断言：firstArgument 不是对象。
- 令 elementLength = ?
ToIndex (firstArgument)。 - 返回 ?
AllocateTypedArray (constructorName, NewTarget, proto, elementLength)。
23.2.5.1.1 AllocateTypedArray ( constructorName, newTarget, defaultProto [ , length ] )
The abstract operation AllocateTypedArray takes arguments constructorName (a String which is the name of a
- 令 proto 为 ?
GetPrototypeFromConstructor (newTarget, defaultProto)。 - 令 obj 为
TypedArrayCreate (proto)。 - 断言：obj.[[ViewedArrayBuffer]] 为
undefined 。 - 设 obj.[[TypedArrayName]] = constructorName。
- 若 constructorName 为
"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 ( O, srcArray )
The abstract operation InitializeTypedArrayFromTypedArray takes arguments O (a
- 令 srcData = srcArray.[[ViewedArrayBuffer]]。
- 令 elementType =
TypedArrayElementType (O)。 - 令 elementSize =
TypedArrayElementSize (O)。 - 令 srcType =
TypedArrayElementType (srcArray)。 - 令 srcElementSize =
TypedArrayElementSize (srcArray)。 - 令 srcByteOffset = srcArray.[[ByteOffset]]。
- 令 srcRecord 为
MakeTypedArrayWithBufferWitnessRecord (srcArray,seq-cst )。 - 若
IsTypedArrayOutOfBounds (srcRecord) 为true ，抛出TypeError 异常。 - 令 elementLength =
TypedArrayLength (srcRecord)。 - 令 byteLength = elementSize × elementLength。
- 若 elementType 是 srcType，则
- 令 data = ?
CloneArrayBuffer (srcData, srcByteOffset, byteLength)。
- 令 data = ?
- 否则，
- 令 data = ?
AllocateArrayBuffer (%ArrayBuffer% , byteLength)。 - 若 srcArray.[[ContentType]] 不等于 O.[[ContentType]]，抛出
TypeError 异常。 - 令 srcByteIndex = srcByteOffset。
- 令 targetByteIndex = 0。
- 令 count = elementLength。
- 当 count > 0 重复，
- 令 value =
GetValueFromBuffer (srcData, srcByteIndex, srcType,true ,unordered )。 - 执行
SetValueInBuffer (data, targetByteIndex, elementType, value,true ,unordered )。 - 设 srcByteIndex = srcByteIndex + srcElementSize。
- 设 targetByteIndex = targetByteIndex + elementSize。
- 设 count = count - 1。
- 令 value =
- 令 data = ?
- 设 O.[[ViewedArrayBuffer]] = data。
- 设 O.[[ByteLength]] = byteLength。
- 设 O.[[ByteOffset]] = 0。
- 设 O.[[ArrayLength]] = elementLength。
- 返回
unused 。
23.2.5.1.3 InitializeTypedArrayFromArrayBuffer ( O, buffer, byteOffset, length )
The abstract operation InitializeTypedArrayFromArrayBuffer takes arguments O (a
- 令 elementSize =
TypedArrayElementSize (O)。 - 令 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 异常。 - 设 O.[[ByteLength]] =
auto 。 - 设 O.[[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 异常。
- 设 O.[[ByteLength]] = newByteLength。
- 设 O.[[ArrayLength]] = newByteLength / elementSize。
- 若 length 为
- 设 O.[[ViewedArrayBuffer]] = buffer。
- 设 O.[[ByteOffset]] = offset。
- 返回
unused 。
23.2.5.1.4 InitializeTypedArrayFromList ( O, values )
The abstract operation InitializeTypedArrayFromList takes arguments O (a
- 令 len 为 values 中的元素数量。
- 执行 ?
AllocateTypedArrayBuffer (O, len)。 - 令 k = 0。
- 当 k < len 重复，
- 断言：values 现在为空列表。
- 返回
unused 。
23.2.5.1.5 InitializeTypedArrayFromArrayLike ( O, arrayLike )
The abstract operation InitializeTypedArrayFromArrayLike takes arguments O (a
- 令 len 为 ?
LengthOfArrayLike (arrayLike)。 - 执行 ?
AllocateTypedArrayBuffer (O, len)。 - 令 k = 0。
- 当 k < len 重复，
- 返回
unused 。
23.2.5.1.6 AllocateTypedArrayBuffer ( O, length )
The abstract operation AllocateTypedArrayBuffer takes arguments O (a
- 断言：O.[[ViewedArrayBuffer]] 为
undefined 。 - 令 elementSize =
TypedArrayElementSize (O)。 - 令 byteLength = elementSize × length。
- 令 data = ?
AllocateArrayBuffer (%ArrayBuffer% , byteLength)。 - 设 O.[[ViewedArrayBuffer]] = data。
- 设 O.[[ByteLength]] = byteLength。
- 设 O.[[ByteOffset]] = 0。
- 设 O.[[ArrayLength]] = length。
- 返回
unused 。
23.2.6 TypedArray 构造函数的属性
每个 TypedArray
- 具有 [[Prototype]] 内部槽，其值为
%TypedArray% 。 - 具有
"length" 属性，其值为3 𝔽。 - 具有
"name" 属性，其值为在Table 73 中为其指定的构造函数 名称的字符串值。 - 具有以下属性：
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
23.2.8 TypedArray 实例的属性
TypedArray 实例是
24 键控集合（Keyed Collections）
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 为
- 令 k 为
Completion (Get (next,"0" ))。 IfAbruptCloseIterator (k, iteratorRecord)。- 令 v 为
Completion (Get (next,"1" ))。 IfAbruptCloseIterator (v, iteratorRecord)。- 令 status 为
Completion (Call(adder, target, « k, v »))。 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 返回该键的元素的数组。
callback 以两个参数被调用：元素的值以及该元素的索引。
groupBy 的返回值是一个 Map。
该函数被调用时执行以下步骤：
- 令 groups 为 ?
GroupBy (items, callback,collection )。 - 令 map 为 ! Construct(
%Map% )。 - 对 groups 中每个
Record { [[Key]], [[Elements]] } g：- 令 elements 为
CreateArrayFromList (g.[[Elements]])。 - 令 entry 为记录 { [[Key]]: g.[[Key]], [[Value]]: elements }。
- 将 entry 追加到 map.[[MapData]]。
- 令 elements 为
- 返回 map。
24.1.2.2 Map.prototype
Map.prototype 的初始值是
该属性具有 { [[Writable]]:
24.1.2.3 get Map [ %Symbol.species% ]
Map[%Symbol.species%] 是一个存取器属性，其 set 访问器函数为
- 返回
this 值。
该函数
创建派生集合对象的方法应调用
24.1.3 Map 原型对象的属性
Map 原型对象：
- 是 %Map.prototype%。
- 有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是一个
普通对象 。 - 没有 [[MapData]] 内部槽。
24.1.3.1 Map.prototype.clear ( )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 执行 ?
RequireInternalSlot (M, [[MapData]])。 - 对 M.[[MapData]] 中每个
Record { [[Key]], [[Value]] } p：- 将 p.[[Key]] 设为
empty 。 - 将 p.[[Value]] 设为
empty 。
- 将 p.[[Key]] 设为
- 返回
undefined 。
24.1.3.2 Map.prototype.constructor
Map.prototype.constructor 的初始值是
24.1.3.3 Map.prototype.delete ( key )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 执行 ?
RequireInternalSlot (M, [[MapData]])。 - 将 key 设为
CanonicalizeKeyedCollectionKey (key)。 - 对 M.[[MapData]] 中每个
Record { [[Key]], [[Value]] } p：- 如果 p.[[Key]] 不是
empty 且SameValue (p.[[Key]], key) 为true ，则- 将 p.[[Key]] 设为
empty 。 - 将 p.[[Value]] 设为
empty 。 - 返回
true 。
- 将 p.[[Key]] 设为
- 如果 p.[[Key]] 不是
- 返回
false 。
值
24.1.3.4 Map.prototype.entries ( )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 返回 ?
CreateMapIterator (M,key+value )。
24.1.3.5 Map.prototype.forEach ( callback [ , thisArg ] )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 执行 ?
RequireInternalSlot (M, [[MapData]])。 - 如果
IsCallable (callback) 为false ，抛出TypeError 异常。 - 令 entries 为 M.[[MapData]]。
- 令 numEntries 为 entries 中元素的数量。
- 令 index 为 0。
- 当 index < numEntries 重复，
- 令 e 为 entries[index]。
- 将 index 设为 index + 1。
- 如果 e.[[Key]] 不是
empty ，则- 执行 ? Call(callback, thisArg, « e.[[Value]], e.[[Key]], M »)。
- 注：在执行 callback 期间 entries 中元素数量可能增加。
- 将 numEntries 设为 entries 中元素的数量。
- 返回
undefined 。
callback 应为接受三个参数的函数。forEach 按键插入顺序对 Map 中每个键/值对调用一次 callback。仅对 Map 中实际存在的键调用；已删除的键不会调用。
如果提供 thisArg，它将在每次调用 callback 时用作
callback 以三个参数调用：条目的值、条目的键以及被遍历的 Map。
forEach 不直接修改其被调用的对象，但该对象可在 callback 内被修改。Map 的 [[MapData]] 中的每个条目只访问一次。调用开始后新增的键会被访问。一个键如果在访问后被删除然后在调用结束前又被重新加入会被再次访问。调用开始后删除且尚未访问的键不会被访问，除非它在调用结束前再次添加。
24.1.3.6 Map.prototype.get ( key )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 执行 ?
RequireInternalSlot (M, [[MapData]])。 - 将 key 设为
CanonicalizeKeyedCollectionKey (key)。 - 对 M.[[MapData]] 中每个
Record { [[Key]], [[Value]] } p：- 如果 p.[[Key]] 不是
empty 且SameValue (p.[[Key]], key) 为true ，返回 p.[[Value]]。
- 如果 p.[[Key]] 不是
- 返回
undefined 。
24.1.3.7 Map.prototype.has ( key )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 执行 ?
RequireInternalSlot (M, [[MapData]])。 - 将 key 设为
CanonicalizeKeyedCollectionKey (key)。 - 对 M.[[MapData]] 中每个
Record { [[Key]], [[Value]] } p：- 如果 p.[[Key]] 不是
empty 且SameValue (p.[[Key]], key) 为true ，返回true 。
- 如果 p.[[Key]] 不是
- 返回
false 。
24.1.3.8 Map.prototype.keys ( )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 返回 ?
CreateMapIterator (M,key )。
24.1.3.9 Map.prototype.set ( key, value )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 执行 ?
RequireInternalSlot (M, [[MapData]])。 - 将 key 设为
CanonicalizeKeyedCollectionKey (key)。 - 对 M.[[MapData]] 中每个
Record { [[Key]], [[Value]] } p：- 如果 p.[[Key]] 不是
empty 且SameValue (p.[[Key]], key) 为true ，则- 将 p.[[Value]] 设为 value。
- 返回 M。
- 如果 p.[[Key]] 不是
- 令 p 为记录 { [[Key]]: key, [[Value]]: value }。
- 将 p 追加到 M.[[MapData]]。
- 返回 M。
24.1.3.10 get Map.prototype.size
Map.prototype.size 是一个存取器属性，其 set 访问器函数为
- 令 M 为
this 值。 - 执行 ?
RequireInternalSlot (M, [[MapData]])。 - 令 count 为 0。
- 对 M.[[MapData]] 中每个
Record { [[Key]], [[Value]] } p：- 如果 p.[[Key]] 不是
empty ，将 count 设为 count + 1。
- 如果 p.[[Key]] 不是
- 返回
𝔽 (count)。
24.1.3.11 Map.prototype.values ( )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 返回 ?
CreateMapIterator (M,value )。
24.1.3.12 Map.prototype [ %Symbol.iterator% ] ( )
24.1.3.13 Map.prototype [ %Symbol.toStringTag% ]
该属性具有 { [[Writable]]:
24.1.4 Map 实例的属性
24.1.5 Map 迭代器对象
Map Iterator 是一个表示对某个特定 Map 实例对象的特定迭代的对象。没有命名的 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 为一个无参数的新抽象闭包，捕获 map 和 kind 并在调用时执行：
- 令 entries 为 map.[[MapData]]。
- 令 index 为 0。
- 令 numEntries 为 entries 中元素的数量。
- 当 index < numEntries 重复，
- 令 e 为 entries[index]。
- 将 index 设为 index + 1。
- 如果 e.[[Key]] 不是
empty ，则- 如果 kind 是
key ，则- 令 result 为 e.[[Key]]。
- 否则如果 kind 是
value ，则- 令 result 为 e.[[Value]]。
- 否则，
- 断言：kind 是
key+value 。 - 令 result 为
CreateArrayFromList (« e.[[Key]], e.[[Value]] »)。
- 断言：kind 是
- 执行 ?
GeneratorYield (CreateIteratorResultObject (result,false ))。 - 注：在
GeneratorYield 暂停本抽象操作 执行期间，entries 中的元素数量可能增加。 - 将 numEntries 设为 entries 中元素的数量。
- 如果 kind 是
- 返回
NormalCompletion (unused )。
- 返回
CreateIteratorFromClosure (closure,"%MapIteratorPrototype%" ,%MapIteratorPrototype% )。
24.1.5.2 %MapIteratorPrototype% 对象
%MapIteratorPrototype% 对象：
- 具有所有 Map 迭代器对象继承的属性。
- 是一个
普通对象 。 - 有一个 [[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 记录
Set Record 是用于封装 Set 或类似对象接口的
Set 记录具有
| 字段名 | 取值 | 含义 |
|---|---|---|
| [[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 一个包含
- 如果 obj 不是一个 Object，抛出
TypeError 异常。 - 令 rawSize 为 ?
Get (obj,"size" )。 - 令 numSize 为 ?
ToNumber (rawSize)。 - 注：如果 rawSize 是
undefined ，则 numSize 将为NaN 。 - 如果 numSize 是
NaN ，抛出TypeError 异常。 - 令 intSize 为 !
ToIntegerOrInfinity (numSize)。 - 如果 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 重复，
- 令 e 为 setData[index]。
- 如果 e 不是
empty 且 e 是 value，则- 返回 index。
- 将 index 设为 index + 1。
- 返回
not-found 。
24.2.1.5 SetDataSize ( setData )
The abstract operation SetDataSize takes argument setData (a
- 令 count 为 0。
- 对 setData 中每个元素 e：
- 如果 e 不是
empty ，将 count 设为 count + 1。
- 如果 e 不是
- 返回 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%] 是一个存取器属性，其 set 访问器函数为
- 返回
this 值。
该函数
创建派生集合对象的方法应调用
24.2.4 Set 原型对象的属性
Set 原型对象：
- 是 %Set.prototype%。
- 有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是一个
普通对象 。 - 没有 [[SetData]] 内部槽。
24.2.4.1 Set.prototype.add ( value )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 执行 ?
RequireInternalSlot (S, [[SetData]])。 - 将 value 设为
CanonicalizeKeyedCollectionKey (value)。 - 对 S.[[SetData]] 中每个元素 e：
- 如果 e 不是
empty 且SameValue (e, value) 为true ，则- 返回 S。
- 如果 e 不是
- 将 value 追加到 S.[[SetData]]。
- 返回 S。
24.2.4.2 Set.prototype.clear ( )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 执行 ?
RequireInternalSlot (S, [[SetData]])。 - 对 S.[[SetData]] 中每个元素 e：
- 用值为
empty 的元素替换 S.[[SetData]] 中值为 e 的元素。
- 用值为
- 返回
undefined 。
24.2.4.3 Set.prototype.constructor
Set.prototype.constructor 的初始值是
24.2.4.4 Set.prototype.delete ( value )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 执行 ?
RequireInternalSlot (S, [[SetData]])。 - 将 value 设为
CanonicalizeKeyedCollectionKey (value)。 - 对 S.[[SetData]] 中每个元素 e：
- 如果 e 不是
empty 且SameValue (e, value) 为true ，则- 用值为
empty 的元素替换 S.[[SetData]] 中值为 e 的元素。 - 返回
true 。
- 用值为
- 如果 e 不是
- 返回
false 。
值
24.2.4.5 Set.prototype.difference ( other )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[SetData]])。 - 令 otherRec 为 ?
GetSetRecord (other)。 - 令 resultSetData 为 O.[[SetData]] 的一个拷贝。
- 如果
SetDataSize (O.[[SetData]]) ≤ otherRec.[[Size]]，则- 令 thisSize 为 O.[[SetData]] 中元素的数量。
- 令 index 为 0。
- 当 index < thisSize 重复，
- 令 e 为 resultSetData[index]。
- 如果 e 不是
empty ，则- 令 inOther 为
ToBoolean (? Call(otherRec.[[Has]], otherRec.[[SetObject]], « e »))。 - 如果 inOther 为
true ，则- 将 resultSetData[index] 设为
empty 。
- 将 resultSetData[index] 设为
- 令 inOther 为
- 将 index 设为 index + 1。
- 否则，
- 令 keysIter 为 ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]])。 - 令 next 为
not-started 。 - 当 next 不是
done 重复，- 将 next 设为 ?
IteratorStepValue (keysIter)。 - 如果 next 不是
done ，则- 将 next 设为
CanonicalizeKeyedCollectionKey (next)。 - 令 valueIndex 为
SetDataIndex (resultSetData, next)。 - 如果 valueIndex 不是
not-found ，则- 将 resultSetData[valueIndex] 设为
empty 。
- 将 resultSetData[valueIndex] 设为
- 将 next 设为
- 将 next 设为 ?
- 令 keysIter 为 ?
- 令 result 为
OrdinaryObjectCreate (%Set.prototype% , « [[SetData]] »)。 - 将 result.[[SetData]] 设为 resultSetData。
- 返回 result。
24.2.4.6 Set.prototype.entries ( )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 返回 ?
CreateSetIterator (S,key+value )。
在迭代语义上，Set 类似于每个条目键和值相同的 Map。
24.2.4.7 Set.prototype.forEach ( callback [ , thisArg ] )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 执行 ?
RequireInternalSlot (S, [[SetData]])。 - 如果
IsCallable (callback) 为false ，抛出TypeError 异常。 - 令 entries 为 S.[[SetData]]。
- 令 numEntries 为 entries 中元素的数量。
- 令 index 为 0。
- 当 index < numEntries 重复，
- 令 e 为 entries[index]。
- 将 index 设为 index + 1。
- 如果 e 不是
empty ，则- 执行 ? Call(callback, thisArg, « e, e, S »)。
- 注：执行 callback 期间 entries 中元素数量可能增加。
- 将 numEntries 设为 entries 中元素的数量。
- 返回
undefined 。
callback 应为接受三个参数的函数。forEach 按值插入顺序对 Set 对象中每个值调用一次 callback。仅对实际存在的值调用；对已删除的值不会调用。
如果提供 thisArg，它作为每次调用 callback 的
callback 以三个参数调用：前两个参数是 Set 中的一个值（相同的值传两次），第三个参数是被遍历的 Set 对象。
callback 传递三个参数是为了与 Map 和 Array 的 forEach 回调函数保持一致；在 Set 中每个值同时被视为键和值。
forEach 不直接修改其被调用的对象，但对象可在 callback 中被修改。
每个值通常只访问一次；但如果某值在被访问后被删除并在调用结束前重新加入，会被再次访问。调用开始后删除且尚未访问的值不会被访问，除非在调用结束前再次添加。调用开始后新增的值会被访问。
24.2.4.8 Set.prototype.has ( value )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 执行 ?
RequireInternalSlot (S, [[SetData]])。 - 将 value 设为
CanonicalizeKeyedCollectionKey (value)。 - 对 S.[[SetData]] 中每个元素 e：
- 如果 e 不是
empty 且SameValue (e, value) 为true ，返回true 。
- 如果 e 不是
- 返回
false 。
24.2.4.9 Set.prototype.intersection ( other )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[SetData]])。 - 令 otherRec 为 ?
GetSetRecord (other)。 - 令 resultSetData 为一个新的空
List 。 - 如果
SetDataSize (O.[[SetData]]) ≤ otherRec.[[Size]]，则- 令 thisSize 为 O.[[SetData]] 中元素的数量。
- 令 index 为 0。
- 当 index < thisSize 重复，
- 令 e 为 O.[[SetData]][index]。
- 将 index 设为 index + 1。
- 如果 e 不是
empty ，则- 令 inOther 为
ToBoolean (? Call(otherRec.[[Has]], otherRec.[[SetObject]], « e »))。 - 如果 inOther 为
true ，则- 注：早先对 otherRec.[[Has]] 的调用可能移除并重新添加 O.[[SetData]] 的元素，导致同一元素在本次迭代中被访问两次。
- 如果
SetDataHas (resultSetData, e) 为false ，则- 将 e 追加到 resultSetData。
- 注：执行 otherRec.[[Has]] 期间 O.[[SetData]] 中元素数量可能增加。
- 将 thisSize 设为 O.[[SetData]] 中元素的数量。
- 令 inOther 为
- 否则，
- 令 keysIter 为 ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]])。 - 令 next 为
not-started 。 - 当 next 不是
done 重复，- 将 next 设为 ?
IteratorStepValue (keysIter)。 - 如果 next 不是
done ，则- 将 next 设为
CanonicalizeKeyedCollectionKey (next)。 - 令 inThis 为
SetDataHas (O.[[SetData]], next)。 - 如果 inThis 为
true ，则- 注：因为 other 是一个任意对象，其
"keys" 迭代器可能多次产生同一值。 - 如果
SetDataHas (resultSetData, next) 为false ，则- 将 next 追加到 resultSetData。
- 注：因为 other 是一个任意对象，其
- 将 next 设为
- 将 next 设为 ?
- 令 keysIter 为 ?
- 令 result 为
OrdinaryObjectCreate (%Set.prototype% , « [[SetData]] »)。 - 将 result.[[SetData]] 设为 resultSetData。
- 返回 result。
24.2.4.10 Set.prototype.isDisjointFrom ( other )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[SetData]])。 - 令 otherRec 为 ?
GetSetRecord (other)。 - 如果
SetDataSize (O.[[SetData]]) ≤ otherRec.[[Size]]，则- 令 thisSize 为 O.[[SetData]] 中元素的数量。
- 令 index 为 0。
- 当 index < thisSize 重复，
- 令 e 为 O.[[SetData]][index]。
- 将 index 设为 index + 1。
- 如果 e 不是
empty ，则- 令 inOther 为
ToBoolean (? Call(otherRec.[[Has]], otherRec.[[SetObject]], « e »))。 - 如果 inOther 为
true ，返回false 。 - 注：执行 otherRec.[[Has]] 期间 O.[[SetData]] 中元素数量可能增加。
- 将 thisSize 设为 O.[[SetData]] 中元素的数量。
- 令 inOther 为
- 否则，
- 令 keysIter 为 ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]])。 - 令 next 为
not-started 。 - 当 next 不是
done 重复，- 将 next 设为 ?
IteratorStepValue (keysIter)。 - 如果 next 不是
done ，则- 如果
SetDataHas (O.[[SetData]], next) 为true ，则- 执行 ?
IteratorClose (keysIter,NormalCompletion (unused ))。 - 返回
false 。
- 执行 ?
- 如果
- 将 next 设为 ?
- 令 keysIter 为 ?
- 返回
true 。
24.2.4.11 Set.prototype.isSubsetOf ( other )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[SetData]])。 - 令 otherRec 为 ?
GetSetRecord (other)。 - 如果
SetDataSize (O.[[SetData]]) > otherRec.[[Size]]，返回false 。 - 令 thisSize 为 O.[[SetData]] 中元素数量。
- 令 index 为 0。
- 当 index < thisSize 重复，
- 令 e 为 O.[[SetData]][index]。
- 将 index 设为 index + 1。
- 如果 e 不是
empty ，则- 令 inOther 为
ToBoolean (? Call(otherRec.[[Has]], otherRec.[[SetObject]], « e »))。 - 如果 inOther 为
false ，返回false 。 - 注：执行 otherRec.[[Has]] 期间 O.[[SetData]] 中元素数量可能增加。
- 将 thisSize 设为 O.[[SetData]] 中元素的数量。
- 令 inOther 为
- 返回
true 。
24.2.4.12 Set.prototype.isSupersetOf ( other )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[SetData]])。 - 令 otherRec 为 ?
GetSetRecord (other)。 - 如果
SetDataSize (O.[[SetData]]) < otherRec.[[Size]]，返回false 。 - 令 keysIter 为 ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]])。 - 令 next 为
not-started 。 - 当 next 不是
done 重复，- 将 next 设为 ?
IteratorStepValue (keysIter)。 - 如果 next 不是
done ，则- 如果
SetDataHas (O.[[SetData]], next) 为false ，则- 执行 ?
IteratorClose (keysIter,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 访问器函数为
- 令 S 为
this 值。 - 执行 ?
RequireInternalSlot (S, [[SetData]])。 - 令 size 为
SetDataSize (S.[[SetData]])。 - 返回
𝔽 (size)。
24.2.4.15 Set.prototype.symmetricDifference ( other )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[SetData]])。 - 令 otherRec 为 ?
GetSetRecord (other)。 - 令 keysIter 为 ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]])。 - 令 resultSetData 为 O.[[SetData]] 的一个拷贝。
- 令 next 为
not-started 。 - 当 next 不是
done 重复，- 将 next 设为 ?
IteratorStepValue (keysIter)。 - 如果 next 不是
done ，则- 将 next 设为
CanonicalizeKeyedCollectionKey (next)。 - 令 resultIndex 为
SetDataIndex (resultSetData, next)。 - 如果 resultIndex 是
not-found ，令 alreadyInResult 为false ；否则令其为true 。 - 如果
SetDataHas (O.[[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 )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[SetData]])。 - 令 otherRec 为 ?
GetSetRecord (other)。 - 令 keysIter 为 ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]])。 - 令 resultSetData 为 O.[[SetData]] 的一个拷贝。
- 令 next 为
not-started 。 - 当 next 不是
done 重复，- 将 next 设为 ?
IteratorStepValue (keysIter)。 - 如果 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 ( )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 返回 ?
CreateSetIterator (S,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 迭代器对象
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 为一个无参数的新抽象闭包，捕获 set 和 kind 并在调用时执行：
- 令 index 为 0。
- 令 entries 为 set.[[SetData]]。
- 令 numEntries 为 entries 中元素的数量。
- 当 index < numEntries 重复，
- 令 e 为 entries[index]。
- 将 index 设为 index + 1。
- 如果 e 不是
empty ，则- 如果 kind 是
key+value ，则- 令 result 为
CreateArrayFromList (« e, e »)。 - 执行 ?
GeneratorYield (CreateIteratorResultObject (result,false ))。
- 令 result 为
- 否则，
- 断言：kind 是
value 。 - 执行 ?
GeneratorYield (CreateIteratorResultObject (e,false ))。
- 断言：kind 是
- 注：在
GeneratorYield 暂停本抽象操作 执行期间，entries 中元素数量可能增加。 - 将 numEntries 设为 entries 中元素的数量。
- 如果 kind 是
- 返回
NormalCompletion (unused )。
- 返回
CreateIteratorFromClosure (closure,"%SetIteratorPrototype%" ,%SetIteratorPrototype% )。
24.2.6.2 %SetIteratorPrototype% 对象
%SetIteratorPrototype% 对象：
- 具有所有 Set 迭代器对象继承的属性。
- 是一个
普通对象 。 - 有一个 [[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 是键/值对的集合，其中键是对象和/或符号，值可以是任意
实现可以在 WeakMap 的键/值对变得不可访问与其被移除之间施加任意决定的延迟。若该延迟对 ECMAScript 程序可观察，将导致不确定性并影响程序执行。因此，实现不得提供任何不需要观察者出示被观察键就能观察 WeakMap 键的方式。
WeakMap 必须使用哈希表或其他平均情况下提供次线性访问时间的机制实现。本规范使用的数据结构仅用于描述 WeakMap 所需的可观察语义，而非可行实现模型。
WeakMap 和 WeakSet 旨在提供一种动态地将状态与对象或符号关联的机制，在没有 WeakMap 或 WeakSet 实例的情况下，如果对象或符号本来会变得不可访问并被实现的垃圾回收机制回收，这种机制不会“泄漏”内存资源。该特性可以通过使用按对象/符号反向映射 WeakMap 或 WeakSet 实例到键来实现。或者，每个 WeakMap 或 WeakSet 实例可以在内部存储其键和值数据，但这种方法需要 WeakMap 或 WeakSet 实现与垃圾回收器协同。以下参考文献描述的机制可能对 WeakMap 和 WeakSet 的实现有用：
Barry Hayes. 1997. Ephemerons: a new finalization mechanism. 载于 Proceedings of the 12th ACM SIGPLAN conference on Object-oriented programming, systems, languages, and applications (OOPSLA '97), A. Michael Berman (编). 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 )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 执行 ?
RequireInternalSlot (M, [[WeakMapData]])。 - 如果
CanBeHeldWeakly (key) 为false ，返回false 。 - 对 M.[[WeakMapData]] 中每个
Record { [[Key]], [[Value]] } p：- 如果 p.[[Key]] 不是
empty 且SameValue (p.[[Key]], key) 为true ，则- 将 p.[[Key]] 设为
empty 。 - 将 p.[[Value]] 设为
empty 。 - 返回
true 。
- 将 p.[[Key]] 设为
- 如果 p.[[Key]] 不是
- 返回
false 。
值
24.3.3.3 WeakMap.prototype.get ( key )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 执行 ?
RequireInternalSlot (M, [[WeakMapData]])。 - 如果
CanBeHeldWeakly (key) 为false ，返回undefined 。 - 对 M.[[WeakMapData]] 中每个
Record { [[Key]], [[Value]] } p：- 如果 p.[[Key]] 不是
empty 且SameValue (p.[[Key]], key) 为true ，返回 p.[[Value]]。
- 如果 p.[[Key]] 不是
- 返回
undefined 。
24.3.3.4 WeakMap.prototype.has ( key )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 执行 ?
RequireInternalSlot (M, [[WeakMapData]])。 - 如果
CanBeHeldWeakly (key) 为false ，返回false 。 - 对 M.[[WeakMapData]] 中每个
Record { [[Key]], [[Value]] } p：- 如果 p.[[Key]] 不是
empty 且SameValue (p.[[Key]], key) 为true ，返回true 。
- 如果 p.[[Key]] 不是
- 返回
false 。
24.3.3.5 WeakMap.prototype.set ( key, value )
该方法被调用时执行以下步骤：
- 令 M 为
this 值。 - 执行 ?
RequireInternalSlot (M, [[WeakMapData]])。 - 如果
CanBeHeldWeakly (key) 为false ，抛出TypeError 异常。 - 对 M.[[WeakMapData]] 中每个
Record { [[Key]], [[Value]] } p：- 如果 p.[[Key]] 不是
empty 且SameValue (p.[[Key]], key) 为true ，则- 将 p.[[Value]] 设为 value。
- 返回 M。
- 如果 p.[[Key]] 不是
- 令 p 为记录 { [[Key]]: key, [[Value]]: value }。
- 将 p 追加到 M.[[WeakMapData]]。
- 返回 M。
24.3.3.6 WeakMap.prototype [ %Symbol.toStringTag% ]
该属性具有 { [[Writable]]:
24.3.4 WeakMap 实例的属性
WeakMap 实例是
24.4 WeakSet 对象
WeakSet 是对象和/或符号的集合。一个特定对象或符号在 WeakSet 的集合中只能出现一次。可以查询 WeakSet 是否包含一个特定值，但没有
实现可以在 WeakSet 中的一个值变得不可访问与其被移除之间施加任意决定的延迟。若该延迟对 ECMAScript 程序可观察，将导致不确定性并影响程序执行。因此，实现不得提供不需要观察者出示被观察值就能判断 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 )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 执行 ?
RequireInternalSlot (S, [[WeakSetData]])。 - 如果
CanBeHeldWeakly (value) 为false ，抛出TypeError 异常。 - 对 S.[[WeakSetData]] 中每个元素 e：
- 如果 e 不是
empty 且SameValue (e, value) 为true ，则- 返回 S。
- 如果 e 不是
- 将 value 追加到 S.[[WeakSetData]]。
- 返回 S。
24.4.3.2 WeakSet.prototype.constructor
WeakSet.prototype.constructor 的初始值是
24.4.3.3 WeakSet.prototype.delete ( value )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 执行 ?
RequireInternalSlot (S, [[WeakSetData]])。 - 如果
CanBeHeldWeakly (value) 为false ，返回false 。 - 对 S.[[WeakSetData]] 中每个元素 e：
- 如果 e 不是
empty 且SameValue (e, value) 为true ，则- 用值为
empty 的元素替换 S.[[WeakSetData]] 中值为 e 的元素。 - 返回
true 。
- 用值为
- 如果 e 不是
- 返回
false 。
值
24.4.3.4 WeakSet.prototype.has ( value )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 执行 ?
RequireInternalSlot (S, [[WeakSetData]])。 - 如果
CanBeHeldWeakly (value) 为false ，返回false 。 - 对 S.[[WeakSetData]] 中每个元素 e：
- 如果 e 不是
empty 且SameValue (e, value) 为true ，返回true 。
- 如果 e 不是
- 返回
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 结构化数据（Structured Data）
25.1 ArrayBuffer 对象
25.1.1 记号（Notation）
本小节、
读-改-写 修改函数 是一种数学函数，以抽象闭包形式表示，接受两个
- 它们以原子方式执行其全部算法步骤。
- 其各个算法步骤不可被观察。
为帮助验证读-改-写 修改函数的算法步骤构成一个纯粹的数学函数，建议遵循以下编辑约定：
- 除其参数与捕获的值外，不直接或经由被调用的
抽象操作 与抽象闭包传递性访问任何语言或规范值。 - 不直接或传递性调用返回
Completion Record 的抽象操作 与抽象闭包。 - 不返回
Completion Record 。
25.1.2 固定长度与可调整大小（Resizable）的 ArrayBuffer 对象
固定长度 ArrayBuffer（fixed-length ArrayBuffer） 是创建后其字节长度不可改变的 ArrayBuffer。
可调整大小 ArrayBuffer（resizable ArrayBuffer） 是创建后其字节长度可通过调用
创建何种 ArrayBuffer 对象取决于传递给
25.1.3 ArrayBuffer 对象的抽象操作
25.1.3.1 AllocateArrayBuffer ( constructor, byteLength [ , maxByteLength ] )
The abstract operation AllocateArrayBuffer takes arguments constructor (a constructor) and byteLength (a non-negative
- 令 slots 为 « [[ArrayBufferData]], [[ArrayBufferByteLength]], [[ArrayBufferDetachKey]] »。
- 如果存在 maxByteLength 且其不为
empty ，令 allocatingResizableBuffer 为true ；否则令其为false 。 - 若 allocatingResizableBuffer 为
true ，则- 若 byteLength > maxByteLength，抛出
RangeError 异常。 - 将 [[ArrayBufferMaxByteLength]] 追加到 slots。
- 若 byteLength > maxByteLength，抛出
- 令 obj 为 ?
OrdinaryCreateFromConstructor (constructor,"%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 (
- 若
IsSharedArrayBuffer (arrayBuffer) 为true 且 arrayBuffer 具有内部槽 [[ArrayBufferByteLengthData]]，则- 令 bufferByteLengthBlock 为 arrayBuffer.[[ArrayBufferByteLengthData]]。
- 令 rawLength 为
GetRawBytesFromSharedBlock (bufferByteLengthBlock, 0,biguint64 ,true , order)。 - 令 isLittleEndian 为外层 agent 的
Agent Record 的 [[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 的创建与拷贝均不可观察。实现可用零拷贝移动或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 要么是包含
- 断言：
IsSharedArrayBuffer (arrayBuffer) 为false 。 - 若 key 不存在，设 key 为
undefined 。 - 若 arrayBuffer.[[ArrayBufferDetachKey]] 不为 key，抛出
TypeError 异常。 - 设 arrayBuffer.[[ArrayBufferData]] 为
null 。 - 设 arrayBuffer.[[ArrayBufferByteLength]] 为 0。
- 返回
unused 。
分离一个 ArrayBuffer 实例会将其用作后备存储的
25.1.3.6 CloneArrayBuffer ( srcBuffer, srcByteOffset, srcLength )
The abstract operation CloneArrayBuffer takes arguments srcBuffer (an ArrayBuffer or a SharedArrayBuffer), srcByteOffset (a non-negative
- 断言：
IsDetachedBuffer (srcBuffer) 为false 。 - 令 targetBuffer 为 ?
AllocateArrayBuffer (%ArrayBuffer% , srcLength)。 - 令 srcBlock 为 srcBuffer.[[ArrayBufferData]]。
- 令 targetBlock 为 targetBuffer.[[ArrayBufferData]]。
- 执行
CopyDataBlockBytes (targetBlock, 0, srcBlock, srcByteOffset, srcLength)。 - 返回 targetBuffer。
25.1.3.7 GetArrayBufferMaxByteLengthOption ( options )
The abstract operation GetArrayBufferMaxByteLengthOption takes argument options (an ECMAScript language value) and returns 要么是包含非负整数或
25.1.3.8 HostResizeArrayBuffer ( buffer, newByteLength )
The host-defined abstract operation HostResizeArrayBuffer takes arguments buffer (an ArrayBuffer) and newByteLength (a non-negative
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 73 中元素类型 type 指定的元素大小值。 - 若 isLittleEndian 为
false ，反转 rawBytes 的元素顺序。 - 若 type 为
float16 ，则- 令 value 为将 rawBytes 字节元素拼接并按
IEEE 754-2019 binary16 小端位串编码解释的结果。 - 若 value 是 NaN，返回
NaN 。 - 返回与 value 对应的 Number 值。
- 令 value 为将 rawBytes 字节元素拼接并按
- 若 type 为
float32 ，则- 同上以 binary32 方式处理。
- 若 type 为
float64 ，则- 同上以 binary64 方式处理。
- 若
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 73 中元素类型 type 指定的元素大小值。 - 令 execution 为外层 agent 的
Agent Record 的 [[CandidateExecution]] 字段。 - 令 eventsRecord 为 execution.[[EventsRecords]] 中 [[AgentSignifier]] 为
AgentSignifier () 的Agent Events Record 。 - 若 isTypedArray 为
true 且IsNoTearConfiguration (type, order) 为true ，令 noTear 为true ；否则为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 73 中元素类型 type 的元素大小值。 - 若
IsSharedArrayBuffer (arrayBuffer) 为true ，则- 断言：block 为
Shared Data Block 。 - 令 rawValue 为
GetRawBytesFromSharedBlock (block, byteIndex, type, isTypedArray, order)。
- 断言：block 为
- 否则，
- 断言：rawValue 元素个数为 elementSize。
- 若 isLittleEndian 不存在，设其为外层 agent 的
Agent Record 的 [[LittleEndian]] 字段值。 - 返回
RawBytesToNumeric (type, rawValue, isLittleEndian)。
25.1.3.17 NumericToRawBytes ( type, value, isLittleEndian )
The abstract operation NumericToRawBytes takes arguments type (a
- 若 type 为
float16 ，则- 令 rawBytes 为长度 2 的
List ，为将 value 以 roundTiesToEven 模式转换为IEEE 754-2019 binary16 格式的结果字节（小端序）。若 value 为NaN ，rawBytes 可为实现选择的任一 binary16 NaN 编码；实现对每个可区分NaN 必须始终选择同一编码。
- 令 rawBytes 为长度 2 的
- Else if type 为
float32 ，同理生成 4 字节（binary32）。 - Else if type 为
float64 ，同理生成 8 字节（binary64）。 - 否则，
- 若 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；否则为 Number。 - 令 block 为 arrayBuffer.[[ArrayBufferData]]。
- 令 elementSize 为
Table 73 中元素类型 type 的元素大小值。 - 若 isLittleEndian 不存在，设其为外层 agent 的
Agent Record 的 [[LittleEndian]] 字段值。 - 令 rawBytes 为
NumericToRawBytes (type, value, isLittleEndian)。 - 若
IsSharedArrayBuffer (arrayBuffer) 为true ，则- 令 execution 为外层 agent 的
Agent Record 的 [[CandidateExecution]] 字段。 - 令 eventsRecord 为 execution.[[EventsRecords]] 中 [[AgentSignifier]] 为
AgentSignifier () 的Agent Events Record 。 - 若 isTypedArray 为
true 且IsNoTearConfiguration (type, order) 为true ，令 noTear 为true ；否则为false 。 - 将
WriteSharedMemory { [[Order]]: order, [[NoTear]]: noTear, [[Block]]: block, [[ByteIndex]]: byteIndex, [[ElementSize]]: elementSize, [[Payload]]: rawBytes } 追加到 eventsRecord.[[EventList]]。
- 令 execution 为外层 agent 的
- 否则，
- 将 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；否则为 Number。 - 令 block 为 arrayBuffer.[[ArrayBufferData]]。
- 令 elementSize 为
Table 73 中元素类型 type 的元素大小值。 - 令 isLittleEndian 为外层 agent 的
Agent Record 的 [[LittleEndian]] 字段值。 - 令 rawBytes 为
NumericToRawBytes (type, value, isLittleEndian)。 - 若
IsSharedArrayBuffer (arrayBuffer) 为true ，则- 令 execution 为外层 agent 的
Agent Record 的 [[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]]。
- 令 execution 为外层 agent 的
- 否则，
- 令 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构造函数 的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%] 是一个存取器属性，其 set 访问器为
- 返回
this 值。
该函数
25.1.6 ArrayBuffer 原型对象的属性
ArrayBuffer 原型对象：
- 是 %ArrayBuffer.prototype%。
- 有 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是
普通对象 。 - 没有 [[ArrayBufferData]] 或 [[ArrayBufferByteLength]] 内部槽。
25.1.6.1 get ArrayBuffer.prototype.byteLength
ArrayBuffer.prototype.byteLength 是一个存取器属性，其 set 访问器为
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[ArrayBufferData]])。 - 若
IsSharedArrayBuffer (O) 为true ，抛出TypeError 异常。 - 若
IsDetachedBuffer (O) 为true ，返回+0 𝔽。 - 令 length 为 O.[[ArrayBufferByteLength]]。
- 返回
𝔽 (length)。
25.1.6.2 ArrayBuffer.prototype.constructor
ArrayBuffer.prototype.constructor 的初始值是
25.1.6.3 get ArrayBuffer.prototype.detached
ArrayBuffer.prototype.detached 是一个存取器属性，其 set 访问器为
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[ArrayBufferData]])。 - 若
IsSharedArrayBuffer (O) 为true ，抛出TypeError 异常。 - 返回
IsDetachedBuffer (O)。
25.1.6.4 get ArrayBuffer.prototype.maxByteLength
ArrayBuffer.prototype.maxByteLength 是一个存取器属性，其 set 访问器为
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[ArrayBufferData]])。 - 若
IsSharedArrayBuffer (O) 为true ，抛出TypeError 异常。 - 若
IsDetachedBuffer (O) 为true ，返回+0 𝔽。 - 若
IsFixedLengthArrayBuffer (O) 为true ，则- 令 length 为 O.[[ArrayBufferByteLength]]。
- 否则，
- 令 length 为 O.[[ArrayBufferMaxByteLength]]。
- 返回
𝔽 (length)。
25.1.6.5 get ArrayBuffer.prototype.resizable
ArrayBuffer.prototype.resizable 是一个存取器属性，其 set 访问器为
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[ArrayBufferData]])。 - 若
IsSharedArrayBuffer (O) 为true ，抛出TypeError 异常。 - 若
IsFixedLengthArrayBuffer (O) 为false ，返回true ；否则返回false 。
25.1.6.6 ArrayBuffer.prototype.resize ( newLength )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[ArrayBufferMaxByteLength]])。 - 若
IsSharedArrayBuffer (O) 为true ，抛出TypeError 异常。 - 令 newByteLength 为 ?
ToIndex (newLength)。 - 若
IsDetachedBuffer (O) 为true ，抛出TypeError 异常。 - 若 newByteLength > O.[[ArrayBufferMaxByteLength]]，抛出
RangeError 异常。 - 令 hostHandled 为 ?
HostResizeArrayBuffer (O, newByteLength)。 - 若 hostHandled 为
handled ，返回undefined 。 - 令 oldBlock 为 O.[[ArrayBufferData]]。
- 令 newBlock 为 ?
CreateByteDataBlock (newByteLength)。 - 令 copyLength 为
min (newByteLength, O.[[ArrayBufferByteLength]])。 - 执行
CopyDataBlockBytes (newBlock, 0, oldBlock, 0, copyLength)。 - 注：新
Data Block 的创建与旧Data Block 的拷贝均不可观察。实现可原地增长或收缩。 - 设 O.[[ArrayBufferData]] 为 newBlock。
- 设 O.[[ArrayBufferByteLength]] 为 newByteLength。
- 返回
undefined 。
25.1.6.7 ArrayBuffer.prototype.slice ( start, end )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[ArrayBufferData]])。 - 若
IsSharedArrayBuffer (O) 为true ，抛出TypeError 异常。 - 若
IsDetachedBuffer (O) 为true ，抛出TypeError 异常。 - 令 len 为 O.[[ArrayBufferByteLength]]。
- 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 若 relativeStart = -∞，令 first 为 0。
- Else if relativeStart < 0，令 first 为
max (len + relativeStart, 0)。 - Else，令 first 为
min (relativeStart, len)。 - 若 end 为
undefined ，令 relativeEnd 为 len；否则令 relativeEnd 为 ?ToIntegerOrInfinity (end)。 - 若 relativeEnd = -∞，令 final 为 0。
- Else if relativeEnd < 0，令 final 为
max (len + relativeEnd, 0)。 - Else，令 final 为
min (relativeEnd, len)。 - 令 newLen 为
max (final - first, 0)。 - 令 ctor 为 ?
SpeciesConstructor (O,%ArrayBuffer% )。 - 令 new 为 ? Construct(ctor, «
𝔽 (newLen) »)。 - 执行 ?
RequireInternalSlot (new, [[ArrayBufferData]])。 - 若
IsSharedArrayBuffer (new) 为true ，抛出TypeError 异常。 - 若
IsDetachedBuffer (new) 为true ，抛出TypeError 异常。 - 若
SameValue (new, O) 为true ，抛出TypeError 异常。 - 若 new.[[ArrayBufferByteLength]] < newLen，抛出
TypeError 异常。 - 注：以上步骤的副作用可能已分离或调整 O 大小。
- 若
IsDetachedBuffer (O) 为true ，抛出TypeError 异常。 - 令 fromBuf 为 O.[[ArrayBufferData]]。
- 令 toBuf 为 new.[[ArrayBufferData]]。
- 令 currentLen 为 O.[[ArrayBufferByteLength]]。
- 若 first < currentLen，则
- 令 count 为
min (newLen, currentLen - first)。 - 执行
CopyDataBlockBytes (toBuf, 0, fromBuf, first, count)。
- 令 count 为
- 返回 new。
25.1.6.8 ArrayBuffer.prototype.transfer ( [ newLength ] )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 返回 ?
ArrayBufferCopyAndDetach (O, newLength,preserve-resizability )。
25.1.6.9 ArrayBuffer.prototype.transferToFixedLength ( [ newLength ] )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 返回 ?
ArrayBufferCopyAndDetach (O, newLength,fixed-length )。
25.1.6.10 ArrayBuffer.prototype [ %Symbol.toStringTag% ]
该属性特性为 { [[Writable]]:
25.1.7 ArrayBuffer 实例的属性
ArrayBuffer 实例从
[[ArrayBufferData]] 为
[[ArrayBufferDetachKey]] 设为非
25.1.8 可调整大小 ArrayBuffer 指南
以下是供 ECMAScript 程序员在使用可调整大小 ArrayBuffer 时的指南。
建议在部署环境中（如果可能）对程序进行测试。不同硬件设备的可用物理内存差异很大；虚拟内存子系统也因硬件设备与操作系统不同而差异明显。一个在 64 位桌面浏览器中无内存不足错误的应用，可能在 32 位移动浏览器中耗尽内存。
为可调整大小 ArrayBuffer 选择
请注意：成功构造一个指定最大值的可调整大小 ArrayBuffer 并不保证未来的扩展一定成功。
以下是供实现可调整大小 ArrayBuffer 的 ECMAScript 实现者的指南。
Resizable ArrayBuffer 可实现为在调整时复制、通过预留虚拟内存的原地增长、或针对
若
若
25.2 SharedArrayBuffer 对象
25.2.1 固定长度与可增长的 SharedArrayBuffer 对象
固定长度 SharedArrayBuffer 是创建后其字节长度不可改变的 SharedArrayBuffer。
可增长 SharedArrayBuffer 是创建后其字节长度可通过调用
创建哪种 SharedArrayBuffer 对象取决于传递给
25.2.2 SharedArrayBuffer 对象的抽象操作
25.2.2.1 AllocateSharedArrayBuffer ( constructor, byteLength [ , maxByteLength ] )
The abstract operation AllocateSharedArrayBuffer takes arguments constructor (a constructor) and byteLength (a non-negative
- 令 slots 为 « [[ArrayBufferData]] »。
- 若存在 maxByteLength 且其不为
empty ，令 allocatingGrowableBuffer 为true ；否则令其为false 。 - 若 allocatingGrowableBuffer 为
true ，则- 若 byteLength > maxByteLength，抛出
RangeError 异常。 - 将 [[ArrayBufferByteLengthData]] 与 [[ArrayBufferMaxByteLength]] 追加到 slots。
- 若 byteLength > maxByteLength，抛出
- 否则，
- 将 [[ArrayBufferByteLength]] 追加到 slots。
- 令 obj 为 ?
OrdinaryCreateFromConstructor (constructor,"%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. 测试一个对象是否是 ArrayBuffer、SharedArrayBuffer，或它们的子类型。 It performs the following steps when called:
- 令 bufferData 为 obj.[[ArrayBufferData]]。
- 若 bufferData 为
null ，返回false 。 - 若 bufferData 是
Data Block ，返回false 。 - 断言：bufferData 是
Shared Data Block 。 - 返回
true 。
25.2.2.3 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 异常。 - 令 isLittleEndian 为外层 agent 的
Agent Record 的 [[LittleEndian]] 字段的值。若该抽象操作 以handled 正常完成 ，则一个WriteSharedMemory 或ReadModifyWriteSharedMemory 事件被加入外层 agent 的候选执行，其 [[Order]] 为seq-cst ，[[Payload]] 为NumericToRawBytes (biguint64 , newByteLength, isLittleEndian)，[[Block]] 为 buffer.[[ArrayBufferByteLengthData]]，[[ByteIndex]] 为 0，[[ElementSize]] 为 8，从而并发竞争的SharedArrayBuffer.prototype.grow调用不会“丢失”（即静默不做任何事）。
上面第二个要求有意未明确说明如何或何时读取 buffer 的当前字节长度。由于字节长度必须通过底层硬件的原子读-改-写操作更新，使用 load-link/store-conditional 或 load-exclusive/store-exclusive 指令对的体系结构可能希望将该指令对在指令流中保持紧邻。因此，SharedArrayBuffer.prototype.grow 自身不会在调用 HostGrowSharedArrayBuffer 前对 newByteLength 做边界检查，也不要求何时读取当前字节长度。
这与
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%] 是一个存取器属性，其 set 访问器函数为
- 返回
this 值。
该函数
25.2.5 SharedArrayBuffer 原型对象的属性
SharedArrayBuffer 原型对象：
- 是 %SharedArrayBuffer.prototype%。
- 具有 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是一个
普通对象 。 - 没有 [[ArrayBufferData]] 或 [[ArrayBufferByteLength]] 内部槽。
25.2.5.1 get SharedArrayBuffer.prototype.byteLength
SharedArrayBuffer.prototype.byteLength 是一个存取器属性，其 set 访问器函数为
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[ArrayBufferData]])。 - 若
IsSharedArrayBuffer (O) 为false ，抛出TypeError 异常。 - 令 length 为
ArrayBufferByteLength (O,seq-cst )。 - 返回
𝔽 (length)。
25.2.5.2 SharedArrayBuffer.prototype.constructor
SharedArrayBuffer.prototype.constructor 的初始值是
25.2.5.3 SharedArrayBuffer.prototype.grow ( newLength )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[ArrayBufferMaxByteLength]])。 - 若
IsSharedArrayBuffer (O) 为false ，抛出TypeError 异常。 - 令 newByteLength 为 ?
ToIndex (newLength)。 - 令 hostHandled 为 ?
HostGrowSharedArrayBuffer (O, newByteLength)。 - 若 hostHandled 为
handled ，返回undefined 。 - 令 isLittleEndian 为外层 agent 的
Agent Record 的 [[LittleEndian]] 字段的值。 - 令 byteLengthBlock 为 O.[[ArrayBufferByteLengthData]]。
- 令 currentByteLengthRawBytes 为
GetRawBytesFromSharedBlock (byteLengthBlock, 0,biguint64 ,true ,seq-cst )。 - 令 newByteLengthRawBytes 为
NumericToRawBytes (biguint64 ,ℤ (newByteLength), isLittleEndian)。 - 重复，
- 注：这是一个比较并交换循环，确保对同一缓冲区的并行竞争增长是全序的，不会丢失，也不会静默不执行。循环在能够无竞争地尝试增长时退出。
- 令 currentByteLength 为
ℝ (RawBytesToNumeric (biguint64 , currentByteLengthRawBytes, isLittleEndian))。 - 若 newByteLength = currentByteLength，返回
undefined 。 - 若 newByteLength < currentByteLength 或 newByteLength > O.[[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。
禁止比较交换更新长度的虚假失败。若新长度的边界检查通过且实现未耗尽内存，则总会向候选执行添加一个
对 SharedArrayBuffer.prototype.grow 的并行调用是全序的。例如并发的 sab.grow(10) 与 sab.grow(20)，二者之一必定赢得竞争。sab.grow(10) 不会在 sab.grow(20) 先发生时收缩 sab；在那种情况下它将抛出 RangeError。
25.2.5.4 get SharedArrayBuffer.prototype.growable
SharedArrayBuffer.prototype.growable 是一个存取器属性，其 set 访问器函数为
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[ArrayBufferData]])。 - 若
IsSharedArrayBuffer (O) 为false ，抛出TypeError 异常。 - 若
IsFixedLengthArrayBuffer (O) 为false ，返回true ；否则返回false 。
25.2.5.5 get SharedArrayBuffer.prototype.maxByteLength
SharedArrayBuffer.prototype.maxByteLength 是一个存取器属性，其 set 访问器函数为
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[ArrayBufferData]])。 - 若
IsSharedArrayBuffer (O) 为false ，抛出TypeError 异常。 - 若
IsFixedLengthArrayBuffer (O) 为true ，则- 令 length 为 O.[[ArrayBufferByteLength]]。
- 否则，
- 令 length 为 O.[[ArrayBufferMaxByteLength]]。
- 返回
𝔽 (length)。
25.2.5.6 SharedArrayBuffer.prototype.slice ( start, end )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[ArrayBufferData]])。 - 若
IsSharedArrayBuffer (O) 为false ，抛出TypeError 异常。 - 令 len 为
ArrayBufferByteLength (O,seq-cst )。 - 令 relativeStart 为 ?
ToIntegerOrInfinity (start)。 - 若 relativeStart = -∞，令 first 为 0。
- Else if relativeStart < 0，令 first 为
max (len + relativeStart, 0)。 - Else，令 first 为
min (relativeStart, len)。 - 若 end 为
undefined ，令 relativeEnd 为 len；否则令 relativeEnd 为 ?ToIntegerOrInfinity (end)。 - 若 relativeEnd = -∞，令 final 为 0。
- Else if relativeEnd < 0，令 final 为
max (len + relativeEnd, 0)。 - Else，令 final 为
min (relativeEnd, len)。 - 令 newLen 为
max (final - first, 0)。 - 令 ctor 为 ?
SpeciesConstructor (O,%SharedArrayBuffer% )。 - 令 new 为 ? Construct(ctor, «
𝔽 (newLen) »)。 - 执行 ?
RequireInternalSlot (new, [[ArrayBufferData]])。 - 若
IsSharedArrayBuffer (new) 为false ，抛出TypeError 异常。 - 若 new.[[ArrayBufferData]] 是 O.[[ArrayBufferData]]，抛出
TypeError 异常。 - 若
ArrayBufferByteLength (new,seq-cst ) < newLen，抛出TypeError 异常。 - 令 fromBuf 为 O.[[ArrayBufferData]]。
- 令 toBuf 为 new.[[ArrayBufferData]]。
- 执行
CopyDataBlockBytes (toBuf, 0, fromBuf, first, newLen)。 - 返回 new。
25.2.5.7 SharedArrayBuffer.prototype [ %Symbol.toStringTag% ]
该属性特性为 { [[Writable]]:
25.2.6 SharedArrayBuffer 实例的属性
SharedArrayBuffer 实例从
SharedArrayBuffer 实例与 ArrayBuffer 实例不同，永远不会被分离。
25.2.7 可增长 SharedArrayBuffer 指南
以下是供使用
建议在部署环境中（若可行）对程序进行测试。不同硬件设备的可用物理内存差异巨大；虚拟内存子系统同样因硬件与操作系统不同而显著差异。一个在 64 位桌面浏览器中无内存耗尽错误的应用，可能在 32 位移动浏览器中耗尽内存。
为
请注意：成功构造一个指定最大值的
对u8[idx]）的边界检查中的长度读取不是同步的。一般而言，在缺乏显式同步的情况下，一个属性访问在边界内并不意味着同一 agent 中后续的另一个属性访问也在边界内。相比之下，通过 SharedArrayBuffer、length 与 byteLength getter 对长度的显式读取是同步的。内置方法为检查
以下是实现
建议将
由于增长操作可与对
被增长的内存在创建时必须表现为已归零，包括对任何并行的竞争访问。这可通过按需零填充的虚拟内存页实现，或在手动清零内存时使用谨慎的同步。
针对
在没有虚拟内存的
25.3 DataView 对象
25.3.1 DataView 对象的抽象操作
25.3.1.1 具有缓冲区见证记录的 DataView
具有缓冲区见证记录的 DataView 是一个
具有缓冲区见证记录的 DataView 拥有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[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 DataView With Buffer Witness
- 断言：
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 DataView With Buffer Witness
- 令 view 为 viewRecord.[[Object]]。
- 令 bufferByteLength 为 viewRecord.[[CachedBufferByteLength]]。
- 断言：
IsDetachedBuffer (view.[[ViewedArrayBuffer]]) 为true 当且仅当 bufferByteLength 为detached 。 - 若 bufferByteLength 为
detached ，返回true 。 - 令 byteOffsetStart 为 view.[[ByteOffset]]。
- 若 view.[[ByteLength]] 为
auto ，则- 令 byteOffsetEnd 为 bufferByteLength。
- 否则，
- 令 byteOffsetEnd 为 byteOffsetStart + view.[[ByteLength]]。
- 若 byteOffsetStart > bufferByteLength 或 byteOffsetEnd > bufferByteLength，返回
true 。 - 注：长度为 0 的 DataView 不被视为越界。
- 返回
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 73 中元素类型 type 指定的元素大小值。 - 若 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 ，令 numberValue 为 ?ToBigInt (value)。 - 否则，令 numberValue 为 ?
ToNumber (value)。 - 设 isLittleEndian 为
ToBoolean (isLittleEndian)。 - 令 viewOffset 为 view.[[ByteOffset]]。
- 令 viewRecord 为
MakeDataViewWithBufferWitnessRecord (view,unordered )。 - 注：当 view 的后备缓冲区是
可增长 SharedArrayBuffer 时，边界检查不是同步操作。 - 若
IsViewOutOfBounds (viewRecord) 为true ，抛出TypeError 异常。 - 令 viewSize 为
GetViewByteLength (viewRecord)。 - 令 elementSize 为
Table 73 中元素类型 type 指定的元素大小值。 - 若 getIndex + elementSize > viewSize，抛出
RangeError 异常。 - 令 bufferIndex 为 getIndex + viewOffset。
- 执行
SetValueInBuffer (view.[[ViewedArrayBuffer]], bufferIndex, type, numberValue,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 为 ?
- 令 O 为 ?
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，抛出
- 设 O.[[ViewedArrayBuffer]] 为 buffer。
- 设 O.[[ByteLength]] 为 viewByteLength。
- 设 O.[[ByteOffset]] 为 offset。
- 返回 O。
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 是一个存取器属性，其 set 访问器函数为
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[DataView]])。 - 断言：O 具有 [[ViewedArrayBuffer]] 内部槽。
- 令 buffer 为 O.[[ViewedArrayBuffer]]。
- 返回 buffer。
25.3.4.2 get DataView.prototype.byteLength
DataView.prototype.byteLength 是一个存取器属性，其 set 访问器函数为
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[DataView]])。 - 断言：O 具有 [[ViewedArrayBuffer]] 内部槽。
- 令 viewRecord 为
MakeDataViewWithBufferWitnessRecord (O,seq-cst )。 - 若
IsViewOutOfBounds (viewRecord) 为true ，抛出TypeError 异常。 - 令 size 为
GetViewByteLength (viewRecord)。 - 返回
𝔽 (size)。
25.3.4.3 get DataView.prototype.byteOffset
DataView.prototype.byteOffset 是一个存取器属性，其 set 访问器函数为
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[DataView]])。 - 断言：O 具有 [[ViewedArrayBuffer]] 内部槽。
- 令 viewRecord 为
MakeDataViewWithBufferWitnessRecord (O,seq-cst )。 - 若
IsViewOutOfBounds (viewRecord) 为true ，抛出TypeError 异常。 - 令 offset 为 O.[[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 对象提供在共享内存数组单元上不可分割（原子）操作的函数，以及让 agent 等待和派发原始事件（primitive events）的函数。正确使用 Atomics 函数，可以让通过共享内存通信的多 agent 程序即便在并行 CPU 上也按照可理解的顺序执行。共享内存通信的规则由下文定义的
关于在 ECMAScript 中编程与实现共享内存的说明性指南，请参见
25.4.1 Waiter Record
Waiter Record 是一个 Atomics.wait 或 Atomics.waitAsync 的特定调用。
Waiter Record 拥有
| 字段名 | 取值 | 含义 |
|---|---|---|
| [[AgentSignifier]] | 一个 agent 标识符 |
调用 Atomics.wait 或 Atomics.waitAsync 的 agent。
|
| [[PromiseCapability]] |
一个 |
若表示一次对 Atomics.waitAsync 的调用，则为生成的 promise，否则为 |
| [[TimeoutTime]] |
一个非负 |
可能触发超时的最早时间；使用 |
| [[Result]] |
|
调用的返回值。 |
25.4.2 WaiterList Records
WaiterList Record 用于解释通过 Atomics.wait、Atomics.waitAsync 与 Atomics.notify 进行的等待与通知。
WaiterList Record 拥有
| 字段名 | 取值 | 含义 |
|---|---|---|
| [[Waiters]] |
一个 |
等待与该 WaiterList 关联的位置的 Atomics.wait 或 Atomics.waitAsync 调用。
|
| [[MostRecentLeaveEvent]] |
一个 |
最近一次离开其临界区的事件；若从未进入过其临界区则为 |
在一个 WaiterList 中可以有多个具有相同 agent 标识符的
agent 集群拥有一个 WaiterList Record 的存储；该存储由 (block, i) 索引，其中 block 是一个
每个 WaiterList Record 有一个 临界区（critical section），控制在求值期间对该 WaiterList Record 的独占访问。一次只能有一个 agent 进入该临界区。进入和离开临界区由
25.4.3 Atomics 的抽象操作
25.4.3.1 ValidateIntegerTypedArray ( typedArray, waitable )
The abstract operation ValidateIntegerTypedArray takes arguments typedArray (an ECMAScript language value) and waitable (a Boolean) and returns 要么是包含一个
- 令 taRecord 为 ?
ValidateTypedArray (typedArray,unordered )。 - 注：当 typedArray 的后备缓冲区是
可增长 SharedArrayBuffer 时，边界检查不是同步操作。 - 若 waitable 为
true ，则- 若 typedArray.[[TypedArrayName]] 既不是
"Int32Array" 也不是"BigInt64Array" ，抛出TypeError 异常。
- 若 typedArray.[[TypedArrayName]] 既不是
- 否则，
- 令 type 为
TypedArrayElementType (typedArray)。 - 若
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 异常。 - 令 typedArray 为 taRecord.[[Object]]。
- 令 elementSize 为
TypedArrayElementSize (typedArray)。 - 令 offset 为 typedArray.[[ByteOffset]]。
- 返回 (accessIndex × elementSize) + offset。
25.4.3.3 ValidateAtomicAccessOnIntegerTypedArray ( typedArray, requestIndex )
The abstract operation ValidateAtomicAccessOnIntegerTypedArray takes arguments typedArray (an ECMAScript language value) and requestIndex (an ECMAScript language value) and returns 要么是包含一个整数的
- 令 taRecord 为 ?
ValidateIntegerTypedArray (typedArray,false )。 - 返回 ?
ValidateAtomicAccess (taRecord, requestIndex)。
25.4.3.4 RevalidateAtomicAccess ( typedArray, byteIndexInBuffer )
The abstract operation RevalidateAtomicAccess takes arguments typedArray (a
- 令 taRecord 为
MakeTypedArrayWithBufferWitnessRecord (typedArray,unordered )。 - 注：当 typedArray 的后备缓冲区是
可增长 SharedArrayBuffer 时，边界检查不是同步操作。 - 若
IsTypedArrayOutOfBounds (taRecord) 为true ，抛出TypeError 异常。 - 断言：byteIndexInBuffer ≥ typedArray.[[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 ( WL )
The abstract operation EnterCriticalSection takes argument WL (a
- 断言：外层 agent 不在任何
WaiterList Record 的临界区中。 - 等待直到没有 agent 在 WL 的临界区中，然后进入 WL 的临界区（期间不允许其他 agent 进入）。
- 若 WL.[[MostRecentLeaveEvent]] 不为
empty ，则- 注：至少进入过一次临界区的 WL 有由
LeaveCriticalSection 设置的Synchronize 事件 。 - 令 execution 为外层 agent 的
Agent Record 的 [[CandidateExecution]] 字段。 - 令 eventsRecord 为 execution.[[EventsRecords]] 中 [[AgentSignifier]] 为
AgentSignifier () 的Agent Events Record 。 - 令 enterEvent 为一个新的
Synchronize 事件 。 - 将 enterEvent 追加到 eventsRecord.[[EventList]]。
- 将 (WL.[[MostRecentLeaveEvent]], enterEvent) 追加到 eventsRecord.[[AgentSynchronizesWith]]。
- 注：至少进入过一次临界区的 WL 有由
- 返回
unused 。
当尝试进入临界区的 agent 必须等待另一个 agent 离开时，EnterCriticalSection 存在 争用（contention）。无争用时，EnterCriticalSection 调用的 FIFO 顺序是可观察的；有争用时，实现可选择任意顺序，但不能导致某个 agent 无限期等待。
25.4.3.7 LeaveCriticalSection ( WL )
The abstract operation LeaveCriticalSection takes argument WL (a
- 断言：外层 agent 正在 WL 的临界区中。
- 令 execution 为外层 agent 的
Agent Record 的 [[CandidateExecution]] 字段。 - 令 eventsRecord 为 execution.[[EventsRecords]] 中 [[AgentSignifier]] 为
AgentSignifier () 的Agent Events Record 。 - 令 leaveEvent 为一个新的
Synchronize 事件 。 - 将 leaveEvent 追加到 eventsRecord.[[EventList]]。
- 设 WL.[[MostRecentLeaveEvent]] 为 leaveEvent。
- 离开 WL 的临界区。
- 返回
unused 。
25.4.3.8 AddWaiter ( WL, waiterRecord )
The abstract operation AddWaiter takes arguments WL (a
- 断言：外层 agent 在 WL 的临界区中。
- 断言：WL.[[Waiters]] 中不存在其 [[PromiseCapability]] 字段为 waiterRecord.[[PromiseCapability]] 且 [[AgentSignifier]] 字段为 waiterRecord.[[AgentSignifier]] 的
Waiter Record 。 - 将 waiterRecord 追加到 WL.[[Waiters]]。
- 返回
unused 。
25.4.3.9 RemoveWaiter ( WL, waiterRecord )
The abstract operation RemoveWaiter takes arguments WL (a
- 断言：外层 agent 在 WL 的临界区中。
- 断言：WL.[[Waiters]] 包含 waiterRecord。
- 从 WL.[[Waiters]] 移除 waiterRecord。
- 返回
unused 。
25.4.3.10 RemoveWaiters ( WL, c )
The abstract operation RemoveWaiters takes arguments WL (a
25.4.3.11 SuspendThisAgent ( WL, waiterRecord )
The abstract operation SuspendThisAgent takes arguments WL (a
- 断言：外层 agent 在 WL 的临界区中。
- 断言：WL.[[Waiters]] 包含 waiterRecord。
- 令 thisAgent 为
AgentSignifier ()。 - 断言：waiterRecord.[[AgentSignifier]] 是 thisAgent。
- 断言：waiterRecord.[[PromiseCapability]] 是
blocking 。 - 断言：
AgentCanSuspend () 为true 。 - 执行
LeaveCriticalSection (WL) 并挂起外层 agent 直到时间到达 waiterRecord.[[TimeoutTime]]，以一种方式组合操作：使得离开临界区后到挂起生效前到来的通知不会丢失。外层 agent 只能因超时或另一个 agent 使用参数 WL 与 thisAgent 调用NotifyWaiter （即通过调用Atomics.notify）而被唤醒。 - 执行
EnterCriticalSection (WL)。 - 返回
unused 。
25.4.3.12 NotifyWaiter ( WL, waiterRecord )
The abstract operation NotifyWaiter takes arguments WL (a
- 断言：外层 agent 在 WL 的临界区中。
- 若 waiterRecord.[[PromiseCapability]] 为
blocking ，则- 唤醒其标识符为 waiterRecord.[[AgentSignifier]] 的 agent。
- 注：这会使该 agent 在
SuspendThisAgent 中恢复执行。
- 否则若
AgentSignifier () 是 waiterRecord.[[AgentSignifier]]，则- 令 promiseCapability 为 waiterRecord.[[PromiseCapability]]。
- 执行 ! Call(promiseCapability.[[Resolve]],
undefined , « waiterRecord.[[Result]] »)。
- 否则，
- 执行
EnqueueResolveInAgentJob (waiterRecord.[[AgentSignifier]], waiterRecord.[[PromiseCapability]], waiterRecord.[[Result]])。
- 执行
- 返回
unused 。
一个 agent 不得以除传递给
25.4.3.13 EnqueueResolveInAgentJob ( agentSignifier, promiseCapability, resolution )
The abstract operation EnqueueResolveInAgentJob takes arguments agentSignifier (an agent signifier), promiseCapability (a
- 令 resolveJob 为一个无参数的新 Job 抽象闭包，捕获 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, typedArray, index, value, timeout )
The abstract operation DoWait takes arguments mode (
- 令 taRecord 为 ?
ValidateIntegerTypedArray (typedArray,true )。 - 令 buffer 为 taRecord.[[Object]].[[ViewedArrayBuffer]]。
- 若
IsSharedArrayBuffer (buffer) 为false ，抛出TypeError 异常。 - 令 i 为 ?
ValidateAtomicAccess (taRecord, index)。 - 令 arrayTypeName 为 typedArray.[[TypedArrayName]]。
- 若 arrayTypeName 为
"BigInt64Array" ，令 v 为 ?ToBigInt64 (value)。 - 否则，令 v 为 ?
ToInt32 (value)。 - 令 q 为 ?
ToNumber (timeout)。 - 若 q 为
NaN 或+∞ 𝔽，令 t 为 +∞；否则若 q 为-∞ 𝔽，令 t 为 0；否则令 t 为max (ℝ (q), 0)。 - 若 mode 为
sync 且AgentCanSuspend () 为false ，抛出TypeError 异常。 - 令 block 为 buffer.[[ArrayBufferData]]。
- 令 offset 为 typedArray.[[ByteOffset]]。
- 令 byteIndexInBuffer 为 (i × 4) + offset。
- 令 WL 为
GetWaiterList (block, byteIndexInBuffer)。 - 若 mode 为
sync ，则- 令 promiseCapability 为
blocking 。 - 令 resultObject 为
undefined 。
- 令 promiseCapability 为
- 否则，
- 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 resultObject 为
OrdinaryObjectCreate (%Object.prototype% )。
- 令 promiseCapability 为 !
- 执行
EnterCriticalSection (WL)。 - 令 elementType 为
TypedArrayElementType (typedArray)。 - 令 w 为
GetValueFromBuffer (buffer, byteIndexInBuffer, elementType,true ,seq-cst )。 - 若 v ≠ w，则
- 执行
LeaveCriticalSection (WL)。 - 若 mode 为
sync ，返回"not-equal" 。 - 执行 !
CreateDataPropertyOrThrow (resultObject,"async" ,false )。 - 执行 !
CreateDataPropertyOrThrow (resultObject,"value" ,"not-equal" )。 - 返回 resultObject。
- 执行
- 若 t = 0 且 mode 为
async ，则- 注：对同步的立即超时没有特殊处理；异步立即超时被特殊处理以快速失败并避免不必要的 Promise 作业。
- 执行
LeaveCriticalSection (WL)。 - 执行 !
CreateDataPropertyOrThrow (resultObject,"async" ,false )。 - 执行 !
CreateDataPropertyOrThrow (resultObject,"value" ,"timed-out" )。 - 返回 resultObject。
- 令 thisAgent 为
AgentSignifier ()。 - 令 now 为标识当前时间的
时间值 (UTC)。 - 令 additionalTimeout 为实现定义的非负
数学值 。 - 令 timeoutTime 为
ℝ (now) + t + additionalTimeout。 - 注：当 t 为 +∞ 时，timeoutTime 亦为 +∞。
- 令 waiterRecord 为一个新
Waiter Record { [[AgentSignifier]]: thisAgent, [[PromiseCapability]]: promiseCapability, [[TimeoutTime]]: timeoutTime, [[Result]]:"ok" }。 - 执行
AddWaiter (WL, waiterRecord)。 - 若 mode 为
sync ，则- 执行
SuspendThisAgent (WL, waiterRecord)。
- 执行
- 否则若 timeoutTime 是
有限 的，则- 执行
EnqueueAtomicsWaitAsyncTimeoutJob (WL, waiterRecord)。
- 执行
- 执行
LeaveCriticalSection (WL)。 - 若 mode 为
sync ，返回 waiterRecord.[[Result]]。 - 执行 !
CreateDataPropertyOrThrow (resultObject,"async" ,true )。 - 执行 !
CreateDataPropertyOrThrow (resultObject,"value" , promiseCapability.[[Promise]])。 - 返回 resultObject。
additionalTimeout 允许实现按需填充超时，例如用于降低能耗或粗化计时器分辨率以缓解计时攻击。该值在不同 DoWait 调用间可能不同。
25.4.3.15 EnqueueAtomicsWaitAsyncTimeoutJob ( WL, waiterRecord )
The abstract operation EnqueueAtomicsWaitAsyncTimeoutJob takes arguments WL (a
- 令 timeoutJob 为一个无参数的新 Job 抽象闭包，捕获 WL 与 waiterRecord，被调用时执行：
- 执行
EnterCriticalSection (WL)。 - 若 WL.[[Waiters]] 包含 waiterRecord，则
- 令 timeOfJobExecution 为标识当前时间的
时间值 (UTC)。 - 断言：
ℝ (timeOfJobExecution) ≥ waiterRecord.[[TimeoutTime]]（忽略时间值 可能的非单调性）。 - 设 waiterRecord.[[Result]] 为
"timed-out" 。 - 执行
RemoveWaiter (WL, waiterRecord)。 - 执行
NotifyWaiter (WL, waiterRecord)。
- 令 timeOfJobExecution 为标识当前时间的
- 执行
LeaveCriticalSection (WL)。 - 返回
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
- 令 execution 为外层 agent 的
Agent Record 的 [[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 为一个具有参数 (oldBytes, newBytes) 的新读-改-写修改函数，不捕获任何内容，被调用时原子地执行：
- 否则，
- 令 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 ( typedArray, index, value, op )
The abstract operation AtomicReadModifyWrite takes arguments typedArray (an ECMAScript language value), index (an ECMAScript language value), value (an ECMAScript language value), and op (a read-modify-write modification function) and returns 要么是包含 Number 或 BigInt 的
- 令 byteIndexInBuffer 为 ?
ValidateAtomicAccessOnIntegerTypedArray (typedArray, index)。 - 若 typedArray.[[ContentType]] 为
bigint ，令 v 为 ?ToBigInt (value)。 - 否则，令 v 为
𝔽 (?ToIntegerOrInfinity (value))。 - 执行 ?
RevalidateAtomicAccess (typedArray, byteIndexInBuffer)。 - 令 buffer 为 typedArray.[[ViewedArrayBuffer]]。
- 令 elementType 为
TypedArrayElementType (typedArray)。 - 返回
GetModifySetValueInBuffer (buffer, byteIndexInBuffer, elementType, v, 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 执行按位与的结果。
- 否则若 op 是
^，则- 令 resultByte 为按位异或结果。
- 否则，
- 断言：op 是
|。 - 令 resultByte 为按位或结果。
- 断言：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 ( typedArray, index, value )
该函数被调用时执行以下步骤：
- 令 add 为一个具有参数 (xBytes, yBytes) 的新读-改-写修改函数，捕获 typedArray，被调用时原子地执行：
- 令 type 为
TypedArrayElementType (typedArray)。 - 令 isLittleEndian 为外层 agent 的
Agent Record 的 [[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)。
- 断言：x
- 令 sumBytes 为
NumericToRawBytes (type, sum, isLittleEndian)。 - 断言：sumBytes、xBytes 与 yBytes 拥有相同数量的元素。
- 返回 sumBytes。
- 令 type 为
- 返回 ?
AtomicReadModifyWrite (typedArray, index, value, add)。
25.4.5 Atomics.and ( typedArray, index, value )
该函数被调用时执行以下步骤：
- 令 and 为一个具有参数 (xBytes, yBytes) 的新读-改-写修改函数，不捕获任何内容，被调用时原子地执行：
- 返回
ByteListBitwiseOp (&, xBytes, yBytes)。
- 返回
- 返回 ?
AtomicReadModifyWrite (typedArray, index, value, and)。
25.4.6 Atomics.compareExchange ( typedArray, index, expectedValue, replacementValue )
该函数被调用时执行以下步骤：
- 令 byteIndexInBuffer 为 ?
ValidateAtomicAccessOnIntegerTypedArray (typedArray, index)。 - 令 buffer 为 typedArray.[[ViewedArrayBuffer]]。
- 令 block 为 buffer.[[ArrayBufferData]]。
- 若 typedArray.[[ContentType]] 为
bigint ，则 - 否则，
- 令 expected 为
𝔽 (?ToIntegerOrInfinity (expectedValue))。 - 令 replacement 为
𝔽 (?ToIntegerOrInfinity (replacementValue))。
- 令 expected 为
- 执行 ?
RevalidateAtomicAccess (typedArray, byteIndexInBuffer)。 - 令 elementType 为
TypedArrayElementType (typedArray)。 - 令 elementSize 为
TypedArrayElementSize (typedArray)。 - 令 isLittleEndian 为外层 agent 的
Agent Record 的 [[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 ( typedArray, index, value )
该函数被调用时执行以下步骤：
- 令 second 为一个具有参数 (oldBytes, newBytes) 的新读-改-写修改函数，不捕获任何内容，被调用时原子地执行：
- 返回 newBytes。
- 返回 ?
AtomicReadModifyWrite (typedArray, index, value, second)。
25.4.8 Atomics.isLockFree ( size )
该函数被调用时执行以下步骤：
- 令 n 为 ?
ToIntegerOrInfinity (size)。 - 令 AR 为外层 agent 的
Agent Record 。 - 若 n = 1，返回 AR.[[IsLockFree1]]。
- 若 n = 2，返回 AR.[[IsLockFree2]]。
- 若 n = 4，返回
true 。 - 若 n = 8，返回 AR.[[IsLockFree8]]。
- 返回
false 。
此函数是一个优化原语。直觉是：如果大小为 n 字节的数据上的原子原语（compareExchange、load、store、add、sub、and、or、xor 或 exchange）的原子步骤会在不获取该数据之外的锁的情况下执行，则 Atomics.isLockFree(n) 返回
Atomics.isLockFree(4) 总是返回
无论此函数返回何值，所有原子操作都保证原子性。例如，它们不会在操作中间出现可见操作（如“撕裂”）。
25.4.9 Atomics.load ( typedArray, index )
该函数被调用时执行以下步骤：
- 令 byteIndexInBuffer 为 ?
ValidateAtomicAccessOnIntegerTypedArray (typedArray, index)。 - 执行 ?
RevalidateAtomicAccess (typedArray, byteIndexInBuffer)。 - 令 buffer 为 typedArray.[[ViewedArrayBuffer]]。
- 令 elementType 为
TypedArrayElementType (typedArray)。 - 返回
GetValueFromBuffer (buffer, byteIndexInBuffer, elementType,true ,seq-cst )。
25.4.10 Atomics.or ( typedArray, index, value )
该函数被调用时执行以下步骤：
- 令 or 为一个具有参数 (xBytes, yBytes) 的新读-改-写修改函数，不捕获任何内容，被调用时原子地执行：
- 返回
ByteListBitwiseOp (|, xBytes, yBytes)。
- 返回
- 返回 ?
AtomicReadModifyWrite (typedArray, index, value, or)。
25.4.11 Atomics.store ( typedArray, index, value )
该函数被调用时执行以下步骤：
- 令 byteIndexInBuffer 为 ?
ValidateAtomicAccessOnIntegerTypedArray (typedArray, index)。 - 若 typedArray.[[ContentType]] 为
bigint ，令 v 为 ?ToBigInt (value)。 - 否则，令 v 为
𝔽 (?ToIntegerOrInfinity (value))。 - 执行 ?
RevalidateAtomicAccess (typedArray, byteIndexInBuffer)。 - 令 buffer 为 typedArray.[[ViewedArrayBuffer]]。
- 令 elementType 为
TypedArrayElementType (typedArray)。 - 执行
SetValueInBuffer (buffer, byteIndexInBuffer, elementType, v,true ,seq-cst )。 - 返回 v。
25.4.12 Atomics.sub ( typedArray, index, value )
该函数被调用时执行以下步骤：
- 令 subtract 为一个具有参数 (xBytes, yBytes) 的新读-改-写修改函数，捕获 typedArray，被调用时原子地执行：
- 令 type 为
TypedArrayElementType (typedArray)。 - 令 isLittleEndian 为外层 agent 的
Agent Record 的 [[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)。
- 断言：x
- 令 differenceBytes 为
NumericToRawBytes (type, difference, isLittleEndian)。 - 断言：differenceBytes、xBytes 与 yBytes 拥有相同数量的元素。
- 返回 differenceBytes。
- 令 type 为
- 返回 ?
AtomicReadModifyWrite (typedArray, index, value, subtract)。
25.4.13 Atomics.wait ( typedArray, index, value, timeout )
该函数将外层 agent 置于等待队列并挂起，直到被通知或等待超时，返回区分这些情形的字符串。
调用时执行以下步骤：
- 返回 ?
DoWait (sync , typedArray, index, value, timeout)。
25.4.14 Atomics.waitAsync ( typedArray, index, value, timeout )
该函数返回一个 Promise，当调用者 agent 被通知或超时到达时 resolve。
调用时执行以下步骤：
- 返回 ?
DoWait (async , typedArray, index, value, timeout)。
25.4.15 Atomics.notify ( typedArray, index, count )
该函数通知一些在等待队列中休眠的 agent。
调用时执行以下步骤：
- 令 taRecord 为 ?
ValidateIntegerTypedArray (typedArray,true )。 - 令 byteIndexInBuffer 为 ?
ValidateAtomicAccess (taRecord, index)。 - 若 count 为
undefined ，则- 令 c 为 +∞。
- 否则，
- 令 intCount 为 ?
ToIntegerOrInfinity (count)。 - 令 c 为
max (intCount, 0)。
- 令 intCount 为 ?
- 令 buffer 为 typedArray.[[ViewedArrayBuffer]]。
- 令 block 为 buffer.[[ArrayBufferData]]。
- 若
IsSharedArrayBuffer (buffer) 为false ，返回+0 𝔽。 - 令 WL 为
GetWaiterList (block, byteIndexInBuffer)。 - 执行
EnterCriticalSection (WL)。 - 令 S 为
RemoveWaiters (WL, c)。 - 对 S 的每个元素 W，执行
- 执行
NotifyWaiter (WL, W)。
- 执行
- 执行
LeaveCriticalSection (WL)。 - 令 n 为 S 中元素数量。
- 返回
𝔽 (n)。
25.4.16 Atomics.xor ( typedArray, index, value )
该函数被调用时执行以下步骤：
- 令 xor 为一个具有参数 (xBytes, yBytes) 的新读-改-写修改函数，不捕获任何内容，被调用时原子地执行：
- 返回
ByteListBitwiseOp (^, xBytes, yBytes)。
- 返回
- 返回 ?
AtomicReadModifyWrite (typedArray, index, value, xor)。
25.4.17 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.parse ( text [ , reviver ] )
该函数解析一个 JSON 文本（JSON 格式的字符串）并生成一个
可选参数 reviver 是一个带两个参数 key 与 value 的函数。它可以过滤并转换结果。解析产生的每个 key/value 对都会调用它，其返回值将替代原始值。若返回收到的值，结构不变；若返回
- 令 jsonString 为 ?
ToString (text)。 - 令 unfiltered 为 ?
ParseJSON (jsonString)。 - 若
IsCallable (reviver) 为true ，则- 令 root 为
OrdinaryObjectCreate (%Object.prototype% )。 - 令 rootName 为空字符串。
- 执行 !
CreateDataPropertyOrThrow (root, rootName, unfiltered)。 - 返回 ?
InternalizeJSONProperty (root, rootName, reviver)。
- 令 root 为
- 否则，
- 返回 unfiltered。
该函数的
25.5.1.1 ParseJSON ( text )
The abstract operation ParseJSON takes argument text (a String) and returns 要么是包含一个
- 若 StringToCodePoints(text) 不是 ECMA-404 所规定的有效 JSON 文本，抛出
SyntaxError 异常。 - 令 scriptString 为
"(" 、text 与");" 的字符串连接。 - 令 script 为 ParseText(scriptString,
Script )。 - 注：
13.2.5.1 定义的早期错误规则 对上述 ParseText 调用有特殊处理。 - 断言：script 是一个 Parse Node。
- 令 result 为 ! Evaluation of script。
- 注：
13.2.5.5 定义的 PropertyDefinitionEvaluation 语义对上述求值有特殊处理。 - 断言：result 不是 String、Number、Boolean、由
ArrayLiteral 或ObjectLiteral 定义的 Object、就是null 。 - 返回 result。
一致实现的 JSON.parse 不允许扩展 JSON 语法。若实现希望支持修改或扩展的 JSON 交换格式，必须定义不同的解析函数。
有效 JSON 文本是 ECMAScript
然而，由于
当对象中存在重复名称字符串时，词法上先出现的同键值将被
25.5.1.2 InternalizeJSONProperty ( holder, name, reviver )
The abstract operation InternalizeJSONProperty takes arguments holder (an Object), name (a String), and reviver (a function object) and returns 要么是包含一个
该算法故意不在 [[Delete]] 或
调用时执行以下步骤：
- 令 val 为 ?
Get (holder, name)。 - 若 val
是 Object ，则- 令 isArray 为 ?
IsArray (val)。 - 若 isArray 为
true ，则- 令 len 为 ?
LengthOfArrayLike (val)。 - 令 I 为 0。
- 当 I < len 重复，
- 令 prop 为 !
ToString (𝔽 (I))。 - 令 newElement 为 ?
InternalizeJSONProperty (val, prop, reviver)。 - 若 newElement 为
undefined ，则- 执行 ? val.[[Delete]](prop)。
- 否则，
- 执行 ?
CreateDataProperty (val, prop, newElement)。
- 执行 ?
- 设 I 为 I + 1。
- 令 prop 为 !
- 令 len 为 ?
- 否则，
- 令 keys 为 ?
EnumerableOwnProperties (val,key )。 - 对 keys 的每个 String P，执行
- 令 newElement 为 ?
InternalizeJSONProperty (val, P, reviver)。 - 若 newElement 为
undefined ，则- 执行 ? val.[[Delete]](P)。
- 否则，
- 执行 ?
CreateDataProperty (val, P, newElement)。
- 执行 ?
- 令 newElement 为 ?
- 令 keys 为 ?
- 令 isArray 为 ?
- 返回 ? Call(reviver, holder, « name, val »)。
25.5.2 JSON.stringify ( value [ , replacer [ , space ] ] )
该函数返回一个 UTF-16 编码的 JSON 格式字符串表示一个
调用时执行以下步骤：
- 令 stack 为新空
List 。 - 令 indent 为空字符串。
- 令 PropertyList 为
undefined 。 - 令 ReplacerFunction 为
undefined 。 - 若 replacer
是 Object ，则- 若
IsCallable (replacer) 为true ，则- 设 ReplacerFunction 为 replacer。
- 否则，
- 令 isArray 为 ?
IsArray (replacer)。 - 若 isArray 为
true ，则- 设 PropertyList 为新空
List 。 - 令 len 为 ?
LengthOfArrayLike (replacer)。 - 令 k 为 0。
- 当 k < len 重复，
- 令 prop 为 !
ToString (𝔽 (k))。 - 令 v 为 ?
Get (replacer, prop)。 - 令 item 为
undefined 。 - 若 v 是 String，则
- 设 item 为 v。
- 否则若 v
是 Number ，则- 设 item 为 !
ToString (v)。
- 设 item 为 !
- 否则若 v
是 Object ，则- 若 v 具有 [[StringData]] 或 [[NumberData]] 内部槽，设 item 为 ?
ToString (v)。
- 若 v 具有 [[StringData]] 或 [[NumberData]] 内部槽，设 item 为 ?
- 若 item 不为
undefined 且 PropertyList 不包含 item，则- 将 item 追加到 PropertyList。
- 设 k 为 k + 1。
- 令 prop 为 !
- 设 PropertyList 为新空
- 令 isArray 为 ?
- 若
- 若 space
是 Object ，则 - 若 space
是 Number ，则- 令 spaceMV 为 !
ToIntegerOrInfinity (space)。 - 设 spaceMV 为
min (10, spaceMV)。 - 若 spaceMV < 1，令 gap 为空字符串；否则令 gap 为包含 spaceMV 个代码单元 0x0020 (SPACE) 的字符串。
- 令 spaceMV 为 !
- 否则若 space 是 String，则
- 若 space 长度 ≤ 10，令 gap 为 space；否则令 gap 为 space 的前 10 个代码单元子串。
- 否则，
- 令 gap 为空字符串。
- 令 wrapper 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 !
CreateDataPropertyOrThrow (wrapper, 空字符串, value)。 - 令 state 为
JSON Serialization Record { [[ReplacerFunction]]: ReplacerFunction, [[Stack]]: stack, [[Indent]]: indent, [[Gap]]: gap, [[PropertyList]]: PropertyList }。 - 返回 ?
SerializeJSONProperty (state, 空字符串, wrapper)。
该函数的
JSON 结构允许任意深度嵌套，但必须非循环。若 value 是或包含循环结构，则该函数必须抛出
a = [];
a[0] = a;
my_text = JSON.stringify(a); // 必须抛出 TypeError。符号化的原始值呈现如下：
null 在 JSON 文本中呈现为字符串值"null" 。undefined 不呈现。true 在 JSON 文本中呈现为字符串值"true" 。false 在 JSON 文本中呈现为字符串值"false" 。
字符串值以 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.2.1 JSON Serialization Record
JSON Serialization Record 是一个
JSON Serialization Record 拥有
| 字段名 | 取值 | 含义 |
|---|---|---|
| [[ReplacerFunction]] | 一个 |
可为对象属性提供替换值的函数（来自 JSON.stringify 的 replacer 参数）。 |
| [[PropertyList]] | 一个 String 的 |
序列化非数组对象时包含的 |
| [[Gap]] | 一个 String | 缩进单元（来自 space 参数）。 |
| [[Stack]] | 一个对象的 |
正在序列化的嵌套对象集合，用于检测循环结构。 |
| [[Indent]] | 一个 String | 当前缩进。 |
25.5.2.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 »)。
- 令 toJSON 为 ?
- 若 state.[[ReplacerFunction]] 不为
undefined ，则- 设 value 为 ? Call(state.[[ReplacerFunction]], holder, « key, value »)。
- 若 value
是 Object ，则 - 若 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.2.3 QuoteJSONString ( value )
The abstract operation QuoteJSONString takes argument value (a String) and returns a String. 将 value 用 0x0022 (QUOTATION MARK) 代码单元包裹并对其中某些代码单元转义。该操作将 value 视作 UTF-16 编码的代码点序列，详见
- 令 product 为仅由代码单元 0x0022 (QUOTATION MARK) 组成的字符串值。
- 对 StringToCodePoints(value) 的每个代码点 C，执行
- 若 C 列于
Table 79 “Code Point” 列，则- 设 product 为 product 与该行 “Escape Sequence” 列中转义序列的连接。
- 否则若 C 数值小于 0x0020 (SPACE) 或与某
前导代理 或后导代理 数值相同，则- 令 unit 为数值等于 C 数值的代码单元。
- 设 product 为 product 与
UnicodeEscape (unit) 的连接。
- 否则，
- 设 product 为 product 与 UTF16EncodeCodePoint(C) 的连接。
- 若 C 列于
- 设 product 为 product 与代码单元 0x0022 (QUOTATION MARK) 的连接。
- 返回 product。
| Code Point | 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.2.4 UnicodeEscape ( C )
The abstract operation UnicodeEscape takes argument C (a code unit) and returns a String. 以 Unicode 转义序列表示 C。 It performs the following steps when called:
- 令 n 为 C 的数值。
- 断言：n ≤ 0xFFFF。
- 令 hex 为 n 的字符串表示，按小写十六进制格式。
- 返回代码单元 0x005C (REVERSE SOLIDUS)、
"u" 与StringPad (hex, 4,"0" ,start ) 的字符串连接。
25.5.2.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 ，则- 令 K 为 state.[[PropertyList]]。
- 否则，
- 令 K 为 ?
EnumerableOwnProperties (value,key )。
- 令 K 为 ?
- 令 partial 为新空
List 。 - 对 K 的每个元素 P，执行
- 令 strP 为 ?
SerializeJSONProperty (state, P, value)。 - 若 strP 不为
undefined ，则- 令 member 为
QuoteJSONString (P)。 - 设 member 为 member 与
":" 的连接。 - 若 state.[[Gap]] 非空字符串，则
- 设 member 为 member 与代码单元 0x0020 (SPACE) 的连接。
- 设 member 为 member 与 strP 的连接。
- 将 member 追加到 partial。
- 令 member 为
- 令 strP 为 ?
- 若 partial 为空，则
- 令 final 为
"{}" 。
- 令 final 为
- 否则，
- 若 state.[[Gap]] 为空字符串，则
- 令 properties 为以代码单元 0x002C (COMMA) 分隔连接 partial 中所有元素字符串的结果（不在首尾插入逗号）。
- 令 final 为
"{" 、properties、"}" 的连接。
- 否则，
- 令 separator 为代码单元 0x002C (COMMA)、代码单元 0x000A (LINE FEED) 与 state.[[Indent]] 的连接。
- 令 properties 为以 separator 分隔连接 partial 所有元素字符串的结果（不在首尾插入分隔符）。
- 令 final 为
"{" 、代码单元 0x000A (LINE FEED)、state.[[Indent]]、properties、代码单元 0x000A (LINE FEED)、stepBack 与"}" 的连接。
- 若 state.[[Gap]] 为空字符串，则
- 移除 state.[[Stack]] 的最后一个元素。
- 设 state.[[Indent]] 为 stepBack。
- 返回 final。
25.5.2.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 。 - 令 len 为 ?
LengthOfArrayLike (value)。 - 令 index 为 0。
- 当 index < len 重复，
- 令 strP 为 ?
SerializeJSONProperty (state, !ToString (𝔽 (index)), value)。 - 若 strP 为
undefined ，则- 将
"null" 追加到 partial。
- 将
- 否则，
- 将 strP 追加到 partial。
- 设 index 为 index + 1。
- 令 strP 为 ?
- 若 partial 为空，则
- 令 final 为
"[]" 。
- 令 final 为
- 否则，
- 若 state.[[Gap]] 为空字符串，则
- 令 properties 为以代码单元 0x002C (COMMA) 分隔连接 partial 所有元素字符串的结果（不在首尾插入逗号）。
- 令 final 为
"[" 、properties、"]" 的连接。
- 否则，
- 令 separator 为代码单元 0x002C (COMMA)、代码单元 0x000A (LINE FEED) 与 state.[[Indent]] 的连接。
- 令 properties 为以 separator 分隔连接 partial 所有元素字符串的结果（不在首尾插入分隔符）。
- 令 final 为
"[" 、代码单元 0x000A (LINE FEED)、state.[[Indent]]、properties、代码单元 0x000A (LINE FEED)、stepBack 与"]" 的连接。
- 若 state.[[Gap]] 为空字符串，则
- 移除 state.[[Stack]] 的最后一个元素。
- 设 state.[[Indent]] 为 stepBack。
- 返回 final。
数组表示仅包含从 array.length（不含）的元素。键不是
25.5.3 JSON [ %Symbol.toStringTag% ]
该属性具有特性 { [[Writable]]:
26 内存管理（Managing Memory）
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);
// ... 稍后 ...
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]] »)。 - 令 fn 为活动
函数对象 。 - 将 finalizationRegistry.[[Realm]] 设为 fn.[[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]] 包含 cell 时，cell.[[HeldValue]] 是存活的；然而这并不一定意味着 cell.[[UnregisterToken]] 或 cell.[[Target]] 是存活的。例如，用对象自身作为其注销标记（unregister token）进行注册并不会使该对象永久存活。
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 interface 包含
27.1.1.2 Iterator 接口
实现 iterator interface 的对象必须包含
| 属性 | 值 | 要求 |
|---|---|---|
|
|
一个返回 IteratorResult 对象的函数 |
返回的对象必须符合 IteratorResult 接口。如果之前对该迭代器的 next 方法的一次调用返回了 next 调用也应当返回 |
可以向 next 函数传递参数，但其含义与合法性取决于目标迭代器。for-of 语句及其他常见迭代器使用者不会传递任何参数，所以期望以这种方式使用的迭代器对象必须准备好在无参数情况下被调用。
| 属性 | 值 | 要求 |
|---|---|---|
|
|
一个返回 IteratorResult 对象的函数 |
返回的对象必须符合 IteratorResult 接口。调用此方法通知迭代器对象调用方不打算再进行任何 next 方法调用。返回的 IteratorResult 对象通常具有 return 方法的参数值。然而，这一要求不强制执行。
|
|
|
一个返回 IteratorResult 对象的函数 |
返回的对象必须符合 IteratorResult 接口。调用此方法通知迭代器对象调用方检测到错误条件。该参数可用于标识错误条件，通常会是一个异常对象。典型响应是 throw 传入的参数值。如果该方法未 throw，返回的 IteratorResult 对象通常具有 |
通常这些方法的调用方在调用前应检查其是否存在。包括 for-of、yield* 和数组解构在内的某些 ECMAScript 语言特性会在进行存在性检查后调用这些方法。大多数接受
27.1.1.3 Async Iterable 接口
async iterable interface 包含
| 属性 | 值 | 要求 |
|---|---|---|
%Symbol.asyncIterator% |
一个返回 async 迭代器对象的函数 | 返回的对象必须符合 |
27.1.1.4 Async Iterator 接口
实现 async iterator interface 的对象必须包含
| 属性 | 值 | 要求 |
|---|---|---|
| 一个返回 Promise（兑现为 IteratorResult 对象）的函数 |
返回的 promise 在兑现时，必须以符合 IteratorResult 接口的对象兑现。如果之前对某 async 迭代器的 另外，作为兑现值的 IteratorResult 对象的 |
可以向 next 函数传递参数，但其解释与有效性取决于目标 async 迭代器。for-await-of 语句及其他常见 async 迭代器使用者不会传递任何参数，因此期望这样使用的 async 迭代器对象必须准备好在无参数情况下被调用。
| 属性 | 值 | 要求 |
|---|---|---|
| 一个返回 Promise（兑现为 IteratorResult 对象）的函数 |
返回的 promise 在兑现时，必须以符合 IteratorResult 接口的对象兑现。调用此方法通知 async 迭代器对象调用方不打算再对该 async 迭代器进行更多 另外，作为兑现值的 IteratorResult 对象的 |
|
| 一个返回 Promise（兑现为 IteratorResult 对象）的函数 |
返回的 promise 在兑现时，必须以符合 IteratorResult 接口的对象兑现。调用此方法通知 async 迭代器对象调用方已检测到错误条件。参数可用于标识该错误条件，并且通常为一个异常对象。典型响应是返回一个以该参数值拒绝的被拒绝 promise。 如果返回的 promise 被兑现，IteratorResult 对象兑现值通常具有 |
通常这些方法的调用方在调用前应检查其是否存在。包括 for-await-of 和 yield* 在内的某些 ECMAScript 语言特性会在进行存在性检查后调用这些方法。
27.1.1.5 IteratorResult 接口
IteratorResult interface 包含
| 属性 | 值 | 要求 |
|---|---|---|
|
|
一个 Boolean |
这是迭代器 next 方法调用的结果状态。如果已到达迭代器末尾， |
|
|
一个 |
如果 done 为 |
27.1.2 迭代器辅助（Iterator Helper）对象
Iterator Helper object 是一个
27.1.2.1 %IteratorHelperPrototype% 对象
%IteratorHelperPrototype% 对象：
- 具有所有
Iterator Helper 对象继承的属性。 - 是一个
普通对象 。 - 具有一个 [[Prototype]] 内部槽，其值为
%Iterator.prototype% 。 - 具有以下属性：
27.1.2.1.1 %IteratorHelperPrototype%.next ( )
- Return ?
GeneratorResume (this value,undefined ,"Iterator Helper" ).
27.1.2.1.2 %IteratorHelperPrototype%.return ( )
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[UnderlyingIterator]]). - 断言：O 具有 [[GeneratorState]] 内部槽。
- 若 O.[[GeneratorState]] 为
suspended-start ，则- 设 O.[[GeneratorState]] 为
completed 。 - 注：一旦生成器进入 completed 状态，它将不再离开该状态，且其关联的执行上下文不再被恢复。与 O 关联的任何执行状态此时都可被丢弃。
- 执行 ?
IteratorClose (O.[[UnderlyingIterator]],NormalCompletion (unused )). - 返回
CreateIteratorResultObject (undefined ,true )。
- 设 O.[[GeneratorState]] 为
- 令 C 为
ReturnCompletion (undefined )。 - 返回 ?
GeneratorResumeAbrupt (O, C,"Iterator Helper" ).
27.1.2.1.3 %IteratorHelperPrototype% [ %Symbol.toStringTag% ]
此属性具有特性 { [[Writable]]:
27.1.3 迭代器对象
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.from ( O )
- 令 iteratorRecord 为 ?
GetIteratorFlattenable (O,iterate-string-primitives )。 - 令 hasInstance 为 ?
OrdinaryHasInstance (%Iterator% , iteratorRecord.[[Iterator]])。 - 若 hasInstance 为
true ，则- 返回 iteratorRecord.[[Iterator]]。
- 令 wrapper 为
OrdinaryObjectCreate (%WrapForValidIteratorPrototype% , « [[Iterated]] »)。 - 设 wrapper.[[Iterated]] 为 iteratorRecord。
- 返回 wrapper。
27.1.3.2.1.1 %WrapForValidIteratorPrototype% 对象
%WrapForValidIteratorPrototype% 对象：
- 是一个
普通对象 。 - 具有一个 [[Prototype]] 内部槽，其值为
%Iterator.prototype% 。
27.1.3.2.1.1.1 %WrapForValidIteratorPrototype%.next ( )
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[Iterated]]). - 令 iteratorRecord 为 O.[[Iterated]]。
- 返回 ? Call(iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]])。
27.1.3.2.1.1.2 %WrapForValidIteratorPrototype%.return ( )
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[Iterated]]). - 令 iterator 为 O.[[Iterated]].[[Iterator]]。
- 断言：iterator 是一个 Object。
- 令 returnMethod 为 ?
GetMethod (iterator,"return" )。 - 若 returnMethod 为
undefined ，则- 返回
CreateIteratorResultObject (undefined ,true )。
- 返回
- 返回 ? Call(returnMethod, iterator)。
27.1.3.2.2 Iterator.prototype
Iterator.prototype 的初始值是
此属性具有特性 { [[Writable]]:
27.1.4 Iterator 原型对象的属性
Iterator 原型对象：
- 是 %Iterator.prototype%。
- 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是一个
普通对象 。
本规范中所有实现
以下表达式是 ECMAScript 代码访问 %Iterator.prototype% 对象的一种方式：
Object.getPrototypeOf(Object.getPrototypeOf([][Symbol.iterator]()))27.1.4.1 Iterator.prototype.constructor
Iterator.prototype.constructor 是一个
27.1.4.1.1 get Iterator.prototype.constructor
[[Get]] 属性的值是一个不需要参数的内置函数。被调用时执行以下步骤：
- 返回
%Iterator% 。
27.1.4.1.2 set Iterator.prototype.constructor
[[Set]] 属性的值是一个接受参数 v 的内置函数。被调用时执行以下步骤：
- 执行 ?
SetterThatIgnoresPrototypeProperties (this value,%Iterator.prototype% ,"constructor" , v)。 - 返回
undefined 。
与大多数内置原型上的
27.1.4.2 Iterator.prototype.drop ( limit )
当调用此方法时，执行以下步骤：
- 令 O 为
this 值。 - 如果 O 不是一个 Object，抛出一个
TypeError 异常。 - 令 iterated 为
Iterator Record { [[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }。 - 令 numLimit 为
Completion (ToNumber (limit))。 IfAbruptCloseIterator (numLimit, iterated)。- 若 numLimit 为
NaN ，则- 令 error 为
ThrowCompletion (一个新建的RangeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 令 integerLimit 为 !
ToIntegerOrInfinity (numLimit)。 - 若 integerLimit < 0，则
- 令 error 为
ThrowCompletion (一个新建的RangeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 设 iterated 为 ?
GetIteratorDirect (O)。 - 令 closure 为一个新的无参数抽象闭包，捕获 iterated 与 integerLimit，调用时执行：
- 令 remaining 为 integerLimit。
- 重复，当 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% , « [[UnderlyingIterator]] »)。 - 设 result.[[UnderlyingIterator]] 为 iterated。
- 返回 result。
27.1.4.3 Iterator.prototype.every ( predicate )
当调用此方法时，执行以下步骤：
- 令 O 为
this 值。 - 如果 O 不是一个 Object，抛出一个
TypeError 异常。 - 令 iterated 为
Iterator Record { [[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }。 - 若
IsCallable (predicate) 为false ，则- 令 error 为
ThrowCompletion (一个新建的TypeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 设 iterated 为 ?
GetIteratorDirect (O)。 - 令 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.4.4 Iterator.prototype.filter ( predicate )
当调用此方法时，执行以下步骤：
- 令 O 为
this 值。 - 如果 O 不是一个 Object，抛出一个
TypeError 异常。 - 令 iterated 为
Iterator Record { [[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }。 - 若
IsCallable (predicate) 为false ，则- 令 error 为
ThrowCompletion (一个新建的TypeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 设 iterated 为 ?
GetIteratorDirect (O)。 - 令 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% , « [[UnderlyingIterator]] »)。 - 设 result.[[UnderlyingIterator]] 为 iterated。
- 返回 result。
27.1.4.5 Iterator.prototype.find ( predicate )
当调用此方法时，执行以下步骤：
- 令 O 为
this 值。 - 如果 O 不是一个 Object，抛出一个
TypeError 异常。 - 令 iterated 为
Iterator Record { [[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }。 - 若
IsCallable (predicate) 为false ，则- 令 error 为
ThrowCompletion (一个新建的TypeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 设 iterated 为 ?
GetIteratorDirect (O)。 - 令 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.4.6 Iterator.prototype.flatMap ( mapper )
当调用此方法时，执行以下步骤：
- 令 O 为
this 值。 - 如果 O 不是一个 Object，抛出一个
TypeError 异常。 - 令 iterated 为
Iterator Record { [[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }。 - 若
IsCallable (mapper) 为false ，则- 令 error 为
ThrowCompletion (一个新建的TypeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 设 iterated 为 ?
GetIteratorDirect (O)。 - 令 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% , « [[UnderlyingIterator]] »)。 - 设 result.[[UnderlyingIterator]] 为 iterated。
- 返回 result。
27.1.4.7 Iterator.prototype.forEach ( procedure )
当调用此方法时，执行以下步骤：
- 令 O 为
this 值。 - 如果 O 不是一个 Object，抛出一个
TypeError 异常。 - 令 iterated 为
Iterator Record { [[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }。 - 若
IsCallable (procedure) 为false ，则- 令 error 为
ThrowCompletion (一个新建的TypeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 设 iterated 为 ?
GetIteratorDirect (O)。 - 令 counter 为 0。
- 重复，
- 令 value 为 ?
IteratorStepValue (iterated)。 - 若 value 为
done ，返回undefined 。 - 令 result 为
Completion (Call(procedure,undefined , « value,𝔽 (counter) »))。 IfAbruptCloseIterator (result, iterated)。- 设 counter 为 counter + 1。
- 令 value 为 ?
27.1.4.8 Iterator.prototype.map ( mapper )
当调用此方法时，执行以下步骤：
- 令 O 为
this 值。 - 如果 O 不是一个 Object，抛出一个
TypeError 异常。 - 令 iterated 为
Iterator Record { [[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }。 - 若
IsCallable (mapper) 为false ，则- 令 error 为
ThrowCompletion (一个新建的TypeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 设 iterated 为 ?
GetIteratorDirect (O)。 - 令 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% , « [[UnderlyingIterator]] »)。 - 设 result.[[UnderlyingIterator]] 为 iterated。
- 返回 result。
27.1.4.9 Iterator.prototype.reduce ( reducer [ , initialValue ] )
当调用此方法时，执行以下步骤：
- 令 O 为
this 值。 - 如果 O 不是一个 Object，抛出一个
TypeError 异常。 - 令 iterated 为
Iterator Record { [[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }。 - 若
IsCallable (reducer) 为false ，则- 令 error 为
ThrowCompletion (一个新建的TypeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 设 iterated 为 ?
GetIteratorDirect (O)。 - 若 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.4.10 Iterator.prototype.some ( predicate )
当调用此方法时，执行以下步骤：
- 令 O 为
this 值。 - 如果 O 不是一个 Object，抛出一个
TypeError 异常。 - 令 iterated 为
Iterator Record { [[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }。 - 若
IsCallable (predicate) 为false ，则- 令 error 为
ThrowCompletion (一个新建的TypeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 设 iterated 为 ?
GetIteratorDirect (O)。 - 令 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.4.11 Iterator.prototype.take ( limit )
当调用此方法时，执行以下步骤：
- 令 O 为
this 值。 - 如果 O 不是一个 Object，抛出一个
TypeError 异常。 - 令 iterated 为
Iterator Record { [[Iterator]]: O, [[NextMethod]]:undefined , [[Done]]:false }。 - 令 numLimit 为
Completion (ToNumber (limit))。 IfAbruptCloseIterator (numLimit, iterated)。- 若 numLimit 为
NaN ，则- 令 error 为
ThrowCompletion (一个新建的RangeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 令 integerLimit 为 !
ToIntegerOrInfinity (numLimit)。 - 若 integerLimit < 0，则
- 令 error 为
ThrowCompletion (一个新建的RangeError 对象)。 - 返回 ?
IteratorClose (iterated, error)。
- 令 error 为
- 设 iterated 为 ?
GetIteratorDirect (O)。 - 令 closure 为一个新的无参数抽象闭包，捕获 iterated 与 integerLimit，调用时执行：
- 令 remaining 为 integerLimit。
- 重复，
- 若 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% , « [[UnderlyingIterator]] »)。 - 设 result.[[UnderlyingIterator]] 为 iterated。
- 返回 result。
27.1.4.12 Iterator.prototype.toArray ( )
当调用此方法时，执行以下步骤：
- 令 O 为
this 值。 - 如果 O 不是一个 Object，抛出一个
TypeError 异常。 - 令 iterated 为 ?
GetIteratorDirect (O)。 - 令 items 为一个新的空
List 。 - 重复，
- 令 value 为 ?
IteratorStepValue (iterated)。 - 若 value 为
done ，返回CreateArrayFromList (items)。 - 将 value 追加至 items。
- 令 value 为 ?
27.1.4.13 Iterator.prototype [ %Symbol.iterator% ] ( )
当调用此函数时，执行以下步骤：
- 返回
this 值。
此函数
27.1.4.14 Iterator.prototype [ %Symbol.toStringTag% ]
Iterator.prototype[%Symbol.toStringTag%] 是一个
27.1.4.14.1 get Iterator.prototype [ %Symbol.toStringTag% ]
[[Get]] 属性的值是一个不需要参数的内置函数。被调用时执行以下步骤：
- 返回
"Iterator" 。
27.1.4.14.2 set Iterator.prototype [ %Symbol.toStringTag% ]
[[Set]] 属性的值是一个接受参数 v 的内置函数。被调用时执行以下步骤：
- 执行 ?
SetterThatIgnoresPrototypeProperties (this value,%Iterator.prototype% ,%Symbol.toStringTag% , v)。 - 返回
undefined 。
与大多数内置原型上的
27.1.5 %AsyncIteratorPrototype% 对象
%AsyncIteratorPrototype% 对象：
- 具有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是一个
普通对象 。
本规范中所有实现
27.1.5.1 %AsyncIteratorPrototype% [ %Symbol.asyncIterator% ] ( )
当调用此函数时，执行以下步骤：
- 返回
this 值。
此函数
27.1.6 Async-from-Sync 迭代器对象
Async-from-Sync Iterator object 是一个将特定同步迭代器适配为 async 迭代器的对象。Async-from-Sync
27.1.6.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.6.2 %AsyncFromSyncIteratorPrototype% 对象
%AsyncFromSyncIteratorPrototype% 对象：
- 具有所有 Async-from-Sync
Iterator 对象继承的属性。 - 是一个
普通对象 。 - 具有一个 [[Prototype]] 内部槽，其值为
%AsyncIteratorPrototype% 。 - 永远不会被 ECMAScript 代码直接访问。
- 具有以下属性：
27.1.6.2.1 %AsyncFromSyncIteratorPrototype%.next ( [ value ] )
- 令 O 为
this 值。 - 断言：O 是一个具有 [[SyncIteratorRecord]] 内部槽的 Object。
- 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 syncIteratorRecord 为 O.[[SyncIteratorRecord]]。
- 若 value 存在，则
- 令 result 为
Completion (IteratorNext(syncIteratorRecord, value))。
- 令 result 为
- 否则，
- 令 result 为
Completion (IteratorNext(syncIteratorRecord))。
- 令 result 为
IfAbruptRejectPromise (result, promiseCapability)。- 返回
AsyncFromSyncIteratorContinuation (result, promiseCapability, syncIteratorRecord,true )。
27.1.6.2.2 %AsyncFromSyncIteratorPrototype%.return ( [ value ] )
- 令 O 为
this 值。 - 断言：O 是一个具有 [[SyncIteratorRecord]] 内部槽的 Object。
- 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 syncIteratorRecord 为 O.[[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]]。
- 执行 ! Call(promiseCapability.[[Reject]],
- 返回
AsyncFromSyncIteratorContinuation (result, promiseCapability, syncIteratorRecord,false )。
27.1.6.2.3 %AsyncFromSyncIteratorPrototype%.throw ( [ value ] )
- 令 O 为
this 值。 - 断言：O 是一个具有 [[SyncIteratorRecord]] 内部槽的 Object。
- 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 syncIteratorRecord 为 O.[[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]]。
- 执行 ! Call(promiseCapability.[[Reject]],
- 返回
AsyncFromSyncIteratorContinuation (result, promiseCapability, syncIteratorRecord,true )。
27.1.6.3 Async-from-Sync 迭代器实例的属性
Async-from-Sync 迭代器实例是从
| 内部槽 | 类型 | 描述 |
|---|---|---|
| [[SyncIteratorRecord]] |
an |
表示正在被适配的原始同步迭代器。 |
27.1.6.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 为一个新的具有参数 (v) 且捕获 done 的抽象闭包，调用时执行：
- 返回
CreateIteratorResultObject (v, done)。
- 返回
- 令 onFulfilled 为
CreateBuiltinFunction (unwrap, 1,"" , « »)。 - 注：onFulfilled 用于处理 IteratorResult 对象的
"value" 属性，以便在其值为 promise 时等待，并将结果重新打包为一个新的“解包后的” IteratorResult 对象。 - 若 done 为
true ，或 closeOnRejection 为false ，则- 令 onRejected 为
undefined 。
- 令 onRejected 为
- 否则，
- 令 closeIterator 为一个新的具有参数 (error) 且捕获 syncIteratorRecord 的抽象闭包，调用时执行：
- 返回 ?
IteratorClose (syncIteratorRecord,ThrowCompletion (error))。
- 返回 ?
- 令 onRejected 为
CreateBuiltinFunction (closeIterator, 1,"" , « »)。 - 注：onRejected 用于在其产生的 IteratorResult 对象的
"value" 属性为一个被拒绝的 promise 时关闭迭代器。
- 令 closeIterator 为一个新的具有参数 (error) 且捕获 syncIteratorRecord 的抽象闭包，调用时执行：
- 执行
PerformPromiseThen (valueWrapper, onFulfilled, onRejected, promiseCapability)。 - 返回 promiseCapability.[[Promise]]。
27.2 Promise 对象
Promise 是一个对象，用作延迟（且可能是异步）计算最终结果的占位符。
任一 Promise 处于三个互斥状态之一：fulfilled、rejected 和 pending：
-
当对一个 promise
p执行p.then(f, r)会立即入列一个调用函数f的 Job 时，p为 fulfilled。 -
当对一个 promise
p执行p.then(f, r)会立即入列一个调用函数r的 Job 时，p为 rejected。 - 当一个 promise 既不是 fulfilled 也不是 rejected 时，它是 pending。
若一个 promise 不是 pending（即已 fulfilled 或 rejected），则称其为 settled。
一个 promise 若已 settled 或被“锁定”与另一个 promise 的状态匹配，则称其为 resolved。试图 resolve 或 reject 一个已 resolved 的 promise 不产生任何效果。一个 promise 若未 resolved 则为 unresolved。未 resolved 的 promise 始终处于 pending 状态。一个已 resolved 的 promise 可能是 pending、fulfilled 或 rejected。
27.2.1 Promise 抽象操作
27.2.1.1 PromiseCapability 记录
PromiseCapability Record 是一个
PromiseCapability 记录具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Promise]] | 一个 Object | 可用作 promise 的对象。 |
| [[Resolve]] |
一个 |
用于 resolve 给定 promise 的函数。 |
| [[Reject]] |
一个 |
用于 reject 给定 promise 的函数。 |
27.2.1.1.1 IfAbruptRejectPromise ( value, capability )
IfAbruptRejectPromise 是一组使用
IfAbruptRejectPromise (value, capability)。
等价于：
- 断言：value 是一个
Completion Record 。 - 若 value 是一个 abrupt completion，则
- 执行 ? Call(capability.[[Reject]],
undefined , « value.[[Value]] »)。 - 返回 capability.[[Promise]]。
- 执行 ? Call(capability.[[Reject]],
- 否则，
- 设 value 为 ! value。
27.2.1.2 PromiseReaction 记录
PromiseReaction Record 是一个
PromiseReaction 记录具有
| 字段名 | 值 | 含义 |
|---|---|---|
| [[Capability]] |
一个 |
该记录为其提供 reaction 处理器的 promise 的能力集合。 |
| [[Type]] |
|
当 [[Handler]] 为 |
| [[Handler]] |
一个 |
应对传入值执行的函数，其返回值决定派生 promise 的后续行为。若 [[Handler]] 为 |
27.2.1.3 CreateResolvingFunctions ( promise )
The abstract operation CreateResolvingFunctions takes argument promise (a Promise) and returns 一个具有字段 [[Resolve]] (
- 令 alreadyResolved 为
Record { [[Value]]:false }。 - 令 stepsResolve 为
Promise Resolve 函数 中定义的算法步骤。 - 令 lengthResolve 为
Promise Resolve 函数 中函数定义的非可选参数数量。 - 令 resolve 为
CreateBuiltinFunction (stepsResolve, lengthResolve,"" , « [[Promise]], [[AlreadyResolved]] »)。 - 设 resolve.[[Promise]] 为 promise。
- 设 resolve.[[AlreadyResolved]] 为 alreadyResolved。
- 令 stepsReject 为
Promise Reject 函数 中定义的算法步骤。 - 令 lengthReject 为
Promise Reject 函数 中函数定义的非可选参数数量。 - 令 reject 为
CreateBuiltinFunction (stepsReject, lengthReject,"" , « [[Promise]], [[AlreadyResolved]] »)。 - 设 reject.[[Promise]] 为 promise。
- 设 reject.[[AlreadyResolved]] 为 alreadyResolved。
- 返回
Record { [[Resolve]]: resolve, [[Reject]]: reject }。
27.2.1.3.1 Promise Reject 函数
Promise reject 函数是一个匿名内置函数，具有 [[Promise]] 与 [[AlreadyResolved]] 内部槽。
当以参数 reason 调用一个 promise reject 函数时，执行以下步骤：
- 令 F 为活动
函数对象 。 - 断言：F 具有一个值为 Object 的 [[Promise]] 内部槽。
- 令 promise 为 F.[[Promise]]。
- 令 alreadyResolved 为 F.[[AlreadyResolved]]。
- 若 alreadyResolved.[[Value]] 为
true ，返回undefined 。 - 设 alreadyResolved.[[Value]] 为
true 。 - 执行
RejectPromise (promise, reason)。 - 返回
undefined 。
Promise reject 函数的
27.2.1.3.2 Promise Resolve 函数
Promise resolve 函数是一个匿名内置函数，具有 [[Promise]] 与 [[AlreadyResolved]] 内部槽。
当以参数 resolution 调用一个 promise resolve 函数时，执行以下步骤：
- 令 F 为活动
函数对象 。 - 断言：F 具有一个值为 Object 的 [[Promise]] 内部槽。
- 令 promise 为 F.[[Promise]]。
- 令 alreadyResolved 为 F.[[AlreadyResolved]]。
- 若 alreadyResolved.[[Value]] 为
true ，返回undefined 。 - 设 alreadyResolved.[[Value]] 为
true 。 - 若
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 。
Promise resolve 函数的
27.2.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.2.1.5 NewPromiseCapability ( C )
The abstract operation NewPromiseCapability takes argument C (an ECMAScript language value) and returns resolve 与 reject 函数。该 promise 及其 resolve 与 reject 函数用于初始化一个新的
- 若
IsConstructor (C) 为false ，抛出一个TypeError 异常。 - 注：假定 C 是一个支持 Promise
构造函数 参数约定的构造函数 （见27.2.3.1 ）。 - 令 resolvingFunctions 为
Record { [[Resolve]]:undefined , [[Reject]]:undefined }。 - 令 executorClosure 为一个具有参数 (resolve, reject) 且捕获 resolvingFunctions 的新抽象闭包，调用时执行：
- 若 resolvingFunctions.[[Resolve]] 不为
undefined ，抛出一个TypeError 异常。 - 若 resolvingFunctions.[[Reject]] 不为
undefined ，抛出一个TypeError 异常。 - 设 resolvingFunctions.[[Resolve]] 为 resolve。
- 设 resolvingFunctions.[[Reject]] 为 reject。
- 返回
NormalCompletion (undefined )。
- 若 resolvingFunctions.[[Resolve]] 不为
- 令 executor 为
CreateBuiltinFunction (executorClosure, 2,"" , « »)。 - 令 promise 为 ? Construct(C, « executor »)。
- 若
IsCallable (resolvingFunctions.[[Resolve]]) 为false ，抛出一个TypeError 异常。 - 若
IsCallable (resolvingFunctions.[[Reject]]) 为false ，抛出一个TypeError 异常。 - 返回
PromiseCapability Record { [[Promise]]: promise, [[Resolve]]: resolvingFunctions.[[Resolve]], [[Reject]]: resolvingFunctions.[[Reject]] }。
27.2.1.6 IsPromise ( x )
The abstract operation IsPromise takes argument x (an ECMAScript language value) and returns 一个 Boolean. 检查对象上是否具有 promise 品牌标记。 It performs the following steps when called:
- 若 x 不是一个 Object，返回
false 。 - 若 x 不具有 [[PromiseState]] 内部槽，返回
false 。 - 返回
true 。
27.2.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.2.1.8 TriggerPromiseReactions ( reactions, argument )
The abstract operation TriggerPromiseReactions takes arguments reactions (a
- 对于 reactions 的每个元素 reaction，执行
- 令 job 为
NewPromiseReactionJob (reaction, argument)。 - 执行
HostEnqueuePromiseJob (job.[[Job]], job.[[Realm]])。
- 令 job 为
- 返回
unused 。
27.2.1.9 HostPromiseRejectionTracker ( promise, operation )
The host-defined abstract operation HostPromiseRejectionTracker takes arguments promise (a Promise) and operation (
HostPromiseRejectionTracker 的默认实现是返回
HostPromiseRejectionTracker 在两种场景被调用：
- 当一个 promise 在没有任何处理器的情况下被拒绝时，以 operation 参数为
"reject" 调用。 - 当首次向一个已拒绝的 promise 添加处理器时，以 operation 参数为
"handle" 调用。
一个典型实现可能尝试通知开发者未处理的拒绝，同时在随后新处理器附加使先前通知失效时再次适当通知。
若 operation 为
27.2.2 Promise 作业
27.2.2.1 NewPromiseReactionJob ( reaction, argument )
The abstract operation NewPromiseReactionJob takes arguments reaction (一个
- 令 job 为一个无参数的新 Job 抽象闭包，捕获 reaction 和 argument，在被调用时执行下列步骤：
- 令 promiseCapability 为 reaction.[[Capability]]。
- 令 type 为 reaction.[[Type]]。
- 令 handler 为 reaction.[[Handler]]。
- 如果 handler 是
empty ，则- 如果 type 是
fulfill ，则- 令 handlerResult 为
NormalCompletion (argument)。
- 令 handlerResult 为
- 否则，
- 断言：type 是
reject 。 - 令 handlerResult 为
ThrowCompletion (argument)。
- 断言：type 是
- 如果 type 是
- 否则，
- 令 handlerResult 为
Completion (HostCallJobCallback (handler,undefined , « argument »))。
- 令 handlerResult 为
- 如果 promiseCapability 是
undefined ，则- 断言：handlerResult 不是一个 abrupt completion。
- 返回
empty 。
- 断言：promiseCapability 是一个
PromiseCapability Record 。 - 如果 handlerResult 是一个 abrupt completion，则
- 返回 ? Call(promiseCapability.[[Reject]],
undefined , « handlerResult.[[Value]] »)。
- 返回 ? Call(promiseCapability.[[Reject]],
- 否则，
- 返回 ? Call(promiseCapability.[[Resolve]],
undefined , « handlerResult.[[Value]] »)。
- 返回 ? Call(promiseCapability.[[Resolve]],
- 令 handlerRealm 为
null 。 - 如果 reaction.[[Handler]] 不为
empty ，则- 令 getHandlerRealmResult 为
Completion (GetFunctionRealm (reaction.[[Handler]].[[Callback]]))。 - 如果 getHandlerRealmResult 是一个 normal completion，则将 handlerRealm 设为 getHandlerRealmResult.[[Value]]。
- 否则，将 handlerRealm 设为
当前 Realm Record 。 - 注：除非处理器是
undefined ，否则 handlerRealm 永不为null 。当处理器是已撤销的 Proxy 且没有 ECMAScript 代码运行时，handlerRealm 用来创建错误对象。
- 令 getHandlerRealmResult 为
- 返回
Record { [[Job]]: job, [[Realm]]: handlerRealm }。
27.2.2.2 NewPromiseResolveThenableJob ( promiseToResolve, thenable, then )
The abstract operation NewPromiseResolveThenableJob takes arguments promiseToResolve (一个 Promise), thenable (一个 Object), and then (一个
- 令 job 为一个无参数的新 Job 抽象闭包，捕获 promiseToResolve, thenable, 以及 then，在被调用时执行下列步骤：
- 令 resolvingFunctions 为
CreateResolvingFunctions (promiseToResolve)。 - 令 thenCallResult 为
Completion (HostCallJobCallback (then, thenable, « resolvingFunctions.[[Resolve]], resolvingFunctions.[[Reject]] »))。 - 如果 thenCallResult 是一个 abrupt completion，则
- 返回 ? Call(resolvingFunctions.[[Reject]],
undefined , « thenCallResult.[[Value]] »)。
- 返回 ? Call(resolvingFunctions.[[Reject]],
- 返回 ! thenCallResult。
- 令 resolvingFunctions 为
- 令 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 }。
该作业使用提供的 thenable 及其 then 方法来 resolve 给定的 promise。此过程必须作为一个 Job 进行，以确保对 then 方法的求值发生在任意外围代码求值完成之后。
27.2.3 Promise 构造函数
Promise
- 是 %Promise%。
- 是全局对象
"Promise" 属性的初始值。 - 作为
构造函数 调用时创建并初始化一个新的 Promise。 - 不应作为普通函数调用，若以那种方式调用将抛出异常。
- 可用作类定义中
extends子句的值。意图继承指定 Promise 行为的子类构造函数 必须包含对 Promise构造函数 的super调用，以使用支持Promise和Promise.prototype内建方法所需的内部状态创建并初始化子类实例。
27.2.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 。 - 令 resolvingFunctions 为
CreateResolvingFunctions (promise)。 - 令 completion 为
Completion (Call(executor,undefined , « resolvingFunctions.[[Resolve]], resolvingFunctions.[[Reject]] »))。 - 如果 completion 是一个 abrupt completion，则
- 执行 ? Call(resolvingFunctions.[[Reject]],
undefined , « completion.[[Value]] »)。
- 执行 ? Call(resolvingFunctions.[[Reject]],
- 返回 promise。
executor 参数必须是一个
传给 executor 的 resolve 函数接受一个参数。executor 代码最终可以调用 resolve 来表示其希望 resolve 关联的 Promise。传给 resolve 的参数表示延迟动作的最终值，可以是实际的 fulfill 值，也可以是另一个在 fulfill 后提供该值的 promise。
传给 executor 的 reject 函数接受一个参数。executor 代码最终可以调用 reject 来表示关联的 Promise 已被 reject 且永不会 fulfill。传给 reject 的参数用作该 promise 的拒绝值。典型情况下它将是一个 Error 对象。
Promise
27.2.4 Promise 构造函数的属性
Promise
- 有一个 [[Prototype]] 内部槽，其值为
%Function.prototype% 。 - 具有以下属性：
27.2.4.1 Promise.all ( iterable )
该函数返回一个新的 promise：若传入的各个 promise 全部 fulfill，则以其 fulfill 值数组进行 fulfill；若其中第一个 reject，则以该 reject 原因进行 reject。它在运行本算法时会将传入可迭代对象的所有元素解析为 promise。
- 令 C 为
this 值。 - 令 promiseCapability 为 ?
NewPromiseCapability (C)。 - 令 promiseResolve 为
Completion (GetPromiseResolve (C))。 IfAbruptRejectPromise (promiseResolve, promiseCapability)。- 令 iteratorRecord 为
Completion (GetIterator (iterable,sync ))。 IfAbruptRejectPromise (iteratorRecord, promiseCapability)。- 令 result 为
Completion (PerformPromiseAll (iteratorRecord, C, promiseCapability, promiseResolve))。 - 如果 result 是一个 abrupt completion，则
- 如果 iteratorRecord.[[Done]] 是
false ，将 result 设为Completion (IteratorClose (iteratorRecord, result))。 IfAbruptRejectPromise (result, promiseCapability)。
- 如果 iteratorRecord.[[Done]] 是
- 返回 ! result。
27.2.4.1.1 GetPromiseResolve ( promiseConstructor )
The abstract operation GetPromiseResolve takes argument promiseConstructor (一个 constructor) and returns 要么是包含一个
- 令 promiseResolve 为 ?
Get (promiseConstructor,"resolve" )。 - 如果
IsCallable (promiseResolve) 是false ，抛出TypeError 异常。 - 返回 promiseResolve。
27.2.4.1.2 PerformPromiseAll ( iteratorRecord, constructor, resultCapability, promiseResolve )
The abstract operation PerformPromiseAll takes arguments iteratorRecord (一个
- 令 values 为一个新的空
List 。 - 令 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, constructor, « next »)。
- 令 steps 为
Promise.allResolve 元素函数 - 令 length 为
Promise.allResolve 元素函数 - 令 onFulfilled 为
CreateBuiltinFunction (steps, length,"" , « [[AlreadyCalled]], [[Index]], [[Values]], [[Capability]], [[RemainingElements]] »)。 - 将 onFulfilled.[[AlreadyCalled]] 设为
false 。 - 将 onFulfilled.[[Index]] 设为 index。
- 将 onFulfilled.[[Values]] 设为 values。
- 将 onFulfilled.[[Capability]] 设为 resultCapability。
- 将 onFulfilled.[[RemainingElements]] 设为 remainingElementsCount。
- 将 remainingElementsCount.[[Value]] 设为 remainingElementsCount.[[Value]] + 1。
- 执行 ? Invoke(nextPromise,
"then" , « onFulfilled, resultCapability.[[Reject]] »)。 - 将 index 设为 index + 1。
- 令 next 为 ?
27.2.4.1.3 Promise.all Resolve 元素函数
Promise.all resolve 元素函数是一个匿名内建函数，用于 resolve 某个特定的 Promise.all 元素。每个此类函数具有 [[Index]]、[[Values]]、[[Capability]]、[[RemainingElements]] 和 [[AlreadyCalled]] 内部槽。
当一个 Promise.all resolve 元素函数以参数 x 被调用时，执行下列步骤：
- 令 F 为活动
函数对象 。 - 如果 F.[[AlreadyCalled]] 是
true ，返回undefined 。 - 将 F.[[AlreadyCalled]] 设为
true 。 - 令 index 为 F.[[Index]]。
- 令 values 为 F.[[Values]]。
- 令 promiseCapability 为 F.[[Capability]]。
- 令 remainingElementsCount 为 F.[[RemainingElements]]。
- 将 values[index] 设为 x。
- 将 remainingElementsCount.[[Value]] 设为 remainingElementsCount.[[Value]] - 1。
- 如果 remainingElementsCount.[[Value]] = 0，则
- 令 valuesArray 为
CreateArrayFromList (values)。 - 返回 ? Call(promiseCapability.[[Resolve]],
undefined , « valuesArray »)。
- 令 valuesArray 为
- 返回
undefined 。
Promise.all resolve 元素函数的
27.2.4.2 Promise.allSettled ( iterable )
该函数返回一个 promise，当所有原始 promise 均已 settle（即变为 fulfilled 或 rejected）后，以包含 promise 状态快照的数组 fulfill。它在运行本算法时将传入可迭代对象的所有元素解析为 promise。
- 令 C 为
this 值。 - 令 promiseCapability 为 ?
NewPromiseCapability (C)。 - 令 promiseResolve 为
Completion (GetPromiseResolve (C))。 IfAbruptRejectPromise (promiseResolve, promiseCapability)。- 令 iteratorRecord 为
Completion (GetIterator (iterable,sync ))。 IfAbruptRejectPromise (iteratorRecord, promiseCapability)。- 令 result 为
Completion (PerformPromiseAllSettled (iteratorRecord, C, promiseCapability, promiseResolve))。 - 如果 result 是一个 abrupt completion，则
- 如果 iteratorRecord.[[Done]] 是
false ，将 result 设为Completion (IteratorClose (iteratorRecord, result))。 IfAbruptRejectPromise (result, promiseCapability)。
- 如果 iteratorRecord.[[Done]] 是
- 返回 ! result。
27.2.4.2.1 PerformPromiseAllSettled ( iteratorRecord, constructor, resultCapability, promiseResolve )
The abstract operation PerformPromiseAllSettled takes arguments iteratorRecord (一个
- 令 values 为一个新的空
List 。 - 令 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, constructor, « next »)。
- 令 stepsFulfilled 为
Promise.allSettledResolve 元素函数 - 令 lengthFulfilled 为
Promise.allSettledResolve 元素函数 - 令 onFulfilled 为
CreateBuiltinFunction (stepsFulfilled, lengthFulfilled,"" , « [[AlreadyCalled]], [[Index]], [[Values]], [[Capability]], [[RemainingElements]] »)。 - 令 alreadyCalled 为
Record { [[Value]]:false }。 - 将 onFulfilled.[[AlreadyCalled]] 设为 alreadyCalled。
- 将 onFulfilled.[[Index]] 设为 index。
- 将 onFulfilled.[[Values]] 设为 values。
- 将 onFulfilled.[[Capability]] 设为 resultCapability。
- 将 onFulfilled.[[RemainingElements]] 设为 remainingElementsCount。
- 令 stepsRejected 为
Promise.allSettledReject 元素函数 - 令 lengthRejected 为
Promise.allSettledReject 元素函数 - 令 onRejected 为
CreateBuiltinFunction (stepsRejected, lengthRejected,"" , « [[AlreadyCalled]], [[Index]], [[Values]], [[Capability]], [[RemainingElements]] »)。 - 将 onRejected.[[AlreadyCalled]] 设为 alreadyCalled。
- 将 onRejected.[[Index]] 设为 index。
- 将 onRejected.[[Values]] 设为 values。
- 将 onRejected.[[Capability]] 设为 resultCapability。
- 将 onRejected.[[RemainingElements]] 设为 remainingElementsCount。
- 将 remainingElementsCount.[[Value]] 设为 remainingElementsCount.[[Value]] + 1。
- 执行 ? Invoke(nextPromise,
"then" , « onFulfilled, onRejected »)。 - 将 index 设为 index + 1。
- 令 next 为 ?
27.2.4.2.2 Promise.allSettled Resolve 元素函数
Promise.allSettled resolve 元素函数是一个匿名内建函数，用于 resolve 某个特定的 Promise.allSettled 元素。每个此类函数具有 [[Index]]、[[Values]]、[[Capability]]、[[RemainingElements]] 和 [[AlreadyCalled]] 内部槽。
当一个 Promise.allSettled resolve 元素函数以参数 x 被调用时，执行下列步骤：
- 令 F 为活动
函数对象 。 - 令 alreadyCalled 为 F.[[AlreadyCalled]]。
- 如果 alreadyCalled.[[Value]] 是
true ，返回undefined 。 - 将 alreadyCalled.[[Value]] 设为
true 。 - 令 index 为 F.[[Index]]。
- 令 values 为 F.[[Values]]。
- 令 promiseCapability 为 F.[[Capability]]。
- 令 remainingElementsCount 为 F.[[RemainingElements]]。
- 令 obj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 !
CreateDataPropertyOrThrow (obj,"status" ,"fulfilled" )。 - 执行 !
CreateDataPropertyOrThrow (obj,"value" , x)。 - 将 values[index] 设为 obj。
- 将 remainingElementsCount.[[Value]] 设为 remainingElementsCount.[[Value]] - 1。
- 如果 remainingElementsCount.[[Value]] = 0，则
- 令 valuesArray 为
CreateArrayFromList (values)。 - 返回 ? Call(promiseCapability.[[Resolve]],
undefined , « valuesArray »)。
- 令 valuesArray 为
- 返回
undefined 。
Promise.allSettled resolve 元素函数的
27.2.4.2.3 Promise.allSettled Reject 元素函数
Promise.allSettled reject 元素函数是一个匿名内建函数，用于 reject 某个特定的 Promise.allSettled 元素。每个此类函数具有 [[Index]]、[[Values]]、[[Capability]]、[[RemainingElements]] 和 [[AlreadyCalled]] 内部槽。
当一个 Promise.allSettled reject 元素函数以参数 x 被调用时，执行下列步骤：
- 令 F 为活动
函数对象 。 - 令 alreadyCalled 为 F.[[AlreadyCalled]]。
- 如果 alreadyCalled.[[Value]] 是
true ，返回undefined 。 - 将 alreadyCalled.[[Value]] 设为
true 。 - 令 index 为 F.[[Index]]。
- 令 values 为 F.[[Values]]。
- 令 promiseCapability 为 F.[[Capability]]。
- 令 remainingElementsCount 为 F.[[RemainingElements]]。
- 令 obj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 !
CreateDataPropertyOrThrow (obj,"status" ,"rejected" )。 - 执行 !
CreateDataPropertyOrThrow (obj,"reason" , x)。 - 将 values[index] 设为 obj。
- 将 remainingElementsCount.[[Value]] 设为 remainingElementsCount.[[Value]] - 1。
- 如果 remainingElementsCount.[[Value]] = 0，则
- 令 valuesArray 为
CreateArrayFromList (values)。 - 返回 ? Call(promiseCapability.[[Resolve]],
undefined , « valuesArray »)。
- 令 valuesArray 为
- 返回
undefined 。
Promise.allSettled reject 元素函数的
27.2.4.3 Promise.any ( iterable )
该函数返回一个 promise：由第一个 fulfill 的输入 promise 来 fulfill；如果所有输入 promise 均被 reject，则以一个包含所有拒绝原因的 AggregateError 进行 reject。它在运行本算法时将传入可迭代对象的所有元素解析为 promise。
- 令 C 为
this 值。 - 令 promiseCapability 为 ?
NewPromiseCapability (C)。 - 令 promiseResolve 为
Completion (GetPromiseResolve (C))。 IfAbruptRejectPromise (promiseResolve, promiseCapability)。- 令 iteratorRecord 为
Completion (GetIterator (iterable,sync ))。 IfAbruptRejectPromise (iteratorRecord, promiseCapability)。- 令 result 为
Completion (PerformPromiseAny (iteratorRecord, C, promiseCapability, promiseResolve))。 - 如果 result 是一个 abrupt completion，则
- 如果 iteratorRecord.[[Done]] 是
false ，将 result 设为Completion (IteratorClose (iteratorRecord, result))。 IfAbruptRejectPromise (result, promiseCapability)。
- 如果 iteratorRecord.[[Done]] 是
- 返回 ! result。
27.2.4.3.1 PerformPromiseAny ( iteratorRecord, constructor, resultCapability, promiseResolve )
The abstract operation PerformPromiseAny takes arguments iteratorRecord (一个
- 令 errors 为一个新的空
List 。 - 令 remainingElementsCount 为
Record { [[Value]]: 1 }。 - 令 index 为 0。
- 重复，
- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 是
done ，则- 将 remainingElementsCount.[[Value]] 设为 remainingElementsCount.[[Value]] - 1。
- 如果 remainingElementsCount.[[Value]] = 0，则
- 令 error 为一个新创建的
AggregateError 对象。 - 执行 !
DefinePropertyOrThrow (error,"errors" , PropertyDescriptor { [[Configurable]]:true , [[Enumerable]]:false , [[Writable]]:true , [[Value]]:CreateArrayFromList (errors) })。 - 返回
ThrowCompletion (error)。
- 令 error 为一个新创建的
- 返回 resultCapability.[[Promise]]。
- 将
undefined 追加到 errors。 - 令 nextPromise 为 ? Call(promiseResolve, constructor, « next »)。
- 令 stepsRejected 为
Promise.anyReject 元素函数 - 令 lengthRejected 为
Promise.anyReject 元素函数 - 令 onRejected 为
CreateBuiltinFunction (stepsRejected, lengthRejected,"" , « [[AlreadyCalled]], [[Index]], [[Errors]], [[Capability]], [[RemainingElements]] »)。 - 将 onRejected.[[AlreadyCalled]] 设为
false 。 - 将 onRejected.[[Index]] 设为 index。
- 将 onRejected.[[Errors]] 设为 errors。
- 将 onRejected.[[Capability]] 设为 resultCapability。
- 将 onRejected.[[RemainingElements]] 设为 remainingElementsCount。
- 将 remainingElementsCount.[[Value]] 设为 remainingElementsCount.[[Value]] + 1。
- 执行 ? Invoke(nextPromise,
"then" , « resultCapability.[[Resolve]], onRejected »)。 - 将 index 设为 index + 1。
- 令 next 为 ?
27.2.4.3.2 Promise.any Reject 元素函数
Promise.any reject 元素函数是一个匿名内建函数，用于 reject 某个特定的 Promise.any 元素。每个此类函数具有 [[Index]]、[[Errors]]、[[Capability]]、[[RemainingElements]] 和 [[AlreadyCalled]] 内部槽。
当一个 Promise.any reject 元素函数以参数 x 被调用时，执行下列步骤：
- 令 F 为活动
函数对象 。 - 如果 F.[[AlreadyCalled]] 是
true ，返回undefined 。 - 将 F.[[AlreadyCalled]] 设为
true 。 - 令 index 为 F.[[Index]]。
- 令 errors 为 F.[[Errors]]。
- 令 promiseCapability 为 F.[[Capability]]。
- 令 remainingElementsCount 为 F.[[RemainingElements]]。
- 将 errors[index] 设为 x。
- 将 remainingElementsCount.[[Value]] 设为 remainingElementsCount.[[Value]] - 1。
- 如果 remainingElementsCount.[[Value]] = 0，则
- 令 error 为一个新创建的
AggregateError 对象。 - 执行 !
DefinePropertyOrThrow (error,"errors" , PropertyDescriptor { [[Configurable]]:true , [[Enumerable]]:false , [[Writable]]:true , [[Value]]:CreateArrayFromList (errors) })。 - 返回 ? Call(promiseCapability.[[Reject]],
undefined , « error »)。
- 令 error 为一个新创建的
- 返回
undefined 。
Promise.any reject 元素函数的
27.2.4.4 Promise.prototype
Promise.prototype 的初始值是
该属性具有 { [[Writable]]:
27.2.4.5 Promise.race ( iterable )
该函数返回一个新的 promise，其 settle 方式与第一个 settle 的传入 promise 相同。它在运行本算法时将传入的 iterable 的所有元素解析为 promise。
- 令 C 为
this 值。 - 令 promiseCapability 为 ?
NewPromiseCapability (C)。 - 令 promiseResolve 为
Completion (GetPromiseResolve (C))。 IfAbruptRejectPromise (promiseResolve, promiseCapability)。- 令 iteratorRecord 为
Completion (GetIterator (iterable,sync ))。 IfAbruptRejectPromise (iteratorRecord, promiseCapability)。- 令 result 为
Completion (PerformPromiseRace (iteratorRecord, C, promiseCapability, promiseResolve))。 - 如果 result 是一个 abrupt completion，则
- 如果 iteratorRecord.[[Done]] 是
false ，将 result 设为Completion (IteratorClose (iteratorRecord, result))。 IfAbruptRejectPromise (result, promiseCapability)。
- 如果 iteratorRecord.[[Done]] 是
- 返回 ! result。
如果 iterable 参数不产生任何值，或其产生的 promise 都永不 settle，则此方法返回的挂起 promise 将永不 settle。
27.2.4.5.1 PerformPromiseRace ( iteratorRecord, constructor, resultCapability, promiseResolve )
The abstract operation PerformPromiseRace takes arguments iteratorRecord (一个
- 重复，
- 令 next 为 ?
IteratorStepValue (iteratorRecord)。 - 如果 next 是
done ，则- 返回 resultCapability.[[Promise]]。
- 令 nextPromise 为 ? Call(promiseResolve, constructor, « next »)。
- 执行 ? Invoke(nextPromise,
"then" , « resultCapability.[[Resolve]], resultCapability.[[Reject]] »)。
- 令 next 为 ?
27.2.4.6 Promise.reject ( r )
该函数返回一个以传入参数为拒绝原因而被 reject 的新 promise。
- 令 C 为
this 值。 - 令 promiseCapability 为 ?
NewPromiseCapability (C)。 - 执行 ? Call(promiseCapability.[[Reject]],
undefined , « r »)。 - 返回 promiseCapability.[[Promise]]。
27.2.4.7 Promise.resolve ( x )
该函数要么返回一个以传入参数 resolve 的新 promise，要么若该参数本身是由此
- 令 C 为
this 值。 - 如果 C 不是一个 Object，抛出
TypeError 异常。 - 返回 ?
PromiseResolve (C, x)。
27.2.4.7.1 PromiseResolve ( C, x )
The abstract operation PromiseResolve takes arguments C (一个 Object) and x (一个
- 如果
IsPromise (x) 是true ，则 - 令 promiseCapability 为 ?
NewPromiseCapability (C)。 - 执行 ? Call(promiseCapability.[[Resolve]],
undefined , « x »)。 - 返回 promiseCapability.[[Promise]]。
27.2.4.8 Promise.try ( callback, ...args )
该函数在被调用时执行下列步骤：
- 令 C 为
this 值。 - 如果 C 不是一个 Object，抛出
TypeError 异常。 - 令 promiseCapability 为 ?
NewPromiseCapability (C)。 - 令 status 为
Completion (Call(callback,undefined , args))。 - 如果 status 是一个 abrupt completion，则
- 执行 ? Call(promiseCapability.[[Reject]],
undefined , « status.[[Value]] »)。
- 执行 ? Call(promiseCapability.[[Reject]],
- 否则，
- 执行 ? Call(promiseCapability.[[Resolve]],
undefined , « status.[[Value]] »)。
- 执行 ? Call(promiseCapability.[[Resolve]],
- 返回 promiseCapability.[[Promise]]。
27.2.4.9 Promise.withResolvers ( )
该函数返回一个具有三个属性的对象：一个新 promise 以及与之关联的 resolve 和 reject 函数。
- 令 C 为
this 值。 - 令 promiseCapability 为 ?
NewPromiseCapability (C)。 - 令 obj 为
OrdinaryObjectCreate (%Object.prototype% )。 - 执行 !
CreateDataPropertyOrThrow (obj,"promise" , promiseCapability.[[Promise]])。 - 执行 !
CreateDataPropertyOrThrow (obj,"resolve" , promiseCapability.[[Resolve]])。 - 执行 !
CreateDataPropertyOrThrow (obj,"reject" , promiseCapability.[[Reject]])。 - 返回 obj。
27.2.4.10 get Promise [ %Symbol.species% ]
Promise[%Symbol.species%] 是一个
- 返回
this 值。
该函数的
Promise 原型方法通常使用其
27.2.5 Promise 原型对象的属性
Promise 原型对象：
- 是 %Promise.prototype%。
- 有一个 [[Prototype]] 内部槽，其值为
%Object.prototype% 。 - 是一个
普通对象 。 - 不具有 [[PromiseState]] 内部槽，也不具有 Promise 实例的其他任何内部槽。
27.2.5.1 Promise.prototype.catch ( onRejected )
该方法被调用时执行以下步骤：
- 令 promise 为
this 值。 - 返回 ? Invoke(promise,
"then" , «undefined , onRejected »)。
27.2.5.2 Promise.prototype.constructor
Promise.prototype.constructor 的初始值是
27.2.5.3 Promise.prototype.finally ( onFinally )
该方法被调用时执行以下步骤：
- 令 promise 为
this 值。 - 如果 promise 不是一个 Object，抛出
TypeError 异常。 - 令 C 为 ?
SpeciesConstructor (promise,%Promise% )。 - 断言：
IsConstructor (C) 为true 。 - 如果
IsCallable (onFinally) 为false ，则- 令 thenFinally 为 onFinally。
- 令 catchFinally 为 onFinally。
- 否则，
- 令 thenFinallyClosure 为一个具有参数 (value) 的新抽象闭包，捕获 onFinally 与 C，在被调用时执行以下步骤：
- 令 result 为 ? Call(onFinally,
undefined )。 - 令 p 为 ?
PromiseResolve (C, result)。 - 令 returnValue 为一个无参数的新抽象闭包，捕获 value 并在被调用时执行以下步骤：
- 返回
NormalCompletion (value)。
- 返回
- 令 valueThunk 为
CreateBuiltinFunction (returnValue, 0,"" , « »)。 - 返回 ? Invoke(p,
"then" , « valueThunk »)。
- 令 result 为 ? Call(onFinally,
- 令 thenFinally 为
CreateBuiltinFunction (thenFinallyClosure, 1,"" , « »)。 - 令 catchFinallyClosure 为一个具有参数 (reason) 的新抽象闭包，捕获 onFinally 与 C，在被调用时执行以下步骤：
- 令 result 为 ? Call(onFinally,
undefined )。 - 令 p 为 ?
PromiseResolve (C, result)。 - 令 throwReason 为一个无参数的新抽象闭包，捕获 reason 并在被调用时执行以下步骤：
- 返回
ThrowCompletion (reason)。
- 返回
- 令 thrower 为
CreateBuiltinFunction (throwReason, 0,"" , « »)。 - 返回 ? Invoke(p,
"then" , « thrower »)。
- 令 result 为 ? Call(onFinally,
- 令 catchFinally 为
CreateBuiltinFunction (catchFinallyClosure, 1,"" , « »)。
- 令 thenFinallyClosure 为一个具有参数 (value) 的新抽象闭包，捕获 onFinally 与 C，在被调用时执行以下步骤：
- 返回 ? Invoke(promise,
"then" , « thenFinally, catchFinally »)。
27.2.5.4 Promise.prototype.then ( onFulfilled, onRejected )
该方法被调用时执行以下步骤：
- 令 promise 为
this 值。 - 如果
IsPromise (promise) 为false ，抛出TypeError 异常。 - 令 C 为 ?
SpeciesConstructor (promise,%Promise% )。 - 令 resultCapability 为 ?
NewPromiseCapability (C)。 - 返回
PerformPromiseThen (promise, onFulfilled, onRejected, resultCapability)。
27.2.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.2.5.5 Promise.prototype [ %Symbol.toStringTag% ]
该属性具有 { [[Writable]]:
27.2.6 Promise 实例的属性
Promise 实例是
| 内部槽 | 类型 | 描述 |
|---|---|---|
| [[PromiseState]] |
|
决定该 promise 对其 then 方法的传入调用如何作出反应。
|
| [[PromiseResult]] |
一个 |
promise 被 fulfill 或 reject 时的值（若有）。当且仅当 [[PromiseState]] 为 |
| [[PromiseFulfillReactions]] |
一个 |
当（如果）promise 从 |
| [[PromiseRejectReactions]] |
一个 |
当（如果）promise 从 |
| [[PromiseIsHandled]] | 一个 Boolean | 指示该 promise 是否曾拥有过 fulfill 或 reject 处理器；用于未处理拒绝的跟踪。 |
27.3 GeneratorFunction 对象
GeneratorFunction 是通常通过求值
27.3.1 GeneratorFunction 构造函数
GeneratorFunction
- 是 %GeneratorFunction%。
- 是
Function的子类。 - 当以函数（而非
构造函数 ）方式调用时创建并初始化一个新的 GeneratorFunction。故函数调用GeneratorFunction (…)等价于以相同参数的对象创建表达式new GeneratorFunction (…)。 - 可用作类定义中
extends子句的值。意图继承指定 GeneratorFunction 行为的子类构造函数 必须包含对 GeneratorFunction构造函数 的super调用，以创建并初始化带有内建 GeneratorFunction 行为所需内部槽的子类实例。所有用于定义 generator函数对象 的 ECMAScript 语法形式都会创建 GeneratorFunction 的直接实例。没有语法手段创建 GeneratorFunction 子类的实例。
27.3.1.1 GeneratorFunction ( ...parameterArgs, bodyArg )
最后一个参数（如果存在）指定生成器函数的函数体（可执行代码）；之前的任意参数指定形式参数。
该函数被调用时执行以下步骤：
- 令 C 为活动
函数对象 。 - 如果 bodyArg 不存在，将 bodyArg 设为空字符串。
- 返回 ?
CreateDynamicFunction (C, NewTarget,generator , parameterArgs, bodyArg)。
参见
27.3.2 GeneratorFunction 构造函数的属性
GeneratorFunction
- 是一个继承自 Function
构造函数 的标准内建函数对象 。 - 具有值为
%Function% 的 [[Prototype]] 内部槽。 - 具有值为
1 𝔽 的"length" 属性。 - 具有值为
"GeneratorFunction" 的"name" 属性。 - 具有以下属性：
27.3.2.1 GeneratorFunction.prototype
GeneratorFunction.prototype 的初始值是
该属性具有 { [[Writable]]:
27.3.3 GeneratorFunction 原型对象的属性
GeneratorFunction 原型对象：
- 是 %GeneratorFunction.prototype%（见
Figure 6 ）。 - 是一个
普通对象 。 - 不是
函数对象 ，且没有 [[ECMAScriptCode]] 内部槽，也没有Table 28 或Table 91 中列出的任何其他内部槽。 - 具有值为
%Function.prototype% 的 [[Prototype]] 内部槽。
27.3.3.1 GeneratorFunction.prototype.constructor
GeneratorFunction.prototype.constructor 的初始值是
该属性具有 { [[Writable]]:
27.3.3.2 GeneratorFunction.prototype.prototype
GeneratorFunction.prototype.prototype 的初始值是
该属性具有 { [[Writable]]:
27.3.3.3 GeneratorFunction.prototype [ %Symbol.toStringTag% ]
该属性具有 { [[Writable]]:
27.3.4 GeneratorFunction 实例
每个 GeneratorFunction 实例都是一个 ECMAScript
每个 GeneratorFunction 实例具有以下自有属性：
27.3.4.1 length
27.3.4.2 name
27.3.4.3 prototype
每当创建一个 GeneratorFunction 实例时，也会创建另一个
该属性具有 { [[Writable]]:
不同于 Function 实例，GeneratorFunction 的
27.4 AsyncGeneratorFunction 对象
AsyncGeneratorFunction 是通常通过求值
27.4.1 AsyncGeneratorFunction 构造函数
AsyncGeneratorFunction
- 是 %AsyncGeneratorFunction%。
- 是
Function的子类。 - 当以函数（而非
构造函数 ）方式调用时创建并初始化一个新的 AsyncGeneratorFunction。故函数调用AsyncGeneratorFunction (...)等价于以相同参数的对象创建表达式new AsyncGeneratorFunction (...)。 - 可用作类定义中
extends子句的值。意图继承指定 AsyncGeneratorFunction 行为的子类构造函数 必须包含对 AsyncGeneratorFunction构造函数 的super调用，以创建并初始化带有内建 AsyncGeneratorFunction 行为所需内部槽的子类实例。所有用于定义 async generator函数对象 的 ECMAScript 语法形式都会创建 AsyncGeneratorFunction 的直接实例。没有语法手段创建 AsyncGeneratorFunction 子类的实例。
27.4.1.1 AsyncGeneratorFunction ( ...parameterArgs, bodyArg )
最后一个参数（如果存在）指定异步生成器函数的函数体（可执行代码）；之前的任意参数指定形式参数。
该函数被调用时执行以下步骤：
- 令 C 为活动
函数对象 。 - 如果 bodyArg 不存在，将 bodyArg 设为空字符串。
- 返回 ?
CreateDynamicFunction (C, NewTarget,async-generator , parameterArgs, bodyArg)。
参见
27.4.2 AsyncGeneratorFunction 构造函数的属性
AsyncGeneratorFunction
- 是一个继承自 Function
构造函数 的标准内建函数对象 。 - 具有值为
%Function% 的 [[Prototype]] 内部槽。 - 具有值为
1 𝔽 的"length" 属性。 - 具有值为
"AsyncGeneratorFunction" 的"name" 属性。 - 具有以下属性：
27.4.2.1 AsyncGeneratorFunction.prototype
AsyncGeneratorFunction.prototype 的初始值是
该属性具有 { [[Writable]]:
27.4.3 AsyncGeneratorFunction 原型对象的属性
AsyncGeneratorFunction 原型对象：
- 是 %AsyncGeneratorFunction.prototype%。
- 是一个
普通对象 。 - 不是
函数对象 ，且没有 [[ECMAScriptCode]] 内部槽，也没有Table 28 或Table 92 中列出的任何其他内部槽。 - 具有值为
%Function.prototype% 的 [[Prototype]] 内部槽。
27.4.3.1 AsyncGeneratorFunction.prototype.constructor
AsyncGeneratorFunction.prototype.constructor 的初始值是
该属性具有 { [[Writable]]:
27.4.3.2 AsyncGeneratorFunction.prototype.prototype
AsyncGeneratorFunction.prototype.prototype 的初始值是
该属性具有 { [[Writable]]:
27.4.3.3 AsyncGeneratorFunction.prototype [ %Symbol.toStringTag% ]
该属性具有 { [[Writable]]:
27.4.4 AsyncGeneratorFunction 实例
每个 AsyncGeneratorFunction 实例都是一个 ECMAScript
每个 AsyncGeneratorFunction 实例具有以下自有属性：
27.4.4.1 length
该属性具有 { [[Writable]]:
27.4.4.2 name
27.4.4.3 prototype
每当创建一个 AsyncGeneratorFunction 实例时，也会创建另一个
该属性具有 { [[Writable]]:
不同于函数实例，AsyncGeneratorFunction 的
27.5 Generator 对象
Generator 通过调用一个生成器函数创建，并符合迭代器接口与可迭代接口。
Generator 实例直接从创建该实例的生成器函数
27.5.1 %GeneratorPrototype% 对象
%GeneratorPrototype% 对象：
- 是 %GeneratorFunction.prototype.prototype%。
- 是一个
普通对象 。 - 不是一个 Generator 实例，且没有 [[GeneratorState]] 内部槽。
- 具有值为
%Iterator.prototype% 的 [[Prototype]] 内部槽。 - 具有被所有 Generator 实例间接继承的属性。
27.5.1.1 %GeneratorPrototype%.constructor
.constructor 的初始值是
该属性具有 { [[Writable]]:
27.5.1.2 %GeneratorPrototype%.next ( value )
- 返回 ?
GeneratorResume (this value, value,empty )。
27.5.1.3 %GeneratorPrototype%.return ( value )
该方法被调用时执行以下步骤：
- 令 g 为
this 值。 - 令 C 为
ReturnCompletion (value)。 - 返回 ?
GeneratorResumeAbrupt (g, C,empty )。
27.5.1.4 %GeneratorPrototype%.throw ( exception )
该方法被调用时执行以下步骤：
- 令 g 为
this 值。 - 令 C 为
ThrowCompletion (exception)。 - 返回 ?
GeneratorResumeAbrupt (g, C,empty )。
27.5.1.5 %GeneratorPrototype% [ %Symbol.toStringTag% ]
该属性具有 { [[Writable]]:
27.5.2 Generator 实例的属性
Generator 实例最初按
| 内部槽 | 类型 | 描述 |
|---|---|---|
| [[GeneratorState]] |
|
该生成器的当前执行状态。 |
| [[GeneratorContext]] | 一个执行上下文 | 执行该生成器代码时使用的执行上下文。 |
| [[GeneratorBrand]] |
一个 String 或 |
用于区分不同种类生成器的标记。由 ECMAScript 源文本声明的生成器的 [[GeneratorBrand]] 始终为 |
27.5.3 Generator 抽象操作
27.5.3.1 GeneratorStart ( generator, generatorBody )
The abstract operation GeneratorStart takes arguments generator (a Generator) and generatorBody (a
- 断言：generator.[[GeneratorState]] 是
suspended-start 。 - 令 genContext 为正在运行的执行上下文。
- 将 genContext 的 Generator 组件设为 generator。
- 令 closure 为一个无参数的新抽象闭包，捕获 generatorBody 并在被调用时执行以下步骤：
- 令 acGenContext 为正在运行的执行上下文。
- 令 acGenerator 为 acGenContext 的 Generator 组件。
- 如果 generatorBody 是一个 Parse Node，则
- 令 result 为
Completion (Evaluation of generatorBody)。
- 令 result 为
- 否则，
- 断言：generatorBody 是一个无参数抽象闭包。
- 令 result 为
Completion (generatorBody())。
- 断言：若我们在此返回，生成器要么抛出了异常，要么执行了隐式或显式的 return。
- 将 acGenContext 从执行上下文栈移除，并恢复栈顶执行上下文为正在运行的执行上下文。
- 将 acGenerator.[[GeneratorState]] 设为
completed 。 - 注：一旦生成器进入
completed 状态，它将不再离开该状态，其关联执行上下文不再恢复。此时可丢弃与 acGenerator 相关的任意执行状态。 - 如果 result 是一个 normal completion，则
- 令 resultValue 为
undefined 。
- 令 resultValue 为
- 否则如果 result 是一个 return completion，则
- 令 resultValue 为 result.[[Value]]。
- 否则，
- 断言：result 是一个 throw completion。
- 返回 ? result。
- 返回
NormalCompletion (CreateIteratorResultObject (resultValue,true ))。
- 设定 genContext 的代码求值状态，使得当该执行上下文恢复求值时，将无参数调用 closure。
- 将 generator.[[GeneratorContext]] 设为 genContext。
- 返回
unused 。
27.5.3.2 GeneratorValidate ( generator, generatorBrand )
The abstract operation GeneratorValidate takes arguments generator (an ECMAScript language value) and generatorBrand (a String or
- 执行 ?
RequireInternalSlot (generator, [[GeneratorState]])。 - 执行 ?
RequireInternalSlot (generator, [[GeneratorBrand]])。 - 如果 generator.[[GeneratorBrand]] 不等于 generatorBrand，抛出
TypeError 异常。 - 断言：generator 也有 [[GeneratorContext]] 内部槽。
- 令 state 为 generator.[[GeneratorState]]。
- 如果 state 是
executing ，抛出TypeError 异常。 - 返回 state。
27.5.3.3 GeneratorResume ( generator, value, generatorBrand )
The abstract operation GeneratorResume takes arguments generator (an ECMAScript language value), value (an ECMAScript language value or
- 令 state 为 ?
GeneratorValidate (generator, generatorBrand)。 - 如果 state 是
completed ，返回CreateIteratorResultObject (undefined ,true )。 - 断言：state 是
suspended-start 或suspended-yield 。 - 令 genContext 为 generator.[[GeneratorContext]]。
- 令 methodContext 为正在运行的执行上下文。
- 挂起 methodContext。
- 将 generator.[[GeneratorState]] 设为
executing 。 - 将 genContext 压入执行上下文栈；genContext 现在是正在运行的执行上下文。
- 恢复 genContext 的挂起求值，使用
NormalCompletion (value) 作为使其挂起的操作的结果。令 result 为恢复计算返回的值。 - 断言：当我们在此返回时，genContext 已从执行上下文栈移除且 methodContext 是当前正在运行的执行上下文。
- 返回 ? result。
27.5.3.4 GeneratorResumeAbrupt ( generator, abruptCompletion, generatorBrand )
The abstract operation GeneratorResumeAbrupt takes arguments generator (an ECMAScript language value), abruptCompletion (a return completion or a throw completion), and generatorBrand (a String or
- 令 state 为 ?
GeneratorValidate (generator, generatorBrand)。 - 如果 state 是
suspended-start ，则- 将 generator.[[GeneratorState]] 设为
completed 。 - 注：一旦生成器进入
completed 状态，它将不再离开该状态，其关联执行上下文不再恢复。此时可丢弃与 generator 相关的任意执行状态。 - 将 state 设为
completed 。
- 将 generator.[[GeneratorState]] 设为
- 如果 state 是
completed ，则- 如果 abruptCompletion 是一个 return completion，则
- 返回
CreateIteratorResultObject (abruptCompletion.[[Value]],true )。
- 返回
- 返回 ? abruptCompletion。
- 如果 abruptCompletion 是一个 return completion，则
- 断言：state 是
suspended-yield 。 - 令 genContext 为 generator.[[GeneratorContext]]。
- 令 methodContext 为正在运行的执行上下文。
- 挂起 methodContext。
- 将 generator.[[GeneratorState]] 设为
executing 。 - 将 genContext 压入执行上下文栈；genContext 现在是正在运行的执行上下文。
- 恢复 genContext 的挂起求值，使用 abruptCompletion 作为使其挂起的操作的结果。令 result 为恢复计算返回的
Completion Record 。 - 断言：当我们在此返回时，genContext 已从执行上下文栈移除且 methodContext 是当前正在运行的执行上下文。
- 返回 ? result。
27.5.3.5 GetGeneratorKind ( )
The abstract operation GetGeneratorKind takes no arguments and returns
- 令 genContext 为正在运行的执行上下文。
- 如果 genContext 没有 Generator 组件，返回
non-generator 。 - 令 generator 为 genContext 的 Generator 组件。
- 如果 generator 具有 [[AsyncGeneratorState]] 内部槽，返回
async 。 - 否则，返回
sync 。
27.5.3.6 GeneratorYield ( iteratorResult )
The abstract operation GeneratorYield takes argument iteratorResult (an Object that conforms to the
- 令 genContext 为正在运行的执行上下文。
- 断言：genContext 是一个生成器的执行上下文。
- 令 generator 为 genContext 的 Generator 组件的值。
- 断言：
GetGeneratorKind () 是sync 。 - 将 generator.[[GeneratorState]] 设为
suspended-yield 。 - 将 genContext 从执行上下文栈移除，恢复栈顶执行上下文为正在运行的执行上下文。
- 令 callerContext 为正在运行的执行上下文。
- 恢复 callerContext，传入
NormalCompletion (iteratorResult)。如果 genContext 之后再次被恢复，令 resumptionValue 为恢复时使用的Completion Record 。 - 断言：若控制流到达此处，则 genContext 再次成为正在运行的执行上下文。
- 返回 resumptionValue。
27.5.3.7 Yield ( value )
The abstract operation Yield takes argument value (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:
- 令 generatorKind 为
GetGeneratorKind ()。 - 如果 generatorKind 是
async ，返回 ?AsyncGeneratorYield (?Await (value))。 - 否则，返回 ?
GeneratorYield (CreateIteratorResultObject (value,false ))。
27.5.3.8 CreateIteratorFromClosure ( closure, generatorBrand, generatorPrototype [ , extraSlots ] )
The abstract operation CreateIteratorFromClosure takes arguments closure (an
- 注：closure 可以包含对
Yield 操作的使用，以产出一个 IteratorResult 对象。 - 如果 extraSlots 不存在，将 extraSlots 设为一个新的空
List 。 - 令 internalSlotsList 为 extraSlots 与 « [[GeneratorState]], [[GeneratorContext]], [[GeneratorBrand]] » 的列表连接。
- 令 generator 为
OrdinaryObjectCreate (generatorPrototype, internalSlotsList)。 - 将 generator.[[GeneratorBrand]] 设为 generatorBrand。
- 将 generator.[[GeneratorState]] 设为
suspended-start 。 - 令 callerContext 为正在运行的执行上下文。
- 令 calleeContext 为一个新的执行上下文。
- 将 calleeContext 的 Function 设为
null 。 - 将 calleeContext 的
Realm 设为当前 Realm Record 。 - 将 calleeContext 的 ScriptOrModule 设为 callerContext 的 ScriptOrModule。
- 如果 callerContext 尚未被挂起，则挂起 callerContext。
- 将 calleeContext 压入执行上下文栈；calleeContext 现在是正在运行的执行上下文。
- 执行
GeneratorStart (generator, closure)。 - 将 calleeContext 从执行上下文栈移除并恢复 callerContext 为正在运行的执行上下文。
- 返回 generator。
27.6 AsyncGenerator 对象
AsyncGenerator 通过调用一个 async 生成器函数创建，并同时符合异步迭代器接口与异步可迭代接口。
AsyncGenerator 实例直接从创建该实例的异步生成器函数
27.6.1 %AsyncGeneratorPrototype% 对象
%AsyncGeneratorPrototype% 对象：
- 是 %AsyncGeneratorFunction.prototype.prototype%。
- 是一个
普通对象 。 - 不是 AsyncGenerator 实例，并且没有 [[AsyncGeneratorState]] 内部槽。
- 具有值为
%AsyncIteratorPrototype% 的 [[Prototype]] 内部槽。 - 具有被所有 AsyncGenerator 实例间接继承的属性。
27.6.1.1 %AsyncGeneratorPrototype%.constructor
.constructor 的初始值是
该属性具有 { [[Writable]]:
27.6.1.2 %AsyncGeneratorPrototype%.next ( value )
- 令 generator 为
this 值。 - 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 result 为
Completion (AsyncGeneratorValidate (generator,empty ))。 IfAbruptRejectPromise (result, promiseCapability)。- 令 state 为 generator.[[AsyncGeneratorState]]。
- 如果 state 是
completed ，则- 令 iteratorResult 为
CreateIteratorResultObject (undefined ,true )。 - 执行 ! Call(promiseCapability.[[Resolve]],
undefined , « iteratorResult »)。 - 返回 promiseCapability.[[Promise]]。
- 令 iteratorResult 为
- 令 completion 为
NormalCompletion (value)。 - 执行
AsyncGeneratorEnqueue (generator, completion, promiseCapability)。 - 如果 state 是
suspended-start 或suspended-yield ，则- 执行
AsyncGeneratorResume (generator, completion)。
- 执行
- 否则，
- 断言：state 是
executing 或draining-queue 。
- 断言：state 是
- 返回 promiseCapability.[[Promise]]。
27.6.1.3 %AsyncGeneratorPrototype%.return ( value )
- 令 generator 为
this 值。 - 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 result 为
Completion (AsyncGeneratorValidate (generator,empty ))。 IfAbruptRejectPromise (result, promiseCapability)。- 令 completion 为
ReturnCompletion (value)。 - 执行
AsyncGeneratorEnqueue (generator, completion, promiseCapability)。 - 令 state 为 generator.[[AsyncGeneratorState]]。
- 如果 state 是
suspended-start 或completed ，则- 将 generator.[[AsyncGeneratorState]] 设为
draining-queue 。 - 执行
AsyncGeneratorAwaitReturn (generator)。
- 将 generator.[[AsyncGeneratorState]] 设为
- 否则如果 state 是
suspended-yield ，则- 执行
AsyncGeneratorResume (generator, completion)。
- 执行
- 否则，
- 断言：state 是
executing 或draining-queue 。
- 断言：state 是
- 返回 promiseCapability.[[Promise]]。
27.6.1.4 %AsyncGeneratorPrototype%.throw ( exception )
- 令 generator 为
this 值。 - 令 promiseCapability 为 !
NewPromiseCapability (%Promise% )。 - 令 result 为
Completion (AsyncGeneratorValidate (generator,empty ))。 IfAbruptRejectPromise (result, promiseCapability)。- 令 state 为 generator.[[AsyncGeneratorState]]。
- 如果 state 是
suspended-start ，则- 将 generator.[[AsyncGeneratorState]] 设为
completed 。 - 将 state 设为
completed 。
- 将 generator.[[AsyncGeneratorState]] 设为
- 如果 state 是
completed ，则- 执行 ! Call(promiseCapability.[[Reject]],
undefined , « exception »)。 - 返回 promiseCapability.[[Promise]]。
- 执行 ! Call(promiseCapability.[[Reject]],
- 令 completion 为
ThrowCompletion (exception)。 - 执行
AsyncGeneratorEnqueue (generator, completion, promiseCapability)。 - 如果 state 是
suspended-yield ，则- 执行
AsyncGeneratorResume (generator, completion)。
- 执行
- 否则，
- 断言：state 是
executing 或draining-queue 。
- 断言：state 是
- 返回 promiseCapability.[[Promise]]。
27.6.1.5 %AsyncGeneratorPrototype% [ %Symbol.toStringTag% ]
该属性具有 { [[Writable]]:
27.6.2 AsyncGenerator 实例的属性
AsyncGenerator 实例最初按如下描述的内部槽创建：
| 内部槽 | 类型 | 描述 |
|---|---|---|
| [[AsyncGeneratorState]] | 异步生成器的当前执行状态。 | |
| [[AsyncGeneratorContext]] | 一个执行上下文 | 执行该异步生成器代码时使用的执行上下文。 |
| [[AsyncGeneratorQueue]] | 一个 |
表示恢复该异步生成器请求的记录。除状态转换期间外，当且仅当 [[AsyncGeneratorState]] 为 |
| [[GeneratorBrand]] | 一个 String 或 |
用于区分不同种类异步生成器的标记。由 ECMAScript 源文本声明的异步生成器的 [[GeneratorBrand]] 始终为 |
27.6.3 AsyncGenerator 抽象操作
27.6.3.1 AsyncGeneratorRequest 记录
AsyncGeneratorRequest 是一个
其具有以下字段：
| 字段名 | 取值 | 含义 |
|---|---|---|
| [[Completion]] | 一个 |
用于恢复该异步生成器的 |
| [[Capability]] | 一个 |
与此请求关联的 promise 能力。 |
27.6.3.2 AsyncGeneratorStart ( generator, generatorBody )
The abstract operation AsyncGeneratorStart takes arguments generator (an AsyncGenerator) and generatorBody (a
- 断言：generator.[[AsyncGeneratorState]] 是
suspended-start 。 - 令 genContext 为正在运行的执行上下文。
- 将 genContext 的 Generator 组件设为 generator。
- 令 closure 为一个无参数的新抽象闭包，捕获 generatorBody 并在被调用时执行以下步骤：
- 令 acGenContext 为正在运行的执行上下文。
- 令 acGenerator 为 acGenContext 的 Generator 组件。
- 如果 generatorBody 是一个 Parse Node，则
- 令 result 为
Completion (Evaluation of generatorBody)。
- 令 result 为
- 否则，
- 断言：generatorBody 是一个无参数抽象闭包。
- 令 result 为
Completion (generatorBody())。
- 断言：若我们在此返回，异步生成器要么抛出异常，要么执行了隐式或显式的 return。
- 将 acGenContext 从执行上下文栈移除，并恢复栈顶执行上下文为正在运行的执行上下文。
- 将 acGenerator.[[AsyncGeneratorState]] 设为
draining-queue 。 - 如果 result 是一个 normal completion，将 result 设为
NormalCompletion (undefined )。 - 如果 result 是一个 return completion，将 result 设为
NormalCompletion (result.[[Value]])。 - 执行
AsyncGeneratorCompleteStep (acGenerator, result,true )。 - 执行
AsyncGeneratorDrainQueue (acGenerator)。 - 返回
NormalCompletion (undefined )。
- 设定 genContext 的代码求值状态，使得当该执行上下文恢复求值时，将无参数调用 closure。
- 将 generator.[[AsyncGeneratorContext]] 设为 genContext。
- 将 generator.[[AsyncGeneratorQueue]] 设为一个新的空
List 。 - 返回
unused 。
27.6.3.3 AsyncGeneratorValidate ( generator, generatorBrand )
The abstract operation AsyncGeneratorValidate takes arguments generator (an ECMAScript language value) and generatorBrand (a String or
- 执行 ?
RequireInternalSlot (generator, [[AsyncGeneratorContext]])。 - 执行 ?
RequireInternalSlot (generator, [[AsyncGeneratorState]])。 - 执行 ?
RequireInternalSlot (generator, [[AsyncGeneratorQueue]])。 - 如果 generator.[[GeneratorBrand]] 不等于 generatorBrand，抛出
TypeError 异常。 - 返回
unused 。
27.6.3.4 AsyncGeneratorEnqueue ( generator, completion, promiseCapability )
The abstract operation AsyncGeneratorEnqueue takes arguments generator (an AsyncGenerator), completion (a
- 令 request 为
AsyncGeneratorRequest { [[Completion]]: completion, [[Capability]]: promiseCapability }。 - 将 request 追加到 generator.[[AsyncGeneratorQueue]]。
- 返回
unused 。
27.6.3.5 AsyncGeneratorCompleteStep ( generator, completion, done [ , realm ] )
The abstract operation AsyncGeneratorCompleteStep takes arguments generator (an AsyncGenerator), completion (a
- 断言：generator.[[AsyncGeneratorQueue]] 非空。
- 令 next 为 generator.[[AsyncGeneratorQueue]] 的第一个元素。
- 移除 generator.[[AsyncGeneratorQueue]] 的第一个元素。
- 令 promiseCapability 为 next.[[Capability]]。
- 令 value 为 completion.[[Value]]。
- 如果 completion 是一个 throw completion，则
- 执行 ! Call(promiseCapability.[[Reject]],
undefined , « value »)。
- 执行 ! Call(promiseCapability.[[Reject]],
- 否则，
- 断言：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.6.3.6 AsyncGeneratorResume ( generator, completion )
The abstract operation AsyncGeneratorResume takes arguments generator (an AsyncGenerator) and completion (a
- 断言：generator.[[AsyncGeneratorState]] 是
suspended-start 或suspended-yield 。 - 令 genContext 为 generator.[[AsyncGeneratorContext]]。
- 令 callerContext 为正在运行的执行上下文。
- 挂起 callerContext。
- 将 generator.[[AsyncGeneratorState]] 设为
executing 。 - 将 genContext 压入执行上下文栈；genContext 现在是正在运行的执行上下文。
- 恢复 genContext 的挂起求值，使用 completion 作为使其挂起的操作的结果。令 result 为恢复计算返回的
Completion Record 。 - 断言：result 永不是一个 abrupt completion。
- 断言：当我们在此返回时，genContext 已从执行上下文栈移除且 callerContext 是当前正在运行的执行上下文。
- 返回
unused 。
27.6.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.6.3.8 AsyncGeneratorYield ( value )
The abstract operation AsyncGeneratorYield takes argument value (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 是一个生成器的执行上下文。
- 令 generator 为 genContext 的 Generator 组件的值。
- 断言：
GetGeneratorKind () 是async 。 - 令 completion 为
NormalCompletion (value)。 - 断言：执行上下文栈至少有两个元素。
- 令 previousContext 为执行上下文栈倒数第二个元素。
- 令 previousRealm 为 previousContext 的
Realm 。 - 执行
AsyncGeneratorCompleteStep (generator, completion,false , previousRealm)。 - 令 queue 为 generator.[[AsyncGeneratorQueue]]。
- 如果 queue 非空，则
- 注：执行在不挂起生成器的情况下继续。
- 令 toYield 为 queue 的第一个元素。
- 令 resumptionValue 为
Completion (toYield.[[Completion]])。 - 返回 ?
AsyncGeneratorUnwrapYieldResumption (resumptionValue)。
- 否则，
- 将 generator.[[AsyncGeneratorState]] 设为
suspended-yield 。 - 将 genContext 从执行上下文栈移除并恢复栈顶执行上下文为正在运行的执行上下文。
- 令 callerContext 为正在运行的执行上下文。
- 恢复 callerContext，传入
undefined 。如果 genContext 之后再次被恢复，令 resumptionValue 为恢复时使用的Completion Record 。 - 断言：若控制流到达此处，则 genContext 再次成为正在运行的执行上下文。
- 返回 ?
AsyncGeneratorUnwrapYieldResumption (resumptionValue)。
- 将 generator.[[AsyncGeneratorState]] 设为
27.6.3.9 AsyncGeneratorAwaitReturn ( generator )
The abstract operation AsyncGeneratorAwaitReturn takes argument generator (an AsyncGenerator) and returns
- 断言：generator.[[AsyncGeneratorState]] 是
draining-queue 。 - 令 queue 为 generator.[[AsyncGeneratorQueue]]。
- 断言：queue 非空。
- 令 next 为 queue 的第一个元素。
- 令 completion 为
Completion (next.[[Completion]])。 - 断言：completion 是一个 return completion。
- 令 promiseCompletion 为
Completion (PromiseResolve (%Promise% , completion.[[Value]]))。 - 如果 promiseCompletion 是一个 abrupt completion，则
- 执行
AsyncGeneratorCompleteStep (generator, promiseCompletion,true )。 - 执行
AsyncGeneratorDrainQueue (generator)。 - 返回
unused 。
- 执行
- 断言：promiseCompletion 是一个 normal completion。
- 令 promise 为 promiseCompletion.[[Value]]。
- 令 fulfilledClosure 为一个具有参数 (value) 的新抽象闭包，捕获 generator 并在被调用时执行以下步骤：
- 断言：generator.[[AsyncGeneratorState]] 是
draining-queue 。 - 令 result 为
NormalCompletion (value)。 - 执行
AsyncGeneratorCompleteStep (generator, result,true )。 - 执行
AsyncGeneratorDrainQueue (generator)。 - 返回
NormalCompletion (undefined )。
- 断言：generator.[[AsyncGeneratorState]] 是
- 令 onFulfilled 为
CreateBuiltinFunction (fulfilledClosure, 1,"" , « »)。 - 令 rejectedClosure 为一个具有参数 (reason) 的新抽象闭包，捕获 generator 并在被调用时执行以下步骤：
- 断言：generator.[[AsyncGeneratorState]] 是
draining-queue 。 - 令 result 为
ThrowCompletion (reason)。 - 执行
AsyncGeneratorCompleteStep (generator, result,true )。 - 执行
AsyncGeneratorDrainQueue (generator)。 - 返回
NormalCompletion (undefined )。
- 断言：generator.[[AsyncGeneratorState]] 是
- 令 onRejected 为
CreateBuiltinFunction (rejectedClosure, 1,"" , « »)。 - 执行
PerformPromiseThen (promise, onFulfilled, onRejected)。 - 返回
unused 。
27.6.3.10 AsyncGeneratorDrainQueue ( generator )
The abstract operation AsyncGeneratorDrainQueue takes argument generator (an AsyncGenerator) and returns
- 断言：generator.[[AsyncGeneratorState]] 是
draining-queue 。 - 令 queue 为 generator.[[AsyncGeneratorQueue]]。
- 当 queue 非空时重复，
- 令 next 为 queue 的第一个元素。
- 令 completion 为
Completion (next.[[Completion]])。 - 如果 completion 是一个 return completion，则
- 执行
AsyncGeneratorAwaitReturn (generator)。 - 返回
unused 。
- 执行
- 否则，
- 如果 completion 是一个 normal completion，则
- 将 completion 设为
NormalCompletion (undefined )。
- 将 completion 设为
- 执行
AsyncGeneratorCompleteStep (generator, completion,true )。
- 如果 completion 是一个 normal completion，则
- 将 generator.[[AsyncGeneratorState]] 设为
completed 。 - 返回
unused 。
27.6.3.11 CreateAsyncIteratorFromClosure ( closure, generatorBrand, generatorPrototype )
The abstract operation CreateAsyncIteratorFromClosure takes arguments closure (an
- 注：closure 可以包含
Await 操作的使用以及Yield 操作以产出一个 IteratorResult 对象。 - 令 internalSlotsList 为 « [[AsyncGeneratorState]], [[AsyncGeneratorContext]], [[AsyncGeneratorQueue]], [[GeneratorBrand]] »。
- 令 generator 为
OrdinaryObjectCreate (generatorPrototype, internalSlotsList)。 - 将 generator.[[GeneratorBrand]] 设为 generatorBrand。
- 将 generator.[[AsyncGeneratorState]] 设为
suspended-start 。 - 令 callerContext 为正在运行的执行上下文。
- 令 calleeContext 为一个新的执行上下文。
- 将 calleeContext 的 Function 设为
null 。 - 将 calleeContext 的
Realm 设为当前 Realm Record 。 - 将 calleeContext 的 ScriptOrModule 设为 callerContext 的 ScriptOrModule。
- 如果 callerContext 尚未被挂起，则挂起 callerContext。
- 将 calleeContext 压入执行上下文栈；calleeContext 现在是正在运行的执行上下文。
- 执行
AsyncGeneratorStart (generator, closure)。 - 将 calleeContext 从执行上下文栈移除并恢复 callerContext 为正在运行的执行上下文。
- 返回 generator。
27.7 AsyncFunction 对象
AsyncFunction 通常通过求值
27.7.1 AsyncFunction 构造函数
AsyncFunction
- 是 %AsyncFunction%。
- 是
Function的子类。 - 当以函数（而非
构造函数 ）方式调用时创建并初始化一个新的 AsyncFunction。故函数调用AsyncFunction(…)等价于以相同参数的对象创建表达式new AsyncFunction(…)。 - 可用作类定义中
extends子句的值。意图继承指定 AsyncFunction 行为的子类构造函数 必须包含对 AsyncFunction构造函数 的super调用，以创建并初始化具有内建异步函数行为所需内部槽的子类实例。所有用于定义异步函数对象 的 ECMAScript 语法形式都会创建 AsyncFunction 的直接实例。没有语法手段创建 AsyncFunction 子类的实例。
27.7.1.1 AsyncFunction ( ...parameterArgs, bodyArg )
最后一个参数（如果存在）指定异步函数的函数体（可执行代码）。之前的任意参数指定形式参数。
该函数被调用时执行以下步骤：
- 令 C 为活动
函数对象 。 - 如果 bodyArg 不存在，将 bodyArg 设为空字符串。
- 返回 ?
CreateDynamicFunction (C, NewTarget,async , parameterArgs, bodyArg)。
27.7.2 AsyncFunction 构造函数的属性
AsyncFunction
- 是一个继承自 Function
构造函数 的标准内建函数对象 。 - 具有值为
%Function% 的 [[Prototype]] 内部槽。 - 具有值为
1 𝔽 的"length" 属性。 - 具有值为
"AsyncFunction" 的"name" 属性。 - 具有以下属性：
27.7.2.1 AsyncFunction.prototype
AsyncFunction.prototype 的初始值是
该属性具有 { [[Writable]]:
27.7.3 AsyncFunction 原型对象的属性
AsyncFunction 原型对象：
- 是 %AsyncFunction.prototype%。
- 是一个
普通对象 。 - 不是
函数对象 ，并且没有 [[ECMAScriptCode]] 内部槽，也没有Table 28 中列出的任何其他内部槽。 - 具有值为
%Function.prototype% 的 [[Prototype]] 内部槽。
27.7.3.1 AsyncFunction.prototype.constructor
AsyncFunction.prototype.constructor 的初始值是
该属性具有 { [[Writable]]:
27.7.3.2 AsyncFunction.prototype [ %Symbol.toStringTag% ]
该属性具有 { [[Writable]]:
27.7.4 AsyncFunction 实例
每个 AsyncFunction 实例都是一个 ECMAScript
每个 AsyncFunction 实例具有以下自有属性：
27.7.4.1 length
27.7.4.2 name
27.7.5 Async 函数的抽象操作
27.7.5.1 AsyncFunctionStart ( promiseCapability, asyncFunctionBody )
The abstract operation AsyncFunctionStart takes arguments promiseCapability (a
- 令 runningContext 为正在运行的执行上下文。
- 令 asyncContext 为 runningContext 的一个副本。
- 注：复制执行状态是
AsyncBlockStart 恢复其执行所需。恢复一个当前正在执行的上下文是未定义的。 - 执行
AsyncBlockStart (promiseCapability, asyncFunctionBody, asyncContext)。 - 返回
unused 。
27.7.5.2 AsyncBlockStart ( promiseCapability, asyncBody, asyncContext )
The abstract operation AsyncBlockStart takes arguments promiseCapability (a
- 令 runningContext 为正在运行的执行上下文。
- 令 closure 为一个无参数的新抽象闭包，捕获 promiseCapability 与 asyncBody 并在被调用时执行以下步骤：
- 令 acAsyncContext 为正在运行的执行上下文。
- 如果 asyncBody 是一个 Parse Node，则
- 令 result 为
Completion (Evaluation of asyncBody)。
- 令 result 为
- 否则，
- 断言：asyncBody 是一个无参数抽象闭包。
- 令 result 为
Completion (asyncBody())。
- 断言：若我们在此返回，异步函数要么抛出异常，要么执行了隐式或显式 return；所有等待均已完成。
- 将 acAsyncContext 从执行上下文栈移除，并恢复栈顶执行上下文为正在运行的执行上下文。
- 如果 result 是一个 normal completion，则
- 执行 ! Call(promiseCapability.[[Resolve]],
undefined , «undefined »)。
- 执行 ! Call(promiseCapability.[[Resolve]],
- 否则如果 result 是一个 return completion，则
- 执行 ! Call(promiseCapability.[[Resolve]],
undefined , « result.[[Value]] »)。
- 执行 ! Call(promiseCapability.[[Resolve]],
- 否则，
- 断言：result 是一个 throw completion。
- 执行 ! Call(promiseCapability.[[Reject]],
undefined , « result.[[Value]] »)。
- 返回
NormalCompletion (unused )。
- 设定 asyncContext 的代码求值状态，使得当该执行上下文恢复求值时，将无参数调用 closure。
- 将 asyncContext 压入执行上下文栈；asyncContext 现在是正在运行的执行上下文。
- 恢复 asyncContext 的挂起求值。令 result 为恢复计算返回的值。
- 断言：当我们在此返回时，asyncContext 已从执行上下文栈移除且 runningContext 是当前正在运行的执行上下文。
- 断言：result 是一个取值为
unused 的 normal completion。该值的可能来源是Await ，或当异步函数未等待任何内容时，上文步骤2.i 。 - 返回
unused 。
27.7.5.3 Await ( value )
The abstract operation Await takes argument value (an ECMAScript language value) and returns either a normal completion containing either an ECMAScript language value or
- 令 asyncContext 为正在运行的执行上下文。
- 令 promise 为 ?
PromiseResolve (%Promise% , value)。 - 令 fulfilledClosure 为一个具有参数 (v) 的新抽象闭包，捕获 asyncContext 并在被调用时执行以下步骤：
- 令 prevContext 为正在运行的执行上下文。
- 挂起 prevContext。
- 将 asyncContext 压入执行上下文栈；asyncContext 现在是正在运行的执行上下文。
- 恢复 asyncContext 的挂起求值，使用
NormalCompletion (v) 作为使其挂起的操作的结果。 - 断言：当我们到达此步骤时，asyncContext 已从执行上下文栈移除且 prevContext 是当前正在运行的执行上下文。
- 返回
NormalCompletion (undefined )。
- 令 onFulfilled 为
CreateBuiltinFunction (fulfilledClosure, 1,"" , « »)。 - 令 rejectedClosure 为一个具有参数 (reason) 的新抽象闭包，捕获 asyncContext 并在被调用时执行以下步骤：
- 令 prevContext 为正在运行的执行上下文。
- 挂起 prevContext。
- 将 asyncContext 压入执行上下文栈；asyncContext 现在是正在运行的执行上下文。
- 恢复 asyncContext 的挂起求值，使用
ThrowCompletion (reason) 作为使其挂起的操作的结果。 - 断言：当我们到达此步骤时，asyncContext 已从执行上下文栈移除且 prevContext 是当前正在运行的执行上下文。
- 返回
NormalCompletion (undefined )。
- 令 onRejected 为
CreateBuiltinFunction (rejectedClosure, 1,"" , « »)。 - 执行
PerformPromiseThen (promise, onFulfilled, onRejected)。 - 将 asyncContext 从执行上下文栈移除并恢复栈顶执行上下文为正在运行的执行上下文。
- 令 callerContext 为正在运行的执行上下文。
- 恢复 callerContext，传入
empty 。如果 asyncContext 之后再次被恢复，令 completion 为恢复时使用的Completion Record 。 - 断言：若控制流到达此处，则 asyncContext 再次成为正在运行的执行上下文。
- 返回 completion。
28 反射
28.1 Reflect 对象
Reflect 对象：
- 是 %Reflect%。
- 是全局对象
"Reflect" 属性的初始值。 - 是一个
普通对象 。 - 具有值为
%Object.prototype% 的 [[Prototype]] 内部槽。 - 不是
函数对象 。 - 没有 [[Construct]] 内部方法；不能用
new作为构造函数 调用。 - 没有 [[Call]] 内部方法；不能当作函数调用。
28.1.1 Reflect.apply ( target, thisArgument, argumentsList )
该函数被调用时执行以下步骤：
- 如果
IsCallable (target) 为false ，抛出TypeError 异常。 - 令 args 为 ? CreateListFromArrayLike(argumentsList)。
- 执行
PrepareForTailCall ()。 - 返回 ? Call(target, thisArgument, args)。
28.1.2 Reflect.construct ( target, argumentsList [ , newTarget ] )
该函数被调用时执行以下步骤：
- 如果
IsConstructor (target) 为false ，抛出TypeError 异常。 - 如果 newTarget 不存在，将 newTarget 设为 target。
- 否则如果
IsConstructor (newTarget) 为false ，抛出TypeError 异常。 - 令 args 为 ? CreateListFromArrayLike(argumentsList)。
- 返回 ? Construct(target, args, newTarget)。
28.1.3 Reflect.defineProperty ( target, propertyKey, attributes )
该函数被调用时执行以下步骤：
- 如果 target 不是一个 Object，抛出
TypeError 异常。 - 令 key 为 ?
ToPropertyKey (propertyKey)。 - 令 desc 为 ?
ToPropertyDescriptor (attributes)。 - 返回 ? target.[[DefineOwnProperty]](key, desc)。
28.1.4 Reflect.deleteProperty ( target, propertyKey )
该函数被调用时执行以下步骤：
- 如果 target 不是一个 Object，抛出
TypeError 异常。 - 令 key 为 ?
ToPropertyKey (propertyKey)。 - 返回 ? target.[[Delete]](key)。
28.1.5 Reflect.get ( target, propertyKey [ , receiver ] )
该函数被调用时执行以下步骤：
- 如果 target 不是一个 Object，抛出
TypeError 异常。 - 令 key 为 ?
ToPropertyKey (propertyKey)。 - 如果 receiver 不存在，则
- 将 receiver 设为 target。
- 返回 ? target.[[Get]](key, receiver)。
28.1.6 Reflect.getOwnPropertyDescriptor ( target, propertyKey )
该函数被调用时执行以下步骤：
- 如果 target 不是一个 Object，抛出
TypeError 异常。 - 令 key 为 ?
ToPropertyKey (propertyKey)。 - 令 desc 为 ? target.[[GetOwnProperty]](key)。
- 返回
FromPropertyDescriptor (desc)。
28.1.7 Reflect.getPrototypeOf ( target )
该函数被调用时执行以下步骤：
- 如果 target 不是一个 Object，抛出
TypeError 异常。 - 返回 ? target.[[GetPrototypeOf]]()。
28.1.8 Reflect.has ( target, propertyKey )
该函数被调用时执行以下步骤：
- 如果 target 不是一个 Object，抛出
TypeError 异常。 - 令 key 为 ?
ToPropertyKey (propertyKey)。 - 返回 ? target.[[HasProperty]](key)。
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, propertyKey, V [ , receiver ] )
该函数被调用时执行以下步骤：
- 如果 target 不是一个 Object，抛出
TypeError 异常。 - 令 key 为 ?
ToPropertyKey (propertyKey)。 - 如果 receiver 不存在，则
- 将 receiver 设为 target。
- 返回 ? target.[[Set]](key, V, 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 为一个无参数的新抽象闭包（不捕获任何东西），调用时执行：
- 令 F 为活动
函数对象 。 - 令 p 为 F.[[RevocableProxy]]。
- 如果 p 为
null ，返回NormalCompletion (undefined )。 - 将 F.[[RevocableProxy]] 设为
null 。 - 断言：p 是一个 Proxy 奇异对象。
- 将 p.[[ProxyTarget]] 设为
null 。 - 将 p.[[ProxyHandler]] 设为
null 。 - 返回
NormalCompletion (undefined )。
- 令 F 为活动
- 令 revoker 为
CreateBuiltinFunction (revokerClosure, 0,"" , « [[RevocableProxy]] »)。 - 将 revoker.[[RevocableProxy]] 设为 proxy。
- 令 result 为
OrdinaryObjectCreate (%Object.prototype% )。
- 令 result 为
- 执行 !
CreateDataPropertyOrThrow (result,"proxy" , proxy)。 - 执行 !
CreateDataPropertyOrThrow (result,"revoke" , revoker)。 - 返回 result。
28.3 模块命名空间对象
模块命名空间对象是一种模块命名空间奇异对象，提供在运行时以属性方式访问模块导出绑定的机制。没有用于模块命名空间对象的
除
28.3.1 %Symbol.toStringTag%
该属性具有 { [[Writable]]:
29 内存模型
内存一致性模型（或称 内存模型）规定了
内存模型以关系约束形式定义，这些约束作用于在求值过程中由对 SharedArrayBuffer 的
29.1 内存模型基础
共享内存访问（读与写）分为两类：原子访问和数据访问（下文定义）。原子访问是顺序一致的，即存在一个所有代理都同意的
不支持比顺序一致更弱、比无序更强的次序（如 release-acquire）。
共享数据块事件 是 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]] | 一个读-改-写修改函数 | 从读取的 |
这些事件由
某些操作还可能引入 Synchronize 事件。一个 Synchronize 事件 没有字段，仅用于直接约束其他事件的允许顺序。
除共享数据块事件与 Synchronize 事件外，还存在
令 ReadSharedMemory、WriteSharedMemory 或 ReadModifyWriteSharedMemory 事件的范围为从其 [[ByteIndex]] 到 [[ByteIndex]] + [[ElementSize]] - 1 的连续整数集合。两个事件的范围相等当且仅当它们具有相同 [[Block]] 且范围逐元素相等。若两个事件有相同 [[Block]]、范围不等且交集非空则范围重叠。若两个事件没有相同 [[Block]] 或其范围既不相等也不重叠则范围不相交。
应考虑的postMessage），代理的启动与停止，以及通过共享内存之外的通道在代理集群内通信。对于某次执行 execution，这些事件由
候选执行中的事件由下列定义的关系排序。
29.2 代理事件记录
Agent Events Record 是具有以下字段的
| 字段名 | 取值 | 含义 |
|---|---|---|
| [[AgentSignifier]] | 一个代理标识符 | 其求值导致此排序的代理。 |
| [[EventList]] | 一个事件的 |
求值过程中事件被追加到该列表。 |
| [[AgentSynchronizesWith]] | 一对 |
由操作语义引入的同步关系。 |
29.3 选定值记录
Chosen Value Record 是具有以下字段的
| 字段名 | 取值 | 含义 |
|---|---|---|
| [[Event]] | 一个 |
为该选定值引入的 |
| [[ChosenValue]] | 一个 |
求值过程中非确定性选出的字节。 |
29.4 候选执行
代理集群求值的一个 candidate execution 是具有以下字段的
| 字段名 | 取值 | 含义 |
|---|---|---|
| [[EventsRecords]] | 映射一个代理到求值过程中追加的事件列表。 | |
| [[ChosenValues]] | 将 |
29.5 内存模型的抽象操作
29.5.1 EventSet ( execution )
The abstract operation EventSet takes argument execution (a
- 令 events 为一个空 Set。
- 对于 execution.[[EventsRecords]] 中的每个
Agent Events Record aer，执行- 对 aer.[[EventList]] 中的每个事件 E，执行
- 将 E 加入 events。
- 对 aer.[[EventList]] 中的每个事件 E，执行
- 返回 events。
29.5.2 SharedDataBlockEventSet ( execution )
The abstract operation SharedDataBlockEventSet takes argument execution (a
- 令 events 为一个空 Set。
- 对
EventSet (execution) 中的每个事件 E，执行- 如果 E 是
ReadSharedMemory 、WriteSharedMemory 或ReadModifyWriteSharedMemory 事件，将 E 加入 events。
- 如果 E 是
- 返回 events。
29.5.3 HostEventSet ( execution )
The abstract operation HostEventSet takes argument execution (a
- 令 events 为一个空 Set。
- 对
EventSet (execution) 中的每个事件 E，执行- 如果 E 不在
SharedDataBlockEventSet (execution) 中，将 E 加入 events。
- 如果 E 不在
- 返回 events。
29.5.4 ComposeWriteEventBytes ( execution, byteIndex, Ws )
The abstract operation ComposeWriteEventBytes takes arguments execution (a
- 令 byteLocation 为 byteIndex。
- 令 bytesRead 为一个新的空
List 。 - 对 Ws 中每个元素 W，执行
- 断言：W 的范围包含 byteLocation。
- 令 payloadIndex 为 byteLocation - W.[[ByteIndex]]。
- 如果 W 是
WriteSharedMemory 事件，则- 令 byte 为 W.[[Payload]][payloadIndex]。
- 否则，
- 断言：W 是
ReadModifyWriteSharedMemory 事件。 - 令 bytes 为
ValueOfReadEvent (execution, W)。 - 令 bytesModified 为 W.[[ModifyOp]](bytes, W.[[Payload]])。
- 令 byte 为 bytesModified[payloadIndex]。
- 断言：W 是
- 将 byte 追加到 bytesRead。
- 将 byteLocation 设为 byteLocation + 1。
- 返回 bytesRead。
读-改-写修改 [[ModifyOp]] 由 Atomics 对象上引入
此
29.5.5 ValueOfReadEvent ( execution, R )
The abstract operation ValueOfReadEvent takes arguments execution (a
- 令 Ws 为
reads-bytes-from (R) in execution。 - 断言：Ws 是长度等于 R.[[ElementSize]] 的
WriteSharedMemory 或ReadModifyWriteSharedMemory 事件List 。 - 返回
ComposeWriteEventBytes (execution, R.[[ByteIndex]], Ws)。
29.6 候选执行的关系
以下关系与数学函数以特定候选执行为参数，对其事件排序。
29.6.1 is-agent-order-before
对候选执行 execution，其 is-agent-order-before 关系是满足以下条件的事件上的最小关系。
- 对事件 E 与 D，若存在 execution.[[EventsRecords]] 中的某个
Agent Events Record aer，使得 aer.[[EventList]] 同时包含 E 与 D 且 E 在该List 顺序上位于 D 之前，则 E 在 execution 中 is-agent-order-before D。
29.6.2 reads-bytes-from
对候选执行 execution，其 reads-bytes-from 函数是一个数学函数，将
-
对
SharedDataBlockEventSet (execution) 中每个ReadSharedMemory 或ReadModifyWriteSharedMemory 事件 R，reads-bytes-from(R) in execution 为长度 R.[[ElementSize]] 的List ，其元素为WriteSharedMemory 或ReadModifyWriteSharedMemory 事件 Ws，满足：- Ws 中索引 i 的每个事件 W 的范围包含 R.[[ByteIndex]] + i。
- R 不在 Ws 中。
一个候选执行总能容纳一个 reads-bytes-from 函数。
29.6.3 reads-from
对候选执行 execution，其 reads-from 关系是满足以下条件的事件上的最小关系。
- 对事件 R 与 W，若
SharedDataBlockEventSet (execution) 同时包含 R 与 W 且reads-bytes-from (R) in execution 包含 W，则 R reads-from W。
29.6.4 host-synchronizes-with
对候选执行 execution，其 host-synchronizes-with 关系是
- 若 E host-synchronizes-with D，则
HostEventSet (execution) 包含 E 与 D。 - host-synchronizes-with 与
is-agent-order-before 的并集中不存在环。
对候选执行 execution 中两个
该关系允许postMessage。
29.6.5 synchronizes-with
对候选执行 execution，其 synchronizes-with 关系是满足以下条件的事件上的最小关系：
-
对事件 R 与 W，若 R
reads-from W in execution、R.[[Order]] 为seq-cst 、W.[[Order]] 为seq-cst 且 R 与 W 范围相等，则 W synchronizes-with R。 -
对 execution.[[EventsRecords]] 的每个元素 eventsRecord，以下成立：
- 若 eventsRecord.[[AgentSynchronizesWith]] 包含 (S, Sw)，则 S synchronizes-with Sw。
- 对事件 E 与 D，若 execution.[[HostSynchronizesWith]] 包含 (E, D)，则 E synchronizes-with D。
按
并非所有通过
若
29.6.6 happens-before
对候选执行 execution，其 happens-before 关系是满足以下条件的事件上的最小关系。
-
对事件 E 与 D，若以下任一成立则 E happens-before D：
- E
is-agent-order-before D。 - E
synchronizes-with D。 SharedDataBlockEventSet (execution) 同时包含 E 与 D，E.[[Order]] 为init ，且 E 与 D 范围重叠。- 存在事件 F 使得 E happens-before F 且 F happens-before D。
- E
因 happens-before 是 agent-order 的超集，候选执行与 ECMAScript 的单线程求值语义一致。
29.7 合法执行的性质
29.7.1 有效选定读取
候选执行 execution 具有有效选定读取当且仅当以下算法返回
- 对
SharedDataBlockEventSet (execution) 中每个ReadSharedMemory 或ReadModifyWriteSharedMemory 事件 R，执行- 令 chosenValueRecord 为 execution.[[ChosenValues]] 中 [[Event]] 字段为 R 的元素。
- 令 chosenValue 为 chosenValueRecord.[[ChosenValue]]。
- 令 readValue 为
ValueOfReadEvent (execution, R)。 - 令 chosenLen 为 chosenValue 的元素个数。
- 令 readLen 为 readValue 的元素个数。
- 如果 chosenLen ≠ readLen，则
- 返回
false 。
- 返回
- 如果 存在整数 i 属于 [0, chosenLen) 使 chosenValue[i] ≠ readValue[i]，则
- 返回
false 。
- 返回
- 返回
true 。
29.7.2 相干读取
候选执行 execution 具有相干读取当且仅当以下算法返回
- 对
SharedDataBlockEventSet (execution) 中每个ReadSharedMemory 或ReadModifyWriteSharedMemory 事件 R，执行- 令 Ws 为
reads-bytes-from (R) in execution。 - 令 byteLocation 为 R.[[ByteIndex]]。
- 对 Ws 中每个元素 W，执行
- 如果 R
happens-before W，则- 返回
false 。
- 返回
- 如果 存在
WriteSharedMemory 或ReadModifyWriteSharedMemory 事件 V，其范围包含 byteLocation，且 Whappens-before V 且 Vhappens-before R，则- 返回
false 。
- 返回
- 将 byteLocation 设为 byteLocation + 1。
- 如果 R
- 令 Ws 为
- 返回
true 。
29.7.3 无撕裂读取
候选执行 execution 具有无撕裂读取当且仅当以下算法返回
- 对
SharedDataBlockEventSet (execution) 中每个ReadSharedMemory 或ReadModifyWriteSharedMemory 事件 R，执行- 如果 R.[[NoTear]] 为
true ，则- 断言：R.[[ByteIndex]] 除以 R.[[ElementSize]] 的余数为 0。
- 对每个事件 W（满足 R
reads-from W 且 W.[[NoTear]] 为true ），执行- 如果 R 与 W 范围相等且存在事件 V 使得 V 与 W 范围相等、V.[[NoTear]] 为
true 、W 与 V 非同一共享数据块事件 且 Rreads-from V，则- 返回
false 。
- 返回
- 如果 R 与 W 范围相等且存在事件 V 使得 V 与 W 范围相等、V.[[NoTear]] 为
- 如果 R.[[NoTear]] 为
- 返回
true 。
事件的 [[NoTear]] 字段为
直观地，该要求表示当内存范围以整数
29.7.4 顺序一致原子
对候选执行 execution，is-memory-order-before 是
- 对事件 E 与 D，若 E
happens-before D，则 E is-memory-order-before D。 -
对 R 与 W（满足 R
reads-from W），不存在WriteSharedMemory 或ReadModifyWriteSharedMemory 事件 V 属于SharedDataBlockEventSet (execution)，使 V.[[Order]] 为seq-cst 、W is-memory-order-before V、V is-memory-order-before R，且以下任一成立：- W
synchronizes-with R 且 V 与 R 范围相等。 - W
happens-before R 且 Vhappens-before R，W.[[Order]] 为seq-cst ，且 W 与 V 范围相等。 - W
happens-before R 且 Whappens-before V，R.[[Order]] 为seq-cst ，且 V 与 R 范围相等。
Note 1 此条款额外约束范围相等的
seq-cst 事件。 - W
-
对
SharedDataBlockEventSet (execution) 中每个WriteSharedMemory 或ReadModifyWriteSharedMemory 事件 W，若 W.[[Order]] 为seq-cst ，则不可能存在无限多个与 W 范围相等且 memory-order 位于 W 之前的ReadSharedMemory 或ReadModifyWriteSharedMemory 事件。Note 2 该条款与代理的前向进展保证一起确保：
seq-cst 写在有限 时间内对范围相等的seq-cst 读可见。
若候选执行存在一个 is-memory-order-before 关系，则其具有顺序一致原子。
虽然 is-memory-order-before 包含
29.7.5 合法执行
候选执行 execution 是合法执行（或简称执行）当且仅当以下各项均为真：
宿主 为 execution 提供host-synchronizes-with 关系。- execution 存在一个为
严格偏序 的happens-before 关系。 - execution 具有有效选定读取。
- execution 具有相干读取。
- execution 具有无撕裂读取。
- execution 具有顺序一致原子。
所有程序至少有一个合法执行。
29.8 竞争
对执行 execution 及其中
- 如果 E 与 D 不是同一
共享数据块事件 ，则- 如果并非 E
happens-before D 且 Dhappens-before E 同时成立，则- 如果 E 与 D 均为
WriteSharedMemory 或ReadModifyWriteSharedMemory 事件且范围不相交为假，则- 返回
true 。
- 返回
- 如果 E
reads-from D 或 Dreads-from E，则- 返回
true 。
- 返回
- 如果 E 与 D 均为
- 如果并非 E
- 返回
false 。
29.9 数据竞争
对执行 execution 及其中
- 如果 E 与 D 在 execution 中处于
race ，则- 如果 E.[[Order]] 不是
seq-cst 或 D.[[Order]] 不是seq-cst ，则- 返回
true 。
- 返回
- 如果 E 与 D 范围重叠，则
- 返回
true 。
- 返回
- 如果 E.[[Order]] 不是
- 返回
false 。
29.10 数据竞争自由
执行 execution 是 data race free 当且仅当
若程序所有执行均数据竞争自由，则该程序为数据竞争自由程序。
29.11 共享内存指南
以下是面向使用共享内存的 ECMAScript 程序员的指南。
推荐保持程序数据竞争自由，即使同一内存位置不可能同时发生并发非原子操作。数据竞争自由程序具有交错语义：每个代理的每一步求值语义互相交错。此时无需理解
更一般地，即便程序非数据竞争自由，也可能具可预测行为，只要原子操作不参与任何数据竞争，且竞争操作的访问大小一致。最简单方式是保证原子与非原子操作使用不同内存单元，且不同大小的原子访问不同时访问相同单元。实质上，程序应尽量将共享内存视为强类型。仍不可依赖竞争的非原子访问的顺序与时序，但若内存被强类型对待，竞争访问不会“撕裂”（其值的位不会混合）。
以下是面向为使用共享内存程序编写编译器变换的 ECMAScript 实现者的指南。
希望在多代理环境中允许大多数在单代理环境有效的程序变换，以确保多代理程序中每个代理的性能与单代理时一样。此类变换往往难以判定。我们概述若干应视为规范性的规则（由
令 agent-order slice 为
令读取事件的 possible read values 为该事件在所有合法执行中
在无共享内存时有效的任意 agent-order slice 变换在存在共享内存时亦有效，以下例外：
-
原子操作不可动摇：程序变换不得使 agent-order slice 中的
seq-cst 事件与其unordered 操作重排，亦不得重排其seq-cst 操作之间的顺序，也不得移除seq-cst 操作。（实践中，该限制迫使编译器假设每个
seq-cst 操作均为同步点并被包含在最终is-memory-order-before 关系中。） -
读取必须稳定：任一共享内存读取在一次执行中只能观察到单一值。
（例如，若语义上单次读取被多次执行，则程序只能观察其中一个值；某些再物化变换可违反此规则。）
-
写入必须稳定：所有可观察写入必须源于该次执行的程序语义。
（例如，变换不能引入程序本不可能的写，如对更大位置的读改写来写较小数据，写入程序原本不可写的值，或将刚读取的值写回其位置且期间可能被他代理
覆盖 。） -
可能读取值不得为空：程序变换不能使某共享内存读取的可能读取值集合为空。
（反直觉地，该规则实际限制对写的变换，因为写的作用仅在被读事件读取。例如写可移动、合并，有时在两个
seq-cst 操作间重排，但不可删掉所有更新某位置的写，必须保留一个。）
仍然有效的变换示例：合并多个对同一位置的非原子读；重排非原子读；引入推测非原子读；合并多个对同一位置的非原子写；对不同位置的非原子写重排；将非原子读外提出循环（即使影响终止性）。注意别名
以下是面向为共享内存访问生成机器码的 ECMAScript 实现者的指南。
对LOCK 前缀指令，ARM 的 load-exclusive/store-exclusive，Power 的 load-link/store-conditional。
具体而言，
- 程序中的每个原子操作都被视为必要。
- 原子操作不与其他原子或非原子操作重排。
- 函数被假定执行原子操作。
- 原子操作不以更大数据的读改写实现，而在不支持相应大小原子时使用非锁自由原子（假定平台具备所有必要尺寸的普通内存访问）。
朴素代码生成模式：
- 常规加载与存储 -> 单条加载/存储指令。
- 锁自由原子加载与存储 -> 全栅栏，常规加载/存储，再全栅栏。
- 锁自由原子读改写 -> 全栅栏，原子读改写指令序列，全栅栏。
- 非锁自由原子 -> 自旋锁获取，全栅栏，一系列非原子读写，全栅栏，自旋锁释放。
该映射在原子操作与非原子写或不同大小原子不竞争下正确；若竞争，
局部优化在模型约束下也是允许的，例如：
- 平台相关的消除冗余栅栏（例如 x86 上锁自由原子读写的栅栏多可省略，除写后的栅栏）。
- 多数现代平台支持所需数据大小的锁自由原子；若需非锁自由原子，可将原子操作体周围栅栏折叠进锁操作；最简单是每个 SharedArrayBuffer 一个锁字。
- 更复杂的局部优化，如合并背靠背栅栏；x86 上分隔原子写的栅栏可省，因写后所需栅栏仅用于分隔与后续读。
Annex A (informative) 语法概要
A.1 词法语法
A.2 表达式
当处理产生式实例
时，
当处理产生式实例
时，
在特定情况下，当处理产生式实例
时，
A.3 语句
A.4 函数与类
当处理产生式实例
时，
当处理产生式实例
时，
A.5 脚本与模块
A.6 数值转换
所有未被
A.7 时区偏移字符串格式
A.8 正则表达式
对于每个 \u u \u u
Annex B (normative) 供网页浏览器使用的额外 ECMAScript 特性
当 ECMAScript
本附录中定义的一些特性在本附录中具体说明，另一些则在本文档主体中说明。
当某个特性在正文中定义时，每个其影响文档的点都会用带颜色框中的 “Normative Optional” 字样标记。此外，如果该特性牵涉算法或
B.1 附加语法
B.1.1 类 HTML 注释
Syntax
类似包含行终止符代码点的
B.1.2 正则表达式模式
这种替代模式文法与语义只改变 BMP 模式的语法与语义。下面的语法扩展包含带有 [UnicodeMode] 参数的产生式。然而，这些扩展均不改变在
Syntax
当同一左侧同时出现带 [+UnicodeMode] 与 [~UnicodeMode] 守卫时，用于控制消解优先级。
B.1.2.1 静态语义：早期错误
- 若任意源码文本被此产生式匹配，则为语法错误。
此外，下列产生式的规则添加 高亮 文本后被修改：
-
若第一个
ClassAtom 的 IsCharacterClass 为true 或第二个ClassAtom 的 IsCharacterClass 为true 且该产生式具有 [UnicodeMode] 参数，则为语法错误。 -
若第一个
ClassAtom 的 IsCharacterClass 为false ，第二个ClassAtom 的 IsCharacterClass 为false ，且第一个ClassAtom 的 CharacterValue 严格大于第二个的 CharacterValue，则为语法错误。
-
若
ClassAtomNoDash 的 IsCharacterClass 为true 或ClassAtom 的 IsCharacterClass 为true 且该产生式具有 [UnicodeMode] 参数，则为语法错误。 -
若
ClassAtomNoDash 的 IsCharacterClass 为false ，ClassAtom 的 IsCharacterClass 为false ，且ClassAtomNoDash 的 CharacterValue 严格大于ClassAtom 的 CharacterValue，则为语法错误。
B.1.2.2 静态语义：CountLeftCapturingParensWithin 与 CountLeftCapturingParensBefore
在 CountLeftCapturingParensWithin 与 CountLeftCapturingParensBefore 的定义中，对 “
B.1.2.3 静态语义：IsCharacterClass
- 返回
false 。
B.1.2.4 静态语义：CharacterValue
- 返回 U+005C (REVERSE SOLIDUS) 的数值。
- 令 ch 为
ClassControlLetter 匹配的代码点。 - 令 i 为 ch 的数值。
- 返回 i 除以 32 的余数。
- 返回
LegacyOctalEscapeSequence 的 MV（见12.9.4.3 ）。
B.1.2.5 运行时语义：CompileSubpattern
CompileSubpattern 的语义按如下扩展：
B.1.2.6 运行时语义：CompileAssertion
B.1.2.7 运行时语义：CompileAtom
除
- 令 A 为包含单个字符
\U+005C (REVERSE SOLIDUS) 的CharSet 。 - 返回
CharacterSetMatcher (rer, A,false , direction)。
- 令 ch 为
ExtendedPatternCharacter 所表示的字符。 - 令 A 为包含字符 ch 的单元素
CharSet 。 - 返回
CharacterSetMatcher (rer, A,false , direction)。
B.1.2.8 运行时语义：CompileToCharSet
以下两条规则替换 CompileToCharSet 对应规则。
- 令 A 为第一个
ClassAtom 的 CompileToCharSet，参数 rer。 - 令 B 为第二个
ClassAtom 的 CompileToCharSet，参数 rer。 - 令 C 为
ClassContents 的 CompileToCharSet，参数 rer。 - 令 D 为
CharacterRangeOrUnion (rer, A, B)。 - 返回 D 与 C 的并集。
- 令 A 为
ClassAtomNoDash 的 CompileToCharSet，参数 rer。 - 令 B 为
ClassAtom 的 CompileToCharSet，参数 rer。 - 令 C 为
ClassContents 的 CompileToCharSet，参数 rer。 - 令 D 为
CharacterRangeOrUnion (rer, A, B)。 - 返回 D 与 C 的并集。
另外，向 CompileToCharSet 添加以下规则。
- 令 cv 为该
ClassEscape 的 CharacterValue。 - 令 c 为字符值为 cv 的字符。
- 返回包含单个字符 c 的
CharSet 。
- 返回包含单个字符
\U+005C (REVERSE SOLIDUS) 的CharSet 。
\c（其后未跟可接受控制字符）到达。B.1.2.8.1 CharacterRangeOrUnion ( rer, A, B )
The abstract operation CharacterRangeOrUnion takes arguments rer (a RegExp
- 若
HasEitherUnicodeFlag (rer) 为false ，则 - 返回
CharacterRange (A, B)。
B.1.2.9 静态语义：ParsePattern ( patternText, u, v )
- 若 v 为
true 且 u 为true ，则- 令 parseResult 为包含一个或多个
SyntaxError 对象的List 。
- 令 parseResult 为包含一个或多个
- 否则若 v 为
true ，则- 令 parseResult 为 ParseText(patternText,
Pattern )。[+UnicodeMode, +UnicodeSetsMode, +NamedCaptureGroups]
- 令 parseResult 为 ParseText(patternText,
- 否则若 u 为
true ，则- 令 parseResult 为 ParseText(patternText,
Pattern )。[+UnicodeMode, ~UnicodeSetsMode, +NamedCaptureGroups]
- 令 parseResult 为 ParseText(patternText,
- 否则，
- 返回 parseResult。
B.2 额外内建属性
当 ECMAScript
B.2.1 全局对象的额外属性
| 内在名称 | 全局名称 | ECMAScript 语言关联 |
|---|---|---|
|
|
escape
|
escape 函数 ( |
|
|
unescape
|
unescape 函数 ( |
B.2.1.1 escape ( string )
该函数是全局对象的一个属性。它计算一个字符串值的新版本，其中某些代码单元被十六进制转义序列替换。
当替换数值 ≤ 0x00FF 的代码单元时，使用形如 %xx 的两位转义序列。替换数值严格大于 0x00FF 的代码单元时，使用形如 %uxxxx 的四位转义序列。
它是 %escape% 内在对象。
调用时执行以下步骤：
- 将 string 设为 ?
ToString (string)。 - 令 len 为 string 的长度。
- 令 R 为空字符串。
- 令 unescapedSet 为 ASCII 单词字符与
"@*+-./" 的串联。 - 令 k 为 0。
- 当 k < len 重复，
- 返回 R。
该编码部分基于 RFC 1738 描述的编码，但本标准指定的全部编码如上所述，与 RFC 1738 内容无关。该编码不反映 RFC 3986 对 RFC 1738 的更改。
B.2.1.2 unescape ( string )
该函数是全局对象的一个属性。它计算一个字符串值的新版本，其中每个可能由 escape 函数引入的转义序列被其表示的代码单元替换。
它是 %unescape% 内在对象。
调用时执行以下步骤：
- 将 string 设为 ?
ToString (string)。 - 令 len 为 string 的长度。
- 令 R 为空字符串。
- 令 k 为 0。
- 当 k < len 重复，
- 令 C 为 string 中索引 k 处的代码单元。
- 若 C 是代码单元 0x0025 (PERCENT SIGN)，则
- 令 hexDigits 为空字符串。
- 令 optionalAdvance 为 0。
- 若 k + 5 < len 且 string 中索引 k + 1 处代码单元为 0x0075 (LATIN SMALL LETTER U)，则
- 将 hexDigits 设为 string 从 k + 2 到 k + 6 的子串。
- 将 optionalAdvance 设为 5。
- 否则若 k + 3 ≤ len，则
- 将 hexDigits 设为 string 从 k + 1 到 k + 3 的子串。
- 将 optionalAdvance 设为 2。
- 令 parseResult 为 ParseText(hexDigits,
HexDigits )。[~Sep] - 若 parseResult 是 Parse Node，则
- 令 n 为 parseResult 的 MV。
- 将 C 设为数值为 n 的代码单元。
- 将 k 设为 k + optionalAdvance。
- 将 R 设为 R 与 C 的串联。
- 将 k 设为 k + 1。
- 返回 R。
B.2.2 String.prototype 对象的额外属性
B.2.2.1 String.prototype.substr ( start, length )
该方法返回将
调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireObjectCoercible (O)。 - 令 S 为 ?
ToString (O)。 - 令 size 为 S 的长度。
- 令 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 夹取到 0 与 size 之间。
- 令 intEnd 为
min (intStart + intLength, size)。 - 返回 S 从 intStart 到 intEnd 的子串。
该方法有意设计为泛型；它不要求其
B.2.2.2 String.prototype.anchor ( name )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 返回 ?
CreateHTML (S,"a" ,"name" , name)。
B.2.2.2.1 CreateHTML ( string, tag, attribute, value )
The abstract operation CreateHTML takes arguments string (an ECMAScript language value), tag (a String), attribute (a String), and value (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 (string)。 - 令 S 为 ?
ToString (string)。 - 令 p1 为
"<" 与 tag 的串联。 - 若 attribute 不是空字符串，则
- 令 V 为 ?
ToString (value)。 - 令 escapedV 为与 V 相同的字符串值，除了 V 中每个代码单元 0x0022 (QUOTATION MARK) 被六个代码单元序列
""" 替换。 - 将 p1 设为以下串联：
- p1
- 代码单元 0x0020 (SPACE)
- attribute
- 代码单元 0x003D (EQUALS SIGN)
- 代码单元 0x0022 (QUOTATION MARK)
- escapedV
- 代码单元 0x0022 (QUOTATION MARK)
- 令 V 为 ?
- 令 p2 为 p1 与
">" 的串联。 - 令 p3 为 p2 与 S 的串联。
- 令 p4 为 p3、
"</" 、tag 与">" 的串联。 - 返回 p4。
B.2.2.3 String.prototype.big ( )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 返回 ?
CreateHTML (S,"big" ,"" ,"" )。
B.2.2.4 String.prototype.blink ( )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 返回 ?
CreateHTML (S,"blink" ,"" ,"" )。
B.2.2.5 String.prototype.bold ( )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 返回 ?
CreateHTML (S,"b" ,"" ,"" )。
B.2.2.6 String.prototype.fixed ( )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 返回 ?
CreateHTML (S,"tt" ,"" ,"" )。
B.2.2.7 String.prototype.fontcolor ( colour )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 返回 ?
CreateHTML (S,"font" ,"color" , colour)。
B.2.2.8 String.prototype.fontsize ( size )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 返回 ?
CreateHTML (S,"font" ,"size" , size)。
B.2.2.9 String.prototype.italics ( )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 返回 ?
CreateHTML (S,"i" ,"" ,"" )。
B.2.2.10 String.prototype.link ( url )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 返回 ?
CreateHTML (S,"a" ,"href" , url)。
B.2.2.11 String.prototype.small ( )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 返回 ?
CreateHTML (S,"small" ,"" ,"" )。
B.2.2.12 String.prototype.strike ( )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 返回 ?
CreateHTML (S,"strike" ,"" ,"" )。
B.2.2.13 String.prototype.sub ( )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 返回 ?
CreateHTML (S,"sub" ,"" ,"" )。
B.2.2.14 String.prototype.sup ( )
该方法被调用时执行以下步骤：
- 令 S 为
this 值。 - 返回 ?
CreateHTML (S,"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 年问题”。
该方法被调用时执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 若 t 为
NaN ，返回NaN 。 - 返回
YearFromTime (LocalTime (t)) -1900 𝔽。
B.2.3.2 Date.prototype.setYear ( year )
setFullYear 方法在几乎所有场景中更可取，因为它避免“2000 年问题”。
该方法被调用时执行以下步骤：
- 令 dateObject 为
this 值。 - 执行 ?
RequireInternalSlot (dateObject, [[DateValue]])。 - 令 t 为 dateObject.[[DateValue]]。
- 令 y 为 ?
ToNumber (year)。 - 若 t 为
NaN ，将 t 设为+0 𝔽；否则将 t 设为LocalTime (t)。 - 令 yyyy 为
MakeFullYear (y)。 - 令 d 为
MakeDay (yyyy,MonthFromTime (t),DateFromTime (t))。 - 令 date 为
MakeDate (d,TimeWithinDay (t))。 - 令 u 为
TimeClip (UTC (date))。 - 将 dateObject.[[DateValue]] 设为 u。
- 返回 u。
B.2.3.3 Date.prototype.toGMTString ( )
更推荐使用 toUTCString 方法。本方法主要为兼容旧代码而提供。
B.2.4 RegExp.prototype 对象的额外属性
B.2.4.1 RegExp.prototype.compile ( pattern, flags )
该方法被调用时执行以下步骤：
- 令 O 为
this 值。 - 执行 ?
RequireInternalSlot (O, [[RegExpMatcher]])。 - 若 pattern 是一个对象且具有 [[RegExpMatcher]] 内部槽，则
- 若 flags 不为
undefined ，抛出TypeError 异常。 - 令 P 为 pattern.[[OriginalSource]]。
- 令 F 为 pattern.[[OriginalFlags]]。
- 若 flags 不为
- 否则，
- 令 P 为 pattern。
- 令 F 为 flags。
- 返回 ?
RegExpInitialize (O, P, F)。
该方法使用新的模式与标志完全重新初始化
B.3 其他附加特性
B.3.1 带标签的函数声明
在 ECMAScript 2015 之前，
B.3.2 块级函数声明 Web 历史兼容语义
在 ECMAScript 2015 之前，规范未定义
-
在单个块内声明并仅在该块内引用函数。
-
一个或多个
FunctionDeclaration ，其BindingIdentifier 名称为 f，出现在封闭函数 g 的函数代码内，并嵌套在一个Block 中。 -
在 g 的函数代码内不存在其他非
var的 f 声明。 -
所有 f 作为
IdentifierReference 的出现均位于包含 f 声明的Block 的StatementList 内。
-
一个或多个
-
在单个
Block 中声明函数并可能使用，同时被不在该Block 内的内部函数引用。-
一个或多个
FunctionDeclaration ，其BindingIdentifier 名称为 f，出现在封闭函数 g 的函数代码内，且该声明嵌套在一个Block 中。 -
在 g 的函数代码内不存在其他非
var的 f 声明。 -
在包含 f 声明的
Block 的StatementList 内可以有 f 作为IdentifierReference 的出现。 -
在嵌套于 g 之内的另一个函数 h 中至少有一次 f 作为
IdentifierReference 的出现，且不存在其他 f 声明屏蔽 h 内对 f 的引用。 - 所有对 h 的调用都发生在 f 声明已被求值之后。
-
一个或多个
-
在单个块中声明函数并可能使用，同时也在后续块中被引用。
-
一个或多个
FunctionDeclaration ，其BindingIdentifier 名称为 f，出现在封闭函数 g 的函数代码内，并嵌套在一个Block 中。 -
在 g 的函数代码内不存在其他非
var的 f 声明。 -
在包含 f 声明的
Block 的StatementList 内可以有 f 作为IdentifierReference 的出现。 -
在 g 的函数代码中至少有一次 f 作为
IdentifierReference 的出现，其词法位置位于包含 f 声明的Block 之后。
-
一个或多个
第一种用例与 ECMAScript 2015 提供的
第二与第三种用例的 ECMAScript 2015 互操作性需要对
如果 ECMAScript 实现有报告诊断警告消息的机制，当代码包含应用这些兼容语义并对非兼容语义引入可观察差异的
该特性在以下点涉及特殊语义：
Block : { StatementList } 14.2.1 中的某条早期错误规则 SwitchStatement : switch ( Expression ) CaseBlock 14.12.1 中的某条早期错误规则 FunctionDeclarationInstantiation 中的步骤32.a BlockDeclarationInstantiation 中的步骤3.a.ii.1 BlockDeclarationInstantiation 中的步骤3.b.iii GlobalDeclarationInstantiation 中的步骤12 EvalDeclarationInstantiation 中的步骤13
B.3.3 IfStatement 语句子句中的 FunctionDeclarations
以下内容扩展了
该产生式仅在解析非严格代码时适用。被该产生式匹配的源码文本按如下处理：每个匹配出现的
B.3.4 Catch 块中的 VariableStatements
该特性中，var 声明。通过修改
运行时，此类绑定在 VariableDeclarationEnvironment 中实例化。它们不会遮蔽由 var 声明的 var 绑定。
该修改行为也适用于包含于 var 与 function 声明。通过修改
B.3.5 ForIn 语句头中的初始值设定项
以下内容扩展了
该产生式仅在解析非严格代码时适用。
- 返回
Statement 的 ContainsDuplicateLabels，参数 labelSet。
- 返回
Statement 的 ContainsUndefinedBreakTarget，参数 labelSet。
- 返回
Statement 的 ContainsUndefinedContinueTarget，参数 iterationSet 与 « »。
- 返回
false 。
- 令 names1 为
BindingIdentifier 的 BoundNames。 - 令 names2 为
Statement 的 VarDeclaredNames。 - 返回 names1 与 names2 的列表串联。
- 令 declarations1 为 «
BindingIdentifier »。 - 令 declarations2 为
Statement 的 VarScopedDeclarations。 - 返回 declarations1 与 declarations2 的列表串联。
- 令 bindingId 为
BindingIdentifier 的 StringValue。 - 令 lhs 为 ?
ResolveBinding (bindingId)。 - 若 IsAnonymousFunctionDefinition(
Initializer ) 为true ，则- 令 value 为 ? NamedEvaluation(
Initializer , 参数 bindingId)。
- 令 value 为 ? NamedEvaluation(
- 否则，
- 令 rhs 为 ? Evaluation(
Initializer )。 - 令 value 为 ?
GetValue (rhs)。
- 令 rhs 为 ? Evaluation(
- 执行 ?
PutValue (lhs, value)。 - 令 keyResult 为 ?
ForIn/OfHeadEvaluation (« »,Expression ,enumerate )。 - 返回 ? ForIn/OfBodyEvaluation(
BindingIdentifier ,Statement , keyResult,enumerate ,var-binding , labelSet)。
B.3.6 [[IsHTMLDDA]] 内部槽
typeof 运算符
本规范从不创建具有 [[IsHTMLDDA]] 内部槽的对象。然而，网页浏览器中的 document.all 对象 是一个带有该槽的document.all 外不应创建任何此类对象。
该特性在以下点涉及特殊语义：
ToBoolean 中的步骤3 IsLooselyEqual 中的步骤4 typeof求值语义中的步骤12
B.3.7 HostMakeJobCallback 中的非默认行为
B.3.8 HostEnsureCanAddPrivateElement 中的非默认行为
B.3.9 函数调用赋值目标的运行时错误
当函数调用（
当赋值目标是 = 或一个 ??=、&&=、||=）。
参见 AssignmentTargetType 的步骤
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 不能作为赋值运算符（13.15 ）的LeftHandSideExpression ，也不能作为UpdateExpression （13.4 ），亦或作为前缀自增（13.4.4 ）或前缀自减（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 代码进行声明绑定实例化（
19.2.1 ）。 -
如果在严格模式代码中对
this 求值，则该this 值不会被强制转换为对象。this 值为undefined 或null 时不会被转换为全局对象，原始值不会被转换为包装对象。通过函数调用（包括使用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 且其 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 宿主定义字段
Script
Candidate Executions 上的 [[HostSynchronizesWith]]：见
[[IsHTMLDDA]]：见
D.3 宿主定义对象
全局对象：见
D.4 运行作业
调用作业抽象闭包前的准备步骤与之后的清理步骤。见
D.5 奇异对象的内部方法
本规范中未指定的任意奇异对象在
D.6 内建对象与方法
任何本规范未定义的内建对象与方法，除非在
Annex E (informative) ECMAScript 2015 中的更正与澄清（可能的兼容性影响）
Date.prototype.toString 返回的值。ECMAScript 2015 规定结果为字符串
/。
String.prototype.match 与 String.prototype.replace 对于 pattern 参数为设置了 global 标志的 RegExp 值的情况的规范不正确。旧规范指出每次尝试匹配模式时，如果 lastIndex 未改变，则应加 1。正确行为是只有当模式匹配到空字符串时才加 1。
Array.prototype.sort 如何解释由 comparator 返回的
Annex F (informative) 引入与先前版本不兼容的新增与变更
Space_Separator (Zs) 类别（因此在 ECMAScript 2015 中视为空白）移动到 Format (Cf) 类别（自 Unicode 6.3.0 起）。这导致对空白敏感的方法表现不同。例如，之前版本 "\u180E".trim().length 为 0，在 ECMAScript 2016 及后为 1。此外，ECMAScript 2017 要求始终使用最新 Unicode 标准。
let 开头后跟 token [ 的
( token 紧跟 token 序列 let [ 则 let 视为
let [ 则 let 视为
in 关键字之前的
var 声明是早期错误。之前版本该变量声明会在外层变量环境中实例化，但声明的
eval 且其 eval 代码包含绑定与 var 或 FunctionDeclaration 声明，则抛出运行时
Object.freeze 的参数不是对象，按无自有属性的不可扩展
Object.getOwnPropertyDescriptor 的参数不是对象，尝试用
String.prototype.localeCompare 必须将 Unicode 标准下规范等价的字符串视为相同。之前版本允许忽略规范等价，使用按位比较。
String.prototype.trim 识别可能存在于 Unicode BMP 之外的空白代码点。然而截至 Unicode 7 尚无此类代码点。之前版本这些代码点不会被识别为空白。
Atomics.wake 重命名为 Atomics.notify 以避免与 Atomics.wait 混淆。
await 入队的作业数量减少，可能在 then() 调用与 await 表达式之间创建可观察到的解析顺序差异。
参考文献
-
IEEE 754-2019：IEEE Standard for Floating-Point Arithmetic。电气与电子工程师协会，纽约（2019）
Note IEEE 754-2008 与 IEEE 754-2019 之间没有影响 ECMA-262 规范的规范性变更。
- The Unicode Standard，可访问 <https://unicode.org/versions/latest>
- Unicode Technical Note #5: Canonical Equivalence in Applications，可访问 <https://unicode.org/notes/tn5/>
- Unicode Technical Standard #10: Unicode Collation Algorithm，可访问 <https://unicode.org/reports/tr10/>
- Unicode Standard Annex #15, Unicode Normalization Forms，可访问 <https://unicode.org/reports/tr15/>
- Unicode Standard Annex #18: Unicode Regular Expressions，可访问 <https://unicode.org/reports/tr18/>
-
Unicode Standard Annex #24: Unicode
ScriptProperty，可访问 <https://unicode.org/reports/tr24/> - Unicode Standard Annex #31, Unicode Identifiers and Pattern Syntax，可访问 <https://unicode.org/reports/tr31/>
- Unicode Standard Annex #44: Unicode Character Database，可访问 <https://unicode.org/reports/tr44/>
- Unicode Technical Standard #51: Unicode Emoji，可访问 <https://unicode.org/reports/tr51/>
- IANA Time Zone Database，可访问 <https://www.iana.org/time-zones>
- ISO 8601:2004(E) Data elements and interchange formats — Information interchange — Representation of dates and times
- RFC 1738 “Uniform Resource Locators (URL)”，可访问 <https://tools.ietf.org/html/rfc1738>
- RFC 2396 “Uniform Resource Identifiers (URI): Generic Syntax”，可访问 <https://tools.ietf.org/html/rfc2396>
- RFC 3629 “UTF-8, a transformation format of ISO 10646”，可访问 <https://tools.ietf.org/html/rfc3629>
- RFC 7231 “Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content”，可访问 <https://tools.ietf.org/html/rfc7231>
版本后记
本规范在 GitHub 上以一种称为 Ecmarkup 的纯文本源格式编写。Ecmarkup 是一种 HTML 与 Markdown 方言，提供框架与工具集，用于以纯文本编写 Ecma 规范，并将其处理为遵循本文档编辑惯例的全功能 HTML 呈现。Ecmarkup 构建并集成了多种其他格式与技术，包括用于定义语法的 Grammarkdown 与用于编写算法步骤的 Ecmarkdown。本规范的 PDF 呈现使用一个打印样式表生成，该样式表利用 CSS 分页媒体规范，并使用 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
© 2025 Ecma International
This draft document may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published, and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this section are included on all such copies and derivative works. However, this document itself may not be modified in any way, including by removing the copyright notice or references to Ecma International, except as needed for the purpose of developing any document or deliverable produced by Ecma International.
This disclaimer is valid only prior to final version of this document. After approval all rights on the standard are reserved by Ecma International.
The limited permissions are granted through the standardization phase and will not be revoked by Ecma International or its successors or assigns during this time.
This document and the information contained herein is provided on an "AS IS" basis and ECMA INTERNATIONAL DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY OWNERSHIP RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
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.