Draft ECMA-262 / June 25, 2026
ECMAScript® 2027 言語仕様
この仕様について
https://tc39.es/ecma262/ にある文書は、最も正確で最新のECMAScript仕様です。これは、最新の年次スナップショットの内容に加えて、完了した提案 — すなわち、提案プロセスにおいてStage 4に到達し、したがって複数の実装で実装され、次の年次スナップショットに含まれるもの — を含みます。過去のスナップショットは https://ecma-international.org/publications-and-standards/standards/ecma-262/ で入手できます。
この仕様への貢献
この仕様は、ECMAScriptコミュニティの助けを借りてGitHub上で開発されています。この仕様の開発に貢献する方法はいくつかあります：
- GitHubリポジトリ: https://github.com/tc39/ecma262
- Issue: すべてのIssue, 新しいIssueを提出
- Pull Request: すべてのPull Request, 新しいPull Requestを作成
- テストスイート: Test262
- 編集者:
-
コミュニティ:
- Discourse: https://es.discourse.group/
- チャット: Matrix
- メーリング
リスト アーカイブ: https://esdiscuss.org/
この文書がどのように作成されるかについての詳細は、
導入
このEcma標準は、ECMAScript 2027言語を定義します。これはECMAScript言語仕様の第18版です。ECMAScriptは、いくつかの起源となる技術に基づいており、最もよく知られているものはJavaScript（Netscape）とJScript（Microsoft）です。この言語はNetscapeのBrendan Eichによって発明され、同社のNavigator 2.0ブラウザーで初めて登場しました。Webブラウザーに組み込まれた言語として最もよく知られていますが、サーバーや組み込みアプリケーションを含むブラウザー外での利用にも広く採用され、世界で最も広く使われている汎用プログラミング言語の一つへと成長しました。
ECMAScript言語仕様の開発は1996年11月に始まりました。このEcma標準の第1版は、1997年6月のEcma総会で採択されました。
そのEcma標準は、ファストトラック手続きに基づく採択のためISO/IEC JTC 1に提出され、1998年4月に国際標準ISO/IEC 16262として承認されました。1998年6月のEcma総会は、ISO/IEC 16262との完全な整合性を維持するため、ECMA-262の第2版を承認しました。第1版と第2版の間の変更は編集上の性質のものです。
標準の第3版では、強力な正規表現、より優れた文字列処理、新しい制御文、try/catch例外処理、エラーのより厳密な定義、数値出力の書式化、および将来の言語の成長を見越した小さな変更が導入されました。ECMAScript標準の第3版は1999年12月のEcma総会で採択され、2002年6月にISO/IEC 16262:2002として発行されました。
第3版の発行後、ECMAScriptは、ほぼすべてのWebブラウザーでサポートされるプログラミング言語となったWorld Wide Webと連動して大規模に普及しました。ECMAScriptの第4版を開発するために重要な作業が行われました。しかし、その作業は完了せず、ECMAScriptの第4版として発行されることもありませんでしたが、その一部は第6版の開発に組み込まれました。
ECMAScriptの第5版（ECMA-262第5th版として発行）は、ブラウザー実装の間で一般的になっていた言語仕様の事実上の解釈を明文化し、第3版の発行以降に登場した新機能のサポートを追加しました。そのような機能には、アクセサープロパティ、オブジェクトの反射的な作成と検査、プロパティ属性のプログラムによる制御、追加の配列操作関数、JSONオブジェクトエンコーディング形式のサポート、強化されたエラーチェックとプログラムセキュリティを提供するstrict modeが含まれます。第5版は2009年12月のEcma総会で採択されました。
第5版は、ファストトラック手続きに基づく採択のためISO/IEC JTC 1に提出され、国際標準ISO/IEC 16262:2011として承認されました。ECMAScript標準の5.1版は軽微な訂正を取り込み、ISO/IEC 16262:2011と同一のテキストです。5.1版は2011年6月のEcma総会で採択されました。
第6版の集中的な開発は、第5版が発行に向けて準備されていた2009年に始まりました。しかし、その前には、1999年の第3版の発行に遡る重要な実験と、言語拡張の設計作業が行われていました。非常に現実的な意味で、第6版の完成は15年にわたる努力の集大成です。この版の目標には、大規模アプリケーション、ライブラリ作成、および他の言語のコンパイルターゲットとしてのECMAScriptの利用をよりよくサポートすることが含まれていました。その主な拡張には、モジュール、クラス宣言、レキシカルなブロックスコープ、イテレーターとジェネレーター、非同期プログラミングのためのpromise、分割代入パターン、proper tail callsが含まれていました。ECMAScriptの組み込みライブラリは、map、set、およびバイナリ数値の配列を含む追加のデータ抽象化、ならびに文字列と正規表現におけるUnicode補助文字の追加サポートを提供するよう拡張されました。組み込みもサブクラス化を通じて拡張可能にされました。第6版は、定期的で漸進的な言語およびライブラリの拡張の基盤を提供します。第6版は2015年6月の総会で採択されました。
ECMAScript 2016は、Ecma TC39の新しい年次リリース周期とオープンな開発プロセスの下でリリースされた最初のECMAScript版でした。ECMAScript 2015のソース文書から平文のソース文書が構築され、GitHub上で完全に進められるさらなる開発の基盤として機能しました。この標準の開発期間を通じて、何百ものpull requestとissueが提出され、何千ものバグ修正、編集上の修正、その他の改善を表していました。さらに、この取り組みを支援するため、Ecmarkup、Ecmarkdown、Grammarkdownを含む多数のソフトウェアツールが開発されました。ES2016には、新しいべき乗演算子のサポートも含まれ、Array.prototypeにincludesという新しいメソッドが追加されました。
ECMAScript 2017では、Async Functions、Shared Memory、Atomicsが導入され、さらに小規模な言語およびライブラリの拡張、バグ修正、編集上の更新が行われました。Async functionsは、promiseを返す関数のための構文を提供することで、非同期プログラミング体験を改善します。Shared MemoryとAtomicsは、並列CPU上であっても明確に定義された実行順序を保証するアトミック操作を使用して、複数のエージェントからなるプログラムが通信できるようにする新しいメモリモデルを導入します。また、Objectに新しい静的メソッドとしてObject.values、Object.entries、Object.getOwnPropertyDescriptorsが含まれました。
ECMAScript 2018では、dotAllフラグ、名前付きキャプチャグループ、Unicodeプロパティエスケープ、および後読みアサーションも含まれました。最後に、object restおよびspreadプロパティも含まれました。
ECMAScript 2019では、いくつかの新しい組み込み関数が導入されました。配列を平坦化するためのArray.prototype上のflatとflatMap、Object.entriesの戻り値を直接新しいObjectに変換するObject.fromEntries、および広く実装されていたものの非標準であったString.prototype.trimLeftおよびtrimRight組み込みの、よりよい名前の代替としてのString.prototype上のtrimStartとtrimEndです。さらに、構文と意味論に対するいくつかの小さな更新も含まれました。更新された構文には、任意のcatch束縛パラメーター、およびJSONとの整合のために文字列リテラル内でU+2028（LINE SEPARATOR）とU+2029（PARAGRAPH SEPARATOR）を許可することが含まれました。その他の更新には、Array.prototype.sortが安定ソートであることを要求すること、JSON.stringifyが入力に関係なく整形式UTF-8を返すことを要求すること、およびFunction.prototype.toStringが対応する元のソーステキストまたは標準のプレースホルダーのいずれかを返すことを要求することで明確化することが含まれました。
ECMAScript 2020、第11th版では、globalな正規表現によって生成されるすべてのmatchオブジェクトに対するmatchAllメソッド、動的なspecifierでModulesを非同期にimportする構文であるimport()、任意精度整数を扱うための新しい数値プリミティブであるBigInt、短絡しない新しいPromiseコンビネーターであるPromise.allSettled、globalなthis値にアクセスする普遍的な方法であるglobalThis、modules内で使用するための専用構文export * as ns from 'module'、for-in列挙順序の標準化の拡大、Module内で利用可能で、そのModuleに関する文脈情報を含み得るhost-populated objectであるimport.metaが導入され、さらに“nullish”な値（
ECMAScript 2021、第12th版では、StringsのためのreplaceAllメソッド、入力値がfulfilledになったときに短絡するPromiseコンビネーターであるPromise.any、複数のエラーを一度に表すための新しいError型であるAggregateError、論理代入演算子（??=、&&=、||=）、対象オブジェクトをガベージコレクションから保持することなく参照するためのWeakRef、対象オブジェクトがガベージコレクトされたときに実行されるcleanup操作の登録と登録解除を管理するFinalizationRegistry、数値リテラルの区切り文字（1_000）が導入され、またArray.prototype.sortはより精密にされ、実装定義のソート順序となる場合の数が減らされました。
ECMAScript 2022、第13th版では、top-level awaitが導入され、moduleのトップレベルでそのキーワードを使用できるようになりました。新しいclass要素として、publicおよびprivateのinstance fields、publicおよびprivateのstatic fields、private instance methodsおよびaccessors、private static methodsおよびaccessors、classごとの評価初期化を行うためのclass内のstatic blocks、オブジェクト上のprivate fieldsの存在をテストするための#x in obj構文、matched substringsの開始および終了インデックスを提供する/dフラグによる正規表現match indices、エラーに因果関係の連鎖を記録するために使用できるErrorオブジェクト上のcauseプロパティ、相対インデックス指定を可能にするStrings、Arrays、atメソッド、およびObject.prototype.hasOwnPropertyの便利な代替であるObject.hasOwnが導入されました。
ECMAScript 2023、第14th版では、Array.prototypeおよびTypedArray.prototype上のtoSorted、toReversed、with、findLast、findLastIndexメソッド、ならびにArray.prototype上のtoSplicedメソッドが導入されました。また、実行可能なECMAScriptファイルをより扱いやすくするため、ファイルの先頭における#!コメントのサポートが追加され、ほとんどのSymbolsをweak collectionsのキーとして使用できるようになりました。
ECMAScript 2024、第15th版では、ArrayBuffersおよびSharedArrayBuffersのサイズ変更と転送のための機能が追加されました。文字列の集合を扱うためのより高度な機能を持つRegExpsを作成する新しいRegExp /vフラグが追加され、Promisesを構築するための便利なメソッドであるPromise.withResolvers、データを集約するためのObject.groupByおよびMap.groupByメソッド、shared memoryの変更を非同期に待つためのAtomics.waitAsyncメソッド、および文字列が整形式Unicodeのみを含むかをチェックし保証するためのString.prototype.isWellFormedおよびString.prototype.toWellFormedメソッドが導入されました。
ECMAScript 2025、第16th版では、Iterator globalが追加されました。Setsに対して一般的な操作を実行するためのSet.prototype上のメソッドが追加され、JSON modulesをimportするサポート、およびimported modulesの属性を宣言する構文が追加されました。文字列を正規表現内で安全に使用できるようエスケープするためのRegExp.escapeメソッド、正規表現内でmodifier flagsをインラインで有効化および無効化する構文、Promiseを返す場合も返さない場合もある関数を呼び出し、結果が常にPromiseになることを保証するPromise.tryメソッド、ならびに新しいFloat16Array DataView.prototype.getFloat16、DataView.prototype.setFloat16、Math.f16roundメソッドが追加されました。
ECMAScript 2026、第17th版では、大きさの異なるNumbersのMath.sumPrecise、Iterator.concat、Array.fromAsync、error objectsを識別するためのError.isError、keyがまだ存在しない場合に取得時に使用するdefault valueを提供するためのMap.prototypeおよびWeakMap.prototype上のメソッド、16進数およびbase64でエンコードされたバイナリデータのStringsとの変換を行うためのUint8Array上のメソッド、JSON sourceの一致したsegmentにアクセスするためのJSON.parse reviversへのパラメーター、およびprimitive valuesに対するJSON.stringify出力を細かく制御するためのJSON.rawJSONが追加されました。
多くの組織を代表する数十人の個人が、Ecma TC39内で、この版および以前の版の開発に非常に重要な貢献をしてきました。さらに、TC39のECMAScriptへの取り組みを支援する活発なコミュニティが生まれました。このコミュニティは、多数のdraftをレビューし、何千ものbug reportを提出し、実装実験を行い、test suitesに貢献し、世界中のdeveloperコミュニティにECMAScriptについて教育してきました。残念ながら、この取り組みに貢献したすべての人および組織を特定して謝意を示すことは不可能です。
Allen Wirfs-Brock
ECMA-262、第6th版、Project Editor
Brian Terlson
ECMA-262、第7th版から第10th版まで、Project Editor
Jordan Harband
ECMA-262、第10th版から第12th版まで、Project Editor
Kevin Gibbons
ECMA-262、第12th版から第17th版まで、Project Editor
Shu-yu Guo
ECMA-262、第12th版から第18th版まで、Project Editor
Michael Ficarra
ECMA-262、第12th版から第18th版まで、Project Editor
Richard Gibson
ECMA-262、第18th版、Project Editor
Ron Buckton
ECMA-262、第18th版、Project Editor
Nicolò Ribaudo
ECMA-262、第18th版、Project Editor
Linus Groh
ECMA-262、第18th版、Project Editor
1 適用範囲
この標準は、汎用プログラミング言語ECMAScript 2027を定義します。
2 適合性
ECMAScriptの適合実装は、この仕様に記述されるすべての型、値、オブジェクト、プロパティ、関数、およびプログラムの構文と意味論を提供し、サポートしなければなりません。
ECMAScriptの適合実装は、Unicode StandardおよびISO/IEC 10646の最新バージョンに適合して、ソーステキスト入力を解釈しなければなりません。
異なる人間の言語および国で使用される言語的・文化的慣習に適応する必要のあるプログラムをサポートするアプリケーションプログラミングインターフェイス（API）を提供するECMAScriptの適合実装は、この仕様と互換性のあるECMA-402の最新版で定義されるインターフェイスを実装しなければなりません。
ECMAScriptの適合実装は、この仕様に記述されるものを超えて、追加の型、値、オブジェクト、プロパティ、および関数を提供しても構いません。特に、ECMAScriptの適合実装は、この仕様に記述されるオブジェクトについて、この仕様に記述されていないプロパティ、およびそれらのプロパティの値を提供しても構いません。
ECMAScriptの適合実装は、この仕様に記述されていないプログラムおよび正規表現の構文をサポートしても構いません。特に、ECMAScriptの適合実装は、この仕様の副節
ECMAScriptの適合実装は、副節
ECMAScriptの適合実装は、
ECMAScriptの適合実装は、別途示されない限り、Normative Optional副節を実装するか実装しないかを選択しても構いません。Web browsersは一般に、すべてのnormative optional副節を実装することが要求されます。（Annex
2.1 Normative Optional Clause Headingの例
clause内容の例。
ECMAScriptの適合実装は、Normative Optionalとしてもマークされている場合を除き、Legacy副節を実装しなければなりません。Legacy副節内で指定されるすべての言語機能および振る舞いは、1つ以上の望ましくない特性を持ちます。しかし、既存のアプリケーションにおける継続的な使用により、この仕様からそれらを削除することは妨げられています。これらの機能は、ECMAScript言語の中核部分とは見なされません。プログラマーは、新しいECMAScriptコードを書く際に、これらの機能および振る舞いを使用したり、それらの存在を仮定したりするべきではありません。
2.2 Legacy Clause Headingの例
clause内容の例。
2.3 Legacy Normative Optional Clause Headingの例
clause内容の例。
3 規範的参照
以下の参照文書は、この文書の適用に不可欠です。日付付き参照については、引用された版のみが適用されます。日付なし参照については、参照文書の最新版（すべての修正を含む）が適用されます。
The Unicode Standard.
https://unicode.org/versions/latest
ISO/IEC 10646, Information Technology — Universal Multiple-Octet Coded Character Set (UCS) plus Amendment 1:2005, Amendment 2:2006, Amendment 3:2008, Amendment 4:2008, and additional amendments and corrigenda, or successor.
ECMA-402, ECMAScript Internationalization API Specification, specifically the annual edition corresponding to this edition of this specification.
https://www.ecma-international.org/publications-and-standards/standards/ecma-402/
ECMA-404, The JSON Data Interchange Format.
https://www.ecma-international.org/publications-and-standards/standards/ecma-404/
4 概要
この節は、ECMAScript言語の非規範的な概要を含みます。
ECMAScriptは、
ECMAScriptはもともとスクリプト言語として使用されるよう設計されましたが、汎用プログラミング言語として広く使用されるようになりました。スクリプト言語とは、既存のシステムの機能を操作、カスタマイズ、および自動化するために使用されるプログラミング言語です。そのようなシステムでは、有用な機能がすでにユーザーインターフェイスを通じて利用可能であり、スクリプト言語はその機能をプログラム制御に公開するための仕組みです。このようにして、既存のシステムはオブジェクトと機能の
ECMAScriptはもともと、ブラウザー内のWebページを活性化し、Webベースのクライアントサーバーアーキテクチャの一部としてサーバー計算を実行する仕組みを提供する、Webスクリプト言語として設計されました。ECMAScriptは現在、さまざまな
ECMAScriptの使用は単純なスクリプティングを超え、現在では多くの異なる環境と規模におけるプログラミング作業の全範囲に使用されています。ECMAScriptの使用が拡大するにつれて、それが提供する特徴や機能も拡大してきました。ECMAScriptは現在、十分な機能を備えた汎用プログラミング言語です。
4.1 Webスクリプティング
Webブラウザーは、クライアント側計算のためのECMAScript
Webサーバーは、サーバー側計算のための異なる
ECMAScriptをサポートする各Webブラウザーおよびサーバーは、それぞれ独自の
4.2 ホストと実装
ECMAScriptを
実装とは、Annex
implementation-definedな機能とは、さらなる限定なしに、その定義を外部ソースに委ねるものです。この仕様は特定の振る舞いについていかなる推奨も行わず、適合実装はこの仕様によって課される制約の範囲内で任意の振る舞いを自由に選択できます。
implementation-approximatedな機能とは、理想的な振る舞いを推奨しつつ、その定義を外部ソースに委ねるものです。適合実装はこの仕様によって課される制約の範囲内で任意の振る舞いを自由に選択できますが、その理想に近づくよう努力することが推奨されます。Math.exp
ホストとは、Annex
ホストフックとは、全体または一部が外部ソースによって定義される抽象操作です。すべての
normal completion またはthrow completion のいずれかを返さなければなりません。
host-definedな機能とは、さらなる限定なしにその定義を外部ソースに委ね、Annex
ホスト環境とは、すべての
この仕様は、常に最も具体的な用語を使用するという編集上の慣例に従います。たとえば、ある機能が
4.3 ECMAScriptの概要
以下はECMAScriptの非公式な概要です — 言語のすべての部分が記述されているわけではありません。この概要は、標準本体の一部ではありません。
ECMAScriptはオブジェクトベースです。基本的な言語機能および
ECMAScriptは、ECMAScriptエンティティの定義を補完する組み込みオブジェクトの集合を定義します。これらの組み込みオブジェクトには、グローバルオブジェクト、Object、Function、Boolean、Symbol、およびさまざまなErrorオブジェクトを含む、言語のMath、Number、Dateを含む数値を表し操作するオブジェクト、テキスト処理オブジェクトであるStringとRegExp、Arrayおよび要素がすべて特定の数値データ表現を持つ9種類のTyped Arraysを含む値のindexed collectionsであるオブジェクト、MapおよびSetオブジェクトを含むkeyed collections、JSONオブジェクト、ArrayBuffer、SharedArrayBuffer、DataViewを含む構造化データをサポートするオブジェクト、generator functionsおよびPromiseオブジェクトを含む制御抽象化をサポートするオブジェクト、ならびにProxyとReflectを含むreflectionオブジェクトが含まれます。
ECMAScriptはまた、一連の組み込み演算子を定義します。ECMAScript演算子には、さまざまな単項演算、乗法演算子、加法演算子、ビットシフト演算子、関係演算子、等価演算子、二項ビット演算子、二項論理演算子、代入演算子、およびカンマ演算子が含まれます。
大規模なECMAScriptプログラムはモジュールによってサポートされます。モジュールにより、プログラムを複数の文および宣言の列へ分割できます。各モジュールは、自身が使用する宣言のうち他のモジュールによって提供される必要があるもの、および自身の宣言のうち他のモジュールから使用可能なものを明示的に識別します。
ECMAScriptの構文は意図的にJava構文に似ています。ECMAScriptの構文は、使いやすいスクリプト言語として機能できるよう緩やかにされています。たとえば、変数はその型を宣言する必要がなく、プロパティにも型は関連付けられず、定義された関数はそれらへの呼び出しより前にテキスト上で宣言が現れる必要もありません。
4.3.1 オブジェクト
ECMAScriptにはclass定義の構文が含まれているものの、ECMAScriptオブジェクトは、C++、Smalltalk、Javaにおけるもののように根本的にclassベースではありません。その代わり、オブジェクトは、リテラル記法やコンストラクターなど、さまざまな方法で作成できます。コンストラクターはオブジェクトを作成し、その後、それらのプロパティに初期値を代入することで、その全部または一部を初期化するコードを実行します。各コンストラクターは、new Date(2009, 11)は新しいDateオブジェクトを作成します。newを使用せずにコンストラクターを呼び出すと、コンストラクターに応じた結果になります。たとえば、Date()はオブジェクトではなく現在の日付と時刻の文字列表現を生成します。
コンストラクターによって作成されたすべてのオブジェクトは、そのコンストラクターの
classベースのオブジェクト指向言語では、一般に、状態はインスタンスによって担われ、メソッドはクラスによって担われ、継承は構造と振る舞いのみのものです。ECMAScriptでは、状態とメソッドはオブジェクトによって担われ、一方で構造、振る舞い、および状態はすべて継承されます。
自分自身では、プロトタイプが含む特定のプロパティを直接含まないすべてのオブジェクトは、そのプロパティとその値を共有します。図1はこれを示しています：
CFはコンストラクター（かつオブジェクト）です。new式を使用して5つのオブジェクトが作成されています：cf1、cf2、cf3、cf4、およびcf5です。これらの各オブジェクトは、
ほとんどのclassベースのオブジェクト言語とは異なり、プロパティは値を代入することによって動的にオブジェクトへ追加できます。つまり、コンストラクターは、構築されるオブジェクトのすべてまたはいずれかのプロパティを命名したり、それらに値を代入したりする必要はありません。上の図では、CFp内のプロパティに新しい値を代入することにより、cf1、cf2、cf3、cf4、およびcf5のための新しい共有プロパティを追加できます。
ECMAScriptオブジェクトは本質的にclassベースではありませんが、コンストラクター関数、プロトタイプオブジェクト、およびメソッドの共通パターンに基づくclass風の抽象化を定義することが便利な場合がよくあります。ECMAScriptの組み込みオブジェクト自体も、そのようなclass風のパターンに従います。ECMAScript 2015以降、ECMAScript言語には構文上のclass定義が含まれ、プログラマーは組み込みオブジェクトで使用される同じclass風抽象化パターンに適合するオブジェクトを簡潔に定義できます。
4.3.2 ECMAScriptのStrictバリアント
ECMAScript言語は、この言語の一部のユーザーが、言語で利用可能な一部の機能の使用を制限したいと望む可能性を認識しています。彼らは、セキュリティの利益のため、自分たちがエラーを起こしやすいと考える機能を避けるため、強化されたエラーチェックを得るため、またはその他の自ら選ぶ理由のために、そうするかもしれません。この可能性をサポートするため、ECMAScriptは言語のstrictバリアントを定義します。言語のstrictバリアントは、通常のECMAScript言語の特定の構文的および意味的機能を除外し、一部の機能の詳細な意味論を変更します。strictバリアントはまた、非strict形式の言語ではエラーとして指定されていない状況で、エラー例外をthrowすることによって報告されなければならない追加のエラー条件を指定します。
ECMAScriptのstrictバリアントは、一般に言語のstrict modeと呼ばれます。strict modeの選択、およびECMAScriptのstrict mode構文と意味論の使用は、
この仕様に適合するため、ECMAScript実装は、この仕様で定義される完全で無制限なECMAScript言語とECMAScript言語のstrictバリアントの双方を実装しなければなりません。さらに、実装は、無制限およびstrict modeのsource text unitを単一の複合プログラムへ組み合わせることをサポートしなければなりません。
4.4 用語と定義
この文書の目的のため、以下の用語および定義が適用されます。
4.4.1 implementation-approximated
4.4.2 implementation-defined
4.4.3 host-defined
編集上、節
4.4.4 type
節
4.4.5 primitive value
節
primitive valueは、言語実装の最下位レベルで直接表現されるデータです。
4.4.6 object
オブジェクトはプロパティの集合であり、単一のプロトタイプオブジェクトを持ちます。プロトタイプは
4.4.7 constructor
オブジェクトを作成し初期化する
コンストラクターの
4.4.8 prototype
他のオブジェクトに共有プロパティを提供するオブジェクト
コンストラクターがオブジェクトを作成すると、そのオブジェクトはプロパティ参照を解決する目的で、コンストラクターのconstructor.prototypeによって参照でき、オブジェクトのプロトタイプに追加されたプロパティは、継承を通じて、そのプロトタイプを共有するすべてのオブジェクトによって共有されます。あるいは、Object.create組み込み関数を使用して、明示的に指定されたプロトタイプを持つ新しいオブジェクトを作成することもできます。
4.4.9 ordinary object
すべてのオブジェクトがサポートしなければならないessential internal methodsについて、デフォルトの振る舞いを持つオブジェクト
4.4.10 exotic object
essential internal methodsの1つ以上について、デフォルトの振る舞いを持たないオブジェクト
4.4.11 standard object
その意味論がこの仕様によって定義されるオブジェクト
4.4.12 built-in object
ECMAScript実装によって指定され提供されるオブジェクト
標準built-in objectsはこの仕様で定義されます。ECMAScript実装は、追加の種類のbuilt-in objectsを指定し提供しても構いません。
4.4.13 undefined value
変数に値が代入されていないときに使用されるprimitive value
4.4.14 Undefined type
その唯一の値が
4.4.15 null value
任意のオブジェクト値の意図的な不在を表すprimitive value
4.4.16 Null type
その唯一の値が
4.4.17 Boolean value
Boolean値は
4.4.18 Boolean type
primitive valuesである
4.4.19 Boolean object
標準組み込みBooleanコンストラクターのインスタンスである
Boolean objectは、new式でBooleanコンストラクターを使用し、引数としてBoolean値を供給することで作成されます。結果のオブジェクトは、その値がBoolean値であるinternal slotを持ちます。Boolean objectはBoolean値へ強制変換できます。
4.4.20 String value
0個以上の16ビット符号なし整数値の有限順序列であるprimitive value
String valueは
4.4.21 String type
すべての可能なString valuesの集合
4.4.22 String object
標準組み込みStringコンストラクターのインスタンスである
String objectは、new式でStringコンストラクターを使用し、引数としてString値を供給することで作成されます。結果のオブジェクトは、その値がString値であるinternal slotを持ちます。String objectは、Stringコンストラクターを関数として呼び出すことでString値へ強制変換できます（
4.4.23 Number value
倍精度64ビットバイナリ形式の
Number valueは
4.4.24 Number type
4.4.25 Number object
標準組み込みNumberコンストラクターのインスタンスである
Number objectは、new式でNumberコンストラクターを使用し、引数としてNumber値を供給することで作成されます。結果のオブジェクトは、その値がNumber値であるinternal slotを持ちます。Number objectは、Numberコンストラクターを関数として呼び出すことでNumber値へ強制変換できます（
4.4.26 Infinity
正の無限Number値であるNumber value
4.4.27 NaN
4.4.28 BigInt value
任意精度整数値に対応するprimitive value
4.4.29 BigInt type
すべての可能なBigInt valuesの集合
4.4.30 BigInt object
標準組み込みBigIntコンストラクターのインスタンスである
4.4.31 Symbol value
一意で非StringのObject
4.4.32 Symbol type
すべての可能なSymbol valuesの集合
4.4.33 Symbol object
標準組み込みSymbolコンストラクターのインスタンスである
4.4.34 function
サブルーチンとして呼び出され得る
そのプロパティに加えて、関数は呼び出されたときにどのように振る舞うかを決定する実行可能コードと状態を含みます。関数のコードはECMAScriptで書かれている場合も、そうでない場合もあります。
4.4.35 built-in function
関数であるbuilt-in object
built-in functionsの例には、parseIntおよびMath.expが含まれます。
4.4.36 built-in constructor
コンストラクターであるbuilt-in function
built-in ObjectおよびFunctionが含まれます。
4.4.37 property
key（String値またはSymbol値のいずれか）と値を関連付けるオブジェクトの一部
プロパティの形式によって、値はデータ値（primitive value、オブジェクト、または
4.4.38 method
プロパティの値である関数
関数がオブジェクトのメソッドとして呼び出されると、そのオブジェクトは関数にその
4.4.39 built-in method
built-in functionであるメソッド
標準built-in methodsはこの仕様で定義されます。
4.4.40 attribute
プロパティの何らかの特性を定義する内部値
4.4.41 own property
そのオブジェクトによって直接含まれるプロパティ
4.4.42 inherited property
own propertyではないが、そのオブジェクトのプロトタイプのプロパティ（ownまたはinheritedのいずれか）であるオブジェクトのプロパティ
4.5 この仕様の構成
この仕様の残りは、以下のように構成されます：
Clause
Clauses
Clauses
Clauses
Clause
5 記法上の慣例
5.1 構文文法と字句文法
5.1.1 文脈自由文法
文脈自由文法は、いくつかの生成から構成されます。各生成は、その左辺として非終端記号と呼ばれる抽象記号を持ち、その右辺として0個以上の非終端記号および終端記号の列を持ちます。各文法について、終端記号は指定されたアルファベットから取られます。
chain productionとは、右辺にちょうど1つの非終端記号と0個以上の終端記号を持つ生成です。
goal symbolと呼ばれる単一の区別された非終端記号からなる文から始めて、与えられた文脈自由文法は言語、すなわち、列内の任意の非終端を、その非終端を左辺とする生成の右辺で繰り返し置き換えることによって得られる可能性のある終端記号列の（おそらく無限の）集合を指定します。
5.1.2 字句文法とRegExp文法
ECMAScriptの字句文法は、clause
white spaceおよびcomments以外の入力要素は、ECMAScriptの構文文法の終端記号を形成し、ECMAScript tokensと呼ばれます。これらのtokensは、ECMAScript言語の/*…*/という形式のcomment）も、line terminatorを含まない場合は同様に単に破棄されます。しかし、
ECMAScriptのRegExp文法は、
字句文法およびRegExp文法の生成は、区切り句読点として2つのコロン“::”を持つことで区別されます。字句文法とRegExp文法はいくつかの生成を共有します。
5.1.3 数値文字列文法
数値文字列文法は、
数値文字列文法の生成は、句読点として3つのコロン“:::”を持つことで区別され、source textの解析には決して使用されません。
5.1.4 構文文法
ECMAScriptの構文文法は、clauses
符号位置のストリームをECMAScript
解析が成功すると、それはparse tree、すなわち各ノードがParse Nodeである根付き木構造を構築します。各Parse Nodeは文法内の記号のインスタンスです。それは、その記号から導出できるsource textの範囲を表します。source text全体を表すparse treeのルートノードは、解析の
新しいParse Nodesは、parserの各呼び出しごとにインスタンス化され、同一のsource textの解析であっても、解析間で再利用されることはありません。Parse Nodesは、それらがsource textの同じ範囲を表し、同じ文法記号のインスタンスであり、同じparser呼び出しから得られた場合に限り、同じParse Nodeと見なされます。
同じStringを複数回解析すると、異なるParse Nodesが生じます。たとえば、次を考えてください：
let str = "1 + 1;";
eval(str);
eval(str);evalへの各呼び出しは、strの値を
構文文法の生成は、句読点として1つのコロン“:”だけを持つことで区別されます。
clauses
特定の場合には、曖昧さを避けるため、構文文法は有効なECMAScript
- もともとpに一致したtokensの列が、nを
goal symbol として再度解析されます。nが文法パラメーターを取る場合、それらはpがもともと解析されたときに使用されたものと同じ値に設定されます。 - tokensの列が、tokensを残すことなく、nの単一のインスタンスとして解析できる場合：
- そのnのインスタンス（与えられたpに対して一意なParse Node）を、“pによってcoveredされるn”と呼びます。
- nおよびその導出生成に対するすべてのEarly Error rulesも、pによってcoveredされるnに適用されます。
- それ以外（解析が失敗した場合）は、early Syntax Errorです。
5.1.5 文法記法
5.1.5.1 終端記号
ECMAScript文法において、一部の終端記号はfixed-widthフォントで示されます。これらはsource textに書かれたとおり正確に現れるものです。この方法で指定されるすべての終端記号符号位置は、他のUnicode範囲の似た見た目の符号位置ではなく、Basic Latinブロックからの適切なUnicode符号位置として理解されます。終端記号内の符号位置は、\
終端記号が個々のUnicode符号位置である文法（すなわち、字句文法、RegExp文法、および数値文字列文法）では、生成内に現れる複数のfixed-width符号位置の連続した並びは、独立した終端記号として書かれた同じ符号位置列の単純な省略形です。
たとえば、生成：
は、次の省略形です：
対照的に、構文文法では、fixed-width符号位置の連続した並びは単一の終端記号です。
終端記号には、他に2つの形式があります：
- 字句文法およびRegExp文法では、慣用的な印字表現を持たないUnicode符号位置は、代わりに“<ABBREV>”という形式で示されます。ここで“ABBREV”は、その符号位置または符号位置集合のためのニーモニックです。これらの形式は、
Unicode Format-Control Characters 、White Space 、およびLine Terminators で定義されます。 - 構文文法では、特定の終端記号（例：
IdentifierName およびRegularExpressionLiteral ）はイタリック体で示されます。これは、それらが字句文法内の同名の非終端を参照するためです。
5.1.5.2 非終端記号と生成
非終端記号はitalic体で示されます。非終端の定義（“production”とも呼ばれます）は、定義される非終端の名前の後に1つ以上のコロンを続けることで導入されます。（コロンの数は、その生成がどの文法に属するかを示します。）その後、非終端に対する1つ以上の代替右辺が続く行に示されます。たとえば、構文上の定義：
は、非終端while、左括弧token、
は、
5.1.5.3 任意記号
終端または非終端の後に現れることがある下付き接尾辞“opt”は、任意記号を示します。任意記号を含む代替は、実際には、任意要素を省略するものとそれを含むものの2つの右辺を指定します。これは、次が：
次の便利な省略形であることを意味します：
また、次が：
次の便利な省略形であることも意味します：
これはさらに次の省略形です：
したがって、この例では、非終端
5.1.5.4 文法パラメーター
生成は、その生成によって定義される非終端記号の接尾辞として現れることがある、“[parameters]”という形式の下付き注釈によってパラメーター化されても構いません。“parameters”は、単一の名前またはカンマ区切りの名前のリストのいずれかです。パラメーター化された生成は、パラメーター名のすべての組み合わせを定義する生成の集合の省略形であり、各パラメーター名にはアンダースコアが前置され、パラメーター化された非終端記号に追加されます。これは、次が：
次の便利な省略形であることを意味します：
また、次が：
次の省略形であることも意味します：
複数のパラメーターは組み合わせ的な数の生成を生み出しますが、そのすべてが完全な文法内で必ずしも参照されるわけではありません。
生成の右辺上の非終端への参照もパラメーター化できます。たとえば：
は、次のように言うことと等価です：
また：
は、次と等価です：
非終端参照は、パラメーターリストと“opt”接尾辞の双方を持つことができます。たとえば：
は、次の省略形です：
右辺の非終端参照でパラメーター名に“?”を前置すると、そのパラメーター値は現在の生成の左辺記号への参照におけるそのパラメーター名の出現に依存します。たとえば：
は、次の省略形です：
右辺の代替が“[+parameter]”で前置されている場合、その代替は、生成の非終端記号を参照する際にその名前付きパラメーターが使用された場合にのみ利用可能です。右辺の代替が“[~parameter]”で前置されている場合、その代替は、生成の非終端記号を参照する際にその名前付きパラメーターが使用されなかった場合にのみ利用可能です。これは、次が：
次の省略形であることを意味します：
また、次が：
次の省略形であることも意味します：
5.1.5.5 one of
文法定義内でコロンの後に“one of”という語が続く場合、それは後続の行または複数行上の終端記号の各々が代替定義であることを意味します。たとえば、ECMAScriptの字句文法には次の生成が含まれます：
これは単に次の便利な省略形です：
5.1.5.6 [empty]
“[empty]”という句が生成の右辺として現れる場合、それはその生成の右辺が終端も非終端も含まないことを示します。
5.1.5.7 先読み制約
“[lookahead = seq]”という句が生成の右辺に現れる場合、それは直後に続く入力token列のprefixがtoken列seqである場合にのみ、その生成を使用できることを示します。同様に、“[lookahead ∈ set]”は、setがtoken列の有限の非空集合である場合、直後に続くtoken列のprefixがsetのいずれかの要素である場合にのみ、その生成を使用できることを示します。便宜上、その集合は非終端として書くこともでき、その場合、それはその非終端が展開され得るすべてのtoken列の集合を表します。その非終端が無限に多くの異なるtoken列へ展開され得る場合、それは編集上の誤りと見なされます。
これらの条件は否定できます。“[lookahead ≠ seq]”は、含まれる生成が、seqが直後に続く入力token列のprefixでない場合にのみ使用できることを示し、“[lookahead ∉ set]”は、setのいずれの要素も直後に続くtoken列のprefixでない場合にのみ、その生成を使用できることを示します。
例として、次の定義が与えられた場合：
この定義：
は、文字nに続いて1個以上の10進数字があり、その最初のものが偶数であるもの、または、別の10進数字が後続しない10進数字のいずれかに一致します。
これらの句が構文文法で使用される場合、後続のtokensを決定するには後の位置でどの字句
5.1.5.8 [no LineTerminator here]
“[no
は、script内でthrow tokenと
5.1.5.9 but not
生成の右辺は、“but not”という句を使用し、その後に除外される展開を示すことで、特定の展開が許可されないことを指定できます。たとえば、生成：
は、非終端
5.1.5.10 説明句
最後に、いくつかの非終端記号は、すべての代替を列挙することが非実用的である場合に、sans-serif体の説明句によって記述されます：
5.2 アルゴリズムの慣例
この仕様は、アルゴリズムのステップを指定するために番号付きリストをよく使用します。これらのアルゴリズムは、ECMAScript言語構造の要求される意味論を正確に指定するために使用されます。これらのアルゴリズムは、特定の実装技法の使用を暗示することを意図していません。実際には、与えられた機能を実装するために、より効率的なアルゴリズムが利用可能である場合があります。
アルゴリズムは、順序付きのカンマ区切りのalias名の列によって明示的にパラメーター化されても構いません。これらのalias名は、アルゴリズムステップ内でその位置に渡されたargumentを参照するために使用できます。任意パラメーターは、周囲の角括弧（[ , name ]）で示され、アルゴリズムステップ内では必須パラメーターと何ら異なりません。restパラメーターは、leading ellipsis（, ...name）で示され、パラメーターリストの末尾に現れても構いません。restパラメーターは、必須および任意パラメーターの後に提供されたすべてのargumentsを
アルゴリズムステップは、順次的なサブステップへ細分化されても構いません。サブステップはインデントされ、それ自体もさらにインデントされたサブステップへ分割されても構いません。サブステップを識別するためにアウトライン番号付けの慣例が使用され、第一レベルのサブステップは小文字のアルファベット文字で、第二レベルのサブステップは小文字のローマ数字でラベル付けされます。3レベルを超える必要がある場合、これらの規則は繰り返され、第4レベルでは数値ラベルが使用されます。たとえば：
- トップレベルステップ
- サブステップ。
- サブステップ。
- サブサブステップ。
- サブサブサブステップ
- サブサブサブサブステップ
- サブサブサブサブサブステップ
- サブサブサブサブステップ
- サブサブサブステップ
- サブサブステップ。
ステップまたはサブステップは、そのサブステップを条件付ける“if”述語として書かれることがあります。この場合、サブステップは述語がtrueである場合にのみ適用されます。ステップまたはサブステップが“else”という語で始まる場合、それは同じレベルの直前の“if”述語ステップの否定である述語です。
ステップは、そのサブステップの反復適用を指定するために“For each”または“Repeat”で始まることがあります。
“Assert:”で始まるステップは、そのアルゴリズムの不変条件を表明します。そのような表明は、そうでなければ暗黙であるアルゴリズム上の不変条件を明示するために使用されます。同様に、“NOTE:”で始まるステップは、近くのステップに関する関連する文脈を提供します。Assertion stepsおよびnote stepsは厳密に情報提供であり、追加の意味的要件を加えないため、実装によってチェックされる必要はありません。
アルゴリズムステップは、“Let x be someValue”という形式を使用して任意の値に名前付きaliasを宣言できます。これらのaliasは、xとsomeValueの双方が同じ基礎データを参照し、どちらに対する変更も双方から見えるという点で参照のようなものです。この参照のような振る舞いを避けたいアルゴリズムステップは、右辺のコピーを明示的に作成するべきです：“Let x be a copy of someValue”はsomeValueの浅いコピーを作成します。
一度宣言されると、aliasは後続の任意のステップで参照できますが、aliasの宣言より前のステップから参照してはなりません。aliasは、“Set x to someOtherValue”という形式を使用して変更できます。
5.2.1 評価順序
複雑な式がアルゴリズムステップ内に現れる場合、それらは左から右、内側から外側の順序で評価されるものと理解されます。たとえば、ステップ
- A(B(), C.[[D]]) + E(F())を返す。
は次と等価です
- tmp1 をB()とする。
- tmp2 をC.[[D]]とする。
- tmp3 をA(tmp1, tmp2)とする。
- tmp4 をF()とする。
- tmp5 をE(tmp4)とする。
- tmp6 をtmp3 + tmp5とする。
- tmp6 を返す。
ここで、さまざまなtmpN aliasesは一時的なものであり、これらのステップ内でのみ見えます。
5.2.2 抽象操作
この仕様の複数の部分での使用を容易にするため、abstract operationsと呼ばれる一部のアルゴリズムは、名前付きで、パラメーター化された関数形式で書かれ、他のアルゴリズム内から名前によって参照できるようにされています。抽象操作は通常、OperationName(arg1, arg2)のような関数適用スタイルを使用して参照されます。一部の抽象操作は、class風の仕様抽象化のpolymorphically dispatched methodsとして扱われます。そのようなmethod風の抽象操作は通常、someValue.OperationName(arg1, arg2)のようなメソッド適用スタイルを使用して参照されます。
5.2.3 Syntax-Directed Operations
syntax-directed operationとは、名前付き操作であり、その定義はアルゴリズムから構成され、それぞれがECMAScript文法のいずれかの1つ以上の生成に関連付けられます。複数の代替定義を持つ生成は通常、各代替について別個のアルゴリズムを持ちます。アルゴリズムが文法生成に関連付けられる場合、それはその生成代替の終端および非終端記号を、あたかもアルゴリズムのパラメーターであるかのように参照できます。この方法で使用される場合、非終端記号は、source textを解析する際に一致した実際の代替定義を指します。文法生成またはそれから導出された
アルゴリズムが生成代替に関連付けられる場合、その代替は通常、“[ ]”文法注釈なしで示されます。そのような注釈は、その代替の構文認識にのみ影響するべきであり、その代替に関連付けられた意味論には影響しません。
Syntax-directed operationsは、以下のアルゴリズム内のステップ
- status を
SomeNonTerminal のSyntaxDirectedOperationとする。 - someParseNode を何らかのsource textのparseとする。
- someParseNode のSyntaxDirectedOperationを実行する。
- argument
"value" 付きでsomeParseNode のSyntaxDirectedOperationを実行する。
明示的に別途指定されない限り、すべての
しかし
Runtime Semantics:
5.2.4 Runtime Semantics
runtimeで呼び出されなければならない意味論を指定するアルゴリズムは、runtime semanticsと呼ばれます。Runtime semanticsは、
5.2.4.1 Completion ( completionRecord )
The abstract operation Completion takes argument completionRecord (a
Assert : completionRecord はCompletion Record である。- completionRecord を返す。
5.2.4.2 Throw
アルゴリズムステップにおいて、“throw”という語は、
- result.[[Error]] が
none でないなら、result.[[Error]]をthrowする。
は次と等価です
- result.[[Error]] が
none でないなら、ThrowCompletion (result.[[Error]])を返す。
特定の型の例外をthrowすると述べるアルゴリズムステップは、throwされるその型の例外を構築します。たとえば、
TypeError 例外をthrowする。
は次と等価です
ThrowCompletion (newly createdTypeError object)を返す。
5.2.4.3 Completion Recordsをアンラップするための省略形
Prefix “?”および“!”は、
- result を ? record とする。
は次と等価です
Assert : record はCompletion Record である。- record が
abrupt completion なら、record を返す。 - result をrecord.[[Value]]とする。
同様に、ステップ
- result を ! record とする。
は次と等価です
Assert : record はnormal completion である。- result をrecord.[[Value]]とする。
“?”または“!”が他の任意の文脈で使用される場合、この規則が適用できるようになるまで、まず
- AO(? Other())を実行する。
は次のように書き換えることができます
- tmp1 をOther()とする。
- tmp2 を ? tmp1 とする。
- AO(tmp2)を実行する。
これはさらに次のように展開されます
- tmp1 をOther()とする。
Assert : tmp1 はCompletion Record である。- tmp1 が
abrupt completion なら、tmp1 を返す。 - tmp2 をtmp1.[[Value]]とする。
- AO(tmp2)を実行する。
5.2.4.4 暗黙のNormal Completion
Completion 、NormalCompletion 、ThrowCompletion 、またはReturnCompletion を適用した結果が直接返される場合Completion Record を構築した結果が直接返される場合
true を返す。
は次のいずれとも同じ意味です
NormalCompletion (true )を返す。
または
- completion を
NormalCompletion (true )とする。 Completion (completion)を返す。
または
Completion Record { [[Type]]:normal , [[Value]]:true , [[Target]]:empty }を返す。
- ? completion を返す。
次の例は、
- completion を
NormalCompletion (true )とする。 - completion を返す。
5.2.5 Static Semantics
文脈自由文法は、入力要素のストリームが、評価され得る有効なECMAScript
Static Semantic Rulesには名前があり、通常はアルゴリズムを使用して定義されます。名前付きStatic Semantic Rulesは文法生成に関連付けられ、複数の代替定義を持つ生成は通常、適用可能な各名前付きstatic semantic ruleについて、各代替に対して別個のアルゴリズムを持ちます。
static semantic ruleの特別な種類は、Early Error Ruleです。
5.2.6 数学演算
この仕様は、以下の種類の数値を参照します：
- Mathematical values: デフォルトの数値型として使用される任意の実数。
- Extended mathematical values:
Mathematical values に+∞および-∞を加えたもの。 - Numbers:
IEEE 754-2019 binary64（二倍精度浮動小数点）値。 - BigInts: 任意の整数を一対一対応で表す
ECMAScript言語値 。
この仕様の言語では、数値は下付き接尾辞を使用して異なる数値種別の間で区別されます。下付き文字𝔽はNumbersを指し、下付き文字ℤはBigIntsを指します。下付き接尾辞のない数値は
一般に、この仕様が“the length of y”や“the
この仕様でintegerという用語が使用される場合、別途述べられない限り、それは整数の集合に属する
+, ×, =, ≥などの数値演算子は、オペランドの型によって決定されるそれらの演算を指します。
数学関数
数学関数
数学関数
記法“
“the result of clamping x between lower and upper”という句（ここでx は
数学関数
数学関数
数学関数
下限a から上限b までのintervalは、同じ数値型の数値の、無限であり得る、空であり得る集合です。各境界はinclusiveまたはexclusiveのいずれかとして記述されますが、両方ではありません。
- a（inclusive）からb（inclusive）までの
interval 、別名inclusive interval from a to bは、同じ数値型のすべての値x であって a ≤ x ≤ bを満たすものを含み、それ以外を含みません。 - a（inclusive）からb（exclusive）までの
interval は、同じ数値型のすべての値x であって a ≤ x < bを満たすものを含み、それ以外を含みません。 - a（exclusive）からb（inclusive）までの
interval は、同じ数値型のすべての値x であって a < x ≤ bを満たすものを含み、それ以外を含みません。 - a（exclusive）からb（exclusive）までの
interval は、同じ数値型のすべての値x であって a < x < bを満たすものを含み、それ以外を含みません。
たとえば、1（inclusive）から2（exclusive）までの
5.2.7 値記法
この仕様では、Function.prototype.applyやlet n = 42;などの
5.2.8 同一性
この仕様では、仕様値と
この仕様の観点から、2つの値を等価性について比較するために、“If bool is
ECMAScript言語の観点から、言語値は
仕様値について、specification identityを持たない値の例には、
Specification identityは、
6 ECMAScriptのデータ型と値
この仕様内のアルゴリズムは、それぞれに関連付けられた型を持つ値を操作します。可能な値の型は、この節で定義されるものに正確に限られます。型はさらに
6.1 ECMAScript言語型
ECMAScript言語型は、ECMAScriptプログラマーがECMAScript言語を使用して直接操作する値に対応します。ECMAScript言語型はUndefined、Null、Boolean、String、Symbol、Number、BigInt、およびObjectです。ECMAScript言語値とは、ECMAScript言語型によって特徴付けられる値です。
6.1.1 Undefined型
Undefined型は、
6.1.2 Null型
Null型は、
6.1.3 Boolean型
Boolean型は、
6.1.4 String型
String型は、最大長253 - 1要素までの、0個以上の16ビット符号なし整数値（“要素”）のすべての順序列の集合です。String型は一般に、実行中のECMAScriptプログラム内でテキストデータを表すために使用され、その場合、String内の各要素はUTF-16コード単位値として扱われます。各要素は、その列内の位置を占めるものと見なされます。これらの位置は非負整数でインデックス付けされます。最初の要素（存在する場合）はindex 0にあり、次の要素（存在する場合）はindex 1にあり、以下同様です。Stringの長さは、その中の要素（すなわち16ビット値）の数です。空のStringは長さ0であり、したがって要素を含みません。
Stringの内容を解釈しないECMAScript操作は、それ以上の意味論を適用しません。String値を解釈する操作は、各要素を単一のUTF-16コード単位として扱います。しかし、ECMAScriptはこれらのコード単位の値や相互関係を制限しないため、Stringの内容をUTF-16でエンコードされたUnicode符号位置列としてさらに解釈する操作は、不正な部分列を考慮しなければなりません。そのような操作は、0xD800から0xDBFFまでの包含区間内の数値を持つすべてのコード単位（Unicode Standardによってleading surrogate、またはより正式にはhigh-surrogate code unitとして定義される）と、0xDC00から0xDFFFまでの包含区間内の数値を持つすべてのコード単位（trailing surrogate、またはより正式にはlow-surrogate code unitとして定義される）に対して、以下の規則を使用して特別な扱いを適用します：
-
leading surrogate でもtrailing surrogate でもないコード単位は、同じ値を持つ符号位置として解釈されます。 -
2つのコード単位の列であって、最初のコード単位c1が
leading surrogate であり、2番目のコード単位c2がtrailing surrogate であるものは、surrogate pairであり、値(c1 - 0xD800) × 0x400 + (c2 - 0xDC00) + 0x10000を持つ符号位置として解釈されます。（11.1.3 を参照） -
leading surrogate またはtrailing surrogate であるが、surrogate pair の一部ではないコード単位は、同じ値を持つ符号位置として解釈されます。
関数String.prototype.normalize（String.prototype.localeCompare（
この設計の根拠は、Stringsの実装を可能な限り単純かつ高性能に保つことでした。
この仕様では、“A, B, ...のstring-concatenation”（各argumentがString値、コード単位、またはコード単位列である場合）という句は、各argumentのコード単位（順序どおり）の連結（順序どおり）であるコード単位列を持つString値を表します。
“inclusiveStartからexclusiveEndまでのstringのsubstring”（stringがString値またはコード単位列であり、inclusiveStartおよびexclusiveEndが整数である場合）という句は、index inclusiveStartから始まりindex exclusiveEndの直前で終わる、stringの連続するコード単位からなるString値を表します（inclusiveStart = exclusiveEndの場合は空のString）。"to"接尾辞が省略された場合、stringの長さがexclusiveEndの値として使用されます。
“the ASCII word characters”という句は、Unicode Basic Latinブロック内のすべての文字および数字にU+005F（LOW LINE）を加えたもののみからなる、以下のString値を表します：
歴史的な理由により、これはさまざまなアルゴリズムにおいて重要性を持ちます。
6.1.4.1 StringIndexOf ( string, searchValue, fromIndex )
The abstract operation StringIndexOf takes arguments string (a String), searchValue (a String), and fromIndex (a non-negative
- lengthをstringの長さとする。
- searchValueが空のStringであり、fromIndex ≤ lengthなら、fromIndexを返す。
- searchLengthをsearchValueの長さとする。
- fromIndex ≤ i ≤ length - searchLengthである各整数iについて、昇順で、以下を行う
- candidateをstringのiからi + searchLengthまでの
substring とする。 - candidateがsearchValueなら、iを返す。
- candidateをstringのiからi + searchLengthまでの
not-found を返す。
searchValueが空のStringであり、fromIndex ≤ stringの長さである場合、このアルゴリズムはfromIndexを返します。空のStringは、最後のコード単位の後を含め、文字列内のすべての位置で実質的に見つかります。
このアルゴリズムは、fromIndex + searchValueの長さ > stringの長さである場合、常に
6.1.4.2 StringLastIndexOf ( string, searchValue, fromIndex )
The abstract operation StringLastIndexOf takes arguments string (a String), searchValue (a String), and fromIndex (a non-negative
searchValueが空のStringである場合、このアルゴリズムはfromIndexを返します。空のStringは、最後のコード単位の後を含め、文字列内のすべての位置で実質的に見つかります。
6.1.5 Symbol型
Symbol型は、Objectプロパティのキーとして使用できるすべての非String値の集合です（
各Symbolは一意で不変です。
各Symbolは不変の[[Description]] internal slotを持ち、その値はStringまたは
6.1.5.1 Well-Known Symbols
well-known symbolsは、この仕様のアルゴリズムによって明示的に参照される組み込みSymbol値です。それらは通常、仕様アルゴリズムの拡張点として機能する値を持つプロパティのキーとして使用されます。別途指定されない限り、well-known symbols値はすべての
この仕様内では、well-known symbolは、
%Symbol.name%を使用する箇所に@@nameという形式の記法を使用していました。特に、以下の名前が使用されていました：@@asyncIterator、@@hasInstance、@@isConcatSpreadable、@@| 仕様名 | [[Description]] | 値と目的 |
|---|---|---|
| %Symbol.asyncDispose% |
|
オブジェクト上で非同期にリソースのクリーンアップを実行するメソッド。それを含むスコープの評価が完了したときに、AsyncDisposableStack オブジェクトおよび await using 宣言によって呼び出される。
|
| %Symbol.asyncIterator% |
|
オブジェクトのデフォルト非同期イテレータを返すメソッド。for-await-of 文のセマンティクスによって呼び出される。
|
| %Symbol.dispose% |
|
オブジェクト上で明示的なリソースのクリーンアップを実行するメソッド。それを含むスコープの評価が完了したときに、DisposableStack オブジェクト、AsyncDisposableStack オブジェクト、および using 宣言によって呼び出される。
|
| %Symbol.hasInstance% |
|
コンストラクタオブジェクトが、あるオブジェクトをそのコンストラクタのインスタンスの1つとして認識するかどうかを判定するメソッド。instanceof 演算子のセマンティクスによって呼び出される。
|
| %Symbol.isConcatSpreadable% |
|
true の場合、オブジェクトが Array.prototype.concat |
| %Symbol.iterator% |
|
オブジェクトのデフォルトイテレータを返すメソッド。for-of 文のセマンティクスによって呼び出される。 |
| %Symbol.match% |
|
正規表現を文字列に照合する正規表現メソッド。String.prototype.match |
| %Symbol.matchAll% |
|
文字列に対する正規表現の一致を yield するイテレータを返す正規表現メソッド。String.prototype.matchAll |
| %Symbol.replace% |
|
文字列の一致した部分文字列を置換する正規表現メソッド。String.prototype.replace |
| %Symbol.search% |
|
正規表現に一致する文字列内のインデックスを返す正規表現メソッド。String.prototype.search |
| %Symbol.species% |
|
派生オブジェクトを作成するために使用されるコンストラクタ関数である、関数値のプロパティ。 |
| %Symbol.split% |
|
正規表現に一致するインデックスで文字列を分割する正規表現メソッド。String.prototype.split |
| %Symbol.toPrimitive% |
|
オブジェクトを対応するプリミティブ値へ変換するメソッド。 |
| %Symbol.toStringTag% |
|
オブジェクトのデフォルトの文字列表現を作成する際に使用される String 値のプロパティ。組み込みメソッド Object.prototype.toString |
| %Symbol.unscopables% |
|
自身および継承されたプロパティ名が、関連付けられたオブジェクトの with 環境束縛から除外されるプロパティ名である、オブジェクト値のプロパティ。
|
6.1.6 数値型
ECMAScriptには2つの組み込み数値型、NumberとBigIntがあります。以下の抽象操作は、これらの数値型上で定義されます。“Result”列は戻り型を示し、その操作の一部の呼び出しが
数値型は一般に、精度の損失や切り捨てなしには変換できないため、ECMAScript言語はこれらの型間の暗黙変換を提供しません。プログラマーは、別の型を必要とする関数を呼び出すとき、型間で変換するためにNumberおよびBigInt関数を明示的に呼び出さなければなりません。
ECMAScriptの第1版およびその後の版は、特定の演算子について、精度を失ったり切り捨てたりする可能性のある暗黙の数値変換を提供してきました。これらのlegacy implicit conversionsは後方互換性のために維持されていますが、プログラマーのエラーの機会を最小化し、将来の版における一般化されたvalue typesの選択肢を残すため、BigIntには提供されません。
6.1.6.1 Number型
Number型は、正確に18,437,736,874,454,810,627個（すなわちNaNによって生成されることに注意してください。）一部の実装では、外部コードがさまざまなNaN値の違いを検出できる場合がありますが、そのような振る舞いは
他に2つの特別な値があり、+Infinity（または単にInfinity）および-Infinityによって生成されることに注意してください。）
その他の18,437,736,874,454,810,624個（すなわち
+0（または単に0）および-0によって生成されることに注意してください。）
18,437,736,874,454,810,622個（すなわち
そのうち18,428,729,675,200,069,632個（すなわち
ここでsは1または-1、mは252（inclusive）から253（exclusive）までの
残りの9,007,199,254,740,990個（すなわち
ここでsは1または-1、mは0（exclusive）から252（exclusive）までの
大きさが253以下であるすべての正および負の
有限数は、非ゼロであり、それを表現するために使用される
この仕様では、“xのNumber value for”という句は、xが正確な実数数学量（πのような無理数であってもよい）を表す場合、以下の方法で選ばれたNumber値を意味します。Number型のすべての
+∞のNumber valueは
一部のECMAScript演算子は、
6.1.6.1.1 Number::unaryMinus ( number )
The abstract operation Number::unaryMinus takes argument number (a Number) and returns a Number. It performs the following steps when called:
- numberが
NaN なら、NaN を返す。 - numberの否定を返す。すなわち、同じ大きさで反対の符号を持つNumberを計算する。
6.1.6.1.2 Number::bitwiseNOT ( number )
The abstract operation Number::bitwiseNOT takes argument number (a Number) and returns an
- oldValueを !
ToInt32 (number) とする。 - oldValueのビットごとの補数を返す。結果の
mathematical value は32ビットtwo's complement bit stringとして正確に表現可能です。
6.1.6.1.3 Number::exponentiate ( base, exponent )
The abstract operation Number::exponentiate takes arguments base (a Number) and exponent (a Number) and returns a Number. これはbaseをexponent乗した結果を表す
- exponentが
NaN なら、NaN を返す。 - exponentが
+0 𝔽または-0 𝔽のいずれかなら、1 𝔽を返す。 - baseが
NaN なら、NaN を返す。 - baseが
+∞ 𝔽なら、- exponent >
+0 𝔽なら、+∞ 𝔽を返す。 +0 𝔽を返す。
- exponent >
- baseが
-∞ 𝔽なら、- exponent >
+0 𝔽なら、- exponentがodd
integral Number なら、-∞ 𝔽を返す。 +∞ 𝔽を返す。
- exponentがodd
- exponentがodd
integral Number なら、-0 𝔽を返す。 +0 𝔽を返す。
- exponent >
- baseが
+0 𝔽なら、- exponent >
+0 𝔽なら、+0 𝔽を返す。 +∞ 𝔽を返す。
- exponent >
- baseが
-0 𝔽なら、- exponent >
+0 𝔽なら、- exponentがodd
integral Number なら、-0 𝔽を返す。 +0 𝔽を返す。
- exponentがodd
- exponentがodd
integral Number なら、-∞ 𝔽を返す。 +∞ 𝔽を返す。
- exponent >
Assert : baseはfinite であり、+0 𝔽でも-0 𝔽でもない。- exponentが
+∞ 𝔽なら、 - exponentが
-∞ 𝔽なら、 Assert : exponentはfinite であり、+0 𝔽でも-0 𝔽でもない。- base <
-0 𝔽かつexponentがintegral Number でないなら、NaN を返す。 ℝ (base)をℝ (exponent)乗した結果を表すimplementation-approximated なNumber値を返す。
baseが** exponentの結果は、
6.1.6.1.4 Number::multiply ( x, y )
The abstract operation Number::multiply takes arguments x (a Number) and y (a Number) and returns a Number.
有限精度の乗算は可換ですが、常に結合的であるとは限りません。
6.1.6.1.5 Number::divide ( x, y )
The abstract operation Number::divide takes arguments x (a Number) and y (a Number) and returns a Number.
- xが
NaN またはyがNaN なら、NaN を返す。 - xが
+∞ 𝔽または-∞ 𝔽のいずれかなら、- yが
+∞ 𝔽または-∞ 𝔽のいずれかなら、NaN を返す。 - yが
+0 𝔽またはy >+0 𝔽なら、xを返す。 - -xを返す。
- yが
- yが
+∞ 𝔽なら、- xが
+0 𝔽またはx >+0 𝔽なら、+0 𝔽を返す。 -0 𝔽を返す。
- xが
- yが
-∞ 𝔽なら、- xが
+0 𝔽またはx >+0 𝔽なら、-0 𝔽を返す。 +0 𝔽を返す。
- xが
- xが
+0 𝔽または-0 𝔽のいずれかなら、- yが
+0 𝔽または-0 𝔽のいずれかなら、NaN を返す。 - y >
+0 𝔽なら、xを返す。 - -xを返す。
- yが
- yが
+0 𝔽なら、- x >
+0 𝔽なら、+∞ 𝔽を返す。 -∞ 𝔽を返す。
- x >
- yが
-0 𝔽なら、- x >
+0 𝔽なら、-∞ 𝔽を返す。 +∞ 𝔽を返す。
- x >
𝔽 (ℝ (x) /ℝ (y))を返す。
6.1.6.1.6 Number::remainder ( numerator, denominator )
The abstract operation Number::remainder takes arguments numerator (a Number) and denominator (a Number) and returns a Number. numeratorをdividend、denominatorをdivisorとする、そのオペランドの暗黙の除算からremainderを生成します。 It performs the following steps when called:
- numeratorが
NaN またはdenominatorがNaN なら、NaN を返す。 - numeratorが
+∞ 𝔽または-∞ 𝔽のいずれかなら、NaN を返す。 - denominatorが
+∞ 𝔽または-∞ 𝔽のいずれかなら、numeratorを返す。 - denominatorが
+0 𝔽または-0 𝔽のいずれかなら、NaN を返す。 - numeratorが
+0 𝔽または-0 𝔽のいずれかなら、numeratorを返す。 Assert : numeratorとdenominatorはfinite かつnon-zeroである。- quotientを
ℝ (numerator) /ℝ (denominator)とする。 - truncatedQuotientを
truncate (quotient)とする。 - remainderを
ℝ (numerator) - (ℝ (denominator) × truncatedQuotient)とする。 - remainder = 0かつnumerator <
-0 𝔽なら、-0 𝔽を返す。 𝔽 (remainder)を返す。
CおよびC++では、remainder演算子はintegral operandsのみを受け入れます。ECMAScriptでは、floating-point operandsも受け入れます。
%演算子によって計算されるfloating-point remainder操作の結果は、%を、Javaの6.1.6.1.7 Number::add ( x, y )
The abstract operation Number::add takes arguments x (a Number) and y (a Number) and returns a Number.
有限精度の加算は可換ですが、常に結合的であるとは限りません。
6.1.6.1.8 Number::subtract ( x, y )
The abstract operation Number::subtract takes arguments x (a Number) and y (a Number) and returns a Number. 減算を実行し、そのオペランドの差を生成します。xはminuendであり、yはsubtrahendです。 It performs the following steps when called:
Number::add (x,Number::unaryMinus (y))を返す。
x - yは常にx + (-y)と同じ結果を生成します。
6.1.6.1.9 Number::leftShift ( x, y )
The abstract operation Number::leftShift takes arguments x (a Number) and y (a Number) and returns an
- leftNumberを !
ToInt32 (x) とする。 - rightNumberを !
ToUint32 (y) とする。 - shiftCountを
ℝ (rightNumber)modulo 32とする。 - leftNumberをshiftCountビット左シフトした結果を返す。結果の
mathematical value は32ビットtwo's complement bit stringとして正確に表現可能です。
6.1.6.1.10 Number::signedRightShift ( x, y )
The abstract operation Number::signedRightShift takes arguments x (a Number) and y (a Number) and returns an
- leftNumberを !
ToInt32 (x) とする。 - rightNumberを !
ToUint32 (y) とする。 - shiftCountを
ℝ (rightNumber)modulo 32とする。 - leftNumberをshiftCountビットだけsign-extending right shiftした結果を返す。最上位ビットが伝播されます。結果の
mathematical value は32ビットtwo's complement bit stringとして正確に表現可能です。
6.1.6.1.11 Number::unsignedRightShift ( x, y )
The abstract operation Number::unsignedRightShift takes arguments x (a Number) and y (a Number) and returns an
- leftNumberを !
ToUint32 (x) とする。 - rightNumberを !
ToUint32 (y) とする。 - shiftCountを
ℝ (rightNumber)modulo 32とする。 - leftNumberをshiftCountビットだけzero-filling right shiftした結果を返す。空いたビットはゼロで埋められます。結果の
mathematical value は32ビットunsigned bit stringとして正確に表現可能です。
6.1.6.1.12 Number::lessThan ( x, y )
The abstract operation Number::lessThan takes arguments x (a Number) and y (a Number) and returns a Boolean or
6.1.6.1.13 Number::equal ( x, y )
The abstract operation Number::equal takes arguments x (a Number) and y (a Number) and returns a Boolean. It performs the following steps when called:
- xが
NaN なら、false を返す。 - yが
NaN なら、false を返す。 - xがyなら、
true を返す。 - xが
+0 𝔽かつyが-0 𝔽なら、true を返す。 - xが
-0 𝔽かつyが+0 𝔽なら、true を返す。 false を返す。
6.1.6.1.14 Number::sameValue ( x, y )
The abstract operation Number::sameValue takes arguments x (a Number) and y (a Number) and returns a Boolean. It performs the following steps when called:
- xが
NaN かつyがNaN なら、true を返す。 - xが
+0 𝔽かつyが-0 𝔽なら、false を返す。 - xが
-0 𝔽かつyが+0 𝔽なら、false を返す。 - xがyなら、
true を返す。 false を返す。
6.1.6.1.15 Number::sameValueZero ( x, y )
The abstract operation Number::sameValueZero takes arguments x (a Number) and y (a Number) and returns a Boolean. It performs the following steps when called:
- xが
NaN かつyがNaN なら、true を返す。 - xが
+0 𝔽かつyが-0 𝔽なら、true を返す。 - xが
-0 𝔽かつyが+0 𝔽なら、true を返す。 - xがyなら、
true を返す。 false を返す。
6.1.6.1.16 NumberBitwiseOp ( op, x, y )
The abstract operation NumberBitwiseOp takes arguments op (&, ^, or |), x (a Number), and y (a Number) and returns an
- leftNumberを !
ToInt32 (x) とする。 - rightNumberを !
ToInt32 (y) とする。 - leftBitsを
ℝ (leftNumber)を表す32ビットtwo's complement bit stringとする。 - rightBitsを
ℝ (rightNumber)を表す32ビットtwo's complement bit stringとする。 - opが
&なら、- resultをleftBitsおよびrightBitsにbitwise AND操作を適用した結果とする。
- そうでなく、opが
^なら、- resultをleftBitsおよびrightBitsにbitwise exclusive OR（XOR）操作を適用した結果とする。
- そうでなければ、
Assert : opは|である。- resultをleftBitsおよびrightBitsにbitwise inclusive OR操作を適用した結果とする。
- 32ビットtwo's complement bit string resultによって表される
integer のNumber valueを返す。
6.1.6.1.17 Number::bitwiseAND ( x, y )
The abstract operation Number::bitwiseAND takes arguments x (a Number) and y (a Number) and returns an
NumberBitwiseOp (&, x, y)を返す。
6.1.6.1.18 Number::bitwiseXOR ( x, y )
The abstract operation Number::bitwiseXOR takes arguments x (a Number) and y (a Number) and returns an
NumberBitwiseOp (^, x, y)を返す。
6.1.6.1.19 Number::bitwiseOR ( x, y )
The abstract operation Number::bitwiseOR takes arguments x (a Number) and y (a Number) and returns an
NumberBitwiseOp (|, x, y)を返す。
6.1.6.1.20 Number::toString ( x, radix )
The abstract operation Number::toString takes arguments x (a Number) and radix (an
- xが
NaN なら、"NaN" を返す。 - xが
+0 𝔽または-0 𝔽のいずれかなら、"0" を返す。 - x <
-0 𝔽なら、"-" とNumber::toString (-x, radix)のstring-concatenation を返す。 - xが
+∞ 𝔽なら、"Infinity" を返す。 - n、k、およびsを、k ≥ 1、radixk - 1 ≤ s < radixk、
𝔽 (s × radixn - k) がxであり、かつkが可能な限り小さいようなintegers とする。kはradixを用いるsの表現内のdigitsの数であり、sはradixで割り切れず、sの最下位digitはこれらの基準によって必ずしも一意に決定されないことに注意。 - radix ≠ 10またはnが-5から21までの包含区間内にあるなら、
- n ≥ kなら、
- 以下の
string-concatenation を返す：- radixを使用するsの表現のk個のdigitsのコード単位
- コード単位0x0030（DIGIT ZERO）のn - k回の出現
- 以下の
- n > 0なら、
- 以下の
string-concatenation を返す：- radixを使用するsの表現の最上位n個のdigitsのコード単位
- コード単位0x002E（FULL STOP）
- radixを使用するsの表現の残りのk - n個のdigitsのコード単位
- 以下の
Assert : n ≤ 0。- 以下の
string-concatenation を返す：- コード単位0x0030（DIGIT ZERO）
- コード単位0x002E（FULL STOP）
- コード単位0x0030（DIGIT ZERO）の-n回の出現
- radixを使用するsの表現のk個のdigitsのコード単位
- n ≥ kなら、
NOTE : この場合、入力は1.2e+3のような科学的E記法を使用して表されます。Assert : radixは10である。- n < 0なら、
- exponentSignをコード単位0x002D（HYPHEN-MINUS）とする。
- そうでなければ、
- exponentSignをコード単位0x002B（PLUS SIGN）とする。
- k = 1なら、
- 以下の
string-concatenation を返す：- sの単一digitのコード単位
- コード単位0x0065（LATIN SMALL LETTER E）
- exponentSign
abs (n - 1)の10進表現のコード単位
- 以下の
- 以下の
string-concatenation を返す：- sの10進表現の最上位digitのコード単位
- コード単位0x002E（FULL STOP）
- sの10進表現の残りのk - 1個のdigitsのコード単位
- コード単位0x0065（LATIN SMALL LETTER E）
- exponentSign
abs (n - 1)の10進表現のコード単位
ECMAScriptの実装者は、floating-point numbersのbinary-to-decimal変換についてDavid M. Gayが書いた論文およびコードを有用と感じるかもしれません：
Gay, David M. Correctly Rounded Binary-Decimal and Decimal-Binary Conversions. Numerical Analysis, Manuscript 90-10. AT&T Bell Laboratories (Murray Hill, New Jersey). 30 November 1990. Available as
https://ampl.com/_archive/first-website/REFS/rounding.pdf. Associated code available as
http://netlib.sandia.gov/fp/dtoa.c and as
http://netlib.sandia.gov/fp/g_fmt.c and may also be found at the various netlib mirror sites.
6.1.6.2 BigInt型
BigInt型は
6.1.6.2.1 BigInt::unaryMinus ( bigint )
The abstract operation BigInt::unaryMinus takes argument bigint (a BigInt) and returns a BigInt. It performs the following steps when called:
- bigint =
0 ℤなら、0 ℤを返す。 - -bigintを返す。
6.1.6.2.2 BigInt::bitwiseNOT ( bigint )
The abstract operation BigInt::bitwiseNOT takes argument bigint (a BigInt) and returns a BigInt. bigintのone's complementを返します。 It performs the following steps when called:
- -bigint -
1 ℤを返す。
6.1.6.2.3 BigInt::exponentiate ( base, exponent )
The abstract operation BigInt::exponentiate takes arguments base (a BigInt) and exponent (a BigInt) and returns either a
- exponent <
0 ℤなら、RangeError 例外をthrowする。 - base =
0 ℤかつexponent =0 ℤなら、1 ℤを返す。 - baseをexponent乗したものを返す。
6.1.6.2.4 BigInt::multiply ( x, y )
The abstract operation BigInt::multiply takes arguments x (a BigInt) and y (a BigInt) and returns a BigInt. It performs the following steps when called:
- x × yを返す。
6.1.6.2.5 BigInt::divide ( x, y )
The abstract operation BigInt::divide takes arguments x (a BigInt) and y (a BigInt) and returns either a
6.1.6.2.6 BigInt::remainder ( numerator, denominator )
The abstract operation BigInt::remainder takes arguments numerator (a BigInt) and denominator (a BigInt) and returns either a
6.1.6.2.7 BigInt::add ( x, y )
The abstract operation BigInt::add takes arguments x (a BigInt) and y (a BigInt) and returns a BigInt. It performs the following steps when called:
- x + yを返す。
6.1.6.2.8 BigInt::subtract ( x, y )
The abstract operation BigInt::subtract takes arguments x (a BigInt) and y (a BigInt) and returns a BigInt. It performs the following steps when called:
- x - yを返す。
6.1.6.2.9 BigInt::leftShift ( x, y )
The abstract operation BigInt::leftShift takes arguments x (a BigInt) and y (a BigInt) and returns a BigInt. It performs the following steps when called:
6.1.6.2.10 BigInt::signedRightShift ( x, y )
The abstract operation BigInt::signedRightShift takes arguments x (a BigInt) and y (a BigInt) and returns a BigInt. It performs the following steps when called:
BigInt::leftShift (x, -y)を返す。
6.1.6.2.11 BigInt::unsignedRightShift ( x, y )
The abstract operation BigInt::unsignedRightShift takes arguments x (a BigInt) and y (a BigInt) and returns a
TypeError 例外をthrowする。
6.1.6.2.12 BigInt::lessThan ( x, y )
The abstract operation BigInt::lessThan takes arguments x (a BigInt) and y (a BigInt) and returns a Boolean. It performs the following steps when called:
6.1.6.2.13 BigInt::equal ( x, y )
The abstract operation BigInt::equal takes arguments x (a BigInt) and y (a BigInt) and returns a Boolean. It performs the following steps when called:
6.1.6.2.14 BinaryAnd ( x, y )
The abstract operation BinaryAnd takes arguments x (0 or 1) and y (0 or 1) and returns 0 or 1. It performs the following steps when called:
- x = 1かつy = 1なら、1を返す。
- 0を返す。
6.1.6.2.15 BinaryOr ( x, y )
The abstract operation BinaryOr takes arguments x (0 or 1) and y (0 or 1) and returns 0 or 1. It performs the following steps when called:
- x = 1またはy = 1なら、1を返す。
- 0を返す。
6.1.6.2.16 BinaryXor ( x, y )
The abstract operation BinaryXor takes arguments x (0 or 1) and y (0 or 1) and returns 0 or 1. It performs the following steps when called:
- x = 1かつy = 0なら、1を返す。
- x = 0かつy = 1なら、1を返す。
- 0を返す。
6.1.6.2.17 BigIntBitwiseOp ( op, x, y )
The abstract operation BigIntBitwiseOp takes arguments op (&, ^, or |), x (a BigInt), and y (a BigInt) and returns a BigInt. It performs the following steps when called:
- xを
ℝ (x)に設定する。 - yを
ℝ (y)に設定する。 - resultを0とする。
- shiftを0とする。
- (x = 0またはx = -1)かつ(y = 0またはy = -1)になるまで、繰り返す
- opが
&なら、 - そうでなく、opが
|なら、 - そうでなければ、
- signBit ≠ 0なら、
- resultをresult - 2shiftに設定する。
NOTE : これは符号を拡張します。
- resultのBigInt valueを返す。
6.1.6.2.18 BigInt::bitwiseAND ( x, y )
The abstract operation BigInt::bitwiseAND takes arguments x (a BigInt) and y (a BigInt) and returns a BigInt. It performs the following steps when called:
BigIntBitwiseOp (&, x, y)を返す。
6.1.6.2.19 BigInt::bitwiseXOR ( x, y )
The abstract operation BigInt::bitwiseXOR takes arguments x (a BigInt) and y (a BigInt) and returns a BigInt. It performs the following steps when called:
BigIntBitwiseOp (^, x, y)を返す。
6.1.6.2.20 BigInt::bitwiseOR ( x, y )
The abstract operation BigInt::bitwiseOR takes arguments x (a BigInt) and y (a BigInt) and returns a BigInt. It performs the following steps when called:
BigIntBitwiseOp (|, x, y)を返す。
6.1.6.2.21 BigInt::toString ( x, radix )
The abstract operation BigInt::toString takes arguments x (a BigInt) and radix (an
- x <
0 ℤなら、"-" とBigInt::toString (-x, radix)のstring-concatenation を返す。 - radixを使用するxの表現からなるString値を返す。
6.1.7 Object型
Object型の各インスタンス（単に“Object”とも呼ばれる）は、プロパティの集合を表します。各プロパティは、data propertyまたはaccessor propertyのいずれかです：
-
data propertyは、キー値を
ECMAScript言語値 およびBoolean属性の集合に関連付けます。 -
accessor propertyは、キー値を1つまたは2つのaccessor functions、およびBoolean属性の集合に関連付けます。accessor functionsは、そのプロパティに関連付けられた
ECMAScript言語値 を格納または取得するために使用されます。
オブジェクトのプロパティは、
integer indexは、
すべての非負の
すべてのオブジェクトは論理的にはプロパティの集合ですが、そのプロパティへのアクセスおよび操作の意味論が異なる複数の形式のオブジェクトがあります。複数の形式のオブジェクトの定義については、
加えて、一部のオブジェクトはcallableです。これらはfunctionsまたは
6.1.7.1 プロパティ属性
属性は、この仕様において、
| 属性名 | それが存在するプロパティの種類 | 値のドメイン | Default Value | 説明 |
|---|---|---|---|---|
| [[Value]] |
|
|
|
プロパティのgetアクセスによって取得される値。 |
| [[Writable]] |
|
Boolean |
|
|
| [[Get]] |
|
Objectまたは |
|
値がObjectである場合、それは |
| [[Set]] |
|
Objectまたは |
|
値がObjectである場合、それは |
| [[Enumerable]] |
|
Boolean |
|
|
| [[Configurable]] |
|
Boolean |
|
|
6.1.7.2 Object Internal Methods and Internal Slots
ECMAScriptにおけるオブジェクトの実際の意味論は、internal methodsと呼ばれるアルゴリズムを通じて指定されます。ECMAScriptエンジン内の各オブジェクトは、その実行時の振る舞いを定義するinternal methodsの集合に関連付けられています。これらのinternal methodsはECMAScript言語の一部ではありません。これらは、この仕様によって説明目的でのみ定義されます。しかし、ECMAScriptの実装内の各オブジェクトは、それに関連付けられたinternal methodsによって指定されるとおりに振る舞わなければなりません。これが実現される正確な方法は実装によって決定されます。
Internal method namesは多態的です。これは、共通のinternal method nameが異なるオブジェクト値に対して呼び出されたとき、それらが異なるアルゴリズムを実行し得ることを意味します。internal methodが呼び出される実際のオブジェクトは、その呼び出しの“target”です。実行時に、あるアルゴリズムの実装が、そのオブジェクトがサポートしていないinternal methodを使用しようとした場合、
Internal slotsは、オブジェクト、Symbols、または
すべてのオブジェクトは[[PrivateElements]]という名前のinternal slotを持ち、これは
Internal methodsおよびinternal slotsは、この仕様内では二重角括弧[[ ]]で囲まれた名前を使用して識別されます。
ordinary objectは、以下のすべての基準を満たすオブジェクトです：
-
Table 4 に列挙されるinternal methodsについて、そのオブジェクトは10.1 で定義されるものを使用します。 -
そのオブジェクトが[[Call]] internal methodを持つ場合、
10.2.1 で定義されるもの、または10.3.1 で定義されるもののいずれかを使用します。 -
そのオブジェクトが[[Construct]] internal methodを持つ場合、
10.2.2 で定義されるもの、または10.3.2 で定義されるもののいずれかを使用します。
exotic objectは、
この仕様は、
internal methodは、そのparametersに加えて、常にそのmethod invocationのtargetであるオブジェクトへアクセスできます。
internal methodは暗黙的に
| Internal Method | Signature | 説明 |
|---|---|---|
| [[GetPrototypeOf]] | ( ) → Object | Null |
このオブジェクトにinherited propertiesを提供するオブジェクトを決定します。 |
| [[SetPrototypeOf]] | (Object | Null) → Boolean |
このオブジェクトを、inherited propertiesを提供する別のオブジェクトに関連付けます。 |
| [[IsExtensible]] | ( ) → Boolean | このオブジェクトに追加のプロパティを加えることが許可されているかどうかを決定します。 |
| [[PreventExtensions]] | ( ) → Boolean |
このオブジェクトに新しいプロパティを追加できるかどうかを制御します。操作が成功した場合は |
| [[GetOwnProperty]] |
(propertyKey) → Undefined | |
キーがpropertyKeyであるこのオブジェクトのown propertyについて |
| [[DefineOwnProperty]] | (propertyKey, propertyDesc) → Boolean |
キーがpropertyKeyであるown propertyを作成または変更し、propertyDescによって記述される状態を持たせます。そのプロパティが正常に作成／更新された場合は |
| [[HasProperty]] | (propertyKey) → Boolean | このオブジェクトが、キーがpropertyKeyであるownまたはinherited propertyのいずれかを既に持っているかどうかを示すBoolean値を返します。 |
| [[Get]] | (propertyKey, receiver) → any |
このオブジェクトから、キーがpropertyKeyであるプロパティの値を返します。プロパティ値を取得するために何らかのECMAScriptコードを実行する必要がある場合、receiverはそのコードを評価する際の |
| [[Set]] | (propertyKey, value, receiver) → Boolean |
キーがpropertyKeyであるプロパティの値をvalueに設定します。プロパティ値を設定するために何らかのECMAScriptコードを実行する必要がある場合、receiverはそのコードを評価する際の |
| [[Delete]] | (propertyKey) → Boolean |
キーがpropertyKeyであるown propertyをこのオブジェクトから削除します。プロパティが削除されず、まだ存在している場合は |
| [[OwnPropertyKeys]] |
( ) → |
要素がそのオブジェクトのすべてのown |
| Internal Method | Signature | 説明 |
|---|---|---|
| [[Call]] |
(any, a |
このオブジェクトに関連付けられたコードを実行します。function call expressionを通じて呼び出されます。internal methodへのargumentsは、 |
| [[Construct]] |
(a |
オブジェクトを作成します。new演算子またはsuper呼び出しを通じて呼び出されます。internal methodへの最初のargumentは、super呼び出しのargumentsを要素とするnew演算子が最初に適用されたオブジェクトです。このinternal methodを実装するオブジェクトは |
6.1.7.3 Essential Internal Methodsの不変条件
ECMAScriptエンジンのObjectsのInternal Methodsは、以下で指定される不変条件の一覧に従わなければなりません。通常のECMAScript Objectsおよびこの仕様におけるすべてのstandard
実装が提供する任意の
実装は、その不変条件を強制せずにessential internal methodsの機能を実装する代替インターフェイスを提供するなど、いかなる方法でもこれらの不変条件が迂回されることを許してはなりません。
定義：
- internal methodのtargetは、そのinternal methodが呼び出されるオブジェクトです。
-
targetは、その[[IsExtensible]] internal methodから
false を返すこと、またはその[[PreventExtensions]] internal methodからtrue を返すことが観測されている場合、non-extensibleです。 - non-existentプロパティは、non-extensible target上にown propertyとして存在しないプロパティです。
-
SameValue へのすべての参照は、SameValue アルゴリズムの定義に従います。
戻り値：
任意のinternal methodによって返される値は、以下のいずれかを持つ
- [[Type]] =
normal 、[[Target]] =empty 、および[[Value]] = そのinternal methodについて下に示される“normal return type”の値、または - [[Type]] =
throw 、[[Target]] =empty 、および[[Value]] = 任意のECMAScript言語値 。
internal methodは、
[[GetPrototypeOf]] ( )
- normal return typeはObjectまたはNullのいずれかです。
-
targetがnon-extensibleであり、[[GetPrototypeOf]]が値protoを返す場合、[[GetPrototypeOf]]への将来の呼び出しは
SameValue をprotoとして返すべきです。
オブジェクトのprototype chainは有限長であるべきです（すなわち、任意のオブジェクトから開始して、[[GetPrototypeOf]] internal methodをその結果に再帰的に適用すると、最終的に値
[[SetPrototypeOf]] ( proto )
- normal return typeはBooleanです。
-
targetがnon-extensibleである場合、protoがtargetの観測された[[GetPrototypeOf]]値と
SameValue でない限り、[[SetPrototypeOf]]はfalse を返さなければなりません。
[[IsExtensible]] ( )
- normal return typeはBooleanです。
-
[[IsExtensible]]が
false を返す場合、target上の[[IsExtensible]]への将来のすべての呼び出しはfalse を返さなければなりません。
[[PreventExtensions]] ( )
- normal return typeはBooleanです。
-
[[PreventExtensions]]が
true を返す場合、target上の[[IsExtensible]]への将来のすべての呼び出しはfalse を返さなければならず、targetは現在non-extensibleと見なされます。
[[GetOwnProperty]] ( propertyKey )
-
normal return typeは
Property Descriptor またはUndefinedのいずれかです。 -
戻り値が
Property Descriptor である場合、それはfully populated Property Descriptor でなければなりません。 -
propertyKeyがnon-configurable、non-writable own
data property として記述される場合、[[GetOwnProperty]] ( propertyKey )への将来のすべての呼び出しは、[[Value]]がpropertyKeyの[[Value]]属性とSameValue であるProperty Descriptor を返さなければなりません。 -
[[Writable]]および[[Value]]以外のpropertyKeyの属性が時間の経過とともに変化し得る場合、またはそのプロパティが削除され得る場合、propertyKeyの[[Configurable]]属性は
true でなければなりません。 -
[[Writable]]属性が
false からtrue へ変化し得る場合、[[Configurable]]属性はtrue でなければなりません。 -
targetがnon-extensibleであり、propertyKeyがnon-existentである場合、target上の[[GetOwnProperty]] (propertyKey)への将来のすべての呼び出しは、propertyKeyをnon-existentとして記述しなければなりません（すなわち、[[GetOwnProperty]] (propertyKey)は
undefined を返さなければなりません）。
3番目の不変条件の結果として、あるプロパティが
[[DefineOwnProperty]] ( propertyKey, propertyDesc )
- normal return typeはBooleanです。
-
propertyKeyが以前にtargetのnon-configurable own propertyとして観測されている場合、以下のいずれかでない限り、[[DefineOwnProperty]]は
false を返さなければなりません：-
propertyKeyがwritable
data property である。non-configurable writabledata property は、non-configurable non-writabledata property に変更できます。 -
propertyDescのすべての属性がpropertyKeyの属性と
SameValue である。
-
propertyKeyがwritable
-
targetがnon-extensibleであり、propertyKeyがnon-existent own propertyである場合、[[DefineOwnProperty]] (propertyKey, propertyDesc)は
false を返さなければなりません。すなわち、non-extensible target objectは新しいプロパティで拡張できません。
[[HasProperty]] ( propertyKey )
- normal return typeはBooleanです。
-
propertyKeyが以前にtargetのnon-configurable own dataまたは
accessor property として観測されている場合、[[HasProperty]]はtrue を返さなければなりません。
[[Get]] ( propertyKey, receiver )
-
normal return typeは任意の
ECMAScript言語型 です。 -
propertyKeyが以前に、targetの値valueを持つnon-configurable、non-writable own
data property として観測されている場合、[[Get]]はvalueとSameValue を返さなければなりません。 -
propertyKeyが以前に、[[Get]]属性が
undefined であるtargetのnon-configurable ownaccessor property として観測されている場合、[[Get]]操作はundefined を返さなければなりません。
[[Set]] ( propertyKey, value, receiver )
- normal return typeはBooleanです。
-
propertyKeyが以前にtargetのnon-configurable、non-writable own
data property として観測されている場合、valueがpropertyKeyの[[Value]]属性とSameValue でない限り、[[Set]]はfalse を返さなければなりません。 -
propertyKeyが以前に、[[Set]]属性が
undefined であるtargetのnon-configurable ownaccessor property として観測されている場合、[[Set]]操作はfalse を返さなければなりません。
[[Delete]] ( propertyKey )
- normal return typeはBooleanです。
-
propertyKeyが以前にtargetのnon-configurable own dataまたは
accessor property として観測されている場合、[[Delete]]はfalse を返さなければなりません。
[[OwnPropertyKeys]] ( )
-
normal return typeは
List です。 -
返される
List は重複するentriesを含んではなりません。 -
返される
List の各要素はproperty key でなければなりません。 -
返される
List は、以前に観測されたすべてのnon-configurable own propertiesのkeysを少なくとも含まなければなりません。 -
targetがnon-extensibleである場合、返される
List は、[[GetOwnProperty]]を使用して観測可能なtargetのすべてのown propertiesのkeysのみを含まなければなりません。
[[Call]] ( )
-
normal return typeは任意の
ECMAScript言語型 です。
[[Construct]] ( )
- normal return typeはObjectです。
- targetは[[Call]] internal methodも持たなければなりません。
6.1.7.4 Well-Known Intrinsic Objects
well-known intrinsicsは、この仕様のアルゴリズムによって明示的に参照される組み込みオブジェクトであり、通常
この仕様内では、%name%のような参照は、current
| 組込み名 | グローバル名 | ECMAScript 言語での関連付け |
|---|---|---|
|
|
|
AggregateError |
|
|
|
Array |
|
|
|
ArrayBuffer |
|
|
|
|
|
|
|
AsyncDisposableStack |
|
|
Async-from-Sync |
|
|
|
async 関数オブジェクトの |
|
|
|
async generator 関数オブジェクトの |
|
|
|
async generator オブジェクトのプロトタイプ ( |
|
|
|
すべての標準組込み |
|
|
|
|
Atomics オブジェクト ( |
|
|
|
BigInt |
|
|
|
BigInt64Array |
|
|
|
BigUint64Array |
|
|
|
Boolean |
|
|
|
DataView |
|
|
|
Date |
|
|
|
decodeURI 関数 ( |
|
|
|
decodeURIComponent 関数 ( |
|
|
|
DisposableStack |
|
|
|
encodeURI 関数 ( |
|
|
|
encodeURIComponent 関数 ( |
|
|
|
Error |
|
|
|
eval 関数 ( |
|
|
|
EvalError |
|
|
|
FinalizationRegistry |
|
|
|
Float16Array |
|
|
|
Float32Array |
|
|
|
Float64Array |
|
|
|
|
|
|
|
Function |
|
|
generator 関数オブジェクトの |
|
|
|
generator オブジェクトのプロトタイプ ( |
|
|
|
|
Int8Array |
|
|
|
Int16Array |
|
|
|
Int32Array |
|
|
|
isFinite 関数 ( |
|
|
|
isNaN 関数 ( |
|
|
|
Iterator |
|
|
|
|
|
|
|
JSON オブジェクト ( |
|
|
|
Map |
|
|
|
|
|
|
|
Math オブジェクト ( |
|
|
|
Number |
|
|
|
Object |
|
|
|
parseFloat 関数 ( |
|
|
|
parseInt 関数 ( |
|
|
|
Promise |
|
|
|
Proxy |
|
|
|
RangeError |
|
|
|
ReferenceError |
|
|
|
Reflect オブジェクト ( |
|
|
|
RegExp |
|
|
|
|
|
|
|
Set |
|
|
|
|
|
|
|
SharedArrayBuffer |
|
|
|
String |
|
|
|
|
|
|
|
SuppressedError |
|
|
|
Symbol |
|
|
|
SyntaxError |
|
|
無条件に |
|
|
|
すべての typed Array |
|
|
|
|
TypeError |
|
|
|
Uint8Array |
|
|
|
Uint8ClampedArray |
|
|
|
Uint16Array |
|
|
|
Uint32Array |
|
|
|
URIError |
|
|
|
WeakMap |
|
|
|
WeakRef |
|
|
|
WeakSet |
|
|
Iterator.from によって返されるラップ済みイテレータオブジェクトのプロトタイプ ( |
6.2 ECMAScript仕様型
仕様型は、ECMAScript言語構文および
6.2.1 Enum仕様型
Enumsは、仕様内部の値であり、ECMAScriptコードから直接観測できません。Enumsは
6.2.2 ListおよびRecord仕様型
List型は、new式、関数呼び出し、および単純な順序付き値リストが必要な他のアルゴリズムにおけるargument lists（
アルゴリズムが順序を指定せずにListの要素を反復する場合、使用される順序はList内の要素の順序です。
この仕様内では、表記上の便宜のため、新しいList値を表現するためにliteral syntaxを使用できます。たとえば、« 1, 2 »は、それぞれ特定の値に初期化された2つの要素を持つList値を定義します。新しい空のListは« »として表現できます。
この仕様では、“A, B, ...のlist-concatenation”（各argumentが空であってもよいListである場合）という句は、各argumentの要素（順序どおり）の連結（順序どおり）を要素とする新しいList値を表します。
StringsのListに適用される場合、“lexicographic code unit orderに従ってソートされる”という句は、より短い文字列の長さまで各コード単位の数値でソートし、すべてが等しい場合はより短い文字列をより長い文字列の前にソートすることを意味します。これは抽象操作
Record型は、この仕様のアルゴリズム内のデータ集約を記述するために使用されます。Record型値は、1つ以上の名前付きフィールドで構成されます。各フィールドの値は
この仕様内では、表記上の便宜のため、Record値を表現するためにobject literal-like syntaxを使用できます。たとえば、{ [[Field1]]: 42, [[Field2]]:
仕様テキストおよびアルゴリズムでは、Record値の特定のフィールドを参照するためにdot notationを使用できます。たとえば、Rが前段落に示されたrecordである場合、R.[[Field2]]は“Rの[[Field2]]という名前のフィールド”を表す省略表現です。
一般的に使用されるRecordフィールドの組み合わせに対するSchemaには名前が付けられる場合があり、その名前は、記述されている特定の種類の集約を識別するためにliteral Record値の接頭辞として使用できます。例：PropertyDescriptor { [[Value]]: 42, [[Writable]]:
6.2.3 SetおよびRelation仕様型
Set型は、
Relation型は、Sets上の制約を説明するために使用されます。Relation型の値は、その値域からの値の順序対のSetです。たとえば、
strict partial orderは、以下を満たすRelation値Rです。
-
Rのdomain内のすべてのa、b、およびcについて：
- a R aではなく、かつ
- a R bかつb R cなら、a R cである。
上記の2つの性質は、それぞれirreflexivityおよびtransitivityと呼ばれます。
strict total orderは、以下を満たすRelation値Rです。
-
Rのdomain内のすべてのa、b、およびcについて：
- aはbである、またはa R bである、またはb R aであり、かつ
- a R aではなく、かつ
- a R bかつb R cなら、a R cである。
上記の3つの性質は、それぞれtotality、irreflexivity、およびtransitivityと呼ばれます。
6.2.4 Completion Record仕様型
Completion Record仕様型は、値の実行時伝播および、制御の非局所的移動を行う文（break、continue、returnおよびthrow）の振る舞いなどの制御フローを説明するために使用されます。
Completion Recordsは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Type]] |
|
発生したcompletionの種類。 |
| [[Value]] |
|
生成された値。 |
| [[Target]] |
Stringまたは |
directed control transfersのtarget label。 |
以下の省略用語は、Completion Recordsを参照するために使用されることがあります。
- normal completionは、[[Type]]値が
normal である任意のCompletion Recordを指します。 - break completionは、[[Type]]値が
break である任意のCompletion Recordを指します。 - continue completionは、[[Type]]値が
continue である任意のCompletion Recordを指します。 - return completionは、[[Type]]値が
return である任意のCompletion Recordを指します。 - throw completionは、[[Type]]値が
throw である任意のCompletion Recordを指します。 - abrupt completionは、[[Type]]値が
normal 以外である任意のCompletion Recordを指します。 - ある型の値を含むnormal completionは、その[[Value]]フィールドにその型の値を持つnormal completionを指します。
この仕様で定義されるcallable objectsは、normal completionまたはthrow completionのみを返します。他の種類のCompletion Recordを返すことは編集上の誤りと見なされます。
6.2.4.1 NormalCompletion ( value )
The abstract operation NormalCompletion takes argument value (any value except a
Completion Record { [[Type]]:normal , [[Value]]: value, [[Target]]:empty }を返す。
6.2.4.2 ThrowCompletion ( value )
The abstract operation ThrowCompletion takes argument value (an ECMAScript language value) and returns a
Completion Record { [[Type]]:throw , [[Value]]: value, [[Target]]:empty }を返す。
6.2.4.3 ReturnCompletion ( value )
The abstract operation ReturnCompletion takes argument value (an ECMAScript language value) and returns a
Completion Record { [[Type]]:return , [[Value]]: value, [[Target]]:empty }を返す。
6.2.4.4 UpdateEmpty ( completionRecord, value )
The abstract operation UpdateEmpty takes arguments completionRecord (a
Assert : completionRecordがreturn completion またはthrow completion のいずれかであるなら、completionRecord.[[Value]]はempty ではない。- completionRecord.[[Value]]が
empty でないなら、? completionRecordを返す。 Completion Record { [[Type]]: completionRecord.[[Type]], [[Value]]: value, [[Target]]: completionRecord.[[Target]] }を返す。
6.2.5 Reference Record仕様型
Reference Record型は、delete、typeof、代入演算子、superキーワード、およびその他の言語機能のような演算子の振る舞いを説明するために使用されます。たとえば、代入の左辺オペランドはReference Recordを生成することが期待されます。
Reference Recordは、解決済みの名前または（まだ解決されていない可能性のある）プロパティ束縛です。そのフィールドは
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Base]] | 束縛を保持する値または |
|
| [[ReferencedName]] | 束縛の名前。[[Base]]値が |
|
| [[Strict]] | Boolean | |
| [[ThisValue]] | superキーワードを使用して表現されたプロパティ束縛を表します。これはSuper Reference Recordと呼ばれ、その[[Base]]値は決して |
以下の抽象操作は、この仕様においてReference Recordsを操作するために使用されます：
6.2.5.1 IsPropertyReference ( refRecord )
The abstract operation IsPropertyReference takes argument refRecord (a
- refRecord.[[Base]]が
unresolvable なら、false を返す。 - refRecord.[[Base]]が
Environment Record なら、false を返す。 true を返す。
6.2.5.2 IsUnresolvableReference ( refRecord )
The abstract operation IsUnresolvableReference takes argument refRecord (a
- refRecord.[[Base]]が
unresolvable なら、true を返す。 false を返す。
6.2.5.3 IsSuperReference ( refRecord )
The abstract operation IsSuperReference takes argument refRecord (a
- refRecord.[[ThisValue]]が
empty なら、false を返す。 true を返す。
6.2.5.4 IsPrivateReference ( refRecord )
The abstract operation IsPrivateReference takes argument refRecord (a
- refRecord.[[ReferencedName]]が
Private Name なら、true を返す。 false を返す。
6.2.5.5 GetValue ( refRecord )
The abstract operation GetValue takes argument refRecord (a
- refRecordが
Reference Record でないなら、refRecordを返す。 IsUnresolvableReference (refRecord)がtrue なら、ReferenceError 例外をthrowする。IsPropertyReference (refRecord)がtrue なら、- baseObjを ?
ToObject (refRecord.[[Base]]) とする。 IsPrivateReference (refRecord)がtrue なら、- ?
PrivateGet (baseObj, refRecord.[[ReferencedName]])を返す。
- ?
- refRecord.[[ReferencedName]]が
property key でないなら、- refRecord.[[ReferencedName]]を ?
ToPropertyKey (refRecord.[[ReferencedName]]) に設定する。
- refRecord.[[ReferencedName]]を ?
- ? baseObj.[[Get]](refRecord.[[ReferencedName]],
GetThisValue (refRecord))を返す。
- baseObjを ?
- baseをrefRecord.[[Base]]とする。
Assert : baseはEnvironment Record である。- ? base.
GetBindingValue (refRecord.[[ReferencedName]], refRecord.[[Strict]])を返す（9.1 を参照）。
ステップ
6.2.5.6 PutValue ( refRecord, value )
The abstract operation PutValue takes arguments refRecord (a
- refRecordが
Reference Record でないなら、ReferenceError 例外をthrowする。 IsUnresolvableReference (refRecord)がtrue なら、- refRecord.[[Strict]]が
true なら、ReferenceError 例外をthrowする。 - globalObjを
GetGlobalObject ()とする。 - ?
Set (globalObj, refRecord.[[ReferencedName]], value,false )を実行する。 unused を返す。
- refRecord.[[Strict]]が
IsPropertyReference (refRecord)がtrue なら、- baseObjを ?
ToObject (refRecord.[[Base]]) とする。 IsPrivateReference (refRecord)がtrue なら、- ?
PrivateSet (baseObj, refRecord.[[ReferencedName]], value)を返す。
- ?
- refRecord.[[ReferencedName]]が
property key でないなら、- refRecord.[[ReferencedName]]を ?
ToPropertyKey (refRecord.[[ReferencedName]]) に設定する。
- refRecord.[[ReferencedName]]を ?
- succeededを ? baseObj.[[Set]](refRecord.[[ReferencedName]], value,
GetThisValue (refRecord)) とする。 - succeededが
false かつrefRecord.[[Strict]]がtrue なら、TypeError 例外をthrowする。 unused を返す。
- baseObjを ?
- baseをrefRecord.[[Base]]とする。
Assert : baseはEnvironment Record である。- ? base.
SetMutableBinding (refRecord.[[ReferencedName]], value, refRecord.[[Strict]])を返す（9.1 を参照）。
ステップ
6.2.5.7 GetThisValue ( refRecord )
The abstract operation GetThisValue takes argument refRecord (a
Assert :IsPropertyReference (refRecord)はtrue である。IsSuperReference (refRecord)がtrue なら、refRecord.[[ThisValue]]を返す。- refRecord.[[Base]]を返す。
6.2.5.8 InitializeReferencedBinding ( refRecord, value )
The abstract operation InitializeReferencedBinding takes arguments refRecord (a
Assert :IsUnresolvableReference (refRecord)はfalse である。- baseをrefRecord.[[Base]]とする。
Assert : baseはEnvironment Record である。- ? base.
InitializeBinding (refRecord.[[ReferencedName]], value)を返す。
6.2.5.9 MakePrivateReference ( baseValue, privateIdentifier )
The abstract operation MakePrivateReference takes arguments baseValue (an ECMAScript language value) and privateIdentifier (a String) and returns a
- privateEnvを
running execution context のPrivateEnvironmentとする。 Assert : privateEnvはnull でない。- privateNameを
ResolvePrivateIdentifier (privateEnv, privateIdentifier)とする。 Reference Record { [[Base]]: baseValue, [[ReferencedName]]: privateName, [[Strict]]:true , [[ThisValue]]:empty }を返す。
6.2.6 Property Descriptor仕様型
Property Descriptor型は、Objectプロパティ属性の操作および具象化を説明するために使用されます。Property Descriptorは0個以上のフィールドを持つ
Property Descriptor値は、特定のフィールドの存在または使用に基づいて、data Property Descriptorsおよびaccessor Property Descriptorsにさらに分類される場合があります。data Property Descriptorは、[[Value]]または[[Writable]]という名前のフィールドのいずれかを含むものです。accessor Property Descriptorは、[[Get]]または[[Set]]という名前のフィールドのいずれかを含むものです。任意のProperty Descriptorは、[[Enumerable]]および[[Configurable]]という名前のフィールドを持つことができます。Property Descriptor値はdata Property Descriptorかつaccessor Property Descriptorの両方であってはなりません。ただし、どちらでもない場合があります（その場合、それはgeneric Property Descriptorです）。fully populated Property Descriptorは、accessor Property Descriptorまたはdata Property Descriptorのいずれかであり、
以下の抽象操作は、この仕様においてProperty Descriptor値を操作するために使用されます：
6.2.6.1 IsAccessorDescriptor ( propertyDesc )
The abstract operation IsAccessorDescriptor takes argument propertyDesc (a
- propertyDescが[[Get]]フィールドを持つなら、
true を返す。 - propertyDescが[[Set]]フィールドを持つなら、
true を返す。 false を返す。
6.2.6.2 IsDataDescriptor ( propertyDesc )
The abstract operation IsDataDescriptor takes argument propertyDesc (a
- propertyDescが[[Value]]フィールドを持つなら、
true を返す。 - propertyDescが[[Writable]]フィールドを持つなら、
true を返す。 false を返す。
6.2.6.3 IsGenericDescriptor ( propertyDesc )
The abstract operation IsGenericDescriptor takes argument propertyDesc (a
IsAccessorDescriptor (propertyDesc)がtrue なら、false を返す。IsDataDescriptor (propertyDesc)がtrue なら、false を返す。true を返す。
6.2.6.4 FromPropertyDescriptor ( propertyDesc )
The abstract operation FromPropertyDescriptor takes argument propertyDesc (a
- propertyDescが
undefined なら、undefined を返す。 - objを
OrdinaryObjectCreate (%Object.prototype% )とする。 Assert : objはown propertiesを持たないextensibleordinary object である。- propertyDescが[[Value]]フィールドを持つなら、
- !
CreateDataPropertyOrThrow (obj,"value" , propertyDesc.[[Value]])を実行する。
- !
- propertyDescが[[Writable]]フィールドを持つなら、
- !
CreateDataPropertyOrThrow (obj,"writable" , propertyDesc.[[Writable]])を実行する。
- !
- propertyDescが[[Get]]フィールドを持つなら、
- !
CreateDataPropertyOrThrow (obj,"get" , propertyDesc.[[Get]])を実行する。
- !
- propertyDescが[[Set]]フィールドを持つなら、
- !
CreateDataPropertyOrThrow (obj,"set" , propertyDesc.[[Set]])を実行する。
- !
- propertyDescが[[Enumerable]]フィールドを持つなら、
- !
CreateDataPropertyOrThrow (obj,"enumerable" , propertyDesc.[[Enumerable]])を実行する。
- !
- propertyDescが[[Configurable]]フィールドを持つなら、
- !
CreateDataPropertyOrThrow (obj,"configurable" , propertyDesc.[[Configurable]])を実行する。
- !
- objを返す。
6.2.6.5 ToPropertyDescriptor ( obj )
The abstract operation ToPropertyDescriptor takes argument obj (an ECMAScript language value) and returns either a
- objがObjectでないなら、
TypeError 例外をthrowする。 - propertyDescを、初期状態でフィールドを持たない新しい
Property Descriptor とする。 - hasEnumerableを ?
HasProperty (obj,"enumerable" ) とする。 - hasEnumerableが
true なら、 - hasConfigurableを ?
HasProperty (obj,"configurable" ) とする。 - hasConfigurableが
true なら、 - hasValueを ?
HasProperty (obj,"value" ) とする。 - hasValueが
true なら、- valueを ?
Get (obj,"value" ) とする。 - propertyDesc.[[Value]]をvalueに設定する。
- valueを ?
- hasWritableを ?
HasProperty (obj,"writable" ) とする。 - hasWritableが
true なら、 - hasGetを ?
HasProperty (obj,"get" ) とする。 - hasGetが
true なら、- getterを ?
Get (obj,"get" ) とする。 IsCallable (getter)がfalse かつgetterがundefined でないなら、TypeError 例外をthrowする。- propertyDesc.[[Get]]をgetterに設定する。
- getterを ?
- hasSetを ?
HasProperty (obj,"set" ) とする。 - hasSetが
true なら、- setterを ?
Get (obj,"set" ) とする。 IsCallable (setter)がfalse かつsetterがundefined でないなら、TypeError 例外をthrowする。- propertyDesc.[[Set]]をsetterに設定する。
- setterを ?
- propertyDescが[[Get]]フィールドを持つ、またはpropertyDescが[[Set]]フィールドを持つなら、
- propertyDescが[[Value]]フィールドを持つ、またはpropertyDescが[[Writable]]フィールドを持つなら、
TypeError 例外をthrowする。
- propertyDescが[[Value]]フィールドを持つ、またはpropertyDescが[[Writable]]フィールドを持つなら、
- propertyDescを返す。
6.2.6.6 CompletePropertyDescriptor ( propertyDesc )
The abstract operation CompletePropertyDescriptor takes argument propertyDesc (a
- likeを
Record { [[Value]]:undefined , [[Writable]]:false , [[Get]]:undefined , [[Set]]:undefined , [[Enumerable]]:false , [[Configurable]]:false }とする。 IsGenericDescriptor (propertyDesc)がtrue またはIsDataDescriptor (propertyDesc)がtrue なら、- propertyDescが[[Value]]フィールドを持たないなら、propertyDesc.[[Value]]をlike.[[Value]]に設定する。
- propertyDescが[[Writable]]フィールドを持たないなら、propertyDesc.[[Writable]]をlike.[[Writable]]に設定する。
- そうでなければ、
- propertyDescが[[Get]]フィールドを持たないなら、propertyDesc.[[Get]]をlike.[[Get]]に設定する。
- propertyDescが[[Set]]フィールドを持たないなら、propertyDesc.[[Set]]をlike.[[Set]]に設定する。
- propertyDescが[[Enumerable]]フィールドを持たないなら、propertyDesc.[[Enumerable]]をlike.[[Enumerable]]に設定する。
- propertyDescが[[Configurable]]フィールドを持たないなら、propertyDesc.[[Configurable]]をlike.[[Configurable]]に設定する。
unused を返す。
6.2.7 Environment Record仕様型
6.2.8 Abstract Closure仕様型
Abstract Closure仕様型は、値の集合とともにアルゴリズムステップを参照するために使用されます。Abstract Closuresはメタ値であり、closure(arg1, arg2)のような関数適用形式を使用して呼び出されます。抽象操作と同様に、呼び出しはAbstract Closureによって記述されたアルゴリズムステップを実行します。
Abstract Closureを作成するアルゴリズムステップでは、値は動詞“capture”の後にaliasesのリストを続けることで捕捉されます。Abstract Closureが作成されると、その時点で各aliasに関連付けられている値を捕捉します。Abstract Closureが呼び出されたときに実行されるアルゴリズムを指定するステップでは、各捕捉された値は、その値を捕捉するために使用されたaliasによって参照されます。
Abstract Closureが
Abstract Closuresは、他のアルゴリズムの一部としてインラインで作成されます。以下の例に示します。
- addendを41とする。
- closureを、parameters (x)を持ち、addendをcaptureし、呼び出されたときに以下のステップを実行する新しい
Abstract Closure とする：- x + addendを返す。
- valueをclosure(1)とする。
Assert : valueは42である。
6.2.9 Data Blocks
Data Block仕様型は、byte-sized（8 bit）の数値の、別個で可変な列を記述するために使用されます。byte valueは、0から255までの包含区間内の整数です。Data Block値は、各byteが初期値0を持つ固定数のbytesで作成されます。
この仕様内では、表記上の便宜のため、Data Block値の個々のbytesへアクセスするためにarray-like syntaxを使用できます。この表記は、Data Block値を0-basedの
複数の
Shared Data Blocksの意味論は、
以下の抽象操作は、この仕様においてData Block値を操作するために使用されます：
6.2.9.1 CreateByteDataBlock ( size )
The abstract operation CreateByteDataBlock takes argument size (a non-negative
- size > 253 - 1なら、
RangeError 例外をthrowする。 - dataBlockをsize bytesからなる新しい
Data Block 値とする。そのようなData Block を作成することが不可能な場合、RangeError 例外をthrowする。 - dataBlockのすべてのbytesを0に設定する。
- dataBlockを返す。
6.2.9.2 CreateSharedByteDataBlock ( size )
The abstract operation CreateSharedByteDataBlock takes argument size (a non-negative
- dataBlockをsize bytesからなる新しい
Shared Data Block 値とする。そのようなShared Data Block を作成することが不可能な場合、RangeError 例外をthrowする。 - agentRecordを
surrounding agent のAgent Record とする。 - executionをagentRecord.[[CandidateExecution]]とする。
- eventsRecordを、[[AgentSignifier]]が
AgentSignifier ()であるexecution.[[EventsRecords]]のAgent Events Record とする。 - zeroを« 0 »とする。
- dataBlockの各index indexについて、以下を行う
WriteSharedMemory { [[Order]]:init , [[NoTear]]:true , [[Block]]: dataBlock, [[ByteIndex]]: index, [[ElementSize]]: 1, [[Payload]]: zero }をeventsRecord.[[EventList]]へappendする。
- dataBlockを返す。
6.2.9.3 CopyDataBlockBytes ( toBlock, toIndex, fromBlock, fromIndex, count )
The abstract operation CopyDataBlockBytes takes arguments toBlock (a
Assert : fromBlockとtoBlockは別個の値である。- fromSizeをfromBlock内のbytesの数とする。
Assert : fromIndex + count ≤ fromSize。- toSizeをtoBlock内のbytesの数とする。
Assert : toIndex + count ≤ toSize。- count > 0の間、繰り返す
- fromBlockが
Shared Data Block なら、- agentRecordを
surrounding agent のAgent Record とする。 - executionをagentRecord.[[CandidateExecution]]とする。
- eventsRecordを、[[AgentSignifier]]が
AgentSignifier ()であるexecution.[[EventsRecords]]のAgent Events Record とする。 - bytesを、唯一の要素が非決定的に選択された
byte value であるList とする。 NOTE : 実装では、bytesは基礎となるハードウェア上のnon-atomic read instructionの結果です。この非決定性は、weak consistencyを持つハードウェアの観測可能な振る舞いを記述するためのmemory model の意味論的規定です。- readEventを
ReadSharedMemory { [[Order]]:unordered , [[NoTear]]:true , [[Block]]: fromBlock, [[ByteIndex]]: fromIndex, [[ElementSize]]: 1 }とする。 - readEventをeventsRecord.[[EventList]]へappendする。
Chosen Value Record { [[Event]]: readEvent, [[ChosenValue]]: bytes }をexecution.[[ChosenValues]]へappendする。- toBlockが
Shared Data Block なら、WriteSharedMemory { [[Order]]:unordered , [[NoTear]]:true , [[Block]]: toBlock, [[ByteIndex]]: toIndex, [[ElementSize]]: 1, [[Payload]]: bytes }をeventsRecord.[[EventList]]へappendする。
- そうでなければ、
- toBlock[toIndex]をbytes[0]に設定する。
- agentRecordを
- そうでなければ、
Assert : toBlockはShared Data Block ではない。- toBlock[toIndex]をfromBlock[fromIndex]に設定する。
- toIndexをtoIndex + 1に設定する。
- fromIndexをfromIndex + 1に設定する。
- countをcount - 1に設定する。
- fromBlockが
unused を返す。
6.2.10 PrivateElement仕様型
PrivateElement型は、private class fields、methods、およびaccessorsの仕様で使用される
PrivateElement型の値は、
| フィールド名 | それが存在する[[Kind]]フィールドの値 | 値 | 意味 |
|---|---|---|---|
| [[Key]] | All |
|
field、method、またはaccessorの名前。 |
| [[Kind]] | All |
|
elementの種類。 |
| [[Value]] |
|
|
fieldの値。 |
| [[Get]] |
|
|
private accessorのgetter。 |
| [[Set]] |
|
|
private accessorのsetter。 |
6.2.11 ClassFieldDefinition Record仕様型
ClassFieldDefinition型は、class fieldsの仕様で使用される
ClassFieldDefinition型の値は、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Name]] |
|
fieldの名前。 |
| [[Initializer]] |
ECMAScript |
fieldのinitializer（存在する場合）。 |
6.2.12 Private Names
Private Name仕様型は、private class element（field、method、またはaccessor）のキーを表す、グローバルに一意な値（それ以外は区別できない場合でも、他のいかなるPrivate Nameとも異なるもの）を記述するために使用されます。各Private Nameは、不変の[[Description]] internal slotを持ち、これはStringです。Private Nameは
6.2.13 ClassStaticBlockDefinition Record仕様型
ClassStaticBlockDefinition Recordは、class static initialization blockの実行可能コードをカプセル化するために使用される
ClassStaticBlockDefinition Recordsは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[BodyFunction]] |
ECMAScript |
classのstatic initialization中に呼び出される |
7 抽象操作
これらの操作はECMAScript言語の一部ではありません。これらは、ECMAScript言語の意味論の仕様を補助するためだけにここで定義されます。その他の、より特殊化された抽象操作は、この仕様全体にわたって定義されます。
7.1 型変換
ECMAScript言語は、必要に応じて自動的な型変換を暗黙に実行します。特定の構文の意味論を明確にするため、変換抽象操作の集合を定義することが有用です。変換抽象操作は多態的です。任意の
7.1.1 ToPrimitive ( input [ , preferredType ] )
The abstract operation ToPrimitive takes argument input (an ECMAScript language value) and optional argument preferredType (
- inputがObjectなら、
- exoticToPrimitiveを ?
GetMethod (input,%Symbol.toPrimitive% ) とする。 - exoticToPrimitiveが
undefined でないなら、 - preferredTypeが存在しないなら、preferredTypeを
number に設定する。 - ?
OrdinaryToPrimitive (input, preferredType)を返す。
- exoticToPrimitiveを ?
- inputを返す。
ToPrimitiveがhintなしで呼び出された場合、一般にhintが
7.1.1.1 OrdinaryToPrimitive ( obj, hint )
The abstract operation OrdinaryToPrimitive takes arguments obj (an Object) and hint (
- hintが
string なら、- methodNamesを«
"toString" ,"valueOf" »とする。
- methodNamesを«
- そうでなければ、
- methodNamesを«
"valueOf" ,"toString" »とする。
- methodNamesを«
- methodNamesの各要素nameについて、以下を行う
- methodを ?
Get (obj, name) とする。 IsCallable (method)がtrue なら、- resultを ?
Call (method, obj) とする。 - resultがObjectでないなら、resultを返す。
- resultを ?
- methodを ?
TypeError 例外をthrowする。
7.1.2 ToBoolean ( arg )
The abstract operation ToBoolean takes argument arg (an ECMAScript language value) and returns a Boolean. これはargを
- argがBooleanなら、argを返す。
- argが
undefined 、null 、+0 𝔽、-0 𝔽、NaN 、0 ℤ、または空のStringのいずれかなら、false を返す。 - hostがweb browserであるか、または他の方法で
[[IsHTMLDDA]] Internal Slot をサポートするなら、- argがObjectであり、argが[[IsHTMLDDA]] internal slotを持つなら、
false を返す。
- argがObjectであり、argが[[IsHTMLDDA]] internal slotを持つなら、
true を返す。
7.1.3 ToNumeric ( arg )
The abstract operation ToNumeric takes argument arg (an ECMAScript language value) and returns either a
- primitiveValueを ?
ToPrimitive (arg,number ) とする。 - primitiveValueがBigIntなら、primitiveValueを返す。
- ?
ToNumber (primitiveValue)を返す。
7.1.4 ToNumber ( arg )
The abstract operation ToNumber takes argument arg (an ECMAScript language value) and returns either a
- argがNumberなら、argを返す。
- argがSymbolまたはBigIntのいずれかなら、
TypeError 例外をthrowする。 - argが
undefined なら、NaN を返す。 - argが
null またはfalse のいずれかなら、+0 𝔽を返す。 - argが
true なら、1 𝔽を返す。 - argがStringなら、
StringToNumber (arg)を返す。 Assert : argはObjectである。- primitiveValueを ?
ToPrimitive (arg,number ) とする。 Assert : primitiveValueはObjectでない。- ?
ToNumber (primitiveValue)を返す。
7.1.4.1 String型に適用されるToNumber
抽象操作
構文
上で明示的に定義されていないすべてのgrammar symbolsは、numeric literalsのLexical Grammarで使用される定義を持ちます（
-
StringNumericLiteral は、先頭および／または末尾のwhite spaceおよび／またはline terminatorsを含むことができます。 -
decimalである
StringNumericLiteral は、任意個数の先頭の0digitsを持つことができます。 -
decimalである
StringNumericLiteral は、その符号を示すために+または-を含むことができます。 -
空であるか、white spaceのみを含む
StringNumericLiteral は、+0 𝔽へ変換されます。 -
Infinityおよび-InfinityはStringNumericLiteral として認識されますが、NumericLiteral としては認識されません。 -
StringNumericLiteral はBigIntLiteralSuffix を含むことができません。 -
StringNumericLiteral はNumericLiteralSeparator を含むことができません。
7.1.4.1.1 StringToNumber ( string )
The abstract operation StringToNumber takes argument string (a String) and returns a Number. It performs the following steps when called:
- literalを
ParseText (string,StringNumericLiteral )とする。 - literalがerrorsの
List なら、NaN を返す。 - literalの
StringNumericValue を返す。
7.1.4.1.2 Runtime Semantics: StringNumericValue
The
It is defined piecewise over the following productions:
+0 𝔽を返す。
𝔽 (NonDecimalIntegerLiteral のMV)を返す。
- aを
StrUnsignedDecimalLiteral のStringNumericValue とする。 - aが
+0 𝔽なら、-0 𝔽を返す。 - -aを返す。
+∞ 𝔽を返す。
- aを最初の
DecimalDigits のMVとする。 - 2番目の
DecimalDigits が存在するなら、- bを2番目の
DecimalDigits のMVとする。 - nを2番目の
DecimalDigits 内のcode pointsの数とする。
- bを2番目の
- そうでなければ、
- bを0とする。
- nを0とする。
ExponentPart が存在するなら、eをExponentPart のMVとする。そうでなければ、eを0とする。RoundMVResult ((a + (b × 10-n)) × 10e)を返す。
- bを
DecimalDigits のMVとする。 ExponentPart が存在するなら、eをExponentPart のMVとする。そうでなければ、eを0とする。- nを
DecimalDigits 内のcode pointsの数とする。 RoundMVResult (b × 10e - n)を返す。
- aを
DecimalDigits のMVとする。 ExponentPart が存在するなら、eをExponentPart のMVとする。そうでなければ、eを0とする。RoundMVResult (a × 10e)を返す。
7.1.4.1.3 RoundMVResult ( n )
The abstract operation RoundMVResult takes argument n (a
- nのdecimal representationが20個以下のsignificant digitsを持つなら、
𝔽 (n)を返す。 - option1を、nのdecimal representation内の20番目以降の各significant digitを0 digitで置き換えた結果が表す
mathematical value とする。 - option2を、nのdecimal representation内の20番目以降の各significant digitを0 digitで置き換え、その後20番目の位置でそれをincrementした結果（必要に応じて繰り上がりを伴う）が表す
mathematical value とする。 - chosenをoption1またはoption2のいずれかの
implementation-defined な選択とする。 𝔽 (chosen)を返す。
7.1.5 ToIntegerOrInfinity ( arg )
The abstract operation ToIntegerOrInfinity takes argument arg (an ECMAScript language value) and returns either a
7.1.6 ToFixedSizeInteger ( int, signed, bitWidth )
The abstract operation ToFixedSizeInteger takes arguments int (an
ToFixedSizeIntegerはidempotentです。任意の
7.1.7 ToInt32 ( arg )
The abstract operation ToInt32 takes argument arg (an ECMAScript language value) and returns either a
- intを ?
ToIntegerOrInfinity (arg) とする。 𝔽 (ToFixedSizeInteger (int,signed , 32))を返す。
7.1.8 ToUint32 ( arg )
The abstract operation ToUint32 takes argument arg (an ECMAScript language value) and returns either a
- intを ?
ToIntegerOrInfinity (arg) とする。 𝔽 (ToFixedSizeInteger (int,unsigned , 32))を返す。
7.1.9 ToInt16 ( arg )
The abstract operation ToInt16 takes argument arg (an ECMAScript language value) and returns either a
- intを ?
ToIntegerOrInfinity (arg) とする。 𝔽 (ToFixedSizeInteger (int,signed , 16))を返す。
7.1.10 ToUint16 ( arg )
The abstract operation ToUint16 takes argument arg (an ECMAScript language value) and returns either a
- intを ?
ToIntegerOrInfinity (arg) とする。 𝔽 (ToFixedSizeInteger (int,unsigned , 16))を返す。
7.1.11 ToInt8 ( arg )
The abstract operation ToInt8 takes argument arg (an ECMAScript language value) and returns either a
- intを ?
ToIntegerOrInfinity (arg) とする。 𝔽 (ToFixedSizeInteger (int,signed , 8))を返す。
7.1.12 ToUint8 ( arg )
The abstract operation ToUint8 takes argument arg (an ECMAScript language value) and returns either a
- intを ?
ToIntegerOrInfinity (arg) とする。 𝔽 (ToFixedSizeInteger (int,unsigned , 8))を返す。
7.1.13 ToUint8Clamp ( arg )
The abstract operation ToUint8Clamp takes argument arg (an ECMAScript language value) and returns either a
他のほとんどのECMAScript整数変換操作とは異なり、ToUint8Clampは非整数値を切り捨てるのではなく丸めます。また、“round half to even”のtie-breakingを使用します。これはMath.round
7.1.14 ToBigInt ( arg )
The abstract operation ToBigInt takes argument arg (an ECMAScript language value) and returns either a
- primitiveを ?
ToPrimitive (arg,number ) とする。 - primitiveが
Table 12 で対応する値を返す。
| Argument Type | 結果 |
|---|---|
| Undefined |
|
| Null |
|
| Boolean |
primitiveが1nを返し、primitiveが0nを返す。
|
| BigInt | primitiveを返す。 |
| Number |
|
| String |
|
| Symbol |
|
7.1.15 StringToBigInt ( string )
The abstract operation StringToBigInt takes argument string (a String) and returns a BigInt or
7.1.15.1 StringIntegerLiteral文法
構文
7.1.15.2 Runtime Semantics: MV
-
StringIntegerLiteral ::: StrWhiteSpace opt -
StringIntegerLiteral ::: StrWhiteSpace opt StrIntegerLiteral StrWhiteSpace opt StrIntegerLiteral のMVです。
7.1.16 ToBigInt64 ( arg )
The abstract operation ToBigInt64 takes argument arg (an ECMAScript language value) and returns either a
- intを
ℝ (?ToBigInt (arg))とする。 ℤ (ToFixedSizeInteger (int,signed , 64))を返す。
7.1.17 ToBigUint64 ( arg )
The abstract operation ToBigUint64 takes argument arg (an ECMAScript language value) and returns either a
- intを
ℝ (?ToBigInt (arg))とする。 ℤ (ToFixedSizeInteger (int,unsigned , 64))を返す。
7.1.18 ToString ( arg )
The abstract operation ToString takes argument arg (an ECMAScript language value) and returns either a
- argがStringなら、argを返す。
- argがSymbolなら、
TypeError 例外をthrowする。 - argが
undefined なら、"undefined" を返す。 - argが
null なら、"null" を返す。 - argが
true なら、"true" を返す。 - argが
false なら、"false" を返す。 - argがNumberなら、
Number::toString (arg, 10)を返す。 - argがBigIntなら、
BigInt::toString (arg, 10)を返す。 Assert : argはObjectである。- primitiveValueを ?
ToPrimitive (arg,string ) とする。 Assert : primitiveValueはObjectでない。- ?
ToString (primitiveValue)を返す。
7.1.19 ToObject ( arg )
The abstract operation ToObject takes argument arg (an ECMAScript language value) and returns either a
- argが
undefined またはnull のいずれかなら、TypeError 例外をthrowする。 - argがBooleanなら、[[BooleanData]] internal slotがargに設定された新しいBoolean objectを返す。Boolean objectsの説明については
20.3 を参照。 - argがNumberなら、[[NumberData]] internal slotがargに設定された新しいNumber objectを返す。Number objectsの説明については
21.1 を参照。 - argがStringなら、[[StringData]] internal slotがargに設定された新しいString objectを返す。String objectsの説明については
22.1 を参照。 - argがSymbolなら、[[SymbolData]] internal slotがargに設定された新しいSymbol objectを返す。Symbol objectsの説明については
20.4 を参照。 - argがBigIntなら、[[BigIntData]] internal slotがargに設定された新しいBigInt objectを返す。BigInt objectsの説明については
21.2 を参照。 Assert : argはObjectである。- argを返す。
7.1.20 ToPropertyKey ( arg )
The abstract operation ToPropertyKey takes argument arg (an ECMAScript language value) and returns either a
- keyを ?
ToPrimitive (arg,string ) とする。 - keyがSymbolなら、
- keyを返す。
- !
ToString (key)を返す。
7.1.21 ToLength ( arg )
The abstract operation ToLength takes argument arg (an ECMAScript language value) and returns either a
- lengthを ?
ToIntegerOrInfinity (arg) とする。 - length ≤ 0なら、
+0 𝔽を返す。 𝔽 (min (length, 253 - 1))を返す。
7.1.22 CanonicalNumericIndexString ( arg )
The abstract operation CanonicalNumericIndexString takes argument arg (a String) and returns a Number or
canonical numeric stringとは、CanonicalNumericIndexString抽象操作が
7.1.23 ToIndex ( arg )
The abstract operation ToIndex takes argument arg (an ECMAScript language value) and returns either a
- intを ?
ToIntegerOrInfinity (arg) とする。 - intが0から253 - 1までの包含区間内にないなら、
RangeError 例外をthrowする。 - intを返す。
7.2 テストおよび比較操作
7.2.1 RequireObjectCoercible ( arg )
The abstract operation RequireObjectCoercible takes argument arg (an ECMAScript language value) and returns either a
- argが
undefined またはnull のいずれかなら、TypeError 例外をthrowする。 unused を返す。
7.2.2 IsArray ( arg )
The abstract operation IsArray takes argument arg (an ECMAScript language value) and returns either a
- argがObjectでないなら、
false を返す。 - argが
Array exotic object なら、true を返す。 - argが
Proxy exotic object なら、- ?
ValidateNonRevokedProxy (arg)を実行する。 - proxyTargetをarg.[[ProxyTarget]]とする。
- ?
IsArray (proxyTarget)を返す。
- ?
false を返す。
7.2.3 IsCallable ( arg )
The abstract operation IsCallable takes argument arg (an ECMAScript language value) and returns a Boolean. これはargが[[Call]] internal methodを持つcallable functionであるかどうかを決定します。 It performs the following steps when called:
- argがObjectでないなら、
false を返す。 - argが[[Call]] internal methodを持つなら、
true を返す。 false を返す。
7.2.4 IsConstructor ( arg )
The abstract operation IsConstructor takes argument arg (an ECMAScript language value) and returns a Boolean. これはargが[[Construct]] internal methodを持つ
- argがObjectでないなら、
false を返す。 - argが[[Construct]] internal methodを持つなら、
true を返す。 false を返す。
7.2.5 IsExtensible ( obj )
The abstract operation IsExtensible takes argument obj (an Object) and returns either a
- ? obj.[[IsExtensible]]()を返す。
7.2.6 IsRegExp ( arg )
The abstract operation IsRegExp takes argument arg (an ECMAScript language value) and returns either a
- argがObjectでないなら、
false を返す。 - matcherを ?
Get (arg,%Symbol.match% ) とする。 - matcherが
undefined でないなら、ToBoolean (matcher)を返す。 - argが[[RegExpMatcher]] internal slotを持つなら、
true を返す。 false を返す。
7.2.7 Static Semantics: IsStringWellFormedUnicode ( string )
The abstract operation IsStringWellFormedUnicode takes argument string (a String) and returns a Boolean. これは
- lengthをstringの長さとする。
- kを0とする。
- k < lengthの間、繰り返す
- codePointを
CodePointAt (string, k)とする。 - codePoint.[[IsUnpairedSurrogate]]が
true なら、false を返す。 - kをk + codePoint.[[CodeUnitCount]]に設定する。
- codePointを
true を返す。
7.2.8 SameType ( x, y )
The abstract operation SameType takes arguments x (an ECMAScript language value) and y (an ECMAScript language value) and returns a Boolean. これは2つのargumentsが同じ型であるかどうかを決定します。 It performs the following steps when called:
- xが
undefined かつyがundefined なら、true を返す。 - xが
null かつyがnull なら、true を返す。 - xがBooleanかつyがBooleanなら、
true を返す。 - xがNumberかつyがNumberなら、
true を返す。 - xがBigIntかつyがBigIntなら、
true を返す。 - xがSymbolかつyがSymbolなら、
true を返す。 - xがStringかつyがStringなら、
true を返す。 - xがObjectかつyがObjectなら、
true を返す。 false を返す。
7.2.9 SameValue ( x, y )
The abstract operation SameValue takes arguments x (an ECMAScript language value) and y (an ECMAScript language value) and returns a Boolean. これは2つのargumentsが同じ値であるかどうかを決定します。 It performs the following steps when called:
SameType (x, y)がfalse なら、false を返す。- xがNumberなら、
Number::sameValue (x, y)を返す。
SameValueNonNumber (x, y)を返す。
このアルゴリズムは、すべての
7.2.10 SameValueZero ( x, y )
The abstract operation SameValueZero takes arguments x (an ECMAScript language value) and y (an ECMAScript language value) and returns a Boolean. これは2つのargumentsが同じ値であるかどうかを決定します（
SameType (x, y)がfalse なら、false を返す。- xがNumberなら、
Number::sameValueZero (x, y)を返す。
SameValueNonNumber (x, y)を返す。
SameValueZeroは、
7.2.11 SameValueNonNumber ( x, y )
The abstract operation SameValueNonNumber takes arguments x (an ECMAScript language value, but not a Number) and y (an ECMAScript language value, but not a Number) and returns a Boolean. It performs the following steps when called:
Assert :SameType (x, y)はtrue である。- xが
undefined またはnull のいずれかなら、true を返す。 - xがBigIntなら、
BigInt::equal (x, y)を返す。
- xがStringなら、
- xとyが同じ長さを持ち、同じ位置に同じcode unitsを持つなら、
true を返す。 false を返す。
- xとyが同じ長さを持ち、同じ位置に同じcode unitsを持つなら、
- xがBooleanなら、
- xが
true かつyがtrue なら、true を返す。 - xが
false かつyがfalse なら、true を返す。 false を返す。
- xが
NOTE : その他すべてのECMAScript言語値 はidentityによって比較されます。- xがyなら、
true を返す。 false を返す。
7.2.12 IsLessThan ( x, y, leftFirst )
The abstract operation IsLessThan takes arguments x (an ECMAScript language value), y (an ECMAScript language value), and leftFirst (a Boolean) and returns either a
- leftFirstが
true なら、- pxを ?
ToPrimitive (x,number ) とする。 - pyを ?
ToPrimitive (y,number ) とする。
- pxを ?
- そうでなければ、
NOTE : 左から右への評価を保持するため、評価の順序を反転する必要があります。- pyを ?
ToPrimitive (y,number ) とする。 - pxを ?
ToPrimitive (x,number ) とする。
- pxがStringかつpyがStringなら、
- pxがBigIntかつpyがStringなら、
- nyを
StringToBigInt (py)とする。 - nyが
undefined なら、undefined を返す。 BigInt::lessThan (px, ny)を返す。
- nyを
- pxがStringかつpyがBigIntなら、
- nxを
StringToBigInt (px)とする。 - nxが
undefined なら、undefined を返す。 BigInt::lessThan (nx, py)を返す。
- nxを
NOTE : pxとpyはprimitive valuesであるため、評価順序は重要ではありません。- nxを ?
ToNumeric (px) とする。 - nyを ?
ToNumeric (py) とする。 SameType (nx, ny)がtrue なら、- nxがNumberなら、
Number::lessThan (nx, ny)を返す。 Assert : nxはBigIntである。BigInt::lessThan (nx, ny)を返す。
- nxがNumberなら、
Assert : nxはBigIntかつnyはNumberである、またはnxはNumberかつnyはBigIntである。- nxが
NaN またはnyがNaN なら、undefined を返す。 - nxが
-∞ 𝔽またはnyが+∞ 𝔽なら、true を返す。 - nxが
+∞ 𝔽またはnyが-∞ 𝔽なら、false を返す。 ℝ (nx) <ℝ (ny)なら、true を返す。false を返す。
Stringsの比較は、UTF-16 code unit値の列に対する単純なlexicographic orderingを使用します。Unicode仕様で定義される文字または文字列の等価性およびcollating orderについての、より複雑で意味論志向の定義を使用しようとはしません。したがって、Unicode Standardに従ってcanonically equalであるString値でも、同じ正規化形式でない場合は等しくないと判定され得ます。また、
7.2.13 IsLooselyEqual ( x, y )
The abstract operation IsLooselyEqual takes arguments x (an ECMAScript language value) and y (an ECMAScript language value) and returns either a ==演算子の意味論を提供します。 It performs the following steps when called:
SameType (x, y)がtrue なら、IsStrictlyEqual (x, y)を返す。
- xが
null かつyがundefined なら、true を返す。 - xが
undefined かつyがnull なら、true を返す。 - hostがweb browserであるか、または他の方法で
[[IsHTMLDDA]] Internal Slot をサポートするなら、- xがObjectであり、xが[[IsHTMLDDA]] internal slotを持ち、かつyが
undefined またはnull のいずれかなら、true を返す。 - xが
undefined またはnull のいずれかであり、yがObjectであり、かつyが[[IsHTMLDDA]] internal slotを持つなら、true を返す。
- xがObjectであり、xが[[IsHTMLDDA]] internal slotを持ち、かつyが
- xがNumberかつyがStringなら、!
IsLooselyEqual (x, !ToNumber (y))を返す。 - xがStringかつyがNumberなら、!
IsLooselyEqual (!ToNumber (x), y)を返す。 - xがBigIntかつyがStringなら、
- nを
StringToBigInt (y)とする。 - nが
undefined なら、false を返す。 - !
IsLooselyEqual (x, n)を返す。
- nを
- xがStringかつyがBigIntなら、!
IsLooselyEqual (y, x)を返す。 - xがBooleanなら、!
IsLooselyEqual (!ToNumber (x), y)を返す。 - yがBooleanなら、!
IsLooselyEqual (x, !ToNumber (y))を返す。 - xがString、Number、BigInt、またはSymbolのいずれかであり、yがObjectなら、!
IsLooselyEqual (x, ?ToPrimitive (y))を返す。 - xがObjectであり、yがString、Number、BigInt、またはSymbolのいずれかなら、!
IsLooselyEqual (?ToPrimitive (x), y)を返す。 - xがBigIntかつyがNumberである、またはxがNumberかつyがBigIntであるなら、
false を返す。
7.2.14 IsStrictlyEqual ( x, y )
The abstract operation IsStrictlyEqual takes arguments x (an ECMAScript language value) and y (an ECMAScript language value) and returns a Boolean. これは===演算子の意味論を提供します。 It performs the following steps when called:
SameType (x, y)がfalse なら、false を返す。- xがNumberなら、
Number::equal (x, y)を返す。
SameValueNonNumber (x, y)を返す。
このアルゴリズムは、signed zeroesおよびNaNsの扱いにおいて
7.3 オブジェクト上の操作
7.3.1 MakeBasicObject ( internalSlotsList )
The abstract operation MakeBasicObject takes argument internalSlotsList (a
- internalSlotsListを、internalSlotsListと« [[PrivateElements]] »の
list-concatenation に設定する。 - objを、internalSlotsList内の各名前に対するinternal slotを持つ新しく作成されたオブジェクトとする。
NOTE :Object Internal Methods and Internal Slots で記述されるように、各そのようなinternal slotの初期値は、別途指定されない限りundefined です。- obj.[[PrivateElements]]を新しい空の
List に設定する。 - objのessential internal methodsを、
10.1 で指定されるデフォルトのordinary object 定義に設定する。 Assert : 呼び出し元がobjの[[GetPrototypeOf]]および[[SetPrototypeOf]] essential internal methodsの両方を上書きしないなら、internalSlotsListは[[Prototype]]を含む。Assert : 呼び出し元がobjの[[SetPrototypeOf]]、[[IsExtensible]]、および[[PreventExtensions]] essential internal methodsのすべてを上書きしないなら、internalSlotsListは[[Extensible]]を含む。- internalSlotsListが[[Extensible]]を含むなら、obj.[[Extensible]]を
true に設定する。 - objを返す。
この仕様内では、
7.3.2 Get ( obj, propertyKey )
The abstract operation Get takes arguments obj (an Object) and propertyKey (a
- ? obj.[[Get]](propertyKey, obj)を返す。
7.3.3 GetV ( value, propertyKey )
The abstract operation GetV takes arguments value (an ECMAScript language value) and propertyKey (a
- objを ?
ToObject (value) とする。 - ? obj.[[Get]](propertyKey, value)を返す。
7.3.4 Set ( obj, propertyKey, value, throw )
The abstract operation Set takes arguments obj (an Object), propertyKey (a
- successを ? obj.[[Set]](propertyKey, value, obj) とする。
- successが
false かつthrowがtrue なら、TypeError 例外をthrowする。 unused を返す。
7.3.5 CreateDataProperty ( obj, propertyKey, value )
The abstract operation CreateDataProperty takes arguments obj (an Object), propertyKey (a
- newDescをPropertyDescriptor { [[Value]]: value, [[Writable]]:
true , [[Enumerable]]:true , [[Configurable]]:true }とする。 - ? obj.[[DefineOwnProperty]](propertyKey, newDesc)を返す。
この抽象操作は、ECMAScript言語の代入演算子によって作成されるプロパティに使用されるものと同じデフォルトに属性が設定されたプロパティを作成します。通常、そのプロパティはまだ存在しません。存在していてconfigurableでない場合、またはobjがextensibleでない場合、[[DefineOwnProperty]]は
7.3.6 CreateDataPropertyOrThrow ( obj, propertyKey, value )
The abstract operation CreateDataPropertyOrThrow takes arguments obj (an Object), propertyKey (a
- successを ?
CreateDataProperty (obj, propertyKey, value) とする。 - successが
false なら、TypeError 例外をthrowする。 unused を返す。
この抽象操作は、ECMAScript言語の代入演算子によって作成されるプロパティに使用されるものと同じデフォルトに属性が設定されたプロパティを作成します。通常、そのプロパティはまだ存在しません。存在していてconfigurableでない場合、またはobjがextensibleでない場合、[[DefineOwnProperty]]は
7.3.7 CreateNonEnumerableDataPropertyOrThrow ( obj, propertyKey, value )
The abstract operation CreateNonEnumerableDataPropertyOrThrow takes arguments obj (an Object), propertyKey (a
Assert : objはnon-configurable propertiesを持たないordinaryかつextensibleなオブジェクトである。- newDescをPropertyDescriptor { [[Value]]: value, [[Writable]]:
true , [[Enumerable]]:false , [[Configurable]]:true }とする。 - !
DefinePropertyOrThrow (obj, propertyKey, newDesc)を実行する。 unused を返す。
この抽象操作は、enumerableでない点を除き、ECMAScript言語の代入演算子によって作成されるプロパティに使用されるものと同じデフォルトに属性が設定されたプロパティを作成します。通常、そのプロパティはまだ存在しません。存在する場合でも、
7.3.8 DefinePropertyOrThrow ( obj, propertyKey, propertyDesc )
The abstract operation DefinePropertyOrThrow takes arguments obj (an Object), propertyKey (a
- successを ? obj.[[DefineOwnProperty]](propertyKey, propertyDesc) とする。
- successが
false なら、TypeError 例外をthrowする。 unused を返す。
7.3.9 DeletePropertyOrThrow ( obj, propertyKey )
The abstract operation DeletePropertyOrThrow takes arguments obj (an Object) and propertyKey (a
- successを ? obj.[[Delete]](propertyKey) とする。
- successが
false なら、TypeError 例外をthrowする。 unused を返す。
7.3.10 GetMethod ( value, propertyKey )
The abstract operation GetMethod takes arguments value (an ECMAScript language value) and propertyKey (a
- funcを ?
GetV (value, propertyKey) とする。 - funcが
undefined またはnull のいずれかなら、undefined を返す。 IsCallable (func)がfalse なら、TypeError 例外をthrowする。- funcを返す。
7.3.11 HasProperty ( obj, propertyKey )
The abstract operation HasProperty takes arguments obj (an Object) and propertyKey (a
- ? obj.[[HasProperty]](propertyKey)を返す。
7.3.12 HasOwnProperty ( obj, propertyKey )
The abstract operation HasOwnProperty takes arguments obj (an Object) and propertyKey (a
- propertyDescを ? obj.[[GetOwnProperty]](propertyKey) とする。
- propertyDescが
undefined なら、false を返す。 true を返す。
7.3.13 Call ( func, thisValue [ , argList ] )
The abstract operation Call takes arguments func (an ECMAScript language value) and thisValue (an ECMAScript language value) and optional argument argList (a
- argListが存在しないなら、argListを新しい空の
List に設定する。 IsCallable (func)がfalse なら、TypeError 例外をthrowする。- ? func.[[Call]](thisValue, argList)を返す。
7.3.14 Construct ( ctor [ , argList [ , newTarget ] ] )
The abstract operation Construct takes argument ctor (a
- newTargetが存在しないなら、newTargetをctorに設定する。
- argListが存在しないなら、argListを新しい空の
List に設定する。 - ? ctor.[[Construct]](argList, newTarget)を返す。
newTargetが存在しない場合、この操作はnew F(...argumentsList)と等価です。
7.3.15 SetIntegrityLevel ( obj, level )
The abstract operation SetIntegrityLevel takes arguments obj (an Object) and level (
- statusを ? obj.[[PreventExtensions]]() とする。
- statusが
false なら、false を返す。 - keysを ? obj.[[OwnPropertyKeys]]() とする。
- levelが
sealed なら、- keysの各要素keyについて、以下を行う
- ?
DefinePropertyOrThrow (obj, key, PropertyDescriptor { [[Configurable]]:false })を実行する。
- ?
- keysの各要素keyについて、以下を行う
- そうでなければ、
Assert : levelはfrozen である。- keysの各要素keyについて、以下を行う
- currentDescを ? obj.[[GetOwnProperty]](key) とする。
- currentDescが
undefined でないなら、IsAccessorDescriptor (currentDesc)がtrue なら、- propertyDescをPropertyDescriptor { [[Configurable]]:
false }とする。
- propertyDescをPropertyDescriptor { [[Configurable]]:
- そうでなければ、
- propertyDescをPropertyDescriptor { [[Configurable]]:
false , [[Writable]]:false }とする。
- propertyDescをPropertyDescriptor { [[Configurable]]:
- ?
DefinePropertyOrThrow (obj, key, propertyDesc)を実行する。
true を返す。
7.3.16 TestIntegrityLevel ( obj, level )
The abstract operation TestIntegrityLevel takes arguments obj (an Object) and level (
- extensibleを ?
IsExtensible (obj) とする。 - extensibleが
true なら、false を返す。 NOTE : オブジェクトがextensibleである場合、そのプロパティは一切検査されません。- keysを ? obj.[[OwnPropertyKeys]]() とする。
- keysの各要素keyについて、以下を行う
- currentDescを ? obj.[[GetOwnProperty]](key) とする。
- currentDescが
undefined でないなら、- currentDesc.[[Configurable]]が
true なら、false を返す。 - levelが
frozen かつIsDataDescriptor (currentDesc)がtrue なら、- currentDesc.[[Writable]]が
true なら、false を返す。
- currentDesc.[[Writable]]が
- currentDesc.[[Configurable]]が
true を返す。
7.3.17 CreateArrayFromList ( elements )
The abstract operation CreateArrayFromList takes argument elements (a
- arrayを !
ArrayCreate (0) とする。 - nを0とする。
- elementsの各要素elementについて、以下を行う
- !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (n)), element)を実行する。 - nをn + 1に設定する。
- !
- arrayを返す。
7.3.18 LengthOfArrayLike ( obj )
The abstract operation LengthOfArrayLike takes argument obj (an Object) and returns either a
array-like objectとは、この操作が
7.3.19 CreateListFromArrayLike ( obj [ , validElementTypes ] )
The abstract operation CreateListFromArrayLike takes argument obj (an ECMAScript language value) and optional argument validElementTypes (
- validElementTypesが存在しないなら、validElementTypesを
all に設定する。 - objがObjectでないなら、
TypeError 例外をthrowする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - listを新しい空の
List とする。 - indexを0とする。
- index < lengthの間、繰り返す
- indexNameを !
ToString (𝔽 (index)) とする。 - nextを ?
Get (obj, indexName) とする。 - validElementTypesが
property-key であり、nextがproperty key でないなら、TypeError 例外をthrowする。 - nextをlistへappendする。
- indexをindex + 1に設定する。
- indexNameを !
- listを返す。
7.3.20 Invoke ( value, propertyKey [ , argList ] )
The abstract operation Invoke takes arguments value (an ECMAScript language value) and propertyKey (a
7.3.21 OrdinaryHasInstance ( ctor, instance )
The abstract operation OrdinaryHasInstance takes arguments ctor (an ECMAScript language value) and instance (an ECMAScript language value) and returns either a
IsCallable (ctor)がfalse なら、false を返す。- ctorが[[BoundTargetFunction]] internal slotを持つなら、
- boundCtorをctor.[[BoundTargetFunction]]とする。
- ?
InstanceofOperator (instance, boundCtor)を返す。
- instanceがObjectでないなら、
false を返す。 - protoを ?
Get (ctor,"prototype" ) とする。 - protoがObjectでないなら、
TypeError 例外をthrowする。 - 繰り返す
- instanceを ? instance.[[GetPrototypeOf]]() に設定する。
- instanceが
null なら、false を返す。 SameValue (proto, instance)がtrue なら、true を返す。
7.3.22 SpeciesConstructor ( obj, defaultCtor )
The abstract operation SpeciesConstructor takes arguments obj (an Object) and defaultCtor (a
- ctorを ?
Get (obj,"constructor" ) とする。 - ctorが
undefined なら、defaultCtorを返す。 - ctorがObjectでないなら、
TypeError 例外をthrowする。 - speciesを ?
Get (ctor,%Symbol.species% ) とする。 - speciesが
undefined またはnull のいずれかなら、defaultCtorを返す。 IsConstructor (species)がtrue なら、speciesを返す。TypeError 例外をthrowする。
7.3.23 EnumerableOwnProperties ( obj, kind )
The abstract operation EnumerableOwnProperties takes arguments obj (an Object) and kind (
- ownKeysを ? obj.[[OwnPropertyKeys]]() とする。
- resultsを新しい空の
List とする。 - ownKeysの各要素keyについて、以下を行う
- keyがStringなら、
- propertyDescを ? obj.[[GetOwnProperty]](key) とする。
- propertyDescが
undefined でなく、かつpropertyDesc.[[Enumerable]]がtrue なら、- kindが
key なら、- keyをresultsへappendする。
- そうでなければ、
- valueを ?
Get (obj, key) とする。 - kindが
value なら、- valueをresultsへappendする。
- そうでなければ、
Assert : kindはkey+value である。- entryを
CreateArrayFromList (« key, value »)とする。 - entryをresultsへappendする。
- valueを ?
- kindが
- keyがStringなら、
- resultsを返す。
7.3.24 GetFunctionRealm ( func )
The abstract operation GetFunctionRealm takes argument func (a
- funcが[[Realm]] internal slotを持つなら、
- func.[[Realm]]を返す。
- funcが
bound function exotic object なら、- boundTargetFuncをfunc.[[BoundTargetFunction]]とする。
- ?
GetFunctionRealm (boundTargetFunc)を返す。
- funcが
Proxy exotic object なら、- ?
ValidateNonRevokedProxy (func)を実行する。 - proxyTargetをfunc.[[ProxyTarget]]とする。
Assert : proxyTargetはfunction object である。- ?
GetFunctionRealm (proxyTarget)を返す。
- ?
current Realm Record を返す。
ステップ
7.3.25 CopyDataProperties ( target, source, excludedItems )
The abstract operation CopyDataProperties takes arguments target (an Object), source (an ECMAScript language value), and excludedItems (a
- sourceが
undefined またはnull のいずれかなら、unused を返す。 - fromを !
ToObject (source) とする。 - keysを ? from.[[OwnPropertyKeys]]() とする。
- keysの各要素nextKeyについて、以下を行う
- excludedを
false とする。 - excludedItemsの各要素elementについて、以下を行う
SameValue (element, nextKey)がtrue なら、- excludedを
true に設定する。
- excludedを
- excludedが
false なら、- propertyDescを ? from.[[GetOwnProperty]](nextKey) とする。
- propertyDescが
undefined でなく、かつpropertyDesc.[[Enumerable]]がtrue なら、- propertyValueを ?
Get (from, nextKey) とする。 - !
CreateDataPropertyOrThrow (target, nextKey, propertyValue)を実行する。
- propertyValueを ?
- excludedを
unused を返す。
ここで渡されるtargetは常に新しく作成されたオブジェクトであり、エラーがthrowされた場合に直接アクセスできません。
7.3.26 PrivateElementFind ( obj, privateName )
The abstract operation PrivateElementFind takes arguments obj (an Object) and privateName (a
- obj.[[PrivateElements]]が、entry.[[Key]]がprivateNameであるような
PrivateElement entryを含むなら、- entryを返す。
empty を返す。
7.3.27 PrivateFieldAdd ( obj, privateName, value )
The abstract operation PrivateFieldAdd takes arguments obj (an Object), privateName (a
- hostがweb browserなら、
- ?
HostEnsureCanAddPrivateElement (obj)を実行する。
- ?
- entryを
PrivateElementFind (obj, privateName)とする。 - entryが
empty でないなら、TypeError 例外をthrowする。 PrivateElement { [[Key]]: privateName, [[Kind]]:field , [[Value]]: value }をobj.[[PrivateElements]]へappendする。unused を返す。
7.3.28 PrivateMethodOrAccessorAdd ( obj, method )
The abstract operation PrivateMethodOrAccessorAdd takes arguments obj (an Object) and method (a
Assert : method.[[Kind]]はmethod またはaccessor のいずれかである。- hostがweb browserなら、
- ?
HostEnsureCanAddPrivateElement (obj)を実行する。
- ?
- entryを
PrivateElementFind (obj, method.[[Key]])とする。 - entryが
empty でないなら、TypeError 例外をthrowする。 - methodをobj.[[PrivateElements]]へappendする。
unused を返す。
private methodsおよびaccessorsの値は、インスタンス間で共有されます。この操作はmethodまたはaccessorの新しいcopyを作成しません。
7.3.29 HostEnsureCanAddPrivateElement ( obj )
The
HostEnsureCanAddPrivateElementの実装は、以下の要件に従わなければなりません：
- objが
host-defined exotic object でない場合、この抽象操作はNormalCompletion (unused )を返し、他のステップを実行してはなりません。 - 同じargumentでこの抽象操作を2回呼び出した場合、同じ種類の
Completion Record を返さなければなりません。
HostEnsureCanAddPrivateElementのデフォルト実装は、
この抽象操作は、web browsersであるECMAScript
7.3.30 PrivateGet ( obj, privateName )
The abstract operation PrivateGet takes arguments obj (an Object) and privateName (a
- entryを
PrivateElementFind (obj, privateName)とする。 - entryが
empty なら、TypeError 例外をthrowする。 - entry.[[Kind]]が
field またはmethod のいずれかなら、- entry.[[Value]]を返す。
Assert : entry.[[Kind]]はaccessor である。- entry.[[Get]]が
undefined なら、TypeError 例外をthrowする。 - getterをentry.[[Get]]とする。
- ?
Call (getter, obj)を返す。
7.3.31 PrivateSet ( obj, privateName, value )
The abstract operation PrivateSet takes arguments obj (an Object), privateName (a
- entryを
PrivateElementFind (obj, privateName)とする。 - entryが
empty なら、TypeError 例外をthrowする。 - entry.[[Kind]]が
method なら、TypeError 例外をthrowする。 - entry.[[Kind]]が
field なら、- entry.[[Value]]をvalueに設定する。
- そうでなければ、
unused を返す。
7.3.32 DefineField ( receiver, fieldRecord )
The abstract operation DefineField takes arguments receiver (an Object) and fieldRecord (a
- fieldNameをfieldRecord.[[Name]]とする。
- initializerをfieldRecord.[[Initializer]]とする。
- initializerが
empty でないなら、- initValueを ?
Call (initializer, receiver) とする。
- initValueを ?
- そうでなければ、
- initValueを
undefined とする。
- initValueを
- fieldNameが
Private Name なら、- ?
PrivateFieldAdd (receiver, fieldName, initValue)を実行する。
- ?
- そうでなければ、
Assert : fieldNameはproperty key である。- ?
CreateDataPropertyOrThrow (receiver, fieldName, initValue)を実行する。
unused を返す。
7.3.33 InitializeInstanceElements ( obj, ctor )
The abstract operation InitializeInstanceElements takes arguments obj (an Object) and ctor (an ECMAScript
- methodsをctor.[[PrivateMethods]]とする。
- methodsの各
PrivateElement methodについて、以下を行う- ?
PrivateMethodOrAccessorAdd (obj, method)を実行する。
- ?
- fieldsをctor.[[Fields]]とする。
- fieldsの各要素fieldRecordについて、以下を行う
- ?
DefineField (obj, fieldRecord)を実行する。
- ?
unused を返す。
7.3.34 AddValueToKeyedGroup ( groups, key, value )
The abstract operation AddValueToKeyedGroup takes arguments groups (a
7.3.35 GroupBy ( items, callback, keyCoercion )
The abstract operation GroupBy takes arguments items (an ECMAScript language value), callback (an ECMAScript language value), and keyCoercion (
- ?
RequireObjectCoercible (items)を実行する。 IsCallable (callback)がfalse なら、TypeError 例外をthrowする。- groupsを新しい空の
List とする。 - iteratorRecordを ?
GetIterator (items,sync ) とする。 - kを0とする。
- 繰り返す
- k ≥ 253 - 1なら、
- errorを
ThrowCompletion (a newly createdTypeError object)とする。 - ?
IteratorClose (iteratorRecord, error)を返す。
- errorを
- nextを ?
IteratorStepValue (iteratorRecord) とする。 - nextが
done なら、- groupsを返す。
- valueをnextとする。
- keyを
Completion (Call (callback,undefined , « value,𝔽 (k) »))とする。 IfAbruptCloseIterator (key, iteratorRecord).- keyCoercionが
property なら、- keyを
Completion (ToPropertyKey (key))に設定する。 IfAbruptCloseIterator (key, iteratorRecord).
- keyを
- そうでなければ、
Assert : keyCoercionはcollection である。- keyを
CanonicalizeKeyedCollectionKey (key)に設定する。
AddValueToKeyedGroup (groups, key, value)を実行する。- kをk + 1に設定する。
- k ≥ 253 - 1なら、
7.3.36 GetOptionsObject ( options )
The abstract operation GetOptionsObject takes argument options (an ECMAScript language value) and returns either a
- optionsが
undefined なら、OrdinaryObjectCreate (null )を返す。
- optionsがObjectなら、
- optionsを返す。
TypeError 例外をthrowする。
7.3.37 SetterThatIgnoresPrototypeProperties ( thisValue, home, propertyKey, value )
The abstract operation SetterThatIgnoresPrototypeProperties takes arguments thisValue (an ECMAScript language value), home (an Object), propertyKey (a
- thisValueがObjectでないなら、
TypeError 例外をthrowする。
SameValue (thisValue, home)がtrue なら、NOTE : ここでthrowすることは、strict mode code においてhomeオブジェクト上のnon-writabledata property へ代入することを模倣します。TypeError 例外をthrowする。
- propertyDescを ? thisValue.[[GetOwnProperty]](propertyKey) とする。
- propertyDescが
undefined なら、- ?
CreateDataPropertyOrThrow (thisValue, propertyKey, value)を実行する。
- ?
- そうでなければ、
- ?
Set (thisValue, propertyKey, value,true )を実行する。
- ?
unused を返す。
7.4 Iterator Objects上の操作
Common Iteration Interfaces（
7.4.1 Iterator Records
Iterator Recordは、nextメソッドとともにカプセル化するために使用される
Iterator Recordsは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Iterator]] | Object |
|
| [[NextMethod]] |
|
[[Iterator]]オブジェクトのnextメソッド。
|
| [[Done]] | Boolean |
|
7.4.2 GetIteratorDirect ( obj )
The abstract operation GetIteratorDirect takes argument obj (an Object) and returns either a
- nextMethodを ?
Get (obj,"next" ) とする。 - iteratorRecordを
Iterator Record { [[Iterator]]: obj, [[NextMethod]]: nextMethod, [[Done]]:false }とする。 - iteratorRecordを返す。
7.4.3 GetIteratorFromMethod ( obj, method )
The abstract operation GetIteratorFromMethod takes arguments obj (an ECMAScript language value) and method (a
- iteratorを ?
Call (method, obj) とする。 - iteratorがObjectでないなら、
TypeError 例外をthrowする。 - ?
GetIteratorDirect (iterator)を返す。
7.4.4 GetIterator ( obj, kind )
The abstract operation GetIterator takes arguments obj (an ECMAScript language value) and kind (
- kindが
async なら、- methodを ?
GetMethod (obj,%Symbol.asyncIterator% ) とする。 - methodが
undefined なら、- syncMethodを ?
GetMethod (obj,%Symbol.iterator% ) とする。 - syncMethodが
undefined なら、TypeError 例外をthrowする。 - syncIteratorRecordを ?
GetIteratorFromMethod (obj, syncMethod) とする。 CreateAsyncFromSyncIterator (syncIteratorRecord)を返す。
- syncMethodを ?
- methodを ?
- そうでなければ、
- methodを ?
GetMethod (obj,%Symbol.iterator% ) とする。
- methodを ?
- methodが
undefined なら、TypeError 例外をthrowする。 - ?
GetIteratorFromMethod (obj, method)を返す。
7.4.5 GetIteratorFlattenable ( obj, primitiveHandling )
The abstract operation GetIteratorFlattenable takes arguments obj (an ECMAScript language value) and primitiveHandling (
- objがObjectでないなら、
- primitiveHandlingが
reject-primitives なら、TypeError 例外をthrowする。 Assert : primitiveHandlingはiterate-string-primitives である。- objがStringでないなら、
TypeError 例外をthrowする。
- primitiveHandlingが
- methodを ?
GetMethod (obj,%Symbol.iterator% ) とする。 - methodが
undefined なら、- iteratorをobjとする。
- そうでなければ、
- iteratorを ?
Call (method, obj) とする。
- iteratorを ?
- iteratorがObjectでないなら、
TypeError 例外をthrowする。 - ?
GetIteratorDirect (iterator)を返す。
7.4.6 IteratorNext ( iteratorRecord [ , value ] )
The abstract operation IteratorNext takes argument iteratorRecord (an
- valueが存在しないなら、
- resultを
Completion (Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]]))とする。
- resultを
- そうでなければ、
- resultを
Completion (Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]], « value »))とする。
- resultを
- resultが
throw completion なら、- iteratorRecord.[[Done]]を
true に設定する。 - ? resultを返す。
- iteratorRecord.[[Done]]を
- resultを ! result に設定する。
- resultがObjectでないなら、
- iteratorRecord.[[Done]]を
true に設定する。 TypeError 例外をthrowする。
- iteratorRecord.[[Done]]を
- resultを返す。
7.4.7 IteratorComplete ( iteratorResult )
The abstract operation IteratorComplete takes argument iteratorResult (an Object) and returns either a
7.4.8 IteratorValue ( iteratorResult )
The abstract operation IteratorValue takes argument iteratorResult (an Object) and returns either a
- ?
Get (iteratorResult,"value" )を返す。
7.4.9 IteratorStep ( iteratorRecord )
The abstract operation IteratorStep takes argument iteratorRecord (an
- resultを ?
IteratorNext (iteratorRecord) とする。 - doneを
Completion (IteratorComplete (result))とする。 - doneが
throw completion なら、- iteratorRecord.[[Done]]を
true に設定する。 - ? doneを返す。
- iteratorRecord.[[Done]]を
- doneを ! done に設定する。
- doneが
true なら、- iteratorRecord.[[Done]]を
true に設定する。 done を返す。
- iteratorRecord.[[Done]]を
- resultを返す。
7.4.10 IteratorStepValue ( iteratorRecord )
The abstract operation IteratorStepValue takes argument iteratorRecord (an
- resultを ?
IteratorStep (iteratorRecord) とする。 - resultが
done なら、done を返す。
- valueを
Completion (IteratorValue (result))とする。 - valueが
throw completion なら、- iteratorRecord.[[Done]]を
true に設定する。
- iteratorRecord.[[Done]]を
- ? valueを返す。
7.4.11 IteratorClose ( iteratorRecord, completion )
The abstract operation IteratorClose takes arguments iteratorRecord (an
Assert : iteratorRecord.[[Iterator]]はObjectである。- iteratorをiteratorRecord.[[Iterator]]とする。
- innerResultを
Completion (GetMethod (iterator,"return" )))とする。 - innerResultが
normal completion なら、- returnをinnerResult.[[Value]]とする。
- returnが
undefined なら、? completionを返す。 - innerResultを
Completion (Call (return, iterator))に設定する。
- completionが
throw completion なら、? completionを返す。 - innerResultが
throw completion なら、? innerResultを返す。 - innerResult.[[Value]]がObjectでないなら、
TypeError 例外をthrowする。 - ? completionを返す。
7.4.12 IteratorCloseAll ( iterators, completion )
The abstract operation IteratorCloseAll takes arguments iterators (a
- iteratorsの各要素iteratorについて、
List の逆順で、以下を行う- completionを
Completion (IteratorClose (iterator, completion))に設定する。
- completionを
- ? completionを返す。
7.4.13 IfAbruptCloseIterator ( value, iteratorRecord )
IfAbruptCloseIteratorは、
IfAbruptCloseIterator (value, iteratorRecord).
は、次と同じことを意味します：
Assert : valueはCompletion Record である。- valueが
abrupt completion なら、?IteratorClose (iteratorRecord, value)を返す。 - valueを ! value に設定する。
7.4.14 IfAbruptCloseIterators ( value, iteratorRecords )
IfAbruptCloseIteratorsは、
IfAbruptCloseIterators (value, iteratorRecords).
は、次と同じことを意味します：
Assert : valueはCompletion Record である。- valueが
abrupt completion なら、?IteratorCloseAll (iteratorRecords, value)を返す。 - valueを ! value に設定する。
7.4.15 AsyncIteratorClose ( iteratorRecord, completion )
The abstract operation AsyncIteratorClose takes arguments iteratorRecord (an
Assert : iteratorRecord.[[Iterator]]はObjectである。- iteratorをiteratorRecord.[[Iterator]]とする。
- innerResultを
Completion (GetMethod (iterator,"return" )))とする。 - innerResultが
normal completion なら、- returnをinnerResult.[[Value]]とする。
- returnが
undefined なら、? completionを返す。 - innerResultを
Completion (Call (return, iterator))に設定する。 - innerResultが
normal completion なら、innerResultをCompletion (Await (innerResult.[[Value]]))に設定する。
- completionが
throw completion なら、? completionを返す。 - innerResultが
throw completion なら、? innerResultを返す。 - innerResult.[[Value]]がObjectでないなら、
TypeError 例外をthrowする。 - ? completionを返す。
7.4.16 IfAbruptCloseAsyncIterator ( value, iteratorRecord )
IfAbruptCloseAsyncIteratorは、
IfAbruptCloseAsyncIterator (value, iteratorRecord).
は、次と同じことを意味します：
Assert : valueはCompletion Record である。- valueが
abrupt completion なら、?AsyncIteratorClose (iteratorRecord, value)を返す。 - valueを ! value に設定する。
7.4.17 CreateIteratorResultObject ( value, done )
The abstract operation CreateIteratorResultObject takes arguments value (an ECMAScript language value) and done (a Boolean) and returns an Object that conforms to the
- objを
OrdinaryObjectCreate (%Object.prototype% )とする。 - !
CreateDataPropertyOrThrow (obj,"value" , value)を実行する。 - !
CreateDataPropertyOrThrow (obj,"done" , done)を実行する。 - objを返す。
7.4.18 CreateListIteratorRecord ( list )
The abstract operation CreateListIteratorRecord takes argument list (a
- closureを、parametersを持たず、listをcaptureし、呼び出されたときに以下のステップを実行する新しい
Abstract Closure とする：- listの各要素valueについて、以下を行う
- ?
GeneratorYield (CreateIteratorResultObject (value,false ))を実行する。
- ?
NormalCompletion (undefined )を返す。
- listの各要素valueについて、以下を行う
- iteratorを
CreateIteratorFromClosure (closure,empty ,%Iterator.prototype% )とする。 Iterator Record { [[Iterator]]: iterator, [[NextMethod]]: %GeneratorPrototype.next%, [[Done]]:false }を返す。
list
7.4.19 IteratorToList ( iteratorRecord )
The abstract operation IteratorToList takes argument iteratorRecord (an
- valuesを新しい空の
List とする。 - 繰り返す
- nextを ?
IteratorStepValue (iteratorRecord) とする。 - nextが
done なら、- valuesを返す。
- nextをvaluesへappendする。
- nextを ?
7.5 Disposable オブジェクトに対する操作
共通リソース管理インターフェイスを参照（
7.5.1 DisposableResource レコード
DisposableResource レコードは、破棄可能なオブジェクトを、そのオブジェクトを破棄するために使用されるメソッドとともにカプセル化するために使用される
DisposableResource レコードは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[ResourceValue]] |
Object または |
破棄される値。 |
| [[Kind]] |
|
リソースが using 宣言または DisposableStack オブジェクトによって追加されたか（await using 宣言または AsyncDisposableStack オブジェクトによって追加されたか（ |
| [[DisposeMethod]] |
関数オブジェクトまたは |
リソースが破棄されるときに、[[ResourceValue]] をその |
7.5.2 AddDisposableResource ( disposableResourceStack, value, kind [ , method ] )
The abstract operation AddDisposableResource takes arguments disposableResourceStack (
- method が存在する場合、then
Assert : value はundefined である。- Let resource be ?
CreateDisposableResource (undefined , kind, method).
- Else,
- value が
null またはundefined のいずれかであり、かつ kind がsync-dispose である場合、unused を返す。 NOTE : value がnull またはundefined のいずれかであり、かつ kind がasync-dispose である場合、後でリソースが破棄されるときにもAwait が実行されることを確保するため、そのリソースが評価されたことを記録する。- Let resource be ?
CreateDisposableResource (value, kind).
- value が
- resource を disposableResourceStack に追加する。
- Return
unused .
7.5.3 CreateDisposableResource ( value, kind [ , method ] )
The abstract operation CreateDisposableResource takes arguments value (ECMAScript 言語値) and kind (
- method が存在しない場合、then
- value が
null またはundefined のいずれかである場合、then- Set value to
undefined . - Set method to
undefined .
- Set value to
- Else,
- Set method to ?
GetDisposeMethod (value, kind). - method が
undefined である場合、TypeError 例外を投げる。
- Set method to ?
- value が
- Return the DisposableResource
Record { [[ResourceValue]]: value, [[Kind]]: kind, [[DisposeMethod]]: method }.
7.5.4 GetDisposeMethod ( value, kind )
The abstract operation GetDisposeMethod takes arguments value (ECMAScript 言語値) and kind (
- value が Object でない場合、
TypeError 例外を投げる。 - kind が
sync-dispose である場合、return ?GetMethod (value,%Symbol.dispose% ). Assert : kind はasync-dispose である。- Let asyncMethod be ?
GetMethod (value,%Symbol.asyncDispose% ). - asyncMethod が
undefined でない場合、asyncMethod を返す。 - Let syncMethod be ?
GetMethod (value,%Symbol.dispose% ). - syncMethod が
undefined である場合、undefined を返す。 - Let closure be a new
Abstract Closure with no parameters that captures syncMethod and performs the following steps when called:- Let obj be the
this value. - Let promiseCapability be !
NewPromiseCapability (%Promise% ). - Let result be
Completion (Call (syncMethod, obj)). IfAbruptRejectPromise (result, promiseCapability).- Perform !
Call (promiseCapability.[[Resolve]],undefined , «undefined »). - Return promiseCapability.[[Promise]].
- Let obj be the
NOTE : この関数はユーザーコードから観測できない。この関数は、同期的な%Symbol.dispose%メソッドから返された Promise が await されないこと、および同期的な例外が rejected Promise に変換されることを確保するために使用される。- Return
CreateBuiltinFunction (closure, 0,"" , « »).
7.5.5 DisposeResources ( disposableResourceStack, completion )
The abstract operation DisposeResources takes arguments disposableResourceStack (
- Let needsAwait be
false . - Let hasAwaited be
false . - Let outputCompletion be completion.
- disposableResourceStack の各要素 resource について、
List の逆順で、do- Let value be resource.[[ResourceValue]].
- Let kind be resource.[[Kind]].
- Let method be resource.[[DisposeMethod]].
- kind が
sync-dispose であり、needsAwait がtrue であり、かつ hasAwaited がfalse である場合、then- Perform !
Await (undefined ). - Set needsAwait to
false .
- Perform !
- method が
undefined でない場合、then- Let result be
Completion (Call (method, value)). - result が
normal completion であり、かつ kind がasync-dispose である場合、then- Set result to
Completion (Await (result.[[Value]])). - Set hasAwaited to
true .
- Set result to
- result が
throw completion である場合、then- outputCompletion が
throw completion である場合、then- Set result to result.[[Value]].
- Let suppressed be outputCompletion.[[Value]].
- Let error be a newly created
SuppressedError object. - Perform
CreateNonEnumerableDataPropertyOrThrow (error,"error" , result). - Perform
CreateNonEnumerableDataPropertyOrThrow (error,"suppressed" , suppressed). - Set outputCompletion to
ThrowCompletion (error).
- Else,
- Set outputCompletion to result.
- outputCompletion が
- Let result be
- Else,
- needsAwait が
true であり、かつ hasAwaited がfalse である場合、then- Perform !
Await (undefined ).
- Perform !
NOTE : この時点で disposableResourceStack は二度と使用されない。disposableResourceStack の内容は、ガベージコレクションなどにより、実装内で破棄できる。- Return ? outputCompletion.
8 構文指向操作
この節で定義されるものに加えて、特殊化された構文指向操作がこの仕様全体にわたって定義されます。
8.1 Runtime Semantics: Evaluation
The
8.2 Scope Analysis
8.2.1 Static Semantics: BoundNames
The
It is defined piecewise over the following productions:
- 唯一の要素が
Identifier のStringValue であるList を返す。
- «
"yield" »を返す。
- «
"await" »を返す。
BindingList のBoundNames を返す。
- names1を
BindingList のBoundNames とする。 - names2を
LexicalBinding のBoundNames とする。 - names1とnames2の
list-concatenation を返す。
- names1を
VariableDeclarationList のBoundNames とする。 - names2を
VariableDeclaration のBoundNames とする。 - names1とnames2の
list-concatenation を返す。
- 新しい空の
List を返す。
- names1を
BindingPropertyList のBoundNames とする。 - names2を
BindingRestProperty のBoundNames とする。 - names1とnames2の
list-concatenation を返す。
- 新しい空の
List を返す。
- names1を
BindingElementList のBoundNames とする。 - names2を
BindingRestElement のBoundNames とする。 - names1とnames2の
list-concatenation を返す。
- names1を
BindingPropertyList のBoundNames とする。 - names2を
BindingProperty のBoundNames とする。 - names1とnames2の
list-concatenation を返す。
- names1を
BindingElementList のBoundNames とする。 - names2を
BindingElisionElement のBoundNames とする。 - names1とnames2の
list-concatenation を返す。
ForBinding のBoundNames を返す。
- «
"*default*" »を返す。
- 新しい空の
List を返す。
- names1を
FormalParameterList のBoundNames とする。 - names2を
FunctionRestParameter のBoundNames とする。 - names1とnames2の
list-concatenation を返す。
- names1を
FormalParameterList のBoundNames とする。 - names2を
FormalParameter のBoundNames とする。 - names1とnames2の
list-concatenation を返す。
- formalsを、
CoverParenthesizedExpressionAndArrowParameterList によってcoverされるArrowFormalParameters とする。 - formalsの
BoundNames を返す。
- «
"*default*" »を返す。
- «
"*default*" »を返す。
- «
"*default*" »を返す。
- «
"*default*" »を返す。
- headを、
CoverCallExpressionAndAsyncArrowHead によってcoverされるAsyncArrowHead とする。 - headの
BoundNames を返す。
- 新しい空の
List を返す。
- names1を
ImportedDefaultBinding のBoundNames とする。 - names2を
NameSpaceImport のBoundNames とする。 - names1とnames2の
list-concatenation を返す。
- names1を
ImportedDefaultBinding のBoundNames とする。 - names2を
NamedImports のBoundNames とする。 - names1とnames2の
list-concatenation を返す。
- 新しい空の
List を返す。
- names1を
ImportsList のBoundNames とする。 - names2を
ImportSpecifier のBoundNames とする。 - names1とnames2の
list-concatenation を返す。
- 新しい空の
List を返す。
- declNamesを
HoistableDeclaration のBoundNames とする。 - declNamesが要素
"*default*" を含まないなら、"*default*" をdeclNamesへappendする。 - declNamesを返す。
- declNamesを
ClassDeclaration のBoundNames とする。 - declNamesが要素
"*default*" を含まないなら、"*default*" をdeclNamesへappendする。 - declNamesを返す。
- «
"*default*" »を返す。
8.2.2 Static Semantics: DeclarationPart
The
ClassDeclaration を返す。
8.2.3 Static Semantics: IsConstantDeclaration
The
false を返す。
true を返す。
true を返す。
false を返す。
false を返す。
false を返す。
export default
8.2.4 Static Semantics: IsUsingDeclaration
The
false を返す。
true を返す。
false を返す。
true を返す。
false を返す。
false を返す。
8.2.5 Static Semantics: IsAwaitUsingDeclaration
The
false を返す。
false を返す。
true を返す。
false を返す。
false を返す。
true を返す。
false を返す。
false を返す。
8.2.6 Static Semantics: LexicallyDeclaredNames
The
- 新しい空の
List を返す。
- names1を
StatementList のLexicallyDeclaredNames とする。 - names2を
StatementListItem のLexicallyDeclaredNames とする。 - names1とnames2の
list-concatenation を返す。
Statement がStatement : LabelledStatement LabelledStatement のLexicallyDeclaredNames を返す。- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 最初の
CaseClauses が存在するなら、names1を最初のCaseClauses のLexicallyDeclaredNames とする。 - そうでなければ、names1を新しい空の
List とする。 - names2を
DefaultClause のLexicallyDeclaredNames とする。 - 2番目の
CaseClauses が存在するなら、names3を2番目のCaseClauses のLexicallyDeclaredNames とする。 - そうでなければ、names3を新しい空の
List とする。 - names1、names2、およびnames3の
list-concatenation を返す。
- names1を
CaseClauses のLexicallyDeclaredNames とする。 - names2を
CaseClause のLexicallyDeclaredNames とする。 - names1とnames2の
list-concatenation を返す。
StatementList が存在するなら、StatementList のLexicallyDeclaredNames を返す。- 新しい空の
List を返す。
StatementList が存在するなら、StatementList のLexicallyDeclaredNames を返す。- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- names1を
ModuleItemList のLexicallyDeclaredNames とする。 - names2を
ModuleItem のLexicallyDeclaredNames とする。 - names1とnames2の
list-concatenation を返す。
ExportDeclaration がexportVariableStatement であるなら、新しい空のList を返す。ExportDeclaration のBoundNames を返す。
8.2.7 Static Semantics: LexicallyScopedDeclarations
The
- decls1を
StatementList のLexicallyScopedDeclarations とする。 - decls2を
StatementListItem のLexicallyScopedDeclarations とする。 - decls1とdecls2の
list-concatenation を返す。
Statement がStatement : LabelledStatement LabelledStatement のLexicallyScopedDeclarations を返す。- 新しい空の
List を返す。
- 唯一の要素が
Declaration のDeclarationPart であるList を返す。
- 新しい空の
List を返す。
- 最初の
CaseClauses が存在するなら、decls1を最初のCaseClauses のLexicallyScopedDeclarations とする。 - そうでなければ、decls1を新しい空の
List とする。 - decls2を
DefaultClause のLexicallyScopedDeclarations とする。 - 2番目の
CaseClauses が存在するなら、decls3を2番目のCaseClauses のLexicallyScopedDeclarations とする。 - そうでなければ、decls3を新しい空の
List とする。 - decls1、decls2、およびdecls3の
list-concatenation を返す。
- decls1を
CaseClauses のLexicallyScopedDeclarations とする。 - decls2を
CaseClause のLexicallyScopedDeclarations とする。 - decls1とdecls2の
list-concatenation を返す。
StatementList が存在するなら、StatementList のLexicallyScopedDeclarations を返す。- 新しい空の
List を返す。
StatementList が存在するなら、StatementList のLexicallyScopedDeclarations を返す。- 新しい空の
List を返す。
- 新しい空の
List を返す。
- «
FunctionDeclaration »を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- decls1を
ModuleItemList のLexicallyScopedDeclarations とする。 - decls2を
ModuleItem のLexicallyScopedDeclarations とする。 - decls1とdecls2の
list-concatenation を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 唯一の要素が
Declaration のDeclarationPart であるList を返す。
- 唯一の要素が
HoistableDeclaration のDeclarationPart であるList を返す。
- 唯一の要素が
ClassDeclaration であるList を返す。
- 唯一の要素がこの
ExportDeclaration であるList を返す。
8.2.8 Static Semantics: VarDeclaredNames
The
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- names1を
StatementList のVarDeclaredNames とする。 - names2を
StatementListItem のVarDeclaredNames とする。 - names1とnames2の
list-concatenation を返す。
- 新しい空の
List を返す。
- names1を最初の
Statement のVarDeclaredNames とする。 - names2を2番目の
Statement のVarDeclaredNames とする。 - names1とnames2の
list-concatenation を返す。
- names1を
VariableDeclarationList のBoundNames とする。 - names2を
Statement のVarDeclaredNames とする。 - names1とnames2の
list-concatenation を返す。
- names1を
ForBinding のBoundNames とする。 - names2を
Statement のVarDeclaredNames とする。 - names1とnames2の
list-concatenation を返す。
この節はAnnex
- 新しい空の
List を返す。
- 最初の
CaseClauses が存在するなら、names1を最初のCaseClauses のVarDeclaredNames とする。 - そうでなければ、names1を新しい空の
List とする。 - names2を
DefaultClause のVarDeclaredNames とする。 - 2番目の
CaseClauses が存在するなら、names3を2番目のCaseClauses のVarDeclaredNames とする。 - そうでなければ、names3を新しい空の
List とする。 - names1、names2、およびnames3の
list-concatenation を返す。
- names1を
CaseClauses のVarDeclaredNames とする。 - names2を
CaseClause のVarDeclaredNames とする。 - names1とnames2の
list-concatenation を返す。
StatementList が存在するなら、StatementList のVarDeclaredNames を返す。- 新しい空の
List を返す。
StatementList が存在するなら、StatementList のVarDeclaredNames を返す。- 新しい空の
List を返す。
- 新しい空の
List を返す。
- names1を
Block のVarDeclaredNames とする。 - names2を
Catch のVarDeclaredNames とする。 - names1とnames2の
list-concatenation を返す。
- names1を
Block のVarDeclaredNames とする。 - names2を
Finally のVarDeclaredNames とする。 - names1とnames2の
list-concatenation を返す。
- names1を
Block のVarDeclaredNames とする。 - names2を
Catch のVarDeclaredNames とする。 - names3を
Finally のVarDeclaredNames とする。 - names1、names2、およびnames3の
list-concatenation を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- names1を
ModuleItemList のVarDeclaredNames とする。 - names2を
ModuleItem のVarDeclaredNames とする。 - names1とnames2の
list-concatenation を返す。
- 新しい空の
List を返す。
ExportDeclaration がexportVariableStatement であるなら、ExportDeclaration のBoundNames を返す。- 新しい空の
List を返す。
8.2.9 Static Semantics: VarScopedDeclarations
The
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- decls1を
StatementList のVarScopedDeclarations とする。 - decls2を
StatementListItem のVarScopedDeclarations とする。 - decls1とdecls2の
list-concatenation を返す。
- 新しい空の
List を返す。
- «
VariableDeclaration »を返す。
- decls1を
VariableDeclarationList のVarScopedDeclarations とする。 - decls1と«
VariableDeclaration »のlist-concatenation を返す。
- decls1を最初の
Statement のVarScopedDeclarations とする。 - decls2を2番目の
Statement のVarScopedDeclarations とする。 - decls1とdecls2の
list-concatenation を返す。
- decls1を
VariableDeclarationList のVarScopedDeclarations とする。 - decls2を
Statement のVarScopedDeclarations とする。 - decls1とdecls2の
list-concatenation を返す。
- decls1を«
ForBinding »とする。 - decls2を
Statement のVarScopedDeclarations とする。 - decls1とdecls2の
list-concatenation を返す。
この節はAnnex
- 新しい空の
List を返す。
- 最初の
CaseClauses が存在するなら、decls1を最初のCaseClauses のVarScopedDeclarations とする。 - そうでなければ、decls1を新しい空の
List とする。 - decls2を
DefaultClause のVarScopedDeclarations とする。 - 2番目の
CaseClauses が存在するなら、decls3を2番目のCaseClauses のVarScopedDeclarations とする。 - そうでなければ、decls3を新しい空の
List とする。 - decls1、decls2、およびdecls3の
list-concatenation を返す。
- decls1を
CaseClauses のVarScopedDeclarations とする。 - decls2を
CaseClause のVarScopedDeclarations とする。 - decls1とdecls2の
list-concatenation を返す。
StatementList が存在するなら、StatementList のVarScopedDeclarations を返す。- 新しい空の
List を返す。
StatementList が存在するなら、StatementList のVarScopedDeclarations を返す。- 新しい空の
List を返す。
- 新しい空の
List を返す。
- decls1を
Block のVarScopedDeclarations とする。 - decls2を
Catch のVarScopedDeclarations とする。 - decls1とdecls2の
list-concatenation を返す。
- decls1を
Block のVarScopedDeclarations とする。 - decls2を
Finally のVarScopedDeclarations とする。 - decls1とdecls2の
list-concatenation を返す。
- decls1を
Block のVarScopedDeclarations とする。 - decls2を
Catch のVarScopedDeclarations とする。 - decls3を
Finally のVarScopedDeclarations とする。 - decls1、decls2、およびdecls3の
list-concatenation を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- decls1を
ModuleItemList のVarScopedDeclarations とする。 - decls2を
ModuleItem のVarScopedDeclarations とする。 - decls1とdecls2の
list-concatenation を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 唯一の要素が
Declaration のDeclarationPart であるList を返す。
- 唯一の要素が
HoistableDeclaration のDeclarationPart であるList を返す。
- 唯一の要素が
ClassDeclaration であるList を返す。
- 唯一の要素がこの
ExportDeclaration であるList を返す。
8.2.10 Static Semantics: TopLevelLexicallyDeclaredNames
The
- names1を
StatementList のTopLevelLexicallyDeclaredNames とする。 - names2を
StatementListItem のTopLevelLexicallyDeclaredNames とする。 - names1とnames2の
list-concatenation を返す。
- 新しい空の
List を返す。
Declaration がDeclaration : HoistableDeclaration - 新しい空の
List を返す。
- 新しい空の
Declaration のBoundNames を返す。
functionまたはscriptのtop levelでは、function declarationsはlexical declarationsのようにではなく、var declarationsのように扱われます。
8.2.11 Static Semantics: TopLevelLexicallyScopedDeclarations
The
- decls1を
StatementList のTopLevelLexicallyScopedDeclarations とする。 - decls2を
StatementListItem のTopLevelLexicallyScopedDeclarations とする。 - decls1とdecls2の
list-concatenation を返す。
- 新しい空の
List を返す。
Declaration がDeclaration : HoistableDeclaration - 新しい空の
List を返す。
- 新しい空の
- «
Declaration »を返す。
8.2.12 Static Semantics: TopLevelVarDeclaredNames
The
- names1を
StatementList のTopLevelVarDeclaredNames とする。 - names2を
StatementListItem のTopLevelVarDeclaredNames とする。 - names1とnames2の
list-concatenation を返す。
Declaration がDeclaration : HoistableDeclaration - 新しい空の
List を返す。
functionまたはscriptのtop levelでは、inner function declarationsはvar declarationsのように扱われます。
8.2.13 Static Semantics: TopLevelVarScopedDeclarations
The
- decls1を
StatementList のTopLevelVarScopedDeclarations とする。 - decls2を
StatementListItem のTopLevelVarScopedDeclarations とする。 - decls1とdecls2の
list-concatenation を返す。
Declaration がDeclaration : HoistableDeclaration - declを
HoistableDeclaration のDeclarationPart とする。 - « decl »を返す。
- declを
- 新しい空の
List を返す。
- «
FunctionDeclaration »を返す。
8.3 ラベル
8.3.1 Static Semantics: ContainsDuplicateLabels
The
false を返す。
- hasDuplicatesを、引数labelSetを伴う
StatementList のContainsDuplicateLabels とする。 - hasDuplicatesが
true なら、true を返す。 - 引数labelSetを伴う
StatementListItem のContainsDuplicateLabels を返す。
- hasDuplicateを、引数labelSetを伴う最初の
Statement のContainsDuplicateLabels とする。 - hasDuplicateが
true なら、true を返す。 - 引数labelSetを伴う2番目の
Statement のContainsDuplicateLabels を返す。
- 引数labelSetを伴う
Statement のContainsDuplicateLabels を返す。
- 引数labelSetを伴う
Statement のContainsDuplicateLabels を返す。
- 引数labelSetを伴う
Statement のContainsDuplicateLabels を返す。
- 引数labelSetを伴う
Statement のContainsDuplicateLabels を返す。
- 引数labelSetを伴う
Statement のContainsDuplicateLabels を返す。
この節はAnnex
- 引数labelSetを伴う
Statement のContainsDuplicateLabels を返す。
- 引数labelSetを伴う
CaseBlock のContainsDuplicateLabels を返す。
false を返す。
- 最初の
CaseClauses が存在するなら、- 引数labelSetを伴う最初の
CaseClauses のContainsDuplicateLabels がtrue なら、true を返す。
- 引数labelSetを伴う最初の
- 引数labelSetを伴う
DefaultClause のContainsDuplicateLabels がtrue なら、true を返す。 - 2番目の
CaseClauses が存在しないなら、false を返す。 - 引数labelSetを伴う2番目の
CaseClauses のContainsDuplicateLabels を返す。
- hasDuplicatesを、引数labelSetを伴う
CaseClauses のContainsDuplicateLabels とする。 - hasDuplicatesが
true なら、true を返す。 - 引数labelSetを伴う
CaseClause のContainsDuplicateLabels を返す。
StatementList が存在するなら、引数labelSetを伴うStatementList のContainsDuplicateLabels を返す。false を返す。
StatementList が存在するなら、引数labelSetを伴うStatementList のContainsDuplicateLabels を返す。false を返す。
- labelを
LabelIdentifier のStringValue とする。 - labelSetがlabelを含むなら、
true を返す。 - newLabelSetをlabelSetと« label »の
list-concatenation とする。 - 引数newLabelSetを伴う
LabelledItem のContainsDuplicateLabels を返す。
false を返す。
- hasDuplicatesを、引数labelSetを伴う
Block のContainsDuplicateLabels とする。 - hasDuplicatesが
true なら、true を返す。 - 引数labelSetを伴う
Catch のContainsDuplicateLabels を返す。
- hasDuplicatesを、引数labelSetを伴う
Block のContainsDuplicateLabels とする。 - hasDuplicatesが
true なら、true を返す。 - 引数labelSetを伴う
Finally のContainsDuplicateLabels を返す。
- 引数labelSetを伴う
Block のContainsDuplicateLabels がtrue なら、true を返す。 - 引数labelSetを伴う
Catch のContainsDuplicateLabels がtrue なら、true を返す。 - 引数labelSetを伴う
Finally のContainsDuplicateLabels を返す。
- 引数labelSetを伴う
Block のContainsDuplicateLabels を返す。
false を返す。
false を返す。
- hasDuplicatesを、引数labelSetを伴う
ModuleItemList のContainsDuplicateLabels とする。 - hasDuplicatesが
true なら、true を返す。 - 引数labelSetを伴う
ModuleItem のContainsDuplicateLabels を返す。
false を返す。
8.3.2 Static Semantics: ContainsUndefinedBreakTarget
The
false を返す。
- hasUndefinedLabelsを、引数labelSetを伴う
StatementList のContainsUndefinedBreakTarget とする。 - hasUndefinedLabelsが
true なら、true を返す。 - 引数labelSetを伴う
StatementListItem のContainsUndefinedBreakTarget を返す。
- hasUndefinedLabelsを、引数labelSetを伴う最初の
Statement のContainsUndefinedBreakTarget とする。 - hasUndefinedLabelsが
true なら、true を返す。 - 引数labelSetを伴う2番目の
Statement のContainsUndefinedBreakTarget を返す。
- 引数labelSetを伴う
Statement のContainsUndefinedBreakTarget を返す。
- 引数labelSetを伴う
Statement のContainsUndefinedBreakTarget を返す。
- 引数labelSetを伴う
Statement のContainsUndefinedBreakTarget を返す。
- 引数labelSetを伴う
Statement のContainsUndefinedBreakTarget を返す。
- 引数labelSetを伴う
Statement のContainsUndefinedBreakTarget を返す。
この節はAnnex
false を返す。
- labelSetが
LabelIdentifier のStringValue を含むなら、false を返す。 true を返す。
- 引数labelSetを伴う
Statement のContainsUndefinedBreakTarget を返す。
- 引数labelSetを伴う
CaseBlock のContainsUndefinedBreakTarget を返す。
false を返す。
- 最初の
CaseClauses が存在するなら、- 引数labelSetを伴う最初の
CaseClauses のContainsUndefinedBreakTarget がtrue なら、true を返す。
- 引数labelSetを伴う最初の
- 引数labelSetを伴う
DefaultClause のContainsUndefinedBreakTarget がtrue なら、true を返す。 - 2番目の
CaseClauses が存在しないなら、false を返す。 - 引数labelSetを伴う2番目の
CaseClauses のContainsUndefinedBreakTarget を返す。
- hasUndefinedLabelsを、引数labelSetを伴う
CaseClauses のContainsUndefinedBreakTarget とする。 - hasUndefinedLabelsが
true なら、true を返す。 - 引数labelSetを伴う
CaseClause のContainsUndefinedBreakTarget を返す。
StatementList が存在するなら、引数labelSetを伴うStatementList のContainsUndefinedBreakTarget を返す。false を返す。
StatementList が存在するなら、引数labelSetを伴うStatementList のContainsUndefinedBreakTarget を返す。false を返す。
- labelを
LabelIdentifier のStringValue とする。 - newLabelSetをlabelSetと« label »の
list-concatenation とする。 - 引数newLabelSetを伴う
LabelledItem のContainsUndefinedBreakTarget を返す。
false を返す。
- hasUndefinedLabelsを、引数labelSetを伴う
Block のContainsUndefinedBreakTarget とする。 - hasUndefinedLabelsが
true なら、true を返す。 - 引数labelSetを伴う
Catch のContainsUndefinedBreakTarget を返す。
- hasUndefinedLabelsを、引数labelSetを伴う
Block のContainsUndefinedBreakTarget とする。 - hasUndefinedLabelsが
true なら、true を返す。 - 引数labelSetを伴う
Finally のContainsUndefinedBreakTarget を返す。
- 引数labelSetを伴う
Block のContainsUndefinedBreakTarget がtrue なら、true を返す。 - 引数labelSetを伴う
Catch のContainsUndefinedBreakTarget がtrue なら、true を返す。 - 引数labelSetを伴う
Finally のContainsUndefinedBreakTarget を返す。
- 引数labelSetを伴う
Block のContainsUndefinedBreakTarget を返す。
false を返す。
false を返す。
- hasUndefinedLabelsを、引数labelSetを伴う
ModuleItemList のContainsUndefinedBreakTarget とする。 - hasUndefinedLabelsが
true なら、true を返す。 - 引数labelSetを伴う
ModuleItem のContainsUndefinedBreakTarget を返す。
false を返す。
8.3.3 Static Semantics: ContainsUndefinedContinueTarget
The
false を返す。
- 引数iterationSetおよび« »を伴う
BlockStatement のContainsUndefinedContinueTarget を返す。
- newIterationSetをiterationSetとlabelSetの
list-concatenation とする。 - 引数newIterationSetおよび« »を伴う
IterationStatement のContainsUndefinedContinueTarget を返す。
- hasUndefinedLabelsを、引数iterationSetおよび« »を伴う
StatementList のContainsUndefinedContinueTarget とする。 - hasUndefinedLabelsが
true なら、true を返す。 - 引数iterationSetおよび« »を伴う
StatementListItem のContainsUndefinedContinueTarget を返す。
- hasUndefinedLabelsを、引数iterationSetおよび« »を伴う最初の
Statement のContainsUndefinedContinueTarget とする。 - hasUndefinedLabelsが
true なら、true を返す。 - 引数iterationSetおよび« »を伴う2番目の
Statement のContainsUndefinedContinueTarget を返す。
- 引数iterationSetおよび« »を伴う
Statement のContainsUndefinedContinueTarget を返す。
- 引数iterationSetおよび« »を伴う
Statement のContainsUndefinedContinueTarget を返す。
- 引数iterationSetおよび« »を伴う
Statement のContainsUndefinedContinueTarget を返す。
- 引数iterationSetおよび« »を伴う
Statement のContainsUndefinedContinueTarget を返す。
- 引数iterationSetおよび« »を伴う
Statement のContainsUndefinedContinueTarget を返す。
この節はAnnex
false を返す。
- iterationSetが
LabelIdentifier のStringValue を含むなら、false を返す。 true を返す。
- 引数iterationSetおよび« »を伴う
Statement のContainsUndefinedContinueTarget を返す。
- 引数iterationSetおよび« »を伴う
CaseBlock のContainsUndefinedContinueTarget を返す。
false を返す。
- 最初の
CaseClauses が存在するなら、- 引数iterationSetおよび« »を伴う最初の
CaseClauses のContainsUndefinedContinueTarget がtrue なら、true を返す。
- 引数iterationSetおよび« »を伴う最初の
- 引数iterationSetおよび« »を伴う
DefaultClause のContainsUndefinedContinueTarget がtrue なら、true を返す。 - 2番目の
CaseClauses が存在しないなら、false を返す。 - 引数iterationSetおよび« »を伴う2番目の
CaseClauses のContainsUndefinedContinueTarget を返す。
- hasUndefinedLabelsを、引数iterationSetおよび« »を伴う
CaseClauses のContainsUndefinedContinueTarget とする。 - hasUndefinedLabelsが
true なら、true を返す。 - 引数iterationSetおよび« »を伴う
CaseClause のContainsUndefinedContinueTarget を返す。
StatementList が存在するなら、引数iterationSetおよび« »を伴うStatementList のContainsUndefinedContinueTarget を返す。false を返す。
StatementList が存在するなら、引数iterationSetおよび« »を伴うStatementList のContainsUndefinedContinueTarget を返す。false を返す。
- labelを
LabelIdentifier のStringValue とする。 - newLabelSetをlabelSetと« label »の
list-concatenation とする。 - 引数iterationSetおよびnewLabelSetを伴う
LabelledItem のContainsUndefinedContinueTarget を返す。
false を返す。
- hasUndefinedLabelsを、引数iterationSetおよび« »を伴う
Block のContainsUndefinedContinueTarget とする。 - hasUndefinedLabelsが
true なら、true を返す。 - 引数iterationSetおよび« »を伴う
Catch のContainsUndefinedContinueTarget を返す。
- hasUndefinedLabelsを、引数iterationSetおよび« »を伴う
Block のContainsUndefinedContinueTarget とする。 - hasUndefinedLabelsが
true なら、true を返す。 - 引数iterationSetおよび« »を伴う
Finally のContainsUndefinedContinueTarget を返す。
- 引数iterationSetおよび« »を伴う
Block のContainsUndefinedContinueTarget がtrue なら、true を返す。 - 引数iterationSetおよび« »を伴う
Catch のContainsUndefinedContinueTarget がtrue なら、true を返す。 - 引数iterationSetおよび« »を伴う
Finally のContainsUndefinedContinueTarget を返す。
- 引数iterationSetおよび« »を伴う
Block のContainsUndefinedContinueTarget を返す。
false を返す。
false を返す。
- hasUndefinedLabelsを、引数iterationSetおよび« »を伴う
ModuleItemList のContainsUndefinedContinueTarget とする。 - hasUndefinedLabelsが
true なら、true を返す。 - 引数iterationSetおよび« »を伴う
ModuleItem のContainsUndefinedContinueTarget を返す。
false を返す。
8.4 関数名推論
8.4.1 Static Semantics: HasName
The
- exprを、
CoverParenthesizedExpressionAndArrowParameterList によってcoverされるParenthesizedExpression とする。 - exprの
IsFunctionDefinition がfalse なら、false を返す。 - exprの
HasName を返す。
false を返す。
true を返す。
8.4.2 Static Semantics: IsFunctionDefinition
The
- exprを、
CoverParenthesizedExpressionAndArrowParameterList によってcoverされるParenthesizedExpression とする。 - exprの
IsFunctionDefinition を返す。
false を返す。
true を返す。
8.4.3 Static Semantics: IsAnonymousFunctionDefinition ( expr )
The abstract operation IsAnonymousFunctionDefinition takes argument expr (an
- exprの
IsFunctionDefinition がfalse なら、false を返す。 - hasNameをexprの
HasName とする。 - hasNameが
true なら、false を返す。 true を返す。
8.4.4 Static Semantics: IsIdentifierRef
The
true を返す。
false を返す。
8.4.5 Runtime Semantics: NamedEvaluation
The
- exprを、
CoverParenthesizedExpressionAndArrowParameterList によってcoverされるParenthesizedExpression とする。 - 引数nameを伴うexprの
NamedEvaluation を ? で返す。
Assert :IsAnonymousFunctionDefinition (Expression )はtrue である。- 引数nameを伴う
Expression のNamedEvaluation を ? で返す。
- 引数nameを伴う
FunctionExpression のInstantiateOrdinaryFunctionExpression を返す。
- 引数nameを伴う
ArrowFunction のInstantiateArrowFunctionExpression を返す。
- sourceTextを、
ClassExpression に一致したsource textとする。 - 引数
undefined 、name、およびsourceTextを伴うClassTail のClassDefinitionEvaluation を ? で返す。
8.5 Contains
8.5.1 Static Semantics: Contains
The
以下に列挙されていない、この仕様内のすべてのgrammar production alternativeは、暗黙的に次のContainsのデフォルト定義を持ちます：
- この
Parse Node の各child node childについて、以下を行う- childがsymbolのinstanceなら、
true を返す。 - childがnonterminalのinstanceなら、
- containedをchild
Contains symbolの結果とする。 - containedが
true なら、true を返す。
- containedをchild
- childがsymbolのinstanceなら、
false を返す。
false を返す。
部分構造に依存する静的意味規則は、一般に関数定義の内部を見ません。
- symbolが
ClassBody なら、true を返す。 - symbolが
ClassHeritage なら、ClassHeritage が存在するなら、true を返す。false を返す。
ClassHeritage が存在するなら、ClassHeritage Contains symbolがtrue なら、true を返す。
- 引数symbolを伴う
ClassBody のComputedPropertyContains の結果を返す。
部分構造に依存する静的意味規則は、
false を返す。
部分構造に依存する静的意味規則は、一般にstatic初期化ブロックの内部を見ません。
- symbolが
NewTarget 、SuperProperty 、SuperCall 、super、またはthisのいずれでもないなら、false を返す。 ArrowParameters Contains symbolがtrue なら、true を返す。ConciseBody Contains symbolを返す。
- formalsを、
CoverParenthesizedExpressionAndArrowParameterList によってcoverされるArrowFormalParameters とする。 - formals
Contains symbolを返す。
- symbolが
NewTarget 、SuperProperty 、SuperCall 、super、またはthisのいずれでもないなら、false を返す。 AsyncConciseBody Contains symbolを返す。
- symbolが
NewTarget 、SuperProperty 、SuperCall 、super、またはthisのいずれでもないなら、false を返す。 - headを、
CoverCallExpressionAndAsyncArrowHead によってcoverされるAsyncArrowHead とする。 - head
Contains symbolがtrue なら、true を返す。 AsyncConciseBody Contains symbolを返す。
Containsは、new.target、this、およびsuperの使用を検出するために使用されます。
- symbolが
MethodDefinition なら、true を返す。 - 引数symbolを伴う
MethodDefinition のComputedPropertyContains の結果を返す。
false を返す。
MemberExpression Contains symbolがtrue なら、true を返す。false を返す。
- symbolが
ReservedWord superなら、true を返す。 false を返す。
CallExpression Contains symbolがtrue なら、true を返す。false を返す。
false を返す。
OptionalChain Contains symbolがtrue なら、true を返す。false を返す。
8.5.2 Static Semantics: ComputedPropertyContains
The
false を返す。
ComputedPropertyName Contains symbolの結果を返す。
- 引数symbolを伴う
ClassElementName のComputedPropertyContains の結果を返す。
- 引数symbolを伴う
ClassElementName のComputedPropertyContains の結果を返す。
- 引数symbolを伴う
ClassElementName のComputedPropertyContains の結果を返す。
- inListを、引数symbolを伴う
ClassElementList のComputedPropertyContains とする。 - inListが
true なら、true を返す。 - 引数symbolを伴う
ClassElement のComputedPropertyContains の結果を返す。
false を返す。
false を返す。
- 引数symbolを伴う
ClassElementName のComputedPropertyContains の結果を返す。
- 引数symbolを伴う
ClassElementName のComputedPropertyContains の結果を返す。
8.6 その他
これらの操作は、この仕様全体の複数の箇所で使用されます。
8.6.1 Runtime Semantics: InstantiateFunctionObject
The
- 引数envRecordおよびprivateEnvを伴う
FunctionDeclaration のInstantiateOrdinaryFunctionObject を返す。
- 引数envRecordおよびprivateEnvを伴う
GeneratorDeclaration のInstantiateGeneratorFunctionObject を返す。
- 引数envRecordおよびprivateEnvを伴う
AsyncGeneratorDeclaration のInstantiateAsyncGeneratorFunctionObject を返す。
- 引数envRecordおよびprivateEnvを伴う
AsyncFunctionDeclaration のInstantiateAsyncFunctionObject を返す。
8.6.2 Runtime Semantics: BindingInitialization
The
envRecordにvar statementsおよび一部の
It is defined piecewise over the following productions:
- nameを
Identifier のStringValue とする。 InitializeBoundName (name, value, envRecord)を ? で返す。
InitializeBoundName ("yield" , value, envRecord)を ? で返す。
InitializeBoundName ("await" , value, envRecord)を ? で返す。
RequireObjectCoercible (value)を ? で実行する。- 引数valueおよびenvRecordを伴う
ObjectBindingPattern のBindingInitialization を ? で返す。
- iteratorRecordを ?
GetIterator (value,sync ) とする。 - resultを、引数iteratorRecordおよびenvRecordを伴う
ArrayBindingPattern のIteratorBindingInitialization のCompletion とする。 - iteratorRecord.[[Done]]が
false なら、IteratorClose (iteratorRecord, result)を ? で返す。 - resultを ? で返す。
unused を返す。
- 引数valueおよびenvRecordを伴う
BindingPropertyList のPropertyBindingInitialization を ? で実行する。 unused を返す。
- excludedNamesを新しい空の
List とする。 - 引数value、envRecord、およびexcludedNamesを伴う
BindingRestProperty のRestBindingInitialization を ? で返す。
- excludedNamesを、引数valueおよびenvRecordを伴う
BindingPropertyList のPropertyBindingInitialization の ? 結果とする。 - 引数value、envRecord、およびexcludedNamesを伴う
BindingRestProperty のRestBindingInitialization を ? で返す。
8.6.2.1 InitializeBoundName ( name, value, envRecord )
The abstract operation InitializeBoundName takes arguments name (a String), value (an ECMAScript language value), and envRecord (an
- envRecordが
undefined でないなら、- envRecord.
InitializeBinding (name, value)を ! で実行する。 unused を返す。
- envRecord.
- lhsを ?
ResolveBinding (name) とする。 PutValue (lhs, value)を ? で返す。
8.6.3 Runtime Semantics: IteratorBindingInitialization
The
envRecordに
It is defined piecewise over the following productions:
unused を返す。
- 引数iteratorRecordを伴う
Elision のIteratorDestructuringAssignmentEvaluation を ? で返す。
Elision が存在するなら、- 引数iteratorRecordを伴う
Elision のIteratorDestructuringAssignmentEvaluation を ? で実行する。
- 引数iteratorRecordを伴う
- 引数iteratorRecordおよびenvRecordを伴う
BindingRestElement のIteratorBindingInitialization を ? で返す。
- 引数iteratorRecordおよびenvRecordを伴う
BindingElementList のIteratorBindingInitialization を ? で実行する。 - 引数iteratorRecordを伴う
Elision のIteratorDestructuringAssignmentEvaluation を ? で返す。
- 引数iteratorRecordおよびenvRecordを伴う
BindingElementList のIteratorBindingInitialization を ? で実行する。 Elision が存在するなら、- 引数iteratorRecordを伴う
Elision のIteratorDestructuringAssignmentEvaluation を ? で実行する。
- 引数iteratorRecordを伴う
- 引数iteratorRecordおよびenvRecordを伴う
BindingRestElement のIteratorBindingInitialization を ? で返す。
- 引数iteratorRecordおよびenvRecordを伴う
BindingElementList のIteratorBindingInitialization を ? で実行する。 - 引数iteratorRecordおよびenvRecordを伴う
BindingElisionElement のIteratorBindingInitialization を ? で返す。
- 引数iteratorRecordを伴う
Elision のIteratorDestructuringAssignmentEvaluation を ? で実行する。 - 引数iteratorRecordおよびenvRecordを伴う
BindingElement のIteratorBindingInitialization を ? で返す。
- bindingIdを
BindingIdentifier のStringValue とする。 - lhsを ?
ResolveBinding (bindingId, envRecord) とする。 - vを
undefined とする。 - iteratorRecord.[[Done]]が
false なら、- nextを ?
IteratorStepValue (iteratorRecord) とする。 - nextが
done でないなら、- vをnextに設定する。
- nextを ?
Initializer が存在し、かつvがundefined なら、IsAnonymousFunctionDefinition (Initializer )がtrue なら、- vを、引数bindingIdを伴う
Initializer のNamedEvaluation の ? 結果に設定する。
- vを、引数bindingIdを伴う
- そうでなければ、
- defaultValueを
Initializer のEvaluation の ? 結果とする。 - vを ?
GetValue (defaultValue) に設定する。
- defaultValueを
- envRecordが
undefined なら、PutValue (lhs, v)を ? で返す。 InitializeReferencedBinding (lhs, v)を ? で返す。
- vを
undefined とする。 - iteratorRecord.[[Done]]が
false なら、- nextを ?
IteratorStepValue (iteratorRecord) とする。 - nextが
done でないなら、- vをnextに設定する。
- nextを ?
Initializer が存在し、かつvがundefined なら、- defaultValueを
Initializer のEvaluation の ? 結果とする。 - vを ?
GetValue (defaultValue) に設定する。
- defaultValueを
- 引数vおよびenvRecordを伴う
BindingPattern のBindingInitialization を ? で返す。
- lhsを ?
ResolveBinding (StringValue ofBindingIdentifier , envRecord) とする。 - arrayを !
ArrayCreate (0) とする。 - nを0とする。
- 繰り返す
- nextを
done とする。 - iteratorRecord.[[Done]]が
false なら、- nextを ?
IteratorStepValue (iteratorRecord) に設定する。
- nextを ?
- nextが
done なら、- envRecordが
undefined なら、PutValue (lhs, array)を ? で返す。 InitializeReferencedBinding (lhs, array)を ? で返す。
- envRecordが
CreateDataPropertyOrThrow (array, !ToString (𝔽 (n)), next)を ! で実行する。- nをn + 1に設定する。
- nextを
- arrayを !
ArrayCreate (0) とする。 - nを0とする。
- 繰り返す
- nextを
done とする。 - iteratorRecord.[[Done]]が
false なら、- nextを ?
IteratorStepValue (iteratorRecord) に設定する。
- nextを ?
- nextが
done なら、- 引数arrayおよびenvRecordを伴う
BindingPattern のBindingInitialization を ? で返す。
- 引数arrayおよびenvRecordを伴う
CreateDataPropertyOrThrow (array, !ToString (𝔽 (n)), next)を ! で実行する。- nをn + 1に設定する。
- nextを
unused を返す。
- 引数iteratorRecordおよびenvRecordを伴う
FormalParameterList のIteratorBindingInitialization を ? で実行する。 - 引数iteratorRecordおよびenvRecordを伴う
FunctionRestParameter のIteratorBindingInitialization を ? で返す。
- 引数iteratorRecordおよびenvRecordを伴う
FormalParameterList のIteratorBindingInitialization を ? で実行する。 - 引数iteratorRecordおよびenvRecordを伴う
FormalParameter のIteratorBindingInitialization を ? で返す。
- vを
undefined とする。 Assert : iteratorRecord.[[Done]]はfalse である。- nextを ?
IteratorStepValue (iteratorRecord) とする。 - nextが
done でないなら、- vをnextに設定する。
- 引数vおよびenvRecordを伴う
BindingIdentifier のBindingInitialization を ? で返す。
- formalsを、
CoverParenthesizedExpressionAndArrowParameterList によってcoverされるArrowFormalParameters とする。 - 引数iteratorRecordおよびenvRecordを伴うformalsの
IteratorBindingInitialization を ? で返す。
- vを
undefined とする。 Assert : iteratorRecord.[[Done]]はfalse である。- nextを ?
IteratorStepValue (iteratorRecord) とする。 - nextが
done でないなら、- vをnextに設定する。
- 引数vおよびenvRecordを伴う
BindingIdentifier のBindingInitialization を ? で返す。
8.6.4 Static Semantics: AssignmentTargetType
The
IsStrict (thisIdentifierReference )がtrue であり、かつIdentifier のStringValue が"eval" または"arguments" のいずれかなら、invalid を返す。simple を返す。
simple を返す。
- exprを、
CoverParenthesizedExpressionAndArrowParameterList によってcoverされるParenthesizedExpression とする。 - exprの
AssignmentTargetType を返す。
- hostがweb browserであるか、または他の方法で
Function Call Assignment Targetsに対するRuntime Errors をサポートしており、かつIsStrict (thisCallExpression )がfalse なら、web-compat を返す。
invalid を返す。
invalid を返す。
8.6.5 Static Semantics: PropName
The
empty を返す。
PropertyName のPropName を返す。
StringLiteral のSV を返す。
- numberを
NumericLiteral のNumericValue とする。 - !
ToString (number)を返す。
empty を返す。
empty を返す。
empty を返す。
empty を返す。
8.6.6 Static Semantics: ContainsUsing
The
- 派生した
StatementList のContainsUsing がtrue である場合、true を返す。 StatementListItem のContainsUsing がtrue である場合、true を返す。false を返す。
false を返す。
Declaration のIsUsingDeclaration がtrue である場合、true を返す。Declaration のIsAwaitUsingDeclaration がtrue である場合、true を返す。false を返す。
9 実行可能コードと実行コンテキスト
9.1 Environment Records
Environment Recordは、ECMAScriptコードの字句的な入れ子構造に基づいて、
すべてのEnvironment Recordは[[OuterEnv]]フィールドを持ち、これは
Environment Recordsは純粋に仕様上の仕組みであり、ECMAScript実装の特定のartefactに対応する必要はありません。ECMAScriptプログラムがそのような値に直接アクセスしたり操作したりすることは不可能です。
9.1.1 Environment Record型階層
-
-
Declarative Environment Record は、FunctionDeclaration 、VariableDeclaration 、およびCatch 節など、identifier bindingsをECMAScript言語値 と直接関連付けるECMAScript言語構文要素の効果を定義するために使用されます。-
Function Environment Record は、ECMAScriptfunction object の呼び出しに対応し、その関数内のtop-level declarationsに対するbindingsを含みます。これは新しいthisbindingを確立する場合があります。また、supermethod呼び出しをサポートするために必要な状態もcaptureします。 -
Module Environment Record は、Module のtop-level declarationsに対するbindingsを含みます。また、Module によって明示的にimportされるbindingsも含みます。その[[OuterEnv]]はGlobal Environment Record です。
-
-
Object Environment Record は、identifier bindingsを何らかのオブジェクトのプロパティと関連付けるWithStatement などのECMAScript要素の効果を定義するために使用されます。 -
Global Environment Record は、Script のglobal declarationsに使用されます。これは外側環境を持たず、その[[OuterEnv]]はnull です。identifier bindingsが事前に設定されている場合があり、関連付けられたglobal object を含み、そのプロパティはglobal environmentのidentifier bindingsの一部を提供します。ECMAScriptコードが実行されるにつれて、global object に追加のプロパティが追加され、初期プロパティが変更される場合があります。
-
| メソッド | 目的 | 定義 |
|---|---|---|
| HasBinding ( name ) | The abstract method HasBinding takes argument name (a String) and returns either a |
これは次の型に具体定義を持ちます：
|
| CreateMutableBinding ( name, deletable ) | The abstract method CreateMutableBinding takes arguments name (a String) and deletable (a Boolean) and returns either a |
これは次の型に具体定義を持ちます：
|
| CreateImmutableBinding ( name, strict ) | The abstract method CreateImmutableBinding takes arguments name (a String) and strict (a Boolean) and returns either a |
これは次の型に具体定義を持ちます：
|
| InitializeBinding ( name, value ) | The abstract method InitializeBinding takes arguments name (a String) and value (an ECMAScript language value) and returns either a |
これは次の型に具体定義を持ちます：
|
| SetMutableBinding ( name, value, strict ) | The abstract method SetMutableBinding takes arguments name (a String), value (an ECMAScript language value), and strict (a Boolean) and returns either a |
これは次の型に具体定義を持ちます：
|
| GetBindingValue ( name, strict ) | The abstract method GetBindingValue takes arguments name (a String) and strict (a Boolean) and returns either a |
これは次の型に具体定義を持ちます：
|
| DeleteBinding ( name ) | The abstract method DeleteBinding takes argument name (a String) and returns either a |
これは次の型に具体定義を持ちます：
|
| HasThisBinding ( ) | The abstract method HasThisBinding takes no arguments and returns a Boolean. これは、this bindingを確立するかどうかを決定します。確立する場合は |
これは次の型に具体定義を持ちます：
|
| GetThisBinding ( ) | The abstract method GetThisBinding takes no arguments and returns either a this bindingの値を返します。this bindingが初期化されていない場合、 |
これは次の型に具体定義を持ちます：
|
| HasSuperBinding ( ) | The abstract method HasSuperBinding takes no arguments and returns a Boolean. これは、super method bindingを確立するかどうかを決定します。確立する場合は |
これは次の型に具体定義を持ちます：
|
| WithBaseObject ( ) | The abstract method WithBaseObject takes no arguments and returns an Object or with statementに関連付けられている場合、これはwith objectを返します。そうでない場合、 |
これは次の型に具体定義を持ちます：
|
9.1.1.1 Declarative Environment Records
各Declarative Environment Recordは、variable、constant、let、class、module、import、および/またはfunction declarationsを含むECMAScriptプログラムscopeに関連付けられます。Declarative Environment Recordは、そのscope内に含まれるdeclarationsによって定義される識別子集合をbindします。
すべての Declarative Environment Record はまた [[DisposableResourceStack]] フィールドを持ち、これは using 宣言および await using 宣言によって追跡される。
9.1.1.1.1 HasBinding ( name )
The
- envRecordがnameに対するbindingを持つなら、
true を返す。 false を返す。
9.1.1.1.2 CreateMutableBinding ( name, deletable )
The
Assert : envRecordはnameに対するbindingを既に持っていない。- envRecord内にnameに対するmutable bindingを作成し、それが未初期化であることを記録する。deletableが
true なら、新しく作成されたbindingが後続のDeleteBinding 呼び出しによって削除され得ることを記録する。 unused を返す。
9.1.1.1.3 CreateImmutableBinding ( name, strict )
The
Assert : envRecordはnameに対するbindingを既に持っていない。- envRecord内にnameに対するimmutable bindingを作成し、それが未初期化であることを記録する。strictが
true なら、新しく作成されたbindingがstrict bindingであることを記録する。 unused を返す。
9.1.1.1.4 InitializeBinding ( name, value )
The
Assert : envRecordはnameに対する未初期化のbindingを持っていなければならない。- envRecord内のnameに対するbound valueをvalueに設定する。
- envRecord内のnameに対するbindingが初期化済みであることを
Record する。 unused を返す。
9.1.1.1.5 SetMutableBinding ( name, value, strict )
The
- envRecordがnameに対するbindingを持たないなら、
- strictが
true なら、ReferenceError 例外をthrowする。 - ! envRecord.
CreateMutableBinding (name,true )を実行する。 - ! envRecord.
InitializeBinding (name, value)を実行する。 unused を返す。
- strictが
- envRecord内のnameに対するbindingがstrict bindingなら、strictを
true に設定する。 - envRecord内のnameに対するbindingがまだ初期化されていないなら、
ReferenceError 例外をthrowする。
- そうでなく、envRecord内のnameに対するbindingがmutable bindingなら、
- そのbound valueをvalueへ変更する。
- そうでなければ、
Assert : これはimmutable bindingの値を変更しようとする試みである。- strictが
true なら、TypeError 例外をthrowする。
unused を返す。
ステップ
function f() { eval("var x; x = (delete x, 0);"); }9.1.1.1.6 GetBindingValue ( name, strict )
The
Assert : envRecordはnameに対するbindingを持つ。- envRecord内のnameに対するbindingが未初期化のbindingなら、
ReferenceError 例外をthrowする。 - envRecord内でnameに現在bindされている値を返す。
9.1.1.1.7 DeleteBinding ( name )
The
Assert : envRecordはnameに対するbindingを持つ。- envRecord内のnameに対するbindingを削除できないなら、
false を返す。 - envRecordからnameに対するbindingを削除する。
true を返す。
9.1.1.1.8 HasThisBinding ( )
The
false を返す。
通常のthis bindingを提供しません。
9.1.1.1.9 GetThisBinding ( )
9.1.1.1.10 HasSuperBinding ( )
The
false を返す。
通常のsuper bindingを提供しません。
9.1.1.1.11 WithBaseObject ( )
The
undefined を返す。
9.1.1.2 Object Environment Records
各Object Environment Recordは、自身のbinding objectと呼ばれるオブジェクトに関連付けられます。Object Environment Recordは、そのbinding objectのプロパティ名に直接対応するstring identifier namesの集合をbindします。
with statements（
Object Environment Recordsは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[BindingObject]] | Object |
この |
| [[IsWithEnvironment]] | Boolean |
このwith statementのために作成されたかどうかを示します。
|
9.1.1.2.1 HasBinding ( name )
The
- bindingObjをenvRecord.[[BindingObject]]とする。
- foundBindingを ?
HasProperty (bindingObj, name) とする。 - foundBindingが
false なら、false を返す。 - envRecord.[[IsWithEnvironment]]が
false なら、true を返す。 - unscopablesを ?
Get (bindingObj,%Symbol.unscopables% ) とする。 - unscopablesがObjectなら、
true を返す。
9.1.1.2.2 CreateMutableBinding ( name, deletable )
The
- bindingObjをenvRecord.[[BindingObject]]とする。
- ?
DefinePropertyOrThrow (bindingObj, name, PropertyDescriptor { [[Value]]:undefined , [[Writable]]:true , [[Enumerable]]:true , [[Configurable]]: deletable })を実行する。 unused を返す。
通常、envRecordはnameに対するbindingを持ちませんが、持つ場合、
9.1.1.2.3 CreateImmutableBinding ( name, strict )
9.1.1.2.4 InitializeBinding ( name, value )
The
- ? envRecord.
SetMutableBinding (name, value,false )を実行する。 unused を返す。
この仕様では、
9.1.1.2.5 SetMutableBinding ( name, value, strict )
The
- bindingObjをenvRecord.[[BindingObject]]とする。
- stillExistsを ?
HasProperty (bindingObj, name) とする。 - stillExistsが
false かつstrictがtrue なら、ReferenceError 例外をthrowする。 - ?
Set (bindingObj, name, value, strict)を実行する。 unused を返す。
9.1.1.2.6 GetBindingValue ( name, strict )
The
- bindingObjをenvRecord.[[BindingObject]]とする。
- valueを ?
HasProperty (bindingObj, name) とする。 - valueが
false なら、- strictが
false なら、undefined を返す。 ReferenceError 例外をthrowする。
- strictが
- ?
Get (bindingObj, name)を返す。
9.1.1.2.7 DeleteBinding ( name )
The
- bindingObjをenvRecord.[[BindingObject]]とする。
- ? bindingObj.[[Delete]](name)を返す。
9.1.1.2.8 HasThisBinding ( )
The
false を返す。
this bindingを提供しません。
9.1.1.2.9 GetThisBinding ( )
9.1.1.2.10 HasSuperBinding ( )
The
false を返す。
super bindingを提供しません。
9.1.1.2.11 WithBaseObject ( )
The
- envRecord.[[IsWithEnvironment]]が
true なら、envRecord.[[BindingObject]]を返す。 undefined を返す。
9.1.1.3 Function Environment Records
Function Environment Recordは、functionのtop-level scopeを表すために使用されるthis bindingを提供します。functionがsuperを参照する場合、そのFunction Environment Recordは、function内からsuper method呼び出しを実行するために使用される状態も含みます。
Function Environment Recordsは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[ThisValue]] |
|
これは、このfunctionのこの呼び出しに使用される |
| [[ThisBindingStatus]] |
|
値が |
| [[FunctionObject]] |
ECMAScript |
この |
| [[NewTarget]] |
|
この |
Function Environment Recordsは、
9.1.1.3.1 BindThisValue ( envRecord, value )
The abstract operation BindThisValue takes arguments envRecord (a
Assert : envRecord.[[ThisBindingStatus]]はlexical でない。- envRecord.[[ThisBindingStatus]]が
initialized なら、ReferenceError 例外をthrowする。 - envRecord.[[ThisValue]]をvalueに設定する。
- envRecord.[[ThisBindingStatus]]を
initialized に設定する。 unused を返す。
9.1.1.3.2 HasThisBinding ( )
The
- envRecord.[[ThisBindingStatus]]が
lexical なら、false を返す。 true を返す。
9.1.1.3.3 GetThisBinding ( )
The
Assert : envRecord.[[ThisBindingStatus]]はlexical でない。- envRecord.[[ThisBindingStatus]]が
uninitialized なら、ReferenceError 例外をthrowする。 - envRecord.[[ThisValue]]を返す。
9.1.1.3.4 HasSuperBinding ( )
The
- envRecord.[[ThisBindingStatus]]が
lexical なら、false を返す。 - envRecord.[[FunctionObject]].[[HomeObject]]が
undefined なら、false を返す。 true を返す。
9.1.1.3.5 GetSuperBase ( envRecord )
The abstract operation GetSuperBase takes argument envRecord (a super property accessesのbaseであるオブジェクトを返します。値
- homeをenvRecord.[[FunctionObject]].[[HomeObject]]とする。
- homeが
undefined なら、undefined を返す。 Assert : homeはordinary object である。- ! home.[[GetPrototypeOf]]()を返す。
9.1.1.4 Global Environment Records
Global Environment Recordは、共通の
Global Environment Recordは論理的には単一のrecordですが、
プロパティは
Global Environment Recordsは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[ObjectRecord]] |
|
Binding objectは |
| [[GlobalThisValue]] | Object |
global scope内のthisによって返される値です。 |
| [[DeclarativeRecord]] |
|
関連 |
9.1.1.4.1 HasBinding ( name )
The
- declRecordをenvRecord.[[DeclarativeRecord]]とする。
- ! declRecord.
HasBinding (name)がtrue なら、true を返す。 - objRecordをenvRecord.[[ObjectRecord]]とする。
- ? objRecord.
HasBinding (name)を返す。
9.1.1.4.2 CreateMutableBinding ( name, deletable )
The
- declRecordをenvRecord.[[DeclarativeRecord]]とする。
- ! declRecord.
HasBinding (name)がtrue なら、TypeError 例外をthrowする。 - ! declRecord.
CreateMutableBinding (name, deletable)を返す。
9.1.1.4.3 CreateImmutableBinding ( name, strict )
The
- declRecordをenvRecord.[[DeclarativeRecord]]とする。
- ! declRecord.
HasBinding (name)がtrue なら、TypeError 例外をthrowする。 - ! declRecord.
CreateImmutableBinding (name, strict)を返す。
9.1.1.4.4 InitializeBinding ( name, value )
The
- declRecordをenvRecord.[[DeclarativeRecord]]とする。
- ! declRecord.
HasBinding (name)がtrue なら、- ! declRecord.
InitializeBinding (name, value)を返す。
- ! declRecord.
Assert : bindingが存在するなら、それはObject Environment Record 内になければならない。- objRecordをenvRecord.[[ObjectRecord]]とする。
- ? objRecord.
InitializeBinding (name, value)を返す。
9.1.1.4.5 SetMutableBinding ( name, value, strict )
The
- declRecordをenvRecord.[[DeclarativeRecord]]とする。
- ! declRecord.
HasBinding (name)がtrue なら、- ? declRecord.
SetMutableBinding (name, value, strict)を返す。
- ? declRecord.
- objRecordをenvRecord.[[ObjectRecord]]とする。
- ? objRecord.
SetMutableBinding (name, value, strict)を返す。
9.1.1.4.6 GetBindingValue ( name, strict )
The
- declRecordをenvRecord.[[DeclarativeRecord]]とする。
- ! declRecord.
HasBinding (name)がtrue なら、- ? declRecord.
GetBindingValue (name, strict)を返す。
- ? declRecord.
- objRecordをenvRecord.[[ObjectRecord]]とする。
- ? objRecord.
GetBindingValue (name, strict)を返す。
9.1.1.4.7 DeleteBinding ( name )
The
- declRecordをenvRecord.[[DeclarativeRecord]]とする。
- ! declRecord.
HasBinding (name)がtrue なら、- ! declRecord.
DeleteBinding (name)を返す。
- ! declRecord.
- objRecordをenvRecord.[[ObjectRecord]]とする。
- globalObjをobjRecord.[[BindingObject]]とする。
- existingPropertyを ?
HasOwnProperty (globalObj, name) とする。 - existingPropertyが
true なら、- ? objRecord.
DeleteBinding (name)を返す。
- ? objRecord.
true を返す。
9.1.1.4.8 HasThisBinding ( )
The
true を返す。
this bindingを提供します。
9.1.1.4.9 GetThisBinding ( )
The
- envRecord.[[GlobalThisValue]]を返す。
9.1.1.4.10 HasSuperBinding ( )
The
false を返す。
super bindingを提供しません。
9.1.1.4.11 WithBaseObject ( )
The
undefined を返す。
9.1.1.4.12 HasLexicalDeclaration ( envRecord, name )
The abstract operation HasLexicalDeclaration takes arguments envRecord (a
- declRecordをenvRecord.[[DeclarativeRecord]]とする。
- ! declRecord.
HasBinding (name)を返す。
9.1.1.4.13 HasRestrictedGlobalProperty ( envRecord, name )
The abstract operation HasRestrictedGlobalProperty takes arguments envRecord (a
- objRecordをenvRecord.[[ObjectRecord]]とする。
- globalObjをobjRecord.[[BindingObject]]とする。
- existingPropertyを ? globalObj.[[GetOwnProperty]](name) とする。
- existingPropertyが
undefined なら、false を返す。 - existingProperty.[[Configurable]]が
true なら、false を返す。 true を返す。
varまたはfunction declarationを使用して宣言されたのではなく、直接作成されたプロパティが
9.1.1.4.14 CanDeclareGlobalVar ( envRecord, name )
The abstract operation CanDeclareGlobalVar takes arguments envRecord (a
- objRecordをenvRecord.[[ObjectRecord]]とする。
- globalObjをobjRecord.[[BindingObject]]とする。
- hasPropertyを ?
HasOwnProperty (globalObj, name) とする。 - hasPropertyが
true なら、true を返す。 - ?
IsExtensible (globalObj)を返す。
9.1.1.4.15 CanDeclareGlobalFunction ( envRecord, name )
The abstract operation CanDeclareGlobalFunction takes arguments envRecord (a
- objRecordをenvRecord.[[ObjectRecord]]とする。
- globalObjをobjRecord.[[BindingObject]]とする。
- existingPropertyを ? globalObj.[[GetOwnProperty]](name) とする。
- existingPropertyが
undefined なら、?IsExtensible (globalObj)を返す。 - existingProperty.[[Configurable]]が
true なら、true を返す。 IsDataDescriptor (existingProperty)がtrue であり、かつexistingPropertyがattribute values { [[Writable]]:true , [[Enumerable]]:true }を持つなら、true を返す。false を返す。
9.1.1.4.16 CreateGlobalVarBinding ( envRecord, name, deletable )
The abstract operation CreateGlobalVarBinding takes arguments envRecord (a
- objRecordをenvRecord.[[ObjectRecord]]とする。
- globalObjをobjRecord.[[BindingObject]]とする。
- hasPropertyを ?
HasOwnProperty (globalObj, name) とする。 - extensibleを ?
IsExtensible (globalObj) とする。 - hasPropertyが
false かつextensibleがtrue なら、- ? objRecord.
CreateMutableBinding (name, deletable)を実行する。 - ? objRecord.
InitializeBinding (name,undefined )を実行する。
- ? objRecord.
unused を返す。
9.1.1.4.17 CreateGlobalFunctionBinding ( envRecord, name, value, deletable )
The abstract operation CreateGlobalFunctionBinding takes arguments envRecord (a
- objRecordをenvRecord.[[ObjectRecord]]とする。
- globalObjをobjRecord.[[BindingObject]]とする。
- existingPropertyを ? globalObj.[[GetOwnProperty]](name) とする。
- existingPropertyが
undefined またはexistingProperty.[[Configurable]]がtrue なら、- propertyDescをPropertyDescriptor { [[Value]]: value, [[Writable]]:
true , [[Enumerable]]:true , [[Configurable]]: deletable }とする。
- propertyDescをPropertyDescriptor { [[Value]]: value, [[Writable]]:
- そうでなければ、
- propertyDescをPropertyDescriptor { [[Value]]: value }とする。
- ?
DefinePropertyOrThrow (globalObj, name, propertyDesc)を実行する。 - ?
Set (globalObj, name, value,false )を実行する。 unused を返す。
Global function declarationsは常に
9.1.1.5 Module Environment Records
Module Environment Recordは、ECMAScript
Module Environment Recordsは、
9.1.1.5.1 GetBindingValue ( name, strict )
The
Assert : strictはtrue である。Assert : envRecordはnameに対するbindingを持つ。- nameに対するbindingがindirect bindingであるなら、
- moduleおよびtargetNameを、このnameに対するbindingが作成されたときに提供されたindirection valuesとする。
- targetEnvをmodule.[[Environment]]とする。
- targetEnvが
empty なら、ReferenceError 例外をthrowする。 - ? targetEnv.
GetBindingValue (targetName,true )を返す。
- envRecord内のnameに対するbindingが未初期化のbindingなら、
ReferenceError 例外をthrowする。 - envRecord内でnameに現在bindされている値を返す。
9.1.1.5.2 DeleteBinding ( name )
9.1.1.5.3 HasThisBinding ( )
The
true を返す。
this bindingを提供します。
9.1.1.5.4 GetThisBinding ( )
The
undefined を返す。
9.1.1.5.5 CreateImportBinding ( envRecord, name, targetModule, targetName )
The abstract operation CreateImportBinding takes arguments envRecord (a
9.1.2 Environment Record操作
以下の抽象操作は、この仕様において
9.1.2.1 GetIdentifierReference ( envRecord, name, strict )
The abstract operation GetIdentifierReference takes arguments envRecord (an
- envRecordが
null なら、Reference Record { [[Base]]:unresolvable , [[ReferencedName]]: name, [[Strict]]: strict, [[ThisValue]]:empty }を返す。
- existsを ? envRecord.
HasBinding (name) とする。 - existsが
true なら、Reference Record { [[Base]]: envRecord, [[ReferencedName]]: name, [[Strict]]: strict, [[ThisValue]]:empty }を返す。
- outerをenvRecord.[[OuterEnv]]とする。
- ?
GetIdentifierReference (outer, name, strict)を返す。
9.1.2.2 NewDeclarativeEnvironment ( outerEnv )
The abstract operation NewDeclarativeEnvironment takes argument outerEnv (an
- envRecord を、束縛を含まない新しい
Declarative Environment Record とする。 - envRecord.[[OuterEnv]] を outerEnv に設定する。
- envRecord.[[DisposableResourceStack]] を新しい空の
List に設定する。 - envRecord を返す。
9.1.2.3 NewObjectEnvironment ( obj, isWithEnv, outerEnv )
The abstract operation NewObjectEnvironment takes arguments obj (an Object), isWithEnv (a Boolean), and outerEnv (an
- envRecordを新しい
Object Environment Record とする。 - envRecord.[[BindingObject]]をobjに設定する。
- envRecord.[[IsWithEnvironment]]をisWithEnvに設定する。
- envRecord.[[OuterEnv]]をouterEnvに設定する。
- envRecordを返す。
9.1.2.4 NewFunctionEnvironment ( func, newTarget )
The abstract operation NewFunctionEnvironment takes arguments func (an ECMAScript
- envRecord を、束縛を含まない新しい
Function Environment Record とする。 - envRecord.[[FunctionObject]] を func に設定する。
- func.[[ThisMode]] が
lexical である場合、envRecord.[[ThisBindingStatus]] をlexical に設定する。 - Else, envRecord.[[ThisBindingStatus]] を
uninitialized に設定する。 - envRecord.[[NewTarget]] を newTarget に設定する。
- envRecord.[[OuterEnv]] を func.[[Environment]] に設定する。
- envRecord.[[DisposableResourceStack]] を新しい空の
List に設定する。 - envRecord を返す。
9.1.2.5 NewGlobalEnvironment ( obj, thisValue )
The abstract operation NewGlobalEnvironment takes arguments obj (an Object) and thisValue (an Object) and returns a
- objRecordを
NewObjectEnvironment (obj,false ,null )とする。 - declRecordを
NewDeclarativeEnvironment (null )とする。 - envRecordを新しい
Global Environment Record とする。 - envRecord.[[ObjectRecord]]をobjRecordに設定する。
- envRecord.[[GlobalThisValue]]をthisValueに設定する。
- envRecord.[[DeclarativeRecord]]をdeclRecordに設定する。
- envRecord.[[OuterEnv]]を
null に設定する。 - envRecordを返す。
9.1.2.6 NewModuleEnvironment ( outerEnv )
The abstract operation NewModuleEnvironment takes argument outerEnv (a
- envRecord を、束縛を含まない新しい
Module Environment Record とする。 - envRecord.[[OuterEnv]] を outerEnv に設定する。
- envRecord.[[DisposableResourceStack]] を新しい空の
List に設定する。 - envRecord を返す。
9.2 PrivateEnvironment Records
PrivateEnvironment Recordは、ECMAScriptコード内の
各
| フィールド名 | 値の型 | 意味 |
|---|---|---|
| [[OuterPrivateEnvironment]] |
|
最も近い包含classの |
| [[Names]] |
|
このclassによって宣言された |
9.2.1 PrivateEnvironment Record操作
以下の抽象操作は、この仕様において
9.2.1.1 NewPrivateEnvironment ( outerPrivateEnv )
The abstract operation NewPrivateEnvironment takes argument outerPrivateEnv (a
- namesを新しい空の
List とする。 PrivateEnvironment Record { [[OuterPrivateEnvironment]]: outerPrivateEnv, [[Names]]: names }を返す。
9.2.1.2 ResolvePrivateIdentifier ( privateEnv, identifier )
The abstract operation ResolvePrivateIdentifier takes arguments privateEnv (a
- namesをprivateEnv.[[Names]]とする。
- namesの各
Private Name privateNameについて、以下を行う- privateName.[[Description]]がidentifierなら、
- privateNameを返す。
- privateName.[[Description]]がidentifierなら、
- outerPrivateEnvをprivateEnv.[[OuterPrivateEnvironment]]とする。
Assert : outerPrivateEnvはnull でない。ResolvePrivateIdentifier (outerPrivateEnv, identifier)を返す。
9.3 Realms
評価される前に、すべてのECMAScriptコードはrealmに関連付けられていなければなりません。概念的には、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[AgentSignifier]] |
|
この |
| [[Intrinsics]] |
フィールド名がintrinsic keysであり、その値がobjectsである |
この |
| [[GlobalObject]] | Object |
この |
| [[GlobalEnv]] |
|
この |
| [[TemplateMap]] |
フィールド[[Site]]（ |
Template objectsは、その |
| [[LoadedModules]] |
|
この import() expressionを実行する場合にのみ使用されます。
|
| [[HostDefined]] |
anything（デフォルト値は |
|
9.3.1 InitializeHostDefinedRealm ( )
The abstract operation InitializeHostDefinedRealm takes no arguments and returns either a
- realmを新しい
Realm Record とする。 CreateIntrinsics (realm)を実行する。- realm.[[AgentSignifier]]を
AgentSignifier ()に設定する。 - realm.[[TemplateMap]]を新しい空の
List に設定する。 - newContextを新しい
execution context とする。 - newContextのFunctionを
null に設定する。 - newContextの
Realm をrealmに設定する。 - newContextのScriptOrModuleを
null に設定する。 - newContextを
execution context stack へpushする；newContextは現在running execution context である。 - hostが、realmの
global object として機能する特定のオブジェクトの使用を要求するなら、- globalを、
host-defined mannerで作成されたそのようなオブジェクトとする。
- globalを、
- そうでなければ、
- globalを
OrdinaryObjectCreate (realm.[[Intrinsics]].[[%Object.prototype% ]])とする。
- globalを
- hostが、realmのglobal scope内の
thisbindingにglobal object 以外のオブジェクトを返すことを要求するなら、- thisValueを、
host-defined mannerで作成されたそのようなオブジェクトとする。
- thisValueを、
- そうでなければ、
- thisValueをglobalとする。
- realm.[[GlobalObject]]をglobalに設定する。
- realm.[[GlobalEnv]]を
NewGlobalEnvironment (global, thisValue)に設定する。 - ?
SetDefaultGlobalBindings (realm)を実行する。 host-defined global object propertiesをglobal上に作成する。unused を返す。
9.3.2 CreateIntrinsics ( realmRecord )
The abstract operation CreateIntrinsics takes argument realmRecord (a
- realmRecord.[[Intrinsics]]を新しい
Record に設定する。 - realmRecord.[[Intrinsics]]のフィールドを、
Table 6 に列挙される値で設定する。フィールド名は、その表の“Intrinsic Name”列に列挙される名前です。各フィールドの値は、19 節から28 節までの各オブジェクトの仕様によって定義されるproperty valuesで完全かつ再帰的にpopulatedされた新しいobject valueです。すべてのobject property valuesは新しく作成されたobject valuesです。built-infunction objects であるすべての値は、CreateBuiltinFunction (steps, length, name, slots, realmRecord, proto, async)を実行することによって作成されます。ここで、stepsはこの仕様によって提供されるその関数の定義、nameはその関数の"name" propertyの初期値、lengthはその関数の"length" propertyの初期値、slotsはその関数の指定されたinternal slotsの名前のlist（もしあれば）、protoはその関数の[[Prototype]] internal slotの指定値、asyncはその関数が“async”として記述されている場合はtrue 、そうでない場合はfalse です。intrinsicsおよびそれらのpropertiesの作成は、まだ作成されていないオブジェクトへの依存を避けるように順序付けられていなければなりません。 AddRestrictedFunctionProperties (realmRecord.[[Intrinsics]].[[%Function.prototype% ]], realmRecord)を実行する。unused を返す。
9.3.3 SetDefaultGlobalBindings ( realmRecord )
The abstract operation SetDefaultGlobalBindings takes argument realmRecord (a
- globalをrealmRecord.[[GlobalObject]]とする。
19 節で指定されるGlobal Objectの各propertyについて、以下を行う- nameを
property name のString値とする。 - propertyDescを、そのpropertyの指定されたattributesを含む、そのpropertyの完全にpopulatedされたdata
Property Descriptor とする。19.2 、19.3 、または19.4 に列挙されるpropertiesについては、[[Value]]属性の値はrealmRecordからの対応するintrinsic objectです。 - ?
DefinePropertyOrThrow (global, name, propertyDesc)を実行する。
- nameを
unused を返す。
9.4 Execution Contexts
execution contextは、ECMAScript実装によるコードのruntime評価を追跡するために使用される仕様上の装置です。任意の時点で、実際にコードを実行しているexecution contextは、
execution context stackは、execution contextsを追跡するために使用されます。
execution contextは、それに関連付けられたコードの実行進行を追跡するために必要な実装固有の状態を含みます。各execution contextは、少なくとも
| Component | 目的 |
|---|---|
| code evaluation state |
この |
| Function |
この |
|
|
関連付けられたコードがECMAScriptリソースへアクセスする元となる |
| ScriptOrModule |
関連付けられたコードの由来となる |
ECMAScript code execution contextsは、
| Component | 目的 |
|---|---|
| LexicalEnvironment |
この |
| VariableEnvironment |
この |
| PrivateEnvironment |
最も近い包含class内の |
execution contextのLexicalEnvironmentおよびVariableEnvironment componentsは、常に
Generatorsの評価を表すexecution contextsは、
| Component | 目的 |
|---|---|
| Generator |
この |
ほとんどの状況では、この仕様内のアルゴリズムによって直接操作されるのは、
execution contextは純粋に仕様上の仕組みであり、ECMAScript実装の特定のartefactに対応する必要はありません。ECMAScriptコードがexecution contextへ直接アクセスしたり観測したりすることは不可能です。
9.4.1 GetActiveScriptOrModule ( )
The abstract operation GetActiveScriptOrModule takes no arguments and returns a
execution context stack が空なら、null を返す。- executionContextを、
execution context stack 上でScriptOrModule componentがnull でない最上位のexecution context とする。 - そのような
execution context が存在しないなら、null を返す。 - executionContextのScriptOrModuleを返す。
9.4.2 ResolveBinding ( name [ , envRecord ] )
The abstract operation ResolveBinding takes argument name (a String) and optional argument envRecord (an
- envRecordが存在しない、またはenvRecordが
undefined なら、- envRecordを
running execution context のLexicalEnvironmentに設定する。
- envRecordを
Assert : envRecordはEnvironment Record である。- strictを、評価中のsyntactic productionの
IsStrict とする。 - ?
GetIdentifierReference (envRecord, name, strict)を返す。
ResolveBindingの結果は、常に[[ReferencedName]]フィールドがnameである
9.4.3 GetThisEnvironment ( )
The abstract operation GetThisEnvironment takes no arguments and returns an thisのbindingを供給している
- envRecordを
running execution context のLexicalEnvironmentとする。 - 繰り返す
- existsをenvRecord.
HasThisBinding ()とする。 - existsが
true なら、envRecordを返す。 - outerをenvRecord.[[OuterEnv]]とする。
Assert : outerはnull でない。- envRecordをouterに設定する。
- existsをenvRecord.
ステップthis bindingを持つglobal environmentで終わるからです。
9.4.4 ResolveThisBinding ( )
The abstract operation ResolveThisBinding takes no arguments and returns either a thisのbindingを決定します。 It performs the following steps when called:
- envRecordを
GetThisEnvironment ()とする。 - ? envRecord.
GetThisBinding ()を返す。
9.4.5 GetNewTarget ( )
The abstract operation GetNewTarget takes no arguments and returns an Object or
- envRecordを
GetThisEnvironment ()とする。 Assert : envRecordは[[NewTarget]]フィールドを持つ。- envRecord.[[NewTarget]]を返す。
9.4.6 GetGlobalObject ( )
The abstract operation GetGlobalObject takes no arguments and returns an Object. これは、現在
- currentRealmを
current Realm Record とする。 - currentRealm.[[GlobalObject]]を返す。
9.4.7 RunSuspendedContext ( context, completionRecord )
The abstract operation RunSuspendedContext takes arguments context (an
- callerContextを
running execution context とする。 - callerContextを一時停止する。
- contextを
execution context stack へpushする；contextは現在running execution context である。 - contextの一時停止された評価を再開する。このとき、completionRecordを、それを一時停止した操作の結果として使用する。resultを、再開された計算によって返された
Completion Record とする。 Assert : このステップに到達したとき、contextはすでにexecution context stack から取り除かれており、callerContextが再びrunning execution context である。Completion (result)を返す。
9.4.8 RunCallerContext ( value )
The abstract operation RunCallerContext takes argument value (
- genContextを、実行中の実行コンテキストとする。
- 実行コンテキストスタックからgenContextを取り除き、実行コンテキストスタックの先頭にある実行コンテキストを実行中の実行コンテキストとして復元する。
- callerContextを、実行中の実行コンテキストとする。
NormalCompletion (value)を渡して、callerContextを再開する。NOTE : 上記の手順は制御をcallerContextに移し、一時停止する。このアルゴリズムで一時停止が解除され、後続の手順へ制御が進む唯一の方法は、genContextが再び再開されることであり、それは決して起こらない可能性がある。Assert : genContextは実行中の実行コンテキストである。- resultを、genContextがたった今再開されたときの
Completion Record とする。 Completion (result)を返す。
9.5 JobsおよびJobsをEnqueueするHost Operations
Jobは、他のECMAScript計算が現在進行中でないときにECMAScript計算を開始する、parametersを持たない
- 将来のある時点で、jobがscheduleされた
agent にrunning contextが存在せず、そのagent のexecution context stack が空であるとき、実装は次を行わなければならない：- 任意の
host-defined 準備ステップを実行する。 Job Abstract Closure をInvoke する。- 任意の
host-defined cleanup stepsを実行し、その後execution context stack は空でなければならない。
- 任意の
- 任意の時点で、
agent 内でactiveに評価中であるJob は1つだけであってよい。 Job の評価が開始したら、そのagent 内で他のJob の評価が開始する前に完了まで実行されなければならない。Abstract Closure はnormal completion を返さなければならず、自身でerrorsの処理を実装する。
任意の特定の時点で、次の条件のすべてがtrueであるなら、scriptOrModule（
GetActiveScriptOrModule ()はscriptOrModuleである。- scriptOrModuleが
Script Record またはModule Record である場合、executionContextを、execution context stack 上でScriptOrModule componentがscriptOrModuleである最上位のexecution context とする。executionContextのRealm componentはscriptOrModule.[[Realm]]である。
任意の特定の時点で、次の条件のすべてがtrueであるなら、executionはECMAScriptコードを評価する準備ができているものとします：
execution context stack が空でない。execution context stack 上の最上位execution context のRealm componentがRealm Record である。
特定の種類の
9.5.1 JobCallback Records
JobCallback Recordは、
たとえば、WHATWG HTML specification（https://html.spec.whatwg.org/）は、Promise callbacksのincumbent settings objectを伝播するために
JobCallback Recordsは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Callback]] |
|
|
| [[HostDefined]] |
anything（デフォルト値は |
|
9.5.2 HostMakeJobCallback ( callback )
The
HostMakeJobCallbackの実装は、次の要件に適合しなければなりません：
- [[Callback]]フィールドがcallbackである
JobCallback Record を返さなければならない。
HostMakeJobCallbackのデフォルト実装は、呼び出されたときに次のstepsを実行します：
JobCallback Record { [[Callback]]: callback, [[HostDefined]]:empty }を返す。
web browsersでないECMAScript
これは、callbackが最終的にscheduleされ実行されることを担うfunctionに渡された時点で呼び出されます。たとえば、promise.then(thenAction)は、reaction Promise.prototype.thenを呼び出す時点でthenActionに対してMakeJobCallbackを呼び出します。
9.5.3 HostCallJobCallback ( jobCallback, thisValue, argList )
The
HostCallJobCallbackの実装は、次の要件に適合しなければなりません：
Call (jobCallback.[[Callback]], thisValue, argList)の結果を実行して返さなければならない。
この要件は、
HostCallJobCallbackのデフォルト実装は、呼び出されたときに次のstepsを実行します：
Assert :IsCallable (jobCallback.[[Callback]])はtrue である。- ?
Call (jobCallback.[[Callback]], thisValue, argList)を返す。
web browsersでないECMAScript
9.5.4 HostEnqueueGenericJob ( job, realm )
The
HostEnqueueGenericJobの実装は、
9.5.5 HostEnqueuePromiseJob ( job, realm )
The
HostEnqueuePromiseJobの実装は、
- realmが
null でないなら、jobが呼び出されるたびに、jobの呼び出し時点でexecutionがECMAScriptコードを評価する準備ができるように、implementation-defined stepsを実行しなければならない。 - HostEnqueuePromiseJobが呼び出された時点の
GetActiveScriptOrModule ()をscriptOrModuleとする。realmがnull でないなら、jobが呼び出されるたびに、jobの呼び出し時点でscriptOrModuleがactive script or module であるように、implementation-defined stepsを実行しなければならない。 Jobs は、それらをscheduleしたHostEnqueuePromiseJob呼び出しと同じ順序で実行されなければならない。
9.5.6 HostEnqueueTimeoutJob ( timeoutJob, realm, milliseconds )
The
HostEnqueueTimeoutJobの実装は、
9.6 Agents
agentは、ECMAScript
たとえば、一部のweb browsersは、browser windowの複数の無関係なtabs間で単一の
agent signifierは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[LittleEndian]] | Boolean 値 | アルゴリズム |
| [[CanBlock]] | Boolean 値 | エージェントがブロックできるかどうかを決定する。 |
| [[Signifier]] | エージェント記号子 | そのエージェントクラスター内でエージェントを一意に識別する。 |
| [[IsLockFree1]] | Boolean 値 | 1 |
| [[IsLockFree2]] | Boolean 値 | 2 |
| [[IsLockFree8]] | Boolean 値 | 8 |
| [[CandidateExecution]] | 候補実行 |
メモリーモデルを参照。 |
| [[KeptAlive]] | Object または Symbol のいずれかの |
初期状態では新しい空の |
| [[ModuleAsyncEvaluationCount]] | 整数 | 初期状態では 0 であり、非同期である、または非同期依存関係を持つモジュールの [[AsyncEvaluationOrder]] フィールドに、一意に増加する値を割り当てるために使用される。 |
| [[GlobalSymbolRegistry]] | 初期状態では新しい空の |
[[LittleEndian]]、[[Signifier]]、[[IsLockFree1]]、[[IsLockFree2]]、および [[IsLockFree8]] の値は変更できない。
[[GlobalSymbolRegistry]]
[[IsLockFree1]]、[[IsLockFree2]]、および[[IsLockFree8]]の値は、必ずしもhardwareによって決定されるとは限らず、時間の経過やECMAScript実装間で変化し得るimplementation choicesを反映する場合もあります。
[[IsLockFree4]]フィールドはありません：4-byte atomic operationsは常にlock-freeです。
実際には、atomic operationが何らかの種類のlockで実装されている場合、そのoperationはlock-freeではありません。Lock-freeはwait-freeを意味しません：lock-free atomic operationを完了するために必要となるmachine stepsの数に上限はありません。
サイズnのatomic accessがlock-freeであることは、サイズnのnon-atomic accessesの（知覚される）atomicityについて何も意味しません。具体的には、non-atomic accessesは依然として複数の個別memory accessesのsequenceとして実行される場合があります。詳細は
9.6.1 AgentSignifier ( )
The abstract operation AgentSignifier takes no arguments and returns an
- agentRecordを
surrounding agent のAgent Record とする。 - agentRecord.[[Signifier]]を返す。
9.6.2 AgentCanSuspend ( )
The abstract operation AgentCanSuspend takes no arguments and returns a Boolean. It performs the following steps when called:
- agentRecordを
surrounding agent のAgent Record とする。 - agentRecord.[[CanBlock]]を返す。
一部のenvironmentsでは、特定の
9.6.3 IncrementModuleAsyncEvaluationCount ( )
The abstract operation IncrementModuleAsyncEvaluationCount takes no arguments and returns a non-negative
- agentRecordを
surrounding agent のAgent Record とする。 - countをagentRecord.[[ModuleAsyncEvaluationCount]]とする。
- agentRecord.[[ModuleAsyncEvaluationCount]]をcount + 1に設定する。
- countを返す。
この値は、pending modules間の相対的なevaluation orderを追跡するためだけに使用されます。実装は、pending modulesが存在しないときはいつでも、観測不能に[[ModuleAsyncEvaluationCount]]を0へresetしてよいです。
9.7 Agent Clusters
agent clusterは、shared memory上で操作することによって通信できる
すべての
cluster内のすべての
agent cluster内の異なる
cluster内のすべての
cluster内のすべての
embeddingは、
前述の制限の目的は、別の
この制限の含意は、embedding内で同じsuspend/wake collectiveに属さない
embeddingは、
次の仕様値、およびそれらから推移的に到達可能な値は、それぞれちょうど1つのagent clusterに属します。
cluster内の任意の
agent cluster内のすべての
agent clusterは仕様上の仕組みであり、ECMAScript実装の特定のartefactに対応する必要はありません。
9.8 Forward Progress
実装は次を保証しなければなりません：
- dedicated
executing thread を持つすべてのunblockedagent は、最終的にforward progressを行う executing thread を共有するagents の集合では、1つのagent が最終的にforward progressを行うagent は、blockingを提供する明示的なAPIsを通じる場合を除き、別のagent をblockedにさせない。
これは、
9.9 WeakRefおよびFinalizationRegistry TargetsのProcessing Model
9.9.1 目的
この仕様は、任意のobjectまたはsymbolがgarbage collectedされることについて、いかなる保証も行いません。
-
WeakRef.prototype.derefが呼び出されると、referent（undefined が返されない場合）は、その後の同期的なアクセスも同じ値を返すようにaliveに保持されます。このlistは、ClearKeptObjects abstract operationを使用して同期的な作業が完了したときにresetされます。 -
FinalizationRegistry に登録されたobjectまたはsymbolが到達不能になると、同期的なECMAScript実行が完了した後に、FinalizationRegistry のcleanup callbackの呼び出しが最終的に行われる場合があります。FinalizationRegistry cleanupは、CleanupFinalizationRegistry abstract operationによって実行されます。
これらのactions（
一部のECMAScript実装には、ECMAScriptがidleであるときを含め、backgroundで実行されるgarbage collector implementationsが含まれます。host environmentに
9.9.2 Liveness
objectsおよび/またはsymbolsの集合objSetについて、objSetに関するhypothetical WeakRef-oblivious executionとは、referentがobjSetの要素である
評価中の任意の時点で、objectsおよび/またはsymbolsの集合objSetは、次の条件のいずれかが満たされる場合、liveとみなされます：
-
objSet内の任意の要素が、任意の
agent の[[KeptAlive]]List に含まれている。 - objSetに関するvalid future hypothetical WeakRef-oblivious executionが存在し、そのexecutionがobjSet内の任意の値のidentityを観測する。
field、internal slot、またはproperty内にobjectまたはsymbolが存在することは、その値がliveであることを意味しません。たとえば、問題の値がprogramへ返されることがないなら、それは観測できません。
これは、WeakMap内のkeys、WeakSetのmembers、ならびに
上記の定義は、WeakMap内のkeyがliveでないなら、その対応するvalueも必ずしもliveではないことを含意します。
9.9.3 Execution
任意の時点で、objectsおよび/またはsymbolsの集合objSetが
- objSetの各要素valueについて、以下を行う
- ref.[[WeakRefTarget]]がvalueであるような各
WeakRef refについて、以下を行う- ref.[[WeakRefTarget]]を
empty に設定する。
- ref.[[WeakRefTarget]]を
- finalizationRegistry.[[Cells]]が、cell.[[WeakRefTarget]]がvalueであるような
Record cellを含む各FinalizationRegistry finalizationRegistryについて、以下を行う- cell.[[WeakRefTarget]]を
empty に設定する。 - enqueueCleanupを、
true またはfalse のいずれかのimplementation-defined choiceとする。 - enqueueCleanupが
true なら、HostEnqueueFinalizationRegistryCleanupJob (finalizationRegistry)を実行する。
- cell.[[WeakRefTarget]]を
- map.[[WeakMapData]]が、entry.[[Key]]がvalueであるような
Record entryを含む各WeakMap mapについて、以下を行う- entry.[[Key]]を
empty に設定する。 - entry.[[Value]]を
empty に設定する。
- entry.[[Key]]を
- set.[[WeakSetData]]がvalueを含む各WeakSet setについて、以下を行う
- 値がvalueであるset.[[WeakSetData]]の要素を、値が
empty である要素で置き換える。
- 値がvalueであるset.[[WeakSetData]]の要素を、値が
- ref.[[WeakRefTarget]]がvalueであるような各
livenessの定義とともに、このclauseは、
objectのidentityを観測せずにそのobjectへアクセスすることは可能です。identityが観測されないnon-escaping objectsのpropertiesに対するdead variable eliminationやscalar replacementなどのoptimizationsは許可されます。したがって、これらのoptimizationsは、そのようなobjectsを指す
一方、objectのidentityが観測可能であり、そのobjectが
9.9.4 Host Hooks
9.9.4.1 HostEnqueueFinalizationRegistryCleanupJob ( finalizationRegistry )
The
cleanupJobを、finalizationRegistryをcaptureし、呼び出されたときに次のstepsを実行する、parametersを持たない新しい
- cleanupResultを
Completion (CleanupFinalizationRegistry (finalizationRegistry))とする。 - cleanupResultが
abrupt completion であるなら、errorをreportするための任意のhost-defined stepsを実行する。 unused を返す。
HostEnqueueFinalizationRegistryCleanupJobの実装は、可能であれば、将来のある時点でcleanupJobが実行されるようscheduleします。また、
9.10 ClearKeptObjects ( )
The abstract operation ClearKeptObjects takes no arguments and returns
- agentRecordを
surrounding agent のAgent Record とする。 - agentRecord.[[KeptAlive]]を新しい空の
List に設定する。 unused を返す。
9.11 AddToKeptObjects ( value )
The abstract operation AddToKeptObjects takes argument value (an Object or a Symbol) and returns
- agentRecordを
surrounding agent のAgent Record とする。 - valueをagentRecord.[[KeptAlive]]へappendする。
unused を返す。
9.12 CleanupFinalizationRegistry ( finalizationRegistry )
The abstract operation CleanupFinalizationRegistry takes argument finalizationRegistry (a
Assert : finalizationRegistryは[[Cells]]および[[CleanupCallback]] internal slotsを持つ。- callbackをfinalizationRegistry.[[CleanupCallback]]とする。
- finalizationRegistry.[[Cells]]がcell.[[WeakRefTarget]]が
empty であるRecord cellを含む間、実装は次のstepsを実行してよい：- そのようなcellを任意に選択する。
- cellをfinalizationRegistry.[[Cells]]から削除する。
- ?
HostCallJobCallback (callback,undefined , « cell.[[HeldValue]] »)を実行する。
unused を返す。
9.13 CanBeHeldWeakly ( arg )
The abstract operation CanBeHeldWeakly takes argument arg (an ECMAScript language value) and returns a Boolean. これは、argがweak referenceとして使用するのに適している場合に限り、
- argがObjectなら、
true を返す。 - argがSymbolであり、
KeyForSymbol (arg)がundefined なら、true を返す。 false を返す。
10 Ordinary ObjectsおよびExotic Objectsの振る舞い
10.1 Ordinary Object Internal Methods and Internal Slots
すべての
すべての
以下のalgorithm descriptionsでは、objは
各
10.1.1 [[GetPrototypeOf]] ( )
The [[GetPrototypeOf]] internal method of
OrdinaryGetPrototypeOf (obj)を返す。
10.1.1.1 OrdinaryGetPrototypeOf ( obj )
The abstract operation OrdinaryGetPrototypeOf takes argument obj (an Object) and returns an Object or
- obj.[[Prototype]]を返す。
10.1.2 [[SetPrototypeOf]] ( proto )
The [[SetPrototypeOf]] internal method of
OrdinarySetPrototypeOf (obj, proto)を返す。
10.1.2.1 OrdinarySetPrototypeOf ( obj, proto )
The abstract operation OrdinarySetPrototypeOf takes arguments obj (an Object) and proto (an Object or
- currentをobj.[[Prototype]]とする。
SameValue (proto, current)がtrue なら、true を返す。- extensibleをobj.[[Extensible]]とする。
- extensibleが
false なら、false を返す。 - cursorをprotoとする。
- doneを
false とする。 - doneが
false である間、繰り返す- cursorが
null なら、- doneを
true に設定する。
- doneを
- そうでなく、
SameValue (cursor, obj)がtrue なら、false を返す。
- そうでなければ、
- cursor.[[GetPrototypeOf]]が
10.1.1 で定義されるordinary object internal methodでないなら、doneをtrue に設定する。 - そうでなければ、cursorをcursor.[[Prototype]]に設定する。
- cursor.[[GetPrototypeOf]]が
- cursorが
- obj.[[Prototype]]をprotoに設定する。
true を返す。
ステップ
10.1.3 [[IsExtensible]] ( )
The [[IsExtensible]] internal method of
OrdinaryIsExtensible (obj)を返す。
10.1.3.1 OrdinaryIsExtensible ( obj )
The abstract operation OrdinaryIsExtensible takes argument obj (an Object) and returns a Boolean. It performs the following steps when called:
- obj.[[Extensible]]を返す。
10.1.4 [[PreventExtensions]] ( )
The [[PreventExtensions]] internal method of
OrdinaryPreventExtensions (obj)を返す。
10.1.4.1 OrdinaryPreventExtensions ( obj )
The abstract operation OrdinaryPreventExtensions takes argument obj (an Object) and returns
- obj.[[Extensible]]を
false に設定する。 true を返す。
10.1.5 [[GetOwnProperty]] ( propertyKey )
The [[GetOwnProperty]] internal method of
OrdinaryGetOwnProperty (obj, propertyKey)を返す。
10.1.5.1 OrdinaryGetOwnProperty ( obj, propertyKey )
The abstract operation OrdinaryGetOwnProperty takes arguments obj (an Object) and propertyKey (a
- objがkey propertyKeyを持つown propertyを持たないなら、
undefined を返す。 - propertyDescを、fieldsを持たない新しく作成された
Property Descriptor とする。 - ownPropertyを、keyがpropertyKeyであるobjのown propertyとする。
- ownPropertyが
data property なら、- propertyDesc.[[Value]]をownPropertyの[[Value]]属性の値に設定する。
- propertyDesc.[[Writable]]をownPropertyの[[Writable]]属性の値に設定する。
- そうでなければ、
Assert : ownPropertyはaccessor property である。- propertyDesc.[[Get]]をownPropertyの[[Get]]属性の値に設定する。
- propertyDesc.[[Set]]をownPropertyの[[Set]]属性の値に設定する。
- propertyDesc.[[Enumerable]]をownPropertyの[[Enumerable]]属性の値に設定する。
- propertyDesc.[[Configurable]]をownPropertyの[[Configurable]]属性の値に設定する。
- propertyDescを返す。
10.1.6 [[DefineOwnProperty]] ( propertyKey, propertyDesc )
The [[DefineOwnProperty]] internal method of
- ?
OrdinaryDefineOwnProperty (obj, propertyKey, propertyDesc)を返す。
10.1.6.1 OrdinaryDefineOwnProperty ( obj, propertyKey, propertyDesc )
The abstract operation OrdinaryDefineOwnProperty takes arguments obj (an Object), propertyKey (a
- currentを ? obj.[[GetOwnProperty]](propertyKey) とする。
- extensibleを ?
IsExtensible (obj) とする。 ValidateAndApplyPropertyDescriptor (obj, propertyKey, extensible, propertyDesc, current)を返す。
10.1.6.2 IsCompatiblePropertyDescriptor ( extensible, propertyDesc, current )
The abstract operation IsCompatiblePropertyDescriptor takes arguments extensible (a Boolean), propertyDesc (a
ValidateAndApplyPropertyDescriptor (undefined ,"" , extensible, propertyDesc, current)を返す。
10.1.6.3 ValidateAndApplyPropertyDescriptor ( obj, propertyKey, extensible, propertyDesc, current )
The abstract operation ValidateAndApplyPropertyDescriptor takes arguments obj (an Object or
Assert : propertyKeyはproperty key である。- currentが
undefined なら、- extensibleが
false なら、false を返す。 - objが
undefined なら、true を返す。 IsAccessorDescriptor (propertyDesc)がtrue なら、- object objのpropertyKeyという名前のown
accessor property を作成する。その[[Get]]、[[Set]]、[[Enumerable]]、および[[Configurable]]属性は、propertyDescが対応するfieldを持つ場合はpropertyDesc内の対応するfieldの値に、そうでない場合はその属性のdefault value に設定される。
- object objのpropertyKeyという名前のown
- そうでなければ、
- object objのpropertyKeyという名前のown
data property を作成する。その[[Value]]、[[Writable]]、[[Enumerable]]、および[[Configurable]]属性は、propertyDescが対応するfieldを持つ場合はpropertyDesc内の対応するfieldの値に、そうでない場合はその属性のdefault value に設定される。
- object objのpropertyKeyという名前のown
true を返す。
- extensibleが
Assert : currentはfully populated Property Descriptor である。- propertyDescがfieldsをまったく持たないなら、
true を返す。 - current.[[Configurable]]が
false なら、- propertyDescが[[Configurable]] fieldを持ち、propertyDesc.[[Configurable]]が
true なら、false を返す。 - propertyDescが[[Enumerable]] fieldを持ち、propertyDesc.[[Enumerable]]がcurrent.[[Enumerable]]でないなら、
false を返す。 IsGenericDescriptor (propertyDesc)がfalse であり、かつIsAccessorDescriptor (propertyDesc)がIsAccessorDescriptor (current)でないなら、false を返す。IsAccessorDescriptor (current)がtrue なら、- そうでなく、current.[[Writable]]が
false なら、
- propertyDescが[[Configurable]] fieldを持ち、propertyDesc.[[Configurable]]が
- objが
undefined でないなら、IsDataDescriptor (current)がtrue であり、かつIsAccessorDescriptor (propertyDesc)がtrue なら、- propertyDescが[[Configurable]] fieldを持つなら、configurableをpropertyDesc.[[Configurable]]とする；そうでなければ、configurableをcurrent.[[Configurable]]とする。
- propertyDescが[[Enumerable]] fieldを持つなら、enumerableをpropertyDesc.[[Enumerable]]とする；そうでなければ、enumerableをcurrent.[[Enumerable]]とする。
- object objのpropertyKeyという名前のpropertyを
accessor property で置き換える。その[[Configurable]]および[[Enumerable]]属性はそれぞれconfigurableおよびenumerableに設定され、その[[Get]]および[[Set]]属性は、propertyDescが対応するfieldを持つ場合はpropertyDesc内の対応するfieldの値に、そうでない場合はその属性のdefault value に設定される。
- そうでなく、
IsAccessorDescriptor (current)がtrue であり、かつIsDataDescriptor (propertyDesc)がtrue なら、- propertyDescが[[Configurable]] fieldを持つなら、configurableをpropertyDesc.[[Configurable]]とする；そうでなければ、configurableをcurrent.[[Configurable]]とする。
- propertyDescが[[Enumerable]] fieldを持つなら、enumerableをpropertyDesc.[[Enumerable]]とする；そうでなければ、enumerableをcurrent.[[Enumerable]]とする。
- object objのpropertyKeyという名前のpropertyを
data property で置き換える。その[[Configurable]]および[[Enumerable]]属性はそれぞれconfigurableおよびenumerableに設定され、その[[Value]]および[[Writable]]属性は、propertyDescが対応するfieldを持つ場合はpropertyDesc内の対応するfieldの値に、そうでない場合はその属性のdefault value に設定される。
- そうでなければ、
- propertyDescの各field name fieldNameについて、object objのpropertyKeyという名前のpropertyのfieldNameという名前の属性を、propertyDescのfieldName fieldの値に設定する。
true を返す。
10.1.7 [[HasProperty]] ( propertyKey )
The [[HasProperty]] internal method of
- ?
OrdinaryHasProperty (obj, propertyKey)を返す。
10.1.7.1 OrdinaryHasProperty ( obj, propertyKey )
The abstract operation OrdinaryHasProperty takes arguments obj (an Object) and propertyKey (a
- hasOwnを ? obj.[[GetOwnProperty]](propertyKey) とする。
- hasOwnが
undefined でないなら、true を返す。 - parentを ? obj.[[GetPrototypeOf]]() とする。
- parentが
null でないなら、- ? parent.[[HasProperty]](propertyKey)を返す。
false を返す。
10.1.8 [[Get]] ( propertyKey, receiver )
The [[Get]] internal method of
- ?
OrdinaryGet (obj, propertyKey, receiver)を返す。
10.1.8.1 OrdinaryGet ( obj, propertyKey, receiver )
The abstract operation OrdinaryGet takes arguments obj (an Object), propertyKey (a
- propertyDescを ? obj.[[GetOwnProperty]](propertyKey) とする。
- propertyDescが
undefined なら、- parentを ? obj.[[GetPrototypeOf]]() とする。
- parentが
null なら、undefined を返す。 - ? parent.[[Get]](propertyKey, receiver)を返す。
IsDataDescriptor (propertyDesc)がtrue なら、propertyDesc.[[Value]]を返す。Assert :IsAccessorDescriptor (propertyDesc)はtrue である。- getterをpropertyDesc.[[Get]]とする。
- getterが
undefined なら、undefined を返す。 - ?
Call (getter, receiver)を返す。
10.1.9 [[Set]] ( propertyKey, value, receiver )
The [[Set]] internal method of
- ?
OrdinarySet (obj, propertyKey, value, receiver)を返す。
10.1.9.1 OrdinarySet ( obj, propertyKey, value, receiver )
The abstract operation OrdinarySet takes arguments obj (an Object), propertyKey (a
- ownDescを ? obj.[[GetOwnProperty]](propertyKey) とする。
- ?
OrdinarySetWithOwnDescriptor (obj, propertyKey, value, receiver, ownDesc)を返す。
10.1.9.2 OrdinarySetWithOwnDescriptor ( obj, propertyKey, value, receiver, ownDesc )
The abstract operation OrdinarySetWithOwnDescriptor takes arguments obj (an Object), propertyKey (a
- ownDescが
undefined なら、- parentを ? obj.[[GetPrototypeOf]]() とする。
- parentが
null でないなら、? parent.[[Set]](propertyKey, value, receiver)を返す。 - ownDescをPropertyDescriptor { [[Value]]:
undefined , [[Writable]]:true , [[Enumerable]]:true , [[Configurable]]:true }に設定する。
IsDataDescriptor (ownDesc)がtrue なら、- ownDesc.[[Writable]]が
false なら、false を返す。 - receiverがObjectでないなら、
false を返す。 - existingDescを ? receiver.[[GetOwnProperty]](propertyKey) とする。
- existingDescが
undefined なら、Assert : receiverは現在property propertyKeyを持たない。- ?
CreateDataProperty (receiver, propertyKey, value)を返す。
IsAccessorDescriptor (existingDesc)がtrue なら、false を返す。- existingDesc.[[Writable]]が
false なら、false を返す。 - valueDescをPropertyDescriptor { [[Value]]: value }とする。
- ? receiver.[[DefineOwnProperty]](propertyKey, valueDesc)を返す。
- ownDesc.[[Writable]]が
Assert :IsAccessorDescriptor (ownDesc)はtrue である。- setterをownDesc.[[Set]]とする。
- setterが
undefined なら、false を返す。 - ?
Call (setter, receiver, « value »)を実行する。 true を返す。
10.1.10 [[Delete]] ( propertyKey )
The [[Delete]] internal method of
- ?
OrdinaryDelete (obj, propertyKey)を返す。
10.1.10.1 OrdinaryDelete ( obj, propertyKey )
The abstract operation OrdinaryDelete takes arguments obj (an Object) and propertyKey (a
- propertyDescを ? obj.[[GetOwnProperty]](propertyKey) とする。
- propertyDescが
undefined なら、true を返す。 - propertyDesc.[[Configurable]]が
true なら、- objからpropertyKeyという名前のown propertyを削除する。
true を返す。
false を返す。
10.1.11 [[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of
OrdinaryOwnPropertyKeys (obj)を返す。
10.1.11.1 OrdinaryOwnPropertyKeys ( obj )
The abstract operation OrdinaryOwnPropertyKeys takes argument obj (an Object) and returns a
- keysを新しい空の
List とする。 array index であるようなobjの各ownproperty key propertyKeyについて、ascending numeric index orderで、以下を行う- propertyKeyをkeysへappendする。
- Stringであり、
array index でないようなobjの各ownproperty key propertyKeyについて、property creationのascending chronological orderで、以下を行う- propertyKeyをkeysへappendする。
- Symbolであるようなobjの各own
property key propertyKeyについて、property creationのascending chronological orderで、以下を行う- propertyKeyをkeysへappendする。
- keysを返す。
10.1.12 OrdinaryObjectCreate ( proto [ , additionalInternalSlotsList ] )
The abstract operation OrdinaryObjectCreate takes argument proto (an Object or
- internalSlotsListを« [[Prototype]], [[Extensible]] »とする。
- additionalInternalSlotsListが存在するなら、internalSlotsListをinternalSlotsListとadditionalInternalSlotsListの
list-concatenation に設定する。 - objを
MakeBasicObject (internalSlotsList)とする。 - obj.[[Prototype]]をprotoに設定する。
- objを返す。
OrdinaryObjectCreateは
10.1.13 OrdinaryCreateFromConstructor ( ctor, intrinsicDefaultProto [ , internalSlotsList ] )
The abstract operation OrdinaryCreateFromConstructor takes arguments ctor (a
Assert : intrinsicDefaultProtoはこの仕様におけるintrinsic objectの名前である。対応するobjectは、objectの[[Prototype]]値として使用されることを意図したintrinsicでなければならない。- protoを ?
GetPrototypeFromConstructor (ctor, intrinsicDefaultProto) とする。 - internalSlotsListが存在するなら、slotsをinternalSlotsListとする。
- そうでなければ、slotsを新しい空の
List とする。 OrdinaryObjectCreate (proto, slots)を返す。
10.1.14 GetPrototypeFromConstructor ( ctor, intrinsicDefaultProto )
The abstract operation GetPrototypeFromConstructor takes arguments ctor (a
Assert : intrinsicDefaultProtoはこの仕様におけるintrinsic objectの名前である。対応するobjectは、objectの[[Prototype]]値として使用されることを意図したintrinsicでなければならない。- protoを ?
Get (ctor,"prototype" ) とする。 - protoがObjectでないなら、
- realmを ?
GetFunctionRealm (ctor) とする。 - protoをintrinsicDefaultProtoという名前のrealmのintrinsic objectに設定する。
- realmを ?
- protoを返す。
ctorが[[Prototype]]値を供給しない場合、使用されるdefault valueは
10.1.15 RequireInternalSlot ( obj, internalSlot )
The abstract operation RequireInternalSlot takes arguments obj (an ECMAScript language value) and internalSlot (an internal slot name) and returns either a
- objがObjectでないなら、
TypeError 例外をthrowする。 - objがinternalSlot internal slotを持たないなら、
TypeError 例外をthrowする。 unused を返す。
10.2 ECMAScript関数オブジェクト
ECMAScript
[[Extensible]]および[[Prototype]]に加えて、ECMAScript
| Internal Slot | 型 | 説明 |
|---|---|---|
| [[Environment]] |
|
functionがclosed overされた |
| [[PrivateEnvironment]] |
|
functionがclosed overされた |
| [[FormalParameters]] |
|
functionのformal parameter listを定義するsource textのroot parse node。 |
| [[ECMAScriptCode]] |
|
functionのbodyを定義するsource textのroot parse node。 |
| [[ConstructorKind]] |
|
functionがderived class |
| [[Realm]] |
|
functionが作成された |
| [[ScriptOrModule]] |
|
functionが作成されたscriptまたはmodule。 |
| [[ThisMode]] |
|
functionのformal parametersおよびcode body内でthis参照がどのように解釈されるかを定義します。thisが字句的に囲むfunctionの |
| [[Strict]] | Boolean |
これが |
| [[HomeObject]] |
Objectまたは |
functionがsuperを使用する場合、これは、その[[GetPrototypeOf]]がsuper property lookupsを開始するobjectを提供するobjectです。
|
| [[SourceText]] | Unicode code pointsのsequence |
functionを定義する |
| [[Fields]] |
|
functionがclassである場合、これはclassのnon-static fieldsおよび対応するinitializersを表す |
| [[PrivateMethods]] |
|
functionがclassである場合、これはclassのnon-static private methodsおよびaccessorsを表すlistです。 |
| [[ClassFieldInitializerName]] |
String、Symbol、 |
functionがclass fieldのinitializerとして作成された場合、そのfieldの |
| [[IsClassConstructor]] | Boolean |
functionがclass |
すべてのECMAScript
10.2.1 [[Call]] ( thisArg, argList )
The [[Call]] internal method of ECMAScript
- callerContextを
running execution context とする。 - calleeContextを
PrepareForOrdinaryCall (func,undefined )とする。 Assert : calleeContextは現在running execution context である。- func.[[IsClassConstructor]]が
true なら、- errorを新しく作成された
TypeError objectとする。 NOTE : errorは、funcに関連付けられたRealm Record を伴うcalleeContext内で作成される。- calleeContextを
execution context stack から削除し、callerContextをrunning execution context として復元する。 - errorをthrowする。
- errorを新しく作成された
OrdinaryCallBindThis (func, calleeContext, thisArg)を実行する。- resultを
Completion (OrdinaryCallEvaluateBody (func, argList))とする。 - calleeContextを
execution context stack から削除し、callerContextをrunning execution context として復元する。 - resultが
return completion なら、result.[[Value]]を返す。 Assert : resultはthrow completion である。- ? resultを返す。
ステップ
10.2.1.1 PrepareForOrdinaryCall ( func, newTarget )
The abstract operation PrepareForOrdinaryCall takes arguments func (an ECMAScript
- callerContextを
running execution context とする。 - calleeContextを新しい
ECMAScript code execution context とする。 - calleeContextのFunctionをfuncに設定する。
- calleeRealmをfunc.[[Realm]]とする。
- calleeContextの
Realm をcalleeRealmに設定する。 - calleeContextのScriptOrModuleをfunc.[[ScriptOrModule]]に設定する。
- localEnvを
NewFunctionEnvironment (func, newTarget)とする。 - calleeContextのLexicalEnvironmentをlocalEnvに設定する。
- calleeContextのVariableEnvironmentをlocalEnvに設定する。
- calleeContextのPrivateEnvironmentをfunc.[[PrivateEnvironment]]に設定する。
- callerContextがまだsuspendedでないなら、callerContextをsuspendする。
- calleeContextを
execution context stack へpushする；calleeContextは現在running execution context である。 NOTE : この時点以降に生成される任意のexception objectsはcalleeRealmに関連付けられる。- calleeContextを返す。
10.2.1.2 OrdinaryCallBindThis ( func, calleeContext, thisArg )
The abstract operation OrdinaryCallBindThis takes arguments func (an ECMAScript
- thisModeをfunc.[[ThisMode]]とする。
- thisModeが
lexical なら、unused を返す。 - calleeRealmをfunc.[[Realm]]とする。
- localEnvをcalleeContextのLexicalEnvironmentとする。
- thisModeが
strict なら、- thisValueをthisArgとする。
- そうでなければ、
- thisArgが
undefined またはnull のいずれかなら、- globalEnvをcalleeRealm.[[GlobalEnv]]とする。
Assert : globalEnvはGlobal Environment Record である。- thisValueをglobalEnv.[[GlobalThisValue]]とする。
- そうでなければ、
- thisArgが
Assert : localEnvはFunction Environment Record である。Assert : 次のstepはabrupt completion を返すことはない。なぜならlocalEnv.[[ThisBindingStatus]]はinitialized でないからである。- !
BindThisValue (localEnv, thisValue)を実行する。 unused を返す。
10.2.1.3 Runtime Semantics: EvaluateBody
The
- 引数funcおよびargListを伴う
FunctionBody のEvaluateFunctionBody を ? で返す。
- 引数funcおよびargListを伴う
ConciseBody のEvaluateConciseBody を ? で返す。
- 引数funcおよびargListを伴う
GeneratorBody のEvaluateGeneratorBody を ? で返す。
- 引数funcおよびargListを伴う
AsyncGeneratorBody のEvaluateAsyncGeneratorBody を ? で返す。
- 引数funcおよびargListを伴う
AsyncFunctionBody のEvaluateAsyncFunctionBody を ? で返す。
- 引数funcおよびargListを伴う
AsyncConciseBody のEvaluateAsyncConciseBody を ? で返す。
Assert : argListは空である。Assert : func.[[ClassFieldInitializerName]]はempty でない。IsAnonymousFunctionDefinition (AssignmentExpression )がtrue なら、- valueを、引数func.[[ClassFieldInitializerName]]を伴う
Initializer のNamedEvaluation の ? 結果とする。
- valueを、引数func.[[ClassFieldInitializerName]]を伴う
- そうでなければ、
- rhsを
AssignmentExpression のEvaluation の ? 結果とする。 - valueを ?
GetValue (rhs) とする。
- rhsを
ReturnCompletion (value)を返す。
field initializersはfunction boundaryを構成しますが、
Assert : argListは空である。- 引数funcを伴う
ClassStaticBlockBody のEvaluateClassStaticBlockBody を ? で返す。
10.2.1.4 OrdinaryCallEvaluateBody ( func, argList )
The abstract operation OrdinaryCallEvaluateBody takes arguments func (an ECMAScript
- 引数funcおよびargListを伴うfunc.[[ECMAScriptCode]]の
EvaluateBody を ? で返す。
10.2.2 [[Construct]] ( argList, newTarget )
The [[Construct]] internal method of ECMAScript
- callerContextを
running execution context とする。 - kindをfunc.[[ConstructorKind]]とする。
- kindが
base なら、- thisArgを ?
OrdinaryCreateFromConstructor (newTarget,"%Object.prototype%" ) とする。
- thisArgを ?
- calleeContextを
PrepareForOrdinaryCall (func, newTarget)とする。 Assert : calleeContextは現在running execution context である。- kindが
base なら、OrdinaryCallBindThis (func, calleeContext, thisArg)を実行する。- initializeResultを
Completion (InitializeInstanceElements (thisArg, func))とする。 - initializeResultが
abrupt completion なら、- calleeContextを
execution context stack から削除し、callerContextをrunning execution context として復元する。 - ? initializeResultを返す。
- calleeContextを
- ctorEnvをcalleeContextのLexicalEnvironmentとする。
- resultを
Completion (OrdinaryCallEvaluateBody (func, argList))とする。 - calleeContextを
execution context stack から削除し、callerContextをrunning execution context として復元する。 - resultが
throw completion なら、- ? resultを返す。
Assert : resultはreturn completion である。- result.[[Value]]がObjectなら、result.[[Value]]を返す。
- kindが
base なら、thisArgを返す。 - result.[[Value]]が
undefined でないなら、TypeError 例外をthrowする。 - thisBindingを ? ctorEnv.
GetThisBinding () とする。 Assert : thisBindingはObjectである。- thisBindingを返す。
10.2.3 OrdinaryFunctionCreate ( proto, sourceText, paramList, body, thisMode, envRecord, privateEnv )
The abstract operation OrdinaryFunctionCreate takes arguments proto (an Object), sourceText (a sequence of Unicode code points), paramList (a
- internalSlotsListを
Table 26 に列挙されるinternal slotsとする。 - funcを
OrdinaryObjectCreate (proto, internalSlotsList)とする。 - func.[[Call]]を
10.2.1 で指定される定義に設定する。 - func.[[SourceText]]をsourceTextに設定する。
- func.[[FormalParameters]]をparamListに設定する。
- func.[[ECMAScriptCode]]をbodyに設定する。
- strictを
IsStrict (body)とする。 - func.[[Strict]]をstrictに設定する。
- thisModeが
lexical-this なら、func.[[ThisMode]]をlexical に設定する。 - そうでなく、strictが
true なら、func.[[ThisMode]]をstrict に設定する。 - そうでなければ、func.[[ThisMode]]を
global に設定する。 - func.[[IsClassConstructor]]を
false に設定する。 - func.[[Environment]]をenvRecordに設定する。
- func.[[PrivateEnvironment]]をprivateEnvに設定する。
- func.[[ScriptOrModule]]を
GetActiveScriptOrModule ()に設定する。 - func.[[Realm]]を
current Realm Record に設定する。 - func.[[HomeObject]]を
undefined に設定する。 - func.[[Fields]]を新しい空の
List に設定する。 - func.[[PrivateMethods]]を新しい空の
List に設定する。 - func.[[ClassFieldInitializerName]]を
empty に設定する。 - lengthをparamListの
ExpectedArgumentCount とする。 SetFunctionLength (func, length)を実行する。- funcを返す。
10.2.4 AddRestrictedFunctionProperties ( func, realm )
The abstract operation AddRestrictedFunctionProperties takes arguments func (a
Assert : realm.[[Intrinsics]].[[%ThrowTypeError% ]]は存在し、初期化済みである。- throwerをrealm.[[Intrinsics]].[[
%ThrowTypeError% ]]とする。 - !
DefinePropertyOrThrow (func,"caller" , PropertyDescriptor { [[Get]]: thrower, [[Set]]: thrower, [[Enumerable]]:false , [[Configurable]]:true })を実行する。 - !
DefinePropertyOrThrow (func,"arguments" , PropertyDescriptor { [[Get]]: thrower, [[Set]]: thrower, [[Enumerable]]:false , [[Configurable]]:true })を実行する。 unused を返す。
10.2.4.1 %ThrowTypeError% ( )
このfunctionは%ThrowTypeError% intrinsic objectです。
これは、
呼び出されたとき、次のstepsを実行します：
TypeError 例外をthrowする。
このfunctionの[[Extensible]] internal slotの値は
このfunctionの
このfunctionの
10.2.5 MakeConstructor ( func [ , writableProto [ , proto ] ] )
The abstract operation MakeConstructor takes argument func (an ECMAScript
- funcがECMAScript
function object なら、Assert :IsConstructor (func)はfalse である。Assert : funcはextensible objectであり、"prototype" own propertyを持たない。- func.[[Construct]]を
10.2.2 で指定される定義に設定する。
- そうでなければ、
- func.[[Construct]]を
10.3.2 で指定される定義に設定する。
- func.[[Construct]]を
- func.[[ConstructorKind]]を
base に設定する。 - writableProtoが存在しないなら、writableProtoを
true に設定する。 - protoが存在しないなら、
- protoを
OrdinaryObjectCreate (%Object.prototype% )に設定する。 - !
DefinePropertyOrThrow (proto,"constructor" , PropertyDescriptor { [[Value]]: func, [[Writable]]: writableProto, [[Enumerable]]:false , [[Configurable]]:true })を実行する。
- protoを
- !
DefinePropertyOrThrow (func,"prototype" , PropertyDescriptor { [[Value]]: proto, [[Writable]]: writableProto, [[Enumerable]]:false , [[Configurable]]:false })を実行する。 unused を返す。
10.2.6 MakeClassConstructor ( func )
The abstract operation MakeClassConstructor takes argument func (an ECMAScript
Assert : func.[[IsClassConstructor]]はfalse である。- func.[[IsClassConstructor]]を
true に設定する。 unused を返す。
10.2.7 MakeMethod ( func, homeObj )
The abstract operation MakeMethod takes arguments func (an ECMAScript
Assert : homeObjはordinary object である。- func.[[HomeObject]]をhomeObjに設定する。
unused を返す。
10.2.8 DefineMethodProperty ( homeObj, name, closure, enumerable )
The abstract operation DefineMethodProperty takes arguments homeObj (an Object), name (a
Assert : homeObjはordinaryかつextensible objectである。- nameが
Private Name なら、PrivateElement { [[Key]]: name, [[Kind]]:method , [[Value]]: closure }を返す。 - propertyDescをPropertyDescriptor { [[Value]]: closure, [[Writable]]:
true , [[Enumerable]]: enumerable, [[Configurable]]:true }とする。 - ?
DefinePropertyOrThrow (homeObj, name, propertyDesc)を実行する。 NOTE :DefinePropertyOrThrow がabrupt completion を返すのは、nameが"prototype" であるclass static methodを定義しようとする場合だけである。unused を返す。
10.2.9 SetFunctionName ( func, name [ , prefix ] )
The abstract operation SetFunctionName takes arguments func (a
Assert : funcはextensible objectであり、"name" own propertyを持たない。- nameがSymbolなら、
- descriptionをname.[[Description]]とする。
- descriptionが
undefined なら、nameを空のStringに設定する。 - そうでなければ、nameを
"[" 、description、および"]" のstring-concatenation に設定する。
- そうでなく、nameが
Private Name なら、- nameをname.[[Description]]に設定する。
- funcが[[InitialName]] internal slotを持つなら、
- func.[[InitialName]]をnameに設定する。
- prefixが存在するなら、
- prefixedNameを、prefix、code unit 0x0020 (SPACE)、およびnameの
string-concatenation とする。 - funcが[[InitialName]] internal slotを持つなら、
NOTE : 次のstepの選択は、このAbstract Operationが呼び出されるたびに独立して行われる。- func.[[InitialName]]をnameまたはprefixedNameのいずれかの
implementation-defined choiceに設定する。
- nameをprefixedNameに設定する。
- prefixedNameを、prefix、code unit 0x0020 (SPACE)、およびnameの
- !
DefinePropertyOrThrow (func,"name" , PropertyDescriptor { [[Value]]: name, [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:true })を実行する。 unused を返す。
10.2.10 SetFunctionLength ( func, length )
The abstract operation SetFunctionLength takes arguments func (a
Assert : funcはextensible objectであり、"length" own propertyを持たない。- !
DefinePropertyOrThrow (func,"length" , PropertyDescriptor { [[Value]]:𝔽 (length), [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:true })を実行する。 unused を返す。
10.2.11 FunctionDeclarationInstantiation ( func, argList )
The abstract operation FunctionDeclarationInstantiation takes arguments func (an ECMAScript
ECMAScript functionを評価するために
呼び出されたとき、次のstepsを実行します：
- 実行中の実行コンテキストをcalleeContextとする。
- func.[[ECMAScriptCode]]をcodeとする。
- func.[[Strict]]をstrictとする。
- func.[[FormalParameters]]をformalsとする。
- formalsの
BoundNames をparamNamesとする。 - paramNamesに重複するエントリがある場合、hasDuplicatesを
true とする。そうでなければ、hasDuplicatesをfalse とする。 - formalsの
IsSimpleParameterList をsimpleParamListとする。 - formalsの
ContainsExpression をhasParamExprsとする。 - codeの
VarDeclaredNames をvariableNamesとする。 - codeの
VarScopedDeclarations をvariableDeclsとする。 - codeの
LexicallyDeclaredNames をlexicalNamesとする。 - funcNamesを新しい空の
List とする。 - funcsToInitializeを新しい空の
List とする。 - variableDeclsの各要素variableDeclについて、
List の逆順で、次を行う。- variableDeclが
VariableDeclaration 、ForBinding 、BindingIdentifier のいずれでもない場合、Assert : variableDeclは、FunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 、またはAsyncGeneratorDeclaration のいずれかである。- variableDeclの
BoundNames の唯一の要素をfuncNameとする。 - funcNamesがfuncNameを含まない場合、
- funcNameをfuncNamesの最初の要素として挿入する。
NOTE : 同じ名前に対して複数の関数宣言がある場合、最後の宣言が使用される。- variableDeclをfuncsToInitializeの最初の要素として挿入する。
- variableDeclが
- argumentsObjNeededを
true とする。 - func.[[ThisMode]]が
lexical である場合、NOTE : アロー関数はargumentsオブジェクトを持たない。- argumentsObjNeededを
false に設定する。
- そうでなく、paramNamesが
"arguments" を含む場合、- argumentsObjNeededを
false に設定する。
- argumentsObjNeededを
- そうでなく、hasParamExprsが
false である場合、- funcNamesが
"arguments" を含む、またはlexicalNamesが"arguments" を含む場合、- argumentsObjNeededを
false に設定する。
- argumentsObjNeededを
- funcNamesが
- strictが
true である、またはhasParamExprsがfalse である場合、NOTE : パラメータには単一のEnvironment Record だけが必要である。これは、strict modeコード内のevalへの呼び出しが、evalの外側で可視となる新しい束縛を作成できないためである。- calleeContextのLexicalEnvironmentをenvRecordとする。
- そうでなければ、
NOTE : 仮引数リスト内のdirect eval 呼び出しによって作成された束縛が、パラメータが宣言される環境の外側にあることを保証するため、別個のEnvironment Record が必要である。- calleeContextのLexicalEnvironmentをcalleeEnvとする。
NewDeclarativeEnvironment (calleeEnv)をenvRecordとする。Assert : calleeContextのVariableEnvironmentとcalleeEnvは同じEnvironment Record である。- calleeContextのLexicalEnvironmentをenvRecordに設定する。
- paramNamesの各String paramNameについて、次を行う。
- ! envRecord.
HasBinding (paramName)をalreadyDeclaredとする。 NOTE :Early error により、重複するパラメータ名は、パラメータ既定値またはrestパラメータを持たない非strict関数でのみ発生できることが保証される。- alreadyDeclaredが
false である場合、- ! envRecord.
CreateMutableBinding (paramName,false )を実行する。 - hasDuplicatesが
true である場合、- ! envRecord.
InitializeBinding (paramName,undefined )を実行する。
- ! envRecord.
- ! envRecord.
- ! envRecord.
- argumentsObjNeededが
true である場合、- strictが
true である、またはsimpleParamListがfalse である場合、CreateUnmappedArgumentsObject (argList)をargumentsObjとする。
- そうでなければ、
NOTE : マップされたargumentsオブジェクトは、restパラメータ、パラメータ既定値初期化子、または分割代入パラメータを持たない非strict関数に対してのみ提供される。CreateMappedArgumentsObject (func, formals, argList, envRecord)をargumentsObjとする。
- strictが
true である場合、- ! envRecord.
CreateImmutableBinding ("arguments" ,false )を実行する。 NOTE : strict modeコードでは、この束縛に代入しようとすることがEarly error によって防止されるため、その可変性は観測できない。
- ! envRecord.
- そうでなければ、
- ! envRecord.
CreateMutableBinding ("arguments" ,false )を実行する。
- ! envRecord.
- ! envRecord.
InitializeBinding ("arguments" , argumentsObj)を実行する。 - paramNamesと«
"arguments" »のlist-concatenation をparamBindingsとする。
- strictが
- そうでなければ、
- paramNamesをparamBindingsとする。
CreateListIteratorRecord (argList)をiteratorRecordとする。- hasDuplicatesが
true である場合、- usedEnvを
undefined とする。
- usedEnvを
- そうでなければ、
- envRecordをusedEnvとする。
NOTE : 次のステップはReturnCompletion を返すことができない。これは、式位置でそのようなcompletionが発生する唯一の方法はYieldExpression の使用によるものであり、これは15.5.1 および15.6.1 のEarly Error規則により、パラメータリストでは禁止されているためである。- iteratorRecordおよびusedEnvを引数として、formalsの
IteratorBindingInitialization を実行する。 - hasParamExprsが
false である場合、NOTE : パラメータとトップレベルのvarには単一のEnvironment Record だけが必要である。List paramBindingsのコピーをinstantiatedVariableNamesとする。- variableNamesの各要素nameについて、次を行う。
- instantiatedVariableNamesがnameを含まない場合、
- nameをinstantiatedVariableNamesに追加する。
- ! envRecord.
CreateMutableBinding (name,false )を実行する。 - ! envRecord.
InitializeBinding (name,undefined )を実行する。
- instantiatedVariableNamesがnameを含まない場合、
- envRecordをvariableEnvとする。
- そうでなければ、
NOTE : 仮引数リスト内の式によって作成されたクロージャが、関数本体内の宣言を可視にしないことを保証するため、別個のEnvironment Record が必要である。NewDeclarativeEnvironment (envRecord)をvariableEnvとする。- calleeContextのVariableEnvironmentをvariableEnvに設定する。
- instantiatedVariableNamesを新しい空の
List とする。 - variableNamesの各要素nameについて、次を行う。
- instantiatedVariableNamesがnameを含まない場合、
- nameをinstantiatedVariableNamesに追加する。
- ! variableEnv.
CreateMutableBinding (name,false )を実行する。 - paramBindingsがnameを含まない、またはfuncNamesがnameを含む場合、
- initialValueを
undefined とする。
- initialValueを
- そうでなければ、
- ! envRecord.
GetBindingValue (name,false )をinitialValueとする。
- ! envRecord.
- ! variableEnv.
InitializeBinding (name, initialValue)を実行する。 NOTE : 仮引数と同じ名前を持つvarは、最初は対応する初期化済みパラメータと同じ値を持つ。
- instantiatedVariableNamesがnameを含まない場合、
- strictが
true である場合、- variableEnvをlexicalEnvとする。
- そうでなければ、
ホスト がWebブラウザである、またはその他の形でBlock-Level Function Declarations Web Legacy Compatibility Semantics をサポートする場合、- code
Contains xがtrue であるような任意のBlock 、CaseClause 、またはDefaultClause xのStatementList に直接含まれる各FunctionDeclaration funcDeclについて、次を行う。- funcDeclの
BindingIdentifier のStringValue をfuncNameとする。 FunctionDeclaration funcDeclを、funcNameをBindingIdentifier として持つVariableStatement に置き換えても、funcに対してEarly Errorsが発生せず、かつparamNamesがfuncNameを含まない場合、NOTE : funcNameに対するvar束縛は、それがVarDeclaredName、仮引数の名前、または別のFunctionDeclaration のいずれでもない場合にのみ、ここでインスタンス化される。- instantiatedVariableNamesがfuncNameを含まず、かつfuncNameが
"arguments" でない場合、- ! variableEnv.
CreateMutableBinding (funcName,false )を実行する。 - ! variableEnv.
InitializeBinding (funcName,undefined )を実行する。 - funcNameをinstantiatedVariableNamesに追加する。
- ! variableEnv.
FunctionDeclaration funcDeclが評価されるとき、15.2.6 で提供されるFunctionDeclaration Evaluation アルゴリズムの代わりに、次のステップを実行する。- 実行中の実行コンテキストのVariableEnvironmentをfuncEnvとする。
- 実行中の実行コンテキストのLexicalEnvironmentをblockEnvとする。
- ! blockEnv.
GetBindingValue (funcName,false )をfuncObjとする。 - ! funcEnv.
SetMutableBinding (funcName, funcObj,false )を実行する。 unused を返す。
- funcDeclの
- code
NewDeclarativeEnvironment (variableEnv)をlexicalEnvとする。NOTE : 非strict関数は、トップレベルのlexical宣言に別個のEnvironment Record を使用する。これにより、direct eval は、evalコードによって導入されたvar scoped宣言が、既存のトップレベルのlexically scoped宣言と競合するかどうかを判断できる。strict関数では、strictdirect eval が常にすべての宣言を新しいEnvironment Record に配置するため、これは不要である。
- calleeContextのLexicalEnvironmentをlexicalEnvに設定する。
- codeの
LexicallyScopedDeclarations をlexicalDeclsとする。 - lexicalDeclsの各要素lexicalDeclについて、次を行う。
NOTE : lexically declared nameは、関数/ジェネレータ宣言、仮引数、またはvar名と同じにすることはできない。Lexically declared nameはここでインスタンス化されるだけで、初期化はされない。- lexicalDeclの
BoundNames の各要素nameについて、次を行う。- lexicalDeclの
IsConstantDeclaration がtrue である場合、- ! lexicalEnv.
CreateImmutableBinding (name,true )を実行する。
- ! lexicalEnv.
- そうでなければ、
- ! lexicalEnv.
CreateMutableBinding (name,false )を実行する。
- ! lexicalEnv.
- lexicalDeclの
- calleeContextのPrivateEnvironmentをprivateEnvとする。
- funcsToInitializeの各
Parse Node funcDeclについて、次を行う。- funcDeclの
BoundNames の唯一の要素をfuncNameとする。 - lexicalEnvおよびprivateEnvを引数として、funcDeclの
InstantiateFunctionObject をfuncObjとする。 - ! variableEnv.
SetMutableBinding (funcName, funcObj,false )を実行する。
- funcDeclの
unused を返す。
10.3 Built-in Function Objects
built-in
すべての
- [[Realm]]。functionが作成された
realm を表すRealm Record 。 - [[InitialName]]。functionの初期名であるString。
20.2.3.5 によって使用されます。 - [[Async]]。そのfunctionが
BuiltinCallOrConstruct においてasync function callおよびconstruct behaviourを持つかどうかを示すBoolean。
built-in
built-in
built-in
実装は、この仕様で定義されていない追加のbuilt-in
10.3.1 [[Call]] ( thisArg, argList )
The [[Call]] internal method of built-in
- ?
BuiltinCallOrConstruct (func, thisArg, argList,undefined )を返す。
10.3.2 [[Construct]] ( argList, newTarget )
The [[Construct]] internal method of built-in
- resultを ?
BuiltinCallOrConstruct (func,uninitialized , argList, newTarget) とする。 Assert : resultはObjectである。- resultを返す。
10.3.3 BuiltinCallOrConstruct ( func, thisArg, argList, newTarget )
The abstract operation BuiltinCallOrConstruct takes arguments func (a built-in
- callerContextを
running execution context とする。 - callerContextがまだsuspendedでないなら、callerContextをsuspendする。
- calleeContextを新しい
execution context とする。 - calleeContextのFunctionをfuncに設定する。
- calleeRealmをfunc.[[Realm]]とする。
- calleeContextの
Realm をcalleeRealmに設定する。 - calleeContextのScriptOrModuleを
null に設定する。 - calleeContextの任意の必要な
implementation-defined initializationを実行する。 - calleeContextを
execution context stack へpushする；calleeContextは現在running execution context である。 - func.[[Async]]が
true なら、- promiseCapabilityを !
NewPromiseCapability (%Promise% ) とする。 - resultsClosureを、func、thisArg、argList、およびnewTargetをcaptureし、呼び出されたときに次のstepsを実行する、parametersを持たない新しい
Abstract Closure とする：- resultを、funcの仕様に適合する方法でfuncを評価した結果である
Completion Record とする。thisArgがuninitialized である場合、this 値はuninitializedである；そうでなければthisArgがthis 値を提供する。argListはnamed parametersを提供する。newTargetはNewTarget値を提供する。 NOTE : funcがこの文書内で定義されている場合、“funcの仕様”とは、algorithm stepsまたはその他の手段によってそれに対して指定されたbehaviourである。Completion (result)を返す。
- resultを、funcの仕様に適合する方法でfuncを評価した結果である
AsyncFunctionStart (promiseCapability, resultsClosure)を実行する。- calleeContextを
execution context stack から削除し、callerContextをrunning execution context として復元する。 - promiseCapability.[[Promise]]を返す。
- promiseCapabilityを !
- resultを、funcの仕様に適合する方法でfuncを評価した結果である
Completion Record とする。thisArgがuninitialized である場合、this 値はuninitializedである；そうでなければthisArgがthis 値を提供する。argListはnamed parametersを提供する。newTargetはNewTarget値を提供する。 NOTE : funcがこの文書内で定義されている場合、“funcの仕様”とは、algorithm stepsまたはその他の手段によってそれに対して指定されたbehaviourである。- calleeContextを
execution context stack から削除し、callerContextをrunning execution context として復元する。 - ? resultを返す。
calleeContextが
10.3.4 CreateBuiltinFunction ( behaviour, length, name, additionalInternalSlotsList [ , realm [ , proto [ , prefix [ , async ] ] ] ] )
The abstract operation CreateBuiltinFunction takes arguments behaviour (an
- realmが存在しないなら、realmを
current Realm Record に設定する。 - protoが存在しないなら、protoをrealm.[[Intrinsics]].[[
%Function.prototype% ]]に設定する。 - asyncが存在しないなら、asyncを
false に設定する。 - internalSlotsListを、
10.3 がこれから作成されるbuilt-infunction object に要求するすべてのinternal slotsの名前を含むList とする。 - additionalInternalSlotsListの要素をinternalSlotsListへappendする。
- funcを、呼び出されたときに、提供されたargumentsをbehaviourによって指定される対応parametersの値として使用して、behaviourによって記述されるactionを実行する新しいbuilt-in
function object とする。新しいfunction object は、internalSlotsListの要素を名前とするinternal slots、および[[InitialName]] internal slotを持つ。 - func.[[Async]]をasyncに設定する。
- func.[[Prototype]]をprotoに設定する。
- func.[[Extensible]]を
true に設定する。 - func.[[Realm]]をrealmに設定する。
- func.[[InitialName]]を
null に設定する。 SetFunctionLength (func, length)を実行する。- prefixが存在しないなら、
SetFunctionName (func, name)を実行する。
- そうでなければ、
SetFunctionName (func, name, prefix)を実行する。
- funcを返す。
この仕様で定義される各built-in functionは、CreateBuiltinFunction abstract operationを呼び出すことによって作成されます。
10.4 Built-in Exotic Object Internal Methods and Slots
この仕様は、いくつかの種類のbuilt-in
10.4.1 Bound Function Exotic Objects
objectは、その[[Call]]および（該当する場合）[[Construct]] internal methodsが次の実装を使用し、その他のessential internal methodsが
| Internal Slot | 型 | 説明 |
|---|---|---|
| [[BoundTargetFunction]] | callable Object |
wrapped |
| [[BoundThis]] |
|
wrapped functionを呼び出すときに常に |
| [[BoundArguments]] |
|
その要素がwrapped functionへの任意のcallの最初のargumentsとして使用される値のlist。 |
10.4.1.1 [[Call]] ( thisArg, argList )
The [[Call]] internal method of
- targetをfunc.[[BoundTargetFunction]]とする。
- boundThisをfunc.[[BoundThis]]とする。
- boundArgsをfunc.[[BoundArguments]]とする。
- argsをboundArgsとargListの
list-concatenation とする。 - ?
Call (target, boundThis, args)を返す。
10.4.1.2 [[Construct]] ( argList, newTarget )
The [[Construct]] internal method of
- targetをfunc.[[BoundTargetFunction]]とする。
Assert :IsConstructor (target)はtrue である。- boundArgsをfunc.[[BoundArguments]]とする。
- argsをboundArgsとargListの
list-concatenation とする。 SameValue (func, newTarget)がtrue なら、newTargetをtargetに設定する。- ?
Construct (target, args, newTarget)を返す。
10.4.1.3 BoundFunctionCreate ( targetFunc, boundThis, boundArgs )
The abstract operation BoundFunctionCreate takes arguments targetFunc (a
- protoを ? targetFunc.[[GetPrototypeOf]]() とする。
- internalSlotsListを、« [[Prototype]], [[Extensible]] »と
Table 27 に列挙されるinternal slotsのlist-concatenation とする。 - objを
MakeBasicObject (internalSlotsList)とする。 - obj.[[Prototype]]をprotoに設定する。
- obj.[[Call]]を
10.4.1.1 で指定されるように設定する。 IsConstructor (targetFunc)がtrue なら、- obj.[[Construct]]を
10.4.1.2 で指定されるように設定する。
- obj.[[Construct]]を
- obj.[[BoundTargetFunction]]をtargetFuncに設定する。
- obj.[[BoundThis]]をboundThisに設定する。
- obj.[[BoundArguments]]をboundArgsに設定する。
- objを返す。
10.4.2 Array Exotic Objects
Arrayは、
objectは、その[[DefineOwnProperty]] internal methodが次の実装を使用し、その他のessential internal methodsが
10.4.2.1 [[DefineOwnProperty]] ( propertyKey, propertyDesc )
The [[DefineOwnProperty]] internal method of
- propertyKeyが
"length" なら、?ArraySetLength (array, propertyDesc)を返す。 - propertyKeyが
array index なら、- lengthDescを
OrdinaryGetOwnProperty (array,"length" )とする。 Assert : lengthDescはundefined でない。Assert :IsDataDescriptor (lengthDesc)はtrue である。Assert : lengthDesc.[[Configurable]]はfalse である。- lengthをlengthDesc.[[Value]]とする。
Assert : lengthは非負整数のNumberである。- indexを !
ToUint32 (propertyKey) とする。 - index ≥ lengthかつlengthDesc.[[Writable]]が
false なら、false を返す。 - succeededを !
OrdinaryDefineOwnProperty (array, propertyKey, propertyDesc) とする。 - succeededが
false なら、false を返す。 - index ≥ lengthなら、
- lengthDesc.[[Value]]をindex +
1 𝔽に設定する。 - succeededを !
OrdinaryDefineOwnProperty (array,"length" , lengthDesc) に設定する。 Assert : succeededはtrue である。
- lengthDesc.[[Value]]をindex +
true を返す。
- lengthDescを
- ?
OrdinaryDefineOwnProperty (array, propertyKey, propertyDesc)を返す。
10.4.2.2 ArrayCreate ( length [ , proto ] )
The abstract operation ArrayCreate takes argument length (a non-negative
- length > 232 - 1なら、
RangeError 例外をthrowする。 - protoが存在しないなら、protoを
%Array.prototype% に設定する。 - arrayを
MakeBasicObject (« [[Prototype]], [[Extensible]] »)とする。 - array.[[Prototype]]をprotoに設定する。
- array.[[DefineOwnProperty]]を
10.4.2.1 で指定されるように設定する。 - !
OrdinaryDefineOwnProperty (array,"length" , PropertyDescriptor { [[Value]]:𝔽 (length), [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })を実行する。 - arrayを返す。
10.4.2.3 ArraySpeciesCreate ( originalArray, length )
The abstract operation ArraySpeciesCreate takes arguments originalArray (an Object) and length (a non-negative
- isArrayを ?
IsArray (originalArray) とする。 - isArrayが
false なら、?ArrayCreate (length)を返す。 - ctorを ?
Get (originalArray,"constructor" ) とする。 IsConstructor (ctor)がtrue なら、- thisRealmを
current Realm Record とする。 - ctorRealmを ?
GetFunctionRealm (ctor) とする。 - thisRealmとctorRealmが同じ
Realm Record でないなら、
- thisRealmを
- ctorがObjectなら、
- ctorを ?
Get (ctor,%Symbol.species% ) に設定する。 - ctorが
null なら、ctorをundefined に設定する。
- ctorを ?
- ctorが
undefined なら、?ArrayCreate (length)を返す。 IsConstructor (ctor)がfalse なら、TypeError 例外をthrowする。- ?
Construct (ctor, «𝔽 (length) »)を返す。
originalArrayがArray.prototype methodsについて、歴史的にそのbehaviourを持っていたWeb browsersとの互換性を維持します。
10.4.2.4 ArraySetLength ( array, propertyDesc )
The abstract operation ArraySetLength takes arguments array (an Array) and propertyDesc (a
- propertyDescが[[Value]] fieldを持たないなら、
- !
OrdinaryDefineOwnProperty (array,"length" , propertyDesc)を返す。
- !
- newLengthDescをpropertyDescのcopyとする。
- newLengthを ?
ToUint32 (propertyDesc.[[Value]]) とする。 - numberLengthを ?
ToNumber (propertyDesc.[[Value]]) とする。 SameValueZero (newLength, numberLength)がfalse なら、RangeError 例外をthrowする。- newLengthDesc.[[Value]]をnewLengthに設定する。
- oldLengthDescを
OrdinaryGetOwnProperty (array,"length" )とする。 Assert : oldLengthDescはundefined でない。Assert :IsDataDescriptor (oldLengthDesc)はtrue である。Assert : oldLengthDesc.[[Configurable]]はfalse である。- oldLengthをoldLengthDesc.[[Value]]とする。
- newLength ≥ oldLengthなら、
- !
OrdinaryDefineOwnProperty (array,"length" , newLengthDesc)を返す。
- !
- oldLengthDesc.[[Writable]]が
false なら、false を返す。 - newLengthDescが[[Writable]] fieldを持たない、またはnewLengthDesc.[[Writable]]が
true なら、- newWritableを
true とする。
- newWritableを
- そうでなければ、
NOTE : 任意のelementsを削除できない場合に備えて、[[Writable]]属性をfalse に設定することはdeferされる。- newWritableを
false とする。 - newLengthDesc.[[Writable]]を
true に設定する。
- succeededを !
OrdinaryDefineOwnProperty (array,"length" , newLengthDesc) とする。 - succeededが
false なら、false を返す。 array index であり、!ToUint32 (propertyKey) ≥ newLengthであるようなarrayの各ownproperty key propertyKeyについて、descending numeric index orderで、以下を行う- deleteSucceededを ! array.[[Delete]](propertyKey) とする。
- deleteSucceededが
false なら、- newLengthDesc.[[Value]]を !
ToUint32 (propertyKey) +1 𝔽に設定する。 - newWritableが
false なら、newLengthDesc.[[Writable]]をfalse に設定する。 - !
OrdinaryDefineOwnProperty (array,"length" , newLengthDesc)を実行する。 false を返す。
- newLengthDesc.[[Value]]を !
- newWritableが
false なら、- succeededを !
OrdinaryDefineOwnProperty (array,"length" , PropertyDescriptor { [[Writable]]:false }) に設定する。 Assert : succeededはtrue である。
- succeededを !
true を返す。
10.4.3 String Exotic Objects
String objectは、String値をカプセル化し、String値の個々のcode unit elementsに対応するvirtual
objectは、その[[GetOwnProperty]]、[[DefineOwnProperty]]、および[[OwnPropertyKeys]] internal methodsが次の実装を使用し、その他のessential internal methodsが
10.4.3.1 [[GetOwnProperty]] ( propertyKey )
The [[GetOwnProperty]] internal method of
- propertyDescを
OrdinaryGetOwnProperty (string, propertyKey)とする。 - propertyDescが
undefined でないなら、propertyDescを返す。 StringGetOwnProperty (string, propertyKey)を返す。
10.4.3.2 [[DefineOwnProperty]] ( propertyKey, propertyDesc )
The [[DefineOwnProperty]] internal method of
- stringDescを
StringGetOwnProperty (string, propertyKey)とする。 - stringDescが
undefined でないなら、- extensibleをstring.[[Extensible]]とする。
IsCompatiblePropertyDescriptor (extensible, propertyDesc, stringDesc)を返す。
- !
OrdinaryDefineOwnProperty (string, propertyKey, propertyDesc)を返す。
10.4.3.3 [[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of
- keysを新しい空の
List とする。 - stringをobj.[[StringData]]とする。
Assert : stringはStringである。- lengthをstringのlengthとする。
- 0 ≤ i < lengthである各
integer iについて、昇順で、以下を行う array index であり、!ToIntegerOrInfinity (propertyKey) ≥ lengthであるようなobjの各ownproperty key propertyKeyについて、ascending numeric index orderで、以下を行う- propertyKeyをkeysへappendする。
- Stringであり、
array index でないようなobjの各ownproperty key propertyKeyについて、property creationのascending chronological orderで、以下を行う- propertyKeyをkeysへappendする。
- Symbolであるようなobjの各own
property key propertyKeyについて、property creationのascending chronological orderで、以下を行う- propertyKeyをkeysへappendする。
- keysを返す。
10.4.3.4 StringCreate ( value, proto )
The abstract operation StringCreate takes arguments value (a String) and proto (an Object) and returns a
- stringを
MakeBasicObject (« [[Prototype]], [[Extensible]], [[StringData]] »)とする。 - string.[[Prototype]]をprotoに設定する。
- string.[[StringData]]をvalueに設定する。
- string.[[GetOwnProperty]]を
10.4.3.1 で指定されるように設定する。 - string.[[DefineOwnProperty]]を
10.4.3.2 で指定されるように設定する。 - string.[[OwnPropertyKeys]]を
10.4.3.3 で指定されるように設定する。 - lengthをvalueのlengthとする。
- !
DefinePropertyOrThrow (string,"length" , PropertyDescriptor { [[Value]]:𝔽 (length), [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:false })を実行する。 - stringを返す。
10.4.3.5 StringGetOwnProperty ( string, propertyKey )
The abstract operation StringGetOwnProperty takes arguments string (an Object that has a [[StringData]] internal slot) and propertyKey (a
- propertyKeyがStringでないなら、
undefined を返す。 - numericIndexを
CanonicalNumericIndexString (propertyKey)とする。 - numericIndexが
integral Number でないなら、undefined を返す。 - numericIndexが
-0 𝔽またはnumericIndex <-0 𝔽なら、undefined を返す。 - stringDataをstring.[[StringData]]とする。
Assert : stringDataはStringである。- lengthをstringDataのlengthとする。
ℝ (numericIndex) ≥ lengthなら、undefined を返す。- resultStringを
ℝ (numericIndex)からℝ (numericIndex) + 1までのstringDataのsubstring とする。 - PropertyDescriptor { [[Value]]: resultString, [[Writable]]:
false , [[Enumerable]]:true , [[Configurable]]:false }を返す。
10.4.4 Arguments Exotic Objects
ほとんどのECMAScript functionsは、そのコードからarguments objectを利用可能にします。function definitionの特性に応じて、そのarguments objectは
objectは、そのinternal methodsが次の実装を使用し、ここで指定されていないものは
Object.prototype.toString（
numeric name valuesが対応する
ParameterMap objectおよびそのproperty valuesは、arguments objectとargument bindingsとの対応を指定するための装置として使用されます。ParameterMap objectおよびそのpropertiesの値であるobjectsは、ECMAScriptコードから直接観測可能ではありません。ECMAScript実装は、指定されたsemanticsを実装するために、そのようなobjectsを実際に作成または使用する必要はありません。
Ordinary arguments objectsは、アクセス時に
10.4.4.1 [[GetOwnProperty]] ( propertyKey )
The [[GetOwnProperty]] internal method of
- propertyDescを
OrdinaryGetOwnProperty (args, propertyKey)とする。 - propertyDescが
undefined なら、undefined を返す。 - mapをargs.[[ParameterMap]]とする。
- isMappedを !
HasOwnProperty (map, propertyKey) とする。 - isMappedが
true なら、- propertyDesc.[[Value]]を !
Get (map, propertyKey) に設定する。
- propertyDesc.[[Value]]を !
- propertyDescを返す。
10.4.4.2 [[DefineOwnProperty]] ( propertyKey, propertyDesc )
The [[DefineOwnProperty]] internal method of
- mapをargs.[[ParameterMap]]とする。
- isMappedを !
HasOwnProperty (map, propertyKey) とする。 - newArgDescをpropertyDescとする。
- isMappedが
true であり、かつIsDataDescriptor (propertyDesc)がtrue なら、- propertyDescが[[Value]] fieldを持たず、propertyDescが[[Writable]] fieldを持ち、かつpropertyDesc.[[Writable]]が
false なら、- newArgDescをpropertyDescのcopyに設定する。
- newArgDesc.[[Value]]を !
Get (map, propertyKey) に設定する。
- propertyDescが[[Value]] fieldを持たず、propertyDescが[[Writable]] fieldを持ち、かつpropertyDesc.[[Writable]]が
- allowedを !
OrdinaryDefineOwnProperty (args, propertyKey, newArgDesc) とする。 - allowedが
false なら、false を返す。 - isMappedが
true なら、IsAccessorDescriptor (propertyDesc)がtrue なら、- ! map.[[Delete]](propertyKey)を実行する。
- そうでなければ、
true を返す。
10.4.4.3 [[Get]] ( propertyKey, receiver )
The [[Get]] internal method of
- mapをargs.[[ParameterMap]]とする。
- isMappedを !
HasOwnProperty (map, propertyKey) とする。 - isMappedが
false なら、?OrdinaryGet (args, propertyKey, receiver)を返す。 Assert : mapはpropertyKeyに対するformal parameter mappingを含む。- !
Get (map, propertyKey)を返す。
10.4.4.4 [[Set]] ( propertyKey, value, receiver )
The [[Set]] internal method of
SameValue (args, receiver)がfalse なら、- isMappedを
false とする。
- isMappedを
- そうでなければ、
- mapをargs.[[ParameterMap]]とする。
- isMappedを !
HasOwnProperty (map, propertyKey) とする。
- isMappedが
true なら、 - ?
OrdinarySet (args, propertyKey, value, receiver)を返す。
10.4.4.5 [[Delete]] ( propertyKey )
The [[Delete]] internal method of
- mapをargs.[[ParameterMap]]とする。
- isMappedを !
HasOwnProperty (map, propertyKey) とする。 - resultを ?
OrdinaryDelete (args, propertyKey) とする。 - resultが
true かつisMappedがtrue なら、- ! map.[[Delete]](propertyKey)を実行する。
- resultを返す。
10.4.4.6 CreateUnmappedArgumentsObject ( argList )
The abstract operation CreateUnmappedArgumentsObject takes argument argList (a
- lengthをargList内の要素数とする。
- objを
OrdinaryObjectCreate (%Object.prototype% , « [[ParameterMap]] »)とする。 - obj.[[ParameterMap]]を
undefined に設定する。 - !
DefinePropertyOrThrow (obj,"length" , PropertyDescriptor { [[Value]]:𝔽 (length), [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true })を実行する。 - indexを0とする。
- index < lengthである間、繰り返す
- valueをargList[index]とする。
- !
CreateDataPropertyOrThrow (obj, !ToString (𝔽 (index)), value)を実行する。 - indexをindex + 1に設定する。
- !
DefinePropertyOrThrow (obj,%Symbol.iterator% , PropertyDescriptor { [[Value]]: %Array.prototype.values%, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true })を実行する。 - !
DefinePropertyOrThrow (obj,"callee" , PropertyDescriptor { [[Get]]:%ThrowTypeError% , [[Set]]:%ThrowTypeError% , [[Enumerable]]:false , [[Configurable]]:false })を実行する。 - objを返す。
10.4.4.7 CreateMappedArgumentsObject ( func, formals, argList, envRecord )
The abstract operation CreateMappedArgumentsObject takes arguments func (an ECMAScript
Assert : formalsはrest parameter、任意のbinding patterns、または任意のinitializersを含まない。duplicate identifiersを含む場合がある。- lengthをargList内の要素数とする。
- objを
MakeBasicObject (« [[Prototype]], [[Extensible]], [[ParameterMap]] »)とする。 - obj.[[GetOwnProperty]]を
10.4.4.1 で指定されるように設定する。 - obj.[[DefineOwnProperty]]を
10.4.4.2 で指定されるように設定する。 - obj.[[Get]]を
10.4.4.3 で指定されるように設定する。 - obj.[[Set]]を
10.4.4.4 で指定されるように設定する。 - obj.[[Delete]]を
10.4.4.5 で指定されるように設定する。 - obj.[[Prototype]]を
%Object.prototype% に設定する。 - mapを
OrdinaryObjectCreate (null )とする。 - obj.[[ParameterMap]]をmapに設定する。
- paramNamesをformalsの
BoundNames とする。 - paramCountをparamNames内の要素数とする。
- indexを0とする。
- index < lengthである間、繰り返す
- valueをargList[index]とする。
- !
CreateDataPropertyOrThrow (obj, !ToString (𝔽 (index)), value)を実行する。 - indexをindex + 1に設定する。
- !
DefinePropertyOrThrow (obj,"length" , PropertyDescriptor { [[Value]]:𝔽 (length), [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true })を実行する。 - mappedNamesを新しい空の
List とする。 - indexをparamCount - 1に設定する。
- index ≥ 0である間、繰り返す
- nameをparamNames[index]とする。
- mappedNamesがnameを含まないなら、
- nameをmappedNamesへappendする。
- index < lengthなら、
- getterを
MakeArgGetter (name, envRecord)とする。 - setterを
MakeArgSetter (name, envRecord)とする。 - ! map.[[DefineOwnProperty]](!
ToString (𝔽 (index)), PropertyDescriptor { [[Set]]: setter, [[Get]]: getter, [[Enumerable]]:false , [[Configurable]]:true })を実行する。
- getterを
- indexをindex - 1に設定する。
- !
DefinePropertyOrThrow (obj,%Symbol.iterator% , PropertyDescriptor { [[Value]]: %Array.prototype.values%, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true })を実行する。 - !
DefinePropertyOrThrow (obj,"callee" , PropertyDescriptor { [[Value]]: func, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true })を実行する。 - objを返す。
10.4.4.7.1 MakeArgGetter ( name, envRecord )
The abstract operation MakeArgGetter takes arguments name (a String) and envRecord (an
- getterClosureを、nameおよびenvRecordをcaptureし、呼び出されたときに次のstepsを実行する、parametersを持たない新しい
Abstract Closure とする：NormalCompletion (! envRecord.GetBindingValue (name,false ))を返す。
- getterを
CreateBuiltinFunction (getterClosure, 0,"" , « »)とする。 NOTE : getterはECMAScriptコードから直接アクセス可能になることは決してない。- getterを返す。
10.4.4.7.2 MakeArgSetter ( name, envRecord )
The abstract operation MakeArgSetter takes arguments name (a String) and envRecord (an
- setterClosureを、nameおよびenvRecordをcaptureし、呼び出されたときに次のstepsを実行するparameters (value)を持つ新しい
Abstract Closure とする：NormalCompletion (! envRecord.SetMutableBinding (name, value,false ))を返す。
- setterを
CreateBuiltinFunction (setterClosure, 1,"" , « »)とする。 NOTE : setterはECMAScriptコードから直接アクセス可能になることは決してない。- setterを返す。
10.4.5 TypedArray Exotic Objects
任意のNumber nについて
objectは、その[[PreventExtensions]]、[[GetOwnProperty]]、[[HasProperty]]、[[DefineOwnProperty]]、[[Get]]、[[Set]]、[[Delete]]、および[[OwnPropertyKeys]] internal methodsがこのsectionの定義を使用し、その他のessential internal methodsが
10.4.5.1 [[PreventExtensions]] ( )
The [[PreventExtensions]] internal method of
NOTE :6.1.7.3 で指定されるextensibility-related invariantsは、objがpropertiesを得る（または失ってから再び得る）可能性があるとき、このmethodがtrue を返すことを許可しない。これは、そのunderlying bufferがresizeされるとき、integer index namesを持つpropertiesについて発生する場合がある。IsTypedArrayFixedLength (obj)がfalse なら、false を返す。OrdinaryPreventExtensions (obj)を返す。
10.4.5.2 [[GetOwnProperty]] ( propertyKey )
The [[GetOwnProperty]] internal method of
- propertyKeyがStringなら、
- numericIndexを
CanonicalNumericIndexString (propertyKey)とする。 - numericIndexが
undefined でないなら、- valueを
TypedArrayGetElement (obj, numericIndex)とする。 - valueが
undefined なら、undefined を返す。 - PropertyDescriptor { [[Value]]: value, [[Writable]]:
true , [[Enumerable]]:true , [[Configurable]]:true }を返す。
- valueを
- numericIndexを
OrdinaryGetOwnProperty (obj, propertyKey)を返す。
10.4.5.3 [[HasProperty]] ( propertyKey )
The [[HasProperty]] internal method of
- propertyKeyがStringなら、
- numericIndexを
CanonicalNumericIndexString (propertyKey)とする。 - numericIndexが
undefined でないなら、IsValidIntegerIndex (obj, numericIndex)を返す。
- numericIndexを
- ?
OrdinaryHasProperty (obj, propertyKey)を返す。
10.4.5.4 [[DefineOwnProperty]] ( propertyKey, propertyDesc )
The [[DefineOwnProperty]] internal method of
- propertyKeyがStringなら、
- numericIndexを
CanonicalNumericIndexString (propertyKey)とする。 - numericIndexが
undefined でないなら、IsValidIntegerIndex (obj, numericIndex)がfalse なら、false を返す。- propertyDescが[[Configurable]] fieldを持ち、propertyDesc.[[Configurable]]が
false なら、false を返す。 - propertyDescが[[Enumerable]] fieldを持ち、propertyDesc.[[Enumerable]]が
false なら、false を返す。 IsAccessorDescriptor (propertyDesc)がtrue なら、false を返す。- propertyDescが[[Writable]] fieldを持ち、propertyDesc.[[Writable]]が
false なら、false を返す。 - propertyDescが[[Value]] fieldを持つなら、?
TypedArraySetElement (obj, numericIndex, propertyDesc.[[Value]])を実行する。 true を返す。
- numericIndexを
- !
OrdinaryDefineOwnProperty (obj, propertyKey, propertyDesc)を返す。
10.4.5.5 [[Get]] ( propertyKey, receiver )
The [[Get]] internal method of
- propertyKeyがStringなら、
- numericIndexを
CanonicalNumericIndexString (propertyKey)とする。 - numericIndexが
undefined でないなら、TypedArrayGetElement (obj, numericIndex)を返す。
- numericIndexを
- ?
OrdinaryGet (obj, propertyKey, receiver)を返す。
10.4.5.6 [[Set]] ( propertyKey, value, receiver )
The [[Set]] internal method of
- propertyKeyがStringなら、
- numericIndexを
CanonicalNumericIndexString (propertyKey)とする。 - numericIndexが
undefined でないなら、SameValue (obj, receiver)がtrue なら、- ?
TypedArraySetElement (obj, numericIndex, value)を実行する。 true を返す。
- ?
IsValidIntegerIndex (obj, numericIndex)がfalse なら、true を返す。
- numericIndexを
- ?
OrdinarySet (obj, propertyKey, value, receiver)を返す。
10.4.5.7 [[Delete]] ( propertyKey )
The [[Delete]] internal method of
- propertyKeyがStringなら、
- numericIndexを
CanonicalNumericIndexString (propertyKey)とする。 - numericIndexが
undefined でないなら、IsValidIntegerIndex (obj, numericIndex)がfalse なら、true を返す。false を返す。
- numericIndexを
- !
OrdinaryDelete (obj, propertyKey)を返す。
10.4.5.8 [[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of
- taRecordを
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst )とする。 - keysを新しい空の
List とする。 IsTypedArrayOutOfBounds (taRecord)がfalse なら、- lengthを
TypedArrayLength (taRecord)とする。 - 0 ≤ i < lengthである各
integer iについて、昇順で、以下を行う
- lengthを
- Stringであり、
integer index でないようなobjの各ownproperty key propertyKeyについて、property creationのascending chronological orderで、以下を行う- propertyKeyをkeysへappendする。
- Symbolであるようなobjの各own
property key propertyKeyについて、property creationのascending chronological orderで、以下を行う- propertyKeyをkeysへappendする。
- keysを返す。
10.4.5.9 TypedArray With Buffer Witness Records
TypedArray With Buffer Witness Recordは、
TypedArray With Buffer Witness Recordsは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Object]] |
|
そのbufferのbyte lengthがloadされる |
| [[CachedBufferByteLength]] |
非負整数または |
|
10.4.5.10 MakeTypedArrayWithBufferWitnessRecord ( obj, order )
The abstract operation MakeTypedArrayWithBufferWitnessRecord takes arguments obj (a
- bufferをobj.[[ViewedArrayBuffer]]とする。
IsDetachedBuffer (buffer)がtrue なら、- byteLengthを
detached とする。
- byteLengthを
- そうでなければ、
- byteLengthを
ArrayBufferByteLength (buffer, order)とする。
- byteLengthを
TypedArray With Buffer Witness Record { [[Object]]: obj, [[CachedBufferByteLength]]: byteLength }を返す。
10.4.5.11 TypedArrayCreate ( proto )
The abstract operation TypedArrayCreate takes argument proto (an Object) and returns a
- internalSlotsListを« [[Prototype]], [[Extensible]], [[ViewedArrayBuffer]], [[TypedArrayName]], [[ContentType]], [[ByteLength]], [[ByteOffset]], [[ArrayLength]] »とする。
- taを
MakeBasicObject (internalSlotsList)とする。 - ta.[[PreventExtensions]]を
10.4.5.1 で指定されるように設定する。 - ta.[[GetOwnProperty]]を
10.4.5.2 で指定されるように設定する。 - ta.[[HasProperty]]を
10.4.5.3 で指定されるように設定する。 - ta.[[DefineOwnProperty]]を
10.4.5.4 で指定されるように設定する。 - ta.[[Get]]を
10.4.5.5 で指定されるように設定する。 - ta.[[Set]]を
10.4.5.6 で指定されるように設定する。 - ta.[[Delete]]を
10.4.5.7 で指定されるように設定する。 - ta.[[OwnPropertyKeys]]を
10.4.5.8 で指定されるように設定する。 - ta.[[Prototype]]をprotoに設定する。
- taを返す。
10.4.5.12 TypedArrayByteLength ( taRecord )
The abstract operation TypedArrayByteLength takes argument taRecord (a
Assert :IsTypedArrayOutOfBounds (taRecord)はfalse である。- objをtaRecord.[[Object]]とする。
- obj.[[ByteLength]]が
auto でないなら、obj.[[ByteLength]]を返す。 - lengthを
TypedArrayLength (taRecord)とする。 - elementSizeを
TypedArrayElementSize (obj)とする。 NOTE : underlying bufferが非整数倍にresizeされている場合でも、返されるbyte lengthは常にelementSizeの整数倍である。- length × elementSizeを返す。
10.4.5.13 TypedArrayLength ( taRecord )
The abstract operation TypedArrayLength takes argument taRecord (a
Assert :IsTypedArrayOutOfBounds (taRecord)はfalse である。- objをtaRecord.[[Object]]とする。
- obj.[[ArrayLength]]が
auto でないなら、obj.[[ArrayLength]]を返す。 Assert :IsFixedLengthArrayBuffer (obj.[[ViewedArrayBuffer]])はfalse である。- byteOffsetをobj.[[ByteOffset]]とする。
- elementSizeを
TypedArrayElementSize (obj)とする。 - byteLengthをtaRecord.[[CachedBufferByteLength]]とする。
Assert : byteLengthはdetached でない。floor ((byteLength - byteOffset) / elementSize)を返す。
10.4.5.14 IsTypedArrayOutOfBounds ( taRecord )
The abstract operation IsTypedArrayOutOfBounds takes argument taRecord (a
- objをtaRecord.[[Object]]とする。
- bufferByteLengthをtaRecord.[[CachedBufferByteLength]]とする。
IsDetachedBuffer (obj.[[ViewedArrayBuffer]])がtrue なら、Assert : bufferByteLengthはdetached である。true を返す。
Assert : bufferByteLengthは非負整数である。- byteOffsetStartをobj.[[ByteOffset]]とする。
- obj.[[ArrayLength]]が
auto なら、- byteOffsetEndをbufferByteLengthとする。
- そうでなければ、
- elementSizeを
TypedArrayElementSize (obj)とする。 - arrayByteLengthをobj.[[ArrayLength]] × elementSizeとする。
- byteOffsetEndをbyteOffsetStart + arrayByteLengthとする。
- elementSizeを
NOTE : [[ByteOffset]]がbufferByteLengthである0-lengthTypedArray はout-of-boundsとはみなされない。- byteOffsetStart > bufferByteLengthまたはbyteOffsetEnd > bufferByteLengthなら、
true を返す。 false を返す。
10.4.5.15 IsTypedArrayFixedLength ( obj )
The abstract operation IsTypedArrayFixedLength takes argument obj (a
- obj.[[ArrayLength]]が
auto なら、false を返す。 - bufferをobj.[[ViewedArrayBuffer]]とする。
IsFixedLengthArrayBuffer (buffer)がfalse かつIsSharedArrayBuffer (buffer)がfalse なら、false を返す。true を返す。
10.4.5.16 IsValidIntegerIndex ( obj, index )
The abstract operation IsValidIntegerIndex takes arguments obj (a
IsDetachedBuffer (obj.[[ViewedArrayBuffer]])がtrue なら、false を返す。- indexが
integral Number でないなら、false を返す。 - indexが
-0 𝔽またはindex <-0 𝔽なら、false を返す。 - taRecordを
MakeTypedArrayWithBufferWitnessRecord (obj,unordered )とする。 NOTE : objのbacking bufferがgrowable SharedArrayBuffer である場合、Bounds checkingはsynchronizing operationではない。IsTypedArrayOutOfBounds (taRecord)がtrue なら、false を返す。- lengthを
TypedArrayLength (taRecord)とする。 ℝ (index) ≥ lengthなら、false を返す。true を返す。
10.4.5.17 TypedArrayGetElement ( obj, index )
The abstract operation TypedArrayGetElement takes arguments obj (a
IsValidIntegerIndex (obj, index)がfalse なら、undefined を返す。- offsetをobj.[[ByteOffset]]とする。
- elementSizeを
TypedArrayElementSize (obj)とする。 - byteIndexInBufferを(
ℝ (index) × elementSize) + offsetとする。 - elementTypeを
TypedArrayElementType (obj)とする。 GetValueFromBuffer (obj.[[ViewedArrayBuffer]], byteIndexInBuffer, elementType,true ,unordered )を返す。
10.4.5.18 TypedArraySetElement ( obj, index, value )
The abstract operation TypedArraySetElement takes arguments obj (a
- obj.[[ContentType]]が
bigint なら、numberを ?ToBigInt (value) とする。 - そうでなければ、numberを ?
ToNumber (value) とする。 IsValidIntegerIndex (obj, index)がtrue なら、- offsetをobj.[[ByteOffset]]とする。
- elementSizeを
TypedArrayElementSize (obj)とする。 - byteIndexInBufferを(
ℝ (index) × elementSize) + offsetとする。 - elementTypeを
TypedArrayElementType (obj)とする。 SetValueInBuffer (obj.[[ViewedArrayBuffer]], byteIndexInBuffer, elementType, number,true ,unordered )を実行する。
unused を返す。
このoperationは常に成功するように見えますが、
10.4.5.19 IsArrayBufferViewOutOfBounds ( obj )
The abstract operation IsArrayBufferViewOutOfBounds takes argument obj (a
- objが[[DataView]] internal slotを持つなら、
- viewRecordを
MakeDataViewWithBufferWitnessRecord (obj,seq-cst )とする。 IsViewOutOfBounds (viewRecord)を返す。
- viewRecordを
- taRecordを
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst )とする。 IsTypedArrayOutOfBounds (taRecord)を返す。
10.4.6 Module Namespace Exotic Objects
export * export itemsを使用してindirectlyにexportされた任意のbindingsが含まれます。各String-valued own
objectは、その[[GetPrototypeOf]]、[[SetPrototypeOf]]、[[IsExtensible]]、[[PreventExtensions]]、[[GetOwnProperty]]、[[DefineOwnProperty]]、[[HasProperty]]、[[Get]]、[[Set]]、[[Delete]]、および[[OwnPropertyKeys]] internal methodsがこのsectionの定義を使用し、その他のessential internal methodsが
| Internal Slot | 型 | 説明 |
|---|---|---|
| [[Module]] |
|
このnamespaceが公開するexportsを持つ |
| [[Exports]] |
Stringsの |
要素が、このobjectのown propertiesとして公開されるexported namesのString値である |
10.4.6.1 [[GetPrototypeOf]] ( )
The [[GetPrototypeOf]] internal method of
null を返す。
10.4.6.2 [[SetPrototypeOf]] ( proto )
The [[SetPrototypeOf]] internal method of
- !
SetImmutablePrototype (obj, proto)を返す。
10.4.6.3 [[IsExtensible]] ( )
The [[IsExtensible]] internal method of
false を返す。
10.4.6.4 [[PreventExtensions]] ( )
The [[PreventExtensions]] internal method of
true を返す。
10.4.6.5 [[GetOwnProperty]] ( propertyKey )
The [[GetOwnProperty]] internal method of
- propertyKeyがSymbolなら、
OrdinaryGetOwnProperty (obj, propertyKey)を返す。 - exportsをobj.[[Exports]]とする。
- exportsがpropertyKeyを含まないなら、
undefined を返す。 - valueを ? obj.[[Get]](propertyKey, obj) とする。
- PropertyDescriptor { [[Value]]: value, [[Writable]]:
true , [[Enumerable]]:true , [[Configurable]]:false }を返す。
10.4.6.6 [[DefineOwnProperty]] ( propertyKey, propertyDesc )
The [[DefineOwnProperty]] internal method of
- propertyKeyがSymbolなら、!
OrdinaryDefineOwnProperty (obj, propertyKey, propertyDesc)を返す。 - currentを ? obj.[[GetOwnProperty]](propertyKey) とする。
- currentが
undefined なら、false を返す。 - propertyDescが[[Configurable]] fieldを持ち、propertyDesc.[[Configurable]]が
true なら、false を返す。 - propertyDescが[[Enumerable]] fieldを持ち、propertyDesc.[[Enumerable]]が
false なら、false を返す。 IsAccessorDescriptor (propertyDesc)がtrue なら、false を返す。- propertyDescが[[Writable]] fieldを持ち、propertyDesc.[[Writable]]が
false なら、false を返す。 - propertyDescが[[Value]] fieldを持つなら、
SameValue (propertyDesc.[[Value]], current.[[Value]])を返す。 true を返す。
10.4.6.7 [[HasProperty]] ( propertyKey )
The [[HasProperty]] internal method of
- propertyKeyがSymbolなら、!
OrdinaryHasProperty (obj, propertyKey)を返す。 - exportsをobj.[[Exports]]とする。
- exportsがpropertyKeyを含むなら、
true を返す。 false を返す。
10.4.6.8 [[Get]] ( propertyKey, receiver )
The [[Get]] internal method of
- propertyKeyがSymbolなら、
- !
OrdinaryGet (obj, propertyKey, receiver)を返す。
- !
- exportsをobj.[[Exports]]とする。
- exportsがpropertyKeyを含まないなら、
undefined を返す。 - moduleをobj.[[Module]]とする。
- bindingをmodule.
ResolveExport (propertyKey)とする。 Assert : bindingはResolvedBinding Record である。- targetModuleをbinding.[[Module]]とする。
Assert : targetModuleはundefined でない。- binding.[[BindingName]]が
namespace なら、GetModuleNamespace (targetModule)を返す。
- targetEnvをtargetModule.[[Environment]]とする。
- targetEnvが
empty なら、ReferenceError 例外をthrowする。 - ? targetEnv.
GetBindingValue (binding.[[BindingName]],true )を返す。
10.4.6.9 [[Set]] ( propertyKey, value, receiver )
The [[Set]] internal method of
false を返す。
10.4.6.10 [[Delete]] ( propertyKey )
The [[Delete]] internal method of
- propertyKeyがSymbolなら、
- !
OrdinaryDelete (obj, propertyKey)を返す。
- !
- exportsをobj.[[Exports]]とする。
- exportsがpropertyKeyを含むなら、
false を返す。 true を返す。
10.4.6.11 [[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of
- exportsをobj.[[Exports]]とする。
- symbolKeysを
OrdinaryOwnPropertyKeys (obj)とする。 - exportsとsymbolKeysの
list-concatenation を返す。
10.4.6.12 ModuleNamespaceCreate ( module, exports )
The abstract operation ModuleNamespaceCreate takes arguments module (a
Assert : module.[[Namespace]]はempty である。- internalSlotsListを
Table 29 に列挙されるinternal slotsとする。 - namespaceを
MakeBasicObject (internalSlotsList)とする。 - namespaceのessential internal methodsを
10.4.6 で指定される定義に設定する。 - namespace.[[Module]]をmoduleに設定する。
- sortedExportsを、exportsの要素を
lexicographic code unit order に従ってsortした要素を持つList とする。 - namespace.[[Exports]]をsortedExportsに設定する。
28.3 の定義に対応するnamespaceのown propertiesを作成する。- module.[[Namespace]]をnamespaceに設定する。
- namespaceを返す。
10.4.7 Immutable Prototype Exotic Objects
objectは、その[[SetPrototypeOf]] internal methodが次の実装を使用する場合、immutable prototype exotic objectです。（その他のessential internal methodsは、対象となる具体的な
他の
10.4.7.1 [[SetPrototypeOf]] ( proto )
The [[SetPrototypeOf]] internal method of
- ?
SetImmutablePrototype (obj, proto)を返す。
10.4.7.2 SetImmutablePrototype ( obj, proto )
The abstract operation SetImmutablePrototype takes arguments obj (an Object) and proto (an Object or
- currentを ? obj.[[GetPrototypeOf]]() とする。
SameValue (proto, current)がtrue なら、true を返す。false を返す。
10.5 Proxy Object Internal Methods and Internal Slots
Proxy objectは、そのessential internal methodsが部分的にECMAScriptコードを使用して実装される
objectは、そのessential internal methods（該当する場合は[[Call]]および[[Construct]]を含む）がこのsectionの定義を使用する場合、Proxy exotic objectです。これらのinternal methodsは
| Internal Method | Handler Method |
|---|---|
| [[GetPrototypeOf]] |
getPrototypeOf
|
| [[SetPrototypeOf]] |
setPrototypeOf
|
| [[IsExtensible]] |
isExtensible
|
| [[PreventExtensions]] |
preventExtensions
|
| [[GetOwnProperty]] |
getOwnPropertyDescriptor
|
| [[DefineOwnProperty]] |
defineProperty
|
| [[HasProperty]] |
has
|
| [[Get]] |
get
|
| [[Set]] |
set
|
| [[Delete]] |
deleteProperty
|
| [[OwnPropertyKeys]] |
ownKeys
|
| [[Call]] |
apply
|
| [[Construct]] |
construct
|
handler methodがProxy object internal methodの実装を提供するために呼び出されるとき、handler methodにはproxyのtarget objectがparameterとして渡されます。proxyのhandler objectは、すべてのessential internal methodに対応するmethodを必ずしも持つわけではありません。proxy上でinternal methodをinvokeすると、handler objectがinternal trapに対応するmethodを持たない場合、proxyのtarget object上で対応するinternal methodがinvokeされます。
Proxy objectの[[ProxyHandler]]および[[ProxyTarget]] internal slotsは、objectが作成されるときに常に初期化され、通常は変更できません。一部のProxy objectsは、後でrevokedできるような方法で作成されます。proxyがrevokedされると、その[[ProxyHandler]]および[[ProxyTarget]] internal slotsは
Proxy objectsはinternal methodsの実装を任意のECMAScriptコードによって提供することを許可するため、handler methodsが
以下のalgorithm descriptionsでは、objはECMAScript Proxy object、propertyKeyは
10.5.1 [[GetPrototypeOf]] ( )
The [[GetPrototypeOf]] internal method of
- ?
ValidateNonRevokedProxy (obj)を実行する。 - targetをobj.[[ProxyTarget]]とする。
- handlerをobj.[[ProxyHandler]]とする。
Assert : handlerはObjectである。- trapを ?
GetMethod (handler,"getPrototypeOf" ) とする。 - trapが
undefined なら、- ? target.[[GetPrototypeOf]]()を返す。
- handlerProtoを ?
Call (trap, handler, « target ») とする。 - handlerProtoがObjectでなく、かつhandlerProtoが
null でないなら、TypeError 例外をthrowする。 - extensibleTargetを ?
IsExtensible (target) とする。 - extensibleTargetが
true なら、handlerProtoを返す。 - targetProtoを ? target.[[GetPrototypeOf]]() とする。
SameValue (handlerProto, targetProto)がfalse なら、TypeError 例外をthrowする。- handlerProtoを返す。
Proxy objectsに対する[[GetPrototypeOf]]は次のinvariantsを強制します：
-
[[GetPrototypeOf]]の結果はObjectまたは
null のいずれかでなければならない。 - target objectがextensibleでない場合、Proxy objectに適用された[[GetPrototypeOf]]は、Proxy objectのtarget objectに適用された[[GetPrototypeOf]]と同じ値を返さなければならない。
10.5.2 [[SetPrototypeOf]] ( proto )
The [[SetPrototypeOf]] internal method of
- ?
ValidateNonRevokedProxy (obj)を実行する。 - targetをobj.[[ProxyTarget]]とする。
- handlerをobj.[[ProxyHandler]]とする。
Assert : handlerはObjectである。- trapを ?
GetMethod (handler,"setPrototypeOf" ) とする。 - trapが
undefined なら、- ? target.[[SetPrototypeOf]](proto)を返す。
- boolTrapResultを
ToBoolean (?Call (trap, handler, « target, proto »))とする。 - boolTrapResultが
false なら、false を返す。 - extensibleTargetを ?
IsExtensible (target) とする。 - extensibleTargetが
true なら、true を返す。 - targetProtoを ? target.[[GetPrototypeOf]]() とする。
SameValue (proto, targetProto)がfalse なら、TypeError 例外をthrowする。true を返す。
Proxy objectsに対する[[SetPrototypeOf]]は次のinvariantsを強制します：
- [[SetPrototypeOf]]の結果はBoolean値である。
- target objectがextensibleでない場合、argument値はtarget objectに適用された[[GetPrototypeOf]]の結果と同じでなければならない。
10.5.3 [[IsExtensible]] ( )
The [[IsExtensible]] internal method of
- ?
ValidateNonRevokedProxy (obj)を実行する。 - targetをobj.[[ProxyTarget]]とする。
- handlerをobj.[[ProxyHandler]]とする。
Assert : handlerはObjectである。- trapを ?
GetMethod (handler,"isExtensible" ) とする。 - trapが
undefined なら、- ?
IsExtensible (target)を返す。
- ?
- boolTrapResultを
ToBoolean (?Call (trap, handler, « target »))とする。 - targetResultを ?
IsExtensible (target) とする。 - boolTrapResultがtargetResultでないなら、
TypeError 例外をthrowする。 - boolTrapResultを返す。
Proxy objectsに対する[[IsExtensible]]は次のinvariantsを強制します：
- [[IsExtensible]]の結果はBoolean値である。
- Proxy objectに適用された[[IsExtensible]]は、同じargumentを伴ってProxy objectのtarget objectに適用された[[IsExtensible]]と同じ値を返さなければならない。
10.5.4 [[PreventExtensions]] ( )
The [[PreventExtensions]] internal method of
- ?
ValidateNonRevokedProxy (obj)を実行する。 - targetをobj.[[ProxyTarget]]とする。
- handlerをobj.[[ProxyHandler]]とする。
Assert : handlerはObjectである。- trapを ?
GetMethod (handler,"preventExtensions" ) とする。 - trapが
undefined なら、- ? target.[[PreventExtensions]]()を返す。
- boolTrapResultを
ToBoolean (?Call (trap, handler, « target »))とする。 - boolTrapResultが
true なら、- extensibleTargetを ?
IsExtensible (target) とする。 - extensibleTargetが
true なら、TypeError 例外をthrowする。
- extensibleTargetを ?
- boolTrapResultを返す。
Proxy objectsに対する[[PreventExtensions]]は次のinvariantsを強制します：
- [[PreventExtensions]]の結果はBoolean値である。
-
Proxy objectに適用された[[PreventExtensions]]は、Proxy objectのtarget objectに適用された[[IsExtensible]]が
false である場合にのみtrue を返す。
10.5.5 [[GetOwnProperty]] ( propertyKey )
The [[GetOwnProperty]] internal method of
- ?
ValidateNonRevokedProxy (obj)を実行する。 - targetをobj.[[ProxyTarget]]とする。
- handlerをobj.[[ProxyHandler]]とする。
Assert : handlerはObjectである。- trapを ?
GetMethod (handler,"getOwnPropertyDescriptor" ) とする。 - trapが
undefined なら、- ? target.[[GetOwnProperty]](propertyKey)を返す。
- trapResultObjを ?
Call (trap, handler, « target, propertyKey ») とする。 - trapResultObjがObjectでなく、かつtrapResultObjが
undefined でないなら、TypeError 例外をthrowする。 - targetDescを ? target.[[GetOwnProperty]](propertyKey) とする。
- trapResultObjが
undefined なら、- targetDescが
undefined なら、undefined を返す。 - targetDesc.[[Configurable]]が
false なら、TypeError 例外をthrowする。 - extensibleTargetを ?
IsExtensible (target) とする。 - extensibleTargetが
false なら、TypeError 例外をthrowする。 undefined を返す。
- targetDescが
- extensibleTargetを ?
IsExtensible (target) とする。 - resultDescを ?
ToPropertyDescriptor (trapResultObj) とする。 CompletePropertyDescriptor (resultDesc)を実行する。- validを
IsCompatiblePropertyDescriptor (extensibleTarget, resultDesc, targetDesc)とする。 - validが
false なら、TypeError 例外をthrowする。 - resultDesc.[[Configurable]]が
false なら、- targetDescが
undefined またはtargetDesc.[[Configurable]]がtrue なら、TypeError 例外をthrowする。
- resultDescが[[Writable]] fieldを持ち、resultDesc.[[Writable]]が
false なら、Assert : targetDescは[[Writable]] fieldを持つ。- targetDesc.[[Writable]]が
true なら、TypeError 例外をthrowする。
- targetDescが
- resultDescを返す。
Proxy objectsに対する[[GetOwnProperty]]は次のinvariantsを強制します：
-
[[GetOwnProperty]]の結果は
Property Descriptor またはundefined のいずれかでなければならない。 - propertyがtarget objectのnon-configurable own propertyとして存在する場合、そのpropertyをnon-existentとして報告することはできない。
- propertyがnon-extensible target objectのown propertyとして存在する場合、そのpropertyをnon-existentとして報告することはできない。
- propertyがtarget objectのown propertyとして存在せず、かつtarget objectがextensibleでない場合、そのpropertyをexistentとして報告することはできない。
- propertyがtarget objectのnon-configurable own propertyとして存在しない限り、そのpropertyをnon-configurableとして報告することはできない。
- propertyがtarget objectのnon-configurable, non-writable own propertyとして存在しない限り、そのpropertyをnon-configurableかつnon-writableとして報告することはできない。
10.5.6 [[DefineOwnProperty]] ( propertyKey, propertyDesc )
The [[DefineOwnProperty]] internal method of
- ?
ValidateNonRevokedProxy (obj)を実行する。 - targetをobj.[[ProxyTarget]]とする。
- handlerをobj.[[ProxyHandler]]とする。
Assert : handlerはObjectである。- trapを ?
GetMethod (handler,"defineProperty" ) とする。 - trapが
undefined なら、- ? target.[[DefineOwnProperty]](propertyKey, propertyDesc)を返す。
- propertyDescObjを
FromPropertyDescriptor (propertyDesc)とする。 - boolTrapResultを
ToBoolean (?Call (trap, handler, « target, propertyKey, propertyDescObj »))とする。 - boolTrapResultが
false なら、false を返す。 - targetDescを ? target.[[GetOwnProperty]](propertyKey) とする。
- extensibleTargetを ?
IsExtensible (target) とする。 - propertyDescが[[Configurable]] fieldを持ち、propertyDesc.[[Configurable]]が
false なら、- settingConfigFalseを
true とする。
- settingConfigFalseを
- そうでなければ、
- settingConfigFalseを
false とする。
- settingConfigFalseを
- targetDescが
undefined なら、- extensibleTargetが
false なら、TypeError 例外をthrowする。 - settingConfigFalseが
true なら、TypeError 例外をthrowする。
- extensibleTargetが
- そうでなければ、
IsCompatiblePropertyDescriptor (extensibleTarget, propertyDesc, targetDesc)がfalse なら、TypeError 例外をthrowする。- settingConfigFalseが
true かつtargetDesc.[[Configurable]]がtrue なら、TypeError 例外をthrowする。 IsDataDescriptor (targetDesc)がtrue 、targetDesc.[[Configurable]]がfalse 、かつtargetDesc.[[Writable]]がtrue なら、- propertyDescが[[Writable]] fieldを持ち、propertyDesc.[[Writable]]が
false なら、TypeError 例外をthrowする。
- propertyDescが[[Writable]] fieldを持ち、propertyDesc.[[Writable]]が
true を返す。
Proxy objectsに対する[[DefineOwnProperty]]は次のinvariantsを強制します：
- [[DefineOwnProperty]]の結果はBoolean値である。
- target objectがextensibleでない場合、propertyを追加することはできない。
- target objectの対応するnon-configurable own propertyが存在しない限り、propertyはnon-configurableになれない。
- target objectの対応するnon-configurable, non-writable own propertyが存在しない限り、non-configurable propertyはnon-writableになれない。
-
propertyに対応するtarget object propertyが存在する場合、そのpropertyの
Property Descriptor を[[DefineOwnProperty]]を使用してtarget objectに適用しても例外はthrowされない。
10.5.7 [[HasProperty]] ( propertyKey )
The [[HasProperty]] internal method of
- ?
ValidateNonRevokedProxy (obj)を実行する。 - targetをobj.[[ProxyTarget]]とする。
- handlerをobj.[[ProxyHandler]]とする。
Assert : handlerはObjectである。- trapを ?
GetMethod (handler,"has" ) とする。 - trapが
undefined なら、- ? target.[[HasProperty]](propertyKey)を返す。
- boolTrapResultを
ToBoolean (?Call (trap, handler, « target, propertyKey »))とする。 - boolTrapResultが
false なら、- targetDescを ? target.[[GetOwnProperty]](propertyKey) とする。
- targetDescが
undefined でないなら、- targetDesc.[[Configurable]]が
false なら、TypeError 例外をthrowする。 - extensibleTargetを ?
IsExtensible (target) とする。 - extensibleTargetが
false なら、TypeError 例外をthrowする。
- targetDesc.[[Configurable]]が
- boolTrapResultを返す。
Proxy objectsに対する[[HasProperty]]は次のinvariantsを強制します：
- [[HasProperty]]の結果はBoolean値である。
- propertyがtarget objectのnon-configurable own propertyとして存在する場合、そのpropertyをnon-existentとして報告することはできない。
- propertyがtarget objectのown propertyとして存在し、かつtarget objectがextensibleでない場合、そのpropertyをnon-existentとして報告することはできない。
10.5.8 [[Get]] ( propertyKey, receiver )
The [[Get]] internal method of
- ?
ValidateNonRevokedProxy (obj)を実行する。 - targetをobj.[[ProxyTarget]]とする。
- handlerをobj.[[ProxyHandler]]とする。
Assert : handlerはObjectである。- trapを ?
GetMethod (handler,"get" ) とする。 - trapが
undefined なら、- ? target.[[Get]](propertyKey, receiver)を返す。
- trapResultを ?
Call (trap, handler, « target, propertyKey, receiver ») とする。 - targetDescを ? target.[[GetOwnProperty]](propertyKey) とする。
- targetDescが
undefined でなく、かつtargetDesc.[[Configurable]]がfalse なら、IsDataDescriptor (targetDesc)がtrue であり、かつtargetDesc.[[Writable]]がfalse なら、SameValue (trapResult, targetDesc.[[Value]])がfalse なら、TypeError 例外をthrowする。
IsAccessorDescriptor (targetDesc)がtrue であり、かつtargetDesc.[[Get]]がundefined なら、- trapResultが
undefined でないなら、TypeError 例外をthrowする。
- trapResultが
- trapResultを返す。
Proxy objectsに対する[[Get]]は次のinvariantsを強制します：
-
propertyについて報告される値は、target object propertyがnon-writable, non-configurable own
data property である場合、対応するtarget object propertyの値と同じでなければならない。 -
対応するtarget object propertyが[[Get]]属性として
undefined を持つnon-configurable ownaccessor property である場合、propertyについて報告される値はundefined でなければならない。
10.5.9 [[Set]] ( propertyKey, value, receiver )
The [[Set]] internal method of
- ?
ValidateNonRevokedProxy (obj)を実行する。 - targetをobj.[[ProxyTarget]]とする。
- handlerをobj.[[ProxyHandler]]とする。
Assert : handlerはObjectである。- trapを ?
GetMethod (handler,"set" ) とする。 - trapが
undefined なら、- ? target.[[Set]](propertyKey, value, receiver)を返す。
- boolTrapResultを
ToBoolean (?Call (trap, handler, « target, propertyKey, value, receiver »))とする。 - boolTrapResultが
false なら、false を返す。 - targetDescを ? target.[[GetOwnProperty]](propertyKey) とする。
- targetDescが
undefined でなく、かつtargetDesc.[[Configurable]]がfalse なら、IsDataDescriptor (targetDesc)がtrue であり、かつtargetDesc.[[Writable]]がfalse なら、SameValue (value, targetDesc.[[Value]])がfalse なら、TypeError 例外をthrowする。
IsAccessorDescriptor (targetDesc)がtrue なら、- targetDesc.[[Set]]が
undefined なら、TypeError 例外をthrowする。
- targetDesc.[[Set]]が
true を返す。
Proxy objectsに対する[[Set]]は次のinvariantsを強制します：
- [[Set]]の結果はBoolean値である。
-
対応するtarget object propertyがnon-writable, non-configurable own
data property である場合、propertyの値を、対応するtarget object propertyの値と異なるものに変更することはできない。 -
対応するtarget object propertyが[[Set]]属性として
undefined を持つnon-configurable ownaccessor property である場合、propertyの値を設定することはできない。
10.5.10 [[Delete]] ( propertyKey )
The [[Delete]] internal method of
- ?
ValidateNonRevokedProxy (obj)を実行する。 - targetをobj.[[ProxyTarget]]とする。
- handlerをobj.[[ProxyHandler]]とする。
Assert : handlerはObjectである。- trapを ?
GetMethod (handler,"deleteProperty" ) とする。 - trapが
undefined なら、- ? target.[[Delete]](propertyKey)を返す。
- boolTrapResultを
ToBoolean (?Call (trap, handler, « target, propertyKey »))とする。 - boolTrapResultが
false なら、false を返す。 - targetDescを ? target.[[GetOwnProperty]](propertyKey) とする。
- targetDescが
undefined なら、true を返す。 - targetDesc.[[Configurable]]が
false なら、TypeError 例外をthrowする。 - extensibleTargetを ?
IsExtensible (target) とする。 - extensibleTargetが
false なら、TypeError 例外をthrowする。 true を返す。
Proxy objectsに対する[[Delete]]は次のinvariantsを強制します：
- [[Delete]]の結果はBoolean値である。
- propertyがtarget objectのnon-configurable own propertyとして存在する場合、そのpropertyをdeletedとして報告することはできない。
- propertyがtarget objectのown propertyとして存在し、かつtarget objectがnon-extensibleである場合、そのpropertyをdeletedとして報告することはできない。
10.5.11 [[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of
- ?
ValidateNonRevokedProxy (obj)を実行する。 - targetをobj.[[ProxyTarget]]とする。
- handlerをobj.[[ProxyHandler]]とする。
Assert : handlerはObjectである。- trapを ?
GetMethod (handler,"ownKeys" ) とする。 - trapが
undefined なら、- ? target.[[OwnPropertyKeys]]()を返す。
- trapResultArrayを ?
Call (trap, handler, « target ») とする。 - trapResultを ?
CreateListFromArrayLike (trapResultArray,property-key ) とする。 - trapResultが重複entriesを含むなら、
TypeError 例外をthrowする。 - extensibleTargetを ?
IsExtensible (target) とする。 - targetKeysを ? target.[[OwnPropertyKeys]]() とする。
Assert : targetKeysはproperty keys のList である。Assert : targetKeysは重複entriesを含まない。- targetConfigurableKeysを新しい空の
List とする。 - targetNonconfigurableKeysを新しい空の
List とする。 - targetKeysの各要素keyについて、以下を行う
- propertyDescを ? target.[[GetOwnProperty]](key) とする。
- propertyDescが
undefined でなく、かつpropertyDesc.[[Configurable]]がfalse なら、- keyをtargetNonconfigurableKeysへappendする。
- そうでなければ、
- keyをtargetConfigurableKeysへappendする。
- extensibleTargetが
true であり、かつtargetNonconfigurableKeysが空なら、- trapResultを返す。
- uncheckedResultKeysを、要素がtrapResultの要素である
List とする。 - targetNonconfigurableKeysの各要素keyについて、以下を行う
- uncheckedResultKeysがkeyを含まないなら、
TypeError 例外をthrowする。 - keyをuncheckedResultKeysから削除する。
- uncheckedResultKeysがkeyを含まないなら、
- extensibleTargetが
true なら、trapResultを返す。 - targetConfigurableKeysの各要素keyについて、以下を行う
- uncheckedResultKeysがkeyを含まないなら、
TypeError 例外をthrowする。 - keyをuncheckedResultKeysから削除する。
- uncheckedResultKeysがkeyを含まないなら、
- uncheckedResultKeysが空でないなら、
TypeError 例外をthrowする。 - trapResultを返す。
Proxy objectsに対する[[OwnPropertyKeys]]は次のinvariantsを強制します：
10.5.12 [[Call]] ( thisArg, argList )
The [[Call]] internal method of
- ?
ValidateNonRevokedProxy (obj)を実行する。 - targetをobj.[[ProxyTarget]]とする。
- handlerをobj.[[ProxyHandler]]とする。
Assert : handlerはObjectである。- trapを ?
GetMethod (handler,"apply" ) とする。 - trapが
undefined なら、- ?
Call (target, thisArg, argList)を返す。
- ?
- argArrayを
CreateArrayFromList (argList)とする。 - ?
Call (trap, handler, « target, thisArg, argArray »)を返す。
10.5.13 [[Construct]] ( argList, newTarget )
The [[Construct]] internal method of
- ?
ValidateNonRevokedProxy (obj)を実行する。 - targetをobj.[[ProxyTarget]]とする。
Assert :IsConstructor (target)はtrue である。- handlerをobj.[[ProxyHandler]]とする。
Assert : handlerはObjectである。- trapを ?
GetMethod (handler,"construct" ) とする。 - trapが
undefined なら、- ?
Construct (target, argList, newTarget)を返す。
- ?
- argArrayを
CreateArrayFromList (argList)とする。 - newObjを ?
Call (trap, handler, « target, argArray, newTarget ») とする。 - newObjがObjectでないなら、
TypeError 例外をthrowする。 - newObjを返す。
Proxy objectsに対する[[Construct]]は次のinvariantsを強制します：
- [[Construct]]の結果はObjectでなければならない。
10.5.14 ValidateNonRevokedProxy ( proxy )
The abstract operation ValidateNonRevokedProxy takes argument proxy (a
- proxy.[[ProxyTarget]]が
null なら、TypeError 例外をthrowする。 Assert : proxy.[[ProxyHandler]]はnull でない。unused を返す。
10.5.15 ProxyCreate ( target, handler )
The abstract operation ProxyCreate takes arguments target (an ECMAScript language value) and handler (an ECMAScript language value) and returns either a
- targetがObjectでないなら、
TypeError 例外をthrowする。 - handlerがObjectでないなら、
TypeError 例外をthrowする。 - proxyを
MakeBasicObject (« [[ProxyHandler]], [[ProxyTarget]] »)とする。 - , [[Call]]および[[Construct]]を除き、proxyのessential internal methodsを
10.5 で指定される定義に設定する。 IsCallable (target)がtrue なら、- proxy.[[Call]]を
10.5.12 で指定されるように設定する。 IsConstructor (target)がtrue なら、- proxy.[[Construct]]を
10.5.13 で指定されるように設定する。
- proxy.[[Construct]]を
- proxy.[[Call]]を
- proxy.[[ProxyTarget]]をtargetに設定する。
- proxy.[[ProxyHandler]]をhandlerに設定する。
- proxyを返す。
11 ECMAScript Language: Source Text
11.1 Source Text
Syntax
ECMAScript source textはUnicode code pointsのsequenceです。surrogate code pointsを含むU+0000からU+10FFFFまでのすべてのUnicode code point valuesは、ECMAScript grammarsによって許可される場所でECMAScript source textに出現してよいです。ECMAScript source textを格納および交換するために使用される実際のencodingsは、この仕様には関係ありません。外部source text encodingにかかわらず、conforming ECMAScript implementationはsource textを、各
combining character sequenceのcomponentsは、ユーザーがsequence全体を単一のcharacterと考える場合でも、個々のUnicode code pointsとして扱われます。
string literals、regular expression literals、template literalsおよびidentifiersでは、任意のUnicode code pointは、code pointの数値を明示的に表すUnicode escape sequencesを使用して表すこともできます。comment内では、そのようなescape sequenceはcommentの一部として事実上無視されます。
ECMAScriptは、Unicode escape sequencesの振る舞いにおいてJava programming languageとは異なります。Javaプログラムでは、例えばUnicode escape sequence \u000Aがsingle-line comment内に出現した場合、それはline terminator（Unicode code point U+000AはLINE FEED (LF)）として解釈されるため、次のcode pointはcommentの一部ではありません。同様に、Unicode escape sequence \u000AがJavaプログラムのstring literal内に出現した場合、それも同様にline terminatorとして解釈されますが、これはstring literal内では許可されません—LINE FEED (LF)をstring literalの値の一部にするには、\u000Aではなく\nと書かなければなりません。ECMAScriptプログラムでは、comment内に出現するUnicode escape sequenceは決して解釈されず、したがってcommentの終了に寄与することはありません。同様に、ECMAScriptプログラムのstring literal内に出現するUnicode escape sequenceは常にliteralに寄与し、line terminatorとして、またはstring literalを終了させる可能性のあるcode pointとして解釈されることはありません。
11.1.1 Static Semantics: UTF16EncodeCodePoint ( codePoint )
The abstract operation UTF16EncodeCodePoint takes argument codePoint (a Unicode code point) and returns a String. It performs the following steps when called:
Assert : 0 ≤ codePoint ≤ 0x10FFFF.- codePoint ≤ 0xFFFFなら、数値がcodePointであるcode unitから成るString値を返す。
- cu1を、数値が
floor ((codePoint - 0x10000) / 0x400) + 0xD800であるcode unitとする。 - cu2を、数値が((codePoint - 0x10000)
modulo 0x400) + 0xDC00であるcode unitとする。 - cu1とcu2の
string-concatenation を返す。
11.1.2 Static Semantics: CodePointsToString ( text )
The abstract operation CodePointsToString takes argument text (a sequence of Unicode code points) and returns a String. これは、
- resultを空のStringとする。
- textの各code point codePointについて、以下を行う
- resultをresultと
UTF16EncodeCodePoint (codePoint)のstring-concatenation に設定する。
- resultをresultと
- resultを返す。
11.1.3 Static Semantics: UTF16SurrogatePairToCodePoint ( lead, trail )
The abstract operation UTF16SurrogatePairToCodePoint takes arguments lead (a code unit) and trail (a code unit) and returns a code point. UTF-16
Assert : leadはleading surrogate であり、trailはtrailing surrogate である。- codePointを(lead - 0xD800) × 0x400 + (trail - 0xDC00) + 0x10000とする。
- code point codePointを返す。
11.1.4 Static Semantics: CodePointAt ( string, position )
The abstract operation CodePointAt takes arguments string (a String) and position (a non-negative
- sizeをstringのlengthとする。
Assert : position ≥ 0 かつ position < size.- firstをstring内のindex positionにあるcode unitとする。
- codePointを、数値がfirstの数値であるcode pointとする。
- firstが
leading surrogate でもtrailing surrogate でもないなら、Record { [[CodePoint]]: codePoint, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]:false }を返す。
- firstが
trailing surrogate 、またはposition + 1 = sizeなら、Record { [[CodePoint]]: codePoint, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]:true }を返す。
- secondをstring内のindex position + 1にあるcode unitとする。
- secondが
trailing surrogate でないなら、Record { [[CodePoint]]: codePoint, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]:true }を返す。
- codePointを
UTF16SurrogatePairToCodePoint (first, second)に設定する。 Record { [[CodePoint]]: codePoint, [[CodeUnitCount]]: 2, [[IsUnpairedSurrogate]]:false }を返す。
11.1.5 Static Semantics: StringToCodePoints ( string )
The abstract operation StringToCodePoints takes argument string (a String) and returns a
- codePointsを新しい空の
List とする。 - sizeをstringのlengthとする。
- positionを0とする。
- position < sizeである間、繰り返す
- codePointを
CodePointAt (string, position)とする。 - codePoint.[[CodePoint]]をcodePointsへappendする。
- positionをposition + codePoint.[[CodeUnitCount]]に設定する。
- codePointを
- codePointsを返す。
11.1.6 Static Semantics: ParseText ( sourceText, goalSymbol )
The abstract operation ParseText takes arguments sourceText (a String or a sequence of Unicode code points) and goalSymbol (a nonterminal in one of the ECMAScript grammars) and returns a
- sourceTextがStringなら、sourceTextを
StringToCodePoints (sourceText)に設定する。 - goalSymbolを
goal symbol として使用してsourceTextのparseを試み、parse resultにearly error conditionsがないか分析する。Parsingとearly error detectionは、implementation-defined な方法でinterleavedされる場合があります。 - parseが成功し、
early errors が見つからなかったなら、parseの結果得られたparse treeのrootにあるParse Node （goalSymbolのinstance）を返す。 - parsing errorsおよび/または
early errors を表す1つ以上のSyntaxError objectsのList を返す。複数のparsing errorまたはearly error が存在する場合、list内のerror objectsの数および順序はimplementation-defined ですが、少なくとも1つは存在しなければなりません。
特定の位置に
clause
11.2 Types of Source Code
ECMAScript codeには4つのtypesがあります：
-
Global codeは、ECMAScript
Script として扱われるsource textです。特定のScript のglobal codeには、FunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 、AsyncArrowFunction 、ClassDeclaration 、またはClassExpression の一部としてparseされるsource textは含まれません。 -
Eval codeは、built-in
evalfunctionに供給されるsource textです。より正確には、built-inevalfunctionへのparameterがStringである場合、それはECMAScriptScript として扱われます。evalの特定のinvocationについてのeval codeは、そのScript のglobal code部分です。 -
Function codeは、ECMAScript
function object の[[ECMAScriptCode]]および[[FormalParameters]] internal slots（10.2 を参照）の値を供給するためにparseされるsource textです。特定のECMAScript functionのfunction codeには、nestedFunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 、AsyncArrowFunction 、ClassDeclaration 、またはClassExpression のfunction codeとしてparseされるsource textは含まれません。さらに、上で参照されたsource textが次のものとしてparseされる場合：
FunctionDeclaration またはFunctionExpression のFormalParameters およびFunctionBody 、GeneratorDeclaration またはGeneratorExpression のFormalParameters およびGeneratorBody 、AsyncFunctionDeclaration またはAsyncFunctionExpression のFormalParameters およびAsyncFunctionBody 、またはAsyncGeneratorDeclaration またはAsyncGeneratorExpression のFormalParameters およびAsyncGeneratorBody 、
その場合、そのdeclarationまたはexpressionの
BindingIdentifier （もしあれば）に一致するsource textも、対応するfunctionのfunction codeに含まれます。 -
Module codeは、
ModuleBody として提供されるcodeであるsource textです。これは、moduleがinitializedされるときに直接評価されるcodeです。特定のmoduleのmodule codeには、nestedFunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 、AsyncArrowFunction 、ClassDeclaration 、またはClassExpression の一部としてparseされるsource textは含まれません。
Function codeは一般に、Function Definitions（
11.2.1 Directive Prologues and the Use Strict Directive
Directive Prologueは、
Use Strict Directiveは、"use strict"または'use strict'のいずれかであるものです。
11.2.2 Strict Mode Code
ECMAScript syntactic unitは、unrestrictedまたはstrict mode syntax and semantics（
-
Global code は、Use Strict Directive を含むDirective Prologue で始まる場合、strict mode codeです。 -
Module code は常にstrict mode codeです。 -
ClassDeclaration またはClassExpression のすべてのpartsはstrict mode codeです。 -
Eval code は、Use Strict Directive を含むDirective Prologue で始まる場合、またはevalへのcallがstrict mode code内に含まれるdirect eval である場合、strict mode codeです。 -
Function code は、関連するFunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 、またはAsyncArrowFunction がstrict mode code内に含まれる場合、またはfunctionの[[ECMAScriptCode]] internal slotの値を生成するcodeがUse Strict Directive を含むDirective Prologue で始まる場合、strict mode codeです。 -
built-in Function、Generator、AsyncFunction、およびAsyncGenerator
constructors へのargumentsとして供給されるFunction code は、最後のargumentが、処理されたときにUse Strict Directive を含むDirective Prologue で始まるFunctionBody であるStringである場合、strict mode codeです。
strict mode codeではないECMAScript codeはnon-strict codeと呼ばれます。
11.2.2.1 Static Semantics: IsStrict ( parseNode )
The abstract operation IsStrict takes argument parseNode (a
- parseNodeに一致するsource textが
strict mode code なら、true を返す。 false を返す。
11.2.3 Non-ECMAScript Functions
ECMAScript implementationは、評価的振る舞いが
12 ECMAScript Language: Lexical Grammar
ECMAScript
lexical input elementsの識別が、そのinput elementsを消費しているsyntactic grammar contextに依存する状況がいくつかあります。このため、lexical grammarには複数の
複数のlexical goalsの使用により、automatic semicolon insertionに影響するlexical ambiguitiesが存在しないことが保証されます。例えば、leading divisionまたはdivision-assignmentと、leading
a = b
/hi/g.exec(c).map(d);a = b / hi / g.exec(c).map(d);Syntax
12.1 Unicode Format-Control Characters
Unicode format-control characters（すなわち、LEFT-TO-RIGHT MARKやRIGHT-TO-LEFT MARKなど、Unicode Character Databaseのcategory “Cf”にあるcharacters）は、これに対するより高レベルのprotocols（mark-up languagesなど）が存在しない場合に、textの範囲のformattingを制御するために使用されるcontrol codesです。
source text内でformat-control charactersを許可することは、editingおよびdisplayを容易にするために有用です。すべてのformat control charactersは、comments内、およびstring literals、template literals、regular expression literals内で使用できます。
U+FEFF (ZERO WIDTH NO-BREAK SPACE)は、主にtextの開始時に、それがUnicodeであることをmarkし、textのencodingおよびbyte orderの検出を可能にするために使用されるformat-control characterです。この目的のために意図された<ZWNBSP> charactersは、例えばfilesを連結した結果として、textの開始後に現れることもあります。
12.2 White Space
White space code pointsは、source textのreadabilityを向上させ、tokens（分割できないlexical units）を互いに分離するために使用されますが、それ以外では重要ではありません。White space code pointsは任意の2つのtokensの間、およびinputの開始または終了に出現できます。White space code pointsは、
ECMAScript white space code pointsは
| Code Points | Name | Abbreviation |
|---|---|---|
U+0009
|
CHARACTER TABULATION | <TAB> |
U+000B
|
LINE TABULATION | <VT> |
U+000C
|
FORM FEED (FF) | <FF> |
U+FEFF
|
ZERO WIDTH NO-BREAK SPACE | <ZWNBSP> |
| general category “Space_Separator”内の任意のcode point | <USP> |
U+0020 (SPACE)およびU+00A0 (NO-BREAK SPACE) code pointsは<USP>の一部です。
Syntax
12.3 Line Terminators
white space code pointsと同様に、line terminator code pointsはsource textのreadabilityを向上させ、tokens（分割できないlexical units）を互いに分離するために使用されます。しかし、white space code pointsとは異なり、line terminatorsはsyntactic grammarの振る舞いにある程度影響します。一般に、line terminatorsは任意の2つのtokensの間に出現できますが、syntactic grammarによって禁止される場所がいくつかあります。Line terminatorsはautomatic semicolon insertion（
line terminatorは
Line terminatorsは、regular expressions内の\s classによってmatchされるwhite space code pointsのsetに含まれます。
ECMAScript line terminator code pointsは
| Code Point | Unicode Name | Abbreviation |
|---|---|---|
U+000A
|
LINE FEED (LF) | <LF> |
U+000D
|
CARRIAGE RETURN (CR) | <CR> |
U+2028
|
LINE SEPARATOR | <LS> |
U+2029
|
PARAGRAPH SEPARATOR | <PS> |
Syntax
12.4 Comments
Commentsはsingle-lineまたはmulti-lineのいずれかです。Multi-line commentsはnestできません。
single-line commentは// markerから行末までのすべてのcode pointsで構成されます。ただし、行末の
Commentsはwhite spaceのように振る舞い破棄されますが、
Syntax
このsectionのいくつかのproductionsには、section
12.5 Hashbang Comments
Hashbang Commentsはlocation-sensitiveであり、他のtypes of commentsと同様に、syntactic grammarのinput elementsのstreamから破棄されます。
Syntax
12.6 Tokens
Syntax
12.7 Names and Keywords
この標準は特定のcode point additionsを指定します：U+0024 (DOLLAR SIGN)およびU+005F (LOW LINE)は
Syntax
nonterminal
nonterminal _をderiveします。
Unicode properties “ID_Start”および“ID_Continue”を持つcode pointsのsetsは、それぞれUnicode properties “Other_ID_Start”および“Other_ID_Continue”を持つcode pointsを含みます。
12.7.1 Identifier Names
Unicode escape sequencesは\はどのcode pointsにも寄与しません。\
Unicode Standardに従ってcanonically equivalentである2つの
12.7.1.1 Static Semantics: Early Errors
-
UnicodeEscapeSequence のIdentifierCodePoint がIdentifierStartChar lexical grammar productionによってmatchされる何らかのUnicode code pointでない場合、それはSyntax Errorです。
-
UnicodeEscapeSequence のIdentifierCodePoint がIdentifierPartChar lexical grammar productionによってmatchされる何らかのUnicode code pointでない場合、それはSyntax Errorです。
12.7.1.2 Static Semantics: IdentifierCodePoints
The
- codePointを
IdentifierStart のIdentifierCodePoint とする。 - « codePoint »を返す。
- codePoints をderived
IdentifierName のIdentifierCodePoints とする。 - codePointを
IdentifierPart のIdentifierCodePoint とする。 - codePoints と« codePoint »の
list-concatenation を返す。
12.7.1.3 Static Semantics: IdentifierCodePoint
The
IdentifierStartChar によってmatchされたcode pointを返す。
IdentifierPartChar によってmatchされたcode pointを返す。
- 数値が
Hex4Digits のMVであるcode pointを返す。
- 数値が
CodePoint のMVであるcode pointを返す。
12.7.2 Keywords and Reserved Words
keywordはfixed width fontでliteralに現れます。ECMAScriptのkeywordsには、if、while、async、await、その他多数が含まれます。
reserved wordはidentifierとして使用できないifおよびwhileはreserved wordsです。awaitはasync functionsおよびmodulesの内部でのみreservedです。asyncはreservedではありません；制限なくvariable nameまたはstatement labelとして使用できます。
この仕様は、grammatical productionsとawaitおよびyieldを除き、無条件にreservedです。awaitおよびyieldに対する例外は、parameterized syntactic productionsを使用して
-
Math、window、toString、および_など、常にidentifiersとして許可され、keywordsではないもの； -
下に列挙される
ReservedWord sのうち、awaitおよびyieldを除いた、identifiersとして決して許可されないもの； -
awaitおよびyieldという、contextuallyにidentifiersとして許可されるもの； -
strict mode code において、contextuallyにidentifiersとして許可されないもの：let、static、implements、interface、package、private、protected、およびpublic； -
常にidentifiersとして許可されるが、特定のsyntactic productions内で、
Identifier が許可されない場所にkeywordsとしても現れるもの：as、async、from、get、meta、of、set、およびtarget。
用語conditional keyword、またはcontextual keywordは、最後の3つのcategoriesに属し、したがってあるcontextsではidentifiersとして、別のcontextsではkeywordsとして使用できるkeywordsを指すために使われることがあります。
Syntax
\
\ els\u{65}と綴ることによって“else”という名前のvariableを宣言することはできません。
enumは現在、この仕様内でkeywordとして使用されていません。これは、将来のlanguage extensionsでkeywordとして使用するために取っておかれたfuture reserved wordです。
同様に、implements、interface、package、private、protected、およびpublicは
12.8 Punctuators
Syntax
12.9 Literals
12.9.1 Null Literals
Syntax
12.9.2 Boolean Literals
Syntax
12.9.3 Numeric Literals
Syntax
例えば：3inはerrorであり、2つのinput elements 3およびinではありません。
12.9.3.1 Static Semantics: Early Errors
IsStrict (this production)がtrue なら、それはSyntax Errorです。
12.9.3.2 Static Semantics: MV
numeric literalはNumber typeまたはBigInt typeの値を表します。
-
DecimalLiteral :: DecimalIntegerLiteral . DecimalDigits DecimalIntegerLiteral のMVに（DecimalDigits のMV × 10-n）を加えたものです。ここで、nはNumericLiteralSeparator のすべての出現を除いたDecimalDigits 内のcode pointsの数です。 -
DecimalLiteral :: DecimalIntegerLiteral . ExponentPart DecimalIntegerLiteral のMV × 10eです。ここで、eはExponentPart のMVです。 -
DecimalLiteral :: DecimalIntegerLiteral . DecimalDigits ExponentPart DecimalIntegerLiteral のMVに（DecimalDigits のMV × 10-n）を加えたもの）× 10eです。ここで、nはNumericLiteralSeparator のすべての出現を除いたDecimalDigits 内のcode pointsの数であり、eはExponentPart のMVです。 -
DecimalLiteral :: . DecimalDigits DecimalDigits のMV × 10-nです。ここで、nはNumericLiteralSeparator のすべての出現を除いたDecimalDigits 内のcode pointsの数です。 -
DecimalLiteral :: . DecimalDigits ExponentPart DecimalDigits のMV × 10e - nです。ここで、nはNumericLiteralSeparator のすべての出現を除いたDecimalDigits 内のcode pointsの数であり、eはExponentPart のMVです。 -
DecimalLiteral :: DecimalIntegerLiteral ExponentPart DecimalIntegerLiteral のMV × 10eです。ここで、eはExponentPart のMVです。 -
DecimalIntegerLiteral :: 0 -
DecimalIntegerLiteral :: NonZeroDigit NumericLiteralSeparator opt DecimalDigits NonZeroDigit のMV × 10n）にDecimalDigits のMVを加えたものです。ここで、nはNumericLiteralSeparator のすべての出現を除いたDecimalDigits 内のcode pointsの数です。 -
DecimalDigits :: DecimalDigits DecimalDigit DecimalDigits のMV × 10）にDecimalDigit のMVを加えたものです。 -
DecimalDigits :: DecimalDigits NumericLiteralSeparator DecimalDigit DecimalDigits のMV × 10）にDecimalDigit のMVを加えたものです。 -
ExponentPart :: ExponentIndicator SignedInteger SignedInteger のMVです。 -
SignedInteger :: - DecimalDigits DecimalDigits のMVのnegativeです。 -
DecimalDigit :: 0 HexDigit :: 0 OctalDigit :: 0 LegacyOctalEscapeSequence :: 0 BinaryDigit :: 0 -
DecimalDigit :: 1 NonZeroDigit :: 1 HexDigit :: 1 OctalDigit :: 1 BinaryDigit :: 1 -
DecimalDigit :: 2 NonZeroDigit :: 2 HexDigit :: 2 OctalDigit :: 2 -
DecimalDigit :: 3 NonZeroDigit :: 3 HexDigit :: 3 OctalDigit :: 3 -
DecimalDigit :: 4 NonZeroDigit :: 4 HexDigit :: 4 OctalDigit :: 4 -
DecimalDigit :: 5 NonZeroDigit :: 5 HexDigit :: 5 OctalDigit :: 5 -
DecimalDigit :: 6 NonZeroDigit :: 6 HexDigit :: 6 OctalDigit :: 6 -
DecimalDigit :: 7 NonZeroDigit :: 7 HexDigit :: 7 OctalDigit :: 7 -
DecimalDigit :: 8 NonZeroDigit :: 8 NonOctalDigit :: 8 HexDigit :: 8 -
DecimalDigit :: 9 NonZeroDigit :: 9 NonOctalDigit :: 9 HexDigit :: 9 -
HexDigit :: a HexDigit :: A -
HexDigit :: b HexDigit :: B -
HexDigit :: c HexDigit :: C -
HexDigit :: d HexDigit :: D -
HexDigit :: e HexDigit :: E -
HexDigit :: f HexDigit :: F -
BinaryDigits :: BinaryDigits BinaryDigit BinaryDigits のMV × 2）にBinaryDigit のMVを加えたものです。 -
BinaryDigits :: BinaryDigits NumericLiteralSeparator BinaryDigit BinaryDigits のMV × 2）にBinaryDigit のMVを加えたものです。 -
OctalDigits :: OctalDigits OctalDigit OctalDigits のMV × 8）にOctalDigit のMVを加えたものです。 -
OctalDigits :: OctalDigits NumericLiteralSeparator OctalDigit OctalDigits のMV × 8）にOctalDigit のMVを加えたものです。 -
LegacyOctalIntegerLiteral :: LegacyOctalIntegerLiteral OctalDigit LegacyOctalIntegerLiteral のMV times 8）にOctalDigit のMVを加えたものです。 -
NonOctalDecimalIntegerLiteral :: LegacyOctalLikeDecimalIntegerLiteral NonOctalDigit LegacyOctalLikeDecimalIntegerLiteral のMV times 10）にNonOctalDigit のMVを加えたものです。 -
NonOctalDecimalIntegerLiteral :: NonOctalDecimalIntegerLiteral DecimalDigit NonOctalDecimalIntegerLiteral のMV times 10）にDecimalDigit のMVを加えたものです。 -
LegacyOctalLikeDecimalIntegerLiteral :: LegacyOctalLikeDecimalIntegerLiteral OctalDigit LegacyOctalLikeDecimalIntegerLiteral のMV times 10）にOctalDigit のMVを加えたものです。 -
HexDigits :: HexDigits HexDigit HexDigits のMV × 16）にHexDigit のMVを加えたものです。 -
HexDigits :: HexDigits NumericLiteralSeparator HexDigit HexDigits のMV × 16）にHexDigit のMVを加えたものです。
12.9.3.3 Static Semantics: NumericValue
The
RoundMVResult (DecimalLiteral のMV)を返す。
𝔽 (NonDecimalIntegerLiteral のMV)を返す。
𝔽 (LegacyOctalIntegerLiteral のMV)を返す。
NonDecimalIntegerLiteral のMVに対するBigInt値を返す。
0 ℤを返す。
NonZeroDigit のMVに対するBigInt値を返す。
- nを、
NumericLiteralSeparator のすべての出現を除いたDecimalDigits 内のcode pointsの数とする。 - mvを（
NonZeroDigit のMV × 10n）にDecimalDigits のMVを加えたものとする。 ℤ (mv)を返す。
12.9.4 String Literals
string literalは、single quotesまたはdouble quotesで囲まれた0個以上のUnicode code pointsです。Unicode code pointsはescape sequenceによって表すこともできます。closing quote code points、U+005C (REVERSE SOLIDUS)、U+000D (CARRIAGE RETURN)、およびU+000A (LINE FEED)を除き、すべてのcode pointsはstring literal内にliteralに現れてよいです。任意のcode pointsはescape sequenceの形式で現れてよいです。String literalsはECMAScript String valuesにevaluateされます。これらのString valuesを生成するとき、Unicode code pointsは
Syntax
nonterminal
<LF>および<CR>は、空のcode points sequenceを生成するための\nまたは\u000Aなどのescape sequenceを使用することです。
12.9.4.1 Static Semantics: Early Errors
IsStrict (this production)がtrue なら、それはSyntax Errorです。
string literalsが、それを囲むcodeを
function invalid() { "\7"; "use strict"; }12.9.4.2 Static Semantics: SV
The
string literalはString typeの値を表します。SVは、string literalのさまざまなpartsへのrecursive applicationを通じて、string literalsに対するString valuesを生成します。このprocessの一部として、string literal内の一部のUnicode code pointsは、以下または
-
StringLiteral :: " " -
StringLiteral :: ' ' -
DoubleStringCharacters :: DoubleStringCharacter DoubleStringCharacters DoubleStringCharacter のSVとDoubleStringCharacters のSVのstring-concatenation です。 -
SingleStringCharacters :: SingleStringCharacter SingleStringCharacters SingleStringCharacter のSVとSingleStringCharacters のSVのstring-concatenation です。 -
DoubleStringCharacter :: SourceCharacter but not one of " or\ orLineTerminator SourceCharacter によってmatchされたcode pointに対してUTF16EncodeCodePoint を実行した結果です。 -
DoubleStringCharacter :: <LS> -
DoubleStringCharacter :: <PS> -
DoubleStringCharacter :: LineContinuation -
SingleStringCharacter :: SourceCharacter but not one of ' or\ orLineTerminator SourceCharacter によってmatchされたcode pointに対してUTF16EncodeCodePoint を実行した結果です。 -
SingleStringCharacter :: <LS> -
SingleStringCharacter :: <PS> -
SingleStringCharacter :: LineContinuation -
EscapeSequence :: 0 -
CharacterEscapeSequence :: SingleEscapeCharacter Table 33 に従ってSingleEscapeCharacter によって決定される数値を持つcode unitから成るString値です。
| Escape Sequence | Code Unit Value | Unicode Character Name | Symbol |
|---|---|---|---|
\b
|
0x0008
|
BACKSPACE | <BS> |
\t
|
0x0009
|
CHARACTER TABULATION | <HT> |
\n
|
0x000A
|
LINE FEED (LF) | <LF> |
\v
|
0x000B
|
LINE TABULATION | <VT> |
\f
|
0x000C
|
FORM FEED (FF) | <FF> |
\r
|
0x000D
|
CARRIAGE RETURN (CR) | <CR> |
\"
|
0x0022
|
QUOTATION MARK |
"
|
\'
|
0x0027
|
APOSTROPHE |
'
|
\\
|
0x005C
|
REVERSE SOLIDUS |
\
|
-
NonEscapeCharacter :: SourceCharacter but not one of EscapeCharacter orLineTerminator SourceCharacter によってmatchされたcode pointに対してUTF16EncodeCodePoint を実行した結果です。 -
EscapeSequence :: LegacyOctalEscapeSequence LegacyOctalEscapeSequence のMVであるcode unitから成るString値です。 -
NonOctalDecimalEscapeSequence :: 8 -
NonOctalDecimalEscapeSequence :: 9 -
HexEscapeSequence :: x HexDigit HexDigit HexEscapeSequence のMVであるcode unitから成るString値です。 -
Hex4Digits :: HexDigit HexDigit HexDigit HexDigit Hex4Digits のMVであるcode unitから成るString値です。 -
UnicodeEscapeSequence :: u{ CodePoint } CodePoint のMVに対してUTF16EncodeCodePoint を実行した結果です。 -
TemplateEscapeSequence :: 0
12.9.4.3 Static Semantics: MV
-
LegacyOctalEscapeSequence :: ZeroToThree OctalDigit ZeroToThree のMV）にOctalDigit のMVを加えたものです。 -
LegacyOctalEscapeSequence :: FourToSeven OctalDigit FourToSeven のMV）にOctalDigit のMVを加えたものです。 -
LegacyOctalEscapeSequence :: ZeroToThree OctalDigit OctalDigit ZeroToThree のMV）に（8 times 最初のOctalDigit のMV）を加え、さらに2番目のOctalDigit のMVを加えたものです。 -
ZeroToThree :: 0 -
ZeroToThree :: 1 -
ZeroToThree :: 2 -
ZeroToThree :: 3 -
FourToSeven :: 4 -
FourToSeven :: 5 -
FourToSeven :: 6 -
FourToSeven :: 7 -
HexEscapeSequence :: x HexDigit HexDigit HexDigit のMV）に2番目のHexDigit のMVを加えたものです。 -
Hex4Digits :: HexDigit HexDigit HexDigit HexDigit HexDigit のMV）に（0x100 × 2番目のHexDigit のMV）を加え、さらに（0x10 × 3番目のHexDigit のMV）を加え、さらに4番目のHexDigit のMVを加えたものです。
12.9.5 Regular Expression Literals
regular expression literalは、literalがevaluateされるたびにRegExp object（===としてcompareされることのないregular expression objectsへevaluateされます。RegExp objectは、runtimeにnew RegExpによって、またはRegExp
以下のproductionsはregular expression literalのsyntaxを記述し、input element scannerがregular expression literalの終端を見つけるために使用されます。
実装は
Syntax
Regular expression literalsは空であってはなりません；空のregular expression literalを表す代わりに、code unit sequence //はsingle-line commentを開始します。空のregular expressionを指定するには、/(?:)/を使用してください。
12.9.5.1 Static Semantics: BodyText
The
RegularExpressionBody として認識されたsource textを返す。
12.9.5.2 Static Semantics: FlagText
The
RegularExpressionFlags として認識されたsource textを返す。
12.9.6 Template Literal Lexical Components
Syntax
12.9.6.1 Static Semantics: TV
The
-
NoSubstitutionTemplate :: ` ` -
TemplateHead :: ` ${ -
TemplateMiddle :: } ${ -
TemplateTail :: } ` -
TemplateCharacters :: TemplateCharacter TemplateCharacters TemplateCharacter のTVがundefined である、またはTemplateCharacters のTVがundefined である場合、undefined です。そうでなければ、それはTemplateCharacter のTVとTemplateCharacters のTVのstring-concatenation です。 -
TemplateCharacter :: SourceCharacter but not one of ` or\ or$ orLineTerminator SourceCharacter によってmatchされたcode pointに対してUTF16EncodeCodePoint を実行した結果です。 -
TemplateCharacter :: $ -
TemplateCharacter :: \ TemplateEscapeSequence TemplateEscapeSequence のSV です。 -
TemplateCharacter :: \ NotEscapeSequence undefined です。 -
TemplateCharacter :: LineTerminatorSequence LineTerminatorSequence のTRV です。 -
LineContinuation :: \ LineTerminatorSequence
12.9.6.2 Static Semantics: TRV
The
-
NoSubstitutionTemplate :: ` ` -
TemplateHead :: ` ${ -
TemplateMiddle :: } ${ -
TemplateTail :: } ` -
TemplateCharacters :: TemplateCharacter TemplateCharacters TemplateCharacter のTRVとTemplateCharacters のTRVのstring-concatenation です。 -
TemplateCharacter :: SourceCharacter but not one of ` or\ or$ orLineTerminator SourceCharacter によってmatchされたcode pointに対してUTF16EncodeCodePoint を実行した結果です。 -
TemplateCharacter :: $ -
TemplateCharacter :: \ TemplateEscapeSequence TemplateEscapeSequence のTRVのstring-concatenation です。 -
TemplateCharacter :: \ NotEscapeSequence NotEscapeSequence のTRVのstring-concatenation です。 -
TemplateEscapeSequence :: 0 -
NotEscapeSequence :: 0 DecimalDigit DecimalDigit のTRVのstring-concatenation です。 -
NotEscapeSequence :: x [lookahead ∉ HexDigit ] -
NotEscapeSequence :: x HexDigit [lookahead ∉ HexDigit ]HexDigit のTRVのstring-concatenation です。 -
NotEscapeSequence :: u [lookahead ∉ HexDigit ][lookahead ≠ { ] -
NotEscapeSequence :: u HexDigit [lookahead ∉ HexDigit ]HexDigit のTRVのstring-concatenation です。 -
NotEscapeSequence :: u HexDigit HexDigit [lookahead ∉ HexDigit ]HexDigit のTRV、および2番目のHexDigit のTRVのstring-concatenation です。 -
NotEscapeSequence :: u HexDigit HexDigit HexDigit [lookahead ∉ HexDigit ]HexDigit のTRV、2番目のHexDigit のTRV、および3番目のHexDigit のTRVのstring-concatenation です。 -
NotEscapeSequence :: u { [lookahead ∉ HexDigit ]string-concatenation です。 -
NotEscapeSequence :: u { NotCodePoint [lookahead ∉ HexDigit ]NotCodePoint のTRVのstring-concatenation です。 -
NotEscapeSequence :: u { CodePoint [lookahead ∉ HexDigit ][lookahead ≠ } ]CodePoint のTRVのstring-concatenation です。 -
DecimalDigit :: one of 0 1 2 3 4 5 6 7 8 9 UTF16EncodeCodePoint を実行した結果です。 -
CharacterEscapeSequence :: NonEscapeCharacter NonEscapeCharacter のSV です。 -
SingleEscapeCharacter :: one of ' " \ b f n r t v UTF16EncodeCodePoint を実行した結果です。 -
HexEscapeSequence :: x HexDigit HexDigit HexDigit のTRV、および2番目のHexDigit のTRVのstring-concatenation です。 -
UnicodeEscapeSequence :: u Hex4Digits Hex4Digits のTRVのstring-concatenation です。 -
UnicodeEscapeSequence :: u{ CodePoint } CodePoint のTRV、およびcode unit 0x007D (RIGHT CURLY BRACKET)のstring-concatenation です。 -
Hex4Digits :: HexDigit HexDigit HexDigit HexDigit HexDigit のTRV、2番目のHexDigit のTRV、3番目のHexDigit のTRV、および4番目のHexDigit のTRVのstring-concatenation です。 -
HexDigits :: HexDigits HexDigit HexDigits のTRVとHexDigit のTRVのstring-concatenation です。 -
HexDigit :: one of 0 1 2 3 4 5 6 7 8 9 a b c d e f A B C D E F UTF16EncodeCodePoint を実行した結果です。 -
LineContinuation :: \ LineTerminatorSequence LineTerminatorSequence のTRVのstring-concatenation です。 -
LineTerminatorSequence :: <LF> -
LineTerminatorSequence :: <CR> -
LineTerminatorSequence :: <LS> -
LineTerminatorSequence :: <PS> -
LineTerminatorSequence :: <CR> <LF>
12.10 Automatic Semicolon Insertion
ほとんどのECMAScript statementsおよびdeclarationsはsemicolonで終了しなければなりません。そのようなsemicolonsはsource text内に常に明示的に現れてよいです。しかし便宜上、そのようなsemicolonsは特定の状況ではsource textから省略されてもよいです。これらの状況は、そのような状況でsemicolonsがsource code token streamに自動的に挿入される、と述べることで説明されます。
12.10.1 Rules of Automatic Semicolon Insertion
次のrulesでは、“token”とは、clause
semicolon insertionには3つの基本rulesがあります：
-
source textが左から右へparseされるとき、grammarのどのproductionによっても許可されないtoken（offending tokenと呼ばれる）に遭遇した場合、次の条件の1つ以上がtrueであれば、そのoffending tokenの前にsemicolonが自動的に挿入されます：
-
offending tokenがprevious tokenから少なくとも1つの
LineTerminator によって分離されている。 -
offending tokenが
}である。 -
previous tokenが
)であり、挿入されたsemicolonがdo-while statement（14.7.2 ）のterminating semicolonとしてparseされる。
-
offending tokenがprevious tokenから少なくとも1つの
- source textが左から右へparseされるとき、tokensのinput streamの終端に遭遇し、parserがinput token streamをgoal nonterminalの単一のinstanceとしてparseできない場合、input streamの終端にsemicolonが自動的に挿入されます。
-
source textが左から右へparseされるとき、grammarのあるproductionによって許可されるtokenに遭遇したが、そのproductionがrestricted productionであり、そのtokenがrestricted production内の注釈“[no
LineTerminator here]”の直後にあるterminalまたはnonterminalの最初のtokenとなる場合（したがって、そのようなtokenはrestricted tokenと呼ばれる）、かつrestricted tokenがprevious tokenから少なくとも1つのLineTerminator によって分離されている場合、そのrestricted tokenの前にsemicolonが自動的に挿入されます。
ただし、上記rulesには追加のoverriding conditionがあります：semicolonがempty statementとしてparseされることになる場合、またはそのsemicolonがfor statement（
grammar内のrestricted productionsは次のものだけです：
これらのrestricted productionsの実際上の効果は次のとおりです：
-
パーサが後置演算子として扱う位置で
++または--トークンに遭遇し、直前のトークンと++または--トークンの間に少なくとも1つのLineTerminator が出現していた場合、セミコロンは++または--トークンの前に自動的に挿入される。 -
usingトークンに遭遇し、IdentifierName トークンの前にLineTerminator が遭遇された場合、セミコロンはusingトークンの後に自動的に挿入される。 -
continue、break、return、throw、またはyieldトークンに遭遇し、次のトークンの前にLineTerminator が遭遇された場合、セミコロンはcontinue、break、return、throw、またはyieldトークンの後に自動的に挿入される。 -
アロー関数のパラメータが
=>トークンの前のLineTerminator に続く場合、セミコロンが自動的に挿入され、その区切り子は構文エラーを引き起こす。 -
asyncトークンの後に、function、IdentifierName 、または(トークンの前のLineTerminator が続く場合、セミコロンが自動的に挿入され、asyncトークンは後続のトークンと同じ式またはクラス要素の一部として扱われない。 -
asyncトークンの後に、*トークンの前のLineTerminator が続く場合、セミコロンが自動的に挿入され、その区切り子は構文エラーを引き起こす。
結果として、ECMAScript プログラマに対する実践的な助言は次のとおりである:
-
後置
++または--演算子は、そのオペランドと同じ行に置かれるべきである。 -
using宣言内のBindingList は、usingトークンと同じ行で開始するべきである。 -
returnまたはthrow文内のExpression 、またはyield式内のAssignmentExpression は、return、throw、またはyieldトークンと同じ行で開始するべきである。 -
breakまたはcontinue文内のLabelIdentifier は、breakまたはcontinueトークンと同じ行に置かれるべきである。 -
アロー関数のパラメータの終端とその
=>は、同じ行に置かれるべきである。 -
非同期関数またはメソッドの前にある
asyncトークンは、直後に続くトークンと同じ行に置かれるべきである。
12.10.2 Examples of Automatic Semicolon Insertion
This section is non-normative.source
{ 1 2 } 3は、automatic semicolon insertion rulesを用いても、ECMAScript grammarにおけるvalid sentenceではありません。対照的に、source
{ 1
2 } 3もvalidなECMAScript sentenceではありませんが、automatic semicolon insertionによって次のように変換されます：
{ 1
;2 ;} 3;これはvalidなECMAScript sentenceです。
source
for (a; b
)はvalidなECMAScript sentenceではなく、automatic semicolon insertionによって変更されません。なぜなら、semicolonはfor statementのheaderに必要だからです。Automatic semicolon insertionは、for statementのheader内の2つのsemicolonsの1つを決して挿入しません。
source
return
a + bはautomatic semicolon insertionによって次のように変換されます：
return;
a + b;a + bをtoken returnから分離しているため、expression a + bはreturn statementによって返される値として扱われません。
source
a = b
++cはautomatic semicolon insertionによって次のように変換されます：
a = b;
++c;++ tokenは、variable bに適用されるpostfix operatorとして扱われません。なぜなら、bと++の間に
source
if (a > b)
else c = dはvalidなECMAScript sentenceではなく、その時点でgrammarのどのproductionも適用されないにもかかわらず、else tokenの前にautomatic semicolon insertionによって変更されません。なぜなら、自動的に挿入されたsemicolonはempty statementとしてparseされることになるからです。
source
a = b + c
(d + e).print()はautomatic semicolon insertionによって変換されません。なぜなら、2行目を開始するparenthesized expressionはfunction callのargument listとして解釈できるからです：
a = b + c(d + e).print()assignment statementがleft parenthesisで開始しなければならない状況では、programmerはautomatic semicolon insertionに頼るのではなく、preceding statementの終端に明示的なsemicolonを提供することがよい考えです。
12.10.3 Interesting Cases of Automatic Semicolon Insertion
This section is non-normative.ECMAScript programsは、automatic semicolon insertionに頼ることで、非常に少ないsemicolonsのstyleで書くことができます。上で説明したように、semicolonsはすべてのnewlineで挿入されるわけではなく、automatic semicolon insertionはline terminatorsをまたいだ複数のtokensに依存する場合があります。
新しいsyntactic featuresがECMAScriptに追加されるにつれて、その前でautomatic semicolon insertionに頼っている行がparseされるときにgrammar productionsを変更させる追加grammar productionsが追加される可能性があります。
このsectionの目的では、automatic semicolon insertionのcaseは、その前にあるsource textに応じてsemicolonが挿入される場合もされない場合もある場所であるなら、interestingとみなされます。このsectionの残りでは、このversion of ECMAScriptにおけるautomatic semicolon insertionのいくつかのinteresting casesを説明します。
12.10.3.1 Interesting Cases of Automatic Semicolon Insertion in Statement Lists
- opening parenthesis（
(）。semicolonがない場合、2つの行は一緒にCallExpression として扱われます。 - opening square bracket（
[）。semicolonがない場合、2つの行はArrayLiteral またはArrayAssignmentPattern ではなくproperty accessとして扱われます。 - template literal（
`）。semicolonがない場合、2つの行は、previous expressionをMemberExpression とするtagged Template（13.3.11 ）として解釈されます。 - Unary
+または-。semicolonがない場合、2つの行は対応するbinary operatorの使用として解釈されます。 - RegExp literal。semicolonがない場合、2つの行は、例えばRegExpにflagsがある場合、代わりに
/MultiplicativeOperator としてparseされる可能性があります。
12.10.3.2 Cases of Automatic Semicolon Insertion and “[no LineTerminator here]”
This section is non-normative.
ECMAScriptには、“[no
このsectionの残りでは、このversion of ECMAScriptで“[no
12.10.3.2.1 List of Grammar Productions with Optional Operands and “[no LineTerminator here]”
UpdateExpression 。ContinueStatement 。BreakStatement 。ReturnStatement 。YieldExpression 。- Function Definitions（
15.2 ）との関係におけるAsync Function Definitions（15.8 ）
13 ECMAScript Language: Expressions
13.1 Identifiers
Syntax
yieldおよびawaitはgrammar内で
let
await 0;13.1.1 Static Semantics: Early Errors
-
IsStrict (this production)がtrue であり、かつIdentifier のStringValue が"arguments" または"eval" のいずれかである場合、それはSyntax Errorです。
-
IsStrict (this production)がtrue なら、それはSyntax Errorです。
-
syntactic grammarの
goal symbol がModule なら、それはSyntax Errorです。
- このproductionが[Yield] parameterを持つ場合、それはSyntax Errorです。
- このproductionが[Await] parameterを持つ場合、それはSyntax Errorです。
-
このproductionが[Yield] parameterを持ち、かつ
Identifier のStringValue が"yield" である場合、それはSyntax Errorです。 -
このproductionが[Await] parameterを持ち、かつ
Identifier のStringValue が"await" である場合、それはSyntax Errorです。
-
IsStrict (this phrase)がtrue であり、かつIdentifierName のStringValue が"implements" 、"interface" 、"let" 、"package" 、"private" 、"protected" 、"public" 、"static" 、または"yield" のいずれかである場合、それはSyntax Errorです。 -
syntactic grammarの
goal symbol がModule であり、かつIdentifierName のStringValue が"await" である場合、それはSyntax Errorです。 -
IdentifierName のStringValue が、yieldまたはawaitを除く任意のReservedWord のStringValue である場合、それはSyntax Errorです。
13.1.2 Static Semantics: StringValue
The
- idTextUnescapedを
IdentifierName のIdentifierCodePoints とする。 CodePointsToString (idTextUnescaped)を返す。
"yield" を返す。
"await" を返す。
- 0x0023 (NUMBER SIGN)と
IdentifierName のStringValue のstring-concatenation を返す。
StringLiteral のSV を返す。
13.1.3 Runtime Semantics: Evaluation
- ?
ResolveBinding (Identifier のStringValue )を返す。
- ?
ResolveBinding ("yield" )を返す。
- ?
ResolveBinding ("await" )を返す。
yieldをidentifierとして使用できます。yieldが
13.2 Primary Expression
Syntax
Supplemental Syntax
production
のinstanceを処理するとき、
13.2.1 The this Keyword
13.2.1.1 Runtime Semantics: Evaluation
- ?
ResolveThisBinding ()を返す。
13.2.2 Identifier Reference
13.2.3 Literals
Syntax
13.2.3.1 Runtime Semantics: Evaluation
null を返す。
BooleanLiteral がtokenfalseなら、false を返す。BooleanLiteral がtokentrueなら、true を返す。
12.9.3 で定義されるNumericLiteral のNumericValue を返す。
12.9.4.2 で定義されるStringLiteral のSV を返す。
13.2.4 Array Initializer
Array elementsはelement listのbeginning、middle、またはendでelideされる場合があります。element list内のcommaの直前に
Syntax
13.2.4.1 Runtime Semantics: ArrayAccumulation
The
- 引数arrayおよび(nextIndex + 1)を伴う
Elision の ?ArrayAccumulation を返す。
Elision が存在するなら、- nextIndexを、引数arrayおよびnextIndexを伴う
Elision の ?ArrayAccumulation に設定する。
- nextIndexを、引数arrayおよびnextIndexを伴う
- initResultを
AssignmentExpression の ?Evaluation とする。 - initValueを ?
GetValue (initResult) とする。 - !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (nextIndex)), initValue)を実行する。 - nextIndex + 1を返す。
Elision が存在するなら、- nextIndexを、引数arrayおよびnextIndexを伴う
Elision の ?ArrayAccumulation に設定する。
- nextIndexを、引数arrayおよびnextIndexを伴う
- 引数arrayおよびnextIndexを伴う
SpreadElement の ?ArrayAccumulation を返す。
- nextIndexを、引数arrayおよびnextIndexを伴うderived
ElementList の ?ArrayAccumulation に設定する。 Elision が存在するなら、- nextIndexを、引数arrayおよびnextIndexを伴う
Elision の ?ArrayAccumulation に設定する。
- nextIndexを、引数arrayおよびnextIndexを伴う
- initResultを
AssignmentExpression の ?Evaluation とする。 - initValueを ?
GetValue (initResult) とする。 - !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (nextIndex)), initValue)を実行する。 - nextIndex + 1を返す。
- nextIndexを、引数arrayおよびnextIndexを伴うderived
ElementList の ?ArrayAccumulation に設定する。 Elision が存在するなら、- nextIndexを、引数arrayおよびnextIndexを伴う
Elision の ?ArrayAccumulation に設定する。
- nextIndexを、引数arrayおよびnextIndexを伴う
- 引数arrayおよびnextIndexを伴う
SpreadElement の ?ArrayAccumulation を返す。
- spreadRefを
AssignmentExpression の ?Evaluation とする。 - spreadObjを ?
GetValue (spreadRef) とする。 - iteratorRecordを ?
GetIterator (spreadObj,sync ) とする。 - 繰り返す
- nextを ?
IteratorStepValue (iteratorRecord) とする。 - nextが
done なら、nextIndexを返す。 - !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (nextIndex)), next)を実行する。 - nextIndexをnextIndex + 1に設定する。
- nextを ?
13.2.4.2 Runtime Semantics: Evaluation
- arrayを !
ArrayCreate (0) とする。 Elision が存在するなら、- 引数arrayおよび0を伴う
Elision の ?ArrayAccumulation を実行する。
- 引数arrayおよび0を伴う
- arrayを返す。
- arrayを !
ArrayCreate (0) とする。 - 引数arrayおよび0を伴う
ElementList の ?ArrayAccumulation を実行する。 - arrayを返す。
- arrayを !
ArrayCreate (0) とする。 - nextIndexを、引数arrayおよび0を伴う
ElementList の ?ArrayAccumulation とする。 Elision が存在するなら、- 引数arrayおよびnextIndexを伴う
Elision の ?ArrayAccumulation を実行する。
- 引数arrayおよびnextIndexを伴う
- arrayを返す。
13.2.5 Object Initializer
object initializerは、literalに似た形式で書かれた、Objectのinitializationを記述するexpressionです。これは、curly bracketsで囲まれた、0個以上の
Syntax
特定のcontextsでは、
13.2.5.1 Static Semantics: Early Errors
-
MethodDefinition のHasDirectSuper がtrue である場合、それはSyntax Errorです。 -
MethodDefinition のPrivateBoundIdentifiers が空でない場合、それはSyntax Errorです。
実際のobject initializerを記述することに加えて、
- 任意のsource textがこのproductionによってmatchされる場合、それはSyntax Errorです。
このproductionは、
-
PropertyDefinitionList のPropertyNameList が"__proto__" について重複entriesを含み、かつそれらのentriesの少なくとも2つがPropertyDefinition : PropertyName : AssignmentExpression ObjectLiteral がParseJSON のためにparseされているScript 内に含まれる場合には適用されません（ParseJSON のstep3 を参照）。
13.2.5.2 Static Semantics: IsComputedPropertyKey
The
false を返す。
true を返す。
13.2.5.3 Static Semantics: PropertyDefinitionNodes
The
- 新しい空の
List を返す。
- «
PropertyDefinition »を返す。
- headをderived
PropertyDefinitionList のPropertyDefinitionNodes とする。 - headと«
PropertyDefinition »のlist-concatenation を返す。
13.2.5.4 Static Semantics: PropertyNameList
The
- propertyNameを
PropertyDefinition のPropName とする。 - propertyNameが
empty なら、新しい空のList を返す。 - « propertyName »を返す。
- listを
PropertyDefinitionList のPropertyNameList とする。 - propertyNameを
PropertyDefinition のPropName とする。 - propertyNameが
empty なら、listを返す。 - listと« propertyName »の
list-concatenation を返す。
13.2.5.5 Runtime Semantics: Evaluation
- objを
OrdinaryObjectCreate (%Object.prototype% )とする。 - 引数objを伴う
PropertyDefinitionList の ?PropertyDefinitionEvaluation を実行する。 - objを返す。
StringLiteral のSV を返す。
- numberを
NumericLiteral のNumericValue とする。 - !
ToString (number)を返す。
- exprValueを
AssignmentExpression の ?Evaluation とする。 - propertyNameを ?
GetValue (exprValue) とする。 - ?
ToPropertyKey (propertyName)を返す。
13.2.5.6 Runtime Semantics: PropertyDefinitionEvaluation
The
- 引数objを伴う
PropertyDefinitionList の ?PropertyDefinitionEvaluation を実行する。 - 引数objを伴う
PropertyDefinition の ?PropertyDefinitionEvaluation を実行する。 unused を返す。
- exprValueを
AssignmentExpression の ?Evaluation とする。 - fromValueを ?
GetValue (exprValue) とする。 - excludedNamesを新しい空の
List とする。 - ?
CopyDataProperties (obj, fromValue, excludedNames)を実行する。 unused を返す。
- propertyNameを
IdentifierReference のStringValue とする。 - exprValueを
IdentifierReference の ?Evaluation とする。 - propertyValueを ?
GetValue (exprValue) とする。 Assert : objはordinaryでextensibleなobjectであり、non-configurable propertiesを持たない。- !
CreateDataPropertyOrThrow (obj, propertyName, propertyValue)を実行する。 unused を返す。
- propertyKeyを
PropertyName の ?Evaluation とする。 - この
PropertyDefinition がParseJSON のために評価されているScript 内に含まれるなら（ParseJSON のstep6 を参照）、- isProtoSetterを
false とする。
- isProtoSetterを
- そうでなく、propertyKeyが
"__proto__" であり、かつPropertyName のIsComputedPropertyKey がfalse なら、- isProtoSetterを
true とする。
- isProtoSetterを
- そうでなければ、
- isProtoSetterを
false とする。
- isProtoSetterを
IsAnonymousFunctionDefinition (AssignmentExpression )がtrue であり、かつisProtoSetterがfalse なら、- propertyValueを、引数propertyKeyを伴う
AssignmentExpression の ?NamedEvaluation とする。
- propertyValueを、引数propertyKeyを伴う
- そうでなければ、
- exprValueRefを
AssignmentExpression の ?Evaluation とする。 - propertyValueを ?
GetValue (exprValueRef) とする。
- exprValueRefを
- isProtoSetterが
true なら、- propertyValueがObjectまたはpropertyValueが
null なら、- ! obj.[[SetPrototypeOf]](propertyValue)を実行する。
unused を返す。
- propertyValueがObjectまたはpropertyValueが
Assert : objはordinaryでextensibleなobjectであり、non-configurable propertiesを持たない。- !
CreateDataPropertyOrThrow (obj, propertyKey, propertyValue)を実行する。 unused を返す。
- 引数objおよび
true を伴うMethodDefinition の ?MethodDefinitionEvaluation を実行する。 unused を返す。
13.2.6 Function Defining Expressions
13.2.7 Regular Expression Literals
Syntax
13.2.7.1 Static Semantics: Early Errors
-
IsValidRegularExpressionLiteral (RegularExpressionLiteral )がfalse である場合、それはSyntax Errorです。
13.2.7.2 Static Semantics: IsValidRegularExpressionLiteral ( literal )
The abstract operation IsValidRegularExpressionLiteral takes argument literal (a
- flagsをliteralの
FlagText とする。 - flagsが
d、g、i、m、s、u、v、またはy以外のcode pointsを含むなら、false を返す。 - flagsが任意のcode pointを複数回含むなら、
false を返す。 - flagsが
uを含むなら、uをtrue とする；そうでなければ、uをfalse とする。 - flagsが
vを含むなら、vをtrue とする；そうでなければ、vをfalse とする。 - patternTextをliteralの
BodyText とする。 - uが
false であり、かつvがfalse なら、- stringValueを
CodePointsToString (patternText)とする。 - patternTextを、stringValueの16-bit elementsのそれぞれをUnicode BMP code pointとして解釈した結果となるcode pointsのsequenceに設定する。UTF-16 decodingはelementsに適用されない。
- stringValueを
- parseResultを
ParsePattern (patternText, u, v)とする。 - parseResultが
Parse Node なら、true を返す。 false を返す。
13.2.7.3 Runtime Semantics: Evaluation
- patternを
CodePointsToString (RegularExpressionLiteral のBodyText )とする。 - flagsを
CodePointsToString (RegularExpressionLiteral のFlagText )とする。 - !
RegExpCreate (pattern, flags)を返す。
13.2.8 Template Literals
Syntax
13.2.8.1 Static Semantics: Early Errors
-
[Tagged] parameterが設定されておらず、かつ
NoSubstitutionTemplate がNotEscapeSequence をContains する場合、それはSyntax Errorです。
-
argument
false を伴うTemplateLiteral のTemplateStrings 内のelements数が232以上である場合、それはSyntax Errorです。
-
[Tagged] parameterが設定されておらず、かつ
TemplateHead がNotEscapeSequence をContains する場合、それはSyntax Errorです。
-
[Tagged] parameterが設定されておらず、かつ
TemplateTail がNotEscapeSequence をContains する場合、それはSyntax Errorです。
-
[Tagged] parameterが設定されておらず、かつ
TemplateMiddle がNotEscapeSequence をContains する場合、それはSyntax Errorです。
13.2.8.2 Static Semantics: TemplateStrings
The
- «
TemplateString (NoSubstitutionTemplate , raw) »を返す。
- headを«
TemplateString (TemplateHead , raw) »とする。 - tailを、argument rawを伴う
TemplateSpans のTemplateStrings とする。 - headとtailの
list-concatenation を返す。
- «
TemplateString (TemplateTail , raw) »を返す。
- middleを、argument rawを伴う
TemplateMiddleList のTemplateStrings とする。 - tailを«
TemplateString (TemplateTail , raw) »とする。 - middleとtailの
list-concatenation を返す。
- «
TemplateString (TemplateMiddle , raw) »を返す。
- frontを、argument rawを伴う
TemplateMiddleList のTemplateStrings とする。 - lastを«
TemplateString (TemplateMiddle , raw) »とする。 - frontとlastの
list-concatenation を返す。
13.2.8.3 Static Semantics: TemplateString ( templateToken, raw )
The abstract operation TemplateString takes arguments templateToken (a
このoperationは、rawが
13.2.8.4 GetTemplateObject ( templateLiteral )
The abstract operation GetTemplateObject takes argument templateLiteral (a
- realmを
current Realm Record とする。 - templateRegistryをrealm.[[TemplateMap]]とする。
- templateRegistryの各要素elementについて、以下を行う
- element.[[Site]]がtemplateLiteralと
同じParse Node なら、- element.[[Array]]を返す。
- element.[[Site]]がtemplateLiteralと
- rawStringsを、argument
true を伴うtemplateLiteralのTemplateStrings とする。 Assert : rawStringsはStringsのList である。- cookedStringsを、argument
false を伴うtemplateLiteralのTemplateStrings とする。 - countを
List cookedStrings内のelements数とする。 Assert : count ≤ 232 - 1.- templateを !
ArrayCreate (count) とする。 - rawObjを !
ArrayCreate (count) とする。 - indexを0とする。
- index < countである間、繰り返す
- propertyKeyを !
ToString (𝔽 (index)) とする。 - cookedValueをcookedStrings[index]とする。
- !
DefinePropertyOrThrow (template, propertyKey, PropertyDescriptor { [[Value]]: cookedValue, [[Writable]]:false , [[Enumerable]]:true , [[Configurable]]:false })を実行する。 - rawValueをString値rawStrings[index]とする。
- !
DefinePropertyOrThrow (rawObj, propertyKey, PropertyDescriptor { [[Value]]: rawValue, [[Writable]]:false , [[Enumerable]]:true , [[Configurable]]:false })を実行する。 - indexをindex + 1に設定する。
- propertyKeyを !
- !
SetIntegrityLevel (rawObj,frozen )を実行する。 - !
DefinePropertyOrThrow (template,"raw" , PropertyDescriptor { [[Value]]: rawObj, [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:false })を実行する。 - !
SetIntegrityLevel (template,frozen )を実行する。 Record { [[Site]]: templateLiteral, [[Array]]: template }をrealm.[[TemplateMap]]へappendする。- templateを返す。
template objectの作成は
この仕様の将来のeditionsでは、template objectsの追加non-enumerable propertiesを定義する場合があります。
13.2.8.5 Runtime Semantics: SubstitutionEvaluation
The
- 新しい空の
List を返す。
- subRefを
Expression の ?Evaluation とする。 - subを ?
GetValue (subRef) とする。 - « sub »を返す。
- precedingを
TemplateMiddleList の ?SubstitutionEvaluation とする。 - nextRefを
Expression の ?Evaluation とする。 - nextを ?
GetValue (nextRef) とする。 - precedingと« next »の
list-concatenation を返す。
13.2.8.6 Runtime Semantics: Evaluation
12.9.6 で定義されるNoSubstitutionTemplate のTV を返す。
- headを
12.9.6 で定義されるTemplateHead のTV とする。 - subRefを
Expression の ?Evaluation とする。 - subを ?
GetValue (subRef) とする。 - middleを ?
ToString (sub) とする。 - tailを
TemplateSpans の ?Evaluation とする。 - head、middle、およびtailの
string-concatenation を返す。
+ operatorではなくString.prototype.concatに似ています。
12.9.6 で定義されるTemplateTail のTV を返す。
- headを
TemplateMiddleList の ?Evaluation とする。 - tailを
12.9.6 で定義されるTemplateTail のTV とする。 - headとtailの
string-concatenation を返す。
- headを
12.9.6 で定義されるTemplateMiddle のTV とする。 - subRefを
Expression の ?Evaluation とする。 - subを ?
GetValue (subRef) とする。 - middleを ?
ToString (sub) とする。 - headとmiddleの
string-concatenation を返す。
+ operatorではなくString.prototype.concatに似ています。
- restを
TemplateMiddleList の ?Evaluation とする。 - middleを
12.9.6 で定義されるTemplateMiddle のTV とする。 - subRefを
Expression の ?Evaluation とする。 - subを ?
GetValue (subRef) とする。 - lastを ?
ToString (sub) とする。 - rest、middle、およびlastの
string-concatenation を返す。
+ operatorではなくString.prototype.concatに似ています。
13.2.9 The Grouping Operator
13.2.9.1 Static Semantics: Early Errors
-
CoverParenthesizedExpressionAndArrowParameterList はParenthesizedExpression をcoverしなければなりません。
13.2.9.2 Runtime Semantics: Evaluation
- exprを
CoverParenthesizedExpressionAndArrowParameterList によってcoverされるParenthesizedExpression とする。 - exprの ?
Evaluation を返す。
Expression の ?Evaluation を返す。これはReference型であり得る。
このalgorithmはdeleteやtypeofなどのoperatorsをparenthesized expressionsに適用できるようにするためです。
13.3 Left-Hand-Side Expressions
Syntax
Supplemental Syntax
production
のinstanceを処理するとき、
13.3.1 Static Semantics
13.3.1.1 Static Semantics: Early Errors
- 任意のsource textがこのproductionによってmatchされる場合、それはSyntax Errorです。
このproductionは、automatic semicolon insertion rules（
a?.b
`c`これにより、それが2つのvalid statementsとして解釈されることを防ぎます。目的は、optional chainingを使用しない類似のcodeとの一貫性を維持することです：
a.b
`c`これはvalid statementであり、automatic semicolon insertionは適用されません。
-
syntactic
goal symbol がModule でない場合、それはSyntax Errorです。
13.3.2 Property Accessors
Propertiesは、dot notationを使用してnameによってaccessされます：
またはbracket notationを使用します：
dot notationは、次のsyntactic conversionによって説明されます：
は、その振る舞いにおいて次と同一です
同様に
は、その振る舞いにおいて次と同一です
ここで、<identifier-name-string>は
13.3.2.1 Runtime Semantics: Evaluation
- baseRefを
MemberExpression の ?Evaluation とする。 - baseValueを ?
GetValue (baseRef) とする。 - strictを
IsStrict (thisMemberExpression )とする。 - ?
EvaluatePropertyAccessWithExpressionKey (baseValue,Expression , strict)を返す。
- baseRefを
MemberExpression の ?Evaluation とする。 - baseValueを ?
GetValue (baseRef) とする。 - strictを
IsStrict (thisMemberExpression )とする。 EvaluatePropertyAccessWithIdentifierKey (baseValue,IdentifierName , strict)を返す。
- baseRefを
MemberExpression の ?Evaluation とする。 - baseValueを ?
GetValue (baseRef) とする。 - fieldNameStringを
PrivateIdentifier のStringValue とする。 MakePrivateReference (baseValue, fieldNameString)を返す。
- baseRefを
CallExpression の ?Evaluation とする。 - baseValueを ?
GetValue (baseRef) とする。 - strictを
IsStrict (thisCallExpression )とする。 - ?
EvaluatePropertyAccessWithExpressionKey (baseValue,Expression , strict)を返す。
- baseRefを
CallExpression の ?Evaluation とする。 - baseValueを ?
GetValue (baseRef) とする。 - strictを
IsStrict (thisCallExpression )とする。 EvaluatePropertyAccessWithIdentifierKey (baseValue,IdentifierName , strict)を返す。
- baseRefを
CallExpression の ?Evaluation とする。 - baseValueを ?
GetValue (baseRef) とする。 - fieldNameStringを
PrivateIdentifier のStringValue とする。 MakePrivateReference (baseValue, fieldNameString)を返す。
13.3.3 EvaluatePropertyAccessWithExpressionKey ( baseValue, expr, strict )
The abstract operation EvaluatePropertyAccessWithExpressionKey takes arguments baseValue (an ECMAScript language value), expr (an
- propertyNameRefをexprの ?
Evaluation とする。 - propertyNameValueを ?
GetValue (propertyNameRef) とする。 NOTE : ほとんどの場合、ToPropertyKey はこのstepの直後にpropertyNameValueに対して実行される。しかし、a[b] = cの場合には、cの評価後まで実行されない。Reference Record { [[Base]]: baseValue, [[ReferencedName]]: propertyNameValue, [[Strict]]: strict, [[ThisValue]]:empty }を返す。
13.3.4 EvaluatePropertyAccessWithIdentifierKey ( baseValue, identifierName, strict )
The abstract operation EvaluatePropertyAccessWithIdentifierKey takes arguments baseValue (an ECMAScript language value), identifierName (an
- propertyNameStringをidentifierNameの
StringValue とする。 Reference Record { [[Base]]: baseValue, [[ReferencedName]]: propertyNameString, [[Strict]]: strict, [[ThisValue]]:empty }を返す。
13.3.5 The new Operator
13.3.5.1 Runtime Semantics: Evaluation
- ?
EvaluateNew (NewExpression ,empty )を返す。
- ?
EvaluateNew (MemberExpression ,Arguments )を返す。
13.3.5.1.1 EvaluateNew ( constructExpr, argumentsNode )
The abstract operation EvaluateNew takes arguments constructExpr (a
- refをconstructExprの ?
Evaluation とする。 - ctorを ?
GetValue (ref) とする。 - argumentsNodeが
empty なら、- argListを新しい空の
List とする。
- argListを新しい空の
- そうでなければ、
- argListをargumentsNodeの ?
ArgumentListEvaluation とする。
- argListをargumentsNodeの ?
IsConstructor (ctor)がfalse なら、TypeError 例外をthrowする。- ?
Construct (ctor, argList)を返す。
13.3.6 Function Calls
13.3.6.1 Runtime Semantics: Evaluation
- exprを
CoverCallExpressionAndAsyncArrowHead によってcoverされるCallMemberExpression とする。 - memberExprをexprの
MemberExpression とする。 - argsをexprの
Arguments とする。 - refをmemberExprの ?
Evaluation とする。 - funcを ?
GetValue (ref) とする。 - refが
Reference Record であり、IsPropertyReference (ref)がfalse であり、かつref.[[ReferencedName]]が"eval" なら、SameValue (func,%eval% )がtrue なら、- argListをargsの ?
ArgumentListEvaluation とする。 - argListがelementsを持たないなら、
undefined を返す。 - evalArgをargListの最初のelementとする。
IsStrict (thisCallExpression )がtrue なら、strictCallerをtrue とする；そうでなければ、strictCallerをfalse とする。- ?
PerformEval (evalArg, strictCaller,true )を返す。
- argListをargsの ?
- thisCallをthis
CallExpression とする。 - tailCallを
IsInTailPosition (thisCall)とする。 - ?
EvaluateCall (func, ref, args, tailCall)を返す。
step
- refを
CallExpression の ?Evaluation とする。 - funcを ?
GetValue (ref) とする。 - thisCallをthis
CallExpression とする。 - tailCallを
IsInTailPosition (thisCall)とする。 - ?
EvaluateCall (func, ref,Arguments , tailCall)を返す。
13.3.6.2 EvaluateCall ( func, thisValueRef, argumentListNode, tailPosition )
The abstract operation EvaluateCall takes arguments func (an ECMAScript language value), thisValueRef (an ECMAScript language value or a
- thisValueRefが
Reference Record なら、IsPropertyReference (thisValueRef)がtrue なら、- thisValueを
GetThisValue (thisValueRef)とする。
- thisValueを
- そうでなければ、
- refEnvをthisValueRef.[[Base]]とする。
Assert : refEnvはEnvironment Record である。- thisValueをrefEnv.
WithBaseObject ()とする。
- そうでなければ、
- thisValueを
undefined とする。
- thisValueを
- argListをargumentListNodeの ?
ArgumentListEvaluation とする。 - funcがObjectでないなら、
TypeError 例外をthrowする。 IsCallable (func)がfalse なら、TypeError 例外をthrowする。- tailPositionが
true なら、PrepareForTailCall ()を実行する。 - ?
Call (func, thisValue, argList)を返す。
13.3.7 The super Keyword
13.3.7.1 Runtime Semantics: Evaluation
- envRecordを
GetThisEnvironment ()とする。 - actualThisを ? envRecord.
GetThisBinding () とする。 - propertyNameRefを
Expression の ?Evaluation とする。 - propertyNameValueを ?
GetValue (propertyNameRef) とする。 - strictを
IsStrict (thisSuperProperty )とする。 NOTE : ほとんどの場合、ToPropertyKey はこのstepの直後にpropertyNameValueに対して実行される。しかし、super[b] = cの場合には、cの評価後まで実行されない。MakeSuperPropertyReference (actualThis, propertyNameValue, strict)を返す。
- envRecordを
GetThisEnvironment ()とする。 - actualThisを ? envRecord.
GetThisBinding () とする。 - propertyKeyを
IdentifierName のStringValue とする。 - strictを
IsStrict (thisSuperProperty )とする。 MakeSuperPropertyReference (actualThis, propertyKey, strict)を返す。
- newTargetを
GetNewTarget ()とする。 Assert : newTargetはconstructor である。- superCtorを
GetSuperConstructor ()とする。 - argListを
Arguments の ?ArgumentListEvaluation とする。 IsConstructor (superCtor)がfalse なら、TypeError 例外をthrowする。- resultを ?
Construct (superCtor, argList, newTarget) とする。 - thisERを
GetThisEnvironment ()とする。 Assert : thisERはFunction Environment Record である。- ?
BindThisValue (thisER, result)を実行する。 - funcObjをthisER.[[FunctionObject]]とする。
Assert : funcObjはECMAScriptfunction object である。- ?
InitializeInstanceElements (result, funcObj)を実行する。 - resultを返す。
13.3.7.2 GetSuperConstructor ( )
The abstract operation GetSuperConstructor takes no arguments and returns an Object or
- envRecordを
GetThisEnvironment ()とする。 Assert : envRecordはFunction Environment Record である。- activeFuncをenvRecord.[[FunctionObject]]とする。
Assert : activeFuncはECMAScriptfunction object である。- superCtorを ! activeFunc.[[GetPrototypeOf]]() とする。
- superCtorを返す。
13.3.7.3 MakeSuperPropertyReference ( actualThis, propertyKey, strict )
The abstract operation MakeSuperPropertyReference takes arguments actualThis (an ECMAScript language value), propertyKey (an ECMAScript language value), and strict (a Boolean) and returns a
- envRecordを
GetThisEnvironment ()とする。 Assert : envRecord.HasSuperBinding ()はtrue である。Assert : envRecordはFunction Environment Record である。- baseValueを
GetSuperBase (envRecord)とする。 Reference Record { [[Base]]: baseValue, [[ReferencedName]]: propertyKey, [[Strict]]: strict, [[ThisValue]]: actualThis }を返す。
13.3.8 Argument Lists
argument listのevaluationはvaluesの
13.3.8.1 Runtime Semantics: ArgumentListEvaluation
The
- 新しい空の
List を返す。
- refを
AssignmentExpression の ?Evaluation とする。 - argを ?
GetValue (ref) とする。 - « arg »を返す。
- listを新しい空の
List とする。 - spreadRefを
AssignmentExpression の ?Evaluation とする。 - spreadObjを ?
GetValue (spreadRef) とする。 - iteratorRecordを ?
GetIterator (spreadObj,sync ) とする。 - 繰り返す
- nextを ?
IteratorStepValue (iteratorRecord) とする。 - nextが
done なら、listを返す。 - nextをlistへappendする。
- nextを ?
- precedingArgsを
ArgumentList の ?ArgumentListEvaluation とする。 - refを
AssignmentExpression の ?Evaluation とする。 - argを ?
GetValue (ref) とする。 - precedingArgsと« arg »の
list-concatenation を返す。
- precedingArgsを
ArgumentList の ?ArgumentListEvaluation とする。 - spreadRefを
AssignmentExpression の ?Evaluation とする。 - iteratorRecordを ?
GetIterator (?GetValue (spreadRef),sync ) とする。 - 繰り返す
- nextを ?
IteratorStepValue (iteratorRecord) とする。 - nextが
done なら、precedingArgsを返す。 - nextをprecedingArgsへappendする。
- nextを ?
- templateLiteralをthis
TemplateLiteral とする。 - siteObjを
GetTemplateObject (templateLiteral)とする。 - « siteObj »を返す。
- templateLiteralをthis
TemplateLiteral とする。 - siteObjを
GetTemplateObject (templateLiteral)とする。 - remainingを
SubstitutionTemplate の ?ArgumentListEvaluation とする。 - « siteObj »とremainingの
list-concatenation を返す。
- firstSubRefを
Expression の ?Evaluation とする。 - firstSubを ?
GetValue (firstSubRef) とする。 - restSubを
TemplateSpans の ?SubstitutionEvaluation とする。 Assert : restSubはpossibly emptyList である。- « firstSub »とrestSubの
list-concatenation を返す。
13.3.9 Optional Chains
?.で始まります。13.3.9.1 Runtime Semantics: Evaluation
- baseRefを
MemberExpression の ?Evaluation とする。 - baseValueを ?
GetValue (baseRef) とする。 - baseValueが
undefined またはnull のいずれかなら、undefined を返す。
- 引数baseValueおよびbaseRefを伴う
OptionalChain の ?ChainEvaluation を返す。
- baseRefを
CallExpression の ?Evaluation とする。 - baseValueを ?
GetValue (baseRef) とする。 - baseValueが
undefined またはnull のいずれかなら、undefined を返す。
- 引数baseValueおよびbaseRefを伴う
OptionalChain の ?ChainEvaluation を返す。
- baseRefを
OptionalExpression の ?Evaluation とする。 - baseValueを ?
GetValue (baseRef) とする。 - baseValueが
undefined またはnull のいずれかなら、undefined を返す。
- 引数baseValueおよびbaseRefを伴う
OptionalChain の ?ChainEvaluation を返す。
13.3.9.2 Runtime Semantics: ChainEvaluation
The
- thisChainをthis
OptionalChain とする。 - tailCallを
IsInTailPosition (thisChain)とする。 - ?
EvaluateCall (baseValue, baseRef,Arguments , tailCall)を返す。
- strictを
IsStrict (thisOptionalChain )とする。 - ?
EvaluatePropertyAccessWithExpressionKey (baseValue,Expression , strict)を返す。
- strictを
IsStrict (thisOptionalChain )とする。 EvaluatePropertyAccessWithIdentifierKey (baseValue,IdentifierName , strict)を返す。
- fieldNameStringを
PrivateIdentifier のStringValue とする。 MakePrivateReference (baseValue, fieldNameString)を返す。
- optionalChainを
OptionalChain とする。 - newRefを、引数baseValueおよびbaseRefを伴うoptionalChainの ?
ChainEvaluation とする。 - newValueを ?
GetValue (newRef) とする。 - thisChainをthis
OptionalChain とする。 - tailCallを
IsInTailPosition (thisChain)とする。 - ?
EvaluateCall (newValue, newRef,Arguments , tailCall)を返す。
- optionalChainを
OptionalChain とする。 - newRefを、引数baseValueおよびbaseRefを伴うoptionalChainの ?
ChainEvaluation とする。 - newValueを ?
GetValue (newRef) とする。 - strictを
IsStrict (thisOptionalChain )とする。 - ?
EvaluatePropertyAccessWithExpressionKey (newValue,Expression , strict)を返す。
- optionalChainを
OptionalChain とする。 - newRefを、引数baseValueおよびbaseRefを伴うoptionalChainの ?
ChainEvaluation とする。 - newValueを ?
GetValue (newRef) とする。 - strictを
IsStrict (thisOptionalChain )とする。 EvaluatePropertyAccessWithIdentifierKey (newValue,IdentifierName , strict)を返す。
- optionalChainを
OptionalChain とする。 - newRefを、引数baseValueおよびbaseRefを伴うoptionalChainの ?
ChainEvaluation とする。 - newValueを ?
GetValue (newRef) とする。 - fieldNameStringを
PrivateIdentifier のStringValue とする。 MakePrivateReference (newValue, fieldNameString)を返す。
13.3.10 Import Calls
13.3.10.1 Runtime Semantics: Evaluation
- ?
EvaluateImportCall (最初のAssignmentExpression , 2番目のAssignmentExpression )を返す。
13.3.10.2 EvaluateImportCall ( specifierExpr [ , optionsExpr ] )
The abstract operation EvaluateImportCall takes argument specifierExpr (a
- referrerを
GetActiveScriptOrModule ()とする。 - referrerが
null なら、referrerをcurrent Realm Record に設定する。 - specifierRefをspecifierExprの ?
Evaluation とする。 - specifierを ?
GetValue (specifierRef) とする。 - optionsExprが存在するなら、
- optionsRefをoptionsExprの ?
Evaluation とする。 - optionsを ?
GetValue (optionsRef) とする。
- optionsRefをoptionsExprの ?
- そうでなければ、
- optionsを
undefined とする。
- optionsを
- promiseCapabilityを !
NewPromiseCapability (%Promise% ) とする。 - specifierStringを
Completion (ToString (specifier))とする。 IfAbruptRejectPromise (specifierString, promiseCapability).- attrsを新しい空の
List とする。 - optionsが
undefined でないなら、- optionsがObjectでないなら、
- !
Call (promiseCapability.[[Reject]],undefined , « 新しく作成されたTypeError object »)を実行する。 - promiseCapability.[[Promise]]を返す。
- !
- attrsObjを
Completion (Get (options,"with" )))とする。 IfAbruptRejectPromise (attrsObj, promiseCapability).- attrsObjが
undefined でないなら、- attrsObjがObjectでないなら、
- !
Call (promiseCapability.[[Reject]],undefined , « 新しく作成されたTypeError object »)を実行する。 - promiseCapability.[[Promise]]を返す。
- !
- entriesを
Completion (EnumerableOwnProperties (attrsObj,key+value ))とする。 IfAbruptRejectPromise (entries, promiseCapability).- entriesの各要素entryについて、以下を行う
- keyを !
Get (entry,"0" ) とする。 - valueを !
Get (entry,"1" ) とする。 - keyがStringなら、
- valueがStringでないなら、
- !
Call (promiseCapability.[[Reject]],undefined , « 新しく作成されたTypeError object »)を実行する。 - promiseCapability.[[Promise]]を返す。
- !
ImportAttribute Record { [[Key]]: key, [[Value]]: value }をattrsへappendする。
- valueがStringでないなら、
- keyを !
- attrsObjがObjectでないなら、
AllImportAttributesSupported (attrs)がfalse なら、- !
Call (promiseCapability.[[Reject]],undefined , « 新しく作成されたTypeError object »)を実行する。 - promiseCapability.[[Promise]]を返す。
- !
- attrsを、その[[Key]] fieldのlexicographic orderに従ってsortし、そのような各fieldの値をUTF-16 code unit valuesのsequenceとして扱う。
NOTE : このsortingは、hosts がattributesのenumerated順序に基づいてbehaviourを変更することを禁止されているという点でのみobservableです。
- optionsがObjectでないなら、
- moduleRequestを新しい
ModuleRequest Record { [[Specifier]]: specifierString, [[Attributes]]: attrs }とする。 HostLoadImportedModule (referrer, moduleRequest,empty , promiseCapability)を実行する。- promiseCapability.[[Promise]]を返す。
13.3.10.3 ContinueDynamicImport ( promiseCapability, moduleCompletion )
The abstract operation ContinueDynamicImport takes arguments promiseCapability (a import()
- moduleCompletionが
abrupt completion なら、- !
Call (promiseCapability.[[Reject]],undefined , « moduleCompletion.[[Value]] »)を実行する。 unused を返す。
- !
- moduleをmoduleCompletion.[[Value]]とする。
- loadPromiseをmodule.
LoadRequestedModules ()とする。 - promiseCapabilityをcaptureし、呼び出されたときに次のstepsを実行する、parameters (reason)を持つ新しい
Abstract Closure としてrejectedClosureを作成する：- !
Call (promiseCapability.[[Reject]],undefined , « reason »)を実行する。 NormalCompletion (undefined )を返す。
- !
- onRejectedを
CreateBuiltinFunction (rejectedClosure, 1,"" , « »)とする。 - module、promiseCapability、およびonRejectedをcaptureし、呼び出されたときに次のstepsを実行する、parametersを持たない新しい
Abstract Closure としてlinkAndEvaluateClosureを作成する：- linkを
Completion (module.Link ())とする。 - linkが
abrupt completion なら、- !
Call (promiseCapability.[[Reject]],undefined , « link.[[Value]] »)を実行する。 NormalCompletion (undefined )を返す。
- !
- evaluatePromiseをmodule.
Evaluate ()とする。 - moduleおよびpromiseCapabilityをcaptureし、呼び出されたときに次のstepsを実行する、parametersを持たない新しい
Abstract Closure としてfulfilledClosureを作成する：- namespaceを
GetModuleNamespace (module)とする。 - !
Call (promiseCapability.[[Resolve]],undefined , « namespace »)を実行する。 NormalCompletion (undefined )を返す。
- namespaceを
- onFulfilledを
CreateBuiltinFunction (fulfilledClosure, 0,"" , « »)とする。 PerformPromiseThen (evaluatePromise, onFulfilled, onRejected)を実行する。unused を返す。
- linkを
- linkAndEvaluateを
CreateBuiltinFunction (linkAndEvaluateClosure, 0,"" , « »)とする。 PerformPromiseThen (loadPromise, linkAndEvaluate, onRejected)を実行する。unused を返す。
13.3.11 Tagged Templates
tagged templateは、そのcallのargumentsが
13.3.11.1 Runtime Semantics: Evaluation
- tagRefを
MemberExpression の ?Evaluation とする。 - tagFuncを ?
GetValue (tagRef) とする。 - thisCallをthis
MemberExpression とする。 - tailCallを
IsInTailPosition (thisCall)とする。 - ?
EvaluateCall (tagFunc, tagRef,TemplateLiteral , tailCall)を返す。
- tagRefを
CallExpression の ?Evaluation とする。 - tagFuncを ?
GetValue (tagRef) とする。 - thisCallをthis
CallExpression とする。 - tailCallを
IsInTailPosition (thisCall)とする。 - ?
EvaluateCall (tagFunc, tagRef,TemplateLiteral , tailCall)を返す。
13.3.12 Meta Properties
13.3.12.1 Runtime Semantics: Evaluation
GetNewTarget ()を返す。
- moduleを
GetActiveScriptOrModule ()とする。 Assert : moduleはSource Text Module Record である。- importMetaをmodule.[[ImportMeta]]とする。
- importMetaが
empty なら、- importMetaを
OrdinaryObjectCreate (null )に設定する。 - importMetaValuesを
HostGetImportMetaProperties (module)とする。 - importMetaValuesの各
Record { [[Key]], [[Value]] } entryについて、以下を行う- !
CreateDataPropertyOrThrow (importMeta, entry.[[Key]], entry.[[Value]])を実行する。
- !
HostFinalizeImportMeta (importMeta, module)を実行する。- module.[[ImportMeta]]をimportMetaに設定する。
- importMetaを返す。
- importMetaを
Assert : importMetaはObjectである。- importMetaを返す。
13.3.12.1.1 HostGetImportMetaProperties ( moduleRecord )
The import.metaから返されるobjectに
HostGetImportMetaPropertiesのdefault implementationは、新しい空の
13.3.12.1.2 HostFinalizeImportMeta ( importMeta, moduleRecord )
The import.metaから返されるobjectを準備するために任意のextraordinary operationsを実行できるようにします。
ほとんどの
HostFinalizeImportMetaのdefault implementationは、
13.4 Update Expressions
Syntax
13.4.1 Static Semantics: Early Errors
-
LeftHandSideExpression のAssignmentTargetType がinvalid である場合、それはearly Syntax Errorです。
-
UnaryExpression のAssignmentTargetType がinvalid である場合、それはearly Syntax Errorです。
13.4.2 Postfix Increment Operator
13.4.2.1 Runtime Semantics: Evaluation
- lhsを
LeftHandSideExpression の ?Evaluation とする。 LeftHandSideExpression のAssignmentTargetType がweb-compat なら、ReferenceError 例外をthrowする。- oldValueを ?
ToNumeric (?GetValue (lhs)) とする。 - oldValueがNumberなら、
- newValueを
Number::add (oldValue,1 𝔽)とする。
- newValueを
- そうでなければ、
Assert : oldValueはBigIntである。- newValueを
BigInt::add (oldValue,1 ℤ)とする。
- ?
PutValue (lhs, newValue)を実行する。 - oldValueを返す。
13.4.3 Postfix Decrement Operator
13.4.3.1 Runtime Semantics: Evaluation
- lhsを
LeftHandSideExpression の ?Evaluation とする。 LeftHandSideExpression のAssignmentTargetType がweb-compat なら、ReferenceError 例外をthrowする。- oldValueを ?
ToNumeric (?GetValue (lhs)) とする。 - oldValueがNumberなら、
- newValueを
Number::subtract (oldValue,1 𝔽)とする。
- newValueを
- そうでなければ、
Assert : oldValueはBigIntである。- newValueを
BigInt::subtract (oldValue,1 ℤ)とする。
- ?
PutValue (lhs, newValue)を実行する。 - oldValueを返す。
13.4.4 Prefix Increment Operator
13.4.4.1 Runtime Semantics: Evaluation
- exprを
UnaryExpression の ?Evaluation とする。 UnaryExpression のAssignmentTargetType がweb-compat なら、ReferenceError 例外をthrowする。- oldValueを ?
ToNumeric (?GetValue (expr)) とする。 - oldValueがNumberなら、
- newValueを
Number::add (oldValue,1 𝔽)とする。
- newValueを
- そうでなければ、
Assert : oldValueはBigIntである。- newValueを
BigInt::add (oldValue,1 ℤ)とする。
- ?
PutValue (expr, newValue)を実行する。 - newValueを返す。
13.4.5 Prefix Decrement Operator
13.4.5.1 Runtime Semantics: Evaluation
- exprを
UnaryExpression の ?Evaluation とする。 UnaryExpression のAssignmentTargetType がweb-compat なら、ReferenceError 例外をthrowする。- oldValueを ?
ToNumeric (?GetValue (expr)) とする。 - oldValueがNumberなら、
- newValueを
Number::subtract (oldValue,1 𝔽)とする。
- newValueを
- そうでなければ、
Assert : oldValueはBigIntである。- newValueを
BigInt::subtract (oldValue,1 ℤ)とする。
- ?
PutValue (expr, newValue)を実行する。 - newValueを返す。
13.5 Unary Operators
Syntax
補足構文
生成規則のインスタンスを処理する際
13.5.1 The delete Operator
13.5.1.1 Static Semantics: Early Errors
-
IsStrict (theUnaryExpression )がtrue であり、かつderivedUnaryExpression がPrimaryExpression : IdentifierReference MemberExpression : MemberExpression . PrivateIdentifier CallExpression : CallExpression . PrivateIdentifier OptionalChain : ?. PrivateIdentifier OptionalChain : OptionalChain . PrivateIdentifier -
derived
UnaryExpression が
PrimaryExpression : CoverParenthesizedExpressionAndArrowParameterList
であり、かつCoverParenthesizedExpressionAndArrowParameterList が最終的に、UnaryExpression の代わりに使用された場合にこれらのrulesに従ってSyntax Errorを生じるphraseをderiveする場合、それはSyntax Errorです。このruleはrecursiveに適用されます。
最後のruleは、delete (((foo)))のようなexpressionsが、最初のruleのrecursive applicationにより
13.5.1.2 Runtime Semantics: Evaluation
- refを
UnaryExpression の ?Evaluation とする。 - refが
Reference Record でないなら、true を返す。 IsUnresolvableReference (ref)がtrue なら、Assert : ref.[[Strict]]はfalse である。true を返す。
IsPropertyReference (ref)がtrue なら、Assert :IsPrivateReference (ref)はfalse である。IsSuperReference (ref)がtrue なら、ReferenceError 例外をthrowする。- baseObjを ?
ToObject (ref.[[Base]]) とする。 - ref.[[ReferencedName]]が
property key でないなら、- ref.[[ReferencedName]]を ?
ToPropertyKey (ref.[[ReferencedName]]) に設定する。
- ref.[[ReferencedName]]を ?
- deleteStatusを ? baseObj.[[Delete]](ref.[[ReferencedName]]) とする。
- deleteStatusが
false であり、かつref.[[Strict]]がtrue なら、TypeError 例外をthrowする。 - deleteStatusを返す。
- baseをref.[[Base]]とする。
Assert : baseはEnvironment Record である。- ? base.
DeleteBinding (ref.[[ReferencedName]])を返す。
delete operatorがdelete operatorが
step
13.5.2 The void Operator
13.5.2.1 Runtime Semantics: Evaluation
- exprを
UnaryExpression の ?Evaluation とする。 - ?
GetValue (expr)を実行する。 undefined を返す。
その値は使用されませんが、observable side-effectsを持つ場合があるため、
13.5.3 The typeof Operator
13.5.3.1 Runtime Semantics: Evaluation
- valueを
UnaryExpression の ?Evaluation とする。 - valueが
Reference Record なら、IsUnresolvableReference (value)がtrue なら、"undefined" を返す。
- valueを ?
GetValue (value) に設定する。 - valueが
undefined なら、"undefined" を返す。 - valueが
null なら、"object" を返す。 - valueがStringなら、
"string" を返す。 - valueがSymbolなら、
"symbol" を返す。 - valueがBooleanなら、
"boolean" を返す。 - valueがNumberなら、
"number" を返す。 - valueがBigIntなら、
"bigint" を返す。 Assert : valueはObjectである。- hostがweb browserである、またはその他の形で
[[IsHTMLDDA]] Internal Slot をサポートするなら、- valueが[[IsHTMLDDA]] internal slotを持つなら、
"undefined" を返す。
- valueが[[IsHTMLDDA]] internal slotを持つなら、
- valueが[[Call]] internal methodを持つなら、
"function" を返す。 "object" を返す。
13.5.4 Unary + Operator
unary + operatorは、そのoperandをNumber typeへ変換します。
13.5.4.1 Runtime Semantics: Evaluation
- exprを
UnaryExpression の ?Evaluation とする。 - ?
ToNumber (?GetValue (expr))を返す。
13.5.5 Unary - Operator
unary - operatorは、そのoperandをnumeric valueへ変換し、その後それをnegateします。
13.5.5.1 Runtime Semantics: Evaluation
- exprを
UnaryExpression の ?Evaluation とする。 - oldValueを ?
ToNumeric (?GetValue (expr)) とする。 - oldValueがNumberなら、
Number::unaryMinus (oldValue)を返す。 Assert : oldValueはBigIntである。BigInt::unaryMinus (oldValue)を返す。
13.5.6 Bitwise NOT Operator ( ~ )
13.5.6.1 Runtime Semantics: Evaluation
- exprを
UnaryExpression の ?Evaluation とする。 - oldValueを ?
ToNumeric (?GetValue (expr)) とする。 - oldValueがNumberなら、
Number::bitwiseNOT (oldValue)を返す。 Assert : oldValueはBigIntである。BigInt::bitwiseNOT (oldValue)を返す。
13.5.7 Logical NOT Operator ( ! )
13.5.7.1 Runtime Semantics: Evaluation
- exprを
UnaryExpression の ?Evaluation とする。 - oldValueを
ToBoolean (?GetValue (expr))とする。 - oldValueが
true なら、false を返す。 true を返す。
13.6 Exponentiation Operator
Syntax
13.6.1 Runtime Semantics: Evaluation
13.7 Multiplicative Operators
Syntax
*operatorはmultiplicationを実行し、そのoperandsのproductを生成します。/operatorはdivisionを実行し、そのoperandsのquotientを生成します。%operatorは、暗黙のdivisionからそのoperandsのremainderを生成します。
13.7.1 Runtime Semantics: Evaluation
- opTextを
MultiplicativeOperator によってmatchされたsource textとする。 - ?
EvaluateStringOrNumericBinaryExpression (MultiplicativeExpression , opText,ExponentiationExpression )を返す。
13.8 Additive Operators
Syntax
13.8.1 The Addition Operator ( + )
addition operatorは、string concatenationまたはnumeric additionのいずれかを実行します。
13.8.1.1 Runtime Semantics: Evaluation
13.8.2 The Subtraction Operator ( - )
- operatorはsubtractionを実行し、そのoperandsのdifferenceを生成します。
13.8.2.1 Runtime Semantics: Evaluation
13.9 Bitwise Shift Operators
Syntax
13.9.1 The Left Shift Operator ( << )
right operandによって指定された量だけ、left operandに対してbitwise left shift operationを実行します。
13.9.1.1 Runtime Semantics: Evaluation
13.9.2 The Signed Right Shift Operator ( >> )
right operandによって指定された量だけ、left operandに対してsign-filling bitwise right shift operationを実行します。
13.9.2.1 Runtime Semantics: Evaluation
13.9.3 The Unsigned Right Shift Operator ( >>> )
right operandによって指定された量だけ、left operandに対してzero-filling bitwise right shift operationを実行します。
13.9.3.1 Runtime Semantics: Evaluation
13.10 Relational Operators
relational operatorを評価した結果は常に
Syntax
[In] grammar parameterは、relational expression内のin operatorとfor statement内のin operatorを混同することを避けるために必要です。
13.10.1 Runtime Semantics: Evaluation
- leftRefを
RelationalExpression の ?Evaluation とする。 - leftValueを ?
GetValue (leftRef) とする。 - rightRefを
ShiftExpression の ?Evaluation とする。 - rightValueを ?
GetValue (rightRef) とする。 - resultを ?
IsLessThan (leftValue, rightValue,true ) とする。 - resultが
undefined なら、false を返す。 - resultを返す。
- leftRefを
RelationalExpression の ?Evaluation とする。 - leftValueを ?
GetValue (leftRef) とする。 - rightRefを
ShiftExpression の ?Evaluation とする。 - rightValueを ?
GetValue (rightRef) とする。 - resultを ?
IsLessThan (rightValue, leftValue,false ) とする。 - resultが
undefined なら、false を返す。 - resultを返す。
- leftRefを
RelationalExpression の ?Evaluation とする。 - leftValueを ?
GetValue (leftRef) とする。 - rightRefを
ShiftExpression の ?Evaluation とする。 - rightValueを ?
GetValue (rightRef) とする。 - resultを ?
IsLessThan (rightValue, leftValue,false ) とする。 - resultが
true またはundefined のいずれかなら、false を返す。 true を返す。
- leftRefを
RelationalExpression の ?Evaluation とする。 - leftValueを ?
GetValue (leftRef) とする。 - rightRefを
ShiftExpression の ?Evaluation とする。 - rightValueを ?
GetValue (rightRef) とする。 - resultを ?
IsLessThan (leftValue, rightValue,true ) とする。 - resultが
true またはundefined のいずれかなら、false を返す。 true を返す。
- leftRefを
RelationalExpression の ?Evaluation とする。 - leftValueを ?
GetValue (leftRef) とする。 - rightRefを
ShiftExpression の ?Evaluation とする。 - rightValueを ?
GetValue (rightRef) とする。 - ?
InstanceofOperator (leftValue, rightValue)を返す。
- leftRefを
RelationalExpression の ?Evaluation とする。 - leftValueを ?
GetValue (leftRef) とする。 - rightRefを
ShiftExpression の ?Evaluation とする。 - rightValueを ?
GetValue (rightRef) とする。 - rightValueがObjectでないなら、
TypeError 例外をthrowする。 - ?
HasProperty (rightValue, ?ToPropertyKey (leftValue))を返す。
- privateIdentifierを
PrivateIdentifier のStringValue とする。 - rightRefを
ShiftExpression の ?Evaluation とする。 - rightValueを ?
GetValue (rightRef) とする。 - rightValueがObjectでないなら、
TypeError 例外をthrowする。 - privateEnvを
running execution context のPrivateEnvironmentとする。 Assert : privateEnvはnull でない。- privateNameを
ResolvePrivateIdentifier (privateEnv, privateIdentifier)とする。 PrivateElementFind (rightValue, privateName)がempty なら、false を返す。true を返す。
13.10.2 InstanceofOperator ( value, target )
The abstract operation InstanceofOperator takes arguments value (an ECMAScript language value) and target (an ECMAScript language value) and returns either a
- targetがObjectでないなら、
TypeError 例外をthrowする。 - instOfHandlerを ?
GetMethod (target,%Symbol.hasInstance% ) とする。 - instOfHandlerが
undefined でないなら、 IsCallable (target)がfalse なら、TypeError 例外をthrowする。- ?
OrdinaryHasInstance (target, value)を返す。
Steps instanceof operator semanticsを定義するためにinstanceof semanticsを使用します。
13.11 Equality Operators
equality operatorを評価した結果は常に
Syntax
13.11.1 Runtime Semantics: Evaluation
- leftRefを
EqualityExpression の ?Evaluation とする。 - leftValueを ?
GetValue (leftRef) とする。 - rightRefを
RelationalExpression の ?Evaluation とする。 - rightValueを ?
GetValue (rightRef) とする。 - ?
IsLooselyEqual (rightValue, leftValue)を返す。
- leftRefを
EqualityExpression の ?Evaluation とする。 - leftValueを ?
GetValue (leftRef) とする。 - rightRefを
RelationalExpression の ?Evaluation とする。 - rightValueを ?
GetValue (rightRef) とする。 - resultを ?
IsLooselyEqual (rightValue, leftValue) とする。 - resultが
true なら、false を返す。 true を返す。
- leftRefを
EqualityExpression の ?Evaluation とする。 - leftValueを ?
GetValue (leftRef) とする。 - rightRefを
RelationalExpression の ?Evaluation とする。 - rightValueを ?
GetValue (rightRef) とする。 IsStrictlyEqual (rightValue, leftValue)を返す。
- leftRefを
EqualityExpression の ?Evaluation とする。 - leftValueを ?
GetValue (leftRef) とする。 - rightRefを
RelationalExpression の ?Evaluation とする。 - rightValueを ?
GetValue (rightRef) とする。 - resultを
IsStrictlyEqual (rightValue, leftValue)とする。 - resultが
true なら、false を返す。 true を返す。
equality operatorsは次のinvariantsを維持します：
-
A != Bは!(A == B)と等価です。 -
A == Bは、AおよびBのevaluation順序を除き、B == Aと等価です。
equality operatorは常にtransitiveであるとは限りません。例えば、同じString値を表す2つのdistinct String objectsが存在する場合があります；各String objectは== operatorによってString値と等しいとみなされますが、2つのString objectsは互いに等しいとはみなされません。例えば：
-
new String("a") == "a"および"a" == new String("a")はいずれもtrue です。 -
new String("a") == new String("a")はfalse です。
Stringsのcomparisonは、code unit valuesのsequencesに対する単純なequality testを使用します。Unicode specificationで定義される、より複雑でsemantically orientedなcharacterまたはstring equalityおよびcollating orderのdefinitionsを使用する試みはありません。したがって、Unicode Standardに従ってcanonically equalであるStrings valuesが、unequalとしてtestされる可能性があります。実際には、このalgorithmは両方のStringsがすでにnormalized formにあると仮定します。
13.12 Binary Bitwise Operators
Syntax
13.12.1 Runtime Semantics: Evaluation
13.13 Binary Logical Operators
Syntax
&&または|| operatorによって生成される値は、必ずしも
13.13.1 Runtime Semantics: Evaluation
- leftRefを
LogicalANDExpression の ?Evaluation とする。 - leftValueを ?
GetValue (leftRef) とする。 ToBoolean (leftValue)がfalse なら、leftValueを返す。- rightRefを
BitwiseORExpression の ?Evaluation とする。 - ?
GetValue (rightRef)を返す。
- leftRefを
LogicalORExpression の ?Evaluation とする。 - leftValueを ?
GetValue (leftRef) とする。 ToBoolean (leftValue)がtrue なら、leftValueを返す。- rightRefを
LogicalANDExpression の ?Evaluation とする。 - ?
GetValue (rightRef)を返す。
- leftRefを
CoalesceExpressionHead の ?Evaluation とする。 - leftValueを ?
GetValue (leftRef) とする。 - leftValueが
undefined でもnull でもないなら、leftValueを返す。 - rightRefを
BitwiseORExpression の ?Evaluation とする。 - ?
GetValue (rightRef)を返す。
13.14 Conditional Operator ( ? : )
Syntax
ECMAScriptにおける
13.14.1 Runtime Semantics: Evaluation
- leftRefを
ShortCircuitExpression の ?Evaluation とする。 - leftValueを
ToBoolean (?GetValue (leftRef))とする。 - leftValueが
true なら、- trueRefを最初の
AssignmentExpression の ?Evaluation とする。 - ?
GetValue (trueRef)を返す。
- trueRefを最初の
- falseRefを2番目の
AssignmentExpression の ?Evaluation とする。 - ?
GetValue (falseRef)を返す。
13.15 Assignment Operators
Syntax
13.15.1 Static Semantics: Early Errors
-
LeftHandSideExpression がObjectLiteral またはArrayLiteral のいずれかである場合、LeftHandSideExpression はAssignmentPattern をcoverしなければなりません。 -
LeftHandSideExpression がObjectLiteral でもArrayLiteral でもない場合、LeftHandSideExpression のAssignmentTargetType がinvalid であるなら、それはSyntax Errorです。
-
LeftHandSideExpression のAssignmentTargetType がinvalid である場合、それはSyntax Errorです。
-
LeftHandSideExpression のAssignmentTargetType がsimple でない場合、それはSyntax Errorです。
13.15.2 Runtime Semantics: Evaluation
LeftHandSideExpression がObjectLiteral でもArrayLiteral でもないなら、- leftRefを
LeftHandSideExpression の ?Evaluation とする。 LeftHandSideExpression のAssignmentTargetType がweb-compat なら、ReferenceError 例外をthrowする。IsAnonymousFunctionDefinition (AssignmentExpression )がtrue であり、かつLeftHandSideExpression のIsIdentifierRef がtrue なら、- lhsを
LeftHandSideExpression のStringValue とする。 - rightValueを、引数lhsを伴う
AssignmentExpression の ?NamedEvaluation とする。
- lhsを
- そうでなければ、
- rightRefを
AssignmentExpression の ?Evaluation とする。 - rightValueを ?
GetValue (rightRef) とする。
- rightRefを
- ?
PutValue (leftRef, rightValue)を実行する。 - rightValueを返す。
- leftRefを
- assignmentPatternを
LeftHandSideExpression によってcoverされるAssignmentPattern とする。 - rightRefを
AssignmentExpression の ?Evaluation とする。 - rightValueを ?
GetValue (rightRef) とする。 - 引数rightValueを伴うassignmentPatternの ?
DestructuringAssignmentEvaluation を実行する。 - rightValueを返す。
- leftRefを
LeftHandSideExpression の ?Evaluation とする。 LeftHandSideExpression のAssignmentTargetType がweb-compat なら、ReferenceError 例外をthrowする。- leftValueを ?
GetValue (leftRef) とする。 - rightRefを
AssignmentExpression の ?Evaluation とする。 - rightValueを ?
GetValue (rightRef) とする。 - assignmentOpTextを
AssignmentOperator によってmatchされたsource textとする。 - opTextを、次のtable内でassignmentOpTextに関連付けられたUnicode code pointsのsequenceとする：
assignmentOpText opText **=***=*/=/%=%+=+-=-<<=<<>>=>>>>>=>>>&=&^=^|=| - resultを ?
ApplyStringOrNumericBinaryOperator (leftValue, opText, rightValue) とする。 - ?
PutValue (leftRef, result)を実行する。 - resultを返す。
- leftRefを
LeftHandSideExpression の ?Evaluation とする。 - leftValueを ?
GetValue (leftRef) とする。 ToBoolean (leftValue)がfalse なら、leftValueを返す。IsAnonymousFunctionDefinition (AssignmentExpression )がtrue であり、かつLeftHandSideExpression のIsIdentifierRef がtrue なら、- lhsを
LeftHandSideExpression のStringValue とする。 - rightValueを、引数lhsを伴う
AssignmentExpression の ?NamedEvaluation とする。
- lhsを
- そうでなければ、
- rightRefを
AssignmentExpression の ?Evaluation とする。 - rightValueを ?
GetValue (rightRef) とする。
- rightRefを
- ?
PutValue (leftRef, rightValue)を実行する。 - rightValueを返す。
- leftRefを
LeftHandSideExpression の ?Evaluation とする。 - leftValueを ?
GetValue (leftRef) とする。 ToBoolean (leftValue)がtrue なら、leftValueを返す。IsAnonymousFunctionDefinition (AssignmentExpression )がtrue であり、かつLeftHandSideExpression のIsIdentifierRef がtrue なら、- lhsを
LeftHandSideExpression のStringValue とする。 - rightValueを、引数lhsを伴う
AssignmentExpression の ?NamedEvaluation とする。
- lhsを
- そうでなければ、
- rightRefを
AssignmentExpression の ?Evaluation とする。 - rightValueを ?
GetValue (rightRef) とする。
- rightRefを
- ?
PutValue (leftRef, rightValue)を実行する。 - rightValueを返す。
- leftRefを
LeftHandSideExpression の ?Evaluation とする。 - leftValueを ?
GetValue (leftRef) とする。 - leftValueが
undefined でもnull でもないなら、leftValueを返す。 IsAnonymousFunctionDefinition (AssignmentExpression )がtrue であり、かつLeftHandSideExpression のIsIdentifierRef がtrue なら、- lhsを
LeftHandSideExpression のStringValue とする。 - rightValueを、引数lhsを伴う
AssignmentExpression の ?NamedEvaluation とする。
- lhsを
- そうでなければ、
- rightRefを
AssignmentExpression の ?Evaluation とする。 - rightValueを ?
GetValue (rightRef) とする。
- rightRefを
- ?
PutValue (leftRef, rightValue)を実行する。 - rightValueを返す。
このexpressionが
13.15.3 ApplyStringOrNumericBinaryOperator ( leftValue, opText, rightValue )
The abstract operation ApplyStringOrNumericBinaryOperator takes arguments leftValue (an ECMAScript language value), opText (**, *, /, %, +, -, <<, >>, >>>, &, ^, or |), and rightValue (an ECMAScript language value) and returns either a
- opTextが
+なら、- leftPrimitiveを ?
ToPrimitive (leftValue) とする。 - rightPrimitiveを ?
ToPrimitive (rightValue) とする。 - leftPrimitiveがStringまたはrightPrimitiveがStringなら、
- leftStringを ?
ToString (leftPrimitive) とする。 - rightStringを ?
ToString (rightPrimitive) とする。 - leftStringとrightStringの
string-concatenation を返す。
- leftStringを ?
- leftValueをleftPrimitiveに設定する。
- rightValueをrightPrimitiveに設定する。
- leftPrimitiveを ?
NOTE : この時点では、numeric operationでなければならない。- leftNumberを ?
ToNumeric (leftValue) とする。 - rightNumberを ?
ToNumeric (rightValue) とする。 SameType (leftNumber, rightNumber)がfalse なら、TypeError 例外をthrowする。- leftNumberがBigIntなら、
- opTextが
**なら、?BigInt::exponentiate (leftNumber, rightNumber)を返す。 - opTextが
/なら、?BigInt::divide (leftNumber, rightNumber)を返す。 - opTextが
%なら、?BigInt::remainder (leftNumber, rightNumber)を返す。 - opTextが
>>>なら、?BigInt::unsignedRightShift (leftNumber, rightNumber)を返す。 - operationを、次のtable内でopTextに関連付けられたabstract operationとする：
opText operation *BigInt::multiply +BigInt::add -BigInt::subtract <<BigInt::leftShift >>BigInt::signedRightShift &BigInt::bitwiseAND ^BigInt::bitwiseXOR |BigInt::bitwiseOR
- opTextが
- そうでなければ、
Assert : leftNumberはNumberである。- operationを、次のtable内でopTextに関連付けられたabstract operationとする：
opText operation **Number::exponentiate *Number::multiply /Number::divide %Number::remainder +Number::add -Number::subtract <<Number::leftShift >>Number::signedRightShift >>>Number::unsignedRightShift &Number::bitwiseAND ^Number::bitwiseXOR |Number::bitwiseOR
- operation(leftNumber, rightNumber)を返す。
steps
Step
13.15.4 EvaluateStringOrNumericBinaryExpression ( leftOperand, opText, rightOperand )
The abstract operation EvaluateStringOrNumericBinaryExpression takes arguments leftOperand (a **, *, /, %, +, -, <<, >>, >>>, &, ^, or |), and rightOperand (a
- leftRefをleftOperandの ?
Evaluation とする。 - leftValueを ?
GetValue (leftRef) とする。 - rightRefをrightOperandの ?
Evaluation とする。 - rightValueを ?
GetValue (rightRef) とする。 - ?
ApplyStringOrNumericBinaryOperator (leftValue, opText, rightValue)を返す。
13.15.5 Destructuring Assignment
Supplemental Syntax
特定の状況で、production
のinstanceを処理するとき、
13.15.5.1 Static Semantics: Early Errors
-
IdentifierReference のAssignmentTargetType がsimple でない場合、それはSyntax Errorです。
-
DestructuringAssignmentTarget がArrayLiteral またはObjectLiteral のいずれかである場合、それはSyntax Errorです。
-
LeftHandSideExpression がObjectLiteral またはArrayLiteral のいずれかである場合、LeftHandSideExpression はAssignmentPattern をcoverしなければなりません。 -
LeftHandSideExpression がObjectLiteral でもArrayLiteral でもない場合、LeftHandSideExpression のAssignmentTargetType がsimple でないなら、それはSyntax Errorです。
13.15.5.2 Runtime Semantics: DestructuringAssignmentEvaluation
The
- ?
RequireObjectCoercible (value)を実行する。 unused を返す。
- ?
RequireObjectCoercible (value)を実行する。 - 引数valueを伴う
AssignmentPropertyList の ?PropertyDestructuringAssignmentEvaluation を実行する。 unused を返す。
- ?
RequireObjectCoercible (value)を実行する。 - excludedNamesを新しい空の
List とする。 - 引数valueおよびexcludedNamesを伴う
AssignmentRestProperty の ?RestDestructuringAssignmentEvaluation を返す。
- ?
RequireObjectCoercible (value)を実行する。 - excludedNamesを、引数valueを伴う
AssignmentPropertyList の ?PropertyDestructuringAssignmentEvaluation とする。 - 引数valueおよびexcludedNamesを伴う
AssignmentRestProperty の ?RestDestructuringAssignmentEvaluation を返す。
- iteratorRecordを ?
GetIterator (value,sync ) とする。 - ?
IteratorClose (iteratorRecord,NormalCompletion (unused ))を返す。
- iteratorRecordを ?
GetIterator (value,sync ) とする。 - resultを、引数iteratorRecordを伴う
Elision のIteratorDestructuringAssignmentEvaluation のCompletion とする。 - iteratorRecord.[[Done]]が
false なら、?IteratorClose (iteratorRecord, result)を返す。 - resultを返す。
- iteratorRecordを ?
GetIterator (value,sync ) とする。 Elision が存在するなら、- statusを、引数iteratorRecordを伴う
Elision のIteratorDestructuringAssignmentEvaluation のCompletion とする。 - statusが
abrupt completion なら、Assert : iteratorRecord.[[Done]]はtrue である。- ? statusを返す。
- statusを、引数iteratorRecordを伴う
- resultを、引数iteratorRecordを伴う
AssignmentRestElement のIteratorDestructuringAssignmentEvaluation のCompletion とする。 - iteratorRecord.[[Done]]が
false なら、?IteratorClose (iteratorRecord, result)を返す。 - resultを返す。
- iteratorRecordを ?
GetIterator (value,sync ) とする。 - resultを、引数iteratorRecordを伴う
AssignmentElementList のIteratorDestructuringAssignmentEvaluation のCompletion とする。 - iteratorRecord.[[Done]]が
false なら、?IteratorClose (iteratorRecord, result)を返す。 - resultを返す。
- iteratorRecordを ?
GetIterator (value,sync ) とする。 - statusを、引数iteratorRecordを伴う
AssignmentElementList のIteratorDestructuringAssignmentEvaluation のCompletion とする。 - statusが
abrupt completion なら、- iteratorRecord.[[Done]]が
false なら、?IteratorClose (iteratorRecord, status)を返す。 - ? statusを返す。
- iteratorRecord.[[Done]]が
Elision が存在するなら、- statusを、引数iteratorRecordを伴う
Elision のIteratorDestructuringAssignmentEvaluation のCompletion に設定する。 - statusが
abrupt completion なら、Assert : iteratorRecord.[[Done]]はtrue である。- ? statusを返す。
- statusを、引数iteratorRecordを伴う
AssignmentRestElement が存在するなら、- statusを、引数iteratorRecordを伴う
AssignmentRestElement のIteratorDestructuringAssignmentEvaluation のCompletion に設定する。
- statusを、引数iteratorRecordを伴う
- iteratorRecord.[[Done]]が
false なら、?IteratorClose (iteratorRecord, status)を返す。 - ? statusを返す。
13.15.5.3 Runtime Semantics: PropertyDestructuringAssignmentEvaluation
The
- propertyNamesを、引数valueを伴う
AssignmentPropertyList の ?PropertyDestructuringAssignmentEvaluation とする。 - nextNamesを、引数valueを伴う
AssignmentProperty の ?PropertyDestructuringAssignmentEvaluation とする。 - propertyNamesとnextNamesの
list-concatenation を返す。
- propertyNameを
IdentifierReference のStringValue とする。 - leftRefを ?
ResolveBinding (propertyName) とする。 - valueを ?
GetV (value, propertyName) に設定する。 Initializer が存在し、かつvalueがundefined なら、IsAnonymousFunctionDefinition (Initializer )がtrue なら、- valueを、引数propertyNameを伴う
Initializer の ?NamedEvaluation に設定する。
- valueを、引数propertyNameを伴う
- そうでなければ、
- defaultValueを
Initializer の ?Evaluation とする。 - valueを ?
GetValue (defaultValue) に設定する。
- defaultValueを
- ?
PutValue (leftRef, value)を実行する。 - « propertyName »を返す。
- nameを
PropertyName の ?Evaluation とする。 - 引数valueおよびnameを伴う
AssignmentElement の ?KeyedDestructuringAssignmentEvaluation を実行する。 - « name »を返す。
13.15.5.4 Runtime Semantics: RestDestructuringAssignmentEvaluation
The
- leftRefを
DestructuringAssignmentTarget の ?Evaluation とする。 - restObjを
OrdinaryObjectCreate (%Object.prototype% )とする。 - ?
CopyDataProperties (restObj, value, excludedNames)を実行する。 - ?
PutValue (leftRef, restObj)を返す。
13.15.5.5 Runtime Semantics: IteratorDestructuringAssignmentEvaluation
The
- 引数iteratorRecordを伴う
AssignmentElisionElement の ?IteratorDestructuringAssignmentEvaluation を返す。
- 引数iteratorRecordを伴う
AssignmentElementList の ?IteratorDestructuringAssignmentEvaluation を実行する。 - 引数iteratorRecordを伴う
AssignmentElisionElement の ?IteratorDestructuringAssignmentEvaluation を返す。
- 引数iteratorRecordを伴う
AssignmentElement の ?IteratorDestructuringAssignmentEvaluation を返す。
- 引数iteratorRecordを伴う
Elision の ?IteratorDestructuringAssignmentEvaluation を実行する。 - 引数iteratorRecordを伴う
AssignmentElement の ?IteratorDestructuringAssignmentEvaluation を返す。
- iteratorRecord.[[Done]]が
false なら、- ?
IteratorStep (iteratorRecord)を実行する。
- ?
unused を返す。
- 引数iteratorRecordを伴う
Elision の ?IteratorDestructuringAssignmentEvaluation を実行する。 - iteratorRecord.[[Done]]が
false なら、- ?
IteratorStep (iteratorRecord)を実行する。
- ?
unused を返す。
DestructuringAssignmentTarget がObjectLiteral でもArrayLiteral でもないなら、- leftRefを
DestructuringAssignmentTarget の ?Evaluation とする。
- leftRefを
- valueを
undefined とする。 - iteratorRecord.[[Done]]が
false なら、- nextを ?
IteratorStepValue (iteratorRecord) とする。 - nextが
done でないなら、- valueをnextに設定する。
- nextを ?
Initializer が存在し、かつvalueがundefined なら、IsAnonymousFunctionDefinition (Initializer )がtrue であり、かつDestructuringAssignmentTarget のIsIdentifierRef がtrue なら、- targetを
DestructuringAssignmentTarget のStringValue とする。 - vを、引数targetを伴う
Initializer の ?NamedEvaluation とする。
- targetを
- そうでなければ、
- defaultValueを
Initializer の ?Evaluation とする。 - vを ?
GetValue (defaultValue) とする。
- defaultValueを
- そうでなければ、
- vをvalueとする。
DestructuringAssignmentTarget がObjectLiteral またはArrayLiteral のいずれかなら、- nestedAssignmentPatternを
DestructuringAssignmentTarget によってcoverされるAssignmentPattern とする。 - 引数vを伴うnestedAssignmentPatternの ?
DestructuringAssignmentEvaluation を返す。
- nestedAssignmentPatternを
- ?
PutValue (leftRef, v)を返す。
left to right evaluation orderは、
DestructuringAssignmentTarget がObjectLiteral でもArrayLiteral でもないなら、- leftRefを
DestructuringAssignmentTarget の ?Evaluation とする。
- leftRefを
- arrayを !
ArrayCreate (0) とする。 - nを0とする。
- iteratorRecord.[[Done]]が
false である間、繰り返す- nextを ?
IteratorStepValue (iteratorRecord) とする。 - nextが
done でないなら、- !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (n)), next)を実行する。 - nをn + 1に設定する。
- !
- nextを ?
DestructuringAssignmentTarget がObjectLiteral でもArrayLiteral でもないなら、- ?
PutValue (leftRef, array)を返す。
- ?
- nestedAssignmentPatternを
DestructuringAssignmentTarget によってcoverされるAssignmentPattern とする。 - 引数arrayを伴うnestedAssignmentPatternの ?
DestructuringAssignmentEvaluation を返す。
13.15.5.6 Runtime Semantics: KeyedDestructuringAssignmentEvaluation
The
DestructuringAssignmentTarget がObjectLiteral でもArrayLiteral でもないなら、- leftRefを
DestructuringAssignmentTarget の ?Evaluation とする。
- leftRefを
- valueを ?
GetV (value, propertyName) に設定する。 Initializer が存在し、かつvalueがundefined なら、IsAnonymousFunctionDefinition (Initializer )がtrue であり、かつDestructuringAssignmentTarget のIsIdentifierRef がtrue なら、- targetを
DestructuringAssignmentTarget のStringValue とする。 - rhsValueを、引数targetを伴う
Initializer の ?NamedEvaluation とする。
- targetを
- そうでなければ、
- defaultValueを
Initializer の ?Evaluation とする。 - rhsValueを ?
GetValue (defaultValue) とする。
- defaultValueを
- そうでなければ、
- rhsValueをvalueとする。
DestructuringAssignmentTarget がObjectLiteral またはArrayLiteral のいずれかなら、- assignmentPatternを
DestructuringAssignmentTarget によってcoverされるAssignmentPattern とする。 - 引数rhsValueを伴うassignmentPatternの ?
DestructuringAssignmentEvaluation を返す。
- assignmentPatternを
- ?
PutValue (leftRef, rhsValue)を返す。
13.16 Comma Operator ( , )
Syntax
13.16.1 Runtime Semantics: Evaluation
- leftRefを
Expression の ?Evaluation とする。 - ?
GetValue (leftRef)を実行する。 - rightRefを
AssignmentExpression の ?Evaluation とする。 - ?
GetValue (rightRef)を返す。
その値は使用されませんが、observable side-effectsを持つ場合があるため、
14 ECMAScript Language: Statements and Declarations
Syntax
14.1 Statement Semantics
14.1.1 Runtime Semantics: Evaluation
empty を返す。
FunctionDeclaration の ?Evaluation を返す。
- newLabelSetを新しい空の
List とする。 - 引数newLabelSetを伴うthis
BreakableStatement の ?LabelledEvaluation を返す。
14.2 Block
Syntax
14.2.1 Static Semantics: Early Errors
-
StatementList のLexicallyDeclaredNames が重複entriesを含む場合、それはSyntax Errorです。ただし、hostがweb browserである、またはその他の形でBlock-Level Function Declarations Web Legacy Compatibility Semantics をサポートし、かつ次の両方の条件がtrueである場合を除きます：IsStrict (this production)がfalse である。- 重複entriesはFunctionDeclarationsによってのみboundされる。
-
StatementList のLexicallyDeclaredNames のいずれかの要素がStatementList のVarDeclaredNames にも出現する場合、それはSyntax Errorです。
14.2.2 Runtime Semantics: Evaluation
empty を返す。
- oldEnv を、実行中の実行コンテキストの LexicalEnvironment とする。
- blockEnv を
NewDeclarativeEnvironment (oldEnv) とする。 BlockDeclarationInstantiation (StatementList , blockEnv) を実行する。- 実行中の実行コンテキストの LexicalEnvironment を blockEnv に設定する。
- blockValue を
StatementList のEvaluation のCompletion とする。 - blockValue を
Completion (DisposeResources (blockEnv.[[DisposableResourceStack]], blockValue)) に設定する。 - 実行中の実行コンテキストの LexicalEnvironment を oldEnv に設定する。
- Return ? blockValue.
controlがどのように
- slを
StatementList の ?Evaluation とする。 - sを
StatementListItem のEvaluation のCompletion とする。 - ?
UpdateEmpty (s, sl)を返す。
eval functionへのcallsはすべて値1を返します：
eval("1;;;;;")
eval("1;{}")
eval("1;var a;")14.2.3 BlockDeclarationInstantiation ( code, envRecord )
The abstract operation BlockDeclarationInstantiation takes arguments code (a
これは呼び出されたとき、次のstepsを実行します：
- codeの
LexicallyScopedDeclarations をdeclsとする。 - 実行中の実行コンテキストのPrivateEnvironmentをprivateEnvとする。
- declsの各要素declについて、次を行う。
- declの
BoundNames の各要素nameについて、次を行う。- declの
IsConstantDeclaration がtrue である場合、- ! envRecord.
CreateImmutableBinding (name,true )を実行する。
- ! envRecord.
- そうでなければ、
ホスト がWebブラウザである、またはその他の形でBlock-Level Function Declarations Web Legacy Compatibility Semantics をサポートする場合、- ! envRecord.
HasBinding (name)がfalse である場合、- ! envRecord.
CreateMutableBinding (name,false )を実行する。
- ! envRecord.
- ! envRecord.
- そうでなければ、
- ! envRecord.
CreateMutableBinding (name,false )を実行する。
- ! envRecord.
- declの
- declが
FunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 、またはAsyncGeneratorDeclaration のいずれかである場合、- declの
BoundNames の唯一の要素をfuncNameとする。 - envRecordおよびprivateEnvを引数として、declの
InstantiateFunctionObject をfuncObjとする。 ホスト がWebブラウザである、またはその他の形でBlock-Level Function Declarations Web Legacy Compatibility Semantics をサポートする場合、- envRecord内のfuncNameに対する束縛が未初期化束縛である場合、
- ! envRecord.
InitializeBinding (funcName, funcObj)を実行する。
- ! envRecord.
- そうでなければ、
Assert : declはFunctionDeclaration である。- ! envRecord.
SetMutableBinding (funcName, funcObj,false )を実行する。
- envRecord内のfuncNameに対する束縛が未初期化束縛である場合、
- そうでなければ、
- ! envRecord.
InitializeBinding (funcName, funcObj)を実行する。
- ! envRecord.
- declの
- declの
unused を返す。
14.3 Declarations and the Variable Statement
14.3.1 Let、Const、Using、および Await Using 宣言
let、const、using、および await using 宣言は、実行中の実行コンテキストの LexicalEnvironment にスコープされる変数を定義する。変数は、それを含む let 宣言内の
構文
補足構文
生成規則のインスタンスを処理する際
14.3.1.1 Static Semantics: 早期エラー
-
BindingList のBoundNames が"let" を含む場合、Syntax Error である。 -
BindingList のBoundNames が重複する項目を含む場合、Syntax Error である。
-
BindingList のBoundNames が"let" を含む場合、Syntax Error である。 -
BindingList のBoundNames が重複する項目を含む場合、Syntax Error である。
CoverAwaitExpressionAndAwaitUsingDeclarationHead はAwaitUsingDeclarationHead をカバーしなければならない。-
BindingList のBoundNames が"let" を含む場合、Syntax Error である。 -
BindingList のBoundNames が重複する項目を含む場合、Syntax Error である。
-
Initializer が存在せず、かつこのLexicalBinding を含むLexicalDeclaration のIsConstantDeclaration がtrue である場合、Syntax Error である。
14.3.1.2 Runtime Semantics: Evaluation
- 引数
normal でBindingList のBindingEvaluation を実行する。 empty を返す。
- 引数
sync-dispose でBindingList のBindingEvaluation を実行する。 empty を返す。
- 引数
async-dispose でBindingList のBindingEvaluation を実行する。 empty を返す。
14.3.1.3 Runtime Semantics: BindingEvaluation
The
- 引数 kind で、派生した
BindingList のBindingEvaluation を実行する。 - 引数 kind で
LexicalBinding のBindingEvaluation を返す。
Assert : kind はnormal である。- lhs を !
ResolveBinding (BindingIdentifier のStringValue ) とする。 - !
InitializeReferencedBinding (lhs,undefined ) を実行する。 unused を返す。
静的意味論の規則により、この形式の const、using、または await using 宣言では決して発生しないことが保証される。
- bindingId を
BindingIdentifier のStringValue とする。 - lhs を !
ResolveBinding (bindingId) とする。 IsAnonymousFunctionDefinition (Initializer ) がtrue である場合、then- value を、引数 bindingId で
Initializer のNamedEvaluation とする。
- value を、引数 bindingId で
- Else,
- rhs を
Initializer のEvaluation とする。 - value を ?
GetValue (rhs) とする。
- rhs を
- kind が
normal でない場合、thenAssert :IsUnresolvableReference (lhs) はfalse である。- base を lhs.[[Base]] とする。
Assert : base はDeclarative Environment Record である。- ?
AddDisposableResource (base.[[DisposableResourceStack]], value, kind) を実行する。
- ?
InitializeReferencedBinding (lhs, value) を実行する。 unused を返す。
Assert : kind はnormal である。- rhs を
Initializer のEvaluation とする。 - value を ?
GetValue (rhs) とする。 - envRecord を、実行中の実行コンテキストの LexicalEnvironment とする。
- 引数 value および envRecord で、
BindingPattern のBindingInitialization を返す。
14.3.2 Variable Statement
var statementは、
Syntax
14.3.2.1 Runtime Semantics: Evaluation
VariableDeclarationList の ?Evaluation を実行する。empty を返す。
VariableDeclarationList の ?Evaluation を実行する。VariableDeclaration の ?Evaluation を返す。
empty を返す。
- bindingIdを
BindingIdentifier のStringValue とする。 - lhsを ?
ResolveBinding (bindingId) とする。 IsAnonymousFunctionDefinition (Initializer )がtrue なら、- valueを、引数bindingIdを伴う
Initializer の ?NamedEvaluation とする。
- valueを、引数bindingIdを伴う
- そうでなければ、
- rhsを
Initializer の ?Evaluation とする。 - valueを ?
GetValue (rhs) とする。
- rhsを
- ?
PutValue (lhs, value)を実行する。 empty を返す。
- rhsを
Initializer の ?Evaluation とする。 - rightValueを ?
GetValue (rhs) とする。 - 引数rightValueおよび
undefined を伴うBindingPattern の ?BindingInitialization を返す。
14.3.3 Destructuring Binding Patterns
Syntax
14.3.3.1 Runtime Semantics: PropertyBindingInitialization
The
- boundNamesを、引数valueおよびenvRecordを伴う
BindingPropertyList の ?PropertyBindingInitialization とする。 - nextNamesを、引数valueおよびenvRecordを伴う
BindingProperty の ?PropertyBindingInitialization とする。 - boundNamesとnextNamesの
list-concatenation を返す。
- nameを
SingleNameBinding のBoundNames の唯一の要素とする。 - 引数value、envRecord、およびnameを伴う
SingleNameBinding の ?KeyedBindingInitialization を実行する。 - « name »を返す。
- propertyKeyを
PropertyName の ?Evaluation とする。 - 引数value、envRecord、およびpropertyKeyを伴う
BindingElement の ?KeyedBindingInitialization を実行する。 - « propertyKey »を返す。
14.3.3.2 Runtime Semantics: RestBindingInitialization
The
- lhsを ?
ResolveBinding (BindingIdentifier のStringValue , envRecord) とする。 - restObjを
OrdinaryObjectCreate (%Object.prototype% )とする。 - ?
CopyDataProperties (restObj, value, excludedNames)を実行する。 - envRecordが
undefined なら、?PutValue (lhs, restObj)を返す。 - ?
InitializeReferencedBinding (lhs, restObj)を返す。
14.3.3.3 Runtime Semantics: KeyedBindingInitialization
The
envRecordに
It is defined piecewise over the following productions:
- valueを ?
GetV (value, propertyName) に設定する。 Initializer が存在し、かつvalueがundefined なら、- defaultValueを
Initializer の ?Evaluation とする。 - valueを ?
GetValue (defaultValue) に設定する。
- defaultValueを
- 引数valueおよびenvRecordを伴う
BindingPattern の ?BindingInitialization を返す。
- bindingIdを
BindingIdentifier のStringValue とする。 - lhsを ?
ResolveBinding (bindingId, envRecord) とする。 - valueを ?
GetV (value, propertyName) に設定する。 Initializer が存在し、かつvalueがundefined なら、IsAnonymousFunctionDefinition (Initializer )がtrue なら、- valueを、引数bindingIdを伴う
Initializer の ?NamedEvaluation に設定する。
- valueを、引数bindingIdを伴う
- そうでなければ、
- defaultValueを
Initializer の ?Evaluation とする。 - valueを ?
GetValue (defaultValue) に設定する。
- defaultValueを
- envRecordが
undefined なら、?PutValue (lhs, value)を返す。 - ?
InitializeReferencedBinding (lhs, value)を返す。
14.4 Empty Statement
Syntax
14.4.1 Runtime Semantics: Evaluation
empty を返す。
14.5 Expression Statement
Syntax
functionまたはclass async functionで開始できません。これはlet [で開始できません。これは、最初のlet
14.5.1 Runtime Semantics: Evaluation
- exprRefを
Expression の ?Evaluation とする。 - ?
GetValue (exprRef)を返す。
14.6 The if Statement
Syntax
else]は、古典的な“dangling else”問題を通常の方法で解決します。つまり、関連付けられるifの選択が他の点ではambiguousである場合、elseは候補となるifのうち最も近い（最も内側の）ものに関連付けられます14.6.1 Static Semantics: Early Errors
-
IsLabelledFunction (the firstStatement )がtrue である場合、それはSyntax Errorです。 -
IsLabelledFunction (the secondStatement )がtrue である場合、それはSyntax Errorです。
-
IsLabelledFunction (Statement )がtrue である場合、それはSyntax Errorです。
このruleを適用する必要があるのは、
14.6.2 Runtime Semantics: Evaluation
- exprRefを
Expression の ?Evaluation とする。 - exprValueを
ToBoolean (?GetValue (exprRef))とする。 - exprValueが
true なら、- stmtCompletionを最初の
Statement のEvaluation のCompletion とする。
- stmtCompletionを最初の
- そうでなければ、
- stmtCompletionを2番目の
Statement のEvaluation のCompletion とする。
- stmtCompletionを2番目の
- ?
UpdateEmpty (stmtCompletion,undefined )を返す。
- exprRefを
Expression の ?Evaluation とする。 - exprValueを
ToBoolean (?GetValue (exprRef))とする。 - exprValueが
false なら、undefined を返す。 - stmtCompletionを
Statement のEvaluation のCompletion とする。 - ?
UpdateEmpty (stmtCompletion,undefined )を返す。
14.7 Iteration Statements
Syntax
14.7.1 Semantics
14.7.1.1 LoopContinues ( completion, labelSet )
The abstract operation LoopContinues takes arguments completion (a
- completionが
normal completion なら、true を返す。 - completionが
continue completion でないなら、false を返す。 - completion.[[Target]]が
empty なら、true を返す。 - labelSetがcompletion.[[Target]]を含むなら、
true を返す。 false を返す。
14.7.1.2 Runtime Semantics: LoopEvaluation
The
- 引数labelSetを伴う
DoWhileStatement の ?DoWhileLoopEvaluation を返す。
- 引数labelSetを伴う
WhileStatement の ?WhileLoopEvaluation を返す。
- 引数labelSetを伴う
ForStatement の ?ForLoopEvaluation を返す。
- 引数labelSetを伴う
ForInOfStatement の ?ForIn/OfLoopEvaluation を返す。
14.7.2 The do-while Statement
Syntax
14.7.2.1 Static Semantics: Early Errors
-
IsLabelledFunction (Statement )がtrue である場合、それはSyntax Errorです。
このruleを適用する必要があるのは、
14.7.2.2 Runtime Semantics: DoWhileLoopEvaluation
The
- iterationResultを
undefined とする。 - 繰り返す
- stmtResultを
Statement のEvaluation のCompletion とする。 LoopContinues (stmtResult, labelSet)がfalse なら、?UpdateEmpty (stmtResult, iterationResult)を返す。- stmtResult.[[Value]]が
empty でないなら、iterationResultをstmtResult.[[Value]]に設定する。 - exprRefを
Expression の ?Evaluation とする。 - exprValueを ?
GetValue (exprRef) とする。 ToBoolean (exprValue)がfalse なら、iterationResultを返す。
- stmtResultを
14.7.3 The while Statement
Syntax
14.7.3.1 Static Semantics: Early Errors
-
IsLabelledFunction (Statement )がtrue である場合、それはSyntax Errorです。
このruleを適用する必要があるのは、
14.7.3.2 Runtime Semantics: WhileLoopEvaluation
The
- iterationResultを
undefined とする。 - 繰り返す
- exprRefを
Expression の ?Evaluation とする。 - exprValueを ?
GetValue (exprRef) とする。 ToBoolean (exprValue)がfalse なら、iterationResultを返す。- stmtResultを
Statement のEvaluation のCompletion とする。 LoopContinues (stmtResult, labelSet)がfalse なら、?UpdateEmpty (stmtResult, iterationResult)を返す。- stmtResult.[[Value]]が
empty でないなら、iterationResultをstmtResult.[[Value]]に設定する。
- exprRefを
14.7.4 The for Statement
Syntax
14.7.4.1 Static Semantics: Early Errors
-
IsLabelledFunction (Statement )がtrue である場合、それはSyntax Errorです。
このruleを適用する必要があるのは、
-
LexicalDeclaration のBoundNames のいずれかの要素がStatement のVarDeclaredNames にも出現する場合、それはSyntax Errorです。
14.7.4.2 Runtime Semantics: ForLoopEvaluation
The
- 最初の
Expression が存在するなら、- exprRefを最初の
Expression の ?Evaluation とする。 - ?
GetValue (exprRef)を実行する。
- exprRefを最初の
- 2番目の
Expression が存在するなら、testを2番目のExpression とする；そうでなければ、testをempty とする。 - 3番目の
Expression が存在するなら、incrementを3番目のExpression とする；そうでなければ、incrementをempty とする。 - ?
ForBodyEvaluation (test, increment,Statement , « », labelSet)を返す。
VariableDeclarationList の ?Evaluation を実行する。- 最初の
Expression が存在するなら、testを最初のExpression とする；そうでなければ、testをempty とする。 - 2番目の
Expression が存在するなら、incrementを2番目のExpression とする；そうでなければ、incrementをempty とする。 - ?
ForBodyEvaluation (test, increment,Statement , « », labelSet)を返す。
- oldEnv を、実行中の実行コンテキストの LexicalEnvironment とする。
- loopEnv を
NewDeclarativeEnvironment (oldEnv) とする。 - isConst を
LexicalDeclaration のIsConstantDeclaration とする。 - boundNames を
LexicalDeclaration のBoundNames とする。 - boundNames の各要素 name について、do
- isConst が
true である場合、then- ! loopEnv.
CreateImmutableBinding (name,true ) を実行する。
- ! loopEnv.
- Else,
- ! loopEnv.
CreateMutableBinding (name,false ) を実行する。
- ! loopEnv.
- isConst が
- 実行中の実行コンテキストの LexicalEnvironment を loopEnv に設定する。
- forDecl を
LexicalDeclaration のEvaluation のCompletion とする。 - forDecl が
abrupt completion である場合、then- forDecl を
Completion (DisposeResources (loopEnv.[[DisposableResourceStack]], forDecl)) に設定する。 Assert : forDecl はabrupt completion である。- 実行中の実行コンテキストの LexicalEnvironment を oldEnv に設定する。
- Return ? forDecl.
- forDecl を
- isConst が
false である場合、perIterationLets を boundNames とする。そうでなければ、perIterationLets を新しい空のList とする。 - 最初の
Expression が存在する場合、test を最初のExpression とする。そうでなければ、test をempty とする。 - 2番目の
Expression が存在する場合、increment を2番目のExpression とする。そうでなければ、increment をempty とする。 - bodyResult を
Completion (ForBodyEvaluation (test, increment,Statement , perIterationLets, labelSet)) とする。 - bodyResult を
Completion (DisposeResources (loopEnv.[[DisposableResourceStack]], bodyResult)) に設定する。 Assert : bodyResult がnormal completion である場合、bodyResult.[[Value]] はempty でない。- 実行中の実行コンテキストの LexicalEnvironment を oldEnv に設定する。
- Return ? bodyResult.
14.7.4.3 ForBodyEvaluation ( test, increment, stmt, perIterationBindings, labelSet )
The abstract operation ForBodyEvaluation takes arguments test (an
- iterationResultを
undefined とする。 - ?
CreatePerIterationEnvironment (perIterationBindings)を実行する。 - 繰り返す
- testが
empty でないなら、- testRefをtestの ?
Evaluation とする。 - testValueを ?
GetValue (testRef) とする。 ToBoolean (testValue)がfalse なら、iterationResultを返す。
- testRefをtestの ?
- resultをstmtの
Evaluation のCompletion とする。 LoopContinues (result, labelSet)がfalse なら、?UpdateEmpty (result, iterationResult)を返す。- result.[[Value]]が
empty でないなら、iterationResultをresult.[[Value]]に設定する。 - ?
CreatePerIterationEnvironment (perIterationBindings)を実行する。 - incrementが
empty でないなら、- incRefをincrementの ?
Evaluation とする。 - ?
GetValue (incRef)を実行する。
- incRefをincrementの ?
- testが
14.7.4.4 CreatePerIterationEnvironment ( perIterationBindings )
The abstract operation CreatePerIterationEnvironment takes argument perIterationBindings (a
- perIterationBindingsに要素がある場合、
- 実行中の実行コンテキストのLexicalEnvironmentをlastIterationEnvとする。
- lastIterationEnv.[[OuterEnv]]をouterとする。
Assert : outerはnull ではない。NewDeclarativeEnvironment (outer)をthisIterationEnvとする。- perIterationBindingsの各要素nameについて、次を行う。
- ! thisIterationEnv.
CreateMutableBinding (name,false )を実行する。 - ? lastIterationEnv.
GetBindingValue (name,true )をlastValueとする。 - ! thisIterationEnv.
InitializeBinding (name, lastValue)を実行する。
- ! thisIterationEnv.
- 実行中の実行コンテキストのLexicalEnvironmentをthisIterationEnvに設定する。
unused を返す。
14.7.5 The for-in, for-of, and for-await-of Statements
Syntax
このsectionはAnnex
14.7.5.1 Static Semantics: Early Errors
-
IsLabelledFunction (Statement )がtrue である場合、それはSyntax Errorです。
このruleを適用する必要があるのは、
-
LeftHandSideExpression がObjectLiteral またはArrayLiteral のいずれかである場合、LeftHandSideExpression はAssignmentPattern をcoverしなければなりません。 -
LeftHandSideExpression がObjectLiteral でもArrayLiteral でもない場合、LeftHandSideExpression のAssignmentTargetType がinvalid であるなら、それはSyntax Errorです。
-
ForDeclaration のBoundNames が"let" を含む場合、それはSyntax Errorです。 -
ForDeclaration のBoundNames のいずれかの要素がStatement のVarDeclaredNames にも出現する場合、それはSyntax Errorです。 -
ForDeclaration のBoundNames が重複entriesを含む場合、それはSyntax Errorです。
14.7.5.2 Static Semantics: IsDestructuring
The
PrimaryExpression がObjectLiteral またはArrayLiteral のいずれかなら、true を返す。false を返す。
false を返す。
false を返す。
true を返す。
このsectionはAnnex
14.7.5.3 Runtime Semantics: ForDeclarationBindingInitialization
The
- 引数valueおよびenvRecordを伴う
ForBinding の ?BindingInitialization を返す。
SyntaxError 例外を投げる。
14.7.5.4 Runtime Semantics: ForDeclarationBindingInstantiation
The
ForBinding のBoundNames の各要素nameについて、以下を行うLetOrConst のIsConstantDeclaration がtrue なら、- ! envRecord.
CreateImmutableBinding (name,true )を実行する。
- ! envRecord.
- そうでなければ、
- ! envRecord.
CreateMutableBinding (name,false )を実行する。
- ! envRecord.
unused を返す。
ForBinding のBoundNames の各要素 name について、do- ! envRecord.
CreateImmutableBinding (name,true ) を実行する。
- ! envRecord.
unused を返す。
14.7.5.5 Runtime Semantics: ForIn/OfLoopEvaluation
The
- keyResultを ?
ForIn/OfHeadEvaluation (« »,Expression ,enumerate ) とする。 - ?
ForIn/OfBodyEvaluation (LeftHandSideExpression ,Statement , keyResult,enumerate ,assignment , labelSet)を返す。
- keyResultを ?
ForIn/OfHeadEvaluation (« »,Expression ,enumerate ) とする。 - ?
ForIn/OfBodyEvaluation (ForBinding ,Statement , keyResult,enumerate ,var-binding , labelSet)を返す。
- keyResultを ?
ForIn/OfHeadEvaluation (ForDeclaration のBoundNames ,Expression ,enumerate ) とする。 - ?
ForIn/OfBodyEvaluation (ForDeclaration ,Statement , keyResult,enumerate ,lexical-binding , labelSet)を返す。
- keyResultを ?
ForIn/OfHeadEvaluation (« »,AssignmentExpression ,iterate ) とする。 - ?
ForIn/OfBodyEvaluation (LeftHandSideExpression ,Statement , keyResult,iterate ,assignment , labelSet)を返す。
- keyResultを ?
ForIn/OfHeadEvaluation (« »,AssignmentExpression ,iterate ) とする。 - ?
ForIn/OfBodyEvaluation (ForBinding ,Statement , keyResult,iterate ,var-binding , labelSet)を返す。
- keyResultを ?
ForIn/OfHeadEvaluation (ForDeclaration のBoundNames ,AssignmentExpression ,iterate ) とする。 - ?
ForIn/OfBodyEvaluation (ForDeclaration ,Statement , keyResult,iterate ,lexical-binding , labelSet)を返す。
- keyResultを ?
ForIn/OfHeadEvaluation (« »,AssignmentExpression ,async-iterate ) とする。 - ?
ForIn/OfBodyEvaluation (LeftHandSideExpression ,Statement , keyResult,iterate ,assignment , labelSet,async )を返す。
- keyResultを ?
ForIn/OfHeadEvaluation (« »,AssignmentExpression ,async-iterate ) とする。 - ?
ForIn/OfBodyEvaluation (ForBinding ,Statement , keyResult,iterate ,var-binding , labelSet,async )を返す。
- keyResultを ?
ForIn/OfHeadEvaluation (ForDeclaration のBoundNames ,AssignmentExpression ,async-iterate ) とする。 - ?
ForIn/OfBodyEvaluation (ForDeclaration ,Statement , keyResult,iterate ,lexical-binding , labelSet,async )を返す。
このsectionはAnnex
14.7.5.6 ForIn/OfHeadEvaluation ( uninitializedBoundNames, expr, iterationKind )
The abstract operation ForIn/OfHeadEvaluation takes arguments uninitializedBoundNames (a
- oldEnvを
running execution context のLexicalEnvironmentとする。 - uninitializedBoundNamesが空でないなら、
Assert : uninitializedBoundNamesは重複entriesを持たない。- newEnvを
NewDeclarativeEnvironment (oldEnv)とする。 - uninitializedBoundNamesの各String nameについて、以下を行う
- ! newEnv.
CreateMutableBinding (name,false )を実行する。
- ! newEnv.
running execution context のLexicalEnvironmentをnewEnvに設定する。
- exprRefをexprの
Evaluation のCompletion とする。 running execution context のLexicalEnvironmentをoldEnvに設定する。- exprValueを ?
GetValue (? exprRef) とする。 - iterationKindが
enumerate なら、- exprValueが
undefined またはnull のいずれかなら、Completion Record { [[Type]]:break , [[Value]]:empty , [[Target]]:empty }を返す。
- objを !
ToObject (exprValue) とする。 - iteratorを
EnumerateObjectProperties (obj)とする。 - nextMethodを !
GetV (iterator,"next" ) とする。 Iterator Record { [[Iterator]]: iterator, [[NextMethod]]: nextMethod, [[Done]]:false }を返す。
- exprValueが
Assert : iterationKindはiterate またはasync-iterate のいずれかである。- iterationKindが
async-iterate なら、iteratorKindをasync とする。 - そうでなければ、iteratorKindを
sync とする。 - ?
GetIterator (exprValue, iteratorKind)を返す。
14.7.5.7 ForIn/OfBodyEvaluation ( lhs, stmt, iteratorRecord, iterationKind, lhsKind, labelSet [ , iteratorKind ] )
The abstract operation ForIn/OfBodyEvaluation takes arguments lhs (a
- iteratorKind が存在しない場合、iteratorKind を
sync に設定する。 - oldEnv を、実行中の実行コンテキストの LexicalEnvironment とする。
- iterationResult を
undefined とする。 - lhsKind が
lexical-binding である場合、thenAssert : lhs はForDeclaration である。- lhs の
IsAwaitUsingDeclaration がtrue である場合、then- declarationKind を
async-dispose とする。
- declarationKind を
- Else if lhs の
IsUsingDeclaration がtrue である場合、then- declarationKind を
sync-dispose とする。
- declarationKind を
- Else,
- declarationKind を
normal とする。
- declarationKind を
- Else,
- declarationKind を
normal とする。
- declarationKind を
- destructuring を lhs の
IsDestructuring とする。 - destructuring が
true であり、かつ lhsKind がassignment である場合、thenAssert : lhs はLeftHandSideExpression である。- assignmentPattern を、lhs によってカバーされる
AssignmentPattern とする。
- Repeat,
- nextResult を ?
Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]]) とする。 - iteratorKind が
async である場合、nextResult を ?Await (nextResult) に設定する。 - nextResult が Object でない場合、
TypeError 例外を投げる。 - done を ?
IteratorComplete (nextResult) とする。 - done が
true である場合、iterationResult を返す。 - nextValue を ?
IteratorValue (nextResult) とする。 - lhsKind が
assignment またはvar-binding のいずれかである場合、then- destructuring が
true である場合、then- lhsKind が
assignment である場合、then- status を、引数 nextValue で assignmentPattern の
DestructuringAssignmentEvaluation のCompletion とする。
- status を、引数 nextValue で assignmentPattern の
- Else,
Assert : lhsKind はvar-binding である。Assert : lhs はForBinding である。- status を、引数 nextValue および
undefined で lhs のBindingInitialization のCompletion とする。
- lhsKind が
- Else,
- lhsRef を lhs の
Evaluation のCompletion とする。（これは繰り返し評価されることがある。） - lhsKind が
assignment であり、かつ lhs のAssignmentTargetType がweb-compat である場合、ReferenceError 例外を投げる。 - lhsRef が
abrupt completion である場合、then- status を lhsRef とする。
- Else,
- status を
Completion (PutValue (lhsRef.[[Value]], nextValue)) とする。
- status を
- lhsRef を lhs の
- iterationEnv を
undefined とする。
- destructuring が
- Else,
Assert : lhsKind はlexical-binding である。Assert : lhs はForDeclaration である。- iterationEnv を
NewDeclarativeEnvironment (oldEnv) とする。 - 引数 iterationEnv で lhs の
ForDeclarationBindingInstantiation を実行する。 - 実行中の実行コンテキストの LexicalEnvironment を iterationEnv に設定する。
- destructuring が
true である場合、then- status を、引数 nextValue および iterationEnv で lhs の
ForDeclarationBindingInitialization のCompletion とする。
- status を、引数 nextValue および iterationEnv で lhs の
- Else,
Assert : lhs は単一の名前を束縛する。- lhsName を lhs の
BoundNames の唯一の要素とする。 - lhsRef を !
ResolveBinding (lhsName) とする。 - declarationKind が
normal でない場合、thenAssert :IsUnresolvableReference (lhsRef) はfalse である。- base を lhsRef.[[Base]] とする。
Assert : base はDeclarative Environment Record である。- status を
Completion (AddDisposableResource (base.[[DisposableResourceStack]], nextValue, declarationKind)) とする。
- Else,
- status を
NormalCompletion (unused ) とする。
- status を
- status が
normal completion である場合、then- status を
Completion (InitializeReferencedBinding (lhsRef, nextValue)) に設定する。
- status を
- status が
abrupt completion である場合、then- iterationEnv が
undefined でない場合、then- status を
Completion (DisposeResources (iterationEnv.[[DisposableResourceStack]], status)) に設定する。 Assert : status はabrupt completion である。
- status を
- 実行中の実行コンテキストの LexicalEnvironment を oldEnv に設定する。
- iterationKind が
enumerate である場合、return ? status. Assert : iterationKind はiterate である。- iteratorKind が
async である場合、return ?AsyncIteratorClose (iteratorRecord, status). - Return ?
IteratorClose (iteratorRecord, status).
- iterationEnv が
- result を stmt の
Evaluation のCompletion とする。 - iterationEnv が
undefined でない場合、then- result を
Completion (DisposeResources (iterationEnv.[[DisposableResourceStack]], result)) に設定する。
- result を
- 実行中の実行コンテキストの LexicalEnvironment を oldEnv に設定する。
LoopContinues (result, labelSet) がfalse である場合、then- status を
Completion (UpdateEmpty (result, iterationResult)) に設定する。 - iterationKind が
enumerate である場合、return ? status. Assert : iterationKind はiterate である。- iteratorKind が
async である場合、return ?AsyncIteratorClose (iteratorRecord, status). - Return ?
IteratorClose (iteratorRecord, status).
- status を
- result.[[Value]] が
empty でない場合、iterationResult を result.[[Value]] に設定する。
- nextResult を ?
14.7.5.8 Runtime Semantics: Evaluation
- bindingIdを
BindingIdentifier のStringValue とする。 - ?
ResolveBinding (bindingId)を返す。
14.7.5.9 EnumerateObjectProperties ( obj )
The abstract operation EnumerateObjectProperties takes argument obj (an Object) and returns an
- objのenumerable propertiesのString値keysすべてを反復する
nextmethodを持つiterator object を返す。iterator object はECMAScript codeから直接accessできることは決してありません。propertiesをenumeratingするmechanicsおよびorderは指定されませんが、以下で指定されるrulesにconformしなければなりません。
throwおよびreturn methodsはnext methodは、next methodによって処理される前に削除されたpropertyは無視されます。enumeration中にtarget objectへ新しいpropertiesが追加された場合、新しく追加されたpropertiesはactive enumerationで処理されることが保証されません。next methodによって最大1回だけ返されます。
target objectのpropertiesをenumeratingすることには、そのprototype、そのprototypeのprototype、以下同様にrecursiveにpropertiesをenumeratingすることが含まれます；ただし、prototypeのpropertyは、next methodによってすでに処理されたpropertyと同じ名前を持つ場合、処理されません。prototype objectのpropertyがすでに処理されたかどうかを判定するとき、[[Enumerable]] attributesの値は考慮されません。prototype objectsのenumerable
さらに、objも、そのprototype chain内のどのobjectも
- objまたはそのprototype chain内のobjectの[[Prototype]] internal slotの値が変更される、
- objまたはそのprototype chain内のobjectからpropertyが削除される、
- objのprototype chain内のobjectへpropertyが追加される、または
- objまたはそのprototype chain内のobjectのpropertyの[[Enumerable]] attributeの値が変更される。
ECMAScript implementationsは、
以下は、これらのrulesにconformするECMAScript generator functionのinformative definitionです：
function* EnumerateObjectProperties(obj) {
const visited = new Set();
for (const key of Reflect.ownKeys(obj)) {
if (typeof key === "symbol") continue;
const desc = Reflect.getOwnPropertyDescriptor(obj, key);
if (desc) {
visited.add(key);
if (desc.enumerable) yield key;
}
}
const proto = Reflect.getPrototypeOf(obj);
if (proto === null) return;
for (const protoKey of EnumerateObjectProperties(proto)) {
if (!visited.has(protoKey)) yield protoKey;
}
}14.7.5.10 For-In Iterator Objects
For-In Iteratorは、特定のobjectに対する特定のiterationを表すobjectです。For-In Iterator objectsはECMAScript codeから直接accessできることは決してありません；それらは
14.7.5.10.1 CreateForInIterator ( obj )
The abstract operation CreateForInIterator takes argument obj (an Object) and returns a
- iteratorを
OrdinaryObjectCreate (%ForInIteratorPrototype% , « [[Object]], [[ObjectWasVisited]], [[VisitedKeys]], [[RemainingKeys]] »)とする。 - iterator.[[Object]]をobjに設定する。
- iterator.[[ObjectWasVisited]]を
false に設定する。 - iterator.[[VisitedKeys]]を新しい空の
List に設定する。 - iterator.[[RemainingKeys]]を新しい空の
List に設定する。 - iteratorを返す。
14.7.5.10.2 The %ForInIteratorPrototype% Object
%ForInIteratorPrototype% object：
- すべての
For-In Iterator objects によってinheritedされるpropertiesを持ちます。 ordinary object です。- その値が
%Iterator.prototype% である[[Prototype]] internal slotを持ちます。 - ECMAScript codeから直接accessできることは決してありません。
- 次のpropertiesを持ちます：
14.7.5.10.2.1 %ForInIteratorPrototype%.next ( )
- iteratorを
this valueとする。 Assert : iteratorはObjectである。Assert : iteratorはFor-In Iterator instanceのinternal slotsすべてを持つ（14.7.5.10.3 ）。- objをiterator.[[Object]]とする。
- 繰り返す
- iterator.[[ObjectWasVisited]]が
false なら、- keysを ? obj.[[OwnPropertyKeys]]() とする。
- keysの各要素keyについて、以下を行う
- keyがStringなら、
- keyをiterator.[[RemainingKeys]]へappendする。
- keyがStringなら、
- iterator.[[ObjectWasVisited]]を
true に設定する。
- iterator.[[RemainingKeys]]が空でない間、繰り返す
- keyをiterator.[[RemainingKeys]]の最初の要素とする。
- iterator.[[RemainingKeys]]から最初の要素をremoveする。
- iterator.[[VisitedKeys]]がkeyを含まないなら、
- propertyDescを ? obj.[[GetOwnProperty]](key) とする。
- propertyDescが
undefined でないなら、- keyをiterator.[[VisitedKeys]]へappendする。
- propertyDesc.[[Enumerable]]が
true なら、CreateIteratorResultObject (key,false )を返す。
- objを ? obj.[[GetPrototypeOf]]() に設定する。
- iterator.[[Object]]をobjに設定する。
- iterator.[[ObjectWasVisited]]を
false に設定する。 - objが
null なら、CreateIteratorResultObject (undefined ,true )を返す。
- iterator.[[ObjectWasVisited]]が
14.7.5.10.3 Properties of For-In Iterator Instances
| Internal Slot | Type | Description |
|---|---|---|
| [[Object]] | an Object | propertiesがiteratedされているObject値。 |
| [[ObjectWasVisited]] | a Boolean |
|
| [[VisitedKeys]] |
a |
この |
| [[RemainingKeys]] |
a |
そのprototypeが |
14.8 The continue Statement
Syntax
14.8.1 Static Semantics: Early Errors
-
この
ContinueStatement が、直接的または間接的に（ただしfunctionまたはstaticinitialization blockのboundariesを越えずに）IterationStatement 内にnestedされていない場合、それはSyntax Errorです。
14.8.2 Runtime Semantics: Evaluation
Completion Record { [[Type]]:continue , [[Value]]:empty , [[Target]]:empty }を返す。
- labelを
LabelIdentifier のStringValue とする。 Completion Record { [[Type]]:continue , [[Value]]:empty , [[Target]]: label }を返す。
14.9 The break Statement
Syntax
14.9.1 Static Semantics: Early Errors
-
この
BreakStatement が、直接的または間接的に（ただしfunctionまたはstaticinitialization blockのboundariesを越えずに）IterationStatement またはSwitchStatement 内にnestedされていない場合、それはSyntax Errorです。
14.9.2 Runtime Semantics: Evaluation
Completion Record { [[Type]]:break , [[Value]]:empty , [[Target]]:empty }を返す。
- labelを
LabelIdentifier のStringValue とする。 Completion Record { [[Type]]:break , [[Value]]:empty , [[Target]]: label }を返す。
14.10 The return Statement
Syntax
return statementはfunctionのexecutionを停止させ、ほとんどの場合、callerへ値を返します。return statementは、surrounding contextによっては、実際にはcallerへ値を返さない場合があります。例えば、try blockでは、return statementのfinally blockのevaluation中に別の
14.10.1 Runtime Semantics: Evaluation
ReturnCompletion (undefined )を返す。
- exprRefを
Expression の ?Evaluation とする。 - exprValueを ?
GetValue (exprRef) とする。 GetGeneratorKind ()がasync なら、exprValueを ?Await (exprValue) に設定する。ReturnCompletion (exprValue)を返す。
14.11 The with Statement
新しいECMAScript codeではwith statementの使用はdiscouragedされます。
Syntax
with statementは、computed objectに対する
14.11.1 Static Semantics: Early Errors
-
IsStrict (this production)がtrue である場合、それはSyntax Errorです。 -
IsLabelledFunction (Statement )がtrue である場合、それはSyntax Errorです。
second ruleを適用する必要があるのは、
14.11.2 Runtime Semantics: Evaluation
- valueを
Expression の ?Evaluation とする。 - objを ?
ToObject (?GetValue (value)) とする。 - oldEnvを
running execution context のLexicalEnvironmentとする。 - newEnvを
NewObjectEnvironment (obj,true , oldEnv)とする。 running execution context のLexicalEnvironmentをnewEnvに設定する。- stmtCompletionを
Statement のEvaluation のCompletion とする。 running execution context のLexicalEnvironmentをoldEnvに設定する。- ?
UpdateEmpty (stmtCompletion,undefined )を返す。
controlがembedded
14.12 The switch Statement
Syntax
14.12.1 Static Semantics: Early Errors
-
CaseBlock のLexicallyDeclaredNames が重複entriesを含む場合、それはSyntax Errorです。ただし、hostがweb browserである、またはその他の形でBlock-Level Function Declarations Web Legacy Compatibility Semantics をサポートし、かつ次の両方の条件がtrueである場合を除きます：IsStrict (this production)がfalse である。- 重複entriesはFunctionDeclarationsによってのみboundされる。
-
CaseBlock のLexicallyDeclaredNames のいずれかの要素がCaseBlock のVarDeclaredNames にも出現する場合、それはSyntax Errorです。
-
StatementList のContainsUsing がtrue である場合、Syntax Error である。
-
StatementList のContainsUsing がtrue である場合、Syntax Error である。
14.12.2 Runtime Semantics: CaseBlockEvaluation
The
undefined を返す。
- resultValueを
undefined とする。 - caseClausesを、source text orderにおける
CaseClauses 内のCaseClause itemsのList とする。 - foundを
false とする。 - caseClausesの各
CaseClause clauseについて、以下を行う- foundが
false なら、- foundを ?
CaseClauseIsSelected (clause, input) に設定する。
- foundを ?
- foundが
true なら、- completionをclauseの
Evaluation のCompletion とする。 - completion.[[Value]]が
empty でないなら、resultValueをcompletion.[[Value]]に設定する。 - completionが
abrupt completion なら、?UpdateEmpty (completion, resultValue)を返す。
- completionをclauseの
- foundが
- resultValueを返す。
- resultValueを
undefined とする。 - 最初の
CaseClauses が存在するなら、- caseClausesを、source text orderにおける最初の
CaseClauses 内のCaseClause itemsのList とする。
- caseClausesを、source text orderにおける最初の
- そうでなければ、
- caseClausesを新しい空の
List とする。
- caseClausesを新しい空の
- foundを
false とする。 - caseClausesの各
CaseClause clauseについて、以下を行う- foundが
false なら、- foundを ?
CaseClauseIsSelected (clause, input) に設定する。
- foundを ?
- foundが
true なら、- completionをclauseの
Evaluation のCompletion とする。 - completion.[[Value]]が
empty でないなら、resultValueをcompletion.[[Value]]に設定する。 - completionが
abrupt completion なら、?UpdateEmpty (completion, resultValue)を返す。
- completionをclauseの
- foundが
- foundInBを
false とする。 - 2番目の
CaseClauses が存在するなら、- secondCaseClausesを、source text orderにおける2番目の
CaseClauses 内のCaseClause itemsのList とする。
- secondCaseClausesを、source text orderにおける2番目の
- そうでなければ、
- secondCaseClausesを新しい空の
List とする。
- secondCaseClausesを新しい空の
- foundが
false なら、- secondCaseClausesの各
CaseClause clauseについて、以下を行う- foundInBが
false なら、- foundInBを ?
CaseClauseIsSelected (clause, input) に設定する。
- foundInBを ?
- foundInBが
true なら、- completionを
CaseClause clauseのEvaluation のCompletion とする。 - completion.[[Value]]が
empty でないなら、resultValueをcompletion.[[Value]]に設定する。 - completionが
abrupt completion なら、?UpdateEmpty (completion, resultValue)を返す。
- completionを
- foundInBが
- secondCaseClausesの各
- foundInBが
true なら、resultValueを返す。 - defaultRを
DefaultClause のEvaluation のCompletion とする。 - defaultR.[[Value]]が
empty でないなら、resultValueをdefaultR.[[Value]]に設定する。 - defaultRが
abrupt completion なら、?UpdateEmpty (defaultR, resultValue)を返す。 NOTE : 以下は2番目のCaseClauses のもう1つの完全なiterationです。- secondCaseClausesの各
CaseClause clauseについて、以下を行う- completionを
CaseClause clauseのEvaluation のCompletion とする。 - completion.[[Value]]が
empty でないなら、resultValueをcompletion.[[Value]]に設定する。 - completionが
abrupt completion なら、?UpdateEmpty (completion, resultValue)を返す。
- completionを
- resultValueを返す。
14.12.3 CaseClauseIsSelected ( caseClauseNode, input )
The abstract operation CaseClauseIsSelected takes arguments caseClauseNode (a
Assert : caseClauseNodeはproductionCaseClause : case Expression : StatementList opt - exprRefをcaseClauseNodeの
Expression の ?Evaluation とする。 - clauseSelectorを ?
GetValue (exprRef) とする。 IsStrictlyEqual (input, clauseSelector)を返す。
このoperationはcaseClauseNodeの
14.12.4 Runtime Semantics: Evaluation
- exprRef を
Expression のEvaluation とする。 - switchValue を ?
GetValue (exprRef) とする。 - oldEnv を、実行中の実行コンテキストの LexicalEnvironment とする。
- blockEnv を
NewDeclarativeEnvironment (oldEnv) とする。 BlockDeclarationInstantiation (CaseBlock , blockEnv) を実行する。- 実行中の実行コンテキストの LexicalEnvironment を blockEnv に設定する。
- blockResult を、引数 switchValue で
CaseBlock のCaseBlockEvaluation のCompletion とする。 Assert : blockEnv.[[DisposableResourceStack]] は空のList である。- 実行中の実行コンテキストの LexicalEnvironment を oldEnv に設定する。
- Return blockResult.
controlがどのように
empty を返す。
StatementList の ?Evaluation を返す。
empty を返す。
StatementList の ?Evaluation を返す。
14.13 Labelled Statements
Syntax
breakおよびcontinue statementsと組み合わせてのみ使用されます。ECMAScriptにはgoto statementはありません。
14.13.1 Static Semantics: Early Errors
-
任意のsource textがこのproductionによってmatchされる場合、それはSyntax Errorです。ただし、そのsource textが
non-strict code であり、かつhostがweb browserである、またはその他の形でLabelled Function Declarations をサポートする場合を除きます。
14.13.2 Static Semantics: IsLabelledFunction ( stmt )
The abstract operation IsLabelledFunction takes argument stmt (a
- stmtが
LabelledStatement でないなら、false を返す。 - itemをstmtの
LabelledItem とする。 - itemが
LabelledItem : FunctionDeclaration true を返す。 - subStmtをitemの
Statement とする。 IsLabelledFunction (subStmt)を返す。
14.13.3 Runtime Semantics: Evaluation
- 引数« »を伴うthis
LabelledStatement の ?LabelledEvaluation を返す。
14.13.4 Runtime Semantics: LabelledEvaluation
The
- stmtResultを、引数labelSetを伴う
IterationStatement のLoopEvaluation のCompletion とする。 - stmtResultが
break completion なら、- stmtResult.[[Target]]が
empty なら、- stmtResult.[[Value]]が
empty なら、stmtResultをNormalCompletion (undefined )に設定する。 - そうでなければ、stmtResultを
NormalCompletion (stmtResult.[[Value]])に設定する。
- stmtResult.[[Value]]が
- stmtResult.[[Target]]が
- ? stmtResultを返す。
- stmtResultを
SwitchStatement のEvaluation のCompletion とする。 - stmtResultが
break completion なら、- stmtResult.[[Target]]が
empty なら、- stmtResult.[[Value]]が
empty なら、stmtResultをNormalCompletion (undefined )に設定する。 - そうでなければ、stmtResultを
NormalCompletion (stmtResult.[[Value]])に設定する。
- stmtResult.[[Value]]が
- stmtResult.[[Target]]が
- ? stmtResultを返す。
- labelを
LabelIdentifier のStringValue とする。 - newLabelSetをlabelSetと« label »の
list-concatenation とする。 - stmtResultを、引数newLabelSetを伴う
LabelledItem のLabelledEvaluation のCompletion とする。 - stmtResultが
break completion であり、かつstmtResult.[[Target]]がlabelであるなら、- stmtResultを
NormalCompletion (stmtResult.[[Value]])に設定する。
- stmtResultを
- ? stmtResultを返す。
FunctionDeclaration の ?Evaluation を返す。
Statement の ?Evaluation を返す。
LabelledEvaluationに対してspecial semanticsを持つ
14.14 The throw Statement
Syntax
14.14.1 Runtime Semantics: Evaluation
- exprRefを
Expression の ?Evaluation とする。 - exprValueを ?
GetValue (exprRef) とする。 - exprValueをThrowする。
14.15 The try Statement
Syntax
try statementは、runtime errorやthrow statementなど、exceptional conditionが発生し得るcodeのblockを囲みます。catch clauseはexception-handling codeを提供します。catch clauseがexceptionをcatchすると、その
14.15.1 Static Semantics: Early Errors
-
CatchParameter のBoundNames が重複elementsを含む場合、それはSyntax Errorです。 -
CatchParameter のBoundNames のいずれかの要素がBlock のLexicallyDeclaredNames にも出現する場合、それはSyntax Errorです。 -
CatchParameter のBoundNames のいずれかの要素がBlock のVarDeclaredNames にも出現する場合、それはSyntax Errorです。ただし、CatchParameter がCatchParameter : BindingIdentifier Catch Blocks内のVariableStatements をサポートする場合を除きます。
14.15.2 Runtime Semantics: CatchClauseEvaluation
The
- oldEnvを
running execution context のLexicalEnvironmentとする。 - catchEnvを
NewDeclarativeEnvironment (oldEnv)とする。 CatchParameter のBoundNames の各要素argNameについて、以下を行う- ! catchEnv.
CreateMutableBinding (argName,false )を実行する。
- ! catchEnv.
running execution context のLexicalEnvironmentをcatchEnvに設定する。- statusを、引数thrownValueおよびcatchEnvを伴う
CatchParameter のBindingInitialization のCompletion とする。 - statusが
abrupt completion なら、running execution context のLexicalEnvironmentをoldEnvに設定する。- ? statusを返す。
- blockCompletionを
Block のEvaluation のCompletion とする。 running execution context のLexicalEnvironmentをoldEnvに設定する。- ? blockCompletionを返す。
Block の ?Evaluation を返す。
controlがどのように
14.15.3 Runtime Semantics: Evaluation
- blockResultを
Block のEvaluation のCompletion とする。 - blockResultが
throw completion なら、catchResultを、引数blockResult.[[Value]]を伴うCatch のCatchClauseEvaluation のCompletion とする。 - そうでなければ、catchResultをblockResultとする。
- ?
UpdateEmpty (catchResult,undefined )を返す。
- blockResultを
Block のEvaluation のCompletion とする。 - finallyResultを
Finally のEvaluation のCompletion とする。 - finallyResultが
normal completion なら、finallyResultをblockResultに設定する。 - ?
UpdateEmpty (finallyResult,undefined )を返す。
- blockResultを
Block のEvaluation のCompletion とする。 - blockResultが
throw completion なら、catchResultを、引数blockResult.[[Value]]を伴うCatch のCatchClauseEvaluation のCompletion とする。 - そうでなければ、catchResultをblockResultとする。
- finallyResultを
Finally のEvaluation のCompletion とする。 - finallyResultが
normal completion なら、finallyResultをcatchResultに設定する。 - ?
UpdateEmpty (finallyResult,undefined )を返す。
14.16 The debugger Statement
Syntax
14.16.1 Runtime Semantics: Evaluation
implementation-defined debugging facilityがavailableかつenabledであるなら、implementation-defined debugging actionを実行する。- 新しい
implementation-defined Completion Record を返す。
empty を返す。
15 ECMAScript Language: Functions and Classes
さまざまなECMAScript language elementsは、ECMAScript
15.1 Parameter Lists
Syntax
15.1.1 Static Semantics: Early Errors
-
FormalParameters のBoundNames が重複elementsを含む場合、それはSyntax Errorです。
-
FormalParameterList のIsSimpleParameterList がfalse であり、かつFormalParameterList のBoundNames が重複elementsを含む場合、それはSyntax Errorです。
15.1.2 Static Semantics: ContainsExpression
The
false を返す。
false を返す。
- hasを
BindingElementList のContainsExpression とする。 - hasが
true なら、true を返す。 BindingRestElement のContainsExpression を返す。
- hasを
BindingPropertyList のContainsExpression とする。 - hasが
true なら、true を返す。 BindingProperty のContainsExpression を返す。
- hasを
BindingElementList のContainsExpression とする。 - hasが
true なら、true を返す。 BindingElisionElement のContainsExpression を返す。
- hasを
PropertyName のIsComputedPropertyKey とする。 - hasが
true なら、true を返す。 BindingElement のContainsExpression を返す。
true を返す。
false を返す。
true を返す。
false を返す。
false を返す。
FormalParameterList のContainsExpression がtrue なら、true を返す。FunctionRestParameter のContainsExpression を返す。
FormalParameterList のContainsExpression がtrue なら、true を返す。FormalParameter のContainsExpression を返す。
false を返す。
- formalsを
CoverParenthesizedExpressionAndArrowParameterList によってcoverされるArrowFormalParameters とする。 - formalsの
ContainsExpression を返す。
false を返す。
15.1.3 Static Semantics: IsSimpleParameterList
The
false を返す。
false を返す。
true を返す。
false を返す。
true を返す。
false を返す。
false を返す。
FormalParameterList のIsSimpleParameterList がfalse なら、false を返す。FormalParameter のIsSimpleParameterList を返す。
true を返す。
- formalsを
CoverParenthesizedExpressionAndArrowParameterList によってcoverされるArrowFormalParameters とする。 - formalsの
IsSimpleParameterList を返す。
true を返す。
- headを
CoverCallExpressionAndAsyncArrowHead によってcoverされるAsyncArrowHead とする。 - headの
IsSimpleParameterList を返す。
15.1.4 Static Semantics: HasInitializer
The
false を返す。
true を返す。
false を返す。
true を返す。
FormalParameterList のHasInitializer がtrue なら、true を返す。FormalParameter のHasInitializer を返す。
15.1.5 Static Semantics: ExpectedArgumentCount
The
- 0を返す。
FormalParameter のHasInitializer がtrue なら、0を返す。- 1を返す。
- countを
FormalParameterList のExpectedArgumentCount とする。 FormalParameterList のHasInitializer がtrue 、またはFormalParameter のHasInitializer がtrue なら、countを返す。- count + 1を返す。
- 1を返す。
- formalsを
CoverParenthesizedExpressionAndArrowParameterList によってcoverされるArrowFormalParameters とする。 - formalsの
ExpectedArgumentCount を返す。
FormalParameter のHasInitializer がtrue なら、0を返す。- 1を返す。
- 1を返す。
15.2 Function Definitions
Syntax
15.2.1 Static Semantics: Early Errors
-
IsStrict (FormalParameters )がtrue である場合、UniqueFormalParameters : FormalParameters -
BindingIdentifier が存在し、かつIsStrict (BindingIdentifier )がtrue である場合、BindingIdentifier のStringValue が"eval" または"arguments" のいずれかであるなら、それはSyntax Errorです。 -
FunctionBody のFunctionBodyContainsUseStrict がtrue であり、かつFormalParameters のIsSimpleParameterList がfalse である場合、それはSyntax Errorです。 -
FormalParameters のBoundNames のいずれかの要素がFunctionBody のLexicallyDeclaredNames にも出現する場合、それはSyntax Errorです。 -
FormalParameters Contains SuperProperty がtrue である場合、それはSyntax Errorです。 -
FunctionBody Contains SuperProperty がtrue である場合、それはSyntax Errorです。 -
FormalParameters Contains SuperCall がtrue である場合、それはSyntax Errorです。 -
FunctionBody Contains SuperCall がtrue である場合、それはSyntax Errorです。
-
FunctionStatementList のLexicallyDeclaredNames が重複entriesを含む場合、それはSyntax Errorです。 -
FunctionStatementList のLexicallyDeclaredNames のいずれかの要素がFunctionStatementList のVarDeclaredNames にも出現する場合、それはSyntax Errorです。 -
argument « »を伴う
FunctionStatementList のContainsDuplicateLabels がtrue である場合、それはSyntax Errorです。 -
argument « »を伴う
FunctionStatementList のContainsUndefinedBreakTarget がtrue である場合、それはSyntax Errorです。 -
arguments « »および« »を伴う
FunctionStatementList のContainsUndefinedContinueTarget がtrue である場合、それはSyntax Errorです。
15.2.2 Static Semantics: FunctionBodyContainsUseStrict
The
FunctionBody のDirective Prologue がUse Strict Directive を含むなら、true を返す。false を返す。
15.2.3 Runtime Semantics: EvaluateFunctionBody
The
- ?
FunctionDeclarationInstantiation (funcObj, argList)を実行する。 FunctionStatementList の ?Evaluation を実行する。NOTE : previous stepがnormal completion をもたらした場合、evaluationはFunctionStatementList の終端を越えて進むことで終了した。ReturnCompletion (undefined )を返す。
15.2.4 Runtime Semantics: InstantiateOrdinaryFunctionObject
The
- nameを
BindingIdentifier のStringValue とする。 - sourceTextを
FunctionDeclaration によってmatchされたsource textとする。 - closureを
OrdinaryFunctionCreate (%Function.prototype% , sourceText,FormalParameters ,FunctionBody ,non-lexical-this , envRecord, privateEnv)とする。 SetFunctionName (closure, name)を実行する。MakeConstructor (closure)を実行する。- closureを返す。
- sourceTextを
FunctionDeclaration によってmatchされたsource textとする。 - closureを
OrdinaryFunctionCreate (%Function.prototype% , sourceText,FormalParameters ,FunctionBody ,non-lexical-this , envRecord, privateEnv)とする。 SetFunctionName (closure,"default" )を実行する。MakeConstructor (closure)を実行する。- closureを返す。
anonymous export default declarationの一部としてのみ出現できるため、そのfunction codeは常に
15.2.5 Runtime Semantics: InstantiateOrdinaryFunctionExpression
The
- nameが存在しない場合、nameをempty Stringに設定する。
- envRecordを
running execution context のLexicalEnvironmentとする。 - privateEnvを
running execution context のPrivateEnvironmentとする。 - sourceTextを
FunctionExpression によってmatchされたsource textとする。 - closureを
OrdinaryFunctionCreate (%Function.prototype% , sourceText,FormalParameters ,FunctionBody ,non-lexical-this , envRecord, privateEnv)とする。 SetFunctionName (closure, name)を実行する。MakeConstructor (closure)を実行する。- closureを返す。
Assert : nameは存在しない。- nameを
BindingIdentifier のStringValue に設定する。 - outerEnvを
running execution context のLexicalEnvironmentとする。 - funcEnvを
NewDeclarativeEnvironment (outerEnv)とする。 - ! funcEnv.
CreateImmutableBinding (name,false )を実行する。 - privateEnvを
running execution context のPrivateEnvironmentとする。 - sourceTextを
FunctionExpression によってmatchされたsource textとする。 - closureを
OrdinaryFunctionCreate (%Function.prototype% , sourceText,FormalParameters ,FunctionBody ,non-lexical-this , funcEnv, privateEnv)とする。 SetFunctionName (closure, name)を実行する。MakeConstructor (closure)を実行する。- ! funcEnv.
InitializeBinding (name, closure)を実行する。 - closureを返す。
15.2.6 Runtime Semantics: Evaluation
empty を返す。
alternative semanticsは、
empty を返す。
undefined を返す。
- result を
StatementList のEvaluation のCompletion とする。 - env を、実行中の実行コンテキストの LexicalEnvironment とする。
Assert : env はDeclarative Environment Record である。- Return ?
DisposeResources (env.[[DisposableResourceStack]], result).
15.3 Arrow Function Definitions
Syntax
Supplemental Syntax
production
のinstanceを処理するとき、
15.3.1 Static Semantics: Early Errors
-
ArrowParameters Contains YieldExpression がtrue である場合、それはSyntax Errorです。 -
ArrowParameters Contains AwaitExpression がtrue である場合、それはSyntax Errorです。 -
ConciseBody のConciseBodyContainsUseStrict がtrue であり、かつArrowParameters のIsSimpleParameterList がfalse である場合、それはSyntax Errorです。 -
ArrowParameters のBoundNames のいずれかの要素がConciseBody のLexicallyDeclaredNames にも出現する場合、それはSyntax Errorです。
-
CoverParenthesizedExpressionAndArrowParameterList はArrowFormalParameters をcoverしなければなりません。
15.3.2 Static Semantics: ConciseBodyContainsUseStrict
The
false を返す。
15.3.3 Runtime Semantics: EvaluateConciseBody
The
- ?
FunctionDeclarationInstantiation (funcObj, argList)を実行する。 ExpressionBody の ?Evaluation を返す。
15.3.4 Runtime Semantics: InstantiateArrowFunctionExpression
The
- nameが存在しない場合、nameをempty Stringに設定する。
- envRecordを
running execution context のLexicalEnvironmentとする。 - privateEnvを
running execution context のPrivateEnvironmentとする。 - sourceTextを
ArrowFunction によってmatchされたsource textとする。 - closureを
OrdinaryFunctionCreate (%Function.prototype% , sourceText,ArrowParameters ,ConciseBody ,lexical-this , envRecord, privateEnv)とする。 SetFunctionName (closure, name)を実行する。- closureを返す。
arguments、super、this、またはnew.targetに対するlocal bindingsを定義しません。arguments、super、this、またはnew.targetへのreferenceはいずれも、lexically enclosing environment内のbindingへresolveされなければなりません。通常、これは直ちに囲むfunctionのFunction Environmentになります。superへのreferencesを含む場合でも、step superをreferenceするsuperを実装するために必要なstateは、
15.3.5 Runtime Semantics: Evaluation
- exprRefを
AssignmentExpression の ?Evaluation とする。 - exprValueを ?
GetValue (exprRef) とする。 ReturnCompletion (exprValue)を返す。
15.4 Method Definitions
Syntax
15.4.1 Static Semantics: Early Errors
-
FunctionBody のFunctionBodyContainsUseStrict がtrue であり、かつUniqueFormalParameters のIsSimpleParameterList がfalse である場合、それはSyntax Errorです。 -
UniqueFormalParameters のBoundNames のいずれかの要素がFunctionBody のLexicallyDeclaredNames にも出現する場合、それはSyntax Errorです。
-
PropertySetParameterList のBoundNames が重複elementsを含む場合、それはSyntax Errorです。 -
FunctionBody のFunctionBodyContainsUseStrict がtrue であり、かつPropertySetParameterList のIsSimpleParameterList がfalse である場合、それはSyntax Errorです。 -
PropertySetParameterList のBoundNames のいずれかの要素がFunctionBody のLexicallyDeclaredNames にも出現する場合、それはSyntax Errorです。
15.4.2 Static Semantics: HasDirectSuper
The
UniqueFormalParameters Contains SuperCall がtrue なら、true を返す。FunctionBody Contains SuperCall を返す。
PropertySetParameterList Contains SuperCall がtrue なら、true を返す。FunctionBody Contains SuperCall を返す。
UniqueFormalParameters Contains SuperCall がtrue なら、true を返す。GeneratorBody Contains SuperCall を返す。
UniqueFormalParameters Contains SuperCall がtrue なら、true を返す。AsyncGeneratorBody Contains SuperCall を返す。
UniqueFormalParameters Contains SuperCall がtrue なら、true を返す。AsyncFunctionBody Contains SuperCall を返す。
15.4.3 Static Semantics: SpecialMethod
The
false を返す。
true を返す。
15.4.4 Runtime Semantics: DefineMethod
The
- propertyKeyを
ClassElementName の ?Evaluation とする。 - envRecordを
running execution context のLexicalEnvironmentとする。 - privateEnvを
running execution context のPrivateEnvironmentとする。 - protoが存在しないなら、protoを
%Function.prototype% に設定する。 - sourceTextを
MethodDefinition によってmatchされたsource textとする。 - closureを
OrdinaryFunctionCreate (proto, sourceText,UniqueFormalParameters ,FunctionBody ,non-lexical-this , envRecord, privateEnv)とする。 MakeMethod (closure, obj)を実行する。Record { [[Key]]: propertyKey, [[Closure]]: closure }を返す。
15.4.5 Runtime Semantics: MethodDefinitionEvaluation
The
- methodDefを、argument objを伴う
MethodDefinition の ?DefineMethod とする。 SetFunctionName (methodDef.[[Closure]], methodDef.[[Key]])を実行する。- ?
DefineMethodProperty (obj, methodDef.[[Key]], methodDef.[[Closure]], enumerable)を返す。
- propertyKeyを
ClassElementName の ?Evaluation とする。 - envRecordを
running execution context のLexicalEnvironmentとする。 - privateEnvを
running execution context のPrivateEnvironmentとする。 - sourceTextを
MethodDefinition によってmatchされたsource textとする。 - formalParamListをproduction
FormalParameters : [empty] - closureを
OrdinaryFunctionCreate (%Function.prototype% , sourceText, formalParamList,FunctionBody ,non-lexical-this , envRecord, privateEnv)とする。 MakeMethod (closure, obj)を実行する。SetFunctionName (closure, propertyKey,"get" )を実行する。- propertyKeyが
Private Name なら、PrivateElement { [[Key]]: propertyKey, [[Kind]]:accessor , [[Get]]: closure, [[Set]]:undefined }を返す。
- propertyDescをPropertyDescriptor { [[Get]]: closure, [[Enumerable]]: enumerable, [[Configurable]]:
true }とする。 - ?
DefinePropertyOrThrow (obj, propertyKey, propertyDesc)を実行する。 unused を返す。
- propertyKeyを
ClassElementName の ?Evaluation とする。 - envRecordを
running execution context のLexicalEnvironmentとする。 - privateEnvを
running execution context のPrivateEnvironmentとする。 - sourceTextを
MethodDefinition によってmatchされたsource textとする。 - closureを
OrdinaryFunctionCreate (%Function.prototype% , sourceText,PropertySetParameterList ,FunctionBody ,non-lexical-this , envRecord, privateEnv)とする。 MakeMethod (closure, obj)を実行する。SetFunctionName (closure, propertyKey,"set" )を実行する。- propertyKeyが
Private Name なら、PrivateElement { [[Key]]: propertyKey, [[Kind]]:accessor , [[Get]]:undefined , [[Set]]: closure }を返す。
- propertyDescをPropertyDescriptor { [[Set]]: closure, [[Enumerable]]: enumerable, [[Configurable]]:
true }とする。 - ?
DefinePropertyOrThrow (obj, propertyKey, propertyDesc)を実行する。 unused を返す。
- propertyKeyを
ClassElementName の ?Evaluation とする。 - envRecordを
running execution context のLexicalEnvironmentとする。 - privateEnvを
running execution context のPrivateEnvironmentとする。 - sourceTextを
GeneratorMethod によってmatchされたsource textとする。 - closureを
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,UniqueFormalParameters ,GeneratorBody ,non-lexical-this , envRecord, privateEnv)とする。 MakeMethod (closure, obj)を実行する。SetFunctionName (closure, propertyKey)を実行する。- protoを
OrdinaryObjectCreate (%GeneratorPrototype% )とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: proto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })を実行する。 - ?
DefineMethodProperty (obj, propertyKey, closure, enumerable)を返す。
- propertyKeyを
ClassElementName の ?Evaluation とする。 - envRecordを
running execution context のLexicalEnvironmentとする。 - privateEnvを
running execution context のPrivateEnvironmentとする。 - sourceTextを
AsyncGeneratorMethod によってmatchされたsource textとする。 - closureを
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,UniqueFormalParameters ,AsyncGeneratorBody ,non-lexical-this , envRecord, privateEnv)とする。 MakeMethod (closure, obj)を実行する。SetFunctionName (closure, propertyKey)を実行する。- protoを
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: proto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })を実行する。 - ?
DefineMethodProperty (obj, propertyKey, closure, enumerable)を返す。
- propertyKeyを
ClassElementName の ?Evaluation とする。 - envRecordを
running execution context のLexicalEnvironmentとする。 - privateEnvを
running execution context のPrivateEnvironmentとする。 - sourceTextを
AsyncMethod によってmatchされたsource textとする。 - closureを
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,UniqueFormalParameters ,AsyncFunctionBody ,non-lexical-this , envRecord, privateEnv)とする。 MakeMethod (closure, obj)を実行する。SetFunctionName (closure, propertyKey)を実行する。- ?
DefineMethodProperty (obj, propertyKey, closure, enumerable)を返す。
15.5 Generator Function Definitions
Syntax
yieldの直後のsyntactic contextでは、
Generatorsに関係する
15.5.1 Static Semantics: Early Errors
-
GeneratorMethod のHasDirectSuper がtrue である場合、それはSyntax Errorです。 -
UniqueFormalParameters Contains YieldExpression がtrue である場合、それはSyntax Errorです。 -
GeneratorBody のFunctionBodyContainsUseStrict がtrue であり、かつUniqueFormalParameters のIsSimpleParameterList がfalse である場合、それはSyntax Errorです。 -
UniqueFormalParameters のBoundNames のいずれかの要素がGeneratorBody のLexicallyDeclaredNames にも出現する場合、それはSyntax Errorです。
-
IsStrict (FormalParameters )がtrue である場合、UniqueFormalParameters : FormalParameters -
BindingIdentifier が存在し、かつIsStrict (BindingIdentifier )がtrue である場合、BindingIdentifier のStringValue が"eval" または"arguments" のいずれかであるなら、それはSyntax Errorです。 -
GeneratorBody のFunctionBodyContainsUseStrict がtrue であり、かつFormalParameters のIsSimpleParameterList がfalse である場合、それはSyntax Errorです。 -
FormalParameters のBoundNames のいずれかの要素がGeneratorBody のLexicallyDeclaredNames にも出現する場合、それはSyntax Errorです。 -
FormalParameters Contains YieldExpression がtrue である場合、それはSyntax Errorです。 -
FormalParameters Contains SuperProperty がtrue である場合、それはSyntax Errorです。 -
GeneratorBody Contains SuperProperty がtrue である場合、それはSyntax Errorです。 -
FormalParameters Contains SuperCall がtrue である場合、それはSyntax Errorです。 -
GeneratorBody Contains SuperCall がtrue である場合、それはSyntax Errorです。
15.5.2 Runtime Semantics: EvaluateGeneratorBody
The
- ?
FunctionDeclarationInstantiation (funcObj, argList)を実行する。 - genを ?
OrdinaryCreateFromConstructor (funcObj,"%GeneratorPrototype%" , « [[GeneratorState]], [[GeneratorContext]], [[GeneratorBrand]] ») とする。 - gen.[[GeneratorBrand]]を
empty に設定する。 - gen.[[GeneratorState]]を
suspended-start に設定する。 GeneratorStart (gen,FunctionBody )を実行する。ReturnCompletion (gen)を返す。
15.5.3 Runtime Semantics: InstantiateGeneratorFunctionObject
The
- nameを
BindingIdentifier のStringValue とする。 - sourceTextを
GeneratorDeclaration によってmatchされたsource textとする。 - closureを
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,FormalParameters ,GeneratorBody ,non-lexical-this , envRecord, privateEnv)とする。 SetFunctionName (closure, name)を実行する。- protoを
OrdinaryObjectCreate (%GeneratorPrototype% )とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: proto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })を実行する。 - closureを返す。
- sourceTextを
GeneratorDeclaration によってmatchされたsource textとする。 - closureを
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,FormalParameters ,GeneratorBody ,non-lexical-this , envRecord, privateEnv)とする。 SetFunctionName (closure,"default" )を実行する。- protoを
OrdinaryObjectCreate (%GeneratorPrototype% )とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: proto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })を実行する。 - closureを返す。
anonymous export default declarationの一部としてのみ出現できるため、そのfunction codeは常に
15.5.4 Runtime Semantics: InstantiateGeneratorFunctionExpression
The
- nameが存在しない場合、nameをempty Stringに設定する。
- envRecordを
running execution context のLexicalEnvironmentとする。 - privateEnvを
running execution context のPrivateEnvironmentとする。 - sourceTextを
GeneratorExpression によってmatchされたsource textとする。 - closureを
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,FormalParameters ,GeneratorBody ,non-lexical-this , envRecord, privateEnv)とする。 SetFunctionName (closure, name)を実行する。- protoを
OrdinaryObjectCreate (%GeneratorPrototype% )とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: proto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })を実行する。 - closureを返す。
Assert : nameは存在しない。- nameを
BindingIdentifier のStringValue に設定する。 - outerEnvを
running execution context のLexicalEnvironmentとする。 - funcEnvを
NewDeclarativeEnvironment (outerEnv)とする。 - ! funcEnv.
CreateImmutableBinding (name,false )を実行する。 - privateEnvを
running execution context のPrivateEnvironmentとする。 - sourceTextを
GeneratorExpression によってmatchされたsource textとする。 - closureを
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,FormalParameters ,GeneratorBody ,non-lexical-this , funcEnv, privateEnv)とする。 SetFunctionName (closure, name)を実行する。- protoを
OrdinaryObjectCreate (%GeneratorPrototype% )とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: proto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })を実行する。 - ! funcEnv.
InitializeBinding (name, closure)を実行する。 - closureを返す。
15.5.5 Runtime Semantics: Evaluation
- ?
Yield (undefined )を返す。
- exprRefを
AssignmentExpression の ?Evaluation とする。 - valueを ?
GetValue (exprRef) とする。 - ?
Yield (value)を返す。
- genKindを
GetGeneratorKind ()とする。 Assert : genKindはsync またはasync のいずれかである。- exprRefを
AssignmentExpression の ?Evaluation とする。 - valueを ?
GetValue (exprRef) とする。 - iteratorRecordを ?
GetIterator (value, genKind) とする。 - iteratorをiteratorRecord.[[Iterator]]とする。
- receivedを
NormalCompletion (undefined )とする。 - 繰り返す
- receivedが
normal completion なら、- innerResultを ?
Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]], « received.[[Value]] ») とする。 - genKindが
async なら、innerResultを ?Await (innerResult) に設定する。 - innerResultがObjectでないなら、
TypeError 例外をthrowする。 - doneを ?
IteratorComplete (innerResult) とする。 - doneが
true なら、- ?
IteratorValue (innerResult)を返す。
- ?
- genKindが
async なら、receivedをCompletion (AsyncGeneratorYield (?IteratorValue (innerResult)))に設定する。 - そうでなければ、receivedを
Completion (GeneratorYield (innerResult))に設定する。
- innerResultを ?
- そうでなく、receivedが
throw completion なら、- throwを ?
GetMethod (iterator,"throw" ) とする。 - throwが
undefined でないなら、- innerResultを ?
Call (throw, iterator, « received.[[Value]] ») とする。 - genKindが
async なら、innerResultを ?Await (innerResult) に設定する。 NOTE : inneriterator のthrowmethodからのexceptionsは伝播される。innerthrowmethodからのnormal completions は、innernextと同様に処理される。- innerResultがObjectでないなら、
TypeError 例外をthrowする。 - doneを ?
IteratorComplete (innerResult) とする。 - doneが
true なら、- ?
IteratorValue (innerResult)を返す。
- ?
- genKindが
async なら、receivedをCompletion (AsyncGeneratorYield (?IteratorValue (innerResult)))に設定する。 - そうでなければ、receivedを
Completion (GeneratorYield (innerResult))に設定する。
- innerResultを ?
- そうでなければ、
NOTE : iteratorがthrowmethodを持たない場合、このthrowはyield*loopを終了させることになる。しかし、まずiteratorにclean upの機会を与える必要がある。- closeCompletionを
NormalCompletion (empty )とする。 - genKindが
async なら、?AsyncIteratorClose (iteratorRecord, closeCompletion)を実行する。 - そうでなければ、?
IteratorClose (iteratorRecord, closeCompletion)を実行する。 NOTE : next stepは、yield*protocol violationがあったこと、すなわちiteratorがthrowmethodを持たないことを示すためにTypeError をthrowする。TypeError 例外をthrowする。
- throwを ?
- そうでなければ、
Assert : receivedはreturn completion である。- returnを ?
GetMethod (iterator,"return" ) とする。 - returnが
undefined なら、- receivedValueをreceived.[[Value]]とする。
- genKindが
async なら、- receivedValueを ?
Await (receivedValue) に設定する。
- receivedValueを ?
ReturnCompletion (receivedValue)を返す。
- innerReturnResultを ?
Call (return, iterator, « received.[[Value]] ») とする。 - genKindが
async なら、innerReturnResultを ?Await (innerReturnResult) に設定する。 - innerReturnResultがObjectでないなら、
TypeError 例外をthrowする。 - doneを ?
IteratorComplete (innerReturnResult) とする。 - doneが
true なら、- returnedValueを ?
IteratorValue (innerReturnResult) とする。 ReturnCompletion (returnedValue)を返す。
- returnedValueを ?
- genKindが
async なら、receivedをCompletion (AsyncGeneratorYield (?IteratorValue (innerReturnResult)))に設定する。 - そうでなければ、receivedを
Completion (GeneratorYield (innerReturnResult))に設定する。
- receivedが
15.6 Async Generator Function Definitions
Syntax
AsyncGeneratorsに関係する
15.6.1 Static Semantics: Early Errors
AsyncGeneratorMethod のHasDirectSuper がtrue である場合、それはSyntax Errorです。UniqueFormalParameters Contains YieldExpression がtrue である場合、それはSyntax Errorです。UniqueFormalParameters Contains AwaitExpression がtrue である場合、それはSyntax Errorです。AsyncGeneratorBody のFunctionBodyContainsUseStrict がtrue であり、かつUniqueFormalParameters のIsSimpleParameterList がfalse である場合、それはSyntax Errorです。UniqueFormalParameters のBoundNames のいずれかの要素がAsyncGeneratorBody のLexicallyDeclaredNames にも出現する場合、それはSyntax Errorです。
IsStrict (FormalParameters )がtrue である場合、UniqueFormalParameters : FormalParameters BindingIdentifier が存在し、かつIsStrict (BindingIdentifier )がtrue である場合、BindingIdentifier のStringValue が"eval" または"arguments" のいずれかであるなら、それはSyntax Errorです。AsyncGeneratorBody のFunctionBodyContainsUseStrict がtrue であり、かつFormalParameters のIsSimpleParameterList がfalse である場合、それはSyntax Errorです。FormalParameters のBoundNames のいずれかの要素がAsyncGeneratorBody のLexicallyDeclaredNames にも出現する場合、それはSyntax Errorです。FormalParameters Contains YieldExpression がtrue である場合、それはSyntax Errorです。FormalParameters Contains AwaitExpression がtrue である場合、それはSyntax Errorです。FormalParameters Contains SuperProperty がtrue である場合、それはSyntax Errorです。AsyncGeneratorBody Contains SuperProperty がtrue である場合、それはSyntax Errorです。FormalParameters Contains SuperCall がtrue である場合、それはSyntax Errorです。AsyncGeneratorBody Contains SuperCall がtrue である場合、それはSyntax Errorです。
15.6.2 Runtime Semantics: EvaluateAsyncGeneratorBody
The
- ?
FunctionDeclarationInstantiation (funcObj, argList)を実行する。 - genを ?
OrdinaryCreateFromConstructor (funcObj,"%AsyncGeneratorPrototype%" , « [[AsyncGeneratorState]], [[AsyncGeneratorContext]], [[AsyncGeneratorQueue]], [[GeneratorBrand]] ») とする。 - gen.[[GeneratorBrand]]を
empty に設定する。 - gen.[[AsyncGeneratorState]]を
suspended-start に設定する。 AsyncGeneratorStart (gen,FunctionBody )を実行する。ReturnCompletion (gen)を返す。
15.6.3 Runtime Semantics: InstantiateAsyncGeneratorFunctionObject
The
- nameを
BindingIdentifier のStringValue とする。 - sourceTextを
AsyncGeneratorDeclaration によってmatchされたsource textとする。 - closureを
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,FormalParameters ,AsyncGeneratorBody ,non-lexical-this , envRecord, privateEnv)とする。 SetFunctionName (closure, name)を実行する。- protoを
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: proto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })を実行する。 - closureを返す。
- sourceTextを
AsyncGeneratorDeclaration によってmatchされたsource textとする。 - closureを
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,FormalParameters ,AsyncGeneratorBody ,non-lexical-this , envRecord, privateEnv)とする。 SetFunctionName (closure,"default" )を実行する。- protoを
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: proto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })を実行する。 - closureを返す。
anonymous export default declarationの一部としてのみ出現できます。
15.6.4 Runtime Semantics: InstantiateAsyncGeneratorFunctionExpression
The
- nameが存在しない場合、nameをempty Stringに設定する。
- envRecordを
running execution context のLexicalEnvironmentとする。 - privateEnvを
running execution context のPrivateEnvironmentとする。 - sourceTextを
AsyncGeneratorExpression によってmatchされたsource textとする。 - closureを
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,FormalParameters ,AsyncGeneratorBody ,non-lexical-this , envRecord, privateEnv)とする。 SetFunctionName (closure, name)を実行する。- protoを
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: proto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })を実行する。 - closureを返す。
Assert : nameは存在しない。- nameを
BindingIdentifier のStringValue に設定する。 - outerEnvを
running execution context のLexicalEnvironmentとする。 - funcEnvを
NewDeclarativeEnvironment (outerEnv)とする。 - ! funcEnv.
CreateImmutableBinding (name,false )を実行する。 - privateEnvを
running execution context のPrivateEnvironmentとする。 - sourceTextを
AsyncGeneratorExpression によってmatchされたsource textとする。 - closureを
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,FormalParameters ,AsyncGeneratorBody ,non-lexical-this , funcEnv, privateEnv)とする。 SetFunctionName (closure, name)を実行する。- protoを
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: proto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })を実行する。 - ! funcEnv.
InitializeBinding (name, closure)を実行する。 - closureを返す。
15.6.5 Runtime Semantics: Evaluation
15.7 Class Definitions
Syntax
class definitionは常に
15.7.1 Static Semantics: Early Errors
-
ClassHeritage が存在せず、かつ次のalgorithmがtrue を返す場合、それはSyntax Errorです：- ctorを
ClassBody のConstructorMethod とする。 - ctorが
empty なら、false を返す。 - ctorの
HasDirectSuper を返す。
- ctorを
-
ClassElementList のPrototypePropertyNameList が"constructor" の出現を複数含む場合、それはSyntax Errorです。 -
ClassElementList のPrivateBoundIdentifiers が重複entriesを含む場合、それはSyntax Errorです。ただし、そのnameがgetterに1回、setterに1回だけ使用され、他のentriesでは使用されず、getterとsetterが両方ともstaticまたは両方ともnon-staticである場合を除きます。
-
MethodDefinition のPropName が"constructor" でなく、かつMethodDefinition のHasDirectSuper がtrue である場合、それはSyntax Errorです。 -
MethodDefinition のPropName が"constructor" であり、かつMethodDefinition のSpecialMethod がtrue である場合、それはSyntax Errorです。
-
MethodDefinition のHasDirectSuper がtrue である場合、それはSyntax Errorです。 -
MethodDefinition のPropName が"prototype" である場合、それはSyntax Errorです。
FieldDefinition のPropName が"constructor" である場合、それはSyntax Errorです。
-
FieldDefinition のPropName が"prototype" または"constructor" のいずれかである場合、それはSyntax Errorです。
Initializer が存在し、かつInitializer のContainsArguments がtrue である場合、それはSyntax Errorです。Initializer が存在し、かつInitializer Contains SuperCall がtrue である場合、それはSyntax Errorです。
PrivateIdentifier のStringValue が"#constructor" である場合、それはSyntax Errorです。
-
ClassStaticBlockStatementList のLexicallyDeclaredNames が重複entriesを含む場合、それはSyntax Errorです。 -
ClassStaticBlockStatementList のLexicallyDeclaredNames のいずれかの要素がClassStaticBlockStatementList のVarDeclaredNames にも出現する場合、それはSyntax Errorです。 -
argument « »を伴う
ClassStaticBlockStatementList のContainsDuplicateLabels がtrue である場合、それはSyntax Errorです。 -
argument « »を伴う
ClassStaticBlockStatementList のContainsUndefinedBreakTarget がtrue である場合、それはSyntax Errorです。 -
arguments « »および« »を伴う
ClassStaticBlockStatementList のContainsUndefinedContinueTarget がtrue である場合、それはSyntax Errorです。 -
ClassStaticBlockStatementList のContainsArguments がtrue である場合、それはSyntax Errorです。 -
ClassStaticBlockStatementList Contains SuperCall がtrue である場合、それはSyntax Errorです。 -
ClassStaticBlockStatementList Contains awaitがtrue である場合、それはSyntax Errorです。
15.7.2 Static Semantics: ClassElementKind
The
MethodDefinition のPropName が"constructor" なら、constructor-method を返す。non-constructor-method を返す。
non-constructor-method を返す。
non-constructor-method を返す。
empty を返す。
15.7.3 Static Semantics: ConstructorMethod
The
ClassElement のClassElementKind がconstructor-method なら、ClassElement を返す。empty を返す。
- headを
ClassElementList のConstructorMethod とする。 - headが
empty でないなら、headを返す。 ClassElement のClassElementKind がconstructor-method なら、ClassElement を返す。empty を返す。
Early Error rulesは、
15.7.4 Static Semantics: IsStatic
The
false を返す。
true を返す。
false を返す。
true を返す。
true を返す。
false を返す。
15.7.5 Static Semantics: NonConstructorElements
The
ClassElement のClassElementKind がnon-constructor-method なら、- «
ClassElement »を返す。
- «
- 新しい空の
List を返す。
- listを
ClassElementList のNonConstructorElements とする。 ClassElement のClassElementKind がnon-constructor-method なら、ClassElement をlistへappendする。
- listを返す。
15.7.6 Static Semantics: PrototypePropertyNameList
The
- propertyNameを
ClassElement のPropName とする。 - propertyNameが
empty なら、新しい空のList を返す。 ClassElement のIsStatic がtrue なら、新しい空のList を返す。- « propertyName »を返す。
- listを
ClassElementList のPrototypePropertyNameList とする。 - propertyNameを
ClassElement のPropName とする。 - propertyNameが
empty なら、listを返す。 ClassElement のIsStatic がtrue なら、listを返す。- listと« propertyName »の
list-concatenation を返す。
15.7.7 Static Semantics: AllPrivateIdentifiersValid
The
この仕様内で下に列挙されていないすべてのgrammar production alternativeは、暗黙的にAllPrivateIdentifiersValidの次のdefault definitionを持ちます：
- この
Parse Node の各child node childについて、以下を行う- childがnonterminalのinstanceなら、
- argument namesを伴うchildの
AllPrivateIdentifiersValid がfalse なら、false を返す。
- argument namesを伴うchildの
- childがnonterminalのinstanceなら、
true を返す。
- namesが
PrivateIdentifier のStringValue を含むなら、- argument namesを伴う
MemberExpression のAllPrivateIdentifiersValid を返す。
- argument namesを伴う
false を返す。
- namesが
PrivateIdentifier のStringValue を含むなら、- argument namesを伴う
CallExpression のAllPrivateIdentifiersValid を返す。
- argument namesを伴う
false を返す。
- namesが
PrivateIdentifier のStringValue を含むなら、true を返す。 false を返す。
- namesが
PrivateIdentifier のStringValue を含むなら、- argument namesを伴う
OptionalChain のAllPrivateIdentifiersValid を返す。
- argument namesを伴う
false を返す。
- newNamesをnamesと
ClassBody のPrivateBoundIdentifiers のlist-concatenation とする。 - argument newNamesを伴う
ClassElementList のAllPrivateIdentifiersValid を返す。
- namesが
PrivateIdentifier のStringValue を含むなら、- argument namesを伴う
ShiftExpression のAllPrivateIdentifiersValid を返す。
- argument namesを伴う
false を返す。
15.7.8 Static Semantics: PrivateBoundIdentifiers
The
- 唯一の要素が
PrivateIdentifier のStringValue であるList を返す。
- 新しい空の
List を返す。
- names1を
ClassElementList のPrivateBoundIdentifiers とする。 - names2を
ClassElement のPrivateBoundIdentifiers とする。 - names1とnames2の
list-concatenation を返す。
15.7.9 Static Semantics: ContainsArguments
The
この仕様内で下に列挙されていないすべてのgrammar production alternativeは、暗黙的にContainsArgumentsの次のdefault definitionを持ちます：
- この
Parse Node の各child node childについて、以下を行う- childがnonterminalのinstanceなら、
- childの
ContainsArguments がtrue なら、true を返す。
- childの
- childがnonterminalのinstanceなら、
false を返す。
Identifier のStringValue が"arguments" なら、true を返す。false を返す。
false を返す。
15.7.10 Runtime Semantics: ClassFieldDefinitionEvaluation
The
- nameを
ClassElementName の ?Evaluation とする。 Initializer が存在するなら、- formalParamListをproduction
FormalParameters : [empty] - envRecordを
running execution context のLexicalEnvironmentとする。 - privateEnvを
running execution context のPrivateEnvironmentとする。 - sourceTextをUnicode code pointsのempty sequenceとする。
- initializerを
OrdinaryFunctionCreate (%Function.prototype% , sourceText, formalParamList,Initializer ,non-lexical-this , envRecord, privateEnv)とする。 MakeMethod (initializer, homeObj)を実行する。- initializer.[[ClassFieldInitializerName]]をnameに設定する。
- formalParamListをproduction
- そうでなければ、
- initializerを
empty とする。
- initializerを
ClassFieldDefinition Record { [[Name]]: name, [[Initializer]]: initializer }を返す。
15.7.11 Runtime Semantics: ClassStaticBlockDefinitionEvaluation
The
- 実行中の実行コンテキストのLexicalEnvironmentをlexicalEnvとする。
- 実行中の実行コンテキストのPrivateEnvironmentをprivateEnvとする。
- 空のUnicode符号点列をsourceTextとする。
- 生成規則
FormalParameters : [empty] OrdinaryFunctionCreate (%Function.prototype% , sourceText, formalParams,ClassStaticBlockBody ,non-lexical-this , lexicalEnv, privateEnv)をbodyFuncとする。MakeMethod (bodyFunc, homeObj)を実行する。ClassStaticBlockDefinition Record { [[BodyFunction]]: bodyFunc }を返す。
15.7.12 Runtime Semantics: EvaluateClassStaticBlockBody
The
Assert : funcObj はClassStaticBlockDefinitionEvaluation ステップ5 によって作成された合成関数である。- !
FunctionDeclarationInstantiation (funcObj, « ») を実行する。 - result を
ClassStaticBlockStatementList のEvaluation のCompletion とする。 - envRecord を、実行中の実行コンテキストの LexicalEnvironment とする。
Assert : envRecord はDeclarative Environment Record である。- ?
DisposeResources (envRecord.[[DisposableResourceStack]], result) を実行する。 ReturnCompletion (undefined ) を返す。
15.7.13 Runtime Semantics: ClassElementEvaluation
The
- argument objを伴う
FieldDefinition の ?ClassFieldDefinitionEvaluation を返す。
- arguments objおよび
false を伴うMethodDefinition の ?MethodDefinitionEvaluation を返す。
- argument objを伴う
ClassStaticBlock のClassStaticBlockDefinitionEvaluation を返す。
unused を返す。
15.7.14 Runtime Semantics: ClassDefinitionEvaluation
The
specificationの容易さのため、private methodsおよびaccessorsは、private fieldsと並んでclass instancesの[[PrivateElements]] slotに含められます。ただし、任意のobjectは、与えられたclassによって定義されるprivate methodsおよびaccessorsのすべてを持つか、まったく持たないかのいずれかです。この機能は、implementationsが各methodまたはaccessorを個別にtrackする必要のないstrategyを使用してprivate methodsおよびaccessorsを実装することを選択できるように設計されています。
例えば、implementationはinstance private methodsをそれらに対応するthis valueとして実行されたかをtrackできます。object上でinstance private methodをlookupすることは、そのmethodを定義するclass
これはprivate fieldsとは異なります。field initializersはclass instantiation中にthrowする可能性があるため、個々のobjectは与えられたclassのprivate fieldsのproper subsetだけを持つ場合があり、そのためprivate fieldsは一般に個別にtrackされなければなりません。
It is defined piecewise over the following productions:
- envRecordを
running execution context のLexicalEnvironmentとする。 - classEnvを
NewDeclarativeEnvironment (envRecord)とする。 - classBindingが
undefined でないなら、- ! classEnv.
CreateImmutableBinding (classBinding,true )を実行する。
- ! classEnv.
- outerPrivateEnvを
running execution context のPrivateEnvironmentとする。 - classPrivateEnvを
NewPrivateEnvironment (outerPrivateEnv)とする。 ClassBody が存在するなら、ClassBody のPrivateBoundIdentifiers の各String descriptionについて、以下を行う- classPrivateEnv.[[Names]]が、[[Description]]がdescriptionである
Private Name privateNameを含むなら、Assert : これはgetter/setter pairsの場合にのみ可能である。
- そうでなければ、
- nameを、その[[Description]]がdescriptionである新しい
Private Name とする。 - nameをclassPrivateEnv.[[Names]]へappendする。
- nameを、その[[Description]]がdescriptionである新しい
- classPrivateEnv.[[Names]]が、[[Description]]がdescriptionである
ClassHeritage が存在しないなら、- protoParentを
%Object.prototype% とする。 - ctorParentを
%Function.prototype% とする。
- protoParentを
- そうでなければ、
running execution context のLexicalEnvironmentをclassEnvに設定する。NOTE :ClassHeritage を評価するとき、running execution context のPrivateEnvironmentはouterPrivateEnvである。- superclassRefを
ClassHeritage のEvaluation のCompletion とする。 running execution context のLexicalEnvironmentをenvRecordに設定する。- superclassを ?
GetValue (? superclassRef) とする。 - superclassが
null なら、- protoParentを
null とする。 - ctorParentを
%Function.prototype% とする。
- protoParentを
- そうでなく、
IsConstructor (superclass)がfalse なら、TypeError 例外をthrowする。
- そうでなければ、
- protoParentを ?
Get (superclass,"prototype" ) とする。 - protoParentがObjectでなく、かつprotoParentが
null でないなら、TypeError 例外をthrowする。 - ctorParentをsuperclassとする。
- protoParentを ?
- protoを
OrdinaryObjectCreate (protoParent)とする。 ClassBody が存在しないなら、ctorをempty とする。- そうでなければ、ctorを
ClassBody のConstructorMethod とする。 running execution context のLexicalEnvironmentをclassEnvに設定する。running execution context のPrivateEnvironmentをclassPrivateEnvに設定する。- ctorが
empty なら、- defaultCtorを、parametersを持たず、何もcaptureせず、呼び出されたときに次のstepsを実行する新しい
Abstract Closure とする：- argsを、このfunctionに[[Call]]または[[Construct]]によって渡されたargumentsの
List とする。 - NewTargetが
undefined なら、TypeError 例外をthrowする。 - ctorFuncを
active function object とする。 - ctorFunc.[[ConstructorKind]]が
derived なら、NOTE : このbranchはconstructor(...args) { super(...args); }と同様に振る舞う。最も注目すべき違いは、前述のECMAScript source text が%Array.prototype%上の%Symbol.iterator% methodをobservablyに呼び出すのに対し、このfunctionはそれを行わないことである。- funcを ! ctorFunc.[[GetPrototypeOf]]() とする。
IsConstructor (func)がfalse なら、TypeError 例外をthrowする。- resultを ?
Construct (func, args, NewTarget) とする。
- そうでなければ、
NOTE : このbranchはconstructor() {}と同様に振る舞う。- resultを ?
OrdinaryCreateFromConstructor (NewTarget,"%Object.prototype%" ) とする。
- ?
InitializeInstanceElements (result, ctorFunc)を実行する。 NormalCompletion (result)を返す。
- argsを、このfunctionに[[Call]]または[[Construct]]によって渡されたargumentsの
- ctorFuncを
CreateBuiltinFunction (defaultCtor, 0, className, « [[ConstructorKind]], [[SourceText]], [[PrivateMethods]], [[Fields]] », thecurrent Realm Record , ctorParent)とする。
- defaultCtorを、parametersを持たず、何もcaptureせず、呼び出されたときに次のstepsを実行する新しい
- そうでなければ、
- ctorInfoを、arguments protoおよびctorParentを伴うctorの !
DefineMethod とする。 - ctorFuncをctorInfo.[[Closure]]とする。
MakeClassConstructor (ctorFunc)を実行する。SetFunctionName (ctorFunc, className)を実行する。
- ctorInfoを、arguments protoおよびctorParentを伴うctorの !
- ctorFunc.[[SourceText]]をsourceTextに設定する。
MakeConstructor (ctorFunc,false , proto)を実行する。ClassHeritage が存在するなら、ctorFunc.[[ConstructorKind]]をderived に設定する。- !
DefineMethodProperty (proto,"constructor" , ctorFunc,false )を実行する。 ClassBody が存在しないなら、classElementsを新しい空のList とする。- そうでなければ、classElementsを
ClassBody のNonConstructorElements とする。 - instancePrivateMethodsを新しい空の
List とする。 - staticPrivateMethodsを新しい空の
List とする。 - instanceFieldsを新しい空の
List とする。 - staticElementsを新しい空の
List とする。 - classElementsの各
ClassElement classElementについて、以下を行う- classElementの
IsStatic がfalse なら、- elementを、argument protoを伴うclassElementの
ClassElementEvaluation のCompletion とする。
- elementを、argument protoを伴うclassElementの
- そうでなければ、
- elementを、argument ctorFuncを伴うclassElementの
ClassElementEvaluation のCompletion とする。
- elementを、argument ctorFuncを伴うclassElementの
- elementが
abrupt completion なら、running execution context のLexicalEnvironmentをenvRecordに設定する。running execution context のPrivateEnvironmentをouterPrivateEnvに設定する。- ? elementを返す。
- elementを ! element に設定する。
- elementが
PrivateElement なら、Assert : element.[[Kind]]はmethod またはaccessor のいずれかである。- classElementの
IsStatic がfalse なら、containerをinstancePrivateMethodsとする。 - そうでなければ、containerをstaticPrivateMethodsとする。
- containerが、その[[Key]]がelement.[[Key]]である
PrivateElement existingElementを含むなら、Assert : element.[[Kind]]とexistingElement.[[Kind]]は両方ともaccessor である。- element.[[Get]]が
undefined なら、- combinedを
PrivateElement { [[Key]]: element.[[Key]], [[Kind]]:accessor , [[Get]]: existingElement.[[Get]], [[Set]]: element.[[Set]] }とする。
- combinedを
- そうでなければ、
- combinedを
PrivateElement { [[Key]]: element.[[Key]], [[Kind]]:accessor , [[Get]]: element.[[Get]], [[Set]]: existingElement.[[Set]] }とする。
- combinedを
- container内のexistingElementをcombinedで置き換える。
- そうでなければ、
- elementをcontainerへappendする。
- そうでなく、elementが
ClassFieldDefinition Record なら、- classElementの
IsStatic がfalse なら、elementをinstanceFieldsへappendする。 - そうでなければ、elementをstaticElementsへappendする。
- classElementの
- そうでなく、elementが
ClassStaticBlockDefinition Record なら、- elementをstaticElementsへappendする。
- classElementの
running execution context のLexicalEnvironmentをenvRecordに設定する。- classBindingが
undefined でないなら、- ! classEnv.
InitializeBinding (classBinding, ctorFunc)を実行する。
- ! classEnv.
- ctorFunc.[[PrivateMethods]]をinstancePrivateMethodsに設定する。
- ctorFunc.[[Fields]]をinstanceFieldsに設定する。
- staticPrivateMethodsの各
PrivateElement methodについて、以下を行う- !
PrivateMethodOrAccessorAdd (ctorFunc, method)を実行する。
- !
- staticElementsの各要素elementRecordについて、以下を行う
- elementRecordが
ClassFieldDefinition Record なら、- resultを
DefineField (ctorFunc, elementRecord)のCompletion とする。
- resultを
- そうでなければ、
Assert : elementRecordはClassStaticBlockDefinition Record である。- resultを
Call (elementRecord.[[BodyFunction]], ctorFunc)のCompletion とする。
- resultが
abrupt completion なら、running execution context のPrivateEnvironmentをouterPrivateEnvに設定する。- ? resultを返す。
- elementRecordが
running execution context のPrivateEnvironmentをouterPrivateEnvに設定する。- ctorFuncを返す。
15.7.15 Runtime Semantics: BindingClassDeclarationEvaluation
The
- classNameを
BindingIdentifier のStringValue とする。 - sourceTextを
ClassDeclaration によってmatchされたsource textとする。 - valueを、arguments className、className、およびsourceTextを伴う
ClassTail の ?ClassDefinitionEvaluation とする。 - envRecordを
running execution context のLexicalEnvironmentとする。 - ?
InitializeBoundName (className, value, envRecord)を実行する。 - valueを返す。
- sourceTextを
ClassDeclaration によってmatchされたsource textとする。 - arguments
undefined 、"default" 、およびsourceTextを伴うClassTail の ?ClassDefinitionEvaluation を返す。
15.7.16 Runtime Semantics: Evaluation
- this
ClassDeclaration の ?BindingClassDeclarationEvaluation を実行する。 empty を返す。
- sourceTextを
ClassExpression によってmatchされたsource textとする。 - arguments
undefined 、empty String、およびsourceTextを伴うClassTail の ?ClassDefinitionEvaluation を返す。
- classNameを
BindingIdentifier のStringValue とする。 - sourceTextを
ClassExpression によってmatchされたsource textとする。 - arguments className、className、およびsourceTextを伴う
ClassTail の ?ClassDefinitionEvaluation を返す。
- privateIdentifierを
PrivateIdentifier のStringValue とする。 - privateEnvRecordを
running execution context のPrivateEnvironmentとする。 - namesをprivateEnvRecord.[[Names]]とする。
Assert : namesのちょうど1つの要素が、その[[Description]]がprivateIdentifierであるPrivate Name である。- privateNameを、names内の、その[[Description]]がprivateIdentifierである
Private Name とする。 - privateNameを返す。
undefined を返す。
15.8 Async Function Definitions
Syntax
[Await] parameterが存在するとき、awaitは
AsyncFunctionBody 内。AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、またはAsyncGeneratorExpression のFormalParameters 内。この位置のAwaitExpression はstatic semantics によってSyntax errorになります。Module 内。
awaitはidentifierとしてparseされる場合があります。これには次のcontextsが含まれます：
15.8.1 Static Semantics: Early Errors
AsyncFunctionBody のFunctionBodyContainsUseStrict がtrue であり、かつUniqueFormalParameters のIsSimpleParameterList がfalse である場合、それはSyntax Errorです。AsyncMethod のHasDirectSuper がtrue である場合、それはSyntax Errorです。UniqueFormalParameters Contains AwaitExpression がtrue である場合、それはSyntax Errorです。UniqueFormalParameters のBoundNames のいずれかの要素がAsyncFunctionBody のLexicallyDeclaredNames にも出現する場合、それはSyntax Errorです。
AsyncFunctionBody のFunctionBodyContainsUseStrict がtrue であり、かつFormalParameters のIsSimpleParameterList がfalse である場合、それはSyntax Errorです。FormalParameters Contains AwaitExpression がtrue である場合、それはSyntax Errorです。IsStrict (FormalParameters )がtrue である場合、UniqueFormalParameters : FormalParameters BindingIdentifier が存在し、かつIsStrict (BindingIdentifier )がtrue である場合、BindingIdentifier のStringValue が"eval" または"arguments" のいずれかであるなら、それはSyntax Errorです。FormalParameters のBoundNames のいずれかの要素がAsyncFunctionBody のLexicallyDeclaredNames にも出現する場合、それはSyntax Errorです。FormalParameters Contains SuperProperty がtrue である場合、それはSyntax Errorです。AsyncFunctionBody Contains SuperProperty がtrue である場合、それはSyntax Errorです。FormalParameters Contains SuperCall がtrue である場合、それはSyntax Errorです。AsyncFunctionBody Contains SuperCall がtrue である場合、それはSyntax Errorです。
15.8.2 Runtime Semantics: InstantiateAsyncFunctionObject
The
- nameを
BindingIdentifier のStringValue とする。 - sourceTextを
AsyncFunctionDeclaration によってmatchされたsource textとする。 - closureを
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,FormalParameters ,AsyncFunctionBody ,non-lexical-this , envRecord, privateEnv)とする。 SetFunctionName (closure, name)を実行する。- closureを返す。
- sourceTextを
AsyncFunctionDeclaration によってmatchされたsource textとする。 - closureを
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,FormalParameters ,AsyncFunctionBody ,non-lexical-this , envRecord, privateEnv)とする。 SetFunctionName (closure,"default" )を実行する。- closureを返す。
15.8.3 Runtime Semantics: InstantiateAsyncFunctionExpression
The
- nameが存在しない場合、nameをempty Stringに設定する。
- envRecordを
running execution context のLexicalEnvironmentとする。 - privateEnvを
running execution context のPrivateEnvironmentとする。 - sourceTextを
AsyncFunctionExpression によってmatchされたsource textとする。 - closureを
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,FormalParameters ,AsyncFunctionBody ,non-lexical-this , envRecord, privateEnv)とする。 SetFunctionName (closure, name)を実行する。- closureを返す。
Assert : nameは存在しない。- nameを
BindingIdentifier のStringValue に設定する。 - outerEnvを
running execution context のLexicalEnvironmentとする。 - funcEnvを
NewDeclarativeEnvironment (outerEnv)とする。 - ! funcEnv.
CreateImmutableBinding (name,false )を実行する。 - privateEnvを
running execution context のPrivateEnvironmentとする。 - sourceTextを
AsyncFunctionExpression によってmatchされたsource textとする。 - closureを
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,FormalParameters ,AsyncFunctionBody ,non-lexical-this , funcEnv, privateEnv)とする。 SetFunctionName (closure, name)を実行する。- ! funcEnv.
InitializeBinding (name, closure)を実行する。 - closureを返す。
15.8.4 Runtime Semantics: EvaluateAsyncFunctionBody
The
- promiseCapabilityを !
NewPromiseCapability (%Promise% ) とする。 - completionを
Completion (FunctionDeclarationInstantiation (funcObj, argList))とする。 - completionが
abrupt completion なら、- !
Call (promiseCapability.[[Reject]],undefined , « completion.[[Value]] »)を実行する。
- !
- そうでなければ、
AsyncFunctionStart (promiseCapability,FunctionBody )を実行する。
ReturnCompletion (promiseCapability.[[Promise]])を返す。
15.8.5 Runtime Semantics: Evaluation
- expr を、
CoverAwaitExpressionAndAwaitUsingDeclarationHead によってカバーされるAwaitExpression とする。 - Return ?
Evaluation of expr.
- exprRefを
UnaryExpression の ?Evaluation とする。 - valueを ?
GetValue (exprRef) とする。 - ?
Await (value)を返す。
15.9 Async Arrow Function Definitions
Syntax
Supplemental Syntax
production
のinstanceを処理するとき、
15.9.1 Static Semantics: Early Errors
AsyncArrowBindingIdentifier のBoundNames のいずれかの要素がAsyncConciseBody のLexicallyDeclaredNames にも出現する場合、それはSyntax Errorです。
CoverCallExpressionAndAsyncArrowHead はAsyncArrowHead をcoverしなければなりません。CoverCallExpressionAndAsyncArrowHead Contains YieldExpression がtrue である場合、それはSyntax Errorです。CoverCallExpressionAndAsyncArrowHead Contains AwaitExpression がtrue である場合、それはSyntax Errorです。CoverCallExpressionAndAsyncArrowHead のBoundNames のいずれかの要素がAsyncConciseBody のLexicallyDeclaredNames にも出現する場合、それはSyntax Errorです。AsyncConciseBody のAsyncConciseBodyContainsUseStrict がtrue であり、かつCoverCallExpressionAndAsyncArrowHead のIsSimpleParameterList がfalse である場合、それはSyntax Errorです。
15.9.2 Static Semantics: AsyncConciseBodyContainsUseStrict
The
false を返す。
15.9.3 Runtime Semantics: EvaluateAsyncConciseBody
The
- promiseCapabilityを !
NewPromiseCapability (%Promise% ) とする。 - completionを
Completion (FunctionDeclarationInstantiation (funcObj, argList))とする。 - completionが
abrupt completion なら、- !
Call (promiseCapability.[[Reject]],undefined , « completion.[[Value]] »)を実行する。
- !
- そうでなければ、
AsyncFunctionStart (promiseCapability,ExpressionBody )を実行する。
ReturnCompletion (promiseCapability.[[Promise]])を返す。
15.9.4 Runtime Semantics: InstantiateAsyncArrowFunctionExpression
The
- nameが存在しない場合、nameをempty Stringに設定する。
- envRecordを
running execution context のLexicalEnvironmentとする。 - privateEnvを
running execution context のPrivateEnvironmentとする。 - sourceTextを
AsyncArrowFunction によってmatchされたsource textとする。 - paramsを
AsyncArrowBindingIdentifier とする。 - closureを
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText, params,AsyncConciseBody ,lexical-this , envRecord, privateEnv)とする。 SetFunctionName (closure, name)を実行する。- closureを返す。
- nameが存在しない場合、nameをempty Stringに設定する。
- envRecordを
running execution context のLexicalEnvironmentとする。 - privateEnvを
running execution context のPrivateEnvironmentとする。 - sourceTextを
AsyncArrowFunction によってmatchされたsource textとする。 - headを
CoverCallExpressionAndAsyncArrowHead によってcoverされるAsyncArrowHead とする。 - paramsをheadの
ArrowFormalParameters とする。 - closureを
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText, params,AsyncConciseBody ,lexical-this , envRecord, privateEnv)とする。 SetFunctionName (closure, name)を実行する。- closureを返す。
15.9.5 Runtime Semantics: Evaluation
15.10 Tail Position Calls
15.10.1 Static Semantics: IsInTailPosition ( call )
The abstract operation IsInTailPosition takes argument call (a
IsStrict (call)がfalse なら、false を返す。- callが
FunctionBody 、ConciseBody 、またはAsyncConciseBody 内に含まれていないなら、false を返す。 - bodyをcallを最も近く含む
FunctionBody 、ConciseBody 、またはAsyncConciseBody とする。 - bodyが
GeneratorBody のFunctionBody なら、false を返す。 - bodyが
AsyncFunctionBody のFunctionBody なら、false を返す。 - bodyが
AsyncGeneratorBody のFunctionBody なら、false を返す。 - bodyが
AsyncConciseBody なら、false を返す。 - argument callを伴うbodyの
HasCallInTailPosition の結果を返す。
Tail Position callsは
15.10.2 Static Semantics: HasCallInTailPosition
The
call は、ソーステキストの特定の範囲を表す
呼び出し結果の return
同じ using 宣言または await using 宣言は、その呼び出しが可能な末尾位置呼び出しになることを防ぐ。
It is defined piecewise over the following productions:
- has を、引数 call で派生した
StatementList のHasCallInTailPosition とする。 - has が
true である場合、true を返す。 - 派生した
StatementList のContainsUsing がtrue である場合、false を返す。 - 引数 call で
StatementListItem のHasCallInTailPosition を返す。
false を返す。
- hasを、argument callを伴う最初の
Statement のHasCallInTailPosition とする。 - hasが
true なら、true を返す。 - argument callを伴う2番目の
Statement のHasCallInTailPosition を返す。
- argument callを伴う
Statement のHasCallInTailPosition を返す。
- argument callを伴う
LabelledItem のHasCallInTailPosition を返す。
- argument callを伴う
Expression のHasCallInTailPosition を返す。
- argument callを伴う
CaseBlock のHasCallInTailPosition を返す。
- hasを
false とする。 - 最初の
CaseClauses が存在するなら、hasを、argument callを伴う最初のCaseClauses のHasCallInTailPosition に設定する。 - hasが
true なら、true を返す。 - hasを、argument callを伴う
DefaultClause のHasCallInTailPosition に設定する。 - hasが
true なら、true を返す。 - 2番目の
CaseClauses が存在するなら、hasを、argument callを伴う2番目のCaseClauses のHasCallInTailPosition に設定する。 - hasを返す。
- hasを、argument callを伴う
CaseClauses のHasCallInTailPosition とする。 - hasが
true なら、true を返す。 - argument callを伴う
CaseClause のHasCallInTailPosition を返す。
StatementList が存在するなら、argument callを伴うStatementList のHasCallInTailPosition を返す。false を返す。
- argument callを伴う
Catch のHasCallInTailPosition を返す。
- argument callを伴う
Finally のHasCallInTailPosition を返す。
- argument callを伴う
Block のHasCallInTailPosition を返す。
false を返す。
- argument callを伴う
AssignmentExpression のHasCallInTailPosition を返す。
- hasを、argument callを伴う最初の
AssignmentExpression のHasCallInTailPosition とする。 - hasが
true なら、true を返す。 - argument callを伴う2番目の
AssignmentExpression のHasCallInTailPosition を返す。
- argument callを伴う
BitwiseORExpression のHasCallInTailPosition を返す。
- argument callを伴う
LogicalANDExpression のHasCallInTailPosition を返す。
- argument callを伴う
BitwiseORExpression のHasCallInTailPosition を返す。
- this
CallExpression がcallなら、true を返す。 false を返す。
- argument callを伴う
OptionalChain のHasCallInTailPosition を返す。
false を返す。
- this
OptionalChain がcallなら、true を返す。 false を返す。
- this
MemberExpression がcallなら、true を返す。 false を返す。
- exprを
CoverParenthesizedExpressionAndArrowParameterList によってcoverされるParenthesizedExpression とする。 - argument callを伴うexprの
HasCallInTailPosition を返す。
- argument callを伴う
Expression のHasCallInTailPosition を返す。
15.10.3 PrepareForTailCall ( )
The abstract operation PrepareForTailCall takes no arguments and returns
Assert : currentexecution context は、以後いかなるECMAScript codeまたはbuilt-in functionsのevaluationにも使用されない。このabstract operationの呼び出しに続くCallの呼び出しは、そのようなevaluationを実行する前に新しいexecution context を作成してpushする。- current
execution context に関連付けられたすべてのresourcesを破棄する。 unused を返す。
tail position callは、target functionを呼び出す前に、現在実行中のfunction
例えば、tail position callは、target functionのactivation recordのsizeがcalling functionのactivation recordのsizeを超える分だけ、implementationのactivation record stackを増加させるべきです。target functionのactivation recordの方が小さい場合、stackのtotal sizeは減少するべきです。
16 ECMAScript Language: Scripts and Modules
16.1 Scripts
Syntax
16.1.1 Static Semantics: Early Errors
-
ScriptBody のLexicallyDeclaredNames が重複entriesを含む場合、それはSyntax Errorです。 -
ScriptBody のLexicallyDeclaredNames のいずれかの要素がScriptBody のVarDeclaredNames にも出現する場合、それはSyntax Errorです。
-
superを含むsource textがdirect eval によって処理されているeval codeでない限り、StatementList Contains superである場合、それはSyntax Errorです。direct eval 内のsuperに対する追加のearly error rulesは19.2.1.1 で定義されます。 -
NewTarget を含むsource textがdirect eval によって処理されているeval codeでない限り、StatementList Contains NewTarget である場合、それはSyntax Errorです。direct eval 内のNewTarget に対する追加のearly error rulesは19.2.1.1 で定義されます。 -
argument « »を伴う
StatementList のContainsDuplicateLabels がtrue である場合、それはSyntax Errorです。 -
argument « »を伴う
StatementList のContainsUndefinedBreakTarget がtrue である場合、それはSyntax Errorです。 -
arguments « »および« »を伴う
StatementList のContainsUndefinedContinueTarget がtrue である場合、それはSyntax Errorです。 -
ScriptBody を含むsource textがdirect eval によって処理されているeval codeでない限り、argument « »を伴うStatementList のAllPrivateIdentifiersValid がfalse である場合、それはSyntax Errorです。 -
StatementList のContainsUsing がtrue である場合、Syntax Error である。
16.1.2 Static Semantics: ScriptIsStrict
The
ScriptBody が存在し、かつScriptBody のDirective Prologue がUse Strict Directive を含むなら、true を返す。false を返す。
16.1.3 Runtime Semantics: Evaluation
undefined を返す。
16.1.4 Script Records
Script Recordは、評価されているscriptに関する情報をencapsulateします。各script recordは
| Field Name | Value Type | Meaning |
|---|---|---|
| [[Realm]] |
a |
このscriptが作成された |
| [[ECMAScriptCode]] |
a |
このscriptのsource textをparseした結果。 |
| [[LoadedModules]] |
a |
このscriptによってimportされたspecifier stringsからresolved |
| [[HostDefined]] |
anything (default value is |
scriptに追加情報を関連付ける必要がある |
16.1.5 ParseScript ( sourceText, realm, hostDefined )
The abstract operation ParseScript takes arguments sourceText (a String or a sequence of Unicode code points), realm (a
- scriptを
ParseText (sourceText,Script )とする。 - scriptがerrorsの
List なら、scriptを返す。 Script Record { [[Realm]]: realm, [[ECMAScriptCode]]: script, [[LoadedModules]]: « », [[HostDefined]]: hostDefined }を返す。
implementationは、そのscript source textに対するParseScriptのevaluationより前に、script source textをparseし、それをEarly Error conditionsについてanalyseしてもよいです。ただし、errorsのreportingは、この仕様が実際にそのsource textに対してParseScriptを実行する時点までdeferされなければなりません。
16.1.6 ScriptEvaluation ( scriptRecord )
The abstract operation ScriptEvaluation takes argument scriptRecord (a
- globalEnvをscriptRecord.[[Realm]].[[GlobalEnv]]とする。
- scriptContextを新しい
ECMAScript code execution context とする。 - scriptContextのFunctionを
null に設定する。 - scriptContextの
Realm をscriptRecord.[[Realm]]に設定する。 - scriptContextのScriptOrModuleをscriptRecordに設定する。
- scriptContextのVariableEnvironmentをglobalEnvに設定する。
- scriptContextのLexicalEnvironmentをglobalEnvに設定する。
- scriptContextのPrivateEnvironmentを
null に設定する。 running execution context をsuspendする。- scriptContextを
execution context stack へpushする；scriptContextは現在running execution context である。 - scriptNodeをscriptRecord.[[ECMAScriptCode]]とする。
- resultを
Completion (GlobalDeclarationInstantiation (scriptNode, globalEnv))とする。 - resultが
normal completion なら、- resultを
Completion (scriptNodeのEvaluation )に設定する。 - resultが
normal completion であり、かつresult.[[Value]]がempty なら、- resultを
NormalCompletion (undefined )に設定する。
- resultを
- resultを
- scriptContextをsuspendし、それを
execution context stack からremoveする。 Assert :execution context stack は空でない。execution context stack のtopにあるcontextをrunning execution context としてresumeする。- ? resultを返す。
16.1.7 GlobalDeclarationInstantiation ( script, envRecord )
The abstract operation GlobalDeclarationInstantiation takes arguments script (a
scriptsを評価するために
これは呼び出されたとき、次のstepsを実行します：
- scriptの
LexicallyDeclaredNames をlexicalNamesとする。 - scriptの
VarDeclaredNames をvariableNamesとする。 - lexicalNamesの各要素nameについて、次を行う。
HasLexicalDeclaration (envRecord, name)がtrue である場合、SyntaxError 例外を投げる。- ?
HasRestrictedGlobalProperty (envRecord, name)をhasRestrictedGlobalとする。 NOTE : グローバルvarおよびfunction束縛（非strictdirect eval によって導入されるものを除く）は構成不可であり、したがって制限されたグローバルプロパティである。- hasRestrictedGlobalが
true である場合、SyntaxError 例外を投げる。
- variableNamesの各要素nameについて、次を行う。
HasLexicalDeclaration (envRecord, name)がtrue である場合、SyntaxError 例外を投げる。
- scriptの
VarScopedDeclarations をvariableDeclsとする。 - funcsToInitializeを新しい空の
List とする。 - declaredFuncNamesを新しい空の
List とする。 - variableDeclsの各要素variableDeclについて、
List の逆順で、次を行う。- variableDeclが
VariableDeclaration 、ForBinding 、またはBindingIdentifier のいずれでもない場合、Assert : variableDeclは、FunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 、またはAsyncGeneratorDeclaration のいずれかである。NOTE : 同じ名前に対して複数の関数宣言がある場合、最後の宣言が使用される。- variableDeclの
BoundNames の唯一の要素をfuncNameとする。 - declaredFuncNamesがfuncNameを含まない場合、
- ?
CanDeclareGlobalFunction (envRecord, funcName)をfuncDefinableとする。 - funcDefinableが
false である場合、TypeError 例外を投げる。 - funcNameをdeclaredFuncNamesに追加する。
- variableDeclをfuncsToInitializeの最初の要素として挿入する。
- ?
- variableDeclが
- declaredVariableNamesを新しい空の
List とする。 - variableDeclsの各要素variableDeclについて、次を行う。
- variableDeclが
VariableDeclaration 、ForBinding 、またはBindingIdentifier のいずれかである場合、- variableDeclの
BoundNames の各String nameについて、次を行う。- declaredFuncNamesがnameを含まない場合、
- ?
CanDeclareGlobalVar (envRecord, name)をvariableDefinableとする。 - variableDefinableが
false である場合、TypeError 例外を投げる。 - declaredVariableNamesがnameを含まない場合、
- nameをdeclaredVariableNamesに追加する。
- ?
- declaredFuncNamesがnameを含まない場合、
- variableDeclの
- variableDeclが
NOTE : グローバルオブジェクトがordinary object である場合、このアルゴリズムステップ以降で異常終了は発生しない。しかし、グローバルオブジェクトがProxy exotic object である場合、以下のステップの一部で異常終了を引き起こす挙動を示すことがある。ホスト がWebブラウザである、またはその他の形でBlock-Level Function Declarations Web Legacy Compatibility Semantics をサポートする場合、- scriptの
ScriptIsStrict をstrictとする。 - strictが
false である場合、- declaredFuncNamesとdeclaredVariableNamesの
list-concatenation をdeclaredFuncOrVariableNamesとする。 - script
Contains xがtrue であるような任意のBlock 、CaseClause 、またはDefaultClause xのStatementList に直接含まれる各FunctionDeclaration funcDeclについて、次を行う。- funcDeclの
BindingIdentifier のStringValue をfuncNameとする。 FunctionDeclaration funcDeclを、funcNameをBindingIdentifier として持つVariableStatement に置き換えても、scriptに対してEarly Errorsが発生しない場合、HasLexicalDeclaration (envRecord, funcName)がfalse である場合、- ?
CanDeclareGlobalVar (envRecord, funcName)をfuncDefinableとする。 - funcDefinableが
true である場合、NOTE : funcNameに対するvar束縛は、それがVarDeclaredNameでも別のFunctionDeclaration の名前でもない場合にのみ、ここでインスタンス化される。- declaredFuncOrVariableNamesがfuncNameを含まない場合、
- ?
CreateGlobalVarBinding (envRecord, funcName,false )を実行する。 - funcNameをdeclaredFuncOrVariableNamesに追加する。
- ?
FunctionDeclaration funcDeclが評価されるとき、15.2.6 で提供されるFunctionDeclaration Evaluation アルゴリズムの代わりに、次のステップを実行する。- 実行中の実行コンテキストのVariableEnvironmentをglobalEnvとする。
- 実行中の実行コンテキストのLexicalEnvironmentをblockEnvとする。
- ! blockEnv.
GetBindingValue (funcName,false )をfuncObjとする。 - ? globalEnv.
SetMutableBinding (funcName, funcObj,false )を実行する。 unused を返す。
- ?
- funcDeclの
- declaredFuncNamesとdeclaredVariableNamesの
- scriptの
- scriptの
LexicallyScopedDeclarations をlexicalDeclsとする。 - privateEnvを
null とする。 - lexicalDeclsの各要素lexicalDeclについて、次を行う。
NOTE : Lexically declared nameは、ここでインスタンス化されるだけで、初期化されない。- lexicalDeclの
BoundNames の各要素nameについて、次を行う。- lexicalDeclの
IsConstantDeclaration がtrue である場合、- ? envRecord.
CreateImmutableBinding (name,true )を実行する。
- ? envRecord.
- そうでなければ、
- ? envRecord.
CreateMutableBinding (name,false )を実行する。
- ? envRecord.
- lexicalDeclの
- funcsToInitializeの各
Parse Node funcDeclについて、次を行う。- funcDeclの
BoundNames の唯一の要素をfuncNameとする。 - envRecordおよびprivateEnvを引数として、funcDeclの
InstantiateFunctionObject をfuncObjとする。 - ?
CreateGlobalFunctionBinding (envRecord, funcName, funcObj,false )を実行する。
- funcDeclの
- declaredVariableNamesの各String variableNameについて、次を行う。
- ?
CreateGlobalVarBinding (envRecord, variableName,false )を実行する。
- ?
unused を返す。
explicit varまたはfunction declarationsとは異なり、
16.2 Modules
Syntax
16.2.1 Module Semantics
16.2.1.1 Static Semantics: Early Errors
-
ModuleItemList のLexicallyDeclaredNames が重複entriesを含む場合、それはSyntax Errorです。 -
ModuleItemList のLexicallyDeclaredNames のいずれかの要素がModuleItemList のVarDeclaredNames にも出現する場合、それはSyntax Errorです。 -
ModuleItemList のExportedNames が重複entriesを含む場合、それはSyntax Errorです。 -
ModuleItemList のExportedBindings のいずれかの要素がModuleItemList のVarDeclaredNames またはModuleItemList のLexicallyDeclaredNames のいずれにも出現しない場合、それはSyntax Errorです。 -
ModuleItemList Contains superである場合、それはSyntax Errorです。 -
ModuleItemList Contains NewTarget である場合、それはSyntax Errorです。 -
argument « »を伴う
ModuleItemList のContainsDuplicateLabels がtrue である場合、それはSyntax Errorです。 -
argument « »を伴う
ModuleItemList のContainsUndefinedBreakTarget がtrue である場合、それはSyntax Errorです。 -
arguments « »および« »を伴う
ModuleItemList のContainsUndefinedContinueTarget がtrue である場合、それはSyntax Errorです。 -
argument « »を伴う
ModuleItemList のAllPrivateIdentifiersValid がfalse である場合、それはSyntax Errorです。
重複export default
IsStringWellFormedUnicode (StringLiteral のSV )がfalse である場合、それはSyntax Errorです。
16.2.1.2 Static Semantics: ImportedLocalNames ( importEntries )
The abstract operation ImportedLocalNames takes argument importEntries (a
- localNamesを新しい空の
List とする。 - importEntriesの各
ImportEntry Record importEntryについて、次を行う。- importEntry.[[LocalName]]をlocalNamesに追加する。
- localNamesを返す。
16.2.1.3 ModuleRequest Records
ModuleRequest Recordは、与えられたimport attributesでmoduleをimportするrequestを表します。これは次のfieldsから構成されます：
| Field Name | Value Type | Meaning |
|---|---|---|
| [[Specifier]] | a String | module specifier |
| [[Attributes]] |
a |
import attributes |
LoadedModuleRequest Recordは、moduleをimportするrequestを、その結果として得られる
| Field Name | Value Type | Meaning |
|---|---|---|
| [[Specifier]] | a String | module specifier |
| [[Attributes]] |
a |
import attributes |
| [[Module]] |
a |
このmodule requestに対応するloaded module |
ImportAttribute Recordは次のfieldsから構成されます：
| Field Name | Value Type | Meaning |
|---|---|---|
| [[Key]] | a String | attribute key |
| [[Value]] | a String | attribute value |
16.2.1.3.1 ModuleRequestsEqual ( x, y )
The abstract operation ModuleRequestsEqual takes arguments x (a
- x.[[Specifier]]がy.[[Specifier]]でないなら、
false を返す。 - xAttrsをx.[[Attributes]]とする。
- yAttrsをy.[[Attributes]]とする。
- xAttrsCountをxAttrs内の要素数とする。
- yAttrsCountをyAttrs内の要素数とする。
- xAttrsCount ≠ yAttrsCountなら、
false を返す。 - xAttrsの各
ImportAttribute Record xAttrについて、以下を行う- yAttrsが、xAttr.[[Key]]がyAttr.[[Key]]であり、かつxAttr.[[Value]]がyAttr.[[Value]]であるような
ImportAttribute Record yAttrを含まないなら、false を返す。
- yAttrsが、xAttr.[[Key]]がyAttr.[[Key]]であり、かつxAttr.[[Value]]がyAttr.[[Value]]であるような
true を返す。
16.2.1.4 Static Semantics: ModuleRequests
The
- 新しい空の
List を返す。
ModuleItemList のModuleRequests をrequestsとする。ModuleItem のModuleRequests をadditionalRequestsとする。- additionalRequestsの各
ModuleRequest Record moduleRequestについて、次を行う。ModuleRequestsEqual (moduleRequest, otherModuleRequest)がtrue であるようなModuleRequest Record otherModuleRequestをrequestsが含まない場合、- moduleRequestをrequestsに追加する。
- requestsを返す。
- 新しい空の
List を返す。
- specifierを
FromClause のSV とする。 - 唯一の要素が
ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: « » }であるList を返す。
- specifierを
FromClause のSV とする。 - attrsを
WithClause のWithClauseToAttributes とする。 - 唯一の要素が
ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: attrs }であるList を返す。
- specifierを
ModuleSpecifier のSV とする。 - 唯一の要素が
ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: « » }であるList を返す。
- specifierを
ModuleSpecifier のSV とする。 - attrsを
WithClause のWithClauseToAttributes とする。 - 唯一の要素が
ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: attrs }であるList を返す。
- specifierを
FromClause のSV とする。 - 唯一の要素が
ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: « » }であるList を返す。
- specifierを
FromClause のSV とする。 - attrsを
WithClause のWithClauseToAttributes とする。 - 唯一の要素が
ModuleRequest Record { [[Specifier]]: specifier, [[Attributes]]: attrs }であるList を返す。
- 新しい空の
List を返す。
16.2.1.5 Abstract Module Records
Module Recordは、単一moduleのimportsおよびexportsに関するstructural informationをencapsulateします。この情報は、connected modulesのsetsのimportsおよびexportsをlinkするために使用されます。Module Recordには、moduleを評価するときにのみ使用される4つのfieldsが含まれます。
specification purposesのため、Module Record値は
Module Recordは
| Field Name | Value Type | Meaning |
|---|---|---|
| [[Realm]] |
a |
このmoduleが作成された |
| [[Environment]] |
a |
このmoduleに対するtop level bindingsを含む |
| [[Namespace]] |
an Object or |
このmoduleに対して作成されている場合のModule Namespace Object（ |
| [[HostDefined]] |
anything (default value is |
moduleに追加情報を関連付ける必要がある |
| Method | Purpose | Definitions |
|---|---|---|
| LoadRequestedModules ( [ hostDefined ] ) | The abstract method LoadRequestedModules takes optional argument hostDefined (anything) and returns a Promise. そのすべてのdependenciesを再帰的にloadすることで、linkingのためにmoduleを準備します。 |
この仕様内では、これは次のtypes内にdefinitionsを持ちます； |
| GetExportedNames ( [ exportStarSet ] ) | The abstract method GetExportedNames takes optional argument exportStarSet (a このmoduleから直接または間接的にexportされるすべてのnamesのlistを返します。 このmethodをinvokeする前に、 |
この仕様内では、これは次のtypes内にdefinitionsを持ちます； |
| ResolveExport ( exportName [ , resolveSet ] ) | The abstract method ResolveExport takes argument exportName (a String) and optional argument resolveSet (a このmoduleによってexportされるnameのbindingを返します。Bindingsは、{ [[Module]]: このoperationが特定のexportName、resolveSet pairをargumentsとして呼び出されるたびに、同じresultを返さなければなりません。 このmethodをinvokeする前に、 |
この仕様内では、これは次のtypes内にdefinitionsを持ちます； |
| Link ( ) | The abstract method Link takes no arguments and returns either a すべてのmodule dependenciesをtransitivelyにresolveし、 このmethodをinvokeする前に、 |
この仕様内では、これは次のtypes内にdefinitionsを持ちます； |
| Evaluate ( ) | The abstract method Evaluate takes no arguments and returns a Promise. このmoduleおよびそのdependenciesのevaluationに対するpromiseを返します。このpromiseは、successful evaluation時またはすでにsuccessfullyに評価済みである場合にresolveされ、evaluation error時またはすでにunsuccessfullyに評価済みである場合にrejectされます。promiseがrejectedされる場合、 このmethodをinvokeする前に、 |
この仕様内では、これは次のtypes内にdefinitionsを持ちます； |
16.2.1.5.1 EvaluateModuleSync ( module )
The abstract operation EvaluateModuleSync takes argument module (a
Assert : moduleはCyclic Module Record でない。- promiseをmodule.
Evaluate ()とする。 Assert : promise.[[PromiseState]]はfulfilled またはrejected のいずれかである。- promise.[[PromiseState]]が
rejected なら、- promise.[[PromiseIsHandled]]が
false なら、HostPromiseRejectionTracker (promise,"handle" )を実行する。 - promise.[[PromiseIsHandled]]を
true に設定する。 - promise.[[PromiseResult]]をThrowする。
- promise.[[PromiseIsHandled]]が
unused を返す。
16.2.1.6 Cyclic Module Records
Cyclic Module Recordは、
| Field Name | Value Type | Meaning |
|---|---|---|
| [[Status]] |
|
Initially |
| [[EvaluationError]] |
a |
evaluation中に発生したexceptionを表す |
| [[DFSAncestorIndex]] |
an |
|
| [[RequestedModules]] |
a |
このmodule内のimportsに関連付けられた |
| [[LoadedModules]] |
a |
このrecordによって表されるmoduleが、relative import attributesとともにmoduleのimportationをrequestするために使用したspecifier stringsから、resolved |
| [[CycleRoot]] |
a |
cycleの最初にvisitedされたmodule、strongly connected componentのroot DFS ancestor。cycle内にないmoduleについては、これはmodule自身になります。 |
| [[HasTLA]] | a Boolean |
このmoduleが個別にasynchronousであるかどうか（例えば、top-level awaitを含む |
| [[AsyncEvaluationOrder]] |
|
このfieldはinitiallyに |
| [[TopLevelCapability]] |
a |
このmoduleが何らかのcycleの[[CycleRoot]]であり、そのcycle内の何らかのmoduleに対して |
| [[AsyncParentModules]] |
a |
このmoduleまたはdependencyが[[HasTLA]] |
| [[PendingAsyncDependencies]] |
an |
このmoduleがasynchronous dependenciesを持つ場合、これはこのmoduleのためにexecuteがremainingしているasynchronous dependency modulesの数をtrackします。asynchronous dependenciesを持つmoduleは、このfieldが0に到達し、execution errorsがない場合にexecutedされます。 |
| Method | Purpose | Definitions |
|---|---|---|
| InitializeEnvironment ( ) | The abstract method InitializeEnvironment takes no arguments and returns either a |
この仕様内では、これは次のtypes内にdefinitionsを持ちます； |
| ExecuteModule ( [ capability ] ) | The abstract method ExecuteModule takes optional argument capability (a |
この仕様内では、これは次のtypes内にdefinitionsを持ちます； |
GraphLoadingState Recordは、module graphのloading processに関する情報を含む
| Field Name | Value Type | Meaning |
|---|---|---|
| [[PromiseCapability]] |
a |
loading processがfinishしたときにresolveするpromise。 |
| [[IsLoading]] | a Boolean | loading processがまだfinishしておらず、successfullyでもerrorでもない場合はtrueです。 |
| [[PendingModulesCount]] |
a non-negative |
pending |
| [[Visited]] |
a |
circular dependenciesによるinfinite loopsを避けるため、current loading processによってすでにloadedされた |
| [[HostDefined]] |
anything (default value is |
|
16.2.1.6.1 Implementation of Module Record Abstract Methods
以下は、
16.2.1.6.1.1 LoadRequestedModules ( [ hostDefined ] )
The
- hostDefinedが存在しないなら、hostDefinedを
empty に設定する。 - promiseCapabilityを !
NewPromiseCapability (%Promise% ) とする。 - stateを
GraphLoadingState Record { [[IsLoading]]:true , [[PendingModulesCount]]: 1, [[Visited]]: « », [[PromiseCapability]]: promiseCapability, [[HostDefined]]: hostDefined }とする。 InnerModuleLoading (state, module)を実行する。- promiseCapability.[[Promise]]を返す。
<link rel="preload" as="..."> tagsに対して正しいfetch destinationを設定するために使用されます。
import() expressionsは決してhostDefined parameterを設定しません。
16.2.1.6.1.1.1 InnerModuleLoading ( state, module )
The abstract operation InnerModuleLoading takes arguments state (a
Assert : state.[[IsLoading]]はtrue である。- moduleが
Cyclic Module Record であり、module.[[Status]]がnew であり、かつstate.[[Visited]]がmoduleを含まないなら、- moduleをstate.[[Visited]]へappendする。
- requestedModulesCountをmodule.[[RequestedModules]]内の要素数とする。
- state.[[PendingModulesCount]]をstate.[[PendingModulesCount]] + requestedModulesCountに設定する。
- module.[[RequestedModules]]の各
ModuleRequest Record requestについて、以下を行うAllImportAttributesSupported (request.[[Attributes]])がfalse なら、- errorを
ThrowCompletion (a newly createdSyntaxError object)とする。 ContinueModuleLoading (state, error)を実行する。
- errorを
- そうでなく、module.[[LoadedModules]]が
ModuleRequestsEqual (record, request)がtrue であるようなLoadedModuleRequest Record recordを含むなら、InnerModuleLoading (state, record.[[Module]])を実行する。
- そうでなければ、
HostLoadImportedModule (module, request, state.[[HostDefined]], state)を実行する。NOTE :HostLoadImportedModule はFinishLoadingImportedModule をcallし、これはContinueModuleLoading を通じてgraph loading processへre-enterする。
- state.[[IsLoading]]が
false なら、unused を返す。
Assert : state.[[PendingModulesCount]] ≥ 1である。- state.[[PendingModulesCount]]をstate.[[PendingModulesCount]] - 1に設定する。
- state.[[PendingModulesCount]] = 0なら、
- state.[[IsLoading]]を
false に設定する。 - state.[[Visited]]の各
Cyclic Module Record loadedについて、以下を行う- loaded.[[Status]]が
new なら、loaded.[[Status]]をunlinked に設定する。
- loaded.[[Status]]が
- !
Call (state.[[PromiseCapability]].[[Resolve]],undefined , «undefined »)を実行する。
- state.[[IsLoading]]を
unused を返す。
16.2.1.6.1.1.2 ContinueModuleLoading ( state, moduleCompletion )
The abstract operation ContinueModuleLoading takes arguments state (a
- state.[[IsLoading]]が
false なら、unused を返す。 - moduleCompletionが
normal completion なら、InnerModuleLoading (state, moduleCompletion.[[Value]])を実行する。
- そうでなければ、
- state.[[IsLoading]]を
false に設定する。 - !
Call (state.[[PromiseCapability]].[[Reject]],undefined , « moduleCompletion.[[Value]] »)を実行する。
- state.[[IsLoading]]を
unused を返す。
16.2.1.6.1.2 Link ( )
The
Assert : module.[[Status]]はunlinked 、linked 、evaluating-async 、またはevaluated のいずれかである。- stackを新しい空の
List とする。 Completion (InnerModuleLinking (module, stack, 0))をresultとする。- resultが
abrupt completion である場合、- stackの各
Cyclic Module Record requiredModuleについて、次を行う。Assert : requiredModule.[[Status]]はlinking である。- requiredModule.[[Status]]を
unlinked に設定する。
Assert : module.[[Status]]はunlinked である。- ? resultを返す。
- stackの各
Assert : module.[[Status]]はlinked 、evaluating-async 、またはevaluated のいずれかである。Assert : stackは空である。unused を返す。
16.2.1.6.1.2.1 InnerModuleLinking ( module, stack, index )
The abstract operation InnerModuleLinking takes arguments module (a
- moduleが
Cyclic Module Record でないなら、- ? module.
Link ()を実行する。 - indexを返す。
- ? module.
- module.[[Status]]が
linking 、linked 、evaluating-async 、またはevaluated のいずれかなら、- indexを返す。
Assert : module.[[Status]]はunlinked である。- module.[[Status]]を
linking に設定する。 - moduleIndexをindexとする。
- module.[[DFSAncestorIndex]]をindexに設定する。
- indexをindex + 1に設定する。
- moduleをstackへappendする。
- module.[[RequestedModules]]の各
ModuleRequest Record requestについて、以下を行う- requiredModuleを
GetImportedModule (module, request)とする。 - indexを ?
InnerModuleLinking (requiredModule, stack, index) に設定する。 - requiredModuleが
Cyclic Module Record なら、Assert : requiredModule.[[Status]]はlinking 、linked 、evaluating-async 、またはevaluated のいずれかである。Assert : requiredModule.[[Status]]がlinking であることとstackがrequiredModuleを含むことは同値である。- requiredModule.[[Status]]が
linking なら、- module.[[DFSAncestorIndex]]を
min (module.[[DFSAncestorIndex]], requiredModule.[[DFSAncestorIndex]])に設定する。
- module.[[DFSAncestorIndex]]を
- requiredModuleを
- ? module.
InitializeEnvironment ()を実行する。 Assert : moduleはstack内にちょうど1回出現する。Assert : module.[[DFSAncestorIndex]] ≤ moduleIndexである。- module.[[DFSAncestorIndex]] = moduleIndexなら、
- doneを
false とする。 - doneが
false である間、繰り返す- requiredModuleをstackの最後の要素とする。
- stackの最後の要素をremoveする。
Assert : requiredModuleはCyclic Module Record である。- requiredModule.[[Status]]を
linked に設定する。 - requiredModuleとmoduleが同じ
Module Record なら、doneをtrue に設定する。
- doneを
- indexを返す。
16.2.1.6.1.3 Evaluate ( )
The
Assert : このEvaluate への呼び出しは、周囲のagent 内の別のEvaluate への呼び出しと同時には発生していない。Assert : module.[[Status]]はlinked 、evaluating-async 、またはevaluated のいずれかである。- module.[[Status]]が
evaluating-async またはevaluated のいずれかである場合、- module.[[CycleRoot]]が
empty でない場合、- moduleをmodule.[[CycleRoot]]に設定する。
- そうでなければ、
Assert : module.[[Status]]はevaluated であり、module.[[EvaluationError]]はthrow completion である。
- module.[[CycleRoot]]が
- module.[[TopLevelCapability]]が
empty でない場合、- module.[[TopLevelCapability]].[[Promise]]を返す。
- stackを新しい空の
List とする。 - !
NewPromiseCapability (%Promise% )をpromiseCapabilityとする。 - module.[[TopLevelCapability]]をpromiseCapabilityに設定する。
Completion (InnerModuleEvaluation (module, stack, 0))をresultとする。- resultが
abrupt completion である場合、- stackの各
Cyclic Module Record requiredModuleについて、次を行う。Assert : requiredModule.[[Status]]はevaluating である。- requiredModule.[[Status]]を
evaluated に設定する。 - requiredModule.[[EvaluationError]]をresultに設定する。
Assert : module.[[Status]]はevaluated である。Assert : module.[[EvaluationError]]とresultは同じCompletion Record である。- !
Call (promiseCapability.[[Reject]],undefined , « result.[[Value]] »)を実行する。
- stackの各
- そうでなければ、
- promiseCapability.[[Promise]]を返す。
16.2.1.6.1.3.1 InnerModuleEvaluation ( module, stack, index )
The abstract operation InnerModuleEvaluation takes arguments module (a
- moduleが
Cyclic Module Record でないなら、- ?
EvaluateModuleSync (module)を実行する。 - indexを返す。
- ?
- module.[[Status]]が
evaluating-async またはevaluated のいずれかなら、- module.[[EvaluationError]]が
empty なら、indexを返す。 - ? module.[[EvaluationError]]を返す。
- module.[[EvaluationError]]が
- module.[[Status]]が
evaluating なら、indexを返す。 Assert : module.[[Status]]はlinked である。- module.[[Status]]を
evaluating に設定する。 - moduleIndexをindexとする。
- module.[[DFSAncestorIndex]]をindexに設定する。
- module.[[PendingAsyncDependencies]]を0に設定する。
- indexをindex + 1に設定する。
- moduleをstackへappendする。
- module.[[RequestedModules]]の各
ModuleRequest Record requestについて、以下を行う- requiredModuleを
GetImportedModule (module, request)とする。 - indexを ?
InnerModuleEvaluation (requiredModule, stack, index) に設定する。 - requiredModuleが
Cyclic Module Record なら、Assert : requiredModule.[[Status]]はevaluating 、evaluating-async 、またはevaluated のいずれかである。Assert : requiredModule.[[Status]]がevaluating であることとstackがrequiredModuleを含むことは同値である。- requiredModule.[[Status]]が
evaluating なら、- module.[[DFSAncestorIndex]]を
min (module.[[DFSAncestorIndex]], requiredModule.[[DFSAncestorIndex]])に設定する。
- module.[[DFSAncestorIndex]]を
- そうでなければ、
- requiredModuleをrequiredModule.[[CycleRoot]]に設定する。
Assert : requiredModule.[[Status]]はevaluating-async またはevaluated のいずれかである。- requiredModule.[[EvaluationError]]が
empty でないなら、? requiredModule.[[EvaluationError]]を返す。
- requiredModule.[[AsyncEvaluationOrder]]が
integer なら、- module.[[PendingAsyncDependencies]]をmodule.[[PendingAsyncDependencies]] + 1に設定する。
- moduleをrequiredModule.[[AsyncParentModules]]へappendする。
- requiredModuleを
- module.[[PendingAsyncDependencies]] > 0またはmodule.[[HasTLA]]が
true なら、Assert : module.[[AsyncEvaluationOrder]]はunset である。- module.[[AsyncEvaluationOrder]]を
IncrementModuleAsyncEvaluationCount ()に設定する。 - module.[[PendingAsyncDependencies]] = 0なら、
ExecuteAsyncModule (module)を実行する。
- そうでなければ、
- ? module.
ExecuteModule ()を実行する。
- ? module.
Assert : moduleはstack内にちょうど1回出現する。Assert : module.[[DFSAncestorIndex]] ≤ moduleIndexである。- module.[[DFSAncestorIndex]] = moduleIndexなら、
- doneを
false とする。 - doneが
false である間、繰り返す- requiredModuleをstackの最後の要素とする。
- stackの最後の要素をremoveする。
Assert : requiredModuleはCyclic Module Record である。Assert : requiredModule.[[AsyncEvaluationOrder]]はinteger またはunset のいずれかである。- requiredModule.[[AsyncEvaluationOrder]]が
unset なら、requiredModule.[[Status]]をevaluated に設定する。 - そうでなければ、requiredModule.[[Status]]を
evaluating-async に設定する。 - requiredModuleとmoduleが同じ
Module Record なら、doneをtrue に設定する。 - requiredModule.[[CycleRoot]]をmoduleに設定する。
- doneを
- indexを返す。
moduleは、InnerModuleEvaluationによってtraversedされている間は
asynchronous cycleのmoduleに依存する任意のmodulesは、そのcycleが
16.2.1.6.1.3.2 ExecuteAsyncModule ( module )
The abstract operation ExecuteAsyncModule takes argument module (a
Assert : module.[[Status]]はevaluating またはevaluating-async のいずれかである。Assert : module.[[HasTLA]]はtrue である。- promiseCapabilityを !
NewPromiseCapability (%Promise% ) とする。 - moduleをcaptureし、呼び出されたとき次のstepsを実行する、parametersを持たない新しい
Abstract Closure fulfilledClosureとする：AsyncModuleExecutionFulfilled (module)を実行する。NormalCompletion (undefined )を返す。
- onFulfilledを
CreateBuiltinFunction (fulfilledClosure, 0,"" , « »)とする。 - moduleをcaptureし、呼び出されたとき次のstepsを実行する、parameters (error)を持つ新しい
Abstract Closure rejectedClosureとする：AsyncModuleExecutionRejected (module, error)を実行する。NormalCompletion (undefined )を返す。
- onRejectedを
CreateBuiltinFunction (rejectedClosure, 0,"" , « »)とする。 PerformPromiseThen (promiseCapability.[[Promise]], onFulfilled, onRejected)を実行する。- ! module.
ExecuteModule (promiseCapability)を実行する。 unused を返す。
16.2.1.6.1.3.3 GatherAvailableAncestors ( module, execList )
The abstract operation GatherAvailableAncestors takes arguments module (a
- module.[[AsyncParentModules]]の各
Cyclic Module Record ancestorModuleについて、以下を行う- execListがancestorModuleを含まず、かつancestorModule.[[CycleRoot]].[[EvaluationError]]が
empty であるなら、Assert : ancestorModule.[[Status]]はevaluating-async である。Assert : ancestorModule.[[EvaluationError]]はempty である。Assert : ancestorModule.[[AsyncEvaluationOrder]]はinteger である。Assert : ancestorModule.[[PendingAsyncDependencies]] > 0である。- ancestorModule.[[PendingAsyncDependencies]]をancestorModule.[[PendingAsyncDependencies]] - 1に設定する。
- ancestorModule.[[PendingAsyncDependencies]] = 0なら、
- ancestorModuleをexecListへappendする。
- ancestorModule.[[HasTLA]]が
false なら、GatherAvailableAncestors (ancestorModule, execList)を実行する。
- execListがancestorModuleを含まず、かつancestorModule.[[CycleRoot]].[[EvaluationError]]が
unused を返す。
root moduleに対するasynchronous executionがfulfilledされると、このfunctionは、このcompletion時に一緒にsynchronouslyにexecuteできるmodulesのlistを決定し、それらをexecListにpopulateします。
16.2.1.6.1.3.4 AsyncModuleExecutionFulfilled ( module )
The abstract operation AsyncModuleExecutionFulfilled takes argument module (a
- module.[[Status]]が
evaluated なら、Assert : module.[[EvaluationError]]はempty でない。unused を返す。
Assert : module.[[Status]]はevaluating-async である。Assert : module.[[AsyncEvaluationOrder]]はinteger である。Assert : module.[[EvaluationError]]はempty である。- module.[[AsyncEvaluationOrder]]を
done に設定する。 - module.[[Status]]を
evaluated に設定する。 - module.[[TopLevelCapability]]が
empty でないなら、Assert : module.[[CycleRoot]]とmoduleは同じModule Record である。- !
Call (module.[[TopLevelCapability]].[[Resolve]],undefined , «undefined »)を実行する。
- execListを新しい空の
List とする。 GatherAvailableAncestors (module, execList)を実行する。Assert : execListのすべての要素は、その[[AsyncEvaluationOrder]] fieldがinteger に、[[PendingAsyncDependencies]] fieldが0に、[[EvaluationError]] fieldがempty に設定されている。- sortedExecListを、その要素がexecListの要素であり、それらの[[AsyncEvaluationOrder]] fieldの昇順でsortedされた
List とする。 - sortedExecListの各
Cyclic Module Record ancestorModuleについて、以下を行う- ancestorModule.[[Status]]が
evaluated なら、Assert : ancestorModule.[[EvaluationError]]はempty でない。
- そうでなく、ancestorModule.[[HasTLA]]が
true なら、ExecuteAsyncModule (ancestorModule)を実行する。
- そうでなければ、
- resultを
Completion (ancestorModule.ExecuteModule ())とする。 - resultが
abrupt completion なら、AsyncModuleExecutionRejected (ancestorModule, result.[[Value]])を実行する。
- そうでなければ、
- ancestorModule.[[AsyncEvaluationOrder]]を
done に設定する。 - ancestorModule.[[Status]]を
evaluated に設定する。 - ancestorModule.[[TopLevelCapability]]が
empty でないなら、Assert : ancestorModule.[[CycleRoot]]とancestorModuleは同じModule Record である。- !
Call (ancestorModule.[[TopLevelCapability]].[[Resolve]],undefined , «undefined »)を実行する。
- ancestorModule.[[AsyncEvaluationOrder]]を
- resultを
- ancestorModule.[[Status]]が
unused を返す。
16.2.1.6.1.3.5 AsyncModuleExecutionRejected ( module, error )
The abstract operation AsyncModuleExecutionRejected takes arguments module (a
- module.[[Status]]が
evaluated なら、Assert : module.[[EvaluationError]]はempty でない。unused を返す。
Assert : module.[[Status]]はevaluating-async である。Assert : module.[[AsyncEvaluationOrder]]はinteger である。Assert : module.[[EvaluationError]]はempty である。- module.[[EvaluationError]]を
ThrowCompletion (error)に設定する。 - module.[[Status]]を
evaluated に設定する。 - module.[[AsyncEvaluationOrder]]を
done に設定する。 NOTE : module.[[AsyncEvaluationOrder]]はAsyncModuleExecutionFulfilled とのsymmetryのためにdone に設定される。InnerModuleEvaluation において、moduleの[[AsyncEvaluationOrder]] internal slotの値は、その[[EvaluationError]] internal slotがempty でない場合には使用されない。- module.[[TopLevelCapability]]が
empty でないなら、Assert : module.[[CycleRoot]]とmoduleは同じModule Record である。- !
Call (module.[[TopLevelCapability]].[[Reject]],undefined , « error »)を実行する。
- module.[[AsyncParentModules]]の各
Cyclic Module Record ancestorModuleについて、以下を行うAsyncModuleExecutionRejected (ancestorModule, error)を実行する。
unused を返す。
16.2.1.6.2 Example Cyclic Module Record Graphs
このnon-normative sectionは、errorsがどのように発生し得るかに特にfocusして、いくつかのcommon module graphsのlinkingおよびevaluationの一連のexamplesを示します。
まず、次のsimple module graphを考えます：
まず、error conditionsがないと仮定します。hostが最初にA.
次に、A.
最後に、
次に、異なるtypeのerror conditionを考えます：
このscenarioでは、module Aが何らかの他のmoduleへのdependencyをdeclareしていますが、そのmoduleに対する
ここでのloading、linking、evaluation errorsの違いは、次のcharacteristicに起因します：
Evaluation はside effectsを引き起こす可能性があるため、1回だけ実行されなければなりません；したがって、たとえunsuccessfullyであったとしても、evaluationがすでに実行されたかどうかをrememberすることが重要です。（error caseでは、そうしなければsubsequentEvaluate () callsが新しいexceptionをsynthesizeしなければならないため、exceptionもrememberすることに意味があります。）- 一方、Linkingはside-effect-freeであるため、failしたとしても、問題なくlater timeにretryできます。
- Loadingはhostとcloselyにinteractsし、
hosts によってはfailed loadsをusersがretryできるようにすることがdesirableである場合があります（例えば、failureがtemporarily bad network conditionsによって引き起こされた場合）。
次に、cycleを持つmodule graphを考えます：
ここではentry pointがmodule Aであると仮定します。そのため、hostはA.
その後、hostはA.
cyclic module graphのevaluation phaseについても、success caseではanalogous storyが発生します。
次に、Aにlinking errorがあるcaseを考えます；例えば、AがCから存在しないbindingをimportしようとする場合です。その場合、上記のstepsはやはり発生し、Aに対する2回目の
あるいは、Aにevaluation errorがあるcaseを考えます；例えば、そのsource codeがexceptionをthrowする場合です。その場合、上記stepsのevaluation-time analogueはやはり発生し、Aに対する2回目のawaitを含む、またはそれに依存するmodulesのchainをdependency graph全体に形成する[[AsyncParentModules]]を介して、
最後に、すべてのmodulesがasynchronouslyにcompleteするcycleを持つmodule graphを考えます：
Loadingおよびlinkingは以前と同様に発生し、すべてのmodulesは[[Status]]が
A.
|
Field
|
A | B | C | D | E |
|---|---|---|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 | 0 | 0 | 4 |
| [[Status]] | |||||
| [[AsyncEvaluationOrder]] | 4 | 1 | 3 | 0 | 2 |
| [[AsyncParentModules]] | « » | « A » | « A » | « B, C » | « C » |
| [[PendingAsyncDependencies]] | 2 (B and C) | 1 (D) | 2 (D and E) | 0 | 0 |
Eが最初にexecutingをfinishすると仮定します。その場合、
|
Field
|
C | E |
|---|---|---|
| [[DFSAncestorIndex]] | 0 | 4 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | 3 | |
| [[AsyncParentModules]] | « A » | « C » |
| [[PendingAsyncDependencies]] | 1 (D) | 0 |
次にfinishするのはDです（まだexecutingしていた唯一のmoduleだったため）。その場合、awaitを含む場合、potentiallyにBとparallelに）。updated modulesのfieldsは
|
Field
|
B | C | D |
|---|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 | 0 |
| [[Status]] | |||
| [[AsyncEvaluationOrder]] | 1 | 3 | |
| [[AsyncParentModules]] | « A » | « A » | « B, C » |
| [[PendingAsyncDependencies]] | 0 | 0 | 0 |
Cが次にexecutingをfinishすると仮定します。その場合、
|
Field
|
A | C |
|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | 4 | |
| [[AsyncParentModules]] | « » | « A » |
| [[PendingAsyncDependencies]] | 1 (B) | 0 |
次に、Bがexecutingをfinishします。その場合、
|
Field
|
A | B |
|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | 4 | |
| [[AsyncParentModules]] | « » | « A » |
| [[PendingAsyncDependencies]] | 0 | 0 |
最後に、Aがexecutingをfinishします。その場合、
|
Field
|
A |
|---|---|
| [[DFSAncestorIndex]] | 0 |
| [[Status]] | |
| [[AsyncEvaluationOrder]] | |
| [[AsyncParentModules]] | « » |
| [[PendingAsyncDependencies]] | 0 |
あるいは、Bがexecutingをfinishする前にCがexecutionにfailし、errorを返すfailure caseを考えます。その場合、
|
Field
|
A | C |
|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | ||
| [[AsyncParentModules]] | « » | « A » |
| [[PendingAsyncDependencies]] | 1 (B) | 0 |
| [[EvaluationError]] | C's evaluation error |
CがCのerrorを伴ってAに対して
|
Field
|
A |
|---|---|
| [[DFSAncestorIndex]] | 0 |
| [[Status]] | |
| [[AsyncEvaluationOrder]] | |
| [[AsyncParentModules]] | « » |
| [[PendingAsyncDependencies]] | 0 |
| [[EvaluationError]] | C's |
その後、Bがerrorなしでexecutingをfinishします。その場合、
|
Field
|
A | B |
|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | 4 | 1 |
| [[AsyncParentModules]] | « » | « A » |
| [[PendingAsyncDependencies]] | 0 | 0 |
| [[EvaluationError]] | C's |
16.2.1.7 Source Text Module Records
Source Text Module Recordは、
| Field Name | Value Type | Meaning |
|---|---|---|
| [[ECMAScriptCode]] |
a |
|
| [[Context]] |
an |
このmoduleに関連付けられた |
| [[ImportMeta]] |
an Object or |
import.meta meta propertyを通じてexposedされるobject。ECMAScript codeによってaccessされるまでは |
| [[ImportEntries]] |
a |
このmoduleのcodeからderivedされたImportEntry recordsの |
| [[LocalExportEntries]] |
a |
module内でoccurするdeclarationsに対応する、このmoduleのcodeからderivedされたExportEntry recordsの |
| [[IndirectExportEntries]] |
a |
module内でoccurするreexported imports、またはexport * as namespace declarationsからのexportsに対応する、このmoduleのcodeからderivedされたExportEntry recordsの |
| [[StarExportEntries]] |
a |
module内でoccurするexport * declarationsに対応する、このmoduleのcodeからderivedされたExportEntry recordsのexport * as namespace declarationsは含まれません。
|
ImportEntry Recordは、単一のdeclarative importに関する情報をdigestする
| Field Name | Value Type | Meaning |
|---|---|---|
| [[ModuleRequest]] |
a |
|
| [[ImportName]] |
a String or |
[[ModuleRequest]]によってidentifiedされるmoduleによってdesired bindingがexportされているname。値 |
| [[LocalName]] | a String | importing module内からimported valueにlocallyにaccessするために使用されるname。 |
| Import Statement Form | [[ModuleRequest]] | [[ImportName]] | [[LocalName]] |
|---|---|---|---|
import v from "mod";
|
|
|
|
import * as ns from "mod";
|
|
|
|
import {x} from "mod";
|
|
|
|
import {x as v} from "mod";
|
|
|
|
import "mod";
|
|
||
ExportEntry Recordは、単一のdeclarative exportに関する情報をdigestする
| Field Name | Value Type | Meaning |
|---|---|---|
| [[ExportName]] |
a String or |
このmoduleによってこのbindingをexportするために使用されるname。 |
| [[ModuleRequest]] |
a |
|
| [[ImportName]] |
a String, |
[[ModuleRequest]]によってidentifiedされるmoduleによってdesired bindingがexportされているname。export * as ns from "mod" declarationsに使用されます。export * from "mod" declarationsに使用されます。
|
| [[LocalName]] |
a String or |
importing module内からexported valueにlocallyにaccessするために使用されるname。exported valueがmodule内からlocallyにaccessできない場合は |
| Export Statement Form | [[ExportName]] | [[ModuleRequest]] | [[ImportName]] | [[LocalName]] |
|---|---|---|---|---|
export var v;
|
|
|
|
|
export default function f() {}
|
|
|
|
|
export default function () {}
|
|
|
|
|
export default 42;
|
|
|
|
|
export {x};
|
|
|
|
|
export {v as x};
|
|
|
|
|
export {x} from "mod";
|
|
|
|
|
export {v as x} from "mod";
|
|
|
|
|
export * from "mod";
|
|
|
|
|
export * as ns from "mod";
|
|
|
|
|
次のdefinitionsは、
16.2.1.7.1 ParseModule ( sourceText, realm, hostDefined )
The abstract operation ParseModule takes arguments sourceText (a String or a sequence of Unicode code points), realm (a
- bodyを
ParseText (sourceText,Module )とする。 - bodyがerrorsの
List なら、bodyを返す。 - requestedModulesをbodyの
ModuleRequests とする。 - importEntriesをbodyの
ImportEntries とする。 - importedBoundNamesを
ImportedLocalNames (importEntries)とする。 - indirectExportEntriesを新しい空の
List とする。 - localExportEntriesを新しい空の
List とする。 - starExportEntriesを新しい空の
List とする。 - exportEntriesをbodyの
ExportEntries とする。 - exportEntriesの各
ExportEntry Record exportEntryについて、以下を行う- exportEntry.[[ModuleRequest]]が
null なら、- importedBoundNamesがexportEntry.[[LocalName]]を含まないなら、
- exportEntryをlocalExportEntriesへappendする。
- そうでなければ、
NOTE : もともと別のmoduleからimportされたbindingまたはnamespace objectをexportするとき、ExportEntry Record は、bindingまたはnamespace objectがimportされてからexportされるのではなく、original moduleから直接re-exportされていた場合のformにmatchするようにrewrittenされる。これにより、export * fromを通じて同じbindingまたはnamespaceを同じnameで2回exportすることから生じるconflictsは、Source Text Module RecordsのResolveExport concrete method のstep9.e.iii でambiguousとして扱われるのではなく、ignoredできる。- importEntryをimportEntriesのうち[[LocalName]]がexportEntry.[[LocalName]]である要素とする。
ExportEntry Record { [[ModuleRequest]]: importEntry.[[ModuleRequest]], [[ImportName]]: importEntry.[[ImportName]], [[LocalName]]:null , [[ExportName]]: exportEntry.[[ExportName]] }をindirectExportEntriesへappendする。
- importedBoundNamesがexportEntry.[[LocalName]]を含まないなら、
- そうでなく、exportEntry.[[ImportName]]が
all-but-default なら、Assert : exportEntry.[[ExportName]]はnull である。- exportEntryをstarExportEntriesへappendする。
- そうでなければ、
- exportEntryをindirectExportEntriesへappendする。
- exportEntry.[[ModuleRequest]]が
- asyncをbody
Contains awaitとする。 Source Text Module Record { [[Realm]]: realm, [[Environment]]:empty , [[Namespace]]:empty , [[CycleRoot]]:empty , [[HasTLA]]: async, [[AsyncEvaluationOrder]]:unset , [[TopLevelCapability]]:empty , [[AsyncParentModules]]: « », [[PendingAsyncDependencies]]:empty , [[Status]]:new , [[EvaluationError]]:empty , [[HostDefined]]: hostDefined, [[ECMAScriptCode]]: body, [[Context]]:empty , [[ImportMeta]]:empty , [[RequestedModules]]: requestedModules, [[LoadedModules]]: « », [[ImportEntries]]: importEntries, [[LocalExportEntries]]: localExportEntries, [[IndirectExportEntries]]: indirectExportEntries, [[StarExportEntries]]: starExportEntries, [[DFSAncestorIndex]]:empty }を返す。
implementationは、そのmodule source textに対するParseModuleのevaluationより前に、module source textをparseし、それをEarly Error conditionsについてanalyseしてもよいです。ただし、errorsのreportingは、この仕様が実際にそのsource textに対してParseModuleを実行する時点までdeferされなければなりません。
16.2.1.7.2 Implementation of Module Record Abstract Methods
以下は、
16.2.1.7.2.1 GetExportedNames ( [ exportStarSet ] )
The
Assert : module.[[Status]]はnew ではない。- exportStarSetが存在しない場合、exportStarSetを新しい空の
List に設定する。 - exportStarSetがmoduleを含む場合、
- moduleをexportStarSetに追加する。
- exportedNamesを新しい空の
List とする。 - module.[[LocalExportEntries]]の各
ExportEntry Record exportEntryについて、次を行う。 - module.[[IndirectExportEntries]]の各
ExportEntry Record exportEntryについて、次を行う。 - module.[[StarExportEntries]]の各
ExportEntry Record exportEntryについて、次を行う。Assert : exportEntry.[[ModuleRequest]]はnull ではない。GetImportedModule (module, exportEntry.[[ModuleRequest]])をrequestedModuleとする。- requestedModule.
GetExportedNames (exportStarSet)をstarNamesとする。 - starNamesの各要素nameについて、次を行う。
- nameが
"default" でない場合、- exportedNamesがnameを含まない場合、
- nameをexportedNamesに追加する。
- exportedNamesがnameを含まない場合、
- nameが
- exportedNamesを返す。
16.2.1.7.2.2 ResolveExport ( exportName [ , resolveSet ] )
The
defining moduleが見つかった場合、
It performs the following steps when called:
Assert : module.[[Status]]はnew ではない。- resolveSetが存在しない場合、resolveSetを新しい空の
List に設定する。 - resolveSetの各
Record { [[Module]], [[ExportName]] } recordについて、次を行う。- moduleとrecord.[[Module]]が同じ
Module Record であり、かつexportNameがrecord.[[ExportName]]である場合、Assert : これは循環import要求である。null を返す。
- moduleとrecord.[[Module]]が同じ
Record { [[Module]]: module, [[ExportName]]: exportName }をresolveSetに追加する。- module.[[LocalExportEntries]]の各
ExportEntry Record exportEntryについて、次を行う。- exportEntry.[[ExportName]]がexportNameである場合、
Assert : moduleはこのエクスポートに対する直接束縛を提供する。ResolvedBinding Record { [[Module]]: module, [[BindingName]]: exportEntry.[[LocalName]] }を返す。
- exportEntry.[[ExportName]]がexportNameである場合、
- module.[[IndirectExportEntries]]の各
ExportEntry Record exportEntryについて、次を行う。- exportEntry.[[ExportName]]がexportNameである場合、
Assert : exportEntry.[[ModuleRequest]]はnull ではない。GetImportedModule (module, exportEntry.[[ModuleRequest]])をimportedModuleとする。- exportEntry.[[ImportName]]が
namespace である場合、Assert : moduleはこのエクスポートに対する直接束縛を提供しない。ResolvedBinding Record { [[Module]]: importedModule, [[BindingName]]:namespace }を返す。
Assert : moduleはこのエクスポートに対する特定の束縛をインポートしている。Assert : exportEntry.[[ImportName]]はStringである。- importedModule.
ResolveExport (exportEntry.[[ImportName]], resolveSet)を返す。
- exportEntry.[[ExportName]]がexportNameである場合、
- exportNameが
"default" である場合、 - starResolutionを
null とする。 - module.[[StarExportEntries]]の各
ExportEntry Record exportEntryについて、次を行う。Assert : exportEntry.[[ModuleRequest]]はnull ではない。GetImportedModule (module, exportEntry.[[ModuleRequest]])をimportedModuleとする。- importedModule.
ResolveExport (exportName, resolveSet)をresolutionとする。 - resolutionが
ambiguous である場合、ambiguous を返す。 - resolutionが
null でない場合、Assert : resolutionはResolvedBinding Record である。- starResolutionが
null である場合、- starResolutionをresolutionに設定する。
- そうでなければ、
Assert : 要求された名前を含む*エクスポートが複数存在する。- resolution.[[Module]]とstarResolution.[[Module]]が同じ
Module Record でない場合、ambiguous を返す。 - resolution.[[BindingName]]がstarResolution.[[BindingName]]でない場合、
ambiguous を返す。
- starResolutionを返す。
16.2.1.7.3 Implementation of Cyclic Module Record Abstract Methods
以下は、
16.2.1.7.3.1 InitializeEnvironment ( )
The
- module.[[IndirectExportEntries]]の各
ExportEntry Record exportEntryについて、次を行う。Assert : exportEntry.[[ExportName]]はnull ではない。- module.
ResolveExport (exportEntry.[[ExportName]])をresolutionとする。 - resolutionが
null またはambiguous のいずれかである場合、SyntaxError 例外を投げる。 Assert : resolutionはResolvedBinding Record である。
Assert : moduleからのすべての名前付きエクスポートは解決可能である。- module.[[Realm]]をrealmとする。
Assert : realmはundefined ではない。NewModuleEnvironment (realm.[[GlobalEnv]])をenvRecordとする。- module.[[Environment]]をenvRecordに設定する。
- module.[[ImportEntries]]の各
ImportEntry Record importEntryについて、次を行う。GetImportedModule (module, importEntry.[[ModuleRequest]])をimportedModuleとする。- importEntry.[[ImportName]]が
namespace である場合、GetModuleNamespace (importedModule)をnamespaceとする。- ! envRecord.
CreateImmutableBinding (importEntry.[[LocalName]],true )を実行する。 - ! envRecord.
InitializeBinding (importEntry.[[LocalName]], namespace)を実行する。
- そうでなければ、
Assert : importEntry.[[ImportName]]はStringである。- importedModule.
ResolveExport (importEntry.[[ImportName]])をresolutionとする。 - resolutionが
null またはambiguous のいずれかである場合、SyntaxError 例外を投げる。 - resolution.[[BindingName]]が
namespace である場合、GetModuleNamespace (resolution.[[Module]])をnamespaceとする。- ! envRecord.
CreateImmutableBinding (importEntry.[[LocalName]],true )を実行する。 - ! envRecord.
InitializeBinding (importEntry.[[LocalName]], namespace)を実行する。
- そうでなければ、
CreateImportBinding (envRecord, importEntry.[[LocalName]], resolution.[[Module]], resolution.[[BindingName]])を実行する。
- moduleContextを新しいECMAScriptコード実行コンテキストとする。
- moduleContextのFunctionを
null に設定する。 Assert : module.[[Realm]]はundefined ではない。- moduleContextの
Realm をmodule.[[Realm]]に設定する。 - moduleContextのScriptOrModuleをmoduleに設定する。
- moduleContextのVariableEnvironmentをmodule.[[Environment]]に設定する。
- moduleContextのLexicalEnvironmentをmodule.[[Environment]]に設定する。
- moduleContextのPrivateEnvironmentを
null に設定する。 - module.[[Context]]をmoduleContextに設定する。
- moduleContextを実行コンテキストスタックにプッシュする。moduleContextは現在、実行中の実行コンテキストである。
- module.[[ECMAScriptCode]]をcodeとする。
- codeの
VarScopedDeclarations をvariableDeclsとする。 - declaredVariableNamesを新しい空の
List とする。 - variableDeclsの各要素variableDeclについて、次を行う。
- variableDeclの
BoundNames の各要素nameについて、次を行う。- declaredVariableNamesがnameを含まない場合、
- ! envRecord.
CreateMutableBinding (name,false )を実行する。 - ! envRecord.
InitializeBinding (name,undefined )を実行する。 - nameをdeclaredVariableNamesに追加する。
- ! envRecord.
- declaredVariableNamesがnameを含まない場合、
- variableDeclの
- codeの
LexicallyScopedDeclarations をlexicalDeclsとする。 - privateEnvを
null とする。 - lexicalDeclsの各要素lexicalDeclについて、次を行う。
- lexicalDeclの
BoundNames の各要素nameについて、次を行う。- lexicalDeclの
IsConstantDeclaration がtrue である場合、- ! envRecord.
CreateImmutableBinding (name,true )を実行する。
- ! envRecord.
- そうでなければ、
- ! envRecord.
CreateMutableBinding (name,false )を実行する。
- ! envRecord.
- lexicalDeclが
FunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 、またはAsyncGeneratorDeclaration のいずれかである場合、- envRecordおよびprivateEnvを引数として、lexicalDeclの
InstantiateFunctionObject をfuncObjとする。 - ! envRecord.
InitializeBinding (name, funcObj)を実行する。
- envRecordおよびprivateEnvを引数として、lexicalDeclの
- lexicalDeclの
- lexicalDeclの
- moduleContextを実行コンテキストスタックから取り除く。
unused を返す。
16.2.1.7.3.2 ExecuteModule ( [ capability ] )
The
Assert : module はリンク済みであり、そのモジュール環境内の宣言はインスタンス化済みである。- moduleContext を module.[[Context]] とする。
- module.[[HasTLA]] が
false である場合、thenAssert : capability は存在しない。- env を module.[[Environment]] とする。
- 実行中の実行コンテキストを一時停止する。
- moduleContext を実行コンテキストスタックにプッシュする。moduleContext は今や実行中の実行コンテキストである。
- result を module.[[ECMAScriptCode]] の
Evaluation のCompletion とする。 - result を
Completion (DisposeResources (env.[[DisposableResourceStack]], result)) に設定する。 - moduleContext を一時停止し、それを実行コンテキストスタックから取り除く。
- 現在実行コンテキストスタックの最上位にあるコンテキストを、実行中の実行コンテキストとして再開する。
- result が
abrupt completion である場合、then- Return ? result.
- Else,
Assert : capability はPromiseCapability Record である。AsyncBlockStart (capability, module.[[ECMAScriptCode]], moduleContext) を実行する。
unused を返す。
16.2.1.8 Synthetic Module Records
Synthetic Module Recordは、specificationsによって定義されるmoduleに関する情報を表すために使用されます。そのexported namesはcreation時にstaticallyに定義され、一方でそれらに対応するvaluesは
| Field Name | Value Type | Meaning |
|---|---|---|
| [[ExportNames]] | a |
moduleのexportsのnames。このlistはduplicatesを含みません。 |
| [[EvaluationSteps]] | an |
moduleのevaluation時に実行するinitialization logicであり、 |
16.2.1.8.1 CreateDefaultExportSyntheticModule ( defaultExport )
The abstract operation CreateDefaultExportSyntheticModule takes argument defaultExport (an ECMAScript language value) and returns a
- realmを
current Realm Record とする。 - defaultExportをcaptureし、呼び出されたとき次のstepsを実行する、parameters (module)を持つ新しい
Abstract Closure setDefaultExportとする：SetSyntheticModuleExport (module,"default" , defaultExport)を実行する。NormalCompletion (unused )を返す。
Synthetic Module Record { [[Realm]]: realm, [[Environment]]:empty , [[Namespace]]:empty , [[HostDefined]]:undefined , [[ExportNames]]: «"default" », [[EvaluationSteps]]: setDefaultExport }を返す。
16.2.1.8.2 ParseJSONModule ( source )
The abstract operation ParseJSONModule takes argument source (a String) and returns either a
- parseResultを ?
ParseJSON (source) とする。 CreateDefaultExportSyntheticModule (parseResult.[[Value]])を返す。
16.2.1.8.3 SetSyntheticModuleExport ( module, exportName, exportValue )
The abstract operation SetSyntheticModuleExport takes arguments module (a
Assert : module.[[ExportNames]]はexportNameを含む。- envRecordをmodule.[[Environment]]とする。
Assert : envRecordはempty でない。- ! envRecord.
SetMutableBinding (exportName, exportValue,true )を実行する。 unused を返す。
16.2.1.8.4 Implementation of Module Record Abstract Methods
以下は、
16.2.1.8.4.1 LoadRequestedModules ( [ hostDefined ] )
The
NOTE :LoadRequestedModules のこのimplementationはhostDefinedを使用しない。- !
PromiseResolve (%Promise% ,undefined )を返す。
16.2.1.8.4.2 GetExportedNames ( [ exportStarSet ] )
The
NOTE :GetExportedNames のこのimplementationはexportStarSetを使用しない。- module.[[ExportNames]]を返す。
16.2.1.8.4.3 ResolveExport ( exportName [ , resolveSet ] )
The
NOTE :ResolveExport のこのimplementationはresolveSetを使用しない。- module.[[ExportNames]]がexportNameを含まないなら、
null を返す。 ResolvedBinding Record { [[Module]]: module, [[BindingName]]: exportName }を返す。
16.2.1.8.4.4 Link ( )
The
- realmをmodule.[[Realm]]とする。
- envRecordを
NewModuleEnvironment (realm.[[GlobalEnv]])とする。 - module.[[Environment]]をenvRecordに設定する。
- module.[[ExportNames]]の各String exportNameについて、以下を行う
- ! envRecord.
CreateMutableBinding (exportName,false )を実行する。 - ! envRecord.
InitializeBinding (exportName,undefined )を実行する。
- ! envRecord.
NormalCompletion (unused )を返す。
16.2.1.8.4.5 Evaluate ( )
The
- moduleContextを新しい
ECMAScript code execution context とする。 - moduleContextのFunctionを
null に設定する。 - moduleContextの
Realm をmodule.[[Realm]]に設定する。 - moduleContextのScriptOrModuleをmoduleに設定する。
- moduleContextのVariableEnvironmentをmodule.[[Environment]]に設定する。
- moduleContextのLexicalEnvironmentをmodule.[[Environment]]に設定する。
running execution context をsuspendする。- moduleContextを
execution context stack へpushする；moduleContextは現在running execution context である。 - stepsをmodule.[[EvaluationSteps]]とする。
- resultを
Completion (steps(module))とする。 - moduleContextをsuspendし、それを
execution context stack からremoveする。 execution context stack のtopにあるcontextをrunning execution context としてresumeする。- promiseCapabilityを !
NewPromiseCapability (%Promise% ) とする。 IfAbruptRejectPromise (result, promiseCapability)。- !
Call (promiseCapability.[[Resolve]],undefined , «undefined »)を実行する。 - promiseCapability.[[Promise]]を返す。
16.2.1.9 GetImportedModule ( referrer, request )
The abstract operation GetImportedModule takes arguments referrer (a
- recordsを、referrer.[[LoadedModules]]の各
LoadedModuleRequest Record rのうち、ModuleRequestsEqual (r, request)がtrue であるものから構成されるList とする。 Assert : このabstract operationをinvokeする前にLoadRequestedModules がreferrer上でsuccessfullyに完了しているため、recordsはちょうど1つの要素を持つ。- recordをrecordsの唯一の要素とする。
- record.[[Module]]を返す。
16.2.1.10 HostLoadImportedModule ( referrer, moduleRequest, hostDefined, payload )
The
referrerが
<button type="button" onclick="import('./foo.mjs')">Click me</button>import()
HostLoadImportedModuleのimplementationは次のrequirementsにconformしなければなりません：
-
host environmentは、
FinishLoadingImportedModule (referrer, moduleRequest, payload, result)を実行しなければなりません。ここでresultはloadedModule Record を含むnormal completion またはthrow completion のいずれかであり、synchronouslyまたはasynchronouslyのいずれかで実行されます。 -
このoperationが、次を満たす2つの(referrer, moduleRequest) pairsで複数回callされた場合：
- first referrerがsecond referrerと同じである；
ModuleRequestsEqual (the first moduleRequest, the second moduleRequest)がtrue である；
かつ、resultが
normal completion であるFinishLoadingImportedModule (referrer, moduleRequest, payload, result)を実行する場合、毎回同じresultを伴ってFinishLoadingImportedModule (referrer, moduleRequest, payload, result)を実行しなければなりません。 -
moduleRequest.[[Attributes]]が、entry.[[Key]]が
"type" であり、entry.[[Value]]が"json" であるentry entryを持つ場合、host environmentがFinishLoadingImportedModule (referrer, moduleRequest, payload, result)を実行するとき、resultはParseJSONModule のinvocationによって返されたCompletion Record またはthrow completion のいずれかでなければなりません。 -
operationはpayloadを
FinishLoadingImportedModule へpass throughされるopaque valueとして扱わなければなりません。
actual processは
16.2.1.11 FinishLoadingImportedModule ( referrer, moduleRequest, payload, result )
The abstract operation FinishLoadingImportedModule takes arguments referrer (a
- resultが
normal completion なら、- referrer.[[LoadedModules]]が、
ModuleRequestsEqual (record, moduleRequest)がtrue であるようなLoadedModuleRequest Record recordを含むなら、Assert : record.[[Module]]とresult.[[Value]]は同じModule Record である。
- そうでなければ、
LoadedModuleRequest Record { [[Specifier]]: moduleRequest.[[Specifier]], [[Attributes]]: moduleRequest.[[Attributes]], [[Module]]: result.[[Value]] }をreferrer.[[LoadedModules]]へappendする。
- referrer.[[LoadedModules]]が、
- payloadが
GraphLoadingState Record なら、ContinueModuleLoading (payload, result)を実行する。
- そうでなければ、
ContinueDynamicImport (payload, result)を実行する。
unused を返す。
16.2.1.12 AllImportAttributesSupported ( attrs )
The abstract operation AllImportAttributesSupported takes argument attrs (a
- supportedを
HostGetSupportedImportAttributes ()とする。 - attrsの各
ImportAttribute Record attrについて、以下を行う- supportedがattr.[[Key]]を含まないなら、
false を返す。
- supportedがattr.[[Key]]を含まないなら、
true を返す。
16.2.1.12.1 HostGetSupportedImportAttributes ( )
The
HostGetSupportedImportAttributesのimplementationは次のrequirementsにconformしなければなりません：
- これは、それぞれがsupported attributeを示すStringsの
List を返さなければなりません。 - このoperationが呼び出されるたびに、同じcontentsを同じorderで持つ同じ
List を返さなければなりません。
HostGetSupportedImportAttributesのdefault implementationは、新しい空の
16.2.1.13 GetModuleNamespace ( module )
The abstract operation GetModuleNamespace takes argument module (an instance of a concrete subclass of
Assert : moduleがCyclic Module Record なら、module.[[Status]]はnew でもunlinked でもない。- namespaceをmodule.[[Namespace]]とする。
- namespaceが
empty なら、- exportedNamesをmodule.
GetExportedNames ()とする。 - unambiguousNamesを新しい空の
List とする。 - exportedNamesの各要素nameについて、以下を行う
- resolutionをmodule.
ResolveExport (name)とする。 - resolutionが
ResolvedBinding Record なら、nameをunambiguousNamesへappendする。
- resolutionをmodule.
- namespaceを
ModuleNamespaceCreate (module, unambiguousNames)に設定する。
- exportedNamesをmodule.
- namespaceを返す。
GetModuleNamespaceは決してthrowしません。代わりに、unresolvable namesはこの時点で単にnamespaceから除外されます。それらは、どこでもexplicitly requestedされていないambiguous star exportsだけでない限り、後でreal linking errorにつながります。
16.2.1.14 Runtime Semantics: Evaluation
undefined を返す。
- resultを
ModuleItemList のEvaluation のCompletion とする。 - resultが
normal completion であり、かつresult.[[Value]]がempty であるなら、undefined を返す。
- ? resultを返す。
- slを
ModuleItemList の ?Evaluation とする。 - sを
ModuleItem のEvaluation のCompletion とする。 - ?
UpdateEmpty (s, sl)を返す。
empty を返す。
16.2.2 Imports
Syntax
16.2.2.1 Static Semantics: Early Errors
-
ImportDeclaration のBoundNames が重複entriesを含む場合、それはSyntax Errorです。
-
WithClause のWithClauseToAttributes が、a.[[Key]]がb.[[Key]]であるような2つの異なるentries aおよびbを持つ場合、それはSyntax Errorです。
16.2.2.2 Static Semantics: ImportEntries
The
- 新しい空の
List を返す。
- entries1を
ModuleItemList のImportEntries とする。 - entries2を
ModuleItem のImportEntries とする。 - entries1とentries2の
list-concatenation を返す。
- 新しい空の
List を返す。
- moduleを
ImportDeclaration のModuleRequests の唯一の要素とする。 - argument moduleを伴う
ImportClause のImportEntriesForModule を返す。
- 新しい空の
List を返す。
16.2.2.3 Static Semantics: ImportEntriesForModule
The
- entries1を、argument moduleを伴う
ImportedDefaultBinding のImportEntriesForModule とする。 - entries2を、argument moduleを伴う
NameSpaceImport のImportEntriesForModule とする。 - entries1とentries2の
list-concatenation を返す。
- entries1を、argument moduleを伴う
ImportedDefaultBinding のImportEntriesForModule とする。 - entries2を、argument moduleを伴う
NamedImports のImportEntriesForModule とする。 - entries1とentries2の
list-concatenation を返す。
- localNameを
ImportedBinding のBoundNames の唯一の要素とする。 - defaultEntryを
ImportEntry Record { [[ModuleRequest]]: module, [[ImportName]]:"default" , [[LocalName]]: localName }とする。 - « defaultEntry »を返す。
- localNameを
ImportedBinding のStringValue とする。 - entryを
ImportEntry Record { [[ModuleRequest]]: module, [[ImportName]]:namespace , [[LocalName]]: localName }とする。 - « entry »を返す。
- 新しい空の
List を返す。
- specs1を、argument moduleを伴う
ImportsList のImportEntriesForModule とする。 - specs2を、argument moduleを伴う
ImportSpecifier のImportEntriesForModule とする。 - specs1とspecs2の
list-concatenation を返す。
- localNameを
ImportedBinding のBoundNames の唯一の要素とする。 - entryを
ImportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: localName, [[LocalName]]: localName }とする。 - « entry »を返す。
- importNameを
ModuleExportName のStringValue とする。 - localNameを
ImportedBinding のStringValue とする。 - entryを
ImportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: importName, [[LocalName]]: localName }とする。 - « entry »を返す。
16.2.2.4 Static Semantics: WithClauseToAttributes
The
- 新しい空の
List を返す。
- attrsを
WithEntries のWithClauseToAttributes とする。 - attrsを、それらの[[Key]] fieldのlexicographic orderに従ってsortする。このとき各fieldの値をUTF-16 code unit valuesのsequenceとして扱う。
NOTE : このsortingは、hosts がattributesがenumeratedされるorderに基づいてbehaviourを変更することをprohibitedされる点でのみobservableである。 - attrsを返す。
- keyを
AttributeKey のPropName とする。 - entryを
ImportAttribute Record { [[Key]]: key, [[Value]]:StringLiteral のSV }とする。 - « entry »を返す。
- keyを
AttributeKey のPropName とする。 - entryを
ImportAttribute Record { [[Key]]: key, [[Value]]:StringLiteral のSV }とする。 - restを
WithEntries のWithClauseToAttributes とする。 - « entry »とrestの
list-concatenation を返す。
16.2.3 Exports
Syntax
16.2.3.1 Static Semantics: Early Errors
-
NamedExports のReferencedBindings が何らかのStringLiteral を含む場合、それはSyntax Errorです。 -
NamedExports のReferencedBindings 内の各IdentifierName nについて：nのStringValue がReservedWord であるか、nのStringValue が"implements" 、"interface" 、"let" 、"package" 、"private" 、"protected" 、"public" 、または"static" のいずれかである場合、それはSyntax Errorです。
上記のruleは、
16.2.3.2 Static Semantics: ExportedBindings
The
ExportedBindingsは、
It is defined piecewise over the following productions:
- names1を
ModuleItemList のExportedBindings とする。 - names2を
ModuleItem のExportedBindings とする。 - names1とnames2の
list-concatenation を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- this
ExportDeclaration のBoundNames を返す。
- 新しい空の
List を返す。
- names1を
ExportsList のExportedBindings とする。 - names2を
ExportSpecifier のExportedBindings とする。 - names1とnames2の
list-concatenation を返す。
- 唯一の要素が
ModuleExportName のStringValue であるList を返す。
- 唯一の要素が最初の
ModuleExportName のStringValue であるList を返す。
16.2.3.3 Static Semantics: ExportedNames
The
ExportedNamesは、
It is defined piecewise over the following productions:
- names1を
ModuleItemList のExportedNames とする。 - names2を
ModuleItem のExportedNames とする。 - names1とnames2の
list-concatenation を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 唯一の要素が
ModuleExportName のStringValue であるList を返す。
- «
"default" »を返す。
- 新しい空の
List を返す。
- names1を
ExportsList のExportedNames とする。 - names2を
ExportSpecifier のExportedNames とする。 - names1とnames2の
list-concatenation を返す。
- 唯一の要素が
ModuleExportName のStringValue であるList を返す。
- 唯一の要素が2番目の
ModuleExportName のStringValue であるList を返す。
16.2.3.4 Static Semantics: ExportEntries
The
- 新しい空の
List を返す。
- entries1を
ModuleItemList のExportEntries とする。 - entries2を
ModuleItem のExportEntries とする。 - entries1とentries2の
list-concatenation を返す。
- 新しい空の
List を返す。
- moduleを
ExportDeclaration のModuleRequests の唯一の要素とする。 - argument moduleを伴う
ExportFromClause のExportEntriesForModule を返す。
- argument
null を伴うNamedExports のExportEntriesForModule を返す。
- entriesを新しい空の
List とする。 - namesを
VariableStatement のBoundNames とする。 - namesの各要素nameについて、以下を行う
ExportEntry Record { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]: name, [[ExportName]]: name }をentriesへappendする。
- entriesを返す。
- entriesを新しい空の
List とする。 - namesを
Declaration のBoundNames とする。 - namesの各要素nameについて、以下を行う
ExportEntry Record { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]: name, [[ExportName]]: name }をentriesへappendする。
- entriesを返す。
- namesを
HoistableDeclaration のBoundNames とする。 - localNameをnamesの唯一の要素とする。
- 唯一の要素が新しい
ExportEntry Record { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]: localName, [[ExportName]]:"default" }であるList を返す。
- namesを
ClassDeclaration のBoundNames とする。 - localNameをnamesの唯一の要素とする。
- 唯一の要素が新しい
ExportEntry Record { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]: localName, [[ExportName]]:"default" }であるList を返す。
- entryを
ExportEntry Record { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]:"*default*" , [[ExportName]]:"default" }とする。 - « entry »を返す。
16.2.3.5 Static Semantics: ExportEntriesForModule
The
- entryを
ExportEntry Record { [[ModuleRequest]]: module, [[ImportName]]:all-but-default , [[LocalName]]:null , [[ExportName]]:null }とする。 - « entry »を返す。
- exportNameを
ModuleExportName のStringValue とする。 - entryを
ExportEntry Record { [[ModuleRequest]]: module, [[ImportName]]:namespace , [[LocalName]]:null , [[ExportName]]: exportName }とする。 - « entry »を返す。
- 新しい空の
List を返す。
- specs1を、argument moduleを伴う
ExportsList のExportEntriesForModule とする。 - specs2を、argument moduleを伴う
ExportSpecifier のExportEntriesForModule とする。 - specs1とspecs2の
list-concatenation を返す。
- sourceNameを
ModuleExportName のStringValue とする。 - moduleが
null なら、- localNameをsourceNameとする。
- importNameを
null とする。
- そうでなければ、
- localNameを
null とする。 - importNameをsourceNameとする。
- localNameを
- 唯一の要素が新しい
ExportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: importName, [[LocalName]]: localName, [[ExportName]]: sourceName }であるList を返す。
- sourceNameを最初の
ModuleExportName のStringValue とする。 - exportNameを2番目の
ModuleExportName のStringValue とする。 - moduleが
null なら、- localNameをsourceNameとする。
- importNameを
null とする。
- そうでなければ、
- localNameを
null とする。 - importNameをsourceNameとする。
- localNameを
- 唯一の要素が新しい
ExportEntry Record { [[ModuleRequest]]: module, [[ImportName]]: importName, [[LocalName]]: localName, [[ExportName]]: exportName }であるList を返す。
16.2.3.6 Static Semantics: ReferencedBindings
The
- 新しい空の
List を返す。
- names1を
ExportsList のReferencedBindings とする。 - names2を
ExportSpecifier のReferencedBindings とする。 - names1とnames2の
list-concatenation を返す。
- 唯一の要素が
IdentifierName であるList を返す。
- 唯一の要素が
StringLiteral であるList を返す。
16.2.3.7 Runtime Semantics: Evaluation
empty を返す。
VariableStatement の ?Evaluation を返す。
Declaration の ?Evaluation を返す。
HoistableDeclaration の ?Evaluation を返す。
- valueを
ClassDeclaration の ?BindingClassDeclarationEvaluation とする。 - classNameを
ClassDeclaration のBoundNames の唯一の要素とする。 - classNameが
"*default*" なら、- envRecordを
running execution context のLexicalEnvironmentとする。 - ?
InitializeBoundName ("*default*" , value, envRecord)を実行する。
- envRecordを
empty を返す。
IsAnonymousFunctionDefinition (AssignmentExpression )がtrue なら、- valueを、argument
"default" を伴うAssignmentExpression の ?NamedEvaluation とする。
- valueを、argument
- そうでなければ、
- rhsを
AssignmentExpression の ?Evaluation とする。 - valueを ?
GetValue (rhs) とする。
- rhsを
- envRecordを
running execution context のLexicalEnvironmentとする。 - ?
InitializeBoundName ("*default*" , value, envRecord)を実行する。 empty を返す。
17 Error Handling and Language Extensions
implementationは、ほとんどのerrorsを、関連するECMAScript language constructが評価される時点でreportしなければなりません。early errorは、そのerrorを含むevalが呼び出された時点でreportされ、eval codeのevaluationを妨げます。
implementationは、この仕様の“Static Semantics: Early Errors” subclauseに列挙されているconditionの任意のoccurrenceを
implementationは、compilerがあるconstructがどのようなcircumstancesの下でもerrorなしにexecuteできないことをproveできる場合であっても、他の種類のerrorsを
implementationは、以下を除き、指定された通りにすべてのerrorsをreportしなければなりません：
-
17.1 で制限されている場合を除き、hostまたはimplementationはScript syntax、Module syntax、およびregular expression patternまたはflag syntaxを拡張してもよいです。これを可能にするため、SyntaxError をthrowすることが許されているすべてのoperations（evalの呼び出し、regular expression literalの使用、またはFunctionもしくはRegExpconstructor の使用など）は、script syntaxまたはregular expression patternもしくはflag syntaxへのhost-defined extensionに遭遇したとき、SyntaxError をthrowする代わりにhost-defined behaviourを示すことが許されます。 -
17.1 で制限されている場合を除き、hostまたはimplementationは、この仕様で記述されるものを超える追加のtypes、values、objects、properties、およびfunctionsを提供してもよいです。これにより、constructs（global scope内でvariableをlookupするなど）は、error（ReferenceError など）をthrowする代わりにhost-defined behaviourを持つ場合があります。
17.1 Forbidden Extensions
implementationは、以下の方法でこの仕様を拡張してはなりません：
-
strict mode code 内のsyntacticconstructors を使用して定義されたECMAScriptfunction objects は、"caller" または"arguments" という名前のown propertiesを伴って作成されてはなりません。そのようなown propertiesは、definitionがstrict mode code 内に含まれるかどうかに関わらず、ArrowFunction 、MethodDefinition 、GeneratorDeclaration 、GeneratorExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、ClassDeclaration 、ClassExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、またはAsyncArrowFunction を使用して定義されたfunction objects についても作成されてはなりません。Built-in functions、Functionconstructor を使用して作成されたstrict functions 、Generatorconstructor を使用して作成されたgenerator functions、AsyncFunctionconstructor を使用して作成されたasync functions、およびbindmethodを使用して作成されたfunctionsも、そのようなown propertiesを伴って作成されてはなりません。 -
implementationが任意の
function object を"caller" という名前のown propertyで拡張する場合、[[Get]]または[[GetOwnProperty]]を使用してobservedされるそのpropertyのvalueはstrict function objectであってはなりません。それがaccessor property である場合、そのpropertyの[[Get]] attributeのvalueであるfunctionは、呼び出されたときstrict function を決して返してはなりません。 -
mapped arguments objectsもunmapped arguments objectsも、
"caller" という名前のown propertyを伴って作成されてはなりません。 -
toLocaleStringという名前のものなど、ECMA-402で指定されるbuilt-in methodsのbehaviourは、ECMA-402で指定される場合を除き、拡張されてはなりません。 -
22.2.1 およびB.1.2 内のRegExp pattern grammarsは、[UnicodeMode] grammar parameterが存在する場合、source characters A-Zまたはa-zのいずれかをIdentityEscape として認識するように拡張されてはなりません。[+UnicodeMode] -
Syntactic Grammarは、
BindingIdentifier nonterminal symbolにmatchするsource textの直後にtoken:が続くことを許すような方法で拡張されてはなりません。 -
strict mode code を処理するとき、implementationは12.9.3.1 のearly error rulesを緩和してはなりません。 -
TemplateEscapeSequence は、12.9.4 で定義されるLegacyOctalEscapeSequence またはNonOctalDecimalEscapeSequence を含むように拡張されてはなりません。 -
strict mode code を処理するとき、B.3.1 、B.3.2 、B.3.3 、およびB.3.5 で定義されるextensionsはsupportされてはなりません。 -
Module goal symbol としてparseするとき、B.1.1 で定義されるlexical grammar extensionsはsupportされてはなりません。 -
ImportCall は拡張されてはなりません。
18 ECMAScript Standard Built-in Objects
ECMAScript
特に指定されない限り、functionとしてcallableなbuilt-in objectは、
多くのbuilt-in objectsはfunctionsです：それらはargumentsを伴ってinvokedできます。さらにその一部はnew operatorとともに使用することを意図したfunctionsです。各built-in functionについて、この仕様は、そのfunctionが要求するargumentsと、そのnew expressionによって返される特定のobject instancesのpropertiesを記述します。
特定のfunctionのdescriptionで別途指定されない限り、built-in functionまたは
特定のfunctionのdescriptionで別途指定されない限り、記述されるbuilt-in functionまたは
built-in functionsのsetに追加のcapabilitiesを加えるimplementationsは、既存のfunctionsに新しいparametersを追加するのではなく、新しいfunctionsを追加することによってそれを行うことが推奨されます。
特に指定されない限り、すべてのbuilt-in functionおよびすべてのbuilt-in Function.prototype（
特に指定されない限り、すべてのbuilt-in prototype objectは、Object.prototype（
この仕様がbuilt-in
この仕様で定義される各built-in functionは、
例えば、
特に指定されない限り、built-in
特に指定されない限り、built-in
clauses
clauses
19 The Global Object
global objectは：
- controlが任意の
execution context に入る前に作成されます。 - [[Construct]] internal methodを持ちません；
newoperatorを伴うconstructor として使用できません。 - [[Call]] internal methodを持ちません；functionとして呼び出せません。
- valueが
host-defined である[[Prototype]] internal slotを持ちます。 - この仕様で定義されるpropertiesに加えて、
host-defined propertiesを持ってもよいです。これには、そのvalueがglobal object自身であるpropertyが含まれる場合があります。
19.1 Value Properties of the Global Object
19.1.1 globalThis
このpropertyはattributes { [[Writable]]:
19.1.2 Infinity
このpropertyはattributes { [[Writable]]:
19.1.3 NaN
このpropertyはattributes { [[Writable]]:
19.1.4 undefined
このpropertyはattributes { [[Writable]]:
19.2 Function Properties of the Global Object
19.2.1 eval ( source )
このfunctionは%eval% intrinsic objectです。
これは呼び出されたとき、次のstepsを実行します：
- ?
PerformEval (source,false ,false )を返す。
19.2.1.1 PerformEval ( source, strictCaller, direct )
The abstract operation PerformEval takes arguments source (an ECMAScript language value), strictCaller (a Boolean), and direct (a Boolean) and returns either a
Assert : directがfalse なら、strictCallerもfalse である。- sourceがStringでないなら、sourceを返す。
- evalRealmを
current Realm Record とする。 NOTE :direct eval の場合、evalRealmはevalのcallerとevalfunction自身の両方のrealm である。- ?
HostEnsureCanCompileStrings (evalRealm, « », source, direct)を実行する。 - inFuncを
false とする。 - inMethodを
false とする。 - inDerivedCtorを
false とする。 - inClassFieldInitializerを
false とする。 - directが
true なら、- thisEnvRecordを
GetThisEnvironment ()とする。 - thisEnvRecordが
Function Environment Record なら、- funcをthisEnvRecord.[[FunctionObject]]とする。
- inFuncを
true に設定する。 - inMethodをthisEnvRecord.
HasSuperBinding ()に設定する。 - func.[[ConstructorKind]]が
derived なら、inDerivedCtorをtrue に設定する。 - classFieldInitializerNameをfunc.[[ClassFieldInitializerName]]とする。
- classFieldInitializerNameが
empty でないなら、inClassFieldInitializerをtrue に設定する。
- thisEnvRecordを
- 次のsubstepsを
implementation-defined orderで実行し、parsingとerror detectionをinterleaveしてもよい：- scriptを
ParseText (source,Script )とする。 - scriptがerrorsの
List なら、SyntaxError 例外をthrowする。 - script
Contains ScriptBody がfalse なら、undefined を返す。 - bodyをscriptの
ScriptBody とする。 - inFuncが
false であり、bodyContains NewTarget であるなら、SyntaxError 例外をthrowする。 - inMethodが
false であり、bodyContains SuperProperty であるなら、SyntaxError 例外をthrowする。 - inDerivedCtorが
false であり、bodyContains SuperCall であるなら、SyntaxError 例外をthrowする。 - inClassFieldInitializerが
true であり、bodyのContainsArguments がtrue であるなら、SyntaxError 例外をthrowする。
- scriptを
- strictCallerが
true なら、strictEvalをtrue とする。 - そうでなければ、strictEvalをscriptの
ScriptIsStrict とする。 - runningContextを
running execution context とする。 NOTE : directがtrue なら、runningContextはdirect eval を実行したexecution context である。directがfalse なら、runningContextはevalfunctionのinvocationに対するexecution context である。- directが
true なら、- lexicalEnvを
NewDeclarativeEnvironment (runningContextのLexicalEnvironment)とする。 - variableEnvをrunningContextのVariableEnvironmentとする。
- privateEnvをrunningContextのPrivateEnvironmentとする。
- lexicalEnvを
- そうでなければ、
- lexicalEnvを
NewDeclarativeEnvironment (evalRealm.[[GlobalEnv]])とする。 - variableEnvをevalRealm.[[GlobalEnv]]とする。
- privateEnvを
null とする。
- lexicalEnvを
- strictEvalが
true なら、variableEnvをlexicalEnvに設定する。 - runningContextがまだsuspendedでないなら、runningContextをsuspendする。
- evalContextを新しい
ECMAScript code execution context とする。 - evalContextのFunctionを
null に設定する。 - evalContextの
Realm をevalRealmに設定する。 - evalContextのScriptOrModuleをrunningContextのScriptOrModuleに設定する。
- evalContextのVariableEnvironmentをvariableEnvに設定する。
- evalContextのLexicalEnvironmentをlexicalEnvに設定する。
- evalContextのPrivateEnvironmentをprivateEnvに設定する。
- evalContextを
execution context stack へpushする；evalContextは現在running execution context である。 - resultを
Completion (EvalDeclarationInstantiation (body, variableEnv, lexicalEnv, privateEnv, strictEval))とする。 - resultが
normal completion なら、- resultを
Completion (bodyのEvaluation )に設定する。
- resultを
- resultが
normal completion であり、result.[[Value]]がempty であるなら、- resultを
NormalCompletion (undefined )に設定する。
- resultを
- evalContextをsuspendし、
execution context stack からremoveする。 execution context stack のtopにあるcontextをrunning execution context としてresumeする。- ? resultを返す。
calling contextのcodeまたはeval codeのいずれかがlet、const、またはclass declarationsによってintroducedされるbindingsは、常に新しいLexicalEnvironment内にinstantiatedされます。
19.2.1.2 HostEnsureCanCompileStrings ( calleeRealm, paramStrings, bodyString, direct )
The
paramStringsは、function eval callに渡されるstringを表します。
directは、evaluationが
HostEnsureCanCompileStringsのdefault implementationは
19.2.1.3 EvalDeclarationInstantiation ( body, variableEnv, lexicalEnv, privateEnv, strict )
The abstract operation EvalDeclarationInstantiation takes arguments body (a
- bodyの
VarDeclaredNames をvariableNamesとする。 - bodyの
VarScopedDeclarations をvariableDeclsとする。 - strictが
false である場合、- variableEnvが
Global Environment Record である場合、- variableNamesの各要素nameについて、次を行う。
HasLexicalDeclaration (variableEnv, name)がtrue である場合、SyntaxError 例外を投げる。NOTE :evalは、グローバルlexical宣言によってシャドーイングされることになるグローバルvar宣言を作成しない。
- variableNamesの各要素nameについて、次を行う。
- lexicalEnvをthisEnvとする。
Assert : 次のループは終了する。- thisEnvとvariableEnvが同じ
Environment Record でない間、繰り返す。- thisEnvが
Object Environment Record でない場合、NOTE : with文の環境はlexical宣言を含むことができないため、var/letの巻き上げの競合を確認する必要はない。- variableNamesの各要素nameについて、次を行う。
- ! thisEnv.
HasBinding (name)がtrue である場合、ホスト がWebブラウザである、またはその他の形でCatch Blocks内のVariableStatements をサポートする場合、- thisEnvが
Catch 節のEnvironment Record でない場合、SyntaxError 例外を投げる。
- thisEnvが
- そうでなければ、
SyntaxError 例外を投げる。
NOTE :direct eval は、同名のlexical宣言を越えてvar宣言を巻き上げない。
- ! thisEnv.
- thisEnvをthisEnv.[[OuterEnv]]に設定する。
- thisEnvが
- variableEnvが
- privateIdentifiersを新しい空の
List とする。 - privateEnvをpointerとする。
- pointerが
null でない間、繰り返す。- pointer.[[Names]]の各
Private Name bindingについて、次を行う。- privateIdentifiersがbinding.[[Description]]を含まない場合、binding.[[Description]]をprivateIdentifiersに追加する。
- pointerをpointer.[[OuterPrivateEnvironment]]に設定する。
- pointer.[[Names]]の各
- privateIdentifiersを引数とするbodyの
AllPrivateIdentifiersValid がfalse である場合、SyntaxError 例外を投げる。 - funcsToInitializeを新しい空の
List とする。 - declaredFuncNamesを新しい空の
List とする。 - variableDeclsの各要素variableDeclについて、
List の逆順で、次を行う。- variableDeclが
VariableDeclaration 、ForBinding 、またはBindingIdentifier のいずれでもない場合、Assert : variableDeclは、FunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 、またはAsyncGeneratorDeclaration のいずれかである。NOTE : 同じ名前に対して複数の関数宣言がある場合、最後の宣言が使用される。- variableDeclの
BoundNames の唯一の要素をfuncNameとする。 - declaredFuncNamesがfuncNameを含まない場合、
- variableEnvが
Global Environment Record である場合、- ?
CanDeclareGlobalFunction (variableEnv, funcName)をfuncDefinableとする。 - funcDefinableが
false である場合、TypeError 例外を投げる。
- ?
- funcNameをdeclaredFuncNamesに追加する。
- variableDeclをfuncsToInitializeの最初の要素として挿入する。
- variableEnvが
- variableDeclが
- declaredVariableNamesを新しい空の
List とする。 - variableDeclsの各要素variableDeclについて、次を行う。
- variableDeclが
VariableDeclaration 、ForBinding 、またはBindingIdentifier のいずれかである場合、- variableDeclの
BoundNames の各String nameについて、次を行う。- declaredFuncNamesがnameを含まない場合、
- variableEnvが
Global Environment Record である場合、- ?
CanDeclareGlobalVar (variableEnv, name)をvariableDefinableとする。 - variableDefinableが
false である場合、TypeError 例外を投げる。
- ?
- declaredVariableNamesがnameを含まない場合、
- nameをdeclaredVariableNamesに追加する。
- variableEnvが
- declaredFuncNamesがnameを含まない場合、
- variableDeclの
- variableDeclが
- strictが
false であり、かつホスト がWebブラウザである、またはその他の形でBlock-Level Function Declarations Web Legacy Compatibility Semantics をサポートする場合、- declaredFuncNamesとdeclaredVariableNamesの
list-concatenation をdeclaredFuncOrVariableNamesとする。 - body
Contains xがtrue であるような任意のBlock 、CaseClause 、またはDefaultClause xのStatementList に直接含まれる各FunctionDeclaration funcDeclについて、次を行う。- funcDeclの
BindingIdentifier のStringValue をfuncNameとする。 FunctionDeclaration funcDeclを、funcNameをBindingIdentifier として持つVariableStatement に置き換えても、bodyに対してEarly Errorsが発生しない場合、- bindingExistsを
false とする。 - thisEnvをlexicalEnvに設定する。
Assert : 次のループは終了する。- thisEnvがvariableEnvでない間、繰り返す。
- thisEnvが
Object Environment Record でない場合、- ! thisEnv.
HasBinding (funcName)がtrue である場合、ホスト がWebブラウザである、またはその他の形でCatch Blocks内のVariableStatements をサポートする場合、- thisEnvが
Catch 節のEnvironment Record でない場合、bindingExistsをtrue に設定する。
- thisEnvが
- そうでなければ、
- bindingExistsを
true に設定する。
- bindingExistsを
- ! thisEnv.
- thisEnvをthisEnv.[[OuterEnv]]に設定する。
- thisEnvが
- bindingExistsが
false であり、かつvariableEnvがGlobal Environment Record である場合、HasLexicalDeclaration (variableEnv, funcName)がfalse である場合、- ?
CanDeclareGlobalVar (variableEnv, funcName)をfuncDefinableとする。
- ?
- そうでなければ、
- funcDefinableを
false とする。
- funcDefinableを
- そうでなければ、
- funcDefinableを
true とする。
- funcDefinableを
- bindingExistsが
false であり、かつfuncDefinableがtrue である場合、- declaredFuncOrVariableNamesがfuncNameを含まない場合、
- variableEnvが
Global Environment Record である場合、- ?
CreateGlobalVarBinding (variableEnv, funcName,true )を実行する。
- ?
- そうでなければ、
- ! variableEnv.
HasBinding (funcName)をbindingExistsに設定する。 - bindingExistsが
false である場合、- ! variableEnv.
CreateMutableBinding (funcName,true )を実行する。 - ! variableEnv.
InitializeBinding (funcName,undefined )を実行する。
- ! variableEnv.
- ! variableEnv.
- funcNameをdeclaredFuncOrVariableNamesに追加する。
- variableEnvが
FunctionDeclaration funcDeclが評価されるとき、15.2.6 で提供されるFunctionDeclaration Evaluation アルゴリズムの代わりに、次のステップを実行する。- 実行中の実行コンテキストのVariableEnvironmentをglobalEnvとする。
- 実行中の実行コンテキストのLexicalEnvironmentをblockEnvとする。
- ! blockEnv.
GetBindingValue (funcName,false )をfuncObjとする。 - ? globalEnv.
SetMutableBinding (funcName, funcObj,false )を実行する。 unused を返す。
- declaredFuncOrVariableNamesがfuncNameを含まない場合、
- bindingExistsを
- funcDeclの
- declaredFuncNamesとdeclaredVariableNamesの
NOTE : variableEnvがGlobal Environment Record であり、かつグローバルオブジェクトがProxy exotic object である場合を除き、このアルゴリズムステップ以降に異常終了は発生しない。- bodyの
LexicallyScopedDeclarations をlexicalDeclsとする。 - lexicalDeclsの各要素lexicalDeclについて、次を行う。
NOTE : Lexically declared nameは、ここでインスタンス化されるだけで、初期化されない。- lexicalDeclの
BoundNames の各要素nameについて、次を行う。- lexicalDeclの
IsConstantDeclaration がtrue である場合、- ? lexicalEnv.
CreateImmutableBinding (name,true )を実行する。
- ? lexicalEnv.
- そうでなければ、
- ? lexicalEnv.
CreateMutableBinding (name,false )を実行する。
- ? lexicalEnv.
- lexicalDeclの
- funcsToInitializeの各
Parse Node funcDeclについて、次を行う。- funcDeclの
BoundNames の唯一の要素をfuncNameとする。 - lexicalEnvおよびprivateEnvを引数として、funcDeclの
InstantiateFunctionObject をfuncObjとする。 - variableEnvが
Global Environment Record である場合、- ?
CreateGlobalFunctionBinding (variableEnv, funcName, funcObj,true )を実行する。
- ?
- そうでなければ、
- ! variableEnv.
HasBinding (funcName)をbindingExistsとする。 - bindingExistsが
false である場合、NOTE : 次の呼び出しは、ステップ14 に先立つ検証により、abrupt completion を返すことができない。- ! variableEnv.
CreateMutableBinding (funcName,true )を実行する。 - ! variableEnv.
InitializeBinding (funcName, funcObj)を実行する。
- そうでなければ、
- ! variableEnv.
SetMutableBinding (funcName, funcObj,false )を実行する。
- ! variableEnv.
- ! variableEnv.
- funcDeclの
- declaredVariableNamesの各String variableNameについて、次を行う。
- variableEnvが
Global Environment Record である場合、- ?
CreateGlobalVarBinding (variableEnv, variableName,true )を実行する。
- ?
- そうでなければ、
- ! variableEnv.
HasBinding (variableName)をbindingExistsとする。 - bindingExistsが
false である場合、NOTE : 次の呼び出しは、ステップ14 に先立つ検証により、abrupt completion を返すことができない。- ! variableEnv.
CreateMutableBinding (variableName,true )を実行する。 - ! variableEnv.
InitializeBinding (variableName,undefined )を実行する。
- ! variableEnv.
- variableEnvが
unused を返す。
19.2.2 isFinite ( value )
このfunctionは%isFinite% intrinsic objectです。
これは呼び出されたとき、次のstepsを実行します：
19.2.3 isNaN ( value )
このfunctionは%isNaN% intrinsic objectです。
これは呼び出されたとき、次のstepsを実行します：
- numberを ?
ToNumber (value) とする。 - numberが
NaN なら、true を返す。 false を返す。
ECMAScript codeがvalue XがX !== Xという形式のexpressionです。そのresultは、Xが
19.2.4 parseFloat ( string )
このfunctionは、string argumentのcontentsをdecimal literalとしてinterpretすることによってdictatedされるNumber valueをproduceします。
これは%parseFloat% intrinsic objectです。
これは呼び出されたとき、次のstepsを実行します：
- inputStringを ?
ToString (string) とする。 - trimmedStringを !
TrimString (inputString,start ) とする。 - trimmedを
StringToCodePoints (trimmedString)とする。 - trimmedPrefixを、
StrDecimalLiteral のsyntaxをsatisfiesするtrimmedのlongest prefixとする。これはtrimmed自身である場合があります。そのようなprefixがない場合、NaN を返す。 - parsedNumberを
ParseText (trimmedPrefix,StrDecimalLiteral )とする。 Assert : parsedNumberはParse Node である。- parsedNumberの
StringNumericValue を返す。
このfunctionは、stringのleading portionだけをNumber valueとしてinterpretする場合があります；decimal literalのnotationの一部としてinterpretできないcode unitsは無視され、そのようなcode unitsが無視されたことを示すindicationは与えられません。
19.2.5 parseInt ( string, radix )
このfunctionは、指定されたradixに従ってstringのcontentsをinterpretすることによってdictatedされる
これは%parseInt% intrinsic objectです。
これは呼び出されたとき、次のstepsを実行します：
- inputStringを ?
ToString (string) とする。 - trimmedStringを !
TrimString (inputString,start ) とする。 - signを1とする。
- trimmedStringがemptyでなく、trimmedStringの最初のcode unitがcode unit 0x002D (HYPHEN-MINUS)であるなら、signを-1に設定する。
- trimmedStringがemptyでなく、trimmedStringの最初のcode unitがcode unit 0x002B (PLUS SIGN)またはcode unit 0x002D (HYPHEN-MINUS)のいずれかであるなら、trimmedStringをindex 1からのtrimmedStringの
substring に設定する。 - radixMVを
ℝ (?ToInt32 (radix))とする。 - stripPrefixを
true とする。 - radixMV ≠ 0なら、
- radixMV < 2またはradixMV > 36なら、
NaN を返す。 - radixMV ≠ 16なら、stripPrefixを
false に設定する。
- radixMV < 2またはradixMV > 36なら、
- そうでなければ、
- radixMVを10に設定する。
- stripPrefixが
true なら、- trimmedStringのlengthが≥ 2であり、trimmedStringの最初の2つのcode unitsが
"0x" または"0X" のいずれかであるなら、- trimmedStringをindex 2からのtrimmedStringの
substring に設定する。 - radixMVを16に設定する。
- trimmedStringをindex 2からのtrimmedStringの
- trimmedStringのlengthが≥ 2であり、trimmedStringの最初の2つのcode unitsが
- trimmedStringがradix-radixMV digitでないcode unitを含むなら、endをtrimmedString内の最初のそのようなcode unitのindexとする；そうでなければ、endをtrimmedStringのlengthとする。
- numberStringを0からendまでのtrimmedStringの
substring とする。 - numberStringがemptyなら、
NaN を返す。 - mathIntを、radix-radixMV notationにおいてnumberStringによって表される
integer valueとする。values 10から35のdigitsにはletters A through Zおよびa through zを使用する。（ただし、radixMV = 10であり、numberStringが20を超えるsignificant digitsを含む場合、20番目以降の各significant digitはimplementationの選択により0 digitで置き換えられてもよい；またradixMVが2、4、8、10、16、または32のいずれでもない場合、mathIntはradix-radixMV notationでnumberStringによってdenotedされるinteger valueを表すimplementation-approximated integer であってもよい。） - mathInt = 0なら、
- sign = -1なら、
-0 𝔽を返す。 +0 𝔽を返す。
- sign = -1なら、
𝔽 (sign × mathInt)を返す。
19.2.6 URI Handling Functions
Uniform Resource Identifiers、すなわちURIsは、resources（例えばweb pagesやfiles）およびそれらにaccessするためのtransport protocols（例えばHTTPやFTP）をInternet上でidentifyするStringsです。ECMAScript language自身は、このsectionで記述されるようにURIsをencodeおよびdecodeするfunctionsを除き、URIsを使用するためのsupportを提供しません。encodeURIおよびdecodeURIはcomplete URIsとともに動作することを意図しています；それらは、reserved charactersがspecial meaning（例えばdelimitersとして）を持つことが意図されているとassumeし、したがってencodeされません。encodeURIComponentおよびdecodeURIComponentはURIのindividual componentsとともに動作することを意図しています；それらは、reserved charactersがtextを表し、componentがcomplete URIの一部であるときspecial meaningを避けるためにencodeされなければならないとassumeします。
reserved charactersのsetはRFC 2396に基づいており、よりrecentなRFC 3986によってintroducedされたchangesを反映していません。
ECMAScriptの多くのimplementationsは、web pagesをmanipulateする追加のfunctionsおよびmethodsを提供します；これらのfunctionsはこのstandardのscope外です。
19.2.6.1 decodeURI ( encodedURI )
このfunctionは、encodeURI functionによってintroducedされ得る種類の各escape sequenceおよびUTF-8 encodingが、それが表すcode pointのUTF-16 encodingで置き換えられたURIのnew versionをcomputesします。encodeURIによってintroducedされ得なかったescape sequencesは置き換えられません。
これは%decodeURI% intrinsic objectです。
これは呼び出されたとき、次のstepsを実行します：
19.2.6.2 decodeURIComponent ( encodedURIComponent )
このfunctionは、encodeURIComponent functionによってintroducedされ得る種類の各escape sequenceおよびUTF-8 encodingが、それが表すcode pointのUTF-16 encodingで置き換えられたURIのnew versionをcomputesします。
これは%decodeURIComponent% intrinsic objectです。
これは呼び出されたとき、次のstepsを実行します：
19.2.6.3 encodeURI ( uri )
このfunctionは、UTF-16 encoded（
これは%encodeURI% intrinsic objectです。
これは呼び出されたとき、次のstepsを実行します：
19.2.6.4 encodeURIComponent ( uriComponent )
このfunctionは、UTF-16 encoded（
これは%encodeURIComponent% intrinsic objectです。
これは呼び出されたとき、次のstepsを実行します：
19.2.6.5 Encode ( string, extraUnescaped )
The abstract operation Encode takes arguments string (a String) and extraUnescaped (a String) and returns either a
- lengthをstringのlengthとする。
- resultをempty Stringとする。
- alwaysUnescapedをASCII word charactersと
"-.!~*'()" のstring-concatenation とする。 - unescapedSetをalwaysUnescapedとextraUnescapedの
string-concatenation とする。 - kを0とする。
- k < lengthの間、繰り返す
- codeUnitをstring内のindex kにあるcode unitとする。
- unescapedSetがcodeUnitを含むなら、
- kをk + 1に設定する。
- resultをresultとcodeUnitの
string-concatenation に設定する。
- そうでなければ、
- codePointを
CodePointAt (string, k)とする。 - codePoint.[[IsUnpairedSurrogate]]が
true なら、URIError 例外をthrowする。 - kをk + codePoint.[[CodeUnitCount]]に設定する。
- octetsをcodePoint.[[CodePoint]]にUTF-8 transformationをapplyした結果のoctetsの
List とする。 - octetsの各要素octetについて、以下を行う
- hexをoctetのString representationとし、uppercase hexadecimal numberとしてformattedする。
- resultをresult、
"%" 、およびStringPad (hex, 2,"0" ,start )のstring-concatenation に設定する。
- codePointを
- resultを返す。
percent-encodingはindividual octetsを表すために使用されるため、単一のcode pointはmultiple consecutive escape sequences（その8-bit UTF-8 code unitsのそれぞれに1つ）として表現される場合があります。
19.2.6.6 Decode ( string, preserveEscapeSet )
The abstract operation Decode takes arguments string (a String) and preserveEscapeSet (a String) and returns either a
- lengthをstringのlengthとする。
- resultをempty Stringとする。
- kを0とする。
- k < lengthの間、繰り返す
- codeUnitをstring内のindex kにあるcode unitとする。
- segmentをcodeUnitとする。
- codeUnitがcode unit 0x0025 (PERCENT SIGN)であるなら、
- k + 3 > lengthなら、
URIError 例外をthrowする。 - escapeをkからk + 3までのstringの
substring とする。 - firstOctetを
ParseHexOctet (string, k + 1)とする。 - firstOctetが
integer でないなら、URIError 例外をthrowする。 - kをk + 2に設定する。
- nをfirstOctet内のleading 1 bitsの数とする。
- n = 0なら、
- asciiCharを、numeric valueがfirstOctetであるcode unitとする。
- preserveEscapeSetがasciiCharを含むなら、segmentをescapeに設定する；そうでなければ、segmentをasciiCharに設定する。
- そうでなければ、
- n = 1またはn > 4なら、
URIError 例外をthrowする。 - octetsを« firstOctet »とする。
- jを1とする。
- j < nの間、繰り返す
- kをk + 1に設定する。
- k + 3 > lengthなら、
URIError 例外をthrowする。 - string内のindex kにあるcode unitがcode unit 0x0025 (PERCENT SIGN)でないなら、
URIError 例外をthrowする。 - continuationByteを
ParseHexOctet (string, k + 1)とする。 - continuationByteが
integer でないなら、URIError 例外をthrowする。 - continuationByteをoctetsへappendする。
- kをk + 2に設定する。
- jをj + 1に設定する。
Assert : octetsのlengthはnである。- octetsがUnicode code pointのvalid UTF-8 encodingを含まないなら、
URIError 例外をthrowする。 - codePointを、UTF-8 transformationをoctetsにapplyして得られるcode point、すなわちoctetsの
List から21-bit valueへの変換で得られるものとする。 - segmentを
UTF16EncodeCodePoint (codePoint)に設定する。
- n = 1またはn > 4なら、
- k + 3 > lengthなら、
- resultをresultとsegmentの
string-concatenation に設定する。 - kをk + 1に設定する。
- resultを返す。
RFC 3629はinvalid UTF-8 octet sequencesのdecodingをprohibitしています。例えば、invalid sequence 0xC0 0x80はcode unit 0x0000へdecodeしてはなりません。Decode algorithmのimplementationsは、そのようなinvalid sequencesにencounterしたとき
19.2.6.7 ParseHexOctet ( string, position )
The abstract operation ParseHexOctet takes arguments string (a String) and position (a non-negative
- lengthをstringのlengthとする。
Assert : position + 2 ≤ lengthである。- hexDigitsをpositionからposition + 2までのstringの
substring とする。 - parseResultを
ParseText (hexDigits,HexDigits )とする。[~Sep] - parseResultが
Parse Node でないなら、parseResultを返す。 - nをparseResultのMVとする。
Assert : nは0から255までのinclusive interval 内にある。- nを返す。
19.3 Constructor Properties of the Global Object
19.3.1 AggregateError ( . . . )
19.3.2 Array ( . . . )
19.3.3 ArrayBuffer ( . . . )
19.3.4 AsyncDisposableStack ( . . . )
19.3.5 BigInt ( . . . )
19.3.6 BigInt64Array ( . . . )
19.3.7 BigUint64Array ( . . . )
19.3.8 Boolean ( . . . )
19.3.9 DataView ( . . . )
19.3.10 Date ( . . . )
19.3.11 DisposableStack ( . . . )
19.3.12 Error ( . . . )
19.3.13 EvalError ( . . . )
19.3.14 FinalizationRegistry ( . . . )
19.3.15 Float16Array ( . . . )
19.3.16 Float32Array ( . . . )
19.3.17 Float64Array ( . . . )
19.3.18 Function ( . . . )
19.3.19 Int8Array ( . . . )
19.3.20 Int16Array ( . . . )
19.3.21 Int32Array ( . . . )
19.3.22 Iterator ( . . . )
19.3.23 Map ( . . . )
19.3.24 Number ( . . . )
19.3.25 Object ( . . . )
19.3.26 Promise ( . . . )
19.3.27 Proxy ( . . . )
19.3.28 RangeError ( . . . )
19.3.29 ReferenceError ( . . . )
19.3.30 RegExp ( . . . )
19.3.31 Set ( . . . )
19.3.32 SharedArrayBuffer ( . . . )
19.3.33 String ( . . . )
19.3.34 SuppressedError ( . . . )
19.3.35 Symbol ( . . . )
19.3.36 SyntaxError ( . . . )
19.3.37 TypeError ( . . . )
19.3.38 Uint8Array ( . . . )
19.3.39 Uint8ClampedArray ( . . . )
19.3.40 Uint16Array ( . . . )
19.3.41 Uint32Array ( . . . )
19.3.42 URIError ( . . . )
19.3.43 WeakMap ( . . . )
19.3.44 WeakRef ( . . . )
19.3.45 WeakSet ( . . . )
19.4 Other Properties of the Global Object
19.4.1 Atomics
19.4.2 JSON
19.4.3 Math
19.4.4 Reflect
20 Fundamental Objects
20.1 Object Objects
20.1.1 The Object Constructor
Object
- %Object%です。
global object の"Object" propertyのinitial valueです。constructor として呼び出されたとき、新しいordinary object を作成します。constructor としてではなくfunctionとして呼び出されたとき、type conversionを実行します。- class definitionの
extendsclauseのvalueとして使用できます。
20.1.1.1 Object ( value )
このfunctionは呼び出されたとき、次のstepsを実行します：
- NewTargetが
undefined でもactive function object でもないなら、- ?
OrdinaryCreateFromConstructor (NewTarget,"%Object.prototype%" )を返す。
- ?
- valueが
undefined またはnull のいずれかなら、OrdinaryObjectCreate (%Object.prototype% )を返す。 - !
ToObject (value)を返す。
20.1.2 Properties of the Object Constructor
Object
- valueが
%Function.prototype% である[[Prototype]] internal slotを持ちます。 - 次の追加propertiesを持ちます：
20.1.2.1 Object.assign ( target, ...sources )
このfunctionは、1つ以上のsource objectsからすべてのenumerable own propertiesのvaluesをtarget objectへcopyします。
これは呼び出されたとき、次のstepsを実行します：
このfunctionの
20.1.2.2 Object.create ( proto, properties )
このfunctionは、指定されたprototypeを持つ新しいobjectを作成します。
これは呼び出されたとき、次のstepsを実行します：
- protoがObjectでなく、かつprotoが
null でないなら、TypeError 例外をthrowする。 - objを
OrdinaryObjectCreate (proto)とする。 - propertiesが
undefined でないなら、- ?
ObjectDefineProperties (obj, properties)を返す。
- ?
- objを返す。
20.1.2.3 Object.defineProperties ( obj, properties )
このfunctionは、objectのown propertiesを追加し、かつ／または既存のown propertiesのattributesをupdateします。
これは呼び出されたとき、次のstepsを実行します：
- objがObjectでないなら、
TypeError 例外をthrowする。 - ?
ObjectDefineProperties (obj, properties)を返す。
20.1.2.3.1 ObjectDefineProperties ( obj, properties )
The abstract operation ObjectDefineProperties takes arguments obj (an Object) and properties (an ECMAScript language value) and returns either a
- propertiesを ?
ToObject (properties) に設定する。 - keysを ? properties.[[OwnPropertyKeys]]() とする。
- propertyDescsを新しい空の
List とする。 - keysの各要素nextKeyについて、以下を行う
- currentPropertyDescを ? properties.[[GetOwnProperty]](nextKey) とする。
- currentPropertyDescが
undefined でなく、currentPropertyDesc.[[Enumerable]]がtrue なら、- propertyDescObjを ?
Get (properties, nextKey) とする。 - propertyDescを ?
ToPropertyDescriptor (propertyDescObj) とする。 Record { [[Key]]: nextKey, [[Descriptor]]: propertyDesc }をpropertyDescsへappendする。
- propertyDescObjを ?
- propertyDescsの各要素propertyについて、以下を行う
- ?
DefinePropertyOrThrow (obj, property.[[Key]], property.[[Descriptor]])を実行する。
- ?
- objを返す。
20.1.2.4 Object.defineProperty ( obj, key, attrs )
このfunctionは、objectのown propertyを追加し、かつ／または既存のown propertyのattributesをupdateします。
これは呼び出されたとき、次のstepsを実行します：
- objがObjectでないなら、
TypeError 例外をthrowする。 - propertyKeyを ?
ToPropertyKey (key) とする。 - propertyDescを ?
ToPropertyDescriptor (attrs) とする。 - ?
DefinePropertyOrThrow (obj, propertyKey, propertyDesc)を実行する。 - objを返す。
20.1.2.5 Object.entries ( obj )
このfunctionは呼び出されたとき、次のstepsを実行します：
- coercedを ?
ToObject (obj) とする。 - entryListを ?
EnumerableOwnProperties (coerced,key+value ) とする。 CreateArrayFromList (entryList)を返す。
20.1.2.6 Object.freeze ( obj )
このfunctionは呼び出されたとき、次のstepsを実行します：
- objがObjectでないなら、objを返す。
- statusを ?
SetIntegrityLevel (obj,frozen ) とする。 - statusが
false なら、TypeError 例外をthrowする。 - objを返す。
20.1.2.7 Object.fromEntries ( iterable )
このfunctionは呼び出されたとき、次のstepsを実行します：
- ?
RequireObjectCoercible (iterable)を実行する。 - objを
OrdinaryObjectCreate (%Object.prototype% )とする。 Assert : objはown propertiesを持たないextensibleordinary object である。- objをcaptureし、呼び出されたとき次のstepsを実行する、parameters (key, value)を持つ新しい
Abstract Closure closureとする：- propertyKeyを ?
ToPropertyKey (key) とする。 - !
CreateDataPropertyOrThrow (obj, propertyKey, value)を実行する。 NormalCompletion (undefined )を返す。
- propertyKeyを ?
- adderを
CreateBuiltinFunction (closure, 2,"" , « »)とする。 - ?
AddEntriesFromIterable (obj, iterable, adder)を返す。
20.1.2.8 Object.getOwnPropertyDescriptor ( obj, key )
このfunctionは呼び出されたとき、次のstepsを実行します：
- coercedを ?
ToObject (obj) とする。 - propertyKeyを ?
ToPropertyKey (key) とする。 - propertyDescを ? coerced.[[GetOwnProperty]](propertyKey) とする。
FromPropertyDescriptor (propertyDesc)を返す。
20.1.2.9 Object.getOwnPropertyDescriptors ( obj )
このfunctionは呼び出されたとき、次のstepsを実行します：
- coercedを ?
ToObject (obj) とする。 - ownKeysを ? coerced.[[OwnPropertyKeys]]() とする。
- descsを
OrdinaryObjectCreate (%Object.prototype% )とする。 - ownKeysの各要素keyについて、以下を行う
- propertyDescを ? coerced.[[GetOwnProperty]](key) とする。
- propertyDescObjを
FromPropertyDescriptor (propertyDesc)とする。 - propertyDescObjが
undefined でないなら、!CreateDataPropertyOrThrow (descs, key, propertyDescObj)を実行する。
- descsを返す。
20.1.2.10 Object.getOwnPropertyNames ( obj )
このfunctionは呼び出されたとき、次のstepsを実行します：
CreateArrayFromList (?GetOwnPropertyKeys (obj,string ))を返す。
20.1.2.11 Object.getOwnPropertySymbols ( obj )
このfunctionは呼び出されたとき、次のstepsを実行します：
CreateArrayFromList (?GetOwnPropertyKeys (obj,symbol ))を返す。
20.1.2.11.1 GetOwnPropertyKeys ( value, type )
The abstract operation GetOwnPropertyKeys takes arguments value (an ECMAScript language value) and type (
20.1.2.12 Object.getPrototypeOf ( obj )
このfunctionは呼び出されたとき、次のstepsを実行します：
- coercedを ?
ToObject (obj) とする。 - ? coerced.[[GetPrototypeOf]]()を返す。
20.1.2.13 Object.groupBy ( items, callback )
callbackは2つのargumentsをacceptするfunctionであるべきです。groupByはitems内の各elementについてascending orderでcallbackを1回呼び出し、新しいobjectをconstructします。callbackによって返される各valueは
callbackは2つのarguments、すなわちelementのvalueとelementのindexを伴って呼び出されます。
groupByのreturn valueは
このfunctionは呼び出されたとき、次のstepsを実行します：
- ?
GroupBy (items, callback,property )をgroupsとする。 OrdinaryObjectCreate (null )をobjとする。- groupsの各
Record { [[Key]], [[Elements]] } groupについて、次を行う。CreateArrayFromList (group.[[Elements]])をelementsとする。- !
CreateDataPropertyOrThrow (obj, group.[[Key]], elements)を実行する。
- objを返す。
20.1.2.14 Object.hasOwn ( obj, key )
このfunctionは呼び出されたとき、次のstepsを実行します：
- coercedを ?
ToObject (obj) とする。 - propertyKeyを ?
ToPropertyKey (key) とする。 - ?
HasOwnProperty (coerced, propertyKey)を返す。
20.1.2.15 Object.is ( value1, value2 )
このfunctionは呼び出されたとき、次のstepsを実行します：
SameValue (value1, value2)を返す。
20.1.2.16 Object.isExtensible ( obj )
このfunctionは呼び出されたとき、次のstepsを実行します：
- objがObjectでないなら、
false を返す。 - ?
IsExtensible (obj)を返す。
20.1.2.17 Object.isFrozen ( obj )
このfunctionは呼び出されたとき、次のstepsを実行します：
- objがObjectでないなら、
true を返す。 - ?
TestIntegrityLevel (obj,frozen )を返す。
20.1.2.18 Object.isSealed ( obj )
このfunctionは呼び出されたとき、次のstepsを実行します：
- objがObjectでないなら、
true を返す。 - ?
TestIntegrityLevel (obj,sealed )を返す。
20.1.2.19 Object.keys ( obj )
このfunctionは呼び出されたとき、次のstepsを実行します：
- coercedを ?
ToObject (obj) とする。 - keyListを ?
EnumerableOwnProperties (coerced,key ) とする。 CreateArrayFromList (keyList)を返す。
20.1.2.20 Object.preventExtensions ( obj )
このfunctionは呼び出されたとき、次のstepsを実行します：
- objがObjectでないなら、objを返す。
- statusを ? obj.[[PreventExtensions]]() とする。
- statusが
false なら、TypeError 例外をthrowする。 - objを返す。
20.1.2.21 Object.prototype
Object.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
20.1.2.22 Object.seal ( obj )
このfunctionは呼び出されたとき、次のstepsを実行します：
- objがObjectでないなら、objを返す。
- statusを ?
SetIntegrityLevel (obj,sealed ) とする。 - statusが
false なら、TypeError 例外をthrowする。 - objを返す。
20.1.2.23 Object.setPrototypeOf ( obj, proto )
このfunctionは呼び出されたとき、次のstepsを実行します：
- ?
RequireObjectCoercible (obj)を実行する。 - protoがObjectでなく、かつprotoが
null でないなら、TypeError 例外をthrowする。 - objがObjectでないなら、objを返す。
- statusを ? obj.[[SetPrototypeOf]](proto) とする。
- statusが
false なら、TypeError 例外をthrowする。 - objを返す。
20.1.2.24 Object.values ( obj )
このfunctionは呼び出されたとき、次のstepsを実行します：
- coercedを ?
ToObject (obj) とする。 - valueListを ?
EnumerableOwnProperties (coerced,value ) とする。 CreateArrayFromList (valueList)を返す。
20.1.3 Properties of the Object Prototype Object
Object prototype objectは：
- %Object.prototype%です。
- valueが
true である[[Extensible]] internal slotを持ちます。 ordinary objects のために定義されるinternal methodsを持ちます。ただし[[SetPrototypeOf]] methodは例外で、10.4.7.1 で定義される通りです。（したがって、これはimmutable prototype exotic object です。）- valueが
null である[[Prototype]] internal slotを持ちます。
20.1.3.1 Object.prototype.constructor
Object.prototype.constructorのinitial valueは
20.1.3.2 Object.prototype.hasOwnProperty ( value )
このmethodは呼び出されたとき、次のstepsを実行します：
- propertyKeyを ?
ToPropertyKey (value) とする。 - objを ?
ToObject (this value) とする。 - ?
HasOwnProperty (obj, propertyKey)を返す。
20.1.3.3 Object.prototype.isPrototypeOf ( value )
このmethodは呼び出されたとき、次のstepsを実行します：
20.1.3.4 Object.prototype.propertyIsEnumerable ( value )
このmethodは呼び出されたとき、次のstepsを実行します：
- propertyKeyを ?
ToPropertyKey (value) とする。 - objを ?
ToObject (this value) とする。 - propertyDescを ? obj.[[GetOwnProperty]](propertyKey) とする。
- propertyDescが
undefined なら、false を返す。 - propertyDesc.[[Enumerable]]を返す。
このmethodはprototype chain内のobjectsを考慮しません。
20.1.3.5 Object.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
このmethodは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
Invoke (thisValue,"toString" )を返す。
このmethodのoptional parametersは使用されませんが、ECMA-402 toLocaleString methodsによって使用されるparameter patternに対応することを意図しています。ECMA-402 supportを含まないimplementationsは、これらのparameter positionsを他のpurposesのために使用してはなりません。
このmethodは、locale-sensitiveなtoString behaviourを持たないobjectsに対してgenericなtoLocaleString implementationを提供します。Array、Number、Date、およびtoLocaleString methodsを提供します。
ECMA-402は意図的に、このdefault implementationのalternativeを提供していません。
20.1.3.6 Object.prototype.toString ( )
このmethodは呼び出されたとき、次のstepsを実行します：
this valueがundefined なら、"[object Undefined]" を返す。this valueがnull なら、"[object Null]" を返す。- objを !
ToObject (this value) とする。 - isArrayを ?
IsArray (obj) とする。 - isArrayが
true なら、builtinTagを"Array" とする。 - そうでなく、objが[[ParameterMap]] internal slotを持つなら、builtinTagを
"Arguments" とする。 - そうでなく、objが[[Call]] internal methodを持つなら、builtinTagを
"Function" とする。 - そうでなく、objが[[ErrorData]] internal slotを持つなら、builtinTagを
"Error" とする。 - そうでなく、objが[[BooleanData]] internal slotを持つなら、builtinTagを
"Boolean" とする。 - そうでなく、objが[[NumberData]] internal slotを持つなら、builtinTagを
"Number" とする。 - そうでなく、objが[[StringData]] internal slotを持つなら、builtinTagを
"String" とする。 - そうでなく、objが[[DateValue]] internal slotを持つなら、builtinTagを
"Date" とする。 - そうでなく、objが[[RegExpMatcher]] internal slotを持つなら、builtinTagを
"RegExp" とする。 - そうでなければ、builtinTagを
"Object" とする。 - tagを ?
Get (obj,%Symbol.toStringTag% ) とする。 - tagがStringでないなら、tagをbuiltinTagに設定する。
"[object " 、tag、および"]" のstring-concatenation を返す。
Historically、このmethodは、この仕様のprevious editionsでさまざまなbuilt-in objectsのnominal type tagとして使用されていた[[Class]] internal slotのString valueにaccessするために時々使用されていました。上記のtoStringのdefinitionは、toStringをそれら特定の種類のbuilt-in objectsに対するtestとして使用するlegacy codeとのcompatibilityをpreserveします。これは他の種類のbuilt-inまたはprogram defined objectsに対するreliable type testing mechanismを提供しません。加えて、programsは、そのようなlegacy type testsのreliabilityを無効にする方法で
20.1.3.7 Object.prototype.valueOf ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- ?
ToObject (this value)を返す。
20.1.3.8 Object.prototype.__proto__
Object.prototype.__proto__はattributes { [[Enumerable]]:
20.1.3.8.1 get Object.prototype.__proto__
[[Get]] attributeのvalueは、argumentsを要求しないbuilt-in functionです。これは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - ? obj.[[GetPrototypeOf]]()を返す。
20.1.3.8.2 set Object.prototype.__proto__
[[Set]] attributeのvalueは、argument protoを取るbuilt-in functionです。これは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - protoがObjectでなく、かつprotoが
null でないなら、undefined を返す。 - thisValueがObjectでないなら、
undefined を返す。 - statusを ? thisValue.[[SetPrototypeOf]](proto) とする。
- statusが
false なら、TypeError 例外をthrowする。 undefined を返す。
20.1.3.9 Legacy Object.prototype Accessor Methods
20.1.3.9.1 Object.prototype.__defineGetter__ ( key, getter )
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 IsCallable (getter)がfalse なら、TypeError 例外をthrowする。- propertyDescをPropertyDescriptor { [[Get]]: getter, [[Enumerable]]:
true , [[Configurable]]:true }とする。 - propertyKeyを ?
ToPropertyKey (key) とする。 - ?
DefinePropertyOrThrow (obj, propertyKey, propertyDesc)を実行する。 undefined を返す。
20.1.3.9.2 Object.prototype.__defineSetter__ ( key, setter )
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 IsCallable (setter)がfalse なら、TypeError 例外をthrowする。- propertyDescをPropertyDescriptor { [[Set]]: setter, [[Enumerable]]:
true , [[Configurable]]:true }とする。 - propertyKeyを ?
ToPropertyKey (key) とする。 - ?
DefinePropertyOrThrow (obj, propertyKey, propertyDesc)を実行する。 undefined を返す。
20.1.3.9.3 Object.prototype.__lookupGetter__ ( key )
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - propertyKeyを ?
ToPropertyKey (key) とする。 - 繰り返す
- propertyDescを ? obj.[[GetOwnProperty]](propertyKey) とする。
- propertyDescが
undefined でないなら、IsAccessorDescriptor (propertyDesc)がtrue なら、propertyDesc.[[Get]]を返す。undefined を返す。
- objを ? obj.[[GetPrototypeOf]]() に設定する。
- objが
null なら、undefined を返す。
20.1.3.9.4 Object.prototype.__lookupSetter__ ( key )
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - propertyKeyを ?
ToPropertyKey (key) とする。 - 繰り返す
- propertyDescを ? obj.[[GetOwnProperty]](propertyKey) とする。
- propertyDescが
undefined でないなら、IsAccessorDescriptor (propertyDesc)がtrue なら、propertyDesc.[[Set]]を返す。undefined を返す。
- objを ? obj.[[GetPrototypeOf]]() に設定する。
- objが
null なら、undefined を返す。
20.1.4 Properties of Object Instances
Object instancesは、
20.2 Function Objects
20.2.1 The Function Constructor
Function
- %Function%です。
global object の"Function" propertyのinitial valueです。constructor としてではなくfunctionとして呼び出されたとき、新しいfunction object を作成およびinitializeします。したがってfunction callFunction(…)は、同じargumentsを伴うobject creation expressionnew Function(…)と同等です。- class definitionの
extendsclauseのvalueとして使用できます。指定されたFunction behaviourをinheritしようとするsubclassconstructors は、built-in function behaviourに必要なinternal slotsを持つsubclass instanceを作成およびinitializeするために、Functionconstructor へのsupercallを含まなければなりません。function objects を定義するすべてのECMAScript syntactic formsはFunctionのinstancesを作成します。built-in GeneratorFunction、AsyncFunction、およびAsyncGeneratorFunction subclassesを除き、Function subclassesのinstancesを作成するsyntactic meansはありません。
20.2.1.1 Function ( ...paramArgs, bodyArg )
最後のargument（ある場合）はfunctionのbody（executable code）を指定します；それより前のargumentsはformal parametersを指定します。
このfunctionは呼び出されたとき、次のstepsを実行します：
- ctorを
active function object とする。 - bodyArgが存在しないなら、bodyArgをempty Stringに設定する。
- ?
CreateDynamicFunction (ctor, NewTarget,normal , paramArgs, bodyArg)を返す。
指定される各formal parameterごとに1つのargumentを持つことは許されますが、必要ではありません。例えば、次の3つのexpressionsはすべて同じresultをproduceします：
new Function("a", "b", "c", "return a+b+c")
new Function("a, b, c", "return a+b+c")
new Function("a,b", "c", "return a+b+c")20.2.1.1.1 CreateDynamicFunction ( ctor, newTarget, kind, paramArgs, bodyArg )
The abstract operation CreateDynamicFunction takes arguments ctor (a newがinitiallyに適用された
- newTargetが
undefined なら、newTargetをctorに設定する。 - kindが
normal なら、- prefixを
"function" とする。 - exprGrammarをgrammar symbol
FunctionExpression とする。 - bodyGrammarをgrammar symbol
FunctionBody とする。[~Yield, ~Await] - paramGrammarをgrammar symbol
FormalParameters とする。[~Yield, ~Await] - fallbackProtoを
"%Function.prototype%" とする。
- prefixを
- そうでなく、kindが
generator なら、- prefixを
"function*" とする。 - exprGrammarをgrammar symbol
GeneratorExpression とする。 - bodyGrammarをgrammar symbol
GeneratorBody とする。 - paramGrammarをgrammar symbol
FormalParameters とする。[+Yield, ~Await] - fallbackProtoを
"%GeneratorFunction.prototype%" とする。
- prefixを
- そうでなく、kindが
async なら、- prefixを
"async function" とする。 - exprGrammarをgrammar symbol
AsyncFunctionExpression とする。 - bodyGrammarをgrammar symbol
AsyncFunctionBody とする。 - paramGrammarをgrammar symbol
FormalParameters とする。[~Yield, +Await] - fallbackProtoを
"%AsyncFunction.prototype%" とする。
- prefixを
- そうでなければ、
Assert : kindはasync-generator である。- prefixを
"async function*" とする。 - exprGrammarをgrammar symbol
AsyncGeneratorExpression とする。 - bodyGrammarをgrammar symbol
AsyncGeneratorBody とする。 - paramGrammarをgrammar symbol
FormalParameters とする。[+Yield, +Await] - fallbackProtoを
"%AsyncGeneratorFunction.prototype%" とする。
- argCountをparamArgs内の要素数とする。
- paramStringsを新しい空の
List とする。 - paramArgsの各要素argについて、以下を行う
- ?
ToString (arg)をparamStringsへappendする。
- ?
- bodyStringを ?
ToString (bodyArg) とする。 - currentRealmを
current Realm Record とする。 - ?
HostEnsureCanCompileStrings (currentRealm, paramStrings, bodyString,false )を実行する。 - paramStringをempty Stringとする。
- argCount > 0なら、
- paramStringをparamStrings[0]に設定する。
- kを1とする。
- k < argCountの間、繰り返す
- nextArgStringをparamStrings[k]とする。
- paramStringをparamString、
"," （comma）、およびnextArgStringのstring-concatenation に設定する。 - kをk + 1に設定する。
- bodyParseStringを0x000A (LINE FEED)、bodyString、および0x000A (LINE FEED)の
string-concatenation とする。 - sourceStringをprefix、
" anonymous(" 、paramString、0x000A (LINE FEED)、") {" 、bodyParseString、および"}" のstring-concatenation とする。 - sourceTextを
StringToCodePoints (sourceString)とする。 - paramsを
ParseText (paramString, paramGrammar)とする。 - paramsがerrorsの
List なら、SyntaxError 例外をthrowする。 - bodyを
ParseText (bodyParseString, bodyGrammar)とする。 - bodyがerrorsの
List なら、SyntaxError 例外をthrowする。 NOTE : parametersとbodyは、それぞれが単独でvalidであることを保証するためにseparatelyにparsedされる。例えば、new Function("/*", "*/ ) {")はfunctionへevaluateされない。NOTE : このstepに到達した場合、sourceTextはexprGrammarのsyntaxを持っていなければならない（ただしそのreverse implicationは成り立たない）。次の2つのstepsの目的は、exprGrammarにdirectlyにapplyされる任意のEarly Error rulesをenforceすることである。- exprを
ParseText (sourceText, exprGrammar)とする。 - exprがerrorsの
List なら、SyntaxError 例外をthrowする。 - funcProtoを ?
GetPrototypeFromConstructor (newTarget, fallbackProto) とする。 - envRecordをcurrentRealm.[[GlobalEnv]]とする。
- privateEnvを
null とする。 - funcを
OrdinaryFunctionCreate (funcProto, sourceText, params, body,non-lexical-this , envRecord, privateEnv)とする。 SetFunctionName (func,"anonymous" )を実行する。- kindが
generator なら、- protoProtoを
OrdinaryObjectCreate (%GeneratorPrototype% )とする。 - !
DefinePropertyOrThrow (func,"prototype" , PropertyDescriptor { [[Value]]: protoProto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })を実行する。
- protoProtoを
- そうでなく、kindが
async-generator なら、- protoProtoを
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )とする。 - !
DefinePropertyOrThrow (func,"prototype" , PropertyDescriptor { [[Value]]: protoProto, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })を実行する。
- protoProtoを
- そうでなく、kindが
normal なら、MakeConstructor (func)を実行する。
NOTE : kindがasync であるfunctionsはconstructableではなく、[[Construct]] internal methodまたは"prototype" propertyを持たない。- funcを返す。
CreateDynamicFunctionは、そのkindが
20.2.2 Properties of the Function Constructor
Function
- それ自体がbuilt-in
function object です。 - valueが
%Function.prototype% である[[Prototype]] internal slotを持ちます。 - valueが
1 𝔽である"length" propertyを持ちます。 - 次のpropertiesを持ちます：
20.2.2.1 Function.prototype
Function.prototypeのvalueは
このpropertyはattributes { [[Writable]]:
20.2.3 Properties of the Function Prototype Object
Function prototype objectは：
- %Function.prototype%です。
- それ自体がbuilt-in
function object です。 - 任意のargumentsをacceptし、invokedされたとき
undefined を返します。 - [[Construct]] internal methodを持ちません；
newoperatorを伴うconstructor として使用できません。 - valueが
%Object.prototype% である[[Prototype]] internal slotを持ちます。 "prototype" propertyを持ちません。- valueが
+0 𝔽である"length" propertyを持ちます。 - valueがempty Stringである
"name" propertyを持ちます。
Function prototype objectは、ECMAScript 2015 specificationより前に作成されたECMAScript codeとのcompatibilityを保証するため、
20.2.3.1 Function.prototype.apply ( thisArg, argArray )
このmethodは呼び出されたとき、次のstepsを実行します：
- funcを
this valueとする。 IsCallable (func)がfalse なら、TypeError 例外をthrowする。- argArrayが
undefined またはnull のいずれかなら、PrepareForTailCall ()を実行する。- ?
Call (func, thisArg)を返す。
- argListを ?
CreateListFromArrayLike (argArray) とする。 PrepareForTailCall ()を実行する。- ?
Call (func, thisArg, argList)を返す。
thisArg valueは、modificationなしで
funcがarrow functionまたは
20.2.3.2 Function.prototype.bind ( thisArg, ...args )
このmethodは呼び出されたとき、次のstepsを実行します：
- targetを
this valueとする。 IsCallable (target)がfalse なら、TypeError 例外をthrowする。- boundFuncを ?
BoundFunctionCreate (target, thisArg, args) とする。 - lengthを0とする。
- targetHasLengthを ?
HasOwnProperty (target,"length" ) とする。 - targetHasLengthが
true なら、- targetLengthを ?
Get (target,"length" ) とする。 - targetLengthがNumberなら、
- targetLengthが
+∞ 𝔽なら、- lengthを+∞に設定する。
- そうでなく、targetLengthが
-∞ 𝔽なら、- lengthを0に設定する。
- そうでなければ、
- targetLengthAsIntを !
ToIntegerOrInfinity (targetLength) とする。 Assert : targetLengthAsIntはfinite である。- argCountをargs内の要素数とする。
- lengthを
max (targetLengthAsInt - argCount, 0)に設定する。
- targetLengthAsIntを !
- targetLengthが
- targetLengthを ?
SetFunctionLength (boundFunc, length)を実行する。- targetNameを ?
Get (target,"name" ) とする。 - targetNameがStringでないなら、targetNameをempty Stringに設定する。
SetFunctionName (boundFunc, targetName,"bound" )を実行する。- boundFuncを返す。
Function.prototype.bindを使用して作成された
targetがarrow functionまたは
20.2.3.3 Function.prototype.call ( thisArg, ...args )
このmethodは呼び出されたとき、次のstepsを実行します：
- funcを
this valueとする。 IsCallable (func)がfalse なら、TypeError 例外をthrowする。PrepareForTailCall ()を実行する。- ?
Call (func, thisArg, args)を返す。
thisArg valueは、modificationなしで
funcがarrow functionまたは
20.2.3.4 Function.prototype.constructor
Function.prototype.constructorのinitial valueは
20.2.3.5 Function.prototype.toString ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- funcを
this valueとする。 - funcがObjectであり、funcが[[SourceText]] internal slotを持ち、func.[[SourceText]]がUnicode code pointsのsequenceであり、かつ
HostHasSourceTextAvailable (func)がtrue なら、CodePointsToString (func.[[SourceText]])を返す。
- funcが
built-in function object なら、funcのimplementation-defined String source code representationを返す。そのrepresentationはNativeFunction のsyntaxを持たなければなりません。加えて、funcが[[InitialName]] internal slotを持ち、func.[[InitialName]]がStringである場合、NativeFunctionAccessor opt PropertyName にmatchするreturned Stringのportionはfunc.[[InitialName]]でなければなりません。 - funcがObjectであり、
IsCallable (func)がtrue なら、funcのimplementation-defined String source code representationを返す。そのrepresentationはNativeFunction のsyntaxを持たなければなりません。 TypeError 例外をThrowする。
20.2.3.6 Function.prototype [ %Symbol.hasInstance% ] ( value )
このmethodは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
OrdinaryHasInstance (thisValue, value)を返す。
このpropertyはattributes { [[Writable]]:
これは、ほとんどのfunctionsがinheritする%Symbol.hasInstance%のdefault implementationです。%Symbol.hasInstance%は、valueがspecific instanceof operatorによって呼び出されます。次のようなexpressionは、
v instanceof F次のようにevaluatesされます
F[%Symbol.hasInstance%](v)%Symbol.hasInstance% methodをexposeすることによって、instanceofによってどのobjectsがそのinstancesとしてrecognizedされるかをcontrolできます。
このpropertyは、bound functionのtarget functionをgloballyにexposeするために使用され得るtamperingを防ぐため、non-writableかつnon-configurableです。
このmethodの
20.2.4 Function Instances
すべてのFunction instanceはECMAScript Function.prototype.bind method（
Function instancesは次のpropertiesを持ちます：
20.2.4.1 length
20.2.4.2 name
この仕様によってcontextual nameが関連付けられていないAnonymous
20.2.4.3 prototype
このpropertyはattributes { [[Writable]]:
Function.prototype.bindを使用して作成された
20.2.5 HostHasSourceTextAvailable ( func )
The
HostHasSourceTextAvailableのimplementationは、次のrequirementsにconformしなければなりません：
- これはそのparametersに関してdeterministicでなければなりません。specific funcをargumentとして呼び出されるたびに、同じresultを返さなければなりません。
HostHasSourceTextAvailableのdefault implementationは
20.3 Boolean Objects
20.3.1 The Boolean Constructor
Boolean
- %Boolean%です。
global object の"Boolean" propertyのinitial valueです。constructor として呼び出されたとき、新しいBoolean objectを作成およびinitializeします。constructor としてではなくfunctionとして呼び出されたとき、type conversionを実行します。- class definitionの
extendsclauseのvalueとして使用できます。指定されたBoolean behaviourをinheritしようとするsubclassconstructors は、[[BooleanData]] internal slotを持つsubclass instanceを作成およびinitializeするために、Booleanconstructor へのsupercallを含まなければなりません。
20.3.1.1 Boolean ( value )
このfunctionは呼び出されたとき、次のstepsを実行します：
- boolを
ToBoolean (value)とする。 - NewTargetが
undefined なら、boolを返す。 - objを ?
OrdinaryCreateFromConstructor (NewTarget,"%Boolean.prototype%" , « [[BooleanData]] ») とする。 - obj.[[BooleanData]]をboolに設定する。
- objを返す。
20.3.2 Properties of the Boolean Constructor
Boolean
- valueが
%Function.prototype% である[[Prototype]] internal slotを持ちます。 - 次のpropertiesを持ちます：
20.3.2.1 Boolean.prototype
Boolean.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
20.3.3 Properties of the Boolean Prototype Object
Boolean prototype objectは：
- %Boolean.prototype%です。
ordinary object です。- それ自体がBoolean objectです；valueが
false である[[BooleanData]] internal slotを持ちます。 - valueが
%Object.prototype% である[[Prototype]] internal slotを持ちます。
20.3.3.1 Boolean.prototype.constructor
Boolean.prototype.constructorのinitial valueは
20.3.3.2 Boolean.prototype.toString ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- boolを ?
ThisBooleanValue (this value) とする。 - boolが
true なら、"true" を返す。 "false" を返す。
20.3.3.3 Boolean.prototype.valueOf ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- ?
ThisBooleanValue (this value)を返す。
20.3.3.3.1 ThisBooleanValue ( arg )
The abstract operation ThisBooleanValue takes argument arg (an ECMAScript language value) and returns either a
- argがBooleanなら、argを返す。
- argがObjectであり、argが[[BooleanData]] internal slotを持つなら、
- boolをarg.[[BooleanData]]とする。
Assert : boolはBooleanである。- boolを返す。
TypeError 例外をThrowする。
20.3.4 Properties of Boolean Instances
Boolean instancesは、
20.4 Symbol Objects
20.4.1 The Symbol Constructor
Symbol
- %Symbol%です。
global object の"Symbol" propertyのinitial valueです。- functionとして呼び出されたとき、新しいSymbol valueを返します。
newoperatorとともに使用されることを意図していません。- subclassedされることを意図していません。
- class definitionの
extendsclauseのvalueとして使用できますが、それへのsupercallはexceptionを引き起こします。
20.4.1.1 Symbol ( [ description ] )
このfunctionは呼び出されたとき、次のstepsを実行します：
- NewTargetが
undefined でないなら、TypeError 例外をthrowする。 - descriptionが
undefined なら、descStringをundefined とする。 - そうでなければ、descStringを ?
ToString (description) とする。 - ... [[Description]]がdescStringである新しいSymbolを返す。
20.4.2 Properties of the Symbol Constructor
Symbol
- valueが
%Function.prototype% である[[Prototype]] internal slotを持ちます。 - 次のpropertiesを持ちます：
20.4.2.1 Symbol.asyncIterator
Symbol.asyncIteratorのinitial valueはwell-known symbol
このpropertyはattributes { [[Writable]]:
20.4.2.2 Symbol.for ( key )
このfunctionは呼び出されたとき、次のstepsを実行します：
- stringKey を ?
ToString (key) とする。 - agentRecord を周囲のエージェントの
Agent Record とする。 - globalSymbolRegistry を agentRecord.[[GlobalSymbolRegistry]] とする。
- globalSymbolRegistry の各要素 element について、次を行う。
- element.[[Key]] が stringKey である場合、element.[[Symbol]] を返す。
Assert : globalSymbolRegistry は現在、stringKey に対するエントリーを含んでいない。- newSymbol を、[[Description]] が stringKey である新しい Symbol とする。
GlobalSymbolRegistry Record { [[Key]]: stringKey, [[Symbol]]: newSymbol } を globalSymbolRegistry に追加する。- newSymbol を返す。
20.4.2.3 Symbol.hasInstance
Symbol.hasInstanceのinitial valueはwell-known symbol
このpropertyはattributes { [[Writable]]:
20.4.2.4 Symbol.isConcatSpreadable
Symbol.isConcatSpreadableのinitial valueはwell-known symbol
このpropertyはattributes { [[Writable]]:
20.4.2.5 Symbol.iterator
Symbol.iteratorのinitial valueはwell-known symbol
このpropertyはattributes { [[Writable]]:
20.4.2.6 Symbol.keyFor ( symbol )
このfunctionは呼び出されたとき、次のstepsを実行します：
- symbolがSymbolでないなら、
TypeError 例外をthrowする。 KeyForSymbol (symbol)を返す。
20.4.2.7 Symbol.match
Symbol.matchのinitial valueはwell-known symbol
このpropertyはattributes { [[Writable]]:
20.4.2.8 Symbol.matchAll
Symbol.matchAllのinitial valueはwell-known symbol
このpropertyはattributes { [[Writable]]:
20.4.2.9 Symbol.prototype
Symbol.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
20.4.2.10 Symbol.replace
Symbol.replaceのinitial valueはwell-known symbol
このpropertyはattributes { [[Writable]]:
20.4.2.11 Symbol.search
Symbol.searchのinitial valueはwell-known symbol
このpropertyはattributes { [[Writable]]:
20.4.2.12 Symbol.species
Symbol.speciesのinitial valueはwell-known symbol
このpropertyはattributes { [[Writable]]:
20.4.2.13 Symbol.split
Symbol.splitのinitial valueはwell-known symbol
このpropertyはattributes { [[Writable]]:
20.4.2.14 Symbol.toPrimitive
Symbol.toPrimitiveのinitial valueはwell-known symbol
このpropertyはattributes { [[Writable]]:
20.4.2.15 Symbol.toStringTag
Symbol.toStringTagのinitial valueはwell-known symbol
このpropertyはattributes { [[Writable]]:
20.4.2.16 Symbol.unscopables
Symbol.unscopablesのinitial valueはwell-known symbol
このpropertyはattributes { [[Writable]]:
20.4.3 Properties of the Symbol Prototype Object
Symbol prototype objectは：
- %Symbol.prototype%です。
ordinary object です。- Symbol instanceではなく、[[SymbolData]] internal slotを持ちません。
- valueが
%Object.prototype% である[[Prototype]] internal slotを持ちます。
20.4.3.1 Symbol.prototype.constructor
Symbol.prototype.constructorのinitial valueは
20.4.3.2 get Symbol.prototype.description
Symbol.prototype.descriptionは、set accessor functionが
- symbolを ?
ThisSymbolValue (this value) とする。 - symbol.[[Description]]を返す。
20.4.3.3 Symbol.prototype.toString ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- symbolを ?
ThisSymbolValue (this value) とする。 SymbolDescriptiveString (symbol)を返す。
20.4.3.3.1 SymbolDescriptiveString ( symbol )
The abstract operation SymbolDescriptiveString takes argument symbol (a Symbol) and returns a String. It performs the following steps when called:
- symbol.[[Description]]をdescriptionとする。
- descriptionが
undefined である場合、descriptionを空のStringに設定する。 Assert : descriptionはStringである。"Symbol(" 、description、および")" のstring-concatenation を返す。
20.4.3.4 Symbol.prototype.valueOf ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- ?
ThisSymbolValue (this value)を返す。
20.4.3.4.1 ThisSymbolValue ( arg )
The abstract operation ThisSymbolValue takes argument arg (an ECMAScript language value) and returns either a
- argがSymbolなら、argを返す。
- argがObjectであり、argが[[SymbolData]] internal slotを持つなら、
- symbolをarg.[[SymbolData]]とする。
Assert : symbolはSymbolである。- symbolを返す。
TypeError 例外をThrowする。
20.4.3.5 Symbol.prototype [ %Symbol.toPrimitive% ] ( hint )
このmethodは、Symbol objectをprimitive valueへconvertするためにECMAScript language operatorsによって呼び出されます。
これは呼び出されたとき、次のstepsを実行します：
- ?
ThisSymbolValue (this value)を返す。
argumentはignoredされます。
このpropertyはattributes { [[Writable]]:
このmethodの
20.4.3.6 Symbol.prototype [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
20.4.4 Properties of Symbol Instances
Symbol instancesは、
20.4.5 Abstract Operations for Symbols
20.4.5.1 GlobalSymbolRegistry Records
GlobalSymbolRegistry Record は、
GlobalSymbolRegistry Records は、
| フィールド名 | 値 | 用途 |
|---|---|---|
| [[Key]] | String | Symbol をグローバルに識別するために使用される文字列キー。 |
| [[Symbol]] | Symbol | 任意の |
20.4.5.2 KeyForSymbol ( symbol )
The abstract operation KeyForSymbol takes argument symbol (a Symbol) and returns a String or
- agentRecord を周囲のエージェントの
Agent Record とする。 - globalSymbolRegistry を agentRecord.[[GlobalSymbolRegistry]] とする。
- globalSymbolRegistry の各要素 element について、次を行う。
SameValue (element.[[Symbol]], symbol) がtrue である場合、element.[[Key]] を返す。
Assert : globalSymbolRegistry は現在、symbol に対するエントリーを含んでいない。undefined を返す。
20.5 Error Objects
runtime errorsが発生したとき、Error objectsのinstancesはexceptionsとしてthrownされます。Error objectsはuser-defined exception classesのbase objectsとしてもserveする場合があります。
ECMAScript 実装が実行時エラーを検出した場合、
20.5.1 The Error Constructor
Error
- %Error%です。
global object の"Error" propertyのinitial valueです。constructor としてではなくfunctionとして呼び出されたとき、新しいError objectを作成およびinitializeします。したがってfunction callError(…)は、同じargumentsを伴うobject creation expressionnew Error(…)と同等です。- class definitionの
extendsclauseのvalueとして使用できます。指定されたError behaviourをinheritしようとするsubclassconstructors は、[[ErrorData]] internal slotを持つsubclass instancesを作成およびinitializeするために、Errorconstructor へのsupercallを含まなければなりません。
20.5.1.1 Error ( message [ , options ] )
このfunctionは呼び出されたとき、次のstepsを実行します：
- NewTargetが
undefined なら、newTargetをactive function object とする；そうでなければ、newTargetをNewTargetとする。 - objを ?
OrdinaryCreateFromConstructor (newTarget,"%Error.prototype%" , « [[ErrorData]] ») とする。 - messageが
undefined でないなら、- messageStringを ?
ToString (message) とする。 CreateNonEnumerableDataPropertyOrThrow (obj,"message" , messageString)を実行する。
- messageStringを ?
- ?
InstallErrorCause (obj, options)を実行する。 - objを返す。
20.5.2 Properties of the Error Constructor
Error
- valueが
%Function.prototype% である[[Prototype]] internal slotを持ちます。 - 次のpropertiesを持ちます：
20.5.2.1 Error.isError ( arg )
このfunctionは呼び出されたとき、次のstepsを実行します：
- argがObjectでないなら、
false を返す。 - argが[[ErrorData]] internal slotを持たないなら、
false を返す。 true を返す。
20.5.2.2 Error.prototype
Error.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
20.5.3 Properties of the Error Prototype Object
Error prototype objectは：
- %Error.prototype%です。
ordinary object です。- Error instanceではなく、[[ErrorData]] internal slotを持ちません。
- valueが
%Object.prototype% である[[Prototype]] internal slotを持ちます。
20.5.3.1 Error.prototype.constructor
Error.prototype.constructorのinitial valueは
20.5.3.2 Error.prototype.message
Error.prototype.messageのinitial valueはempty Stringです。
20.5.3.3 Error.prototype.name
Error.prototype.nameのinitial valueは
20.5.3.4 Error.prototype.toString ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - objがObjectでないなら、
TypeError 例外をthrowする。 - nameを ?
Get (obj,"name" ) とする。 - nameが
undefined なら、nameを"Error" に設定する；そうでなければ、nameを ?ToString (name) に設定する。 - messageを ?
Get (obj,"message" ) とする。 - messageが
undefined なら、messageをempty Stringに設定する；そうでなければ、messageを ?ToString (message) に設定する。 - nameがempty Stringなら、messageを返す。
- messageがempty Stringなら、nameを返す。
- name、code unit 0x003A (COLON)、code unit 0x0020 (SPACE)、およびmessageの
string-concatenation を返す。
20.5.4 Properties of Error Instances
Error インスタンスは、Error プロトタイプオブジェクトからプロパティを継承し、値が Object.prototype.toString および Error.isError において、Error、AggregateError、SuppressedError、および NativeError インスタンスを Error オブジェクトとして識別することである。
20.5.5 Native Error Types Used in This Standard
実行時エラーが検出された場合、以下の NativeError オブジェクトのいずれか、または AggregateError オブジェクトもしくは SuppressedError オブジェクトの新しいインスタンスが投げられる。すべての NativeError オブジェクトは、
20.5.5.1 EvalError
EvalError
このexceptionは現在この仕様内では使用されていません。このobjectは、この仕様のprevious editionsとのcompatibilityのために残されています。
20.5.5.2 RangeError
RangeError
allowable valuesのsetまたはrange内にないvalueを示します。
20.5.5.3 ReferenceError
ReferenceError
invalid referenceがdetectedされたことを示します。
20.5.5.4 SyntaxError
SyntaxError
parsing errorが発生したことを示します。
20.5.5.5 TypeError
TypeError
TypeErrorは、他のNativeError objectsのいずれもfailure causeのappropriate indicationでない場合に、unsuccessful operationを示すために使用されます。
20.5.5.6 URIError
URIError
global URI handling functionsの1つが、そのdefinitionとincompatibleな方法で使用されたことを示します。
20.5.6 NativeError Object Structure
これらの各objectは、
各error objectについて、definition内のNativeErrorへのreferencesは、
20.5.6.1 The NativeError Constructors
各NativeError
constructor としてではなくfunctionとして呼び出されたとき、新しいNativeError objectを作成およびinitializeします。functionとしてのobjectのcallは、同じargumentsでconstructor として呼び出すことと同等です。したがってfunction callNativeError(…)は、同じargumentsを伴うobject creation expressionnew NativeError(…)と同等です。- class definitionの
extendsclauseのvalueとして使用できます。指定されたNativeError behaviourをinheritしようとするsubclassconstructors は、[[ErrorData]] internal slotを持つsubclass instancesを作成およびinitializeするために、NativeErrorconstructor へのsupercallを含まなければなりません。
20.5.6.1.1 NativeError ( message [ , options ] )
各NativeError functionは呼び出されたとき、次のstepsを実行します：
- NewTargetが
undefined なら、newTargetをactive function object とする；そうでなければ、newTargetをNewTargetとする。 - objを ?
OrdinaryCreateFromConstructor (newTarget,"%NativeError.prototype%" , « [[ErrorData]] ») とする。 - messageが
undefined でないなら、- messageStringを ?
ToString (message) とする。 CreateNonEnumerableDataPropertyOrThrow (obj,"message" , messageString)を実行する。
- messageStringを ?
- ?
InstallErrorCause (obj, options)を実行する。 - objを返す。
step
20.5.6.2 Properties of the NativeError Constructors
各NativeError
- valueが
%Error% である[[Prototype]] internal slotを持ちます。 - valueがString value
"NativeError" である"name" propertyを持ちます。 - 次のpropertiesを持ちます：
20.5.6.2.1 NativeError.prototype
NativeError.prototypeのinitial valueはNativeError prototype object（
このpropertyはattributes { [[Writable]]:
20.5.6.3 Properties of the NativeError Prototype Objects
各NativeError prototype objectは：
ordinary object です。- Error instanceではなく、[[ErrorData]] internal slotを持ちません。
- valueが
%Error.prototype% である[[Prototype]] internal slotを持ちます。
20.5.6.3.1 NativeError.prototype.constructor
与えられたNativeError
20.5.6.3.2 NativeError.prototype.message
与えられたNativeError
20.5.6.3.3 NativeError.prototype.name
与えられたNativeError
20.5.6.4 Properties of NativeError Instances
NativeError インスタンスは、自身の NativeError プロトタイプオブジェクトからプロパティを継承し、値が Object.prototype.toString（Error.isError（
20.5.7 AggregateError Objects
20.5.7.1 The AggregateError Constructor
AggregateError
- %AggregateError%です。
global object の"AggregateError" propertyのinitial valueです。constructor としてではなくfunctionとして呼び出されたとき、新しいAggregateError objectを作成およびinitializeします。したがってfunction callAggregateError(…)は、同じargumentsを伴うobject creation expressionnew AggregateError(…)と同等です。- class definitionの
extendsclauseのvalueとして使用できます。指定されたAggregateError behaviourをinheritしようとするsubclassconstructors は、[[ErrorData]] internal slotを持つsubclass instancesを作成およびinitializeするために、AggregateErrorconstructor へのsupercallを含まなければなりません。
20.5.7.1.1 AggregateError ( errors, message [ , options ] )
このfunctionは呼び出されたとき、次のstepsを実行します：
- NewTargetが
undefined なら、newTargetをactive function object とする；そうでなければ、newTargetをNewTargetとする。 - objを ?
OrdinaryCreateFromConstructor (newTarget,"%AggregateError.prototype%" , « [[ErrorData]] ») とする。 - messageが
undefined でないなら、- messageStringを ?
ToString (message) とする。 CreateNonEnumerableDataPropertyOrThrow (obj,"message" , messageString)を実行する。
- messageStringを ?
- ?
InstallErrorCause (obj, options)を実行する。 - errorsListを ?
IteratorToList (?GetIterator (errors,sync )) とする。 - !
DefinePropertyOrThrow (obj,"errors" , PropertyDescriptor { [[Configurable]]:true , [[Enumerable]]:false , [[Writable]]:true , [[Value]]:CreateArrayFromList (errorsList) })を実行する。 - objを返す。
20.5.7.2 Properties of the AggregateError Constructor
AggregateError
- valueが
%Error% である[[Prototype]] internal slotを持ちます。 - 次のpropertiesを持ちます：
20.5.7.2.1 AggregateError.prototype
AggregateError.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
20.5.7.3 Properties of the AggregateError Prototype Object
AggregateError prototype objectは：
- %AggregateError.prototype%です。
ordinary object です。- Error instanceでもAggregateError instanceでもなく、[[ErrorData]] internal slotを持ちません。
- valueが
%Error.prototype% である[[Prototype]] internal slotを持ちます。
20.5.7.3.1 AggregateError.prototype.constructor
AggregateError.prototype.constructorのinitial valueは
20.5.7.3.2 AggregateError.prototype.message
AggregateError.prototype.messageのinitial valueはempty Stringです。
20.5.7.3.3 AggregateError.prototype.name
AggregateError.prototype.nameのinitial valueは
20.5.7.4 AggregateError インスタンスのプロパティ
AggregateError インスタンスは、自身の AggregateError プロトタイプオブジェクトからプロパティを継承し、値が Object.prototype.toString（Error.isError（
20.5.8 SuppressedError オブジェクト
20.5.8.1 SuppressedError コンストラクタ
SuppressedError コンストラクタは次のとおりである:
- %SuppressedError% である。
- グローバルオブジェクトの
"SuppressedError" プロパティの初期値である。 - コンストラクタとしてではなく関数として呼び出された場合、新しい SuppressedError オブジェクトを作成して初期化する。したがって、関数呼び出し
SuppressedError(…)は、同じ引数を持つオブジェクト作成式new SuppressedError(…)と等価である。 - クラス定義の
extends節の値として使用できる。指定された SuppressedError の振る舞いを継承しようとするサブクラスコンストラクタは、[[ErrorData]] 内部スロットを持つサブクラスインスタンスを作成して初期化するために、SuppressedError コンストラクタへのsuper呼び出しを含めなければならない。
20.5.8.1.1 SuppressedError ( error, suppressed, message )
この関数は、呼び出されたときに次のステップを実行する:
- NewTarget が
undefined である場合、newTarget をアクティブな関数オブジェクトとする。そうでなければ、newTarget を NewTarget とする。 - obj を ?
OrdinaryCreateFromConstructor (newTarget,"%SuppressedError.prototype%" , « [[ErrorData]] ») とする。 - message が
undefined でない場合、then- messageString を ?
ToString (message) とする。 CreateNonEnumerableDataPropertyOrThrow (obj,"message" , messageString) を実行する。
- messageString を ?
CreateNonEnumerableDataPropertyOrThrow (obj,"error" , error) を実行する。CreateNonEnumerableDataPropertyOrThrow (obj,"suppressed" , suppressed) を実行する。- obj を返す。
20.5.8.2 SuppressedError コンストラクタのプロパティ
SuppressedError コンストラクタは次のとおりである:
- 値が
%Error% である [[Prototype]] 内部スロットを持つ。 - 次のプロパティを持つ:
20.5.8.2.1 SuppressedError.prototype
SuppressedError.prototype の初期値は
このプロパティは属性 { [[Writable]]:
20.5.8.3 SuppressedError プロトタイプオブジェクトのプロパティ
SuppressedError プロトタイプオブジェクトは次のとおりである:
- %SuppressedError.prototype% である。
- 通常のオブジェクトである。
- Error インスタンスでも SuppressedError インスタンスでもなく、[[ErrorData]] 内部スロットを持たない。
- 値が
%Error.prototype% である [[Prototype]] 内部スロットを持つ。
20.5.8.3.1 SuppressedError.prototype.constructor
SuppressedError.prototype.constructor の初期値は
20.5.8.3.2 SuppressedError.prototype.message
SuppressedError.prototype.message の初期値は空の String である。
20.5.8.3.3 SuppressedError.prototype.name
SuppressedError.prototype.name の初期値は
20.5.8.4 SuppressedError インスタンスのプロパティ
SuppressedError インスタンスは、自身の Object.prototype.toString および Error.isError において、Error、AggregateError、SuppressedError、および NativeError インスタンスを Error オブジェクトとして識別することである。
20.5.9 Abstract Operations for Error Objects
20.5.9.1 InstallErrorCause ( obj, options )
The abstract operation InstallErrorCause takes arguments obj (an Object) and options (an ECMAScript language value) and returns either a
- optionsがObjectであり、?
HasProperty (options,"cause" )がtrue なら、- causeを ?
Get (options,"cause" ) とする。 CreateNonEnumerableDataPropertyOrThrow (obj,"cause" , cause)を実行する。
- causeを ?
unused を返す。
21 Numbers and Dates
21.1 Number Objects
21.1.1 The Number Constructor
Number
- %Number%です。
global object の"Number" propertyのinitial valueです。constructor として呼び出されたとき、新しいNumber objectを作成およびinitializeします。constructor としてではなくfunctionとして呼び出されたとき、type conversionを実行します。- class definitionの
extendsclauseのvalueとして使用できます。指定されたNumber behaviourをinheritしようとするsubclassconstructors は、[[NumberData]] internal slotを持つsubclass instanceを作成およびinitializeするために、Numberconstructor へのsupercallを含まなければなりません。
21.1.1.1 Number ( value )
このfunctionは呼び出されたとき、次のstepsを実行します：
- valueが存在するなら、
- そうでなければ、
- nを
+0 𝔽とする。
- nを
- NewTargetが
undefined なら、nを返す。 - objを ?
OrdinaryCreateFromConstructor (NewTarget,"%Number.prototype%" , « [[NumberData]] ») とする。 - obj.[[NumberData]]をnに設定する。
- objを返す。
21.1.2 Properties of the Number Constructor
Number
- valueが
%Function.prototype% である[[Prototype]] internal slotを持ちます。 - 次のpropertiesを持ちます：
21.1.2.1 Number.EPSILON
Number.EPSILONのvalueは、1と、Number valueとしてrepresentableな1より大きい最小のvalueとの差のmagnitudeに対するNumber valueであり、およそ2.2204460492503130808472633361816 × 10-16です。
このpropertyはattributes { [[Writable]]:
21.1.2.2 Number.isFinite ( number )
このfunctionは呼び出されたとき、次のstepsを実行します：
- numberがNumberでないなら、
false を返す。 - numberが
finite でないなら、false を返す。 true を返す。
21.1.2.3 Number.isInteger ( number )
このfunctionは呼び出されたとき、次のstepsを実行します：
- numberが
integral Number なら、true を返す。 false を返す。
21.1.2.4 Number.isNaN ( number )
このfunctionは呼び出されたとき、次のstepsを実行します：
- numberがNumberでないなら、
false を返す。 - numberが
NaN なら、true を返す。 false を返す。
このfunctionは、NaNであるかどうかをdetermineする前にそのargumentをNumberへconvertしないという点で、global isNaN function（
21.1.2.5 Number.isSafeInteger ( number )
このfunctionは呼び出されたとき、次のstepsを実行します：
- numberが
integral Number なら、 false を返す。
21.1.2.6 Number.MAX_SAFE_INTEGER
Number.MAX_SAFE_INTEGERより大きいすべての9007199254740992と9007199254740993はいずれもNumber value
Number.MAX_SAFE_INTEGERのvalueは
このpropertyはattributes { [[Writable]]:
21.1.2.7 Number.MAX_VALUE
Number.MAX_VALUEのvalueはNumber typeのlargest positive
このpropertyはattributes { [[Writable]]:
21.1.2.8 Number.MIN_SAFE_INTEGER
Number.MIN_SAFE_INTEGERより小さいすべての-9007199254740992と-9007199254740993はいずれもNumber value
Number.MIN_SAFE_INTEGERのvalueは
このpropertyはattributes { [[Writable]]:
21.1.2.9 Number.MIN_VALUE
Number.MIN_VALUEのvalueはNumber typeのsmallest positive valueであり、およそ
Number.MIN_VALUEのvalueは、そのimplementationによって実際にrepresentできるsmallest non-zero positive valueでなければなりません。
このpropertyはattributes { [[Writable]]:
21.1.2.10 Number.NaN
Number.NaNのvalueは
このpropertyはattributes { [[Writable]]:
21.1.2.11 Number.NEGATIVE_INFINITY
Number.NEGATIVE_INFINITYのvalueは
このpropertyはattributes { [[Writable]]:
21.1.2.12 Number.parseFloat ( string )
21.1.2.13 Number.parseInt ( string, radix )
21.1.2.14 Number.POSITIVE_INFINITY
Number.POSITIVE_INFINITYのvalueは
このpropertyはattributes { [[Writable]]:
21.1.2.15 Number.prototype
Number.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
21.1.3 Properties of the Number Prototype Object
Number prototype objectは：
- %Number.prototype%です。
ordinary object です。- それ自体がNumber objectです；valueが
+0 𝔽である[[NumberData]] internal slotを持ちます。 - valueが
%Object.prototype% である[[Prototype]] internal slotを持ちます。
明示的に別途述べられない限り、以下で定義されるNumber prototype objectのmethodsはgenericではなく、それらに渡される
methodのspecification内の“this Number value”というphraseは、method invocationの
21.1.3.1 Number.prototype.constructor
Number.prototype.constructorのinitial valueは
21.1.3.2 Number.prototype.toExponential ( fractionDigits )
このmethodは、this Number valueを、significandのdecimal pointの前に1桁、significandのdecimal pointの後にfractionDigits桁を持つdecimal exponential notationで表したStringを返します。fractionDigitsが
これは呼び出されたとき、次のstepsを実行します：
- numberを ?
ThisNumberValue (this value) とする。 - fractionCountを ?
ToIntegerOrInfinity (fractionDigits) とする。 Assert : fractionDigitsがundefined なら、fractionCountは0である。- numberが
finite でないなら、Number::toString (number, 10)を返す。 - fractionCount < 0またはfractionCount > 100なら、
RangeError 例外をthrowする。 - numberを
ℝ (number)に設定する。 - signをempty Stringとする。
- number < 0なら、
- signを
"-" に設定する。 - numberを-numberに設定する。
- signを
- number = 0なら、
- significandを、code unit 0x0030 (DIGIT ZERO)がfractionCount + 1回出現するString valueとする。
- exponentを0とする。
- そうでなければ、
- fractionDigitsが
undefined でないなら、- exponentおよびintSignificandを、10fractionCount ≤ intSignificand < 10fractionCount + 1であり、intSignificand × 10exponent - fractionCount - numberが可能な限りzeroに近くなるような
integers とする。そのようなexponentおよびintSignificandのsetsが2つある場合、intSignificand × 10exponent - fractionCountがより大きい方のexponentおよびintSignificandを選ぶ。
- exponentおよびintSignificandを、10fractionCount ≤ intSignificand < 10fractionCount + 1であり、intSignificand × 10exponent - fractionCount - numberが可能な限りzeroに近くなるような
- そうでなければ、
- exponent、intSignificand、およびffを、ff ≥ 0、10ff ≤ intSignificand < 10ff + 1、
𝔽 (intSignificand × 10exponent - ff)が𝔽 (number)であり、ffが可能な限りsmallであるようなintegers とする。intSignificandのdecimal representationはff + 1 digitsを持ち、intSignificandは10で割り切れず、intSignificandのleast significant digitはこれらのcriteriaによって必ずしも一意にdeterminedされないことに注意。 - fractionCountをffに設定する。
- exponent、intSignificand、およびffを、ff ≥ 0、10ff ≤ intSignificand < 10ff + 1、
- significandを、intSignificandのdecimal representationのdigitsからなるString value（order通り、leading zeroesなし）とする。
- fractionDigitsが
- fractionCount ≠ 0なら、
- intPartをsignificandの最初のcode unitとする。
- fractionalPartをsignificandの他のfractionCount個のcode unitsとする。
- significandをintPart、
"." 、およびfractionalPartのstring-concatenation に設定する。
- exponent = 0なら、
- exponentSignを
"+" とする。 - exponentDigitsを
"0" とする。
- exponentSignを
- そうでなければ、
- exponent > 0なら、
- exponentSignを
"+" とする。
- exponentSignを
- そうでなければ、
Assert : exponent < 0である。- exponentSignを
"-" とする。 - exponentを-exponentに設定する。
- exponentDigitsを、exponentのdecimal representationのdigitsからなるString value（order通り、leading zeroesなし）とする。
- exponent > 0なら、
- significandをsignificand、
"e" 、exponentSign、およびexponentDigitsのstring-concatenation に設定する。 - signとsignificandの
string-concatenation を返す。
上記のrulesでrequiredされるよりもaccurateなconversionsを提供するimplementationsについては、step
- exponent、intSignificand、およびffを、ff ≥ 0、10ff ≤ intSignificand < 10ff + 1、
𝔽 (intSignificand × 10exponent - ff)が𝔽 (number)であり、ffが可能な限りsmallであるようなintegers とする。intSignificandについて複数のpossibilitiesがある場合、𝔽 (intSignificand × 10exponent - ff)が𝔽 (number)にclosestであるようにintSignificandを選ぶ。そのようなintSignificandのpossible valuesが2つある場合、evenである方を選ぶ。
21.1.3.3 Number.prototype.toFixed ( fractionDigits )
このmethodは、this Number valueをdecimal fixed-point notationで表し、decimal pointの後にfractionDigits桁を持つStringを返します。fractionDigitsが
これは呼び出されたとき、次のstepsを実行します：
- numberを ?
ThisNumberValue (this value) とする。 - fractionCountを ?
ToIntegerOrInfinity (fractionDigits) とする。 Assert : fractionDigitsがundefined なら、fractionCountは0である。- fractionCountが
finite でないなら、RangeError 例外をthrowする。 - fractionCount < 0またはfractionCount > 100なら、
RangeError 例外をthrowする。 - numberが
finite でないなら、Number::toString (number, 10)を返す。 - numberを
ℝ (number)に設定する。 - signをempty Stringとする。
- number < 0なら、
- signを
"-" に設定する。 - numberを-numberに設定する。
- signを
- number ≥ 1021なら、
- そうでなければ、
- intValueを、intValue / 10fractionCount - numberが可能な限りzeroに近くなる
integer とする。そのようなintValueが2つある場合、より大きいintValueを選ぶ。 - intValue = 0なら、digitStringを
"0" とする；そうでなければ、digitStringをintValueのdecimal representationのdigitsからなるString value（order通り、leading zeroesなし）とする。 - fractionCount ≠ 0なら、
- digitCountをdigitStringのlengthとする。
- digitCount ≤ fractionCountなら、
- zeroPadを、code unit 0x0030 (DIGIT ZERO)がfractionCount + 1 - digitCount回出現するString valueとする。
- digitStringをzeroPadとdigitStringの
string-concatenation に設定する。 - digitCountをfractionCount + 1に設定する。
- intPartをdigitStringの最初のdigitCount - fractionCount個のcode unitsとする。
- fractionalPartをdigitStringの他のfractionCount個のcode unitsとする。
- digitStringをintPart、
"." 、およびfractionalPartのstring-concatenation に設定する。
- intValueを、intValue / 10fractionCount - numberが可能な限りzeroに近くなる
- signとdigitStringの
string-concatenation を返す。
toFixedのoutputは、一部のvaluesについてtoStringよりもpreciseである場合があります。これは、toStringがnumberをadjacent Number valuesとdistinguishするのに十分なsignificant digitsだけをprintするためです。例えば、
(1000000000000000128).toString()は
(1000000000000000128).toFixed(0)は
21.1.3.4 Number.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
ECMA-402 Internationalization APIを含むECMAScript implementationは、このmethodをECMA-402 specificationで指定される通りにimplementしなければなりません。ECMAScript implementationがECMA-402 APIを含まない場合、このmethodの次のspecificationが使用されます：
このmethodは、host environmentのcurrent localeのconventionsに従ってformattedされたthis Number valueを表すString valueをproduceします。このmethodはtoStringと同じものを返すことはpermissibleですが、encouragedはされません。
このmethodのoptional parametersのmeaningsはECMA-402 specificationで定義されます；ECMA-402 supportを含まないimplementationsは、それらのparameter positionsを他の目的に使用してはなりません。
21.1.3.5 Number.prototype.toPrecision ( precision )
このmethodは、this Number valueを、significandのdecimal pointの前に1桁、significandのdecimal pointの後に
これは呼び出されたとき、次のstepsを実行します：
- numberを ?
ThisNumberValue (this value) とする。 - precisionが
undefined なら、!ToString (number)を返す。 - precisionCountを ?
ToIntegerOrInfinity (precision) とする。 - numberが
finite でないなら、Number::toString (number, 10)を返す。 - precisionCount < 1またはprecisionCount > 100なら、
RangeError 例外をthrowする。 - numberを
ℝ (number)に設定する。 - signをempty Stringとする。
- number < 0なら、
- signをcode unit 0x002D (HYPHEN-MINUS)に設定する。
- numberを-numberに設定する。
- number = 0なら、
- significandを、code unit 0x0030 (DIGIT ZERO)がprecisionCount回出現するString valueとする。
- exponentを0とする。
- そうでなければ、
- exponentおよびintSignificandを、10precisionCount - 1 ≤ intSignificand < 10precisionCountであり、intSignificand × 10exponent - precisionCount + 1 - numberが可能な限りzeroに近くなるような
integers とする。そのようなexponentおよびintSignificandのsetsが2つある場合、intSignificand × 10exponent - precisionCount + 1がより大きい方のexponentおよびintSignificandを選ぶ。 - significandを、intSignificandのdecimal representationのdigitsからなるString value（order通り、leading zeroesなし）とする。
- exponent < -6またはexponent ≥ precisionCountなら、
Assert : exponent ≠ 0である。- precisionCount ≠ 1なら、
- intPartをsignificandの最初のcode unitとする。
- fractionalPartをsignificandの他のprecisionCount - 1個のcode unitsとする。
- significandをintPart、
"." 、およびfractionalPartのstring-concatenation に設定する。
- exponent > 0なら、
- exponentSignをcode unit 0x002B (PLUS SIGN)とする。
- そうでなければ、
Assert : exponent < 0である。- exponentSignをcode unit 0x002D (HYPHEN-MINUS)とする。
- exponentを-exponentに設定する。
- exponentDigitsを、exponentのdecimal representationのdigitsからなるString value（order通り、leading zeroesなし）とする。
- sign、significand、code unit 0x0065 (LATIN SMALL LETTER E)、exponentSign、およびexponentDigitsの
string-concatenation を返す。
- exponentおよびintSignificandを、10precisionCount - 1 ≤ intSignificand < 10precisionCountであり、intSignificand × 10exponent - precisionCount + 1 - numberが可能な限りzeroに近くなるような
- exponent = precisionCount - 1なら、signとsignificandの
string-concatenation を返す。 - exponent ≥ 0なら、
- significandを、significandの最初のexponent + 1個のcode units、code unit 0x002E (FULL STOP)、およびsignificandの残りのprecisionCount - (exponent + 1)個のcode unitsの
string-concatenation に設定する。
- significandを、significandの最初のexponent + 1個のcode units、code unit 0x002E (FULL STOP)、およびsignificandの残りのprecisionCount - (exponent + 1)個のcode unitsの
- そうでなければ、
- significandを、code unit 0x0030 (DIGIT ZERO)、code unit 0x002E (FULL STOP)、code unit 0x0030 (DIGIT ZERO)の-(exponent + 1)回のoccurrences、およびString significandの
string-concatenation に設定する。
- significandを、code unit 0x0030 (DIGIT ZERO)、code unit 0x002E (FULL STOP)、code unit 0x0030 (DIGIT ZERO)の-(exponent + 1)回のoccurrences、およびString significandの
- signとsignificandの
string-concatenation を返す。
21.1.3.6 Number.prototype.toString ( [ radix ] )
optional radixは、
このmethodは呼び出されたとき、次のstepsを実行します：
- xを ?
ThisNumberValue (this value) とする。 - radixが
undefined なら、radixMVを10とする。 - そうでなければ、radixMVを ?
ToIntegerOrInfinity (radix) とする。 - radixMVが2から36までの
inclusive interval 内にないなら、RangeError 例外をthrowする。 Number::toString (x, radixMV)を返す。
このmethodはgenericではありません；その
このmethodの
21.1.3.7 Number.prototype.valueOf ( )
- ?
ThisNumberValue (this value)を返す。
21.1.3.7.1 ThisNumberValue ( arg )
The abstract operation ThisNumberValue takes argument arg (an ECMAScript language value) and returns either a
- argがNumberなら、argを返す。
- argがObjectであり、argが[[NumberData]] internal slotを持つなら、
- numberをarg.[[NumberData]]とする。
Assert : numberはNumberである。- numberを返す。
TypeError 例外をThrowする。
21.1.4 Properties of Number Instances
Number instancesは、
21.2 BigInt Objects
21.2.1 The BigInt Constructor
BigInt
- %BigInt%です。
global object の"BigInt" propertyのinitial valueです。constructor としてではなくfunctionとして呼び出されたとき、type conversionを実行します。newoperatorとともに使用すること、またはsubclassedされることを意図していません。class definitionのextendsclauseのvalueとして使用できますが、BigIntconstructor へのsupercallはexceptionを引き起こします。
21.2.1.1 BigInt ( value )
このfunctionは呼び出されたとき、次のstepsを実行します：
- NewTargetが
undefined でないなら、TypeError 例外をthrowする。 - primitiveを ?
ToPrimitive (value,number ) とする。 - primitiveがNumberなら、?
NumberToBigInt (primitive)を返す。 - ?
ToBigInt (primitive)を返す。
21.2.1.1.1 NumberToBigInt ( number )
The abstract operation NumberToBigInt takes argument number (a Number) and returns either a
- numberが
integral Number でないなら、RangeError 例外をthrowする。 ℤ (ℝ (number))を返す。
21.2.2 Properties of the BigInt Constructor
BigInt
- valueが
%Function.prototype% である[[Prototype]] internal slotを持ちます。 - 次のpropertiesを持ちます：
21.2.2.1 BigInt.asIntN ( bits, bigint )
このfunctionは呼び出されたとき、次のstepsを実行します：
21.2.2.2 BigInt.asUintN ( bits, bigint )
このfunctionは呼び出されたとき、次のstepsを実行します：
21.2.2.3 BigInt.prototype
BigInt.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
21.2.3 Properties of the BigInt Prototype Object
BigInt prototype objectは：
- %BigInt.prototype%です。
ordinary object です。- BigInt objectではなく、[[BigIntData]] internal slotを持ちません。
- valueが
%Object.prototype% である[[Prototype]] internal slotを持ちます。
methodのspecification内の“this BigInt value”というphraseは、method invocationの
21.2.3.1 BigInt.prototype.constructor
BigInt.prototype.constructorのinitial valueは
21.2.3.2 BigInt.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
ECMA-402 Internationalization APIを含むECMAScript implementationは、このmethodをECMA-402 specificationで指定される通りにimplementしなければなりません。ECMAScript implementationがECMA-402 APIを含まない場合、このmethodの次のspecificationが使用されます：
このmethodは、host environmentのcurrent localeのconventionsに従ってformattedされたthis BigInt valueを表すString valueをproduceします。このmethodはtoStringと同じものを返すことはpermissibleですが、encouragedはされません。
このmethodのoptional parametersのmeaningsはECMA-402 specificationで定義されます；ECMA-402 supportを含まないimplementationsは、それらのparameter positionsを他の目的に使用してはなりません。
21.2.3.3 BigInt.prototype.toString ( [ radix ] )
optional radixは、
このmethodは呼び出されたとき、次のstepsを実行します：
- xを ?
ThisBigIntValue (this value) とする。 - radixが
undefined なら、radixMVを10とする。 - そうでなければ、radixMVを ?
ToIntegerOrInfinity (radix) とする。 - radixMVが2から36までの
inclusive interval 内にないなら、RangeError 例外をthrowする。 BigInt::toString (x, radixMV)を返す。
このmethodはgenericではありません；その
21.2.3.4 BigInt.prototype.valueOf ( )
- ?
ThisBigIntValue (this value)を返す。
21.2.3.4.1 ThisBigIntValue ( arg )
The abstract operation ThisBigIntValue takes argument arg (an ECMAScript language value) and returns either a
- argがBigIntなら、argを返す。
- argがObjectであり、argが[[BigIntData]] internal slotを持つなら、
Assert : arg.[[BigIntData]]はBigIntである。- arg.[[BigIntData]]を返す。
TypeError 例外をThrowする。
21.2.3.5 BigInt.prototype [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
21.2.4 Properties of BigInt Instances
BigInt instancesは、
21.3 The Math Object
Math objectは：
- %Math%です。
global object の"Math" propertyのinitial valueです。ordinary object です。- valueが
%Object.prototype% である[[Prototype]] internal slotを持ちます。 function object ではありません。- [[Construct]] internal methodを持ちません；
newoperatorを伴うconstructor として使用できません。 - [[Call]] internal methodを持ちません；functionとして呼び出せません。
この仕様では、“the
21.3.1 Value Properties of the Math Object
21.3.1.1 Math.E
e、すなわちnatural logarithmsのbaseに対するNumber valueであり、およそ2.7182818284590452354です。
このpropertyはattributes { [[Writable]]:
21.3.1.2 Math.LN10
10のnatural logarithmに対するNumber valueであり、およそ2.302585092994046です。
このpropertyはattributes { [[Writable]]:
21.3.1.3 Math.LN2
2のnatural logarithmに対するNumber valueであり、およそ0.6931471805599453です。
このpropertyはattributes { [[Writable]]:
21.3.1.4 Math.LOG10E
e、すなわちnatural logarithmsのbaseのbase-10 logarithmに対するNumber valueです；このvalueはおよそ0.4342944819032518です。
このpropertyはattributes { [[Writable]]:
Math.LOG10EのvalueはMath.LN10のvalueのreciprocalにおおよそ等しいです。
21.3.1.5 Math.LOG2E
e、すなわちnatural logarithmsのbaseのbase-2 logarithmに対するNumber valueです；このvalueはおよそ1.4426950408889634です。
このpropertyはattributes { [[Writable]]:
Math.LOG2EのvalueはMath.LN2のvalueのreciprocalにおおよそ等しいです。
21.3.1.6 Math.PI
π、すなわちcircleのcircumferenceとdiameterのratioに対するNumber valueであり、およそ3.1415926535897932です。
このpropertyはattributes { [[Writable]]:
21.3.1.7 Math.SQRT1_2
½のsquare rootに対するNumber valueであり、およそ0.7071067811865476です。
このpropertyはattributes { [[Writable]]:
Math.SQRT1_2のvalueはMath.SQRT2のvalueのreciprocalにおおよそ等しいです。
21.3.1.8 Math.SQRT2
2のsquare rootに対するNumber valueであり、およそ1.4142135623730951です。
このpropertyはattributes { [[Writable]]:
21.3.1.9 Math [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
21.3.2 Function Properties of the Math Object
functions acos、acosh、asin、asinh、atan、atanh、atan2、cbrt、cos、cosh、exp、expm1、hypot、log、log1p、log2、log10、pow、random、sin、sinh、tan、およびtanhのbehaviourは、interestのあるboundary casesを表す特定のargument valuesに対してspecific resultsをrequireすることを除き、ここではpreciselyに指定されません。他のargument valuesについては、これらのfunctionsはfamiliar mathematical functionsのresultsへのapproximationsをcomputeすることを意図していますが、approximation algorithmsの選択にはある程度のlatitudeが許されます。general intentは、implementerが、与えられたhardware platform上のECMAScriptに対して、そのplatform上のC programmersが利用できる同じmathematical libraryを使用できるようにすることです。
algorithmsの選択はimplementationに任されますが、implementationsは、Sun Microsystemsのfreely distributable mathematical libraryであるfdlibm（http://www.netlib.org/fdlibm）に含まれる
21.3.2.1 Math.abs ( x )
このfunctionはxのabsolute valueを返します；resultはxと同じmagnitudeを持ちますが、positive signを持ちます。
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
NaN なら、NaN を返す。 - nが
-0 𝔽なら、+0 𝔽を返す。 - nが
-∞ 𝔽なら、+∞ 𝔽を返す。 - n <
-0 𝔽なら、-nを返す。 - nを返す。
21.3.2.2 Math.acos ( x )
このfunctionはxのinverse cosineを返します。resultはradiansで表され、
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
NaN 、n >1 𝔽、またはn <-1 𝔽のいずれかなら、NaN を返す。 - nが
1 𝔽なら、+0 𝔽を返す。 ℝ (n)のinverse cosineを表すimplementation-approximated Number valueを返す。
21.3.2.3 Math.acosh ( x )
このfunctionはxのinverse hyperbolic cosineを返します。
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
NaN または+∞ 𝔽のいずれかなら、nを返す。 - nが
1 𝔽なら、+0 𝔽を返す。 - n <
1 𝔽なら、NaN を返す。 ℝ (n)のinverse hyperbolic cosineを表すimplementation-approximated Number valueを返す。
21.3.2.4 Math.asin ( x )
このfunctionはxのinverse sineを返します。resultはradiansで表され、
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
NaN 、+0 𝔽、または-0 𝔽のいずれかなら、nを返す。 - n >
1 𝔽またはn <-1 𝔽なら、NaN を返す。 ℝ (n)のinverse sineを表すimplementation-approximated Number valueを返す。
21.3.2.5 Math.asinh ( x )
このfunctionはxのinverse hyperbolic sineを返します。
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
finite でない、またはnが+0 𝔽または-0 𝔽のいずれかなら、nを返す。 ℝ (n)のinverse hyperbolic sineを表すimplementation-approximated Number valueを返す。
21.3.2.6 Math.atan ( x )
このfunctionはxのinverse tangentを返します。resultはradiansで表され、
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
NaN 、+0 𝔽、または-0 𝔽のいずれかなら、nを返す。 - nが
+∞ 𝔽なら、π / 2を表すimplementation-approximated Number valueを返す。 - nが
-∞ 𝔽なら、-π / 2を表すimplementation-approximated Number valueを返す。 ℝ (n)のinverse tangentを表すimplementation-approximated Number valueを返す。
21.3.2.7 Math.atanh ( x )
このfunctionはxのinverse hyperbolic tangentを返します。
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
NaN 、+0 𝔽、または-0 𝔽のいずれかなら、nを返す。 - n >
1 𝔽またはn <-1 𝔽なら、NaN を返す。 - nが
1 𝔽なら、+∞ 𝔽を返す。 - nが
-1 𝔽なら、-∞ 𝔽を返す。 ℝ (n)のinverse hyperbolic tangentを表すimplementation-approximated Number valueを返す。
21.3.2.8 Math.atan2 ( y, x )
このfunctionはarguments yおよびxのquotient
これは呼び出されたとき、次のstepsを実行します：
- nyを ?
ToNumber (y) とする。 - nxを ?
ToNumber (x) とする。 - nyが
NaN またはnxがNaN なら、NaN を返す。 - nyが
+∞ 𝔽なら、- nxが
+∞ 𝔽なら、π / 4を表すimplementation-approximated Number valueを返す。 - nxが
-∞ 𝔽なら、3π / 4を表すimplementation-approximated Number valueを返す。 - π / 2を表す
implementation-approximated Number valueを返す。
- nxが
- nyが
-∞ 𝔽なら、- nxが
+∞ 𝔽なら、-π / 4を表すimplementation-approximated Number valueを返す。 - nxが
-∞ 𝔽なら、-3π / 4を表すimplementation-approximated Number valueを返す。 - -π / 2を表す
implementation-approximated Number valueを返す。
- nxが
- nyが
+0 𝔽なら、- nx >
+0 𝔽またはnxが+0 𝔽なら、+0 𝔽を返す。 - πを表す
implementation-approximated Number valueを返す。
- nx >
- nyが
-0 𝔽なら、- nx >
+0 𝔽またはnxが+0 𝔽なら、-0 𝔽を返す。 - -πを表す
implementation-approximated Number valueを返す。
- nx >
Assert : nyはfinite であり、+0 𝔽でも-0 𝔽でもない。- ny >
+0 𝔽なら、- nxが
+∞ 𝔽なら、+0 𝔽を返す。 - nxが
-∞ 𝔽なら、πを表すimplementation-approximated Number valueを返す。 - nxが
+0 𝔽または-0 𝔽のいずれかなら、π / 2を表すimplementation-approximated Number valueを返す。
- nxが
- ny <
-0 𝔽なら、- nxが
+∞ 𝔽なら、-0 𝔽を返す。 - nxが
-∞ 𝔽なら、-πを表すimplementation-approximated Number valueを返す。 - nxが
+0 𝔽または-0 𝔽のいずれかなら、-π / 2を表すimplementation-approximated Number valueを返す。
- nxが
Assert : nxはfinite であり、+0 𝔽でも-0 𝔽でもない。- resultを
abs (ℝ (ny) /ℝ (nx))のinverse tangentとする。 - nx <
-0 𝔽なら、- ny >
+0 𝔽なら、resultをπ - resultに設定する。 - そうでなければ、resultを-π + resultに設定する。
- ny >
- そうでなければ、
- ny <
-0 𝔽なら、resultを-resultに設定する。
- ny <
- resultを表す
implementation-approximated Number valueを返す。
21.3.2.9 Math.cbrt ( x )
このfunctionはxのcube rootを返します。
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
finite でない、またはnが+0 𝔽または-0 𝔽のいずれかなら、nを返す。 ℝ (n)のcube rootを表すimplementation-approximated Number valueを返す。
21.3.2.10 Math.ceil ( x )
このfunctionは、x以上であるsmallest（-∞にclosest）
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
finite でない、またはnが+0 𝔽または-0 𝔽のいずれかなら、nを返す。 - n <
-0 𝔽かつn >-1 𝔽なら、-0 𝔽を返す。 - nが
integral Number なら、nを返す。 - n以上であるsmallest（-∞にclosest）
integral Number valueを返す。
Math.ceil(x)のvalueは-Math.floor(-x)のvalueと同じです。
21.3.2.11 Math.clz32 ( x )
このfunctionは呼び出されたとき、次のstepsを実行します：
nが
21.3.2.12 Math.cos ( x )
このfunctionはxのcosineを返します。argumentはradiansで表されます。
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
finite でないなら、NaN を返す。 - nが
+0 𝔽または-0 𝔽のいずれかなら、1 𝔽を返す。 ℝ (n)のcosineを表すimplementation-approximated Number valueを返す。
21.3.2.13 Math.cosh ( x )
このfunctionはxのhyperbolic cosineを返します。
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
NaN なら、NaN を返す。 - nが
+∞ 𝔽または-∞ 𝔽のいずれかなら、+∞ 𝔽を返す。 - nが
+0 𝔽または-0 𝔽のいずれかなら、1 𝔽を返す。 ℝ (n)のhyperbolic cosineを表すimplementation-approximated Number valueを返す。
Math.cosh(x)のvalueは(Math.exp(x) + Math.exp(-x)) / 2のvalueと同じです。
21.3.2.14 Math.exp ( x )
このfunctionはxのexponential function（eをx乗したもの。ここでeはnatural logarithmsのbase）を返します。
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
NaN または+∞ 𝔽のいずれかなら、nを返す。 - nが
+0 𝔽または-0 𝔽のいずれかなら、1 𝔽を返す。 - nが
-∞ 𝔽なら、+0 𝔽を返す。 ℝ (n)のexponential functionを表すimplementation-approximated Number valueを返す。
21.3.2.15 Math.expm1 ( x )
このfunctionはxのexponential function（eをx乗したもの。ここでeはnatural logarithmsのbase）から1をsubtractしたresultを返します。resultは、xのvalueが0に近い場合でもaccurateになるようにcomputedされます。
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
NaN 、+0 𝔽、-0 𝔽、または+∞ 𝔽のいずれかなら、nを返す。 - nが
-∞ 𝔽なら、-1 𝔽を返す。 - expを
ℝ (n)のexponential functionとする。 - exp - 1を表す
implementation-approximated Number valueを返す。
21.3.2.16 Math.floor ( x )
このfunctionは、x以下であるgreatest（+∞にclosest）
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
finite でない、またはnが+0 𝔽または-0 𝔽のいずれかなら、nを返す。 - n <
1 𝔽かつn >+0 𝔽なら、+0 𝔽を返す。 - nが
integral Number なら、nを返す。 - n以下であるgreatest（+∞にclosest）
integral Number valueを返す。
Math.floor(x)のvalueは-Math.ceil(-x)のvalueと同じです。
21.3.2.17 Math.fround ( x )
このfunctionは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
NaN なら、NaN を返す。 - nが
+0 𝔽、-0 𝔽、+∞ 𝔽、または-∞ 𝔽のいずれかなら、nを返す。 - n32を、roundTiesToEven modeを使用してnを
IEEE 754-2019 binary32 formatへconvertしたresultとする。 - n64を、n32を
IEEE 754-2019 binary64 formatへconvertしたresultとする。 - n64に対応するECMAScript Number valueを返す。
21.3.2.18 Math.f16round ( x )
このfunctionは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
NaN なら、NaN を返す。 - nが
+0 𝔽、-0 𝔽、+∞ 𝔽、または-∞ 𝔽のいずれかなら、nを返す。 - n16を、roundTiesToEven modeを使用してnを
IEEE 754-2019 binary16 formatへconvertしたresultとする。 - n64を、n16を
IEEE 754-2019 binary64 formatへconvertしたresultとする。 - n64に対応するECMAScript Number valueを返す。
このoperationは、binary32へcastしてからbinary16へcastすることと同じではありません。double-roundingの可能性があるためです：例えばnumber k =
すべてのplatformsがbinary64からbinary16へのcastingにnative supportを提供するわけではありません。これを提供できるlibrariesはさまざまあり、MIT-licensedのhalf libraryも含まれます。あるいは、まずroundTiesToEvenの下でbinary64からbinary32へcastし、そのresultがincorrect double-roundingにつながる可能性があるかどうかをcheckすることもできます。そのようなcasesは、binary32 valueのmantissaをadjustし、initial castをroundTiesToOddの下で実行した場合にproduceされるvalueになるようにすることで明示的にhandleできます。adjusted valueをroundTiesToEvenの下でbinary16へcastすると、correct valueがproduceされます。
21.3.2.19 Math.hypot ( ...args )
zero以上のargumentsが与えられると、このfunctionはそのargumentsのsquaresのsumのsquare rootを返します。
これは呼び出されたとき、次のstepsを実行します：
- coercedを新しい空の
List とする。 - argsの各要素argについて、以下を行う
- nを ?
ToNumber (arg) とする。 - nをcoercedへappendする。
- nを ?
- coercedの各要素numberについて、以下を行う
- numberが
+∞ 𝔽または-∞ 𝔽のいずれかなら、+∞ 𝔽を返す。
- numberが
- onlyZeroを
true とする。 - coercedの各要素numberについて、以下を行う
- numberが
NaN なら、NaN を返す。 - numberが
+0 𝔽でも-0 𝔽でもないなら、onlyZeroをfalse に設定する。
- numberが
- onlyZeroが
true なら、+0 𝔽を返す。 - coercedの要素の
mathematical values のsquaresのsumのsquare rootを表すimplementation-approximated Number valueを返す。
このfunctionの
このfunctionが2つ以上のargumentsで呼び出されるときにnaive implementationsで発生しやすいoverflowsおよびunderflowsによるprecision lossを避けるよう、implementationsは注意すべきです。
21.3.2.20 Math.imul ( x, y )
このfunctionは呼び出されたとき、次のstepsを実行します：
21.3.2.21 Math.log ( x )
このfunctionはxのnatural logarithmを返します。
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
NaN または+∞ 𝔽のいずれかなら、nを返す。 - nが
1 𝔽なら、+0 𝔽を返す。 - nが
+0 𝔽または-0 𝔽のいずれかなら、-∞ 𝔽を返す。 - n <
-0 𝔽なら、NaN を返す。 ln (ℝ (n))を表すimplementation-approximated Number valueを返す。
21.3.2.22 Math.log1p ( x )
このfunctionは1 + xのnatural logarithmを返します。resultは、xのvalueがzeroに近い場合でもaccurateになるようにcomputedされます。
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
NaN 、+0 𝔽、-0 𝔽、または+∞ 𝔽のいずれかなら、nを返す。 - nが
-1 𝔽なら、-∞ 𝔽を返す。 - n <
-1 𝔽なら、NaN を返す。 ln (1 +ℝ (n))を表すimplementation-approximated Number valueを返す。
21.3.2.23 Math.log10 ( x )
このfunctionはxのbase 10 logarithmを返します。
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
NaN または+∞ 𝔽のいずれかなら、nを返す。 - nが
1 𝔽なら、+0 𝔽を返す。 - nが
+0 𝔽または-0 𝔽のいずれかなら、-∞ 𝔽を返す。 - n <
-0 𝔽なら、NaN を返す。 log10 (ℝ (n))を表すimplementation-approximated Number valueを返す。
21.3.2.24 Math.log2 ( x )
このfunctionはxのbase 2 logarithmを返します。
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
NaN または+∞ 𝔽のいずれかなら、nを返す。 - nが
1 𝔽なら、+0 𝔽を返す。 - nが
+0 𝔽または-0 𝔽のいずれかなら、-∞ 𝔽を返す。 - n <
-0 𝔽なら、NaN を返す。 log2 (ℝ (n))を表すimplementation-approximated Number valueを返す。
21.3.2.25 Math.max ( ...args )
zero以上のargumentsが与えられると、このfunctionはargumentsのそれぞれに
これは呼び出されたとき、次のstepsを実行します：
largest valueをdetermineするためのvaluesのcomparisonは、
このfunctionの
21.3.2.26 Math.min ( ...args )
zero以上のargumentsが与えられると、このfunctionはargumentsのそれぞれに
これは呼び出されたとき、次のstepsを実行します：
smallest valueをdetermineするためのvaluesのcomparisonは、
このfunctionの
21.3.2.27 Math.pow ( base, exponent )
このfunctionは呼び出されたとき、次のstepsを実行します：
- baseを ?
ToNumber (base) に設定する。 - exponentを ?
ToNumber (exponent) に設定する。 Number::exponentiate (base, exponent)を返す。
21.3.2.28 Math.random ( )
このfunctionは、positive signを持ち、
distinct Math.random functionは、successive callsからdistinct sequence of valuesをproduceしなければなりません。
21.3.2.29 Math.round ( x )
このfunctionは、xにclosestでありintegralであるNumber valueを返します。2つの
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
finite でない、またはnがintegral Number なら、nを返す。 - n <
0.5 𝔽かつn >+0 𝔽なら、+0 𝔽を返す。 - n <
-0 𝔽かつn ≥-0.5 𝔽なら、-0 𝔽を返す。 - nにclosestな
integral Number を返し、tieの場合は+∞にcloserなNumberを優先する。
Math.round(3.5)は4を返しますが、Math.round(-3.5)は-3を返します。
Math.round(x)のvalueは、常にMath.floor(x + 0.5)のvalueと同じとは限りません。xがxがMath.round(x)はMath.floor(x + 0.5)はMath.round(x)はまた、x + 0.5をcomputeするときのinternal roundingのため、Math.floor(x + 0.5)のvalueと異なる場合があります。
21.3.2.30 Math.sign ( x )
このfunctionはxのsignを返し、xがpositive、negative、またはzeroであるかを示します。
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
NaN 、+0 𝔽、または-0 𝔽のいずれかなら、nを返す。 - n <
-0 𝔽なら、-1 𝔽を返す。 1 𝔽を返す。
21.3.2.31 Math.sin ( x )
このfunctionはxのsineを返します。argumentはradiansで表されます。
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
NaN 、+0 𝔽、または-0 𝔽のいずれかなら、nを返す。 - nが
+∞ 𝔽または-∞ 𝔽のいずれかなら、NaN を返す。 ℝ (n)のsineを表すimplementation-approximated Number valueを返す。
21.3.2.32 Math.sinh ( x )
このfunctionはxのhyperbolic sineを返します。
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
finite でない、またはnが+0 𝔽または-0 𝔽のいずれかなら、nを返す。 ℝ (n)のhyperbolic sineを表すimplementation-approximated Number valueを返す。
Math.sinh(x)のvalueは(Math.exp(x) - Math.exp(-x)) / 2のvalueと同じです。
21.3.2.33 Math.sqrt ( x )
このfunctionはxのsquare rootを返します。
これは呼び出されたとき、次のstepsを実行します：
21.3.2.34 Math.sumPrecise ( items )
Numbersの
これは呼び出されたとき、次のstepsを実行します：
- ?
RequireObjectCoercible (items)を実行する。 - iteratorRecordを ?
GetIterator (items,sync ) とする。 - stateを
minus-zero とする。 - sumを0とする。
- countを0とする。
- nextを
not-started とする。 - nextが
done でない間、繰り返す- nextを ?
IteratorStepValue (iteratorRecord) に設定する。 - nextが
done でないなら、- count ≥ 253 - 1なら、
NOTE : このstepは実際には到達しないことが期待されており、implementationsがこの仕様に違反することなくinputsが“reasonably sized”であることに依存できるようにするためだけに含まれる。- errorを
ThrowCompletion (a newly createdRangeError object)とする。 - ?
IteratorClose (iteratorRecord, error)を返す。
- nextがNumberでないなら、
- errorを
ThrowCompletion (a newly createdTypeError object)とする。 - ?
IteratorClose (iteratorRecord, error)を返す。
- errorを
- nをnextとする。
- stateが
not-a-number でないなら、- nが
NaN なら、- stateを
not-a-number に設定する。
- stateを
- そうでなく、nが
+∞ 𝔽なら、- stateが
minus-infinity なら、stateをnot-a-number に設定する。 - そうでなければ、stateを
plus-infinity に設定する。
- stateが
- そうでなく、nが
-∞ 𝔽なら、- stateが
plus-infinity なら、stateをnot-a-number に設定する。 - そうでなければ、stateを
minus-infinity に設定する。
- stateが
- そうでなく、nが
-0 𝔽でなく、かつstateがminus-zero またはfinite のいずれかなら、- stateを
finite に設定する。 - sumをsum +
ℝ (n)に設定する。
- stateを
- nが
- countをcount + 1に設定する。
- count ≥ 253 - 1なら、
- nextを ?
- stateが
not-a-number なら、NaN を返す。 - stateが
plus-infinity なら、+∞ 𝔽を返す。 - stateが
minus-infinity なら、-∞ 𝔽を返す。 - stateが
minus-zero なら、-0 𝔽を返す。 𝔽 (sum)を返す。
sumのvalueは、さまざまなalgorithmsによってarbitrary-precision arithmeticなしでcomputedできます。その1つは、Jonathan Richard ShewchukによるAdaptive Precision Floating-Point Arithmetic and Fast Robust Geometric Predicatesに示されている“Grow-Expansion” algorithmです。よりrecentなalgorithmは“Fast exact summation using small and large superaccumulators”に示されており、そのcodeはhttps://gitlab.com/radfordneal/xsumで利用できます。
21.3.2.35 Math.tan ( x )
このfunctionはxのtangentを返します。argumentはradiansで表されます。
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
NaN 、+0 𝔽、または-0 𝔽のいずれかなら、nを返す。 - nが
+∞ 𝔽または-∞ 𝔽のいずれかなら、NaN を返す。 ℝ (n)のtangentを表すimplementation-approximated Number valueを返す。
21.3.2.36 Math.tanh ( x )
このfunctionはxのhyperbolic tangentを返します。
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
NaN 、+0 𝔽、または-0 𝔽のいずれかなら、nを返す。 - nが
+∞ 𝔽なら、1 𝔽を返す。 - nが
-∞ 𝔽なら、-1 𝔽を返す。 ℝ (n)のhyperbolic tangentを表すimplementation-approximated Number valueを返す。
Math.tanh(x)のvalueは(Math.exp(x) - Math.exp(-x)) / (Math.exp(x) + Math.exp(-x))のvalueと同じです。
21.3.2.37 Math.trunc ( x )
このfunctionはnumber xのintegral partを返し、fractional digitsをremoveします。xがすでにintegralである場合、resultはxです。
これは呼び出されたとき、次のstepsを実行します：
- nを ?
ToNumber (x) とする。 - nが
finite でない、またはnが+0 𝔽または-0 𝔽のいずれかなら、nを返す。 - n <
1 𝔽かつn >+0 𝔽なら、+0 𝔽を返す。 - n <
-0 𝔽かつn >-1 𝔽なら、-0 𝔽を返す。 +0 𝔽の方向にnにnearestなintegral Number を返す。
21.4 Date Objects
21.4.1 Overview of Date Objects and Definitions of Abstract Operations
以下の
21.4.1.1 Time Values and Time Range
ECMAScriptにおけるtime measurementはPOSIXにおけるtime measurementに類似しており、特にproleptic Gregorian calendar、1970年1月1日UTCの開始時のmidnightをepochとすること、およびすべての日を正確に86,400秒（各秒は1000 milliseconds）から構成されるものとしてaccountingすることによるdefinitionを共有します。
ECMAScriptのtime valueはNumberであり、millisecond precisionでtime内のinstantを表す
Time valuesはUTC leap secondsをaccountしません—positive leap seconds内のinstantsを表すtime valuesは存在せず、negative leap secondsによってUTC timelineからremovedされたinstantsを表すtime valuesが存在します。しかしながら、time valuesのdefinitionは、それにもかかわらずUTCとのpiecewise alignmentをもたらし、discontinuitiesはleap second boundariesにのみ存在し、leap secondsの外側ではzero differenceになります。
Numberは-9,007,199,254,740,992から9,007,199,254,740,992までのすべての
1970年1月1日UTCの開始時のmidnightのexact momentは、time value
proleptic Gregorian calendarでは、leap yearsは、4でdivisibleであり、かつ400でdivisibleであるか100でdivisibleでないものです。
proleptic Gregorian calendarの400 year cycleには97 leap yearsが含まれます。これにより、yearあたり平均365.2425 days、すなわち31,556,952,000 millisecondsになります。したがって、Numberがmillisecond precisionでexactlyにrepresentできるmaximum rangeは、1970年を基準としておよそ-285,426年から285,426年です。このsectionで指定されるtime valueによってsupportされるsmaller rangeは、1970年を基準としておよそ-273,790年から273,790年です。
21.4.1.2 Time-related Constants
これらのconstantsは、以下のsectionsのalgorithmsによって参照されます。
21.4.1.3 Day ( tv )
The abstract operation Day takes argument tv (a
21.4.1.4 TimeWithinDay ( tv )
The abstract operation TimeWithinDay takes argument tv (a
21.4.1.5 DaysInYear ( y )
The abstract operation DaysInYear takes argument y (an
21.4.1.6 DayFromYear ( y )
The abstract operation DayFromYear takes argument y (an
- ryを
ℝ (y)とする。 NOTE : 以下のstepsでは、numberYears1、numberYears4、numberYears100、およびnumberYears400は、それぞれepoch とyear yのstartとの間に現れる、1、4、100、および400でdivisibleなyearsの数を表す。yがepoch より前なら、この数はnegativeである。- numberYears1を(ry - 1970)とする。
- numberYears4を
floor ((ry - 1969) / 4)とする。 - numberYears100を
floor ((ry - 1901) / 100)とする。 - numberYears400を
floor ((ry - 1601) / 400)とする。 𝔽 (365 × numberYears1 + numberYears4 - numberYears100 + numberYears400)を返す。
21.4.1.7 TimeFromYear ( y )
The abstract operation TimeFromYear takes argument y (an
msPerDay ×DayFromYear (y)を返す。
21.4.1.8 YearFromTime ( tv )
The abstract operation YearFromTime takes argument tv (a
TimeFromYear (y) ≤ tvであるようなlargestintegral Number y（+∞にclosest）を返す。
21.4.1.9 DayWithinYear ( tv )
The abstract operation DayWithinYear takes argument tv (a
Day (tv) -DayFromYear (YearFromTime (tv))を返す。
21.4.1.10 InLeapYear ( tv )
The abstract operation InLeapYear takes argument tv (a
DaysInYear (YearFromTime (tv))が366 𝔽なら、1 𝔽を返す。+0 𝔽を返す。
21.4.1.11 MonthFromTime ( tv )
The abstract operation MonthFromTime takes argument tv (a
- inLeapYearを
InLeapYear (tv)とする。 - dayWithinYearを
DayWithinYear (tv)とする。 - dayWithinYear <
31 𝔽なら、+0 𝔽を返す。 - dayWithinYear <
59 𝔽 + inLeapYearなら、1 𝔽を返す。 - dayWithinYear <
90 𝔽 + inLeapYearなら、2 𝔽を返す。 - dayWithinYear <
120 𝔽 + inLeapYearなら、3 𝔽を返す。 - dayWithinYear <
151 𝔽 + inLeapYearなら、4 𝔽を返す。 - dayWithinYear <
181 𝔽 + inLeapYearなら、5 𝔽を返す。 - dayWithinYear <
212 𝔽 + inLeapYearなら、6 𝔽を返す。 - dayWithinYear <
243 𝔽 + inLeapYearなら、7 𝔽を返す。 - dayWithinYear <
273 𝔽 + inLeapYearなら、8 𝔽を返す。 - dayWithinYear <
304 𝔽 + inLeapYearなら、9 𝔽を返す。 - dayWithinYear <
334 𝔽 + inLeapYearなら、10 𝔽を返す。 Assert : dayWithinYear <365 𝔽 + inLeapYearである。11 𝔽を返す。
21.4.1.12 DateFromTime ( tv )
The abstract operation DateFromTime takes argument tv (a
- inLeapYearを
InLeapYear (tv)とする。 - dayWithinYearを
DayWithinYear (tv)とする。 - monthを
MonthFromTime (tv)とする。 - monthが
+0 𝔽なら、dayWithinYear +1 𝔽を返す。 - monthが
1 𝔽なら、dayWithinYear -30 𝔽を返す。 - monthが
2 𝔽なら、dayWithinYear -58 𝔽 - inLeapYearを返す。 - monthが
3 𝔽なら、dayWithinYear -89 𝔽 - inLeapYearを返す。 - monthが
4 𝔽なら、dayWithinYear -119 𝔽 - inLeapYearを返す。 - monthが
5 𝔽なら、dayWithinYear -150 𝔽 - inLeapYearを返す。 - monthが
6 𝔽なら、dayWithinYear -180 𝔽 - inLeapYearを返す。 - monthが
7 𝔽なら、dayWithinYear -211 𝔽 - inLeapYearを返す。 - monthが
8 𝔽なら、dayWithinYear -242 𝔽 - inLeapYearを返す。 - monthが
9 𝔽なら、dayWithinYear -272 𝔽 - inLeapYearを返す。 - monthが
10 𝔽なら、dayWithinYear -303 𝔽 - inLeapYearを返す。 Assert : monthは11 𝔽である。- dayWithinYear -
333 𝔽 - inLeapYearを返す。
21.4.1.13 WeekDay ( tv )
The abstract operation WeekDay takes argument tv (a
21.4.1.14 HourFromTime ( tv )
The abstract operation HourFromTime takes argument tv (a
21.4.1.15 MinFromTime ( tv )
The abstract operation MinFromTime takes argument tv (a
𝔽 (floor (ℝ (tv /msPerMinute ))modulo MinutesPerHour )を返す。
21.4.1.16 SecFromTime ( tv )
The abstract operation SecFromTime takes argument tv (a
𝔽 (floor (ℝ (tv /msPerSecond ))modulo SecondsPerMinute )を返す。
21.4.1.17 msFromTime ( tv )
The abstract operation msFromTime takes argument tv (a
𝔽 (ℝ (tv)modulo ℝ (msPerSecond ))を返す。
21.4.1.18 GetUTCEpochNanoseconds ( year, month, day, hour, minute, second, millisecond, microsecond, nanosecond )
The abstract operation GetUTCEpochNanoseconds takes arguments year (an
21.4.1.19 Time Zone Identifiers
ECMAScriptにおけるtime zonesは、time zone identifiersによって表されます。これは、0x0000から0x007Fまでの
primary time zone identifierは、available named time zoneのpreferred identifierです。 non-primary time zone identifierは、primary time zone identifierではないavailable named time zoneのidentifierです。 available named time zone identifierは、primary time zone identifierまたはnon-primary time zone identifierのいずれかです。 各available named time zone identifierは、exactly one available named time zoneにassociatedされます。 各available named time zoneは、exactly one primary time zone identifierおよびzero or more non-primary time zone identifiersにassociatedされます。
ECMAScript implementationsは、identifier
ECMA-402 Internationalization API specificationで記述されるtime zonesのrequirementsに従うimplementationsは、time zone awareと呼ばれます。
Time zone aware implementationsは、IANA Time Zone DatabaseのZoneおよび
21.4.1.20 GetNamedTimeZoneEpochNanoseconds ( timeZoneIdentifier, year, month, day, hour, minute, second, millisecond, microsecond, nanosecond )
The
inputがnegative time zone transitionのために複数回発生するlocal timeを表す場合（例えばdaylight saving timeが終了するとき、またはtime zone rule changeによりtime zone offsetがdecreasedされるとき）、返される
time zonesに関するlocal political rulesを含まないECMAScript implementationsで使用されるGetNamedTimeZoneEpochNanosecondsのdefault implementationは、呼び出されたとき次のstepsを実行します：
Assert : timeZoneIdentifierは"UTC" である。- epochNanosecondsを
GetUTCEpochNanoseconds (year, month, day, hour, minute, second, millisecond, microsecond, nanosecond)とする。 - « epochNanoseconds »を返す。
America/New_Yorkにおける2017年11月5日の1:30 AMは2回repeatedされるため、GetNamedTimeZoneEpochNanoseconds(
America/New_Yorkにおける2017年3月12日の2:30 AMは存在しないため、GetNamedTimeZoneEpochNanoseconds(
21.4.1.21 GetNamedTimeZoneOffsetNanoseconds ( timeZoneIdentifier, epochNanoseconds )
The
返される
time zonesに関するlocal political rulesを含まないECMAScript implementationsで使用されるGetNamedTimeZoneOffsetNanosecondsのdefault implementationは、呼び出されたとき次のstepsを実行します：
Assert : timeZoneIdentifierは"UTC" である。- 0を返す。
Time zone offset valuesはpositiveまたはnegativeであり得ます。
21.4.1.22 Time Zone Identifier Record
Time Zone Identifier Recordは、
Time Zone Identifier Recordsは、
| Field Name | Value | Meaning |
|---|---|---|
| [[Identifier]] | a String | implementationによってsupportされる |
| [[PrimaryIdentifier]] | a String | [[Identifier]]がresolveする |
[[Identifier]]が
21.4.1.23 AvailableNamedTimeZoneIdentifiers ( )
The
ECMA-402 Internationalization APIをimplementするすべてのimplementationsを含む
- implementationがtime zonesに関するlocal political rulesをまったく含まないなら、
- « the
Time Zone Identifier Record { [[Identifier]]:"UTC" , [[PrimaryIdentifier]]:"UTC" } »を返す。
- « the
- identifiersを、
lexicographic code unit order に従ってsortedされた、uniqueavailable named time zone identifiers のList とする。 - resultを新しい空の
List とする。 - identifiersの各要素identifierについて、以下を行う
- primaryをidentifierとする。
- identifierがこのimplementation内の
non-primary time zone identifier であり、かつidentifierが"UTC" でないなら、- primaryをidentifierにassociatedされた
primary time zone identifier に設定する。 NOTE : implementationはprimary time zone identifier をobtainするためにidentifierをiterativelyにresolveする必要がある場合がある。
- primaryをidentifierにassociatedされた
- recordを
Time Zone Identifier Record { [[Identifier]]: identifier, [[PrimaryIdentifier]]: primary }とする。 - recordをresultへappendする。
Assert : resultは、record.[[Identifier]]が"UTC" であり、record.[[PrimaryIdentifier]]が"UTC" であるようなTime Zone Identifier Record recordを含む。- resultを返す。
21.4.1.24 SystemTimeZoneIdentifier ( )
The
- implementationがUTC time zoneのみをsupportするなら、
"UTC" を返す。 - systemTimeZoneStringを、host environmentのcurrent time zoneを表すString、すなわち
primary time zone identifier またはoffset time zone identifierとする。 - systemTimeZoneStringを返す。
implementationsがDate objectのmethodsにおいてcommonlyに提供するlevel of functionalityをensureするため、SystemTimeZoneIdentifierは、そのようなものが存在する場合、host environmentのtime zone settingに対応するIANA time zone nameを返すことがrecommendedされます。
例えば、host environmentが、userがtime zoneとしてUS Eastern Timeを選択したsystem上のbrowserである場合、SystemTimeZoneIdentifierは
21.4.1.25 LocalTime ( tv )
The abstract operation LocalTime takes argument tv (a
- systemTimeZoneIdentifierを
SystemTimeZoneIdentifier ()とする。 IsTimeZoneOffsetString (systemTimeZoneIdentifier)がtrue なら、- offsetNsを
ParseTimeZoneOffsetString (systemTimeZoneIdentifier)とする。
- offsetNsを
- そうでなければ、
- offsetNsを
GetNamedTimeZoneOffsetNanoseconds (systemTimeZoneIdentifier,ℤ (ℝ (tv) × 106))とする。
- offsetNsを
- offsetMsを
truncate (offsetNs / 106)とする。 - tv +
𝔽 (offsetMs)を返す。
local time tvに関するpolitical rulesがimplementation内でavailableでない場合、resultはtvです。なぜなら
異なる2つのinput
21.4.1.26 UTC ( t )
The abstract operation UTC takes argument t (a Number) and returns a
- tが
finite でないなら、NaN を返す。 - systemTimeZoneIdentifierを
SystemTimeZoneIdentifier ()とする。 IsTimeZoneOffsetString (systemTimeZoneIdentifier)がtrue なら、- offsetNsを
ParseTimeZoneOffsetString (systemTimeZoneIdentifier)とする。
- offsetNsを
- そうでなければ、
- possibleInstantsを
GetNamedTimeZoneEpochNanoseconds (systemTimeZoneIdentifier,ℝ (YearFromTime (t)),ℝ (MonthFromTime (t)) + 1,ℝ (DateFromTime (t)),ℝ (HourFromTime (t)),ℝ (MinFromTime (t)),ℝ (SecFromTime (t)),ℝ (msFromTime (t)), 0, 0)とする。 NOTE : 以下のstepsは、tがnegative time zone transition（例えばdaylight saving timeが終了するとき、またはtime zone rule changeによりtime zone offsetがdecreasedされるとき）で複数回repeatingするlocal time、またはpositive time zone transition（例えばdaylight saving timeが開始するとき、またはtime zone rule changeによりtime zone offsetがincreasedされるとき）でskippedされるlocal timeを表す場合、tがtransition前のtime zone offsetを使用してinterpretedされることをensureする。- possibleInstantsがemptyでないなら、
- disambiguatedInstantをpossibleInstants[0]とする。
- そうでなければ、
NOTE : tはpositive time zone transitionでskippedされたlocal timeを表す（例えばdaylight saving timeの開始、またはUTC offsetをincreaseするtime zone rule changeによる）。- possibleInstantsBeforeを
GetNamedTimeZoneEpochNanoseconds (systemTimeZoneIdentifier,ℝ (YearFromTime (tBefore)),ℝ (MonthFromTime (tBefore)) + 1,ℝ (DateFromTime (tBefore)),ℝ (HourFromTime (tBefore)),ℝ (MinFromTime (tBefore)),ℝ (SecFromTime (tBefore)),ℝ (msFromTime (tBefore)), 0, 0)とする。ここで、tBeforeはpossibleInstantsBeforeがemptyでないようなt未満のlargestintegral Number である（すなわち、tBeforeはtransition前のlast local timeを表す）。 - disambiguatedInstantをpossibleInstantsBeforeのlast elementとする。
- offsetNsを
GetNamedTimeZoneOffsetNanoseconds (systemTimeZoneIdentifier, disambiguatedInstant)とする。
- possibleInstantsを
- offsetMsを
truncate (offsetNs / 106)とする。 - t -
𝔽 (offsetMs)を返す。
Input tはnominallyには
local time tに関するpolitical rulesがimplementation内でavailableでない場合、resultはtです。なぜなら
America/New_Yorkにおける2017年11月5日の1:30 AMは2回repeatedされます（fall backward）が、1:30 AM UTC-05ではなく1:30 AM UTC-04としてinterpretedされなければなりません。
UTC(
America/New_Yorkにおける2017年3月12日の2:30 AMは存在しませんが、2:30 AM UTC-05（3:30 AM UTC-04にequivalent）としてinterpretedされなければなりません。
UTC(
21.4.1.27 MakeTime ( hour, min, sec, ms )
The abstract operation MakeTime takes arguments hour (a Number), min (a Number), sec (a Number), and ms (a Number) and returns a Number. millisecondsの数をcalculateします。 It performs the following steps when called:
- hourが
finite でない、minがfinite でない、secがfinite でない、またはmsがfinite でないなら、NaN を返す。 - hを
𝔽 (!ToIntegerOrInfinity (hour))とする。 - mを
𝔽 (!ToIntegerOrInfinity (min))とする。 - sを
𝔽 (!ToIntegerOrInfinity (sec))とする。 - milliを
𝔽 (!ToIntegerOrInfinity (ms))とする。 - ((h ×
msPerHour + m ×msPerMinute ) + s ×msPerSecond ) + milliを返す。
MakeTime内のarithmeticはfloating-point arithmeticであり、associativeではないため、operationsはcorrect orderでperformされなければなりません。
21.4.1.28 MakeDay ( year, month, date )
The abstract operation MakeDay takes arguments year (a Number), month (a Number), and date (a Number) and returns a
- yearが
finite でない、monthがfinite でない、またはdateがfinite でないなら、NaN を返す。 - yを
𝔽 (!ToIntegerOrInfinity (year))とする。 - mを
𝔽 (!ToIntegerOrInfinity (month))とする。 - dtを
𝔽 (!ToIntegerOrInfinity (date))とする。 - ymをy +
𝔽 (floor (ℝ (m) / 12))とする。 - ymが
finite でないなら、NaN を返す。 - mnを
𝔽 (ℝ (m)modulo 12)とする。 YearFromTime (tv)がymであり、MonthFromTime (tv)がmnであり、DateFromTime (tv)が1 𝔽であるようなfinite time value tvを見つける；ただし、これが可能でない場合（あるargumentがout of rangeであるため）、NaN を返す。Day (tv) + dt -1 𝔽を返す。
21.4.1.29 MakeDate ( day, time )
The abstract operation MakeDate takes arguments day (a Number) and time (a Number) and returns a
21.4.1.30 MakeFullYear ( year )
The abstract operation MakeFullYear takes argument year (a Number) and returns an
- yearが
NaN 、+∞ 𝔽、または-∞ 𝔽のいずれかなら、NaN を返す。 - truncatedを !
ToIntegerOrInfinity (year) とする。 - truncatedが0から99までの
inclusive interval 内にあるなら、1900 𝔽 +𝔽 (truncated)を返す。 𝔽 (truncated)を返す。
21.4.1.31 TimeClip ( time )
The abstract operation TimeClip takes argument time (a Number) and returns a
- timeが
finite でないなら、NaN を返す。 abs (ℝ (time)) > 8.64 × 1015なら、NaN を返す。𝔽 (!ToIntegerOrInfinity (time))を返す。
21.4.1.32 Date Time String Format
ECMAScriptは、ISO 8601 calendar date extended formatのsimplificationに基づくdate-timesのstring interchange formatを定義します。formatは次の通りです：YYYY-MM-DDTHH:mm:ss.sssZ
elementsは次の通りです：
YYYY
|
proleptic Gregorian calendarにおけるyearであり、0000から9999までのfour decimal digits、または |
-
|
|
MM
|
yearのmonthであり、01（January）から12（December）までのtwo decimal digitsです。 |
DD
|
monthのdayであり、01から31までのtwo decimal digitsです。 |
T
|
time elementのbeginningを示すため、 |
HH
|
midnightから経過したcomplete hoursの数であり、00から24までのtwo decimal digitsです。 |
:
|
|
mm
|
hourのstartからのcomplete minutesの数であり、00から59までのtwo decimal digitsです。 |
ss
|
minuteのstartからのcomplete secondsの数であり、00から59までのtwo decimal digitsです。 |
.
|
|
sss
|
secondのstartからのcomplete millisecondsの数であり、three decimal digitsです。 |
Z
|
UTC offset representationであり、HH:mmが続くものとしてspecifiedされます（UTCよりaheadまたはbehindであるlocal timeをそれぞれ示すための |
このformatはdate-only formsを含みます：
YYYY
YYYY-MM
YYYY-MM-DD
また、上記のdate-only formsのいずれかの直後に、optional UTC offset representationがappendedされた以下のtime formsのいずれかが続く“date-time” formsも含みます：
THH:mm
THH:mm:ss
THH:mm:ss.sss
out-of-boundsまたはnonconforming elementsを含むstringは、このformatのvalid instanceではありません。
すべての日はmidnightでstartしmidnightでendするため、notation 00:00および24:00の2つは、one dateにassociatedされ得る2つのmidnightsをdistinguishするためにavailableです。これは、次の2つのnotationsがexactly same point in timeをreferすることを意味します：1995-02-04T24:00および1995-02-05T00:00。後者のformを“calendar dayのend”としてinterpretすることは、そのspecificationがtime intervalsをdescribingするためにreservedし、single points in timeのrepresentations内ではpermitしていないとしても、ISO 8601とconsistentです。
CET、ESTなどのcivil time zonesのabbreviationsをspecifyするinternational standardは存在せず、ときには同じabbreviationが非常に異なる2つのtime zonesに使用されることすらあります。この理由により、ISO 8601とこのformatの両方は、time zone offsetsのnumeric representationsを指定します。
21.4.1.32.1 Expanded Years
1970年1月1日からforwardまたはbackwardにおよそ273,790年というfull Date.parse
expanded yearsを持つdate-
| -271821-04-20T00:00:00Z | 271822 B.C. |
| -000001-01-01T00:00:00Z | 2 B.C. |
| +000000-01-01T00:00:00Z | 1 B.C. |
| +000001-01-01T00:00:00Z | 1 A.D. |
| +001970-01-01T00:00:00Z | 1970 A.D. |
| +002009-12-15T00:00:00Z | 2009 A.D. |
| +275760-09-13T00:00:00Z | 275760 A.D. |
21.4.1.33 Time Zone Offset String Format
ECMAScriptは、ISO 8601からderivedされたUTC offsetsのstring interchange formatを定義します。 formatは以下のgrammarによってdescribedされます。
Syntax
21.4.1.33.1 IsTimeZoneOffsetString ( offsetString )
The abstract operation IsTimeZoneOffsetString takes argument offsetString (a String) and returns a Boolean. return valueは、offsetStringが
21.4.1.33.2 ParseTimeZoneOffsetString ( offsetString )
The abstract operation ParseTimeZoneOffsetString takes argument offsetString (a String) and returns an
- parseResultを
ParseText (offsetString,UTCOffset )とする。 Assert : parseResultはerrorsのList ではない。Assert : parseResultはASCIISign Parse Node を含む。- parsedSignをparseResult内に含まれる
ASCIISign Parse Node にmatchedするsource textとする。 - parsedSignがsingle code point U+002D (HYPHEN-MINUS)なら、
- signを-1とする。
- そうでなければ、
- signを1とする。
NOTE : 以下のStringToNumber のapplicationsはprecisionを失わない。なぜなら、parsed valuesのそれぞれは十分に短いdecimal digitsのstringであることがguaranteedされるからである。Assert : parseResultはHour Parse Node を含む。- parsedHoursをparseResult内に含まれる
Hour Parse Node にmatchedするsource textとする。 - hoursを
ℝ (StringToNumber (CodePointsToString (parsedHours)))とする。 - parseResultが
MinuteSecond Parse Node を含まないなら、- minutesを0とする。
- そうでなければ、
- parsedMinutesをparseResult内に含まれるfirst
MinuteSecond Parse Node にmatchedするsource textとする。 - minutesを
ℝ (StringToNumber (CodePointsToString (parsedMinutes)))とする。
- parsedMinutesをparseResult内に含まれるfirst
- parseResultがtwo
MinuteSecond Parse Nodes を含まないなら、- secondsを0とする。
- そうでなければ、
- parsedSecondsをparseResult内に含まれるsecond
MinuteSecond Parse Node にmatchedするsource textとする。 - secondsを
ℝ (StringToNumber (CodePointsToString (parsedSeconds)))とする。
- parsedSecondsをparseResult内に含まれるsecond
- parseResultが
TemporalDecimalFraction Parse Node を含まないなら、- nanosecondsを0とする。
- そうでなければ、
- parsedFractionをparseResult内に含まれる
TemporalDecimalFraction Parse Node にmatchedするsource textとする。 - fractionを
CodePointsToString (parsedFraction)と"000000000" のstring-concatenation とする。 - nanosecondsStringをfractionの1から10までの
substring とする。 - nanosecondsを
ℝ (StringToNumber (nanosecondsString))とする。
- parsedFractionをparseResult内に含まれる
- sign × (((hours × 60 + minutes) × 60 + seconds) × 109 + nanoseconds)を返す。
21.4.2 The Date Constructor
Date
- %Date%です。
global object の"Date" propertyのinitial valueです。constructor として呼び出されたとき、新しいDateを作成およびinitializeします。constructor としてではなくfunctionとして呼び出されたとき、current time（UTC）を表すStringを返します。- そのbehaviourがargumentsのnumberおよびtypesに基づいて異なるfunctionです。
- class definitionの
extendsclauseのvalueとして使用できます。指定されたDate behaviourをinheritしようとするsubclassconstructors は、[[DateValue]] internal slotを持つsubclass instanceを作成およびinitializeするために、Dateconstructor へのsupercallを含まなければなりません。
21.4.2.1 Date ( ...values )
このfunctionは呼び出されたとき、次のstepsを実行します：
- NewTargetが
undefined なら、- nowをcurrent timeをidentifyする
time value （UTC）とする。 ToDateString (now)を返す。
- nowをcurrent timeをidentifyする
- numberOfArgsをvalues内のelementsの数とする。
- numberOfArgs = 0なら、
- dvをcurrent timeをidentifyする
time value （UTC）とする。
- dvをcurrent timeをidentifyする
- そうでなく、numberOfArgs = 1なら、
- valueをvalues[0]とする。
- valueがObjectであり、valueが[[DateValue]] internal slotを持つなら、
- tvをvalue.[[DateValue]]とする。
- そうでなければ、
- vを ?
ToPrimitive (value) とする。 - vがStringなら、
Assert : vはStringであるため、next stepはabrupt completion を返すことはない。- tvを、
parsemethod（21.4.3.2 ）の場合とexactly same mannerで、vをdateとしてparsingしたresultとする。
- そうでなければ、
- tvを ?
ToNumber (v) とする。
- tvを ?
- vを ?
- dvを
TimeClip (tv)とする。
- そうでなければ、
Assert : numberOfArgs ≥ 2である。- yを ?
ToNumber (values[0]) とする。 - mを ?
ToNumber (values[1]) とする。 - numberOfArgs > 2なら、dtを ?
ToNumber (values[2]) とする；そうでなければ、dtを1 𝔽とする。 - numberOfArgs > 3なら、hを ?
ToNumber (values[3]) とする；そうでなければ、hを+0 𝔽とする。 - numberOfArgs > 4なら、minを ?
ToNumber (values[4]) とする；そうでなければ、minを+0 𝔽とする。 - numberOfArgs > 5なら、sを ?
ToNumber (values[5]) とする；そうでなければ、sを+0 𝔽とする。 - numberOfArgs > 6なら、milliを ?
ToNumber (values[6]) とする；そうでなければ、milliを+0 𝔽とする。 - yrを
MakeFullYear (y)とする。 - finalDateを
MakeDate (MakeDay (yr, m, dt),MakeTime (h, min, s, milli))とする。 - dvを
TimeClip (UTC (finalDate))とする。
- objを ?
OrdinaryCreateFromConstructor (NewTarget,"%Date.prototype%" , « [[DateValue]] ») とする。 - obj.[[DateValue]]をdvに設定する。
- objを返す。
21.4.3 Properties of the Date Constructor
Date
- valueが
%Function.prototype% である[[Prototype]] internal slotを持ちます。 - valueが
7 𝔽である"length" propertyを持ちます。 - 次のpropertiesを持ちます：
21.4.3.1 Date.now ( )
このfunctionは、それへのcallのoccurrenceのUTC dateおよびtimeをdesignateする
21.4.3.2 Date.parse ( string )
このfunctionは、そのargumentに
StringがMMまたはDD elementsがabsentである場合、HH、mm、またはss elementsがabsentである場合、sss elementがabsentである場合、
xが、ECMAScriptの特定のimplementation内でmilliseconds amountがzeroである任意のDateである場合、referencedされるすべてのpropertiesがinitial valuesを持つなら、以下のexpressionsはすべて、そのimplementation内でsame numeric valueをproduceすべきです：
x.valueOf()
Date.parse(x.toString())
Date.parse(x.toUTCString())
Date.parse(x.toISOString())しかし、expression
Date.parse(x.toLocaleString())は、preceding three expressionsとsame Number valueをproduceすることはrequiredではなく、generalに、このfunctionによってproduceされるvalueは、Date Time String Format（toStringまたはtoUTCString methodによってproduceされ得ない任意のString valueが与えられた場合、
21.4.3.3 Date.prototype
Date.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
21.4.3.4 Date.UTC ( year [ , month [ , date [ , hours [ , minutes [ , seconds [ , ms ] ] ] ] ] ] )
このfunctionは呼び出されたとき、次のstepsを実行します：
- yを ?
ToNumber (year) とする。 - monthがpresentなら、mを ?
ToNumber (month) とする；そうでなければ、mを+0 𝔽とする。 - dateがpresentなら、dtを ?
ToNumber (date) とする；そうでなければ、dtを1 𝔽とする。 - hoursがpresentなら、hを ?
ToNumber (hours) とする；そうでなければ、hを+0 𝔽とする。 - minutesがpresentなら、minを ?
ToNumber (minutes) とする；そうでなければ、minを+0 𝔽とする。 - secondsがpresentなら、sを ?
ToNumber (seconds) とする；そうでなければ、sを+0 𝔽とする。 - msがpresentなら、milliを ?
ToNumber (ms) とする；そうでなければ、milliを+0 𝔽とする。 - yrを
MakeFullYear (y)とする。 TimeClip (MakeDate (MakeDay (yr, m, dt),MakeTime (h, min, s, milli)))を返す。
このfunctionの
このfunctionはDate
21.4.4 Properties of the Date Prototype Object
Date prototype objectは：
- %Date.prototype%です。
- それ自体が
ordinary object です。 - Date instanceではなく、[[DateValue]] internal slotを持ちません。
- valueが
%Object.prototype% である[[Prototype]] internal slotを持ちます。
明示的に別途定義されない限り、以下で定義されるDate prototype objectのmethodsはgenericではなく、それらに渡される
21.4.4.1 Date.prototype.constructor
Date.prototype.constructorのinitial valueは
21.4.4.2 Date.prototype.getDate ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- tvが
NaN なら、NaN を返す。 DateFromTime (LocalTime (tv))を返す。
21.4.4.3 Date.prototype.getDay ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- tvが
NaN なら、NaN を返す。 WeekDay (LocalTime (tv))を返す。
21.4.4.4 Date.prototype.getFullYear ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- tvが
NaN なら、NaN を返す。 YearFromTime (LocalTime (tv))を返す。
21.4.4.5 Date.prototype.getHours ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- tvが
NaN なら、NaN を返す。 HourFromTime (LocalTime (tv))を返す。
21.4.4.6 Date.prototype.getMilliseconds ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- tvが
NaN なら、NaN を返す。 msFromTime (LocalTime (tv))を返す。
21.4.4.7 Date.prototype.getMinutes ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- tvが
NaN なら、NaN を返す。 MinFromTime (LocalTime (tv))を返す。
21.4.4.8 Date.prototype.getMonth ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- tvが
NaN なら、NaN を返す。 MonthFromTime (LocalTime (tv))を返す。
21.4.4.9 Date.prototype.getSeconds ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- tvが
NaN なら、NaN を返す。 SecFromTime (LocalTime (tv))を返す。
21.4.4.10 Date.prototype.getTime ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - dateObj.[[DateValue]]を返す。
21.4.4.11 Date.prototype.getTimezoneOffset ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- tvが
NaN なら、NaN を返す。 - (tv -
LocalTime (tv)) /msPerMinute を返す。
21.4.4.12 Date.prototype.getUTCDate ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- tvが
NaN なら、NaN を返す。 DateFromTime (tv)を返す。
21.4.4.13 Date.prototype.getUTCDay ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- tvが
NaN なら、NaN を返す。 WeekDay (tv)を返す。
21.4.4.14 Date.prototype.getUTCFullYear ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- tvが
NaN なら、NaN を返す。 YearFromTime (tv)を返す。
21.4.4.15 Date.prototype.getUTCHours ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- tvが
NaN なら、NaN を返す。 HourFromTime (tv)を返す。
21.4.4.16 Date.prototype.getUTCMilliseconds ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- tvが
NaN なら、NaN を返す。 msFromTime (tv)を返す。
21.4.4.17 Date.prototype.getUTCMinutes ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- tvが
NaN なら、NaN を返す。 MinFromTime (tv)を返す。
21.4.4.18 Date.prototype.getUTCMonth ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- tvが
NaN なら、NaN を返す。 MonthFromTime (tv)を返す。
21.4.4.19 Date.prototype.getUTCSeconds ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- tvが
NaN なら、NaN を返す。 SecFromTime (tv)を返す。
21.4.4.20 Date.prototype.setDate ( date )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- dtを ?
ToNumber (date) とする。 - tvが
NaN なら、NaN を返す。 - tvを
LocalTime (tv)に設定する。 - newDateを
MakeDate (MakeDay (YearFromTime (tv),MonthFromTime (tv), dt),TimeWithinDay (tv))とする。 - uを
TimeClip (UTC (newDate))とする。 - dateObj.[[DateValue]]をuに設定する。
- uを返す。
21.4.4.21 Date.prototype.setFullYear ( year [ , month [ , date ] ] )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- yを ?
ToNumber (year) とする。 - tvが
NaN なら、tvを+0 𝔽に設定する；そうでなければ、tvをLocalTime (tv)に設定する。 - monthがpresentなら、mを ?
ToNumber (month) とする；そうでなければ、mをMonthFromTime (tv)とする。 - dateがpresentなら、dtを ?
ToNumber (date) とする；そうでなければ、dtをDateFromTime (tv)とする。 - newDateを
MakeDate (MakeDay (y, m, dt),TimeWithinDay (tv))とする。 - uを
TimeClip (UTC (newDate))とする。 - dateObj.[[DateValue]]をuに設定する。
- uを返す。
このmethodの
monthがpresentでない場合、このmethodはmonthがvalue getMonth()でpresentであったかのようにbehaveします。dateがpresentでない場合、dateがvalue getDate()でpresentであったかのようにbehaveします。
21.4.4.22 Date.prototype.setHours ( hour [ , min [ , sec [ , ms ] ] ] )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- hを ?
ToNumber (hour) とする。 - minがpresentなら、mを ?
ToNumber (min) とする。 - secがpresentなら、sを ?
ToNumber (sec) とする。 - msがpresentなら、milliを ?
ToNumber (ms) とする。 - tvが
NaN なら、NaN を返す。 - tvを
LocalTime (tv)に設定する。 - minがpresentでないなら、mを
MinFromTime (tv)とする。 - secがpresentでないなら、sを
SecFromTime (tv)とする。 - msがpresentでないなら、milliを
msFromTime (tv)とする。 - dateを
MakeDate (Day (tv),MakeTime (h, m, s, milli))とする。 - uを
TimeClip (UTC (date))とする。 - dateObj.[[DateValue]]をuに設定する。
- uを返す。
このmethodの
minがpresentでない場合、このmethodはminがvalue getMinutes()でpresentであったかのようにbehaveします。secがpresentでない場合、secがvalue getSeconds()でpresentであったかのようにbehaveします。msがpresentでない場合、msがvalue getMilliseconds()でpresentであったかのようにbehaveします。
21.4.4.23 Date.prototype.setMilliseconds ( ms )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- msを ?
ToNumber (ms) に設定する。 - tvが
NaN なら、NaN を返す。 - tvを
LocalTime (tv)に設定する。 - timeを
MakeTime (HourFromTime (tv),MinFromTime (tv),SecFromTime (tv), ms)とする。 - uを
TimeClip (UTC (MakeDate (Day (tv), time)))とする。 - dateObj.[[DateValue]]をuに設定する。
- uを返す。
21.4.4.24 Date.prototype.setMinutes ( min [ , sec [ , ms ] ] )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- mを ?
ToNumber (min) とする。 - secがpresentなら、sを ?
ToNumber (sec) とする。 - msがpresentなら、milliを ?
ToNumber (ms) とする。 - tvが
NaN なら、NaN を返す。 - tvを
LocalTime (tv)に設定する。 - secがpresentでないなら、sを
SecFromTime (tv)とする。 - msがpresentでないなら、milliを
msFromTime (tv)とする。 - dateを
MakeDate (Day (tv),MakeTime (HourFromTime (tv), m, s, milli))とする。 - uを
TimeClip (UTC (date))とする。 - dateObj.[[DateValue]]をuに設定する。
- uを返す。
このmethodの
secがpresentでない場合、このmethodはsecがvalue getSeconds()でpresentであったかのようにbehaveします。msがpresentでない場合、これはmsがvalue getMilliseconds()でpresentであったかのようにbehaveします。
21.4.4.25 Date.prototype.setMonth ( month [ , date ] )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- mを ?
ToNumber (month) とする。 - dateがpresentなら、dtを ?
ToNumber (date) とする。 - tvが
NaN なら、NaN を返す。 - tvを
LocalTime (tv)に設定する。 - dateがpresentでないなら、dtを
DateFromTime (tv)とする。 - newDateを
MakeDate (MakeDay (YearFromTime (tv), m, dt),TimeWithinDay (tv))とする。 - uを
TimeClip (UTC (newDate))とする。 - dateObj.[[DateValue]]をuに設定する。
- uを返す。
このmethodの
dateがpresentでない場合、このmethodはdateがvalue getDate()でpresentであったかのようにbehaveします。
21.4.4.26 Date.prototype.setSeconds ( sec [ , ms ] )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- sを ?
ToNumber (sec) とする。 - msがpresentなら、milliを ?
ToNumber (ms) とする。 - tvが
NaN なら、NaN を返す。 - tvを
LocalTime (tv)に設定する。 - msがpresentでないなら、milliを
msFromTime (tv)とする。 - dateを
MakeDate (Day (tv),MakeTime (HourFromTime (tv),MinFromTime (tv), s, milli))とする。 - uを
TimeClip (UTC (date))とする。 - dateObj.[[DateValue]]をuに設定する。
- uを返す。
このmethodの
msがpresentでない場合、このmethodはmsがvalue getMilliseconds()でpresentであったかのようにbehaveします。
21.4.4.27 Date.prototype.setTime ( time )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tを ?
ToNumber (time) とする。 - vを
TimeClip (t)とする。 - dateObj.[[DateValue]]をvに設定する。
- vを返す。
21.4.4.28 Date.prototype.setUTCDate ( date )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- dtを ?
ToNumber (date) とする。 - tvが
NaN なら、NaN を返す。 - newDateを
MakeDate (MakeDay (YearFromTime (tv),MonthFromTime (tv), dt),TimeWithinDay (tv))とする。 - vを
TimeClip (newDate)とする。 - dateObj.[[DateValue]]をvに設定する。
- vを返す。
21.4.4.29 Date.prototype.setUTCFullYear ( year [ , month [ , date ] ] )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- tvが
NaN なら、tvを+0 𝔽に設定する。 - yを ?
ToNumber (year) とする。 - monthがpresentなら、mを ?
ToNumber (month) とする；そうでなければ、mをMonthFromTime (tv)とする。 - dateがpresentなら、dtを ?
ToNumber (date) とする；そうでなければ、dtをDateFromTime (tv)とする。 - newDateを
MakeDate (MakeDay (y, m, dt),TimeWithinDay (tv))とする。 - vを
TimeClip (newDate)とする。 - dateObj.[[DateValue]]をvに設定する。
- vを返す。
このmethodの
monthがpresentでない場合、このmethodはmonthがvalue getUTCMonth()でpresentであったかのようにbehaveします。dateがpresentでない場合、dateがvalue getUTCDate()でpresentであったかのようにbehaveします。
21.4.4.30 Date.prototype.setUTCHours ( hour [ , min [ , sec [ , ms ] ] ] )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- hを ?
ToNumber (hour) とする。 - minがpresentなら、mを ?
ToNumber (min) とする。 - secがpresentなら、sを ?
ToNumber (sec) とする。 - msがpresentなら、milliを ?
ToNumber (ms) とする。 - tvが
NaN なら、NaN を返す。 - minがpresentでないなら、mを
MinFromTime (tv)とする。 - secがpresentでないなら、sを
SecFromTime (tv)とする。 - msがpresentでないなら、milliを
msFromTime (tv)とする。 - dateを
MakeDate (Day (tv),MakeTime (h, m, s, milli))とする。 - vを
TimeClip (date)とする。 - dateObj.[[DateValue]]をvに設定する。
- vを返す。
このmethodの
minがpresentでない場合、このmethodはminがvalue getUTCMinutes()でpresentであったかのようにbehaveします。secがpresentでない場合、secがvalue getUTCSeconds()でpresentであったかのようにbehaveします。msがpresentでない場合、msがvalue getUTCMilliseconds()でpresentであったかのようにbehaveします。
21.4.4.31 Date.prototype.setUTCMilliseconds ( ms )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- msを ?
ToNumber (ms) に設定する。 - tvが
NaN なら、NaN を返す。 - timeを
MakeTime (HourFromTime (tv),MinFromTime (tv),SecFromTime (tv), ms)とする。 - vを
TimeClip (MakeDate (Day (tv), time))とする。 - dateObj.[[DateValue]]をvに設定する。
- vを返す。
21.4.4.32 Date.prototype.setUTCMinutes ( min [ , sec [ , ms ] ] )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- mを ?
ToNumber (min) とする。 - secがpresentなら、sを ?
ToNumber (sec) とする。 - msがpresentなら、milliを ?
ToNumber (ms) とする。 - tvが
NaN なら、NaN を返す。 - secがpresentでないなら、sを
SecFromTime (tv)とする。 - msがpresentでないなら、milliを
msFromTime (tv)とする。 - dateを
MakeDate (Day (tv),MakeTime (HourFromTime (tv), m, s, milli))とする。 - vを
TimeClip (date)とする。 - dateObj.[[DateValue]]をvに設定する。
- vを返す。
このmethodの
secがpresentでない場合、このmethodはsecがvalue getUTCSeconds()でpresentであったかのようにbehaveします。msがpresentでない場合、msがgetUTCMilliseconds()によって返されるvalueでpresentであったかのようにbehaveします。
21.4.4.33 Date.prototype.setUTCMonth ( month [ , date ] )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- mを ?
ToNumber (month) とする。 - dateがpresentなら、dtを ?
ToNumber (date) とする。 - tvが
NaN なら、NaN を返す。 - dateがpresentでないなら、dtを
DateFromTime (tv)とする。 - newDateを
MakeDate (MakeDay (YearFromTime (tv), m, dt),TimeWithinDay (tv))とする。 - vを
TimeClip (newDate)とする。 - dateObj.[[DateValue]]をvに設定する。
- vを返す。
このmethodの
dateがpresentでない場合、このmethodはdateがvalue getUTCDate()でpresentであったかのようにbehaveします。
21.4.4.34 Date.prototype.setUTCSeconds ( sec [ , ms ] )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- sを ?
ToNumber (sec) とする。 - msがpresentなら、milliを ?
ToNumber (ms) とする。 - tvが
NaN なら、NaN を返す。 - msがpresentでないなら、milliを
msFromTime (tv)とする。 - dateを
MakeDate (Day (tv),MakeTime (HourFromTime (tv),MinFromTime (tv), s, milli))とする。 - vを
TimeClip (date)とする。 - dateObj.[[DateValue]]をvに設定する。
- vを返す。
このmethodの
msがpresentでない場合、このmethodはmsがvalue getUTCMilliseconds()でpresentであったかのようにbehaveします。
21.4.4.35 Date.prototype.toDateString ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- tvが
NaN なら、"Invalid Date" を返す。 - tを
LocalTime (tv)とする。 DateString (t)を返す。
21.4.4.36 Date.prototype.toISOString ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- tvが
NaN なら、RangeError 例外をthrowする。 Assert : tvはintegral Number である。- tvが
Date Time String Format でrepresentできないyearに対応するなら、RangeError 例外をthrowする。 - UTC time scale上で、すべてのformat elementsおよびUTC offset representation
"Z" を含む、Date Time String Format におけるtvのString representationを返す。
21.4.4.37 Date.prototype.toJSON ( key )
このmethodは、JSON.stringify（
これは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - tvを ?
ToPrimitive (obj,number ) とする。 - tvがNumberであり、かつtvが
finite でないなら、null を返す。 - ?
Invoke (obj,"toISOString" )を返す。
argumentはignoredされます。
このmethodは意図的にgenericです；そのtoISOString methodを持つ必要があります。
21.4.4.38 Date.prototype.toLocaleDateString ( [ reserved1 [ , reserved2 ] ] )
ECMA-402 Internationalization APIを含むECMAScript implementationは、このmethodをECMA-402 specificationで指定される通りにimplementしなければなりません。ECMAScript implementationがECMA-402 APIを含まない場合、このmethodの次のspecificationが使用されます：
このmethodはString valueを返します。Stringのcontentsは
このmethodのoptional parametersのmeaningはECMA-402 specificationで定義されます；ECMA-402 supportを含まないimplementationsは、それらのparameter positionsを他の目的に使用してはなりません。
21.4.4.39 Date.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
ECMA-402 Internationalization APIを含むECMAScript implementationは、このmethodをECMA-402 specificationで指定される通りにimplementしなければなりません。ECMAScript implementationがECMA-402 APIを含まない場合、このmethodの次のspecificationが使用されます：
このmethodはString valueを返します。Stringのcontentsは
このmethodのoptional parametersのmeaningはECMA-402 specificationで定義されます；ECMA-402 supportを含まないimplementationsは、それらのparameter positionsを他の目的に使用してはなりません。
21.4.4.40 Date.prototype.toLocaleTimeString ( [ reserved1 [ , reserved2 ] ] )
ECMA-402 Internationalization APIを含むECMAScript implementationは、このmethodをECMA-402 specificationで指定される通りにimplementしなければなりません。ECMAScript implementationがECMA-402 APIを含まない場合、このmethodの次のspecificationが使用されます：
このmethodはString valueを返します。Stringのcontentsは
このmethodのoptional parametersのmeaningはECMA-402 specificationで定義されます；ECMA-402 supportを含まないimplementationsは、それらのparameter positionsを他の目的に使用してはなりません。
21.4.4.41 Date.prototype.toString ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
ToDateString (tv)を返す。
d.[[DateValue]]が1000でevenly divisibleである任意のDate dについて、Date.parse(d.toString()) = d.valueOf()のresultになります。
このmethodはgenericではありません；その
21.4.4.41.1 TimeString ( tv )
The abstract operation TimeString takes argument tv (a Number, but not
- hourを
ToZeroPaddedDecimalString (ℝ (HourFromTime (tv)), 2)とする。 - minuteを
ToZeroPaddedDecimalString (ℝ (MinFromTime (tv)), 2)とする。 - secondを
ToZeroPaddedDecimalString (ℝ (SecFromTime (tv)), 2)とする。 - hour、
":" 、minute、":" 、second、code unit 0x0020 (SPACE)、および"GMT" のstring-concatenation を返す。
21.4.4.41.2 DateString ( tv )
The abstract operation DateString takes argument tv (a Number, but not
- weekdayを、
WeekDay (tv)のNumberを持つTable 61 内のentryのNameとする。 - monthを、
MonthFromTime (tv)のNumberを持つTable 62 内のentryのNameとする。 - dayを
ToZeroPaddedDecimalString (ℝ (DateFromTime (tv)), 2)とする。 - yvを
YearFromTime (tv)とする。 - yvが
+0 𝔽またはyv >+0 𝔽なら、yearSignをempty Stringとする；そうでなければ、yearSignを"-" とする。 - paddedYearを
ToZeroPaddedDecimalString (abs (ℝ (yv)), 4)とする。 - weekday、code unit 0x0020 (SPACE)、month、code unit 0x0020 (SPACE)、day、code unit 0x0020 (SPACE)、yearSign、およびpaddedYearの
string-concatenation を返す。
| Number | Name |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Number | Name |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
21.4.4.41.3 TimeZoneString ( tv )
The abstract operation TimeZoneString takes argument tv (an
- systemTimeZoneIdentifierを
SystemTimeZoneIdentifier ()とする。 IsTimeZoneOffsetString (systemTimeZoneIdentifier)がtrue なら、- offsetNsを
ParseTimeZoneOffsetString (systemTimeZoneIdentifier)とする。
- offsetNsを
- そうでなければ、
- offsetNsを
GetNamedTimeZoneOffsetNanoseconds (systemTimeZoneIdentifier,ℤ (ℝ (tv) × 106))とする。
- offsetNsを
- offsetを
𝔽 (truncate (offsetNs / 106))とする。 - offsetが
+0 𝔽またはoffset >+0 𝔽なら、- offsetSignを
"+" とする。 - absOffsetをoffsetとする。
- offsetSignを
- そうでなければ、
- offsetSignを
"-" とする。 - absOffsetを-offsetとする。
- offsetSignを
- offsetMinを
ToZeroPaddedDecimalString (ℝ (MinFromTime (absOffset)), 2)とする。 - offsetHourを
ToZeroPaddedDecimalString (ℝ (HourFromTime (absOffset)), 2)とする。 - tzNameを、empty String、またはcode unit 0x0020 (SPACE)、code unit 0x0028 (LEFT PARENTHESIS)、
implementation-defined timezone name、およびcode unit 0x0029 (RIGHT PARENTHESIS)のstring-concatenation のいずれかであるimplementation-defined stringとする。 - offsetSign、offsetHour、offsetMin、およびtzNameの
string-concatenation を返す。
21.4.4.41.4 ToDateString ( tv )
The abstract operation ToDateString takes argument tv (an
- tvが
NaN なら、"Invalid Date" を返す。 - localTimeを
LocalTime (tv)とする。 DateString (localTime)、code unit 0x0020 (SPACE)、TimeString (localTime)、およびTimeZoneString (tv)のstring-concatenation を返す。
21.4.4.42 Date.prototype.toTimeString ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- tvが
NaN なら、"Invalid Date" を返す。 - localTimeを
LocalTime (tv)とする。 TimeString (localTime)とTimeZoneString (tv)のstring-concatenation を返す。
21.4.4.43 Date.prototype.toUTCString ( )
このmethodは、HTTP-dateに基づき、ECMAScript Datesによってsupportされるfull range of timesをsupportするようgeneralizedされています。
これは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- tvが
NaN なら、"Invalid Date" を返す。 - weekdayを、
WeekDay (tv)のNumberを持つTable 61 内のentryのNameとする。 - monthを、
MonthFromTime (tv)のNumberを持つTable 62 内のentryのNameとする。 - dayを
ToZeroPaddedDecimalString (ℝ (DateFromTime (tv)), 2)とする。 - yvを
YearFromTime (tv)とする。 - yvが
+0 𝔽またはyv >+0 𝔽なら、yearSignをempty Stringとする；そうでなければ、yearSignを"-" とする。 - paddedYearを
ToZeroPaddedDecimalString (abs (ℝ (yv)), 4)とする。 - weekday、
"," 、code unit 0x0020 (SPACE)、day、code unit 0x0020 (SPACE)、month、code unit 0x0020 (SPACE)、yearSign、paddedYear、code unit 0x0020 (SPACE)、およびTimeString (tv)のstring-concatenation を返す。
21.4.4.44 Date.prototype.valueOf ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - dateObj.[[DateValue]]を返す。
21.4.4.45 Date.prototype [ %Symbol.toPrimitive% ] ( hint )
このmethodは、Dateをprimitive valueへconvertするためにECMAScript language operatorsによって呼び出されます。hintにallowedなvaluesは
これは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - objがObjectでないなら、
TypeError 例外をthrowする。 - hintが
"string" または"default" のいずれかなら、- tryFirstを
string とする。
- tryFirstを
- そうでなく、hintが
"number" なら、- tryFirstを
number とする。
- tryFirstを
- そうでなければ、
TypeError 例外をThrowする。
- ?
OrdinaryToPrimitive (obj, tryFirst)を返す。
このpropertyはattributes { [[Writable]]:
このmethodの
21.4.5 Properties of Date Instances
Date instancesは、
22 Text Processing
22.1 String Objects
22.1.1 The String Constructor
String
- %String%です。
global object の"String" propertyのinitial valueです。constructor として呼び出されたとき、新しいString objectを作成およびinitializeします。constructor としてではなくfunctionとして呼び出されたとき、type conversionを実行します。- class definitionの
extendsclauseのvalueとして使用できます。指定されたString behaviourをinheritしようとするsubclassconstructors は、[[StringData]] internal slotを持つsubclass instanceを作成およびinitializeするために、Stringconstructor へのsupercallを含まなければなりません。
22.1.1.1 String ( value )
このfunctionは呼び出されたとき、次のstepsを実行します：
- valueがpresentでないなら、
- stringをempty Stringとする。
- そうでなければ、
- NewTargetが
undefined であり、かつvalueがSymbolなら、SymbolDescriptiveString (value)を返す。 - stringを ?
ToString (value) とする。
- NewTargetが
- NewTargetが
undefined なら、stringを返す。 StringCreate (string, ?GetPrototypeFromConstructor (NewTarget,"%String.prototype%" ))を返す。
22.1.2 Properties of the String Constructor
String
- valueが
%Function.prototype% である[[Prototype]] internal slotを持ちます。 - 次のpropertiesを持ちます：
22.1.2.1 String.fromCharCode ( ...codeUnits )
このfunctionは、rest parameter codeUnitsを形成する任意の数のargumentsで呼び出すことができます。
これは呼び出されたとき、次のstepsを実行します：
- resultをempty Stringとする。
- codeUnitsの各要素nextについて、以下を行う
- nextCUを、numeric valueが
ℝ (?ToUint16 (next))であるcode unitとする。 - resultをresultとnextCUの
string-concatenation に設定する。
- nextCUを、numeric valueが
- resultを返す。
このfunctionの
22.1.2.2 String.fromCodePoint ( ...codePoints )
このfunctionは、rest parameter codePointsを形成する任意の数のargumentsで呼び出すことができます。
これは呼び出されたとき、次のstepsを実行します：
- resultをempty Stringとする。
- codePointsの各要素nextについて、以下を行う
- nextCPを ?
ToNumber (next) とする。 - nextCPが
integral Number でないなら、RangeError 例外をthrowする。 ℝ (nextCP) < 0またはℝ (nextCP) > 0x10FFFFなら、RangeError 例外をthrowする。- resultをresultと
UTF16EncodeCodePoint (ℝ (nextCP))のstring-concatenation に設定する。
- nextCPを ?
Assert : codePointsがemptyなら、resultはempty Stringである。- resultを返す。
このfunctionの
22.1.2.3 String.prototype
String.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
22.1.2.4 String.raw ( template, ...substitutions )
このfunctionはvariable number of argumentsで呼び出すことができます。first argumentはtemplateであり、remaining argumentsは
これは呼び出されたとき、次のstepsを実行します：
- substitutionCountをsubstitutions内のelementsの数とする。
- cookedを ?
ToObject (template) とする。 - literalsを ?
ToObject (?Get (cooked,"raw" )) とする。 - literalCountを ?
LengthOfArrayLike (literals) とする。 - literalCount ≤ 0なら、empty Stringを返す。
- resultをempty Stringとする。
- nextIndexを0とする。
- 繰り返す：
- nextLiteralValueを ?
Get (literals, !ToString (𝔽 (nextIndex))) とする。 - nextLiteralを ?
ToString (nextLiteralValue) とする。 - resultをresultとnextLiteralの
string-concatenation に設定する。 - nextIndex + 1 = literalCountなら、resultを返す。
- nextIndex < substitutionCountなら、
- nextSubValueをsubstitutions[nextIndex]とする。
- nextSubを ?
ToString (nextSubValue) とする。 - resultをresultとnextSubの
string-concatenation に設定する。
- nextIndexをnextIndex + 1に設定する。
- nextLiteralValueを ?
このfunctionはTagged Template（
22.1.3 Properties of the String Prototype Object
String prototype objectは：
- %String.prototype%です。
String exotic object であり、そのようなobjectsに対して指定されたinternal methodsを持ちます。- valueがempty Stringである[[StringData]] internal slotを持ちます。
- initial valueが
+0 𝔽であり、attributesが { [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:false } である"length" propertyを持ちます。 - valueが
%Object.prototype% である[[Prototype]] internal slotを持ちます。
明示的に別途述べられない限り、以下で定義されるString prototype objectのmethodsはgenericではなく、それらに渡される
22.1.3.1 String.prototype.at ( index )
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - stringを ?
ToString (thisValue) とする。 - lengthをstringのlengthとする。
- relativeIndexを ?
ToIntegerOrInfinity (index) とする。 - relativeIndex ≥ 0なら、
- kをrelativeIndexとする。
- そうでなければ、
- kをlength + relativeIndexとする。
- k < 0またはk ≥ lengthなら、
undefined を返す。 - stringのkからk + 1までの
substring を返す。
22.1.3.2 String.prototype.charAt ( position )
このmethodは、このobjectをStringへconvertしたresultであるString value内のindex positionにあるcode unitを含むsingle element Stringを返します。そのindexにelementが存在しない場合、resultはempty Stringです。resultはString valueであり、String objectではありません。
posがx.charAt(pos)のresultはx.substring(pos, pos + 1)のresultとequivalentです。
このmethodは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - stringを ?
ToString (thisValue) とする。 - positionを ?
ToIntegerOrInfinity (position) に設定する。 - sizeをstringのlengthとする。
- position < 0またはposition ≥ sizeなら、empty Stringを返す。
- stringのpositionからposition + 1までの
substring を返す。
このmethodは意図的にgenericです；その
22.1.3.3 String.prototype.charCodeAt ( position )
このmethodは、このobjectをStringへconvertしたresultであるString内のindex positionにあるcode unitのnumeric valueであるNumber（216未満のnon-negative
このmethodは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - stringを ?
ToString (thisValue) とする。 - positionを ?
ToIntegerOrInfinity (position) に設定する。 - sizeをstringのlengthとする。
- position < 0またはposition ≥ sizeなら、
NaN を返す。 - String string内のindex positionにあるcode unitのnumeric valueに対するNumber valueを返す。
このmethodは意図的にgenericです；その
22.1.3.4 String.prototype.codePointAt ( position )
このmethodは、このobjectをStringへconvertしたresultであるString内のindex positionのstring elementから始まるUTF-16 encoded code point（
このmethodは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - stringを ?
ToString (thisValue) とする。 - positionを ?
ToIntegerOrInfinity (position) に設定する。 - sizeをstringのlengthとする。
- position < 0またはposition ≥ sizeなら、
undefined を返す。 - codePointを
CodePointAt (string, position)とする。 𝔽 (codePoint.[[CodePoint]])を返す。
このmethodは意図的にgenericです；その
22.1.3.5 String.prototype.concat ( ...args )
このmethodが呼び出されると、
このmethodは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - stringを ?
ToString (thisValue) とする。 - resultをstringとする。
- argsの各要素nextについて、以下を行う
- nextStringを ?
ToString (next) とする。 - resultをresultとnextStringの
string-concatenation に設定する。
- nextStringを ?
- resultを返す。
このmethodの
このmethodは意図的にgenericです；その
22.1.3.6 String.prototype.constructor
String.prototype.constructorのinitial valueは
22.1.3.7 String.prototype.endsWith ( searchString [ , endPosition ] )
このmethodは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - stringを ?
ToString (thisValue) とする。 - isRegexpを ?
IsRegExp (searchString) とする。 - isRegexpが
true なら、TypeError 例外をthrowする。 - searchStringを ?
ToString (searchString) に設定する。 - lengthをstringのlengthとする。
- endPositionが
undefined なら、positionをlengthとする；そうでなければ、positionを ?ToIntegerOrInfinity (endPosition) とする。 - endをpositionを0とlengthの間に
clamping したresultとする。 - searchLengthをsearchStringのlengthとする。
- searchLength = 0なら、
true を返す。 - startをend - searchLengthとする。
- start < 0なら、
false を返す。 - substringをstringのstartからendまでの
substring とする。 - substringがsearchStringなら、
true を返す。 false を返す。
first argumentがRegExpである場合にexceptionをthrowすることは、そのようなargument valuesをallowするextensionsをfuture editionsがdefineできるようにするために指定されています。
このmethodは意図的にgenericです；その
22.1.3.8 String.prototype.includes ( searchString [ , position ] )
このmethodは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - stringを ?
ToString (thisValue) とする。 - isRegexpを ?
IsRegExp (searchString) とする。 - isRegexpが
true なら、TypeError 例外をthrowする。 - searchStringを ?
ToString (searchString) に設定する。 - positionIntを ?
ToIntegerOrInfinity (position) とする。 Assert : positionがundefined なら、positionIntは0である。- lengthをstringのlengthとする。
- startをpositionIntを0とlengthの間に
clamping したresultとする。 - indexを
StringIndexOf (string, searchString, start)とする。 - indexが
not-found なら、false を返す。 true を返す。
searchStringが、このobjectをStringへconvertしたresultの
first argumentがRegExpである場合にexceptionをthrowすることは、そのようなargument valuesをallowするextensionsをfuture editionsがdefineできるようにするために指定されています。
このmethodは意図的にgenericです；その
22.1.3.9 String.prototype.indexOf ( searchString [ , position ] )
searchStringが、このobjectをStringへconvertしたresultの
このmethodは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - stringを ?
ToString (thisValue) とする。 - searchStringを ?
ToString (searchString) に設定する。 - positionIntを ?
ToIntegerOrInfinity (position) とする。 Assert : positionがundefined なら、positionIntは0である。- lengthをstringのlengthとする。
- startをpositionIntを0とlengthの間に
clamping したresultとする。 - resultを
StringIndexOf (string, searchString, start)とする。 - resultが
not-found なら、-1 𝔽を返す。 𝔽 (result)を返す。
このmethodは意図的にgenericです；その
22.1.3.10 String.prototype.isWellFormed ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - stringを ?
ToString (thisValue) とする。 IsStringWellFormedUnicode (string)を返す。
22.1.3.11 String.prototype.lastIndexOf ( searchString [ , position ] )
searchStringが、このobjectをStringへconvertしたresultの
このmethodは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - stringを ?
ToString (thisValue) とする。 - searchStringを ?
ToString (searchString) に設定する。 - numberPositionを ?
ToNumber (position) とする。 Assert : positionがundefined なら、numberPositionはNaN である。- numberPositionが
NaN なら、positionを+∞に設定する；そうでなければ、positionを !ToIntegerOrInfinity (numberPosition) に設定する。 - lengthをstringのlengthとする。
- searchLengthをsearchStringのlengthとする。
- length < searchLengthなら、
-1 𝔽を返す。 - startをpositionを0とlength - searchLengthの間に
clamping したresultとする。 - resultを
StringLastIndexOf (string, searchString, start)とする。 - resultが
not-found なら、-1 𝔽を返す。 𝔽 (result)を返す。
このmethodは意図的にgenericです；その
22.1.3.12 String.prototype.localeCompare ( that [ , reserved1 [ , reserved2 ] ] )
ECMA-402 Internationalization APIを含むECMAScript implementationは、このmethodをECMA-402 specificationで指定される通りにimplementしなければなりません。ECMAScript implementationがECMA-402 APIを含まない場合、このmethodの次のspecificationが使用されます：
このmethodは、
comparisonsを実行する前に、このmethodはStringsをprepareするために次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - stringを ?
ToString (thisValue) とする。 - thatValueを ?
ToString (that) とする。
このmethodのoptional secondおよびthird parametersのmeaningはECMA-402 specificationで定義されます；ECMA-402 supportを含まないimplementationsは、それらのparameter positionsに他のinterpretationをassignしてはなりません。
actual return valuesは、それらにadditional informationをencodingできるよう
このmethod自体はArray.prototype.sortへのargumentとして直接適していません。後者はtwo argumentsのfunctionをrequireするためです。
このmethodは、ECMAScript environmentがhost environmentから利用できる任意のlanguage- and/or locale-sensitive comparison functionalityにrelyしてもよく、host environmentのcurrent localeのconventionsに従ってcompareすることを意図しています。しかし、comparison capabilitiesにかかわらず、このmethodはUnicode Standardに従うcanonical equivalenceをrecognizeおよびhonourしなければなりません—例えば、以下のcomparisonsはすべて
// Å ANGSTROM SIGN vs.
// Å LATIN CAPITAL LETTER A + COMBINING RING ABOVE
"\u212B".localeCompare("A\u030A")
// Ω OHM SIGN vs.
// Ω GREEK CAPITAL LETTER OMEGA
"\u2126".localeCompare("\u03A9")
// ṩ LATIN SMALL LETTER S WITH DOT BELOW AND DOT ABOVE vs.
// ṩ LATIN SMALL LETTER S + COMBINING DOT ABOVE + COMBINING DOT BELOW
"\u1E69".localeCompare("s\u0307\u0323")
// ḍ̇ LATIN SMALL LETTER D WITH DOT ABOVE + COMBINING DOT BELOW vs.
// ḍ̇ LATIN SMALL LETTER D WITH DOT BELOW + COMBINING DOT ABOVE
"\u1E0B\u0323".localeCompare("\u1E0D\u0307")
// 가 HANGUL CHOSEONG KIYEOK + HANGUL JUNGSEONG A vs.
// 가 HANGUL SYLLABLE GA
"\u1100\u1161".localeCompare("\uAC00")canonical equivalenceのdefinitionおよびdiscussionについては、Unicode Standardのchapters 2および3に加えて、Unicode Standard Annex #15, Unicode Normalization FormsおよびUnicode Technical Note #5, Canonical Equivalence in Applicationsを参照してください。Unicode Technical Standard #10, Unicode Collation Algorithmも参照してください。
このmethodは、Unicode Standardのchapter 3, section 3.7で定義されるUnicode compatibility equivalentsまたはcompatibility decompositionsをhonourすべきでないことがrecommendedされます。
このmethodは意図的にgenericです；その
22.1.3.13 String.prototype.match ( regexpOrPattern )
このmethodは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - regexpOrPatternがObjectなら、
- matcherを ?
GetMethod (regexpOrPattern,%Symbol.match% ) とする。 - matcherが
undefined でないなら、- ?
Call (matcher, regexpOrPattern, « thisValue »)を返す。
- ?
- matcherを ?
- stringを ?
ToString (thisValue) とする。 - regexpを ?
RegExpCreate (regexpOrPattern,undefined ) とする。 - ?
Invoke (regexp,%Symbol.match% , « string »)を返す。
このmethodは意図的にgenericです；その
22.1.3.14 String.prototype.matchAll ( regexpOrPattern )
このmethodは、
これは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - regexpOrPatternがObjectなら、
- isRegexpを ?
IsRegExp (regexpOrPattern) とする。 - isRegexpが
true なら、- flagsを ?
Get (regexpOrPattern,"flags" ) とする。 - ?
RequireObjectCoercible (flags)を実行する。 - ?
ToString (flags)が"g" を含まないなら、TypeError 例外をthrowする。
- flagsを ?
- matcherを ?
GetMethod (regexpOrPattern,%Symbol.matchAll% ) とする。 - matcherが
undefined でないなら、- ?
Call (matcher, regexpOrPattern, « thisValue »)を返す。
- ?
- isRegexpを ?
- stringを ?
ToString (thisValue) とする。 - regexpを ?
RegExpCreate (regexpOrPattern,"g" ) とする。 - ?
Invoke (regexp,%Symbol.matchAll% , « string »)を返す。
String.prototype.splitと同様に、String.prototype.matchAllは通常、そのinputsをmutateせずにactするようにdesignedされています。22.1.3.15 String.prototype.normalize ( [ form ] )
このmethodは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - stringを ?
ToString (thisValue) とする。 - formが
undefined なら、formを"NFC" に設定する。 - そうでなければ、formを ?
ToString (form) に設定する。 - formが
"NFC" 、"NFD" 、"NFKC" 、または"NFKD" のいずれでもないなら、RangeError 例外をthrowする。 - normalを、the latest Unicode Standard, Normalization Formsで指定される通り、formによってnamedされたnormalization formへstringをnormalizingしたresultであるString valueとする。
- normalを返す。
このmethodは意図的にgenericです；その
22.1.3.16 String.prototype.padEnd ( maxLength [ , fillString ] )
このmethodは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - ?
StringPaddingBuiltinsImpl (thisValue, maxLength, fillString,end )を返す。
22.1.3.17 String.prototype.padStart ( maxLength [ , fillString ] )
このmethodは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - ?
StringPaddingBuiltinsImpl (thisValue, maxLength, fillString,start )を返す。
22.1.3.17.1 StringPaddingBuiltinsImpl ( thisValue, maxLength, fillString, placement )
The abstract operation StringPaddingBuiltinsImpl takes arguments thisValue (an ECMAScript language value), maxLength (an ECMAScript language value), fillString (an ECMAScript language value), and placement (
- stringを ?
ToString (thisValue) とする。 - intMaxLengthを
ℝ (?ToLength (maxLength))とする。 - stringLengthをstringのlengthとする。
- intMaxLength ≤ stringLengthなら、stringを返す。
- fillStringが
undefined なら、fillStringをcode unit 0x0020 (SPACE)のみからなるString valueに設定する。 - そうでなければ、fillStringを ?
ToString (fillString) に設定する。 StringPad (string, intMaxLength, fillString, placement)を返す。
22.1.3.17.2 StringPad ( string, maxLength, fillString, placement )
The abstract operation StringPad takes arguments string (a String), maxLength (a non-negative
- stringLengthをstringのlengthとする。
- maxLength ≤ stringLengthなら、stringを返す。
- fillStringがempty Stringなら、stringを返す。
- fillLengthをmaxLength - stringLengthとする。
- truncatedStringFillerを、fillStringのrepeated concatenationsからなり、length fillLengthにtruncatedされたString valueとする。
- placementが
start なら、truncatedStringFillerとstringのstring-concatenation を返す。 - stringとtruncatedStringFillerの
string-concatenation を返す。
argument maxLengthは、stringのlengthより小さくならないようにclampedされます。
argument fillStringは
22.1.3.17.3 ToZeroPaddedDecimalString ( n, minLength )
The abstract operation ToZeroPaddedDecimalString takes arguments n (a non-negative
- stringをdecimal numberとしてformattedされたnのString representationとする。
StringPad (string, minLength,"0" ,start )を返す。
22.1.3.18 String.prototype.repeat ( count )
このmethodは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - stringを ?
ToString (thisValue) とする。 - nを ?
ToIntegerOrInfinity (count) とする。 - n < 0またはn = +∞なら、
RangeError 例外をthrowする。 - n = 0なら、empty Stringを返す。
- stringのn個のcopiesをappended togetherして作られたString valueを返す。
このmethodは、
このmethodは意図的にgenericです；その
22.1.3.19 String.prototype.replace ( searchValue, replaceValue )
このmethodは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - searchValueがObjectなら、
- replacerを ?
GetMethod (searchValue,%Symbol.replace% ) とする。 - replacerが
undefined でないなら、- ?
Call (replacer, searchValue, « thisValue, replaceValue »)を返す。
- ?
- replacerを ?
- stringを ?
ToString (thisValue) とする。 - searchStringを ?
ToString (searchValue) とする。 - functionalReplaceを
IsCallable (replaceValue)とする。 - functionalReplaceが
false なら、- replaceValueを ?
ToString (replaceValue) に設定する。
- replaceValueを ?
- searchLengthをsearchStringのlengthとする。
- positionを
StringIndexOf (string, searchString, 0)とする。 - positionが
not-found なら、stringを返す。 - precedingをstringの0からpositionまでの
substring とする。 - followingをstringのposition + searchLengthからの
substring とする。 - functionalReplaceが
true なら、 - そうでなければ、
Assert : replaceValueはStringである。- capturesを新しい空の
List とする。 - replacementを !
GetSubstitution (searchString, string, position, captures,undefined , replaceValue) とする。
- preceding、replacement、およびfollowingの
string-concatenation を返す。
このmethodは意図的にgenericです；その
22.1.3.19.1 GetSubstitution ( matched, string, position, captures, namedCaptures, replacementTemplate )
The abstract operation GetSubstitution takes arguments matched (a String), string (a String), position (a non-negative
- stringLengthをstringのlengthとする。
Assert : position ≤ stringLengthである。- resultをempty Stringとする。
- templateRemainderをreplacementTemplateとする。
- templateRemainderがempty Stringでない間、繰り返す
NOTE : 以下のstepsはref（templateRemainderのprefix）をisolateし、refReplacement（そのreplacement）をdetermineし、そのreplacementをresultへappendする。- templateRemainderが
"$$" で始まるなら、- refを
"$$" とする。 - refReplacementを
"$" とする。
- refを
- そうでなく、templateRemainderが
"$`" で始まるなら、- refを
"$`" とする。 - refReplacementをstringの0からpositionまでの
substring とする。
- refを
- そうでなく、templateRemainderが
"$&" で始まるなら、- refを
"$&" とする。 - refReplacementをmatchedとする。
- refを
- そうでなく、templateRemainderが
"$'" （0x0024 (DOLLAR SIGN) followed by 0x0027 (APOSTROPHE)）で始まるなら、- refを
"$'" とする。 - matchLengthをmatchedのlengthとする。
- tailPositionをposition + matchLengthとする。
- refReplacementをstringの
min (tailPosition, stringLength)からのsubstring とする。 NOTE : このabstract operationが、"exec" propertyがintrinsic %RegExp.prototype.exec%でないobject上の%RegExp.prototype% のintrinsic%Symbol.replace% methodへのcallによってinvokedされた場合にのみ、tailPositionはstringLengthを超え得る。
- refを
- そうでなく、templateRemainderが
"$" の後に1つ以上のdecimal digitsが続くもので始まるなら、- templateRemainderが
"$" の後に2つ以上のdecimal digitsが続くもので始まるなら、digitCountを2とする；そうでなければ、digitCountを1とする。 - digitsをtemplateRemainderの1から1 + digitCountまでの
substring とする。 - indexを
ℝ (StringToNumber (digits))とする。 Assert : 0 ≤ index ≤ 99である。- captureLengthをcaptures内のelementsの数とする。
- index > captureLengthかつdigitCount = 2なら、
NOTE : two-digit replacement patternがcapturing groupsのcountを超えるindexをspecifyする場合、それはone-digit replacement patternの後にliteral digitが続くものとして扱われる。- digitCountを1に設定する。
- digitsをdigitsの0から1までの
substring に設定する。 - indexを
ℝ (StringToNumber (digits))に設定する。
- refをtemplateRemainderの0から1 + digitCountまでの
substring とする。 - 1 ≤ index ≤ captureLengthなら、
- captureをcaptures[index - 1]とする。
- captureが
undefined なら、- refReplacementをempty Stringとする。
- そうでなければ、
- refReplacementをcaptureとする。
- そうでなければ、
- refReplacementをrefとする。
- templateRemainderが
- そうでなく、templateRemainderが
"$<" で始まるなら、- gtPositionを
StringIndexOf (templateRemainder,">" , 0)とする。 - gtPositionが
not-found またはnamedCapturesがundefined なら、- refを
"$<" とする。 - refReplacementをrefとする。
- refを
- そうでなければ、
- gtPositionを
- そうでなければ、
- refをtemplateRemainderの0から1までの
substring とする。 - refReplacementをrefとする。
- refをtemplateRemainderの0から1までの
- refLengthをrefのlengthとする。
- templateRemainderをtemplateRemainderのrefLengthからの
substring に設定する。 - resultをresultとrefReplacementの
string-concatenation に設定する。
- resultを返す。
22.1.3.20 String.prototype.replaceAll ( searchValue, replaceValue )
このmethodは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - searchValueがObjectなら、
- isRegexpを ?
IsRegExp (searchValue) とする。 - isRegexpが
true なら、- flagsを ?
Get (searchValue,"flags" ) とする。 - ?
RequireObjectCoercible (flags)を実行する。 - ?
ToString (flags)が"g" を含まないなら、TypeError 例外をthrowする。
- flagsを ?
- replacerを ?
GetMethod (searchValue,%Symbol.replace% ) とする。 - replacerが
undefined でないなら、- ?
Call (replacer, searchValue, « thisValue, replaceValue »)を返す。
- ?
- isRegexpを ?
- stringを ?
ToString (thisValue) とする。 - searchStringを ?
ToString (searchValue) とする。 - functionalReplaceを
IsCallable (replaceValue)とする。 - functionalReplaceが
false なら、- replaceValueを ?
ToString (replaceValue) に設定する。
- replaceValueを ?
- searchLengthをsearchStringのlengthとする。
- advanceByを
max (1, searchLength)とする。 - matchPositionsを新しい空の
List とする。 - positionを
StringIndexOf (string, searchString, 0)とする。 - positionが
not-found でない間、繰り返す- positionをmatchPositionsへappendする。
- positionを
StringIndexOf (string, searchString, position + advanceBy)に設定する。
- endOfLastMatchを0とする。
- resultをempty Stringとする。
- matchPositionsの各要素matchPositionについて、以下を行う
- preservedをstringのendOfLastMatchからmatchPositionまでの
substring とする。 - functionalReplaceが
true なら、 - そうでなければ、
Assert : replaceValueはStringである。- capturesを新しい空の
List とする。 - replacementを !
GetSubstitution (searchString, string, matchPosition, captures,undefined , replaceValue) とする。
- resultをresult、preserved、およびreplacementの
string-concatenation に設定する。 - endOfLastMatchをmatchPosition + searchLengthに設定する。
- preservedをstringのendOfLastMatchからmatchPositionまでの
- endOfLastMatch < stringのlengthなら、
- resultをresultとstringのendOfLastMatchからの
substring のstring-concatenation に設定する。
- resultをresultとstringのendOfLastMatchからの
- resultを返す。
22.1.3.21 String.prototype.search ( regexpOrPattern )
このmethodは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - regexpOrPatternがObjectなら、
- searcherを ?
GetMethod (regexpOrPattern,%Symbol.search% ) とする。 - searcherが
undefined でないなら、- ?
Call (searcher, regexpOrPattern, « thisValue »)を返す。
- ?
- searcherを ?
- stringを ?
ToString (thisValue) とする。 - regexpを ?
RegExpCreate (regexpOrPattern,undefined ) とする。 - ?
Invoke (regexp,%Symbol.search% , « string »)を返す。
このmethodは意図的にgenericです；その
22.1.3.22 String.prototype.slice ( start, end )
このmethodは、このobjectをStringへconvertしたresultの
これは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - stringを ?
ToString (thisValue) とする。 - lengthをstringのlengthとする。
- intStartを ?
ToIntegerOrInfinity (start) とする。 - intStart = -∞なら、fromを0とする。
- そうでなく、intStart < 0なら、fromを
max (length + intStart, 0)とする。 - そうでなければ、fromを
min (intStart, length)とする。 - endが
undefined なら、intEndをlengthとする；そうでなければ、intEndを ?ToIntegerOrInfinity (end) とする。 - intEnd = -∞なら、toを0とする。
- そうでなく、intEnd < 0なら、toを
max (length + intEnd, 0)とする。 - そうでなければ、toを
min (intEnd, length)とする。 - from ≥ toなら、empty Stringを返す。
- stringのfromからtoまでの
substring を返す。
このmethodは意図的にgenericです；その
22.1.3.23 String.prototype.split ( separator, limit )
このmethodは、このobjectをStringへconvertしたresultのsubstringsが格納されたArrayを返します。substringsは、separatorのoccurrencesをleft to rightにsearchすることによってdetermineされます；これらのoccurrencesはreturned array内のいかなるStringのpartでもありませんが、String valueをdivide upする役割を果たします。separatorのvalueは任意のlengthのStringであってもよく、またはRegExpのように
これは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - separatorがObjectなら、
- splitterを ?
GetMethod (separator,%Symbol.split% ) とする。 - splitterが
undefined でないなら、- ?
Call (splitter, separator, « thisValue, limit »)を返す。
- ?
- splitterを ?
- stringを ?
ToString (thisValue) とする。 - limitが
undefined なら、limを232 - 1とする；そうでなければ、limをℝ (?ToUint32 (limit))とする。 - separatorStringを ?
ToString (separator) とする。 - lim = 0なら、
CreateArrayFromList (« »)を返す。
- separatorが
undefined なら、CreateArrayFromList (« string »)を返す。
- separatorLengthをseparatorStringのlengthとする。
- separatorLength = 0なら、
- stringLengthをstringのlengthとする。
- outLengthをlimを0とstringLengthの間に
clamping したresultとする。 - headをstringの0からoutLengthまでの
substring とする。 - codeUnitsを、headのelementsであるcode unitsのsequenceからなる
List とする。 CreateArrayFromList (codeUnits)を返す。
- stringがempty Stringなら、
CreateArrayFromList (« string »)を返す。 - substringsを新しい空の
List とする。 - searchStartを0とする。
- matchIndexを
StringIndexOf (string, separatorString, 0)とする。 - matchIndexが
not-found でない間、繰り返す- substringをstringのsearchStartからmatchIndexまでの
substring とする。 - substringをsubstringsへappendする。
- substrings内のelementsの数がlimなら、
CreateArrayFromList (substrings)を返す。 - searchStartをmatchIndex + separatorLengthに設定する。
- matchIndexを
StringIndexOf (string, separatorString, searchStart)に設定する。
- substringをstringのsearchStartからmatchIndexまでの
- substringをstringのsearchStartからの
substring とする。 - substringをsubstringsへappendする。
CreateArrayFromList (substrings)を返す。
separatorのvalueはempty Stringであってもよいです。この場合、separatorはinput Stringのbeginningまたはendにあるempty
separatorが
このmethodは意図的にgenericです；その
22.1.3.24 String.prototype.startsWith ( searchString [ , position ] )
このmethodは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - stringを ?
ToString (thisValue) とする。 - isRegexpを ?
IsRegExp (searchString) とする。 - isRegexpが
true なら、TypeError 例外をthrowする。 - searchStringを ?
ToString (searchString) に設定する。 - lengthをstringのlengthとする。
- positionが
undefined なら、positionを0に設定する；そうでなければ、positionを ?ToIntegerOrInfinity (position) に設定する。 - startをpositionを0とlengthの間に
clamping したresultとする。 - searchLengthをsearchStringのlengthとする。
- searchLength = 0なら、
true を返す。 - endをstart + searchLengthとする。
- end > lengthなら、
false を返す。 - substringをstringのstartからendまでの
substring とする。 - substringがsearchStringなら、
true を返す。 false を返す。
first argumentがRegExpである場合にexceptionをthrowすることは、そのようなargument valuesをallowするextensionsをfuture editionsがdefineできるようにするために指定されています。
このmethodは意図的にgenericです；その
22.1.3.25 String.prototype.substring ( start, end )
このmethodは、このobjectをStringへconvertしたresultの
いずれかのargumentが
startがendよりstrictly greaterである場合、それらはswappedされます。
これは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - stringを ?
ToString (thisValue) とする。 - lengthをstringのlengthとする。
- intStartを ?
ToIntegerOrInfinity (start) とする。 - endが
undefined なら、intEndをlengthとする；そうでなければ、intEndを ?ToIntegerOrInfinity (end) とする。 - finalStartをintStartを0とlengthの間に
clamping したresultとする。 - finalEndをintEndを0とlengthの間に
clamping したresultとする。 - fromを
min (finalStart, finalEnd)とする。 - toを
max (finalStart, finalEnd)とする。 - stringのfromからtoまでの
substring を返す。
このmethodは意図的にgenericです；その
22.1.3.26 String.prototype.toLocaleLowerCase ( [ reserved1 [ , reserved2 ] ] )
ECMA-402 Internationalization APIを含むECMAScript implementationは、このmethodをECMA-402 specificationで指定される通りにimplementしなければなりません。ECMAScript implementationがECMA-402 APIを含まない場合、このmethodの次のspecificationが使用されます：
このmethodは、
toLowerCaseとexactly the sameに動作しますが、host environmentのcurrent localeのconventionsに対応するlocale-sensitive resultをyieldすることを意図している点が異なります。regular Unicode case mappingsとそのlanguageのrulesがconflictする少数のcases（Turkishなど）にのみdifferenceが生じます。
このmethodのoptional parametersのmeaningはECMA-402 specificationで定義されます；ECMA-402 supportを含まないimplementationsは、それらのparameter positionsを他の目的に使用してはなりません。
このmethodは意図的にgenericです；その
22.1.3.27 String.prototype.toLocaleUpperCase ( [ reserved1 [ , reserved2 ] ] )
ECMA-402 Internationalization APIを含むECMAScript implementationは、このmethodをECMA-402 specificationで指定される通りにimplementしなければなりません。ECMAScript implementationがECMA-402 APIを含まない場合、このmethodの次のspecificationが使用されます：
このmethodは、
toUpperCaseとexactly the sameに動作しますが、host environmentのcurrent localeのconventionsに対応するlocale-sensitive resultをyieldすることを意図している点が異なります。regular Unicode case mappingsとそのlanguageのrulesがconflictする少数のcases（Turkishなど）にのみdifferenceが生じます。
このmethodのoptional parametersのmeaningはECMA-402 specificationで定義されます；ECMA-402 supportを含まないimplementationsは、それらのparameter positionsを他の目的に使用してはなりません。
このmethodは意図的にgenericです；その
22.1.3.28 String.prototype.toLowerCase ( )
このmethodは、
これは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - stringを ?
ToString (thisValue) とする。 - sTextを
StringToCodePoints (string)とする。 - lowerTextを、Unicode Default Case Conversion algorithmに従うtoLowercase(sText)とする。
- lowercaseStringを
CodePointsToString (lowerText)とする。 - lowercaseStringを返す。
resultは、Unicode Character Database内のlocale-insensitive case mappingsに従ってderivedされなければなりません（これは明示的にfile UnicodeData.txtだけでなく、それにaccompaniesするfile SpecialCasing.txt内のすべてのlocale-insensitive mappingsも含みます）。
一部のcode pointsのcase mappingはmultiple code pointsをproduceする場合があります。この場合、result Stringはsource Stringとsame lengthでないことがあります。toUpperCaseとtoLowerCaseの両方がcontext-sensitive behaviourを持つため、methodsはsymmetricalではありません。言い換えると、s.toUpperCase().toLowerCase()は必ずしもs.toLowerCase()にequalではありません。
このmethodは意図的にgenericです；その
22.1.3.29 String.prototype.toString ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- ?
ThisStringValue (this value)を返す。
String objectについて、このmethodはvalueOf methodとsame thingを返すことになります。
22.1.3.30 String.prototype.toUpperCase ( )
このmethodは、
StringがUnicode Default Case ConversionのtoUppercase algorithmを使用してmappedされる点を除き、String.prototype.toLowerCaseとexactly the same wayにbehaveします。
このmethodは意図的にgenericです；その
22.1.3.31 String.prototype.toWellFormed ( )
このmethodは、
これは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
RequireObjectCoercible (thisValue)を実行する。 - stringを ?
ToString (thisValue) とする。 - stringLengthをstringのlengthとする。
- kを0とする。
- resultをempty Stringとする。
- k < stringLengthの間、繰り返す
- codePointを
CodePointAt (string, k)とする。 - codePoint.[[IsUnpairedSurrogate]]が
true なら、- resultをresultと0xFFFD (REPLACEMENT CHARACTER)の
string-concatenation に設定する。
- resultをresultと0xFFFD (REPLACEMENT CHARACTER)の
- そうでなければ、
- resultをresultと
UTF16EncodeCodePoint (codePoint.[[CodePoint]])のstring-concatenation に設定する。
- resultをresultと
- kをk + codePoint.[[CodeUnitCount]]に設定する。
- codePointを
- resultを返す。
22.1.3.32 String.prototype.trim ( )
このmethodは、
これは呼び出されたとき、次のstepsを実行します：
- thisValueを
this valueとする。 - ?
TrimString (thisValue,start+end )を返す。
このmethodは意図的にgenericです；その
22.1.3.32.1 TrimString ( arg, where )
The abstract operation TrimString takes arguments arg (an ECMAScript language value) and where (
- ?
RequireObjectCoercible (arg)を実行する。 - stringを ?
ToString (arg) とする。 - whereが
start なら、- trimmedStringを、stringからleading white spaceがremovedされたcopyであるString valueとする。
- そうでなく、whereが
end なら、- trimmedStringを、stringからtrailing white spaceがremovedされたcopyであるString valueとする。
- そうでなければ、
Assert : whereはstart+end である。- trimmedStringを、stringからleadingおよびtrailing white spaceの両方がremovedされたcopyであるString valueとする。
- trimmedStringを返す。
white spaceのdefinitionは
22.1.3.33 String.prototype.trimEnd ( )
このmethodは、
これは呼び出されたとき、次のstepsを実行します：
- stringを
this valueとする。 - ?
TrimString (string,end )を返す。
このmethodは意図的にgenericです；その
22.1.3.34 String.prototype.trimStart ( )
このmethodは、
これは呼び出されたとき、次のstepsを実行します：
- stringを
this valueとする。 - ?
TrimString (string,start )を返す。
このmethodは意図的にgenericです；その
22.1.3.35 String.prototype.valueOf ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- ?
ThisStringValue (this value)を返す。
22.1.3.35.1 ThisStringValue ( arg )
The abstract operation ThisStringValue takes argument arg (an ECMAScript language value) and returns either a
- argがStringなら、argを返す。
- argがObjectであり、かつargが[[StringData]] internal slotを持つなら、
- stringをarg.[[StringData]]とする。
Assert : stringはStringである。- stringを返す。
TypeError 例外をThrowする。
22.1.3.36 String.prototype [ %Symbol.iterator% ] ( )
このmethodは、String valueのcode pointsをiterateし、各code pointをString valueとしてreturnする
これは呼び出されたとき、次のstepsを実行します：
- stringを
this valueとする。 - ?
RequireObjectCoercible (string)を実行する。 - stringを ?
ToString (string) に設定する。 - closureを、stringをcaptureし、呼び出されたとき次のstepsを実行する、parametersを持たない新しい
Abstract Closure とする：- lengthをstringのlengthとする。
- positionを0とする。
- position < lengthの間、繰り返す
- codePointを
CodePointAt (string, position)とする。 - nextIndexをposition + codePoint.[[CodeUnitCount]]とする。
- resultStringをstringのpositionからnextIndexまでの
substring とする。 - positionをnextIndexに設定する。
- ?
GeneratorYield (CreateIteratorResultObject (resultString,false ))を実行する。
- codePointを
NormalCompletion (unused )を返す。
CreateIteratorFromClosure (closure,"%StringIteratorPrototype%" ,%StringIteratorPrototype% )を返す。
このmethodの
22.1.4 Properties of String Instances
String instancesは
String instancesは
22.1.4.1 length
このString objectによって表されるString value内のelementsの数。
String objectがinitializeされると、このpropertyはunchangingです。これはattributes { [[Writable]]:
22.1.5 String Iterator Objects
String Iteratorは、特定のString instance objectに対するspecific iterationを表すobjectです。String Iterator objectsにはnamed
22.1.5.1 The %StringIteratorPrototype% Object
%StringIteratorPrototype% objectは：
- すべての
String Iterator objects によってinheritedされるpropertiesを持ちます。 ordinary object です。- valueが
%Iterator.prototype% である[[Prototype]] internal slotを持ちます。 - 次のpropertiesを持ちます：
22.1.5.1.1 %StringIteratorPrototype%.next ( )
- ?
GeneratorResume (this value,empty ,"%StringIteratorPrototype%" )を返す。
22.1.5.1.2 %StringIteratorPrototype% [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
22.2 RegExp（Regular Expression）Objects
RegExp objectはregular expressionおよびassociated flagsを含みます。
regular expressionsのformおよびfunctionalityは、Perl 5 programming languageのregular expression facilityをmodelにしています。
22.2.1 Patterns
RegExp
Syntax
associatedするu \u \u u
ここでの最初の2行はCharacterClassとequivalentです。
このsection内のいくつかのproductionsには、section
22.2.1.1 Static Semantics: Early Errors
このsectionは
-
CountLeftCapturingParensWithin (Pattern ) ≥ 232 - 1である場合、Syntax Errorです。 -
Pattern が、xのCapturingGroupName がyのCapturingGroupName であり、かつMightBothParticipate (x, y)がtrue であるような、two distinctGroupSpecifier s xおよびyを含む場合、Syntax Errorです。
-
first
DecimalDigits のMVがsecondDecimalDigits のMVよりstrictly greaterである場合、Syntax Errorです。
-
RegularExpressionModifiers にmatchedするsource textがsame code pointをmore than once含む場合、Syntax Errorです。
-
first
RegularExpressionModifiers にmatchedするsource textとsecondRegularExpressionModifiers にmatchedするsource textがboth emptyである場合、Syntax Errorです。 -
first
RegularExpressionModifiers にmatchedするsource textがsame code pointをmore than once含む場合、Syntax Errorです。 -
second
RegularExpressionModifiers にmatchedするsource textがsame code pointをmore than once含む場合、Syntax Errorです。 -
first
RegularExpressionModifiers にmatchedするsource text内の任意のcode pointが、secondRegularExpressionModifiers にmatchedするsource textにも含まれる場合、Syntax Errorです。
-
GroupSpecifiersThatMatch (GroupName )がemptyである場合、Syntax Errorです。
-
DecimalEscape のCapturingGroupNumber が、AtomEscape を含むPattern 内のCountLeftCapturingParensWithin (thePattern containingAtomEscape )よりstrictly greaterである場合、Syntax Errorです。
-
first
ClassAtom のIsCharacterClass がtrue であるか、secondClassAtom のIsCharacterClass がtrue である場合、Syntax Errorです。 -
first
ClassAtom のIsCharacterClass がfalse であり、secondClassAtom のIsCharacterClass がfalse であり、かつfirstClassAtom のCharacterValue がsecondClassAtom のCharacterValue よりstrictly greaterである場合、Syntax Errorです。
-
ClassAtomNoDash のIsCharacterClass がtrue であるか、ClassAtom のIsCharacterClass がtrue である場合、Syntax Errorです。 -
ClassAtomNoDash のIsCharacterClass がfalse であり、ClassAtom のIsCharacterClass がfalse であり、かつClassAtomNoDash のCharacterValue がClassAtom のCharacterValue よりstrictly greaterである場合、Syntax Errorです。
-
RegExpUnicodeEscapeSequence のCharacterValue が、IdentifierStartChar lexical grammar productionにmatchedする何らかのcode pointのnumeric valueでない場合、Syntax Errorです。
-
RegExpIdentifierStart のRegExpIdentifierCodePoint がUnicodeIDStart lexical grammar productionによってmatchedされない場合、Syntax Errorです。
-
RegExpUnicodeEscapeSequence のCharacterValue が、IdentifierPartChar lexical grammar productionにmatchedする何らかのcode pointのnumeric valueでない場合、Syntax Errorです。
-
RegExpIdentifierPart のRegExpIdentifierCodePoint がUnicodeIDContinue lexical grammar productionによってmatchedされない場合、Syntax Errorです。
-
UnicodePropertyName にmatchedするsource textが、Table 65 の“Property name and aliases ” columnにlistedされているUnicode property name またはproperty aliasでない場合、Syntax Errorです。 -
UnicodePropertyValue にmatchedするsource textが、UnicodePropertyName にmatchedするsource textによって与えられるUnicode propertyまたはproperty aliasに対するproperty valueまたはproperty value aliasとして、PropertyValueAliases.txtにlistedされていない場合、Syntax Errorです。
-
LoneUnicodePropertyNameOrValue にmatchedするsource textが、PropertyValueAliases.txtにlistedされているGeneral_Category (gc) propertyに対するUnicode property valueまたはproperty value aliasでもなく、Table 66 の“Property name and aliases ” columnにlistedされているbinary propertyまたはbinary property aliasでもなく、Table 67 の“Property name ” columnにlistedされているbinary property of stringsでもない場合、Syntax Errorです。 -
enclosing
Pattern が[UnicodeSetsMode] parameterを持たず、かつLoneUnicodePropertyNameOrValue にmatchedするsource textがTable 67 の“Property name ” columnにlistedされているbinary property of stringsである場合、Syntax Errorです。
-
UnicodePropertyValueExpression のMayContainStrings がtrue である場合、Syntax Errorです。
-
ClassContents のMayContainStrings がtrue である場合、Syntax Errorです。
-
ClassContents のMayContainStrings がtrue である場合、Syntax Errorです。
-
first
ClassSetCharacter のCharacterValue がsecondClassSetCharacter のCharacterValue よりstrictly greaterである場合、Syntax Errorです。
22.2.1.2 Static Semantics: CountLeftCapturingParensWithin ( parseNode )
The abstract operation CountLeftCapturingParensWithin takes argument parseNode (a ( terminalにmatchedする任意の( pattern characterです。
このsectionは
It performs the following steps when called:
Assert : parseNodeはthe RegExp Pattern grammar 内のproductionのinstanceである。- parseNode内にcontainedされる
Atom :: ( GroupSpecifier opt Disjunction ) Parse Nodes の数を返す。
22.2.1.3 Static Semantics: CountLeftCapturingParensBefore ( parseNode )
The abstract operation CountLeftCapturingParensBefore takes argument parseNode (a
このsectionは
It performs the following steps when called:
Assert : parseNodeはthe RegExp Pattern grammar 内のproductionのinstanceである。- patternをparseNodeを含む
Pattern とする。 - pattern内にcontainedされる
Atom :: ( GroupSpecifier opt Disjunction ) Parse Nodes のうち、parseNodeより前にoccurするかparseNodeをcontainするものの数を返す。
22.2.1.4 Static Semantics: MightBothParticipate ( x, y )
The abstract operation MightBothParticipate takes arguments x (a
Assert : xおよびyは同じenclosingPattern を持つ。- enclosing
Pattern が、xがAlternative 内にcontainedされyがderivedDisjunction 内にcontainedされる、またはxがderivedDisjunction 内にcontainedされyがAlternative 内にcontainedされるようなDisjunction :: Alternative | Disjunction Parse Node を含むなら、false を返す。 true を返す。
22.2.1.5 Static Semantics: CapturingGroupNumber
The
このsectionは
It is defined piecewise over the following productions:
NonZeroDigit のMVを返す。
- nを
DecimalDigits 内のcode pointsの数とする。 - （
NonZeroDigit のMV × 10n plusDecimalDigits のMV）を返す。
“the MV of
22.2.1.6 Static Semantics: IsCharacterClass
The
このsectionは
It is defined piecewise over the following productions:
false を返す。
true を返す。
22.2.1.7 Static Semantics: CharacterValue
The
このsectionは
It is defined piecewise over the following productions:
- U+002D (HYPHEN-MINUS)のnumeric valueを返す。
- codePointを
SourceCharacter にmatchedするcode pointとする。 - codePointのnumeric valueを返す。
- U+0008 (BACKSPACE)のnumeric valueを返す。
- U+002D (HYPHEN-MINUS)のnumeric valueを返す。
Table 63 に従ったnumeric valueを返す。
| ControlEscape | Numeric Value | Code Point | Unicode Name | Symbol |
|---|---|---|---|---|
t
|
9 |
U+0009
|
CHARACTER TABULATION | <HT> |
n
|
10 |
U+000A
|
LINE FEED (LF) | <LF> |
v
|
11 |
U+000B
|
LINE TABULATION | <VT> |
f
|
12 |
U+000C
|
FORM FEED (FF) | <FF> |
r
|
13 |
U+000D
|
CARRIAGE RETURN (CR) | <CR> |
- codePointを
AsciiLetter にmatchedするcode pointとする。 - iをcodePointのnumeric valueとする。
- iを32で割ったremainderを返す。
- U+0000 (NULL)のnumeric valueを返す。
\0は<NUL> characterを表し、decimal digitをfollowすることはできません。
HexEscapeSequence のMVを返す。
- leadを
HexLeadSurrogate のCharacterValue とする。 - trailを
HexTrailSurrogate のCharacterValue とする。 - codePointを
UTF16SurrogatePairToCodePoint (lead, trail)とする。 - codePointのnumeric valueを返す。
Hex4Digits のMVを返す。
CodePoint のMVを返す。
Hex4Digits のMVを返す。
- codePointを
IdentityEscape にmatchedするcode pointとする。 - codePointのnumeric valueを返す。
- codePointを
SourceCharacter にmatchedするcode pointとする。 - codePointのnumeric valueを返す。
- codePointを
ClassSetReservedPunctuator にmatchedするcode pointとする。 - codePointのnumeric valueを返す。
- U+0008 (BACKSPACE)のnumeric valueを返す。
22.2.1.8 Static Semantics: MayContainStrings
The
false を返す。
LoneUnicodePropertyNameOrValue にmatchedするsource textがTable 67 の“Property name ” columnにlistedされているbinary property of stringsであるなら、true を返す。false を返す。
ClassUnion がpresentなら、ClassUnion のMayContainStrings を返す。false を返す。
ClassSetOperand のMayContainStrings がtrue なら、true を返す。ClassUnion がpresentなら、ClassUnion のMayContainStrings を返す。false を返す。
- first
ClassSetOperand のMayContainStrings がfalse なら、false を返す。 - second
ClassSetOperand のMayContainStrings がfalse なら、false を返す。 true を返す。
ClassIntersection のMayContainStrings がfalse なら、false を返す。ClassSetOperand のMayContainStrings がfalse なら、false を返す。true を返す。
- first
ClassSetOperand のMayContainStrings を返す。
ClassString のMayContainStrings がtrue なら、true を返す。ClassStringDisjunctionContents のMayContainStrings を返す。
true を返す。
NonEmptyClassString がpresentなら、true を返す。false を返す。
22.2.1.9 Static Semantics: GroupSpecifiersThatMatch ( thisGroupName )
The abstract operation GroupSpecifiersThatMatch takes argument thisGroupName (a
- nameをthisGroupNameの
CapturingGroupName とする。 - patternをthisGroupNameを含む
Pattern とする。 - resultを新しい空の
List とする。 - patternが含む各
GroupSpecifier groupSpecifierについて、以下を行う- groupSpecifierの
CapturingGroupName がnameであるなら、- groupSpecifierをresultへappendする。
- groupSpecifierの
- resultを返す。
22.2.1.10 Static Semantics: CapturingGroupName
The
- idTextUnescapedを
RegExpIdentifierName のRegExpIdentifierCodePoints とする。 CodePointsToString (idTextUnescaped)を返す。
22.2.1.11 Static Semantics: RegExpIdentifierCodePoints
The
- codePointを
RegExpIdentifierStart のRegExpIdentifierCodePoint とする。 - « codePoint »を返す。
- 派生した
RegExpIdentifierName のRegExpIdentifierCodePoints をcodePointsとする。 RegExpIdentifierPart のRegExpIdentifierCodePoint をcodePointとする。- codePointsと« codePoint »の
list-concatenation を返す。
22.2.1.12 Static Semantics: RegExpIdentifierCodePoint
The
IdentifierStartChar にmatchedするcode pointを返す。
IdentifierPartChar にmatchedするcode pointを返す。
- numeric valueが
RegExpUnicodeEscapeSequence のCharacterValue であるcode pointを返す。
- leadを、numeric valueが
UnicodeLeadSurrogate にmatchedするcode pointのnumeric valueであるcode unitとする。 - trailを、numeric valueが
UnicodeTrailSurrogate にmatchedするcode pointのnumeric valueであるcode unitとする。 UTF16SurrogatePairToCodePoint (lead, trail)を返す。
22.2.2 Pattern Semantics
regular expression patternは、以下でdescribedされるprocessを使用して
uもvも含まない場合はBMP patternです。そうでなければ、Unicode patternです。BMP patternは、Basic Multilingual Planeのrange内にあるUnicode code pointsである16-bit valuesのsequenceからなるものとしてinterpretedされるStringに対してmatchします。Unicode patternは、UTF-16を使用してencodedされたUnicode code pointsからなるものとしてinterpretedされるStringに対してmatchします。BMP patternのbehaviourをdescribeするcontextにおいて、“character”はsingle 16-bit Unicode BMP code pointを意味します。Unicode patternのbehaviourをdescribeするcontextにおいて、“character”はUTF-16 encoded code point（
例えば、single non-BMP character U+1D11E（MUSICAL SYMBOL G CLEF）としてsource textでexpressedされたpatternを考えます。Unicode patternとしてinterpretedされる場合、それはsingle code point U+1D11Eからなるsingle element（character）
Patternsは、non-BMP charactersがUTF-16 encodedされているECMAScript String valuesとしてRegExp
implementationは、UTF-16への、またはUTF-16からのそのようなtranslationsを実際にはperformしなくてもよいですが、このspecificationのsemanticsは、pattern matchingのresultがそのようなtranslationsがperformedされたかのようになることをrequireします。
22.2.2.1 Notation
以下のdescriptionsでは、次のinternal data structuresを使用します：
-
CharSetElementは、次の2つのentitiesのうちの1つです：
-
regexpRecord.[[UnicodeSets]]が
false なら、CharSetElementは上記のPattern Semanticsの意味におけるcharacterです。 -
regexpRecord.[[UnicodeSets]]が
true なら、CharSetElementは、elementsが上記のPattern Semanticsの意味におけるcharactersであるsequenceです。これにはempty sequence、one characterのsequence、およびmore than one characterのsequenceが含まれます。convenienceのため、このkindのCharSetElementsを扱うとき、individual characterはone characterのsequenceとinterchangeablyに扱われます。
-
regexpRecord.[[UnicodeSets]]が
- CharSetは、CharSetElementsのmathematical setです。
-
CaptureRangeは、captureに含まれるcharactersのrangeを表す
Record { [[StartIndex]], [[EndIndex]] }です。ここで、[[StartIndex]]はinput内のrangeのstart index（inclusive）を表すinteger であり、[[EndIndex]]はinput内のrangeのend index（exclusive）を表すinteger です。任意のCaptureRange について、これらのindicesは[[StartIndex]] ≤ [[EndIndex]]というinvariantをsatisfyしなければなりません。 -
MatchStateは、
Record { [[Input]], [[EndIndex]], [[Captures]] }です。ここで、[[Input]]はmatch対象のStringを表すcharactersのList 、[[EndIndex]]はinteger 、[[Captures]]はpattern内の各left-capturing parenthesis に1つずつ対応するvaluesのList です。MatchStates はregular expression matching algorithms内でpartial match statesを表すために使用されます。[[EndIndex]]は、patternによってこれまでmatchedされたlast input characterのindexに1を加えたものです。一方、[[Captures]]はcapturing parenthesesのresultsを保持します。[[Captures]]のnth elementは、nth set of capturing parenthesesによってcapturedされたcharactersのrangeを表すCaptureRange 、またはnth set of capturing parenthesesがまだreachedされていない場合はundefined です。backtrackingにより、matching process中の任意の時点でmanyMatchStates が使用され得ます。 -
MatcherContinuationは、one
MatchState argumentを受け取り、MatchState またはfailure のいずれかを返すAbstract Closure です。MatcherContinuation は、its captured valuesによってspecifiedされるpatternのremaining portionを、MatchState argumentでgivenされたintermediate stateからstartingして、inputに対してmatchしようとします。matchがsucceedsする場合、MatcherContinuation はreachedしたfinalMatchState を返します；matchがfailsする場合、MatcherContinuation はfailure を返します。 -
Matcherは、two arguments—
MatchState およびMatcherContinuation —を受け取り、MatchState またはfailure のいずれかを返すAbstract Closure です。Matcher は、patternのmiddle subpattern（closureのcaptured valuesによってspecifiedされる）を、MatchState argumentでgivenされたintermediate stateからstartingして、MatchState の[[Input]]に対してmatchしようとします。MatcherContinuation argumentは、patternのrestをmatchするclosureであるべきです。patternのsubpatternをmatchしてnewMatchState をobtainした後、Matcher はそのnewMatchState 上でMatcherContinuation をcallし、patternのrestもmatchできるかどうかをtestします。できる場合、Matcher はMatcherContinuation によってreturnedされたMatchState を返します；そうでない場合、Matcher はchoice pointsでdifferent choicesをtryしてもよく、succeedsするかすべてのpossibilitiesがexhaustedされるまでMatcherContinuation をrepeatedlyにcallします。
22.2.2.1.1 RegExp Records
RegExp Recordは、compilation中およびpossibly matching中に必要なRegExpに関するinformationをstoreするために使用される
これは次のfieldsを持ちます：
| Field Name | Value | Meaning |
|---|---|---|
| [[IgnoreCase]] | a Boolean | |
| [[Multiline]] | a Boolean | |
| [[DotAll]] | a Boolean | |
| [[Unicode]] | a Boolean | |
| [[UnicodeSets]] | a Boolean | |
| [[CapturingGroupsCount]] | a non-negative |
RegExpのpattern内の |
22.2.2.2 Runtime Semantics: CompilePattern
The
- mを、arguments regexpRecordおよび
forward を伴うDisjunction のCompileSubpattern とする。 - regexpRecordおよびmをcaptureし、calledされたときに次のstepsをperformする、parameters (input, index)を持つnew
Abstract Closure を返す：Assert : inputはcharactersのList である。Assert : 0 ≤ index ≤ input内のelementsの数である。- cを、nothingをcaptureし、calledされたときに次のstepsをperformする、parameters (y)を持つnew
MatcherContinuation とする：Assert : yはMatchState である。- yを返す。
- capabilityを、1からregexpRecord.[[CapturingGroupsCount]]までindexedされたregexpRecord.[[CapturingGroupsCount]]個の
undefined valuesのList とする。 - xを
MatchState { [[Input]]: input, [[EndIndex]]: index, [[Captures]]: capability }とする。 - m(x, c)を返す。
Patternは
22.2.2.3 Runtime Semantics: CompileSubpattern
The
このsectionは
It is defined piecewise over the following productions:
- m1を、arguments regexpRecordおよびdirectionを伴う
Alternative のCompileSubpattern とする。 - m2を、arguments regexpRecordおよびdirectionを伴う
Disjunction のCompileSubpattern とする。 MatchTwoAlternatives (m1, m2)を返す。
| regular expression operatorはtwo alternativesをseparateします。patternはまずleft |によってskippedされたpatternのportion内のcapturing parenthesesは、Stringsではなく
/a|ab/.exec("abc")は
/((a)|(ab))((c)|(bc))/.exec("abc")はarray
["abc", "a", "a", undefined, "bc", undefined, "bc"]を返し、
["abc", "ab", undefined, "ab", "c", "c", undefined]ではありません。two alternativesがtriedされるorderはdirectionのvalueにindependentです。
EmptyMatcher ()を返す。
- m1を、arguments regexpRecordおよびdirectionを伴う
Alternative のCompileSubpattern とする。 - m2を、arguments regexpRecordおよびdirectionを伴う
Term のCompileSubpattern とする。 MatchSequence (m1, m2, direction)を返す。
Consecutive
- argument regexpRecordを伴う
Assertion のCompileAssertion を返す。
resulting
- arguments regexpRecordおよびdirectionを伴う
Atom のCompileAtom を返す。
- mを、arguments regexpRecordおよびdirectionを伴う
Atom のCompileAtom とする。 - qを
Quantifier のCompileQuantifier とする。 Assert : q.[[Min]] ≤ q.[[Max]]である。- parenIndexを
CountLeftCapturingParensBefore (Term )とする。 - parenCountを
CountLeftCapturingParensWithin (Atom )とする。 - m、q、parenIndex、およびparenCountをcaptureし、calledされたときに次のstepsをperformする、parameters (x, c)を持つnew
Matcher を返す：Assert : xはMatchState である。Assert : cはMatcherContinuation である。RepeatMatcher (m, q.[[Min]], q.[[Max]], q.[[Greedy]], x, c, parenIndex, parenCount)を返す。
22.2.2.3.1 RepeatMatcher ( m, min, max, greedy, matchState, continue, parenIndex, parenCount )
The abstract operation RepeatMatcher takes arguments m (a
- max = 0なら、continue(matchState)を返す。
- dを、m、min、max、greedy、matchState、continue、parenIndex、およびparenCountをcaptureし、calledされたときに次のstepsをperformする、parameters (y)を持つnew
MatcherContinuation とする：Assert : yはMatchState である。- min = 0かつy.[[EndIndex]] = matchState.[[EndIndex]]なら、
failure を返す。 - min = 0なら、min2を0とする；そうでなければ、min2をmin - 1とする。
- max = +∞なら、max2を+∞とする；そうでなければ、max2をmax - 1とする。
RepeatMatcher (m, min2, max2, greedy, y, continue, parenIndex, parenCount)を返す。
- capabilityをmatchState.[[Captures]]のcopyとする。
- parenIndex + 1からparenIndex + parenCountまでの
inclusive interval 内の各integer kについて、capability[k]をundefined に設定する。 - inputをmatchState.[[Input]]とする。
- eをmatchState.[[EndIndex]]とする。
- xrを
MatchState { [[Input]]: input, [[EndIndex]]: e, [[Captures]]: capability }とする。 - min ≠ 0なら、m(xr, d)を返す。
- greedyが
false なら、- zをcontinue(matchState)とする。
- zが
failure でないなら、zを返す。 - m(xr, d)を返す。
- zをm(xr, d)とする。
- zが
failure でないなら、zを返す。 - continue(matchState)を返す。
Compare
/a[a-z]{2,4}/.exec("abcdefghi")これは
/a[a-z]{2,4}?/.exec("abcdefghi")は
さらに次を考えます：
/(aa|aabaac|ba|b|c)*/.exec("aabaac")これは、aboveのchoice point orderingにより、array
["aaba", "ba"]を返し、次のいずれでもありません：
["aabaac", "aabaac"]
["aabaac", "c"]上記のchoice pointsのorderingは、two numbers（unary notationでrepresented）のgreatest common divisorをcalculateするregular expressionを書くために使用できます。次のexampleは10と15のgcdをcalculateします：
"aaaaaaaaaa,aaaaaaaaaaaaaaa".replace(/^(a+)\1*,\1+$/, "$1")これはunary notationでgcd
RepeatMatcherのstep
/(z)((a+)?(b+)?(c))*/.exec("zaacbbbcac")で見ることができ、これはarray
["zaacbbbcac", "z", "ac", "a", undefined, "c"]を返し、
["zaacbbbcac", "z", "ac", "a", "bbb", "c"]ではありません。なぜなら、outermost *の各iterationが、quantified
RepeatMatcherのstep
/(a*)*/.exec("b")または少しmore complicatedな：
/(a*)b\1+/.exec("baaaac")これはarray
["b", ""]を返します。
22.2.2.3.2 EmptyMatcher ( )
The abstract operation EmptyMatcher takes no arguments and returns a
- nothingをcaptureし、calledされたときに次のstepsをperformする、parameters (matchState, continue)を持つnew
Matcher を返す：Assert : matchStateはMatchState である。Assert : continueはMatcherContinuation である。- continue(matchState)を返す。
22.2.2.3.3 MatchTwoAlternatives ( m1, m2 )
The abstract operation MatchTwoAlternatives takes arguments m1 (a
- m1およびm2をcaptureし、calledされたときに次のstepsをperformする、parameters (matchState, continue)を持つnew
Matcher を返す：Assert : matchStateはMatchState である。Assert : continueはMatcherContinuation である。- resultをm1(matchState, continue)とする。
- resultが
failure でないなら、resultを返す。 - m2(matchState, continue)を返す。
22.2.2.3.4 MatchSequence ( m1, m2, direction )
The abstract operation MatchSequence takes arguments m1 (a
- directionが
forward なら、- m1およびm2をcaptureし、calledされたときに次のstepsをperformする、parameters (matchState, continue)を持つnew
Matcher を返す：Assert : matchStateはMatchState である。Assert : continueはMatcherContinuation である。- dを、continueおよびm2をcaptureし、calledされたときに次のstepsをperformする、parameters (y)を持つnew
MatcherContinuation とする：Assert : yはMatchState である。- m2(y, continue)を返す。
- m1(matchState, d)を返す。
- m1およびm2をcaptureし、calledされたときに次のstepsをperformする、parameters (matchState, continue)を持つnew
Assert : directionはbackward である。- m1およびm2をcaptureし、calledされたときに次のstepsをperformする、parameters (matchState, continue)を持つnew
Matcher を返す：Assert : matchStateはMatchState である。Assert : continueはMatcherContinuation である。- dを、continueおよびm1をcaptureし、calledされたときに次のstepsをperformする、parameters (y)を持つnew
MatcherContinuation とする：Assert : yはMatchState である。- m1(y, continue)を返す。
- m2(matchState, d)を返す。
22.2.2.4 Runtime Semantics: CompileAssertion
The
このsectionは
It is defined piecewise over the following productions:
- regexpRecordをcaptureし、calledされたときに次のstepsをperformする、parameters (matchState, continue)を持つnew
Matcher を返す：Assert : matchStateはMatchState である。Assert : continueはMatcherContinuation である。- inputをmatchState.[[Input]]とする。
- eをmatchState.[[EndIndex]]とする。
- e = 0である、またはregexpRecord.[[Multiline]]が
true でありcharacter input[e - 1]がLineTerminator によってmatchedされるなら、- continue(matchState)を返す。
failure を返す。
y flagがpatternとともに使用される場合であっても、^は常にinputのbeginning、または（regexpRecord.[[Multiline]]が
- regexpRecordをcaptureし、calledされたときに次のstepsをperformする、parameters (matchState, continue)を持つnew
Matcher を返す：Assert : matchStateはMatchState である。Assert : continueはMatcherContinuation である。- inputをmatchState.[[Input]]とする。
- eをmatchState.[[EndIndex]]とする。
- inputLengthをinput内のelementsの数とする。
- e = inputLengthである、またはregexpRecord.[[Multiline]]が
true でありcharacter input[e]がLineTerminator によってmatchedされるなら、- continue(matchState)を返す。
failure を返す。
- regexpRecordをcaptureし、calledされたときに次のstepsをperformする、parameters (matchState, continue)を持つnew
Matcher を返す：Assert : matchStateはMatchState である。Assert : continueはMatcherContinuation である。- inputをmatchState.[[Input]]とする。
- eをmatchState.[[EndIndex]]とする。
- aを
IsWordChar (regexpRecord, input, e - 1)とする。 - bを
IsWordChar (regexpRecord, input, e)とする。 - aが
true でありbがfalse である、またはaがfalse でありbがtrue であるなら、continue(matchState)を返す。 failure を返す。
- regexpRecordをcaptureし、calledされたときに次のstepsをperformする、parameters (matchState, continue)を持つnew
Matcher を返す：Assert : matchStateはMatchState である。Assert : continueはMatcherContinuation である。- inputをmatchState.[[Input]]とする。
- eをmatchState.[[EndIndex]]とする。
- aを
IsWordChar (regexpRecord, input, e - 1)とする。 - bを
IsWordChar (regexpRecord, input, e)とする。 - aが
true でありbがtrue である、またはaがfalse でありbがfalse であるなら、continue(matchState)を返す。 failure を返す。
- mを、arguments regexpRecordおよび
forward を伴うDisjunction のCompileSubpattern とする。 - mをcaptureし、calledされたときに次のstepsをperformする、parameters (matchState, continue)を持つnew
Matcher を返す：Assert : matchStateはMatchState である。Assert : continueはMatcherContinuation である。- dを、nothingをcaptureし、calledされたときに次のstepsをperformする、parameters (y)を持つnew
MatcherContinuation とする：Assert : yはMatchState である。- yを返す。
- resultをm(matchState, d)とする。
- resultが
failure なら、failure を返す。 Assert : resultはMatchState である。- capabilityをresult.[[Captures]]とする。
- inputをmatchState.[[Input]]とする。
- xeをmatchState.[[EndIndex]]とする。
- zを
MatchState { [[Input]]: input, [[EndIndex]]: xe, [[Captures]]: capability }とする。 - continue(z)を返す。
form (?= )はzero-width positive lookaheadをspecifyします。succeedするには、(?= formへのbacktrackingはありません（このunusual behaviourはPerlからinheritedされています）。これは、
例えば、
/(?=(a+))/.exec("baaabac")はfirst bの直後のempty Stringにmatchし、したがってarrayを返します：
["", "aaa"]lookaheadへのbacktrackingがないことをillustrateするため、次を考えます：
/(?=(a+))a*b\1/.exec("baaabac")このexpressionは
["aba", "a"]を返し、次ではありません：
["aaaba", "a"]- mを、arguments regexpRecordおよび
forward を伴うDisjunction のCompileSubpattern とする。 - mをcaptureし、calledされたときに次のstepsをperformする、parameters (matchState, continue)を持つnew
Matcher を返す：Assert : matchStateはMatchState である。Assert : continueはMatcherContinuation である。- dを、nothingをcaptureし、calledされたときに次のstepsをperformする、parameters (y)を持つnew
MatcherContinuation とする：Assert : yはMatchState である。- yを返す。
- resultをm(matchState, d)とする。
- resultが
failure でないなら、failure を返す。 - continue(matchState)を返す。
form (?! )はzero-width negative lookaheadをspecifyします。succeedするには、
/(.*?)a(?!(a+)b\2c)\2(.*)/.exec("baaabaac")は、some positive number n of a's、b、another n a's（first \2でspecified）、およびcがimmediately followedしないaを探します。second \2はnegative lookaheadの外側にあるため、
["baaabaac", "ba", undefined, "abaac"]- mを、arguments regexpRecordおよび
backward を伴うDisjunction のCompileSubpattern とする。 - mをcaptureし、calledされたときに次のstepsをperformする、parameters (matchState, continue)を持つnew
Matcher を返す：Assert : matchStateはMatchState である。Assert : continueはMatcherContinuation である。- dを、nothingをcaptureし、calledされたときに次のstepsをperformする、parameters (y)を持つnew
MatcherContinuation とする：Assert : yはMatchState である。- yを返す。
- resultをm(matchState, d)とする。
- resultが
failure なら、failure を返す。 Assert : resultはMatchState である。- capabilityをresult.[[Captures]]とする。
- inputをmatchState.[[Input]]とする。
- xeをmatchState.[[EndIndex]]とする。
- zを
MatchState { [[Input]]: input, [[EndIndex]]: xe, [[Captures]]: capability }とする。 - continue(z)を返す。
- mを、arguments regexpRecordおよび
backward を伴うDisjunction のCompileSubpattern とする。 - mをcaptureし、calledされたときに次のstepsをperformする、parameters (matchState, continue)を持つnew
Matcher を返す：Assert : matchStateはMatchState である。Assert : continueはMatcherContinuation である。- dを、nothingをcaptureし、calledされたときに次のstepsをperformする、parameters (y)を持つnew
MatcherContinuation とする：Assert : yはMatchState である。- yを返す。
- resultをm(matchState, d)とする。
- resultが
failure でないなら、failure を返す。 - continue(matchState)を返す。
22.2.2.4.1 IsWordChar ( regexpRecord, input, e )
The abstract operation IsWordChar takes arguments regexpRecord (a
- inputLengthをinput内のelementsの数とする。
- e = -1またはe = inputLengthなら、
false を返す。 - charをcharacter input[e]とする。
WordCharacters (regexpRecord)がcharを含むなら、true を返す。false を返す。
22.2.2.5 Runtime Semantics: CompileQuantifier
The
- qpを
QuantifierPrefix のCompileQuantifierPrefix とする。 Record { [[Min]]: qp.[[Min]], [[Max]]: qp.[[Max]], [[Greedy]]:true }を返す。
- qpを
QuantifierPrefix のCompileQuantifierPrefix とする。 Record { [[Min]]: qp.[[Min]], [[Max]]: qp.[[Max]], [[Greedy]]:false }を返す。
22.2.2.6 Runtime Semantics: CompileQuantifierPrefix
The
Record { [[Min]]: 0, [[Max]]: +∞ }を返す。
Record { [[Min]]: 1, [[Max]]: +∞ }を返す。
Record { [[Min]]: 0, [[Max]]: 1 }を返す。
- iを
DecimalDigits のMVとする（12.9.3 を参照）。 Record { [[Min]]: i, [[Max]]: i }を返す。
- iを
DecimalDigits のMVとする。 Record { [[Min]]: i, [[Max]]: +∞ }を返す。
- iをfirst
DecimalDigits のMVとする。 - jをsecond
DecimalDigits のMVとする。 Record { [[Min]]: i, [[Max]]: j }を返す。
22.2.2.7 Runtime Semantics: CompileAtom
The
このsectionは
It is defined piecewise over the following productions:
- charを
PatternCharacter にmatchedするcharacterとする。 - charSetをcharacter charを含むone-element
CharSet とする。 CharacterSetMatcher (regexpRecord, charSet,false , direction)を返す。
- charSetを
AllCharacters (regexpRecord)とする。 - regexpRecord.[[DotAll]]が
true でないなら、LineTerminator productionのright-hand side上のcode pointに対応するすべてのcharactersをcharSetからremoveする。
CharacterSetMatcher (regexpRecord, charSet,false , direction)を返す。
- ccをargument regexpRecordを伴う
CharacterClass のCompileCharacterClass とする。 - csをcc.[[CharSet]]とする。
- regexpRecord.[[UnicodeSets]]が
false である、またはcsのすべてのCharSetElement がsingle characterからなる（csがemptyの場合を含む）なら、CharacterSetMatcher (regexpRecord, cs, cc.[[Invert]], direction)を返す。 Assert : cc.[[Invert]]はfalse である。- listOfMatchersを
Matchers のemptyList とする。 - cs内のmore than 1 characterを含む各
CharSetElement sについて、lengthのdescending orderでiteratingして、以下を行う- cs2をsのlast code pointを含むone-element
CharSet とする。 - m2を
CharacterSetMatcher (regexpRecord, cs2,false , direction)とする。 - s内の各code point c1について、そのsecond-to-last code pointからbackwardsにiteratingして、以下を行う
- cs1をc1を含むone-element
CharSet とする。 - m1を
CharacterSetMatcher (regexpRecord, cs1,false , direction)とする。 - m2を
MatchSequence (m1, m2, direction)に設定する。
- cs1をc1を含むone-element
- m2をlistOfMatchersへappendする。
- cs2をsのlast code pointを含むone-element
- singlesを、single characterからなるcsのすべての
CharSetElement を含むCharSet とする。 CharacterSetMatcher (regexpRecord, singles,false , direction)をlistOfMatchersへappendする。- csがcharactersのempty sequenceを含むなら、
EmptyMatcher ()をlistOfMatchersへappendする。 - m2をlistOfMatchers内のlast
Matcher とする。 - listOfMatchersの各
Matcher m1について、そのsecond-to-last elementからbackwardsにiteratingして、以下を行う- m2を
MatchTwoAlternatives (m1, m2)に設定する。
- m2を
- m2を返す。
- mを、arguments regexpRecordおよびdirectionを伴う
Disjunction のCompileSubpattern とする。 - parenIndexを
CountLeftCapturingParensBefore (Atom )とする。 - direction、m、およびparenIndexをcaptureし、calledされたときに次のstepsをperformする、parameters (x, c)を持つnew
Matcher を返す：Assert : xはMatchState である。Assert : cはMatcherContinuation である。- dを、x、c、direction、およびparenIndexをcaptureし、calledされたときに次のstepsをperformする、parameters (y)を持つnew
MatcherContinuation とする：Assert : yはMatchState である。- capabilityをy.[[Captures]]のcopyとする。
- inputをx.[[Input]]とする。
- xeをx.[[EndIndex]]とする。
- yeをy.[[EndIndex]]とする。
- directionが
forward なら、Assert : xe ≤ yeである。- rを
CaptureRange { [[StartIndex]]: xe, [[EndIndex]]: ye }とする。
- そうでなければ、
Assert : directionはbackward である。Assert : ye ≤ xeである。- rを
CaptureRange { [[StartIndex]]: ye, [[EndIndex]]: xe }とする。
- capability[parenIndex + 1]をrに設定する。
- zを
MatchState { [[Input]]: input, [[EndIndex]]: ye, [[Captures]]: capability }とする。 - c(z)を返す。
- m(x, d)を返す。
form ( )のparenthesesは、\ followed by a non-zero decimal number）で使用されたり、replace Stringでreferencedされたり、regular expression matching (?: )を使用します。
- addModifiersを
RegularExpressionModifiers にmatchedするsource textとする。 - removeModifiersをempty Stringとする。
- modifiedRerを
UpdateModifiers (regexpRecord,CodePointsToString (addModifiers), removeModifiers)とする。 - arguments modifiedRerおよびdirectionを伴う
Disjunction のCompileSubpattern を返す。
- addModifiersをfirst
RegularExpressionModifiers にmatchedするsource textとする。 - removeModifiersをsecond
RegularExpressionModifiers にmatchedするsource textとする。 - modifiedRerを
UpdateModifiers (regexpRecord,CodePointsToString (addModifiers),CodePointsToString (removeModifiers))とする。 - arguments modifiedRerおよびdirectionを伴う
Disjunction のCompileSubpattern を返す。
- nを
DecimalEscape のCapturingGroupNumber とする。 Assert : n ≤ regexpRecord.[[CapturingGroupsCount]]である。BackreferenceMatcher (regexpRecord, « n », direction)を返す。
\ followed by a non-zero decimal number nというformのescape sequenceは、nth set of capturing parentheses（
- charValueを
CharacterEscape のCharacterValue とする。 - charをcharacter valueがcharValueであるcharacterとする。
- charSetをcharacter charを含むone-element
CharSet とする。 CharacterSetMatcher (regexpRecord, charSet,false , direction)を返す。
- csをargument regexpRecordを伴う
CharacterClassEscape のCompileToCharSet とする。 - regexpRecord.[[UnicodeSets]]が
false である、またはcsのすべてのCharSetElement がsingle characterからなる（csがemptyの場合を含む）なら、CharacterSetMatcher (regexpRecord, cs,false , direction)を返す。 - listOfMatchersを
Matchers のemptyList とする。 - cs内のmore than 1 characterを含む各
CharSetElement sについて、lengthのdescending orderでiteratingして、以下を行う- cs2をsのlast code pointを含むone-element
CharSet とする。 - m2を
CharacterSetMatcher (regexpRecord, cs2,false , direction)とする。 - s内の各code point c1について、そのsecond-to-last code pointからbackwardsにiteratingして、以下を行う
- cs1をc1を含むone-element
CharSet とする。 - m1を
CharacterSetMatcher (regexpRecord, cs1,false , direction)とする。 - m2を
MatchSequence (m1, m2, direction)に設定する。
- cs1をc1を含むone-element
- m2をlistOfMatchersへappendする。
- cs2をsのlast code pointを含むone-element
- singlesを、single characterからなるcsのすべての
CharSetElement を含むCharSet とする。 CharacterSetMatcher (regexpRecord, singles,false , direction)をlistOfMatchersへappendする。- csがcharactersのempty sequenceを含むなら、
EmptyMatcher ()をlistOfMatchersへappendする。 - m2をlistOfMatchers内のlast
Matcher とする。 - listOfMatchersの各
Matcher m1について、そのsecond-to-last elementからbackwardsにiteratingして、以下を行う- m2を
MatchTwoAlternatives (m1, m2)に設定する。
- m2を
- m2を返す。
- matchingGroupSpecifiersを
GroupSpecifiersThatMatch (GroupName )とする。 - parenIndicesを新しい空の
List とする。 - matchingGroupSpecifiersの各
GroupSpecifier groupSpecifierについて、以下を行う- parenIndexを
CountLeftCapturingParensBefore (groupSpecifier)とする。 - parenIndexをparenIndicesへappendする。
- parenIndexを
BackreferenceMatcher (regexpRecord, parenIndices, direction)を返す。
22.2.2.7.1 CharacterSetMatcher ( regexpRecord, charSet, invert, direction )
The abstract operation CharacterSetMatcher takes arguments regexpRecord (a
- regexpRecord.[[UnicodeSets]]が
true なら、Assert : invertはfalse である。Assert : charSetのすべてのCharSetElement はsingle characterからなる。
- regexpRecord、charSet、invert、およびdirectionをcaptureし、calledされたときに次のstepsをperformする、parameters (x, c)を持つnew
Matcher を返す：Assert : xはMatchState である。Assert : cはMatcherContinuation である。- inputをx.[[Input]]とする。
- endIndexをx.[[EndIndex]]とする。
- directionが
forward なら、fをendIndex + 1とする。 - そうでなければ、fをendIndex - 1とする。
- inputLengthをinput内のelementsの数とする。
- f < 0またはf > inputLengthなら、
failure を返す。 - indexを
min (endIndex, f)とする。 - charをcharacter input[index]とする。
- ccを
Canonicalize (regexpRecord, char)とする。 Canonicalize (regexpRecord, a)がccであるような、exactly one character aを含むCharSetElement がcharSet内に存在するなら、foundをtrue とする；そうでなければ、foundをfalse とする。- invertが
false であり、かつfoundがfalse なら、failure を返す。 - invertが
true であり、かつfoundがtrue なら、failure を返す。 - capabilityをx.[[Captures]]とする。
- yを
MatchState { [[Input]]: input, [[EndIndex]]: f, [[Captures]]: capability }とする。 - c(y)を返す。
22.2.2.7.2 BackreferenceMatcher ( regexpRecord, ns, direction )
The abstract operation BackreferenceMatcher takes arguments regexpRecord (a
- regexpRecord、ns、およびdirectionをcaptureし、calledされたときに次のstepsをperformする、parameters (x, c)を持つnew
Matcher を返す：Assert : xはMatchState である。Assert : cはMatcherContinuation である。- inputをx.[[Input]]とする。
- capabilityをx.[[Captures]]とする。
- rを
undefined とする。 - nsの各
integer nについて、以下を行う- capability[n]が
undefined でないなら、Assert : rはundefined である。- rをcapability[n]に設定する。
- capability[n]が
- rが
undefined なら、c(x)を返す。 - endIndexをx.[[EndIndex]]とする。
- rsをr.[[StartIndex]]とする。
- reをr.[[EndIndex]]とする。
- lengthをre - rsとする。
- directionが
forward なら、fをendIndex + lengthとする。 - そうでなければ、fをendIndex - lengthとする。
- inputLengthをinput内のelementsの数とする。
- f < 0またはf > inputLengthなら、
failure を返す。 - gを
min (endIndex, f)とする。 - 0（inclusive）からlength（exclusive）までの
interval 内に、Canonicalize (regexpRecord, input[rs + i])がCanonicalize (regexpRecord, input[g + i])でないようなinteger iが存在するなら、failure を返す。 - yを
MatchState { [[Input]]: input, [[EndIndex]]: f, [[Captures]]: capability }とする。 - c(y)を返す。
22.2.2.7.3 Canonicalize ( regexpRecord, char )
The abstract operation Canonicalize takes arguments regexpRecord (a
HasEitherUnicodeFlag (regexpRecord)がtrue であり、かつregexpRecord.[[IgnoreCase]]がtrue なら、- Unicode Character Databaseのfile
CaseFolding.txtがcharに対するsimpleまたはcommon case folding mappingを提供するなら、そのmappingをcharにapplyしたresultを返す。 - charを返す。
- Unicode Character Databaseのfile
- regexpRecord.[[IgnoreCase]]が
false なら、charを返す。 Assert : charはUTF-16 code unitである。- codePointをnumeric valueがcharのnumeric valueであるcode pointとする。
- uを、Unicode Default Case Conversion algorithmに従ったtoUppercase(« codePoint »)とする。
- uStringを
CodePointsToString (u)とする。 - uStringのlength ≠ 1なら、charを返す。
- codeUnitをuStringのsingle code unit elementとする。
- charのnumeric value ≥ 128であり、かつcodeUnitのnumeric value < 128なら、charを返す。
- codeUnitを返す。
ß（U+00DF LATIN SMALL LETTER SHARP S）をssやSSへmapしません。ただし、Basic Latin blockの外側にあるcode pointsをその内側のcode pointsへmapすることはあります—例えば、ſ（U+017F LATIN SMALL LETTER LONG S）はs（U+0073 LATIN SMALL LETTER S）へcase-foldし、K（U+212A KELVIN SIGN）はk（U+006B LATIN SMALL LETTER K）へcase-foldします。それらのcode pointsを含むStringsは/[a-z]/uiのようなregular expressionsによってmatchedされます。
Ω（U+2126 OHM SIGN）はtoUppercaseではitselfへmappedされますが、toCasefoldではΩ（U+03A9 GREEK CAPITAL LETTER OMEGA）とともにω（U+03C9 GREEK SMALL LETTER OMEGA）へmappedされるため、/[ω]/uiおよび/[\u03A9]/uiによってmatchedされますが、/[ω]/iまたは/[\u03A9]/iによってはmatchedされません。また、Basic Latin blockの外側のcode pointはその内側のcode pointへmappedされないため、/[a-z]/iによってmatchedされません。
22.2.2.7.4 UpdateModifiers ( regexpRecord, add, remove )
The abstract operation UpdateModifiers takes arguments regexpRecord (a
Assert : addおよびremoveはcommon elementsを持たない。- ignoreCaseをregexpRecord.[[IgnoreCase]]とする。
- multilineをregexpRecord.[[Multiline]]とする。
- dotAllをregexpRecord.[[DotAll]]とする。
- unicodeをregexpRecord.[[Unicode]]とする。
- unicodeSetsをregexpRecord.[[UnicodeSets]]とする。
- capturingGroupsCountをregexpRecord.[[CapturingGroupsCount]]とする。
- removeが
"i" を含むなら、ignoreCaseをfalse に設定する。 - そうでなく、addが
"i" を含むなら、ignoreCaseをtrue に設定する。 - removeが
"m" を含むなら、multilineをfalse に設定する。 - そうでなく、addが
"m" を含むなら、multilineをtrue に設定する。 - removeが
"s" を含むなら、dotAllをfalse に設定する。 - そうでなく、addが
"s" を含むなら、dotAllをtrue に設定する。 RegExp Record { [[IgnoreCase]]: ignoreCase, [[Multiline]]: multiline, [[DotAll]]: dotAll, [[Unicode]]: unicode, [[UnicodeSets]]: unicodeSets, [[CapturingGroupsCount]]: capturingGroupsCount }を返す。
22.2.2.8 Runtime Semantics: CompileCharacterClass
The
- charSetをargument regexpRecordを伴う
ClassContents のCompileToCharSet とする。 Record { [[CharSet]]: charSet, [[Invert]]:false }を返す。
- charSetをargument regexpRecordを伴う
ClassContents のCompileToCharSet とする。 - regexpRecord.[[UnicodeSets]]が
true なら、Record { [[CharSet]]:CharacterComplement (regexpRecord, charSet), [[Invert]]:false }を返す。
Record { [[CharSet]]: charSet, [[Invert]]:true }を返す。
22.2.2.9 Runtime Semantics: CompileToCharSet
The
このsectionは
It is defined piecewise over the following productions:
- empty
CharSet を返す。
- charSetをargument regexpRecordを伴う
ClassAtom のCompileToCharSet とする。 - otherSetをargument regexpRecordを伴う
NonemptyClassRangesNoDash のCompileToCharSet とする。 CharSets charSetおよびotherSetのunionを返す。
- charSetをargument regexpRecordを伴うfirst
ClassAtom のCompileToCharSet とする。 - otherSetをargument regexpRecordを伴うsecond
ClassAtom のCompileToCharSet とする。 - remainingSetをargument regexpRecordを伴う
ClassContents のCompileToCharSet とする。 - rangeSetを
CharacterRange (charSet, otherSet)とする。 - rangeSetおよびremainingSetのunionを返す。
- charSetをargument regexpRecordを伴う
ClassAtomNoDash のCompileToCharSet とする。 - otherSetをargument regexpRecordを伴う
NonemptyClassRangesNoDash のCompileToCharSet とする。 CharSets charSetおよびotherSetのunionを返す。
- charSetをargument regexpRecordを伴う
ClassAtomNoDash のCompileToCharSet とする。 - otherSetをargument regexpRecordを伴う
ClassAtom のCompileToCharSet とする。 - remainingSetをargument regexpRecordを伴う
ClassContents のCompileToCharSet とする。 - rangeSetを
CharacterRange (charSet, otherSet)とする。 - rangeSetおよびremainingSetのunionを返す。
patternがcaseをignoreする場合でも、rangeのtwo endsのcaseは、どのcharactersがrangeに属するかをdetermineする上でsignificantです。したがって、例えば、pattern /[E-F]/iはletters E、F、e、およびfのみにmatchします。一方、pattern /[E-f]/iはUnicode Basic Latin block内のすべてのuppercaseおよびlowercase lettersに加えて、symbols [, \, ], ^, _, and `にもmatchします。
- characterはliterallyに扱われることも、rangeをdenoteすることもできます。これは、
- single character
-U+002D (HYPHEN-MINUS)を含むCharSet を返す。
SourceCharacter にmatchedするcharacterを含むCharSet を返す。
- charValueをこの
ClassEscape のCharacterValue とする。 - charをcharacter valueがcharValueであるcharacterとする。
- single character charを含む
CharSet を返す。
\b、\B、およびbackreferencesを除き、regular expressionのrestでallowedされる任意のescape sequencesを使用できます。\bはbackspace characterを意味し、\Bおよびbackreferencesはerrorsをraiseします。
- characters
0,1,2,3,4,5,6,7,8, and9を含むten-elementCharSet を返す。
- charSetを
CharacterClassEscape :: d CharSet とする。 CharacterComplement (regexpRecord, charSet)を返す。
WhiteSpace またはLineTerminator productionsのright-hand side上のcode pointに対応するすべてのcharactersを含むCharSet を返す。
- charSetを
CharacterClassEscape :: s CharSet とする。 CharacterComplement (regexpRecord, charSet)を返す。
MaybeSimpleCaseFolding (regexpRecord,WordCharacters (regexpRecord))を返す。
- charSetを
CharacterClassEscape :: w CharSet とする。 CharacterComplement (regexpRecord, charSet)を返す。
- argument regexpRecordを伴う
UnicodePropertyValueExpression のCompileToCharSet を返す。
- charSetをargument regexpRecordを伴う
UnicodePropertyValueExpression のCompileToCharSet とする。 Assert : charSetはsingle code pointsのみを含む。CharacterComplement (regexpRecord, charSet)を返す。
- psを
UnicodePropertyName にmatchedするsource textとする。 - pを
UnicodeMatchProperty (regexpRecord, ps)とする。 Assert : pはTable 65 の“Property name and aliases ” columnにlistedされているUnicode property name またはproperty aliasである。- vsを
UnicodePropertyValue にmatchedするsource textとする。 - vを
UnicodeMatchPropertyValue (p, vs)とする。 - charSetを、character database definitionがproperty p with value vを含むすべてのUnicode code pointsを含む
CharSet とする。 MaybeSimpleCaseFolding (regexpRecord, charSet)を返す。
- sを
LoneUnicodePropertyNameOrValue にmatchedするsource textとする。 UnicodeMatchPropertyValue (General_Category, s)が、PropertyValueAliases.txtにlistedされているGeneral_Category (gc) propertyに対するUnicode property valueまたはproperty value aliasであるなら、- “General_Category” property with value sをcharacter database definitionが含むすべてのUnicode code pointsを含む
CharSet を返す。
- “General_Category” property with value sをcharacter database definitionが含むすべてのUnicode code pointsを含む
- pを
UnicodeMatchProperty (regexpRecord, s)とする。 Assert : pはTable 66 の“Property name and aliases ” columnにlistedされているbinary Unicode propertyまたはbinary property alias、またはTable 67 の“Property name ” columnにlistedされているbinary Unicode property of stringsである。- charSetを、character database definitionがproperty p with value “True”を含むすべてのCharSetElementsを含む
CharSet とする。 MaybeSimpleCaseFolding (regexpRecord, charSet)を返す。
- charSetをargument regexpRecordを伴う
ClassSetRange のCompileToCharSet とする。 ClassUnion がpresentなら、- otherSetをargument regexpRecordを伴う
ClassUnion のCompileToCharSet とする。 CharSets charSetおよびotherSetのunionを返す。
- otherSetをargument regexpRecordを伴う
- charSetを返す。
- charSetをargument regexpRecordを伴う
ClassSetOperand のCompileToCharSet とする。 ClassUnion がpresentなら、- otherSetをargument regexpRecordを伴う
ClassUnion のCompileToCharSet とする。 CharSets charSetおよびotherSetのunionを返す。
- otherSetをargument regexpRecordを伴う
- charSetを返す。
- charSetをargument regexpRecordを伴うfirst
ClassSetOperand のCompileToCharSet とする。 - otherSetをargument regexpRecordを伴うsecond
ClassSetOperand のCompileToCharSet とする。 CharSets charSetおよびotherSetのintersectionを返す。
- charSetをargument regexpRecordを伴う
ClassIntersection のCompileToCharSet とする。 - otherSetをargument regexpRecordを伴う
ClassSetOperand のCompileToCharSet とする。 CharSets charSetおよびotherSetのintersectionを返す。
- charSetをargument regexpRecordを伴うfirst
ClassSetOperand のCompileToCharSet とする。 - otherSetをargument regexpRecordを伴うsecond
ClassSetOperand のCompileToCharSet とする。 - otherSetのCharSetElementsでもあるものを除いた、charSetのCharSetElementsを含む
CharSet を返す。
- charSetをargument regexpRecordを伴う
ClassSubtraction のCompileToCharSet とする。 - otherSetをargument regexpRecordを伴う
ClassSetOperand のCompileToCharSet とする。 - otherSetのCharSetElementsでもあるものを除いた、charSetのCharSetElementsを含む
CharSet を返す。
- charSetをargument regexpRecordを伴うfirst
ClassSetCharacter のCompileToCharSet とする。 - otherSetをargument regexpRecordを伴うsecond
ClassSetCharacter のCompileToCharSet とする。 MaybeSimpleCaseFolding (regexpRecord,CharacterRange (charSet, otherSet))を返す。
resultはしばしばtwo or more rangesから構成されます。UnicodeSetsが
- charSetをargument regexpRecordを伴う
ClassSetCharacter のCompileToCharSet とする。 MaybeSimpleCaseFolding (regexpRecord, charSet)を返す。
- charSetをargument regexpRecordを伴う
ClassStringDisjunction のCompileToCharSet とする。 MaybeSimpleCaseFolding (regexpRecord, charSet)を返す。
- argument regexpRecordを伴う
NestedClass のCompileToCharSet を返す。
- argument regexpRecordを伴う
ClassContents のCompileToCharSet を返す。
- charSetをargument regexpRecordを伴う
ClassContents のCompileToCharSet とする。 CharacterComplement (regexpRecord, charSet)を返す。
- argument regexpRecordを伴う
CharacterClassEscape のCompileToCharSet を返す。
- argument regexpRecordを伴う
ClassStringDisjunctionContents のCompileToCharSet を返す。
- sをargument regexpRecordを伴う
ClassString のCompileClassSetString とする。 - one string sを含む
CharSet を返す。
- sをargument regexpRecordを伴う
ClassString のCompileClassSetString とする。 - charSetをone string sを含む
CharSet とする。 - otherSetをargument regexpRecordを伴う
ClassStringDisjunctionContents のCompileToCharSet とする。 CharSets charSetおよびotherSetのunionを返す。
- charValueをこの
ClassSetCharacter のCharacterValue とする。 - charをcharacter valueがcharValueであるcharacterとする。
- single character charを含む
CharSet を返す。
- single character U+0008 (BACKSPACE)を含む
CharSet を返す。
22.2.2.9.1 CharacterRange ( charSet, otherSet )
The abstract operation CharacterRange takes arguments charSet (a
22.2.2.9.2 HasEitherUnicodeFlag ( regexpRecord )
The abstract operation HasEitherUnicodeFlag takes argument regexpRecord (a
- regexpRecord.[[Unicode]]が
true またはregexpRecord.[[UnicodeSets]]がtrue なら、true を返す。 false を返す。
22.2.2.9.3 WordCharacters ( regexpRecord )
The abstract operation WordCharacters takes argument regexpRecord (a \b、\B、\w、および\Wのpurposesにおいて“word characters”とconsideredされるcharactersを含む
- basicWordCharsをASCII word characters内のすべてのcharacterを含む
CharSet とする。 - extraWordCharsを、basicWordChars内にないが
Canonicalize (regexpRecord, c)がbasicWordChars内にあるようなすべてのcharacters cを含むCharSet とする。 Assert :HasEitherUnicodeFlag (regexpRecord)がtrue かつregexpRecord.[[IgnoreCase]]がtrue でない限り、extraWordCharsはemptyである。- basicWordCharsおよびextraWordCharsのunionを返す。
22.2.2.9.4 AllCharacters ( regexpRecord )
The abstract operation AllCharacters takes argument regexpRecord (a
- regexpRecord.[[UnicodeSets]]が
true であり、かつregexpRecord.[[IgnoreCase]]がtrue なら、- Simple Case Folding mappingを持たない（すなわち、
scf (c)=cである）すべてのUnicode code points cを含むCharSet を返す。
- Simple Case Folding mappingを持たない（すなわち、
HasEitherUnicodeFlag (regexpRecord)がtrue なら、- すべてのcode point valuesを含む
CharSet を返す。
- すべてのcode point valuesを含む
- すべてのcode unit valuesを含む
CharSet を返す。
22.2.2.9.5 MaybeSimpleCaseFolding ( regexpRecord, charSet )
The abstract operation MaybeSimpleCaseFolding takes arguments regexpRecord (a CaseFolding.txt内のSimple Case Folding（
- regexpRecord.[[UnicodeSets]]が
false またはregexpRecord.[[IgnoreCase]]がfalse なら、charSetを返す。 - otherSetをnew empty
CharSet とする。 - charSetの各
CharSetElement sについて、以下を行う- tをcharactersのempty sequenceとする。
- s内の各single code point codePointについて、以下を行う
scf (codePoint)をtへappendする。
- tをotherSetへaddする。
- otherSetを返す。
22.2.2.9.6 CharacterComplement ( regexpRecord, complement )
The abstract operation CharacterComplement takes arguments regexpRecord (a
- charSetを
AllCharacters (regexpRecord)とする。 - complementのCharSetElementsでもあるものを除いた、charSetのCharSetElementsを含む
CharSet を返す。
22.2.2.9.7 UnicodeMatchProperty ( regexpRecord, p )
The abstract operation UnicodeMatchProperty takes arguments regexpRecord (a
- regexpRecord.[[UnicodeSets]]が
true であり、かつpがTable 67 の“Property name ” columnにlistedされているUnicode property name であるなら、- Unicode code points pの
List を返す。
- Unicode code points pの
Assert : pはTable 65 またはTable 66 の“Property name and aliases ” columnにlistedされているUnicode property name またはproperty aliasである。- cを、corresponding rowの“
Canonical property name ” columnでgivenされたpのcanonicalproperty name とする。 - Unicode code points cの
List を返す。
Implementationsは、
例えば、Script_Extensions（scx（property alias）はvalidですが、script_extensionsやScxはvalidではありません。
listed propertiesは、UTS18 RL1.2がrequireするもののsupersetを形成します。
これらのtables内のentriesのspellings（casingを含む）は、Unicode Character Databaseのfile PropertyAliases.txtで使用されるspellingsとmatchします。そのfile内のprecise spellingsはstableであることがguaranteedされています。
General_Category |
General_Category |
gc |
|
Script |
Script |
sc |
|
Script_Extensions |
Script_Extensions |
scx |
ASCII |
ASCII |
ASCII_Hex_Digit |
ASCII_Hex_Digit |
AHex |
|
Alphabetic |
Alphabetic |
Alpha |
|
Any |
Any |
Assigned |
Assigned |
Bidi_Control |
Bidi_Control |
Bidi_C |
|
Bidi_Mirrored |
Bidi_Mirrored |
Bidi_M |
|
Case_Ignorable |
Case_Ignorable |
CI |
|
Cased |
Cased |
Changes_When_Casefolded |
Changes_When_Casefolded |
CWCF |
|
Changes_When_Casemapped |
Changes_When_Casemapped |
CWCM |
|
Changes_When_Lowercased |
Changes_When_Lowercased |
CWL |
|
Changes_When_NFKC_Casefolded |
Changes_When_NFKC_Casefolded |
CWKCF |
|
Changes_When_Titlecased |
Changes_When_Titlecased |
CWT |
|
Changes_When_Uppercased |
Changes_When_Uppercased |
CWU |
|
Dash |
Dash |
Default_Ignorable_Code_Point |
Default_Ignorable_Code_Point |
DI |
|
Deprecated |
Deprecated |
Dep |
|
Diacritic |
Diacritic |
Dia |
|
Emoji |
Emoji |
Emoji_Component |
Emoji_Component |
EComp |
|
Emoji_Modifier |
Emoji_Modifier |
EMod |
|
Emoji_Modifier_Base |
Emoji_Modifier_Base |
EBase |
|
Emoji_Presentation |
Emoji_Presentation |
EPres |
|
Extended_Pictographic |
Extended_Pictographic |
ExtPict |
|
Extender |
Extender |
Ext |
|
Grapheme_Base |
Grapheme_Base |
Gr_Base |
|
Grapheme_Extend |
Grapheme_Extend |
Gr_Ext |
|
Hex_Digit |
Hex_Digit |
Hex |
|
IDS_Binary_Operator |
IDS_Binary_Operator |
IDSB |
|
IDS_Trinary_Operator |
IDS_Trinary_Operator |
IDST |
|
ID_Continue |
ID_Continue |
IDC |
|
ID_Start |
ID_Start |
IDS |
|
Ideographic |
Ideographic |
Ideo |
|
Join_Control |
Join_Control |
Join_C |
|
Logical_Order_Exception |
Logical_Order_Exception |
LOE |
|
Lowercase |
Lowercase |
Lower |
|
Math |
Math |
Noncharacter_Code_Point |
Noncharacter_Code_Point |
NChar |
|
Pattern_Syntax |
Pattern_Syntax |
Pat_Syn |
|
Pattern_White_Space |
Pattern_White_Space |
Pat_WS |
|
Quotation_Mark |
Quotation_Mark |
QMark |
|
Radical |
Radical |
Regional_Indicator |
Regional_Indicator |
RI |
|
Sentence_Terminal |
Sentence_Terminal |
STerm |
|
Soft_Dotted |
Soft_Dotted |
SD |
|
Terminal_Punctuation |
Terminal_Punctuation |
Term |
|
Unified_Ideograph |
Unified_Ideograph |
UIdeo |
|
Uppercase |
Uppercase |
Upper |
|
Variation_Selector |
Variation_Selector |
VS |
|
White_Space |
White_Space |
space |
|
XID_Continue |
XID_Continue |
XIDC |
|
XID_Start |
XID_Start |
XIDS |
Basic_Emoji |
Emoji_Keycap_Sequence |
RGI_Emoji_Modifier_Sequence |
RGI_Emoji_Flag_Sequence |
RGI_Emoji_Tag_Sequence |
RGI_Emoji_ZWJ_Sequence |
RGI_Emoji |
22.2.2.9.8 UnicodeMatchPropertyValue ( p, v )
The abstract operation UnicodeMatchPropertyValue takes arguments p (
Assert : pはTable 65 の“Canonical property name ” columnにlistedされているcanonicalかつunaliasedなUnicode property name である。Assert : vはUnicode property pに対するproperty valueまたはproperty value aliasであり、PropertyValueAliases.txtにlistedされている。- valueを、corresponding rowの“Canonical property value” columnでgivenされたvのcanonical property valueとする。
- Unicode code points valueの
List を返す。
Implementationsは、PropertyValueAliases.txtにlistedされているUnicode property valuesおよびproperty value aliasesをsupportしなければなりません。interoperabilityをensureするため、implementationsは他のproperty valuesまたはproperty value aliasesをsupportしてはなりません。
例えば、XpeoおよびOld_PersianはvalidなScript_Extensions valuesですが、xpeoおよびOld Persianはvalidではありません。
このalgorithmはUAX44にlistedされているsymbolic valuesのmatching rulesとは異なります：case、Is prefixはsupportされません。
22.2.2.10 Runtime Semantics: CompileClassSetString
The
- charactersのempty sequenceを返す。
- argument regexpRecordを伴う
NonEmptyClassString のCompileClassSetString を返す。
- csをargument regexpRecordを伴う
ClassSetCharacter のCompileToCharSet とする。 - s1を、csのsingle
CharSetElement であるcharactersのsequenceとする。 NonEmptyClassString がpresentなら、- s2をargument regexpRecordを伴う
NonEmptyClassString のCompileClassSetString とする。 - s1とs2のconcatenationを返す。
- s2をargument regexpRecordを伴う
- s1を返す。
22.2.3 Abstract Operations for RegExp Creation
22.2.3.1 RegExpCreate ( pattern, flags )
The abstract operation RegExpCreate takes arguments pattern (an ECMAScript language value) and flags (a String or
- objを !
RegExpAlloc (%RegExp% ) とする。 - ?
RegExpInitialize (obj, pattern, flags)を返す。
22.2.3.2 RegExpAlloc ( newTarget )
The abstract operation RegExpAlloc takes argument newTarget (a
- objを ?
OrdinaryCreateFromConstructor (newTarget,"%RegExp.prototype%" , « [[OriginalSource]], [[OriginalFlags]], [[RegExpRecord]], [[RegExpMatcher]] ») とする。 - !
DefinePropertyOrThrow (obj,"lastIndex" , PropertyDescriptor { [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false })を実行する。 - objを返す。
22.2.3.3 RegExpInitialize ( obj, pattern, flags )
The abstract operation RegExpInitialize takes arguments obj (an Object), pattern (an ECMAScript language value), and flags (an ECMAScript language value) and returns either a
- patternが
undefined なら、patternをempty Stringに設定する。 - そうでなければ、patternを ?
ToString (pattern) に設定する。 - flagsが
undefined なら、flagsをempty Stringに設定する。 - そうでなければ、flagsを ?
ToString (flags) に設定する。 - flagsが
"d" 、"g" 、"i" 、"m" 、"s" 、"u" 、"v" 、または"y" 以外のcode unitを含むなら、SyntaxError 例外をthrowする。 - flagsが同じcode unitを複数回含むなら、
SyntaxError 例外をthrowする。 - flagsが
"i" を含むなら、iをtrue とする；そうでなければ、iをfalse とする。 - flagsが
"m" を含むなら、mをtrue とする；そうでなければ、mをfalse とする。 - flagsが
"s" を含むなら、sをtrue とする；そうでなければ、sをfalse とする。 - flagsが
"u" を含むなら、uをtrue とする；そうでなければ、uをfalse とする。 - flagsが
"v" を含むなら、vをtrue とする；そうでなければ、vをfalse とする。 - uが
true またはvがtrue なら、- patternTextを
StringToCodePoints (pattern)とする。
- patternTextを
- そうでなければ、
- patternTextを、patternの各16-bit elementをUnicode BMP code pointとしてinterpretingしたresultとする。UTF-16 decodingはelementsにapplyされない。
- parseResultを
ParsePattern (patternText, u, v)とする。 - parseResultが
SyntaxError objectsのnon-emptyList なら、SyntaxError 例外をthrowする。 Assert : parseResultはPattern Parse Node である。- obj.[[OriginalSource]]をpatternに設定する。
- obj.[[OriginalFlags]]をflagsに設定する。
- capturingGroupsCountを
CountLeftCapturingParensWithin (parseResult)とする。 - regexpRecordを
RegExp Record { [[IgnoreCase]]: i, [[Multiline]]: m, [[DotAll]]: s, [[Unicode]]: u, [[UnicodeSets]]: v, [[CapturingGroupsCount]]: capturingGroupsCount }とする。 - obj.[[RegExpRecord]]をregexpRecordに設定する。
- obj.[[RegExpMatcher]]を、argument regexpRecordを伴うparseResultの
CompilePattern に設定する。 - ?
Set (obj,"lastIndex" ,+0 𝔽,true )を実行する。 - objを返す。
22.2.3.4 Static Semantics: ParsePattern ( patternText, u, v )
The abstract operation ParsePattern takes arguments patternText (a sequence of Unicode code points), u (a Boolean), and v (a Boolean) and returns a
このsectionは
It performs the following steps when called:
- vが
true であり、かつuがtrue なら、- parseResultを、one or more
SyntaxError objectsを含むList とする。
- parseResultを、one or more
- そうでなく、vが
true なら、 - そうでなく、uが
true なら、 - そうでなければ、
- parseResultを返す。
22.2.4 The RegExp Constructor
RegExp
- %RegExp%です。
global object の"RegExp" propertyのinitial valueです。constructor として呼び出されたとき、新しいRegExp objectを作成およびinitializeします。constructor としてではなくfunctionとして呼び出されたとき、新しいRegExp object、またはonly argumentがRegExp objectである場合はargument自体のいずれかを返します。- class definitionの
extendsclauseのvalueとして使用できます。指定されたRegExp behaviourをinheritしようとするsubclassconstructors は、必要なinternal slotsを持つsubclass instancesを作成およびinitializeするために、RegExpconstructor へのsupercallを含まなければなりません。
22.2.4.1 RegExp ( patternOrRegexp, flags )
このfunctionは呼び出されたとき、次のstepsを実行します：
- patternIsRegExpを ?
IsRegExp (patternOrRegexp) とする。 - NewTargetが
undefined なら、- newTargetを
active function object とする。 - patternIsRegExpが
true であり、かつflagsがundefined なら、
- newTargetを
- そうでなければ、
- newTargetをNewTargetとする。
- patternOrRegexpがObjectであり、かつpatternOrRegexpが[[RegExpMatcher]] internal slotを持つなら、
- patternSourceをpatternOrRegexp.[[OriginalSource]]とする。
- flagsが
undefined なら、flagsをpatternOrRegexp.[[OriginalFlags]]に設定する。
- そうでなく、patternIsRegExpが
true なら、 - そうでなければ、
- patternSourceをpatternOrRegexpとする。
- objを ?
RegExpAlloc (newTarget) とする。 - ?
RegExpInitialize (obj, patternSource, flags)を返す。
patternが
22.2.5 Properties of the RegExp Constructor
RegExp
- valueが
%Function.prototype% である[[Prototype]] internal slotを持ちます。 - 次のpropertiesを持ちます：
22.2.5.1 RegExp.escape ( string )
このfunctionは、regular expression
これは呼び出されたとき、次のstepsを実行します：
- stringがStringでないなら、
TypeError 例外をthrowする。 - escapedをempty Stringとする。
- codePointListを
StringToCodePoints (string)とする。 - codePointListの各code point codePointについて、以下を行う
- escapedがempty Stringであり、かつcodePointが
DecimalDigit またはAsciiLetter のいずれかによってmatchedされるなら、NOTE : leading digitをescapeすると、outputが、\0character escapeまたは\1のようなDecimalEscape の後に使用され得るpattern textに対応し、preceding escape sequenceのextensionとしてinterpretedされるのではなく、なおstringにmatchすることをensureする。leading ASCII letterをescapeすることは、\cの後のcontextについて同じことを行う。- numericValueをcodePointのnumeric valueとする。
- hexを
Number::toString (𝔽 (numericValue), 16)とする。 Assert : hexのlengthは2である。- escapedをcode unit 0x005C (REVERSE SOLIDUS)、
"x" 、およびhexのstring-concatenation に設定する。
- そうでなければ、
- escapedをescapedと
EncodeForRegExpEscape (codePoint)のstring-concatenation に設定する。
- escapedをescapedと
- escapedがempty Stringであり、かつcodePointが
- escapedを返す。
similar namesを持つにもかかわらず、RegExp.escapeはsimilar actionsをperformしません。前者はstringとしてrepresentationするためにpatternをescapeし、このfunctionはpatternの内側でrepresentationするためにstringをescapeします。
22.2.5.1.1 EncodeForRegExpEscape ( codePoint )
The abstract operation EncodeForRegExpEscape takes argument codePoint (a code point) and returns a String. これはcodePointにmatchingするための
- codePointが
SyntaxCharacter によってmatchedされる、またはcodePointがU+002F (SOLIDUS)であるなら、- 0x005C (REVERSE SOLIDUS)と
UTF16EncodeCodePoint (codePoint)のstring-concatenation を返す。
- 0x005C (REVERSE SOLIDUS)と
- codePointが
Table 63 の“Code Point” columnにlistedされているcode pointなら、- 0x005C (REVERSE SOLIDUS)と、“Code Point” columnがcodePointを含むrowの“ControlEscape” column内のstringの
string-concatenation を返す。
- 0x005C (REVERSE SOLIDUS)と、“Code Point” columnがcodePointを含むrowの“ControlEscape” column内のstringの
- otherPunctuatorsを
",-=<>#&!%:;@~'`" とcode unit 0x0022 (QUOTATION MARK)のstring-concatenation とする。 - toEscapeを
StringToCodePoints (otherPunctuators)とする。 - toEscapeがcodePointを含む、codePointが
WhiteSpace またはLineTerminator のいずれかによってmatchedされる、またはcodePointがleading surrogate またはtrailing surrogate とsame numeric valueを持つなら、- codePointNumberをcodePointのnumeric valueとする。
- codePointNumber ≤ 0xFFなら、
- hexを
Number::toString (𝔽 (codePointNumber), 16)とする。 - code unit 0x005C (REVERSE SOLIDUS)、
"x" 、およびStringPad (hex, 2,"0" ,start )のstring-concatenation を返す。
- hexを
- escapedをempty Stringとする。
- codeUnitsを
UTF16EncodeCodePoint (codePoint)とする。 - codeUnitsの各code unit codeUnitについて、以下を行う
- escapedをescapedと
UnicodeEscape (codeUnit)のstring-concatenation に設定する。
- escapedをescapedと
- escapedを返す。
UTF16EncodeCodePoint (codePoint)を返す。
22.2.5.2 RegExp.prototype
RegExp.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
22.2.5.3 get RegExp [ %Symbol.species% ]
RegExp[%Symbol.species%]は、set accessor functionが
this valueを返す。
このfunctionの
RegExp prototype methodsは通常、その
22.2.6 Properties of the RegExp Prototype Object
RegExp prototype objectは：
- %RegExp.prototype%です。
ordinary object です。- RegExp instanceではなく、[[RegExpMatcher]] internal slotも、RegExp instance objectsの他のinternal slotsも持ちません。
- valueが
%Object.prototype% である[[Prototype]] internal slotを持ちます。
RegExp prototype objectは自身の
22.2.6.1 RegExp.prototype.constructor
RegExp.prototype.constructorのinitial valueは
22.2.6.2 RegExp.prototype.exec ( string )
このmethodはstring内でregular expression patternのoccurrenceをsearchし、matchのresultsを含むArrayを返すか、stringがmatchしなかった場合は
これは呼び出されたとき、次のstepsを実行します：
- regexpを
this valueとする。 - ?
RequireInternalSlot (regexp, [[RegExpMatcher]])を実行する。 - stringを ?
ToString (string) に設定する。 - ?
RegExpBuiltinExec (regexp, string)を返す。
22.2.6.3 get RegExp.prototype.dotAll
RegExp.prototype.dotAllは、set accessor functionが
- regexpを
this valueとする。 - codeUnitをcode unit 0x0073 (LATIN SMALL LETTER S)とする。
- ?
RegExpHasFlag (regexp, codeUnit)を返す。
22.2.6.4 get RegExp.prototype.flags
RegExp.prototype.flagsは、set accessor functionが
- regexpを
this valueとする。 - regexpがObjectでないなら、
TypeError 例外をthrowする。 - codeUnitsを新しい空の
List とする。 - hasIndicesを
ToBoolean (?Get (regexp,"hasIndices" ))とする。 - hasIndicesが
true なら、code unit 0x0064 (LATIN SMALL LETTER D)をcodeUnitsへappendする。 - globalを
ToBoolean (?Get (regexp,"global" ))とする。 - globalが
true なら、code unit 0x0067 (LATIN SMALL LETTER G)をcodeUnitsへappendする。 - ignoreCaseを
ToBoolean (?Get (regexp,"ignoreCase" ))とする。 - ignoreCaseが
true なら、code unit 0x0069 (LATIN SMALL LETTER I)をcodeUnitsへappendする。 - multilineを
ToBoolean (?Get (regexp,"multiline" ))とする。 - multilineが
true なら、code unit 0x006D (LATIN SMALL LETTER M)をcodeUnitsへappendする。 - dotAllを
ToBoolean (?Get (regexp,"dotAll" ))とする。 - dotAllが
true なら、code unit 0x0073 (LATIN SMALL LETTER S)をcodeUnitsへappendする。 - unicodeを
ToBoolean (?Get (regexp,"unicode" ))とする。 - unicodeが
true なら、code unit 0x0075 (LATIN SMALL LETTER U)をcodeUnitsへappendする。 - unicodeSetsを
ToBoolean (?Get (regexp,"unicodeSets" ))とする。 - unicodeSetsが
true なら、code unit 0x0076 (LATIN SMALL LETTER V)をcodeUnitsへappendする。 - stickyを
ToBoolean (?Get (regexp,"sticky" ))とする。 - stickyが
true なら、code unit 0x0079 (LATIN SMALL LETTER Y)をcodeUnitsへappendする。 - code unitsが
List codeUnitsのelementsであるString valueを返す。codeUnitsがelementsを持たない場合、empty Stringが返される。
22.2.6.4.1 RegExpHasFlag ( regexp, codeUnit )
The abstract operation RegExpHasFlag takes arguments regexp (an ECMAScript language value) and codeUnit (a code unit) and returns either a
- regexpがObjectでないなら、
TypeError 例外をthrowする。 - regexpが[[OriginalFlags]] internal slotを持たないなら、
SameValue (regexp,%RegExp.prototype% )がtrue なら、undefined を返す。TypeError 例外をThrowする。
- flagsをregexp.[[OriginalFlags]]とする。
- flagsがcodeUnitを含むなら、
true を返す。 false を返す。
22.2.6.5 get RegExp.prototype.global
RegExp.prototype.globalは、set accessor functionが
- regexpを
this valueとする。 - codeUnitをcode unit 0x0067 (LATIN SMALL LETTER G)とする。
- ?
RegExpHasFlag (regexp, codeUnit)を返す。
22.2.6.6 get RegExp.prototype.hasIndices
RegExp.prototype.hasIndicesは、set accessor functionが
- regexpを
this valueとする。 - codeUnitをcode unit 0x0064 (LATIN SMALL LETTER D)とする。
- ?
RegExpHasFlag (regexp, codeUnit)を返す。
22.2.6.7 get RegExp.prototype.ignoreCase
RegExp.prototype.ignoreCaseは、set accessor functionが
- regexpを
this valueとする。 - codeUnitをcode unit 0x0069 (LATIN SMALL LETTER I)とする。
- ?
RegExpHasFlag (regexp, codeUnit)を返す。
22.2.6.8 RegExp.prototype [ %Symbol.match% ] ( string )
このmethodは呼び出されたとき、次のstepsを実行します：
- regexpを
this valueとする。 - regexpがObjectでないなら、
TypeError 例外をthrowする。 - stringを ?
ToString (string) に設定する。 - flagsを ?
ToString (?Get (regexp,"flags" )) とする。 - flagsが
"g" を含まないなら、?RegExpExec (regexp, string)を返す。 - flagsが
"u" を含む、またはflagsが"v" を含むなら、fullUnicodeをtrue とする；そうでなければ、fullUnicodeをfalse とする。 - ?
Set (regexp,"lastIndex" ,+0 𝔽,true )を実行する。 - arrayを !
ArrayCreate (0) とする。 - matchCountを0とする。
- 繰り返す：
- resultを ?
RegExpExec (regexp, string) とする。 - resultが
null なら、- matchCount = 0なら、
null を返す。 - arrayを返す。
- matchCount = 0なら、
- matchStringを ?
ToString (?Get (result,"0" )) とする。 - !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (matchCount)), matchString)を実行する。 - matchStringがempty Stringなら、
- matchCountをmatchCount + 1に設定する。
- resultを ?
このmethodの
22.2.6.9 RegExp.prototype [ %Symbol.matchAll% ] ( string )
このmethodは呼び出されたとき、次のstepsを実行します：
- regexpを
this valueとする。 - regexpがObjectでないなら、
TypeError 例外をthrowする。 - stringを ?
ToString (string) に設定する。 - speciesCtorを ?
SpeciesConstructor (regexp,%RegExp% ) とする。 - flagsを ?
ToString (?Get (regexp,"flags" )) とする。 - matcherを ?
Construct (speciesCtor, « regexp, flags ») とする。 - lastIndexを ?
ToLength (?Get (regexp,"lastIndex" )) とする。 - ?
Set (matcher,"lastIndex" , lastIndex,true )を実行する。 - flagsが
"g" を含むなら、globalをtrue とする。 - そうでなければ、globalを
false とする。 - flagsが
"u" を含む、またはflagsが"v" を含むなら、fullUnicodeをtrue とする。 - そうでなければ、fullUnicodeを
false とする。 CreateRegExpStringIterator (matcher, string, global, fullUnicode)を返す。
このmethodの
22.2.6.10 get RegExp.prototype.multiline
RegExp.prototype.multilineは、set accessor functionが
- regexpを
this valueとする。 - codeUnitをcode unit 0x006D (LATIN SMALL LETTER M)とする。
- ?
RegExpHasFlag (regexp, codeUnit)を返す。
22.2.6.11 RegExp.prototype [ %Symbol.replace% ] ( string, replaceValue )
このmethodは呼び出されたとき、次のstepsを実行します：
- regexpを
this valueとする。 - regexpがObjectでないなら、
TypeError 例外をthrowする。 - stringを ?
ToString (string) に設定する。 - stringLengthをstringのlengthとする。
- functionalReplaceを
IsCallable (replaceValue)とする。 - functionalReplaceが
false なら、- replaceValueを ?
ToString (replaceValue) に設定する。
- replaceValueを ?
- flagsを ?
ToString (?Get (regexp,"flags" )) とする。 - flagsが
"g" を含むなら、globalをtrue とする；そうでなければ、globalをfalse とする。 - globalが
true なら、- ?
Set (regexp,"lastIndex" ,+0 𝔽,true )を実行する。
- ?
- resultsを新しい空の
List とする。 - doneを
false とする。 - doneが
false である間、繰り返す- resultを ?
RegExpExec (regexp, string) とする。 - resultが
null なら、- doneを
true に設定する。
- doneを
- そうでなければ、
- resultを ?
- accumulatedResultをempty Stringとする。
- nextSourcePositionを0とする。
- resultsの各要素resultについて、以下を行う
- resultLengthを ?
LengthOfArrayLike (result) とする。 - capturesCountを
max (resultLength - 1, 0)とする。 - matchedを ?
ToString (?Get (result,"0" )) とする。 - matchLengthをmatchedのlengthとする。
- positionを ?
ToIntegerOrInfinity (?Get (result,"index" )) とする。 - positionを、0とstringLengthの間に
clamping したresultに設定する。 - capturesを新しい空の
List とする。 - captureNumberを1とする。
- captureNumber ≤ capturesCountの間、繰り返す
- captureを ?
Get (result, !ToString (𝔽 (captureNumber))) とする。 - captureが
undefined でないなら、- captureを ?
ToString (capture) に設定する。
- captureを ?
- captureをcapturesへappendする。
NOTE : captureNumber = 1のとき、preceding stepはfirst elementをcapturesへputする（index 0に）。より一般に、captureNumberth capture（captureNumberth set of capturing parenthesesによってcapturedされたcharacters）はcaptures[captureNumber - 1]にある。- captureNumberをcaptureNumber + 1に設定する。
- captureを ?
- namedCapturesを ?
Get (result,"groups" ) とする。 - functionalReplaceが
true なら、- replacerArgsを« matched »、captures、および«
𝔽 (position), string »のlist-concatenation とする。 - namedCapturesが
undefined でないなら、- namedCapturesをreplacerArgsへappendする。
- replacementValueを ?
Call (replaceValue,undefined , replacerArgs) とする。 - replacementStringを ?
ToString (replacementValue) とする。
- replacerArgsを« matched »、captures、および«
- そうでなければ、
- namedCapturesが
undefined でないなら、- namedCapturesを ?
ToObject (namedCaptures) に設定する。
- namedCapturesを ?
- replacementStringを ?
GetSubstitution (matched, string, position, captures, namedCaptures, replaceValue) とする。
- namedCapturesが
- position ≥ nextSourcePositionなら、
NOTE : positionは通常backwardsにmoveすべきではない。そうなる場合、それはill-behaving RegExp subclass、またはregexpのglobal flagやその他のcharacteristicsをchangeするためのaccess triggered side-effectの使用を示す。そのようなcasesでは、corresponding substitutionはignoredされる。- accumulatedResultを、accumulatedResult、stringのnextSourcePositionからpositionまでの
substring 、およびreplacementStringのstring-concatenation に設定する。 - nextSourcePositionをposition + matchLengthに設定する。
- resultLengthを ?
- nextSourcePosition ≥ stringLengthなら、accumulatedResultを返す。
- accumulatedResultとstringのnextSourcePositionからの
substring のstring-concatenation を返す。
このmethodの
22.2.6.12 RegExp.prototype [ %Symbol.search% ] ( string )
このmethodは呼び出されたとき、次のstepsを実行します：
- regexpを
this valueとする。 - regexpがObjectでないなら、
TypeError 例外をthrowする。 - stringを ?
ToString (string) に設定する。 - previousLastIndexを ?
Get (regexp,"lastIndex" ) とする。 - previousLastIndexが
+0 𝔽でないなら、- ?
Set (regexp,"lastIndex" ,+0 𝔽,true )を実行する。
- ?
- resultを ?
RegExpExec (regexp, string) とする。 - currentLastIndexを ?
Get (regexp,"lastIndex" ) とする。 SameValue (currentLastIndex, previousLastIndex)がfalse なら、- ?
Set (regexp,"lastIndex" , previousLastIndex,true )を実行する。
- ?
- resultが
null なら、-1 𝔽を返す。 - ?
Get (result,"index" )を返す。
このmethodの
このRegExp objectの
22.2.6.13 get RegExp.prototype.source
RegExp.prototype.sourceは、set accessor functionが
- regexpを
this valueとする。 - regexpがObjectでないなら、
TypeError 例外をthrowする。 - regexpが[[OriginalSource]] internal slotを持たないなら、
SameValue (regexp,%RegExp.prototype% )がtrue なら、"(?:)" を返す。TypeError 例外をThrowする。
Assert : regexpは[[OriginalFlags]] internal slotを持つ。- sourceをregexp.[[OriginalSource]]とする。
- flagsをregexp.[[OriginalFlags]]とする。
EscapeRegExpPattern (source, flags)を返す。
22.2.6.13.1 EscapeRegExpPattern ( pattern, flags )
The abstract operation EscapeRegExpPattern takes arguments pattern (a String) and flags (a String) and returns a String. It performs the following steps when called:
- flagsが
"v" を含むなら、- patternSymbolを
Pattern とする。[+UnicodeMode, +UnicodeSetsMode]
- patternSymbolを
- そうでなく、flagsが
"u" を含むなら、- patternSymbolを
Pattern とする。[+UnicodeMode, ~UnicodeSetsMode]
- patternSymbolを
- そうでなければ、
- patternSymbolを
Pattern とする。[~UnicodeMode, ~UnicodeSetsMode]
- patternSymbolを
- escapedPatternを、UTF-16 encoded Unicode code points（
6.1.4 ）としてinterpretedされたpatternにequivalentなpatternSymbolのformのStringとする。この中では、certain code pointsが以下でdescribedされる通りescapedされます。escapedPatternはpatternとdifferしてもよいしdifferしなくてもよい；しかし、escapedPatternをpatternSymbolとしてevaluatingすることでresultするAbstract Closure は、constructed objectの[[RegExpMatcher]] internal slotによってgivenされるAbstract Closure とidenticallyにbehaveしなければなりません。このabstract operationをpatternおよびflagsのsame valuesでmultiple callsすると、identical resultsをproduceしなければなりません。 - pattern内にoccurringするcode points
/または任意のLineTerminator は、" / " ではなく"/" 、escapedPattern、"/" 、およびflagsのstring-concatenation が（appropriate lexical contextにおいて）constructed regular expressionとidenticallyにbehaveするRegularExpressionLiteral としてparseできることをensureするため、必要に応じてescapedPattern内でescapedされなければなりません。例えば、patternが"/" なら、escapedPatternは"\/" または"\u002F" などであり得ますが、"/" ではあり得ません。なぜなら、flagsがfollowする///はRegularExpressionLiteral ではなくSingleLineComment としてparseされるからです。patternがempty Stringなら、このspecificationはescapedPatternを"(?:)" とすることで満たされ得ます。 - escapedPatternを返す。
similar namesを持つにもかかわらず、RegExp.escapeとEscapeRegExpPatternはsimilar actionsをperformしません。前者はpatternの内側でrepresentationするためにstringをescapeし、このfunctionはstringとしてrepresentationするためにpatternをescapeします。
22.2.6.14 RegExp.prototype [ %Symbol.split% ] ( string, limit )
このmethodは、stringをStringへconvertingしたresultのsubstringsがstoredされたArrayを返します。substringsは、
/a*?/[Symbol.split]("ab")はarray ["a", "b"]へevaluatesされ、一方/a*/[Symbol.split]("ab")はarray ["","b"]へevaluatesされます。）
stringがempty Stringである（またはそれへconvertsされる）場合、resultはregular expressionがempty Stringにmatchできるかどうかに依存します。matchできる場合、result arrayはelementsを含みません。そうでなければ、result arrayはone elementを含み、それはempty Stringです。
regular expressionがcapturing parenthesesを含む場合、separatorがmatchedされるたびに、capturing parenthesesのresults（任意の
/<(\/)?([^<>]+)>/[Symbol.split]("A<B>bold</B>and<CODE>coded</CODE>")はarrayへevaluatesされます：
["A", undefined, "B", "bold", "/", "B", "and", undefined, "CODE", "coded", "/", "CODE", ""]limitが
このmethodは呼び出されたとき、次のstepsを実行します：
- regexpを
this valueとする。 - regexpがObjectでないなら、
TypeError 例外をthrowする。 - stringを ?
ToString (string) に設定する。 - speciesCtorを ?
SpeciesConstructor (regexp,%RegExp% ) とする。 - flagsを ?
ToString (?Get (regexp,"flags" )) とする。 - flagsが
"u" を含む、またはflagsが"v" を含むなら、unicodeMatchingをtrue とする。 - そうでなければ、unicodeMatchingを
false とする。 - flagsが
"y" を含むなら、newFlagsをflagsとする。 - そうでなければ、newFlagsをflagsと
"y" のstring-concatenation とする。 - splitterを ?
Construct (speciesCtor, « regexp, newFlags ») とする。 - arrayを !
ArrayCreate (0) とする。 - lengthAを0とする。
- limitが
undefined なら、limを232 - 1とする；そうでなければ、limをℝ (?ToUint32 (limit))とする。 - lim = 0なら、arrayを返す。
- stringがempty Stringなら、
- matchResultを ?
RegExpExec (splitter, string) とする。 - matchResultが
null でないなら、arrayを返す。 - !
CreateDataPropertyOrThrow (array,"0" , string)を実行する。 - arrayを返す。
- matchResultを ?
- sizeをstringのlengthとする。
- lastMatchEndを0とする。
- searchIndexをlastMatchEndとする。
- searchIndex < sizeの間、繰り返す
- ?
Set (splitter,"lastIndex" ,𝔽 (searchIndex),true )を実行する。 - matchResultを ?
RegExpExec (splitter, string) とする。 - matchResultが
null なら、- searchIndexを
AdvanceStringIndex (string, searchIndex, unicodeMatching)に設定する。
- searchIndexを
- そうでなければ、
- matchEndを
ℝ (?ToLength (?Get (splitter,"lastIndex" )))とする。 - matchEndを
min (matchEnd, size)に設定する。 - matchEnd = lastMatchEndなら、
- searchIndexを
AdvanceStringIndex (string, searchIndex, unicodeMatching)に設定する。
- searchIndexを
- そうでなければ、
- substringをstringのlastMatchEndからsearchIndexまでの
substring とする。 - !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (lengthA)), substring)を実行する。 - lengthAをlengthA + 1に設定する。
- lengthA = limなら、arrayを返す。
- lastMatchEndをmatchEndに設定する。
- numberOfCapturesを ?
LengthOfArrayLike (matchResult) とする。 - numberOfCapturesを
max (numberOfCaptures - 1, 0)に設定する。 - captureIndexを1とする。
- captureIndex ≤ numberOfCapturesの間、繰り返す
- searchIndexをlastMatchEndに設定する。
- substringをstringのlastMatchEndからsearchIndexまでの
- matchEndを
- ?
- substringをstringのlastMatchEndからsizeまでの
substring とする。 - !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (lengthA)), substring)を実行する。 - arrayを返す。
このmethodの
このmethodは、このRegExp objectの
22.2.6.15 get RegExp.prototype.sticky
RegExp.prototype.stickyは、set accessor functionが
- regexpを
this valueとする。 - codeUnitをcode unit 0x0079 (LATIN SMALL LETTER Y)とする。
- ?
RegExpHasFlag (regexp, codeUnit)を返す。
22.2.6.16 RegExp.prototype.test ( string )
このmethodは呼び出されたとき、次のstepsを実行します：
- regexpを
this valueとする。 - regexpがObjectでないなら、
TypeError 例外をthrowする。 - stringを ?
ToString (string) に設定する。 - matchを ?
RegExpExec (regexp, string) とする。 - matchが
null なら、false を返す。 true を返す。
22.2.6.17 RegExp.prototype.toString ( )
- regexpを
this valueとする。 - regexpがObjectでないなら、
TypeError 例外をthrowする。 - patternを ?
ToString (?Get (regexp,"source" )) とする。 - flagsを ?
ToString (?Get (regexp,"flags" )) とする。 - resultを
"/" 、pattern、"/" 、およびflagsのstring-concatenation とする。 - resultを返す。
returned Stringは、このobjectとsame behaviourを持つanother RegExp objectへevaluatesされる
22.2.6.18 get RegExp.prototype.unicode
RegExp.prototype.unicodeは、set accessor functionが
- regexpを
this valueとする。 - codeUnitをcode unit 0x0075 (LATIN SMALL LETTER U)とする。
- ?
RegExpHasFlag (regexp, codeUnit)を返す。
22.2.6.19 get RegExp.prototype.unicodeSets
RegExp.prototype.unicodeSetsは、set accessor functionが
- regexpを
this valueとする。 - codeUnitをcode unit 0x0076 (LATIN SMALL LETTER V)とする。
- ?
RegExpHasFlag (regexp, codeUnit)を返す。
22.2.7 Abstract Operations for RegExp Matching
22.2.7.1 RegExpExec ( regexp, string )
The abstract operation RegExpExec takes arguments regexp (an Object) and string (a String) and returns either a
- execを ?
Get (regexp,"exec" ) とする。 IsCallable (exec)がtrue なら、- resultを ?
Call (exec, regexp, « string ») とする。 - resultがObjectでなく、かつresultが
null でないなら、TypeError 例外をthrowする。 - resultを返す。
- resultを ?
- ?
RequireInternalSlot (regexp, [[RegExpMatcher]])を実行する。 - ?
RegExpBuiltinExec (regexp, string)を返す。
callableな
22.2.7.2 RegExpBuiltinExec ( regexp, string )
The abstract operation RegExpBuiltinExec takes arguments regexp (an initialized RegExp instance) and string (a String) and returns either a
- lengthをstringのlengthとする。
- lastIndexを
ℝ (?ToLength (!Get (regexp,"lastIndex" )))とする。 - flagsをregexp.[[OriginalFlags]]とする。
- flagsが
"g" を含むなら、globalをtrue とする；そうでなければ、globalをfalse とする。 - flagsが
"y" を含むなら、stickyをtrue とする；そうでなければ、stickyをfalse とする。 - flagsが
"d" を含むなら、hasIndicesをtrue とする；そうでなければ、hasIndicesをfalse とする。 - globalが
false であり、かつstickyがfalse なら、lastIndexを0に設定する。 - matcherをregexp.[[RegExpMatcher]]とする。
- flagsが
"u" を含む、またはflagsが"v" を含むなら、fullUnicodeをtrue とする；そうでなければ、fullUnicodeをfalse とする。 - matchSucceededを
false とする。 - fullUnicodeが
true なら、inputをStringToCodePoints (string)とする；そうでなければ、inputを、そのelementsがstringのelementsであるcode unitsであるList とする。 NOTE : inputの各elementはcharacterであるとconsiderされる。- matchSucceededが
false である間、繰り返す- lastIndex > lengthなら、
- globalが
true またはstickyがtrue なら、- ?
Set (regexp,"lastIndex" ,+0 𝔽,true )を実行する。
- ?
null を返す。
- globalが
- inputIndexを、stringのelement lastIndexからobtainedされたcharacterのinput内のindexとする。
- resultをmatcher(input, inputIndex)とする。
- resultが
failure なら、- stickyが
true なら、- ?
Set (regexp,"lastIndex" ,+0 𝔽,true )を実行する。 null を返す。
- ?
- lastIndexを
AdvanceStringIndex (string, lastIndex, fullUnicode)に設定する。
- stickyが
- そうでなければ、
Assert : resultはMatchState である。- matchSucceededを
true に設定する。
- lastIndex > lengthなら、
- endIndexをresult.[[EndIndex]]とする。
- fullUnicodeが
true なら、endIndexをGetStringIndex (string, endIndex)に設定する。 - globalが
true またはstickyがtrue なら、 - capturingGroupsCountをresult.[[Captures]]内のelementsの数とする。
Assert : capturingGroupsCount = regexp.[[RegExpRecord]].[[CapturingGroupsCount]]である。Assert : capturingGroupsCount < 232 - 1である。- arrayを !
ArrayCreate (capturingGroupsCount + 1) とする。 Assert : arrayの"length" propertyのmathematical value はcapturingGroupsCount + 1である。- !
CreateDataPropertyOrThrow (array,"index" ,𝔽 (lastIndex))を実行する。 - !
CreateDataPropertyOrThrow (array,"input" , string)を実行する。 - matchを
Match Record { [[StartIndex]]: lastIndex, [[EndIndex]]: endIndex }とする。 - indicesを新しい空の
List とする。 - groupNamesを新しい空の
List とする。 - matchをindicesへappendする。
- matchedSubstringを
GetMatchString (string, match)とする。 - !
CreateDataPropertyOrThrow (array,"0" , matchedSubstring)を実行する。 - regexpが任意の
GroupName を含むなら、- groupsを
OrdinaryObjectCreate (null )とする。 - hasGroupsを
true とする。
- groupsを
- そうでなければ、
- groupsを
undefined とする。 - hasGroupsを
false とする。
- groupsを
- !
CreateDataPropertyOrThrow (array,"groups" , groups)を実行する。 - matchedGroupNamesを新しい空の
List とする。 - 1 ≤ i ≤ capturingGroupsCountである各
integer iについて、ascending orderで、以下を行う- captureをresult.[[Captures]]のith elementとする。
- captureが
undefined なら、- capturedValueを
undefined とする。 undefined をindicesへappendする。
- capturedValueを
- そうでなければ、
- captureStartをcapture.[[StartIndex]]とする。
- captureEndをcapture.[[EndIndex]]とする。
- fullUnicodeが
true なら、- captureStartを
GetStringIndex (string, captureStart)に設定する。 - captureEndを
GetStringIndex (string, captureEnd)に設定する。
- captureStartを
- captureRecordを
Match Record { [[StartIndex]]: captureStart, [[EndIndex]]: captureEnd }とする。 - capturedValueを
GetMatchString (string, captureRecord)とする。 - captureRecordをindicesへappendする。
- !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (i)), capturedValue)を実行する。 - regexpのith captureが
GroupName でdefinedされていたなら、- groupNameをその
GroupName のCapturingGroupName とする。 - matchedGroupNamesがgroupNameを含むなら、
Assert : capturedValueはundefined である。undefined をgroupNamesへappendする。
- そうでなければ、
- capturedValueが
undefined でないなら、groupNameをmatchedGroupNamesへappendする。 NOTE : groupNameとnamedされたmultiple groupsが存在する場合、groupsはこの時点ですでにgroupName propertyを持っている可能性がある。しかし、groupsは、そのpropertiesがすべてwritabledata properties であるordinary object であるため、CreateDataPropertyOrThrow へのcallはそれでもsucceedすることがguaranteedされる。- !
CreateDataPropertyOrThrow (groups, groupName, capturedValue)を実行する。 - groupNameをgroupNamesへappendする。
- capturedValueが
- groupNameをその
- そうでなければ、
undefined をgroupNamesへappendする。
- hasIndicesが
true なら、- indicesArrayを
MakeMatchIndicesIndexPairArray (string, indices, groupNames, hasGroups)とする。 - !
CreateDataPropertyOrThrow (array,"indices" , indicesArray)を実行する。
- indicesArrayを
- arrayを返す。
22.2.7.3 AdvanceStringIndex ( string, index, unicode )
The abstract operation AdvanceStringIndex takes arguments string (a String), index (a non-negative
Assert : index ≤ 253 - 1である。- unicodeが
false なら、index + 1を返す。 - lengthをstringのlengthとする。
- index + 1 ≥ lengthなら、index + 1を返す。
- codePointを
CodePointAt (string, index)とする。 - index + codePoint.[[CodeUnitCount]]を返す。
22.2.7.4 GetStringIndex ( string, codePointIndex )
The abstract operation GetStringIndex takes arguments string (a String) and codePointIndex (a non-negative
- stringがempty Stringなら、0を返す。
- lengthをstringのlengthとする。
- codeUnitCountを0とする。
- codePointCountを0とする。
- codeUnitCount < lengthの間、繰り返す
- codePointCount = codePointIndexなら、codeUnitCountを返す。
- codePointを
CodePointAt (string, codeUnitCount)とする。 - codeUnitCountをcodeUnitCount + codePoint.[[CodeUnitCount]]に設定する。
- codePointCountをcodePointCount + 1に設定する。
- lengthを返す。
22.2.7.5 Match Records
Match Recordは、regular expression matchまたはcaptureのstartおよびend indicesをencapsulateするために使用される
Match Recordsは
| Field Name | Value | Meaning |
|---|---|---|
| [[StartIndex]] | a non-negative |
matchがbeginする（inclusive）stringのstartからのcode unitsの数。 |
| [[EndIndex]] | an |
matchがendする（exclusive）stringのstartからのcode unitsの数。 |
22.2.7.6 GetMatchString ( string, match )
The abstract operation GetMatchString takes arguments string (a String) and match (a
22.2.7.7 GetMatchIndexPair ( string, match )
The abstract operation GetMatchIndexPair takes arguments string (a String) and match (a
Assert : match.[[StartIndex]] ≤ match.[[EndIndex]] ≤ stringのlengthである。CreateArrayFromList («𝔽 (match.[[StartIndex]]),𝔽 (match.[[EndIndex]]) »)を返す。
22.2.7.8 MakeMatchIndicesIndexPairArray ( string, indices, groupNames, hasGroups )
The abstract operation MakeMatchIndicesIndexPairArray takes arguments string (a String), indices (a
- nをindices内のelementsの数とする。
Assert : n < 232 - 1である。Assert : groupNamesはn - 1個のelementsを持つ。NOTE : groupNamesList はindices[1]からstartingしてindicesList とalignedされたelementsを含む。- arrayを !
ArrayCreate (n) とする。 - hasGroupsが
true なら、- groupsを
OrdinaryObjectCreate (null )とする。
- groupsを
- そうでなければ、
- groupsを
undefined とする。
- groupsを
- !
CreateDataPropertyOrThrow (array,"groups" , groups)を実行する。 - 0 ≤ i < nである各
integer iについて、ascending orderで、以下を行う- matchIndicesをindices[i]とする。
- matchIndicesが
undefined でないなら、- matchIndexPairを
GetMatchIndexPair (string, matchIndices)とする。
- matchIndexPairを
- そうでなければ、
- matchIndexPairを
undefined とする。
- matchIndexPairを
- !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (i)), matchIndexPair)を実行する。 - i > 0なら、
- nameをgroupNames[i - 1]とする。
- nameが
undefined でないなら、Assert : groupsはundefined でない。NOTE : nameとnamedされたmultiple groupsが存在する場合、groupsはこの時点ですでにname propertyを持っている可能性がある。しかし、groupsは、そのpropertiesがすべてwritabledata properties であるordinary object であるため、CreateDataPropertyOrThrow へのcallはそれでもsucceedすることがguaranteedされる。- !
CreateDataPropertyOrThrow (groups, name, matchIndexPair)を実行する。
- arrayを返す。
22.2.8 Properties of RegExp Instances
RegExp instancesは
ECMAScript 2015より前は、RegExp instancesはown RegExp.prototypeの
RegExp instancesはまた次のpropertyを持ちます：
22.2.8.1 lastIndex
22.2.9 RegExp String Iterator Objects
RegExp String Iteratorは、some specific RegExp instance objectに対してmatchingしながら、some specific String instance object上のspecific iterationを表すobjectです。RegExp String Iterator objectsにはnamed
22.2.9.1 CreateRegExpStringIterator ( regexp, string, global, fullUnicode )
The abstract operation CreateRegExpStringIterator takes arguments regexp (an Object), string (a String), global (a Boolean), and fullUnicode (a Boolean) and returns an Object. It performs the following steps when called:
- iteratorを
OrdinaryObjectCreate (%RegExpStringIteratorPrototype% , « [[IteratingRegExp]], [[IteratedString]], [[Global]], [[Unicode]], [[Done]] »)とする。 - iterator.[[IteratingRegExp]]をregexpに設定する。
- iterator.[[IteratedString]]をstringに設定する。
- iterator.[[Global]]をglobalに設定する。
- iterator.[[Unicode]]をfullUnicodeに設定する。
- iterator.[[Done]]を
false に設定する。 - iteratorを返す。
22.2.9.2 The %RegExpStringIteratorPrototype% Object
%RegExpStringIteratorPrototype% objectは：
- すべての
RegExp String Iterator objects によってinheritedされるpropertiesを持ちます。 ordinary object です。- valueが
%Iterator.prototype% である[[Prototype]] internal slotを持ちます。 - 次のpropertiesを持ちます：
22.2.9.2.1 %RegExpStringIteratorPrototype%.next ( )
- iteratorObjを
this valueとする。 - iteratorObjがObjectでないなら、
TypeError 例外をthrowする。 - iteratorObjが
RegExp String Iterator Object Instanceのすべてのinternal slotsを持たないなら（22.2.9.3 を参照）、TypeError 例外をthrowする。 - iteratorObj.[[Done]]が
true なら、CreateIteratorResultObject (undefined ,true )を返す。
- regexpをiteratorObj.[[IteratingRegExp]]とする。
- stringをiteratorObj.[[IteratedString]]とする。
- globalをiteratorObj.[[Global]]とする。
- fullUnicodeをiteratorObj.[[Unicode]]とする。
- matchを ?
RegExpExec (regexp, string) とする。 - matchが
null なら、- iteratorObj.[[Done]]を
true に設定する。 CreateIteratorResultObject (undefined ,true )を返す。
- iteratorObj.[[Done]]を
- globalが
false なら、- iteratorObj.[[Done]]を
true に設定する。 CreateIteratorResultObject (match,false )を返す。
- iteratorObj.[[Done]]を
- matchStringを ?
ToString (?Get (match,"0" )) とする。 - matchStringがempty Stringなら、
CreateIteratorResultObject (match,false )を返す。
22.2.9.2.2 %RegExpStringIteratorPrototype% [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
22.2.9.3 Properties of RegExp String Iterator Instances
| Internal Slot | Type | Description |
|---|---|---|
| [[IteratingRegExp]] | an Object | iterationに使用されるregular expression。 |
| [[IteratedString]] | a String | iterateされているString value。 |
| [[Global]] | a Boolean | [[IteratingRegExp]]がglobalであるかどうかを示します。 |
| [[Unicode]] | a Boolean | [[IteratingRegExp]]がUnicode modeであるかどうかを示します。 |
| [[Done]] | a Boolean | iterationがcompleteしているかどうかを示します。 |
23 Indexed Collections
23.1 Array Objects
Arraysは、あるclassの
23.1.1 The Array Constructor
Array
- %Array%です。
global object の"Array" propertyのinitial valueです。constructor として呼び出されたとき、新しいArrayを作成およびinitializeします。constructor としてではなくfunctionとして呼び出されたときも、新しいArrayを作成およびinitializeします。したがって、function callArray(…)は、same argumentsを伴うobject creation expressionnew Array(…)とequivalentです。- argumentsの数およびtypesに基づいてbehaviourが異なるfunctionです。
- class definitionの
extendsclauseのvalueとして使用できます。exotic Array behaviourをinheritしようとするsubclassconstructors は、Array exotic objects であるsubclass instancesをinitializeするために、Arrayconstructor へのsupercallを含まなければなりません。しかし、Array.prototypemethodsのほとんどは、そのthis valueがArray exotic object であることに依存しないgeneric methodsです。
23.1.1.1 Array ( ...values )
このfunctionは呼び出されたとき、次のstepsを実行します：
- NewTargetが
undefined なら、newTargetをactive function object とする；そうでなければ、newTargetをNewTargetとする。 - protoを ?
GetPrototypeFromConstructor (newTarget,"%Array.prototype%" ) とする。 - numberOfArgsをvalues内のelementsの数とする。
- numberOfArgs = 0なら、!
ArrayCreate (0, proto)を返す。 - numberOfArgs = 1なら、
- lengthをvalues[0]とする。
- arrayを !
ArrayCreate (0, proto) とする。 - lengthがNumberでないなら、
- !
CreateDataPropertyOrThrow (array,"0" , length)を実行する。 - intLengthを
1 𝔽とする。
- !
- そうでなければ、
- intLengthを !
ToUint32 (length) とする。 SameValueZero (intLength, length)がfalse なら、RangeError 例外をthrowする。
- intLengthを !
- !
Set (array,"length" , intLength,true )を実行する。 - arrayを返す。
Assert : numberOfArgs ≥ 2である。- arrayを ?
ArrayCreate (numberOfArgs, proto) とする。 - kを0とする。
- k < numberOfArgsの間、繰り返す
- propertyKeyを !
ToString (𝔽 (k)) とする。 - itemKをvalues[k]とする。
- !
CreateDataPropertyOrThrow (array, propertyKey, itemK)を実行する。 - kをk + 1に設定する。
- propertyKeyを !
Assert : arrayの"length" propertyのmathematical value はnumberOfArgsである。- arrayを返す。
23.1.2 Properties of the Array Constructor
Array
- valueが
%Function.prototype% である[[Prototype]] internal slotを持ちます。 - valueが
1 𝔽である"length" propertyを持ちます。 - 次のpropertiesを持ちます：
23.1.2.1 Array.from ( items [ , mapper [ , thisArg ] ] )
このfunctionは呼び出されたとき、次のstepsを実行します：
- ctorを
this valueとする。 - mapperが
undefined なら、- mappingを
false とする。
- mappingを
- そうでなければ、
IsCallable (mapper)がfalse なら、TypeError 例外をthrowする。- mappingを
true とする。
- usingIteratorを ?
GetMethod (items,%Symbol.iterator% ) とする。 - usingIteratorが
undefined でないなら、IsConstructor (ctor)がtrue なら、- arrayを ?
Construct (ctor) とする。
- arrayを ?
- そうでなければ、
- arrayを !
ArrayCreate (0) とする。
- arrayを !
- iteratorRecordを ?
GetIteratorFromMethod (items, usingIterator) とする。 - kを0とする。
- 繰り返す：
- k ≥ 253 - 1なら、
- errorを
ThrowCompletion (a newly createdTypeError object)とする。 - ?
IteratorClose (iteratorRecord, error)を返す。
- errorを
- propertyKeyを !
ToString (𝔽 (k)) とする。 - nextを ?
IteratorStepValue (iteratorRecord) とする。 - nextが
done なら、 - mappingが
true なら、- mappedValueを
Completion (Call (mapper, thisArg, « next,𝔽 (k) »))とする。 IfAbruptCloseIterator (mappedValue, iteratorRecord).
- mappedValueを
- そうでなければ、
- mappedValueをnextとする。
- defineStatusを
Completion (CreateDataPropertyOrThrow (array, propertyKey, mappedValue))とする。 IfAbruptCloseIterator (defineStatus, iteratorRecord).- kをk + 1に設定する。
- k ≥ 253 - 1なら、
NOTE : itemsはiterable でないため、array-like object であるとassumeする。- arrayLikeを !
ToObject (items) とする。 - lengthを ?
LengthOfArrayLike (arrayLike) とする。 IsConstructor (ctor)がtrue なら、- そうでなければ、
- arrayを ?
ArrayCreate (length) とする。
- arrayを ?
- kを0とする。
- k < lengthの間、繰り返す
- ?
Set (array,"length" ,𝔽 (length),true )を実行する。 - arrayを返す。
このmethodは意図的にgenericなfactory methodです；その
23.1.2.2 Array.fromAsync ( items [ , mapper [ , thisArg ] ] )
このasync functionは呼び出されたとき、次のstepsを実行します：
- ctorを
this valueとする。 - mappingを
false とする。 - mapperが
undefined でないなら、IsCallable (mapper)がfalse なら、TypeError 例外をthrowする。- mappingを
true に設定する。
- iteratorRecordを
undefined とする。 - usingAsyncIteratorを ?
GetMethod (items,%Symbol.asyncIterator% ) とする。 - usingAsyncIteratorが
undefined なら、- usingSyncIteratorを ?
GetMethod (items,%Symbol.iterator% ) とする。 - usingSyncIteratorが
undefined でないなら、- iteratorRecordを
CreateAsyncFromSyncIterator (?GetIteratorFromMethod (items, usingSyncIterator))に設定する。
- iteratorRecordを
- usingSyncIteratorを ?
- そうでなければ、
- iteratorRecordを ?
GetIteratorFromMethod (items, usingAsyncIterator) に設定する。
- iteratorRecordを ?
- iteratorRecordが
undefined でないなら、IsConstructor (ctor)がtrue なら、- arrayを ?
Construct (ctor) とする。
- arrayを ?
- そうでなければ、
- arrayを !
ArrayCreate (0) とする。
- arrayを !
- kを0とする。
- 繰り返す：
- k ≥ 253 - 1なら、
- errorを
ThrowCompletion (a newly createdTypeError object)とする。 - ?
AsyncIteratorClose (iteratorRecord, error)を返す。
- errorを
- propertyKeyを !
ToString (𝔽 (k)) とする。 - nextResultを ?
Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]]) とする。 - nextResultを ?
Await (nextResult) に設定する。 - nextResultがObjectでないなら、
TypeError 例外をthrowする。 - doneを ?
IteratorComplete (nextResult) とする。 - doneが
true なら、 - nextValueを ?
IteratorValue (nextResult) とする。 - mappingが
true なら、- mappedValueを
Completion (Call (mapper, thisArg, « nextValue,𝔽 (k) »))とする。 IfAbruptCloseAsyncIterator (mappedValue, iteratorRecord).- mappedValueを
Completion (Await (mappedValue))に設定する。 IfAbruptCloseAsyncIterator (mappedValue, iteratorRecord).
- mappedValueを
- そうでなければ、
- mappedValueをnextValueとする。
- defineStatusを
Completion (CreateDataPropertyOrThrow (array, propertyKey, mappedValue))とする。 IfAbruptCloseAsyncIterator (defineStatus, iteratorRecord).- kをk + 1に設定する。
- k ≥ 253 - 1なら、
- そうでなければ、
NOTE : itemsはasync iterable でもiterable でもないため、array-like object であるとassumeする。- arrayLikeを !
ToObject (items) とする。 - lengthを ?
LengthOfArrayLike (arrayLike) とする。 IsConstructor (ctor)がtrue なら、- そうでなければ、
- arrayを ?
ArrayCreate (length) とする。
- arrayを ?
- kを0とする。
- k < lengthの間、繰り返す
- propertyKeyを !
ToString (𝔽 (k)) とする。 - kValueを ?
Get (arrayLike, propertyKey) とする。 - kValueを ?
Await (kValue) に設定する。 - mappingが
true なら、 - そうでなければ、
- mappedValueをkValueとする。
- ?
CreateDataPropertyOrThrow (array, propertyKey, mappedValue)を実行する。 - kをk + 1に設定する。
- propertyKeyを !
- ?
Set (array,"length" ,𝔽 (length),true )を実行する。 - arrayを返す。
このmethodは意図的にgenericなfactory methodです；その
23.1.2.3 Array.isArray ( arg )
このfunctionは呼び出されたとき、次のstepsを実行します：
- ?
IsArray (arg)を返す。
23.1.2.4 Array.of ( ...items )
このmethodは呼び出されたとき、次のstepsを実行します：
- lengthをitems内のelementsの数とする。
- lengthNumberを
𝔽 (length)とする。 - ctorを
this valueとする。 IsConstructor (ctor)がtrue なら、- arrayを ?
Construct (ctor, « lengthNumber ») とする。
- arrayを ?
- そうでなければ、
- arrayを ?
ArrayCreate (length) とする。
- arrayを ?
- kを0とする。
- k < lengthの間、繰り返す
- kValueをitems[k]とする。
- propertyKeyを !
ToString (𝔽 (k)) とする。 - ?
CreateDataPropertyOrThrow (array, propertyKey, kValue)を実行する。 - kをk + 1に設定する。
- ?
Set (array,"length" , lengthNumber,true )を実行する。 - arrayを返す。
このmethodは意図的にgenericなfactory methodです；その
23.1.2.5 Array.prototype
Array.prototypeのvalueは
このpropertyはattributes { [[Writable]]:
23.1.2.6 get Array [ %Symbol.species% ]
Array[%Symbol.species%]は、set accessor functionが
this valueを返す。
このfunctionの
Array prototype methodsは通常、その
23.1.3 Properties of the Array Prototype Object
Array prototype objectは：
- %Array.prototype%です。
Array exotic object であり、そのようなobjectsに対して指定されたinternal methodsを持ちます。- initial valueが
+0 𝔽であり、attributesが { [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false } である"length" propertyを持ちます。 - valueが
%Object.prototype% である[[Prototype]] internal slotを持ちます。
Array prototype objectは、ECMAScript 2015 specificationより前に作成されたECMAScript codeとのcompatibilityをensureするために、
23.1.3.1 Array.prototype.at ( index )
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - relativeIndexを ?
ToIntegerOrInfinity (index) とする。 - relativeIndex ≥ 0なら、
- kをrelativeIndexとする。
- そうでなければ、
- kをlength + relativeIndexとする。
- k < 0またはk ≥ lengthなら、
undefined を返す。 - ?
Get (obj, !ToString (𝔽 (k)))を返す。
23.1.3.2 Array.prototype.concat ( ...items )
このmethodは、objectのarray elementsに各argumentのarray elementsがfollowしたものを含むarrayを返します。
これは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - arrayを ?
ArraySpeciesCreate (obj, 0) とする。 - nextIndexを0とする。
- objをitemsの先頭にprependする。
- itemsの各要素itemについて、以下を行う
- spreadableを ?
IsConcatSpreadable (item) とする。 - spreadableが
true なら、- lengthを ?
LengthOfArrayLike (item) とする。 - nextIndex + length > 253 - 1なら、
TypeError 例外をthrowする。 - sourceIndexを0とする。
- sourceIndex < lengthの間、繰り返す
- propertyKeyを !
ToString (𝔽 (sourceIndex)) とする。 - existsを ?
HasProperty (item, propertyKey) とする。 - existsが
true なら、- subElementを ?
Get (item, propertyKey) とする。 - ?
CreateDataPropertyOrThrow (array, !ToString (𝔽 (nextIndex)), subElement)を実行する。
- subElementを ?
- nextIndexをnextIndex + 1に設定する。
- sourceIndexをsourceIndex + 1に設定する。
- propertyKeyを !
- lengthを ?
- そうでなければ、
NOTE : itemはspreadされるのではなくsingle itemとしてaddedされる。- nextIndex ≥ 253 - 1なら、
TypeError 例外をthrowする。 - ?
CreateDataPropertyOrThrow (array, !ToString (𝔽 (nextIndex)), item)を実行する。 - nextIndexをnextIndex + 1に設定する。
- spreadableを ?
- ?
Set (array,"length" ,𝔽 (nextIndex),true )を実行する。 - arrayを返す。
このmethodの
step
このmethodは意図的にgenericです；その
23.1.3.2.1 IsConcatSpreadable ( obj )
The abstract operation IsConcatSpreadable takes argument obj (an ECMAScript language value) and returns either a
- objがObjectでないなら、
false を返す。 - spreadableを ?
Get (obj,%Symbol.isConcatSpreadable% ) とする。 - spreadableが
undefined でないなら、ToBoolean (spreadable)を返す。 - ?
IsArray (obj)を返す。
23.1.3.3 Array.prototype.constructor
Array.prototype.constructorのinitial valueは
23.1.3.4 Array.prototype.copyWithin ( target, start [ , end ] )
end argumentはoptionalです。providedされない場合、
targetがnegativeなら、lengthをarrayのlengthとして、
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - relativeTargetを ?
ToIntegerOrInfinity (target) とする。 - relativeTarget = -∞なら、toを0とする。
- そうでなく、relativeTarget < 0なら、toを
max (length + relativeTarget, 0)とする。 - そうでなければ、toを
min (relativeTarget, length)とする。 - relativeStartを ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞なら、fromを0とする。
- そうでなく、relativeStart < 0なら、fromを
max (length + relativeStart, 0)とする。 - そうでなければ、fromを
min (relativeStart, length)とする。 - endが
undefined なら、relativeEndをlengthとする；そうでなければ、relativeEndを ?ToIntegerOrInfinity (end) とする。 - relativeEnd = -∞なら、finalを0とする。
- そうでなく、relativeEnd < 0なら、finalを
max (length + relativeEnd, 0)とする。 - そうでなければ、finalを
min (relativeEnd, length)とする。 - countを
min (final - from, length - to)とする。 - from < toかつto < from + countなら、
- directionを-1とする。
- fromをfrom + count - 1に設定する。
- toをto + count - 1に設定する。
- そうでなければ、
- directionを1とする。
- count > 0の間、繰り返す
- fromKeyを !
ToString (𝔽 (from)) とする。 - toKeyを !
ToString (𝔽 (to)) とする。 - fromPresentを ?
HasProperty (obj, fromKey) とする。 - fromPresentが
true なら、 - そうでなければ、
Assert : fromPresentはfalse である。- ?
DeletePropertyOrThrow (obj, toKey)を実行する。
- fromをfrom + directionに設定する。
- toをto + directionに設定する。
- countをcount - 1に設定する。
- fromKeyを !
- objを返す。
このmethodは意図的にgenericです；その
23.1.3.5 Array.prototype.entries ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 CreateArrayIterator (obj,key+value )を返す。
23.1.3.6 Array.prototype.every ( callback [ , thisArg ] )
callbackはthree argumentsをacceptし、Boolean valueへcoercibleなvalueを返すfunctionであるべきです。everyは、callbackがeveryはimmediately everyは
thisArg parameterがprovidedされる場合、callbackの各invocationに対する
callbackはthree argumentsで呼び出されます：elementのvalue、elementのindex、およびtraversedされているobjectです。
everyは、それが呼び出されたobjectをdirectlyにはmutateしませんが、objectはcallbackへのcallsによってmutateされる可能性があります。
everyによってprocessedされるelementsのrangeは、callbackへのfirst callの前にsetされます。everyへのcallがbeginした後にarrayへappendedされたelementsは、callbackによってvisitedされません。arrayのexisting elementsがchangedされた場合、callbackへpassedされるそのvalueは、everyがそれらをvisitする時点のvalueになります；everyへのcallがbeginした後、visitedされる前にdeletedされたelementsはvisitedされません。everyは数学における“for all” quantifierのようにactします。特に、empty arrayについては
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 IsCallable (callback)がfalse なら、TypeError 例外をthrowする。- kを0とする。
- k < lengthの間、繰り返す
true を返す。
このmethodは意図的にgenericです；その
23.1.3.7 Array.prototype.fill ( value [ , start [ , end ] ] )
start argumentはoptionalです。providedされない場合、
end argumentはoptionalです。providedされない場合、
startがnegativeなら、lengthをarrayのlengthとして、
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - relativeStartを ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞なら、kを0とする。
- そうでなく、relativeStart < 0なら、kを
max (length + relativeStart, 0)とする。 - そうでなければ、kを
min (relativeStart, length)とする。 - endが
undefined なら、relativeEndをlengthとする；そうでなければ、relativeEndを ?ToIntegerOrInfinity (end) とする。 - relativeEnd = -∞なら、finalを0とする。
- そうでなく、relativeEnd < 0なら、finalを
max (length + relativeEnd, 0)とする。 - そうでなければ、finalを
min (relativeEnd, length)とする。 - k < finalの間、繰り返す
- objを返す。
このmethodは意図的にgenericです；その
23.1.3.8 Array.prototype.filter ( callback [ , thisArg ] )
callbackはthree argumentsをacceptし、Boolean valueへcoercibleなvalueを返すfunctionであるべきです。filterは、array内の各elementについてascending orderでcallbackをonce呼び出し、callbackが
thisArg parameterがprovidedされる場合、callbackの各invocationに対する
callbackはthree argumentsで呼び出されます：elementのvalue、elementのindex、およびtraversedされているobjectです。
filterは、それが呼び出されたobjectをdirectlyにはmutateしませんが、objectはcallbackへのcallsによってmutateされる可能性があります。
filterによってprocessedされるelementsのrangeは、callbackへのfirst callの前にsetされます。filterへのcallがbeginした後にarrayへappendedされたelementsは、callbackによってvisitedされません。arrayのexisting elementsがchangedされた場合、callbackへpassedされるそのvalueは、filterがそれらをvisitする時点のvalueになります；filterへのcallがbeginした後、visitedされる前にdeletedされたelementsはvisitedされません。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 IsCallable (callback)がfalse なら、TypeError 例外をthrowする。- arrayを ?
ArraySpeciesCreate (obj, 0) とする。 - kを0とする。
- toを0とする。
- k < lengthの間、繰り返す
- propertyKeyを !
ToString (𝔽 (k)) とする。 - kPresentを ?
HasProperty (obj, propertyKey) とする。 - kPresentが
true なら、 - kをk + 1に設定する。
- propertyKeyを !
- arrayを返す。
このmethodは意図的にgenericです；その
23.1.3.9 Array.prototype.find ( predicate [ , thisArg ] )
このmethodは、predicateがfindはimmediatelyそのelement valueを返します。そうでなければ、findは
additional informationについては
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - findRecordを ?
FindViaPredicate (obj, length,ascending , predicate, thisArg) とする。 - findRecord.[[Value]]を返す。
このmethodは意図的にgenericです；その
23.1.3.10 Array.prototype.findIndex ( predicate [ , thisArg ] )
このmethodは、predicateがfindIndexはimmediatelyそのelement valueのindexを返します。そうでなければ、findIndexは-1を返します。
additional informationについては
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - findRecordを ?
FindViaPredicate (obj, length,ascending , predicate, thisArg) とする。 - findRecord.[[Index]]を返す。
このmethodは意図的にgenericです；その
23.1.3.11 Array.prototype.findLast ( predicate [ , thisArg ] )
このmethodは、predicateがfindLastはimmediatelyそのelement valueを返します。そうでなければ、findLastは
additional informationについては
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - findRecordを ?
FindViaPredicate (obj, length,descending , predicate, thisArg) とする。 - findRecord.[[Value]]を返す。
このmethodは意図的にgenericです；その
23.1.3.12 Array.prototype.findLastIndex ( predicate [ , thisArg ] )
このmethodは、predicateがfindLastIndexはimmediatelyそのelement valueのindexを返します。そうでなければ、findLastIndexは-1を返します。
additional informationについては
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - findRecordを ?
FindViaPredicate (obj, length,descending , predicate, thisArg) とする。 - findRecord.[[Index]]を返す。
このmethodは意図的にgenericです；その
23.1.3.12.1 FindViaPredicate ( obj, length, direction, predicate, thisArg )
The abstract operation FindViaPredicate takes arguments obj (an Object), length (a non-negative
objは
predicateはfunctionであるべきです。arrayのelementについて呼び出されるとき、three argumentsが渡されます：elementのvalue、elementのindex、およびtraversedされているobjectです。そのreturn valueはBoolean valueへcoercedされます。
thisArgは、predicateの各invocationに対する
このoperationは、それが呼び出されたobjectをdirectlyにはmutateしませんが、objectはpredicateへのcallsによってmutateされる可能性があります。
processedされるelementsのrangeは、predicateへのfirst callの前、traversalがbeginする直前にsetされます。この後にarrayへappendedされたelementsは、predicateによってvisitedされません。arrayのexisting elementsがchangedされた場合、predicateへpassedされるそのvalueは、このoperationがそれらをvisitする時点のvalueになります。traversalがbeginした後、visitedされる前にdeletedされたelementsはstill visitedされ、prototypeからlooked upされるか、
It performs the following steps when called:
IsCallable (predicate)がfalse なら、TypeError 例外をthrowする。- directionが
ascending なら、 - そうでなければ、
- indicesの各
integer kについて、以下を行う Record { [[Index]]:-1 𝔽, [[Value]]:undefined }を返す。
23.1.3.13 Array.prototype.flat ( [ depth ] )
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - sourceLengthを ?
LengthOfArrayLike (obj) とする。 - depthNumberを1とする。
- depthが
undefined でないなら、- depthNumberを ?
ToIntegerOrInfinity (depth) に設定する。 - depthNumber < 0なら、depthNumberを0に設定する。
- depthNumberを ?
- arrayを ?
ArraySpeciesCreate (obj, 0) とする。 - ?
FlattenIntoArray (array, obj, sourceLength, 0, depthNumber)を実行する。 - arrayを返す。
23.1.3.13.1 FlattenIntoArray ( target, source, sourceLength, start, depth [ , mapperFunc [ , thisArg ] ] )
The abstract operation FlattenIntoArray takes arguments target (an Object), source (an Object), sourceLength (a non-negative
Assert : mapperFuncがpresentなら、IsCallable (mapperFunc)はtrue であり、thisArgはpresentであり、depthは1である。- targetIndexをstartとする。
- sourceIndexを
+0 𝔽とする。 ℝ (sourceIndex) < sourceLengthの間、繰り返す- propertyKeyを !
ToString (sourceIndex) とする。 - existsを ?
HasProperty (source, propertyKey) とする。 - existsが
true なら、- elementを ?
Get (source, propertyKey) とする。 - mapperFuncがpresentなら、
- elementを ?
Call (mapperFunc, thisArg, « element, sourceIndex, source ») に設定する。
- elementを ?
- shouldFlattenを
false とする。 - depth > 0なら、
- shouldFlattenを ?
IsArray (element) に設定する。
- shouldFlattenを ?
- shouldFlattenが
true なら、- depth = +∞なら、newDepthを+∞とする。
- そうでなければ、newDepthをdepth - 1とする。
- elementLengthを ?
LengthOfArrayLike (element) とする。 - targetIndexを ?
FlattenIntoArray (target, element, elementLength, targetIndex, newDepth) に設定する。
- そうでなければ、
- targetIndex ≥ 253 - 1なら、
TypeError 例外をthrowする。 - ?
CreateDataPropertyOrThrow (target, !ToString (𝔽 (targetIndex)), element)を実行する。 - targetIndexをtargetIndex + 1に設定する。
- targetIndex ≥ 253 - 1なら、
- elementを ?
- sourceIndexをsourceIndex +
1 𝔽に設定する。
- propertyKeyを !
- targetIndexを返す。
23.1.3.14 Array.prototype.flatMap ( mapperFunc [ , thisArg ] )
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - sourceLengthを ?
LengthOfArrayLike (obj) とする。 IsCallable (mapperFunc)がfalse なら、TypeError 例外をthrowする。- arrayを ?
ArraySpeciesCreate (obj, 0) とする。 - ?
FlattenIntoArray (array, obj, sourceLength, 0, 1, mapperFunc, thisArg)を実行する。 - arrayを返す。
23.1.3.15 Array.prototype.forEach ( callback [ , thisArg ] )
callbackはthree argumentsをacceptするfunctionであるべきです。forEachは、array内にpresentな各elementについてascending orderでcallbackをonce呼び出します。callbackは、arrayの実際にexistするelementsに対してのみ呼び出されます；arrayのmissing elementsに対しては呼び出されません。
thisArg parameterがprovidedされる場合、callbackの各invocationに対する
callbackはthree argumentsで呼び出されます：elementのvalue、elementのindex、およびtraversedされているobjectです。
forEachは、それが呼び出されたobjectをdirectlyにはmutateしませんが、objectはcallbackへのcallsによってmutateされる可能性があります。
forEachによってprocessedされるelementsのrangeは、callbackへのfirst callの前にsetされます。forEachへのcallがbeginした後にarrayへappendedされたelementsは、callbackによってvisitedされません。arrayのexisting elementsがchangedされた場合、callbackへpassedされるそのvalueは、forEachがそれらをvisitする時点のvalueになります；forEachへのcallがbeginした後、visitedされる前にdeletedされたelementsはvisitedされません。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 IsCallable (callback)がfalse なら、TypeError 例外をthrowする。- kを0とする。
- k < lengthの間、繰り返す
undefined を返す。
このmethodは意図的にgenericです；その
23.1.3.16 Array.prototype.includes ( searchElement [ , fromIndex ] )
このmethodは、
optional second argument fromIndexは
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - length = 0なら、
false を返す。 - startIndexを ?
ToIntegerOrInfinity (fromIndex) とする。 Assert : fromIndexがundefined なら、startIndexは0である。- startIndex = +∞なら、
false を返す。 - startIndex = -∞なら、startIndexを0に設定する。
- startIndex ≥ 0なら、
- kをstartIndexとする。
- そうでなければ、
- kをlength + startIndexとする。
- k < 0なら、kを0に設定する。
- k < lengthの間、繰り返す
- elementKを ?
Get (obj, !ToString (𝔽 (k))) とする。 SameValueZero (searchElement, elementK)がtrue なら、true を返す。- kをk + 1に設定する。
- elementKを ?
false を返す。
このmethodは意図的にgenericです；その
このmethodは、similarなindexOf methodと意図的にtwo waysで異なります。First、それは
23.1.3.17 Array.prototype.indexOf ( searchElement [ , fromIndex ] )
このmethodは、
optional second argument fromIndexは
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - length = 0なら、
-1 𝔽を返す。 - startIndexを ?
ToIntegerOrInfinity (fromIndex) とする。 Assert : fromIndexがundefined なら、startIndexは0である。- startIndex = +∞なら、
-1 𝔽を返す。 - startIndex = -∞なら、startIndexを0に設定する。
- startIndex ≥ 0なら、
- kをstartIndexとする。
- そうでなければ、
- kをlength + startIndexとする。
- k < 0なら、kを0に設定する。
- k < lengthの間、繰り返す
- propertyKeyを !
ToString (𝔽 (k)) とする。 - kPresentを ?
HasProperty (obj, propertyKey) とする。 - kPresentが
true なら、- elementKを ?
Get (obj, propertyKey) とする。 IsStrictlyEqual (searchElement, elementK)がtrue なら、𝔽 (k)を返す。
- elementKを ?
- kをk + 1に設定する。
- propertyKeyを !
-1 𝔽を返す。
このmethodは意図的にgenericです；その
23.1.3.18 Array.prototype.join ( separator )
このmethodはarrayのelementsをStringsへconvertし、その後、separatorのoccurrencesでseparatedしてそれらのStringsをconcatenateします。separatorがprovidedされない場合、single commaがseparatorとして使用されます。
これは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - separatorが
undefined なら、sepを"," とする。 - そうでなければ、sepを ?
ToString (separator) とする。 - resultをempty Stringとする。
- kを0とする。
- k < lengthの間、繰り返す
- k > 0なら、resultをresultとsepの
string-concatenation に設定する。 - elementを ?
Get (obj, !ToString (𝔽 (k))) とする。 - elementが
undefined でもnull でもないなら、- elementStringを ?
ToString (element) とする。 - resultをresultとelementStringの
string-concatenation に設定する。
- elementStringを ?
- kをk + 1に設定する。
- k > 0なら、resultをresultとsepの
- resultを返す。
このmethodは意図的にgenericです；その
23.1.3.19 Array.prototype.keys ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 CreateArrayIterator (obj,key )を返す。
23.1.3.20 Array.prototype.lastIndexOf ( searchElement [ , fromIndex ] )
このmethodは、
optional second argument fromIndexはarrayのlength minus oneをdefaultとします（つまり、whole arrayがsearchedされます）。それがarrayのlength以上である場合、whole arrayがsearchedされます。それが
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - length = 0なら、
-1 𝔽を返す。 - fromIndexがpresentなら、startIndexを ?
ToIntegerOrInfinity (fromIndex) とする；そうでなければ、startIndexをlength - 1とする。 - startIndex = -∞なら、
-1 𝔽を返す。 - startIndex ≥ 0なら、
- kを
min (startIndex, length - 1)とする。
- kを
- そうでなければ、
- kをlength + startIndexとする。
- k ≥ 0の間、繰り返す
- propertyKeyを !
ToString (𝔽 (k)) とする。 - kPresentを ?
HasProperty (obj, propertyKey) とする。 - kPresentが
true なら、- elementKを ?
Get (obj, propertyKey) とする。 IsStrictlyEqual (searchElement, elementK)がtrue なら、𝔽 (k)を返す。
- elementKを ?
- kをk - 1に設定する。
- propertyKeyを !
-1 𝔽を返す。
このmethodは意図的にgenericです；その
23.1.3.21 Array.prototype.map ( callback [ , thisArg ] )
callbackはthree argumentsをacceptするfunctionであるべきです。mapは、array内の各elementについてascending orderでcallbackをonce呼び出し、そのresultsからnew Arrayをconstructします。callbackは、arrayの実際にexistするelementsに対してのみ呼び出されます；arrayのmissing elementsに対しては呼び出されません。
thisArg parameterがprovidedされる場合、callbackの各invocationに対する
callbackはthree argumentsで呼び出されます：elementのvalue、elementのindex、およびtraversedされているobjectです。
mapは、それが呼び出されたobjectをdirectlyにはmutateしませんが、objectはcallbackへのcallsによってmutateされる可能性があります。
mapによってprocessedされるelementsのrangeは、callbackへのfirst callの前にsetされます。mapへのcallがbeginした後にarrayへappendedされたelementsは、callbackによってvisitedされません。arrayのexisting elementsがchangedされた場合、callbackへpassedされるそのvalueは、mapがそれらをvisitする時点のvalueになります；mapへのcallがbeginした後、visitedされる前にdeletedされたelementsはvisitedされません。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 IsCallable (callback)がfalse なら、TypeError 例外をthrowする。- arrayを ?
ArraySpeciesCreate (obj, length) とする。 - kを0とする。
- k < lengthの間、繰り返す
- propertyKeyを !
ToString (𝔽 (k)) とする。 - kPresentを ?
HasProperty (obj, propertyKey) とする。 - kPresentが
true なら、- kValueを ?
Get (obj, propertyKey) とする。 - mappedValueを ?
Call (callback, thisArg, « kValue,𝔽 (k), obj ») とする。 - ?
CreateDataPropertyOrThrow (array, propertyKey, mappedValue)を実行する。
- kValueを ?
- kをk + 1に設定する。
- propertyKeyを !
- arrayを返す。
このmethodは意図的にgenericです；その
23.1.3.22 Array.prototype.pop ( )
このmethodはarrayのlast elementをremoveし、それを返します。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - length = 0なら、
- ?
Set (obj,"length" ,+0 𝔽,true )を実行する。 undefined を返す。
- ?
Assert : length > 0である。- newLengthを
𝔽 (length - 1)とする。 - indexを !
ToString (newLength) とする。 - elementを ?
Get (obj, index) とする。 - ?
DeletePropertyOrThrow (obj, index)を実行する。 - ?
Set (obj,"length" , newLength,true )を実行する。 - elementを返す。
このmethodは意図的にgenericです；その
23.1.3.23 Array.prototype.push ( ...items )
このmethodは、argumentsを、それらがappearするorderでarrayのendへappendします。これはarrayのnew lengthを返します。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - argCountをitems内のelementsの数とする。
- length + argCount > 253 - 1なら、
TypeError 例外をthrowする。 - itemsの各要素itemについて、以下を行う
- ?
Set (obj,"length" ,𝔽 (length),true )を実行する。 𝔽 (length)を返す。
このmethodの
このmethodは意図的にgenericです；その
23.1.3.24 Array.prototype.reduce ( callback [ , initialValue ] )
callbackはfour argumentsを取るfunctionであるべきです。reduceは、initialValueがprovidedされない限りfirst elementをskippingしながら、array内にpresentな各elementについてascending orderでcallbackをonce呼び出します。
callbackはfour argumentsで呼び出されます：previousValue（callbackへのprevious callからのvalue）、currentValue（current elementのvalue）、currentIndex、およびtraversedされているobjectです。callbackがfirst time呼び出されるとき、previousValueとcurrentValueはtwo valuesのいずれかになり得ます。reduceへのcallでinitialValueがsuppliedされた場合、previousValueはinitialValueになり、currentValueはarray内のfirst valueになります。initialValueがsuppliedされなかった場合、previousValueはarray内のfirst valueになり、currentValueはsecondになります。arrayがelementsを含まず、かつinitialValueがprovidedされない場合、
reduceは、それが呼び出されたobjectをdirectlyにはmutateしませんが、objectはcallbackへのcallsによってmutateされる可能性があります。
reduceによってprocessedされるelementsのrangeは、callbackへのfirst callの前にsetされます。reduceへのcallがbeginした後にarrayへappendedされたelementsは、callbackによってvisitedされません。arrayのexisting elementsがchangedされた場合、callbackへpassedされるそのvalueは、reduceがそれらをvisitする時点のvalueになります；reduceへのcallがbeginした後、visitedされる前にdeletedされたelementsはvisitedされません。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 IsCallable (callback)がfalse なら、TypeError 例外をthrowする。- length = 0であり、かつinitialValueがpresentでないなら、
TypeError 例外をthrowする。 - kを0とする。
- accumulatorを
undefined とする。 - initialValueがpresentなら、
- accumulatorをinitialValueに設定する。
- そうでなければ、
- kPresentを
false とする。 - kPresentが
false であり、かつk < lengthである間、繰り返す- propertyKeyを !
ToString (𝔽 (k)) とする。 - kPresentを ?
HasProperty (obj, propertyKey) に設定する。 - kPresentが
true なら、- accumulatorを ?
Get (obj, propertyKey) に設定する。
- accumulatorを ?
- kをk + 1に設定する。
- propertyKeyを !
- kPresentが
false なら、TypeError 例外をthrowする。
- kPresentを
- k < lengthの間、繰り返す
- accumulatorを返す。
このmethodは意図的にgenericです；その
23.1.3.25 Array.prototype.reduceRight ( callback [ , initialValue ] )
callbackはfour argumentsを取るfunctionであるべきです。reduceRightは、initialValueがprovidedされない限りfirst callをskippingしながら、array内にpresentな各elementについてdescending orderでcallbackをonce呼び出します。
callbackはfour argumentsで呼び出されます：previousValue（callbackへのprevious callからのvalue）、currentValue（current elementのvalue）、currentIndex、およびtraversedされているobjectです。functionがfirst time呼び出されるとき、previousValueとcurrentValueはtwo valuesのいずれかになり得ます。reduceRightへのcallでinitialValueがsuppliedされた場合、previousValueはinitialValueになり、currentValueはarray内のlast valueになります。initialValueがsuppliedされなかった場合、previousValueはarray内のlast valueになり、currentValueはsecond-to-last valueになります。arrayがelementsを含まず、かつinitialValueがprovidedされない場合、
reduceRightは、それが呼び出されたobjectをdirectlyにはmutateしませんが、objectはcallbackへのcallsによってmutateされる可能性があります。
reduceRightによってprocessedされるelementsのrangeは、callbackへのfirst callの前にsetされます。reduceRightへのcallがbeginした後にarrayへappendedされたelementsは、callbackによってvisitedされません。arrayのexisting elementsがcallbackによってchangedされた場合、callbackへpassedされるそのvalueは、reduceRightがそれらをvisitする時点のvalueになります；reduceRightへのcallがbeginした後、visitedされる前にdeletedされたelementsはvisitedされません。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 IsCallable (callback)がfalse なら、TypeError 例外をthrowする。- length = 0であり、かつinitialValueがpresentでないなら、
TypeError 例外をthrowする。 - kをlength - 1とする。
- accumulatorを
undefined とする。 - initialValueがpresentなら、
- accumulatorをinitialValueに設定する。
- そうでなければ、
- kPresentを
false とする。 - kPresentが
false であり、かつk ≥ 0である間、繰り返す- propertyKeyを !
ToString (𝔽 (k)) とする。 - kPresentを ?
HasProperty (obj, propertyKey) に設定する。 - kPresentが
true なら、- accumulatorを ?
Get (obj, propertyKey) に設定する。
- accumulatorを ?
- kをk - 1に設定する。
- propertyKeyを !
- kPresentが
false なら、TypeError 例外をthrowする。
- kPresentを
- k ≥ 0の間、繰り返す
- accumulatorを返す。
このmethodは意図的にgenericです；その
23.1.3.26 Array.prototype.reverse ( )
このmethodはarrayのelementsをrearrangeし、そのorderをreverseします。これはreversed arrayを返します。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - middleを
floor (length / 2)とする。 - lowerを0とする。
- lower ≠ middleの間、繰り返す
- upperをlength - lower - 1とする。
- upperPを !
ToString (𝔽 (upper)) とする。 - lowerPを !
ToString (𝔽 (lower)) とする。 - lowerExistsを ?
HasProperty (obj, lowerP) とする。 - lowerExistsが
true なら、- lowerValueを ?
Get (obj, lowerP) とする。
- lowerValueを ?
- upperExistsを ?
HasProperty (obj, upperP) とする。 - upperExistsが
true なら、- upperValueを ?
Get (obj, upperP) とする。
- upperValueを ?
- lowerExistsが
true であり、かつupperExistsがtrue なら、 - そうでなく、lowerExistsが
false であり、かつupperExistsがtrue なら、- ?
Set (obj, lowerP, upperValue,true )を実行する。 - ?
DeletePropertyOrThrow (obj, upperP)を実行する。
- ?
- そうでなく、lowerExistsが
true であり、かつupperExistsがfalse なら、- ?
DeletePropertyOrThrow (obj, lowerP)を実行する。 - ?
Set (obj, upperP, lowerValue,true )を実行する。
- ?
- そうでなければ、
- lowerをlower + 1に設定する。
- objを返す。
このmethodは意図的にgenericです；その
23.1.3.27 Array.prototype.shift ( )
このmethodはarrayのfirst elementをremoveし、それを返します。
これは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - length = 0なら、
- ?
Set (obj,"length" ,+0 𝔽,true )を実行する。 undefined を返す。
- ?
- firstを ?
Get (obj,"0" ) とする。 - kを1とする。
- k < lengthの間、繰り返す
- fromを !
ToString (𝔽 (k)) とする。 - toを !
ToString (𝔽 (k - 1)) とする。 - fromPresentを ?
HasProperty (obj, from) とする。 - fromPresentが
true なら、 - そうでなければ、
Assert : fromPresentはfalse である。- ?
DeletePropertyOrThrow (obj, to)を実行する。
- kをk + 1に設定する。
- fromを !
- ?
DeletePropertyOrThrow (obj, !ToString (𝔽 (length - 1)))を実行する。 - ?
Set (obj,"length" ,𝔽 (length - 1),true )を実行する。 - firstを返す。
このmethodは意図的にgenericです；その
23.1.3.28 Array.prototype.slice ( start, end )
このmethodは、element startからelement endまで（ただしendを含まない）のarrayのelementsを含むarrayを返します（またはendが
これは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - relativeStartを ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞なら、kを0とする。
- そうでなく、relativeStart < 0なら、kを
max (length + relativeStart, 0)とする。 - そうでなければ、kを
min (relativeStart, length)とする。 - endが
undefined なら、relativeEndをlengthとする；そうでなければ、relativeEndを ?ToIntegerOrInfinity (end) とする。 - relativeEnd = -∞なら、finalを0とする。
- そうでなく、relativeEnd < 0なら、finalを
max (length + relativeEnd, 0)とする。 - そうでなければ、finalを
min (relativeEnd, length)とする。 - countを
max (final - k, 0)とする。 - arrayを ?
ArraySpeciesCreate (obj, count) とする。 - resultIndexを0とする。
- k < finalの間、繰り返す
- propertyKeyを !
ToString (𝔽 (k)) とする。 - kPresentを ?
HasProperty (obj, propertyKey) とする。 - kPresentが
true なら、- kValueを ?
Get (obj, propertyKey) とする。 - ?
CreateDataPropertyOrThrow (array, !ToString (𝔽 (resultIndex)), kValue)を実行する。
- kValueを ?
- kをk + 1に設定する。
- resultIndexをresultIndex + 1に設定する。
- propertyKeyを !
- ?
Set (array,"length" ,𝔽 (resultIndex),true )を実行する。 - arrayを返す。
step
このmethodは意図的にgenericです；その
23.1.3.29 Array.prototype.some ( callback [ , thisArg ] )
callbackはthree argumentsをacceptし、Boolean valueへcoercibleなvalueを返すfunctionであるべきです。someは、callbackがsomeはimmediately someは
thisArg parameterがprovidedされる場合、callbackの各invocationに対する
callbackはthree argumentsで呼び出されます：elementのvalue、elementのindex、およびtraversedされているobjectです。
someは、それが呼び出されたobjectをdirectlyにはmutateしませんが、objectはcallbackへのcallsによってmutateされる可能性があります。
someによってprocessedされるelementsのrangeは、callbackへのfirst callの前にsetされます。someへのcallがbeginした後にarrayへappendedされたelementsは、callbackによってvisitedされません。arrayのexisting elementsがchangedされた場合、callbackへpassedされるそのvalueは、someがそれらをvisitする時点のvalueになります；someへのcallがbeginした後、visitedされる前にdeletedされたelementsはvisitedされません。someは数学における“exists” quantifierのようにactします。特に、empty arrayについては
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 IsCallable (callback)がfalse なら、TypeError 例外をthrowする。- kを0とする。
- k < lengthの間、繰り返す
false を返す。
このmethodは意図的にgenericです；その
23.1.3.30 Array.prototype.sort ( comparator )
このmethodはthis arrayのelementsをsortします。comparatorが
これは呼び出されたとき、次のstepsを実行します：
- comparatorが
undefined でなく、かつIsCallable (comparator)がfalse なら、TypeError 例外をthrowする。 - objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - sortCompareを、comparatorをcaptureし、calledされたときに次のstepsを実行する、parameters (x, y)を持つnew
Abstract Closure とする：- ?
CompareArrayElements (x, y, comparator)を返す。
- ?
- sortedListを ?
SortIndexedProperties (obj, length, sortCompare,skip-holes ) とする。 - itemCountをsortedList内のelementsの数とする。
- jを0とする。
- j < itemCountの間、繰り返す
NOTE : step5 のSortIndexedProperties へのcallはskip-holes を使用する。remaining indicesは、sortからdetectedおよびexcludedされたholesの数をpreserveするためにdeletedされる。- j < lengthの間、繰り返す
- ?
DeletePropertyOrThrow (obj, !ToString (𝔽 (j)))を実行する。 - jをj + 1に設定する。
- ?
- objを返す。
non-existent property valuesは常に
steps
このmethodは意図的にgenericです；その
23.1.3.30.1 SortIndexedProperties ( obj, length, sortCompare, holes )
The abstract operation SortIndexedProperties takes arguments obj (an Object), length (a non-negative
- itemsを新しい空の
List とする。 - kを0とする。
- k < lengthの間、繰り返す
- propertyKeyを !
ToString (𝔽 (k)) とする。 - holesが
skip-holes なら、- kReadを ?
HasProperty (obj, propertyKey) とする。
- kReadを ?
- そうでなければ、
Assert : holesはread-through-holes である。- kReadを
true とする。
- kReadが
true なら、- kValueを ?
Get (obj, propertyKey) とする。 - kValueをitemsへappendする。
- kValueを ?
- kをk + 1に設定する。
- propertyKeyを !
implementation-defined sequence of calls to sortCompareを使用してitemsをSortする。そのようなcallのいずれかがabrupt completion を返す場合、sortCompareへのそれ以上のcallsをperformする前にstopし、そのCompletion Record を返す。- itemsを返す。
sort orderは、上記algorithmのstep
-
itemCountより小さいnon-negative
integers のmathematical permutation πが存在し、itemCountより小さいevery non-negativeinteger jについて、elementold[j] はnew[π(j)] とexactly the sameでなければなりません。 -
そして、itemCountより小さいすべてのnon-negative
integers jおよびkについて、ℝ (sortCompare(old[j], old[k])) < 0π(j) < π(k) です。 -
さらに、j < k < itemCountであるすべてのnon-negative
integers jおよびkについて、ℝ (sortCompare(old[j], old[k])) = 0π(j) < π(k) です；つまり、sortはstableです。
ここでnotation
-
comparator(a, b)をcallingすると、two argumentsとしてspecific pair of values aおよびbがgivenされたとき、常にsame value vを返します。さらに、vはNumberであり、vは
NaN ではありません。これは、given pair of aおよびbについて、a <C b、a =C b、およびa >C bのexactly oneがtrueになることをimplyすることに注意してください。 - comparator(a, b)をcallingしても、objまたはobjのprototype chain上のany objectをmodifyしません。
- a =C a（reflexivity）
- a =C bなら、b =C a（symmetry）
- a =C bであり、かつb =C cなら、a =C c（transitivity of =C）
- a <C bであり、かつb <C cなら、a <C c（transitivity of <C）
- a >C bであり、かつb >C cなら、a >C c（transitivity of >C）
上記のconditionsは、comparatorがset valuesをequivalence classesへdivideし、これらのequivalence classesがtotally orderedであることをensureするためにnecessary and sufficientです。
23.1.3.30.2 CompareArrayElements ( x, y, comparator )
The abstract operation CompareArrayElements takes arguments x (an ECMAScript language value), y (an ECMAScript language value), and comparator (a
- xが
undefined であり、かつyがundefined なら、+0 𝔽を返す。 - xが
undefined なら、1 𝔽を返す。 - yが
undefined なら、-1 𝔽を返す。 - comparatorが
undefined でないなら、 - xStringを ?
ToString (x) とする。 - yStringを ?
ToString (y) とする。 - xSmallerを !
IsLessThan (xString, yString,true ) とする。 - xSmallerが
true なら、-1 𝔽を返す。 - ySmallerを !
IsLessThan (yString, xString,true ) とする。 - ySmallerが
true なら、1 𝔽を返す。 +0 𝔽を返す。
23.1.3.31 Array.prototype.splice ( start, deleteCount, ...items )
このmethodは
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - relativeStartを ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞なら、actualStartを0とする。
- そうでなく、relativeStart < 0なら、actualStartを
max (length + relativeStart, 0)とする。 - そうでなければ、actualStartを
min (relativeStart, length)とする。 - itemCountをitems内のelementsの数とする。
- startがpresentでないなら、
- actualDeleteCountを0とする。
- そうでなく、deleteCountがpresentでないなら、
- actualDeleteCountをlength - actualStartとする。
- そうでなければ、
- dcを ?
ToIntegerOrInfinity (deleteCount) とする。 - actualDeleteCountをdcを0とlength - actualStartの間に
clamping したresultとする。
- dcを ?
- length + itemCount - actualDeleteCount > 253 - 1なら、
TypeError 例外をthrowする。 - deletedArrayを ?
ArraySpeciesCreate (obj, actualDeleteCount) とする。 - kを0とする。
- k < actualDeleteCountの間、繰り返す
- fromを !
ToString (𝔽 (actualStart + k)) とする。 - ?
HasProperty (obj, from)がtrue なら、- fromValueを ?
Get (obj, from) とする。 - ?
CreateDataPropertyOrThrow (deletedArray, !ToString (𝔽 (k)), fromValue)を実行する。
- fromValueを ?
- kをk + 1に設定する。
- fromを !
- ?
Set (deletedArray,"length" ,𝔽 (actualDeleteCount),true )を実行する。 - itemCount < actualDeleteCountなら、
- kをactualStartに設定する。
- k < (length - actualDeleteCount)の間、繰り返す
- fromを !
ToString (𝔽 (k + actualDeleteCount)) とする。 - toを !
ToString (𝔽 (k + itemCount)) とする。 - ?
HasProperty (obj, from)がtrue なら、 - そうでなければ、
- ?
DeletePropertyOrThrow (obj, to)を実行する。
- ?
- kをk + 1に設定する。
- fromを !
- kをlengthに設定する。
- k > (length - actualDeleteCount + itemCount)の間、繰り返す
- ?
DeletePropertyOrThrow (obj, !ToString (𝔽 (k - 1)))を実行する。 - kをk - 1に設定する。
- ?
- そうでなく、itemCount > actualDeleteCountなら、
- kを(length - actualDeleteCount)に設定する。
- k > actualStartの間、繰り返す
- fromを !
ToString (𝔽 (k + actualDeleteCount - 1)) とする。 - toを !
ToString (𝔽 (k + itemCount - 1)) とする。 - ?
HasProperty (obj, from)がtrue なら、 - そうでなければ、
- ?
DeletePropertyOrThrow (obj, to)を実行する。
- ?
- kをk - 1に設定する。
- fromを !
- kをactualStartに設定する。
- itemsの各要素itemについて、以下を行う
- ?
Set (obj,"length" ,𝔽 (length - actualDeleteCount + itemCount),true )を実行する。 - deletedArrayを返す。
このmethodは意図的にgenericです；その
23.1.3.32 Array.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
ECMA-402 Internationalization APIを含むECMAScript implementationは、このmethodをECMA-402 specificationで指定される通りにimplementしなければなりません。ECMAScript implementationがECMA-402 APIを含まない場合、このmethodの次のspecificationが使用されます。
ECMA-402のfirst editionは、このmethodのreplacement specificationを含みませんでした。
このmethodのoptional parametersのmeaningsはECMA-402 specificationで定義されます；ECMA-402 supportを含まないimplementationsは、それらのparameter positionsを他の何かに使用してはなりません。
このmethodは呼び出されたとき、次のstepsを実行します：
- arrayを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (array) とする。 - separatorを、host environmentのcurrent localeにappropriateな
implementation-defined list-separator String value（", " など）とする。 - resultをempty Stringとする。
- kを0とする。
- k < lengthの間、繰り返す
- k > 0なら、resultをresultとseparatorの
string-concatenation に設定する。 - elementを ?
Get (array, !ToString (𝔽 (k))) とする。 - elementが
undefined でもnull でもないなら、- elementStringを ?
ToString (?Invoke (element,"toLocaleString" )) とする。 - resultをresultとelementStringの
string-concatenation に設定する。
- elementStringを ?
- kをk + 1に設定する。
- k > 0なら、resultをresultとseparatorの
- resultを返す。
このmethodはarrayのelementsをそれらのtoLocaleString methodsを使用してStringsへconvertし、その後、toStringにanalogousですが、host environmentのcurrent localeのconventionsに対応するlocale-sensitive resultをyieldすることを意図している点が異なります。
このmethodは意図的にgenericです；その
23.1.3.33 Array.prototype.toReversed ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - arrayを ?
ArrayCreate (length) とする。 - kを0とする。
- k < lengthの間、繰り返す
- arrayを返す。
23.1.3.34 Array.prototype.toSorted ( comparator )
このmethodは呼び出されたとき、次のstepsを実行します：
- comparatorが
undefined でなく、かつIsCallable (comparator)がfalse なら、TypeError 例外をthrowする。 - objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - arrayを ?
ArrayCreate (length) とする。 - sortCompareを、comparatorをcaptureし、calledされたときに次のstepsを実行する、parameters (x, y)を持つnew
Abstract Closure とする：- ?
CompareArrayElements (x, y, comparator)を返す。
- ?
- sortedListを ?
SortIndexedProperties (obj, length, sortCompare,read-through-holes ) とする。 - jを0とする。
- j < lengthの間、繰り返す
- !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (j)), sortedList[j])を実行する。 - jをj + 1に設定する。
- !
- arrayを返す。
23.1.3.35 Array.prototype.toSpliced ( start, skipCount, ...items )
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - relativeStartを ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞なら、actualStartを0とする。
- そうでなく、relativeStart < 0なら、actualStartを
max (length + relativeStart, 0)とする。 - そうでなければ、actualStartを
min (relativeStart, length)とする。 - insertCountをitems内のelementsの数とする。
- startがpresentでないなら、
- actualSkipCountを0とする。
- そうでなく、skipCountがpresentでないなら、
- actualSkipCountをlength - actualStartとする。
- そうでなければ、
- scを ?
ToIntegerOrInfinity (skipCount) とする。 - actualSkipCountをscを0とlength - actualStartの間に
clamping したresultとする。
- scを ?
- newLengthをlength + insertCount - actualSkipCountとする。
- newLength > 253 - 1なら、
TypeError 例外をthrowする。 - newArrayを ?
ArrayCreate (newLength) とする。 - writeIndexを0とする。
- readIndexをactualStart + actualSkipCountとする。
- writeIndex < actualStartの間、繰り返す
- propertyKeyを !
ToString (𝔽 (writeIndex)) とする。 - iValueを ?
Get (obj, propertyKey) とする。 - !
CreateDataPropertyOrThrow (newArray, propertyKey, iValue)を実行する。 - writeIndexをwriteIndex + 1に設定する。
- propertyKeyを !
- itemsの各要素itemについて、以下を行う
- propertyKeyを !
ToString (𝔽 (writeIndex)) とする。 - !
CreateDataPropertyOrThrow (newArray, propertyKey, item)を実行する。 - writeIndexをwriteIndex + 1に設定する。
- propertyKeyを !
- writeIndex < newLengthの間、繰り返す
- newArrayを返す。
23.1.3.36 Array.prototype.toString ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- arrayを ?
ToObject (this value) とする。 - funcを ?
Get (array,"join" ) とする。 IsCallable (func)がfalse なら、funcをintrinsic function %Object.prototype.toString%に設定する。- ?
Call (func, array)を返す。
このmethodは意図的にgenericです；その
23.1.3.37 Array.prototype.unshift ( ...items )
このmethodは、argumentsをarrayのstartへprependし、array内でのそれらのorderがargument list内でappearするorderとsameになるようにします。
これは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - argCountをitems内のelementsの数とする。
- argCount > 0なら、
- length + argCount > 253 - 1なら、
TypeError 例外をthrowする。 - kをlengthとする。
- k > 0の間、繰り返す
- fromを !
ToString (𝔽 (k - 1)) とする。 - toを !
ToString (𝔽 (k + argCount - 1)) とする。 - fromPresentを ?
HasProperty (obj, from) とする。 - fromPresentが
true なら、 - そうでなければ、
Assert : fromPresentはfalse である。- ?
DeletePropertyOrThrow (obj, to)を実行する。
- kをk - 1に設定する。
- fromを !
- jを
+0 𝔽とする。 - itemsの各要素itemについて、以下を行う
- length + argCount > 253 - 1なら、
- ?
Set (obj,"length" ,𝔽 (length + argCount),true )を実行する。 𝔽 (length + argCount)を返す。
このmethodの
このmethodは意図的にgenericです；その
23.1.3.38 Array.prototype.values ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 CreateArrayIterator (obj,value )を返す。
23.1.3.39 Array.prototype.with ( index, value )
このmethodは呼び出されたとき、次のstepsを実行します：
- objを ?
ToObject (this value) とする。 - lengthを ?
LengthOfArrayLike (obj) とする。 - relativeIndexを ?
ToIntegerOrInfinity (index) とする。 - relativeIndex ≥ 0なら、actualIndexをrelativeIndexとする。
- そうでなければ、actualIndexをlength + relativeIndexとする。
- actualIndex ≥ lengthまたはactualIndex < 0なら、
RangeError 例外をthrowする。 - arrayを ?
ArrayCreate (length) とする。 - kを0とする。
- k < lengthの間、繰り返す
- propertyKeyを !
ToString (𝔽 (k)) とする。 - k = actualIndexなら、fromValueをvalueとする。
- そうでなければ、fromValueを ?
Get (obj, propertyKey) とする。 - !
CreateDataPropertyOrThrow (array, propertyKey, fromValue)を実行する。 - kをk + 1に設定する。
- propertyKeyを !
- arrayを返す。
23.1.3.40 Array.prototype [ %Symbol.iterator% ] ( )
23.1.3.41 Array.prototype [ %Symbol.unscopables% ]
- unscopableListを
OrdinaryObjectCreate (null )とする。 - !
CreateDataPropertyOrThrow (unscopableList,"at" ,true )を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"copyWithin" ,true )を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"entries" ,true )を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"fill" ,true )を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"find" ,true )を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"findIndex" ,true )を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"findLast" ,true )を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"findLastIndex" ,true )を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"flat" ,true )を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"flatMap" ,true )を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"includes" ,true )を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"keys" ,true )を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"toReversed" ,true )を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"toSorted" ,true )を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"toSpliced" ,true )を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"values" ,true )を実行する。 - unscopableListを返す。
このpropertyはattributes { [[Writable]]:
このobjectのown Array.prototypeのstandard propertiesとして含まれていなかったwith statementについてignoredされます。これは、outer scope内のbindingとしてこれらのnamesのいずれかを使用し、そのbindingがbinding objectがArrayであるwith statementによってshadowedされる可能性のあるexisting codeのbehaviourをpreserveするためです。
23.1.4 Properties of Array Instances
Array instancesは
Array instancesは
23.1.4.1 length
Array instanceの
23.1.5 Array Iterator Objects
Array Iteratorは、some specific Array instance object上のspecific iterationを表すobjectです。Array Iterator objectsにはnamed
23.1.5.1 CreateArrayIterator ( array, kind )
The abstract operation CreateArrayIterator takes arguments array (an Object) and kind (
- iteratorを
OrdinaryObjectCreate (%ArrayIteratorPrototype% , « [[IteratedArrayLike]], [[ArrayLikeNextIndex]], [[ArrayLikeIterationKind]] »)とする。 - iterator.[[IteratedArrayLike]]をarrayに設定する。
- iterator.[[ArrayLikeNextIndex]]を0に設定する。
- iterator.[[ArrayLikeIterationKind]]をkindに設定する。
- iteratorを返す。
23.1.5.2 The %ArrayIteratorPrototype% Object
%ArrayIteratorPrototype% objectは：
- すべての
Array Iterator objects によってinheritedされるpropertiesを持ちます。 ordinary object です。- valueが
%Iterator.prototype% である[[Prototype]] internal slotを持ちます。 - 次のpropertiesを持ちます：
23.1.5.2.1 %ArrayIteratorPrototype%.next ( )
- iteratorObjを
this valueとする。 - iteratorObjがObjectでないなら、
TypeError 例外をthrowする。 - iteratorObjが
Array Iterator Instanceのすべてのinternal slots（23.1.5.3 ）を持たないなら、TypeError 例外をthrowする。 - arrayをiteratorObj.[[IteratedArrayLike]]とする。
- arrayが
undefined なら、CreateIteratorResultObject (undefined ,true )を返す。 - indexをiteratorObj.[[ArrayLikeNextIndex]]とする。
- kindをiteratorObj.[[ArrayLikeIterationKind]]とする。
- arrayが[[TypedArrayName]] internal slotを持つなら、
- taRecordを
MakeTypedArrayWithBufferWitnessRecord (array,seq-cst )とする。 IsTypedArrayOutOfBounds (taRecord)がtrue なら、TypeError 例外をthrowする。- lengthを
TypedArrayLength (taRecord)とする。
- taRecordを
- そうでなければ、
- lengthを ?
LengthOfArrayLike (array) とする。
- lengthを ?
- index ≥ lengthなら、
- iteratorObj.[[IteratedArrayLike]]を
undefined に設定する。 CreateIteratorResultObject (undefined ,true )を返す。
- iteratorObj.[[IteratedArrayLike]]を
- iteratorObj.[[ArrayLikeNextIndex]]をindex + 1に設定する。
- indexNumberを
𝔽 (index)とする。 - kindが
key なら、- resultをindexNumberとする。
- そうでなければ、
- elementKeyを !
ToString (indexNumber) とする。 - elementValueを ?
Get (array, elementKey) とする。 - kindが
value なら、- resultをelementValueとする。
- そうでなければ、
Assert : kindはkey+value である。- resultを
CreateArrayFromList (« indexNumber, elementValue »)とする。
- elementKeyを !
CreateIteratorResultObject (result,false )を返す。
23.1.5.2.2 %ArrayIteratorPrototype% [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
23.1.5.3 Properties of Array Iterator Instances
| Internal Slot | Type | Description |
|---|---|---|
| [[IteratedArrayLike]] |
an Object or |
iterateされている |
| [[ArrayLikeNextIndex]] |
a non-negative |
この |
| [[ArrayLikeIterationKind]] |
|
iterationの各elementについて何がreturnedされるかをidentifyするvalue。 |
23.2 TypedArray Objects
TypedArrayは、underlying binary data buffer（
|
|
Element Type | Element Size | Conversion Operation | Description |
|---|---|---|---|---|
|
Int8Array %Int8Array% |
|
1 |
|
8-bit two's complement signed |
|
Uint8Array %Uint8Array% |
|
1 |
|
8-bit unsigned |
|
Uint8ClampedArray %Uint8ClampedArray% |
|
1 |
|
8-bit unsigned |
|
Int16Array %Int16Array% |
|
2 |
|
16-bit two's complement signed |
|
Uint16Array %Uint16Array% |
|
2 |
|
16-bit unsigned |
|
Int32Array %Int32Array% |
|
4 |
|
32-bit two's complement signed |
|
Uint32Array %Uint32Array% |
|
4 |
|
32-bit unsigned |
|
BigInt64Array %BigInt64Array% |
|
8 |
|
64-bit two's complement signed |
|
BigUint64Array %BigUint64Array% |
|
8 |
|
64-bit unsigned |
|
Float16Array %Float16Array% |
|
2 | 16-bit IEEE floating point | |
|
Float32Array %Float32Array% |
|
4 | 32-bit IEEE floating point | |
|
Float64Array %Float64Array% |
|
8 | 64-bit IEEE floating point |
以下のdefinitionsでは、TypedArrayへのreferencesは、上のtableからappropriate
23.2.1 The %TypedArray% Intrinsic Object
%TypedArray% intrinsic objectは：
- すべてのTypedArray
constructor objectsがinheritするconstructor function object です。 - そのcorresponding prototype objectとともに、すべてのTypedArray
constructors およびそのinstancesによってinheritedされるcommon propertiesを提供します。 - global nameを持たず、
global object のpropertyとして現れません。 - various TypedArray
constructors のabstract superclassとしてactします。 - abstract class
constructor であるため、invokedされるとerrorをthrowします。TypedArrayconstructors はこれに対するsupercallをperformしません。
23.2.1.1 %TypedArray% ( )
このfunctionは呼び出されたとき、次のstepsを実行します：
TypeError 例外をthrowする。
このfunctionの
23.2.2 Properties of the %TypedArray% Intrinsic Object
- valueが
%Function.prototype% である[[Prototype]] internal slotを持ちます。 - valueが
"TypedArray" である"name" propertyを持ちます。 - 次のpropertiesを持ちます：
23.2.2.1 %TypedArray%.from ( source [ , mapper [ , thisArg ] ] )
このmethodは呼び出されたとき、次のstepsを実行します：
- ctorを
this valueとする。 IsConstructor (ctor)がfalse なら、TypeError 例外をthrowする。- mapperが
undefined なら、- mappingを
false とする。
- mappingを
- そうでなければ、
IsCallable (mapper)がfalse なら、TypeError 例外をthrowする。- mappingを
true とする。
- usingIteratorを ?
GetMethod (source,%Symbol.iterator% ) とする。 - usingIteratorが
undefined でないなら、- valuesを ?
IteratorToList (?GetIteratorFromMethod (source, usingIterator)) とする。 - lengthをvalues内のelementsの数とする。
- targetObjを ?
TypedArrayCreateFromConstructor (ctor, «𝔽 (length) ») とする。 - kを0とする。
- k < lengthの間、繰り返す
Assert : valuesは現在emptyList である。- targetObjを返す。
- valuesを ?
NOTE : sourceはiterable object ではないため、すでにarray-like object であるとassumeする。- arrayLikeを !
ToObject (source) とする。 - lengthを ?
LengthOfArrayLike (arrayLike) とする。 - targetObjを ?
TypedArrayCreateFromConstructor (ctor, «𝔽 (length) ») とする。 - kを0とする。
- k < lengthの間、繰り返す
- targetObjを返す。
23.2.2.2 %TypedArray%.of ( ...items )
このmethodは呼び出されたとき、次のstepsを実行します：
- lengthをitems内のelementsの数とする。
- ctorを
this valueとする。 IsConstructor (ctor)がfalse なら、TypeError 例外をthrowする。- newObjを ?
TypedArrayCreateFromConstructor (ctor, «𝔽 (length) ») とする。 - kを0とする。
- k < lengthの間、繰り返す
- newObjを返す。
23.2.2.3 %TypedArray%.prototype
.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
23.2.2.4 get %TypedArray% [ %Symbol.species% ]
[%Symbol.species%]は、set accessor functionが
this valueを返す。
このfunctionの
23.2.3 Properties of the %TypedArray% Prototype Object
%TypedArray% prototype objectは：
- valueが
%Object.prototype% である[[Prototype]] internal slotを持ちます。 - %TypedArray.prototype%です。
ordinary object です。- [[ViewedArrayBuffer]]や、TypedArray instance objectsにspecificなその他のinternal slotsを持ちません。
23.2.3.1 %TypedArray%.prototype.at ( index )
- objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - lengthを
TypedArrayLength (taRecord)とする。 - relativeIndexを ?
ToIntegerOrInfinity (index) とする。 - relativeIndex ≥ 0なら、
- kをrelativeIndexとする。
- そうでなければ、
- kをlength + relativeIndexとする。
- k < 0またはk ≥ lengthなら、
undefined を返す。 - !
Get (obj, !ToString (𝔽 (k)))を返す。
23.2.3.2 get %TypedArray%.prototype.buffer
.prototype.bufferは、set accessor functionが
- objを
this valueとする。 - ?
RequireInternalSlot (obj, [[TypedArrayName]])を実行する。 Assert : objは[[ViewedArrayBuffer]] internal slotを持つ。- bufferをobj.[[ViewedArrayBuffer]]とする。
- bufferを返す。
23.2.3.3 get %TypedArray%.prototype.byteLength
.prototype.byteLengthは、set accessor functionが
- objを
this valueとする。 - ?
RequireInternalSlot (obj, [[TypedArrayName]])を実行する。 Assert : objは[[ViewedArrayBuffer]] internal slotを持つ。- taRecordを
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst )とする。 IsTypedArrayOutOfBounds (taRecord)がtrue なら、+0 𝔽を返す。- sizeを
TypedArrayByteLength (taRecord)とする。 𝔽 (size)を返す。
23.2.3.4 get %TypedArray%.prototype.byteOffset
.prototype.byteOffsetは、set accessor functionが
- objを
this valueとする。 - ?
RequireInternalSlot (obj, [[TypedArrayName]])を実行する。 Assert : objは[[ViewedArrayBuffer]] internal slotを持つ。- taRecordを
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst )とする。 IsTypedArrayOutOfBounds (taRecord)がtrue なら、+0 𝔽を返す。- offsetをobj.[[ByteOffset]]とする。
𝔽 (offset)を返す。
23.2.3.5 %TypedArray%.prototype.constructor
.prototype.constructorのinitial valueは
23.2.3.6 %TypedArray%.prototype.copyWithin ( target, start [ , end ] )
このmethodのargumentsのinterpretationおよびuseは、Array.prototype.copyWithinと同じです。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - lengthを
TypedArrayLength (taRecord)とする。 - relativeTargetを ?
ToIntegerOrInfinity (target) とする。 - relativeTarget = -∞なら、targetIndexを0とする。
- そうでなく、relativeTarget < 0なら、targetIndexを
max (length + relativeTarget, 0)とする。 - そうでなければ、targetIndexを
min (relativeTarget, length)とする。 - relativeStartを ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞なら、startIndexを0とする。
- そうでなく、relativeStart < 0なら、startIndexを
max (length + relativeStart, 0)とする。 - そうでなければ、startIndexを
min (relativeStart, length)とする。 - endが
undefined なら、relativeEndをlengthとする；そうでなければ、relativeEndを ?ToIntegerOrInfinity (end) とする。 - relativeEnd = -∞なら、endIndexを0とする。
- そうでなく、relativeEnd < 0なら、endIndexを
max (length + relativeEnd, 0)とする。 - そうでなければ、endIndexを
min (relativeEnd, length)とする。 - countを
min (endIndex - startIndex, length - targetIndex)とする。 - count > 0なら、
NOTE : copyingはsource dataのbit-level encodingをpreserveするmannerでperformedされなければならない。- bufferをobj.[[ViewedArrayBuffer]]とする。
- taRecordを
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst )に設定する。 IsTypedArrayOutOfBounds (taRecord)がtrue なら、TypeError 例外をthrowする。- lengthを
TypedArrayLength (taRecord)に設定する。 NOTE : 上記stepsのside-effectsによりobjのsizeがreducedされた可能性があり、そのcaseではcopyingはlongest still-applicable prefixでproceedすべきである。- countを
min (count, length - startIndex, length - targetIndex)に設定する。 - elementSizeを
TypedArrayElementSize (obj)とする。 - byteOffsetをobj.[[ByteOffset]]とする。
- toByteIndexを(targetIndex × elementSize) + byteOffsetとする。
- fromByteIndexを(startIndex × elementSize) + byteOffsetとする。
- countBytesをcount × elementSizeとする。
- fromByteIndex < toByteIndexかつtoByteIndex < fromByteIndex + countBytesなら、
- directionを-1とする。
- fromByteIndexをfromByteIndex + countBytes - 1に設定する。
- toByteIndexをtoByteIndex + countBytes - 1に設定する。
- そうでなければ、
- directionを1とする。
- countBytes > 0の間、繰り返す
- valueを
GetValueFromBuffer (buffer, fromByteIndex,uint8 ,true ,unordered )とする。 SetValueInBuffer (buffer, toByteIndex,uint8 , value,true ,unordered )を実行する。- fromByteIndexをfromByteIndex + directionに設定する。
- toByteIndexをtoByteIndex + directionに設定する。
- countBytesをcountBytes - 1に設定する。
- valueを
- objを返す。
23.2.3.7 %TypedArray%.prototype.entries ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - ?
ValidateTypedArray (obj,seq-cst )を実行する。 CreateArrayIterator (obj,key+value )を返す。
23.2.3.8 %TypedArray%.prototype.every ( callback [ , thisArg ] )
このmethodのargumentsのinterpretationおよびuseは、Array.prototype.everyと同じです。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - lengthを
TypedArrayLength (taRecord)とする。 IsCallable (callback)がfalse なら、TypeError 例外をthrowする。- kを0とする。
- k < lengthの間、繰り返す
true を返す。
このmethodはgenericではありません。
23.2.3.9 %TypedArray%.prototype.fill ( value [ , start [ , end ] ] )
このmethodのargumentsのinterpretationおよびuseは、Array.prototype.fillと同じです。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - lengthを
TypedArrayLength (taRecord)とする。 - obj.[[ContentType]]が
bigint なら、valueを ?ToBigInt (value) に設定する。 - そうでなければ、valueを ?
ToNumber (value) に設定する。 - relativeStartを ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞なら、startIndexを0とする。
- そうでなく、relativeStart < 0なら、startIndexを
max (length + relativeStart, 0)とする。 - そうでなければ、startIndexを
min (relativeStart, length)とする。 - endが
undefined なら、relativeEndをlengthとする；そうでなければ、relativeEndを ?ToIntegerOrInfinity (end) とする。 - relativeEnd = -∞なら、endIndexを0とする。
- そうでなく、relativeEnd < 0なら、endIndexを
max (length + relativeEnd, 0)とする。 - そうでなければ、endIndexを
min (relativeEnd, length)とする。 - taRecordを
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst )に設定する。 IsTypedArrayOutOfBounds (taRecord)がtrue なら、TypeError 例外をthrowする。- lengthを
TypedArrayLength (taRecord)に設定する。 - endIndexを
min (endIndex, length)に設定する。 - kをstartIndexとする。
- k < endIndexの間、繰り返す
- objを返す。
23.2.3.10 %TypedArray%.prototype.filter ( callback [ , thisArg ] )
このmethodのargumentsのinterpretationおよびuseは、Array.prototype.filterと同じです。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - lengthを
TypedArrayLength (taRecord)とする。 IsCallable (callback)がfalse なら、TypeError 例外をthrowする。- keptを新しい空の
List とする。 - capturedを0とする。
- kを0とする。
- k < lengthの間、繰り返す
- resultを ?
TypedArraySpeciesCreate (obj, «𝔽 (captured) ») とする。 - nを0とする。
- keptの各要素elementについて、以下を行う
- resultを返す。
このmethodはgenericではありません。
23.2.3.11 %TypedArray%.prototype.find ( predicate [ , thisArg ] )
このmethodのargumentsのinterpretationおよびuseは、Array.prototype.findと同じです。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - lengthを
TypedArrayLength (taRecord)とする。 - findRecordを ?
FindViaPredicate (obj, length,ascending , predicate, thisArg) とする。 - findRecord.[[Value]]を返す。
このmethodはgenericではありません。
23.2.3.12 %TypedArray%.prototype.findIndex ( predicate [ , thisArg ] )
このmethodのargumentsのinterpretationおよびuseは、Array.prototype.findIndexと同じです。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - lengthを
TypedArrayLength (taRecord)とする。 - findRecordを ?
FindViaPredicate (obj, length,ascending , predicate, thisArg) とする。 - findRecord.[[Index]]を返す。
このmethodはgenericではありません。
23.2.3.13 %TypedArray%.prototype.findLast ( predicate [ , thisArg ] )
このmethodのargumentsのinterpretationおよびuseは、Array.prototype.findLastと同じです。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - lengthを
TypedArrayLength (taRecord)とする。 - findRecordを ?
FindViaPredicate (obj, length,descending , predicate, thisArg) とする。 - findRecord.[[Value]]を返す。
このmethodはgenericではありません。
23.2.3.14 %TypedArray%.prototype.findLastIndex ( predicate [ , thisArg ] )
このmethodのargumentsのinterpretationおよびuseは、Array.prototype.findLastIndexと同じです。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - lengthを
TypedArrayLength (taRecord)とする。 - findRecordを ?
FindViaPredicate (obj, length,descending , predicate, thisArg) とする。 - findRecord.[[Index]]を返す。
このmethodはgenericではありません。
23.2.3.15 %TypedArray%.prototype.forEach ( callback [ , thisArg ] )
このmethodのargumentsのinterpretationおよびuseは、Array.prototype.forEachと同じです。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - lengthを
TypedArrayLength (taRecord)とする。 IsCallable (callback)がfalse なら、TypeError 例外をthrowする。- kを0とする。
- k < lengthの間、繰り返す
undefined を返す。
このmethodはgenericではありません。
23.2.3.16 %TypedArray%.prototype.includes ( searchElement [ , fromIndex ] )
このmethodのargumentsのinterpretationおよびuseは、Array.prototype.includesと同じです。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - lengthを
TypedArrayLength (taRecord)とする。 - length = 0なら、
false を返す。 - nを ?
ToIntegerOrInfinity (fromIndex) とする。 Assert : fromIndexがundefined なら、nは0である。- n = +∞なら、
false を返す。 - n = -∞なら、nを0に設定する。
- n ≥ 0なら、
- kをnとする。
- そうでなければ、
- kをlength + nとする。
- k < 0なら、kを0に設定する。
- k < lengthの間、繰り返す
- elementKを !
Get (obj, !ToString (𝔽 (k))) とする。 SameValueZero (searchElement, elementK)がtrue なら、true を返す。- kをk + 1に設定する。
- elementKを !
false を返す。
このmethodはgenericではありません。
23.2.3.17 %TypedArray%.prototype.indexOf ( searchElement [ , fromIndex ] )
このmethodのargumentsのinterpretationおよびuseは、Array.prototype.indexOfと同じです。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - lengthを
TypedArrayLength (taRecord)とする。 - length = 0なら、
-1 𝔽を返す。 - nを ?
ToIntegerOrInfinity (fromIndex) とする。 Assert : fromIndexがundefined なら、nは0である。- n = +∞なら、
-1 𝔽を返す。 - n = -∞なら、nを0に設定する。
- n ≥ 0なら、
- kをnとする。
- そうでなければ、
- kをlength + nとする。
- k < 0なら、kを0に設定する。
- k < lengthの間、繰り返す
- propertyKeyを !
ToString (𝔽 (k)) とする。 - kPresentを !
HasProperty (obj, propertyKey) とする。 - kPresentが
true なら、- elementKを !
Get (obj, propertyKey) とする。 IsStrictlyEqual (searchElement, elementK)がtrue なら、𝔽 (k)を返す。
- elementKを !
- kをk + 1に設定する。
- propertyKeyを !
-1 𝔽を返す。
このmethodはgenericではありません。
23.2.3.18 %TypedArray%.prototype.join ( separator )
このmethodのargumentsのinterpretationおよびuseは、Array.prototype.joinと同じです。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - lengthを
TypedArrayLength (taRecord)とする。 - separatorが
undefined なら、sepを"," とする。 - そうでなければ、sepを ?
ToString (separator) とする。 - resultをempty Stringとする。
- kを0とする。
- k < lengthの間、繰り返す
- k > 0なら、resultをresultとsepの
string-concatenation に設定する。 - elementを !
Get (obj, !ToString (𝔽 (k))) とする。 - elementが
undefined でないなら、- elementStringを !
ToString (element) とする。 - resultをresultとelementStringの
string-concatenation に設定する。
- elementStringを !
- kをk + 1に設定する。
- k > 0なら、resultをresultとsepの
- resultを返す。
このmethodはgenericではありません。
23.2.3.19 %TypedArray%.prototype.keys ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - ?
ValidateTypedArray (obj,seq-cst )を実行する。 CreateArrayIterator (obj,key )を返す。
23.2.3.20 %TypedArray%.prototype.lastIndexOf ( searchElement [ , fromIndex ] )
このmethodのargumentsのinterpretationおよびuseは、Array.prototype.lastIndexOfと同じです。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - lengthを
TypedArrayLength (taRecord)とする。 - length = 0なら、
-1 𝔽を返す。 - fromIndexがpresentなら、nを ?
ToIntegerOrInfinity (fromIndex) とする；そうでなければ、nをlength - 1とする。 - n = -∞なら、
-1 𝔽を返す。 - n ≥ 0なら、
- kを
min (n, length - 1)とする。
- kを
- そうでなければ、
- kをlength + nとする。
- k ≥ 0の間、繰り返す
- propertyKeyを !
ToString (𝔽 (k)) とする。 - kPresentを !
HasProperty (obj, propertyKey) とする。 - kPresentが
true なら、- elementKを !
Get (obj, propertyKey) とする。 IsStrictlyEqual (searchElement, elementK)がtrue なら、𝔽 (k)を返す。
- elementKを !
- kをk - 1に設定する。
- propertyKeyを !
-1 𝔽を返す。
このmethodはgenericではありません。
23.2.3.21 get %TypedArray%.prototype.length
.prototype.lengthは、set accessor functionが
- objを
this valueとする。 - ?
RequireInternalSlot (obj, [[TypedArrayName]])を実行する。 Assert : objは[[ViewedArrayBuffer]]および[[ArrayLength]] internal slotsを持つ。- taRecordを
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst )とする。 IsTypedArrayOutOfBounds (taRecord)がtrue なら、+0 𝔽を返す。- lengthを
TypedArrayLength (taRecord)とする。 𝔽 (length)を返す。
このfunctionはgenericではありません。
23.2.3.22 %TypedArray%.prototype.map ( callback [ , thisArg ] )
このmethodのargumentsのinterpretationおよびuseは、Array.prototype.mapと同じです。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - lengthを
TypedArrayLength (taRecord)とする。 IsCallable (callback)がfalse なら、TypeError 例外をthrowする。- resultを ?
TypedArraySpeciesCreate (obj, «𝔽 (length) ») とする。 - kを0とする。
- k < lengthの間、繰り返す
- resultを返す。
このmethodはgenericではありません。
23.2.3.23 %TypedArray%.prototype.reduce ( callback [ , initialValue ] )
このmethodのargumentsのinterpretationおよびuseは、Array.prototype.reduceと同じです。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - lengthを
TypedArrayLength (taRecord)とする。 IsCallable (callback)がfalse なら、TypeError 例外をthrowする。- length = 0であり、かつinitialValueがpresentでないなら、
TypeError 例外をthrowする。 - kを0とする。
- accumulatorを
undefined とする。 - initialValueがpresentなら、
- accumulatorをinitialValueに設定する。
- そうでなければ、
- k < lengthの間、繰り返す
- accumulatorを返す。
このmethodはgenericではありません。
23.2.3.24 %TypedArray%.prototype.reduceRight ( callback [ , initialValue ] )
このmethodのargumentsのinterpretationおよびuseは、Array.prototype.reduceRightと同じです。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - lengthを
TypedArrayLength (taRecord)とする。 IsCallable (callback)がfalse なら、TypeError 例外をthrowする。- length = 0であり、かつinitialValueがpresentでないなら、
TypeError 例外をthrowする。 - kをlength - 1とする。
- accumulatorを
undefined とする。 - initialValueがpresentなら、
- accumulatorをinitialValueに設定する。
- そうでなければ、
- k ≥ 0の間、繰り返す
- accumulatorを返す。
このmethodはgenericではありません。
23.2.3.25 %TypedArray%.prototype.reverse ( )
このmethodのargumentsのinterpretationおよびuseは、Array.prototype.reverseと同じです。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - lengthを
TypedArrayLength (taRecord)とする。 - middleを
floor (length / 2)とする。 - lowerを0とする。
- lower ≠ middleの間、繰り返す
- objを返す。
このmethodはgenericではありません。
23.2.3.26 %TypedArray%.prototype.set ( source [ , offset ] )
このmethodは、このTypedArray内のmultiple valuesをsetし、sourceからvaluesを読み取ります。detailsはsourceのtypeに基づいて異なります。optional offset valueは、valuesがwrittenされるこのTypedArray内のfirst element indexを示します。omittedされる場合、0であるとassumedされます。
これは呼び出されたとき、次のstepsを実行します：
- targetを
this valueとする。 - ?
RequireInternalSlot (target, [[TypedArrayName]])を実行する。 Assert : targetは[[ViewedArrayBuffer]] internal slotを持つ。- targetOffsetを ?
ToIntegerOrInfinity (offset) とする。 - targetOffset < 0なら、
RangeError 例外をthrowする。 - sourceが[[TypedArrayName]] internal slotを持つObjectなら、
- ?
SetTypedArrayFromTypedArray (target, targetOffset, source)を実行する。
- ?
- そうでなければ、
- ?
SetTypedArrayFromArrayLike (target, targetOffset, source)を実行する。
- ?
undefined を返す。
このmethodはgenericではありません。
23.2.3.26.1 SetTypedArrayFromArrayLike ( target, targetOffset, source )
The abstract operation SetTypedArrayFromArrayLike takes arguments target (a
- targetRecordを
MakeTypedArrayWithBufferWitnessRecord (target,seq-cst )とする。 IsTypedArrayOutOfBounds (targetRecord)がtrue なら、TypeError 例外をthrowする。- targetLengthを
TypedArrayLength (targetRecord)とする。 - sourceを ?
ToObject (source) に設定する。 - sourceLengthを ?
LengthOfArrayLike (source) とする。 - targetOffset = +∞なら、
RangeError 例外をthrowする。 - sourceLength + targetOffset > targetLengthなら、
RangeError 例外をthrowする。 - kを0とする。
- k < sourceLengthの間、繰り返す
- propertyKeyを !
ToString (𝔽 (k)) とする。 - valueを ?
Get (source, propertyKey) とする。 - targetIndexを
𝔽 (targetOffset + k)とする。 - ?
TypedArraySetElement (target, targetIndex, value)を実行する。 - kをk + 1に設定する。
- propertyKeyを !
unused を返す。
23.2.3.26.2 SetTypedArrayFromTypedArray ( target, targetOffset, source )
The abstract operation SetTypedArrayFromTypedArray takes arguments target (a
- targetBufferをtarget.[[ViewedArrayBuffer]]とする。
- targetRecordを
MakeTypedArrayWithBufferWitnessRecord (target,seq-cst )とする。 IsTypedArrayOutOfBounds (targetRecord)がtrue なら、TypeError 例外をthrowする。- targetLengthを
TypedArrayLength (targetRecord)とする。 - sourceBufferをsource.[[ViewedArrayBuffer]]とする。
- sourceRecordを
MakeTypedArrayWithBufferWitnessRecord (source,seq-cst )とする。 IsTypedArrayOutOfBounds (sourceRecord)がtrue なら、TypeError 例外をthrowする。- sourceLengthを
TypedArrayLength (sourceRecord)とする。 - targetTypeを
TypedArrayElementType (target)とする。 - targetElementSizeを
TypedArrayElementSize (target)とする。 - targetByteOffsetをtarget.[[ByteOffset]]とする。
- sourceTypeを
TypedArrayElementType (source)とする。 - sourceElementSizeを
TypedArrayElementSize (source)とする。 - sourceByteOffsetをsource.[[ByteOffset]]とする。
- targetOffset = +∞なら、
RangeError 例外をthrowする。 - sourceLength + targetOffset > targetLengthなら、
RangeError 例外をthrowする。 - target.[[ContentType]]がsource.[[ContentType]]でないなら、
TypeError 例外をthrowする。 IsSharedArrayBuffer (sourceBuffer)がtrue であり、IsSharedArrayBuffer (targetBuffer)がtrue であり、かつsourceBuffer.[[ArrayBufferData]]がtargetBuffer.[[ArrayBufferData]]であるなら、sameSharedArrayBufferをtrue とする；そうでなければ、sameSharedArrayBufferをfalse とする。SameValue (sourceBuffer, targetBuffer)がtrue またはsameSharedArrayBufferがtrue なら、- sourceByteLengthを
TypedArrayByteLength (sourceRecord)とする。 - sourceBufferを ?
CloneArrayBuffer (sourceBuffer, sourceByteOffset, sourceByteLength) に設定する。 - sourceByteIndexを0とする。
- sourceByteLengthを
- そうでなければ、
- sourceByteIndexをsourceByteOffsetとする。
- targetByteIndexを(targetOffset × targetElementSize) + targetByteOffsetとする。
- limitをtargetByteIndex + (targetElementSize × sourceLength)とする。
- sourceTypeがtargetTypeなら、
NOTE : transferはsource dataのbit-level encodingをpreserveするmannerでperformedされなければならない。- targetByteIndex < limitの間、繰り返す
- valueを
GetValueFromBuffer (sourceBuffer, sourceByteIndex,uint8 ,true ,unordered )とする。 SetValueInBuffer (targetBuffer, targetByteIndex,uint8 , value,true ,unordered )を実行する。- sourceByteIndexをsourceByteIndex + 1に設定する。
- targetByteIndexをtargetByteIndex + 1に設定する。
- valueを
- そうでなければ、
- targetByteIndex < limitの間、繰り返す
- valueを
GetValueFromBuffer (sourceBuffer, sourceByteIndex, sourceType,true ,unordered )とする。 SetValueInBuffer (targetBuffer, targetByteIndex, targetType, value,true ,unordered )を実行する。- sourceByteIndexをsourceByteIndex + sourceElementSizeに設定する。
- targetByteIndexをtargetByteIndex + targetElementSizeに設定する。
- valueを
- targetByteIndex < limitの間、繰り返す
unused を返す。
23.2.3.27 %TypedArray%.prototype.slice ( start, end )
このmethodのargumentsのinterpretationおよびuseは、Array.prototype.sliceと同じです。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - sourceArrayLengthを
TypedArrayLength (taRecord)とする。 - relativeStartを ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞なら、startIndexを0とする。
- そうでなく、relativeStart < 0なら、startIndexを
max (sourceArrayLength + relativeStart, 0)とする。 - そうでなければ、startIndexを
min (relativeStart, sourceArrayLength)とする。 - endが
undefined なら、relativeEndをsourceArrayLengthとする；そうでなければ、relativeEndを ?ToIntegerOrInfinity (end) とする。 - relativeEnd = -∞なら、endIndexを0とする。
- そうでなく、relativeEnd < 0なら、endIndexを
max (sourceArrayLength + relativeEnd, 0)とする。 - そうでなければ、endIndexを
min (relativeEnd, sourceArrayLength)とする。 - countBytesを
max (endIndex - startIndex, 0)とする。 - resultArrayを ?
TypedArraySpeciesCreate (obj, «𝔽 (countBytes) ») とする。 - countBytes > 0なら、
- taRecordを
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst )に設定する。 IsTypedArrayOutOfBounds (taRecord)がtrue なら、TypeError 例外をthrowする。- endIndexを
min (endIndex,TypedArrayLength (taRecord))に設定する。 - countBytesを
max (endIndex - startIndex, 0)に設定する。 - sourceTypeを
TypedArrayElementType (obj)とする。 - targetTypeを
TypedArrayElementType (resultArray)とする。 - sourceTypeがtargetTypeなら、
NOTE : transferはsource dataのbit-level encodingをpreserveするmannerでperformedされなければならない。- sourceBufferをobj.[[ViewedArrayBuffer]]とする。
- targetBufferをresultArray.[[ViewedArrayBuffer]]とする。
- elementSizeを
TypedArrayElementSize (obj)とする。 - sourceByteOffsetをobj.[[ByteOffset]]とする。
- sourceByteIndexを(startIndex × elementSize) + sourceByteOffsetとする。
- targetByteIndexをresultArray.[[ByteOffset]]とする。
- endByteIndexをtargetByteIndex + (countBytes × elementSize)とする。
- targetByteIndex < endByteIndexの間、繰り返す
- valueを
GetValueFromBuffer (sourceBuffer, sourceByteIndex,uint8 ,true ,unordered )とする。 SetValueInBuffer (targetBuffer, targetByteIndex,uint8 , value,true ,unordered )を実行する。- sourceByteIndexをsourceByteIndex + 1に設定する。
- targetByteIndexをtargetByteIndex + 1に設定する。
- valueを
- そうでなければ、
- taRecordを
- resultArrayを返す。
このmethodはgenericではありません。
23.2.3.28 %TypedArray%.prototype.some ( callback [ , thisArg ] )
このmethodのargumentsのinterpretationおよびuseは、Array.prototype.someと同じです。
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - lengthを
TypedArrayLength (taRecord)とする。 IsCallable (callback)がfalse なら、TypeError 例外をthrowする。- kを0とする。
- k < lengthの間、繰り返す
false を返す。
このmethodはgenericではありません。
23.2.3.29 %TypedArray%.prototype.sort ( comparator )
これはdistinct methodであり、以下でdescribedされる点を除き、Array.prototype.sortのrequirementsとsame requirementsをimplementします。このmethodのimplementationは、
このmethodはgenericではありません。
これは呼び出されたとき、次のstepsを実行します：
- comparatorが
undefined でなく、かつIsCallable (comparator)がfalse なら、TypeError 例外をthrowする。 - objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - lengthを
TypedArrayLength (taRecord)とする。 NOTE : 以下のclosureは、23.1.3.30 で使用されるstring comparisonではなくnumeric comparisonをperformする。- sortCompareを、comparatorをcaptureし、calledされたときに次のstepsを実行する、parameters (x, y)を持つnew
Abstract Closure とする：- ?
CompareTypedArrayElements (x, y, comparator)を返す。
- ?
- sortedListを ?
SortIndexedProperties (obj, length, sortCompare,read-through-holes ) とする。 - jを0とする。
- j < lengthの間、繰り返す
- objを返す。
23.2.3.30 %TypedArray%.prototype.subarray ( start, end )
このmethodは、element typeがこのTypedArrayのelement typeであり、ArrayBufferがこのTypedArrayのArrayBufferであるnew TypedArrayを返し、start（inclusive）からend（exclusive）までの
これは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - ?
RequireInternalSlot (obj, [[TypedArrayName]])を実行する。 Assert : objは[[ViewedArrayBuffer]] internal slotを持つ。- bufferをobj.[[ViewedArrayBuffer]]とする。
- sourceRecordを
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst )とする。 IsTypedArrayOutOfBounds (sourceRecord)がtrue なら、- sourceLengthを0とする。
- そうでなければ、
- sourceLengthを
TypedArrayLength (sourceRecord)とする。
- sourceLengthを
- relativeStartを ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞なら、startIndexを0とする。
- そうでなく、relativeStart < 0なら、startIndexを
max (sourceLength + relativeStart, 0)とする。 - そうでなければ、startIndexを
min (relativeStart, sourceLength)とする。 - elementSizeを
TypedArrayElementSize (obj)とする。 - sourceByteOffsetをobj.[[ByteOffset]]とする。
- beginByteOffsetをsourceByteOffset + (startIndex × elementSize)とする。
- obj.[[ArrayLength]]が
auto であり、かつendがundefined なら、- argListを« buffer,
𝔽 (beginByteOffset) »とする。
- argListを« buffer,
- そうでなければ、
- endが
undefined なら、relativeEndをsourceLengthとする；そうでなければ、relativeEndを ?ToIntegerOrInfinity (end) とする。 - relativeEnd = -∞なら、endIndexを0とする。
- そうでなく、relativeEnd < 0なら、endIndexを
max (sourceLength + relativeEnd, 0)とする。 - そうでなければ、endIndexを
min (relativeEnd, sourceLength)とする。 - newLengthを
max (endIndex - startIndex, 0)とする。 - argListを« buffer,
𝔽 (beginByteOffset),𝔽 (newLength) »とする。
- endが
- ?
TypedArraySpeciesCreate (obj, argList)を返す。
このmethodはgenericではありません。
23.2.3.31 %TypedArray%.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
これはdistinct methodであり、Array.prototype.toLocaleStringとsame algorithmをimplementします。ただし、
このmethodはgenericではありません。
ECMAScript implementationがECMA-402 Internationalization APIを含む場合、このmethodはECMA-402 specification内のArray.prototype.toLocaleStringのalgorithmに基づきます。
23.2.3.32 %TypedArray%.prototype.toReversed ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - lengthを
TypedArrayLength (taRecord)とする。 - resultArrayを ?
TypedArrayCreateSameType (obj, length) とする。 - kを0とする。
- k < lengthの間、繰り返す
- resultArrayを返す。
23.2.3.33 %TypedArray%.prototype.toSorted ( comparator )
このmethodは呼び出されたとき、次のstepsを実行します：
- comparatorが
undefined でなく、かつIsCallable (comparator)がfalse なら、TypeError 例外をthrowする。 - objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - lengthを
TypedArrayLength (taRecord)とする。 - resultArrayを ?
TypedArrayCreateSameType (obj, length) とする。 NOTE : 以下のclosureは、23.1.3.34 で使用されるstring comparisonではなくnumeric comparisonをperformする。- sortCompareを、comparatorをcaptureし、calledされたときに次のstepsを実行する、parameters (x, y)を持つnew
Abstract Closure とする：- ?
CompareTypedArrayElements (x, y, comparator)を返す。
- ?
- sortedListを ?
SortIndexedProperties (obj, length, sortCompare,read-through-holes ) とする。 - jを0とする。
- j < lengthの間、繰り返す
- resultArrayを返す。
23.2.3.34 %TypedArray%.prototype.toString ( )
23.2.3.35 %TypedArray%.prototype.values ( )
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - ?
ValidateTypedArray (obj,seq-cst )を実行する。 CreateArrayIterator (obj,value )を返す。
23.2.3.36 %TypedArray%.prototype.with ( index, value )
このmethodは呼び出されたとき、次のstepsを実行します：
- objを
this valueとする。 - taRecordを ?
ValidateTypedArray (obj,seq-cst ) とする。 - lengthを
TypedArrayLength (taRecord)とする。 - relativeIndexを ?
ToIntegerOrInfinity (index) とする。 - relativeIndex ≥ 0なら、actualIndexをrelativeIndexとする。
- そうでなければ、actualIndexをlength + relativeIndexとする。
- obj.[[ContentType]]が
bigint なら、numericValueを ?ToBigInt (value) とする。 - そうでなければ、numericValueを ?
ToNumber (value) とする。 IsValidIntegerIndex (obj,𝔽 (actualIndex))がfalse なら、RangeError 例外をthrowする。- resultArrayを ?
TypedArrayCreateSameType (obj, length) とする。 - kを0とする。
- k < lengthの間、繰り返す
- resultArrayを返す。
23.2.3.37 %TypedArray%.prototype [ %Symbol.iterator% ] ( )
23.2.3.38 get %TypedArray%.prototype [ %Symbol.toStringTag% ]
.prototype[%Symbol.toStringTag%]は、set accessor functionが
- objを
this valueとする。 - objがObjectでないなら、
undefined を返す。 - objが[[TypedArrayName]] internal slotを持たないなら、
undefined を返す。 - nameをobj.[[TypedArrayName]]とする。
Assert : nameはStringである。- nameを返す。
このpropertyはattributes { [[Enumerable]]:
このfunctionの
23.2.4 Abstract Operations for TypedArray Objects
23.2.4.1 TypedArrayCreateFromConstructor ( ctor, argList )
The abstract operation TypedArrayCreateFromConstructor takes arguments ctor (a
- taを ?
Construct (ctor, argList) とする。 - taRecordを ?
ValidateTypedArray (ta,seq-cst ) とする。 Assert : taはProperties of TypedArray Instances でmentionedされるすべてのinternal slotsを持つ。- argList内のelementsの数が1であり、かつargList[0]がNumberなら、
IsTypedArrayOutOfBounds (taRecord)がtrue なら、TypeError 例外をthrowする。- lengthを
TypedArrayLength (taRecord)とする。 - length <
ℝ (argList[0])なら、TypeError 例外をthrowする。
- taを返す。
23.2.4.2 TypedArrayCreateSameType ( exemplar, length )
The abstract operation TypedArrayCreateSameType takes arguments exemplar (a
- ctorを、
Table 71 内のconstructor name exemplar.[[TypedArrayName]]にassociatedするintrinsic objectとする。 - resultを ?
TypedArrayCreateFromConstructor (ctor, «𝔽 (length) ») とする。 Assert : resultは[[TypedArrayName]]および[[ContentType]] internal slotsを持つ。Assert : result.[[ContentType]]はexemplar.[[ContentType]]である。- resultを返す。
23.2.4.3 TypedArraySpeciesCreate ( exemplar, argList )
The abstract operation TypedArraySpeciesCreate takes arguments exemplar (a
- defaultCtorを、
Table 71 内のconstructor name exemplar.[[TypedArrayName]]にassociatedするintrinsic objectとする。 - ctorを ?
SpeciesConstructor (exemplar, defaultCtor) とする。 - resultを ?
TypedArrayCreateFromConstructor (ctor, argList) とする。 - result.[[ContentType]]がexemplar.[[ContentType]]でないなら、
TypeError 例外をthrowする。 - resultを返す。
23.2.4.4 ValidateTypedArray ( obj, order )
The abstract operation ValidateTypedArray takes arguments obj (an ECMAScript language value) and order (
- ?
RequireInternalSlot (obj, [[TypedArrayName]])を実行する。 Assert : objは[[ViewedArrayBuffer]] internal slotを持つ。- taRecordを
MakeTypedArrayWithBufferWitnessRecord (obj, order)とする。 IsTypedArrayOutOfBounds (taRecord)がtrue なら、TypeError 例外をthrowする。- taRecordを返す。
23.2.4.5 TypedArrayElementSize ( obj )
The abstract operation TypedArrayElementSize takes argument obj (a
- obj.[[TypedArrayName]]について
Table 71 でspecifiedされるElement Size valueを返す。
23.2.4.6 TypedArrayElementType ( obj )
The abstract operation TypedArrayElementType takes argument obj (a
- obj.[[TypedArrayName]]について
Table 71 でspecifiedされるElement Type valueを返す。
23.2.4.7 CompareTypedArrayElements ( x, y, comparator )
The abstract operation CompareTypedArrayElements takes arguments x (a Number or a BigInt), y (a Number or a BigInt), and comparator (a
Assert : xはNumberでありyはNumberである、またはxはBigIntでありyはBigIntである。- comparatorが
undefined でないなら、 - xが
NaN であり、かつyがNaN なら、+0 𝔽を返す。 - xが
NaN なら、1 𝔽を返す。 - yが
NaN なら、-1 𝔽を返す。 - x < yなら、
-1 𝔽を返す。 - x > yなら、
1 𝔽を返す。 - xが
-0 𝔽であり、かつyが+0 𝔽なら、-1 𝔽を返す。 - xが
+0 𝔽であり、かつyが-0 𝔽なら、1 𝔽を返す。 +0 𝔽を返す。
23.2.5 The TypedArray Constructors
各TypedArray
- otherwise notedされる場合を除き、
Table 71 内で、TypedArrayの代わりにconstructor nameとして使用されるnameのみが異なる、以下でdescribedされるstructureを持つintrinsic objectです。 - argumentsの数およびtypesに基づいてbehaviourが異なるfunctionです。TypedArrayのcallのactual behaviourは、それにpassedされるargumentsのnumberおよびkindに依存します。
- functionとして呼び出されることを意図しておらず、そのようなmannerで呼び出されるとexceptionをthrowします。
- クラス定義の
extends句の値として使用できる。指定された TypedArray の動作を継承しようとするサブクラスコンストラクターは、%TypedArray% .prototypeの組み込みメソッドをサポートするために必要な内部状態でサブクラスインスタンスを作成し初期化するため、TypedArray コンストラクターへのsuper呼び出しを含めなければならない。
23.2.5.1 TypedArray ( ...args )
各TypedArray
- NewTargetが
undefined なら、TypeError 例外をthrowする。 - ctorNameを、this TypedArray
constructor についてTable 71 でspecifiedされるConstructor Name valueのString valueとする。 - protoを
"%TypedArray.prototype%"とする。 - numberOfArgsをargs内のelementsの数とする。
- numberOfArgs = 0なら、?
AllocateTypedArray (ctorName, NewTarget, proto, 0)を返す。 - firstArgをargs[0]とする。
- firstArgがObjectなら、
- objを ?
AllocateTypedArray (ctorName, NewTarget, proto) とする。 - firstArgが[[TypedArrayName]] internal slotを持つなら、
- ?
InitializeTypedArrayFromTypedArray (obj, firstArg)を実行する。
- ?
- そうでなく、firstArgが[[ArrayBufferData]] internal slotを持つなら、
- numberOfArgs > 1なら、byteOffsetをargs[1]とする；そうでなければ、byteOffsetを
undefined とする。 - numberOfArgs > 2なら、lengthをargs[2]とする；そうでなければ、lengthを
undefined とする。 - ?
InitializeTypedArrayFromArrayBuffer (obj, firstArg, byteOffset, length)を実行する。
- numberOfArgs > 1なら、byteOffsetをargs[1]とする；そうでなければ、byteOffsetを
- そうでなければ、
Assert : firstArgはObjectであり、firstArgは[[TypedArrayName]]および[[ArrayBufferData]] internal slotのいずれも持たない。- usingIteratorを ?
GetMethod (firstArg,%Symbol.iterator% ) とする。 - usingIteratorが
undefined でないなら、- valuesを ?
IteratorToList (?GetIteratorFromMethod (firstArg, usingIterator)) とする。 - ?
InitializeTypedArrayFromList (obj, values)を実行する。
- valuesを ?
- そうでなければ、
NOTE : firstArgはiterable object ではないため、すでにarray-like object であるとassumeする。- ?
InitializeTypedArrayFromArrayLike (obj, firstArg)を実行する。
- objを返す。
- objを ?
Assert : firstArgはObjectではない。- elementLengthを ?
ToIndex (firstArg) とする。 - ?
AllocateTypedArray (ctorName, NewTarget, proto, elementLength)を返す。
23.2.5.1.1 AllocateTypedArray ( ctorName, newTarget, defaultProto [ , length ] )
The abstract operation AllocateTypedArray takes arguments ctorName (a String which is the name of a
- protoを ?
GetPrototypeFromConstructor (newTarget, defaultProto) とする。 - objを
TypedArrayCreate (proto)とする。 Assert : obj.[[ViewedArrayBuffer]]はundefined である。- obj.[[TypedArrayName]]をctorNameに設定する。
- ctorNameが
"BigInt64Array" または"BigUint64Array" のいずれかなら、obj.[[ContentType]]をbigint に設定する。 - そうでなければ、obj.[[ContentType]]を
number に設定する。 - lengthがpresentでないなら、
- obj.[[ByteLength]]を0に設定する。
- obj.[[ByteOffset]]を0に設定する。
- obj.[[ArrayLength]]を0に設定する。
- そうでなければ、
- ?
AllocateTypedArrayBuffer (obj, length)を実行する。
- ?
- objを返す。
23.2.5.1.2 InitializeTypedArrayFromTypedArray ( obj, sourceArray )
The abstract operation InitializeTypedArrayFromTypedArray takes arguments obj (a
- sourceDataをsourceArray.[[ViewedArrayBuffer]]とする。
- elementTypeを
TypedArrayElementType (obj)とする。 - elementSizeを
TypedArrayElementSize (obj)とする。 - sourceTypeを
TypedArrayElementType (sourceArray)とする。 - sourceElementSizeを
TypedArrayElementSize (sourceArray)とする。 - sourceByteOffsetをsourceArray.[[ByteOffset]]とする。
- sourceRecordを
MakeTypedArrayWithBufferWitnessRecord (sourceArray,seq-cst )とする。 IsTypedArrayOutOfBounds (sourceRecord)がtrue なら、TypeError 例外をthrowする。- elementLengthを
TypedArrayLength (sourceRecord)とする。 - byteLengthをelementSize × elementLengthとする。
- elementTypeがsourceTypeなら、
- dataを ?
CloneArrayBuffer (sourceData, sourceByteOffset, byteLength) とする。
- dataを ?
- そうでなければ、
- dataを ?
AllocateArrayBuffer (%ArrayBuffer% , byteLength) とする。 - sourceArray.[[ContentType]]がobj.[[ContentType]]でないなら、
TypeError 例外をthrowする。 - sourceByteIndexをsourceByteOffsetとする。
- targetByteIndexを0とする。
- countをelementLengthとする。
- count > 0の間、繰り返す
- valueを
GetValueFromBuffer (sourceData, sourceByteIndex, sourceType,true ,unordered )とする。 SetValueInBuffer (data, targetByteIndex, elementType, value,true ,unordered )を実行する。- sourceByteIndexをsourceByteIndex + sourceElementSizeに設定する。
- targetByteIndexをtargetByteIndex + elementSizeに設定する。
- countをcount - 1に設定する。
- valueを
- dataを ?
- obj.[[ViewedArrayBuffer]]をdataに設定する。
- obj.[[ByteLength]]をbyteLengthに設定する。
- obj.[[ByteOffset]]を0に設定する。
- obj.[[ArrayLength]]をelementLengthに設定する。
unused を返す。
23.2.5.1.3 InitializeTypedArrayFromArrayBuffer ( obj, buffer, byteOffset, length )
The abstract operation InitializeTypedArrayFromArrayBuffer takes arguments obj (a
- elementSizeを
TypedArrayElementSize (obj)とする。 - offsetを ?
ToIndex (byteOffset) とする。 - offset
modulo elementSize ≠ 0なら、RangeError 例外をthrowする。 - bufferIsFixedLengthを
IsFixedLengthArrayBuffer (buffer)とする。 - lengthが
undefined でないなら、- newLengthを ?
ToIndex (length) とする。
- newLengthを ?
IsDetachedBuffer (buffer)がtrue なら、TypeError 例外をthrowする。- bufferByteLengthを
ArrayBufferByteLength (buffer,seq-cst )とする。 - lengthが
undefined であり、かつbufferIsFixedLengthがfalse なら、- offset > bufferByteLengthなら、
RangeError 例外をthrowする。 - obj.[[ByteLength]]を
auto に設定する。 - obj.[[ArrayLength]]を
auto に設定する。
- offset > bufferByteLengthなら、
- そうでなければ、
- lengthが
undefined なら、- bufferByteLength
modulo elementSize ≠ 0なら、RangeError 例外をthrowする。 - newByteLengthをbufferByteLength - offsetとする。
- newByteLength < 0なら、
RangeError 例外をthrowする。
- bufferByteLength
- そうでなければ、
- newByteLengthをnewLength × elementSizeとする。
- offset + newByteLength > bufferByteLengthなら、
RangeError 例外をthrowする。
- obj.[[ByteLength]]をnewByteLengthに設定する。
- obj.[[ArrayLength]]をnewByteLength / elementSizeに設定する。
- lengthが
- obj.[[ViewedArrayBuffer]]をbufferに設定する。
- obj.[[ByteOffset]]をoffsetに設定する。
unused を返す。
23.2.5.1.4 InitializeTypedArrayFromList ( obj, values )
The abstract operation InitializeTypedArrayFromList takes arguments obj (a
23.2.5.1.5 InitializeTypedArrayFromArrayLike ( obj, arrayLike )
The abstract operation InitializeTypedArrayFromArrayLike takes arguments obj (a
- lengthを ?
LengthOfArrayLike (arrayLike) とする。 - ?
AllocateTypedArrayBuffer (obj, length)を実行する。 - kを0とする。
- k < lengthの間、繰り返す
unused を返す。
23.2.5.1.6 AllocateTypedArrayBuffer ( obj, length )
The abstract operation AllocateTypedArrayBuffer takes arguments obj (a
Assert : obj.[[ViewedArrayBuffer]]はundefined である。- elementSizeを
TypedArrayElementSize (obj)とする。 - byteLengthをelementSize × lengthとする。
- dataを ?
AllocateArrayBuffer (%ArrayBuffer% , byteLength) とする。 - obj.[[ViewedArrayBuffer]]をdataに設定する。
- obj.[[ByteLength]]をbyteLengthに設定する。
- obj.[[ByteOffset]]を0に設定する。
- obj.[[ArrayLength]]をlengthに設定する。
unused を返す。
23.2.6 Properties of the TypedArray Constructors
各TypedArray
- valueが
%TypedArray% である[[Prototype]] internal slotを持ちます。 - valueが
3 𝔽である"length" propertyを持ちます。 - valueが、
Table 71 でそれについてspecifiedされるconstructor nameのString valueである"name" propertyを持ちます。 - 次のpropertiesを持ちます：
23.2.6.1 TypedArray.BYTES_PER_ELEMENT
TypedArray.BYTES_PER_ELEMENTのvalueは、TypedArrayについて
このpropertyはattributes { [[Writable]]:
23.2.6.2 TypedArray.prototype
TypedArray.prototypeのinitial valueは、corresponding TypedArray prototype intrinsic object（
このpropertyはattributes { [[Writable]]:
23.2.7 Properties of the TypedArray Prototype Objects
各TypedArray prototype objectは：
- valueが
%TypedArray.prototype% である[[Prototype]] internal slotを持ちます。 ordinary object です。- [[ViewedArrayBuffer]]や、TypedArray instance objectsにspecificなその他のinternal slotsを持ちません。
23.2.7.1 TypedArray.prototype.BYTES_PER_ELEMENT
TypedArray.prototype.BYTES_PER_ELEMENTのvalueは、TypedArrayについて
このpropertyはattributes { [[Writable]]:
23.2.7.2 TypedArray.prototype.constructor
given TypedArray
23.2.8 Properties of TypedArray Instances
TypedArray instancesは
23.3 Uint8Arrayオブジェクト
Uint8Arrayは、上でdescribedされたTypedArrayのparticular kindです。加えて、Uint8Array
23.3.1 Uint8Array Constructorの追加プロパティ
23.3.1.1 Uint8Array.fromBase64 ( string [ , options ] )
- stringがStringでないなら、
TypeError 例外をthrowする。 - optsを ?
GetOptionsObject (options) とする。 - alphabetを ?
Get (opts,"alphabet" ) とする。 - alphabetが
undefined なら、alphabetを"base64" に設定する。 - alphabetが
"base64" でも"base64url" でもないなら、TypeError 例外をthrowする。 - lastChunkHandlingを ?
Get (opts,"lastChunkHandling" ) とする。 - lastChunkHandlingが
undefined なら、lastChunkHandlingを"loose" に設定する。 - lastChunkHandlingが
"loose" 、"strict" 、または"stop-before-partial" のいずれでもないなら、TypeError 例外をthrowする。 - resultを
FromBase64 (string, alphabet, lastChunkHandling)とする。 - result.[[Error]]が
none でないなら、- result.[[Error]]をthrowする。
- resultLengthをresult.[[Bytes]]内のelementsの数とする。
- taを ?
AllocateTypedArray ("Uint8Array" ,%Uint8Array% ,"%Uint8Array.prototype%" , resultLength) とする。 Assert : ta.[[ViewedArrayBuffer]].[[ArrayBufferByteLength]]はresult.[[Bytes]]内のelementsの数である。- ta.[[ViewedArrayBuffer]].[[ArrayBufferData]]の各indexのvalueを、result.[[Bytes]]のcorresponding indexのvalueに設定する。
- taを返す。
23.3.1.2 Uint8Array.fromHex ( string )
- stringがStringでないなら、
TypeError 例外をthrowする。 - resultを
FromHex (string)とする。 - result.[[Error]]が
none でないなら、- result.[[Error]]をthrowする。
- resultLengthをresult.[[Bytes]]内のelementsの数とする。
- taを ?
AllocateTypedArray ("Uint8Array" ,%Uint8Array% ,"%Uint8Array.prototype%" , resultLength) とする。 Assert : ta.[[ViewedArrayBuffer]].[[ArrayBufferByteLength]]はresult.[[Bytes]]内のelementsの数である。- ta.[[ViewedArrayBuffer]].[[ArrayBufferData]]の各indexのvalueを、result.[[Bytes]]のcorresponding indexのvalueに設定する。
- taを返す。
23.3.2 Uint8Array Prototype Objectの追加プロパティ
23.3.2.1 Uint8Array.prototype.setFromBase64 ( string [ , options ] )
- intoを
this valueとする。 - ?
ValidateUint8Array (into)を実行する。 - stringがStringでないなら、
TypeError 例外をthrowする。 - optsを ?
GetOptionsObject (options) とする。 - alphabetを ?
Get (opts,"alphabet" ) とする。 - alphabetが
undefined なら、alphabetを"base64" に設定する。 - alphabetが
"base64" でも"base64url" でもないなら、TypeError 例外をthrowする。 - lastChunkHandlingを ?
Get (opts,"lastChunkHandling" ) とする。 - lastChunkHandlingが
undefined なら、lastChunkHandlingを"loose" に設定する。 - lastChunkHandlingが
"loose" 、"strict" 、または"stop-before-partial" のいずれでもないなら、TypeError 例外をthrowする。 - taRecordを
MakeTypedArrayWithBufferWitnessRecord (into,seq-cst )とする。 IsTypedArrayOutOfBounds (taRecord)がtrue なら、TypeError 例外をthrowする。- byteLengthを
TypedArrayLength (taRecord)とする。 - resultを
FromBase64 (string, alphabet, lastChunkHandling, byteLength)とする。 - bytesをresult.[[Bytes]]とする。
- writtenをbytes内のelementsの数とする。
NOTE :FromBase64 はuser codeをinvokeしないため、intoをbackingするArrayBufferはdetachedまたはshrunkされていることはない。Assert : written ≤ byteLength。SetUint8ArrayBytes (into, bytes)を実行する。- result.[[Error]]が
none でないなら、- result.[[Error]]をthrowする。
- resultObjを
OrdinaryObjectCreate (%Object.prototype% )とする。 - !
CreateDataPropertyOrThrow (resultObj,"read" ,𝔽 (result.[[Read]]))を実行する。 - !
CreateDataPropertyOrThrow (resultObj,"written" ,𝔽 (written))を実行する。 - resultObjを返す。
23.3.2.2 Uint8Array.prototype.setFromHex ( string )
- intoを
this valueとする。 - ?
ValidateUint8Array (into)を実行する。 - stringがStringでないなら、
TypeError 例外をthrowする。 - taRecordを
MakeTypedArrayWithBufferWitnessRecord (into,seq-cst )とする。 IsTypedArrayOutOfBounds (taRecord)がtrue なら、TypeError 例外をthrowする。- byteLengthを
TypedArrayLength (taRecord)とする。 - resultを
FromHex (string, byteLength)とする。 - bytesをresult.[[Bytes]]とする。
- writtenをbytes内のelementsの数とする。
NOTE :FromHex はuser codeをinvokeしないため、intoをbackingするArrayBufferはdetachedまたはshrunkされていることはない。Assert : written ≤ byteLength。SetUint8ArrayBytes (into, bytes)を実行する。- result.[[Error]]が
none でないなら、- result.[[Error]]をthrowする。
- resultObjを
OrdinaryObjectCreate (%Object.prototype% )とする。 - !
CreateDataPropertyOrThrow (resultObj,"read" ,𝔽 (result.[[Read]]))を実行する。 - !
CreateDataPropertyOrThrow (resultObj,"written" ,𝔽 (written))を実行する。 - resultObjを返す。
23.3.2.3 Uint8Array.prototype.toBase64 ( [ options ] )
- objを
this valueとする。 - ?
ValidateUint8Array (obj)を実行する。 - optsを ?
GetOptionsObject (options) とする。 - alphabetを ?
Get (opts,"alphabet" ) とする。 - alphabetが
undefined なら、alphabetを"base64" に設定する。 - alphabetが
"base64" でも"base64url" でもないなら、TypeError 例外をthrowする。 - omitPaddingを
ToBoolean (?Get (opts,"omitPadding" ))とする。 - toEncodeを ?
GetUint8ArrayBytes (obj) とする。 - alphabetが
"base64" なら、- outAsciiを、toEncodeをRFC 4648のsection 4でspecifiedされるbase64 encodingに従ってencodingした結果のcode pointsのsequenceとする。Paddingは、omitPaddingが
false である場合に限りincludedされる。
- outAsciiを、toEncodeをRFC 4648のsection 4でspecifiedされるbase64 encodingに従ってencodingした結果のcode pointsのsequenceとする。Paddingは、omitPaddingが
- そうでなければ、
CodePointsToString (outAscii)を返す。
23.3.2.4 Uint8Array.prototype.toHex ( )
- objを
this valueとする。 - ?
ValidateUint8Array (obj)を実行する。 - toEncodeを ?
GetUint8ArrayBytes (obj) とする。 - outをempty Stringとする。
- toEncodeの各byte byteについて、以下を行う
- hexを
Number::toString (𝔽 (byte), 16)とする。 - hexを
StringPad (hex, 2,"0" ,start )に設定する。 - outをoutとhexの
string-concatenation に設定する。
- hexを
- outを返す。
23.3.3 Uint8Arrayオブジェクトの抽象操作
23.3.3.1 ValidateUint8Array ( ta )
The abstract operation ValidateUint8Array takes argument ta (an ECMAScript language value) and returns either a
- ?
RequireInternalSlot (ta, [[TypedArrayName]])を実行する。 - ta.[[TypedArrayName]]が
"Uint8Array" でないなら、TypeError 例外をthrowする。 unused を返す。
23.3.3.2 GetUint8ArrayBytes ( ta )
The abstract operation GetUint8ArrayBytes takes argument ta (a Uint8Array) and returns either a
- bufferをta.[[ViewedArrayBuffer]]とする。
- taRecordを
MakeTypedArrayWithBufferWitnessRecord (ta,seq-cst )とする。 IsTypedArrayOutOfBounds (taRecord)がtrue なら、TypeError 例外をthrowする。- lengthを
TypedArrayLength (taRecord)とする。 - byteOffsetをta.[[ByteOffset]]とする。
- bytesを新しい空の
List とする。 - indexを0とする。
- index < lengthの間、繰り返す
- byteIndexをbyteOffset + indexとする。
- byteを
ℝ (GetValueFromBuffer (buffer, byteIndex,uint8 ,true ,unordered ))とする。 - byteをbytesへappendする。
- indexをindex + 1に設定する。
- bytesを返す。
23.3.3.3 SetUint8ArrayBytes ( into, bytes )
The abstract operation SetUint8ArrayBytes takes arguments into (a Uint8Array) and bytes (a
- offsetをinto.[[ByteOffset]]とする。
- lengthをbytes内のelementsの数とする。
- indexを0とする。
- index < lengthの間、繰り返す
- byteをbytes[index]とする。
- byteIndexInBufferをindex + offsetとする。
SetValueInBuffer (into.[[ViewedArrayBuffer]], byteIndexInBuffer,uint8 ,𝔽 (byte),true ,unordered )を実行する。- indexをindex + 1に設定する。
unused を返す。
23.3.3.4 SkipAsciiWhitespace ( string, index )
The abstract operation SkipAsciiWhitespace takes arguments string (a String) and index (a non-negative
- lengthをstringのlengthとする。
- index < lengthの間、繰り返す
- charをstring内のindex indexにあるcode unitとする。
- charが0x0009 (TAB)、0x000A (LF)、0x000C (FF)、0x000D (CR)、または0x0020 (SPACE)のいずれでもないなら、
- indexを返す。
- indexをindex + 1に設定する。
- indexを返す。
23.3.3.5 DecodeFinalBase64Chunk ( chunk, throwOnExtraBits )
The abstract operation DecodeFinalBase64Chunk takes arguments chunk (a String of length 2 or 3) and throwOnExtraBits (a Boolean) and returns either a
- chunkLengthをchunkのlengthとする。
- chunkLength = 2なら、
- chunkをchunkと
"AA" のstring-concatenation に設定する。
- chunkをchunkと
- そうでなければ、
Assert : chunkLengthは3である。- chunkをchunkと
"A" のstring-concatenation に設定する。
- bytesを
DecodeFullLengthBase64Chunk (chunk)とする。 - chunkLength = 2なら、
- throwOnExtraBitsが
true であり、かつbytes[1] ≠ 0なら、SyntaxError 例外をthrowする。 - « bytes[0] »を返す。
- throwOnExtraBitsが
- throwOnExtraBitsが
true であり、かつbytes[2] ≠ 0なら、SyntaxError 例外をthrowする。 - « bytes[0], bytes[1] »を返す。
23.3.3.6 DecodeFullLengthBase64Chunk ( chunk )
The abstract operation DecodeFullLengthBase64Chunk takes argument chunk (a String of length 4) and returns a
standard base64 alphabetは
23.3.3.7 FromBase64 ( string, alphabet, lastChunkHandling [ , maxLength ] )
The abstract operation FromBase64 takes arguments string (a String), alphabet (
- maxLengthがpresentでないなら、
NOTE : 下のalgorithmにおけるvalidationおよびdecodingのorderはobservableではない。Implementationsは、最もefficientなorderでそれらをperformすることがencouragedされ、possibly validationとdecodingをinterleavingしてもよい。- maxLength = 0なら、
Record { [[Read]]: 0, [[Bytes]]: « », [[Error]]:none }を返す。
- readを0とする。
- bytesを新しい空の
List とする。 - chunkをempty Stringとする。
- chunkLengthを0とする。
- indexを0とする。
- lengthをstringのlengthとする。
- 繰り返す、
Assert : bytes内のelementsの数は3でevenly divisibleである。- indexを
SkipAsciiWhitespace (string, index)に設定する。 - index = lengthなら、
- chunkLength > 0なら、
- lastChunkHandlingが
"stop-before-partial" なら、Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]:none }を返す。
- lastChunkHandlingが
"strict" なら、- errorをnewly created
SyntaxError objectとする。 Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }を返す。
- errorをnewly created
Assert : lastChunkHandlingは"loose" である。- chunkLength = 1なら、
- errorをnewly created
SyntaxError objectとする。 Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }を返す。
- errorをnewly created
- bytesを、bytesと !
DecodeFinalBase64Chunk (chunk,false ) のlist-concatenation に設定する。
- lastChunkHandlingが
Record { [[Read]]: length, [[Bytes]]: bytes, [[Error]]:none }を返す。
- chunkLength > 0なら、
- charをstringのindexからindex + 1までの
substring とする。 - indexをindex + 1に設定する。
- charが
"=" なら、- chunkLength < 2なら、
- errorをnewly created
SyntaxError objectとする。 Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }を返す。
- errorをnewly created
- indexを
SkipAsciiWhitespace (string, index)に設定する。 - chunkLength = 2なら、
- index = lengthなら、
- charをstringのindexからindex + 1までの
substring に設定する。 - charが
"=" なら、- indexを
SkipAsciiWhitespace (string, index + 1)に設定する。
- indexを
- index < lengthなら、
- errorをnewly created
SyntaxError objectとする。 Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }を返す。
- errorをnewly created
- lastChunkHandlingが
"strict" なら、throwOnExtraBitsをtrue とする；そうでなければ、throwOnExtraBitsをfalse とする。 - decodeResultを
Completion (DecodeFinalBase64Chunk (chunk, throwOnExtraBits))とする。 - decodeResultが
abrupt completion なら、- errorをdecodeResult.[[Value]]とする。
Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }を返す。
- bytesを、bytesと ! decodeResult の
list-concatenation に設定する。 Record { [[Read]]: length, [[Bytes]]: bytes, [[Error]]:none }を返す。
- chunkLength < 2なら、
- alphabetが
"base64url" なら、- charが
"+" または"/" のいずれかなら、- errorをnewly created
SyntaxError objectとする。 Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }を返す。
- errorをnewly created
- そうでなく、charが
"-" なら、- charを
"+" に設定する。
- charを
- そうでなく、charが
"_" なら、- charを
"/" に設定する。
- charを
- charが
- charのsole code unitが
standard base64 alphabet のelementでないなら、- errorをnewly created
SyntaxError objectとする。 Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }を返す。
- errorをnewly created
- remainingをmaxLength - bytes内のelementsの数とする。
- remaining = 1かつchunkLength = 2の場合、またはremaining = 2かつchunkLength = 3の場合、
Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]:none }を返す。
- chunkをchunkとcharの
string-concatenation に設定する。 - chunkLengthをchunkのlengthに設定する。
- chunkLength = 4なら、
- bytesを、bytesと
DecodeFullLengthBase64Chunk (chunk)のlist-concatenation に設定する。 - chunkをempty Stringに設定する。
- chunkLengthを0に設定する。
- readをindexに設定する。
- bytes内のelementsの数 = maxLengthなら、
Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]:none }を返す。
- bytesを、bytesと
23.3.3.8 FromHex ( string [ , maxLength ] )
The abstract operation FromHex takes argument string (a String) and optional argument maxLength (a non-negative
- maxLengthがpresentでないなら、maxLengthを253 - 1に設定する。
- lengthをstringのlengthとする。
- bytesを新しい空の
List とする。 - readを0とする。
- length
modulo 2 ≠ 0なら、- errorをnewly created
SyntaxError objectとする。 Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }を返す。
- errorをnewly created
- read < lengthであり、かつbytes内のelementsの数 < maxLengthである間、繰り返す
- hexitsをstringのreadからread + 2までの
substring とする。 - hexitsが
"0123456789abcdefABCDEF" 内にないcode unitsを含むなら、- errorをnewly created
SyntaxError objectとする。 Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error }を返す。
- errorをnewly created
- readをread + 2に設定する。
- byteを、values 10 through 15のdigitsとしてletters
A throughF およびa throughf を使用するbase-16 notationでhexitsによりrepresentedされるinteger valueとする。 - byteをbytesへappendする。
- hexitsをstringのreadからread + 2までの
Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]:none }を返す。
24 Keyed Collections
24.1 Mapオブジェクト
Mapはkey/value pairのcollectionであり、keysとvaluesはいずれも任意のECMAScript language valueであってよい。distinctなkey valueは、Mapのcollection内の1つのkey/value pairにだけ出現してよい。distinctなkey valuesは
Mapは、平均的にcollection内のelements数に対してsublinearなaccess timeを提供するhash tableまたはその他のmechanismsを用いて実装されなければならない。この仕様で用いられるdata structureは、Mapのrequired observable semanticsをdescribeすることだけを意図している。viable implementation modelであることは意図されていない。
24.1.1 Map Constructor
Map
- %Map%である。
global object の"Map" propertyのinitial valueである。constructor として呼び出されたとき、新しいMapをcreateしてinitializeする。- functionとして呼び出されることは意図されておらず、そのように呼び出された場合はexceptionをthrowする。
- クラス定義の
extends句内の値として使用できる。指定された Map の動作を継承しようとするサブクラスコンストラクターは、Map.prototypeの組み込みメソッドをサポートするために必要な内部状態でサブクラスインスタンスを作成し初期化するため、Map コンストラクターへのsuper呼び出しを含めなければならない。
24.1.1.1 Map ( [ iterable ] )
このfunctionは、呼び出されたときに次のstepsを実行する：
- NewTargetが
undefined なら、TypeError 例外をthrowする。 - mapを ?
OrdinaryCreateFromConstructor (NewTarget,"%Map.prototype%" , « [[MapData]] ») とする。 - map.[[MapData]]を新しい空の
List に設定する。 - iterableが
undefined またはnull のどちらかなら、mapを返す。 - adderを ?
Get (map,"set" ) とする。 IsCallable (adder)がfalse なら、TypeError 例外をthrowする。- ?
AddEntriesFromIterable (map, iterable, adder)を返す。
parameter iterableがpresentである場合、それは
24.1.1.2 AddEntriesFromIterable ( target, iterable, adder )
The abstract operation AddEntriesFromIterable takes arguments target (an Object), iterable (an ECMAScript language value, but not
- iteratorRecordを ?
GetIterator (iterable,sync ) とする。 - 繰り返す、
- nextを ?
IteratorStepValue (iteratorRecord) とする。 - nextが
done なら、targetを返す。 - nextがObjectでないなら、
- errorを
ThrowCompletion (newly createdTypeError object)とする。 - ?
IteratorClose (iteratorRecord, error)を返す。
- errorを
- keyを
Completion (Get (next,"0" ))とする。 IfAbruptCloseIterator (key, iteratorRecord)。- valueを
Completion (Get (next,"1" ))とする。 IfAbruptCloseIterator (value, iteratorRecord)。- statusを
Completion (Call (adder, target, « key, value »))とする。 IfAbruptCloseIterator (status, iteratorRecord)。
- nextを ?
parameter iterableは、
24.1.2 Map Constructorのプロパティ
Map
- valueが
%Function.prototype% である[[Prototype]] internal slotを持つ。 - 次のpropertiesを持つ：
24.1.2.1 Map.groupBy ( items, callback )
callbackはtwo argumentsをacceptするfunctionであるべきである。groupByはitems内の各elementについてascending orderでcallbackを1回callし、新しいMapをconstructする。callbackによりreturnedされた各valueはMap内のkeyとして使用される。そのような各keyについて、result Mapはkeyがそのkeyであり、valueがcallbackがそのkeyを返したすべてのelementsを含むarrayであるentryを持つ。
callbackはtwo arguments、すなわちelementのvalueとelementのindexでcallされる。
groupByのreturn valueはMapである。
このfunctionは、呼び出されたときに次のstepsを実行する：
24.1.2.2 Map.prototype
Map.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
24.1.2.3 get Map [ %Symbol.species% ]
Map[%Symbol.species%]は、set accessor functionが
this valueを返す。
このfunctionの
derived collection objectsをcreateするmethodsは、derived objectsをcreateするために使用する
24.1.3 Map Prototype Objectのプロパティ
Map prototype objectは：
- %Map.prototype%である。
- valueが
%Object.prototype% である[[Prototype]] internal slotを持つ。 ordinary object である。- [[MapData]] internal slotを持たない。
24.1.3.1 Map.prototype.clear ( )
このmethodは、呼び出されたときに次のstepsを実行する：
- mapを
this valueとする。 - ?
RequireInternalSlot (map, [[MapData]])を実行する。 - map.[[MapData]]の各
Record { [[Key]], [[Value]] } entryについて、以下を行う- entry.[[Key]]を
empty に設定する。 - entry.[[Value]]を
empty に設定する。
- entry.[[Key]]を
undefined を返す。
その
24.1.3.2 Map.prototype.constructor
Map.prototype.constructorのinitial valueは
24.1.3.3 Map.prototype.delete ( key )
このmethodは、呼び出されたときに次のstepsを実行する：
- mapを
this valueとする。 - ?
RequireInternalSlot (map, [[MapData]])を実行する。 - keyを
CanonicalizeKeyedCollectionKey (key)に設定する。 - map.[[MapData]]の各
Record { [[Key]], [[Value]] } entryについて、以下を行う- entry.[[Key]]が
empty でなく、SameValue (entry.[[Key]], key)がtrue なら、- entry.[[Key]]を
empty に設定する。 - entry.[[Value]]を
empty に設定する。 true を返す。
- entry.[[Key]]を
- entry.[[Key]]が
false を返す。
value
24.1.3.4 Map.prototype.entries ( )
このmethodは、呼び出されたときに次のstepsを実行する：
- mapを
this valueとする。 - ?
CreateMapIterator (map,key+value )を返す。
24.1.3.5 Map.prototype.forEach ( callback [ , thisArg ] )
このmethodは、呼び出されたときに次のstepsを実行する：
- mapを
this valueとする。 - ?
RequireInternalSlot (map, [[MapData]])を実行する。 IsCallable (callback)がfalse なら、TypeError 例外をthrowする。- entriesをmap.[[MapData]]とする。
- entriesCountをentries内のelementsの数とする。
- indexを0とする。
- index < entriesCountの間、繰り返す
undefined を返す。
callbackはthree argumentsをacceptするfunctionであるべきである。forEachはMap内にpresentな各key/value pairについて、key insertion orderでcallbackを1回callする。callbackは、実際に存在するMapのkeysについてのみcallされ、Mapからdeletedされたkeysについてはcallされない。
thisArg parameterがprovidedされた場合、それはcallbackの各invocationにおける
callbackはthree arguments、すなわちitemのvalue、itemのkey、およびtraversedされるMapでcallされる。
forEachは、それが呼び出されたobjectをdirectly mutateしないが、そのobjectはcallbackのcallsによってmutatedされるかもしれない。mapの[[MapData]]の各entryは1回だけvisitedされる。forEachへのcallがbeginsした後にaddedされたnew keysはvisitedされる。keyがvisitedされた後にdeletedされ、その後forEach callがcompletesする前にre-addedされた場合、そのkeyはrevisitedされる。forEachへのcallがbeginsした後、visitedされる前にdeletedされたkeysは、forEach callがcompletesする前にkeyが再びaddedされない限り、visitedされない。
24.1.3.6 Map.prototype.get ( key )
このmethodは、呼び出されたときに次のstepsを実行する：
- mapを
this valueとする。 - ?
RequireInternalSlot (map, [[MapData]])を実行する。 - keyを
CanonicalizeKeyedCollectionKey (key)に設定する。 - map.[[MapData]]の各
Record { [[Key]], [[Value]] } entryについて、以下を行う- entry.[[Key]]が
empty でなく、SameValue (entry.[[Key]], key)がtrue なら、entry.[[Value]]を返す。
- entry.[[Key]]が
undefined を返す。
24.1.3.7 Map.prototype.getOrInsert ( key, value )
このmethodは、呼び出されたときに次のstepsを実行する：
- mapを
this valueとする。 - ?
RequireInternalSlot (map, [[MapData]])を実行する。 - keyを
CanonicalizeKeyedCollectionKey (key)に設定する。 - map.[[MapData]]の各
Record { [[Key]], [[Value]] } entryについて、以下を行う- entry.[[Key]]が
empty でなく、SameValue (entry.[[Key]], key)がtrue なら、entry.[[Value]]を返す。
- entry.[[Key]]が
- entryを
Record { [[Key]]: key, [[Value]]: value }とする。 - entryをmap.[[MapData]]へappendする。
- valueを返す。
24.1.3.8 Map.prototype.getOrInsertComputed ( key, callback )
このmethodは、呼び出されたときに次のstepsを実行する：
- mapを
this valueとする。 - ?
RequireInternalSlot (map, [[MapData]])を実行する。 IsCallable (callback)がfalse なら、TypeError 例外をthrowする。- keyを
CanonicalizeKeyedCollectionKey (key)に設定する。 - map.[[MapData]]の各
Record { [[Key]], [[Value]] } entryについて、以下を行う- entry.[[Key]]が
empty でなく、SameValue (entry.[[Key]], key)がtrue なら、entry.[[Value]]を返す。
- entry.[[Key]]が
- valueを ?
Call (callback,undefined , « key ») とする。 NOTE : Mapはcallbackのexecution中にmodifiedされているかもしれない。- map.[[MapData]]の各
Record { [[Key]], [[Value]] } entryについて、以下を行う- entry.[[Key]]が
empty でなく、SameValue (entry.[[Key]], key)がtrue なら、- entry.[[Value]]をvalueに設定する。
- valueを返す。
- entry.[[Key]]が
- entryを
Record { [[Key]]: key, [[Value]]: value }とする。 - entryをmap.[[MapData]]へappendする。
- valueを返す。
24.1.3.9 Map.prototype.has ( key )
このmethodは、呼び出されたときに次のstepsを実行する：
- mapを
this valueとする。 - ?
RequireInternalSlot (map, [[MapData]])を実行する。 - keyを
CanonicalizeKeyedCollectionKey (key)に設定する。 - map.[[MapData]]の各
Record { [[Key]], [[Value]] } entryについて、以下を行う- entry.[[Key]]が
empty でなく、SameValue (entry.[[Key]], key)がtrue なら、true を返す。
- entry.[[Key]]が
false を返す。
24.1.3.10 Map.prototype.keys ( )
このmethodは、呼び出されたときに次のstepsを実行する：
- mapを
this valueとする。 - ?
CreateMapIterator (map,key )を返す。
24.1.3.11 Map.prototype.set ( key, value )
このmethodは、呼び出されたときに次のstepsを実行する：
- mapを
this valueとする。 - ?
RequireInternalSlot (map, [[MapData]])を実行する。 - keyを
CanonicalizeKeyedCollectionKey (key)に設定する。 - map.[[MapData]]の各
Record { [[Key]], [[Value]] } entryについて、以下を行う- entry.[[Key]]が
empty でなく、SameValue (entry.[[Key]], key)がtrue なら、- entry.[[Value]]をvalueに設定する。
- mapを返す。
- entry.[[Key]]が
- entryを
Record { [[Key]]: key, [[Value]]: value }とする。 - entryをmap.[[MapData]]へappendする。
- mapを返す。
24.1.3.12 get Map.prototype.size
Map.prototype.sizeは、set accessor functionが
- mapを
this valueとする。 - ?
RequireInternalSlot (map, [[MapData]])を実行する。 - countを0とする。
- map.[[MapData]]の各
Record { [[Key]], [[Value]] } entryについて、以下を行う- entry.[[Key]]が
empty でないなら、countをcount + 1に設定する。
- entry.[[Key]]が
𝔽 (count)を返す。
24.1.3.13 Map.prototype.values ( )
このmethodは、呼び出されたときに次のstepsを実行する：
- mapを
this valueとする。 - ?
CreateMapIterator (map,value )を返す。
24.1.3.14 Map.prototype [ %Symbol.iterator% ] ( )
24.1.3.15 Map.prototype [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
24.1.4 Map Instancesのプロパティ
Map instancesは
24.1.5 Map Iteratorオブジェクト
Map Iteratorは、あるspecific Map instance objectに対するspecific iterationをrepresentするobjectである。Map Iterator objectsにはnamed
24.1.5.1 CreateMapIterator ( map, kind )
The abstract operation CreateMapIterator takes arguments map (an ECMAScript language value) and kind (
- ?
RequireInternalSlot (map, [[MapData]])を実行する。 - closureを、parametersを持たず、mapおよびkindをcapturesし、呼び出されたときに次のstepsを実行する新しい
Abstract Closure とする：- entriesをmap.[[MapData]]とする。
- indexを0とする。
- entriesCountをentries内のelementsの数とする。
- index < entriesCountの間、繰り返す
- entryをentries[index]とする。
- indexをindex + 1に設定する。
- entry.[[Key]]が
empty でないなら、- kindが
key なら、- resultをentry.[[Key]]とする。
- そうでなく、kindが
value なら、- resultをentry.[[Value]]とする。
- そうでなければ、
Assert : kindはkey+value である。- resultを
CreateArrayFromList (« entry.[[Key]], entry.[[Value]] »)とする。
- ?
GeneratorYield (CreateIteratorResultObject (result,false ))を実行する。 NOTE : このabstract operationのexecutionがGeneratorYield によりpausedされている間に、entries内のelementsの数が増加しているかもしれない。- entriesCountをentries内のelementsの数に設定する。
- kindが
NormalCompletion (unused )を返す。
CreateIteratorFromClosure (closure,"%MapIteratorPrototype%" ,%MapIteratorPrototype% )を返す。
24.1.5.2 %MapIteratorPrototype% Object
%MapIteratorPrototype% objectは：
- すべての
Map Iterator objects によりinheritedされるpropertiesを持つ。 ordinary object である。- valueが
%Iterator.prototype% である[[Prototype]] internal slotを持つ。 - 次のpropertiesを持つ：
24.1.5.2.1 %MapIteratorPrototype%.next ( )
- ?
GeneratorResume (this value,empty ,"%MapIteratorPrototype%" )を返す。
24.1.5.2.2 %MapIteratorPrototype% [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
24.2 Setオブジェクト
Set objectsは
Set objectsは、平均的にcollection内のelements数に対してsublinearなaccess timeを提供するhash tableまたはその他のmechanismsを用いて実装されなければならない。この仕様で用いられるdata structureは、Set objectsのrequired observable semanticsをdescribeすることだけを意図している。viable implementation modelであることは意図されていない。
24.2.1 Setオブジェクトの抽象操作
24.2.1.1 Set Records
Set Recordは、Setまたはsimilar objectのinterfaceをencapsulateするために使用される
Set Recordsは
| Field Name | Value | Meaning |
|---|---|---|
| [[SetObject]] | Object | Setまたはsimilar object。 |
| [[Size]] |
non-negative |
objectのreported size。 |
| [[Has]] |
|
objectのhas method。
|
| [[Keys]] |
|
objectのkeys method。
|
24.2.1.2 GetSetRecord ( obj )
The abstract operation GetSetRecord takes argument obj (an ECMAScript language value) and returns either a
- objがObjectでないなら、
TypeError 例外をthrowする。 - rawSizeを ?
Get (obj,"size" ) とする。 - numberSizeを ?
ToNumber (rawSize) とする。 NOTE : rawSizeがundefined なら、numberSizeはNaN になる。- numberSizeが
NaN なら、TypeError 例外をthrowする。 - intSizeを !
ToIntegerOrInfinity (numberSize) とする。 - intSize < 0なら、
RangeError 例外をthrowする。 - hasを ?
Get (obj,"has" ) とする。 IsCallable (has)がfalse なら、TypeError 例外をthrowする。- keysを ?
Get (obj,"keys" ) とする。 IsCallable (keys)がfalse なら、TypeError 例外をthrowする。- 新しい
Set Record { [[SetObject]]: obj, [[Size]]: intSize, [[Has]]: has, [[Keys]]: keys }を返す。
24.2.1.3 SetDataHas ( setData, value )
The abstract operation SetDataHas takes arguments setData (a
SetDataIndex (setData, value)がnot-found なら、false を返す。true を返す。
24.2.1.4 SetDataIndex ( setData, value )
The abstract operation SetDataIndex takes arguments setData (a
- valueを
CanonicalizeKeyedCollectionKey (value)に設定する。 - sizeをsetData内のelementsの数とする。
- indexを0とする。
- index < sizeの間、繰り返す
- elementをsetData[index]とする。
- elementが
empty でなく、elementがvalueであるなら、- indexを返す。
- indexをindex + 1に設定する。
not-found を返す。
24.2.1.5 SetDataSize ( setData )
The abstract operation SetDataSize takes argument setData (a
- countを0とする。
- setDataの各element elementについて、以下を行う
- elementが
empty でないなら、countをcount + 1に設定する。
- elementが
- countを返す。
24.2.2 Set Constructor
Set
- %Set%である。
global object の"Set" propertyのinitial valueである。constructor として呼び出されたとき、新しいSet object をcreateしてinitializeする。- functionとして呼び出されることは意図されておらず、そのように呼び出された場合はexceptionをthrowする。
- クラス定義の
extends句内の値として使用できる。指定された Set の動作を継承しようとするサブクラスコンストラクターは、Set.prototypeの組み込みメソッドをサポートするために必要な内部状態でサブクラスインスタンスを作成し初期化するため、Set コンストラクターへのsuper呼び出しを含めなければならない。
24.2.2.1 Set ( [ iterable ] )
このfunctionは、呼び出されたときに次のstepsを実行する：
- NewTargetが
undefined なら、TypeError 例外をthrowする。 - setを ?
OrdinaryCreateFromConstructor (NewTarget,"%Set.prototype%" , « [[SetData]] ») とする。 - set.[[SetData]]を新しい空の
List に設定する。 - iterableが
undefined またはnull のどちらかなら、setを返す。 - adderを ?
Get (set,"add" ) とする。 IsCallable (adder)がfalse なら、TypeError 例外をthrowする。- iteratorRecordを ?
GetIterator (iterable,sync ) とする。 - 繰り返す、
- nextを ?
IteratorStepValue (iteratorRecord) とする。 - nextが
done なら、setを返す。 - statusを
Completion (Call (adder, set, « next »))とする。 IfAbruptCloseIterator (status, iteratorRecord)。
- nextを ?
24.2.3 Set Constructorのプロパティ
Set
- valueが
%Function.prototype% である[[Prototype]] internal slotを持つ。 - 次のpropertiesを持つ：
24.2.3.1 Set.prototype
Set.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
24.2.3.2 get Set [ %Symbol.species% ]
Set[%Symbol.species%]は、set accessor functionが
this valueを返す。
このfunctionの
derived collection objectsをcreateするmethodsは、derived objectsをcreateするために使用する
24.2.4 Set Prototype Objectのプロパティ
Set prototype objectは：
- %Set.prototype%である。
- valueが
%Object.prototype% である[[Prototype]] internal slotを持つ。 ordinary object である。- [[SetData]] internal slotを持たない。
24.2.4.1 Set.prototype.add ( value )
このmethodは、呼び出されたときに次のstepsを実行する：
- setを
this valueとする。 - ?
RequireInternalSlot (set, [[SetData]])を実行する。 - valueを
CanonicalizeKeyedCollectionKey (value)に設定する。 - set.[[SetData]]の各element entryについて、以下を行う
- entryが
empty でなく、SameValue (entry, value)がtrue なら、- setを返す。
- entryが
- valueをset.[[SetData]]へappendする。
- setを返す。
24.2.4.2 Set.prototype.clear ( )
このmethodは、呼び出されたときに次のstepsを実行する：
- setを
this valueとする。 - ?
RequireInternalSlot (set, [[SetData]])を実行する。 - set.[[SetData]]の各element entryについて、以下を行う
- valueがentryであるset.[[SetData]]のelementを、valueが
empty であるelementでreplaceする。
- valueがentryであるset.[[SetData]]のelementを、valueが
undefined を返す。
その
24.2.4.3 Set.prototype.constructor
Set.prototype.constructorのinitial valueは
24.2.4.4 Set.prototype.delete ( value )
このmethodは、呼び出されたときに次のstepsを実行する：
- setを
this valueとする。 - ?
RequireInternalSlot (set, [[SetData]])を実行する。 - valueを
CanonicalizeKeyedCollectionKey (value)に設定する。 - set.[[SetData]]の各element entryについて、以下を行う
- entryが
empty でなく、SameValue (entry, value)がtrue なら、- valueがentryであるset.[[SetData]]のelementを、valueが
empty であるelementでreplaceする。 true を返す。
- valueがentryであるset.[[SetData]]のelementを、valueが
- entryが
false を返す。
value
24.2.4.5 Set.prototype.difference ( other )
このmethodは、呼び出されたときに次のstepsを実行する：
- setを
this valueとする。 - ?
RequireInternalSlot (set, [[SetData]])を実行する。 - otherRecordを ?
GetSetRecord (other) とする。 - resultSetDataをset.[[SetData]]のcopyとする。
SetDataSize (set.[[SetData]]) ≤ otherRecord.[[Size]]なら、- そうでなければ、
- keysIteratorを ?
GetIteratorFromMethod (otherRecord.[[SetObject]], otherRecord.[[Keys]]) とする。 - nextを
not-started とする。 - nextが
done でない間、繰り返す- nextを ?
IteratorStepValue (keysIterator) に設定する。 - nextが
done でないなら、- nextを
CanonicalizeKeyedCollectionKey (next)に設定する。 - valueIndexを
SetDataIndex (resultSetData, next)とする。 - valueIndexが
not-found でないなら、- resultSetData[valueIndex]を
empty に設定する。
- resultSetData[valueIndex]を
- nextを
- nextを ?
- keysIteratorを ?
- resultを
OrdinaryObjectCreate (%Set.prototype% , « [[SetData]] »)とする。 - result.[[SetData]]をresultSetDataに設定する。
- resultを返す。
24.2.4.6 Set.prototype.entries ( )
このmethodは、呼び出されたときに次のstepsを実行する：
- setを
this valueとする。 - ?
CreateSetIterator (set,key+value )を返す。
iteration purposesにおいて、Setは各entryがkeyとvalueに同じvalueを持つMapにsimilarに見える。
24.2.4.7 Set.prototype.forEach ( callback [ , thisArg ] )
このmethodは、呼び出されたときに次のstepsを実行する：
- setを
this valueとする。 - ?
RequireInternalSlot (set, [[SetData]])を実行する。 IsCallable (callback)がfalse なら、TypeError 例外をthrowする。- entriesをset.[[SetData]]とする。
- entriesCountをentries内のelementsの数とする。
- indexを0とする。
- index < entriesCountの間、繰り返す
undefined を返す。
callbackはthree argumentsをacceptするfunctionであるべきである。forEachは
thisArg parameterがprovidedされた場合、それはcallbackの各invocationにおける
callbackはthree argumentsでcallされる：first two argumentsはSet内にcontainedされるvalueである。両方のargumentsには同じvalueがpassedされる。traversedされる
MapおよびArrayのforEach methodsで使用されるcall back functionsとconsistentにするため、callbackはthree argumentsでcallされる。Setでは、各item valueはkeyとvalueの両方であるとconsideredされる。
forEachは、それが呼び出されたobjectをdirectly mutateしないが、そのobjectはcallbackのcallsによってmutatedされるかもしれない。
各valueは通常1回だけvisitedされる。しかし、valueがvisitedされた後にdeletedされ、その後forEach callがcompletesする前にre-addedされた場合、そのvalueはrevisitedされる。forEachへのcallがbeginsした後、visitedされる前にdeletedされたvaluesは、forEach callがcompletesする前にvalueが再びaddedされない限り、visitedされない。forEachへのcallがbeginsした後にaddedされたnew valuesはvisitedされる。
24.2.4.8 Set.prototype.has ( value )
このmethodは、呼び出されたときに次のstepsを実行する：
- setを
this valueとする。 - ?
RequireInternalSlot (set, [[SetData]])を実行する。 - valueを
CanonicalizeKeyedCollectionKey (value)に設定する。 - set.[[SetData]]の各element entryについて、以下を行う
- entryが
empty でなく、SameValue (entry, value)がtrue なら、true を返す。
- entryが
false を返す。
24.2.4.9 Set.prototype.intersection ( other )
このmethodは、呼び出されたときに次のstepsを実行する：
- setを
this valueとする。 - ?
RequireInternalSlot (set, [[SetData]])を実行する。 - otherRecordを ?
GetSetRecord (other) とする。 - resultSetDataを新しい空の
List とする。 SetDataSize (set.[[SetData]]) ≤ otherRecord.[[Size]]なら、- thisSizeをset.[[SetData]]内のelementsの数とする。
- indexを0とする。
- index < thisSizeの間、繰り返す
- entryをset.[[SetData]][index]とする。
- indexをindex + 1に設定する。
- entryが
empty でないなら、- inOtherを
ToBoolean (?Call (otherRecord.[[Has]], otherRecord.[[SetObject]], « entry »))とする。 - inOtherが
true なら、NOTE : otherRecord.[[Has]]へのearlier callsがset.[[SetData]]のelementをremoveしてre-addすることがpossibleであり、それによりこのiteration中に同じelementがtwice visitedされる可能性がある。SetDataHas (resultSetData, entry)がfalse なら、- entryをresultSetDataへappendする。
NOTE : set.[[SetData]]内のelementsの数はotherRecord.[[Has]]のexecution中に増加しているかもしれない。- thisSizeをset.[[SetData]]内のelementsの数に設定する。
- inOtherを
- そうでなければ、
- keysIteratorを ?
GetIteratorFromMethod (otherRecord.[[SetObject]], otherRecord.[[Keys]]) とする。 - nextを
not-started とする。 - nextが
done でない間、繰り返す- nextを ?
IteratorStepValue (keysIterator) に設定する。 - nextが
done でないなら、- nextを
CanonicalizeKeyedCollectionKey (next)に設定する。 - inThisを
SetDataHas (set.[[SetData]], next)とする。 - inThisが
true なら、NOTE : otherはarbitrary objectであるため、その"keys" iterator が同じvalueを複数回produceすることがpossibleである。SetDataHas (resultSetData, next)がfalse なら、- nextをresultSetDataへappendする。
- nextを
- nextを ?
- keysIteratorを ?
- resultを
OrdinaryObjectCreate (%Set.prototype% , « [[SetData]] »)とする。 - result.[[SetData]]をresultSetDataに設定する。
- resultを返す。
24.2.4.10 Set.prototype.isDisjointFrom ( other )
このmethodは、呼び出されたときに次のstepsを実行する：
- setを
this valueとする。 - ?
RequireInternalSlot (set, [[SetData]])を実行する。 - otherRecordを ?
GetSetRecord (other) とする。 SetDataSize (set.[[SetData]]) ≤ otherRecord.[[Size]]なら、- thisSizeをset.[[SetData]]内のelementsの数とする。
- indexを0とする。
- index < thisSizeの間、繰り返す
- entryをset.[[SetData]][index]とする。
- indexをindex + 1に設定する。
- entryが
empty でないなら、
- そうでなければ、
- keysIteratorを ?
GetIteratorFromMethod (otherRecord.[[SetObject]], otherRecord.[[Keys]]) とする。 - nextを
not-started とする。 - nextが
done でない間、繰り返す- nextを ?
IteratorStepValue (keysIterator) に設定する。 - nextが
done でないなら、SetDataHas (set.[[SetData]], next)がtrue なら、- ?
IteratorClose (keysIterator,NormalCompletion (unused ))を実行する。 false を返す。
- ?
- nextを ?
- keysIteratorを ?
true を返す。
24.2.4.11 Set.prototype.isSubsetOf ( other )
このmethodは、呼び出されたときに次のstepsを実行する：
- setを
this valueとする。 - ?
RequireInternalSlot (set, [[SetData]])を実行する。 - otherRecordを ?
GetSetRecord (other) とする。 SetDataSize (set.[[SetData]]) > otherRecord.[[Size]]なら、false を返す。- thisSizeをset.[[SetData]]内のelementsの数とする。
- indexを0とする。
- index < thisSizeの間、繰り返す
- entryをset.[[SetData]][index]とする。
- indexをindex + 1に設定する。
- entryが
empty でないなら、
true を返す。
24.2.4.12 Set.prototype.isSupersetOf ( other )
このmethodは、呼び出されたときに次のstepsを実行する：
- setを
this valueとする。 - ?
RequireInternalSlot (set, [[SetData]])を実行する。 - otherRecordを ?
GetSetRecord (other) とする。 SetDataSize (set.[[SetData]]) < otherRecord.[[Size]]なら、false を返す。- keysIteratorを ?
GetIteratorFromMethod (otherRecord.[[SetObject]], otherRecord.[[Keys]]) とする。 - nextを
not-started とする。 - nextが
done でない間、繰り返す- nextを ?
IteratorStepValue (keysIterator) に設定する。 - nextが
done でないなら、SetDataHas (set.[[SetData]], next)がfalse なら、- ?
IteratorClose (keysIterator,NormalCompletion (unused ))を実行する。 false を返す。
- ?
- nextを ?
true を返す。
24.2.4.13 Set.prototype.keys ( )
iteration purposesにおいて、Setは各entryがkeyとvalueに同じvalueを持つMapにsimilarに見える。
24.2.4.14 get Set.prototype.size
Set.prototype.sizeは、set accessor functionが
- setを
this valueとする。 - ?
RequireInternalSlot (set, [[SetData]])を実行する。 - sizeを
SetDataSize (set.[[SetData]])とする。 𝔽 (size)を返す。
24.2.4.15 Set.prototype.symmetricDifference ( other )
このmethodは、呼び出されたときに次のstepsを実行する：
- setを
this valueとする。 - ?
RequireInternalSlot (set, [[SetData]])を実行する。 - otherRecordを ?
GetSetRecord (other) とする。 - keysIteratorを ?
GetIteratorFromMethod (otherRecord.[[SetObject]], otherRecord.[[Keys]]) とする。 - resultSetDataをset.[[SetData]]のcopyとする。
- nextを
not-started とする。 - nextが
done でない間、繰り返す- nextを ?
IteratorStepValue (keysIterator) に設定する。 - nextが
done でないなら、- nextを
CanonicalizeKeyedCollectionKey (next)に設定する。 - resultIndexを
SetDataIndex (resultSetData, next)とする。 - resultIndexが
not-found なら、alreadyInResultをfalse とする；そうでなければ、alreadyInResultをtrue とする。 SetDataHas (set.[[SetData]], next)がtrue なら、- alreadyInResultが
true なら、resultSetData[resultIndex]をempty に設定する。
- alreadyInResultが
- そうでなければ、
- alreadyInResultが
false なら、nextをresultSetDataへappendする。
- alreadyInResultが
- nextを
- nextを ?
- resultを
OrdinaryObjectCreate (%Set.prototype% , « [[SetData]] »)とする。 - result.[[SetData]]をresultSetDataに設定する。
- resultを返す。
24.2.4.16 Set.prototype.union ( other )
このmethodは、呼び出されたときに次のstepsを実行する：
- setを
this valueとする。 - ?
RequireInternalSlot (set, [[SetData]])を実行する。 - otherRecordを ?
GetSetRecord (other) とする。 - keysIteratorを ?
GetIteratorFromMethod (otherRecord.[[SetObject]], otherRecord.[[Keys]]) とする。 - resultSetDataをset.[[SetData]]のcopyとする。
- nextを
not-started とする。 - nextが
done でない間、繰り返す- nextを ?
IteratorStepValue (keysIterator) に設定する。 - nextが
done でないなら、- nextを
CanonicalizeKeyedCollectionKey (next)に設定する。 SetDataHas (resultSetData, next)がfalse なら、- nextをresultSetDataへappendする。
- nextを
- nextを ?
- resultを
OrdinaryObjectCreate (%Set.prototype% , « [[SetData]] »)とする。 - result.[[SetData]]をresultSetDataに設定する。
- resultを返す。
24.2.4.17 Set.prototype.values ( )
このmethodは、呼び出されたときに次のstepsを実行する：
- setを
this valueとする。 - ?
CreateSetIterator (set,value )を返す。
24.2.4.18 Set.prototype [ %Symbol.iterator% ] ( )
24.2.4.19 Set.prototype [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
24.2.5 Set Instancesのプロパティ
Set instancesは
24.2.6 Set Iteratorオブジェクト
Set Iteratorは、下でdefinedされるstructureを持つ
24.2.6.1 CreateSetIterator ( set, kind )
The abstract operation CreateSetIterator takes arguments set (an ECMAScript language value) and kind (
- ?
RequireInternalSlot (set, [[SetData]])を実行する。 - closureを、parametersを持たず、setおよびkindをcapturesし、呼び出されたときに次のstepsを実行する新しい
Abstract Closure とする：- indexを0とする。
- entriesをset.[[SetData]]とする。
- entriesCountをentries内のelementsの数とする。
- index < entriesCountの間、繰り返す
- entryをentries[index]とする。
- indexをindex + 1に設定する。
- entryが
empty でないなら、- kindが
key+value なら、- resultを
CreateArrayFromList (« entry, entry »)とする。 - ?
GeneratorYield (CreateIteratorResultObject (result,false ))を実行する。
- resultを
- そうでなければ、
Assert : kindはvalue である。- ?
GeneratorYield (CreateIteratorResultObject (entry,false ))を実行する。
NOTE : このabstract operationのexecutionがGeneratorYield によりpausedされている間に、entries内のelementsの数が増加しているかもしれない。- entriesCountをentries内のelementsの数に設定する。
- kindが
NormalCompletion (unused )を返す。
CreateIteratorFromClosure (closure,"%SetIteratorPrototype%" ,%SetIteratorPrototype% )を返す。
24.2.6.2 %SetIteratorPrototype% Object
%SetIteratorPrototype% objectは：
- すべての
Set Iterator objects によりinheritedされるpropertiesを持つ。 ordinary object である。- valueが
%Iterator.prototype% である[[Prototype]] internal slotを持つ。 - 次のpropertiesを持つ：
24.2.6.2.1 %SetIteratorPrototype%.next ( )
- ?
GeneratorResume (this value,empty ,"%SetIteratorPrototype%" )を返す。
24.2.6.2.2 %SetIteratorPrototype% [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
24.3 WeakMapオブジェクト
WeakMapはkey/value pairのcollectionsであり、keysはobjectsおよび/またはsymbolsであり、valuesは任意の
implementationは、WeakMapのkey/value pairがinaccessibleになる時点と、そのkey/value pairがWeakMapからremovedされる時点との間に、arbitrarily determined latencyをimposeしてもよい。このlatencyがECMAScript programにobservableであったなら、それはprogram executionに影響し得るindeterminacyのsourceとなる。そのため、ECMAScript implementationは、observed keyをobserverにpresentすることをrequireしないWeakMapのkeyをobserveするmeansを一切provideしてはならない。
WeakMapは、平均的にcollection内のkey/value pairs数に対してsublinearなaccess timeを提供するhash tableまたはその他のmechanismsを用いて実装されなければならない。この仕様で用いられるdata structureは、WeakMapのrequired observable semanticsをdescribeすることだけを意図している。viable implementation modelであることは意図されていない。
WeakMapおよびWeakSetは、WeakMapまたはWeakSet instanceが存在しない場合にobjectまたはsymbolがotherwise inaccessibleとなり、implementationのgarbage collection mechanismsによるresource reclamationのsubjectとなるときに、memory resourcesを“leak”しないmannerでstateをobjectまたはsymbolにdynamically associatingするためのmechanismsをprovideすることを意図している。このcharacteristicは、WeakMapまたはWeakSet instancesからkeysへのinverted per-object/symbol mappingを使用することでachievedできる。あるいは、各WeakMapまたはWeakSet instanceはそのkeyおよびvalue dataをinternally storeしてもよいが、このapproachはWeakMapまたはWeakSet implementationとgarbage collectorとのcoordinationをrequireする。以下のreferencesは、WeakMapおよびWeakSetのimplementationsにusefulであり得るmechanismをdescribeする：
Barry Hayes. 1997. Ephemerons: a new finalization mechanism. In Proceedings of the 12th ACM SIGPLAN conference on Object-oriented programming, systems, languages, and applications (OOPSLA '97), A. Michael Berman (Ed.). ACM, New York, NY, USA, 176-183, http://doi.acm.org/10.1145/263698.263733.
Alexandra Barros, Roberto Ierusalimschy, Eliminating Cycles in Weak Tables. Journal of Universal Computer Science - J.UCS, vol. 14, no. 21, pp. 3481-3497, 2008, http://www.jucs.org/jucs_14_21/eliminating_cycles_in_weak
24.3.1 WeakMap Constructor
WeakMap
- %WeakMap%である。
global object の"WeakMap" propertyのinitial valueである。constructor として呼び出されたとき、新しいWeakMapをcreateしてinitializeする。- functionとして呼び出されることは意図されておらず、そのように呼び出された場合はexceptionをthrowする。
- クラス定義の
extends句内の値として使用できる。指定された WeakMap の動作を継承しようとするサブクラスコンストラクターは、WeakMap.prototypeの組み込みメソッドをサポートするために必要な内部状態でサブクラスインスタンスを作成し初期化するため、WeakMap コンストラクターへのsuper呼び出しを含めなければならない。
24.3.1.1 WeakMap ( [ iterable ] )
このfunctionは、呼び出されたときに次のstepsを実行する：
- NewTargetが
undefined なら、TypeError 例外をthrowする。 - mapを ?
OrdinaryCreateFromConstructor (NewTarget,"%WeakMap.prototype%" , « [[WeakMapData]] ») とする。 - map.[[WeakMapData]]を新しい空の
List に設定する。 - iterableが
undefined またはnull のどちらかなら、mapを返す。 - adderを ?
Get (map,"set" ) とする。 IsCallable (adder)がfalse なら、TypeError 例外をthrowする。- ?
AddEntriesFromIterable (map, iterable, adder)を返す。
parameter iterableがpresentである場合、それは
24.3.2 WeakMap Constructorのプロパティ
WeakMap
- valueが
%Function.prototype% である[[Prototype]] internal slotを持つ。 - 次のpropertiesを持つ：
24.3.2.1 WeakMap.prototype
WeakMap.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
24.3.3 WeakMap Prototype Objectのプロパティ
WeakMap prototype objectは：
- %WeakMap.prototype%である。
- valueが
%Object.prototype% である[[Prototype]] internal slotを持つ。 ordinary object である。- [[WeakMapData]] internal slotを持たない。
24.3.3.1 WeakMap.prototype.constructor
WeakMap.prototype.constructorのinitial valueは
24.3.3.2 WeakMap.prototype.delete ( key )
このmethodは、呼び出されたときに次のstepsを実行する：
- weakMapを
this valueとする。 - ?
RequireInternalSlot (weakMap, [[WeakMapData]])を実行する。 CanBeHeldWeakly (key)がfalse なら、false を返す。- weakMap.[[WeakMapData]]の各
Record { [[Key]], [[Value]] } entryについて、以下を行う- entry.[[Key]]が
empty でなく、SameValue (entry.[[Key]], key)がtrue なら、- entry.[[Key]]を
empty に設定する。 - entry.[[Value]]を
empty に設定する。 true を返す。
- entry.[[Key]]を
- entry.[[Key]]が
false を返す。
value
24.3.3.3 WeakMap.prototype.get ( key )
このmethodは、呼び出されたときに次のstepsを実行する：
- weakMapを
this valueとする。 - ?
RequireInternalSlot (weakMap, [[WeakMapData]])を実行する。 CanBeHeldWeakly (key)がfalse なら、undefined を返す。- weakMap.[[WeakMapData]]の各
Record { [[Key]], [[Value]] } entryについて、以下を行う- entry.[[Key]]が
empty でなく、SameValue (entry.[[Key]], key)がtrue なら、entry.[[Value]]を返す。
- entry.[[Key]]が
undefined を返す。
24.3.3.4 WeakMap.prototype.getOrInsert ( key, value )
このmethodは、呼び出されたときに次のstepsを実行する：
- weakMapを
this valueとする。 - ?
RequireInternalSlot (weakMap, [[WeakMapData]])を実行する。 CanBeHeldWeakly (key)がfalse なら、TypeError 例外をthrowする。- weakMap.[[WeakMapData]]の各
Record { [[Key]], [[Value]] } entryについて、以下を行う- entry.[[Key]]が
empty でなく、SameValue (entry.[[Key]], key)がtrue なら、entry.[[Value]]を返す。
- entry.[[Key]]が
- entryを
Record { [[Key]]: key, [[Value]]: value }とする。 - entryをweakMap.[[WeakMapData]]へappendする。
- valueを返す。
24.3.3.5 WeakMap.prototype.getOrInsertComputed ( key, callback )
このmethodは、呼び出されたときに次のstepsを実行する：
- weakMapを
this valueとする。 - ?
RequireInternalSlot (weakMap, [[WeakMapData]])を実行する。 CanBeHeldWeakly (key)がfalse なら、TypeError 例外をthrowする。IsCallable (callback)がfalse なら、TypeError 例外をthrowする。- weakMap.[[WeakMapData]]の各
Record { [[Key]], [[Value]] } entryについて、以下を行う- entry.[[Key]]が
empty でなく、SameValue (entry.[[Key]], key)がtrue なら、entry.[[Value]]を返す。
- entry.[[Key]]が
- valueを ?
Call (callback,undefined , « key ») とする。 NOTE : WeakMapはcallbackのexecution中にmodifiedされているかもしれない。- weakMap.[[WeakMapData]]の各
Record { [[Key]], [[Value]] } entryについて、以下を行う- entry.[[Key]]が
empty でなく、SameValue (entry.[[Key]], key)がtrue なら、- entry.[[Value]]をvalueに設定する。
- valueを返す。
- entry.[[Key]]が
- entryを
Record { [[Key]]: key, [[Value]]: value }とする。 - entryをweakMap.[[WeakMapData]]へappendする。
- valueを返す。
24.3.3.6 WeakMap.prototype.has ( key )
このmethodは、呼び出されたときに次のstepsを実行する：
- weakMapを
this valueとする。 - ?
RequireInternalSlot (weakMap, [[WeakMapData]])を実行する。 CanBeHeldWeakly (key)がfalse なら、false を返す。- weakMap.[[WeakMapData]]の各
Record { [[Key]], [[Value]] } entryについて、以下を行う- entry.[[Key]]が
empty でなく、SameValue (entry.[[Key]], key)がtrue なら、true を返す。
- entry.[[Key]]が
false を返す。
24.3.3.7 WeakMap.prototype.set ( key, value )
このmethodは、呼び出されたときに次のstepsを実行する：
- weakMapを
this valueとする。 - ?
RequireInternalSlot (weakMap, [[WeakMapData]])を実行する。 CanBeHeldWeakly (key)がfalse なら、TypeError 例外をthrowする。- weakMap.[[WeakMapData]]の各
Record { [[Key]], [[Value]] } entryについて、以下を行う- entry.[[Key]]が
empty でなく、SameValue (entry.[[Key]], key)がtrue なら、- entry.[[Value]]をvalueに設定する。
- weakMapを返す。
- entry.[[Key]]が
- entryを
Record { [[Key]]: key, [[Value]]: value }とする。 - entryをweakMap.[[WeakMapData]]へappendする。
- weakMapを返す。
24.3.3.8 WeakMap.prototype [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
24.3.4 WeakMap Instancesのプロパティ
WeakMap instancesは
24.4 WeakSetオブジェクト
WeakSetはobjectsおよび/またはsymbolsのcollectionsである。distinct objectまたはsymbolはWeakSetのcollectionのelementとして1回だけ出現してよい。WeakSetはspecific valueをcontainするかどうかqueryできるが、保持しているvaluesをenumerateするmechanismはprovidedされない。certain conditionsでは、
implementationは、WeakSet内にcontainedされるvalueがinaccessibleになる時点と、そのvalueがWeakSetからremovedされる時点との間に、arbitrarily determined latencyをimposeしてもよい。このlatencyがECMAScript programにobservableであったなら、それはprogram executionに影響し得るindeterminacyのsourceとなる。そのため、ECMAScript implementationは、observed valueをobserverにpresentすることをrequireしないparticular valueをWeakSetがcontainするかどうかをdetermineするmeansを一切provideしてはならない。
WeakSetは、平均的にcollection内のelements数に対してsublinearなaccess timeを提供するhash tableまたはその他のmechanismsを用いて実装されなければならない。この仕様で用いられるdata structureは、WeakSetのrequired observable semanticsをdescribeすることだけを意図している。viable implementation modelであることは意図されていない。
24.4.1 WeakSet Constructor
WeakSet
- %WeakSet%である。
global object の"WeakSet" propertyのinitial valueである。constructor として呼び出されたとき、新しいWeakSetをcreateしてinitializeする。- functionとして呼び出されることは意図されておらず、そのように呼び出された場合はexceptionをthrowする。
- クラス定義の
extends句内の値として使用できる。指定された WeakSet の動作を継承しようとするサブクラスコンストラクターは、WeakSet.prototypeの組み込みメソッドをサポートするために必要な内部状態でサブクラスインスタンスを作成し初期化するため、WeakSet コンストラクターへのsuper呼び出しを含めなければならない。
24.4.1.1 WeakSet ( [ iterable ] )
このfunctionは、呼び出されたときに次のstepsを実行する：
- NewTargetが
undefined なら、TypeError 例外をthrowする。 - setを ?
OrdinaryCreateFromConstructor (NewTarget,"%WeakSet.prototype%" , « [[WeakSetData]] ») とする。 - set.[[WeakSetData]]を新しい空の
List に設定する。 - iterableが
undefined またはnull のどちらかなら、setを返す。 - adderを ?
Get (set,"add" ) とする。 IsCallable (adder)がfalse なら、TypeError 例外をthrowする。- iteratorRecordを ?
GetIterator (iterable,sync ) とする。 - 繰り返す、
- nextを ?
IteratorStepValue (iteratorRecord) とする。 - nextが
done なら、setを返す。 - statusを
Completion (Call (adder, set, « next »))とする。 IfAbruptCloseIterator (status, iteratorRecord)。
- nextを ?
24.4.2 WeakSet Constructorのプロパティ
WeakSet
- valueが
%Function.prototype% である[[Prototype]] internal slotを持つ。 - 次のpropertiesを持つ：
24.4.2.1 WeakSet.prototype
WeakSet.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
24.4.3 WeakSet Prototype Objectのプロパティ
WeakSet prototype objectは：
- %WeakSet.prototype%である。
- valueが
%Object.prototype% である[[Prototype]] internal slotを持つ。 ordinary object である。- [[WeakSetData]] internal slotを持たない。
24.4.3.1 WeakSet.prototype.add ( value )
このmethodは、呼び出されたときに次のstepsを実行する：
- weakSetを
this valueとする。 - ?
RequireInternalSlot (weakSet, [[WeakSetData]])を実行する。 CanBeHeldWeakly (value)がfalse なら、TypeError 例外をthrowする。- weakSet.[[WeakSetData]]の各element entryについて、以下を行う
- entryが
empty でなく、SameValue (entry, value)がtrue なら、- weakSetを返す。
- entryが
- valueをweakSet.[[WeakSetData]]へappendする。
- weakSetを返す。
24.4.3.2 WeakSet.prototype.constructor
WeakSet.prototype.constructorのinitial valueは
24.4.3.3 WeakSet.prototype.delete ( value )
このmethodは、呼び出されたときに次のstepsを実行する：
- weakSetを
this valueとする。 - ?
RequireInternalSlot (weakSet, [[WeakSetData]])を実行する。 CanBeHeldWeakly (value)がfalse なら、false を返す。- weakSet.[[WeakSetData]]の各element entryについて、以下を行う
- entryが
empty でなく、SameValue (entry, value)がtrue なら、- valueがentryであるweakSet.[[WeakSetData]]のelementを、valueが
empty であるelementでreplaceする。 true を返す。
- valueがentryであるweakSet.[[WeakSetData]]のelementを、valueが
- entryが
false を返す。
value
24.4.3.4 WeakSet.prototype.has ( value )
このmethodは、呼び出されたときに次のstepsを実行する：
- weakSetを
this valueとする。 - ?
RequireInternalSlot (weakSet, [[WeakSetData]])を実行する。 CanBeHeldWeakly (value)がfalse なら、false を返す。- weakSet.[[WeakSetData]]の各element entryについて、以下を行う
- entryが
empty でなく、SameValue (entry, value)がtrue なら、true を返す。
- entryが
false を返す。
24.4.3.5 WeakSet.prototype [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
24.4.4 WeakSet Instancesのプロパティ
WeakSet instancesは
24.5 Keyed Collectionsの抽象操作
24.5.1 CanonicalizeKeyedCollectionKey ( key )
The abstract operation CanonicalizeKeyedCollectionKey takes argument key (an ECMAScript language value) and returns an ECMAScript language value. It performs the following steps when called:
- keyが
-0 𝔽なら、+0 𝔽を返す。 - keyを返す。
25 構造化データ
25.1 ArrayBufferオブジェクト
25.1.1 記法
このsection、
read-modify-write modification functionは、
- それらはすべてのalgorithm stepsをatomicallyに実行する。
- それらのindividual algorithm stepsはobservableではない。
read-modify-write modification functionのalgorithm stepsがpureなmathematical functionをconstituteすることのverificationを助けるため、以下のeditorial conventionsがrecommendedされる：
- それらは、parametersおよびcaptured valuesを除き、直接にも、invoked
abstract operations およびAbstract Closures を介してtransitivelyにも、いかなるlanguageまたはspecification valuesにもaccessしない。 - それらは、
Completion Records を返すabstract operations およびAbstract Closures を、直接にもtransitivelyにもinvokeしない。 - それらは
Completion Records を返さない。
25.1.2 Fixed-lengthおよびResizable ArrayBufferオブジェクト
fixed-length ArrayBufferは、creation後にbyte lengthがchangeできないArrayBufferである。
resizable ArrayBufferは、
createdされるArrayBuffer objectのkindは、
25.1.3 ArrayBufferオブジェクト用の抽象操作
25.1.3.1 AllocateArrayBuffer ( ctor, byteLength [ , maxByteLength ] )
The abstract operation AllocateArrayBuffer takes arguments ctor (コンストラクタ) and byteLength (非負整数) and optional argument maxByteLength (非負整数または
- Let slots be « [[ArrayBufferData]], [[ArrayBufferByteLength]], [[ArrayBufferDetachKey]] ».
- If maxByteLength is present and maxByteLength is not
empty , let allocatingResizableBuffer betrue ; else let allocatingResizableBuffer befalse . - If allocatingResizableBuffer is
true , then- If byteLength > maxByteLength, throw a
RangeError exception. - Append [[ArrayBufferMaxByteLength]] to slots.
- If byteLength > maxByteLength, throw a
- Let obj be ?
OrdinaryCreateFromConstructor (ctor,"%ArrayBuffer.prototype%" , slots). - Let block be ?
CreateByteDataBlock (byteLength). - Set obj.[[ArrayBufferData]] to block.
- Set obj.[[ArrayBufferByteLength]] to byteLength.
- If allocatingResizableBuffer is
true , then- If it is not possible to create a
Data Block block consisting of maxByteLength bytes, throw aRangeError exception. NOTE : Resizable ArrayBuffers are designed to be implementable with in-place growth. Implementations may throw if, for example, virtual memory cannot be reserved up front.- Set obj.[[ArrayBufferMaxByteLength]] to maxByteLength.
- If it is not possible to create a
- Return obj.
25.1.3.2 ArrayBufferByteLength ( arrayBuffer, order )
The abstract operation ArrayBufferByteLength takes arguments arrayBuffer (ArrayBufferまたはSharedArrayBuffer) and order (
IsGrowableSharedArrayBuffer (arrayBuffer) がtrue である場合、- bufferByteLengthBlock を arrayBuffer.[[ArrayBufferByteLengthData]] とする。
- rawLength を
GetRawBytesFromSharedBlock (bufferByteLengthBlock, 0,biguint64 ,true , order) とする。 - agentRecord を周囲のエージェントの
Agent Record とする。 - isLittleEndian を agentRecord.[[LittleEndian]] とする。
ℝ (RawBytesToNumeric (biguint64 , rawLength, isLittleEndian)) を返す。
- アサート:
IsDetachedBuffer (arrayBuffer) はfalse である。 - arrayBuffer.[[ArrayBufferByteLength]] を返す。
25.1.3.3 ArrayBufferCopyAndDetach ( arrayBuffer, newLength, preserveResizability )
The abstract operation ArrayBufferCopyAndDetach takes arguments arrayBuffer (
- ?
RequireInternalSlot (arrayBuffer, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (arrayBuffer) がtrue である場合、TypeError 例外を投げる。- newLength が
undefined である場合、- newByteLength を arrayBuffer.[[ArrayBufferByteLength]] とする。
- そうでなければ、
- newByteLength を ?
ToIndex (newLength) とする。
- newByteLength を ?
IsDetachedBuffer (arrayBuffer) がtrue である場合、TypeError 例外を投げる。- preserveResizability が
preserve-resizability であり、かつIsFixedLengthArrayBuffer (arrayBuffer) がfalse である場合、- newMaxByteLength を arrayBuffer.[[ArrayBufferMaxByteLength]] とする。
- そうでなければ、
- newMaxByteLength を
empty とする。
- newMaxByteLength を
- arrayBuffer.[[ArrayBufferDetachKey]] が
undefined でない場合、TypeError 例外を投げる。 - newBuffer を ?
AllocateArrayBuffer (%ArrayBuffer% , newByteLength, newMaxByteLength) とする。 - copyLength を
min (newByteLength, arrayBuffer.[[ArrayBufferByteLength]]) とする。 - fromBlock を arrayBuffer.[[ArrayBufferData]] とする。
- toBlock を newBuffer.[[ArrayBufferData]] とする。
CopyDataBlockBytes (toBlock, 0, fromBlock, 0, copyLength) を実行する。- 注記: 新しい
Data Block の作成も、古いData Block からのコピーも観測可能ではない。実装はこのメソッドをゼロコピーの移動またはreallocとして実装してもよい。 - !
DetachArrayBuffer (arrayBuffer) を実行する。 - newBuffer を返す。
25.1.3.4 IsDetachedBuffer ( arrayBuffer )
The abstract operation IsDetachedBuffer takes argument arrayBuffer (ArrayBufferまたはSharedArrayBuffer) and returns Boolean. It performs the following steps when called:
- arrayBuffer.[[ArrayBufferData]] が
null である場合、true を返す。 false を返す。
25.1.3.5 DetachArrayBuffer ( arrayBuffer [ , key ] )
The abstract operation DetachArrayBuffer takes argument arrayBuffer (ArrayBuffer) and optional argument key (任意) and returns
- アサート:
IsSharedArrayBuffer (arrayBuffer) はfalse である。 - key が存在しない場合、key を
undefined に設定する。 - arrayBuffer.[[ArrayBufferDetachKey]] が key でない場合、
TypeError 例外を投げる。 - arrayBuffer.[[ArrayBufferData]] を
null に設定する。 - arrayBuffer.[[ArrayBufferByteLength]] を 0 に設定する。
unused を返す。
ArrayBufferインスタンスのデタッチは、そのバッキングストアとして使用される
25.1.3.6 CloneArrayBuffer ( sourceBuffer, sourceByteOffset, sourceLength )
The abstract operation CloneArrayBuffer takes arguments sourceBuffer (ArrayBufferまたはSharedArrayBuffer), sourceByteOffset (非負整数), and sourceLength (非負整数) and returns ArrayBufferを含む正常完了またはthrow完了. これは、sourceByteOffset から始まり sourceLength バイト続く範囲にわたって、sourceBuffer のデータのコピーであるデータを持つ新しいArrayBufferを作成する。 It performs the following steps when called:
- アサート:
IsDetachedBuffer (sourceBuffer) はfalse である。 - targetBuffer を ?
AllocateArrayBuffer (%ArrayBuffer% , sourceLength) とする。 - sourceBlock を sourceBuffer.[[ArrayBufferData]] とする。
- targetBlock を targetBuffer.[[ArrayBufferData]] とする。
CopyDataBlockBytes (targetBlock, 0, sourceBlock, sourceByteOffset, sourceLength) を実行する。- targetBuffer を返す。
25.1.3.7 GetArrayBufferMaxByteLengthOption ( options )
The abstract operation GetArrayBufferMaxByteLengthOption takes argument options (
25.1.3.8 HostResizeArrayBuffer ( buffer, newByteLength )
The
HostResizeArrayBufferの実装は、次の要件に従わなければならない:
- この抽象操作は buffer をデタッチしない。
- この抽象操作が
handled で正常完了する場合、buffer.[[ArrayBufferByteLength]] は newByteLength である。
HostResizeArrayBufferの既定の実装は
25.1.3.9 IsFixedLengthArrayBuffer ( arrayBuffer )
The abstract operation IsFixedLengthArrayBuffer takes argument arrayBuffer (ArrayBufferまたはSharedArrayBuffer) and returns Boolean. It performs the following steps when called:
- arrayBuffer が [[ArrayBufferMaxByteLength]] 内部スロットを持つ場合、
false を返す。 true を返す。
25.1.3.10 IsUnsignedElementType ( type )
The abstract operation IsUnsignedElementType takes argument type (
- type が
uint8 ,uint8clamped ,uint16 ,uint32 , またはbiguint64 のいずれかである場合、true を返す。 false を返す。
25.1.3.11 IsUnclampedIntegerElementType ( type )
The abstract operation IsUnclampedIntegerElementType takes argument type (
- type が
int8 ,uint8 ,int16 ,uint16 ,int32 , またはuint32 のいずれかである場合、true を返す。 false を返す。
25.1.3.12 IsBigIntElementType ( type )
The abstract operation IsBigIntElementType takes argument type (
- type が
biguint64 またはbigint64 のいずれかである場合、true を返す。 false を返す。
25.1.3.13 IsNoTearConfiguration ( type, order )
The abstract operation IsNoTearConfiguration takes arguments type (a
IsUnclampedIntegerElementType (type) がtrue である場合、true を返す。IsBigIntElementType (type) がtrue であり、かつ order がinit でもunordered でもない場合、true を返す。false を返す。
25.1.3.14 RawBytesToNumeric ( type, rawBytes, isLittleEndian )
The abstract operation RawBytesToNumeric takes arguments type (
- elementSize を、Element Type type に対して
Table 71 で指定されるElement Size値とする。 - isLittleEndian が
false である場合、rawBytes の要素の順序を反転する。 - type が
float16 である場合、- value を、rawBytes のバイト要素を連結し、
IEEE 754-2019 binary16値のリトルエンディアン・ビット列エンコードとして解釈したものとする。 - value がNaNである場合、
NaN を返す。 - value に対応するNumber値を返す。
- value を、rawBytes のバイト要素を連結し、
- type が
float32 である場合、- value を、rawBytes のバイト要素を連結し、
IEEE 754-2019 binary32値のリトルエンディアン・ビット列エンコードとして解釈したものとする。 - value がNaNである場合、
NaN を返す。 - value に対応するNumber値を返す。
- value を、rawBytes のバイト要素を連結し、
- type が
float64 である場合、- value を、rawBytes のバイト要素を連結し、
IEEE 754-2019 binary64値のリトルエンディアン・ビット列エンコードとして解釈したものとする。 - value がNaNである場合、
NaN を返す。 - value に対応するNumber値を返す。
- value を、rawBytes のバイト要素を連結し、
IsUnsignedElementType (type) がtrue である場合、- intValue を、rawBytes のバイト要素を連結し、符号なしリトルエンディアン二進数のビット列エンコードとして解釈したものとする。
- そうでなければ、
- intValue を、rawBytes のバイト要素を連結し、ビット長 elementSize × 8 の二進リトルエンディアン2の補数のビット列エンコードとして解釈したものとする。
IsBigIntElementType (type) がtrue である場合、intValue に対応するBigInt値を返す。- intValue に対応するNumber値を返す。
25.1.3.15 GetRawBytesFromSharedBlock ( block, byteIndex, type, isTypedArray, order )
The abstract operation GetRawBytesFromSharedBlock takes arguments block (
- elementSize を、Element Type type に対して
Table 71 で指定されるElement Size値とする。 - agentRecord を周囲のエージェントの
Agent Record とする。 - execution を agentRecord.[[CandidateExecution]] とする。
- eventsRecord を、execution.[[EventsRecords]] のうち [[AgentSignifier]] が
AgentSignifier () であるAgent Events Record とする。 - isTypedArray が
true であり、かつIsNoTearConfiguration (type, order) がtrue である場合、noTear をtrue とする。そうでなければ noTear をfalse とする。 - rawValue を、要素が非決定的に選択されたバイト値である、長さ elementSize の
List とする。 - 注記: 実装では、rawValue は基礎となるハードウェア上の非アトミックまたはアトミック読み取り命令の結果である。非決定性は、弱い一貫性を持つハードウェアの観測可能な振る舞いを記述するための、メモリモデルの意味論的規定である。
- readEvent を
ReadSharedMemory { [[Order]]: order, [[NoTear]]: noTear, [[Block]]: block, [[ByteIndex]]: byteIndex, [[ElementSize]]: elementSize } とする。 - readEvent を eventsRecord.[[EventList]] に追加する。
Chosen Value Record { [[Event]]: readEvent, [[ChosenValue]]: rawValue } を execution.[[ChosenValues]] に追加する。- rawValue を返す。
25.1.3.16 GetValueFromBuffer ( arrayBuffer, byteIndex, type, isTypedArray, order [ , isLittleEndian ] )
The abstract operation GetValueFromBuffer takes arguments arrayBuffer (ArrayBufferまたはSharedArrayBuffer), byteIndex (非負整数), type (
- アサート:
IsDetachedBuffer (arrayBuffer) はfalse である。 - アサート: arrayBuffer には、byteIndex から始まり type の値を表現するのに十分なバイトがある。
- block を arrayBuffer.[[ArrayBufferData]] とする。
- elementSize を、Element Type type に対して
Table 71 で指定されるElement Size値とする。 IsSharedArrayBuffer (arrayBuffer) がtrue である場合、- アサート: block は
Shared Data Block である。 - rawValue を
GetRawBytesFromSharedBlock (block, byteIndex, type, isTypedArray, order) とする。
- アサート: block は
- そうでなければ、
- rawValue を、block 内の byteIndex（含む）から byteIndex + elementSize（含まない）までの区間のインデックスにあるバイトを要素とする
List とする。
- rawValue を、block 内の byteIndex（含む）から byteIndex + elementSize（含まない）までの区間のインデックスにあるバイトを要素とする
- アサート: rawValue 内の要素数は elementSize である。
- isLittleEndian が存在しない場合、
- agentRecord を周囲のエージェントの
Agent Record とする。 - isLittleEndian を agentRecord.[[LittleEndian]] に設定する。
- agentRecord を周囲のエージェントの
RawBytesToNumeric (type, rawValue, isLittleEndian) を返す。
25.1.3.17 NumericToRawBytes ( type, value, isLittleEndian )
The abstract operation NumericToRawBytes takes arguments type (
- type が
float16 である場合、- rawBytes を、roundTiesToEvenモードを使用して value を
IEEE 754-2019 binary16形式へ変換した結果である2バイトを要素とするList とする。これらのバイトはリトルエンディアン順に配置される。value がNaN である場合、rawBytes は実装が選択する任意のIEEE 754-2019 binary16形式のNaNエンコードに設定されてもよい。実装は、実装上区別可能な各NaN 値に対して、常に同じエンコードを選択しなければならない。
- rawBytes を、roundTiesToEvenモードを使用して value を
- そうでなく type が
float32 である場合、- rawBytes を、roundTiesToEvenモードを使用して value を
IEEE 754-2019 binary32形式へ変換した結果である4バイトを要素とするList とする。これらのバイトはリトルエンディアン順に配置される。value がNaN である場合、rawBytes は実装が選択する任意のIEEE 754-2019 binary32形式のNaNエンコードに設定されてもよい。実装は、実装上区別可能な各NaN 値に対して、常に同じエンコードを選択しなければならない。
- rawBytes を、roundTiesToEvenモードを使用して value を
- そうでなく type が
float64 である場合、- rawBytes を、value の
IEEE 754-2019 binary64形式エンコードである8バイトを要素とするList とする。これらのバイトはリトルエンディアン順に配置される。value がNaN である場合、rawBytes は実装が選択する任意のIEEE 754-2019 binary64形式のNaNエンコードに設定されてもよい。実装は、実装上区別可能な各NaN 値に対して、常に同じエンコードを選択しなければならない。
- rawBytes を、value の
- そうでなければ、
- n を、Element Type type に対して
Table 71 で指定されるElement Size値とする。 - conversionOperation を、Element Type type に対して
Table 71 の“Conversion Operation”列にある名前の抽象操作とする。 - intValue を
ℝ (! conversionOperation(value)) とする。 - intValue ≥ 0 である場合、
- rawBytes を、intValue の n バイト二進エンコードを要素とする
List とする。これらのバイトはリトルエンディアン順に並べられる。
- rawBytes を、intValue の n バイト二進エンコードを要素とする
- そうでなければ、
- rawBytes を、intValue の n バイト二進2の補数エンコードを要素とする
List とする。これらのバイトはリトルエンディアン順に並べられる。
- rawBytes を、intValue の n バイト二進2の補数エンコードを要素とする
- n を、Element Type type に対して
- isLittleEndian が
false である場合、rawBytes の要素の順序を反転する。 - rawBytes を返す。
25.1.3.18 SetValueInBuffer ( arrayBuffer, byteIndex, type, value, isTypedArray, order [ , isLittleEndian ] )
The abstract operation SetValueInBuffer takes arguments arrayBuffer (an ArrayBuffer or SharedArrayBuffer), byteIndex (a non-negative
- アサート:
IsDetachedBuffer (arrayBuffer) はfalse である。 - アサート: arrayBuffer には、byteIndex から始まり type の値を表現するのに十分なバイトがある。
- アサート:
IsBigIntElementType (type) がtrue である場合、value はBigIntであり、そうでなければ value はNumberである。 - block を arrayBuffer.[[ArrayBufferData]] とする。
- elementSize を、Element Type type に対して
Table 71 で指定されるElement Size値とする。 - agentRecord を周囲のエージェントの
Agent Record とする。 - isLittleEndian が存在しない場合、
- isLittleEndian を agentRecord.[[LittleEndian]] に設定する。
- rawBytes を
NumericToRawBytes (type, value, isLittleEndian) とする。 IsSharedArrayBuffer (arrayBuffer) がtrue である場合、- execution を agentRecord.[[CandidateExecution]] とする。
- eventsRecord を、execution.[[EventsRecords]] のうち [[AgentSignifier]] が
AgentSignifier () であるAgent Events Record とする。 - isTypedArray が
true であり、かつIsNoTearConfiguration (type, order) がtrue である場合、noTear をtrue とする。そうでなければ noTear をfalse とする。 WriteSharedMemory { [[Order]]: order, [[NoTear]]: noTear, [[Block]]: block, [[ByteIndex]]: byteIndex, [[ElementSize]]: elementSize, [[Payload]]: rawBytes } を eventsRecord.[[EventList]] に追加する。
- そうでなければ、
- rawBytes の個々のバイトを、block[byteIndex] から始めて block に格納する。
unused を返す。
25.1.3.19 GetModifySetValueInBuffer ( arrayBuffer, byteIndex, type, value, op )
The abstract operation GetModifySetValueInBuffer takes arguments arrayBuffer (ArrayBufferまたはSharedArrayBuffer), byteIndex (非負整数), type (
- アサート:
IsDetachedBuffer (arrayBuffer) はfalse である。 - アサート: arrayBuffer には、byteIndex から始まり type の値を表現するのに十分なバイトがある。
- アサート:
IsBigIntElementType (type) がtrue である場合、value はBigIntであり、そうでなければ value はNumberである。 - block を arrayBuffer.[[ArrayBufferData]] とする。
- elementSize を、Element Type type に対して
Table 71 で指定されるElement Size値とする。 - agentRecord を周囲のエージェントの
Agent Record とする。 - isLittleEndian を agentRecord.[[LittleEndian]] とする。
- rawBytes を
NumericToRawBytes (type, value, isLittleEndian) とする。 IsSharedArrayBuffer (arrayBuffer) がtrue である場合、- execution を agentRecord.[[CandidateExecution]] とする。
- eventsRecord を、execution.[[EventsRecords]] のうち [[AgentSignifier]] が
AgentSignifier () であるAgent Events Record とする。 - rawBytesRead を、要素が非決定的に選択されたバイト値である、長さ elementSize の
List とする。 - 注記: 実装では、rawBytesRead は基礎となるハードウェア上のload-link、load-exclusive、または読み取り-変更-書き込み命令のオペランドの結果である。非決定性は、弱い一貫性を持つハードウェアの観測可能な振る舞いを記述するための、メモリモデルの意味論的規定である。
- rmwEvent を
ReadModifyWriteSharedMemory { [[Order]]:seq-cst , [[NoTear]]:true , [[Block]]: block, [[ByteIndex]]: byteIndex, [[ElementSize]]: elementSize, [[Payload]]: rawBytes, [[ModifyOp]]: op } とする。 - rmwEvent を eventsRecord.[[EventList]] に追加する。
Chosen Value Record { [[Event]]: rmwEvent, [[ChosenValue]]: rawBytesRead } を execution.[[ChosenValues]] に追加する。
- そうでなければ、
- rawBytesRead を、block[byteIndex] から始まる elementSize バイトの並びを要素とする、長さ elementSize の
List とする。 - rawBytesModified を op(rawBytesRead, rawBytes) とする。
- rawBytesModified の個々のバイトを、block[byteIndex] から始めて block に格納する。
- rawBytesRead を、block[byteIndex] から始まる elementSize バイトの並びを要素とする、長さ elementSize の
RawBytesToNumeric (type, rawBytesRead, isLittleEndian) を返す。
25.1.4 ArrayBuffer Constructor
ArrayBuffer
- %ArrayBuffer%である。
global object の"ArrayBuffer" propertyのinitial valueである。constructor として呼び出されたとき、新しいArrayBufferをcreateしてinitializeする。- functionとして呼び出されることは意図されておらず、そのように呼び出された場合はexceptionをthrowする。
- クラス定義の
extends句の値として使用できる。指定された ArrayBuffer の動作を継承しようとするサブクラスコンストラクターは、ArrayBuffer.prototypeの組み込みメソッドをサポートするために必要な内部状態でサブクラスインスタンスを作成し初期化するため、ArrayBuffer コンストラクターへのsuper呼び出しを含めなければならない。
25.1.4.1 ArrayBuffer ( length [ , options ] )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- NewTargetが
undefined なら、TypeError 例外をthrowする。 - byteLengthを ?
ToIndex (length) とする。 - requestedMaxByteLengthを ?
GetArrayBufferMaxByteLengthOption (options) とする。 - ?
AllocateArrayBuffer (NewTarget, byteLength, requestedMaxByteLength)を返す。
25.1.5 ArrayBuffer Constructorのプロパティ
ArrayBuffer
- valueが
%Function.prototype% である[[Prototype]] internal slotを持つ。 - 以下のpropertiesを持つ：
25.1.5.1 ArrayBuffer.isView ( arg )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- argがObjectでないなら、
false を返す。 - argが[[ViewedArrayBuffer]] internal slotを持つなら、
true を返す。 false を返す。
25.1.5.2 ArrayBuffer.prototype
ArrayBuffer.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
25.1.5.3 get ArrayBuffer [ %Symbol.species% ]
ArrayBuffer[%Symbol.species%]は、set accessor functionが
this valueを返す。
このfunctionの
25.1.6 ArrayBuffer Prototype Objectのプロパティ
ArrayBuffer prototype objectは：
- %ArrayBuffer.prototype%である。
- valueが
%Object.prototype% である[[Prototype]] internal slotを持つ。 ordinary object である。- [[ArrayBufferData]]または[[ArrayBufferByteLength]] internal slotを持たない。
25.1.6.1 get ArrayBuffer.prototype.byteLength
ArrayBuffer.prototype.byteLengthは、set accessor functionが
- objを
this valueとする。 - ?
RequireInternalSlot (obj, [[ArrayBufferData]])を実行する。 IsSharedArrayBuffer (obj)がtrue なら、TypeError 例外をthrowする。IsDetachedBuffer (obj)がtrue なら、+0 𝔽を返す。- lengthをobj.[[ArrayBufferByteLength]]とする。
𝔽 (length)を返す。
25.1.6.2 ArrayBuffer.prototype.constructor
ArrayBuffer.prototype.constructorのinitial valueは
25.1.6.3 get ArrayBuffer.prototype.detached
ArrayBuffer.prototype.detachedは、set accessor functionが
- objを
this valueとする。 - ?
RequireInternalSlot (obj, [[ArrayBufferData]])を実行する。 IsSharedArrayBuffer (obj)がtrue なら、TypeError 例外をthrowする。IsDetachedBuffer (obj)を返す。
25.1.6.4 get ArrayBuffer.prototype.maxByteLength
ArrayBuffer.prototype.maxByteLengthは、set accessor functionが
- objを
this valueとする。 - ?
RequireInternalSlot (obj, [[ArrayBufferData]])を実行する。 IsSharedArrayBuffer (obj)がtrue なら、TypeError 例外をthrowする。IsDetachedBuffer (obj)がtrue なら、+0 𝔽を返す。IsFixedLengthArrayBuffer (obj)がtrue なら、- lengthをobj.[[ArrayBufferByteLength]]とする。
- そうでなければ、
- lengthをobj.[[ArrayBufferMaxByteLength]]とする。
𝔽 (length)を返す。
25.1.6.5 get ArrayBuffer.prototype.resizable
ArrayBuffer.prototype.resizableは、set accessor functionが
- objを
this valueとする。 - ?
RequireInternalSlot (obj, [[ArrayBufferData]])を実行する。 IsSharedArrayBuffer (obj)がtrue なら、TypeError 例外をthrowする。IsFixedLengthArrayBuffer (obj)がfalse なら、true を返す。false を返す。
25.1.6.6 ArrayBuffer.prototype.resize ( newLength )
このmethodは、呼び出されたときに以下のstepsを実行する：
- objを
this valueとする。 - ?
RequireInternalSlot (obj, [[ArrayBufferMaxByteLength]])を実行する。 IsSharedArrayBuffer (obj)がtrue なら、TypeError 例外をthrowする。- newByteLengthを ?
ToIndex (newLength) とする。 IsDetachedBuffer (obj)がtrue なら、TypeError 例外をthrowする。- newByteLength > obj.[[ArrayBufferMaxByteLength]]なら、
RangeError 例外をthrowする。 - hostHandledを ?
HostResizeArrayBuffer (obj, newByteLength) とする。 - hostHandledが
handled なら、undefined を返す。 - oldBlockをobj.[[ArrayBufferData]]とする。
- newBlockを ?
CreateByteDataBlock (newByteLength) とする。 - copyLengthを
min (newByteLength, obj.[[ArrayBufferByteLength]])とする。 CopyDataBlockBytes (newBlock, 0, oldBlock, 0, copyLength)を実行する。NOTE : 新しいData Block のcreationもoldData Block からのcopyingもobservableではない。Implementationsは、このmethodをin-place growthまたはshrinkageとしてimplementしてもよい。- obj.[[ArrayBufferData]]をnewBlockに設定する。
- obj.[[ArrayBufferByteLength]]をnewByteLengthに設定する。
undefined を返す。
25.1.6.7 ArrayBuffer.prototype.slice ( start, end )
このmethodは、呼び出されたときに以下のstepsを実行する：
- objを
this valueとする。 - ?
RequireInternalSlot (obj, [[ArrayBufferData]])を実行する。 IsSharedArrayBuffer (obj)がtrue なら、TypeError 例外をthrowする。IsDetachedBuffer (obj)がtrue なら、TypeError 例外をthrowする。- lengthをobj.[[ArrayBufferByteLength]]とする。
- relativeStartを ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞なら、firstを0とする。
- そうでなく、relativeStart < 0なら、firstを
max (length + relativeStart, 0)とする。 - そうでなければ、firstを
min (relativeStart, length)とする。 - endが
undefined なら、relativeEndをlengthとする；そうでなければ、relativeEndを ?ToIntegerOrInfinity (end) とする。 - relativeEnd = -∞なら、finalを0とする。
- そうでなく、relativeEnd < 0なら、finalを
max (length + relativeEnd, 0)とする。 - そうでなければ、finalを
min (relativeEnd, length)とする。 - newLengthを
max (final - first, 0)とする。 - ctorを ?
SpeciesConstructor (obj,%ArrayBuffer% ) とする。 - newを ?
Construct (ctor, «𝔽 (newLength) ») とする。 - ?
RequireInternalSlot (new, [[ArrayBufferData]])を実行する。 IsSharedArrayBuffer (new)がtrue なら、TypeError 例外をthrowする。IsDetachedBuffer (new)がtrue なら、TypeError 例外をthrowする。SameValue (new, obj)がtrue なら、TypeError 例外をthrowする。- new.[[ArrayBufferByteLength]] < newLengthなら、
TypeError 例外をthrowする。 NOTE : 上記stepsのside-effectsにより、objがdetachedまたはresizedされている可能性がある。IsDetachedBuffer (obj)がtrue なら、TypeError 例外をthrowする。- fromBufをobj.[[ArrayBufferData]]とする。
- toBufをnew.[[ArrayBufferData]]とする。
- currentLengthをobj.[[ArrayBufferByteLength]]とする。
- first < currentLengthなら、
- countを
min (newLength, currentLength - first)とする。 CopyDataBlockBytes (toBuf, 0, fromBuf, first, count)を実行する。
- countを
- newを返す。
25.1.6.8 ArrayBuffer.prototype.transfer ( [ newLength ] )
このmethodは、呼び出されたときに以下のstepsを実行する：
- objを
this valueとする。 - ?
ArrayBufferCopyAndDetach (obj, newLength,preserve-resizability )を返す。
25.1.6.9 ArrayBuffer.prototype.transferToFixedLength ( [ newLength ] )
このmethodは、呼び出されたときに以下のstepsを実行する：
- objを
this valueとする。 - ?
ArrayBufferCopyAndDetach (obj, newLength,fixed-length )を返す。
25.1.6.10 ArrayBuffer.prototype [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
25.1.7 ArrayBuffer Instancesのプロパティ
ArrayBuffer instancesは
[[ArrayBufferData]]が
[[ArrayBufferDetachKey]]が
25.1.8 Resizable ArrayBuffer Guidelines
以下は、
programsは、可能であればdeployment environmentsでtestedされることをrecommendする。available physical memoryの量はhardware devices間でgreatlyに異なる。同様に、virtual memory subsystemsもhardware devices間およびoperating systems間でgreatlyに異なる。64-bit desktop web browserでout-of-memory errorsなしにrunsするapplicationが、32-bit mobile web browserではout of memoryになる可能性がある。
particular maximum sizeの
以下は、
hostがmulti-tenanted（すなわち、多数のECMAScript applicationsをsimultaneouslyにrunsする）である場合、web browserなどで、そのimplementationsがvirtual memoryをreservingすることでin-place growthをimplementすることをchooseするなら、32-bitおよび64-bitの両implementationsは、
hostがMMUのないembedded devices上でrunningするもののようにvirtual memoryを持たない場合、またはhostがcopyingによるresizingのみをimplementする場合、
25.2 SharedArrayBufferオブジェクト
25.2.1 Fixed-lengthおよびGrowable SharedArrayBufferオブジェクト
fixed-length SharedArrayBufferは、creation後にbyte lengthがchangeできないSharedArrayBufferである。
growable SharedArrayBufferは、
createdされるSharedArrayBuffer objectのkindは、
25.2.2 SharedArrayBufferオブジェクトの抽象操作
25.2.2.1 AllocateSharedArrayBuffer ( ctor, byteLength [ , maxByteLength ] )
The abstract operation AllocateSharedArrayBuffer takes arguments ctor (a
- Let slots be « [[ArrayBufferData]] ».
- If maxByteLength is present and maxByteLength is not
empty , let allocatingGrowableBuffer betrue ; else let allocatingGrowableBuffer befalse . - If allocatingGrowableBuffer is
true , then- If byteLength > maxByteLength, throw a
RangeError exception. - Append [[ArrayBufferByteLengthData]] and [[ArrayBufferMaxByteLength]] to slots.
- If byteLength > maxByteLength, throw a
- Else,
- Append [[ArrayBufferByteLength]] to slots.
- Let obj be ?
OrdinaryCreateFromConstructor (ctor,"%SharedArrayBuffer.prototype%" , slots). - If allocatingGrowableBuffer is
true , let allocLength be maxByteLength; else let allocLength be byteLength. - Let block be ?
CreateSharedByteDataBlock (allocLength). - Set obj.[[ArrayBufferData]] to block.
- If allocatingGrowableBuffer is
true , thenAssert : byteLength ≤ maxByteLength.- Let byteLengthBlock be ?
CreateSharedByteDataBlock (8). - Perform
SetValueInBuffer (byteLengthBlock, 0,biguint64 ,ℤ (byteLength),true ,seq-cst ). - Set obj.[[ArrayBufferByteLengthData]] to byteLengthBlock.
- Set obj.[[ArrayBufferMaxByteLength]] to maxByteLength.
- Else,
- Set obj.[[ArrayBufferByteLength]] to byteLength.
- Return obj.
25.2.2.2 IsSharedArrayBuffer ( obj )
The abstract operation IsSharedArrayBuffer takes argument obj (an ArrayBuffer or a SharedArrayBuffer) and returns a Boolean. objectがSharedArrayBufferであるかどうかをtestする。 It performs the following steps when called:
- obj.[[ArrayBufferData]]が
Shared Data Block なら、true を返す。 false を返す。
25.2.2.3 IsGrowableSharedArrayBuffer ( obj )
The abstract operation IsGrowableSharedArrayBuffer takes argument obj (an ArrayBuffer or a SharedArrayBuffer) and returns a Boolean. objectが
IsSharedArrayBuffer (obj)がtrue であり、objが[[ArrayBufferByteLengthData]] internal slotを持つなら、true を返す。false を返す。
25.2.2.4 HostGrowSharedArrayBuffer ( buffer, newByteLength )
The
HostGrowSharedArrayBufferのimplementationは、以下のrequirementsにconformしなければならない：
- abstract operationが
unhandled でnormally completeしない場合に、newByteLength < bufferのcurrent byte lengthまたはnewByteLength > buffer.[[ArrayBufferMaxByteLength]]であるなら、RangeError 例外をthrowする。 - agentRecordを
surrounding agent のAgent Record とする。isLittleEndianをagentRecord.[[LittleEndian]]とする。abstract operationがhandled でnormally completeする場合、[[Order]]がseq-cst 、[[Payload]]がNumericToRawBytes (biguint64 , newByteLength, isLittleEndian)、[[Block]]がbuffer.[[ArrayBufferByteLengthData]]、[[ByteIndex]]が0、[[ElementSize]]が8であるWriteSharedMemory またはReadModifyWriteSharedMemory eventが、SharedArrayBuffer.prototype.grow ( newLength ) へのracing callsが“lost”されない、すなわちsilently do nothingしないように、surrounding agent のcandidate execution にaddedされる。
上記のsecond requirementは、bufferのcurrent byte lengthがどのように、またはいつreadされるかについてintentionally vagueである。byte lengthはunderlying hardware上のatomic read-modify-write operationを介してupdatedされなければならないため、load-link/store-conditionalまたはload-exclusive/store-exclusive instruction pairsを使用するarchitecturesでは、paired instructionsをinstruction stream内でcloseに保ちたい場合がある。そのため、
これは、0 ≤ newByteLength ≤ buffer.[[ArrayBufferMaxByteLength]]であることがguaranteedされる
HostGrowSharedArrayBufferのdefault implementationは
25.2.3 SharedArrayBuffer Constructor
SharedArrayBuffer
- %SharedArrayBuffer%である。
- そのpropertyがpresentである場合（belowを参照）、
global object の"SharedArrayBuffer" propertyのinitial valueである。 constructor として呼び出されたとき、新しいSharedArrayBufferをcreateしてinitializeする。- functionとして呼び出されることは意図されておらず、そのように呼び出された場合はexceptionをthrowする。
- クラス定義の
extends句の値として使用できる。指定された SharedArrayBuffer の動作を継承しようとするサブクラスコンストラクターは、SharedArrayBuffer.prototypeの組み込みメソッドをサポートするために必要な内部状態でサブクラスインスタンスを作成し初期化するため、SharedArrayBuffer コンストラクターへのsuper呼び出しを含めなければならない。
hostがSharedArrayBuffersへのconcurrent accessをprovideしない場合はいつでも、
ArrayBufferとは異なり、SharedArrayBufferはdetachedになることができず、そのinternal [[ArrayBufferData]] slotは決して
25.2.3.1 SharedArrayBuffer ( length [ , options ] )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- NewTargetが
undefined なら、TypeError 例外をthrowする。 - byteLengthを ?
ToIndex (length) とする。 - requestedMaxByteLengthを ?
GetArrayBufferMaxByteLengthOption (options) とする。 - ?
AllocateSharedArrayBuffer (NewTarget, byteLength, requestedMaxByteLength)を返す。
25.2.4 SharedArrayBuffer Constructorのプロパティ
SharedArrayBuffer
- valueが
%Function.prototype% である[[Prototype]] internal slotを持つ。 - 以下のpropertiesを持つ：
25.2.4.1 SharedArrayBuffer.prototype
SharedArrayBuffer.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
25.2.4.2 get SharedArrayBuffer [ %Symbol.species% ]
SharedArrayBuffer[%Symbol.species%]は、set accessor functionが
this valueを返す。
このfunctionの
25.2.5 SharedArrayBuffer Prototype Objectのプロパティ
SharedArrayBuffer prototype objectは：
- %SharedArrayBuffer.prototype%である。
- valueが
%Object.prototype% である[[Prototype]] internal slotを持つ。 ordinary object である。- [[ArrayBufferData]]または[[ArrayBufferByteLength]] internal slotを持たない。
25.2.5.1 get SharedArrayBuffer.prototype.byteLength
SharedArrayBuffer.prototype.byteLengthは、set accessor functionが
- objを
this valueとする。 - ?
RequireInternalSlot (obj, [[ArrayBufferData]])を実行する。 IsSharedArrayBuffer (obj)がfalse なら、TypeError 例外をthrowする。- lengthを
ArrayBufferByteLength (obj,seq-cst )とする。 𝔽 (length)を返す。
25.2.5.2 SharedArrayBuffer.prototype.constructor
SharedArrayBuffer.prototype.constructorのinitial valueは
25.2.5.3 SharedArrayBuffer.prototype.grow ( newLength )
このmethodは、呼び出されたときに以下のstepsを実行する：
- objを
this valueとする。 - ?
RequireInternalSlot (obj, [[ArrayBufferMaxByteLength]])を実行する。 IsSharedArrayBuffer (obj)がfalse なら、TypeError 例外をthrowする。- newByteLengthを ?
ToIndex (newLength) とする。 - hostHandledを ?
HostGrowSharedArrayBuffer (obj, newByteLength) とする。 - hostHandledが
handled なら、undefined を返す。 - agentRecordを
surrounding agent のAgent Record とする。 - isLittleEndianをagentRecord.[[LittleEndian]]とする。
- byteLengthBlockをobj.[[ArrayBufferByteLengthData]]とする。
- currentByteLengthRawBytesを
GetRawBytesFromSharedBlock (byteLengthBlock, 0,biguint64 ,true ,seq-cst )とする。 - newByteLengthRawBytesを
NumericToRawBytes (biguint64 ,ℤ (newByteLength), isLittleEndian)とする。 - Repeat,
NOTE : これは、same bufferのparallelかつracingなgrowsがtotally orderedされ、lostされず、silently do nothingしないことをensureするためのcompare-and-exchange loopである。このloopは、uncontendedにgrowをattemptできた場合にexitする。- currentByteLengthを
ℝ (RawBytesToNumeric (biguint64 , currentByteLengthRawBytes, isLittleEndian))とする。 - newByteLength = currentByteLengthなら、
undefined を返す。 - newByteLength < currentByteLengthまたはnewByteLength > obj.[[ArrayBufferMaxByteLength]]なら、
RangeError 例外をthrowする。 - byteLengthDeltaをnewByteLength - currentByteLengthとする。
- byteLengthDelta bytesからなるnew
Shared Data Block valueをcreateすることがimpossibleなら、RangeError 例外をthrowする。 NOTE : ここではnewShared Data Block はconstructedもusedもされない。growable SharedArrayBuffersのobservable behaviourは、construction timeにmax -sizedShared Data Block をallocatingすることでspecifiedされており、このstepは、out of memoryになったimplementationsがRangeError をthrowしなければならないというrequirementをcaptureする。- readByteLengthRawBytesを
AtomicCompareExchangeInSharedBlock (byteLengthBlock, 0, 8, currentByteLengthRawBytes, newByteLengthRawBytes)とする。 ByteListEqual (readByteLengthRawBytes, currentByteLengthRawBytes)がtrue なら、undefined を返す。- currentByteLengthRawBytesをreadByteLengthRawBytesに設定する。
lengthをupdateするcompare-exchangeのspurious failuresは禁止される。new lengthのbounds checkingがpassし、implementationがout of memoryでない場合、
SharedArrayBuffer.prototype.growへのparallel callsはtotally orderedである。例えば、sab.grow(10)とsab.grow(20)という2つのracing callsを考える。2つのcallsのうち一方がraceにwinすることがguaranteedされる。sab.grow(10)へのcallは、たとえsab.grow(20)が先にhappenedしたとしても、決してsabをshrinkしない；その場合は代わりにRangeErrorをthrowする。
25.2.5.4 get SharedArrayBuffer.prototype.growable
SharedArrayBuffer.prototype.growableは、set accessor functionが
- objを
this valueとする。 - ?
RequireInternalSlot (obj, [[ArrayBufferData]])を実行する。 IsSharedArrayBuffer (obj)がfalse なら、TypeError 例外をthrowする。IsFixedLengthArrayBuffer (obj)がfalse なら、true を返す。false を返す。
25.2.5.5 get SharedArrayBuffer.prototype.maxByteLength
SharedArrayBuffer.prototype.maxByteLengthは、set accessor functionが
- objを
this valueとする。 - ?
RequireInternalSlot (obj, [[ArrayBufferData]])を実行する。 IsSharedArrayBuffer (obj)がfalse なら、TypeError 例外をthrowする。IsFixedLengthArrayBuffer (obj)がtrue なら、- lengthをobj.[[ArrayBufferByteLength]]とする。
- そうでなければ、
- lengthをobj.[[ArrayBufferMaxByteLength]]とする。
𝔽 (length)を返す。
25.2.5.6 SharedArrayBuffer.prototype.slice ( start, end )
このmethodは、呼び出されたときに以下のstepsを実行する：
- objを
this valueとする。 - ?
RequireInternalSlot (obj, [[ArrayBufferData]])を実行する。 IsSharedArrayBuffer (obj)がfalse なら、TypeError 例外をthrowする。- lengthを
ArrayBufferByteLength (obj,seq-cst )とする。 - relativeStartを ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞なら、firstを0とする。
- そうでなく、relativeStart < 0なら、firstを
max (length + relativeStart, 0)とする。 - そうでなければ、firstを
min (relativeStart, length)とする。 - endが
undefined なら、relativeEndをlengthとする；そうでなければ、relativeEndを ?ToIntegerOrInfinity (end) とする。 - relativeEnd = -∞なら、finalを0とする。
- そうでなく、relativeEnd < 0なら、finalを
max (length + relativeEnd, 0)とする。 - そうでなければ、finalを
min (relativeEnd, length)とする。 - newLengthを
max (final - first, 0)とする。 - ctorを ?
SpeciesConstructor (obj,%SharedArrayBuffer% ) とする。 - newを ?
Construct (ctor, «𝔽 (newLength) ») とする。 - ?
RequireInternalSlot (new, [[ArrayBufferData]])を実行する。 IsSharedArrayBuffer (new)がfalse なら、TypeError 例外をthrowする。- new.[[ArrayBufferData]]がobj.[[ArrayBufferData]]であるなら、
TypeError 例外をthrowする。 ArrayBufferByteLength (new,seq-cst ) < newLengthなら、TypeError 例外をthrowする。- fromBufをobj.[[ArrayBufferData]]とする。
- toBufをnew.[[ArrayBufferData]]とする。
CopyDataBlockBytes (toBuf, 0, fromBuf, first, newLength)を実行する。- newを返す。
25.2.5.7 SharedArrayBuffer.prototype [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
25.2.6 SharedArrayBuffer Instancesのプロパティ
SharedArrayBuffer instancesは
SharedArrayBuffer instancesは、ArrayBuffer instancesとは異なり、決してdetachedされない。
25.2.7 Growable SharedArrayBuffer Guidelines
以下は、
programsは、可能であればdeployment environmentsでtestedされることをrecommendする。available physical memoryの量はhardware devices間でgreatlyに異なる。同様に、virtual memory subsystemsもhardware devices間およびoperating systems間でgreatlyに異なる。64-bit desktop web browserでout-of-memory errorsなしにrunsするapplicationが、32-bit mobile web browserではout of memoryになる可能性がある。
particular maximum sizeの
u8[idx]）のbounds-checkingのためのlengthのloadsはsynchronizingではない。一般に、explicit synchronizationがない場合、あるproperty accessがin-boundであることは、同じlengthおよびbyteLength gettersを介したlengthのexplicit loadsはsynchronizingである。
以下は、
grow operationsは
Grown memoryは、そのcreationの瞬間から、parallelなracy accessesに対しても含めて、zeroedにappearしなければならない。これはzero-filled-on-demand virtual memory pages、またはmanualにzeroing memoryする場合はcareful synchronizationによってaccomplishedできる。
growable SharedArrayBuffersの
MMUのないembedded devices上でrunningする
25.3 DataViewオブジェクト
25.3.1 DataViewオブジェクトの抽象操作
25.3.1.1 DataView With Buffer Witness Records
DataView With Buffer Witness Recordは、viewed bufferのcached byte lengthとともにDataViewをencapsulateするために使用される
DataView With Buffer Witness Recordsは、
| Field Name | Value | Meaning |
|---|---|---|
| [[Object]] | a DataView | bufferのbyte lengthがloadedされるDataView object。 |
| [[CachedBufferByteLength]] |
a non-negative |
|
25.3.1.2 MakeDataViewWithBufferWitnessRecord ( obj, order )
The abstract operation MakeDataViewWithBufferWitnessRecord takes arguments obj (a DataView) and order (
- bufferをobj.[[ViewedArrayBuffer]]とする。
IsDetachedBuffer (buffer)がtrue なら、- byteLengthを
detached とする。
- byteLengthを
- そうでなければ、
- byteLengthを
ArrayBufferByteLength (buffer, order)とする。
- byteLengthを
DataView With Buffer Witness Record { [[Object]]: obj, [[CachedBufferByteLength]]: byteLength }を返す。
25.3.1.3 GetViewByteLength ( viewRecord )
The abstract operation GetViewByteLength takes argument viewRecord (a
Assert :IsViewOutOfBounds (viewRecord)はfalse である。- viewをviewRecord.[[Object]]とする。
- view.[[ByteLength]]が
auto でないなら、view.[[ByteLength]]を返す。 Assert :IsFixedLengthArrayBuffer (view.[[ViewedArrayBuffer]])はfalse である。- byteOffsetをview.[[ByteOffset]]とする。
- byteLengthをviewRecord.[[CachedBufferByteLength]]とする。
Assert : byteLengthはdetached でない。- byteLength - byteOffsetを返す。
25.3.1.4 IsViewOutOfBounds ( viewRecord )
The abstract operation IsViewOutOfBounds takes argument viewRecord (a
- viewをviewRecord.[[Object]]とする。
- bufferByteLengthをviewRecord.[[CachedBufferByteLength]]とする。
IsDetachedBuffer (view.[[ViewedArrayBuffer]])がtrue なら、Assert : bufferByteLengthはdetached である。true を返す。
Assert : bufferByteLengthはnon-negativeinteger である。- byteOffsetStartをview.[[ByteOffset]]とする。
- view.[[ByteLength]]が
auto なら、- byteOffsetEndをbufferByteLengthとする。
- そうでなければ、
- byteOffsetEndをbyteOffsetStart + view.[[ByteLength]]とする。
NOTE : [[ByteOffset]]がbufferByteLengthである0-length DataViewはout-of-boundsであるとはconsideredされない。- byteOffsetStart > bufferByteLengthまたはbyteOffsetEnd > bufferByteLengthなら、
true を返す。 false を返す。
25.3.1.5 GetViewValue ( view, requestIndex, isLittleEndian, type )
The abstract operation GetViewValue takes arguments view (an ECMAScript language value), requestIndex (an ECMAScript language value), isLittleEndian (an ECMAScript language value), and type (a
- ?
RequireInternalSlot (view, [[DataView]])を実行する。 Assert : viewは[[ViewedArrayBuffer]] internal slotを持つ。- getIndexを ?
ToIndex (requestIndex) とする。 - isLittleEndianを
ToBoolean (isLittleEndian)に設定する。 - viewOffsetをview.[[ByteOffset]]とする。
- viewRecordを
MakeDataViewWithBufferWitnessRecord (view,unordered )とする。 NOTE : viewのbacking bufferがgrowable SharedArrayBuffer である場合、Bounds checkingはsynchronizing operationではない。IsViewOutOfBounds (viewRecord)がtrue なら、TypeError 例外をthrowする。- viewSizeを
GetViewByteLength (viewRecord)とする。 - elementSizeを、Element Type typeについて
Table 71 でspecifiedされるElement Size valueとする。 - getIndex + elementSize > viewSizeなら、
RangeError 例外をthrowする。 - bufferIndexをgetIndex + viewOffsetとする。
GetValueFromBuffer (view.[[ViewedArrayBuffer]], bufferIndex, type,false ,unordered , isLittleEndian)を返す。
25.3.1.6 SetViewValue ( view, requestIndex, isLittleEndian, type, value )
The abstract operation SetViewValue takes arguments view (an ECMAScript language value), requestIndex (an ECMAScript language value), isLittleEndian (an ECMAScript language value), type (a
- ?
RequireInternalSlot (view, [[DataView]])を実行する。 Assert : viewは[[ViewedArrayBuffer]] internal slotを持つ。- getIndexを ?
ToIndex (requestIndex) とする。 IsBigIntElementType (type)がtrue なら、numberを ?ToBigInt (value) とする。- そうでなければ、numberを ?
ToNumber (value) とする。 - isLittleEndianを
ToBoolean (isLittleEndian)に設定する。 - viewOffsetをview.[[ByteOffset]]とする。
- viewRecordを
MakeDataViewWithBufferWitnessRecord (view,unordered )とする。 NOTE : viewのbacking bufferがgrowable SharedArrayBuffer である場合、Bounds checkingはsynchronizing operationではない。IsViewOutOfBounds (viewRecord)がtrue なら、TypeError 例外をthrowする。- viewSizeを
GetViewByteLength (viewRecord)とする。 - elementSizeを、Element Type typeについて
Table 71 でspecifiedされるElement Size valueとする。 - getIndex + elementSize > viewSizeなら、
RangeError 例外をthrowする。 - bufferIndexをgetIndex + viewOffsetとする。
SetValueInBuffer (view.[[ViewedArrayBuffer]], bufferIndex, type, number,false ,unordered , isLittleEndian)を実行する。undefined を返す。
25.3.2 DataView Constructor
DataView
- %DataView%である。
global object の"DataView" propertyのinitial valueである。constructor として呼び出されたとき、新しいDataViewをcreateしてinitializeする。- functionとして呼び出されることは意図されておらず、そのように呼び出された場合はexceptionをthrowする。
- クラス定義の
extends句の値として使用できる。指定された DataView の動作を継承しようとするサブクラスコンストラクターは、DataView.prototypeの組み込みメソッドをサポートするために必要な内部状態でサブクラスインスタンスを作成し初期化するため、DataView コンストラクターへのsuper呼び出しを含めなければならない。
25.3.2.1 DataView ( buffer [ , byteOffset [ , byteLength ] ] )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- NewTargetが
undefined なら、TypeError 例外をthrowする。 - ?
RequireInternalSlot (buffer, [[ArrayBufferData]])を実行する。 - offsetを ?
ToIndex (byteOffset) とする。 IsDetachedBuffer (buffer)がtrue なら、TypeError 例外をthrowする。- bufferByteLengthを
ArrayBufferByteLength (buffer,seq-cst )とする。 - offset > bufferByteLengthなら、
RangeError 例外をthrowする。 - bufferIsFixedLengthを
IsFixedLengthArrayBuffer (buffer)とする。 - byteLengthが
undefined なら、- bufferIsFixedLengthが
true なら、- viewByteLengthをbufferByteLength - offsetとする。
- そうでなければ、
- viewByteLengthを
auto とする。
- viewByteLengthを
- bufferIsFixedLengthが
- そうでなければ、
- viewByteLengthを ?
ToIndex (byteLength) とする。 - offset + viewByteLength > bufferByteLengthなら、
RangeError 例外をthrowする。
- viewByteLengthを ?
- objを ?
OrdinaryCreateFromConstructor (NewTarget,"%DataView.prototype%" , « [[DataView]], [[ViewedArrayBuffer]], [[ByteLength]], [[ByteOffset]] ») とする。 IsDetachedBuffer (buffer)がtrue なら、TypeError 例外をthrowする。- bufferByteLengthを
ArrayBufferByteLength (buffer,seq-cst )に設定する。 - offset > bufferByteLengthなら、
RangeError 例外をthrowする。 - byteLengthが
undefined でないなら、- offset + viewByteLength > bufferByteLengthなら、
RangeError 例外をthrowする。
- offset + viewByteLength > bufferByteLengthなら、
- obj.[[ViewedArrayBuffer]]をbufferに設定する。
- obj.[[ByteLength]]をviewByteLengthに設定する。
- obj.[[ByteOffset]]をoffsetに設定する。
- objを返す。
25.3.3 DataView Constructorのプロパティ
DataView
- valueが
%Function.prototype% である[[Prototype]] internal slotを持つ。 - 以下のpropertiesを持つ：
25.3.3.1 DataView.prototype
DataView.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
25.3.4 DataView Prototype Objectのプロパティ
DataView prototype objectは：
- %DataView.prototype%である。
- valueが
%Object.prototype% である[[Prototype]] internal slotを持つ。 ordinary object である。- [[DataView]], [[ViewedArrayBuffer]], [[ByteLength]], または[[ByteOffset]] internal slotを持たない。
25.3.4.1 get DataView.prototype.buffer
DataView.prototype.bufferは、set accessor functionが
- objを
this valueとする。 - ?
RequireInternalSlot (obj, [[DataView]])を実行する。 Assert : objは[[ViewedArrayBuffer]] internal slotを持つ。- bufferをobj.[[ViewedArrayBuffer]]とする。
- bufferを返す。
25.3.4.2 get DataView.prototype.byteLength
DataView.prototype.byteLengthは、set accessor functionが
- objを
this valueとする。 - ?
RequireInternalSlot (obj, [[DataView]])を実行する。 Assert : objは[[ViewedArrayBuffer]] internal slotを持つ。- viewRecordを
MakeDataViewWithBufferWitnessRecord (obj,seq-cst )とする。 IsViewOutOfBounds (viewRecord)がtrue なら、TypeError 例外をthrowする。- sizeを
GetViewByteLength (viewRecord)とする。 𝔽 (size)を返す。
25.3.4.3 get DataView.prototype.byteOffset
DataView.prototype.byteOffsetは、set accessor functionが
- objを
this valueとする。 - ?
RequireInternalSlot (obj, [[DataView]])を実行する。 Assert : objは[[ViewedArrayBuffer]] internal slotを持つ。- viewRecordを
MakeDataViewWithBufferWitnessRecord (obj,seq-cst )とする。 IsViewOutOfBounds (viewRecord)がtrue なら、TypeError 例外をthrowする。- offsetをobj.[[ByteOffset]]とする。
𝔽 (offset)を返す。
25.3.4.4 DataView.prototype.constructor
DataView.prototype.constructorのinitial valueは
25.3.4.5 DataView.prototype.getBigInt64 ( byteOffset [ , littleEndian ] )
このmethodは、呼び出されたときに以下のstepsを実行する：
- viewを
this valueとする。 - ?
GetViewValue (view, byteOffset, littleEndian,bigint64 )を返す。
25.3.4.6 DataView.prototype.getBigUint64 ( byteOffset [ , littleEndian ] )
このmethodは、呼び出されたときに以下のstepsを実行する：
- viewを
this valueとする。 - ?
GetViewValue (view, byteOffset, littleEndian,biguint64 )を返す。
25.3.4.7 DataView.prototype.getFloat16 ( byteOffset [ , littleEndian ] )
このmethodは、呼び出されたときに以下のstepsを実行する：
- viewを
this valueとする。 - littleEndianがpresentでないなら、littleEndianを
false に設定する。 - ?
GetViewValue (view, byteOffset, littleEndian,float16 )を返す。
25.3.4.8 DataView.prototype.getFloat32 ( byteOffset [ , littleEndian ] )
このmethodは、呼び出されたときに以下のstepsを実行する：
- viewを
this valueとする。 - littleEndianがpresentでないなら、littleEndianを
false に設定する。 - ?
GetViewValue (view, byteOffset, littleEndian,float32 )を返す。
25.3.4.9 DataView.prototype.getFloat64 ( byteOffset [ , littleEndian ] )
このmethodは、呼び出されたときに以下のstepsを実行する：
- viewを
this valueとする。 - littleEndianがpresentでないなら、littleEndianを
false に設定する。 - ?
GetViewValue (view, byteOffset, littleEndian,float64 )を返す。
25.3.4.10 DataView.prototype.getInt8 ( byteOffset )
このmethodは、呼び出されたときに以下のstepsを実行する：
- viewを
this valueとする。 - ?
GetViewValue (view, byteOffset,true ,int8 )を返す。
25.3.4.11 DataView.prototype.getInt16 ( byteOffset [ , littleEndian ] )
このmethodは、呼び出されたときに以下のstepsを実行する：
- viewを
this valueとする。 - littleEndianがpresentでないなら、littleEndianを
false に設定する。 - ?
GetViewValue (view, byteOffset, littleEndian,int16 )を返す。
25.3.4.12 DataView.prototype.getInt32 ( byteOffset [ , littleEndian ] )
このmethodは、呼び出されたときに以下のstepsを実行する：
- viewを
this valueとする。 - littleEndianがpresentでないなら、littleEndianを
false に設定する。 - ?
GetViewValue (view, byteOffset, littleEndian,int32 )を返す。
25.3.4.13 DataView.prototype.getUint8 ( byteOffset )
このmethodは、呼び出されたときに以下のstepsを実行する：
- viewを
this valueとする。 - ?
GetViewValue (view, byteOffset,true ,uint8 )を返す。
25.3.4.14 DataView.prototype.getUint16 ( byteOffset [ , littleEndian ] )
このmethodは、呼び出されたときに以下のstepsを実行する：
- viewを
this valueとする。 - littleEndianがpresentでないなら、littleEndianを
false に設定する。 - ?
GetViewValue (view, byteOffset, littleEndian,uint16 )を返す。
25.3.4.15 DataView.prototype.getUint32 ( byteOffset [ , littleEndian ] )
このmethodは、呼び出されたときに以下のstepsを実行する：
- viewを
this valueとする。 - littleEndianがpresentでないなら、littleEndianを
false に設定する。 - ?
GetViewValue (view, byteOffset, littleEndian,uint32 )を返す。
25.3.4.16 DataView.prototype.setBigInt64 ( byteOffset, value [ , littleEndian ] )
このmethodは、呼び出されたときに以下のstepsを実行する：
- viewを
this valueとする。 - ?
SetViewValue (view, byteOffset, littleEndian,bigint64 , value)を返す。
25.3.4.17 DataView.prototype.setBigUint64 ( byteOffset, value [ , littleEndian ] )
このmethodは、呼び出されたときに以下のstepsを実行する：
- viewを
this valueとする。 - ?
SetViewValue (view, byteOffset, littleEndian,biguint64 , value)を返す。
25.3.4.18 DataView.prototype.setFloat16 ( byteOffset, value [ , littleEndian ] )
このmethodは、呼び出されたときに以下のstepsを実行する：
- viewを
this valueとする。 - littleEndianがpresentでないなら、littleEndianを
false に設定する。 - ?
SetViewValue (view, byteOffset, littleEndian,float16 , value)を返す。
25.3.4.19 DataView.prototype.setFloat32 ( byteOffset, value [ , littleEndian ] )
このmethodは、呼び出されたときに以下のstepsを実行する：
- viewを
this valueとする。 - littleEndianがpresentでないなら、littleEndianを
false に設定する。 - ?
SetViewValue (view, byteOffset, littleEndian,float32 , value)を返す。
25.3.4.20 DataView.prototype.setFloat64 ( byteOffset, value [ , littleEndian ] )
このmethodは、呼び出されたときに以下のstepsを実行する：
- viewを
this valueとする。 - littleEndianがpresentでないなら、littleEndianを
false に設定する。 - ?
SetViewValue (view, byteOffset, littleEndian,float64 , value)を返す。
25.3.4.21 DataView.prototype.setInt8 ( byteOffset, value )
このmethodは、呼び出されたときに以下のstepsを実行する：
- viewを
this valueとする。 - ?
SetViewValue (view, byteOffset,true ,int8 , value)を返す。
25.3.4.22 DataView.prototype.setInt16 ( byteOffset, value [ , littleEndian ] )
このmethodは、呼び出されたときに以下のstepsを実行する：
- viewを
this valueとする。 - littleEndianがpresentでないなら、littleEndianを
false に設定する。 - ?
SetViewValue (view, byteOffset, littleEndian,int16 , value)を返す。
25.3.4.23 DataView.prototype.setInt32 ( byteOffset, value [ , littleEndian ] )
このmethodは、呼び出されたときに以下のstepsを実行する：
- viewを
this valueとする。 - littleEndianがpresentでないなら、littleEndianを
false に設定する。 - ?
SetViewValue (view, byteOffset, littleEndian,int32 , value)を返す。
25.3.4.24 DataView.prototype.setUint8 ( byteOffset, value )
このmethodは、呼び出されたときに以下のstepsを実行する：
- viewを
this valueとする。 - ?
SetViewValue (view, byteOffset,true ,uint8 , value)を返す。
25.3.4.25 DataView.prototype.setUint16 ( byteOffset, value [ , littleEndian ] )
このmethodは、呼び出されたときに以下のstepsを実行する：
- viewを
this valueとする。 - littleEndianがpresentでないなら、littleEndianを
false に設定する。 - ?
SetViewValue (view, byteOffset, littleEndian,uint16 , value)を返す。
25.3.4.26 DataView.prototype.setUint32 ( byteOffset, value [ , littleEndian ] )
このmethodは、呼び出されたときに以下のstepsを実行する：
- viewを
this valueとする。 - littleEndianがpresentでないなら、littleEndianを
false に設定する。 - ?
SetViewValue (view, byteOffset, littleEndian,uint32 , value)を返す。
25.3.4.27 DataView.prototype [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
25.3.5 DataView Instancesのプロパティ
DataView instancesは
[[DataView]] internal slotのvalueは、この仕様内では使用されない。そのinternal slotのsimple presenceが、DataView
25.4 Atomicsオブジェクト
Atomicsオブジェクトは：
- %Atomics%である。
global object の"Atomics" propertyのinitial valueである。ordinary object である。- valueが
%Object.prototype% である[[Prototype]] internal slotを持つ。 - [[Construct]] internal methodを持たない；
newoperatorでconstructor として使用できない。 - [[Call]] internal methodを持たない；functionとしてinvokeできない。
Atomicsオブジェクトは、shared memory array cells上でindivisibly（atomically）にoperateするfunctionsと、
ECMAScriptでshared memoryをprogrammingおよびimplementingするためのinformative guidelinesについては、
25.4.1 Waiter Record
Waiter Recordは、Atomics.waitまたはAtomics.waitAsyncへのparticular callをdenoteするために使用される
Waiter Recordは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[AgentSignifier]] |
an |
Atomics.waitまたはAtomics.waitAsyncをcalledした |
| [[PromiseCapability]] |
a |
Atomics.waitAsyncへのcallをdenoteする場合はresulting promise、そうでなければ |
| [[TimeoutTime]] |
a non-negative |
timeoutがtriggerされ得る最も早い時刻； |
| [[Result]] |
|
callのreturn value。 |
25.4.2 WaiterList Records
WaiterList Recordは、Atomics.wait、Atomics.waitAsync、およびAtomics.notifyを介する
WaiterList Recordは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Waiters]] |
a |
このWaiterListがassociatedされるlocation上でwaitingしている、Atomics.waitまたはAtomics.waitAsyncへのcalls。
|
| [[MostRecentLeaveEvent]] |
a |
その |
同じ
各WaiterList Recordは、evaluation中にそのWaiterList Recordへのexclusive accessをcontrolするcritical sectionを持つ。一度にsingle
25.4.3 Atomicsの抽象操作
25.4.3.1 ValidateIntegerTypedArray ( ta, waitable )
The abstract operation ValidateIntegerTypedArray takes arguments ta (an ECMAScript language value) and waitable (a Boolean) and returns either a
- taRecordを ?
ValidateTypedArray (ta,unordered ) とする。 NOTE : taのbacking bufferがgrowable SharedArrayBuffer である場合、Bounds checkingはsynchronizing operationではない。- waitableが
true なら、- ta.[[TypedArrayName]]が
"Int32Array" でも"BigInt64Array" でもないなら、TypeError 例外をthrowする。
- ta.[[TypedArrayName]]が
- そうでなければ、
- typeを
TypedArrayElementType (ta)とする。 IsUnclampedIntegerElementType (type)がfalse であり、かつIsBigIntElementType (type)がfalse なら、TypeError 例外をthrowする。
- typeを
- taRecordを返す。
25.4.3.2 ValidateAtomicAccess ( taRecord, requestIndex )
The abstract operation ValidateAtomicAccess takes arguments taRecord (a
- lengthを
TypedArrayLength (taRecord)とする。 - accessIndexを ?
ToIndex (requestIndex) とする。 Assert : accessIndex ≥ 0である。- accessIndex ≥ lengthなら、
RangeError 例外をthrowする。 - taをtaRecord.[[Object]]とする。
- elementSizeを
TypedArrayElementSize (ta)とする。 - offsetをta.[[ByteOffset]]とする。
- (accessIndex × elementSize) + offsetを返す。
25.4.3.3 ValidateAtomicAccessOnIntegerTypedArray ( ta, requestIndex )
The abstract operation ValidateAtomicAccessOnIntegerTypedArray takes arguments ta (an ECMAScript language value) and requestIndex (an ECMAScript language value) and returns either a
- taRecordを ?
ValidateIntegerTypedArray (ta,false ) とする。 - ?
ValidateAtomicAccess (taRecord, requestIndex)を返す。
25.4.3.4 RevalidateAtomicAccess ( ta, byteIndexInBuffer )
The abstract operation RevalidateAtomicAccess takes arguments ta (a
- taRecordを
MakeTypedArrayWithBufferWitnessRecord (ta,unordered )とする。 NOTE : taのbacking bufferがgrowable SharedArrayBuffer である場合、Bounds checkingはsynchronizing operationではない。IsTypedArrayOutOfBounds (taRecord)がtrue なら、TypeError 例外をthrowする。Assert : byteIndexInBuffer ≥ ta.[[ByteOffset]]である。- byteIndexInBuffer ≥ taRecord.[[CachedBufferByteLength]]なら、
RangeError 例外をthrowする。 unused を返す。
25.4.3.5 GetWaiterList ( block, i )
The abstract operation GetWaiterList takes arguments block (a
Assert : iおよびi + 3はblockのmemory内のvalid byte offsetsである。- pair (block, i)によってreferencedされる
WaiterList Record を返す。
25.4.3.6 EnterCriticalSection ( waiterList )
The abstract operation EnterCriticalSection takes argument waiterList (a
Assert :surrounding agent はいかなるWaiterList Record についてもcritical section 内にいない。- waiterListの
critical section 内にagent がいなくなるまでwaitし、その後waiterListのcritical section にenterする（他のagent がenterすることをallowせずに）。 - waiterList.[[MostRecentLeaveEvent]]が
empty でないなら、NOTE : 少なくとも一度critical section にenteredされたwaiterListは、LeaveCriticalSection によってsetされたSynchronize event を持つ。- agentRecordを
surrounding agent のAgent Record とする。 - executionをagentRecord.[[CandidateExecution]]とする。
- eventsRecordを、execution.[[EventsRecords]]のうち[[AgentSignifier]]が
AgentSignifier ()であるAgent Events Record とする。 - enterEventをnew
Synchronize event とする。 - enterEventをeventsRecord.[[EventList]]にappendする。
- (waiterList.[[MostRecentLeaveEvent]], enterEvent)をeventsRecord.[[AgentSynchronizesWith]]にappendする。
unused を返す。
EnterCriticalSectionは、
25.4.3.7 LeaveCriticalSection ( waiterList )
The abstract operation LeaveCriticalSection takes argument waiterList (a
Assert :surrounding agent はwaiterListのcritical section 内にいる。- agentRecordを
surrounding agent のAgent Record とする。 - executionをagentRecord.[[CandidateExecution]]とする。
- eventsRecordを、execution.[[EventsRecords]]のうち[[AgentSignifier]]が
AgentSignifier ()であるAgent Events Record とする。 - leaveEventをnew
Synchronize event とする。 - leaveEventをeventsRecord.[[EventList]]にappendする。
- waiterList.[[MostRecentLeaveEvent]]をleaveEventに設定する。
- waiterListの
critical section をleaveする。 unused を返す。
25.4.3.8 AddWaiter ( waiterList, waiterRecord )
The abstract operation AddWaiter takes arguments waiterList (a
Assert :surrounding agent はwaiterListのcritical section 内にいる。Assert : waiterList.[[Waiters]]内に、[[PromiseCapability]] fieldがwaiterRecord.[[PromiseCapability]]であり、かつ[[AgentSignifier]] fieldがwaiterRecord.[[AgentSignifier]]であるWaiter Record は存在しない。- waiterRecordをwaiterList.[[Waiters]]にappendする。
unused を返す。
25.4.3.9 RemoveWaiter ( waiterList, waiterRecord )
The abstract operation RemoveWaiter takes arguments waiterList (a
Assert :surrounding agent はwaiterListのcritical section 内にいる。Assert : waiterList.[[Waiters]]はwaiterRecordを含む。- waiterRecordをwaiterList.[[Waiters]]からremoveする。
unused を返す。
25.4.3.10 RemoveWaiters ( waiterList, count )
The abstract operation RemoveWaiters takes arguments waiterList (a
Assert :surrounding agent はwaiterListのcritical section 内にいる。- lengthをwaiterList.[[Waiters]]内のelementsのnumberとする。
- countを
min (count, length)に設定する。 - waitersを、elementsがwaiterList.[[Waiters]]のfirst count elementsである
List とする。 - waiterList.[[Waiters]]のfirst count elementsをremoveする。
- waitersを返す。
25.4.3.11 SuspendThisAgent ( waiterList, waiterRecord )
The abstract operation SuspendThisAgent takes arguments waiterList (a
Assert :surrounding agent はwaiterListのcritical section 内にいる。Assert : waiterList.[[Waiters]]はwaiterRecordを含む。- thisAgentを
AgentSignifier ()とする。 Assert : waiterRecord.[[AgentSignifier]]はthisAgentである。Assert : waiterRecord.[[PromiseCapability]]はblocking である。Assert :AgentCanSuspend ()はtrue である。LeaveCriticalSection (waiterList)を実行し、時刻がwaiterRecord.[[TimeoutTime]]になるまでsurrounding agent をsuspendする。critical section をexitedした後で、suspensionがtake effectする前にarrivesするnotificationがlostされないように、combined operationをperformする。surrounding agent は、timeoutによって、または別のagent がarguments waiterListおよびthisAgentでNotifyWaiter をcallingすること（すなわちAtomics.notifyへのcallを介すること）によってのみ、suspensionからwakeできる。EnterCriticalSection (waiterList)を実行する。unused を返す。
25.4.3.12 NotifyWaiter ( waiterList, waiterRecord )
The abstract operation NotifyWaiter takes arguments waiterList (a
Assert :surrounding agent はwaiterListのcritical section 内にいる。- waiterRecord.[[PromiseCapability]]が
blocking なら、- signifierがwaiterRecord.[[AgentSignifier]]である
agent をsuspensionからwakeする。 NOTE : これは、agent がSuspendThisAgent 内でexecutionをresumeすることをcauseする。
- signifierがwaiterRecord.[[AgentSignifier]]である
- そうでなく、
AgentSignifier ()がwaiterRecord.[[AgentSignifier]]であるなら、- promiseCapabilityをwaiterRecord.[[PromiseCapability]]とする。
- !
Call (promiseCapability.[[Resolve]],undefined , « waiterRecord.[[Result]] »)を実行する。
- そうでなければ、
EnqueueResolveInAgentJob (waiterRecord.[[AgentSignifier]], waiterRecord.[[PromiseCapability]], waiterRecord.[[Result]])を実行する。
unused を返す。
25.4.3.13 EnqueueResolveInAgentJob ( agentSignifier, promiseCapability, resolution )
The abstract operation EnqueueResolveInAgentJob takes arguments agentSignifier (an
- resolveJobを、parametersを持たず、agentSignifier、promiseCapability、およびresolutionをcapturesし、calledされたときに以下のstepsを実行するnew
Job Abstract Closure とする：Assert :AgentSignifier ()はagentSignifierである。- !
Call (promiseCapability.[[Resolve]],undefined , « resolution »)を実行する。 unused を返す。
- realmInTargetAgentを !
GetFunctionRealm (promiseCapability.[[Resolve]]) とする。 Assert : agentSignifierはrealmInTargetAgent.[[AgentSignifier]]である。HostEnqueueGenericJob (resolveJob, realmInTargetAgent)を実行する。unused を返す。
25.4.3.14 DoWait ( mode, ta, index, value, timeout )
The abstract operation DoWait takes arguments mode (
- taRecordを ?
ValidateIntegerTypedArray (ta,true ) とする。 - bufferをtaRecord.[[Object]].[[ViewedArrayBuffer]]とする。
IsSharedArrayBuffer (buffer)がfalse なら、TypeError 例外をthrowする。- byteIndexInBufferを ?
ValidateAtomicAccess (taRecord, index) とする。 - arrayTypeNameをta.[[TypedArrayName]]とする。
- arrayTypeNameが
"BigInt64Array" なら、expectedを ?ToBigInt64 (value) とする。 - そうでなければ、expectedを ?
ToInt32 (value) とする。 - timeoutNumberを ?
ToNumber (timeout) とする。 - timeoutNumberが
NaN または+∞ 𝔽のいずれかなら、realTimeoutを+∞とする。 - そうでなく、timeoutNumberが
-∞ 𝔽なら、realTimeoutを0とする。 - そうでなければ、realTimeoutを
max (ℝ (timeoutNumber), 0)とする。 - modeが
sync であり、AgentCanSuspend ()がfalse なら、TypeError 例外をthrowする。 - blockをbuffer.[[ArrayBufferData]]とする。
- waiterListを
GetWaiterList (block, byteIndexInBuffer)とする。 - modeが
sync なら、- promiseCapabilityを
blocking とする。 - resultObjを
undefined とする。
- promiseCapabilityを
- そうでなければ、
- promiseCapabilityを !
NewPromiseCapability (%Promise% ) とする。 - resultObjを
OrdinaryObjectCreate (%Object.prototype% )とする。
- promiseCapabilityを !
EnterCriticalSection (waiterList)を実行する。- elementTypeを
TypedArrayElementType (ta)とする。 - witnessを
GetValueFromBuffer (buffer, byteIndexInBuffer, elementType,true ,seq-cst )とする。 - expected ≠ witnessなら、
LeaveCriticalSection (waiterList)を実行する。- modeが
sync なら、"not-equal" を返す。 - !
CreateDataPropertyOrThrow (resultObj,"async" ,false )を実行する。 - !
CreateDataPropertyOrThrow (resultObj,"value" ,"not-equal" )を実行する。 - resultObjを返す。
- realTimeout = 0かつmodeが
async なら、NOTE : synchronous immediate timeoutsにspecial handlingはない。Asynchronous immediate timeoutsは、fail fastし、unnecessary Promise jobsをavoidするためにspecial handlingを持つ。LeaveCriticalSection (waiterList)を実行する。- !
CreateDataPropertyOrThrow (resultObj,"async" ,false )を実行する。 - !
CreateDataPropertyOrThrow (resultObj,"value" ,"timed-out" )を実行する。 - resultObjを返す。
- thisAgentを
AgentSignifier ()とする。 - nowをcurrent timeをidentifyingする
time value (UTC)とする。 - additionalTimeoutを
implementation-defined non-negativemathematical value とする。 - timeoutTimeを
ℝ (now) + realTimeout + additionalTimeoutとする。 NOTE : realTimeoutが+∞である場合、timeoutTimeも+∞である。- waiterRecordをnew
Waiter Record { [[AgentSignifier]]: thisAgent, [[PromiseCapability]]: promiseCapability, [[TimeoutTime]]: timeoutTime, [[Result]]:"ok" }とする。 AddWaiter (waiterList, waiterRecord)を実行する。- modeが
sync なら、SuspendThisAgent (waiterList, waiterRecord)を実行する。
- そうでなく、timeoutTimeが
finite なら、EnqueueAtomicsWaitAsyncTimeoutJob (waiterList, waiterRecord)を実行する。
LeaveCriticalSection (waiterList)を実行する。- modeが
sync なら、waiterRecord.[[Result]]を返す。 - !
CreateDataPropertyOrThrow (resultObj,"async" ,true )を実行する。 - !
CreateDataPropertyOrThrow (resultObj,"value" , promiseCapability.[[Promise]])を実行する。 - resultObjを返す。
additionalTimeoutは、power consumptionのreducingやtiming attacksをmitigateするためのtimer resolutionのcoarseningなど、必要に応じてimplementationsがtimeoutsをpadすることを可能にする。このvalueはDoWaitのcallごとに異なってもよい。
25.4.3.15 EnqueueAtomicsWaitAsyncTimeoutJob ( waiterList, waiterRecord )
The abstract operation EnqueueAtomicsWaitAsyncTimeoutJob takes arguments waiterList (a
- timeoutJobを、parametersを持たず、waiterListおよびwaiterRecordをcapturesし、calledされたときに以下のstepsを実行するnew
Job Abstract Closure とする：EnterCriticalSection (waiterList)を実行する。- waiterList.[[Waiters]]がwaiterRecordを含むなら、
- timeOfJobExecutionをcurrent timeをidentifyingする
time value (UTC)とする。 Assert :ℝ (timeOfJobExecution) ≥ waiterRecord.[[TimeoutTime]]である（time values のpotential non-monotonicityをignoringする）。- waiterRecord.[[Result]]を
"timed-out" に設定する。 RemoveWaiter (waiterList, waiterRecord)を実行する。NotifyWaiter (waiterList, waiterRecord)を実行する。
- timeOfJobExecutionをcurrent timeをidentifyingする
LeaveCriticalSection (waiterList)を実行する。unused を返す。
- nowをcurrent timeをidentifyingする
time value (UTC)とする。 - currentRealmを
current Realm Record とする。 HostEnqueueTimeoutJob (timeoutJob, currentRealm,𝔽 (waiterRecord.[[TimeoutTime]]) - now)を実行する。unused を返す。
25.4.3.16 AtomicCompareExchangeInSharedBlock ( block, byteIndexInBuffer, elementSize, expectedBytes, replacementBytes )
The abstract operation AtomicCompareExchangeInSharedBlock takes arguments block (a
- agentRecordを
surrounding agent のAgent Record とする。 - executionをagentRecord.[[CandidateExecution]]とする。
- eventsRecordを、execution.[[EventsRecords]]のうち[[AgentSignifier]]が
AgentSignifier ()であるAgent Events Record とする。 - rawBytesReadを、elementsがnondeterministicallyにchosenされた
byte values であるlength elementSizeのList とする。 NOTE : implementationsにおいて、rawBytesReadはunderlying hardware上のload-link、load-exclusive、またはread-modify-write instructionのoperandのresultである。nondeterminismは、weak consistencyを持つhardwareのobservable behaviourをdescribeするためのmemory model のsemantic prescriptionである。NOTE : expected valueとread valueのcomparisonは、expected valueがread valueとequalでない場合にneedlessly strong synchronizationをavoidするため、read-modify-write modification function の外側でperformedされる。ByteListEqual (rawBytesRead, expectedBytes)がtrue なら、- secondを、parameters (oldBytes, newBytes)を持ち、nothingをcapturesし、calledされたときに以下のstepsをatomicallyに実行するnew
read-modify-write modification function とする：- newBytesを返す。
- eventを
ReadModifyWriteSharedMemory { [[Order]]:seq-cst , [[NoTear]]:true , [[Block]]: block, [[ByteIndex]]: byteIndexInBuffer, [[ElementSize]]: elementSize, [[Payload]]: replacementBytes, [[ModifyOp]]: second }とする。
- secondを、parameters (oldBytes, newBytes)を持ち、nothingをcapturesし、calledされたときに以下のstepsをatomicallyに実行するnew
- そうでなければ、
- eventを
ReadSharedMemory { [[Order]]:seq-cst , [[NoTear]]:true , [[Block]]: block, [[ByteIndex]]: byteIndexInBuffer, [[ElementSize]]: elementSize }とする。
- eventを
- eventをeventsRecord.[[EventList]]にappendする。
Chosen Value Record { [[Event]]: event, [[ChosenValue]]: rawBytesRead }をexecution.[[ChosenValues]]にappendする。- rawBytesReadを返す。
25.4.3.17 AtomicReadModifyWrite ( ta, index, value, op )
The abstract operation AtomicReadModifyWrite takes arguments ta (an ECMAScript language value), index (an ECMAScript language value), value (an ECMAScript language value), and op (a
- byteIndexInBufferを ?
ValidateAtomicAccessOnIntegerTypedArray (ta, index) とする。 - ta.[[ContentType]]が
bigint なら、coercedを ?ToBigInt (value) とする。 - そうでなければ、coercedを
𝔽 (?ToIntegerOrInfinity (value))とする。 - ?
RevalidateAtomicAccess (ta, byteIndexInBuffer)を実行する。 - bufferをta.[[ViewedArrayBuffer]]とする。
- elementTypeを
TypedArrayElementType (ta)とする。 GetModifySetValueInBuffer (buffer, byteIndexInBuffer, elementType, coerced, op)を返す。
25.4.3.18 ByteListBitwiseOp ( op, xBytes, yBytes )
The abstract operation ByteListBitwiseOp takes arguments op (&, ^, or |), xBytes (a
Assert : xBytesとyBytesは同じnumberのelementsを持つ。- resultをnew empty
List とする。 - iを0とする。
- xBytesの各element xByteについて、
- yByteをyBytes[i]とする。
- opが
&なら、- resultByteを、xByteとyByteにbitwise AND operationをapplyingしたresultとする。
- そうでなく、opが
^なら、- resultByteを、xByteとyByteにbitwise exclusive OR (XOR) operationをapplyingしたresultとする。
- そうでなければ、
Assert : opは|である。- resultByteを、xByteとyByteにbitwise inclusive OR operationをapplyingしたresultとする。
- iをi + 1に設定する。
- resultByteをresultにappendする。
- resultを返す。
25.4.3.19 ByteListEqual ( xBytes, yBytes )
The abstract operation ByteListEqual takes arguments xBytes (a
- xBytesとyBytesが同じnumberのelementsを持たないなら、
false を返す。 - iを0とする。
- xBytesの各element xByteについて、
- yByteをyBytes[i]とする。
- xByte ≠ yByteなら、
false を返す。 - iをi + 1に設定する。
true を返す。
25.4.4 Atomics.add ( ta, index, value )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- addを、parameters (xBytes, yBytes)を持ち、taをcapturesし、calledされたときに以下のstepsをatomicallyに実行するnew
read-modify-write modification function とする：- typeを
TypedArrayElementType (ta)とする。 - agentRecordを
surrounding agent のAgent Record とする。 - isLittleEndianをagentRecord.[[LittleEndian]]とする。
- xを
RawBytesToNumeric (type, xBytes, isLittleEndian)とする。 - yを
RawBytesToNumeric (type, yBytes, isLittleEndian)とする。 - xがNumberなら、
- sumを
Number::add (x, y)とする。
- sumを
- そうでなければ、
Assert : xはBigIntである。- sumを
BigInt::add (x, y)とする。
- sumBytesを
NumericToRawBytes (type, sum, isLittleEndian)とする。 Assert : sumBytes、xBytes、およびyBytesは同じnumberのelementsを持つ。- sumBytesを返す。
- typeを
- ?
AtomicReadModifyWrite (ta, index, value, add)を返す。
25.4.5 Atomics.and ( ta, index, value )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- andを、parameters (xBytes, yBytes)を持ち、nothingをcapturesし、calledされたときに以下のstepsをatomicallyに実行するnew
read-modify-write modification function とする：ByteListBitwiseOp (&, xBytes, yBytes)を返す。
- ?
AtomicReadModifyWrite (ta, index, value, and)を返す。
25.4.6 Atomics.compareExchange ( ta, index, expectedValue, replacementValue )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- byteIndexInBufferを ?
ValidateAtomicAccessOnIntegerTypedArray (ta, index) とする。 - bufferをta.[[ViewedArrayBuffer]]とする。
- blockをbuffer.[[ArrayBufferData]]とする。
- ta.[[ContentType]]が
bigint なら、 - そうでなければ、
- expectedを
𝔽 (?ToIntegerOrInfinity (expectedValue))とする。 - replacementを
𝔽 (?ToIntegerOrInfinity (replacementValue))とする。
- expectedを
- ?
RevalidateAtomicAccess (ta, byteIndexInBuffer)を実行する。 - elementTypeを
TypedArrayElementType (ta)とする。 - elementSizeを
TypedArrayElementSize (ta)とする。 - agentRecordを
surrounding agent のAgent Record とする。 - isLittleEndianをagentRecord.[[LittleEndian]]とする。
- expectedBytesを
NumericToRawBytes (elementType, expected, isLittleEndian)とする。 - replacementBytesを
NumericToRawBytes (elementType, replacement, isLittleEndian)とする。 IsSharedArrayBuffer (buffer)がtrue なら、- rawBytesReadを
AtomicCompareExchangeInSharedBlock (block, byteIndexInBuffer, elementSize, expectedBytes, replacementBytes)とする。
- rawBytesReadを
- そうでなければ、
- rawBytesReadを、elementsがblock[byteIndexInBuffer]でstartingするelementSize bytesのsequenceであるlength elementSizeの
List とする。 ByteListEqual (rawBytesRead, expectedBytes)がtrue なら、- replacementBytesのindividual bytesをblockに、block[byteIndexInBuffer]からstartingしてstoreする。
- rawBytesReadを、elementsがblock[byteIndexInBuffer]でstartingするelementSize bytesのsequenceであるlength elementSizeの
RawBytesToNumeric (elementType, rawBytesRead, isLittleEndian)を返す。
25.4.7 Atomics.exchange ( ta, index, value )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- secondを、parameters (oldBytes, newBytes)を持ち、nothingをcapturesし、calledされたときに以下のstepsをatomicallyに実行するnew
read-modify-write modification function とする：- newBytesを返す。
- ?
AtomicReadModifyWrite (ta, index, value, second)を返す。
25.4.8 Atomics.isLockFree ( size )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- nを ?
ToIntegerOrInfinity (size) とする。 - agentRecordを
surrounding agent のAgent Record とする。 - n = 1なら、agentRecord.[[IsLockFree1]]を返す。
- n = 2なら、agentRecord.[[IsLockFree2]]を返す。
- n = 4なら、
true を返す。 - n = 8なら、agentRecord.[[IsLockFree8]]を返す。
false を返す。
このfunctionはoptimization primitiveである。その直観は、size n bytesのdatum上のatomic primitive（compareExchange、load、store、add、sub、and、or、xor、またはexchange）のatomic stepが、Atomics.isLockFree(n)は
Atomics.isLockFree(4)は、すべてのknown relevant hardwareでsupportできるため、常に
このfunctionによってreturnedされるvalueに関わらず、すべてのatomic operationsはatomicであることがguaranteedされる。例えば、それらはoperationの途中でvisible operationがtake placeすること（例：“tearing”）は決してない。
25.4.9 Atomics.load ( ta, index )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- byteIndexInBufferを ?
ValidateAtomicAccessOnIntegerTypedArray (ta, index) とする。 - ?
RevalidateAtomicAccess (ta, byteIndexInBuffer)を実行する。 - bufferをta.[[ViewedArrayBuffer]]とする。
- elementTypeを
TypedArrayElementType (ta)とする。 GetValueFromBuffer (buffer, byteIndexInBuffer, elementType,true ,seq-cst )を返す。
25.4.10 Atomics.notify ( ta, index, count )
この関数は、待機キュー内でスリープしているいくつかのエージェントに通知する。
呼び出されたとき、次の手順を実行する。
- taRecord を ?
ValidateIntegerTypedArray (ta,true ) とする。 - byteIndexInBuffer を ?
ValidateAtomicAccess (taRecord, index) とする。 - count が
undefined である場合、- count を +∞ に設定する。
- そうでなければ、
- intCount を ?
ToIntegerOrInfinity (count) とする。 - count を
max (intCount, 0) に設定する。
- intCount を ?
- buffer を ta.[[ViewedArrayBuffer]] とする。
- block を buffer.[[ArrayBufferData]] とする。
IsSharedArrayBuffer (buffer) がfalse である場合、+0 𝔽 を返す。- waiterList を
GetWaiterList (block, byteIndexInBuffer) とする。 EnterCriticalSection (waiterList) を実行する。- waiters を
RemoveWaiters (waiterList, count) とする。 - waiters の各要素 waiterRecord について、次を行う。
NotifyWaiter (waiterList, waiterRecord) を実行する。
LeaveCriticalSection (waiterList) を実行する。- waitersCount を waiters 内の要素数とする。
𝔽 (waitersCount) を返す。
25.4.11 Atomics.or ( ta, index, value )
この関数は、呼び出されたとき、次の手順を実行する。
- or を、パラメーター (xBytes, yBytes) を持ち、何もキャプチャせず、呼び出されたときに次の手順をアトミックに実行する、新しい読み取り-変更-書き込み変更関数とする。
ByteListBitwiseOp (|, xBytes, yBytes) を返す。
- ?
AtomicReadModifyWrite (ta, index, value, or) を返す。
25.4.12 Atomics.pause ( )
この関数は、値を待機している間プログラムがスピンループしていることを CPU に示すヒントを提供する。
呼び出されたとき、次の手順を実行する。
- ECMAScript 実装の実行環境が、現在実行中のコードがスピン待機ループ内にあることをオペレーティングシステムまたは CPU に通知することをサポートしている場合、その信号を送る。
undefined を返す。
このメソッドは、mutex 内の spinlock 高速パスなど、スピン待機ループを実装するプログラムが、値を待機している間スピンしていることを CPU に示すヒントを提供するために設計されている。これはタイミング以外に観測可能な動作を持たない。
実装は、基盤となるアーキテクチャのベストプラクティスがスピンループ内でそのような命令を推奨している場合、pause または yield 命令を実装することが期待される。例えば、Intel 最適化マニュアルは pause 命令を推奨している。
実装には、一時停止する最大時間について、数十から数百ナノ秒程度の内部上限を持つことが推奨される。
関数呼び出しのオーバーヘッドにより、最適化コンパイラーにおけるこのメソッドへのインライン化された呼び出しが、インライン化されていない呼び出しとは異なる時間だけ待機することは妥当である。
25.4.13 Atomics.store ( ta, index, value )
この関数は、呼び出されたとき、次の手順を実行する。
- byteIndexInBuffer を ?
ValidateAtomicAccessOnIntegerTypedArray (ta, index) とする。 - ta.[[ContentType]] が
bigint である場合、coerced を ?ToBigInt (value) とする。 - そうでなければ、coerced を
𝔽 (?ToIntegerOrInfinity (value)) とする。 - ?
RevalidateAtomicAccess (ta, byteIndexInBuffer) を実行する。 - buffer を ta.[[ViewedArrayBuffer]] とする。
- elementType を
TypedArrayElementType (ta) とする。 SetValueInBuffer (buffer, byteIndexInBuffer, elementType, coerced,true ,seq-cst ) を実行する。- coerced を返す。
25.4.14 Atomics.sub ( ta, index, value )
この関数は、呼び出されたとき、次の手順を実行する。
- subtract を、パラメーター (xBytes, yBytes) を持ち、ta をキャプチャし、呼び出されたときに次の手順をアトミックに実行する、新しい読み取り-変更-書き込み変更関数とする。
- type を
TypedArrayElementType (ta) とする。 - agentRecord を周囲のエージェントの
Agent Record とする。 - isLittleEndian を agentRecord.[[LittleEndian]] とする。
- x を
RawBytesToNumeric (type, xBytes, isLittleEndian) とする。 - y を
RawBytesToNumeric (type, yBytes, isLittleEndian) とする。 - x が Number である場合、
- difference を
Number::subtract (x, y) とする。
- difference を
- そうでなければ、
Assert : x は BigInt である。- difference を
BigInt::subtract (x, y) とする。
- differenceBytes を
NumericToRawBytes (type, difference, isLittleEndian) とする。 Assert : differenceBytes、xBytes、および yBytes は同じ数の要素を持つ。- differenceBytes を返す。
- type を
- ?
AtomicReadModifyWrite (ta, index, value, subtract) を返す。
25.4.15 Atomics.wait ( ta, index, value, timeout )
この関数は、周囲のエージェントを待機キューに入れ、通知されるか待機がタイムアウトするまでそのエージェントを一時停止し、それらの場合を区別する String を返す。
呼び出されたとき、次の手順を実行する。
- ?
DoWait (sync , ta, index, value, timeout) を返す。
25.4.16 Atomics.waitAsync ( ta, index, value, timeout )
この関数は、呼び出し元エージェントが通知されるかタイムアウトに達したときに解決される Promise を返す。
呼び出されたとき、次の手順を実行する。
- ?
DoWait (async , ta, index, value, timeout) を返す。
25.4.17 Atomics.xor ( ta, index, value )
この関数は、呼び出されたとき、次の手順を実行する。
- xor を、パラメーター (xBytes, yBytes) を持ち、何もキャプチャせず、呼び出されたときに次の手順をアトミックに実行する、新しい読み取り-変更-書き込み変更関数とする。
ByteListBitwiseOp (^, xBytes, yBytes) を返す。
- ?
AtomicReadModifyWrite (ta, index, value, xor) を返す。
25.4.18 Atomics [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
25.5 JSONオブジェクト
JSONオブジェクトは：
- %JSON%である。
global object の"JSON" propertyのinitial valueである。ordinary object である。- JSON textsをparseおよびconstructするために使用される、
parseおよびstringifyという2つのfunctionsを含む。 - valueが
%Object.prototype% である[[Prototype]] internal slotを持つ。 - [[Construct]] internal methodを持たない；
newoperatorでconstructor として使用できない。 - [[Call]] internal methodを持たない；functionとしてinvokeできない。
JSON Data Interchange FormatはECMA-404でdefinedされている。このspecificationで使用されるJSON interchange formatは、ECMA-404によってdescribedされるものとexactly sameである。JSON.parseおよびJSON.stringifyのconforming implementationsは、ECMA-404 specificationでdescribedされるexact interchange formatを、そのformatに対するdeletionsやextensionsなしにsupportしなければならない。
25.5.1 JSON.isRawJSON ( obj )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- objがObjectであり、かつobjが[[IsRawJSON]] internal slotを持つなら、
true を返す。 false を返す。
25.5.2 JSON.parse ( text [ , reviver ] )
このfunctionはJSON text（JSON形式のString）をparseし、ECMAScript language valueをproduceする。JSON formatは、ECMAScript literals、Array Initializers、およびObject Initializersのsyntaxにsimilarなsyntaxでliterals、arrays、およびobjectsをrepresentする。parsing後、JSON objectsはECMAScript objectsとしてrealizedされる。JSON arraysはECMAScript Array instancesとしてrealizedされる。JSON strings、numbers、booleans、およびnullはECMAScript Strings、Numbers、Booleans、および
optional reviver parameterは、resultsをfilterおよびtransformできるfunctionである。parseによってproducedされる各valueについて、reviverは3つのarguments（associated
- jsonStringを ?
ToString (text) とする。 - parseResultを ?
ParseJSON (jsonString) とする。 - unfilteredをparseResult.[[Value]]とする。
IsCallable (reviver)がfalse なら、unfilteredを返す。- rootを
OrdinaryObjectCreate (%Object.prototype% )とする。 - rootNameをempty Stringとする。
- !
CreateDataPropertyOrThrow (root, rootName, unfiltered)を実行する。 - snapshotを
CreateJSONParseRecord (parseResult.[[ParseNode]], rootName, unfiltered)とする。 - ?
InternalizeJSONProperty (root, rootName, reviver, snapshot)を返す。
このfunctionの
25.5.2.1 ParseJSON ( text )
The abstract operation ParseJSON takes argument text (a String) and returns either a
StringToCodePoints (text)がECMA-404でspecifiedされるvalid JSON textでないなら、SyntaxError 例外をthrowする。- scriptStringを
"(" 、text、および");" のstring-concatenation とする。 - scriptを
ParseText (scriptString,Script )とする。 NOTE :13.2.5.1 でdefinedされるearly error rulesは、上記のParseText のinvocationについてspecial handlingを持つ。Assert : scriptはParse Node である。- resultを !
Evaluation of script とする。 NOTE :13.2.5.6 でdefinedされるPropertyDefinitionEvaluation semanticsは、上記のevaluationについてspecial handlingを持つ。Assert : resultはString、Number、Boolean、ArrayLiteral またはObjectLiteral のいずれかによってdefinedされるObject、またはnull のいずれかである。Record { [[ParseNode]]: script, [[Value]]: result }を返す。
JSON.parseのconforming implementationがJSON grammarsをextendすることはpermittedされない。implementationがmodifiedまたはextended JSON interchange formatをsupportしたい場合、different parse functionをdefiningすることによってそうしなければならない。
Valid JSON textはECMAScript
しかし、ParseJSON中には
object内にduplicate name Stringsがある場合、same keyに対するlexically preceding valuesはoverwrittenされる。
25.5.2.2 JSON Parse Record
JSON Parse Recordは、JSON textからparsedされたvalueのinitial stateをdescribeするために使用される
JSON Parse Recordsは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[ParseNode]] | a |
context |
| [[Key]] | a |
[[Value]]がassociatedされる |
| [[Value]] | an ECMAScript language value | [[ParseNode]]のevaluationによってproducedされるvalue。 |
| [[Elements]] | a |
[[Value]]がArrayである場合、これは[[Value]]のelementsにcorrespondingする |
| [[Entries]] | a |
[[Value]]がnon-Array Objectである場合、これは[[Value]]のentriesにcorrespondingする |
25.5.2.3 CreateJSONParseRecord ( parseNode, key, value )
The abstract operation CreateJSONParseRecord takes arguments parseNode (a
- typedValueNodeを
ShallowestContainedJSONValue (parseNode)とする。 Assert : typedValueNodeはempty でない。- elementsをnew empty
List とする。 - entriesをnew empty
List とする。 - valueがObjectなら、
- isArrayを !
IsArray (value) とする。 - isArrayが
true なら、Assert : typedValueNodeはArrayLiteral Parse Node である。- contentNodesをtypedValueNodeの
JSONArrayLiteralContentNodes とする。 - lengthをcontentNodes内のelementsのnumberとする。
- valueLengthを !
LengthOfArrayLike (value) とする。 Assert : valueLengthはlengthである。- indexを0とする。
- Repeat, while index < length,
- propertyNameを !
ToString (𝔽 (index)) とする。 - elementParseRecordを
CreateJSONParseRecord (contentNodes[index], propertyName, !Get (value, propertyName))とする。 - elementParseRecordをelementsにappendする。
- indexをindex + 1に設定する。
- propertyNameを !
- そうでなければ、
Assert : typedValueNodeはObjectLiteral Parse Node である。- propertyNodesをtypedValueNodeの
PropertyDefinitionNodes とする。 NOTE : valueはJSON textからproducedされ、modifiedされていないため、そのproperty keys はすべてStringsであり、exhaustively enumeratedされる。- keysを !
EnumerableOwnProperties (value,key ) とする。 - keysの各String propertyKeyについて、
NOTE : JSON textがsingle objectについてsame nameを持つmultiple name/value pairs（例えば{"a":"lost","a":"kept"}）をspecifyingする場合、resulting ECMAScript objectのcorresponding propertyのvalueは、そのnameを持つlast pairによってspecifiedされる。- propertyDefinitionを
empty とする。 - propertyNodesの各
Parse Node propertyNodeについて、- propertyNameをpropertyNodeの
PropName とする。 - propertyNameがpropertyKeyなら、propertyDefinitionをpropertyNodeに設定する。
- propertyNameをpropertyNodeの
Assert : propertyDefinitionはPropertyDefinition : PropertyName : AssignmentExpression - propertyValueNodeをpropertyDefinitionの
AssignmentExpression とする。 - entryParseRecordを
CreateJSONParseRecord (propertyValueNode, propertyKey, !Get (value, propertyKey))とする。 - entryParseRecordをentriesにappendする。
- isArrayを !
- そうでなければ、
Assert : typedValueNodeはArrayLiteral Parse Node でもObjectLiteral Parse Node でもない。
JSON Parse Record { [[ParseNode]]: typedValueNode, [[Key]]: key, [[Value]]: value, [[Elements]]: elements, [[Entries]]: entries }を返す。
25.5.2.4 InternalizeJSONProperty ( holder, name, reviver, parseRecord )
The abstract operation InternalizeJSONProperty takes arguments holder (an Object), name (a String), reviver (a
このalgorithmは、[[Delete]]または
これは、呼び出されたときに以下のstepsを実行する：
- valueを ?
Get (holder, name) とする。 - contextを
OrdinaryObjectCreate (%Object.prototype% )とする。 - parseRecordが
JSON Parse Record であり、SameValue (parseRecord.[[Value]], value)がtrue なら、- valueがObjectでないなら、
- parseNodeをparseRecord.[[ParseNode]]とする。
Assert : parseNodeはArrayLiteral Parse Node でもObjectLiteral Parse Node でもない。- sourceTextをparseNodeによってmatchedされるsource textとする。
- !
CreateDataPropertyOrThrow (context,"source" ,CodePointsToString (sourceText))を実行する。
- elementRecordsをparseRecord.[[Elements]]とする。
- entryRecordsをparseRecord.[[Entries]]とする。
- valueがObjectでないなら、
- そうでなければ、
- valueがObjectなら、
- isArrayを ?
IsArray (value) とする。 - isArrayが
true なら、- elementRecordsLengthをelementRecords内のelementsのnumberとする。
- lengthを ?
LengthOfArrayLike (value) とする。 - indexを0とする。
- Repeat, while index < length,
- propertyKeyを !
ToString (𝔽 (index)) とする。 - index < elementRecordsLengthなら、elementRecordをelementRecords[index]とする；そうでなければ、elementRecordを
empty とする。 - newElementを ?
InternalizeJSONProperty (value, propertyKey, reviver, elementRecord) とする。 - newElementが
undefined なら、- ? value.[[Delete]](propertyKey)を実行する。
- そうでなければ、
- ?
CreateDataProperty (value, propertyKey, newElement)を実行する。
- ?
- indexをindex + 1に設定する。
- propertyKeyを !
- そうでなければ、
- keysを ?
EnumerableOwnProperties (value,key ) とする。 - keysの各String propertyKeyについて、
- entryRecordsのelement entryであってentry.[[Key]]がpropertyKeyであるものが存在するなら、entryRecordをentryとする；そうでなければ、entryRecordを
empty とする。 - newElementを ?
InternalizeJSONProperty (value, propertyKey, reviver, entryRecord) とする。 - newElementが
undefined なら、- ? value.[[Delete]](propertyKey)を実行する。
- そうでなければ、
- ?
CreateDataProperty (value, propertyKey, newElement)を実行する。
- ?
- entryRecordsのelement entryであってentry.[[Key]]がpropertyKeyであるものが存在するなら、entryRecordをentryとする；そうでなければ、entryRecordを
- keysを ?
- isArrayを ?
- ?
Call (reviver, holder, « name, value, context »)を返す。
25.5.2.5 Static Semantics: ShallowestContainedJSONValue ( root )
The abstract operation ShallowestContainedJSONValue takes argument root (a
- activeFuncを
active function object とする。 Assert : activeFuncはJSON.parsebuilt-infunction object である（JSON.parse を参照）。- typesを«
NullLiteral ,BooleanLiteral ,NumericLiteral ,StringLiteral ,ArrayLiteral ,ObjectLiteral ,UnaryExpression »とする。 - unaryExprを
empty とする。 - queueを« root »とする。
- Repeat, while queue is not empty,
- candidateをqueueのfirst elementとする。
- queueからfirst elementをremoveする。
- queuedChildrenを
false とする。 - typesの各nonterminal typeについて、
- candidateがtypeのinstanceであるなら、
NOTE : JSON grammarにおいて、numbertokenはnegative valueをrepresentし得る。ECMAScriptでは、negationは、UnaryExpression が-に続いてderivedUnaryExpression へparseするunary operationとしてrepresentedされる。- typeが
UnaryExpression なら、- candidateのparentが
UnaryExpression Parse Node でないなら、unaryExprをcandidateに設定する。
- candidateのparentが
- そうでなく、typeが
NumericLiteral なら、Assert : candidateはunaryExpr内にcontainedされる。- unaryExprを返す。
- そうでなければ、
- candidateを返す。
- queuedChildrenが
false であり、candidateがnonterminalのinstanceであり、かつcandidateContains typeがtrue なら、- childrenを、candidateの各child nodeをorder通りに含む
List とする。 - queueをqueueとchildrenの
list-concatenation に設定する。 - queuedChildrenを
true に設定する。
- childrenを、candidateの各child nodeをorder通りに含む
- candidateがtypeのinstanceであるなら、
empty を返す。
25.5.2.6 Static Semantics: JSONArrayLiteralContentNodes
The
Assert :Elision はpresentでない。ElementList がpresentでないなら、new emptyList を返す。ElementList のJSONArrayLiteralContentNodes を返す。
Assert :Elision はpresentでない。- «
AssignmentExpression »を返す。
Assert :Elision はpresentでない。- elementsをderived
ElementList のJSONArrayLiteralContentNodes とする。 - elementsと«
AssignmentExpression »のlist-concatenation を返す。
NOTE : ECMA-404でspecifiedされるJSON textはSpreadElement をincludeしない。Assert : このstepに到達することはない。
25.5.3 JSON.rawJSON ( text )
このfunctionは、string、number、boolean、またはnull valueのraw JSON textをrepresentするobjectを返す。
- jsonStringを ?
ToString (text) とする。 - jsonStringがempty Stringなら、
SyntaxError 例外をthrowする。 - jsonStringのfirst code unitが、ASCII lowercase letter code unit（0x0061から0x007Aまで、inclusive）、ASCII digit code unit（0x0030から0x0039まで、inclusive）、0x0022 (QUOTATION MARK)、または0x002D (HYPHEN-MINUS)のいずれでもないなら、
SyntaxError 例外をthrowする。 - jsonStringのlast code unitが、ASCII lowercase letter code unit（0x0061から0x007Aまで、inclusive）、ASCII digit code unit（0x0030から0x0039まで、inclusive）、または0x0022 (QUOTATION MARK)のいずれでもないなら、
SyntaxError 例外をthrowする。 - parseResultを ?
ParseJSON (jsonString) とする。 Assert : parseResult.[[Value]]はString、Number、Boolean、またはnull のいずれかである。- internalSlotsListを« [[IsRawJSON]] »とする。
- objを
OrdinaryObjectCreate (null , internalSlotsList)とする。 - !
CreateDataPropertyOrThrow (obj,"rawJSON" , jsonString)を実行する。 - !
SetIntegrityLevel (obj,frozen )を実行する。 - objを返す。
25.5.4 JSON.stringify ( value [ , replacer [ , space ] ] )
このfunctionは、ECMAScript language valueをrepresentするUTF-16 encoded JSON formatのString、または
これは、呼び出されたときに以下のstepsを実行する：
- stackをnew empty
List とする。 - indentをempty Stringとする。
- propertyListを
undefined とする。 - replacerFuncを
undefined とする。 - replacerがObjectなら、
IsCallable (replacer)がtrue なら、- replacerFuncをreplacerに設定する。
- そうでなければ、
- isArrayを ?
IsArray (replacer) とする。 - isArrayが
true なら、- propertyListをnew empty
List に設定する。 - lengthを ?
LengthOfArrayLike (replacer) とする。 - kを0とする。
- Repeat, while k < length,
- propertyKeyを !
ToString (𝔽 (k)) とする。 - propertyValueを ?
Get (replacer, propertyKey) とする。 - itemを
undefined とする。 - propertyValueがStringなら、
- itemをpropertyValueに設定する。
- そうでなく、propertyValueがNumberなら、
- itemを !
ToString (propertyValue) に設定する。
- itemを !
- そうでなく、propertyValueがObjectなら、
- propertyValueが[[StringData]]または[[NumberData]] internal slotを持つなら、itemを ?
ToString (propertyValue) に設定する。
- propertyValueが[[StringData]]または[[NumberData]] internal slotを持つなら、itemを ?
- itemが
undefined でなく、かつpropertyListがitemをcontainしないなら、- itemをpropertyListにappendする。
- kをk + 1に設定する。
- propertyKeyを !
- propertyListをnew empty
- isArrayを ?
- spaceがObjectなら、
- spaceがNumberなら、
- spaceMVを !
ToIntegerOrInfinity (space) とする。 - spaceMVを
min (10, spaceMV)に設定する。 - spaceMV < 1なら、gapをempty Stringとする；そうでなければ、gapをcode unit 0x0020 (SPACE)のspaceMV occurrencesを含むString valueとする。
- spaceMVを !
- そうでなく、spaceがStringなら、
- spaceのlengthが10以下なら、gapをspaceとする；そうでなければ、gapをspaceの0から10までの
substring とする。
- spaceのlengthが10以下なら、gapをspaceとする；そうでなければ、gapをspaceの0から10までの
- そうでなければ、
- gapをempty Stringとする。
- wrapperを
OrdinaryObjectCreate (%Object.prototype% )とする。 - !
CreateDataPropertyOrThrow (wrapper, the empty String, value)を実行する。 - stateを
JSON Serialization Record { [[ReplacerFunction]]: replacerFunc, [[Stack]]: stack, [[Indent]]: indent, [[Gap]]: gap, [[PropertyList]]: propertyList }とする。 - ?
SerializeJSONProperty (state, the empty String, wrapper)を返す。
このfunctionの
JSON structuresは任意のdepthまでnestedされることがallowedされるが、acyclicでなければならない。valueがcyclic structureである、またはそれを含む場合、このfunctionは
a = [];
a[0] = a;
my_text = JSON.stringify(a); // This must throw a TypeError.Symbolic primitive valuesは以下のようにrenderedされる：
-
null valueはJSON text内でString value"null" としてrenderedされる。 -
undefined valueはrenderedされない。 -
true valueはJSON text内でString value"true" としてrenderedされる。 -
false valueはJSON text内でString value"false" としてrenderedされる。
String valuesはQUOTATION MARK (") code unitsでwrappedされる。code units "および\は\ prefixesでescapedされる。Control characters code unitsはescape sequences \uHHHH、またはよりshorter formsである\b (BACKSPACE)、\f (FORM FEED)、\n (LINE FEED)、\r (CARRIAGE RETURN)、\t (CHARACTER TABULATION)にreplacedされる。
JSON representationを持たないvalues（
objectは、U+007B (LEFT CURLY BRACKET)に続いて、U+002C (COMMA)でseparatedされたzero or more propertiesが続き、U+007D (RIGHT CURLY BRACKET)でclosedされるものとしてrenderedされる。propertyは、
25.5.4.1 JSON Serialization Record
JSON Serialization Recordは、JSON formatへのserializationをenableするために使用される
JSON Serialization Recordsは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[ReplacerFunction]] | a |
object propertiesにreplacement valuesをsupplyできるfunction（JSON.stringifyのreplacer parameterから）。 |
| [[PropertyList]] | either a |
non-array objectをserializingする際にincludeするpropertiesのnames（JSON.stringifyのreplacer parameterから）。 |
| [[Gap]] | a String | indentationのunit（JSON.stringifyのspace parameterから）。 |
| [[Stack]] | a |
serializedされるprocess中にあるnested objectsのset。cyclic structuresをdetectするためにusedされる。 |
| [[Indent]] | a String | current indentation。 |
25.5.4.2 SerializeJSONProperty ( state, key, holder )
The abstract operation SerializeJSONProperty takes arguments state (a
- valueを ?
Get (holder, key) とする。 - valueがObjectまたはvalueがBigIntなら、
- toJSONを ?
GetV (value,"toJSON" ) とする。 IsCallable (toJSON)がtrue なら、- valueを ?
Call (toJSON, value, « key ») に設定する。
- valueを ?
- toJSONを ?
- state.[[ReplacerFunction]]が
undefined でないなら、- valueを ?
Call (state.[[ReplacerFunction]], holder, « key, value ») に設定する。
- valueを ?
- valueがObjectなら、
- valueが[[IsRawJSON]] internal slotを持つなら、
- valueが[[NumberData]] internal slotを持つなら、
- valueを ?
ToNumber (value) に設定する。
- valueを ?
- そうでなく、valueが[[StringData]] internal slotを持つなら、
- valueを ?
ToString (value) に設定する。
- valueを ?
- そうでなく、valueが[[BooleanData]] internal slotを持つなら、
- valueをvalue.[[BooleanData]]に設定する。
- そうでなく、valueが[[BigIntData]] internal slotを持つなら、
- valueをvalue.[[BigIntData]]に設定する。
- valueが
null なら、"null" を返す。 - valueが
true なら、"true" を返す。 - valueが
false なら、"false" を返す。 - valueがStringなら、
QuoteJSONString (value)を返す。 - valueがNumberなら、
- valueがBigIntなら、
TypeError 例外をthrowする。 - valueがObjectであり、
IsCallable (value)がfalse なら、- isArrayを ?
IsArray (value) とする。 - isArrayが
true なら、- ?
SerializeJSONArray (state, value)を返す。
- ?
- ?
SerializeJSONObject (state, value)を返す。
- isArrayを ?
undefined を返す。
25.5.4.3 QuoteJSONString ( value )
The abstract operation QuoteJSONString takes argument value (a String) and returns a String. valueを0x0022 (QUOTATION MARK) code unitsでwrapし、その中のcertain other code unitsをescapeする。このoperationは、
- productを、code unit 0x0022 (QUOTATION MARK)のみからなるString valueとする。
StringToCodePoints (value)の各code point codePointについて、- codePointが
Table 78 の“Code Point” columnにlistedされているなら、- productを、productと、corresponding rowの“Escape Sequence” columnでspecifiedされるcodePointのescape sequenceとの
string-concatenation に設定する。
- productを、productと、corresponding rowの“Escape Sequence” columnでspecifiedされるcodePointのescape sequenceとの
- そうでなく、codePointが0x0020 (SPACE)未満のnumeric valueを持つ、またはcodePointが
leading surrogate またはtrailing surrogate とsame numeric valueを持つなら、- unitを、numeric valueがcodePointのnumeric valueであるcode unitとする。
- productを、productと
UnicodeEscape (unit)のstring-concatenation に設定する。
- そうでなければ、
- productを、productと
UTF16EncodeCodePoint (codePoint)のstring-concatenation に設定する。
- productを、productと
- codePointが
- productを、productとcode unit 0x0022 (QUOTATION MARK)の
string-concatenation に設定する。 - productを返す。
| Code Point | Unicode Character Name | Escape Sequence |
|---|---|---|
| U+0008 | BACKSPACE |
\b
|
| U+0009 | CHARACTER TABULATION |
\t
|
| U+000A | LINE FEED (LF) |
\n
|
| U+000C | FORM FEED (FF) |
\f
|
| U+000D | CARRIAGE RETURN (CR) |
\r
|
| U+0022 | QUOTATION MARK |
\"
|
| U+005C | REVERSE SOLIDUS |
\\
|
25.5.4.4 UnicodeEscape ( codeUnit )
The abstract operation UnicodeEscape takes argument codeUnit (a code unit) and returns a String. codeUnitをUnicode escape sequenceとしてrepresentsする。 It performs the following steps when called:
- nをcodeUnitのnumeric valueとする。
Assert : n ≤ 0xFFFFである。- hexを、lowercase hexadecimal numberとしてformattedされたnのString representationとする。
- code unit 0x005C (REVERSE SOLIDUS)、
"u" 、およびStringPad (hex, 4,"0" ,start )のstring-concatenation を返す。
25.5.4.5 SerializeJSONObject ( state, value )
The abstract operation SerializeJSONObject takes arguments state (a
- state.[[Stack]]がvalueをcontainするなら、structureがcyclicalであるため、
TypeError 例外をthrowする。 - valueをstate.[[Stack]]にappendする。
- stepBackをstate.[[Indent]]とする。
- state.[[Indent]]をstate.[[Indent]]とstate.[[Gap]]の
string-concatenation に設定する。 - state.[[PropertyList]]が
undefined でないなら、- keysをstate.[[PropertyList]]とする。
- そうでなければ、
- keysを ?
EnumerableOwnProperties (value,key ) とする。
- keysを ?
- partialをnew empty
List とする。 - keysの各element propertyKeyについて、
- stringPを ?
SerializeJSONProperty (state, propertyKey, value) とする。 - stringPが
undefined でないなら、- memberを
QuoteJSONString (propertyKey)とする。 - memberをmemberと
":" のstring-concatenation に設定する。 - state.[[Gap]]がempty Stringでないなら、
- memberをmemberとcode unit 0x0020 (SPACE)の
string-concatenation に設定する。
- memberをmemberとcode unit 0x0020 (SPACE)の
- memberをmemberとstringPの
string-concatenation に設定する。 - memberをpartialにappendする。
- memberを
- stringPを ?
- partialがemptyなら、
- finalを
"{}" とする。
- finalを
- そうでなければ、
- state.[[Gap]]がempty Stringなら、
- propertiesを、partialのすべてのelement Stringsを、adjacent pair of Stringsごとにcode unit 0x002C (COMMA)でseparatedしてconcatenatingすることによってformedされるString valueとする。commaはfirst Stringの前にもlast Stringの後にもinsertedされない。
- finalを
"{" 、properties、および"}" のstring-concatenation とする。
- そうでなければ、
- separatorをcode unit 0x002C (COMMA)、code unit 0x000A (LINE FEED)、およびstate.[[Indent]]の
string-concatenation とする。 - propertiesを、partialのすべてのelement Stringsを、adjacent pair of StringsごとにseparatorでseparatedしてconcatenatingすることによってformedされるString valueとする。separator Stringはfirst Stringの前にもlast Stringの後にもinsertedされない。
- finalを
"{" 、code unit 0x000A (LINE FEED)、state.[[Indent]]、properties、code unit 0x000A (LINE FEED)、stepBack、および"}" のstring-concatenation とする。
- separatorをcode unit 0x002C (COMMA)、code unit 0x000A (LINE FEED)、およびstate.[[Indent]]の
- state.[[Gap]]がempty Stringなら、
- state.[[Stack]]のlast elementをremoveする。
- state.[[Indent]]をstepBackに設定する。
- finalを返す。
25.5.4.6 SerializeJSONArray ( state, value )
The abstract operation SerializeJSONArray takes arguments state (a
- state.[[Stack]]がvalueをcontainするなら、structureがcyclicalであるため、
TypeError 例外をthrowする。 - valueをstate.[[Stack]]にappendする。
- stepBackをstate.[[Indent]]とする。
- state.[[Indent]]をstate.[[Indent]]とstate.[[Gap]]の
string-concatenation に設定する。 - partialをnew empty
List とする。 - lengthを ?
LengthOfArrayLike (value) とする。 - indexを0とする。
- Repeat, while index < length,
- stringPを ?
SerializeJSONProperty (state, !ToString (𝔽 (index)), value) とする。 - stringPが
undefined なら、"null" をpartialにappendする。
- そうでなければ、
- stringPをpartialにappendする。
- indexをindex + 1に設定する。
- stringPを ?
- partialがemptyなら、
- finalを
"[]" とする。
- finalを
- そうでなければ、
- state.[[Gap]]がempty Stringなら、
- propertiesを、partialのすべてのelement Stringsを、adjacent pair of Stringsごとにcode unit 0x002C (COMMA)でseparatedしてconcatenatingすることによってformedされるString valueとする。commaはfirst Stringの前にもlast Stringの後にもinsertedされない。
- finalを
"[" 、properties、および"]" のstring-concatenation とする。
- そうでなければ、
- separatorをcode unit 0x002C (COMMA)、code unit 0x000A (LINE FEED)、およびstate.[[Indent]]の
string-concatenation とする。 - propertiesを、partialのすべてのelement Stringsを、adjacent pair of StringsごとにseparatorでseparatedしてconcatenatingすることによってformedされるString valueとする。separator Stringはfirst Stringの前にもlast Stringの後にもinsertedされない。
- finalを
"[" 、code unit 0x000A (LINE FEED)、state.[[Indent]]、properties、code unit 0x000A (LINE FEED)、stepBack、および"]" のstring-concatenation とする。
- separatorをcode unit 0x002C (COMMA)、code unit 0x000A (LINE FEED)、およびstate.[[Indent]]の
- state.[[Gap]]がempty Stringなら、
- state.[[Stack]]のlast elementをremoveする。
- state.[[Indent]]をstepBackに設定する。
- finalを返す。
arraysのrepresentationは、array.length（exclusive）までの
25.5.5 JSON [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
26 メモリ管理
26.1 WeakRefオブジェクト
26.1.1 WeakRefコンストラクタ
WeakRef
- %WeakRef%である。
-
global object の"WeakRef" propertyのinitial valueである。 -
constructor として呼び出されたときに、新しいWeakRefをcreateおよびinitializeする。 - functionとして呼び出されることを意図しておらず、そのように呼び出された場合はexceptionをthrowする。
-
クラス定義の
extends句内の値として使用できる。指定されたWeakRefの動作を継承しようとするサブクラスコンストラクターは、WeakRef.prototypeの組み込みメソッドをサポートするために必要な内部状態でサブクラスインスタンスを作成し初期化するため、WeakRefコンストラクターへのsuper呼び出しを含めなければならない。
26.1.1.1 WeakRef ( target )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- NewTargetが
undefined なら、TypeError 例外をthrowする。 CanBeHeldWeakly (target)がfalse なら、TypeError 例外をthrowする。- weakRefを ?
OrdinaryCreateFromConstructor (NewTarget,"%WeakRef.prototype%" , « [[WeakRefTarget]] ») とする。 AddToKeptObjects (target)を実行する。- weakRef.[[WeakRefTarget]]をtargetに設定する。
- weakRefを返す。
26.1.2 WeakRefコンストラクタのプロパティ
-
valueが
%Function.prototype% である[[Prototype]] internal slotを持つ。 - 以下のpropertiesを持つ：
26.1.2.1 WeakRef.prototype
WeakRef.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
26.1.3 WeakRef Prototype Objectのプロパティ
WeakRef prototype objectは：
- %WeakRef.prototype%である。
-
valueが
%Object.prototype% である[[Prototype]] internal slotを持つ。 ordinary object である。- [[WeakRefTarget]] internal slotを持たない。
26.1.3.1 WeakRef.prototype.constructor
WeakRef.prototype.constructorのinitial valueは
26.1.3.2 WeakRef.prototype.deref ( )
このmethodは、呼び出されたときに以下のstepsを実行する：
- weakRefを
this valueとする。 - ?
RequireInternalSlot (weakRef, [[WeakRefTarget]])を実行する。 WeakRefDeref (weakRef)を返す。
let target = { foo() {} };
let weakRef = new WeakRef(target);
// ... later ...
if (weakRef.deref()) {
weakRef.deref().foo();
}上記の例では、first derefが
26.1.3.3 WeakRef.prototype [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
26.1.4 WeakRef Abstract Operations
26.1.4.1 WeakRefDeref ( weakRef )
The abstract operation WeakRefDeref takes argument weakRef (a
- targetをweakRef.[[WeakRefTarget]]とする。
- targetが
empty でないなら、AddToKeptObjects (target)を実行する。- targetを返す。
undefined を返す。
このabstract operationは、livenessを簡潔にdefineできるようにするためだけに、WeakRef.prototype.derefからseparatelyにdefinedされている。
26.1.5 WeakRefインスタンスのプロパティ
26.2 FinalizationRegistryオブジェクト
26.2.1 FinalizationRegistryコンストラクタ
FinalizationRegistry
- %FinalizationRegistry%である。
-
global object の"FinalizationRegistry" propertyのinitial valueである。 -
constructor として呼び出されたときに、新しいFinalizationRegistryをcreateおよびinitializeする。 - functionとして呼び出されることを意図しておらず、そのように呼び出された場合はexceptionをthrowする。
-
クラス定義の
extends句内の値として使用できる。指定されたFinalizationRegistryの動作を継承しようとするサブクラスコンストラクターは、FinalizationRegistry.prototypeの組み込みメソッドをサポートするために必要な内部状態でサブクラスインスタンスを作成し初期化するため、FinalizationRegistryコンストラクターへのsuper呼び出しを含めなければならない。
26.2.1.1 FinalizationRegistry ( cleanupCallback )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- NewTargetが
undefined である場合、TypeError 例外を投げる。 IsCallable (cleanupCallback)がfalse である場合、TypeError 例外を投げる。- ?
OrdinaryCreateFromConstructor (NewTarget,"%FinalizationRegistry.prototype%" , « [[Realm]], [[CleanupCallback]], [[Cells]] »)をfinalizationRegistryとする。 - アクティブな関数オブジェクトをactiveFuncとする。
- finalizationRegistry.[[Realm]]をactiveFunc.[[Realm]]に設定する。
- finalizationRegistry.[[CleanupCallback]]を
HostMakeJobCallback (cleanupCallback)に設定する。 - finalizationRegistry.[[Cells]]を新しい空の
List に設定する。 - finalizationRegistryを返す。
26.2.2 FinalizationRegistryコンストラクタのプロパティ
-
valueが
%Function.prototype% である[[Prototype]] internal slotを持つ。 - 以下のpropertiesを持つ：
26.2.2.1 FinalizationRegistry.prototype
FinalizationRegistry.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
26.2.3 FinalizationRegistry Prototype Objectのプロパティ
FinalizationRegistry prototype objectは：
- %FinalizationRegistry.prototype%である。
-
valueが
%Object.prototype% である[[Prototype]] internal slotを持つ。 ordinary object である。- [[Cells]]および[[CleanupCallback]] internal slotsを持たない。
26.2.3.1 FinalizationRegistry.prototype.constructor
FinalizationRegistry.prototype.constructorのinitial valueは
26.2.3.2 FinalizationRegistry.prototype.register ( target, heldValue [ , unregisterToken ] )
このmethodは、呼び出されたときに以下のstepsを実行する：
- finalizationRegistryを
this valueとする。 - ?
RequireInternalSlot (finalizationRegistry, [[Cells]])を実行する。 CanBeHeldWeakly (target)がfalse なら、TypeError 例外をthrowする。SameValue (target, heldValue)がtrue なら、TypeError 例外をthrowする。CanBeHeldWeakly (unregisterToken)がfalse なら、- unregisterTokenが
undefined でないなら、TypeError 例外をthrowする。 - unregisterTokenを
empty に設定する。
- unregisterTokenが
- cellを
Record { [[WeakRefTarget]]: target, [[HeldValue]]: heldValue, [[UnregisterToken]]: unregisterToken }とする。 - cellをfinalizationRegistry.[[Cells]]にappendする。
undefined を返す。
26.2.3.3 FinalizationRegistry.prototype.unregister ( unregisterToken )
このmethodは、呼び出されたときに以下のstepsを実行する：
- finalizationRegistryを
this valueとする。 - ?
RequireInternalSlot (finalizationRegistry, [[Cells]])を実行する。 CanBeHeldWeakly (unregisterToken)がfalse なら、TypeError 例外をthrowする。- removedを
false とする。 - finalizationRegistry.[[Cells]]の各
Record { [[WeakRefTarget]], [[HeldValue]], [[UnregisterToken]] } cellについて、- cell.[[UnregisterToken]]が
empty でなく、かつSameValue (cell.[[UnregisterToken]], unregisterToken)がtrue なら、- finalizationRegistry.[[Cells]]からcellをremoveする。
- removedを
true に設定する。
- cell.[[UnregisterToken]]が
- removedを返す。
26.2.3.4 FinalizationRegistry.prototype [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
26.2.4 FinalizationRegistryインスタンスのプロパティ
27 制御抽象オブジェクト
27.1 反復
27.1.1 共通の反復インターフェイス
interfaceは、関連付けられた値が特定の仕様に一致する
27.1.1.1 Iterableインターフェイス
iterable interfaceは、
| Property | Value | Requirements |
|---|---|---|
%Symbol.iterator%
|
|
返されるobjectは |
27.1.1.2 Iteratorインターフェイス
iterator interfaceを実装するobjectは、
| Property | Value | Requirements |
|---|---|---|
|
|
|
返されるobjectはnext methodへの以前のcallがnext methodへの後続のすべてのcallsも、 |
next functionにargumentsを渡してもよいが、それらの解釈およびvalidityはtarget iteratorに依存する。for-of statementおよびiteratorsの他の一般的な利用者はargumentsを渡さないため、そのような方法で使用されることを期待するiterator objectsは、argumentsなしで呼び出されることに対処できるよう準備されていなければならない。
| Property | Value | Requirements |
|---|---|---|
|
|
|
返されるobjectはnext method callsを行う意図がないことをreturn methodのargumentとして渡された値を持つ |
|
|
|
返されるobjectはthrowすることである。methodがthrowしない場合、返される |
典型的には、これらのmethodsの呼び出し側は、それらをinvokeする前にそれらの存在をcheckすべきである。for-of、yield*、およびarray destructuringを含む特定のECMAScript language featuresは、existence checkを実行した後にこれらのmethodsをcallする。
27.1.1.3 Async Iterableインターフェイス
async iterable interfaceは、
| Property | Value | Requirements |
|---|---|---|
%Symbol.asyncIterator% |
返されるobjectは |
27.1.1.4 Async Iteratorインターフェイス
async iterator interfaceを実装するobjectは、
| Property | Value | Requirements |
|---|---|---|
|
返されるpromiseは、fulfilledされたときに、 さらに、fulfillment valueとして機能する |
next functionにargumentsを渡してもよいが、それらの解釈およびvalidityはtarget async iteratorに依存する。for-await-of statementおよびasync iteratorsの他の一般的な利用者はargumentsを渡さないため、そのような方法で使用されることを期待するasync iterator objectsは、argumentsなしで呼び出されることに対処できるよう準備されていなければならない。
| Property | Value | Requirements |
|---|---|---|
|
返されるpromiseは、fulfilledされたときに、 さらに、fulfillment valueとして機能する |
||
|
返されるpromiseは、fulfilledされたときに、 返されるpromiseがfulfilledされる場合、 |
典型的には、これらのmethodsの呼び出し側は、それらをinvokeする前にそれらの存在をcheckすべきである。for-await-ofおよびyield*を含む特定のECMAScript language featuresは、existence checkを実行した後にこれらのmethodsをcallする。
27.1.1.5 IteratorResultインターフェイス
IteratorResult interfaceは、
| Property | Value | Requirements |
|---|---|---|
|
|
Boolean |
これはnext method callのresult statusである。 |
|
|
ECMAScript language value |
doneが |
27.1.2 Iterator Helperオブジェクト
Iterator Helper objectは、特定のsource
27.1.2.1 %IteratorHelperPrototype%オブジェクト
%IteratorHelperPrototype% objectは：
- すべての
Iterator Helper objects によってinheritedされるpropertiesを持つ。 ordinary object である。- valueが
%Iterator.prototype% である[[Prototype]] internal slotを持つ。 - 以下のpropertiesを持つ：
27.1.2.1.1 %IteratorHelperPrototype%.next ( )
- ?
GeneratorResume (this value,undefined ,"Iterator Helper" )を返す。
27.1.2.1.2 %IteratorHelperPrototype%.return ( )
- objを
this valueとする。 - ?
RequireInternalSlot (obj, [[UnderlyingIterators]])を実行する。 Assert : objは[[GeneratorState]] internal slotを持つ。- obj.[[GeneratorState]]が
suspended-start なら、- obj.[[GeneratorState]]を
completed に設定する。 NOTE : generatorがcompleted stateに入ると、そこから離れることはなく、関連付けられたexecution context は再開されない。この時点で、objに関連付けられた任意のexecution stateは破棄できる。- ?
IteratorCloseAll (obj.[[UnderlyingIterators]],NormalCompletion (unused ))を実行する。 CreateIteratorResultObject (undefined ,true )を返す。
- obj.[[GeneratorState]]を
- completionを
ReturnCompletion (undefined )とする。 - ?
GeneratorResumeAbrupt (obj, completion,"Iterator Helper" )を返す。
27.1.2.1.3 %IteratorHelperPrototype% [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
27.1.3 Iteratorオブジェクト
27.1.3.1 Iteratorコンストラクタ
Iterator
- %Iterator%である。
global object の"Iterator" propertyのinitial valueである。- subclassableであるようにdesignedされている。class definitionの
extends clauseのvalueとして使用してもよい。
27.1.3.1.1 Iterator ( )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- NewTargetが
undefined またはactive function object なら、TypeError 例外をthrowする。 - ?
OrdinaryCreateFromConstructor (NewTarget,"%Iterator.prototype%" )を返す。
27.1.3.2 Iteratorコンストラクタのプロパティ
- valueが
%Function.prototype% である[[Prototype]] internal slotを持つ。 - 以下のpropertiesを持つ：
27.1.3.2.1 Iterator.concat ( ...items )
- iterablesをnew empty
List とする。 - itemsの各element itemについて、
- itemがObjectでないなら、
TypeError 例外をthrowする。 - methodを ?
GetMethod (item,%Symbol.iterator% ) とする。 - methodが
undefined なら、TypeError 例外をthrowする。 Record { [[OpenMethod]]: method, [[Iterable]]: item }をiterablesにappendする。
- itemがObjectでないなら、
- closureを、iterablesをcaptureし、呼び出されたときに以下のstepsを実行する、parametersを持たないnew
Abstract Closure とする：- iterablesの各
Record iterableについて、- iteratorを ?
Call (iterable.[[OpenMethod]], iterable.[[Iterable]]) とする。 - iteratorがObjectでないなら、
TypeError 例外をthrowする。 - iteratorRecordを ?
GetIteratorDirect (iterator) とする。 - innerAliveを
true とする。 - innerAliveが
true である間、繰り返す：- innerValueを ?
IteratorStepValue (iteratorRecord) とする。 - innerValueが
done なら、- innerAliveを
false に設定する。
- innerAliveを
- そうでなければ、
- completionを
Completion (Yield (innerValue))とする。 - completionが
abrupt completion なら、- ?
IteratorClose (iteratorRecord, completion)を返す。
- ?
- completionを
- innerValueを ?
- iteratorを ?
ReturnCompletion (undefined )を返す。
- iterablesの各
- genを
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterators]] »)とする。 - gen.[[UnderlyingIterators]]をnew empty
List に設定する。 - genを返す。
27.1.3.2.2 Iterator.from ( obj )
- iteratorRecordを ?
GetIteratorFlattenable (obj,iterate-string-primitives ) とする。 - hasInstanceを ?
OrdinaryHasInstance (%Iterator% , iteratorRecord.[[Iterator]]) とする。 - hasInstanceが
true なら、- iteratorRecord.[[Iterator]]を返す。
- wrapperを
OrdinaryObjectCreate (%WrapForValidIteratorPrototype% , « [[Iterated]] »)とする。 - wrapper.[[Iterated]]をiteratorRecordに設定する。
- wrapperを返す。
27.1.3.2.2.1 %WrapForValidIteratorPrototype%オブジェクト
%WrapForValidIteratorPrototype% objectは：
ordinary object である。- valueが
%Iterator.prototype% である[[Prototype]] internal slotを持つ。
27.1.3.2.2.1.1 %WrapForValidIteratorPrototype%.next ( )
- objを
this valueとする。 - ?
RequireInternalSlot (obj, [[Iterated]])を実行する。 - iteratorRecordをobj.[[Iterated]]とする。
- ?
Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]])を返す。
27.1.3.2.2.1.2 %WrapForValidIteratorPrototype%.return ( )
- objを
this valueとする。 - ?
RequireInternalSlot (obj, [[Iterated]])を実行する。 - iteratorをobj.[[Iterated]].[[Iterator]]とする。
Assert : iteratorはObjectである。- returnMethodを ?
GetMethod (iterator,"return" ) とする。 - returnMethodが
undefined なら、CreateIteratorResultObject (undefined ,true )を返す。
- ?
Call (returnMethod, iterator)を返す。
27.1.3.2.3 Iterator.prototype
Iterator.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
27.1.3.2.4 Iterator.zip ( iterables [ , options ] )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- iterablesがObjectでないなら、
TypeError 例外をthrowする。 - optionsを ?
GetOptionsObject (options) に設定する。 - modeを ?
Get (options,"mode" ) とする。 - modeが
undefined なら、modeを"shortest" に設定する。 - modeが
"shortest" 、"longest" 、または"strict" のいずれでもないなら、TypeError 例外をthrowする。 - paddingOptionを
undefined とする。 - modeが
"longest" なら、- paddingOptionを ?
Get (options,"padding" ) に設定する。 - paddingOptionが
undefined でなく、かつObjectでないなら、TypeError 例外をthrowする。
- paddingOptionを ?
- itersをnew empty
List とする。 - paddingをnew empty
List とする。 - inputIterを ?
GetIterator (iterables,sync ) とする。 - nextを
not-started とする。 - nextが
done でない間、繰り返す：- nextを
Completion (IteratorStepValue (inputIter))に設定する。 IfAbruptCloseIterators (next, iters).- nextが
done でないなら、- iterを
Completion (GetIteratorFlattenable (next,reject-primitives ))とする。 - needClosingを« inputIter »とitersの
list-concatenation とする。 IfAbruptCloseIterators (iter, needClosing).- iterをitersにappendする。
- iterを
- nextを
- iterCountをitersのelements数とする。
- modeが
"longest" なら、- paddingOptionが
undefined なら、- iterCount回繰り返す：
undefined をpaddingにappendする。
- iterCount回繰り返す：
- そうでなければ、
- paddingIterを
Completion (GetIterator (paddingOption,sync ))とする。 IfAbruptCloseIterators (paddingIter, iters).- usingIteratorを
true とする。 - iterCount回繰り返す：
- usingIteratorが
true なら、- nextを
Completion (IteratorStepValue (paddingIter))に設定する。 IfAbruptCloseIterators (next, iters).- nextが
done なら、- usingIteratorを
false に設定する。
- usingIteratorを
- そうでなければ、
- nextをpaddingにappendする。
- nextを
- usingIteratorが
false なら、undefined をpaddingにappendする。
- usingIteratorが
- usingIteratorが
true なら、- completionを
Completion (IteratorClose (paddingIter,NormalCompletion (unused )))とする。 IfAbruptCloseIterators (completion, iters).
- completionを
- paddingIterを
- paddingOptionが
- finishResultsを、parameters (results)を持ち、何もcaptureせず、呼び出されたときに以下のstepsを実行するnew
Abstract Closure とする：CreateArrayFromList (results)を返す。
IteratorZip (iters, mode, padding, finishResults)を返す。
27.1.3.2.5 Iterator.zipKeyed ( iterables [ , options ] )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- iterablesがObjectでないなら、
TypeError 例外をthrowする。 - optionsを ?
GetOptionsObject (options) に設定する。 - modeを ?
Get (options,"mode" ) とする。 - modeが
undefined なら、modeを"shortest" に設定する。 - modeが
"shortest" 、"longest" 、または"strict" のいずれでもないなら、TypeError 例外をthrowする。 - paddingOptionを
undefined とする。 - modeが
"longest" なら、- paddingOptionを ?
Get (options,"padding" ) に設定する。 - paddingOptionが
undefined でなく、かつObjectでないなら、TypeError 例外をthrowする。
- paddingOptionを ?
- itersをnew empty
List とする。 - paddingをnew empty
List とする。 - allKeysを ? iterables.[[OwnPropertyKeys]]() とする。
- keysをnew empty
List とする。 - allKeysの各element keyについて、
- propertyDescを
Completion (iterables.[[GetOwnProperty]](key))とする。 IfAbruptCloseIterators (propertyDesc, iters).- propertyDescが
undefined でなく、かつpropertyDesc.[[Enumerable]]がtrue なら、- valueを
Completion (Get (iterables, key))とする。 IfAbruptCloseIterators (value, iters).- valueが
undefined でないなら、- keyをkeysにappendする。
- iterを
Completion (GetIteratorFlattenable (value,reject-primitives ))とする。 IfAbruptCloseIterators (iter, iters).- iterをitersにappendする。
- valueを
- propertyDescを
- iterCountをitersのelements数とする。
- modeが
"longest" なら、- paddingOptionが
undefined なら、- iterCount回繰り返す：
undefined をpaddingにappendする。
- iterCount回繰り返す：
- そうでなければ、
- keysの各element keyについて、
- valueを
Completion (Get (paddingOption, key))とする。 IfAbruptCloseIterators (value, iters).- valueをpaddingにappendする。
- valueを
- keysの各element keyについて、
- paddingOptionが
- finishResultsを、parameters (results)を持ち、keysとiterCountをcaptureし、呼び出されたときに以下のstepsを実行するnew
Abstract Closure とする：- objを
OrdinaryObjectCreate (null )とする。 - 0 ≤ i < iterCountである各
integer iについて、昇順で、- !
CreateDataPropertyOrThrow (obj, keys[i], results[i])を実行する。
- !
- objを返す。
- objを
IteratorZip (iters, mode, padding, finishResults)を返す。
27.1.3.3 Iterator Prototype Objectのプロパティ
Iterator prototype objectは：
- %Iterator.prototype%である。
- valueが
%Object.prototype% である[[Prototype]] internal slotを持つ。 ordinary object である。
このspecificationでdefinedされる、
以下のexpressionは、ECMAScript codeが%Iterator.prototype% objectにaccessできる1つの方法である：
Object.getPrototypeOf(Object.getPrototypeOf([][Symbol.iterator]()))27.1.3.3.1 Iterator.prototype.constructor
Iterator.prototype.constructorは、attributes { [[Enumerable]]:
27.1.3.3.1.1 get Iterator.prototype.constructor
[[Get]] attributeのvalueは、argumentsを必要としないbuilt-in functionである。呼び出されたときに以下のstepsを実行する：
%Iterator% を返す。
27.1.3.3.1.2 set Iterator.prototype.constructor
[[Set]] attributeのvalueは、argument vを取るbuilt-in functionである。呼び出されたときに以下のstepsを実行する：
- ?
SetterThatIgnoresPrototypeProperties (this value,%Iterator.prototype% ,"constructor" , v)を実行する。 undefined を返す。
ほとんどのbuilt-in prototypes上の
27.1.3.3.2 Iterator.prototype.drop ( limit )
このmethodは、呼び出されたときに以下のstepsを実行する：
- objを
this valueとする。 - objがObjectでないなら、
TypeError 例外をthrowする。 - iteratedを
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false }とする。 - numberLimitを
Completion (ToNumber (limit))とする。 IfAbruptCloseIterator (numberLimit, iterated).- numberLimitが
NaN なら、- errorを
ThrowCompletion (a newly createdRangeError object)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- intLimitを !
ToIntegerOrInfinity (numberLimit) とする。 - intLimit < 0なら、
- errorを
ThrowCompletion (a newly createdRangeError object)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- iteratedを ?
GetIteratorDirect (obj) に設定する。 - closureを、iteratedとintLimitをcaptureし、呼び出されたときに以下のstepsを実行する、parametersを持たないnew
Abstract Closure とする：- remainingをintLimitとする。
- remaining > 0である間、繰り返す：
- remaining ≠ +∞なら、
- remainingをremaining - 1に設定する。
- nextを ?
IteratorStep (iterated) とする。 - nextが
done なら、ReturnCompletion (undefined )を返す。
- remaining ≠ +∞なら、
- 繰り返す：
- valueを ?
IteratorStepValue (iterated) とする。 - valueが
done なら、ReturnCompletion (undefined )を返す。 - completionを
Completion (Yield (value))とする。 IfAbruptCloseIterator (completion, iterated).
- valueを ?
- resultを
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterators]] »)とする。 - result.[[UnderlyingIterators]]を« iterated »に設定する。
- resultを返す。
27.1.3.3.3 Iterator.prototype.every ( predicate )
このmethodは、呼び出されたときに以下のstepsを実行する：
- objを
this valueとする。 - objがObjectでないなら、
TypeError 例外をthrowする。 - iteratedを
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false }とする。 IsCallable (predicate)がfalse なら、- errorを
ThrowCompletion (a newly createdTypeError object)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- iteratedを ?
GetIteratorDirect (obj) に設定する。 - counterを0とする。
- 繰り返す：
- valueを ?
IteratorStepValue (iterated) とする。 - valueが
done なら、true を返す。 - resultを
Completion (Call (predicate,undefined , « value,𝔽 (counter) »))とする。 IfAbruptCloseIterator (result, iterated).ToBoolean (result)がfalse なら、?IteratorClose (iterated,NormalCompletion (false ))を返す。- counterをcounter + 1に設定する。
- valueを ?
27.1.3.3.4 Iterator.prototype.filter ( predicate )
このmethodは、呼び出されたときに以下のstepsを実行する：
- objを
this valueとする。 - objがObjectでないなら、
TypeError 例外をthrowする。 - iteratedを
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false }とする。 IsCallable (predicate)がfalse なら、- errorを
ThrowCompletion (a newly createdTypeError object)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- iteratedを ?
GetIteratorDirect (obj) に設定する。 - closureを、iteratedとpredicateをcaptureし、呼び出されたときに以下のstepsを実行する、parametersを持たないnew
Abstract Closure とする：- counterを0とする。
- 繰り返す：
- valueを ?
IteratorStepValue (iterated) とする。 - valueが
done なら、ReturnCompletion (undefined )を返す。 - selectedを
Completion (Call (predicate,undefined , « value,𝔽 (counter) »))とする。 IfAbruptCloseIterator (selected, iterated).ToBoolean (selected)がtrue なら、- completionを
Completion (Yield (value))とする。 IfAbruptCloseIterator (completion, iterated).
- completionを
- counterをcounter + 1に設定する。
- valueを ?
- resultを
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterators]] »)とする。 - result.[[UnderlyingIterators]]を« iterated »に設定する。
- resultを返す。
27.1.3.3.5 Iterator.prototype.find ( predicate )
このmethodは、呼び出されたときに以下のstepsを実行する：
- objを
this valueとする。 - objがObjectでないなら、
TypeError 例外をthrowする。 - iteratedを
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false }とする。 IsCallable (predicate)がfalse なら、- errorを
ThrowCompletion (a newly createdTypeError object)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- iteratedを ?
GetIteratorDirect (obj) に設定する。 - counterを0とする。
- 繰り返す：
- valueを ?
IteratorStepValue (iterated) とする。 - valueが
done なら、undefined を返す。 - resultを
Completion (Call (predicate,undefined , « value,𝔽 (counter) »))とする。 IfAbruptCloseIterator (result, iterated).ToBoolean (result)がtrue なら、?IteratorClose (iterated,NormalCompletion (value))を返す。- counterをcounter + 1に設定する。
- valueを ?
27.1.3.3.6 Iterator.prototype.flatMap ( mapper )
このmethodは、呼び出されたときに以下のstepsを実行する：
- objを
this valueとする。 - objがObjectでないなら、
TypeError 例外をthrowする。 - iteratedを
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false }とする。 IsCallable (mapper)がfalse なら、- errorを
ThrowCompletion (a newly createdTypeError object)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- iteratedを ?
GetIteratorDirect (obj) に設定する。 - closureを、iteratedとmapperをcaptureし、呼び出されたときに以下のstepsを実行する、parametersを持たないnew
Abstract Closure とする：- counterを0とする。
- 繰り返す：
- valueを ?
IteratorStepValue (iterated) とする。 - valueが
done なら、ReturnCompletion (undefined )を返す。 - mappedを
Completion (Call (mapper,undefined , « value,𝔽 (counter) »))とする。 IfAbruptCloseIterator (mapped, iterated).- innerIteratorを
Completion (GetIteratorFlattenable (mapped,reject-primitives ))とする。 IfAbruptCloseIterator (innerIterator, iterated).- innerAliveを
true とする。 - innerAliveが
true である間、繰り返す：- innerValueを
Completion (IteratorStepValue (innerIterator))とする。 IfAbruptCloseIterator (innerValue, iterated).- innerValueが
done なら、- innerAliveを
false に設定する。
- innerAliveを
- そうでなければ、
- completionを
Completion (Yield (innerValue))とする。 - completionが
abrupt completion なら、- backupCompletionを
Completion (IteratorClose (innerIterator, completion))とする。 IfAbruptCloseIterator (backupCompletion, iterated).- ?
IteratorClose (iterated, completion)を返す。
- backupCompletionを
- completionを
- innerValueを
- counterをcounter + 1に設定する。
- valueを ?
- resultを
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterators]] »)とする。 - result.[[UnderlyingIterators]]を« iterated »に設定する。
- resultを返す。
27.1.3.3.7 Iterator.prototype.forEach ( procedure )
このmethodは、呼び出されたときに以下のstepsを実行する：
- objを
this valueとする。 - objがObjectでないなら、
TypeError 例外をthrowする。 - iteratedを
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false }とする。 IsCallable (procedure)がfalse なら、- errorを
ThrowCompletion (a newly createdTypeError object)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- iteratedを ?
GetIteratorDirect (obj) に設定する。 - counterを0とする。
- 繰り返す：
- valueを ?
IteratorStepValue (iterated) とする。 - valueが
done なら、undefined を返す。 - resultを
Completion (Call (procedure,undefined , « value,𝔽 (counter) »))とする。 IfAbruptCloseIterator (result, iterated).- counterをcounter + 1に設定する。
- valueを ?
27.1.3.3.8 Iterator.prototype.map ( mapper )
このmethodは、呼び出されたときに以下のstepsを実行する：
- objを
this valueとする。 - objがObjectでないなら、
TypeError 例外をthrowする。 - iteratedを
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false }とする。 IsCallable (mapper)がfalse なら、- errorを
ThrowCompletion (a newly createdTypeError object)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- iteratedを ?
GetIteratorDirect (obj) に設定する。 - closureを、iteratedとmapperをcaptureし、呼び出されたときに以下のstepsを実行する、parametersを持たないnew
Abstract Closure とする：- counterを0とする。
- 繰り返す：
- valueを ?
IteratorStepValue (iterated) とする。 - valueが
done なら、ReturnCompletion (undefined )を返す。 - mappedを
Completion (Call (mapper,undefined , « value,𝔽 (counter) »))とする。 IfAbruptCloseIterator (mapped, iterated).- completionを
Completion (Yield (mapped))とする。 IfAbruptCloseIterator (completion, iterated).- counterをcounter + 1に設定する。
- valueを ?
- resultを
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterators]] »)とする。 - result.[[UnderlyingIterators]]を« iterated »に設定する。
- resultを返す。
27.1.3.3.9 Iterator.prototype.reduce ( reducer [ , initialValue ] )
このmethodは、呼び出されたときに以下のstepsを実行する：
- objを
this valueとする。 - objがObjectでないなら、
TypeError 例外をthrowする。 - iteratedを
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false }とする。 IsCallable (reducer)がfalse なら、- errorを
ThrowCompletion (a newly createdTypeError object)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- iteratedを ?
GetIteratorDirect (obj) に設定する。 - initialValueが存在しないなら、
- accumulatorを ?
IteratorStepValue (iterated) とする。 - accumulatorが
done なら、TypeError 例外をthrowする。 - counterを1とする。
- accumulatorを ?
- そうでなければ、
- accumulatorをinitialValueとする。
- counterを0とする。
- 繰り返す：
- valueを ?
IteratorStepValue (iterated) とする。 - valueが
done なら、accumulatorを返す。 - resultを
Completion (Call (reducer,undefined , « accumulator, value,𝔽 (counter) »))とする。 IfAbruptCloseIterator (result, iterated).- accumulatorをresultに設定する。
- counterをcounter + 1に設定する。
- valueを ?
27.1.3.3.10 Iterator.prototype.some ( predicate )
このmethodは、呼び出されたときに以下のstepsを実行する：
- objを
this valueとする。 - objがObjectでないなら、
TypeError 例外をthrowする。 - iteratedを
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false }とする。 IsCallable (predicate)がfalse なら、- errorを
ThrowCompletion (a newly createdTypeError object)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- iteratedを ?
GetIteratorDirect (obj) に設定する。 - counterを0とする。
- 繰り返す：
- valueを ?
IteratorStepValue (iterated) とする。 - valueが
done なら、false を返す。 - resultを
Completion (Call (predicate,undefined , « value,𝔽 (counter) »))とする。 IfAbruptCloseIterator (result, iterated).ToBoolean (result)がtrue なら、?IteratorClose (iterated,NormalCompletion (true ))を返す。- counterをcounter + 1に設定する。
- valueを ?
27.1.3.3.11 Iterator.prototype.take ( limit )
このmethodは、呼び出されたときに以下のstepsを実行する：
- objを
this valueとする。 - objがObjectでないなら、
TypeError 例外をthrowする。 - iteratedを
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false }とする。 - numberLimitを
Completion (ToNumber (limit))とする。 IfAbruptCloseIterator (numberLimit, iterated).- numberLimitが
NaN なら、- errorを
ThrowCompletion (a newly createdRangeError object)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- intLimitを !
ToIntegerOrInfinity (numberLimit) とする。 - intLimit < 0なら、
- errorを
ThrowCompletion (a newly createdRangeError object)とする。 - ?
IteratorClose (iterated, error)を返す。
- errorを
- iteratedを ?
GetIteratorDirect (obj) に設定する。 - closureを、iteratedとintLimitをcaptureし、呼び出されたときに以下のstepsを実行する、parametersを持たないnew
Abstract Closure とする：- remainingをintLimitとする。
- 繰り返す：
- remaining = 0なら、
- ?
IteratorClose (iterated,ReturnCompletion (undefined ))を返す。
- ?
- remaining ≠ +∞なら、
- remainingをremaining - 1に設定する。
- valueを ?
IteratorStepValue (iterated) とする。 - valueが
done なら、ReturnCompletion (undefined )を返す。 - completionを
Completion (Yield (value))とする。 IfAbruptCloseIterator (completion, iterated).
- remaining = 0なら、
- resultを
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterators]] »)とする。 - result.[[UnderlyingIterators]]を« iterated »に設定する。
- resultを返す。
27.1.3.3.12 Iterator.prototype.toArray ( )
このmethodは、呼び出されたときに以下のstepsを実行する：
- objを
this valueとする。 - objがObjectでないなら、
TypeError 例外をthrowする。 - iteratedを ?
GetIteratorDirect (obj) とする。 - itemsをnew empty
List とする。 - 繰り返す：
- valueを ?
IteratorStepValue (iterated) とする。 - valueが
done なら、CreateArrayFromList (items)を返す。 - valueをitemsにappendする。
- valueを ?
27.1.3.3.13 Iterator.prototype [ %Symbol.dispose% ] ( )
このメソッドは、呼び出されたときに次のステップを実行する:
このメソッドの
27.1.3.3.14 Iterator.prototype [ %Symbol.iterator% ] ( )
このfunctionは、呼び出されたときに以下のstepsを実行する：
this valueを返す。
このfunctionの
27.1.3.3.15 Iterator.prototype [ %Symbol.toStringTag% ]
Iterator.prototype[%Symbol.toStringTag%]は、attributes { [[Enumerable]]:
27.1.3.3.15.1 get Iterator.prototype [ %Symbol.toStringTag% ]
[[Get]] attributeのvalueは、argumentsを必要としないbuilt-in functionである。呼び出されたときに以下のstepsを実行する：
"Iterator" を返す。
27.1.3.3.15.2 set Iterator.prototype [ %Symbol.toStringTag% ]
[[Set]] attributeのvalueは、argument vを取るbuilt-in functionである。呼び出されたときに以下のstepsを実行する：
- ?
SetterThatIgnoresPrototypeProperties (this value,%Iterator.prototype% ,%Symbol.toStringTag% , v)を実行する。 undefined を返す。
ほとんどのbuilt-in prototypes上の
27.1.3.4 IteratorsのためのAbstract Operations
27.1.3.4.1 IteratorZip ( iters, mode, padding, finishResults )
The abstract operation IteratorZip takes arguments iters (a
- iterCountをitersのelements数とする。
- openItersをitersのcopyとする。
- closureを、iters、iterCount、openIters、mode、padding、およびfinishResultsをcaptureし、呼び出されたときに以下のstepsを実行する、parametersを持たないnew
Abstract Closure とする：- iterCount = 0なら、
ReturnCompletion (undefined )を返す。 - 繰り返す：
- resultsをnew empty
List とする。 Assert : openItersはemptyでない。- 0 ≤ i < iterCountである各
integer iについて、昇順で、- iterをiters[i]とする。
- iterが
null なら、Assert : modeは"longest" である。- resultをpadding[i]とする。
- そうでなければ、
- resultを
Completion (IteratorStepValue (iter))とする。 - resultが
abrupt completion なら、- openItersからiterをremoveする。
- ?
IteratorCloseAll (openIters, result)を返す。
- resultを ! result に設定する。
- resultが
done なら、- openItersからiterをremoveする。
- modeが
"shortest" なら、- ?
IteratorCloseAll (openIters,ReturnCompletion (undefined ))を返す。
- ?
- そうでなく、modeが
"strict" なら、- i ≠ 0なら、
- ?
IteratorCloseAll (openIters,ThrowCompletion (a newly createdTypeError object))を返す。
- ?
- 1 ≤ k < iterCountである各
integer kについて、昇順で、Assert : iters[k]はnull でない。- openを
Completion (IteratorStep (iters[k]))とする。 - openが
abrupt completion なら、- openItersからiters[k]をremoveする。
- ?
IteratorCloseAll (openIters, open)を返す。
- openを ! open に設定する。
- openが
done なら、- openItersからiters[k]をremoveする。
- そうでなければ、
- ?
IteratorCloseAll (openIters,ThrowCompletion (a newly createdTypeError object))を返す。
- ?
ReturnCompletion (undefined )を返す。
- i ≠ 0なら、
- そうでなければ、
Assert : modeは"longest" である。- openItersがemptyなら、
ReturnCompletion (undefined )を返す。 - iters[i]を
null に設定する。 - resultをpadding[i]に設定する。
- resultを
- resultをresultsにappendする。
- resultsをfinishResults(results)に設定する。
- completionを
Completion (Yield (results))とする。 IfAbruptCloseIterators (completion, openIters).
- resultsをnew empty
- iterCount = 0なら、
- genを
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterators]] »)とする。 - gen.[[UnderlyingIterators]]をopenItersに設定する。
- genを返す。
27.1.4 %AsyncIteratorPrototype%オブジェクト
%AsyncIteratorPrototype% objectは：
- valueが
%Object.prototype% である[[Prototype]] internal slotを持つ。 ordinary object である。
このspecificationでdefinedされる、
27.1.4.1 %AsyncIteratorPrototype% [ %Symbol.asyncDispose% ] ( )
このメソッドは、呼び出されたときに次のステップを実行する:
- obj を
this 値とする。 - promiseCapability を !
NewPromiseCapability (%Promise% ) とする。 - return を
Completion (GetMethod (obj,"return" ))) とする。 IfAbruptRejectPromise (return, promiseCapability).- return が
undefined である場合、then- !
Call (promiseCapability.[[Resolve]],undefined , «undefined ») を実行する。
- !
- Else,
- result を
Completion (Call (return, obj, « »)) とする。 IfAbruptRejectPromise (result, promiseCapability).- resultWrapper を
Completion (PromiseResolve (%Promise% , result)) とする。 IfAbruptRejectPromise (resultWrapper, promiseCapability).- unwrap を、何もキャプチャせず、呼び出されたときに次のステップを実行する、パラメータを持たない新しい
Abstract Closure とする:undefined を返す。
- onFulfilled を
CreateBuiltinFunction (unwrap, 1,"" , « ») とする。 PerformPromiseThen (resultWrapper, onFulfilled,undefined , promiseCapability) を実行する。
- result を
- promiseCapability.[[Promise]] を返す。
このメソッドの
27.1.4.2 %AsyncIteratorPrototype% [ %Symbol.asyncIterator% ] ( )
このfunctionは、呼び出されたときに以下のstepsを実行する：
this valueを返す。
このfunctionの
27.1.5 Async-from-Sync Iteratorオブジェクト
Async-from-Sync Iterator objectは、特定のsynchronous
27.1.5.1 CreateAsyncFromSyncIterator ( syncIteratorRecord )
The abstract operation CreateAsyncFromSyncIterator takes argument syncIteratorRecord (an
- asyncIteratorを
OrdinaryObjectCreate (%AsyncFromSyncIteratorPrototype% , « [[SyncIteratorRecord]] »)とする。 - asyncIterator.[[SyncIteratorRecord]]をsyncIteratorRecordに設定する。
- nextMethodを !
Get (asyncIterator,"next" ) とする。 - iteratorRecordを
Iterator Record { [[Iterator]]: asyncIterator, [[NextMethod]]: nextMethod, [[Done]]:false }とする。 - iteratorRecordを返す。
27.1.5.2 %AsyncFromSyncIteratorPrototype%オブジェクト
%AsyncFromSyncIteratorPrototype% objectは：
- すべての
Async-from-Sync Iterator objects によってinheritedされるpropertiesを持つ。 ordinary object である。- valueが
%AsyncIteratorPrototype% である[[Prototype]] internal slotを持つ。 - ECMAScript codeから直接accessされることは決してない。
- 以下のpropertiesを持つ：
27.1.5.2.1 %AsyncFromSyncIteratorPrototype%.next ( [ value ] )
- objを
this valueとする。 Assert : objは[[SyncIteratorRecord]] internal slotを持つObjectである。- promiseCapabilityを !
NewPromiseCapability (%Promise% ) とする。 - syncIteratorRecordをobj.[[SyncIteratorRecord]]とする。
- valueが存在するなら、
- resultを
Completion (IteratorNext (syncIteratorRecord, value))とする。
- resultを
- そうでなければ、
- resultを
Completion (IteratorNext (syncIteratorRecord))とする。
- resultを
IfAbruptRejectPromise (result, promiseCapability).AsyncFromSyncIteratorContinuation (result, promiseCapability, syncIteratorRecord,true )を返す。
27.1.5.2.2 %AsyncFromSyncIteratorPrototype%.return ( [ value ] )
- objを
this valueとする。 Assert : objは[[SyncIteratorRecord]] internal slotを持つObjectである。- promiseCapabilityを !
NewPromiseCapability (%Promise% ) とする。 - syncIteratorRecordをobj.[[SyncIteratorRecord]]とする。
- syncIteratorをsyncIteratorRecord.[[Iterator]]とする。
- returnを
Completion (GetMethod (syncIterator,"return" ))とする。 IfAbruptRejectPromise (return, promiseCapability).- returnが
undefined なら、- iteratorResultを
CreateIteratorResultObject (value,true )とする。 - !
Call (promiseCapability.[[Resolve]],undefined , « iteratorResult »)を実行する。 - promiseCapability.[[Promise]]を返す。
- iteratorResultを
- valueが存在するなら、
- resultを
Completion (Call (return, syncIterator, « value »))とする。
- resultを
- そうでなければ、
- resultを
Completion (Call (return, syncIterator))とする。
- resultを
IfAbruptRejectPromise (result, promiseCapability).- resultがObjectでないなら、
- !
Call (promiseCapability.[[Reject]],undefined , « a newly createdTypeError object »)を実行する。 - promiseCapability.[[Promise]]を返す。
- !
AsyncFromSyncIteratorContinuation (result, promiseCapability, syncIteratorRecord,false )を返す。
27.1.5.2.3 %AsyncFromSyncIteratorPrototype%.throw ( [ value ] )
- objを
this valueとする。 Assert : objは[[SyncIteratorRecord]] internal slotを持つObjectである。- promiseCapabilityを !
NewPromiseCapability (%Promise% ) とする。 - syncIteratorRecordをobj.[[SyncIteratorRecord]]とする。
- syncIteratorをsyncIteratorRecord.[[Iterator]]とする。
- throwを
Completion (GetMethod (syncIterator,"throw" ))とする。 IfAbruptRejectPromise (throw, promiseCapability).- throwが
undefined なら、NOTE : syncIteratorにthrowmethodがない場合、capabilityをrejectする前にcleanupの機会を与えるためにそれをcloseする。- closeCompletionを
NormalCompletion (empty )とする。 - resultを
Completion (IteratorClose (syncIteratorRecord, closeCompletion))とする。 IfAbruptRejectPromise (result, promiseCapability).NOTE : 次のstepは、protocol violationがあったことを示すためにTypeError をthrowする：syncIteratorはthrowmethodを持たない。NOTE : syncIteratorのclosingがthrowしない場合、そのoperationのresultは、それがrejected promiseをyieldする場合であっても無視される。- !
Call (promiseCapability.[[Reject]],undefined , « a newly createdTypeError object »)を実行する。 - promiseCapability.[[Promise]]を返す。
- valueが存在するなら、
- resultを
Completion (Call (throw, syncIterator, « value »))とする。
- resultを
- そうでなければ、
- resultを
Completion (Call (throw, syncIterator))とする。
- resultを
IfAbruptRejectPromise (result, promiseCapability).- resultがObjectでないなら、
- !
Call (promiseCapability.[[Reject]],undefined , « a newly createdTypeError object »)を実行する。 - promiseCapability.[[Promise]]を返す。
- !
AsyncFromSyncIteratorContinuation (result, promiseCapability, syncIteratorRecord,true )を返す。
27.1.5.3 Async-from-Sync Iteratorインスタンスのプロパティ
Async-from-Sync
| Internal Slot | Type | Description |
|---|---|---|
| [[SyncIteratorRecord]] |
|
adaptされているoriginal synchronous |
27.1.5.4 AsyncFromSyncIteratorContinuation ( result, promiseCapability, syncIteratorRecord, closeOnRejection )
The abstract operation AsyncFromSyncIteratorContinuation takes arguments result (an Object), promiseCapability (a
NOTE : promiseCapabilityはintrinsic%Promise% からderivedされるため、下記のIfAbruptRejectPromise の使用によって必要となるpromiseCapability.[[Reject]]へのcallsは、throwしないことがguaranteedされる。- doneを
Completion (IteratorComplete (result))とする。 IfAbruptRejectPromise (done, promiseCapability).- valueを
Completion (IteratorValue (result))とする。 IfAbruptRejectPromise (value, promiseCapability).- valueWrapperを
Completion (PromiseResolve (%Promise% , value))とする。 - valueWrapperが
abrupt completion で、doneがfalse で、closeOnRejectionがtrue なら、- valueWrapperを
Completion (IteratorClose (syncIteratorRecord, valueWrapper))に設定する。
- valueWrapperを
IfAbruptRejectPromise (valueWrapper, promiseCapability).- unwrapを、parameters (v)を持ち、doneをcaptureし、呼び出されたときに以下のstepsを実行するnew
Abstract Closure とする：CreateIteratorResultObject (v, done)を返す。
- onFulfilledを
CreateBuiltinFunction (unwrap, 1,"" , « »)とする。 NOTE : onFulfilledは、IteratorResult object の"value" propertyを処理するとき、そのvalueがpromiseである場合にそれを待ち、resultを新しい“unwrapped”IteratorResult object に再packageするために使用される。- doneが
true またはcloseOnRejectionがfalse なら、- onRejectedを
undefined とする。
- onRejectedを
- そうでなければ、
- closeIteratorを、parameters (error)を持ち、syncIteratorRecordをcaptureし、呼び出されたときに以下のstepsを実行するnew
Abstract Closure とする：- ?
IteratorClose (syncIteratorRecord,ThrowCompletion (error))を返す。
- ?
- onRejectedを
CreateBuiltinFunction (closeIterator, 1,"" , « »)とする。 NOTE : onRejectedは、Iterator がyieldするIteratorResult object の"value" propertyがrejected promiseである場合に、そのIterator をcloseするために使用される。
- closeIteratorを、parameters (error)を持ち、syncIteratorRecordをcaptureし、呼び出されたときに以下のstepsを実行するnew
PerformPromiseThen (valueWrapper, onFulfilled, onRejected, promiseCapability)を実行する。- promiseCapability.[[Promise]]を返す。
27.2 リソース管理
27.2.1 共通リソース管理インターフェイス
27.2.1.1 Disposable インターフェイス
Disposable インターフェイスは、
| プロパティ | 値 | 要件 |
|---|---|---|
%Symbol.dispose%
|
関数オブジェクト |
このメソッドを呼び出すことにより、呼び出し元がこのオブジェクトを引き続き使用する意図がないことを 同じオブジェクトに対してこのメソッドを複数回呼び出す場合、すでに破棄済みのリソースに対してクリーンアップロジックを繰り返すことを避けるべきであり、最初の呼び出しで例外が投げられた場合であっても、例外を投げるべきではない。ただし、この要件は強制されない。
|
27.2.1.2 AsyncDisposable インターフェイス
AsyncDisposable インターフェイスは、
| プロパティ | 値 | 要件 |
|---|---|---|
%Symbol.asyncDispose%
|
promise を返す関数オブジェクト |
このメソッドを呼び出すことにより、呼び出し元がこのオブジェクトを引き続き使用する意図がないことを 同じオブジェクトに対してこのメソッドを複数回呼び出す場合、すでに破棄済みのリソースに対してクリーンアップロジックを繰り返すことを避けるべきであり、最初の呼び出しで例外が投げられた場合または rejected promise が返された場合であっても、例外を投げたり rejected promise を返したりするべきではない。ただし、この要件は強制されない。
|
27.3 DisposableStack オブジェクト
DisposableStack は、まとめて破棄されるべき1つ以上のリソースを格納するために使用できるオブジェクトである。
任意の DisposableStack オブジェクトは、互いに排他的な2つの状態、すなわち disposed または pending のいずれかにある。disposable stack d は、d.dispose() も d.move() も d に対して呼び出されていない場合に限り pending である。
27.3.1 DisposableStack コンストラクタ
DisposableStack コンストラクタは次のとおりである:
- %DisposableStack% である。
- グローバルオブジェクトの
"DisposableStack" プロパティの初期値である。 - コンストラクタとして呼び出されたとき、新しい DisposableStack を作成して初期化する。
- 関数として呼び出されることは意図されておらず、そのように呼び出された場合は例外を投げる。
- クラス定義の
extends節の値として使用できる。指定された DisposableStack の振る舞いを継承しようとするサブクラスコンストラクタは、DisposableStack.prototypeの組込みメソッドをサポートするために必要な内部状態を持つサブクラスインスタンスを作成して初期化するために、DisposableStack コンストラクタへのsuper呼び出しを含めなければならない。
27.3.1.1 DisposableStack ( )
この関数は、呼び出されたときに次のステップを実行する:
- NewTarget が
undefined である場合、TypeError 例外を投げる。 - disposableStack を ?
OrdinaryCreateFromConstructor (NewTarget,"%DisposableStack.prototype%" , « [[DisposableState]], [[DisposableResourceStack]] ») とする。 - disposableStack.[[DisposableState]] を
pending に設定する。 - disposableStack.[[DisposableResourceStack]] を新しい空の
List に設定する。 - disposableStack を返す。
27.3.2 DisposableStack コンストラクタのプロパティ
DisposableStack コンストラクタは次のとおりである:
- 値が
%Function.prototype% である [[Prototype]] 内部スロットを持つ。 - 次のプロパティを持つ:
27.3.2.1 DisposableStack.prototype
DisposableStack.prototype の初期値は
このプロパティは属性 { [[Writable]]:
27.3.3 DisposableStack プロトタイプオブジェクトのプロパティ
DisposableStack プロトタイプオブジェクトは次のとおりである:
- %DisposableStack.prototype% である。
- 値が
%Object.prototype% である [[Prototype]] 内部スロットを持つ。 - 通常のオブジェクトである。
- [[DisposableState]] 内部スロットも、DisposableStack インスタンスのその他の内部スロットも持たない。
27.3.3.1 DisposableStack.prototype.adopt ( value, onDispose )
このメソッドは、呼び出されたときに次のステップを実行する:
- disposableStack を
this 値とする。 - ?
RequireInternalSlot (disposableStack, [[DisposableState]]) を実行する。 - disposableStack.[[DisposableState]] が
disposed である場合、ReferenceError 例外を投げる。 IsCallable (onDispose) がfalse である場合、TypeError 例外を投げる。- closure を、value と onDispose をキャプチャし、呼び出されたときに次のステップを実行する、パラメータを持たない新しい
Abstract Closure とする:- Return ?
Call (onDispose,undefined , « value »).
- Return ?
- func を
CreateBuiltinFunction (closure, 0,"" , « ») とする。 - ?
AddDisposableResource (disposableStack.[[DisposableResourceStack]],undefined ,sync-dispose , func) を実行する。 - value を返す。
27.3.3.2 DisposableStack.prototype.constructor
DisposableStack.prototype.constructor の初期値は
27.3.3.3 DisposableStack.prototype.defer ( onDispose )
このメソッドは、呼び出されたときに次のステップを実行する:
- disposableStack を
this 値とする。 - ?
RequireInternalSlot (disposableStack, [[DisposableState]]) を実行する。 - disposableStack.[[DisposableState]] が
disposed である場合、ReferenceError 例外を投げる。 IsCallable (onDispose) がfalse である場合、TypeError 例外を投げる。- ?
AddDisposableResource (disposableStack.[[DisposableResourceStack]],undefined ,sync-dispose , onDispose) を実行する。 undefined を返す。
27.3.3.4 DisposableStack.prototype.dispose ( )
このメソッドは、呼び出されたときに次のステップを実行する:
- disposableStack を
this 値とする。 - ?
RequireInternalSlot (disposableStack, [[DisposableState]]) を実行する。 - disposableStack.[[DisposableState]] が
disposed である場合、undefined を返す。 - disposableStack.[[DisposableState]] を
disposed に設定する。 - Return ?
DisposeResources (disposableStack.[[DisposableResourceStack]],NormalCompletion (undefined )).
27.3.3.5 get DisposableStack.prototype.disposed
DisposableStack.prototype.disposed は、set アクセサ関数が
- disposableStack を
this 値とする。 - ?
RequireInternalSlot (disposableStack, [[DisposableState]]) を実行する。 - disposableStack.[[DisposableState]] が
disposed である場合、true を返す。 false を返す。
27.3.3.6 DisposableStack.prototype.move ( )
このメソッドは、呼び出されたときに次のステップを実行する:
- disposableStack を
this 値とする。 - ?
RequireInternalSlot (disposableStack, [[DisposableState]]) を実行する。 - disposableStack.[[DisposableState]] が
disposed である場合、ReferenceError 例外を投げる。 - newDisposableStack を ?
OrdinaryCreateFromConstructor (%DisposableStack% ,"%DisposableStack.prototype%" , « [[DisposableState]], [[DisposableResourceStack]] ») とする。 - newDisposableStack.[[DisposableState]] を
pending に設定する。 - newDisposableStack.[[DisposableResourceStack]] を disposableStack.[[DisposableResourceStack]] に設定する。
- disposableStack.[[DisposableResourceStack]] を新しい空の
List に設定する。 - disposableStack.[[DisposableState]] を
disposed に設定する。 - newDisposableStack を返す。
27.3.3.7 DisposableStack.prototype.use ( value )
このメソッドは、呼び出されたときに次のステップを実行する:
- disposableStack を
this 値とする。 - ?
RequireInternalSlot (disposableStack, [[DisposableState]]) を実行する。 - disposableStack.[[DisposableState]] が
disposed である場合、ReferenceError 例外を投げる。 - ?
AddDisposableResource (disposableStack.[[DisposableResourceStack]], value,sync-dispose ) を実行する。 - value を返す。
27.3.3.8 DisposableStack.prototype [ %Symbol.dispose% ] ( )
%Symbol.dispose% プロパティの初期値は、
27.3.3.9 DisposableStack.prototype [ %Symbol.toStringTag% ]
%Symbol.toStringTag% プロパティの初期値は String 値
このプロパティは属性 { [[Writable]]:
27.3.4 DisposableStack インスタンスのプロパティ
DisposableStack インスタンスは、
| 内部スロット | 型 | 説明 |
|---|---|---|
| [[DisposableState]] |
|
disposable stack が自身の %Symbol.dispose% メソッドへの着信呼び出しにどのように反応するかを制御する。
|
| [[DisposableResourceStack]] |
|
disposable stack が破棄されるときに破棄されるリソース。リソースは初期化された順に追加され、逆順に破棄される。 |
27.4 AsyncDisposableStack オブジェクト
AsyncDisposableStack は、非同期にまとめて破棄されるべき1つ以上のリソースを格納するために使用できるオブジェクトである。
任意の AsyncDisposableStack オブジェクトは、互いに排他的な2つの状態、すなわち disposed または pending のいずれかにある。async-disposable stack d は、d.disposeAsync() も d.move() も d に対して呼び出されていない場合に限り pending である。
27.4.1 AsyncDisposableStack コンストラクタ
AsyncDisposableStack コンストラクタは次のとおりである:
- %AsyncDisposableStack% である。
- グローバルオブジェクトの
"AsyncDisposableStack" プロパティの初期値である。 - コンストラクタとして呼び出されたとき、新しい AsyncDisposableStack を作成して初期化する。
- 関数として呼び出されることは意図されておらず、そのように呼び出された場合は例外を投げる。
- クラス定義の
extends節の値として使用できる。指定された AsyncDisposableStack の振る舞いを継承しようとするサブクラスコンストラクタは、AsyncDisposableStack.prototypeの組込みメソッドをサポートするために必要な内部状態を持つサブクラスインスタンスを作成して初期化するために、AsyncDisposableStack コンストラクタへのsuper呼び出しを含めなければならない。
27.4.1.1 AsyncDisposableStack ( )
この関数は、呼び出されたときに次のステップを実行する:
- NewTarget が
undefined である場合、TypeError 例外を投げる。 - asyncDisposableStack を ?
OrdinaryCreateFromConstructor (NewTarget,"%AsyncDisposableStack.prototype%" , « [[AsyncDisposableState]], [[DisposableResourceStack]] ») とする。 - asyncDisposableStack.[[AsyncDisposableState]] を
pending に設定する。 - asyncDisposableStack.[[DisposableResourceStack]] を新しい空の
List に設定する。 - asyncDisposableStack を返す。
27.4.2 AsyncDisposableStack コンストラクタのプロパティ
AsyncDisposableStack コンストラクタは次のとおりである:
- 値が
%Function.prototype% である [[Prototype]] 内部スロットを持つ。 - 次のプロパティを持つ:
27.4.2.1 AsyncDisposableStack.prototype
AsyncDisposableStack.prototype の初期値は
このプロパティは属性 { [[Writable]]:
27.4.3 AsyncDisposableStack プロトタイプオブジェクトのプロパティ
AsyncDisposableStack プロトタイプオブジェクトは次のとおりである:
- %AsyncDisposableStack.prototype% である。
- 値が
%Object.prototype% である [[Prototype]] 内部スロットを持つ。 - 通常のオブジェクトである。
- [[AsyncDisposableState]] 内部スロットも、AsyncDisposableStack インスタンスのその他の内部スロットも持たない。
27.4.3.1 AsyncDisposableStack.prototype.adopt ( value, onDisposeAsync )
このメソッドは、呼び出されたときに次のステップを実行する:
- asyncDisposableStack を
this 値とする。 - ?
RequireInternalSlot (asyncDisposableStack, [[AsyncDisposableState]]) を実行する。 - asyncDisposableStack.[[AsyncDisposableState]] が
disposed である場合、ReferenceError 例外を投げる。 IsCallable (onDisposeAsync) がfalse である場合、TypeError 例外を投げる。- closure を、value と onDisposeAsync をキャプチャし、呼び出されたときに次のステップを実行する、パラメータを持たない新しい
Abstract Closure とする:- Return ?
Call (onDisposeAsync,undefined , « value »).
- Return ?
- func を
CreateBuiltinFunction (closure, 0,"" , « ») とする。 - ?
AddDisposableResource (asyncDisposableStack.[[DisposableResourceStack]],undefined ,async-dispose , func) を実行する。 - value を返す。
27.4.3.2 AsyncDisposableStack.prototype.constructor
AsyncDisposableStack.prototype.constructor の初期値は
27.4.3.3 AsyncDisposableStack.prototype.defer ( onDisposeAsync )
このメソッドは、呼び出されたときに次のステップを実行する:
- asyncDisposableStack を
this 値とする。 - ?
RequireInternalSlot (asyncDisposableStack, [[AsyncDisposableState]]) を実行する。 - asyncDisposableStack.[[AsyncDisposableState]] が
disposed である場合、ReferenceError 例外を投げる。 IsCallable (onDisposeAsync) がfalse である場合、TypeError 例外を投げる。- ?
AddDisposableResource (asyncDisposableStack.[[DisposableResourceStack]],undefined ,async-dispose , onDisposeAsync) を実行する。 undefined を返す。
27.4.3.4 AsyncDisposableStack.prototype.disposeAsync ( )
この async メソッドは、呼び出されたときに次のステップを実行する:
- asyncDisposableStack を
this 値とする。 - ?
RequireInternalSlot (asyncDisposableStack, [[AsyncDisposableState]]) を実行する。 - asyncDisposableStack.[[AsyncDisposableState]] が
disposed である場合、undefined を返す。 - asyncDisposableStack.[[AsyncDisposableState]] を
disposed に設定する。 - Return ?
DisposeResources (asyncDisposableStack.[[DisposableResourceStack]],NormalCompletion (undefined )).
27.4.3.5 get AsyncDisposableStack.prototype.disposed
AsyncDisposableStack.prototype.disposed は、set アクセサ関数が
- asyncDisposableStack を
this 値とする。 - ?
RequireInternalSlot (asyncDisposableStack, [[AsyncDisposableState]]) を実行する。 - asyncDisposableStack.[[AsyncDisposableState]] が
disposed である場合、true を返す。 false を返す。
27.4.3.6 AsyncDisposableStack.prototype.move ( )
このメソッドは、呼び出されたときに次のステップを実行する:
- asyncDisposableStack を
this 値とする。 - ?
RequireInternalSlot (asyncDisposableStack, [[AsyncDisposableState]]) を実行する。 - asyncDisposableStack.[[AsyncDisposableState]] が
disposed である場合、ReferenceError 例外を投げる。 - newAsyncDisposableStack を ?
OrdinaryCreateFromConstructor (%AsyncDisposableStack% ,"%AsyncDisposableStack.prototype%" , « [[AsyncDisposableState]], [[DisposableResourceStack]] ») とする。 - newAsyncDisposableStack.[[AsyncDisposableState]] を
pending に設定する。 - newAsyncDisposableStack.[[DisposableResourceStack]] を asyncDisposableStack.[[DisposableResourceStack]] に設定する。
- asyncDisposableStack.[[DisposableResourceStack]] を新しい空の
List に設定する。 - asyncDisposableStack.[[AsyncDisposableState]] を
disposed に設定する。 - newAsyncDisposableStack を返す。
27.4.3.7 AsyncDisposableStack.prototype.use ( value )
このメソッドは、呼び出されたときに次のステップを実行する:
- asyncDisposableStack を
this 値とする。 - ?
RequireInternalSlot (asyncDisposableStack, [[AsyncDisposableState]]) を実行する。 - asyncDisposableStack.[[AsyncDisposableState]] が
disposed である場合、ReferenceError 例外を投げる。 - ?
AddDisposableResource (asyncDisposableStack.[[DisposableResourceStack]], value,async-dispose ) を実行する。 - value を返す。
27.4.3.8 AsyncDisposableStack.prototype [ %Symbol.asyncDispose% ] ( )
%Symbol.asyncDispose% プロパティの初期値は、
27.4.3.9 AsyncDisposableStack.prototype [ %Symbol.toStringTag% ]
%Symbol.toStringTag% プロパティの初期値は String 値
このプロパティは属性 { [[Writable]]:
27.4.4 AsyncDisposableStack インスタンスのプロパティ
AsyncDisposableStack インスタンスは、
| 内部スロット | 型 | 説明 |
|---|---|---|
| [[AsyncDisposableState]] |
|
disposable stack が自身の %Symbol.asyncDispose% メソッドへの着信呼び出しにどのように反応するかを制御する。
|
| [[DisposableResourceStack]] |
|
disposable stack が破棄されるときに破棄されるリソース。リソースは初期化された順に追加され、逆順に破棄される。 |
27.5 Promiseオブジェクト
Promiseは、遅延された（かつ場合によっては非同期の）計算の最終的な結果のplaceholderとして使用されるobjectである。
任意のPromiseは、互いに排他的な3つのstate、すなわちfulfilled、rejected、およびpendingのいずれかにある：
-
promise
pは、p.then(f, r)がfunctionfをcallするJob をただちにenqueueするならfulfilledである。 -
promise
pは、p.then(f, r)がfunctionrをcallするJob をただちにenqueueするならrejectedである。 - promiseは、fulfilledでもrejectedでもないならpendingである。
promiseは、pendingでない場合、すなわちfulfilledまたはrejectedのいずれかである場合、settledであるという。
promiseは、settledであるか、または別のpromiseのstateと一致するように“locked in”されているなら、resolvedである。resolved promiseをresolveまたはrejectしようとしても効果はない。promiseは、resolvedでないならunresolvedである。unresolved promiseは常にpending stateにある。resolved promiseはpending、fulfilled、またはrejectedでありうる。
27.5.1 Promise Abstract Operations
27.5.1.1 PromiseCapability Records
PromiseCapability Recordは、Promiseまたはpromise-like objectを、そのpromiseをresolveまたはrejectできるfunctionsとともにencapsulateするために使用される
PromiseCapability Recordsは、
| Field Name | Value | Meaning |
|---|---|---|
| [[Promise]] | Object | promiseとして使用可能なobject。 |
| [[Resolve]] |
|
与えられたpromiseをresolveするために使用されるfunction。 |
| [[Reject]] |
|
与えられたpromiseをrejectするために使用されるfunction。 |
27.5.1.1.1 IfAbruptRejectPromise ( value, capability )
IfAbruptRejectPromiseは、
IfAbruptRejectPromise (value, capability).
は、次と同じ意味である：
Assert : valueはCompletion Record である。- valueが
abrupt completion なら、- ?
Call (capability.[[Reject]],undefined , « value.[[Value]] »)を実行する。 - capability.[[Promise]]を返す。
- ?
- valueを ! value に設定する。
27.5.1.2 PromiseReaction Records
PromiseReaction Recordは、promiseが与えられたvalueでresolvedまたはrejectedになったときに、どのようにreactすべきかについての情報を格納するために使用される
PromiseReaction Recordsは、
| Field Name | Value | Meaning |
|---|---|---|
| [[Capability]] |
|
このrecordがreaction handlerを提供するpromiseのcapabilities。 |
| [[Type]] |
|
[[Type]]は、[[Handler]]が |
| [[Handler]] |
|
incoming valueに適用されるべきfunctionであり、そのreturn valueがderived promiseに何が起こるかをgovernする。[[Handler]]が |
27.5.1.3 CreateResolvingFunctions ( toResolve )
The abstract operation CreateResolvingFunctions takes argument toResolve (a Promise) and returns a
- promiseOrEmptyを
Record { [[Value]]: toResolve }とする。 - resolveStepsを、parameters (resolution)を持ち、promiseOrEmptyをcaptureし、呼び出されたときに以下のstepsを実行するnew
Abstract Closure とする：- promiseOrEmpty.[[Value]]が
empty なら、undefined を返す。 - promiseをpromiseOrEmpty.[[Value]]とする。
- promiseOrEmpty.[[Value]]を
empty に設定する。 SameValue (resolution, promise)がtrue なら、- selfResolutionErrorをnewly created
TypeError objectとする。 RejectPromise (promise, selfResolutionError)を実行する。undefined を返す。
- selfResolutionErrorをnewly created
- resolutionがObjectでないなら、
FulfillPromise (promise, resolution)を実行する。undefined を返す。
- thenを
Completion (Get (resolution,"then" ))とする。 - thenが
abrupt completion なら、RejectPromise (promise, then.[[Value]])を実行する。undefined を返す。
- thenActionをthen.[[Value]]とする。
IsCallable (thenAction)がfalse なら、FulfillPromise (promise, resolution)を実行する。undefined を返す。
- thenJobCallbackを
HostMakeJobCallback (thenAction)とする。 - jobを
NewPromiseResolveThenableJob (promise, resolution, thenJobCallback)とする。 HostEnqueuePromiseJob (job.[[Job]], job.[[Realm]])を実行する。undefined を返す。
- promiseOrEmpty.[[Value]]が
- resolveを
CreateBuiltinFunction (resolveSteps, 1,"" , « »)とする。 - rejectStepsを、parameters (reason)を持ち、promiseOrEmptyをcaptureし、呼び出されたときに以下のstepsを実行するnew
Abstract Closure とする：- promiseOrEmpty.[[Value]]が
empty なら、undefined を返す。 - promiseをpromiseOrEmpty.[[Value]]とする。
- promiseOrEmpty.[[Value]]を
empty に設定する。 RejectPromise (promise, reason)を実行する。undefined を返す。
- promiseOrEmpty.[[Value]]が
- rejectを
CreateBuiltinFunction (rejectSteps, 1,"" , « »)とする。 Record { [[Resolve]]: resolve, [[Reject]]: reject }を返す。
27.5.1.4 FulfillPromise ( promise, value )
The abstract operation FulfillPromise takes arguments promise (a Promise) and value (an ECMAScript language value) and returns
Assert : promise.[[PromiseState]]はpending である。- reactionsをpromise.[[PromiseFulfillReactions]]とする。
- promise.[[PromiseResult]]をvalueに設定する。
- promise.[[PromiseFulfillReactions]]を
undefined に設定する。 - promise.[[PromiseRejectReactions]]を
undefined に設定する。 - promise.[[PromiseState]]を
fulfilled に設定する。 TriggerPromiseReactions (reactions, value)を実行する。unused を返す。
27.5.1.5 NewPromiseCapability ( ctor )
The abstract operation NewPromiseCapability takes argument ctor (an ECMAScript language value) and returns either a resolveおよびreject functionsをextractしようとする。promiseとresolveおよびreject functionsは、new
IsConstructor (ctor)がfalse なら、TypeError 例外をthrowする。NOTE : ctorは、Promiseconstructor のparameter conventionsをsupportするconstructor functionであるとassumedされる（27.5.3.1 を参照）。- resolvingFuncsを
Record { [[Resolve]]:undefined , [[Reject]]:undefined }とする。 - executorClosureを、parameters (resolve, reject)を持ち、resolvingFuncsをcaptureし、呼び出されたときに以下のstepsを実行するnew
Abstract Closure とする：- resolvingFuncs.[[Resolve]]が
undefined でないなら、TypeError 例外をthrowする。 - resolvingFuncs.[[Reject]]が
undefined でないなら、TypeError 例外をthrowする。 - resolvingFuncs.[[Resolve]]をresolveに設定する。
- resolvingFuncs.[[Reject]]をrejectに設定する。
NormalCompletion (undefined )を返す。
- resolvingFuncs.[[Resolve]]が
- executorを
CreateBuiltinFunction (executorClosure, 2,"" , « »)とする。 - promiseを ?
Construct (ctor, « executor ») とする。 IsCallable (resolvingFuncs.[[Resolve]])がfalse なら、TypeError 例外をthrowする。IsCallable (resolvingFuncs.[[Reject]])がfalse なら、TypeError 例外をthrowする。PromiseCapability Record { [[Promise]]: promise, [[Resolve]]: resolvingFuncs.[[Resolve]], [[Reject]]: resolvingFuncs.[[Reject]] }を返す。
このabstract operationはPromise subclassingをsupportする。これは、Promise
27.5.1.6 IsPromise ( arg )
The abstract operation IsPromise takes argument arg (an ECMAScript language value) and returns a Boolean. これはobject上のpromise brandをcheckする。 It performs the following steps when called:
- argがObjectでないなら、
false を返す。 - argが[[PromiseState]] internal slotを持たないなら、
false を返す。 true を返す。
27.5.1.7 RejectPromise ( promise, reason )
The abstract operation RejectPromise takes arguments promise (a Promise) and reason (an ECMAScript language value) and returns
Assert : promise.[[PromiseState]]はpending である。- reactionsをpromise.[[PromiseRejectReactions]]とする。
- promise.[[PromiseResult]]をreasonに設定する。
- promise.[[PromiseFulfillReactions]]を
undefined に設定する。 - promise.[[PromiseRejectReactions]]を
undefined に設定する。 - promise.[[PromiseState]]を
rejected に設定する。 - promise.[[PromiseIsHandled]]が
false なら、HostPromiseRejectionTracker (promise,"reject" )を実行する。 TriggerPromiseReactions (reactions, reason)を実行する。unused を返す。
27.5.1.8 TriggerPromiseReactions ( reactions, arg )
The abstract operation TriggerPromiseReactions takes arguments reactions (a
- reactionsの各element reactionについて、
- jobを
NewPromiseReactionJob (reaction, arg)とする。 HostEnqueuePromiseJob (job.[[Job]], job.[[Realm]])を実行する。
- jobを
unused を返す。
27.5.1.9 HostPromiseRejectionTracker ( promise, operation )
The
HostPromiseRejectionTrackerのdefault implementationは
HostPromiseRejectionTrackerは2つのscenariosでcallされる：
- promiseがhandlersなしでrejectedされるとき、operation argumentを
"reject" に設定してcallされる。 - rejected promiseに初めてhandlerが追加されるとき、operation argumentを
"handle" に設定してcallされる。
HostPromiseRejectionTrackerの典型的なimplementationは、unhandled rejectionsをdevelopersに通知しようとしつつ、そのような以前のnotificationsが後から新しいhandlersのattachによってinvalidatedされる場合にも通知するよう注意するかもしれない。
operationが
27.5.2 Promise Jobs
27.5.2.1 NewPromiseReactionJob ( reaction, arg )
The abstract operation NewPromiseReactionJob takes arguments reaction (a
- jobを、parametersを持たず、reactionおよびargをcaptureし、呼び出されたときに以下のstepsを実行するnew
Job Abstract Closure とする：- promiseCapabilityをreaction.[[Capability]]とする。
- typeをreaction.[[Type]]とする。
- handlerをreaction.[[Handler]]とする。
- handlerが
empty なら、- typeが
fulfill なら、- handlerResultを
NormalCompletion (arg)とする。
- handlerResultを
- そうでなければ、
Assert : typeはreject である。- handlerResultを
ThrowCompletion (arg)とする。
- typeが
- そうでなければ、
- handlerResultを
Completion (HostCallJobCallback (handler,undefined , « arg »))とする。
- handlerResultを
- promiseCapabilityが
undefined なら、Assert : handlerResultはabrupt completion でない。empty を返す。
Assert : promiseCapabilityはPromiseCapability Record である。- handlerResultが
abrupt completion なら、- ?
Call (promiseCapability.[[Reject]],undefined , « handlerResult.[[Value]] »)を返す。
- ?
- ?
Call (promiseCapability.[[Resolve]],undefined , « handlerResult.[[Value]] »)を返す。
- handlerRealmを
null とする。 - reaction.[[Handler]]が
empty でないなら、- getHandlerRealmResultを
Completion (GetFunctionRealm (reaction.[[Handler]].[[Callback]]))とする。 - getHandlerRealmResultが
normal completion なら、handlerRealmをgetHandlerRealmResult.[[Value]]に設定する。 - そうでなければ、handlerRealmを
current Realm Record に設定する。 NOTE : handlerがundefined でない限り、handlerRealmは決してnull ではない。handlerがrevoked ProxyでありECMAScript codeが実行されない場合、handlerRealmはerror objectsをcreateするために使用される。
- getHandlerRealmResultを
Record { [[Job]]: job, [[Realm]]: handlerRealm }を返す。
27.5.2.2 NewPromiseResolveThenableJob ( promiseToResolve, thenable, then )
The abstract operation NewPromiseResolveThenableJob takes arguments promiseToResolve (a Promise), thenable (an Object), and then (a
- jobを、parametersを持たず、promiseToResolve、thenable、およびthenをcaptureし、呼び出されたときに以下のstepsを実行するnew
Job Abstract Closure とする：- resolvingFuncsを
CreateResolvingFunctions (promiseToResolve)とする。 - thenCallResultを
Completion (HostCallJobCallback (then, thenable, « resolvingFuncs.[[Resolve]], resolvingFuncs.[[Reject]] »))とする。 - thenCallResultが
abrupt completion なら、- ?
Call (resolvingFuncs.[[Reject]],undefined , « thenCallResult.[[Value]] »)を返す。
- ?
- ! thenCallResultを返す。
- resolvingFuncsを
- getThenRealmResultを
Completion (GetFunctionRealm (then.[[Callback]]))とする。 - getThenRealmResultが
normal completion なら、thenRealmをgetThenRealmResult.[[Value]]とする。 - そうでなければ、thenRealmを
current Realm Record とする。 NOTE : thenRealmは決してnull ではない。then.[[Callback]]がrevoked Proxyでありcodeが実行されない場合、thenRealmはerror objectsをcreateするために使用される。Record { [[Job]]: job, [[Realm]]: thenRealm }を返す。
27.5.3 Promiseコンストラクタ
Promise
- %Promise%である。
global object の"Promise" propertyのinitial valueである。constructor として呼び出されたときにnew Promiseをcreateしてinitializeする。- functionとして呼び出されることを意図しておらず、そのように呼び出された場合はexceptionをthrowする。
- クラス定義の
extends句内の値として使用できる。指定された Promise の動作を継承しようとするサブクラスコンストラクターは、PromiseおよびPromise.prototypeの組み込みメソッドをサポートするために必要な内部状態でサブクラスインスタンスを作成し初期化するため、Promise コンストラクターへのsuper呼び出しを含めなければならない。
27.5.3.1 Promise ( executor )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- NewTargetが
undefined なら、TypeError 例外をthrowする。 IsCallable (executor)がfalse なら、TypeError 例外をthrowする。- promiseを ?
OrdinaryCreateFromConstructor (NewTarget,"%Promise.prototype%" , « [[PromiseState]], [[PromiseResult]], [[PromiseFulfillReactions]], [[PromiseRejectReactions]], [[PromiseIsHandled]] ») とする。 - promise.[[PromiseState]]を
pending に設定する。 - promise.[[PromiseResult]]を
empty に設定する。 - promise.[[PromiseFulfillReactions]]をnew empty
List に設定する。 - promise.[[PromiseRejectReactions]]をnew empty
List に設定する。 - promise.[[PromiseIsHandled]]を
false に設定する。 - resolvingFuncsを
CreateResolvingFunctions (promise)とする。 - completionを
Completion (Call (executor,undefined , « resolvingFuncs.[[Resolve]], resolvingFuncs.[[Reject]] »))とする。 - completionが
abrupt completion なら、- ?
Call (resolvingFuncs.[[Reject]],undefined , « completion.[[Value]] »)を実行する。
- ?
- promiseを返す。
executor argumentは
executor functionに渡されるresolve functionは、single argumentを受け入れる。executor codeは最終的にresolve functionをcallして、関連付けられたPromiseをresolveしたいことを示してもよい。resolve functionに渡されるargumentは、deferred actionの最終的なvalueを表し、実際のfulfillment valueまたはfulfilledされた場合にvalueを提供する別のpromiseのいずれかでありうる。
executor functionに渡されるreject functionは、single argumentを受け入れる。executor codeは最終的にreject functionをcallして、関連付けられたPromiseがrejectedされ、決してfulfilledされないことを示してもよい。reject functionに渡されるargumentは、promiseのrejection valueとして使用される。典型的にはError objectである。
Promise
27.5.4 Promiseコンストラクタのプロパティ
Promise
- valueが
%Function.prototype% である[[Prototype]] internal slotを持つ。 - 以下のpropertiesを持つ：
27.5.4.1 Promise.all ( iterable )
このfunctionは、渡されたpromisesのfulfillment valuesのarrayでfulfilledされる、または最初にrejectする渡されたpromiseのreasonでrejectされるnew promiseを返す。このalgorithmを実行する際、渡された
- ctorを
this valueとする。 - promiseCapabilityを ?
NewPromiseCapability (ctor) とする。 - promiseResolveを
Completion (GetPromiseResolve (ctor))とする。 IfAbruptRejectPromise (promiseResolve, promiseCapability).- iteratorRecordを
Completion (GetIterator (iterable,sync ))とする。 IfAbruptRejectPromise (iteratorRecord, promiseCapability).- resultを
Completion (PerformPromiseAll (iteratorRecord, ctor, promiseCapability, promiseResolve))とする。 - resultが
abrupt completion なら、- iteratorRecord.[[Done]]が
false なら、resultをCompletion (IteratorClose (iteratorRecord, result))に設定する。 IfAbruptRejectPromise (result, promiseCapability).
- iteratorRecord.[[Done]]が
- ! resultを返す。
このfunctionは、その
27.5.4.1.1 GetPromiseResolve ( promiseCtor )
The abstract operation GetPromiseResolve takes argument promiseCtor (a
- promiseResolveを ?
Get (promiseCtor,"resolve" ) とする。 IsCallable (promiseResolve)がfalse なら、TypeError 例外をthrowする。- promiseResolveを返す。
27.5.4.1.2 PerformPromiseAll ( iteratorRecord, ctor, resultCapability, promiseResolve )
The abstract operation PerformPromiseAll takes arguments iteratorRecord (an
- valuesをnew empty
List とする。 NOTE : remainingElementsCountは、inputiterator がexhaustedされる前に渡されたcallbackをcallするmisbehaving"then" が存在する場合でも、resultCapability.[[Resolve]]が一度だけcallされることをensureするため、0ではなく1から始まる。- remainingElementsCountを
Record { [[Value]]: 1 }とする。 - indexを0とする。
- 繰り返す：
- nextを ?
IteratorStepValue (iteratorRecord) とする。 - nextが
done なら、- remainingElementsCount.[[Value]]をremainingElementsCount.[[Value]] - 1に設定する。
- remainingElementsCount.[[Value]] = 0なら、
- valuesArrayを
CreateArrayFromList (values)とする。 - ?
Call (resultCapability.[[Resolve]],undefined , « valuesArray »)を実行する。
- valuesArrayを
- resultCapability.[[Promise]]を返す。
undefined をvaluesにappendする。- nextPromiseを ?
Call (promiseResolve, ctor, « next ») とする。 - fulfilledStepsを、parameters (value)を持ち、values、resultCapability、およびremainingElementsCountをcaptureし、呼び出されたときに以下のstepsを実行するnew
Abstract Closure とする：- activeFuncを
active function object とする。 - activeFunc.[[AlreadyCalled]]が
true なら、undefined を返す。 - activeFunc.[[AlreadyCalled]]を
true に設定する。 - thisIndexをactiveFunc.[[Index]]とする。
- values[thisIndex]をvalueに設定する。
- remainingElementsCount.[[Value]]をremainingElementsCount.[[Value]] - 1に設定する。
- remainingElementsCount.[[Value]] = 0なら、
- valuesArrayを
CreateArrayFromList (values)とする。 - ?
Call (resultCapability.[[Resolve]],undefined , « valuesArray »)を返す。
- valuesArrayを
undefined を返す。
- activeFuncを
- onFulfilledを
CreateBuiltinFunction (fulfilledSteps, 1,"" , « [[AlreadyCalled]], [[Index]] »)とする。 - onFulfilled.[[AlreadyCalled]]を
false に設定する。 - onFulfilled.[[Index]]をindexに設定する。
- indexをindex + 1に設定する。
- remainingElementsCount.[[Value]]をremainingElementsCount.[[Value]] + 1に設定する。
- ?
Invoke (nextPromise,"then" , « onFulfilled, resultCapability.[[Reject]] »)を実行する。
- nextを ?
27.5.4.2 Promise.allSettled ( iterable )
このfunctionは、original promisesがすべてsettled、すなわちfulfilledまたはrejectedのいずれかになるまで待ってから、promise state snapshotsのarrayでfulfilledされるpromiseを返す。このalgorithmを実行する際、渡された
- ctorを
this valueとする。 - promiseCapabilityを ?
NewPromiseCapability (ctor) とする。 - promiseResolveを
Completion (GetPromiseResolve (ctor))とする。 IfAbruptRejectPromise (promiseResolve, promiseCapability).- iteratorRecordを
Completion (GetIterator (iterable,sync ))とする。 IfAbruptRejectPromise (iteratorRecord, promiseCapability).- resultを
Completion (PerformPromiseAllSettled (iteratorRecord, ctor, promiseCapability, promiseResolve))とする。 - resultが
abrupt completion なら、- iteratorRecord.[[Done]]が
false なら、resultをCompletion (IteratorClose (iteratorRecord, result))に設定する。 IfAbruptRejectPromise (result, promiseCapability).
- iteratorRecord.[[Done]]が
- ! resultを返す。
このfunctionは、その
27.5.4.2.1 PerformPromiseAllSettled ( iteratorRecord, ctor, resultCapability, promiseResolve )
The abstract operation PerformPromiseAllSettled takes arguments iteratorRecord (an
- valuesをnew empty
List とする。 NOTE : remainingElementsCountは、inputiterator がexhaustedされる前に渡されたcallbacksの1つをcallするmisbehaving"then" が存在する場合でも、resultCapability.[[Resolve]]が一度だけcallされることをensureするため、0ではなく1から始まる。- remainingElementsCountを
Record { [[Value]]: 1 }とする。 - indexを0とする。
- 繰り返す：
- nextを ?
IteratorStepValue (iteratorRecord) とする。 - nextが
done なら、- remainingElementsCount.[[Value]]をremainingElementsCount.[[Value]] - 1に設定する。
- remainingElementsCount.[[Value]] = 0なら、
- valuesArrayを
CreateArrayFromList (values)とする。 - ?
Call (resultCapability.[[Resolve]],undefined , « valuesArray »)を実行する。
- valuesArrayを
- resultCapability.[[Promise]]を返す。
undefined をvaluesにappendする。- nextPromiseを ?
Call (promiseResolve, ctor, « next ») とする。 - alreadyCalledを
Record { [[Value]]:false }とする。 - fulfilledStepsを、parameters (value)を持ち、values、resultCapability、およびremainingElementsCountをcaptureし、呼び出されたときに以下のstepsを実行するnew
Abstract Closure とする：- activeFuncを
active function object とする。 - activeFunc.[[AlreadyCalled]].[[Value]]が
true なら、undefined を返す。 - activeFunc.[[AlreadyCalled]].[[Value]]を
true に設定する。 - objを
OrdinaryObjectCreate (%Object.prototype% )とする。 - !
CreateDataPropertyOrThrow (obj,"status" ,"fulfilled" )を実行する。 - !
CreateDataPropertyOrThrow (obj,"value" , value)を実行する。 - thisIndexをactiveFunc.[[Index]]とする。
- values[thisIndex]をobjに設定する。
- remainingElementsCount.[[Value]]をremainingElementsCount.[[Value]] - 1に設定する。
- remainingElementsCount.[[Value]] = 0なら、
- valuesArrayを
CreateArrayFromList (values)とする。 - ?
Call (resultCapability.[[Resolve]],undefined , « valuesArray »)を返す。
- valuesArrayを
undefined を返す。
- activeFuncを
- onFulfilledを
CreateBuiltinFunction (fulfilledSteps, 1,"" , « [[AlreadyCalled]], [[Index]] »)とする。 - onFulfilled.[[AlreadyCalled]]をalreadyCalledに設定する。
- onFulfilled.[[Index]]をindexに設定する。
- rejectedStepsを、parameters (error)を持ち、values、resultCapability、およびremainingElementsCountをcaptureし、呼び出されたときに以下のstepsを実行するnew
Abstract Closure とする：- activeFuncを
active function object とする。 - activeFunc.[[AlreadyCalled]].[[Value]]が
true なら、undefined を返す。 - activeFunc.[[AlreadyCalled]].[[Value]]を
true に設定する。 - objを
OrdinaryObjectCreate (%Object.prototype% )とする。 - !
CreateDataPropertyOrThrow (obj,"status" ,"rejected" )を実行する。 - !
CreateDataPropertyOrThrow (obj,"reason" , error)を実行する。 - thisIndexをactiveFunc.[[Index]]とする。
- values[thisIndex]をobjに設定する。
- remainingElementsCount.[[Value]]をremainingElementsCount.[[Value]] - 1に設定する。
- remainingElementsCount.[[Value]] = 0なら、
- valuesArrayを
CreateArrayFromList (values)とする。 - ?
Call (resultCapability.[[Resolve]],undefined , « valuesArray »)を返す。
- valuesArrayを
undefined を返す。
- activeFuncを
- onRejectedを
CreateBuiltinFunction (rejectedSteps, 1,"" , « [[AlreadyCalled]], [[Index]] »)とする。 - onRejected.[[AlreadyCalled]]をalreadyCalledに設定する。
- onRejected.[[Index]]をindexに設定する。
- indexをindex + 1に設定する。
- remainingElementsCount.[[Value]]をremainingElementsCount.[[Value]] + 1に設定する。
- ?
Invoke (nextPromise,"then" , « onFulfilled, onRejected »)を実行する。
- nextを ?
27.5.4.3 Promise.any ( iterable )
このfunctionは、与えられたpromisesのうち最初にfulfilledされたpromiseによってfulfilledされるpromise、または与えられたpromisesがすべてrejectedされた場合にrejection reasonsを保持するAggregateErrorでrejectedされるpromiseを返す。このalgorithmを実行する際、渡された
- ctorを
this valueとする。 - promiseCapabilityを ?
NewPromiseCapability (ctor) とする。 - promiseResolveを
Completion (GetPromiseResolve (ctor))とする。 IfAbruptRejectPromise (promiseResolve, promiseCapability).- iteratorRecordを
Completion (GetIterator (iterable,sync ))とする。 IfAbruptRejectPromise (iteratorRecord, promiseCapability).- resultを
Completion (PerformPromiseAny (iteratorRecord, ctor, promiseCapability, promiseResolve))とする。 - resultが
abrupt completion なら、- iteratorRecord.[[Done]]が
false なら、resultをCompletion (IteratorClose (iteratorRecord, result))に設定する。 IfAbruptRejectPromise (result, promiseCapability).
- iteratorRecord.[[Done]]が
- ! resultを返す。
このfunctionは、そのPromise
27.5.4.3.1 PerformPromiseAny ( iteratorRecord, ctor, resultCapability, promiseResolve )
The abstract operation PerformPromiseAny takes arguments iteratorRecord (an
- errorsをnew empty
List とする。 NOTE : remainingElementsCountは、inputiterator がexhaustedされる前に渡されたcallbackをcallするmisbehaving"then" が存在する場合でも、resultCapability.[[Reject]]が一度だけcallされることをensureするため、0ではなく1から始まる。- remainingElementsCountを
Record { [[Value]]: 1 }とする。 - indexを0とする。
- 繰り返す：
- nextを ?
IteratorStepValue (iteratorRecord) とする。 - nextが
done なら、- remainingElementsCount.[[Value]]をremainingElementsCount.[[Value]] - 1に設定する。
- remainingElementsCount.[[Value]] = 0なら、
- aggregateErrorをnewly created
AggregateError objectとする。 - !
DefinePropertyOrThrow (aggregateError,"errors" , PropertyDescriptor { [[Configurable]]:true , [[Enumerable]]:false , [[Writable]]:true , [[Value]]:CreateArrayFromList (errors) })を実行する。 - ?
Call (resultCapability.[[Reject]],undefined , « aggregateError »)を実行する。
- aggregateErrorをnewly created
- resultCapability.[[Promise]]を返す。
undefined をerrorsにappendする。- nextPromiseを ?
Call (promiseResolve, ctor, « next ») とする。 - rejectedStepsを、parameters (error)を持ち、errors、resultCapability、およびremainingElementsCountをcaptureし、呼び出されたときに以下のstepsを実行するnew
Abstract Closure とする：- activeFuncを
active function object とする。 - activeFunc.[[AlreadyCalled]]が
true なら、undefined を返す。 - activeFunc.[[AlreadyCalled]]を
true に設定する。 - thisIndexをactiveFunc.[[Index]]とする。
- errors[thisIndex]をerrorに設定する。
- remainingElementsCount.[[Value]]をremainingElementsCount.[[Value]] - 1に設定する。
- remainingElementsCount.[[Value]] = 0なら、
- aggregateErrorをnewly created
AggregateError objectとする。 - !
DefinePropertyOrThrow (aggregateError,"errors" , PropertyDescriptor { [[Configurable]]:true , [[Enumerable]]:false , [[Writable]]:true , [[Value]]:CreateArrayFromList (errors) })を実行する。 - ?
Call (resultCapability.[[Reject]],undefined , « aggregateError »)を返す。
- aggregateErrorをnewly created
undefined を返す。
- activeFuncを
- onRejectedを
CreateBuiltinFunction (rejectedSteps, 1,"" , « [[AlreadyCalled]], [[Index]] »)とする。 - onRejected.[[AlreadyCalled]]を
false に設定する。 - onRejected.[[Index]]をindexに設定する。
- indexをindex + 1に設定する。
- remainingElementsCount.[[Value]]をremainingElementsCount.[[Value]] + 1に設定する。
- ?
Invoke (nextPromise,"then" , « resultCapability.[[Resolve]], onRejected »)を実行する。
- nextを ?
27.5.4.4 Promise.prototype
Promise.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
27.5.4.5 Promise.race ( iterable )
このfunctionは、最初にsettleする渡されたpromiseと同じ方法でsettledされるnew promiseを返す。このalgorithmを実行する際、渡されたiterableのすべてのelementsをpromisesにresolveする。
- ctorを
this valueとする。 - promiseCapabilityを ?
NewPromiseCapability (ctor) とする。 - promiseResolveを
Completion (GetPromiseResolve (ctor))とする。 IfAbruptRejectPromise (promiseResolve, promiseCapability).- iteratorRecordを
Completion (GetIterator (iterable,sync ))とする。 IfAbruptRejectPromise (iteratorRecord, promiseCapability).- resultを
Completion (PerformPromiseRace (iteratorRecord, ctor, promiseCapability, promiseResolve))とする。 - resultが
abrupt completion なら、- iteratorRecord.[[Done]]が
false なら、resultをCompletion (IteratorClose (iteratorRecord, result))に設定する。 IfAbruptRejectPromise (result, promiseCapability).
- iteratorRecord.[[Done]]が
- ! resultを返す。
iterable argumentがvaluesをyieldしない場合、またはiterableによってyieldされたpromisesのどれもsettleしない場合、このmethodによって返されるpending promiseは決してsettledされない。
このfunctionは、そのresolve methodをprovideすることもexpectedする。
27.5.4.5.1 PerformPromiseRace ( iteratorRecord, ctor, resultCapability, promiseResolve )
The abstract operation PerformPromiseRace takes arguments iteratorRecord (an
- 繰り返す：
- nextを ?
IteratorStepValue (iteratorRecord) とする。 - nextが
done なら、- resultCapability.[[Promise]]を返す。
- nextPromiseを ?
Call (promiseResolve, ctor, « next ») とする。 - ?
Invoke (nextPromise,"then" , « resultCapability.[[Resolve]], resultCapability.[[Reject]] »)を実行する。
- nextを ?
27.5.4.6 Promise.reject ( reason )
このfunctionは、渡されたargumentでrejectedされたnew promiseを返す。
- ctorを
this valueとする。 - promiseCapabilityを ?
NewPromiseCapability (ctor) とする。 - ?
Call (promiseCapability.[[Reject]],undefined , « reason »)を実行する。 - promiseCapability.[[Promise]]を返す。
このfunctionは、その
27.5.4.7 Promise.resolve ( resolution )
このfunctionは、渡されたargumentでresolvedされたnew promise、またはargumentがこの
- ctorを
this valueとする。 - ctorがObjectでないなら、
TypeError 例外をthrowする。 - ?
PromiseResolve (ctor, resolution)を返す。
このfunctionは、その
27.5.4.7.1 PromiseResolve ( ctor, resolution )
The abstract operation PromiseResolve takes arguments ctor (an Object) and resolution (an ECMAScript language value) and returns either a
IsPromise (resolution)がtrue なら、- promiseCapabilityを ?
NewPromiseCapability (ctor) とする。 - ?
Call (promiseCapability.[[Resolve]],undefined , « resolution »)を実行する。 - promiseCapability.[[Promise]]を返す。
27.5.4.8 Promise.try ( callback, ...args )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- ctorを
this valueとする。 - ctorがObjectでないなら、
TypeError 例外をthrowする。 - promiseCapabilityを ?
NewPromiseCapability (ctor) とする。 - statusを
Completion (Call (callback,undefined , args))とする。 - statusが
abrupt completion なら、- ?
Call (promiseCapability.[[Reject]],undefined , « status.[[Value]] »)を実行する。
- ?
- そうでなければ、
- ?
Call (promiseCapability.[[Resolve]],undefined , « status.[[Value]] »)を実行する。
- ?
- promiseCapability.[[Promise]]を返す。
このfunctionは、その
27.5.4.9 Promise.withResolvers ( )
このfunctionは、new promiseと、それに関連付けられたresolveおよびreject functionsからなる3つのpropertiesを持つobjectを返す。
- ctorを
this valueとする。 - promiseCapabilityを ?
NewPromiseCapability (ctor) とする。 - objを
OrdinaryObjectCreate (%Object.prototype% )とする。 - !
CreateDataPropertyOrThrow (obj,"promise" , promiseCapability.[[Promise]])を実行する。 - !
CreateDataPropertyOrThrow (obj,"resolve" , promiseCapability.[[Resolve]])を実行する。 - !
CreateDataPropertyOrThrow (obj,"reject" , promiseCapability.[[Reject]])を実行する。 - objを返す。
27.5.4.10 get Promise [ %Symbol.species% ]
Promise[%Symbol.species%]は、set accessor functionが
this valueを返す。
このfunctionの
Promise prototype methodsは通常、derived objectをcreateするために、その
27.5.5 Promise Prototype Objectのプロパティ
Promise prototype objectは：
- %Promise.prototype%である。
- valueが
%Object.prototype% である[[Prototype]] internal slotを持つ。 ordinary object である。- [[PromiseState]] internal slot、またはPromise instancesの他のinternal slotsを持たない。
27.5.5.1 Promise.prototype.catch ( onRejected )
このmethodは、呼び出されたときに以下のstepsを実行する：
- promiseを
this valueとする。 - ?
Invoke (promise,"then" , «undefined , onRejected »)を返す。
27.5.5.2 Promise.prototype.constructor
Promise.prototype.constructorのinitial valueは
27.5.5.3 Promise.prototype.finally ( onFinally )
このmethodは、呼び出されたときに以下のstepsを実行する：
- promiseを
this valueとする。 - promiseがObjectでないなら、
TypeError 例外をthrowする。 - ctorを ?
SpeciesConstructor (promise,%Promise% ) とする。 Assert :IsConstructor (ctor)はtrue である。IsCallable (onFinally)がfalse なら、- thenFinallyをonFinallyとする。
- catchFinallyをonFinallyとする。
- そうでなければ、
- thenFinallyClosureを、parameters (value)を持ち、onFinallyおよびctorをcaptureし、呼び出されたときに以下のstepsを実行するnew
Abstract Closure とする：- resultを ?
Call (onFinally,undefined ) とする。 - pを ?
PromiseResolve (ctor, result) とする。 - returnValueを、parametersを持たず、valueをcaptureし、呼び出されたときに以下のstepsを実行するnew
Abstract Closure とする：NormalCompletion (value)を返す。
- valueThunkを
CreateBuiltinFunction (returnValue, 0,"" , « »)とする。 - ?
Invoke (p,"then" , « valueThunk »)を返す。
- resultを ?
- thenFinallyを
CreateBuiltinFunction (thenFinallyClosure, 1,"" , « »)とする。 - catchFinallyClosureを、parameters (reason)を持ち、onFinallyおよびctorをcaptureし、呼び出されたときに以下のstepsを実行するnew
Abstract Closure とする：- resultを ?
Call (onFinally,undefined ) とする。 - pを ?
PromiseResolve (ctor, result) とする。 - throwReasonを、parametersを持たず、reasonをcaptureし、呼び出されたときに以下のstepsを実行するnew
Abstract Closure とする：- reasonをThrowする。
- throwerを
CreateBuiltinFunction (throwReason, 0,"" , « »)とする。 - ?
Invoke (p,"then" , « thrower »)を返す。
- resultを ?
- catchFinallyを
CreateBuiltinFunction (catchFinallyClosure, 1,"" , « »)とする。
- thenFinallyClosureを、parameters (value)を持ち、onFinallyおよびctorをcaptureし、呼び出されたときに以下のstepsを実行するnew
- ?
Invoke (promise,"then" , « thenFinally, catchFinally »)を返す。
27.5.5.4 Promise.prototype.then ( onFulfilled, onRejected )
このmethodは、呼び出されたときに以下のstepsを実行する：
- promiseを
this valueとする。 IsPromise (promise)がfalse なら、TypeError 例外をthrowする。- ctorを ?
SpeciesConstructor (promise,%Promise% ) とする。 - resultCapabilityを ?
NewPromiseCapability (ctor) とする。 PerformPromiseThen (promise, onFulfilled, onRejected, resultCapability)を返す。
27.5.5.4.1 PerformPromiseThen ( promise, onFulfilled, onRejected [ , resultCapability ] )
The abstract operation PerformPromiseThen takes arguments promise (a Promise), onFulfilled (an ECMAScript language value), and onRejected (an ECMAScript language value) and optional argument resultCapability (a
Assert :IsPromise (promise)はtrue である。- resultCapabilityが存在しないなら、
- resultCapabilityを
undefined に設定する。
- resultCapabilityを
IsCallable (onFulfilled)がfalse なら、- onFulfilledJobCallbackを
empty とする。
- onFulfilledJobCallbackを
- そうでなければ、
- onFulfilledJobCallbackを
HostMakeJobCallback (onFulfilled)とする。
- onFulfilledJobCallbackを
IsCallable (onRejected)がfalse なら、- onRejectedJobCallbackを
empty とする。
- onRejectedJobCallbackを
- そうでなければ、
- onRejectedJobCallbackを
HostMakeJobCallback (onRejected)とする。
- onRejectedJobCallbackを
- fulfillReactionを
PromiseReaction Record { [[Capability]]: resultCapability, [[Type]]:fulfill , [[Handler]]: onFulfilledJobCallback }とする。 - rejectReactionを
PromiseReaction Record { [[Capability]]: resultCapability, [[Type]]:reject , [[Handler]]: onRejectedJobCallback }とする。 - promise.[[PromiseState]]が
pending なら、- fulfillReactionをpromise.[[PromiseFulfillReactions]]にappendする。
- rejectReactionをpromise.[[PromiseRejectReactions]]にappendする。
- そうでなく、promise.[[PromiseState]]が
fulfilled なら、- valueをpromise.[[PromiseResult]]とする。
- fulfillJobを
NewPromiseReactionJob (fulfillReaction, value)とする。 HostEnqueuePromiseJob (fulfillJob.[[Job]], fulfillJob.[[Realm]])を実行する。
- そうでなければ、
Assert : promise.[[PromiseState]]はrejected である。- reasonをpromise.[[PromiseResult]]とする。
- promise.[[PromiseIsHandled]]が
false なら、HostPromiseRejectionTracker (promise,"handle" )を実行する。 - rejectJobを
NewPromiseReactionJob (rejectReaction, reason)とする。 HostEnqueuePromiseJob (rejectJob.[[Job]], rejectJob.[[Realm]])を実行する。
- promise.[[PromiseIsHandled]]を
true に設定する。 - resultCapabilityが
undefined なら、undefined を返す。 - resultCapability.[[Promise]]を返す。
27.5.5.5 Promise.prototype [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
27.5.6 Promiseインスタンスのプロパティ
Promise instancesは、
| Internal Slot | Type | Description |
|---|---|---|
| [[PromiseState]] |
|
promiseがそのthen methodへのincoming callsにどのようにreactするかをgovernする。
|
| [[PromiseResult]] |
ECMAScript language valueまたは |
promiseがfulfilledまたはrejectedされたvalue（ある場合）。[[PromiseState]]が |
| [[PromiseFulfillReactions]] |
|
promiseが |
| [[PromiseRejectReactions]] |
|
promiseが |
| [[PromiseIsHandled]] | Boolean | promiseがこれまでにfulfillmentまたはrejection handlerを持ったことがあるかどうかを示す。unhandled rejection trackingで使用される。 |
27.6 GeneratorFunctionオブジェクト
GeneratorFunctionsは、通常、
27.6.1 GeneratorFunctionコンストラクタ
GeneratorFunction
- %GeneratorFunction%である。
Functionのsubclassである。constructor としてではなくfunctionとして呼び出されたときにnew GeneratorFunctionをcreateしてinitializeする。したがって、function callGeneratorFunction (…)は、同じargumentsを持つobject creation expressionnew GeneratorFunction (…)と等価である。- class definitionの
extendsclauseのvalueとして使用してもよい。指定されたGeneratorFunction behaviourをinheritすることを意図するsubclassconstructors は、built-in GeneratorFunction behaviourに必要なinternal slotsでsubclass instancesをcreateしてinitializeするために、GeneratorFunctionconstructor へのsupercallを含まなければならない。generatorfunction objects をdefineするすべてのECMAScript syntactic formsは、GeneratorFunctionのdirect instancesを作成する。GeneratorFunction subclassesのinstancesを作成するsyntactic meansは存在しない。
27.6.1.1 GeneratorFunction ( ...paramArgs, bodyArg )
最後のargument（ある場合）は、generator functionのbody（executable code）を指定する。それより前のargumentsはformal parametersを指定する。
このfunctionは、呼び出されたときに以下のstepsを実行する：
- activeFuncを
active function object とする。 - bodyArgが存在しないなら、bodyArgをempty Stringに設定する。
- ?
CreateDynamicFunction (activeFunc, NewTarget,generator , paramArgs, bodyArg)を返す。
27.6.2 GeneratorFunctionコンストラクタのプロパティ
GeneratorFunction
- Function
constructor からinheritするstandard built-infunction object である。 - valueが
%Function% である[[Prototype]] internal slotを持つ。 - valueが
1 𝔽である"length" propertyを持つ。 - valueが
"GeneratorFunction" である"name" propertyを持つ。 - 以下のpropertiesを持つ：
27.6.2.1 GeneratorFunction.prototype
GeneratorFunction.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
27.6.3 GeneratorFunction Prototype Objectのプロパティ
GeneratorFunction prototype objectは：
- %GeneratorFunction.prototype%である（
Figure 6 を参照）。 ordinary object である。function object ではなく、[[ECMAScriptCode]] internal slotも、Table 26 またはTable 94 に列挙されるinternal slotsのいずれも持たない。- valueが
%Function.prototype% である[[Prototype]] internal slotを持つ。
27.6.3.1 GeneratorFunction.prototype.constructor
GeneratorFunction.prototype.constructorのinitial valueは
このpropertyはattributes { [[Writable]]:
27.6.3.2 GeneratorFunction.prototype.prototype
GeneratorFunction.prototype.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
27.6.3.3 GeneratorFunction.prototype [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
27.6.4 GeneratorFunctionインスタンス
すべてのGeneratorFunction instanceはECMAScript
各GeneratorFunction instanceは以下のown propertiesを持つ：
27.6.4.1 length
27.6.4.2 name
27.6.4.3 prototype
GeneratorFunction instanceが作成されるたびに、別の
このpropertyはattributes { [[Writable]]:
Function instancesとは異なり、GeneratorFunctionの
27.7 AsyncGeneratorFunctionオブジェクト
AsyncGeneratorFunctionsは、通常、
27.7.1 AsyncGeneratorFunctionコンストラクタ
AsyncGeneratorFunction
- %AsyncGeneratorFunction%である。
Functionのsubclassである。constructor としてではなくfunctionとして呼び出されたときにnew AsyncGeneratorFunctionをcreateしてinitializeする。したがって、function callAsyncGeneratorFunction (...)は、同じargumentsを持つobject creation expressionnew AsyncGeneratorFunction (...)と等価である。- class definitionの
extendsclauseのvalueとして使用してもよい。指定されたAsyncGeneratorFunction behaviourをinheritすることを意図するsubclassconstructors は、built-in AsyncGeneratorFunction behaviourに必要なinternal slotsでsubclass instancesをcreateしてinitializeするために、AsyncGeneratorFunctionconstructor へのsupercallを含まなければならない。async generatorfunction objects をdefineするすべてのECMAScript syntactic formsは、AsyncGeneratorFunctionのdirect instancesを作成する。AsyncGeneratorFunction subclassesのinstancesを作成するsyntactic meansは存在しない。
27.7.1.1 AsyncGeneratorFunction ( ...paramArgs, bodyArg )
最後のargument（ある場合）は、async generator functionのbody（executable code）を指定する。それより前のargumentsはformal parametersを指定する。
このfunctionは、呼び出されたときに以下のstepsを実行する：
- activeFuncを
active function object とする。 - bodyArgが存在しないなら、bodyArgをempty Stringに設定する。
- ?
CreateDynamicFunction (activeFunc, NewTarget,async-generator , paramArgs, bodyArg)を返す。
27.7.2 AsyncGeneratorFunctionコンストラクタのプロパティ
AsyncGeneratorFunction
- Function
constructor からinheritするstandard built-infunction object である。 - valueが
%Function% である[[Prototype]] internal slotを持つ。 - valueが
1 𝔽である"length" propertyを持つ。 - valueが
"AsyncGeneratorFunction" である"name" propertyを持つ。 - 以下のpropertiesを持つ：
27.7.2.1 AsyncGeneratorFunction.prototype
AsyncGeneratorFunction.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
27.7.3 AsyncGeneratorFunction Prototype Objectのプロパティ
AsyncGeneratorFunction prototype objectは：
- %AsyncGeneratorFunction.prototype%である。
ordinary object である。function object ではなく、[[ECMAScriptCode]] internal slotも、Table 26 またはTable 95 に列挙されるinternal slotsのいずれも持たない。- valueが
%Function.prototype% である[[Prototype]] internal slotを持つ。
27.7.3.1 AsyncGeneratorFunction.prototype.constructor
AsyncGeneratorFunction.prototype.constructorのinitial valueは
このpropertyはattributes { [[Writable]]:
27.7.3.2 AsyncGeneratorFunction.prototype.prototype
AsyncGeneratorFunction.prototype.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
27.7.3.3 AsyncGeneratorFunction.prototype [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
27.7.4 AsyncGeneratorFunctionインスタンス
すべてのAsyncGeneratorFunction instanceはECMAScript
各AsyncGeneratorFunction instanceは以下のown propertiesを持つ：
27.7.4.1 length
このpropertyはattributes { [[Writable]]:
27.7.4.2 name
27.7.4.3 prototype
AsyncGeneratorFunction instanceが作成されるたびに、別の
このpropertyはattributes { [[Writable]]:
function instancesとは異なり、AsyncGeneratorFunctionの
27.8 Generatorオブジェクト
Generatorは、generator functionをcallすることによって作成され、
Generator instancesは、そのinstanceを作成したgenerator functionの
27.8.1 %GeneratorPrototype%オブジェクト
%GeneratorPrototype% objectは：
- %GeneratorFunction.prototype.prototype%である。
ordinary object である。- Generator instanceではなく、[[GeneratorState]] internal slotを持たない。
- valueが
%Iterator.prototype% である[[Prototype]] internal slotを持つ。 - すべてのGenerator instancesによって間接的にinheritされるpropertiesを持つ。
27.8.1.1 %GeneratorPrototype%.constructor
.constructorのinitial valueは
このpropertyはattributes { [[Writable]]:
27.8.1.2 %GeneratorPrototype%.next ( value )
- ?
GeneratorResume (this value, value,empty )を返す。
27.8.1.3 %GeneratorPrototype%.return ( value )
このmethodは、呼び出されたときに以下のstepsを実行する：
- genを
this valueとする。 - completionを
ReturnCompletion (value)とする。 - ?
GeneratorResumeAbrupt (gen, completion,empty )を返す。
27.8.1.4 %GeneratorPrototype%.throw ( exception )
このmethodは、呼び出されたときに以下のstepsを実行する：
- genを
this valueとする。 - completionを
ThrowCompletion (exception)とする。 - ?
GeneratorResumeAbrupt (gen, completion,empty )を返す。
27.8.1.5 %GeneratorPrototype% [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
27.8.2 Generatorインスタンスのプロパティ
Generator instancesは、最初に
| Internal Slot | Type | Description |
|---|---|---|
| [[GeneratorState]] |
|
generatorのcurrent execution state。 |
| [[GeneratorContext]] |
|
このgeneratorのcodeをexecutingするときに使用される |
| [[GeneratorBrand]] |
Stringまたは |
異なる種類のgeneratorsをdistinguishするために使用されるbrand。 |
27.8.3 Generator Abstract Operations
27.8.3.1 GeneratorStart ( gen, genBody )
The abstract operation GeneratorStart takes arguments gen (a Generator) and genBody (a
Assert : gen.[[GeneratorState]]はsuspended-start である。- genContextを
running execution context とする。 - genContextのGenerator componentをgenに設定する。
- closureを、parametersを持たず、genBodyをcaptureし、呼び出されたときに以下のstepsを実行するnew
Abstract Closure とする：- acGenContextを
running execution context とする。 - acGenをacGenContextのGenerator componentとする。
- genBodyが
Parse Node なら、- resultを
Completion (Evaluation of genBody)とする。
- resultを
- そうでなければ、
Assert : genBodyはparametersを持たないAbstract Closure である。- resultを
Completion (genBody())とする。
Assert : ここにreturnした場合、generatorはexceptionをthrowしたか、implicitまたはexplicit returnのいずれかを実行した。- acGenContextを
execution context stack からremoveし、execution context stack のtopにあるexecution context をrunning execution context としてrestoreする。 - acGen.[[GeneratorState]]を
completed に設定する。 NOTE : generatorがcompleted stateに入ると、決してそこからleaveせず、そのassociatedexecution context は決してresumedされない。この時点で、acGenにassociatedする任意のexecution stateはdiscardできる。- resultが
normal completion なら、- resultValueを
undefined とする。
- resultValueを
- そうでなく、resultが
return completion なら、- resultValueをresult.[[Value]]とする。
- そうでなければ、
Assert : resultはthrow completion である。- ? resultを返す。
NormalCompletion (CreateIteratorResultObject (resultValue,true ))を返す。
- acGenContextを
- genContextのcode evaluation stateを、その
execution context についてevaluationがresumedされたときに、closureがargumentsなしでcallされるように設定する。 - gen.[[GeneratorContext]]をgenContextに設定する。
unused を返す。
27.8.3.2 GeneratorValidate ( gen, genBrand )
The abstract operation GeneratorValidate takes arguments gen (an ECMAScript language value) and genBrand (a String or
- ?
RequireInternalSlot (gen, [[GeneratorState]])を実行する。 - ?
RequireInternalSlot (gen, [[GeneratorBrand]])を実行する。 - gen.[[GeneratorBrand]]がgenBrandでないなら、
TypeError 例外をthrowする。 Assert : genは[[GeneratorContext]] internal slotを持つ。- stateをgen.[[GeneratorState]]とする。
- stateが
executing なら、TypeError 例外をthrowする。 - stateを返す。
27.8.3.3 GeneratorResume ( gen, value, genBrand )
The abstract operation GeneratorResume takes arguments gen (an ECMAScript language value), value (an ECMAScript language value or
- stateを ?
GeneratorValidate (gen, genBrand) とする。 - stateが
completed なら、CreateIteratorResultObject (undefined ,true )を返す。 Assert : stateはsuspended-start またはsuspended-yield のいずれかである。- genContextをgen.[[GeneratorContext]]とする。
- gen.[[GeneratorState]]を
executing に設定する。 - ?
RunSuspendedContext (genContext,NormalCompletion (value))を返す。
27.8.3.4 GeneratorResumeAbrupt ( gen, abruptCompletion, genBrand )
The abstract operation GeneratorResumeAbrupt takes arguments gen (an ECMAScript language value), abruptCompletion (a
- stateを ?
GeneratorValidate (gen, genBrand) とする。 - stateが
suspended-start なら、- gen.[[GeneratorState]]を
completed に設定する。 NOTE : generatorがcompleted stateに入ると、決してそこからleaveせず、そのassociatedexecution context は決してresumedされない。この時点で、genにassociatedする任意のexecution stateはdiscardできる。- stateを
completed に設定する。
- gen.[[GeneratorState]]を
- stateが
completed なら、- abruptCompletionが
return completion なら、CreateIteratorResultObject (abruptCompletion.[[Value]],true )を返す。
- ? abruptCompletionを返す。
- abruptCompletionが
Assert : stateはsuspended-yield である。- genContextをgen.[[GeneratorContext]]とする。
- gen.[[GeneratorState]]を
executing に設定する。 - ?
RunSuspendedContext (genContext, abruptCompletion)を返す。
27.8.3.5 GetGeneratorKind ( )
The abstract operation GetGeneratorKind takes no arguments and returns
- genContextを
running execution context とする。 - genContextがGenerator componentを持たないなら、
non-generator を返す。 - genをgenContextのGenerator componentとする。
- genが[[AsyncGeneratorState]] internal slotを持つなら、
async を返す。 sync を返す。
27.8.3.6 GeneratorYield ( iteratorResult )
The abstract operation GeneratorYield takes argument iteratorResult (an Object that conforms to the
- genContextを、実行中の実行コンテキストとする。
Assert : genContextはジェネレータの実行コンテキストである。- genを、genContextのGeneratorコンポーネントの値とする。
Assert :GetGeneratorKind ()はsync である。- gen.[[GeneratorState]]を
suspended-yield に設定する。 - Return ?
RunCallerContext (iteratorResult)。
27.8.3.7 Yield ( arg )
The abstract operation Yield takes argument arg (an ECMAScript language value) and returns either a
- genKindを
GetGeneratorKind ()とする。 - genKindが
async なら、?AsyncGeneratorYield (?Await (arg))を返す。 - ?
GeneratorYield (CreateIteratorResultObject (arg,false ))を返す。
27.8.3.8 CreateIteratorFromClosure ( closure, genBrand, genProto [ , extraSlots ] )
The abstract operation CreateIteratorFromClosure takes arguments closure (an
NOTE : closureは、IteratorResult object をyieldするためにYield operationのusesを含むことができる。- extraSlotsが存在しないなら、extraSlotsをnew empty
List に設定する。 - internalSlotsListをextraSlotsと« [[GeneratorState]], [[GeneratorContext]], [[GeneratorBrand]] »の
list-concatenation とする。 - genを
OrdinaryObjectCreate (genProto, internalSlotsList)とする。 - gen.[[GeneratorBrand]]をgenBrandに設定する。
- gen.[[GeneratorState]]を
suspended-start に設定する。 - callerContextを
running execution context とする。 - calleeContextをnew
execution context とする。 - calleeContextのFunctionを
null に設定する。 - calleeContextの
Realm をcurrent Realm Record に設定する。 - calleeContextのScriptOrModuleをcallerContextのScriptOrModuleに設定する。
- callerContextがまだsuspendedでないなら、callerContextをsuspendする。
- calleeContextを
execution context stack にPushする。calleeContextはいまrunning execution context である。 GeneratorStart (gen, closure)を実行する。- calleeContextを
execution context stack からremoveし、callerContextをrunning execution context としてrestoreする。 - genを返す。
27.9 AsyncGeneratorオブジェクト
AsyncGeneratorは、async generator functionをcallすることによって作成され、
AsyncGenerator instancesは、そのinstanceを作成したasync generator functionの
27.9.1 %AsyncGeneratorPrototype%オブジェクト
%AsyncGeneratorPrototype% objectは：
- %AsyncGeneratorFunction.prototype.prototype%である。
ordinary object である。- AsyncGenerator instanceではなく、[[AsyncGeneratorState]] internal slotを持たない。
- valueが
%AsyncIteratorPrototype% である[[Prototype]] internal slotを持つ。 - すべてのAsyncGenerator instancesによって間接的にinheritされるpropertiesを持つ。
27.9.1.1 %AsyncGeneratorPrototype%.constructor
.constructorのinitial valueは
このpropertyはattributes { [[Writable]]:
27.9.1.2 %AsyncGeneratorPrototype%.next ( value )
- genを
this valueとする。 - promiseCapabilityを !
NewPromiseCapability (%Promise% ) とする。 - resultを
Completion (AsyncGeneratorValidate (gen,empty ))とする。 IfAbruptRejectPromise (result, promiseCapability).- stateをgen.[[AsyncGeneratorState]]とする。
- stateが
completed なら、- iteratorResultを
CreateIteratorResultObject (undefined ,true )とする。 - !
Call (promiseCapability.[[Resolve]],undefined , « iteratorResult »)を実行する。 - promiseCapability.[[Promise]]を返す。
- iteratorResultを
- completionを
NormalCompletion (value)とする。 AsyncGeneratorEnqueue (gen, completion, promiseCapability)を実行する。- stateが
suspended-start またはsuspended-yield のいずれかなら、AsyncGeneratorResume (gen, completion)を実行する。
- そうでなければ、
Assert : stateはexecuting またはdraining-queue のいずれかである。
- promiseCapability.[[Promise]]を返す。
27.9.1.3 %AsyncGeneratorPrototype%.return ( value )
- genを
this valueとする。 - promiseCapabilityを !
NewPromiseCapability (%Promise% ) とする。 - resultを
Completion (AsyncGeneratorValidate (gen,empty ))とする。 IfAbruptRejectPromise (result, promiseCapability).- completionを
ReturnCompletion (value)とする。 AsyncGeneratorEnqueue (gen, completion, promiseCapability)を実行する。- stateをgen.[[AsyncGeneratorState]]とする。
- stateが
suspended-start またはcompleted のいずれかなら、- gen.[[AsyncGeneratorState]]を
draining-queue に設定する。 AsyncGeneratorAwaitReturn (gen)を実行する。
- gen.[[AsyncGeneratorState]]を
- そうでなく、stateが
suspended-yield なら、AsyncGeneratorResume (gen, completion)を実行する。
- そうでなければ、
Assert : stateはexecuting またはdraining-queue のいずれかである。
- promiseCapability.[[Promise]]を返す。
27.9.1.4 %AsyncGeneratorPrototype%.throw ( exception )
- genを
this valueとする。 - promiseCapabilityを !
NewPromiseCapability (%Promise% ) とする。 - resultを
Completion (AsyncGeneratorValidate (gen,empty ))とする。 IfAbruptRejectPromise (result, promiseCapability).- stateをgen.[[AsyncGeneratorState]]とする。
- stateが
suspended-start なら、- gen.[[AsyncGeneratorState]]を
completed に設定する。 - stateを
completed に設定する。
- gen.[[AsyncGeneratorState]]を
- stateが
completed なら、- !
Call (promiseCapability.[[Reject]],undefined , « exception »)を実行する。 - promiseCapability.[[Promise]]を返す。
- !
- completionを
ThrowCompletion (exception)とする。 AsyncGeneratorEnqueue (gen, completion, promiseCapability)を実行する。- stateが
suspended-yield なら、AsyncGeneratorResume (gen, completion)を実行する。
- そうでなければ、
Assert : stateはexecuting またはdraining-queue のいずれかである。
- promiseCapability.[[Promise]]を返す。
27.9.1.5 %AsyncGeneratorPrototype% [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
27.9.2 AsyncGeneratorインスタンスのプロパティ
AsyncGenerator instancesは、最初に以下に記述されるinternal slotsで作成される：
| Internal Slot | Type | Description |
|---|---|---|
| [[AsyncGeneratorState]] | async generatorのcurrent execution state。 | |
| [[AsyncGeneratorContext]] | このasync generatorのcodeをexecutingするときに使用される |
|
| [[AsyncGeneratorQueue]] | async generatorをresumeするrequestsを表す |
|
| [[GeneratorBrand]] | Stringまたは |
異なる種類のasync generatorsをdistinguishするために使用されるbrand。 |
27.9.3 AsyncGenerator Abstract Operations
27.9.3.1 AsyncGeneratorRequest Records
AsyncGeneratorRequestは、async generatorがどのようにresumedされるべきかについての情報を格納し、対応するpromiseをfulfillまたはrejectするcapabilitiesを含むために使用される
これらは以下のfieldsを持つ：
| Field Name | Value | Meaning |
|---|---|---|
| [[Completion]] | async generatorをresumeするために使用されるべき |
|
| [[Capability]] | このrequestにassociatedするpromise capabilities。 |
27.9.3.2 AsyncGeneratorStart ( gen, genBody )
The abstract operation AsyncGeneratorStart takes arguments gen (an AsyncGenerator) and genBody (a
Assert : gen.[[AsyncGeneratorState]]はsuspended-start である。- genContextを
running execution context とする。 - genContextのGenerator componentをgenに設定する。
- closureを、parametersを持たず、genBodyをcaptureし、呼び出されたときに以下のstepsを実行するnew
Abstract Closure とする：- acGenContextを
running execution context とする。 - acGenをacGenContextのGenerator componentとする。
- genBodyが
Parse Node なら、- resultを
Completion (Evaluation of genBody)とする。
- resultを
- そうでなければ、
Assert : genBodyはparametersを持たないAbstract Closure である。- resultを
Completion (genBody())とする。
Assert : ここにreturnした場合、async generatorはexceptionをthrowしたか、implicitまたはexplicit returnのいずれかを実行した。- acGenContextを
execution context stack からremoveし、execution context stack のtopにあるexecution context をrunning execution context としてrestoreする。 - acGen.[[AsyncGeneratorState]]を
draining-queue に設定する。 - resultが
normal completion なら、resultをNormalCompletion (undefined )に設定する。 - resultが
return completion なら、resultをNormalCompletion (result.[[Value]])に設定する。 AsyncGeneratorCompleteStep (acGen, result,true )を実行する。AsyncGeneratorDrainQueue (acGen)を実行する。NormalCompletion (undefined )を返す。
- acGenContextを
- genContextのcode evaluation stateを、その
execution context についてevaluationがresumedされたときに、closureがargumentsなしでcallされるように設定する。 - gen.[[AsyncGeneratorContext]]をgenContextに設定する。
- gen.[[AsyncGeneratorQueue]]をnew empty
List に設定する。 unused を返す。
27.9.3.3 AsyncGeneratorValidate ( gen, genBrand )
The abstract operation AsyncGeneratorValidate takes arguments gen (an ECMAScript language value) and genBrand (a String or
- ?
RequireInternalSlot (gen, [[AsyncGeneratorContext]])を実行する。 - ?
RequireInternalSlot (gen, [[AsyncGeneratorState]])を実行する。 - ?
RequireInternalSlot (gen, [[AsyncGeneratorQueue]])を実行する。 - gen.[[GeneratorBrand]]がgenBrandでないなら、
TypeError 例外をthrowする。 unused を返す。
27.9.3.4 AsyncGeneratorEnqueue ( gen, completion, promiseCapability )
The abstract operation AsyncGeneratorEnqueue takes arguments gen (an AsyncGenerator), completion (a
- requestを
AsyncGeneratorRequest { [[Completion]]: completion, [[Capability]]: promiseCapability }とする。 - requestをgen.[[AsyncGeneratorQueue]]にappendする。
unused を返す。
27.9.3.5 AsyncGeneratorCompleteStep ( gen, completion, done [ , realm ] )
The abstract operation AsyncGeneratorCompleteStep takes arguments gen (an AsyncGenerator), completion (a
Assert : gen.[[AsyncGeneratorQueue]]はemptyでない。- nextをgen.[[AsyncGeneratorQueue]]のfirst elementとする。
- gen.[[AsyncGeneratorQueue]]からfirst elementをremoveする。
- promiseCapabilityをnext.[[Capability]]とする。
- valueをcompletion.[[Value]]とする。
- completionが
throw completion なら、- !
Call (promiseCapability.[[Reject]],undefined , « value »)を実行する。
- !
- そうでなければ、
Assert : completionはnormal completion である。- realmが存在するなら、
- oldRealmを
running execution context のRealm とする。 running execution context のRealm をrealmに設定する。- iteratorResultを
CreateIteratorResultObject (value, done)とする。 running execution context のRealm をoldRealmに設定する。
- oldRealmを
- そうでなければ、
- iteratorResultを
CreateIteratorResultObject (value, done)とする。
- iteratorResultを
- !
Call (promiseCapability.[[Resolve]],undefined , « iteratorResult »)を実行する。
unused を返す。
27.9.3.6 AsyncGeneratorResume ( gen, completion )
The abstract operation AsyncGeneratorResume takes arguments gen (an AsyncGenerator) and completion (a
Assert : gen.[[AsyncGeneratorState]]はsuspended-start またはsuspended-yield のいずれかである。- genContextをgen.[[AsyncGeneratorContext]]とする。
- gen.[[AsyncGeneratorState]]を
executing に設定する。 - !
RunSuspendedContext (genContext, completion)を実行する。 unused を返す。
27.9.3.7 AsyncGeneratorUnwrapYieldResumption ( resumptionValue )
The abstract operation AsyncGeneratorUnwrapYieldResumption takes argument resumptionValue (a
- resumptionValueが
return completion でないなら、? resumptionValueを返す。 - awaitedを
Completion (Await (resumptionValue.[[Value]]))とする。 - awaitedが
throw completion なら、? awaitedを返す。 Assert : awaitedはnormal completion である。ReturnCompletion (awaited.[[Value]])を返す。
27.9.3.8 AsyncGeneratorYield ( arg )
The abstract operation AsyncGeneratorYield takes argument arg (an ECMAScript language value) and returns either a
- genContextを、実行中の実行コンテキストとする。
Assert : genContextはジェネレータの実行コンテキストである。- genを、genContextのGeneratorコンポーネントの値とする。
Assert :GetGeneratorKind ()はasync である。- completionを、
NormalCompletion (arg)とする。 Assert : 実行コンテキストスタックには少なくとも2つの要素がある。- previousContextを、実行コンテキストスタックの先頭から2番目の要素とする。
- previousRealmを、previousContextの
Realm とする。 AsyncGeneratorCompleteStep (gen, completion,false , previousRealm)を実行する。- queueを、gen.[[AsyncGeneratorQueue]]とする。
- queueが空でない場合、
NOTE : 実行はジェネレータを中断せずに継続する。- toYieldを、queueの最初の要素とする。
- resumptionValueを、
Completion (toYield.[[Completion]])とする。 - Return ?
AsyncGeneratorUnwrapYieldResumption (resumptionValue)。
- gen.[[AsyncGeneratorState]]を
suspended-yield に設定する。 - resumptionValueを、
Completion (RunCallerContext (undefined ))とする。 - Return ?
AsyncGeneratorUnwrapYieldResumption (resumptionValue)。
27.9.3.9 AsyncGeneratorAwaitReturn ( gen )
The abstract operation AsyncGeneratorAwaitReturn takes argument gen (an AsyncGenerator) and returns
Assert : gen.[[AsyncGeneratorState]]はdraining-queue である。- queueをgen.[[AsyncGeneratorQueue]]とする。
Assert : queueはemptyでない。- nextをqueueのfirst elementとする。
- completionを
Completion (next.[[Completion]])とする。 Assert : completionはreturn completion である。- promiseCompletionを
Completion (PromiseResolve (%Promise% , completion.[[Value]]))とする。 - promiseCompletionが
abrupt completion なら、AsyncGeneratorCompleteStep (gen, promiseCompletion,true )を実行する。AsyncGeneratorDrainQueue (gen)を実行する。unused を返す。
Assert : promiseCompletionはnormal completion である。- promiseをpromiseCompletion.[[Value]]とする。
- fulfilledClosureを、parameters (value)を持ち、genをcaptureし、呼び出されたときに以下のstepsを実行するnew
Abstract Closure とする：Assert : gen.[[AsyncGeneratorState]]はdraining-queue である。- resultを
NormalCompletion (value)とする。 AsyncGeneratorCompleteStep (gen, result,true )を実行する。AsyncGeneratorDrainQueue (gen)を実行する。NormalCompletion (undefined )を返す。
- onFulfilledを
CreateBuiltinFunction (fulfilledClosure, 1,"" , « »)とする。 - rejectedClosureを、parameters (reason)を持ち、genをcaptureし、呼び出されたときに以下のstepsを実行するnew
Abstract Closure とする：Assert : gen.[[AsyncGeneratorState]]はdraining-queue である。- resultを
ThrowCompletion (reason)とする。 AsyncGeneratorCompleteStep (gen, result,true )を実行する。AsyncGeneratorDrainQueue (gen)を実行する。NormalCompletion (undefined )を返す。
- onRejectedを
CreateBuiltinFunction (rejectedClosure, 1,"" , « »)とする。 PerformPromiseThen (promise, onFulfilled, onRejected)を実行する。unused を返す。
27.9.3.10 AsyncGeneratorDrainQueue ( gen )
The abstract operation AsyncGeneratorDrainQueue takes argument gen (an AsyncGenerator) and returns
Assert : gen.[[AsyncGeneratorState]]はdraining-queue である。- queueをgen.[[AsyncGeneratorQueue]]とする。
- queueがemptyでない間、繰り返す：
- nextをqueueのfirst elementとする。
- completionを
Completion (next.[[Completion]])とする。 - completionが
return completion なら、AsyncGeneratorAwaitReturn (gen)を実行する。unused を返す。
- completionが
normal completion なら、- completionを
NormalCompletion (undefined )に設定する。
- completionを
AsyncGeneratorCompleteStep (gen, completion,true )を実行する。
- gen.[[AsyncGeneratorState]]を
completed に設定する。 unused を返す。
27.10 AsyncFunctionオブジェクト
AsyncFunctionsは、通常、
27.10.1 AsyncFunctionコンストラクタ
AsyncFunction
- %AsyncFunction%である。
Functionのsubclassである。constructor としてではなくfunctionとして呼び出されたときにnew AsyncFunctionをcreateしてinitializeする。したがって、function callAsyncFunction(…)は、同じargumentsを持つobject creation expressionnew AsyncFunction(…)と等価である。- class definitionの
extendsclauseのvalueとして使用してもよい。指定されたAsyncFunction behaviourをinheritすることを意図するsubclassconstructors は、built-in async function behaviourに必要なinternal slotsでsubclass instanceをcreateしてinitializeするために、AsyncFunctionconstructor へのsupercallを含まなければならない。asyncfunction objects をdefineするすべてのECMAScript syntactic formsは、AsyncFunctionのdirect instancesを作成する。AsyncFunction subclassesのinstancesを作成するsyntactic meansは存在しない。
27.10.1.1 AsyncFunction ( ...paramArgs, bodyArg )
最後のargument（ある場合）は、async functionのbody（executable code）を指定する。それより前のargumentsはformal parametersを指定する。
このfunctionは、呼び出されたときに以下のstepsを実行する：
- activeFuncを
active function object とする。 - bodyArgが存在しないなら、bodyArgをempty Stringに設定する。
- ?
CreateDynamicFunction (activeFunc, NewTarget,async , paramArgs, bodyArg)を返す。
27.10.2 AsyncFunctionコンストラクタのプロパティ
AsyncFunction
- Function
constructor からinheritするstandard built-infunction object である。 - valueが
%Function% である[[Prototype]] internal slotを持つ。 - valueが
1 𝔽である"length" propertyを持つ。 - valueが
"AsyncFunction" である"name" propertyを持つ。 - 以下のpropertiesを持つ：
27.10.2.1 AsyncFunction.prototype
AsyncFunction.prototypeのinitial valueは
このpropertyはattributes { [[Writable]]:
27.10.3 AsyncFunction Prototype Objectのプロパティ
AsyncFunction prototype objectは：
- %AsyncFunction.prototype%である。
ordinary object である。function object ではなく、[[ECMAScriptCode]] internal slotも、Table 26 に列挙されるinternal slotsのいずれも持たない。- valueが
%Function.prototype% である[[Prototype]] internal slotを持つ。
27.10.3.1 AsyncFunction.prototype.constructor
AsyncFunction.prototype.constructorのinitial valueは
このpropertyはattributes { [[Writable]]:
27.10.3.2 AsyncFunction.prototype [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
27.10.4 AsyncFunctionインスタンス
すべてのAsyncFunction instanceはECMAScript
各AsyncFunction instanceは以下のown propertiesを持つ：
27.10.4.1 length
27.10.4.2 name
27.10.5 Async Functions Abstract Operations
27.10.5.1 AsyncFunctionStart ( promiseCapability, asyncFuncBody )
The abstract operation AsyncFunctionStart takes arguments promiseCapability (a
- runningContextを
running execution context とする。 - asyncContextをrunningContextのcopyとする。
NOTE : execution stateのcopyingは、AsyncBlockStart がそのexecutionをresumeするためにrequiredである。現在executing中のcontextをresumeすることはill-definedである。AsyncBlockStart (promiseCapability, asyncFuncBody, asyncContext)を実行する。unused を返す。
27.10.5.2 AsyncBlockStart ( promiseCapability, asyncBody, asyncContext )
The abstract operation AsyncBlockStart takes arguments promiseCapability (a
- closureを、parametersを持たず、promiseCapabilityおよびasyncBodyをcaptureし、呼び出されたときに以下のstepsを実行するnew
Abstract Closure とする：- acAsyncContextを
running execution context とする。 - asyncBodyが
Parse Node なら、- resultを
Completion (Evaluation of asyncBody)とする。
- resultを
- そうでなければ、
Assert : asyncBodyはparametersを持たないAbstract Closure である。- resultを
Completion (asyncBody())とする。
Assert : ここにreturnした場合、async functionはexceptionをthrowしたか、implicitまたはexplicit returnを実行した。すべてのawaitingは完了している。- acAsyncContextを
execution context stack からremoveし、execution context stack のtopにあるexecution context をrunning execution context としてrestoreする。 - resultが
normal completion なら、- !
Call (promiseCapability.[[Resolve]],undefined , «undefined »)を実行する。
- !
- そうでなく、resultが
return completion なら、- !
Call (promiseCapability.[[Resolve]],undefined , « result.[[Value]] »)を実行する。
- !
- そうでなければ、
Assert : resultはthrow completion である。- !
Call (promiseCapability.[[Reject]],undefined , « result.[[Value]] »)を実行する。
NormalCompletion (unused )を返す。
- acAsyncContextを
- asyncContextのcode evaluation stateを、その
execution context についてevaluationがresumedされたときに、closureがargumentsなしでcallされるように設定する。 - resultを !
RunSuspendedContext (asyncContext,NormalCompletion (empty )) とする。 Assert : resultはunused である。NOTE : result valuesのpossible sourcesは、Await 、またはasync functionが何もawaitしない場合は上のstep1.i である。unused を返す。
27.10.5.3 Await ( arg )
The abstract operation Await takes argument arg (an ECMAScript language value) and returns either a
- asyncContextを、実行中の実行コンテキストとする。
- promiseを、?
PromiseResolve (%Promise% , arg)とする。 - fulfilledClosureを、asyncContextをキャプチャし、呼び出されたときに次の手順を実行する、パラメータ(v)を持つ新しい
Abstract Closure とする。Completion (RunSuspendedContext (asyncContext,NormalCompletion (v)))を実行する。NOTE :RunSuspendedContext によって返されるCompletion Record は意図的に無視される。NormalCompletion (undefined )を返す。
- onFulfilledを、
CreateBuiltinFunction (fulfilledClosure, 1,"" , « »)とする。 - rejectedClosureを、asyncContextをキャプチャし、呼び出されたときに次の手順を実行する、パラメータ(reason)を持つ新しい
Abstract Closure とする。Completion (RunSuspendedContext (asyncContext,ThrowCompletion (reason)))を実行する。NOTE :RunSuspendedContext によって返されるCompletion Record は意図的に無視される。NormalCompletion (undefined )を返す。
- onRejectedを、
CreateBuiltinFunction (rejectedClosure, 1,"" , « »)とする。 PerformPromiseThen (promise, onFulfilled, onRejected)を実行する。- Return ?
RunCallerContext (empty )。
28 Reflection
28.1 Reflectオブジェクト
Reflect objectは：
- %Reflect%である。
global object の"Reflect" propertyのinitial valueである。ordinary object である。- valueが
%Object.prototype% である[[Prototype]] internal slotを持つ。 function object ではない。- [[Construct]] internal methodを持たない；
newoperatorを伴ってconstructor として使用できない。 - [[Call]] internal methodを持たない；functionとしてinvokedできない。
28.1.1 Reflect.apply ( target, thisArg, args )
このfunctionは、呼び出されたときに以下のstepsを実行する：
IsCallable (target)がfalse なら、TypeError 例外をthrowする。- argListを ?
CreateListFromArrayLike (args) とする。 PrepareForTailCall ()を実行する。- ?
Call (target, thisArg, argList)を返す。
28.1.2 Reflect.construct ( target, args [ , newTarget ] )
このfunctionは、呼び出されたときに以下のstepsを実行する：
IsConstructor (target)がfalse なら、TypeError 例外をthrowする。- newTargetが存在しないなら、newTargetをtargetに設定する。
- そうでなく、
IsConstructor (newTarget)がfalse なら、TypeError 例外をthrowする。 - argListを ?
CreateListFromArrayLike (args) とする。 - ?
Construct (target, argList, newTarget)を返す。
28.1.3 Reflect.defineProperty ( target, key, attrs )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- targetがObjectでないなら、
TypeError 例外をthrowする。 - propertyKeyを ?
ToPropertyKey (key) とする。 - propertyDescを ?
ToPropertyDescriptor (attrs) とする。 - ? target.[[DefineOwnProperty]](propertyKey, propertyDesc)を返す。
28.1.4 Reflect.deleteProperty ( target, key )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- targetがObjectでないなら、
TypeError 例外をthrowする。 - propertyKeyを ?
ToPropertyKey (key) とする。 - ? target.[[Delete]](propertyKey)を返す。
28.1.5 Reflect.get ( target, key [ , receiver ] )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- targetがObjectでないなら、
TypeError 例外をthrowする。 - propertyKeyを ?
ToPropertyKey (key) とする。 - receiverが存在しないなら、
- receiverをtargetに設定する。
- ? target.[[Get]](propertyKey, receiver)を返す。
28.1.6 Reflect.getOwnPropertyDescriptor ( target, key )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- targetがObjectでないなら、
TypeError 例外をthrowする。 - propertyKeyを ?
ToPropertyKey (key) とする。 - propertyDescを ? target.[[GetOwnProperty]](propertyKey) とする。
FromPropertyDescriptor (propertyDesc)を返す。
28.1.7 Reflect.getPrototypeOf ( target )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- targetがObjectでないなら、
TypeError 例外をthrowする。 - ? target.[[GetPrototypeOf]]()を返す。
28.1.8 Reflect.has ( target, key )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- targetがObjectでないなら、
TypeError 例外をthrowする。 - propertyKeyを ?
ToPropertyKey (key) とする。 - ? target.[[HasProperty]](propertyKey)を返す。
28.1.9 Reflect.isExtensible ( target )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- targetがObjectでないなら、
TypeError 例外をthrowする。 - ? target.[[IsExtensible]]()を返す。
28.1.10 Reflect.ownKeys ( target )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- targetがObjectでないなら、
TypeError 例外をthrowする。 - keysを ? target.[[OwnPropertyKeys]]() とする。
CreateArrayFromList (keys)を返す。
28.1.11 Reflect.preventExtensions ( target )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- targetがObjectでないなら、
TypeError 例外をthrowする。 - ? target.[[PreventExtensions]]()を返す。
28.1.12 Reflect.set ( target, key, value [ , receiver ] )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- targetがObjectでないなら、
TypeError 例外をthrowする。 - propertyKeyを ?
ToPropertyKey (key) とする。 - receiverが存在しないなら、
- receiverをtargetに設定する。
- ? target.[[Set]](propertyKey, value, receiver)を返す。
28.1.13 Reflect.setPrototypeOf ( target, proto )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- targetがObjectでないなら、
TypeError 例外をthrowする。 - protoがObjectでなく、かつprotoが
null でないなら、TypeError 例外をthrowする。 - ? target.[[SetPrototypeOf]](proto)を返す。
28.1.14 Reflect [ %Symbol.toStringTag% ]
このpropertyはattributes { [[Writable]]:
28.2 Proxyオブジェクト
28.2.1 Proxyコンストラクタ
Proxy
- %Proxy%である。
global object の"Proxy" propertyのinitial valueである。constructor として呼び出されたときにnew Proxy objectをcreateしてinitializeする。- functionとして呼び出されることを意図しておらず、そのように呼び出された場合はexceptionをthrowする。
28.2.1.1 Proxy ( target, handler )
このfunctionは、呼び出されたときに以下のstepsを実行する：
- NewTargetが
undefined なら、TypeError 例外をthrowする。 - ?
ProxyCreate (target, handler)を返す。
28.2.2 Proxyコンストラクタのプロパティ
Proxy
- valueが
%Function.prototype% である[[Prototype]] internal slotを持つ。 - Proxy objectsはinitializationを必要とする[[Prototype]] internal slotを持たないため、
"prototype" propertyを持たない。 - 以下のpropertiesを持つ：
28.2.2.1 Proxy.revocable ( target, handler )
このfunctionはrevocable Proxy objectを作成する。
これは、呼び出されたときに以下のstepsを実行する：
- ?
ProxyCreate (target, handler)をproxyとする。 - パラメータを持たず、何も捕捉せず、呼び出されたときに次のステップを実行する新しい
Abstract Closure をrevokerClosureとする。- アクティブな関数オブジェクトをactiveFuncとする。
- activeFunc.[[RevocableProxy]]をrevocableProxyとする。
- revocableProxyが
null である場合、NormalCompletion (undefined )を返す。 - activeFunc.[[RevocableProxy]]を
null に設定する。 Assert : revocableProxyはProxy exotic object である。- revocableProxy.[[ProxyTarget]]を
null に設定する。 - revocableProxy.[[ProxyHandler]]を
null に設定する。 NormalCompletion (undefined )を返す。
CreateBuiltinFunction (revokerClosure, 0,"" , « [[RevocableProxy]] »)をrevokerとする。- revoker.[[RevocableProxy]]をproxyに設定する。
OrdinaryObjectCreate (%Object.prototype% )をresultとする。- !
CreateDataPropertyOrThrow (result,"proxy" , proxy)を実行する。 - !
CreateDataPropertyOrThrow (result,"revoke" , revoker)を実行する。 - resultを返す。
28.3 Module Namespaceオブジェクト
Module Namespace Objectは、moduleのexported bindingsへのruntime property-based accessを提供する
28.3.1 %Symbol.toStringTag%
このpropertyはattributes { [[Writable]]:
29 Memory Model
memory consistency model、またはmemory modelは、SharedArrayBufferにbackされた
memory modelは、evaluation中にSharedArrayBuffer上の
このsectionは、SharedArrayBuffers上の
29.1 Memory Modelの基礎
Shared memory accesses（readsおよびwrites）は、以下で定義されるatomic accessesとdata accessesという2つのgroupsに分けられる。Atomic accessesはsequentially consistentである、すなわち
release-acquireなど、sequentially consistentより弱くunorderedより強いorderingsはsupportされない。
Shared Data Block eventは、ReadSharedMemory、WriteSharedMemory、またはReadModifyWriteSharedMemory
| Field Name | Value | Meaning |
|---|---|---|
| [[Order]] | ||
| [[NoTear]] | Boolean | このeventが、このeventとequal |
| [[Block]] | eventがoperateするblock。 | |
| [[ByteIndex]] | non-negative |
[[Block]]内のreadのbyte address。 |
| [[ElementSize]] | non-negative |
readのsize。 |
| Field Name | Value | Meaning |
|---|---|---|
| [[Order]] | ||
| [[NoTear]] | Boolean | このeventが、このeventとequal |
| [[Block]] | eventがoperateするblock。 | |
| [[ByteIndex]] | non-negative |
[[Block]]内のwriteのbyte address。 |
| [[ElementSize]] | non-negative |
writeのsize。 |
| [[Payload]] | 他のeventsによってreadされる |
| Field Name | Value | Meaning |
|---|---|---|
| [[Order]] | Read-modify- |
|
| [[NoTear]] | Read-modify- |
|
| [[Block]] | eventがoperateするblock。 | |
| [[ByteIndex]] | non-negative |
[[Block]]内のread-modify-writeのbyte address。 |
| [[ElementSize]] | non-negative |
read-modify-writeのsize。 |
| [[Payload]] | [[ModifyOp]]に渡される |
|
| [[ModifyOp]] | readされた |
Shared Data Block eventsは、
Shared Data Block event eのmemory rangeを、e.[[ByteIndex]]（inclusive）からe.[[ByteIndex]] + e.[[ElementSize]]（exclusive）までの
考慮されるべきhost-specific synchronizing eventsの例は：SharedArrayBufferをあるpostMessage）、
Eventsは、以下で定義されるrelationsによって
29.2 Agent Events Records
Agent Events Recordは、以下のfieldsを持つ
| Field Name | Value | Meaning |
|---|---|---|
| [[AgentSignifier]] | このorderingをevaluationのresultとして生じさせた |
|
| [[EventList]] | Eventsはevaluation中にlistへappendされる。 | |
| [[AgentSynchronizesWith]] | operational semanticsによって導入された |
29.3 Chosen Value Records
Chosen Value Recordは、以下のfieldsを持つ
| Field Name | Value | Meaning |
|---|---|---|
| [[Event]] | このchosen valueのために導入された |
|
| [[ChosenValue]] | evaluation中にnondeterministically chosenされたbytes。 |
29.4 Candidate Executions
| Field Name | Value | Meaning |
|---|---|---|
| [[EventsRecords]] | ||
| [[ChosenValues]] |
empty candidate executionは、そのfieldsがempty
29.5 Memory ModelのAbstract Operations
29.5.1 EventSet ( execution )
The abstract operation EventSet takes argument execution (a
- eventsをempty Setとする。
- execution.[[EventsRecords]]の各
Agent Events Record eventsRecordについて、- eventsRecord.[[EventList]]の各
Memory event eventについて、- eventをeventsにaddする。
- eventsRecord.[[EventList]]の各
- eventsを返す。
29.5.2 SharedDataBlockEventSet ( execution )
The abstract operation SharedDataBlockEventSet takes argument execution (a
- eventsをempty Setとする。
EventSet (execution)の各Memory event eventについて、- eventが
Shared Data Block event なら、eventをeventsにaddする。
- eventが
- eventsを返す。
29.5.3 HostEventSet ( execution )
The abstract operation HostEventSet takes argument execution (a
EventSet (execution)のうちSharedDataBlockEventSet (execution)に含まれないすべてのelementsを含むnew Setを返す。
29.5.4 ComposeWriteEventBytes ( execution, byteIndex, writes )
The abstract operation ComposeWriteEventBytes takes arguments execution (a
- byteLocationをbyteIndexとする。
- bytesReadをnew empty
List とする。 - writesの各element writeEventについて、
Assert : writeEventはそのmemory range 内にbyteLocationを持つ。- payloadIndexをbyteLocation - writeEvent.[[ByteIndex]]とする。
- writeEventが
WriteSharedMemory eventなら、- byteをwriteEvent.[[Payload]][payloadIndex]とする。
- そうでなければ、
Assert : writeEventはReadModifyWriteSharedMemory eventである。- bytesを
ValueOfReadEvent (execution, writeEvent)とする。 - bytesModifiedをwriteEvent.[[ModifyOp]](bytes, writeEvent.[[Payload]])とする。
- byteをbytesModified[payloadIndex]とする。
- byteをbytesReadにappendする。
- byteLocationをbyteLocation + 1に設定する。
- bytesReadを返す。
read-modify-write modification [[ModifyOp]]は、
このabstract operationは、
29.5.5 ValueOfReadEvent ( execution, readEvent )
The abstract operation ValueOfReadEvent takes arguments execution (a
- writesをexecutionにおける
reads-bytes-from (readEvent)とする。 Assert : writesは、lengthがreadEvent.[[ElementSize]]にequalなWriteSharedMemory またはReadModifyWriteSharedMemory eventsのList である。ComposeWriteEventBytes (execution, readEvent.[[ByteIndex]], writes)を返す。
29.6 Candidate ExecutionsのRelations
以下のrelationsおよびmathematical functionsは、particular
29.6.1 is-agent-order-before
- events eventAおよびeventBについて、execution.[[EventsRecords]]内に、eventAとeventBの両方を含むeventsRecord.[[EventList]]を持つ何らかの
Agent Events Record eventsRecordがあり、かつeventsRecord.[[EventList]]のList orderにおいてeventAがeventBより前であるなら、eventAはexecutionにおいてeventBのis-agent-order-beforeである。
各
29.6.2 reads-bytes-from
-
SharedDataBlockEventSet (execution)内の各ReadSharedMemory またはReadModifyWriteSharedMemory event readEventについて、executionにおけるreads-bytes-from(readEvent)は、lengthがreadEvent.[[ElementSize]]であるList であり、そのelementsはWriteSharedMemory またはReadModifyWriteSharedMemory events writesであって、以下のすべてがtrueである。- writes内のindex iを持つ各event writeEventは、その
memory range 内にreadEvent.[[ByteIndex]] + iを持つ。 - resultはwrites内にない。
- writes内のindex iを持つ各event writeEventは、その
29.6.3 reads-from
- events readEventおよびwriteEventについて、
SharedDataBlockEventSet (execution)がreadEventとwriteEventの両方を含み、かつexecutionにおけるreads-bytes-from (readEvent)がwriteEventを含むなら、readEventはexecutionにおいてwriteEventからreads-fromする。
29.6.4 host-synchronizes-with
- eventAがexecutionにおいてeventBとhost-synchronizes-withであるなら、
HostEventSet (execution)はeventAおよびeventBを含む。 - executionにおけるhost-synchronizes-withと
is-agent-order-before のunionにcycleは存在しない。
このpostMessageなどの追加のsynchronization mechanismsを提供することをallowする。
29.6.5 synchronizes-with
-
events readEventおよびwriteEventについて、readEventがexecutionにおいてwriteEventから
reads-from し、readEvent.[[Order]]がseq-cst であり、writeEvent.[[Order]]がseq-cst であり、かつreadEventとwriteEventがequalmemory ranges を持つなら、writeEventはexecutionにおいてreadEventとsynchronizes-withである。 -
execution.[[EventsRecords]]の各element eventsRecordについて、以下がtrueである。
- events eventAおよびeventBについて、eventsRecord.[[AgentSynchronizesWith]]が(eventA, eventB)を含むなら、eventAはexecutionにおいてeventBとsynchronizes-withである。
- イベント eventA および eventB について、execution 内で eventA が eventB と
host-synchronizes-with する場合、execution 内で eventA は eventB と synchronizes-with する。
29.6.6 happens-before
-
events eventAおよびeventBについて、以下のconditionsのいずれかがtrueなら、eventAはexecutionにおいてeventBのhappens-beforeである。
- eventAはexecutionにおいてeventBの
is-agent-order-before である。 - eventAはexecutionにおいてeventBと
synchronizes-with である。 SharedDataBlockEventSet (execution)がeventAとeventBの両方を含み、eventA.[[Order]]がinit であり、かつeventAとeventBがoverlappingmemory ranges を持つ。- executionにおいて、eventAがeventCのhappens-beforeであり、かつeventCがeventBのhappens-beforeであるようなevent eventCが存在する。
- eventAはexecutionにおいてeventBの
happens-beforeは
29.7 Valid Executionsのプロパティ
29.7.1 Valid Chosen Reads
SharedDataBlockEventSet (execution)の各ReadSharedMemory またはReadModifyWriteSharedMemory event readEventについて、- chosenValueRecordを、[[Event]] fieldがreadEventであるexecution.[[ChosenValues]]のelementとする。
- chosenValueをchosenValueRecord.[[ChosenValue]]とする。
- readValueを
ValueOfReadEvent (execution, readEvent)とする。 - chosenLengthをchosenValue内のelementsの数とする。
- readLengthをreadValue内のelementsの数とする。
- chosenLength ≠ readLengthなら、
false を返す。
- 0（inclusive）からchosenLength（exclusive）までの
interval 内の何らかのinteger iについて、chosenValue[i] ≠ readValue[i]なら、false を返す。
true を返す。
29.7.2 Coherent Reads
SharedDataBlockEventSet (execution)の各ReadSharedMemory またはReadModifyWriteSharedMemory event readEventについて、- writesをexecutionにおける
reads-bytes-from (readEvent)とする。 - byteLocationをreadEvent.[[ByteIndex]]とする。
- writesの各element writeEventについて、
- readEventがexecutionにおいてwriteEventの
happens-before であるなら、false を返す。
- byteLocationをその
memory range 内に持つWriteSharedMemory またはReadModifyWriteSharedMemory event valueであって、executionにおいてwriteEventがvalueのhappens-before であり、かつvalueがreadEventのhappens-before であるものが存在するなら、false を返す。
- byteLocationをbyteLocation + 1に設定する。
- readEventがexecutionにおいてwriteEventの
- writesをexecutionにおける
true を返す。
29.7.3 Tear Free Reads
SharedDataBlockEventSet (execution)の各ReadSharedMemory またはReadModifyWriteSharedMemory event readEventについて、- readEvent.[[NoTear]]が
true なら、Assert : readEvent.[[ByteIndex]]をreadEvent.[[ElementSize]]でdivideしたremainderは0である。- executionにおいてreadEventがwriteEventから
reads-from し、かつwriteEvent.[[NoTear]]がtrue であるような各Memory event writeEventについて、- readEventとwriteEventがequal
memory ranges を持ち、valueとwriteEventがequalmemory ranges を持ち、value.[[NoTear]]がtrue であり、writeEventとvalueが同じShared Data Block event ではなく、かつexecutionにおいてreadEventがvalueからreads-from するようなMemory event valueが存在するなら、false を返す。
- readEventとwriteEventがequal
- readEvent.[[NoTear]]が
true を返す。
直観的には、このrequirementは、
29.7.4 Sequentially Consistent Atomics
- events eventAおよびeventBについて、eventAがexecutionにおいてeventBの
happens-before であるなら、eventAはexecutionにおいてeventBのis-memory-order-beforeである。 -
executionにおいてreadEventがwriteEventから
reads-from するようなevents readEventおよびwriteEventについて、SharedDataBlockEventSet (execution)内にWriteSharedMemory またはReadModifyWriteSharedMemory event valueであって、value.[[Order]]がseq-cst であり、writeEventがexecutionにおいてvalueのis-memory-order-beforeであり、valueがexecutionにおいてreadEventのis-memory-order-beforeであり、かつ以下のconditionsのいずれかがtrueであるものは存在しない。- writeEventがexecutionにおいてreadEventと
synchronizes-with であり、かつvalueとreadEventがequalmemory ranges を持つ。 - writeEventがreadEventの
happens-before であり、かつvalueがexecutionにおいてreadEventのhappens-before であり、writeEvent.[[Order]]がseq-cst であり、かつwriteEventとvalueがequalmemory ranges を持つ。 - writeEventがreadEventの
happens-before であり、かつwriteEventがexecutionにおいてvalueのhappens-before であり、readEvent.[[Order]]がseq-cst であり、かつvalueとreadEventがequalmemory ranges を持つ。
Note 1 このclauseはさらにequal
memory ranges 上のseq-cst eventsをconstrainする。 - writeEventがexecutionにおいてreadEventと
-
SharedDataBlockEventSet (execution)内の各WriteSharedMemory またはReadModifyWriteSharedMemory event writeEventについて、writeEvent.[[Order]]がseq-cst なら、equalmemory range を持ち、writeEventのmemory-order beforeであるReadSharedMemory またはReadModifyWriteSharedMemory eventsがSharedDataBlockEventSet (execution)内にinfinite number存在する、ということはない。Note 2 このclauseは
agents に関するforward progress guaranteeと合わせて、equalmemory range を持つseq-cst writes がfinite time内にseq-cst reads にvisibleになるというliveness conditionをensureする。
is-memory-order-beforeは
29.7.5 Valid Executions
- hostがexecutionについて
host-synchronizes-with Relation を提供する。 - executionが
strict partial order であるhappens-before Relation をadmitする。 - executionがvalid chosen readsを持つ。
- executionがcoherent readsを持つ。
- executionがtear free readsを持つ。
- executionがsequentially consistent atomicsを持つ。
すべてのprogramsには少なくとも1つのvalid executionが存在する。
29.8 Races
execution executionと、
- eventAとeventBが同じ
Shared Data Block event でないなら、- executionにおいてeventAがeventBの
happens-before であり、かつeventBがeventAのhappens-before である、ということが成り立たないなら、- eventAが
WriteSharedMemory またはReadModifyWriteSharedMemory eventのいずれかであり、eventBがWriteSharedMemory またはReadModifyWriteSharedMemory eventのいずれかであり、かつeventAとeventBがdisjointmemory ranges を持たないなら、true を返す。
- eventAがexecutionにおいてeventBから
reads-from する、またはeventBがexecutionにおいてeventAからreads-from するなら、true を返す。
- eventAが
- executionにおいてeventAがeventBの
false を返す。
29.9 Data Races
execution executionと、
- eventAとeventBがexecutionにおいて
race にあるなら、- eventA.[[Order]]が
seq-cst でない、またはeventB.[[Order]]がseq-cst でないなら、true を返す。
- eventAとeventBがoverlapping
memory ranges を持つなら、true を返す。
- eventA.[[Order]]が
false を返す。
29.10 Data Race Freedom
execution executionは、
programは、そのすべてのexecutionsがdata race freeであるならdata race freeである。
29.11 Shared Memory Guidelines
以下は、shared memoryを扱うECMAScript programmers向けのguidelinesである。
programsは
より一般には、programが
以下は、shared memoryを使用するprogramsに対するcompiler transformationsを書くECMAScript implementers向けのguidelinesである。
multi-
agent-order sliceを、single
shared memoryがない場合にvalidなagent-order sliceの任意のtransformationは、以下のexceptionsを除き、shared memoryがある場合にもvalidである。
-
Atomics are carved in stone：Program transformationsは、[[Order]]が
seq-cst であるShared Data Block events をis-agent-order-before Relation からremoveさせてはならず、互いに対してreorderedさせてはならず、また[[Order]]がunordered であるeventsに対してagent-order slice内でreorderedさせてはならない。（実際には、reorderingsの禁止は、compilerに、すべての
seq-cst operationがsynchronizationであり、finalis-memory-order-before Relation にincludedされるとassumeすることを強制する。これは通常、inter-agent program analysisがない場合にいずれにせよassumeしなければならないことである。また、calleeのmemory-orderへのeffectsがunknownであるすべてのcallがseq-cst operationsを含む可能性があるとcompilerにassumeさせる。） -
Reads must be stable：任意のgiven shared memory readは、execution内でsingle valueのみをobserveしなければならない。
（例えば、program内でsemanticallyにはsingle readであるものが複数回executedされた場合、その後programはreadされたvaluesのうち1つだけをobserveすることをallowedされる。rematerializationとして知られるtransformationはこのruleにviolateする可能性がある。）
-
Writes must be stable：shared memoryへのすべてのobservable writesは、execution内のprogram semanticsからfollowしなければならない。
（例えば、transformationは、より小さいdatumを書くためにより大きなlocation上のread-modify-write operationsを使用すること、programがwriteできなかったvalueをmemoryにwriteすること、またはreadされたlocationがread後に別の
agent によってoverwrittenされた可能性がある場合に、そのlocationへjust-read valueを書き戻すことなどにより、特定のobservable writesをintroduceしてはならない。） -
Possible read values must be non-empty：Program transformationsは、shared memory readのpossible read valuesをemptyにしてはならない。
（counterintuitively、このruleはeffectとしてwrites上のtransformationsを制限する。なぜなら、writesは
read events によってreadされる限りにおいてmemory model 内でforceを持つからである。例えば、writesは2つのseq-cst operationsの間でmovedおよびcoalescedされ、時にはreorderedされることがあるが、transformationはlocationをupdatesするすべてのwritesをremoveしてはならない；何らかのwriteはpreservedされなければならない。）
validのままであるtransformationsの例は：同じlocationからの複数のnon-atomic readsをmergeすること、non-atomic readsをreorderすること、speculative non-atomic readsをintroduceすること、同じlocationへの複数のnon-atomic writesをmergeすること、different locationsへのnon-atomic writesをreorderすること、およびterminationに影響する場合でもnon-atomic readsをloopsの外へhoistすること、である。一般に、aliased
以下は、shared memory accessesのためにmachine codeを生成するECMAScript implementers向けのguidelinesである。
memory modelsがARMまたはPowerのものと同程度以上にweakでないarchitecturesについては、non-atomic storesおよびloadsはtarget architecture上のbare storesおよびloadsへcompileしてよい。Atomic storesおよびloadsはsequential consistencyをguaranteeするinstructionsへcompileされてよい。そのようなinstructionsが存在しない場合、bare storeまたはloadの両側にbarriersを配置するなど、memory barriersをemployすることになる。Read-modify-write operationsは、x86上のLOCK-prefixed instructions、ARM上のload-exclusive/store-exclusive instructions、およびPower上のload-link/store-conditional instructionsなど、target architecture上のread-modify-write instructionsへcompileされてよい。
Specifically、
- program内のすべてのatomic operationはnecessaryであるとassumedされる。
- Atomic operationsは互いに、またはnon-atomic operationsとrearrangedされない。
- Functionsは常にatomic operationsをperformするとassumedされる。
- Atomic operationsは、larger data上のread-modify-write operationsとしては決してimplementedされず、platformがappropriate sizeのatomic operationsを持たない場合にはnon-lock-free atomicsとしてimplementedされる。（すべてのplatformがevery interesting sizeのnormal memory access operationsを持つことは既にassumeしている。）
Naive code generationはこれらのpatternsを使用する：
- Regular loadsおよびstoresはsingle loadおよびstore instructionsへcompileされる。
- Lock-free atomic loadsおよびstoresは、full（sequentially consistent）fence、regular loadまたはstore、およびfull fenceへcompileされる。
- Lock-free atomic read-modify-write accessesは、full fence、atomic read-modify-write instruction sequence、およびfull fenceへcompileされる。
- Non-lock-free atomicsは、spinlock acquire、full fence、一連のnon-atomic loadおよびstore instructions、full fence、およびspinlock releaseへcompileされる。
そのmappingは、
- redundant fencesをremoveする明らかなplatform-dependent improvementsが存在する。例えば、x86ではlock-free atomic loadsおよびstoresの周囲のfencesは、storeにfollowingするfenceを除き常にomittedでき、lock-free read-modify-write instructionsにはfenceはneededでない。これらはすべて
LOCK-prefixed instructionsを使用するからである。多くのplatformsにはseveral strengthsのfencesがあり、sequential consistencyをdestroyしない特定のcontextsではweaker fencesを使用できる。 - Most modern platformsは、ECMAScript atomicsによってrequiredされるすべてのdata sizesについてlock-free atomicsをsupportする。non-lock-free atomicsが必要な場合、atomic operationのbodyをsurroundするfencesは通常、lockおよびunlock stepsにfoldできる。non-lock-free atomicsの最も単純なsolutionは、SharedArrayBufferごとにsingle lock wordを持つことである。
- code analysisを必要とする、よりcomplicatedなplatform-dependent local improvementsも存在する。例えば、back-to-backの2つのfencesはしばしばsingle fenceと同じeffectを持つため、sequence内の2つのatomic operationsのためにcodeがgeneratedされる場合、それらをseparateするfenceはsingle fenceだけでよい。x86では、atomic storesをseparatingするsingle fenceでさえomittedできる。なぜならstoreにfollowingするfenceは、storeをsubsequent loadからseparateするためにのみneededだからである。
Annex A (informative) Grammar Summary
A.1 Lexical Grammar
A.2 Expressions
productionのinstanceを処理するとき、
productionのinstanceを処理するとき、
生成規則のインスタンスを処理する際
特定の状況においてproductionのinstanceを処理するとき、
A.3 Statements
生成規則のインスタンスを処理する際
A.4 Functions and Classes
productionのinstanceを処理するとき、
productionのinstanceを処理するとき、
A.5 Scripts and Modules
A.6 Number Conversions
A.7 Time Zone Offset String Format
A.8 Regular Expressions
関連付けられるu \u \u u
Annex B (normative) Webブラウザー向け追加ECMAScript機能
このannexで定義されるECMAScript言語のsyntaxおよびsemanticsは、ECMAScript hostがweb browserである場合にrequiredである。このannexの内容はnormativeであるが、ECMAScript hostがweb browserでない場合はoptionalである。
このannexで定義される一部のfeaturesはこのannexでspecifiedされ、一部はこの文書のmain bodyでspecifiedされる。
featureがmain bodyでspecifiedされる場合、それが文書に影響する各pointは、coloured box内の“
このannexは、web browser ECMAScript
これらfeaturesはcore ECMAScript languageの一部とはconsideredされない。Programmersは新しいECMAScript codeを書くとき、これらfeaturesおよびbehavioursのexistenceを使用またはassumeすべきでない。ECMAScript implementationsは、そのimplementationがweb browserの一部である場合、またはweb browsersがencounterするものと同じlegacy ECMAScript codeをrunすることがrequiredされる場合を除き、これらfeaturesをimplementすることをdiscouragedされる。
B.1 追加Syntax
B.1.1 HTML-like Comments
Syntax
line terminator code pointを含む
B.1.2 Regular Expressions Patterns
このalternative pattern grammarおよびsemanticsは、BMP patternsのsyntaxおよびsemanticsのみをchangeする。以下のgrammar extensionsには[UnicodeMode] parameterでparameterizedされたproductionsが含まれる。しかし、これらextensionsのいずれも、
Syntax
同じleft-hand sidesが[+UnicodeMode]および[~UnicodeMode] guardsの両方でoccurする場合、それはdisambiguation priorityをcontrolするためである。
B.1.2.1 Static Semantics: Early Errors
- このproductionによりsource textがmatchされる場合、それはSyntax Errorである。
さらに、以下のproductionsのrulesは、highlighted textのadditionによりmodifiedされる：
-
first
ClassAtom のIsCharacterClass がtrue である、またはsecondClassAtom のIsCharacterClass がtrue でありこのproductionが[UnicodeMode] parameterを持つなら、それはSyntax Errorである。 -
first
ClassAtom のIsCharacterClass がfalse であり、secondClassAtom のIsCharacterClass がfalse であり、firstClassAtom のCharacterValue がsecondClassAtom のCharacterValue よりstrictly greaterであるなら、それはSyntax Errorである。
-
ClassAtomNoDash のIsCharacterClass がtrue である、またはClassAtom のIsCharacterClass がtrue でありこのproductionが[UnicodeMode] parameterを持つなら、それはSyntax Errorである。 -
ClassAtomNoDash のIsCharacterClass がfalse であり、ClassAtom のIsCharacterClass がfalse であり、ClassAtomNoDash のCharacterValue がClassAtom のCharacterValue よりstrictly greaterであるなら、それはSyntax Errorである。
B.1.2.2 Static Semantics: CountLeftCapturingParensWithin and CountLeftCapturingParensBefore
B.1.2.3 Static Semantics: IsCharacterClass
false を返す。
B.1.2.4 Static Semantics: CharacterValue
- U+005C (REVERSE SOLIDUS)のnumeric valueを返す。
- codePointを
ClassControlLetter によりmatchedされるcode pointとする。 - iをcodePointのnumeric valueとする。
- iを32で割ったremainderを返す。
LegacyOctalEscapeSequence のMVを返す（12.9.4.3 を参照）。
B.1.2.5 Runtime Semantics: CompileSubpattern
B.1.2.6 Runtime Semantics: CompileAssertion
B.1.2.7 Runtime Semantics: CompileAtom
- charSetを、single character
\U+005C (REVERSE SOLIDUS)を含むCharSet とする。 CharacterSetMatcher (regexpRecord, charSet,false , direction)を返す。
- charを
ExtendedPatternCharacter によりrepresentedされるcharacterとする。 - charSetをcharacter charを含むone-element
CharSet とする。 CharacterSetMatcher (regexpRecord, charSet,false , direction)を返す。
B.1.2.8 Runtime Semantics: CompileToCharSet
以下の2つのrulesは、
- charSetをargument regexpRecordを伴うfirst
ClassAtom のCompileToCharSet とする。 - otherSetをargument regexpRecordを伴うsecond
ClassAtom のCompileToCharSet とする。 - remainingSetをargument regexpRecordを伴う
ClassContents のCompileToCharSet とする。 - rangeSetを
CharacterRangeOrUnion (regexpRecord, charSet, otherSet)とする。 - rangeSetとremainingSetのunionを返す。
- charSetをargument regexpRecordを伴う
ClassAtomNoDash のCompileToCharSet とする。 - otherSetをargument regexpRecordを伴う
ClassAtom のCompileToCharSet とする。 - remainingSetをargument regexpRecordを伴う
ClassContents のCompileToCharSet とする。 - rangeSetを
CharacterRangeOrUnion (regexpRecord, charSet, otherSet)とする。 - rangeSetとremainingSetのunionを返す。
さらに、以下のrulesが
- charValueをこの
ClassEscape のCharacterValue とする。 - charをcharacter valueがcharValueであるcharacterとする。
- single character charを含む
CharSet を返す。
- single character
\U+005C (REVERSE SOLIDUS)を含むCharSet を返す。
\cからのみreachedされうる。B.1.2.8.1 CharacterRangeOrUnion ( regexpRecord, charSet, otherSet )
The abstract operation CharacterRangeOrUnion takes arguments regexpRecord (a
HasEitherUnicodeFlag (regexpRecord)がfalse なら、CharacterRange (charSet, otherSet)を返す。
B.1.2.9 Static Semantics: ParsePattern ( patternText, u, v )
abstract operation
- vが
true でありuがtrue なら、- parseResultを1つ以上の
SyntaxError objectsを含むList とする。
- parseResultを1つ以上の
- そうでなく、vが
true なら、 - そうでなく、uが
true なら、 - そうでなければ、
- parseResultを返す。
B.2 追加Built-in Properties
ECMAScript hostがweb browserである場合、standard built-in objectsの以下のadditional propertiesがdefinedされる。
B.2.1 Global Objectの追加Properties
| Intrinsic Name | Global Name | ECMAScript Language Association |
|---|---|---|
|
|
|
escape function（ |
|
|
|
unescape function（ |
B.2.1.1 escape ( string )
このfunctionは
numeric valueが0x00FF以下のcode unitをreplacingするとき、%xx形式のtwo-digit escape sequenceが使用される。numeric valueが0x00FFよりstrictly greaterであるcode unitをreplacingするとき、%uxxxx形式のfour-digit escape sequenceが使用される。
これは%escape% intrinsic objectである。
呼び出されたとき、以下のstepsを実行する：
- stringを ?
ToString (string) に設定する。 - lengthをstringのlengthとする。
- resultをempty Stringとする。
- unescapedSetをASCII word charactersと
"@*+-./" のstring-concatenation とする。 - kを0とする。
- k < lengthである間、繰り返す：
- codeUnitをstring内のindex kにあるcode unitとする。
- unescapedSetがcodeUnitをcontainするなら、
- nextPartをcodeUnitとする。
- そうでなければ、
- codeUnitNumberをcodeUnitのnumeric valueとする。
- codeUnitNumber < 256なら、
- hexを、uppercase hexadecimal numberとしてformattedされたcodeUnitNumberのString representationとする。
- nextPartを
"%" とStringPad (hex, 2,"0" ,start )のstring-concatenation とする。
- そうでなければ、
- hexを、uppercase hexadecimal numberとしてformattedされたcodeUnitNumberのString representationとする。
- nextPartを
"%u" とStringPad (hex, 4,"0" ,start )のstring-concatenation とする。
- resultをresultとnextPartの
string-concatenation に設定する。 - kをk + 1に設定する。
- resultを返す。
このencodingは、RFC 1738でdescribedされるencodingにpartly基づくが、このstandardでspecifiedされるentire encodingは、RFC 1738のcontentsに関係なく上にdescribedされる。このencodingは、RFC 3986によってRFC 1738に行われたchangesをreflectしない。
B.2.1.2 unescape ( string )
このfunctionはescape functionによってintroducedされうるsortの各escape sequenceが、それがrepresentsするcode unitでreplacedされたString valueのnew versionをcomputesする。
これは%unescape% intrinsic objectである。
呼び出されたとき、以下のstepsを実行する：
- stringを ?
ToString (string) に設定する。 - lengthをstringのlengthとする。
- resultをempty Stringとする。
- kを0とする。
- k < lengthである間、繰り返す：
- codeUnitをstring内のindex kにあるcode unitとする。
- codeUnitがcode unit 0x0025 (PERCENT SIGN)であるなら、
- hexDigitsをempty Stringとする。
- optionalAdvanceを0とする。
- k + 5 < lengthであり、string内のindex k + 1にあるcode unitがcode unit 0x0075 (LATIN SMALL LETTER U)であるなら、
- hexDigitsをstringのk + 2からk + 6までの
substring に設定する。 - optionalAdvanceを5に設定する。
- hexDigitsをstringのk + 2からk + 6までの
- そうでなく、k + 3 ≤ lengthなら、
- hexDigitsをstringのk + 1からk + 3までの
substring に設定する。 - optionalAdvanceを2に設定する。
- hexDigitsをstringのk + 1からk + 3までの
- parseResultを
ParseText (hexDigits,HexDigits )とする。[~Sep] - parseResultが
Parse Node なら、- codeUnitNumberをparseResultのMVとする。
- codeUnitをnumeric valueがcodeUnitNumberであるcode unitに設定する。
- kをk + optionalAdvanceに設定する。
- resultをresultとcodeUnitの
string-concatenation に設定する。 - kをk + 1に設定する。
- resultを返す。
B.2.2 String.prototype Objectの追加Properties
B.2.2.1 String.prototype.substr ( start, length )
このmethodは、
呼び出されたとき、以下のstepsを実行する：
- objを
this valueとする。 - ?
RequireObjectCoercible (obj)を実行する。 - stringを ?
ToString (obj) とする。 - sizeをstringのlengthとする。
- intStartを ?
ToIntegerOrInfinity (start) とする。 - intStart = -∞なら、intStartを0に設定する。
- そうでなく、intStart < 0なら、intStartを
max (size + intStart, 0)に設定する。 - そうでなければ、intStartを
min (intStart, size)に設定する。 - lengthが
undefined なら、intLengthをsizeとする；そうでなければ、intLengthを ?ToIntegerOrInfinity (length) とする。 - intLengthを0とsizeの間に
clamping したresultに設定する。 - intEndを
min (intStart + intLength, size)とする。 - stringのintStartからintEndまでの
substring を返す。
このmethodはintentionally genericである；その
B.2.2.2 String.prototype.anchor ( name )
このmethodは呼び出されたとき、以下のstepsを実行する：
- stringを
this valueとする。 - ?
CreateHTML (string,"a" ,"name" , name)を返す。
B.2.2.2.1 CreateHTML ( contents, tag, attr, attrValue )
The abstract operation CreateHTML takes arguments contents (an ECMAScript language value), tag (a String), attr (a String), and attrValue (an ECMAScript language value) and returns either a
- ?
RequireObjectCoercible (contents)を実行する。 - contentsStringを ?
ToString (contents) とする。 - part1を
"<" とtagのstring-concatenation とする。 - attrがempty Stringでないなら、
- attrValueStringを ?
ToString (attrValue) とする。 - escapedAttrValueを、attrValueString内のcode unit 0x0022 (QUOTATION MARK)の各occurrenceがsix code unit sequence
""" でreplacedされたことを除きattrValueStringと同じString valueとする。 - part1を以下の
string-concatenation に設定する：- part1
- code unit 0x0020 (SPACE)
- attr
- code unit 0x003D (EQUALS SIGN)
- code unit 0x0022 (QUOTATION MARK)
- escapedAttrValue
- code unit 0x0022 (QUOTATION MARK)
- attrValueStringを ?
- part2をpart1と
">" のstring-concatenation とする。 - part3をpart2とcontentsStringの
string-concatenation とする。 - part4をpart3、
"</" 、tag、および">" のstring-concatenation とする。 - part4を返す。
B.2.2.3 String.prototype.big ( )
このmethodは呼び出されたとき、以下のstepsを実行する：
- stringを
this valueとする。 - ?
CreateHTML (string,"big" ,"" ,"" )を返す。
B.2.2.4 String.prototype.blink ( )
このmethodは呼び出されたとき、以下のstepsを実行する：
- stringを
this valueとする。 - ?
CreateHTML (string,"blink" ,"" ,"" )を返す。
B.2.2.5 String.prototype.bold ( )
このmethodは呼び出されたとき、以下のstepsを実行する：
- stringを
this valueとする。 - ?
CreateHTML (string,"b" ,"" ,"" )を返す。
B.2.2.6 String.prototype.fixed ( )
このmethodは呼び出されたとき、以下のstepsを実行する：
- stringを
this valueとする。 - ?
CreateHTML (string,"tt" ,"" ,"" )を返す。
B.2.2.7 String.prototype.fontcolor ( colour )
このmethodは呼び出されたとき、以下のstepsを実行する：
- stringを
this valueとする。 - ?
CreateHTML (string,"font" ,"color" , colour)を返す。
B.2.2.8 String.prototype.fontsize ( size )
このmethodは呼び出されたとき、以下のstepsを実行する：
- stringを
this valueとする。 - ?
CreateHTML (string,"font" ,"size" , size)を返す。
B.2.2.9 String.prototype.italics ( )
このmethodは呼び出されたとき、以下のstepsを実行する：
- stringを
this valueとする。 - ?
CreateHTML (string,"i" ,"" ,"" )を返す。
B.2.2.10 String.prototype.link ( url )
このmethodは呼び出されたとき、以下のstepsを実行する：
- stringを
this valueとする。 - ?
CreateHTML (string,"a" ,"href" , url)を返す。
B.2.2.11 String.prototype.small ( )
このmethodは呼び出されたとき、以下のstepsを実行する：
- stringを
this valueとする。 - ?
CreateHTML (string,"small" ,"" ,"" )を返す。
B.2.2.12 String.prototype.strike ( )
このmethodは呼び出されたとき、以下のstepsを実行する：
- stringを
this valueとする。 - ?
CreateHTML (string,"strike" ,"" ,"" )を返す。
B.2.2.13 String.prototype.sub ( )
このmethodは呼び出されたとき、以下のstepsを実行する：
- stringを
this valueとする。 - ?
CreateHTML (string,"sub" ,"" ,"" )を返す。
B.2.2.14 String.prototype.sup ( )
このmethodは呼び出されたとき、以下のstepsを実行する：
- stringを
this valueとする。 - ?
CreateHTML (string,"sup" ,"" ,"" )を返す。
B.2.2.15 String.prototype.trimLeft ( )
B.2.2.16 String.prototype.trimRight ( )
B.2.3 Date.prototype Objectの追加Properties
B.2.3.1 Date.prototype.getYear ( )
getFullYear methodは“year 2000 problem”をavoidするため、ほぼすべての目的でpreferredされる。
このmethodは呼び出されたとき、以下のstepsを実行する：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - tvをdateObj.[[DateValue]]とする。
- tvが
NaN なら、NaN を返す。 YearFromTime (LocalTime (tv)) -1900 𝔽を返す。
B.2.3.2 Date.prototype.setYear ( year )
setFullYear methodは“year 2000 problem”をavoidするため、ほぼすべての目的でpreferredされる。
このmethodは呼び出されたとき、以下のstepsを実行する：
- dateObjを
this valueとする。 - ?
RequireInternalSlot (dateObj, [[DateValue]])を実行する。 - timeをdateObj.[[DateValue]]とする。
- yearを ?
ToNumber (year) とする。 - timeが
NaN なら、timeを+0 𝔽に設定する；そうでなければ、timeをLocalTime (time)に設定する。 - fullYearを
MakeFullYear (year)とする。 - dayを
MakeDay (fullYear,MonthFromTime (time),DateFromTime (time))とする。 - dateを
MakeDate (day,TimeWithinDay (time))とする。 - utcTimestampを
TimeClip (UTC (date))とする。 - dateObj.[[DateValue]]をutcTimestampに設定する。
- utcTimestampを返す。
B.2.3.3 Date.prototype.toGMTString ( )
toUTCString methodがpreferredされる。このmethodは主にold codeとのcompatibilityのためにprovidedされる。
B.2.4 RegExp.prototype Objectの追加Properties
B.2.4.1 RegExp.prototype.compile ( pattern, flags )
このmethodは呼び出されたとき、以下のstepsを実行する：
- objを
this valueとする。 - ?
RequireInternalSlot (obj, [[RegExpMatcher]])を実行する。 - patternがObjectであり、patternが[[RegExpMatcher]] internal slotを持つなら、
- flagsが
undefined でないなら、TypeError 例外をthrowする。 - flagsをpattern.[[OriginalFlags]]に設定する。
- patternをpattern.[[OriginalSource]]に設定する。
- flagsが
- ?
RegExpInitialize (obj, pattern, flags)を返す。
このmethodは
B.3 その他の追加Features
B.3.1 Labelled Function Declarations
ECMAScript 2015より前、
B.3.2 Block-Level Function Declarations Web Legacy Compatibility Semantics
ECMAScript 2015より前、ECMAScript specificationは
-
functionがdeclaredされ、single block内でのみreferencedされる。
-
BindingIdentifier がname fである1つ以上のFunctionDeclaration sが、enclosing function gのfunction code内にoccurし、そのdeclarationがBlock 内にnestedされている。 -
fの他のdeclarationで、
vardeclarationでないものは、gのfunction code内にoccurしない。 -
IdentifierReference としてのfのすべてのoccurrencesは、fのdeclarationをcontainするBlock のStatementList 内にある。
-
-
functionがdeclaredされ、single
Block 内でpossibly usedされるが、同じBlock 内にcontainedされないinner function definitionによってalso referencedされる。-
BindingIdentifier がname fである1つ以上のFunctionDeclaration sが、enclosing function gのfunction code内にoccurし、そのdeclarationがBlock 内にnestedされている。 -
fの他のdeclarationで、
vardeclarationでないものは、gのfunction code内にoccurしない。 -
fのdeclarationをcontainする
Block のStatementList 内に、IdentifierReference としてのfのoccurrencesがあってもよい。 -
g内にnestedされた別のfunction h内に、
IdentifierReference としてのfのoccurrenceが少なくとも1つあり、h内からのfへのreferencesをshadowするfの他のdeclarationがない。 - hのすべてのinvocationsは、fのdeclarationがevaluatedされた後にoccurする。
-
-
functionがdeclaredされ、single block内でpossibly usedされるが、subsequent blocks内でもreferencedされる。
-
BindingIdentifier がname fである1つ以上のFunctionDeclaration が、enclosing function gのfunction code内にoccurし、そのdeclarationがBlock 内にnestedされている。 -
fの他のdeclarationで、
vardeclarationでないものは、gのfunction code内にoccurしない。 -
fのdeclarationをcontainする
Block のStatementList 内に、IdentifierReference としてのfのoccurrencesがあってもよい。 -
fのdeclarationをcontainする
Block にlexically followsするgのfunction code内に、IdentifierReference としてのfのoccurrenceが少なくとも1つある。
-
first use caseは、ECMAScript 2015によってprovidedされる
secondおよびthird use casesのECMAScript 2015 interoperabilityは、clause
ECMAScript implementationがdiagnostic warning messagesをreportするmechanismを持つ場合、これらcompatibility semanticsがappliedされ、non-compatibility semanticsからobservable differencesをintroduceする
このfeatureは以下のpointsでspecial semanticsをinvolvesする：
14.2.1 内のBlock : { StatementList } early error rulesの1つ14.12.1 内のSwitchStatement : switch ( Expression ) CaseBlock early error rulesの1つFunctionDeclarationInstantiation 内のstep32.a BlockDeclarationInstantiation 内のstep3.a.ii.1 BlockDeclarationInstantiation 内のstep3.b.iii GlobalDeclarationInstantiation 内のstep12 EvalDeclarationInstantiation 内のstep13
B.3.3 IfStatement Statement Clauses内のFunctionDeclarations
以下は
このproductionは、
B.3.4 Catch Blocks内のVariableStatements
このfeatureでは、var declarationsをcontainしてもよい。これは、
runtimeでは、そのようなbindingsはVariableDeclarationEnvironment内でinstantiatedされる。それらはvar declarationsのvar bindingではなくcorresponding catch parameterへassignする。
このmodified behaviourは、varおよびfunction declarationsにもappliesする。このchangeは、
B.3.5 ForIn Statement Heads内のInitializers
以下は
このproductionは、
- argument labelSetを伴う
Statement のContainsDuplicateLabels を返す。
- argument labelSetを伴う
Statement のContainsUndefinedBreakTarget を返す。
- arguments iterationSetおよび « » を伴う
Statement のContainsUndefinedContinueTarget を返す。
false を返す。
- names1を
BindingIdentifier のBoundNames とする。 - names2を
Statement のVarDeclaredNames とする。 - names1とnames2の
list-concatenation を返す。
- decls1を «
BindingIdentifier » とする。 - decls2を
Statement のVarScopedDeclarations とする。 - decls1とdecls2の
list-concatenation を返す。
- bindingIdを
BindingIdentifier のStringValue とする。 - lhsを ?
ResolveBinding (bindingId) とする。 IsAnonymousFunctionDefinition (Initializer )がtrue なら、- valueをargument bindingIdを伴う
Initializer のNamedEvaluation とする。
- valueをargument bindingIdを伴う
- そうでなければ、
- rhsを ?
Initializer のEvaluation とする。 - valueを ?
GetValue (rhs) とする。
- rhsを ?
- ?
PutValue (lhs, value)を実行する。 - keyResultを ?
ForIn/OfHeadEvaluation (« »,Expression ,enumerate ) とする。 - ?
ForIn/OfBodyEvaluation (BindingIdentifier ,Statement , keyResult,enumerate ,var-binding , labelSet)を返す。
B.3.6 [[IsHTMLDDA]] Internal Slot
[[IsHTMLDDA]] internal slotはtypeof operator
[[IsHTMLDDA]] internal slotを持つObjectsは、このspecificationによってcreatedされることはない。しかし、web browsersにおけるdocument.all objectは、web compatibility purposesのために存在するこのslotを持つdocument.allのexceptionを除き、これを持つものをcreateすべきでない。
このfeatureは以下のpointsでspecial semanticsをinvolvesする：
ToBoolean 内のstep3 IsLooselyEqual 内のstep4 typeofのevaluation semantics内のstep12
B.3.7 HostMakeJobCallbackにおけるNon-default behaviour
B.3.8 HostEnsureCanAddPrivateElementにおけるNon-default behaviour
B.3.9 Function Call Assignment Targetsに対するRuntime Errors
function call（
assignment targetが=または??=、&&=、||=）にはapplyしない。
Annex C (informative) ECMAScriptのStrict Mode
strict modeのrestrictionおよびexceptions
-
implements、interface、let、package、private、protected、public、static、およびyieldはstrict mode code 内でreserved words である。（12.7.2 ）。 -
conforming implementationは、
strict mode code をprocessingするとき、productionsNumericLiteral :: LegacyOctalIntegerLiteral DecimalIntegerLiteral :: NonOctalDecimalIntegerLiteral -
conforming implementationは、
strict mode code をprocessingするとき、productionsEscapeSequence :: LegacyOctalEscapeSequence EscapeSequence :: NonOctalDecimalEscapeSequence -
undeclared identifierまたはotherwise unresolvable referenceへのAssignmentは、
global object 内にpropertyをcreateしない。simple assignmentがstrict mode code 内でoccurする場合、そのLeftHandSideExpression はunresolvable Referenceへevaluateしてはならない。もしそうならReferenceError 例外がthrownされる（6.2.5.6 ）。LeftHandSideExpression はまた、attribute value { [[Writable]]:false }を持つdata property へのreference、attribute value { [[Set]]:undefined }を持つaccessor property へのreference、または[[Extensible]] internal slotがfalse であるobjectのnon-existent propertyへのreferenceであってもならない。これらの場合、TypeError例外がthrownされる（13.15 ）。 -
StringValue が"eval" または"arguments" であるIdentifierReference は、Assignment operator（13.15 ）またはUpdateExpression （13.4 ）のLeftHandSideExpression として、あるいはPrefix Increment（13.4.4 ）またはPrefix Decrement（13.4.5 ）operatorによってoperated uponされるUnaryExpression としてappearしてはならない。 -
strict functions のArguments objectsは、access時にTypeError 例外をthrowするnon-configurableaccessor property "callee" をdefineする（10.4.4.6 ）。 -
strict functions のArguments objectsは、そのarray-indexed property valuesを、そのfunctionsのcorresponding formal parameter bindingsとdynamically shareしない。（10.4.4 ）。 -
strict functions では、arguments objectがcreatedされる場合、local identifierargumentsのarguments objectへのbindingはimmutableであり、したがってassignment expressionのtargetであってはならない。（10.2.11 ）。 -
BindingIdentifier のStringValue がstrict mode code 内で"eval" または"arguments" のいずれかであるなら、それはSyntaxError である（13.1.1 ）。 -
Strict mode eval codeは、evalのcallerのvariable environment内でvariablesまたはfunctionsをinstantiateできない。代わりに、new variable environmentがcreatedされ、そのenvironmentがeval codeのdeclaration binding instantiationに使用される（
19.2.1 ）。 -
strict mode code 内でthis がevaluatedされる場合、this valueはobjectへcoercedされない。undefined またはnull のthis valueはglobal object へconvertedされず、primitive valuesはwrapper objectsへconvertedされない。function call（Function.prototype.applyおよびFunction.prototype.callを使用して行われるcallsを含む）を介してpassedされるthis valueは、passedされたthis valueをobjectへcoerceしない（10.2.1.2 、20.2.3.1 、20.2.3.3 ）。 -
deleteoperatorがstrict mode code 内でoccurする場合、そのUnaryExpression がvariable、function argument、またはfunction nameへのdirect referenceであるなら、SyntaxError がthrownされる（13.5.1.1 ）。 -
deleteoperatorがstrict mode code 内でoccurする場合、deletedされるpropertyがattribute { [[Configurable]]:false }を持つ、またはotherwise deletedできないなら、TypeError がthrownされる（13.5.1.2 ）。 -
Strict mode code はWithStatement をincludeしてはならない。そのようなcontextでWithStatement がoccurすることはSyntaxError である（14.11.1 ）。 -
CatchParameter がstrict mode code 内でoccurし、CatchParameter のBoundNames がevalまたはargumentsのいずれかをcontainsするなら、それはSyntaxError である（14.15.1 ）。 -
strict function のFormalParameters 内に同じBindingIdentifier が複数回appearするなら、それはSyntaxError である。Function、Generator、またはAsyncFunctionconstructor を使用してそのようなfunctionをcreateしようとすることはSyntaxError である（15.2.1 、20.2.1.1.1 ）。 -
implementationは、このspecificationでdefinedされるものを超えて、
strict functions 内のfunction instancesの"caller" または"arguments" というpropertiesのmeaningsをextendしてはならない。
Annex D (informative) Host Layering Points
hostのdefinitionについては
D.1 Host Hooks
D.2 Host-defined Fields
[[IsHTMLDDA]]：
D.3 Host-defined Objects
D.4 Running Jobs
D.5 Exotic ObjectsのInternal Methods
このspecification内でspecifiedされていない任意の
D.6 Built-in Objects and Methods
Annex E (informative) 互換性に影響する可能性があるECMAScript 2015におけるCorrections and Clarifications
Date.prototype.toStringによってreturnedされるvalueをspecifyしていなかった。ECMAScript 2015はresultをString value
/のescapingのみをrequiredしていた。
String.prototype.matchおよびString.prototype.replaceのspecificationsは、pattern argumentがglobal flagをsetされたRegExp valueであるcasesについてincorrectであった。previous specificationsは、patternをmatchする各attemptについて、lastIndexがchangeしなかった場合、それは1だけincrementedされるべきだとstatedしていた。correct behaviourは、patternがempty Stringにmatchedした場合にのみlastIndexが1だけincrementedされるべきであるというものである。
Array.prototype.sortによってcomparatorからreturnedされる
Annex F (informative) 以前のEditionsとのIncompatibilitiesをIntroduceするAdditions and Changes
Space_Separator（Zs）categoryにあり、したがってwhitespaceとしてtreatedされていたが、（Unicode 6.3.0以降）Format（Cf）categoryへmovedされた。これにより、whitespace-sensitive methodsは異なってbehaveする。例えば、"\u180E".trim().lengthはprevious editionsでは0であったが、ECMAScript 2016以降では1である。さらに、ECMAScript 2017はUnicode Standardのlatest versionを常に使用することをmandatedした。
letで始まりtoken [が続く
( tokenの直後にtoken sequence let [が続く場合、そのletは
let [が続く場合、そのletは
in
var declarationをcontainすることは
evalをevaluatesし、そのeval codeがvarまたはFunctionDeclaration declarationを含む場合、runtime
Object.freezeへのargumentがobjectでない場合、それはown propertiesを持たないnon-extensible
Object.getOwnPropertyDescriptorへのargumentがobjectでない場合、
Object.getOwnPropertyNamesへのargumentがobjectでない場合、
Object.getPrototypeOfへのargumentがobjectでない場合、
Object.isExtensibleへのargumentがobjectでない場合、それはown propertiesを持たないnon-extensible
Object.isFrozenへのargumentがobjectでない場合、それはown propertiesを持たないnon-extensible
Object.isSealedへのargumentがobjectでない場合、それはown propertiesを持たないnon-extensible
Object.keysへのargumentがobjectでない場合、
Object.preventExtensionsへのargumentがobjectでない場合、それはown propertiesを持たないnon-extensible
Object.sealへのargumentがobjectでない場合、それはown propertiesを持たないnon-extensible
String.prototype.localeCompare functionはUnicode Standardに従ってcanonically equivalentであるStringsをidenticalとしてtreatしなければならない。previous editionsでは、implementationsはcanonical equivalenceをignoreし、代わりにbit-wise comparisonを使用することがpermittedされていた。
String.prototype.trim methodはUnicode BMP外にexistしうるwhite space code pointsをrecognizeするようにdefinedされる。しかし、Unicode 7時点ではそのようなcode pointsはdefinedされていない。previous editionsでは、そのようなcode pointsはwhite spaceとしてrecognizedされなかった。
Atomics.waitとのconfusionをpreventするため、Atomics.wakeはAtomics.notifyへrenamedされた。
awaitによってenqueuedされるthen() callとawait expressionの間のresolution orderにobservable differenceをcreateしうる。
Bibliography
-
IEEE 754-2019: IEEE Standard for Floating-Point Arithmetic. Institute of Electrical and Electronic Engineers, New York (2019)
Note ECMA-262 specificationに影響するnormative changesは、IEEE 754-2008とIEEE 754-2019の間にない。
- The Unicode Standard、<https://unicode.org/versions/latest>で入手可能
- Unicode Technical Note #5: Canonical Equivalence in Applications、<https://unicode.org/notes/tn5/>で入手可能
- Unicode Technical Standard #10: Unicode Collation Algorithm、<https://unicode.org/reports/tr10/>で入手可能
- Unicode Standard Annex #15, Unicode Normalization Forms、<https://unicode.org/reports/tr15/>で入手可能
- Unicode Standard Annex #18: Unicode Regular Expressions、<https://unicode.org/reports/tr18/>で入手可能
-
Unicode Standard Annex #24: Unicode
ScriptProperty、<https://unicode.org/reports/tr24/>で入手可能 - Unicode Standard Annex #31, Unicode Identifiers and Pattern Syntax、<https://unicode.org/reports/tr31/>で入手可能
- Unicode Standard Annex #44: Unicode Character Database、<https://unicode.org/reports/tr44/>で入手可能
- Unicode Technical Standard #51: Unicode Emoji、<https://unicode.org/reports/tr51/>で入手可能
- IANA Time Zone Database、<https://www.iana.org/time-zones>で入手可能
- ISO 8601:2004(E) Data elements and interchange formats — Information interchange — Representation of dates and times
- RFC 1738 “Uniform Resource Locators (URL)”、<https://tools.ietf.org/html/rfc1738>で入手可能
- RFC 2396 “Uniform Resource Identifiers (URI): Generic Syntax”、<https://tools.ietf.org/html/rfc2396>で入手可能
- RFC 3629 “UTF-8, a transformation format of ISO 10646”、<https://tools.ietf.org/html/rfc3629>で入手可能
- RFC 7231 “Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content”、<https://tools.ietf.org/html/rfc7231>で入手可能
Colophon
このspecificationは、GitHub上で、Ecmarkupと呼ばれるplaintext source formatでauthoredされる。Ecmarkupは、plaintextでEcma specificationsをauthoringし、この文書のeditorial conventionsに従うfull-featured HTML renderingへspecificationをprocessingするためのframeworkおよびtoolsetを提供するHTML and Markdown dialectである。Ecmarkupは、syntaxをdefiningするためのGrammarkdownや、algorithm stepsをauthoringするためのEcmarkdownを含む、多数の他のformatsおよびtechnologiesをbuilds on and integratesする。このspecificationのPDF renderingsは、CSS Paged Media specificationを利用するprint stylesheetを使用してproducedされ、PrinceXMLを使用してconvertedされる。
このspecificationのprior editionsはWordを使用してauthoredされていた。このeditionのbasisをformedしたEcmarkup source textは、automated conversion toolを使用してECMAScript 2015 Word documentをEcmarkupへconvertingすることでproducedされた。
Copyright & Software License
Ecma International
Rue du Rhone 114
CH-1204 Geneva
Tel: +41 22 849 6000
Fax: +41 22 849 6001
Web: https://ecma-international.org/
Copyright Notice
ALTERNATIVE COPYRIGHT NOTICE AND COPYRIGHT LICENSE
© 2026 Ecma International
By obtaining and/or copying this work, you (the licensee) agree that you have read, understood, and will comply with the following terms and conditions.
Permission under Ecma’s copyright to copy, modify, prepare derivative works of, and distribute this work, with or without modification, for any purpose and without fee or royalty is hereby granted, provided that you include the following on ALL copies of the work or portions thereof, including modifications:
(i) The full text of this COPYRIGHT NOTICE AND COPYRIGHT LICENSE in a location viewable to users of the redistributed or derivative work.
(ii) Any pre-existing intellectual property disclaimers, notices, or terms and conditions. If none exist, the Ecma alternative copyright notice should be included.
(iii) Notice of any changes or modifications, through a copyright statement on
the document such as “This document includes material copied from or
derived from ECMAScript® 2027 言語仕様 https://tc39.es/ecma262/.
Copyright © Ecma International.”
Disclaimers
THIS WORK IS PROVIDED “AS IS,” AND COPYRIGHT HOLDERS MAKE NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE DOCUMENT WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.
COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE DOCUMENT.
The name and trademarks of copyright holders may NOT be used in advertising or publicity pertaining to the work without specific, written prior permission. Title to copyright in this work will at all times remain with copyright holders.
Software License
All Software contained in this document ("Software") is protected by copyright and is being made available under the "BSD License", included below. This Software may be subject to third party rights (rights from parties other than Ecma International), including patent rights, and no licenses under such third party rights are granted under this license even if the third party concerned is a member of Ecma International. SEE THE ECMA CODE OF CONDUCT IN PATENT MATTERS AVAILABLE AT https://ecma-international.org/memento/codeofconduct.htm FOR INFORMATION REGARDING THE LICENSING OF PATENT CLAIMS THAT ARE REQUIRED TO IMPLEMENT ECMA INTERNATIONAL STANDARDS.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
- Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
- Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
- Neither the name of the authors nor Ecma International may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE ECMA INTERNATIONAL "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ECMA INTERNATIONAL BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.