ECMAScript® 2024 语言规范

关于本规范

https://tc39.es/ecma262/ 上的文档是最准确和最新的ECMAScript规范。它包含了最新年度快照的内容以及任何已完成的提案(那些在提案流程中达到第4阶段并因此在多个实现中实现且将在下一次实际修订中包含的提案)自该快照以来的内容。

本文档可以作为单页多页查看。

为此规范做贡献

此规范在GitHub上由ECMAScript社区的帮助下开发。有多种方式可以为此规范的发展做出贡献:

有关如何创建此文档的更多信息,请参阅colophon

导言

此ecma标准定义了ECMAScript 2024语言。它是ECMAScript语言的第十五版 规范。自1997年第一版出版以来,ECMAScript已发展成为世界上 最广泛使用的通用编程语言。它最为人所知的是嵌入在网络中的语言 浏览器,但也被广泛用于服务器和嵌入式应用程序。

ECMAScript基于几种原始技术,最著名的是JavaScript(Netscape)和 JScript(微软)。该语言由Netscape的Brendan Eich发明,首次出现在该公司的 Navigator 2.0浏览器。它已出现在Netscape的所有后续浏览器和Netscape的所有浏览器中 Microsoft从Internet Explorer 3.0开始。

ECMAScript语言规范的开发始于1996年11月。这个的第一版 ECMA标准于1997年6月由ECMA大会通过。

该ECMA标准已提交给ISO/IEC JTC 1以供快速通道程序采用,并被批准为 国际标准ISO/IEC 16262,1998年4月。ECMA大会于1998年6月批准了第二个 ECMA-262版本,使其完全符合ISO/IEC 16262。第一个和第二个之间的变化 版本本质上是编辑性的。

标准第三版引入了强大的正则表达式、更好的字符串处理、新的控件 语句、try/catch异常处理、更严格的错误定义、数字输出的格式和次要 对未来语言增长的预期变化。ECMAScript标准的第三版被 1999年12月的ECMA大会,并于2002年6月作为ISO/IEC 16262:2002发布。

第三版发布后,ECMAScript与全球广泛采用 Web,它已成为基本上所有Web浏览器都支持的编程语言。重要的 开发ECMAScript第四版的工作已经完成。然而,这项工作没有完成,也没有出版 作为ECMAScript的第四版,但其中一些被纳入了第六版的开发。

ECMAScript第五版(作为ECMA-262 5th版发布)事实上已编纂 对浏览器实现中常见的语言规范的解释并添加了 支持自第三版出版以来出现的新功能。这些功能包括 访问器 属性,对象的反射创建和检查,属性的程序控制 属性,额外的数组操作功能,支持JSON对象编码格式,以及严格的 提供增强错误检查和程序安全性的模式。第五版被ECMA2009年12月大会采用。

第五版提交给ISO/IEC JTC 1采用快速通道程序,并被批准为国际标准ISO/IEC 16262:2011。ECMAScript标准的5.1版包含了一些小的修正,文本与ISO/IEC 16262:2011相同。5.1版于2011年6月被Ecma大会采纳。

第六版的集中开发始于2009年,当时第五版正在准备出版。然而,在此之前,自1999年第三版发布以来,已经进行了大量的实验和语言增强设计工作。从某种意义上说,第六版的完成是十五年努力的结晶。本版的目标包括提供对大型应用程序、库创建的更好支持,并将ECMAScript用作其他语言的编译目标。其主要增强功能包括模块、类声明、词法块作用域、迭代器和生成器、用于异步编程的Promises、解构模式和正确的尾调用。ECMAScript内置库扩展了对附加数据抽象的支持,包括地图、集合和二进制数值数组,并在字符串和正则表达式中增加了对Unicode补充字符的支持。内置库还通过子类化变得可扩展。第六版为常规的、增量的语言和库增强提供了基础。第六版于2015年6月被大会采纳。

ECMAScript 2016是Ecma TC39在新的年度发布节奏和开放开发流程下发布的第一个ECMAScript版本。从ECMAScript 2015源文档生成了一个纯文本源文档,作为在GitHub上进一步开发的基础。在这一标准的开发过程中,提交了数百个拉取请求和问题,代表了成千上万个错误修复、编辑修正和其他改进。此外,还开发了许多软件工具来帮助这一工作,包括Ecmarkup、Ecmarkdown和Grammarkdown。ES2016还包括对新幂运算符的支持,并在Array.prototype中添加了一个名为includes的新方法。

ECMAScript 2017引入了异步函数、共享内存和原子操作,以及一些较小的语言和库增强、错误修复和编辑更新。异步函数通过提供Promise返回函数的语法来改进异步编程体验。共享内存和原子操作引入了一种新的内存模型,允许多代理程序使用原子操作进行通信,即使在并行CPU上也能确保定义明确的执行顺序。它还包括Object上的新静态方法:Object.valuesObject.entriesObject.getOwnPropertyDescriptors

ECMAScript 2018通过AsyncIterator协议和异步生成器引入了对异步迭代的支持。它还包括四个新的正则表达式特性:dotAll标志、命名捕获组、Unicode属性转义和后行断言。最后,它还包括对象的剩余和扩展属性。

ECMAScript 2019引入了一些新的内置函数:Array.prototype上的flatflatMap用于扁平化数组,Object.fromEntries用于直接将Object.entries的返回值转化为新对象,以及String.prototype上的trimStarttrimEnd作为更好命名的替代方案,取代广泛实现但非标准的String.prototype.trimLefttrimRight内置函数。此外,它还包括一些语法和语义的较小更新。更新的语法包括可选的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,一个由宿主填充的对象,包含关于模块的上下文信息;以及为处理“nullish”值(undefinednull)引入的两个新语法特性:nullish合并,一个值选择操作符;以及可选链,一个属性访问和函数调用操作符,当要访问/调用的值为nullish时会短路。

ECMAScript 2021,第12版,引入了字符串的replaceAll方法;Promise.any,一个在输入值被实现时短路的Promise组合器;AggregateError,一种新错误类型,用于同时表示多个错误;逻辑赋值操作符(??=&&=||=);WeakRef,用于引用目标对象而不保留其免于垃圾回收,以及FinalizationRegistry,用于管理在目标对象被垃圾回收时执行的清理操作的注册和取消注册;数字字面量的分隔符(1_000);并且使Array.prototype.sort更加精确,减少了导致实现定义的排序顺序的不确定情况。

ECMAScript 2022,第13版,引入了顶层await,允许在模块顶层使用关键字;新的类元素:公共和私有实例字段、公共和私有静态字段、私有实例方法和访问器、以及私有静态方法和访问器;类中的静态块,用于每类评估初始化;#x in obj语法,用于测试对象上私有字段的存在;通过/d标志的正则表达式匹配索引,提供匹配子字符串的起始和结束索引;Error对象上的cause属性,用于记录错误中的因果链;用于字符串、数组和类型化数组at方法,允许相对索引;以及Object.hasOwnObject.prototype.hasOwnProperty的便捷替代。

ECMAScript 2023,第14版,引入了Array.prototypeTypedArray.prototype上的toSortedtoReversedwithfindLastfindLastIndex方法,以及Array.prototype上的toSpliced方法;增加了对文件开头#!注释的支持,以更好地促进可执行ECMAScript文件;并允许在弱集合中使用大多数符号作为键。

ECMAScript 2024,第15版,增加了调整和转移ArrayBuffers和SharedArrayBuffers大小的功能;添加了用于创建具有更高级功能的字符串集的RegExp/v标志;引入了用于构建Promise的便捷方法Promise.withResolvers、用于数据聚合的Object.groupByMap.groupBy方法、用于异步等待共享内存更改的Atomics.waitAsync方法,以及用于检查和确保字符串仅包含格式良好的Unicode的String.prototype.isWellFormedString.prototype.toWellFormed方法。

代表许多组织的数十个人在Ecma TC39中对这一版本的开发以及之前的版本做出了非常重要的贡献。此外,还出现了一个支持TC39的ECMAScript工作的活跃社区。这个社区审查了无数草案,提交了数千个错误报告,进行了实现实验,贡献了测试套件,并向全球开发者社区介绍了ECMAScript。不幸的是,不可能识别和感谢每一个为这项工作做出贡献的人和组织。

Allen Wirfs-Brock
ECMA-262,第六版项目编辑

Brian Terlson
ECMA-262,第七版至第十版项目编辑

Jordan Harband
ECMA-262,第十版至第十二版项目编辑

Shu-yu Guo
ECMA-262,第十二版至第十五版项目编辑

Michael Ficarra
ECMA-262,第十二版至第十五版项目编辑

Kevin Gibbons
ECMA-262,第十二版至第十五版项目编辑

1 范围

本标准定义了ECMAScript 2024通用编程语言。

2 一致性

符合ECMAScript规范的实现必须提供并支持本规范中描述的所有类型、值、对象、属性、函数和程序语法及语义。

符合ECMAScript规范的实现必须按照最新版本的Unicode标准和ISO/IEC 10646解释源文本输入。

提供支持不同语言和国家的语言和文化习俗的应用编程接口(API)的符合ECMAScript规范的实现必须实现ECMA-402最新版本中与本规范兼容的接口。

符合ECMAScript规范的实现可以提供本规范中未描述的其他类型、值、对象、属性和函数。特别是,符合ECMAScript规范的实现可以为本规范中描述的对象提供本规范中未描述的属性和值。

符合ECMAScript规范的实现可以支持本规范中未描述的程序和正则表达式语法。特别是,符合ECMAScript规范的实现可以支持使用本规范第12.7.2节中提到的任何“未来保留字”的程序语法。

符合ECMAScript规范的实现不得实现本规范第17.1节中列出的任何禁用扩展。

符合ECMAScript规范的实现不得重新定义任何不是实现定义实现近似宿主定义的设施。

符合ECMAScript规范的实现可以选择实现或不实现规范性可选的小节。如果实现了任何规范性可选行为,则必须实现包含的规范性可选条款中的所有行为。本规范中用彩色框中的“规范性可选”一词来表示规范性可选条款,如下所示。

2.1 示例规范性可选条款标题

示例条款内容。

符合ECMAScript规范的实现必须实现遗留小节,除非它们也被标记为规范性可选。遗留小节中指定的所有语言特性和行为都具有一个或多个不理想的特性。然而,它们在现有应用程序中的持续使用阻止了它们从本规范中删除。这些特性不被视为ECMAScript核心语言的一部分。程序员在编写新的ECMAScript代码时不应使用或假设这些特性和行为的存在。

2.2 示例遗留条款标题

示例条款内容。

2.3 示例遗留规范性可选条款标题

示例条款内容。

3 规范性引用

下列引用文件对于本文档的应用是必不可少的。对于有日期的引用,仅适用于所引用的版本。对于无日期的引用,适用于引用文件的最新版本(包括任何修正案)。

IEEE 754-2019IEEE 浮点算术标准

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 程序的计算环境不仅会提供本规范中描述的对象和其他设施,还会提供某些环境特定的对象,这些对象的描述和行为超出了本规范的范围,只是表明它们可能提供某些属性可以从 ECMAScript 程序中访问和调用的函数。

ECMAScript 最初设计为一种脚本语言,但现已广泛用作通用编程语言。脚本语言 是一种用于操作、定制和自动化现有系统功能的编程语言。在这些系统中,有用的功能已经通过用户界面可用,脚本语言是将这些功能暴露给程序控制的机制。这样,现有系统就提供了一个对象和设施的 宿主环境,从而完善了脚本语言的功能。脚本语言旨在供专业和非专业程序员使用。

ECMAScript 最初设计为一种 Web 脚本语言,提供一种机制来在浏览器中使网页生动起来,并作为基于 Web 的客户端-服务器架构的一部分执行服务器计算。ECMAScript 现在用于为各种 宿主环境 提供核心脚本功能。因此,本文件中规定的核心语言与任何特定的 宿主环境 无关。

ECMAScript 的使用已经超出了简单的脚本编写,它现在用于许多不同环境和规模的全方位编程任务。随着 ECMAScript 使用范围的扩大,它提供的功能和设施也在扩展。ECMAScript 现在是一种功能齐全的通用编程语言。

4.1 Web脚本

Web浏览器为客户端计算提供了一个ECMAScript 宿主环境,包括表示窗口、菜单、弹出窗口、对话框、文本区域、锚点、框架、历史记录、Cookies以及输入/输出的对象。此外,宿主环境还提供了一种将脚本代码附加到事件(如焦点更改、页面和图像加载、卸载、错误和中止、选择、表单提交和鼠标操作)的方法。脚本代码出现在HTML中,显示的页面是用户界面元素和固定和计算文本及图像的组合。脚本代码对用户交互有反应,因此不需要主程序。

Web服务器为服务器端计算提供了不同的宿主环境,包括表示请求、客户端和文件的对象;以及锁定和共享数据的机制。通过结合使用浏览器端和服务器端脚本,可以在客户端和服务器之间分配计算,同时为基于Web的应用程序提供定制的用户界面。

每个支持ECMAScript的Web浏览器和服务器都提供自己的宿主环境,从而完成ECMAScript的执行环境。

4.2 宿主和实现

为了帮助将ECMAScript集成到宿主环境中,本规范将某些功能的定义(例如,抽象操作)全部或部分地推迟到本规范之外的来源。在编辑上,本规范区分了以下几种推迟定义的方式。

实现是进一步定义附录D中列出的功能或那些标记为实现定义实现近似的功能的外部来源。在非正式使用中,实现是指具体的人工制品,例如特定的网络浏览器。

实现定义的功能是指将其定义推迟到外部来源而没有进一步的限定。本规范对特定行为没有做出任何建议,符合规范的实现可以在本规范提出的约束范围内选择任何行为。

实现近似的功能是指将其定义推迟到外部来源,同时建议一种理想行为。虽然符合规范的实现可以在本规范提出的约束范围内选择任何行为,但鼓励它们尽量接近理想。一些数学操作,例如Math.exp,属于实现近似

宿主是进一步定义附录D中列出的功能,但不进一步定义其他实现定义实现近似功能的外部来源。在非正式使用中,宿主是指以相同方式通过附录D与本规范接口的所有实现集,例如所有网络浏览器的集合。宿主通常是一个外部规范,例如WHATWG HTML (https://html.spec.whatwg.org/)。换句话说,宿主定义的功能通常在外部规范中进一步定义。

宿主挂钩 是一个由外部来源全部或部分定义的抽象操作。所有 宿主挂钩 必须列在附录 D 中。宿主挂钩 必须至少符合以下要求:

宿主定义 的功能是将其定义推迟到外部来源而没有进一步的限定,并列在附录 D 中。不是 宿主 的实现也可以提供 宿主定义 的功能定义。

宿主环境 是所有 宿主定义 功能的特定定义选择。宿主环境 通常包括允许获取输入和提供输出的对象或函数,作为 宿主定义 属性的一部分的 全局对象

本规范遵循始终使用最具体术语的编辑约定。例如,如果一个功能是 宿主定义 的,则不应称其为 实现定义

宿主和实现可以通过本规范中定义的语言类型、规范类型、抽象操作、语法生成、内在对象和内在符号与本规范接口。

4.3 ECMAScript 概述

以下是 ECMAScript 的非规范性概述,并未描述该语言的所有部分。该概述不属于标准的正式部分。

ECMAScript 是基于对象的:基本语言和宿主功能由对象提供,ECMAScript 程序是一个相互通信的对象集合。在 ECMAScript 中,对象 是具有零个或多个 属性 的集合,每个属性都有确定如何使用该属性的 特性 —— 例如,当属性的可写特性(Writable attribute)设置为 false 时,任何试图通过执行的 ECMAScript 代码分配不同值给该属性的操作都会失败。属性是包含其他对象、原始值函数 的容器。原始值是以下内置类型之一的成员:UndefinedNullBooleanNumberBigIntStringSymbol;对象是内置类型 Object 的成员;函数是可调用对象。通过属性与对象关联的函数称为 方法

ECMAScript 定义了一组 内置对象,完善了 ECMAScript 实体的定义。这些内置对象包括 全局对象;对语言的 运行时语义 基本的对象,包括 ObjectFunctionBooleanSymbol 及各种 Error 对象;表示和操作数值的对象,包括 MathNumberDate;处理文本的对象 StringRegExp;值的索引集合的对象,包括 Array 和九种不同类型的元素具有特定数值表示的 Typed Arrays;键控集合,包括 MapSet 对象;支持结构化数据的对象,包括 JSON 对象、ArrayBufferSharedArrayBufferDataView;支持控制抽象的对象,包括生成器函数和 Promise 对象;以及反射对象,包括 ProxyReflect

ECMAScript 还定义了一组内置 运算符。ECMAScript 运算符包括各种一元运算符、乘法运算符、加法运算符、位移运算符、关系运算符、相等运算符、二进制位运算符、二进制逻辑运算符、赋值运算符和逗号运算符。

大型 ECMAScript 程序由 模块 支持,允许程序划分为多个语句和声明的序列。每个模块明确标识其使用的需要由其他模块提供的声明,以及哪些声明可供其他模块使用。

ECMAScript 语法故意类似于 Java 语法。ECMAScript 语法被放宽,以使其作为一种易于使用的脚本语言。例如,变量不需要声明其类型,属性也没有关联类型,定义的函数也不需要在调用之前出现在文本上。

4.3.1 对象

尽管 ECMAScript 包含类定义的语法,但 ECMAScript 对象并非如 C++、Smalltalk 或 Java 中的类为基础。相反,对象可以通过多种方式创建,包括字面量表示法或 构造函数,这些构造函数创建对象,然后通过为其属性分配初始值来初始化全部或部分对象。每个 构造函数 都是一个具有名为 "prototype" 属性的函数,该属性用于实现 基于原型的继承共享属性。对象通过在 new 表达式中使用 构造函数 创建;例如,new Date(2009, 11) 创建一个新的 Date 对象。不使用 new 调用 构造函数 会产生不同的结果,这取决于 构造函数。例如,Date() 生成当前日期和时间的字符串表示,而不是对象。

每个由 构造函数 创建的对象都有一个隐式引用(称为对象的 原型),指向其 构造函数"prototype" 属性的值。此外,原型可能有一个非 null 的隐式引用指向其原型,依此类推;这称为 原型链。当引用对象中的属性时,该引用是指向原型链中第一个包含该名称属性的对象中的属性。换句话说,首先检查直接提到的对象是否包含该属性;如果该对象包含命名属性,则该引用指向的就是该属性;如果该对象不包含命名属性,则接下来检查该对象的原型;依此类推。

图 1:对象/原型关系
许多框和箭头的图片。

在基于类的面向对象语言中,通常状态由实例承载,方法由类承载,并且继承仅限于结构和行为。而在 ECMAScript 中,状态和方法由对象承载,而结构、行为和状态都是继承的。

所有不直接包含其原型所包含的特定属性的对象共享该属性及其值。图 1 说明了这一点:

CF 是一个 构造函数(也是一个对象)。通过使用 new 表达式创建了五个对象:cf1cf2cf3cf4cf5。这些对象每个都包含名为 "q1""q2" 的属性。虚线表示隐式原型关系;例如,cf3 的原型是 CFp构造函数 CF 本身有两个属性,分别为 "P1""P2",它们在 CFpcf1cf2cf3cf4cf5 中不可见。CFp 中名为 "CFP1" 的属性由 cf1cf2cf3cf4cf5 共享(但不包括 CF),以及 CFp 的隐式原型链中除 "q1""q2""CFP1" 之外的任何属性。注意,CFCFp 之间没有隐式原型链接。

与大多数基于类的对象语言不同,可以通过分配值动态地向对象添加属性。也就是说,构造函数 不需要命名或分配所有或任何构造对象的属性。在上图中,可以通过向 CFp 中的属性分配新值,为 cf1cf2cf3cf4cf5 添加一个新的共享属性。

尽管 ECMAScript 对象本质上不是基于类的,但根据 构造函数、原型对象和方法的共同模式定义类样抽象通常是方便的。ECMAScript 内置对象本身遵循这样的类样模式。从 ECMAScript 2015 开始,ECMAScript 语言包括语法类定义,允许程序员简洁地定义符合内置对象使用的相同类样抽象模式的对象。

4.3.2 ECMAScript 的严格变体

ECMAScript 语言认识到某些用户可能希望限制其使用语言中某些功能的可能性。他们可能出于安全考虑,避免他们认为容易出错的功能,获得增强的错误检查,或出于其他原因。为了支持这种可能性,ECMAScript 定义了语言的严格变体。语言的严格变体排除了一些常规 ECMAScript 语言的特定语法和语义特性,并修改了某些特性的详细语义。严格变体还指定了在非严格形式的语言未指定为错误的情况下必须通过抛出错误异常来报告的其他错误条件。

ECMAScript 的严格变体通常称为语言的严格模式。严格模式的选择和 ECMAScript 严格模式语法和语义的使用明确在单个 ECMAScript 源文本 单元级别进行,如 11.2.2 中所述。由于在语法源文本单元级别选择严格模式,因此严格模式仅对该源文本单元内具有局部效果的限制。严格模式不会限制或修改必须在多个源文本单元之间一致操作的 ECMAScript 语义。完整的 ECMAScript 程序可以由严格模式和非严格模式 ECMAScript 源文本 单元组成。在这种情况下,严格模式仅在实际执行在严格模式源文本单元中定义的代码时才适用。

为了符合本规范,ECMAScript 实现必须实现完整的无限制 ECMAScript 语言和本规范定义的 ECMAScript 语言的严格变体。此外,实现必须支持将无限制和严格模式源文本单元组合成一个单一的组合程序。

4.4 术语和定义

在本文件中,适用以下术语和定义。

4.4.1 实现近似 (implementation-approximated)

一个 实现近似 设施是由外部来源全部或部分定义的,但在本规范中有推荐的理想行为。

4.4.2 实现定义 (implementation-defined)

一个 实现定义 设施是由外部来源全部或部分定义的。

4.4.3 宿主定义 (host-defined)

实现定义 相同。

编辑说明,参见 4.2 条款。

4.4.4 类型 (type)

数据值集合,定义见 第 6 章

4.4.5 原始值 (primitive value)

是 Undefined、Null、Boolean、Number、BigInt、Symbol 或 String 类型中的一个成员,定义见 第 6 章

原始值是在语言实现的最低层直接表示的数据。

4.4.6 对象 (object)

Object 类型的成员。

对象是属性的集合,并且有一个单一的原型对象。原型可以是 null

4.4.7 构造函数 (constructor)

函数对象,用于创建和初始化对象。

构造函数的 prototype 属性的值是一个原型对象,用于实现继承和共享属性。

4.4.8 原型 (prototype)

为其他对象提供共享属性的对象。

当一个 构造函数 创建一个对象时,该对象隐式地引用了该构造函数的 prototype 属性,用于解析属性引用。构造函数的 prototype 属性可以通过程序表达式 constructor.prototype 引用,并且添加到对象原型中的属性通过继承在所有共享该原型的对象中共享。或者,可以使用 Object.create 内置函数创建具有显式指定原型的新对象。

4.4.9 普通对象 (ordinary object)

具有所有对象必须支持的基本内部方法默认行为的对象

4.4.10 特殊对象 (exotic object)

在一个或多个基本内部方法上不具有默认行为的对象

任何不是 普通对象 的对象都是 特殊对象

4.4.11 标准对象 (standard object)

其语义由本规范定义的对象

4.4.12 内置对象 (built-in object)

由 ECMAScript 实现指定和提供的对象

标准内置对象在本规范中定义。ECMAScript 实现可以指定和提供其他种类的内置对象。

4.4.13 未定义值 (undefined value)

当变量未被赋值时使用的原始值

4.4.14 Undefined 类型 (Undefined type)

唯一值为 undefined 的类型

4.4.15 空值 (null value)

表示故意缺少任何对象值的原始值

4.4.16 Null 类型 (Null type)

唯一值为 null 的类型

4.4.17 布尔值 (Boolean value)

属于 Boolean 类型 的成员

只有两个布尔值,truefalse

4.4.18 Boolean 类型 (Boolean type)

由原始值 truefalse 组成的类型

4.4.19 Boolean 对象 (Boolean object)

属于 对象类型 的成员,是标准内置 Boolean 构造函数 的实例

Boolean 对象是通过在 new 表达式中使用 Boolean 构造函数 并提供一个布尔值作为参数来创建的。生成的对象具有一个内部插槽,其值为布尔值。可以将 Boolean 对象强制转换为布尔值。

4.4.20 字符串值 (String value)

原始值,是一个 有限 的有序序列,包含零个或多个 16 位无符号 整数

字符串值是 字符串类型 的成员。序列中的每个 整数 值通常代表 UTF-16 文本的单个 16 位单元。然而,ECMAScript 对这些值没有任何限制或要求,除了它们必须是 16 位无符号 整数

4.4.21 字符串类型 (String type)

所有可能的字符串值的集合

4.4.22 字符串对象 (String object)

属于 对象类型 的成员,是标准内置字符串 构造函数 的实例

字符串对象是通过在 new 表达式中使用字符串 构造函数 并提供一个字符串值作为参数来创建的。生成的对象具有一个内部插槽,其值为字符串值。可以通过将字符串 构造函数 作为函数调用来将字符串对象强制转换为字符串值 (22.1.1.1)。

4.4.23 Number 值 (Number value)

对应双精度 64 位二进制格式 IEEE 754-2019 值的原始值

Number 值是 Number 类型 的成员,是数字的直接表示。

4.4.24 Number 类型 (Number type)

所有可能的 Number 值的集合,包括特殊的“非数值” (NaN) 值、正无穷大和负无穷大

4.4.25 Number 对象 (Number object)

属于 对象类型 的成员,是标准内置 Number 构造函数 的实例

Number 对象是通过在 new 表达式中使用 Number 构造函数 并提供一个 Number 值作为参数来创建的。生成的对象具有一个内部插槽,其值为 Number 值。可以通过将 Number 构造函数 作为函数调用来将 Number 对象强制转换为 Number 值 (21.1.1.1)。

4.4.26 无穷大 (Infinity)

表示正无穷大的 Number 值

4.4.27 NaN

表示 IEEE 754-2019 “非数值” 的 Number 值

4.4.28 BigInt 值 (BigInt value)

对应任意精度 整数 值的原始值

4.4.29 BigInt 类型 (BigInt type)

所有可能的 BigInt 值的集合

4.4.30 BigInt 对象 (BigInt object)

属于 对象类型 的成员,是标准内置 BigInt 构造函数 的实例

4.4.31 Symbol 值 (Symbol value)

表示唯一的、非字符串对象 属性键 的原始值

4.4.32 Symbol 类型 (Symbol type)

所有可能的 Symbol 值的集合

4.4.33 Symbol 对象 (Symbol object)

属于 对象类型 的成员,是标准内置 Symbol 构造函数 的实例

4.4.34 函数 (function)

属于 对象类型 的成员,可以作为子例程调用

除了它的属性之外,函数还包含可执行代码和状态,这些代码和状态决定了它在调用时的行为。函数的代码可以是 ECMAScript 编写的,也可以不是。

4.4.35 内置函数 (built-in function)

内置对象,是一个函数

内置函数的例子包括 parseIntMath.exp宿主 或实现可能提供本规范中未描述的其他内置函数。

4.4.36 内置构造函数 (built-in constructor)

内置函数,是一个 构造函数

内置 构造函数 的例子包括 ObjectFunction宿主 或实现可能提供本规范中未描述的其他内置 构造函数

4.4.37 属性 (property)

对象的一部分,关联一个键(字符串值或 Symbol 值)和一个值

根据属性的形式,值可以直接表示为数据值(原始值、对象或 函数对象)或通过一对访问器函数间接表示。

4.4.38 方法 (method)

作为属性值的函数

当函数作为对象的方法调用时,对象会作为其 this 值传递给函数。

4.4.39 内置方法 (built-in method)

作为内置函数的方法

标准内置方法在本规范中定义。宿主 或实现可能提供本规范中未描述的其他内置方法。

4.4.40 属性 (attribute)

定义属性某些特性的内部值

4.4.41 自有属性 (own property)

直接包含在对象中的属性

4.4.42 继承属性 (inherited property)

对象的属性,不是自有属性,但它是对象原型的属性(自有属性或继承属性)

4.5 本规范的组织结构 (Organization of This Specification)

本规范的其余部分组织如下:

5 节定义了整个规范中使用的符号约定。

6 节到第 10 节定义了 ECMAScript 程序运行的执行环境。

11 节到第 17 节定义了实际的 ECMAScript 编程语言,包括其语法编码和所有语言特性的执行语义。

18 节到第 28 节定义了 ECMAScript 标准库。它们包括所有可供 ECMAScript 程序在执行时使用的标准对象的定义。

29 节描述了对 SharedArrayBuffer 支持的内存的访问和 Atomics 对象的方法的内存一致性模型。

5 符号约定

5.1 句法和词法语法

5.1.1 上下文无关文法

一个上下文无关文法由若干生成式组成。每个生成式的左侧都有一个抽象符号,称为非终结符,右侧则是一系列零个或多个非终结符和终结符符号。对于每个文法,终结符号来自指定的字母表。

链生成式是右侧有且只有一个非终结符号以及零个或多个终结符号的生成式。

从一个由单个特殊非终结符组成的句子开始,称为目标符号,给定的上下文无关文法指定了一种语言,即通过不断将序列中的任何非终结符替换为其左侧为该非终结符的生成式的右侧所能产生的终结符号的(可能是无限的)集合。

5.1.2 词法和正则表达式文法

ECMAScript 的词法文法12 章中给出。该文法的终结符是符合 SourceCharacter 规则的 Unicode 代码点,这些规则定义在 11.1 章中。它定义了一组生成式,从 目标符号 InputElementDivInputElementTemplateTailInputElementRegExpInputElementRegExpOrTemplateTailInputElementHashbangOrRegExp 开始,描述了如何将这些代码点的序列转换为输入元素的序列。

除空白和注释外的输入元素构成 ECMAScript 语法文法的终结符,称为 ECMAScript 标记。这些标记是 ECMAScript 语言的 保留字、标识符、字面量和标点符号。此外,行终止符虽然不被视为标记,但也成为输入元素流的一部分,并指导自动分号插入过程(12.10)。简单的空白和单行注释被丢弃,不会出现在语法文法的输入元素流中。如果一个 MultiLineComment(即形式为 /**/ 的注释,不论是否跨越多行)不包含行终止符,则它同样会被丢弃;但如果 MultiLineComment 包含一个或多个行终止符,则它将被一个单一的行终止符替代,成为语法文法输入元素流的一部分。

ECMAScript 的正则表达式文法22.2.1 章中给出。该文法的终结符也是由 SourceCharacter 定义的代码点。它定义了一组生成式,从 目标符号 Pattern 开始,描述了如何将代码点的序列转换为正则表达式模式。

词法和正则表达式文法的生成式通过两个冒号 “::” 作为分隔标点来区分。这两种文法共享一些生成式。

5.1.3 数值字符串文法

7.1.4.1 章节中出现了数值字符串文法。它的终结符是 SourceCharacter,用于从 目标符号 StringNumericLiteral 开始,将字符串翻译成数值(这与 数字字面量的词法文法 类似但不同)。

数值字符串文法的生成式通过三个冒号 “:::” 作为标点符号来区分,且从不用于解析源文本。

5.1.4 句法文法

ECMAScript 的 句法文法第13节第16节 中给出。该文法的终结符是由词法文法定义的 ECMAScript 标记(5.1.2)。它定义了一组生成式,从两个可选的 目标符号 ScriptModule 开始,描述了标记序列如何形成 ECMAScript 程序的句法上正确的独立组件。

当要将代码点流解析为 ECMAScript ScriptModule 时,首先通过重复应用词法文法将其转换为输入元素流;然后通过一次应用句法文法来解析该输入元素流。如果输入元素流中的标记不能解析为目标非终结符(ScriptModule)的单个实例,并且没有剩余标记,则输入流在句法上是错误的。

解析成功时,会构造一个 解析树,这是一个以根为起点的树结构,其中每个节点是一个 解析节点。每个解析节点都是文法中某个符号的实例;它表示可以从该符号派生的源文本范围。表示整个源文本的解析树的根节点是解析的 目标符号 的一个实例。当解析节点是非终结符的实例时,它也是以该非终结符作为左侧的某个生成式的实例。此外,它具有零个或多个子节点,每个符号一个:每个子节点都是相应符号的解析节点实例。

解析器的每次调用都会实例化新的解析节点,并且在解析相同源文本时永不重用。解析节点被认为是相同的解析节点,当且仅当它们表示相同的源文本范围,是相同文法符号的实例,并且是由同一次解析器调用生成的。

注 1

多次解析相同的字符串会导致不同的解析节点。例如,考虑:

let str = "1 + 1;";
              eval(str);
              eval(str);

每次调用 eval 都会将 str 的值转换为 ECMAScript 源文本 并执行一个独立的解析,创建自己独立的解析节点树。这些树是不同的,即使每次解析操作的源文本都来自相同的字符串值。

注 2
解析节点是规范产物,实现并不要求使用类似的数据结构。

句法文法的生成式通过使用一个冒号 “:” 作为标点符号来区分。

第13节第16节 中所述的句法文法并不完全说明哪些标记序列被接受为正确的 ECMAScript ScriptModule。某些附加的标记序列也被接受,即那些如果只在某些地方添加分号(如在行终止符之前)就能描述的序列。此外,如果行终止符出现在某些“尴尬”的地方,则由文法描述的某些标记序列也不被认为是可接受的。

在某些情况下,为避免歧义,句法文法使用了泛化生成式,允许不形成有效 ECMAScript ScriptModule 的标记序列。例如,这种技术用于对象字面量和对象解构模式。在这种情况下,提供了更严格的补充文法,进一步限制了可接受的标记序列。通常,早期错误 规则会声明,在某些上下文中,“P 必须覆盖 N”,其中 P 是解析节点(泛化生成式的实例),N 是补充文法中的非终结符。这意味着:

  1. 使用 N 作为目标符号重新解析最初由 P 匹配的标记序列。如果 N 采用文法参数,则它们设置为与最初解析 P 时相同的值。
  2. 如果标记序列可以解析为 N 的单个实例,并且没有剩余标记,则:
    1. 我们将该 N 的实例(解析节点,在给定 P 的情况下是唯一的)称为“由 P 覆盖的 N”。
    2. N 及其派生生成式的所有早期错误规则也适用于由 P 覆盖的 N
  3. 否则(如果解析失败),则为早期语法错误。

5.1.5 语法标记

5.1.5.1 终结符号

在ECMAScript语法中,一些终结符号显示为固定宽度字体。这些符号应当按照书写的样子准确出现在源文本中。以这种方式指定的所有终结符号码点都应被理解为来自基本拉丁块的适当Unicode码点,而不是来自其他Unicode范围的类似看起来的码点。终结符号中的一个码点不能通过\ UnicodeEscapeSequence来表达。

在其终结符号是单个Unicode码点的语法中(即,词汇、RegExp和数值字符串语法),连续的多个固定宽度码点出现在一个生产中,是一种简单的速记,用于表示相同的码点序列,写作独立的终结符号。

例如,产生式:

HexIntegerLiteral :: 0x HexDigits

是以下的简写形式:

HexIntegerLiteral :: 0 x HexDigits

相比之下,在句法语法中,连续的固定宽度码点构成一个单独的终结符号。

终结符号还有其他两种形式:

5.1.5.2 非终结符号与生产规则

非终结符号显示为斜体类型。非终结(也称为“产生式”)的定义是由被定义的非终结名称开始,后面跟着一个或多个冒号(冒号的数量表示生产所属的语法)。然后,非终结的一个或多个备选右侧在后续行中跟随。例如,句法定义:

WhileStatement : while ( Expression ) Statement

说明非终结WhileStatement 表示关键字while,后跟一个左括号,然后是一个Expression, 后跟一个右括号,然后是一个Statement。这里出现的ExpressionStatement本身也是非终结。作为另一个例子,句法定义:

ArgumentList : AssignmentExpression ArgumentList , AssignmentExpression

说明一个ArgumentList 可能代表一个单独的AssignmentExpression或一个ArgumentList, 后跟一个逗号,然后是一个AssignmentExpression。 这个ArgumentList的定义是递归的,即它是以自身为基础定义的。结果是,一个ArgumentList可能包含任意正数个参数,这些参数由逗号分隔,每个参数表达式都是一个AssignmentExpression。这种非终结的递归定义是常见的。

5.1.5.3 可选符号

下标后缀“opt”,可出现在终结符或非终结符之后,表示一个可选符号。包含可选符号的替代项实际上指定了两个右侧,一个省略可选元素,一个包含它。这意味着:

VariableDeclaration : BindingIdentifier Initializeropt

是一个方便的缩写:

VariableDeclaration : BindingIdentifier BindingIdentifier Initializer

和:

ForStatement : for ( LexicalDeclaration Expressionopt ; Expressionopt ) Statement

是一个方便的缩写:

ForStatement : for ( LexicalDeclaration ; Expressionopt ) Statement for ( LexicalDeclaration Expression ; Expressionopt ) Statement

反过来又是一个缩写:

ForStatement : for ( LexicalDeclaration ; ) Statement for ( LexicalDeclaration ; Expression ) Statement for ( LexicalDeclaration Expression ; ) Statement for ( LexicalDeclaration Expression ; Expression ) Statement

因此,在这个例子中,非终结符ForStatement 实际上有四个备选右侧。

5.1.5.4 语法参数

一个产生式可能会被形式为“[parameters]”的下标注释参数化,它可能作为由产生式定义的非终结符号的后缀出现。“parameters”可以是单个名称或逗号分隔的名称列表。参数化的产生式是一组产生式的简写,这些产生式定义了所有参数名称的组合,这些名称由下划线前缀,并附加到参数化的非终结符号上。这意味着:

StatementList[Return] : ReturnStatement ExpressionStatement

是以下的缩写:

StatementList : ReturnStatement ExpressionStatement StatementList_Return : ReturnStatement ExpressionStatement

并且:

StatementList[Return, In] : ReturnStatement ExpressionStatement

是以下的缩写:

StatementList : ReturnStatement ExpressionStatement StatementList_Return : ReturnStatement ExpressionStatement StatementList_In : ReturnStatement ExpressionStatement StatementList_Return_In : ReturnStatement ExpressionStatement

多个参数会产生组合数量的产生式,但并不是所有的产生式都必须在完整的语法中被引用。

产生式右侧的非终结符号的引用也可以被参数化。例如:

StatementList : ReturnStatement ExpressionStatement[+In]

等同于说:

StatementList : ReturnStatement ExpressionStatement_In

以及:

StatementList : ReturnStatement ExpressionStatement[~In]

相当于:

StatementList : ReturnStatement ExpressionStatement

一个非终结符的引用可能同时具有参数列表和“opt”后缀。例如:

VariableDeclaration : BindingIdentifier Initializer[+In]opt

是以下的缩写:

VariableDeclaration : BindingIdentifier BindingIdentifier Initializer_In

在右侧非终结符引用中,用“?”前缀参数名称,使得该参数值依赖于当前产生式左侧符号引用中参数名称的出现。例如:

VariableDeclaration[In] : BindingIdentifier Initializer[?In]

是以下的缩写:

VariableDeclaration : BindingIdentifier Initializer VariableDeclaration_In : BindingIdentifier Initializer_In

如果右侧的备选方案以“[+parameter]”为前缀,那么这个备选方案只在引用产生式的非终结符号时使用了指定的参数才可用。如果右侧的备选方案以“[~parameter]”为前缀,那么这个备选方案只在引用产生式的非终结符号时使用指定的参数才可用。这意味着:

StatementList[Return] : [+Return] ReturnStatement ExpressionStatement

是以下的缩写:

StatementList : ExpressionStatement StatementList_Return : ReturnStatement ExpressionStatement

并且:

StatementList[Return] : [~Return] ReturnStatement ExpressionStatement

是以下的缩写:

StatementList : ReturnStatement ExpressionStatement StatementList_Return : ExpressionStatement

5.1.5.5 one of

当语法定义中的冒号后面跟着“one of”这几个词时,它们表示接下来的每一行上的终结符号都是一个替代定义。例如,ECMAScript的词法语法包含以下产生式:

NonZeroDigit :: one of 1 2 3 4 5 6 7 8 9

这只是一个方便的缩写,完整形式为:

NonZeroDigit :: 1 2 3 4 5 6 7 8 9

5.1.5.6 [empty]

如果产生式的右侧出现“[empty]”这一短语,它表示该产生式的右侧不包含任何终结符号或非终结符号。

5.1.5.7 前瞻限制

如果短语“[lookahead = seq]”出现在产生式的右侧,它表示只有当令牌序列seq是紧随其后的输入令牌序列的前缀时,才能使用该产生式。类似地,“[lookahead ∈ set]”,其中set是一个非空的有限令牌序列集合,表示只有当set中的某个元素是紧随其后的令牌序列的前缀时,才能使用该产生式。为了方便起见,该集合也可以写作非终结符,这种情况下它代表所有非终结符可以扩展到的令牌序列的集合。如果非终结符可以扩展到无限多个不同的令牌序列,则被认为是编辑错误。

这些条件可以被否定。“[lookahead ≠ seq]”表示只有当seq不是紧随其后的输入令牌序列的前缀时,才能使用包含的产生式,“[lookahead ∉ set]”表示只有当set中的没有元素是紧随其后的令牌序列的前缀时,才能使用该产生式。

例如,给定以下定义:

DecimalDigit :: one of 0 1 2 3 4 5 6 7 8 9 DecimalDigits :: DecimalDigit DecimalDigits DecimalDigit

定义如下:

LookaheadExample :: n [lookahead ∉ { 1, 3, 5, 7, 9 }] DecimalDigits DecimalDigit [lookahead ∉ DecimalDigit]

匹配字母n,后跟一个或多个十进制数字,第一个数字为偶数,或一个十进制数字,后面没有跟随另一个十进制数字。

注意,当这些短语在句法语法中使用时,可能无法明确识别紧随其后的令牌序列,因为确定后续的令牌需要知道在后续位置使用哪个词法目标符号。因此,当这些短语在句法语法中使用时,如果词法目标符号的选择可能会改变seq是否会成为生成的令牌序列的前缀,那么在前视限制中出现令牌序列seq(包括作为序列集合的一部分)被认为是编辑错误。

5.1.5.8 [no LineTerminator here]

如果在句法文法的生成式右侧出现短语“[no LineTerminator here]”,则表示该生成式是受限生成式:如果在指示位置的输入流中出现 LineTerminator,则不允许使用该生成式。例如,生成式:

ThrowStatement : throw [no LineTerminator here] Expression ;

表示如果在脚本中 throw 标记和 Expression 之间出现 LineTerminator,则不允许使用该生成式。

除非受限生成式禁止出现 LineTerminator,否则在输入元素流中的任何两个连续标记之间出现任何数量的 LineTerminator 都不会影响脚本的句法可接受性。

5.1.5.9 but not

生成式的右侧可以使用短语“but not”并指示要排除的扩展来指定不允许某些扩展。例如,生成式:

Identifier :: IdentifierName but not ReservedWord

意味着非终结符 Identifier 可以被替换为任何可以替换 IdentifierName 的代码点序列,前提是相同的代码点序列不能替换 ReservedWord

5.1.5.10 描述性短语

最后,在一些列出所有替代方案不切实际的情况下,使用无衬线字体的描述性短语来描述少数非终结符号:

SourceCharacter :: 任意 Unicode 代码点
<

5.2 算法约定

该规范经常使用编号列表来指定算法中的步骤。这些算法用于精确指定 ECMAScript 语言结构的所需语义。这些算法并不意味着必须使用任何特定的实现技术。实际上,可能有更有效的算法可用于实现给定的功能。

算法可以明确地用一个有序的、逗号分隔的别名序列参数化,这些别名在算法步骤中可用于引用在该位置传入的参数。可选参数用方括号([ , name ])表示,与算法步骤中的必需参数没有区别。参数列表的末尾可以出现一个剩余参数,以省略号(, ...name)表示。剩余参数捕获所有在必需参数和可选参数之后提供的参数,这些参数被编入一个 列表。如果没有这样的额外参数,那么这个 列表 将为空。

算法步骤可以细分为顺序子步骤。子步骤是缩进的,并且本身可以进一步分为缩进的子步骤。用大纲编号约定来标识子步骤,第一层子步骤用小写字母标记,第二层子步骤用小写罗马数字标记。如果需要超过三个层级,这些规则将重复,第四层使用数字标签。例如:

  1. 顶层步骤
    1. 子步骤。
    2. 子步骤。
      1. 子子步骤。
        1. 子子子步骤
          1. 子子子子步骤
            1. 子子子子子步骤

步骤或子步骤可以作为一个“if”谓词编写,条件化其子步骤。在这种情况下,只有当谓词为真时,子步骤才会被应用。如果步骤或子步骤以“else”一词开头,它是一个谓词,是与同一层级前一个“if”谓词步骤的否定。

步骤可以指定其子步骤的迭代应用。

以“Assert(断言):”开头的步骤断言其算法的不变条件。这种断言用来明确那些否则会是隐含的算法不变性。这样的断言不增加额外的语义要求,因此实现无需检查。它们仅用于澄清算法。

算法步骤可以使用“Let x be someValue”的形式声明任何值的命名别名。这些别名类似于引用,xsomeValue都指向相同的底层数据,对任何一个的修改都对双方可见。如果算法步骤想要避免这种类似引用的行为,应该明确地复制右侧值:“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语法之一的一个或多个产生式相关联。具有多个替代定义的产生式通常会为每个替代定义有一个独特的算法。当一个算法与一个语法产生式相关联时,它可以引用产生式替代的终结符和非终结符,就好像它们是算法的参数一样。在这种方式下使用时,非终结符引用在解析源文本时匹配的实际替代定义。由语法产生式匹配的源文本或由其衍生的解析节点是从参与匹配的第一个终结符开始到参与匹配的最后一个终结符结束的源文本部分。

当一个算法与一个产生式替代相关联时,该替代通常显示时不包括任何“[ ]”语法注释。这样的注释只应影响替代的语法识别,对替代的相关语义没有影响。

语法导向操作通过使用下列算法中的步骤134的约定,通过解析节点和可选的其他参数调用。

  1. status为SyntaxDirectedOperation of SomeNonTerminal
  2. someParseNode为一些源文本的解析。
  3. 执行someParseNode的SyntaxDirectedOperation。
  4. 带参数"value"执行someParseNode的SyntaxDirectedOperation。

除非另有明确规定,所有链产生式都隐含为其左侧非终结符的每个操作提供定义。隐含的定义简单地重新应用同一个操作和相同的参数(如果有的话)到链产生式的唯一右侧非终结符,然后返回结果。例如,假设某个算法有一个步骤形式:“返回评估 of ”,并且存在一个产生式:

: { 语句列表 }

但是评估操作并未将算法与该产生式关联。在这种情况下,评估操作隐含地包括如下形式的关联:

运行时语义:评估

: { 语句列表 }
  1. 返回评估 of 语句列表

5.2.3 运行时语义

需要在运行时调用以指定语义的算法称为运行时语义。运行时语义由抽象操作语法导向操作定义。

5.2.3.1 完成(completionRecord

抽象操作完成接受参数completionRecord(一个完成记录),并返回一个完成记录。此操作用于强调正在返回一个完成记录。在被调用时,它执行以下步骤:

  1. 断言completionRecord 是一个完成记录
  2. 返回completionRecord

5.2.3.2 抛出异常

算法步骤中提到抛出异常的,如:

  1. 抛出一个TypeError异常。

意味着与以下内容相同:

  1. 返回ThrowCompletion(新创建的TypeError对象)。

5.2.3.3 ReturnIfAbrupt

算法步骤中提到或等同于以下内容:

  1. ReturnIfAbrupt(argument)。

意味着:

  1. Assertargument 是一个Completion Record
  2. 如果 argument 是一个abrupt completion,返回Completion(argument)。
  3. 否则,将 argument 设置为 argument.[[Value]]

算法步骤中提到或等同于:

  1. ReturnIfAbrupt(AbstractOperation())。

意味着:

  1. hygienicTemp 是 AbstractOperation()。
  2. AsserthygienicTemp 是一个Completion Record
  3. 如果 hygienicTemp 是一个abrupt completion,返回Completion(hygienicTemp)。
  4. 否则,将 hygienicTemp 设置为 hygienicTemp.[[Value]]

hygienicTemp 是短暂的,仅在涉及 ReturnIfAbrupt 的步骤中可见。

算法步骤中提到或等同于:

  1. result 是 AbstractOperation(ReturnIfAbrupt(argument))。

意味着:

  1. Assertargument 是一个Completion Record
  2. 如果 argument 是一个abrupt completion,返回Completion(argument)。
  3. 否则,将 argument 设置为 argument.[[Value]]
  4. result 是 AbstractOperation(argument)。

5.2.3.4 ReturnIfAbrupt 简写

抽象操作语法导向操作调用时,前缀为?表示应当应用ReturnIfAbrupt到产生的完成记录。例如,步骤:

  1. ? OperationName().

等同于以下步骤:

  1. ReturnIfAbrupt(OperationName())。

同样,对于方法应用风格,步骤:

  1. someValue.OperationName().

等同于:

  1. ReturnIfAbrupt(someValue.OperationName())。

同样地,前缀!用来表示以下对抽象或语法导向操作的调用绝不会返回一个突然完成,并且结果中的完成记录[[Value]]字段应当代替操作的返回值使用。例如,步骤:

  1. val 是 ! OperationName().

等同于以下步骤:

  1. val 是 OperationName()。
  2. Assertval 是一个正常完成
  3. val 设置为 val.[[Value]]

语法导向操作运行时语义中使用这种简写,通过在操作调用前放置!?

  1. 执行 ! SyntaxDirectedOperation of NonTerminal

5.2.3.5 隐式正常完成

在声明返回完成记录抽象操作和所有内置函数中,返回的值首先传递给NormalCompletion,并使用其结果。此规则不适用于Completion算法内部,或当返回的值在该步骤中明确标记为完成记录的情况;这些情况包括:

如果通过任何其他方式从这样的抽象操作中返回完成记录,将是一个编辑错误。例如,在这些抽象操作中,

  1. 返回true

意味着与任何一种

  1. 返回NormalCompletion(true)。

  1. completionNormalCompletion(true)。
  2. 返回Completion(completion)。

  1. 返回完成记录 { [[Type]]: normal, [[Value]]: true, [[Target]]: empty }。

注意,通过ReturnIfAbrupt扩展,允许以下示例,因为在扩展的步骤中,应用Completion的结果在突然情况下直接返回,并且在正常情况下解包后隐式应用NormalCompletion

  1. 返回 ? completion

以下示例将是一个编辑错误,因为在该步骤中没有注明正在返回完成记录

  1. completionNormalCompletion(true)。
  2. 返回completion

5.2.4 静态语义

无上下文语法并不足以表达所有定义流式输入元素是否形成可评估的 ECMAScript ScriptModule 的规则。在某些情况下,需要使用 ECMAScript 算法约定或描述性要求来表达额外的规则。这些规则始终与语法的产生式相关联,并称为产生式的静态语义

静态语义规则具有名称,并通常使用算法定义。命名的静态语义规则与语法产生式相关联,具有多个备选定义的产生式通常对每个适用的命名静态语义规则有一个单独的算法。

静态语义规则的一种特殊类型是早期错误规则早期错误规则定义了特定语法产生式相关的早期错误条件(参见章节17)。大多数早期错误规则的评估在本规范的算法中未显式调用。符合要求的实现必须在首次评估ScriptModule之前,验证用于解析该ScriptModule的所有早期错误规则。如果违反了任何早期错误规则,则ScriptModule无效,无法评估。

5.2.5 数学运算

本规范参考以下数值类型:

  • 数学值:任意实数,作为默认的数值类型使用。
  • 扩展数学值数学值 加上 +∞ 和 -∞。
  • 数字:IEEE 754-2019 双精度浮点数值。参见 IEEE 754-2019
  • BigIntsECMAScript 语言值,表示与整数 整数 一一对应的任意整数。

在本规范的术语中,数值使用下标后缀来区分不同的数值类型。下标 𝔽 表示数字(Numbers),下标 表示大整数(BigInts)。没有下标后缀的数值指代 数学值

数值运算符(如 +、×、= 和 ≥)根据操作数的类型确定其操作。当应用于 数学值 时,这些运算符指代通常的数学运算。当应用于 扩展数学值 时,这些运算符指代扩展实数上的通常数学运算;未定义的不定形式在本规范中不予定义,其使用应视为编辑错误。当应用于数字(Numbers)时,这些运算符指代 IEEE 754-2019 中的相关运算。当应用于大整数(BigInts)时,这些运算符指代大整数的 数学值

一般来说,当本规范提到数值时,例如“y 的长度”或“由四位十六进制数字表示的 整数”,未明确指定数值类型时,默认指代 数学值。明确指代数字(Number)或大整数(BigInt)数值的短语将以明确标注方式出现;例如,“数字的数值,用于代码点数量…”或“大整数的数值…。”

不定义混合类型操作数(例如数字和 数学值)的数值运算符,其应视为本规范中的编辑错误。

本规范中大多数数值以十进制表示;同时也使用形如 0x 后跟数字 0-9 或 A-F 的十六进制值。

当本规范中使用术语 整数 时,指的是在 数学值 集合中的 整数,除非另有说明。当本规范中使用术语 整数数字 时,指的是数值其 数学值整数 集合中。

本文档中对 数学值、数字或大整数之间的转换总是明确的。从 数学值扩展数学值 x 到数字的转换表示为“数字的数值 x”或 𝔽(x),并在 6.1.6.1 中定义。从整数或大整数 x 到大整数的转换表示为“大整数的数值 x”或 ℤ(x)。从数字或大整数 x数学值 的转换表示为“数学值的数值 x”,或 ℝ(x)。对于 数学值的数值 +0𝔽-0𝔽,其为 数学值 0。对于非 有限 值,其 数学值的数值 未定义。对于 x扩展数学值的数值,其为 数学值的数值,对于 有限 值为 +∞ 和 -∞,对于 +∞𝔽-∞𝔽 分别为 +∞ 和 -∞,对于 NaN 未定义。

数学函数 abs(x) 计算 x 的绝对值,如果 x < 0,则结果为 -x,否则结果为 x 本身。

数学函数 min(x1, x2, ..., xN) 计算 x1xN 中的最小值。数学函数 max(x1, x2, ..., xN) 计算 x1xN 中的最大值。这些数学函数的定义域和值域为 扩展数学值

记法 “x modulo y”(y 必须为 有限 且非零)计算一个与 y 同号(或零)的值 k,使得 abs(k) < abs(y) 且 x - k = q × y,其中 q 是某个 整数

短语 "将 x 夹在 lowerupper 之间"(其中 x扩展数学值,而 lowerupper数学值,满足 lowerupper)的结果是:如果 x < lower,则产生 lower;如果 x > upper,则产生 upper;否则产生 x

数学函数 floor(x) 计算不大于 x 的最大 整数(接近 +∞)。

floor(x) = x - (x modulo 1).

数学函数 truncate(x) 通过朝零方向舍入移除 x 的小数部分,如果 x < 0,则产生 -floor(-x),否则产生 floor(x)

数学函数 min, max, abs, floor, 和 truncate 对于 Numbers 和 BigInts 都没有定义,任何使用具有非 数学值 参数的方法在本规范中应视为编辑错误。

从下界 a 到上界 b区间 是可能是无限的、可能为空的、相同数值类型的数值集合。每个边界都将描述为包含或排除,但不会同时包含。有四种类型的区间,如下所示:

例如,从 1(包含)到 2(排除)的 区间 包含所有介于 1 和 2 之间的 数学值,包括 1 但不包括 2。在定义区间的目的上,-0𝔽 < +0𝔽,因此,例如,下界为 +0𝔽包含区间 包括 +0𝔽 但不包括 -0𝔽NaN 永远不包括在一个 区间 中。

5.2.6 值表示法

在本规范中,ECMAScript 语言值粗体 显示。例如 nulltrue"hello"。这些与 ECMAScript 源文本Function.prototype.applylet n = 42; 区分开来。

5.2.7 身份

在本规范中,规范值和 ECMAScript 语言值 都被比较是否相等。在比较相等性时,值可以分为两类。如果所有的固有特性(如 整数 的大小或序列的长度)都相同,则没有身份标识的值与其他没有身份标识的值相等。没有身份标识的值可以在未先前引用的情况下通过完全描述其特性来显示。相反,每个带有身份标识的值都是唯一的,因此只与自身相等。带有身份标识的值类似于没有身份标识的值,但具有一个额外的不可预测、不可更改、全局唯一的特征,称为身份。对现有带有身份标识的值的引用不能仅通过描述来显示,因为身份本身是无法描述的;相反,必须明确地将对这些值的引用从一个地方传递到另一个地方。一些带有身份标识的值是可变的,因此可以在原地更改其特性(除了其身份),从而使所有持有该值的人都能观察到新的特性。没有身份标识的值永远不等于带有身份标识的值。

从本规范的角度来看,“is”一词用于比较两个值是否相等,例如“如果booltrue,则...”,而“contains”一词用于使用相等性比较在列表中搜索值,例如“如果list包含一个Recordr,使得r.[[Foo]]true,则...”。值的规范身份决定了这些比较的结果,并在本规范中是公理性的。

从 ECMAScript 语言的角度来看,语言值使用SameValue抽象操作及其传递调用的抽象操作进行相等性比较。这些比较的算法操作决定了ECMAScript 语言值语言身份

对于规范值,没有规范身份的值包括但不限于:数学值扩展数学值ECMAScript 源文本代理对指令前言等;UTF-16 代码单元;Unicode 代码点;枚举抽象操作,包括语法导向操作宿主钩子等;有序对。 具有规范身份的规范值包括但不限于:记录的任何种类,包括属性描述符私有元素等;解析节点列表集合关系抽象闭包数据块私有名称执行上下文执行上下文堆栈代理标识符;以及等待列表记录

规范身份对于所有ECMAScript 语言值都与语言身份一致,除了由Symbol.for生成的Symbol值。没有规范身份和语言身份的ECMAScript语言值包括:undefinednull布尔值字符串数字,和大整数。具有规范身份和语言身份的ECMAScript语言值包括:Symbol,但不包括由Symbol.for生成的Symbol值,以及对象

6 ECMAScript 数据类型和值

本规范中的算法操作值,每个值都有一个关联的类型。可能的值类型正是本条款中定义的那些类型。类型进一步分为ECMAScript 语言类型和规范类型。

在本规范中,“Type(x)”表示“x类型”,其中“类型”指的是本条款中定义的ECMAScript语言和规范类型。

6.1 ECMAScript 语言类型

ECMAScript 语言类型对应于由 ECMAScript 程序员直接使用 ECMAScript 语言操作的值。ECMAScript 语言类型包括 Undefined、Null、Boolean、String、Symbol、Number、BigInt 和 Object。一个ECMAScript 语言值是由 ECMAScript 语言类型特征化的值。

6.1.1 Undefined 类型

Undefined 类型恰好有一个值,称为 undefined。任何未被赋值的变量具有值 undefined

6.1.2 Null 类型

Null 类型恰好有一个值,称为 null

6.1.3 Boolean 类型

Boolean 类型表示具有两个值的逻辑实体,称为 truefalse

6.1.4 String 类型

String 类型是所有有序序列的集合,这些序列由零个或多个 16 位无符号整数值(“元素”)组成,最多可以有 253 - 1 个元素。String 类型通常用于表示运行中的 ECMAScript 程序中的文本数据,其中 String 中的每个元素都被视为一个 UTF-16 代码单元值。每个元素被视为占据序列中的一个位置。这些位置使用非负整数进行索引。第一个元素(如果有)位于索引 0,下一个元素(如果有)位于索引 1,依此类推。String 的长度是其中的元素数(即 16 位值)。空字符串的长度为零,因此不包含任何元素。

不解释 String 内容的 ECMAScript 操作不应用进一步的语义。对解释 String 值的操作将每个元素视为单个 UTF-16 代码单元。然而,ECMAScript 不限制这些代码单元的值或关系,因此进一步解释 String 内容为 UTF-16 编码的 Unicode 代码点序列的操作必须考虑到格式不正确的子序列。这些操作对于每个数值位于从 0xD800 到 0xDBFF(由 Unicode 标准定义为leading surrogate,或更正式地称为high-surrogate code unit)的代码单元,以及每个数值位于从 0xDC00 到 0xDFFF(定义为trailing surrogate,或更正式地称为low-surrogate code unit)的代码单元使用以下规则:

  • 一个既不是前导代理对也不是后继代理对的代码单元,将被解释为具有相同值的代码点。
  • 两个代码单元的序列,其中第一个代码单元 c1前导代理对,第二个代码单元 c2后继代理对,称为代理对,解释为代码点的值为 (c1 - 0xD800) × 0x400 + (c2 - 0xDC00) + 0x10000。(参见11.1.3
  • 一个是前导代理对后继代理对的代码单元,但不是代理对的一部分,将被解释为具有相同值的代码点。

函数 String.prototype.normalize(参见22.1.3.15)可以用来显式标准化一个字符串值。String.prototype.localeCompare(参见22.1.3.12)在内部标准化字符串值,但其他操作不会隐式地标准化它们操作的字符串。操作结果除非另有说明,否则不受语言和/或地区的影响。

这种设计背后的理念是为了保持字符串的实现尽可能简单和高效。如果ECMAScript源代码文本处于规范形式C,只要它们不包含任何Unicode转义序列,字符串字面值也保证是标准化的。

在这个规范中,“字符串连接 AB 等...”(每个参数是一个字符串值、代码单元或代码单元的序列)表示的是一个字符串值,其代码单元的序列是每个参数(按顺序)的代码单元的连接(按顺序)。

短语“从 inclusiveStartexclusiveEnd子字符串”(其中 S 是一个字符串值或代码单元序列,而 inclusiveStartexclusiveEnd整数)表示由 S 的连续代码单元组成的字符串值,开始于索引 inclusiveStart 并在索引 exclusiveEnd 之前立即结束(当 inclusiveStart = exclusiveEnd 时为空字符串)。如果省略了“to”后缀,则使用 S 的长度作为 exclusiveEnd 的值。

短语“ASCII 单词字符”表示以下字符串值,它仅由 Unicode 基本拉丁语块中的每个字母和数字以及 U+005F(下划线)组成:
"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789_".
出于历史原因,它对各种算法具有重要意义。

6.1.4.1 StringIndexOf ( string, searchValue, fromIndex )

抽象操作 StringIndexOf 接受参数 string(一个字符串)、searchValue(一个字符串)和 fromIndex (一个非负 整数)并返回一个 整数。它在被调用时执行以下步骤:

  1. lenstring 的长度。
  2. 如果 searchValue 是空字符串且 fromIndexlen,返回 fromIndex
  3. searchLensearchValue 的长度。
  4. 对于每个 整数 i 使得 fromIndexilen - searchLen,按升序执行:
    1. candidatestringii + searchLen子字符串
    2. 如果 candidatesearchValue,返回 i
  5. 返回 -1。
注 1

如果 searchValue 是空字符串且 fromIndexstring 的长度,该算法返回 fromIndex。空字符串实际上在字符串中的每个位置都能找到,包括在最后一个码位之后。

注 2

如果 fromIndex 加上 searchValue 的长度大于 string 的长度,该算法总是返回 -1。

6.1.5 符号类型(Symbol Type)

符号类型 是可以用作对象属性键的所有非字符串值的集合(6.1.7)。

每个可能的符号值都是唯一且不可变的。

每个符号值不可变地持有一个关联的值,称为 [[Description]],它要么是 undefined,要么是一个字符串值。

6.1.5.1 众所周知的符号(Well-Known Symbols)

众所周知的符号是本规范算法明确引用的内建符号值。它们通常用作属性的键,这些属性的值作为规范算法的扩展点。除非另有说明,否则众所周知的符号值在所有realm中共享(9.3)。

在本规范中,一个众所周知的符号用 @@name 的形式表示,其中“name”是表1中列出的值之一。

表1: 众所周知的符号
规范名称 [[Description]] 值和用途
@@asyncIterator "Symbol.asyncIterator" 一个方法,返回对象的默认异步迭代器。由for-await-of语句的语义调用。
@@hasInstance "Symbol.hasInstance" 一个方法,确定构造函数对象是否将某个对象识别为其实例之一。由instanceof运算符的语义调用。
@@isConcatSpreadable "Symbol.isConcatSpreadable" 一个布尔值属性,如果为true,表示对象应通过Array.prototype.concat展平为其数组元素。
@@iterator "Symbol.iterator" 一个方法,返回对象的默认迭代器。由for-of语句的语义调用。
@@match "Symbol.match" 一个正则表达式方法,将正则表达式与字符串匹配。由String.prototype.match方法调用。
@@matchAll "Symbol.matchAll" 一个正则表达式方法,返回一个迭代器,该迭代器生成正则表达式与字符串匹配的所有结果。由String.prototype.matchAll方法调用。
@@replace "Symbol.replace" 一个正则表达式方法,替换字符串中的匹配子字符串。由String.prototype.replace方法调用。
@@search "Symbol.search" 一个正则表达式方法,返回匹配正则表达式的字符串中的索引。由String.prototype.search方法调用。
@@species "Symbol.species" 一个函数值属性,是用于创建派生对象的构造函数。
@@split "Symbol.split" 一个正则表达式方法,在匹配正则表达式的索引处分割字符串。由String.prototype.split方法调用。
@@toPrimitive "Symbol.toPrimitive" 一个方法,将对象转换为相应的原始值。由ToPrimitive抽象操作调用。
@@toStringTag "Symbol.toStringTag" 一个字符串值属性,用于创建对象的默认字符串描述。由内建方法Object.prototype.toString访问。
@@unscopables "Symbol.unscopables" 一个对象值属性,其自身和继承的属性名称是从相关对象的with环境绑定中排除的属性名称。

6.1.6 数字类型(Numeric Types)

ECMAScript 有两种内建的数字类型:Number 和 BigInt。以下抽象操作定义在这些数字类型上。“结果”列显示返回类型,并指出某些操作调用是否可能返回异常完成

表2:数字类型操作
操作 示例源码 评估语义调用... 结果
Number::unaryMinus -x 一元 - 运算符 Number
BigInt::unaryMinus BigInt
Number::bitwiseNOT ~x 按位非运算符 ( ~ ) Number
BigInt::bitwiseNOT BigInt
Number::exponentiate x ** y 幂运算符Math.pow ( base, exponent ) Number
BigInt::exponentiate 要么是包含 BigInt 的正常完成,要么是抛出完成
Number::multiply x * y 乘法运算符 Number
BigInt::multiply BigInt
Number::divide x / y 乘法运算符 Number
BigInt::divide 要么是包含 BigInt 的正常完成,要么是抛出完成
Number::remainder x % y 乘法运算符 Number
BigInt::remainder 要么是包含 BigInt 的正常完成,要么是抛出完成
Number::add x ++
++ x
x + y
后缀递增运算符, 前缀递增运算符, 和 加法运算符(+ Number
BigInt::add BigInt
Number::subtract x --
-- x
x - y
后缀递减运算符, 前缀递减运算符, 和 减法运算符(- Number
BigInt::subtract BigInt
Number::leftShift x << y 左移位运算符(<< Number
BigInt::leftShift BigInt
Number::signedRightShift x >> y 有符号右移位运算符(>> Number
BigInt::signedRightShift BigInt
Number::unsignedRightShift x >>> y The Unsigned Right Shift Operator ( >>> ) Number
BigInt::unsignedRightShift a throw completion
Number::lessThan x < y
x > y
x <= y
x >= y
关系运算符, via IsLessThan ( x, y, LeftFirst ) Boolean or undefined (for unordered inputs)
BigInt::lessThan Boolean
Number::equal x == y
x != y
x === y
x !== y
等值运算符, via IsStrictlyEqual ( x, y ) Boolean
BigInt::equal
Number::sameValue Object.is(x, y) 对象内部方法, via SameValue ( x, y ), 测试精确的值相等性 Boolean
Number::sameValueZero [x].includes(y) Array、Map和Set方法, via SameValueZero ( x, y ), 要测试值相等性,忽略 +0𝔽-0𝔽 Boolean
Number::bitwiseAND x & y 二进制按位运算符 Number
BigInt::bitwiseAND BigInt
Number::bitwiseXOR x ^ y Number
BigInt::bitwiseXOR BigInt
Number::bitwiseOR x | y Number
BigInt::bitwiseOR BigInt
Number::toString String(x) 许多表达式和内置函数, 经由 ToString ( argument ) String
BigInt::toString

由于数值类型通常不能在不损失精度或截断的情况下相互转换,ECMAScript语言不提供这些类型之间的隐式转换。在调用需要另一种类型的函数时,程序员必须显式调用 NumberBigInt 函数进行类型转换。

ECMAScript 的早期和后续版本为某些运算符提供了隐式数值转换,这可能会损失精度或 截断。这些遗留的隐式转换保留了向后兼容性,但不适用于 BigInt,以减少程序员错误的可能性,并为未来版本中的泛型 值类型 留出选项。

6.1.6.1 数字类型(The Number Type)

数字类型(Number type)具有精确的 18,437,736,874,454,810,627 (即 264 - 253 + 3)个值, 表示双精度 64 位格式的 IEEE 754-2019 值,这些值按照 IEEE 二进制浮点算术标准规定。不同于 IEEE 标准的 9,007,199,254,740,990 (即 253 - 2)个“非数值(Not-a-Number)”值在 ECMAScript 中表示为单独的特殊值 NaN。 (注意,NaN 值由程序表达式 NaN 产生。)在一些实现中,外部代码可能能够检测到各种不同的非数值,但这种行为是 实现定义的; 对于 ECMAScript 代码来说,所有的 NaN 值都是无法区分的。

在存储 Number 值到 ArrayBuffer(参见 25.1)或 SharedArrayBuffer(参见 25.2)后,可能观察到的位模式不一定与 ECMAScript 实现中使用的该 Number 值的内部表示相同。

还有另外两个特殊值,分别称为 positive Infinitynegative Infinity。为了简洁起见,在解释目的上,这些值也被表示为符号 +∞𝔽-∞𝔽,分别。(注意,这两个无穷大的 Number 值由程序表达式 +Infinity(或简单地 Infinity)和 -Infinity 产生。)

其余的 18,437,736,874,454,810,624(即 264 - 253)个值被称为 有限数。其中一半是正数,一半是负数;对于每个 有限 的正数 Number 值,都有一个相应的具有相同数量级的负数值。

注意,这里有一个 positive zero 和一个 negative zero。为了简洁起见,在解释目的上,这些值也被表示为符号 +0𝔽-0𝔽,分别。(注意,这两个不同的零 Number 值由程序表达式 +0(或简单地 0)和 -0 产生。)

18,437,736,874,454,810,622(即 264 - 253 - 2)个 有限 的非零值分为两种:

18,428,729,675,200,069,632(即 264 - 254)个被规范化的值,具有以下形式:

s × m × 2e

其中,s 可以是 1 或 -1,m 是一个 整数,在区间从 252(包含)到 253(不包含)之间,而 e 是一个 整数,在区间从 -1074 到 971 的 包含区间内。

剩余的 9,007,199,254,740,990(即 253 - 2)个值是非规格化的,具有以下形式:

s × m × 2e

其中,s 可以是 1 或 -1,m 是一个 整数,在区间从 0(不包含)到 252(不包含)之间,而 e 是 -1074。

注意,在 Number 类型中,所有不大于 253 的正整数和负整数都可以表示。整数 0 在 Number 类型中有两种表示形式:+0𝔽-0𝔽

一个 有限数 的“奇数有效尾数”指的是,如果它是非零的,并且用来表示它的 整数 m(以上述两种形式之一)是奇数。否则,它具有“偶数有效尾数”。 在本规范中,“表示为数值的 Number 值 for x”这一短语表示选定以下方式的 Number 值。考虑所有的 Number 类型的 有限值,从中去除 -0𝔽,并额外添加两个不可表示的值,即 21024(即 +1 × 253 × 2971)和 -21024(即 -1 × 253 × 2971)。选择这个集合中与 x 最接近的成员。如果集合中有两个值同样接近,则选择有效尾数为偶数的那个;为此,额外的两个值 21024-21024 被认为具有偶数的有效尾数。最后,如果选择了 21024,则用 +∞𝔽 替换它;如果选择了 -21024,则用 -∞𝔽 替换它;如果选择了 +0𝔽,则仅当 x < 0 时,用 -0𝔽 替换它;否则使用选择的其他值而不变。结果就是 表示为数值的 Number 值 for x。(此过程与 IEEE 754-2019 roundTiesToEven 模式的行为完全对应。)

+∞ 的 Number 值为+∞𝔽,而 -∞ 的 Number 值为-∞𝔽

一些 ECMAScript 运算符只处理特定范围内的 整数,比如从 -231231 - 1闭区间或者从 0 到 216 - 1闭区间。这些运算符接受 Number 类型的任何值,但首先将每个这样的值转换为预期范围内的 整数 值。请参阅 7.1 中的数值转换操作描述。

6.1.6.1.1 Number::unaryMinus ( x )

抽象操作 Number::unaryMinus 接受参数 x(一个 Number),并返回一个 Number。调用时执行以下步骤:

  1. 如果 xNaN,则返回 NaN
  2. 返回取反后的结果 x;即具有相同大小但相反符号的 Number。

6.1.6.1.2 Number::bitwiseNOT ( x )

抽象操作 Number::bitwiseNOT 接受参数 x(一个 Number),并返回一个 整数型 Number。调用时执行以下步骤:

  1. oldValue 为 ! ToInt32(x)。
  2. 返回对 oldValue 应用按位补码操作的结果。该结果的 数学值 正好可表示为一个32位的二进制补码字符串。

6.1.6.1.3 Number::exponentiate ( base, exponent )

抽象操作 Number::exponentiate 接受参数 base(一个 Number)和 exponent(一个 Number),并返回一个 Number。它返回一个 实现近似值,表示将 baseexponent 次幂的结果。调用时执行以下步骤:

  1. 如果 exponentNaN,则返回 NaN
  2. 如果 exponent+0𝔽-0𝔽,则返回 1𝔽
  3. 如果 baseNaN,则返回 NaN
  4. 如果 base+∞𝔽,则
    1. 如果 exponent > +0𝔽,则返回 +∞𝔽。否则,返回 +0𝔽
  5. 如果 base-∞𝔽,则
    1. 如果 exponent > +0𝔽,那么
      1. 如果 exponent 是奇数的 integral Number,则返回 -∞𝔽。否则,返回 +∞𝔽
    2. 否则,
      1. 如果 exponent 是奇数的 integral Number,则返回 -0𝔽。否则,返回 +0𝔽
  6. 如果 base+0𝔽,则
    1. 如果 exponent > +0𝔽,则返回 +0𝔽。否则,返回 +∞𝔽
  7. 如果 base-0𝔽,则
    1. 如果 exponent > +0𝔽,那么
      1. 如果 exponent 是奇数的 integral Number,则返回 -0𝔽。否则,返回 +0𝔽
    2. 否则,
      1. 如果 exponent 是奇数的 integral Number,则返回 -∞𝔽。否则,返回 +∞𝔽
  8. Assert: base 是有限数,并且不是 +0𝔽-0𝔽
  9. 如果 exponent+∞𝔽,则
    1. 如果 abs((base)) > 1,则返回 +∞𝔽
    2. 如果 abs((base)) = 1,则返回 NaN
    3. 如果 abs((base)) < 1,则返回 +0𝔽
  10. 如果 exponent-∞𝔽,则
    1. 如果 abs((base)) > 1,则返回 +0𝔽
    2. 如果 abs((base)) = 1,则返回 NaN
    3. 如果 abs((base)) < 1,则返回 +∞𝔽
  11. Assert: exponentfinite,并且不是 +0𝔽-0𝔽
  12. 如果 base < -0𝔽,并且 exponent 不是一个 integral Number,则返回 NaN
  13. 返回一个表示将 (base) 的 (exponent) 次幂的结果的 implementation-approximated 数值。

base1𝔽-1𝔽,并且 exponent+∞𝔽-∞𝔽,或者当 base1𝔽exponentNaN𝔽 时,base ** exponent 的结果与 IEEE 754-2019 不同。ECMAScript 的第一版对于这个操作的结果规定为 NaN,而后来的 IEEE 754 标准修订版规定为 1𝔽。为了兼容性,保留了历史上 ECMAScript 的行为。

6.1.6.1.4 Number::multiply ( x, y )

抽象操作 Number::multiply 接受参数 x(一个 Number)和 y(一个 Number),返回一个 Number。它根据 IEEE 754-2019 的双精度二进制算术规则执行乘法运算,生成 xy 的乘积。调用时执行以下步骤:

  1. 如果 xNaN 或者 yNaN,则返回 NaN
  2. 如果 x+∞𝔽 或者 -∞𝔽,则
    1. 如果 y+0𝔽 或者 -0𝔽,则返回 NaN
    2. 如果 y > +0𝔽,则返回 x
    3. 返回 -x
  3. 如果 y+∞𝔽 或者 -∞𝔽,则
    1. 如果 x+0𝔽 或者 -0𝔽,则返回 NaN
    2. 如果 x > +0𝔽,则返回 y
    3. 返回 -y
  4. 如果 x-0𝔽,则
    1. 如果 y-0𝔽 或者 y < -0𝔽,则返回 +0𝔽
    2. 否则,返回 -0𝔽
  5. 如果 y-0𝔽,则
    1. 如果 x < -0𝔽,则返回 +0𝔽
    2. 否则,返回 -0𝔽
  6. 返回 𝔽((x) × (y))。

有限精度乘法是可交换的,但不总是可结合的。

6.1.6.1.5 Number::divide ( x, y )

抽象操作 Number::divide 接受参数 x(一个 Number)和 y(一个 Number),返回一个 Number。 它根据 IEEE 754-2019 二进制双精度算术规则执行除法,产生 x 除以 y 的商。 调用时执行以下步骤:

  1. 如果 xNaN 或者 yNaN,返回 NaN
  2. 如果 x+∞𝔽 或者 -∞𝔽,则
    1. 如果 y+∞𝔽 或者 -∞𝔽,返回 NaN
    2. 如果 y+0𝔽 或者 y > +0𝔽,返回 x
    3. 返回 -x
  3. 如果 y+∞𝔽,则
    1. 如果 x+0𝔽 或者 x > +0𝔽,返回 +0𝔽。 否则,返回 -0𝔽
  4. 如果 y-∞𝔽,则
    1. 如果 x+0𝔽 或者 x > +0𝔽,返回 -0𝔽。 否则,返回 +0𝔽
  5. 如果 x+0𝔽 或者 -0𝔽,则
    1. 如果 y+0𝔽 或者 -0𝔽,返回 NaN
    2. 如果 y > +0𝔽, 返回 x
    3. 返回 -x
  6. 如果 y+0𝔽,则
    1. 如果 x > +0𝔽, 返回 +∞𝔽。否则,返回 -∞𝔽
  7. 如果 y-0𝔽,则
    1. 如果 x > +0𝔽, 返回 -∞𝔽。否则,返回 +∞𝔽
  8. 返回 𝔽((x) / (y)).

6.1.6.1.6 Number::remainder ( n, d )

抽象操作 Number::remainder 接受参数 n(一个 Number)和 d(一个 Number),返回一个 Number。 它返回其操作数的隐含除法的余数,其中 n 是被除数,d 是除数。调用时执行以下步骤:

  1. 如果 nNaN 或者 dNaN,返回 NaN
  2. 如果 n+∞𝔽 或者 -∞𝔽,返回 NaN
  3. 如果 d+∞𝔽 或者 -∞𝔽,返回 n
  4. 如果 d+0𝔽 或者 -0𝔽,返回 NaN
  5. 如果 n+0𝔽 或者 -0𝔽,返回 n
  6. Assert: ndfinite 的且非零。
  7. quotient(n) / (d)。
  8. qtruncate(quotient)。
  9. r(n) - ((d) × q)。
  10. 如果 r = 0 并且 n < -0𝔽,返回 -0𝔽
  11. 返回 𝔽(r)。
注1

在 C 和 C++ 中,取余运算符只接受整数操作数;在 ECMAScript 中,它也接受浮点操作数。

注2
浮点取余运算的结果与 % 运算符计算的“余数”操作不同,后者由 IEEE 754-2019 定义。 IEEE 754-2019 的“余数”操作从四舍五入的除法中计算余数,而不是截断的除法,因此其行为与通常的 整数 取余运算符不类似。 相反,ECMAScript 语言定义浮点操作的 % 以类似于 Java 整数 取余运算符的方式行为;这可以与 C 库函数 fmod 进行比较。

6.1.6.1.7 Number::add ( x, y )

抽象操作 Number::add 接受参数 x(一个 Number)和 y(一个 Number),返回一个 Number。它根据 IEEE 754-2019 二进制双精度算术的规则执行加法,生成其参数的和。调用时执行以下步骤:

  1. 如果 xNaN 或者 yNaN,返回 NaN
  2. 如果 x+∞𝔽 并且 y-∞𝔽,返回 NaN
  3. 如果 x-∞𝔽 并且 y+∞𝔽,返回 NaN
  4. 如果 x+∞𝔽 或者 -∞𝔽,返回 x
  5. 如果 y+∞𝔽 或者 -∞𝔽,返回 y
  6. Assert: xy 都是 有限的
  7. 如果 x-0𝔽 并且 y-0𝔽,返回 -0𝔽
  8. 返回 𝔽((x) + (y))。

有限精度加法是可交换的,但并非总是可结合的。

6.1.6.1.8 Number::subtract ( x, y )

抽象操作 Number::subtract 接受参数 x(一个 Number)和 y(一个 Number),返回一个 Number。它执行减法运算,生成其操作数的差;x 是被减数,y 是减数。调用时执行以下步骤:

  1. 返回 Number::add(x, Number::unaryMinus(y))。

总是有 x - y 的结果与 x + (-y) 相同。

6.1.6.1.9 Number::leftShift ( x, y )

抽象操作 Number::leftShift 接受参数 x(一个 Number)和 y(一个 Number),返回一个整数 Number。调用时执行以下步骤:

  1. lnum 为 ! ToInt32(x)。
  2. rnum 为 ! ToUint32(y)。
  3. shiftCount(rnum) modulo 32。
  4. 返回将 lnum 左移 shiftCount 位的结果。结果的 数学值可准确表示为一个32位二进制补码位字符串。

6.1.6.1.10 Number::signedRightShift ( x, y )

抽象操作 Number::signedRightShift 接受参数 x(一个 Number)和 y(一个 Number),返回一个整数 Number。调用时执行以下步骤:

  1. lnum 为 ! ToInt32(x)。
  2. rnum 为 ! ToUint32(y)。
  3. shiftCount(rnum) modulo 32。
  4. 返回将 lnum 右移 shiftCount 位并进行符号扩展的结果。最高有效位被传播。结果的 数学值可准确表示为一个32位二进制补码位字符串。

6.1.6.1.11 Number::unsignedRightShift ( x, y )

抽象操作 Number::unsignedRightShift 接受参数 x(一个 Number)和 y(一个 Number),返回一个整数 Number。调用时执行以下步骤:

  1. lnum 为 ! ToUint32(x)。
  2. rnum 为 ! ToUint32(y)。
  3. shiftCount(rnum) modulo 32。
  4. 返回将 lnum 右移 shiftCount 位并进行零填充的结果。空出的位将填充为零。结果的 数学值可准确表示为一个32位无符号位字符串。

6.1.6.1.12 Number::lessThan ( x, y )

抽象操作 Number::lessThan 接受参数 x(一个 Number)和 y(一个 Number),返回一个布尔值或 undefined。调用时执行以下步骤:

  1. 如果 xNaN,则返回 undefined
  2. 如果 yNaN,则返回 undefined
  3. 如果 x 等于 y,则返回 false
  4. 如果 x+0𝔽 并且 y-0𝔽,则返回 false
  5. 如果 x-0𝔽 并且 y+0𝔽,则返回 false
  6. 如果 x+∞𝔽,则返回 false
  7. 如果 y+∞𝔽,则返回 true
  8. 如果 y-∞𝔽,则返回 false
  9. 如果 x-∞𝔽,则返回 true
  10. Assert: xy 都是 finite
  11. 如果 (x) 小于 (y),则返回 true。否则,返回 false

6.1.6.1.13 Number::equal ( x, y )

抽象操作 Number::equal 接受参数 x(一个 Number)和 y(一个 Number),返回一个布尔值。调用时执行以下步骤:

  1. 如果 xNaN,则返回 false
  2. 如果 yNaN,则返回 false
  3. 如果 x 等于 y,则返回 true
  4. 如果 x+0𝔽 并且 y-0𝔽,则返回 true
  5. 如果 x-0𝔽 并且 y+0𝔽,则返回 true
  6. 返回 false

6.1.6.1.14 Number::sameValue ( x, y )

抽象操作 Number::sameValue 接受参数 x(一个 Number)和 y(一个 Number),返回一个布尔值。调用时执行以下步骤:

  1. 如果 xNaN 并且 yNaN,则返回 true
  2. 如果 x+0𝔽 并且 y-0𝔽,则返回 false
  3. 如果 x-0𝔽 并且 y+0𝔽,则返回 false
  4. 如果 x 等于 y,则返回 true
  5. 返回 false

6.1.6.1.15 Number::sameValueZero ( x, y )

抽象操作 Number::sameValueZero 接受参数 x(一个 Number)和 y(一个 Number),返回一个布尔值。调用时执行以下步骤:

  1. 如果 xNaN 并且 yNaN,则返回 true
  2. 如果 x+0𝔽 并且 y-0𝔽,则返回 true
  3. 如果 x-0𝔽 并且 y+0𝔽,则返回 true
  4. 如果 x 等于 y,则返回 true
  5. 返回 false

6.1.6.1.16 Number::NumberBitwiseOp ( op, x, y )

抽象操作 Number::NumberBitwiseOp 接受参数 op&^|)、x(一个 Number)和 y(一个 Number),返回一个 integral Number。调用时执行以下步骤:

  1. lnum 为 ! ToInt32(x).
  2. rnum 为 ! ToInt32(y).
  3. lbits 为表示 (lnum) 的 32 位二进制补码位字符串。
  4. rbits 为表示 (rnum) 的 32 位二进制补码位字符串。
  5. 如果 op&,则
    1. result 为对 lbitsrbits 执行按位与操作的结果。
  6. 否则,如果 op^,则
    1. result 为对 lbitsrbits 执行按位异或(XOR)操作的结果。
  7. 否则,
    1. Assert:断言 op|
    2. result 为对 lbitsrbits 执行按位或操作的结果。
  8. 返回由 32 位二进制补码位字符串 result 表示的 Number value forinteger

6.1.6.1.17 Number::bitwiseAND ( x, y )

抽象操作 Number::bitwiseAND 接受参数 x(一个 Number)和 y(一个 Number),返回一个 integral Number。调用时执行以下步骤:

  1. 返回 NumberBitwiseOp(&, x, y).

6.1.6.1.18 Number::bitwiseXOR ( x, y )

抽象操作 Number::bitwiseXOR 接受参数 x(一个 Number)和 y(一个 Number),返回一个 integral Number。调用时执行以下步骤:

  1. 返回 NumberBitwiseOp(^, x, y).

6.1.6.1.19 Number::bitwiseOR ( x, y )

抽象操作 Number::bitwiseOR 接受参数 x(一个 Number)和 y(一个 Number),返回一个 integral Number。调用时执行以下步骤:

  1. 返回 NumberBitwiseOp(|, x, y).

6.1.6.1.20 Number::toString ( x, radix )

抽象操作 Number::toString 接受参数 x(一个数字)和 radix(一个在 2 到 36 之间的整数),并返回一个字符串。它使用以 radix 为基数的进位制系统将 x 表示为字符串。使用基数 r 表示数字时所用的数字取自 "0123456789abcdefghijklmnopqrstuvwxyz" 的前 r 个字符。数值大小大于或等于 1𝔽 的数字表示永远不会包含前导零。它在被调用时执行以下步骤:

  1. 如果 xNaN,返回 "NaN"
  2. 如果 x+0𝔽-0𝔽,返回 "0"
  3. 如果 x < -0𝔽,返回 字符串连接"-"Number::toString(-x, radix)。
  4. 如果 x+∞𝔽,返回 "Infinity"
  5. nks整数,使得 k ≥ 1,radixk - 1s < radixk𝔽(s × radixn - k) 是 x,并且 k 尽可能小。注意,k 是使用基数 radix 表示 s 的数字个数,s 不能被 radix 整除,并且 s 的最低有效位不一定由这些条件唯一确定。
  6. 如果 radix ≠ 10 或 n包含区间 从 -5 到 21,那么
    1. 如果 nk,那么
      1. 返回 字符串连接
        • 使用基数 radix 表示 sk 位数字的代码单元
        • n - k 个代码单元 0x0030 (DIGIT ZERO)
    2. 否则如果 n > 0,那么
      1. 返回 字符串连接
        • 使用基数 radix 表示 s 的最高有效 n 位数字的代码单元
        • 代码单元 0x002E (FULL STOP)
        • 使用基数 radix 表示 s 的剩余 k - n 位数字的代码单元
    3. 否则,
      1. 断言n ≤ 0。
      2. 返回 字符串连接
        • 代码单元 0x0030 (DIGIT ZERO)
        • 代码单元 0x002E (FULL STOP)
        • -n 个代码单元 0x0030 (DIGIT ZERO)
        • 使用基数 radix 表示 sk 位数字的代码单元
  7. 注意:在这种情况下,输入将使用科学 E 表示法表示,例如 1.2e+3
  8. 断言radix 是 10。
  9. 如果 n < 0,那么
    1. exponentSign 为代码单元 0x002D (HYPHEN-MINUS)。
  10. 否则,
    1. exponentSign 为代码单元 0x002B (PLUS SIGN)。
  11. 如果 k = 1,那么
    1. 返回 字符串连接
      • s 的单个数字的代码单元
      • 代码单元 0x0065 (LATIN SMALL LETTER E)
      • exponentSign
      • 十进制表示的 abs(n - 1)
  12. 返回 字符串连接
    • 十进制表示的 s 的最高有效位的代码单元
    • 代码单元 0x002E (FULL STOP)
    • 十进制表示的 s 的剩余 k - 1 位数字的代码单元
    • 代码单元 0x0065 (LATIN SMALL LETTER E)
    • exponentSign
    • 十进制表示的 abs(n - 1)
注 1

以下观察可能对实现有指导作用,但不是本标准规范性要求的一部分:

  • 如果 x 是除 -0𝔽 以外的任何数字值,那么 ToNumber(ToString(x)) 是 x。
  • s 的最低有效位并不总是由步骤 5 中列出的要求唯一确定。
注 2

对于提供比上述规则更精确转换的实现,建议使用以下替代版本的步骤 5 作为指导:

  1. nks整数,使得 k ≥ 1,radixk - 1s < radixk𝔽(s × radixn - k) 是 x,并且 k 尽可能小。如果有多个可能的 s 值,选择使 s × radixn - k 最接近 (x) 的 s 值。如果有两个这样的可能值,选择偶数的那一个。注意,k 是使用基数 radix 表示 s 的数字个数,并且 s 不能被 radix 整除。
注 3

ECMAScript 的实现者可能会发现 David M. Gay 撰写的关于浮点数二进制到十进制转换的论文和代码很有用:

Gay, David M. 正确舍入的二进制-十进制和十进制-二进制转换。数值分析,手稿 90-10。AT&T 贝尔实验室(新泽西州默里山)。1990 年 11 月 30 日。 可在
http://ampl.com/REFS/abstracts.html#rounding 获取。 相关代码可在
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 )

抽象操作 BigInt::unaryMinus 接受参数 x(一个 BigInt)并返回一个 BigInt。它在被调用时执行以下步骤:

  1. 如果 x0,返回 0
  2. 返回 -x

6.1.6.2.2 BigInt::bitwiseNOT ( x )

抽象操作 BigInt::bitwiseNOT 接受参数 x(一个 BigInt)并返回一个 BigInt。 它返回 x 的按位取反。它在被调用时执行以下步骤:

  1. 返回 -x - 1

6.1.6.2.3 BigInt::exponentiate ( base, exponent )

抽象操作 BigInt::exponentiate 接受参数 base(一个 BigInt)和 exponent(一个 BigInt),并返回一个包含 BigInt 的正常完成或抛出完成。它在被调用时执行以下步骤:

  1. 如果 exponent < 0,抛出一个 RangeError 异常。
  2. 如果 base0exponent0,返回 1
  3. 返回 baseexponent 次方。

6.1.6.2.4 BigInt::multiply ( x, y )

抽象操作 BigInt::multiply 接受参数 x(一个 BigInt)和 y(一个 BigInt)并返回一个 BigInt。它在被调用时执行以下步骤:

  1. 返回 x × y
即使结果的位宽比输入大得多,也会给出精确的数学答案。

6.1.6.2.5 BigInt::divide ( x, y )

抽象操作 BigInt::divide 接受参数 x(一个 BigInt)和 y(一个 BigInt),并返回一个包含 BigInt 的正常完成或抛出完成。它在被调用时执行以下步骤:

  1. 如果 y0,抛出一个 RangeError 异常。
  2. quotient(x) / (y)。
  3. 返回 (truncate(quotient))。

6.1.6.2.6 BigInt::remainder ( n, d )

抽象操作 BigInt::remainder 接受参数 n(一个 BigInt)和 d(一个 BigInt),并返回一个 正常完成包含一个 BigInt 或一个 抛出完成。它在调用时执行以下步骤:

  1. 如果 d0,抛出一个 RangeError 异常。
  2. 如果 n0,返回 0
  3. quotient(n) / (d)。
  4. q(截断(quotient))。
  5. 返回 n - (d × q)。
结果的符号与被除数的符号相同。

6.1.6.2.7 BigInt::add ( x, y )

抽象操作 BigInt::add 接受参数 x(一个 BigInt)和 y(一个 BigInt)并返回一个 BigInt。它在被调用时执行以下步骤:

  1. 返回 x + y

6.1.6.2.8 BigInt::subtract ( x, y )

抽象操作 BigInt::subtract 接受参数 x(一个 BigInt)和 y(一个 BigInt)并返回一个 BigInt。它在被调用时执行以下步骤:

  1. 返回 x - y

6.1.6.2.9 BigInt::leftShift ( x, y )

抽象操作 BigInt::leftShift 接受参数 x(一个 BigInt)和 y(一个 BigInt)并返回一个 BigInt。它在被调用时执行以下步骤:

  1. 如果 y < 0,则
    1. 返回 (floor((x) / 2-(y))).
  2. 返回 x × 2y.
这里的语义应该等同于按位左移,将 BigInt 视为无限长度的二进制补码数字字符串。

6.1.6.2.10 BigInt::signedRightShift ( x, y )

抽象操作 BigInt::signedRightShift 接受参数 x(一个 BigInt)和 y(一个 BigInt)并返回一个 BigInt。它在被调用时执行以下步骤:

  1. 返回 BigInt::leftShift(x, -y).

6.1.6.2.11 BigInt::unsignedRightShift ( x, y )

抽象操作 BigInt::unsignedRightShift 接受参数 x(一个 BigInt)和 y(一个 BigInt)并返回一个 抛出完成记录。它在被调用时执行以下步骤:

  1. 抛出一个 TypeError 异常。

6.1.6.2.12 BigInt::lessThan ( x, y )

抽象操作 BigInt::lessThan 接受参数 x(一个 BigInt)和 y(一个 BigInt)并返回一个布尔值。它在被调用时执行以下步骤:

  1. 如果 (x) < (y),返回 true;否则返回 false

6.1.6.2.13 BigInt::equal ( x, y )

抽象操作 BigInt::equal 接受参数 x(一个 BigInt)和 y(一个 BigInt)并返回一个布尔值。它在被调用时执行以下步骤:

  1. 如果 (x) = (y), 返回 true;否则返回 false

6.1.6.2.14 BinaryAnd ( x, y )

抽象操作 BinaryAnd 接受参数 x(0 或 1)和 y(0 或 1)并返回 0 或 1。它在被调用时执行以下步骤:

  1. 如果 x = 1 且 y = 1,返回 1。
  2. 否则,返回 0。

6.1.6.2.15 BinaryOr ( x, y )

抽象操作 BinaryOr 接受参数 x(0 或 1)和 y(0 或 1)并返回 0 或 1。它在被调用时执行以下步骤:

  1. 如果 x = 1 或 y = 1,返回 1。
  2. 否则,返回 0。

6.1.6.2.16 BinaryXor ( x, y )

抽象操作 BinaryXor 接受参数 x(0 或 1)和 y(0 或 1)并返回 0 或 1。它在被调用时执行以下步骤:

  1. 如果 x = 1 且 y = 0,返回 1。
  2. 否则如果 x = 0 且 y = 1,返回 1。
  3. 否则,返回 0。

6.1.6.2.17 BigInt位运算 ( op, x, y )

抽象操作 BigInt位运算 接受参数 op&^|)、x(一个 BigInt)和 y(一个 BigInt)并返回一个 BigInt。它在被调用时执行以下步骤:

  1. x 设置为 (x)。
  2. y 设置为 (y)。
  3. result 为 0。
  4. shift 为 0。
  5. 重复,直到 (x = 0 或 x = -1) 和 (y = 0 或 y = -1),
    1. xDigitx 取模 2。
    2. yDigity 取模 2。
    3. 如果 op&,那么
      1. result 设置为 result + 2shift × 按位与(xDigit, yDigit)。
    4. 否则如果 op|,那么
      1. result 设置为 result + 2shift × 按位或(xDigit, yDigit)。
    5. 否则
      1. 断言: op^
      2. result 设置为 result + 2shift × 按位异或(xDigit, yDigit)。
    6. shift 设置为 shift + 1。
    7. x 设置为 (x - xDigit) / 2。
    8. y 设置为 (y - yDigit) / 2。
  6. 如果 op&,那么
    1. tmp按位与(x 取模 2, y 取模 2)。
  7. 否则如果 op|,那么
    1. tmp按位或(x 取模 2, y 取模 2)。
  8. 否则
    1. 断言: op^
    2. tmp按位异或(x 取模 2, y 取模 2)。
  9. 如果 tmp ≠ 0,那么
    1. result 设置为 result - 2shift
    2. 注意:这扩展了符号位。
  10. 返回 BigInt 值 for result

6.1.6.2.18 BigInt::bitwiseAND ( x, y )

抽象操作 BigInt::bitwiseAND 接受参数 x(一个 BigInt)和 y(一个 BigInt)并返回一个 BigInt。它在调用时执行以下步骤:

  1. 返回 BigIntBitwiseOp(&, x, y)。

6.1.6.2.19 BigInt::bitwiseXOR ( x, y )

抽象操作 BigInt::bitwiseXOR 接受参数 x(一个 BigInt)和 y(一个 BigInt)并返回一个 BigInt。它在调用时执行以下步骤:

  1. 返回 BigIntBitwiseOp(^, x, y)。

6.1.6.2.20 BigInt::bitwiseOR ( x, y )

抽象操作 BigInt::bitwiseOR 接受参数 x(一个 BigInt)和 y(一个 BigInt)并返回一个 BigInt。它在调用时执行以下步骤:

  1. 返回 BigIntBitwiseOp(|, x, y)。

6.1.6.2.21 BigInt::toString ( x, radix )

抽象操作 BigInt::toString 接受参数 x(一个 BigInt)和 radix(一个在 2 到 36 之间的整数)并返回一个字符串。它使用基数 radixx 表示为字符串。使用基数 r 表示 BigInt 的数字取自 "0123456789abcdefghijklmnopqrstuvwxyz" 的前 r 个码元。除了 0 之外的 BigInt 表示永远不会包含前导零。它在调用时执行以下步骤:

  1. 如果 x < 0,返回 字符串连接"-"BigInt::toString(-x, radix)。
  2. 返回使用基数 radix 表示 x 的字符串值。

6.1.7 对象类型

每个 对象类型 的实例,也简称为“一个对象”,表示一个属性的集合。每个属性要么是一个数据属性,要么是一个访问器属性:

  • 一个 数据属性 将一个键值与一个 ECMAScript 语言值 和一个布尔属性集合关联起来。
  • 一个 访问器属性 将一个键值与一个或两个访问器函数以及一个布尔属性集合关联起来。访问器函数用于存储或检索与该属性相关联的 ECMAScript 语言值

对象的属性使用属性键唯一标识。一个 属性键 要么是一个字符串,要么是一个符号。所有字符串和符号,包括空字符串,都可以作为属性键。一个 属性名 是一个 字符串 的属性键。

一个 整数索引 是一个 属性名 n,使得 CanonicalNumericIndexString(n) 返回一个在 包含区间+0𝔽𝔽(253 - 1) 内的 整数。一个 数组索引 是一个 整数索引 n,使得 CanonicalNumericIndexString(n) 返回一个在 包含区间+0𝔽𝔽(232 - 2) 内的 整数

每个非负的 安全整数 都有一个对应的 整数索引。除了 232 - 1 之外的每个 32 位 无符号 整数 都有一个对应的 数组索引"-0" 既不是一个 整数索引 也不是 数组索引

属性键用于访问属性和它们的值。属性访问有两种类型:获取设置,分别对应于值的检索和赋值。通过获取和设置访问的属性包括 自有属性继承属性。继承属性可能是关联对象的自有属性或继承属性。每个对象的自有属性必须具有与其他自有属性不同的键值。

所有对象在逻辑上都是属性的集合,但有多种形式的对象,它们的属性访问和操作语义不同。请参见 6.1.7.2 以了解多种形式的对象的定义。

此外,一些对象是可调用的;这些被称为函数或 函数对象,并在下面进一步描述。ECMAScript 中的所有函数都是 Object 类型的成员。

6.1.7.1 属性属性

属性用于在本规范中定义和解释对象属性的状态,如 表 3 所述。除非明确指定,每个属性的初始值为其默认值。

表 3: 对象属性的属性
属性名称 存在的属性类型 值域 默认值 描述
[[Value]] 数据属性 ECMAScript 语言值 undefined 通过获取属性访问检索到的值。
[[Writable]] 数据属性 布尔值 false 如果为 false,尝试通过 ECMAScript 代码更改属性的 [[Value]] 属性将不会成功。
[[Get]] 访问器属性 对象或 undefined undefined 如果值 是一个对象,它必须是一个 函数对象。函数的 [[Call]] 内部方法(表 5)在每次执行属性获取访问时被调用,不带参数。
[[Set]] 访问器属性 对象或 undefined undefined 如果值 是一个对象,它必须是一个 函数对象。函数的 [[Call]] 内部方法(表 5)在每次执行属性设置访问时被调用,带有一个参数,即被赋的值。属性 [[Set]] 内部方法的效果可能,但不是必须,影响后续调用属性 [[Get]] 内部方法返回的值。
[[Enumerable]] 数据属性访问器属性 一个布尔值 false 如果 true,该属性将通过 for-in 枚举(见 14.7.5)进行枚举。 否则,该属性被称为不可枚举。
[[Configurable]] 数据属性访问器属性 一个布尔值 false 如果 false,尝试删除该属性,将其从 数据属性 变为 访问器属性 或 从 访问器属性 变为 数据属性,或对其属性进行任何更改(除了替换现有的 [[Value]] 或将 [[Writable]] 设置为 false)都将失败。

6.1.7.2 对象内部方法和内部槽

在 ECMAScript 中,对象的实际语义是通过称为 内部方法 的算法指定的。每个 ECMAScript 引擎中的对象都与一组内部方法相关联,这些方法定义了其运行时行为。这些内部方法不是 ECMAScript 语言的一部分。它们纯粹是为了说明目的而由本规范定义的。然而,ECMAScript 实现中的每个对象必须按照与其相关联的内部方法指定的行为方式行事。实现的具体方式由实现决定。

内部方法名称是多态的。这意味着不同的对象值在调用相同的内部方法名称时可能会执行不同的算法。实际调用内部方法的对象是调用的“目标”。如果在运行时,算法的实现尝试使用对象不支持的内部方法,则会抛出 TypeError 异常。

内部槽对应于与对象相关联并被各种 ECMAScript 规范算法使用的内部状态。内部槽不是对象属性,也不会被继承。 根据特定的内部槽规范,这种状态可能由任何 ECMAScript 语言类型 或特定的 ECMAScript 规范类型值组成。除非另有明确说明,内部槽作为创建对象过程的一部分进行分配,并且不能动态添加到对象中。除非另有说明,内部槽的初始值为 undefined。本规范中的各种算法创建具有内部槽的对象。然而,ECMAScript 语言没有直接的方法将内部槽与对象关联起来。

所有对象都有一个名为 [[PrivateElements]] 的内部槽,它是一个 ListPrivateElements。这个 List 表示对象的私有字段、方法和访问器的值。最初,它是一个空的 List

内部方法和内部槽在本规范中使用双括号 [[ ]] 括起来的名称进行标识。

表 4 总结了本规范使用的适用于所有由 ECMAScript 代码创建或操作的对象的 基本内部方法。每个对象都必须有所有基本内部方法的算法。然而,并非所有对象都必须对这些方法使用相同的算法。

一个 普通对象 是满足以下所有条件的对象:

  • 对于 表 4 中列出的内部方法,对象使用 10.1 中定义的那些。
  • 如果对象具有 [[Call]] 内部方法,它使用 10.2.110.3.1 中定义的其中之一。
  • 如果对象具有 [[Construct]] 内部方法,它使用 10.2.210.3.2 中定义的其中之一。

一个 异域对象 是一个不是 普通对象 的对象。

本规范通过这些对象的内部方法识别不同种类的 异域对象。一个对象在行为上等同于某种 异域对象(例如 数组异域对象绑定函数异域对象),但并不具有为该种类指定的相同内部方法集合,则不被识别为该种类的 异域对象

表 4 和其他类似表格的“签名”列描述了每个内部方法的调用模式。调用模式总是包括一个括号括起来的描述性参数名称列表。如果参数名称与 ECMAScript 类型名称相同,则该名称描述参数值的所需类型。如果内部方法显式返回一个值,其参数列表后跟符号“→”和返回值的类型名称。签名中使用的类型名称指的是第 6 条中定义的类型,增加了以下附加名称。“any”表示该值可以是任何 ECMAScript 语言类型

除了其参数外,内部方法总是可以访问作为方法调用目标的对象。

内部方法隐式返回一个 完成记录,要么是一个 正常完成,它包装了调用模式中显示的返回类型的值,要么是一个 抛出完成

表 4: 基本内部方法
内部方法 签名 描述
[[GetPrototypeOf]] ( ) Object | Null 确定为该对象提供继承属性的对象。null 值表示没有继承属性。
[[SetPrototypeOf]] (Object | Null) Boolean 将该对象与提供继承属性的另一个对象关联。传递 null 表示没有继承属性。返回 true 表示操作成功完成,或 false 表示操作不成功。
[[IsExtensible]] ( ) Boolean 确定是否允许向该对象添加更多属性。
[[PreventExtensions]] ( ) Boolean 控制是否可以向该对象添加新属性。返回 true 如果操作成功,或 false 如果操作不成功。
[[GetOwnProperty]] (propertyKey) Undefined | 属性描述符 返回该对象自身属性的 属性描述符,其键为 propertyKey,或 undefined 如果没有这样的属性。
[[DefineOwnProperty]] (propertyKey, 属性描述符) Boolean 创建或修改自身属性,其键为 propertyKey,具有 属性描述符 描述的状态。返回 true 如果属性成功创建/更新,或 false 如果属性无法创建或更新。
[[HasProperty]] (propertyKey) Boolean 返回一个布尔值,指示该对象是否已经具有键为 propertyKey 的自身或继承属性。
[[Get]] (propertyKey, Receiver) any 从该对象返回键为 propertyKey 的属性的值。如果需要执行 ECMAScript 代码来检索属性值,Receiver 用作评估代码时的 this 值。
[[Set]] (propertyKey, value, Receiver) Boolean 将键为 propertyKey 的属性的值设置为 value。如果需要执行 ECMAScript 代码来设置属性值,Receiver 用作评估代码时的 this 值。返回 true 如果属性值已设置,或 false 如果无法设置。
[[Delete]] (propertyKey) Boolean 从该对象中删除键为 propertyKey 的自身属性。如果属性未删除且仍存在,返回 false。如果属性已删除或不存在,返回 true
[[OwnPropertyKeys]] ( ) List of 属性键 返回一个 List,其元素是对象的所有自身 属性键

表 5 总结了可能被调用为函数的对象支持的额外基本内部方法。一个 函数对象 是支持 [[Call]] 内部方法的对象。一个 构造函数 是支持 [[Construct]] 内部方法的对象。每个支持 [[Construct]] 的对象必须支持 [[Call]];也就是说,每个 构造函数 必须是一个 函数对象。因此,一个 构造函数 也可以被称为 构造函数 函数构造函数 函数对象

表 5: 函数对象的额外基本内部方法
内部方法 签名 描述
[[Call]] (any, a List of any) any 执行与此对象关联的代码。通过函数调用表达式调用。内部方法的参数是一个 this 值和一个 List,其元素是通过调用表达式传递给函数的参数。实现此内部方法的对象是 可调用的
[[Construct]] (a List of any, Object) Object 创建一个对象。通过 new 运算符或 super 调用调用。内部方法的第一个参数是一个 List,其元素是 构造函数 调用或 super 调用的参数。第二个参数是最初应用 new 运算符的对象。实现此内部方法的对象称为 构造函数。一个 函数对象 不一定是 构造函数,并且这些非 构造函数 函数对象 没有 [[Construct]] 内部方法。

普通对象和标准异域对象的基本内部方法的语义在第 10 条中指定。如果实现不支持异域对象的任何指定内部方法的使用,则必须在尝试时抛出 TypeError 异常。

6.1.7.3 基本内部方法的不变性

ECMAScript引擎中对象的内部方法必须符合下面指定的不变性列表。普通ECMAScript对象以及本规范中的所有标准异域对象都保持这些不变性。ECMAScript代理对象通过在[[ProxyHandler]] 对象上调用的陷阱结果上进行运行时检查来保持这些不变性。

任何实现提供的异域对象也必须为这些对象保持这些不变性。违反这些不变性可能导致ECMAScript代码行为不可预测并产生安全问题。然而,违反这些不变性绝不能损害实现的内存安全。

实现不得以任何方式允许绕过这些不变性,例如通过提供实现基本内部方法功能的替代接口而不强制执行其不变性。

定义:

  • 内部方法的目标是调用内部方法的对象。
  • 如果目标对象的[[IsExtensible]]内部方法返回false,或者其[[PreventExtensions]]内部方法返回true,则该目标是不可扩展的
  • 不存在的属性是不可扩展目标对象上不存在的自有属性。
  • 所有对SameValue的引用均根据SameValue算法的定义。

返回值:

任何内部方法返回的值必须是一个Completion Record,具有以下任一形式:

  • [[Type]] = normal[[Target]] = empty,和[[Value]] = 该内部方法显示的“正常返回类型”的值,或
  • [[Type]] = throw[[Target]] = empty,和[[Value]] = 任何ECMAScript语言值
注 1

内部方法不得返回continue completionbreak completionreturn completion

[[GetPrototypeOf]] ( )

  • 正常返回类型是Object或Null。
  • 如果目标对象是不可扩展的,并且[[GetPrototypeOf]]返回一个值V,那么任何未来的[[GetPrototypeOf]]调用应返回与V相同的SameValue
注 2

一个对象的原型链应该具有有限长度(即,从任何对象开始,递归地将其[[GetPrototypeOf]]内部方法应用于其结果最终应导致值null)。然而,如果原型链包括任何不使用普通对象定义的[[GetPrototypeOf]]异域对象,则此要求作为对象级别的不变性是不可执行的。这样的循环原型链可能会在访问对象属性时导致无限循环。

[[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 )的调用必须返回Property Descriptor,其[[Value]]P[[Value]]属性相同SameValue
  • 如果P的除了[[Writable]][[Value]]之外的属性可能会随时间变化,或者如果该属性可能会被删除,那么P[[Configurable]]属性必须是true
  • 如果[[Writable]]属性可能从false变为true,那么[[Configurable]]属性必须是true
  • 如果目标对象是不可扩展的且P不存在,那么所有未来对该目标对象的[[GetOwnProperty]] ( P )调用必须将P描述为不存在(即[[GetOwnProperty]] ( P )必须返回undefined)。
注 3

由于第三个不变性的结果,如果一个属性被描述为数据属性并且它可能会随时间返回不同的值,那么[[Writable]][[Configurable]]属性中至少有一个必须是true,即使没有通过其他基本内部方法暴露改变值的机制。

[[DefineOwnProperty]] ( P, Desc )

  • 正常返回类型是Boolean。
  • [[DefineOwnProperty]]必须返回false,如果P之前已被观察为目标对象的不可配置自有属性,除非:
    1. P是一个可写的数据属性。一个不可配置的可写数据属性可以被改变为一个不可配置的不可写数据属性
    2. Desc的所有属性与P的属性相同SameValue
  • [[DefineOwnProperty]] ( P, Desc ) 必须返回false,如果目标对象是不可扩展的且P是一个不存在的自有属性。也就是说,一个不可扩展的目标对象不能被扩展新的属性。

[[HasProperty]] ( P )

  • 正常返回类型是Boolean。
  • 如果P之前已被观察为目标对象的不可配置自有数据或访问器属性[[HasProperty]]必须返回true

[[Get]] ( P, Receiver )

  • 正常返回类型是任何ECMAScript语言类型
  • 如果P之前已被观察为目标对象的不可配置、不可写的自有数据属性,其值为V,那么[[Get]]必须返回与V相同的SameValue
  • 如果P之前已被观察为目标对象的不可配置自有访问器属性,其[[Get]]属性为undefined[[Get]]操作必须返回undefined

[[Set]] ( P, V, Receiver )

  • 正常返回类型是Boolean。
  • 如果P之前已被观察为目标对象的不可配置、不可写的自有数据属性,那么[[Set]]必须返回false,除非VP[[Value]]属性相同SameValue
  • 如果P之前已被观察为目标对象的不可配置自有访问器属性,其[[Set]]属性为undefined[[Set]]操作必须返回false

[[Delete]] ( P )

  • 正常返回类型是Boolean。
  • 如果P之前已被观察为目标对象的不可配置自有数据或访问器属性[[Delete]]必须返回false

[[OwnPropertyKeys]] ( )

  • 正常返回类型是List
  • 返回的List不得包含任何重复条目。
  • 返回的List的每个元素的类型必须是String或Symbol。
  • 返回的List必须至少包含所有之前观察到的不可配置自有属性的键。
  • 如果目标对象是不可扩展的,返回的List必须仅包含目标对象的所有自有属性的键,这些属性可通过[[GetOwnProperty]]观察到。

[[Call]] ( )

[[Construct]] ( )

  • 正常返回类型是Object。
  • 目标对象还必须具有[[Call]]内部方法。

6.1.7.4 众所周知的内在对象

众所周知的内在对象是内置对象,它们在本规范的算法中被明确引用,并且通常具有与领域相关的身份。除非另有说明,每个内在对象实际上对应于一组类似的对象,每个领域一个。

在本规范中,诸如%name%的引用意味着与当前领域相关联的内在对象,对应于该名称。诸如%name.a.b%的引用意味着,在任何ECMAScript代码被评估之前,访问内在对象%name%的"a"属性的"b"属性。当前领域及其内在对象的确定在9.4中描述。众所周知的内在对象列在表6中。

表 6:众所周知的内置对象
内置名称 全局名称 ECMAScript 语言关联
%AggregateError% AggregateError AggregateError 构造函数 (20.5.7.1)
%Array% Array Array 构造函数 (23.1.1)
%ArrayBuffer% ArrayBuffer ArrayBuffer 构造函数 (25.1.4)
%ArrayIteratorPrototype% 数组迭代器对象的原型 (23.1.5)
%AsyncFromSyncIteratorPrototype% async-from-sync 迭代器对象的原型 (27.1.4)
%AsyncFunction% 异步函数对象的构造函数 (27.7.1)
%AsyncGeneratorFunction% 异步迭代器对象的构造函数 (27.4.1)
%AsyncIteratorPrototype% 所有标准内置异步迭代器对象间接继承的对象
%Atomics% Atomics Atomics 对象 (25.4)
%BigInt% BigInt BigInt 构造函数 (21.2.1)
%BigInt64Array% BigInt64Array BigInt64Array 构造函数 (23.2)
%BigUint64Array% BigUint64Array BigUint64Array 构造函数 (23.2)
%Boolean% 布尔值 布尔值 构造函数 (20.3.1)
%DataView% 数据视图 数据视图 构造函数 (25.3.2)
%Date% Date Date 构造函数 (21.4.2)
%decodeURI% decodeURI decodeURI 函数 (19.2.6.1)
%decodeURIComponent% decodeURIComponent decodeURIComponent 函数 (19.2.6.2)
%encodeURI% encodeURI encodeURI 函数 (19.2.6.3)
%encodeURIComponent% encodeURIComponent encodeURIComponent 函数 (19.2.6.4)
%Error% Error Error 构造函数 (20.5.1)
%eval% eval eval 函数 (19.2.1)
%EvalError% EvalError EvalError 构造函数 (20.5.5.1)
%FinalizationRegistry% FinalizationRegistry FinalizationRegistry 构造函数 (26.2.1)
%Float32Array% Float32Array Float32Array 构造函数 (23.2)
%Float64Array% Float64Array Float64Array 构造函数 (23.2)
%ForInIteratorPrototype% For-In 迭代器对象的原型 (14.7.5.10)
%Function% Function Function 构造函数 (20.2.1)
%GeneratorFunction% 生成器的构造函数 (27.3.1)
%Int8Array% Int8Array Int8Array 构造函数 (23.2)
%Int16Array% Int16Array Int16Array 构造函数 (23.2)
%Int32Array% Int32Array Int32Array 构造函数 (23.2)
%isFinite% isFinite isFinite 函数 (19.2.2)
%isNaN% isNaN isNaN 函数 (19.2.3)
%IteratorPrototype% 所有标准内置迭代器对象间接继承的对象
%JSON% JSON JSON 对象 (25.5)
%Map% Map Map 构造函数 (24.1.1)
%MapIteratorPrototype% Map 迭代器对象的原型 (24.1.5)
%Math% Math Math 对象 (21.3)
%Number% Number Number 构造函数 (21.1.1)
%Object% Object Object 构造函数 (20.1.1)
%parseFloat% parseFloat parseFloat 函数 (19.2.4)
%parseInt% parseInt parseInt 函数 (19.2.5)
%Promise% Promise Promise 构造函数 (27.2.3)
%Proxy% Proxy Proxy 构造函数 (28.2.1)
%RangeError% RangeError RangeError 构造函数 (20.5.5.2)
%ReferenceError% ReferenceError ReferenceError 构造函数 (20.5.5.3)
%Reflect% Reflect Reflect 对象 (28.1)
%RegExp% RegExp RegExp 构造函数 (22.2.4)
%RegExpStringIteratorPrototype% 正则表达式字符串迭代器对象的原型 (22.2.9)
%Set% Set Set 构造函数 (24.2.1)
%SetIteratorPrototype% Set 迭代器对象的原型 (24.2.5)
%SharedArrayBuffer% SharedArrayBuffer SharedArrayBuffer 构造函数 (25.2.3)
%String% String String 构造函数 (22.1.1)
%StringIteratorPrototype% 字符串迭代器对象的原型 (22.1.5)
%Symbol% Symbol Symbol 构造函数 (20.4.1)
%SyntaxError% SyntaxError SyntaxError 构造函数 (20.5.5.4)
%ThrowTypeError% 一个 函数对象,它会无条件抛出一个新的 %TypeError% 实例
%TypedArray% 所有类型化数组 构造函数 的超类 (23.2.1)
%TypeError% TypeError TypeError 构造函数 (20.5.5.5)
%Uint8Array% Uint8Array Uint8Array 构造函数 (23.2)
%Uint8ClampedArray% Uint8ClampedArray Uint8ClampedArray 构造函数 (23.2)
%Uint16Array% Uint16Array Uint16Array 构造函数 (23.2)
%Uint32Array% Uint32Array Uint32Array 构造函数 (23.2)
%URIError% URIError URIError 构造函数 (20.5.5.6)
%WeakMap% WeakMap WeakMap 构造函数 (24.3.1)
%WeakRef% WeakRef WeakRef 构造函数 (26.1.1)
%WeakSet% WeakSet WeakSet 构造函数 (24.4.1)

表 97 中有额外的条目。

6.2 ECMAScript 规范类型

规范类型对应于在算法中使用的元值,用于描述 ECMAScript 语言结构和 ECMAScript 语言类型 的语义。规范类型包括引用(Reference)、列表(List)完成记录(Completion Record)属性描述符(Property Descriptor)环境记录(Environment Record)抽象闭包(Abstract Closure)数据块(Data Block)。规范类型值是规范的产物,不一定对应于 ECMAScript 实现中的任何特定实体。规范类型值可用于描述 ECMAScript 表达式评估的中间结果,但这些值不能存储为对象的属性或 ECMAScript 语言变量的值。

6.2.1 枚举规范类型

枚举是规范内部的值,不能直接从 ECMAScript 代码中观察到。枚举用 sans-serif 字体表示。例如,完成记录[[Type]] 字段取值如 normalreturnthrow。枚举除了名称外没有其他特征。枚举的名称仅用于区分其他枚举,并不暗示其在上下文中的使用或意义。

6.2.2 列表和记录规范类型

列表类型用于解释参数列表的评估(参见 13.3.8)在 new 表达式、函数调用和其他需要简单有序值列表的算法中。列表类型的值是包含各个值的列表元素的简单有序序列。这些序列可以是任意长度的。列表元素可以使用基于 0 的索引随机访问。为了表示方便,可以使用类似数组的语法来访问列表元素。例如,arguments[2] 是表示列表 arguments 的第 3 个元素的简写。

当算法迭代列表元素而不指定顺序时,使用的顺序是列表中元素的顺序。

为了在本规范中表示方便,可以使用字面量语法来表示新的列表值。例如,« 1, 2 » 定义了一个包含两个元素的列表值,每个元素初始化为特定值。一个新的空列表可以表示为 « »。

在本规范中,短语“列表连接 AB、...”(其中每个参数是一个可能为空的列表)表示一个新列表值,其元素是每个参数(按顺序)的元素(按顺序)的连接。

记录类型用于描述本规范算法中的数据聚合。记录类型值由一个或多个命名字段组成。每个字段的值是一个 ECMAScript 语言值 或规范值。字段名称总是用双括号括起来,例如 [[Value]]

为了在本规范中表示方便,可以使用类似对象字面量的语法来表示记录值。例如,{ [[Field1]]: 42, [[Field2]]: false, [[Field3]]: empty } 定义了一个包含三个字段的记录值,每个字段初始化为特定值。字段名称的顺序不重要。任何未明确列出的字段都被认为是缺席的。

在规范文本和算法中,可以使用点表示法来引用记录值的特定字段。例如,如果 R 是前一段中显示的记录,则 R.[[Field2]] 是“R 中名为 [[Field2]] 的字段”的简写。

常用记录字段组合的模式可以命名,并且该名称可以用作字面量记录值的前缀,以标识所描述的特定聚合类型。例如:PropertyDescriptor { [[Value]]: 42, [[Writable]]: false, [[Configurable]]: true }。

6.2.3 集合和关系规范类型

集合类型用于解释 内存模型 中使用的无序元素集合。它不同于同名的 ECMAScript 集合类型。为了消除歧义,本规范中始终将 ECMAScript 集合实例称为“Set 对象”。集合类型的值是简单元素集合,其中没有元素出现多次。可以向集合中添加和删除元素。集合可以进行并集、交集或差集运算。

关系类型用于解释对集合的约束。关系类型的值是其值域中值的有序对集合。例如,事件上的关系是事件的有序对集合。对于关系 RR 值域中的两个值 aba R b 是表示有序对 (a, b) 是 R 成员的简写。关系在某些条件下是最小的,当它是满足这些条件的最小关系时。

严格偏序是满足以下条件的关系值 R

  • 对于 R 域中的所有 abc

    • 不是 a R a,并且
    • 如果 a R bb R c,则 a R c
注 1

上述两个属性分别称为非自反性和传递性。

严格全序是满足以下条件的关系值 R

  • 对于 R 域中的所有 abc

    • aba R bb R a,并且
    • 不是 a R a,并且
    • 如果 a R bb R c,则 a R c
注 2

上述三个属性分别称为完全性、非自反性和传递性。

6.2.4 完成记录规范类型

完成记录规范类型用于解释值和控制流的运行时传播,例如执行非本地控制转移的语句(breakcontinuereturnthrow)的行为。

完成记录具有 表 7 中定义的字段。

表 7: 完成记录 字段
字段名称 含义
[[Type]] normalbreakcontinuereturnthrow 发生的完成类型。
[[Value]] 任何值,除了 完成记录 产生的值。
[[Target]] 字符串或 empty 定向控制转移的目标标签。

以下简短术语有时用于指代完成记录。

  • 正常完成指任何 [[Type]] 值为 normal 的完成记录。
  • 中断完成指任何 [[Type]] 值为 break 的完成记录。
  • 继续完成指任何 [[Type]] 值为 continue 的完成记录。
  • 返回完成指任何 [[Type]] 值为 return 的完成记录。
  • 抛出完成指任何 [[Type]] 值为 throw 的完成记录。
  • 异常完成指任何 [[Type]] 值不是 normal 的完成记录。
  • 某种类型的 正常完成包含[[Value]] 字段中包含该类型值的正常完成。

本规范中定义的可调用对象仅返回正常完成或抛出完成。返回任何其他类型的完成记录被视为编辑错误。

实现定义 的可调用对象必须返回正常完成或抛出完成。

6.2.4.1 NormalCompletion ( value )

抽象操作 NormalCompletion 接受参数 value(任何值,除了 完成记录)并返回一个 正常完成。它在调用时执行以下步骤:

  1. 返回 完成记录 { [[Type]]: normal, [[Value]]: value, [[Target]]: empty }.

6.2.4.2 ThrowCompletion ( value )

抽象操作 ThrowCompletion 接受参数 value(一个 ECMAScript 语言值)并返回一个 抛出完成。它在调用时执行以下步骤:

  1. 返回 完成记录 { [[Type]]: throw, [[Value]]: value, [[Target]]: empty }.

6.2.4.3 UpdateEmpty ( completionRecord, value )

抽象操作 UpdateEmpty 接受参数 completionRecord(一个 完成记录)和 value(任何值,除了 完成记录)并返回一个 完成记录。它在调用时执行以下步骤:

  1. 断言:如果 completionRecord返回完成抛出完成,则 completionRecord.[[Value]] 不是 empty
  2. 如果 completionRecord.[[Value]] 不是 empty,返回 ? completionRecord
  3. 返回 完成记录 { [[Type]]: completionRecord.[[Type]], [[Value]]: value, [[Target]]: completionRecord.[[Target]] }.

6.2.5 引用记录规范类型

引用记录类型用于解释 deletetypeof、赋值运算符、super 关键字 和其他语言特性的行为。例如,赋值运算符的左操作数预期会产生一个引用记录。

引用记录是已解析的名称或属性绑定;其字段由 表 8 定义。

表 8: 引用记录 字段
字段名称 含义
[[Base]] 一个 ECMAScript 语言值、一个 环境记录unresolvable 持有绑定的值或 环境记录[[Base]]unresolvable 表示绑定无法解析。
[[ReferencedName]] 字符串、符号或 私有名称 绑定的名称。如果 [[Base]] 值是 环境记录,则始终为字符串。
[[Strict]] 布尔值 true 如果引用记录源自 严格模式代码false 否则。
[[ThisValue]] 一个 ECMAScript 语言值empty 如果不是 empty,则引用记录表示使用 super 关键字 表达的属性绑定;它被称为 超级引用记录,其 [[Base]] 值永远不会是 环境记录。在这种情况下,[[ThisValue]] 字段保存创建引用记录时的 this 值。

以下 抽象操作 用于在本规范中操作引用记录:

6.2.5.1 IsPropertyReference ( V )

抽象操作 IsPropertyReference 接受参数 V(一个 引用记录)并返回一个布尔值。它在调用时执行以下步骤:

  1. 如果 V.[[Base]]unresolvable,返回 false
  2. 如果 V.[[Base]] 是一个 环境记录,返回 false;否则返回 true

6.2.5.2 IsUnresolvableReference ( V )

抽象操作 IsUnresolvableReference 接受参数 V(一个 引用记录)并返回一个布尔值。当调用时,它执行以下步骤:

  1. 如果 V.[[Base]]unresolvable,返回 true;否则返回 false

6.2.5.3 IsSuperReference ( V )

抽象操作 IsSuperReference 接受参数 V(一个 引用记录)并返回一个布尔值。当调用时,它执行以下步骤:

  1. 如果 V.[[ThisValue]] 不是 empty,返回 true;否则返回 false

6.2.5.4 IsPrivateReference ( V )

抽象操作 IsPrivateReference 接受参数 V(一个 引用记录)并返回一个布尔值。当调用时,它执行以下步骤:

  1. 如果 V.[[ReferencedName]]私有名称,返回 true;否则返回 false

6.2.5.5 GetValue ( V )

抽象操作 GetValue 接受参数 V(一个 引用记录 或一个 ECMAScript 语言值)并返回一个 正常完成包含 一个 ECMAScript 语言值 或一个 突然完成。当调用时,它执行以下步骤:

  1. 如果 V 不是一个 引用记录,返回 V
  2. 如果 IsUnresolvableReference(V) 是 true,抛出一个 ReferenceError 异常。
  3. 如果 IsPropertyReference(V) 是 true,那么
    1. baseObj 为 ? ToObject(V.[[Base]])。
    2. 如果 IsPrivateReference(V) 是 true,那么
      1. 返回 ? PrivateGet(baseObj, V.[[ReferencedName]])。
    3. 返回 ? baseObj.[[Get]](V.[[ReferencedName]], GetThisValue(V))。
  4. 否则,
    1. baseV.[[Base]]
    2. 断言base 是一个 环境记录
    3. 返回 ? base.GetBindingValue(V.[[ReferencedName]], V.[[Strict]])(见 9.1)。

在步骤 3.a 中可能创建的对象在上述抽象操作和 普通对象 [[Get]] 内部方法之外不可访问。实现可能会选择避免实际创建该对象。

6.2.5.6 PutValue ( V, W )

抽象操作 PutValue 接受参数 V(一个 引用记录 或一个 ECMAScript 语言值)和 W(一个 ECMAScript 语言值)并返回一个 正常完成包含 unused 或一个 突然完成。当调用时,它执行以下步骤:

  1. 如果 V 不是一个 引用记录,抛出一个 ReferenceError 异常。
  2. 如果 IsUnresolvableReference(V) 是 true,那么
    1. 如果 V.[[Strict]]true,抛出一个 ReferenceError 异常。
    2. globalObjGetGlobalObject()。
    3. 执行 ? Set(globalObj, V.[[ReferencedName]], W, false)。
    4. 返回 unused
  3. 如果 IsPropertyReference(V) 是 true,那么
    1. baseObj 为 ? ToObject(V.[[Base]])。
    2. 如果 IsPrivateReference(V) 是 true,那么
      1. 返回 ? PrivateSet(baseObj, V.[[ReferencedName]], W)。
    3. succeeded 为 ? baseObj.[[Set]](V.[[ReferencedName]], W, GetThisValue(V))。
    4. 如果 succeededfalseV.[[Strict]]true,抛出一个 TypeError 异常。
    5. 返回 unused
  4. 否则,
    1. baseV.[[Base]]
    2. 断言base 是一个 环境记录
    3. 返回 ? base.SetMutableBinding(V.[[ReferencedName]], W, V.[[Strict]])(见 9.1)。

在步骤 3.a 中可能创建的对象在上述抽象操作和 普通对象 [[Set]] 内部方法之外不可访问。实现可能会选择避免实际创建该对象。

6.2.5.7 GetThisValue ( V )

抽象操作GetThisValue接受参数V(一个引用记录)并返回一个ECMAScript语言值。它在调用时执行以下步骤:

  1. 断言IsPropertyReference(V) 是true
  2. 如果IsSuperReference(V) 是true,返回V.[[ThisValue]];否则返回V.[[Base]]

6.2.5.8 InitializeReferencedBinding ( V, W )

抽象操作InitializeReferencedBinding接受参数V(一个引用记录)和W(一个ECMAScript语言值)并返回一个正常完成包含 未使用或一个突然完成。它在调用时执行以下步骤:

  1. 断言IsUnresolvableReference(V) 是false
  2. baseV.[[Base]]
  3. 断言base是一个环境记录
  4. 返回 ? base.InitializeBinding(V.[[ReferencedName]], W)。

6.2.5.9 MakePrivateReference ( baseValue, privateIdentifier )

抽象操作MakePrivateReference接受参数baseValue(一个ECMAScript语言值)和privateIdentifier(一个字符串)并返回一个引用记录。它在调用时执行以下步骤:

  1. privEnv运行执行上下文的PrivateEnvironment。
  2. 断言privEnv不是null
  3. privateNameResolvePrivateIdentifier(privEnv, privateIdentifier)。
  4. 返回引用记录 { [[Base]]: baseValue, [[ReferencedName]]: privateName, [[Strict]]: true, [[ThisValue]]: empty }。

6.2.6 属性描述符规范类型

属性描述符类型用于解释对象属性属性的操作和具体化。属性描述符是一个记录,包含零个或多个字段,其中每个字段的名称是一个属性名称,其值是对应的属性值,如6.1.7.1中所指定。本规范中用于标记属性描述符记录的架构名称是“PropertyDescriptor”。

属性描述符值可以根据某些字段的存在或使用进一步分类为数据属性描述符和访问器属性描述符。数据属性描述符是包含名为[[Value]][[Writable]]的字段的描述符。访问器属性描述符是包含名为[[Get]][[Set]]的字段的描述符。任何属性描述符都可能包含名为[[Enumerable]][[Configurable]]的字段。属性描述符值不能同时是数据属性描述符和访问器属性描述符;然而,它可以既不是(在这种情况下,它是一个通用属性描述符)。一个完全填充的属性描述符是访问器属性描述符或数据属性描述符,并且具有表3中定义的所有对应字段。

以下抽象操作用于在本规范中操作属性描述符值:

6.2.6.1 IsAccessorDescriptor ( Desc )

抽象操作IsAccessorDescriptor接受参数Desc(一个属性描述符undefined)并返回一个布尔值。它在调用时执行以下步骤:

  1. 如果Descundefined,返回false
  2. 如果Desc[[Get]]字段,返回true
  3. 如果Desc[[Set]]字段,返回true
  4. 返回false

6.2.6.2 IsDataDescriptor ( Desc )

抽象操作IsDataDescriptor接受参数Desc(一个属性描述符undefined)并返回一个布尔值。它在调用时执行以下步骤:

  1. 如果Descundefined,返回false
  2. 如果Desc[[Value]]字段,返回true
  3. 如果Desc[[Writable]]字段,返回true
  4. 返回false

6.2.6.3 IsGenericDescriptor ( Desc )

抽象操作IsGenericDescriptor接受参数Desc(一个属性描述符undefined)并返回一个布尔值。它在调用时执行以下步骤:

  1. 如果Descundefined,返回false
  2. 如果IsAccessorDescriptor(Desc) 是true,返回false
  3. 如果IsDataDescriptor(Desc) 是true,返回false
  4. 返回true

6.2.6.4 FromPropertyDescriptor ( Desc )

抽象操作FromPropertyDescriptor接受参数Desc(一个属性描述符undefined)并返回一个对象或undefined。它在调用时执行以下步骤:

  1. 如果Descundefined,返回undefined
  2. objOrdinaryObjectCreate(%Object.prototype%)。
  3. 断言obj是一个可扩展的普通对象,没有自己的属性。
  4. 如果Desc[[Value]]字段,则
    1. 执行! CreateDataPropertyOrThrow(obj, "value", Desc.[[Value]])。
  5. 如果Desc[[Writable]]字段,则
    1. 执行! CreateDataPropertyOrThrow(obj, "writable", Desc.[[Writable]])。
  6. 如果Desc[[Get]]字段,则
    1. 执行! CreateDataPropertyOrThrow(obj, "get", Desc.[[Get]])。
  7. 如果Desc[[Set]]字段,则
    1. 执行! CreateDataPropertyOrThrow(obj, "set", Desc.[[Set]])。
  8. 如果Desc[[Enumerable]]字段,则
    1. 执行! CreateDataPropertyOrThrow(obj, "enumerable", Desc.[[Enumerable]])。
  9. 如果Desc[[Configurable]]字段,则
    1. 执行! CreateDataPropertyOrThrow(obj, "configurable", Desc.[[Configurable]])。
  10. 返回obj

6.2.6.5 ToPropertyDescriptor ( Obj )

抽象操作ToPropertyDescriptor接受参数Obj(一个ECMAScript语言值)并返回一个正常完成包含一个属性描述符或一个抛出完成。它在调用时执行以下步骤:

  1. 如果Obj不是一个对象,抛出一个TypeError异常。
  2. desc为一个新属性描述符,最初没有字段。
  3. hasEnumerable为? HasProperty(Obj, "enumerable")。
  4. 如果hasEnumerabletrue,则
    1. enumerableToBoolean(? Get(Obj, "enumerable"))。
    2. desc.[[Enumerable]]enumerable
  5. hasConfigurable为? HasProperty(Obj, "configurable")。
  6. 如果hasConfigurabletrue,则
    1. configurableToBoolean(? Get(Obj, "configurable"))。
    2. desc.[[Configurable]]configurable
  7. hasValue为? HasProperty(Obj, "value")。
  8. 如果hasValuetrue,则
    1. value为? Get(Obj, "value")。
    2. desc.[[Value]]value
  9. hasWritable为? HasProperty(Obj, "writable")。
  10. 如果hasWritabletrue,则
    1. writableToBoolean(? Get(Obj, "writable"))。
    2. desc.[[Writable]]writable
  11. hasGet为? HasProperty(Obj, "get")。
  12. 如果hasGettrue,则
    1. getter为? Get(Obj, "get")。
    2. 如果IsCallable(getter)是falsegetter不是undefined,抛出一个TypeError异常。
    3. desc.[[Get]]getter
  13. hasSet为? HasProperty(Obj, "set")。
  14. 如果hasSettrue,则
    1. setter为? Get(Obj, "set")。
    2. 如果IsCallable(setter)是falsesetter不是undefined,抛出一个TypeError异常。
    3. desc.[[Set]]setter
  15. 如果desc[[Get]]字段或desc[[Set]]字段,则
    1. 如果desc[[Value]]字段或desc[[Writable]]字段,抛出一个TypeError异常。
  16. 返回desc

6.2.6.6 CompletePropertyDescriptor ( Desc )

抽象操作CompletePropertyDescriptor接受参数Desc(一个属性描述符)并返回未使用。它在调用时执行以下步骤:

  1. like记录 { [[Value]]: undefined, [[Writable]]: false, [[Get]]: undefined, [[Set]]: undefined, [[Enumerable]]: false, [[Configurable]]: false }。
  2. 如果IsGenericDescriptor(Desc) 是trueIsDataDescriptor(Desc) 是true,则
    1. 如果Desc没有[[Value]]字段,设Desc.[[Value]]like.[[Value]]
    2. 如果Desc没有[[Writable]]字段,设Desc.[[Writable]]like.[[Writable]]
  3. 否则
    1. 如果Desc没有[[Get]]字段,设Desc.[[Get]]like.[[Get]]
    2. 如果Desc没有[[Set]]字段,设Desc.[[Set]]like.[[Set]]
  4. 如果Desc没有[[Enumerable]]字段,设Desc.[[Enumerable]]like.[[Enumerable]]
  5. 如果Desc没有[[Configurable]]字段,设Desc.[[Configurable]]like.[[Configurable]]
  6. 返回未使用

6.2.7 环境记录规范类型

环境记录类型用于解释嵌套函数和块中的名称解析行为。这种类型及其操作在9.1中定义。

6.2.8 抽象闭包规范类型

抽象闭包规范类型用于引用算法步骤以及一组值。抽象闭包通过函数应用风格调用,例如closure(arg1, arg2)。与抽象操作类似,调用抽象闭包时执行其描述的算法步骤。

在创建抽象闭包的算法步骤中,值通过“捕获”动词后跟别名列表来捕获。当创建抽象闭包时,它会捕获创建时与每个别名关联的值。在指定抽象闭包被调用时要执行的算法步骤中,每个捕获的值通过用于捕获该值的别名来引用。

如果抽象闭包返回一个完成记录,该完成记录必须是正常完成抛出完成

抽象闭包作为其他算法的一部分内联创建,如下例所示。

  1. addend为41。
  2. closure为一个新抽象闭包,参数为(x),捕获addend,并在调用时执行以下步骤:
    1. 返回x + addend
  3. valclosure(1)。
  4. 断言val为42。

6.2.9 数据块

数据块规范类型用于描述一个独特且可变的字节大小(8位)数值序列。字节值是一个整数,范围在包含区间从0到255。 数据块值在创建时具有固定数量的字节,每个字节的初始值为0。

为了在本规范中表示方便,可以使用类似数组的语法来访问数据块值的各个字节。这种表示法将数据块值呈现为从0开始的整数索引字节序列。例如,如果db是一个5字节的数据块值,则db[2]可以用来访问其第3个字节。

驻留在可以被多个代理并发引用的内存中的数据块被称为共享数据块。共享数据块具有地址无关的身份(用于测试共享数据块值的相等性):它不绑定到任何进程中块映射到的虚拟地址,而是绑定到块表示的内存位置集合。两个数据块相等仅当它们包含的位置集合相等;否则,它们不相等,并且它们包含的位置集合的交集为空。最后,共享数据块可以与数据块区分开来。

共享数据块的语义通过共享数据块事件内存模型定义。抽象操作引入共享数据块事件,并作为评估语义和内存模型的事件语义之间的接口。事件形成一个候选执行,内存模型在此基础上充当过滤器。请查阅内存模型以获取完整语义。

共享数据块事件记录建模,定义在内存模型中。

以下抽象操作用于在本规范中操作数据块值:

6.2.9.1 CreateByteDataBlock ( size )

抽象操作CreateByteDataBlock接受参数size(一个非负整数)并返回一个正常完成包含一个数据块或一个抛出完成。它在调用时执行以下步骤:

  1. 如果size > 253 - 1,抛出一个RangeError异常。
  2. db为一个新数据块值,包含size字节。如果无法创建这样的数据块,抛出一个RangeError异常。
  3. db的所有字节设置为0。
  4. 返回db

6.2.9.2 CreateSharedByteDataBlock ( size )

抽象操作 CreateSharedByteDataBlock 接受参数 size(一个非负的 整数) 并返回一个 正常完成记录 包含一个 共享数据块 或一个 抛出完成记录。它在被调用时执行以下步骤:

  1. db 为一个由 size 字节组成的新 共享数据块 值。如果无法创建这样的 共享数据块,则抛出一个 RangeError 异常。
  2. execution周围代理代理记录[[CandidateExecution]] 字段。
  3. eventsRecordexecution.[[EventsRecords]]代理事件记录,其 [[AgentSignifier]]代理标识符()。
  4. zero 为 « 0 »。
  5. 对于 db 的每个索引 i,执行以下步骤:
    1. 写共享内存 { [[Order]]: init, [[NoTear]]: true, [[Block]]: db, [[ByteIndex]]: i, [[ElementSize]]: 1, [[Payload]]: zero } 追加到 eventsRecord.[[EventList]]
  6. 返回 db

6.2.9.3 CopyDataBlockBytes ( toBlock, toIndex, fromBlock, fromIndex, count )

抽象操作 CopyDataBlockBytes 接受参数 toBlock(一个 数据块 或一个 共享数据块), toIndex(一个非负的 整数),fromBlock(一个 数据块 或一个 共享数据块),fromIndex(一个非负的 整数),和 count(一个非负的 整数)并返回 unused。它在被调用时执行以下步骤:

  1. 断言fromBlocktoBlock 是不同的值。
  2. fromSizefromBlock 中的字节数。
  3. 断言fromIndex + countfromSize
  4. toSizetoBlock 中的字节数。
  5. 断言toIndex + counttoSize
  6. 重复,当 count > 0 时,执行以下步骤:
    1. 如果 fromBlock 是一个 共享数据块,则
      1. execution周围代理代理记录[[CandidateExecution]] 字段。
      2. eventsRecordexecution.[[EventsRecords]]代理事件记录,其 [[AgentSignifier]]代理标识符()。
      3. bytes 为一个 列表,其唯一元素是一个不确定选择的 字节值
      4. 注意:在实现中,bytes 是底层硬件上非原子读指令的结果。这种不确定性是 内存模型 的语义描述,用于描述具有弱一致性硬件的可观察行为。
      5. readEvent读共享内存 { [[Order]]: unordered, [[NoTear]]: true, [[Block]]: fromBlock, [[ByteIndex]]: fromIndex, [[ElementSize]]: 1 }。
      6. readEvent 追加到 eventsRecord.[[EventList]]
      7. 选择值记录 { [[Event]]: readEvent, [[ChosenValue]]: bytes } 追加到 execution.[[ChosenValues]]
      8. 如果 toBlock 是一个 共享数据块,则
        1. 写共享内存 { [[Order]]: unordered, [[NoTear]]: true, [[Block]]: toBlock, [[ByteIndex]]: toIndex, [[ElementSize]]: 1, [[Payload]]: bytes } 追加到 eventsRecord.[[EventList]]
      9. 否则,
        1. toBlock[toIndex] 设置为 bytes[0]。
    2. 否则,
      1. 断言toBlock 不是一个 共享数据块
      2. toBlock[toIndex] 设置为 fromBlock[fromIndex]。
    3. toIndex 设置为 toIndex + 1。
    4. fromIndex 设置为 fromIndex + 1。
    5. count 设置为 count - 1。
  7. 返回 unused

6.2.10 私有元素规范类型

私有元素类型是一个 记录,用于规范私有类字段、方法和访问器。尽管 属性描述符 不适用于私有元素,但私有字段的行为类似于不可配置、不可枚举、可写的 数据属性,私有方法的行为类似于不可配置、不可枚举、不可写的 数据属性,私有访问器的行为类似于不可配置、不可枚举的 访问器属性

私有元素类型的值是 记录 值,其字段由 表 9 定义。这些值被称为 私有元素

表 9: 私有元素 字段
字段名称 [[Kind]] 字段值 含义
[[Key]] 所有 一个 私有名称 字段、方法或访问器的名称。
[[Kind]] 所有 field, method, 或 accessor 元素的种类。
[[Value]] fieldmethod 一个 ECMAScript 语言值 字段的值。
[[Get]] accessor 一个 函数对象undefined 私有访问器的 getter。
[[Set]] accessor 一个 函数对象undefined 私有访问器的 setter。

6.2.11 类字段定义记录规范类型

类字段定义类型是一个 记录,用于规范类字段。

类字段定义类型的值是 记录 值,其字段由 表 10 定义。这些值被称为 类字段定义记录

表 10: 类字段定义记录 字段
字段名称 含义
[[Name]] 一个 私有名称、字符串或符号 字段的名称。
[[Initializer]] 一个 ECMAScript 函数对象empty 字段的初始化器(如果有)。

6.2.12 私有名称

私有名称规范类型用于描述一个全局唯一的值(不同于任何其他私有名称,即使它们在其他方面无法区分),该值表示私有类元素(字段、方法或访问器)的键。每个私有名称都有一个关联的不可变 [[Description]],它是一个 字符串 值。私有名称可以通过 PrivateFieldAddPrivateMethodOrAccessorAdd 安装在任何 ECMAScript 对象上,然后使用 PrivateGetPrivateSet 进行读取或写入。

6.2.13 类静态块定义记录规范类型

类静态块定义记录是一个 记录 值,用于封装类静态初始化块的可执行代码。

类静态块定义记录的字段列在 表 11 中。

表 11: 类静态块定义记录 字段
字段名称 含义
[[BodyFunction]] 一个 ECMAScript 函数对象 在类静态初始化期间调用的 函数对象

7 抽象操作

这些操作不是 ECMAScript 语言的一部分;它们在这里仅用于帮助规范 ECMAScript 语言的语义。其他更专业的 抽象操作 定义在本规范的其他部分。

7.1 类型转换

ECMAScript 语言在需要时隐式执行自动类型转换。为了阐明某些结构的语义,定义了一组转换 抽象操作。这些转换 抽象操作 是多态的;它们可以接受任何 ECMAScript 语言类型 的值。但其他规范类型不与这些操作一起使用。

ECMAScript 语言中的 BigInt 类型 没有隐式转换;程序员必须显式调用 BigInt 来从其他类型转换值。

7.1.1 ToPrimitive ( input [ , preferredType ] )

抽象操作 ToPrimitive 接受参数 input(一个 ECMAScript 语言值)和可选参数 preferredTypestringnumber)并返回一个 正常完成包含 一个 ECMAScript 语言值 或一个 抛出完成。它将其 input 参数转换为非 对象类型。如果对象能够转换为多种原始类型,它可能会使用可选提示 preferredType 来优先考虑该类型。它在被调用时执行以下步骤:

  1. 如果 input 是一个对象, then
    1. exoticToPrim 为 ? GetMethod(input, @@toPrimitive)。
    2. 如果 exoticToPrim 不是 undefined, then
      1. 如果 preferredType 不存在,则
        1. hint"default"
      2. 否则如果 preferredTypestring,则
        1. hint"string"
      3. 否则,
        1. 断言preferredTypenumber
        2. hint"number"
      4. result 为 ? Call(exoticToPrim, input, « hint »)。
      5. 如果 result 不是一个对象,返回 result
      6. 抛出一个 TypeError 异常。
    3. 如果 preferredType 不存在,令 preferredTypenumber
    4. 返回 ? OrdinaryToPrimitive(input, preferredType)。
  2. 返回 input

当 ToPrimitive 被调用时不带提示时,它的行为通常类似于提示为 number。然而,对象可以通过定义 @@toPrimitive 方法来覆盖这种行为。在本规范中,只有日期对象(参见 21.4.4.45)和符号对象(参见 20.4.3.5)覆盖了默认的 ToPrimitive 行为。日期对象将没有提示视为提示为 string

7.1.1.1 OrdinaryToPrimitive ( O, hint )

抽象操作 OrdinaryToPrimitive 接受参数 O(一个对象)和 hintstringnumber)并返回一个 正常完成包含 一个 ECMAScript 语言值 或一个 抛出完成。它在被调用时执行以下步骤:

  1. 如果 hintstring,则
    1. methodNames 为 « "toString", "valueOf" »。
  2. 否则,
    1. methodNames 为 « "valueOf", "toString" »。
  3. 对于 methodNames 的每个元素 name,执行
    1. method 为 ? Get(O, name)。
    2. 如果 IsCallable(method) is true,则
      1. result 为 ? Call(method, O)。
      2. 如果 result 不是一个对象,返回 result
  4. 抛出一个 TypeError 异常。

7.1.2 ToBoolean ( argument )

抽象操作 ToBoolean 接受参数 argument(一个 ECMAScript 语言值)并返回一个布尔值。它将 argument 转换为布尔类型。 它在被调用时执行以下步骤:

  1. 如果 argument 是一个布尔值,返回 argument
  2. 如果 argument 是以下之一:undefinednull+0𝔽-0𝔽NaN0 或空字符串,返回 false
  3. 注意:这一步在 B.3.6.1 中被替换。
  4. 返回 true

7.1.3 ToNumeric ( value )

抽象操作 ToNumeric 接受参数 value(一个 ECMAScript 语言值)并返回一个 正常完成包含 一个数字或 BigInt,或一个 抛出完成。它返回 value 转换为数字或 BigInt。它在被调用时执行以下步骤:

  1. primValue 为 ? ToPrimitive(value, number)。
  2. 如果 primValue 是一个 BigInt,返回 primValue
  3. 返回 ? ToNumber(primValue)。

7.1.4 ToNumber ( argument )

抽象操作 ToNumber 接受参数 argument(一个 ECMAScript 语言值)并返回一个 正常完成包含 一个数字或一个 抛出完成。它将 argument 转换为数字类型。它在被调用时执行以下步骤:

  1. 如果 argument 是一个数字,返回 argument
  2. 如果 argument 是符号或 BigInt,抛出一个 TypeError 异常。
  3. 如果 argumentundefined,返回 NaN
  4. 如果 argumentnullfalse,返回 +0𝔽
  5. 如果 argumenttrue,返回 1𝔽
  6. 如果 argument 是一个字符串,返回 StringToNumber(argument)。
  7. 断言argument 是一个对象
  8. primValue 为 ? ToPrimitive(argument, number)。
  9. 断言primValue 不是一个对象
  10. 返回 ? ToNumber(primValue)。

7.1.4.1 ToNumber 应用于字符串类型

抽象操作 StringToNumber 指定如何将字符串值转换为数字值,使用以下语法。

语法

StringNumericLiteral ::: StrWhiteSpaceopt StrWhiteSpaceopt StrNumericLiteral StrWhiteSpaceopt StrWhiteSpace ::: StrWhiteSpaceChar StrWhiteSpaceopt StrWhiteSpaceChar ::: WhiteSpace LineTerminator StrNumericLiteral ::: StrDecimalLiteral NonDecimalIntegerLiteral[~Sep] StrDecimalLiteral ::: StrUnsignedDecimalLiteral + StrUnsignedDecimalLiteral - StrUnsignedDecimalLiteral StrUnsignedDecimalLiteral ::: Infinity DecimalDigits[~Sep] . DecimalDigits[~Sep]opt ExponentPart[~Sep]opt . DecimalDigits[~Sep] ExponentPart[~Sep]opt DecimalDigits[~Sep] ExponentPart[~Sep]opt

所有未明确定义的语法符号均使用词法语法中为数字字面量定义的定义(12.9.3

应注意字符串数字字面量数字字面量的语法差异:

7.1.4.1.1 StringToNumber ( str )

抽象操作 StringToNumber 接受参数 str(一个字符串)并返回一个数字。 当调用时,它执行以下步骤:

  1. textStringToCodePoints(str).
  2. literalParseText(text, StringNumericLiteral).
  3. 如果 literal 是一个 List 的错误,返回 NaN.
  4. 返回 StringNumericValueliteral.

7.1.4.1.2 运行时语义:StringNumericValue

语法导向操作 StringNumericValue 不接受参数并返回一个数字。

StringNumericLiteral 转换为数字值的整体过程类似于确定 NumericValueNumericLiteral(见 12.9.3),但某些细节有所不同。

它在以下产生式上分段定义:

StringNumericLiteral ::: StrWhiteSpaceopt
  1. 返回 +0𝔽
StringNumericLiteral ::: StrWhiteSpaceopt StrNumericLiteral StrWhiteSpaceopt
  1. 返回 StringNumericValueStrNumericLiteral
StrNumericLiteral ::: NonDecimalIntegerLiteral
  1. 返回 𝔽(MV of NonDecimalIntegerLiteral)。
StrDecimalLiteral ::: - StrUnsignedDecimalLiteral
  1. aStringNumericValueStrUnsignedDecimalLiteral
  2. 如果 a+0𝔽,返回 -0𝔽
  3. 返回 -a
StrUnsignedDecimalLiteral ::: Infinity
  1. 返回 +∞𝔽
StrUnsignedDecimalLiteral ::: DecimalDigits . DecimalDigitsopt ExponentPartopt
  1. a 为第一个 DecimalDigits 的 MV。
  2. 如果第二个 DecimalDigits 存在,则
    1. b 为第二个 DecimalDigits 的 MV。
    2. n 为第二个 DecimalDigits 的代码点数。
  3. 否则,
    1. b 为 0。
    2. n 为 0。
  4. 如果 ExponentPart 存在,令 eExponentPart 的 MV。否则,令 e 为 0。
  5. 返回 RoundMVResult((a + (b × 10-n)) × 10e)。
StrUnsignedDecimalLiteral ::: . DecimalDigits ExponentPartopt
  1. bDecimalDigits 的 MV。
  2. 如果 ExponentPart 存在,令 eExponentPart 的 MV。否则,令 e 为 0。
  3. nDecimalDigits 的代码点数。
  4. 返回 RoundMVResult(b × 10e - n)。
StrUnsignedDecimalLiteral ::: DecimalDigits ExponentPartopt
  1. aDecimalDigits 的 MV。
  2. 如果 ExponentPart 存在,令 eExponentPart 的 MV。否则,令 e 为 0。
  3. 返回 RoundMVResult(a × 10e)。

7.1.4.1.3 RoundMVResult ( n )

抽象操作 RoundMVResult 接受参数 n(一个 mathematical value)并返回一个数字。它以一种实现定义的方式将 n 转换为数字。对于此抽象操作的目的,如果一个数字不是零,或者它的左边和右边都有非零数字,则该数字是重要的。对于此抽象操作的目的,“表示的 mathematical value”是“十进制表示”的逆。它执行以下步骤:

  1. 如果 n 的十进制表示有 20 个或更少的有效数字,返回 𝔽(n)。
  2. option1 为结果的 mathematical value,其中 n 的十进制表示中第 20 位之后的每个有效数字都被替换为 0。
  3. option2 为结果的 mathematical value,其中 n 的十进制表示中第 20 位之后的每个有效数字都被替换为 0,然后在第 20 位处递增(必要时进位)。
  4. chosen实现定义option1option2 的选择。
  5. 返回 𝔽(chosen)。

7.1.5 ToIntegerOrInfinity ( argument )

抽象操作 ToIntegerOrInfinity 接受参数 argument(一个 ECMAScript 语言 值)并返回一个 正常 完成包含 一个 整数、+∞ 或 -∞,或一个 抛出 完成。它将 argument 转换为一个 整数,表示其 数值的小数部分被截断,或者在数值为无穷大时转换为 +∞ 或 -∞。它在调用时执行以下步骤:

  1. number 为 ? ToNumber(argument).
  2. 如果 numberNaN+0𝔽-0𝔽,返回 0.
  3. 如果 number+∞𝔽, 返回 +∞.
  4. 如果 number-∞𝔽, 返回 -∞.
  5. 返回 truncate((number)).
𝔽(ToIntegerOrInfinity(x)) 永远不会返回 -0𝔽 对于任何 x 的值。小数部分的截断 是在将 x 转换为 数学 值 之后进行的。

7.1.6 ToInt32 ( argument )

抽象操作 ToInt32 接受参数 argument(一个 ECMAScript 语言 值)并返回一个 正常 完成包含 一个 整数 Number 或一个 抛出 完成。它将 argument 转换为 232整数 Number 值之一,范围在 包含区间𝔽(-231) 到 𝔽(231 - 1)。它在调用时执行以下步骤:

  1. number 为 ? ToNumber(argument).
  2. 如果 number 不是 有限number+0𝔽-0𝔽, 返回 +0𝔽.
  3. inttruncate((number)).
  4. int32bitint modulo 232.
  5. 如果 int32bit ≥ 231,返回 𝔽(int32bit - 232);否则返回 𝔽(int32bit).

根据上述 ToInt32 的定义:

  • ToInt32 抽象操作是幂等的:如果应用于其产生的结果,第二次应用不会改变该值。
  • ToInt32(ToUint32(x)) 与 ToInt32(x) 对于所有 x 的值是相同的。(为了保持这一特性,+∞𝔽-∞𝔽 被映射到 +0𝔽。)
  • ToInt32 将 -0𝔽 映射到 +0𝔽

7.1.7 ToUint32 ( argument )

抽象操作 ToUint32 接受参数 argument(一个 ECMAScript 语言 值)并返回一个 正常 完成包含 一个 整数 Number 或一个 抛出 完成。它将 argument 转换为 232整数 Number 值之一,范围在 包含区间+0𝔽𝔽(232 - 1)。它在调用时执行以下步骤:

  1. number 为 ? ToNumber(argument).
  2. 如果 number 不是 有限number+0𝔽-0𝔽, 返回 +0𝔽.
  3. inttruncate((number)).
  4. int32bitint modulo 232.
  5. 返回 𝔽(int32bit).

根据上述 ToUint32 的定义:

  • 步骤 5 是 ToUint32 和 ToInt32 之间的唯一区别。
  • ToUint32 抽象操作是幂等的:如果应用于其产生的结果,第二次应用不会改变该值。
  • ToUint32(ToInt32(x)) 与 ToUint32(x) 对于所有 x 的值是相同的。(为了保持这一特性,+∞𝔽-∞𝔽 被映射到 +0𝔽。)
  • ToUint32 将 -0𝔽 映射到 +0𝔽

7.1.8 ToInt16 ( argument )

抽象操作 ToInt16 接受参数 argument(一个 ECMAScript 语言值)并返回一个 正常完成,其中包含一个 整数,或者一个 抛出完成。它将 argument 转换为 216整数值之一,这些值位于 闭区间 𝔽(-215) 到 𝔽(215 - 1) 之间。调用时,它执行以下步骤:

  1. number 为 ? ToNumber(argument)。
  2. 如果 number 不是 有限的 或者 number+0𝔽-0𝔽,返回 +0𝔽
  3. int截断((number))。
  4. int16bitint 216
  5. 如果 int16bit ≥ 215,返回 𝔽(int16bit - 216);否则返回 𝔽(int16bit)。

7.1.9 ToUint16 ( argument )

抽象操作 ToUint16 接受参数 argument(一个 ECMAScript 语言值)并返回一个 正常完成,其中包含一个 整数,或者一个 抛出完成。它将 argument 转换为 216整数值之一,这些值位于 闭区间 +0𝔽𝔽(216 - 1) 之间。调用时,它执行以下步骤:

  1. number 为 ? ToNumber(argument)。
  2. 如果 number 不是 有限的 或者 number+0𝔽-0𝔽,返回 +0𝔽
  3. int截断((number))。
  4. int16bitint 216
  5. 返回 𝔽(int16bit)。

根据上述 ToUint16 的定义:

  • 在第 4 步中将 216 替换为 232 是 ToUint32 和 ToUint16 唯一的区别。
  • ToUint16 将 -0𝔽 映射为 +0𝔽

7.1.10 ToInt8 ( argument )

抽象操作 ToInt8 接受参数 argument(一个 ECMAScript 语言值),并返回一个 正常完成,其中包含一个 整数,或者一个 抛出完成。它将 argument 转换为 28整数值之一,这些值位于 闭区间 -128𝔽127𝔽 之间。调用时,它执行以下步骤:

  1. number 为 ? ToNumber(argument)。
  2. 如果 number 不是 有限的 或者 number+0𝔽-0𝔽,返回 +0𝔽
  3. int截断((number))。
  4. int8bitint 28
  5. 如果 int8bit ≥ 27,返回 𝔽(int8bit - 28);否则返回 𝔽(int8bit)。

7.1.11 ToUint8(argument

抽象操作ToUint8接受参数argument(一个ECMAScript语言值),并返回一个包含整数Number正常完成或一个抛出完成。它将argument转换为从+0𝔽255𝔽的28整数Number值中的一个,这些值在包含区间内。当被调用时,执行以下步骤:

  1. numberToNumber(argument)。
  2. 如果number不是有限的,或number+0𝔽-0𝔽,则返回+0𝔽
  3. int截断((number))。
  4. int8bitint 28
  5. 返回 𝔽(int8bit)。

7.1.12 ToUint8Clamp ( argument )

抽象操作 ToUint8Clamp 接受参数 argument(一个 ECMAScript 语言值),并返回一个 正常完成记录,包含 一个 整数 或一个 抛出完成记录。它将 argument 钳制和四舍五入到 28整数 值之一,在 闭区间+0𝔽255𝔽 之间。调用时执行以下步骤:

  1. number 为 ? ToNumber(argument)。
  2. 如果 numberNaN,返回 +0𝔽
  3. mvnumber 的扩展数学值
  4. clamped mv 钳制在 0 和 255 之间的结果。
  5. ffloor(clamped)。
  6. 如果 clamped < f + 0.5,返回 𝔽(f)。
  7. 如果 clamped > f + 0.5,返回 𝔽(f + 1)。
  8. 如果 f 是偶数,返回 𝔽(f)。否则,返回 𝔽(f + 1)。

与大多数其他 ECMAScript 整数 转换操作不同,ToUint8Clamp 是四舍五入而不是截断非整数值。它还使用“向偶数舍入”的中点舍入方法,这与 Math.round 的“向上舍入”方法不同。

7.1.13 ToBigInt ( argument )

抽象操作 ToBigInt 接受参数 argument(一个 ECMAScript 语言值),并返回一个 正常完成记录,包含 一个 BigInt 或一个 抛出完成记录。它将 argument 转换为 BigInt 值,或者在需要从 Number 隐式转换时抛出错误。调用时执行以下步骤:

  1. prim 为 ? ToPrimitive(argument, number)。
  2. 返回 prim表 12 中对应的值。
表 12: BigInt 转换
参数类型 结果
Undefined 抛出 TypeError 异常。
Null 抛出 TypeError 异常。
Boolean 如果 primtrue,返回 1n;如果 primfalse,返回 0n
BigInt 返回 prim
Number 抛出 TypeError 异常。
String
  1. nStringToBigInt(prim)。
  2. 如果 nundefined,抛出 SyntaxError 异常。
  3. 返回 n
Symbol 抛出 TypeError 异常。

7.1.14 StringToBigInt ( str )

抽象操作 StringToBigInt 接受参数 str(一个字符串)并返回一个 BigInt 或 undefined。调用时执行以下步骤:

  1. textStringToCodePoints(str)。
  2. literalParseText(text, StringIntegerLiteral)。
  3. 如果 literal 是一个 错误列表,返回 undefined
  4. mvliteral 的 MV。
  5. 断言mv 是一个 整数
  6. 返回 (mv)。

7.1.14.1 StringIntegerLiteral 语法

StringToBigInt 使用以下语法。

语法

StringIntegerLiteral ::: StrWhiteSpaceopt StrWhiteSpaceopt StrIntegerLiteral StrWhiteSpaceopt StrIntegerLiteral ::: SignedInteger[~Sep] NonDecimalIntegerLiteral[~Sep]

7.1.14.2 运行时语义:MV

7.1.15 ToBigInt64 ( argument )

抽象操作 ToBigInt64 接受参数 argument(一个 ECMAScript 语言值),并返回一个 正常完成记录,包含 一个 BigInt 或一个 抛出完成记录。它将 argument 转换为 264 个 BigInt 值之一,在 闭区间(-263) 到 (263 - 1)。调用时执行以下步骤:

  1. n 为 ? ToBigInt(argument)。
  2. int64bit(n) 取模 264
  3. 如果 int64bit ≥ 263,返回 (int64bit - 264);否则返回 (int64bit)。

7.1.16 ToBigUint64 ( argument )

抽象操作 ToBigUint64 接受参数 argument(一个 ECMAScript 语言值),并返回一个 正常完成记录,包含 一个 BigInt 或一个 抛出完成记录。它将 argument 转换为 264 个 BigInt 值之一,在 闭区间0(264 - 1)。调用时执行以下步骤:

  1. n 为 ? ToBigInt(argument)。
  2. int64bit(n) 取模 264
  3. 返回 (int64bit)。

7.1.17 ToString ( argument )

抽象操作 ToString 接受参数 argument(一个 ECMAScript 语言值),并返回一个 正常完成记录,包含 一个字符串或一个 抛出完成记录。它将 argument 转换为一个字符串类型的值。调用时执行以下步骤:

  1. 如果 argument 是一个字符串,返回 argument
  2. 如果 argument 是一个符号,抛出一个 TypeError 异常。
  3. 如果 argumentundefined,返回 "undefined"
  4. 如果 argumentnull,返回 "null"
  5. 如果 argumenttrue,返回 "true"
  6. 如果 argumentfalse,返回 "false"
  7. 如果 argument 是一个数字,返回 Number::toString(argument, 10)。
  8. 如果 argument 是一个 BigInt,返回 BigInt::toString(argument, 10)。
  9. 断言argument 是一个对象
  10. primValue 为 ? ToPrimitive(argument, string)。
  11. 断言primValue 不是一个对象
  12. 返回 ? ToString(primValue)。

7.1.18 ToObject ( argument )

抽象操作 ToObject 接受参数 argument(一个 ECMAScript 语言值),并返回一个 正常完成记录,包含 一个对象或一个 抛出完成记录。它根据 表 13argument 转换为对象类型的值:

表 13: ToObject 转换
参数类型 结果
Undefined 抛出一个 TypeError 异常。
Null 抛出一个 TypeError 异常。
Boolean 返回一个新的布尔对象,其 [[BooleanData]] 内部槽被设置为 argument。参见 20.3 获取布尔对象的描述。
Number 返回一个新的数字对象,其 [[NumberData]] 内部槽被设置为 argument。参见 21.1 获取数字对象的描述。
String 返回一个新的字符串对象,其 [[StringData]] 内部槽被设置为 argument。参见 22.1 获取字符串对象的描述。
Symbol 返回一个新的符号对象,其 [[SymbolData]] 内部槽被设置为 argument。参见 20.4 获取符号对象的描述。
BigInt 返回一个新的 BigInt 对象,其 [[BigIntData]] 内部槽被设置为 argument。参见 21.2 获取 BigInt 对象的描述。
Object 返回 argument

7.1.19 ToPropertyKey ( argument )

抽象操作 ToPropertyKey 接受参数 argument(一个 ECMAScript 语言值),并返回一个 正常完成记录,包含 一个 属性键 或一个 抛出完成记录。它将 argument 转换为可以用作 属性键 的值。调用时执行以下步骤:

  1. key 为 ? ToPrimitive(argument, string)。
  2. 如果 key 是一个符号,那么
    1. 返回 key
  3. 返回 ! ToString(key)。

7.1.20 ToLength ( argument )

抽象操作 ToLength 接受参数 argument(一个 ECMAScript 语言值),并返回一个 正常完成记录,包含 一个 整数 或一个 抛出完成记录。它将 argument 钳制和截取为一个适合作为 类数组对象 长度的 整数。调用时执行以下步骤:

  1. len 为 ? ToIntegerOrInfinity(argument)。
  2. 如果 len ≤ 0,返回 +0𝔽
  3. 返回 𝔽(min(len, 253 - 1))。

7.1.21 CanonicalNumericIndexString ( argument )

抽象操作 CanonicalNumericIndexString 接受参数 argument(一个字符串)并返回一个数字或 undefined。如果 argument"-0" 或完全匹配某个数字值 nToString(n) 的结果,则返回相应的数字值。否则,它返回 undefined。调用时执行以下步骤:

  1. 如果 argument"-0",返回 -0𝔽
  2. n 为 ! ToNumber(argument)。
  3. 如果 ! ToString(n) 是 argument,返回 n
  4. 返回 undefined

一个规范数字字符串是任何使 CanonicalNumericIndexString 抽象操作不返回 undefined 的字符串值。

7.1.22 ToIndex ( value )

抽象操作 ToIndex 接受参数 value(一个 ECMAScript 语言值),并返回一个 正常完成记录,包含 一个非负 整数 或一个 抛出完成记录。它将 value 转换为一个 整数,并返回该 整数,如果它是非负的并且对应于一个 整数索引。否则,它会抛出一个异常。调用时执行以下步骤:

  1. integer 为 ? ToIntegerOrInfinity(value)。
  2. 如果 integer 不在从 0 到 253 - 1 的 闭区间 内,抛出一个 RangeError 异常。
  3. 返回 integer

7.2 测试和比较操作

7.2.1 RequireObjectCoercible ( argument )

抽象操作 RequireObjectCoercible 接受参数 argument(一个 ECMAScript 语言值),并返回一个 正常完成记录,包含 一个 ECMAScript 语言值 或一个 抛出完成记录。如果 argument 是一个无法使用 ToObject 转换为对象的值,则抛出一个错误。其定义见 表 14

表 14: RequireObjectCoercible 结果
参数类型 结果
Undefined 抛出一个 TypeError 异常。
Null 抛出一个 TypeError 异常。
Boolean 返回 argument
Number 返回 argument
String 返回 argument
Symbol 返回 argument
BigInt 返回 argument
Object 返回 argument

7.2.2 IsArray ( argument )

抽象操作 IsArray 接受参数 argument(一个 ECMAScript 语言值),并返回一个 正常完成记录,包含 一个布尔值或一个 抛出完成记录。调用时执行以下步骤:

  1. 如果 argument 不是一个对象,返回 false
  2. 如果 argument 是一个 数组异质对象,返回 true
  3. 如果 argument 是一个 代理异质对象,那么
    1. 执行 ? ValidateNonRevokedProxy(argument)。
    2. proxyTargetargument.[[ProxyTarget]]
    3. 返回 ? IsArray(proxyTarget)。
  4. 返回 false

7.2.3 IsCallable ( argument )

抽象操作 IsCallable 接受参数 argument(一个 ECMAScript 语言值),并返回一个布尔值。它确定 argument 是否是一个具有 [[Call]] 内部方法的可调用函数。调用时执行以下步骤:

  1. 如果 argument 不是一个对象,返回 false
  2. 如果 argument 具有 [[Call]] 内部方法,返回 true
  3. 返回 false

7.2.4 IsConstructor ( argument )

抽象操作 IsConstructor 接受参数 argument(一个 ECMAScript 语言值),并返回一个布尔值。它确定 argument 是否是一个具有 [[Construct]] 内部方法的 函数对象。调用时执行以下步骤:

  1. 如果 argument 不是一个对象,返回 false
  2. 如果 argument 具有 [[Construct]] 内部方法,返回 true
  3. 返回 false

7.2.5 IsExtensible ( O )

抽象操作 IsExtensible 接受参数 O(一个对象),并返回一个 正常完成记录,包含 一个布尔值或一个 抛出完成记录。它用于确定是否可以向 O 添加其他属性。调用时执行以下步骤:

  1. 返回 ? O.[[IsExtensible]]()。

7.2.6 IsIntegralNumber ( argument )

抽象操作 IsIntegralNumber 接受参数 argument(一个 ECMAScript 语言值),并返回一个布尔值。它确定 argument 是否是一个 有限的 整数 值。调用时执行以下步骤:

  1. 如果 argument 不是一个数字,返回 false
  2. 如果 argument 不是 有限的,返回 false
  3. 如果 truncate((argument)) ≠ (argument), 返回 false
  4. 返回 true

7.2.7 IsPropertyKey ( argument )

抽象操作 IsPropertyKey 接受参数 argument(一个 ECMAScript 语言值),并返回一个布尔值。它确定 argument 是否是一个可以用作 属性键 的值。调用时执行以下步骤:

  1. 如果 argument 是一个字符串,返回 true
  2. 如果 argument 是一个符号,返回 true
  3. 返回 false

7.2.8 IsRegExp ( argument )

抽象操作 IsRegExp 接受参数 argument(一个 ECMAScript 语言值),并返回一个 正常完成记录,包含 一个布尔值或一个 抛出完成记录。调用时执行以下步骤:

  1. 如果 argument 不是一个对象,返回 false
  2. matcher 为 ? Get(argument, @@match)。
  3. 如果 matcher 不是 undefined,返回 ToBoolean(matcher)。
  4. 如果 argument 具有 [[RegExpMatcher]] 内部槽,返回 true
  5. 返回 false

7.2.9 静态语义:IsStringWellFormedUnicode ( string )

抽象操作 IsStringWellFormedUnicode 接受参数 string(一个字符串),并返回一个布尔值。它将 string 解释为一系列 UTF-16 编码的代码点,如 6.1.4 中描述,并确定它是否是一个 格式良好 的 UTF-16 序列。调用时执行以下步骤:

  1. lenstring 的长度。
  2. k 为 0。
  3. 重复,直到 k < len
    1. cpCodePointAt(string, k)。
    2. 如果 cp.[[IsUnpairedSurrogate]]true,返回 false
    3. k 设置为 k + cp.[[CodeUnitCount]]
  4. 返回 true

7.2.10 SameValue ( x, y )

抽象操作 SameValue 接受参数 x(一个 ECMAScript 语言值)和 y(一个 ECMAScript 语言值),并返回一个布尔值。它确定这两个参数是否是相同的值。调用时执行以下步骤:

  1. 如果 Type(x) 不是 Type(y),返回 false
  2. 如果 x 是一个数字,那么
    1. 返回 Number::sameValue(x, y)。
  3. 返回 SameValueNonNumber(x, y)。

这个算法不同于 IsStrictlyEqual 算法,因为它将所有 NaN 值视为等价,并区分 +0𝔽-0𝔽

7.2.11 SameValueZero ( x, y )

抽象操作 SameValueZero 接受参数 x(一个 ECMAScript 语言值)和 y(一个 ECMAScript 语言值),并返回一个布尔值。它确定这两个参数是否是相同的值(忽略 +0𝔽-0𝔽 之间的差异)。调用时执行以下步骤:

  1. 如果 Type(x) 不是 Type(y),返回 false
  2. 如果 x 是一个数字,那么
    1. 返回 Number::sameValueZero(x, y)。
  3. 返回 SameValueNonNumber(x, y)。

SameValueZero 与 SameValue 的唯一区别是它将 +0𝔽-0𝔽 视为等价。

7.2.12 SameValueNonNumber ( x, y )

抽象操作 SameValueNonNumber 接受参数 x(一个 ECMAScript 语言值,但不是数字)和 y(一个 ECMAScript 语言值,但不是数字),并返回一个布尔值。调用时执行以下步骤:

  1. 断言Type(x) 是 Type(y)。
  2. 如果 xnullundefined,返回 true
  3. 如果 x 是一个 BigInt,那么
    1. 返回 BigInt::equal(x, y)。
  4. 如果 x 是一个字符串,那么
    1. 如果 xy 具有相同的长度并且在相同的位置具有相同的代码单元,返回 true;否则,返回 false
  5. 如果 x 是一个布尔值,那么
    1. 如果 xy 都是 true 或都为 false,返回 true;否则,返回 false
  6. 注意:所有其他 ECMAScript 语言值 通过身份进行比较。
  7. 如果 xy,返回 true;否则,返回 false
注 1
出于阐述目的,即使没有必要,也会在此算法中单独处理某些情况。
注 2
有关“xy”的具体含义详见 5.2.7

7.2.13 IsLessThan ( x, y, LeftFirst )

抽象操作 IsLessThan 接受参数 x(一个 ECMAScript 语言值),y(一个 ECMAScript 语言值),和 LeftFirst(一个布尔值),并返回一个 正常完成包含一个布尔值或 undefined,或一个 抛出完成。它提供了比较 x < y 的语义,返回 truefalse,或 undefined(表示至少一个操作数是 NaN)。LeftFirst 标志用于控制对 xy 进行可能具有可见副作用的操作的顺序。这是必要的,因为 ECMAScript 指定了从左到右的表达式求值顺序。如果 LeftFirsttruex 参数对应于出现在 y 参数对应表达式左侧的表达式。如果 LeftFirstfalse,情况相反,必须在 x 之前对 y 进行操作。它在调用时执行以下步骤:

  1. 如果 LeftFirsttrue,则
    1. px 为 ? ToPrimitive(x, number).
    2. py 为 ? ToPrimitive(y, number).
  2. 否则
    1. 注意:需要反转求值顺序以保持从左到右的求值。
    2. py 为 ? ToPrimitive(y, number).
    3. px 为 ? ToPrimitive(x, number).
  3. 如果 px 是一个 字符串py 是一个 字符串,则
    1. lxpx 的长度。
    2. lypy 的长度。
    3. 对于每个 整数 i 使得 0 ≤ i < min(lx, ly), 按升序进行以下操作
      1. cxpx 中索引 i 处的代码单元数值。
      2. cypy 中索引 i 处的代码单元数值。
      3. 如果 cx < cy,返回 true.
      4. 如果 cx > cy,返回 false.
    4. 如果 lx < ly,返回 true。否则,返回 false.
  4. 否则
    1. 如果 px 是一个 BigIntpy 是一个 字符串,则
      1. nyStringToBigInt(py).
      2. 如果 nyundefined,返回 undefined.
      3. 返回 BigInt::lessThan(px, ny).
    2. 如果 px 是一个 字符串py 是一个 BigInt,则
      1. nxStringToBigInt(px).
      2. 如果 nxundefined,返回 undefined.
      3. 返回 BigInt::lessThan(nx, py).
    3. 注意:因为 pxpy 是原始值,求值顺序不重要。
    4. nx 为 ? ToNumeric(px).
    5. ny 为 ? ToNumeric(py).
    6. 如果 Type(nx) 是 Type(ny),则
      1. 如果 nx 是一个 数字,则
        1. 返回 Number::lessThan(nx, ny).
      2. 否则
        1. 断言nx 是一个 BigInt.
        2. 返回 BigInt::lessThan(nx, ny).
    7. 断言nx 是一个 BigIntny 是一个 数字,或 nx 是一个 数字ny 是一个 BigInt.
    8. 如果 nxnyNaN, 返回 undefined.
    9. 如果 nx-∞𝔽ny+∞𝔽,返回 true.
    10. 如果 nx+∞𝔽ny-∞𝔽,返回 false.
    11. 如果 (nx) < (ny),返回 true;否则返回 false.
注 1

步骤 3 与算法中处理加法运算符 + 的步骤 1.c 不同 (13.15.3),使用逻辑与操作而不是逻辑或操作。

注 2

字符串的比较使用简单的按 UTF-16 代码单元值序列的字典顺序,没有尝试使用 Unicode 规范中定义的更复杂的、语义导向的字符或字符串相等性和排序顺序定义。因此,根据 Unicode 标准正规等价但不在相同规范化形式中的字符串值可能会被测试为不等。同样需要注意的是,对于包含 代理对 的字符串,按代码单元的字典顺序与按代码点的字典顺序不同。

7.2.14 IsLooselyEqual ( x, y )

抽象操作 IsLooselyEqual 接受参数 x(一个 ECMAScript 语言 值)和 y(一个 ECMAScript 语言 值),并返回一个 正常 完成包含 布尔值或一个 抛出 完成。它提供了 == 操作符的语义。它在被调用时执行以下步骤:

  1. 如果 类型(x) 和 类型(y) 相同,则
    1. 返回 严格相等(x, y)。
  2. 如果 xnullyundefined,返回 true
  3. 如果 xundefinedynull,返回 true
  4. 注意:这一步在章节 B.3.6.2 中被替换。
  5. 如果 x 是数字y 是字符串,返回 ! 宽松相等(x, ! 转换为数字(y))。
  6. 如果 x 是字符串y 是数字,返回 ! 宽松相等(! 转换为数字(x), y)。
  7. 如果 x 是 BigInty 是字符串,则
    1. n字符串转换为 BigInt(y)。
    2. 如果 nundefined,返回 false
    3. 返回 ! 宽松相等(x, n)。
  8. 如果 x 是字符串y 是 BigInt,返回 ! 宽松相等(y, x)。
  9. 如果 x 是布尔值,返回 ! 宽松相等(! 转换为数字(x), y)。
  10. 如果 y 是布尔值,返回 ! 宽松相等(x, ! 转换为数字(y))。
  11. 如果 x 是字符串、数字、BigInt 或 Symbol 且 y 是对象,返回 ! 宽松相等(x, ? 转换为原始值(y))。
  12. 如果 x 是对象y 是字符串、数字、BigInt 或 Symbol,返回 ! 宽松相等(? 转换为原始值(x), y)。
  13. 如果 x 是 BigInty 是数字,或如果 x 是数字y 是 BigInt,则
    1. 如果 x 不是 有限y 不是 有限,返回 false
    2. 如果 (x) = (y), 返回 true;否则返回 false
  14. 返回 false

7.2.15 IsStrictlyEqual ( x, y )

抽象操作 IsStrictlyEqual 接受参数 x(一个 ECMAScript 语言值)和 y(一个 ECMAScript 语言值)并返回一个布尔值。它提供了 === 操作符的语义。调用时执行以下步骤:

  1. 如果 Type(x) 不是 Type(y),返回 false
  2. 如果 x 是一个数字,则
    1. 返回 Number::equal(x, y)。
  3. 返回 SameValueNonNumber(x, y)。

该算法在处理有符号零和 NaN 时与 SameValue 算法不同。

7.3 对象操作

7.3.1 MakeBasicObject ( internalSlotsList )

抽象操作 MakeBasicObject 接受参数 internalSlotsList(一个List,包含内部插槽名称),并返回一个对象。它是所有以算法方式创建的 ECMAScript 对象的源头,包括普通对象和异态对象。它因此提取出了创建所有对象时使用的公共步骤,并集中了对象的创建过程。在调用时执行以下步骤:

  1. obj 成为一个新创建的对象,其内部包含 internalSlotsList 中每个名称的内部插槽。
  2. obj 的关键内部方法设置为默认的普通对象定义,详见10.1
  3. Assert:如果调用者不会覆盖 obj[[GetPrototypeOf]][[SetPrototypeOf]] 关键内部方法中的任意一个,则 internalSlotsList 包含 [[Prototype]]
  4. Assert:如果调用者不会覆盖 obj[[SetPrototypeOf]][[IsExtensible]][[PreventExtensions]] 关键内部方法中的所有一个或多个,则 internalSlotsList 包含 [[Extensible]]
  5. 如果 internalSlotsList 包含 [[Extensible]],则将 obj.[[Extensible]] 设置为 true
  6. 返回 obj

在本规范中,异态对象通过首先调用 MakeBasicObject 来获取基本的基础对象,然后覆盖该对象的一些或全部内部方法,例如ArrayCreateBoundFunctionCreate等抽象操作中创建。为了封装异态对象的创建过程,对象的关键内部方法在这些操作外部永不修改。

7.3.2 Get ( O, P )

抽象操作 Get 接受参数 O(一个对象)和 P(一个属性键),并返回一个正常完成记录,其中包含ECMAScript 语言值抛出完成记录。用于检索对象的特定属性的值。调用时执行以下步骤:

  1. 返回 ? O.[[Get]](P, O).

7.3.3 GetV ( V, P )

抽象操作 GetV 接受参数 V(一个ECMAScript 语言值)和 P(一个属性键),并返回一个正常完成记录,其中包含ECMAScript 语言值抛出完成记录。用于检索ECMAScript 语言值的特定属性的值。如果该值不是对象,则使用适合该值类型的包装对象进行属性查找。调用时执行以下步骤:

  1. O 成为 ? ToObject(V).
  2. 返回 ? O.[[Get]](P, V).

7.3.4 Set ( O, P, V, Throw )

抽象操作 Set 接受参数 O(一个对象)、P(一个属性键)、V(一个ECMAScript 语言值)和 Throw(一个布尔值),并返回一个正常完成记录,其中包含抛出完成记录V是要设置的属性的新值。调用时执行以下步骤:

  1. success 成为 ? O.[[Set]](P, V, O).
  2. 如果 successfalse 并且 Throwtrue,则抛出一个 TypeError 异常。
  3. 返回 unused.

7.3.5 CreateDataProperty ( O, P, V )

抽象操作 CreateDataProperty 接受参数 O(一个对象)、P(一个属性键)和 V(一个ECMAScript 语言值),并返回一个正常完成记录,其中包含抛出完成记录。用于创建对象的新自有属性。调用时执行以下步骤:

  1. newDesc 成为属性描述符 { [[Value]]: V, [[Writable]]: true, [[Enumerable]]: true, [[Configurable]]: true }.
  2. 返回 ? O.[[DefineOwnProperty]](P, newDesc).

此抽象操作创建一个属性,其属性设置为 ECMAScript 语言赋值运算符创建的默认值。通常,该属性不会已存在。如果存在且不可配置,或者 O 不可扩展,则 [[DefineOwnProperty]] 将返回 false

7.3.6 CreateDataPropertyOrThrow ( O, P, V )

抽象操作 CreateDataPropertyOrThrow 接受参数 O(一个对象)、P(一个属性键)和 V(一个ECMAScript 语言值),并返回一个正常完成记录,其中包含抛出完成记录 unused。用于创建对象的新自有属性。如果无法执行请求的属性更新,则抛出 TypeError 异常。调用时执行以下步骤:

  1. success 成为 ? CreateDataProperty(O, P, V).
  2. 如果 successfalse,则抛出一个 TypeError 异常。
  3. 返回 unused.

此抽象操作创建一个属性,其属性设置为 ECMAScript 语言赋值运算符创建的默认值。通常,该属性不会已存在。如果存在且不可配置,或者 O 不可扩展,则 [[DefineOwnProperty]] 将返回 false,导致此操作抛出 TypeError 异常。

7.3.7 CreateNonEnumerableDataPropertyOrThrow ( O, P, V )

抽象操作 CreateNonEnumerableDataPropertyOrThrow 接受参数 O(一个对象)、P(一个属性键)和 V(一个ECMAScript 语言值),并返回 unused。用于创建普通对象的新非可枚举自有属性。调用时执行以下步骤:

  1. Assert: O 是一个普通的、可扩展的对象,并且没有不可配置的属性。
  2. newDesc 成为属性描述符 { [[Value]]: V, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: true }.
  3. 执行 ! DefinePropertyOrThrow(O, P, newDesc).
  4. 返回 unused.

此抽象操作创建一个属性,其属性设置为与 ECMAScript 语言赋值运算符创建的默认值相同,但不可枚举。通常情况下,该属性不存在。如果存在,则 DefinePropertyOrThrow 保证正常完成。

7.3.8 DefinePropertyOrThrow ( O, P, desc )

抽象操作 DefinePropertyOrThrow 接受参数 O(一个对象)、P(一个属性键)和 desc(一个属性描述符)并返回 normal completion containing unused 或一个 throw completion。用于以可能引发 TypeError 异常的方式调用对象的 [[DefineOwnProperty]] 内部方法,如果无法执行所请求的属性更新。调用时执行以下步骤:

  1. success 成为 ? O.[[DefineOwnProperty]](P, desc).
  2. 如果 successfalse,则抛出 TypeError 异常。
  3. 返回 unused.

7.3.9 DeletePropertyOrThrow ( O, P )

抽象操作 DeletePropertyOrThrow 接受参数 O(一个对象)和 P(一个属性键)并返回 normal completion containing unused 或一个 throw completion。用于移除对象的特定自有属性。如果属性不可配置,则抛出异常。调用时执行以下步骤:

  1. success 成为 ? O.[[Delete]](P).
  2. 如果 successfalse,则抛出 TypeError 异常。
  3. 返回 unused.

7.3.10 GetMethod ( V, P )

抽象操作 GetMethod 接受参数 V(一个ECMAScript 语言值) 和 P(一个属性键)并返回一个normal completion containing包含函数对象undefined,或一个throw completion。用于在期望属性值为函数时获取ECMAScript 语言值的特定属性值。调用时执行以下步骤:

  1. func 成为 ? GetV(V, P).
  2. 如果 funcundefinednull,则返回 undefined
  3. 如果 IsCallable(func) 是 false,则抛出 TypeError 异常。
  4. 返回 func

7.3.11 HasProperty ( O, P )

抽象操作 HasProperty 接受参数 O(一个 Object)和 P(一个 属性键)并返回一个 normal completion containing 一个 Boolean 或一个 throw completion。它用于确定对象是否具有指定的 属性键,该属性可以是自有的或继承的。调用时执行以下步骤:

  1. 返回 ? O.[[HasProperty]](P)。

7.3.12 HasOwnProperty ( O, P )

抽象操作 HasOwnProperty 接受参数 O(一个 Object)和 P(一个 属性键)并返回一个 normal completion containing 一个 Boolean 或一个 throw completion。它用于确定对象是否具有指定的自有 属性键。调用时执行以下步骤:

  1. Let desc be ? O.[[GetOwnProperty]](P).
  2. If desc is undefined, return false.
  3. Return true.

7.3.13 Call ( F, V [ , argumentsList ] )

抽象操作 Call 接受参数 F(一个 ECMAScript 语言值)和 V(一个 ECMAScript 语言值)以及可选参数 argumentsList(一个 List,包含 ECMAScript 语言值)并返回一个 normal completion containing 一个 ECMAScript 语言值 或一个 throw completion。它用于调用 函数对象[[Call]] 内部方法。 F函数对象V[[Call]]this 值,argumentsList 是传递给内部方法的对应参数。如果 argumentsList 不存在,则使用一个新的空 List 作为其值。调用时执行以下步骤:

  1. 如果argumentsList不存在,则将argumentsList设为一个新的空List
  2. 如果IsCallable(F)的返回值为false,则抛出TypeError异常。
  3. 返回 ? F.[[Call]](V, argumentsList)。

7.3.14 构造(F [ , argumentsList [ , newTarget ] ])

抽象操作构造(Construct)接受参数F(一个构造函数)和可选参数argumentsList(一个List,包含ECMAScript语言值)以及newTarget(一个构造函数),并返回一个包含对象的正常完成或抛出异常的抛出完成。它用于调用函数对象[[Construct]]内部方法。参数argumentsListnewTarget将作为相应内部方法的参数传递。如果argumentsList不存在,则使用一个新的空List作为其值。如果newTarget不存在,则使用F作为其值。调用时执行以下步骤:

  1. 如果newTarget不存在,则将newTarget设为F
  2. 如果argumentsList不存在,则将argumentsList设为一个新的空List
  3. 返回 ? F.[[Construct]](argumentsList, newTarget)。

如果newTarget不存在,则该操作等效于:new F(...argumentsList)

7.3.15 SetIntegrityLevel ( O, level )

抽象操作 SetIntegrityLevel 接受参数 O(一个对象)和 levelsealedfrozen),并返回一个包含布尔值的 正常完成或抛出异常的 抛出完成。它用于固定对象的自有属性集合。调用时执行以下步骤:

  1. status 为 ? O.[[PreventExtensions]]()。
  2. 如果 statusfalse,则返回 false
  3. keys 为 ? O.[[OwnPropertyKeys]]()。
  4. 如果 levelsealed,则
    1. 对于 keys 的每个元素 k,执行
      1. 执行 ? DefinePropertyOrThrow(O, k, PropertyDescriptor { [[Configurable]]: false  })。
  5. 否则,
    1. Assertlevelfrozen
    2. 对于 keys 的每个元素 k,执行
      1. currentDesc 为 ? O.[[GetOwnProperty]](k)。
      2. 如果 currentDesc 不是 undefined,则
        1. 如果 IsAccessorDescriptor(currentDesc) 是 true,则
          1. desc 为 PropertyDescriptor { [[Configurable]]: false  }。
        2. 否则,
          1. desc 为 PropertyDescriptor { [[Configurable]]: false, [[Writable]]: false  }。
        3. 执行 ? DefinePropertyOrThrow(O, k, desc)。
  6. 返回 true

7.3.16 TestIntegrityLevel ( O, level )

抽象操作 TestIntegrityLevel 接受参数 O(一个对象)和 levelsealedfrozen),并返回一个包含布尔值的 正常完成或抛出异常的 抛出完成。它用于确定对象的自有属性集合是否被固定。调用时执行以下步骤:

  1. extensible 为 ? IsExtensible(O)。
  2. 如果 extensibletrue,则返回 false
  3. 注意:如果对象是可扩展的,则不检查其任何属性。
  4. keys 为 ? O.[[OwnPropertyKeys]]()。
  5. 对于 keys 的每个元素 k,执行
    1. currentDesc 为 ? O.[[GetOwnProperty]](k)。
    2. 如果 currentDesc 不是 undefined,则
      1. 如果 currentDesc.[[Configurable]]true,则返回 false
      2. 如果 levelfrozen 并且 IsDataDescriptor(currentDesc) 是 true,则
        1. 如果 currentDesc.[[Writable]]true,则返回 false
  6. 返回 true

7.3.17 CreateArrayFromList ( elements )

抽象操作 CreateArrayFromList 接受参数 elements(一个 List,包含 ECMAScript 语言值)并返回一个数组。它用于创建一个数组,其元素由 elements 提供。调用时执行以下步骤:

  1. array 为 ! ArrayCreate(0)。
  2. n 为 0。
  3. 对于 elements 的每个元素 e,执行
    1. 执行 ! CreateDataPropertyOrThrow(array, ! ToString(𝔽(n)), e)。
    2. n 设为 n + 1。
  4. 返回 array

7.3.18 LengthOfArrayLike ( obj )

抽象操作 LengthOfArrayLike 接受参数 obj(一个对象)并返回一个正常完成,包含非负整数整数或一个抛出完成。它返回类似数组对象的"length"属性值。调用时执行以下步骤:

  1. 返回 (? ToLength(? Get(obj, "length")))。

类似数组对象是指该操作返回正常完成的任何对象。

注 1
通常,类似数组对象还会具有一些以整数索引命名的属性。但这不是此定义的要求。
注 2
数组和字符串对象是类似数组对象的示例。

7.3.19 CreateListFromArrayLike ( obj [ , elementTypes ] )

抽象操作 CreateListFromArrayLike 接受参数 obj(一个ECMAScript 语言值)和可选参数 elementTypes(一个List,包含 ECMAScript 语言类型的名称),返回正常完成,包含一个List值,其元素由obj的索引属性提供。 elementTypes 包含创建的List的元素值允许的 ECMAScript 语言类型名称。调用时执行以下步骤:

  1. 如果 elementTypes 不存在,则将 elementTypes 设置为« Undefined, Null, Boolean, String, Symbol, Number, BigInt, Object »。
  2. 如果 obj 不是对象,则抛出 TypeError 异常。
  3. len 是 ? LengthOfArrayLike(obj)。
  4. list 是一个新的空List
  5. index 是 0。
  6. 重复,当 index < len 时,
    1. indexName 是 ! ToString(𝔽(index))。
    2. next 是 ? Get(obj, indexName)。
    3. 如果 elementTypes 不包含 Type(next),则抛出 TypeError 异常。
    4. next 追加到 list
    5. index 设置为 index + 1。
  7. 返回 list

7.3.20 Invoke ( V, P [ , argumentsList ] )

抽象操作 Invoke 接受参数 V(一个ECMAScript 语言值)和 P(一个属性键),可选参数 argumentsList(一个List,包含ECMAScript 语言值),返回正常完成,包含一个ECMAScript 语言值或者抛出完成。该操作用于调用ECMAScript 语言值的方法属性。 V 既用作属性查找点也用作调用的this值。 argumentsList 是传递给方法的参数值列表。如果 argumentsList 不存在,则使用一个新的空List作为其值。调用时执行以下步骤:

  1. 如果 argumentsList 不存在,则将 argumentsList 设置为一个新的空List
  2. func 是 ? GetV(V, P)。
  3. 返回 ? Call(func, V, argumentsList)。

7.3.21 OrdinaryHasInstance ( C, O )

抽象操作 OrdinaryHasInstance 接受参数 C(一个ECMAScript 语言值)和 O(一个ECMAScript 语言值),返回正常完成,包含一个布尔值或者抛出完成。它实现了确定O是否从C提供的实例对象继承路径的默认算法。调用时执行以下步骤:

  1. 如果 IsCallable(C) 为 false,返回 false
  2. 如果 C 有一个 [[BoundTargetFunction]] 内部插槽,则
    1. BCC.[[BoundTargetFunction]]
    2. 返回 ? InstanceofOperator(O, BC)。
  3. 如果 O 不是一个对象,返回 false
  4. P 为 ? Get(C, "prototype")。
  5. 如果 P 不是一个对象,抛出一个 TypeError 异常。
  6. 重复,
    1. O 设置为 ? O.[[GetPrototypeOf]]()。
    2. 如果 Onull,返回 false
    3. 如果 SameValue(P, O) 是 true,返回 true

7.3.22 SpeciesConstructor ( O, defaultConstructor )

抽象操作 SpeciesConstructor 接受参数 O(一个对象)和 defaultConstructor(一个构造函数),返回正常完成,包含一个构造函数或者一个抛出完成。它用于获取应该用于创建从 O 派生的新对象的构造函数。如果无法从 O 开始找到一个构造函数@@species属性,则使用 defaultConstructor。调用时执行以下步骤:

  1. C 为 ? Get(O, "constructor")。
  2. 如果 Cundefined,返回 defaultConstructor
  3. 如果 C 不是一个对象,抛出一个 TypeError 异常。
  4. S 为 ? Get(C, @@species)。
  5. 如果 Sundefined 或者 null,返回 defaultConstructor
  6. 如果 IsConstructor(S) 是 true,返回 S
  7. 抛出一个 TypeError 异常。

7.3.23 EnumerableOwnProperties ( O, kind )

抽象操作 EnumerableOwnProperties 接受参数 O(一个对象)和 kindkeyvaluekey+value),返回 一个正常完成,包含 一个列表ECMAScript 语言值或者一个抛出完成。调用时执行以下步骤:

  1. ownKeys 为 ? O.[[OwnPropertyKeys]]()。
  2. results 为一个新的空列表
  3. 对于 ownKeys 的每个元素 key,做如下操作:
    1. 如果 key字符串,那么:
      1. desc 为 ? O.[[GetOwnProperty]](key)。
      2. 如果 desc 不是 undefined 并且 desc.[[Enumerable]]true,那么:
        1. 如果 kindkey,那么
          1. key 添加到 results 中。
        2. 否则,
          1. value 为 ? Get(O, key)。
          2. 如果 kindvalue,那么:
            1. value 添加到 results 中。
          3. 否则,
            1. 断言kindkey+value
            2. entryCreateArrayFromListkey, value »)。
            3. entry 添加到 results 中。
  4. 返回 results

7.3.24 GetFunctionRealm ( obj )

抽象操作 GetFunctionRealm 接受参数 obj(一个函数对象),返回一个正常完成,包含一个域记录或者一个抛出完成。调用时执行以下步骤:

  1. 如果 obj 拥有一个 [[Realm]] 内部插槽,则:
    1. 返回 obj.[[Realm]]
  2. 如果 obj 是一个绑定函数的异域对象,则:
    1. boundTargetFunctionobj.[[BoundTargetFunction]]
    2. 返回 ? GetFunctionRealm(boundTargetFunction)。
  3. 如果 obj 是一个代理的异域对象,则:
    1. 执行 ? ValidateNonRevokedProxy(obj)。
    2. proxyTargetobj.[[ProxyTarget]]
    3. 返回 ? GetFunctionRealm(proxyTarget)。
  4. 返回 当前域记录

如果 obj 是一个非标准函数异域对象且没有 [[Realm]] 内部插槽,则步骤 4 会被执行。

7.3.25 CopyDataProperties ( target, source, excludedItems )

抽象操作 CopyDataProperties 接受参数 target(一个对象),source (一个ECMAScript 语言值)和 excludedItems(一个列表,包含属性键),并返回一个正常完成,包含 unused或者一个抛出完成。调用时执行以下步骤:

  1. 如果 sourceundefinednull,则返回 unused
  2. from 为 ! ToObject(source)。
  3. keys 为 ? from.[[OwnPropertyKeys]]()。
  4. 对于 keys 中的每个元素 nextKey,执行以下步骤:
    1. excludedfalse
    2. 对于 excludedItems 中的每个元素 e,执行以下步骤:
      1. 如果 SameValue(e, nextKey) 是 true,则执行以下步骤:
        1. excluded 设为 true
    3. 如果 excludedfalse,则执行以下步骤:
      1. desc 为 ? from.[[GetOwnProperty]](nextKey)。
      2. 如果 desc 不是 undefined 并且 desc.[[Enumerable]]true,则执行以下步骤:
        1. propValue 为 ? Get(from, nextKey)。
        2. 执行 ! CreateDataPropertyOrThrow(target, nextKey, propValue)。
  5. 返回 unused

这里传入的目标对象始终是一个新创建的对象,在发生错误抛出时不会直接访问到它。

7.3.26 PrivateElementFind ( O, P )

抽象操作 PrivateElementFind 接受参数 O(一个对象)和 P(一个私有名称),并返回一个PrivateElement或者empty。调用时执行以下步骤:

  1. 如果 O.[[PrivateElements]] 包含一个PrivateElement pe, 使得 pe.[[Key]]P,则执行以下步骤:
    1. 返回 pe
  2. 返回 empty

7.3.27 PrivateFieldAdd ( O, P, value )

抽象操作 PrivateFieldAdd 接受参数 O(一个对象),P(一个私有名称),和 value(一个ECMAScript 语言值),并返回一个normal completion containing unused 或者一个throw completion。调用时执行以下步骤:

  1. If the host is a web browser, then
    1. 执行 ? HostEnsureCanAddPrivateElement(O).
  2. Let entry be PrivateElementFind(O, P).
  3. If entry is not empty, throw a TypeError exception.
  4. Append PrivateElement { [[Key]]: P, [[Kind]]: field, [[Value]]: value } to O.[[PrivateElements]].
  5. Return unused.

7.3.28 PrivateMethodOrAccessorAdd ( O, method )

抽象操作 PrivateMethodOrAccessorAdd 接受参数 O(一个对象)和 method(一个 PrivateElement),并返回一个包含正常完成的 未使用 或抛出完成。调用时执行以下步骤:

  1. Assert: method.[[Kind]]methodaccessor
  2. 如果 宿主环境 是 Web 浏览器,则执行:
    1. 执行 ? HostEnsureCanAddPrivateElement(O)。
  3. entry 成为 PrivateElementFind(O, method.[[Key]])。
  4. 如果 entry 不是 empty,则抛出一个 TypeError 异常。
  5. method 添加到 O.[[PrivateElements]]
  6. 返回 unused

私有方法和访问器的值在实例之间是共享的。此操作不会创建方法或访问器的新副本。

7.3.29 HostEnsureCanAddPrivateElement ( O )

宿主定义的抽象操作 HostEnsureCanAddPrivateElement 接受参数 O(一个对象),并返回一个包含正常完成的 未使用 或抛出完成。它允许宿主环境阻止将私有元素添加到特定的宿主定义的异域对象。

HostEnsureCanAddPrivateElement 的实现必须符合以下要求:

  • 如果 O 不是宿主定义的异域对象,则此抽象操作必须返回 NormalCompletion(unused),并且不执行其他步骤。
  • 使用相同参数调用此抽象操作的任何两次必须返回相同类型的 完成记录

HostEnsureCanAddPrivateElement 的默认实现是返回 NormalCompletion(unused)。

此抽象操作仅由 ECMAScript 宿主,即 Web 浏览器调用。

7.3.30 PrivateGet ( O, P )

抽象操作 PrivateGet 接受参数 O(一个对象)和 P(一个私有名称),并返回一个包含 ECMAScript 语言值的普通完成或抛出完成。调用时执行以下步骤:

  1. entryPrivateElementFind(O, P)。
  2. 如果 entry 为空,则抛出 TypeError 异常。
  3. 如果 entry.[[Kind]]fieldmethod,则
    1. 返回 entry.[[Value]]
  4. Assert:确保 entry.[[Kind]]accessor
  5. 如果 entry.[[Get]]undefined,则抛出 TypeError 异常。
  6. getterentry.[[Get]]
  7. 返回 ? Call(getter, O)。

7.3.31 PrivateSet ( O, P, value )

抽象操作 PrivateSet 接受参数 O(一个对象)、P(一个私有名称)和 value(一个 ECMAScript 语言值),并返回一个包含未使用的普通完成或抛出完成。调用时执行以下步骤:

  1. entryPrivateElementFind(O, P)。
  2. 如果 entry 为空,则抛出 TypeError 异常。
  3. 如果 entry.[[Kind]]field,则
    1. entry.[[Value]] 设置为 value
  4. 否则,如果 entry.[[Kind]]method,则
    1. 抛出 TypeError 异常。
  5. 否则,
    1. Assert: 确保 entry.[[Kind]]accessor
    2. 如果 entry.[[Set]]undefined,则抛出 TypeError 异常。
    3. setterentry.[[Set]]
    4. 执行 ? Call(setter, O, « value »)。
  6. 返回 unused

7.3.32 DefineField ( receiver, fieldRecord )

抽象操作 DefineField 接受参数 receiver(一个对象)和 fieldRecord(一个 ClassFieldDefinition Record),并返回一个包含未使用的普通完成或抛出完成。调用时执行以下步骤:

  1. fieldNamefieldRecord.[[Name]]
  2. initializerfieldRecord.[[Initializer]]
  3. 如果 initializer 不为空,则
    1. initValue 为 ? Call(initializer, receiver)。
  4. 否则,
    1. initValueundefined
  5. 如果 fieldName 是一个 Private Name,则
    1. 执行 ? PrivateFieldAdd(receiver, fieldName, initValue)。
  6. 否则,
    1. Assert: 确保 IsPropertyKey(fieldName) 是 true
    2. 执行 ? CreateDataPropertyOrThrow(receiver, fieldName, initValue)。
  7. 返回 unused

7.3.33 InitializeInstanceElements ( O, constructor )

抽象操作 InitializeInstanceElements 接受参数 O(一个对象)和 constructor(一个 ECMAScript function object),并返回一个包含未使用的普通完成或抛出完成。调用时执行以下步骤:

  1. methodsconstructor.[[PrivateMethods]] 的值。
  2. 对于每个 PrivateElement methodmethods 中,执行
    1. 执行 ? PrivateMethodOrAccessorAdd(O, method)。
  3. fieldsconstructor.[[Fields]] 的值。
  4. 对于每个元素 fieldRecordfields 中,执行
    1. 执行 ? DefineField(O, fieldRecord)。
  5. 返回 unused

7.3.34 AddValueToKeyedGroup ( groups, key, value )

抽象操作 AddValueToKeyedGroup 接受参数 groups(一个包含字段 [[Key]](一个 ECMAScript 语言值)和 [[Elements]](一个 ECMAScript 语言值列表)的 List 的记录),key(一个 ECMAScript 语言值)和 value(一个 ECMAScript 语言值),并返回 unused。调用时执行以下步骤:

  1. 对于每个 记录 { [[Key]], [[Elements]] } ggroups 中,执行
    1. 如果 SameValue(g.[[Key]], key) 的结果为 true,则
      1. Assert: 正好有一个 groups 的元素符合此条件。
      2. value 追加到 g.[[Elements]] 中。
      3. 返回 unused
  2. group 为记录 { [[Key]]: key, [[Elements]]: « value » }。
  3. group 追加到 groups 中。
  4. 返回 unused

7.3.35 GroupBy ( items, callbackfn, keyCoercion )

抽象操作 GroupBy 接受参数 items(一个 ECMAScript 语言值)、callbackfn(一个 ECMAScript 语言值)和 keyCoercionpropertyzero),并返回一个包含字段 [[Key]](一个 ECMAScript 语言值)和 [[Elements]](一个 ECMAScript 语言值列表)的 List 的记录或一个 throw completion。调用时执行以下步骤:

  1. 执行 ? RequireObjectCoercible(items).
  2. 如果 IsCallable(callbackfn) 的结果为 false,则抛出一个 TypeError 异常。
  3. groups 为一个新的空 List
  4. iteratorRecord 为 ? GetIterator(items, sync).
  5. k 为 0。
  6. 重复执行
    1. 如果 k ≥ 253 - 1,则
      1. errorThrowCompletion(一个新创建的 TypeError 对象)。
      2. 返回 ? IteratorClose(iteratorRecord, error).
    2. next 为 ? IteratorStepValue(iteratorRecord).
    3. 如果 nextdone,则
      1. 返回 groups
    4. valuenext
    5. keyCompletion(Call(callbackfn, undefined, « value, 𝔽(k) »)).
    6. IfAbruptCloseIterator(key, iteratorRecord).
    7. 如果 keyCoercionproperty,则
      1. key 设置为 Completion(ToPropertyKey(key)).
      2. IfAbruptCloseIterator(key, iteratorRecord).
    8. 否则,
      1. Assert: keyCoercionzero
      2. 如果 key-0𝔽,则将 key 设置为 +0𝔽
    9. 执行 AddValueToKeyedGroup(groups, key, value).
    10. k 设置为 k + 1。

7.4 迭代器对象操作

请参阅通用迭代接口(27.1)。

7.4.1 迭代器记录

迭代器记录是用于封装迭代器或异步迭代器及其 next 方法的 记录 值。

迭代器记录具有以下在 表格 15 中列出的字段。

表格 15: 迭代器记录 字段
字段名 含义
[[Iterator]] 一个对象 符合 IteratorAsyncIterator 接口的对象。
[[NextMethod]] 一个 ECMAScript 语言值 [[Iterator]] 对象的 next 方法。
[[Done]] 一个布尔值 表示迭代器是否已关闭。

7.4.2 GetIteratorFromMethod ( obj, method )

抽象操作 GetIteratorFromMethod 接受参数 obj(一个 ECMAScript 语言值) 和 method(一个 函数对象),并返回一个包含正常完成或抛出完成的 迭代器记录。 当调用时,执行以下步骤:

  1. iterator be ? Call(method, obj).
  2. If iterator 不是一个对象,抛出一个 TypeError 异常。
  3. nextMethod be ? Get(iterator, "next").
  4. iteratorRecord迭代器记录 { [[Iterator]]: iterator, [[NextMethod]]: nextMethod, [[Done]]: false }。
  5. 返回 iteratorRecord

7.4.3 GetIterator ( obj, kind )

抽象操作 GetIterator 接受参数 obj(一个 ECMAScript 语言值)和 kindsyncasync),并返回一个包含正常完成状态的迭代器记录或抛出异常完成状态。调用时执行以下步骤:

  1. 如果 kindasync,则
    1. method 为 ? GetMethod(obj, @@asyncIterator)。
    2. 如果 methodundefined,则
      1. syncMethod 为 ? GetMethod(obj, @@iterator)。
      2. 如果 syncMethodundefined,则抛出 TypeError 异常。
      3. syncIteratorRecord 为 ? GetIteratorFromMethod(obj, syncMethod)。
      4. 返回 CreateAsyncFromSyncIterator(syncIteratorRecord)。
  2. 否则,
    1. method 为 ? GetMethod(obj, @@iterator)。
  3. 如果 methodundefined,则抛出 TypeError 异常。
  4. 返回 ? GetIteratorFromMethod(obj, method)。

7.4.4 IteratorNext ( iteratorRecord [ , value ] )

抽象操作 IteratorNext 接受参数 iteratorRecord(一个 Iterator Record)和可选参数 value(一个 ECMAScript 语言值),并返回一个包含正常完成状态的对象或抛出异常完成状态。调用时执行以下步骤:

  1. 如果 value 不存在,则
    1. result 为 ? Call(iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]])。
  2. 否则,
    1. result 为 ? Call(iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]], « value »)。
  3. 如果 result 不是对象,则抛出 TypeError 异常。
  4. 返回 result

7.4.5 IteratorComplete ( iterResult )

抽象操作 IteratorComplete 接受参数 iterResult(一个对象)并返回一个包含正常完成状态的布尔值或抛出异常完成状态。调用时执行以下步骤:

  1. 返回 ToBoolean(? Get(iterResult, "done"))。

7.4.6 IteratorValue ( iterResult )

抽象操作 IteratorValue 接受参数 iterResult(一个对象)并返回一个包含正常完成状态的 ECMAScript 语言值或抛出异常完成状态。调用时执行以下步骤:

  1. 返回 ? Get(iterResult, "value")。

7.4.7 IteratorStep ( iteratorRecord )

抽象操作 IteratorStep 接受参数 iteratorRecord(一个 迭代器记录),并返回一个正常完成包含对象或 false,或者抛出完成。它通过调用 iteratorRecord.[[NextMethod]]iteratorRecord.[[Iterator]] 请求下一个值,并根据情况返回 false 表示迭代器已经结束,或者返回可用的 IteratorResult 对象。调用时执行以下步骤:

  1. result 为 ? IteratorNext(iteratorRecord).
  2. done 为 ? IteratorComplete(result).
  3. 如果 donetrue,则返回 false
  4. 返回 result

7.4.8 IteratorStepValue ( iteratorRecord )

抽象操作 IteratorStepValue 接受参数 iteratorRecord(一个 迭代器记录),并返回一个正常完成包含 ECMAScript 语言值或 done,或者抛出完成。它通过调用 iteratorRecord.[[NextMethod]]iteratorRecord.[[Iterator]] 请求下一个值,并根据情况返回 done 表示迭代器已经结束,或者返回从 IteratorResult 对象中获取的值。调用时执行以下步骤:

  1. resultCompletion(IteratorNext(iteratorRecord)).
  2. If result is a throw completion, 则
    1. iteratorRecord.[[Done]] 设置为 true
    2. 返回 ? result
  3. result 设置为 ! result
  4. doneCompletion(IteratorComplete(result)).
  5. If done 是一个 throw completion, 则
    1. iteratorRecord.[[Done]] 设置为 true
    2. 返回 ? done
  6. done 设置为 ! done
  7. If donetrue, 则
    1. iteratorRecord.[[Done]] 设置为 true
    2. 返回 done
  8. valueCompletion(Get(result, "value")).
  9. If value 是一个 throw completion, 则
    1. iteratorRecord.[[Done]] 设置为 true
  10. 返回 ? value

7.4.9 IteratorClose ( iteratorRecord, completion )

抽象操作 IteratorClose 接受参数 iteratorRecord(一个 迭代器记录)和 completion(一个 完成记录),并返回一个 完成记录。它用于通知迭代器在达到完成状态时执行其通常执行的任何操作。调用时执行以下步骤:

  1. AssertiteratorRecord.[[Iterator]] 是一个对象
  2. iteratoriteratorRecord.[[Iterator]]
  3. innerResultCompletion(GetMethod(iterator, "return")).
  4. 如果 innerResult 是一个 正常完成,则
    1. returninnerResult.[[Value]]
    2. 如果 returnundefined,则返回 ? completion
    3. innerResult 设置为 Completion(Call(return, iterator)).
  5. 如果 completion 是一个 抛出完成,则返回 ? completion
  6. 如果 innerResult 是一个 抛出完成,则返回 ? innerResult
  7. 如果 innerResult.[[Value]] 不是一个对象,则抛出 TypeError 异常。
  8. 返回 ? completion

7.4.10 IfAbruptCloseIterator ( value, iteratorRecord )

IfAbruptCloseIterator 是一个使用 迭代器记录 的一系列算法步骤的简写形式。形式为:

  1. IfAbruptCloseIterator(value, iteratorRecord).

意味着与以下内容相同:

  1. Assert: value 是一个 完成记录
  2. 如果 value 是一个 突然完成,则返回 ? IteratorClose(iteratorRecord, value)。
  3. 否则,将 value 设置为 ! value

7.4.11 AsyncIteratorClose ( iteratorRecord, completion )

异步抽象操作 AsyncIteratorClose 接受参数 iteratorRecord (一个 迭代器记录)和 completion (一个 完成记录),并返回一个 完成记录。 用于通知异步迭代器,在达到完成状态时执行其通常执行的任何操作。调用时执行以下步骤:

  1. Assert: iteratorRecord.[[Iterator]] 是一个对象
  2. iteratoriteratorRecord.[[Iterator]]
  3. innerResultCompletion(GetMethod(iterator, "return"))。
  4. 如果 innerResult 是一个 正常完成,则:
    1. returninnerResult.[[Value]]
    2. 如果 returnundefined,返回 ? completion
    3. innerResult 设为 Completion(Call(return, iterator))。
    4. 如果 innerResult 是一个 正常完成, 将 innerResult 设为 Completion(Await(innerResult.[[Value]]))。
  5. 如果 completion 是一个 抛出完成,返回 ? completion
  6. 如果 innerResult 是一个 抛出完成,返回 ? innerResult
  7. 如果 innerResult.[[Value]] 不是一个对象, 抛出 TypeError 异常。
  8. 返回 ? completion

7.4.12 CreateIterResultObject ( value, done )

抽象操作 CreateIterResultObject 接受参数 value (一个 ECMAScript 语言值)和 done (一个布尔值),并返回符合 IteratorResult 接口的对象。它在调用时执行以下步骤:

  1. objOrdinaryObjectCreate(%Object.prototype%)。
  2. 执行 ! CreateDataPropertyOrThrow(obj, "value", value)。
  3. 执行 ! CreateDataPropertyOrThrow(obj, "done", done)。
  4. 返回 obj

7.4.13 CreateListIteratorRecord ( list )

抽象操作 CreateListIteratorRecord 接受参数 list (一个 List,包含 ECMAScript 语言值),并返回一个 Iterator Record。它创建一个迭代器对象记录,其 next 方法返回 list 的连续元素。在调用时执行以下步骤:

  1. closure 成为一个没有参数的新 Abstract Closure,它捕获 list,并在调用时执行以下步骤:
    1. 对于 list 的每个元素 E,执行
      1. 执行 ? GeneratorYield(CreateIterResultObject(E, false))。
    2. 返回 NormalCompletion(undefined)。
  2. iterator 成为 CreateIteratorFromClosure(closure, empty, %IteratorPrototype%)。
  3. 返回 Iterator Record { [[Iterator]]: iterator, [[NextMethod]]: %GeneratorFunction.prototype.prototype.next%, [[Done]]: false }。

列表迭代器对象对 ECMAScript 代码不可直接访问。

7.4.14 IteratorToList ( iteratorRecord )

抽象操作 IteratorToList 接受参数 iteratorRecord (一个 Iterator Record)并返回一个包含 正常完成,其包含 List,或者一个 抛出完成。在调用时执行以下步骤:

  1. values 成为一个新的空 List
  2. 重复执行,
    1. next 成为 ? IteratorStepValue(iteratorRecord)。
    2. 如果 nextdone,那么
      1. 返回 values
    3. next 追加到 values

8 语法导向操作

除了本节中定义的操作外,专门的语法导向操作在本规范的各个地方进行了定义。

8.1 运行时语义:评估

语法导向操作 Evaluation 不接受参数并返回一个完成记录

该操作的定义分布在本规范的“ECMAScript 语言”部分。每个定义都出现在相关产生式的定义后面。

8.2 Scope 分析

8.2.1 静态语义:BoundNames

语法导向操作 BoundNames 不接受参数,并返回一个字符串列表(List)。

"*default*" 在本规范中用作模块默认导出的合成名称,当没有其他名称时使用。模块的 [[Environment]] 中创建一个以该名称命名的条目,并保存相应的值。通过调用 ResolveExport(exportName [ , resolveSet ]) 解析名为 "default" 的导出,模块会返回一个 ResolvedBinding Record,其 [[BindingName]]"*default*",然后在模块的 [[Environment]] 中解析为上述值。这仅用于规范的便利性,使得匿名默认导出能够像其他任何导出一样解析。这个 "*default*" 字符串对 ECMAScript 代码或模块链接算法是不可访问的。

它在以下产生式上分段定义:

BindingIdentifier : Identifier
  1. 返回一个 List,其唯一元素是 Identifier 的字符串值,来自于 Identifier
BindingIdentifier : yield
  1. 返回 « "yield" »。
BindingIdentifier : await
  1. 返回 « "await" »。
LexicalDeclaration : LetOrConst BindingList ;
  1. 返回 BoundNames 的结果, 来自于 BindingList
BindingList : BindingList , LexicalBinding
  1. names1BoundNames 的结果, 来自于 BindingList
  2. names2BoundNames 的结果, 来自于 LexicalBinding
  3. 返回 list-concatenation 的结果, 包括 names1names2
LexicalBinding : BindingIdentifier Initializeropt
  1. 返回 BoundNames 的结果, 来自于 BindingIdentifier
LexicalBinding : BindingPattern Initializer
  1. 返回 BoundNames 的结果, 来自于 BindingPattern
VariableDeclarationList : VariableDeclarationList , VariableDeclaration
  1. names1BoundNames 的结果, 来自于 VariableDeclarationList
  2. names2BoundNames 的结果, 来自于 VariableDeclaration
  3. 返回 list-concatenation 的结果, 包括 names1names2
VariableDeclaration : BindingIdentifier Initializeropt
  1. 返回 BoundNames 的结果, 来自于 BindingIdentifier
VariableDeclaration : BindingPattern Initializer
  1. 返回 BoundNames 的结果, 来自于 BindingPattern
ObjectBindingPattern : { }
  1. 返回一个新的空 List
ObjectBindingPattern : { BindingPropertyList , BindingRestProperty }
  1. names1 成为 BoundNames 的结果, 其中 BindingPropertyList 是指向的非终结符。
  2. names2 成为 BoundNames 的结果, 其中 BindingRestProperty 是指向的非终结符。
  3. 返回 list-concatenation 的结果, 其中包含 names1names2
ArrayBindingPattern : [ Elisionopt ]
  1. 返回一个新的空 List
ArrayBindingPattern : [ Elisionopt BindingRestElement ]
  1. names 成为 BoundNames 的结果, 其中 BindingRestElement 是指向的非终结符。
ArrayBindingPattern : [ BindingElementList , Elisionopt ]
  1. names1 成为 BoundNames 的结果, 其中 BindingElementList 是指向的非终结符。
  2. names2 成为 BoundNames 的结果, 其中 BindingRestElement 是指向的非终结符。
  3. 返回 list-concatenation 的结果, 其中包含 names1names2
BindingPropertyList : BindingPropertyList , BindingProperty
  1. names1 成为 BoundNames 的结果, 其中 BindingPropertyList 是指向的非终结符。
  2. names2 成为 BoundNames 的结果, 其中 BindingProperty 是指向的非终结符。
  3. 返回 list-concatenation 的结果, 其中包含 names1names2
BindingElementList : BindingElementList , BindingElisionElement
  1. names1 成为 BoundNames 的结果, 其中 BindingElementList 是指向的非终结符。
  2. names2 成为 BoundNames 的结果, 其中 BindingElisionElement 是指向的非终结符。
  3. 返回 list-concatenation 的结果, 其中包含 names1names2
BindingElisionElement : Elisionopt BindingElement
  1. 返回 BoundNames 的结果, 其中 BindingElement 是指向的非终结符。
BindingProperty : PropertyName : BindingElement
  1. 返回 BoundNames 的结果, 其中 BindingElement 是指向的非终结符。
SingleNameBinding : BindingIdentifier Initializeropt
  1. 返回 BoundNames 的结果, 其中 BindingIdentifier 是指向的非终结符。
BindingElement : BindingPattern Initializeropt
  1. 返回 BoundNames 的结果, 其中 BindingPattern 是指向的非终结符。
ForDeclaration : LetOrConst ForBinding
  1. 返回 BoundNames 的结果, 其中 ForBinding 是指向的非终结符。
FunctionDeclaration : function BindingIdentifier ( FormalParameters ) { FunctionBody }
  1. 返回 BoundNames 的结果, 其中 BindingIdentifier 是指向的非终结符。
FunctionDeclaration : function ( FormalParameters ) { FunctionBody }
  1. 返回« "*default*" »。
FormalParameters : [empty]
  1. 返回一个新的空List
FormalParameters : FormalParameterList , FunctionRestParameter
  1. names1 设置为获取 FormalParameterListBoundNames
  2. names2 设置为获取 FunctionRestParameterBoundNames
  3. 返回 list-concatenation 的结果,即 names1names2 的连接列表。
FormalParameterList : FormalParameterList , FormalParameter
  1. names1 设置为获取 FormalParameterListBoundNames
  2. names2 设置为获取 FormalParameterBoundNames
  3. 返回 list-concatenation 的结果,即 names1names2 的连接列表。
ArrowParameters : CoverParenthesizedExpressionAndArrowParameterList
  1. formals 设置为由 ArrowFormalParameters 覆盖的CoverParenthesizedExpressionAndArrowParameterList
  2. 返回 formalsBoundNames
GeneratorDeclaration : function * BindingIdentifier ( FormalParameters ) { GeneratorBody }
  1. 返回BindingIdentifier的绑定名称。
GeneratorDeclaration : function * ( FormalParameters ) { GeneratorBody }
  1. 返回"*default*"
AsyncGeneratorDeclaration : async function * BindingIdentifier ( FormalParameters ) { AsyncGeneratorBody }
  1. 返回BindingIdentifierBoundNames
AsyncGeneratorDeclaration : async function * ( FormalParameters ) { AsyncGeneratorBody }
  1. 返回 « "*default*" »。
ClassDeclaration : class BindingIdentifier ClassTail
  1. 返回BoundNames中的BindingIdentifier
ClassDeclaration : class ClassTail
  1. 返回 « "*default*" »。
AsyncFunctionDeclaration : async function BindingIdentifier ( FormalParameters ) { AsyncFunctionBody }
  1. 返回BoundNames中的BindingIdentifier
AsyncFunctionDeclaration : async function ( FormalParameters ) { AsyncFunctionBody }
  1. 返回 « "*default*" »。
CoverCallExpressionAndAsyncArrowHead : MemberExpression Arguments
  1. head为被CoverCallExpressionAndAsyncArrowHead覆盖的AsyncArrowHead
  2. 返回headBoundNames
ImportDeclaration : import ImportClause FromClause ;
  1. 返回BoundNamesImportClause
ImportDeclaration : import ModuleSpecifier ;
  1. 返回一个新的空List
ImportClause : ImportedDefaultBinding , NameSpaceImport
  1. names1BoundNamesImportedDefaultBindingBoundNames
  2. names2BoundNamesNameSpaceImportBoundNames
  3. 返回list-concatenationnames1names2
ImportClause : ImportedDefaultBinding , NamedImports
  1. names1BoundNamesImportedDefaultBindingBoundNames
  2. names2BoundNamesNamedImportsBoundNames
  3. 返回list-concatenationnames1names2
NamedImports : { }
  1. 返回一个新的空List
ImportsList : ImportsList , ImportSpecifier
  1. names1BoundNamesImportsListBoundNames
  2. names2BoundNamesImportSpecifierBoundNames
  3. 返回list-concatenationnames1names2
ImportSpecifier ModuleExportName as ImportedBinding
  1. 返回ImportedBindingBoundNames
ExportDeclaration export ExportFromClause FromClause export NamedExports
  1. 返回一个新的空List
ExportDeclaration export VariableStatement
  1. 返回VariableStatementBoundNames
ExportDeclaration export Declaration
  1. 返回DeclarationBoundNames
ExportDeclaration export default HoistableDeclaration
  1. declarationNamesHoistableDeclarationBoundNames
  2. 如果declarationNames不包含元素"*default*",则将"*default*"添加到declarationNames中。
  3. 返回declarationNames
ExportDeclaration export default ClassDeclaration
  1. declarationNamesClassDeclarationBoundNames
  2. 如果declarationNames不包含元素"*default*",则将"*default*"添加到declarationNames中。
  3. 返回declarationNames
ExportDeclaration export default AssignmentExpression
  1. 返回« "*default*" »。

8.2.2 静态语义:DeclarationPart

DeclarationPart 是一个语法导向操作,不接受参数并返回一个解析节点(Parse Node)。它根据以下产生式逐段定义:

HoistableDeclaration FunctionDeclaration
  1. 返回 FunctionDeclaration
HoistableDeclaration GeneratorDeclaration
  1. 返回 GeneratorDeclaration
HoistableDeclaration AsyncFunctionDeclaration
  1. 返回 AsyncFunctionDeclaration
HoistableDeclaration AsyncGeneratorDeclaration
  1. 返回 AsyncGeneratorDeclaration
Declaration ClassDeclaration
  1. 返回 ClassDeclaration
Declaration LexicalDeclaration
  1. 返回 LexicalDeclaration

8.2.3 静态语义:IsConstantDeclaration

语法导向操作 IsConstantDeclaration 不接受任何参数,并返回一个布尔值。它在以下产生式上逐段定义:

LexicalDeclaration : LetOrConst BindingList ;
  1. 返回 IsConstantDeclarationLetOrConst
LetOrConst : let
  1. 返回 false
LetOrConst : const
  1. 返回 true
FunctionDeclaration : function BindingIdentifier ( FormalParameters ) { FunctionBody } function ( FormalParameters ) { FunctionBody } GeneratorDeclaration : function * BindingIdentifier ( FormalParameters ) { GeneratorBody } function * ( FormalParameters ) { GeneratorBody } AsyncGeneratorDeclaration : async function * BindingIdentifier ( FormalParameters ) { AsyncGeneratorBody } async function * ( FormalParameters ) { AsyncGeneratorBody } AsyncFunctionDeclaration : async function BindingIdentifier ( FormalParameters ) { AsyncFunctionBody } async function ( FormalParameters ) { AsyncFunctionBody }
  1. 返回 false
ClassDeclaration : class BindingIdentifier ClassTail class ClassTail
  1. 返回 false
ExportDeclaration : export ExportFromClause FromClause ; export NamedExports ; export default AssignmentExpression ;
  1. 返回 false

没有必要将 export default AssignmentExpression 视为常量声明,因为没有语法允许对用于引用模块默认对象的内部绑定名称进行赋值。

8.2.4 静态语义:词法声明的名称

语法导向操作 LexicallyDeclaredNames 不接受任何参数,并返回一个字符串列表。它在以下产生式上逐段定义:

Block : { }
  1. 返回一个新的空列表
StatementList : StatementList StatementListItem
  1. names1LexicallyDeclaredNamesStatementList
  2. names2LexicallyDeclaredNamesStatementListItem
  3. 返回 names1names2列表连接
StatementListItem : Statement
  1. 如果 Statement Statement : LabelledStatement ,返回 LexicallyDeclaredNamesLabelledStatement
  2. 返回一个新的空列表
StatementListItem : Declaration
  1. 返回 BoundNamesDeclaration
CaseBlock : { }
  1. 返回一个新的空列表
CaseBlock : { CaseClausesopt DefaultClause CaseClausesopt }
  1. 如果第一个CaseClauses存在,令names1为第一个CaseClausesLexicallyDeclaredNames
  2. 否则,令names1为一个新的空列表
  3. names2DefaultClauseLexicallyDeclaredNames
  4. 如果第二个CaseClauses存在,令names3为第二个CaseClausesLexicallyDeclaredNames
  5. 否则,令names3为一个新的空列表
  6. 返回names1names2names3列表连接
CaseClauses : CaseClauses CaseClause
  1. names1LexicallyDeclaredNamesCaseClauses
  2. names2LexicallyDeclaredNamesCaseClause
  3. 返回 names1names2列表连接
CaseClause : case Expression : StatementListopt
  1. 如果StatementList存在,返回StatementListLexicallyDeclaredNames
  2. 返回一个新的空列表
DefaultClause : default : StatementListopt
  1. 如果StatementList存在,返回StatementListLexicallyDeclaredNames
  2. 返回一个新的空列表
LabelledStatement : LabelIdentifier : LabelledItem
  1. 返回LexicallyDeclaredNamesLabelledItem
LabelledItem : Statement
  1. 返回一个新的空列表
LabelledItem : FunctionDeclaration
  1. 返回BoundNamesFunctionDeclaration
FunctionStatementList : [empty]
  1. 返回一个新的空列表
FunctionStatementList : StatementList
  1. 返回TopLevelLexicallyDeclaredNamesStatementList
ClassStaticBlockStatementList : [empty]
  1. 返回一个新的空列表
ClassStaticBlockStatementList : StatementList
  1. 返回TopLevelLexicallyDeclaredNamesStatementList
ConciseBody : ExpressionBody
  1. 返回一个新的空列表
AsyncConciseBody : ExpressionBody
  1. 返回一个新的空列表
Script : [empty]
  1. 返回一个新的空列表
ScriptBody : StatementList
  1. 返回TopLevelLexicallyDeclaredNamesStatementList
注 1

Script的顶层,函数声明被视为var声明,而不是词法声明。

注 2

Module的LexicallyDeclaredNames包括所有导入绑定的名称。

ModuleItemList : ModuleItemList ModuleItem
  1. names1LexicallyDeclaredNamesModuleItemList
  2. names2LexicallyDeclaredNamesModuleItem
  3. 返回 names1names2列表连接
ModuleItem : ImportDeclaration
  1. 返回BoundNamesImportDeclaration
ModuleItem : ExportDeclaration
  1. 如果ExportDeclarationexport VariableStatement,返回一个新的空列表
  2. 返回BoundNamesExportDeclaration
ModuleItem : StatementListItem
  1. 返回LexicallyDeclaredNamesStatementListItem
注 3

Module的顶层,函数声明被视为词法声明,而不是var声明。

8.2.5 静态语义:词法作用域声明

语法导向操作 LexicallyScopedDeclarations 不接受任何参数,并返回一个列表,其中包含解析节点。它在以下产生式上逐段定义:

StatementList : StatementList StatementListItem
  1. declarations1LexicallyScopedDeclarationsStatementList
  2. declarations2LexicallyScopedDeclarationsStatementListItem
  3. 返回 declarations1declarations2列表连接
StatementListItem : Statement
  1. 如果Statement Statement : LabelledStatement ,返回LexicallyScopedDeclarationsLabelledStatement
  2. 返回一个新的空列表
StatementListItem : Declaration
  1. 返回一个列表,其唯一元素是DeclarationPartDeclaration
CaseBlock : { }
  1. 返回一个新的空列表
CaseBlock : { CaseClausesopt DefaultClause CaseClausesopt }
  1. 如果第一个CaseClauses存在,令declarations1为第一个CaseClausesLexicallyScopedDeclarations
  2. 否则,令declarations1为一个新的空列表
  3. declarations2DefaultClauseLexicallyScopedDeclarations
  4. 如果第二个CaseClauses存在,令declarations3为第二个CaseClausesLexicallyScopedDeclarations
  5. 否则,令declarations3为一个新的空列表
  6. 返回declarations1declarations2declarations3列表连接
CaseClauses : CaseClauses CaseClause
  1. declarations1LexicallyScopedDeclarationsCaseClauses
  2. declarations2LexicallyScopedDeclarationsCaseClause
  3. 返回 declarations1declarations2列表连接
CaseClause : case Expression : StatementListopt
  1. 如果StatementList存在,返回StatementListLexicallyScopedDeclarations
  2. 返回一个新的空列表
DefaultClause : default : StatementListopt
  1. 如果StatementList存在,返回StatementListLexicallyScopedDeclarations
  2. 返回一个新的空列表
LabelledStatement : LabelIdentifier : LabelledItem
  1. 返回LexicallyScopedDeclarationsLabelledItem
LabelledItem : Statement
  1. 返回一个新的空列表
LabelledItem : FunctionDeclaration
  1. 返回 « FunctionDeclaration »。
FunctionStatementList : [empty]
  1. 返回一个新的空列表
FunctionStatementList : StatementList
  1. 返回TopLevelLexicallyScopedDeclarationsStatementList
ClassStaticBlockStatementList : [empty]
  1. 返回一个新的空列表
ClassStaticBlockStatementList : StatementList
  1. 返回TopLevelLexicallyScopedDeclarationsStatementList
ConciseBody : ExpressionBody
  1. 返回一个新的空列表
AsyncConciseBody : ExpressionBody
  1. 返回一个新的空列表
Script : [empty]
  1. 返回一个新的空列表
ScriptBody : StatementList
  1. 返回TopLevelLexicallyScopedDeclarationsStatementList
Module : [empty]
  1. 返回一个新的空列表
ModuleItemList : ModuleItemList ModuleItem
  1. declarations1LexicallyScopedDeclarationsModuleItemList
  2. declarations2LexicallyScopedDeclarationsModuleItem
  3. 返回 declarations1declarations2列表连接
ModuleItem : ImportDeclaration
  1. 返回一个新的空列表
ExportDeclaration : export ExportFromClause FromClause ; export NamedExports ; export VariableStatement
  1. 返回一个新的空列表
ExportDeclaration : export Declaration
  1. 返回一个列表,其唯一元素是DeclarationPartDeclaration
ExportDeclaration : export default HoistableDeclaration
  1. 返回一个列表,其唯一元素是DeclarationPartHoistableDeclaration
ExportDeclaration : export default ClassDeclaration
  1. 返回一个列表,其唯一元素是ClassDeclaration
ExportDeclaration : export default AssignmentExpression ;
  1. 返回一个列表,其唯一元素是此ExportDeclaration

8.2.6 静态语义: VarDeclaredNames

语法导向操作 VarDeclaredNames 不接受任何参数,并返回一个字符串列表。它在以下产生式上逐段定义:

Statement : EmptyStatement ExpressionStatement ContinueStatement BreakStatement ReturnStatement ThrowStatement DebuggerStatement
  1. 返回一个新的空列表
Block : { }
  1. 返回一个新的空列表
StatementList : StatementList StatementListItem
  1. names1VarDeclaredNamesStatementList
  2. names2VarDeclaredNamesStatementListItem
  3. 返回 names1names2列表连接
StatementListItem : Declaration
  1. 返回一个新的空列表
VariableStatement : var VariableDeclarationList ;
  1. 返回BoundNamesVariableDeclarationList
IfStatement : if ( Expression ) Statement else Statement
  1. names1 为第一个VarDeclaredNamesStatement
  2. names2 为第二个VarDeclaredNamesStatement
  3. 返回 names1names2列表连接
IfStatement : if ( Expression ) Statement
  1. 返回VarDeclaredNamesStatement
DoWhileStatement : do Statement while ( Expression ) ;
  1. 返回VarDeclaredNamesStatement
WhileStatement : while ( Expression ) Statement
  1. 返回VarDeclaredNamesStatement
ForStatement : for ( Expressionopt ; Expressionopt ; Expressionopt ) Statement
  1. 返回VarDeclaredNamesStatement
ForStatement : for ( var VariableDeclarationList ; Expressionopt ; Expressionopt ) Statement
  1. names1BoundNamesVariableDeclarationList
  2. names2VarDeclaredNamesStatement
  3. 返回 names1names2列表连接
ForStatement : for ( LexicalDeclaration Expressionopt ; Expressionopt ) Statement
  1. 返回VarDeclaredNamesStatement
ForInOfStatement : for ( LeftHandSideExpression in Expression ) Statement for ( ForDeclaration in Expression ) Statement for ( LeftHandSideExpression of AssignmentExpression ) Statement for ( ForDeclaration of AssignmentExpression ) Statement for await ( LeftHandSideExpression of AssignmentExpression ) Statement for await ( ForDeclaration of AssignmentExpression ) Statement
  1. 返回VarDeclaredNamesStatement
ForInOfStatement : for ( var ForBinding in Expression ) Statement for ( var ForBinding of AssignmentExpression ) Statement for await ( var ForBinding of AssignmentExpression ) Statement
  1. names1BoundNamesForBinding
  2. names2VarDeclaredNamesStatement
  3. 返回 names1names2列表连接

本节由附录B.3.5进行扩展。

WithStatement : with ( Expression ) Statement
  1. 返回VarDeclaredNamesStatement
SwitchStatement : switch ( Expression ) CaseBlock
  1. 返回VarDeclaredNamesCaseBlock
CaseBlock : { }
  1. 返回一个新的空列表
CaseBlock : { CaseClausesopt DefaultClause CaseClausesopt }
  1. 如果第一个CaseClauses存在,令names1为第一个CaseClausesVarDeclaredNames
  2. 否则,令names1为一个新的空列表
  3. names2DefaultClauseVarDeclaredNames
  4. 如果第二个CaseClauses存在,令names3为第二个CaseClausesVarDeclaredNames
  5. 否则,令names3为一个新的空列表
  6. 返回names1names2names3列表连接
CaseClauses : CaseClauses CaseClause
  1. names1VarDeclaredNamesCaseClauses
  2. names2VarDeclaredNamesCaseClause
  3. 返回 names1names2列表连接
CaseClause : case Expression : StatementListopt
  1. 如果StatementList存在,返回StatementListVarDeclaredNames
  2. 返回一个新的空列表
DefaultClause : default : StatementListopt
  1. 如果StatementList存在,返回StatementListVarDeclaredNames
  2. 返回一个新的空列表
LabelledStatement : LabelIdentifier : LabelledItem
  1. 返回VarDeclaredNamesLabelledItem
LabelledItem : FunctionDeclaration
  1. 返回一个新的空列表
TryStatement : try Block Catch
  1. names1VarDeclaredNamesBlock
  2. names2VarDeclaredNamesCatch
  3. 返回 names1names2列表连接
TryStatement : try Block Finally
  1. names1VarDeclaredNamesBlock
  2. names2VarDeclaredNamesFinally
  3. 返回 names1names2列表连接
TryStatement : try Block Catch Finally
  1. names1VarDeclaredNamesBlock
  2. names2VarDeclaredNamesCatch
  3. names3VarDeclaredNamesFinally
  4. 返回 names1names2names3列表连接
Catch : catch ( CatchParameter ) Block
  1. 返回VarDeclaredNamesBlock
FunctionStatementList : [empty]
  1. 返回一个新的空列表
FunctionStatementList : StatementList
  1. 返回TopLevelVarDeclaredNamesStatementList
ClassStaticBlockStatementList : [empty]
  1. 返回一个新的空列表
ClassStaticBlockStatementList : StatementList
  1. 返回TopLevelVarDeclaredNamesStatementList
ConciseBody : ExpressionBody
  1. 返回一个新的空列表
AsyncConciseBody : ExpressionBody
  1. 返回一个新的空列表
Script : [empty]
  1. 返回一个新的空列表
ScriptBody : StatementList
  1. 返回TopLevelVarDeclaredNamesStatementList
ModuleItemList : ModuleItemList ModuleItem
  1. names1VarDeclaredNamesModuleItemList
  2. names2VarDeclaredNamesModuleItem
  3. 返回 names1names2列表连接
ModuleItem : ImportDeclaration
  1. 返回一个新的空列表
ModuleItem : ExportDeclaration
  1. 如果ExportDeclarationexport VariableStatement,返回BoundNamesExportDeclaration
  2. 返回一个新的空列表

8.2.7 静态语义:VarScopedDeclarations

VarScopedDeclarations是一个无需参数并返回List的语法定向操作,其中列表包含Parse Nodes。它通过以下各个产生式逐段定义:

Statement : EmptyStatement ExpressionStatement ContinueStatement BreakStatement ReturnStatement ThrowStatement DebuggerStatement
  1. 返回一个新的空 List
Block : { }
  1. 返回一个新的空 List
StatementList : StatementList StatementListItem
  1. declarations1VarScopedDeclarations,位于 StatementList
  2. declarations2VarScopedDeclarations,位于 StatementListItem
  3. 返回 list-concatenation 的结果,包括 declarations1declarations2
StatementListItem : Declaration
  1. 返回一个新的空 List
VariableDeclarationList : VariableDeclaration
  1. 返回 « VariableDeclaration »。
VariableDeclarationList : VariableDeclarationList , VariableDeclaration
  1. declarations1VarScopedDeclarationsVariableDeclarationList
  2. 返回 list-concatenationdeclarations1 和 « VariableDeclaration »。
IfStatement : if ( Expression ) Statement else Statement
  1. declarations1VarScopedDeclarations 的第一个 Statement
  2. declarations2VarScopedDeclarations 的第二个 Statement
  3. 返回 list-concatenationdeclarations1declarations2
IfStatement : if ( Expression ) Statement
  1. 返回 StatementVarScopedDeclarations
DoWhileStatement : do Statement while ( Expression ) ;
  1. 返回 StatementVarScopedDeclarations
WhileStatement : while ( Expression ) Statement
  1. 返回 StatementVarScopedDeclarations
ForStatement : for ( Expressionopt ; Expressionopt ; Expressionopt ) Statement
  1. 返回 StatementVarScopedDeclarations
ForStatement : for ( var VariableDeclarationList ; Expressionopt ; Expressionopt ) Statement
  1. declarations1 成为 VariableDeclarationListVarScopedDeclarations
  2. declarations2 成为 StatementVarScopedDeclarations
  3. 返回 declarations1declarations2list-concatenation
ForStatement : for ( LexicalDeclaration Expressionopt ; Expressionopt ) Statement
  1. 返回 StatementVarScopedDeclarations
ForInOfStatement : for ( LeftHandSideExpression in Expression ) Statement for ( ForDeclaration in Expression ) Statement for ( LeftHandSideExpression of AssignmentExpression ) Statement for ( ForDeclaration of AssignmentExpression ) Statement for await ( LeftHandSideExpression of AssignmentExpression ) Statement for await ( ForDeclaration of AssignmentExpression ) Statement
  1. 返回 StatementVarScopedDeclarations
ForInOfStatement : for ( var ForBinding in Expression ) Statement for ( var ForBinding of AssignmentExpression ) Statement for await ( var ForBinding of AssignmentExpression ) Statement
  1. declarations1 为 « ForBinding »。
  2. declarations2VarScopedDeclarationsStatement 中的结果。
  3. 返回 declarations1declarations2list-concatenation

本节由附件 B.3.5 扩展。

WithStatement : with ( Expression ) Statement
  1. 返回VarScopedDeclarations Statement的内容。
SwitchStatement : switch ( Expression ) CaseBlock
  1. 返回 VarScopedDeclarationsCaseBlock
CaseBlock : { }
  1. 返回一个新的空列表
CaseBlock : { CaseClausesopt DefaultClause CaseClausesopt }
  1. 如果第一个CaseClauses存在,则让declarations1成为第一个CaseClausesVarScopedDeclarations
  2. 否则,让declarations1成为一个新的空列表
  3. declarations2成为VarScopedDeclarationsDefaultClause
  4. 如果第二个CaseClauses存在,则让declarations3成为第二个CaseClausesVarScopedDeclarations
  5. 否则,让declarations3成为一个新的空列表
  6. 返回declarations1declarations2declarations3列表连接
CaseClauses : CaseClauses CaseClause
  1. declarations1成为VarScopedDeclarationsCaseClauses
  2. declarations2成为VarScopedDeclarationsCaseClause
  3. 返回declarations1declarations2列表连接
CaseClause : case Expression : StatementListopt
  1. 如果StatementList存在, 返回VarScopedDeclarationsStatementList
  2. 返回一个新的空List
DefaultClause : default : StatementListopt
  1. 如果StatementList存在, 返回VarScopedDeclarationsStatementList
  2. 返回一个新的空List
LabelledStatement : LabelIdentifier : LabelledItem
  1. 返回VarScopedDeclarationsLabelledItem
LabelledItem : FunctionDeclaration
  1. 返回一个新的空List
TryStatement : try Block Catch
  1. declarations1VarScopedDeclarationsBlock
  2. declarations2VarScopedDeclarationsCatch
  3. 返回declarations1declarations2list-concatenation
TryStatement : try Block Finally
  1. declarations1设为Block的变量作用域声明。
  2. declarations2设为Finally的变量作用域声明。
  3. 返回declarations1declarations2列表连接
TryStatement : try Block Catch Finally
  1. declarations1设为Block的变量作用域声明。
  2. declarations2设为Catch的变量作用域声明。
  3. declarations3设为Finally的变量作用域声明。
  4. 返回declarations1declarations2declarations3列表连接
Catch : catch ( CatchParameter ) Block
  1. 返回VarScopedDeclarationsBlock
FunctionStatementList : [empty]
  1. 返回一个新的空List
FunctionStatementList : StatementList
  1. 返回TopLevelVarScopedDeclarationsStatementList
ClassStaticBlockStatementList : [empty]
  1. 返回一个新的空List
ClassStaticBlockStatementList : StatementList
  1. 返回TopLevelVarScopedDeclarationsStatementList
ConciseBody : ExpressionBody
  1. 返回一个新的空List
AsyncConciseBody : ExpressionBody
  1. 返回一个新的空List
Script : [empty]
  1. 返回一个新的空List
ScriptBody : StatementList
  1. 返回TopLevelVarScopedDeclarationsStatementList
Module : [empty]
  1. 返回一个新的空List
ModuleItemList : ModuleItemList ModuleItem
  1. declarations1成为VarScopedDeclarationsModuleItemList
  2. declarations2成为VarScopedDeclarationsModuleItem
  3. 返回list-concatenationdeclarations1declarations2
ModuleItem : ImportDeclaration
  1. 返回一个新的空List
ModuleItem : ExportDeclaration
  1. 如果ExportDeclarationexport VariableStatement,返回 VarScopedDeclarationsVariableStatement
  2. 返回一个新的空List

8.2.8 静态语义: TopLevelLexicallyDeclaredNames

语法定向操作 TopLevelLexicallyDeclaredNames 不接受参数并返回一个 字符串列表。它在以下产生式上被分段定义:

StatementList : StatementList StatementListItem
  1. names1设为StatementList的顶层词法声明名称。
  2. names2设为StatementListItem的顶层词法声明名称。
  3. 返回names1names2列表连接
StatementListItem : Statement
  1. 返回一个新的空List
StatementListItem : Declaration
  1. 如果Declaration Declaration : HoistableDeclaration ,则
    1. 返回一个新的空List
  2. 返回BoundNames,属于Declaration

在函数或脚本的顶层,函数声明被视为 var 声明,而不是词法声明。

8.2.9 静态语义: TopLevelLexicallyScopedDeclarations

静态语义操作 TopLevelLexicallyScopedDeclarations 不接受参数,并返回一个 List,其中包含 解析节点。它根据以下产生式逐段定义:

StatementList : StatementList StatementListItem
  1. declarations1 成为 TopLevelLexicallyScopedDeclarationsStatementList
  2. declarations2 成为 TopLevelLexicallyScopedDeclarationsStatementListItem
  3. 返回 list-concatenation, 包含 declarations1declarations2
StatementListItem : Statement
  1. 返回一个新的空 List
StatementListItem : Declaration
  1. 如果 Declaration Declaration : HoistableDeclaration ,那么
    1. 返回一个新的空 List
  2. 返回 « Declaration »。

8.2.10 静态语义: TopLevelVarDeclaredNames

语法定向操作 TopLevelVarDeclaredNames 不接受参数,并返回一个 List,其中包含字符串列表。它在以下产生式上分段定义:

StatementList : StatementList StatementListItem
  1. names1TopLevelVarDeclaredNamesStatementList 的。
  2. names2TopLevelVarDeclaredNamesStatementListItem 的。
  3. 返回 list-concatenationnames1names2
StatementListItem : Declaration
  1. 如果 Declaration Declaration : HoistableDeclaration ,则
    1. 返回 BoundNamesHoistableDeclaration
  2. 返回一个新的空 List
StatementListItem : Statement
  1. 如果 Statement Statement : LabelledStatement ,返回 TopLevelVarDeclaredNamesStatement
  2. 返回 VarDeclaredNamesStatement

在函数或脚本的顶层,内部函数声明被视为 var 声明。

LabelledStatement : LabelIdentifier : LabelledItem
  1. 返回 TopLevelVarDeclaredNamesLabelledItem
LabelledItem : Statement
  1. 如果Statement Statement : LabelledStatement ,返回TopLevelVarDeclaredNamesStatement
  2. 返回VarDeclaredNamesStatement
LabelledItem : FunctionDeclaration
  1. 返回FunctionDeclarationFunctionDeclaration

8.2.11 Static Semantics: TopLevelVarScopedDeclarations

The 语法导向操作 TopLevelVarScopedDeclarations 不接受参数并返回一个 列表,其中包含 解析节点。 它在以下各处生效:

StatementList : StatementList StatementListItem
  1. Let declarations1 be TopLevelVarScopedDeclarationsStatementList
  2. Let declarations2 be TopLevelVarScopedDeclarationsStatementListItem
  3. Return 列表连接 declarations1declarations2
StatementListItem : Statement
  1. 如果 Statement Statement : LabelledStatement ,返回 TopLevelVarScopedDeclarationsStatement
  2. 返回 VarScopedDeclarationsStatement
StatementListItem : Declaration
  1. 如果 Declaration Declaration : HoistableDeclaration ,那么
    1. declaration 成为 HoistableDeclarationDeclarationPart
    2. 返回 « declaration »。
  2. 返回一个新的空 List
LabelledStatement : LabelIdentifier : LabelledItem
  1. 返回 TopLevelVarScopedDeclarations 中的 LabelledItem
LabelledItem : Statement
  1. 如果 Statement Statement : LabelledStatement , 返回 TopLevelVarScopedDeclarations 中的 Statement
  2. 返回 VarScopedDeclarations 中的 Statement
LabelledItem : FunctionDeclaration
  1. 返回 « FunctionDeclaration »。

8.3 Labels

8.3.1 静态语义: 包含重复标签 (ContainsDuplicateLabels)

语法导向操作 ContainsDuplicateLabels 接受参数 labelSet(一个 字符串列表)并返回一个布尔值。它在以下各个产生式上分段定义:

Statement : VariableStatement EmptyStatement ExpressionStatement ContinueStatement BreakStatement ReturnStatement ThrowStatement DebuggerStatement Block : { } StatementListItem : Declaration
  1. 返回 false
StatementList : StatementList StatementListItem
  1. hasDuplicates 为带有参数 labelSetContainsDuplicateLabelsStatementList 中的结果。
  2. 如果 hasDuplicatestrue,则返回 true
  3. 返回带有参数 labelSetContainsDuplicateLabelsStatementListItem 中的结果。
IfStatement : if ( Expression ) Statement else Statement
  1. hasDuplicate 为带有参数 labelSetContainsDuplicateLabels 在第一个 Statement 中的结果。
  2. 如果 hasDuplicatetrue,则返回 true
  3. 返回带有参数 labelSetContainsDuplicateLabels 在第二个 Statement 中的结果。
IfStatement : if ( Expression ) Statement
  1. 返回带有参数 labelSetContainsDuplicateLabelsStatement 中的结果。
DoWhileStatement : do Statement while ( Expression ) ;
  1. 返回带有参数 labelSetContainsDuplicateLabelsStatement 中的结果。
WhileStatement : while ( Expression ) Statement
  1. 返回带有参数 labelSetContainsDuplicateLabelsStatement 中的结果。
ForStatement : for ( Expressionopt ; Expressionopt ; Expressionopt ) Statement for ( var VariableDeclarationList ; Expressionopt ; Expressionopt ) Statement for ( LexicalDeclaration Expressionopt ; Expressionopt ) Statement
  1. 返回带有参数 labelSetContainsDuplicateLabelsStatement 中的结果。
ForInOfStatement : for ( LeftHandSideExpression in Expression ) Statement for ( var ForBinding in Expression ) Statement for ( ForDeclaration in Expression ) Statement for ( LeftHandSideExpression of AssignmentExpression ) Statement for ( var ForBinding of AssignmentExpression ) Statement for ( ForDeclaration of AssignmentExpression ) Statement for await ( LeftHandSideExpression of AssignmentExpression ) Statement for await ( var ForBinding of AssignmentExpression ) Statement for await ( ForDeclaration of AssignmentExpression ) Statement
  1. 返回带有参数 labelSetContainsDuplicateLabelsStatement 中的结果。

此部分由附录 B.3.5 扩展。

WithStatement : with ( Expression ) Statement
  1. 返回带有参数 labelSetContainsDuplicateLabelsStatement
SwitchStatement : switch ( Expression ) CaseBlock
  1. 返回带有参数 labelSetContainsDuplicateLabelsCaseBlock
CaseBlock : { }
  1. 返回 false
CaseBlock : { CaseClausesopt DefaultClause CaseClausesopt }
  1. 如果第一个 CaseClauses 存在,则
    1. 如果使用参数 labelSet 调用第一个 CaseClausesContainsDuplicateLabels 返回 true,则返回 true
  2. 如果使用参数 labelSet 调用 ContainsDuplicateLabels 返回第二个 DefaultClause 的结果为 true,则返回 true
  3. 如果第二个 CaseClauses 不存在,则返回 false
  4. 返回使用参数 labelSet 调用第二个 CaseClausesContainsDuplicateLabels
CaseClauses : CaseClauses CaseClause
  1. hasDuplicates 为使用参数 labelSet 调用 ContainsDuplicateLabels 的结果,作用于 CaseClauses
  2. 如果 hasDuplicatestrue,则返回 true
  3. 返回使用参数 labelSet 调用 ContainsDuplicateLabels 的结果,作用于 CaseClause
CaseClause : case Expression : StatementListopt
  1. 如果存在 StatementList,则返回使用参数 labelSet 调用 ContainsDuplicateLabels 的结果,作用于 StatementList
  2. 返回 false
DefaultClause : default : StatementListopt
  1. 如果存在 StatementList,则返回使用参数 labelSet 调用 ContainsDuplicateLabels 的结果,作用于 StatementList
  2. 返回 false
LabelledStatement : LabelIdentifier : LabelledItem
  1. label 设置为 StringValue 的值,来源于 LabelIdentifier
  2. 如果 labelSet 包含 label,则返回 true
  3. newLabelSetlist-concatenation,包含 labelSet 和 « label »。
  4. 返回使用参数 newLabelSet 调用 ContainsDuplicateLabels 的结果,作用于 LabelledItem
LabelledItem : FunctionDeclaration
  1. 返回 false
TryStatement : try Block Catch
  1. hasDuplicates 成为 ContainsDuplicateLabels 用参数 labelSet 计算 Block
  2. 如果 hasDuplicatestrue,则返回 true
  3. 返回 ContainsDuplicateLabels 用参数 labelSet 计算 Catch
TryStatement : try Block Finally
  1. hasDuplicates 成为 ContainsDuplicateLabels 用参数 labelSet 计算 Block
  2. 如果 hasDuplicatestrue,则返回 true
  3. 返回 ContainsDuplicateLabels 用参数 labelSet 计算 Finally
TryStatement : try Block Catch Finally
  1. 如果 ContainsDuplicateLabels 用参数 labelSet 计算 Block 的结果是 true,则返回 true
  2. 如果 ContainsDuplicateLabels 用参数 labelSet 计算 Catch 的结果是 true,则返回 true
  3. 返回 ContainsDuplicateLabels 用参数 labelSet 计算 Finally 的结果。
Catch : catch ( CatchParameter ) Block
  1. 返回 ContainsDuplicateLabels 用参数 labelSet 计算 Block 的结果。
FunctionStatementList : [empty]
  1. 返回 false
ClassStaticBlockStatementList : [empty]
  1. 返回 false.
ModuleItemList : ModuleItemList ModuleItem
  1. hasDuplicates 为带有参数 labelSetContainsDuplicateLabels, 其中 ModuleItemList
  2. 如果 hasDuplicatestrue,则返回 true
  3. 返回带有参数 labelSetContainsDuplicateLabels ,其对应 ModuleItem
ModuleItem : ImportDeclaration ExportDeclaration
  1. 返回 false

8.3.2 静态语义: ContainsUndefinedBreakTarget

语法定向操作 ContainsUndefinedBreakTarget 接受参数 labelSet(一个字符串列表)并返回一个布尔值。它根据以下产生式逐段定义:

Statement : VariableStatement EmptyStatement ExpressionStatement ContinueStatement ReturnStatement ThrowStatement DebuggerStatement Block : { } StatementListItem : Declaration
  1. 返回 false
StatementList : StatementList StatementListItem
  1. hasUndefinedLabels 成为 ContainsUndefinedBreakTarget 应用于参数为 labelSetStatementList
  2. 如果 hasUndefinedLabelstrue,则返回 true
  3. 返回 ContainsUndefinedBreakTarget 应用于参数为 labelSetStatementListItem
IfStatement : if ( Expression ) Statement else Statement
  1. hasUndefinedLabels 成为 ContainsUndefinedBreakTarget 应用于参数为 labelSet 的第一个 Statement
  2. 如果 hasUndefinedLabelstrue,则返回 true
  3. 返回 ContainsUndefinedBreakTarget 应用于参数为 labelSet 的第二个 Statement
IfStatement : if ( Expression ) Statement
  1. 返回 ContainsUndefinedBreakTarget 应用于参数为 labelSetStatement
DoWhileStatement : do Statement while ( Expression ) ;
  1. 返回 ContainsUndefinedBreakTarget 应用于参数为 labelSetStatement
WhileStatement : while ( Expression ) Statement
  1. 返回 ContainsUndefinedBreakTarget 应用于参数为 labelSetStatement
ForStatement : for ( Expressionopt ; Expressionopt ; Expressionopt ) Statement for ( var VariableDeclarationList ; Expressionopt ; Expressionopt ) Statement for ( LexicalDeclaration Expressionopt ; Expressionopt ) Statement
  1. 返回 ContainsUndefinedBreakTarget 应用于参数为 labelSetStatement
ForInOfStatement : for ( LeftHandSideExpression in Expression ) Statement for ( var ForBinding in Expression ) Statement for ( ForDeclaration in Expression ) Statement for ( LeftHandSideExpression of AssignmentExpression ) Statement for ( var ForBinding of AssignmentExpression ) Statement for ( ForDeclaration of AssignmentExpression ) Statement for await ( LeftHandSideExpression of AssignmentExpression ) Statement for await ( var ForBinding of AssignmentExpression ) Statement for await ( ForDeclaration of AssignmentExpression ) Statement
  1. 返回 ContainsUndefinedBreakTarget 应用于参数为 labelSetStatement

此部分由附件 B.3.5 扩展。

BreakStatement : break ;
  1. 返回 false
BreakStatement : break LabelIdentifier ;
  1. 如果 labelSet 不包含 StringValueLabelIdentifier,则返回 true
  2. 返回 false
WithStatement : with ( Expression ) Statement
  1. 返回 ContainsUndefinedBreakTarget 应用于参数为 labelSetStatement
SwitchStatement : switch ( Expression ) CaseBlock
  1. 返回 ContainsUndefinedBreakTarget 应用于参数为 labelSetCaseBlock
CaseBlock : { }
  1. 返回false
CaseBlock : { CaseClausesopt DefaultClause CaseClausesopt }
  1. 如果第一个CaseClauses存在,则
    1. 如果使用参数labelSet调用ContainsUndefinedBreakTarget 返回true
  2. 如果使用参数labelSet调用ContainsUndefinedBreakTarget 的返回值为true,则返回true
  3. 如果第二个CaseClauses不存在,则返回false
  4. 返回使用参数labelSet调用ContainsUndefinedBreakTarget 的第二个CaseClauses
CaseClauses : CaseClauses CaseClause
  1. hasUndefinedLabelsContainsUndefinedBreakTarget 的返回值,使用参数labelSet调用CaseClauses
  2. 如果hasUndefinedLabelstrue,则返回true
  3. 使用参数labelSet调用ContainsUndefinedBreakTarget 的返回值,使用CaseClause
CaseClause : case Expression : StatementListopt
  1. 如果存在StatementList,则返回使用参数labelSet调用ContainsUndefinedBreakTarget 的返回值,使用StatementList
  2. 返回false
DefaultClause : default : StatementListopt
  1. 如果StatementList存在, 使用参数labelSet调用ContainsUndefinedBreakTarget的返回值,使用StatementList
  2. 返回false
LabelledStatement : LabelIdentifier : LabelledItem
  1. labelStringValue的返回值, 使用LabelIdentifier
  2. newLabelSetlist-concatenation的返回值,使用labelSet和«label »。
  3. 使用参数newLabelSet调用ContainsUndefinedBreakTarget的返回值, 使用LabelledItem
LabelledItem : FunctionDeclaration
  1. 返回false
TryStatement : try Block Catch
  1. hasUndefinedLabelsContainsUndefinedBreakTarget的返回值, 使用BlocklabelSet
  2. 如果hasUndefinedLabelstrue,返回true
  3. 使用CatchlabelSet调用ContainsUndefinedBreakTarget的返回值。
TryStatement : try Block Finally
  1. hasUndefinedLabelsContainsUndefinedBreakTarget的返回值, 使用BlocklabelSet
  2. 如果hasUndefinedLabelstrue,返回true
  3. 使用FinallylabelSet调用ContainsUndefinedBreakTarget的返回值。
TryStatement : try Block Catch Finally
  1. 如果ContainsUndefinedBreakTarget 的返回值为true,使用BlocklabelSet,返回true
  2. 如果ContainsUndefinedBreakTarget 的返回值为true,使用CatchlabelSet,返回true
  3. 使用FinallylabelSet调用ContainsUndefinedBreakTarget的返回值。
Catch : catch ( CatchParameter ) Block
  1. 使用BlocklabelSet调用ContainsUndefinedBreakTarget的返回值。
FunctionStatementList : [空]
  1. 返回false
ClassStaticBlockStatementList : [空]
  1. 返回false
ModuleItemList : ModuleItemList ModuleItem
  1. hasUndefinedLabelsContainsUndefinedBreakTarget 的返回值,使用ModuleItemListlabelSet作为参数。
  2. 如果hasUndefinedLabelstrue,返回true
  3. 使用ModuleItemlabelSet作为参数,调用ContainsUndefinedBreakTarget的返回值。
ModuleItem : ImportDeclaration ExportDeclaration
  1. 返回false

8.3.3 静态语义: ContainsUndefinedContinueTarget

语法定向操作 ContainsUndefinedContinueTarget 接受参数 iterationSet(一个字符串列表)和 labelSet(一个字符串列表),返回一个布尔值。它根据以下产生式逐段定义:

Statement : VariableStatement EmptyStatement ExpressionStatement BreakStatement ReturnStatement ThrowStatement DebuggerStatement Block : { } StatementListItem : Declaration
  1. 返回 false
Statement : BlockStatement
  1. 返回 ContainsUndefinedContinueTarget 对于 BlockStatement 的结果,参数为 iterationSet 和 « »。
BreakableStatement : IterationStatement
  1. newIterationSetlist-concatenation 的结果,参数为 iterationSetlabelSet
  2. 返回 ContainsUndefinedContinueTarget 对于 IterationStatement 的结果,参数为 newIterationSet 和 « »。
StatementList : StatementList StatementListItem
  1. hasUndefinedLabelsContainsUndefinedContinueTarget 对于 StatementList 的结果,参数为 iterationSet 和 « »。
  2. 如果 hasUndefinedLabelstrue,则返回 true
  3. 返回 ContainsUndefinedContinueTarget 对于第二个 Statement 的结果,参数为 iterationSet 和 « »。
IfStatement : if ( Expression ) Statement else Statement
  1. hasUndefinedLabelsContainsUndefinedContinueTarget 对于第一个 Statement 的结果,参数为 iterationSet 和 « »。
  2. 如果 hasUndefinedLabelstrue,则返回 true
  3. 返回 ContainsUndefinedContinueTarget 对于第二个 Statement 的结果,参数为 iterationSet 和 « »。
IfStatement : if ( Expression ) Statement
  1. 返回 ContainsUndefinedContinueTarget 对于 Statement 的结果,参数为 iterationSet 和 « »。
DoWhileStatement : do Statement while ( Expression ) ;
  1. 返回 ContainsUndefinedContinueTarget 对于 Statement 的结果,参数为 iterationSet 和 « »。
WhileStatement : while ( Expression ) Statement
  1. 返回 ContainsUndefinedContinueTarget 对于 Statement 的结果,参数为 iterationSet 和 « »。
ForStatement : for ( Expressionopt ; Expressionopt ; Expressionopt ) Statement for ( var VariableDeclarationList ; Expressionopt ; Expressionopt ) Statement for ( LexicalDeclaration Expressionopt ; Expressionopt ) Statement
  1. 返回使用参数 iterationSet 和 « » 的 ContainsUndefinedContinueTargetStatement 进行调用。
ForInOfStatement : for ( LeftHandSideExpression in Expression ) Statement for ( var ForBinding in Expression ) Statement for ( ForDeclaration in Expression ) Statement for ( LeftHandSideExpression of AssignmentExpression ) Statement for ( var ForBinding of AssignmentExpression ) Statement for ( ForDeclaration of AssignmentExpression ) Statement for await ( LeftHandSideExpression of AssignmentExpression ) Statement for await ( var ForBinding of AssignmentExpression ) Statement for await ( ForDeclaration of AssignmentExpression ) Statement
  1. 返回使用参数 iterationSet 和 « » 的 ContainsUndefinedContinueTargetStatement 进行调用。

本节由附录 B.3.5 扩展。

ContinueStatement : continue ;
  1. 返回 false
ContinueStatement : continue LabelIdentifier ;
  1. 如果 iterationSet 不包含 LabelIdentifierStringValue,则返回 true
  2. 返回 false
WithStatement : with ( Expression ) Statement
  1. 返回使用参数 iterationSet 和 « » 的 ContainsUndefinedContinueTargetStatement 进行调用。
SwitchStatement : switch ( Expression ) CaseBlock
  1. 返回使用参数 iterationSet 和 « » 的 ContainsUndefinedContinueTargetCaseBlock 进行调用。
CaseBlock : { }
  1. 返回 false
CaseBlock : { CaseClausesopt DefaultClause CaseClausesopt }
  1. 如果第一个 CaseClauses 存在,则
    1. 如果 ContainsUndefinedContinueTarget 对第一个带参数 iterationSet 和 « » 的 CaseClauses 返回 true,则返回 true
  2. 如果 ContainsUndefinedContinueTarget 对带参数 iterationSet 和 « » 的 DefaultClause 返回 true,则返回 true
  3. 如果第二个 CaseClauses 不存在,则返回 false
  4. 返回使用参数 iterationSet 和 « » 的第二个 CaseClausesContainsUndefinedContinueTarget
CaseClauses : CaseClauses CaseClause
  1. hasUndefinedLabels 等于使用参数 iterationSet 和 « » 的 ContainsUndefinedContinueTargetCaseClauses 进行调用。
  2. 如果 hasUndefinedLabelstrue,则返回 true
  3. 返回使用参数 iterationSet 和 « » 的 ContainsUndefinedContinueTargetCaseClause 进行调用。
CaseClause : case Expression : StatementListopt
  1. 如果存在 StatementList,则返回使用参数 iterationSet 和 « » 的 ContainsUndefinedContinueTargetStatementList 进行调用。
  2. 返回 false
DefaultClause : default : StatementListopt
  1. 如果存在 StatementList,则返回使用参数 iterationSet 和 « » 的 ContainsUndefinedContinueTargetStatementList 进行调用。
  2. 返回 false
LabelledStatement : LabelIdentifier : LabelledItem
  1. labelLabelIdentifierStringValue
  2. newLabelSetlabelSet 和 « label » 的 list-concatenation
  3. 返回使用参数 iterationSetnewLabelSetContainsUndefinedContinueTargetLabelledItem 进行调用。
LabelledItem : FunctionDeclaration
  1. 返回 false
TryStatement : try Block Catch
  1. hasUndefinedLabels 为使用参数 iterationSet 和 « » 调用 ContainsUndefinedContinueTargetBlock 的结果。
  2. 如果 hasUndefinedLabelstrue,则返回 true
  3. 返回使用参数 iterationSet 和 « » 调用 ContainsUndefinedContinueTargetCatch 的结果。
TryStatement : try Block Finally
  1. hasUndefinedLabels 为使用参数 iterationSet 和 « » 调用 ContainsUndefinedContinueTargetBlock 的结果。
  2. 如果 hasUndefinedLabelstrue,则返回 true
  3. 返回使用参数 iterationSet 和 « » 调用 ContainsUndefinedContinueTargetFinally 的结果。
TryStatement : try Block Catch Finally
  1. 如果使用参数 iterationSet 和 « » 调用 ContainsUndefinedContinueTargetBlock 的结果为 true,则返回 true
  2. 如果使用参数 iterationSet 和 « » 调用 ContainsUndefinedContinueTargetCatch 的结果为 true,则返回 true
  3. 返回使用参数 iterationSet 和 « » 调用 ContainsUndefinedContinueTargetFinally 的结果。
Catch : catch ( CatchParameter ) Block
  1. 返回使用参数 iterationSet 和 « » 调用 ContainsUndefinedContinueTargetBlock 的结果。
FunctionStatementList : [empty]
  1. 返回 false
ClassStaticBlockStatementList : [empty]
  1. 返回 false
ModuleItemList : ModuleItemList ModuleItem
  1. hasUndefinedLabels 成为使用参数 iterationSet 和 « » 调用 ContainsUndefinedContinueTargetModuleItemList 的结果。
  2. 如果 hasUndefinedLabelstrue,则返回 true
  3. 返回使用参数 iterationSet 和 « » 调用 ContainsUndefinedContinueTargetModuleItem 的结果。
ModuleItem : ImportDeclaration ExportDeclaration
  1. 返回 false

8.4 函数名称推断

8.4.1 静态语义:HasName

语法定向操作 HasName 不接受任何参数并返回一个布尔值。它在以下各个生成式上逐块定义:

PrimaryExpression : CoverParenthesizedExpressionAndArrowParameterList
  1. exprParenthesizedExpression,它被 CoverParenthesizedExpressionAndArrowParameterList 覆盖
  2. 如果 exprIsFunctionDefinitionfalse,则返回 false
  3. 返回 exprHasName
FunctionExpression : function ( FormalParameters ) { FunctionBody } GeneratorExpression : function * ( FormalParameters ) { GeneratorBody } AsyncGeneratorExpression : async function * ( FormalParameters ) { AsyncGeneratorBody } AsyncFunctionExpression : async function ( FormalParameters ) { AsyncFunctionBody } ArrowFunction : ArrowParameters => ConciseBody AsyncArrowFunction : async AsyncArrowBindingIdentifier => AsyncConciseBody CoverCallExpressionAndAsyncArrowHead => AsyncConciseBody ClassExpression : class ClassTail
  1. 返回 false
FunctionExpression : function BindingIdentifier ( FormalParameters ) { FunctionBody } GeneratorExpression : function * BindingIdentifier ( FormalParameters ) { GeneratorBody } AsyncGeneratorExpression : async function * BindingIdentifier ( FormalParameters ) { AsyncGeneratorBody } AsyncFunctionExpression : async function BindingIdentifier ( FormalParameters ) { AsyncFunctionBody } ClassExpression : class BindingIdentifier ClassTail
  1. 返回 true.

8.4.2 静态语义:IsFunctionDefinition

语法导向操作 IsFunctionDefinition 不接受任何参数,返回一个布尔值。它在以下产生式上逐步定义:

PrimaryExpression : CoverParenthesizedExpressionAndArrowParameterList
  1. exprParenthesizedExpression,它是由 CoverParenthesizedExpressionAndArrowParameterList 覆盖 的表达式。
  2. 返回 exprIsFunctionDefinition
PrimaryExpression : this IdentifierReference Literal ArrayLiteral ObjectLiteral RegularExpressionLiteral TemplateLiteral MemberExpression : MemberExpression [ Expression ] MemberExpression . IdentifierName MemberExpression TemplateLiteral SuperProperty MetaProperty new MemberExpression Arguments MemberExpression . PrivateIdentifier NewExpression : new NewExpression LeftHandSideExpression : CallExpression OptionalExpression UpdateExpression : LeftHandSideExpression ++ LeftHandSideExpression -- ++ UnaryExpression -- UnaryExpression UnaryExpression : delete UnaryExpression void UnaryExpression typeof UnaryExpression + UnaryExpression - UnaryExpression ~ UnaryExpression ! UnaryExpression AwaitExpression ExponentiationExpression : UpdateExpression ** ExponentiationExpression MultiplicativeExpression : MultiplicativeExpression MultiplicativeOperator ExponentiationExpression AdditiveExpression : AdditiveExpression + MultiplicativeExpression AdditiveExpression - MultiplicativeExpression ShiftExpression : ShiftExpression << AdditiveExpression ShiftExpression >> AdditiveExpression ShiftExpression >>> AdditiveExpression RelationalExpression : RelationalExpression < ShiftExpression RelationalExpression > ShiftExpression RelationalExpression <= ShiftExpression RelationalExpression >= ShiftExpression RelationalExpression instanceof ShiftExpression RelationalExpression in ShiftExpression PrivateIdentifier in ShiftExpression EqualityExpression : EqualityExpression == RelationalExpression EqualityExpression != RelationalExpression EqualityExpression === RelationalExpression EqualityExpression !== RelationalExpression BitwiseANDExpression : BitwiseANDExpression & EqualityExpression BitwiseXORExpression : BitwiseXORExpression ^ BitwiseANDExpression BitwiseORExpression : BitwiseORExpression | BitwiseXORExpression LogicalANDExpression : LogicalANDExpression && BitwiseORExpression LogicalORExpression : LogicalORExpression || LogicalANDExpression CoalesceExpression : CoalesceExpressionHead ?? BitwiseORExpression ConditionalExpression : ShortCircuitExpression ? AssignmentExpression : AssignmentExpression AssignmentExpression : YieldExpression LeftHandSideExpression = AssignmentExpression LeftHandSideExpression AssignmentOperator AssignmentExpression LeftHandSideExpression &&= AssignmentExpression LeftHandSideExpression ||= AssignmentExpression LeftHandSideExpression ??= AssignmentExpression Expression : Expression , AssignmentExpression
  1. 返回 false.
AssignmentExpression : ArrowFunction AsyncArrowFunction FunctionExpression : function BindingIdentifieropt ( FormalParameters ) { FunctionBody } GeneratorExpression : function * BindingIdentifieropt ( FormalParameters ) { GeneratorBody } AsyncGeneratorExpression : async function * BindingIdentifieropt ( FormalParameters ) { AsyncGeneratorBody } AsyncFunctionExpression : async function BindingIdentifieropt ( FormalParameters ) { AsyncFunctionBody } ClassExpression : class BindingIdentifieropt ClassTail
  1. 返回 true.

8.4.3 静态语义:IsAnonymousFunctionDefinition ( expr )

抽象操作 IsAnonymousFunctionDefinition 接受参数 expr(一个 AssignmentExpression 解析节点,一个 Initializer 解析节点,或一个 Expression 解析节点)并返回一个布尔值。它确定其参数是否为不绑定名称的函数定义。当调用时执行以下步骤:

  1. 如果 exprIsFunctionDefinition 返回 false,则返回 false
  2. hasNameexprHasName
  3. 如果 hasName 返回 true,则返回 false
  4. 返回 true

8.4.4 静态语义:IsIdentifierRef

语法定向操作 IsIdentifierRef 不接受任何参数并返回一个布尔值。它在以下各个生成式中逐段定义:

PrimaryExpression : IdentifierReference
  1. 返回 true.
PrimaryExpression : this Literal ArrayLiteral ObjectLiteral FunctionExpression ClassExpression GeneratorExpression AsyncFunctionExpression AsyncGeneratorExpression RegularExpressionLiteral TemplateLiteral CoverParenthesizedExpressionAndArrowParameterList MemberExpression : MemberExpression [ Expression ] MemberExpression . IdentifierName MemberExpression TemplateLiteral SuperProperty MetaProperty new MemberExpression Arguments MemberExpression . PrivateIdentifier NewExpression : new NewExpression LeftHandSideExpression : CallExpression OptionalExpression
  1. 返回 false.

8.4.5 运行时语义:NamedEvaluation

语法定向操作 NamedEvaluation 接受参数 name(一个 属性键 或一个 私有名称)并返回一个 包含 一个 函数对象 的正常完成记录或一个 异常完成。它在以下各个生成式中逐段定义:

PrimaryExpression : CoverParenthesizedExpressionAndArrowParameterList
  1. exprParenthesizedExpression,它被 覆盖CoverParenthesizedExpressionAndArrowParameterList 中。
  2. 返回 ? NamedEvaluationname 作为参数调用 expr
ParenthesizedExpression : ( Expression )
  1. 断言: IsAnonymousFunctionDefinition(Expression) 为 true
  2. 返回 ? NamedEvaluationname 作为参数调用 Expression
FunctionExpression : function ( FormalParameters ) { FunctionBody }
  1. 返回 InstantiateOrdinaryFunctionExpressionname 作为参数调用 FunctionExpression
GeneratorExpression : function * ( FormalParameters ) { GeneratorBody }
  1. 返回 InstantiateGeneratorFunctionExpressionname 作为参数调用 GeneratorExpression
AsyncGeneratorExpression : async function * ( FormalParameters ) { AsyncGeneratorBody }
  1. 返回 InstantiateAsyncGeneratorFunctionExpressionname 作为参数调用 AsyncGeneratorExpression
AsyncFunctionExpression : async function ( FormalParameters ) { AsyncFunctionBody }
  1. 返回 InstantiateAsyncFunctionExpressionname 作为参数调用 AsyncFunctionExpression
ArrowFunction : ArrowParameters => ConciseBody
  1. 返回 InstantiateArrowFunctionExpressionname 作为参数调用 ArrowFunction
AsyncArrowFunction : async AsyncArrowBindingIdentifier => AsyncConciseBody CoverCallExpressionAndAsyncArrowHead => AsyncConciseBody
  1. 返回 InstantiateAsyncArrowFunctionExpressionname 作为参数调用 AsyncArrowFunction
ClassExpression : class ClassTail
  1. value 为 ? ClassDefinitionEvaluationClassTail 和参数 undefined 以及 name 调用。
  2. value.[[SourceText]] 设置为 ClassExpression 匹配的源文本。
  3. 返回 value

8.5 包含

8.5.1 静态语义:Contains

语法导向操作 Contains 接受参数 symbol(一个语法符号)并返回一个布尔值。

本规范中未列出的每个语法生成替代方案都隐含具有以下默认的 Contains 定义:

  1. 对于此 解析节点 的每个子节点 child,执行以下操作:
    1. 如果 childsymbol 的一个实例,返回 true
    2. 如果 child 是一个非终结符的实例,那么:
      1. containedchild 结果的 Contains symbol
      2. 如果 containedtrue,返回 true
  2. 返回 false
FunctionDeclaration : function BindingIdentifier ( FormalParameters ) { FunctionBody } function ( FormalParameters ) { FunctionBody } FunctionExpression : function BindingIdentifieropt ( FormalParameters ) { FunctionBody } GeneratorDeclaration : function * BindingIdentifier ( FormalParameters ) { GeneratorBody } function * ( FormalParameters ) { GeneratorBody } GeneratorExpression : function * BindingIdentifieropt ( FormalParameters ) { GeneratorBody } AsyncGeneratorDeclaration : async function * BindingIdentifier ( FormalParameters ) { AsyncGeneratorBody } async function * ( FormalParameters ) { AsyncGeneratorBody } AsyncGeneratorExpression : async function * BindingIdentifieropt ( FormalParameters ) { AsyncGeneratorBody } AsyncFunctionDeclaration : async function BindingIdentifier ( FormalParameters ) { AsyncFunctionBody } async function ( FormalParameters ) { AsyncFunctionBody } AsyncFunctionExpression : async function BindingIdentifieropt ( FormalParameters ) { AsyncFunctionBody }
  1. 返回 false
注 1

依赖于子结构的静态语义规则通常不会深入查看函数定义。

ClassTail : ClassHeritageopt { ClassBody }
  1. 如果 symbolClassBody,则返回 true
  2. 如果 symbolClassHeritage,则
    1. 如果 ClassHeritage 存在,则返回 true;否则返回 false
  3. 如果 ClassHeritage 存在,则
    1. 如果 ClassHeritage Contains symboltrue,则返回 true
  4. 返回 ComputedPropertyContains 的结果,其参数为 symbol,在 ClassBody 中。
Note 2

Static semantic rules that depend upon substructure generally do not look into class bodies except for PropertyNames.

ClassStaticBlock : static { ClassStaticBlockBody }
  1. 返回 false
Note 3

依赖子结构的静态语义规则通常不会检查static初始化块。

ArrowFunction : ArrowParameters => ConciseBody
  1. 如果 symbol 不是 NewTargetSuperPropertySuperCallsuperthis 之一,则返回 false
  2. 如果 ArrowParameters Contains symboltrue,则返回 true
  3. 返回 ConciseBody Contains symbol
ArrowParameters : CoverParenthesizedExpressionAndArrowParameterList
  1. formalsArrowFormalParameters,该 CoverParenthesizedExpressionAndArrowParameterList覆盖
  2. 返回 formals Contains symbol 的结果。
AsyncArrowFunction : async AsyncArrowBindingIdentifier => AsyncConciseBody
  1. 如果 symbol 不是以下之一:NewTargetSuperPropertySuperCallsuper,或 this,返回 false
  2. 返回 AsyncConciseBodyContains symbol 的结果。
AsyncArrowFunction : CoverCallExpressionAndAsyncArrowHead => AsyncConciseBody
  1. 如果 symbol 不是以下之一:NewTargetSuperPropertySuperCallsuper,或 this,返回 false
  2. headAsyncArrowHead,它被 CoverCallExpressionAndAsyncArrowHead 覆盖
  3. 如果 head Contains symbol 的结果为 true,返回 true
  4. 返回 AsyncConciseBody Contains symbol 的结果。
Note 4

Contains is used to detect new.target, this, and super usage within an ArrowFunction or AsyncArrowFunction.

PropertyDefinition : MethodDefinition
  1. 如果 symbolMethodDefinition,返回 true
  2. 返回 MethodDefinition ComputedPropertyContains symbol 的结果。
LiteralPropertyName : IdentifierName
  1. 返回 false
MemberExpression : MemberExpression . IdentifierName
  1. 如果 MemberExpression Contains symboltrue,返回 true
  2. 返回 false
SuperProperty : super . IdentifierName
  1. 如果 symbolReservedWord super,返回 true
  2. 返回 false
CallExpression : CallExpression . IdentifierName
  1. 如果 CallExpression Contains symboltrue,返回 true
  2. 返回 false
OptionalChain : ?. IdentifierName
  1. 返回 false
OptionalChain : OptionalChain . IdentifierName
  1. 如果 OptionalChain Contains symboltrue,返回 true
  2. 返回 false

8.5.2 静态语义:ComputedPropertyContains

语法定向操作 ComputedPropertyContains 接受参数 symbol(一个语法符号)并返回一个布尔值。它通过以下生成式逐步定义:

ClassElementName : PrivateIdentifier PropertyName : LiteralPropertyName
  1. 返回 false
PropertyName : ComputedPropertyName
  1. 返回 ComputedPropertyName 的结果,其中 symbol 被作为 Contains 的参数。
MethodDefinition : ClassElementName ( UniqueFormalParameters ) { FunctionBody } get ClassElementName ( ) { FunctionBody } set ClassElementName ( PropertySetParameterList ) { FunctionBody }
  1. 返回 ComputedPropertyContains 的结果,其中 ClassElementName 被作为参数 symbol
GeneratorMethod : * ClassElementName ( UniqueFormalParameters ) { GeneratorBody }
  1. 返回 ComputedPropertyContains 的结果,其中 ClassElementName 被作为参数 symbol
AsyncGeneratorMethod : async * ClassElementName ( UniqueFormalParameters ) { AsyncGeneratorBody }
  1. 返回 ComputedPropertyContains 的结果,其中 ClassElementName 被作为参数 symbol
ClassElementList : ClassElementList ClassElement
  1. inListComputedPropertyContains 的结果,其中 ClassElementList 被作为参数 symbol
  2. 如果 inListtrue,则返回 true
  3. 返回 ComputedPropertyContains 的结果,其中 ClassElement 被作为参数 symbol
ClassElement : ClassStaticBlock
  1. 返回 false
ClassElement : ;
  1. 返回 false
AsyncMethod : async ClassElementName ( UniqueFormalParameters ) { AsyncFunctionBody }
  1. 返回 ComputedPropertyContains 的结果,其中 ClassElementName 被作为参数 symbol
FieldDefinition : ClassElementName Initializeropt
  1. 返回 ComputedPropertyContains 的结果,其中 ClassElementName 被作为参数 symbol

8.6 杂项

这些操作在整个规范的多个地方使用。

8.6.1 运行时语义: InstantiateFunctionObject

语法导向操作 InstantiateFunctionObject 接受参数 env(一个 环境记录)和 privateEnv(一个 私有环境记录null)并返回一个 ECMAScript 函数对象。它按以下生成规则定义:

FunctionDeclaration : function BindingIdentifier ( FormalParameters ) { FunctionBody } function ( FormalParameters ) { FunctionBody }
  1. 返回 InstantiateOrdinaryFunctionObjectFunctionDeclaration 的调用,参数为 envprivateEnv
GeneratorDeclaration : function * BindingIdentifier ( FormalParameters ) { GeneratorBody } function * ( FormalParameters ) { GeneratorBody }
  1. 返回 InstantiateGeneratorFunctionObjectGeneratorDeclaration 的调用,参数为 envprivateEnv
AsyncGeneratorDeclaration : async function * BindingIdentifier ( FormalParameters ) { AsyncGeneratorBody } async function * ( FormalParameters ) { AsyncGeneratorBody }
  1. 返回 InstantiateAsyncGeneratorFunctionObjectAsyncGeneratorDeclaration 的调用,参数为 envprivateEnv
AsyncFunctionDeclaration : async function BindingIdentifier ( FormalParameters ) { AsyncFunctionBody } async function ( FormalParameters ) { AsyncFunctionBody }
  1. 返回 InstantiateAsyncFunctionObjectAsyncFunctionDeclaration 的调用,参数为 envprivateEnv

8.6.2 运行时语义:绑定初始化

语法导向操作 BindingInitialization 接受参数 value(一个ECMAScript 语言值)和 environment(一个环境记录undefined)并返回一个包含 unused 的正常完成或一个突然完成

undefined 被传递给 environment 以表明应该使用PutValue操作来分配初始化值。对于var 语句和一些非严格函数的形式参数列表(参见10.2.11)来说就是这种情况。在这些情况下,词法绑定在其初始化器评估之前被提升和预初始化。

它在以下生成式中逐段定义:

BindingIdentifier : Identifier
  1. name 成为 StringValueIdentifier
  2. 返回 ? InitializeBoundName(name, value, environment)。
BindingIdentifier : yield
  1. 返回 ? InitializeBoundName("yield", value, environment)。
BindingIdentifier : await
  1. 返回 ? InitializeBoundName("await", value, environment)。
BindingPattern : ObjectBindingPattern
  1. 执行 ? RequireObjectCoercible(value)。
  2. 返回 ? BindingInitialization of ObjectBindingPattern with arguments valueenvironment
BindingPattern : ArrayBindingPattern
  1. iteratorRecord 为 ? GetIterator(value, sync)。
  2. resultCompletion(IteratorBindingInitialization of ArrayBindingPattern with arguments iteratorRecordenvironment)。
  3. 如果 iteratorRecord.[[Done]]false,返回 ? IteratorClose(iteratorRecord, result)。
  4. 返回 ? result
ObjectBindingPattern : { }
  1. 返回 unused
ObjectBindingPattern : { BindingPropertyList } { BindingPropertyList , }
  1. 执行 ? PropertyBindingInitialization of BindingPropertyList with arguments valueenvironment
  2. 返回 unused
ObjectBindingPattern : { BindingRestProperty }
  1. excludedNames 成为一个新的空列表
  2. 返回 ? RestBindingInitialization of BindingRestProperty with arguments value, environment, 和 excludedNames
ObjectBindingPattern : { BindingPropertyList , BindingRestProperty }
  1. excludedNames 成为 ? PropertyBindingInitialization of BindingPropertyList with arguments valueenvironment
  2. 返回 ? RestBindingInitialization of BindingRestProperty with arguments value, environment, 和 excludedNames

8.6.2.1 InitializeBoundName ( name, value, environment )

抽象操作 InitializeBoundName 接受参数 name(字符串),value(一个 ECMAScript 语言值),和 environment(一个 环境记录undefined)并返回一个 正常完成记录包含 unused 或者一个 异常完成。它在调用时执行以下步骤:

  1. 如果 environment 不是 undefined,那么
    1. 执行 ! environment.InitializeBinding(name, value)。
    2. 返回 unused
  2. 否则,
    1. lhs 等于 ? ResolveBinding(name)。
    2. 返回 ? PutValue(lhs, value)。

8.6.3 运行时语义:IteratorBindingInitialization

语法指引操作 IteratorBindingInitialization 接受参数 iteratorRecord(一个 迭代器记录)和 environment(一个 环境记录undefined)并返回一个 正常完成记录(包含 unused)或者一个 异常完成记录

environment 被传递为 undefined 时,表示应该使用 PutValue 操作来分配初始化值。这种情况出现在 非严格函数 的形式参数列表中。在这种情况下,形式参数绑定会被预初始化,以处理具有相同名称的多个参数的可能性。

它通过以下生成式逐段定义:

ArrayBindingPattern : [ ]
  1. 返回 unused
ArrayBindingPattern : [ Elision ]
  1. 返回 ? IteratorDestructuringAssignmentEvaluation of Elision with argument iteratorRecord
ArrayBindingPattern : [ Elisionopt BindingRestElement ]
  1. 如果 Elision 存在,那么
    1. 执行 ? IteratorDestructuringAssignmentEvaluation of Elision with argument iteratorRecord
  2. 返回 ? IteratorBindingInitialization of BindingRestElement with arguments iteratorRecordenvironment
ArrayBindingPattern : [ BindingElementList , Elision ]
  1. 执行 ? IteratorBindingInitialization of BindingElementList with arguments iteratorRecordenvironment
  2. 返回 ? IteratorDestructuringAssignmentEvaluation of Elision with argument iteratorRecord
ArrayBindingPattern : [ BindingElementList , Elisionopt BindingRestElement ]
  1. 执行 ? IteratorBindingInitialization of BindingElementList with arguments iteratorRecordenvironment
  2. 如果 Elision 存在,那么
    1. 执行 ? IteratorDestructuringAssignmentEvaluation of Elision with argument iteratorRecord
  3. 返回 ? IteratorBindingInitialization of BindingRestElement with arguments iteratorRecordenvironment
BindingElementList : BindingElementList , BindingElisionElement
  1. 执行 ? IteratorBindingInitialization of BindingElementList with arguments iteratorRecordenvironment
  2. 返回 ? IteratorBindingInitialization of BindingElisionElement with arguments iteratorRecordenvironment
BindingElisionElement : Elision BindingElement
  1. 执行 ? IteratorDestructuringAssignmentEvaluation of Elision with argument iteratorRecord
  2. 返回 ? IteratorBindingInitialization of BindingElement with arguments iteratorRecordenvironment
单名称绑定(SingleNameBinding) : 绑定标识符(BindingIdentifier) 初始化器(Initializer) opt
  1. bindingId 字符串值(StringValue) 绑定标识符(BindingIdentifier)
  2. lhs 为 ?  解析绑定(ResolveBinding) (bindingId, environment)。
  3. v未定义(undefined)
  4. 如果 iteratorRecord[[完成]]([[Done]])false,则:
    1. next 为 ?  迭代器步骤值(IteratorStepValue) (iteratorRecord)。
    2. 如果 next 不是 完成(done),则:
      1. v 设为 next
  5. 如果存在 初始化器(Initializer) v未定义(undefined),则:
    1. 如果 是否匿名函数定义(IsAnonymousFunctionDefinition) ( 初始化器(Initializer) ) 为 true,则:
      1. v 设为 ?  命名评估(NamedEvaluation) ( 初始化器(Initializer) ,参数为 bindingId)。
    2. 否则:
      1. defaultValue 为 ?  评估(Evaluation) ( 初始化器(Initializer) )。
      2. v 设为 ?  获取值(GetValue) (defaultValue)。
  6. 如果 environment未定义(undefined), 则返回 ?  放置值(PutValue) (lhsv)。
  7. 返回 ?  初始化引用绑定(InitializeReferencedBinding) (lhsv)。
绑定元素(BindingElement) : 绑定模式(BindingPattern) 初始化器(Initializer) opt
  1. v未定义(undefined)
  2. 如果 iteratorRecord[[完成]]([[Done]])false,则:
    1. next 为 ?  迭代器步骤值(IteratorStepValue) (iteratorRecord)。
    2. 如果 next 不是 完成(done),则:
      1. v 设为 next
  3. 如果存在 初始化器(Initializer) v未定义(undefined),则:
    1. defaultValue 为 ?  评估(Evaluation) ( 初始化器(Initializer) )。
    2. v 设为 ?  获取值(GetValue) (defaultValue)。
  4. 返回 ?  绑定初始化(BindingInitialization) 绑定模式(BindingPattern) ,参数为 venvironment
BindingRestElement : ... BindingIdentifier
  1. lhs 为 ?  ResolveBinding ( StringValue BindingIdentifier , environment)。
  2. A 为 !  ArrayCreate (0)。
  3. n 为 0。
  4. 重复,
    1. nextdone
    2. 如果 iteratorRecord[[Done]]false,则:
      1. next 设为 ?  IteratorStepValue (iteratorRecord)。
    3. 如果 nextdone,则:
      1. 如果 environmentundefined,则返回 ?  PutValue (lhs, A)。
      2. 返回 ?  InitializeReferencedBinding (lhs, A)。
    4. 执行 !  CreateDataPropertyOrThrow (A, !  ToString ( 𝔽 (n)), next)。
    5. n 设为 n + 1。
BindingRestElement : ... BindingPattern
  1. A 为 !  ArrayCreate (0)。
  2. n 为 0。
  3. 重复,
    1. nextdone
    2. 如果 iteratorRecord[[Done]]false,则:
      1. next 设为 ?  IteratorStepValue (iteratorRecord)。
    3. 如果 nextdone,则:
      1. 返回 ?  BindingInitialization of BindingPattern ,参数为 Aenvironment
    4. 执行 !  CreateDataPropertyOrThrow (A, !  ToString ( 𝔽 (n)), next)。
    5. n 设为 n + 1。
FormalParameters : [empty]
  1. 返回 unused
FormalParameters : FormalParameterList , FunctionRestParameter
  1. 执行 ?  IteratorBindingInitialization of FormalParameterList ,参数为 iteratorRecordenvironment
  2. 返回 ?  IteratorBindingInitialization of FunctionRestParameter ,参数为 iteratorRecordenvironment
FormalParameterList : FormalParameterList , FormalParameter
  1. 执行 ?  IteratorBindingInitialization of FormalParameterList ,参数为 iteratorRecordenvironment
  2. 返回 ?  IteratorBindingInitialization of FormalParameter ,参数为 iteratorRecordenvironment
ArrowParameters : BindingIdentifier
  1. vundefined
  2. 断言 iteratorRecord.[[Done]]false
  3. next 为 ?  IteratorStepValue (iteratorRecord)。
  4. 如果 next 不是 done,则
    1. v 设置为 next
  5. 返回 ?  BindingInitialization of BindingIdentifier ,参数为 venvironment
ArrowParameters : CoverParenthesizedExpressionAndArrowParameterList
  1. formalsArrowFormalParameters ,它被 CoverParenthesizedExpressionAndArrowParameterList 所覆盖。
  2. 返回 ?  IteratorBindingInitialization of formals,参数为 iteratorRecordenvironment
AsyncArrowBindingIdentifier : BindingIdentifier
  1. vundefined
  2. 断言 iteratorRecord.[[Done]]false
  3. next 为 ?  IteratorStepValue (iteratorRecord)。
  4. 如果 next 不是 done,则
    1. v 设置为 next
  5. 返回 ?  BindingInitialization of BindingIdentifier ,参数为 venvironment

8.6.4 静态语义: AssignmentTargetType

语法导向操作 AssignmentTargetType 不接受参数,返回 simpleinvalid。它在以下各个产生式上被分段定义:

IdentifierReference : Identifier
  1. 如果这个 IdentifierReference 包含在 严格模式代码 中,并且 IdentifierStringValue"eval""arguments",则返回 invalid
  2. 返回 simple
IdentifierReference : yield await CallExpression : CallExpression [ Expression ] CallExpression . IdentifierName CallExpression . PrivateIdentifier MemberExpression : MemberExpression [ Expression ] MemberExpression . IdentifierName SuperProperty MemberExpression . PrivateIdentifier
  1. 返回 simple
PrimaryExpression : CoverParenthesizedExpressionAndArrowParameterList
  1. expr 是由 ParenthesizedExpression包含 的部分。
  2. 返回 AssignmentTargetTypeexpr
PrimaryExpression : this Literal ArrayLiteral ObjectLiteral FunctionExpression ClassExpression GeneratorExpression AsyncFunctionExpression AsyncGeneratorExpression RegularExpressionLiteral TemplateLiteral CallExpression : CoverCallExpressionAndAsyncArrowHead SuperCall ImportCall CallExpression Arguments CallExpression TemplateLiteral NewExpression : new NewExpression MemberExpression : MemberExpression TemplateLiteral new MemberExpression Arguments NewTarget : new . target ImportMeta : import . meta LeftHandSideExpression : OptionalExpression UpdateExpression : LeftHandSideExpression ++ LeftHandSideExpression -- ++ UnaryExpression -- UnaryExpression UnaryExpression : delete UnaryExpression void UnaryExpression typeof UnaryExpression + UnaryExpression - UnaryExpression ~ UnaryExpression ! UnaryExpression AwaitExpression ExponentiationExpression : UpdateExpression ** ExponentiationExpression MultiplicativeExpression : MultiplicativeExpression MultiplicativeOperator ExponentiationExpression AdditiveExpression : AdditiveExpression + MultiplicativeExpression AdditiveExpression - MultiplicativeExpression ShiftExpression : ShiftExpression << AdditiveExpression ShiftExpression >> AdditiveExpression ShiftExpression >>> AdditiveExpression RelationalExpression : RelationalExpression < ShiftExpression RelationalExpression > ShiftExpression RelationalExpression <= ShiftExpression RelationalExpression >= ShiftExpression RelationalExpression instanceof ShiftExpression RelationalExpression in ShiftExpression PrivateIdentifier in ShiftExpression EqualityExpression : EqualityExpression == RelationalExpression EqualityExpression != RelationalExpression EqualityExpression === RelationalExpression EqualityExpression !== RelationalExpression BitwiseANDExpression : BitwiseANDExpression & EqualityExpression BitwiseXORExpression : BitwiseXORExpression ^ BitwiseANDExpression BitwiseORExpression : BitwiseORExpression | BitwiseXORExpression LogicalANDExpression : LogicalANDExpression && BitwiseORExpression LogicalORExpression : LogicalORExpression || LogicalANDExpression CoalesceExpression : CoalesceExpressionHead ?? BitwiseORExpression ConditionalExpression : ShortCircuitExpression ? AssignmentExpression : AssignmentExpression AssignmentExpression : YieldExpression ArrowFunction AsyncArrowFunction LeftHandSideExpression = AssignmentExpression LeftHandSideExpression AssignmentOperator AssignmentExpression LeftHandSideExpression &&= AssignmentExpression LeftHandSideExpression ||= AssignmentExpression LeftHandSideExpression ??= AssignmentExpression Expression : Expression , AssignmentExpression
  1. 返回 invalid

8.6.5 静态语义:PropName

语法导向操作 PropName 不接受任何参数,并返回一个字符串或 empty。它在以下生成式上逐步定义:

PropertyDefinition : IdentifierReference
  1. 返回 StringValueIdentifierReference
PropertyDefinition : ... AssignmentExpression
  1. 返回 empty.
PropertyDefinition : PropertyName : AssignmentExpression
  1. 返回 PropNamePropertyName
LiteralPropertyName : IdentifierName
  1. 返回 StringValueIdentifierName
LiteralPropertyName : StringLiteral
  1. 返回 SVStringLiteral
LiteralPropertyName : NumericLiteral
  1. nbrNumericValueNumericLiteral
  2. 返回 ! ToString(nbr)。
ComputedPropertyName : [ AssignmentExpression ]
  1. 返回 empty
MethodDefinition : ClassElementName ( UniqueFormalParameters ) { FunctionBody } get ClassElementName ( ) { FunctionBody } set ClassElementName ( PropertySetParameterList ) { FunctionBody }
  1. 返回 PropNameClassElementName
GeneratorMethod : * ClassElementName ( UniqueFormalParameters ) { GeneratorBody }
  1. 返回 PropNameClassElementName
AsyncGeneratorMethod : async * ClassElementName ( UniqueFormalParameters ) { AsyncGeneratorBody }
  1. 返回 PropNameClassElementName
ClassElement : ClassStaticBlock
  1. 返回 empty.
ClassElement : ;
  1. 返回 empty.
AsyncMethod : async ClassElementName ( UniqueFormalParameters ) { AsyncFunctionBody }
  1. 返回 PropNameClassElementName
FieldDefinition : ClassElementName Initializeropt
  1. 返回 PropNameClassElementName
ClassElementName : PrivateIdentifier
  1. 返回 empty

9 可执行代码和执行上下文

9.1 环境记录

环境记录是一种规范类型,用于根据 ECMAScript 代码的词法嵌套结构,定义标识符与特定变量和函数的关联。通常,环境记录与 ECMAScript 代码的某些特定语法结构相关联,如函数声明块语句捕获子句等。每次评估此类代码时,都会创建一个新的环境记录来记录该代码创建的标识符绑定。

每个环境记录都有一个[[OuterEnv]]字段,它要么是null,要么是对外部环境记录的引用。这用于模拟环境记录值的逻辑嵌套。内部环境记录的外部引用是对逻辑上包围内部环境记录的外部环境记录的引用。当然,外部环境记录可能有其自己的外部环境记录。一个环境记录可能作为多个内部环境记录的外部环境。例如,如果一个函数声明包含两个嵌套的函数声明,那么每个嵌套函数的环境记录的外部环境记录将是当前评估的包围函数的环境记录。

环境记录纯粹是规范机制,不需要对应于 ECMAScript 实现的任何具体产物。ECMAScript 程序不可能直接访问或操作这些值。

9.1.1 环境记录类型层次结构

环境记录 可以被认为存在于一个简单的面向对象层次结构中,其中 环境记录 是一个具有三个具体子类的抽象类:声明式环境记录对象环境记录全局环境记录函数环境记录模块环境记录声明式环境记录 的子类。

环境记录抽象类包括表16中定义的抽象规范方法。这些抽象方法对每个具体子类都有不同的具体算法。

表16: 环境记录的抽象方法
方法 用途
HasBinding(N) 确定环境记录是否有字符串值N的绑定。如果有,返回true,否则返回false
CreateMutableBinding(N, D) 环境记录中创建一个新的但未初始化的可变绑定。字符串值N是绑定名的文本。如果布尔参数Dtrue,则绑定可能会被随后删除。
CreateImmutableBinding(N, S) 环境记录中创建一个新的但未初始化的不可变绑定。字符串值N是绑定名的文本。如果Strue,则在初始化后尝试设置它总是会抛出异常,无论引用该绑定的操作的严格模式设置如何。
InitializeBinding(N, V) 设置环境记录中已存在但未初始化的绑定的值。字符串值N是绑定名的文本。V是绑定的值,可以是任何ECMAScript 语言类型的值。
SetMutableBinding(N, V, S) 设置环境记录中已存在的可变绑定的值。字符串值N是绑定名的文本。V是绑定的值,可以是任何ECMAScript 语言类型的值。S是一个布尔标志。如果Strue并且绑定不能设置,则抛出TypeError异常。
GetBindingValue(N, S) 返回环境记录中已存在绑定的值。字符串值N是绑定名的文本。S用于标识源自严格模式代码或其他需要严格模式引用语义的引用。如果Strue且绑定不存在,则抛出ReferenceError异常。如果绑定存在但未初始化,则无论S的值如何,都会抛出ReferenceError
DeleteBinding(N) 环境记录中删除一个绑定。字符串值N是绑定名的文本。如果存在N的绑定,则移除绑定并返回true。如果绑定存在但无法移除,则返回false。如果绑定不存在,则返回true
HasThisBinding() 确定环境记录是否建立了this绑定。如果建立了,返回true,否则返回false
HasSuperBinding() 确定环境记录是否建立了super方法绑定。如果建立了,返回true,否则返回false
WithBaseObject() 如果此环境记录with语句关联,则返回 with 对象。否则,返回undefined

9.1.1.1 声明式环境记录

每个声明式环境记录都与包含变量、常量、let、class、模块、import和/或函数声明的 ECMAScript 程序范围相关联。声明式环境记录绑定其范围内包含的声明所定义的一组标识符。

声明式环境记录的具体规范方法的行为由以下算法定义。

9.1.1.1.1 HasBinding ( N )

声明式环境记录 envRec的 HasBinding 具体方法接受参数N(一个字符串)并返回一个包含布尔值的正常完成记录。它确定参数标识符是否是记录绑定的标识符之一。调用时执行以下步骤:

  1. 如果envRecN的绑定,则返回true
  2. 返回false

9.1.1.1.2 CreateMutableBinding ( N, D )

声明式环境记录 envRec的 CreateMutableBinding 具体方法接受参数N(一个字符串)和D(一个布尔值),并返回一个包含 unused的正常完成记录。它为名称N创建一个新的未初始化的可变绑定。环境记录中不应已有N的绑定。如果Dtrue,则新绑定被标记为可以删除。调用时执行以下步骤:

  1. 断言envRec中不存在N的绑定。
  2. envRec中为N创建一个可变绑定,并记录它未初始化。如果Dtrue,则记录新创建的绑定可以通过后续的 DeleteBinding 调用删除。
  3. 返回unused

9.1.1.1.3 CreateImmutableBinding ( N, S )

声明式环境记录 envRec的 CreateImmutableBinding 具体方法接受参数N(一个字符串)和S(一个布尔值),并返回一个包含 unused的正常完成记录。它为名称N创建一个新的未初始化的不可变绑定。环境记录中不应已有N的绑定。如果Strue,则新绑定被标记为严格绑定。调用时执行以下步骤:

  1. 断言envRec中不存在N的绑定。
  2. envRec中为N创建一个不可变绑定,并记录它未初始化。如果Strue,则记录新创建的绑定是严格绑定。
  3. 返回unused

9.1.1.1.4 InitializeBinding ( N, V )

声明式环境记录 envRec的 InitializeBinding 具体方法接受参数N(一个字符串)和V(一个ECMAScript 语言值),并返回一个包含 unused的正常完成记录。它用于将名称为N的标识符的当前绑定值设置为V。必须已存在N的未初始化绑定。调用时执行以下步骤:

  1. 断言envRec中必须有N的未初始化绑定。
  2. envRecN的绑定值设置为V
  3. 记录envRecN的绑定已被初始化。
  4. 返回unused

9.1.1.1.5 SetMutableBinding ( N, V, S )

声明式环境记录 envRec的 SetMutableBinding 具体方法接受参数N(一个字符串)、V(一个ECMAScript 语言值)和S(一个布尔值),并返回一个包含 unused的正常完成记录或一个抛出完成记录。它尝试将名称为N的标识符的当前绑定值更改为V。通常情况下,已经存在N的绑定,但在极少数情况下可能不存在。如果绑定是不可变绑定,则如果Strue,会抛出TypeError。调用时执行以下步骤:

  1. 如果envRec中没有N的绑定,则
    1. 如果Strue,抛出ReferenceError异常。
    2. 执行 ! envRec.CreateMutableBinding(N, true)。
    3. 执行 ! envRec.InitializeBinding(N, V)。
    4. 返回unused
  2. 如果envRecN的绑定是严格绑定,则将S设置为true
  3. 如果envRecN的绑定尚未初始化,则
    1. 抛出ReferenceError异常。
  4. 否则,如果envRecN的绑定是可变绑定,则
    1. 将其绑定值更改为V
  5. 否则,
    1. 断言:这是尝试更改不可变绑定的值。
    2. 如果Strue,抛出TypeError异常。
  6. 返回unused

在步骤1中缺少绑定的 ECMAScript 代码示例是:

function f() { eval("var x; x = (delete x, 0);"); }

9.1.1.1.6 GetBindingValue ( N, S )

声明式环境记录 envRec的 GetBindingValue 具体方法接受参数N(一个字符串)和S(一个布尔值),并返回一个包含一个ECMAScript 语言值的正常完成记录或一个抛出完成记录。它返回其绑定标识符的值,其名称为N。如果绑定存在但未初始化,则抛出ReferenceError,无论S的值如何。调用时执行以下步骤:

  1. 断言envRecN的绑定。
  2. 如果envRecN的绑定是未初始化绑定,则抛出ReferenceError异常。
  3. 返回当前绑定到envRecN的值。

9.1.1.1.7 DeleteBinding ( N )

声明式环境记录 envRec的 DeleteBinding 具体方法接受参数N(一个字符串),并返回一个包含布尔值的正常完成记录。它只能删除已明确指定为可删除的绑定。调用时执行以下步骤:

  1. 断言envRecN的绑定。
  2. 如果envRecN的绑定不能被删除,则返回false
  3. envRec中移除N的绑定。
  4. 返回true

9.1.1.1.8 HasThisBinding ( )

声明式环境记录 envRec的 HasThisBinding 具体方法不接受任何参数并返回false。调用时执行以下步骤:

  1. 返回false

常规声明式环境记录(即,不是函数环境记录模块环境记录)不提供this绑定。

9.1.1.1.9 HasSuperBinding ( )

声明式环境记录 envRec的 HasSuperBinding 具体方法不接受任何参数并返回false。调用时执行以下步骤:

  1. 返回false

常规声明式环境记录(即,不是函数环境记录模块环境记录)不提供super绑定。

9.1.1.1.10 WithBaseObject ( )

声明式环境记录 envRec的 WithBaseObject 具体方法不接受任何参数并返回undefined。调用时执行以下步骤:

  1. 返回undefined

9.1.1.2 对象环境记录

每个对象环境记录都与一个称为绑定对象的对象相关联。对象环境记录绑定一组字符串标识符名称,这些名称直接对应于其绑定对象的属性名称。属性键不是标识符名称形式的字符串不包括在绑定标识符的集合中。无论其[[Enumerable]]属性的设置如何,自己的和继承的属性都包括在集合中。由于可以动态添加和删除属性,对象环境记录绑定的标识符集可能会因添加或删除属性的任何操作而改变。作为此类副作用创建的任何绑定都被视为可变绑定,即使相应属性的[[Writable]]属性为false。不可变绑定不存在于对象环境记录中。

with语句创建的对象环境记录(14.11)可以将其绑定对象作为隐式this值用于函数调用。此功能由布尔值[[IsWithEnvironment]]字段控制。

对象环境记录具有表17中列出的附加状态字段。

表17: 对象环境记录的附加字段
字段名称 含义
[[BindingObject]] 一个对象 环境记录的绑定对象。
[[IsWithEnvironment]] 一个布尔值 指示此环境记录是否为with语句创建。

对象环境记录的具体规范方法的行为由以下算法定义。

9.1.1.2.1 HasBinding ( N )

对象环境记录 envRec的 HasBinding 具体方法接受参数N(一个字符串),并返回一个包含布尔值的正常完成记录或一个抛出完成记录。它确定其关联的绑定对象是否具有名称为N的属性。调用时执行以下步骤:

  1. bindingObject成为envRec[[BindingObject]]
  2. foundBinding为? HasProperty(bindingObject, N)。
  3. 如果foundBindingfalse,返回false
  4. 如果envRec[[IsWithEnvironment]]false,返回true
  5. unscopables为? Get(bindingObject, @@unscopables)。
  6. 如果unscopables是一个对象,则
    1. blockedToBoolean(? Get(unscopables, N))。
    2. 如果blockedtrue,返回false
  7. 返回true

9.1.1.2.2 CreateMutableBinding ( N, D )

对象环境记录 envRec的 CreateMutableBinding 具体方法接受参数N(一个字符串)和D(一个布尔值),并返回一个包含 unused的正常完成记录或一个抛出完成记录。它在环境记录的关联绑定对象中创建一个名为N的属性,并将其初始化为undefined。如果Dtrue,新属性的[[Configurable]]属性设置为true;否则设置为false。调用时执行以下步骤:

  1. bindingObject成为envRec[[BindingObject]]
  2. 执行? DefinePropertyOrThrow(bindingObject, N, PropertyDescriptor { [[Value]]: undefined, [[Writable]]: true, [[Enumerable]]: true, [[Configurable]]: D })。
  3. 返回unused

通常情况下,envRec不会有N的绑定,但如果有,DefinePropertyOrThrow的语义可能会导致替换或遮蔽现有绑定,或返回突然完成

9.1.1.2.3 CreateImmutableBinding ( N, S )

对象环境记录中从未使用过此规范。

9.1.1.2.4 InitializeBinding ( N, V )

对象环境记录 envRec的 InitializeBinding 具体方法接受参数N(一个字符串)和V(一个ECMAScript 语言值),并返回一个包含 unused的正常完成记录或一个抛出完成记录。它用于将名称为N的标识符的当前绑定值设置为V。调用时执行以下步骤:

  1. 执行? envRec.SetMutableBinding(N, V, false)。
  2. 返回unused

在此规范中,所有对对象环境记录的 CreateMutableBinding 的使用都紧随其后调用 InitializeBinding 用于相同的名称。因此,此规范未明确跟踪对象环境记录中的绑定初始化状态。

9.1.1.2.5 SetMutableBinding ( N, V, S )

对象环境记录 envRec的 SetMutableBinding 具体方法接受参数N(一个字符串)、V(一个ECMAScript 语言值)和S(一个布尔值),并返回一个包含 unused的正常完成记录或一个抛出完成记录。它尝试将环境记录的关联绑定对象的名称为N的属性的值设置为V。通常情况下,该属性已经存在,但如果不存在或当前不可写,则错误处理由S决定。调用时执行以下步骤:

  1. bindingObject成为envRec[[BindingObject]]
  2. stillExists为? HasProperty(bindingObject, N)。
  3. 如果stillExistsfalseStrue,抛出ReferenceError异常。
  4. 执行? Set(bindingObject, N, V, S)。
  5. 返回unused

9.1.1.2.6 GetBindingValue ( N, S )

对象环境记录 envRec的 GetBindingValue 具体方法接受参数N(一个字符串)和S(一个布尔值),并返回一个包含一个ECMAScript 语言值的正常完成记录或一个抛出完成记录。它返回其关联绑定对象的名称为N的属性的值。该属性应该已经存在,但如果不存在,则结果取决于S。调用时执行以下步骤:

  1. bindingObject成为envRec[[BindingObject]]
  2. value为? HasProperty(bindingObject, N)。
  3. 如果valuefalse,则
    1. 如果Sfalse,返回undefined;否则抛出ReferenceError异常。
  4. 返回? Get(bindingObject, N)。

9.1.1.2.7 DeleteBinding ( N )

对象环境记录 envRec的 DeleteBinding 具体方法接受参数N(一个字符串),并返回一个包含布尔值的正常完成记录或一个抛出完成记录。它只能删除[[Configurable]]属性为true的环境对象的属性。调用时执行以下步骤:

  1. bindingObject成为envRec[[BindingObject]]
  2. 返回? bindingObject.[[Delete]](N)。

9.1.1.2.8 HasThisBinding ( )

对象环境记录 envRec的 HasThisBinding 具体方法不接受任何参数并返回false。调用时执行以下步骤:

  1. 返回false

对象环境记录不提供this绑定。

9.1.1.2.9 HasSuperBinding ( )

对象环境记录 envRec的 HasSuperBinding 具体方法不接受任何参数并返回false。调用时执行以下步骤:

  1. 返回false

对象环境记录不提供super绑定。

9.1.1.2.10 WithBaseObject ( )

对象环境记录 envRec的 WithBaseObject 具体方法不接受任何参数,并返回一个对象或undefined。调用时执行以下步骤:

  1. 如果envRec[[IsWithEnvironment]]true,返回envRec[[BindingObject]]
  2. 否则,返回undefined

9.1.1.3 函数环境记录

函数环境记录 是一种 声明性环境记录, 用于表示函数的顶级作用域,并且如果函数不是一个箭头函数,则提供一个 this绑定。如果函数不是一个箭头函数函数并引用 super,则其函数环境记录还包含用于在函数内部执行super方法调用的状态。

函数环境记录具有表18中列出的附加状态字段。

表18: 函数环境记录的附加字段
字段名称 含义
[[ThisValue]] 一个ECMAScript语言值 这是该函数调用中使用的this值。
[[ThisBindingStatus]] lexical, initializeduninitialized 如果值是lexical,则这是一个箭头函数,并且没有本地的this值。
[[FunctionObject]] 一个ECMAScript 函数对象 导致创建此环境记录函数对象
[[NewTarget]] 一个对象或undefined 如果此环境记录是由[[Construct]]内部方法创建的, 则[[NewTarget]][[Construct]]newTarget参数的值。 否则,其值为undefined

函数环境记录支持声明性环境记录中列出的所有方法, 并且除了HasThisBinding和HasSuperBinding方法之外,其它所有方法的规范相同。 此外,函数环境记录还支持表19中列出的方法:

表19: 函数环境记录的附加方法
方法 目的
BindThisValue(V) 设置[[ThisValue]]并记录它已被初始化。
GetThisBinding() 返回此环境记录this绑定的值。 如果this绑定尚未初始化,则抛出ReferenceError异常。
GetSuperBase() 返回在此环境记录中绑定的super属性访问的基础对象。 值undefined表示这些访问将产生运行时错误。

函数环境记录附加具体方法的行为由以下算法定义:

9.1.1.3.1 BindThisValue ( V )

函数环境记录BindThisValue具体方法接受参数V(一个ECMAScript语言值)并返回一个包含ECMAScript语言值的正常完成记录或一个抛出完成记录。 调用时执行以下步骤:

  1. 断言: envRec.[[ThisBindingStatus]]不是lexical
  2. 如果envRec.[[ThisBindingStatus]]initialized,抛出ReferenceError异常。
  3. envRec.[[ThisValue]]设置为V
  4. envRec.[[ThisBindingStatus]]设置为initialized
  5. 返回V

9.1.1.3.2 HasThisBinding ( )

函数环境记录HasThisBinding具体方法不接受任何参数并返回一个布尔值。 调用时执行以下步骤:

  1. 如果envRec.[[ThisBindingStatus]]lexical,返回false; 否则,返回true

9.1.1.3.3 HasSuperBinding ( )

函数环境记录HasSuperBinding具体方法不接受任何参数并返回一个布尔值。 调用时执行以下步骤:

  1. 如果envRec.[[ThisBindingStatus]]lexical,返回false
  2. 如果envRec.[[FunctionObject]].[[HomeObject]]undefined,返回false; 否则,返回true

9.1.1.3.4 GetThisBinding ( )

函数环境记录GetThisBinding具体方法不接受任何参数并返回一个包含ECMAScript语言值的正常完成记录或一个抛出完成记录。 调用时执行以下步骤:

  1. 断言: envRec.[[ThisBindingStatus]]不是lexical
  2. 如果envRec.[[ThisBindingStatus]]uninitialized,抛出ReferenceError异常。
  3. 返回envRec.[[ThisValue]]

9.1.1.3.5 GetSuperBase ( )

函数环境记录GetSuperBase具体方法不接受任何参数并返回一个包含一个对象、nullundefined的正常完成记录或一个抛出完成记录。 调用时执行以下步骤:

  1. home成为envRec.[[FunctionObject]].[[HomeObject]]
  2. 如果homeundefined,返回undefined
  3. 断言: home 是一个对象
  4. 返回? home.[[GetPrototypeOf]]()。

9.1.1.4 全局环境记录

全局环境记录用于表示所有在同一个领域中处理的ECMAScript 脚本元素共享的最外层作用域。全局环境记录提供内置全局变量的绑定(第19章)、全局对象的属性绑定, 以及所有在脚本中出现的顶级声明的绑定(8.2.98.2.11)。

全局环境记录在逻辑上是一个单一的记录,但它被指定为一个复合体,封装了一个对象环境记录和一个声明性环境记录对象环境记录的基础对象是相关领域记录全局对象。这个全局对象是全局环境记录的GetThisBinding具体方法返回的值。全局环境记录的对象环境记录组件包含所有内置全局变量(第19章)的绑定以及全局代码中包含的函数声明生成器声明异步函数声明异步生成器声明变量声明。全局代码中所有其他ECMAScript声明的绑定都包含在全局环境记录的声明性环境记录组件中。

属性可以直接在全局对象上创建。 因此,全局环境记录的对象环境记录组件可能同时包含由函数声明生成器声明异步函数声明异步生成器声明变量声明显式创建的绑定以及作为全局对象属性隐式创建的绑定。 为了确定哪些绑定是通过声明显式创建的,全局环境记录维护一个使用其CreateGlobalVarBinding和CreateGlobalFunctionBinding具体方法绑定的名称列表。

全局环境记录具有表20中列出的附加字段和表21中列出的附加方法。

表20: 全局环境记录的附加字段
字段名称 含义
[[ObjectRecord]] 一个对象环境记录 绑定对象是全局对象。它包含全局内置绑定以及全局代码中的函数声明生成器声明异步函数声明异步生成器声明、 和变量声明绑定,针对相关的领域
[[GlobalThisValue]] 一个对象 全局作用域中this返回的值。宿主可以提供任何ECMAScript对象值。
[[DeclarativeRecord]] 一个声明性环境记录 包含所有在相关领域代码中的全局代码声明的绑定,除了函数声明生成器声明异步函数声明异步生成器声明、 和变量声明绑定。
[[VarNames]] 一个字符串列表 在相关领域代码的全局代码中,函数声明生成器声明异步函数声明异步生成器声明、 和变量声明的绑定名称。
表21: 全局环境记录的附加方法
方法 目的
GetThisBinding() 返回此环境记录this绑定的值。
HasVarDeclaration (N) 确定参数标识符是否在此环境记录中具有通过变量声明函数声明生成器声明异步函数声明、 或异步生成器声明创建的绑定。
HasLexicalDeclaration (N) 确定参数标识符是否在此环境记录中具有通过词法声明(如词法声明类声明)创建的绑定。
HasRestrictedGlobalProperty (N) 确定参数是否为全局对象属性的名称,该属性不得被全局词法绑定遮蔽。
CanDeclareGlobalVar (N) 确定是否可以成功调用相应的CreateGlobalVarBinding方法,并为相同的参数N声明全局变量。
CanDeclareGlobalFunction (N) 确定是否可以成功调用相应的CreateGlobalFunctionBinding方法,并为相同的参数N声明全局函数。
CreateGlobalVarBinding(N, D) 用于在[[ObjectRecord]]组件中创建并初始化一个全局var绑定, 该绑定的初始值为undefined。绑定将是可变绑定。 相应的全局对象属性将具有适合var的属性值。 字符串值N是绑定的名称。如果Dtrue,则绑定可以被删除。 在逻辑上等同于CreateMutableBinding后跟SetMutableBinding,但它允许对var声明进行特殊处理。
CreateGlobalFunctionBinding(N, V, D) [[ObjectRecord]]组件中创建并初始化一个全局function绑定。 绑定将是可变绑定。相应的全局对象属性将具有适合function的属性值。 字符串值N是绑定的名称。V是初始化值。 如果布尔参数Dtrue,则绑定可以被删除。 在逻辑上等同于CreateMutableBinding后跟SetMutableBinding,但它允许对函数声明进行特殊处理。

具体规范方法的行为定义如下算法。

9.1.1.4.1 HasBinding ( N )

全局环境记录envRec的HasBinding具体方法接受参数N(字符串),返回一个正常完成记录,包含一个布尔值或一个抛出完成记录。它确定参数标识符是否被记录绑定。调用时执行以下步骤:

  1. DclRecenvRec[[DeclarativeRecord]]
  2. 如果! DclRec.HasBinding(N)为true,返回true
  3. ObjRecenvRec[[ObjectRecord]]
  4. 返回? ObjRec.HasBinding(N)。

9.1.1.4.2 CreateMutableBinding ( N, D )

全局环境记录envRec的CreateMutableBinding具体方法接受参数N(字符串)和D(布尔值),返回一个正常完成记录,包含未使用或一个抛出完成记录。它创建一个新的未初始化的可变绑定,绑定在相关的声明记录中。声明记录中不能已经存在N的绑定。如果Dtrue,新的绑定标记为可删除。调用时执行以下步骤:

  1. DclRecenvRec[[DeclarativeRecord]]
  2. 如果! DclRec.HasBinding(N)为true,抛出类型错误异常。
  3. 返回 ! DclRec.CreateMutableBinding(N, D)。

9.1.1.4.3 CreateImmutableBinding ( N, S )

全局环境记录envRec的CreateImmutableBinding具体方法接受参数N(字符串)和S(布尔值),返回一个正常完成记录,包含未使用或一个抛出完成记录。它创建一个新的未初始化的不可变绑定。该环境记录中不能已经存在N的绑定。如果Strue,新的绑定标记为严格绑定。调用时执行以下步骤:

  1. DclRecenvRec[[DeclarativeRecord]]
  2. 如果! DclRec.HasBinding(N)为true,抛出类型错误异常。
  3. 返回 ! DclRec.CreateImmutableBinding(N, S)。

9.1.1.4.4 InitializeBinding ( N, V )

全局环境记录envRec的InitializeBinding具体方法接受参数N(字符串)和VECMAScript语言值),返回一个正常完成记录,包含未使用或一个抛出完成记录。它用于将标识符的当前绑定的值设置为V。必须已经存在一个未初始化的N绑定。调用时执行以下步骤:

  1. DclRecenvRec[[DeclarativeRecord]]
  2. 如果! DclRec.HasBinding(N)为true,则
    1. 返回 ! DclRec.InitializeBinding(N, V)。
  3. 断言:如果绑定存在,它必须在对象环境记录中。
  4. ObjRecenvRec[[ObjectRecord]]
  5. 返回? ObjRec.InitializeBinding(N, V)。

9.1.1.4.5 SetMutableBinding ( N, V, S )

全局环境记录envRec的SetMutableBinding具体方法接受参数N(字符串)、VECMAScript语言值)和S(布尔值),返回一个正常完成记录,包含未使用或一个抛出完成记录。它尝试将标识符的当前绑定的值更改为V。如果绑定是不可变的,并且Strue,则抛出类型错误。通常已经存在名为N的属性,但如果不存在或当前不可写,错误处理由S决定。调用时执行以下步骤:

  1. DclRecenvRec[[DeclarativeRecord]]
  2. 如果! DclRec.HasBinding(N)为true,则
    1. 返回 ? DclRec.SetMutableBinding(N, V, S)。
  3. ObjRecenvRec[[ObjectRecord]]
  4. 返回? ObjRec.SetMutableBinding(N, V, S)。

9.1.1.4.6 GetBindingValue ( N, S )

全局环境记录envRec的GetBindingValue具体方法接受参数N(字符串)和S(布尔值),返回一个正常完成记录,包含一个ECMAScript语言值或一个抛出完成记录。它返回标识符N的绑定值。如果绑定是未初始化的,则抛出引用错误异常。通常已经存在名为N的属性,但如果不存在或当前不可写,错误处理由S决定。调用时执行以下步骤:

  1. DclRecenvRec[[DeclarativeRecord]]
  2. 如果! DclRec.HasBinding(N)为true,则
    1. 返回 ? DclRec.GetBindingValue(N, S)。
  3. ObjRecenvRec[[ObjectRecord]]
  4. 返回? ObjRec.GetBindingValue(N, S)。

9.1.1.4.7 DeleteBinding ( N )

全局环境记录envRec的DeleteBinding具体方法接受参数N(字符串),返回一个正常完成记录,包含一个布尔值或一个抛出完成记录。它只能删除已明确指定为可删除的绑定。调用时执行以下步骤:

  1. DclRecenvRec[[DeclarativeRecord]]
  2. 如果! DclRec.HasBinding(N)为true,则
    1. 返回 ! DclRec.DeleteBinding(N)。
  3. ObjRecenvRec[[ObjectRecord]]
  4. globalObjectObjRec[[BindingObject]]
  5. existingProp为? HasOwnProperty(globalObject, N)。
  6. 如果existingProptrue,则
    1. status为? ObjRec.DeleteBinding(N)。
    2. 如果statustrue,并且envRec[[VarNames]]包含N,则
      1. envRec[[VarNames]]中删除N
    3. 返回status
  7. 返回true

9.1.1.4.8 HasThisBinding ( )

全局环境记录envRec的HasThisBinding具体方法不接受参数,返回true。调用时执行以下步骤:

  1. 返回true

全局环境记录总是提供this绑定。

9.1.1.4.9 HasSuperBinding ( )

全局环境记录envRec的HasSuperBinding具体方法不接受参数,返回false。调用时执行以下步骤:

  1. 返回false

全局环境记录不提供super绑定。

9.1.1.4.10 WithBaseObject ( )

全局环境记录envRec的WithBaseObject具体方法不接受参数,返回undefined。调用时执行以下步骤:

  1. 返回undefined

9.1.1.4.11 GetThisBinding ( )

全局环境记录envRec的GetThisBinding具体方法不接受参数,返回一个正常完成记录,包含一个对象。调用时执行以下步骤:

  1. 返回envRec[[GlobalThisValue]]

9.1.1.4.12 HasVarDeclaration ( N )

全局环境记录envRec的HasVarDeclaration具体方法接受参数N(字符串),返回一个布尔值。它确定参数标识符是否在此记录中具有通过变量语句函数声明创建的绑定。调用时执行以下步骤:

  1. varDeclaredNamesenvRec[[VarNames]]
  2. 如果varDeclaredNames包含N,返回 true
  3. 返回false

9.1.1.4.13 HasLexicalDeclaration ( N )

全局环境记录envRec的HasLexicalDeclaration具体方法接受参数N(字符串),返回一个布尔值。它确定参数标识符是否在此记录中具有通过词法声明(如词法声明类声明)创建的绑定。调用时执行以下步骤:

  1. DclRecenvRec[[DeclarativeRecord]]
  2. 返回! DclRec.HasBinding(N)。

9.1.1.4.14 HasRestrictedGlobalProperty ( N )

全局环境记录envRec的HasRestrictedGlobalProperty具体方法接受参数N(字符串),返回一个正常完成记录,包含一个布尔值或一个抛出完成记录。它确定参数标识符是否为全局对象属性的名称,该属性不得被全局词法绑定遮蔽。调用时执行以下步骤:

  1. ObjRecenvRec[[ObjectRecord]]
  2. globalObjectObjRec[[BindingObject]]
  3. existingProp为? globalObject.[[GetOwnProperty]](N)。
  4. 如果existingProp未定义, 返回false
  5. 如果existingProp[[Configurable]]true,返回false
  6. 返回true

全局对象上可能存在直接创建的属性,而不是通过var或函数声明创建的。 不得创建具有与全局对象的不可配置属性相同名称的全局词法绑定。全局属性"undefined"就是一个例子。

9.1.1.4.15 CanDeclareGlobalVar ( N )

全局环境记录envRec的CanDeclareGlobalVar具体方法接受参数N(字符串),返回一个正常完成记录,包含一个布尔值或一个抛出完成记录。它确定是否可以成功调用相应的CreateGlobalVarBinding方法,并为相同的参数N声明全局变量。允许冗余的var声明和已存在的全局对象属性的var声明。调用时执行以下步骤:

  1. ObjRecenvRec[[ObjectRecord]]
  2. globalObjectObjRec[[BindingObject]]
  3. hasProperty为? HasOwnProperty(globalObject, N)。
  4. 如果hasPropertytrue,返回 true
  5. 返回? IsExtensible(globalObject)。

9.1.1.4.16 CanDeclareGlobalFunction ( N )

全局环境记录envRec的CanDeclareGlobalFunction具体方法接受参数N(字符串),返回一个正常完成记录,包含一个布尔值或一个抛出完成记录。它确定是否可以成功调用相应的CreateGlobalFunctionBinding方法,并为相同的参数N声明全局函数。调用时执行以下步骤:

  1. ObjRecenvRec[[ObjectRecord]]
  2. globalObjectObjRec[[BindingObject]]
  3. existingProp为? globalObject.[[GetOwnProperty]](N)。
  4. 如果existingProp未定义, 返回? IsExtensible(globalObject)。
  5. 如果existingProp[[Configurable]]true,返回true
  6. 如果IsDataDescriptor(existingProp) 为true,且existingProp具有属性值{ [[Writable]]: true, [[Enumerable]]: true },返回true
  7. 返回false

9.1.1.4.17 CreateGlobalVarBinding ( N, D )

全局环境记录envRec的CreateGlobalVarBinding具体方法接受参数N(字符串)和D(布尔值),返回一个正常完成记录,包含未使用或一个抛出完成记录。它在相关的对象环境记录中创建并初始化一个可变绑定,并在相关的[[VarNames]]中记录绑定名称列表。如果绑定已经存在,它将被重用并假定为已初始化。调用时执行以下步骤:

  1. ObjRecenvRec[[ObjectRecord]]
  2. globalObjectObjRec[[BindingObject]]
  3. hasProperty为? HasOwnProperty(globalObject, N)。
  4. extensible为? IsExtensible(globalObject)。
  5. 如果hasPropertyfalse并且extensibletrue,则
    1. 执行? ObjRec.CreateMutableBinding(N, D)。
    2. 执行? ObjRec.InitializeBinding(N, 未定义)。
  6. 如果envRec[[VarNames]] 不包含N,则
    1. N追加到envRec[[VarNames]]中。
  7. 返回未使用

9.1.1.4.18 CreateGlobalFunctionBinding ( N, V, D )

全局环境记录envRec的CreateGlobalFunctionBinding具体方法接受参数N(字符串)、VECMAScript语言值)和D(布尔值),返回一个正常完成记录,包含未使用或一个抛出完成记录。它在相关的对象环境记录中创建并初始化一个可变绑定,并在相关的[[VarNames]]中记录绑定名称列表。如果绑定已经存在,它将被替换。调用时执行以下步骤:

  1. ObjRecenvRec[[ObjectRecord]]
  2. globalObjectObjRec[[BindingObject]]
  3. existingProp为? globalObject.[[GetOwnProperty]](N)。
  4. 如果existingProp未定义existingProp[[Configurable]]true,则
    1. desc为属性描述符{ [[Value]]: V, [[Writable]]: true, [[Enumerable]]: true, [[Configurable]]: D }.
  5. 否则,
    1. desc为属性描述符{ [[Value]]: V }。
  6. 执行? DefinePropertyOrThrow(globalObject, N, desc)。
  7. 执行 ? Set(globalObject, N, V, false)。
  8. 如果envRec[[VarNames]] 不包含N,则
    1. N追加到envRec[[VarNames]]中。
  9. 返回未使用

全局函数声明始终表示为全局对象的自有属性。 如果可能,将重新配置现有的自有属性以具有一组标准的属性值。 第7步等效于调用InitializeBinding具体方法,如果globalObject是代理,则会产生相同的代理陷阱调用顺序。

9.1.1.5 模块环境记录

模块环境记录 是一种 声明环境记录,用于表示 ECMAScript 模块 的外部作用域。除了常规的可变和不可变绑定外,模块环境记录还提供了不可变的导入绑定,这些绑定提供了对存在于另一个 环境记录 中目标绑定的间接访问。

模块环境记录支持所有在 声明环境记录中列出的 表 16 的方法,并共享这些方法的相同规范,除了 GetBindingValue、DeleteBinding、HasThisBinding 和 GetThisBinding 外。此外,模块环境记录还支持在 表 22 中列出的方法:

表 22: 模块环境记录的附加方法
方法 目的
CreateImportBinding(N, M, N2) 在一个模块环境记录中创建一个不可变的间接绑定。字符串值 N 是绑定名称的文本。M 是一个 模块记录N2 是存在于 M模块环境记录 中的一个绑定。
GetThisBinding() 返回该环境记录的 this 绑定的值。

模块环境记录的附加具体规范方法的行为由以下算法定义:

9.1.1.5.1 GetBindingValue ( N, S )

模块环境记录的 GetBindingValue 具体方法 envRec 接受参数 N(字符串)和 S(布尔值),返回一个包含 ECMAScript 语言值的正常完成记录或抛出完成记录。它返回其绑定标识符 N 的值。但是,如果绑定是间接绑定,则返回目标绑定的值。如果绑定存在但未初始化,则抛出 ReferenceError。调用时执行以下步骤:

  1. 断言: Strue
  2. 断言: envRec 有一个绑定 N
  3. 如果 N 的绑定是间接绑定,那么:
    1. MN2 为创建该 N 绑定时提供的间接值。
    2. targetEnvM[[Environment]]
    3. 如果 targetEnvempty,则抛出 ReferenceError
    4. 返回 ? targetEnv.GetBindingValue(N2, true)。
  4. 如果 envRecN 的绑定是未初始化的绑定,则抛出 ReferenceError
  5. 返回当前绑定在 envRec 中的 N 的值。

S 将始终为 true,因为模块始终是严格模式代码。

9.1.1.5.2 DeleteBinding ( N )

模块环境记录的 DeleteBinding 具体方法在本规范中从未使用。

模块环境记录仅在严格代码中使用,并且在严格代码中,早期错误规则防止 delete 操作符应用于将解析为模块环境记录绑定的引用记录。详见13.5.1.1

9.1.1.5.3 HasThisBinding ( )

模块环境记录的 HasThisBinding 具体方法 envRec 不接受任何参数并返回 true。调用时执行以下步骤:

  1. 返回 true

模块环境记录始终提供 this 绑定。

9.1.1.5.4 GetThisBinding ( )

模块环境记录的 GetThisBinding 具体方法 envRec 不接受任何参数并返回 undefined。调用时执行以下步骤:

  1. 返回 undefined

9.1.1.5.5 CreateImportBinding ( N, M, N2 )

模块环境记录的 CreateImportBinding 具体方法 envRec 接受参数 N(字符串)、M模块记录)和 N2(字符串),并返回 未使用。它为名称 N 创建一个新的初始化的不可变间接绑定。在此环境记录中不得已有名称为 N 的绑定。N2M 的模块环境记录中存在的一个绑定的名称。对新绑定值的访问将间接访问目标绑定的绑定值。调用时执行以下步骤:

  1. 断言: envRec 不得已有名称为 N 的绑定。
  2. 断言: 当 M[[Environment]] 实例化时,它将具有名称为 N2 的直接绑定。
  3. envRec 中创建一个不可变的间接绑定,引用 MN2 作为其目标绑定,并记录该绑定已初始化。
  4. 返回 未使用

9.1.2 环境记录操作

本规范使用以下 抽象操作 来对 环境记录 进行操作:

9.1.2.1 GetIdentifierReference ( env, name, strict )

抽象操作 GetIdentifierReference 接受参数 env(一个 环境记录null)、name(字符串)和 strict(布尔值),返回一个包含 引用记录 的正常完成记录或抛出完成记录。调用时执行以下步骤:

  1. 如果 envnull,则
    1. 返回 引用记录 { [[Base]]: unresolvable, [[ReferencedName]]: name, [[Strict]]: strict, [[ThisValue]]: empty }。
  2. exists 为 ? env.HasBinding(name)。
  3. 如果 existstrue,则
    1. 返回 引用记录 { [[Base]]: env, [[ReferencedName]]: name, [[Strict]]: strict, [[ThisValue]]: empty }。
  4. 否则,
    1. outerenv.[[OuterEnv]]
    2. 返回 ? GetIdentifierReference(outer, name, strict)。

9.1.2.2 NewDeclarativeEnvironment ( E )

抽象操作 NewDeclarativeEnvironment 接受参数 E(一个 环境记录null),返回一个 声明环境记录。调用时执行以下步骤:

  1. env 为一个新的 声明环境记录,其中不包含任何绑定。
  2. env.[[OuterEnv]] 设置为 E
  3. 返回 env

9.1.2.3 NewObjectEnvironment ( O, W, E )

抽象操作 NewObjectEnvironment 接受参数 O(一个对象)、W(布尔值)和 E(一个 环境记录null),返回一个 对象环境记录。调用时执行以下步骤:

  1. env 为一个新的 对象环境记录
  2. env.[[BindingObject]] 设置为 O
  3. env.[[IsWithEnvironment]] 设置为 W
  4. env.[[OuterEnv]] 设置为 E
  5. 返回 env

9.1.2.4 NewFunctionEnvironment ( F, newTarget )

抽象操作 NewFunctionEnvironment 接受参数 F(一个 ECMAScript 函数对象)和 newTarget(一个对象或 undefined),返回一个 函数环境记录。调用时执行以下步骤:

  1. env 为一个新的 函数环境记录,其中不包含任何绑定。
  2. env.[[FunctionObject]] 设置为 F
  3. 如果 F.[[ThisMode]]lexical,将 env.[[ThisBindingStatus]] 设置为 lexical
  4. 否则,将 env.[[ThisBindingStatus]] 设置为 uninitialized
  5. env.[[NewTarget]] 设置为 newTarget
  6. env.[[OuterEnv]] 设置为 F.[[Environment]]
  7. 返回 env

9.1.2.5 NewGlobalEnvironment ( G, thisValue )

抽象操作 NewGlobalEnvironment 接受参数 G(一个对象)和 thisValue(一个对象),返回一个 全局环境记录。调用时执行以下步骤:

  1. objRecNewObjectEnvironment(G, false, null)。
  2. dclRecNewDeclarativeEnvironment(null)。
  3. env 为一个新的 全局环境记录
  4. env.[[ObjectRecord]] 设置为 objRec
  5. env.[[GlobalThisValue]] 设置为 thisValue
  6. env.[[DeclarativeRecord]] 设置为 dclRec
  7. env.[[VarNames]] 设置为一个新的空 列表
  8. env.[[OuterEnv]] 设置为 null
  9. 返回 env

9.1.2.6 NewModuleEnvironment ( E )

抽象操作 NewModuleEnvironment 接受参数 E(一个 环境记录),返回一个 模块环境记录。调用时执行以下步骤:

  1. env 为一个新的 模块环境记录,其中不包含任何绑定。
  2. env.[[OuterEnv]] 设置为 E
  3. 返回 env

9.2 私有环境记录

私有环境记录 是一种用于根据 ECMAScript 代码中的 类声明类表达式 的词法嵌套结构跟踪 私有名称 的规范机制。它们类似于但不同于 环境记录。每个 私有环境记录 都与一个 类声明类表达式 相关联。每次评估这样的类时,都会创建一个新的 私有环境记录 来记录该类声明的 私有名称

每个 私有环境记录 都具有 表 23 中定义的字段。

表 23: 私有环境记录 字段
字段名 值类型 含义
[[OuterPrivateEnvironment]] 一个 私有环境记录null 最近的包含类的 私有环境记录。如果与此 私有环境记录 关联的类不包含在任何其他类中,则为 null
[[Names]] 一个 列表,包含 私有名称 该类声明的 私有名称

9.2.1 私有环境记录操作

本规范使用以下 抽象操作 来对 私有环境记录 进行操作:

9.2.1.1 NewPrivateEnvironment ( outerPrivEnv )

抽象操作 NewPrivateEnvironment 接受参数 outerPrivEnv(一个 私有环境记录null),返回一个 私有环境记录。调用时执行以下步骤:

  1. names 为一个新的空 列表
  2. 返回 私有环境记录 { [[OuterPrivateEnvironment]]: outerPrivEnv, [[Names]]: names }。

9.2.1.2 ResolvePrivateIdentifier ( privEnv, identifier )

抽象操作 ResolvePrivateIdentifier 接受参数 privEnv(一个 私有环境记录)和 identifier(字符串),返回一个 私有名称。调用时执行以下步骤:

  1. namesprivEnv.[[Names]]
  2. 对于 names 中的每个 私有名称 pn, 执行以下步骤:
    1. 如果 pn.[[Description]]identifier,则:
      1. 返回 pn
  3. outerPrivEnvprivEnv.[[OuterPrivateEnvironment]]
  4. 断言outerPrivEnv 不为 null
  5. 返回 ResolvePrivateIdentifier( outerPrivEnv, identifier)。

9.3 范围(Realms)

在评估之前,所有 ECMAScript 代码都必须与一个 范围 相关联。从概念上讲,一个 范围 由一组内置对象、一个 ECMAScript 全局环境、在该全局环境范围内加载的所有 ECMAScript 代码,以及其他相关状态和资源组成。

本规范中以 范围记录 表示 范围,其字段在 表 24 中指定:

表 24:范围记录 字段
字段名称 含义
[[AgentSignifier]] 一个 代理标识符 拥有此 范围代理
[[Intrinsics]] 一个 记录,其字段名称是内置键,其值是对象 与此 范围 相关联的代码使用的内置值
[[GlobalObject]] 一个对象或 undefined 全局对象 对于此 范围
[[GlobalEnv]] 一个 全局环境记录 范围 的全局环境
[[TemplateMap]] 一个 列表,包含字段 [[Site]](一个 模板字面量 解析节点)和 [[Array]](一个数组)

模板对象在每个 范围 中分别进行规范化,使用其 范围记录[[TemplateMap]]。每个 [[Site]] 值是一个 解析节点,即一个 模板字面量。关联的 [[Array]] 值是传递给标签函数的相应模板对象。

注 1
一旦 解析节点 变得不可达,对应的 [[Array]] 也会变得不可达,如果实现从 [[TemplateMap]] 列表中删除该对,这将是不可观察的。
[[LoadedModules]] 一个 列表,包含字段 [[Specifier]](一个字符串)和 [[Module]](一个 模块记录

从此 范围 导入的说明符字符串到已解析的 模块记录 的映射。该列表不包含两个具有相同 [[Specifier]] 的不同 记录

注 2
正如在 HostLoadImportedModule16.2.1.8 注 1)中所述, [[LoadedModules]]范围记录 中仅在没有 活动脚本或模块 的上下文中运行 import() 表达式时使用。
[[HostDefined]] 任何(默认值为 undefined 宿主 保留的字段,用于将其他信息与 范围记录 关联。

9.3.1 创建范围(CreateRealm) ( )

抽象操作 CreateRealm 不接受任何参数并返回一个 范围记录。调用时执行以下步骤:

  1. realmRec 为一个新的 范围记录
  2. 执行 CreateIntrinsics(realmRec)。
  3. realmRec.[[AgentSignifier]] 设置为 AgentSignifier()。
  4. realmRec.[[GlobalObject]] 设置为 undefined
  5. realmRec.[[GlobalEnv]] 设置为 undefined
  6. realmRec.[[TemplateMap]] 设置为一个新的空 列表
  7. 返回 realmRec

9.3.2 创建内置对象(CreateIntrinsics) ( realmRec )

抽象操作 CreateIntrinsics 接受参数 realmRec(一个 范围记录)并返回 unused。调用时执行以下步骤:

  1. realmRec.[[Intrinsics]] 设置为一个新的 记录
  2. 使用 表 6 中列出的值设置 realmRec.[[Intrinsics]] 的字段。这些字段名称是表的第一列中列出的名称。每个字段的值是一个新的对象值,按照规范中的定义完全递归地填充属性值。这些对象的创建顺序必须避免对尚未创建的对象的依赖。
  3. 执行 AddRestrictedFunctionProperties(realmRec.[[Intrinsics]].[[%Function.prototype%]], realmRec)。
  4. 返回 unused

9.3.3 设置范围全局对象(SetRealmGlobalObject) ( realmRec, globalObj, thisValue )

抽象操作 SetRealmGlobalObject 接受参数 realmRec(一个 范围记录)、globalObj(一个对象或 undefined),以及 thisValue(一个对象或 undefined),并返回 unused。调用时执行以下步骤:

  1. 如果 globalObjundefined,则:
    1. intrinsicsrealmRec.[[Intrinsics]]
    2. globalObj 设置为 OrdinaryObjectCreate(intrinsics.[[%Object.prototype%]])。
  2. 断言globalObj一个对象
  3. 如果 thisValueundefined,则将 thisValue 设置为 globalObj
  4. realmRec.[[GlobalObject]] 设置为 globalObj
  5. newGlobalEnvNewGlobalEnvironment(globalObj, thisValue)。
  6. realmRec.[[GlobalEnv]] 设置为 newGlobalEnv
  7. 返回 unused

9.3.4 设置默认全局绑定(SetDefaultGlobalBindings) ( realmRec )

抽象操作 SetDefaultGlobalBindings 接受参数 realmRec(一个 范围记录)并返回一个 正常完成的对象 或 一个 抛出完成。调用时执行以下步骤:

  1. globalrealmRec.[[GlobalObject]]
  2. 对于在 第 19 章 中指定的全局对象的每个属性,执行:
    1. name 为属性名称的字符串值。
    2. desc 为该属性的完全填充的数据 属性描述符,包含该属性的指定属性。对于 第 19.2 章第 19.3 章第 19.4 章 中列出的属性,其 [[Value]] 属性的值是对应的内置对象。
    3. 执行 ? DefinePropertyOrThrow(global, name, desc)。
  3. 返回 global

9.4 执行上下文(Execution Contexts)

执行上下文 是一个规范设备,用于跟踪 ECMAScript 实现对代码的运行时评估。在任何时候,每个 代理 至多只有一个正在实际执行代码的执行上下文。这被称为该 代理正在运行的执行上下文。在此规范中的所有对 正在运行的执行上下文 的引用都指的是 围绕的代理正在运行的执行上下文

执行上下文堆栈 用于跟踪执行上下文。正在运行的执行上下文 始终是该堆栈的顶部元素。每当控制从当前 正在运行的执行上下文 关联的可执行代码转移到与该执行上下文无关的可执行代码时,都会创建一个新的执行上下文。新创建的执行上下文会被推送到堆栈顶部,成为 正在运行的执行上下文

执行上下文包含所有跟踪其关联代码执行进度的必要实现特定状态。每个执行上下文至少有 表 25 中列出的状态组件。

表 25: 所有执行上下文的状态组件
组件 目的
代码评估状态 执行、暂停和恢复与此 执行上下文 关联的代码所需的任何状态。
函数 如果此 执行上下文 正在评估 函数对象 的代码,则此组件的值为该 函数对象。如果上下文正在评估 脚本模块 的代码,则值为 null
范围 关联代码访问 ECMAScript 资源的 范围记录
脚本或模块 关联代码来源的 模块记录脚本记录。如果没有起源脚本或模块,如在 InitializeHostDefinedRealm 中创建的原始 执行上下文 的情况,则值为 null

评估 代码时 正在运行的执行上下文 可能会在此规范中定义的各个点暂停。一旦 正在运行的执行上下文 被暂停,不同的执行上下文可能成为 正在运行的执行上下文 并开始评估其代码。稍后,暂停的执行上下文可能再次成为 正在运行的执行上下文 并在先前暂停的点继续评估其代码。正在运行的执行上下文 状态在执行上下文之间的转换通常以堆栈样式的后进先出方式进行。然而,一些 ECMAScript 特性需要 正在运行的执行上下文 的非 LIFO 转换。

范围 组件的值也被称为 当前范围记录正在运行的执行上下文 的函数组件的值也被称为 活动函数对象

ECMAScript 代码执行上下文 具有 表 26 中列出的附加状态组件。

表 26: ECMAScript 代码执行上下文的附加状态组件
组件 目的
词法环境 标识用于解析此 执行上下文 内代码所做的标识符引用的 环境记录
变量环境 标识在此 执行上下文 中由 变量声明 创建绑定的 环境记录
私有环境 标识由最近包含类中的 类元素 创建的 私有名称私有环境记录。如果没有包含类,则为 null

执行上下文的词法环境和变量环境组件始终是 环境记录

表示生成器评估的执行上下文具有 表 27 中列出的附加状态组件。

表 27: 生成器执行上下文的附加状态组件
组件 目的
生成器 执行上下文 正在评估的生成器。

在大多数情况下,仅由此规范中的算法直接操作 正在运行的执行上下文执行上下文堆栈 的顶部)。因此,当未注明时使用术语“词法环境”和“变量环境”,它们是指 正在运行的执行上下文 的这些组件。

执行上下文纯粹是一个规范机制,不需要对应于 ECMAScript 实现的任何特定制品。ECMAScript 代码不可能直接访问或观察到执行上下文。

9.4.1 GetActiveScriptOrModule ( )

抽象操作 GetActiveScriptOrModule 不接受参数,并返回 脚本记录模块记录null。它用于基于 正在运行的执行上下文 确定正在运行的脚本或模块。调用时执行以下步骤:

  1. 如果 执行上下文堆栈 为空,则返回 null
  2. ec执行上下文堆栈 中最顶部的 执行上下文,其 ScriptOrModule 组件不为 null
  3. 如果不存在这样的 执行上下文,则返回 null。否则,返回 ec 的 ScriptOrModule。

9.4.2 ResolveBinding ( name [ , env ] )

抽象操作 ResolveBinding 接受参数 name(一个字符串)和可选参数 env(一个 环境记录undefined),并返回 正常完成记录,包含一个 引用记录 或一个 抛出完成记录。它用于确定 name 的绑定。env 可以用于显式提供要搜索绑定的 环境记录。调用时执行以下步骤:

  1. 如果未提供 envenvundefined,则
    1. env 设置为 正在运行的执行上下文 的词法环境。
  2. 断言env 是一个 环境记录
  3. 如果正在评估的语法生成的 源文本匹配 包含在 严格模式代码 中,则将 strict 设置为 true;否则将 strict 设置为 false
  4. 返回 ? GetIdentifierReference(env, name, strict)。

ResolveBinding 的结果始终是一个 引用记录,其 [[ReferencedName]] 字段是 name

9.4.3 GetThisEnvironment ( )

抽象操作 GetThisEnvironment 不接受参数,并返回一个 环境记录。它找到当前提供 this 绑定的 环境记录。调用时执行以下步骤:

  1. env 设置为 正在运行的执行上下文 的词法环境。
  2. 重复以下步骤,直到条件不成立为止:
    1. existsenv.HasThisBinding()。
    2. 如果 existstrue,则返回 env
    3. outer 设置为 env.[[OuterEnv]]
    4. 断言outer 不是 null
    5. env 设置为 outer

步骤 2 中的循环将始终终止,因为环境列表总是以具有 this 绑定的全局环境结束。

9.4.4 ResolveThisBinding ( )

抽象操作 ResolveThisBinding 不接受参数,并返回 正常完成记录,包含一个 ECMAScript 语言值 或一个 抛出完成记录。它使用 正在运行的执行上下文 的词法环境确定 this 的绑定。调用时执行以下步骤:

  1. envRecGetThisEnvironment()。
  2. 返回 ? envRec.GetThisBinding()。

9.4.5 GetNewTarget ( )

抽象操作 GetNewTarget 不接受参数,并返回一个对象或 undefined。它使用 正在运行的执行上下文 的词法环境确定 NewTarget 值。调用时执行以下步骤:

  1. envRecGetThisEnvironment()。
  2. 断言envRec 具有 [[NewTarget]] 字段。
  3. 返回 envRec.[[NewTarget]]

9.4.6 GetGlobalObject ( )

抽象操作 GetGlobalObject 不接受参数并返回一个对象。它返回由当前 正在运行的执行上下文 使用的 全局对象。调用时执行以下步骤:

  1. currentRealm当前范围记录
  2. 返回 currentRealm.[[GlobalObject]]

9.5 Jobs and Host Operations to Enqueue Jobs

作业是一个无参数的抽象闭包,在没有其他 ECMAScript 计算正在进行时启动 ECMAScript 计算。

作业由 ECMAScript 宿主环境在特定的代理中调度执行。本规范描述了宿主挂钩HostEnqueueGenericJobHostEnqueueFinalizationRegistryCleanupJobHostEnqueuePromiseJobHostEnqueueTimeoutJob来调度作业。这个规范中的宿主挂钩按调度作业时附加的约束进行组织。宿主可以定义其他抽象操作来调度作业。这些操作接受一个作业抽象闭包和一个范围(一个范围记录null)作为参数。如果提供了范围记录,这些操作会在提供的范围中调度作业,以由拥有范围代理在将来的某个时间执行。如果提供的是null,则该作业不会执行 ECMAScript 代码。其实现必须符合以下要求:

注 1
宿主环境不需要 以统一的方式对待作业的调度。例如,网络浏览器和 Node.js 将 Promise 处理作业视为比其他工作优先级更高;未来的功能可能会添加作业,这些作业不会被视为如此高的优先级。

在任何特定时间,如果以下所有条件都为真,则scriptOrModule(一个脚本记录、一个模块记录null)是活动脚本或模块

在任何特定时间,如果以下所有条件都为真,则执行准备好评估 ECMAScript 代码

注 2

宿主环境可以通过将执行上下文推入执行上下文堆栈来准备评估代码。具体步骤是实现定义的

选择范围的具体方式取决于宿主环境。这个初始执行上下文范围仅在调用任何回调函数之前使用。当与作业相关的回调函数(例如 Promise 处理程序)被调用时,调用会推入自己的执行上下文范围

特定种类的作业有额外的符合性要求。

9.5.1 作业回调记录

作业回调记录是一个记录值,用于存储一个函数对象和一个宿主定义的值。通过宿主排队的作业调用的函数对象可以具有额外的宿主定义上下文。为了传播状态,作业的抽象闭包不应该直接捕获并调用函数对象。相反,使用HostMakeJobCallbackHostCallJobCallback

WHATWG HTML 规范(https://html.spec.whatwg.org/)例如,使用宿主定义的值传播 Promise 回调的现有设置对象。

作业回调记录具有表 28中列出的字段。

表 28:作业回调记录字段
字段名称 含义
[[Callback]] 一个函数对象 作业被调用时要调用的函数。
[[HostDefined]] 任何(默认值为empty 保留供宿主使用的字段。

9.5.2 HostMakeJobCallback ( callback )

宿主定义的抽象操作 HostMakeJobCallback 接受参数callback(一个函数对象)并返回一个作业回调记录

HostMakeJobCallback 的实现必须符合以下要求:

  • 它必须返回一个作业回调记录,其[[Callback]]字段是callback

HostMakeJobCallback 的默认实现在调用时执行以下步骤:

  1. 返回作业回调记录 { [[Callback]]: callback[[HostDefined]]: empty }。

不是网络浏览器的 ECMAScript 宿主必须使用 HostMakeJobCallback 的默认实现。

这在将回调传递给负责其最终调度和运行的函数时调用。例如,promise.then(thenAction)在调用Promise.prototype.then时调用 MakeJobCallback 在调用Promise.prototype.then时调用 MakeJobCallback,而不是在调度反应作业时。

9.5.3 HostCallJobCallback ( jobCallback, V, argumentsList )

宿主定义的抽象操作 HostCallJobCallback 接受参数jobCallback(一个作业回调记录),V(一个ECMAScript 语言值)和argumentsList(一个列表由 ECMAScript 语言值组成)并返回正常完成,其中包含一个ECMAScript 语言值或一个抛出完成

HostCallJobCallback 的实现必须符合以下要求:

  • 它必须执行并返回调用(jobCallback.[[Callback]]VargumentsList)的结果。

此要求意味着宿主不能更改本规范中定义的函数对象的[[Call]]行为。

HostCallJobCallback 的默认实现在调用时执行以下步骤:

  1. 断言IsCallable(jobCallback.[[Callback]]) 为true
  2. 返回?调用(jobCallback.[[Callback]]VargumentsList)的结果。

不是网络浏览器的 ECMAScript 宿主必须使用 HostCallJobCallback 的默认实现。

9.5.4 HostEnqueueGenericJob ( job, realm )

宿主定义的抽象操作 HostEnqueueGenericJob 接受参数job(一个作业抽象闭包)和realm(一个范围记录)并返回unused。它将job调度到realm所指示的代理的realm中,以便在将来的某个时间执行。这些抽象闭包旨在不受附加约束(如优先级和顺序)调度。

HostEnqueueGenericJob 的实现必须符合9.5中的要求。

9.5.5 HostEnqueuePromiseJob ( job, realm )

宿主定义的抽象操作 HostEnqueuePromiseJob 接受参数job(一个作业抽象闭包)和realm(一个范围记录null)并返回unused。它将job调度到将来的某个时间执行。用于该算法的抽象闭包旨在与处理 Promise 相关,或者以与 Promise 处理操作同等的优先级进行调度。

HostEnqueuePromiseJob 的实现必须符合9.5中的要求以及以下内容:

通过NewPromiseResolveThenableJob返回的作业的realm通常是通过调用GetFunctionRealmthen函数对象上的结果。通过NewPromiseReactionJob返回的作业的realm通常是通过调用GetFunctionRealm在处理程序不是undefined时的结果。如果处理程序是undefined,则realmnull。对于这两种类型的作业,当GetFunctionRealm异常完成时(即在撤销的代理上调用),realm是调用GetFunctionRealm时的当前范围记录。当realmnull时,不会评估用户 ECMAScript 代码,也不会创建新的 ECMAScript 对象(例如错误对象)。WHATWG HTML 规范(https://html.spec.whatwg.org/),例如,使用realm检查运行脚本的能力和条目概念。

9.5.6 HostEnqueueTimeoutJob ( timeoutJob, realm, milliseconds )

宿主定义的抽象操作 HostEnqueueTimeoutJob 接受参数timeoutJob(一个作业抽象闭包),realm(一个范围记录)和milliseconds(一个非负有限数字)并返回unused。它将timeoutJob调度到realm所指示的代理的realm中,以便在至少milliseconds毫秒后执行。

HostEnqueueTimeoutJob 的实现必须符合9.5中的要求。

9.6 InitializeHostDefinedRealm ( )

抽象操作 InitializeHostDefinedRealm 不接受任何参数,返回一个包含 正常完成unused 或者一个 抛出完成。调用时,它执行以下步骤:

  1. realmCreateRealm() 的结果。
  2. newContext 为一个新的 执行上下文
  3. newContext 的 Function 设置为 null
  4. newContextRealm 设置为 realm
  5. newContext 的 ScriptOrModule 设置为 null
  6. newContext 推入 执行上下文栈newContext 现在是 运行中的执行上下文
  7. 如果 宿主 需要使用一个 特殊对象 作为 realm全局对象,则让 global 为以 宿主定义 的方式创建的此类对象。否则,让 globalundefined,表示应创建一个 普通对象 作为 全局对象
  8. 如果 宿主 需要 this 绑定在 realm 的全局作用域中返回一个不同于 全局对象 的对象,则让 thisValue 为以 宿主定义 的方式创建的此类对象。否则,让 thisValueundefined,表示 realm 的全局 this 绑定应为 全局对象
  9. 执行 SetRealmGlobalObject(realm, global, thisValue)。
  10. globalObj 为 ? SetDefaultGlobalBindings(realm) 的结果。
  11. globalObj 上创建任何 宿主定义全局对象属性。
  12. 返回 unused

9.7 Agents

一个代理包括一组ECMAScript执行上下文、一个执行上下文栈、一个运行中的执行上下文、一个代理记录和一个执行线程。除了执行线程之外,代理的组成部分完全属于该代理

一个代理执行线程独立于其他代理在其执行上下文上执行算法步骤,除非一个执行线程可被多个代理共享,前提是共享该线程的代理没有代理记录[[CanBlock]]字段为true

注1

一些网络浏览器会在多个不相关的浏览器窗口标签页之间共享单个执行线程

当一个代理执行线程正在执行算法步骤时,该代理就是这些步骤的外围代理。这些步骤使用外围代理来访问在代理内保存的规范级执行对象:运行中的执行上下文执行上下文栈代理记录的字段。

一个代理标识符是一个全局唯一的、不透明的值,用于标识一个代理

表29: 代理记录字段
字段名 含义
[[LittleEndian]] 布尔值 在算法GetValueFromBufferSetValueInBuffer中需要时,计算isLittleEndian参数的默认值。该选择是实现定义的,应该是对实现最有效的替代方案。一旦该值被观察到,它就不能改变。
[[CanBlock]] 布尔值 确定代理是否可以阻塞。
[[Signifier]] 一个代理标识符 唯一标识其代理在其代理集群中的位置。
[[IsLockFree1]] 布尔值 如果对一个字节大小值的原子操作是无锁的,则为true,否则为false
[[IsLockFree2]] 布尔值 如果对两字节大小值的原子操作是无锁的,则为true,否则为false
[[IsLockFree8]] 布尔值 如果对八字节大小值的原子操作是无锁的,则为true,否则为false
[[CandidateExecution]] 一个候选执行记录 参见内存模型
[[KeptAlive]] 一个列表,包括对象或符号 最初是一个新的空列表,表示在当前任务结束前需要保持存活的对象和/或符号的列表。

一旦[[Signifier]][[IsLockFree1]][[IsLockFree2]]的值被任何代理在其代理集群中观察到,它们就不能改变。

注2

[[IsLockFree1]][[IsLockFree2]]的值不一定由硬件决定,还可能反映出可能随时间和不同ECMAScript实现而变化的实现选择。

没有[[IsLockFree4]]字段:四字节原子操作总是无锁的。

实际上,如果一个原子操作的实现使用了任何类型的锁,则该操作就不是无锁的。无锁不意味着无等待:没有关于完成无锁原子操作需要多少机器步骤的上限。

原子访问大小为n是无锁的,并不意味着对非原子访问大小为n的访问有任何暗示,特别是,非原子访问仍可能作为一系列单独的内存访问执行。详见ReadSharedMemoryWriteSharedMemory

注3

一个代理是一个规范机制,不必对应于ECMAScript实现的任何特定工件。

9.7.1 AgentSignifier ( )

抽象操作 AgentSignifier 不接受任何参数,并返回一个代理标识符。调用时,它执行以下步骤:

  1. AR代理记录,属于外围代理
  2. 返回 AR.[[Signifier]]

9.7.2 AgentCanSuspend ( )

抽象操作 AgentCanSuspend 不接受任何参数,并返回一个布尔值。调用时,它执行以下步骤:

  1. AR代理记录,属于外围代理
  2. 返回 AR.[[CanBlock]]

在某些环境中,允许给定代理挂起可能是不合理的。例如,在网络浏览器环境中,可能不允许挂起文档的主事件处理线程,同时仍然允许工作线程的事件处理线程挂起。

9.8 代理集群

一个代理集群是可以通过操作共享内存进行通信的代理的最大集合。

注1

不同代理中的程序可能通过未指定的方法共享内存。至少,SharedArrayBuffers的底层内存可以在集群中的代理之间共享。

可能有一些代理可以通过消息传递进行通信,但不能共享内存;它们永远不会在同一个代理集群中。

每个代理只属于一个代理集群。

注2

集群中的代理不需要在某个特定时间点都存活。如果代理A创建了另一个代理B,之后A终止,而B创建了代理C,如果A可以与B共享某些内存且B可以与C共享某些内存,那么这三个代理在同一个集群中。

集群中的所有代理在其各自的代理记录中的[[LittleEndian]]字段的值必须相同。

注3

如果一个代理集群中的不同代理[[LittleEndian]]值不同,则使用共享内存进行多字节数据操作会变得困难。

集群中的所有代理在其各自的代理记录中的[[IsLockFree1]]字段的值必须相同;同样适用于[[IsLockFree2]]字段。

集群中的所有代理在其各自的代理记录中的[[Signifier]]字段的值必须不同。

嵌入环境可以在不通知或合作代理的情况下停用(停止前进进程)或激活(恢复前进进程)一个代理。如果嵌入环境这样做,它必须确保集群中的一些代理在其他代理被无限期停用时不继续活动。

注4

上述限制的目的是避免出现某个代理由于另一个代理被停用而死锁或饿死的情况。例如,如果HTML共享工作者的生命周期独立于任何窗口中的文档,并允许其与这样的独立文档的专用工作者共享内存,而该文档及其专用工作者在持有锁时被停用(例如,文档被推入窗口的历史记录中),然后共享工作者尝试获取锁,则共享工作者将被阻塞直到专用工作者再次激活(如果有的话)。同时,尝试从其他窗口访问共享工作者的其他工作者将饿死。

这一限制的含义是,在嵌入环境中,不可能在不属于同一挂起/唤醒集体的代理之间共享内存。

嵌入环境可以在不通知或合作集群中其他代理的情况下终止一个代理。如果一个代理不是由其自身或集群中另一个代理通过编程方式终止,而是由集群外部的力量终止,那么嵌入环境必须选择以下两种策略之一:要么终止集群中的所有代理,要么提供可靠的API,使集群中的代理能够协调,以便集群中至少有一个剩余成员能够检测到终止,并且终止数据包含足够的信息来识别被终止的代理

注5

这种终止的例子包括:操作系统或用户终止在不同进程中运行的代理;当每个代理的资源核算表明代理是失控时,嵌入环境本身终止与其他代理在同一进程中运行的代理

每个以下的规范值及从它们递归可达的值,只属于一个代理集群。

在集群中任何代理评估任何ECMAScript代码之前,集群中所有代理代理记录中的[[CandidateExecution]]字段被设置为初始的候选执行。初始的候选执行是一个空的候选执行,其[[EventsRecords]]字段是一个列表,其中包含每个代理代理事件记录,其[[AgentSignifier]]字段是该代理代理标识符,其[[EventList]][[AgentSynchronizesWith]]字段是空的列表

注6

一个代理集群中的所有代理共享其代理记录[[CandidateExecution]]字段中的同一个候选执行候选执行内存模型使用的规范机制。

注7

代理集群是一个规范机制,不必对应于ECMAScript实现的任何特定工件。

9.9 前进进度

对于一个代理来说,前进进度是指其根据本规范执行评估步骤。

代理运行执行上下文同步且无限期地等待外部事件时,该代理会变得阻塞。只有其代理记录[[CanBlock]]字段为true代理才会以这种方式阻塞。一个非阻塞代理是指不阻塞的代理。

实现必须确保:

这与内存模型中的活性保证一起,确保所有seq-cst写操作最终会对所有代理可见。

9.10 WeakRef 和 FinalizationRegistry 目标的处理模型

9.10.1 目标

本规范不保证任何对象或符号将被垃圾回收。对于那些不是存活的对象或符号,可能在很长一段时间后或永远不会被释放。因此,本规范在描述垃圾回收触发的行为时使用了“可能”一词。

WeakRefsFinalizationRegistrys的语义基于两个在特定时间点发生的操作:

  • 当调用WeakRef.prototype.deref时,如果未返回undefined,则被引用对象保持存活,以便随后的同步访问也返回相同的值。当使用ClearKeptObjects抽象操作进行同步工作时,此列表会被重置。
  • 当与FinalizationRegistry注册的对象或符号变得不可达时,可能会在同步 ECMAScript 执行完成后调用FinalizationRegistry的清理回调。清理通过CleanupFinalizationRegistry抽象操作进行。

这些操作(ClearKeptObjectsCleanupFinalizationRegistry)不会中断同步的 ECMAScript 执行。由于宿主可能会组装更长的同步 ECMAScript 执行运行,本规范将ClearKeptObjectsCleanupFinalizationRegistry的调度延迟到宿主环境

一些 ECMAScript 实现包括在后台运行的垃圾回收器实现,包括 ECMAScript 空闲时。让宿主环境调度CleanupFinalizationRegistry允许它恢复 ECMAScript 执行以运行终结器工作,这可能释放被占用的值,从而减少整体内存使用。

9.10.2 存活性

对于某些对象和/或符号的集合S,相对于S假设的 WeakRef-oblivious执行是指抽象操作WeakRefDeref的执行,该操作始终返回undefined

注 1
WeakRef-obliviousness 与存活性共同捕捉了两个概念。其一,WeakRef本身不会使其引用保持存活。其二,存活性的循环不意味着一个值是存活的。具体来说,如果确定v的存活性取决于确定WeakRef引用r的存活性,r的存活性不能假定v的存活性,这将是循环推理。
注 2
WeakRef-obliviousness 是在对象或符号集合上定义的,以解释循环。如果它在单个值上定义,那么一个在循环中的WeakRef引用将被视为存活,即使它的身份只是通过循环中的其他WeakRef引用观察到的。
注 3
通俗地说,我们认为单个对象或符号是存活的,如果包含它的每个集合都是存活的。

在评估过程中,如果对象和/或符号的集合S满足以下任一条件,则被认为是存活的

  • S中的任何元素都包含在任何代理[[KeptAlive]]列表中。
  • 存在一个有效的未来假设的 WeakRef-oblivious 执行,该执行观察S中任何值的身份。
注 4
上述第二个条件旨在捕捉这样的直觉:如果通过非WeakRef方式观察到一个值的身份,那么该值是存活的。可以通过观察严格的相等比较或观察将值用作 Map 中的键来观察值的身份。
注 5

对象或符号在字段、内部槽或属性中的存在并不意味着该值是存活的。例如,如果问题中的值从未传递回程序,则无法观察到它。

这是 WeakMap 中的键、WeakSet 的成员以及[[WeakRefTarget]][[UnregisterToken]]字段在FinalizationRegistry单元记录中的情况。

上述定义意味着,如果 WeakMap 中的键不是存活的,则其对应的值也不一定是存活的。

注 6
存活性是保证引擎不清空哪些WeakRefs的下限。此处定义的存活性是不可判定的。在实践中,引擎使用保守的近似方法,例如可达性。预计会有显著的实现灵活性。

9.10.3 执行

在任何时候,如果对象和/或符号的集合S不是存活的,ECMAScript 实现可以原子地执行以下步骤:

  1. 对于S的每个元素value,执行以下操作
    1. 对于每个WeakRef,如果ref[[WeakRefTarget]]value,则执行以下操作
      1. ref[[WeakRefTarget]]设置为empty
    2. 对于每个FinalizationRegistry,如果fg[[Cells]]包含一个记录,其中cell[[WeakRefTarget]]value,则执行以下操作
      1. cell[[WeakRefTarget]]设置为empty
      2. 可选地,执行HostEnqueueFinalizationRegistryCleanupJob(fg)。
    3. 对于每个 WeakMapmap,如果map[[WeakMapData]]包含一个记录,其中r[[Key]]value,则执行以下操作
      1. r[[Key]]设置为empty
      2. r[[Value]]设置为empty
    4. 对于每个 WeakSetset,如果set[[WeakSetData]]包含value,则执行以下操作
      1. 用值为empty的元素替换set[[WeakSetData]]中值为value的元素。
注 1

结合存活性的定义,本条款规定了实现可以应用的关于WeakRefs的优化。

有可能在不观察对象身份的情况下访问对象。允许对非逃逸对象的属性进行死变量消除和标量替换等优化,因此这些优化可以可观察地清空指向这些对象的WeakRefs

另一方面,如果可以观察到对象的身份,并且该对象位于WeakRef[[WeakRefTarget]]内部槽中,则禁止进行可观察地清空WeakRef的优化。

由于调用HostEnqueueFinalizationRegistryCleanupJob是可选的,注册在FinalizationRegistry中的对象不一定是存活的。实现可以因任何原因省略FinalizationRegistry回调,例如,如果FinalizationRegistry本身变得死掉,或如果应用程序正在关闭。

注 2

实现没有义务为最大集合的非存活对象或符号清空WeakRefs

如果实现选择一个非存活集合S来清空WeakRefs,则此定义要求它同时清空S中所有值的WeakRefs。换句话说,实现不符合规范的行为是清空指向值vWeakRef,而不清空其他可能导致观察到v值的WeakRefs

9.10.4 宿主钩子

9.10.4.1 HostEnqueueFinalizationRegistryCleanupJob (finalizationRegistry)

宿主定义的抽象操作 HostEnqueueFinalizationRegistryCleanupJob 接受参数finalizationRegistry(一个FinalizationRegistry)并返回unused

cleanupJob成为一个新的作业抽象闭包,没有参数,捕获finalizationRegistry并在调用时执行以下步骤:

  1. cleanupResult完成(CleanupFinalizationRegistry(finalizationRegistry))。
  2. 如果cleanupResult是一个异常完成,执行任何宿主定义的步骤来报告错误。
  3. 返回unused

HostEnqueueFinalizationRegistryCleanupJob 的实现会安排在将来的某个时间执行cleanupJob,如果可能的话。它还必须符合9.5中的要求。

9.11 ClearKeptObjects ( )

抽象操作 ClearKeptObjects 不接受任何参数并返回 unused。期望 ECMAScript 实现会在一系列同步的 ECMAScript 执行完成时调用 ClearKeptObjects。调用该操作时执行以下步骤:

  1. agentRecord 成为 周围代理代理记录
  2. agentRecord.[[KeptAlive]] 设置为一个新的空的 列表
  3. 返回 unused

9.12 AddToKeptObjects ( value )

抽象操作 AddToKeptObjects 接受参数 value(一个对象或符号)并返回 unused。调用该操作时执行以下步骤:

  1. agentRecord 成为 周围代理代理记录
  2. value 添加到 agentRecord.[[KeptAlive]]
  3. 返回 unused
当抽象操作 AddToKeptObjects 被调用并传入目标对象或符号时,它会将目标添加到一个列表中,该列表会强引用该目标,直到调用 ClearKeptObjects

9.13 CleanupFinalizationRegistry ( finalizationRegistry )

抽象操作 CleanupFinalizationRegistry 接受参数 finalizationRegistry(一个 FinalizationRegistry),并返回 正常完成记录,包含 unused抛出完成记录。调用该操作时执行以下步骤:

  1. 断言finalizationRegistry 具有 [[Cells]][[CleanupCallback]] 内部槽。
  2. callbackfinalizationRegistry.[[CleanupCallback]]
  3. finalizationRegistry.[[Cells]] 包含一个 记录 cell,其 [[WeakRefTarget]]empty 时,实现可以执行以下步骤:
    1. 选择任意这样的 cell
    2. finalizationRegistry.[[Cells]] 中移除 cell
    3. 执行 ? HostCallJobCallback(callback, undefined, « cell.[[HeldValue]] »)。
  4. 返回 unused

9.14 CanBeHeldWeakly ( v )

抽象操作 CanBeHeldWeakly 接受参数 v(一个 ECMAScript 语言值),并返回一个布尔值。仅当 v 适合用作弱引用时,它才返回 true。只有适合用作弱引用的值才可以作为 WeakMap 的键、WeakSet 的元素、WeakRef 的目标,或 FinalizationRegistry 的目标之一。调用该操作时执行以下步骤:

  1. 如果 v 是一个对象,返回 true
  2. 如果 v 是一个符号,并且 KeyForSymbol(v) 是 undefined,返回 true
  3. 返回 false

没有 语言身份 的语言值可以在没有先前引用的情况下显现出来,不适合用作弱引用。通过 Symbol.for 产生的符号值与其他符号值不同,它没有语言身份,因此不适合用作弱引用。众所周知的符号 可能永远不会被收集,但仍被视为适合用作弱引用,因为它们数量有限,可以通过多种实现方法进行管理。然而,在 活动 WeakMap 中与众所周知符号关联的任何值都不太可能被收集,并且可能在实现中“泄漏”内存资源。

10 普通对象和异域对象的行为

10.1 普通对象的内部方法和内部槽

所有的 普通对象 都有一个名为 [[Prototype]] 的内部槽。这个内部槽的值可以是 null 或一个对象,用于实现继承。假设某个名为 P 的属性在一个 普通对象 O 中缺失,但在其 [[Prototype]] 对象上存在。如果 P 指向 数据属性,则 O 会继承该属性以进行读取操作,使其行为如同 PO 的一个属性一样。如果 P 指向 [[Prototype]] 对象上的一个可写的 数据属性,则在 O 上设置 P 的访问将会创建一个新的名为 P数据属性。如果 P 指向 [[Prototype]] 对象上的一个不可写的 数据属性,则在 O 上设置 P 的访问将会失败。如果 P 指向 访问器属性,该访问器将被 O 继承,以进行读取和设置操作。

每个 普通对象 都有一个布尔值的 [[Extensible]] 内部槽,用于满足 6.1.7.3 中规定的与可扩展性相关的内部方法不变性。也就是说,一旦对象的 [[Extensible]] 内部槽的值被设置为 false,就不能再向对象添加属性,也不能修改对象的 [[Prototype]] 内部槽的值,或者随后将 [[Extensible]] 的值更改为 true

在以下算法描述中,假设 O 是一个 普通对象P 是一个 属性键 值,V 是任何 ECMAScript 语言值,而 Desc 是一个 属性描述符 记录。

每个 普通对象 的内部方法都委托给一个同名的抽象操作。如果这样的抽象操作依赖于另一个内部方法,那么内部方法将会在 O 上被调用,而不是直接调用同名的抽象操作。这些语义确保了 异域对象 在应用普通对象的内部方法时,其被重写的内部方法会被调用。

10.1.1 [[GetPrototypeOf]] ( )

[[GetPrototypeOf]] 内部方法用于一个 普通对象 O,不接受任何参数,返回一个 正常的完成记录,其值为一个对象或 null。调用时执行以下步骤:

  1. 返回 OrdinaryGetPrototypeOf(O)。

10.1.1.1 OrdinaryGetPrototypeOf ( O )

抽象操作 OrdinaryGetPrototypeOf 接受一个参数 O(一个对象),并返回一个对象或 null。调用时执行以下步骤:

  1. 返回 O.[[Prototype]]

10.1.2 [[SetPrototypeOf]] ( V )

[[SetPrototypeOf]] 内部方法用于一个 普通对象 O,接受一个参数 V(一个对象或 null),并返回一个 正常的完成记录,其值为布尔值。调用时执行以下步骤:

  1. 返回 OrdinarySetPrototypeOf(O, V)。

10.1.2.1 OrdinarySetPrototypeOf ( O, V )

抽象操作 OrdinarySetPrototypeOf 接受两个参数:O(一个对象)和 V(一个对象或 null),并返回一个布尔值。调用时执行以下步骤:

  1. current 设为 O.[[Prototype]]
  2. 如果 SameValue(V, current) 为 true,则返回 true
  3. extensible 设为 O.[[Extensible]]
  4. 如果 extensiblefalse,则返回 false
  5. p 设为 V
  6. done 设为 false
  7. 重复以下步骤,直到 donetrue
    1. 如果 pnull,则
      1. done 设为 true
    2. 否则,如果 SameValue(p, O) 为 true,则
      1. 返回 false
    3. 否则,
      1. 如果 p.[[GetPrototypeOf]] 不是在 普通对象 内部方法中定义的 10.1.1,则将 done 设为 true
      2. 否则,将 p 设为 p.[[Prototype]]
  8. O.[[Prototype]] 设为 V
  9. 返回 true

步骤 7 中的循环保证了在原型链中只包含使用 普通对象 定义的 [[GetPrototypeOf]][[SetPrototypeOf]] 的对象时,不会出现循环。

10.1.3 [[IsExtensible]] ( )

[[IsExtensible]] 内部方法用于一个 普通对象 O,不接受参数,并返回一个 正常的完成记录,其值为布尔值。调用时执行以下步骤:

  1. 返回 OrdinaryIsExtensible(O)。

10.1.3.1 OrdinaryIsExtensible ( O )

抽象操作 OrdinaryIsExtensible 接受一个参数 O(一个对象),并返回一个布尔值。调用时执行以下步骤:

  1. 返回 O.[[Extensible]]

10.1.4 [[PreventExtensions]] ( )

[[PreventExtensions]] 内部方法用于一个 普通对象 O,不接受参数,并返回一个 正常的完成记录,其值为 true。调用时执行以下步骤:

  1. 返回 OrdinaryPreventExtensions(O)。

10.1.4.1 OrdinaryPreventExtensions ( O )

抽象操作 OrdinaryPreventExtensions 接受一个参数 O(一个对象),并返回 true。调用时执行以下步骤:

  1. O.[[Extensible]] 设置为 false
  2. 返回 true

10.1.5 [[GetOwnProperty]] ( P )

[[GetOwnProperty]] 内部方法用于一个 普通对象 O,接受一个参数 P(一个 属性键),并返回一个 正常的完成记录,其值可以是 属性描述符undefined。调用时执行以下步骤:

  1. 返回 OrdinaryGetOwnProperty(O, P)。

10.1.5.1 OrdinaryGetOwnProperty ( O, P )

抽象操作 OrdinaryGetOwnProperty 接受两个参数 O(一个对象)和 P(一个 属性键),并返回一个 属性描述符undefined。调用时执行以下步骤:

  1. 如果 O 没有键为 P 的自身属性,则返回 undefined
  2. 创建一个新的 属性描述符 D,其字段为空。
  3. 获取 O 自身属性中键为 P 的属性 X
  4. 如果 X 是一个 数据属性,则:
    1. D.[[Value]] 设置为 X[[Value]] 属性值。
    2. D.[[Writable]] 设置为 X[[Writable]] 属性值。
  5. 否则:
    1. 断言X 是一个 访问器属性
    2. D.[[Get]] 设置为 X[[Get]] 属性值。
    3. D.[[Set]] 设置为 X[[Set]] 属性值。
  6. D.[[Enumerable]] 设置为 X[[Enumerable]] 属性值。
  7. D.[[Configurable]] 设置为 X[[Configurable]] 属性值。
  8. 返回 D

10.1.6 [[DefineOwnProperty]] ( P, Desc )

普通对象的 [[DefineOwnProperty]] 内部方法接受两个参数:P(一个 属性 键)和 Desc(一个 属性描述符), 并返回一个 正常完成, 包含一个布尔值或一个 抛出完成。 调用时,它执行以下步骤:

  1. 返回 ? OrdinaryDefineOwnProperty(O, P, Desc).

10.1.6.1 OrdinaryDefineOwnProperty(O, P, Desc

抽象操作 OrdinaryDefineOwnProperty 接受参数 O(一个对象)、P(一个属性键),和 Desc(一个属性描述符),并返回一个包含布尔值的正常完成或一个抛出完成。当被调用时,它执行以下步骤:

  1. current 为 ? O.[[GetOwnProperty]](P)。
  2. extensible 为 ? IsExtensible(O)。
  3. 返回 ValidateAndApplyPropertyDescriptor(O, P, extensible, Desc, current)。

10.1.6.2 IsCompatiblePropertyDescriptor(Extensible, Desc, Current

抽象操作 IsCompatiblePropertyDescriptor 接受参数 Extensible(一个布尔值)、Desc(一个属性描述符),和 Current(一个属性描述符undefined),并返回一个布尔值。当被调用时,它执行以下步骤:

  1. 返回 ValidateAndApplyPropertyDescriptor(undefined, "", Extensible, Desc, Current)。

10.1.6.3 ValidateAndApplyPropertyDescriptor(O, P, extensible, Desc, current

抽象操作 ValidateAndApplyPropertyDescriptor 接受参数 O(一个对象或undefined)、P(一个属性键)、extensible(一个布尔值)、Desc(一个属性描述符),和 current(一个属性描述符undefined),并返回一个布尔值。只有当 Desc 可以作为具有指定扩展性和当前属性current的对象的属性应用时,同时保持不变量时,它才返回 true。当这种应用是可能的且O不是undefined时,它会为名为P的属性执行该应用(如有必要,创建该属性)。当被调用时,它执行以下步骤:

  1. 断言IsPropertyKey(P) 是 true
  2. 如果 currentundefined,则
    1. 如果 extensiblefalse,返回 false
    2. 如果 Oundefined,返回 true
    3. 如果 IsAccessorDescriptor(Desc) 是 true,则
      1. 为对象 O 创建一个名为 P存取器属性,其 [[Get]][[Set]][[Enumerable]][[Configurable]] 属性设置为 Desc 中相应字段的值,如果 Desc 有该字段,则设置为该字段的值,否则设置为属性的默认值
    4. 否则,
      1. 为对象 O 创建一个名为 P数据属性,其 [[Value]][[Writable]][[Enumerable]][[Configurable]] 属性设置为 Desc 中相应字段的值,如果 Desc 有该字段,则设置为该字段的值,否则设置为属性的默认值
    5. 返回 true
  3. 断言current 是一个完全填充的属性描述符
  4. 如果 Desc 没有任何字段,返回 true
  5. 如果 current.[[Configurable]]false,则
    1. 如果 Desc 有一个 [[Configurable]] 字段且 Desc.[[Configurable]]true,返回 false
    2. 如果 Desc 有一个 [[Enumerable]] 字段且 Desc.[[Enumerable]] 不等于 current.[[Enumerable]],返回 false
    3. 如果 IsGenericDescriptor(Desc) 是 false 并且 IsAccessorDescriptor(Desc) 不等于 IsAccessorDescriptor(current),返回 false
    4. 如果 IsAccessorDescriptor(current) 是 true,则
      1. 如果 Desc 有一个 [[Get]] 字段且 SameValue(Desc.[[Get]], current.[[Get]]) 是 false,返回 false
      2. 如果 Desc 有一个 [[Set]] 字段且 SameValue(Desc.[[Set]], current.[[Set]]) 是 false,返回 false
    5. 否则,如果 current.[[Writable]]false,则
      1. 如果 Desc 有一个 [[Writable]] 字段且 Desc.[[Writable]]true,返回 false
      2. 如果 Desc 有一个 [[Value]] 字段且 SameValue(Desc.[[Value]], current.[[Value]]) 是 false,返回 false
  6. 如果 O 不是 undefined,则
    1. 如果 IsDataDescriptor(current) 是 trueIsAccessorDescriptor(Desc) 是 true,则
      1. 如果 Desc 有一个 [[Configurable]] 字段,令 configurableDesc.[[Configurable]];否则令 configurablecurrent.[[Configurable]]
      2. 如果 Desc 有一个 [[Enumerable]] 字段,令 enumerableDesc.[[Enumerable]];否则令 enumerablecurrent.[[Enumerable]]
      3. 替换对象 O 中名为 P 的属性为一个存取器属性,其 [[Configurable]][[Enumerable]] 属性分别设置为 configurableenumerable,其 [[Get]][[Set]] 属性设置为 Desc 中相应字段的值,如果 Desc 有该字段,则设置为该字段的值,否则设置为属性的默认值
    2. 否则,如果 IsAccessorDescriptor(current) 是 trueIsDataDescriptor(Desc) 是 true,则
      1. 如果 Desc 有一个 [[Configurable]] 字段,令 configurableDesc.[[Configurable]];否则令 configurablecurrent.[[Configurable]]
      2. 如果 Desc 有一个 [[Enumerable]] 字段,令 enumerableDesc.[[Enumerable]];否则令 enumerablecurrent.[[Enumerable]]
      3. 替换对象 O 中名为 P 的属性为一个数据属性,其 [[Configurable]][[Enumerable]] 属性分别设置为 configurableenumerable,其 [[Value]][[Writable]] 属性设置为 Desc 中相应字段的值,如果 Desc 有该字段,则设置为该字段的值,否则设置为属性的默认值
    3. 否则,
      1. 对于 Desc 的每个字段,将对象 O 中名为 P 的属性的相应属性设置为该字段的值。
  7. 返回 true

10.1.7 [[HasProperty]]P

一个普通对象[[HasProperty]]内部方法接受参数P(一个属性键),并返回一个包含布尔值的正常完成或一个抛出完成。当被调用时,它执行以下步骤:

  1. 返回 ? OrdinaryHasPropertyO, P)。

10.1.7.1 OrdinaryHasProperty(O, P

抽象操作 OrdinaryHasProperty 接受参数 O(一个对象)和 P(一个属性键),并返回一个包含布尔值的正常完成或一个抛出完成。当被调用时,它执行以下步骤:

  1. hasOwn 为 ? O.[[GetOwnProperty]](P)。
  2. 如果 hasOwn 不是 undefined,返回 true
  3. parent 为 ? O.[[GetPrototypeOf]]()。
  4. 如果 parent 不是 null,则
    1. 返回 ? parent.[[HasProperty]](P)。
  5. 返回 false

10.1.8 [[Get]] ( P, Receiver )

[[Get]] 内部方法用于一个 普通对象 O,接受参数 P(一个 属性键)和 Receiver(一个 ECMAScript 语言值),并返回一个 正常完成记录,其中包含一个 ECMAScript 语言值,或者一个 抛出完成记录。调用时执行以下步骤:

  1. 返回 ? OrdinaryGet(O, P, Receiver).

10.1.8.1 OrdinaryGet ( O, P, Receiver )

抽象操作 OrdinaryGet 接受参数 O(一个对象)、P(一个 属性键)和 Receiver(一个 ECMAScript 语言值),并返回一个 正常完成记录,其中包含一个 ECMAScript 语言值,或者一个 抛出完成记录。调用时执行以下步骤:

  1. desc 等于 ? O.[[GetOwnProperty]](P)。
  2. 如果 descundefined,则
    1. parent 等于 ? O.[[GetPrototypeOf]]()。
    2. 如果 parentnull,返回 undefined
    3. 返回 ? parent.[[Get]](P, Receiver)。
  3. 如果 IsDataDescriptor(desc) 是 true,返回 desc.[[Value]]
  4. 断言: IsAccessorDescriptor(desc) 是 true
  5. getter 等于 desc.[[Get]]
  6. 如果 getterundefined,返回 undefined
  7. 返回 ? Call(getter, Receiver)。

10.1.9 [[Set]] ( P, V, Receiver )

普通对象(ordinary objectO[[Set]] 内部方法接受三个参数:P(属性键),V(ECMAScript 语言值),和 Receiver(ECMAScript 语言值),并返回一个完成记录,可能是包含布尔值的正常完成记录,也可能是抛出异常的完成记录。调用时执行以下步骤:

  1. 返回 ? OrdinarySet(O, P, V, Receiver)。

10.1.9.1 OrdinarySet ( O, P, V, Receiver )

抽象操作 OrdinarySet 接受四个参数:O(对象),P(属性键),V(ECMAScript 语言值),和 Receiver(ECMAScript 语言值),并返回一个完成记录,可能是包含布尔值的正常完成记录,也可能是抛出异常的完成记录。调用时执行以下步骤:

  1. ownDesc 为 ? O.[[GetOwnProperty]](P)。
  2. 返回 ? OrdinarySetWithOwnDescriptor(O, P, V, Receiver, ownDesc)。

10.1.9.2 OrdinarySetWithOwnDescriptor ( O, P, V, Receiver, ownDesc )

抽象操作 OrdinarySetWithOwnDescriptor 接受五个参数:O(对象),P(属性键),V(ECMAScript 语言值),Receiver(ECMAScript 语言值),和 ownDesc(属性描述符或 undefined),并返回一个完成记录,可能是包含布尔值的正常完成记录,也可能是抛出异常的完成记录。调用时执行以下步骤:

  1. 如果 ownDescundefined,则:
    1. parent 为 ? O.[[GetPrototypeOf]]()。
    2. 如果 parent 不为 null,则:
      1. 返回 ? parent.[[Set]](P, V, Receiver)。
    3. 否则:
      1. ownDesc 设置为属性描述符 {[[Value]]: undefined, [[Writable]]: true, [[Enumerable]]: true, [[Configurable]]: true}。
  2. 如果 IsDataDescriptor(ownDesc) 为 true,则:
    1. 如果 ownDesc.[[Writable]]false,返回 false
    2. 如果 Receiver 不是一个对象,返回 false
    3. existingDescriptor 为 ? Receiver.[[GetOwnProperty]](P)。
    4. 如果 existingDescriptor 不为 undefined,则:
      1. 如果 IsAccessorDescriptor(existingDescriptor) 为 true,返回 false
      2. 如果 existingDescriptor.[[Writable]]false,返回 false
      3. valueDesc 为属性描述符 {[[Value]]: V}。
      4. 返回 ? Receiver.[[DefineOwnProperty]](P, valueDesc)。
    5. 否则:
      1. Assert: Receiver 当前没有属性 P
      2. 返回 ? CreateDataProperty(Receiver, P, V)。
  3. Assert: IsAccessorDescriptor(ownDesc) 为 true
  4. setterownDesc.[[Set]]
  5. 如果 setterundefined,返回 false
  6. 执行 ? Call(setter, Receiver, «V»)。
  7. 返回 true

10.1.10 [[Delete]] ( P )

普通对象(ordinary objectO[[Delete]] 内部方法接受参数 P属性键),并返回一个包含布尔值的正常完成记录或一个抛出异常的完成记录。调用时执行以下步骤:

  1. 返回 ? OrdinaryDelete(O, P)。

10.1.10.1 OrdinaryDelete ( O, P )

抽象操作 OrdinaryDelete 接受两个参数:O(对象)和 P属性键),并返回一个包含布尔值的正常完成记录或一个抛出异常的完成记录。调用时执行以下步骤:

  1. desc 为 ? O.[[GetOwnProperty]](P)。
  2. 如果 descundefined,返回 true
  3. 如果 desc.[[Configurable]]true,则:
    1. O 中删除名称为 P 的自身属性。
    2. 返回 true
  4. 返回 false

10.1.11 [[OwnPropertyKeys]] ( )

普通对象(ordinary objectO[[OwnPropertyKeys]] 内部方法不接受任何参数,并返回一个包含 列表 的正常完成记录,该列表包含 属性键。调用时执行以下步骤:

  1. 返回 OrdinaryOwnPropertyKeys(O)。

10.1.11.1 OrdinaryOwnPropertyKeys ( O )

抽象操作 OrdinaryOwnPropertyKeys 接受一个参数 O(对象),并返回一个包含 列表属性键。调用时执行以下步骤:

  1. keys 为一个新的空 列表
  2. 对于 O 的每个自身 属性键 P,如果 P数组索引,按升序的数字索引顺序:
    1. P 添加到 keys 中。
  3. 对于 O 的每个自身 属性键 P,如果 P 是一个字符串P 不是 数组索引,按属性创建的升序时间顺序:
    1. P 添加到 keys 中。
  4. 对于 O 的每个自身 属性键 P,如果 P 是一个符号,按属性创建的升序时间顺序:
    1. P 添加到 keys 中。
  5. 返回 keys

10.1.12 OrdinaryObjectCreate ( proto [ , additionalInternalSlotsList ] )

抽象操作 OrdinaryObjectCreate 接受参数 proto(一个对象或 null)以及可选参数 additionalInternalSlotsList(一个 列表,包含内部槽的名称),并返回一个对象。它用于指定新的 普通对象 的运行时创建。additionalInternalSlotsList 包含必须作为对象一部分定义的附加内部槽的名称,除了 [[Prototype]][[Extensible]]。如果未提供 additionalInternalSlotsList,则使用一个新的空 列表。调用时执行以下步骤:

  1. internalSlotsList 为 « [[Prototype]], [[Extensible]] »。
  2. 如果 additionalInternalSlotsList 存在,则将 internalSlotsList 设置为 列表连接 internalSlotsListadditionalInternalSlotsList 的结果。
  3. OMakeBasicObject(internalSlotsList)。
  4. O.[[Prototype]] 设置为 proto
  5. 返回 O

尽管 OrdinaryObjectCreate 仅调用 MakeBasicObject,但它的使用传达了创建 普通对象 的意图,而不是一种特殊的对象。因此,在该规范中,它不会被任何算法调用,这些算法随后会以使结果变为非普通的方式修改对象的内部方法。创建 特殊对象 的操作直接调用 MakeBasicObject

10.1.13 OrdinaryCreateFromConstructor ( constructor, intrinsicDefaultProto [ , internalSlotsList ] )

抽象操作 OrdinaryCreateFromConstructor 接受参数 constructor(一个 构造函数)和 intrinsicDefaultProto(一个字符串),以及可选参数 internalSlotsList(一个 列表,包含内部槽的名称),并返回一个对象或抛出异常。它创建一个 普通对象,其 [[Prototype]] 值从 构造函数"prototype" 属性中获取(如果存在)。否则,使用由 intrinsicDefaultProto 指定的内建对象作为 [[Prototype]]internalSlotsList 包含必须作为对象一部分定义的附加内部槽的名称。如果未提供 internalSlotsList,则使用一个新的空 列表。调用时执行以下步骤:

  1. 断言: intrinsicDefaultProto 是本规范定义的内建对象的名称。对应的对象必须是一个内建对象,旨在作为对象的 [[Prototype]] 值。
  2. proto 为 ? GetPrototypeFromConstructor(constructor, intrinsicDefaultProto)。
  3. 如果 internalSlotsList 存在,令 slotsListinternalSlotsList
  4. 否则,令 slotsList 为一个新的空 列表
  5. 返回 OrdinaryObjectCreate(proto, slotsList)。

10.1.14 GetPrototypeFromConstructor ( constructor, intrinsicDefaultProto )

抽象操作 GetPrototypeFromConstructor 接受参数 constructor(一个 函数对象)和 intrinsicDefaultProto(一个字符串),并返回一个对象或抛出异常。它确定在创建与特定 构造函数 对应的对象时应使用的 [[Prototype]] 值。该值从 构造函数"prototype" 属性中获取(如果存在)。否则,使用由 intrinsicDefaultProto 指定的内建对象作为 [[Prototype]]。调用时执行以下步骤:

  1. 断言: intrinsicDefaultProto 是本规范定义的内建对象的名称。对应的对象必须是一个内建对象,旨在作为对象的 [[Prototype]] 值。
  2. proto 为 ? Get(constructor, "prototype")。
  3. 如果 proto 不是一个对象,则
    1. realm 为 ? GetFunctionRealm(constructor)。
    2. proto 设置为 realm 的名为 intrinsicDefaultProto 的内建对象。
  4. 返回 proto

如果 constructor 没有提供 [[Prototype]] 值,则使用的默认值是从 领域constructor 函数获取的,而不是从 正在执行的上下文 中获取。

10.1.15 RequireInternalSlot ( O, internalSlot )

抽象操作 RequireInternalSlot 接受参数 O(一个 ECMAScript 语言值)和 internalSlot(一个内部槽名称),并返回一个正常的完成包含 unused 或一个抛出完成。除非 O 是一个对象 并且具有给定的内部槽,否则会抛出异常。调用时执行以下步骤:

  1. 如果 O 不是一个对象,则抛出一个 TypeError 异常。
  2. 如果 O 不具有一个 internalSlot 内部槽,则抛出一个 TypeError 异常。
  3. 返回 unused

10.2 ECMAScript 函数对象

ECMAScript 函数对象 封装了参数化的 ECMAScript 代码,并将其封闭在词法环境中,支持对该代码的动态求值。一个 ECMAScript 函数对象 是一个 普通对象,并且具有与其他 普通对象 相同的内部槽和内部方法。一个 ECMAScript 函数对象 的代码可以是 严格模式代码(见 11.2.2)或 非严格模式代码。一个 ECMAScript 函数对象 的代码是 严格模式代码 的,被称为 严格函数。如果代码不是 严格模式代码,则称为 非严格函数

除了 [[Extensible]][[Prototype]] 外,ECMAScript 函数对象 还有在 表 30 中列出的内部槽。

表 30: ECMAScript 函数对象的内部槽
内部槽 类型 描述
[[Environment]] 一个 环境记录 函数封闭的 环境记录。在评估函数代码时用作外部环境。
[[PrivateEnvironment]] 一个 PrivateEnvironment 记录null 函数封闭的 PrivateEnvironment 记录。如果该函数没有语法上包含在类中,则为 null。在评估函数代码时,作为内部类的外部 PrivateEnvironment 使用。
[[FormalParameters]] 一个 解析节点 定义函数正式参数列表的源文本的根解析节点。
[[ECMAScriptCode]] 一个 解析节点 定义函数主体的源文本的根解析节点。
[[ConstructorKind]] basederived 函数是否是派生类 构造函数
[[Realm]] 一个 Realm 记录 函数创建的 realm,提供在评估函数时访问的任何内建对象。
[[ScriptOrModule]] 一个 脚本记录模块记录 函数创建的脚本或模块。
[[ThisMode]] lexicalstrictglobal 定义 this 引用在函数的正式参数和代码体内如何被解释。lexical 表示 this 指向词法上封闭函数的 this 值。strict 表示 this 值正好按照函数调用时提供的值使用。global 表示 this 值为 undefinednull 时解释为对 全局对象 的引用,其他的 this 值则首先传递给 ToObject
[[Strict]] 一个布尔值 如果这是一个 严格函数,则为 true;如果这是一个 非严格函数,则为 false
[[HomeObject]] 一个对象 如果函数使用了 super,这是提供 [[GetPrototypeOf]] 的对象,从而开始 super 属性的查找。
[[SourceText]] 一系列 Unicode 码点 定义函数的 源文本
[[Fields]] 一个 列表ClassFieldDefinition 记录 如果函数是一个类,则这是一个列表,表示类的非静态字段及其对应的初始化器。
[[PrivateMethods]] 一个 列表PrivateElements 如果函数是一个类,则这是一个列表,表示类的非静态私有方法和访问器。
[[ClassFieldInitializerName]] 一个字符串、一个符号、一个 私有名称empty 如果函数作为类字段的初始化器创建,则用于 NamedEvaluation 的名称;否则为 empty
[[IsClassConstructor]] 一个布尔值 指示函数是否是一个类 构造函数。如果为 true,调用该函数的 [[Call]] 将立即抛出 TypeError 异常。

所有 ECMAScript 函数对象 都有这里定义的 [[Call]] 内部方法。此外,ECMAScript 函数如果也是 构造函数,则还有 [[Construct]] 内部方法。

10.2.1 [[Call]] ( thisArgument, argumentsList )

ECMAScript 函数对象 F[[Call]] 内部方法接受参数 thisArgument(一个 ECMAScript 语言值)和 argumentsList(一个 列表,包含 ECMAScript 语言值),并返回一个 正常完成(包含一个 ECMAScript 语言值)或者一个 抛出完成。调用时执行以下步骤:

  1. callerContext当前执行上下文
  2. calleeContextPrepareForOrdinaryCall(F, undefined)。
  3. 断言: calleeContext 现在是 当前执行上下文
  4. 如果 F.[[IsClassConstructor]]true,则
    1. error 为一个新创建的 TypeError 对象。
    2. 注意:error 是在 calleeContext 中创建的,使用 F 关联的 领域记录
    3. 执行上下文栈 中移除 calleeContext,并将 callerContext 恢复为 当前执行上下文
    4. 返回 ThrowCompletion(error)。
  5. 执行 OrdinaryCallBindThis(F, calleeContext, thisArgument)。
  6. resultCompletion(OrdinaryCallEvaluateBody(F, argumentsList))。
  7. 执行上下文栈 中移除 calleeContext,并将 callerContext 恢复为 当前执行上下文
  8. 如果 result 是一个 返回完成,返回 result.[[Value]]
  9. ReturnIfAbrupt(result)。
  10. 返回 undefined

当在步骤 7 中从 执行上下文栈 中移除 calleeContext 时,如果它是挂起的并被生成器保留以便以后恢复,则不得销毁它。

10.2.1.1 PrepareForOrdinaryCall ( F, newTarget )

抽象操作 PrepareForOrdinaryCall 接受参数 F(一个 ECMAScript 函数对象)和 newTarget(一个对象或 undefined),并返回一个 执行上下文。它在调用时执行以下步骤:

  1. callerContext当前执行上下文
  2. calleeContext 为一个新的 ECMAScript 代码执行上下文
  3. calleeContext 的函数设置为 F
  4. calleeRealmF.[[Realm]]
  5. calleeContext领域 设置为 calleeRealm
  6. calleeContext 的 ScriptOrModule 设置为 F.[[ScriptOrModule]]
  7. localEnvNewFunctionEnvironment(F, newTarget)。
  8. calleeContext 的词法环境设置为 localEnv
  9. calleeContext 的变量环境设置为 localEnv
  10. calleeContext 的私有环境设置为 F.[[PrivateEnvironment]]
  11. 如果 callerContext 尚未被挂起,则挂起 callerContext
  12. calleeContext 推入 执行上下文栈calleeContext 现在是 当前执行上下文
  13. 注意:此后产生的任何异常对象都与 calleeRealm 关联。
  14. 返回 calleeContext

10.2.1.2 OrdinaryCallBindThis ( F, calleeContext, thisArgument )

抽象操作 OrdinaryCallBindThis 接受参数 F(一个 ECMAScript 函数对象)、calleeContext(一个 执行上下文)以及 thisArgument(一个 ECMAScript 语言值),并返回 unused。它在调用时执行以下步骤:

  1. thisModeF.[[ThisMode]]
  2. 如果 thisModelexical,则返回 unused
  3. calleeRealmF.[[Realm]]
  4. localEnvcalleeContext 的词法环境。
  5. 如果 thisModestrict,则:
    1. thisValuethisArgument
  6. 否则:
    1. 如果 thisArgumentundefinednull,则:
      1. globalEnvcalleeRealm.[[GlobalEnv]]
      2. Assert: globalEnv 是一个 全局环境记录
      3. thisValueglobalEnv.[[GlobalThisValue]]
    2. 否则:
      1. thisValue 为 ! ToObject(thisArgument)。
      2. 注意:ToObject 使用 calleeRealm 生成包装对象。
  7. Assert: localEnv 是一个 函数环境记录
  8. Assert: 下一步不会返回 突发完成,因为 localEnv.[[ThisBindingStatus]] 不是 initialized
  9. 执行 ! localEnv.BindThisValue(thisValue)。
  10. 返回 unused

10.2.1.3 运行时语义:EvaluateBody

语法驱动操作 语法驱动操作 EvaluateBody 接受两个参数:functionObject(一个 ECMAScript 函数对象)和 argumentsList(一个 列表,包含 ECMAScript 语言值),并返回一个 正常完成记录, 包含一个 ECMAScript 语言值 或者一个 突发完成记录。它在以下产生式中被分段定义:

FunctionBody : FunctionStatementList
  1. 返回 ? EvaluateFunctionBodyFunctionBody,参数为 functionObjectargumentsList
ConciseBody : ExpressionBody
  1. 返回 ? EvaluateConciseBodyConciseBody,参数为 functionObjectargumentsList
GeneratorBody : FunctionBody
  1. 返回 ? EvaluateGeneratorBodyGeneratorBody,参数为 functionObjectargumentsList
AsyncGeneratorBody : FunctionBody
  1. 返回 ? EvaluateAsyncGeneratorBodyAsyncGeneratorBody,参数为 functionObjectargumentsList
AsyncFunctionBody : FunctionBody
  1. 返回 ? EvaluateAsyncFunctionBodyAsyncFunctionBody,参数为 functionObjectargumentsList
AsyncConciseBody : ExpressionBody
  1. 返回 ? EvaluateAsyncConciseBodyAsyncConciseBody,参数为 functionObjectargumentsList
Initializer : = AssignmentExpression
  1. 断言argumentsList 为空。
  2. 断言functionObject.[[ClassFieldInitializerName]] 不为空。
  3. 如果 IsAnonymousFunctionDefinition(AssignmentExpression) 为 true,则
    1. value 为 ? NamedEvaluationInitializer,参数为 functionObject.[[ClassFieldInitializerName]]
  4. 否则,
    1. rhs 为 ? EvaluationAssignmentExpression
    2. value 为 ? GetValue(rhs)。
  5. 返回 完成记录 { [[Type]]: return, [[Value]]: value, [[Target]]: empty }。

尽管字段初始化器构成函数边界,调用 FunctionDeclarationInstantiation 没有任何可观察的效果,因此被省略。

ClassStaticBlockBody : ClassStaticBlockStatementList
  1. 断言argumentsList 为空。
  2. 返回 ? EvaluateClassStaticBlockBodyClassStaticBlockBody ,参数为 functionObject

10.2.1.4 OrdinaryCallEvaluateBody ( F, argumentsList )

抽象操作 OrdinaryCallEvaluateBody 接受两个参数:F(一个 ECMAScript 函数对象)和 argumentsList(一个 列表,包含 ECMAScript 语言值),并返回一个 正常完成记录, 包含一个 ECMAScript 语言值, 或者一个 突发完成记录。它在调用时执行以下步骤:

  1. 返回 ? EvaluateBodyF.[[ECMAScriptCode]],参数为 FargumentsList

10.2.2 [[Construct]] ( argumentsList, newTarget )

ECMAScript 函数对象 F[[Construct]] 内部方法接受两个参数:argumentsList(一个 列表,包含 ECMAScript 语言值)和 newTarget(一个 构造函数),并返回一个 正常完成记录,包含一个对象,或一个 抛出完成记录。它在调用时执行以下步骤:

  1. callerContext 为当前 运行执行上下文
  2. kindF.[[ConstructorKind]]
  3. 如果 kindbase,则
    1. thisArgument 为 ? OrdinaryCreateFromConstructor(newTarget, "%Object.prototype%")。
  4. calleeContextPrepareForOrdinaryCall(F, newTarget)。
  5. Assert: calleeContext 现在是 运行执行上下文
  6. 如果 kindbase,则
    1. 执行 OrdinaryCallBindThis(F, calleeContext, thisArgument)。
    2. initializeResultCompletion(InitializeInstanceElements(thisArgument, F))。
    3. 如果 initializeResult突发完成记录,则
      1. 执行上下文栈 中移除 calleeContext,并将 callerContext 恢复为 运行执行上下文
      2. 返回 ? initializeResult
  7. constructorEnvcalleeContext 的 LexicalEnvironment。
  8. resultCompletion(OrdinaryCallEvaluateBody(F, argumentsList))。
  9. 执行上下文栈 中移除 calleeContext,并将 callerContext 恢复为 运行执行上下文
  10. 如果 result返回完成记录,则
    1. 如果 result.[[Value]] 是一个对象,返回 result.[[Value]]
    2. 如果 kindbase,返回 thisArgument
    3. 如果 result.[[Value]] 不是 undefined,则抛出一个 TypeError 异常。
  11. 否则,
    1. ReturnIfAbrupt(result)。
  12. thisBinding 为 ? constructorEnv.GetThisBinding()。
  13. Assert: thisBinding 是一个对象
  14. 返回 thisBinding

10.2.3 OrdinaryFunctionCreate ( functionPrototype, sourceText, ParameterList, Body, thisMode, env, privateEnv )

抽象操作 OrdinaryFunctionCreate 接受以下参数:functionPrototype(一个对象), sourceText(一系列 Unicode 代码点),ParameterList(一个 解析节点), Body(一个 解析节点), thisModelexical-thisnon-lexical-this), env(一个 环境记录), 和 privateEnv(一个 私有环境记录null), 并返回一个 ECMAScript 函数对象。 它用于指定以默认的 [[Call]] 内部方法和无 [[Construct]] 内部方法(尽管可以通过像 MakeConstructor 这样的操作后续添加)的方式创建一个新函数。 sourceText 是要创建的函数的语法定义的源文本。调用时执行以下步骤:

  1. internalSlotsList表 30 中列出的内部槽。
  2. FOrdinaryObjectCreate(functionPrototype, internalSlotsList)。
  3. F.[[Call]] 设置为 10.2.1 中指定的定义。
  4. F.[[SourceText]] 设置为 sourceText
  5. F.[[FormalParameters]] 设置为 ParameterList
  6. F.[[ECMAScriptCode]] 设置为 Body
  7. 如果 source text matched by Body严格模式代码,则令 Stricttrue;否则令 Strictfalse
  8. F.[[Strict]] 设置为 Strict
  9. 如果 thisModelexical-this,则将 F.[[ThisMode]] 设置为 lexical
  10. 否则如果 Stricttrue,则将 F.[[ThisMode]] 设置为 strict
  11. 否则,将 F.[[ThisMode]] 设置为 global
  12. F.[[IsClassConstructor]] 设置为 false
  13. F.[[Environment]] 设置为 env
  14. F.[[PrivateEnvironment]] 设置为 privateEnv
  15. F.[[ScriptOrModule]] 设置为 GetActiveScriptOrModule()。
  16. F.[[Realm]] 设置为 当前 Realm 记录
  17. F.[[HomeObject]] 设置为 undefined
  18. F.[[Fields]] 设置为一个新的空的 列表
  19. F.[[PrivateMethods]] 设置为一个新的空的 列表
  20. F.[[ClassFieldInitializerName]] 设置为 empty
  21. lenParameterList 的期望参数数量。
  22. 执行 SetFunctionLength(F, len)。
  23. 返回 F

10.2.4 AddRestrictedFunctionProperties ( F, realm )

抽象操作 AddRestrictedFunctionProperties 接受两个参数:F(一个 函数对象) 和 realm(一个 Realm 记录),并返回 unused。 当调用时,它执行以下步骤:

  1. 断言: realm.[[Intrinsics]].[[%ThrowTypeError%]] 存在 并已初始化。
  2. throwerrealm.[[Intrinsics]].[[%ThrowTypeError%]]。
  3. 执行 ! DefinePropertyOrThrow(F, "caller", 属性描述符 { [[Get]]: thrower, [[Set]]: thrower, [[Enumerable]]: false, [[Configurable]]: true }).
  4. 执行 ! DefinePropertyOrThrow(F, "arguments", 属性描述符 { [[Get]]: thrower, [[Set]]: thrower, [[Enumerable]]: false, [[Configurable]]: true }).
  5. 返回 unused

10.2.4.1 %ThrowTypeError% ( )

这个函数是 %ThrowTypeError% 内在对象。

它是一个匿名的内置 函数对象,在每个 Realm 中定义一次。

当调用时,它执行以下步骤:

  1. 抛出一个 TypeError 异常。

这个函数的 [[Extensible]] 内部槽的值为 false

这个函数的 "length" 属性具有属性描述符 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false }。

这个函数的 "name" 属性具有属性描述符 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false }。

10.2.5 MakeConstructor ( F [ , writablePrototype [ , prototype ] ] )

抽象操作 MakeConstructor 接受一个参数 F(一个 ECMAScript 函数对象 或内置的 函数对象),以及可选参数 writablePrototype(一个布尔值)和 prototype(一个对象),并返回 unused。 它将 F 转换为一个 构造函数。当调用时,它执行以下步骤:

  1. 如果 F 是一个 ECMAScript 函数对象, 则
    1. 断言: IsConstructor(F) 为 false
    2. 断言: F 是一个可扩展的对象,且没有一个名为 "prototype" 的自身属性。
    3. F.[[Construct]] 设置为 在 10.2.2 中指定的定义。
  2. 否则,
    1. F.[[Construct]] 设置为 在 10.3.2 中指定的定义。
  3. F.[[ConstructorKind]] 设置为 base
  4. 如果 writablePrototype 不存在,将 writablePrototype 设置为 true
  5. 如果 prototype 不存在,则
    1. prototype 设置为 OrdinaryObjectCreate(%Object.prototype%)。
    2. 执行 ! DefinePropertyOrThrow(prototype, "constructor", 属性描述符 { [[Value]]: F, [[Writable]]: writablePrototype, [[Enumerable]]: false, [[Configurable]]: true }).
  6. 执行 ! DefinePropertyOrThrow(F, "prototype", 属性描述符 { [[Value]]: prototype, [[Writable]]: writablePrototype, [[Enumerable]]: false, [[Configurable]]: false }).
  7. 返回 unused

10.2.6 MakeClassConstructor ( F )

抽象操作 MakeClassConstructor 接受一个参数 F(一个 ECMAScript 函数对象),并返回 unused。当调用时,它执行以下步骤:

  1. 断言: F.[[IsClassConstructor]]false
  2. F.[[IsClassConstructor]] 设置为 true
  3. 返回 unused

10.2.7 MakeMethod ( F, homeObject )

抽象操作 MakeMethod 接受参数 F(一个 ECMAScript 函数对象)和 homeObject(一个对象),并返回 unused。 它将 F 配置为一个方法。当调用时,它执行以下步骤:

  1. F.[[HomeObject]] 设置为 homeObject
  2. 返回 unused

10.2.8 DefineMethodProperty ( homeObject, key, closure, enumerable )

抽象操作 DefineMethodProperty 接受四个参数:homeObject(一个对象),key(一个 属性键私有名称),closure(一个 函数对象),以及 enumerable(一个布尔值),并返回一个 正常完成记录, 其中包含一个 PrivateElementunused,或者是一个 突然完成。 当调用时,它执行以下步骤:

  1. 断言: homeObject 是一个普通的、可扩展的对象。
  2. 如果 key 是一个 私有名称,则
    1. 返回 PrivateElement { [[Key]]: key, [[Kind]]: method, [[Value]]: closure }。
  3. 否则,
    1. desc 为 PropertyDescriptor { [[Value]]: closure, [[Writable]]: true, [[Enumerable]]: enumerable, [[Configurable]]: true }。
    2. 执行 ? DefinePropertyOrThrow(homeObject, key, desc)。
    3. 注:DefinePropertyOrThrow 仅在尝试定义一个类静态方法时,如果 key"prototype",才会返回 突然完成
    4. 返回 unused

10.2.9 SetFunctionName ( F, name [ , prefix ] )

抽象操作 SetFunctionName 接受两个必需参数和一个可选参数:F(一个 函数对象)和 name(一个 属性键私有名称),以及一个可选的 prefix(一个字符串),并返回 unused。它将一个 "name" 属性添加到 F 上。它在调用时执行以下步骤:

  1. 断言: F 是一个可扩展的对象,并且没有 "name" 自有属性。
  2. 如果 name 是一个符号,则
    1. descriptionname[[Description]] 值。
    2. 如果 descriptionundefined, 将 name 设置为空字符串。
    3. 否则,将 name 设置为 字符串连接, 包含 "["description"]"
  3. 否则,如果 name 是一个 私有名称,则
    1. name 设置为 name[[Description]]
  4. 如果 F 有一个 [[InitialName]] 内部槽,则
    1. F.[[InitialName]] 设置为 name
  5. 如果 prefix 存在,则
    1. name 设置为 字符串连接, 包含 prefix、代码单元 0x0020(空格)和 name
    2. 如果 F 有一个 [[InitialName]] 内部槽,则
      1. 可选地,将 F.[[InitialName]] 设置为 name
  6. 执行 ! DefinePropertyOrThrow(F, "name",属性描述符 { [[Value]]: name, [[Writable]]: false[[Enumerable]]: false[[Configurable]]: true }).
  7. 返回 unused

10.2.10 SetFunctionLength ( F, length )

抽象操作 SetFunctionLength 接受两个参数:F(一个 函数对象)和 length(一个非负的 整数 或 +∞),并返回 unused。它将一个 "length" 属性添加到 F 上。它在调用时执行以下步骤:

  1. 断言: F 是一个可扩展的对象,并且没有 "length" 自有属性。
  2. 执行 ! DefinePropertyOrThrow(F, "length",属性描述符 { [[Value]]: 𝔽(length), [[Writable]]: false[[Enumerable]]: false[[Configurable]]: true }).
  3. 返回 unused

10.2.11 FunctionDeclarationInstantiation ( func, argumentsList )

抽象操作 FunctionDeclarationInstantiation 接受两个参数:func(一个 ECMAScript 函数对象)和 argumentsList(一个 列表,其中包含 ECMAScript 语言值),并返回一个 正常完成 包含 unused 或一个 突然完成func 是为其建立 执行上下文 的函数对象。

注 1

当为评估 ECMAScript 函数建立执行上下文时,会创建一个新的 函数环境记录, 并在该 环境记录 中实例化每个形式参数的绑定。 函数体中的每个声明也会被实例化。如果函数的形式参数没有包含任何默认值初始化器,则函数体中的声明会在与参数相同的 环境记录 中实例化。如果存在默认值参数初始化器,则为函数体声明创建第二个 环境记录。形式参数和函数会在 FunctionDeclarationInstantiation 过程中初始化。所有其他绑定则在函数体评估期间初始化。

它在调用时执行以下步骤:

  1. calleeContext正在执行的执行上下文
  2. codefunc.[[ECMAScriptCode]]
  3. strictfunc.[[Strict]]
  4. formalsfunc.[[FormalParameters]]
  5. parameterNames绑定名称formals
  6. 如果 parameterNames 有任何重复项,令 hasDuplicatestrue。否则,令 hasDuplicatesfalse
  7. simpleParameterList简单参数列表formals
  8. hasParameterExpressions包含表达式formals
  9. varNames变量声明名称code
  10. varDeclarations变量作用域声明code
  11. lexicalNames词法声明名称code
  12. functionNames 是一个新的空的 列表
  13. functionsToInitialize 是一个新的空的 列表
  14. 对于 varDeclarations 的每一个元素 d, 按照反向 列表 顺序,执行以下操作
    1. 如果 d 既不是 变量声明 也不是 ForBinding 也不是 BindingIdentifier,则
      1. 断言: d 要么是 函数声明, 要么是 生成器声明, 要么是 异步函数声明, 要么是 异步生成器声明
      2. fn绑定名称 的唯一元素。
      3. 如果 functionNames 不包含 fn,则
        1. fn 插入到 functionNames 的第一个位置。
        2. 注: 如果有多个相同名称的函数声明,将使用最后一个声明。
        3. d 插入到 functionsToInitialize 的第一个位置。
  15. argumentsObjectNeededtrue
  16. 如果 func.[[ThisMode]]lexical,则
    1. 注: 箭头函数永远没有 arguments 对象。
    2. argumentsObjectNeeded 设置为 false
  17. 否则,如果 parameterNames 包含 "arguments",则
    1. argumentsObjectNeeded 设置为 false
  18. 否则,如果 hasParameterExpressionsfalse,则
    1. 如果 functionNames 包含 "arguments"lexicalNames 包含 "arguments",则
      1. argumentsObjectNeeded 设置为 false
  19. 如果 stricttruehasParameterExpressionsfalse,则
    1. 注: 只需要一个 环境记录 来处理参数,因为在 eval 中的调用在 严格模式代码 中不能 创建在 eval 外部可见的新绑定。
    2. envcalleeContext 的 词法环境。
  20. 否则,
    1. 注: 需要一个单独的 环境记录 以确保由 直接 eval 调用在形式参数列表中创建的绑定在参数声明的环境之外。
    2. calleeEnvcalleeContext 的 词法环境。
    3. envNewDeclarativeEnvironment(calleeEnv)。
    4. 断言: calleeContext 的变量环境是 calleeEnv
    5. calleeContext 的词法环境设置为 env
  21. 对于 parameterNames 中的每个字符串 paramName,执行
    1. alreadyDeclared 为 ! env.HasBinding(paramName)。
    2. 注: 早期错误 确保重复的参数名称只能出现在 非严格模式函数 中,并且这些函数没有参数默认值或剩余参数。
    3. 如果 alreadyDeclaredfalse,则
      1. 执行 ! env.CreateMutableBinding(paramName, false)。
      2. 如果 hasDuplicatestrue,则
        1. 执行 ! env.InitializeBinding(paramName, undefined)。
  22. 如果 argumentsObjectNeededtrue,则
    1. 如果 stricttruesimpleParameterListfalse,则
      1. aoCreateUnmappedArgumentsObject(argumentsList)。
    2. 否则,
      1. 注: 映射的参数对象仅在 非严格模式函数 中提供,并且这些函数没有剩余参数、参数默认值初始化器或任何解构参数。
      2. aoCreateMappedArgumentsObject(func, formals, argumentsList, env)。
    3. 如果 stricttrue,则
      1. 执行 ! env.CreateImmutableBinding("arguments", false)。
      2. 注: 在 严格模式代码 中,早期错误 防止尝试对该绑定进行赋值,因此其可变性不可观察。
    4. 否则,
      1. 执行 ! env.CreateMutableBinding("arguments", false)。
    5. 执行 ! env.InitializeBinding("arguments", ao)。
    6. parameterBindingslist-concatenationparameterNames 和 « "arguments" »。
  23. 否则,
    1. parameterBindingsparameterNames
  24. iteratorRecordCreateListIteratorRecord(argumentsList)。
  25. 如果 hasDuplicatestrue,则
    1. 执行 ? IteratorBindingInitializationformals,使用参数 iteratorRecordundefined
  26. 否则,
    1. 执行 ? IteratorBindingInitializationformals,使用参数 iteratorRecordenv
  27. 如果 hasParameterExpressionsfalse,则
    1. 注: 仅需要一个 环境记录 来处理参数和顶级变量。
    2. instantiatedVarNames列表 parameterBindings 的副本。
    3. 对于 varNames 中的每个元素 n,执行
      1. 如果 instantiatedVarNames 不包含 n,则
        1. n 添加到 instantiatedVarNames
        2. 执行 ! env.CreateMutableBinding(n, false)。
        3. 执行 ! env.InitializeBinding(n, undefined)。
    4. varEnvenv
  28. 否则,
    1. 注: 需要一个单独的 环境记录 来确保在形式参数列表中创建的闭包无法访问函数体中的声明。
    2. varEnvNewDeclarativeEnvironment(env)。
    3. calleeContext 的 VariableEnvironment 设置为 varEnv
    4. instantiatedVarNames 为一个新的空 列表
    5. 对于 varNames 中的每个元素 n,执行
      1. 如果 instantiatedVarNames 不包含 n,则
        1. n 添加到 instantiatedVarNames
        2. 执行 ! varEnv.CreateMutableBinding(n, false)。
        3. 如果 parameterBindings 不包含 n,或 functionNames 包含 n,则
          1. initialValueundefined
        4. 否则,
          1. initialValue 为 ! env.GetBindingValue(n, false)。
        5. 执行 ! varEnv.InitializeBinding(n, initialValue)。
        6. 注: 与形式参数同名的变量最初具有与相应初始化参数相同的值。
  29. 注: 附录 B.3.2.1 在此处添加了额外的步骤。
  30. 如果 strictfalse,则
    1. lexEnvNewDeclarativeEnvironment(varEnv)。
    2. 注: 非严格模式函数 使用单独的 环境记录 处理顶级词法声明,以便 直接 eval 可以确定 eval 代码引入的任何 var 范围声明是否与已有的顶级词法范围声明冲突。对于 严格模式函数 不需要这样做,因为严格模式 直接 eval 总是将所有声明放入新的 环境记录
  31. 否则,
    1. lexEnvvarEnv
  32. calleeContext 的 LexicalEnvironment 设置为 lexEnv
  33. lexDeclarations词法作用域声明code
  34. 对于 lexDeclarations 中的每个元素 d,执行
    1. 注: 词法声明的名称不能与函数/生成器声明、形式参数或 var 名称相同。词法声明的名称仅在此处实例化,但不初始化。
    2. 对于 d绑定名称 中的每个元素 dn,执行
      1. 如果 是常量声明dtrue,则
        1. 执行 ! lexEnv.CreateImmutableBinding(dn, true)。
      2. 否则,
        1. 执行 ! lexEnv.CreateMutableBinding(dn, false)。
  35. privateEnvcalleeContext 的 PrivateEnvironment。
  36. 对于 functionsToInitialize 中的每个 解析节点 f,执行
    1. fnf绑定名称 的唯一元素。
    2. fo实例化函数对象f,参数为 lexEnvprivateEnv
    3. 执行 ! varEnv.SetMutableBinding(fn, fo, false)。
  37. 返回 unused
注 2

B.3.2 提供了上述算法的扩展,以确保与早于 ECMAScript 2015 的 web 浏览器实现的向后兼容性。

10.3 内置函数对象

内置的 函数对象 是一个 普通对象;它必须满足 普通对象10.1 中规定的要求。

除了每个 普通对象 所需的内部插槽(见 10.1),内置的 函数对象 还必须具有以下内部插槽:

  • [[Realm]],一个 Realm 记录,表示创建该函数的 realm
  • [[InitialName]],一个字符串,表示函数的初始名称。它由 20.2.3.5 使用。

内置 函数对象[[Prototype]] 内部插槽的初始值是 %Function.prototype%,除非另有说明。

内置 函数对象 必须具有一个符合 10.3.1 中定义的 [[Call]] 内部方法。

内置 函数对象 仅在被描述为“构造函数”时,或某些算法在本规范中明确设置其 [[Construct]] 内部方法时,才具有 [[Construct]] 内部方法。这样的 [[Construct]] 内部方法必须符合 10.3.2 中定义的。

实现可以提供本规范中未定义的额外内置 函数对象

10.3.1 [[Call]] ( thisArgument, argumentsList )

内置 函数对象 F[[Call]] 内部方法接受参数 thisArgument(一个 ECMAScript 语言值)和 argumentsList(一个 列表ECMAScript 语言值),并返回一个正常完成记录(包含一个 ECMAScript 语言值)或一个抛出完成记录。

  1. 返回 ? BuiltinCallOrConstruct(F, thisArgument, argumentsList, undefined).

10.3.2 [[Construct]] ( argumentsList, newTarget )

内置 函数对象 F[[Construct]] 内部方法(当该方法存在时)接受参数 argumentsList(一个 列表ECMAScript 语言值)和 newTarget(一个 构造函数),并返回一个正常完成记录(包含一个对象)或一个抛出完成记录。

  1. 返回 ? BuiltinCallOrConstruct(F, uninitialized, argumentsList, newTarget).

10.3.3 BuiltinCallOrConstruct ( F, thisArgument, argumentsList, newTarget )

抽象操作 BuiltinCallOrConstruct 接受以下参数:F(一个内置的 函数对象)、thisArgument(一个 ECMAScript 语言值uninitialized)、argumentsList(一个 列表ECMAScript 语言值)、以及 newTarget(一个 构造函数undefined)。它返回一个正常完成记录(包含一个 ECMAScript 语言值)或一个抛出完成记录。调用时执行以下步骤:

  1. callerContext 为当前 运行中的执行上下文
  2. 如果 callerContext 尚未被挂起,则挂起 callerContext
  3. calleeContext 为一个新的 执行上下文
  4. calleeContext 的函数设置为 F
  5. calleeRealmF.[[Realm]]
  6. calleeContextRealm 设置为 calleeRealm
  7. calleeContext 的 ScriptOrModule 设置为 null
  8. 执行对 calleeContext 的任何必要的 实现定义 初始化。
  9. calleeContext 推入 执行上下文栈calleeContext 现在是 运行中的执行上下文
  10. result完成记录,即以符合 F 规范的方式评估 F 的结果。如果 thisArgumentuninitialized,则 this 的值为未初始化;否则,thisArgument 提供 this 值。argumentsList 提供命名参数。newTarget 提供 NewTarget 值。
  11. 注:如果 F 在本文件中定义,“F 的规范”是通过算法步骤或其他方式指定的行为。
  12. 执行上下文栈 中移除 calleeContext,并将 callerContext 恢复为 运行中的执行上下文
  13. 返回 ? result
Note

calleeContext执行上下文栈 中移除时,如果它已经被挂起并被一个可访问的生成器保留以备后续恢复,则不得销毁。

10.3.4 CreateBuiltinFunction ( behaviour, length, name, additionalInternalSlotsList [ , realm [ , prototype [ , prefix ] ] ] )

抽象操作 CreateBuiltinFunction 接受以下参数:behaviour(一个 抽象闭包、一组算法步骤,或本规范中定义的其他函数行为)、length(一个非负的 整数 或 +∞)、name(一个 属性键 或一个 私有名称)、以及 additionalInternalSlotsList(一个 列表,包含内部槽的名称),和可选参数 realm(一个 Realm 记录)、prototype(一个对象或 null),以及 prefix(一个字符串)。该操作返回一个 函数对象additionalInternalSlotsList 包含必须作为对象的一部分定义的额外内部槽的名称。此操作创建一个内置的 函数对象。它执行以下步骤:

  1. 如果 realm 不存在,则将 realm 设置为 当前 Realm 记录
  2. 如果 prototype 不存在,则将 prototype 设置为 realm.[[Intrinsics]].[[%Function.prototype%]]。
  3. internalSlotsList 为一个 列表,包含所有 10.3 对于即将创建的内置 函数对象 所需的内部槽的名称。
  4. additionalInternalSlotsList 的元素附加到 internalSlotsList
  5. func 为一个新的内置 函数对象,当调用时,它会根据 behaviour 的描述,使用提供的参数作为 behaviour 指定的相应参数的值。新的 函数对象 具有名称为 internalSlotsList 元素的内部槽,并具有一个 [[InitialName]] 内部槽。
  6. func.[[Prototype]] 设置为 prototype
  7. func.[[Extensible]] 设置为 true
  8. func.[[Realm]] 设置为 realm
  9. func.[[InitialName]] 设置为 null
  10. 执行 SetFunctionLength(func, length)。
  11. 如果 prefix 不存在,则
    1. 执行 SetFunctionName(func, name)。
  12. 否则,
    1. 执行 SetFunctionName(func, name, prefix)。
  13. 返回 func

本规范中定义的每个内置函数都是通过调用 CreateBuiltinFunction 抽象操作创建的。

10.4 内置的异域对象内部方法和槽

本规范定义了几种内置的 异域对象。这些对象的行为通常类似于 普通对象,但在一些特定情况下有所不同。以下 异域对象 使用 普通对象 的内部方法,除非在下文中明确另有说明:

10.4.1 绑定函数异域对象

绑定函数异域对象 是一种 异域对象,它封装了另一个 函数对象。一个 绑定函数异域对象 是可调用的(它有一个 [[Call]] 内部方法,并且可能有一个 [[Construct]] 内部方法)。调用一个 绑定函数异域对象 通常会调用它封装的函数。

一个对象是一个 绑定函数异域对象,如果它的 [[Call]] 和(如果适用的话)[[Construct]] 内部方法使用以下实现,并且它的其他基本内部方法使用在 10.1 中找到的定义。这些方法是在 BoundFunctionCreate 中安装的。

绑定函数异域对象 不具有 ECMAScript 函数对象 中列出的内部槽,这些槽在 表30 中列出。相反,它们具有 表31 中列出的内部槽,此外还有 [[Prototype]][[Extensible]]

表31:绑定函数异域对象的内部槽
内部槽 类型 描述
[[BoundTargetFunction]] 可调用的对象 封装的 函数对象
[[BoundThis]] 一个 ECMAScript 语言值 在调用封装的函数时始终传递的 this 值。
[[BoundArguments]] 一个 列表ECMAScript 语言值 一个值的列表,其元素作为对封装函数的任何调用的第一个参数。

10.4.1.1 [[Call]] ( thisArgument, argumentsList )

[[Call]] 内部方法用于一个 绑定函数异域对象 F,它接受参数 thisArgument(一个 ECMAScript 语言值)和 argumentsList(一个 列表ECMAScript 语言值),并返回一个包含 ECMAScript 语言值正常完成记录,或者一个 抛出完成记录。它在被调用时执行以下步骤:

  1. targetF.[[BoundTargetFunction]]
  2. boundThisF.[[BoundThis]]
  3. boundArgsF.[[BoundArguments]]
  4. args列表连接boundArgsargumentsList
  5. 返回 ? Call(target, boundThis, args)。

10.4.1.2 [[Construct]] ( argumentsList, newTarget )

[[Construct]] 内部方法用于一个 绑定函数异域对象 F,它接受参数 argumentsList(一个 列表ECMAScript 语言值)和 newTarget(一个 构造函数),并返回一个包含 Object 的 正常完成记录,或者一个 抛出完成记录。它在被调用时执行以下步骤:

  1. targetF.[[BoundTargetFunction]]
  2. 断言: IsConstructor(target) 为 true
  3. boundArgsF.[[BoundArguments]]
  4. args列表连接boundArgsargumentsList
  5. 如果 SameValue(F, newTarget) 为 true,则将 newTarget 设置为 target
  6. 返回 ? Construct(target, args, newTarget)。

10.4.1.3 BoundFunctionCreate ( targetFunction, boundThis, boundArgs )

抽象操作 BoundFunctionCreate 接受参数 targetFunction(一个 函数对象)、boundThis(一个 ECMAScript 语言值)和 boundArgs(一个 列表ECMAScript 语言值),并返回一个包含函数对象的 正常完成记录,或者一个 抛出完成记录。它用于指定创建新的 绑定函数异域对象。它在被调用时执行以下步骤:

  1. proto 为 ? targetFunction.[[GetPrototypeOf]]()。
  2. internalSlotsList 为 «[[Prototype]][[Extensible]]» 和在 表 31 中列出的内部槽的 列表连接
  3. objMakeBasicObject(internalSlotsList)。
  4. obj.[[Prototype]] 设置为 proto
  5. obj.[[Call]] 设置为在 10.4.1.1 中描述的内容。
  6. 如果 IsConstructor(targetFunction) 为 true,则:
    1. obj.[[Construct]] 设置为在 10.4.1.2 中描述的内容。
  7. obj.[[BoundTargetFunction]] 设置为 targetFunction
  8. obj.[[BoundThis]] 设置为 boundThis
  9. obj.[[BoundArguments]] 设置为 boundArgs
  10. 返回 obj

10.4.2 数组异域对象

数组是一个 异域对象,它对 数组索引 属性键 给予特殊处理(见 6.1.7)。一个属性的 属性名 是一个 数组索引 时,这个属性也被称为 元素。每个数组都有一个不可配置的 "length" 属性,其值始终是一个非负的 整数,其 数学值 严格小于 232"length" 属性的值在数值上大于每个其名称为 数组索引 的自身属性的名称;每当创建或改变数组的自身属性时,会根据需要调整其他属性以保持这一不变性。具体来说,每当添加一个名称为 数组索引 的自身属性时,"length" 属性的值会被必要地更改为比该 数组索引 的数值大 1;并且每当 "length" 属性的值被更改时,每个其名称为 数组索引 的自身属性,其值不小于新长度时都会被删除。这一约束仅适用于数组的自身属性,不受可能从其原型继承的 "length"数组索引 属性的影响。

一个对象是一个 数组异域对象(或简称为数组),如果它的 [[DefineOwnProperty]] 内部方法使用以下实现,并且它的其他基本内部方法使用在 10.1 中找到的定义。这些方法被安装在 ArrayCreate 中。

10.4.2.1 [[DefineOwnProperty]] ( P, Desc )

[[DefineOwnProperty]] 内部方法在 数组 异域对象 A 中接受参数 P(一个 属性键)和 Desc (一个 属性描述符),并返回 一个 正常完成记录,其中包含 一个布尔值或一个 抛出完成记录。调用时,它 执行以下步骤:

  1. 如果 P"length",则
    1. 返回 ? ArraySetLength(A, Desc).
  2. 否则,如果 P 是一个 数组索引,则
    1. lengthDescOrdinaryGetOwnProperty(A, "length").
    2. Assert: IsDataDescriptor(lengthDesc) 是 true
    3. Assert: lengthDesc.[[Configurable]]false
    4. lengthlengthDesc.[[Value]]
    5. Assert: length 是一个非负的 整数
    6. index 为 ! ToUint32(P)。
    7. 如果 indexlengthlengthDesc.[[Writable]]false,则返回 false
    8. succeeded 为 ! OrdinaryDefineOwnProperty(A, P, Desc)。
    9. 如果 succeededfalse,则返回 false
    10. 如果 indexlength,则
      1. lengthDesc.[[Value]] 设置为 index + 1𝔽
      2. succeeded 设置为 ! OrdinaryDefineOwnProperty(A, "length", lengthDesc)。
      3. Assert: succeededtrue
    11. 返回 true
  3. 返回 ? OrdinaryDefineOwnProperty(A, P, Desc)。

10.4.2.2 ArrayCreate ( length [ , proto ] )

抽象操作 ArrayCreate 接受参数 length(一个非负的 整数) 和一个可选参数 proto(一个对象),并返回一个 正常完成记录,其中包含 一个 数组异域对象 或一个 抛出完成记录。它用于指定创建新的数组。调用时,它执行以下步骤:

  1. 如果 length > 232 - 1,抛出一个 RangeError 异常。
  2. 如果 proto 不存在,将 proto 设置为 %Array.prototype%
  3. AMakeBasicObject[[Prototype]], [[Extensible]] »)。
  4. A.[[Prototype]] 设置为 proto
  5. A.[[DefineOwnProperty]] 设置为在 10.4.2.1 中规定的方式。
  6. 执行 ! OrdinaryDefineOwnProperty(A, "length", 属性描述符 { [[Value]]: 𝔽(length), [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false })。
  7. 返回 A

10.4.2.3 ArraySpeciesCreate ( originalArray, length )

抽象操作 ArraySpeciesCreate 接受两个参数:originalArray(一个对象)和 length(一个非负的 整数),并返回一个对象,可能是 正常完成记录,也可能是一个 抛出完成记录。它用于指定使用从 originalArray 派生的 构造函数 创建一个新的数组或类似对象。它并不强制 构造函数 函数返回一个数组。调用时,它执行以下步骤:

  1. isArray 为 ? IsArray(originalArray)。
  2. 如果 isArrayfalse,返回 ? ArrayCreate(length)。
  3. C 为 ? Get(originalArray, "constructor")。
  4. 如果 IsConstructor(C) 为 true,则
    1. thisRealm当前 Realm 记录
    2. realmC 为 ? GetFunctionRealm(C)。
    3. 如果 thisRealmrealmC 不是同一个 Realm 记录,则
      1. 如果 SameValue(C, realmC.[[Intrinsics]].[[%Array%]]) 为 true,则将 C 设置为 undefined
  5. 如果 C 是一个对象,则
    1. C 设置为 ? Get(C, @@species)。
    2. 如果 Cnull,将 C 设置为 undefined
  6. 如果 Cundefined,返回 ? ArrayCreate(length)。
  7. 如果 IsConstructor(C) 为 false,抛出一个 TypeError 异常。
  8. 返回 ? Construct(C, « 𝔽(length)  »)。

如果 originalArray 是使用标准内置 Array 构造函数 创建的,并且它的 Realm运行时执行上下文Realm 不同,则在 运行时执行上下文Realm 中创建一个新的 Array。这保持了与历史上在使用 ArraySpeciesCreate 定义的 Array.prototype 方法时的浏览器兼容性。

10.4.2.4 ArraySetLength ( A, Desc )

抽象操作 ArraySetLength 接受两个参数:A(一个数组)和 Desc(一个 属性描述符),并返回一个 正常完成记录,包含一个布尔值,或者一个 抛出完成记录。调用时,它执行以下步骤:

  1. 如果 Desc 没有 [[Value]] 字段,则
    1. 返回 ! OrdinaryDefineOwnProperty(A, "length", Desc).
  2. newLenDescDesc 的一个副本。
  3. newLen 为 ? ToUint32(Desc.[[Value]])。
  4. numberLen 为 ? ToNumber(Desc.[[Value]])。
  5. 如果 SameValueZero(newLen, numberLen) 为 false,则抛出一个 RangeError 异常。
  6. newLenDesc.[[Value]] 设置为 newLen
  7. oldLenDesc 为 ? OrdinaryGetOwnProperty(A, "length")。
  8. AssertIsDataDescriptor(oldLenDesc) 为 true
  9. AssertoldLenDesc.[[Configurable]]false
  10. oldLenoldLenDesc.[[Value]]
  11. 如果 newLenoldLen,则
    1. 返回 ! OrdinaryDefineOwnProperty(A, "length", newLenDesc).
  12. 如果 oldLenDesc.[[Writable]]false,返回 false
  13. 如果 newLenDesc 没有 [[Writable]] 字段,或者 newLenDesc.[[Writable]]true,则
    1. newWritabletrue
  14. 否则,
    1. 注意:将 [[Writable]] 属性设置为 false 是延迟的,以防某些元素无法被删除。
    2. newWritablefalse
    3. newLenDesc.[[Writable]] 设置为 true
  15. succeeded 为 ! OrdinaryDefineOwnProperty(A, "length", newLenDesc)。
  16. 如果 succeededfalse,则返回 false
  17. 对于 A 中每个拥有的 属性键 P,其中 P 是一个 数组索引,并且 ! ToUint32(P) ≥ newLen,按降序数字索引顺序,执行
    1. deleteSucceeded 为 ! A.[[Delete]](P)。
    2. 如果 deleteSucceededfalse,则
      1. newLenDesc.[[Value]] 设置为 ! ToUint32(P) + 1𝔽
      2. 如果 newWritablefalse,则将 newLenDesc.[[Writable]] 设置为 false
      3. 执行 ! OrdinaryDefineOwnProperty(A, "length", newLenDesc)。
      4. 返回 false
  18. 如果 newWritablefalse,则
    1. succeeded 设置为 ! OrdinaryDefineOwnProperty(A, "length", 属性描述符 { [[Writable]]false } )。
    2. Assertsucceededtrue
  19. 返回 true

在步骤 34 中,如果 Desc.[[Value]] 是一个对象,则其 valueOf 方法会被调用两次。这是从本规范第2版开始规定的遗留行为。

10.4.3 字符串异域对象

字符串对象是一个封装了字符串值的 异域对象,它暴露出虚拟的 整数索引 数据属性 对应于字符串值的每个代码单元元素。字符串异域对象 总是有一个名为 "length"数据属性,其值是封装的字符串值的长度。 这些代码单元数据属性和 "length" 属性都是不可写的且不可配置的。

如果一个对象的 [[GetOwnProperty]][[DefineOwnProperty]][[OwnPropertyKeys]] 内部方法使用以下实现,并且它的其他基本内部方法使用在 10.1 中找到的定义, 那么该对象就是一个 字符串异域对象 (或简称字符串对象)。这些方法被安装在 StringCreate 中。

字符串异域对象 拥有与 普通对象 相同的内部插槽。它们还有一个 [[StringData]] 内部插槽。

10.4.3.1 [[GetOwnProperty]] ( P )

一个 字符串异域对象 S[[GetOwnProperty]] 内部方法接收一个参数 P(一个 属性键),并返回一个 正常完成,其中包含一个 属性描述符undefined。它在被调用时执行以下步骤:

  1. descOrdinaryGetOwnProperty(S, P).
  2. 如果 desc 不为 undefined,则返回 desc
  3. 返回 StringGetOwnProperty(S, P).

10.4.3.2 [[DefineOwnProperty]] ( P, Desc )

一个 字符串异域对象 S[[DefineOwnProperty]] 内部方法接收两个参数:P(一个 属性键)和 Desc(一个 属性描述符),并返回一个 正常完成,其中包含一个布尔值。它在被调用时执行以下步骤:

  1. stringDescStringGetOwnProperty(S, P).
  2. 如果 stringDesc 不为 undefined,则:
    1. extensibleS.[[Extensible]]
    2. 返回 IsCompatiblePropertyDescriptor(extensible, Desc, stringDesc).
  3. 返回 ! OrdinaryDefineOwnProperty(S, P, Desc).

10.4.3.3 [[OwnPropertyKeys]] ( )

一个 字符串异域对象 O[[OwnPropertyKeys]] 内部方法不接受任何参数,并返回一个 正常完成,其中包含一个 属性键列表。它在被调用时执行以下步骤:

  1. keys 为一个新的空 列表
  2. strO.[[StringData]]
  3. 断言: str 是一个字符串
  4. lenstr 的长度。
  5. 对每一个整数 i,使得 0 ≤ i < len,按升序执行:
    1. 将 ! ToString(𝔽(i)) 追加到 keys
  6. O 的每一个自有属性键 P,使得 P 是一个 数组索引 并且 ! ToIntegerOrInfinity(P) ≥ len,按升序的数字索引顺序执行:
    1. P 追加到 keys
  7. O 的每一个自有属性键 P,使得 P 是一个 字符串 并且 P 不是一个 数组索引,按属性创建的时间顺序执行:
    1. P 追加到 keys
  8. O 的每一个自有属性键 P,使得 P 是一个 符号,按属性创建的时间顺序执行:
    1. P 追加到 keys
  9. 返回 keys

10.4.3.4 StringCreate ( value, prototype )

抽象操作 StringCreate 接受两个参数:value(一个字符串)和 prototype(一个对象),并返回一个 字符串异域对象。它用于指定新 字符串异域对象 的创建。它在调用时执行以下步骤:

  1. SMakeBasicObject[[Prototype]], [[Extensible]], [[StringData]] »)。
  2. S.[[Prototype]] 设置为 prototype
  3. S.[[StringData]] 设置为 value
  4. S.[[GetOwnProperty]] 设置为 10.4.3.1 中指定的内容。
  5. S.[[DefineOwnProperty]] 设置为 10.4.3.2 中指定的内容。
  6. S.[[OwnPropertyKeys]] 设置为 10.4.3.3 中指定的内容。
  7. lengthvalue 的长度。
  8. 执行 ! DefinePropertyOrThrow(S, "length", 属性描述符 { [[Value]]: 𝔽(length), [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false })。
  9. 返回 S

10.4.3.5 StringGetOwnProperty ( S, P )

抽象操作 StringGetOwnProperty 接受两个参数:S(一个具有 [[StringData]] 内部槽的对象)和 P(一个 属性键),并返回一个 属性描述符undefined。它在调用时执行以下步骤:

  1. 如果 P 不是一个字符串,返回 undefined
  2. indexCanonicalNumericIndexString(P)。
  3. 如果 indexundefined,返回 undefined
  4. 如果 IsIntegralNumber(index) 是 false,返回 undefined
  5. 如果 index-0𝔽,返回 undefined
  6. strS.[[StringData]]
  7. Assert: str 是一个字符串
  8. lenstr 的长度。
  9. 如果 (index) < 0 或 len(index),返回 undefined
  10. resultStrstr(index) 到 (index) + 1 的子字符串。
  11. 返回属性描述符 { [[Value]]: resultStr, [[Writable]]: false, [[Enumerable]]: true, [[Configurable]]: false }。

10.4.4 Arguments Exotic Objects

大多数 ECMAScript 函数会向其代码提供一个 arguments 对象。根据函数定义的特性,其 arguments 对象可能是一个 普通对象arguments 特殊对象。一个 arguments 特殊对象 是一种 特殊对象,其 数组索引 属性映射到其关联 ECMAScript 函数的正式参数绑定。

如果一个对象的内部方法使用以下实现(未在此处指定的使用 10.1 中找到的实现),则该对象是一个 arguments 特殊对象。这些方法由 CreateMappedArgumentsObject 安装。

Note 1

虽然 CreateUnmappedArgumentsObject 被归入本条款,但它创建的是一个 普通对象,而不是一个 arguments 特殊对象

Arguments 特殊对象 具有与 普通对象 相同的内部槽。它们还具有一个 [[ParameterMap]] 内部槽。普通 arguments 对象也具有一个 [[ParameterMap]] 内部槽,其值始终为 undefined。对于普通 arguments 对象,[[ParameterMap]] 内部槽仅由 Object.prototype.toString (20.1.3.6) 用于识别它们。

Note 2

一个 整数索引 数据属性arguments 特殊对象 的数字名称值小于 相应 函数对象 的正式参数数量时,初始时它们的值与函数的 执行上下文 中相应的参数绑定共享。这 意味着,改变属性会改变相应的参数绑定的值,反之亦然。如果删除该属性后重新定义它,或者如果该属性被改变为 存取属性,则这种对应关系会中断。如果 arguments 对象是一个 普通对象,则其属性的值仅是传递给函数的参数的副本,属性值与正式参数值之间没有动态关联。

Note 3

ParameterMap 对象及其属性值用作指定 arguments 对象与参数绑定之间对应关系的设备。ParameterMap 对象及其属性值并不直接从 ECMAScript 代码中可观察。ECMAScript 实现不需要实际创建或使用此类对象来实现指定的语义。

Note 4

普通 arguments 对象定义了一个不可配置的 存取属性,其名称为 "callee",在访问时会抛出 TypeError 异常。对于 arguments 特殊对象"callee" 属性具有更具体的意义,这些对象仅为某些 非严格模式函数 创建。普通变体中的该属性定义存在是为了确保符合 ECMAScript 规范的实现不会以其他方式定义该属性。

Note 5

ECMAScript 对 arguments 特殊对象 的实现历史上包含了一个名为 "caller"存取属性。在 ECMAScript 2017 之前,规范中包括了在普通 arguments 对象上定义一个抛出异常的 "caller" 属性。由于实现不再包含此扩展,ECMAScript 2017 删除了对抛出异常的 "caller" 存取器的要求。

10.4.4.1 [[GetOwnProperty]] ( P )

[[GetOwnProperty]] 内部方法用于 arguments 特殊对象 args,接受一个参数 P(一个 属性键),并 返回一个 正常完成记录,该记录包含 一个 属性描述符undefined。当调用时,它执行以下步骤:

  1. descOrdinaryGetOwnProperty(args, P)。
  2. 如果 descundefined,则返回 undefined
  3. mapargs.[[ParameterMap]]
  4. isMapped 为 ! HasOwnProperty(map, P)。
  5. 如果 isMappedtrue,则
    1. desc.[[Value]] 设置为 ! Get(map, P)。
  6. 返回 desc

10.4.4.2 [[DefineOwnProperty]] ( P, Desc )

[[DefineOwnProperty]] 内部方法用于 arguments 特殊对象 args,接受两个参数:P(一个 属性键)和 Desc(一个 属性描述符),并 返回一个 正常完成记录,该记录 包含一个布尔值。调用时,它执行以下步骤:

  1. mapargs.[[ParameterMap]]
  2. isMapped 为 ! HasOwnProperty(map, P)。
  3. newArgDescDesc
  4. 如果 isMappedtrueIsDataDescriptor(Desc) 为 true,则
    1. 如果 Desc 没有 [[Value]] 字段,Desc 有一个 [[Writable]] 字段,且 Desc.[[Writable]]false,则
      1. newArgDesc 设置为 Desc 的副本。
      2. newArgDesc.[[Value]] 设置为 ! Get(map, P)。
  5. allowed 为 ! OrdinaryDefineOwnProperty(args, P, newArgDesc)。
  6. 如果 allowedfalse,则返回 false
  7. 如果 isMappedtrue,则
    1. 如果 IsAccessorDescriptor(Desc) 为 true,则
      1. 执行 ! map.[[Delete]](P)。
    2. 否则,
      1. 如果 Desc[[Value]] 字段,则
        1. Assert: 以下 Set 操作将成功,因为由 arguments 对象映射的正式参数始终是可写的。
        2. 执行 ! Set(map, P, Desc.[[Value]], false)。
      2. 如果 Desc[[Writable]] 字段且 Desc.[[Writable]]false,则
        1. 执行 ! map.[[Delete]](P)。
  8. 返回 true

10.4.4.3 [[Get]] ( P, Receiver )

[[Get]] 内部方法用于 arguments 特殊对象 args,接受两个参数: P(一个 属性键) 和 Receiver(一个 ECMAScript 语言值),并返回一个正常 完成记录,其中包含一个 ECMAScript 语言值 或一个 抛出完成。调用时,它执行以下步骤:

  1. mapargs.[[ParameterMap]]
  2. isMapped 为 ! HasOwnProperty(map, P)。
  3. 如果 isMappedfalse,则
    1. 返回 ? OrdinaryGet(args, P, Receiver)。
  4. 否则,
    1. Assertmap 包含 P 的正式参数映射。
    2. 返回 ! Get(map, P)。

10.4.4.4 [[Set]] ( P, V, Receiver )

[[Set]] 内部方法用于 arguments 特殊对象 args,接受三个参数: P(一个 属性键), V(一个 ECMAScript 语言值), 和 Receiver(一个 ECMAScript 语言值),并返回一个正常 完成记录,其中包含一个布尔值或一个 抛出完成。调用时,它执行以下步骤:

  1. 如果 SameValue(args, Receiver) 为 false,则
    1. isMappedfalse
  2. 否则,
    1. mapargs.[[ParameterMap]]
    2. isMapped 为 ! HasOwnProperty(map, P)。
  3. 如果 isMappedtrue,则
    1. Assert:以下的 Set 操作将会成功,因为 arguments 对象中的正式参数总是可写的。
    2. 执行 ! Set(map, P, V, false)。
  4. 返回 ? OrdinarySet(args, P, V, Receiver)。

10.4.4.5 [[Delete]] ( P )

[[Delete]] 内部方法用于 arguments 特殊对象 args, 接受一个参数 P(一个 属性键), 并返回一个正常完成记录,其中包含一个布尔值或一个 抛出完成。调用时,它执行以下步骤:

  1. mapargs.[[ParameterMap]]
  2. isMapped 为 ! HasOwnProperty(map, P)。
  3. result 为 ? OrdinaryDelete(args, P)。
  4. 如果 resulttrueisMappedtrue,则
    1. 执行 ! map.[[Delete]](P)。
  5. 返回 result

10.4.4.6 CreateUnmappedArgumentsObject ( argumentsList )

抽象操作 CreateUnmappedArgumentsObject 接受一个参数 argumentsList(一个 列表,包含 ECMAScript 语言值),并返回一个 普通对象。调用时,它执行以下步骤:

  1. lenargumentsList 中的元素数量。
  2. objOrdinaryObjectCreate(%Object.prototype%, « [[ParameterMap]] »).
  3. obj.[[ParameterMap]] 设置为 undefined
  4. 执行 ! DefinePropertyOrThrow(obj, "length", 属性描述符 { [[Value]]: 𝔽(len), [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: true }).
  5. index 为 0。
  6. 重复,直到 index < len
    1. valargumentsList[index]。
    2. 执行 ! CreateDataPropertyOrThrow(obj, ! ToString(𝔽(index)), val)。
    3. index 设置为 index + 1。
  7. 执行 ! DefinePropertyOrThrow(obj, @@iterator, 属性描述符 { [[Value]]: %Array.prototype.values%, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: true }).
  8. 执行 ! DefinePropertyOrThrow(obj, "callee", 属性描述符 { [[Get]]: %ThrowTypeError%, [[Set]]: %ThrowTypeError%, [[Enumerable]]: false, [[Configurable]]: false }).
  9. 返回 obj

10.4.4.7 CreateMappedArgumentsObject ( func, formals, argumentsList, env )

抽象操作 CreateMappedArgumentsObject 接受参数 func(一个对象)、formals(一个 解析节点)、argumentsList(一个 列表,包含 ECMAScript 语言值)和 env(一个 环境记录),并返回一个 arguments 特殊对象。调用时执行以下步骤:

  1. 断言formals 不包含剩余参数、任何绑定模式或任何初始化器。它可以包含重复的标识符。
  2. lenargumentsList 中元素的数量。
  3. objMakeBasicObject[[Prototype]], [[Extensible]], [[ParameterMap]] »)。
  4. 设置 obj.[[GetOwnProperty]]10.4.4.1 所述。
  5. 设置 obj.[[DefineOwnProperty]]10.4.4.2 所述。
  6. 设置 obj.[[Get]]10.4.4.3 所述。
  7. 设置 obj.[[Set]]10.4.4.4 所述。
  8. 设置 obj.[[Delete]]10.4.4.5 所述。
  9. 设置 obj.[[Prototype]]%Object.prototype%
  10. mapOrdinaryObjectCreate(null)。
  11. 设置 obj.[[ParameterMap]]map
  12. parameterNamesBoundNamesformals
  13. numberOfParametersparameterNames 中元素的数量。
  14. index 为 0。
  15. 重复,直到 index < len
    1. valargumentsList[index]。
    2. 执行 ! CreateDataPropertyOrThrow(obj, ! ToString(𝔽(index)), val)。
    3. 设置 indexindex + 1。
  16. 执行 ! DefinePropertyOrThrow(obj, "length", PropertyDescriptor { [[Value]]: 𝔽(len), [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: true })。
  17. mappedNames 为一个新的空的 列表
  18. 设置 indexnumberOfParameters - 1。
  19. 重复,直到 index ≥ 0,
    1. nameparameterNames[index]。
    2. 如果 mappedNames 不包含 name,那么
      1. name 添加到 mappedNames
      2. 如果 index < len,那么
        1. gMakeArgGetter(name, env)。
        2. pMakeArgSetter(name, env)。
        3. 执行 ! map.[[DefineOwnProperty]](! ToString(𝔽(index)), PropertyDescriptor { [[Set]]: p, [[Get]]: g, [[Enumerable]]: false, [[Configurable]]: true })。
    3. 设置 indexindex - 1。
  20. 执行 ! DefinePropertyOrThrow(obj, @@iterator, PropertyDescriptor { [[Value]]: %Array.prototype.values%, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: true })。
  21. 执行 ! DefinePropertyOrThrow(obj, "callee", PropertyDescriptor { [[Value]]: func, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: true })。
  22. 返回 obj

10.4.4.7.1 MakeArgGetter ( name, env )

抽象操作 MakeArgGetter 接受参数 name(一个字符串)和 env(一个 环境记录),并返回一个 函数对象。它创建一个内置的 函数对象,该函数对象在执行时返回在 env 中绑定的 name 的值。调用时执行以下步骤:

  1. getterClosure 为一个新的 抽象闭包,无参数,捕获 nameenv,并在调用时执行以下步骤:
    1. 返回 env.GetBindingValue(name, false)。
  2. getterCreateBuiltinFunction(getterClosure, 0, "", « »)。
  3. 注意:getter 从不直接被 ECMAScript 代码访问。
  4. 返回 getter

10.4.4.7.2 MakeArgSetter ( name, env )

抽象操作 MakeArgSetter 接受参数 name(一个字符串)和 env(一个 环境记录),并返回一个 函数对象。它创建一个内置的 函数对象,该函数对象在执行时设置在 env 中绑定的 name 的值。调用时执行以下步骤:

  1. setterClosure 为一个新的 抽象闭包,参数为 (value),捕获 nameenv,并在调用时执行以下步骤:
    1. 返回 ! env.SetMutableBinding(name, value, false)。
  2. setterCreateBuiltinFunction(setterClosure, 1, "", « »)。
  3. 注意:setter 从不直接被 ECMAScript 代码访问。
  4. 返回 setter

10.4.5 TypedArray 特殊对象

TypedArray 是一种 特殊对象,它对 整数索引 属性键 进行特殊处理。

TypedArrays 具有与 普通对象 相同的内部槽,并且额外具有 [[ViewedArrayBuffer]][[ArrayLength]][[ByteOffset]][[ContentType]][[TypedArrayName]] 内部槽。

如果一个对象的 [[GetOwnProperty]][[HasProperty]][[DefineOwnProperty]][[Get]][[Set]][[Delete]][[OwnPropertyKeys]] 内部方法使用本节中的定义,并且其其他基本内部方法使用 10.1 中的定义,则该对象是一个 TypedArray。这些方法由 TypedArrayCreate 安装。

10.4.5.1 [[GetOwnProperty]] ( P )

[[GetOwnProperty]]TypedArray O 的内部方法,它接受参数 P(一个 属性键),并返回一个 正常完成记录,包含 属性描述符undefined。调用时执行以下步骤:

  1. 如果 P 是一个字符串,则:
    1. numericIndexCanonicalNumericIndexString(P)。
    2. 如果 numericIndex 不是 undefined,则:
      1. valueTypedArrayGetElement(O, numericIndex)。
      2. 如果 valueundefined,则返回 undefined
      3. 返回属性描述符 { [[Value]]: value, [[Writable]]: true, [[Enumerable]]: true, [[Configurable]]: true  }。
  2. 返回 OrdinaryGetOwnProperty(O, P)。

10.4.5.2 [[HasProperty]] ( P )

[[HasProperty]]TypedArray O 的内部方法,它接受参数 P(一个 属性键),并返回一个 正常完成记录,包含一个布尔值或一个 抛出完成记录。调用时执行以下步骤:

  1. 如果 P 是一个字符串,则:
    1. numericIndexCanonicalNumericIndexString(P)。
    2. 如果 numericIndex 不是 undefined,返回 IsValidIntegerIndex(O, numericIndex)。
  2. 返回 ? OrdinaryHasProperty(O, P)。

10.4.5.3 [[DefineOwnProperty]] ( P, Desc )

[[DefineOwnProperty]]TypedArray O 的内部方法,它接受参数 P(一个 属性键)和 Desc(一个 属性描述符),并返回一个 正常完成记录,包含一个布尔值,或者一个 抛出完成记录。调用时执行以下步骤:

  1. 如果 P 是一个字符串,则:
    1. numericIndexCanonicalNumericIndexString(P)。
    2. 如果 numericIndex 不是 undefined,则:
      1. 如果 IsValidIntegerIndex(O, numericIndex) 为 false,则返回 false
      2. 如果 Desc 具有 [[Configurable]] 字段且 Desc.[[Configurable]]false,则返回 false
      3. 如果 Desc 具有 [[Enumerable]] 字段且 Desc.[[Enumerable]]false,则返回 false
      4. 如果 IsAccessorDescriptor(Desc) 为 true,则返回 false
      5. 如果 Desc 具有 [[Writable]] 字段且 Desc.[[Writable]]false,则返回 false
      6. 如果 Desc 具有 [[Value]] 字段,执行 ? TypedArraySetElement(O, numericIndex, Desc.[[Value]])。
      7. 返回 true
  2. 返回 ! OrdinaryDefineOwnProperty(O, P, Desc)。

10.4.5.4 [[Get]] ( P, Receiver )

[[Get]]TypedArray O 的内部方法,它接受参数 P(一个 属性键)和 Receiver(一个 ECMAScript 语言值),并返回一个 正常完成记录,包含一个 ECMAScript 语言值 或一个 抛出完成记录。调用时执行以下步骤:

  1. 如果 P 是一个字符串,则:
    1. numericIndexCanonicalNumericIndexString(P)。
    2. 如果 numericIndex 不是 undefined,则:
      1. 返回 TypedArrayGetElement(O, numericIndex)。
  2. 返回 ? OrdinaryGet(O, P, Receiver)。

10.4.5.5 [[Set]] ( P, V, Receiver )

[[Set]]TypedArray O 的内部方法,它接受参数 P(一个 属性键)、V(一个 ECMAScript 语言值)和 Receiver(一个 ECMAScript 语言值),并返回一个 正常完成记录,包含一个布尔值,或者一个 抛出完成记录。调用时执行以下步骤:

  1. 如果 P 是一个字符串,则:
    1. numericIndexCanonicalNumericIndexString(P)。
    2. 如果 numericIndex 不是 undefined,则:
      1. 如果 SameValue(O, Receiver) 为 true,则:
        1. 执行 ? TypedArraySetElement(O, numericIndex, V)。
        2. 返回 true
      2. 如果 IsValidIntegerIndex(O, numericIndex) 为 false,则返回 true
  2. 返回 ? OrdinarySet(O, P, V, Receiver)。

10.4.5.6 [[Delete]] ( P )

[[Delete]]TypedArray O 的内部方法,它接受参数 P(一个 属性键),并返回一个 正常完成记录,包含一个布尔值。调用时执行以下步骤:

  1. 如果 P 是一个字符串,则:
    1. numericIndexCanonicalNumericIndexString(P)。
    2. 如果 numericIndex 不是 undefined,则:
      1. 如果 IsValidIntegerIndex(O, numericIndex) 为 false,则返回 true;否则返回 false
  2. 返回 ! OrdinaryDelete(O, P)。

10.4.5.7 [[OwnPropertyKeys]] ( )

[[OwnPropertyKeys]]TypedArray O 的内部方法,它不接受任何参数,并返回一个 正常完成记录,包含一个 列表,其中包含 属性键。调用时执行以下步骤:

  1. taRecordMakeTypedArrayWithBufferWitnessRecord(O, seq-cst)。
  2. keys 为一个新的空的 列表
  3. 如果 IsTypedArrayOutOfBounds(taRecord) 为 false,则:
    1. lengthTypedArrayLength(taRecord)。
    2. 对于每个满足 0 ≤ i < length整数 i,按升序进行:
      1. 将 ! ToString(𝔽(i)) 添加到 keys
  4. 对于每个 O 的自身 属性键 P,如果 P 是一个字符串 并且 P 不是一个 整数索引,按属性创建的时间顺序升序进行:
    1. P 添加到 keys
  5. 对于每个 O 的自身 属性键 P,如果 P 是一个符号,按属性创建的时间顺序升序进行:
    1. P 添加到 keys
  6. 返回 keys

10.4.5.8 带缓冲见证记录的 TypedArray

一个 带缓冲见证记录的 TypedArray 是一个 记录 值,用于封装一个 TypedArray 以及查看缓冲区的缓存字节长度。它用于确保当查看的缓冲区是一个 可增长的 SharedArrayBuffer 时,有一个单一的共享内存读取事件来读取字节长度数据块。

带缓冲见证记录的 TypedArray 具有 表 32 中列出的字段。

表 32: 带缓冲见证记录的 TypedArray 字段
字段名称 含义
[[Object]] 一个 TypedArray 其缓冲区的字节长度被加载的 TypedArray
[[CachedBufferByteLength]] 一个非负的 整数detached 创建 记录 时对象的 [[ViewedArrayBuffer]] 的字节长度。

10.4.5.9 MakeTypedArrayWithBufferWitnessRecord ( obj, order )

抽象操作 MakeTypedArrayWithBufferWitnessRecord 接受参数 obj(一个 TypedArray)和 orderseq-cstunordered),并返回一个 带缓冲见证记录的 TypedArray。调用时执行以下步骤:

  1. bufferobj.[[ViewedArrayBuffer]]
  2. 如果 IsDetachedBuffer(buffer) 为 true,则:
    1. byteLengthdetached
  3. 否则,
    1. byteLengthArrayBufferByteLength(buffer, order)。
  4. 返回 带缓冲见证记录的 TypedArray { [[Object]]: obj, [[CachedBufferByteLength]]: byteLength  }。

10.4.5.10 TypedArrayCreate ( prototype )

抽象操作 TypedArrayCreate 接受参数 prototype(一个对象),并返回一个 TypedArray。它用于指定新 TypedArrays 的创建。调用时执行以下步骤:

  1. internalSlotsList 为 « [[Prototype]], [[Extensible]], [[ViewedArrayBuffer]], [[TypedArrayName]], [[ContentType]], [[ByteLength]], [[ByteOffset]], [[ArrayLength]]  »。
  2. AMakeBasicObject(internalSlotsList)。
  3. 设置 A.[[GetOwnProperty]]10.4.5.1 中所指定的。
  4. 设置 A.[[HasProperty]]10.4.5.2 中所指定的。
  5. 设置 A.[[DefineOwnProperty]]10.4.5.3 中所指定的。
  6. 设置 A.[[Get]]10.4.5.4 中所指定的。
  7. 设置 A.[[Set]]10.4.5.5 中所指定的。
  8. 设置 A.[[Delete]]10.4.5.6 中所指定的。
  9. 设置 A.[[OwnPropertyKeys]]10.4.5.7 中所指定的。
  10. A.[[Prototype]] 设置为 prototype
  11. 返回 A

10.4.5.11 TypedArrayByteLength ( taRecord )

抽象操作 TypedArrayByteLength 接受参数 taRecord(一个 带缓冲见证记录的 TypedArray),并返回一个非负的 整数。调用时执行以下步骤:

  1. 如果 IsTypedArrayOutOfBounds(taRecord) 为 true,则返回 0。
  2. lengthTypedArrayLength(taRecord)。
  3. 如果 length = 0,则返回 0。
  4. OtaRecord.[[Object]]
  5. 如果 O.[[ByteLength]] 不为 auto,则返回 O.[[ByteLength]]
  6. elementSizeTypedArrayElementSize(O)。
  7. 返回 length × elementSize

10.4.5.12 TypedArrayLength ( taRecord )

抽象操作 TypedArrayLength 接受参数 taRecord(一个 带缓冲见证记录的 TypedArray),并返回一个非负的 整数。调用时执行以下步骤:

  1. 断言IsTypedArrayOutOfBounds(taRecord) 为 false
  2. OtaRecord.[[Object]]
  3. 如果 O.[[ArrayLength]] 不为 auto,则返回 O.[[ArrayLength]]
  4. 断言IsFixedLengthArrayBuffer(O.[[ViewedArrayBuffer]]) 为 false
  5. byteOffsetO.[[ByteOffset]]
  6. elementSizeTypedArrayElementSize(O)。
  7. byteLengthtaRecord.[[CachedBufferByteLength]]
  8. 断言byteLength 不为 detached
  9. 返回 floor((byteLength - byteOffset) / elementSize)。

10.4.5.13 IsTypedArrayOutOfBounds ( taRecord )

抽象操作 IsTypedArrayOutOfBounds 接受参数 taRecord(一个 带缓冲见证记录的 TypedArray),并返回一个布尔值。它检查对象的任何数值属性是否引用了基础缓冲区边界内不包含的索引处的值。调用时执行以下步骤:

  1. OtaRecord.[[Object]]
  2. bufferByteLengthtaRecord.[[CachedBufferByteLength]]
  3. 断言:如果 O.[[ViewedArrayBuffer]]IsDetachedBuffer,则 bufferByteLength 必须为 detached
  4. 如果 bufferByteLengthdetached,返回 true
  5. byteOffsetStartO.[[ByteOffset]]
  6. 如果 O.[[ArrayLength]]auto,则:
    1. byteOffsetEndbufferByteLength
  7. 否则,
    1. elementSizeTypedArrayElementSize(O)。
    2. byteOffsetEndbyteOffsetStart + O.[[ArrayLength]] × elementSize
  8. 如果 byteOffsetStart > bufferByteLengthbyteOffsetEnd > bufferByteLength,返回 true
  9. 注意:长度为 0 的 TypedArrays 不被视为越界。
  10. 返回 false

10.4.5.14 IsValidIntegerIndex ( O, index )

抽象操作 IsValidIntegerIndex 接受参数 O(一个 TypedArray)和 index(一个数字),并返回一个布尔值。调用时执行以下步骤:

  1. 如果 IsDetachedBuffer(O.[[ViewedArrayBuffer]]) 为 true,返回 false
  2. 如果 IsIntegralNumber(index) 为 false,返回 false
  3. 如果 index-0𝔽,返回 false
  4. taRecordMakeTypedArrayWithBufferWitnessRecord(O, unordered)。
  5. 注意:当 O 的后备缓冲区是一个 可增长的 SharedArrayBuffer 时,边界检查不是同步操作。
  6. 如果 IsTypedArrayOutOfBounds(taRecord) 为 true,返回 false
  7. lengthTypedArrayLength(taRecord)。
  8. 如果 (index) < 0 或 (index) ≥ length,返回 false
  9. 返回 true

10.4.5.15 TypedArrayGetElement ( O, index )

抽象操作 TypedArrayGetElement 接受参数 O(一个 TypedArray)和 index(一个数字),并返回一个数字、BigInt 或 undefined。调用时执行以下步骤:

  1. 如果 IsValidIntegerIndex(O, index) 为 false,返回 undefined
  2. offsetO.[[ByteOffset]]
  3. elementSizeTypedArrayElementSize(O)。
  4. byteIndexInBuffer 为 ((index) × elementSize) + offset
  5. elementTypeTypedArrayElementType(O)。
  6. 返回 GetValueFromBuffer(O.[[ViewedArrayBuffer]], byteIndexInBuffer, elementType, true, unordered)。

10.4.5.16 TypedArraySetElement ( O, index, value )

抽象操作 TypedArraySetElement 接受参数 O(一个 TypedArray)、index(一个数字)和 value(一个 ECMAScript 语言值),并返回一个 包含 unused抛出完成记录。调用时执行以下步骤:

  1. 如果 O.[[ContentType]]bigint,令 numValue 为 ? ToBigInt(value)。
  2. 否则,令 numValue 为 ? ToNumber(value)。
  3. 如果 IsValidIntegerIndex(O, index) 为 true,则:
    1. offsetO.[[ByteOffset]]
    2. elementSizeTypedArrayElementSize(O)。
    3. byteIndexInBuffer 为 ((index) × elementSize) + offset
    4. elementTypeTypedArrayElementType(O)。
    5. 执行 SetValueInBuffer(O.[[ViewedArrayBuffer]], byteIndexInBuffer, elementType, numValue, true, unordered)。
  4. 返回 unused

此操作似乎总是成功,但在尝试写入 TypedArray 的末尾或写入由已分离的 ArrayBuffer 支持的 TypedArray 时没有效果。

10.4.5.17 IsArrayBufferViewOutOfBounds ( O )

抽象操作 IsArrayBufferViewOutOfBounds 接受参数 O(一个 TypedArray 或一个 DataView),并返回一个布尔值。它检查 TypedArray 的数值属性或 DataView 对象的方法是否可以引用基础数据块边界之外的索引处的值。此抽象操作存在是为了方便上游规范。调用时执行以下步骤:

  1. 如果 O 具有 [[DataView]] 内部插槽,则:
    1. viewRecordMakeDataViewWithBufferWitnessRecord(O, seq-cst)。
    2. 返回 IsViewOutOfBounds(viewRecord)。
  2. taRecordMakeTypedArrayWithBufferWitnessRecord(O, seq-cst)。
  3. 返回 IsTypedArrayOutOfBounds(taRecord)。

10.4.6 模块命名空间特殊对象

一个 模块命名空间特殊对象 是一个 特殊对象,它暴露了从 ECMAScript 模块 导出的绑定(参见 16.2.3)。一个 模块命名空间特殊对象 的字符串键自身属性与模块导出的绑定名称之间存在一一对应关系。导出的绑定包括使用 export * 语法间接导出的绑定。每个字符串值自身属性键是相应导出绑定名称的 字符串值。这些是 模块命名空间特殊对象 的唯一字符串键属性。每个这样的属性具有以下属性: { [[Writable]]: true, [[Enumerable]]: true, [[Configurable]]: false }。模块命名空间特殊对象 是不可扩展的。

一个对象是一个 模块命名空间特殊对象,如果它的 [[GetPrototypeOf]], [[SetPrototypeOf]], [[IsExtensible]], [[PreventExtensions]], [[GetOwnProperty]], [[DefineOwnProperty]], [[HasProperty]], [[Get]], [[Set]], [[Delete]], 和 [[OwnPropertyKeys]] 内部方法使用本节中的定义,而它的其他基本内部方法使用 10.1 中的定义。这些方法由 ModuleNamespaceCreate 安装。

模块命名空间特殊对象 具有 表 33 中定义的内部插槽。

表 33:模块命名空间特殊对象的内部插槽
内部插槽名称 类型 描述
[[Module]] 一个 模块记录 暴露此命名空间导出的 模块记录
[[Exports]] 一个 字符串列表 一个 列表,其元素是作为此对象的自身属性暴露的导出名称的字符串值。该列表的顺序就像用 %Array.prototype.sort% 使用 undefined 作为 comparefn 对这些字符串值进行排序一样。

10.4.6.1 [[GetPrototypeOf]] ( )

一个 模块命名空间特殊对象[[GetPrototypeOf]] 内部方法不接收任何参数,返回一个 正常完成记录,包含 null。它执行以下步骤:

  1. 返回 null

10.4.6.2 [[SetPrototypeOf]] ( V )

一个 模块命名空间特殊对象[[SetPrototypeOf]] 内部方法接收参数 V(一个对象或 null),返回一个 正常完成记录,包含 一个布尔值。它执行以下步骤:

  1. 返回 ! SetImmutablePrototype(O, V)。

10.4.6.3 [[IsExtensible]] ( )

一个 模块命名空间特殊对象[[IsExtensible]] 内部方法不接收任何参数,返回一个 正常完成记录,包含 false。它执行以下步骤:

  1. 返回 false

10.4.6.4 [[PreventExtensions]] ( )

一个 模块命名空间特殊对象[[PreventExtensions]] 内部方法不接收任何参数,返回一个 正常完成记录,包含 true。它执行以下步骤:

  1. 返回 true

10.4.6.5 [[GetOwnProperty]] ( P )

一个 模块命名空间特殊对象[[GetOwnProperty]] 内部方法接收参数 P(一个 属性键),返回一个 正常完成记录,包含 一个 属性描述符undefined,或一个 抛出完成记录。它执行以下步骤:

  1. 如果 P 是一个符号,返回 OrdinaryGetOwnProperty(O, P)。
  2. exports 成为 O[[Exports]]
  3. 如果 exports 不包含 P,返回 undefined
  4. value 成为 ? O.[[Get]](P, O)。
  5. 返回 PropertyDescriptor { [[Value]]: value, [[Writable]]: true, [[Enumerable]]: true, [[Configurable]]: false }。

10.4.6.6 [[DefineOwnProperty]] ( P, Desc )

一个 模块命名空间特殊对象[[DefineOwnProperty]] 内部方法接收参数 P(一个 属性键)和 Desc(一个 属性描述符),返回一个 正常完成记录,包含 一个布尔值或一个 抛出完成记录。它执行以下步骤:

  1. 如果 P 是一个符号,返回 ! OrdinaryDefineOwnProperty(O, P, Desc)。
  2. current 成为 ? O.[[GetOwnProperty]](P)。
  3. 如果 currentundefined,返回 false
  4. 如果 Desc 具有 [[Configurable]] 字段,并且 Desc[[Configurable]]true,返回 false
  5. 如果 Desc 具有 [[Enumerable]] 字段,并且 Desc[[Enumerable]]false,返回 false
  6. 如果 IsAccessorDescriptor(Desc) 是 true,返回 false
  7. 如果 Desc 具有 [[Writable]] 字段,并且 Desc[[Writable]]false,返回 false
  8. 如果 Desc 具有 [[Value]] 字段,返回 SameValue(Desc.[[Value]], current.[[Value]])。
  9. 返回 true

10.4.6.7 [[HasProperty]] ( P )

一个 模块命名空间特殊对象[[HasProperty]] 内部方法接收参数 P(一个 属性键),返回一个 正常完成记录,包含 一个布尔值。它执行以下步骤:

  1. 如果 P 是一个符号,返回 ! OrdinaryHasProperty(O, P)。
  2. exports 成为 O[[Exports]]
  3. 如果 exports 包含 P,返回 true
  4. 返回 false

10.4.6.8 [[Get]] ( P, Receiver )

一个 模块命名空间特殊对象[[Get]] 内部方法接收参数 P(一个 属性键)和 Receiver(一个 ECMAScript 语言值),返回一个 正常完成记录,包含 一个 ECMAScript 语言值 或一个 抛出完成记录。它执行以下步骤:

  1. 如果 P 是一个符号,则
    1. 返回 ! OrdinaryGet(O, P, Receiver)。
  2. exports 成为 O[[Exports]]
  3. 如果 exports 不包含 P,返回 undefined
  4. m 成为 O[[Module]]
  5. binding 成为 m.ResolveExport(P)。
  6. 断言binding 是一个 已解析绑定记录
  7. targetModule 成为 binding[[Module]]
  8. 断言targetModule 不是 undefined
  9. 如果 binding[[BindingName]]namespace,则
    1. 返回 GetModuleNamespace(targetModule)。
  10. targetEnv 成为 targetModule[[Environment]]
  11. 如果 targetEnvempty,抛出一个 ReferenceError 异常。
  12. 返回 ? targetEnv.GetBindingValue(binding.[[BindingName]], true)。

ResolveExport 是无副作用的。每次用特定的 exportNameresolveSet 参数调用此操作时,它必须返回相同的结果。实现可以选择预先计算或缓存每个 模块命名空间特殊对象[[Exports]] 的 ResolveExport 结果。

10.4.6.9 [[Set]] ( P, V, Receiver )

一个 模块命名空间特殊对象[[Set]] 内部方法接收参数 P(一个 属性键),V(一个 ECMAScript 语言值),和 Receiver(一个 ECMAScript 语言值),返回一个 正常完成记录,包含 false。它执行以下步骤:

  1. 返回 false

10.4.6.10 [[Delete]] ( P )

一个 模块命名空间特殊对象[[Delete]] 内部方法接收参数 P(一个 属性键),返回一个 正常完成记录,包含 一个布尔值。它执行以下步骤:

  1. 如果 P 是一个符号,则
    1. 返回 ! OrdinaryDelete(O, P)。
  2. exports 成为 O[[Exports]]
  3. 如果 exports 包含 P,返回 false
  4. 返回 true

10.4.6.11 [[OwnPropertyKeys]] ( )

一个 模块命名空间特殊对象[[OwnPropertyKeys]] 内部方法不接收任何参数,返回一个 正常完成记录,包含 一个 列表属性键。它执行以下步骤:

  1. exports 成为 O[[Exports]]
  2. symbolKeys 成为 OrdinaryOwnPropertyKeys(O)。
  3. 返回 列表连接 exportssymbolKeys

10.4.6.12 ModuleNamespaceCreate ( module, exports )

抽象操作 ModuleNamespaceCreate 接收参数 module(一个 模块记录)和 exports(一个 字符串列表),返回一个 模块命名空间特殊对象。它用于指定创建新的 模块命名空间特殊对象。它执行以下步骤:

  1. 断言module[[Namespace]]empty
  2. internalSlotsList 成为 表 33 中列出的内部插槽。
  3. M 成为 MakeBasicObject(internalSlotsList)。
  4. M 的基本内部方法设置为 10.4.6 中的定义。
  5. M[[Module]] 设置为 module
  6. sortedExports 成为 列表,其元素是 exports 的元素,顺序就像用 %Array.prototype.sort% 使用 undefined 作为 comparefn 对这些值进行排序一样。
  7. M[[Exports]] 设置为 sortedExports
  8. 创建与 28.3 中定义相对应的 M 自身属性。
  9. module[[Namespace]] 设置为 M
  10. 返回 M

10.4.7 不可变原型特殊对象

一个 不可变原型特殊对象 是一个具有 [[Prototype]] 内部插槽的 特殊对象,该插槽在初始化后不会改变。

如果对象的 [[SetPrototypeOf]] 内部方法使用以下实现,则该对象是一个 不可变原型特殊对象。(其其他基本内部方法可以根据具体的 不可变原型特殊对象 使用任意实现。)

与其他 特殊对象 不同,没有为 不可变原型特殊对象 提供专门的创建抽象操作。这是因为它们仅由 %Object.prototype%宿主环境 使用,并且在 宿主环境 中,相关对象可能在其他方面也是特殊的,因此需要它们自己的专门创建操作。

10.4.7.1 [[SetPrototypeOf]] ( V )

一个 不可变原型特殊对象[[SetPrototypeOf]] 内部方法接收参数 V(一个对象或 null),并返回一个 正常完成记录,包含 一个布尔值或一个 抛出完成记录。它执行以下步骤:

  1. 返回 ? SetImmutablePrototype(O, V)。

10.4.7.2 SetImmutablePrototype ( O, V )

抽象操作 SetImmutablePrototype 接收参数 O(一个对象)和 V(一个对象或 null),并返回一个 正常完成记录,包含 一个布尔值或一个 抛出完成记录。它执行以下步骤:

  1. current 成为 ? O.[[GetPrototypeOf]]()。
  2. 如果 SameValue(V, current) 是 true,返回 true
  3. 返回 false

10.5 代理对象的内部方法和内部插槽

代理对象是一个 特殊对象,其基本内部方法部分由 ECMAScript 代码实现。每个代理对象都有一个名为 [[ProxyHandler]] 的内部插槽。[[ProxyHandler]] 的值是一个对象,称为代理的 处理程序对象,或 null。处理程序对象的方法(见 表34)可以用来增强一个或多个代理对象的内部方法的实现。每个代理对象还有一个名为 [[ProxyTarget]] 的内部插槽,其值要么是一个对象,要么是 null 值。这个对象被称为代理的 目标对象

如果对象的基本内部方法(包括 [[Call]][[Construct]],如果适用)使用本节中的定义,则该对象是一个 代理特殊对象。这些内部方法在 ProxyCreate 中安装。

表34: 代理处理程序方法
内部方法 处理程序方法
[[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

当调用处理程序方法来提供代理对象内部方法的实现时,处理程序方法会将代理的目标对象作为参数传递。代理的处理程序对象不一定具有与每个基本内部方法对应的方法。如果处理程序对象没有对应于内部陷阱的方法,则在代理上调用内部方法将导致调用代理目标对象上的相应内部方法。

代理对象的 [[ProxyHandler]][[ProxyTarget]] 内部插槽在对象创建时总是被初始化,并且通常不可修改。有些代理对象是以允许其随后被撤销的方式创建的。当代理被撤销时,其 [[ProxyHandler]][[ProxyTarget]] 内部插槽被设置为 null,导致在该代理对象上随后调用内部方法会抛出 TypeError 异常。

由于代理对象允许内部方法的实现由任意 ECMAScript 代码提供,因此可能会定义一个其处理程序方法违反 6.1.7.3 中定义的不变量的代理对象。一些在 6.1.7.3 中定义的内部方法不变量是基本的完整性不变量。这些不变量由本节中指定的代理对象内部方法明确执行。ECMAScript 实现必须在所有可能的不变量违反的情况下都具有健壮性。

在以下算法描述中,假设 O 是一个 ECMAScript 代理对象,P 是一个 属性键 值,V 是任何 ECMAScript 语言值,并且 Desc 是一个 属性描述符 记录。

10.5.1 [[GetPrototypeOf]] ( )

[[GetPrototypeOf]] 内部方法的 Proxy 异质对象 O 不接受任何参数,并返回 正常完成记录 ,其包含一个对象或 null,或者返回一个 抛出完成 。调用时执行以下步骤:

  1. 执行 ?  ValidateNonRevokedProxy (O)。
  2. targetO.[[ProxyTarget]]
  3. handlerO.[[ProxyHandler]]
  4. 断言handler 是一个 对象
  5. trap 为 ?  GetMethod (handler, "getPrototypeOf")。
  6. 如果 trapundefined,则:
    1. 返回 ? target.[[GetPrototypeOf]]()。
  7. handlerProto 为 ?  Call (trap, handler, « target »)。
  8. 如果 handlerProto 不是一个 对象 并且 handlerProto 不是 null,则抛出 TypeError 异常。
  9. extensibleTarget 为 ?  IsExtensible (target)。
  10. 如果 extensibleTargettrue,则返回 handlerProto
  11. targetProto 为 ? target.[[GetPrototypeOf]]()。
  12. 如果 SameValue (handlerProto, targetProto) 是 false,则抛出 TypeError 异常。
  13. 返回 handlerProto

Proxy 对象的 [[GetPrototypeOf]] 强制执行以下不变量:

  • [[GetPrototypeOf]] 的结果必须是一个对象或 null
  • 如果目标对象不可扩展,则应用于代理对象的 [[GetPrototypeOf]] 必须返回与应用于代理对象的目标对象的 [[GetPrototypeOf]] 相同的值。

10.5.2 [[SetPrototypeOf]] ( V )

[[SetPrototypeOf]] 内部方法的 Proxy 异质对象 O 接受参数 V(一个对象或 null),并返回一个 正常完成记录 ,其包含一个布尔值或返回一个 抛出完成 。调用时执行以下步骤:

  1. 执行 ?  ValidateNonRevokedProxy (O)。
  2. targetO.[[ProxyTarget]]
  3. handlerO.[[ProxyHandler]]
  4. 断言handler 是一个 对象
  5. trap 为 ?  GetMethod (handler, "setPrototypeOf")。
  6. 如果 trapundefined,则:
    1. 返回 ? target.[[SetPrototypeOf]](V)。
  7. booleanTrapResult ToBoolean (? Call (trap, handler, « target, V »))。
  8. 如果 booleanTrapResultfalse,则返回 false
  9. extensibleTarget 为 ?  IsExtensible (target)。
  10. 如果 extensibleTargettrue,则返回 true
  11. targetProto 为 ? target.[[GetPrototypeOf]]()。
  12. 如果 SameValue (V, targetProto) 是 false,则抛出 TypeError 异常。
  13. 返回 true

Proxy 对象的 [[SetPrototypeOf]] 强制执行以下不变量:

  • [[SetPrototypeOf]] 的结果是一个布尔值。
  • 如果目标对象不可扩展,则参数值必须与应用于目标对象的 [[GetPrototypeOf]] 的结果相同。

10.5.3 [[IsExtensible]] ( )

[[IsExtensible]] 内部方法的 Proxy 异质对象 O 不接受参数并返回一个 正常完成记录 ,其包含一个布尔值或返回一个 抛出完成 。调用时执行以下步骤:

  1. 执行 ?  ValidateNonRevokedProxy (O)。
  2. targetO.[[ProxyTarget]]
  3. handlerO.[[ProxyHandler]]
  4. 断言 handler 是一个 对象
  5. trap 为 ?  GetMethod (handler, "isExtensible")。
  6. 如果 trapundefined,则:
    1. 返回 ?  IsExtensible (target)。
  7. booleanTrapResult ToBoolean (? Call (trap, handler, « target »))。
  8. targetResult 为 ?  IsExtensible (target)。
  9. 如果 booleanTrapResult 不等于 targetResult,则抛出 TypeError 异常。
  10. 返回 booleanTrapResult

Proxy 对象的 [[IsExtensible]] 强制执行以下不变量:

  • [[IsExtensible]] 的结果是一个布尔值。
  • 应用于 Proxy 对象的 [[IsExtensible]] 必须返回与应用于 Proxy 对象的目标对象相同的参数值相同的结果。

10.5.4 [[PreventExtensions]] ( )

[[PreventExtensions]] 内部方法的 Proxy 异质对象 O 不接受参数并返回一个 正常完成记录 ,其包含一个布尔值或返回一个 抛出完成 。调用时执行以下步骤:

  1. 执行 ?  ValidateNonRevokedProxy (O)。
  2. targetO.[[ProxyTarget]]
  3. handlerO.[[ProxyHandler]]
  4. 断言 handler 是一个 对象
  5. trap 为 ?  GetMethod (handler, "preventExtensions")。
  6. 如果 trapundefined,则:
    1. 返回 ? target.[[PreventExtensions]]()
  7. booleanTrapResult ToBoolean (? Call (trap, handler, « target »))。
  8. 如果 booleanTrapResulttrue,则:
    1. extensibleTarget 为 ?  IsExtensible (target)。
    2. 如果 extensibleTargettrue,抛出 TypeError 异常。
  9. 返回 booleanTrapResult

Proxy 对象的 [[PreventExtensions]] 强制执行以下不变量:

  • [[PreventExtensions]] 的结果是一个布尔值。
  • 应用于 Proxy 对象的 [[PreventExtensions]] 仅当应用于 Proxy 对象的目标对象的 [[IsExtensible]] 结果为 false 时,才会返回 true

10.5.5 [[GetOwnProperty]] ( P )

[[GetOwnProperty]] 内部方法的 Proxy 异质对象 O 接受参数 P(一个 属性键 )并返回一个 正常完成记录 ,其包含一个 属性描述符 undefined,或者返回一个 抛出完成 。调用时执行以下步骤:

  1. 执行 ?  ValidateNonRevokedProxy (O)。
  2. targetO.[[ProxyTarget]]
  3. handlerO.[[ProxyHandler]]
  4. 断言 handler 是一个 对象
  5. trap 为 ?  GetMethod (handler, "getOwnPropertyDescriptor")。
  6. 如果 trapundefined,则:
    1. 返回 ? target.[[GetOwnProperty]](P)
  7. trapResultObj 为 ?  Call (trap, handler, «target, P »)。
  8. 如果 trapResultObj 不是一个 对象 trapResultObj 不是 undefined,抛出一个 TypeError 异常。
  9. targetDesc 为 ? target.[[GetOwnProperty]](P)
  10. 如果 trapResultObjundefined,则:
    1. 如果 targetDescundefined,返回 undefined
    2. 如果 targetDesc.[[Configurable]]false,抛出一个 TypeError 异常。
    3. extensibleTarget 为 ?  IsExtensible (target)。
    4. 如果 extensibleTargetfalse,抛出一个 TypeError 异常。
    5. 返回 undefined
  11. extensibleTarget 为 ?  IsExtensible (target)。
  12. resultDesc 为 ?  ToPropertyDescriptor (trapResultObj)。
  13. 执行 CompletePropertyDescriptor (resultDesc)。
  14. valid IsCompatiblePropertyDescriptor (extensibleTarget, resultDesc, targetDesc)。
  15. 如果 validfalse,抛出一个 TypeError 异常。
  16. 如果 resultDesc.[[Configurable]]false,则:
    1. 如果 targetDescundefinedtargetDesc.[[Configurable]]true,则:
      1. 抛出一个 TypeError 异常。
    2. 如果 resultDesc 有一个 [[Writable]] 字段并且 resultDesc.[[Writable]]false,则:
      1. 断言 targetDesc 有一个 [[Writable]] 字段。
      2. 如果 targetDesc.[[Writable]]true,抛出一个 TypeError 异常。
  17. 返回 resultDesc

Proxy 对象的 [[GetOwnProperty]] 强制执行以下不变量:

  • [[GetOwnProperty]] 的结果必须是一个对象或 undefined
  • 如果目标对象作为自身不可配置的属性存在,则该属性不能被报告为不存在。
  • 如果目标对象作为自身不可扩展的属性存在,则该属性不能被报告为不存在。
  • 如果目标对象是不可扩展的,且该属性不存在于目标对象的自身属性中,则该属性不能被报告为存在。
  • 除非目标对象的自身不可配置属性存在,否则该属性不能被报告为不可配置。
  • 除非目标对象的自身不可配置且不可写的属性存在,否则该属性不能被报告为既不可配置又不可写。

10.5.6 [[DefineOwnProperty]] ( P, Desc )

[[DefineOwnProperty]] 内部方法的 Proxy 异质对象 O 接受参数 P(一个 属性键 )和 Desc(一个 属性描述符 )并返回一个 正常完成记录 ,其包含一个布尔值或返回一个 抛出完成 。调用时执行以下步骤:

  1. 执行 ?  ValidateNonRevokedProxy (O)。
  2. targetO.[[ProxyTarget]]
  3. handlerO.[[ProxyHandler]]
  4. 断言 handler 是一个 对象
  5. trap 为 ?  GetMethod (handler, "defineProperty")。
  6. 如果 trapundefined,则:
    1. 返回 ? target.[[DefineOwnProperty]](P, Desc)
  7. descObj 为 ?  FromPropertyDescriptor (Desc)。
  8. booleanTrapResult ToBoolean (? Call (trap, handler, «target, P, descObj »))。
  9. 如果 booleanTrapResultfalse,返回 false
  10. targetDesc 为 ? target.[[GetOwnProperty]](P)
  11. extensibleTarget 为 ?  IsExtensible (target)。
  12. 如果 Desc 有一个 [[Configurable]] 字段且 Desc.[[Configurable]]false,则:
    1. settingConfigFalsetrue
  13. 否则,
    1. settingConfigFalsefalse
  14. 如果 targetDescundefined,则:
    1. 如果 extensibleTargetfalse,抛出一个 TypeError 异常。
    2. 如果 settingConfigFalsetrue,抛出一个 TypeError 异常。
  15. 否则,
    1. 如果 IsCompatiblePropertyDescriptor (extensibleTarget, Desc, targetDesc) 是 false,抛出一个 TypeError 异常。
    2. 如果 settingConfigFalsetruetargetDesc.[[Configurable]]true,抛出一个 TypeError 异常。
    3. 如果 IsDataDescriptor (targetDesc) 是 truetargetDesc.[[Configurable]]false,且 targetDesc.[[Writable]]true,则:
      1. 如果 Desc 有一个 [[Writable]] 字段且 Desc.[[Writable]]false,抛出一个 TypeError 异常。
  16. 返回 true

Proxy 对象的 [[DefineOwnProperty]] 强制执行以下不变量:

  • [[DefineOwnProperty]] 的结果是一个布尔值。
  • 如果目标对象是不可扩展的,则不能添加属性。
  • 除非目标对象存在相应的不可配置自身属性,否则属性不能是不可配置的。
  • 除非目标对象存在相应的不可配置且不可写的自身属性,否则不可配置的属性不能是不可写的。
  • 如果属性有相应的目标对象属性,则使用属性的属性描述符应用于目标对象的 [[DefineOwnProperty]] 不会抛出异常。

10.5.7 [[HasProperty]] ( P )

[[HasProperty]] 内部方法的 Proxy 异质对象 O 接受参数 P(一个 属性键 )并返回一个 正常完成记录 ,其包含一个布尔值或返回一个 抛出完成 。调用时执行以下步骤:

  1. 执行 ?  ValidateNonRevokedProxy (O)。
  2. targetO.[[ProxyTarget]]
  3. handlerO.[[ProxyHandler]]
  4. 断言 handler 是一个 对象
  5. trap 为 ?  GetMethod (handler, "has")。
  6. 如果 trapundefined,则:
    1. 返回 ? target.[[HasProperty]](P)
  7. booleanTrapResult ToBoolean (? Call (trap, handler, «target, P »))。
  8. 如果 booleanTrapResultfalse,则:
    1. targetDesc 为 ? target.[[GetOwnProperty]](P)
    2. 如果 targetDesc 不是 undefined,则:
      1. 如果 targetDesc.[[Configurable]]false,抛出一个 TypeError 异常。
      2. extensibleTarget 为 ?  IsExtensible (target)。
      3. 如果 extensibleTargetfalse,抛出一个 TypeError 异常。
  9. 返回 booleanTrapResult

Proxy 对象的 [[HasProperty]] 强制执行以下不变量:

  • [[HasProperty]] 的结果是一个布尔值。
  • 如果属性作为目标对象的不可配置自身属性存在,则不能报告该属性不存在。
  • 如果属性作为目标对象的自身属性存在且目标对象不可扩展,则不能报告该属性不存在。

10.5.8 [[Get]] ( P, Receiver )

[[Get]] 内部方法的 Proxy 异质对象 O 接受参数 P(一个 属性键 )和 Receiver(一个 ECMAScript 语言值 ),并返回一个 正常完成记录 ,其包含一个 ECMAScript 语言值 或返回一个 抛出完成 。调用时执行以下步骤:

  1. 执行 ?  ValidateNonRevokedProxy (O)。
  2. targetO.[[ProxyTarget]]
  3. handlerO.[[ProxyHandler]]
  4. 断言 handler 是一个 对象
  5. trap 为 ?  GetMethod (handler, "get")。
  6. 如果 trapundefined,则:
    1. 返回 ? target.[[Get]](P, Receiver)
  7. trapResult 为 ?  Call (trap, handler, «target, P, Receiver ») 。
  8. targetDesc 为 ? target.[[GetOwnProperty]](P)
  9. 如果 targetDesc 不是 undefinedtargetDesc.[[Configurable]]false,则:
    1. 如果 IsDataDescriptor (targetDesc) 是 truetargetDesc.[[Writable]]false,则:
      1. 如果 SameValue (trapResult, targetDesc.[[Value]]) 是 false,抛出一个 TypeError 异常。
    2. 如果 IsAccessorDescriptor (targetDesc) 是 true 且 targetDesc.[[Get]]undefined,则:
      1. 如果 trapResult 不是 undefined,抛出一个 TypeError 异常。
  10. 返回 trapResult

Proxy 对象的 [[Get]] 强制执行以下不变量:

  • 如果目标对象属性是一个不可写、不可配置的自身 数据属性 ,则报告的属性值必须与相应的目标对象属性的值相同。
  • 如果相应的目标对象属性是一个不可配置的自身 访问器属性 且其 [[Get]] 属性为 undefined,则报告的属性值必须为 undefined

10.5.9 [[Set]] ( P, V, Receiver )

[[Set]] 内部方法的 Proxy 异质对象 O 接受参数 P(一个 属性键 ),V(一个 ECMAScript 语言值 )和 Receiver(一个 ECMAScript 语言值 ),并返回一个 正常完成记录 ,其包含一个布尔值或返回一个 抛出完成 。调用时执行以下步骤:

  1. 执行 ?  ValidateNonRevokedProxy (O)。
  2. targetO.[[ProxyTarget]]
  3. handlerO.[[ProxyHandler]]
  4. 断言 handler 是一个 对象
  5. trap 为 ?  GetMethod (handler, "set")。
  6. 如果 trapundefined,则:
    1. 返回 ? target.[[Set]](P, V, Receiver)
  7. booleanTrapResult ToBoolean (? Call (trap, handler, «target, P, V, Receiver »))。
  8. 如果 booleanTrapResultfalse,返回 false
  9. targetDesc 为 ? target.[[GetOwnProperty]](P)
  10. 如果 targetDesc 不是 undefinedtargetDesc.[[Configurable]]false,则:
    1. 如果 IsDataDescriptor (targetDesc) 是 true 且 targetDesc.[[Writable]]false,则:
      1. 如果 SameValue (V, targetDesc.[[Value]]) 是 false,抛出一个 TypeError 异常。
    2. 如果 IsAccessorDescriptor (targetDesc) 是 true,则:
      1. 如果 targetDesc.[[Set]]undefined,抛出一个 TypeError 异常。
  11. 返回 true

Proxy 对象的 [[Set]] 强制执行以下不变量:

  • [[Set]] 的结果是一个布尔值。
  • 如果相应的目标对象属性是一个不可写、不可配置的自身 数据属性 ,则不能将属性值更改为与相应的目标对象属性的值不同的值。
  • 如果相应的目标对象属性是一个不可配置的自身 访问器属性 且其 [[Set]] 属性为 undefined,则不能设置该属性的值。

10.5.10 [[Delete]] ( P )

[[Delete]] 内部方法的 Proxy 异质对象 O 接受参数 P(一个 属性键 ),并返回一个 正常完成记录 ,其包含一个布尔值或返回一个 抛出完成 。调用时执行以下步骤:

  1. 执行 ?  ValidateNonRevokedProxy (O)。
  2. targetO.[[ProxyTarget]]
  3. handlerO.[[ProxyHandler]]
  4. 断言 handler 是一个 对象
  5. trap 为 ?  GetMethod (handler, "deleteProperty")。
  6. 如果 trapundefined,则:
    1. 返回 ? target.[[Delete]](P)
  7. booleanTrapResult ToBoolean (? Call (trap, handler, «target, P »))。
  8. 如果 booleanTrapResultfalse,返回 false
  9. targetDesc 为 ? target.[[GetOwnProperty]](P)
  10. 如果 targetDescundefined,返回 true
  11. 如果 targetDesc.[[Configurable]]false,抛出一个 TypeError 异常。
  12. extensibleTarget 为 ?  IsExtensible (target)。
  13. 如果 extensibleTargetfalse,抛出一个 TypeError 异常。
  14. 返回 true

Proxy 对象的 [[Delete]] 强制执行以下不变量:

  • [[Delete]] 的结果是一个布尔值。
  • 如果目标对象存在一个不可配置的自身属性,则不能将其报告为已删除。
  • 如果目标对象存在一个自身属性且目标对象是不可扩展的,则不能将其报告为已删除。

10.5.11 [[OwnPropertyKeys]] ( )

[[OwnPropertyKeys]] 内部方法的 Proxy 异质对象 O 不接受任何参数,并返回一个 正常完成记录 ,其包含一个 列表 属性键 或返回一个 抛出完成 。调用时执行以下步骤:

  1. 执行 ?  ValidateNonRevokedProxy (O)。
  2. targetO.[[ProxyTarget]]
  3. handlerO.[[ProxyHandler]]
  4. 断言 handler 是一个 对象
  5. trap 为 ?  GetMethod (handler, "ownKeys")。
  6. 如果 trapundefined,则:
    1. 返回 ? target.[[OwnPropertyKeys]]()
  7. trapResultArray 为 ?  Call (trap, handler, «target »)。
  8. trapResult 为 ?  CreateListFromArrayLike (trapResultArray, «String, Symbol »)。
  9. 如果 trapResult 包含任何重复项,抛出一个 TypeError 异常。
  10. extensibleTarget 为 ?  IsExtensible (target)。
  11. targetKeys 为 ? target.[[OwnPropertyKeys]]()
  12. 断言 targetKeys 是一个包含 列表 属性键
  13. 断言 targetKeys 不包含重复项。
  14. targetConfigurableKeys 为一个新的空 列表
  15. targetNonconfigurableKeys 为一个新的空 列表
  16. 对于 targetKeys 的每个元素 key,执行以下步骤:
    1. desc 为 ? target.[[GetOwnProperty]](key)
    2. 如果 desc 不是 undefineddesc.[[Configurable]]false,则:
      1. key 追加到 targetNonconfigurableKeys
    3. 否则:
      1. key 追加到 targetConfigurableKeys
  17. 如果 extensibleTargettruetargetNonconfigurableKeys 为空,则:
    1. 返回 trapResult
  18. uncheckedResultKeys 为一个包含 trapResult 元素的 列表
  19. 对于 targetNonconfigurableKeys 的每个元素 key,执行以下步骤:
    1. 如果 uncheckedResultKeys 不包含 key,抛出一个 TypeError 异常。
    2. uncheckedResultKeys 中移除 key
  20. 如果 extensibleTargettrue,返回 trapResult
  21. 对于 targetConfigurableKeys 的每个元素 key,执行以下步骤:
    1. 如果 uncheckedResultKeys 不包含 key,抛出一个 TypeError 异常。
    2. uncheckedResultKeys 中移除 key
  22. 如果 uncheckedResultKeys 不为空,抛出一个 TypeError 异常。
  23. 返回 trapResult

Proxy 对象的 [[OwnPropertyKeys]] 强制执行以下不变量:

  • [[OwnPropertyKeys]] 的结果是一个 列表
  • 返回的 列表 不包含重复项。
  • 每个结果 列表 元素的类型是字符串或符号。
  • 结果 列表 必须包含目标对象所有不可配置自身属性的键。
  • 如果目标对象是不可扩展的,则结果 列表 必须包含目标对象自身属性的所有键且不包含其他值。

10.5.12 [[Call]] ( thisArgument, argumentsList )

[[Call]] 内部方法用于 Proxy 异域对象 O。它接受参数 thisArgument(一个 ECMAScript 语言值)和 argumentsList(一个 列表,包含 ECMAScript 语言值),并返回一个包含 正常完成记录,其中包含一个 ECMAScript 语言值 或者一个 抛出完成记录。它在被调用时执行以下步骤:

  1. 执行 ? ValidateNonRevokedProxy(O).
  2. target 等于 O.[[ProxyTarget]].
  3. handler 等于 O.[[ProxyHandler]].
  4. 断言: handler 是一个对象。
  5. trap 等于 ? GetMethod(handler, "apply").
  6. 如果 trap 是 undefined,则
    1. 返回 ? Call(target, thisArgument, argumentsList).
  7. argArray 等于 CreateArrayFromList(argumentsList).
  8. 返回 ? Call(trap, handler, « target, thisArgument, argArray »).

Proxy 异域对象 只有在其 [[ProxyTarget]] 内部槽的初始值是一个具有 [[Call]] 内部方法的对象时,才具有 [[Call]] 内部方法。

10.5.13 [[Construct]] ( argumentsList, newTarget )

[[Construct]] 内部方法用于 Proxy 异域对象 O。它接受参数 argumentsList(一个 列表,包含 ECMAScript 语言值)和 newTarget(一个 构造函数),并返回一个包含对象的 正常完成记录 或一个 抛出完成记录。它在被调用时执行以下步骤:

  1. 执行 ? ValidateNonRevokedProxy(O).
  2. target 等于 O.[[ProxyTarget]].
  3. 断言: IsConstructor(target) 为 true。
  4. handler 等于 O.[[ProxyHandler]].
  5. 断言: handler 是一个对象。
  6. trap 等于 ? GetMethod(handler, "construct").
  7. 如果 trap 是 undefined,则
    1. 返回 ? Construct(target, argumentsList, newTarget).
  8. argArray 等于 CreateArrayFromList(argumentsList).
  9. newObj 等于 ? Call(trap, handler, « target, argArray, newTarget »).
  10. 如果 newObj 不是一个对象,抛出一个 TypeError 异常。
  11. 返回 newObj.
注 1

Proxy 异域对象 只有在其 [[ProxyTarget]] 内部槽的初始值是一个具有 [[Construct]] 内部方法的对象时,才具有 [[Construct]] 内部方法。

注 2

[[Construct]] 对于 Proxy 对象强制执行以下不变量:

  • [[Construct]] 的结果必须是一个对象。

10.5.14 ValidateNonRevokedProxy ( proxy )

抽象操作 ValidateNonRevokedProxy 接受参数 proxy(一个 Proxy 异域对象),并返回包含 正常完成记录unused 或者一个 抛出完成记录。如果 proxy 已被撤销,则抛出 TypeError 异常。它在被调用时执行以下步骤:

  1. 如果 proxy.[[ProxyTarget]]null,抛出 TypeError 异常。
  2. 断言: proxy.[[ProxyHandler]] 不是 null
  3. 返回 unused

10.5.15 ProxyCreate ( target, handler )

抽象操作 ProxyCreate 接受参数 target(一个 ECMAScript 语言值)和 handler(一个 ECMAScript 语言值),并返回包含 正常完成记录Proxy 异域对象 或一个 抛出完成记录。它用于指定新 Proxy 对象的创建。它在被调用时执行以下步骤:

  1. 如果 target 不是一个对象,抛出 TypeError 异常。
  2. 如果 handler 不是一个对象,抛出 TypeError 异常。
  3. P 等于 MakeBasicObject[[ProxyHandler]], [[ProxyTarget]] »)。
  4. 设置 P 的基本内部方法,除了 [[Call]][[Construct]],按照 10.5 中的定义。
  5. 如果 IsCallable(target) 为 true,则
    1. 设置 P.[[Call]],如 10.5.12 中所述。
    2. 如果 IsConstructor(target) 为 true,则
      1. 设置 P.[[Construct]],如 10.5.13 中所述。
  6. 设置 P.[[ProxyTarget]]target
  7. 设置 P.[[ProxyHandler]]handler
  8. 返回 P

11 ECMAScript 语言:源代码

11.1 源代码

语法

SourceCharacter :: 任何 Unicode 代码点

ECMAScript 源代码 是一系列 Unicode 代码点。在 ECMAScript 语法允许的地方,所有从 U+0000 到 U+10FFFF 的 Unicode 代码点值,包括代理代码点,都可以出现在 ECMAScript 源代码中。用于存储和交换 ECMAScript 源代码的实际编码与本规范无关。不论外部源代码编码如何,符合规范的 ECMAScript 实现都将源代码处理为等效的 SourceCharacter 值序列,每个 SourceCharacter 都是一个 Unicode 代码点。符合规范的 ECMAScript 实现不要求对源代码进行任何规范化,或表现得像在执行源代码的规范化。

组合字符序列的组成部分被视为单独的 Unicode 代码点,即使用户可能将整个序列视为一个字符。

在字符串字面量、正则表达式字面量、模板字面量和标识符中,任何 Unicode 代码点也可以使用 Unicode 转义序列来表示,显式表达代码点的数值。在注释中,这样的转义序列实际上被忽略,作为注释的一部分。

ECMAScript 与 Java 编程语言在 Unicode 转义序列的行为上有所不同。例如,在 Java 程序中,如果 Unicode 转义序列 \u000A 出现在单行注释中,它会被解释为行终止符(Unicode 代码点 U+000A 是换行符(LF)),因此下一个代码点不再是注释的一部分。同样,如果 Unicode 转义序列 \u000A 出现在 Java 程序的字符串字面量中,它也会被解释为行终止符,字符串字面量中不允许有行终止符——必须写成 \n 而不是 \u000A,以使换行符(LF)成为字符串字面量的字符串值的一部分。在 ECMAScript 程序中,出现在注释中的 Unicode 转义序列从不被解释,因此不能终止注释。同样,出现在 ECMAScript 程序的字符串字面量中的 Unicode 转义序列始终是字面量的一部分,永远不会被解释为行终止符或可能终止字符串字面量的代码点。

11.1.1 静态语义: UTF16EncodeCodePoint ( cp )

抽象操作 UTF16EncodeCodePoint 接受参数 cp(一个 Unicode 代码点)并返回一个字符串。调用时,它执行以下步骤:

  1. 断言: 0 ≤ cp ≤ 0x10FFFF。
  2. 如果 cp ≤ 0xFFFF,返回由数值为 cp 的代码单元组成的字符串值。
  3. cu1 为数值为 向下取整((cp - 0x10000) / 0x400) + 0xD800 的代码单元。
  4. cu2 为数值为 ((cp - 0x10000) 0x400) + 0xDC00 的代码单元。
  5. 返回 字符串连接 cu1cu2 的结果。

11.1.2 静态语义: CodePointsToString ( text )

抽象操作 CodePointsToString 接受参数 text(一个 Unicode 代码点序列)并返回一个字符串。它将 text 转换为字符串值,如 6.1.4 中所述。调用时,它执行以下步骤:

  1. result 为空字符串。
  2. 对于 text 中的每个代码点 cp,执行以下步骤
    1. result 设为 字符串连接 resultUTF16EncodeCodePoint(cp) 的结果。
  3. 返回 result

11.1.3 静态语义: UTF16SurrogatePairToCodePoint ( lead, trail )

抽象操作 UTF16SurrogatePairToCodePoint 接受参数 lead(一个代码单元)和 trail(一个代码单元),并返回一个代码点。形成 UTF-16 代理对 的两个代码单元将转换为一个代码点。调用时,它执行以下步骤:

  1. 断言: lead 是一个 前导代理项 并且 trail 是一个 尾随代理项
  2. cp 为 (lead - 0xD800) × 0x400 + (trail - 0xDC00) + 0x10000。
  3. 返回代码点 cp

11.1.4 静态语义: CodePointAt ( string, position )

抽象操作 CodePointAt 接受参数 string(一个字符串)和 position(一个非负 整数),并返回一个包含字段 [[CodePoint]](一个代码点)、[[CodeUnitCount]](一个正的 整数)、[[IsUnpairedSurrogate]](一个布尔值)的 记录。它将 string 解释为 UTF-16 编码的代码点序列,如 6.1.4 中所述,并从索引 position 处的代码单元开始读取单个代码点。调用时,它执行以下步骤:

  1. sizestring 的长度。
  2. 断言: position ≥ 0 并且 position < size
  3. firststring 内索引 position 处的代码单元。
  4. cp 为数值为 first 的代码点。
  5. 如果 first 既不是 前导代理项 也不是 尾随代理项,则
    1. 返回 记录 { [[CodePoint]]: cp, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]: false }。
  6. 如果 first尾随代理项 或者 position + 1 = size,则
    1. 返回 记录 { [[CodePoint]]: cp, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]: true }。
  7. secondstring 内索引 position + 1 处的代码单元。
  8. 如果 second 不是 尾随代理项,则
    1. 返回 记录 { [[CodePoint]]: cp, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]: true }。
  9. cp 设置为 UTF16SurrogatePairToCodePoint(first, second)。
  10. 返回 记录 { [[CodePoint]]: cp, [[CodeUnitCount]]: 2, [[IsUnpairedSurrogate]]: false }。

11.1.5 静态语义: StringToCodePoints ( string )

抽象操作 StringToCodePoints 接受参数 string(一个字符串)并返回一个代码点的 列表。它返回将 string 解释为 UTF-16 编码的 Unicode 文本后得到的 Unicode 代码点序列,如 6.1.4 中所述。调用时,它执行以下步骤:

  1. codePoints 为一个新的空的 列表
  2. sizestring 的长度。
  3. position 为 0。
  4. 重复,当 position 小于 size 时,
    1. cpCodePointAt(string, position)。
    2. cp.[[CodePoint]] 添加到 codePoints
    3. position 设置为 position + cp.[[CodeUnitCount]]
  5. 返回 codePoints

11.1.6 静态语义: ParseText ( sourceText, goalSymbol )

抽象操作 ParseText 接受参数 sourceText(一个 Unicode 代码点序列)和 goalSymbol(ECMAScript 语法中的一个非终结符)并返回一个 解析节点或一个非空的 列表,其中包含 SyntaxError 对象。调用时,它执行以下步骤:

  1. 尝试使用 goalSymbol 作为目标符号解析 sourceText,并分析解析结果是否有 早期错误条件。解析和 早期错误检测可以以 实现定义 的方式交错进行。
  2. 如果解析成功且没有发现早期错误,则返回解析节点goalSymbol 的一个实例),该节点位于解析树的根节点。
  3. 否则,返回一个包含一个或多个 SyntaxError 对象的列表,这些对象表示解析错误和/或 早期错误。如果存在多个解析错误或 早期错误,则列表中的错误对象数量和排序是实现定义的,但至少必须存在一个。
注 1

考虑一个在特定点有早期错误的文本,并且在后续点有语法错误。一个先进行解析然后进行早期错误检测的实现可能会报告语法错误并且不进行早期错误检测。一个将两者交错进行的实现可能会报告早期错误并且不继续发现语法错误。第三个实现可能会报告两个错误。这些行为都是符合规范的。

注 2

另见第 17 节。

11.2 Types of Source Code

有四种类型的 ECMAScript 代码:

Note 1

Function code 通常以函数定义的主体形式提供(15.2),箭头函数定义(15.3),方法定义(15.4),生成器函数定义(15.5),异步函数定义(15.8),异步生成器函数定义(15.6),和异步箭头函数(15.9)。Function code 也来源于 Function 构造函数(constructor)(20.2.1.1),GeneratorFunction 构造函数(constructor)(27.3.1.1),以及 AsyncFunction 构造函数(constructor)(27.7.1.1)的参数。

Note 2

BindingIdentifier 包含在函数代码中的实际效果是,即使周围代码不是 严格模式代码,包含 "use strict" 指令的函数体名称为 BindingIdentifier 的函数仍然会应用 严格模式代码 的早期错误。

11.2.1 指令序言和 "use strict" 指令

指令序言 是出现在 StatementListItemModuleItem 的初始位置处的最长序列 ExpressionStatement。这些 ExpressionStatement 以一个 StringLiteral 标记及后续的分号组成。这个分号可以是显式的,也可以由自动分号插入 (12.10)。 指令序言 可以是一个空序列。

"use strict" 指令 是出现在 指令序言 中的 ExpressionStatement,其 StringLiteral 为精确的代码点序列 "use strict"'use strict'"use strict" 指令 不应包含 EscapeSequenceLineContinuation

指令序言 可以包含多个 "use strict" 指令。 但是,如果出现这种情况,实施可能会发出警告。

ExpressionStatement 在包含生成中的正常评估中被评估。实现可以为出现在 指令序言 中 但不是 "use strict" 指令ExpressionStatement 定义特定的含义。 如果存在适当的通知机制,则在 指令序言 中 碰到不是 "use strict" 指令 并且 没有实现定义含义的 ExpressionStatement 时,实现应发出警告。

11.2.2 严格模式代码

ECMAScript 语法单元可以使用无限制或严格模式语法和语义进行处理 (4.3.2)。在以下情况下,代码被解释为 严格模式代码

不是严格模式代码的 ECMAScript 代码称为 非严格代码

11.2.3 非 ECMAScript 函数

ECMAScript 实现可能支持对函数 异质对象 的求值,其求值行为以某种 宿主定义 的可执行代码形式表达,而不是 ECMAScript 源文本。无论 函数对象 是在 ECMAScript 代码中定义的,还是内置函数,从调用或被调用的 ECMAScript 代码的角度来看,都是不可观察的。

12 ECMAScript 语言:词法语法

ECMAScript 脚本模块的源文本首先被转换为一系列输入元素,这些输入元素包括标记、行终止符、注释或空白。源文本从左到右扫描,反复采用最长可能的代码点序列作为下一个输入元素。

在多个情况下,词法输入元素的识别对消耗输入元素的语法语境是敏感的。这需要词法语法的多个目标符号InputElementHashbangOrRegExp目标在脚本模块的开头使用。InputElementRegExpOrTemplateTail目标在语法语境中使用,其中允许正则表达式文本模板中间模板尾部InputElementRegExp目标符号在所有允许正则表达式文本但不允许模板中间模板尾部的语法语境中使用。InputElementTemplateTail目标在所有允许模板中间模板尾部但不允许正则表达式文本的语法语境中使用。在所有其他语境中,InputElementDiv用作词法目标符号

Note

使用多个词法目标确保没有词法歧义会影响自动分号插入。例如,没有语法语境同时允许前导除法或除法赋值和前导正则表达式文本。这不受分号插入的影响(见12.10);例如以下情况:

a = b
/hi/g.exec(c).map(d);

在一个行终止符之后的第一个非空白、非注释代码点是U+002F(SOLIDUS),且语法上下文允许除法或除法赋值,不会在行终止符处插入分号。也就是说,上述示例的解释方式与以下相同:

a = b / hi / g.exec(c).map(d);

语法

InputElementDiv :: WhiteSpace LineTerminator Comment CommonToken DivPunctuator RightBracePunctuator InputElementRegExp :: WhiteSpace LineTerminator Comment CommonToken RightBracePunctuator RegularExpressionLiteral InputElementRegExpOrTemplateTail :: WhiteSpace LineTerminator Comment CommonToken RegularExpressionLiteral TemplateSubstitutionTail InputElementTemplateTail :: WhiteSpace LineTerminator Comment CommonToken DivPunctuator TemplateSubstitutionTail InputElementHashbangOrRegExp :: WhiteSpace LineTerminator Comment CommonToken HashbangComment RegularExpressionLiteral

12.1 Unicode 格式控制字符

Unicode 格式控制字符(即 Unicode 字符数据库中类别为 “Cf” 的字符,如左到右标记或右到左标记)是用于在缺乏高级协议(如标记语言)的情况下控制一段文本格式的控制代码。

允许在源文本中使用格式控制字符以便于编辑和显示是很有用的。所有格式控制字符都可以在注释、字符串字面量、模板字面量和正则表达式字面量中使用。

U+200C(零宽非连接符)和 U+200D(零宽连接符)是用于在某些语言中形成单词或短语时进行必要区分的格式控制字符。在 ECMAScript 源文本 中,这些代码点也可以在第一个字符之后用于 IdentifierName 中。

U+FEFF(零宽不换行空格)是主要用于文本开头的格式控制字符,用来标记它为 Unicode 并允许检测文本的编码和字节顺序。出于这种目的而使用的 <ZWNBSP> 字符有时也会出现在文本的开头之后,例如由于文件连接的结果。在 ECMAScript 源文本 中,<ZWNBSP> 代码点被视为空白字符(见 12.2)。

某些格式控制字符在注释、字符串字面量和正则表达式字面量之外的特殊处理在 表 35 中总结。

表 35: 格式控制代码点的使用
代码点 名称 缩写 用法
U+200C 零宽非连接符 <ZWNJ> IdentifierPart
U+200D 零宽连接符 <ZWJ> IdentifierPart
U+FEFF 零宽不换行空格 <ZWNBSP> WhiteSpace

12.2 空白符

空白符代码点用于提高源文本的可读性,并将词法单元(不可分割的词法单位)彼此分开,但除此之外没有其他意义。空白符代码点可以出现在任意两个词法单元之间,以及输入的开头或结尾。空白符代码点可以出现在 StringLiteralRegularExpressionLiteralTemplateTemplateSubstitutionTail 中,在这些情况下,它们被视为构成字面值一部分的有效代码点。它们也可以出现在 Comment 中,但不能出现在任何其他类型的词法单元中。

ECMAScript 的空白符代码点列在 表 36 中。

表 36: 空白符代码点
代码点 名称 缩写
U+0009 CHARACTER TABULATION <TAB>
U+000B LINE TABULATION <VT>
U+000C FORM FEED (FF) <FF>
U+FEFF ZERO WIDTH NO-BREAK SPACE <ZWNBSP>
general category 中的任意代码点 “Space_Separator” <USP>
注 1

U+0020 (SPACE) 和 U+00A0 (NO-BREAK SPACE) 代码点是 <USP> 的一部分。

注 2

除了表 表 36 中列出的代码点外,ECMAScript 的 WhiteSpace 有意排除了所有具有 Unicode “White_Space” 属性但未分类为 general category “Space_Separator” (“Zs”) 的代码点。

语法

WhiteSpace :: <TAB> <VT> <FF> <ZWNBSP> <USP>

12.3 行终止符

像空白符代码点一样,行终止符代码点用于提高源文本的可读性,并将词法单元(不可分割的词法单位)彼此分开。然而,与空白符代码点不同,行终止符对语法规则的行为有一定影响。通常,行终止符可以出现在任意两个词法单元之间,但在某些地方,语法规则禁止它们的出现。行终止符还会影响自动分号插入的过程(12.10)。行终止符不能出现在任何词法单元内部,除了 StringLiteralTemplateTemplateSubstitutionTail。<LF> 和 <CR> 行终止符不能出现在 StringLiteral 词法单元中,除非作为 LineContinuation 的一部分。

行终止符可以出现在 MultiLineComment 中,但不能出现在 SingleLineComment 中。

行终止符包含在正则表达式中的 \s 类匹配的空白符代码点集合中。

ECMAScript 行终止符代码点列在 表 37 中。

表 37: 行终止符代码点
代码点 Unicode 名称 缩写
U+000A LINE FEED (LF) <LF>
U+000D CARRIAGE RETURN (CR) <CR>
U+2028 LINE SEPARATOR <LS>
U+2029 PARAGRAPH SEPARATOR <PS>

只有表 表 37 中的 Unicode 代码点被视为行终止符。其他新的行或换行 Unicode 代码点不被视为行终止符,但如果它们符合 表 36 中列出的要求,则被视为空白符。序列 <CR><LF> 通常用作行终止符。出于报告行号的目的,应将其视为单个 SourceCharacter

语法

LineTerminator :: <LF> <CR> <LS> <PS> LineTerminatorSequence :: <LF> <CR> [lookahead ≠ <LF>] <LS> <PS> <CR> <LF>

12.4 注释

注释可以是单行或多行。多行注释不能嵌套。

由于单行注释可以包含任何 Unicode 代码点,除了 LineTerminator 代码点,并且由于通用规则是词法单元总是尽可能长,因此单行注释总是由 // 标记到行尾的所有代码点组成。然而,行尾的 LineTerminator 不被视为单行注释的一部分;它由词法语法单独识别,并成为语法解析的输入元素流的一部分。这一点非常重要,因为它意味着单行注释的存在或不存在不会影响自动分号插入的过程(见 12.10)。

注释表现得像空白符,并被丢弃,除了如果一个 MultiLineComment 包含一个行终止符代码点,那么整个注释将被视为 LineTerminator,以便语法解析。

语法

Comment :: MultiLineComment SingleLineComment MultiLineComment :: /* MultiLineCommentCharsopt */ MultiLineCommentChars :: MultiLineNotAsteriskChar MultiLineCommentCharsopt * PostAsteriskCommentCharsopt PostAsteriskCommentChars :: MultiLineNotForwardSlashOrAsteriskChar MultiLineCommentCharsopt * PostAsteriskCommentCharsopt MultiLineNotAsteriskChar :: SourceCharacter 但不包括 * MultiLineNotForwardSlashOrAsteriskChar :: SourceCharacter 但不包括 /* SingleLineComment :: // SingleLineCommentCharsopt SingleLineCommentChars :: SingleLineCommentChar SingleLineCommentCharsopt SingleLineCommentChar :: SourceCharacter 但不包括 LineTerminator

本节中的一些规则在 B.1.1 中给出了替代定义。

12.5 Hashbang 注释

Hashbang 注释是位置敏感的,并且像其他类型的注释一样,从语法解析的输入元素流中被丢弃。

语法

HashbangComment :: #! SingleLineCommentCharsopt

12.6 词法单元(Tokens)

语法

CommonToken :: IdentifierName PrivateIdentifier Punctuator NumericLiteral StringLiteral Template Note

DivPunctuator, RegularExpressionLiteral, RightBracePunctuator, 和 TemplateSubstitutionTail 派生了其他不包含在 CommonToken 生产式中的词法单元。

12.7 名称和关键字

IdentifierNameReservedWord 是根据 Unicode Standard Annex #31, Identifier and Pattern Syntax 所给出的默认标识符语法解释的词法单元,并进行了一些小的修改。 ReservedWordIdentifierName 的一个枚举子集。语法定义了 Identifier 为不属于 ReservedWordIdentifierName 。Unicode 标识符语法基于 Unicode 标准所定义的字符属性。所有符合 ECMAScript 实现的标识符都必须按照最新版本的 Unicode 标准中的指定类别处理 Unicode 代码点。ECMAScript 实现可以识别在 Unicode 标准的后续版本中定义的标识符代码点。

注 1

本标准指定了特定的代码点添加:U+0024 (美元符号) 和 U+005F (下划线) 在 IdentifierName 的任何地方都允许使用,并且 U+200C (零宽度非连接符) 和 U+200D (零宽度连接符) 在 IdentifierName 的第一个代码点之后的任何地方都允许使用。

语法

PrivateIdentifier :: # IdentifierName IdentifierName :: IdentifierStart IdentifierName IdentifierPart IdentifierStart :: IdentifierStartChar \ UnicodeEscapeSequence IdentifierPart :: IdentifierPartChar \ UnicodeEscapeSequence IdentifierStartChar :: UnicodeIDStart $ _ IdentifierPartChar :: UnicodeIDContinue $ <ZWNJ> <ZWJ> AsciiLetter :: one of a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z UnicodeIDStart :: 任何具有 Unicode 属性 “ID_Start” 的 Unicode 代码点 UnicodeIDContinue :: 任何具有 Unicode 属性 “ID_Continue” 的 Unicode 代码点

UnicodeEscapeSequence 的非终结符定义见 12.9.4

注 2

非终结符 IdentifierPart 通过 UnicodeIDContinue 派生出 _

注 3

具有 Unicode 属性 “ID_Start” 和 “ID_Continue” 的代码点集合分别包括具有 Unicode 属性 “Other_ID_Start” 和 “Other_ID_Continue” 的代码点。

12.7.1 标识符名称

IdentifierName 中允许使用 Unicode 转义序列,其中它们贡献了一个等于 IdentifierCodePoint 的单个 Unicode 代码点 UnicodeEscapeSequence 。在转义序列前的 \ 不贡献任何代码点。Unicode 转义序列不能用于对 IdentifierName 贡献一个代码点,该代码点本来就是无效的。换句话说,如果将 \ Unicode 转义序列替换为它所贡献的 SourceCharacter ,结果仍然必须是一个有效的 IdentifierName ,并且与原始的 IdentifierName 拥有完全相同的 SourceCharacter 序列。在本规范中的所有标识符名称解释都是基于它们的实际代码点的,无论是否使用转义序列对任何特定的代码点进行贡献。

根据 Unicode 标准,两个规范等效的 IdentifierName 是不相等的,除非在替换每个 Unicode 转义序列后,它们由完全相同的代码点序列表示。

12.7.1.1 静态语义:早期错误

IdentifierStart :: \ UnicodeEscapeSequence IdentifierPart :: \ UnicodeEscapeSequence

12.7.1.2 静态语义:IdentifierCodePoints

语法导向操作 IdentifierCodePoints 不接受任何参数,并返回一个代码点列表。它在以下各生成式上分段定义:

IdentifierName :: IdentifierStart
  1. cpIdentifierCodePointIdentifierStart
  2. 返回 « cp »。
IdentifierName :: IdentifierName IdentifierPart
  1. cpsIdentifierCodePoints 派生出的 IdentifierName
  2. cpIdentifierCodePointIdentifierPart
  3. 返回 列表串联cps 和 « cp »。

12.7.1.3 静态语义:IdentifierCodePoint

语法导向操作 IdentifierCodePoint 不接受任何参数并返回一个代码点。它在以下各生成式上分段定义:

IdentifierStart :: IdentifierStartChar
  1. 返回 IdentifierStartChar 匹配的代码点。
IdentifierPart :: IdentifierPartChar
  1. 返回 IdentifierPartChar 匹配的代码点。
UnicodeEscapeSequence :: u Hex4Digits
  1. 返回数值为 Hex4Digits 的代码点。
UnicodeEscapeSequence :: u{ CodePoint }
  1. 返回数值为 CodePoint 的代码点。

12.7.2 关键字和保留字

关键字 是一个与 IdentifierName 匹配的词法单元,但它还有一个语法用途;也就是说,它以某种语法形式出现在某些语法生成式中,例如 ifwhileasyncawait 等。

保留字 是一个不能用作标识符的 IdentifierName 。许多关键字都是保留字,但有些不是,有些仅在某些上下文中是保留的。例如 ifwhile 是保留字,await 仅在异步函数和模块中是保留的,而 async 不是保留的,它可以在变量名或语句标签中使用。

本规范使用语法生成式和 早期错误 规则的组合来指定哪些名称是有效标识符,哪些是保留字。下面列出的所有 ReservedWord ,除了 awaityield,都是无条件保留的。awaityield 的例外情况在 13.1 中进行了说明,使用了参数化的语法生成式。最后,一些早期错误规则限制了有效标识符的集合。请参阅 13.1.114.3.1.114.7.5.1 ,以及 15.7.1 。总的来说,有五类标识符名称:

  • 那些始终允许作为标识符使用的,不是关键字的名称,例如 MathwindowtoString_;

  • 那些永远不允许作为标识符使用的名称,即下面列出的 ReservedWord(除了 awaityield);

  • 那些在特定上下文中允许作为标识符使用的名称,即 awaityield;

  • 那些在 严格模式代码 中上下文不允许作为标识符使用的名称:letstaticimplementsinterfacepackageprivateprotectedpublic;

  • 那些始终允许作为标识符使用,但在某些语法生成式中的某些地方也出现为关键字的名称,即 Identifier 不允许:asasyncfromgetmetaofsettarget

术语 条件关键字上下文关键字 有时用来指在上述最后三类中的关键字,这些关键字可以在某些上下文中作为标识符使用,而在其他上下文中作为关键字使用。

语法

ReservedWord :: 之一 await break case catch class const continue debugger default delete do else enum export extends false finally for function if import in instanceof new null return super switch this throw true try typeof var void while with yield 注 1

根据 5.1.5 ,语法中的关键字匹配特定 SourceCharacter 元素的字面序列。关键字中的代码点不能通过 \ Unicode 转义序列表示。

IdentifierName 可以包含 \ UnicodeEscapeSequence ,但不能通过拼写 els\u{65} 来声明一个名为 "else" 的变量。 早期错误 规则在 13.1.1 中排除了与保留字具有相同 StringValue 的标识符。

注 2

enum 目前在本规范中不作为关键字使用。它是一个 未来保留字,为将来的语言扩展预留。

同样,implementsinterfacepackageprivateprotectedpublic严格模式代码 中是未来保留字。

注 3

名称 argumentseval 不是关键字,但在 严格模式代码 中受到一些限制。请参阅 13.1.18.6.415.2.115.5.115.6.1 ,以及 15.8.1

12.8 标点符号

语法

Punctuator :: OptionalChainingPunctuator OtherPunctuator OptionalChainingPunctuator :: ?. [lookahead ∉ DecimalDigit ] OtherPunctuator :: 之一 { ( ) [ ] . ... ; , < > <= >= == != === !== + - * % ** ++ -- << >> >>> & | ^ ! ~ && || ?? ? : = += -= *= %= **= <<= >>= >>>= &= |= ^= &&= ||= ??= => DivPunctuator :: / /= RightBracePunctuator :: }

12.9 字面量

12.9.1 Null 字面量

语法

NullLiteral :: null

12.9.2 布尔字面量

语法

BooleanLiteral :: true false

12.9.3 数值字面量

语法

NumericLiteralSeparator :: _ NumericLiteral :: DecimalLiteral DecimalBigIntegerLiteral NonDecimalIntegerLiteral[+Sep] NonDecimalIntegerLiteral[+Sep] BigIntLiteralSuffix LegacyOctalIntegerLiteral DecimalBigIntegerLiteral :: 0 BigIntLiteralSuffix NonZeroDigit DecimalDigits[+Sep]opt BigIntLiteralSuffix NonZeroDigit NumericLiteralSeparator DecimalDigits[+Sep] BigIntLiteralSuffix NonDecimalIntegerLiteral[Sep] :: BinaryIntegerLiteral[?Sep] OctalIntegerLiteral[?Sep] HexIntegerLiteral[?Sep] BigIntLiteralSuffix :: n DecimalLiteral :: DecimalIntegerLiteral . DecimalDigits[+Sep]opt ExponentPart[+Sep]opt . DecimalDigits[+Sep] ExponentPart[+Sep]opt DecimalIntegerLiteral ExponentPart[+Sep]opt DecimalIntegerLiteral :: 0 NonZeroDigit NonZeroDigit NumericLiteralSeparatoropt DecimalDigits[+Sep] NonOctalDecimalIntegerLiteral DecimalDigits[Sep] :: DecimalDigit DecimalDigits[?Sep] DecimalDigit [+Sep] DecimalDigits[+Sep] NumericLiteralSeparator DecimalDigit DecimalDigit :: one of 0 1 2 3 4 5 6 7 8 9 NonZeroDigit :: one of 1 2 3 4 5 6 7 8 9 ExponentPart[Sep] :: ExponentIndicator SignedInteger[?Sep] ExponentIndicator :: one of e E SignedInteger[Sep] :: DecimalDigits[?Sep] + DecimalDigits[?Sep] - DecimalDigits[?Sep] BinaryIntegerLiteral[Sep] :: 0b BinaryDigits[?Sep] 0B BinaryDigits[?Sep] BinaryDigits[Sep] :: BinaryDigit BinaryDigits[?Sep] BinaryDigit [+Sep] BinaryDigits[+Sep] NumericLiteralSeparator BinaryDigit BinaryDigit :: one of 0 1 OctalIntegerLiteral[Sep] :: 0o OctalDigits[?Sep] 0O OctalDigits[?Sep] OctalDigits[Sep] :: OctalDigit OctalDigits[?Sep] OctalDigit [+Sep] OctalDigits[+Sep] NumericLiteralSeparator OctalDigit LegacyOctalIntegerLiteral :: 0 OctalDigit LegacyOctalIntegerLiteral OctalDigit NonOctalDecimalIntegerLiteral :: 0 NonOctalDigit LegacyOctalLikeDecimalIntegerLiteral NonOctalDigit NonOctalDecimalIntegerLiteral DecimalDigit LegacyOctalLikeDecimalIntegerLiteral :: 0 OctalDigit LegacyOctalLikeDecimalIntegerLiteral OctalDigit OctalDigit :: one of 0 1 2 3 4 5 6 7 NonOctalDigit :: one of 8 9 HexIntegerLiteral[Sep] :: 0x HexDigits[?Sep] 0X HexDigits[?Sep] HexDigits[Sep] :: HexDigit HexDigits[?Sep] HexDigit [+Sep] HexDigits[+Sep] NumericLiteralSeparator HexDigit 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

紧跟在 SourceCharacter 后面的 NumericLiteral 不能是 IdentifierStartDecimalDigit

例如:3in 是错误的,而不是两个输入元素 3in

12.9.3.1 静态语义:早期错误

NumericLiteral :: LegacyOctalIntegerLiteral DecimalIntegerLiteral :: NonOctalDecimalIntegerLiteral
非严格模式代码 中,这种语法是 遗留的

12.9.3.2 静态语义:MV

数值字面量表示 Number 类型BigInt 类型 的值。

12.9.3.3 静态语义:NumericValue

语法定向操作 NumericValue 不接受参数,并返回一个 Number 或 BigInt。它在以下产生式上逐段定义:

NumericLiteral :: DecimalLiteral
  1. 返回 RoundMVResult(DecimalLiteral 的 MV)。
NumericLiteral :: NonDecimalIntegerLiteral
  1. 返回 𝔽(NonDecimalIntegerLiteral 的 MV)。
NumericLiteral :: LegacyOctalIntegerLiteral
  1. 返回 𝔽(LegacyOctalIntegerLiteral 的 MV)。
NumericLiteral :: NonDecimalIntegerLiteral BigIntLiteralSuffix
  1. 返回 BigInt 值 的 MV NonDecimalIntegerLiteral
DecimalBigIntegerLiteral :: 0 BigIntLiteralSuffix
  1. 返回 0
DecimalBigIntegerLiteral :: NonZeroDigit BigIntLiteralSuffix
  1. 返回 BigInt 值 的 MV NonZeroDigit
DecimalBigIntegerLiteral :: NonZeroDigit DecimalDigits BigIntLiteralSuffix NonZeroDigit NumericLiteralSeparator DecimalDigits BigIntLiteralSuffix
  1. nDecimalDigits 中代码点的数量,排除所有 NumericLiteralSeparator 的出现。
  2. mv 为 (NonZeroDigit 的 MV × 10n) 加上 DecimalDigits 的 MV。
  3. 返回 (mv)。

12.9.4 字符串字面量

注 1

字符串字面量是用单引号或双引号括起来的 0 个或更多 Unicode 代码点。Unicode 代码点也可以通过转义序列表示。除了闭合引号的代码点、U+005C(反斜杠)、U+000D(回车符)和 U+000A(换行符)外,所有代码点都可以直接出现在字符串字面量中。任何代码点都可以以转义序列的形式出现。字符串字面量求值为 ECMAScript 字符串值。在生成这些字符串值时,Unicode 代码点按照 11.1.1 中定义的方式进行 UTF-16 编码。属于基本多文种平面的代码点编码为字符串的单个代码单元元素。所有其他代码点编码为字符串的两个代码单元元素。

语法

StringLiteral :: " DoubleStringCharactersopt " ' SingleStringCharactersopt ' DoubleStringCharacters :: DoubleStringCharacter DoubleStringCharactersopt SingleStringCharacters :: SingleStringCharacter SingleStringCharactersopt DoubleStringCharacter :: SourceCharacter but not one of " or \ or LineTerminator <LS> <PS> \ EscapeSequence LineContinuation SingleStringCharacter :: SourceCharacter but not one of ' or \ or LineTerminator <LS> <PS> \ EscapeSequence LineContinuation LineContinuation :: \ LineTerminatorSequence EscapeSequence :: CharacterEscapeSequence 0 [lookahead ∉ DecimalDigit] LegacyOctalEscapeSequence NonOctalDecimalEscapeSequence HexEscapeSequence UnicodeEscapeSequence CharacterEscapeSequence :: SingleEscapeCharacter NonEscapeCharacter SingleEscapeCharacter :: one of ' " \ b f n r t v NonEscapeCharacter :: SourceCharacter but not one of EscapeCharacter or LineTerminator EscapeCharacter :: SingleEscapeCharacter DecimalDigit x u LegacyOctalEscapeSequence :: 0 [lookahead ∈ { 8, 9 }] NonZeroOctalDigit [lookahead ∉ OctalDigit] ZeroToThree OctalDigit [lookahead ∉ OctalDigit] FourToSeven OctalDigit ZeroToThree OctalDigit OctalDigit NonZeroOctalDigit :: OctalDigit but not 0 ZeroToThree :: one of 0 1 2 3 FourToSeven :: one of 4 5 6 7 NonOctalDecimalEscapeSequence :: one of 8 9 HexEscapeSequence :: x HexDigit HexDigit UnicodeEscapeSequence :: u Hex4Digits u{ CodePoint } Hex4Digits :: HexDigit HexDigit HexDigit HexDigit

非终结符 HexDigit 的定义见 12.9.3SourceCharacter11.1 中定义。

注 2

<LF> 和 <CR> 不能出现在字符串字面量中,除非作为 LineContinuation 的一部分以产生空代码点序列。在字符串字面量的字符串值中包含它们的正确方法是使用转义序列,如 \n\u000A

12.9.4.1 静态语义:早期错误

EscapeSequence :: LegacyOctalEscapeSequence NonOctalDecimalEscapeSequence 注 1
非严格代码 中,此语法是 遗留的
注 2

字符串字面量可能会出现在将包围代码置于 严格模式 中的 使用严格指令 之前,实施时必须注意对这些字面量执行上述规则。例如,以下源文本包含一个语法错误:

function invalid() { "\7"; "use strict"; }

12.9.4.2 静态语义:SV

语法定向操作 SV 不接受参数,并返回一个字符串。

字符串字面量表示 字符串类型 的值。SV 通过递归应用字符串字面量的各个部分来生成字符串值。在这个过程中,字符串字面量中的一些 Unicode 代码点被解释为具有 数学值,如下所述或在 12.9.3 中描述。

表 38: 字符串单字符转义序列
转义序列 代码单元值 Unicode 字符名称 符号
\b 0x0008 退格符 <BS>
\t 0x0009 字符制表符 <HT>
\n 0x000A 换行符 (LF) <LF>
\v 0x000B 行制表符 <VT>
\f 0x000C 换页符 (FF) <FF>
\r 0x000D 回车符 (CR) <CR>
\" 0x0022 引号 "
\' 0x0027 撇号 '
\\ 0x005C 反斜杠 \

12.9.4.3 静态语义:MV

12.9.5 正则表达式字面量

注 1

正则表达式字面量是一个输入元素,每次评估该字面量时都会转换为一个 RegExp 对象(参见 22.2)。程序中的两个正则表达式字面量评估为永远不会相互比较为 === 的正则表达式对象,即使这两个字面量的内容相同。也可以通过 new RegExp 或调用 RegExp 构造函数 在运行时创建 RegExp 对象(参见 22.2.4)。

下面的生成式描述了正则表达式字面量的语法,并由输入元素扫描器用于查找正则表达式字面量的结束位置。包含 RegularExpressionBodyRegularExpressionFlags 的源文本随后使用更严格的 ECMAScript 正则表达式语法再次解析(参见 22.2.1)。

实现可以扩展 22.2.1 中定义的 ECMAScript 正则表达式语法,但不得扩展下面定义的 RegularExpressionBodyRegularExpressionFlags 生成式或这些生成式使用的生成式。

语法

RegularExpressionLiteral :: / RegularExpressionBody / RegularExpressionFlags RegularExpressionBody :: RegularExpressionFirstChar RegularExpressionChars RegularExpressionChars :: [empty] RegularExpressionChars RegularExpressionChar RegularExpressionFirstChar :: RegularExpressionNonTerminator 但不包括 *\/[ RegularExpressionBackslashSequence RegularExpressionClass RegularExpressionChar :: RegularExpressionNonTerminator 但不包括 \/[ RegularExpressionBackslashSequence RegularExpressionClass RegularExpressionBackslashSequence :: \ RegularExpressionNonTerminator RegularExpressionNonTerminator :: SourceCharacter 但不包括 LineTerminator RegularExpressionClass :: [ RegularExpressionClassChars ] RegularExpressionClassChars :: [empty] RegularExpressionClassChars RegularExpressionClassChar RegularExpressionClassChar :: RegularExpressionNonTerminator 但不包括 ]\ RegularExpressionBackslashSequence RegularExpressionFlags :: [empty] RegularExpressionFlags IdentifierPartChar 注 2

正则表达式字面量不能为空;而不是表示一个空的正则表达式字面量,代码单元序列 // 启动一个单行注释。要指定一个空的正则表达式,请使用:/(?:)/

12.9.5.1 静态语义:BodyText

语法导向操作 BodyText 不接受任何参数并返回源文本。它分段定义于以下生成式:

RegularExpressionLiteral :: / RegularExpressionBody / RegularExpressionFlags
  1. 返回被识别为 RegularExpressionBody 的源文本。

12.9.5.2 静态语义:FlagText

语法导向操作 FlagText 不接受任何参数并返回源文本。它分段定义于以下生成式:

RegularExpressionLiteral :: / RegularExpressionBody / RegularExpressionFlags
  1. 返回被识别为 RegularExpressionFlags 的源文本。

12.9.6 模板字面量词法组件

语法

Template :: NoSubstitutionTemplate TemplateHead NoSubstitutionTemplate :: ` TemplateCharactersopt ` TemplateHead :: ` TemplateCharactersopt ${ TemplateSubstitutionTail :: TemplateMiddle TemplateTail TemplateMiddle :: } TemplateCharactersopt ${ TemplateTail :: } TemplateCharactersopt ` TemplateCharacters :: TemplateCharacter TemplateCharactersopt TemplateCharacter :: $ [lookahead ≠ {] \ TemplateEscapeSequence \ NotEscapeSequence LineContinuation LineTerminatorSequence SourceCharacter 但不包括 `\$LineTerminator TemplateEscapeSequence :: CharacterEscapeSequence 0 [lookahead ∉ DecimalDigit] HexEscapeSequence UnicodeEscapeSequence NotEscapeSequence :: 0 DecimalDigit DecimalDigit 但不包括0 x [lookahead ∉ HexDigit] x HexDigit [lookahead ∉ HexDigit] u [lookahead ∉ HexDigit] [lookahead ≠ {] u HexDigit [lookahead ∉ HexDigit] u HexDigit HexDigit [lookahead ∉ HexDigit] u HexDigit HexDigit HexDigit [lookahead ∉ HexDigit] u { [lookahead ∉ HexDigit] u { NotCodePoint [lookahead ∉ HexDigit] u { CodePoint [lookahead ∉ HexDigit] [lookahead ≠ }] NotCodePoint :: HexDigits[~Sep] 但只有当 HexDigits 的 MV > 0x10FFFF 时 CodePoint :: HexDigits[~Sep] 但只有当 HexDigits 的 MV ≤ 0x10FFFF 时

TemplateSubstitutionTailInputElementTemplateTail 替代词法目标使用。

12.9.6.1 静态语义:TV

语法导向操作 TV 不接受参数并返回字符串或undefined。模板字面量组件由 TV 解释为 字符串类型 的值。TV 用于构造模板对象的索引组件(俗称模板值)。在 TV 中,转义序列由转义序列表示的 Unicode 代码点的 UTF-16 代码单元替换。

12.9.6.2 静态语义:TRV

语法导向操作 TRV 不接受参数并返回字符串。模板字面量组件由 TRV 解释为字符串类型的值。TRV 用于构造模板对象的原始组件(俗称模板原始值)。TRV 类似于TV,区别在于 TRV 中的转义序列按字面意思解释。

TV排除了LineContinuation的代码单元,而 TRV 包括它们。 <CR><LF> 和 <CR>LineTerminatorSequence 被标准化为 TV 和 TRV 的 <LF>。需要明确的TemplateEscapeSequence包括 <CR> 或 <CR><LF> 序列。

12.10 自动分号插入

大多数 ECMAScript 语句和声明必须以分号结尾。这些分号总是可以显式出现在源代码中。然而,为了方便,在某些情况下,这些分号可以从源代码中省略。在这些情况下,可以通过描述分号自动插入到源代码令牌流中的那些情况来解释。

12.10.1 自动分号插入规则

在以下规则中,“令牌”是指使用当前词法 目标符号确定的实际识别的词法令牌,如 第 12条款所述。

分号插入有三条基本规则:

  1. 当从左到右解析源文本时,遇到不允许的令牌(称为冒犯令牌)时,如果以下条件之一为真, 则会在冒犯令牌之前自动插入分号:

    • 冒犯令牌与前一个令牌之间至少有一个 行终止符分隔。
    • 冒犯令牌是}
    • 前一个令牌是),插入的分号将被解析为do-while语句的终止分号 ( 14.7.2)。
  2. 当从左到右解析源文本时,遇到输入令牌流的结尾并且解析器无法将输入令牌流解析为目标非终结符的单个实例时, 则在输入流的结尾自动插入分号。
  3. 当从左到右解析源文本时,遇到某些语法规则允许的令牌,但该语法规则是受限规则,并且该令牌是紧跟在标注 “[no 行终止符 here]”之后的受限规则中的第一个令牌 (因此称为受限令牌),并且受限令牌与前一个令牌之间至少有一个 行终止符分隔时, 则在受限令牌之前自动插入分号。

但是,前述规则有一个额外的优先条件:如果分号将被解析为空语句或成为for语句头中的两个分号之一, 则不会自动插入分号(见 14.7.4)。

以下是语法中唯一的受限规则:

UpdateExpression [Yield, Await] : LeftHandSideExpression [?Yield, ?Await] [no 行终止符 here] ++ LeftHandSideExpression [?Yield, ?Await] [no 行终止符 here] -- ContinueStatement [Yield, Await] : continue ; continue [no 行终止符 here] LabelIdentifier [?Yield, ?Await] ; BreakStatement [Yield, Await] : break ; break [no 行终止符 here] LabelIdentifier [?Yield, ?Await] ; ReturnStatement [Yield, Await] : return ; return [no 行终止符 here] Expression [+In, ?Yield, ?Await] ; ThrowStatement [Yield, Await] : throw [no 行终止符 here] Expression [+In, ?Yield, ?Await] ; YieldExpression [In, Await] : yield yield [no 行终止符 here] AssignmentExpression [?In, +Yield, ?Await] yield [no 行终止符 here] * AssignmentExpression [?In, +Yield, ?Await] ArrowFunction [In, Yield, Await] : ArrowParameters [?Yield, ?Await] [no 行终止符 here] => ConciseBody [?In] AsyncFunctionDeclaration [Yield, Await, Default] : async [no 行终止符 here] function BindingIdentifier [?Yield, ?Await] ( FormalParameters [~Yield, +Await] ) { AsyncFunctionBody } [+Default] async [no 行终止符 here] function ( FormalParameters [~Yield, +Await] ) { AsyncFunctionBody } AsyncFunctionExpression : async [no 行终止符 here] function BindingIdentifier [~Yield, +Await]opt ( FormalParameters [~Yield, +Await] ) { AsyncFunctionBody } AsyncMethod [Yield, Await] : async [no 行终止符 here] ClassElementName [?Yield, ?Await] ( UniqueFormalParameters [~Yield, +Await] ) { AsyncFunctionBody } AsyncGeneratorDeclaration [Yield, Await, Default] : async [no 行终止符 here] function * BindingIdentifier [?Yield, ?Await] ( FormalParameters [+Yield, +Await] ) { AsyncGeneratorBody } [+Default] async [no 行终止符 here] function * ( FormalParameters [+Yield, +Await] ) { AsyncGeneratorBody } AsyncGeneratorExpression : async [no 行终止符 here] function * BindingIdentifier [+Yield, +Await]opt ( FormalParameters [+Yield, +Await] ) { AsyncGeneratorBody } AsyncGeneratorMethod [Yield, Await] : async [no 行终止符 here] * ClassElementName [?Yield, ?Await] ( UniqueFormalParameters [+Yield, +Await] ) { AsyncGeneratorBody } AsyncArrowFunction [In, Yield, Await] : async [no 行终止符 here] AsyncArrowBindingIdentifier [?Yield] [no 行终止符 here] => AsyncConciseBody [?In] CoverCallExpressionAndAsyncArrowHead [?Yield, ?Await] [no 行终止符 here] => AsyncConciseBody [?In] AsyncArrowHead : async [no 行终止符 here] ArrowFormalParameters [~Yield, +Await]

这些受限规则的实际效果如下:

  • 当遇到++--令牌且解析器将其视为后缀操作符,并且前一个令牌与++--令牌之间至少有一个 行终止符时, 则在++--令牌之前自动插入分号。
  • 当遇到continuebreakreturnthrowyield令牌并且在下一个令牌之前遇到一个 行终止符时, 则在continuebreakreturnthrowyield令牌之后自动插入分号。
  • 当箭头函数的参数之后有一个 行终止符且在=> 令牌之前时,自动插入分号并且标点符号会导致语法错误。
  • async令牌之后有一个 行终止符且在 function 标识符名称(令牌之前时,自动插入分号并且async令牌不会被视为与后续令牌相同的表达式或类元素。
  • async令牌之后有一个 行终止符且在 *令牌之前时,自动插入分号并且标点符号会导致语法错误。

因此,对ECMAScript程序员的实际建议是:

  • 后缀++--操作符应与其操作数在同一行。
  • returnthrow语句中的 表达式或在 yield表达式中的 赋值表达式应从 returnthrowyield令牌所在的同一行开始。
  • breakcontinue语句中的 标签标识符应与 breakcontinue令牌在同一行。
  • 箭头函数参数的结束与=>应在同一行。
  • 异步函数或方法前的async令牌应与紧随其后的令牌在同一行。

12.10.2 自动分号插入的示例

本节为非规范性内容。

以下源代码

{ 1 2 } 3

即使使用自动分号插入规则,也不是 ECMAScript 语法中的有效句子。相反,以下源代码

{ 1
2 } 3

也不是有效的 ECMAScript 句子,但通过自动分号插入会被转换为以下内容:

{ 1
;2 ;} 3;

这是一个有效的 ECMAScript 句子。

以下源代码

for (a; b
)

不是有效的 ECMAScript 句子,且不会因自动分号插入而改变,因为 for 语句头部需要的分号。自动分号插入永远不会插入 for 语句头部的两个分号之一。

以下源代码

return
a + b

通过自动分号插入会被转换为以下内容:

return;
a + b;
注 1

表达式 a + b 不会被视为 return 语句要返回的值,因为 returna + b 之间有一个 行终止符 分隔。

以下源代码

a = b
++c

通过自动分号插入会被转换为以下内容:

a = b;
++c;
注 2

符号 ++ 不会被视为应用于变量 b 的后缀运算符,因为 b++ 之间有一个 行终止符

以下源代码

if (a > b)
else c = d

不是有效的 ECMAScript 句子,且即使在 else 符号之前没有任何语法规则适用,自动分号插入也不会改变,因为自动插入的分号会被解析为一个空语句。

以下源代码

a = b + c
(d + e).print()

不会被自动分号插入规则改变,因为第二行开始的括号表达式可以被解释为函数调用的参数列表:

a = b + c(d + e).print()

在赋值语句必须以左括号开始的情况下,程序员最好在前一条语句的末尾提供一个显式分号,而不是依赖自动分号插入。

12.10.3 自动分号插入的有趣案例

本节为非规范性内容。

ECMAScript 程序可以通过依赖自动分号插入来以很少分号的风格编写。如上所述,分号并不会在每个换行处插入,自动分号插入可能依赖跨行终止符的多个标记。

随着新的语法特性被添加到 ECMAScript 中,可能会增加一些语法产生式,这会导致依赖自动分号插入的行在解析时改变语法产生式。

在本节的目的中,如果某个地方的分号是否插入取决于之前的源文本,则该自动分号插入的案例被认为是有趣的。本节的其余部分描述了 ECMAScript 这一版本中一些有趣的自动分号插入案例。

12.10.3.1 语句列表中自动分号插入的有趣案例

在一个 StatementList 中,许多 StatementListItem 以分号结束,这些分号可以通过自动分号插入省略。由于上述规则,在表达式结束的一行末尾,如果下一行以以下任意内容开始,则需要一个分号:

  • 开括号 (()。没有分号,这两行会被视为一个 CallExpression
  • 开方括号 ([)。没有分号,这两行会被视为属性访问,而不是一个 ArrayLiteralArrayAssignmentPattern
  • 模板字符串 (`)。没有分号,这两行会被解释为一个标记模板 (13.3.11),前一个表达式作为 MemberExpression
  • 一元 +-。没有分号,这两行会被解释为使用对应的二元运算符。
  • 正则表达式文字。没有分号,这两行可能会被解析为 / MultiplicativeOperator,例如如果正则表达式有标志。

12.10.3.2 自动分号插入和“[无 行终止符 这里]”的案例

本节为非规范性内容。

ECMAScript 包含一些语法产生式,它们包括“[无 行终止符 这里]”。这些产生式有时是为了在语法中拥有可选操作数。在这些位置引入 行终止符 会通过使用没有可选操作数的语法产生式来改变源文本的语法产生式。

本节的其余部分描述了 ECMAScript 这一版本中使用“[无 行终止符 这里]”的若干产生式。

12.10.3.2.1 带有可选操作数和“[无 行终止符 这里]”的语法产生式列表

13 ECMAScript 语言:表达式

13.1 标识符

语法

IdentifierReference[Yield, Await] : Identifier [~Yield] yield [~Await] await BindingIdentifier[Yield, Await] : Identifier yield await LabelIdentifier[Yield, Await] : Identifier [~Yield] yield [~Await] await Identifier : IdentifierName but not ReservedWord

yieldawait 在语法中允许作为 BindingIdentifier,但在下面的 静态语义 中禁止,以防止在某些情况下自动插入分号,例如

let
        await 0;

13.1.1 静态语义:早期错误

BindingIdentifier : Identifier IdentifierReference : yield BindingIdentifier : yield LabelIdentifier : yield IdentifierReference : await BindingIdentifier : await LabelIdentifier : await BindingIdentifier[Yield, Await] : yield
  • 如果该生成式有一个 [Yield] 参数,那么这是一个语法错误。
BindingIdentifier[Yield, Await] : await
  • 如果该生成式有一个 [Await] 参数,那么这是一个语法错误。
IdentifierReference[Yield, Await] : Identifier BindingIdentifier[Yield, Await] : Identifier LabelIdentifier[Yield, Await] : Identifier
  • 如果该生成式有一个 [Yield] 参数,并且 StringValueIdentifier"yield",那么这是一个语法错误。
  • 如果该生成式有一个 [Await] 参数,并且 StringValueIdentifier"await",那么这是一个语法错误。
Identifier : IdentifierName 但不是 ReservedWord

StringValueIdentifierName 标准化了 IdentifierName 中的任何 Unicode 转义序列,因此这些转义不能用于编写与 Identifier 的代码点序列相同的 ReservedWord

13.1.2 静态语义:StringValue

语法导向操作 StringValue 不带参数并返回一个字符串。它分段定义在以下生成式中:

IdentifierName :: IdentifierStart IdentifierName IdentifierPart
  1. idTextUnescapedIdentifierCodePointsIdentifierName
  2. 返回 CodePointsToString(idTextUnescaped)。
IdentifierReference : yield BindingIdentifier : yield LabelIdentifier : yield
  1. 返回 "yield"
IdentifierReference : await BindingIdentifier : await LabelIdentifier : await
  1. 返回 "await"
Identifier : IdentifierName 但不是 ReservedWord
  1. 返回 StringValueIdentifierName
PrivateIdentifier :: # IdentifierName
  1. 返回 0x0023(数字符号)和 StringValueIdentifierName字符串连接
ModuleExportName : StringLiteral
  1. 返回 SVStringLiteral

13.1.3 运行时语义:评估

IdentifierReference : Identifier
  1. 返回 ? ResolveBinding(StringValueIdentifier)。
IdentifierReference : yield
  1. 返回 ? ResolveBinding("yield")。
IdentifierReference : await
  1. 返回 ? ResolveBinding("await")。
注 1

评估 IdentifierReference 的结果总是类型为引用的值。

注 2

非严格模式代码中,关键字yield 可以用作标识符。评估 IdentifierReference 时将 yield 解析为 Identifier。早期错误限制确保这种评估仅在 非严格模式代码中发生。

13.2 主要表达式

语法

PrimaryExpression[Yield, Await] : this IdentifierReference[?Yield, ?Await] Literal ArrayLiteral[?Yield, ?Await] ObjectLiteral[?Yield, ?Await] FunctionExpression ClassExpression[?Yield, ?Await] GeneratorExpression AsyncFunctionExpression AsyncGeneratorExpression RegularExpressionLiteral TemplateLiteral[?Yield, ?Await, ~Tagged] CoverParenthesizedExpressionAndArrowParameterList[?Yield, ?Await] CoverParenthesizedExpressionAndArrowParameterList[Yield, Await] : ( Expression[+In, ?Yield, ?Await] ) ( Expression[+In, ?Yield, ?Await] , ) ( ) ( ... BindingIdentifier[?Yield, ?Await] ) ( ... BindingPattern[?Yield, ?Await] ) ( Expression[+In, ?Yield, ?Await] , ... BindingIdentifier[?Yield, ?Await] ) ( Expression[+In, ?Yield, ?Await] , ... BindingPattern[?Yield, ?Await] )

补充语法

当处理如下产生式实例时
PrimaryExpression[Yield, Await] : CoverParenthesizedExpressionAndArrowParameterList[?Yield, ?Await]
CoverParenthesizedExpressionAndArrowParameterList 的解释会使用以下语法进行细化:

ParenthesizedExpression[Yield, Await] : ( Expression[+In, ?Yield, ?Await] )

13.2.1 this 关键字

13.2.1.1 运行时语义:求值

PrimaryExpression : this
  1. 返回 ? ResolveThisBinding().

13.2.2 标识符引用

关于IdentifierReference,请参阅 13.1

13.2.3 字面量

语法

Literal : NullLiteral BooleanLiteral NumericLiteral StringLiteral

13.2.3.1 运行时语义:求值

Literal : NullLiteral
  1. 返回 null
Literal : BooleanLiteral
  1. 如果 BooleanLiteral 是标记 false,返回 false
  2. 如果 BooleanLiteral 是标记 true,返回 true
Literal : NumericLiteral
  1. 返回 NumericValueNumericLiteral,如 12.9.3 中定义。
Literal : StringLiteral
  1. 返回 SVStringLiteral,如 12.9.4.2 中定义。

13.2.4 数组初始化器

ArrayLiteral 是描述数组初始化的表达式,使用一个列表,其中包含零个或多个表达式,每个表达式代表一个数组元素,并用方括号括起来。这些元素不必是字面量;它们在每次数组初始化器被求值时都会被求值。

数组元素可以在元素列表的开头、中间或结尾省略。每当元素列表中的逗号前没有 AssignmentExpression(即开头的逗号或另一个逗号之后的逗号)时,缺失的数组元素将贡献数组的长度并增加后续元素的索引。省略的数组元素是未定义的。如果在数组末尾省略一个元素,该元素不会贡献数组的长度。

语法

ArrayLiteral[Yield, Await] : [ Elisionopt ] [ ElementList[?Yield, ?Await] ] [ ElementList[?Yield, ?Await] , Elisionopt ] ElementList[Yield, Await] : Elisionopt AssignmentExpression[+In, ?Yield, ?Await] Elisionopt> SpreadElement[?Yield, ?Await] ElementList[?Yield, ?Await] , Elisionopt AssignmentExpression[+In, ?Yield, ?Await] ElementList[?Yield, ?Await] , Elisionopt SpreadElement[?Yield, ?Await] Elision : , Elision , SpreadElement[Yield, Await] : ... AssignmentExpression[+In, ?Yield, ?Await]

13.2.4.1 运行时语义:数组积累

语法定向操作 ArrayAccumulation 接受参数 array(一个数组)和 nextIndex(一个整数)并返回正常完成记录包含的一个整数或一个中断完成记录。它根据以下产生式逐步定义:

Elision : ,
  1. lennextIndex + 1。
  2. 执行 ? Set(array, "length",𝔽(len), true)。
  3. 注意:如果 len 超过 232 - 1,则上述步骤会抛出错误。
  4. 返回 len
Elision : Elision ,
  1. 返回 ? ArrayAccumulation of Elision with arguments array and (nextIndex + 1)。
ElementList : Elisionopt AssignmentExpression
  1. 如果 Elision 存在,则
    1. 设置 nextIndex 为 ? ArrayAccumulation of Elision with arguments array and nextIndex
  2. initResult 为 ? Evaluation of AssignmentExpression
  3. initValue 为 ? GetValue(initResult)。
  4. 执行 ! CreateDataPropertyOrThrow(array, ! ToString(𝔽(nextIndex)), initValue)。
  5. 返回 nextIndex + 1。
ElementList : Elisionopt SpreadElement
  1. 如果 Elision 存在,则
    1. 设置 nextIndex 为 ? ArrayAccumulation of Elision with arguments array and nextIndex
  2. 返回 ? ArrayAccumulation of SpreadElement with arguments array and nextIndex
SpreadElement : ... AssignmentExpression
  1. spreadRef 为 ? Evaluation of AssignmentExpression
  2. spreadObj 为 ? GetValue(spreadRef)。
  3. iteratorRecord 为 ? GetIterator(spreadObj, sync)。
  4. 重复,
    1. next 为 ? IteratorStepValue(iteratorRecord)。
    2. 如果 nextdone,返回 nextIndex
    3. 执行 ! CreateDataPropertyOrThrow(array, ! ToString(𝔽(nextIndex)), next)。
    4. 设置 nextIndexnextIndex + 1。

CreateDataPropertyOrThrow 用于确保定义数组的自有属性,即使标准内置数组原型对象已被修改以阻止使用 [[Set]] 创建新自有属性。

13.2.4.2 运行时语义:求值

ArrayLiteral : [ Elisionopt ]
  1. array 为 ! ArrayCreate(0)。
  2. 如果 Elision 存在,则
    1. 执行 ? ArrayAccumulation of Elision with arguments array and 0。
  3. 返回 array
ArrayLiteral : [ ElementList ]
  1. array 为 ! ArrayCreate(0)。
  2. 执行 ? ArrayAccumulation of ElementList with arguments array and 0。
  3. 返回 array
ArrayLiteral : [ ElementList , Elisionopt ]
  1. array 为 ! ArrayCreate(0)。
  2. nextIndex 为 ? ArrayAccumulation of ElementList with arguments array and 0。
  3. 如果 Elision 存在,则
    1. 执行 ? ArrayAccumulation of Elision with arguments array and nextIndex
  4. 返回 array

13.2.5 对象初始化器

注1

对象初始化器是一个描述对象初始化的表达式,写成类似字面量的形式。它是一个由零个或多个属性键和关联值组成的列表,用大括号括起来。值不必是字面量;每次对象初始化器求值时,它们都会被求值。

语法

ObjectLiteral[Yield, Await] : { } { PropertyDefinitionList[?Yield, ?Await] } { PropertyDefinitionList[?Yield, ?Await] , } PropertyDefinitionList[Yield, Await] : PropertyDefinition[?Yield, ?Await] PropertyDefinitionList[?Yield, ?Await] , PropertyDefinition[?Yield, ?Await] PropertyDefinition[Yield, Await] : IdentifierReference[?Yield, ?Await] CoverInitializedName[?Yield, ?Await] PropertyName[?Yield, ?Await] : AssignmentExpression[+In, ?Yield, ?Await] MethodDefinition[?Yield, ?Await] ... AssignmentExpression[+In, ?Yield, ?Await] PropertyName[Yield, Await] : LiteralPropertyName ComputedPropertyName[?Yield, ?Await] LiteralPropertyName : IdentifierName StringLiteral NumericLiteral ComputedPropertyName[Yield, Await] : [ AssignmentExpression[+In, ?Yield, ?Await] ] CoverInitializedName[Yield, Await] : IdentifierReference[?Yield, ?Await] Initializer[+In, ?Yield, ?Await] Initializer[In, Yield, Await] : = AssignmentExpression[?In, ?Yield, ?Await] 注2

MethodDefinition15.4中定义。

注3

在某些上下文中,ObjectLiteral用作更受限的二级语法的覆盖语法。CoverInitializedName生产是必要的,以完全覆盖这些二级语法。但是,在需要实际ObjectLiteral的正常上下文中使用此生产会导致早期语法错误。

13.2.5.1 静态语义:早期错误

PropertyDefinition : MethodDefinition

除了描述实际的对象初始化器外,ObjectLiteral生产还用作ObjectAssignmentPattern的覆盖语法,并且可能被识别为CoverParenthesizedExpressionAndArrowParameterList的一部分。当ObjectLiteral出现在需要ObjectAssignmentPattern的上下文中时,不适用以下早期错误规则。此外,在最初解析CoverParenthesizedExpressionAndArrowParameterListCoverCallExpressionAndAsyncArrowHead时也不适用。

PropertyDefinition : CoverInitializedName
  • 如果任何源文本与此生产匹配,则这是语法错误。
注1

此生产的存在是为了使ObjectLiteral可以用作ObjectAssignmentPattern的覆盖语法。它不能出现在实际的对象初始化器中。

ObjectLiteral : { PropertyDefinitionList } { PropertyDefinitionList , } 注2

列表返回的PropertyNameList不包括使用ComputedPropertyName定义的属性名称。

13.2.5.2 静态语义:IsComputedPropertyKey

语法指向操作 IsComputedPropertyKey不带参数,返回一个布尔值。它在以下生成中逐段定义:

PropertyName : LiteralPropertyName
  1. 返回false
PropertyName : ComputedPropertyName
  1. 返回true

13.2.5.3 静态语义:PropertyNameList

语法指向操作 PropertyNameList不带参数,返回一个字符串的列表。它在以下生成中逐段定义:

PropertyDefinitionList : PropertyDefinition
  1. propName成为PropName of PropertyDefinition
  2. 如果propNameempty,则返回一个新的空列表
  3. 返回« propName »。
PropertyDefinitionList : PropertyDefinitionList , PropertyDefinition
  1. list成为PropertyNameList of PropertyDefinitionList
  2. propName成为PropName of PropertyDefinition
  3. 如果propNameempty,则返回list
  4. 返回列表连接 of list和« propName »。

13.2.5.4 运行时语义:求值

ObjectLiteral : { }
  1. 返回OrdinaryObjectCreate(%Object.prototype%)。
ObjectLiteral : { PropertyDefinitionList } { PropertyDefinitionList , }
  1. obj成为OrdinaryObjectCreate(%Object.prototype%)。
  2. PropertyDefinitionList执行PropertyDefinitionEvaluation,参数为obj
  3. 返回obj
LiteralPropertyName : IdentifierName
  1. 返回StringValue of IdentifierName
LiteralPropertyName : StringLiteral
  1. 返回SV of StringLiteral
LiteralPropertyName : NumericLiteral
  1. nbr成为NumericValue of NumericLiteral
  2. 返回!ToString(nbr)。
ComputedPropertyName : [ AssignmentExpression ]
  1. exprValue成为Evaluation of AssignmentExpression
  2. propName成为GetValue(exprValue)。
  3. 返回ToPropertyKey(propName)。

13.2.5.5 运行时语义:PropertyDefinitionEvaluation

语法指向操作 PropertyDefinitionEvaluation接受参数object(一个对象)并返回normal completion containingunused或一个abrupt completion。它在以下生成中逐段定义:

PropertyDefinitionList : PropertyDefinitionList , PropertyDefinition
  1. PropertyDefinitionList执行PropertyDefinitionEvaluation,参数为object
  2. PropertyDefinition执行PropertyDefinitionEvaluation,参数为object
  3. 返回unused
PropertyDefinition : ... AssignmentExpression
  1. exprValue成为Evaluation of AssignmentExpression
  2. fromValue成为GetValue(exprValue)。
  3. excludedNames成为一个新的空列表
  4. objectfromValueexcludedNames执行CopyDataProperties
  5. 返回unused
PropertyDefinition : IdentifierReference
  1. propName成为StringValue of IdentifierReference
  2. exprValue成为Evaluation of IdentifierReference
  3. propValue成为GetValue(exprValue)。
  4. 断言object是一个普通的、可扩展的对象,没有不可配置的属性。
  5. objectpropNamepropValue执行CreateDataPropertyOrThrow
  6. 返回unused
PropertyDefinition : PropertyName : AssignmentExpression
  1. propKey成为Evaluation of PropertyName
  2. 如果此PropertyDefinition包含在一个Script中,并且正在为JSON.parse求值(请参阅7 of JSON.parse),则
    1. isProtoSetter成为false
  3. 否则,如果propKey__proto__并且IsComputedPropertyKey of PropertyNamefalse,则
    1. isProtoSetter成为true
  4. 否则,
    1. isProtoSetter成为false
  5. 如果IsAnonymousFunctionDefinition of AssignmentExpressiontrue并且isProtoSetterfalse,则
    1. propValue成为NamedEvaluation of AssignmentExpression with argument propKey
  6. 否则,
    1. exprValueRef成为Evaluation of AssignmentExpression
    2. propValue成为GetValue(exprValueRef)。
  7. 如果isProtoSettertrue,则
    1. 如果propValue一个对象propValuenull,则
      1. 执行!object.[[SetPrototypeOf]](propValue)。
    2. 返回unused
  8. 断言object是一个普通的、可扩展的对象,没有不可配置的属性。
  9. objectpropKeypropValue执行CreateDataPropertyOrThrow
  10. 返回unused
PropertyDefinition : MethodDefinition
  1. MethodDefinition执行MethodDefinitionEvaluation,参数为objecttrue
  2. 返回unused

13.2.6 函数定义表达式

参见15.2了解 PrimaryExpression : FunctionExpression

参见15.5了解 PrimaryExpression : GeneratorExpression

参见15.7了解 PrimaryExpression : ClassExpression

参见15.8了解 PrimaryExpression : AsyncFunctionExpression

参见15.6了解 PrimaryExpression : AsyncGeneratorExpression

13.2.7 正则表达式字面量

语法

参见12.9.5

13.2.7.1 静态语义:早期错误

PrimaryExpression : RegularExpressionLiteral

13.2.7.2 静态语义:IsValidRegularExpressionLiteral(literal)

抽象操作IsValidRegularExpressionLiteral接受参数literal(一个RegularExpressionLiteral Parse Node)并返回一个布尔值。它在调用时执行以下步骤以确定其参数是否为有效的正则表达式字面量:

  1. flagsFlagTextliteral
  2. 如果flags包含dgimsuvy之外的任何代码点,或flags包含的任何代码点不止一次,则返回false
  3. 如果flags包含u,则令utrue;否则令ufalse
  4. 如果flags包含v,则令vtrue;否则令vfalse
  5. patternTextBodyTextliteral
  6. 如果ufalsevfalse,则
    1. stringValueCodePointsToString(patternText)。
    2. patternText设置为解释stringValue的每个16位元素为Unicode BMP代码点而得到的代码点序列。不对元素应用UTF-16解码。
  7. parseResultParsePattern(patternText, u, v)。
  8. 如果parseResult是一个Parse Node,则返回true;否则返回false

13.2.7.3 运行时语义:求值

PrimaryExpression : RegularExpressionLiteral
  1. patternCodePointsToString(BodyTextRegularExpressionLiteral)。
  2. flagsCodePointsToString(FlagTextRegularExpressionLiteral)。
  3. 返回!RegExpCreate(pattern, flags)。

13.2.8 模板字面量

语法

TemplateLiteral[Yield, Await, Tagged] : NoSubstitutionTemplate SubstitutionTemplate[?Yield, ?Await, ?Tagged] SubstitutionTemplate[Yield, Await, Tagged] : TemplateHead Expression[+In, ?Yield, ?Await] TemplateSpans[?Yield, ?Await, ?Tagged] TemplateSpans[Yield, Await, Tagged] : TemplateTail TemplateMiddleList[?Yield, ?Await, ?Tagged] TemplateTail TemplateMiddleList[Yield, Await, Tagged] : TemplateMiddle Expression[+In, ?Yield, ?Await] TemplateMiddleList[?Yield, ?Await, ?Tagged] TemplateMiddle Expression[+In, ?Yield, ?Await]

13.2.8.1 静态语义: 早期错误

TemplateLiteral [Yield, Await, Tagged] : NoSubstitutionTemplate TemplateLiteral [Yield, Await, Tagged] : SubstitutionTemplate [?Yield, ?Await, ?Tagged]
  • 如果 TemplateStrings 的结果中元素的数量大于或等于 232,则这是一个语法错误。
SubstitutionTemplate [Yield, Await, Tagged] : TemplateHead Expression [+In, ?Yield, ?Await] TemplateSpans [?Yield, ?Await, ?Tagged] TemplateSpans [Yield, Await, Tagged] : TemplateTail TemplateMiddleList [Yield, Await, Tagged] : TemplateMiddle Expression [+In, ?Yield, ?Await] TemplateMiddleList [?Yield, ?Await, ?Tagged] TemplateMiddle Expression [+In, ?Yield, ?Await]

13.2.8.2 静态语义:模板字符串

模板字符串是一个语法导向操作,它接受参数raw(一个布尔值)并返回一个 列表,其中包含字符串或undefined。它在以下产生式上分段定义:

TemplateLiteral : NoSubstitutionTemplate
  1. 返回 « TemplateString(NoSubstitutionTemplate, raw) ».
SubstitutionTemplate : TemplateHead Expression TemplateSpans
  1. head 为 « TemplateString(TemplateHead, raw) ».
  2. tailTemplateStrings of TemplateSpans with argument raw.
  3. 返回 headtail列表连接.
TemplateSpans : TemplateTail
  1. 返回 « TemplateString(TemplateTail, raw) ».
TemplateSpans : TemplateMiddleList TemplateTail
  1. middleTemplateStrings of TemplateMiddleList with argument raw.
  2. tail 为 « TemplateString(TemplateTail, raw) ».
  3. 返回 middletail列表连接.
TemplateMiddleList : TemplateMiddle Expression
  1. 返回 « TemplateString(TemplateMiddle, raw) ».
TemplateMiddleList : TemplateMiddleList TemplateMiddle Expression
  1. frontTemplateStrings of TemplateMiddleList with argument raw.
  2. last 为 « TemplateString(TemplateMiddle, raw) ».
  3. 返回 frontlast列表连接.

13.2.8.3 静态语义:TemplateString ( templateToken, raw )

抽象操作 TemplateString 接受参数 templateToken(一个 NoSubstitutionTemplate 解析节点,一个 TemplateHead 解析节点,一个 TemplateMiddle 解析节点,或一个 TemplateTail 解析节点)和 raw(一个布尔值),并返回一个字符串或 undefined。它在被调用时执行以下步骤:

  1. 如果 rawtrue,则
    1. stringtemplateTokenTRV
  2. 否则,
    1. stringtemplateTokenTV
  3. 返回 string

如果 rawfalse 并且 templateToken 包含一个 NotEscapeSequence,则此操作返回 undefined。在所有其他情况下,它返回一个字符串。

13.2.8.4 GetTemplateObject ( templateLiteral )

抽象操作 GetTemplateObject 接受参数 templateLiteral(一个 解析节点)并返回一个数组。它在被调用时执行以下步骤:

  1. realm当前领域记录
  2. templateRegistryrealm.[[TemplateMap]]
  3. 对于 templateRegistry 中的每个元素 e,执行
    1. 如果 e.[[Site]]templateLiteral 相同的解析节点,则
      1. 返回 e.[[Array]]
  4. rawStringsTemplateStrings of templateLiteral with argument true
  5. 断言rawStrings 是一个 字符串列表
  6. cookedStringsTemplateStrings of templateLiteral with argument false
  7. countcookedStrings 的元素数量。
  8. 断言count ≤ 232 - 1。
  9. template 为 ! ArrayCreate(count)。
  10. rawObj 为 ! ArrayCreate(count)。
  11. index 为 0。
  12. 重复,当 index < count 时,
    1. prop 为 ! ToString(𝔽(index))。
    2. cookedValuecookedStrings[index]。
    3. 执行 ! DefinePropertyOrThrow(template, prop, PropertyDescriptor { [[Value]]: cookedValue, [[Writable]]: false, [[Enumerable]]: true, [[Configurable]]: false })。
    4. rawValue 为字符串值 rawStrings[index]。
    5. 执行 ! DefinePropertyOrThrow(rawObj, prop, PropertyDescriptor { [[Value]]: rawValue, [[Writable]]: false, [[Enumerable]]: true, [[Configurable]]: false })。
    6. indexindex + 1。
  13. 执行 ! SetIntegrityLevel(rawObj, frozen)。
  14. 执行 ! DefinePropertyOrThrow(template, "raw", PropertyDescriptor { [[Value]]: rawObj, [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false })。
  15. 执行 ! SetIntegrityLevel(template, frozen)。
  16. 将记录 { [[Site]]: templateLiteral, [[Array]]: template } 追加到 realm.[[TemplateMap]]
  17. 返回 template
注 1

模板对象的创建不会导致 异常完成

注 2

程序代码中的每个 TemplateLiteral 都与一个唯一的模板对象相关联,该对象用于标记模板的求值(13.2.8.6)。模板对象是冻结的,每次特定标记模板求值时都使用相同的模板对象。模板对象是懒惰创建的(在第一次求值时)还是提前创建的(在第一次求值之前)是实现选择,对 ECMAScript 代码不可见。

注 3

本规范的未来版本可能会定义模板对象的附加不可枚举属性。

13.2.8.5 运行时语义:SubstitutionEvaluation

SubstitutionEvaluation 是一个 语法导向操作,它不接受参数,并返回一个 正常完成 包含一个 ECMAScript 语言值列表 或一个 异常完成。它在以下产生式上分段定义:

TemplateSpans : TemplateTail
  1. 返回一个新的空 列表
TemplateSpans : TemplateMiddleList TemplateTail
  1. 返回 ? SubstitutionEvaluation of TemplateMiddleList
TemplateMiddleList : TemplateMiddle Expression
  1. subRef 为 ? Evaluation of Expression
  2. sub 为 ? GetValue(subRef)。
  3. 返回 « sub »。
TemplateMiddleList : TemplateMiddleList TemplateMiddle Expression
  1. preceding 为 ? SubstitutionEvaluation of TemplateMiddleList
  2. nextRef 为 ? Evaluation of Expression
  3. next 为 ? GetValue(nextRef)。
  4. 返回 preceding 和 « next » 的 列表连接

13.2.8.6 运行时语义:求值

TemplateLiteral : NoSubstitutionTemplate
  1. 返回 NoSubstitutionTemplateTV,定义在 12.9.6
SubstitutionTemplate : TemplateHead Expression TemplateSpans
  1. headTemplateHeadTV,定义在 12.9.6
  2. subRef 为 ? Evaluation of Expression
  3. sub 为 ? GetValue(subRef)。
  4. middle 为 ? ToString(sub)。
  5. tail 为 ? Evaluation of TemplateSpans
  6. 返回 headmiddletail字符串连接
注 1

Expression 值的字符串转换语义类似于 String.prototype.concat 而不是 + 运算符。

TemplateSpans : TemplateTail
  1. 返回 TemplateTailTV,定义在 12.9.6
TemplateSpans : TemplateMiddleList TemplateTail
  1. head 为 ? Evaluation of TemplateMiddleList
  2. tailTemplateTailTV,定义在 12.9.6
  3. 返回 headtail字符串连接
TemplateMiddleList : TemplateMiddle Expression
  1. headTemplateMiddleTV,定义在 12.9.6
  2. subRef 为 ? Evaluation of Expression
  3. sub 为 ? GetValue(subRef)。
  4. middle 为 ? ToString(sub)。
  5. 返回 headmiddle字符串连接
注 2

Expression 值的字符串转换语义类似于 String.prototype.concat 而不是 + 运算符。

TemplateMiddleList : TemplateMiddleList TemplateMiddle Expression
  1. rest 为 ? Evaluation of TemplateMiddleList
  2. middleTemplateMiddleTV,定义在 12.9.6
  3. subRef 为 ? Evaluation of Expression
  4. sub 为 ? GetValue(subRef)。
  5. last 为 ? ToString(sub)。
  6. 返回 restmiddlelast字符串连接
注 3

Expression 值的字符串转换语义类似于 String.prototype.concat 而不是 + 运算符。

13.2.9 分组运算符

13.2.9.1 静态语义:早期错误

PrimaryExpression : CoverParenthesizedExpressionAndArrowParameterList

13.2.9.2 运行时语义:求值

PrimaryExpression : CoverParenthesizedExpressionAndArrowParameterList
  1. exprParenthesizedExpression覆盖CoverParenthesizedExpressionAndArrowParameterList
  2. 返回 ? Evaluation of expr
ParenthesizedExpression : ( Expression )
  1. 返回 ? Evaluation of Expression。这可能是 Reference 类型。

此算法不会对 Evaluation of Expression 应用 GetValue。这样做的主要动机是允许诸如 deletetypeof 等运算符应用于带括号的表达式。

13.3 左值表达式

语法

MemberExpression[Yield, Await] : PrimaryExpression[?Yield, ?Await] MemberExpression[?Yield, ?Await] [ Expression[+In, ?Yield, ?Await] ] MemberExpression[?Yield, ?Await] . IdentifierName MemberExpression[?Yield, ?Await] TemplateLiteral[?Yield, ?Await, +Tagged] SuperProperty[?Yield, ?Await] MetaProperty new MemberExpression[?Yield, ?Await] Arguments[?Yield, ?Await] MemberExpression[?Yield, ?Await] . PrivateIdentifier SuperProperty[Yield, Await] : super [ Expression[+In, ?Yield, ?Await] ] super . IdentifierName MetaProperty : NewTarget ImportMeta NewTarget : new . target ImportMeta : import . meta NewExpression[Yield, Await] : MemberExpression[?Yield, ?Await] new NewExpression[?Yield, ?Await] CallExpression[Yield, Await] : CoverCallExpressionAndAsyncArrowHead[?Yield, ?Await] SuperCall[?Yield, ?Await] ImportCall[?Yield, ?Await] CallExpression[?Yield, ?Await] Arguments[?Yield, ?Await] CallExpression[?Yield, ?Await] [ Expression[+In, ?Yield, ?Await] ] CallExpression[?Yield, ?Await] . IdentifierName CallExpression[?Yield, ?Await] TemplateLiteral[?Yield, ?Await, +Tagged] CallExpression[?Yield, ?Await] . PrivateIdentifier SuperCall[Yield, Await] : super Arguments[?Yield, ?Await] ImportCall[Yield, Await] : import ( AssignmentExpression[+In, ?Yield, ?Await] ) Arguments[Yield, Await] : ( ) ( ArgumentList[?Yield, ?Await] ) ( ArgumentList[?Yield, ?Await] , ) ArgumentList[Yield, Await] : AssignmentExpression[+In, ?Yield, ?Await] ... AssignmentExpression[+In, ?Yield, ?Await] ArgumentList[?Yield, ?Await] , AssignmentExpression[+In, ?Yield, ?Await] ArgumentList[?Yield, ?Await] , ... AssignmentExpression[+In, ?Yield, ?Await] OptionalExpression[Yield, Await] : MemberExpression[?Yield, ?Await] OptionalChain[?Yield, ?Await] CallExpression[?Yield, ?Await] OptionalChain[?Yield, ?Await] OptionalExpression[?Yield, ?Await] OptionalChain[?Yield, ?Await] OptionalChain[Yield, Await] : ?. Arguments[?Yield, ?Await] ?. [ Expression[+In, ?Yield, ?Await] ] ?. IdentifierName ?. TemplateLiteral[?Yield, ?Await, +Tagged] ?. PrivateIdentifier OptionalChain[?Yield, ?Await] Arguments[?Yield, ?Await] OptionalChain[?Yield, ?Await] [ Expression[+In, ?Yield, ?Await] ] OptionalChain[?Yield, ?Await] . IdentifierName OptionalChain[?Yield, ?Await] TemplateLiteral[?Yield, ?Await, +Tagged] OptionalChain[?Yield, ?Await] . PrivateIdentifier LeftHandSideExpression[Yield, Await] : NewExpression[?Yield, ?Await] CallExpression[?Yield, ?Await] OptionalExpression[?Yield, ?Await]

补充语法

当处理以下产生式的一个实例时
CallExpression : CoverCallExpressionAndAsyncArrowHead
CoverCallExpressionAndAsyncArrowHead 的解释使用以下语法进行细化:

CallMemberExpression[Yield, Await] : MemberExpression[?Yield, ?Await] Arguments[?Yield, ?Await]

13.3.1 静态语义

13.3.1.1 静态语义:早期错误

OptionalChain : ?. TemplateLiteral OptionalChain TemplateLiteral
  • 如果任何源代码与此产生式匹配,则这是一个语法错误。

此产生式存在是为了防止自动分号插入规则(12.10)应用于以下代码:

a?.b
`c`

以便将其解释为两个有效的语句。目的是保持与没有可选链的类似代码的一致性:

a.b
`c`

这是一个有效的语句,并且自动分号插入不适用。

ImportMeta : import . meta

13.3.2 属性访问器

属性通过名称访问,使用点表示法:

或方括号表示法:

点表示法通过以下句法转换解释:

其行为与以下相同:

MemberExpression [ <identifier-name-string> ]

同样地:

其行为与以下相同:

CallExpression [ <identifier-name-string> ]

其中 <identifier-name-string> 是评估 StringValueIdentifierName 的结果。

13.3.2.1 运行时语义:评估

MemberExpression : MemberExpression [ Expression ]
  1. baseReference 为 ? EvaluationMemberExpression
  2. baseValue 为 ? GetValue(baseReference)。
  3. 如果 源代码匹配MemberExpression严格模式代码,设 stricttrue;否则设 strictfalse
  4. 返回 ? EvaluatePropertyAccessWithExpressionKey(baseValue, Expression, strict)。
MemberExpression : MemberExpression . IdentifierName
  1. baseReference 为 ? EvaluationMemberExpression
  2. baseValue 为 ? GetValue(baseReference)。
  3. 如果 源代码匹配MemberExpression严格模式代码,设 stricttrue;否则设 strictfalse
  4. 返回 EvaluatePropertyAccessWithIdentifierKey(baseValue, IdentifierName, strict)。
MemberExpression : MemberExpression . PrivateIdentifier
  1. baseReference 为 ? EvaluationMemberExpression
  2. baseValue 为 ? GetValue(baseReference)。
  3. fieldNameStringStringValuePrivateIdentifier
  4. 返回 MakePrivateReference(baseValue, fieldNameString)。
CallExpression : CallExpression [ Expression ]
  1. baseReference 为 ? EvaluationCallExpression
  2. baseValue 为 ? GetValue(baseReference)。
  3. 如果 源代码匹配CallExpression严格模式代码,设 stricttrue;否则设 strictfalse
  4. 返回 ? EvaluatePropertyAccessWithExpressionKey(baseValue, Expression, strict)。
CallExpression : CallExpression . IdentifierName
  1. baseReference 为 ? EvaluationCallExpression
  2. baseValue 为 ? GetValue(baseReference)。
  3. 如果 源代码匹配CallExpression严格模式代码,设 stricttrue;否则设 strictfalse
  4. 返回 EvaluatePropertyAccessWithIdentifierKey(baseValue, IdentifierName, strict)。
CallExpression : CallExpression . PrivateIdentifier
  1. baseReference 为 ? EvaluationCallExpression
  2. baseValue 为 ? GetValue(baseReference)。
  3. fieldNameStringStringValuePrivateIdentifier
  4. 返回 MakePrivateReference(baseValue, fieldNameString)。

13.3.3 EvaluatePropertyAccessWithExpressionKey ( baseValue, expression, strict )

抽象操作 EvaluatePropertyAccessWithExpressionKey 接受参数 baseValue(一个 ECMAScript 语言值),expression(一个 Expression 解析节点),和 strict(一个布尔值),并返回一个 正常完成 包含一个 引用记录 或一个 突然完成。它在调用时执行以下步骤:

  1. propertyNameReference 为 ? Evaluationexpression
  2. propertyNameValue 为 ? GetValue(propertyNameReference)。
  3. propertyKey 为 ? ToPropertyKey(propertyNameValue)。
  4. 返回 引用记录 { [[Base]]: baseValue, [[ReferencedName]]: propertyKey, [[Strict]]: strict, [[ThisValue]]: empty }。

13.3.4 EvaluatePropertyAccessWithIdentifierKey ( baseValue, identifierName, strict )

抽象操作 EvaluatePropertyAccessWithIdentifierKey 接受参数 baseValue(一个 ECMAScript 语言值),identifierName(一个 IdentifierName 解析节点),和 strict(一个布尔值),并返回一个 引用记录。它在调用时执行以下步骤:

  1. propertyNameStringStringValueidentifierName
  2. 返回 引用记录 { [[Base]]: baseValue, [[ReferencedName]]: propertyNameString, [[Strict]]: strict, [[ThisValue]]: empty }。

13.3.5 The new Operator

13.3.5.1 运行时语义:评估

NewExpression : new NewExpression
  1. 返回 ? EvaluateNew(NewExpression, empty)。
MemberExpression : new MemberExpression Arguments
  1. 返回 ? EvaluateNew(MemberExpression, Arguments)。

13.3.5.1.1 EvaluateNew ( constructExpr, arguments )

抽象操作 EvaluateNew 接受参数 constructExpr(一个 NewExpression 解析节点 或一个 MemberExpression 解析节点)和 argumentsempty 或一个 Arguments 解析节点),并返回 一个 正常完成 包含一个 ECMAScript 语言值 或一个 突然完成。它在调用时执行以下步骤:

  1. ref 为 ? EvaluationconstructExpr
  2. constructor 为 ? GetValue(ref)。
  3. 如果 argumentsempty
    1. argList 为一个新空的 列表
  4. 否则,
    1. argList 为 ? ArgumentListEvaluationarguments
  5. 如果 IsConstructor(constructor) is false,抛出一个 TypeError 异常。
  6. 返回 ? Construct(constructor, argList)。

13.3.6 Function Calls

13.3.6.1 运行时语义:评估

CallExpression : CoverCallExpressionAndAsyncArrowHead
  1. exprCallMemberExpressionCoverCallExpressionAndAsyncArrowHead 覆盖的部分。
  2. memberExprexprMemberExpression
  3. argumentsexprArguments
  4. ref 为 ? EvaluationmemberExpr
  5. func 为 ? GetValue(ref)。
  6. 如果 ref 是一个 引用记录IsPropertyReference(ref) 是 false,且 ref.[[ReferencedName]]"eval",则
    1. 如果 SameValue(func, %eval%) 是 true,则
      1. argList 为 ? ArgumentListEvaluationarguments
      2. 如果 argList 没有元素,返回 undefined
      3. evalArgargList 的第一个元素。
      4. 如果 源代码匹配CallExpression严格模式代码,设 strictCallertrue。否则设 strictCallerfalse
      5. 返回 ? PerformEval(evalArg, strictCaller, true)。
  7. thisCall 为这个 CallExpression
  8. tailCallIsInTailPosition(thisCall)。
  9. 返回 ? EvaluateCall(func, ref, arguments, tailCall)。

一个 CallExpression 评估执行步骤 6.a.v 是一个 直接 eval

CallExpression : CallExpression Arguments
  1. ref 为 ? EvaluationCallExpression
  2. func 为 ? GetValue(ref)。
  3. thisCall 为这个 CallExpression
  4. tailCallIsInTailPosition(thisCall)。
  5. 返回 ? EvaluateCall(func, ref, Arguments, tailCall)。

13.3.6.2 EvaluateCall ( func, ref, arguments, tailPosition )

抽象操作 EvaluateCall 接受参数 func(一个 ECMAScript 语言值),ref(一个 ECMAScript 语言值 或一个 引用记录),arguments(一个 解析节点), tailPosition(一个布尔值),并返回一个 正常完成 包含一个 ECMAScript 语言值 或一个 突然完成。它在调用时执行以下步骤:

  1. 如果 ref 是一个 引用记录,则
    1. 如果 IsPropertyReference(ref) 是 true,则
      1. thisValueGetThisValue(ref)。
    2. 否则,
      1. refEnvref.[[Base]]
      2. 断言refEnv 是一个 环境记录
      3. thisValuerefEnv.WithBaseObject()。
  2. 否则,
    1. thisValueundefined
  3. argList 为 ? ArgumentListEvaluationarguments
  4. 如果 func 不是一个对象,抛出一个 TypeError 异常。
  5. 如果 IsCallable(func) 是 false,抛出一个 TypeError 异常。
  6. 如果 tailPositiontrue, 执行 PrepareForTailCall()。
  7. 返回 ? Call(func, thisValue, argList)。

13.3.7 The super 关键字

13.3.7.1 运行时语义:评估

SuperProperty : super [ Expression ]
  1. env 为运行时执行上下文的 环境记录
  2. homeenv.GetSuperBase()。
  3. propertyNameReference 为 ? Evaluation表达式
  4. propertyNameValue 为 ? GetValue(propertyNameReference)。
  5. propertyKey 为 ? ToPropertyKey(propertyNameValue)。
  6. strictIsStrictReference(propertyNameReference)。
  7. 返回 MakeSuperPropertyReference(home, propertyKey, strict)。
SuperProperty : super . IdentifierName
  1. env 为运行时执行上下文的 环境记录
  2. homeenv.GetSuperBase()。
  3. strictIsStrictReference(propertyNameReference)。
  4. propertyKeyStringValueIdentifierName
  5. 返回 MakeSuperPropertyReference(home, propertyKey, strict)。
SuperCall : super Arguments
  1. newTargetGetNewTarget()。
  2. 断言newTarget 是一个对象
  3. funcGetSuperConstructor()。
  4. argList 为 ? ArgumentListEvaluationArguments
  5. 如果 IsConstructor(func) 是 false,抛出一个 TypeError 异常。
  6. result 为 ? Construct(func, argList, newTarget)。
  7. thisERGetThisEnvironment()。
  8. 执行 ? thisER.BindThisValue(result)。
  9. FthisER.[[FunctionObject]]
  10. 断言F 是一个 ECMAScript 函数对象
  11. 执行 ? InitializeInstanceElements(result, F)。
  12. 返回 result

13.3.7.2 GetSuperConstructor ( )

抽象操作 GetSuperConstructor 不接受任何参数,并返回一个 ECMAScript 语言值。它在调用时执行以下步骤:

  1. envRecGetThisEnvironment()。
  2. 断言envRec 是一个 函数环境记录
  3. activeFunctionenvRec.[[FunctionObject]]
  4. 断言activeFunction 是一个 ECMAScript 函数对象
  5. superConstructor 为 ! activeFunction.[[GetPrototypeOf]]()。
  6. 返回 superConstructor

13.3.7.3 MakeSuperPropertyReference ( actualThis, propertyKey, strict )

抽象操作 MakeSuperPropertyReference 接受参数 actualThis(一个 ECMAScript 语言值),propertyKey(一个 属性键),和 strict(一个布尔值),并返回一个 正常完成 包含一个 Super 引用记录 或一个 抛出完成。它在调用时执行以下步骤:

  1. envGetThisEnvironment()。
  2. 断言env.HasSuperBinding() 是 true
  3. baseValue 为 ? env.GetSuperBase()。
  4. 返回 引用记录 { [[Base]]: baseValue, [[ReferencedName]]: propertyKey, [[Strict]]: strict, [[ThisValue]]: actualThis }。

13.3.8 参数列表

参数列表的评估产生一个列表的 值。

13.3.8.1 运行时语义:参数列表评估

语法导向操作参数列表评估不接受参数,并返回一个正常完成包含一个列表ECMAScript语言值或一个突然完成。它在以下产生式上分段定义:

Arguments : ( )
  1. 返回一个新的空列表
ArgumentList : AssignmentExpression
  1. ref为? AssignmentExpression的评估。
  2. arg为? GetValue(ref)。
  3. 返回 « arg »。
ArgumentList : ... AssignmentExpression
  1. list为一个新空列表
  2. spreadRef为? AssignmentExpression的评估。
  3. spreadObj为? GetValue(spreadRef)。
  4. iteratorRecord为? GetIterator(spreadObj, sync)。
  5. 重复,
    1. next为? IteratorStepValue(iteratorRecord)。
    2. 如果nextdone,返回 list
    3. next添加到list
ArgumentList : ArgumentList , AssignmentExpression
  1. precedingArgs为? ArgumentListEvaluation of ArgumentList
  2. ref为? Evaluation of AssignmentExpression
  3. arg为? GetValue(ref)。
  4. 返回列表连接 of precedingArgs 和 « arg »。
ArgumentList : ArgumentList , ... AssignmentExpression
  1. precedingArgs为? ArgumentListEvaluation of ArgumentList
  2. spreadRef为? Evaluation of AssignmentExpression
  3. iteratorRecord为? GetIterator(? GetValue(spreadRef), sync)。
  4. 重复,
    1. next为? IteratorStepValue(iteratorRecord)。
    2. 如果nextdone,返回 precedingArgs
    3. next添加到precedingArgs
TemplateLiteral : NoSubstitutionTemplate
  1. templateLiteral为这个TemplateLiteral
  2. siteObjGetTemplateObject(templateLiteral)。
  3. 返回 « siteObj »。
TemplateLiteral : SubstitutionTemplate
  1. templateLiteral为这个TemplateLiteral
  2. siteObjGetTemplateObject(templateLiteral)。
  3. remaining为? ArgumentListEvaluation of SubstitutionTemplate
  4. 返回列表连接 of « siteObj » 和 remaining
SubstitutionTemplate : TemplateHead Expression TemplateSpans
  1. firstSubRef为? Evaluation of Expression
  2. firstSub为? GetValue(firstSubRef)。
  3. restSub为? SubstitutionEvaluation of TemplateSpans
  4. 断言: restSub 是一个 可能为空的列表
  5. 返回列表连接 of « firstSub » 和 restSub

13.3.9 可选链

一个可选链是一个或多个属性访问和函数调用的链,第一个以?.标记开始。

13.3.9.1 运行时语义:评估

OptionalExpression : MemberExpression OptionalChain
  1. baseReference为? Evaluation of MemberExpression
  2. baseValue为? GetValue(baseReference)。
  3. 如果baseValueundefinednull,则
    1. 返回undefined
  4. 返回? ChainEvaluation of OptionalChain with arguments baseValuebaseReference
OptionalExpression : CallExpression OptionalChain
  1. baseReference为? Evaluation of CallExpression
  2. baseValue为? GetValue(baseReference)。
  3. 如果baseValueundefinednull,则
    1. 返回undefined
  4. 返回? ChainEvaluation of OptionalChain with arguments baseValuebaseReference
OptionalExpression : OptionalExpression OptionalChain
  1. baseReference为? Evaluation of OptionalExpression
  2. baseValue为? GetValue(baseReference)。
  3. 如果baseValueundefinednull,则
    1. 返回undefined
  4. 返回? ChainEvaluation of OptionalChain with arguments baseValuebaseReference

13.3.9.2 运行时语义:链评估

语法导向操作链评估接受参数baseValue(一个ECMAScript语言值)和baseReference(一个ECMAScript语言值或一个引用记录),并返回一个正常完成,包含一个ECMAScript语言值或一个引用记录,或一个突然完成。它在以下产生式上分段定义:

OptionalChain : ?. Arguments
  1. thisChain为这个OptionalChain
  2. tailCallIsInTailPosition(thisChain)。
  3. 返回? EvaluateCall(baseValue, baseReference, Arguments, tailCall)。
OptionalChain : ?. [ Expression ]
  1. 如果这个OptionalChain源文本匹配严格模式代码,设stricttrue;否则设strictfalse
  2. 返回? EvaluatePropertyAccessWithExpressionKey(baseValue, Expression, strict)。
OptionalChain : ?. IdentifierName
  1. 如果这个OptionalChain源文本匹配严格模式代码,设stricttrue;否则设strictfalse
  2. 返回EvaluatePropertyAccessWithIdentifierKey(baseValue, IdentifierName, strict)。
OptionalChain : ?. PrivateIdentifier
  1. fieldNameStringPrivateIdentifierStringValue
  2. 返回MakePrivateReference(baseValue, fieldNameString)。
OptionalChain : OptionalChain Arguments
  1. optionalChainOptionalChain
  2. newReference为? ChainEvaluation of optionalChain with arguments baseValuebaseReference
  3. newValue为? GetValue(newReference)。
  4. thisChain为这个OptionalChain
  5. tailCallIsInTailPosition(thisChain)。
  6. 返回? EvaluateCall(newValue, newReference, Arguments, tailCall)。
OptionalChain : OptionalChain [ Expression ]
  1. optionalChainOptionalChain
  2. newReference为? ChainEvaluation of optionalChain with arguments baseValuebaseReference
  3. newValue为? GetValue(newReference)。
  4. 如果这个OptionalChain源文本匹配严格模式代码,设stricttrue;否则设strictfalse
  5. 返回? EvaluatePropertyAccessWithExpressionKey(newValue, Expression, strict)。
OptionalChain : OptionalChain . IdentifierName
  1. optionalChainOptionalChain
  2. newReference为? ChainEvaluation of optionalChain with arguments baseValuebaseReference
  3. newValue为? GetValue(newReference)。
  4. 如果这个OptionalChain源文本匹配严格模式代码,设stricttrue;否则设strictfalse
  5. 返回EvaluatePropertyAccessWithIdentifierKey(newValue, IdentifierName, strict)。
OptionalChain : OptionalChain . PrivateIdentifier
  1. optionalChainOptionalChain
  2. newReference为? ChainEvaluation of optionalChain with arguments baseValuebaseReference
  3. newValue为? GetValue(newReference)。
  4. fieldNameStringPrivateIdentifierStringValue
  5. 返回MakePrivateReference(newValue, fieldNameString)。

13.3.10 Import 调用

13.3.10.1 运行时语义: Evaluation

ImportCall : import ( AssignmentExpression )
  1. referrerGetActiveScriptOrModule()。
  2. 如果referrernull,设 referrer当前领域记录
  3. argRef为? Evaluation of AssignmentExpression
  4. specifier为? GetValue(argRef)。
  5. promiseCapability为! NewPromiseCapability(%Promise%)。
  6. specifierStringCompletion(ToString(specifier))。
  7. IfAbruptRejectPromise(specifierString, promiseCapability)。
  8. 执行HostLoadImportedModule(referrer, specifierString, empty, promiseCapability)。
  9. 返回promiseCapability.[[Promise]]

13.3.10.1.1 ContinueDynamicImport ( promiseCapability, moduleCompletion )

抽象操作ContinueDynamicImport接受参数promiseCapability(一个PromiseCapability Record)和moduleCompletion(一个正常完成包含一个Module Record或一个抛出完成)并返回unused。它完成了一个动态导入的原始过程,最初由一个import()调用启动,根据需要解决或拒绝该调用返回的承诺。它执行以下步骤:

  1. 如果moduleCompletion是一个突然完成,则
    1. 执行! Call(promiseCapability.[[Reject]], undefined, « moduleCompletion.[[Value]] »)。
    2. 返回unused
  2. modulemoduleCompletion.[[Value]]
  3. loadPromisemodule.LoadRequestedModules()。
  4. rejectedClosure为一个新抽象闭包,参数为(reason),捕获promiseCapability,并执行以下步骤:
    1. 执行! Call(promiseCapability.[[Reject]], undefined, « reason »)。
    2. 返回unused
  5. onRejectedCreateBuiltinFunction(rejectedClosure, 1, "", « »)。
  6. linkAndEvaluateClosure为一个新抽象闭包,无参数,捕获modulepromiseCapabilityonRejected,并执行以下步骤:
    1. linkCompletion(module.Link())。
    2. 如果link是一个突然完成,则
      1. 执行! Call(promiseCapability.[[Reject]], undefined, « link.[[Value]] »)。
      2. 返回unused
    3. evaluatePromisemodule.Evaluate()。
    4. fulfilledClosure为一个新抽象闭包 ,无参数,捕获modulepromiseCapability,并执行以下步骤:
      1. namespaceGetModuleNamespace(module)。
      2. 执行! Call(promiseCapability.[[Resolve]], undefined, « namespace »)。
      3. 返回unused
    5. onFulfilledCreateBuiltinFunction(fulfilledClosure, 0, "", « »)。
    6. 执行PerformPromiseThen(evaluatePromise, onFulfilled, onRejected)。
    7. 返回unused
  7. linkAndEvaluateCreateBuiltinFunction(linkAndEvaluateClosure, 0, "", « »)。
  8. 执行PerformPromiseThen(loadPromise, linkAndEvaluate, onRejected)。
  9. 返回unused

13.3.11 标签模板

标签模板是一个函数调用,其中调用的参数是从一个TemplateLiteral (13.2.8) 派生的。实际参数包括一个模板对象 (13.2.8.4) 和通过评估嵌入在TemplateLiteral中的表达式产生的值。

13.3.11.1 运行时语义:评估

MemberExpression : MemberExpression TemplateLiteral
  1. tagRef为? Evaluation of MemberExpression
  2. tagFunc为? GetValue(tagRef)。
  3. thisCall为这个MemberExpression
  4. tailCallIsInTailPosition(thisCall)。
  5. 返回? EvaluateCall(tagFunc, tagRef, TemplateLiteral, tailCall)。
CallExpression : CallExpression TemplateLiteral
  1. tagRef为? Evaluation of CallExpression
  2. tagFunc为? GetValue(tagRef)。
  3. thisCall为这个CallExpression
  4. tailCallIsInTailPosition(thisCall)。
  5. 返回? EvaluateCall(tagFunc, tagRef, TemplateLiteral, tailCall)。

13.3.12 元属性

13.3.12.1 运行时语义: Evaluation

NewTarget : new . target
  1. 返回 GetNewTarget()。
ImportMeta : import . meta
  1. moduleGetActiveScriptOrModule()。
  2. 断言module 是一个 源文本模块记录
  3. importMetamodule.[[ImportMeta]]
  4. 如果 importMetaempty, 则
    1. importMetaOrdinaryObjectCreate(null)。
    2. importMetaValuesHostGetImportMetaProperties(module)。
    3. 对于每个 记录 { [[Key]], [[Value]] } pimportMetaValues,执行
      1. 执行 ! CreateDataPropertyOrThrow(importMeta, p.[[Key]], p.[[Value]])。
    4. 执行 HostFinalizeImportMeta(importMeta, module)。
    5. module.[[ImportMeta]]importMeta
    6. 返回 importMeta
  5. 否则,
    1. 断言importMeta 是一个对象
    2. 返回 importMeta

13.3.12.1.1 HostGetImportMetaProperties ( moduleRecord )

The 宿主定义 抽象操作 HostGetImportMetaProperties 接受参数 moduleRecord(一个 模块记录)并 返回一个 列表记录 带有字段 [[Key]](一个 属性键)和 [[Value]](一个 ECMAScript 语言 值)。它允许 宿主 提供 属性 键 和值给从 import.meta 返回的对象。

HostGetImportMetaProperties 的默认实现是返回一个新的空 列表

13.3.12.1.2 HostFinalizeImportMeta ( importMeta, moduleRecord )

The 宿主定义 抽象操作 HostFinalizeImportMeta 接受参数 importMeta(一个对象)和 moduleRecord (一个 模块记录)并 返回 unused。它允许 宿主 执行任何非凡的操作来准备从 import.meta 返回的对象。

大多数 宿主 可以简单地定义 HostGetImportMetaProperties, 并让 HostFinalizeImportMeta 保持其默认行为。然而,HostFinalizeImportMeta 为 宿主 提供了一个“逃生舱”,可以在对象暴露给 ECMAScript 代码之前直接操作它。

HostFinalizeImportMeta 的默认实现是返回 unused

13.4 更新表达式

语法

UpdateExpression[Yield, Await] : LeftHandSideExpression[?Yield, ?Await] LeftHandSideExpression[?Yield, ?Await] [no LineTerminator here] ++ LeftHandSideExpression[?Yield, ?Await] [no LineTerminator here] -- ++ UnaryExpression[?Yield, ?Await] -- UnaryExpression[?Yield, ?Await]

13.4.1 静态语义:早期错误

UpdateExpression : LeftHandSideExpression ++ LeftHandSideExpression -- UpdateExpression : ++ UnaryExpression -- UnaryExpression

13.4.2 后置递增运算符

13.4.2.1 运行时语义:评估

UpdateExpression : LeftHandSideExpression ++
  1. lhs 为 ? 评估LeftHandSideExpression
  2. oldValue 为 ? ToNumeric(? GetValue(lhs))。
  3. 如果 oldValue 是一个 数字,则
    1. newValueNumber::add(oldValue, 1𝔽)。
  4. 否则,
    1. 断言oldValue 是一个 大整数
    2. newValueBigInt::add(oldValue, 1)。
  5. 执行 ? PutValue(lhs, newValue)。
  6. 返回 oldValue

13.4.3 后置递减运算符

13.4.3.1 运行时语义:评估

UpdateExpression : LeftHandSideExpression --
  1. lhs 为 ? 评估LeftHandSideExpression
  2. oldValue 为 ? ToNumeric(? GetValue(lhs))。
  3. 如果 oldValue 是一个 数字,则
    1. newValueNumber::subtract(oldValue, 1𝔽)。
  4. 否则,
    1. 断言oldValue 是一个 大整数
    2. newValueBigInt::subtract(oldValue, 1)。
  5. 执行 ? PutValue(lhs, newValue)。
  6. 返回 oldValue

13.4.4 前置递增运算符

13.4.4.1 运行时语义:评估

UpdateExpression : ++ UnaryExpression
  1. expr 为 ? 评估UnaryExpression
  2. oldValue 为 ? ToNumeric(? GetValue(expr))。
  3. 如果 oldValue 是一个 数字,则
    1. newValueNumber::add(oldValue, 1𝔽)。
  4. 否则,
    1. 断言oldValue 是一个 大整数
    2. newValueBigInt::add(oldValue, 1)。
  5. 执行 ? PutValue(expr, newValue)。
  6. 返回 newValue

13.4.5 前置递减运算符

13.4.5.1 运行时语义:评估

UpdateExpression : -- UnaryExpression
  1. expr 为 ? 评估UnaryExpression
  2. oldValue 为 ? ToNumeric(? GetValue(expr))。
  3. 如果 oldValue 是一个 数字,则
    1. newValueNumber::subtract(oldValue, 1𝔽)。
  4. 否则,
    1. 断言oldValue 是一个 大整数
    2. newValueBigInt::subtract(oldValue, 1)。
  5. 执行 ? PutValue(expr, newValue)。
  6. 返回 newValue

13.5 一元运算符

语法

UnaryExpression[Yield, Await] : UpdateExpression[?Yield, ?Await] delete UnaryExpression[?Yield, ?Await] void UnaryExpression[?Yield, ?Await] typeof UnaryExpression[?Yield, ?Await] + UnaryExpression[?Yield, ?Await] - UnaryExpression[?Yield, ?Await] ~ UnaryExpression[?Yield, ?Await] ! UnaryExpression[?Yield, ?Await] [+Await] AwaitExpression[?Yield]

13.5.1 The delete 运算符

13.5.1.1 静态语义:早期错误

UnaryExpression : delete UnaryExpression

最后一项规则意味着表达式如 delete (((foo))) 会产生 早期错误,因为递归应用了第一项规则。

13.5.1.2 运行时语义:评估

UnaryExpression : delete UnaryExpression
  1. ref 为 ? 评估UnaryExpression
  2. 如果 ref 不是 引用记录,返回 true
  3. 如果 IsUnresolvableReference(ref) 是 true,则
    1. 断言ref.[[Strict]]false
    2. 返回 true
  4. 如果 IsPropertyReference(ref) 是 true,则
    1. 断言IsPrivateReference(ref) 是 false
    2. 如果 IsSuperReference(ref) 是 true,抛出 ReferenceError 异常。
    3. baseObj 为 ? ToObject(ref.[[Base]])。
    4. deleteStatus 为 ? baseObj.[[Delete]](ref.[[ReferencedName]])。
    5. 如果 deleteStatusfalse 并且 ref.[[Strict]]true,抛出 TypeError 异常。
    6. 返回 deleteStatus
  5. 否则,
    1. baseref.[[Base]]
    2. 断言base环境记录
    3. 返回 ? base.DeleteBinding(ref.[[ReferencedName]])。
注 1

delete 运算符出现在 严格模式代码 中时,如果其 UnaryExpression 是直接引用变量、函数参数或函数名,则抛出 SyntaxError 异常。此外,如果 delete 运算符出现在 严格模式代码 中,并且要删除的属性具有属性 { [[Configurable]]: false }(或无法删除),则抛出 TypeError 异常。

注 2

在步骤 4.c 中可能创建的对象在上述抽象操作和 普通对象[[Delete]] 内部方法之外不可访问。实现可能会选择避免实际创建该对象。

13.5.2 The void 运算符

13.5.2.1 运行时语义:评估

UnaryExpression : void UnaryExpression
  1. expr 为 ? 评估UnaryExpression
  2. 执行 ? GetValue(expr)。
  3. 返回 undefined

GetValue 必须被调用,即使它的值没有被使用,因为它可能有可观察的副作用。

13.5.3 The typeof 运算符

13.5.3.1 运行时语义:评估

UnaryExpression : typeof UnaryExpression
  1. val 为 ? 评估UnaryExpression
  2. 如果 val引用记录,则
    1. 如果 IsUnresolvableReference(val) 是 true,返回 "undefined"
  3. val 为 ? GetValue(val)。
  4. 如果 valundefined,返回 "undefined"
  5. 如果 valnull,返回 "object"
  6. 如果 val 是字符串,返回 "string"
  7. 如果 val 是符号,返回 "symbol"
  8. 如果 val 是布尔值,返回 "boolean"
  9. 如果 val 是数字,返回 "number"
  10. 如果 val 是大整数,返回 "bigint"
  11. 断言val 是对象
  12. 注意:这一步在章节 B.3.6.3 中被替换。
  13. 如果 val[[Call]] 内部槽,返回 "function"
  14. 返回 "object"

13.5.4 一元 + 运算符

一元 + 运算符将其操作数转换为 数字类型

13.5.4.1 运行时语义:评估

UnaryExpression : + UnaryExpression
  1. expr 为 ? 评估UnaryExpression
  2. 返回 ? ToNumber(? GetValue(expr))。

13.5.5 一元 - 运算符

一元 - 运算符将其操作数转换为数值,然后对其取反。取反 +0𝔽 产生 -0𝔽,取反 -0𝔽 产生 +0𝔽

13.5.5.1 运行时语义:评估

UnaryExpression : - UnaryExpression
  1. expr 为 ? 评估UnaryExpression
  2. oldValue 为 ? ToNumeric(? GetValue(expr))。
  3. 如果 oldValue 是数字,则
    1. 返回 Number::unaryMinus(oldValue)。
  4. 否则,
    1. 断言oldValue 是大整数
    2. 返回 BigInt::unaryMinus(oldValue)。

13.5.6 按位 NOT 运算符 ( ~ )

13.5.6.1 运行时语义:评估

UnaryExpression : ~ UnaryExpression
  1. expr 为 ? 评估UnaryExpression
  2. oldValue 为 ? ToNumeric(? GetValue(expr))。
  3. 如果 oldValue 是数字,则
    1. 返回 Number::bitwiseNOT(oldValue)。
  4. 否则,
    1. 断言oldValue 是大整数
    2. 返回 BigInt::bitwiseNOT(oldValue)。

13.5.7 逻辑 NOT 运算符 ( ! )

13.5.7.1 运行时语义:评估

UnaryExpression : ! UnaryExpression
  1. expr 为 ? 评估UnaryExpression
  2. oldValueToBoolean(? GetValue(expr))。
  3. 如果 oldValuetrue,返回 false
  4. 返回 true

13.6 幂运算符

语法

ExponentiationExpression[Yield, Await] : UnaryExpression[?Yield, ?Await] UpdateExpression[?Yield, ?Await] ** ExponentiationExpression[?Yield, ?Await]

13.6.1 运行时语义:评估

ExponentiationExpression : UpdateExpression ** ExponentiationExpression
  1. 返回 ? EvaluateStringOrNumericBinaryExpression(UpdateExpression, **, ExponentiationExpression).

13.7 乘法运算符

语法

MultiplicativeExpression[Yield, Await] : ExponentiationExpression[?Yield, ?Await] MultiplicativeExpression[?Yield, ?Await] MultiplicativeOperator ExponentiationExpression[?Yield, ?Await] MultiplicativeOperator : one of * / %
  • 运算符 * 执行乘法,生成其操作数的乘积。
  • 运算符 / 执行除法,生成其操作数的商。
  • 运算符 % 生成其操作数在隐式除法中的余数。

13.7.1 运行时语义:评估

MultiplicativeExpression : MultiplicativeExpression MultiplicativeOperator ExponentiationExpression
  1. opText源文本匹配的 MultiplicativeOperator
  2. 返回 ? EvaluateStringOrNumericBinaryExpression(MultiplicativeExpression, opText, ExponentiationExpression)。

13.8 加法运算符

语法

AdditiveExpression[Yield, Await] : MultiplicativeExpression[?Yield, ?Await] AdditiveExpression[?Yield, ?Await] + MultiplicativeExpression[?Yield, ?Await] AdditiveExpression[?Yield, ?Await] - MultiplicativeExpression[?Yield, ?Await]

13.8.1 加法运算符 ( + )

加法运算符既可以执行字符串连接,也可以执行数值加法。

13.8.1.1 运行时语义:评估

AdditiveExpression : AdditiveExpression + MultiplicativeExpression
  1. 返回 ? EvaluateStringOrNumericBinaryExpression(AdditiveExpression, +, MultiplicativeExpression)。

13.8.2 减法运算符 ( - )

减法运算符执行减法,生成其操作数的差值。

13.8.2.1 运行时语义:评估

AdditiveExpression : AdditiveExpression - MultiplicativeExpression
  1. 返回 ? EvaluateStringOrNumericBinaryExpression(AdditiveExpression, -, MultiplicativeExpression)。

13.9 位移运算符

语法

ShiftExpression[Yield, Await] : AdditiveExpression[?Yield, ?Await] ShiftExpression[?Yield, ?Await] << AdditiveExpression[?Yield, ?Await] ShiftExpression[?Yield, ?Await] >> AdditiveExpression[?Yield, ?Await] ShiftExpression[?Yield, ?Await] >>> AdditiveExpression[?Yield, ?Await]

13.9.1 左移运算符 ( << )

对左操作数执行按位左移操作,移动的位数由右操作数指定。

13.9.1.1 运行时语义:评估

ShiftExpression : ShiftExpression << AdditiveExpression
  1. 返回 ? EvaluateStringOrNumericBinaryExpression(ShiftExpression, <<, AdditiveExpression)。

13.9.2 带符号右移运算符 ( >> )

对左操作数执行按位右移操作,移动的位数由右操作数指定,并使用符号位填充空出的位。

13.9.2.1 运行时语义:评估

ShiftExpression : ShiftExpression >> AdditiveExpression
  1. 返回 ? EvaluateStringOrNumericBinaryExpression(ShiftExpression, >>, AdditiveExpression)。

13.9.3 无符号右移运算符 ( >>> )

对左操作数执行按位右移操作,移动的位数由右操作数指定,并使用零填充空出的位。

13.9.3.1 运行时语义:评估

ShiftExpression : ShiftExpression >>> AdditiveExpression
  1. 返回 ? EvaluateStringOrNumericBinaryExpression(ShiftExpression, >>>, AdditiveExpression)。

13.10 关系运算符

注 1

关系运算符的求值结果总是布尔类型,反映运算符命名的关系是否在其两个操作数之间成立。

语法

RelationalExpression [In, Yield, Await] : ShiftExpression [?Yield, ?Await] RelationalExpression [?In, ?Yield, ?Await] < ShiftExpression [?Yield, ?Await] RelationalExpression [?In, ?Yield, ?Await] > ShiftExpression [?Yield, ?Await] RelationalExpression [?In, ?Yield, ?Await] <= ShiftExpression [?Yield, ?Await] RelationalExpression [?In, ?Yield, ?Await] >= ShiftExpression [?Yield, ?Await] RelationalExpression [?In, ?Yield, ?Await] instanceof ShiftExpression [?Yield, ?Await] [+In] RelationalExpression [+In, ?Yield, ?Await] in ShiftExpression [?Yield, ?Await] [+In] PrivateIdentifier in ShiftExpression [?Yield, ?Await] 注 2

[In] 语法参数是为了避免在关系表达式中混淆 in 运算符和 for 语句中的 in 运算符。

13.10.1 运行时语义: 求值

RelationalExpression : RelationalExpression < ShiftExpression
  1. lref 为 ?  Evaluation of RelationalExpression
  2. lval 为 ?  GetValue (lref)。
  3. rref 为 ?  Evaluation of ShiftExpression
  4. rval 为 ?  GetValue (rref)。
  5. r 为 ?  IsLessThan (lval, rval, true)。
  6. 如果 rundefined,返回 false。否则,返回 r
RelationalExpression : RelationalExpression > ShiftExpression
  1. lref 为 ?  Evaluation of RelationalExpression
  2. lval 为 ?  GetValue (lref)。
  3. rref 为 ?  Evaluation of ShiftExpression
  4. rval 为 ?  GetValue (rref)。
  5. r 为 ?  IsLessThan (rval, lval, false)。
  6. 如果 rundefined,返回 false。否则,返回 r
RelationalExpression : RelationalExpression <= ShiftExpression
  1. lref 为 ?  Evaluation of RelationalExpression
  2. lval 为 ?  GetValue (lref)。
  3. rref 为 ?  Evaluation of ShiftExpression
  4. rval 为 ?  GetValue (rref)。
  5. r 为 ?  IsLessThan (rval, lval, false)。
  6. 如果 rtrueundefined,返回 false。否则,返回 true
RelationalExpression : RelationalExpression >= ShiftExpression
  1. lref 为 ?  Evaluation of RelationalExpression
  2. lval 为 ?  GetValue (lref)。
  3. rref 为 ?  Evaluation of ShiftExpression
  4. rval 为 ?  GetValue (rref)。
  5. r 为 ?  IsLessThan (lval, rval, true)。
  6. 如果 rtrueundefined,返回 false。否则,返回 true
RelationalExpression : RelationalExpression instanceof ShiftExpression
  1. lref 为 ?  Evaluation of RelationalExpression
  2. lval 为 ?  GetValue (lref)。
  3. rref 为 ?  Evaluation of ShiftExpression
  4. rval 为 ?  GetValue (rref)。
  5. 返回 ?  InstanceofOperator (lval, rval)。
RelationalExpression : RelationalExpression in ShiftExpression
  1. lref 为 ?  Evaluation of RelationalExpression
  2. lval 为 ?  GetValue (lref)。
  3. rref 为 ?  Evaluation of ShiftExpression
  4. rval 为 ?  GetValue (rref)。
  5. 如果 rval 不是对象 ,抛出 TypeError 异常。
  6. 返回 ?  HasProperty (rval,?  ToPropertyKey (lval))。
RelationalExpression : PrivateIdentifier in ShiftExpression
  1. privateIdentifier StringValue of PrivateIdentifier
  2. rref 为 ?  Evaluation of ShiftExpression
  3. rval 为 ?  GetValue (rref)。
  4. 如果 rval 不是对象 ,抛出 TypeError 异常。
  5. privateEnv 运行执行上下文 的 PrivateEnvironment。
  6. privateName ResolvePrivateIdentifier (privateEnvprivateIdentifier)。
  7. 如果 PrivateElementFind (rvalprivateName) 不是 empty,返回 true
  8. 返回 false

13.10.2 InstanceofOperator ( V, target )

抽象操作 InstanceofOperator 接受参数 V(一个 ECMAScript 语言值 )和 target(一个 ECMAScript 语言值 )并返回一个包含布尔值或抛出完成记录的 正常完成 记录。它实现了一个通用算法,用于确定 V 是否是 target 的实例,方法是咨询 target @@hasInstance 方法,或者在没有这种方法的情况下,确定 target"prototype" 属性的值是否存在于 V 的原型链中。调用时执行以下步骤:

  1. 如果 target 不是对象 ,抛出 TypeError 异常。
  2. instOfHandler 为 ?  GetMethod (target @@hasInstance )。
  3. 如果 instOfHandler 不是 undefined,则
    1. 返回 ToBoolean (? Call (instOfHandlertarget,« V »))。
  4. 如果 IsCallable (target) 是 false,抛出 TypeError 异常。
  5. 返回 ?  OrdinaryHasInstance (targetV)。

步骤 4 5 提供了与以前版本的 ECMAScript 的兼容性,这些版本没有使用 @@hasInstance 方法来定义 instanceof 运算符语义。如果对象没有定义或继承 @@hasInstance ,它将使用默认的 instanceof 语义。

13.11 等值运算符

等值运算符的求值结果总是布尔类型,反映运算符命名的关系是否在其两个操作数之间成立。

语法

EqualityExpression [In, Yield, Await] : RelationalExpression [?In, ?Yield, ?Await] EqualityExpression [?In, ?Yield, ?Await] == RelationalExpression [?In, ?Yield, ?Await] EqualityExpression [?In, ?Yield, ?Await] != RelationalExpression [?In, ?Yield, ?Await] EqualityExpression [?In, ?Yield, ?Await] === RelationalExpression [?In, ?Yield, ?Await] EqualityExpression [?In, ?Yield, ?Await] !== RelationalExpression [?In, ?Yield, ?Await]

13.11.1 运行时语义:求值

EqualityExpression : EqualityExpression == RelationalExpression
  1. lref 为 ?  Evaluation of EqualityExpression
  2. lval 为 ?  GetValue (lref)。
  3. rref 为 ?  Evaluation of RelationalExpression
  4. rval 为 ?  GetValue (rref)。
  5. 返回 ?  IsLooselyEqual (rval, lval)。
EqualityExpression : EqualityExpression != RelationalExpression
  1. lref 为 ?  Evaluation of EqualityExpression
  2. lval 为 ?  GetValue (lref)。
  3. rref 为 ?  Evaluation of RelationalExpression
  4. rval 为 ?  GetValue (rref)。
  5. r 为 ?  IsLooselyEqual (rval, lval)。
  6. 如果 rtrue,返回 false。否则,返回 true
EqualityExpression : EqualityExpression === RelationalExpression
  1. lref 为 ?  Evaluation of EqualityExpression
  2. lval 为 ?  GetValue (lref)。
  3. rref 为 ?  Evaluation of RelationalExpression
  4. rval 为 ?  GetValue (rref)。
  5. 返回 IsStrictlyEqual (rval, lval)。
EqualityExpression : EqualityExpression !== RelationalExpression
  1. lref 为 ?  Evaluation of EqualityExpression
  2. lval 为 ?  GetValue (lref)。
  3. rref 为 ?  Evaluation of RelationalExpression
  4. rval 为 ?  GetValue (rref)。
  5. r IsStrictlyEqual (rval, lval)。
  6. 如果 rtrue,返回 false。否则,返回 true
注 1

根据上述等值定义:

  • 字符串比较可以通过:`${a}` == `${b}` 强制进行。
  • 数字比较可以通过:+a == +b 强制进行。
  • 布尔值比较可以通过:!a == !b 强制进行。
注 2

等值运算符保持以下不变量:

  • A != B 等价于 !(A == B)
  • A == B 等价于 B == A,除了 AB 的求值顺序。
注 3

等值运算符并不总是传递的。例如,可能存在两个不同的字符串对象,每个对象表示相同的字符串值;每个字符串对象会被 == 运算符视为与字符串值相等,但这两个字符串对象彼此并不相等。例如:

  • new String("a") == "a""a" == new String("a") 均为 true
  • new String("a") == new String("a")false
注 4

字符串比较使用简单的代码单元值相等测试。不会尝试使用 Unicode 规范中定义的更复杂的、语义导向的字符或字符串相等性定义和排序顺序。因此,根据 Unicode 标准规范等价的字符串值可能会被测试为不相等。实际上,这个算法假设两个字符串都已处于规范化形式。

13.12 二进制按位运算符

语法

BitwiseANDExpression [In, Yield, Await] : EqualityExpression [?In, ?Yield, ?Await] BitwiseANDExpression [?In, ?Yield, ?Await] & EqualityExpression [?In, ?Yield, ?Await] BitwiseXORExpression [In, Yield, Await] : BitwiseANDExpression [?In, ?Yield, ?Await] BitwiseXORExpression [?In, ?Yield, ?Await] ^ BitwiseANDExpression [?In, ?Yield, ?Await] BitwiseORExpression [In, Yield, Await] : BitwiseXORExpression [?In, ?Yield, ?Await] BitwiseORExpression [?In, ?Yield, ?Await] | BitwiseXORExpression [?In, ?Yield, ?Await]

13.12.1 运行时语义:求值

BitwiseANDExpression : BitwiseANDExpression & EqualityExpression
  1. 返回 ?  EvaluateStringOrNumericBinaryExpression ( BitwiseANDExpression , &, EqualityExpression )。
BitwiseXORExpression : BitwiseXORExpression ^ BitwiseANDExpression
  1. 返回 ?  EvaluateStringOrNumericBinaryExpression ( BitwiseXORExpression , ^, BitwiseANDExpression )。
BitwiseORExpression : BitwiseORExpression | BitwiseXORExpression
  1. 返回 ?  EvaluateStringOrNumericBinaryExpression ( BitwiseORExpression , |, BitwiseXORExpression )。

13.13 二进制逻辑运算符

语法

LogicalANDExpression [In, Yield, Await] : BitwiseORExpression [?In, ?Yield, ?Await] LogicalANDExpression [?In, ?Yield, ?Await] && BitwiseORExpression [?In, ?Yield, ?Await] LogicalORExpression [In, Yield, Await] : LogicalANDExpression [?In, ?Yield, ?Await] LogicalORExpression [?In, ?Yield, ?Await] || LogicalANDExpression [?In, ?Yield, ?Await] CoalesceExpression [In, Yield, Await] : CoalesceExpressionHead [?In, ?Yield, ?Await] ?? BitwiseORExpression [?In, ?Yield, ?Await] CoalesceExpressionHead [In, Yield, Await] : CoalesceExpression [?In, ?Yield, ?Await] BitwiseORExpression [?In, ?Yield, ?Await] ShortCircuitExpression [In, Yield, Await] : LogicalORExpression [?In, ?Yield, ?Await] CoalesceExpression [?In, ?Yield, ?Await]

&&|| 运算符生成的值不一定是布尔类型。生成的值始终是两个操作数表达式之一的值。

13.13.1 运行时语义:求值

LogicalANDExpression : LogicalANDExpression && BitwiseORExpression
  1. lref 为 ?  Evaluation of LogicalANDExpression
  2. lval 为 ?  GetValue (lref)。
  3. lbool ToBoolean (lval)。
  4. 如果 lboolfalse,则返回 lval
  5. rref 为 ?  Evaluation of BitwiseORExpression
  6. 返回 ?  GetValue (rref)。
LogicalORExpression : LogicalORExpression || LogicalANDExpression
  1. lref 为 ?  Evaluation of LogicalORExpression
  2. lval 为 ?  GetValue (lref)。
  3. lbool ToBoolean (lval)。
  4. 如果 lbooltrue,则返回 lval
  5. rref 为 ?  Evaluation of LogicalANDExpression
  6. 返回 ?  GetValue (rref)。
CoalesceExpression : CoalesceExpressionHead ?? BitwiseORExpression
  1. lref 为 ?  Evaluation of CoalesceExpressionHead
  2. lval 为 ?  GetValue (lref)。
  3. 如果 lvalundefinednull,则
    1. rref 为 ?  Evaluation of BitwiseORExpression
    2. 返回 ?  GetValue (rref)。
  4. 否则,
    1. 返回 lval

13.14 条件操作符(? :

语法

ConditionalExpression [In, Yield, Await] : ShortCircuitExpression [?In, ?Yield, ?Await] ShortCircuitExpression [?In, ?Yield, ?Await] ? AssignmentExpression [+In, ?Yield, ?Await] : AssignmentExpression [?In, ?Yield, ?Await]

ECMAScript 中 ConditionalExpression 的语法与 C 和 Java 中的稍有不同。C 和 Java 允许第二个子表达式是一个 Expression ,但限制第三个表达式为 ConditionalExpression 。ECMAScript 这样设计的动机是允许赋值表达式由条件的任意一边控制,并且消除在中间表达式中出现逗号表达式这一困惑且几乎无用的情况。

13.14.1 运行时语义:求值

ConditionalExpression : ShortCircuitExpression ? AssignmentExpression : AssignmentExpression
  1. lref 为 ?  Evaluation of ShortCircuitExpression
  2. lval ToBoolean (? GetValue (lref))。
  3. 如果 lvaltrue,则
    1. trueRef 为 ?  Evaluation of 第一个 AssignmentExpression
    2. 返回 ?  GetValue (trueRef)。
  4. 否则,
    1. falseRef 为 ?  Evaluation of 第二个 AssignmentExpression
    2. 返回 ?  GetValue (falseRef)。

13.15 赋值操作符

语法

AssignmentExpression[In, Yield, Await] : ConditionalExpression[?In, ?Yield, ?Await] [+Yield] YieldExpression[?In, ?Await] ArrowFunction[?In, ?Yield, ?Await] AsyncArrowFunction[?In, ?Yield, ?Await] LeftHandSideExpression[?Yield, ?Await] = AssignmentExpression[?In, ?Yield, ?Await] LeftHandSideExpression[?Yield, ?Await] AssignmentOperator AssignmentExpression[?In, ?Yield, ?Await] LeftHandSideExpression[?Yield, ?Await] &&= AssignmentExpression[?In, ?Yield, ?Await] LeftHandSideExpression[?Yield, ?Await] ||= AssignmentExpression[?In, ?Yield, ?Await] LeftHandSideExpression[?Yield, ?Await] ??= AssignmentExpression[?In, ?Yield, ?Await] AssignmentOperator : one of *= /= %= += -= <<= >>= >>>= &= ^= |= **=

13.15.1 静态语义:早期错误

AssignmentExpression : LeftHandSideExpression = AssignmentExpression

如果 LeftHandSideExpression ObjectLiteral ArrayLiteral ,则应用以下早期错误规则:

如果 LeftHandSideExpression 既不是 ObjectLiteral 也不是 ArrayLiteral ,则应用以下早期错误规则:

AssignmentExpression : LeftHandSideExpression AssignmentOperator AssignmentExpression LeftHandSideExpression &&= AssignmentExpression LeftHandSideExpression ||= AssignmentExpression LeftHandSideExpression ??= AssignmentExpression

13.15.2 运行时语义:求值

AssignmentExpression : LeftHandSideExpression = AssignmentExpression
  1. 如果 LeftHandSideExpression 既不是 ObjectLiteral 也不是 ArrayLiteral ,则:
    1. lref是对 Evaluation LeftHandSideExpression 的求值。
    2. 如果 IsAnonymousFunctionDefinition ( AssignmentExpression )和 IsIdentifierRef LeftHandSideExpression 都为true,则:
      1. rval是对 NamedEvaluation ( AssignmentExpression ),带有参数lref.[[ReferencedName]]
    3. 否则,
      1. rref是对 Evaluation ( AssignmentExpression )的求值。
      2. rval是对 GetValue (rref)的求值。
    4. 执行 PutValue ( lrefrval)。
    5. 返回rval
  2. assignmentPattern成为 AssignmentPattern ,由 涵盖 LeftHandSideExpression
  3. rref是对 Evaluation ( AssignmentExpression )的求值。
  4. rval是对 GetValue (rref)的求值。
  5. 执行 DestructuringAssignmentEvaluation assignmentPattern,带有参数rval
  6. 返回rval
AssignmentExpression : LeftHandSideExpression AssignmentOperator AssignmentExpression
  1. lref是对 Evaluation LeftHandSideExpression 的求值。
  2. lval是对 GetValue (lref)的求值。
  3. rref是对 Evaluation AssignmentExpression 的求值。
  4. rval是对 GetValue (rref)的求值。
  5. assignmentOpText 源文本匹配 AssignmentOperator
  6. opText成为以下表格中与assignmentOpText关联的Unicode代码点序列:
    assignmentOpText opText
    **= **
    *= *
    /= /
    %= %
    += +
    -= -
    <<= <<
    >>= >>
    >>>= >>>
    &= &
    ^= ^
    |= |
  7. r是对 ApplyStringOrNumericBinaryOperator ( lvalopTextrval)的求值。
  8. 执行 PutValue ( lrefr)。
  9. 返回r
AssignmentExpression : LeftHandSideExpression &&= AssignmentExpression
  1. lref是对 Evaluation LeftHandSideExpression 的求值。
  2. lval是对 GetValue (lref)的求值。
  3. lbool ToBoolean (lval)的求值。
  4. 如果lboolfalse,返回lval
  5. 如果 IsAnonymousFunctionDefinition ( AssignmentExpression )为 true,且 IsIdentifierRef LeftHandSideExpression true,则:
    1. rval是对 NamedEvaluation ( AssignmentExpression ),带有参数 lref.[[ReferencedName]]
  6. 否则,
    1. rref是对 Evaluation AssignmentExpression 的求值。
    2. rval是对 GetValue (rref)的求值。
  7. 执行 PutValue ( lrefrval)。
  8. 返回rval
AssignmentExpression : LeftHandSideExpression ||= AssignmentExpression
  1. lref是对 Evaluation LeftHandSideExpression 的求值。
  2. lval是对 GetValue (lref)的求值。
  3. lbool ToBoolean (lval)的求值。
  4. 如果lbooltrue,返回lval
  5. 如果 IsAnonymousFunctionDefinition ( AssignmentExpression )为 true,且 IsIdentifierRef LeftHandSideExpression true,则:
    1. rval是对 NamedEvaluation ( AssignmentExpression ),带有参数 lref.[[ReferencedName]]
  6. 否则,
    1. rref是对 Evaluation AssignmentExpression 的求值。
    2. rval是对 GetValue (rref)的求值。
  7. 执行 PutValue ( lrefrval)。
  8. 返回rval
AssignmentExpression : LeftHandSideExpression ??= AssignmentExpression
  1. lref是对 Evaluation LeftHandSideExpression 的求值。
  2. lval是对 GetValue (lref)的求值。
  3. 如果 lval既不是undefined也不是null,返回 lval
  4. 如果 IsAnonymousFunctionDefinition ( AssignmentExpression )为 true,且 IsIdentifierRef LeftHandSideExpression true,则:
    1. rval是对 NamedEvaluation ( AssignmentExpression ),带有参数 lref.[[ReferencedName]]
  5. 否则,
    1. rref是对 Evaluation AssignmentExpression 的求值。
    2. rval是对 GetValue (rref)的求值。
  6. 执行 PutValue ( lrefrval)。
  7. 返回rval

当此表达式出现在 严格模式代码 中时,如果步骤 1.d 2 2 2 2 中的 lref是不可解析的引用,则会抛出ReferenceError异常。此外,如果 lref在步骤 8 7 7 6 中引用了具有属性值{[[Writable]]:false}的数据属性、属性值{[[Set]]:undefined}的访问器属性或对于其 IsExtensible 谓词返回值为false的对象的不存在属性,在这些情况下,会抛出TypeError异常。

13.15.3 ApplyStringOrNumericBinaryOperator ( lval, opText, rval )

抽象操作 ApplyStringOrNumericBinaryOperator 接受参数 lval(一个 ECMAScript 语言值)、opText***/%+-<<>>>>>&^|)和 rval(一个 ECMAScript 语言值),并返回一个 正常完成记录,包含一个字符串、一个 BigInt 或一个数字,或者一个 抛出完成。调用时执行以下步骤:

  1. 如果 opText+,则
    1. lprim 为 ? ToPrimitive(lval)。
    2. rprim 为 ? ToPrimitive(rval)。
    3. 如果 lprim字符串rprim字符串,则
      1. lstr 为 ? ToString(lprim)。
      2. rstr 为 ? ToString(rprim)。
      3. 返回 lstrrstr字符串连接
    4. lval 设置为 lprim
    5. rval 设置为 rprim
  2. 注意:此时,它必须是一个数值运算。
  3. lnum 为 ? ToNumeric(lval)。
  4. rnum 为 ? ToNumeric(rval)。
  5. 如果 lnum类型rnum类型 不同,抛出一个 TypeError 异常。
  6. 如果 lnumBigInt,则
    1. 如果 opText**,返回 ? BigInt::exponentiate(lnum, rnum)。
    2. 如果 opText/,返回 ? BigInt::divide(lnum, rnum)。
    3. 如果 opText%,返回 ? BigInt::remainder(lnum, rnum)。
    4. 如果 opText>>>,返回 ? BigInt::unsignedRightShift(lnum, rnum)。
  7. operation 为与以下表格中的 opTextlnum类型 相关的抽象操作:
    opText 类型(lnum) operation
    ** Number Number::exponentiate
    * Number Number::multiply
    * BigInt BigInt::multiply
    / Number Number::divide
    % Number Number::remainder
    + Number Number::add
    + BigInt BigInt::add
    - Number Number::subtract
    - BigInt BigInt::subtract
    << Number Number::leftShift
    << BigInt BigInt::leftShift
    >> Number Number::signedRightShift
    >> BigInt BigInt::signedRightShift
    >>> Number Number::unsignedRightShift
    & Number Number::bitwiseAND
    & BigInt BigInt::bitwiseAND
    ^ Number Number::bitwiseXOR
    ^ BigInt BigInt::bitwiseXOR
    | Number Number::bitwiseOR
    | BigInt BigInt::bitwiseOR
  8. 返回 operation(lnum, rnum)。
注 1

在步骤 ToPrimitive 中没有提供提示。除了日期对象之外,所有标准对象在没有提示的情况下都将其处理为 number;日期对象在没有提示的情况下将其处理为 string特殊对象 可能以其他方式处理没有提示的情况。

注 2

步骤 1.c 与算法 IsLessThan 的步骤 3 不同,使用逻辑或运算而不是逻辑与运算。

13.15.4 EvaluateStringOrNumericBinaryExpression ( leftOperand, opText, rightOperand )

抽象操作 EvaluateStringOrNumericBinaryExpression 接受参数 leftOperand(一个解析节点)、opText(一个 Unicode 代码点序列)和 rightOperand(一个解析节点),返回一个正常完成记录,其中包含一个字符串、BigInt 或数字,或者一个中断完成记录。当被调用时,它执行以下步骤:

  1. lref 为 ? EvaluationleftOperand
  2. lval 为 ? GetValue(lref)。
  3. rref 为 ? EvaluationrightOperand
  4. rval 为 ? GetValue(rref)。
  5. 返回 ? ApplyStringOrNumericBinaryOperator(lval, opText, rval)。

13.15.5 解构赋值

补充语法

在处理以下产生式的实例时
AssignmentExpression : LeftHandSideExpression = AssignmentExpression
对于 LeftHandSideExpression 的解释将使用以下语法进行细化:

AssignmentPattern[Yield, Await] : ObjectAssignmentPattern[?Yield, ?Await] ArrayAssignmentPattern[?Yield, ?Await] ObjectAssignmentPattern[Yield, Await] : { } { AssignmentRestProperty[?Yield, ?Await] } { AssignmentPropertyList[?Yield, ?Await] } { AssignmentPropertyList[?Yield, ?Await] , AssignmentRestProperty[?Yield, ?Await]opt } ArrayAssignmentPattern[Yield, Await] : [ Elisionopt AssignmentRestElement[?Yield, ?Await]opt ] [ AssignmentElementList[?Yield, ?Await] ] [ AssignmentElementList[?Yield, ?Await] , Elisionopt AssignmentRestElement[?Yield, ?Await]opt ] AssignmentRestProperty[Yield, Await] : ... DestructuringAssignmentTarget[?Yield, ?Await] AssignmentPropertyList[Yield, Await] : AssignmentProperty[?Yield, ?Await] AssignmentPropertyList[?Yield, ?Await] , AssignmentProperty[?Yield, ?Await] AssignmentElementList[Yield, Await] : AssignmentElisionElement[?Yield, ?Await] AssignmentElementList[?Yield, ?Await] , AssignmentElisionElement[?Yield, ?Await] AssignmentElisionElement[Yield, Await] : Elisionopt AssignmentElement[?Yield, ?Await] AssignmentProperty[Yield, Await] : IdentifierReference[?Yield, ?Await] Initializer[+In, ?Yield, ?Await]opt PropertyName[?Yield, ?Await] : AssignmentElement[?Yield, ?Await] AssignmentElement[Yield, Await] : DestructuringAssignmentTarget[?Yield, ?Await] Initializer[+In, ?Yield, ?Await]opt AssignmentRestElement[Yield, Await] : ... DestructuringAssignmentTarget[?Yield, ?Await] DestructuringAssignmentTarget[Yield, Await] : LeftHandSideExpression[?Yield, ?Await]

13.15.5.1 静态语义:早期错误

AssignmentProperty : IdentifierReference Initializeropt AssignmentRestProperty : ... DestructuringAssignmentTarget DestructuringAssignmentTarget : LeftHandSideExpression

如果 LeftHandSideExpressionObjectLiteralArrayLiteral,则适用以下早期错误规则:

如果 LeftHandSideExpression 既不是 ObjectLiteral 也不是 ArrayLiteral,则适用以下早期错误规则:

13.15.5.2 运行时语义:DestructuringAssignmentEvaluation

语法指引操作 DestructuringAssignmentEvaluation 接受参数 value(一个 ECMAScript 语言值 )并返回一个包含 正常完成 unused 或一个 突然完成 。它通过以下生成规则分段定义:

ObjectAssignmentPattern : { }
  1. 执行 ? RequireObjectCoercible (value)。
  2. 返回 unused
ObjectAssignmentPattern : { AssignmentPropertyList } { AssignmentPropertyList , }
  1. 执行 ? RequireObjectCoercible (value)。
  2. 执行 ? PropertyDestructuringAssignmentEvaluation of AssignmentPropertyList with argument value
  3. 返回 unused
ObjectAssignmentPattern : { AssignmentRestProperty }
  1. 执行 ? RequireObjectCoercible (value)。
  2. excludedNames 成为一个新的空的 列表
  3. 返回 ? RestDestructuringAssignmentEvaluation of AssignmentRestProperty with arguments valueexcludedNames
ObjectAssignmentPattern : { AssignmentPropertyList , AssignmentRestProperty }
  1. 执行 ? RequireObjectCoercible (value)。
  2. excludedNames 成为 ? PropertyDestructuringAssignmentEvaluation of AssignmentPropertyList with argument value
  3. 返回 ? RestDestructuringAssignmentEvaluation of AssignmentRestProperty with arguments valueexcludedNames
ArrayAssignmentPattern : [ ]
  1. iteratorRecord 成为 ? GetIterator (value, sync)。
  2. 返回 ? IteratorClose (iteratorRecord, NormalCompletion (unused))。
ArrayAssignmentPattern : [ Elision ]
  1. iteratorRecord 成为 ? GetIterator (value, sync)。
  2. result 成为 Completion ( IteratorDestructuringAssignmentEvaluation of Elision with argument iteratorRecord)。
  3. 如果 iteratorRecord.[[Done]]false,返回 ? IteratorClose (iteratorRecord, result)。
  4. 返回 result
ArrayAssignmentPattern : [ Elisionopt AssignmentRestElement ]
  1. iteratorRecord 成为 ? GetIterator (value, sync)。
  2. 如果 Elision 存在,则
    1. status 成为 Completion ( IteratorDestructuringAssignmentEvaluation of Elision with argument iteratorRecord)。
    2. 如果 status 是一个 突然完成 ,则
      1. 断言: iteratorRecord.[[Done]]true
      2. 返回 ? status
  3. result 成为 Completion ( IteratorDestructuringAssignmentEvaluation of AssignmentRestElement with argument iteratorRecord)。
  4. 如果 iteratorRecord.[[Done]]false,返回 ? IteratorClose (iteratorRecord, result)。
  5. 返回 result
ArrayAssignmentPattern : [ AssignmentElementList , Elisionopt AssignmentRestElementopt ]
  1. iteratorRecord 成为 ? GetIterator (value, sync)。
  2. status 成为 Completion ( IteratorDestructuringAssignmentEvaluation of AssignmentElementList with argument iteratorRecord)。
  3. 如果 status 是一个 突然完成 ,则
    1. 如果 iteratorRecord.[[Done]]false,返回 ? IteratorClose (iteratorRecord, status)。
    2. 返回 ? status
  4. 如果 Elision 存在,则
    1. 设置 status Completion ( IteratorDestructuringAssignmentEvaluation of Elision with argument iteratorRecord)。
    2. 如果 status 是一个 突然完成 ,则
      1. 断言: iteratorRecord.[[Done]]true
      2. 返回 ? status
  5. 如果 AssignmentRestElement 存在,则
    1. 设置 status Completion ( IteratorDestructuringAssignmentEvaluation of AssignmentRestElement with argument iteratorRecord)。
  6. 如果 iteratorRecord.[[Done]]false,返回 ? IteratorClose (iteratorRecord, status)。
  7. 返回 ? status

13.15.5.3 运行时语义:属性解构赋值求值

语法导向操作 PropertyDestructuringAssignmentEvaluation 接受参数 value (一个 ECMAScript 语言值),并返回一个 包含的正常完成 属性键列表 或一个 异常完成。它收集所有解构的 属性键。它的定义如下:

AssignmentPropertyList : AssignmentPropertyList , AssignmentProperty
  1. propertyNames 是 ? PropertyDestructuringAssignmentEvaluationAssignmentPropertyList 调用时的参数 value
  2. nextNames 是 ? PropertyDestructuringAssignmentEvaluationAssignmentProperty 调用时的参数 value
  3. 返回 propertyNamesnextNames列表连接
AssignmentProperty : IdentifierReference Initializeropt
  1. PStringValueIdentifierReference
  2. lref 是 ? ResolveBinding(P)。
  3. v 是 ? GetV(value, P)。
  4. 如果 Initializer 存在并且 vundefined,则
    1. 如果 IsAnonymousFunctionDefinition(Initializer) 为 true,则
      1. v 设置为 ? NamedEvaluationInitializer 参数为 P
    2. 否则,
      1. defaultValue 是 ? EvaluationInitializer
      2. v 设置为 ? GetValue(defaultValue)。
  5. 执行 ? PutValue(lref, v)。
  6. 返回 « P »。
AssignmentProperty : PropertyName : AssignmentElement
  1. name 是 ? EvaluationPropertyName
  2. 执行 ? KeyedDestructuringAssignmentEvaluationAssignmentElement 参数为 valuename
  3. 返回 « name »。

13.15.5.4 运行时语义:RestDestructuringAssignmentEvaluation

语法导向操作 RestDestructuringAssignmentEvaluation 接受参数 value (一个 ECMAScript 语言值) 和 excludedNames(一个 列表属性键),并返回一个 包含 unused 的正常完成记录,或一个 异常完成。它的定义如下:

AssignmentRestProperty : ... DestructuringAssignmentTarget
  1. lref 是 ? EvaluationDestructuringAssignmentTarget
  2. restObjOrdinaryObjectCreate(%Object.prototype%)。
  3. 执行 ? CopyDataProperties(restObj, value, excludedNames)。
  4. 返回 ? PutValue(lref, restObj)。

13.15.5.5 运行时语义:IteratorDestructuringAssignmentEvaluation

语法导向操作 IteratorDestructuringAssignmentEvaluation 接受参数 iteratorRecord(一个 迭代器记录)并返回一个 包含 unused 的正常完成记录或一个 异常完成。它的定义如下:

AssignmentElementList : AssignmentElisionElement
  1. 返回 ? IteratorDestructuringAssignmentEvaluationAssignmentElisionElement 传入参数 iteratorRecord
AssignmentElementList : AssignmentElementList , AssignmentElisionElement
  1. 执行 ? IteratorDestructuringAssignmentEvaluationAssignmentElementList 传入参数 iteratorRecord
  2. 返回 ? IteratorDestructuringAssignmentEvaluationAssignmentElisionElement 传入参数 iteratorRecord
AssignmentElisionElement : AssignmentElement
  1. 返回 ? IteratorDestructuringAssignmentEvaluationAssignmentElement 传入参数 iteratorRecord
AssignmentElisionElement : Elision AssignmentElement
  1. 执行 ? IteratorDestructuringAssignmentEvaluationElision 传入参数 iteratorRecord
  2. 返回 ? IteratorDestructuringAssignmentEvaluationAssignmentElement 传入参数 iteratorRecord
Elision : ,
  1. 如果 iteratorRecord.[[Done]]false,那么
    1. nextCompletion(IteratorStep(iteratorRecord))。
    2. 如果 next 是一个 异常完成,设置 iteratorRecord.[[Done]]true
    3. ReturnIfAbrupt(next)。
    4. 如果 nextfalse,设置 iteratorRecord.[[Done]]true
  2. 返回 unused
Elision : Elision ,
  1. 执行 ? IteratorDestructuringAssignmentEvaluationElision 传入参数 iteratorRecord
  2. 如果 iteratorRecord.[[Done]]false,那么
    1. nextCompletion(IteratorStep(iteratorRecord))。
    2. 如果 next 是一个 异常完成,设置 iteratorRecord.[[Done]]true
    3. ReturnIfAbrupt(next)。
    4. 如果 nextfalse,设置 iteratorRecord.[[Done]]true
  3. 返回 unused
AssignmentElement : DestructuringAssignmentTarget Initializeropt
  1. 如果 DestructuringAssignmentTarget 既不是一个 ObjectLiteral 也不是一个 ArrayLiteral,那么
    1. lref 为 ? EvaluationDestructuringAssignmentTarget
  2. valueundefined
  3. 如果 iteratorRecord.[[Done]]false,那么
    1. next 为 ? IteratorStepValueiteratorRecord
    2. 如果 next 不是 done,那么
      1. 设置 valuenext
  4. 如果 Initializer 存在并且 valueundefined,那么
    1. 如果 IsAnonymousFunctionDefinition(Initializer) 是 true 并且 IsIdentifierRefDestructuringAssignmentTargettrue,那么
      1. v 为 ? NamedEvaluationInitializer 传入参数 lref.[[ReferencedName]]
    2. 否则,
      1. defaultValue 为 ? EvaluationInitializer
      2. v 为 ? GetValue(defaultValue)。
  5. 否则,
    1. vvalue
  6. 如果 DestructuringAssignmentTarget 是一个 ObjectLiteral 或一个 ArrayLiteral,那么
    1. nestedAssignmentPattern 为一个 AssignmentPattern, 它被 覆盖DestructuringAssignmentTarget
    2. 返回 ? DestructuringAssignmentEvaluationnestedAssignmentPattern 传入参数 v
  7. 返回 ? PutValue(lref, v)。

从左到右的求值顺序通过在访问迭代器或求值 DestructuringAssignmentTarget 不是解构模式之前先求值 Initializer 来保持。

AssignmentRestElement : ... DestructuringAssignmentTarget
  1. 如果 DestructuringAssignmentTarget 既不是一个 ObjectLiteral 也不是一个 ArrayLiteral,那么
    1. lref 为 ? EvaluationDestructuringAssignmentTarget
  2. A 为 ! ArrayCreate(0)。
  3. n 为 0。
  4. 重复,直到 iteratorRecord.[[Done]]false
    1. next 为 ? IteratorStepValueiteratorRecord
    2. 如果 next 不是 done,那么
      1. 执行 ! CreateDataPropertyOrThrowA, ! ToString𝔽nnext
      2. 设置 nn + 1。
  5. 如果 DestructuringAssignmentTarget 既不是一个 ObjectLiteral 也不是一个 ArrayLiteral,那么
    1. 返回 ? PutValuelrefA
  6. nestedAssignmentPattern 为一个 AssignmentPattern, 它被 覆盖DestructuringAssignmentTarget
  7. 返回 ? DestructuringAssignmentEvaluationnestedAssignmentPattern 传入参数 A

13.15.5.6 运行时语义:KeyedDestructuringAssignmentEvaluation

语法指向操作 KeyedDestructuringAssignmentEvaluation 接受参数 value(一个 ECMAScript 语言值 )和 propertyName(一个 属性键 ),并返回一个 包含的正常完成 unused 异常完成 。它逐一定义在以下产生式上:

AssignmentElement : DestructuringAssignmentTarget Initializer opt
  1. 如果 DestructuringAssignmentTarget 既不是 ObjectLiteral 也不是 ArrayLiteral ,那么
    1. lref 为 ? Evaluation DestructuringAssignmentTarget
  2. v 为 ? GetV valuepropertyName
  3. 如果 Initializer 存在并且 vundefined,那么
    1. 如果 IsAnonymousFunctionDefinition Initializer 并且 IsIdentifierRef DestructuringAssignmentTarget 都为 true,那么
      1. rhsValue 为 ? NamedEvaluation Initializer 传入参数 lref.[[ReferencedName]]
    2. 否则,
      1. defaultValue 为 ? Evaluation Initializer
      2. rhsValue 为 ? GetValue defaultValue
  4. 否则,
    1. rhsValuev
  5. 如果 DestructuringAssignmentTarget 是一个 ObjectLiteral ArrayLiteral ,那么
    1. assignmentPattern AssignmentPattern ,它被 覆盖 DestructuringAssignmentTarget
    2. 返回 ? DestructuringAssignmentEvaluation assignmentPattern 传入参数 rhsValue
  6. 返回 ? PutValue lrefrhsValue

13.16 逗号操作符 (,)

语法

Expression [In, Yield, Await] : AssignmentExpression [?In, ?Yield, ?Await] Expression [?In, ?Yield, ?Await] , AssignmentExpression [?In, ?Yield, ?Await]

13.16.1 运行时语义:Evaluation

Expression : Expression , AssignmentExpression
  1. lref 为 ?  Evaluation Expression
  2. 执行 ?  GetValue (lref)。
  3. rref 为 ?  Evaluation AssignmentExpression
  4. 返回 ?  GetValue (rref)。

GetValue 必须被调用,即使其值未被使用,因为它可能具有可观察的副作用。

14 ECMAScript 语言:语句和声明

语法

Statement[Yield, Await, Return] : BlockStatement[?Yield, ?Await, ?Return] VariableStatement[?Yield, ?Await] EmptyStatement ExpressionStatement[?Yield, ?Await] IfStatement[?Yield, ?Await, ?Return] BreakableStatement[?Yield, ?Await, ?Return] ContinueStatement[?Yield, ?Await] BreakStatement[?Yield, ?Await] [+Return] ReturnStatement[?Yield, ?Await] WithStatement[?Yield, ?Await, ?Return] LabelledStatement[?Yield, ?Await, ?Return] ThrowStatement[?Yield, ?Await] TryStatement[?Yield, ?Await, ?Return] DebuggerStatement Declaration[Yield, Await] : HoistableDeclaration[?Yield, ?Await, ~Default] ClassDeclaration[?Yield, ?Await, ~Default] LexicalDeclaration[+In, ?Yield, ?Await] HoistableDeclaration[Yield, Await, Default] : FunctionDeclaration[?Yield, ?Await, ?Default] GeneratorDeclaration[?Yield, ?Await, ?Default] AsyncFunctionDeclaration[?Yield, ?Await, ?Default] AsyncGeneratorDeclaration[?Yield, ?Await, ?Default] BreakableStatement[Yield, Await, Return] : IterationStatement[?Yield, ?Await, ?Return] SwitchStatement[?Yield, ?Await, ?Return]

14.1 语句语义

14.1.1 运行时语义:求值

HoistableDeclaration : GeneratorDeclaration AsyncFunctionDeclaration AsyncGeneratorDeclaration
  1. 返回 empty
HoistableDeclaration : FunctionDeclaration
  1. 返回 ? 求值 of FunctionDeclaration
BreakableStatement : IterationStatement SwitchStatement
  1. newLabelSet 为一个空的 List
  2. 返回 ? LabelledEvaluation of this BreakableStatement with argument newLabelSet

14.2

语法

BlockStatement[Yield, Await, Return] : Block[?Yield, ?Await, ?Return] Block[Yield, Await, Return] : { StatementList[?Yield, ?Await, ?Return]opt } StatementList[Yield, Await, Return] : StatementListItem[?Yield, ?Await, ?Return] StatementList[?Yield, ?Await, ?Return] StatementListItem[?Yield, ?Await, ?Return] StatementListItem[Yield, Await, Return] : Statement[?Yield, ?Await, ?Return] Declaration[?Yield, ?Await]

14.2.1 静态语义:早期错误

Block : { StatementList }

14.2.2 运行时语义:求值

Block : { }
  1. 返回 empty
Block : { StatementList }
  1. oldEnv运行中的执行上下文的 LexicalEnvironment。
  2. blockEnvNewDeclarativeEnvironment(oldEnv)。
  3. 执行 BlockDeclarationInstantiation(StatementList, blockEnv)。
  4. 运行中的执行上下文的 LexicalEnvironment 设置为 blockEnv
  5. blockValueCompletion(求值 of StatementList)。
  6. 运行中的执行上下文的 LexicalEnvironment 设置为 oldEnv
  7. 返回 ? blockValue
注 1

无论控制如何离开 Block,LexicalEnvironment 总是恢复到其以前的状态。

StatementList : StatementList StatementListItem
  1. sl 为 ? 求值 of StatementList
  2. sCompletion(求值 of StatementListItem)。
  3. 返回 ? UpdateEmpty(s, sl)。
注 2

StatementList 的值是 StatementList 中最后一个产生值的项的值。例如,以下对 eval 函数的调用都返回值 1:

eval("1;;;;;")
eval("1;{}")
eval("1;var a;")

14.2.3 BlockDeclarationInstantiation ( code, env )

抽象操作 BlockDeclarationInstantiation 接受参数 code(一个 解析节点)和 env (一个 声明性环境记录)并返回 unusedcode 是与块体对应的 解析节点env 是将在其中创建绑定的 环境记录

BlockCaseBlock 被求值时,会创建一个新的 声明性环境记录,并且块作用域内的每个变量、常量、函数或类声明的绑定会在 环境记录 中实例化。

当调用时,它执行以下步骤:

  1. declarationscodeLexicallyScopedDeclarations
  2. privateEnv运行中的执行上下文的 PrivateEnvironment。
  3. 对于 declarations 的每个元素 d,执行
    1. 对于 dBoundNames 的每个元素 dn,执行
      1. 如果 dIsConstantDeclarationtrue,则
        1. 执行 ! env.CreateImmutableBinding(dn, true)。
      2. 否则,
        1. 执行 ! env.CreateMutableBinding(dn, false)。注意:此步骤在 B.3.2.6 中被替换。
    2. 如果 dFunctionDeclarationGeneratorDeclarationAsyncFunctionDeclarationAsyncGeneratorDeclaration,则
      1. fndBoundNames 的唯一元素。
      2. fodInstantiateFunctionObject,参数为 envprivateEnv
      3. 执行 ! env.InitializeBinding(fn, fo)。注意:此步骤在 B.3.2.6 中被替换。
  4. 返回 unused

14.3 声明和变量语句

14.3.1 Let 和 Const 声明

letconst 声明定义的变量作用域为 运行中的执行上下文的 LexicalEnvironment。变量在其包含的 环境记录 被实例化时创建,但在变量的 LexicalBinding 被求值之前不能以任何方式访问。带有 InitializerLexicalBinding 定义的变量在 Initializer 被求值时被赋值,而不是在变量创建时。如果 let 声明中的 LexicalBinding 没有 Initializer,则变量在 LexicalBinding 被求值时被赋值为 undefined

语法

LexicalDeclaration[In, Yield, Await] : LetOrConst BindingList[?In, ?Yield, ?Await] ; LetOrConst : let const BindingList[In, Yield, Await] : LexicalBinding[?In, ?Yield, ?Await] BindingList[?In, ?Yield, ?Await] , LexicalBinding[?In, ?Yield, ?Await] LexicalBinding[In, Yield, Await] : BindingIdentifier[?Yield, ?Await] Initializer[?In, ?Yield, ?Await]opt BindingPattern[?Yield, ?Await] Initializer[?In, ?Yield, ?Await]

14.3.1.1 静态语义:早期错误

LexicalDeclaration : LetOrConst BindingList ; LexicalBinding : BindingIdentifier Initializeropt

14.3.1.2 运行时语义:求值

LexicalDeclaration : LetOrConst BindingList ;
  1. 执行 ? 求值 of BindingList
  2. 返回 empty
BindingList : BindingList , LexicalBinding
  1. 执行 ? 求值 of BindingList
  2. 返回 ? 求值 of LexicalBinding
LexicalBinding : BindingIdentifier
  1. lhs 为 ! ResolveBinding(StringValue of BindingIdentifier)。
  2. 执行 ! InitializeReferencedBinding(lhs, undefined)。
  3. 返回 empty

一个 静态语义 规则确保这种形式的 LexicalBinding 永远不会出现在 const 声明中。

LexicalBinding : BindingIdentifier Initializer
  1. bindingIdStringValue of BindingIdentifier
  2. lhs 为 ! ResolveBinding(bindingId)。
  3. 如果 IsAnonymousFunctionDefinition(Initializer) is true,则
    1. value 为 ? NamedEvaluation of Initializer with argument bindingId
  4. 否则,
    1. rhs 为 ? 求值 of Initializer
    2. value 为 ? GetValue(rhs)。
  5. 执行 ! InitializeReferencedBinding(lhs, value)。
  6. 返回 empty
LexicalBinding : BindingPattern Initializer
  1. rhs 为 ? 求值 of Initializer
  2. value 为 ? GetValue(rhs)。
  3. env运行中的执行上下文的 LexicalEnvironment。
  4. 返回 ? BindingInitialization of BindingPattern with arguments value and env

14.3.2 变量语句

一个 var 语句声明的变量作用域为 运行中的执行上下文的 VariableEnvironment。Var 变量在其包含的 环境记录 被实例化时创建,并初始化为 undefined。在任何 VariableEnvironment 的作用域内,一个共同的 BindingIdentifier 可能出现在多个 VariableDeclaration 中,但这些声明共同定义了一个变量。带有 InitializerVariableDeclaration 定义的变量在 Initializer 被求值时被赋值,而不是在变量创建时。

语法

VariableStatement[Yield, Await] : var VariableDeclarationList[+In, ?Yield, ?Await] ; VariableDeclarationList[In, Yield, Await] : VariableDeclaration[?In, ?Yield, ?Await] VariableDeclarationList[?In, ?Yield, ?Await] , VariableDeclaration[?In, ?Yield, ?Await] VariableDeclaration[In, Yield, Await] : BindingIdentifier[?Yield, ?Await] Initializer[?In, ?Yield, ?Await]opt BindingPattern[?Yield, ?Await] Initializer[?In, ?Yield, ?Await]

14.3.2.1 运行时语义:求值

VariableStatement : var VariableDeclarationList ;
  1. 执行 ? 求值 of VariableDeclarationList
  2. 返回 empty
VariableDeclarationList : VariableDeclarationList , VariableDeclaration
  1. 执行 ? 求值 of VariableDeclarationList
  2. 返回 ? 求值 of VariableDeclaration
VariableDeclaration : BindingIdentifier
  1. 返回 empty
VariableDeclaration : BindingIdentifier Initializer
  1. bindingIdStringValue of BindingIdentifier
  2. lhs 为 ? ResolveBinding(bindingId)。
  3. 如果 IsAnonymousFunctionDefinition(Initializer) is true,则
    1. value 为 ? NamedEvaluation of Initializer with argument bindingId
  4. 否则,
    1. rhs 为 ? 求值 of Initializer
    2. value 为 ? GetValue(rhs)。
  5. 执行 ? PutValue(lhs, value)。
  6. 返回 empty

如果一个 VariableDeclaration 嵌套在一个 with 语句中,并且 BindingIdentifierVariableDeclaration 中与 with 语句的绑定对象的 属性名 相同,那么步骤 5 将把 value 赋值给该属性,而不是赋值给 VariableEnvironment 绑定。

VariableDeclaration : BindingPattern Initializer
  1. rhs 为 ? 求值 of Initializer
  2. rval 为 ? GetValue(rhs)。
  3. 返回 ? BindingInitialization of BindingPattern with arguments rval and undefined

14.3.3 解构绑定模式

语法

BindingPattern[Yield, Await] : ObjectBindingPattern[?Yield, ?Await] ArrayBindingPattern[?Yield, ?Await] ObjectBindingPattern[Yield, Await] : { } { BindingRestProperty[?Yield, ?Await] } { BindingPropertyList[?Yield, ?Await] } { BindingPropertyList[?Yield, ?Await] , BindingRestProperty[?Yield, ?Await]opt } ArrayBindingPattern[Yield, Await] : [ Elisionopt BindingRestElement[?Yield, ?Await]opt ] [ BindingElementList[?Yield, ?Await] ] [ BindingElementList[?Yield, ?Await] , Elisionopt BindingRestElement[?Yield, ?Await]opt ] BindingRestProperty[Yield, Await] : ... BindingIdentifier[?Yield, ?Await] BindingPropertyList[Yield, Await] : BindingProperty[?Yield, ?Await] BindingPropertyList[?Yield, ?Await] , BindingProperty[?Yield, ?Await] BindingElementList[Yield, Await] : BindingElisionElement[?Yield, ?Await] BindingElementList[?Yield, ?Await] , BindingElisionElement[?Yield, ?Await] BindingElisionElement[Yield, Await] : Elisionopt BindingElement[?Yield, ?Await] BindingProperty[Yield, Await] : SingleNameBinding[?Yield, ?Await] PropertyName[?Yield, ?Await] : BindingElement[?Yield, ?Await] BindingElement[Yield, Await] : SingleNameBinding[?Yield, ?Await] BindingPattern[?Yield, ?Await] Initializer[+In, ?Yield, ?Await]opt SingleNameBinding[Yield, Await] : BindingIdentifier[?Yield, ?Await] Initializer[+In, ?Yield, ?Await]opt BindingRestElement[Yield, Await] : ... BindingIdentifier[?Yield, ?Await] ... BindingPattern[?Yield, ?Await]

14.3.3.1 运行时语义:属性绑定初始化

属性绑定初始化是一个 语法导向操作,它接受参数 value(一个 ECMAScript 语言值)和 environment(一个 环境记录undefined),并返回一个 正常完成 包含一个 列表属性键 或一个 突然完成。它收集所有绑定属性名的列表。它在以下产生式上分段定义:

BindingPropertyList : BindingPropertyList , BindingProperty
  1. boundNames 为 ? 属性绑定初始化 of BindingPropertyList 使用参数 valueenvironment
  2. nextNames 为 ? 属性绑定初始化 of BindingProperty 使用参数 valueenvironment
  3. 返回 boundNamesnextNames列表连接
BindingProperty : SingleNameBinding
  1. nameSingleNameBindingBoundNames 的唯一元素。
  2. 执行 ? 键绑定初始化 of SingleNameBinding 使用参数 valueenvironmentname
  3. 返回 « name »。
BindingProperty : PropertyName : BindingElement
  1. P 为 ? 求值 of PropertyName
  2. 执行 ? 键绑定初始化 of BindingElement 使用参数 valueenvironmentP
  3. 返回 « P »。

14.3.3.2 运行时语义:剩余绑定初始化

剩余绑定初始化是一个 语法导向操作,它接受参数 value(一个 ECMAScript 语言值)、environment(一个 环境记录undefined)和 excludedNames(一个 列表属性键),并返回一个 正常完成 包含 unused 或一个 突然完成。它在以下产生式上分段定义:

BindingRestProperty : ... BindingIdentifier
  1. lhs 为 ? ResolveBinding(StringValue of BindingIdentifier, environment)。
  2. restObjOrdinaryObjectCreate(%Object.prototype%)。
  3. 执行 ? CopyDataProperties(restObj, value, excludedNames)。
  4. 如果 environmentundefined, 返回 ? PutValue(lhs, restObj)。
  5. 返回 ? InitializeReferencedBinding(lhs, restObj)。

14.3.3.3 运行时语义:键绑定初始化

键绑定初始化是一个 语法导向操作,它接受参数 value(一个 ECMAScript 语言值)、environment(一个 环境记录undefined)和 propertyName(一个 属性键),并返回一个 正常完成 包含 unused 或一个 突然完成。它定义在以下产生式上分段:

undefined 作为 environment 传递时,表示应该使用 PutValue 操作来分配初始化值。这种情况发生在 非严格函数 的形式参数列表中。在这种情况下,形式参数绑定是预初始化的,以处理多个参数具有相同名称的可能性。

它在以下产生式上分段定义:

BindingElement : BindingPattern Initializeropt
  1. v 为 ? GetV(value, propertyName)。
  2. 如果 Initializer 存在且 vundefined,则
    1. defaultValue 为 ? 求值 of Initializer
    2. 设置 v 为 ? GetValue(defaultValue)。
  3. 返回 ? 绑定初始化 of BindingPattern 使用参数 venvironment
SingleNameBinding : BindingIdentifier Initializeropt
  1. bindingIdStringValue of BindingIdentifier
  2. lhs 为 ? ResolveBinding(bindingId, environment)。
  3. v 为 ? GetV(value, propertyName)。
  4. 如果 Initializer 存在且 vundefined,则
    1. 如果 IsAnonymousFunctionDefinition(Initializer) is true,则
      1. 设置 v 为 ? NamedEvaluation of Initializer with argument bindingId
    2. 否则,
      1. defaultValue 为 ? 求值 of Initializer
      2. 设置 v 为 ? GetValue(defaultValue)。
  5. 如果 environmentundefined, 返回 ? PutValue(lhs, v)。
  6. 返回 ? InitializeReferencedBinding(lhs, v)。

14.4 空语句

语法

EmptyStatement : ;

14.4.1 运行时语义:求值

EmptyStatement : ;
  1. 返回 empty

14.5 表达式语句

语法

ExpressionStatement[Yield, Await] : [lookahead ∉ { {, function, async [no LineTerminator here] function, class, let [ }] Expression[+In, ?Yield, ?Await] ;

一个 ExpressionStatement 不能以一个 U+007B (LEFT CURLY BRACKET) 开始,因为这可能会使其与一个 Block 产生歧义。一个 ExpressionStatement 不能以 functionclass 关键字 开始,因为这可能会使其与一个 FunctionDeclaration、一个 GeneratorDeclaration 或一个 ClassDeclaration 产生歧义。一个 ExpressionStatement 不能以 async function 开始,因为这可能会使其与一个 AsyncFunctionDeclaration 或一个 AsyncGeneratorDeclaration 产生歧义。一个 ExpressionStatement 不能以两个标记序列 let [ 开始,因为这可能会使其与一个 let LexicalDeclaration 的第一个 LexicalBinding 是一个 ArrayBindingPattern 产生歧义。

14.5.1 运行时语义:求值

ExpressionStatement : Expression ;
  1. exprRef 为 ? 求值 of Expression
  2. 返回 ? GetValue(exprRef)。

14.6 if 语句

语法

IfStatement[Yield, Await, Return] : if ( Expression[+In, ?Yield, ?Await] ) Statement[?Yield, ?Await, ?Return] else Statement[?Yield, ?Await, ?Return] if ( Expression[+In, ?Yield, ?Await] ) Statement[?Yield, ?Await, ?Return] [lookahead ≠ else]
前瞻限制 [lookahead ≠ else] 以通常的方式解决了经典的“悬空 else”问题。也就是说,当关联的 if 选择不明确时,else 与最近的(最内层的)候选 if 相关联。

14.6.1 静态语义:早期错误

IfStatement : if ( Expression ) Statement else Statement IfStatement : if ( Expression ) Statement

只有在实现 B.3.1 中指定的扩展时,才需要应用此规则。

14.6.2 运行时语义:求值

IfStatement : if ( Expression ) Statement else Statement
  1. exprRef 为 ? 求值 of Expression.
  2. exprValueToBoolean(? GetValue(exprRef)).
  3. 如果 exprValuetrue,则
    1. stmtCompletionCompletion(求值 of the first Statement).
  4. 否则
    1. stmtCompletionCompletion(求值 of the second Statement).
  5. 返回 ? UpdateEmpty(stmtCompletion, undefined).
IfStatement : if ( Expression ) Statement
  1. exprRef 为 ? 求值 of Expression.
  2. exprValueToBoolean(? GetValue(exprRef)).
  3. 如果 exprValuefalse,则
    1. 返回 undefined.
  4. 否则
    1. stmtCompletionCompletion(求值 of Statement).
    2. 返回 ? UpdateEmpty(stmtCompletion, undefined).

14.7 迭代语句

语法

IterationStatement[Yield, Await, Return] : DoWhileStatement[?Yield, ?Await, ?Return] WhileStatement[?Yield, ?Await, ?Return] ForStatement[?Yield, ?Await, ?Return] ForInOfStatement[?Yield, ?Await, ?Return]

14.7.1 语义

14.7.1.1 LoopContinues ( completion, labelSet )

抽象操作 LoopContinues 接受参数 completion(一个 Completion Record)和 labelSet(一个 List of Strings)并返回一个 Boolean。它在调用时执行以下步骤:

  1. 如果 completion 是一个 normal completion,返回 true
  2. 如果 completion 不是一个 continue completion,返回 false
  3. 如果 completion.[[Target]]empty,返回 true
  4. 如果 labelSet 包含 completion.[[Target]],返回 true
  5. 返回 false

Statement 部分的 IterationStatement 中,ContinueStatement 可以用于开始一个新的迭代。

14.7.1.2 运行时语义:LoopEvaluation

语法导向操作 LoopEvaluation 接受参数 labelSet(一个 List of Strings)并返回一个 normal completion containing 一个 ECMAScript language value 或一个 abrupt completion。它在以下产生式上定义:

IterationStatement : DoWhileStatement
  1. 返回 ? DoWhileLoopEvaluation of DoWhileStatement with argument labelSet.
IterationStatement : WhileStatement
  1. 返回 ? WhileLoopEvaluation of WhileStatement with argument labelSet.
IterationStatement : ForStatement
  1. 返回 ? ForLoopEvaluation of ForStatement with argument labelSet.
IterationStatement : ForInOfStatement
  1. 返回 ? ForInOfLoopEvaluation of ForInOfStatement with argument labelSet.

14.7.2 do-while 语句

语法

DoWhileStatement[Yield, Await, Return] : do Statement[?Yield, ?Await, ?Return] while ( Expression[+In, ?Yield, ?Await] ) ;

14.7.2.1 静态语义:早期错误

DoWhileStatement : do Statement while ( Expression ) ;

只有在实现 B.3.1 中指定的扩展时,才需要应用此规则。

14.7.2.2 运行时语义:DoWhileLoopEvaluation

语法导向操作 DoWhileLoopEvaluation 接受参数 labelSet(一个 List of Strings)并返回一个 normal completion containing 一个 ECMAScript language value 或一个 abrupt completion。它在以下产生式上定义:

DoWhileStatement : do Statement while ( Expression ) ;
  1. Vundefined
  2. 重复,
    1. stmtResultCompletion(求值 of Statement)。
    2. 如果 LoopContinues(stmtResult, labelSet) 是 false,返回 ? UpdateEmpty(stmtResult, V)。
    3. 如果 stmtResult.[[Value]] 不是 empty,设 VstmtResult.[[Value]]
    4. exprRef 为 ? 求值 of Expression
    5. exprValue 为 ? GetValue(exprRef)。
    6. 如果 ToBoolean(exprValue) 是 false,返回 V

14.7.3 while 语句

语法

WhileStatement[Yield, Await, Return] : while ( Expression[+In, ?Yield, ?Await] ) Statement[?Yield, ?Await, ?Return]

14.7.3.1 静态语义:早期错误

WhileStatement : while ( Expression ) Statement

只有在实现 B.3.1 中指定的扩展时,才需要应用此规则。

14.7.3.2 运行时语义:WhileLoopEvaluation

语法导向操作 WhileLoopEvaluation 接受参数 labelSet(一个 List of Strings)并返回一个 normal completion containing 一个 ECMAScript language value 或一个 abrupt completion。它在以下产生式上定义:

WhileStatement : while ( Expression ) Statement
  1. Vundefined
  2. 重复,
    1. exprRef 为 ? 求值 of Expression
    2. exprValue 为 ? GetValue(exprRef)。
    3. 如果 ToBoolean(exprValue) 是 false,返回 V
    4. stmtResultCompletion(求值 of Statement)。
    5. 如果 LoopContinues(stmtResult, labelSet) 是 false,返回 ? UpdateEmpty(stmtResult, V)。
    6. 如果 stmtResult.[[Value]] 不是 empty,设 VstmtResult.[[Value]]

14.7.4 for 语句

语法

ForStatement[Yield, Await, Return] : for ( [lookahead ≠ let [] Expression[~In, ?Yield, ?Await]opt ; Expression[+In, ?Yield, ?Await]opt ; Expression[+In, ?Yield, ?Await]opt ) Statement[?Yield, ?Await, ?Return] for ( var VariableDeclarationList[~In, ?Yield, ?Await] ; Expression[+In, ?Yield, ?Await]opt ; Expression[+In, ?Yield, ?Await]opt ) Statement[?Yield, ?Await, ?Return] for ( LexicalDeclaration[~In, ?Yield, ?Await] Expression[+In, ?Yield, ?Await]opt ; Expression[+In, ?Yield, ?Await]opt ) Statement[?Yield, ?Await, ?Return]

14.7.4.1 静态语义:早期错误

ForStatement : for ( Expressionopt ; Expressionopt ; Expressionopt ) Statement for ( var VariableDeclarationList ; Expressionopt ; Expressionopt ) Statement for ( LexicalDeclaration Expressionopt ; Expressionopt ) Statement

只有在实现 B.3.1 中指定的扩展时,才需要应用此规则。

ForStatement : for ( LexicalDeclaration Expressionopt ; Expressionopt ) Statement

14.7.4.2 运行时语义:ForLoopEvaluation

语法导向操作 ForLoopEvaluation 接受参数 labelSet(一个 List of Strings)并返回一个 normal completion containing 一个 ECMAScript language value 或一个 abrupt completion。它在以下产生式上定义:

ForStatement : for ( Expressionopt ; Expressionopt ; Expressionopt ) Statement
  1. 如果第一个 Expression 存在,则
    1. exprRef 为 ? 求值 of the first Expression
    2. 执行 ? GetValue(exprRef)。
  2. 如果第二个 Expression 存在,设 test 为第二个 Expression;否则,设 testempty
  3. 如果第三个 Expression 存在,设 increment 为第三个 Expression;否则,设 incrementempty
  4. 返回 ? ForBodyEvaluation(test, increment, Statement, « », labelSet)。
ForStatement : for ( var VariableDeclarationList ; Expressionopt ; Expressionopt ) Statement
  1. 执行 ? 求值 of VariableDeclarationList
  2. 如果第一个 Expression 存在,设 test 为第一个 Expression;否则,设 testempty
  3. 如果第二个 Expression 存在,设 increment 为第二个 Expression;否则,设 incrementempty
  4. 返回 ? ForBodyEvaluation(test, increment, Statement, « », labelSet)。
ForStatement : for ( LexicalDeclaration Expressionopt ; Expressionopt ) Statement
  1. oldEnv运行执行上下文的词法环境。
  2. loopEnvNewDeclarativeEnvironment(oldEnv)。
  3. isConstIsConstantDeclaration of LexicalDeclaration
  4. boundNamesBoundNames of LexicalDeclaration
  5. 对于 boundNames 的每个元素 dn,执行
    1. 如果 isConsttrue,则
      1. 执行 ! loopEnv.CreateImmutableBinding(dn, true)。
    2. 否则,
      1. 执行 ! loopEnv.CreateMutableBinding(dn, false)。
  6. 运行执行上下文的词法环境设置为 loopEnv
  7. forDclCompletion(求值 of LexicalDeclaration)。
  8. 如果 forDcl 是一个 abrupt completion,则
    1. 运行执行上下文的词法环境设置为 oldEnv
    2. 返回 ? forDcl
  9. 如果 isConstfalse,设 perIterationLetsboundNames;否则设 perIterationLets 为 一个新的空 List
  10. 如果第一个 Expression 存在,设 test 为第一个 Expression;否则,设 testempty
  11. 如果第二个 Expression 存在,设 increment 为第二个 Expression;否则,设 incrementempty
  12. bodyResultCompletion(ForBodyEvaluation(test, increment, Statement, perIterationLets, labelSet))。
  13. 运行执行上下文的词法环境设置为 oldEnv
  14. 返回 ? bodyResult

14.7.4.3 ForBodyEvaluation ( test, increment, stmt, perIterationBindings, labelSet )

抽象操作 ForBodyEvaluation 接受参数 test(一个 Expression Parse Nodeempty),increment(一个 Expression Parse Nodeempty),stmt(一个 Statement Parse Node), perIterationBindings(一个 List of Strings),和 labelSet(一个 List of Strings)并返回一个 normal completion containing 一个 ECMAScript language value 或一个 abrupt completion。它在调用时执行以下步骤:

  1. Vundefined
  2. 执行 ? CreatePerIterationEnvironment(perIterationBindings)。
  3. 重复,
    1. 如果 test 不是 empty,则
      1. testRef 为 ? 求值 of test
      2. testValue 为 ? GetValue(testRef)。
      3. 如果 ToBoolean(testValue) 是 false,返回 V
    2. resultCompletion(求值 of stmt)。
    3. 如果 LoopContinues(result, labelSet) 是 false,返回 ? UpdateEmpty(result, V)。
    4. 如果 result.[[Value]] 不是 empty,设 Vresult.[[Value]]
    5. 执行 ? CreatePerIterationEnvironment(perIterationBindings)。
    6. 如果 increment 不是 empty,则
      1. incRef 为 ? 求值 of increment
      2. 执行 ? GetValue(incRef)。

14.7.4.4 CreatePerIterationEnvironment ( perIterationBindings )

抽象操作 CreatePerIterationEnvironment 接受参数 perIterationBindings (一个 List of Strings)并返回一个 normal completion containing unused 或一个 throw completion。它在调用时执行以下步骤:

  1. 如果 perIterationBindings 有任何元素,则
    1. lastIterationEnv运行执行上下文的词法环境。
    2. outerlastIterationEnv.[[OuterEnv]]
    3. 断言outer 不是 null
    4. thisIterationEnvNewDeclarativeEnvironment(outer)。
    5. 对于 perIterationBindings 的每个元素 bn,执行
      1. 执行 ! thisIterationEnv.CreateMutableBinding(bn, false)。
      2. lastValue 为 ? lastIterationEnv.GetBindingValue(bn, true)。
      3. 执行 ! thisIterationEnv.InitializeBinding(bn, lastValue)。
    6. 运行执行上下文的词法环境设置为 thisIterationEnv
  2. 返回 unused

14.7.5 for-infor-offor-await-of 语句

语法

ForInOfStatement[Yield, Await, Return] : for ( [lookahead ≠ let [] LeftHandSideExpression[?Yield, ?Await] in Expression[+In, ?Yield, ?Await] ) Statement[?Yield, ?Await, ?Return] for ( var ForBinding[?Yield, ?Await] in Expression[+In, ?Yield, ?Await] ) Statement[?Yield, ?Await, ?Return] for ( ForDeclaration[?Yield, ?Await] in Expression[+In, ?Yield, ?Await] ) Statement[?Yield, ?Await, ?Return] for ( [lookahead ∉ { let, async of }] LeftHandSideExpression[?Yield, ?Await] of AssignmentExpression[+In, ?Yield, ?Await] ) Statement[?Yield, ?Await, ?Return] for ( var ForBinding[?Yield, ?Await] of AssignmentExpression[+In, ?Yield, ?Await] ) Statement[?Yield, ?Await, ?Return] for ( ForDeclaration[?Yield, ?Await] of AssignmentExpression[+In, ?Yield, ?Await] ) Statement[?Yield, ?Await, ?Return] [+Await] for await ( [lookahead ≠ let] LeftHandSideExpression[?Yield, ?Await] of AssignmentExpression[+In, ?Yield, ?Await] ) Statement[?Yield, ?Await, ?Return] [+Await] for await ( var ForBinding[?Yield, ?Await] of AssignmentExpression[+In, ?Yield, ?Await] ) Statement[?Yield, ?Await, ?Return] [+Await] for await ( ForDeclaration[?Yield, ?Await] of AssignmentExpression[+In, ?Yield, ?Await] ) Statement[?Yield, ?Await, ?Return] ForDeclaration[Yield, Await] : LetOrConst ForBinding[?Yield, ?Await] ForBinding[Yield, Await] : BindingIdentifier[?Yield, ?Await] BindingPattern[?Yield, ?Await]

本节由附录 B.3.5 扩展。

14.7.5.1 静态语义:早期错误

ForInOfStatement : for ( LeftHandSideExpression in Expression ) Statement for ( var ForBinding in Expression ) Statement for ( ForDeclaration in Expression ) Statement for ( LeftHandSideExpression of AssignmentExpression ) Statement for ( var ForBinding of AssignmentExpression ) Statement for ( ForDeclaration of AssignmentExpression ) Statement for await ( LeftHandSideExpression of AssignmentExpression ) Statement for await ( var ForBinding of AssignmentExpression ) Statement for await ( ForDeclaration of AssignmentExpression ) Statement

只有在实现 B.3.1 中指定的扩展时,才需要应用此规则。

ForInOfStatement : for ( LeftHandSideExpression in Expression ) Statement for ( LeftHandSideExpression of AssignmentExpression ) Statement for await ( LeftHandSideExpression of AssignmentExpression ) Statement

如果 LeftHandSideExpressionObjectLiteralArrayLiteral,则以下早期错误规则适用:

如果 LeftHandSideExpression 既不是 ObjectLiteral 也不是 ArrayLiteral,则以下早期错误规则适用:

ForInOfStatement : for ( ForDeclaration in Expression ) Statement for ( ForDeclaration of AssignmentExpression ) Statement for await ( ForDeclaration of AssignmentExpression ) Statement

14.7.5.2 静态语义:IsDestructuring

语法导向操作 IsDestructuring 不接受参数并返回一个布尔值。它在以下产生式上定义:

MemberExpression : PrimaryExpression
  1. 如果 PrimaryExpressionObjectLiteralArrayLiteral, 返回 true
  2. 返回 false
MemberExpression : MemberExpression [ Expression ] MemberExpression . IdentifierName MemberExpression TemplateLiteral SuperProperty MetaProperty new MemberExpression Arguments MemberExpression . PrivateIdentifier NewExpression : new NewExpression LeftHandSideExpression : CallExpression OptionalExpression
  1. 返回 false
ForDeclaration : LetOrConst ForBinding
  1. 返回 IsDestructuring of ForBinding
ForBinding : BindingIdentifier
  1. 返回 false
ForBinding : BindingPattern
  1. 返回 true

本节由附录 B.3.5 扩展。

14.7.5.3 运行时语义:ForDeclarationBindingInitialization

语法导向操作 ForDeclarationBindingInitialization 接受参数 value(一个 ECMAScript 语言值)和 environment(一个 环境记录undefined)并返回一个 正常完成包含 unused 或一个 异常完成

undefined 传递给 environment 表示应使用 PutValue 操作来分配初始化值。这适用于 var 语句和某些 非严格函数 的形式参数列表(参见 10.2.11)。 在这些情况下,词法绑定被提升并在评估其初始化器之前预初始化。

它在以下产生式上定义:

ForDeclaration : LetOrConst ForBinding
  1. 返回 ? BindingInitialization of ForBinding with arguments value and environment

14.7.5.4 运行时语义:ForDeclarationBindingInstantiation

语法导向操作 ForDeclarationBindingInstantiation 接受参数 environment(一个 声明性环境记录)并返回 unused。它在以下产生式上定义:

ForDeclaration : LetOrConst ForBinding
  1. 对于 BoundNames of ForBinding 的每个元素 name,执行
    1. 如果 IsConstantDeclaration of LetOrConsttrue,则
      1. 执行 ! environment.CreateImmutableBinding(name, true)。
    2. 否则,
      1. 执行 ! environment.CreateMutableBinding(name, false)。
  2. 返回 unused

14.7.5.5 运行时语义:ForInOfLoopEvaluation

语法导向操作 ForInOfLoopEvaluation 接受参数 labelSet(一个 List of Strings)并返回一个 正常完成包含 一个 ECMAScript 语言值 或一个 异常完成。它在以下产生式上定义:

ForInOfStatement : for ( LeftHandSideExpression in Expression ) Statement
  1. keyResult 为 ? ForIn/OfHeadEvaluation(« », Expression, enumerate)。
  2. 返回 ? ForIn/OfBodyEvaluation(LeftHandSideExpression, Statement, keyResult, enumerate, assignment, labelSet)。
ForInOfStatement : for ( var ForBinding in Expression ) Statement
  1. keyResult 为 ? ForIn/OfHeadEvaluation(« », Expression, enumerate)。
  2. 返回 ? ForIn/OfBodyEvaluation(ForBinding, Statement, keyResult, enumerate, var-binding, labelSet)。
ForInOfStatement : for ( ForDeclaration in Expression ) Statement
  1. keyResult 为 ? ForIn/OfHeadEvaluation(BoundNames of ForDeclaration, Expression, enumerate)。
  2. 返回 ? ForIn/OfBodyEvaluation(ForDeclaration, Statement, keyResult, enumerate, lexical-binding, labelSet)。
ForInOfStatement : for ( LeftHandSideExpression of AssignmentExpression ) Statement
  1. keyResult 为 ? ForIn/OfHeadEvaluation(« », AssignmentExpression, iterate)。
  2. 返回 ? ForIn/OfBodyEvaluation(LeftHandSideExpression, Statement, keyResult, iterate, assignment, labelSet)。
ForInOfStatement : for ( var ForBinding of AssignmentExpression ) Statement
  1. keyResult 为 ? ForIn/OfHeadEvaluation(« », AssignmentExpression, iterate)。
  2. 返回 ? ForIn/OfBodyEvaluation(ForBinding, Statement, keyResult, iterate, var-binding, labelSet)。
ForInOfStatement : for ( ForDeclaration of AssignmentExpression ) Statement
  1. keyResult 为 ? ForIn/OfHeadEvaluation(BoundNames of ForDeclaration, AssignmentExpression, iterate)。
  2. 返回 ? ForIn/OfBodyEvaluation(ForDeclaration, Statement, keyResult, iterate, lexical-binding, labelSet)。
ForInOfStatement : for await ( LeftHandSideExpression of AssignmentExpression ) Statement
  1. keyResult 为 ? ForIn/OfHeadEvaluation(« », AssignmentExpression, async-iterate)。
  2. 返回 ? ForIn/OfBodyEvaluation(LeftHandSideExpression, Statement, keyResult, iterate, assignment, labelSet, async)。
ForInOfStatement : for await ( var ForBinding of AssignmentExpression ) Statement
  1. keyResult 为 ? ForIn/OfHeadEvaluation(« », AssignmentExpression, async-iterate)。
  2. 返回 ? ForIn/OfBodyEvaluation(ForBinding, Statement, keyResult, iterate, var-binding, labelSet, async)。
ForInOfStatement : for await ( ForDeclaration of AssignmentExpression ) Statement
  1. keyResult 为 ? ForIn/OfHeadEvaluation(BoundNames of ForDeclaration, AssignmentExpression, async-iterate)。
  2. 返回 ? ForIn/OfBodyEvaluation(ForDeclaration, Statement, keyResult, iterate, lexical-binding, labelSet, async)。

本节由附录 B.3.5 扩展。

14.7.5.6 ForIn/OfHeadEvaluation ( uninitializedBoundNames, expr, iterationKind )

抽象操作 ForIn/OfHeadEvaluation 接受参数 uninitializedBoundNames(一个 字符串列表),expr(一个 表达式 解析节点 或一个 赋值表达式 解析节点),以及 iterationKindenumerateiterate,或 async-iterate),并返回一个 正常完成记录 包含一个 迭代器记录 或一个 异常完成记录。它在调用时执行以下步骤:

  1. oldEnv运行执行上下文 的词法环境。
  2. 如果 uninitializedBoundNames 不为空,则
    1. 断言uninitializedBoundNames 没有重复条目。
    2. newEnvNewDeclarativeEnvironment(oldEnv)。
    3. 对于 uninitializedBoundNames 中的每个字符串 name,执行
      1. 执行 ! newEnv.CreateMutableBinding(name, false)。
    4. 运行执行上下文 的词法环境设置为 newEnv
  3. exprRefCompletion(Evaluation of expr)。
  4. 运行执行上下文 的词法环境设置为 oldEnv
  5. exprValue 为 ? GetValue(? exprRef)。
  6. 如果 iterationKindenumerate,则
    1. 如果 exprValueundefinednull,则
      1. 返回 完成记录 { [[Type]]: break, [[Value]]: empty, [[Target]]: empty }。
    2. obj 为 ! ToObject(exprValue)。
    3. iteratorEnumerateObjectProperties(obj)。
    4. nextMethod 为 ! GetV(iterator, "next")。
    5. 返回 迭代器记录 { [[Iterator]]: iterator, [[NextMethod]]: nextMethod, [[Done]]: false }。
  7. 否则
    1. 断言iterationKinditerateasync-iterate
    2. 如果 iterationKindasync-iterate,令 iteratorKindasync
    3. 否则,令 iteratorKindsync
    4. 返回 ? GetIterator(exprValue, iteratorKind)。

14.7.5.7 ForIn/OfBodyEvaluation ( lhs, stmt, iteratorRecord, iterationKind, lhsKind, labelSet [ , iteratorKind ] )

抽象操作 ForIn/OfBodyEvaluation 接受参数 lhs(一个 解析节点),stmt (一个 语句 解析节点), iteratorRecord(一个 迭代器记录), iterationKindenumerateiterate), lhsKindassignmentvar-binding,或 lexical-binding),以及 labelSet(一个 字符串列表), 以及可选参数 iteratorKindsyncasync),并返回一个 正常完成记录 包含一个 ECMAScript 语言值 或一个 异常完成记录。 它在调用时执行以下步骤:

  1. 如果 iteratorKind 不存在,设置 iteratorKindsync
  2. oldEnv运行执行上下文 的词法环境。
  3. Vundefined
  4. destructuringIsDestructuringlhs
  5. 如果 destructuringtruelhsKindassignment,则
    1. 断言lhs 是一个 LeftHandSideExpression
    2. assignmentPatternAssignmentPattern覆盖lhs
  6. 重复,
    1. nextResult 为 ? Call(iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]])。
    2. 如果 iteratorKindasync, 设置 nextResult 为 ? Await(nextResult)。
    3. 如果 nextResult 不是一个 Object,抛出一个 TypeError 异常。
    4. done 为 ? IteratorComplete(nextResult)。
    5. 如果 donetrue,返回 V
    6. nextValue 为 ? IteratorValue(nextResult)。
    7. 如果 lhsKindassignmentvar-binding,则
      1. 如果 destructuringtrue, 则
        1. 如果 lhsKindassignment,则
          1. statusCompletion(DestructuringAssignmentEvaluation of assignmentPattern with argument nextValue)。
        2. 否则,
          1. 断言lhsKindvar-binding
          2. 断言lhs 是一个 ForBinding
          3. statusCompletion(BindingInitialization of lhs 使用 参数 nextValueundefined)。
      2. 否则,
        1. lhsRefCompletion(Evaluation of lhs)。(可能会被 多次评估。)
        2. 如果 lhsRef 是一个 异常 完成,则
          1. statuslhsRef
        3. 否则,
          1. statusCompletion(PutValue(lhsRef.[[Value]], nextValue))。
    8. 否则,
      1. 断言lhsKindlexical-binding
      2. 断言lhs 是一个 ForDeclaration
      3. iterationEnvNewDeclarativeEnvironment(oldEnv)。
      4. 执行 ForDeclarationBindingInstantiationlhs 使用参数 iterationEnv
      5. 设置 运行 执行上下文 的词法环境为 iterationEnv
      6. 如果 destructuringtrue, 则
        1. statusCompletion(ForDeclarationBindingInitialization of lhs 使用参数 nextValueiterationEnv)。
      7. 否则,
        1. 断言lhs 绑定一个单一的名称。
        2. lhsNameBoundNameslhs 的唯一元素。
        3. lhsRef 为 ! ResolveBinding(lhsName)。
        4. statusCompletion(InitializeReferencedBinding(lhsRef, nextValue))。
    9. 如果 status 是一个 异常 完成,则
      1. 设置 运行 执行上下文 的词法环境为 oldEnv
      2. 如果 iteratorKindasync,返回 ? AsyncIteratorClose(iteratorRecord, status)。
      3. 如果 iterationKindenumerate,则
        1. 返回 ? status
      4. 否则,
        1. 断言iterationKinditerate
        2. 返回 ? IteratorClose(iteratorRecord, status)。
    10. resultCompletion(Evaluation of stmt)。
    11. 设置 运行 执行上下文 的词法环境为 oldEnv
    12. 如果 LoopContinues(result, labelSet) 是 false,则
      1. 如果 iterationKindenumerate,则
        1. 返回 ? UpdateEmpty(result, V)。
      2. 否则,
        1. 断言iterationKinditerate
        2. 设置 statusCompletion(UpdateEmpty(result, V))。
        3. 如果 iteratorKindasync,返回 ? AsyncIteratorClose(iteratorRecord, status)。
        4. 返回 ? IteratorClose(iteratorRecord, status)。
    13. 如果 result.[[Value]] 不是 empty,设置 Vresult.[[Value]]

14.7.5.8 运行时语义:评估

BindingIdentifier : Identifier yield await
  1. bindingIdStringValueBindingIdentifier
  2. 返回 ? ResolveBinding(bindingId)。

14.7.5.9 EnumerateObjectProperties ( O )

抽象操作 EnumerateObjectProperties 接受参数 O(一个对象)并返回一个迭代器。它在调用时执行以下步骤:

  1. 返回一个迭代器对象(27.1.1.2),其 next 方法遍历 O 的所有可枚举的字符串键属性。迭代器对象对 ECMAScript 代码永远不可直接访问。遍历属性的机制和顺序未指定,但必须符合以下规则。

迭代器的 throwreturn 方法是 null,并且永远不会被调用。迭代器的 next 方法处理对象属性以确定属性键是否应作为迭代器值返回。返回的属性键不包括 Symbols。目标对象的属性可能在枚举期间被删除。在迭代器的 next 方法处理之前删除的属性将被忽略。如果在枚举期间向目标对象添加新属性,则不能保证新添加的属性会在活动枚举中被处理。一个属性名在任何枚举中最多由迭代器的 next 方法返回一次。

枚举目标对象的属性包括枚举其原型及其原型的原型等的属性,递归地;但如果原型的属性与迭代器的 next 方法已经处理的属性同名,则不处理原型的属性。原型对象的可枚举属性名必须通过调用 EnumerateObjectProperties 并将原型对象作为参数来获取。EnumerateObjectProperties 必须通过调用目标对象的 [[OwnPropertyKeys]] 内部方法来获取目标对象的自有属性键。目标对象的属性属性必须通过调用其 [[GetOwnProperty]] 内部方法来获取。

此外,如果 O 或其原型链中的任何对象不是 Proxy 奇特对象TypedArray模块命名空间奇特对象,或实现提供的 奇特对象,则迭代器必须表现得像由 CreateForInIterator(O) 给出的迭代器,直到以下情况之一发生:

  • O 或其原型链中的对象的 [[Prototype]] 内部槽的值发生变化,
  • O 或其原型链中的对象的属性被删除,
  • O 的原型链中的对象的属性被添加,或
  • O 或其原型链中的对象的属性的 [[Enumerable]] 属性发生变化。
注1

ECMAScript 实现不需要直接实现 14.7.5.10.2.1 中的算法。它们可以选择任何实现,只要其行为不会偏离该算法,除非违反了前一段中的约束。

以下是一个符合这些规则的 ECMAScript 生成器函数的非正式定义:

function* EnumerateObjectProperties(obj) {
  const visited = new Set();
  for (const key of Reflect.ownKeys(obj)) {
    if (typeof key === "symbol") continue;
    const desc = Reflect.getOwnPropertyDescriptor(obj, key);
    if (desc) {
      visited.add(key);
      if (desc.enumerable) yield key;
    }
  }
  const proto = Reflect.getPrototypeOf(obj);
  if (proto === null) return;
  for (const protoKey of EnumerateObjectProperties(proto)) {
    if (!visited.has(protoKey)) yield protoKey;
  }
}
注2
实现不需要匹配 CreateForInIterator奇特对象 列表是基于历史实现在这些情况下存在差异,并且在所有其他情况下达成一致。

14.7.5.10 For-In 迭代器对象

For-In 迭代器是表示特定对象上的特定迭代的对象。For-In 迭代器对象永远不会直接对 ECMAScript 代码可访问;它们仅存在于阐明 EnumerateObjectProperties 的行为。

14.7.5.10.1 CreateForInIterator ( object )

抽象操作 CreateForInIterator 接受参数 object(一个对象)并返回一个 For-In 迭代器。它用于创建一个 For-In 迭代器对象,该对象按特定顺序迭代 object 的自身和继承的可枚举字符串属性。调用时执行以下步骤:

  1. iteratorOrdinaryObjectCreate(%ForInIteratorPrototype%, « [[Object]], [[ObjectWasVisited]], [[VisitedKeys]], [[RemainingKeys]] »)。
  2. iterator.[[Object]] 设置为 object
  3. iterator.[[ObjectWasVisited]] 设置为 false
  4. iterator.[[VisitedKeys]] 设置为一个新的空 列表
  5. iterator.[[RemainingKeys]] 设置为一个新的空 列表
  6. 返回 iterator

14.7.5.10.2 %ForInIteratorPrototype% 对象

%ForInIteratorPrototype% 对象:

  • 具有所有 For-In 迭代器对象继承的属性。
  • 是一个 普通对象
  • 有一个内部槽 [[Prototype]],其值是 %IteratorPrototype%
  • 永远不能被 ECMAScript 代码直接访问。
  • 具有以下属性:

14.7.5.10.2.1 %ForInIteratorPrototype%.next ( )

  1. Othis 值。
  2. 断言O 是一个 对象
  3. 断言O 具有 For-In 迭代器实例的所有内部槽 (14.7.5.10.3)。
  4. objectO.[[Object]]
  5. 重复,
    1. 如果 O.[[ObjectWasVisited]]false,则
      1. keys 为 ? object.[[OwnPropertyKeys]]()
      2. keys 的每个元素 key,执行
        1. 如果 key 是一个 字符串,则
          1. key 追加到 O.[[RemainingKeys]]
      3. O.[[ObjectWasVisited]] 设置为 true
    2. 重复,直到 O.[[RemainingKeys]] 为空,
      1. rO.[[RemainingKeys]] 的第一个元素。
      2. O.[[RemainingKeys]] 中移除第一个元素。
      3. 如果 O.[[VisitedKeys]] 中不存在一个元素 v 使得 SameValue(r, v) 为 true,则
        1. desc 为 ? object.[[GetOwnProperty]](r)。
        2. 如果 desc 不为 undefined,则
          1. r 追加到 O.[[VisitedKeys]]
          2. 如果 desc.[[Enumerable]]true,返回 CreateIterResultObject(r, false)。
    3. object 设置为 ? object.[[GetPrototypeOf]]()
    4. O.[[Object]] 设置为 object
    5. O.[[ObjectWasVisited]] 设置为 false
    6. 如果 objectnull,返回 CreateIterResultObject(undefined, true)。

14.7.5.10.3 For-In 迭代器实例的属性

For-In 迭代器实例是 普通对象,它们从 %ForInIteratorPrototype% 内部对象继承属性。For-In 迭代器实例初始创建时具有 表 39 中列出的内部槽。

表 39: For-In 迭代器实例的内部槽
内部槽 类型 描述
[[Object]] 一个对象 正在迭代其属性的对象值。
[[ObjectWasVisited]] 一个布尔值 如果迭代器已经在 [[Object]] 上调用了 [[OwnPropertyKeys]] 则为 true,否则为 false
[[VisitedKeys]] 一个 字符串列表 到目前为止,该迭代器已发出的值。
[[RemainingKeys]] 一个 字符串列表 在迭代其原型的属性(如果其原型不为 null)之前,当前对象剩余要发出的值。

14.8 continue 语句

语法

ContinueStatement [Yield, Await] : continue ; continue [no LineTerminator here] LabelIdentifier [?Yield, ?Await] ;

14.8.1 静态语义:早期错误

ContinueStatement : continue ; continue LabelIdentifier ;

14.8.2 运行时语义:求值

ContinueStatement : continue ;
  1. 返回 完成记录 { [[Type]]: continue, [[Value]]: empty, [[Target]]: empty }.
ContinueStatement : continue LabelIdentifier ;
  1. label StringValue LabelIdentifier
  2. 返回 完成记录 { [[Type]]: continue, [[Value]]: empty, [[Target]]: label }.

14.9 break 语句

语法

BreakStatement [Yield, Await] : break ; break [no LineTerminator here] LabelIdentifier [?Yield, ?Await] ;

14.9.1 静态语义:早期错误

BreakStatement : break ;

14.9.2 运行时语义:求值

BreakStatement : break ;
  1. 返回 完成记录 { [[Type]]: break, [[Value]]: empty, [[Target]]: empty }.
BreakStatement : break LabelIdentifier ;
  1. label StringValue LabelIdentifier
  2. 返回 完成记录 { [[Type]]: break, [[Value]]: empty, [[Target]]: label }.

14.10 return 语句

语法

ReturnStatement [Yield, Await] : return ; return [no LineTerminator here] Expression [+In, ?Yield, ?Await] ; Note

return 语句会导致函数停止执行,并在大多数情况下返回一个值给调用者。如果省略了 Expression ,返回值为 undefined。否则,返回值是 Expression 的值。根据周围的上下文,return 语句可能实际上不会返回值给调用者。例如,在 try 块中,return 语句的 Completion Record 可能在执行 finally 块时被另一个 Completion Record 替换。

14.10.1 运行时语义:求值

ReturnStatement : return ;
  1. 返回 Completion Record { [[Type]]: return, [[Value]]: undefined, [[Target]]: empty }.
ReturnStatement : return Expression ;
  1. exprRef 为 ?  Evaluation Expression
  2. exprValue 为 ?  GetValue (exprRef)。
  3. 如果 GetGeneratorKind () 是 async,设置 exprValue 为 ?  Await (exprValue)。
  4. 返回 Completion Record { [[Type]]: return, [[Value]]: exprValue, [[Target]]: empty }.

14.11 with 语句

注 1

在新的 ECMAScript 代码中,不鼓励使用 Legacy with 语句。考虑使用在 严格模式代码 非严格模式代码 中都允许的替代方案,如 解构赋值

语法

WithStatement [Yield, Await, Return] : with ( Expression [+In, ?Yield, ?Await] ) Statement [?Yield, ?Await, ?Return] 注 2

with 语句为计算对象添加了一个 对象环境记录 到当前执行上下文的词法环境中。然后使用这个扩展的词法环境执行一个语句。最后,它恢复原始的词法环境。

14.11.1 静态语义:早期错误

WithStatement : with ( Expression ) Statement

仅在实现 B.3.1 中指定的扩展时,才需要应用第二条规则。

14.11.2 运行时语义:求值

WithStatement : with ( Expression ) Statement
  1. val 为 ?  Evaluation Expression
  2. obj 为 ?  ToObject (? GetValue (val))。
  3. oldEnv 为当前执行上下文的 词法环境
  4. newEnv NewObjectEnvironment (obj, true, oldEnv)。
  5. 将当前执行上下文的 词法环境 设置为 newEnv
  6. C Completion ( Evaluation Statement )。
  7. 将当前执行上下文的 词法环境 设置回 oldEnv
  8. 返回 ?  UpdateEmpty (C, undefined)。

无论以何种方式退出嵌入的 Statement ,无论是正常还是以某种形式的 中止完成 或异常,词法环境总是恢复到原来的状态。

14.12 switch 语句

语法

SwitchStatement [Yield, Await, Return] : switch ( Expression [+In, ?Yield, ?Await] ) CaseBlock [?Yield, ?Await, ?Return] CaseBlock [Yield, Await, Return] : { CaseClauses [?Yield, ?Await, ?Return] opt } { CaseClauses [?Yield, ?Await, ?Return] opt DefaultClause [?Yield, ?Await, ?Return] CaseClauses [?Yield, ?Await, ?Return] opt } CaseClauses [Yield, Await, Return] : CaseClause [?Yield, ?Await, ?Return] CaseClauses [?Yield, ?Await, ?Return] CaseClause [?Yield, ?Await, ?Return] CaseClause [Yield, Await, Return] : case Expression [+In, ?Yield, ?Await] : StatementList [?Yield, ?Return] opt DefaultClause [Yield, Await, Return] : default : StatementList [?Yield, ?Return] opt

14.12.1 静态语义:早期错误

SwitchStatement : switch ( Expression ) CaseBlock

14.12.2 运行时语义:CaseBlockEvaluation

语法定向操作 CaseBlockEvaluation 接受参数 input (一个 ECMAScript 语言值 ),并返回 正常完成包含的 ECMAScript 语言值 中止完成 。它在以下产生式上分段定义:

CaseBlock : { }
  1. 返回 undefined
CaseBlock : { CaseClauses }
  1. Vundefined
  2. A List 中的 CaseClause 项,按源文本顺序排列。
  3. foundfalse
  4. A 中的每个 CaseClause C,执行以下操作:
    1. 如果 foundfalse,则:
      1. found 为 ? CaseClauseIsSelected (C, input)。
    2. 如果 foundtrue,则:
      1. R Completion ( Evaluation (C))。
      2. 如果 R.[[Value]] 不是 empty,则将 V 设为 R.[[Value]]
      3. 如果 R 中止完成 ,则返回 ? UpdateEmpty (R, V)。
  5. 返回 V
CaseBlock : { CaseClauses opt DefaultClause CaseClauses opt }
  1. Vundefined
  2. 如果存在第一个 CaseClauses ,则:
    1. A List 中的 CaseClause 项,按源文本顺序排列。
  3. 否则:
    1. A 为一个新的空 List
  4. foundfalse
  5. A 中的每个 CaseClause C,执行以下操作:
    1. 如果 foundfalse,则:
      1. found 为 ? CaseClauseIsSelected (C, input)。
    2. 如果 foundtrue,则:
      1. R Completion ( Evaluation (C))。
      2. 如果 R.[[Value]] 不是 empty,则将 V 设为 R.[[Value]]
      3. 如果 R 中止完成 ,则返回 ? UpdateEmpty (R, V)。
  6. foundInBfalse
  7. 如果存在第二个 CaseClauses ,则:
    1. B List 中的 CaseClause 项,按源文本顺序排列。
  8. 否则:
    1. B 为一个新的空 List
  9. 如果 foundfalse,则:
    1. B 中的每个 CaseClause C,执行以下操作:
      1. 如果 foundInBfalse,则:
        1. foundInB 为 ? CaseClauseIsSelected (C, input)。
      2. 如果 foundInBtrue,则:
        1. R Completion ( Evaluation ( CaseClause C))。
        2. 如果 R.[[Value]] 不是 empty,则将 V 设为 R.[[Value]]
        3. 如果 R 中止完成 ,则返回 ? UpdateEmpty (R, V)。
  10. 如果 foundInBtrue,则返回 V
  11. defaultR Completion ( Evaluation ( DefaultClause ))。
  12. 如果 defaultR.[[Value]] 不是 empty,则将 V 设为 defaultR.[[Value]]
  13. 如果 defaultR 中止完成 ,则返回 ? UpdateEmpty (defaultR, V)。
  14. 注:以下是第二个 CaseClauses 的另一个完整迭代。
  15. B 中的每个 CaseClause C,执行以下操作:
    1. R Completion ( Evaluation ( CaseClause C))。
    2. 如果 R.[[Value]] 不是 empty,则将 V 设为 R.[[Value]]
    3. 如果 R 中止完成 ,则返回 ? UpdateEmpty (R, V)。
  16. 返回 V

14.12.3 CaseClauseIsSelected ( C, input )

抽象操作 CaseClauseIsSelected 接受参数 C(一个 CaseClause 解析节点 )和 input(一个 ECMAScript 语言值 ),并返回 正常完成包含的 布尔值或 中止完成 。它在调用时执行以下步骤:

  1. 断言 C CaseClause : case Expression : StatementList opt 的一个实例。
  2. exprRef 为 ? Evaluation C Expression
  3. clauseSelector 为 ? GetValue (exprRef)。
  4. 返回 IsStrictlyEqual (input, clauseSelector)。

此操作不执行 C StatementList (如果有)。 CaseBlock 算法使用其返回值来确定要开始执行的 StatementList

14.12.4 运行时语义:Evaluation

SwitchStatement : switch ( Expression ) CaseBlock
  1. exprRef 为 ? Evaluation ( Expression )。
  2. switchValue 为 ? GetValue (exprRef)。
  3. oldEnv 当前执行上下文 的 LexicalEnvironment。
  4. blockEnv NewDeclarativeEnvironment (oldEnv)。
  5. 执行 BlockDeclarationInstantiation ( CaseBlock , blockEnv)。
  6. 当前执行上下文 的 LexicalEnvironment 设置为 blockEnv
  7. R Completion ( CaseBlockEvaluation ( CaseBlock , switchValue))。
  8. 当前执行上下文 的 LexicalEnvironment 设置回 oldEnv
  9. 返回 R

无论控制如何离开 SwitchStatement ,LexicalEnvironment 总是恢复到其先前状态。

CaseClause : case Expression :
  1. 返回 empty
CaseClause : case Expression : StatementList
  1. 返回 ? Evaluation ( StatementList )。
DefaultClause : default :
  1. 返回 empty
DefaultClause : default : StatementList
  1. 返回 ? Evaluation ( StatementList )。

14.13 带标签的语句

语法

LabelledStatement [Yield, Await, Return] : LabelIdentifier [?Yield, ?Await] : LabelledItem [?Yield, ?Await, ?Return] LabelledItem [Yield, Await, Return] : Statement [?Yield, ?Await, ?Return] FunctionDeclaration [?Yield, ?Await, ~Default]

一个 Statement 可能被一个标签前缀。带标签的语句仅与带标签的breakcontinue语句结合使用。ECMAScript 没有goto语句。 一个 Statement 可以是 LabelledStatement 的一部分,而后者本身可以是 LabelledStatement 的一部分,依此类推。以这种方式引入的标签在描述单个语句的语义时统称为“当前标签集”。

14.13.1 静态语义:早期错误

LabelledItem : FunctionDeclaration
  • 如果此生成的源文本匹配任何源文本,则为语法错误。

如果实现了 B.3.1 中指定的扩展,则此规则的替代定义是必要的。

14.13.2 静态语义:IsLabelledFunction (stmt)

抽象操作 IsLabelledFunction 接受参数 stmt (一个 Statement 解析节点 ) 并返回一个布尔值。当调用时执行以下步骤:

  1. 如果 stmt 不是一个 LabelledStatement ,返回 false
  2. item 成为 stmt LabelledItem
  3. 如果 item LabelledItem : FunctionDeclaration ,返回 true
  4. subStmt 成为 item Statement
  5. 返回 IsLabelledFunction (subStmt)。

14.13.3 运行时语义:评估

LabelledStatement : LabelIdentifier : LabelledItem
  1. 返回 ?  LabelledEvaluation 的这个 LabelledStatement ,参数为 « »。

14.13.4 运行时语义:LabelledEvaluation

语法指向操作 LabelledEvaluation 接受参数 labelSet(一个 列表 字符串)并返回一个 正常完成包含 ECMAScript 语言值 或一个 突然完成 。它在以下生成中逐步定义:

BreakableStatement : IterationStatement
  1. stmtResult 成为 Completion ( LoopEvaluation IterationStatement ,参数为 labelSet)。
  2. 如果 stmtResult 是一个 break completion ,则
    1. 如果 stmtResult.[[Target]]empty,则
      1. 如果 stmtResult.[[Value]]empty,则将 stmtResult 设置为 NormalCompletion (undefined)。
      2. 否则,将 stmtResult 设置为 NormalCompletion (stmtResult.[[Value]])。
  3. 返回 ? stmtResult
BreakableStatement : SwitchStatement
  1. stmtResult 成为 Completion ( Evaluation SwitchStatement )。
  2. 如果 stmtResult 是一个 break completion ,则
    1. 如果 stmtResult.[[Target]]empty,则
      1. 如果 stmtResult.[[Value]]empty,则将 stmtResult 设置为 NormalCompletion (undefined)。
      2. 否则,将 stmtResult 设置为 NormalCompletion (stmtResult.[[Value]])。
  3. 返回 ? stmtResult
注 1

一个 BreakableStatement 是可以通过无标签的 BreakStatement 退出的语句。

LabelledStatement : LabelIdentifier : LabelledItem
  1. label 成为 StringValue LabelIdentifier
  2. newLabelSet 成为 列表连接 labelSet 和 « label »。
  3. stmtResult 成为 Completion ( LabelledEvaluation LabelledItem ,参数为 newLabelSet)。
  4. 如果 stmtResult 是一个 break completion 并且 stmtResult.[[Target]]label,则
    1. stmtResult 设置为 NormalCompletion (stmtResult.[[Value]])。
  5. 返回 ? stmtResult
LabelledItem : FunctionDeclaration
  1. 返回 ?  Evaluation FunctionDeclaration
Statement : BlockStatement VariableStatement EmptyStatement ExpressionStatement IfStatement ContinueStatement BreakStatement ReturnStatement WithStatement ThrowStatement TryStatement DebuggerStatement
  1. 返回 ?  Evaluation Statement
注 2

Statement 的唯一两个在 LabelledEvaluation 中具有特殊语义的生成是 BreakableStatement LabelledStatement

14.14 throw 语句

语法

ThrowStatement [Yield, Await] : throw [此处不能有 行终止符 ] 表达式 [+In, ?Yield, ?Await] ;

14.14.1 运行时语义:求值

ThrowStatement : throw 表达式 ;
  1. exprRef 为 ?  Evaluation 表达式
  2. exprValue 为 ?  GetValue (exprRef)。
  3. 返回 ThrowCompletion (exprValue)。

14.15 try 语句

语法

TryStatement [Yield, Await, Return] : try Block [?Yield, ?Await, ?Return] Catch [?Yield, ?Await, ?Return] try Block [?Yield, ?Await, ?Return] Finally [?Yield, ?Await, ?Return] try Block [?Yield, ?Await, ?Return] Catch [?Yield, ?Await, ?Return] Finally [?Yield, ?Await, ?Return] Catch [Yield, Await, Return] : catch ( CatchParameter [?Yield, ?Await] ) Block [?Yield, ?Await, ?Return] catch Block [?Yield, ?Await, ?Return] Finally [Yield, Await, Return] : finally Block [?Yield, ?Await, ?Return] CatchParameter [Yield, Await] : BindingIdentifier [?Yield, ?Await] BindingPattern [?Yield, ?Await]

try 语句包含可能发生异常的代码块,如运行时错误或 throw 语句。catch 子句提供异常处理代码。当 catch 子句捕获异常时,其 CatchParameter 绑定到该异常。

14.15.1 静态语义:早期错误

Catch : catch ( CatchParameter ) Block

对于此生成规则的替代静态语义定义,见 B.3.4

14.15.2 运行时语义:CatchClauseEvaluation

CatchClauseEvaluation 是一个带有参数 thrownValue(一个 ECMAScript 语言值)的语法直接操作,返回一个包含 ECMAScript 语言值的正常完成记录或一个中断完成记录。它在以下生成规则中定义:

Catch : catch ( CatchParameter ) Block
  1. oldEnv 为当前执行上下文的 LexicalEnvironment。
  2. catchEnv NewDeclarativeEnvironment (oldEnv)。
  3. 对于 BoundNames CatchParameter 中的每个元素 argName,执行
    1. 执行 ! catchEnv.CreateMutableBinding(argName, false)。
  4. 将当前执行上下文的 LexicalEnvironment 设置为 catchEnv
  5. status Completion ( BindingInitialization CatchParameter ,参数为 thrownValuecatchEnv)。
  6. 如果 status 是一个中断完成,则
    1. 将当前执行上下文的 LexicalEnvironment 设置为 oldEnv
    2. 返回 ? status
  7. B Completion ( Evaluation Block )。
  8. 将当前执行上下文的 LexicalEnvironment 设置为 oldEnv
  9. 返回 ? B
Catch : catch Block
  1. 返回 ?  Evaluation Block

无论控制如何离开 Block ,LexicalEnvironment 总是恢复到原来的状态。

14.15.3 运行时语义:Evaluation

TryStatement : try Block Catch
  1. B Completion ( Evaluation Block )。
  2. 如果 B 是一个 throw completion ,令 C Completion ( CatchClauseEvaluation Catch ,参数为 B.[[Value]])。
  3. 否则,令 CB
  4. 返回 ?  UpdateEmpty (C, undefined)。
TryStatement : try Block Finally
  1. B Completion ( Evaluation Block )。
  2. F Completion ( Evaluation Finally )。
  3. 如果 F 是一个 normal completion ,则将 F 设置为 B
  4. 返回 ?  UpdateEmpty (F, undefined)。
TryStatement : try Block Catch Finally
  1. B Completion ( Evaluation Block )。
  2. 如果 B 是一个 throw completion ,令 C Completion ( CatchClauseEvaluation Catch ,参数为 B.[[Value]])。
  3. 否则,令 CB
  4. F Completion ( Evaluation Finally )。
  5. 如果 F 是一个 normal completion ,则将 F 设置为 C
  6. 返回 ?  UpdateEmpty (F, undefined)。

14.16 debugger 语句

句法

DebuggerStatement : debugger ;

14.16.1 运行时语义:Evaluation

执行 DebuggerStatement 时,在调试器下运行时可能会触发断点。如果调试器不存在或未激活,此语句不会产生可观察到的效果。

DebuggerStatement : debugger ;
  1. 如果一个 实现定义 的调试设施可用且已启用,则
    1. 执行一个 实现定义 的调试动作。
    2. 返回一个新的 实现定义 Completion Record
  2. 否则,
    1. 返回 empty

15 ECMAScript 语言:函数和类

各种 ECMAScript 语言元素会导致创建 ECMAScript 函数对象 ( 10.2 )。此类函数的 Evaluation 从执行其 [[Call]] 内部方法开始 ( 10.2.1 )。

15.1 参数列表

语法

UniqueFormalParameters[Yield, Await] : FormalParameters[?Yield, ?Await] FormalParameters[Yield, Await] : [empty] FunctionRestParameter[?Yield, ?Await] FormalParameterList[?Yield, ?Await] FormalParameterList[?Yield, ?Await] , FormalParameterList[?Yield, ?Await] , FunctionRestParameter[?Yield, ?Await] FormalParameterList[Yield, Await] : FormalParameter[?Yield, ?Await] FormalParameterList[?Yield, ?Await] , FormalParameter[?Yield, ?Await] FunctionRestParameter[Yield, Await] : BindingRestElement[?Yield, ?Await] FormalParameter[Yield, Await] : BindingElement[?Yield, ?Await]

15.1.1 静态语义:早期错误

UniqueFormalParameters : FormalParameters FormalParameters : FormalParameterList

FormalParameterList 中的同一 BindingIdentifier 的多次出现仅适用于具有简单参数列表且未在 严格模式代码 中定义的函数。

15.1.2 静态语义:ContainsExpression

语法导向操作 ContainsExpression 不接受参数并返回一个布尔值。它分段定义在以下产生式上:

ObjectBindingPattern : { } { BindingRestProperty }
  1. 返回 false
ObjectBindingPattern : { BindingPropertyList , BindingRestProperty }
  1. 返回 ContainsExpressionBindingPropertyList
ArrayBindingPattern : [ Elisionopt ]
  1. 返回 false
ArrayBindingPattern : [ Elisionopt BindingRestElement ]
  1. 返回 ContainsExpressionBindingRestElement
ArrayBindingPattern : [ BindingElementList , Elisionopt ]
  1. 返回 ContainsExpressionBindingElementList
ArrayBindingPattern : [ BindingElementList , Elisionopt BindingRestElement ]
  1. hasContainsExpressionBindingElementList
  2. 如果 hastrue,则返回 true
  3. 返回 ContainsExpressionBindingRestElement
BindingPropertyList : BindingPropertyList , BindingProperty
  1. hasContainsExpressionBindingPropertyList
  2. 如果 hastrue,则返回 true
  3. 返回 ContainsExpressionBindingProperty
BindingElementList : BindingElementList , BindingElisionElement
  1. hasContainsExpressionBindingElementList
  2. 如果 hastrue,则返回 true
  3. 返回 ContainsExpressionBindingElisionElement
BindingElisionElement : Elisionopt BindingElement
  1. 返回 ContainsExpressionBindingElement
BindingProperty : PropertyName : BindingElement
  1. hasIsComputedPropertyKeyPropertyName
  2. 如果 hastrue,则返回 true
  3. 返回 ContainsExpressionBindingElement
BindingElement : BindingPattern Initializer
  1. 返回 true
SingleNameBinding : BindingIdentifier
  1. 返回 false
SingleNameBinding : BindingIdentifier Initializer
  1. 返回 true
BindingRestElement : ... BindingIdentifier
  1. 返回 false
BindingRestElement : ... BindingPattern
  1. 返回 ContainsExpressionBindingPattern
FormalParameters : [empty]
  1. 返回 false
FormalParameters : FormalParameterList , FunctionRestParameter
  1. 如果 ContainsExpressionFormalParameterListtrue,则返回 true
  2. 返回 ContainsExpressionFunctionRestParameter
FormalParameterList : FormalParameterList , FormalParameter
  1. 如果 ContainsExpressionFormalParameterListtrue,则返回 true
  2. 返回 ContainsExpressionFormalParameter
ArrowParameters : BindingIdentifier
  1. 返回 false
ArrowParameters : CoverParenthesizedExpressionAndArrowParameterList
  1. formalsArrowFormalParameters,它被 涵盖CoverParenthesizedExpressionAndArrowParameterList
  2. 返回 ContainsExpressionformals
AsyncArrowBindingIdentifier : BindingIdentifier
  1. 返回 false

15.1.3 静态语义:IsSimpleParameterList

语法导向操作 IsSimpleParameterList 不接受参数并返回一个布尔值。它分段定义在以下产生式上:

BindingElement : BindingPattern
  1. 返回 false
BindingElement : BindingPattern Initializer
  1. 返回 false
SingleNameBinding : BindingIdentifier
  1. 返回 true
SingleNameBinding : BindingIdentifier Initializer
  1. 返回 false
FormalParameters : [empty]
  1. 返回 true
FormalParameters : FunctionRestParameter
  1. 返回 false
FormalParameters : FormalParameterList , FunctionRestParameter
  1. 返回 false
FormalParameterList : FormalParameterList , FormalParameter
  1. 如果 IsSimpleParameterListFormalParameterListfalse,则返回 false
  2. 返回 IsSimpleParameterListFormalParameter
FormalParameter : BindingElement
  1. 返回 IsSimpleParameterListBindingElement
ArrowParameters : BindingIdentifier
  1. 返回 true
ArrowParameters : CoverParenthesizedExpressionAndArrowParameterList
  1. formalsArrowFormalParameters,它被 涵盖CoverParenthesizedExpressionAndArrowParameterList
  2. 返回 IsSimpleParameterListformals
AsyncArrowBindingIdentifier : BindingIdentifier
  1. 返回 true
CoverCallExpressionAndAsyncArrowHead : MemberExpression Arguments
  1. headAsyncArrowHead,它被 涵盖CoverCallExpressionAndAsyncArrowHead
  2. 返回 IsSimpleParameterListhead

15.1.4 静态语义:HasInitializer

语法导向操作 HasInitializer 不接受参数并返回一个布尔值。它分段定义在以下产生式上:

BindingElement : BindingPattern
  1. 返回 false
BindingElement : BindingPattern Initializer
  1. 返回 true
SingleNameBinding : BindingIdentifier
  1. 返回 false
SingleNameBinding : BindingIdentifier Initializer
  1. 返回 true
FormalParameterList : FormalParameterList , FormalParameter
  1. 如果 HasInitializerFormalParameterListtrue,则返回 true
  2. 返回 HasInitializerFormalParameter

15.1.5 静态语义:ExpectedArgumentCount

语法导向操作 ExpectedArgumentCount 不接受参数并返回一个 整数。它分段定义在以下产生式上:

FormalParameters : [empty] FunctionRestParameter
  1. 返回 0。
FormalParameters : FormalParameterList , FunctionRestParameter
  1. 返回 ExpectedArgumentCountFormalParameterList

FormalParameterList 的 ExpectedArgumentCount 是 FormalParameters 中在 rest 参数或第一个带初始化器的 FormalParameter 左边的参数数量。 FormalParameter 没有初始化器允许在第一个带初始化器的参数之后,但这些参数被认为是可选的,并且其默认值为 undefined

FormalParameterList : FormalParameter
  1. 如果 HasInitializerFormalParametertrue,返回 0。
  2. 返回 1。
FormalParameterList : FormalParameterList , FormalParameter
  1. countExpectedArgumentCountFormalParameterList
  2. 如果 HasInitializerFormalParameterListtrue 或者 HasInitializerFormalParametertrue,则返回 count
  3. 返回 count + 1。
ArrowParameters : BindingIdentifier
  1. 返回 1。
ArrowParameters : CoverParenthesizedExpressionAndArrowParameterList
  1. formalsArrowFormalParameters,它被 涵盖CoverParenthesizedExpressionAndArrowParameterList
  2. 返回 ExpectedArgumentCountformals
PropertySetParameterList : FormalParameter
  1. 如果 HasInitializerFormalParametertrue,返回 0。
  2. 返回 1。
AsyncArrowBindingIdentifier : BindingIdentifier
  1. 返回 1。

15.2 函数定义

语法

FunctionDeclaration [Yield, Await, Default] : function BindingIdentifier [?Yield, ?Await] ( FormalParameters [~Yield, ~Await] ) { FunctionBody [~Yield, ~Await] } [+Default] function ( FormalParameters [~Yield, ~Await] ) { FunctionBody [~Yield, ~Await] } FunctionExpression : function BindingIdentifier [~Yield, ~Await] opt ( FormalParameters [~Yield, ~Await] ) { FunctionBody [~Yield, ~Await] } FunctionBody [Yield, Await] : FunctionStatementList [?Yield, ?Await] FunctionStatementList [Yield, Await] : StatementList [?Yield, ?Await, +Return] opt

15.2.1 静态语义:早期错误

FunctionDeclaration : function BindingIdentifier ( FormalParameters ) { FunctionBody } function ( FormalParameters ) { FunctionBody } FunctionExpression : function BindingIdentifier opt ( FormalParameters ) { FunctionBody }

LexicallyDeclaredNames 不包括使用 var 或函数声明绑定的标识符。

FunctionBody : FunctionStatementList

15.2.2 静态语义:FunctionBodyContainsUseStrict

syntax-directed operation FunctionBodyContainsUseStrict 不接受参数并返回一个布尔值。其定义如下:

FunctionBody : FunctionStatementList
  1. 如果 Directive Prologue FunctionBody 包含 Use Strict Directive ,则返回 true;否则,返回 false

15.2.3 运行时语义:EvaluateFunctionBody

syntax-directed operation EvaluateFunctionBody 接受参数 functionObject(一个 ECMAScript function object )和 argumentsList(一个 List )并返回一个 normal completion containing 一个 ECMAScript language value 或一个 abrupt completion 。其定义如下:

FunctionBody : FunctionStatementList
  1. 执行 ?  FunctionDeclarationInstantiation (functionObject, argumentsList)。
  2. 返回 ?  Evaluation FunctionStatementList

15.2.4 运行时语义:InstantiateOrdinaryFunctionObject

syntax-directed operation InstantiateOrdinaryFunctionObject 接受参数 env(一个 Environment Record )和 privateEnv(一个 PrivateEnvironment Record null)并返回一个 ECMAScript function object 。其定义如下:

FunctionDeclaration : function BindingIdentifier ( FormalParameters ) { FunctionBody }
  1. name StringValue BindingIdentifier
  2. sourceText source text matched by FunctionDeclaration
  3. F OrdinaryFunctionCreate ( %Function.prototype% sourceText FormalParameters FunctionBody non-lexical-thisenvprivateEnv)。
  4. 执行 SetFunctionName (Fname)。
  5. 执行 MakeConstructor (F)。
  6. 返回 F
FunctionDeclaration : function ( FormalParameters ) { FunctionBody }
  1. sourceText source text matched by FunctionDeclaration
  2. F OrdinaryFunctionCreate ( %Function.prototype% sourceText FormalParameters FunctionBody non-lexical-thisenvprivateEnv)。
  3. 执行 SetFunctionName (F"default")。
  4. 执行 MakeConstructor (F)。
  5. 返回 F

匿名的 FunctionDeclaration 只能作为 export default 声明的一部分出现,因此其函数代码始终是 strict mode code

15.2.5 运行时语义:InstantiateOrdinaryFunctionExpression

syntax-directed operation InstantiateOrdinaryFunctionExpression 接受可选参数 name(一个 property key 或一个 Private Name )并返回一个 ECMAScript function object 。其定义如下:

FunctionExpression : function ( FormalParameters ) { FunctionBody }
  1. 如果 name 不存在,则将 name 设置为空字符串。
  2. env 为当前执行上下文的词法环境。
  3. privateEnv 为当前执行上下文的私有环境。
  4. sourceText source text matched by FunctionExpression
  5. closure OrdinaryFunctionCreate ( %Function.prototype% sourceText FormalParameters FunctionBody non-lexical-thisenvprivateEnv)。
  6. 执行 SetFunctionName (closurename)。
  7. 执行 MakeConstructor (closure)。
  8. 返回 closure
FunctionExpression : function BindingIdentifier ( FormalParameters ) { FunctionBody }
  1. 断言 name 不存在。
  2. 设置 name StringValue BindingIdentifier
  3. outerEnv 为当前执行上下文的词法环境。
  4. funcEnv NewDeclarativeEnvironment (outerEnv)。
  5. 执行 ! funcEnv.CreateImmutableBinding(name, false)。
  6. privateEnv 为当前执行上下文的私有环境。
  7. sourceText source text matched by FunctionExpression
  8. closure OrdinaryFunctionCreate ( %Function.prototype% sourceText FormalParameters FunctionBody non-lexical-thisfuncEnvprivateEnv)。
  9. 执行 SetFunctionName (closurename)。
  10. 执行 MakeConstructor (closure)。
  11. 执行 ! funcEnv.InitializeBinding(name, closure)。
  12. 返回 closure

BindingIdentifier 可以在 FunctionExpression FunctionBody 内部被引用,以允许函数递归调用自身。然而,与 FunctionDeclaration 不同, BindingIdentifier 不能从函数表达式的外部引用,也不会影响包围 FunctionExpression 的范围。

15.2.6 运行时语义:Evaluation

FunctionDeclaration : function BindingIdentifier ( FormalParameters ) { FunctionBody }
  1. 返回 empty
注 1

替代语义见 B.3.2

FunctionDeclaration : function ( FormalParameters ) { FunctionBody }
  1. 返回 empty
FunctionExpression : function BindingIdentifier opt ( FormalParameters ) { FunctionBody }
  1. 返回 InstantiateOrdinaryFunctionExpression FunctionExpression
注 2

使用 FunctionDeclaration FunctionExpression 定义的每个函数会自动创建一个 "prototype" 属性,以便函数可以作为 constructor 使用。

FunctionStatementList : [empty]
  1. 返回 undefined

15.3 箭头函数定义

语法

ArrowFunction [In, Yield, Await] : ArrowParameters [?Yield, ?Await] [no LineTerminator here] => ConciseBody [?In] ArrowParameters [Yield, Await] : BindingIdentifier [?Yield, ?Await] CoverParenthesizedExpressionAndArrowParameterList [?Yield, ?Await] ConciseBody [In] : [lookahead ≠ {] ExpressionBody [?In, ~Await] { FunctionBody [~Yield, ~Await] } ExpressionBody [In, Await] : AssignmentExpression [?In, ~Yield, ?Await]

补充语法

处理生产式的实例时
ArrowParameters [Yield, Await] : CoverParenthesizedExpressionAndArrowParameterList [?Yield, ?Await]
CoverParenthesizedExpressionAndArrowParameterList 的解释使用以下语法进行细化:

ArrowFormalParameters [Yield, Await] : ( UniqueFormalParameters [?Yield, ?Await] )

15.3.1 静态语义:早期错误

ArrowFunction : ArrowParameters => ConciseBody ArrowParameters : CoverParenthesizedExpressionAndArrowParameterList

15.3.2 静态语义:ConciseBodyContainsUseStrict

syntax-directed operation ConciseBodyContainsUseStrict 不接受参数并返回一个布尔值。其定义如下:

ConciseBody : ExpressionBody
  1. 返回 false
ConciseBody : { FunctionBody }
  1. 返回 FunctionBodyContainsUseStrict FunctionBody

15.3.3 运行时语义:EvaluateConciseBody

syntax-directed operation EvaluateConciseBody 接受参数 functionObject(一个 ECMAScript 函数对象 )和 argumentsList(一个 列表 ,包含 ECMAScript 语言值 )并返回一个 完成记录 ,其中包含一个 ECMAScript 语言值 或一个 异常完成 。其定义如下:

ConciseBody : ExpressionBody
  1. 执行 ?  FunctionDeclarationInstantiation (functionObjectargumentsList)。
  2. 返回 ?  Evaluation ExpressionBody

15.3.4 运行时语义:InstantiateArrowFunctionExpression

syntax-directed operation InstantiateArrowFunctionExpression 接受可选参数 name(一个 属性键 或一个 私有名称 )并返回一个 ECMAScript 函数对象 。其定义如下:

ArrowFunction : ArrowParameters => ConciseBody
  1. 如果 name 不存在,将 name 设置为 ""
  2. env 为当前执行上下文的词法环境。
  3. privateEnv 为当前执行上下文的私有环境。
  4. sourceText source text matched by ArrowFunction
  5. closure OrdinaryFunctionCreate ( %Function.prototype% sourceText ArrowParameters ConciseBody lexical-thisenvprivateEnv)。
  6. 执行 SetFunctionName (closurename)。
  7. 返回 closure

ArrowFunction 不定义 argumentssuperthisnew.target 的本地绑定。在 ArrowFunction 内对 argumentssuperthisnew.target 的任何引用必须解析为词法上封闭的环境中的绑定。通常,这将是紧密封闭函数的函数环境。即使 ArrowFunction 可能包含对 super 的引用,在步骤 5 中创建的 函数对象 不会通过执行 MakeMethod 变成一个方法。一个引用 super ArrowFunction 总是包含在一个非 ArrowFunction 中,实现 super 所需的状态可以通过 函数对象 所捕获的 env 访问 ArrowFunction

15.3.5 运行时语义:Evaluation

ArrowFunction : ArrowParameters => ConciseBody
  1. 返回 InstantiateArrowFunctionExpression ArrowFunction
ExpressionBody : AssignmentExpression
  1. exprRef 为 ?  Evaluation AssignmentExpression
  2. exprValue 为 ?  GetValue (exprRef)。
  3. 返回 Completion Record { [[Type]]: return[[Value]]exprValue[[Target]]empty }。

15.4 方法定义

语法

MethodDefinition [Yield, Await] : ClassElementName [?Yield, ?Await] ( UniqueFormalParameters [~Yield, ~Await] ) { FunctionBody [~Yield, ~Await] } GeneratorMethod [?Yield, ?Await] AsyncMethod [?Yield, ?Await] AsyncGeneratorMethod [?Yield, ?Await] get ClassElementName [?Yield, ?Await] ( ) { FunctionBody [~Yield, ~Await] } set ClassElementName [?Yield, ?Await] ( PropertySetParameterList ) { FunctionBody [~Yield, ~Await] } PropertySetParameterList : FormalParameter [~Yield, ~Await]

15.4.1 静态语义:早期错误

MethodDefinition : ClassElementName ( UniqueFormalParameters ) { FunctionBody } MethodDefinition : set ClassElementName ( PropertySetParameterList ) { FunctionBody }

15.4.2 静态语义:HasDirectSuper

语法指向操作 HasDirectSuper 不接受任何参数并返回一个布尔值。它在以下生成式上逐段定义:

MethodDefinition : ClassElementName ( UniqueFormalParameters ) { FunctionBody }
  1. 如果 UniqueFormalParameters 包含 SuperCall true,则返回 true
  2. 返回 FunctionBody 包含 SuperCall
MethodDefinition : get ClassElementName ( ) { FunctionBody }
  1. 返回 FunctionBody 包含 SuperCall
MethodDefinition : set ClassElementName ( PropertySetParameterList ) { FunctionBody }
  1. 如果 PropertySetParameterList 包含 SuperCall true,则返回 true
  2. 返回 FunctionBody 包含 SuperCall
GeneratorMethod : * ClassElementName ( UniqueFormalParameters ) { GeneratorBody }
  1. 如果 UniqueFormalParameters 包含 SuperCall true,则返回 true
  2. 返回 GeneratorBody 包含 SuperCall
AsyncGeneratorMethod : async * ClassElementName ( UniqueFormalParameters ) { AsyncGeneratorBody }
  1. 如果 UniqueFormalParameters 包含 SuperCall true,则返回 true
  2. 返回 AsyncGeneratorBody 包含 SuperCall
AsyncMethod : async ClassElementName ( UniqueFormalParameters ) { AsyncFunctionBody }
  1. 如果 UniqueFormalParameters 包含 SuperCall true,则返回 true
  2. 返回 AsyncFunctionBody 包含 SuperCall

15.4.3 静态语义:SpecialMethod

语法指向操作 SpecialMethod 不接受任何参数并返回一个布尔值。它在以下生成式上逐段定义:

MethodDefinition : ClassElementName ( UniqueFormalParameters ) { FunctionBody }
  1. 返回 false
MethodDefinition : GeneratorMethod AsyncMethod AsyncGeneratorMethod get ClassElementName ( ) { FunctionBody } set ClassElementName ( PropertySetParameterList ) { FunctionBody }
  1. 返回 true

15.4.4 运行时语义:DefineMethod

语法指向操作 DefineMethod 接受参数 object(一个对象)和可选参数 functionPrototype(一个对象),并返回一个包含字段 [[Key]](一个属性键)和 [[Closure]](一个 ECMAScript 函数对象)的 Record 的正常完成,或一个中断完成。它在以下生成式上逐段定义:

MethodDefinition : ClassElementName ( UniqueFormalParameters ) { FunctionBody }
  1. 令 propKey 为 ?  Evaluation ClassElementName 的结果。
  2. 令 env 为 当前执行上下文 的 LexicalEnvironment。
  3. 令 privateEnv 为 当前执行上下文 的 PrivateEnvironment。
  4. 如果 functionPrototype 存在,则:
    1. 令 prototype 为 functionPrototype。
  5. 否则:
    1. 令 prototype 为 %Function.prototype%
  6. 令 sourceText 为 MethodDefinition 匹配的源文本。
  7. 令 closure 为 OrdinaryFunctionCreate (prototype, sourceText, UniqueFormalParameters , FunctionBody , non-lexical-this, env, privateEnv)。
  8. 执行 MakeMethod (closure, object)。
  9. 返回 { [[Key]]: propKey, [[Closure]]: closure } 的 Record。

15.4.5 运行时语义:MethodDefinitionEvaluation

语法指向操作 MethodDefinitionEvaluation 接受参数 object(一个对象)和 enumerable(一个布尔值),并返回包含一个 PrivateElement 或 unused 的正常完成,或一个中断完成。它在以下生成式上逐段定义:

MethodDefinition : ClassElementName ( UniqueFormalParameters ) { FunctionBody }
  1. 令 methodDef 为 ?  DefineMethod 的结果。
  2. 执行 SetFunctionName (methodDef.[[Closure]], methodDef.[[Key]])。
  3. 返回 ?  DefineMethodProperty (object, methodDef.[[Key]], methodDef.[[Closure]], enumerable)。
MethodDefinition : get ClassElementName ( ) { FunctionBody }
  1. 令 propKey 为 ?  Evaluation ClassElementName 的结果。
  2. 令 env 为 当前执行上下文 的 LexicalEnvironment。
  3. 令 privateEnv 为 当前执行上下文 的 PrivateEnvironment。
  4. 令 sourceText 为 MethodDefinition 匹配的源文本。
  5. 令 formalParameterList 为生产式 FormalParameters : [empty] 的实例。
  6. 令 closure 为 OrdinaryFunctionCreate ( %Function.prototype% , sourceText, formalParameterList, FunctionBody , non-lexical-this, env, privateEnv)。
  7. 执行 MakeMethod (closure, object)。
  8. 执行 SetFunctionName (closure, propKey, "get")。
  9. 如果 propKey 是一个 私有名称 ,则:
    1. 返回 { [[Key]]: propKey, [[Kind]]: accessor, [[Get]]: closure, [[Set]]: undefined } 的 PrivateElement。
  10. 否则:
    1. 令 desc 为 PropertyDescriptor { [[Get]]: closure, [[Enumerable]]: enumerable, [[Configurable]]: true }。
    2. 执行 ?  DefinePropertyOrThrow (object, propKey, desc)。
    3. 返回 unused。
MethodDefinition : set ClassElementName ( PropertySetParameterList ) { FunctionBody }
  1. 令 propKey 为 ?  Evaluation ClassElementName 的结果。
  2. 令 env 为 当前执行上下文 的 LexicalEnvironment。
  3. 令 privateEnv 为 当前执行上下文 的 PrivateEnvironment。
  4. 令 sourceText 为 MethodDefinition 匹配的源文本。
  5. 令 closure 为 OrdinaryFunctionCreate ( %Function.prototype% , sourceText, PropertySetParameterList , FunctionBody , non-lexical-this, env, privateEnv)。
  6. 执行 MakeMethod (closure, object)。
  7. 执行 SetFunctionName (closure, propKey, "set")。
  8. 如果 propKey 是一个 私有名称 ,则:
    1. 返回 { [[Key]]: propKey, [[Kind]]: accessor, [[Get]]: undefined, [[Set]]: closure } 的 PrivateElement。
  9. 否则:
    1. 令 desc 为 PropertyDescriptor { [[Set]]: closure, [[Enumerable]]: enumerable, [[Configurable]]: true }。
    2. 执行 ?  DefinePropertyOrThrow (object, propKey, desc)。
    3. 返回 unused。
GeneratorMethod : * ClassElementName ( UniqueFormalParameters ) { GeneratorBody }
  1. 令 propKey 为 ?  Evaluation ClassElementName 的结果。
  2. 令 env 为 当前执行上下文 的 LexicalEnvironment。
  3. 令 privateEnv 为 当前执行上下文 的 PrivateEnvironment。
  4. 令 sourceText 为 GeneratorMethod 匹配的源文本。
  5. 令 closure 为 OrdinaryFunctionCreate ( %GeneratorFunction.prototype% , sourceText, UniqueFormalParameters , GeneratorBody , non-lexical-this, env, privateEnv)。
  6. 执行 MakeMethod (closure, object)。
  7. 执行 SetFunctionName (closure, propKey)。
  8. 令 prototype 为 OrdinaryObjectCreate ( %GeneratorFunction.prototype.prototype% )。
  9. 执行 !  DefinePropertyOrThrow (closure, "prototype", PropertyDescriptor { [[Value]]: prototype, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false })。
  10. 返回 ?  DefineMethodProperty (object, propKey, closure, enumerable)。
AsyncGeneratorMethod : async * ClassElementName ( UniqueFormalParameters ) { AsyncGeneratorBody }
  1. 令 propKey 为 ?  Evaluation ClassElementName 的结果。
  2. 令 env 为 当前执行上下文 的 LexicalEnvironment。
  3. 令 privateEnv 为 当前执行上下文 的 PrivateEnvironment。
  4. 令 sourceText 为 AsyncGeneratorMethod 匹配的源文本。
  5. 令 closure 为 OrdinaryFunctionCreate ( %AsyncGeneratorFunction.prototype% , sourceText, UniqueFormalParameters , AsyncGeneratorBody , non-lexical-this, env, privateEnv)。
  6. 执行 MakeMethod (closure, object)。
  7. 执行 SetFunctionName (closure, propKey)。
  8. 令 prototype 为 OrdinaryObjectCreate ( %AsyncGeneratorFunction.prototype.prototype% )。
  9. 执行 !  DefinePropertyOrThrow (closure, "prototype", PropertyDescriptor { [[Value]]: prototype, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false })。
  10. 返回 ?  DefineMethodProperty (object, propKey, closure, enumerable)。
AsyncMethod : async ClassElementName ( UniqueFormalParameters ) { AsyncFunctionBody }
  1. 令 propKey 为 ?  Evaluation ClassElementName 的结果。
  2. 令 env 为 当前执行上下文 的 LexicalEnvironment。
  3. 令 privateEnv 为 当前执行上下文 的 PrivateEnvironment。
  4. 令 sourceText 为 AsyncMethod 匹配的源文本。
  5. 令 closure 为 OrdinaryFunctionCreate ( %AsyncFunction.prototype% , sourceText, UniqueFormalParameters , AsyncFunctionBody , non-lexical-this, env, privateEnv)。
  6. 执行 MakeMethod (closure, object)。
  7. 执行 SetFunctionName (closure, propKey)。
  8. 返回 ?  DefineMethodProperty (object, propKey, closure, enumerable)。

15.5 生成器函数定义

语法

GeneratorDeclaration[Yield, Await, Default] : function * BindingIdentifier[?Yield, ?Await] ( FormalParameters[+Yield, ~Await] ) { GeneratorBody } [+Default] function * ( FormalParameters[+Yield, ~Await] ) { GeneratorBody } GeneratorExpression : function * BindingIdentifier[+Yield, ~Await]opt ( FormalParameters[+Yield, ~Await] ) { GeneratorBody } GeneratorMethod[Yield, Await] : * ClassElementName[?Yield, ?Await] ( UniqueFormalParameters[+Yield, ~Await] ) { GeneratorBody } GeneratorBody : FunctionBody[+Yield, ~Await] YieldExpression[In, Await] : yield yield [no LineTerminator here] AssignmentExpression[?In, +Yield, ?Await] yield [no LineTerminator here] * AssignmentExpression[?In, +Yield, ?Await] 注 1

紧接在 yield 之后的语法上下文要求使用 InputElementRegExpOrTemplateTail 词法目标。

注 2

YieldExpression 不能在生成器函数的 FormalParameters 中使用,因为 FormalParameters 中的任何表达式都在生成器处于可恢复状态之前被评估。

注 3

与生成器相关的 抽象操作 定义在 27.5.3 中。

15.5.1 静态语义:早期错误

GeneratorMethod : * ClassElementName ( UniqueFormalParameters ) { GeneratorBody } GeneratorDeclaration : function * BindingIdentifier ( FormalParameters ) { GeneratorBody } function * ( FormalParameters ) { GeneratorBody } GeneratorExpression : function * BindingIdentifieropt ( FormalParameters ) { GeneratorBody }

15.5.2 运行时语义:EvaluateGeneratorBody

语法导向操作 EvaluateGeneratorBody 接受两个参数:functionObject(一个 ECMAScript 函数对象)和 argumentsList(一个 列表,包含 ECMAScript 语言值), 并返回一个 抛出完成记录 或一个 返回完成记录。 它的定义分为以下几个步骤:

GeneratorBody : FunctionBody
  1. 执行 ? FunctionDeclarationInstantiation(functionObject, argumentsList)。
  2. G 为 ? OrdinaryCreateFromConstructor(functionObject, "%GeneratorFunction.prototype.prototype%",« [[GeneratorState]], [[GeneratorContext]], [[GeneratorBrand]] »)。
  3. G.[[GeneratorBrand]] 设置为 empty
  4. 执行 GeneratorStart(G, FunctionBody)。
  5. 返回 完成记录 { [[Type]]: return, [[Value]]: G, [[Target]]: empty }。

15.5.3 运行时语义:InstantiateGeneratorFunctionObject

语法导向操作 InstantiateGeneratorFunctionObject 接受两个参数:env(一个 环境记录)和 privateEnv(一个 私有环境记录null), 并返回一个 ECMAScript 函数对象。它的定义分为以下几个步骤:

GeneratorDeclaration : function * BindingIdentifier ( FormalParameters ) { GeneratorBody }
  1. nameStringValueBindingIdentifier
  2. sourceText 为与 GeneratorDeclaration 匹配的 GeneratorDeclaration 的源文本。
  3. FOrdinaryFunctionCreate(%GeneratorFunction.prototype%, sourceTextFormalParametersGeneratorBodynon-lexical-thisenvprivateEnv)。
  4. 执行 SetFunctionName(Fname)。
  5. prototypeOrdinaryObjectCreate(%GeneratorFunction.prototype.prototype%).
  6. 执行 ! DefinePropertyOrThrow(F"prototype",属性描述符 { [[Value]]: prototype[[Writable]]: true[[Enumerable]]: false[[Configurable]]: false })。
  7. 返回 F
GeneratorDeclaration : function * ( FormalParameters ) { GeneratorBody }
  1. sourceText 为与 GeneratorDeclaration 匹配的 GeneratorDeclaration 的源文本。
  2. FOrdinaryFunctionCreate(%GeneratorFunction.prototype%, sourceTextFormalParametersGeneratorBodynon-lexical-thisenvprivateEnv)。
  3. 执行 SetFunctionName(F"default")。
  4. prototypeOrdinaryObjectCreate(%GeneratorFunction.prototype.prototype%).
  5. 执行 ! DefinePropertyOrThrow(F"prototype",属性描述符 { [[Value]]: prototype[[Writable]]: true[[Enumerable]]: false[[Configurable]]: false })。
  6. 返回 F

匿名的 GeneratorDeclaration 只能作为 export default 声明的一部分出现,因此其函数代码始终是 严格模式代码

15.5.4 运行时语义:实例化生成器函数表达式

语法导向操作 实例化生成器函数表达式接收一个可选参数 name(一个 属性键 或一个 私有名称 )并返回一个 ECMAScript 函数对象 。其定义如下:

GeneratorExpression : function * ( FormalParameters ) { GeneratorBody }
  1. 如果 name 不存在,将 name 设为空字符串 ""
  2. env 为当前运行执行上下文的 词法环境
  3. privateEnv 为当前运行执行上下文的 私有环境
  4. sourceText 为与 语法导向操作 GeneratorExpression 匹配的源文本。
  5. closure OrdinaryFunctionCreate ( %GeneratorFunction.prototype% , sourceText, FormalParameters , GeneratorBody , non-lexical-this, env, privateEnv)。
  6. 执行 SetFunctionName (closure, name)。
  7. prototype OrdinaryObjectCreate ( %GeneratorFunction.prototype.prototype% )。
  8. 执行 DefinePropertyOrThrow (closure, "prototype", PropertyDescriptor { [[Value]]: prototype, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false })。
  9. 返回 closure

15.5.5 运行时语义:求值

GeneratorExpression : function * BindingIdentifier opt ( FormalParameters ) { GeneratorBody }
  1. 返回 InstantiateGeneratorFunctionExpression GeneratorExpression
YieldExpression : yield
  1. 返回 ?  Yield (undefined)。
YieldExpression : yield AssignmentExpression
  1. exprRef 为 ?  Evaluation AssignmentExpression
  2. value 为 ?  GetValue (exprRef)。
  3. 返回 ?  Yield (value)。
YieldExpression : yield * AssignmentExpression
  1. generatorKind GetGeneratorKind ()。
  2. exprRef 为 ?  Evaluation AssignmentExpression
  3. value 为 ?  GetValue (exprRef)。
  4. iteratorRecord 为 ?  GetIterator (value, generatorKind)。
  5. iteratoriteratorRecord.[[Iterator]]
  6. received NormalCompletion (undefined)。
  7. 重复,直到:
    1. 如果 received 正常完成 ,则
      1. innerResult 为 ?  Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]], « received.[[Value]] »)。
      2. 如果 generatorKindasync,将 innerResult 设为 ?  Await (innerResult)。
      3. 如果 innerResult 不是对象 ,抛出 TypeError 异常。
      4. done 为 ?  IteratorComplete (innerResult)。
      5. 如果 donetrue,则
        1. 返回 ?  IteratorValue (innerResult)。
      6. 如果 generatorKindasync,将 received 设为 Completion (? AsyncGeneratorYield (? IteratorValue (innerResult)))。
      7. 否则,将 received 设为 Completion ( GeneratorYield (innerResult))。
    2. 否则,如果 received throw completion ,则
      1. throw 为 ?  GetMethod (iterator, "throw")。
      2. 如果 throw 不是 undefined,则
        1. innerResult 为 ?  Call (throw, iterator, « received.[[Value]] »)。
        2. 如果 generatorKindasync,将 innerResult 设为 ?  Await (innerResult)。
        3. 注意:内部迭代器的 throw 方法抛出的异常会被传播。throw 方法的正常完成与 next 类似。
        4. 如果 innerResult 不是对象 ,抛出 TypeError 异常。
        5. done 为 ?  IteratorComplete (innerResult)。
        6. 如果 donetrue,则
          1. 返回 ?  IteratorValue (innerResult)。
        7. 如果 generatorKindasync,将 received 设为 Completion ( AsyncGeneratorYield (? IteratorValue (innerResult)))。
        8. 否则,将 received 设为 Completion ( GeneratorYield (innerResult))。
      3. 否则,
        1. 断言 received return completion
        2. return 为 ?  GetMethod (iterator, "return")。
        3. 如果 returnundefined,则
          1. value 设为 received.[[Value]]
          2. 如果 generatorKindasync,则
            1. value 设为 ?  Await (value)。
          3. 返回 Completion Record { [[Type]]: return, [[Value]]: value, [[Target]]: empty  }。
        4. innerReturnResult 为 ?  Call (return, iterator, « received.[[Value]] »)。
        5. 如果 generatorKindasync,将 innerReturnResult 设为 ?  Await (innerReturnResult)。
        6. 如果 innerReturnResult 不是对象 ,抛出 TypeError 异常。
        7. done 为 ?  IteratorComplete (innerReturnResult)。
        8. 如果 donetrue,则
          1. value 设为 ?  IteratorValue (innerReturnResult)。
          2. 返回 Completion Record { [[Type]]: return, [[Value]]: value, [[Target]]: empty  }。
        9. 如果 generatorKindasync,将 received 设为 Completion ( AsyncGeneratorYield (? IteratorValue (innerReturnResult)))。
        10. 否则,将 received 设为 Completion ( GeneratorYield (innerReturnResult))。

15.6 异步生成器函数定义

语法

AsyncGeneratorDeclaration[Yield, Await, Default] : async [no LineTerminator here] function * BindingIdentifier[?Yield, ?Await] ( FormalParameters[+Yield, +Await] ) { AsyncGeneratorBody } [+Default] async [no LineTerminator here] function * ( FormalParameters[+Yield, +Await] ) { AsyncGeneratorBody } AsyncGeneratorExpression : async [no LineTerminator here] function * BindingIdentifier[+Yield, +Await]opt ( FormalParameters[+Yield, +Await] ) { AsyncGeneratorBody } AsyncGeneratorMethod[Yield, Await] : async [no LineTerminator here] * ClassElementName[?Yield, ?Await] ( UniqueFormalParameters[+Yield, +Await] ) { AsyncGeneratorBody } AsyncGeneratorBody : FunctionBody[+Yield, +Await] 注 1

YieldExpression AwaitExpression 不能在异步生成器函数的 FormalParameters 中使用,因为任何属于 FormalParameters 的表达式在生成的 AsyncGenerator 处于可恢复状态之前都会被求值。

注 2

与 AsyncGenerators 相关的 抽象操作 定义在 27.6.3

15.6.1 静态语义:早期错误

AsyncGeneratorMethod : async * ClassElementName ( UniqueFormalParameters ) { AsyncGeneratorBody } AsyncGeneratorDeclaration : async function * BindingIdentifier ( FormalParameters ) { AsyncGeneratorBody } async function * ( FormalParameters ) { AsyncGeneratorBody } AsyncGeneratorExpression : async function * BindingIdentifier opt ( FormalParameters ) { AsyncGeneratorBody }

15.6.2 运行时语义:EvaluateAsyncGeneratorBody

语法定向操作 EvaluateAsyncGeneratorBody 接受参数 functionObject(一个 ECMAScript 函数对象 )和 argumentsList(一个 列表 of ECMAScript 语言值 ),并返回一个 throw completion return completion 。它分段定义如下:

AsyncGeneratorBody : FunctionBody
  1. 执行 ?  FunctionDeclarationInstantiation (functionObject, argumentsList)。
  2. generator 为 ?  OrdinaryCreateFromConstructor (functionObject, "%AsyncGeneratorFunction.prototype.prototype%", « [[AsyncGeneratorState]], [[AsyncGeneratorContext]], [[AsyncGeneratorQueue]], [[GeneratorBrand]] »)。
  3. generator.[[GeneratorBrand]] 设为 empty
  4. 执行 AsyncGeneratorStart (generator, FunctionBody )。
  5. 返回 Completion Record { [[Type]]: return, [[Value]]: generator, [[Target]]: empty  }。

15.6.3 运行时语义:InstantiateAsyncGeneratorFunctionObject

语法定向操作 InstantiateAsyncGeneratorFunctionObject 接受参数 env(一个 环境记录 )和 privateEnv(一个 私有环境记录 null),并返回一个 ECMAScript 函数对象 。它分段定义如下:

AsyncGeneratorDeclaration : async function * BindingIdentifier ( FormalParameters ) { AsyncGeneratorBody }
  1. name StringValue of BindingIdentifier
  2. sourceText 源文本匹配 AsyncGeneratorDeclaration
  3. F OrdinaryFunctionCreate ( %AsyncGeneratorFunction.prototype% , sourceText, FormalParameters , AsyncGeneratorBody , non-lexical-this, env, privateEnv)。
  4. 执行 SetFunctionName (F, name)。
  5. prototype OrdinaryObjectCreate ( %AsyncGeneratorFunction.prototype.prototype% )。
  6. 执行 !  DefinePropertyOrThrow (F, "prototype", PropertyDescriptor { [[Value]]: prototype, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false  })。
  7. 返回 F
AsyncGeneratorDeclaration : async function * ( FormalParameters ) { AsyncGeneratorBody }
  1. sourceText 源文本匹配 AsyncGeneratorDeclaration
  2. F OrdinaryFunctionCreate ( %AsyncGeneratorFunction.prototype% , sourceText, FormalParameters , AsyncGeneratorBody , non-lexical-this, env, privateEnv)。
  3. 执行 SetFunctionName (F, "default")。
  4. prototype OrdinaryObjectCreate ( %AsyncGeneratorFunction.prototype.prototype% )。
  5. 执行 !  DefinePropertyOrThrow (F, "prototype", PropertyDescriptor { [[Value]]: prototype, [[Writable]]: true, [[Enumerable]]: false, [[Configurable]]: false  })。
  6. 返回 F

匿名的 AsyncGeneratorDeclaration 只能作为 export default 声明的一部分出现。

15.6.4 运行时语义:InstantiateAsyncGeneratorFunctionExpression

语法定向操作 InstantiateAsyncGeneratorFunctionExpression 接受可选参数 name(一个 属性键 私有名称 ),并返回一个 ECMAScript 函数对象 。它分段定义如下:

AsyncGeneratorExpression : async function * ( FormalParameters ) { AsyncGeneratorBody }
AsyncGeneratorExpression : async function * BindingIdentifier ( FormalParameters ) { AsyncGeneratorBody }

AsyncGeneratorExpression 中的 BindingIdentifier 可以在 AsyncGeneratorExpression AsyncGeneratorBody 中被引用,以允许生成器代码递归调用自身。然而,与 AsyncGeneratorDeclaration 不同,在 AsyncGeneratorExpression 中的 BindingIdentifier 不能在外层作用域中被引用,也不会影响包含它的作用域。

15.6.5 运行时语义:评估

AsyncGeneratorExpression : async function * BindingIdentifier opt ( FormalParameters ) { AsyncGeneratorBody }

15.7 类定义

语法

ClassDeclaration[Yield, Await, Default] : class BindingIdentifier[?Yield, ?Await] ClassTail[?Yield, ?Await] [+Default] class ClassTail[?Yield, ?Await] ClassExpression[Yield, Await] : class BindingIdentifier[?Yield, ?Await]opt ClassTail[?Yield, ?Await] ClassTail[Yield, Await] : ClassHeritage[?Yield, ?Await]opt { ClassBody[?Yield, ?Await]opt } ClassHeritage[Yield, Await] : extends LeftHandSideExpression[?Yield, ?Await] ClassBody[Yield, Await] : ClassElementList[?Yield, ?Await] ClassElementList[Yield, Await] : ClassElement[?Yield, ?Await] ClassElementList[?Yield, ?Await] ClassElement[?Yield, ?Await] ClassElement[Yield, Await] : MethodDefinition[?Yield, ?Await] static MethodDefinition[?Yield, ?Await] FieldDefinition[?Yield, ?Await] ; static FieldDefinition[?Yield, ?Await] ; ClassStaticBlock ; FieldDefinition[Yield, Await] : ClassElementName[?Yield, ?Await] Initializer[+In, ?Yield, ?Await]opt ClassElementName[Yield, Await] : PropertyName[?Yield, ?Await] PrivateIdentifier ClassStaticBlock : static { ClassStaticBlockBody } ClassStaticBlockBody : ClassStaticBlockStatementList ClassStaticBlockStatementList : StatementList[~Yield, +Await, ~Return]opt

类定义总是 严格模式代码

15.7.1 静态语义:早期错误

ClassTail : ClassHeritage opt { ClassBody } ClassBody : ClassElementList ClassElement : MethodDefinition ClassElement : static MethodDefinition ClassElement : FieldDefinition ; ClassElement : static FieldDefinition ; FieldDefinition : ClassElementName Initializer opt ClassElementName : PrivateIdentifier ClassStaticBlockBody : ClassStaticBlockStatementList

15.7.2 静态语义:ClassElementKind

语法导向操作 ClassElementKind 不接受参数,并返回 constructor-methodnon-constructor-method,或 empty。它在以下各个生成式上分段定义:

ClassElement : MethodDefinition
  1. 如果 PropNameMethodDefinition"constructor",返回 constructor-method
  2. 返回 non-constructor-method
ClassElement : static MethodDefinition FieldDefinition ; static FieldDefinition ;
  1. 返回 non-constructor-method
ClassElement : ClassStaticBlock
  1. 返回 non-constructor-method
ClassElement : ;
  1. 返回 empty

15.7.3 静态语义:ConstructorMethod

语法导向操作 ConstructorMethod 不接受参数,并返回一个 ClassElement 解析节点empty。它在以下各个生成式上分段定义:

ClassElementList : ClassElement
  1. 如果 ClassElementKindClassElementconstructor-method,返回 ClassElement
  2. 返回 empty
ClassElementList : ClassElementList ClassElement
  1. headConstructorMethodClassElementList
  2. 如果 head 不是 empty,返回 head
  3. 如果 ClassElementKindClassElementconstructor-method,返回 ClassElement
  4. 返回 empty

早期错误规则确保只有一个名为 "constructor" 的方法定义,并且它不是 访问器 属性 或生成器定义。

15.7.4 静态语义:IsStatic

语法导向操作 IsStatic 不接受参数,并返回一个布尔值。它在以下各个生成式上分段定义:

ClassElement : MethodDefinition
  1. 返回 false
ClassElement : static MethodDefinition
  1. 返回 true
ClassElement : FieldDefinition ;
  1. 返回 false
ClassElement : static FieldDefinition ;
  1. 返回 true
ClassElement : ClassStaticBlock
  1. 返回 true
ClassElement : ;
  1. 返回 false

15.7.5 静态语义:NonConstructorElements

语法导向操作 NonConstructorElements 不接受参数,并返回一个包含 ClassElement解析节点列表。它在以下各个生成式上分段定义:

ClassElementList : ClassElement
  1. 如果ClassElementKind 属于ClassElement且为non-constructor-method,则
    1. 返回« ClassElement »。
  2. 返回一个新的空列表
ClassElementList : ClassElementList ClassElement
  1. list等于NonConstructorElements 属于ClassElementList
  2. 如果ClassElementKind 属于ClassElement且为non-constructor-method,则
    1. ClassElement追加到list的末尾。
  3. 返回list

15.7.6 静态语义:PrototypePropertyNameList

语法导向操作 PrototypePropertyNameList 不接受参数,并返回一个包含属性键列表。它在以下各个生成式上分段定义:

ClassElementList : ClassElement
  1. propName 等于 PropName 属于 ClassElement
  2. 如果 propNameempty,则返回一个新的空列表
  3. 如果 IsStatic 属于 ClassElementtrue,则返回一个新的空列表
  4. 返回 « propName »。
ClassElementList : ClassElementList ClassElement
  1. list 等于 PrototypePropertyNameList 属于ClassElementList
  2. propName 等于 PropName 属于 ClassElement
  3. 如果 propNameempty,则返回 list
  4. 如果 IsStatic 属于 ClassElementtrue,则返回 list
  5. 返回列表连接 list 和 « propName »。

15.7.7 静态语义:AllPrivateIdentifiersValid

语法导向操作 AllPrivateIdentifiersValid 接受参数 names(一个字符串列表)并返回一个布尔值。

本规范中未列出的每个语法生成式替代项隐含有以下默认的 AllPrivateIdentifiersValid 定义:

  1. 对于此解析节点的每个子节点child,执行以下操作:
    1. 如果 child 是一个非终结符的实例,那么
      1. 如果 AllPrivateIdentifiersValid 属于 child 并带有参数 namesfalse,则返回 false
  2. 返回 true
MemberExpression : MemberExpression . PrivateIdentifier
  1. 如果 names 包含 StringValue 属于 PrivateIdentifier,那么
    1. 返回 AllPrivateIdentifiersValid 属于 MemberExpression 并带有参数 names
  2. 返回 false
CallExpression : CallExpression . PrivateIdentifier
  1. 如果 names 包含 StringValue 属于 PrivateIdentifier,那么
    1. 返回 AllPrivateIdentifiersValid 属于 CallExpression 并带有参数 names
  2. 返回 false
OptionalChain : ?. PrivateIdentifier
  1. 如果 names 包含 StringValue 属于 PrivateIdentifier,返回 true
  2. 返回 false
OptionalChain : OptionalChain . PrivateIdentifier
  1. 如果 names 包含 StringValue 属于 PrivateIdentifier,那么
    1. 返回 AllPrivateIdentifiersValid 属于 OptionalChain 并带有参数 names
  2. 返回 false
ClassBody : ClassElementList
  1. newNames 等于 列表连接 namesPrivateBoundIdentifiers 属于 ClassBody
  2. 返回 AllPrivateIdentifiersValid 属于 ClassElementList 并带有参数 newNames
RelationalExpression : PrivateIdentifier in ShiftExpression
  1. 如果 names 包含 StringValue 属于 PrivateIdentifier,那么
    1. 返回 AllPrivateIdentifiersValid 属于 ShiftExpression 并带有参数 names
  2. 返回 false

15.7.8 静态语义:PrivateBoundIdentifiers

语法导向操作 PrivateBoundIdentifiers 不接受参数并返回一个字符串列表。它通过以下生成式逐步定义:

FieldDefinition : ClassElementName Initializeropt
  1. 返回PrivateBoundIdentifiers 属于 ClassElementName
ClassElementName : PrivateIdentifier
  1. 返回一个列表,其唯一元素是StringValue 属于 PrivateIdentifier
ClassElementName : PropertyName ClassElement : ClassStaticBlock ;
  1. 返回一个新的空列表
ClassElementList : ClassElementList ClassElement
  1. names1PrivateBoundIdentifiers 属于ClassElementList
  2. names2PrivateBoundIdentifiers 属于ClassElement
  3. 返回 names1names2列表连接
MethodDefinition : ClassElementName ( UniqueFormalParameters ) { FunctionBody } get ClassElementName ( ) { FunctionBody } set ClassElementName ( PropertySetParameterList ) { FunctionBody } GeneratorMethod : * ClassElementName ( UniqueFormalParameters ) { GeneratorBody } AsyncMethod : async ClassElementName ( UniqueFormalParameters ) { AsyncFunctionBody } AsyncGeneratorMethod : async * ClassElementName ( UniqueFormalParameters ) { AsyncGeneratorBody }
  1. 返回PrivateBoundIdentifiers 属于 ClassElementName

15.7.9 静态语义:ContainsArguments

语法导向操作 ContainsArguments 不接受参数并返回一个布尔值。

本规范中未列出的每个语法生成式替代方案隐式具有以下 ContainsArguments 的默认定义:

  1. 对于此解析节点的每个子节点child,执行以下操作
    1. 如果child是一个非终结符实例,则
      1. 如果ContainsArguments 属于childtrue,则返回true
  2. 返回false
IdentifierReference : Identifier
  1. 如果StringValue 属于 Identifier"arguments",则返回true
  2. 返回false
FunctionDeclaration : function BindingIdentifier ( FormalParameters ) { FunctionBody } function ( FormalParameters ) { FunctionBody } FunctionExpression : function BindingIdentifieropt ( FormalParameters ) { FunctionBody } GeneratorDeclaration : function * BindingIdentifier ( FormalParameters ) { GeneratorBody } function * ( FormalParameters ) { GeneratorBody } GeneratorExpression : function * BindingIdentifieropt ( FormalParameters ) { GeneratorBody } AsyncGeneratorDeclaration : async function * BindingIdentifier ( FormalParameters ) { AsyncGeneratorBody } async function * ( FormalParameters ) { AsyncGeneratorBody } AsyncGeneratorExpression : async function * BindingIdentifieropt ( FormalParameters ) { AsyncGeneratorBody } AsyncFunctionDeclaration : async function BindingIdentifier ( FormalParameters ) { AsyncFunctionBody } async function ( FormalParameters ) { AsyncFunctionBody } AsyncFunctionExpression : async function BindingIdentifieropt ( FormalParameters ) { AsyncFunctionBody }
  1. 返回false
MethodDefinition : ClassElementName ( UniqueFormalParameters ) { FunctionBody } get ClassElementName ( ) { FunctionBody } set ClassElementName ( PropertySetParameterList ) { FunctionBody } GeneratorMethod : * ClassElementName ( UniqueFormalParameters ) { GeneratorBody } AsyncGeneratorMethod : async * ClassElementName ( UniqueFormalParameters ) { AsyncGeneratorBody } AsyncMethod : async ClassElementName ( UniqueFormalParameters ) { AsyncFunctionBody }
  1. 返回false
MethodDefinition : ClassElementName ( UniqueFormalParameters ) { FunctionBody } get ClassElementName ( ) { FunctionBody } set ClassElementName ( PropertySetParameterList ) { FunctionBody } GeneratorMethod : * ClassElementName ( UniqueFormalParameters ) { GeneratorBody } AsyncGeneratorMethod : async * ClassElementName ( UniqueFormalParameters ) { AsyncGeneratorBody } AsyncMethod : async ClassElementName ( UniqueFormalParameters ) { AsyncFunctionBody }
  1. 返回ContainsArguments 属于ClassElementName

15.7.10 运行时语义: ClassFieldDefinitionEvaluation

ClassFieldDefinitionEvaluation 语法直接操作接收参数 homeObject(一个对象),并返回一个包含 ClassFieldDefinition Record 的正常完成记录或一个 异常完成记录。它根据以下语法规则逐一定义:

FieldDefinition : ClassElementName Initializeropt
  1. name 为 ? Evaluation ClassElementName
  2. 如果 Initializer 存在,那么:
    1. formalParameterListFormalParameters:[empty] 的一个实例。
    2. env运行执行上下文 的词法环境。
    3. privateEnv运行执行上下文 的私有环境。
    4. sourceText 为 Unicode 代码点的空序列。
    5. initializerOrdinaryFunctionCreate(%Function.prototype%, sourceText, formalParameterList, Initializer, non-lexical-this, env, privateEnv)。
    6. 执行 MakeMethod(initializer, homeObject)。
    7. 设置 initializer.[[ClassFieldInitializerName]]name
  3. 否则:
    1. initializerempty
  4. 返回 ClassFieldDefinition Record { [[Name]]: name, [[Initializer]]: initializer }。
initializer 创建的函数永远不会直接被 ECMAScript 代码访问。

15.7.11 运行时语义:ClassStaticBlockDefinitionEvaluation

ClassStaticBlockDefinitionEvaluation 语法直接操作接收参数 homeObject(一个对象),并返回一个 ClassStaticBlockDefinition Record。它根据以下语法规则逐一定义:

ClassStaticBlock : static { ClassStaticBlockBody }
  1. lex运行执行上下文 的词法环境。
  2. privateEnv运行执行上下文 的私有环境。
  3. sourceText 为 Unicode 代码点的空序列。
  4. formalParametersFormalParameters:[empty] 的一个实例。
  5. bodyFunctionOrdinaryFunctionCreate(%Function.prototype%, sourceText, formalParameters, ClassStaticBlockBody, non-lexical-this, lex, privateEnv)。
  6. 执行 MakeMethod(bodyFunction, homeObject)。
  7. 返回 ClassStaticBlockDefinition Record { [[BodyFunction]]: bodyFunction }。
bodyFunction 创建的函数永远不会直接被 ECMAScript 代码访问。

15.7.12 运行时语义:EvaluateClassStaticBlockBody

EvaluateClassStaticBlockBody 语法直接操作接收参数 functionObject(一个 ECMAScript 函数对象),并返回一个 正常完成记录,包含一个 ECMAScript 语言值,或一个 中断完成。它根据以下语法规则逐一定义:

ClassStaticBlockBody : ClassStaticBlockStatementList
  1. 断言functionObject 是由 ClassStaticBlockDefinitionEvaluation5 步创建的合成函数。
  2. 执行 ! FunctionDeclarationInstantiation(functionObject, « »)。
  3. 返回 ? Evaluation of ClassStaticBlockStatementList

15.7.13 运行时语义:ClassElementEvaluation

语法直接操作 ClassElementEvaluation 接受参数 object(一个对象)并返回一个包含 正常完成 ClassFieldDefinition 记录 ClassStaticBlockDefinition 记录 PrivateElement unused,或返回一个 中止完成 。其分段定义如下生产:

ClassElement : FieldDefinition ; static FieldDefinition ;
  1. 返回 ? ClassFieldDefinitionEvaluation FieldDefinition 参数为 object
ClassElement : MethodDefinition static MethodDefinition
  1. 返回 ? MethodDefinitionEvaluation MethodDefinition 参数为 objectfalse
ClassElement : ClassStaticBlock
  1. 返回 ClassStaticBlockDefinitionEvaluation ClassStaticBlock 参数为 object
ClassElement