Draft ECMA-262 / May 7, 2026
ECMAScript® 2027 Language Specification
この仕様について
https://tc39.es/ecma262/ にあるドキュメントは、最も正確で最新のECMAScript仕様書です。最新の年次スナップショットの内容と、提案プロセスでステージ4に到達し、いくつかの実装ですでに実装され、次回の年次スナップショットに含まれる完了した提案も含まれています。過去のスナップショットは https://ecma-international.org/publications-and-standards/standards/ecma-262/ で入手できます。
このドキュメントは単一ページおよび複数ページとして利用できます。
この仕様への貢献
この仕様は、ECMAScriptコミュニティの協力のもとGitHub上で開発されています。以下のような方法で本仕様の開発に貢献できます：
- GitHubリポジトリ：https://github.com/tc39/ecma262
- イシュー：すべてのイシュー、新しいイシューを作成
- プルリクエスト：すべてのプルリクエスト、新しいプルリクエストの作成
- テストスイート：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ブラウザに登場しました。ウェブブラウザに組み込まれた言語として有名ですが、サーバや組込み用途などブラウザ以外でも幅広く採用され、世界で最も広く使われている汎用プログラミング言語の一つとなりました。
ECMAScript言語仕様の開発は1996年11月に開始されました。このEcma規格の最初の版は、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例外処理、エラーのより厳密な定義、数値出力の書式設定、将来の言語発展を見越した軽微な変更が加えられました。第3版は1999年12月のEcma総会で採択され、2002年6月にISO/IEC 16262:2002として発行されました。
第3版発行後、ECMAScriptはWorld Wide Webとともに爆発的に普及し、事実上すべてのウェブブラウザが対応するプログラミング言語となりました。ECMAScript第4版の開発にも大きな労力が注がれましたが、これは完成には至らず第4版として出版されませんでしたが、一部は第6版の開発に取り入れられました。
ECMAScript第5版（ECMA-262 第5版として発行）は、ブラウザ実装で一般的になった仕様の事実上の解釈を規格化し、第3版以降に登場した新機能への対応も追加しました。これにはアクセサプロパティ、オブジェクトの動的生成や検査、プロパティ属性の制御、配列操作関数追加、JSONオブジェクト形式、エラー検出やプログラムの安全性を高める厳格モードなどが含まれます。第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、分割代入パターン、適切な末尾呼び出しなどが含まれます。組み込みライブラリには、MapやSet、バイナリ数値配列などのデータ抽象サポート、文字列と正規表現のUnicode補助文字対応の拡張、サブクラス化による拡張性の向上が加わりました。第6版は、定期的かつ段階的な言語・ライブラリの改良の基盤となります。第6版は2015年6月の総会で採択されました。
ECMAScript 2016は、Ecma TC39の新しい年次リリースサイクルとオープンな開発プロセスによる最初の版です。ECMAScript 2015のソース文書をもとにプレーンテキストのソース文書が作成され、全てGitHub上で開発が進みました。この規格の開発期間中に数百件のプルリクエスト・イシューが提起され、数千件のバグ修正や編集修正、改善がなされました。さらに、Ecmarkup、Ecmarkdown、Grammarkdownなど多数の支援ツールも開発されました。ES2016では新たにべき乗演算子を導入し、Array.prototype に includes メソッドを追加しました。
ECMAScript 2017ではAsync関数、共有メモリ、Atomicsが導入され、その他小規模な言語・ライブラリアップデートやバグ修正が行われました。Async関数はPromiseを返す関数のための構文を提供し、非同期プログラミング体験を向上させます。共有メモリとAtomicsにより、複数エージェントプログラムが並列CPU上でも確実な実行順序を保ったままアトミック操作で通信できる新しいObject.values、Object.entries、Object.getOwnPropertyDescriptorsなどの静的メソッドも追加されました。
ECMAScript 2018では、asyncイテレータープロトコルとasyncジェネレータによる非同期反復のサポートが導入されました。また、dotAllフラグ、名前付きキャプチャグループ、Unicodeプロパティエスケープ、後方参照といった4つの正規表現新機能、さらにオブジェクトのレスト・スプレッドプロパティも追加されました。
ECMAScript 2019では、配列の平坦化を行うArray.prototype.flat・flatMap、Object.entriesの戻り値を直接新しいオブジェクトへ変換するObject.fromEntries、より適切な名前のString.prototype.trimStartとtrimEndが導入されました（従来の非標準組み込みString.prototype.trimLeft trimRightの代替）。その他、構文・意味論の小規模な更新として、catchパラメータの省略と、JSONと整合するようにU+2028（行区切り）・U+2029（段落区切り）も文字列リテラルで許容されました。さらには、Array.prototype.sortの安定ソートの義務化、JSON.stringifyの常に整形式なUTF-8返却、Function.prototype.toStringのソースまたは標準的プレースホルダ返却要件が明確化されました。
第11版であるECMAScript 2020では、グローバルな正規表現で生成される全マッチオブジェクトを反復できるmatchAll（String）、動的指定子で非同期的にモジュールをインポートするimport()構文、任意精度整数を扱う新プリミティブ型BigInt、短絡しないPromise結合子Promise.allSettled、グローバルthis参照のためのglobalThis、モジュール専用のexport * as ns from 'module'構文、for-in列挙順序の規格化、import.meta（ホストが与えるモジュール情報オブジェクト）、nullish値への対応を強化するnull合体（??）演算子およびオプショナルチェイン（?.）も追加されました。
第12版であるECMAScript 2021では、replaceAll（String）、Promise.any（いずれか1つがfulfilled時に短絡するPromise結合子）、複数エラー同時表現の新しいエラー型AggregateError、論理代入演算子（??=, &&=, ||=）、ガベージコレクション抑止なし参照用WeakRef、クリーンアップ処理管理のFinalizationRegistry、数値リテラルのセパレータ（1_000）、Array.prototype.sortの仕様上より明確な定義などが導入されました。
第13版であるECMAScript 2022では、モジュールのトップレベルでawaitが使用可能になり、新しいクラス要素（パブリック/プライベートのインスタンスフィールドや静的フィールド、プライベートインスタンスメソッド・アクセサ、プライベート静的メソッド・アクセサ）、クラス内のstaticブロック、#x in obj構文、正規表現の/dフラグ（インデックス情報の取得）、Errorオブジェクトのcauseプロパティ、文字列・配列・atメソッド、Object.hasOwnが追加されました。
第14版であるECMAScript 2023では、Array.prototype・TypedArray.prototypeにtoSorted、toReversed、with、findLast、findLastIndexメソッド、Array.prototypeにtoSplicedが追加され、実行可能ECMAScriptファイル支援のため先頭の#!コメント対応、大半のSymbolがWeakコレクションのキーで使用可能となりました。
第15版であるECMAScript 2024では、ArrayBufferやSharedArrayBufferのリサイズ・転送機能、より高度な文字列集合操作に利用できる新しい正規表現/vフラグ、Promise構築のためのPromise.withResolvers、データ集約用のObject.groupBy・Map.groupBy、共有メモリの非同期監視Atomics.waitAsync、文字列のUnicode整形式チェック/修正String.prototype.isWellFormed・toWellFormedが導入されました。
第16版であるECMAScript 2025では、イテレータ操作用の新たなグローバルIteratorと関連静的・プロトタイプメソッド、Setの共通操作追加、JSONモジュールのimportやimport属性宣言構文、正規表現で安全に使えるように文字列をエスケープするRegExp.escape、フラグのインライン切替構文、Promise化を保証するPromise.try、新しい型付き配列Float16Array、およびDataView.prototype.getFloat16・setFloat16・Math.f16roundメソッドが追加されました。
第17版であるECMAScript 2026では、さまざまな大きさの数値を精度落としを抑えて合計するMath.sumPrecise、イテレータ連結のIterator.concat、asyncイテラブルなどから非同期でArrayを構築するArray.fromAsync、エラー判定のError.isError、MapとWeakMap取得時のデフォルト値提供メソッド、Uint8Arrayによる16進・base64文字列変換、JSON.parseのreviverにJSONソース断片を受けるパラメータ、プリミティブ値のJSON.stringify出力を細かく制御するJSON.rawJSONなどが導入されました。
多くの組織を代表する数十名の方々がEcma TC39内で本版および前版の策定に大きく貢献しました。加えて、TC39のECMAScript活動を支える活発なコミュニティも生まれました。このコミュニティは数多くの草案レビュー、バグ報告、実装実験、テストスイートの提供、そしてECMAScriptについて世界中の開発者を教育するなど、多彩な支援を行っています。残念ながら、本作業に貢献してくださった全ての方や組織を特定し感謝を表すことは不可能です。
Allen Wirfs-Brock
ECMA-262, プロジェクトエディター, 第6版
Brian Terlson
ECMA-262, プロジェクトエディター, 第7版〜第10版
Jordan Harband
ECMA-262, プロジェクトエディター, 第10版〜第12版
Kevin Gibbons
ECMA-262, プロジェクトエディター, 第12版〜第17版
Shu-yu Guo
ECMA-262, プロジェクトエディター, 第12版〜第18版
Michael Ficarra
ECMA-262, プロジェクトエディター, 第12版〜第18版
Richard Gibson
ECMA-262, プロジェクトエディター, 第18版
Ron Buckton
ECMA-262, プロジェクトエディター, 第18版
Nicolò Ribaudo
ECMA-262, プロジェクトエディター, 第18版
Linus Groh
ECMA-262, プロジェクトエディター, 第18版
1 適用範囲
この規格は、ECMAScript 2027 汎用プログラミング言語を定義する。
2 適合性
ECMAScript の適合実装は、この仕様に記述されているすべての型、値、オブジェクト、プロパティ、関数、およびプログラム構文と意味論を提供し、サポートしなければならない。
ECMAScript の適合実装は、ソーステキスト入力を、Unicode Standard および ISO/IEC 10646 の最新版に適合するように解釈しなければならない。
異なる人間言語および国で用いられる言語的・文化的慣習に適応する必要があるプログラムを支援するアプリケーションプログラミングインターフェース（API）を提供する ECMAScript の適合実装は、この仕様と互換性のある ECMA-402 の最新版で定義されたインターフェースを実装しなければならない。
ECMAScript の適合実装は、この仕様に記述されているものを超える追加の型、値、オブジェクト、プロパティ、および関数を提供してもよい。特に、ECMAScript の適合実装は、この仕様に記述されているオブジェクトについて、この仕様に記述されていないプロパティおよびそれらの値を提供してもよい。
ECMAScript の適合実装は、この仕様に記述されていないプログラム構文および正規表現構文をサポートしてもよい。特に、ECMAScript の適合実装は、この仕様の節
ECMAScript の適合実装は、節
ECMAScript の適合実装は、実装定義、実装近似、またはホスト定義でないいかなる機能も再定義してはならない。
ECMAScript の適合実装は、別段の указ示がない限り、Normative Optional 節を実装するか否かを選択してよい。ウェブブラウザは一般に、すべての Normative Optional 節を実装することが要求される。（付録
2.1 Normative Optional 節見出しの例
節内容の例。
ECMAScript の適合実装は、Legacy 節を実装しなければならない。ただし、それらが Normative Optional としてもマークされている場合を除く。Legacy 節内で規定される言語機能および振る舞いはすべて、1 つ以上の望ましくない特性を持つ。しかし、既存のアプリケーションで継続して使用されているため、それらをこの仕様から削除することはできない。これらの機能は ECMAScript 言語の中核部分とはみなされない。プログラマは、新しい ECMAScript コードを書く際に、これらの機能や振る舞いを使用したり、その存在を前提としたりすべきではない。
2.2 Legacy 節見出しの例
節内容の例。
2.3 Legacy Normative Optional 節見出しの例
節内容の例。
3 引用規格
以下に示す参照文書は、この文書の適用に不可欠である。日付付き参照については、引用された版のみが適用される。日付なし参照については、参照文書の最新版（あらゆる改訂を含む）が適用される。
Unicode Standard.
https://unicode.org/versions/latest
ISO/IEC 10646, Information Technology — Universal Multiple-Octet Coded Character Set (UCS) および Amendment 1:2005, Amendment 2:2006, Amendment 3:2008, Amendment 4:2008, ならびに追加の改訂および訂正、または後継規格。
ECMA-402, ECMAScript Internationalization API 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 プログラムの計算環境は、この仕様に記述されたオブジェクトやその他の機能だけでなく、特定の環境固有のオブジェクトも提供することが想定されている。それらの説明および振る舞いは、この仕様の範囲外であるが、ECMAScript プログラムからアクセス可能な特定のプロパティや呼び出し可能な関数を提供してもよいことだけが示される。
ECMAScript は元来スクリプト言語として使用されるよう設計されたが、現在では汎用プログラミング言語として広く利用されている。スクリプト言語とは、既存システムの機能を操作、カスタマイズ、および自動化するために用いられるプログラミング言語である。そのようなシステムでは、有用な機能はすでにユーザーインターフェースを通じて利用可能であり、スクリプト言語はその機能をプログラム制御に公開する仕組みである。この意味で、既存システムはオブジェクトおよび機能からなるホスト環境を提供し、それがスクリプト言語の能力を補完する。スクリプト言語は、専門的プログラマと非専門的プログラマの双方による使用を意図している。
ECMAScript は当初、Web スクリプト言語として設計され、ブラウザ内で Web ページに動きを与え、さらに Web ベースのクライアント・サーバアーキテクチャの一部としてサーバ計算を行う仕組みを提供した。現在、ECMAScript は多様なホスト環境に対して中核的なスクリプト機能を提供するために用いられている。したがって、この文書では特定のホスト環境とは切り離して中核言語を規定する。
ECMAScript の利用は単純なスクリプティングを超え、今では多くの異なる環境と規模におけるプログラミング作業の全領域で使用されている。ECMAScript の利用が拡大するにつれて、それが提供する機能と設備も拡張されてきた。ECMAScript は現在、完全な機能を備えた汎用プログラミング言語である。
4.1 Web スクリプティング
ウェブブラウザは ECMAScript のクライアント側計算のためのホスト環境を提供する。これには、たとえばウィンドウ、メニュー、ポップアップ、ダイアログボックス、テキストエリア、アンカー、フレーム、履歴、クッキー、および入出力を表すオブジェクトが含まれる。さらに、ホスト環境は、フォーカスの変更、ページや画像の読み込み、アンロード、エラーや中断、選択、フォーム送信、およびマウス操作といったイベントにスクリプトコードを関連付ける手段を提供する。スクリプトコードは HTML 内に現れ、表示されるページはユーザーインターフェース要素と固定または計算によるテキストおよび画像の組合せとなる。スクリプトコードはユーザー操作に反応し、メインプログラムは不要である。
ウェブサーバは、リクエスト、クライアント、およびファイルを表すオブジェクト、ならびにデータをロックし共有する仕組みを含む、サーバ側計算のための別のホスト環境を提供する。ブラウザ側とサーバ側のスクリプティングを組み合わせることで、Web ベースのアプリケーション向けにカスタマイズされたユーザーインターフェースを提供しつつ、計算をクライアントとサーバの間で分散することが可能になる。
ECMAScript をサポートする各ウェブブラウザおよびサーバは、それぞれ独自のホスト環境を提供し、ECMAScript 実行環境を完成させる。
4.2 ホストと実装
ECMAScript をホスト環境へ統合することを助けるために、この仕様は、特定の機能（たとえば抽象操作）の定義を、この仕様の外部の情報源に、全体または一部について委ねている。編集上、この仕様では以下の種類の委譲を区別する。
implementation とは、付録
implementation-defined 機能とは、追加の限定なしにその定義を外部情報源に委ねる機能である。この仕様は特定の振る舞いを推奨せず、適合実装はこの仕様が課す制約の範囲内で自由に任意の振る舞いを選択できる。
implementation-approximated 機能とは、理想的な振る舞いを推奨しつつ、その定義を外部情報源に委ねる機能である。適合実装はこの仕様が課す制約の範囲内で任意の振る舞いを選択できるが、理想に近づくよう努めることが推奨される。Math.exp
host とは、付録
host hook とは、外部情報源によって全体または一部が定義される抽象操作である。すべての
- それは
normal completion またはthrow completion のいずれかを返さなければならない。
host-defined 機能とは、追加の限定なしにその定義を外部情報源に委ね、かつ付録
host environment とは、すべての
この仕様は、常に最も具体的な用語を使うという編集上の慣例に従う。たとえば、ある機能が
4.3 ECMAScript の概要
以下は ECMAScript の非形式的な概要であり、言語のすべての部分が記述されているわけではない。この概要は標準本文の一部ではない。
ECMAScript はオブジェクトベースである。すなわち、基本言語機能およびホスト機能はオブジェクトによって提供され、ECMAScript プログラムは相互に通信するオブジェクト群から成る。ECMAScript において、object は 0 個以上の property の集合であり、各 property はその利用方法を決定する attribute を持つ。たとえば、ある property の Writable attribute が
ECMAScript は、ECMAScript 実体の定義を補完する built-in object の集合を定義する。これらの built-in object には、global object、Object、Function、Boolean、Symbol、およびさまざまな Error object を含む言語の実行時意味論に不可欠な object、Math、Number、および Date を含む数値を表現および操作する object、テキスト処理 object である String と RegExp、Array と、すべての要素が特定の数値データ表現を持つ 9 種類の Typed Array を含むインデックス付き値コレクションを表す object、Map および Set object を含むキー付きコレクション、JSON object、ArrayBuffer、SharedArrayBuffer、および DataView を含む構造化データを支援する object、generator function および Promise object を含む制御抽象を支援する object、ならびに Proxy と Reflect を含む reflection object がある。
ECMAScript はまた、組込み operator の集合も定義する。ECMAScript の operator には、さまざまな単項演算、乗法演算子、加法演算子、ビット単位シフト演算子、関係演算子、等値演算子、二項ビット演算子、二項論理演算子、代入演算子、およびコンマ演算子が含まれる。
大規模な ECMAScript プログラムは、プログラムを複数の文および宣言の列に分割できるようにする module によって支えられる。各 module は、他の module から提供される必要がある使用宣言と、自身の宣言のうち他の module から利用可能なものを明示的に識別する。
ECMAScript の構文は意図的に Java の構文に似せてある。ECMAScript の構文は、使いやすいスクリプト言語として機能できるように緩やかにされている。たとえば、変数には宣言は不要であり、型は property に関連付けられず、定義された function は、その呼出しより前にテキスト上で宣言が現れる必要もない。
4.3.1 オブジェクト
ECMAScript にはクラス定義のための構文が含まれているが、ECMAScript の object は、C++、Smalltalk、Java におけるそれらのように、本質的にクラスベースではない。代わりに object は、リテラル記法や、object を生成した後で property に初期値を代入してその全部または一部を初期化するコードを実行する new Date(2009, 11) は新しい Date object を生成する。new を使わずに Date() は object ではなく現在の日付と時刻の文字列表現を生成する。
クラスベースのオブジェクト指向言語では、一般に状態はインスタンスが保持し、メソッドはクラスが保持し、継承されるのは構造と振る舞いのみである。ECMAScript では、状態とメソッドは object が保持し、構造、振る舞い、および状態のすべてが継承される。
自身の prototype が持つ特定の property を直接含まないすべての object は、その property とその値を共有する。図 1 はこれを示している。
CF は new 式を用いて 5 個の object が生成されている：cf1, cf2, cf3, cf4, および cf5。これらの各 object は
ほとんどのクラスベース object 言語とは異なり、property は値を代入することによって動的に object に追加できる。すなわち
ECMAScript の object は本質的にはクラスベースではないが、
4.3.2 ECMAScript の strict 変種
ECMAScript 言語は、この言語の利用者の中に、言語で利用可能な機能の一部の使用を制限したいと望む者がいる可能性を認識している。彼らは、安全性の観点から、エラーを起こしやすいとみなす機能を避けるため、強化されたエラーチェックを得るため、あるいはその他自身が選ぶ理由のためにそうするかもしれない。この可能性を支援するために、ECMAScript は言語の strict 変種を定義する。言語の strict 変種は、通常の ECMAScript 言語における特定の構文的・意味論的機能の一部を除外し、一部の機能の詳細な意味論を変更する。また strict 変種は、言語の非 strict 形式ではエラーと規定されていない状況においても、エラー例外を投げることで報告しなければならない追加のエラー条件を規定する。
ECMAScript の strict 変種は、一般にこの言語の strict mode と呼ばれる。ECMAScript の strict mode の選択および strict mode の構文と意味論の使用は、
この仕様に適合するためには、ECMAScript 実装は、この仕様で定義される完全な無制限 ECMAScript 言語と、ECMAScript 言語の strict 変種の両方を実装しなければならない。さらに、実装は、無制限および strict mode のソーステキスト単位を単一の複合プログラムに組み合わせることをサポートしなければならない。
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
object は property の集合であり、単一の prototype object を持つ。prototype は
4.4.7 constructor
object を生成し初期化する
4.4.8 prototype
他の object のために共有 property を提供する object
constructor.prototype によって参照でき、object の prototype に追加された property は、継承を通じて、その prototype を共有するすべての object によって共有される。あるいは、新しい object は、組込み関数 Object.create を用いて、明示的に指定された prototype を持つように生成してもよい。
4.4.9 ordinary object
すべての object がサポートしなければならない本質的内部メソッドについて、既定の振る舞いを持つ object
4.4.10 exotic object
1 つ以上の本質的内部メソッドについて既定の振る舞いを持たない object
4.4.11 standard object
意味論がこの仕様によって定義される object
4.4.12 built-in object
ECMAScript 実装によって規定され、提供される object
標準 built-in object はこの仕様で定義される。ECMAScript 実装は、追加の種類の built-in object を規定し提供してもよい。
4.4.13 undefined value
変数に値が代入されていないときに使用される primitive value
4.4.14 Undefined type
唯一の値が
4.4.15 null value
いかなる object 値も意図的に存在しないことを表す primitive value
4.4.16 Null type
唯一の値が
4.4.17 Boolean value
Boolean value は
4.4.18 Boolean type
primitive value
4.4.19 Boolean object
標準 built-in Boolean
Boolean object は new 式で Boolean
4.4.20 String value
0 個以上の 16 ビット符号なし整数値からなる有限順序列である primitive value
String value は
4.4.21 String type
可能なすべての String value の集合
4.4.22 String object
標準 built-in String
String object は new 式で String
4.4.23 Number value
倍精度 64 ビット二進形式
Number value は
4.4.24 Number type
4.4.25 Number object
標準 built-in Number
Number object は new 式で Number
4.4.26 Infinity
正の無限 Number value である Number value
4.4.27 NaN
4.4.28 BigInt value
任意精度整数値に対応する primitive value
4.4.29 BigInt type
可能なすべての BigInt value の集合
4.4.30 BigInt object
標準 built-in BigInt
4.4.31 Symbol value
一意で、String ではない Object
4.4.32 Symbol type
可能なすべての Symbol value の集合
4.4.33 Symbol object
標準 built-in Symbol
4.4.34 function
サブルーチンとして呼び出されうる
function は、その property に加えて、呼び出されたときの振る舞いを決定する実行可能コードおよび状態を含む。function のコードは ECMAScript で書かれていてもいなくてもよい。
4.4.35 built-in function
function である built-in object
built-in function の例には parseInt や Math.exp がある。
4.4.36 built-in constructor
built-in Object や Function がある。
4.4.37 property
key（String value または Symbol value のいずれか）と値を関連付ける object の一部
property の形式に応じて、値はデータ値（primitive value、object、または
4.4.38 method
property の値である function
function が object の method として呼び出されるとき、その object はその function に
4.4.39 built-in method
built-in function である method
標準 built-in method はこの仕様で定義される。
4.4.40 attribute
property の何らかの特性を定義する内部値
4.4.41 own property
その object に直接含まれる property
4.4.42 inherited property
own property ではないが、その object の prototype の property（own または inherited のいずれか）である object の property
4.5 この仕様の構成
この仕様の残りは以下のように構成される。
節
節
節
節
節
5 記法規約
5.1 構文文法と字句文法
5.1.1 文脈自由文法
文脈自由文法は複数の production から成る。各 production は、その left-hand side として nonterminal と呼ばれる抽象記号を持ち、その right-hand side として 0 個以上の nonterminal 記号および terminal 記号の列を持つ。各文法において、terminal 記号は指定されたアルファベットから取られる。
chain production とは、その右辺に terminal 記号が 0 個以上付随し、かつちょうど 1 個の nonterminal 記号を持つ production である。
goal symbol と呼ばれる、単一の特別な nonterminal から成る文から出発して、与えられた文脈自由文法は 1 つの language、すなわち、その列の中の任意の nonterminal を、その nonterminal を左辺とする production の右辺で繰り返し置き換えることにより得られる、terminal 記号列の（おそらく無限の）集合を規定する。
5.1.2 字句文法と RegExp 文法
ECMAScript の lexical grammar は節
空白およびコメント以外の入力要素は、ECMAScript の構文文法の terminal 記号を成し、ECMAScript の token と呼ばれる。これらの token は、ECMAScript 言語の予約語、識別子、リテラル、および区切り記号である。さらに、行終端子は token とはみなされないが、入力要素ストリームの一部となり、自動セミコロン挿入（/*…*/ 形式のコメントで、複数行にまたがるかどうかを問わない）も、行終端子を含まなければ同様に単に破棄される。しかし、
ECMAScript の RegExp grammar は
字句文法および RegExp 文法の production は、区切り記号として 2 つのコロン “::” を持つことで区別される。字句文法と RegExp 文法は一部の production を共有する。
5.1.3 数値文字列文法
numeric string grammar は
numeric string grammar の production は、句読点として 3 つのコロン “:::” を持つことで区別され、ソーステキストの解析には決して用いられない。
5.1.4 構文文法
ECMAScript の syntactic grammar は、節
コードポイントのストリームが ECMAScript の
解析が成功すると、parse tree、すなわち各 node が Parse Node である根付き木構造が構築される。各 Parse Node は文法中の記号の instance であり、その記号から導出できるソーステキストの範囲を表す。ソーステキスト全体を表す parse tree の根 node は、解析の
新しい Parse Node は parser の各呼出しごとに生成され、たとえ同一のソーステキストであっても解析間で再利用されることはない。Parse Node は、同じソーステキスト範囲を表し、同じ文法記号の instance であり、かつ同じ parser 呼出しから生じた場合に限り、同じ Parse Node とみなされる。
同じ String を複数回解析すると、異なる Parse Node が生じる。たとえば、次を考える。
let str = "1 + 1;";
eval(str);
eval(str);eval の各呼出しは、str の値を
構文文法の production は、句読点としてただ 1 つのコロン “:” を持つことで区別される。
節
場合によっては、曖昧さを避けるために、構文文法は、有効な ECMAScript
- もともと p に一致した token 列は、
goal symbol として n を用いて再度解析される。n が文法パラメータを取るなら、p が最初に解析されたときと同じ値に設定される。 - その token 列が、余り token を残さず、単一の n の instance として解析できる場合、次が成り立つ。
- その n の instance（与えられた p に対して一意な Parse Node）を、「p によって covered される n」と呼ぶ。
- n およびその導出 production に対するすべての Early Error rule は、p によって covered される n にも適用される。
- それ以外の場合（解析に失敗した場合）、それは early Syntax Error である。
5.1.5 文法記法
5.1.5.1 終端記号
ECMAScript 文法では、一部の terminal 記号が fixed-width フォントで示される。これらは、ソーステキスト中に書かれたとおり正確に現れなければならない。この方法で指定されるすべての terminal 記号コードポイントは、他の Unicode 範囲の似た見た目のコードポイントではなく、Basic Latin ブロックの適切な Unicode コードポイントとして理解される。terminal 記号中のコードポイントは、\
terminal 記号が個々の Unicode コードポイントである文法（すなわち、字句文法、RegExp 文法、および numeric string grammar）では、production 中に現れる複数の fixed-width コードポイントの連続列は、その同じコードポイント列を単独の terminal 記号として書いたものの単純な略記である。
たとえば、production:
は、次の略記である。
これに対して、構文文法では、fixed-width コードポイントの連続列は単一の terminal 記号である。
terminal 記号にはさらに 2 つの形式がある。
- 字句文法および RegExp 文法では、通常の印字表現を持たない Unicode コードポイントは、代わりに "<ABBREV>" の形式で示される。ここで "ABBREV" はそのコードポイントまたはコードポイント集合のニーモニックである。これらの形式は
Unicode 書式制御文字 、White Space 、およびLine Terminator で定義される。 - 構文文法では、特定の terminal 記号（たとえば
IdentifierName やRegularExpressionLiteral ）はイタリック体で示される。これは、それらが字句文法における同名の nonterminal を参照するためである。
5.1.5.2 非終端記号と生成規則
nonterminal 記号は italic 体で示される。nonterminal の定義（“production” とも呼ばれる）は、定義される nonterminal の名前に続いて 1 個以上のコロンを付けることで導入される。（コロンの数は、その production がどの文法に属するかを示す。）その後、nonterminal の 1 つ以上の代替 right-hand side が続く行に現れる。たとえば、構文定義:
は、nonterminal while、左括弧 token、
は、
5.1.5.3 オプション記号
terminal または nonterminal の後ろに現れることがある下付き接尾辞 “opt” は、省略可能な記号を示す。省略可能記号を含む選択肢は、実際には 2 つの right-hand side、すなわち省略可能要素を省いたものと含むものを指定している。これは次を意味する。
は、次の便利な略記である。
また、次も同様である。
は、次の便利な略記である。
これはさらに次の略記である。
したがって、この例では nonterminal
5.1.5.4 文法パラメータ
production は、定義される nonterminal 記号の接尾辞として現れる “[parameters]” 形式の下付き注記によってパラメータ化されてよい。“parameters” は単一の名前でも、コンマ区切りの名前列でもよい。パラメータ化された production は、パラメータ化された nonterminal 記号に、パラメータ名の前にアンダースコアを付けて追加した、パラメータ名のすべての組合せを定義する production 群の略記である。これは次を意味する。
は、次の便利な略記である。
また、次も同様である。
は、次の略記である。
複数パラメータは組合せ的な数の production を生み、そのすべてが完全な文法内で実際に参照されるとは限らない。
production の right-hand side 上の nonterminal 参照もパラメータ化できる。たとえば、
は、次と等価である。
また、
は、次と等価である。
nonterminal 参照は、パラメータリストと “opt” 接尾辞の両方を持ってよい。たとえば、
は、次の略記である。
right-hand side の nonterminal 参照において、パラメータ名の前に “?” を付けると、そのパラメータ値は、現在の production の left-hand side 記号への参照におけるそのパラメータ名の有無に依存する。たとえば、
は、次の略記である。
right-hand side の選択肢の前に “[+parameter]” が付く場合、その選択肢は、その production の nonterminal 記号を参照する際に指定された parameter が用いられた場合にのみ利用可能である。right-hand side の選択肢の前に “[~parameter]” が付く場合、その選択肢は、その production の nonterminal 記号を参照する際に、その parameter が 用いられなかった 場合にのみ利用可能である。これは次を意味する。
は、次の略記である。
また、次も同様である。
は、次の略記である。
5.1.5.5 one of
文法定義において、コロンの後に “one of” という語が続く場合、それは次行または次行群にある各 terminal 記号が代替定義であることを示す。たとえば、ECMAScript の字句文法には次の production が含まれる。
これは単に次の便利な略記である。
5.1.5.6 [empty]
production の right-hand side として “[empty]” という句が現れる場合、それはその production の right-hand side に terminal も nonterminal も含まれないことを示す。
5.1.5.7 先読み制約
production の right-hand side に “[lookahead = seq]” という句が現れる場合、それは、直後の入力 token 列の接頭辞が token 列 seq である場合にのみ、その production を使用できることを示す。同様に、“[lookahead ∈ set]” で、set が有限非空の token 列集合である場合、その production は、set のいずれかの要素が直後の token 列の接頭辞である場合にのみ使用できる。便宜上、その集合は nonterminal として書かれてもよく、その場合それは、その nonterminal が展開しうるすべての token 列の集合を表す。その nonterminal が無限に多くの異なる token 列へ展開しうる場合、それは編集上の誤りとみなされる。
これらの条件は否定されてもよい。“[lookahead ≠ seq]” は、包含する production が、seq が直後の入力 token 列の接頭辞 ではない 場合にのみ使用できることを示し、“[lookahead ∉ set]” は、set のどの要素も直後の token 列の接頭辞 ではない 場合にのみ、その production を使用できることを示す。
例として、次の定義が与えられているとする。
このとき、定義:
は、文字 n に続いて最初の 1 文字が偶数である 1 個以上の 10 進数字が続くもの、または別の 10 進数字が後続しない単一の 10 進数字、のいずれかに一致する。
これらの句が構文文法で用いられる場合、後の位置でどの字句
5.1.5.8 [no LineTerminator here]
構文文法の production の right-hand side に “[no
は、スクリプト中で throw token と
5.1.5.9 but not
production の right-hand side は、“but not” という句を用い、その後に除外される展開を示すことで、特定の展開が許されないことを指定してよい。たとえば、production:
は、nonterminal
5.1.5.10 記述句
最後に、いくつかの nonterminal 記号は、すべての選択肢を列挙するのが実際的でない場合に、サンセリフ体の記述句によって説明される。
5.2 アルゴリズム規約
この仕様では、アルゴリズムの手順を指定するために番号付きリストをしばしば用いる。これらのアルゴリズムは、ECMAScript 言語構成要素に要求される意味論を正確に規定するために用いられる。これらのアルゴリズムは、特定の実装技法の使用を示唆することを意図していない。実際には、ある機能を実装するために、より効率的なアルゴリズムが利用可能な場合がある。
アルゴリズムは、その位置で渡された引数を参照するためにアルゴリズム手順内で用いることができる別名の、順序付きかつコンマ区切りの列によって、明示的にパラメータ化されてよい。省略可能パラメータは、角括弧で囲むことで表される（[ , name ]）が、アルゴリズム手順内では必須パラメータと何ら異ならない。可変長パラメータはパラメータリストの末尾に現れてよく、先頭の省略記号（, ...name）によって示される。可変長パラメータは、必須および省略可能パラメータの後に与えられたすべての引数を
アルゴリズム手順は、順次的な下位手順に分割されてよい。下位手順はインデントされ、さらにその内部でより深い下位手順へ分割されてよい。アウトライン番号規約により、下位手順の第 1 レベルは小文字アルファベット、第 2 レベルは小文字ローマ数字で識別される。3 レベルを超える場合には、これらの規則が繰り返され、第 4 レベルでは数値ラベルが用いられる。たとえば、
- 最上位手順
- 下位手順。
- 下位手順。
- 下下位手順。
- 下下下位手順
- 下下下下位手順
- 下下下下下位手順
- 下下下下位手順
- 下下下位手順
- 下下位手順。
手順または下位手順は、その下位手順の適用条件となる “if” 述語として書かれてよい。この場合、その述語が真であるときにのみ下位手順が適用される。手順または下位手順が “else” という語で始まる場合、それは同じレベルにある直前の “if” 述語手順の否定である述語となる。
手順は “For each” または “Repeat” で始まり、その下位手順の反復適用を指定してよい。
“Assert:” で始まる手順は、そのアルゴリズムの不変条件を表明する。そのような表明は、そうでなければ暗黙となるアルゴリズム上の不変条件を明示するために用いられる。同様に、“NOTE:” で始まる手順は、近接する手順に関連する文脈を提供する。
アルゴリズム手順は、“Let x be someValue” という形式を用いて任意の値に対する名前付き別名を宣言してよい。これらの別名は参照に似ており、x と someValue の両方が同じ基底データを参照し、どちらへの変更も双方から見える。こうした参照的挙動を避けたいアルゴリズム手順は、右辺のコピーを明示的に作るべきである。“Let x be a copy of someValue” は someValue の浅いコピーを生成する。
一度宣言された別名は、それ以降の任意の手順で参照してよく、別名の宣言より前の手順から参照してはならない。別名は “Set x to someOtherValue” という形式で変更してよい。
5.2.1 評価順序
複雑な式がアルゴリズム手順に現れる場合、それらは左から右へ、内側から外側への順に評価されるものと理解される。たとえば、手順
- Return A(B(), C.[[D]]) + E(F()).
は、次と等価である。
- Let tmp1 be B().
- Let tmp2 be C.[[D]].
- Let tmp3 be A(tmp1, tmp2).
- Let tmp4 be F().
- Let tmp5 be E(tmp4).
- Let tmp6 be tmp3 + tmp5.
- Return tmp6.
ここで、各種 tmpN 別名は一時的なものであり、これらの手順内でのみ可視である。
5.2.2 抽象操作
この仕様の複数箇所での利用を容易にするために、一部のアルゴリズムは、abstract operation と呼ばれ、名前付きかつパラメータ化された関数形式で書かれる。これにより、他のアルゴリズム内から名前で参照できる。abstract operation は通常、OperationName(arg1, arg2) のような関数適用スタイルで参照される。一部の abstract operation は、クラス様の仕様抽象の多相ディスパッチされるメソッドとして扱われる。そのようなメソッド様 abstract operation は通常、someValue.OperationName(arg1, arg2) のようなメソッド適用スタイルで参照される。
5.2.3 構文指向操作
syntax-directed operation とは、その定義が ECMAScript 文法のいずれかの 1 つ以上の production に関連付けられたアルゴリズム群から成る名前付き操作である。複数の代替定義を持つ production には、通常、各代替ごとに別個のアルゴリズムがある。アルゴリズムが文法 production に関連付けられている場合、それはその production 代替の terminal 記号および nonterminal 記号を、あたかもアルゴリズムのパラメータであるかのように参照してよい。このように用いられるとき、nonterminal 記号は、ソーステキスト解析時に一致した実際の代替定義を参照する。文法 production、またはそれから導出された
アルゴリズムが production の代替に関連付けられている場合、その代替は通常、いかなる “[ ]” 文法注釈も付けずに示される。そのような注釈は代替の構文的認識にのみ影響し、代替に関連付けられた意味論には影響しない。
syntax-directed operation は、parse node と、任意でその他のパラメータを用いて、以下のアルゴリズムの手順
- Let status be SyntaxDirectedOperation of
SomeNonTerminal . - Let someParseNode be the parse of some source text.
- Perform SyntaxDirectedOperation of someParseNode.
- Perform SyntaxDirectedOperation of someParseNode with argument
"value" .
明示的に別段の指定がない限り、すべての
しかし
Runtime Semantics:
- Return
Evaluation ofStatementList .
5.2.4 実行時意味論
実行時に呼び出されなければならない意味論を規定するアルゴリズムは、runtime semantics と呼ばれる。runtime semantics は、
5.2.4.1 Completion ( completionRecord )
The
Assert : completionRecord is aCompletion Record .- Return completionRecord.
5.2.4.2 Throw
アルゴリズム手順において、"throw" という語は
- If result.[[Error]] is not
none , throw result.[[Error]].
は、次と等価である。
- If result.[[Error]] is not
none , returnThrowCompletion (result.[[Error]]).
特定の型の例外を投げるよう述べるアルゴリズム手順は、その型の例外を構築して投げる。たとえば、
- Throw a
TypeError exception.
は、次と等価である。
- Return
ThrowCompletion (a newly createdTypeError object).
5.2.4.3 Completion Record を展開するための略記
接頭辞 ? および ! は、? は ! は
- Let result be ? record.
は、次と等価である。
Assert : record is aCompletion Record .- If record is an
abrupt completion , return record. - Let result be record.[[Value]].
同様に、手順
- Let result be ! record.
は、次と等価である。
Assert : record is anormal completion .- Let result be record.[[Value]].
? または ! が他の文脈で用いられる場合、まず
- Perform AO(? Other()).
は、次のように書き換えられる。
- Let tmp1 be Other().
- Let tmp2 be ? tmp1.
- Perform AO(tmp2).
これはさらに次のように展開される。
- Let tmp1 be Other().
Assert : tmp1 is aCompletion Record .- If tmp1 is an
abrupt completion , return tmp1. - Let tmp2 be tmp1.[[Value]].
- Perform AO(tmp2).
5.2.4.4 暗黙の Normal Completion
Completion 、NormalCompletion 、ThrowCompletion 、またはReturnCompletion を適用した結果が直接返される場合Completion Record を構築した結果が直接返される場合
そのような
- Return
true .
は、次のいずれとも同じ意味である。
- Return
NormalCompletion (true ).
または
- Let completion be
NormalCompletion (true ). - Return
Completion (completion).
または
- Return
Completion Record { [[Type]]:normal , [[Value]]:true , [[Target]]:empty }.
? 略記の展開
- Return ? completion.
次の例は、その手順において注記されることなく
- Let completion be
NormalCompletion (true ). - Return completion.
5.2.5 静的意味論
文脈自由文法は、入力要素ストリームが評価可能な有効な ECMAScript
Static Semantic Rule には名前があり、通常はアルゴリズムを用いて定義される。名前付き Static Semantic Rule は文法 production に関連付けられ、複数の代替定義を持つ production では、通常、適用可能な各名前付き 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: 任意の整数を 1 対 1 に対応させて表す
ECMAScript 言語値 。
この仕様の言語では、数値は下付き接尾辞を用いて異なる数値種別の間で区別される。下付き 𝔽 は Number を指し、下付き ℤ は BigInt を指す。下付き接尾辞のない数値は
一般に、この仕様が、たとえば “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 は、a から b までの inclusive interval とも呼ばれ、同じ数値型の値 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 同一性
この仕様では、仕様値と
この仕様の観点からは、“is” という語は 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 型は、0 個以上の 16 ビット符号なし整数値（“elements”）の順序付き列すべての集合であり、その最大長は 253 - 1 要素である。String 型は一般に、実行中の ECMAScript プログラムにおけるテキストデータを表現するために用いられ、その場合、String 内の各要素は UTF-16 コードユニット値として扱われる。各要素は、その列の中の位置を占めるものとみなされる。これらの位置には非負整数で添字が付けられる。最初の要素（存在する場合）は添字 0 にあり、次の要素（存在する場合）は添字 1 にあり、以下同様である。String の長さは、その中に含まれる要素（すなわち 16 ビット値）の個数である。空文字列の長さは 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 でもないコードユニットは、同じ値を持つコードポイントとして解釈される。 -
最初のコードユニット c1 が
leading surrogate で、2 番目のコードユニット c2 がtrailing surrogate である 2 つのコードユニット列は、surrogate pair であり、値 (c1 - 0xD800) × 0x400 + (c2 - 0xDC00) + 0x10000 を持つコードポイントとして解釈される。（11.1.3 を参照） -
leading surrogate またはtrailing surrogate であるが、surrogate pair の一部ではないコードユニットは、同じ値を持つコードポイントとして解釈される。
関数 String.prototype.normalize（String.prototype.localeCompare（
この設計の根拠は、String の実装を可能な限り単純かつ高性能に保つことにあった。ECMAScript のソーステキストが Normalized Form C であれば、Unicode エスケープシーケンスを含まない限り、文字列リテラルも正規化されることが保証される。
この仕様において、“A, B, ... の string-concatenation” という句（各引数は String 値、コードユニット、またはコードユニット列である）は、各引数のコードユニットを（順に）連結したコードユニット列を持つ String 値を表す。
“inclusiveStart から exclusiveEnd までの str の substring” という句（str は String 値またはコードユニット列であり、inclusiveStart および exclusiveEnd は整数である）は、str のうち添字 inclusiveStart から始まり、添字 exclusiveEnd の直前で終わる連続したコードユニットから成る String 値を表す（inclusiveStart = exclusiveEnd のときは空文字列である）。“to” の接尾辞が省略された場合、str の長さが exclusiveEnd の値として用いられる。
“the ASCII word characters” という句は、Unicode Basic Latin ブロック内のすべての英字と数字、および U+005F（LOW LINE）のみから成る次の String 値を表す。
歴史的な理由により、これはさまざまなアルゴリズムにおいて意味を持つ。
6.1.4.1 StringIndexOf ( string, searchValue, fromIndex )
The
- len を string の長さとする。
- searchValue が空文字列であり、かつ fromIndex ≤ len なら、fromIndex を返す。
- searchLen を searchValue の長さとする。
- fromIndex ≤ i ≤ len - searchLen を満たす各整数 i について、昇順で次を行う
- candidate を string の i から i + searchLen までの
substring とする。 - candidate が searchValue なら、i を返す。
- candidate を string の i から i + searchLen までの
not-found を返す。
searchValue が空文字列であり、かつ fromIndex ≤ string の長さである場合、このアルゴリズムは fromIndex を返す。空文字列は、最後のコードユニットの後を含め、文字列内のあらゆる位置で見つかるものとして実質的に扱われる。
このアルゴリズムは、fromIndex + searchValue の長さ > string の長さ である場合、常に
6.1.4.2 StringLastIndexOf ( string, searchValue, fromIndex )
The
searchValue が空文字列である場合、このアルゴリズムは fromIndex を返す。空文字列は、最後のコードユニットの後を含め、文字列内のあらゆる位置で見つかるものとして実質的に扱われる。
6.1.5 Symbol 型
Symbol 型は、Object のプロパティのキーとして使用できるすべての非 String 値の集合である（
各 Symbol は一意であり、不変である。
各 Symbol は不変の [[Description]] 内部スロットを持ち、その値は String または
6.1.5.1 Well-Known Symbol
well-known symbol は、この仕様のアルゴリズムによって明示的に参照される組込み Symbol 値である。これらは通常、その値が仕様アルゴリズムの拡張ポイントとして機能するプロパティのキーとして使用される。特に指定がない限り、well-known symbol 値はすべての
この仕様では、well-known symbol は、
%Symbol.name% を使用する。特に、次の名前が使用されていた: @@asyncIterator, @@hasInstance, @@isConcatSpreadable, @@| 仕様名 | [[Description]] | 値と目的 |
|---|---|---|
| %Symbol.asyncIterator% |
|
オブジェクトの既定の for-await-of 文の意味論によって呼び出される。
|
| %Symbol.hasInstance% |
|
instanceof 演算子の意味論によって呼び出される。
|
| %Symbol.isConcatSpreadable% |
|
Array.prototype.concat |
| %Symbol.iterator% |
|
オブジェクトの既定の |
| %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% |
|
オブジェクトを対応する primitive 値へ変換するメソッド。 |
| %Symbol.toStringTag% |
|
オブジェクトの既定の文字列表現の生成に用いられる String 値プロパティ。組込みメソッド Object.prototype.toString |
| %Symbol.unscopables% |
|
その own および継承プロパティ名が、関連付けられたオブジェクトの with 環境バインディングから除外されるプロパティ名である object 値プロパティ。
|
6.1.6 数値型
ECMAScript には 2 つの組込み数値型がある: Number と BigInt。以下の抽象操作は、これらの数値型に対して定義される。“Result” 列には戻り値の型が示され、さらにその操作の一部の呼出しにおいて
数値型は一般に、精度の喪失または切り捨てなしには相互変換できないため、ECMAScript 言語はこれらの型の間で暗黙変換を提供しない。プログラマは、別の型を必要とする関数を呼び出す際には、Number および BigInt 関数を明示的に呼び出して型変換しなければならない。
ECMAScript の初版およびその後の各版は、特定の演算子について、精度を失うか切り捨てる可能性のある暗黙の数値変換を提供してきた。これらのレガシーな暗黙変換は後方互換性のために維持されているが、BigInt には提供されない。これは、プログラマの誤りの機会を最小化し、将来の版において一般化された value types の選択肢を残すためである。
6.1.6.1 Number 型
Number 型は、正確に 18,437,736,874,454,810,627 個（すなわち NaN によって生成されることに注意。）一部の実装では、外部コードがさまざまな NaN 値の違いを検出できる場合があるが、そのような挙動は
これ以外に、+Infinity（または単に Infinity）および -Infinity によって生成されることに注意。）
残りの 18,437,736,874,454,810,624 個（すなわち
+0（または単に 0）および -0 によって生成されることに注意。）
18,437,736,874,454,810,622 個（すなわち
そのうち 18,428,729,675,200,069,632 個（すなわち
ここで s は 1 または -1、m は 252（inclusive）から 253（exclusive）までの区間にある整数、e は -1074 から 971 までの包含区間にある整数である。
残りの 9,007,199,254,740,990 個（すなわち
ここで s は 1 または -1、m は 0（exclusive）から 252（exclusive）までの区間にある整数、e は -1074 である。
大きさが 253 以下のすべての正負整数は Number 型で表現可能であることに注意。整数 0 は Number 型において 2 つの表現を持つ:
有限数は、それが非ゼロであり、（上に示した 2 つの形式のいずれかで）それを表すために用いられる整数 m が奇数である場合、odd significand を持つ。それ以外の場合、それは even significand を持つ。
この仕様において、“x の Number value for” という句は、x が正確な実数の数学的量（π のような無理数である場合もある）を表すとき、次の方法で選ばれた Number 値を意味する。Number 型の有限値すべての集合を考え、そこから
+∞ の Number value は
一部の ECMAScript 演算子は、
6.1.6.1.1 Number::unaryMinus ( x )
The
- x が
NaN なら、NaN を返す。 - x の negation を返す。すなわち、同じ大きさで符号が反対の Number を計算する。
6.1.6.1.2 Number::bitwiseNOT ( x )
The
- oldValue を !
ToInt32 (x) とする。 - oldValue の bitwise complement を返す。結果の数学的値は 32 ビット 2 の補数ビット列として正確に表現可能である。
6.1.6.1.3 Number::exponentiate ( base, exponent )
The
- exponent が
NaN なら、NaN を返す。 - exponent が
+0 𝔽 または-0 𝔽 のいずれかであるなら、1 𝔽 を返す。 - base が
NaN なら、NaN を返す。 - base が
+∞ 𝔽 なら、- exponent >
+0 𝔽 なら、+∞ 𝔽 を返す。 +0 𝔽 を返す。
- exponent >
- base が
-∞ 𝔽 なら、- exponent >
+0 𝔽 なら、- exponent が奇数の
integral Number なら、-∞ 𝔽 を返す。 +∞ 𝔽 を返す。
- exponent が奇数の
- exponent が奇数の
integral Number なら、-0 𝔽 を返す。 +0 𝔽 を返す。
- exponent >
- base が
+0 𝔽 なら、- exponent >
+0 𝔽 なら、+0 𝔽 を返す。 +∞ 𝔽 を返す。
- exponent >
- base が
-0 𝔽 なら、- exponent >
+0 𝔽 なら、- exponent が奇数の
integral Number なら、-0 𝔽 を返す。 +0 𝔽 を返す。
- exponent が奇数の
- exponent が奇数の
integral Number なら、-∞ 𝔽 を返す。 +∞ 𝔽 を返す。
- exponent >
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
有限精度の乗算は可換であるが、常に結合的とは限らない。
6.1.6.1.5 Number::divide ( x, y )
The
- 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 ( n, d )
The
- n が
NaN または d がNaN なら、NaN を返す。 - n が
+∞ 𝔽 または-∞ 𝔽 のいずれかなら、NaN を返す。 - d が
+∞ 𝔽 または-∞ 𝔽 のいずれかなら、n を返す。 - d が
+0 𝔽 または-0 𝔽 のいずれかなら、NaN を返す。 - n が
+0 𝔽 または-0 𝔽 のいずれかなら、n を返す。 Assert : n および d はfinite かつ非ゼロである。- quotient を
ℝ (n) /ℝ (d) とする。 - q を
truncate (quotient) とする。 - r を
ℝ (n) - (ℝ (d) × q) とする。 - r = 0 かつ n <
-0 𝔽 なら、-0 𝔽 を返す。 𝔽 (r) を返す。
C および C++ では、remainder 演算子は整数オペランドのみを受け付ける。ECMAScript では浮動小数点オペランドも受け付ける。
% 演算子によって計算される浮動小数点 remainder 演算の結果は、% を、Java の 6.1.6.1.7 Number::add ( x, y )
The
有限精度の加算は可換であるが、常に結合的とは限らない。
6.1.6.1.8 Number::subtract ( x, y )
The
Number::add (x,Number::unaryMinus (y)) を返す。
x - y が x + (-y) と同じ結果を生成することは常に成り立つ。
6.1.6.1.9 Number::leftShift ( x, y )
The
6.1.6.1.10 Number::signedRightShift ( x, y )
The
6.1.6.1.11 Number::unsignedRightShift ( x, y )
The
6.1.6.1.12 Number::lessThan ( x, y )
The
6.1.6.1.13 Number::equal ( x, y )
The
- 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
- 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
- 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 &, ^, or |), x (a Number), and y (a Number) and returns an
- lNum を !
ToInt32 (x) とする。 - rNum を !
ToInt32 (y) とする。 - lBits を
ℝ (lNum) を表す 32 ビット 2 の補数ビット列とする。 - rBits を
ℝ (rNum) を表す 32 ビット 2 の補数ビット列とする。 - op が
&の場合、- result を lBits と rBits にビット単位の AND 演算を適用した結果とする。
- Else if op が
^の場合、- result を lBits と rBits にビット単位の排他的 OR（XOR）演算を適用した結果とする。
- Else,
Assert : op は|である。- result を lBits と rBits にビット単位の包含的 OR 演算を適用した結果とする。
- 32 ビット 2 の補数ビット列 result が表す整数の Number value を返す。
6.1.6.1.17 Number::bitwiseAND ( x, y )
The
NumberBitwiseOp (&, x, y) を返す。
6.1.6.1.18 Number::bitwiseXOR ( x, y )
The
NumberBitwiseOp (^, x, y) を返す。
6.1.6.1.19 Number::bitwiseOR ( x, y )
The
NumberBitwiseOp (|, x, y) を返す。
6.1.6.1.20 Number::toString ( x, radix )
The
- 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 が可能な限り小さくなるような整数とする。k は基数 radix による s の表現における桁数であり、s は radix で割り切れず、また s の最下位桁はこれらの条件によって必ずしも一意に決まらないことに注意。 - radix ≠ 10 または n が -5 から 21 までの包含区間にあるなら、
- n ≥ k なら、
- 次の
string-concatenation を返す:- 基数 radix による s の表現の k 桁のコードユニット
- コードユニット 0x0030（DIGIT ZERO）の n - k 回の出現
- 次の
- n > 0 なら、
- 次の
string-concatenation を返す:- 基数 radix による s の表現の上位 n 桁のコードユニット
- コードユニット 0x002E（FULL STOP）
- 基数 radix による s の表現の残り k - n 桁のコードユニット
- 次の
Assert : n ≤ 0。- 次の
string-concatenation を返す:- コードユニット 0x0030（DIGIT ZERO）
- コードユニット 0x002E（FULL STOP）
- コードユニット 0x0030（DIGIT ZERO）の -n 回の出現
- 基数 radix による s の表現の k 桁のコードユニット
- n ≥ k なら、
NOTE : この場合、入力は1.2e+3のような科学的 E 記法で表される。Assert : radix は 10 である。- n < 0 なら、
- exponentSign をコードユニット 0x002D（HYPHEN-MINUS）とする。
- Else,
- exponentSign をコードユニット 0x002B（PLUS SIGN）とする。
- k = 1 なら、
- 次の
string-concatenation を返す:- s の単一桁のコードユニット
- コードユニット 0x0065（LATIN SMALL LETTER E）
- exponentSign
abs (n - 1) の十進表現のコードユニット
- 次の
- 次の
string-concatenation を返す:- s の十進表現の最上位桁のコードユニット
- コードユニット 0x002E（FULL STOP）
- s の十進表現の残り k - 1 桁のコードユニット
- コードユニット 0x0065（LATIN SMALL LETTER E）
- exponentSign
abs (n - 1) の十進表現のコードユニット
ECMAScript の実装者にとって、浮動小数点数の二進数から十進数への変換に関して David M. Gay によって書かれた論文とコードは有用である可能性がある。
Gay, David M. Correctly Rounded Binary-Decimal and Decimal-Binary Conversions. Numerical Analysis, Manuscript 90-10. AT&T Bell Laboratories (Murray Hill, New Jersey). 30 November 1990. 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 型は整数値を表す。その値は任意の大きさを取りうるものであり、特定のビット幅には制限されない。一般に、特に注記がない限り、各演算は数学的に正確な答えを返すよう設計されている。二項演算において、BigInt は 2 の補数の二進文字列として振る舞い、負数は左側に無限にビットが立っているものとして扱われる。
6.1.6.2.1 BigInt::unaryMinus ( x )
The
- x =
0 ℤ なら、0 ℤ を返す。 - -x を返す。
6.1.6.2.2 BigInt::bitwiseNOT ( x )
The
- -x -
1 ℤ を返す。
6.1.6.2.3 BigInt::exponentiate ( base, exponent )
The
- exponent <
0 ℤ なら、RangeError 例外を投げる。 - base =
0 ℤ かつ exponent =0 ℤ なら、1 ℤ を返す。 - base の exponent 乗を返す。
6.1.6.2.4 BigInt::multiply ( x, y )
The
- x × y を返す。
6.1.6.2.5 BigInt::divide ( x, y )
The
6.1.6.2.6 BigInt::remainder ( n, d )
The
6.1.6.2.7 BigInt::add ( x, y )
The
- x + y を返す。
6.1.6.2.8 BigInt::subtract ( x, y )
The
- x - y を返す。
6.1.6.2.9 BigInt::leftShift ( x, y )
The
6.1.6.2.10 BigInt::signedRightShift ( x, y )
The
BigInt::leftShift (x, -y) を返す。
6.1.6.2.11 BigInt::unsignedRightShift ( x, y )
The
TypeError 例外を投げる。
6.1.6.2.12 BigInt::lessThan ( x, y )
The
6.1.6.2.13 BigInt::equal ( x, y )
The
6.1.6.2.14 BinaryAnd ( x, y )
The
- x = 1 かつ y = 1 なら、1 を返す。
- 0 を返す。
6.1.6.2.15 BinaryOr ( x, y )
The
- x = 1 または y = 1 なら、1 を返す。
- 0 を返す。
6.1.6.2.16 BinaryXor ( x, y )
The
- x = 1 かつ y = 0 なら、1 を返す。
- x = 0 かつ y = 1 なら、1 を返す。
- 0 を返す。
6.1.6.2.17 BigIntBitwiseOp ( op, x, y )
The &, ^, 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 が
&の場合、 - Else if op が
|の場合、 - Else,
- tmp ≠ 0 の場合、
- result を result - 2shift に設定する。
NOTE : これにより符号が拡張される。
- result の BigInt value を返す。
6.1.6.2.18 BigInt::bitwiseAND ( x, y )
The
BigIntBitwiseOp (&, x, y) を返す。
6.1.6.2.19 BigInt::bitwiseXOR ( x, y )
The
BigIntBitwiseOp (^, x, y) を返す。
6.1.6.2.20 BigInt::bitwiseOR ( x, y )
The
BigIntBitwiseOp (|, x, y) を返す。
6.1.6.2.21 BigInt::toString ( x, radix )
The
- x <
0 ℤ なら、"-" とBigInt::toString (-x, radix) のstring-concatenation を返す。 - 基数 radix による x の表現から成る String 値を返す。
6.1.7 Object 型
Object 型の各インスタンスは、単に “an Object” とも呼ばれ、プロパティの集合を表す。各プロパティは、data property または accessor property のいずれかである。
-
data property は、キー値を
ECMAScript 言語値 および Boolean 属性の集合と関連付ける。 -
accessor property は、キー値を 1 つまたは 2 つの accessor function および Boolean 属性の集合と関連付ける。accessor function は、そのプロパティに関連付けられた
ECMAScript 言語値 を格納または取得するために使用される。
オブジェクトのプロパティは、
integer index とは、
すべての非負 safe
すべてのオブジェクトは論理的にはプロパティの集合であるが、プロパティへのアクセスおよび操作に関する意味論が異なる複数の形式のオブジェクトが存在する。オブジェクトの複数の形式の定義については
さらに、一部のオブジェクトは callable であり、これらは functions または
6.1.7.1 プロパティ属性
属性は、この仕様において、
| 属性名 | その属性が存在するプロパティの種類 | 値域 | 既定値 | 説明 |
|---|---|---|---|---|
| [[Value]] |
|
an ECMAScript language value |
|
そのプロパティに対する get アクセスによって取得される値。 |
| [[Writable]] |
|
a Boolean |
|
|
| [[Get]] |
|
an Object or |
|
値が Object であるなら、それは |
| [[Set]] |
|
an Object or |
|
値が Object であるなら、それは |
| [[Enumerable]] |
|
a Boolean |
|
|
| [[Configurable]] |
|
a Boolean |
|
|
6.1.7.2 Object 内部メソッドと内部スロット
ECMAScript におけるオブジェクトの実際の意味論は、internal methods と呼ばれるアルゴリズムによって規定される。ECMAScript エンジン内の各オブジェクトは、その実行時の挙動を定義する内部メソッドの集合と関連付けられている。これらの内部メソッドは ECMAScript 言語の一部ではない。これらは純粋に説明のためにこの仕様で定義される。しかし、ECMAScript の実装内の各オブジェクトは、それに関連付けられた内部メソッドに従って振る舞わなければならない。これをどのように正確に達成するかは、実装によって決定される。
内部メソッド名は多相的である。これは、共通の内部メソッド名が適用されたときに、異なるオブジェクト値が異なるアルゴリズムを実行しうることを意味する。内部メソッドが呼び出される実際のオブジェクトは、その呼出しの “target” である。実行時に、あるアルゴリズムの実装が、そのオブジェクトがサポートしていない内部メソッドを使用しようとした場合、
内部スロットは、オブジェクト、Symbol、または
すべてのオブジェクトは [[PrivateElements]] という名前の内部スロットを持ち、これは
内部メソッドおよび内部スロットは、この仕様の中では二重角括弧 [[ ]] で囲まれた名前を用いて識別される。
ordinary object とは、次の基準をすべて満たすオブジェクトである。
-
Table 4 に列挙された内部メソッドについて、そのオブジェクトは10.1 で定義されたものを使用する。 -
そのオブジェクトが [[Call]] 内部メソッドを持つ場合、
10.2.1 で定義されたもの、または10.3.1 で定義されたもののいずれかを使用する。 -
そのオブジェクトが [[Construct]] 内部メソッドを持つ場合、
10.2.2 で定義されたもの、または10.3.2 で定義されたもののいずれかを使用する。
exotic object とは、
この仕様は、異なる種類の
内部メソッドは、そのパラメータに加えて、常にメソッド呼出しの target であるオブジェクトへアクセスできる。
内部メソッドは暗黙に
| Internal Method | Signature | 説明 |
|---|---|---|
| [[GetPrototypeOf]] | ( ) → Object | Null |
このオブジェクトに継承プロパティを提供するオブジェクトを決定する。 |
| [[SetPrototypeOf]] | (Object | Null) → Boolean |
このオブジェクトを、継承プロパティを提供する別のオブジェクトと関連付ける。 |
| [[IsExtensible]] | ( ) → Boolean | このオブジェクトに追加のプロパティを加えることが許可されているかどうかを判定する。 |
| [[PreventExtensions]] | ( ) → Boolean |
このオブジェクトに新しいプロパティを追加できるかどうかを制御する。操作が成功した場合は |
| [[GetOwnProperty]] |
(propertyKey) → Undefined | |
キーが propertyKey であるこのオブジェクトの own property に対する |
| [[DefineOwnProperty]] | (propertyKey, propertyDescriptor) → Boolean |
キーが propertyKey である own property を作成または変更し、propertyDescriptor によって記述される状態を持たせる。そのプロパティが正常に作成／更新された場合は |
| [[HasProperty]] | (propertyKey) → Boolean | キーが propertyKey である own property または 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 |
このオブジェクトに関連付けられたコードを実行する。関数呼出し式を介して起動される。内部メソッドへの引数は |
| [[Construct]] |
(a |
オブジェクトを生成する。new 演算子または super 呼出しを介して起動される。内部メソッドへの第 1 引数は、super 呼出しの引数を要素とする new 演算子が適用されたオブジェクトである。この内部メソッドを実装するオブジェクトは |
6.1.7.3 Essential Internal Methods の不変条件
ECMAScript エンジンの Object の Internal Methods は、以下に規定される不変条件の一覧に適合しなければならない。この仕様における ordinary ECMAScript Object およびすべての標準
実装によって提供される
実装は、これらの不変条件を強制することなく essential internal methods の機能を実装する代替インターフェースを提供するなどして、これらの不変条件がいかなる方法によっても回避されることを許してはならない。
定義:
- 内部メソッドの target とは、その内部メソッドが呼び出されるオブジェクトである。
-
target は、その [[IsExtensible]] 内部メソッドから
false を返すこと、またはその [[PreventExtensions]] 内部メソッドからtrue を返すことが観測されている場合、non-extensible である。 - non-existent property とは、non-extensible target 上に own property として存在しないプロパティである。
-
SameValue へのすべての参照は、SameValue アルゴリズムの定義に従う。
戻り値:
任意の内部メソッドによって返される値は、次のいずれかを持つ
- [[Type]] =
normal , [[Target]] =empty , および [[Value]] = その内部メソッドについて以下に示される “normal return type” の値、または - [[Type]] =
throw , [[Target]] =empty , および [[Value]] = 任意のECMAScript 言語値 。
内部メソッドは
[[GetPrototypeOf]] ( )
- normal return type は Object または Null のいずれかである。
-
target が non-extensible であり、[[GetPrototypeOf]] が値 proto を返した場合、その後の [[GetPrototypeOf]] の呼出しはすべて proto と
SameValue である値を返すべきである。
オブジェクトの prototype chain は有限長であるべきである（すなわち、任意のオブジェクトから始めて、その結果に [[GetPrototypeOf]] 内部メソッドを再帰的に適用すると、最終的に値
[[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 を返さなければならない。 -
propertyKey の [[Writable]] および [[Value]] 以外の属性が時間とともに変化しうる場合、またはそのプロパティが削除されうる場合、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, desc )
- normal return type は Boolean である。
-
[[DefineOwnProperty]] は、propertyKey が以前に target の non-configurable own property として観測されていた場合、次のいずれかに当てはまらない限り
false を返さなければならない。-
propertyKey が writable
data property である。non-configurable な writabledata property は、non-configurable な non-writabledata property に変更できる。 -
desc のすべての属性が propertyKey の属性と
SameValue である。
-
propertyKey が writable
-
[[DefineOwnProperty]] (propertyKey, desc) は、target が non-extensible であり、かつ propertyKey が non-existent own property である場合、
false を返さなければならない。すなわち、non-extensible target object は新しいプロパティによって拡張できない。
[[HasProperty]] ( propertyKey )
- normal return type は Boolean である。
-
propertyKey が以前に target の non-configurable own
data property またはaccessor property として観測されていた場合、[[HasProperty]] はtrue を返さなければならない。
[[Get]] ( propertyKey, receiver )
-
normal return type は任意の
ECMAScript 言語型 である。 -
propertyKey が以前に、値 value を持つ target の 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 property またはaccessor property として観測されていた場合、[[Delete]] はfalse を返さなければならない。
[[OwnPropertyKeys]] ( )
-
normal return type は
List である。 -
返される
List には重複する項目が含まれていてはならない。 -
返される
List の各要素はproperty key でなければならない。 -
返される
List には、以前に観測されたすべての non-configurable own property のキーが少なくとも含まれていなければならない。 -
target が non-extensible である場合、返される
List は [[GetOwnProperty]] を用いて観測可能な target のすべての own property のキーのみを含まなければならない。
[[Call]] ( )
-
normal return type は任意の
ECMAScript 言語型 である。
[[Construct]] ( )
- normal return type は Object である。
- target は [[Call]] 内部メソッドも持たなければならない。
6.1.7.4 Well-Known Intrinsic Object
well-known intrinsic は、この仕様のアルゴリズムによって明示的に参照され、通常
この仕様において、%name% のような参照は、その名前に対応する現在の
6.2 ECMAScript 仕様型
仕様型は、ECMAScript 言語構成要素および
6.2.1 Enum 仕様型
Enum は、仕様内部の値であり、ECMAScript コードから直接観測することはできない。Enum は、
6.2.2 List および Record 仕様型
List 型は、new 式、関数呼出し、および単純な順序付き値リストが必要な他のアルゴリズムにおける引数リストの評価（
アルゴリズムが順序を明示せずに List の要素を反復するとき、用いられる順序は List 内の要素の順序である。
この仕様内での記法上の便宜のため、新しい List 値を表現するためにリテラル構文を用いることができる。たとえば、« 1, 2 » は、2 つの要素を持ち、それぞれが特定の値に初期化された List 値を定義する。新しい空の List は « » と表現できる。
この仕様において、“A, B, ... の list-concatenation” という句（各引数は空であってよい List である）は、各引数の要素を（順に）連結した要素を持つ新しい List 値を表す。
String の List に適用される “lexicographic code unit order に従って sorted される” という句は、短い方の文字列の長さまで各コードユニットの数値で比較し、すべて等しい場合には短い文字列を長い文字列より前に並べることを意味し、これは抽象操作
Record 型は、この仕様のアルゴリズム内におけるデータ集約を記述するために使用される。Record 型の値は、1 つ以上の名前付きフィールドから成る。各フィールドの値は
この仕様内での記法上の便宜のため、オブジェクトリテラルに似た構文を用いて Record 値を表現できる。たとえば、{ [[Field1]]: 42, [[Field2]]:
仕様本文およびアルゴリズムでは、ドット記法を用いて Record 値の特定フィールドを参照できる。たとえば、R が前段落で示した record であるなら、R.[[Field2]] は “R の [[Field2]] という名前のフィールド” の略記である。
よく使用される Record フィールドの組合せに対する schema には名前を付けることができ、その名前はリテラル Record 値の接頭辞として使用され、記述されている集約の具体的な種類を識別できる。たとえば: PropertyDescriptor { [[Value]]: 42, [[Writable]]:
6.2.3 Set および Relation 仕様型
Set 型は、
Relation 型は、Set 上の制約を説明するために使用される。Relation 型の値は、その値域から取られた値の順序対の Set である。たとえば、
strict partial order は、次を満たす Relation 値 R である。
-
R の定義域に属するすべての a, b, および c について:
- a R a は成り立たず、かつ
- a R b かつ b R c なら、a R c である。
上の 2 つの性質は、それぞれ irreflexivity および transitivity と呼ばれる。
strict total order は、次を満たす Relation 値 R である。
-
R の定義域に属するすべての a, b, および c について:
- a は b であるか、a R b であるか、または b R a であり、かつ
- a R a は成り立たず、かつ
- a R b かつ b R c なら、a R c である。
上の 3 つの性質は、それぞれ totality、irreflexivity、および transitivity と呼ばれる。
6.2.4 Completion Record 仕様型
Completion Record 仕様型は、値の実行時伝播および、非局所的な制御移動を行う文（break、continue、return、throw）の挙動のような制御フローを説明するために使用される。
Completion Record は
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Type]] |
|
発生した completion の種類。 |
| [[Value]] |
|
生成された値。 |
| [[Target]] |
a String or |
指向的な制御移動の target ラベル。 |
次の略記用語は、ときどき Completion Record を参照するために使用される。
- 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 を指す。 - a normal completion containing some type of value は、その型の値を [[Value]] フィールドに持つ normal completion を指す。
この仕様で定義される callable object は、normal completion または throw completion のみを返す。他の種類の Completion Record を返すことは編集上の誤りとみなされる。
6.2.4.1 NormalCompletion ( value )
The
Completion Record { [[Type]]:normal , [[Value]]: value, [[Target]]:empty } を返す。
6.2.4.2 ThrowCompletion ( value )
The
Completion Record { [[Type]]:throw , [[Value]]: value, [[Target]]:empty } を返す。
6.2.4.3 ReturnCompletion ( value )
The
Completion Record { [[Type]]:return , [[Value]]: value, [[Target]]:empty } を返す。
6.2.4.4 UpdateEmpty ( completionRecord, value )
The
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]] | an ECMAScript language value, an |
バインディングを保持する値または |
| [[ReferencedName]] | an ECMAScript language value or a |
そのバインディングの名前。[[Base]] の値が |
| [[Strict]] | a Boolean | |
| [[ThisValue]] | an ECMAScript language value or |
super キーワードを用いて表現されたプロパティバインディングを表し、Super Reference Record と呼ばれる。その [[Base]] 値が |
以下の抽象操作が、この仕様において Reference Record を操作するために使用される。
6.2.5.1 IsPropertyReference ( referenceRecord )
The
- referenceRecord.[[Base]] が
unresolvable なら、false を返す。 - referenceRecord.[[Base]] が
Environment Record なら、false を返す。 true を返す。
6.2.5.2 IsUnresolvableReference ( referenceRecord )
The
- referenceRecord.[[Base]] が
unresolvable なら、true を返す。 false を返す。
6.2.5.3 IsSuperReference ( referenceRecord )
The
- referenceRecord.[[ThisValue]] が
empty なら、false を返す。 true を返す。
6.2.5.4 IsPrivateReference ( referenceRecord )
The
- referenceRecord.[[ReferencedName]] が
Private Name なら、true を返す。 false を返す。
6.2.5.5 GetValue ( referenceRecord )
The
- referenceRecord が
Reference Record でないなら、referenceRecord を返す。 IsUnresolvableReference (referenceRecord) がtrue なら、ReferenceError 例外を投げる。IsPropertyReference (referenceRecord) がtrue なら、- baseObj を ?
ToObject (referenceRecord.[[Base]]) とする。 IsPrivateReference (referenceRecord) がtrue なら、- ?
PrivateGet (baseObj, referenceRecord.[[ReferencedName]]) を返す。
- ?
- referenceRecord.[[ReferencedName]] が
property key でないなら、- referenceRecord.[[ReferencedName]] を ?
ToPropertyKey (referenceRecord.[[ReferencedName]]) に設定する。
- referenceRecord.[[ReferencedName]] を ?
- ? baseObj.[[Get]](referenceRecord.[[ReferencedName]],
GetThisValue (referenceRecord)) を返す。
- baseObj を ?
- base を referenceRecord.[[Base]] とする。
Assert : base はEnvironment Record である。- ? base.
GetBindingValue (referenceRecord.[[ReferencedName]], referenceRecord.[[Strict]]) を返す（9.1 を参照）。
手順
6.2.5.6 PutValue ( referenceRecord, value )
The
- referenceRecord が
Reference Record でないなら、ReferenceError 例外を投げる。 IsUnresolvableReference (referenceRecord) がtrue なら、- referenceRecord.[[Strict]] が
true なら、ReferenceError 例外を投げる。 - globalObj を
GetGlobalObject () とする。 - ?
Set (globalObj, referenceRecord.[[ReferencedName]], value,false ) を実行する。 unused を返す。
- referenceRecord.[[Strict]] が
IsPropertyReference (referenceRecord) がtrue なら、- baseObj を ?
ToObject (referenceRecord.[[Base]]) とする。 IsPrivateReference (referenceRecord) がtrue なら、- ?
PrivateSet (baseObj, referenceRecord.[[ReferencedName]], value) を返す。
- ?
- referenceRecord.[[ReferencedName]] が
property key でないなら、- referenceRecord.[[ReferencedName]] を ?
ToPropertyKey (referenceRecord.[[ReferencedName]]) に設定する。
- referenceRecord.[[ReferencedName]] を ?
- succeeded を ? baseObj.[[Set]](referenceRecord.[[ReferencedName]], value,
GetThisValue (referenceRecord)) とする。 - succeeded が
false かつ referenceRecord.[[Strict]] がtrue なら、TypeError 例外を投げる。 unused を返す。
- baseObj を ?
- base を referenceRecord.[[Base]] とする。
Assert : base はEnvironment Record である。- ? base.
SetMutableBinding (referenceRecord.[[ReferencedName]], value, referenceRecord.[[Strict]]) を返す（9.1 を参照）。
手順
6.2.5.7 GetThisValue ( referenceRecord )
The
Assert :IsPropertyReference (referenceRecord) istrue .IsSuperReference (referenceRecord) がtrue なら、referenceRecord.[[ThisValue]] を返す。- referenceRecord.[[Base]] を返す。
6.2.5.8 InitializeReferencedBinding ( referenceRecord, value )
The
Assert :IsUnresolvableReference (referenceRecord) isfalse .- base を referenceRecord.[[Base]] とする。
Assert : base はEnvironment Record である。- ? base.
InitializeBinding (referenceRecord.[[ReferencedName]], value) を返す。
6.2.5.9 MakePrivateReference ( baseValue, privateIdentifier )
The
- privateEnv を、実行中の
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 Descriptor と accessor Property Descriptor にさらに分類できる。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 ( desc )
The
- desc が [[Get]] フィールドを持つなら、
true を返す。 - desc が [[Set]] フィールドを持つなら、
true を返す。 false を返す。
6.2.6.2 IsDataDescriptor ( desc )
The
- desc が [[Value]] フィールドを持つなら、
true を返す。 - desc が [[Writable]] フィールドを持つなら、
true を返す。 false を返す。
6.2.6.3 IsGenericDescriptor ( desc )
The
IsAccessorDescriptor (desc) がtrue なら、false を返す。IsDataDescriptor (desc) がtrue なら、false を返す。true を返す。
6.2.6.4 FromPropertyDescriptor ( desc )
The
- desc が
undefined なら、undefined を返す。 - obj を
OrdinaryObjectCreate (%Object.prototype% ) とする。 Assert : obj は own property を持たない extensible なordinary object である。- desc が [[Value]] フィールドを持つ場合、
- !
CreateDataPropertyOrThrow (obj,"value" , desc.[[Value]]) を実行する。
- !
- desc が [[Writable]] フィールドを持つ場合、
- !
CreateDataPropertyOrThrow (obj,"writable" , desc.[[Writable]]) を実行する。
- !
- desc が [[Get]] フィールドを持つ場合、
- !
CreateDataPropertyOrThrow (obj,"get" , desc.[[Get]]) を実行する。
- !
- desc が [[Set]] フィールドを持つ場合、
- !
CreateDataPropertyOrThrow (obj,"set" , desc.[[Set]]) を実行する。
- !
- desc が [[Enumerable]] フィールドを持つ場合、
- !
CreateDataPropertyOrThrow (obj,"enumerable" , desc.[[Enumerable]]) を実行する。
- !
- desc が [[Configurable]] フィールドを持つ場合、
- !
CreateDataPropertyOrThrow (obj,"configurable" , desc.[[Configurable]]) を実行する。
- !
- obj を返す。
6.2.6.5 ToPropertyDescriptor ( obj )
The
- obj が Object でないなら、
TypeError 例外を投げる。 - 最初はフィールドを持たない新しい
Property Descriptor として desc を作る。 - hasEnumerable を ?
HasProperty (obj,"enumerable" ) とする。 - hasEnumerable が
true の場合、 - hasConfigurable を ?
HasProperty (obj,"configurable" ) とする。 - hasConfigurable が
true の場合、 - hasValue を ?
HasProperty (obj,"value" ) とする。 - hasValue が
true の場合、- value を ?
Get (obj,"value" ) とする。 - desc.[[Value]] を value に設定する。
- value を ?
- hasWritable を ?
HasProperty (obj,"writable" ) とする。 - hasWritable が
true の場合、 - hasGet を ?
HasProperty (obj,"get" ) とする。 - hasGet が
true の場合、- getter を ?
Get (obj,"get" ) とする。 IsCallable (getter) がfalse かつ getter がundefined でないなら、TypeError 例外を投げる。- desc.[[Get]] を getter に設定する。
- getter を ?
- hasSet を ?
HasProperty (obj,"set" ) とする。 - hasSet が
true の場合、- setter を ?
Get (obj,"set" ) とする。 IsCallable (setter) がfalse かつ setter がundefined でないなら、TypeError 例外を投げる。- desc.[[Set]] を setter に設定する。
- setter を ?
- desc が [[Get]] フィールドまたは [[Set]] フィールドを持つ場合、
- desc が [[Value]] フィールドまたは [[Writable]] フィールドを持つなら、
TypeError 例外を投げる。
- desc が [[Value]] フィールドまたは [[Writable]] フィールドを持つなら、
- desc を返す。
6.2.6.6 CompletePropertyDescriptor ( desc )
The
- like を
Record { [[Value]]:undefined , [[Writable]]:false , [[Get]]:undefined , [[Set]]:undefined , [[Enumerable]]:false , [[Configurable]]:false } とする。 IsGenericDescriptor (desc) がtrue またはIsDataDescriptor (desc) がtrue の場合、- desc が [[Value]] フィールドを持たないなら、desc.[[Value]] を like.[[Value]] に設定する。
- desc が [[Writable]] フィールドを持たないなら、desc.[[Writable]] を like.[[Writable]] に設定する。
- Else,
- desc が [[Get]] フィールドを持たないなら、desc.[[Get]] を like.[[Get]] に設定する。
- desc が [[Set]] フィールドを持たないなら、desc.[[Set]] を like.[[Set]] に設定する。
- desc が [[Enumerable]] フィールドを持たないなら、desc.[[Enumerable]] を like.[[Enumerable]] に設定する。
- desc が [[Configurable]] フィールドを持たないなら、desc.[[Configurable]] を like.[[Configurable]] に設定する。
unused を返す。
6.2.7 Environment Record 仕様型
6.2.8 Abstract Closure 仕様型
Abstract Closure 仕様型は、値の集合とともにアルゴリズム手順を参照するために使用される。Abstract Closure はメタ値であり、closure(arg1, arg2) のような関数適用形式を用いて呼び出される。抽象操作と同様に、呼出しはその Abstract Closure によって記述されたアルゴリズム手順を実行する。
Abstract Closure を作成するアルゴリズム手順では、値は “capture” という動詞に続く別名のリストを用いて捕捉される。Abstract Closure が作成されるとき、その時点で各別名に関連付けられている値を捕捉する。Abstract Closure が呼び出されたときに実行されるアルゴリズムを規定する手順では、各捕捉値は、その値を捕捉するために使用された別名によって参照される。
Abstract Closure が
Abstract Closure は、他のアルゴリズムの一部としてインラインで作成される。次の例に示す。
- addend を 41 とする。
- closure を、新しい
Abstract Closure とする。この Closure はパラメータ (x) を持ち、addend を捕捉し、呼び出されたときに次の手順を実行する:- x + addend を返す。
- val を closure(1) とする。
Assert : val は 42 である。
6.2.9 Data Block
Data Block 仕様型は、バイト単位（8 ビット）の数値の、独立した可変の列を記述するために使用される。byte value とは、0 から 255 までの包含区間にある整数である。Data Block 値は、各バイトの初期値が 0 である固定個数のバイトで作成される。
この仕様内での記法上の便宜のため、配列風の構文を用いて Data Block 値の個々のバイトへアクセスできる。この記法は、Data Block 値を 0 始まりの
複数の
Shared Data Block の意味論は、
Shared Data Block event は、
以下の抽象操作は、この仕様において Data Block 値を操作するために使用される。
6.2.9.1 CreateByteDataBlock ( size )
The
- size > 253 - 1 なら、
RangeError 例外を投げる。 - size バイトから成る新しい
Data Block 値 db を作る。そのようなData Block を作成できない場合、RangeError 例外を投げる。 - db のすべてのバイトを 0 に設定する。
- db を返す。
6.2.9.2 CreateSharedByteDataBlock ( size )
The
- size バイトから成る新しい
Shared Data Block 値 db を作る。そのようなShared Data Block を作成できない場合、RangeError 例外を投げる。 - agentRecord を、周囲の
agent のAgent Record とする。 - execution を agentRecord.[[CandidateExecution]] とする。
- eventsRecord を、execution.[[EventsRecords]] のうち [[AgentSignifier]] が
AgentSignifier () であるAgent Events Record とする。 - zero を « 0 » とする。
- db の各添字 i について、次を行う
WriteSharedMemory { [[Order]]:init , [[NoTear]]:true , [[Block]]: db, [[ByteIndex]]: i, [[ElementSize]]: 1, [[Payload]]: zero } を eventsRecord.[[EventList]] に追加する。
- db を返す。
6.2.9.3 CopyDataBlockBytes ( toBlock, toIndex, fromBlock, fromIndex, count )
The
Assert : fromBlock と toBlock は異なる値である。- fromSize を fromBlock 内のバイト数とする。
Assert : fromIndex + count ≤ fromSize。- toSize を toBlock 内のバイト数とする。
Assert : toIndex + count ≤ toSize。- count > 0 の間、繰り返す
- fromBlock が
Shared Data Block の場合、- agentRecord を、周囲の
agent のAgent Record とする。 - execution を agentRecord.[[CandidateExecution]] とする。
- eventsRecord を、execution.[[EventsRecords]] のうち [[AgentSignifier]] が
AgentSignifier () であるAgent Events Record とする。 - bytes を、唯一の要素として非決定的に選ばれた
byte value を持つList とする。 NOTE : 実装において、bytes は基盤ハードウェア上の非アトミック read 命令の結果である。非決定性は、弱い一貫性を持つハードウェアの観測可能な挙動を記述するための、メモリモデル による意味論的規定である。- readEvent を
ReadSharedMemory { [[Order]]:unordered , [[NoTear]]:true , [[Block]]: fromBlock, [[ByteIndex]]: fromIndex, [[ElementSize]]: 1 } とする。 - readEvent を eventsRecord.[[EventList]] に追加する。
Chosen Value Record { [[Event]]: readEvent, [[ChosenValue]]: bytes } を execution.[[ChosenValues]] に追加する。- toBlock が
Shared Data Block の場合、WriteSharedMemory { [[Order]]:unordered , [[NoTear]]:true , [[Block]]: toBlock, [[ByteIndex]]: toIndex, [[ElementSize]]: 1, [[Payload]]: bytes } を eventsRecord.[[EventList]] に追加する。
- Else,
- toBlock[toIndex] を bytes[0] に設定する。
- agentRecord を、周囲の
- Else,
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 field、method、および accessor の仕様において使用される
PrivateElement 型の値は、
| フィールド名 | そのフィールドが存在する [[Kind]] フィールドの値 | 値 | 意味 |
|---|---|---|---|
| [[Key]] | All |
a |
field、method、または accessor の名前。 |
| [[Kind]] | All |
|
要素の種類。 |
| [[Value]] |
|
an ECMAScript language value | field の値。 |
| [[Get]] |
|
a |
private accessor の getter。 |
| [[Set]] |
|
a |
private accessor の setter。 |
6.2.11 ClassFieldDefinition Record 仕様型
ClassFieldDefinition 型は、class field の仕様において使用される
ClassFieldDefinition 型の値は、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Name]] |
a |
field の名前。 |
| [[Initializer]] |
an ECMAScript |
存在する場合、その field の initializer。 |
6.2.12 Private Name
Private Name 仕様型は、private class element（field、method、または accessor）のキーを表す、グローバルに一意な値（たとえ他の点で区別不能であっても、他のあらゆる Private Name と異なる値）を記述するために使用される。各 Private Name は、不変の [[Description]] 内部スロットを持ち、その値は String である。Private Name は、任意の ECMAScript object に対して
6.2.13 ClassStaticBlockDefinition Record 仕様型
ClassStaticBlockDefinition Record は、class static initialization block の実行可能コードをカプセル化するために使用される
ClassStaticBlockDefinition Record は、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[BodyFunction]] |
an ECMAScript |
class の static 初期化中に呼び出される |
7 抽象操作
これらの操作は ECMAScript 言語の一部ではない。これらは、ECMAScript 言語の意味論を仕様化するのを補助するためだけに、ここで定義される。この仕様全体を通して、他にもより特殊化された抽象操作が定義されている。
7.1 型変換
ECMAScript 言語は必要に応じて暗黙に自動型変換を行う。ある種の構文の意味論を明確にするために、変換抽象操作の集合を定義しておくことは有用である。変換抽象操作は多相的であり、任意の
7.1.1 ToPrimitive ( input [ , preferredType ] )
The
- input が Object である場合、
- exoticToPrim を ?
GetMethod (input,%Symbol.toPrimitive% ) とする。 - exoticToPrim が
undefined でない場合、 - preferredType が存在しないなら、preferredType を
number に設定する。 - ?
OrdinaryToPrimitive (input, preferredType) を返す。
- exoticToPrim を ?
- input を返す。
ToPrimitive がヒントなしで呼び出されると、一般にはヒントが
7.1.1.1 OrdinaryToPrimitive ( obj, hint )
The
- hint が
string の場合、- methodNames を «
"toString" ,"valueOf" » とする。
- methodNames を «
- Else,
- 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 ( argument )
The
- argument が Boolean なら、argument を返す。
- argument が
undefined ,null ,+0 𝔽,-0 𝔽,NaN ,0 ℤ, または空の String のいずれかであるなら、false を返す。 - ホストがウェブブラウザであるか、または
[[IsHTMLDDA]] 内部スロット をサポートする場合、- argument が Object であり、かつ argument が [[IsHTMLDDA]] 内部スロットを持つなら、
false を返す。
- argument が Object であり、かつ argument が [[IsHTMLDDA]] 内部スロットを持つなら、
true を返す。
7.1.3 ToNumeric ( value )
The
- primValue を ?
ToPrimitive (value,number ) とする。 - primValue が BigInt なら、primValue を返す。
- ?
ToNumber (primValue) を返す。
7.1.4 ToNumber ( argument )
The
- argument が Number なら、argument を返す。
- argument が Symbol または BigInt のいずれかであるなら、
TypeError 例外を throw する。 - argument が
undefined なら、NaN を返す。 - argument が
null またはfalse のいずれかであるなら、+0 𝔽 を返す。 - argument が
true なら、1 𝔽 を返す。 - argument が String なら、
StringToNumber (argument) を返す。 Assert : argument は Object である。- primValue を ?
ToPrimitive (argument,number ) とする。 Assert : primValue は Object ではない。- ?
ToNumber (primValue) を返す。
7.1.4.1 String 型に適用される ToNumber
抽象操作
構文
上で明示的に定義されていないすべての文法記号は、数値リテラルの字句文法（
-
StringNumericLiteral には、先頭および／または末尾の空白や行終端子を含めることができる。 -
10 進の
StringNumericLiteral は、任意個の先頭0桁を持つことができる。 -
10 進の
StringNumericLiteral には、その符号を示すための+または-を含めることができる。 -
空であるか、または空白のみを含む
StringNumericLiteral は、+0 𝔽 に変換される。 -
Infinityおよび-InfinityはStringNumericLiteral として認識されるが、NumericLiteral としては認識されない。 -
StringNumericLiteral はBigIntLiteralSuffix を含むことができない。 -
StringNumericLiteral はNumericLiteralSeparator を含むことができない。
7.1.4.1.1 StringToNumber ( str )
The
- literal を
ParseText (str,StringNumericLiteral ) とする。 - literal がエラーの
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 に含まれるコードポイント数とする。
- b を 2 番目の
- Else,
- b を 0 とする。
- n を 0 とする。
ExponentPart が存在するなら e をExponentPart の MV とし、そうでなければ e を 0 とする。RoundMVResult ((a + (b × 10-n)) × 10e) を返す。
- b を
DecimalDigits の MV とする。 ExponentPart が存在するなら e をExponentPart の MV とし、そうでなければ e を 0 とする。- n を
DecimalDigits に含まれるコードポイント数とする。 RoundMVResult (b × 10e - n) を返す。
- a を
DecimalDigits の MV とする。 ExponentPart が存在するなら e をExponentPart の MV とし、そうでなければ e を 0 とする。RoundMVResult (a × 10e) を返す。
7.1.4.1.3 RoundMVResult ( n )
The
- n の 10 進表現が 20 桁以下の significant digits を持つなら、
𝔽 (n) を返す。 - option1 を、n の 10 進表現において 20 桁目より後の各 significant digit を 0 桁で置き換えた結果によって表される数学的値とする。
- option2 を、n の 10 進表現において 20 桁目より後の各 significant digit を 0 桁で置き換え、その後 20 桁目でインクリメントした結果（必要に応じて桁上がりを行う）によって表される数学的値とする。
- chosen を、option1 または option2 のいずれかを選ぶ
implementation-defined な選択とする。 𝔽 (chosen) を返す。
7.1.5 ToIntegerOrInfinity ( argument )
The
7.1.6 ToFixedSizeInteger ( int, signed, bitWidth )
The
ToFixedSizeInteger は冪等である: 任意の
7.1.7 ToInt32 ( argument )
The
- int を ?
ToIntegerOrInfinity (argument) とする。 𝔽 (ToFixedSizeInteger (int,signed , 32)) を返す。
7.1.8 ToUint32 ( argument )
The
- int を ?
ToIntegerOrInfinity (argument) とする。 𝔽 (ToFixedSizeInteger (int,unsigned , 32)) を返す。
7.1.9 ToInt16 ( argument )
The
- int を ?
ToIntegerOrInfinity (argument) とする。 𝔽 (ToFixedSizeInteger (int,signed , 16)) を返す。
7.1.10 ToUint16 ( argument )
The
- int を ?
ToIntegerOrInfinity (argument) とする。 𝔽 (ToFixedSizeInteger (int,unsigned , 16)) を返す。
7.1.11 ToInt8 ( argument )
The
- int を ?
ToIntegerOrInfinity (argument) とする。 𝔽 (ToFixedSizeInteger (int,signed , 8)) を返す。
7.1.12 ToUint8 ( argument )
The
- int を ?
ToIntegerOrInfinity (argument) とする。 𝔽 (ToFixedSizeInteger (int,unsigned , 8)) を返す。
7.1.13 ToUint8Clamp ( argument )
The
他のほとんどの ECMAScript 整数変換操作とは異なり、ToUint8Clamp は非整数値を切り捨てるのではなく丸める。また、これは「最近接偶数丸め」の同値分岐を使用し、これは Math.round
7.1.14 ToBigInt ( argument )
The
- prim を ?
ToPrimitive (argument,number ) とする。 Table 12 において prim が対応する値を返す。
| 引数の型 | 結果 |
|---|---|
| Undefined |
|
| Null |
|
| Boolean |
prim が 1n を返し、prim が 0n を返す。
|
| BigInt | prim を返す。 |
| Number |
|
| String |
|
| Symbol |
|
7.1.15 StringToBigInt ( str )
The
- literal を
ParseText (str,StringIntegerLiteral ) とする。 - literal がエラーの
List である場合、undefined を返す。 - mv を literal の MV とする。
Assert : mv は整数である。ℤ (mv) を返す。
7.1.15.1 StringIntegerLiteral 文法
構文
7.1.15.2 実行時セマンティクス: MV
-
StringIntegerLiteral ::: StrWhiteSpace opt -
StringIntegerLiteral ::: StrWhiteSpace opt StrIntegerLiteral StrWhiteSpace opt StrIntegerLiteral の MV である。
7.1.16 ToBigInt64 ( argument )
The
- int を
ℝ (?ToBigInt (argument)) とする。 ℤ (ToFixedSizeInteger (int,signed , 64)) を返す。
7.1.17 ToBigUint64 ( argument )
The
- int を
ℝ (?ToBigInt (argument)) とする。 ℤ (ToFixedSizeInteger (int,unsigned , 64)) を返す。
7.1.18 ToString ( argument )
The
- argument が String である場合、argument を返す。
- argument が Symbol である場合、
TypeError 例外を投げる。 - argument が
undefined である場合、"undefined" を返す。 - argument が
null である場合、"null" を返す。 - argument が
true である場合、"true" を返す。 - argument が
false である場合、"false" を返す。 - argument が Number である場合、
Number::toString (argument, 10) を返す。 - argument が BigInt である場合、
BigInt::toString (argument, 10) を返す。 Assert : argument は Object である。- primValue を ?
ToPrimitive (argument,string ) とする。 Assert : primValue は Object ではない。- ?
ToString (primValue) を返す。
7.1.19 ToObject ( argument )
The
- argument が
undefined またはnull のいずれかである場合、TypeError 例外を投げる。 - argument が Boolean である場合、[[BooleanData]] 内部スロットが argument に設定された新しい Boolean オブジェクトを返す。Boolean オブジェクトの説明については
20.3 を参照。 - argument が Number である場合、[[NumberData]] 内部スロットが argument に設定された新しい Number オブジェクトを返す。Number オブジェクトの説明については
21.1 を参照。 - argument が String である場合、[[StringData]] 内部スロットが argument に設定された新しい String オブジェクトを返す。String オブジェクトの説明については
22.1 を参照。 - argument が Symbol である場合、[[SymbolData]] 内部スロットが argument に設定された新しい Symbol オブジェクトを返す。Symbol オブジェクトの説明については
20.4 を参照。 - argument が BigInt である場合、[[BigIntData]] 内部スロットが argument に設定された新しい BigInt オブジェクトを返す。BigInt オブジェクトの説明については
21.2 を参照。 Assert : argument は Object である。- argument を返す。
7.1.20 ToPropertyKey ( argument )
The
- key を ?
ToPrimitive (argument,string ) とする。 - key が Symbol である場合、
- key を返す。
- !
ToString (key) を返す。
7.1.21 ToLength ( argument )
The
- len を ?
ToIntegerOrInfinity (argument) とする。 - len ≤ 0 である場合、
+0 𝔽 を返す。 𝔽 (min (len, 253 - 1)) を返す。
7.1.22 CanonicalNumericIndexString ( argument )
The
正準数値文字列とは、CanonicalNumericIndexString 抽象操作が
7.1.23 ToIndex ( value )
The
- integer を ?
ToIntegerOrInfinity (value) とする。 - integer が 0 から 253 - 1 までの包含区間にないなら、
RangeError 例外を throw する。 - integer を返す。
7.2 判定および比較操作
7.2.1 RequireObjectCoercible ( argument )
The
- argument が
undefined またはnull のいずれかであるなら、TypeError 例外を throw する。 unused を返す。
7.2.2 IsArray ( argument )
The
- argument が Object でないなら、
false を返す。 - argument が Array
exotic object なら、true を返す。 - argument が Proxy
exotic object なら、- ?
ValidateNonRevokedProxy (argument) を実行する。 - proxyTarget を argument.[[ProxyTarget]] とする。
- ?
IsArray (proxyTarget) を返す。
- ?
false を返す。
7.2.3 IsCallable ( argument )
The
- argument が Object でないなら、
false を返す。 - argument が [[Call]] 内部メソッドを持つなら、
true を返す。 false を返す。
7.2.4 IsConstructor ( argument )
The
- argument が Object でないなら、
false を返す。 - argument が [[Construct]] 内部メソッドを持つなら、
true を返す。 false を返す。
7.2.5 IsExtensible ( obj )
The
- ? obj.[[IsExtensible]]() を返す。
7.2.6 IsRegExp ( argument )
The
- argument が Object でないなら、
false を返す。 - matcher を ?
Get (argument,%Symbol.match% ) とする。 - matcher が
undefined でないなら、ToBoolean (matcher) を返す。 - argument が [[RegExpMatcher]] 内部スロットを持つなら、
true を返す。 false を返す。
7.2.7 Static Semantics: IsStringWellFormedUnicode ( string )
The
- len を string の長さとする。
- k を 0 とする。
- k < len の間、繰り返す
- cp を
CodePointAt (string, k) とする。 - cp.[[IsUnpairedSurrogate]] が
true なら、false を返す。 - k を k + cp.[[CodeUnitCount]] に設定する。
- cp を
true を返す。
7.2.8 SameType ( x, y )
The
- 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
SameType (x, y) がfalse なら、false を返す。- x が Number なら、
Number::sameValue (x, y) を返す。
SameValueNonNumber (x, y) を返す。
このアルゴリズムは、すべての
7.2.10 SameValueZero ( x, y )
The
SameType (x, y) がfalse なら、false を返す。- x が Number なら、
Number::sameValueZero (x, y) を返す。
SameValueNonNumber (x, y) を返す。
SameValueZero は、
7.2.11 SameValueNonNumber ( x, y )
The
Assert :SameType (x, y) istrue .- x が
undefined またはnull のいずれかなら、true を返す。 - x が BigInt なら、
BigInt::equal (x, y) を返す。
- x が String なら、
- x と y の長さが同じであり、かつ同じ位置に同じコードユニットを持つなら、
true を返す。 false を返す。
- x と y の長さが同じであり、かつ同じ位置に同じコードユニットを持つなら、
- x が Boolean なら、
- x が
true かつ y がtrue なら、true を返す。 - x が
false かつ y がfalse なら、true を返す。 false を返す。
- x が
NOTE : 他のすべてのECMAScript 言語値 は identity によって比較される。- x is y なら、
true を返す。 false を返す。
7.2.12 IsLessThan ( x, y, leftFirst )
The
- leftFirst が
true の場合、- px を ?
ToPrimitive (x,number ) とする。 - py を ?
ToPrimitive (y,number ) とする。
- px を ?
- Else,
NOTE : 左から右への評価を保つために、評価順序を逆転させる必要がある。- py を ?
ToPrimitive (y,number ) とする。 - px を ?
ToPrimitive (x,number ) とする。
- px が String かつ py が String なら、
- lx を px の長さとする。
- ly を py の長さとする。
- 0 ≤ i <
min (lx, ly) を満たす各整数 i について、昇順で次を行う- cx を px 内の添字 i にあるコードユニットの数値とする。
- cy を py 内の添字 i にあるコードユニットの数値とする。
- cx < cy なら、
true を返す。 - cx > cy なら、
false を返す。
- lx < ly なら、
true を返す。 false を返す。
- px が BigInt かつ py が String なら、
- ny を
StringToBigInt (py) とする。 - ny が
undefined なら、undefined を返す。 BigInt::lessThan (px, ny) を返す。
- ny を
- px が String かつ py が BigInt なら、
- nx を
StringToBigInt (px) とする。 - nx が
undefined なら、undefined を返す。 BigInt::lessThan (nx, py) を返す。
- nx を
NOTE : px と py は primitive 値なので、評価順序は重要ではない。- 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 を返す。
String の比較では、UTF-16 コードユニット値の列に対する単純な辞書式順序を用いる。Unicode 仕様で定義される、より複雑で意味論指向の文字または文字列の等価性や照合順序の定義を使おうとはしない。したがって、Unicode Standard に従えば正準的に等しいが同じ正規化形式にない String 値は、不等と判定されうる。また、code unit による辞書式順序は、
7.2.13 IsLooselyEqual ( x, y )
The == 演算子の意味論を与える。 It performs the following steps when called:
SameType (x, y) がtrue なら、IsStrictlyEqual (x, y) を返す。
- x が
null かつ y がundefined なら、true を返す。 - x が
undefined かつ y がnull なら、true を返す。 - ホストがウェブブラウザであるか、または
[[IsHTMLDDA]] 内部スロット をサポートする場合、- x が Object であり、x が [[IsHTMLDDA]] 内部スロットを持ち、かつ y が
undefined またはnull のいずれかであるなら、true を返す。 - x が
undefined またはnull のいずれかであり、y が Object であり、かつ y が [[IsHTMLDDA]] 内部スロットを持つなら、true を返す。
- x が Object であり、x が [[IsHTMLDDA]] 内部スロットを持ち、かつ y が
- x が Number かつ y が String なら、!
IsLooselyEqual (x, !ToNumber (y)) を返す。 - x が String かつ y が Number なら、!
IsLooselyEqual (!ToNumber (x), y) を返す。 - x が BigInt かつ y が String なら、
- n を
StringToBigInt (y) とする。 - n が
undefined なら、false を返す。 - !
IsLooselyEqual (x, n) を返す。
- n を
- x が String かつ y が BigInt なら、!
IsLooselyEqual (y, x) を返す。 - x が Boolean なら、!
IsLooselyEqual (!ToNumber (x), y) を返す。 - y が Boolean なら、!
IsLooselyEqual (x, !ToNumber (y)) を返す。 - x が String、Number、BigInt、または Symbol のいずれかであり、かつ y が Object なら、!
IsLooselyEqual (x, ?ToPrimitive (y)) を返す。 - x が Object であり、かつ y が String、Number、BigInt、または Symbol のいずれかであるなら、!
IsLooselyEqual (?ToPrimitive (x), y) を返す。 - x が BigInt かつ y が Number、または x が Number かつ y が BigInt である場合、
false を返す。
7.2.14 IsStrictlyEqual ( x, y )
The === 演算子の意味論を与える。 It performs the following steps when called:
SameType (x, y) がfalse なら、false を返す。- x が Number なら、
Number::equal (x, y) を返す。
SameValueNonNumber (x, y) を返す。
このアルゴリズムは、符号付きゼロと NaN の扱いにおいて
7.3 Object に対する操作
7.3.1 MakeBasicObject ( internalSlotsList )
The
- internalSlotsList を、internalSlotsList と « [[PrivateElements]] » の
list-concatenation に設定する。 - obj を、internalSlotsList 内の各名前に対応する内部スロットを持つ新しく生成された object とする。
NOTE :Object 内部メソッドと内部スロット に記述されるとおり、特に規定されない限り、そのような各内部スロットの初期値はundefined である。- obj.[[PrivateElements]] を新しい空の
List に設定する。 - obj の essential internal methods を、
10.1 で規定される既定のordinary object 定義に設定する。 Assert : 呼び出し元が obj の [[GetPrototypeOf]] および [[SetPrototypeOf]] の両 essential internal method を上書きしないなら、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
- ? obj.[[Get]](propertyKey, obj) を返す。
7.3.3 GetV ( value, propertyKey )
The
- obj を ?
ToObject (value) とする。 - ? obj.[[Get]](propertyKey, value) を返す。
7.3.4 Set ( obj, propertyKey, value, throw )
The
- success を ? obj.[[Set]](propertyKey, value, obj) とする。
- success が
false かつ throw がtrue なら、TypeError 例外を throw する。 unused を返す。
7.3.5 CreateDataProperty ( obj, propertyKey, value )
The
- 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
- success を ?
CreateDataProperty (obj, propertyKey, value) とする。 - success が
false なら、TypeError 例外を throw する。 unused を返す。
この抽象操作は、その属性が ECMAScript 言語の代入演算子によって生成されるプロパティと同じ既定値に設定されたプロパティを生成する。通常、そのプロパティはまだ存在しない。もし存在していて configurable でないか、または obj が extensible でないなら、[[DefineOwnProperty]] は
7.3.7 CreateNonEnumerableDataPropertyOrThrow ( obj, propertyKey, value )
The
Assert : obj は ordinary で extensible な object であり、non-configurable なプロパティを持たない。- newDesc を PropertyDescriptor { [[Value]]: value, [[Writable]]:
true , [[Enumerable]]:false , [[Configurable]]:true } とする。 - !
DefinePropertyOrThrow (obj, propertyKey, newDesc) を実行する。 unused を返す。
この抽象操作は、その属性が ECMAScript 言語の代入演算子によって生成されるプロパティと同じ既定値に設定されるが、enumerable ではないプロパティを生成する。通常、そのプロパティはまだ存在しない。もし存在していたとしても、
7.3.8 DefinePropertyOrThrow ( obj, propertyKey, desc )
The
- success を ? obj.[[DefineOwnProperty]](propertyKey, desc) とする。
- success が
false なら、TypeError 例外を throw する。 unused を返す。
7.3.9 DeletePropertyOrThrow ( obj, propertyKey )
The
- success を ? obj.[[Delete]](propertyKey) とする。
- success が
false なら、TypeError 例外を throw する。 unused を返す。
7.3.10 GetMethod ( value, propertyKey )
The
- func を ?
GetV (value, propertyKey) とする。 - func が
undefined またはnull のいずれかであるなら、undefined を返す。 IsCallable (func) がfalse なら、TypeError 例外を throw する。- func を返す。
7.3.11 HasProperty ( obj, propertyKey )
The
- ? obj.[[HasProperty]](propertyKey) を返す。
7.3.12 HasOwnProperty ( obj, propertyKey )
The
- desc を ? obj.[[GetOwnProperty]](propertyKey) とする。
- desc が
undefined なら、false を返す。 true を返す。
7.3.13 Call ( func, thisValue [ , argumentsList ] )
The
- argumentsList が存在しないなら、argumentsList を新しい空の
List に設定する。 IsCallable (func) がfalse なら、TypeError 例外を throw する。- ? func.[[Call]](thisValue, argumentsList) を返す。
7.3.14 Construct ( constructor [ , argumentsList [ , newTarget ] ] )
The
- newTarget が存在しないなら、newTarget を constructor に設定する。
- argumentsList が存在しないなら、argumentsList を新しい空の
List に設定する。 - ? constructor.[[Construct]](argumentsList, newTarget) を返す。
newTarget が存在しない場合、この操作は new F(...argumentsList) と等価である。
7.3.15 SetIntegrityLevel ( obj, level )
The
- status を ? obj.[[PreventExtensions]]() とする。
- status が
false なら、false を返す。 - keys を ? obj.[[OwnPropertyKeys]]() とする。
- level が
sealed の場合、- keys の各要素 key について、次を行う
- ?
DefinePropertyOrThrow (obj, key, PropertyDescriptor { [[Configurable]]:false }) を実行する。
- ?
- keys の各要素 key について、次を行う
- Else,
Assert : level はfrozen である。- keys の各要素 key について、次を行う
- currentDesc を ? obj.[[GetOwnProperty]](key) とする。
- currentDesc が
undefined でないなら、IsAccessorDescriptor (currentDesc) がtrue なら、- desc を PropertyDescriptor { [[Configurable]]:
false } とする。
- desc を PropertyDescriptor { [[Configurable]]:
- Else,
- desc を PropertyDescriptor { [[Configurable]]:
false , [[Writable]]:false } とする。
- desc を PropertyDescriptor { [[Configurable]]:
- ?
DefinePropertyOrThrow (obj, key, desc) を実行する。
true を返す。
7.3.16 TestIntegrityLevel ( obj, level )
The
- extensible を ?
IsExtensible (obj) とする。 - extensible が
true なら、false を返す。 NOTE : object が 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
- array を !
ArrayCreate (0) とする。 - n を 0 とする。
- elements の各要素 e について、次を行う
- !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (n)), e) を実行する。 - n を n + 1 に設定する。
- !
- array を返す。
7.3.18 LengthOfArrayLike ( obj )
The
array-like object とは、この操作が
7.3.19 CreateListFromArrayLike ( obj [ , validElementTypes ] )
The
- validElementTypes が存在しないなら、validElementTypes を
all に設定する。 - obj が Object でないなら、
TypeError 例外を throw する。 - len を ?
LengthOfArrayLike (obj) とする。 - list を新しい空の
List とする。 - index を 0 とする。
- index < len の間、繰り返す
- indexName を !
ToString (𝔽 (index)) とする。 - next を ?
Get (obj, indexName) とする。 - validElementTypes が
property-key であり、かつ next がproperty key でないなら、TypeError 例外を throw する。 - next を list に追加する。
- index を index + 1 に設定する。
- indexName を !
- list を返す。
7.3.20 Invoke ( value, propertyKey [ , argumentsList ] )
The
7.3.21 OrdinaryHasInstance ( constructor, instance )
The
IsCallable (constructor) がfalse なら、false を返す。- constructor が [[BoundTargetFunction]] 内部スロットを持つなら、
- boundConstructor を constructor.[[BoundTargetFunction]] とする。
- ?
InstanceofOperator (instance, boundConstructor) を返す。
- instance が Object でないなら、
false を返す。 - proto を ?
Get (constructor,"prototype" ) とする。 - proto が Object でないなら、
TypeError 例外を throw する。 - 繰り返す
- instance を ? instance.[[GetPrototypeOf]]() に設定する。
- instance が
null なら、false を返す。 SameValue (proto, instance) がtrue なら、true を返す。
7.3.22 SpeciesConstructor ( obj, defaultConstructor )
The
- constructor を ?
Get (obj,"constructor" ) とする。 - constructor が
undefined なら、defaultConstructor を返す。 - constructor が Object でないなら、
TypeError 例外を throw する。 - species を ?
Get (constructor,%Symbol.species% ) とする。 - species が
undefined またはnull のいずれかなら、defaultConstructor を返す。 IsConstructor (species) がtrue なら、species を返す。TypeError 例外を throw する。
7.3.23 EnumerableOwnProperties ( obj, kind )
The
- ownKeys を ? obj.[[OwnPropertyKeys]]() とする。
- results を新しい空の
List とする。 - ownKeys の各要素 key について、次を行う
- key が String であるなら、
- desc を ? obj.[[GetOwnProperty]](key) とする。
- desc が
undefined でなく、かつ desc.[[Enumerable]] がtrue であるなら、- kind が
key なら、- key を results に追加する。
- Else,
- value を ?
Get (obj, key) とする。 - kind が
value なら、- value を results に追加する。
- Else,
Assert : kind はkey+value である。- entry を
CreateArrayFromList (« key, value ») とする。 - entry を results に追加する。
- value を ?
- kind が
- key が String であるなら、
- results を返す。
7.3.24 GetFunctionRealm ( func )
The
- func が [[Realm]] 内部スロットを持つなら、
- func.[[Realm]] を返す。
- func が bound function
exotic object なら、- boundTargetFunction を func.[[BoundTargetFunction]] とする。
- ?
GetFunctionRealm (boundTargetFunction) を返す。
- func が Proxy
exotic object なら、- ?
ValidateNonRevokedProxy (func) を実行する。 - proxyTarget を func.[[ProxyTarget]] とする。
Assert : proxyTarget はfunction object である。- ?
GetFunctionRealm (proxyTarget) を返す。
- ?
- 現在の
Realm Record を返す。
手順
7.3.25 CopyDataProperties ( target, source, excludedItems )
The
- source が
undefined またはnull のいずれかであるなら、unused を返す。 - from を !
ToObject (source) とする。 - keys を ? from.[[OwnPropertyKeys]]() とする。
- keys の各要素 nextKey について、次を行う
- excluded を
false とする。 - excludedItems の各要素 e について、次を行う
SameValue (e, nextKey) がtrue なら、- excluded を
true に設定する。
- excluded を
- excluded が
false なら、- desc を ? from.[[GetOwnProperty]](nextKey) とする。
- desc が
undefined でなく、かつ desc.[[Enumerable]] がtrue であるなら、- propValue を ?
Get (from, nextKey) とする。 - !
CreateDataPropertyOrThrow (target, nextKey, propValue) を実行する。
- propValue を ?
- excluded を
unused を返す。
ここで渡される target は、エラーが throw された場合に直接アクセスできない、新しく生成された object である。
7.3.26 PrivateElementFind ( obj, privateName )
The
- obj.[[PrivateElements]] が、pe.[[Key]] is privateName である
PrivateElement pe を含むなら、- pe を返す。
empty を返す。
7.3.27 PrivateFieldAdd ( obj, privateName, value )
The
- ホストがウェブブラウザであるなら、
- ?
HostEnsureCanAddPrivateElement (obj) を実行する。
- ?
- entry を
PrivateElementFind (obj, privateName) とする。 - entry が
empty でないなら、TypeError 例外を throw する。 PrivateElement { [[Key]]: privateName, [[Kind]]:field , [[Value]]: value } を obj.[[PrivateElements]] に追加する。unused を返す。
7.3.28 PrivateMethodOrAccessorAdd ( obj, method )
The
Assert : method.[[Kind]] はmethod またはaccessor のいずれかである。- ホストがウェブブラウザであるなら、
- ?
HostEnsureCanAddPrivateElement (obj) を実行する。
- ?
- entry を
PrivateElementFind (obj, method.[[Key]]) とする。 - entry が
empty でないなら、TypeError 例外を throw する。 - method を obj.[[PrivateElements]] に追加する。
unused を返す。
private method と accessor の値はインスタンス間で共有される。この操作は method または accessor の新しいコピーを生成しない。
7.3.29 HostEnsureCanAddPrivateElement ( obj )
The
HostEnsureCanAddPrivateElement の実装は、次の要件に適合しなければならない。
- obj が
host-defined exotic object でないなら、この抽象操作はNormalCompletion (unused ) を返し、他の手順を一切実行してはならない。 - 同じ引数でこの抽象操作を 2 回呼び出した場合、その両方は同じ種類の
Completion Record を返さなければならない。
HostEnsureCanAddPrivateElement の既定実装は
この抽象操作は、ウェブブラウザである ECMAScript ホストによってのみ呼び出される。
7.3.30 PrivateGet ( obj, privateName )
The
- 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
- entry を
PrivateElementFind (obj, privateName) とする。 - entry が
empty なら、TypeError 例外を throw する。 - entry.[[Kind]] が
method なら、TypeError 例外を throw する。 - entry.[[Kind]] が
field なら、- entry.[[Value]] を value に設定する。
- Else,
unused を返す。
7.3.32 DefineField ( receiver, fieldRecord )
The
- fieldName を fieldRecord.[[Name]] とする。
- initializer を fieldRecord.[[Initializer]] とする。
- initializer が
empty でない場合、- initValue を ?
Call (initializer, receiver) とする。
- initValue を ?
- Else,
- initValue を
undefined とする。
- initValue を
- fieldName が
Private Name なら、- ?
PrivateFieldAdd (receiver, fieldName, initValue) を実行する。
- ?
- Else,
Assert : fieldName はproperty key である。- ?
CreateDataPropertyOrThrow (receiver, fieldName, initValue) を実行する。
unused を返す。
7.3.33 InitializeInstanceElements ( obj, constructor )
The
- methods を constructor.[[PrivateMethods]] とする。
- methods 内の各
PrivateElement method について、次を行う- ?
PrivateMethodOrAccessorAdd (obj, method) を実行する。
- ?
- fields を constructor.[[Fields]] とする。
- fields の各要素 fieldRecord について、次を行う
- ?
DefineField (obj, fieldRecord) を実行する。
- ?
unused を返す。
7.3.34 AddValueToKeyedGroup ( groups, key, value )
The
7.3.35 GroupBy ( items, callback, keyCoercion )
The
- ?
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 を
- Else,
Assert : keyCoercion はcollection である。- key を
CanonicalizeKeyedCollectionKey (key) に設定する。
AddValueToKeyedGroup (groups, key, value) を実行する。- k を k + 1 に設定する。
- k ≥ 253 - 1 の場合、
7.3.36 GetOptionsObject ( options )
The
- options が
undefined の場合、OrdinaryObjectCreate (null ) を返す。
- options が Object である場合、
- options を返す。
TypeError 例外を throw する。
7.3.37 SetterThatIgnoresPrototypeProperties ( thisValue, home, propertyKey, value )
The
- thisValue が Object でない場合、
TypeError 例外を throw する。
SameValue (thisValue, home) がtrue の場合、NOTE : ここで throw することは、strict mode code における home object 上の non-writabledata property への代入を模倣する。TypeError 例外を throw する。
- desc を ? thisValue.[[GetOwnProperty]](propertyKey) とする。
- desc が
undefined の場合、- ?
CreateDataPropertyOrThrow (thisValue, propertyKey, value) を実行する。
- ?
- Else,
- ?
Set (thisValue, propertyKey, value,true ) を実行する。
- ?
unused を返す。
7.4 Iterator Object に対する操作
Common Iteration Interfaces（
7.4.1 Iterator Record
Iterator Record は、next メソッドを一緒にカプセル化するために用いられる
Iterator Record は
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Iterator]] | an Object |
|
| [[NextMethod]] | an ECMAScript language value |
[[Iterator]] object の next メソッド。
|
| [[Done]] | a Boolean |
その |
7.4.2 GetIteratorDirect ( obj )
The
- nextMethod を ?
Get (obj,"next" ) とする。 - iteratorRecord を
Iterator Record { [[Iterator]]: obj, [[NextMethod]]: nextMethod, [[Done]]:false } とする。 - iteratorRecord を返す。
7.4.3 GetIteratorFromMethod ( obj, method )
The
- iterator を ?
Call (method, obj) とする。 - iterator が Object でないなら、
TypeError 例外を throw する。 - ?
GetIteratorDirect (iterator) を返す。
7.4.4 GetIterator ( obj, kind )
The
- 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 を ?
- Else,
- method を ?
GetMethod (obj,%Symbol.iterator% ) とする。
- method を ?
- method が
undefined なら、TypeError 例外を throw する。 - ?
GetIteratorFromMethod (obj, method) を返す。
7.4.5 GetIteratorFlattenable ( obj, primitiveHandling )
The
- 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 とする。
- Else,
- iterator を ?
Call (method, obj) とする。
- iterator を ?
- iterator が Object でないなら、
TypeError 例外を throw する。 - ?
GetIteratorDirect (iterator) を返す。
7.4.6 IteratorNext ( iteratorRecord [ , value ] )
The
- value が存在しない場合、
- result を
Completion (Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]])) とする。
- result を
- Else,
- 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
7.4.8 IteratorValue ( iteratorResult )
The
- ?
Get (iteratorResult,"value" ) を返す。
7.4.9 IteratorStep ( iteratorRecord )
The
- 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
- 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
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 ( iters, completion )
The
- iters の各要素 iter について、逆順の
List 順序で次を行う- completion を
Completion (IteratorClose (iter, 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 AsyncIteratorClose ( iteratorRecord, completion )
The
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.15 IfAbruptCloseAsyncIterator ( value, iteratorRecord )
IfAbruptCloseAsyncIterator は、
IfAbruptCloseAsyncIterator (value, iteratorRecord)。
は、次と同じ意味である:
Assert : value はCompletion Record である。- value が
abrupt completion なら、?AsyncIteratorClose (iteratorRecord, value) を返す。 - value を ! value に設定する。
7.4.16 CreateIteratorResultObject ( value, done )
The
- obj を
OrdinaryObjectCreate (%Object.prototype% ) とする。 - !
CreateDataPropertyOrThrow (obj,"value" , value) を実行する。 - !
CreateDataPropertyOrThrow (obj,"done" , done) を実行する。 - obj を返す。
7.4.17 CreateListIteratorRecord ( list )
The
- closure を、新しい
Abstract Closure とする。この Closure はパラメータを持たず、list を捕捉し、呼び出されたときに次の手順を実行する:- list の各要素 value について、次を行う
- ?
GeneratorYield (CreateIteratorResultObject (value,false )) を実行する。
- ?
NormalCompletion (undefined ) を返す。
- list の各要素 value について、次を行う
- iterator を
CreateIteratorFromClosure (closure,empty ,%Iterator.prototype% ) とする。 Iterator Record { [[Iterator]]: iterator, [[NextMethod]]: %GeneratorPrototype.next%, [[Done]]:false } を返す。
list
7.4.18 IteratorToList ( iteratorRecord )
The
- values を新しい空の
List とする。 - 繰り返す
- next を ?
IteratorStepValue (iteratorRecord) とする。 - next が
done の場合、- values を返す。
- next を values に追加する。
- next を ?
8 構文指向操作
この節で定義されるものに加えて、特殊化された構文指向操作がこの仕様全体を通じて定義される。
8.1 Runtime Semantics: Evaluation
The
8.2 スコープ解析
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 を返す。
BindingIdentifier のBoundNames を返す。
BindingPattern のBoundNames を返す。
- names1 を
VariableDeclarationList のBoundNames とする。 - names2 を
VariableDeclaration のBoundNames とする。 - names1 と names2 の
list-concatenation を返す。
BindingIdentifier のBoundNames を返す。
BindingPattern のBoundNames を返す。
- 新しい空の
List を返す。
- names1 を
BindingPropertyList のBoundNames とする。 - names2 を
BindingRestProperty のBoundNames とする。 - names1 と names2 の
list-concatenation を返す。
- 新しい空の
List を返す。
BindingRestElement のBoundNames を返す。
BindingElementList のBoundNames を返す。
- 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 を返す。
BindingElement のBoundNames を返す。
BindingElement のBoundNames を返す。
BindingIdentifier のBoundNames を返す。
BindingPattern のBoundNames を返す。
ForBinding のBoundNames を返す。
BindingIdentifier の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 によって包摂されるArrowFormalParameters とする。 - formals の
BoundNames を返す。
BindingIdentifier のBoundNames を返す。
- «
"*default*" » を返す。
BindingIdentifier のBoundNames を返す。
- «
"*default*" » を返す。
BindingIdentifier のBoundNames を返す。
- «
"*default*" » を返す。
BindingIdentifier のBoundNames を返す。
- «
"*default*" » を返す。
- head を、
CoverCallExpressionAndAsyncArrowHead によって包摂されるAsyncArrowHead とする。 - head の
BoundNames を返す。
ImportClause のBoundNames を返す。
- 新しい空の
List を返す。
- names1 を
ImportedDefaultBinding のBoundNames とする。 - names2 を
NameSpaceImport のBoundNames とする。 - names1 と names2 の
list-concatenation を返す。
- names1 を
ImportedDefaultBinding のBoundNames とする。 - names2 を
NamedImports のBoundNames とする。 - names1 と names2 の
list-concatenation を返す。
- 新しい空の
List を返す。
- names1 を
ImportsList のBoundNames とする。 - names2 を
ImportSpecifier のBoundNames とする。 - names1 と names2 の
list-concatenation を返す。
ImportedBinding のBoundNames を返す。
- 新しい空の
List を返す。
VariableStatement のBoundNames を返す。
Declaration のBoundNames を返す。
- declarationNames を
HoistableDeclaration のBoundNames とする。 - declarationNames が
"*default*" という要素を含まない場合、"*default*" を declarationNames に追加する。 - declarationNames を返す。
- declarationNames を
ClassDeclaration のBoundNames とする。 - declarationNames が
"*default*" という要素を含まない場合、"*default*" を declarationNames に追加する。 - declarationNames を返す。
- «
"*default*" » を返す。
8.2.2 Static Semantics: DeclarationPart
The
FunctionDeclaration を返す。
GeneratorDeclaration を返す。
ClassDeclaration を返す。
LexicalDeclaration を返す。
8.2.3 Static Semantics: IsConstantDeclaration
The
LetOrConst のIsConstantDeclaration を返す。
false を返す。
true を返す。
false を返す。
false を返す。
false を返す。
export default
8.2.4 Static Semantics: LexicallyDeclaredNames
The
- 新しい空の
List を返す。
- names1 を
StatementList のLexicallyDeclaredNames とする。 - names2 を
StatementListItem のLexicallyDeclaredNames とする。 - names1 と names2 の
list-concatenation を返す。
Statement がStatement : LabelledStatement LabelledStatement のLexicallyDeclaredNames を返す。- 新しい空の
List を返す。
Declaration のBoundNames を返す。
- 新しい空の
List を返す。
- 最初の
CaseClauses が存在するなら、names1 を最初のCaseClauses のLexicallyDeclaredNames とする。 - Else, names1 を新しい空の
List とする。 - names2 を
DefaultClause のLexicallyDeclaredNames とする。 - 2 番目の
CaseClauses が存在するなら、names3 を 2 番目のCaseClauses のLexicallyDeclaredNames とする。 - Else, 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 を返す。
FunctionDeclaration のBoundNames を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- names1 を
ModuleItemList のLexicallyDeclaredNames とする。 - names2 を
ModuleItem のLexicallyDeclaredNames とする。 - names1 と names2 の
list-concatenation を返す。
ImportDeclaration のBoundNames を返す。
ExportDeclaration がexportVariableStatement であるなら、新しい空のList を返す。ExportDeclaration のBoundNames を返す。
8.2.5 Static Semantics: LexicallyScopedDeclarations
The
- declarations1 を
StatementList のLexicallyScopedDeclarations とする。 - declarations2 を
StatementListItem のLexicallyScopedDeclarations とする。 - declarations1 と declarations2 の
list-concatenation を返す。
Statement がStatement : LabelledStatement LabelledStatement のLexicallyScopedDeclarations を返す。- 新しい空の
List を返す。
- 唯一の要素として
Declaration のDeclarationPart を持つList を返す。
- 新しい空の
List を返す。
- 最初の
CaseClauses が存在するなら、declarations1 を最初のCaseClauses のLexicallyScopedDeclarations とする。 - Else, declarations1 を新しい空の
List とする。 - declarations2 を
DefaultClause のLexicallyScopedDeclarations とする。 - 2 番目の
CaseClauses が存在するなら、declarations3 を 2 番目のCaseClauses のLexicallyScopedDeclarations とする。 - Else, declarations3 を新しい空の
List とする。 - declarations1, declarations2, および declarations3 の
list-concatenation を返す。
- declarations1 を
CaseClauses のLexicallyScopedDeclarations とする。 - declarations2 を
CaseClause のLexicallyScopedDeclarations とする。 - declarations1 と declarations2 の
list-concatenation を返す。
StatementList が存在するなら、StatementList のLexicallyScopedDeclarations を返す。- 新しい空の
List を返す。
StatementList が存在するなら、StatementList のLexicallyScopedDeclarations を返す。- 新しい空の
List を返す。
- 新しい空の
List を返す。
- «
FunctionDeclaration » を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- declarations1 を
ModuleItemList のLexicallyScopedDeclarations とする。 - declarations2 を
ModuleItem のLexicallyScopedDeclarations とする。 - declarations1 と declarations2 の
list-concatenation を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 唯一の要素として
Declaration のDeclarationPart を持つList を返す。
- 唯一の要素として
HoistableDeclaration のDeclarationPart を持つList を返す。
- 唯一の要素として
ClassDeclaration を持つList を返す。
- 唯一の要素としてこの
ExportDeclaration を持つList を返す。
8.2.6 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 を返す。
Statement のVarDeclaredNames を返す。
Statement のVarDeclaredNames を返す。
Statement のVarDeclaredNames を返す。
Statement のVarDeclaredNames を返す。
- names1 を
VariableDeclarationList のBoundNames とする。 - names2 を
Statement のVarDeclaredNames とする。 - names1 と names2 の
list-concatenation を返す。
Statement のVarDeclaredNames を返す。
Statement のVarDeclaredNames を返す。
- names1 を
ForBinding のBoundNames とする。 - names2 を
Statement のVarDeclaredNames とする。 - names1 と names2 の
list-concatenation を返す。
この節は Annex
Statement のVarDeclaredNames を返す。
CaseBlock のVarDeclaredNames を返す。
- 新しい空の
List を返す。
- 最初の
CaseClauses が存在するなら、names1 を最初のCaseClauses のVarDeclaredNames とする。 - Else, names1 を新しい空の
List とする。 - names2 を
DefaultClause のVarDeclaredNames とする。 - 2 番目の
CaseClauses が存在するなら、names3 を 2 番目のCaseClauses のVarDeclaredNames とする。 - Else, 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 を返す。
LabelledItem のVarDeclaredNames を返す。
- 新しい空の
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 を返す。
Block のVarDeclaredNames を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- names1 を
ModuleItemList のVarDeclaredNames とする。 - names2 を
ModuleItem のVarDeclaredNames とする。 - names1 と names2 の
list-concatenation を返す。
- 新しい空の
List を返す。
ExportDeclaration がexportVariableStatement であるなら、ExportDeclaration のBoundNames を返す。- 新しい空の
List を返す。
8.2.7 Static Semantics: VarScopedDeclarations
The
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- declarations1 を
StatementList のVarScopedDeclarations とする。 - declarations2 を
StatementListItem のVarScopedDeclarations とする。 - declarations1 と declarations2 の
list-concatenation を返す。
- 新しい空の
List を返す。
- «
VariableDeclaration » を返す。
- declarations1 を
VariableDeclarationList のVarScopedDeclarations とする。 - declarations1 と «
VariableDeclaration » のlist-concatenation を返す。
- declarations1 を最初の
Statement のVarScopedDeclarations とする。 - declarations2 を 2 番目の
Statement のVarScopedDeclarations とする。 - declarations1 と declarations2 の
list-concatenation を返す。
Statement のVarScopedDeclarations を返す。
Statement のVarScopedDeclarations を返す。
Statement のVarScopedDeclarations を返す。
Statement のVarScopedDeclarations を返す。
- declarations1 を
VariableDeclarationList のVarScopedDeclarations とする。 - declarations2 を
Statement のVarScopedDeclarations とする。 - declarations1 と declarations2 の
list-concatenation を返す。
Statement のVarScopedDeclarations を返す。
Statement のVarScopedDeclarations を返す。
- declarations1 を «
ForBinding » とする。 - declarations2 を
Statement のVarScopedDeclarations とする。 - declarations1 と declarations2 の
list-concatenation を返す。
この節は Annex
Statement のVarScopedDeclarations を返す。
CaseBlock のVarScopedDeclarations を返す。
- 新しい空の
List を返す。
- 最初の
CaseClauses が存在するなら、declarations1 を最初のCaseClauses のVarScopedDeclarations とする。 - Else, declarations1 を新しい空の
List とする。 - declarations2 を
DefaultClause のVarScopedDeclarations とする。 - 2 番目の
CaseClauses が存在するなら、declarations3 を 2 番目のCaseClauses のVarScopedDeclarations とする。 - Else, declarations3 を新しい空の
List とする。 - declarations1, declarations2, および declarations3 の
list-concatenation を返す。
- declarations1 を
CaseClauses のVarScopedDeclarations とする。 - declarations2 を
CaseClause のVarScopedDeclarations とする。 - declarations1 と declarations2 の
list-concatenation を返す。
StatementList が存在するなら、StatementList のVarScopedDeclarations を返す。- 新しい空の
List を返す。
StatementList が存在するなら、StatementList のVarScopedDeclarations を返す。- 新しい空の
List を返す。
- 新しい空の
List を返す。
- declarations1 を
Block のVarScopedDeclarations とする。 - declarations2 を
Catch のVarScopedDeclarations とする。 - declarations1 と declarations2 の
list-concatenation を返す。
- declarations1 を
Block のVarScopedDeclarations とする。 - declarations2 を
Finally のVarScopedDeclarations とする。 - declarations1 と declarations2 の
list-concatenation を返す。
- declarations1 を
Block のVarScopedDeclarations とする。 - declarations2 を
Catch のVarScopedDeclarations とする。 - declarations3 を
Finally のVarScopedDeclarations とする。 - declarations1, declarations2, および declarations3 の
list-concatenation を返す。
Block のVarScopedDeclarations を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- 新しい空の
List を返す。
- declarations1 を
ModuleItemList のVarScopedDeclarations とする。 - declarations2 を
ModuleItem のVarScopedDeclarations とする。 - declarations1 と declarations2 の
list-concatenation を返す。
- 新しい空の
List を返す。
ExportDeclaration がexportVariableStatement であるなら、VariableStatement のVarScopedDeclarations を返す。- 新しい空の
List を返す。
8.2.8 Static Semantics: TopLevelLexicallyDeclaredNames
The
- names1 を
StatementList のTopLevelLexicallyDeclaredNames とする。 - names2 を
StatementListItem のTopLevelLexicallyDeclaredNames とする。 - names1 と names2 の
list-concatenation を返す。
- 新しい空の
List を返す。
Declaration がDeclaration : HoistableDeclaration - 新しい空の
List を返す。
- 新しい空の
Declaration のBoundNames を返す。
function または script のトップレベルでは、function 宣言は lexical 宣言ではなく var 宣言のように扱われる。
8.2.9 Static Semantics: TopLevelLexicallyScopedDeclarations
The
- declarations1 を
StatementList のTopLevelLexicallyScopedDeclarations とする。 - declarations2 を
StatementListItem のTopLevelLexicallyScopedDeclarations とする。 - declarations1 と declarations2 の
list-concatenation を返す。
- 新しい空の
List を返す。
Declaration がDeclaration : HoistableDeclaration - 新しい空の
List を返す。
- 新しい空の
- «
Declaration » を返す。
8.2.10 Static Semantics: TopLevelVarDeclaredNames
The
- names1 を
StatementList のTopLevelVarDeclaredNames とする。 - names2 を
StatementListItem のTopLevelVarDeclaredNames とする。 - names1 と names2 の
list-concatenation を返す。
Declaration がDeclaration : HoistableDeclaration HoistableDeclaration のBoundNames を返す。
- 新しい空の
List を返す。
Statement がStatement : LabelledStatement Statement のTopLevelVarDeclaredNames を返す。Statement のVarDeclaredNames を返す。
function または script のトップレベルでは、内側の function 宣言は var 宣言のように扱われる。
Statement がStatement : LabelledStatement Statement のTopLevelVarDeclaredNames を返す。Statement のVarDeclaredNames を返す。
FunctionDeclaration のBoundNames を返す。
8.2.11 Static Semantics: TopLevelVarScopedDeclarations
The
- declarations1 を
StatementList のTopLevelVarScopedDeclarations とする。 - declarations2 を
StatementListItem のTopLevelVarScopedDeclarations とする。 - declarations1 と declarations2 の
list-concatenation を返す。
Statement がStatement : LabelledStatement Statement のTopLevelVarScopedDeclarations を返す。Statement のVarScopedDeclarations を返す。
Declaration がDeclaration : HoistableDeclaration - declaration を
HoistableDeclaration のDeclarationPart とする。 - « declaration » を返す。
- declaration を
- 新しい空の
List を返す。
Statement がStatement : LabelledStatement Statement のTopLevelVarScopedDeclarations を返す。Statement のVarScopedDeclarations を返す。
- «
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 によって包摂されるParenthesizedExpression とする。 - expr の
IsFunctionDefinition がfalse なら、false を返す。 - expr の
HasName を返す。
false を返す。
true を返す。
8.4.2 Static Semantics: IsFunctionDefinition
The
- expr を、
CoverParenthesizedExpressionAndArrowParameterList によって包摂されるParenthesizedExpression とする。 - expr の
IsFunctionDefinition を返す。
false を返す。
true を返す。
8.4.3 Static Semantics: IsAnonymousFunctionDefinition ( expr )
The
- 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 によって包摂されるParenthesizedExpression とする。 - 引数 name を伴う expr の
NamedEvaluation を ? 返す。
Assert :IsAnonymousFunctionDefinition (Expression ) istrue .- 引数 name を伴う
Expression のNamedEvaluation を ? 返す。
- 引数 name を伴う
FunctionExpression のInstantiateOrdinaryFunctionExpression を返す。
- 引数 name を伴う
GeneratorExpression のInstantiateGeneratorFunctionExpression を返す。
- 引数 name を伴う
AsyncGeneratorExpression のInstantiateAsyncGeneratorFunctionExpression を返す。
- 引数 name を伴う
AsyncFunctionExpression のInstantiateAsyncFunctionExpression を返す。
- 引数 name を伴う
ArrowFunction のInstantiateArrowFunctionExpression を返す。
- 引数 name を伴う
AsyncArrowFunction のInstantiateAsyncArrowFunctionExpression を返す。
- sourceText を
ClassExpression に一致したソーステキストとする。 - 引数
undefined , name, および sourceText を伴うClassTail のClassDefinitionEvaluation を ? 返す。
8.5 Contains
8.5.1 Static Semantics: Contains
The
この仕様において、以下に列挙されていないすべての文法生成規則の選択肢は、暗黙に次の既定の Contains 定義を持つ:
- この
Parse Node の各子ノード child について、次を行う- child が symbol のインスタンスであるなら、
true を返す。 - child が非終端記号のインスタンスであるなら、
- contained を child
Contains symbol の結果とする。 - contained が
true なら、true を返す。
- contained を child
- child が symbol のインスタンスであるなら、
false を返す。
false を返す。
部分構造に依存する静的意味規則は、一般に関数定義の内部を見ない。
- symbol が
ClassBody なら、true を返す。 - symbol が
ClassHeritage なら、ClassHeritage が存在するなら、true を返す。false を返す。
ClassHeritage が存在するなら、ClassHeritage Contains symbol がtrue なら、true を返す。
- 引数 symbol を伴う
ClassBody のComputedPropertyContains の結果を返す。
部分構造に依存する静的意味規則は、一般に
false を返す。
部分構造に依存する静的意味規則は、一般に static 初期化ブロックの内部を見ない。
- symbol が
NewTarget ,SuperProperty ,SuperCall ,super, またはthisのいずれでもないなら、false を返す。 ArrowParameters Contains symbol がtrue なら、true を返す。ConciseBody Contains symbol を返す。
- formals を、
CoverParenthesizedExpressionAndArrowParameterList によって包摂されるArrowFormalParameters とする。 - formals
Contains symbol を返す。
- symbol が
NewTarget ,SuperProperty ,SuperCall ,super, またはthisのいずれでもないなら、false を返す。 AsyncConciseBody Contains symbol を返す。
- symbol が
NewTarget ,SuperProperty ,SuperCall ,super, またはthisのいずれでもないなら、false を返す。 - head を、
CoverCallExpressionAndAsyncArrowHead によって包摂されるAsyncArrowHead とする。 - head
Contains symbol がtrue なら、true を返す。 AsyncConciseBody Contains symbol を返す。
Contains は、new.target, this, および super の使用を検出するために使われる。
- symbol が
MethodDefinition なら、true を返す。 - 引数 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
- 引数 env および privateEnv を伴う
FunctionDeclaration のInstantiateOrdinaryFunctionObject を返す。
- 引数 env および privateEnv を伴う
GeneratorDeclaration のInstantiateGeneratorFunctionObject を返す。
- 引数 env および privateEnv を伴う
AsyncGeneratorDeclaration のInstantiateAsyncGeneratorFunctionObject を返す。
- 引数 env および privateEnv を伴う
AsyncFunctionDeclaration のInstantiateAsyncFunctionObject を返す。
8.6.2 Runtime Semantics: BindingInitialization
The
It is defined piecewise over the following productions:
- name を
Identifier のStringValue とする。 - ?
InitializeBoundName (name, value, environment) を返す。
- ?
InitializeBoundName ("yield" , value, environment) を返す。
- ?
InitializeBoundName ("await" , value, environment) を返す。
- ?
RequireObjectCoercible (value) を実行する。 - 引数 value および environment を伴う
ObjectBindingPattern のBindingInitialization を ? 返す。
- iteratorRecord を ?
GetIterator (value,sync ) とする。 - result を、引数 iteratorRecord および environment を伴う
ArrayBindingPattern のIteratorBindingInitialization のCompletion とする。 - iteratorRecord.[[Done]] が
false なら、?IteratorClose (iteratorRecord, result) を返す。 - ? result を返す。
unused を返す。
- 引数 value および environment を伴う
BindingPropertyList のPropertyBindingInitialization を ? 実行する。 unused を返す。
- excludedNames を新しい空の
List とする。 - 引数 value, environment, および excludedNames を伴う
BindingRestProperty のRestBindingInitialization を ? 返す。
- excludedNames を、引数 value および environment を伴う
BindingPropertyList のPropertyBindingInitialization の ? とする。 - 引数 value, environment, および excludedNames を伴う
BindingRestProperty のRestBindingInitialization を ? 返す。
8.6.2.1 InitializeBoundName ( name, value, environment )
The
- environment が
undefined でない場合、- ! environment.
InitializeBinding (name, value) を実行する。 unused を返す。
- ! environment.
- lhs を ?
ResolveBinding (name) とする。 - ?
PutValue (lhs, value) を返す。
8.6.3 Runtime Semantics: IteratorBindingInitialization
The
environment に
It is defined piecewise over the following productions:
unused を返す。
- 引数 iteratorRecord を伴う
Elision のIteratorDestructuringAssignmentEvaluation を ? 返す。
Elision が存在するなら、- 引数 iteratorRecord を伴う
Elision のIteratorDestructuringAssignmentEvaluation を ? 実行する。
- 引数 iteratorRecord を伴う
- 引数 iteratorRecord および environment を伴う
BindingRestElement のIteratorBindingInitialization を ? 返す。
- 引数 iteratorRecord および environment を伴う
BindingElementList のIteratorBindingInitialization を ? 実行する。 - 引数 iteratorRecord を伴う
Elision のIteratorDestructuringAssignmentEvaluation を ? 返す。
- 引数 iteratorRecord および environment を伴う
BindingElementList のIteratorBindingInitialization を ? 実行する。 Elision が存在するなら、- 引数 iteratorRecord を伴う
Elision のIteratorDestructuringAssignmentEvaluation を ? 実行する。
- 引数 iteratorRecord を伴う
- 引数 iteratorRecord および environment を伴う
BindingRestElement のIteratorBindingInitialization を ? 返す。
- 引数 iteratorRecord および environment を伴う
BindingElementList のIteratorBindingInitialization を ? 実行する。 - 引数 iteratorRecord および environment を伴う
BindingElisionElement のIteratorBindingInitialization を ? 返す。
- 引数 iteratorRecord を伴う
Elision のIteratorDestructuringAssignmentEvaluation を ? 実行する。 - 引数 iteratorRecord および environment を伴う
BindingElement のIteratorBindingInitialization を ? 返す。
- bindingId を
BindingIdentifier のStringValue とする。 - lhs を ?
ResolveBinding (bindingId, environment) とする。 - v を
undefined とする。 - iteratorRecord.[[Done]] が
false なら、- next を ?
IteratorStepValue (iteratorRecord) とする。 - next が
done でないなら、- v を next に設定する。
- next を ?
Initializer が存在し、かつ v がundefined であるなら、IsAnonymousFunctionDefinition (Initializer ) がtrue なら、- 引数 bindingId を伴う
Initializer のNamedEvaluation を ? v に設定する。
- 引数 bindingId を伴う
- Else,
- defaultValue を
Initializer の ?Evaluation とする。 - v を ?
GetValue (defaultValue) に設定する。
- defaultValue を
- environment が
undefined なら、?PutValue (lhs, v) を返す。 - ?
InitializeReferencedBinding (lhs, v) を返す。
- v を
undefined とする。 - iteratorRecord.[[Done]] が
false なら、- next を ?
IteratorStepValue (iteratorRecord) とする。 - next が
done でないなら、- v を next に設定する。
- next を ?
Initializer が存在し、かつ v がundefined であるなら、- defaultValue を
Initializer の ?Evaluation とする。 - v を ?
GetValue (defaultValue) に設定する。
- defaultValue を
- 引数 v および environment を伴う
BindingPattern のBindingInitialization を ? 返す。
- lhs を ?
ResolveBinding (BindingIdentifier のStringValue , environment) とする。 - array を !
ArrayCreate (0) とする。 - n を 0 とする。
- 繰り返す
- next を
done とする。 - iteratorRecord.[[Done]] が
false なら、- next を ?
IteratorStepValue (iteratorRecord) に設定する。
- next を ?
- next が
done なら、- environment が
undefined なら、?PutValue (lhs, array) を返す。 - ?
InitializeReferencedBinding (lhs, array) を返す。
- environment が
- !
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 および environment を伴う
BindingPattern のBindingInitialization を ? 返す。
- 引数 array および environment を伴う
- !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (n)), next) を実行する。 - n を n + 1 に設定する。
- next を
unused を返す。
- 引数 iteratorRecord および environment を伴う
FormalParameterList のIteratorBindingInitialization を ? 実行する。 - 引数 iteratorRecord および environment を伴う
FunctionRestParameter のIteratorBindingInitialization を ? 返す。
- 引数 iteratorRecord および environment を伴う
FormalParameterList のIteratorBindingInitialization を ? 実行する。 - 引数 iteratorRecord および environment を伴う
FormalParameter のIteratorBindingInitialization を ? 返す。
- v を
undefined とする。 Assert : iteratorRecord.[[Done]] isfalse .- next を ?
IteratorStepValue (iteratorRecord) とする。 - next が
done でないなら、- v を next に設定する。
- 引数 v および environment を伴う
BindingIdentifier のBindingInitialization を ? 返す。
- formals を、
CoverParenthesizedExpressionAndArrowParameterList によって包摂されるArrowFormalParameters とする。 - 引数 iteratorRecord および environment を伴う formals の
IteratorBindingInitialization を ? 返す。
- v を
undefined とする。 Assert : iteratorRecord.[[Done]] isfalse .- next を ?
IteratorStepValue (iteratorRecord) とする。 - next が
done でないなら、- v を next に設定する。
- 引数 v および environment を伴う
BindingIdentifier のBindingInitialization を ? 返す。
8.6.4 Static Semantics: AssignmentTargetType
The
IsStrict (thisIdentifierReference ) がtrue であり、かつIdentifier のStringValue が"eval" または"arguments" のいずれかであるなら、invalid を返す。simple を返す。
simple を返す。
- expr を、
CoverParenthesizedExpressionAndArrowParameterList によって包摂されるParenthesizedExpression とする。 - expr の
AssignmentTargetType を返す。
- ホストがウェブブラウザであるか、または
関数呼び出し代入ターゲットに対する実行時エラー をサポートし、かつIsStrict (thisCallExpression ) がfalse であるなら、web-compat を返す。
invalid を返す。
invalid を返す。
8.6.5 Static Semantics: PropName
The
IdentifierReference のStringValue を返す。
empty を返す。
PropertyName のPropName を返す。
IdentifierName のStringValue を返す。
StringLiteral のSV を返す。
- nbr を
NumericLiteral のNumericValue とする。 - !
ToString (nbr) を返す。
empty を返す。
ClassElementName のPropName を返す。
ClassElementName のPropName を返す。
ClassElementName のPropName を返す。
empty を返す。
empty を返す。
ClassElementName のPropName を返す。
ClassElementName のPropName を返す。
empty を返す。
9 実行可能コードと実行コンテキスト
9.1 Environment Record
Environment Record は、ECMAScript コードのレキシカルな入れ子構造に基づいて、
すべての Environment Record は [[OuterEnv]] フィールドを持ち、その値は
Environment Record は純粋に仕様上の仕組みであり、ECMAScript 実装のいかなる特定の実体にも対応する必要はない。ECMAScript プログラムがそのような値に直接アクセスしたり操作したりすることは不可能である。
9.1.1 Environment Record 型階層
-
-
Declarative Environment Record は、FunctionDeclaration 、VariableDeclaration 、Catch 節など、識別子束縛をECMAScript 言語値 と直接結び付ける ECMAScript 言語の構文要素の効果を定義するために用いられる。-
Function Environment Record は ECMAScript 関数オブジェクトの呼び出しに対応し、その関数内のトップレベル宣言の束縛を含む。新しいthis束縛を確立する場合がある。また、superメソッド呼び出しをサポートするために必要な状態も保持する。 -
Module Environment Record はModule のトップレベル宣言の束縛を含む。また、Module によって明示的に import された束縛も含む。その [[OuterEnv]] はGlobal Environment Record である。
-
-
Object Environment Record は、WithStatement など、識別子束縛を何らかのオブジェクトのプロパティと関連付ける ECMAScript 要素の効果を定義するために用いられる。 -
Global Environment Record はScript のグローバル宣言に使用される。これは外側環境を持たず、その [[OuterEnv]] はnull である。識別子束縛で事前に埋められている場合があり、また、関連付けられたグローバルオブジェクト を含み、そのプロパティがグローバル環境の識別子束縛の一部を提供する。ECMAScript コードが実行されるにつれ、追加のプロパティがグローバルオブジェクト に追加されることがあり、初期プロパティは変更され得る。
-
| メソッド | 目的 | 定義 |
|---|---|---|
| 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 束縛を確立するかを判定する。確立するなら |
これは次の型に具象定義を持つ:
|
| GetThisBinding ( ) | The abstract method GetThisBinding takes no arguments and returns either a this 束縛の値を返す。this 束縛が初期化されていなければ |
これは次の型に具象定義を持つ:
|
| HasSuperBinding ( ) | The abstract method HasSuperBinding takes no arguments and returns a Boolean. これはsuper メソッド束縛を確立するかを判定する。確立するなら |
これは次の型に具象定義を持つ:
|
| WithBaseObject ( ) | The abstract method WithBaseObject takes no arguments and returns an Object or with 文に関連付けられているなら、with オブジェクトを返す。そうでなければ |
これは次の型に具象定義を持つ:
|
9.1.1.1 Declarative Environment Record
各 Declarative Environment Record は、変数、定数、let、class、module、import、および／または function 宣言を含む ECMAScript プログラムスコープに関連付けられる。Declarative Environment Record は、そのスコープ内に含まれる宣言によって定義される識別子の集合を束縛する。
9.1.1.1.1 HasBinding ( name )
The
- envRec が name に対する束縛を持つなら、
true を返す。 false を返す。
9.1.1.1.2 CreateMutableBinding ( name, deletable )
The
Assert : envRec は name に対する束縛をまだ持っていない。- envRec 内に name に対する可変束縛を作成し、それが未初期化であることを記録する。deletable が
true なら、新たに作成された束縛が後続のDeleteBinding 呼出しによって削除され得ることを記録する。 unused を返す。
9.1.1.1.3 CreateImmutableBinding ( name, strict )
The
Assert : envRec は name に対する束縛をまだ持っていない。- envRec 内に name に対する不変束縛を作成し、それが未初期化であることを記録する。strict が
true なら、新たに作成された束縛が strict 束縛であることを記録する。 unused を返す。
9.1.1.1.4 InitializeBinding ( name, value )
The
Assert : envRec は name に対する未初期化束縛を持っていなければならない。- envRec 内の name に対する束縛値を value に設定する。
- envRec 内の name に対する束縛が初期化済みになったことを
記録する 。 unused を返す。
9.1.1.1.5 SetMutableBinding ( name, value, strict )
The
- envRec が name に対する束縛を持たないなら、
- strict が
true なら、ReferenceError 例外を送出する。 - !envRec.
CreateMutableBinding (name,true ) を実行する。 - !envRec.
InitializeBinding (name, value) を実行する。 unused を返す。
- strict が
- envRec 内の name に対する束縛が strict 束縛であるなら、strict を
true に設定する。 - envRec 内の name に対する束縛がまだ初期化されていないなら、
ReferenceError 例外を送出する。
- Else if envRec 内の name に対する束縛が可変束縛であるなら、
- その束縛値を value に変更する。
- Else,
Assert : これは不変束縛の値を変更しようとする試みである。- strict が
true なら、TypeError 例外を送出する。
unused を返す。
手順
function f() { eval("var x; x = (delete x, 0);"); }9.1.1.1.6 GetBindingValue ( name, strict )
The
Assert : envRec は name に対する束縛を持つ。- envRec 内の name に対する束縛が未初期化束縛であるなら、
ReferenceError 例外を送出する。 - envRec 内で現在 name に束縛されている値を返す。
9.1.1.1.7 DeleteBinding ( name )
The
Assert : envRec は name に対する束縛を持つ。- envRec 内の name に対する束縛が削除できないなら、
false を返す。 - envRec から name に対する束縛を除去する。
true を返す。
9.1.1.1.8 HasThisBinding ( )
The
false を返す。
通常の this 束縛を提供しない。
9.1.1.1.9 GetThisBinding ( )
9.1.1.1.10 HasSuperBinding ( )
The
false を返す。
通常の super 束縛を提供しない。
9.1.1.1.11 WithBaseObject ( )
The
undefined を返す。
9.1.1.2 Object Environment Record
各 Object Environment Record は、その束縛オブジェクトと呼ばれるオブジェクトに関連付けられる。Object Environment Record は、その束縛オブジェクトのプロパティ名に直接対応する文字列識別子名の集合を束縛する。
with 文（
Object Environment Record は、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[BindingObject]] | an Object |
この |
| [[IsWithEnvironment]] | a Boolean |
この with 文のために作成されたかどうかを示す。
|
9.1.1.2.1 HasBinding ( name )
The
- bindingObject を envRec.[[BindingObject]] とする。
- foundBinding を ?
HasProperty (bindingObject, name) とする。 - foundBinding が
false なら、false を返す。 - envRec.[[IsWithEnvironment]] が
false なら、true を返す。 - unscopables を ?
Get (bindingObject,%Symbol.unscopables% ) とする。 - unscopables が Object なら、
true を返す。
9.1.1.2.2 CreateMutableBinding ( name, deletable )
The
- bindingObject を envRec.[[BindingObject]] とする。
- ?
DefinePropertyOrThrow (bindingObject, name, PropertyDescriptor { [[Value]]:undefined , [[Writable]]:true , [[Enumerable]]:true , [[Configurable]]: deletable }) を実行する。 unused を返す。
通常、envRec は name に対する束縛を持たないが、もし持っている場合、
9.1.1.2.3 CreateImmutableBinding ( name, strict )
9.1.1.2.4 InitializeBinding ( name, value )
The
- ? envRec.
SetMutableBinding (name, value,false ) を実行する。 unused を返す。
この仕様では、
9.1.1.2.5 SetMutableBinding ( name, value, strict )
The
- bindingObject を envRec.[[BindingObject]] とする。
- stillExists を ?
HasProperty (bindingObject, name) とする。 - stillExists が
false かつ strict がtrue なら、ReferenceError 例外を送出する。 - ?
Set (bindingObject, name, value, strict) を実行する。 unused を返す。
9.1.1.2.6 GetBindingValue ( name, strict )
The
- bindingObject を envRec.[[BindingObject]] とする。
- value を ?
HasProperty (bindingObject, name) とする。 - value が
false なら、- strict が
false なら、undefined を返す。 ReferenceError 例外を送出する。
- strict が
- ?
Get (bindingObject, name) を返す。
9.1.1.2.7 DeleteBinding ( name )
The
- bindingObject を envRec.[[BindingObject]] とする。
- ? bindingObject.[[Delete]](name) を返す。
9.1.1.2.8 HasThisBinding ( )
The
false を返す。
this 束縛を提供しない。
9.1.1.2.9 GetThisBinding ( )
9.1.1.2.10 HasSuperBinding ( )
The
false を返す。
super 束縛を提供しない。
9.1.1.2.11 WithBaseObject ( )
The
- envRec.[[IsWithEnvironment]] が
true なら、envRec.[[BindingObject]] を返す。 undefined を返す。
9.1.1.3 Function Environment Record
Function Environment Record は、関数のトップレベルスコープを表すために用いられる this 束縛を提供する。関数が super を参照する場合、その Function Environment Record には、関数内からの super メソッド呼出しを実行するために使われる状態も含まれる。
Function Environment Record は、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[ThisValue]] | an ECMAScript language value |
これは、この関数呼出しに用いられる |
| [[ThisBindingStatus]] |
|
値が |
| [[FunctionObject]] |
an ECMAScript |
この |
| [[NewTarget]] |
a |
この |
Function Environment Record は、
9.1.1.3.1 BindThisValue ( envRec, value )
The
Assert : envRec.[[ThisBindingStatus]] is notlexical .- envRec.[[ThisBindingStatus]] が
initialized なら、ReferenceError 例外を送出する。 - envRec.[[ThisValue]] を value に設定する。
- envRec.[[ThisBindingStatus]] を
initialized に設定する。 unused を返す。
9.1.1.3.2 HasThisBinding ( )
The
- envRec.[[ThisBindingStatus]] が
lexical なら、false を返す。 true を返す。
9.1.1.3.3 GetThisBinding ( )
The
Assert : envRec.[[ThisBindingStatus]] is notlexical .- envRec.[[ThisBindingStatus]] が
uninitialized なら、ReferenceError 例外を送出する。 - envRec.[[ThisValue]] を返す。
9.1.1.3.4 HasSuperBinding ( )
The
- envRec.[[ThisBindingStatus]] が
lexical なら、false を返す。 - envRec.[[FunctionObject]].[[HomeObject]] が
undefined なら、false を返す。 true を返す。
9.1.1.3.5 GetSuperBase ( envRec )
The super プロパティアクセスの基底となるオブジェクトを返す。値
- home を envRec.[[FunctionObject]].[[HomeObject]] とする。
- home が
undefined なら、undefined を返す。 Assert : home はordinary object である。- ! home.[[GetPrototypeOf]]() を返す。
9.1.1.4 Global Environment Record
Global Environment Record は、共通の
Global Environment Record は論理的には単一のレコードだが、
プロパティは
Global Environment Record は、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[ObjectRecord]] |
an |
束縛オブジェクトは |
| [[GlobalThisValue]] | an Object |
グローバルスコープにおいて this が返す値。ホストは任意の ECMAScript Object 値を提供できる。
|
| [[DeclarativeRecord]] |
a |
関連する |
9.1.1.4.1 HasBinding ( name )
The
- declarativeRecord を envRec.[[DeclarativeRecord]] とする。
- !declarativeRecord.
HasBinding (name) がtrue なら、true を返す。 - objectRecord を envRec.[[ObjectRecord]] とする。
- ? objectRecord.
HasBinding (name) を返す。
9.1.1.4.2 CreateMutableBinding ( name, deletable )
The
- declarativeRecord を envRec.[[DeclarativeRecord]] とする。
- !declarativeRecord.
HasBinding (name) がtrue なら、TypeError 例外を送出する。 - !declarativeRecord.
CreateMutableBinding (name, deletable) を返す。
9.1.1.4.3 CreateImmutableBinding ( name, strict )
The
- declarativeRecord を envRec.[[DeclarativeRecord]] とする。
- !declarativeRecord.
HasBinding (name) がtrue なら、TypeError 例外を送出する。 - !declarativeRecord.
CreateImmutableBinding (name, strict) を返す。
9.1.1.4.4 InitializeBinding ( name, value )
The
- declarativeRecord を envRec.[[DeclarativeRecord]] とする。
- !declarativeRecord.
HasBinding (name) がtrue なら、- !declarativeRecord.
InitializeBinding (name, value) を返す。
- !declarativeRecord.
Assert : 束縛が存在するなら、それはObject Environment Record 内になければならない。- objectRecord を envRec.[[ObjectRecord]] とする。
- ? objectRecord.
InitializeBinding (name, value) を返す。
9.1.1.4.5 SetMutableBinding ( name, value, strict )
The
- declarativeRecord を envRec.[[DeclarativeRecord]] とする。
- !declarativeRecord.
HasBinding (name) がtrue なら、- ? declarativeRecord.
SetMutableBinding (name, value, strict) を返す。
- ? declarativeRecord.
- objectRecord を envRec.[[ObjectRecord]] とする。
- ? objectRecord.
SetMutableBinding (name, value, strict) を返す。
9.1.1.4.6 GetBindingValue ( name, strict )
The
- declarativeRecord を envRec.[[DeclarativeRecord]] とする。
- !declarativeRecord.
HasBinding (name) がtrue なら、- ? declarativeRecord.
GetBindingValue (name, strict) を返す。
- ? declarativeRecord.
- objectRecord を envRec.[[ObjectRecord]] とする。
- ? objectRecord.
GetBindingValue (name, strict) を返す。
9.1.1.4.7 DeleteBinding ( name )
The
- declarativeRecord を envRec.[[DeclarativeRecord]] とする。
- !declarativeRecord.
HasBinding (name) がtrue なら、- !declarativeRecord.
DeleteBinding (name) を返す。
- !declarativeRecord.
- objectRecord を envRec.[[ObjectRecord]] とする。
- globalObject を objectRecord.[[BindingObject]] とする。
- existingProp を ?
HasOwnProperty (globalObject, name) とする。 - existingProp が
true なら、- ? objectRecord.
DeleteBinding (name) を返す。
- ? objectRecord.
true を返す。
9.1.1.4.8 HasThisBinding ( )
The
true を返す。
this 束縛を提供する。
9.1.1.4.9 GetThisBinding ( )
The
- envRec.[[GlobalThisValue]] を返す。
9.1.1.4.10 HasSuperBinding ( )
The
false を返す。
super 束縛を提供しない。
9.1.1.4.11 WithBaseObject ( )
The
undefined を返す。
9.1.1.4.12 HasLexicalDeclaration ( envRec, name )
The
- declarativeRecord を envRec.[[DeclarativeRecord]] とする。
- !declarativeRecord.
HasBinding (name) を返す。
9.1.1.4.13 HasRestrictedGlobalProperty ( envRec, name )
The
- objectRecord を envRec.[[ObjectRecord]] とする。
- globalObject を objectRecord.[[BindingObject]] とする。
- existingProp を ? globalObject.[[GetOwnProperty]](name) とする。
- existingProp が
undefined なら、false を返す。 - existingProp.[[Configurable]] が
true なら、false を返す。 true を返す。
9.1.1.4.14 CanDeclareGlobalVar ( envRec, name )
The
- objectRecord を envRec.[[ObjectRecord]] とする。
- globalObject を objectRecord.[[BindingObject]] とする。
- hasProperty を ?
HasOwnProperty (globalObject, name) とする。 - hasProperty が
true なら、true を返す。 - ?
IsExtensible (globalObject) を返す。
9.1.1.4.15 CanDeclareGlobalFunction ( envRec, name )
The
- objectRecord を envRec.[[ObjectRecord]] とする。
- globalObject を objectRecord.[[BindingObject]] とする。
- existingProp を ? globalObject.[[GetOwnProperty]](name) とする。
- existingProp が
undefined なら、?IsExtensible (globalObject) を返す。 - existingProp.[[Configurable]] が
true なら、true を返す。 IsDataDescriptor (existingProp) がtrue で、かつ existingProp が属性値 { [[Writable]]:true , [[Enumerable]]:true } を持つなら、true を返す。false を返す。
9.1.1.4.16 CreateGlobalVarBinding ( envRec, name, deletable )
The
- objectRecord を envRec.[[ObjectRecord]] とする。
- globalObject を objectRecord.[[BindingObject]] とする。
- hasProperty を ?
HasOwnProperty (globalObject, name) とする。 - extensible を ?
IsExtensible (globalObject) とする。 - hasProperty が
false かつ extensible がtrue なら、- ? objectRecord.
CreateMutableBinding (name, deletable) を実行する。 - ? objectRecord.
InitializeBinding (name,undefined ) を実行する。
- ? objectRecord.
unused を返す。
9.1.1.4.17 CreateGlobalFunctionBinding ( envRec, name, value, deletable )
The
- objectRecord を envRec.[[ObjectRecord]] とする。
- globalObject を objectRecord.[[BindingObject]] とする。
- existingProp を ? globalObject.[[GetOwnProperty]](name) とする。
- existingProp が
undefined または existingProp.[[Configurable]] がtrue なら、- desc を PropertyDescriptor { [[Value]]: value, [[Writable]]:
true , [[Enumerable]]:true , [[Configurable]]: deletable } とする。
- desc を PropertyDescriptor { [[Value]]: value, [[Writable]]:
- Else,
- desc を PropertyDescriptor { [[Value]]: value } とする。
- ?
DefinePropertyOrThrow (globalObject, name, desc) を実行する。 - ?
Set (globalObject, name, value,false ) を実行する。 unused を返す。
グローバル関数宣言は常に
9.1.1.5 Module Environment Record
Module Environment Record は、ECMAScript
Module Environment Record は、
9.1.1.5.1 GetBindingValue ( name, strict )
The
Assert : strict istrue .Assert : envRec has a binding for name.- name に対する束縛が間接束縛であるなら、
- module と targetName を、この name に対する束縛が作成されたときに与えられた間接参照値とする。
- targetEnv を module.[[Environment]] とする。
- targetEnv が
empty なら、ReferenceError 例外を送出する。 - ? targetEnv.
GetBindingValue (targetName,true ) を返す。
- envRec 内の name に対する束縛が未初期化束縛であるなら、
ReferenceError 例外を送出する。 - envRec 内で現在 name に束縛されている値を返す。
9.1.1.5.2 DeleteBinding ( name )
9.1.1.5.3 HasThisBinding ( )
The
true を返す。
this 束縛を提供する。
9.1.1.5.4 GetThisBinding ( )
The
undefined を返す。
9.1.1.5.5 CreateImportBinding ( envRec, name, targetModule, targetName )
The
9.1.2 Environment Record 操作
以下の抽象操作は、この仕様において
9.1.2.1 GetIdentifierReference ( env, name, strict )
The
- env が
null なら、Reference Record { [[Base]]:unresolvable , [[ReferencedName]]: name, [[Strict]]: strict, [[ThisValue]]:empty } を返す。
- exists を ? env.
HasBinding (name) とする。 - exists が
true なら、Reference Record { [[Base]]: env, [[ReferencedName]]: name, [[Strict]]: strict, [[ThisValue]]:empty } を返す。
- outer を env.[[OuterEnv]] とする。
- ?
GetIdentifierReference (outer, name, strict) を返す。
9.1.2.2 NewDeclarativeEnvironment ( outerEnv )
The
- env を、束縛を含まない新しい
Declarative Environment Record とする。 - env.[[OuterEnv]] を outerEnv に設定する。
- env を返す。
9.1.2.3 NewObjectEnvironment ( obj, isWithEnvironment, outerEnv )
The
- env を新しい
Object Environment Record とする。 - env.[[BindingObject]] を obj に設定する。
- env.[[IsWithEnvironment]] を isWithEnvironment に設定する。
- env.[[OuterEnv]] を outerEnv に設定する。
- env を返す。
9.1.2.4 NewFunctionEnvironment ( func, newTarget )
The
- env を、束縛を含まない新しい
Function Environment Record とする。 - env.[[FunctionObject]] を func に設定する。
- func.[[ThisMode]] が
lexical なら、env.[[ThisBindingStatus]] をlexical に設定する。 - Else, env.[[ThisBindingStatus]] を
uninitialized に設定する。 - env.[[NewTarget]] を newTarget に設定する。
- env.[[OuterEnv]] を func.[[Environment]] に設定する。
- env を返す。
9.1.2.5 NewGlobalEnvironment ( obj, thisValue )
The
- objRec を
NewObjectEnvironment (obj,false ,null ) とする。 - dclRec を
NewDeclarativeEnvironment (null ) とする。 - env を新しい
Global Environment Record とする。 - env.[[ObjectRecord]] を objRec に設定する。
- env.[[GlobalThisValue]] を thisValue に設定する。
- env.[[DeclarativeRecord]] を dclRec に設定する。
- env.[[OuterEnv]] を
null に設定する。 - env を返す。
9.1.2.6 NewModuleEnvironment ( outerEnv )
The
- env を、束縛を含まない新しい
Module Environment Record とする。 - env.[[OuterEnv]] を outerEnv に設定する。
- env を返す。
9.2 PrivateEnvironment Record
PrivateEnvironment Record は、ECMAScript コード内の
各
| フィールド名 | 値型 | 意味 |
|---|---|---|
| [[OuterPrivateEnvironment]] |
a |
最も近い外側の class の |
| [[Names]] |
a |
この class によって宣言された |
9.2.1 PrivateEnvironment Record 操作
以下の抽象操作は、この仕様において
9.2.1.1 NewPrivateEnvironment ( outerPrivateEnv )
The
- names を新しい空の
List とする。 PrivateEnvironment Record { [[OuterPrivateEnvironment]]: outerPrivateEnv, [[Names]]: names } を返す。
9.2.1.2 ResolvePrivateIdentifier ( privateEnv, identifier )
The
- names を privateEnv.[[Names]] とする。
- names の各
Private Name pn について、次を行う- pn.[[Description]] が identifier であるなら、
- pn を返す。
- pn.[[Description]] が identifier であるなら、
- outerPrivateEnv を privateEnv.[[OuterPrivateEnvironment]] とする。
Assert : outerPrivateEnv is notnull .ResolvePrivateIdentifier (outerPrivateEnv, identifier) を返す。
9.3 Realm
評価される前に、すべての ECMAScript コードは realm に関連付けられていなければならない。概念的には、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[AgentSignifier]] |
an |
この |
| [[Intrinsics]] |
a |
この |
| [[GlobalObject]] | an Object |
この |
| [[GlobalEnv]] |
a |
この |
| [[TemplateMap]] |
a |
テンプレートオブジェクトは、それぞれの |
| [[LoadedModules]] |
a |
この import() 式を実行するときにのみ使用される。
|
| [[HostDefined]] |
anything (default value is |
|
9.3.1 InitializeHostDefinedRealm ( )
The
- 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 である。 - ホストが realm の global object として機能する特定の object の使用を要求するなら、
- global を、そのような object でホスト定義の方法で作成されたものとする。
- Else,
- global を
OrdinaryObjectCreate (realm.[[Intrinsics]].[[%Object.prototype% ]]) とする。
- global を
- ホストが realm の global scope における
this束縛として global object 以外の object を返すことを要求するなら、- thisValue を、そのような object でホスト定義の方法で作成されたものとする。
- Else,
- thisValue を global とする。
- realm.[[GlobalObject]] を global に設定する。
- realm.[[GlobalEnv]] を
NewGlobalEnvironment (global, thisValue) に設定する。 - ?
SetDefaultGlobalBindings (realm) を実行する。 - global 上に任意の
host-defined global object property を作成する。 unused を返す。
9.3.2 CreateIntrinsics ( realmRec )
The
- realmRec.[[Intrinsics]] を新しい
Record に設定する。 - realmRec.[[Intrinsics]] の各フィールドに、
Table 6 に列挙された値を設定する。フィールド名は表の “Intrinsic Name” 列に列挙された名前である。各フィールドの値は、19 から28 までの各節で定義される各 object の仕様に従って、プロパティ値で完全かつ再帰的に充填された新しい object 値である。すべての object property 値は新しく作成された object 値である。built-infunction object であるすべての値は、CreateBuiltinFunction (steps, length, name, slots, realmRec, prototype, async) を実行することで作成される。ここで steps はこの仕様が提供するその関数の定義、name は関数の"name" プロパティの初期値、length は関数の"length" プロパティの初期値、slots はその関数に指定された内部スロット名の list（存在する場合）、prototype は関数の [[Prototype]] 内部スロットの指定値、そして async はその関数が “async” と記述されている場合はtrue 、そうでなければfalse である。intrinsics とそれらのプロパティの作成順序は、まだ作成されていない object への依存を避けるように定められなければならない。 AddRestrictedFunctionProperties (realmRec.[[Intrinsics]].[[%Function.prototype% ]], realmRec) を実行する。unused を返す。
9.3.3 SetDefaultGlobalBindings ( realmRec )
The
- global を realmRec.[[GlobalObject]] とする。
19 節で指定される Global Object の各 property について、次を行う- name をその property 名の String 値とする。
- desc を、その property に指定された属性を含む、完全に充填された data
Property Descriptor とする。19.2 、19.3 、または19.4 に列挙された property については、[[Value]] 属性の値は realmRec に対応する intrinsic object である。 - ?
DefinePropertyOrThrow (global, name, desc) を実行する。
unused を返す。
9.4 実行コンテキスト
execution context は、ECMAScript 実装によるコードの実行時評価を追跡するために用いられる仕様上の仕組みである。任意の時点において、実際にコードを実行している execution context は
execution context stack は execution context を追跡するために用いられる。
execution context は、関連付けられたコードの実行進行を追跡するために必要な、実装固有のあらゆる状態を含む。各 execution context は、少なくとも
| コンポーネント | 目的 |
|---|---|
| code evaluation state |
この |
| Function |
この |
|
|
関連付けられたコードが ECMAScript 資源へアクセスする元となる |
| ScriptOrModule |
関連付けられたコードの出所である Module |
ECMAScript code execution contexts は、
| コンポーネント | 目的 |
|---|---|
| LexicalEnvironment |
この |
| VariableEnvironment |
この |
| PrivateEnvironment |
最も近い包含 class における |
execution context の LexicalEnvironment および VariableEnvironment コンポーネントは、常に
Generator の評価を表す execution context は、
| コンポーネント | 目的 |
|---|---|
| Generator |
この |
ほとんどの状況では、
execution context は純粋に仕様上の仕組みであり、ECMAScript 実装のいかなる特定の実体にも対応する必要はない。ECMAScript コードが execution context に直接アクセスしたり観測したりすることは不可能である。
9.4.1 GetActiveScriptOrModule ( )
The
execution context stack が空なら、null を返す。- ec を、
execution context stack 上で ScriptOrModule コンポーネントがnull でない最上位のexecution context とする。 - そのような
execution context が存在しないなら、null を返す。 - ec の ScriptOrModule を返す。
9.4.2 ResolveBinding ( name [ , env ] )
The
- env が存在しないか、または env が
undefined なら、- env を
running execution context の LexicalEnvironment に設定する。
- env を
Assert : env はEnvironment Record である。- strict を、評価中の構文生成規則に対する
IsStrict とする。 - ?
GetIdentifierReference (env, name, strict) を返す。
ResolveBinding の結果は常に、[[ReferencedName]] フィールドが name である
9.4.3 GetThisEnvironment ( )
The this の束縛を提供している
- env を
running execution context の LexicalEnvironment とする。 - 繰り返す
- exists を env.
HasThisBinding () とする。 - exists が
true なら、env を返す。 - outer を env.[[OuterEnv]] とする。
Assert : outer is notnull .- env を outer に設定する。
- exists を env.
手順 this 束縛を持つ global environment で終わるからである。
9.4.4 ResolveThisBinding ( )
The this の束縛を決定する。 It performs the following steps when called:
- envRec を
GetThisEnvironment () とする。 - ? envRec.
GetThisBinding () を返す。
9.4.5 GetNewTarget ( )
The
- envRec を
GetThisEnvironment () とする。 Assert : envRec は [[NewTarget]] フィールドを持つ。- envRec.[[NewTarget]] を返す。
9.4.6 GetGlobalObject ( )
The
- currentRealm を
current Realm Record とする。 - currentRealm.[[GlobalObject]] を返す。
9.4.7 RunSuspendedContext ( context, completionRecord )
The
- callerContext を実行中の実行コンテキストとする。
- callerContext を中断する。
- context を実行コンテキストスタックにプッシュする；context は今や実行中の実行コンテキストである。
- context の中断された評価を再開する。その際、それを中断させた操作の結果として completionRecord を用いる。再開された計算により返された完了レコードを result とする。
Assert : このステップに到達した時点で、context はすでに実行コンテキストスタックから取り除かれており、callerContext が再び実行中の実行コンテキストである。- Return
Completion (result).
9.5 Job と Job を enqueue する Host Operation
Job は、他の ECMAScript 計算が現在進行中でないときに ECMAScript 計算を開始する、引数を持たない
- 将来のある時点で、その job がスケジュールされた
agent に running context が存在せず、かつそのagent のexecution context stack が空であるとき、実装は次を行わなければならない:- 任意の
host-defined preparation step を実行する。 - その
Job Abstract Closure を呼び出す 。 - 任意の
host-defined cleanup step を実行し、その後execution context stack は空でなければならない。
- 任意の
- ある
agent において、任意の時点で、評価中であり得るJob は 1 つだけである。 Job の評価が開始されたなら、そのagent において他のいかなるJob の評価が開始される前にも、そのJob は完了まで実行されなければならない。- その
Abstract Closure はnormal completion を返さなければならず、エラー処理は自身で実装しなければならない。
任意の特定の時点で、scriptOrModule（Script
GetActiveScriptOrModule () が scriptOrModule である。- scriptOrModule が Script
Record または ModuleRecord である場合、ec をexecution context stack 上で ScriptOrModule コンポーネントが scriptOrModule である最上位のexecution context とする。ec のRealm コンポーネントは scriptOrModule.[[Realm]] である。
任意の特定の時点で、ある execution が ECMAScript code を評価する準備ができている のは、次のすべての条件が真である場合である:
execution context stack が空でない。execution context stack 上の最上位execution context のRealm コンポーネントがRealm Record である。
特定種別の
9.5.1 JobCallback Record
JobCallback Record は、
たとえば WHATWG HTML 仕様（https://html.spec.whatwg.org/）は、Promise callback に対する incumbent settings object を伝播するために
JobCallback Record は、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Callback]] |
a |
その |
| [[HostDefined]] |
anything (default value is |
|
9.5.2 HostMakeJobCallback ( callback )
The
HostMakeJobCallback の実装は次の要件に適合しなければならない:
- [[Callback]] フィールドが callback である
JobCallback Record を返さなければならない。
HostMakeJobCallback の既定実装は、呼び出されたとき次の手順を実行する:
JobCallback Record { [[Callback]]: callback, [[HostDefined]]:empty } を返す。
web browser でない ECMAScript
これは、その callback が、最終的にスケジュールされ実行される責任を持つ関数へ渡される時点で呼び出される。たとえば promise.then(thenAction) は、reaction Promise.prototype.then を呼び出す時点で thenAction に対して MakeJobCallback を呼び出す。
9.5.3 HostCallJobCallback ( jobCallback, value, argumentsList )
The
HostCallJobCallback の実装は次の要件に適合しなければならない:
Call (jobCallback.[[Callback]], value, argumentsList) の結果を実行し、その結果を返さなければならない。
この要件は、
HostCallJobCallback の既定実装は、呼び出されたとき次の手順を実行する:
Assert :IsCallable (jobCallback.[[Callback]]) istrue .- ?
Call (jobCallback.[[Callback]], value, argumentsList) を返す。
web browser でない ECMAScript
9.5.4 HostEnqueueGenericJob ( job, realm )
The
HostEnqueueGenericJob の実装は
9.5.5 HostEnqueuePromiseJob ( job, realm )
The
HostEnqueuePromiseJob の実装は
- realm が
null でない場合、job が呼び出されるたびに、実装は job 呼出し時に execution がECMAScript code を評価する準備ができている ようにするimplementation-defined な手順を実行しなければならない。 - scriptOrModule を HostEnqueuePromiseJob が呼び出された時点の
GetActiveScriptOrModule () とする。realm がnull でない場合、job が呼び出されるたびに、実装は job 呼出し時に scriptOrModule がactive script or module であるようにするimplementation-defined な手順を実行しなければならない。 Job は、それらをスケジュールした HostEnqueuePromiseJob 呼出しと同じ順序で実行されなければならない。
9.5.6 HostEnqueueTimeoutJob ( timeoutJob, realm, milliseconds )
The
HostEnqueueTimeoutJob の実装は
9.6 Agent
agent は、一組の ECMAScript
たとえば一部の web browser では、browser window の無関係な複数の tab 間で単一の
agent signifier は、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[LittleEndian]] | a Boolean | アルゴリズム |
| [[CanBlock]] | a Boolean | その |
| [[Signifier]] | an |
その |
| [[IsLockFree1]] | a Boolean | 1- |
| [[IsLockFree2]] | a Boolean | 2- |
| [[IsLockFree8]] | a Boolean | 8- |
| [[CandidateExecution]] | a |
memory model を参照。 |
| [[KeptAlive]] | a |
初期値は新しい空の |
| [[ModuleAsyncEvaluationCount]] | an |
初期値は 0 であり、非同期である module または非同期依存を持つ module の [[AsyncEvaluationOrder]] フィールドに、一意な増加値を割り当てるために用いられる。 |
[[LittleEndian]]、[[Signifier]]、[[IsLockFree1]]、[[IsLockFree2]]、および [[IsLockFree8]] の値は変更できない。
[[IsLockFree1]]、[[IsLockFree2]]、および [[IsLockFree8]] の値は、必ずしも hardware のみによって決まるわけではなく、時間の経過や ECMAScript 実装間で変化し得る実装上の選択も反映し得る。
[[IsLockFree4]] フィールドは存在しない: 4-byte atomic operation は常に lock-free である。
実際には、ある atomic operation が何らかの lock を用いて実装されているなら、その operation は lock-free ではない。lock-free は wait-free を含意しない: lock-free atomic operation の完了に必要な machine step 数には上限がない。
サイズ n の atomic access が lock-free であることは、サイズ n の非 atomic access の（知覚される）原子性について何も意味しない。特に、非 atomic access は依然として複数の独立した memory access の列として実行され得る。詳細は
9.6.1 AgentSignifier ( )
The
- agentRecord を
surrounding agent のAgent Record とする。 - agentRecord.[[Signifier]] を返す。
9.6.2 AgentCanSuspend ( )
The
- agentRecord を
surrounding agent のAgent Record とする。 - agentRecord.[[CanBlock]] を返す。
一部の環境では、与えられた
9.6.3 IncrementModuleAsyncEvaluationCount ( )
The
- agentRecord を
surrounding agent のAgent Record とする。 - count を agentRecord.[[ModuleAsyncEvaluationCount]] とする。
- agentRecord.[[ModuleAsyncEvaluationCount]] を count + 1 に設定する。
- count を返す。
この値は、保留中の module 間の相対的な評価順序を追跡するためにのみ用いられる。実装は、保留中の module が存在しないときは 언제でも、観測不能な形で [[ModuleAsyncEvaluationCount]] を 0 に戻してよい。
9.7 Agent Cluster
agent cluster は、shared memory 上で操作することにより通信できる
すべての
cluster 内のすべての
agent cluster 内の異なる
cluster 内のすべての
cluster 内のすべての
embedding は、
前述の制約の目的は、別の
この制約が意味するのは、embedding 内で同じ suspend/wake collective に属さない
embedding は、その
次の仕様値およびそこから推移的に到達可能な値は、それぞれちょうど 1 つの agent cluster に属する。
cluster 内のいずれの
agent cluster 内のすべての
agent cluster は仕様上の仕組みであり、ECMAScript 実装のいかなる特定の実体にも対応する必要はない。
9.8 Forward Progress
実装は次を保証しなければならない:
- 専用の
executing thread を持つすべての unblocked なagent は、最終的に forward progress を行う - 1 つの
executing thread を共有するagent の集合においては、いずれか 1 つのagent が最終的に forward progress を行う agent は、blocking を提供する明示的 API を通じる場合を除き、他のagent が blocked になる原因となってはならない。
これは、memory model における liveness 保証とともに、すべての
9.9 WeakRef および FinalizationRegistry Target の Processing Model
9.9.1 目的
この仕様は、いかなる object や symbol も garbage collected されることを保証しない。
-
WeakRef.prototype.derefが呼び出されると、referent は（undefined が返されない場合）その後の同期的アクセスも同じ値を返すように生存維持される。この list は、ClearKeptObjects 抽象操作を用いた同期 work の完了時に reset される。 -
FinalizationRegistry に登録された object または symbol が到達不能になると、そのFinalizationRegistry の cleanup callback の呼出しが、同期的 ECMAScript 実行の完了後、最終的に行われる場合がある。FinalizationRegistry cleanup はCleanupFinalizationRegistry 抽象操作によって実行される。
これら 2 つの action（
一部の ECMAScript 実装には、ECMAScript が idle のときも含めて background で動作する garbage collector 実装が含まれる。
9.9.2 Liveness
ある object および／または symbol の集合 objectSet に対して、objectSet に関する 仮想的 WeakRef-oblivious execution とは、referent が objectSet の要素である
評価中の任意の時点で、ある object および／または symbol の集合 objectSet は、次のいずれかの条件を満たすなら live とみなされる:
-
objectSet のいずれかの要素が、いずれかの
agent の [[KeptAlive]]List に含まれている。 - objectSet に関する有効な将来の仮想的 WeakRef-oblivious execution が存在し、その execution が objectSet 内のいずれかの値の identity を観測する。
field、internal slot、または property の中に object または symbol が存在することは、その値が live であることを含意しない。たとえば、その値が program に一度も返されないなら、それは観測できない。
これは WeakMap の key、WeakSet の member、ならびに
上記の定義は、WeakMap 内の key が live でない場合、その対応する value も必ずしも live ではないことを含意する。
9.9.3 Execution
任意の時点で、ある object および／または symbol の集合 objectSet が
- objectSet の各要素 value について、次を行う
- ref.[[WeakRefTarget]] が value である各
WeakRef ref について、次を行う- ref.[[WeakRefTarget]] を
empty に設定する。
- ref.[[WeakRefTarget]] を
- fg.[[Cells]] が cell.[[WeakRefTarget]] が value である
Record cell を含む各FinalizationRegistry fg について、次を行う- cell.[[WeakRefTarget]] を
empty に設定する。 - 任意で、
HostEnqueueFinalizationRegistryCleanupJob (fg) を実行する。
- cell.[[WeakRefTarget]] を
- map.[[WeakMapData]] が r.[[Key]] が value である
Record r を含む各 WeakMap map について、次を行う- r.[[Key]] を
empty に設定する。 - r.[[Value]] を
empty に設定する。
- r.[[Key]] を
- set.[[WeakSetData]] が value を含む各 WeakSet set について、次を行う
- set.[[WeakSetData]] において値が value である要素を、値が
empty である要素で置き換える。
- set.[[WeakSetData]] において値が value である要素を、値が
- ref.[[WeakRefTarget]] が value である各
liveness の定義とあわせて、この節は、
object の identity を観測せずにその object にアクセスすることは可能である。identity が観測されない非 escape object の property に対する dead variable elimination や scalar replacement のような最適化は許される。したがって、これらの最適化は、そのような object を指す
一方で、object の identity が観測可能であり、かつその object が
実装は、非
実装が
9.9.4 Host Hook
9.9.4.1 HostEnqueueFinalizationRegistryCleanupJob ( finalizationRegistry )
The
cleanupJob を、引数を持たない新しい
- cleanupResult を
Completion (CleanupFinalizationRegistry (finalizationRegistry)) とする。 - cleanupResult が
abrupt completion なら、エラー報告のための任意のhost-defined 手順を実行する。 unused を返す。
HostEnqueueFinalizationRegistryCleanupJob の実装は、可能であれば cleanupJob が将来のある時点で実行されるようスケジュールする。また、
9.10 ClearKeptObjects ( )
The
- agentRecord を
surrounding agent のAgent Record とする。 - agentRecord.[[KeptAlive]] を新しい空の
List に設定する。 unused を返す。
9.11 AddToKeptObjects ( value )
The
- agentRecord を
surrounding agent のAgent Record とする。 - value を agentRecord.[[KeptAlive]] に append する。
unused を返す。
9.12 CleanupFinalizationRegistry ( finalizationRegistry )
The
Assert : finalizationRegistry は [[Cells]] および [[CleanupCallback]] internal slot を持つ。- callback を finalizationRegistry.[[CleanupCallback]] とする。
- finalizationRegistry.[[Cells]] が cell.[[WeakRefTarget]] が
empty であるRecord cell を含む間、実装は次の手順を実行してよい:- そのような cell を任意に選ぶ。
- cell を finalizationRegistry.[[Cells]] から除去する。
- ?
HostCallJobCallback (callback,undefined , « cell.[[HeldValue]] ») を実行する。
unused を返す。
9.13 CanBeHeldWeakly ( v )
The
- v が Object なら、
true を返す。 - v が Symbol であり、かつ
KeyForSymbol (v) がundefined なら、true を返す。 false を返す。
10 通常および特殊なオブジェクトの挙動
10.1 通常オブジェクトの内部メソッドと内部スロット
すべての通常オブジェクトは [[Prototype]] と呼ばれる内部
スロットを持つ。この内部スロットの値は
すべての通常オブジェクトは Boolean 値の [[Extensible]]
内部スロットを持ち、これは
以下のアルゴリズム記述において、obj は通常オブジェク
ト、propertyKey は
各通常オブジェクト内部メソッドは、同様の名前を持つ抽象操 作へ委譲する。そのような抽象操作が別の内部メソッドに依存 する場合、その内部メソッドは、同様の名前を持つ抽象操作を 直接呼び出すのではなく obj に対して呼び出される。これ らの意味論により、通常オブジェクト内部メソッドが特殊オブ ジェクトに適用されたとき、それらの上書きされた内部メソッ ドが呼び出されることが保証される。
10.1.1 [[GetPrototypeOf]] ( )
The [[GetPrototypeOf]] internal method of an
OrdinaryGetPrototypeOf (obj) を返す。
10.1.1.1 OrdinaryGetPrototypeOf ( obj )
The
- obj.[[Prototype]] を返す。
10.1.2 [[SetPrototypeOf]] ( proto )
The [[SetPrototypeOf]] internal method of an
OrdinarySetPrototypeOf (obj, proto) を返す。
10.1.2.1 OrdinarySetPrototypeOf ( obj, proto )
The
- current を obj.[[Prototype]] とする。
SameValue (proto, current) がtrue なら、true を返す。- extensible を obj.[[Extensible]] とする。
- extensible が
false なら、false を返す。 - cursor を proto とする。
- done を
false とする。 - done が
false の間、繰り返す - obj.[[Prototype]] を proto に設定する。
true を返す。
手順
10.1.3 [[IsExtensible]] ( )
The [[IsExtensible]] internal method of an
OrdinaryIsExtensible (obj) を返す。
10.1.3.1 OrdinaryIsExtensible ( obj )
The
- obj.[[Extensible]] を返す。
10.1.4 [[PreventExtensions]] ( )
The [[PreventExtensions]] internal method of an
OrdinaryPreventExtensions (obj) を返す。
10.1.4.1 OrdinaryPreventExtensions ( obj )
The
- obj.[[Extensible]] を
false に設定する。 true を返す。
10.1.5 [[GetOwnProperty]] ( propertyKey )
The [[GetOwnProperty]] internal method of an
OrdinaryGetOwnProperty (obj, propertyKey) を返す。
10.1.5.1 OrdinaryGetOwnProperty ( obj, propertyKey )
The
- obj が key propertyKey を持つ own property を
持たないなら、
undefined を返す。 - desc を、フィールドを持たない新しく作成された
Property Descriptor とする。 - ownProperty を、key が propertyKey である obj の own property とする。
- ownProperty が
data property なら、- desc.[[Value]] を ownProperty の [[Value]] 属性の値に設定する。
- desc.[[Writable]] を ownProperty の [[Writable]] 属性の値に設定する。
- Else,
Assert : ownProperty はaccessor property で ある。- desc.[[Get]] を ownProperty の [[Get]] 属性の値に設定する。
- desc.[[Set]] を ownProperty の [[Set]] 属性の値に設定する。
- desc.[[Enumerable]] を ownProperty の [[Enumerable]] 属性の値に設定する。
- desc.[[Configurable]] を ownProperty の [[Configurable]] 属性の値に設定する。
- desc を返す。
10.1.6 [[DefineOwnProperty]] ( propertyKey, desc )
The [[DefineOwnProperty]] internal method of an
- ?
OrdinaryDefineOwnProperty (obj, propertyKey, desc) を返す。
10.1.6.1 OrdinaryDefineOwnProperty ( obj, propertyKey, desc )
The
- current を ? obj.[[GetOwnProperty]](propertyKey) とする。
- extensible を ?
IsExtensible (obj) とする。 ValidateAndApplyPropertyDescriptor (obj, propertyKey, extensible, desc, current) を 返す。
10.1.6.2 IsCompatiblePropertyDescriptor ( extensible, desc, current )
The
ValidateAndApplyPropertyDescriptor (undefined ,"" , extensible, desc, current) を返す。
10.1.6.3 ValidateAndApplyPropertyDescriptor ( obj, propertyKey, extensible, desc, current )
The
Assert : propertyKey はproperty key である。- current が
undefined なら、- extensible が
false なら、false を返す。 - obj が
undefined なら、true を返す。 IsAccessorDescriptor (desc) がtrue なら、- obj の propertyKey という名前の own
accessor property を作成し、その [[Get]]、 [[Set]]、[[Enumerable]]、[[Configurable]] 属性を、desc がそのフィールドを持つ場合は 対応する値に、そうでなければその属性の既定値 に設定する。
- obj の propertyKey という名前の own
- Else,
- obj の propertyKey という名前の own
data property を作成し、その [[Value]]、 [[Writable]]、[[Enumerable]]、 [[Configurable]] 属性を、desc がそのフィ ールドを持つ場合は対応する値に、そうでなけれ ばその属性の既定値 に設定 する。
- obj の propertyKey という名前の own
true を返す。
- extensible が
Assert : current は fully populated なProperty Descriptor である。- desc がいかなるフィールドも持たないなら、
true を返す。 - current.[[Configurable]] が
false なら、- desc が [[Configurable]] フィールドを持ち、
かつ desc.[[Configurable]] が
true なら、false を返す。 - desc が [[Enumerable]] フィールドを持ち、
かつ desc.[[Enumerable]] が
current.[[Enumerable]] と異なるなら、
false を返す。 IsGenericDescriptor (desc) がfalse であり、 かつIsAccessorDescriptor (desc) がIsAccessorDescriptor (current) と異なるなら、false を返す。IsAccessorDescriptor (current) がtrue なら、- Else if current.[[Writable]] が
false なら、
- desc が [[Configurable]] フィールドを持ち、
かつ desc.[[Configurable]] が
- obj が
undefined でないなら、IsDataDescriptor (current) がtrue であり、 かつIsAccessorDescriptor (desc) がtrue なら、- desc が [[Configurable]] フィールドを持つ なら、configurable を desc.[[Configurable]] とする; そうでなけれ ば configurable を current.[[Configurable]] とする。
- desc が [[Enumerable]] フィールドを持つな ら、enumerable を desc.[[Enumerable]] と する; そうでなければ enumerable を current.[[Enumerable]] とする。
- obj の propertyKey という名前のプロパ
ティを
accessor property に置き換え、その [[Configurable]] および [[Enumerable]] 属性 をそれぞれ configurable および enumerable に設定し、[[Get]] および [[Set]] 属性を、desc がそのフィールドを持 つ場合は対応する値に、そうでなければその属性 の既定値 に設定する。
- Else if
IsAccessorDescriptor (current) がtrue であり、かつIsDataDescriptor (desc) がtrue なら、- desc が [[Configurable]] フィールドを持つ なら、configurable を desc.[[Configurable]] とする; そうでなけれ ば configurable を current.[[Configurable]] とする。
- desc が [[Enumerable]] フィールドを持つな ら、enumerable を desc.[[Enumerable]] と する; そうでなければ enumerable を current.[[Enumerable]] とする。
- obj の propertyKey という名前のプロパ
ティを
data property に置き換え、その [[Configurable]] および [[Enumerable]] 属性 をそれぞれ configurable および enumerable に設定し、[[Value]] および [[Writable]] 属性を、desc がそのフィールド を持つ場合は対応する値に、そうでなければその 属性の既定値 に設定する。
- Else,
- desc の各フィールド名 fieldName につい て、obj の propertyKey という名前のプロ パティの fieldName という属性を、 desc の fieldName フィールドの値に設定 する。
true を返す。
10.1.7 [[HasProperty]] ( propertyKey )
The [[HasProperty]] internal method of an
- ?
OrdinaryHasProperty (obj, propertyKey) を返 す。
10.1.7.1 OrdinaryHasProperty ( obj, propertyKey )
The
- 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 an
- ?
OrdinaryGet (obj, propertyKey, receiver) を返 す。
10.1.8.1 OrdinaryGet ( obj, propertyKey, receiver )
The
- desc を ? obj.[[GetOwnProperty]](propertyKey) とする。
- desc が
undefined なら、- parent を ? obj.[[GetPrototypeOf]]() とする。
- parent が
null なら、undefined を返す。 - ? parent.[[Get]](propertyKey, receiver) を返す。
IsDataDescriptor (desc) がtrue なら、 desc.[[Value]] を返す。Assert :IsAccessorDescriptor (desc) istrue .- getter を desc.[[Get]] とする。
- getter が
undefined なら、undefined を返す。 - ?
Call (getter, receiver) を返す。
10.1.9 [[Set]] ( propertyKey, value, receiver )
The [[Set]] internal method of an
- ?
OrdinarySet (obj, propertyKey, value, receiver) を返す。
10.1.9.1 OrdinarySet ( obj, propertyKey, value, receiver )
The
- ownDesc を ? obj.[[GetOwnProperty]](propertyKey) とする。
- ?
OrdinarySetWithOwnDescriptor (obj, propertyKey, value, receiver, ownDesc) を返す。
10.1.9.2 OrdinarySetWithOwnDescriptor ( obj, propertyKey, value, receiver, ownDesc )
The
- 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 を返 す。 - existingDescriptor を ? receiver.[[GetOwnProperty]](propertyKey) とする。
- existingDescriptor が
undefined なら、Assert : receiver は現在 propertyKey という プロパティを持たない。- ?
CreateDataProperty (receiver, propertyKey, value) を返す。
IsAccessorDescriptor (existingDescriptor) がtrue なら、false を返す。- existingDescriptor.[[Writable]] が
false な ら、false を返す。 - valueDesc を PropertyDescriptor { [[Value]]: value } とする。
- ? receiver.[[DefineOwnProperty]](propertyKey, valueDesc) を返す。
- ownDesc.[[Writable]] が
Assert :IsAccessorDescriptor (ownDesc) istrue .- setter を ownDesc.[[Set]] とする。
- setter が
undefined なら、false を返す。 - ?
Call (setter, receiver, « value ») を実行す る。 true を返す。
10.1.10 [[Delete]] ( propertyKey )
The [[Delete]] internal method of an
- ?
OrdinaryDelete (obj, propertyKey) を返す。
10.1.10.1 OrdinaryDelete ( obj, propertyKey )
The
- desc を ? obj.[[GetOwnProperty]](propertyKey) とする。
- desc が
undefined なら、true を返す。 - desc.[[Configurable]] が
true なら、- obj から名前が propertyKey である own property を除去する。
true を返す。
false を返す。
10.1.11 [[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of an
OrdinaryOwnPropertyKeys (obj) を返す。
10.1.11.1 OrdinaryOwnPropertyKeys ( obj )
The
- keys を新しい空の
List とする。 - obj の各 own
property key propertyKey につい て、propertyKey がarray index であるものを、 数値 index 昇順で処理し、- propertyKey を keys に append する。
- obj の各 own
property key propertyKey につい て、propertyKey が String であり、かつarray index ではないものを、プロパティ作成時刻の 昇順で処理し、- propertyKey を keys に append する。
- obj の各 own
property key propertyKey につい て、propertyKey が Symbol であるものを、プロ パティ作成時刻の昇順で処理し、- propertyKey を keys に append する。
- keys を返す。
10.1.12 OrdinaryObjectCreate ( proto [ , additionalInternalSlotsList ] )
The
- internalSlotsList を « [[Prototype]], [[Extensible]] » とする。
- additionalInternalSlotsList が存在する場合、
internalSlotsList を internalSlotsList と
additionalInternalSlotsList の
list-concatenation に設定する。 - obj を
MakeBasicObject (internalSlotsList) と する。 - obj.[[Prototype]] を proto に設定する。
- obj を返す。
OrdinaryObjectCreate は
10.1.13 OrdinaryCreateFromConstructor ( constructor, intrinsicDefaultProto [ , internalSlotsList ] )
The
Assert : intrinsicDefaultProto は、この仕様にお ける intrinsic object の名前である。対応する object は、オブジェクトの [[Prototype]] 値として 使用されることが意図された intrinsic でなければ ならない。- proto を ?
GetPrototypeFromConstructor ( constructor, intrinsicDefaultProto) とする。 - internalSlotsList が存在する場合、slotsList を internalSlotsList とする。
- Else, slotsList を新しい空の
List とする。 OrdinaryObjectCreate (proto, slotsList) を返 す。
10.1.14 GetPrototypeFromConstructor ( constructor, intrinsicDefaultProto )
The
Assert : intrinsicDefaultProto は、この仕様にお ける intrinsic object の名前である。対応する object は、オブジェクトの [[Prototype]] 値として 使用されることが意図された intrinsic でなければ ならない。- proto を ?
Get (constructor,"prototype" ) と する。 - proto が Object でないなら、
- realm を ?
GetFunctionRealm (constructor) とする。 - proto を realm の intrinsicDefaultProto という名前の intrinsic object に設定する。
- realm を ?
- proto を返す。
constructor が [[Prototype]] 値を提供しない場
合、用いられる既定値は、
10.1.15 RequireInternalSlot ( obj, internalSlot )
The
- obj が Object でなければ、
TypeError 例外を送 出する。 - obj が internalSlot internal slot を持たなけ
れば、
TypeError 例外を送出する。 unused を返す。
10.2 ECMAScript 関数オブジェクト
ECMAScript 関数オブジェクトは、レキシカル環境を閉包
した、パラメータ化された ECMAScript コードをカプセル化
し、そのコードの動的評価をサポートする。ECMAScript 関数
オブジェクトは通常オブジェクトであり、他の通常オブジェク
トと同じ内部スロットおよび同じ内部メソッドを持つ。
ECMAScript 関数オブジェクトのコードは、
[[Extensible]] と [[Prototype]] に加えて、
ECMAScript 関数オブジェクトは
| 内部スロット | 型 | 説明 |
|---|---|---|
| [[Environment]] |
an |
関数が閉包した |
| [[PrivateEnvironment]] |
a |
関数が閉包した |
| [[FormalParameters]] |
a |
関数の仮引数リストを定義する source text の root parse node。 |
| [[ECMAScriptCode]] |
a |
関数本体を定義する source text の root parse node。 |
| [[ConstructorKind]] |
|
関数が derived class |
| [[Realm]] |
a |
関数が作成された |
| [[ScriptOrModule]] |
a Script |
関数が作成された script または module。 |
| [[ThisMode]] |
|
関数の仮引数およびコード本体内で this 参照
がどのように解釈されるかを定義する。this がレキシカルに外側の関数の |
| [[Strict]] | a Boolean |
これが |
| [[HomeObject]] |
an Object or |
関数が super を使用する場合、これは
super プロパティ探索が開始されるオブジェク
トを [[GetPrototypeOf]] が提供する、そのオブ
ジェクトである。
|
| [[SourceText]] | a sequence of Unicode code points |
関数を定義する |
| [[Fields]] |
a |
関数が class である場合、これは class の非
static field と、それに対応する initializer
を表す |
| [[PrivateMethods]] |
a |
関数が class である場合、これは class の非 static private method および accessor を表 す list である。 |
| [[ClassFieldInitializerName]] |
a String, a Symbol, a |
関数が class field の initializer として作
成された場合、その field の |
| [[IsClassConstructor]] | a Boolean |
関数が class |
すべての ECMAScript 関数オブジェクトは、ここで定義
される [[Call]] 内部メソッドを持つ。さらに
10.2.1 [[Call]] ( thisArgument, argumentsList )
The [[Call]] internal method of an ECMAScript
- callerContext を
running execution context とする。 - calleeContext を
PrepareForOrdinaryCall (func,undefined ) とする。 Assert : calleeContext はいまrunning execution context である。- func.[[IsClassConstructor]] が
true なら、- error を新しく作成された
TypeError object とする。 NOTE : error は calleeContext において func に関連付けられたRealm Record を用い て作成される。- calleeContext を
execution context stack から取り除き、callerContext をrunning execution context として復元する。 - error を送出する。
- error を新しく作成された
OrdinaryCallBindThis (func, calleeContext, thisArgument) を実行する。- result を
Completion (OrdinaryCallEvaluateBody (func, argumentsList)) とする。 - 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
- 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 がまだ suspend されていなけ れば、callerContext を suspend する。
- calleeContext を
execution context stack に push する; calleeContext はいまrunning execution context である。 NOTE : これ以降に生成されるいかなる exception object も calleeRealm に関連付けられる。- calleeContext を返す。
10.2.1.2 OrdinaryCallBindThis ( func, calleeContext, thisArgument )
The
- thisMode を func.[[ThisMode]] とする。
- thisMode が
lexical なら、unused を返す。 - calleeRealm を func.[[Realm]] とする。
- localEnv を calleeContext の LexicalEnvironment とする。
- thisMode が
strict なら、- thisValue を thisArgument とする。
- Else,
- thisArgument が
undefined またはnull のいずれかなら、- globalEnv を calleeRealm.[[GlobalEnv]] とする。
Assert : globalEnv はGlobal Environment Record である。- thisValue を globalEnv.[[GlobalThisValue]] とする。
- Else,
- thisArgument が
Assert : localEnv はFunction Environment Record である。Assert : 次の手順がabrupt completion を返す ことは決してない。なぜなら localEnv.[[ThisBindingStatus]] はinitialized ではないからである。- !
BindThisValue (localEnv, thisValue) を 実行する。 unused を返す。
10.2.1.3 Runtime Semantics: EvaluateBody
The
- func および argumentsList を引数として
FunctionBody のEvaluateFunctionBody を ? 返す。
- func および argumentsList を引数として
ConciseBody のEvaluateConciseBody を ? 返す。
- func および argumentsList を引数として
GeneratorBody のEvaluateGeneratorBody を ? 返す。
- func および argumentsList を引数として
AsyncGeneratorBody のEvaluateAsyncGeneratorBody を ? 返す。
- func および argumentsList を引数として
AsyncFunctionBody のEvaluateAsyncFunctionBody を ? 返す。
- func および argumentsList を引数として
AsyncConciseBody のEvaluateAsyncConciseBody を ? 返す。
Assert : argumentsList は空である。Assert : func.[[ClassFieldInitializerName]] はempty ではない。IsAnonymousFunctionDefinition (AssignmentExpression ) がtrue なら、- value を、func.[[ClassFieldInitializerName]]
を引数とする
Initializer のNamedEvaluation の ? とする。
- value を、func.[[ClassFieldInitializerName]]
を引数とする
- Else,
- rhs を
AssignmentExpression の ?Evaluation とする。 - value を ?
GetValue (rhs) とする。
- rhs を
ReturnCompletion (value) を返す。
field initializer は関数境界を構成するが、
Assert : argumentsList は空である。- func を引数として
ClassStaticBlockBody のEvaluateClassStaticBlockBody を ? 返す。
10.2.1.4 OrdinaryCallEvaluateBody ( func, argumentsList )
The
- func および argumentsList を引数として
func.[[ECMAScriptCode]] の
EvaluateBody を ? 返す。
10.2.2 [[Construct]] ( argumentsList, newTarget )
The [[Construct]] internal method of an ECMAScript
- callerContext を
running execution context とする。 - kind を func.[[ConstructorKind]] とする。
- kind が
base なら、- thisArgument を
?
OrdinaryCreateFromConstructor (newTarget,"%Object.prototype%" ) とする。
- thisArgument を
?
- calleeContext を
PrepareForOrdinaryCall (func, newTarget) とす る。 Assert : calleeContext はいまrunning execution context である。- kind が
base なら、OrdinaryCallBindThis (func, calleeContext, thisArgument) を実行する。- initializeResult を
Completion (InitializeInstanceElements (thisArgument, func)) とする。 - initializeResult が
abrupt completion なら、- calleeContext を
execution context stack から取り除き、callerContext をrunning execution context として復元する。 - ? initializeResult を返す。
- calleeContext を
- constructorEnv を calleeContext の LexicalEnvironment とする。
- result を
Completion (OrdinaryCallEvaluateBody (func, argumentsList)) とする。 - calleeContext を
execution context stack から取り除き、callerContext をrunning execution context として復元する。 - result が
throw completion なら、- ? result を返す。
Assert : result はreturn completion であ る。- result.[[Value]] が Object なら、 result.[[Value]] を返す。
- kind が
base なら、thisArgument を返す。 - result.[[Value]] が
undefined でないなら、TypeError 例外を送出する。 - thisBinding を ? constructorEnv.
GetThisBinding () とする。 Assert : thisBinding は Object である。- thisBinding を返す。
10.2.3 OrdinaryFunctionCreate ( functionPrototype, sourceText, parameterList, body, thisMode, env, privateEnv )
The
- internalSlotsList を
Table 25 に列挙された内部スロットとする。 - func を
OrdinaryObjectCreate ( functionPrototype, internalSlotsList) とす る。 - func.[[Call]] を
10.2.1 で規定された定義に設定する。 - func.[[SourceText]] を sourceText に設定す る。
- func.[[FormalParameters]] を parameterList に設定する。
- func.[[ECMAScriptCode]] を body に設定する。
- strict を
IsStrict (body) とする。 - func.[[Strict]] を strict に設定する。
- thisMode が
lexical-this なら、 func.[[ThisMode]] をlexical に設定する。 - Else if strict が
true なら、 func.[[ThisMode]] をstrict に設定する。 - Else, func.[[ThisMode]] を
global に設定す る。 - func.[[IsClassConstructor]] を
false に設 定する。 - func.[[Environment]] を env に設定する。
- func.[[PrivateEnvironment]] を privateEnv に設定する。
- func.[[ScriptOrModule]] を
GetActiveScriptOrModule () に設定する。 - func.[[Realm]] を
current Realm Record に 設定する。 - func.[[HomeObject]] を
undefined に設定す る。 - func.[[Fields]] を新しい空の
List に設定す る。 - func.[[PrivateMethods]] を新しい空の
List に 設定する。 - func.[[ClassFieldInitializerName]] を
empty に設定する。 - len を parameterList の
ExpectedArgumentCount とする。 SetFunctionLength (func, len) を実行する。- func を返す。
10.2.4 AddRestrictedFunctionProperties ( func, realm )
The
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% ( )
この関数は %ThrowTypeError% intrinsic object である。
これは、各
呼び出されると、次の手順を実行する:
TypeError 例外を送出する。
この関数の [[Extensible]] 内部スロットの値は
この関数の
この関数の
10.2.5 MakeConstructor ( func [ , writablePrototype [ , prototype ] ] )
The
- func が ECMAScript
function object なら、Assert :IsConstructor (func) isfalse .Assert : func は"prototype" own property を持たない拡張可能オブジェクトである。- func.[[Construct]] を
10.2.2 で規定された定義に設定する。
- Else,
- func.[[Construct]] を
10.3.2 で規定された定義に設定する。
- func.[[Construct]] を
- func.[[ConstructorKind]] を
base に設定する。 - writablePrototype が存在しないなら、
writablePrototype を
true に設定する。 - prototype が存在しないなら、
- prototype を
OrdinaryObjectCreate (%Object.prototype% ) に設定する。 - !
DefinePropertyOrThrow (prototype,"constructor" , PropertyDescriptor { [[Value]]: func, [[Writable]]: writablePrototype, [[Enumerable]]:false , [[Configurable]]:true }) を実行する。
- prototype を
- !
DefinePropertyOrThrow (func,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]: writablePrototype, [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 unused を返す。
10.2.6 MakeClassConstructor ( func )
The
Assert : func.[[IsClassConstructor]] isfalse .- func.[[IsClassConstructor]] を
true に設定す る。 unused を返す。
10.2.7 MakeMethod ( func, homeObject )
The
Assert : homeObject は通常オブジェクトである。- func.[[HomeObject]] を homeObject に設定す る。
unused を返す。
10.2.8 DefineMethodProperty ( homeObject, key, closure, enumerable )
The
Assert : homeObject は通常かつ拡張可能なオブジェ クトである。- key が
Private Name なら、PrivateElement { [[Key]]: key, [[Kind]]:method , [[Value]]: closure } を返す。 - desc を PropertyDescriptor { [[Value]]:
closure, [[Writable]]:
true , [[Enumerable]]: enumerable, [[Configurable]]:true } とす る。 - ?
DefinePropertyOrThrow (homeObject, key, desc) を実行する。 NOTE :DefinePropertyOrThrow がabrupt completion を返すのは、key が"prototype" である class static method を定義しようとす る場合に限られる。unused を返す。
10.2.9 SetFunctionName ( func, name [ , prefix ] )
The
Assert : func は"name" own property を持た ない拡張可能オブジェクトである。- name が Symbol なら、
- description を name.[[Description]] とす る。
- description が
undefined なら、name を 空の String に設定する。 - Else, name を
"[" と description と"]" のstring-concatenation に設定す る。
- Else if name が
Private Name なら、- name を name.[[Description]] に設定す る。
- func が [[InitialName]] internal slot を持つ
なら、
- func.[[InitialName]] を name に設定する。
- prefix が存在するなら、
- name を prefix と code unit 0x0020
(SPACE) と name の
string-concatenation に設定する。 - func が [[InitialName]] internal slot を持
つなら、
NOTE : 次の手順における選択は、この抽象操作が 呼び出されるたびに独立して行われる。- 任意で、func.[[InitialName]] を name に 設定する。
- name を 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
Assert : func は"length" own property を持 たない拡張可能オブジェクトである。- !
DefinePropertyOrThrow (func,"length" , PropertyDescriptor { [[Value]]:𝔽 (length), [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:true }) を実行する。 unused を返す。
10.2.11 FunctionDeclarationInstantiation ( func, argumentsList )
The
ECMAScript 関数を評価するための
呼び出されると、次の手順を実行する:
- calleeContext を
running execution context とする。 - code を func.[[ECMAScriptCode]] とする。
- strict を func.[[Strict]] とする。
- formals を func.[[FormalParameters]] とす る。
- parameterNames を formals の
BoundNames とする。 - parameterNames が重複する要素を持つなら、
hasDuplicates を
true とする; そうでなけ れば hasDuplicates をfalse とする。 - simpleParameterList を formals の
IsSimpleParameterList とする。 - hasParameterExpressions を formals の
ContainsExpression とする。 - varNames を code の
VarDeclaredNames と する。 - varDeclarations を code の
VarScopedDeclarations とする。 - lexicalNames を code の
LexicallyDeclaredNames とする。 - functionNames を新しい空の
List とする。 - functionsToInitialize を新しい空の
List とす る。 - varDeclarations の各要素 varDecl につい
て、
List の逆順で、次を行う- varDecl が
VariableDeclaration でもForBinding でもBindingIdentifier でも ないなら、Assert : varDecl はFunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 、AsyncGeneratorDeclaration のいずれか である。- fn を varDecl の
BoundNames の唯一の 要素とする。 - functionNames が fn を含まないなら、
- fn を functionNames の先頭要素として 挿入する。
NOTE : 同じ名前に対して複数の function declaration がある場合、最後の宣言が用い られる。- varDecl を functionsToInitialize の先頭要素として挿入する。
- varDecl が
- argumentsObjectNeeded を
true とする。 - func.[[ThisMode]] が
lexical なら、NOTE : Arrow function は決して arguments object を持たない。- argumentsObjectNeeded を
false に設定 する。
- Else if parameterNames が
"arguments" を 含むなら、- argumentsObjectNeeded を
false に設定 する。
- argumentsObjectNeeded を
- Else if hasParameterExpressions が
false なら、- functionNames が
"arguments" を含むか、 または lexicalNames が"arguments" を 含むなら、- argumentsObjectNeeded を
false に設 定する。
- argumentsObjectNeeded を
- functionNames が
- strict が
true または hasParameterExpressions がfalse なら、NOTE :strict mode code 内のeval呼出し はevalの外から見える新しい束縛を作成で きないため、仮引数に対して必要なEnvironment Record は 1 つだけである。- env を calleeContext の LexicalEnvironment とする。
- Else,
NOTE : 仮引数リストにおけるdirect eval 呼 出しによって作成された束縛が、仮引数が宣言さ れる環境の外側になることを保証するために、別 のEnvironment Record が必要である。- calleeEnv を calleeContext の LexicalEnvironment とする。
- env を
NewDeclarativeEnvironment ( calleeEnv) とする。 Assert : calleeContext の VariableEnvironment と calleeEnv は同 じEnvironment Record である。- calleeContext の LexicalEnvironment を env に設定する。
- parameterNames の各 String paramName に
ついて、次を行う
- alreadyDeclared を
! env.
HasBinding (paramName) とする。 NOTE :early error により、重複仮引数名が 起こり得るのは、parameter default value や rest parameter を持たないnon-strict function に限られる。- alreadyDeclared が
false なら、- ! env.
CreateMutableBinding (paramName,false ) を実行する。 - hasDuplicates が
true なら、- ! env.
InitializeBinding (paramName,undefined ) を実行する。
- ! env.
- ! env.
- alreadyDeclared を
! env.
- argumentsObjectNeeded が
true なら、- strict が
true または simpleParameterList がfalse なら、- ao を
CreateUnmappedArgumentsObject ( argumentsList) とする。
- ao を
- Else,
NOTE : mapped argument object は、rest parameter、parameter default value initializer、または destructured parameter を持たないnon-strict function に対してのみ提供される。- ao を
CreateMappedArgumentsObject ( func, formals, argumentsList, env) とする。
- strict が
true なら、- ! env.
CreateImmutableBinding ("arguments" ,false ) を実行する。 NOTE :strict mode code ではearly error によりこの束縛への代入の試みは防が れるため、その可変性は観測不能である。
- ! env.
- Else,
- ! env.
CreateMutableBinding ("arguments" ,false ) を実行する。
- ! env.
- ! env.
InitializeBinding ("arguments" , ao) を実行する。 - parameterBindings を parameterNames と
«
"arguments" » のlist-concatenation とする。
- strict が
- Else,
- parameterBindings を parameterNames とする。
- iteratorRecord を
CreateListIteratorRecord (argumentsList) とす る。 - hasDuplicates が
true なら、- usedEnv を
undefined とする。
- usedEnv を
- Else,
- usedEnv を env とする。
NOTE : 次の手順がReturnCompletion を返すこと はない。なぜなら、式位置でそのような completion が生じる唯一の方法はYieldExpression の使用 によるが、これは15.5.1 および15.6.1 のearly error 規則により parameter list では禁止されているからである。- iteratorRecord および usedEnv を引数とす
る formals の
IteratorBindingInitialization を ? 実行する。 - hasParameterExpressions が
false なら、NOTE : 仮引数および top-level var に必要なEnvironment Record は 1 つだけである。- instantiatedVarNames を
List parameterBindings の copy とする。 - varNames の各要素 n について、次を行う
- instantiatedVarNames が n を含まなけ
れば、
- n を instantiatedVarNames に append する。
- ! env.
CreateMutableBinding (n,false ) を実行する。 - ! env.
InitializeBinding (n,undefined ) を実行する。
- instantiatedVarNames が n を含まなけ
れば、
- varEnv を env とする。
- Else,
NOTE : 仮引数リスト内の式によって作成された closure が、関数本体内の宣言を可視にしない ことを保証するために、別のEnvironment Record が必要である。- varEnv を
NewDeclarativeEnvironment ( env) とする。 - calleeContext の VariableEnvironment を varEnv に設定する。
- instantiatedVarNames を新しい空の
List とする。 - varNames の各要素 n について、次を行う
- instantiatedVarNames が n を含まなけ
れば、
- n を instantiatedVarNames に append する。
- ! varEnv.
CreateMutableBinding (n,false ) を実行する。 - parameterBindings が n を含まない
か、または functionNames が n を
含むなら、
- initialValue を
undefined とする。
- initialValue を
- Else,
- initialValue を
! env.
GetBindingValue (n,false ) とする。
- initialValue を
! env.
- ! varEnv.
InitializeBinding (n, initialValue) を実行する。 NOTE : 仮引数と同名の var は、初期状態で 対応する初期化済み仮引数と同じ値を持つ。
- instantiatedVarNames が n を含まなけ
れば、
- strict が
true なら、- lexEnv を varEnv とする。
- Else,
- ホスト
が web browser であるか、または
ブロックレベル Function Declaration の Web レガシー互換性意味論 をサポートするなら、- code
Contains x がtrue である 任意のBlock 、CaseClause 、DefaultClause x のStatementList に直接含まれる各FunctionDeclaration fnDecl について、次を行う- funcName を fnDecl の
BindingIdentifier のStringValue と する。 FunctionDeclaration fnDecl を funcName をBindingIdentifier と するVariableStatement に置き換えて も func に対していかなるearly error も生じず、かつ parameterNames が funcName を含まないなら、NOTE : funcName に対する var 束縛 は、それが VarDeclaredName でも、仮 引数名でも、別のFunctionDeclaration でもない場合に 限ってここでインスタンス化される。- instantiatedVarNames が
funcName を含まず、かつ funcName
が
"arguments" でないなら、- ! varEnv.
CreateMutableBinding ( funcName,false ) を実行する。 - ! varEnv.
InitializeBinding ( funcName,undefined ) を実行す る。 - funcName を instantiatedVarNames に append する。
- ! varEnv.
FunctionDeclaration fnDecl が評価されるとき、15.2.6 で与えられるFunctionDeclaration Evaluation algorithm の代わりに、次 の手順を実行する:- fEnv を
running execution context の VariableEnvironment とする。 - bEnv を
running execution context の LexicalEnvironment とする。 - fObj を
! bEnv.
GetBindingValue (funcName,false ) とする。 - ! fEnv.
SetMutableBinding ( funcName, fObj,false ) を 実行する。 unused を返す。
- fEnv を
- funcName を fnDecl の
- code
- lexEnv を
NewDeclarativeEnvironment ( varEnv) とする。 NOTE :non-strict function は、direct eval が eval code によって導入さ れる var scoped declaration が、既存の top-level lexically scoped declaration と conflict するかどうかを判定できるよう に、top-level lexical declaration のた めに別のEnvironment Record を用いる。strict function ではこれは不要である。な ぜなら strict なdirect eval は常に、すべ ての declaration を新しいEnvironment Record に配置するからである。
- ホスト
が web browser であるか、または
- calleeContext の LexicalEnvironment を lexEnv に設定する。
- lexDeclarations を code の
LexicallyScopedDeclarations とする。 - lexDeclarations の各要素 lexDecl につい
て、次を行う
NOTE : lexical に宣言された名前は、 function/generator declaration、仮引数、 または var 名と同じにはなり得ない。lexical に宣言された名前は、ここではインスタンス化の みが行われ、初期化は行われない。- lexDecl の
BoundNames の各要素 dn につ いて、次を行う- lexDecl の
IsConstantDeclaration がtrue なら、- ! lexEnv.
CreateImmutableBinding ( dn,true ) を実行する。
- ! lexEnv.
- Else,
- ! lexEnv.
CreateMutableBinding (dn,false ) を実行する。
- ! lexEnv.
- lexDecl の
- privateEnv を calleeContext の PrivateEnvironment とする。
- functionsToInitialize の各
Parse Node fnDecl について、次を行う- fn を fnDecl の
BoundNames の唯一の要 素とする。 - fo を lexEnv および privateEnv を引数
とする fnDecl の
InstantiateFunctionObject とする。 - ! varEnv.
SetMutableBinding (fn, fo,false ) を実行する。
- fn を fnDecl の
unused を返す。
10.3 組込み関数オブジェクト
組込み関数オブジェクトは通常オブジェクトである; それは
すべての通常オブジェクトに要求される内部スロット
（
- [[Realm]]: 関数が作成された
realm を表すRealm Record 。 - [[InitialName]]: 関数の初期名である String。
20.2.3.5 により使用される。 - [[Async]]: 関数が
BuiltinCallOrConstruct にお いて async な関数呼出しおよび構築の振る舞いを持つかど うかを示す Boolean。
別段の指定がない限り、組込み関数オブジェクトの
[[Prototype]] 内部スロットの初期値は
組込み関数オブジェクトは、
組込み関数オブジェクトは、それが “
実装は、この仕様で定義されていない追加の組込み関数オブ ジェクトを提供してよい。
10.3.1 [[Call]] ( thisArgument, argumentsList )
The [[Call]] internal method of a built-in
- ?
BuiltinCallOrConstruct (func, thisArgument, argumentsList,undefined ) を返す。
10.3.2 [[Construct]] ( argumentsList, newTarget )
The [[Construct]] internal method of a built-in
- result を ?
BuiltinCallOrConstruct (func,uninitialized , argumentsList, newTarget) と する。 Assert : result は Object である。- result を返す。
10.3.3 BuiltinCallOrConstruct ( func, thisArgument, argumentsList, newTarget )
The
- callerContext を
running execution context とする。 - callerContext がまだ suspend されていなけれ ば、callerContext を suspend する。
- calleeContext を新しい
execution context とする。 - calleeContext の Function を func に設定す る。
- calleeRealm を func.[[Realm]] とする。
- calleeContext の
Realm を calleeRealm に 設定する。 - calleeContext の ScriptOrModule を
null に設定する。 - calleeContext に対して必要な
implementation-defined な初期化を実行する。 - calleeContext を
execution context stack に push する; calleeContext はいまrunning execution context である。 - func.[[Async]] が
true なら、- promiseCapability を
!
NewPromiseCapability (%Promise% ) とする。 - resultsClosure を、引数を持たず、func、
thisArgument、argumentsList、および
newTarget を capture し、呼び出されたとき
次の手順を実行する新しい
Abstract Closure と する:- result を、func の仕様に適合する方法で
func を評価した結果である
Completion Record とする。 thisArgument がuninitialized なら、this 値は uninitialized である; そうでな ければ thisArgument がthis 値を与え る。argumentsList が名前付き引数を与え る。newTarget が NewTarget 値を与える。 NOTE : func がこの文書で定義されている場合、 “func の仕様” とは、algorithm step ま たはその他の手段により指定されたその振る舞い である。Completion (result) を返す。
- result を、func の仕様に適合する方法で
func を評価した結果である
AsyncFunctionStart (promiseCapability, resultsClosure) を実行する。- calleeContext を
execution context stack から取り除き、callerContext をrunning execution context として復元する。 - promiseCapability.[[Promise]] を返す。
- promiseCapability を
!
- result
を、func の仕様に適合する方法で func を
評価した結果である
Completion Record とする。thisArgument がuninitialized なら、this 値は uninitialized である; そう でなければ thisArgument がthis 値を与え る。argumentsList が名前付き引数を与える。 newTarget が NewTarget 値を与える。 NOTE : func がこの文書で定義されている場合、 “func の仕様” とは、algorithm step または その他の手段により指定されたその振る舞いである。- calleeContext を
execution context stack から取り除き、callerContext をrunning execution context として復元する。 - ? result を返す。
calleeContext が
10.3.4 CreateBuiltinFunction ( behaviour, length, name, additionalInternalSlotsList [ , realm [ , prototype [ , prefix [ , async ] ] ] ] )
The
- realm が与えられていなければ、realm を
current Realm Record に設定する。 - prototype が与えられていなければ、
prototype を
realm.[[Intrinsics]].[[
%Function.prototype% ]] に設定する。 - async が与えられていなければ、async を
false に設定する。 - internalSlotsList を、これから作成される組
込み関数オブジェクトに
10.3 が要求するすべての内部スロットの名前を含むList とする。 - additionalInternalSlotsList の要素を internalSlotsList に append する。
- func を新しい組込み関数オブジェクトとする。こ の関数オブジェクトは、呼び出されると、 behaviour に記述された action を、与えられ た引数を behaviour により指定される対応する parameter の値として用いて実行する。新しい関 数オブジェクトは、その名前が internalSlotsList の要素である内部スロット と、[[InitialName]] internal slot を持つ。
- func.[[Async]] を async に設定する。
- func.[[Prototype]] を prototype に設定す る。
- func.[[Extensible]] を
true に設定する。 - func.[[Realm]] を realm に設定する。
- func.[[InitialName]] を
null に設定する。 SetFunctionLength (func, length) を実行す る。- prefix が与えられていなければ、
SetFunctionName (func, name) を実行す る。
- Else,
SetFunctionName (func, name, prefix) を実行する。
- func を返す。
この仕様で定義される各組込み関数は、 CreateBuiltinFunction 抽象操作を呼び出すことによって 作成される。
10.4 組込み特殊オブジェクトの内部メソッドとスロット
この仕様は、数種類の組込み特殊オブジェクトを定義する。 これらのオブジェクトは、いくつかの特定状況を除いて、一般 に通常オブジェクトと類似した振る舞いをする。以下の特殊オ ブジェクトは、以下で明示的に別段の指定がある場合を除き、 通常オブジェクトの内部メソッドを用いる:
10.4.1 束縛関数特殊オブジェクト
オブジェクトが 束縛関数特殊オブジェクト
であるのは、その [[Call]] および（該当する場合）
[[Construct]] 内部メソッドが次の実装を用い、かつ他の本質
的内部メソッドが
| 内部スロット | 型 | 説明 |
|---|---|---|
| [[BoundTargetFunction]] | a callable Object | 包まれている関数オブジェクト。 |
| [[BoundThis]] | an ECMAScript language value |
包まれた関数を呼び出すときに、常に |
| [[BoundArguments]] |
a |
その要素が、包まれた関数へのあらゆる呼出しに おいて最初の引数として用いられる値の list。 |
10.4.1.1 [[Call]] ( thisArgument, argumentsList )
The [[Call]] internal method of a bound function
- target を func.[[BoundTargetFunction]] とす る。
- boundThis を func.[[BoundThis]] とする。
- boundArgs を func.[[BoundArguments]] とす る。
- args を boundArgs と argumentsList
の
list-concatenation とする。 - ?
Call (target, boundThis, args) を返 す。
10.4.1.2 [[Construct]] ( argumentsList, newTarget )
The [[Construct]] internal method of a bound function
- target を func.[[BoundTargetFunction]] とす る。
Assert :IsConstructor (target) istrue .- boundArgs を func.[[BoundArguments]] と する。
- args を boundArgs と argumentsList
の
list-concatenation とする。 SameValue (func, newTarget) がtrue なら、newTarget を target に設定する。- ?
Construct (target, args, newTarget) を返す。
10.4.1.3 BoundFunctionCreate ( targetFunction, boundThis, boundArgs )
The
- proto を ? targetFunction.[[GetPrototypeOf]]() とする。
- internalSlotsList を
« [[Prototype]], [[Extensible]] » と
Table 26 に列挙された内部スロットのlist-concatenation とする。 - obj を
MakeBasicObject (internalSlotsList) とする。 - obj.[[Prototype]] を proto に設定する。
- obj.[[Call]] を
10.4.1.1 に規定されたとおりに設定する。 IsConstructor (targetFunction) がtrue な ら、- obj.[[Construct]] を
10.4.1.2 に規定されたとおりに設定する。
- obj.[[Construct]] を
- obj.[[BoundTargetFunction]] を targetFunction に設定する。
- obj.[[BoundThis]] を boundThis に設定す る。
- obj.[[BoundArguments]] を boundArgs に設 定する。
- obj を返す。
10.4.2 配列特殊オブジェクト
Array は、
オブジェクトが Array 特殊オブジェクト
（または単に Array）であるのは、その [[DefineOwnProperty]]
内部メソッドが次の実装を用い、かつ他の本質的内部メソッド
が
10.4.2.1 [[DefineOwnProperty]] ( propertyKey, desc )
The [[DefineOwnProperty]] internal method of an Array
- propertyKey が
"length" なら、 ?ArraySetLength (array, desc) を返す。 - propertyKey が
array index なら、- lengthDesc を
OrdinaryGetOwnProperty ( array,"length" ) とする。 Assert : lengthDesc はundefined では ない。Assert :IsDataDescriptor (lengthDesc) istrue .Assert : lengthDesc.[[Configurable]] isfalse .- length を lengthDesc.[[Value]] とする。
Assert : length は非負整数 Number である。- index を !
ToUint32 (propertyKey) とする。 - index ≥ length かつ
lengthDesc.[[Writable]] が
false な ら、false を返す。 - succeeded を
!
OrdinaryDefineOwnProperty (array, propertyKey, desc) とする。 - succeeded が
false なら、false を 返す。 - index ≥ length なら、
- lengthDesc.[[Value]] を
index +
1 𝔽 に設定する。 - succeeded を
!
OrdinaryDefineOwnProperty (array,"length" , lengthDesc) に設定する。 Assert : succeeded istrue .
- lengthDesc.[[Value]] を
index +
true を返す。
- lengthDesc を
- ?
OrdinaryDefineOwnProperty (array, propertyKey, desc) を返す。
10.4.2.2 ArrayCreate ( length [ , proto ] )
The
- length > 232 - 1 なら、
RangeError 例外を送出する。 - 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
- isArray を ?
IsArray (originalArray) とす る。 - isArray が
false なら、 ?ArrayCreate (length) を返す。 - constructor を
?
Get (originalArray,"constructor" ) とする。 IsConstructor (constructor) がtrue な ら、- thisRealm を
current Realm Record とす る。 - constructorRealm を
?
GetFunctionRealm (constructor) とす る。 - thisRealm と constructorRealm が同
じ
Realm Record でないなら、
- thisRealm を
- constructor が Object なら、
- constructor を
?
Get (constructor,%Symbol.species% ) に設定する。 - constructor が
null なら、 constructor をundefined に設定する。
- constructor を
?
- constructor が
undefined なら、 ?ArrayCreate (length) を返す。 IsConstructor (constructor) がfalse な ら、TypeError 例外を送出する。- ?
Construct (constructor, «𝔽 (length) ») を返す。
originalArray が、Array.prototype メソッドについて、歴史的にそのよう
な挙動を持っていた Web browser との互換性が維持され
る。
10.4.2.4 ArraySetLength ( array, desc )
The
- desc が [[Value]] フィールドを持たないなら、
- !
OrdinaryDefineOwnProperty (array,"length" , desc) を返す。
- !
- newLenDesc を desc の copy とする。
- newLen を
?
ToUint32 (desc.[[Value]]) とする。 - numberLen
を ?
ToNumber (desc.[[Value]]) とする。 SameValueZero (newLen, numberLen) がfalse なら、RangeError 例外を送出す る。- newLenDesc.[[Value]] を newLen に設定す る。
- oldLenDesc を
OrdinaryGetOwnProperty ( array,"length" ) とする。 Assert : oldLenDesc はundefined では ない。Assert :IsDataDescriptor (oldLenDesc) istrue .Assert : oldLenDesc.[[Configurable]] isfalse .- oldLen を oldLenDesc.[[Value]] とする。
- newLen ≥ oldLen なら、
- !
OrdinaryDefineOwnProperty (array,"length" , newLenDesc) を返す。
- !
- oldLenDesc.[[Writable]] が
false な ら、false を返す。 - newLenDesc が [[Writable]] フィールドを持
たないか、または newLenDesc.[[Writable]]
が
true なら、- newWritable を
true とする。
- newWritable を
- Else,
NOTE : いずれかの element を削除できない場 合に備えて、[[Writable]] 属性をfalse に設定するのは延期される。- newWritable を
false とする。 - newLenDesc.[[Writable]] を
true に設 定する。
- succeeded を
!
OrdinaryDefineOwnProperty (array,"length" , newLenDesc) とする。 - succeeded が
false なら、false を返 す。 - array の各 own
property key propertyKey について、propertyKey がarray index であり、かつ !ToUint32 (propertyKey) ≥ newLen であ るものを、数値 index 降順で処理し、次を行う- deleteSucceeded を ! array.[[Delete]](propertyKey) とす る。
- deleteSucceeded が
false なら、- newLenDesc.[[Value]] を
!
ToUint32 (propertyKey) +1 𝔽 に設定する。 - newWritable が
false なら、 newLenDesc.[[Writable]] をfalse に設定する。 - !
OrdinaryDefineOwnProperty (array,"length" , newLenDesc) を実行す る。 false を返す。
- newLenDesc.[[Value]] を
!
- newWritable が
false なら、- succeeded を
!
OrdinaryDefineOwnProperty (array,"length" , PropertyDescriptor { [[Writable]]:false }) に設定する。 Assert : succeeded istrue .
- succeeded を
!
true を返す。
10.4.3 文字列特殊オブジェクト
String object は、String 値をカプセル化し、その
String 値の個々の code unit 要素に対応する仮想的な整数
index 付き
オブジェクトが String 特殊オブジェクト
（または単に String object）であるのは、その
[[GetOwnProperty]]、[[DefineOwnProperty]]、
[[OwnPropertyKeys]] 内部メソッドが次の実装を用い、かつ
他の本質的内部メソッドが
10.4.3.1 [[GetOwnProperty]] ( propertyKey )
The [[GetOwnProperty]] internal method of a String
- desc を
OrdinaryGetOwnProperty (str, propertyKey) とする。 - desc が
undefined でなければ、 desc を返す。 StringGetOwnProperty (str, propertyKey) を返す。
10.4.3.2 [[DefineOwnProperty]] ( propertyKey, desc )
The [[DefineOwnProperty]] internal method of a String
- stringDesc を
StringGetOwnProperty (str, propertyKey) とする。 - stringDesc が
undefined でなければ、- extensible を str.[[Extensible]] とす る。
IsCompatiblePropertyDescriptor ( extensible, desc, stringDesc) を返 す。
- !
OrdinaryDefineOwnProperty (str, propertyKey, desc) を返す。
10.4.3.3 [[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of a String
- keys を新しい空の
List とする。 - str を obj.[[StringData]] とする。
Assert : str は String である。- len を str の長さとする。
- 0 ≤ i < len を満たす各整数 i につい て、昇順で、次を行う
- obj の各 own
property key propertyKey について、propertyKey がarray index で あり、かつ !ToIntegerOrInfinity ( propertyKey) ≥ len であるものを、数値 index 昇順で処理し、次を行う- propertyKey を keys に append する。
- obj の各 own
property key propertyKey について、propertyKey が String であり、 かつarray index ではないものを、プロパティ 作成時刻の昇順で処理し、次を行う- propertyKey を keys に append する。
- obj の各 own
property key propertyKey について、propertyKey が Symbol である ものを、プロパティ作成時刻の昇順で処理し、次を 行う- propertyKey を keys に append する。
- keys を返す。
10.4.3.4 StringCreate ( value, prototype )
The
- str を
MakeBasicObject ( « [[Prototype]], [[Extensible]], [[StringData]] ») とする。 - str.[[Prototype]] を prototype に設定す る。
- str.[[StringData]] を value に設定する。
- str.[[GetOwnProperty]] を
10.4.3.1 に規定されたとおりに設定する。 - str.[[DefineOwnProperty]] を
10.4.3.2 に規定されたとおりに設定する。 - str.[[OwnPropertyKeys]] を
10.4.3.3 に規定されたとおりに設定する。 - length を value の長さとする。
- !
DefinePropertyOrThrow (str,"length" , PropertyDescriptor { [[Value]]:𝔽 (length), [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - str を返す。
10.4.3.5 StringGetOwnProperty ( str, propertyKey )
The
- propertyKey が String でなければ、
undefined を返す。 - index を
CanonicalNumericIndexString (propertyKey) とする。 - index が整数 Number でなければ、
undefined を返す。 - index が
-0 𝔽 であるか、また は index <-0 𝔽 なら、undefined を返す。 - stringData を str.[[StringData]] とす る。
Assert : stringData は String である。- len を stringData の長さとする。
ℝ (index) ≥ len なら、undefined を返 す。- resultStr を、
ℝ (index) からℝ (index) + 1 までの stringData のsubstring とする。 - PropertyDescriptor { [[Value]]: resultStr,
[[Writable]]:
false , [[Enumerable]]:true , [[Configurable]]:false } を返す。
10.4.4 Arguments 特殊オブジェクト
ほとんどの ECMAScript 関数は、そのコードから利用可能
な arguments object を作成する。関数定義の特性に応じ
て、その arguments object は通常オブジェクトまたは
オブジェクトが arguments 特殊オブジェクト
であるのは、その内部メソッドが次の実装を用い、ここで指定
されていないものは
Object.prototype.toString
（
対応する関数オブジェクトの仮引数の数より小さい数値名を
持つ
ParameterMap object とその property 値は、 arguments object と引数束縛との対応を規定するための仕 組みとして用いられる。ParameterMap object と、そのプ ロパティの値であるオブジェクトは、ECMAScript code から 直接観測可能ではない。ECMAScript 実装は、指定された意味 論を実装するために、そのようなオブジェクトを実際に作成し たり使用したりする必要はない。
通常の arguments object は、
ECMAScript 実装の
10.4.4.1 [[GetOwnProperty]] ( propertyKey )
The [[GetOwnProperty]] internal method of an arguments
- desc を
OrdinaryGetOwnProperty (args, propertyKey) とする。 - desc が
undefined なら、undefined を 返す。 - map を args.[[ParameterMap]] とする。
- isMapped を !
HasOwnProperty (map, propertyKey) とする。 - isMapped が
true なら、- desc.[[Value]] を !
Get (map, propertyKey) に設定する。
- desc.[[Value]] を !
- desc を返す。
10.4.4.2 [[DefineOwnProperty]] ( propertyKey, desc )
The [[DefineOwnProperty]] internal method of an arguments
- map を args.[[ParameterMap]] とする。
- isMapped を !
HasOwnProperty (map, propertyKey) とする。 - newArgDesc を desc とする。
- isMapped が
true かつIsDataDescriptor (desc) がtrue なら、- desc が [[Value]] フィールドを持たず、
desc が [[Writable]] フィールドを持ち、
かつ desc.[[Writable]] が
false な ら、- newArgDesc を desc の copy に設定 する。
- newArgDesc.[[Value]] を !
Get (map, propertyKey) に設定する。
- desc が [[Value]] フィールドを持たず、
desc が [[Writable]] フィールドを持ち、
かつ desc.[[Writable]] が
- allowed を
!
OrdinaryDefineOwnProperty (args, propertyKey, newArgDesc) とする。 - allowed が
false なら、false を返 す。 - isMapped が
true なら、IsAccessorDescriptor (desc) がtrue な ら、- ! map.[[Delete]](propertyKey) を実 行する。
- Else,
true を返す。
10.4.4.3 [[Get]] ( propertyKey, receiver )
The [[Get]] internal method of an arguments
- map を args.[[ParameterMap]] とする。
- isMapped を !
HasOwnProperty (map, propertyKey) とする。 - isMapped が
false なら、 ?OrdinaryGet (args, propertyKey, receiver) を返す。 Assert : map は propertyKey に対する仮 引数対応付けを含む。- !
Get (map, propertyKey) を返す。
10.4.4.4 [[Set]] ( propertyKey, value, receiver )
The [[Set]] internal method of an arguments
SameValue (args, receiver) がfalse な ら、- isMapped を
false とする。
- isMapped を
- Else,
- 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 an arguments
- map を args.[[ParameterMap]] とする。
- isMapped を !
HasOwnProperty (map, propertyKey) とする。 - result を ?
OrdinaryDelete (args, propertyKey) とする。 - result が
true かつ isMapped がtrue なら、- ! map.[[Delete]](propertyKey) を実行す る。
- result を返す。
10.4.4.6 CreateUnmappedArgumentsObject ( argumentsList )
The
- len を argumentsList の要素数とする。
- obj を
OrdinaryObjectCreate (%Object.prototype% , « [[ParameterMap]] ») とする。 - obj.[[ParameterMap]] を
undefined に設 定する。 - !
DefinePropertyOrThrow (obj,"length" , PropertyDescriptor { [[Value]]:𝔽 (len), [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true }) を実行する。 - index を 0 とする。
- index < len の間、繰り返す
- val を argumentsList[index] とす る。
- !
CreateDataPropertyOrThrow (obj, !ToString (𝔽 (index)), val) を実行す る。 - index を index + 1 に設定する。
- !
DefinePropertyOrThrow (obj,%Symbol.iterator% , PropertyDescriptor { [[Value]]: %Array.prototype.values%, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true }) を実行する。 - !
DefinePropertyOrThrow (obj,"callee" , PropertyDescriptor { [[Get]]:%ThrowTypeError% , [[Set]]:%ThrowTypeError% , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - obj を返す。
10.4.4.7 CreateMappedArgumentsObject ( func, formals, argumentsList, env )
The
Assert : formals は rest parameter、 binding pattern、またはいかなる initializer も含まない。重複識別子を含んでもよい。- len を argumentsList の要素数とする。
- 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 に設定す る。
- parameterNames を formals の
BoundNames とする。 - numberOfParameters を parameterNames の要素数とする。
- index を 0 とする。
- index < len の間、繰り返す
- val を argumentsList[index] とす る。
- !
CreateDataPropertyOrThrow (obj, !ToString (𝔽 (index)), val) を実行す る。 - index を index + 1 に設定する。
- !
DefinePropertyOrThrow (obj,"length" , PropertyDescriptor { [[Value]]:𝔽 (len), [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:true }) を実行する。 - mappedNames を新しい空の
List とする。 - index を numberOfParameters - 1 に設定 する。
- index ≥ 0 の間、繰り返す
- name を parameterNames[index] とす る。
- mappedNames が name を含まないなら、
- name を mappedNames に append す る。
- index < len なら、
- getter を
MakeArgGetter (name, env) とする。 - setter を
MakeArgSetter (name, env) とする。 - ! 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, env )
The
- getterClosure を、引数を持たず、name
と env を capture し、呼び出されたとき
次の手順を実行する新しい
Abstract Closure とする:NormalCompletion ( ! env.GetBindingValue (name,false )) を返す。
- getter を
CreateBuiltinFunction ( getterClosure, 0,"" , « ») とする。 NOTE : getter は ECMAScript code から直 接アクセス可能になることはない。- getter を返す。
10.4.4.7.2 MakeArgSetter ( name, env )
The
- setterClosure を、(value) を引数とし、
name と env を capture し、呼び出された
とき次の手順を実行する新しい
Abstract Closure とする:NormalCompletion ( ! env.SetMutableBinding (name, value,false )) を返す。
- setter を
CreateBuiltinFunction ( setterClosure, 1,"" , « ») とす る。 NOTE : setter は ECMAScript code から直 接アクセス可能になることはない。- setter を返す。
10.4.5 TypedArray 特殊オブジェクト
任意の Number n に対する
オブジェクトが TypedArray
であるのは、その [[PreventExtensions]]、
[[GetOwnProperty]]、[[HasProperty]]、
[[DefineOwnProperty]]、[[Get]]、[[Set]]、
[[Delete]]、および [[OwnPropertyKeys]] 内部メソッド
がこの節の定義を用い、かつ他の本質的内部メソッドが
10.4.5.1 [[PreventExtensions]] ( )
The [[PreventExtensions]] internal method of a
NOTE :6.1.7.3 に規定された拡張可能性関連の不変条件は、基底 buffer の resize によって整数 index 名の property が増える（または減ってから再び増え る）可能性があるとき、obj に対してこのメソ ッドがtrue を返すことを許さない。IsTypedArrayFixedLength (obj) がfalse なら、false を返す。OrdinaryPreventExtensions (obj) を返す。
10.4.5.2 [[GetOwnProperty]] ( propertyKey )
The [[GetOwnProperty]] internal method of a
- propertyKey が String なら、
- numericIndex を
CanonicalNumericIndexString (propertyKey) とする。 - numericIndex が
undefined でなけれ ば、- value を
TypedArrayGetElement (obj, numericIndex) とする。 - value が
undefined なら、undefined を返す。 - PropertyDescriptor { [[Value]]:
value, [[Writable]]:
true , [[Enumerable]]:true , [[Configurable]]:true } を返す。
- value を
- numericIndex を
OrdinaryGetOwnProperty (obj, propertyKey) を返す。
10.4.5.3 [[HasProperty]] ( propertyKey )
The [[HasProperty]] internal method of a
- propertyKey が String なら、
- numericIndex を
CanonicalNumericIndexString (propertyKey) とする。 - numericIndex が
undefined でなけれ ば、IsValidIntegerIndex (obj, numericIndex) を返す。
- numericIndex を
- ?
OrdinaryHasProperty (obj, propertyKey) を返す。
10.4.5.4 [[DefineOwnProperty]] ( propertyKey, desc )
The [[DefineOwnProperty]] internal method of a
- propertyKey が String なら、
- numericIndex を
CanonicalNumericIndexString (propertyKey) とする。 - numericIndex が
undefined でなけれ ば、IsValidIntegerIndex (obj, numericIndex) がfalse なら、false を返す。- desc が [[Configurable]] フィールド
を持ち、かつ desc.[[Configurable]] が
false なら、false を返す。 - desc が [[Enumerable]] フィールドを持
ち、かつ desc.[[Enumerable]] が
false なら、false を返す。 IsAccessorDescriptor (desc) がtrue なら、false を返す。- desc が [[Writable]] フィールドを持
ち、かつ desc.[[Writable]] が
false なら、false を返す。 - desc が [[Value]] フィールドを持つな
ら、?
TypedArraySetElement (obj, numericIndex, desc.[[Value]]) を 実行する。 true を返す。
- numericIndex を
- !
OrdinaryDefineOwnProperty (obj, propertyKey, desc) を返す。
10.4.5.5 [[Get]] ( propertyKey, receiver )
The [[Get]] internal method of a
- propertyKey が String なら、
- numericIndex を
CanonicalNumericIndexString (propertyKey) とする。 - numericIndex が
undefined でなけれ ば、TypedArrayGetElement (obj, numericIndex) を返す。
- numericIndex を
- ?
OrdinaryGet (obj, propertyKey, receiver) を返す。
10.4.5.6 [[Set]] ( propertyKey, value, receiver )
The [[Set]] internal method of a
- propertyKey が String なら、
- numericIndex を
CanonicalNumericIndexString (propertyKey) とする。 - numericIndex が
undefined でなけれ ば、SameValue (obj, receiver) がtrue なら、- ?
TypedArraySetElement (obj, numericIndex, value) を実行する。 true を返す。
- ?
IsValidIntegerIndex (obj, numericIndex) がfalse なら、true を返す。
- numericIndex を
- ?
OrdinarySet (obj, propertyKey, value, receiver) を返す。
10.4.5.7 [[Delete]] ( propertyKey )
The [[Delete]] internal method of a
- propertyKey が String なら、
- numericIndex を
CanonicalNumericIndexString (propertyKey) とする。 - numericIndex が
undefined でなけれ ば、IsValidIntegerIndex (obj, numericIndex) がfalse なら、true を返す。false を返す。
- numericIndex を
- !
OrdinaryDelete (obj, propertyKey) を返 す。
10.4.5.8 [[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of a
- taRecord を
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst ) とする。 - keys を新しい空の
List とする。 IsTypedArrayOutOfBounds (taRecord) がfalse なら、- length を
TypedArrayLength (taRecord) とする。 - 0 ≤ i < length を満たす各整数 i に ついて、昇順で、次を行う
- length を
- obj の各 own
property key propertyKey について、propertyKey が String であり、 かつinteger index ではないものを、プロパテ ィ作成時刻の昇順で処理し、次を行う- propertyKey を keys に append する。
- obj の各 own
property key propertyKey について、propertyKey が Symbol であるも のを、プロパティ作成時刻の昇順で処理し、次を行 う- propertyKey を keys に append す る。
- keys を返す。
10.4.5.9 TypedArray With Buffer Witness Record
TypedArray With Buffer Witness Record
は、
TypedArray With Buffer Witness Record は
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Object]] |
a |
その buffer の byte length が読み込まれ
る |
| [[CachedBufferByteLength]] |
a non-negative |
この |
10.4.5.10 MakeTypedArrayWithBufferWitnessRecord ( obj, order )
The
- buffer を obj.[[ViewedArrayBuffer]] とす る。
IsDetachedBuffer (buffer) がtrue な ら、- byteLength を
detached とする。
- byteLength を
- Else,
- byteLength を
ArrayBufferByteLength ( buffer, order) とする。
- byteLength を
TypedArray With Buffer Witness Record { [[Object]]: obj, [[CachedBufferByteLength]]: byteLength } を返す。
10.4.5.11 TypedArrayCreate ( prototype )
The
- internalSlotsList を « [[Prototype]], [[Extensible]], [[ViewedArrayBuffer]], [[TypedArrayName]], [[ContentType]], [[ByteLength]], [[ByteOffset]], [[ArrayLength]] » とする。
- typedArray を
MakeBasicObject (internalSlotsList) とす る。 - typedArray.[[PreventExtensions]] を
10.4.5.1 に規定されたとおりに設定する。 - typedArray.[[GetOwnProperty]] を
10.4.5.2 に規定されたとおりに設定する。 - typedArray.[[HasProperty]] を
10.4.5.3 に規定されたとおりに設定する。 - typedArray.[[DefineOwnProperty]] を
10.4.5.4 に規定されたとおりに設定する。 - typedArray.[[Get]] を
10.4.5.5 に規定されたとおりに設定する。 - typedArray.[[Set]] を
10.4.5.6 に規定されたとおりに設定する。 - typedArray.[[Delete]] を
10.4.5.7 に規定されたとおりに設定する。 - typedArray.[[OwnPropertyKeys]] を
10.4.5.8 に規定されたとおりに設定する。 - typedArray.[[Prototype]] を prototype に 設定する。
- typedArray を返す。
10.4.5.12 TypedArrayByteLength ( taRecord )
The
Assert :IsTypedArrayOutOfBounds (taRecord) isfalse .- obj を taRecord.[[Object]] とする。
- obj.[[ByteLength]] が
auto でなけれ ば、obj.[[ByteLength]] を返す。 - length を
TypedArrayLength (taRecord) とする。 - elementSize を
TypedArrayElementSize (obj) とする。 NOTE : 返される byte length は、基底 buffer が非整数倍に resize されている場合でも、常 に elementSize の整数倍である。- length × elementSize を返す。
10.4.5.13 TypedArrayLength ( taRecord )
The
Assert :IsTypedArrayOutOfBounds (taRecord) isfalse .- obj を taRecord.[[Object]] とする。
- obj.[[ArrayLength]] が
auto でなけれ ば、obj.[[ArrayLength]] を返す。 Assert :IsFixedLengthArrayBuffer ( obj.[[ViewedArrayBuffer]]) isfalse .- byteOffset を obj.[[ByteOffset]] とす る。
- elementSize を
TypedArrayElementSize (obj) とする。 - byteLength を taRecord.[[CachedBufferByteLength]] とす る。
Assert : byteLength はdetached ではな い。floor ((byteLength - byteOffset) / elementSize) を返す。
10.4.5.14 IsTypedArrayOutOfBounds ( taRecord )
The
- obj を taRecord.[[Object]] とする。
- bufferByteLength を taRecord.[[CachedBufferByteLength]] とす る。
IsDetachedBuffer (obj.[[ViewedArrayBuffer]]) がtrue なら、Assert : bufferByteLength はdetached である。true を返す。
Assert : bufferByteLength は非負整数であ る。- byteOffsetStart を obj.[[ByteOffset]] とする。
- obj.[[ArrayLength]] が
auto なら、- byteOffsetEnd を bufferByteLength とする。
- Else,
- elementSize を
TypedArrayElementSize (obj) とする。 - arrayByteLength を obj.[[ArrayLength]] × elementSize とする。
- byteOffsetEnd を byteOffsetStart + arrayByteLength とする。
- elementSize を
NOTE : [[ByteOffset]] が bufferByteLength である長さ 0 のTypedArray は、範囲外とは みなされない。- byteOffsetStart > bufferByteLength
または byteOffsetEnd > bufferByteLength
なら、
true を返す。 false を返す。
10.4.5.15 IsTypedArrayFixedLength ( obj )
The
- obj.[[ArrayLength]] が
auto なら、false を返す。 - buffer を obj.[[ViewedArrayBuffer]] とする。
IsFixedLengthArrayBuffer (buffer) がfalse かつIsSharedArrayBuffer (buffer) がfalse なら、false を返す。true を返す。
10.4.5.16 IsValidIntegerIndex ( obj, index )
The
IsDetachedBuffer (obj.[[ViewedArrayBuffer]]) がtrue なら、false を返す。- index が整数 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
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
- obj.[[ContentType]] が
bigint なら、 numValue を ?ToBigInt (value) とする。 - Else, numValue を ?
ToNumber (value) とす る。 IsValidIntegerIndex (obj, index) がtrue なら、- offset を obj.[[ByteOffset]] とする。
- elementSize を
TypedArrayElementSize (obj) とする。 - byteIndexInBuffer を
(
ℝ (index) × elementSize) + offset とする。 - elementType を
TypedArrayElementType (obj) とする。 SetValueInBuffer (obj.[[ViewedArrayBuffer]], byteIndexInBuffer, elementType, numValue,true ,unordered ) を実行す る。
unused を返す。
この操作は常に成功したように見えるが、
10.4.5.19 IsArrayBufferViewOutOfBounds ( obj )
The
- obj が [[DataView]] internal slot を持つ
なら、
- viewRecord を
MakeDataViewWithBufferWitnessRecord ( obj,seq-cst ) とする。 IsViewOutOfBounds (viewRecord) を返す。
- viewRecord を
- taRecord を
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst ) とする。 IsTypedArrayOutOfBounds (taRecord) を返す。
10.4.6 モジュール名前空間特殊オブジェクト
export * export item を用いて間接
的に export された束縛も含まれる。各 String 値の own
オブジェクトが module namespace 特殊オブジェクト
であるのは、その [[GetPrototypeOf]]、
[[SetPrototypeOf]]、[[IsExtensible]]、
[[PreventExtensions]]、[[GetOwnProperty]]、
[[DefineOwnProperty]]、[[HasProperty]]、[[Get]]、
[[Set]]、[[Delete]]、および [[OwnPropertyKeys]]
内部メソッドがこの節の定義を用い、かつ他の本質的内部メソ
ッドが
10.4.6.1 [[GetPrototypeOf]] ( )
The [[GetPrototypeOf]] internal method of a module namespace
null を返す。
10.4.6.2 [[SetPrototypeOf]] ( proto )
The [[SetPrototypeOf]] internal method of a module namespace
- !
SetImmutablePrototype (obj, proto) を返 す。
10.4.6.3 [[IsExtensible]] ( )
The [[IsExtensible]] internal method of a module namespace
false を返す。
10.4.6.4 [[PreventExtensions]] ( )
The [[PreventExtensions]] internal method of a module namespace
true を返す。
10.4.6.5 [[GetOwnProperty]] ( propertyKey )
The [[GetOwnProperty]] internal method of a module namespace
- 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, desc )
The [[DefineOwnProperty]] internal method of a module namespace
- propertyKey が Symbol なら、
!
OrdinaryDefineOwnProperty (obj, propertyKey, desc) を返す。 - current を ? obj.[[GetOwnProperty]]( propertyKey) とする。
- current が
undefined なら、false を返す。 - desc が [[Configurable]] フィールドを持ち、
かつ desc.[[Configurable]] が
true な ら、false を返す。 - desc が [[Enumerable]] フィールドを持ち、
かつ desc.[[Enumerable]] が
false な ら、false を返す。 IsAccessorDescriptor (desc) がtrue な ら、false を返す。- desc が [[Writable]] フィールドを持ち、
かつ desc.[[Writable]] が
false なら、false を返す。 - desc が [[Value]] フィールドを持つなら、
SameValue (desc.[[Value]], current.[[Value]]) を返す。 true を返す。
10.4.6.7 [[HasProperty]] ( propertyKey )
The [[HasProperty]] internal method of a module namespace
- propertyKey が Symbol なら、
!
OrdinaryHasProperty (obj, propertyKey) を返す。 - exports を obj.[[Exports]] とする。
- exports が propertyKey を含むなら、
true を返す。 false を返す。
10.4.6.8 [[Get]] ( propertyKey, receiver )
The [[Get]] internal method of a module namespace
- 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 例外を送出する。 - ? targetEnv.
GetBindingValue ( binding.[[BindingName]],true ) を返す。
10.4.6.9 [[Set]] ( propertyKey, value, receiver )
The [[Set]] internal method of a module namespace
false を返す。
10.4.6.10 [[Delete]] ( propertyKey )
The [[Delete]] internal method of a module namespace
- propertyKey が Symbol なら、
- !
OrdinaryDelete (obj, propertyKey) を返 す。
- !
- exports を obj.[[Exports]] とする。
- exports が propertyKey を含むなら、
false を返す。 true を返す。
10.4.6.11 [[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of a module namespace
- exports を obj.[[Exports]] とする。
- symbolKeys を
OrdinaryOwnPropertyKeys (obj) とする。 - exports と symbolKeys の
list-concatenation を返す。
10.4.6.12 ModuleNamespaceCreate ( module, exports )
The
Assert : module.[[Namespace]] isempty .- internalSlotsList を
Table 28 に列挙された内部スロットとする。 - namespace を
MakeBasicObject (internalSlotsList) とす る。 - namespace の本質的内部メソッドを
10.4.6 に規定された定義に設定する。 - namespace.[[Module]] を module に設定す る。
- sortedExports を、exports の要素を
code unit の辞書順に整列した
List とする。 - namespace.[[Exports]] を sortedExports に設定する。
28.3 の定義に対応する own property を namespace に作成する。- module.[[Namespace]] を namespace に設 定する。
- namespace を返す。
10.4.7 不変プロトタイプ特殊オブジェクト
オブジェクトが 不変プロトタイプ特殊オブジェクト
であるのは、その [[SetPrototypeOf]] 内部メソッドが次の
実装を用いる場合である。（そのほかの本質的内部メソッド
は、対象となる具体的な
他の特殊オブジェクトと異なり、不変プロトタイプ特殊オ
ブジェクトに対しては専用の作成抽象操作は提供されていな
い。これは、それらが
10.4.7.1 [[SetPrototypeOf]] ( proto )
The [[SetPrototypeOf]] internal method of an immutable prototype
- ?
SetImmutablePrototype (obj, proto) を返 す。
10.4.7.2 SetImmutablePrototype ( obj, proto )
The
- current を ? obj.[[GetPrototypeOf]]() とする。
SameValue (proto, current) がtrue なら、true を返す。false を返す。
10.5 Proxy オブジェクトの内部メソッドと内部スロット
Proxy オブジェクトは、その本質的内部メソッドが
ECMAScript code を用いて部分的に実装される特殊オブジェ
クトである。すべての Proxy オブジェクトは
[[ProxyHandler]] と呼ばれる内部スロットを持つ。
[[ProxyHandler]] の値は、proxy の handler object
と呼ばれる object、または
オブジェクトが
Proxy 特殊オブジェクト
であるのは、その本質的内部メソッド（該当する場合、
[[Call]] および [[Construct]] を含む）がこの節の定義を
用いる場合である。これらの内部メソッドは
| 内部メソッド | handler メソッド |
|---|---|
| [[GetPrototypeOf]] |
getPrototypeOf
|
| [[SetPrototypeOf]] |
setPrototypeOf
|
| [[IsExtensible]] |
isExtensible
|
| [[PreventExtensions]] |
preventExtensions
|
| [[GetOwnProperty]] |
getOwnPropertyDescriptor
|
| [[DefineOwnProperty]] |
defineProperty
|
| [[HasProperty]] |
has
|
| [[Get]] |
get
|
| [[Set]] |
set
|
| [[Delete]] |
deleteProperty
|
| [[OwnPropertyKeys]] |
ownKeys
|
| [[Call]] |
apply
|
| [[Construct]] |
construct
|
handler メソッドが Proxy オブジェクトの内部メソッ ド実装を提供するために呼び出されるとき、その handler メソッドには proxy の target object が引数として渡され る。proxy の handler object は、必ずしもすべての本質 的内部メソッドに対応するメソッドを持つわけではない。 handler object が内部 trap に対応するメソッドを持たな い場合、proxy 上で内部メソッドを起動すると、proxy の target object 上の対応する内部メソッドの起動が結果とし て生じる。
Proxy オブジェクトの [[ProxyHandler]] および
[[ProxyTarget]] 内部スロットは、オブジェクトが作成される
とき常に初期化され、通常は変更できない。いくつかの Proxy
オブジェクトは、その後 revoked されることを許す
方法で作成される。proxy が revoked されると、その
[[ProxyHandler]] および [[ProxyTarget]] 内部スロットは
Proxy オブジェクトは、任意の ECMAScript code によ
って内部メソッドの実装を提供することを許すため、
以下のアルゴリズム記述において、obj は
ECMAScript Proxy object、propertyKey は
10.5.1 [[GetPrototypeOf]] ( )
The [[GetPrototypeOf]] internal method of a Proxy
- ?
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 例外を送出する。 - extensibleTarget を ?
IsExtensible (target) とする。 - extensibleTarget が
true なら、 handlerProto を返す。 - targetProto を ? target.[[GetPrototypeOf]]() とする。
SameValue (handlerProto, targetProto) がfalse なら、TypeError 例外を送出する。- handlerProto を返す。
Proxy object に対する [[GetPrototypeOf]] は次 の不変条件を強制する:
-
[[GetPrototypeOf]] の結果は Object または
null のいずれかでなければならない。 - target object が拡張可能でない場合、 Proxy object に適用された [[GetPrototypeOf]] は、Proxy object の target object に適用 された [[GetPrototypeOf]] と同じ値を返さ なければならない。
10.5.2 [[SetPrototypeOf]] ( proto )
The [[SetPrototypeOf]] internal method of a Proxy
- ?
ValidateNonRevokedProxy (obj) を実行する。 - target を obj.[[ProxyTarget]] とする。
- handler を obj.[[ProxyHandler]] とする。
Assert : handler は Object である。- trap を ?
GetMethod (handler,"setPrototypeOf" ) とする。 - trap が
undefined なら、- ? target.[[SetPrototypeOf]](proto) を返す。
- booleanTrapResult を
ToBoolean (?Call ( trap, handler, « target, proto »)) とする。 - booleanTrapResult が
false なら、false を返す。 - extensibleTarget を ?
IsExtensible (target) とする。 - extensibleTarget が
true なら、true を返す。 - targetProto を ? target.[[GetPrototypeOf]]() とする。
SameValue (proto, targetProto) がfalse なら、TypeError 例外を送出する。true を返す。
Proxy object に対する [[SetPrototypeOf]] は次 の不変条件を強制する:
- [[SetPrototypeOf]] の結果は Boolean 値であ る。
- target object が拡張可能でない場合、引数の 値は target object に適用された [[GetPrototypeOf]] の結果と同じでなければな らない。
10.5.3 [[IsExtensible]] ( )
The [[IsExtensible]] internal method of a Proxy
- ?
ValidateNonRevokedProxy (obj) を実行する。 - target を obj.[[ProxyTarget]] とする。
- handler を obj.[[ProxyHandler]] とする。
Assert : handler は Object である。- trap を ?
GetMethod (handler,"isExtensible" ) とする。 - trap が
undefined なら、- ?
IsExtensible (target) を返す。
- ?
- booleanTrapResult を
ToBoolean (?Call ( trap, handler, « target »)) とする。 - targetResult を ?
IsExtensible (target) とする。 - booleanTrapResult が targetResult でない
なら、
TypeError 例外を送出する。 - booleanTrapResult を返す。
Proxy object に対する [[IsExtensible]] は次 の不変条件を強制する:
- [[IsExtensible]] の結果は Boolean 値であ る。
- Proxy object に適用された [[IsExtensible]] は、同じ引数で Proxy object の target object に適用された [[IsExtensible]] と同 じ値を返さなければならない。
10.5.4 [[PreventExtensions]] ( )
The [[PreventExtensions]] internal method of a Proxy
- ?
ValidateNonRevokedProxy (obj) を実行する。 - target を obj.[[ProxyTarget]] とする。
- handler を obj.[[ProxyHandler]] とする。
Assert : handler は Object である。- trap を ?
GetMethod (handler,"preventExtensions" ) とする。 - trap が
undefined なら、- ? target.[[PreventExtensions]]() を返す。
- booleanTrapResult を
ToBoolean (?Call ( trap, handler, « target »)) とする。 - booleanTrapResult が
true なら、- extensibleTarget を ?
IsExtensible (target) とする。 - extensibleTarget が
true なら、TypeError 例外を送出する。
- extensibleTarget を ?
- booleanTrapResult を返す。
Proxy object に対する [[PreventExtensions]] は次の不変条件を強制する:
- [[PreventExtensions]] の結果は Boolean 値で ある。
-
Proxy object に適用された
[[PreventExtensions]] は、Proxy object の
target object に適用された [[IsExtensible]]
が
false である場合にのみtrue を返 す。
10.5.5 [[GetOwnProperty]] ( propertyKey )
The [[GetOwnProperty]] internal method of a Proxy
- ?
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 でなく、かつ
undefined でもないなら、TypeError 例外 を送出する。 - targetDesc を ? target.[[GetOwnProperty]](propertyKey) とする。
- trapResultObj が
undefined なら、- targetDesc が
undefined なら、undefined を返す。 - targetDesc.[[Configurable]] が
false な ら、TypeError 例外を送出する。 - extensibleTarget を ?
IsExtensible (target) とする。 - extensibleTarget が
false なら、TypeError 例外を送出する。 undefined を返す。
- targetDesc が
- extensibleTarget を ?
IsExtensible (target) とする。 - resultDesc を
?
ToPropertyDescriptor (trapResultObj) とす る。 CompletePropertyDescriptor (resultDesc) を実 行する。- valid を
IsCompatiblePropertyDescriptor ( extensibleTarget, resultDesc, targetDesc) とする。 - valid が
false なら、TypeError 例外 を送出する。 - resultDesc.[[Configurable]] が
false な ら、- targetDesc が
undefined または targetDesc.[[Configurable]] がtrue なら、TypeError 例外を送出する。
- resultDesc が [[Writable]] フィールドを持
ち、かつ resultDesc.[[Writable]] が
false なら、Assert : targetDesc は [[Writable]] フィールドを持つ。- targetDesc.[[Writable]] が
true な ら、TypeError 例外を送出する。
- targetDesc が
- resultDesc を返す。
Proxy object に対する [[GetOwnProperty]] は 次の不変条件を強制する:
-
[[GetOwnProperty]] の結果は
Property Descriptor またはundefined のいずれか でなければならない。 - property は、target object の non-configurable own property として存 在する場合、存在しないものとして報告されてはな らない。
- property は、拡張可能でない target object の own property として存在する場合、存在し ないものとして報告されてはならない。
- property は、target object の own property として存在せず、かつ target object が拡張可能でない場合、存在するものとして報告さ れてはならない。
- property は、それが target object の non-configurable own property として存在 しない限り、non-configurable として報告さ れてはならない。
- property は、それが target object の non-configurable かつ non-writable own property として存在しない限り、 non-configurable かつ non-writable の 両方として報告されてはならない。
10.5.6 [[DefineOwnProperty]] ( propertyKey, desc )
The [[DefineOwnProperty]] internal method of a Proxy
- ?
ValidateNonRevokedProxy (obj) を実行する。 - target を obj.[[ProxyTarget]] とする。
- handler を obj.[[ProxyHandler]] とする。
Assert : handler は Object である。- trap を ?
GetMethod (handler,"defineProperty" ) とする。 - trap が
undefined なら、- ? target.[[DefineOwnProperty]](propertyKey, desc) を返す。
- descObj を
FromPropertyDescriptor (desc) と する。 - booleanTrapResult を
ToBoolean (?Call ( trap, handler, « target, propertyKey, descObj »)) とする。 - booleanTrapResult が
false なら、false を返す。 - targetDesc を ? target.[[GetOwnProperty]](propertyKey) とする。
- extensibleTarget を ?
IsExtensible (target) とする。 - desc が [[Configurable]] フィールドを持ち、
かつ desc.[[Configurable]] が
false な ら、- settingConfigFalse を
true とする。
- settingConfigFalse を
- Else,
- settingConfigFalse を
false とする。
- settingConfigFalse を
- targetDesc が
undefined なら、- extensibleTarget が
false なら、TypeError 例外を送出する。 - settingConfigFalse が
true なら、TypeError 例外を送出する。
- extensibleTarget が
- Else,
IsCompatiblePropertyDescriptor ( extensibleTarget, desc, targetDesc) がfalse なら、TypeError 例外を送出す る。- settingConfigFalse が
true かつ targetDesc.[[Configurable]] がtrue なら、TypeError 例外を送出する。 IsDataDescriptor (targetDesc) がtrue 、 targetDesc.[[Configurable]] がfalse 、 かつ targetDesc.[[Writable]] がtrue なら、- desc が [[Writable]] フィールドを持ち、
かつ desc.[[Writable]] が
false な ら、TypeError 例外を送出する。
- desc が [[Writable]] フィールドを持ち、
かつ desc.[[Writable]] が
true を返す。
Proxy object に対する [[DefineOwnProperty]] は次の不変条件を強制する:
- [[DefineOwnProperty]] の結果は Boolean 値で ある。
- target object が拡張可能でない場合、 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 Descriptor を [[DefineOwnProperty]] を用 いて target object に適用しても例外を送出 してはならない。
10.5.7 [[HasProperty]] ( propertyKey )
The [[HasProperty]] internal method of a Proxy
- ?
ValidateNonRevokedProxy (obj) を実行する。 - target を obj.[[ProxyTarget]] とする。
- handler を obj.[[ProxyHandler]] とする。
Assert : handler は Object である。- trap を ?
GetMethod (handler,"has" ) とする。 - trap が
undefined なら、- ? target.[[HasProperty]](propertyKey) を返す。
- booleanTrapResult を
ToBoolean (?Call ( trap, handler, « target, propertyKey »)) とする。 - booleanTrapResult が
false なら、- targetDesc を ? target.[[GetOwnProperty]](propertyKey) とする。
- targetDesc が
undefined でなければ、- targetDesc.[[Configurable]] が
false なら、TypeError 例外を送出する。 - extensibleTarget を
?
IsExtensible (target) とする。 - extensibleTarget が
false なら、TypeError 例外を送出する。
- targetDesc.[[Configurable]] が
- booleanTrapResult を返す。
Proxy object に対する [[HasProperty]] は次 の不変条件を強制する:
- [[HasProperty]] の結果は Boolean 値である。
- property は、target object の non-configurable own property として存 在する場合、存在しないものとして報告されてはな らない。
- property は、target object の own property として存在し、かつ target object が拡張可能でない場合、存在しないものとして報告 されてはならない。
10.5.8 [[Get]] ( propertyKey, receiver )
The [[Get]] internal method of a Proxy
- ?
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 例外を送出する。
IsAccessorDescriptor (targetDesc) がtrue かつ targetDesc.[[Get]] がundefined なら、- trapResult が
undefined でなけれ ば、TypeError 例外を送出する。
- trapResult が
- trapResult を返す。
Proxy object に対する [[Get]] は次の不変条 件を強制する:
-
target object の property が
non-writable かつ non-configurable な
own
data property である場合、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 a Proxy
- ?
ValidateNonRevokedProxy (obj) を実行する。 - target を obj.[[ProxyTarget]] とする。
- handler を obj.[[ProxyHandler]] とする。
Assert : handler は Object である。- trap を ?
GetMethod (handler,"set" ) とする。 - trap が
undefined なら、- ? target.[[Set]](propertyKey, value, receiver) を返す。
- booleanTrapResult を
ToBoolean (?Call ( trap, handler, « target, propertyKey, value, receiver »)) とする。 - booleanTrapResult が
false なら、false を返す。 - targetDesc を ? target.[[GetOwnProperty]](propertyKey) とする。
- targetDesc が
undefined でなく、かつ targetDesc.[[Configurable]] がfalse なら、IsDataDescriptor (targetDesc) がtrue かつ targetDesc.[[Writable]] がfalse なら、SameValue (value, targetDesc.[[Value]]) がfalse なら、TypeError 例外を送 出する。
IsAccessorDescriptor (targetDesc) がtrue なら、- targetDesc.[[Set]] が
undefined なら、TypeError 例外を送出する。
- targetDesc.[[Set]] が
true を返す。
Proxy object に対する [[Set]] は次の不変条件 を強制する:
- [[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 a Proxy
- ?
ValidateNonRevokedProxy (obj) を実行する。 - target を obj.[[ProxyTarget]] とする。
- handler を obj.[[ProxyHandler]] とする。
Assert : handler は Object である。- trap を ?
GetMethod (handler,"deleteProperty" ) とする。 - trap が
undefined なら、- ? target.[[Delete]](propertyKey) を返す。
- booleanTrapResult を
ToBoolean (?Call ( trap, handler, « target, propertyKey »)) とする。 - booleanTrapResult が
false なら、false を返す。 - targetDesc を ? target.[[GetOwnProperty]](propertyKey) とする。
- targetDesc が
undefined なら、true を返す。 - targetDesc.[[Configurable]] が
false な ら、TypeError 例外を送出する。 - extensibleTarget を ?
IsExtensible (target) とする。 - extensibleTarget が
false なら、TypeError 例外を送出する。 true を返す。
Proxy object に対する [[Delete]] は次の不変 条件を強制する:
- [[Delete]] の結果は Boolean 値である。
- property は、target object の non-configurable own property として存 在する場合、削除されたものとして報告されてはな らない。
- property は、target object の own property として存在し、かつ target object が non-extensible である場合、削除されたも のとして報告されてはならない。
10.5.11 [[OwnPropertyKeys]] ( )
The [[OwnPropertyKeys]] internal method of a Proxy
- ?
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 に重複要素が含まれるなら、
TypeError 例外を送出する。 - extensibleTarget を ?
IsExtensible (target) とする。 - targetKeys を ? target.[[OwnPropertyKeys]]() とする。
Assert : targetKeys はproperty key のList である。Assert : targetKeys は重複要素を含まない。- targetConfigurableKeys を新しい空の
List とする。 - targetNonconfigurableKeys を新しい空の
List とする。 - targetKeys の各要素 key について、次を行う
- desc を ? target.[[GetOwnProperty]](key) とする。
- desc が
undefined でなく、かつ desc.[[Configurable]] がfalse なら、- key を targetNonconfigurableKeys に append する。
- Else,
- key を targetConfigurableKeys に append する。
- extensibleTarget が
true かつ targetNonconfigurableKeys が空なら、- trapResult を返す。
- uncheckedResultKeys を、その要素が
trapResult の要素である
List とする。 - targetNonconfigurableKeys の各要素 key
について、次を行う
- uncheckedResultKeys が key を含まなけ
れば、
TypeError 例外を送出する。 - uncheckedResultKeys から key を除去す る。
- uncheckedResultKeys が key を含まなけ
れば、
- extensibleTarget が
true なら、 trapResult を返す。 - targetConfigurableKeys の各要素 key に
ついて、次を行う
- uncheckedResultKeys が key を含まなけ
れば、
TypeError 例外を送出する。 - uncheckedResultKeys から key を除去す る。
- uncheckedResultKeys が key を含まなけ
れば、
- uncheckedResultKeys が空でなければ、
TypeError 例外を送出する。 - trapResult を返す。
Proxy object に対する [[OwnPropertyKeys]] は 次の不変条件を強制する:
10.5.12 [[Call]] ( thisArgument, argumentsList )
The [[Call]] internal method of a Proxy
- ?
ValidateNonRevokedProxy (obj) を実行する。 - target を obj.[[ProxyTarget]] とする。
- handler を obj.[[ProxyHandler]] とする。
Assert : handler は Object である。- trap を ?
GetMethod (handler,"apply" ) とする。 - trap が
undefined なら、- ?
Call (target, thisArgument, argumentsList) を返す。
- ?
- argArray を
CreateArrayFromList (argumentsList) とする。 - ?
Call (trap, handler, « target, thisArgument, argArray ») を返す。
10.5.13 [[Construct]] ( argumentsList, newTarget )
The [[Construct]] internal method of a Proxy
- ?
ValidateNonRevokedProxy (obj) を実行する。 - target を obj.[[ProxyTarget]] とする。
Assert :IsConstructor (target) istrue .- handler を obj.[[ProxyHandler]] とする。
Assert : handler は Object である。- trap を ?
GetMethod (handler,"construct" ) とする。 - trap が
undefined なら、- ?
Construct (target, argumentsList, newTarget) を返す。
- ?
- argArray を
CreateArrayFromList (argumentsList) とする。 - newObj を ?
Call (trap, handler, « target, argArray, newTarget ») とす る。 - newObj が Object でなければ、
TypeError 例外を送出する。 - newObj を返す。
Proxy object に対する [[Construct]] は次の不 変条件を強制する:
- [[Construct]] の結果は Object でなければなら ない。
10.5.14 ValidateNonRevokedProxy ( proxy )
The
- proxy.[[ProxyTarget]] が
null なら、TypeError 例外を送出する。 Assert : proxy.[[ProxyHandler]] はnull ではない。unused を返す。
10.5.15 ProxyCreate ( target, handler )
The
- target が Object でなければ、
TypeError 例外を送出する。 - handler が Object でなければ、
TypeError 例外を送出する。 - proxy を
MakeBasicObject ( « [[ProxyHandler]], [[ProxyTarget]] ») とする。 - proxy の本質的内部メソッドのうち [[Call]]
および [[Construct]] を除くものを、
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 言語: ソーステキスト
11.1 ソーステキスト
構文
ECMAScript ソーステキストは、Unicode 符号位置の並びである。ECMAScript の文法によって許可される箇所では、サロゲート符号位置を含め、U+0000 から U+10FFFF までのすべての Unicode 符号位置の値が ECMAScript ソーステキスト中に現れ得る。ECMAScript ソーステキストの保存および交換に用いられる実際のエンコーディングは、この仕様においては関係しない。外部のソーステキストのエンコーディングに関係なく、適合する ECMAScript 実装は、ソーステキストを、各
結合文字列の各構成要素は、利用者がその列全体を単一の文字と見なすかもしれない場合であっても、個別の Unicode 符号位置として扱われる。
文字列リテラル、正規表現リテラル、テンプレートリテラル、および識別子においては、任意の Unicode 符号位置は、その符号位置の数値を明示的に表す Unicode エスケープシーケンスを用いて表すこともできる。コメントの内部では、そのようなエスケープシーケンスは実質的にコメントの一部として無視される。
ECMAScript は、Unicode エスケープシーケンスの振る舞いにおいて Java プログラミング言語と異なる。たとえば Java プログラムでは、Unicode エスケープシーケンス \u000A が単一行コメントの中に現れると、それは行終端子（Unicode 符号位置 U+000A は LINE FEED (LF) である）として解釈され、その結果、次の符号位置はコメントの一部ではなくなる。同様に、Unicode エスケープシーケンス \u000A が Java プログラム中の文字列リテラルに現れると、それもまた行終端子として解釈されるが、これは文字列リテラル内では許されない—文字列リテラルの値の一部として LINE FEED (LF) を含めるには、\u000A の代わりに \n と書かなければならない。ECMAScript プログラムでは、コメント中に現れる Unicode エスケープシーケンスは決して解釈されず、したがってコメントの終端に寄与することはない。同様に、ECMAScript プログラムの文字列リテラル中に現れる Unicode エスケープシーケンスは常にそのリテラルに寄与し、行終端子として、あるいは文字列リテラルを終端し得る符号位置として解釈されることは決してない。
11.1.1 Static Semantics: UTF16EncodeCodePoint ( cp )
The
Assert : 0 ≤ cp ≤ 0x10FFFF.- cp ≤ 0xFFFF なら、数値が cp である code unit からなる String 値を返す。
- cu1 を、数値が
floor ((cp - 0x10000) / 0x400) + 0xD800 である code unit とする。 - cu2 を、数値が ((cp - 0x10000)
modulo 0x400) + 0xDC00 である code unit とする。 - cu1 と cu2 の
string-concatenation を返す。
11.1.2 Static Semantics: CodePointsToString ( text )
The
- result を空の String とする。
- text の各 code point cp について、次を行う
- result を result と
UTF16EncodeCodePoint (cp) のstring-concatenation に設定する。
- result を result と
- result を返す。
11.1.3 Static Semantics: UTF16SurrogatePairToCodePoint ( lead, trail )
The
Assert : lead は上位サロゲートであり、trail は下位サロゲートである。- cp を (lead - 0xD800) × 0x400 + (trail - 0xDC00) + 0x10000 とする。
- code point cp を返す。
11.1.4 Static Semantics: CodePointAt ( string, position )
The
- size を string の長さとする。
Assert : position ≥ 0 and position < size.- first を string 内の index position にある code unit とする。
- cp を、数値が first の数値である code point とする。
- first が上位サロゲートでも下位サロゲートでもないなら、
Record { [[CodePoint]]: cp, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]:false } を返す。
- first が下位サロゲートであるか、または position + 1 = size なら、
Record { [[CodePoint]]: cp, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]:true } を返す。
- second を string 内の index position + 1 にある code unit とする。
- second が下位サロゲートでないなら、
Record { [[CodePoint]]: cp, [[CodeUnitCount]]: 1, [[IsUnpairedSurrogate]]:true } を返す。
- cp を
UTF16SurrogatePairToCodePoint (first, second) に設定する。 Record { [[CodePoint]]: cp, [[CodeUnitCount]]: 2, [[IsUnpairedSurrogate]]:false } を返す。
11.1.5 Static Semantics: StringToCodePoints ( string )
The
- codePoints を新しい空の
List とする。 - size を string の長さとする。
- position を 0 とする。
- position < size の間、繰り返す
- cp を
CodePointAt (string, position) とする。 - cp.[[CodePoint]] を codePoints に append する。
- position を position + cp.[[CodeUnitCount]] に設定する。
- cp を
- codePoints を返す。
11.1.6 Static Semantics: ParseText ( sourceText, goalSymbol )
The
- sourceText が String なら、sourceText を
StringToCodePoints (sourceText) に設定する。 - goalSymbol を目標記号として sourceText の parse を試み、その parse 結果について
early error 条件を解析する。parse とearly error 検出は、implementation-defined な方法で交互に行われてもよい。 - parse が成功し、かつ
early error が見つからなかったなら、parse の結果得られた parse tree の根にあるParse Node （goalSymbol の instance）を返す。 - parse error および / または
early error を表す 1 個以上のSyntaxError object のList を返す。複数の parse error またはearly error が存在する場合、List 中の error object の数および順序はimplementation-defined であるが、少なくとも 1 個は存在しなければならない。
あるテキストにおいて、ある地点に
11.2 ソースコードの種類
ECMAScript コードには 4 種類ある:
-
グローバルコードは、ECMAScript
Script として扱われるソーステキストである。ある特定のScript のグローバルコードは、FunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 、AsyncArrowFunction 、ClassDeclaration 、またはClassExpression の一部として parse されるいかなるソーステキストも含まない。 -
eval コードは、組込み
eval関数に与えられるソーステキストである。より正確には、組込みeval関数への引数が String である場合、それは ECMAScriptScript として扱われる。ある特定のeval呼出しに対する eval コードは、そのScript のグローバルコード部分である。 -
関数コードは、ECMAScript 関数オブジェクトの [[ECMAScriptCode]] および [[FormalParameters]] 内部スロット（
10.2 を参照）の値を与えるために parse されるソーステキストである。ある特定の ECMAScript 関数の関数コードは、入れ子になったFunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 、AsyncArrowFunction 、ClassDeclaration 、またはClassExpression の関数コードとして parse されるいかなるソーステキストも含まない。さらに、上で言及したソーステキストが次のいずれかとして parse される場合:
FunctionDeclaration またはFunctionExpression のFormalParameters とFunctionBody 、GeneratorDeclaration またはGeneratorExpression のFormalParameters とGeneratorBody 、AsyncFunctionDeclaration またはAsyncFunctionExpression のFormalParameters とAsyncFunctionBody 、またはAsyncGeneratorDeclaration またはAsyncGeneratorExpression のFormalParameters とAsyncGeneratorBody 、
その場合、その宣言または式の
BindingIdentifier （存在するなら）に対応するソーステキストも、対応する関数の関数コードに含まれる。 -
モジュールコードは、
ModuleBody として与えられるコードであるソーステキストである。これは、module が初期化されるときに直接評価されるコードである。ある特定の module のモジュールコードは、入れ子になったFunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 、AsyncArrowFunction 、ClassDeclaration 、またはClassExpression の一部として parse されるいかなるソーステキストも含まない。
関数コードは通常、関数定義（
11.2.1 Directive Prologue と Use Strict Directive
Directive Prologue とは、
Use Strict Directive とは、"use strict" または 'use strict' のいずれかの code point 列であるものをいう。
11.2.2 Strict Mode Code
ECMAScript の構文単位は、制限なしまたは strict mode の構文および意味論（
-
グローバルコード は、それがUse Strict Directive を含むDirective Prologue で始まる場合、strict mode code である。 -
モジュールコード は常に strict mode code である。 -
ClassDeclaration またはClassExpression のすべての部分は strict mode code である。 -
Eval コード は、それがUse Strict Directive を含むDirective Prologue で始まる場合、またはevalへの呼出しが strict mode code 内に含まれるdirect eval である場合、strict mode code である。 -
関数コード は、対応するFunctionDeclaration 、FunctionExpression 、GeneratorDeclaration 、GeneratorExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、MethodDefinition 、ArrowFunction 、またはAsyncArrowFunction が strict mode code 内に含まれている場合、または関数の [[ECMAScriptCode]] 内部スロットの値を生成するコードがUse Strict Directive を含むDirective Prologue で始まる場合、strict mode code である。 -
組込み Function、Generator、AsyncFunction、および AsyncGenerator
constructor への引数として与えられる関数コード は、最後の引数が String であり、それを処理した結果がUse Strict Directive を含むDirective Prologue で始まるFunctionBody である場合、strict mode code である。
strict mode code でない ECMAScript code は、non-strict code と呼ばれる。
11.2.2.1 Static Semantics: IsStrict ( node )
The
- node に対応するソーステキストが
strict mode code なら、true を返す。 false を返す。
11.2.3 非 ECMAScript 関数
ECMAScript 実装は、その評価動作が
12 ECMAScript 言語: 字句文法
ECMAScript
字句入力要素の識別が、それらの入力要素を消費する構文文
法コンテキストに依存する状況がいくつか存在する。そのた
め、字句文法には複数の目標記号が必要となる。
複数の字句目標を用いることにより、自動セミコロン挿入
に影響を与える字句上の曖昧性が存在しないことが保証され
る。たとえば、先頭の除算または除算代入と、先頭の
a = b
/hi/g.exec(c).map(d);
ここで、
a = b / hi / g.exec(c).map(d);構文
12.1 Unicode 書式制御文字
Unicode の書式制御文字（すなわち、Unicode Character Database における “Cf” カテゴリの文 字。たとえば LEFT-TO-RIGHT MARK や RIGHT-TO-LEFT MARK）は、より高水準のプロトコル （markup language など）が存在しない場合に、ある範 囲のテキストの書式を制御するために用いられる制御 code である。
編集や表示を容易にするため、ソーステキストに書式制御文 字を許可することは有用である。すべての書式制御文字は comment の内部、および string literal、template literal、regular expression literal の内部で使 用してよい。
U+FEFF (ZERO WIDTH NO-BREAK SPACE) は、主
にテキストの先頭において、それが Unicode であること
を示し、かつテキストのエンコーディングおよび byte 順
序を検出可能にするために用いられる書式制御文字である。こ
の目的のための <ZWNBSP> 文字は、たとえば file の連
結の結果として、テキストの先頭以外にも現れることがある。
12.2 White Space
White space code point は、ソーステキストの可
読性を向上させ、token（分割不能な字句単位）同士を区切
るために用いられるが、それ以外では意味を持たない。
White space code point は、任意の 2 つの token
の間、および入力の先頭または末尾に現れ得る。White
space code point は、
ECMAScript の white space code point は
| Code Points | 名称 | 略称 |
|---|---|---|
U+0009
|
CHARACTER TABULATION | <TAB> |
U+000B
|
LINE TABULATION | <VT> |
U+000C
|
FORM FEED (FF) | <FF> |
U+FEFF
|
ZERO WIDTH NO-BREAK SPACE | <ZWNBSP> |
| 一般カテゴリ “Space_Separator” に属する任意の code point | <USP> |
U+0020 (SPACE) および U+00A0 (NO-BREAK SPACE) code point は <USP> の一部である。
構文
12.3 Line Terminator
White space code point と同様に、line
terminator code point もソーステキストの可読性を向
上させ、token（分割不能な字句単位）同士を区切るために
用いられる。しかし、white space code point とは異
なり、line terminator は構文文法の振る舞いにいくら
か影響を与える。一般に、line terminator は任意の 2
つの token の間に現れ得るが、構文文法により禁止され
ている箇所がいくつかある。line terminator は、自動
セミコロン挿入の処理にも影響する
（
line terminator は
line terminator は、正規表現における \s
class で一致される white space code point の集合
に含まれる。
ECMAScript の line terminator code point は
| Code Point | Unicode 名 | 略称 |
|---|---|---|
U+000A
|
LINE FEED (LF) | <LF> |
U+000D
|
CARRIAGE RETURN (CR) | <CR> |
U+2028
|
LINE SEPARATOR | <LS> |
U+2029
|
PARAGRAPH SEPARATOR | <PS> |
構文
12.4 Comment
Comment は、単一行でも複数行でもよい。複数行 comment は入れ子にできない。
単一行 comment は // マーカーか
ら行末までのすべての code point から構成される。しか
し、行末の
Comment は white space のように振る舞い、捨てら
れる。ただし、
構文
この節のいくつかの生成規則には、
12.5 Hashbang Comment
Hashbang Comment は位置依存であり、他の種類の comment と同様、構文文法のための入力要素列から捨てられ る。
構文
12.6 Token
構文
12.7 名前と予約語
この標準は特定の code point の追加を規定する:
U+0024 (DOLLAR SIGN) および U+005F (LOW
LINE) は
構文
非終端記号
非終端記号 _ を導出する。
Unicode property “ID_Start” および “ID_Continue” を持つ code point の集合は、それ ぞれ、Unicode property “Other_ID_Start” および “Other_ID_Continue” を持つ code point を含 む。
12.7.1 識別子名
Unicode エスケープシーケンスは
\ はいかな
る code point も与えない。\
Unicode Standard に従って正準同値である 2 つの
12.7.1.1 Static Semantics: Early Errors
-
UnicodeEscapeSequence のIdentifierCodePoint が、 字句文法生成規則IdentifierStartChar に一致す る Unicode code point でない場合、それは Syntax Error である。
-
UnicodeEscapeSequence のIdentifierCodePoint が、 字句文法生成規則IdentifierPartChar に一致す る Unicode code point でない場合、それは Syntax Error である。
12.7.1.2 Static Semantics: IdentifierCodePoints
The
- cp を
IdentifierStart のIdentifierCodePoint とする。 - « cp » を返す。
- cps を、導出された
IdentifierName のIdentifierCodePoints とする。 - cp を
IdentifierPart のIdentifierCodePoint とする。 - cps と « cp » の
list-concatenation を返す。
12.7.1.3 Static Semantics: IdentifierCodePoint
The
IdentifierStartChar に一致した code point を返す。
IdentifierPartChar に一致した code point を返す。
- 数値が
Hex4Digits の MV である code point を返す。
- 数値が
CodePoint の MV である code point を返す。
12.7.2 キーワードと予約語
keyword と
は、fixed width font により、文
字どおりに現れる。ECMAScript の keyword には if、
while、async、await など多数が含まれる。
reserved
word とは、識別子として使用できない
if および while
は reserved word である。await は async
function および module の内部でのみ予約される。
async は予約されない; それは変数名または文ラベルと
して制限なく使用できる。
この仕様は、文法生成規則と await
および yield を除くすべては、無条件に予約される。
await および yield に対する例外は、
-
Math、window、toString、および_のように、常に識別子として許可され、keyword ではな いもの; -
awaitおよびyieldを除く、以下に列挙さ れるReservedWord 、すなわち、決して識別子として許 可されないもの; -
awaitおよびyield、すなわち、文脈に応じ て識別子として許可されるもの; -
strict mode code において文脈的に識別子とし て不許可となるもの:let、static、implements、interface、package、private、protected、およびpublic; -
常に識別子として許可されるが、
Identifier が許 可されない特定の構文生成規則内では keyword としても 現れるもの:as、async、from、get、meta、of、set、およびtarget。
conditional keyword または contextual keyword という用語は、最後の 3 つのカテゴリに 属する keyword、すなわち、ある文脈では識別子として使 用でき、別の文脈では keyword として使用されるものを指 して用いられることがある。
構文
\
\
els\u{65} と綴って "else" という名前の変数を宣言
することはできない。
enum は現在この仕様において keyword として
使用されていない。これは将来予約語であり、将来の言
語拡張における keyword としての使用のために確保されて
いる。
同様に、implements、interface、
package、private、protected、および
public は
12.8 区切り記号
構文
12.9 リテラル
12.9.1 Null リテラル
構文
12.9.2 Boolean リテラル
構文
12.9.3 数値リテラル
構文
たとえば: 3in は error であり、2 つの入
力要素 3 と in ではない。
12.9.3.1 Static Semantics: Early Errors
IsStrict (this production) がtrue なら、それは Syntax Error である。
12.9.3.2 Static Semantics: MV
数値リテラルは
-
DecimalLiteral :: DecimalIntegerLiteral . DecimalDigits DecimalIntegerLiteral の MV に、 (DecimalDigits の MV × 10-n) を 加えたものである。ここで n はDecimalDigits に含まれる code point 数で あり、NumericLiteralSeparator のすべての出 現を除く。 -
DecimalLiteral :: DecimalIntegerLiteral . ExponentPart DecimalIntegerLiteral の MV × 10e である。ここで e はExponentPart の MV である。 -
DecimalLiteral :: DecimalIntegerLiteral . DecimalDigits ExponentPart DecimalIntegerLiteral の MV に (DecimalDigits の MV × 10-n) を 加えたもの) × 10e である。ここで n はDecimalDigits に含まれる code point 数であり、NumericLiteralSeparator のすべて の出現を除き、e はExponentPart の MV で ある。 -
DecimalLiteral :: . DecimalDigits DecimalDigits の MV × 10-n である。ここで n はDecimalDigits に含まれる code point 数で あり、NumericLiteralSeparator のすべての出 現を除く。 -
DecimalLiteral :: . DecimalDigits ExponentPart DecimalDigits の MV × 10e - n である。ここで n はDecimalDigits に含まれる code point 数で あり、NumericLiteralSeparator のすべての出 現を除き、e はExponentPart の MV であ る。 -
DecimalLiteral :: DecimalIntegerLiteral ExponentPart DecimalIntegerLiteral の MV × 10e である。ここで e はExponentPart の MV である。 -
DecimalIntegerLiteral :: 0 -
DecimalIntegerLiteral :: NonZeroDigit NumericLiteralSeparator opt DecimalDigits NonZeroDigit の MV × 10n) にDecimalDigits の MV を加えたものであ る。ここで n はDecimalDigits に含まれる code point 数であり、NumericLiteralSeparator のすべての出現を除く。 -
DecimalDigits :: DecimalDigits DecimalDigit DecimalDigits の MV × 10) にDecimalDigit の MV を加えたものである。 -
DecimalDigits :: DecimalDigits NumericLiteralSeparator DecimalDigit DecimalDigits の MV × 10) にDecimalDigit の MV を加えたものである。 -
ExponentPart :: ExponentIndicator SignedInteger SignedInteger の MV である。 -
SignedInteger :: - DecimalDigits DecimalDigits の MV の負値であ る。 -
DecimalDigit :: 0 HexDigit :: 0 OctalDigit :: 0 LegacyOctalEscapeSequence :: 0 BinaryDigit :: 0 -
DecimalDigit :: 1 NonZeroDigit :: 1 HexDigit :: 1 OctalDigit :: 1 BinaryDigit :: 1 -
DecimalDigit :: 2 NonZeroDigit :: 2 HexDigit :: 2 OctalDigit :: 2 -
DecimalDigit :: 3 NonZeroDigit :: 3 HexDigit :: 3 OctalDigit :: 3 -
DecimalDigit :: 4 NonZeroDigit :: 4 HexDigit :: 4 OctalDigit :: 4 -
DecimalDigit :: 5 NonZeroDigit :: 5 HexDigit :: 5 OctalDigit :: 5 -
DecimalDigit :: 6 NonZeroDigit :: 6 HexDigit :: 6 OctalDigit :: 6 -
DecimalDigit :: 7 NonZeroDigit :: 7 HexDigit :: 7 OctalDigit :: 7 -
DecimalDigit :: 8 NonZeroDigit :: 8 NonOctalDigit :: 8 HexDigit :: 8 -
DecimalDigit :: 9 NonZeroDigit :: 9 NonOctalDigit :: 9 HexDigit :: 9 -
HexDigit :: a HexDigit :: A -
HexDigit :: b HexDigit :: B -
HexDigit :: c HexDigit :: C -
HexDigit :: d HexDigit :: D -
HexDigit :: e HexDigit :: E -
HexDigit :: f HexDigit :: F -
BinaryDigits :: BinaryDigits BinaryDigit BinaryDigits の MV × 2) にBinaryDigit の MV を加えたものである。 -
BinaryDigits :: BinaryDigits NumericLiteralSeparator BinaryDigit BinaryDigits の MV × 2) にBinaryDigit の MV を加えたものである。 -
OctalDigits :: OctalDigits OctalDigit OctalDigits の MV × 8) にOctalDigit の MV を加えたものである。 -
OctalDigits :: OctalDigits NumericLiteralSeparator OctalDigit OctalDigits の MV × 8) にOctalDigit の MV を加えたものである。 -
LegacyOctalIntegerLiteral :: LegacyOctalIntegerLiteral OctalDigit LegacyOctalIntegerLiteral の MV に 8 を掛けたものにOctalDigit の MV を 加えたものである。 -
NonOctalDecimalIntegerLiteral :: LegacyOctalLikeDecimalIntegerLiteral NonOctalDigit LegacyOctalLikeDecimalIntegerLiteral の MV に 10 を掛けたものにNonOctalDigit の MV を加えたものである。 -
NonOctalDecimalIntegerLiteral :: NonOctalDecimalIntegerLiteral DecimalDigit NonOctalDecimalIntegerLiteral の MV に 10 を掛けたものにDecimalDigit の MV を加えたものである。 -
LegacyOctalLikeDecimalIntegerLiteral :: LegacyOctalLikeDecimalIntegerLiteral OctalDigit LegacyOctalLikeDecimalIntegerLiteral の MV に 10 を掛けたものにOctalDigit の MV を加えたものである。 -
HexDigits :: HexDigits HexDigit HexDigits の MV × 16) にHexDigit の MV を加えたものである。 -
HexDigits :: HexDigits NumericLiteralSeparator HexDigit HexDigits の MV × 16) にHexDigit の MV を加えたものである。
12.9.3.3 Static Semantics: NumericValue
The
RoundMVResult (MV ofDecimalLiteral ) を返す。
𝔽 (MV ofNonDecimalIntegerLiteral ) を返す。
𝔽 (MV ofLegacyOctalIntegerLiteral ) を返す。
NonDecimalIntegerLiteral の MV に対応する BigInt 値を返す。
0 ℤ を返す。
NonZeroDigit の MV に対応する BigInt 値を返 す。
- n を、
DecimalDigits に含まれる code point 数からNumericLiteralSeparator の すべての出現を除いたものとする。 - mv を、(
NonZeroDigit の MV × 10n) にDecimalDigits の MV を加えたものとす る。 ℤ (mv) を返す。
12.9.4 文字列リテラル
文字列リテラルは、単引用符または二重引用符で囲まれた
0 個以上の Unicode code point である。Unicode
code point は escape sequence を用いて表現するこ
ともできる。文字列リテラルには、閉じ引用符の code
point、U+005C (REVERSE SOLIDUS)、U+000D
(CARRIAGE RETURN)、および U+000A (LINE FEED)
を除くすべての code point を文字どおりに現すことが
できる。任意の code point は escape sequence の
形で現すことができる。文字列リテラルは ECMAScript
String 値へ評価される。これらの String 値を生成する
際、Unicode code point は
構文
非終端記号
<LF> および <CR> は、空の code
point 列を生成する \n や \u000A のような escape
sequence を用いることである。
12.9.4.1 Static Semantics: Early Errors
IsStrict (this production) がtrue なら、それは Syntax Error である。
文字列リテラルが、その後に続く
function invalid() { "\7"; "use strict"; }12.9.4.2 Static Semantics: SV
The
文字列リテラルは
-
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 に一致した code point に対してUTF16EncodeCodePoint を実行した結果である。 -
DoubleStringCharacter :: <LS> -
DoubleStringCharacter :: <PS> -
DoubleStringCharacter :: LineContinuation -
SingleStringCharacter :: SourceCharacter but not one of ' or\ orLineTerminator SourceCharacter に一致した code point に対してUTF16EncodeCodePoint を実行した結果である。 -
SingleStringCharacter :: <LS> -
SingleStringCharacter :: <PS> -
SingleStringCharacter :: LineContinuation -
EscapeSequence :: 0 -
CharacterEscapeSequence :: SingleEscapeCharacter Table 32 に従って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 に一致した 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 × 最初の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 正規表現リテラル
正規表現リテラルは、その literal が評価されるたび
に RegExp object へ変換される入力要素である
（=== と比較して真
になることのない正規表現オブジェクトへ評価される。
RegExp object は、new RegExp によって、または
RegExp
以下の生成規則は、正規表現リテラルの構文を記述し、入
力要素 scanner により正規表現リテラルの終端を見つけ
るために用いられる。
実装は、
構文
正規表現リテラルは空であってはならない; 空の正規表現
リテラルを表す代わりに、code unit 列 // は単一行
comment を開始する。空の正規表現を指定するには、
/(?:)/ を用いる。
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 の字句構成要素
構文
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 に一致した 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 に一致した 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 自動セミコロン挿入
ほとんどの ECMAScript の文および宣言は、セミコロ ンで終端しなければならない。そのようなセミコロンは、ソー ステキスト中に常に明示的に現れてよい。しかし便宜のため、 特定の状況では、そのようなセミコロンはソーステキストから 省略してよい。これらの状況は、そのような状況においてセミ コロンがソースコード token 列に自動的に挿入される、と 述べることにより記述される。
12.10.1 自動セミコロン挿入の規則
以下の規則において、“token” とは、現在の字句目標
記号を用いて
セミコロン挿入には 3 つの基本規則がある:
-
ソーステキストを左から右へ parse していると き、文法のいかなる生成規則によっても許可されない token （offending token と呼ぶ）に遭遇した場 合、次の条件の 1 つ以上が真であれば、その offending token の前にセミコロンが自動的に挿入される:
-
offending token が、直前の token から
少なくとも 1 個の
LineTerminator によっ て分離されている。 -
offending token が
}である。 -
直前の token が
)であり、かつ挿入され たセミコロンが do-while 文 （14.7.2 ） の終端セミコロンとして parse される。
-
offending token が、直前の token から
少なくとも 1 個の
- ソーステキストを左から右へ parse していると き、token 列入力の末尾に到達し、parser が入 力 token 列を目標非終端記号の単一 instance として parse できない場合、入力列の末尾にセミ コロンが自動的に挿入される。
-
ソーステキストを左から右へ parse していると
き、ある token が文法上は何らかの生成規則に
よって許可されるが、その生成規則が制限付き生成
規則であり、かつその token が、その制限付き
生成規則内の注記 “[no
LineTerminator here]” の直後に現れる terminal または nonterminal の最初の token になる場合 （したがってその token は restricted token と呼ばれる）、そして restricted token が直 前の token から少なくとも 1 個のLineTerminator によって分離されている場 合、その restricted token の前にセミコロン が自動的に挿入される。
ただし、これらの規則には追加の最優先条件がある: そ
のセミコロンが empty statement として parse され
てしまう場合、またはそのセミコロンが for 文
（
文法における制限付き生成規則は、次のものだけである:
これらの制限付き生成規則の実際上の効果は次のとおりで ある:
-
parser が
++または--token を後置 演算子として扱う位置で、それに遭遇し、かつ直前の token と++または--token の間 に少なくとも 1 個のLineTerminator がある 場合、++または--token の前にセミ コロンが自動的に挿入される。 -
continue、break、return、throw、またはyieldtoken に遭遇 し、次の token より前にLineTerminator に遭遇した場合、continue、break、return、throw、またはyieldtoken の後 にセミコロンが自動的に挿入される。 -
arrow function の parameter(s) の後、
=>token より前にLineTerminator がある場合、セミコロンが自動的に挿入され、その punctuator は syntax error を引き起こ す。 -
asynctoken の後、function、IdentifierName 、または(token よ り前にLineTerminator がある場合、セミ コロンが自動的に挿入され、asynctoken は後続 token と同じ式または class element の一部としては扱われない。 -
asynctoken の後、*token より前にLineTerminator がある場合、セミコロンが 自動的に挿入され、その punctuator は syntax error を引き起こす。
ECMAScript プログラマへの実際上の助言は次のとお りである:
-
後置
++または--演算子は、その被 演算子と同じ行に置くべきである。 -
returnまたはthrow文におけるExpression 、またはyield式におけ るAssignmentExpression は、return、throw、またはyieldtoken と同じ行で始めるべきである。 -
breakまたはcontinue文のLabelIdentifier は、breakまたはcontinuetoken と同じ行に置くべきで ある。 -
arrow function の parameter(s) の終
わりとその
=>は同じ行に置くべきである。 -
async な function または method に先
行する
asynctoken は、その直後の token と同じ行に置くべきである。
12.10.2 自動セミコロン挿入の例
この節は非規範的である。次のソース
{ 1 2 } 3は、自動セミコロン挿入規則を考慮しても、 ECMAScript 文法における妥当な文ではない。これに対し、 次のソース
{ 1
2 } 3もまた妥当な ECMAScript 文ではないが、自動セミコ ロン挿入によって次のように変換される:
{ 1
;2 ;} 3;これは妥当な ECMAScript 文である。
次のソース
for (a; b
)
は妥当な ECMAScript 文ではなく、for 文の
header に必要なセミコロンであるため、自動セミコロン挿
入によって変更もされない。自動セミコロン挿入は、for
文の header にある 2 つのセミコロンのいずれかを挿入
することは決してない。
次のソース
return
a + bは、自動セミコロン挿入によって次のように変換される:
return;
a + b;
式 a + b は return 文によって返される値
としては扱われない。なぜなら return とそれを分離しているからである。
次のソース
a = b
++cは、自動セミコロン挿入によって次のように変換される:
a = b;
++c;
token ++ は、変数 b に適用される後置演
算子としては扱われない。なぜなら b と ++ の間
に
次のソース
if (a > b)
else c = d
は妥当な ECMAScript 文ではなく、else
token の前で自動セミコロン挿入によって変更もされな
い。たとえその地点で文法のいかなる生成規則も適用できな
くても、自動挿入されたセミコロンは empty statement
として parse されてしまうからである。
次のソース
a = b + c
(d + e).print()は、自動セミコロン挿入によって変換されない。な ぜなら 2 行目の先頭にある括弧付き式は、関数呼出しの引数 list として解釈できるからである:
a = b + c(d + e).print()代入文が左丸括弧で始まらなければならない状況では、プ ログラマは自動セミコロン挿入に頼るのではなく、先行する文 の末尾に明示的なセミコロンを与えるのがよい考えである。
12.10.3 自動セミコロン挿入の興味深い事例
この節は非規範的である。ECMAScript プログラムは、自動セミコロン挿入に依存 することで、非常に少ないセミコロンを用いるスタイルでも記 述できる。上で述べたように、セミコロンはすべての改行位置 に挿入されるわけではなく、自動セミコロン挿入は line terminator をまたぐ複数 token に依存し得る。
新しい構文機能が ECMAScript に追加されると、その前 にある自動セミコロン挿入に依存する行について、parse 時 に文法生成規則が変化するような追加の文法生成規則が加えら れ得る。
この節の目的において、自動セミコロン挿入の事例が興味 深いと見なされるのは、それが、先行するソーステキストに応 じてセミコロンが挿入される場合とされない場合がある場所で ある場合である。この節の残りでは、このバージョンの ECMAScript における自動セミコロン挿入の興味深い事例を いくつか記述する。
12.10.3.1 Statement List における自動セミコロン挿入の興味深い事例
- 左丸括弧 (
()。セミコ ロンがない場合、2 行は together でCallExpression として扱われる。 - 左角括弧 (
[)。セミコ ロンがない場合、2 行はArrayLiteral またはArrayAssignmentPattern ではなく、 property access として扱われる。 - template literal (
`)。 セミコロンがない場合、2 行は together でタグ付き Template（13.3.11 ） として解釈され、前の式がMemberExpression にな る。 - 単項
+または-。 セミコロンがない場合、2 行は together で対応する二項 演算子の使用として解釈される。 - RegExp literal。セミコロ
ンがない場合、2 行は代わりに
/MultiplicativeOperator として parse され得 る。たとえば RegExp が flag を持つ場合である。
12.10.3.2 自動セミコロン挿入と “[no LineTerminator here]” の事例
この節は非規範的である。
ECMAScript は “[no
この節の残りでは、このバージョンの ECMAScript に
おいて “[no
12.10.3.2.1 optional operand と “[no LineTerminator here]” を持つ文法生成規則の一覧
UpdateExpression .ContinueStatement .BreakStatement .ReturnStatement .YieldExpression .- 関数定義
(
15.2 ) との関係における Async 関数定義 (15.8 )
13 ECMAScript 言語: 式
13.1 識別子
構文
yield および await は、文法上は
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 である。
-
構文文法の
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 である。 -
構文文法の
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" を返す。
IdentifierName のStringValue を返す。
- 0x0023 (NUMBER SIGN) と
IdentifierName のStringValue のstring-concatenation を返す。
StringLiteral のSV を返す。
13.1.3 Runtime Semantics: Evaluation
- ?
ResolveBinding (StringValue ofIdentifier ) を返す。
- ?
ResolveBinding ("yield" ) を返す。
- ?
ResolveBinding ("await" ) を返す。
yield
は識別子として使用できる。
yield の束縛を解決
する。Early Error 制約により、そのような評価は
13.2 Primary Expression
構文
補助構文
次の production の instance を処理するとき
13.2.1 this Keyword
13.2.1.1 Runtime Semantics: Evaluation
- ?
ResolveThisBinding () を返す。
13.2.2 Identifier Reference
13.2.3 リテラル
構文
13.2.3.1 Runtime Semantics: Evaluation
null を返す。
BooleanLiteral が tokenfalseなら、false を返す。BooleanLiteral が tokentrueなら、true を返す。
12.9.3 で定義されるNumericLiteral のNumericValue を返す。
12.9.4.2 で定義されるStringLiteral のSV を返す。
13.2.4 Array Initializer
Array element は element list の先頭・中
間・末尾で省略され得る。element list 内の comma
の直前に
構文
13.2.4.1 Runtime Semantics: ArrayAccumulation
The
- array および (nextIndex + 1) を引数と
する
Elision のArrayAccumulation を ? 返す。
Elision が存在するなら、- nextIndex を、array および
nextIndex を引数とする
Elision のArrayAccumulation の ? に設定する。
- nextIndex を、array および
nextIndex を引数とする
- initResult を ?
Evaluation ofAssignmentExpression とする。 - initValue を ?
GetValue (initResult) とする。 - !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (nextIndex)), initValue) を実行する。 - nextIndex + 1 を返す。
Elision が存在するなら、- nextIndex を、array および
nextIndex を引数とする
Elision のArrayAccumulation の ? に設定する。
- nextIndex を、array および
nextIndex を引数とする
- array および nextIndex を引数とする
SpreadElement のArrayAccumulation を ? 返す。
- nextIndex を、array および
nextIndex を引数とする、導出された
ElementList のArrayAccumulation の ? に設定する。 Elision が存在するなら、- nextIndex を、array および
nextIndex を引数とする
Elision のArrayAccumulation の ? に設定する。
- nextIndex を、array および
nextIndex を引数とする
- initResult を ?
Evaluation ofAssignmentExpression とする。 - initValue を ?
GetValue (initResult) とする。 - !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (nextIndex)), initValue) を実行する。 - nextIndex + 1 を返す。
- nextIndex を、array および
nextIndex を引数とする、導出された
ElementList のArrayAccumulation の ? に設定する。 Elision が存在するなら、- nextIndex を、array および
nextIndex を引数とする
Elision のArrayAccumulation の ? に設定する。
- nextIndex を、array および
nextIndex を引数とする
- array および nextIndex を引数とする
SpreadElement のArrayAccumulation を ? 返す。
- spreadRef を ?
Evaluation ofAssignmentExpression とする。 - 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 の初期化を記述する式である。これ
は、0 個以上の
構文
ある文脈では、
13.2.5.1 Static Semantics: Early Errors
-
MethodDefinition のHasDirectSuper がtrue なら、それは Syntax Error であ る。 -
MethodDefinition のPrivateBoundIdentifiers が空でないな ら、それは Syntax Error である。
実際の object initializer を記述することに加え
て、
- この production に任意の source text が 一致する場合、それは Syntax Error である。
この production は、
-
PropertyDefinitionList のPropertyNameList が"__proto__" に対 する重複項目を含み、かつそれらのうち少なくとも 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 を、導出された
PropertyDefinitionList のPropertyDefinitionNodes とする。 - head と «
PropertyDefinition » のlist-concatenation を返す。
13.2.5.4 Static Semantics: PropertyNameList
The
- propName を
PropertyDefinition のPropName とする。 - propName が
empty なら、新しい空のList を返す。 - « propName » を返す。
- list を
PropertyDefinitionList のPropertyNameList とする。 - propName を
PropertyDefinition のPropName とする。 - propName が
empty なら、list を返 す。 - list と « propName » の
list-concatenation を返す。
13.2.5.5 Runtime Semantics: Evaluation
- obj を
OrdinaryObjectCreate (%Object.prototype% ) とする。 - obj を引数として
PropertyDefinitionList のPropertyDefinitionEvaluation を ? 実行す る。 - obj を返す。
IdentifierName のStringValue を返す。
StringLiteral のSV を返す。
- nbr を
NumericLiteral のNumericValue とする。 - !
ToString (nbr) を返す。
- exprValue を ?
Evaluation ofAssignmentExpression とする。 - propName を ?
GetValue (exprValue) とする。 - ?
ToPropertyKey (propName) を返す。
13.2.5.6 Runtime Semantics: PropertyDefinitionEvaluation
The
- object を引数として
PropertyDefinitionList のPropertyDefinitionEvaluation を ? 実行す る。 - object を引数として
PropertyDefinition のPropertyDefinitionEvaluation を ? 実 行する。 unused を返す。
- exprValue を ?
Evaluation ofAssignmentExpression とする。 - fromValue を ?
GetValue (exprValue) とする。 - excludedNames を新しい空の
List とす る。 - ?
CopyDataProperties (object, fromValue, excludedNames) を実行する。 unused を返す。
- propName を
IdentifierReference のStringValue とする。 - exprValue を ?
Evaluation ofIdentifierReference とする。 - propValue を ?
GetValue (exprValue) とする。 Assert : object は、non-configurable property を持たない、通常かつ拡張可能な object である。- !
CreateDataPropertyOrThrow (object, propName, propValue) を実行する。 unused を返す。
- propertyKey を ?
Evaluation ofPropertyName とする。 - この
PropertyDefinition がParseJSON のために評価されているScript の内部に含 まれている場合 （ParseJSON の step6 を参照）、- isProtoSetter を
false とする。
- isProtoSetter を
- Else if propertyKey が
"__proto__" であり、かつPropertyName のIsComputedPropertyKey がfalse なら、- isProtoSetter を
true とする。
- isProtoSetter を
- Else,
- isProtoSetter を
false とする。
- isProtoSetter を
IsAnonymousFunctionDefinition (AssignmentExpression ) がtrue かつ isProtoSetter がfalse なら、- propValue を、propertyKey を引数と
する
AssignmentExpression のNamedEvaluation の ? とする。
- propValue を、propertyKey を引数と
する
- Else,
- exprValueRef を ?
Evaluation ofAssignmentExpression とする。 - propValue を ?
GetValue (exprValueRef) とする。
- exprValueRef を ?
- isProtoSetter が
true なら、- propValue が Object または
null な ら、- ! object.[[SetPrototypeOf]](propValue) を実行する。
unused を返す。
- propValue が Object または
Assert : object は、non-configurable property を持たない、通常かつ拡張可能な object である。- !
CreateDataPropertyOrThrow (object, propertyKey, propValue) を実行する。 unused を返す。
- object および
true を引数としてMethodDefinition のMethodDefinitionEvaluation を ? 実行す る。 unused を返す。
13.2.6 関数定義式
13.2.7 正規表現リテラル
構文
13.2.7.1 Static Semantics: Early Errors
-
IsValidRegularExpressionLiteral (RegularExpressionLiteral ) がfalse なら、それは Syntax Error である。
13.2.7.2 Static Semantics: IsValidRegularExpressionLiteral ( literal )
The
- flags を literal の
FlagText とする。 - flags が
d,g,i,m,s,u,v,y以外の code point を 含むなら、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 要素を Unicode BMP code point として解釈した結果生じる code point 列 に設定する。要素には UTF-16 decoding は適 用しない。
- stringValue を
- parseResult を
ParsePattern (patternText, u, v) とする。 - parseResult が
Parse Node なら、true を返す。 false を返す。
13.2.7.3 Runtime Semantics: Evaluation
- pattern を
CodePointsToString (BodyText ofRegularExpressionLiteral ) とする。 - flags を
CodePointsToString (FlagText ofRegularExpressionLiteral ) とする。 - !
RegExpCreate (pattern, flags) を返 す。
13.2.8 Template Literal
構文
13.2.8.1 Static Semantics: Early Errors
-
[Tagged] parameter が設定されて
おらず、かつ
NoSubstitutionTemplate がNotEscapeSequence を含む場合、それは Syntax Error である。
-
引数
false を伴うTemplateLiteral のTemplateStrings の要素数が 232 以上である場合、それは Syntax Error である。
-
[Tagged] parameter が設定されて
おらず、かつ
TemplateHead がNotEscapeSequence を含む場合、それは Syntax Error である。
-
[Tagged] parameter が設定されて
おらず、かつ
TemplateTail がNotEscapeSequence を含む場合、それは Syntax Error である。
-
[Tagged] parameter が設定されて
おらず、かつ
TemplateMiddle がNotEscapeSequence を含む場合、それは Syntax Error である。
13.2.8.2 Static Semantics: TemplateStrings
The
- «
TemplateString (NoSubstitutionTemplate , raw) » を返す。
- head を «
TemplateString (TemplateHead , raw) » とする。 - tail を、raw を引数とする
TemplateSpans のTemplateStrings とす る。 - head と tail の
list-concatenation を返す。
- «
TemplateString (TemplateTail , raw) » を返す。
- middle を、raw を引数とする
TemplateMiddleList のTemplateStrings とする。 - tail を «
TemplateString (TemplateTail , raw) » とする。 - middle と tail の
list-concatenation を返す。
- «
TemplateString (TemplateMiddle , raw) » を返す。
- front を、raw を引数とする
TemplateMiddleList のTemplateStrings とする。 - last を «
TemplateString (TemplateMiddle , raw) » とする。 - front と last の
list-concatenation を返す。
13.2.8.3 Static Semantics: TemplateString ( templateToken, raw )
The
この操作は、raw が
13.2.8.4 GetTemplateObject ( templateLiteral )
The
- realm を
current Realm Record とする。 - templateRegistry を realm.[[TemplateMap]] とする。
- templateRegistry の各要素 e につい
て、次を行う
- e.[[Site]] が templateLiteral と
同じ Parse Node なら、- e.[[Array]] を返す。
- e.[[Site]] が templateLiteral と
- rawStrings を、引数
true を伴う templateLiteral のTemplateStrings とする。 Assert : rawStrings は String のList である。- cookedStrings を、引数
false を伴う templateLiteral のTemplateStrings とする。 - count を
List cookedStrings の要素 数とする。 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 の作成は
この仕様の将来版では、template object の追 加の non-enumerable property が定義されることが ある。
13.2.8.5 Runtime Semantics: SubstitutionEvaluation
The
- 新しい空の
List を返す。
TemplateMiddleList のSubstitutionEvaluation を ? 返す。
- subRef を ?
Evaluation ofExpression とする。 - sub を ?
GetValue (subRef) とする。 - « sub » を返す。
- preceding を
TemplateMiddleList のSubstitutionEvaluation の ? とする。 - nextRef を ?
Evaluation ofExpression とする。 - 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 を ?
Evaluation ofExpression とする。 - sub を ?
GetValue (subRef) とする。 - middle を ?
ToString (sub) とする。 - tail を ?
Evaluation ofTemplateSpans とする。 - head, middle, および tail の
string-concatenation を返す。
+ 演算子というより
String.prototype.concat に近い。
12.9.6 で定義されるTemplateTail のTV を返 す。
- head を ?
Evaluation ofTemplateMiddleList とする。 - tail を
12.9.6 で定義されるTemplateTail のTV とす る。 - head と tail の
string-concatenation を返す。
- head を
12.9.6 で定義されるTemplateMiddle のTV とす る。 - subRef を ?
Evaluation ofExpression とする。 - sub を ?
GetValue (subRef) とする。 - middle を ?
ToString (sub) とする。 - head と middle の
string-concatenation を返す。
+ 演算子というより
String.prototype.concat に近い。
- rest を ?
Evaluation ofTemplateMiddleList とする。 - middle を
12.9.6 で定義されるTemplateMiddle のTV とす る。 - subRef を ?
Evaluation ofExpression とする。 - sub を ?
GetValue (subRef) とする。 - last を ?
ToString (sub) とする。 - rest, middle, および last の
string-concatenation を返す。
+ 演算子というより
String.prototype.concat に近い。
13.2.9 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 のような演算子を括弧付き
式へ適用できるようにすることである。
13.3 Left-Hand-Side Expressions
構文
補助構文
次の production の instance を処理するとき
13.3.1 Static Semantics
13.3.1.1 Static Semantics: Early Errors
- 任意の source text がこの production に 一致する場合、それは Syntax Error である。
この production は、次の code に対して自
動セミコロン挿入規則
（
a?.b
`c`そうでなければ、それが 2 つの妥当な文として解釈さ れてしまうからである。目的は、optional chaining を 持たない類似 code との一貫性を維持することである:
a.b
`c`これは妥当な文であり、自動セミコロン挿入は適用され ない。
-
syntactic
goal symbol がModule でない場合、それは Syntax Error である。
13.3.2 Property Accessors
property は、名前によってアクセスされ、次のよう な dot notation を用いる:
または、次のような bracket notation を用い る:
dot notation は、次の構文変換によって説明され る:
これは、その振る舞いにおいて次と同一である:
同様に
これは、その振る舞いにおいて次と同一である:
ここで <identifier-name-string> は
13.3.2.1 Runtime Semantics: Evaluation
- baseReference を ?
Evaluation ofMemberExpression とする。 - baseValue を ?
GetValue (baseReference) とする。 - strict を
IsStrict (thisMemberExpression ) とする。 - ?
EvaluatePropertyAccessWithExpressionKey ( baseValue,Expression , strict) を返 す。
- baseReference を ?
Evaluation ofMemberExpression とする。 - baseValue を ?
GetValue (baseReference) とする。 - strict を
IsStrict (thisMemberExpression ) とする。 EvaluatePropertyAccessWithIdentifierKey ( baseValue,IdentifierName , strict) を 返す。
- baseReference を ?
Evaluation ofMemberExpression とする。 - baseValue を ?
GetValue (baseReference) とする。 - fieldNameString を
PrivateIdentifier のStringValue とす る。 MakePrivateReference (baseValue, fieldNameString) を返す。
- baseReference を ?
Evaluation ofCallExpression とする。 - baseValue を ?
GetValue (baseReference) とする。 - strict を
IsStrict (thisCallExpression ) とする。 - ?
EvaluatePropertyAccessWithExpressionKey ( baseValue,Expression , strict) を返 す。
- baseReference を ?
Evaluation ofCallExpression とする。 - baseValue を ?
GetValue (baseReference) とする。 - strict を
IsStrict (thisCallExpression ) とする。 EvaluatePropertyAccessWithIdentifierKey ( baseValue,IdentifierName , strict) を 返す。
- baseReference を ?
Evaluation ofCallExpression とする。 - baseValue を ?
GetValue (baseReference) とする。 - fieldNameString を
PrivateIdentifier のStringValue とす る。 MakePrivateReference (baseValue, fieldNameString) を返す。
13.3.3 EvaluatePropertyAccessWithExpressionKey ( baseValue, expression, strict )
The
- propertyNameReference を ?
Evaluation of expression とする。 - propertyNameValue を
?
GetValue (propertyNameReference) とす る。 NOTE : ほとんどの場合、ToPropertyKey はこの手順の直後に propertyNameValue に対して実行される。し かしa[b] = cの場合、それはcの評価後 まで実行されない。Reference Record { [[Base]]: baseValue, [[ReferencedName]]: propertyNameValue, [[Strict]]: strict, [[ThisValue]]:empty } を返す。
13.3.4 EvaluatePropertyAccessWithIdentifierKey ( baseValue, identifierName, strict )
The
- propertyNameString を identifierName の
StringValue とする。 Reference Record { [[Base]]: baseValue, [[ReferencedName]]: propertyNameString, [[Strict]]: strict, [[ThisValue]]:empty } を返す。
13.3.5 new Operator
13.3.5.1 Runtime Semantics: Evaluation
- ?
EvaluateNew (NewExpression ,empty ) を返 す。
- ?
EvaluateNew (MemberExpression ,Arguments ) を返す。
13.3.5.1.1 EvaluateNew ( constructExpr, arguments )
The
- ref を ?
Evaluation of constructExpr とする。 - constructor を ?
GetValue (ref) とす る。 - arguments が
empty なら、- argList を新しい空の
List とする。
- argList を新しい空の
- Else,
- argList を ?
ArgumentListEvaluation of arguments とする。
- argList を ?
IsConstructor (constructor) がfalse なら、TypeError 例外を送出する。- ?
Construct (constructor, argList) を 返す。
13.3.6 関数呼出し
13.3.6.1 Runtime Semantics: Evaluation
- expr を
CoverCallExpressionAndAsyncArrowHead に よって cover されるCallMemberExpression とする。 - memberExpr を expr の
MemberExpression とする。 - arguments を expr の
Arguments と する。 - ref を ?
Evaluation of memberExpr とする。 - func を ?
GetValue (ref) とする。 - ref が
Reference Record であり、IsPropertyReference (ref) がfalse であ り、かつ ref.[[ReferencedName]] が"eval" なら、SameValue (func,%eval% ) がtrue なら、- argList を ?
ArgumentListEvaluation of arguments とする。 - argList が要素を持たないなら、
undefined を返す。 - evalArg を argList の最初の要素 とする。
IsStrict (thisCallExpression ) がtrue なら、strictCaller をtrue とする; そうでなければ strictCaller をfalse とする。- ?
PerformEval (evalArg, strictCaller,true ) を返す。
- argList を ?
- thisCall を this
CallExpression とす る。 - tailCall を
IsInTailPosition (thisCall) とする。 - ?
EvaluateCall (func, ref, arguments, tailCall) を返す。
step
- ref を ?
Evaluation ofCallExpression とする。 - func を ?
GetValue (ref) とする。 - thisCall を this
CallExpression とす る。 - tailCall を
IsInTailPosition (thisCall) とする。 - ?
EvaluateCall (func, ref,Arguments , tailCall) を返す。
13.3.6.2 EvaluateCall ( func, ref, arguments, tailPosition )
The
- ref が
Reference Record なら、IsPropertyReference (ref) がtrue な ら、- thisValue を
GetThisValue (ref) とする。
- thisValue を
- Else,
- refEnv を ref.[[Base]] とする。
Assert : refEnv はEnvironment Record である。- thisValue を
refEnv.
WithBaseObject () とする。
- Else,
- thisValue を
undefined とする。
- thisValue を
- argList を ?
ArgumentListEvaluation of arguments とする。 - func が Object でなければ、
TypeError 例外を送出する。 IsCallable (func) がfalse なら、TypeError 例外を送出する。- tailPosition が
true なら、PrepareForTailCall () を実行する。 - ?
Call (func, thisValue, argList) を 返す。
13.3.7 super Keyword
13.3.7.1 Runtime Semantics: Evaluation
- env を
GetThisEnvironment () とする。 - actualThis を ? env.
GetThisBinding () とする。 - propertyNameReference を ?
Evaluation ofExpression とする。 - propertyNameValue を
?
GetValue (propertyNameReference) とす る。 - strict を
IsStrict (thisSuperProperty ) とする。 NOTE : ほとんどの場合、ToPropertyKey はこの手順の直後に propertyNameValue に対して実行される。し かしsuper[b] = cの場合、それはcの 評価後まで実行されない。MakeSuperPropertyReference (actualThis, propertyNameValue, strict) を返す。
- env を
GetThisEnvironment () とする。 - actualThis を ? env.
GetThisBinding () とする。 - propertyKey を
IdentifierName のStringValue とする。 - strict を
IsStrict (thisSuperProperty ) とする。 MakeSuperPropertyReference (actualThis, propertyKey, strict) を返す。
- newTarget を
GetNewTarget () とする。 Assert : newTarget はconstructor であ る。- superConstructor を
GetSuperConstructor () とする。 - argList を ?
ArgumentListEvaluation ofArguments とする。 IsConstructor (superConstructor) がfalse なら、TypeError 例外を送出 する。- result を
?
Construct (superConstructor, argList, newTarget) とする。 - thisER を
GetThisEnvironment () とす る。 Assert : thisER はFunction Environment Record である。- ?
BindThisValue (thisER, result) を 実行する。 - funcObj を thisER.[[FunctionObject]] とする。
Assert : funcObj は ECMAScript 関数 object である。- ?
InitializeInstanceElements (result, funcObj) を実行する。 - result を返す。
13.3.7.2 GetSuperConstructor ( )
The
- envRec を
GetThisEnvironment () とする。 Assert : envRec はFunction Environment Record である。- activeFunction を envRec.[[FunctionObject]] とする。
Assert : activeFunction は ECMAScript 関数 object である。- superConstructor を ! activeFunction.[[GetPrototypeOf]]() とする。
- superConstructor を返す。
13.3.7.3 MakeSuperPropertyReference ( actualThis, propertyKey, strict )
The
- env を
GetThisEnvironment () とする。 Assert : env.HasSuperBinding () istrue .Assert : env はFunction Environment Record である。- baseValue を
GetSuperBase (env) とす る。 Reference Record { [[Base]]: baseValue, [[ReferencedName]]: propertyKey, [[Strict]]: strict, [[ThisValue]]: actualThis } を返す。
13.3.8 Argument List
argument list の評価は、値の
13.3.8.1 Runtime Semantics: ArgumentListEvaluation
The
- 新しい空の
List を返す。
- ref を ?
Evaluation ofAssignmentExpression とする。 - arg を ?
GetValue (ref) とする。 - « arg » を返す。
- list を新しい空の
List とする。 - spreadRef を ?
Evaluation ofAssignmentExpression とする。 - spreadObj を ?
GetValue (spreadRef) とする。 - iteratorRecord を
?
GetIterator (spreadObj,sync ) とす る。 - 繰り返す
- next を
?
IteratorStepValue (iteratorRecord) とする。 - next が
done なら、list を返す。 - next を list に append する。
- next を
?
- precedingArgs を
ArgumentList のArgumentListEvaluation の ? とする。 - ref を ?
Evaluation ofAssignmentExpression とする。 - arg を ?
GetValue (ref) とする。 - precedingArgs と « arg » の
list-concatenation を返す。
- precedingArgs を
ArgumentList のArgumentListEvaluation の ? とする。 - spreadRef を ?
Evaluation ofAssignmentExpression とする。 - 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 を
?
ArgumentListEvaluation ofSubstitutionTemplate とする。 - « siteObj » と remaining の
list-concatenation を返す。
- firstSubRef を ?
Evaluation ofExpression とする。 - firstSub を ?
GetValue (firstSubRef) とする。 - restSub を ?
SubstitutionEvaluation ofTemplateSpans とする。 Assert : restSub は空である場合もあるList である。- « firstSub » と restSub の
list-concatenation を返す。
13.3.9 Optional Chain
?. で始まるものであ
る。13.3.9.1 Runtime Semantics: Evaluation
- baseReference を ?
Evaluation ofMemberExpression とする。 - baseValue を ?
GetValue (baseReference) とする。 - baseValue が
undefined またはnull のいずれかなら、undefined を返す。
- baseValue および baseReference を引数
とする
OptionalChain のChainEvaluation を ? 返す。
- baseReference を ?
Evaluation ofCallExpression とする。 - baseValue を ?
GetValue (baseReference) とする。 - baseValue が
undefined またはnull のいずれかなら、undefined を返す。
- baseValue および baseReference を引数
とする
OptionalChain のChainEvaluation を ? 返す。
- baseReference を ?
Evaluation ofOptionalExpression とする。 - baseValue を ?
GetValue (baseReference) とする。 - baseValue が
undefined またはnull のいずれかなら、undefined を返す。
- baseValue および baseReference を引数
とする
OptionalChain のChainEvaluation を ? 返す。
13.3.9.2 Runtime Semantics: ChainEvaluation
The
- thisChain を this
OptionalChain とする。 - tailCall を
IsInTailPosition (thisChain) とする。 - ?
EvaluateCall (baseValue, baseReference,Arguments , tailCall) を返す。
- strict を
IsStrict (thisOptionalChain ) とする。 - ?
EvaluatePropertyAccessWithExpressionKey ( baseValue,Expression , strict) を返 す。
- strict を
IsStrict (thisOptionalChain ) とする。 EvaluatePropertyAccessWithIdentifierKey ( baseValue,IdentifierName , strict) を 返す。
- fieldNameString を
PrivateIdentifier のStringValue とする。 MakePrivateReference (baseValue, fieldNameString) を返す。
- optionalChain を
OptionalChain とする。 - newReference を、baseValue および
baseReference を引数とする
optionalChain の
ChainEvaluation の ? とする。 - newValue を ?
GetValue (newReference) とする。 - thisChain を this
OptionalChain とす る。 - tailCall を
IsInTailPosition (thisChain) とする。 - ?
EvaluateCall (newValue, newReference,Arguments , tailCall) を返す。
- optionalChain を
OptionalChain とする。 - newReference を、baseValue および
baseReference を引数とする
optionalChain の
ChainEvaluation の ? とする。 - newValue を ?
GetValue (newReference) とする。 - strict を
IsStrict (thisOptionalChain ) とする。 - ?
EvaluatePropertyAccessWithExpressionKey ( newValue,Expression , strict) を返 す。
- optionalChain を
OptionalChain とする。 - newReference を、baseValue および
baseReference を引数とする
optionalChain の
ChainEvaluation の ? とする。 - newValue を ?
GetValue (newReference) とする。 - strict を
IsStrict (thisOptionalChain ) とする。 EvaluatePropertyAccessWithIdentifierKey ( newValue,IdentifierName , strict) を 返す。
- optionalChain を
OptionalChain とする。 - newReference を、baseValue および
baseReference を引数とする
optionalChain の
ChainEvaluation の ? とする。 - newValue を ?
GetValue (newReference) とする。 - fieldNameString を
PrivateIdentifier のStringValue とする。 MakePrivateReference (newValue, fieldNameString) を返す。
13.3.10 Import Call
13.3.10.1 Runtime Semantics: Evaluation
- ?
EvaluateImportCall (最初のAssignmentExpression , 2 番目のAssignmentExpression ) を返す。
13.3.10.2 EvaluateImportCall ( specifierExpression [ , optionsExpression ] )
The
- referrer を
GetActiveScriptOrModule () とする。 - referrer が
null なら、referrer をcurrent Realm Record に設定する。 - specifierRef を ?
Evaluation of specifierExpression とする。 - specifier を ?
GetValue (specifierRef) とする。 - optionsExpression が存在するなら、
- optionsRef を ?
Evaluation of optionsExpression とする。 - options を ?
GetValue (optionsRef) とする。
- optionsRef を ?
- Else,
- options を
undefined とする。
- options を
- promiseCapability を
!
NewPromiseCapability (%Promise% ) とする。 - specifierString を
Completion (ToString (specifier)) とする。 IfAbruptRejectPromise (specifierString, promiseCapability).- attributes を新しい空の
List とする。 - options が
undefined でないなら、- options が Object でないなら、
- !
Call (promiseCapability.[[Reject]],undefined , « 新たに作成されたTypeError object ») を実行する。 - promiseCapability.[[Promise]] を返す。
- !
- attributesObj を
Completion (Get (options,"with" )) とする。 IfAbruptRejectPromise (attributesObj, promiseCapability).- attributesObj が
undefined でない なら、- attributesObj が Object でないな
ら、
- !
Call (promiseCapability.[[Reject]],undefined , « 新たに作成されたTypeError object ») を実行する。 - promiseCapability.[[Promise]] を返 す。
- !
- entries を
Completion (EnumerableOwnProperties ( attributesObj,key+value )) とす る。 IfAbruptRejectPromise (entries, promiseCapability).- entries の各要素 entry について、 次を行う
- attributesObj が Object でないな
ら、
AllImportAttributesSupported (attributes) がfalse なら、- !
Call (promiseCapability.[[Reject]],undefined , « 新たに作成されたTypeError object ») を実行する。 - promiseCapability.[[Promise]] を返 す。
- !
- attributes を、それぞれの [[Key]]
field の値を UTF-16 code unit 値列と
して扱ったときの辞書順に従って sort す
る。
NOTE : この sorting は、host が attribute の列挙順序に基づいて挙動を変えて はならないという点においてのみ観測可能であ る。
- options が Object でないなら、
- moduleRequest を新しい
ModuleRequest
Record { [[Specifier]]: specifierString, [[Attributes]]: attributes } とする。 HostLoadImportedModule (referrer, moduleRequest,empty , promiseCapability) を実行する。- promiseCapability.[[Promise]] を返す。
13.3.10.3 ContinueDynamicImport ( promiseCapability, moduleCompletion )
The import()
- moduleCompletion が
abrupt completion なら、- !
Call (promiseCapability.[[Reject]],undefined , « moduleCompletion.[[Value]] ») を実行する。 unused を返す。
- !
- module を moduleCompletion.[[Value]] とする。
- loadPromise を
module.
LoadRequestedModules () とする。 - rejectedClosure を、(reason) を引数
とし、promiseCapability を capture
し、呼び出されたとき次の手順を実行する新しい
Abstract Closure とする:- !
Call (promiseCapability.[[Reject]],undefined , « reason ») を実行す る。 NormalCompletion (undefined ) を返 す。
- !
- onRejected を
CreateBuiltinFunction (rejectedClosure, 1,"" , « ») とする。 - linkAndEvaluateClosure を、引数を持た
ず、module, promiseCapability, およ
び onRejected を capture し、呼び出
されたとき次の手順を実行する新しい
Abstract Closure とする:- link を
Completion (module.Link ()) とする。 - link が
abrupt completion なら、- !
Call (promiseCapability.[[Reject]],undefined , « link.[[Value]] ») を実行する。 NormalCompletion (undefined ) を返 す。
- !
- evaluatePromise を
module.
Evaluate () とする。 - fulfilledClosure を、引数を持たず、
module および promiseCapability
を capture し、呼び出されたとき次の手
順を実行する新しい
Abstract Closure と する:- 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 Template
tagged template は function call であ
り、その call の引数は
13.3.11.1 Runtime Semantics: Evaluation
- tagRef を ?
Evaluation ofMemberExpression とする。 - tagFunc を ?
GetValue (tagRef) とす る。 - thisCall を this
MemberExpression とする。 - tailCall を
IsInTailPosition (thisCall) とする。 - ?
EvaluateCall (tagFunc, tagRef,TemplateLiteral , tailCall) を返す。
- tagRef を ?
Evaluation ofCallExpression とする。 - tagFunc を ?
GetValue (tagRef) とす る。 - thisCall を this
CallExpression とする。 - tailCall を
IsInTailPosition (thisCall) とする。 - ?
EvaluateCall (tagFunc, tagRef,TemplateLiteral , tailCall) を返す。
13.3.12 Meta Property
13.3.12.1 Runtime Semantics: Evaluation
GetNewTarget () を返す。
- module を
GetActiveScriptOrModule () とする。 Assert : module は Source Text ModuleRecord である。- importMeta を module.[[ImportMeta]] とする。
- importMeta が
empty なら、- importMeta を
OrdinaryObjectCreate (null ) に設定す る。 - importMetaValues を
HostGetImportMetaProperties (module) とする。 - importMetaValues の各
Record { [[Key]], [[Value]] } p につい て、次を行う- !
CreateDataPropertyOrThrow ( importMeta, p.[[Key]], p.[[Value]]) を実行する。
- !
HostFinalizeImportMeta (importMeta, module) を実行する。- module.[[ImportMeta]] を importMeta に設定する。
- importMeta を返す。
- importMeta を
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 を準備するために、任意の特別な操作を実行できるよ
うにする。
ほとんどの
HostFinalizeImportMeta の default
implementation は
13.4 Update Expression
構文
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 を ?
Evaluation ofLeftHandSideExpression とする。 LeftHandSideExpression のAssignmentTargetType がweb-compat な ら、ReferenceError 例外を送出する。- oldValue を
?
ToNumeric (?GetValue (lhs)) とする。 - oldValue が Number なら、
- newValue を
Number::add (oldValue,1 𝔽) とする。
- newValue を
- Else,
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 を ?
Evaluation ofLeftHandSideExpression とする。 LeftHandSideExpression のAssignmentTargetType がweb-compat な ら、ReferenceError 例外を送出する。- oldValue を
?
ToNumeric (?GetValue (lhs)) とする。 - oldValue が Number なら、
- newValue を
Number::subtract (oldValue,1 𝔽) とする。
- newValue を
- Else,
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 を ?
Evaluation ofUnaryExpression とする。 UnaryExpression のAssignmentTargetType がweb-compat なら、ReferenceError 例外を送出する。- oldValue を
?
ToNumeric (?GetValue (expr)) とする。 - oldValue が Number なら、
- newValue を
Number::add (oldValue,1 𝔽) とする。
- newValue を
- Else,
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 を ?
Evaluation ofUnaryExpression とする。 UnaryExpression のAssignmentTargetType がweb-compat なら、ReferenceError 例外を送出する。- oldValue を
?
ToNumeric (?GetValue (expr)) とする。 - oldValue が Number なら、
- newValue を
Number::subtract (oldValue,1 𝔽) とする。
- newValue を
- Else,
Assert : oldValue は BigInt である。- newValue を
BigInt::subtract (oldValue,1 ℤ) とする。
- ?
PutValue (expr, newValue) を実行す る。 - newValue を返す。
13.5 Unary Operator
構文
13.5.1 delete Operator
13.5.1.1 Static Semantics: Early Errors
-
IsStrict (theUnaryExpression ) がtrue であり、かつ導出されたUnaryExpression がPrimaryExpression : IdentifierReference MemberExpression : MemberExpression . PrivateIdentifier CallExpression : CallExpression . PrivateIdentifier OptionalChain : ?. PrivateIdentifier OptionalChain : OptionalChain . PrivateIdentifier -
導出された
UnaryExpression が
PrimaryExpression : CoverParenthesizedExpressionAndArrowParameterList
であり、かつCoverParenthesizedExpressionAndArrowParameterList が、もしそれをUnaryExpression の代わり に用いたならこれらの規則に従って Syntax Error を生じる phrase を最終的に導出する 場合、それは Syntax Error である。この規 則は再帰的に適用される。
最後の規則は、delete (((foo))) のような式
が、最初の規則の再帰的適用により
13.5.1.2 Runtime Semantics: Evaluation
- ref を ?
Evaluation ofUnaryExpression とする。 - ref が
Reference Record でないなら、true を返す。 IsUnresolvableReference (ref) がtrue なら、Assert : ref.[[Strict]] isfalse .true を返す。
IsPropertyReference (ref) がtrue な ら、Assert :IsPrivateReference (ref) isfalse .IsSuperReference (ref) がtrue な ら、ReferenceError 例外を送出する。- 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 例外を送出する。 - deleteStatus を返す。
- base を ref.[[Base]] とする。
Assert : base はEnvironment Record である。- ? base.
DeleteBinding (ref.[[ReferencedName]]) を返す。
delete 演算子が delete
演算子が
step
13.5.2 void Operator
13.5.2.1 Runtime Semantics: Evaluation
- expr を ?
Evaluation ofUnaryExpression とする。 - ?
GetValue (expr) を実行する。 undefined を返す。
13.5.3 typeof Operator
13.5.3.1 Runtime Semantics: Evaluation
- val を ?
Evaluation ofUnaryExpression とする。 - val が
Reference Record なら、IsUnresolvableReference (val) がtrue なら、"undefined" を返 す。
- val を ?
GetValue (val) に設定する。 - val が
undefined なら、"undefined" を返す。 - val が
null なら、"object" を返 す。 - val が String なら、
"string" を返 す。 - val が Symbol なら、
"symbol" を返 す。 - val が Boolean なら、
"boolean" を 返す。 - val が Number なら、
"number" を返 す。 - val が BigInt なら、
"bigint" を返 す。 Assert : val は Object である。host が web browser であるか、または[[IsHTMLDDA]] 内部スロット をサポートするなら、- val が [[IsHTMLDDA]] internal slot
を持つなら、
"undefined" を返す。
- val が [[IsHTMLDDA]] internal slot
を持つなら、
- val が [[Call]] internal method を持
つなら、
"function" を返す。 "object" を返す。
13.5.4 Unary + Operator
単項 + 演算子は、その operand を
13.5.4.1 Runtime Semantics: Evaluation
- expr を ?
Evaluation ofUnaryExpression とする。 - ?
ToNumber (?GetValue (expr)) を返す。
13.5.5 Unary - Operator
単項 - 演算子は、その operand を数値へ変換
し、その後それを negate する。
13.5.5.1 Runtime Semantics: Evaluation
- expr を ?
Evaluation ofUnaryExpression とする。 - 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 を ?
Evaluation ofUnaryExpression とする。 - 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 を ?
Evaluation ofUnaryExpression とする。 - oldValue を
ToBoolean (?GetValue (expr)) とする。 - oldValue が
true なら、false を返す。 true を返す。
13.6 Exponentiation Operator
構文
13.6.1 Runtime Semantics: Evaluation
13.7 Multiplicative Operator
構文
*演算子は乗算を行い、その operand の積 を生成する。/演算子は除算を行い、その operand の商 を生成する。%演算子は、暗黙の除算における operand の余りを生成する。
13.7.1 Runtime Semantics: Evaluation
- opText を
MultiplicativeOperator に 一致した source text とする。 - ?
EvaluateStringOrNumericBinaryExpression (MultiplicativeExpression , opText,ExponentiationExpression ) を返す。
13.8 Additive Operator
構文
13.8.1 Addition Operator ( + )
加算演算子は、文字列連結または数値加算のいずれかを行 う。
13.8.1.1 Runtime Semantics: Evaluation
13.8.2 Subtraction Operator ( - )
- 演算子は減算を行い、その operand の差
を生成する。
13.8.2.1 Runtime Semantics: Evaluation
13.9 Bitwise Shift Operator
構文
13.9.1 Left Shift Operator ( << )
左 operand に対して、右 operand によって指 定された量だけ bitwise left shift を行う。
13.9.1.1 Runtime Semantics: Evaluation
13.9.2 Signed Right Shift Operator ( >> )
左 operand に対して、右 operand によって指 定された量だけ、符号拡張を伴う bitwise right shift を行う。
13.9.2.1 Runtime Semantics: Evaluation
13.9.3 Unsigned Right Shift Operator ( >>> )
左 operand に対して、右 operand によって指 定された量だけ、0 埋めの bitwise right shift を 行う。
13.9.3.1 Runtime Semantics: Evaluation
13.10 Relational Operator
relational operator の評価結果は常に
構文
[In] 文法 parameter は、
relational expression における in 演算子と、
for 文における in 演算子とを混同しないために必
要である。
13.10.1 Runtime Semantics: Evaluation
- lRef を ?
Evaluation ofRelationalExpression とする。 - lVal を ?
GetValue (lRef) とする。 - rRef を ?
Evaluation ofShiftExpression とする。 - rVal を ?
GetValue (rRef) とする。 - result を ?
IsLessThan (lVal, rVal,true ) とする。 - result が
undefined なら、false を返す。 - result を返す。
- lRef を ?
Evaluation ofRelationalExpression とする。 - lVal を ?
GetValue (lRef) とする。 - rRef を ?
Evaluation ofShiftExpression とする。 - rVal を ?
GetValue (rRef) とする。 - result を ?
IsLessThan (rVal, lVal,false ) とする。 - result が
undefined なら、false を返す。 - result を返す。
- lRef を ?
Evaluation ofRelationalExpression とする。 - lVal を ?
GetValue (lRef) とする。 - rRef を ?
Evaluation ofShiftExpression とする。 - rVal を ?
GetValue (rRef) とする。 - result を ?
IsLessThan (rVal, lVal,false ) とする。 - result が
true またはundefined のいずれかなら、false を返す。 true を返す。
- lRef を ?
Evaluation ofRelationalExpression とする。 - lVal を ?
GetValue (lRef) とする。 - rRef を ?
Evaluation ofShiftExpression とする。 - rVal を ?
GetValue (rRef) とする。 - result を ?
IsLessThan (lVal, rVal,true ) とする。 - result が
true またはundefined のいずれかなら、false を返す。 true を返す。
- lRef を ?
Evaluation ofRelationalExpression とする。 - lVal を ?
GetValue (lRef) とする。 - rRef を ?
Evaluation ofShiftExpression とする。 - rVal を ?
GetValue (rRef) とする。 - ?
InstanceofOperator (lVal, rVal) を返 す。
- lRef を ?
Evaluation ofRelationalExpression とする。 - lVal を ?
GetValue (lRef) とする。 - rRef を ?
Evaluation ofShiftExpression とする。 - rVal を ?
GetValue (rRef) とする。 - rVal が Object でなければ、
TypeError 例外を送出する。 - ?
HasProperty (rVal, ?ToPropertyKey (lVal)) を返す。
- privateIdentifier を
PrivateIdentifier のStringValue とする。 - rRef を ?
Evaluation ofShiftExpression とする。 - rVal を ?
GetValue (rRef) とする。 - rVal が Object でなければ、
TypeError 例外を送出する。 - privateEnv を、
running execution context の PrivateEnvironment とする。 Assert : privateEnv はnull ではな い。- privateName を
ResolvePrivateIdentifier (privateEnv, privateIdentifier) とする。 PrivateElementFind (rVal, privateName) がempty なら、false を返す。true を返す。
13.10.2 InstanceofOperator ( value, target )
The
- target が Object でなければ、
TypeError 例外を送出する。 - instOfHandler を ?
GetMethod (target,%Symbol.hasInstance% ) とする。 - instOfHandler が
undefined でなければ、 IsCallable (target) がfalse なら、TypeError 例外を送出する。- ?
OrdinaryHasInstance (target, value) を返す。
steps
instanceof 演算子の意味論を定義するのに
instanceof 意味論を用い
る。
13.11 Equality Operator
equality operator の評価結果は常に
構文
13.11.1 Runtime Semantics: Evaluation
- lRef を ?
Evaluation ofEqualityExpression とする。 - lVal を ?
GetValue (lRef) とする。 - rRef を ?
Evaluation ofRelationalExpression とする。 - rVal を ?
GetValue (rRef) とする。 - ?
IsLooselyEqual (rVal, lVal) を返す。
- lRef を ?
Evaluation ofEqualityExpression とする。 - lVal を ?
GetValue (lRef) とする。 - rRef を ?
Evaluation ofRelationalExpression とする。 - rVal を ?
GetValue (rRef) とする。 - r を ?
IsLooselyEqual (rVal, lVal) とする。 - r が
true なら、false を返す。 true を返す。
- lRef を ?
Evaluation ofEqualityExpression とする。 - lVal を ?
GetValue (lRef) とする。 - rRef を ?
Evaluation ofRelationalExpression とする。 - rVal を ?
GetValue (rRef) とする。 IsStrictlyEqual (rVal, lVal) を返す。
- lRef を ?
Evaluation ofEqualityExpression とする。 - lVal を ?
GetValue (lRef) とする。 - rRef を ?
Evaluation ofRelationalExpression とする。 - rVal を ?
GetValue (rRef) とする。 - r を
IsStrictlyEqual (rVal, lVal) と する。 - r が
true なら、false を返す。 true を返す。
equality operator は次の不変条件を維持す る:
-
A != Bは!(A == B)と等価である。 -
A == Bは、AとBの評価順序を除け ば、B == Aと等価である。
equality operator は常に推移的であるわけ
ではない。たとえば、同じ String 値を表す 2 つの異な
る String object があり得る; それぞれの String
object は == 演算子によりその String 値と等しい
と見なされるが、2 つの String object 同士は互いに
等しくはない。たとえば:
-
new String("a") == "a"および"a" == new String("a")はどちらもtrue である。 -
new String("a") == new String("a")はfalse である。
String の比較は、code unit 値列に対する単純 な等値判定を用いる。Unicode 仕様で定義される、より複 雑で意味論指向の文字または文字列の等値性および照合順序の 定義を使用しようとはしない。したがって、Unicode Standard によれば正準同値である String 値が、不 等であると判定され得る。実質的に、この algorithm は 両方の String がすでに正規化済みであると仮定してい る。
13.12 Binary Bitwise Operator
構文
13.12.1 Runtime Semantics: Evaluation
13.13 Binary Logical Operator
構文
&& または || 演算子が生成する値は、
必ずしも
13.13.1 Runtime Semantics: Evaluation
- lRef を ?
Evaluation ofLogicalANDExpression とする。 - lVal を ?
GetValue (lRef) とする。 ToBoolean (lVal) がfalse なら、 lVal を返す。- rRef を ?
Evaluation ofBitwiseORExpression とする。 - ?
GetValue (rRef) を返す。
- lRef を ?
Evaluation ofLogicalORExpression とする。 - lVal を ?
GetValue (lRef) とする。 ToBoolean (lVal) がtrue なら、 lVal を返す。- rRef を ?
Evaluation ofLogicalANDExpression とする。 - ?
GetValue (rRef) を返す。
- lRef を ?
Evaluation ofCoalesceExpressionHead とする。 - lVal を ?
GetValue (lRef) とする。 - lVal が
undefined でもnull でも ないなら、lVal を返す。 - rRef を ?
Evaluation ofBitwiseORExpression とする。 - ?
GetValue (rRef) を返す。
13.14 Conditional Operator ( ? : )
構文
ECMAScript における
13.14.1 Runtime Semantics: Evaluation
- lRef を ?
Evaluation ofShortCircuitExpression とする。 - lVal を
ToBoolean (?GetValue (lRef)) とする。 - lVal が
true なら、- trueRef を、最初の
AssignmentExpression のEvaluation の ? とする。 - ?
GetValue (trueRef) を返す。
- trueRef を、最初の
- falseRef を、2 番目の
AssignmentExpression のEvaluation の ? とする。 - ?
GetValue (falseRef) を返す。
13.15 Assignment Operator
構文
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 でも ないなら、- lRef を ?
Evaluation ofLeftHandSideExpression とする。 LeftHandSideExpression のAssignmentTargetType がweb-compat なら、ReferenceError 例外を送出す る。IsAnonymousFunctionDefinition (AssignmentExpression ) がtrue であ り、かつIsIdentifierRef ofLeftHandSideExpression がtrue なら、- lhs を
LeftHandSideExpression のStringValue とする。 - rVal を、lhs を引数とする
AssignmentExpression のNamedEvaluation の ? とする。
- lhs を
- Else,
- rRef を ?
Evaluation ofAssignmentExpression とする。 - rVal を ?
GetValue (rRef) とす る。
- rRef を ?
- ?
PutValue (lRef, rVal) を実行する。 - rVal を返す。
- lRef を ?
- assignmentPattern を、
LeftHandSideExpression によって cover されるAssignmentPattern とする。 - rRef を ?
Evaluation ofAssignmentExpression とする。 - rVal を ?
GetValue (rRef) とする。 - rVal を引数として assignmentPattern
の
DestructuringAssignmentEvaluation を ? 実行する。 - rVal を返す。
- lRef を ?
Evaluation ofLeftHandSideExpression とする。 LeftHandSideExpression のAssignmentTargetType がweb-compat なら、ReferenceError 例外を送出する。- lVal を ?
GetValue (lRef) とする。 - rRef を ?
Evaluation ofAssignmentExpression とする。 - rVal を ?
GetValue (rRef) とする。 - assignmentOpText を
AssignmentOperator に一致した source text とする。 - opText を、以下の表において
assignmentOpText に対応付けられる
Unicode code point 列とする:
assignmentOpText opText **=***=*/=/%=%+=+-=-<<=<<>>=>>>>>=>>>&=&^=^|=| - r を
?
ApplyStringOrNumericBinaryOperator (lVal, opText, rVal) とする。 - ?
PutValue (lRef, r) を実行す る。 - r を返す。
- lRef を ?
Evaluation ofLeftHandSideExpression とする。 - lVal を ?
GetValue (lRef) と する。 ToBoolean (lVal) がfalse なら、 lVal を返す。IsAnonymousFunctionDefinition (AssignmentExpression ) がtrue であり、 かつIsIdentifierRef ofLeftHandSideExpression がtrue なら、- lhs を
LeftHandSideExpression のStringValue とする。 - rVal を、lhs を引数とする
AssignmentExpression のNamedEvaluation の ? とする。
- lhs を
- Else,
- rRef を ?
Evaluation ofAssignmentExpression とする。 - rVal を ?
GetValue (rRef) とする。
- rRef を ?
- ?
PutValue (lRef, rVal) を実 行する。 - rVal を返す。
- lRef を ?
Evaluation ofLeftHandSideExpression とする。 - lVal を ?
GetValue (lRef) とす る。 ToBoolean (lVal) がtrue なら、 lVal を返す。IsAnonymousFunctionDefinition (AssignmentExpression ) がtrue であり、 かつIsIdentifierRef ofLeftHandSideExpression がtrue なら、- lhs を
LeftHandSideExpression のStringValue とする。 - rVal を、lhs を引数とする
AssignmentExpression のNamedEvaluation の ? とする。
- lhs を
- Else,
- rRef を ?
Evaluation ofAssignmentExpression とする。 - rVal を ?
GetValue (rRef) とする。
- rRef を ?
- ?
PutValue (lRef, rVal) を実行 する。 - rVal を返す。
- lRef を ?
Evaluation ofLeftHandSideExpression とする。 - lVal を ?
GetValue (lRef) とする。 - lVal が
undefined でもnull でも ないなら、lVal を返す。 IsAnonymousFunctionDefinition (AssignmentExpression ) がtrue であり、 かつIsIdentifierRef ofLeftHandSideExpression がtrue なら、- lhs を
LeftHandSideExpression のStringValue とする。 - rVal を、lhs を引数とする
AssignmentExpression のNamedEvaluation の ? とする。
- lhs を
- Else,
- rRef を ?
Evaluation ofAssignmentExpression とする。 - rVal を ?
GetValue (rRef) とする。
- rRef を ?
- ?
PutValue (lRef, rVal) を 実行する。 - rVal を返す。
この式が
13.15.3 ApplyStringOrNumericBinaryOperator ( lVal, opText, rVal )
The **, *, /, %, +, -, <<, >>, >>>, &, ^, or |), and rVal (an ECMAScript language value) and returns either a
- opText が
+なら、- lPrim
を ?
ToPrimitive (lVal) とする。 - rPrim
を ?
ToPrimitive (rVal) とする。 - lPrim
が String または rPrim が String な
ら、
- lStr を ?
ToString (lPrim) とす る。 - rStr を ?
ToString (rPrim) とす る。 - lStr と rStr の
string-concatenation を返す。
- lStr を ?
- lVal を lPrim に設定する。
- rVal を rPrim に設定する。
- lPrim
を ?
NOTE : この時点で、それは数値演算でなければなら ない。- lNum を ?
ToNumeric (lVal) とする。 - rNum を ?
ToNumeric (rVal) とする。 SameType (lNum, rNum) がfalse な ら、TypeError 例外を送出する。- lNum が BigInt なら、
- opText が
**なら、 ?BigInt::exponentiate (lNum, rNum) を返す。 - opText が
/なら、 ?BigInt::divide (lNum, rNum) を返 す。 - opText が
%なら、 ?BigInt::remainder (lNum, rNum) を返す。 - opText が
>>>なら、 ?BigInt::unsignedRightShift (lNum, rNum) を返す。 - operation を、以下の表において
opText に対応付けられる
abstract operation とする:opText operation *BigInt::multiply +BigInt::add -BigInt::subtract <<BigInt::leftShift >>BigInt::signedRightShift &BigInt::bitwiseAND ^BigInt::bitwiseXOR |BigInt::bitwiseOR
- opText が
- Else,
Assert : lNum は Number である。- operation を、以下の表において
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(lNum, rNum) を返す。
steps
step
13.15.4 EvaluateStringOrNumericBinaryExpression ( leftOperand, opText, rightOperand )
The **, *, /, %, +, -, <<, >>, >>>, &, ^, or |), and rightOperand (a
- lRef を ?
Evaluation of leftOperand とする。 - lVal を ?
GetValue (lRef) とする。 - rRef を ?
Evaluation of rightOperand とする。 - rVal を ?
GetValue (rRef) とする。 - ?
ApplyStringOrNumericBinaryOperator (lVal, opText, rVal) を返す。
13.15.5 Destructuring Assignment
補助構文
ある特定の状況において、次の 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]] istrue .- ? 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]] istrue .- ? 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 とする。 - lRef を ?
ResolveBinding (propertyName) とする。 - v を ?
GetV (value, propertyName) とする。 Initializer が存在し、かつ v がundefined なら、IsAnonymousFunctionDefinition (Initializer ) がtrue なら、- v を、propertyName を引数とする
Initializer のNamedEvaluation の ? に設定する。
- v を、propertyName を引数とする
- Else,
- defaultValue を ?
Evaluation ofInitializer とする。 - v を ?
GetValue (defaultValue) に設定する。
- defaultValue を ?
- ?
PutValue (lRef, v) を実行する。 - « propertyName » を返す。
- name を ?
Evaluation ofPropertyName とする。 - value および name を引数として
AssignmentElement のKeyedDestructuringAssignmentEvaluation を ? 実行する。 - « name » を返す。
13.15.5.4 Runtime Semantics: RestDestructuringAssignmentEvaluation
The
- lRef を ?
Evaluation ofDestructuringAssignmentTarget とする。 - restObj を
OrdinaryObjectCreate (%Object.prototype% ) とする。 - ?
CopyDataProperties (restObj, value, excludedNames) を実行する。 - ?
PutValue (lRef, 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 でもないなら、- lRef を ?
Evaluation ofDestructuringAssignmentTarget とす る。
- lRef を ?
- value を
undefined とする。 - iteratorRecord.[[Done]] が
false な ら、- next を
?
IteratorStepValue (iteratorRecord) とする。 - next が
done でないなら、- value を next に設定する。
- next を
?
Initializer が存在し、かつ value がundefined なら、IsAnonymousFunctionDefinition (Initializer ) がtrue であり、か つIsIdentifierRef ofDestructuringAssignmentTarget がtrue なら、- target を
DestructuringAssignmentTarget のStringValue とする。 - v を、target を引数とする
Initializer のNamedEvaluation の ? とする。
- target を
- Else,
- defaultValue を ?
Evaluation ofInitializer とする。 - v を ?
GetValue (defaultValue) とする。
- defaultValue を ?
- Else,
- v を value とする。
DestructuringAssignmentTarget がObjectLiteral またはArrayLiteral のいずれかなら、- nestedAssignmentPattern を、
DestructuringAssignmentTarget によ って cover されるAssignmentPattern とする。 - v を引数とする
nestedAssignmentPattern の
DestructuringAssignmentEvaluation を ? 返す。
- nestedAssignmentPattern を、
- ?
PutValue (lRef, v) を返す。
destructuring pattern ではない
DestructuringAssignmentTarget がObjectLiteral でもArrayLiteral でもないなら、- lRef を ?
Evaluation ofDestructuringAssignmentTarget とす る。
- lRef を ?
- 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 (lRef, array) を返す。
- ?
- nestedAssignmentPattern を、
DestructuringAssignmentTarget によっ て cover されるAssignmentPattern と する。 - array を引数とする
nestedAssignmentPattern の
DestructuringAssignmentEvaluation を ? 返す。
13.15.5.6 Runtime Semantics: KeyedDestructuringAssignmentEvaluation
The
DestructuringAssignmentTarget がObjectLiteral でもArrayLiteral でもないなら、- lRef を ?
Evaluation ofDestructuringAssignmentTarget とす る。
- lRef を ?
- v を ?
GetV (value, propertyName) とする。 Initializer が存在し、かつ v がundefined なら、IsAnonymousFunctionDefinition (Initializer ) がtrue であり、か つIsIdentifierRef ofDestructuringAssignmentTarget がtrue なら、- target を
DestructuringAssignmentTarget のStringValue とする。 - rhsValue を、target を引数とす
る
Initializer のNamedEvaluation の ? とする。
- target を
- Else,
- defaultValue を ?
Evaluation ofInitializer とする。 - rhsValue を ?
GetValue (defaultValue) とする。
- defaultValue を ?
- Else,
- rhsValue を v とする。
DestructuringAssignmentTarget がObjectLiteral またはArrayLiteral のいずれかなら、- assignmentPattern を、
DestructuringAssignmentTarget によ って cover されるAssignmentPattern とする。 - rhsValue を引数とする
assignmentPattern の
DestructuringAssignmentEvaluation を ? 返す。
- assignmentPattern を、
- ?
PutValue (lRef, rhsValue) を返す。
13.16 Comma Operator ( , )
構文
13.16.1 Runtime Semantics: Evaluation
- lRef を ?
Evaluation ofExpression とする。 - ?
GetValue (lRef) を実行する。 - rRef を ?
Evaluation ofAssignmentExpression とする。 - ?
GetValue (rRef) を返す。
14 ECMAScript 言語: 文と宣言
構文
14.1 文の意味論
14.1.1 Runtime Semantics: Evaluation
empty を返す。
- ?
Evaluation ofFunctionDeclaration を返す。
- newLabelSet を新しい空の
List とする。 - newLabelSet を引数として this
BreakableStatement のLabelledEvaluation を ? 返す。
14.2 Block
構文
14.2.1 Static Semantics: Early Errors
-
StatementList のLexicallyDeclaredNames が重複する項目を含む場合、それは Syntax Error である。ただし、host が web browser であるか、またはブロックレベル Function Declaration の Web レガシー互換性意味論 をサポートしており、かつ以下の両条件が真である場合を除く:IsStrict (this production) がfalse である。- 重複する項目が FunctionDeclarations によってのみ束縛されている。
-
StatementList のLexicallyDeclaredNames の任意の要素がStatementList のVarDeclaredNames にも現れる場合、それは Syntax Error である。
14.2.2 Runtime Semantics: Evaluation
empty を返す。
- oldEnv を、
running execution context の LexicalEnvironment とする。 - blockEnv を
NewDeclarativeEnvironment (oldEnv) とす る。 BlockDeclarationInstantiation (StatementList , blockEnv) を実行する。running execution context の LexicalEnvironment を blockEnv に設定す る。- blockValue を
Completion (Evaluation ofStatementList ) とする。 running execution context の LexicalEnvironment を oldEnv に設定す る。- ? blockValue を返す。
どのように control が
- sl を ?
Evaluation ofStatementList とする。 - s を
Completion (Evaluation ofStatementListItem ) とする。 - ?
UpdateEmpty (s, sl) を返す。
eval 関数の呼出しはいずれも値 1 を返す:
eval("1;;;;;")
eval("1;{}")
eval("1;var a;")14.2.3 BlockDeclarationInstantiation ( code, env )
The
これは呼び出されると次の手順を実行する:
- declarations を code の
LexicallyScopedDeclarations とする。 - privateEnv を、
running execution context の PrivateEnvironment とする。 - declarations の各要素 decl について、
次を行う
- decl の
BoundNames の各要素 dn に ついて、次を行うIsConstantDeclaration of decl がtrue なら、- ! env.
CreateImmutableBinding (dn,true ) を実行する。
- ! env.
- Else,
host が web browser であるか、またはブロックレベル Function Declaration の Web レガシー互換性意味論 をサポートするなら、- ! env.
HasBinding (dn) がfalse なら、- ! env.
CreateMutableBinding (dn,false ) を実行する。
- ! env.
- ! env.
- Else,
- ! env.
CreateMutableBinding (dn,false ) を実行する。
- ! env.
- decl が
FunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 、またはAsyncGeneratorDeclaration のいずれか なら、- fn を decl の
BoundNames の唯一 の要素とする。 - fo を、env および privateEnv を
引数とする decl の
InstantiateFunctionObject とする。 host が web browser であるか、またはブロックレベル Function Declaration の Web レガシー互換性意味論 をサポートするなら、- env における fn の束縛が未初期化
の束縛なら、
- ! env.
InitializeBinding (fn, fo) を実行する。
- ! env.
- Else,
Assert : decl はFunctionDeclaration である。- ! env.
SetMutableBinding (fn, fo,false ) を実行する。
- env における fn の束縛が未初期化
の束縛なら、
- Else,
- ! env.
InitializeBinding (fn, fo) を実行する。
- ! env.
- fn を decl の
- decl の
unused を返す。
14.3 宣言と Variable Statement
14.3.1 Let および Const 宣言
let および const 宣言は、let 宣言内の
構文
14.3.1.1 Static Semantics: Early Errors
-
BindingList のBoundNames が"let" を 含む場合、それは Syntax Error である。 -
BindingList のBoundNames が重複する項目 を含む場合、それは Syntax Error である。
-
Initializer が存在せず、かつこのLexicalBinding を含むLexicalDeclaration のIsConstantDeclaration がtrue である 場合、それは Syntax Error である。
14.3.1.2 Runtime Semantics: Evaluation
- ?
Evaluation ofBindingList を実行する。 empty を返す。
- ?
Evaluation ofBindingList を実行する。 - ?
Evaluation ofLexicalBinding を返す。
- lhs を
!
ResolveBinding (StringValue ofBindingIdentifier ) とする。 - !
InitializeReferencedBinding (lhs,undefined ) を実行する。 empty を返す。
静的意味論規則により、この形の
const 宣言内には決して現れな
いことが保証される。
- bindingId を
BindingIdentifier のStringValue とする。 - lhs を !
ResolveBinding (bindingId) とする。 IsAnonymousFunctionDefinition (Initializer ) がtrue なら、- value を、bindingId を引数とする
Initializer のNamedEvaluation の ? とする。
- value を、bindingId を引数とする
- Else,
- rhs を ?
Evaluation ofInitializer とする。 - value を ?
GetValue (rhs) とする。
- rhs を ?
- !
InitializeReferencedBinding (lhs, value) を実行する。 empty を返す。
- rhs を ?
Evaluation ofInitializer とする。 - value を ?
GetValue (rhs) とする。 - env を、
running execution context の LexicalEnvironment とする。 - value および env を引数とする
BindingPattern のBindingInitialization を ? 返す。
14.3.2 Variable Statement
var statement は、
構文
14.3.2.1 Runtime Semantics: Evaluation
- ?
Evaluation ofVariableDeclarationList を実行する。 empty を返す。
- ?
Evaluation ofVariableDeclarationList を実行する。 - ?
Evaluation ofVariableDeclaration を返す。
empty を返す。
- bindingId を
BindingIdentifier のStringValue とする。 - lhs を ?
ResolveBinding (bindingId) とする。 IsAnonymousFunctionDefinition (Initializer ) がtrue なら、- value を、bindingId を引数とする
Initializer のNamedEvaluation の ? とする。
- value を、bindingId を引数とする
- Else,
- rhs を ?
Evaluation ofInitializer とする。 - value を ?
GetValue (rhs) とする。
- rhs を ?
- ?
PutValue (lhs, value) を実行する。 empty を返す。
- rhs を ?
Evaluation ofInitializer とする。 - rVal を ?
GetValue (rhs) とする。 - rVal および
undefined を引数とするBindingPattern のBindingInitialization を ? 返す。
14.3.3 Destructuring Binding Pattern
構文
14.3.3.1 Runtime Semantics: PropertyBindingInitialization
The
- boundNames を、value および
environment を引数とする
BindingPropertyList のPropertyBindingInitialization の ? とす る。 - nextNames を、value および
environment を引数とする
BindingProperty のPropertyBindingInitialization の ? とす る。 - boundNames と nextNames の
list-concatenation を返す。
- name を
SingleNameBinding のBoundNames の唯一の要素とする。 - value, environment, および name を
引数として
SingleNameBinding のKeyedBindingInitialization を ? 実行す る。 - « name » を返す。
- propertyKey を ?
Evaluation ofPropertyName とする。 - value, environment, および
propertyKey を引数として
BindingElement のKeyedBindingInitialization を ? 実行す る。 - « propertyKey » を返す。
14.3.3.2 Runtime Semantics: RestBindingInitialization
The
- lhs を
?
ResolveBinding (StringValue ofBindingIdentifier , environment) とす る。 - restObj を
OrdinaryObjectCreate (%Object.prototype% ) とする。 - ?
CopyDataProperties (restObj, value, excludedNames) を実行する。 - environment が
undefined なら、 ?PutValue (lhs, restObj) を返す。 - ?
InitializeReferencedBinding (lhs, restObj) を返す。
14.3.3.3 Runtime Semantics: KeyedBindingInitialization
The
It is defined piecewise over the following productions:
- v を ?
GetV (value, propertyName) とする。 Initializer が存在し、かつ v がundefined なら、- defaultValue を ?
Evaluation ofInitializer とする。 - v を ?
GetValue (defaultValue) に設 定する。
- defaultValue を ?
- v および environment を引数とする
BindingPattern のBindingInitialization を ? 返す。
- bindingId を
BindingIdentifier のStringValue とする。 - lhs を ?
ResolveBinding (bindingId, environment) とする。 - v を ?
GetV (value, propertyName) とする。 Initializer が存在し、かつ v がundefined なら、IsAnonymousFunctionDefinition (Initializer ) がtrue なら、- v を、bindingId を引数とする
Initializer のNamedEvaluation の ? に設定する。
- v を、bindingId を引数とする
- Else,
- defaultValue を ?
Evaluation ofInitializer とする。 - v を ?
GetValue (defaultValue) に設定する。
- defaultValue を ?
- environment が
undefined なら、 ?PutValue (lhs, v) を返す。 - ?
InitializeReferencedBinding (lhs, v) を返す。
14.4 Empty Statement
構文
14.4.1 Runtime Semantics: Evaluation
empty を返す。
14.5 Expression Statement
構文
function または
class async function で始
まってはならない。なぜなら、それにより
let [ で始まってはならない。なぜなら、それにより最
初の let
14.5.1 Runtime Semantics: Evaluation
- exprRef を ?
Evaluation ofExpression とする。 - ?
GetValue (exprRef) を返す。
14.6 if Statement
構文
else] という
lookahead-restriction は、古典的な “dangling
else” 問題を通常の方法で解決する。すなわち、関連付け
られる if の選択が他の点では曖昧である場合、else
は候補となる if のうち最も近い（最も内側の）ものに
関連付けられる。14.6.1 Static Semantics: Early Errors
-
最初の
Statement に対するIsLabelledFunction がtrue なら、それ は Syntax Error である。 -
2 番目の
Statement に対するIsLabelledFunction がtrue なら、それ は Syntax Error である。
-
Statement に対するIsLabelledFunction がtrue なら、それは Syntax Error であ る。
この規則は、
14.6.2 Runtime Semantics: Evaluation
- exprRef を ?
Evaluation ofExpression とする。 - exprValue を
ToBoolean (?GetValue (exprRef)) とする。 - exprValue が
true なら、- stmtCompletion を、最初の
Statement のEvaluation のCompletion とする。
- stmtCompletion を、最初の
- Else,
- stmtCompletion を、2 番目の
Statement のEvaluation のCompletion とする。
- stmtCompletion を、2 番目の
- ?
UpdateEmpty (stmtCompletion,undefined ) を返す。
- exprRef を ?
Evaluation ofExpression とする。 - exprValue を
ToBoolean (?GetValue (exprRef)) とする。 - exprValue が
false なら、undefined を返す。 - stmtCompletion を、
Statement のEvaluation のCompletion とする。 - ?
UpdateEmpty (stmtCompletion,undefined ) を返す。
14.7 Iteration Statement
構文
14.7.1 意味論
14.7.1.1 LoopContinues ( completion, labelSet )
The
- 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 のForInOfLoopEvaluation を ? 返す。
14.7.2 do-while Statement
構文
14.7.2.1 Static Semantics: Early Errors
-
IsLabelledFunction (Statement ) がtrue なら、それは Syntax Error である。
この規則は、
14.7.2.2 Runtime Semantics: DoWhileLoopEvaluation
The
- iterationResult を
undefined とす る。 - 繰り返す
- stmtResult を
Completion (Evaluation ofStatement ) とする。 LoopContinues (stmtResult, labelSet) がfalse なら、 ?UpdateEmpty (stmtResult, iterationResult) を返す。- stmtResult.[[Value]] が
empty で ないなら、iterationResult を stmtResult.[[Value]] に設定する。 - exprRef を ?
Evaluation ofExpression とする。 - exprValue を ?
GetValue (exprRef) とする。 ToBoolean (exprValue) がfalse なら、iterationResult を返す。
- stmtResult を
14.7.3 while Statement
構文
14.7.3.1 Static Semantics: Early Errors
-
IsLabelledFunction (Statement ) がtrue なら、それは Syntax Error である。
この規則は、
14.7.3.2 Runtime Semantics: WhileLoopEvaluation
The
- iterationResult を
undefined とす る。 - 繰り返す
- exprRef を ?
Evaluation ofExpression とする。 - exprValue を ?
GetValue (exprRef) とする。 ToBoolean (exprValue) がfalse なら、iterationResult を返す。- stmtResult を
Completion (Evaluation ofStatement ) とする。 LoopContinues (stmtResult, labelSet) がfalse なら、 ?UpdateEmpty (stmtResult, iterationResult) を返す。- stmtResult.[[Value]] が
empty で ないなら、iterationResult を stmtResult.[[Value]] に設定する。
- exprRef を ?
14.7.4 for Statement
構文
14.7.4.1 Static Semantics: Early Errors
-
IsLabelledFunction (Statement ) がtrue なら、それは Syntax Error である。
この規則は、
-
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 とする。 - test, increment,
Statement , « », および labelSet を引数とするForBodyEvaluation を ? 返す。
- ?
Evaluation ofVariableDeclarationList を 実行する。 - 最初の
Expression が存在するなら、 test を最初のExpression とする; そ うでなければ test をempty とす る。 - 2 番目の
Expression が存在するなら、 increment を 2 番目のExpression と する; そうでなければ increment をempty とする。 - test, increment,
Statement , « », および labelSet を引数とするForBodyEvaluation を ? 返す。
- oldEnv を、
running execution context の LexicalEnvironment とす る。 - loopEnv を
NewDeclarativeEnvironment (oldEnv) と する。 - isConst を
LexicalDeclaration のIsConstantDeclaration とする。 - boundNames を
LexicalDeclaration のBoundNames とする。 - boundNames の各要素 dn について、
次を行う
- isConst が
true なら、- ! loopEnv.
CreateImmutableBinding ( dn,true ) を実行する。
- ! loopEnv.
- Else,
- ! loopEnv.
CreateMutableBinding (dn,false ) を実行する。
- ! loopEnv.
- isConst が
running execution context の LexicalEnvironment を loopEnv に設定 する。- forDcl を
Completion (Evaluation ofLexicalDeclaration ) とする。 - forDcl が
abrupt completion な ら、running execution context の LexicalEnvironment を oldEnv に設 定する。- ? forDcl を返す。
- isConst が
false なら、 perIterationLets を boundNames と する; そうでなければ perIterationLets を新しい空のList とする。 - 最初の
Expression が存在するなら、 test を最初のExpression とする; そ うでなければ test をempty とす る。 - 2 番目の
Expression が存在するなら、 increment を 2 番目のExpression と する; そうでなければ increment をempty とする。 - bodyResult を、test, increment,
Statement , perIterationLets, およ び labelSet を引数とするForBodyEvaluation のCompletion とす る。 running execution context の LexicalEnvironment を oldEnv に設定 する。- ? bodyResult を返す。
14.7.4.3 ForBodyEvaluation ( test, increment, stmt, perIterationBindings, labelSet )
The
- iterationResult を
undefined とす る。 - ?
CreatePerIterationEnvironment ( perIterationBindings) を実行する。 - 繰り返す
- test が
empty でないなら、- testRef を ?
Evaluation of test とする。 - testValue を ?
GetValue (testRef) とする。 ToBoolean (testValue) がfalse なら、iterationResult を返す。
- testRef を ?
- result を
Completion (Evaluation of stmt) とする。 LoopContinues (result, labelSet) がfalse なら、 ?UpdateEmpty (result, iterationResult) を返す。- result.[[Value]] が
empty でない なら、iterationResult を result.[[Value]] に設定する。 - ?
CreatePerIterationEnvironment ( perIterationBindings) を実行する。 - increment が
empty でないなら、- incRef を ?
Evaluation of increment とする。 - ?
GetValue (incRef) を実行する。
- incRef を ?
- test が
14.7.4.4 CreatePerIterationEnvironment ( perIterationBindings )
The
- perIterationBindings が何らかの要素を持つ
なら、
- lastIterationEnv を、
running execution context の LexicalEnvironment とする。 - outer を lastIterationEnv.[[OuterEnv]] とす る。
Assert : outer はnull ではな い。- thisIterationEnv を
NewDeclarativeEnvironment (outer) とする。 - perIterationBindings の各要素 bn
について、次を行う
- ! thisIterationEnv.
CreateMutableBinding ( bn,false ) を実行する。 - lastValue を
? lastIterationEnv.
GetBindingValue ( bn,true ) とする。 - ! thisIterationEnv.
InitializeBinding ( bn, lastValue) を実行する。
- ! thisIterationEnv.
running execution context の LexicalEnvironment を thisIterationEnv に設定する。
- lastIterationEnv を、
unused を返す。
14.7.5 for-in, for-of, および for-await-of Statement
構文
この節は、Annex
14.7.5.1 Static Semantics: Early Errors
-
IsLabelledFunction (Statement ) がtrue なら、それは Syntax Error である。
この規則は、
-
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 が重複する 項目を含む場合、それは Syntax Error であ る。
14.7.5.2 Static Semantics: IsDestructuring
The
PrimaryExpression がObjectLiteral またはArrayLiteral のいずれかなら、true を返す。false を返す。
false を返す。
ForBinding のIsDestructuring を返す。
false を返す。
true を返す。
この節は、Annex
14.7.5.3 Runtime Semantics: ForDeclarationBindingInitialization
The
- value および environment を引数とす
る
ForBinding のBindingInitialization を ? 返す。
14.7.5.4 Runtime Semantics: ForDeclarationBindingInstantiation
The
ForBinding のBoundNames の各要素 name について、次を行うLetOrConst のIsConstantDeclaration がtrue なら、- ! environment.
CreateImmutableBinding ( name,true ) を実行する。
- ! environment.
- Else,
- ! environment.
CreateMutableBinding ( name,false ) を実行する。
- ! environment.
unused を返す。
14.7.5.5 Runtime Semantics: ForInOfLoopEvaluation
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 (BoundNames ofForDeclaration ,Expression ,enumerate ) とする。 - ?
ForIn/OfBodyEvaluation (ForDeclaration ,Statement , keyResult,enumerate ,lexical-binding , labelSet) を返す。
- keyResult を
?
ForIn/OfHeadEvaluation (« »,AssignmentExpression ,iterate ) とす る。 - ?
ForIn/OfBodyEvaluation (LeftHandSideExpression ,Statement , keyResult,iterate ,assignment , labelSet) を返す。
- keyResult を
?
ForIn/OfHeadEvaluation (« »,AssignmentExpression ,iterate ) とす る。 - ?
ForIn/OfBodyEvaluation (ForBinding ,Statement , keyResult,iterate ,var-binding , labelSet) を返す。
- keyResult を
?
ForIn/OfHeadEvaluation (BoundNames ofForDeclaration ,AssignmentExpression ,iterate ) とする。 - ?
ForIn/OfBodyEvaluation (ForDeclaration ,Statement , keyResult,iterate ,lexical-binding , labelSet) を返す。
- keyResult を
?
ForIn/OfHeadEvaluation (« »,AssignmentExpression ,async-iterate ) とする。 - ?
ForIn/OfBodyEvaluation (LeftHandSideExpression ,Statement , keyResult,iterate ,assignment , labelSet,async ) を返す。
- keyResult を
?
ForIn/OfHeadEvaluation (« »,AssignmentExpression ,async-iterate ) とする。 - ?
ForIn/OfBodyEvaluation (ForBinding ,Statement , keyResult,iterate ,var-binding , labelSet,async ) を返す。
- keyResult を
?
ForIn/OfHeadEvaluation (BoundNames ofForDeclaration ,AssignmentExpression ,async-iterate ) とする。 - ?
ForIn/OfBodyEvaluation (ForDeclaration ,Statement , keyResult,iterate ,lexical-binding , labelSet,async ) を返す。
この節は、Annex
14.7.5.6 ForIn/OfHeadEvaluation ( uninitializedBoundNames, expr, iterationKind )
The
- oldEnv を、
running execution context の LexicalEnvironment とす る。 - uninitializedBoundNames が空でないな
ら、
Assert : uninitializedBoundNames は重複する項目を持たない。- newEnv を
NewDeclarativeEnvironment (oldEnv) とする。 - uninitializedBoundNames の各
String name について、次を行う
- ! newEnv.
CreateMutableBinding (name,false ) を実行する。
- ! newEnv.
running execution context の LexicalEnvironment を newEnv に設 定する。
- exprRef を
Completion (Evaluation of expr) とする。 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 とす る。 - Else, iteratorKind を
sync とす る。 - ?
GetIterator (exprValue, iteratorKind) を返す。
14.7.5.7 ForIn/OfBodyEvaluation ( lhs, stmt, iteratorRecord, iterationKind, lhsKind, labelSet [ , iteratorKind ] )
The
- iteratorKind が存在しないなら、
iteratorKind を
sync に設定する。 - oldEnv を、
running execution context の LexicalEnvironment とす る。 - iterationResult を
undefined とす る。 - destructuring を lhs の
IsDestructuring とする。 - destructuring が
true であり、 かつ lhsKind がassignment なら、Assert : lhs はLeftHandSideExpression である。- assignmentPattern を、lhs によっ
て cover される
AssignmentPattern とする。
- 繰り返す
- 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 のいずれかなら、- destructuring が
true なら、- lhsKind が
assignment なら、- 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 を
Completion (Evaluation of lhs) とする。（それは繰り返し評 価され得る。） - lhsKind が
assignment であ り、かつ lhs のAssignmentTargetType がweb-compat なら、ReferenceError 例外を送出す る。 - lhsRef が
abrupt completion なら、- status を lhsRef とする。
- Else,
- status を
Completion (PutValue (lhsRef.[[Value]], nextValue)) とする。
- status を
- lhsRef を
- destructuring が
- Else,
Assert : lhsKind はlexical-binding である。Assert : lhs はForDeclaration である。- iterationEnv を
NewDeclarativeEnvironment (oldEnv) とする。 - iterationEnv を引数として lhs の
ForDeclarationBindingInstantiation を実行する。 running execution context の LexicalEnvironment を iterationEnv に設定する。- destructuring が
true なら、- status を、nextValue および
iterationEnv を引数とする
lhs の
ForDeclarationBindingInitialization のCompletion とする。
- status を、nextValue および
iterationEnv を引数とする
lhs の
- Else,
Assert : lhs は単一の名前を束縛す る。- lhsName を lhs の
BoundNames の唯一の要素とする。 - lhsRef を !
ResolveBinding ( lhsName) とする。 - status を
Completion (InitializeReferencedBinding (lhsRef, nextValue)) とする。
- status が
abrupt completion な ら、running execution context の LexicalEnvironment を oldEnv に 設定する。- iterationKind が
enumerate なら、? status を返す。 Assert : iterationKind はiterate である。- iteratorKind が
async なら、 ?AsyncIteratorClose (iteratorRecord, status) を返す。 - ?
IteratorClose (iteratorRecord, status) を返す。
- result を
Completion (Evaluation of stmt) とする。 running execution context の LexicalEnvironment を oldEnv に設 定する。LoopContinues (result, labelSet) がfalse なら、- status を
Completion (UpdateEmpty (result, iterationResult)) に設定する。 - iterationKind が
enumerate なら、? status を返す。 Assert : iterationKind はiterate である。- iteratorKind が
async なら、 ?AsyncIteratorClose (iteratorRecord, status) を返す。 - ?
IteratorClose (iteratorRecord, status) を返す。
- status を
- result.[[Value]] が
empty でない なら、iterationResult を result.[[Value]] に設定する。
- nextResult を
?
14.7.5.8 Runtime Semantics: Evaluation
- bindingId を
BindingIdentifier のStringValue とする。 - ?
ResolveBinding (bindingId) を返す。
14.7.5.9 EnumerateObjectProperties ( obj )
The
- obj の enumerable property のすべての
String 値 key を反復する
nextmethod を持つiterator object を返 す。このiterator object は ECMAScript code から直接アクセス可能ではない。 property を列挙する仕組みおよび順序は規定さ れないが、以下で規定される規則には適合しなければな らない。
throw および return
method は next method は、next method によって処理される前に
削除された property は無視される。列挙中に target
object に新しい property が追加された場合、新たに
追加された property が進行中の列挙で処理されることは
保証されない。任意の列挙において、property 名は
next method によって高々 1 回し
か返されない。
target object の property の列挙には、その
prototype の property、その prototype の
prototype の property、というように再帰的に含ま
れる; ただし、prototype の property は、それがす
でに next method によって処理済み
の property と同じ名前を持つ場合には処理されない。
prototype object の property がすでに処理済み
かどうかを判定する際には、[[Enumerable]] 属性値は考慮
されない。prototype object の enumerable
property 名は、その prototype object を引数とし
て渡して EnumerateObjectProperties を起動するこ
とにより取得されなければならない。
EnumerateObjectProperties は、target object
の own
さらに、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]] 属性の値が変化する。
ECMAScript 実装は、
以下は、これらの規則に適合する ECMAScript generator function の参考定義である:
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 Object
For-In Iterator
とは、ある特定の object に対する特定の iteration
を表す object である。For-In Iterator object
は ECMAScript code から直接アクセス可能ではなく、
14.7.5.10.1 CreateForInIterator ( object )
The
- iterator を
OrdinaryObjectCreate (%ForInIteratorPrototype% , « [[Object]], [[ObjectWasVisited]], [[VisitedKeys]], [[RemainingKeys]] ») とする。 - iterator.[[Object]] を object に設定 する。
- iterator.[[ObjectWasVisited]] を
false に設定する。 - iterator.[[VisitedKeys]] を新しい空の
List に設定する。 - iterator.[[RemainingKeys]] を新しい空
の
List に設定する。 - iterator を返す。
14.7.5.10.2 %ForInIteratorPrototype% Object
%ForInIteratorPrototype% object は:
- すべての
For-In Iterator object に よって継承される property を持つ。 - 通常 object である。
- [[Prototype]] internal slot を持ち、
その値は
%Iterator.prototype% である。 - ECMAScript code から直接アクセス可能では ない。
- 次の property を持つ:
14.7.5.10.2.1 %ForInIteratorPrototype%.next ( )
- iter を
this 値とする。 Assert : iter は Object である。Assert : iter は、For-In Iterator instance のすべての internal slot を持つ （14.7.5.10.3 ）。- object を iter.[[Object]] とする。
- 繰り返す
- iter.[[ObjectWasVisited]] が
false なら、- keys を ? object.[[OwnPropertyKeys]]() とする。
- keys の各要素 key について、次を
行う
- key が String なら、
- key を iter.[[RemainingKeys]] に append する。
- key が String なら、
- iter.[[ObjectWasVisited]] を
true に設定する。
- iter.[[RemainingKeys]] が空でな
い間、繰り返す
- key を iter.[[RemainingKeys]] の最初 の要素とする。
- 最初の要素を iter.[[RemainingKeys]] から除 去する。
- iter.[[VisitedKeys]] が key を
含まないなら、
- desc を ? object.[[GetOwnProperty]](key) とする。
- desc が
undefined でなけれ ば、- key を iter.[[VisitedKeys]] に append する。
- desc.[[Enumerable]] が
true なら、CreateIteratorResultObject ( key,false ) を返す。
- object を ? object.[[GetPrototypeOf]]() に設定する。
- iter.[[Object]] を object に設定 する。
- iter.[[ObjectWasVisited]] を
false に設定する。 - object が
null なら、CreateIteratorResultObject (undefined ,true ) を返す。
- iter.[[ObjectWasVisited]] が
14.7.5.10.3 For-In Iterator Instance の Property
| Internal Slot | 型 | 説明 |
|---|---|---|
| [[Object]] | an Object | その property が反復されている Object 値。 |
| [[ObjectWasVisited]] | a Boolean |
|
| [[VisitedKeys]] |
a |
これまでにこの |
| [[RemainingKeys]] |
a |
prototype の property を反復する前
に（その prototype が |
14.8 continue Statement
構文
14.8.1 Static Semantics: Early Errors
-
この
ContinueStatement が、IterationStatement の内部に、直接または間 接に（ただし function またはstaticinitialization block の境界はまたがず に）入れ子になっていない場合、それは 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 break Statement
構文
14.9.1 Static Semantics: Early Errors
-
この
BreakStatement が、IterationStatement またはSwitchStatement の内部に、直接または間接 に（ただし function またはstaticinitialization block の境界はまたがず に）入れ子になっていない場合、それは 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 return Statement
構文
return statement は function の実行を
停止させ、ほとんどの場合、呼出し元へ値を返す。
return statement は、周囲の文脈によっては実際
には呼出し元へ値を返さないことがある。たとえば try
block では、return statement の finally block の評価中に別の
14.10.1 Runtime Semantics: Evaluation
ReturnCompletion (undefined ) を返す。
- exprRef を ?
Evaluation ofExpression とする。 - exprValue を ?
GetValue (exprRef) とする。 GetGeneratorKind () がasync なら、 exprValue を ?Await (exprValue) に設 定する。ReturnCompletion (exprValue) を返す。
14.11 with Statement
with statement の使用は、新し
い ECMAScript code では推奨されない。
構文
with statement は、計算された object に
対する
14.11.1 Static Semantics: Early Errors
-
IsStrict (this production) がtrue なら、それは Syntax Error である。 -
IsLabelledFunction (Statement ) がtrue なら、それは Syntax Error である。
2 番目の規則は、
14.11.2 Runtime Semantics: Evaluation
- val を ?
Evaluation ofExpression とする。 - obj を ?
ToObject (?GetValue (val)) とする。 - oldEnv を、
running execution context の LexicalEnvironment とす る。 - newEnv を
NewObjectEnvironment (obj,true , oldEnv) とする。 running execution context の LexicalEnvironment を newEnv に設定 する。- stmtCompletion を
Completion (Evaluation ofStatement ) とする。 running execution context の LexicalEnvironment を oldEnv に設定 する。- ?
UpdateEmpty (stmtCompletion,undefined ) を返す。
embedded された
14.12 switch Statement
構文
14.12.1 Static Semantics: Early Errors
-
CaseBlock のLexicallyDeclaredNames が重複する項目を含む場合、それは Syntax Error である。ただし、host が web browser であるか、またはブロックレベル Function Declaration の Web レガシー互換性意味論 をサポートしており、かつ以下の両条件が真である場合を除く:IsStrict (this production) がfalse である。- 重複する項目が FunctionDeclarations によってのみ束縛されている。
-
CaseBlock のLexicallyDeclaredNames の任意の要素がCaseBlock のVarDeclaredNames にも現れる場合、それは Syntax Error である。
14.12.2 Runtime Semantics: CaseBlockEvaluation
The
undefined を返す。
- resultValue を
undefined とする。 - caseClauses を、source text 順の
CaseClauses 内のCaseClause item のList とする。 - found を
false とする。 - caseClauses の各
CaseClause clause について、次を行う- found が
false なら、- found を
?
CaseClauseIsSelected (clause, input) に設定する。
- found を
?
- found が
true なら、- completion を
Completion (Evaluation of clause) とする。 - completion.[[Value]] が
empty でないなら、resultValue を completion.[[Value]] に設定する。 - completion が
abrupt completion なら、 ?UpdateEmpty (completion, resultValue) を返す。
- completion を
- found が
- resultValue を返す。
- resultValue を
undefined とする。 - 最初の
CaseClauses が存在するなら、- caseClauses を、source text 順の最
初の
CaseClauses 内のCaseClause item のList とする。
- caseClauses を、source text 順の最
初の
- Else,
- caseClauses を新しい空の
List とする。
- caseClauses を新しい空の
- found を
false とする。 - caseClauses の各
CaseClause clause について、次を行う- found が
false なら、- found を
?
CaseClauseIsSelected (clause, input) に設定する。
- found を
?
- found が
true なら、- completion を
Completion (Evaluation of clause) とする。 - completion.[[Value]] が
empty でないなら、resultValue を completion.[[Value]] に設定する。 - completion が
abrupt completion なら、 ?UpdateEmpty (completion, resultValue) を返す。
- completion を
- found が
- foundInB を
false とする。 - 2 番目の
CaseClauses が存在するなら、- secondCaseClauses を、source text
順の 2 番目の
CaseClauses 内のCaseClause item のList とする。
- secondCaseClauses を、source text
順の 2 番目の
- Else,
- secondCaseClauses を新しい空の
List とする。
- secondCaseClauses を新しい空の
- found が
false なら、- secondCaseClauses の各
CaseClause clause について、次を行う- foundInB が
false なら、- foundInB を
?
CaseClauseIsSelected (clause, input) に設定する。
- foundInB を
?
- foundInB が
true なら、- completion を
Completion (Evaluation ofCaseClause clause) とする。 - completion.[[Value]] が
empty でないなら、resultValue を completion.[[Value]] に設定する。 - completion が
abrupt completion なら、 ?UpdateEmpty (completion, resultValue) を返す。
- completion を
- foundInB が
- secondCaseClauses の各
- foundInB が
true なら、 resultValue を返す。 - defaultR を
Completion (Evaluation ofDefaultClause ) とする。 - defaultR.[[Value]] が
empty でない なら、resultValue を defaultR.[[Value]] に設定する。 - defaultR が
abrupt completion なら、 ?UpdateEmpty (defaultR, resultValue) を返す。 NOTE : 以下は、2 番目のCaseClauses の もう 1 回の完全な iteration である。- secondCaseClauses の各
CaseClause clause について、次を行う- completion を
Completion (Evaluation ofCaseClause clause) とする。 - completion.[[Value]] が
empty で ないなら、resultValue を completion.[[Value]] に設定する。 - completion が
abrupt completion なら、 ?UpdateEmpty (completion, resultValue) を返す。
- completion を
- resultValue を返す。
14.12.3 CaseClauseIsSelected ( constructor, input )
The
Assert : constructor は productionCaseClause : case Expression : StatementList opt - exprRef を constructor の
Expression のEvaluation の ? とす る。 - clauseSelector を ?
GetValue (exprRef) とする。 IsStrictlyEqual (input, clauseSelector) を返す。
この操作は constructor の
14.12.4 Runtime Semantics: Evaluation
- exprRef を ?
Evaluation ofExpression とする。 - switchValue を ?
GetValue (exprRef) とする。 - oldEnv を、
running execution context の LexicalEnvironment とす る。 - blockEnv を
NewDeclarativeEnvironment (oldEnv) と する。 BlockDeclarationInstantiation (CaseBlock , blockEnv) を実行する。running execution context の LexicalEnvironment を blockEnv に設定 する。- blockResult を、switchValue を引数とす
る
CaseBlock のCaseBlockEvaluation のCompletion とする。 running execution context の LexicalEnvironment を oldEnv に設定 する。- blockResult を返す。
どのように control が
empty を返す。
- ?
Evaluation ofStatementList を返す。
empty を返す。
- ?
Evaluation ofStatementList を返す。
14.13 Labelled Statement
構文
break お
よび continue statement と組み合わせてのみ使
用される。ECMAScript には goto statement はな
い。
14.13.1 Static Semantics: Early Errors
-
任意の source text がこの production に
一致する場合、それは Syntax Error である
。ただし、その
source text が
non-strict code であ り、かつhost が web browser であるか、 またはラベル付き Function Declaration をサポートしている場合を除く。
14.13.2 Static Semantics: IsLabelledFunction ( stmt )
The
- 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 ) に設 定する。 - Else, stmtResult を
NormalCompletion (stmtResult.[[Value]]) に設定する。
- stmtResult.[[Value]] が
- stmtResult.[[Target]] が
- ? stmtResult を返す。
- stmtResult を
Completion (Evaluation ofSwitchStatement ) とする。 - stmtResult が
break completion な ら、- stmtResult.[[Target]] が
empty な ら、- stmtResult.[[Value]] が
empty なら、stmtResult をNormalCompletion (undefined ) に設 定する。 - Else, 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 を返す。
- ?
Evaluation ofFunctionDeclaration を返 す。
- ?
Evaluation ofStatement を返す。
14.14 throw Statement
構文
14.14.1 Runtime Semantics: Evaluation
- exprRef を ?
Evaluation ofExpression とする。 - exprValue を ?
GetValue (exprRef) とする。 - exprValue を throw する。
14.15 try Statement
構文
try statement は、runtime error や
throw statement のような例外的条件が発生し得る
code block を囲む。catch clause は例外処理
code を提供する。catch clause が exception を捕
捉するとき、その
14.15.1 Static Semantics: Early Errors
-
CatchParameter のBoundNames が重複する 要素を含む場合、それは Syntax Error であ る。 -
CatchParameter のBoundNames の任意の 要素がBlock のLexicallyDeclaredNames にも現れる場合、それは Syntax Error であ る。 -
CatchParameter のBoundNames の任意の 要素がBlock のVarDeclaredNames にも 現れる場合、それは Syntax Error である 。ただしCatchParameter がCatchParameter : BindingIdentifier host が web browser である か、またはCatch ブロック内の VariableStatement をサポートしている場合を除く。
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 を
Completion (Evaluation ofBlock ) とする。 running execution context の LexicalEnvironment を oldEnv に設定 する。- ? blockCompletion を返す。
- ?
Evaluation ofBlock を返す。
どのように control が
14.15.3 Runtime Semantics: Evaluation
- blockResult を
Completion (Evaluation ofBlock ) とする。 - blockResult が
throw completion な ら、catchResult を、blockResult.[[Value]] を引数とするCatch のCatchClauseEvaluation のCompletion と する。 - Else, catchResult を blockResult とする。
- ?
UpdateEmpty (catchResult,undefined ) を返す。
- blockResult を
Completion (Evaluation ofBlock ) とする。 - finallyResult を
Completion (Evaluation ofFinally ) とする。 - finallyResult が
normal completion なら、finallyResult を blockResult に設定する。 - ?
UpdateEmpty (finallyResult,undefined ) を返す。
- blockResult を
Completion (Evaluation ofBlock ) とする。 - blockResult が
throw completion な ら、catchResult を、blockResult.[[Value]] を引数とするCatch のCatchClauseEvaluation のCompletion と する。 - Else, catchResult を blockResult とする。
- finallyResult を
Completion (Evaluation ofFinally ) とする。 - finallyResult が
normal completion なら、finallyResult を catchResult に設定する。 - ?
UpdateEmpty (finallyResult,undefined ) を返す。
14.16 debugger Statement
構文
14.16.1 Runtime Semantics: Evaluation
implementation-defined な debugging facility が利用可能かつ有効なら、implementation-defined な debugging action を実行する。- 新しい
implementation-defined なCompletion Record を返す。
empty を返す。
15 ECMAScript 言語: 関数とクラス
15.1 パラメータリスト
構文
15.1.1 Static Semantics: 早期エラー
-
FormalParameters のBoundNames に重複する要素が含まれている場合、構文エラーである。
-
FormalParameterList のIsSimpleParameterList がfalse であり、かつFormalParameterList のBoundNames に重複する要素が含まれている場合、構文エラーである。
15.1.2 Static Semantics: ContainsExpression
The
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 を返す。
BindingElement のContainsExpression を返す。
- has を
PropertyName のIsComputedPropertyKey とする。 - has が
true の場合、true を返す。 BindingElement のContainsExpression を返す。
true を返す。
false を返す。
true を返す。
false を返す。
BindingPattern のContainsExpression を返す。
false を返す。
FormalParameterList のContainsExpression がtrue の場合、true を返す。FunctionRestParameter のContainsExpression を返す。
FormalParameterList のContainsExpression がtrue の場合、true を返す。FormalParameter のContainsExpression を返す。
false を返す。
- formals を
CoverParenthesizedExpressionAndArrowParameterList によってカバーされるArrowFormalParameters とする。 - formals の
ContainsExpression を返す。
false を返す。
15.1.3 Static Semantics: IsSimpleParameterList
The
false を返す。
false を返す。
true を返す。
false を返す。
true を返す。
false を返す。
false を返す。
FormalParameterList のIsSimpleParameterList がfalse の場合、false を返す。FormalParameter のIsSimpleParameterList を返す。
true を返す。
- formals を
CoverParenthesizedExpressionAndArrowParameterList によってカバーされるArrowFormalParameters とする。 - formals の
IsSimpleParameterList を返す。
true を返す。
- head を
CoverCallExpressionAndAsyncArrowHead によってカバーされるAsyncArrowHead とする。 - head の
IsSimpleParameterList を返す。
15.1.4 Static Semantics: HasInitializer
The
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 によってカバーされるArrowFormalParameters とする。 - formals の
ExpectedArgumentCount を返す。
FormalParameter のHasInitializer がtrue の場合、0 を返す。- 1 を返す。
- 1 を返す。
15.2 関数定義
構文
15.2.1 Static Semantics: 早期エラー
-
IsStrict (FormalParameters ) がtrue である場合、UniqueFormalParameters : FormalParameters -
BindingIdentifier が存在し、IsStrict (BindingIdentifier ) がtrue である場合、BindingIdentifier のStringValue が"eval" または"arguments" のいずれかであれば、それは 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 に重複するエントリが含まれている場合、それは Syntax Error である。 -
FunctionStatementList のLexicallyDeclaredNames のいずれかの要素が、FunctionStatementList のVarDeclaredNames にも現れる場合、それは Syntax Error である。 -
引数 « » を伴う
FunctionStatementList のContainsDuplicateLabels がtrue である場合、それは Syntax Error である。 -
引数 « » を伴う
FunctionStatementList のContainsUndefinedBreakTarget がtrue である場合、それは Syntax Error である。 -
引数 « » および « » を伴う
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 (functionObject, argumentsList) を実行する。 FunctionStatementList のEvaluation を ? 実行する。NOTE : 前のステップがnormal completion となった場合、評価はFunctionStatementList の末尾を越えて進むことで終了した。ReturnCompletion (undefined ) を返す。
15.2.4 Runtime Semantics: InstantiateOrdinaryFunctionObject
The
- name を
BindingIdentifier のStringValue とする。 - sourceText を
FunctionDeclaration に一致したソーステキストとする。 - closure を
OrdinaryFunctionCreate (%Function.prototype% , sourceText,FormalParameters ,FunctionBody ,non-lexical-this , env, privateEnv) とする。 SetFunctionName (closure, name) を実行する。MakeConstructor (closure) を実行する。- closure を返す。
- sourceText を
FunctionDeclaration に一致したソーステキストとする。 - closure を
OrdinaryFunctionCreate (%Function.prototype% , sourceText,FormalParameters ,FunctionBody ,non-lexical-this , env, privateEnv) とする。 SetFunctionName (closure,"default" ) を実行する。MakeConstructor (closure) を実行する。- closure を返す。
無名の export default 宣言の一部としてのみ現れることができ、その
15.2.5 Runtime Semantics: InstantiateOrdinaryFunctionExpression
The
- name が存在しない場合、name を空の String に設定する。
- env を実行中の実行コンテキストの LexicalEnvironment とする。
- privateEnv を実行中の実行コンテキストの PrivateEnvironment とする。
- sourceText を
FunctionExpression に一致したソーステキストとする。 - closure を
OrdinaryFunctionCreate (%Function.prototype% , sourceText,FormalParameters ,FunctionBody ,non-lexical-this , env, privateEnv) とする。 SetFunctionName (closure, name) を実行する。MakeConstructor (closure) を実行する。- closure を返す。
Assert : name は存在しない。- name を
BindingIdentifier のStringValue に設定する。 - outerEnv を実行中の実行コンテキストの LexicalEnvironment とする。
- funcEnv を
NewDeclarativeEnvironment (outerEnv) とする。 - ! funcEnv.
CreateImmutableBinding (name,false ) を実行する。 - privateEnv を実行中の実行コンテキストの PrivateEnvironment とする。
- sourceText を
FunctionExpression に一致したソーステキストとする。 - closure を
OrdinaryFunctionCreate (%Function.prototype% , sourceText,FormalParameters ,FunctionBody ,non-lexical-this , funcEnv, privateEnv) とする。 SetFunctionName (closure, name) を実行する。MakeConstructor (closure) を実行する。- ! funcEnv.
InitializeBinding (name, closure) を実行する。 - closure を返す。
15.2.6 Runtime Semantics: Evaluation
empty を返す。
代替意味論は、
empty を返す。
undefined を返す。
15.3 アロー関数定義
構文
補足構文
生成規則
のインスタンスを処理するとき、
15.3.1 Static Semantics: 早期エラー
-
ArrowParameters Contains YieldExpression がtrue である場合、これは構文エラーである。 -
ArrowParameters Contains AwaitExpression がtrue である場合、これは構文エラーである。 -
ConciseBody のConciseBodyContainsUseStrict がtrue であり、かつArrowParameters のIsSimpleParameterList がfalse である場合、これは構文エラーである。 -
ArrowParameters のBoundNames の任意の要素がConciseBody のLexicallyDeclaredNames にも現れる場合、これは構文エラーである。
-
CoverParenthesizedExpressionAndArrowParameterList はArrowFormalParameters をカバーしていなければならない。
15.3.2 Static Semantics: ConciseBodyContainsUseStrict
The
false を返す。
15.3.3 Runtime Semantics: EvaluateConciseBody
The
- ?
FunctionDeclarationInstantiation (functionObject, argumentsList) を実行する。 ExpressionBody の ?Evaluation を返す。
15.3.4 Runtime Semantics: InstantiateArrowFunctionExpression
The
- name が存在しない場合、name を空の String に設定する。
- env を実行中の実行コンテキストの LexicalEnvironment とする。
- privateEnv を実行中の実行コンテキストの PrivateEnvironment とする。
- sourceText を
ArrowFunction に一致したソーステキストとする。 - closure を
OrdinaryFunctionCreate (%Function.prototype% , sourceText,ArrowParameters ,ConciseBody ,lexical-this , env, privateEnv) とする。 SetFunctionName (closure, name) を実行する。- closure を返す。
arguments、super、this、または new.target の局所束縛を定義しない。arguments、super、this、または new.target への任意の参照は、レキシカルに包含する環境内の束縛に解決されなければならない。通常、これは直近で包含する関数の Function Environment である。super への参照を含む場合があっても、ステップ super を参照する super を実装するために必要な状態は、
15.3.5 Runtime Semantics: Evaluation
- exprRef を
AssignmentExpression の ?Evaluation とする。 - exprValue を ?
GetValue (exprRef) とする。 ReturnCompletion (exprValue) を返す。
15.4 メソッド定義
構文
15.4.1 Static Semantics: 早期エラー
-
FunctionBody のFunctionBodyContainsUseStrict がtrue であり、かつUniqueFormalParameters のIsSimpleParameterList がfalse である場合、これは構文エラーである。 -
UniqueFormalParameters のBoundNames の任意の要素がFunctionBody のLexicallyDeclaredNames にも現れる場合、これは構文エラーである。
-
PropertySetParameterList のBoundNames が重複要素を含む場合、これは構文エラーである。 -
FunctionBody のFunctionBodyContainsUseStrict がtrue であり、かつPropertySetParameterList のIsSimpleParameterList がfalse である場合、これは構文エラーである。 -
PropertySetParameterList のBoundNames の任意の要素がFunctionBody のLexicallyDeclaredNames にも現れる場合、これは構文エラーである。
15.4.2 Static Semantics: HasDirectSuper
The
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 とする。 - env を実行中の実行コンテキストの LexicalEnvironment とする。
- privateEnv を実行中の実行コンテキストの PrivateEnvironment とする。
- functionPrototype が存在する場合、
- prototype を functionPrototype とする。
- そうでなければ、
- prototype を
%Function.prototype% とする。
- prototype を
- sourceText を
MethodDefinition に一致したソーステキストとする。 - closure を
OrdinaryFunctionCreate (prototype, sourceText,UniqueFormalParameters ,FunctionBody ,non-lexical-this , env, privateEnv) とする。 MakeMethod (closure, object) を実行する。Record { [[Key]]: propertyKey, [[Closure]]: closure } を返す。
15.4.5 Runtime Semantics: MethodDefinitionEvaluation
The
- methodDef を、引数 object で
MethodDefinition の ?DefineMethod とする。 SetFunctionName (methodDef.[[Closure]], methodDef.[[Key]]) を実行する。- ?
DefineMethodProperty (object, methodDef.[[Key]], methodDef.[[Closure]], enumerable) を返す。
- propertyKey を
ClassElementName の ?Evaluation とする。 - env を実行中の実行コンテキストの LexicalEnvironment とする。
- privateEnv を実行中の実行コンテキストの PrivateEnvironment とする。
- sourceText を
MethodDefinition に一致したソーステキストとする。 - formalParameterList を生成規則
FormalParameters : [empty] - closure を
OrdinaryFunctionCreate (%Function.prototype% , sourceText, formalParameterList,FunctionBody ,non-lexical-this , env, privateEnv) とする。 MakeMethod (closure, object) を実行する。SetFunctionName (closure, propertyKey,"get" ) を実行する。- propertyKey が
Private Name である場合、PrivateElement { [[Key]]: propertyKey, [[Kind]]:accessor , [[Get]]: closure, [[Set]]:undefined } を返す。
- desc を PropertyDescriptor { [[Get]]: closure, [[Enumerable]]: enumerable, [[Configurable]]:
true } とする。 - ?
DefinePropertyOrThrow (object, propertyKey, desc) を実行する。 unused を返す。
- propertyKey を
ClassElementName の ?Evaluation とする。 - env を実行中の実行コンテキストの LexicalEnvironment とする。
- privateEnv を実行中の実行コンテキストの PrivateEnvironment とする。
- sourceText を
MethodDefinition に一致したソーステキストとする。 - closure を
OrdinaryFunctionCreate (%Function.prototype% , sourceText,PropertySetParameterList ,FunctionBody ,non-lexical-this , env, privateEnv) とする。 MakeMethod (closure, object) を実行する。SetFunctionName (closure, propertyKey,"set" ) を実行する。- propertyKey が
Private Name である場合、PrivateElement { [[Key]]: propertyKey, [[Kind]]:accessor , [[Get]]:undefined , [[Set]]: closure } を返す。
- desc を PropertyDescriptor { [[Set]]: closure, [[Enumerable]]: enumerable, [[Configurable]]:
true } とする。 - ?
DefinePropertyOrThrow (object, propertyKey, desc) を実行する。 unused を返す。
- propertyKey を
ClassElementName の ?Evaluation とする。 - env を実行中の実行コンテキストの LexicalEnvironment とする。
- privateEnv を実行中の実行コンテキストの PrivateEnvironment とする。
- sourceText を
GeneratorMethod に一致したソーステキストとする。 - closure を
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,UniqueFormalParameters ,GeneratorBody ,non-lexical-this , env, privateEnv) とする。 MakeMethod (closure, object) を実行する。SetFunctionName (closure, propertyKey) を実行する。- prototype を
OrdinaryObjectCreate (%GeneratorPrototype% ) とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - ?
DefineMethodProperty (object, propertyKey, closure, enumerable) を返す。
- propertyKey を
ClassElementName の ?Evaluation とする。 - env を実行中の実行コンテキストの LexicalEnvironment とする。
- privateEnv を実行中の実行コンテキストの PrivateEnvironment とする。
- sourceText を
AsyncGeneratorMethod に一致したソーステキストとする。 - closure を
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,UniqueFormalParameters ,AsyncGeneratorBody ,non-lexical-this , env, privateEnv) とする。 MakeMethod (closure, object) を実行する。SetFunctionName (closure, propertyKey) を実行する。- prototype を
OrdinaryObjectCreate (%AsyncGeneratorPrototype% ) とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - ?
DefineMethodProperty (object, propertyKey, closure, enumerable) を返す。
- propertyKey を
ClassElementName の ?Evaluation とする。 - env を実行中の実行コンテキストの LexicalEnvironment とする。
- privateEnv を実行中の実行コンテキストの PrivateEnvironment とする。
- sourceText を
AsyncMethod に一致したソーステキストとする。 - closure を
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,UniqueFormalParameters ,AsyncFunctionBody ,non-lexical-this , env, privateEnv) とする。 MakeMethod (closure, object) を実行する。SetFunctionName (closure, propertyKey) を実行する。- ?
DefineMethodProperty (object, propertyKey, closure, enumerable) を返す。
15.5 ジェネレータ関数定義
構文
yield の直後の構文コンテキストでは、
Generators に関係する抽象操作は
15.5.1 Static Semantics: 早期エラー
-
GeneratorMethod のHasDirectSuper がtrue である場合、これは構文エラーである。 -
UniqueFormalParameters Contains YieldExpression がtrue である場合、これは構文エラーである。 -
GeneratorBody のFunctionBodyContainsUseStrict がtrue であり、かつUniqueFormalParameters のIsSimpleParameterList がfalse である場合、これは構文エラーである。 -
UniqueFormalParameters のBoundNames の任意の要素がGeneratorBody のLexicallyDeclaredNames にも現れる場合、これは構文エラーである。
-
IsStrict (FormalParameters ) がtrue である場合、UniqueFormalParameters : FormalParameters -
BindingIdentifier が存在し、かつIsStrict (BindingIdentifier ) がtrue である場合、BindingIdentifier のStringValue が"eval" または"arguments" のいずれかであれば、これは構文エラーである。 -
GeneratorBody のFunctionBodyContainsUseStrict がtrue であり、かつFormalParameters のIsSimpleParameterList がfalse である場合、これは構文エラーである。 -
FormalParameters のBoundNames の任意の要素がGeneratorBody のLexicallyDeclaredNames にも現れる場合、これは構文エラーである。 -
FormalParameters Contains YieldExpression がtrue である場合、これは構文エラーである。 -
FormalParameters Contains SuperProperty がtrue である場合、これは構文エラーである。 -
GeneratorBody Contains SuperProperty がtrue である場合、これは構文エラーである。 -
FormalParameters Contains SuperCall がtrue である場合、これは構文エラーである。 -
GeneratorBody Contains SuperCall がtrue である場合、これは構文エラーである。
15.5.2 Runtime Semantics: EvaluateGeneratorBody
The
- ?
FunctionDeclarationInstantiation (functionObject, argumentsList) を実行する。 - generator を ?
OrdinaryCreateFromConstructor (functionObject,"%GeneratorPrototype%" , « [[GeneratorState]], [[GeneratorContext]], [[GeneratorBrand]] ») とする。 - generator.[[GeneratorBrand]] を
empty に設定する。 - generator.[[GeneratorState]] を
suspended-start に設定する。 GeneratorStart (generator,FunctionBody ) を実行する。ReturnCompletion (generator) を返す。
15.5.3 Runtime Semantics: InstantiateGeneratorFunctionObject
The
- name を
BindingIdentifier のStringValue とする。 - sourceText を
GeneratorDeclaration に一致したソーステキストとする。 - closure を
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,FormalParameters ,GeneratorBody ,non-lexical-this , env, privateEnv) とする。 SetFunctionName (closure, name) を実行する。- prototype を
OrdinaryObjectCreate (%GeneratorPrototype% ) とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - closure を返す。
- sourceText を
GeneratorDeclaration に一致したソーステキストとする。 - closure を
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,FormalParameters ,GeneratorBody ,non-lexical-this , env, privateEnv) とする。 SetFunctionName (closure,"default" ) を実行する。- prototype を
OrdinaryObjectCreate (%GeneratorPrototype% ) とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - closure を返す。
匿名 export default 宣言の一部としてのみ現れることができ、その
15.5.4 Runtime Semantics: InstantiateGeneratorFunctionExpression
The
- name が存在しない場合、name を空の String に設定する。
- env を実行中の実行コンテキストの LexicalEnvironment とする。
- privateEnv を実行中の実行コンテキストの PrivateEnvironment とする。
- sourceText を
GeneratorExpression に一致したソーステキストとする。 - closure を
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,FormalParameters ,GeneratorBody ,non-lexical-this , env, privateEnv) とする。 SetFunctionName (closure, name) を実行する。- prototype を
OrdinaryObjectCreate (%GeneratorPrototype% ) とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - closure を返す。
Assert : name は存在しない。- name を
BindingIdentifier のStringValue に設定する。 - outerEnv を実行中の実行コンテキストの LexicalEnvironment とする。
- funcEnv を
NewDeclarativeEnvironment (outerEnv) とする。 - ! funcEnv.
CreateImmutableBinding (name,false ) を実行する。 - privateEnv を実行中の実行コンテキストの PrivateEnvironment とする。
- sourceText を
GeneratorExpression に一致したソーステキストとする。 - closure を
OrdinaryFunctionCreate (%GeneratorFunction.prototype% , sourceText,FormalParameters ,GeneratorBody ,non-lexical-this , funcEnv, privateEnv) とする。 SetFunctionName (closure, name) を実行する。- prototype を
OrdinaryObjectCreate (%GeneratorPrototype% ) とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - ! funcEnv.
InitializeBinding (name, closure) を実行する。 - closure を返す。
15.5.5 Runtime Semantics: Evaluation
- ?
Yield (undefined ) を返す。
- exprRef を
AssignmentExpression の ?Evaluation とする。 - value を ?
GetValue (exprRef) とする。 - ?
Yield (value) を返す。
- generatorKind を
GetGeneratorKind () とする。 Assert : generatorKind はsync またはasync のいずれかである。- exprRef を
AssignmentExpression の ?Evaluation とする。 - value を ?
GetValue (exprRef) とする。 - iteratorRecord を ?
GetIterator (value, generatorKind) とする。 - iterator を iteratorRecord.[[Iterator]] とする。
- received を
NormalCompletion (undefined ) とする。 - 繰り返し、
- received が
normal completion である場合、- innerResult を ?
Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]], « received.[[Value]] ») とする。 - generatorKind が
async である場合、innerResult を ?Await (innerResult) に設定する。 - innerResult が Object でない場合、
TypeError 例外を投げる。 - done を ?
IteratorComplete (innerResult) とする。 - done が
true である場合、- ?
IteratorValue (innerResult) を返す。
- ?
- generatorKind が
async である場合、received をCompletion (AsyncGeneratorYield (?IteratorValue (innerResult))) に設定する。 - そうでなければ、received を
Completion (GeneratorYield (innerResult)) に設定する。
- innerResult を ?
- そうでなく、received が
throw completion である場合、- throw を ?
GetMethod (iterator,"throw" ) とする。 - throw が
undefined でない場合、- innerResult を ?
Call (throw, iterator, « received.[[Value]] ») とする。 - generatorKind が
async である場合、innerResult を ?Await (innerResult) に設定する。 NOTE : 内側イテレータのthrowメソッドからの例外は伝播される。内側のthrowメソッドからのnormal completion は、内側のnextと同様に処理される。- innerResult が Object でない場合、
TypeError 例外を投げる。 - done を ?
IteratorComplete (innerResult) とする。 - done が
true である場合、- ?
IteratorValue (innerResult) を返す。
- ?
- generatorKind が
async である場合、received をCompletion (AsyncGeneratorYield (?IteratorValue (innerResult))) に設定する。 - そうでなければ、received を
Completion (GeneratorYield (innerResult)) に設定する。
- innerResult を ?
- そうでなければ、
NOTE : iterator がthrowメソッドを持たない場合、この throw はyield*ループを終了させる。しかし、その前に iterator にクリーンアップの機会を与える必要がある。- closeCompletion を
NormalCompletion (empty ) とする。 - generatorKind が
async である場合、?AsyncIteratorClose (iteratorRecord, closeCompletion) を実行する。 - そうでなければ、?
IteratorClose (iteratorRecord, closeCompletion) を実行する。 NOTE : 次のステップは、iterator がthrowメソッドを持たないというyield*プロトコル違反を示すためにTypeError を投げる。TypeError 例外を投げる。
- throw を ?
- そうでなければ、
Assert : received はreturn completion である。- return を ?
GetMethod (iterator,"return" ) とする。 - return が
undefined である場合、- receivedValue を received.[[Value]] とする。
- generatorKind が
async である場合、- receivedValue を ?
Await (receivedValue) に設定する。
- receivedValue を ?
ReturnCompletion (receivedValue) を返す。
- innerReturnResult を ?
Call (return, iterator, « received.[[Value]] ») とする。 - generatorKind が
async である場合、innerReturnResult を ?Await (innerReturnResult) に設定する。 - innerReturnResult が Object でない場合、
TypeError 例外を投げる。 - done を ?
IteratorComplete (innerReturnResult) とする。 - done が
true である場合、- returnedValue を ?
IteratorValue (innerReturnResult) とする。 ReturnCompletion (returnedValue) を返す。
- returnedValue を ?
- generatorKind が
async である場合、received をCompletion (AsyncGeneratorYield (?IteratorValue (innerReturnResult))) に設定する。 - そうでなければ、received を
Completion (GeneratorYield (innerReturnResult)) に設定する。
- received が
15.6 非同期ジェネレータ関数定義
構文
AsyncGenerators に関係する抽象操作は
15.6.1 Static Semantics: 早期エラー
AsyncGeneratorMethod のHasDirectSuper がtrue である場合、これは構文エラーである。UniqueFormalParameters Contains YieldExpression がtrue である場合、これは構文エラーである。UniqueFormalParameters Contains AwaitExpression がtrue である場合、これは構文エラーである。AsyncGeneratorBody のFunctionBodyContainsUseStrict がtrue であり、かつUniqueFormalParameters のIsSimpleParameterList がfalse である場合、これは構文エラーである。UniqueFormalParameters のBoundNames の任意の要素がAsyncGeneratorBody のLexicallyDeclaredNames にも現れる場合、これは構文エラーである。
IsStrict (FormalParameters ) がtrue である場合、UniqueFormalParameters : FormalParameters BindingIdentifier が存在し、かつIsStrict (BindingIdentifier ) がtrue である場合、BindingIdentifier のStringValue が"eval" または"arguments" のいずれかであれば、これは構文エラーである。AsyncGeneratorBody のFunctionBodyContainsUseStrict がtrue であり、かつFormalParameters のIsSimpleParameterList がfalse である場合、これは構文エラーである。FormalParameters のBoundNames の任意の要素がAsyncGeneratorBody のLexicallyDeclaredNames にも現れる場合、これは構文エラーである。FormalParameters Contains YieldExpression がtrue である場合、これは構文エラーである。FormalParameters Contains AwaitExpression がtrue である場合、これは構文エラーである。FormalParameters Contains SuperProperty がtrue である場合、これは構文エラーである。AsyncGeneratorBody Contains SuperProperty がtrue である場合、これは構文エラーである。FormalParameters Contains SuperCall がtrue である場合、これは構文エラーである。AsyncGeneratorBody Contains SuperCall がtrue である場合、これは構文エラーである。
15.6.2 Runtime Semantics: EvaluateAsyncGeneratorBody
The
- ?
FunctionDeclarationInstantiation (functionObject, argumentsList) を実行する。 - generator を ?
OrdinaryCreateFromConstructor (functionObject,"%AsyncGeneratorPrototype%" , « [[AsyncGeneratorState]], [[AsyncGeneratorContext]], [[AsyncGeneratorQueue]], [[GeneratorBrand]] ») とする。 - generator.[[GeneratorBrand]] を
empty に設定する。 - generator.[[AsyncGeneratorState]] を
suspended-start に設定する。 AsyncGeneratorStart (generator,FunctionBody ) を実行する。ReturnCompletion (generator) を返す。
15.6.3 Runtime Semantics: InstantiateAsyncGeneratorFunctionObject
The
- name を
BindingIdentifier のStringValue とする。 - sourceText を
AsyncGeneratorDeclaration に一致したソーステキストとする。 - closure を
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,FormalParameters ,AsyncGeneratorBody ,non-lexical-this , env, privateEnv) とする。 SetFunctionName (closure, name) を実行する。- prototype を
OrdinaryObjectCreate (%AsyncGeneratorPrototype% ) とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - closure を返す。
- sourceText を
AsyncGeneratorDeclaration に一致したソーステキストとする。 - closure を
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,FormalParameters ,AsyncGeneratorBody ,non-lexical-this , env, privateEnv) とする。 SetFunctionName (closure,"default" ) を実行する。- prototype を
OrdinaryObjectCreate (%AsyncGeneratorPrototype% ) とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - closure を返す。
匿名 export default 宣言の一部としてのみ現れることができる。
15.6.4 Runtime Semantics: InstantiateAsyncGeneratorFunctionExpression
The
- name が存在しない場合、name を空の String に設定する。
- env を実行中の実行コンテキストの LexicalEnvironment とする。
- privateEnv を実行中の実行コンテキストの PrivateEnvironment とする。
- sourceText を
AsyncGeneratorExpression に一致したソーステキストとする。 - closure を
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,FormalParameters ,AsyncGeneratorBody ,non-lexical-this , env, privateEnv) とする。 SetFunctionName (closure, name) を実行する。- prototype を
OrdinaryObjectCreate (%AsyncGeneratorPrototype% ) とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - closure を返す。
Assert : name は存在しない。- name を
BindingIdentifier のStringValue に設定する。 - outerEnv を実行中の実行コンテキストの LexicalEnvironment とする。
- funcEnv を
NewDeclarativeEnvironment (outerEnv) とする。 - ! funcEnv.
CreateImmutableBinding (name,false ) を実行する。 - privateEnv を実行中の実行コンテキストの PrivateEnvironment とする。
- sourceText を
AsyncGeneratorExpression に一致したソーステキストとする。 - closure を
OrdinaryFunctionCreate (%AsyncGeneratorFunction.prototype% , sourceText,FormalParameters ,AsyncGeneratorBody ,non-lexical-this , funcEnv, privateEnv) とする。 SetFunctionName (closure, name) を実行する。- prototype を
OrdinaryObjectCreate (%AsyncGeneratorPrototype% ) とする。 - !
DefinePropertyOrThrow (closure,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }) を実行する。 - ! funcEnv.
InitializeBinding (name, closure) を実行する。 - closure を返す。
15.6.5 Runtime Semantics: Evaluation
15.7 クラス定義
構文
クラス定義は常に strict mode コードである。
15.7.1 Static Semantics: 早期エラー
-
ClassHeritage が存在せず、次のアルゴリズムがtrue を返す場合、これは構文エラーである:- constructor を
ClassBody のConstructorMethod とする。 - constructor が
empty である場合、false を返す。 - constructor の
HasDirectSuper を返す。
- constructor を
-
ClassElementList のPrototypePropertyNameList が"constructor" の出現を複数含む場合、これは構文エラーである。 -
ClassElementList のPrivateBoundIdentifiers が重複エントリを含む場合、これは構文エラーである。ただし、その名前が getter と setter にそれぞれ一度ずつ使用され、それ以外のエントリでは使用されず、かつ getter と setter がどちらも static であるか、どちらも非 static である場合を除く。
-
MethodDefinition のPropName が"constructor" でなく、かつMethodDefinition のHasDirectSuper がtrue である場合、これは構文エラーである。 -
MethodDefinition のPropName が"constructor" であり、かつMethodDefinition のSpecialMethod がtrue である場合、これは構文エラーである。
-
MethodDefinition のHasDirectSuper がtrue である場合、これは構文エラーである。 -
MethodDefinition のPropName が"prototype" である場合、これは構文エラーである。
FieldDefinition のPropName が"constructor" である場合、これは構文エラーである。
-
FieldDefinition のPropName が"prototype" または"constructor" のいずれかである場合、これは構文エラーである。
Initializer が存在し、かつInitializer のContainsArguments がtrue である場合、これは構文エラーである。Initializer が存在し、かつInitializer Contains SuperCall がtrue である場合、これは構文エラーである。
PrivateIdentifier のStringValue が"#constructor" である場合、これは構文エラーである。
-
ClassStaticBlockStatementList のLexicallyDeclaredNames が重複エントリを含む場合、これは構文エラーである。 -
ClassStaticBlockStatementList のLexicallyDeclaredNames の任意の要素がClassStaticBlockStatementList のVarDeclaredNames にも現れる場合、これは構文エラーである。 -
引数 « » を伴う
ClassStaticBlockStatementList のContainsDuplicateLabels がtrue である場合、これは構文エラーである。 -
引数 « » を伴う
ClassStaticBlockStatementList のContainsUndefinedBreakTarget がtrue である場合、これは構文エラーである。 -
引数 « » および « » を伴う
ClassStaticBlockStatementList のContainsUndefinedContinueTarget がtrue である場合、これは構文エラーである。 -
ClassStaticBlockStatementList のContainsArguments がtrue である場合、これは構文エラーである。 -
ClassStaticBlockStatementList Contains SuperCall がtrue である場合、これは構文エラーである。 -
ClassStaticBlockStatementList Contains awaitがtrue である場合、これは構文エラーである。
15.7.2 Static Semantics: ClassElementKind
The
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 を返す。
早期エラールールにより、
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 に追加する。
- list を返す。
15.7.6 Static Semantics: PrototypePropertyNameList
The
- propName を
ClassElement のPropName とする。 - propName が
empty である場合、新しい空のList を返す。 ClassElement のIsStatic がtrue である場合、新しい空のList を返す。- « propName » を返す。
- list を
ClassElementList のPrototypePropertyNameList とする。 - propName を
ClassElement のPropName とする。 - propName が
empty である場合、list を返す。 ClassElement のIsStatic がtrue である場合、list を返す。- list と « propName » の
list-concatenation を返す。
15.7.7 Static Semantics: AllPrivateIdentifiersValid
The
この仕様において以下に列挙されていないすべての文法生成規則選択肢は、暗黙に AllPrivateIdentifiersValid の次のデフォルト定義を持つ:
- この
Parse Node の各子ノード child について、次を行う。- child が非終端記号のインスタンスである場合、
- 引数 names を伴う child の
AllPrivateIdentifiersValid がfalse である場合、false を返す。
- 引数 names を伴う child の
- child が非終端記号のインスタンスである場合、
true を返す。
- names が
PrivateIdentifier のStringValue を含む場合、- 引数 names を伴う
MemberExpression のAllPrivateIdentifiersValid を返す。
- 引数 names を伴う
false を返す。
- names が
PrivateIdentifier のStringValue を含む場合、- 引数 names を伴う
CallExpression のAllPrivateIdentifiersValid を返す。
- 引数 names を伴う
false を返す。
- names が
PrivateIdentifier のStringValue を含む場合、true を返す。 false を返す。
- names が
PrivateIdentifier のStringValue を含む場合、- 引数 names を伴う
OptionalChain のAllPrivateIdentifiersValid を返す。
- 引数 names を伴う
false を返す。
- newNames を names と
ClassBody のPrivateBoundIdentifiers のlist-concatenation とする。 - 引数 newNames を伴う
ClassElementList のAllPrivateIdentifiersValid を返す。
- names が
PrivateIdentifier のStringValue を含む場合、- 引数 names を伴う
ShiftExpression のAllPrivateIdentifiersValid を返す。
- 引数 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
この仕様において以下に列挙されていないすべての文法生成規則選択肢は、暗黙に ContainsArguments の次のデフォルト定義を持つ:
- この
Parse Node の各子ノード child について、次を行う。- child が非終端記号のインスタンスである場合、
- child の
ContainsArguments がtrue である場合、true を返す。
- child の
- child が非終端記号のインスタンスである場合、
false を返す。
Identifier のStringValue が"arguments" である場合、true を返す。false を返す。
false を返す。
15.7.10 Runtime Semantics: ClassFieldDefinitionEvaluation
The
- name を
ClassElementName の ?Evaluation とする。 Initializer が存在する場合、- formalParameterList を生成規則
FormalParameters : [empty] - env を実行中の実行コンテキストの LexicalEnvironment とする。
- privateEnv を実行中の実行コンテキストの PrivateEnvironment とする。
- sourceText を Unicode 符号位置の空の列とする。
- initializer を
OrdinaryFunctionCreate (%Function.prototype% , sourceText, formalParameterList,Initializer ,non-lexical-this , env, privateEnv) とする。 MakeMethod (initializer, homeObject) を実行する。- initializer.[[ClassFieldInitializerName]] を name に設定する。
- formalParameterList を生成規則
- そうでなければ、
- initializer を
empty とする。
- initializer を
ClassFieldDefinition Record { [[Name]]: name, [[Initializer]]: initializer } を返す。
15.7.11 Runtime Semantics: ClassStaticBlockDefinitionEvaluation
The
- lex を実行中の実行コンテキストの LexicalEnvironment とする。
- privateEnv を実行中の実行コンテキストの PrivateEnvironment とする。
- sourceText を Unicode 符号位置の空の列とする。
- formalParameters を生成規則
FormalParameters : [empty] - bodyFunction を
OrdinaryFunctionCreate (%Function.prototype% , sourceText, formalParameters,ClassStaticBlockBody ,non-lexical-this , lex, privateEnv) とする。 MakeMethod (bodyFunction, homeObject) を実行する。ClassStaticBlockDefinition Record { [[BodyFunction]]: bodyFunction } を返す。
15.7.12 Runtime Semantics: EvaluateClassStaticBlockBody
The
Assert : functionObject はClassStaticBlockDefinitionEvaluation のステップ5 によって作成された合成関数である。- !
FunctionDeclarationInstantiation (functionObject, « ») を実行する。 ClassStaticBlockStatementList の ?Evaluation を実行する。ReturnCompletion (undefined ) を返す。
15.7.13 Runtime Semantics: ClassElementEvaluation
The
- 引数 object を伴う
FieldDefinition の ?ClassFieldDefinitionEvaluation を返す。
- 引数 object および
false を伴うMethodDefinition の ?MethodDefinitionEvaluation を返す。
- 引数 object を伴う
ClassStaticBlock のClassStaticBlockDefinitionEvaluation を返す。
unused を返す。
15.7.14 Runtime Semantics: ClassDefinitionEvaluation
The
仕様を簡潔にするため、private メソッドおよびアクセサは、private フィールドとともに、クラスインスタンスの [[PrivateElements]] スロットに含まれる。しかし、任意のオブジェクトは、所与のクラスによって定義された private メソッドおよびアクセサのすべてを持つか、まったく持たないかのいずれかである。この機能は、実装が各メソッドまたはアクセサを個別に追跡する必要のない戦略を用いて private メソッドおよびアクセサを実装することを選択できるように設計されている。
例えば、実装はインスタンス private メソッドを対応する this 値として実行されたかを追跡できる。その場合、オブジェクト上でインスタンス private メソッドを検索することは、そのメソッドを定義するクラスコンストラクタがそのオブジェクトを初期化するために使用されたことを確認し、その後
これは private フィールドとは異なる。フィールド初期化子はクラスのインスタンス化中に投げる可能性があるため、個々のオブジェクトは所与のクラスの private フィールドの適切な部分集合だけを持つ場合があり、したがって private フィールドは一般に個別に追跡されなければならない。
It is defined piecewise over the following productions:
- env を実行中の実行コンテキストの LexicalEnvironment とする。
- classEnv を
NewDeclarativeEnvironment (env) とする。 - classBinding が
undefined でない場合、- ! classEnv.
CreateImmutableBinding (classBinding,true ) を実行する。
- ! classEnv.
- outerPrivateEnvironment を実行中の実行コンテキストの PrivateEnvironment とする。
- classPrivateEnvironment を
NewPrivateEnvironment (outerPrivateEnvironment) とする。 ClassBody が存在する場合、ClassBody のPrivateBoundIdentifiers の各 String dn について、次を行う。- classPrivateEnvironment.[[Names]] が、pn.[[Description]] が dn である
Private Name pn を含む場合、Assert : これは getter/setter ペアについてのみ可能である。
- そうでない場合、
- name を、[[Description]] が dn である新しい
Private Name とする。 - name を classPrivateEnvironment.[[Names]] に追加する。
- name を、[[Description]] が dn である新しい
- classPrivateEnvironment.[[Names]] が、pn.[[Description]] が dn である
ClassHeritage が存在しない場合、- protoParent を
%Object.prototype% とする。 - constructorParent を
%Function.prototype% とする。
- protoParent を
- そうでない場合、
- 実行中の実行コンテキストの LexicalEnvironment を classEnv に設定する。
NOTE :ClassHeritage を評価するとき、実行中の実行コンテキストの PrivateEnvironment は outerPrivateEnvironment である。- superclassRef を
ClassHeritage の評価のCompletion とする。 - 実行中の実行コンテキストの LexicalEnvironment を env に設定する。
- superclass を ?
GetValue (? superclassRef) とする。 - superclass が
null である場合、- protoParent を
null とする。 - constructorParent を
%Function.prototype% とする。
- protoParent を
- そうでなく、
IsConstructor (superclass) がfalse である場合、TypeError 例外を投げる。
- そうでない場合、
- protoParent を ?
Get (superclass,"prototype" ) とする。 - protoParent が Object でなく、かつ protoParent が
null でない場合、TypeError 例外を投げる。 - constructorParent を superclass とする。
- protoParent を ?
- proto を
OrdinaryObjectCreate (protoParent) とする。 ClassBody が存在しない場合、constructor をempty とする。- そうでない場合、constructor を
ClassBody のConstructorMethod とする。 - 実行中の実行コンテキストの LexicalEnvironment を classEnv に設定する。
- 実行中の実行コンテキストの PrivateEnvironment を classPrivateEnvironment に設定する。
- constructor が
empty である場合、- defaultConstructor を、パラメータを持たず、何もキャプチャせず、呼び出されたときに次の手順を実行する新しい
Abstract Closure とする。- args を、[[Call]] または [[Construct]] によりこの関数に渡された引数の
List とする。 - NewTarget が
undefined である場合、TypeError 例外を投げる。 - constructorFunction を現在アクティブな関数オブジェクトとする。
- constructorFunction.[[ConstructorKind]] が
derived である場合、NOTE : この分岐はconstructor(...args) { super(...args); }と同様に振る舞う。最も注目すべき相違点は、前述のECMAScript ソーステキスト が%Array.prototype%上の%Symbol.iterator% メソッドを観測可能に呼び出す一方で、この関数はそれを行わないことである。- func を ! constructorFunction.[[GetPrototypeOf]]() とする。
IsConstructor (func) がfalse である場合、TypeError 例外を投げる。- result を ?
Construct (func, args, NewTarget) とする。
- そうでない場合、
NOTE : この分岐はconstructor() {}と同様に振る舞う。- result を ?
OrdinaryCreateFromConstructor (NewTarget,"%Object.prototype%" ) とする。
- ?
InitializeInstanceElements (result, constructorFunction) を実行する。 NormalCompletion (result) を返す。
- args を、[[Call]] または [[Construct]] によりこの関数に渡された引数の
- constructorFunction を
CreateBuiltinFunction (defaultConstructor, 0, className, « [[ConstructorKind]], [[SourceText]], [[PrivateMethods]], [[Fields]] », thecurrent Realm Record , constructorParent) とする。
- defaultConstructor を、パラメータを持たず、何もキャプチャせず、呼び出されたときに次の手順を実行する新しい
- そうでない場合、
- constructorInfo を、引数 proto および constructorParent での constructor の !
DefineMethod とする。 - constructorFunction を constructorInfo.[[Closure]] とする。
MakeClassConstructor (constructorFunction) を実行する。SetFunctionName (constructorFunction, className) を実行する。
- constructorInfo を、引数 proto および constructorParent での constructor の !
- constructorFunction.[[SourceText]] を sourceText に設定する。
MakeConstructor (constructorFunction,false , proto) を実行する。ClassHeritage が存在する場合、constructorFunction.[[ConstructorKind]] をderived に設定する。- !
DefineMethodProperty (proto,"constructor" , constructorFunction,false ) を実行する。 ClassBody が存在しない場合、elements を新しい空のList とする。- そうでない場合、elements を
ClassBody のNonConstructorElements とする。 - instancePrivateMethods を新しい空の
List とする。 - staticPrivateMethods を新しい空の
List とする。 - instanceFields を新しい空の
List とする。 - staticElements を新しい空の
List とする。 - elements の各
ClassElement e について、次を行う。- e の
IsStatic がfalse である場合、- element を、引数 proto での e の
ClassElementEvaluation のCompletion とする。
- element を、引数 proto での e の
- そうでない場合、
- element を、引数 constructorFunction での e の
ClassElementEvaluation のCompletion とする。
- element を、引数 constructorFunction での e の
- element が
abrupt completion である場合、- 実行中の実行コンテキストの LexicalEnvironment を env に設定する。
- 実行中の実行コンテキストの PrivateEnvironment を outerPrivateEnvironment に設定する。
- ? element を返す。
- element を ! element に設定する。
- element が
PrivateElement である場合、Assert : element.[[Kind]] はmethod またはaccessor のどちらかである。- e の
IsStatic がfalse である場合、container を instancePrivateMethods とする。 - そうでない場合、container を staticPrivateMethods とする。
- container が、pe.[[Key]] が element.[[Key]] である
PrivateElement pe を含む場合、Assert : element.[[Kind]] と pe.[[Kind]] はともにaccessor である。- element.[[Get]] が
undefined である場合、- combined を
PrivateElement { [[Key]]: element.[[Key]], [[Kind]]:accessor , [[Get]]: pe.[[Get]], [[Set]]: element.[[Set]] } とする。
- combined を
- そうでない場合、
- combined を
PrivateElement { [[Key]]: element.[[Key]], [[Kind]]:accessor , [[Get]]: element.[[Get]], [[Set]]: pe.[[Set]] } とする。
- combined を
- container 内の pe を combined で置き換える。
- そうでない場合、
- element を container に追加する。
- そうでなく、element が
ClassFieldDefinition Record である場合、- e の
IsStatic がfalse である場合、element を instanceFields に追加する。 - そうでない場合、element を staticElements に追加する。
- e の
- そうでなく、element が
ClassStaticBlockDefinition Record である場合、- element を staticElements に追加する。
- e の
- 実行中の実行コンテキストの LexicalEnvironment を env に設定する。
- classBinding が
undefined でない場合、- ! classEnv.
InitializeBinding (classBinding, constructorFunction) を実行する。
- ! classEnv.
- constructorFunction.[[PrivateMethods]] を instancePrivateMethods に設定する。
- constructorFunction.[[Fields]] を instanceFields に設定する。
- staticPrivateMethods の各
PrivateElement method について、次を行う。- !
PrivateMethodOrAccessorAdd (constructorFunction, method) を実行する。
- !
- staticElements の各要素 elementRecord について、次を行う。
- elementRecord が
ClassFieldDefinition Record である場合、- result を
Completion (DefineField (constructorFunction, elementRecord)) とする。
- result を
- そうでない場合、
Assert : elementRecord はClassStaticBlockDefinition Record である。- result を
Completion (Call (elementRecord.[[BodyFunction]], constructorFunction)) とする。
- result が
abrupt completion である場合、- 実行中の実行コンテキストの PrivateEnvironment を outerPrivateEnvironment に設定する。
- ? result を返す。
- elementRecord が
- 実行中の実行コンテキストの PrivateEnvironment を outerPrivateEnvironment に設定する。
- constructorFunction を返す。
15.7.15 Runtime Semantics: BindingClassDeclarationEvaluation
The
- className を
BindingIdentifier のStringValue とする。 - sourceText を
ClassDeclaration に一致したソーステキストとする。 - value を、引数 className、className、および sourceText を伴う
ClassTail の ?ClassDefinitionEvaluation とする。 - env を実行中の実行コンテキストの LexicalEnvironment とする。
- ?
InitializeBoundName (className, value, env) を実行する。 - value を返す。
- sourceText を
ClassDeclaration に一致したソーステキストとする。 - 引数
undefined 、"default" 、および sourceText を伴うClassTail の ?ClassDefinitionEvaluation を返す。
15.7.16 Runtime Semantics: Evaluation
- この
ClassDeclaration の ?BindingClassDeclarationEvaluation を実行する。 empty を返す。
- sourceText を
ClassExpression に一致したソーステキストとする。 - 引数
undefined 、空の String、および sourceText を伴うClassTail の ?ClassDefinitionEvaluation を返す。
- className を
BindingIdentifier のStringValue とする。 - sourceText を
ClassExpression に一致したソーステキストとする。 - 引数 className、className、および sourceText を伴う
ClassTail の ?ClassDefinitionEvaluation を返す。
- privateIdentifier を
PrivateIdentifier のStringValue とする。 - privateEnvRec を実行中の実行コンテキストの PrivateEnvironment とする。
- names を privateEnvRec.[[Names]] とする。
Assert : names のうち正確に一つの要素が、[[Description]] が privateIdentifier であるPrivate Name である。- privateName を、[[Description]] が privateIdentifier である names 内の
Private Name とする。 - privateName を返す。
undefined を返す。
15.8 非同期関数定義
構文
[Await] パラメータが存在するとき、await は
AsyncFunctionBody 内。AsyncFunctionDeclaration 、AsyncFunctionExpression 、AsyncGeneratorDeclaration 、またはAsyncGeneratorExpression のFormalParameters 内。この位置のAwaitExpression は静的意味論により構文エラーである。Module 内。
await は識別子として解析されてもよい。これには次のコンテキストが含まれる:
15.8.1 Static Semantics: 早期エラー
AsyncFunctionBody のFunctionBodyContainsUseStrict がtrue であり、かつUniqueFormalParameters のIsSimpleParameterList がfalse である場合、これは構文エラーである。AsyncMethod のHasDirectSuper がtrue である場合、これは構文エラーである。UniqueFormalParameters Contains AwaitExpression がtrue である場合、これは構文エラーである。UniqueFormalParameters のBoundNames の任意の要素がAsyncFunctionBody のLexicallyDeclaredNames にも現れる場合、これは構文エラーである。
AsyncFunctionBody のFunctionBodyContainsUseStrict がtrue であり、かつFormalParameters のIsSimpleParameterList がfalse である場合、これは構文エラーである。FormalParameters Contains AwaitExpression がtrue である場合、これは構文エラーである。IsStrict (FormalParameters ) がtrue である場合、UniqueFormalParameters : FormalParameters BindingIdentifier が存在し、かつIsStrict (BindingIdentifier ) がtrue である場合、BindingIdentifier のStringValue が"eval" または"arguments" のいずれかであれば、これは構文エラーである。FormalParameters のBoundNames の任意の要素がAsyncFunctionBody のLexicallyDeclaredNames にも現れる場合、これは構文エラーである。FormalParameters Contains SuperProperty がtrue である場合、これは構文エラーである。AsyncFunctionBody Contains SuperProperty がtrue である場合、これは構文エラーである。FormalParameters Contains SuperCall がtrue である場合、これは構文エラーである。AsyncFunctionBody Contains SuperCall がtrue である場合、これは構文エラーである。
15.8.2 Runtime Semantics: InstantiateAsyncFunctionObject
The
- name を
BindingIdentifier のStringValue とする。 - sourceText を
AsyncFunctionDeclaration に一致したソーステキストとする。 - closure を
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,FormalParameters ,AsyncFunctionBody ,non-lexical-this , env, privateEnv) とする。 SetFunctionName (closure, name) を実行する。- closure を返す。
- sourceText を
AsyncFunctionDeclaration に一致したソーステキストとする。 - closure を
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,FormalParameters ,AsyncFunctionBody ,non-lexical-this , env, privateEnv) とする。 SetFunctionName (closure,"default" ) を実行する。- closure を返す。
15.8.3 Runtime Semantics: InstantiateAsyncFunctionExpression
The
- name が存在しない場合、name を空の String に設定する。
- env を実行中の実行コンテキストの LexicalEnvironment とする。
- privateEnv を実行中の実行コンテキストの PrivateEnvironment とする。
- sourceText を
AsyncFunctionExpression に一致したソーステキストとする。 - closure を
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,FormalParameters ,AsyncFunctionBody ,non-lexical-this , env, privateEnv) とする。 SetFunctionName (closure, name) を実行する。- closure を返す。
Assert : name は存在しない。- name を
BindingIdentifier のStringValue に設定する。 - outerEnv を実行中の実行コンテキストの LexicalEnvironment とする。
- funcEnv を
NewDeclarativeEnvironment (outerEnv) とする。 - ! funcEnv.
CreateImmutableBinding (name,false ) を実行する。 - privateEnv を実行中の実行コンテキストの PrivateEnvironment とする。
- sourceText を
AsyncFunctionExpression に一致したソーステキストとする。 - closure を
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText,FormalParameters ,AsyncFunctionBody ,non-lexical-this , funcEnv, privateEnv) とする。 SetFunctionName (closure, name) を実行する。- ! funcEnv.
InitializeBinding (name, closure) を実行する。 - closure を返す。
15.8.4 Runtime Semantics: EvaluateAsyncFunctionBody
The
- promiseCapability を !
NewPromiseCapability (%Promise% ) とする。 - completion を
Completion (FunctionDeclarationInstantiation (functionObject, argumentsList)) とする。 - completion が
abrupt completion である場合、- !
Call (promiseCapability.[[Reject]],undefined , « completion.[[Value]] ») を実行する。
- !
- そうでなければ、
AsyncFunctionStart (promiseCapability,FunctionBody ) を実行する。
ReturnCompletion (promiseCapability.[[Promise]]) を返す。
15.8.5 Runtime Semantics: Evaluation
- exprRef を
UnaryExpression の ?Evaluation とする。 - value を ?
GetValue (exprRef) とする。 - ?
Await (value) を返す。
15.9 非同期アロー関数定義
構文
補足構文
生成規則
のインスタンスを処理するとき、
15.9.1 Static Semantics: 早期エラー
AsyncArrowBindingIdentifier のBoundNames の任意の要素がAsyncConciseBody のLexicallyDeclaredNames にも現れる場合、これは構文エラーである。
CoverCallExpressionAndAsyncArrowHead はAsyncArrowHead をカバーしていなければならない。CoverCallExpressionAndAsyncArrowHead Contains YieldExpression がtrue である場合、これは構文エラーである。CoverCallExpressionAndAsyncArrowHead Contains AwaitExpression がtrue である場合、これは構文エラーである。CoverCallExpressionAndAsyncArrowHead のBoundNames の任意の要素がAsyncConciseBody のLexicallyDeclaredNames にも現れる場合、これは構文エラーである。AsyncConciseBody のAsyncConciseBodyContainsUseStrict がtrue であり、かつCoverCallExpressionAndAsyncArrowHead のIsSimpleParameterList がfalse である場合、これは構文エラーである。
15.9.2 Static Semantics: AsyncConciseBodyContainsUseStrict
The
false を返す。
15.9.3 Runtime Semantics: EvaluateAsyncConciseBody
The
- promiseCapability を !
NewPromiseCapability (%Promise% ) とする。 - completion を
Completion (FunctionDeclarationInstantiation (functionObject, argumentsList)) とする。 - completion が
abrupt completion である場合、- !
Call (promiseCapability.[[Reject]],undefined , « completion.[[Value]] ») を実行する。
- !
- そうでなければ、
AsyncFunctionStart (promiseCapability,ExpressionBody ) を実行する。
ReturnCompletion (promiseCapability.[[Promise]]) を返す。
15.9.4 Runtime Semantics: InstantiateAsyncArrowFunctionExpression
The
- name が存在しない場合、name を空の String に設定する。
- env を実行中の実行コンテキストの LexicalEnvironment とする。
- privateEnv を実行中の実行コンテキストの PrivateEnvironment とする。
- sourceText を
AsyncArrowFunction に一致したソーステキストとする。 - parameters を
AsyncArrowBindingIdentifier とする。 - closure を
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText, parameters,AsyncConciseBody ,lexical-this , env, privateEnv) とする。 SetFunctionName (closure, name) を実行する。- closure を返す。
- name が存在しない場合、name を空の String に設定する。
- env を実行中の実行コンテキストの LexicalEnvironment とする。
- privateEnv を実行中の実行コンテキストの PrivateEnvironment とする。
- sourceText を
AsyncArrowFunction に一致したソーステキストとする。 - head を、
CoverCallExpressionAndAsyncArrowHead によってカバーされるAsyncArrowHead とする。 - parameters を head の
ArrowFormalParameters とする。 - closure を
OrdinaryFunctionCreate (%AsyncFunction.prototype% , sourceText, parameters,AsyncConciseBody ,lexical-this , env, privateEnv) とする。 SetFunctionName (closure, name) を実行する。- closure を返す。
15.9.5 Runtime Semantics: Evaluation
15.10 末尾位置呼び出し
15.10.1 Static Semantics: IsInTailPosition ( call )
The
IsStrict (call) がfalse である場合、false を返す。- call が
FunctionBody 、ConciseBody 、またはAsyncConciseBody 内に含まれていない場合、false を返す。 - body を、call を最も近く含む
FunctionBody 、ConciseBody 、またはAsyncConciseBody とする。 - body が
GeneratorBody のFunctionBody である場合、false を返す。 - body が
AsyncFunctionBody のFunctionBody である場合、false を返す。 - body が
AsyncGeneratorBody のFunctionBody である場合、false を返す。 - body が
AsyncConciseBody である場合、false を返す。 - 引数 call を伴う body の
HasCallInTailPosition の結果を返す。
末尾位置呼び出しは、呼び出し元コンテキストの連鎖の観測を可能にする一般的な非標準言語拡張（
15.10.2 Static Semantics: HasCallInTailPosition
The
call は、ソーステキストの特定の範囲を表す
呼び出し結果の
It is defined piecewise over the following productions:
- has を、引数 call を伴う
StatementList のHasCallInTailPosition とする。 - has が
true である場合、true を返す。 - 引数 call を伴う
StatementListItem のHasCallInTailPosition を返す。
false を返す。
- has を、引数 call を伴う最初の
Statement のHasCallInTailPosition とする。 - has が
true である場合、true を返す。 - 引数 call を伴う 2 番目の
Statement のHasCallInTailPosition を返す。
- 引数 call を伴う
Statement のHasCallInTailPosition を返す。
- 引数 call を伴う
LabelledItem のHasCallInTailPosition を返す。
- 引数 call を伴う
Expression のHasCallInTailPosition を返す。
- 引数 call を伴う
CaseBlock のHasCallInTailPosition を返す。
- has を
false とする。 - 最初の
CaseClauses が存在する場合、has を引数 call を伴う最初のCaseClauses のHasCallInTailPosition に設定する。 - has が
true である場合、true を返す。 - has を、引数 call を伴う
DefaultClause のHasCallInTailPosition に設定する。 - has が
true である場合、true を返す。 - 2 番目の
CaseClauses が存在する場合、has を引数 call を伴う 2 番目のCaseClauses のHasCallInTailPosition に設定する。 - has を返す。
- has を、引数 call を伴う
CaseClauses のHasCallInTailPosition とする。 - has が
true である場合、true を返す。 - 引数 call を伴う
CaseClause のHasCallInTailPosition を返す。
StatementList が存在する場合、引数 call を伴うStatementList のHasCallInTailPosition を返す。false を返す。
- 引数 call を伴う
Catch のHasCallInTailPosition を返す。
- 引数 call を伴う
Finally のHasCallInTailPosition を返す。
- 引数 call を伴う
Block のHasCallInTailPosition を返す。
false を返す。
- 引数 call を伴う
AssignmentExpression のHasCallInTailPosition を返す。
- has を、引数 call を伴う最初の
AssignmentExpression のHasCallInTailPosition とする。 - has が
true である場合、true を返す。 - 引数 call を伴う 2 番目の
AssignmentExpression のHasCallInTailPosition を返す。
- 引数 call を伴う
BitwiseORExpression のHasCallInTailPosition を返す。
- 引数 call を伴う
LogicalANDExpression のHasCallInTailPosition を返す。
- 引数 call を伴う
BitwiseORExpression のHasCallInTailPosition を返す。
- この
CallExpression が call である場合、true を返す。 false を返す。
- 引数 call を伴う
OptionalChain のHasCallInTailPosition を返す。
false を返す。
- この
OptionalChain が call である場合、true を返す。 false を返す。
- この
MemberExpression が call である場合、true を返す。 false を返す。
- expr を
CoverParenthesizedExpressionAndArrowParameterList によってカバーされるParenthesizedExpression とする。 - 引数 call を伴う expr の
HasCallInTailPosition を返す。
- 引数 call を伴う
Expression のHasCallInTailPosition を返す。
15.10.3 PrepareForTailCall ( )
The
Assert : 現在の実行コンテキストは、その後 ECMAScript コードまたは組込み関数の評価に使用されない。この抽象操作の呼び出しに続く Call の呼び出しは、そのような評価を実行する前に新しい実行コンテキストを作成して push する。- 現在の実行コンテキストに関連付けられたすべてのリソースを破棄する。
unused を返す。
末尾位置呼び出しは、ターゲット関数を呼び出す前に、現在実行中の関数実行コンテキストに関連付けられた一時的な内部リソースを解放するか、ターゲット関数を支援するためにそれらのリソースを再利用しなければならない。
例えば、末尾位置呼び出しは、ターゲット関数のアクティベーションレコードのサイズが呼び出し元関数のアクティベーションレコードのサイズを超える分だけ、実装のアクティベーションレコードスタックを増加させるべきである。ターゲット関数のアクティベーションレコードがより小さい場合、スタックの合計サイズは減少するべきである。
16 ECMAScript言語：スクリプトとモジュール
16.1 スクリプト
構文
16.1.1 Static Semantics: 早期エラー
-
ScriptBody のLexicallyDeclaredNames に重複したエントリが含まれている場合、Syntax Error となる。 -
ScriptBody のLexicallyDeclaredNames のいずれかの要素が、ScriptBody のVarDeclaredNames にも含まれている場合、Syntax Error となる。
-
superを含むStatementList は、superを含むソーステキストが直接 eval によって処理されるeval コード でない限り、Syntax Error となる。direct eval 内でのsuperに関する追加の早期エラールールは19.2.1.1 に定義されている。 -
NewTarget を含むStatementList は、それを含むソーステキストが直接 eval によって処理されるeval コード でない限り、Syntax Error となる。direct eval におけるNewTarget の追加の早期エラールールは19.2.1.1 に定義されている。 -
ContainsDuplicateLabels ofStatementList （引数 « »）がtrue の場合、Syntax Error となる。 -
ContainsUndefinedBreakTarget ofStatementList （引数 « »）がtrue の場合、Syntax Error となる。 -
ContainsUndefinedContinueTarget ofStatementList （引数 « » および « »）がtrue の場合、Syntax Error となる。 -
AllPrivateIdentifiersValid ofStatementList （引数 « »）がfalse の場合、ScriptBody を含むソーステキストが直接 eval によって処理されるeval コード でない限り、Syntax Error となる。
16.1.2 Static Semantics: ScriptIsStrict
The
ScriptBody が存在し、かつそのDirective Prologue にUse Strict Directive が含まれている場合、true を返す。false を返す。
16.1.3 Runtime Semantics: Evaluation
undefined を返す。
16.1.4 スクリプトレコード
スクリプトレコードは、評価されるスクリプトに関する情報をカプセル化する。各
| フィールド名 | 値の型 | 意味 |
|---|---|---|
| [[Realm]] |
|
このスクリプトが生成された |
| [[ECMAScriptCode]] |
|
このスクリプトのソーステキストを解析した結果。 |
| [[LoadedModules]] |
|
このスクリプトによってインポートされた指定子文字列から解決済み Module |
| [[HostDefined]] |
任意（デフォルト値は |
ホスト環境がスクリプトに追加情報を関連付けるために予約されたフィールド。 |
16.1.5 ParseScript ( sourceText, realm, hostDefined )
The
実装はスクリプトソーステキストを事前に解析し、ParseScript の評価前に Early Error 条件を検査してもよい。ただし、エラーの報告はこの仕様が実際にそのソーステキストに対して ParseScript を実行する時点まで遅延されなければならない。
16.1.6 ScriptEvaluation ( scriptRecord )
The
- globalEnv を scriptRecord.[[Realm]].[[GlobalEnv]] とする。
- scriptContext を新しい ECMAScript コード実行コンテキストとする。
- scriptContext の Function を
null に設定する。 - scriptContext の
Realm を scriptRecord.[[Realm]] に設定する。 - scriptContext の ScriptOrModule を scriptRecord に設定する。
- scriptContext の VariableEnvironment を globalEnv に設定する。
- scriptContext の LexicalEnvironment を globalEnv に設定する。
- scriptContext の PrivateEnvironment を
null に設定する。 - 実行中の実行コンテキストを一時停止する。
- scriptContext を実行コンテキストスタックにプッシュする；これが現在の実行コンテキストとなる。
- script を scriptRecord.[[ECMAScriptCode]] とする。
- result を
Completion (GlobalDeclarationInstantiation (script, globalEnv)) とする。 - result が通常完了である場合、
- result を
Completion (script のEvaluation ) に設定する。 - result が通常完了であり、かつ result.[[Value]] が
empty の場合、- result を
NormalCompletion (undefined ) に設定する。
- result を
- result を
- scriptContext を一時停止し、実行コンテキストスタックから削除する。
Assert : 実行コンテキストスタックは空でない。- スタックの最上位のコンテキストを再開し、それを現在の実行コンテキストとする。
- ? result を返す。
16.1.7 GlobalDeclarationInstantiation ( script, env )
The
スクリプト評価のための実行コンテキストが確立されるとき、宣言は現在のグローバル環境にインスタンス化される。コード内で宣言されたすべてのグローバルバインディングがインスタンス化される。
この操作は以下の手順を実行する：
- lexNames を script の
LexicallyDeclaredNames とする。 - varNames を script の
VarDeclaredNames とする。 - lexNames の各要素 name について、次を行う。
HasLexicalDeclaration (env, name) がtrue である場合、SyntaxError 例外を投げる。- hasRestrictedGlobal を ?
HasRestrictedGlobalProperty (env, name) とする。 NOTE : グローバルvarおよびfunction束縛（非 strict のdirect eval によって導入されるものを除く）は構成不可であり、したがって制限されたグローバルプロパティである。- hasRestrictedGlobal が
true である場合、SyntaxError 例外を投げる。
- varNames の各要素 name について、次を行う。
HasLexicalDeclaration (env, name) がtrue である場合、SyntaxError 例外を投げる。
- varDeclarations を script の
VarScopedDeclarations とする。 - functionsToInitialize を新しい空の
List とする。 - declaredFunctionNames を新しい空の
List とする。 - varDeclarations の各要素 varDecl について、
List の逆順で、次を行う。- varDecl が
VariableDeclaration 、ForBinding 、またはBindingIdentifier のいずれでもない場合、Assert : varDecl はFunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 、またはAsyncGeneratorDeclaration のいずれかである。NOTE : 同じ名前に対して複数の関数宣言がある場合、最後の宣言が使用される。- fn を varDecl の
BoundNames の唯一の要素とする。 - declaredFunctionNames が fn を含まない場合、
- fnDefinable を ?
CanDeclareGlobalFunction (env, fn) とする。 - fnDefinable が
false である場合、TypeError 例外を投げる。 - fn を declaredFunctionNames に追加する。
- varDecl を functionsToInitialize の先頭要素として挿入する。
- fnDefinable を ?
- varDecl が
- declaredVarNames を新しい空の
List とする。 - varDeclarations の各要素 varDecl について、次を行う。
- varDecl が
VariableDeclaration 、ForBinding 、またはBindingIdentifier のいずれかである場合、- varDecl の
BoundNames の各 String vn について、次を行う。- declaredFunctionNames が vn を含まない場合、
- vnDefinable を ?
CanDeclareGlobalVar (env, vn) とする。 - vnDefinable が
false である場合、TypeError 例外を投げる。 - declaredVarNames が vn を含まない場合、
- vn を declaredVarNames に追加する。
- vnDefinable を ?
- declaredFunctionNames が vn を含まない場合、
- varDecl の
- varDecl が
NOTE :グローバルオブジェクト がordinary object である場合、このアルゴリズムステップ以降に異常終了は発生しない。しかし、グローバルオブジェクト が Proxyexotic object である場合、以降の一部のステップで異常終了を引き起こす振る舞いを示すことがある。- ホストがウェブブラウザであるか、または
ブロックレベル Function Declaration の Web レガシー互換性意味論 をサポートする場合、- strict を script の
ScriptIsStrict とする。 - strict が
false である場合、- declaredFunctionOrVarNames を declaredFunctionNames と declaredVarNames の
list-concatenation とする。 - script
Contains x がtrue となるような任意のBlock 、CaseClause 、またはDefaultClause x のStatementList に直接含まれる各FunctionDeclaration f について、次を行う。- funcName を f の
BindingIdentifier のStringValue とする。 FunctionDeclaration f を、funcName をBindingIdentifier として持つVariableStatement に置き換えても script に Early Errors が一切発生しない場合、HasLexicalDeclaration (env, funcName) がfalse である場合、- fnDefinable を ?
CanDeclareGlobalVar (env, funcName) とする。 - fnDefinable が
true である場合、NOTE : funcName に対する var 束縛は、それが VarDeclaredName でも別のFunctionDeclaration の名前でもない場合にのみ、ここでインスタンス化される。- declaredFunctionOrVarNames が funcName を含まない場合、
- ?
CreateGlobalVarBinding (env, funcName,false ) を実行する。 - funcName を declaredFunctionOrVarNames に追加する。
- ?
FunctionDeclaration f が評価されるとき、15.2.6 で与えられるFunctionDeclaration Evaluation アルゴリズムの代わりに、次の手順を実行する。- gEnv を実行中の実行コンテキストの VariableEnvironment とする。
- bEnv を実行中の実行コンテキストの LexicalEnvironment とする。
- fObj を ! bEnv.
GetBindingValue (funcName,false ) とする。 - ? gEnv.
SetMutableBinding (funcName, fObj,false ) を実行する。 unused を返す。
- fnDefinable を ?
- funcName を f の
- declaredFunctionOrVarNames を declaredFunctionNames と declaredVarNames の
- strict を script の
- lexDeclarations を script の
LexicallyScopedDeclarations とする。 - privateEnv を
null とする。 - lexDeclarations の各要素 lexDecl について、次を行う。
NOTE : 字句的に宣言された名前はここでインスタンス化されるだけで、初期化はされない。- lexDecl の
BoundNames の各要素 dn について、次を行う。- lexDecl の
IsConstantDeclaration がtrue である場合、- ? env.
CreateImmutableBinding (dn,true ) を実行する。
- ? env.
- そうでない場合、
- ? env.
CreateMutableBinding (dn,false ) を実行する。
- ? env.
- lexDecl の
- functionsToInitialize の各
Parse Node f について、次を行う。- fn を f の
BoundNames の唯一の要素とする。 - fo を、引数 env および privateEnv での f の
InstantiateFunctionObject とする。 - ?
CreateGlobalFunctionBinding (env, fn, fo,false ) を実行する。
- fn を f の
- declaredVarNames の各 String vn について、次を行う。
- ?
CreateGlobalVarBinding (env, vn,false ) を実行する。
- ?
unused を返す。
Early Error は let/const/class と var/function の衝突を防ぐが、複数 Script 間の衝突はここで検出される。
16.2 モジュール
構文
16.2.1 モジュールのセマンティクス
16.2.1.1 Static Semantics: 早期エラー
-
ModuleItemList のLexicallyDeclaredNames に重複したエントリが含まれている場合、Syntax Error となる。 -
ModuleItemList のLexicallyDeclaredNames のいずれかの要素が、ModuleItemList のVarDeclaredNames にも含まれている場合、Syntax Error となる。 -
ModuleItemList のExportedNames に重複したエントリが含まれている場合、Syntax Error となる。 -
ModuleItemList のExportedBindings のいずれかの要素が、ModuleItemList のVarDeclaredNames またはLexicallyDeclaredNames のいずれにも含まれていない場合、Syntax Error となる。 -
ModuleItemList にsuperが含まれている場合、Syntax Error となる。 -
ModuleItemList にNewTarget が含まれている場合、Syntax Error となる。 -
ContainsDuplicateLabels ofModuleItemList （引数 « »）がtrue の場合、Syntax Error となる。 -
ContainsUndefinedBreakTarget ofModuleItemList （引数 « »）がtrue の場合、Syntax Error となる。 -
ContainsUndefinedContinueTarget ofModuleItemList （引数 « » および « »）がtrue の場合、Syntax Error となる。 -
AllPrivateIdentifiersValid ofModuleItemList （引数 « »）がfalse の場合、Syntax Error となる。
export default
StringLiteral のSV に対するIsStringWellFormedUnicode がfalse の場合、Syntax Error となる。
16.2.1.2 Static Semantics: ImportedLocalNames ( importEntries )
The
- localNames を新しい空のリストとする。
- importEntries の各
ImportEntry レコード i について、- i.[[LocalName]] を localNames に追加する。
- localNames を返す。
16.2.1.3 ModuleRequest レコード
ModuleRequest レコードは、指定されたインポート属性を持つモジュールのインポート要求を表す。以下のフィールドで構成される：
| フィールド名 | 値の型 | 意味 |
|---|---|---|
| [[Specifier]] | 文字列 | モジュール指定子 |
| [[Attributes]] |
|
インポート属性 |
LoadedModuleRequest レコードは、モジュールのインポート要求とそれに対応する Module
| フィールド名 | 値の型 | 意味 |
|---|---|---|
| [[Specifier]] | 文字列 | モジュール指定子 |
| [[Attributes]] |
|
インポート属性 |
| [[Module]] |
Module |
このモジュール要求に対応する読み込まれたモジュール |
ImportAttribute レコードは以下のフィールドで構成される：
| フィールド名 | 値の型 | 意味 |
|---|---|---|
| [[Key]] | 文字列 | 属性キー |
| [[Value]] | 文字列 | 属性値 |
16.2.1.3.1 ModuleRequestsEqual ( left, right )
The
- left.[[Specifier]] が right.[[Specifier]] と異なる場合、
false を返す。 - leftAttrs を left.[[Attributes]] とする。
- rightAttrs を right.[[Attributes]] とする。
- leftAttrsCount を leftAttrs の要素数とする。
- rightAttrsCount を rightAttrs の要素数とする。
- leftAttrsCount ≠ rightAttrsCount の場合、
false を返す。 - leftAttrs の各
ImportAttribute レコード l について、- rightAttrs に l.[[Key]] が r.[[Key]] と等しく、かつ l.[[Value]] が r.[[Value]] と等しい
ImportAttribute レコード r が存在しない場合、false を返す。
- rightAttrs に l.[[Key]] が r.[[Key]] と等しく、かつ l.[[Value]] が r.[[Value]] と等しい
true を返す。
16.2.1.4 Static Semantics: ModuleRequests
The
- 新しい空のリストを返す。
ModuleItem のModuleRequests を返す。
- requests を
ModuleItemList のModuleRequests とする。 - additionalRequests を
ModuleItem のModuleRequests とする。 - additionalRequests の各
ModuleRequest レコード mr について、- requests に
ModuleRequestsEqual (mr, mr2) がtrue となるModuleRequest レコード mr2 が含まれていない場合、- mr を requests に追加する。
- requests に
- requests を返す。
- 新しい空のリストを返す。
- specifier を
FromClause のSV とする。 - 唯一の要素が
ModuleRequest レコード { [[Specifier]]: specifier, [[Attributes]]: « » } であるリストを返す。
- specifier を
FromClause のSV とする。 - attributes を
WithClause のWithClauseToAttributes とする。 - 唯一の要素が
ModuleRequest レコード { [[Specifier]]: specifier, [[Attributes]]: attributes } であるリストを返す。
- specifier を
ModuleSpecifier のSV とする。 - 唯一の要素が
ModuleRequest レコード { [[Specifier]]: specifier, [[Attributes]]: « » } であるリストを返す。
- specifier を
ModuleSpecifier のSV とする。 - attributes を
WithClause のWithClauseToAttributes とする。 - 唯一の要素が
ModuleRequest レコード { [[Specifier]]: specifier, [[Attributes]]: attributes } であるリストを返す。
- specifier を
FromClause のSV とする。 - 唯一の要素が
ModuleRequest レコード { [[Specifier]]: specifier, [[Attributes]]: « » } であるリストを返す。
- specifier を
FromClause のSV とする。 - attributes を
WithClause のWithClauseToAttributes とする。 - 唯一の要素が
ModuleRequest レコード { [[Specifier]]: specifier, [[Attributes]]: attributes } であるリストを返す。
- 新しい空のリストを返す。
16.2.1.5 抽象モジュールレコード
モジュールレコードは、単一のモジュールのインポートおよびエクスポートの構造情報をカプセル化します。この情報は、接続されたモジュール群のインポートとエクスポートを連結するために使用されます。モジュールレコードには、モジュールを評価するときのみ使用される4つのフィールドが含まれます。
仕様上、モジュールレコード値は
Module
| フィールド名 | 値の型 | 意味 |
|---|---|---|
| [[Realm]] |
|
このモジュールが作成された |
| [[Environment]] |
|
このモジュールのトップレベルバインディングを含む |
| [[Namespace]] |
オブジェクト または |
このモジュールのために作成された場合のモジュール名前空間オブジェクト（ |
| [[HostDefined]] |
任意（デフォルト値は |
モジュールに追加情報を関連付ける必要があるホスト環境用に予約されたフィールドです。 |
| メソッド | 目的 | 定義 |
|---|---|---|
| LoadRequestedModules ( [ hostDefined ] ) | The abstract method LoadRequestedModules takes optional argument hostDefined (anything) and returns Promise. 依存関係を再帰的に全てロードすることで、モジュールのリンキング準備を行います。 |
本仕様では以下の型に定義があります。ホストは追加型に独自定義を持たせてもよい：
|
| GetExportedNames ( [ exportStarSet ] ) | The abstract method GetExportedNames takes optional argument exportStarSet (Source Text Module このモジュールから直接あるいは間接的にエクスポートされるすべての名前のリストを返します。 このメソッドを呼び出す前に |
本仕様では以下の型に定義があります。ホストは追加型に独自定義を持たせてもよい：
|
| ResolveExport ( exportName [ , resolveSet ] ) | The abstract method ResolveExport takes argument exportName (a String) and optional argument resolveSet (a このモジュールによってエクスポートされる名前のバインディングを返します。バインディングは ResolvedBinding Record の形式 { [[Module]]: Module この操作は特定のexportName, resolveSet組み合わせに対して常に同じ結果を返さなければなりません。 このメソッドを呼び出す前に |
本仕様では以下の型に定義があります。ホストは追加型に独自定義を持たせてもよい：
|
| Link ( ) | The abstract method Link takes no arguments and returns 正常終了時 モジュール依存を推移的に解決し、 このメソッドを呼び出す前に |
本仕様では以下の型に定義があります。ホストは追加型に独自定義を持たせてもよい：
|
| Evaluate ( ) | The abstract method Evaluate takes no arguments and returns Promise. このモジュールおよびその依存の評価Promiseを返します。評価が正常に終了した場合、またはすでに正常評価済みの場合には解決され、評価エラーの場合またはすでに評価失敗している場合には拒否されます。Promiseが拒否されるとホストはPromise拒否を処理し、評価エラーを再スローすることが期待されます。このモジュールがCyclic Module このメソッドを呼び出す前に |
本仕様では以下の型に定義があります。ホストは追加型に独自定義を持たせてもよい：
|
16.2.1.5.1 EvaluateModuleSync ( module )
The
Assert : module は Cyclic ModuleRecord ではないこと。- promise を module.
Evaluate () とする。 Assert : promise.[[PromiseState]] はfulfilled またはrejected である。- もし promise.[[PromiseState]] が
rejected ならば、- promise.[[PromiseIsHandled]] が
false の場合、HostPromiseRejectionTracker (promise,"handle" ) を実行する。 - promise.[[PromiseIsHandled]] を
true に設定する。 - promise.[[PromiseResult]] をスローする。
- promise.[[PromiseIsHandled]] が
unused を返す。
16.2.1.6 循環モジュールレコード
循環モジュールレコードは、Cyclic Module
| フィールド名 | 値の型 | 意味 |
|---|---|---|
| [[Status]] |
|
初期値は |
| [[EvaluationError]] |
throw 完了 または |
評価中に発生した例外を表す throw 完了。例外が発生していない場合、または [[Status]] が |
| [[DFSAncestorIndex]] |
整数 または |
|
| [[RequestedModules]] |
ModuleRequest |
このモジュール内の import に関連付けられた ModuleRequest |
| [[LoadedModules]] |
LoadedModuleRequest |
このレコードで表されるモジュールが、解決済み Module |
| [[CycleRoot]] |
|
循環内で最初に訪問されたモジュール、すなわち強連結成分の DFS 祖先のルート。循環に含まれないモジュールの場合は、そのモジュール自身となる。 |
| [[HasTLA]] | Boolean |
このモジュールが個別に非同期であるかどうか（例えば、トップレベル await を含む Source Text Module |
| [[AsyncEvaluationOrder]] |
|
このフィールドは初期値が |
| [[TopLevelCapability]] |
|
このモジュールがある循環の [[CycleRoot]] であり、その循環内のいずれかのモジュールに対して |
| [[AsyncParentModules]] |
|
このモジュールまたは依存関係のいずれかが [[HasTLA]] |
| [[PendingAsyncDependencies]] |
整数 または |
このモジュールが非同期依存を持つ場合、このモジュールの実行のために残っている非同期依存モジュールの数を追跡する。非同期依存を持つモジュールは、このフィールドが 0 になり、かつ実行エラーがないときに実行される。 |
| メソッド | 目的 | 定義 |
|---|---|---|
| InitializeEnvironment ( ) | The abstract method InitializeEnvironment takes no arguments and returns |
本仕様では以下の型で定義されている。ホストは独自の定義を持つ追加型を提供してもよい：
|
| ExecuteModule ( [ capability ] ) | The abstract method ExecuteModule takes optional argument capability ( |
本仕様では以下の型で定義されている。ホストは独自の定義を持つ追加型を提供してもよい：
|
GraphLoadingState レコードは、モジュールグラフのロード処理に関する情報を含むレコードである。これは
| フィールド名 | 値の型 | 意味 |
|---|---|---|
| [[PromiseCapability]] |
|
ロード処理完了時に解決される Promise。 |
| [[IsLoading]] | Boolean | ロード処理がまだ完了していない場合（成功でもエラーでもない場合）に true。 |
| [[PendingModulesCount]] | 0以上の整数 |
保留中の |
| [[Visited]] |
|
現在のロード処理で既にロードされた |
| [[HostDefined]] |
任意（デフォルト値は |
|
16.2.1.6.1 モジュールレコード抽象メソッドの実装
以下は、
16.2.1.6.1.1 LoadRequestedModules ( [ hostDefined ] )
The
- hostDefined が存在しない場合、hostDefined を
empty に設定する。 - pc を !
NewPromiseCapability (%Promise% ) とする。 - state を
GraphLoadingState レコード { [[IsLoading]]:true , [[PendingModulesCount]]: 1, [[Visited]]: « », [[PromiseCapability]]: pc, [[HostDefined]]: hostDefined } とする。 InnerModuleLoading (state, module) を実行する。- pc.[[Promise]] を返す。
<link rel="preload" as="..."> タグに対して正しい fetch destination を設定するために使用される。
import() 式は hostDefined パラメータを決して設定しない。
16.2.1.6.1.1.1 InnerModuleLoading ( state, module )
The
Assert : state.[[IsLoading]] はtrue である。- module が
循環モジュールレコード であり、module.[[Status]] がnew であり、かつ state.[[Visited]] が module を含まない場合、- module を state.[[Visited]] に追加する。
- requestedModulesCount を module.[[RequestedModules]] 内の要素数とする。
- state.[[PendingModulesCount]] を state.[[PendingModulesCount]] + requestedModulesCount に設定する。
- module.[[RequestedModules]] の各
ModuleRequest レコード request について、次を行う。AllImportAttributesSupported (request.[[Attributes]]) がfalse である場合、- error を
ThrowCompletion (新しく作成されたSyntaxError オブジェクト) とする。 ContinueModuleLoading (state, error) を実行する。
- error を
- そうでなく、module.[[LoadedModules]] が、
ModuleRequestsEqual (record, request) がtrue であるようなLoadedModuleRequest レコード record を含む場合、InnerModuleLoading (state, record.[[Module]]) を実行する。
- それ以外の場合、
HostLoadImportedModule (module, request, state.[[HostDefined]], state) を実行する。NOTE :HostLoadImportedModule はFinishLoadingImportedModule を呼び出し、これはContinueModuleLoading を通じてグラフ読み込み処理に再入する。
- state.[[IsLoading]] が
false である場合、unused を返す。
Assert : state.[[PendingModulesCount]] ≥ 1。- state.[[PendingModulesCount]] を state.[[PendingModulesCount]] - 1 に設定する。
- state.[[PendingModulesCount]] = 0 である場合、
- state.[[IsLoading]] を
false に設定する。 - state.[[Visited]] の各
循環モジュールレコード 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
- state.[[IsLoading]] が
false である場合、unused を返す。 - moduleCompletion が正常完了である場合、
InnerModuleLoading (state, moduleCompletion.[[Value]]) を実行する。
- それ以外の場合、
- state.[[IsLoading]] を
false に設定する。 - !
Call (state.[[PromiseCapability]].[[Reject]],undefined , « moduleCompletion.[[Value]] ») を実行する。
- state.[[IsLoading]] を
unused を返す。
16.2.1.6.1.2 Link ( )
The
Assert : module.[[Status]] はunlinked 、linked 、evaluating-async 、またはevaluated のいずれかである。- stack を新しい空の
List とする。 - result を
Completion (InnerModuleLinking (module, stack, 0)) とする。 - result が中途完了である場合、
- stack の各
循環モジュールレコード m について、次を行う。Assert : m.[[Status]] はlinking である。- m.[[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
- module が
循環モジュールレコード でない場合、- ? 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 に追加する。
- module.[[RequestedModules]] の各
ModuleRequest レコード request について、次を行う。- requiredModule を
GetImportedModule (module, request) とする。 - index を ?
InnerModuleLinking (requiredModule, stack, index) に設定する。 - requiredModule が
循環モジュールレコード である場合、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 の最後の要素を削除する。
Assert : requiredModule は循環モジュールレコード である。- requiredModule.[[Status]] を
linked に設定する。 - requiredModule と module が同じ
モジュールレコード である場合、done をtrue に設定する。
- done を
- index を返す。
16.2.1.6.1.3 Evaluate ( )
The
Assert : このEvaluate の呼び出しは、周囲のエージェント内で別の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 完了である。
- module.[[CycleRoot]] が
- module.[[TopLevelCapability]] が
empty でない場合、- module.[[TopLevelCapability]].[[Promise]] を返す。
- stack を新しい空の
List とする。 - capability を !
NewPromiseCapability (%Promise% ) とする。 - module.[[TopLevelCapability]] を capability に設定する。
- result を
Completion (InnerModuleEvaluation (module, stack, 0)) とする。 - result が中途完了である場合、
- stack の各
循環モジュールレコード m について、次を行う。Assert : m.[[Status]] はevaluating である。- m.[[Status]] を
evaluated に設定する。 - m.[[EvaluationError]] を result に設定する。
Assert : module.[[Status]] はevaluated である。Assert : module.[[EvaluationError]] と result は同じCompletion レコードである。- !
Call (capability.[[Reject]],undefined , « result.[[Value]] ») を実行する。
- stack の各
- それ以外の場合、
- capability.[[Promise]] を返す。
16.2.1.6.1.3.1 InnerModuleEvaluation ( module, stack, index )
The
- module が
循環モジュールレコード でない場合、- ?
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 に追加する。
- module.[[RequestedModules]] の各
ModuleRequest レコード request について、次を行う。- requiredModule を
GetImportedModule (module, request) とする。 - index を ?
InnerModuleEvaluation (requiredModule, stack, index) に設定する。 - requiredModule が
循環モジュールレコード である場合、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]] が整数である場合、
- module.[[PendingAsyncDependencies]] を module.[[PendingAsyncDependencies]] + 1 に設定する。
- module を requiredModule.[[AsyncParentModules]] に追加する。
- 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 の最後の要素を削除する。
Assert : requiredModule は循環モジュールレコード である。Assert : requiredModule.[[AsyncEvaluationOrder]] は整数またはunset のいずれかである。- requiredModule.[[AsyncEvaluationOrder]] が
unset である場合、requiredModule.[[Status]] をevaluated に設定する。 - それ以外の場合、requiredModule.[[Status]] を
evaluating-async に設定する。 - requiredModule と module が同じ
モジュールレコード である場合、done をtrue に設定する。 - requiredModule.[[CycleRoot]] を module に設定する。
- done を
- index を返す。
モジュールは、InnerModuleEvaluation によって走査されている間は
非同期サイクルのモジュールに依存している任意のモジュールは、そのサイクルが
16.2.1.6.1.3.2 ExecuteAsyncModule ( module )
The
Assert : module.[[Status]] はevaluating またはevaluating-async のいずれかである。Assert : module.[[HasTLA]] はtrue である。- capability を !
NewPromiseCapability (%Promise% ) とする。 - fulfilledClosure を、パラメータを持たず、module をキャプチャし、呼び出されたときに次の手順を実行する新しい抽象クロージャとする。
AsyncModuleExecutionFulfilled (module) を実行する。NormalCompletion (undefined ) を返す。
- onFulfilled を
CreateBuiltinFunction (fulfilledClosure, 0,"" , « ») とする。 - rejectedClosure を、パラメータ (error) を持ち、module をキャプチャし、呼び出されたときに次の手順を実行する新しい抽象クロージャとする。
AsyncModuleExecutionRejected (module, error) を実行する。NormalCompletion (undefined ) を返す。
- onRejected を
CreateBuiltinFunction (rejectedClosure, 0,"" , « ») とする。 PerformPromiseThen (capability.[[Promise]], onFulfilled, onRejected) を実行する。- ! module.
ExecuteModule (capability) を実行する。 unused を返す。
16.2.1.6.1.3.3 GatherAvailableAncestors ( module, execList )
The
- module.[[AsyncParentModules]] の各
循環モジュールレコード m について、次を行う。- execList が m を含まず、かつ m.[[CycleRoot]].[[EvaluationError]] が
empty である場合、Assert : m.[[Status]] はevaluating-async である。Assert : m.[[EvaluationError]] はempty である。Assert : m.[[AsyncEvaluationOrder]] は整数である。Assert : m.[[PendingAsyncDependencies]] > 0。- m.[[PendingAsyncDependencies]] を m.[[PendingAsyncDependencies]] - 1 に設定する。
- m.[[PendingAsyncDependencies]] = 0 である場合、
- m を execList に追加する。
- m.[[HasTLA]] が
false である場合、GatherAvailableAncestors (m, execList) を実行する。
- execList が m を含まず、かつ m.[[CycleRoot]].[[EvaluationError]] が
unused を返す。
ルート module に対する非同期実行が fulfilled されたとき、この関数は、この完了時に同期的に一緒に実行できるモジュールのリストを決定し、それらを execList に設定する。
16.2.1.6.1.3.4 AsyncModuleExecutionFulfilled ( module )
The
- module.[[Status]] が
evaluated である場合、Assert : module.[[EvaluationError]] はempty でない。unused を返す。
Assert : module.[[Status]] はevaluating-async である。Assert : module.[[AsyncEvaluationOrder]] は整数である。Assert : module.[[EvaluationError]] はempty である。- module.[[AsyncEvaluationOrder]] を
done に設定する。 - module.[[Status]] を
evaluated に設定する。 - module.[[TopLevelCapability]] が
empty でない場合、 - execList を新しい空の
List とする。 GatherAvailableAncestors (module, execList) を実行する。Assert : execList のすべての要素は、その [[AsyncEvaluationOrder]] フィールドが整数に設定され、[[PendingAsyncDependencies]] フィールドが 0 に設定され、[[EvaluationError]] フィールドがempty に設定されている。- sortedExecList を、execList の要素を [[AsyncEvaluationOrder]] フィールドの昇順でソートした要素からなる
List とする。 - sortedExecList の各
循環モジュールレコード m について、次を行う。- m.[[Status]] が
evaluated である場合、Assert : m.[[EvaluationError]] はempty でない。
- そうでなく、m.[[HasTLA]] が
true である場合、ExecuteAsyncModule (m) を実行する。
- それ以外の場合、
- result を
Completion (m.ExecuteModule ()) とする。 - result が中途完了である場合、
AsyncModuleExecutionRejected (m, result.[[Value]]) を実行する。
- それ以外の場合、
- result を
- m.[[Status]] が
unused を返す。
16.2.1.6.1.3.5 AsyncModuleExecutionRejected ( module, error )
The
- module.[[Status]] が
evaluated である場合、Assert : module.[[EvaluationError]] はempty でない。unused を返す。
Assert : module.[[Status]] はevaluating-async である。Assert : module.[[AsyncEvaluationOrder]] は整数である。Assert : module.[[EvaluationError]] はempty である。- module.[[EvaluationError]] を
ThrowCompletion (error) に設定する。 - module.[[Status]] を
evaluated に設定する。 - module.[[AsyncEvaluationOrder]] を
done に設定する。 NOTE : module.[[AsyncEvaluationOrder]] はAsyncModuleExecutionFulfilled との対称性のためにdone に設定される。InnerModuleEvaluation では、モジュールの [[AsyncEvaluationOrder]] 内部スロットの値は、その [[EvaluationError]] 内部スロットがempty でない場合には使用されない。- module.[[TopLevelCapability]] が
empty でない場合、 - module.[[AsyncParentModules]] の各
循環モジュールレコード m について、次を行う。AsyncModuleExecutionRejected (m, error) を実行する。
unused を返す。
16.2.1.6.2 循環モジュールレコードグラフの例
この非規範的な節では、いくつかの一般的なモジュールグラフのリンクおよび評価について、特にエラーがどのように発生し得るかに焦点を当てて、一連の例を示す。
まず、次の単純なモジュールグラフを考える。
まずエラー条件がないと仮定する。ホストが最初に A.
次に、A.
最後に、
次に、別の種類のエラー条件を考える。
このシナリオでは、モジュール A は他のあるモジュールへの依存関係を宣言しているが、そのモジュールの
ここでの読み込み、リンク、評価エラーの違いは、次の特性による。
- 評価は副作用を引き起こし得るため、一度だけ実行されなければならない。したがって、たとえ失敗したとしても、評価がすでに実行されたかどうかを記憶することが重要である。（エラーの場合、例外も記憶するのが理にかなっている。そうしなければ、後続の
Evaluate () 呼び出しが新しい例外を合成しなければならなくなるためである。） - 一方、リンクには副作用がないため、失敗しても、後の時点で問題なく再試行できる。
- 読み込みはホストと密接に相互作用するため、ホストによっては、失敗した読み込みをユーザーが再試行できるようにすることが望ましい場合がある（例えば、一時的に悪いネットワーク状態によって失敗が引き起こされた場合）。
次に、サイクルを持つモジュールグラフを考える。
ここではエントリポイントがモジュール A であると仮定するため、ホストは A.
次にホストは A.
循環モジュールグラフの評価段階についても、成功の場合には同様の話が成り立つ。
ここで、A にリンクエラーがある場合を考える。例えば、C に存在しない束縛をインポートしようとする場合である。その場合、A に対する
あるいは、A に評価エラーがある場合を考える。例えば、そのソースコードが例外を投げる場合である。その場合、上記の手順の評価時の類似物は、A に対する await を含む、またはそれに依存するモジュールについて、
最後に、すべてのモジュールが非同期に完了する、サイクルを持つモジュールグラフを考える。
読み込みおよびリンクは以前と同様に発生し、すべてのモジュールは [[Status]] が
A.
|
フィールド
|
A | B | C | D | E |
|---|---|---|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 | 0 | 0 | 4 |
| [[Status]] | |||||
| [[AsyncEvaluationOrder]] | 4 | 1 | 3 | 0 | 2 |
| [[AsyncParentModules]] | « » | « A » | « A » | « B, C » | « C » |
| [[PendingAsyncDependencies]] | 2（B および C） | 1（D） | 2（D および E） | 0 | 0 |
E が最初に実行を完了すると仮定する。それが起こると、
|
フィールド
|
C | E |
|---|---|---|
| [[DFSAncestorIndex]] | 0 | 4 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | 3 | |
| [[AsyncParentModules]] | « A » | « C » |
| [[PendingAsyncDependencies]] | 1（D） | 0 |
次に D が完了する（まだ実行中だった唯一のモジュールであったため）。それが起こると、await を含む場合、B と並行する可能性がある）。更新されたモジュールのフィールドは
|
フィールド
|
B | C | D |
|---|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 | 0 |
| [[Status]] | |||
| [[AsyncEvaluationOrder]] | 1 | 3 | |
| [[AsyncParentModules]] | « A » | « A » | « B, C » |
| [[PendingAsyncDependencies]] | 0 | 0 | 0 |
次に C が実行を完了すると仮定する。それが起こると、
|
フィールド
|
A | C |
|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | 4 | |
| [[AsyncParentModules]] | « » | « A » |
| [[PendingAsyncDependencies]] | 1（B） | 0 |
その後、B が実行を完了する。それが起こると、
|
フィールド
|
A | B |
|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | 4 | |
| [[AsyncParentModules]] | « » | « A » |
| [[PendingAsyncDependencies]] | 0 | 0 |
最後に、A が実行を完了する。それが起こると、
|
フィールド
|
A |
|---|---|
| [[DFSAncestorIndex]] | 0 |
| [[Status]] | |
| [[AsyncEvaluationOrder]] | |
| [[AsyncParentModules]] | « » |
| [[PendingAsyncDependencies]] | 0 |
あるいは、B が実行を完了する前に C が実行に失敗してエラーを返す失敗の場合を考える。それが起こると、
|
フィールド
|
A | C |
|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | ||
| [[AsyncParentModules]] | « » | « A » |
| [[PendingAsyncDependencies]] | 1（B） | 0 |
| [[EvaluationError]] | C の評価エラー |
C は C のエラーで A に対して
|
フィールド
|
A |
|---|---|
| [[DFSAncestorIndex]] | 0 |
| [[Status]] | |
| [[AsyncEvaluationOrder]] | |
| [[AsyncParentModules]] | « » |
| [[PendingAsyncDependencies]] | 0 |
| [[EvaluationError]] | C の評価エラー |
その後、B はエラーなしで実行を完了する。それが起こると、
|
フィールド
|
A | B |
|---|---|---|
| [[DFSAncestorIndex]] | 0 | 0 |
| [[Status]] | ||
| [[AsyncEvaluationOrder]] | 4 | 1 |
| [[AsyncParentModules]] | « » | « A » |
| [[PendingAsyncDependencies]] | 0 | 0 |
| [[EvaluationError]] | C の評価エラー |
16.2.1.7 ソーステキストモジュールレコード
ソーステキストモジュールレコードは、目標記号
| フィールド名 | 値の型 | 意味 |
|---|---|---|
| [[ECMAScriptCode]] |
|
目標記号として |
| [[Context]] |
ECMAScript コード実行コンテキストまたは |
このモジュールに関連付けられた実行コンテキスト。モジュールの環境が初期化されるまでは |
| [[ImportMeta]] |
Object または |
import.meta メタプロパティを通じて公開されるオブジェクト。ECMAScript コードからアクセスされるまでは |
| [[ImportEntries]] |
|
このモジュールのコードから導出された |
| [[LocalExportEntries]] |
|
モジュール内で出現する宣言に対応する、このモジュールのコードから導出された |
| [[IndirectExportEntries]] |
|
モジュール内で出現する再エクスポートされたインポート、または export * as namespace 宣言からのエクスポートに対応する、このモジュールのコードから導出された |
| [[StarExportEntries]] |
|
モジュール内で出現する export * 宣言に対応する、このモジュールのコードから導出された export * as namespace 宣言は含まない。
|
ImportEntry レコードは、単一の宣言的インポートに関する情報を要約するレコードである。各
| フィールド名 | 値の型 | 意味 |
|---|---|---|
| [[ModuleRequest]] |
|
|
| [[ImportName]] |
String または |
[[ModuleRequest]] によって識別されるモジュールによって、目的の束縛がエクスポートされている名前。値 |
| [[LocalName]] | String | インポートするモジュール内で、インポートされた値にローカルにアクセスするために使用される名前。 |
| インポート文形式 | [[ModuleRequest]] | [[ImportName]] | [[LocalName]] |
|---|---|---|---|
import v from "mod";
|
|
|
|
import * as ns from "mod";
|
|
|
|
import {x} from "mod";
|
|
|
|
import {x as v} from "mod";
|
|
|
|
import "mod";
|
|
||
ExportEntry レコードは、単一の宣言的エクスポートに関する情報を要約するレコードである。各
| フィールド名 | 値の型 | 意味 |
|---|---|---|
| [[ExportName]] |
String または |
このモジュールによってこの束縛をエクスポートするために使用される名前。 |
| [[ModuleRequest]] |
|
|
| [[ImportName]] |
String、 |
[[ModuleRequest]] によって識別されるモジュールによって、目的の束縛がエクスポートされている名前。export * as ns from "mod" 宣言に使用される。export * from "mod" 宣言に使用される。
|
| [[LocalName]] |
String または |
インポートするモジュール内で、エクスポートされた値にローカルにアクセスするために使用される名前。エクスポートされた値がモジュール内からローカルにアクセス可能でない場合は |
| エクスポート文形式 | [[ExportName]] | [[ModuleRequest]] | [[ImportName]] | [[LocalName]] |
|---|---|---|---|---|
export var v;
|
|
|
|
|
export default function f() {}
|
|
|
|
|
export default function () {}
|
|
|
|
|
export default 42;
|
|
|
|
|
export {x};
|
|
|
|
|
export {v as x};
|
|
|
|
|
export {x} from "mod";
|
|
|
|
|
export {v as x} from "mod";
|
|
|
|
|
export * from "mod";
|
|
|
|
|
export * as ns from "mod";
|
|
|
|
|
以下の定義は、
16.2.1.7.1 ParseModule ( sourceText, realm, hostDefined )
The
- body を
ParseText (sourceText,Module ) とする。 - body がエラーの
List である場合、body を返す。 - requestedModules を body の
ModuleRequests とする。 - importEntries を body の
ImportEntries とする。 - importedBoundNames を
ImportedLocalNames (importEntries) とする。 - indirectExportEntries を新しい空の
List とする。 - localExportEntries を新しい空の
List とする。 - starExportEntries を新しい空の
List とする。 - exportEntries を body の
ExportEntries とする。 - exportEntries の各
ExportEntry レコード ee について、次を行う。- ee.[[ModuleRequest]] が
null である場合、- importedBoundNames が ee.[[LocalName]] を含まない場合、
- ee を localExportEntries に追加する。
- それ以外の場合、
NOTE : もともと別のモジュールからインポートされた束縛または名前空間オブジェクトをエクスポートする場合、ExportEntry レコード は、その束縛または名前空間オブジェクトがインポートされてからエクスポートされたのではなく、元のモジュールから直接再エクスポートされた場合に持つであろう形式に一致するように書き換えられる。これにより、export * fromを通じて同じ束縛または名前空間を同じ名前で二重にエクスポートすることから生じる競合 は、ソーステキストモジュールレコードの ResolveExport 具象メソッド のステップ9.e.iii で曖昧として扱われるのではなく、無視できるようになる。- ie を、[[LocalName]] が ee.[[LocalName]] である importEntries の要素とする。
ExportEntry レコード { [[ModuleRequest]]: ie.[[ModuleRequest]], [[ImportName]]: ie.[[ImportName]], [[LocalName]]:null , [[ExportName]]: ee.[[ExportName]] } を indirectExportEntries に追加する。
- importedBoundNames が ee.[[LocalName]] を含まない場合、
- そうでなく、ee.[[ImportName]] が
all-but-default である場合、Assert : ee.[[ExportName]] はnull である。- ee を starExportEntries に追加する。
- それ以外の場合、
- ee を indirectExportEntries に追加する。
- ee.[[ModuleRequest]] が
- async を body
Contains awaitとする。 - Source Text Module
Record { [[Realm]]: realm, [[Environment]]:empty , [[Namespace]]:empty , [[CycleRoot]]:empty , [[HasTLA]]: async, [[AsyncEvaluationOrder]]:unset , [[TopLevelCapability]]:empty , [[AsyncParentModules]]: « », [[PendingAsyncDependencies]]:empty , [[Status]]:new , [[EvaluationError]]:empty , [[HostDefined]]: hostDefined, [[ECMAScriptCode]]: body, [[Context]]:empty , [[ImportMeta]]:empty , [[RequestedModules]]: requestedModules, [[LoadedModules]]: « », [[ImportEntries]]: importEntries, [[LocalExportEntries]]: localExportEntries, [[IndirectExportEntries]]: indirectExportEntries, [[StarExportEntries]]: starExportEntries, [[DFSAncestorIndex]]:empty } を返す。
実装は、そのモジュールソーステキストに対する ParseModule の評価より前に、モジュールソーステキストを解析し、早期エラー条件について解析してもよい。ただし、いかなるエラーの報告も、この仕様が実際にそのソーステキストに対して ParseModule を実行する時点まで延期されなければならない。
16.2.1.7.2 モジュールレコード抽象メソッドの実装
以下は、
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 レコード e について、次を行う。 - module.[[IndirectExportEntries]] の各
ExportEntry レコード e について、次を行う。 - module.[[StarExportEntries]] の各
ExportEntry レコード e について、次を行う。Assert : e.[[ModuleRequest]] はnull ではない。- requestedModule を
GetImportedModule (module, e.[[ModuleRequest]]) とする。 - starNames を requestedModule.
GetExportedNames (exportStarSet) とする。 - starNames の各要素 n について、次を行う。
- n が
"default" でない場合、- exportedNames が n を含まない場合、
- n を exportedNames に追加する。
- exportedNames が n を含まない場合、
- n が
- exportedNames を返す。
16.2.1.7.2.2 ResolveExport ( exportName [ , resolveSet ] )
The
定義モジュールが見つかった場合、ResolvedBinding レコード { [[Module]], [[BindingName]] } が返される。このレコードは、もともと要求されたエクスポートの解決済み束縛を識別する。ただし、これがローカル束縛を持たない名前空間のエクスポートである場合を除く。この場合、[[BindingName]] は
It performs the following steps when called:
Assert : module.[[Status]] はnew ではない。- resolveSet が存在しない場合、resolveSet を新しい空の
List に設定する。 - resolveSet の各
Record { [[Module]], [[ExportName]] } r について、次を行う。 Record { [[Module]]: module, [[ExportName]]: exportName } を resolveSet に追加する。- module.[[LocalExportEntries]] の各
ExportEntry レコード e について、次を行う。- e.[[ExportName]] が exportName である場合、
Assert : module はこのエクスポートの直接束縛を提供する。- ResolvedBinding レコード { [[Module]]: module, [[BindingName]]: e.[[LocalName]] } を返す。
- e.[[ExportName]] が exportName である場合、
- module.[[IndirectExportEntries]] の各
ExportEntry レコード e について、次を行う。- e.[[ExportName]] が exportName である場合、
Assert : e.[[ModuleRequest]] はnull ではない。- importedModule を
GetImportedModule (module, e.[[ModuleRequest]]) とする。 - e.[[ImportName]] が
namespace である場合、Assert : module はこのエクスポートの直接束縛を提供しない。- ResolvedBinding レコード { [[Module]]: importedModule, [[BindingName]]:
namespace } を返す。
Assert : module はこのエクスポートのために特定の束縛をインポートする。Assert : e.[[ImportName]] は String である。- importedModule.
ResolveExport (e.[[ImportName]], resolveSet) を返す。
- e.[[ExportName]] が exportName である場合、
- exportName が
"default" である場合、 - starResolution を
null とする。 - module.[[StarExportEntries]] の各
ExportEntry レコード e について、次を行う。Assert : e.[[ModuleRequest]] はnull ではない。- importedModule を
GetImportedModule (module, e.[[ModuleRequest]]) とする。 - resolution を importedModule.
ResolveExport (exportName, resolveSet) とする。 - resolution が
ambiguous である場合、ambiguous を返す。 - resolution が
null でない場合、Assert : resolution は ResolvedBinding レコードである。- starResolution が
null である場合、- starResolution を resolution に設定する。
- それ以外の場合、
- starResolution を返す。
16.2.1.7.3 循環モジュールレコード抽象メソッドの実装
以下は、
16.2.1.7.3.1 InitializeEnvironment ( )
The
- module.[[IndirectExportEntries]] の各
ExportEntry レコード e について、次を行う。Assert : e.[[ExportName]] はnull ではない。- resolution を module.
ResolveExport (e.[[ExportName]]) とする。 - resolution が
null またはambiguous のいずれかである場合、SyntaxError 例外を投げる。 Assert : resolution は ResolvedBinding レコードである。
Assert : module からのすべての名前付きエクスポートは解決可能である。- realm を module.[[Realm]] とする。
Assert : realm はundefined ではない。- env を
NewModuleEnvironment (realm.[[GlobalEnv]]) とする。 - module.[[Environment]] を env に設定する。
- module.[[ImportEntries]] の各
ImportEntry レコード in について、次を行う。- importedModule を
GetImportedModule (module, in.[[ModuleRequest]]) とする。 - in.[[ImportName]] が
namespace である場合、- namespace を
GetModuleNamespace (importedModule) とする。 - ! env.
CreateImmutableBinding (in.[[LocalName]],true ) を実行する。 - ! env.
InitializeBinding (in.[[LocalName]], namespace) を実行する。
- namespace を
- それ以外の場合、
Assert : in.[[ImportName]] は String である。- resolution を importedModule.
ResolveExport (in.[[ImportName]]) とする。 - resolution が
null またはambiguous のいずれかである場合、SyntaxError 例外を投げる。 - resolution.[[BindingName]] が
namespace である場合、- namespace を
GetModuleNamespace (resolution.[[Module]]) とする。 - ! env.
CreateImmutableBinding (in.[[LocalName]],true ) を実行する。 - ! env.
InitializeBinding (in.[[LocalName]], namespace) を実行する。
- namespace を
- それ以外の場合、
CreateImportBinding (env, in.[[LocalName]], resolution.[[Module]], resolution.[[BindingName]]) を実行する。
- importedModule を
- 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 は現在の実行中の実行コンテキストである。
- code を module.[[ECMAScriptCode]] とする。
- varDeclarations を code の
VarScopedDeclarations とする。 - declaredVarNames を新しい空の
List とする。 - varDeclarations の各要素 d について、次を行う。
- d の
BoundNames の各要素 dn について、次を行う。- declaredVarNames が dn を含まない場合、
- ! env.
CreateMutableBinding (dn,false ) を実行する。 - ! env.
InitializeBinding (dn,undefined ) を実行する。 - dn を declaredVarNames に追加する。
- ! env.
- declaredVarNames が dn を含まない場合、
- d の
- lexDeclarations を code の
LexicallyScopedDeclarations とする。 - privateEnv を
null とする。 - lexDeclarations の各要素 d について、次を行う。
- d の
BoundNames の各要素 dn について、次を行う。- d の
IsConstantDeclaration がtrue である場合、- ! env.
CreateImmutableBinding (dn,true ) を実行する。
- ! env.
- それ以外の場合、
- ! env.
CreateMutableBinding (dn,false ) を実行する。
- ! env.
- d が
FunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 、またはAsyncGeneratorDeclaration のいずれかである場合、- fo を、引数 env および privateEnv を伴う d の
InstantiateFunctionObject とする。 - ! env.
InitializeBinding (dn, fo) を実行する。
- fo を、引数 env および privateEnv を伴う d の
- d の
- d の
- 実行コンテキストスタックから moduleContext を削除する。
unused を返す。
16.2.1.7.3.2 ExecuteModule ( [ capability ] )
The
Assert : module はリンク済みであり、そのモジュール環境内の宣言はインスタンス化済みである。- moduleContext を module.[[Context]] とする。
- module.[[HasTLA]] が
false である場合、Assert : capability は存在しない。- 実行中の実行コンテキストを中断する。
- moduleContext を実行コンテキストスタックにプッシュする。moduleContext は現在の実行中の実行コンテキストである。
- result を
Completion (module.[[ECMAScriptCode]] のEvaluation ) とする。 - moduleContext を中断し、実行コンテキストスタックから削除する。
- 実行コンテキストスタックの最上位にあるコンテキストを実行中の実行コンテキストとして再開する。
- result が中途完了である場合、
- ? result を返す。
- それ以外の場合、
Assert : capability は PromiseCapability レコードである。AsyncBlockStart (capability, module.[[ECMAScriptCode]], moduleContext) を実行する。
unused を返す。
16.2.1.8 合成モジュールレコード
合成モジュールレコードは、仕様によって定義されたモジュールに関する情報を表すために使用される。そのエクスポート名は作成時に静的に定義されるが、それに対応する値は
| フィールド名 | 値の型 | 意味 |
|---|---|---|
| [[ExportNames]] | String の |
このモジュールのエクスポート名。このリストには重複は含まれない。 |
| [[EvaluationSteps]] | 抽象クロージャ | モジュール評価時に実行される初期化ロジックであり、唯一の引数として |
16.2.1.8.1 CreateDefaultExportSyntheticModule ( defaultExport )
The
- realm を現在の
Realm レコードとする。 - setDefaultExport を、引数 (module) を取り defaultExport をキャプチャする新しい抽象クロージャとし、呼び出されたときに以下を実行する：
SetSyntheticModuleExport (module,"default" , defaultExport) を実行する。NormalCompletion (unused ) を返す。
合成モジュールレコード { [[Realm]]: realm, [[Environment]]:empty , [[Namespace]]:empty , [[HostDefined]]:undefined , [[ExportNames]]: «"default" », [[EvaluationSteps]]: setDefaultExport } を返す。
16.2.1.8.2 ParseJSONModule ( source )
The
- parseResult を ?
ParseJSON (source) とする。 CreateDefaultExportSyntheticModule (parseResult.[[Value]]) を返す。
16.2.1.8.3 SetSyntheticModuleExport ( module, exportName, exportValue )
The
Assert : module.[[ExportNames]] は exportName を含む。- envRec を module.[[Environment]] とする。
Assert : envRec はempty ではない。- ! envRec.
SetMutableBinding (exportName, exportValue,true ) を実行する。 unused を返す。
16.2.1.8.4 モジュールレコード抽象メソッドの実装
以下は、
16.2.1.8.4.1 LoadRequestedModules ( [ hostDefined ] )
The
NOTE : このLoadRequestedModules の実装は hostDefined を使用しない。- !
PromiseResolve (%Promise% ,undefined ) を返す。
16.2.1.8.4.2 GetExportedNames ( [ exportStarSet ] )
The
NOTE : このGetExportedNames の実装は exportStarSet を使用しない。- module.[[ExportNames]] を返す。
16.2.1.8.4.3 ResolveExport ( exportName [ , resolveSet ] )
The
NOTE : このResolveExport の実装は resolveSet を使用しない。- module.[[ExportNames]] が exportName を含まない場合、
null を返す。 - ResolvedBinding レコード { [[Module]]: module, [[BindingName]]: exportName } を返す。
16.2.1.8.4.4 Link ( )
The
- realm を module.[[Realm]] とする。
- env を
NewModuleEnvironment (realm.[[GlobalEnv]]) とする。 - module.[[Environment]] を env に設定する。
- module.[[ExportNames]] の各 String exportName について、次を行う。
- ! env.
CreateMutableBinding (exportName,false ) を実行する。 - ! env.
InitializeBinding (exportName,undefined ) を実行する。
- ! env.
NormalCompletion (unused ) を返す。
16.2.1.8.4.5 Evaluate ( )
The
- moduleContext を新しい ECMAScript コード実行コンテキストとする。
- moduleContext の Function を
null に設定する。 - moduleContext の
Realm を module.[[Realm]] に設定する。 - moduleContext の ScriptOrModule を module に設定する。
- moduleContext の VariableEnvironment を module.[[Environment]] に設定する。
- moduleContext の LexicalEnvironment を module.[[Environment]] に設定する。
- 実行中の実行コンテキストを中断する。
- moduleContext を実行コンテキストスタックにプッシュする。moduleContext は現在の実行中の実行コンテキストである。
- steps を module.[[EvaluationSteps]] とする。
- result を
Completion (steps(module)) とする。 - moduleContext を中断し、実行コンテキストスタックから削除する。
- 実行コンテキストスタックの最上位にあるコンテキストを実行中の実行コンテキストとして再開する。
- pc を !
NewPromiseCapability (%Promise% ) とする。 IfAbruptRejectPromise (result, pc)。- !
Call (pc.[[Resolve]],undefined , «undefined ») を実行する。 - pc.[[Promise]] を返す。
16.2.1.9 GetImportedModule ( referrer, request )
The
- records を、referrer.[[LoadedModules]] の各
LoadedModuleRequest レコード r のうちModuleRequestsEqual (r, request) がtrue であるものからなるList とする。 Assert : この抽象操作を呼び出す前に referrer に対してLoadRequestedModules が正常に完了しているため、records はちょうど 1 要素を持つ。- record を records の唯一の要素とする。
- record.[[Module]] を返す。
16.2.1.10 HostLoadImportedModule ( referrer, moduleRequest, hostDefined, payload )
The
HostLoadImportedModule の実装は、以下の要件に従わなければならない：
-
ホスト環境は
FinishLoadingImportedModule (referrer, moduleRequest, payload, result) を実行しなければならない。ここで result は、ロードされたモジュールレコード を含む正常完了、または throw 完了のいずれかであり、同期または非同期で行われ得る。 -
この操作が、次の条件を満たす 2 つの (referrer, moduleRequest) の組に対して複数回呼び出される場合：
- 最初の referrer が 2 番目の referrer と同一である；
ModuleRequestsEqual (最初の moduleRequest, 2 番目の moduleRequest) がtrue である；
そして
FinishLoadingImportedModule (referrer, moduleRequest, payload, result) を実行し、result が正常完了である場合、毎回同じ result を用いてFinishLoadingImportedModule を実行しなければならない。 -
moduleRequest.[[Attributes]] において、entry.[[Key]] が
"type" かつ entry.[[Value]] が"json" であるエントリ entry が存在する場合、ホスト環境がFinishLoadingImportedModule (referrer, moduleRequest, payload, result) を実行する際、result はParseJSONModule の呼び出しによって返されたCompletion Record 、または throw 完了のいずれかでなければならない。 -
この操作は、payload を不透明な値として扱い、そのまま
FinishLoadingImportedModule に渡さなければならない。
実際に行われる処理はホスト定義であるが、通常は適切な
上記のテキストは、type: "json" でインポートされた場合にホストが JSON モジュールをサポートすること（かつ HostLoadImportedModule が正常完了すること）を要求しているが、type: "json" を指定せずにインポートされた場合に JSON モジュールをサポートすることを禁止するものではない。
16.2.1.11 FinishLoadingImportedModule ( referrer, moduleRequest, payload, result )
The
- result が正常完了である場合、
- referrer.[[LoadedModules]] において、
ModuleRequestsEqual (record, moduleRequest) がtrue であるLoadedModuleRequest レコード record が含まれている場合、 - それ以外の場合、
LoadedModuleRequest レコード { [[Specifier]]: moduleRequest.[[Specifier]], [[Attributes]]: moduleRequest.[[Attributes]], [[Module]]: result.[[Value]] } を referrer.[[LoadedModules]] に追加する。
- referrer.[[LoadedModules]] において、
- payload が
GraphLoadingState レコード である場合、ContinueModuleLoading (payload, result) を実行する。
- それ以外の場合、
ContinueDynamicImport (payload, result) を実行する。
unused を返す。
16.2.1.12 AllImportAttributesSupported ( attributes )
The
- supported を
HostGetSupportedImportAttributes () とする。 - attributes の各
ImportAttribute レコード attribute について、次を行う。- supported が attribute.[[Key]] を含まない場合、
false を返す。
- supported が attribute.[[Key]] を含まない場合、
true を返す。
16.2.1.12.1 HostGetSupportedImportAttributes ( )
The
HostGetSupportedImportAttributes の実装は、以下の要件に従わなければならない：
HostGetSupportedImportAttributes のデフォルト実装は、新しい空の
16.2.1.13 GetModuleNamespace ( module )
The
Assert : module が循環モジュールレコード である場合、module.[[Status]] はnew またはunlinked ではない。- namespace を module.[[Namespace]] とする。
- namespace が
empty である場合、- exportedNames を module.
GetExportedNames () とする。 - unambiguousNames を新しい空の
List とする。 - exportedNames の各要素 name について、次を行う。
- resolution を module.
ResolveExport (name) とする。 - resolution が ResolvedBinding レコードである場合、name を unambiguousNames に追加する。
- resolution を module.
- namespace を
ModuleNamespaceCreate (module, unambiguousNames) とする。
- exportedNames を module.
- namespace を返す。
GetModuleNamespace は決して例外を投げない。その代わり、この時点では解決不能な名前は単に名前空間から除外される。それらは、どこからも明示的に要求されていない曖昧なスターエクスポートのみでない限り、後に実際のリンクエラーを引き起こす。
16.2.1.14 Runtime Semantics: 評価
undefined を返す。
- result を
Completion (ModuleItemList のEvaluation ) とする。 - result が正常完了であり、かつ result.[[Value]] が
empty の場合、undefined を返す。
- ? result を返す。
- sl を ?
ModuleItemList のEvaluation とする。 - s を
Completion (ModuleItem のEvaluation ) とする。 - ?
UpdateEmpty (s, sl) を返す。
empty を返す。
16.2.2 インポート
構文
16.2.2.1 Static Semantics: 早期エラー
-
ImportDeclaration のBoundNames に重複するエントリが含まれている場合、これは Syntax Error である。
-
WithClause のWithClauseToAttributes に、a.[[Key]] が b.[[Key]] であるような2つの異なるエントリ a と b がある場合、これは Syntax Error である。
16.2.2.2 Static Semantics: ImportEntries
The
- 新しい空の
List を返す。
- entries1 を
ModuleItemList のImportEntries とする。 - entries2 を
ModuleItem のImportEntries とする。 - entries1 と entries2 のリスト連結を返す。
- 新しい空の
List を返す。
- module を
ImportDeclaration のModuleRequests の唯一の要素とする。 - 引数 module を用いた
ImportClause のImportEntriesForModule を返す。
- 新しい空の
List を返す。
16.2.2.3 Static Semantics: ImportEntriesForModule
The
- entries1 を、引数 module を用いた
ImportedDefaultBinding のImportEntriesForModule とする。 - entries2 を、引数 module を用いた
NameSpaceImport のImportEntriesForModule とする。 - entries1 と entries2 のリスト連結を返す。
- entries1 を、引数 module を用いた
ImportedDefaultBinding のImportEntriesForModule とする。 - entries2 を、引数 module を用いた
NamedImports のImportEntriesForModule とする。 - entries1 と entries2 のリスト連結を返す。
- localName を
ImportedBinding のBoundNames の唯一の要素とする。 - defaultEntry を
ImportEntry レコード { [[ModuleRequest]]: module, [[ImportName]]:"default" , [[LocalName]]: localName } とする。 - « defaultEntry » を返す。
- localName を
ImportedBinding のStringValue とする。 - entry を
ImportEntry レコード { [[ModuleRequest]]: module, [[ImportName]]:namespace , [[LocalName]]: localName } とする。 - « entry » を返す。
- 新しい空の
List を返す。
- specs1 を、引数 module を用いた
ImportsList のImportEntriesForModule とする。 - specs2 を、引数 module を用いた
ImportSpecifier のImportEntriesForModule とする。 - specs1 と specs2 のリスト連結を返す。
- localName を
ImportedBinding のBoundNames の唯一の要素とする。 - entry を
ImportEntry レコード { [[ModuleRequest]]: module, [[ImportName]]: localName, [[LocalName]]: localName } とする。 - « entry » を返す。
- importName を
ModuleExportName のStringValue とする。 - localName を
ImportedBinding のStringValue とする。 - entry を
ImportEntry レコード { [[ModuleRequest]]: module, [[ImportName]]: importName, [[LocalName]]: localName } とする。 - « entry » を返す。
16.2.2.4 Static Semantics: WithClauseToAttributes
The
- 新しい空の
List を返す。
- attributes を
WithEntries のWithClauseToAttributes とする。 - attributes をそれらの [[Key]] フィールドの辞書式順序に従ってソートし、そのような各フィールドの値を UTF-16 コード単位値のシーケンスとして扱う。注: このソートが観測可能なのは、ホストが属性の列挙順序に基づいて振る舞いを変更することを禁止されているという点に限られる。
- attributes を返す。
- key を
AttributeKey のPropName とする。 - entry を
ImportAttribute レコード { [[Key]]: key, [[Value]]:StringLiteral のSV } とする。 - « entry » を返す。
- key を
AttributeKey のPropName とする。 - entry を
ImportAttribute レコード { [[Key]]: key, [[Value]]:StringLiteral のSV } とする。 - rest を
WithEntries のWithClauseToAttributes とする。 - « entry » と rest のリスト連結を返す。
16.2.3 エクスポート
構文
16.2.3.1 Static Semantics: 早期エラー
-
NamedExports のReferencedBindings にStringLiteral が含まれている場合、これは Syntax Error である。 -
NamedExports のReferencedBindings 内の各IdentifierName n について: n のStringValue がReservedWord である、または n のStringValue が"implements" 、"interface" 、"let" 、"package" 、"private" 、"protected" 、"public" 、"static" のいずれかである場合、これは Syntax Error である。
上記の規則は、
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 を返す。
- 新しい空の
List を返す。
NamedExports のExportedBindings を返す。
VariableStatement のBoundNames を返す。
Declaration のBoundNames を返す。
- この
ExportDeclaration のBoundNames を返す。
- 新しい空の
List を返す。
- names1 を
ExportsList のExportedBindings とする。 - names2 を
ExportSpecifier のExportedBindings とする。 - names1 と names2 のリスト連結を返す。
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 のリスト連結を返す。
ExportDeclaration のExportedNames を返す。
- 新しい空の
List を返す。
ExportFromClause のExportedNames を返す。
- 新しい空の
List を返す。
ModuleExportName のStringValue を唯一の要素とするList を返す。
NamedExports のExportedNames を返す。
VariableStatement のBoundNames を返す。
Declaration のBoundNames を返す。
- «
"default" » を返す。
- 新しい空の
List を返す。
- names1 を
ExportsList のExportedNames とする。 - names2 を
ExportSpecifier のExportedNames とする。 - names1 と names2 のリスト連結を返す。
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 を返す。
- module を
ExportDeclaration のModuleRequests の唯一の要素とする。 - 引数 module を用いた
ExportFromClause のExportEntriesForModule を返す。
- 引数
null を用いたNamedExports のExportEntriesForModule を返す。
- entries を新しい空の
List とする。 - names を
VariableStatement のBoundNames とする。 - names の各要素 name について、次を行う。
ExportEntry レコード { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]: name, [[ExportName]]: name } を entries に追加する。
- entries を返す。
- entries を新しい空の
List とする。 - names を
Declaration のBoundNames とする。 - names の各要素 name について、次を行う。
ExportEntry レコード { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]: name, [[ExportName]]: name } を entries に追加する。
- entries を返す。
- names を
HoistableDeclaration のBoundNames とする。 - localName を names の唯一の要素とする。
- 新しい
ExportEntry レコード { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]: localName, [[ExportName]]:"default" } を唯一の要素とするList を返す。
- names を
ClassDeclaration のBoundNames とする。 - localName を names の唯一の要素とする。
- 新しい
ExportEntry レコード { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]: localName, [[ExportName]]:"default" } を唯一の要素とするList を返す。
- entry を
ExportEntry レコード { [[ModuleRequest]]:null , [[ImportName]]:null , [[LocalName]]:"*default*" , [[ExportName]]:"default" } とする。 - « entry » を返す。
16.2.3.5 Static Semantics: ExportEntriesForModule
The
- entry を
ExportEntry レコード { [[ModuleRequest]]: module, [[ImportName]]:all-but-default , [[LocalName]]:null , [[ExportName]]:null } とする。 - « entry » を返す。
- exportName を
ModuleExportName のStringValue とする。 - entry を
ExportEntry レコード { [[ModuleRequest]]: module, [[ImportName]]:namespace , [[LocalName]]:null , [[ExportName]]: exportName } とする。 - « entry » を返す。
- 新しい空の
List を返す。
- specs1 を、引数 module を用いた
ExportsList のExportEntriesForModule とする。 - specs2 を、引数 module を用いた
ExportSpecifier のExportEntriesForModule とする。 - specs1 と specs2 のリスト連結を返す。
- sourceName を
ModuleExportName のStringValue とする。 - module が
null である場合、- localName を sourceName とする。
- importName を
null とする。
- それ以外の場合、
- localName を
null とする。 - importName を sourceName とする。
- localName を
- 新しい
ExportEntry レコード { [[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 レコード { [[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 のリスト連結を返す。
- 最初の
ModuleExportName のReferencedBindings を返す。
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*" である場合、- env を実行中の実行コンテキストの LexicalEnvironment とする。
InitializeBoundName ("*default*" , value, env) を ? で実行する。
empty を返す。
IsAnonymousFunctionDefinition (AssignmentExpression ) がtrue である場合、- value を、引数
"default" を用いたAssignmentExpression のNamedEvaluation の ? 結果とする。
- value を、引数
- それ以外の場合、
- rhs を
AssignmentExpression のEvaluation の ? 結果とする。 - value を
GetValue (rhs) の ? 結果とする。
- rhs を
- env を実行中の実行コンテキストの LexicalEnvironment とする。
InitializeBoundName ("*default*" , value, env) を ? で実行する。empty を返す。
17 Error Handling and Language Extensions
実装は、関連するECMAScript言語構成が評価される時点でほとんどのエラーを報告しなければならない。An early error は、そのエラーを含む eval が呼び出された時に報告され、eval コードの評価を防ぐ。早期エラーでないすべてのエラーはランタイムエラーである。
実装は、本仕様の「Static Semantics: Early Errors」小節に列挙されている条件が発生した場合、それを早期エラーとして報告しなければならない。
コンパイラがある構成がいかなる状況でもエラーなく実行できないと証明できる場合であっても、実装は他の種類のエラーを早期エラーとして扱ってはならない。そのような場合に実装は早期警告を発することができるが、該当する構成が実際に実行されるまでエラーを報告すべきではない。
実装は以下を除き、指定されたとおりにすべてのエラーを報告しなければならない：
-
Except as restricted in
17.1 , ホストまたは実装はScript 構文、Module 構文、および正規表現のパターンまたはフラグ構文を拡張することができる。これを許すために、evalを呼び出す、正規表現リテラルを使用する、または Function や RegExp コンストラクタを使用するなど、SyntaxError を投げることが許されているすべての操作は、スクリプト構文や正規表現パターンまたはフラグ構文に対するホスト定義の拡張に遭遇した際にSyntaxError を投げる代わりにホスト定義の動作を示すことが許される。 -
Except as restricted in
17.1 , ホストまたは実装は本仕様で記述されたものを越える追加の型、値、オブジェクト、プロパティ、および関数を提供することができる。これにより（例えばグローバルスコープで変数を検索するなどの）構成が、エラー（例えばReferenceError ）を投げる代わりにホスト定義の動作を示すことがある。
17.1 Forbidden Extensions
実装は次の方法で本仕様を拡張してはならない：
-
厳格モードのコードで構文上のコンストラクタを使って定義された ECMAScript 関数オブジェクトは、
"caller" または"arguments" という名前の own プロパティを持って作成してはならない。そのような own プロパティは、ArrowFunction 、MethodDefinition 、GeneratorDeclaration 、GeneratorExpression 、AsyncGeneratorDeclaration 、AsyncGeneratorExpression 、ClassDeclaration 、ClassExpression 、AsyncFunctionDeclaration 、AsyncFunctionExpression 、またはAsyncArrowFunction を使用して定義された関数オブジェクトについても、定義が厳格モードコード内に含まれているかどうかにかかわらず作成してはならない。組み込み関数、Function コンストラクタを使用して作成された厳格関数、Generator コンストラクタを使用して作成されたジェネレータ関数、AsyncFunction コンストラクタを使用して作成された async 関数、およびbindメソッドを使用して作成された関数も同様にそのような own プロパティを持って作成してはならない。 -
実装が own プロパティ名を
"caller" として任意の関数オブジェクトを拡張する場合、そのプロパティの値は [[Get]] または [[GetOwnProperty]] を使用して観察したときに厳格関数オブジェクトであってはならない。もしそれがアクセサプロパティであるなら、そのプロパティの [[Get]] 属性の値である関数は、呼び出されたときに決して厳格関数を返してはならない。 -
マップされた引数オブジェクトでもマップされていない引数オブジェクトでも、
"caller" という own プロパティを持って作成してはならない。 -
ECMA-402 に記載されているような組み込みメソッド（例えば
toLocaleStringと名付けられたもの）の振る舞いは、ECMA-402 で指定されている場合を除き拡張してはならない。 -
22.2.1 およびB.1.2 の RegExp パターン文法は、[UnicodeMode] 文法パラメータが存在する場合にソース文字 A-Z または a-z のいずれかをIdentityEscape として認識するように拡張してはならない。[+UnicodeMode] -
構文文法は、
BindingIdentifier 非終端記号にマッチするソーステキストに直ちにトークン:が続くことを許すような形で拡張してはならない。 -
厳格モードコードを処理する際、実装は
12.9.3.1 の早期エラー規則を緩和してはならない。 -
TemplateEscapeSequence は12.9.4 で定義されるLegacyOctalEscapeSequence またはNonOctalDecimalEscapeSequence を含むように拡張してはならない。 -
厳格モードコードを処理する際、
B.3.1 、B.3.2 、B.3.3 、およびB.3.5 で定義された拡張はサポートしてはならない。 -
Module 目標記号の解析時には、B.1.1 で定義された字句文法の拡張をサポートしてはならない。 -
ImportCall は拡張してはならない。
18 ECMAScript Standard Built-in Objects
ECMAScript の
特に指定がない限り、関数として呼び出し可能な組み込みオブジェクトは
多くの組み込みオブジェクトは関数であり、引数を指定して呼び出すことができる。さらにそれらのうちいくつかはコンストラクタであり、new 演算子で使うことを意図した関数である。各組み込み関数について、本仕様はその関数が要求する引数とその関数オブジェクトのプロパティを記述する。各組み込みコンストラクタについては、さらにそのコンストラクタの prototype オブジェクトのプロパティおよびそのコンストラクタを呼び出す new 式によって返される特定のオブジェクトインスタンスのプロパティを記述する。
特定の関数の記述で別段の指定がない限り、組み込み関数またはコンストラクタに指定された必要引数より少ない引数が与えられた場合、その関数またはコンストラクタは、各不足引数が
特定の関数の記述で別段の指定がない限り、記述された組み込み関数またはコンストラクタに指定された許容引数より多くの引数が与えられた場合、追加の引数は呼び出しにより評価され、その後関数によって無視される。ただし、実装はそのような引数に関して実装特有の振る舞いを定義することができるが、その振る舞いが単に余分な引数の存在を理由に
組み込み関数の集合に追加的な機能を加える実装は、既存関数に新しいパラメータを追加するのではなく、新しい関数を追加する方法で行うことが推奨される。
特に指定がない限り、すべての組み込み関数およびすべての組み込みコンストラクタは Function prototype オブジェクト（式 Function.prototype の初期値としてのオブジェクト、
特に指定がない限り、すべての組み込みプロトタイプオブジェクトは Object prototype オブジェクト（式 Object.prototype の初期値、
もし本仕様が組み込みコンストラクタの振る舞いをアルゴリズム手順で定義するなら、それは [[Call]] と [[Construct]] の双方に対する振る舞いである。もしそのようなアルゴリズムが二つの場合を区別する必要があるなら、NewTarget が
組み込み関数オブジェクトで、その関数がコンストラクタとして識別されていないものは、特に指定がない限り [[Construct]] 内部メソッドを実装しない。
組み込み関数オブジェクトでコンストラクタでないものは、特に指定がない限り
本仕様で定義された各組み込み関数は
すべての組み込み関数オブジェクト（コンストラクタを含む）は
例えば、Array prototype オブジェクトの
特に指定がない限り、組み込み関数オブジェクトの
すべての組み込み関数オブジェクト（コンストラクタを含む）は
特に指定がない限り、組み込み関数オブジェクトの
19 グローバルオブジェクト
The グローバルオブジェクト：
- 任意の実行コンテキストに制御が入る前に作成される。
- [[Construct]] 内部メソッドを持たない；
new演算子でコンストラクタとして使用できない。 - [[Call]] 内部メソッドを持たない；関数として呼び出すことはできない。
- 値がホスト定義である [[Prototype]] 内部スロットを持つ。
- この仕様で定義されたプロパティに加えて、ホスト定義のプロパティを持つ場合がある。これには、その値がグローバルオブジェクト自身であるプロパティを含むことがある。
19.1 グローバルオブジェクトの値プロパティ
19.1.1 globalThis
このプロパティは属性 { [[Writable]]:
19.1.2 Infinity
Infinity の値は
19.1.3 NaN
NaN の値は
19.1.4 undefined
undefined の値は
19.2 グローバルオブジェクトの関数プロパティ
19.2.1 eval ( source )
この関数は %eval% 内在オブジェクトである。
呼び出されたとき、以下の手順を実行する：
- Return ?
PerformEval (source,false ,false ).
19.2.1.1 PerformEval ( source, strictCaller, direct )
The
- 断言: direct が
false の場合、strictCaller もfalse であること。 - もし source が文字列でなければ、source を返す。
- evalRealm を現在の
Realm Record とする。 - 注: 直接 eval の場合、evalRealm は eval を呼んだ側のレルムと eval 関数自身のレルムの両方である。
- Perform ?
HostEnsureCanCompileStrings (evalRealm, « », source, direct) を実行する。 - inFunction を
false にする。 - inMethod を
false にする。 - inDerivedConstructor を
false にする。 - inClassFieldInitializer を
false にする。 - もし direct が
true ならば- thisEnvRec を
GetThisEnvironment () とする。 - もし thisEnvRec が
Function Environment Record であれば、- func を thisEnvRec.[[FunctionObject]] とする。
- inFunction を
true にする。 - inMethod を thisEnvRec.
HasSuperBinding () にする。 - もし func.[[ConstructorKind]] が
derived であれば、inDerivedConstructor をtrue にする。 - classFieldInitializerName を func.[[ClassFieldInitializerName]] とする。
- もし classFieldInitializerName が
empty でなければ、inClassFieldInitializer をtrue にする。
- thisEnvRec を
- 実装定義の順序で次のサブステップを実行する（パースとエラー検出を並列に行うことがある）:
- script を
ParseText (source,Script ) とする。 - もし script がエラーのリストであれば、
SyntaxError 例外を投げる。 - もし script が
ScriptBody を含まないなら、undefined を返す。 - body を script の
ScriptBody とする。 - もし inFunction が
false でかつ body がNewTarget を含むなら、SyntaxError 例外を投げる。 - もし inMethod が
false でかつ body がSuperProperty を含むなら、SyntaxError 例外を投げる。 - もし inDerivedConstructor が
false でかつ body がSuperCall を含むなら、SyntaxError 例外を投げる。 - もし inClassFieldInitializer が
true でかつ body のContainsArguments がtrue なら、SyntaxError 例外を投げる。
- script を
- もし strictCaller が
true なら、strictEval をtrue とする。 - さもなければ、strictEval を
ScriptIsStrict (script) とする。 - runningContext を実行中の実行コンテキストとする。
- 注: もし direct が
true なら、runningContext は直接 eval を行った実行コンテキストとなる。もし direct がfalse なら、runningContext はeval関数の呼び出しのための実行コンテキストとなる。 - もし direct が
true なら- lexEnv を
NewDeclarativeEnvironment (runningContext's LexicalEnvironment) とする。 - varEnv を runningContext's VariableEnvironment とする。
- privateEnv を runningContext's PrivateEnvironment とする。
- lexEnv を
- さもなければ、
- lexEnv を
NewDeclarativeEnvironment (evalRealm.[[GlobalEnv]]) とする。 - varEnv を evalRealm.[[GlobalEnv]] とする。
- privateEnv を
null とする。
- lexEnv を
- もし strictEval が
true なら、varEnv を lexEnv に設定する。 - もし runningContext がまだ一時停止していなければ、runningContext を一時停止する。
- evalContext を新しい ECMAScript コード実行コンテキストとする。
- evalContext の Function を
null に設定する。 - evalContext の
Realm を evalRealm に設定する。 - evalContext の ScriptOrModule を runningContext's ScriptOrModule に設定する。
- evalContext の VariableEnvironment を varEnv に設定する。
- evalContext の LexicalEnvironment を lexEnv に設定する。
- evalContext の PrivateEnvironment を privateEnv に設定する。
- 実行コンテキストスタックに evalContext をプッシュする；evalContext が現在の実行コンテキストとなる。
- result を
Completion (EvalDeclarationInstantiation (body, varEnv, lexEnv, privateEnv, strictEval)) とする。 - もし result が通常完了なら、
- result を
Completion (Evaluation of body) に設定する。
- result を
- もし result が通常完了かつ result.[[Value]] が
empty なら、- result を
NormalCompletion (undefined ) に設定する。
- result を
- evalContext を一時停止し、実行コンテキストスタックから取り除く。
- 実行コンテキストスタックのトップになっているコンテキストを再開して実行コンテキストとする。
- Return ? result.
19.2.1.2 HostEnsureCanCompileStrings ( calleeRealm, parameterStrings, bodyString, direct )
The
parameterStrings は関数コンストラクタを使用する際にパラメータリストを構築するために連結される文字列を表す。bodyString は関数本体または eval 呼び出しに渡される文字列を表す。
direct は評価が直接 eval であるかどうかを示す。
HostEnsureCanCompileStrings のデフォルト実装は
19.2.1.3 EvalDeclarationInstantiation ( body, varEnv, lexEnv, privateEnv, strict )
The
- varNames を body の
VarDeclaredNames とする。 - varDeclarations を body の
VarScopedDeclarations とする。 - もし strict が
false なら、- もし varEnv が
Global Environment Record であれば、- 各要素 name に対して varNames の、次を行う
- もし
HasLexicalDeclaration (varEnv, name) がtrue なら、SyntaxError 例外を投げる。 - 注:
evalはグローバルな lexical 宣言によって覆い隠されるようなグローバル var 宣言を作成しない。
- もし
- 各要素 name に対して varNames の、次を行う
- thisEnv を lexEnv とする。
- 断言: 以下のループは終了する。
- thisEnv と varEnv が同じ
Environment Record でない間、繰り返す、- もし thisEnv が
Object Environment Record でないなら、- 注: with 文の環境は lexical 宣言を含まないため var/let ホイスティングの
競合 チェックは必要ない。 - 各要素 name に対して varNames の、次を行う
- もし ! thisEnv.
HasBinding (name) がtrue なら、- ホストが Web ブラウザであるか、または
Catch ブロック内の VariableStatement をサポートしている場合は- もし thisEnv が
Catch 節のEnvironment Record でなければ、SyntaxError 例外を投げる。
- もし thisEnv が
- さもなければ、
SyntaxError 例外を投げる。
- ホストが Web ブラウザであるか、または
- 注: 直接 eval は同名の lexical 宣言よりも var 宣言をホイストしない。
- もし ! thisEnv.
- 注: with 文の環境は lexical 宣言を含まないため var/let ホイスティングの
- thisEnv を thisEnv.[[OuterEnv]] に設定する。
- もし thisEnv が
- もし varEnv が
- privateIdentifiers を新しい空のリストとする。
- pointer を privateEnv とする。
- pointer が
null でない間、繰り返す、- pointer.[[Names]] の各
Private Name binding に対して、次を行う- もし privateIdentifiers が binding.[[Description]] を含まなければ、binding.[[Description]] を privateIdentifiers に追加する。
- pointer を pointer.[[OuterPrivateEnvironment]] に設定する。
- pointer.[[Names]] の各
- もし
AllPrivateIdentifiersValid (body, privateIdentifiers) がfalse なら、SyntaxError 例外を投げる。 - functionsToInitialize を新しい空のリストとする。
- declaredFunctionNames を新しい空のリストとする。
- varDeclarations の各要素 d に対して、逆リスト順で、次を行う
- もし d が
VariableDeclaration 、ForBinding 、あるいはBindingIdentifier のいずれでもないなら、- 断言: d は
FunctionDeclaration 、GeneratorDeclaration 、AsyncFunctionDeclaration 、またはAsyncGeneratorDeclaration のいずれかである。 - 注: 同じ名前の関数宣言が複数ある場合、最後の宣言が使用される。
- fn を d の
BoundNames の唯一の要素とする。 - もし declaredFunctionNames が fn を含まなければ、
- もし varEnv が
Global Environment Record であれば、- fnDefinable を ?
CanDeclareGlobalFunction (varEnv, fn) とする。 - もし fnDefinable が
false なら、TypeError 例外を投げる。
- fnDefinable を ?
- fn を declaredFunctionNames に追加する。
- d を functionsToInitialize の最初の要素として挿入する。
- もし varEnv が
- 断言: d は
- もし d が
- declaredVarNames を新しい空のリストとする。
- varDeclarations の各要素 d に対して、次を行う
- もし d が
VariableDeclaration 、ForBinding 、またはBindingIdentifier のいずれかであれば、- d の
BoundNames の各文字列 vn に対して、次を行う- もし declaredFunctionNames が vn を含まなければ、
- もし varEnv が
Global Environment Record であれば、- vnDefinable を ?
CanDeclareGlobalVar (varEnv, vn) とする。 - もし vnDefinable が
false なら、TypeError 例外を投げる。
- vnDefinable を ?
- もし declaredVarNames が vn を含まなければ、
- vn を declaredVarNames に追加する。
- もし varEnv が
- もし declaredFunctionNames が vn を含まなければ、
- d の
- もし d が
- もし strict が
false でホストが Web ブラウザであるか、またはブロックレベル Function Declaration の Web レガシー互換性意味論 をサポートしているなら、- declaredFunctionOrVarNames を declaredFunctionNames と declaredVarNames の連結リストとする。
- 各
Block 、CaseClause 、またはDefaultClause のStatementList に直接含まれるFunctionDeclaration f について、かつ body がその x を含む場合、次を行う- funcName を f の
BindingIdentifier のStringValue とする。 - もし
FunctionDeclaration f をVariableStatement （BindingIdentifier が funcName）に置き換えても body に早期エラーが発生しないなら、- bindingExists を
false にする。 - thisEnv を lexEnv に設定する。
- 断言: 以下のループは終了する。
- thisEnv が varEnv でない間、繰り返す、
- もし thisEnv が
Object Environment Record でないなら、- もし ! thisEnv.
HasBinding (funcName) がtrue なら、- ホストが Web ブラウザであるか、または
Catch ブロック内の VariableStatement をサポートしている場合、- もし thisEnv が
Catch 節のEnvironment Record でなければ、bindingExists をtrue に設定する。
- もし thisEnv が
- さもなければ、
- bindingExists を
true に設定する。
- bindingExists を
- ホストが Web ブラウザであるか、または
- もし ! thisEnv.
- thisEnv を thisEnv.[[OuterEnv]] に設定する。
- もし thisEnv が
- もし bindingExists が
false でかつ varEnv がGlobal Environment Record であれば、- もし
HasLexicalDeclaration (varEnv, funcName) がfalse なら、- fnDefinable を ?
CanDeclareGlobalVar (varEnv, funcName) とする。
- fnDefinable を ?
- さもなければ、
- fnDefinable を
false にする。
- fnDefinable を
- もし
- さもなければ、
- fnDefinable を
true にする。
- fnDefinable を
- もし bindingExists が
false かつ fnDefinable がtrue なら、- もし declaredFunctionOrVarNames が funcName を含まなければ、
- もし varEnv が
Global Environment Record であれば、- Perform ?
CreateGlobalVarBinding (varEnv, funcName,true ) を実行する。
- Perform ?
- さもなければ、
- bindingExists を ! varEnv.
HasBinding (funcName) に設定する。 - もし bindingExists が
false なら、- Perform ! varEnv.
CreateMutableBinding (funcName,true ) を実行する。 - Perform ! varEnv.
InitializeBinding (funcName,undefined ) を実行する。
- Perform ! varEnv.
- bindingExists を ! varEnv.
- funcName を declaredFunctionOrVarNames に追加する。
- もし varEnv が
FunctionDeclaration f が評価されるとき、次の手順をFunctionDeclaration 評価アルゴリズムの代わりに実行する:- gEnv を実行中の実行コンテキストの VariableEnvironment とする。
- bEnv を実行中の実行コンテキストの LexicalEnvironment とする。
- fObj を ! bEnv.
GetBindingValue (funcName,false ) とする。 - Perform ? gEnv.
SetMutableBinding (funcName, fObj,false ) を実行する。 - Return
unused 。
- もし declaredFunctionOrVarNames が funcName を含まなければ、
- bindingExists を
- funcName を f の
- 注: このアルゴリズムステップ以降は、varEnv が
Global Environment Record であり、かつグローバルオブジェクト が Proxyexotic object でない限り異常終了は発生しない。 - lexDeclarations を body の
LexicallyScopedDeclarations とする。 - lexDeclarations の各要素 d に対して、次を行う
- 注: レキシカルに宣言された名前はここでのみ生成され、初期化はされない。
- d の
BoundNames の各要素 dn に対して、次を行う- もし
IsConstantDeclaration (d) がtrue なら、- Perform ? lexEnv.
CreateImmutableBinding (dn,true ) を実行する。
- Perform ? lexEnv.
- さもなければ、
- Perform ? lexEnv.
CreateMutableBinding (dn,false ) を実行する。
- Perform ? lexEnv.
- もし
- functionsToInitialize の各
Parse Node f に対して、次を行う- fn を f の
BoundNames の唯一の要素とする。 - fo を
InstantiateFunctionObject (f, lexEnv, privateEnv) とする。 - もし varEnv が
Global Environment Record であれば、- Perform ?
CreateGlobalFunctionBinding (varEnv, fn, fo,true ) を実行する。
- Perform ?
- さもなければ、
- bindingExists を ! varEnv.
HasBinding (fn) とする。 - もし bindingExists が
false なら、- 注: 以下の呼び出しは、前の検証により異常完了を返すことはない。
- Perform ! varEnv.
CreateMutableBinding (fn,true ) を実行する。 - Perform ! varEnv.
InitializeBinding (fn, fo) を実行する。
- さもなければ、
- Perform ! varEnv.
SetMutableBinding (fn, fo,false ) を実行する。
- Perform ! varEnv.
- bindingExists を ! varEnv.
- fn を f の
- declaredVarNames の各文字列 vn に対して、次を行う
- もし varEnv が
Global Environment Record であれば、- Perform ?
CreateGlobalVarBinding (varEnv, vn,true ) を実行する。
- Perform ?
- さもなければ、
- bindingExists を ! varEnv.
HasBinding (vn) とする。 - もし bindingExists が
false なら、- 注: 以下の呼び出しは、前の検証により異常完了を返すことはない。
- Perform ! varEnv.
CreateMutableBinding (vn,true ) を実行する。 - Perform ! varEnv.
InitializeBinding (vn,undefined ) を実行する。
- bindingExists を ! varEnv.
- もし varEnv が
- Return
unused 。
19.2.2 isFinite ( number )
この関数は %isFinite% 内在オブジェクトである。
呼び出されたとき、以下の手順を実行する：
- num を ?
ToNumber (number) とする。 - もし num が有限なら、
true を返す。 false を返す。
19.2.3 isNaN ( number )
この関数は %isNaN% 内在オブジェクトである。
呼び出されたとき、以下の手順を実行する：
- num を ?
ToNumber (number) とする。 - もし num が
NaN なら、true を返す。 false を返す。
値 X が X !== X のような式である。これはかつその場合に限り結果が
19.2.4 parseFloat ( string )
この関数は、string 引数の内容を小数リテラルとして解釈することによって規定される Number 値を生成する。
これは %parseFloat% 内在オブジェクトである。
呼び出されたとき、以下の手順を実行する：
- inputString を ?
ToString (string) とする。 - trimmedString を !
TrimString (inputString,start ) とする。 - trimmed を
StringToCodePoints (trimmedString) とする。 - trimmedPrefix を
StrDecimalLiteral の構文を満たす trimmed の最長プレフィックス（存在するならそれ自身）とする。もしそのようなプレフィックスがなければ、NaN を返す。 - parsedNumber を
ParseText (trimmedPrefix,StrDecimalLiteral ) とする。 - 断言: parsedNumber は
Parse Node である。 - parsedNumber の
StringNumericValue を返す。
この関数は string の先頭部分のみを Number 値として解釈する場合があり、10進リテラルの表記の一部として解釈できないコード単位は無視される。無視されたことを示す手段は与えられない。
19.2.5 parseInt ( string, radix )
この関数は、指定された radix に従って string の内容を解釈することによって定められる整数の Number を生成する。string の先頭の空白は無視される。radix が 0 に変換されると（例えば
これは %parseInt% 内在オブジェクトである。
呼び出されたとき、以下の手順を実行する：
- inputString を ?
ToString (string) とする。 - trimmedString を !
TrimString (inputString,start ) とする。 - sign を 1 にする。
- もし trimmedString が空でなく、かつ最初のコード単位が 0x002D (HYPHEN-MINUS) であれば、sign を -1 にする。
- もし trimmedString が空でなく、かつ最初のコード単位が 0x002B (PLUS SIGN) または 0x002D (HYPHEN-MINUS) のいずれかであれば、trimmedString をインデックス 1 からの部分文字列にする。
- radixMV を
ℝ (?ToInt32 (radix)) とする。 - stripPrefix を
true にする。 - もし radixMV ≠ 0 なら、
- もし radixMV < 2 または radixMV > 36 なら、
NaN を返す。 - もし radixMV ≠ 16 なら、stripPrefix を
false に設定する。
- もし radixMV < 2 または radixMV > 36 なら、
- さもなければ、
- radixMV を 10 に設定する。
- もし stripPrefix が
true なら、- もし trimmedString の長さが ≥ 2 でかつ最初の二つのコード単位が
"0x" または"0X" であれば、- trimmedString をインデックス 2 からの部分文字列にする。
- radixMV を 16 に設定する。
- もし trimmedString の長さが ≥ 2 でかつ最初の二つのコード単位が
- もし trimmedString が radix-radixMV の数字でないコード単位を含むなら、end をその最初の位置のインデックスにする；さもなければ end を trimmedString の長さにする。
- numberString を trimmedString の 0 から end までの部分文字列とする。
- もし numberString が空なら、
NaN を返す。 - mathInt を、numberString が radix-radixMV 表記で表す整数値とする（値 10 から 35 の数字には A 〜 Z と a 〜 z を用いる）。（しかしながら、もし radixMV = 10 かつ numberString が 20 を超える有効桁を含む場合、実装は 20 桁目以降の各有効桁を 0 に置き換えることができる；また radixMV が 2,4,8,10,16,32 のいずれでもない場合、mathInt は実装により近似された整数であってよい。）
- もし mathInt = 0 なら、
- もし sign = -1 なら、
-0 𝔽 を返す。 +0 𝔽 を返す。
- もし sign = -1 なら、
𝔽 (sign × mathInt) を返す。
この関数は string の先頭部分のみを整数値として解釈する場合があり、整数の表記として解釈できないコード単位は無視される。無視されたことを示す手段は与えられない。
19.2.6 URI 処理関数
Uniform Resource Identifier（URI）は、インターネット上のリソース（例: ウェブページやファイル）およびそれらにアクセスするためのトランスポートプロトコル（例: HTTP や FTP）を識別する文字列である。ECMAScript 言語自体は URI を使用するためのサポートを提供しないが、本節で説明するように URI をエンコード／デコードする関数は提供する。encodeURI と decodeURI は完全な URI を扱うことを意図している；これらは予約文字が特別な意味（例えば区切り）を持つことを想定しており、エンコードしない。encodeURIComponent と decodeURIComponent は URI の個々のコンポーネントを扱うことを意図している；これらは予約文字がテキストを表し、コンポーネントが完全な URI の一部となる際に特別な意味を持たないようにエンコードされるべきであると想定している。
予約文字の集合は RFC 2396 に基づいており、より新しい RFC 3986 による変更を反映していない。
多くの ECMAScript 実装はウェブページを操作する追加の関数やメソッドを提供する；これらの関数は本標準の範囲外である。
19.2.6.1 decodeURI ( encodedURI )
この関数は、encodeURI 関数によって導入される可能性のある各エスケープシーケンスおよび UTF-8 エンコーディングを、それが表すコードポイントの UTF-16 エンコーディングに置き換えた URI の新しいバージョンを計算する。encodeURI によって導入され得ないエスケープシーケンスは置き換えられない。
これは %decodeURI% 内在オブジェクトである。
呼び出されたとき、以下の手順を実行する：
19.2.6.2 decodeURIComponent ( encodedURIComponent )
この関数は、encodeURIComponent 関数によって導入される可能性のある各エスケープシーケンスおよび UTF-8 エンコーディングを、それが表すコードポイントの UTF-16 エンコーディングに置き換えた URI の新しいバージョンを計算する。
これは %decodeURIComponent% 内在オブジェクトである。
呼び出されたとき、以下の手順を実行する：
19.2.6.3 encodeURI ( uri )
この関数は、UTF-16 エンコードされた（
これは %encodeURI% 内在オブジェクトである。
呼び出されたとき、以下の手順を実行する：
19.2.6.4 encodeURIComponent ( uriComponent )
この関数は、UTF-16 エンコードされた（
これは %encodeURIComponent% 内在オブジェクトである。
呼び出されたとき、以下の手順を実行する：
19.2.6.5 Encode ( string, extraUnescaped )
The
- len を string の長さとする。
- result を空の文字列とする。
- alwaysUnescaped を ASCII の単語文字と
"-.!~*'()" の文字列連結とする。 - unescapedSet を alwaysUnescaped と extraUnescaped の連結とする。
- k を 0 にする。
- k < len の間、繰り返す、
- codeUnit を string のインデックス k のコード単位とする。
- もし unescapedSet が codeUnit を含むなら、
- k を k + 1 にする。
- result を result と codeUnit の文字列連結に設定する。
- さもなければ、
- cp を
CodePointAt (string, k) とする。 - もし cp.[[IsUnpairedSurrogate]] が
true なら、URIError 例外を投げる。 - k を k + cp.[[CodeUnitCount]] に設定する。
- octets を cp.[[CodePoint]] に UTF-8 変換を適用して得られるオクテットのリストとする。
- octets の各要素 octet に対して、次を行う
- hex を octet の大文字の16進数文字列表現とする。
- result を result、
"%" 、およびStringPad (hex, 2,"0" ,start ) の連結に設定する。
- cp を
- result を返す。
パーセントエンコーディングは個々のオクテットを表現するため、単一のコードポイントは複数の連続するエスケープシーケンス（各 8 ビットの UTF-8 コード単位ごとに1つ）として表され得る。
19.2.6.6 Decode ( string, preserveEscapeSet )
The
- len を string の長さとする。
- result を空の文字列とする。
- k を 0 にする。
- k < len の間、繰り返す、
- codeUnit を string のインデックス k のコード単位とする。
- segment を codeUnit に設定する。
- もし codeUnit が 0x0025 (PERCENT SIGN) のコード単位であるなら、
- もし k + 3 > len なら、
URIError 例外を投げる。 - escape を string の k から k + 3 の部分文字列とする。
- firstOctet を
ParseHexOctet (string, k + 1) とする。 - もし firstOctet が整数でなければ、
URIError 例外を投げる。 - k を k + 2 に設定する。
- n を firstOctet の先頭に並ぶ 1 ビットの数とする。
- もし n = 0 なら、
- asciiChar を数値が firstOctet のコード単位とする。
- もし preserveEscapeSet が asciiChar を含めば、segment を escape に設定する；さもなければ segment を asciiChar に設定する。
- さもなければ、
- もし n = 1 または n > 4 なら、
URIError 例外を投げる。 - octets を « firstOctet » とする。
- j を 1 にする。
- j < n の間、繰り返す、
- k を k + 1 に設定する。
- もし k + 3 > len なら、
URIError 例外を投げる。 - もし string のインデックス k のコード単位が 0x0025 (PERCENT SIGN) でなければ、
URIError 例外を投げる。 - continuationByte を
ParseHexOctet (string, k + 1) とする。 - もし continuationByte が整数でなければ、
URIError 例外を投げる。 - continuationByte を octets に追加する。
- k を k + 2 に設定する。
- j を j + 1 に設定する。
- 断言: octets の長さは n である。
- もし octets が Unicode コードポイントの有効な UTF-8 エンコーディングを含まないなら、
URIError 例外を投げる。 - codePoint を octets に UTF-8 変換を適用して得られるコードポイントとする（21 ビット値）。
- segment を
UTF16EncodeCodePoint (codePoint) に設定する。
- もし n = 1 または n > 4 なら、
- もし k + 3 > len なら、
- result を result と segment の文字列連結に設定する。
- k を k + 1 に設定する。
- result を返す。
RFC 3629 は無効な UTF-8 オクテットシーケンスのデコードを禁じている。例えば無効なシーケンス 0xC0 0x80 はコード単位 0x0000 にデコードされてはならない。Decode アルゴリズムの実装は、そのような無効シーケンスに遭遇したとき
19.2.6.7 ParseHexOctet ( string, position )
The
- len を string の長さとする。
- 断言: position + 2 ≤ len。
- hexDigits を string の position から position + 2 の部分文字列とする。
- parseResult を
ParseText (hexDigits,HexDigits ) とする。[~Sep] - もし parseResult が
Parse Node でなければ、parseResult を返す。 - n を parseResult の MV とする。
- 断言: n は 0 から 255 の閉区間内である。
- n を返す。
19.3 グローバルオブジェクトのコンストラクタプロパティ
19.3.1 AggregateError ( . . . )
参照
19.3.2 Array ( . . . )
参照
19.3.3 ArrayBuffer ( . . . )
参照
19.3.4 BigInt ( . . . )
参照
19.3.5 BigInt64Array ( . . . )
参照
19.3.6 BigUint64Array ( . . . )
参照
19.3.7 Boolean ( . . . )
参照
19.3.8 DataView ( . . . )
参照
19.3.9 Date ( . . . )
参照
19.3.10 Error ( . . . )
参照
19.3.11 EvalError ( . . . )
参照
19.3.12 FinalizationRegistry ( . . . )
参照
19.3.13 Float16Array ( . . . )
参照
19.3.14 Float32Array ( . . . )
参照
19.3.15 Float64Array ( . . . )
参照
19.3.16 Function ( . . . )
参照
19.3.17 Int8Array ( . . . )
参照
19.3.18 Int16Array ( . . . )
参照
19.3.19 Int32Array ( . . . )
参照
19.3.20 Iterator ( . . . )
参照
19.3.21 Map ( . . . )
参照
19.3.22 Number ( . . . )
参照
19.3.23 Object ( . . . )
参照
19.3.24 Promise ( . . . )
参照
19.3.25 Proxy ( . . . )
参照
19.3.26 RangeError ( . . . )
参照
19.3.27 ReferenceError ( . . . )
参照
19.3.28 RegExp ( . . . )
参照
19.3.29 Set ( . . . )
参照
19.3.30 SharedArrayBuffer ( . . . )
参照
19.3.31 String ( . . . )
参照
19.3.32 Symbol ( . . . )
参照
19.3.33 SyntaxError ( . . . )
参照
19.3.34 TypeError ( . . . )
参照
19.3.35 Uint8Array ( . . . )
参照
19.3.36 Uint8ClampedArray ( . . . )
参照
19.3.37 Uint16Array ( . . . )
参照
19.3.38 Uint32Array ( . . . )
参照
19.3.39 URIError ( . . . )
参照
19.3.40 WeakMap ( . . . )
参照
19.3.41 WeakRef ( . . . )
参照
19.3.42 WeakSet ( . . . )
参照
19.4 グローバルオブジェクトのその他のプロパティ
19.4.1 Atomics
参照
19.4.2 JSON
参照
19.4.3 Math
参照
19.4.4 Reflect
参照
20 基本オブジェクト
20.1 Object オブジェクト
20.1.1 Object コンストラクタ
Object コンストラクタ：
- は %Object% である。
グローバルオブジェクト の"Object" プロパティの初期値である。- コンストラクタとして呼び出されたときに新しい通常のオブジェクトを作成する。
- コンストラクタとしてではなく関数として呼び出されたときに型変換を行う。
- クラス定義の
extends節の値として使用されることがある。
20.1.1.1 Object ( value )
この関数は呼び出されたときに次の手順を実行する：
- NewTarget が
undefined でもアクティブな関数オブジェクトでもない場合、次を行う：- ?
OrdinaryCreateFromConstructor (NewTarget,"%Object.prototype%" ) を返す。
- ?
- value が
undefined またはnull のいずれかである場合、OrdinaryObjectCreate (%Object.prototype% ) を返す。 - !
ToObject (value) を返す。
20.1.2 Object コンストラクタのプロパティ
Object コンストラクタ：
- [[Prototype]] 内部スロットを持ち、その値は
%Function.prototype% である。 - 以下の追加プロパティを持つ：
20.1.2.1 Object.assign ( target, ...sources )
この関数は、1 個以上のソースオブジェクトから列挙可能な自身のプロパティのすべての値を target オブジェクトにコピーする。
呼び出されたときに次の手順を実行する：
この関数の
20.1.2.2 Object.create ( proto, properties )
この関数は、指定されたプロトタイプを持つ新しいオブジェクトを作成する。
呼び出されたときに次の手順を実行する：
- proto がオブジェクトでなく、かつ proto が
null でもない場合、TypeError 例外を投げる。 - Let obj be
OrdinaryObjectCreate (proto)（指定プロトタイプの通常オブジェクトを作成する）。 - properties が
undefined でない場合、次を行う：- Return ?
ObjectDefineProperties (obj, properties) を返す（プロパティ記述子で定義する）。
- Return ?
- obj を返す。
20.1.2.3 Object.defineProperties ( obj, properties )
この関数は、オブジェクトに自身のプロパティを追加し、または既存の自身のプロパティの属性を更新する。
呼び出されたときに次の手順を実行する：
- obj がオブジェクトでない場合、
TypeError 例外を投げる。 - Return ?
ObjectDefineProperties (obj, properties) を返す。
20.1.2.3.1 ObjectDefineProperties ( obj, properties )
The
- Let props be ?
ToObject (properties)（properties をオブジェクトに変換する）。 - Let keys be ? props.[[OwnPropertyKeys]]()（props の所有プロパティキーを取得する）。
- Let descriptors be a new empty
List （空の記述子リストを作る）。 - keys の各要素 nextKey について、次を行う：
- Let propDesc be ? props.[[GetOwnProperty]](nextKey)（当該キーのプロパティ記述子を取得する）。
- propDesc が
undefined でなく、かつ propDesc.[[Enumerable]] がtrue の場合、次を行う：- Let descObj be ?
Get (props, nextKey)（記述子オブジェクトを取得する）。 - Let desc be ?
ToPropertyDescriptor (descObj)（プロパティ記述子に変換する）。 - Append the
Record { [[Key]]: nextKey, [[Descriptor]]: desc } to descriptors（記述子リストに追加する）。
- Let descObj be ?
- descriptors の各要素 property について、次を行う：
- Perform ?
DefinePropertyOrThrow (obj, property.[[Key]], property.[[Descriptor]])（対象オブジェクトに定義する／失敗すれば例外）。
- Perform ?
- obj を返す。
20.1.2.4 Object.defineProperty ( obj, propertyKey, attributes )
この関数は、オブジェクトに自身のプロパティを追加し、または既存の自身のプロパティの属性を更新する。
呼び出されたときに次の手順を実行する：
- obj がオブジェクトでない場合、
TypeError 例外を投げる。 - Let key be ?
ToPropertyKey (propertyKey)（プロパティキーに変換する）。 - Let desc be ?
ToPropertyDescriptor (attributes)（属性をプロパティ記述子に変換する）。 - Perform ?
DefinePropertyOrThrow (obj, key, desc)（定義する、失敗すれば例外）。 - obj を返す。
20.1.2.5 Object.entries ( obj )
この関数は呼び出されたときに次の手順を実行する：
- Let coerced be ?
ToObject (obj)（obj をオブジェクトに変換する）。 - Let entryList be ?
EnumerableOwnProperties (coerced,key+value )（列挙可能な自身のキーと値の一覧を取得する）。 - Return
CreateArrayFromList (entryList)（一覧から配列を作成して返す）。
20.1.2.6 Object.freeze ( obj )
この関数は呼び出されたときに次の手順を実行する：
- obj がオブジェクトでない場合、obj を返す。
- Let status be ?
SetIntegrityLevel (obj,frozen )（完全凍結の整合性レベルを設定する）。 - status が
false の場合、TypeError 例外を投げる。 - obj を返す。
20.1.2.7 Object.fromEntries ( iterable )
この関数は呼び出されたときに次の手順を実行する：
- Perform ?
RequireObjectCoercible (iterable)（iterable がオブジェクトに変換可能であることを要求する）。 - Let obj be
OrdinaryObjectCreate (%Object.prototype% )（%Object.prototype% をプロトタイプとする通常オブジェクトを作成する）。 Assert : obj は拡張可能な通常オブジェクトで、所有プロパティを持たないことを主張する。- Let closure be a new
Abstract Closure with parameters (key, value) that captures obj and performs the following steps when called:- Let propertyKey be ?
ToPropertyKey (key)（キーをプロパティキーに変換する）。 - Perform !
CreateDataPropertyOrThrow (obj, propertyKey, value)（データプロパティを作成する、失敗すれば例外）。 - Return
NormalCompletion (undefined ).
- Let propertyKey be ?
- Let adder be
CreateBuiltinFunction (closure, 2,"" , « »)（上記クロージャを組み込み関数として作成する）。 - Return ?
AddEntriesFromIterable (obj, iterable, adder)（反復可能からエントリを追加して結果を返す）。
20.1.2.8 Object.getOwnPropertyDescriptor ( obj, propertyKey )
この関数は呼び出されたときに次の手順を実行する：
- Let coerced be ?
ToObject (obj)（obj をオブジェクトに変換する）。 - Let key be ?
ToPropertyKey (propertyKey)（propertyKey をプロパティキーに変換する）。 - Let desc be ? coerced.[[GetOwnProperty]](key)（当該プロパティの内部記述子を取得する）。
- Return
FromPropertyDescriptor (desc)（プロパティ記述子から外部表現を作成して返す）。
20.1.2.9 Object.getOwnPropertyDescriptors ( obj )
この関数は呼び出されたときに次の手順を実行する：
- Let coerced be ?
ToObject (obj). - Let ownKeys be ? coerced.[[OwnPropertyKeys]]()（所有プロパティキーを取得する）。
- Let descriptors be
OrdinaryObjectCreate (%Object.prototype% )（記述子オブジェクトを作成する）。 - For each element key of ownKeys, do
- Let desc be ? coerced.[[GetOwnProperty]](key)（そのキーの内部プロパティ記述子を得る）。
- Let descriptor be
FromPropertyDescriptor (desc)（外向きのプロパティ記述子に変換する）。 - If descriptor is not
undefined , perform !CreateDataPropertyOrThrow (descriptors, key, descriptor)（記述子オブジェクトにデータプロパティとして追加する）。
- Return descriptors（記述子オブジェクトを返す）。
20.1.2.10 Object.getOwnPropertyNames ( obj )
この関数は呼び出されたときに次の手順を実行する：
- Return
CreateArrayFromList (?GetOwnPropertyKeys (obj,string ))（文字列キーの所有プロパティキー一覧から配列を作成して返す）。
20.1.2.11 Object.getOwnPropertySymbols ( obj )
この関数は呼び出されたときに次の手順を実行する：
- Return
CreateArrayFromList (?GetOwnPropertyKeys (obj,symbol ))（シンボルキーの所有プロパティキー一覧から配列を作成して返す）。
20.1.2.11.1 GetOwnPropertyKeys ( value, type )
The
- Let obj be ?
ToObject (value)（value をオブジェクトに変換する）。 - Let keys be ? obj.[[OwnPropertyKeys]]()（所有プロパティキー一覧を取得する）。
- Let nameList be a new empty
List （空の名前リストを作成する）。 - For each element nextKey of keys, do
- If nextKey
is a Symbol and type issymbol , or if nextKeyis a String and type isstring , then- Append nextKey to nameList（条件に一致するキーを名前リストに追加する）。
- If nextKey
- Return nameList（名前リストを返す）。
20.1.2.12 Object.getPrototypeOf ( obj )
この関数は呼び出されたときに次の手順を実行する：
- Let coerced be ?
ToObject (obj)（obj をオブジェクトに変換する）。 - Return ? coerced.[[GetPrototypeOf]]()（プロトタイプを返す）。
20.1.2.13 Object.groupBy ( items, callback )
callback は 2 つの引数を受け取る関数であるべきである。groupBy は items の各要素に対して昇順で一度ずつ callback を呼び出し、新しいオブジェクトを構築する。callback が返す各値はプロパティキーへ強制変換される。そのようにして得られた各プロパティキーについて、結果オブジェクトはそのキーを持ち、対応する値はそのキーに強制された戻り値を持つすべての要素を含む配列である。
callback は 2 引数で呼び出される：要素の値と要素のインデックスである。
groupBy の返り値は
この関数は呼び出されたときに次の手順を実行する：
- Let groups be ?
GroupBy (items, callback,property )（グルーピング情報を取得する）。 - Let obj be
OrdinaryObjectCreate (null )（プロトタイプが null の通常オブジェクトを作る）。 - For each
Record { [[Key]], [[Elements]] } g of groups, do- Let elements be
CreateArrayFromList (g.[[Elements]])（要素リストから配列を作る）。 - Perform !
CreateDataPropertyOrThrow (obj, g.[[Key]], elements)（オブジェクトにデータプロパティを作成する）。
- Let elements be
- Return obj（結果オブジェクトを返す）。
20.1.2.14 Object.hasOwn ( obj, propertyKey )
この関数は呼び出されたときに次の手順を実行する：
- Let coerced be ?
ToObject (obj)（obj をオブジェクトに変換する）。 - Let key be ?
ToPropertyKey (propertyKey)（propertyKey をプロパティキーに変換する）。 - Return ?
HasOwnProperty (coerced, key)（所有プロパティかどうかを返す）。
20.1.2.15 Object.is ( value1, value2 )
この関数は呼び出されたときに次の手順を実行する：
- Return
SameValue (value1, value2)（同値判定を返す）。
20.1.2.16 Object.isExtensible ( obj )
この関数は呼び出されたときに次の手順を実行する：
- If obj
is not an Object , returnfalse （オブジェクトでなければ false を返す）。 - Return ?
IsExtensible (obj)（拡張可能性を返す）。
20.1.2.17 Object.isFrozen ( obj )
この関数は呼び出されたときに次の手順を実行する：
- If obj
is not an Object , returntrue （オブジェクトでなければ true を返す）。 - Return ?
TestIntegrityLevel (obj,frozen )（凍結レベルをテストして返す）。
20.1.2.18 Object.isSealed ( obj )
この関数は呼び出されたときに次の手順を実行する：
- If obj
is not an Object , returntrue （オブジェクトでなければ true を返す）。 - Return ?
TestIntegrityLevel (obj,sealed )（封印レベルをテストして返す）。
20.1.2.19 Object.keys ( obj )
この関数は呼び出されたときに次の手順を実行する：
- Let coerced be ?
ToObject (obj)（obj をオブジェクトに変換する）。 - Let keyList be ?
EnumerableOwnProperties (coerced,key )（列挙可能な自身のキー一覧を取得する）。 - Return
CreateArrayFromList (keyList)（配列を作って返す）。
20.1.2.20 Object.preventExtensions ( obj )
この関数は呼び出されたときに次の手順を実行する：
- If obj
is not an Object , return obj（オブジェクトでなければそのまま返す）。 - Let status be ? obj.[[PreventExtensions]]()（内部メソッドで拡張禁止を行う）。
- If status is
false , throw aTypeError exception（失敗したら例外）。 - Return obj.
20.1.2.21 Object.prototype
Object.prototype の初期値は
This property has the attributes { [[Writable]]:
20.1.2.22 Object.seal ( obj )
この関数は呼び出されたときに次の手順を実行する：
- If obj
is not an Object , return obj（オブジェクトでなければそのまま返す）。 - Let status be ?
SetIntegrityLevel (obj,sealed )（封印レベルを設定する）。 - If status is
false , throw aTypeError exception（失敗したら例外）。 - Return obj.
20.1.2.23 Object.setPrototypeOf ( obj, proto )
この関数は呼び出されたときに次の手順を実行する：
- Perform ?
RequireObjectCoercible (obj)（obj がオブジェクト化可能であることを要求する）。 - If proto
is not an Object and proto is notnull , throw aTypeError exception（proto が不正なら例外）。 - If obj
is not an Object , return obj（obj がオブジェクトでなければそのまま返す）。 - Let status be ? obj.[[SetPrototypeOf]](proto)（内部メソッドでプロトタイプを設定する）。
- If status is
false , throw aTypeError exception（失敗したら例外）。 - Return obj.
20.1.2.24 Object.values ( obj )
この関数は呼び出されたときに次の手順を実行する：
- Let coerced be ?
ToObject (obj)（オブジェクトに変換する）。 - Let valueList be ?
EnumerableOwnProperties (coerced,value )（列挙可能な自身の値一覧を取得する）。 - Return
CreateArrayFromList (valueList)（配列を作って返す）。
20.1.3 Object プロトタイプオブジェクトのプロパティ
Object プロトタイプオブジェクト は次のとおりである：
- は %Object.prototype% である。
- [[Extensible]] 内部スロットを持ち、その値は
true である。 - 通常オブジェクトのために定義される内部メソッドを持つが、[[SetPrototypeOf]] メソッドは
10.4.7.1 に定義されたものと同じである。（したがって、これは不変プロトタイプのエキゾチックオブジェクトである。） - [[Prototype]] 内部スロットを持ち、その値は
null である。
20.1.3.1 Object.prototype.constructor
Object.prototype.constructor の初期値は
20.1.3.2 Object.prototype.hasOwnProperty ( value )
このメソッドは呼び出されたときに次の手順を実行する：
- Let propertyKey be ?
ToPropertyKey (value)（value をプロパティキーに変換する）。 - Let obj be ?
ToObject (this value)（this 値をオブジェクトに変換する）。 - Return ?
HasOwnProperty (obj, propertyKey)（所有プロパティかどうかを返す）。
20.1.3.3 Object.prototype.isPrototypeOf ( value )
このメソッドは呼び出されたときに次の手順を実行する：
- If value
is not an Object , returnfalse （value がオブジェクトでなければ false）。 - Let obj be ?
ToObject (this value)（this 値をオブジェクトに変換する）。 - Repeat,
- Set value to ? value.[[GetPrototypeOf]]()（プロトタイプをたどる）。
- If value is
null , returnfalse （プロトタイプが null なら false）。 - If
SameValue (obj, value) istrue , returntrue （一致すれば true）。
20.1.3.4 Object.prototype.propertyIsEnumerable ( value )
このメソッドは呼び出されたときに次の手順を実行する：
- Let propertyKey be ?
ToPropertyKey (value)（value をプロパティキーに変換する）。 - Let obj be ?
ToObject (this value)（this 値をオブジェクトに変換する）。 - Let desc be ? obj.[[GetOwnProperty]](propertyKey)（所有プロパティ記述子を取得する）。
- If desc is
undefined , returnfalse （定義されていなければ false）。 - Return desc.[[Enumerable]]（列挙可能かどうかを返す）。
このメソッドはプロトタイプ連鎖上のオブジェクトを考慮しない。
20.1.3.5 Object.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
このメソッドは呼び出されたときに次の手順を実行する：
- Let thisValue be the
this value（this 値を取得する）。 - Return ?
Invoke (thisValue,"toString" )（this に対して toString を呼び出して返す）。
このメソッドのオプション引数は使用されないが、ECMA-402 の toLocaleString メソッドで使われる引数パターンに対応させるために用意されている。ECMA-402 を含まない実装はこれらの引数位置を別の用途に使ってはならない。
このメソッドはロケール依存の toString 振る舞いを持たないオブジェクトに対する一般的な toLocaleString 実装を提供する。Array、Number、Date、および toLocaleString メソッドを提供する。
ECMA-402 はこのデフォルト実装に代わるものを意図的に提供していない。
20.1.3.6 Object.prototype.toString ( )
このメソッドは呼び出されたときに次の手順を実行する：
- If the
this value isundefined , return"[object Undefined]" （this が undefined の場合、"[object Undefined]" を返す）。 - If the
this value isnull , return"[object Null]" （this が null の場合、"[object Null]" を返す）。 - Let obj be !
ToObject (this value)（this をオブジェクトに変換する）。 - Let isArray be ?
IsArray (obj)（配列かどうかを判定する）。 - If isArray is
true , let builtinTag be"Array" （配列ならタグを "Array" にする）。 - Else if obj has a [[ParameterMap]] internal slot, let builtinTag be
"Arguments" （引数オブジェクトなら "Arguments"）。 - Else if obj has a [[Call]] internal method, let builtinTag be
"Function" （関数なら "Function"）。 - Else if obj has an [[ErrorData]] internal slot, let builtinTag be
"Error" （エラーなら "Error"）。 - Else if obj has a [[BooleanData]] internal slot, let builtinTag be
"Boolean" （Boolean オブジェクトなら "Boolean"）。 - Else if obj has a [[NumberData]] internal slot, let builtinTag be
"Number" （Number オブジェクトなら "Number"）。 - Else if obj has a [[StringData]] internal slot, let builtinTag be
"String" （String オブジェクトなら "String"）。 - Else if obj has a [[DateValue]] internal slot, let builtinTag be
"Date" （Date オブジェクトなら "Date"）。 - Else if obj has a [[RegExpMatcher]] internal slot, let builtinTag be
"RegExp" （RegExp オブジェクトなら "RegExp"）。 - Else, let builtinTag be
"Object" （それ以外は "Object"）。 - Let tag be ?
Get (obj,%Symbol.toStringTag% )（%Symbol.toStringTag% を取得する）。 - If tag
is not a String , set tag to builtinTag（tag が文字列でなければ builtinTag を使う）。 - Return the
string-concatenation of"[object " , tag, and"]" （"[object " + tag + "]" を返す）。
歴史的に、このメソッドは以前の仕様でいくつかの組み込みオブジェクトの名義的タイプタグとして使われていた [[Class]] 内部スロットの文字列値にアクセスするために使われることがあった。上記の toString の定義は、toString を特定の種類の組み込みオブジェクトの判定に使うレガシーコードとの互換性を保つ。これは他の種類の組み込みオブジェクトやプログラム定義オブジェクトに対する信頼できる型判定機構を提供するものではない。さらに、プログラムは
20.1.3.7 Object.prototype.valueOf ( )
このメソッドは呼び出されたときに次の手順を実行する：
- Return ?
ToObject (this value)（this をオブジェクトに変換して返す）。
20.1.3.8 Object.prototype.__proto__
Object.prototype.__proto__ は属性 { [[Enumerable]]:
20.1.3.8.1 get Object.prototype.__proto__
[[Get]] 属性の値は引数を取らない組み込み関数であり、呼び出されたときに次の手順を実行する：
- Let obj be ?
ToObject (this value)（this をオブジェクトに変換する）。 - Return ? obj.[[GetPrototypeOf]]()（プロトタイプを返す）。
20.1.3.8.2 set Object.prototype.__proto__
[[Set]] 属性の値は引数 proto を取る組み込み関数であり、呼び出されたときに次の手順を実行する：
- Let thisValue be the
this value（this 値を得る）。 - Perform ?
RequireObjectCoercible (thisValue)（this がオブジェクト化可能であることを要求する）。 - If proto
is not an Object and proto is notnull , returnundefined （proto が不正なら undefined を返す）。 - If thisValue
is not an Object , returnundefined （this がオブジェクトでなければ undefined を返す）。 - Let status be ? thisValue.[[SetPrototypeOf]](proto)（内部 SetPrototypeOf を呼ぶ）。
- If status is
false , throw aTypeError exception（失敗したら例外）。 - Return
undefined .
20.1.3.9 レガシーな Object.prototype アクセサメソッド
20.1.3.9.1 Object.prototype.__defineGetter__ ( propertyKey, getter )
このメソッドは呼び出されたときに次の手順を実行する：
- Let obj be ?
ToObject (this value)（this をオブジェクトに変換する）。 - If
IsCallable (getter) isfalse , throw aTypeError exception（getter が呼び出し可能でない場合は例外）。 - Let desc be PropertyDescriptor { [[Get]]: getter, [[Enumerable]]:
true , [[Configurable]]:true }（ゲッター記述子を作る）。 - Let key be ?
ToPropertyKey (propertyKey)（キーに変換する）。 - Perform ?
DefinePropertyOrThrow (obj, key, desc)（定義する、失敗すれば例外）。 - Return
undefined .
20.1.3.9.2 Object.prototype.__defineSetter__ ( propertyKey, setter )
このメソッドは呼び出されたときに次の手順を実行する：
- Let obj be ?
ToObject (this value)（this をオブジェクトに変換する）。 - If
IsCallable (setter) isfalse , throw aTypeError exception（setter が呼び出し可能でない場合は例外）。 - Let desc be PropertyDescriptor { [[Set]]: setter, [[Enumerable]]:
true , [[Configurable]]:true }（セッター記述子を作る）。 - Let key be ?
ToPropertyKey (propertyKey)（キーに変換する）。 - Perform ?
DefinePropertyOrThrow (obj, key, desc)（定義する、失敗すれば例外）。 - Return
undefined .
20.1.3.9.3 Object.prototype.__lookupGetter__ ( propertyKey )
このメソッドは呼び出されたときに次の手順を実行する：
- Let obj be ?
ToObject (this value)（this をオブジェクトに変換する）。 - Let key be ?
ToPropertyKey (propertyKey)（キーに変換する）。 - Repeat,
- Let desc be ? obj.[[GetOwnProperty]](key)（所有プロパティ記述子を取得する）。
- If desc is not
undefined , then- If
IsAccessorDescriptor (desc) istrue , return desc.[[Get]]（アクセサ記述子ならゲッターを返す）。 - Return
undefined （データプロパティなら undefined を返す）。
- If
- Set obj to ? obj.[[GetPrototypeOf]]()（プロトタイプを次に進める）。
- If obj is
null , returnundefined （プロトタイプが尽きたら undefined）。
20.1.3.9.4 Object.prototype.__lookupSetter__ ( propertyKey )
このメソッドは呼び出されたときに次の手順を実行する：
- Let obj be ?
ToObject (this value)（this をオブジェクトに変換する）。 - Let key be ?
ToPropertyKey (propertyKey)（キーに変換する）。 - Repeat,
- Let desc be ? obj.[[GetOwnProperty]](key)（所有プロパティ記述子を取得する）。
- If desc is not
undefined , then- If
IsAccessorDescriptor (desc) istrue , return desc.[[Set]]（アクセサ記述子ならセッターを返す）。 - Return
undefined （データプロパティなら undefined を返す）。
- If
- Set obj to ? obj.[[GetPrototypeOf]]()（プロトタイプを次に進める）。
- If obj is
null , returnundefined （尽きたら undefined）。
20.1.4 オブジェクトインスタンスのプロパティ
オブジェクトインスタンスは、
20.2 関数オブジェクト
20.2.1 Function コンストラクタ
Function コンストラクタ：
- は %Function% である。
グローバルオブジェクト の"Function" プロパティの初期値である。- コンストラクタではなく関数として呼び出されたときに新しい関数オブジェクトを作成・初期化する。したがって関数呼び出し Function(…) は同じ引数で new Function(…) と同等である。
- クラス定義の
extends節の値として使用されることがある。指定された Function 振る舞いを継承することを意図するサブクラスのコンストラクタは、組み込み関数振る舞いに必要な内部スロットを持つサブクラスインスタンスを作成・初期化するために Function コンストラクタへのsuper呼び出しを含まなければならない。ECMAScript の関数オブジェクトを定義するすべての構文は Function のインスタンスを生成する。組み込みの GeneratorFunction、AsyncFunction、AsyncGeneratorFunction を除き、Function サブクラスのインスタンスを作成する構文的方法はない。
20.2.1.1 Function ( ...parameterArgs, bodyArg )
最後の引数（存在する場合）は関数の本体（実行可能コード）を指定し、前の引数は形式パラメータを指定する。
この関数は呼び出されたときに次の手順を実行する：
- Let constructor be the
active function object （アクティブな関数オブジェクトを取得する）。 - If bodyArg is not present, set bodyArg to the empty String（本体引数がなければ空文字列にする）。
- Return ?
CreateDynamicFunction (constructor, NewTarget,normal , parameterArgs, bodyArg)（動的関数を作成して返す）。
各形式パラメータに対して必ず 1 つの引数がある必要はない。例えば次の 3 つの式は同じ結果を生成する：
new Function("a", "b", "c", "return a+b+c")
new Function("a, b, c", "return a+b+c")
new Function("a,b", "c", "return a+b+c")20.2.1.1.1 CreateDynamicFunction ( constructor, newTarget, kind, parameterArgs, bodyArg )
The new が最初に適用されたコンストラクタである。parameterArgs と bodyArg は constructor に渡された引数値を反映する。 It performs the following steps when called:
- If newTarget is
undefined , set newTarget to constructor（newTarget が未定義ならconstructor を使う）。 - If kind is
normal , then- Let prefix be
"function" . - Let exprSym be the grammar symbol
FunctionExpression . - Let bodySym be the grammar symbol
FunctionBody .[~Yield, ~Await] - Let parameterSym be the grammar symbol
FormalParameters .[~Yield, ~Await] - Let fallbackProto be
"%Function.prototype%" .
- Let prefix be
- Else if kind is
generator , then- Let prefix be
"function*" . - Let exprSym be the grammar symbol
GeneratorExpression . - Let bodySym be the grammar symbol
GeneratorBody . - Let parameterSym be the grammar symbol
FormalParameters .[+Yield, ~Await] - Let fallbackProto be
"%GeneratorFunction.prototype%" .
- Let prefix be
- Else if kind is
async , then- Let prefix be
"async function" . - Let exprSym be the grammar symbol
AsyncFunctionExpression . - Let bodySym be the grammar symbol
AsyncFunctionBody . - Let parameterSym be the grammar symbol
FormalParameters .[~Yield, +Await] - Let fallbackProto be
"%AsyncFunction.prototype%" .
- Let prefix be
- Else,
Assert : kind isasync-generator .- Let prefix be
"async function*" . - Let exprSym be the grammar symbol
AsyncGeneratorExpression . - Let bodySym be the grammar symbol
AsyncGeneratorBody . - Let parameterSym be the grammar symbol
FormalParameters .[+Yield, +Await] - Let fallbackProto be
"%AsyncGeneratorFunction.prototype%" .
- Let argCount be the number of elements in parameterArgs（パラメータ引数の数を得る）。
- Let parameterStrings be a new empty
List （空の文字列リストを作る）。 - For each element arg of parameterArgs, do
- Append ?
ToString (arg) to parameterStrings（各引数を文字列に変換してリストに追加）。
- Append ?
- Let bodyString be ?
ToString (bodyArg)（本体引数を文字列にする）。 - Let currentRealm be the
current Realm Record （現在のRealm レコードを取得）。 - Perform ?
HostEnsureCanCompileStrings (currentRealm, parameterStrings, bodyString,false )（ホストにより文字列のコンパイル許可を確認）。 - Let parameterString be the empty String（パラメータ文字列を初期化）。
- If argCount > 0, then
- Set parameterString to parameterStrings[0].
- Let k be 1.
- Repeat, while k < argCount,
- Let nextArgString be parameterStrings[k].
- Set parameterString to the
string-concatenation of parameterString,"," (a comma), and nextArgString（カンマで連結していく）。 - Set k to k + 1.
- Let bodyParseString be the
string-concatenation of 0x000A (LINE FEED), bodyString, and 0x000A (LINE FEED)（本体のパース用文字列を生成）。 - Let sourceString be the
string-concatenation of prefix," anonymous(" , parameterString, 0x000A (LINE FEED),") {" , bodyParseString, and"}" （ソース文字列を組み立てる）。 - Let sourceText be
StringToCodePoints (sourceString)（コードポイント列に変換する）。 - Let parameters be
ParseText (parameterString, parameterSym)（パラメータ文字列を構文解析する）。 - If parameters is a
List of errors, throw aSyntaxError exception（パースエラーなら例外）。 - Let body be
ParseText (bodyParseString, bodySym)（本体文字列を構文解析する）。 - If body is a
List of errors, throw aSyntaxError exception（本体パースでエラーなら例外）。 NOTE : パラメータと本体はそれぞれ単独で有効であることを保証するために別々に解析される。例えばnew Function("/*", "*/ ) {")は関数にはならない。NOTE : このステップに到達した場合、sourceText は exprSym の構文を持たなければならない（ただしその逆は成り立たない）。次の 2 ステップの目的は exprSym に直接適用される Early Error ルールを強制することである。- Let expr be
ParseText (sourceText, exprSym)（ソース全体を構文解析）。 - If expr is a
List of errors, throw aSyntaxError exception（構文エラーなら例外）。 - Let proto be ?
GetPrototypeFromConstructor (newTarget, fallbackProto)（コンストラクタからプロトタイプを取得）。 - Let env be currentRealm.[[GlobalEnv]]（グローバル環境を取得）。
- Let privateEnv be
null （プライベート環境は null）。 - Let func be
OrdinaryFunctionCreate (proto, sourceText, parameters, body,non-lexical-this , env, privateEnv)（関数オブジェクトを作成）。 - Perform
SetFunctionName (func,"anonymous" )（関数名を設定）。 - If kind is
generator , then- Let prototype be
OrdinaryObjectCreate (%GeneratorPrototype% )（ジェネレータのプロトタイプを作成）。 - Perform !
DefinePropertyOrThrow (func,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }).（prototype プロパティを定義）。
- Let prototype be
- Else if kind is
async-generator , then- Let prototype be
OrdinaryObjectCreate (%AsyncGeneratorPrototype% )（非同期ジェネレータのプロトタイプを作成）。 - Perform !
DefinePropertyOrThrow (func,"prototype" , PropertyDescriptor { [[Value]]: prototype, [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false }).（prototype を定義）。
- Let prototype be
- Else if kind is
normal , then- Perform
MakeConstructor (func)（関数をコンストラクタにする）。
- Perform
NOTE : kind がasync の関数は constructable でなく、[[Construct]] 内部メソッドや"prototype" プロパティを持たない。- Return func（作成した関数を返す）。
CreateDynamicFunction は、作成する関数のうち kind が
20.2.2 Function コンストラクタのプロパティ
Function コンストラクタ：
- それ自体が組み込みの関数オブジェクトである。
- [[Prototype]] 内部スロットを持ち、その値は
%Function.prototype% である。 "length" プロパティの値は1 𝔽 である。- 以下のプロパティを持つ：
20.2.2.1 Function.prototype
Function.prototype の値は
This property has the attributes { [[Writable]]:
20.2.3 Function プロトタイプオブジェクトのプロパティ
Function プロトタイプオブジェクト は次のとおりである：
- は %Function.prototype% である。
- それ自体が組み込み関数オブジェクトである。
- 任意の引数を受け取り、呼び出されると
undefined を返す。 - [[Construct]] 内部メソッドを持たない；したがって
new演算子でコンストラクタとして使用できない。 - [[Prototype]] 内部スロットを持ち、その値は
%Object.prototype% である。 "prototype" プロパティを持たない。"length" プロパティの値は+0 𝔽 である。"name" プロパティの値は空文字列である。
Function プロトタイプオブジェクトは、ECMAScript 2015 以前に作成された ECMAScript コードとの互換性を確保するために関数オブジェクトとして指定されている。
20.2.3.1 Function.prototype.apply ( thisArg, argArray )
このメソッドは呼び出されたときに次の手順を実行する：
- Let func be the
this value（this を func とする）。 - If
IsCallable (func) isfalse , throw aTypeError exception（呼び出し可能でなければ例外）。 - If argArray is either
undefined ornull , then- Perform
PrepareForTailCall (). - Return ?
Call (func, thisArg)（引数なしで呼び出す）。
- Perform
- Let argList be ?
CreateListFromArrayLike (argArray)（配列様オブジェクトから引数リストを作る）。 - Perform
PrepareForTailCall (). - Return ?
Call (func, thisArg, argList)（作成した引数リストで呼び出す）。
thisArg の値は修飾されずに this 値として渡される。これは Edition 3 からの変更であり、Edition 3 では
もし func がアロー関数かバウンド関数エキゾチックオブジェクトである場合、thisArg はステップ
20.2.3.2 Function.prototype.bind ( thisArg, ...args )
このメソッドは呼び出されたときに次の手順を実行する：
- Let target be the
this value（this を target とする）。 - If
IsCallable (target) isfalse , throw aTypeError exception（呼び出し可能でなければ例外）。 - Let boundFunc be ?
BoundFunctionCreate (target, thisArg, args)（バウンド関数を作成する）。 - Let length be 0（length を 0 に初期化）。
- Let targetHasLength be ?
HasOwnProperty (target,"length" )（ターゲットに length 自身プロパティがあるか確認）。 - If targetHasLength is
true , then- Let targetLen be ?
Get (target,"length" )（ターゲットの length を取得）。 - If targetLen
is a Number , then- If targetLen is
+∞ 𝔽, then- Set length to +∞.
- Else if targetLen is
-∞ 𝔽, then- Set length to 0.
- Else,
- Let targetLenAsInt be !
ToIntegerOrInfinity (targetLen)（整数に変換）。 Assert : targetLenAsInt isfinite （有限であることを主張）。- Let argCount be the number of elements in args（バインドする引数の数）。
- Set length to
max (targetLenAsInt - argCount, 0)（残りの引数数を length に設定）。
- Let targetLenAsInt be !
- If targetLen is
- Let targetLen be ?
- Perform
SetFunctionLength (boundFunc, length)（バウンド関数の length を設定）。 - Let targetName be ?
Get (target,"name" )（ターゲットの name を取得）。 - If targetName
is not a String , set targetName to the empty String（文字列でなければ空文字）。 - Perform
SetFunctionName (boundFunc, targetName,"bound" )（名前を設定し "bound" を付加）。 - Return boundFunc（バウンド関数を返す）。
Function.prototype.bind で作成された関数オブジェクトはエキゾチックオブジェクトである。また
もし target がアロー関数かバウンド関数エキゾチックオブジェクトである場合、このメソッドに渡された thisArg は後続の func 呼び出しで使用されない。
20.2.3.3 Function.prototype.call ( thisArg, ...args )
このメソッドは呼び出されたときに次の手順を実行する：
- Let func be the
this value（this を func とする）。 - If
IsCallable (func) isfalse , throw aTypeError exception（呼び出し可能でなければ例外）。 - Perform
PrepareForTailCall (). - Return ?
Call (func, thisArg, args)（引数で呼び出す）。
thisArg の値は修飾されずに this 値として渡される。これは Edition 3 からの変更である。非 strict 関数は関数内部に入るときにこれらの変換を行う。
もし func がアロー関数かバウンド関数エキゾチックオブジェクトである場合、thisArg はステップ
20.2.3.4 Function.prototype.constructor
Function.prototype.constructor の初期値は
20.2.3.5 Function.prototype.toString ( )
このメソッドは呼び出されたときに次の手順を実行する：
- Let func be the
this value（this を func とする）。 - If func
is an Object , func has a [[SourceText]] internal slot, func.[[SourceText]] is a sequence of Unicode code points, andHostHasSourceTextAvailable (func) istrue , then- Return
CodePointsToString (func.[[SourceText]])（ソーステキストが利用可能ならそれを返す）。
- Return
- If func is a
built-in function object , return animplementation-defined String source code representation of func. The representation must have the syntax of aNativeFunction . Additionally, if func has an [[InitialName]] internal slot and func.[[InitialName]]is a String , the portion of the returned String that would be matched byNativeFunctionAccessor opt PropertyName must be func.[[InitialName]]. - If func
is an Object andIsCallable (func) istrue , return animplementation-defined String source code representation of func. The representation must have the syntax of aNativeFunction . - Throw a
TypeError exception（上に当てはまらなければ例外）。
20.2.3.6 Function.prototype [ %Symbol.hasInstance% ] ( value )
このメソッドは呼び出されたときに次の手順を実行する：
- Let thisValue be the
this value（this を取得する）。 - Return ?
OrdinaryHasInstance (thisValue, value)（ordinary has-instance を実行して返す）。
This property has the attributes { [[Writable]]:
これは %Symbol.hasInstance% のデフォルト実装であり、多くの関数が継承する。instanceof 演算子は特定のコンストラクタのインスタンスか否かを判定するために %Symbol.hasInstance% を呼び出す。式
v instanceof Fは次と評価される：
F[%Symbol.hasInstance%](v)コンストラクタ関数は関数上に異なる %Symbol.hasInstance% メソッドを公開することで instanceof によって認識されるオブジェクトを制御できる。
このプロパティはバウンド関数の対象関数をグローバルに公開するための改変を防ぐために書き換え不可かつ設定不可である。
The value of the
20.2.4 関数インスタンス
すべての Function インスタンスは ECMAScript の関数オブジェクトであり、Function.prototype.bind によって作られた関数オブジェクトは
関数インスタンスは以下のプロパティを持つ：
20.2.4.1 length
20.2.4.2 name
この仕様によって文脈上の名前が関連付けられていない匿名関数オブジェクトは、
20.2.4.3 prototype
コンストラクタとして使用できる関数インスタンスは
このプロパティは属性 { [[Writable]]:
Function.prototype.bind で作成された関数、または
20.2.5 HostHasSourceTextAvailable ( func )
The
HostHasSourceTextAvailable の実装は次の要件に従わなければならない：
- 引数に関して決定的でなければならない。特定の func を引数として呼び出した場合、常に同じ結果を返さなければならない。
HostHasSourceTextAvailable のデフォルト実装は
20.3 Boolean オブジェクト
20.3.1 Boolean コンストラクタ
Boolean コンストラクタ：
- は %Boolean% である。
グローバルオブジェクト の"Boolean" プロパティの初期値である。- コンストラクタとして呼び出されたときに新しい Boolean オブジェクトを作成・初期化する。
- コンストラクタとしてではなく関数として呼び出されたときに型変換を行う。
- クラス定義の
extends節の値として使用されることがある。指定された Boolean 振る舞いを継承することを意図するサブクラスのコンストラクタは、[[BooleanData]] 内部スロットを持つサブクラスインスタンスを作成・初期化するために Boolean コンストラクタへのsuper呼び出しを含まなければならない。
20.3.1.1 Boolean ( value )
この関数は呼び出されたときに次の手順を実行する：
- Let b be
ToBoolean (value)（値を真偽値に変換する）。 - If NewTarget is
undefined , return b（NewTarget が undefined ならプリミティブ真偽値を返す）。 - Let obj be ?
OrdinaryCreateFromConstructor (NewTarget,"%Boolean.prototype%" , « [[BooleanData]] »)（コンストラクタから Boolean オブジェクトを作る）。 - Set obj.[[BooleanData]] to b（内部スロットに値を格納）。
- Return obj（オブジェクトを返す）。
20.3.2 Boolean コンストラクタのプロパティ
Boolean コンストラクタ：
- [[Prototype]] 内部スロットを持ち、その値は
%Function.prototype% である。 - 以下のプロパティを持つ：
20.3.2.1 Boolean.prototype
Boolean.prototype の初期値は
This property has the attributes { [[Writable]]:
20.3.3 Boolean プロトタイプオブジェクトのプロパティ
Boolean プロトタイプオブジェクト は次のとおりである：
- は %Boolean.prototype% である。
- 通常オブジェクトである。
- 自身が Boolean オブジェクトであり、[[BooleanData]] 内部スロットを持ち、その値は
false である。 - [[Prototype]] 内部スロットを持ち、その値は
%Object.prototype% である。
20.3.3.1 Boolean.prototype.constructor
Boolean.prototype.constructor の初期値は
20.3.3.2 Boolean.prototype.toString ( )
このメソッドは呼び出されたときに次の手順を実行する：
- Let b be ?
ThisBooleanValue (this value)（this の Boolean 値を取得する）。 - If b is
true , return"true" （真なら "true" を返す）。 - Return
"false" （それ以外は "false" を返す）。
20.3.3.3 Boolean.prototype.valueOf ( )
このメソッドは呼び出されたときに次の手順を実行する：
- Return ?
ThisBooleanValue (this value)（this の Boolean 値を返す）。
20.3.3.3.1 ThisBooleanValue ( value )
The
- If value
is a Boolean , return value（プリミティブ Boolean ならそのまま返す）。 - If value
is an Object and value has a [[BooleanData]] internal slot, then- Let b be value.[[BooleanData]]（内部スロットの値を取得）。
Assert : bis a Boolean （b が Boolean であることを主張）。- Return b（その値を返す）。
- Throw a
TypeError exception（それ以外は例外）。
20.3.4 Boolean インスタンスのプロパティ
Boolean インスタンスは
20.4 Symbol オブジェクト
20.4.1 Symbol コンストラクタ
Symbol コンストラクタ：
- は %Symbol% である。
グローバルオブジェクト の"Symbol" プロパティの初期値である。- 関数として呼び出されたときに新しい Symbol 値を返す。
new演算子で使用することを意図していない。- サブクラス化することを意図していない。
- クラス定義の
extends節の値として使用されることがあるが、それに対するsuper呼び出しは例外を引き起こす。
20.4.1.1 Symbol ( [ description ] )
この関数は呼び出されたときに次の手順を実行する：
- If NewTarget is not
undefined , throw aTypeError exception（NewTarget が定義されている場合は例外）。 - If description is
undefined , let descString beundefined （説明が undefined なら descString を undefined にする）。 - Else, let descString be ?
ToString (description)（そうでなければ文字列化する）。 - Return a new Symbol whose [[Description]] is descString（説明を持つ新しい Symbol を返す）。
20.4.2 Symbol コンストラクタのプロパティ
Symbol コンストラクタ：
- [[Prototype]] 内部スロットを持ち、その値は
%Function.prototype% である。 - 以下のプロパティを持つ：
20.4.2.1 Symbol.asyncIterator
Symbol.asyncIterator の初期値は既知のシンボル
This property has the attributes { [[Writable]]:
20.4.2.2 Symbol.for ( key )
この関数は呼び出されたときに次の手順を実行する：
- Let stringKey be ?
ToString (key)（キーを文字列に変換する）。 - For each element e of the
GlobalSymbolRegistry List , do- If e.[[Key]] is stringKey, return e.[[Symbol]]（既に登録されていればそのシンボルを返す）。
Assert : TheGlobalSymbolRegistry List does not currently contain an entry for stringKey（登録されていないことを主張）。- Let newSymbol be a new Symbol whose [[Description]] is stringKey（新しいシンボルを作る）。
- Append the GlobalSymbolRegistry
Record { [[Key]]: stringKey, [[Symbol]]: newSymbol } to theGlobalSymbolRegistry List （登録リストに追加）。 - Return newSymbol（新しいシンボルを返す）。
GlobalSymbolRegistry List は追記のみ可能なグローバルに利用可能なリストである。すべての
20.4.2.3 Symbol.hasInstance
Symbol.hasInstance の初期値は既知のシンボル
This property has the attributes { [[Writable]]:
20.4.2.4 Symbol.isConcatSpreadable
Symbol.isConcatSpreadable の初期値は既知のシンボル
This property has the attributes { [[Writable]]:
20.4.2.5 Symbol.iterator
Symbol.iterator の初期値は既知のシンボル
This property has the attributes { [[Writable]]:
20.4.2.6 Symbol.keyFor ( sym )
この関数は呼び出されたときに次の手順を実行する：
- If sym
is not a Symbol , throw aTypeError exception（sym がシンボルでなければ例外）。 - Return
KeyForSymbol (sym)（キーを返す）。
20.4.2.7 Symbol.match
Symbol.match の初期値は既知のシンボル
This property has the attributes { [[Writable]]:
20.4.2.8 Symbol.matchAll
Symbol.matchAll の初期値は既知のシンボル
This property has the attributes { [[Writable]]:
20.4.2.9 Symbol.prototype
Symbol.prototype の初期値は
This property has the attributes { [[Writable]]:
20.4.2.10 Symbol.replace
Symbol.replace の初期値は既知のシンボル
This property has the attributes { [[Writable]]:
20.4.2.11 Symbol.search
Symbol.search の初期値は既知のシンボル
This property has the attributes { [[Writable]]:
20.4.2.12 Symbol.species
Symbol.species の初期値は既知のシンボル
This property has the attributes { [[Writable]]:
20.4.2.13 Symbol.split
Symbol.split の初期値は既知のシンボル
This property has the attributes { [[Writable]]:
20.4.2.14 Symbol.toPrimitive
Symbol.toPrimitive の初期値は既知のシンボル
This property has the attributes { [[Writable]]:
20.4.2.15 Symbol.toStringTag
Symbol.toStringTag の初期値は既知のシンボル
This property has the attributes { [[Writable]]:
20.4.2.16 Symbol.unscopables
Symbol.unscopables の初期値は既知のシンボル
This property has the attributes { [[Writable]]:
20.4.3 Symbol プロトタイプオブジェクトのプロパティ
Symbol プロトタイプオブジェクト は次のとおりである：
- は %Symbol.prototype% である。
- 通常オブジェクトである。
- Symbol インスタンスではなく、[[SymbolData]] 内部スロットを持たない。
- [[Prototype]] 内部スロットを持ち、その値は
%Object.prototype% である。
20.4.3.1 Symbol.prototype.constructor
Symbol.prototype.constructor の初期値は
20.4.3.2 get Symbol.prototype.description
Symbol.prototype.description は set アクセサが
- Let s be the
this value（this を取得）。 - Let sym be ?
ThisSymbolValue (s)（this からシンボル値を取得）。 - Return sym.[[Description]]（その説明を返す）。
20.4.3.3 Symbol.prototype.toString ( )
このメソッドは呼び出されたときに次の手順を実行する：
- Let sym be ?
ThisSymbolValue (this value)（this のシンボル値を取得）。 - Return
SymbolDescriptiveString (sym)（記述文字列を返す）。
20.4.3.3.1 SymbolDescriptiveString ( sym )
The
- Let desc be sym.[[Description]]（説明を取得）。
- If desc is
undefined , set desc to the empty String（説明が undefined なら空文字にする）。 Assert : descis a String （文字列であることを主張）。- Return the
string-concatenation of"Symbol(" , desc, and")" （"Symbol(" + desc + ")" を返す）。
20.4.3.4 Symbol.prototype.valueOf ( )
このメソッドは呼び出されたときに次の手順を実行する：
- Return ?
ThisSymbolValue (this value)（this のシンボル値を返す）。
20.4.3.4.1 ThisSymbolValue ( value )
The
- If value
is a Symbol , return value（プリミティブ Symbol なら返す）。 - If value
is an Object and value has a [[SymbolData]] internal slot, then- Let s be value.[[SymbolData]]（内部スロットのシンボルを取得）。
Assert : sis a Symbol （シンボルであることを主張）。- Return s（返す）。
- Throw a
TypeError exception（それ以外は例外）。
20.4.3.5 Symbol.prototype [ %Symbol.toPrimitive% ] ( hint )
このメソッドは ECMAScript の演算子によって Symbol オブジェクトをプリミティブ値に変換するために呼び出される。
呼び出されたときに次の手順を実行する：
- Return ?
ThisSymbolValue (this value)（this のシンボル値を返す）。
引数は無視される。
This property has the attributes { [[Writable]]:
The value of the
20.4.3.6 Symbol.prototype [ %Symbol.toStringTag% ]
This property has the attributes { [[Writable]]:
20.4.4 Symbol インスタンスのプロパティ
Symbol インスタンスは
20.4.5 シンボルのための抽象操作
20.4.5.1 KeyForSymbol ( sym )
The
- For each element e of the
GlobalSymbolRegistry List , do- If
SameValue (e.[[Symbol]], sym) istrue , return e.[[Key]]（一致するエントリのキーを返す）。
- If
Assert : TheGlobalSymbolRegistry List does not currently contain an entry for sym（登録されていないことを主張）。- Return
undefined （見つからなければ undefined を返す）。
20.5 Error オブジェクト
エラーオブジェクトのインスタンスは実行時エラーが発生したときに例外として投げられる。Error オブジェクトはユーザー定義の例外クラスの基底オブジェクトとしても使用され得る。
ECMAScript 実装が実行時エラーを検出したとき、それは
20.5.1 Error コンストラクタ
Error コンストラクタ：
- は %Error% である。
グローバルオブジェクト の"Error" プロパティの初期値である。- コンストラクタとしてではなく関数として呼び出されたときに新しい Error オブジェクトを作成・初期化する。したがって関数呼び出し Error(…) は new Error(…) と同等である。
- クラス定義の
extends節の値として使用されることがある。指定された Error 振る舞いを継承するサブクラスのコンストラクタは、[[ErrorData]] 内部スロットを持つサブクラスインスタンスを作成・初期化するために Error コンストラクタへのsuper呼び出しを含まなければならない。
20.5.1.1 Error ( message [ , options ] )
この関数は呼び出されたときに次の手順を実行する：
- If NewTarget is
undefined , let newTarget be theactive function object ; else let newTarget be NewTarget（NewTarget が undefined ならアクティブ関数を使う）。 - Let obj be ?
OrdinaryCreateFromConstructor (newTarget,"%Error.prototype%" , « [[ErrorData]] »)（Error オブジェクトを作成）。 - If message is not
undefined , then- Let msg be ?
ToString (message)（メッセージを文字列化）。 - Perform
CreateNonEnumerableDataPropertyOrThrow (obj,"message" , msg)（message プロパティを非列挙で作成）。
- Let msg be ?
- Perform ?
InstallErrorCause (obj, options)（cause オプションをインストール）。 - Return obj（オブジェクトを返す）。
20.5.2 Error コンストラクタのプロパティ
Error コンストラクタ：
- [[Prototype]] 内部スロットを持ち、その値は
%Function.prototype% である。 - 以下のプロパティを持つ：
20.5.2.1 Error.isError ( arg )
この関数は呼び出されたときに次の手順を実行する：
- If arg
is not an Object , returnfalse （オブジェクトでなければ false）。 - If arg does not have an [[ErrorData]] internal slot, return
false （[[ErrorData]] がなければ false）。 - Return
true （それ以外は true）。
20.5.2.2 Error.prototype
Error.prototype の初期値は
This property has the attributes { [[Writable]]:
20.5.3 Error プロトタイプオブジェクトのプロパティ
Error プロトタイプオブジェクト は次のとおりである：
- は %Error.prototype% である。
- 通常オブジェクトである。
- Error インスタンスではなく [[ErrorData]] 内部スロットを持たない。
- [[Prototype]] 内部スロットを持ち、その値は
%Object.prototype% である。
20.5.3.1 Error.prototype.constructor
Error.prototype.constructor の初期値は
20.5.3.2 Error.prototype.message
Error.prototype.message の初期値は空文字列である。
20.5.3.3 Error.prototype.name
Error.prototype.name の初期値は
20.5.3.4 Error.prototype.toString ( )
このメソッドは呼び出されたときに次の手順を実行する：
- Let obj be the
this value（this を取得）。 - If obj
is not an Object , throw aTypeError exception（オブジェクトでなければ例外）。 - Let name be ?
Get (obj,"name" )（name を取得）。 - If name is
undefined , set name to"Error" ; else set name to ?ToString (name)（name が undefined なら "Error"、そうでなければ文字列化）。 - Let msg be ?
Get (obj,"message" )（message を取得）。 - If msg is
undefined , set msg to the empty String; else set msg to ?ToString (msg)（message が undefined なら空文字、そうでなければ文字列化）。 - If name is the empty String, return msg（name が空なら message を返す）。
- If msg is the empty String, return name（message が空なら name を返す）。
- Return the
string-concatenation of name, the code unit 0x003A (COLON), the code unit 0x0020 (SPACE), and msg（"name: message" を返す）。
20.5.4 Error インスタンスのプロパティ
Error インスタンスは Object.prototype.toString と Error.isError によって Error、AggregateError、NativeError のインスタンスを Error オブジェクトとして識別することである。
20.5.5 この標準で使用されるネイティブエラー型
以下の NativeError オブジェクトのいずれか、あるいは AggregateError オブジェクトの新しいインスタンスが実行時エラー検出時に投げられる。すべての NativeError オブジェクトは共通の構造を共有し、その構造は
20.5.5.1 EvalError
EvalError コンストラクタは %EvalError% である。
この例外は現在この仕様内では使用されていない。互換性のために残されている。
20.5.5.2 RangeError
RangeError コンストラクタは %RangeError% である。
許容される値の集合や範囲に入らない値を示す。
20.5.5.3 ReferenceError
ReferenceError コンストラクタは %ReferenceError% である。
無効な参照が検出されたことを示す。
20.5.5.4 SyntaxError
SyntaxError コンストラクタは %SyntaxError% である。
パースエラーが発生したことを示す。
20.5.5.5 TypeError
TypeError コンストラクタは %TypeError% である。
他のいずれの NativeError も失敗原因を適切に示すものではない場合に、不成功な操作を示すために使用される。
20.5.5.6 URIError
URIError コンストラクタは %URIError% である。
グローバル URI 処理関数のいずれかがその定義と互換性のない方法で使用されたことを示す。
20.5.6 NativeError オブジェクトの構造
これらの各オブジェクトは下記に示す構造を持ち、コンストラクタ名とプロトタイプオブジェクトの
各エラーオブジェクトについて、定義中の NativeError への参照は
20.5.6.1 NativeError コンストラクタ
各 NativeError コンストラクタ：
- コンストラクタではなく関数として呼び出されたときに新しい NativeError オブジェクトを作成・初期化する。同一の引数で関数として呼ぶことはコンストラクタとして呼ぶことと等価である。したがって関数呼び出し
NativeError(…)は newNativeError(…)と等しい。 - クラス定義の
extends節の値として使用されることがある。指定された NativeError 振る舞いを継承しようとするサブクラスのコンストラクタは、[[ErrorData]] 内部スロットを持つサブクラスインスタンスを作成・初期化するために NativeError コンストラクタへのsuper呼び出しを含まなければならない。
20.5.6.1.1 NativeError ( message [ , options ] )
各 NativeError 関数は呼び出されたときに次の手順を実行する：
- If NewTarget is
undefined , let newTarget be theactive function object ; else let newTarget be NewTarget（NewTarget を決定）。 - Let obj be ?
OrdinaryCreateFromConstructor (newTarget,"%NativeError.prototype%", « [[ErrorData]] »)（オブジェクトを作成）。 - If message is not
undefined , then- Let msg be ?
ToString (message)（メッセージを文字列化）。 - Perform
CreateNonEnumerableDataPropertyOrThrow (obj,"message" , msg)（message を非列挙プロパティとして作成）。
- Let msg be ?
- Perform ?
InstallErrorCause (obj, options)（cause オプションをインストール）。 - Return obj（作成したオブジェクトを返す）。
ステップ
20.5.6.2 NativeError コンストラクタのプロパティ
各 NativeError コンストラクタ：
- [[Prototype]] 内部スロットを持ち、その値は
%Error% である。 "name" プロパティの値は文字列値"NativeError" である。- 以下のプロパティを持つ：
20.5.6.2.1 NativeError.prototype
NativeError.prototype の初期値は NativeError プロトタイプオブジェクトである（
This property has the attributes { [[Writable]]:
20.5.6.3 NativeError プロトタイプオブジェクトのプロパティ
各 NativeError プロトタイプオブジェクト は次のとおりである：
- 通常オブジェクトである。
- Error インスタンスではなく [[ErrorData]] 内部スロットを持たない。
- [[Prototype]] 内部スロットを持ち、その値は
%Error.prototype% である。
20.5.6.3.1 NativeError.prototype.constructor
特定の NativeError コンストラクタに対するプロトタイプの
20.5.6.3.2 NativeError.prototype.message
特定の NativeError コンストラクタに対するプロトタイプの
20.5.6.3.3 NativeError.prototype.name
特定の NativeError コンストラクタに対するプロトタイプの
20.5.6.4 NativeError インスタンスのプロパティ
NativeError インスタンスはその NativeError プロトタイプオブジェクトからプロパティを継承する通常オブジェクトであり、[[ErrorData]] 内部スロットを持ち、その値は Object.prototype.toString と Error.isError によって Error、AggregateError、または NativeError のインスタンスを識別することである。
20.5.7 AggregateError オブジェクト
20.5.7.1 AggregateError コンストラクタ
AggregateError コンストラクタ：
- は %AggregateError% である。
グローバルオブジェクト の"AggregateError" プロパティの初期値である。- コンストラクタではなく関数として呼び出されたときに新しい AggregateError オブジェクトを作成・初期化する。したがって関数呼び出し AggregateError(…) は new AggregateError(…) と等しい。
- クラス定義の
extends節の値として使用されることがある。指定された AggregateError 振る舞いを継承するサブクラスのコンストラクタは、[[ErrorData]] 内部スロットを持つサブクラスインスタンスを作成・初期化するために AggregateError コンストラクタへのsuper呼び出しを含まなければならない。
20.5.7.1.1 AggregateError ( errors, message [ , options ] )
この関数は呼び出されたときに次の手順を実行する：
- If NewTarget is
undefined , let newTarget be theactive function object ; else let newTarget be NewTarget（NewTarget を決める）。 - Let obj be ?
OrdinaryCreateFromConstructor (newTarget,"%AggregateError.prototype%" , « [[ErrorData]] »)（AggregateError オブジェクトを作成）。 - If message is not
undefined , then- Let msg be ?
ToString (message)（メッセージを文字列化）。 - Perform
CreateNonEnumerableDataPropertyOrThrow (obj,"message" , msg)（message を作成）。
- Let msg be ?
- Perform ?
InstallErrorCause (obj, options)（cause をインストール）。 - Let errorsList be ?
IteratorToList (?GetIterator (errors,sync ))（errors から同期イテレータを取得してリスト化）。 - Perform !
DefinePropertyOrThrow (obj,"errors" , PropertyDescriptor { [[Configurable]]:true , [[Enumerable]]:false , [[Writable]]:true , [[Value]]:CreateArrayFromList (errorsList) })（errors プロパティを作成）。 - Return obj（オブジェクトを返す）。
20.5.7.2 AggregateError コンストラクタのプロパティ
AggregateError コンストラクタ：
- [[Prototype]] 内部スロットを持ち、その値は
%Error% である。 - 以下のプロパティを持つ：
20.5.7.2.1 AggregateError.prototype
AggregateError.prototype の初期値は
This property has the attributes { [[Writable]]:
20.5.7.3 AggregateError プロトタイプオブジェクトのプロパティ
AggregateError プロトタイプオブジェクト は次のとおりである：
- は %AggregateError.prototype% である。
- 通常オブジェクトである。
- Error インスタンスや AggregateError インスタンスではなく、[[ErrorData]] 内部スロットを持たない。
- [[Prototype]] 内部スロットを持ち、その値は
%Error.prototype% である。
20.5.7.3.1 AggregateError.prototype.constructor
AggregateError.prototype.constructor の初期値は
20.5.7.3.2 AggregateError.prototype.message
AggregateError.prototype.message の初期値は空文字列である。
20.5.7.3.3 AggregateError.prototype.name
AggregateError.prototype.name の初期値は
20.5.7.4 AggregateError インスタンスのプロパティ
AggregateError インスタンスは Object.prototype.toString と Error.isError によって Error、AggregateError、または NativeError のインスタンスを識別することである。
20.5.8 エラーオブジェクトの抽象操作
20.5.8.1 InstallErrorCause ( obj, options )
The
- If options
is an Object and ?HasProperty (options,"cause" ) istrue , then- Let cause be ?
Get (options,"cause" )（options.cause を取得）。 - Perform
CreateNonEnumerableDataPropertyOrThrow (obj,"cause" , cause)（cause を非列挙プロパティとして作成）。
- Let cause be ?
- Return
unused （何も返さない）。
21 Numbers and Dates
21.1 数値オブジェクト
21.1.1 Number コンストラクター
Number コンストラクターは次の通りです:
- %Number% です。
グローバルオブジェクト の"Number" プロパティの初期値です。- コンストラクターとして呼び出された場合、新しい Number オブジェクトを作成して初期化します。
- 関数として呼び出された場合は型変換を行います。
- クラス定義の
extends節の値として使用できる場合があります。指定された Number の振る舞いを継承するサブクラスのコンストラクターは、サブクラスインスタンスを [[NumberData]] 内部スロットで作成・初期化するために、Number コンストラクターへのsuper呼び出しを含める必要があります。
21.1.1.1 Number ( value )
この関数は呼び出されたときに以下の手順を実行します:
- value が存在する場合、次を行う:
- 存在しない場合、次を行う:
- n を
+0 𝔽 とする。
- n を
- NewTarget が
undefined の場合、n を返す。 - obj を ?
OrdinaryCreateFromConstructor (NewTarget,"%Number.prototype%" , « [[NumberData]] ») とする。 - obj.[[NumberData]] に n を設定する。
- obj を返す。
21.1.2 Numberコンストラクターのプロパティ
Numberコンストラクターは:
- [[Prototype]]内部スロットを持ち、その値は
%Function.prototype% です。 - 次のプロパティを持ちます:
21.1.2.1 Number.EPSILON
Number.EPSILON の値は、1とNumber値として表現可能な1より大きい最小値との差の大きさを表すNumber値であり、概ね 2.2204460492503130808472633361816 × 10-16 です。
このプロパティの属性は { [[Writable]]:
21.1.2.2 Number.isFinite ( number )
この関数は呼び出されたとき、以下の手順を実行します:
- number がNumberでなければ、
false を返します。 - number が有限でなければ、
false を返します。 true を返します。
21.1.2.3 Number.isInteger ( number )
この関数は呼び出されたとき、以下の手順を実行します:
- number が整数のNumberであれば、
true を返します。 false を返します。
21.1.2.4 Number.isNaN ( number )
この関数は呼び出されたとき、以下の手順を実行します:
- number がNumberでなければ、
false を返します。 - number が
NaN であれば、true を返します。 false を返します。
この関数はグローバル関数 isNaN (
21.1.2.5 Number.isSafeInteger ( number )
整数 n が "安全な整数" であるのは、n のNumber値が他の整数のNumber値と一致しない場合に限ります。
この関数は呼び出されたとき、以下の手順を実行します:
21.1.2.6 Number.MAX_SAFE_INTEGER
Number.MAX_SAFE_INTEGER より大きいすべての整数のNumber値は少なくとも1つの他の整数と共有されます。このため、このような大きな整数は 9007199254740992 と 9007199254740993 はどちらも Number値
Number.MAX_SAFE_INTEGER の値は
このプロパティの属性は { [[Writable]]:
21.1.2.7 Number.MAX_VALUE
Number.MAX_VALUE の値はNumber型の最大の正の有限値であり、概ね
このプロパティの属性は { [[Writable]]:
21.1.2.8 Number.MIN_SAFE_INTEGER
Number.MIN_SAFE_INTEGER より小さいすべての整数のNumber値は少なくとも1つの他の整数と共有されます。このため、このような大きな負の整数は -9007199254740992 と -9007199254740993 はどちらも Number値
Number.MIN_SAFE_INTEGER の値は
このプロパティの属性は { [[Writable]]:
21.1.2.9 Number.MIN_VALUE
Number.MIN_VALUE の値はNumber型の最小の正の値であり、概ね
Number.MIN_VALUE の値は実際に実装によって表現可能な最小の非ゼロ正の値でなければなりません。
このプロパティの属性は { [[Writable]]:
21.1.2.10 Number.NaN
Number.NaN の値は
このプロパティの属性は { [[Writable]]:
21.1.2.11 Number.NEGATIVE_INFINITY
Number.NEGATIVE_INFINITY の値は
このプロパティの属性は { [[Writable]]:
21.1.2.12 Number.parseFloat ( string )
21.1.2.13 Number.parseInt ( string, radix )
21.1.2.14 Number.POSITIVE_INFINITY
Number.POSITIVE_INFINITY の値は
このプロパティの属性は { [[Writable]]:
21.1.2.15 Number.prototype
Number.prototype の初期値は
このプロパティの属性は { [[Writable]]:
21.1.3 Numberプロトタイプオブジェクトのプロパティ
Numberプロトタイプオブジェクトは:
- %Number.prototype% です。
- 通常のオブジェクトです。
- それ自体がNumberオブジェクトであり、[[NumberData]] 内部スロットを持ち、その値は
+0 𝔽 です。 - [[Prototype]] 内部スロットを持ち、その値は
%Object.prototype% です。
特に明記されていない限り、下記に定義されるNumberプロトタイプオブジェクトのメソッドは汎用的ではなく、渡される
メソッド仕様内の “this Number value” は、抽象操作 ThisNumberValue に
21.1.3.1 Number.prototype.constructor
Number.prototype.constructor の初期値は
21.1.3.2 Number.prototype.toExponential ( fractionDigits )
このメソッドは、このNumber値を10進指数表記で文字列として返します。小数点の前に1桁、後に fractionDigits 桁を表示します。fractionDigits が
呼び出されたとき、以下の手順を実行します:
- numberValue を ? ThisNumberValue(
this value) とする。 - fractionCount を ?
ToIntegerOrInfinity (fractionDigits) とする。 Assert : fractionDigits がundefined ならば、fractionCount は 0 である。- numberValue が有限でないならば、
Number::toString (numberValue, 10) を返す。 - fractionCount < 0 または fractionCount > 100 ならば、
RangeError 例外を投げる。 - numberValue を
ℝ (numberValue) に設定する。 - sign を空の String とする。
- numberValue < 0 ならば、
- sign を
"-" に設定する。 - numberValue を -numberValue に設定する。
- sign を
- numberValue = 0 ならば、
- significand を、コード単位 0x0030 (DIGIT ZERO) が fractionCount + 1 個出現するものからなる String 値とする。
- exponent を 0 とする。
- そうでなければ、
- fractionDigits が
undefined でないならば、- exponent と intSignificand を、10fractionCount ≤ intSignificand < 10fractionCount + 1 であり、かつ intSignificand × 10exponent - fractionCount - numberValue が可能な限りゼロに近くなるような整数とする。そのような exponent と intSignificand の組が 2 つある場合、intSignificand × 10exponent - fractionCount がより大きい方の exponent と intSignificand を選ぶ。
- そうでなければ、
- significand を、intSignificand の十進表現の各桁からなる String 値（順に、先頭のゼロなし）とする。
- fractionDigits が
- fractionCount ≠ 0 ならば、
- integerPart を significand の最初のコード単位とする。
- fractionalPart を significand の他の fractionCount 個のコード単位とする。
- significand を、integerPart、
"." 、および fractionalPart の文字列連結に設定する。
- exponent = 0 ならば、
- exponentSign を
"+" とする。 - exponentDigits を
"0" とする。
- exponentSign を
- そうでなければ、
- exponent > 0 ならば、
- exponentSign を
"+" とする。
- exponentSign を
- そうでなければ、
Assert : exponent < 0。- exponentSign を
"-" とする。 - exponent を -exponent に設定する。
- exponentDigits を、exponent の十進表現の各桁からなる String 値（順に、先頭のゼロなし）とする。
- exponent > 0 ならば、
- significand を、significand、
"e" 、exponentSign、および exponentDigits の文字列連結に設定する。 - sign と significand の文字列連結を返す。
上記の規則で要求されるよりも正確な変換を提供する実装については、step
- exponent、intSignificand、および ff を、ff ≥ 0、10ff ≤ intSignificand < 10ff + 1、
𝔽 (intSignificand × 10exponent - ff) が𝔽 (numberValue) であり、かつ ff が可能な限り小さいような整数とする。intSignificand について複数の可能性がある場合、𝔽 (intSignificand × 10exponent - ff) が𝔽 (numberValue) に最も近くなるような intSignificand を選ぶ。そのような intSignificand の値が 2 つある場合、偶数である方を選ぶ。
21.1.3.3 Number.prototype.toFixed ( fractionDigits )
このメソッドは、このNumber値を小数固定表記で文字列として返します。小数点以下に fractionDigits 桁を表示します。fractionDigits が
呼び出されたとき、以下の手順を実行します:
- numberValue を ? ThisNumberValue(
this value) とする。 - fractionCount を ?
ToIntegerOrInfinity (fractionDigits) とする。 Assert : fractionDigits がundefined の場合、fractionCount は 0。- fractionCount が有限でなければ
RangeError を投げる。 - fractionCount < 0 または fractionCount > 100 なら
RangeError を投げる。 - numberValue が有限でなければ
Number::toString (numberValue, 10) を返す。 - numberValue を
ℝ (numberValue) に設定。 - sign を空文字列に設定。
- numberValue < 0 なら、sign を "-" に設定し、numberValue を -numberValue にする。
- numberValue ≥ 1021 の場合、digitString を !
ToString (𝔽 (numberValue)) とする。 - それ以外の場合、整数値を求め、digitString を生成、fractionCount に応じて小数点を付与。
- sign と digitString を連結して返す。
toFixed は toString よりも正確に表示される場合があります。例:
(1000000000000000128).toString() は
(1000000000000000128).toFixed(0) は
21.1.3.4 Number.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
ECMA-402 Internationalization API を含む実装では、このメソッドを ECMA-402 の仕様に従って実装する必要があります。APIを含まない場合、ホスト環境の現在のロケールに従った文字列を返す実装定義の仕様が適用されます。
21.1.3.5 Number.prototype.toPrecision ( precision )
このメソッドは、このNumber値を小数点1桁と precision - 1 桁の指数表記か、precision 桁の固定表記で文字列として返します。precision が
呼び出されたとき、以下の手順を実行します:
- numberValue を ? ThisNumberValue(
this value) とする。 - precision が
undefined なら !ToString (numberValue) を返す。 - precisionCount を ?
ToIntegerOrInfinity (precision) とする。 - numberValue が有限でなければ
Number::toString (numberValue, 10) を返す。 - precisionCount < 1 または precisionCount > 100 なら
RangeError を投げる。 - numberValue を
ℝ (numberValue) に設定。 - sign を空文字列に設定。
- numberValue < 0 なら sign を "-" に設定し、numberValue を -numberValue にする。
- numberValue = 0 なら、significand に0を precisionCount 回繰り返した文字列を設定、exponent を 0。
- それ以外の場合、exponent, intSignificand を計算して significand を作成。
- 結果として sign と significand を連結して返す。
21.1.3.6 Number.prototype.toString ( [ radix ] )
オプションの radix は2～36の整数であるべきです。radix が
呼び出されたとき、以下の手順を実行します:
- x を ? ThisNumberValue(
this value) とする。 - radix が
undefined なら radixMV を 10 に設定。 - それ以外の場合、radixMV を ?
ToIntegerOrInfinity (radix) とする。 - radixMV が 2～36 の範囲外なら
RangeError を投げる。 Number::toString (x, radixMV) を返す。
このメソッドは汎用的ではなく、
21.1.3.7 Number.prototype.valueOf ( )
- ? ThisNumberValue(
this value) を返す。
21.1.3.7.1 ThisNumberValue ( value: ECMAScript言語値, ): Numberを含む通常完了または例外
- value がNumberなら value を返す。
- value がオブジェクトで [[NumberData]] 内部スロットを持つ場合:
- n を value.[[NumberData]] とする。
Assert : n はNumber。- n を返す。
TypeError を投げる。
21.1.4 Numberインスタンスのプロパティ
Numberインスタンスは通常のオブジェクトで、
21.2 BigIntオブジェクト
21.2.1 BigIntコンストラクター
BigIntコンストラクターは:
- %BigInt% です。
グローバルオブジェクト の"BigInt" プロパティの初期値です。- コンストラクターとしてではなく関数として呼び出された場合、型変換を行います。
new演算子やサブクラス化の目的では使用されません。クラス定義のextendsに使用することは可能ですが、BigIntコンストラクターへのsuper呼び出しは例外を引き起こします。
21.2.1.1 BigInt ( value )
呼び出されたとき、この関数は以下の手順を実行します:
- NewTarget が
undefined でなければTypeError を投げる。 - prim を ?
ToPrimitive (value,number ) とする。 - prim がNumberであれば ? NumberToBigInt(prim) を返す。
- ?
ToBigInt (prim) を返す。
21.2.1.1.1 NumberToBigInt ( number: Number, ): BigIntを返すか例外を投げる
21.2.2 BigIntコンストラクターのプロパティ
BigIntコンストラクターは:
- [[Prototype]] 内部スロットを持ち、その値は
%Function.prototype% です。 - 次のプロパティを持ちます:
21.2.2.1 BigInt.asIntN ( bits, bigint )
呼び出されたとき、以下の手順を実行します:
21.2.2.2 BigInt.asUintN ( bits, bigint )
呼び出されたとき、以下の手順を実行します:
21.2.2.3 BigInt.prototype
BigInt.prototype の初期値は
このプロパティの属性は { [[Writable]]:
21.2.3 BigIntプロトタイプオブジェクトのプロパティ
BigIntプロトタイプオブジェクトは:
- %BigInt.prototype% です。
- 通常のオブジェクトです。
- BigIntオブジェクトではなく、[[BigIntData]] 内部スロットを持ちません。
- [[Prototype]] 内部スロットを持ち、その値は
%Object.prototype% です。
メソッド仕様内の “this BigInt value” は、抽象操作 ThisBigIntValue に
21.2.3.1 BigInt.prototype.constructor
BigInt.prototype.constructor の初期値は
21.2.3.2 BigInt.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
ECMA-402 Internationalization API を含む実装では、ECMA-402 仕様に従ってこのメソッドを実装する必要があります。含まない場合、ホスト環境のロケールに従った文字列を返す実装定義の仕様が適用されます。
21.2.3.3 BigInt.prototype.toString ( [ radix ] )
オプションの radix は2～36の整数であるべきです。radix が
呼び出されたとき、以下の手順を実行します:
- x を ? ThisBigIntValue(
this value) とする。 - radix が
undefined なら radixMV を 10 に設定。 - それ以外の場合、radixMV を ?
ToIntegerOrInfinity (radix) とする。 - radixMV が 2～36 の範囲外なら
RangeError を投げる。 BigInt::toString (x, radixMV) を返す。
このメソッドは汎用的ではなく、
21.2.3.4 BigInt.prototype.valueOf ( )
- ? ThisBigIntValue(
this value) を返す。
21.2.3.4.1 ThisBigIntValue ( value: ECMAScript言語値, ): BigIntを返すか例外を投げる
- value がBigIntなら value を返す。
- value がオブジェクトで [[BigIntData]] 内部スロットを持つ場合:
- value.[[BigIntData]] を返す。
TypeError を投げる。
21.2.3.5 BigInt.prototype [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
21.2.4 BigIntインスタンスのプロパティ
BigIntインスタンスは通常のオブジェクトで、
21.3 Mathオブジェクト
Mathオブジェクトは以下の通りです：
- %Math%である。
グローバルオブジェクト の"Math" プロパティの初期値である。- 通常のオブジェクトである。
- [[Prototype]]内部スロットを持ち、その値は
%Object.prototype% である。 - 関数オブジェクトではない。
- [[Construct]]内部メソッドを持たず、
new演算子でコンストラクターとして使用できない。 - [[Call]]内部メソッドを持たず、関数として呼び出すことができない。
この仕様書において、“x のNumber値”という表現は
21.3.1 Mathオブジェクトの値プロパティ
21.3.1.1 Math.E
自然対数の底である e のNumber値で、おおよそ 2.7182818284590452354。
このプロパティの属性は { [[Writable]]:
21.3.1.2 Math.LN10
10 の自然対数のNumber値で、おおよそ 2.302585092994046。
このプロパティの属性は { [[Writable]]:
21.3.1.3 Math.LN2
2 の自然対数のNumber値で、おおよそ 0.6931471805599453。
このプロパティの属性は { [[Writable]]:
21.3.1.4 Math.LOG10E
自然対数の底 e の常用対数値のNumber値で、おおよそ 0.4342944819032518。
このプロパティの属性は { [[Writable]]:
Math.LOG10E の値は Math.LN10 の値のおおよその逆数です。
21.3.1.5 Math.LOG2E
自然対数の底 e の二進対数値のNumber値で、おおよそ 1.4426950408889634。
このプロパティの属性は { [[Writable]]:
Math.LOG2E の値は Math.LN2 の値のおおよその逆数です。
21.3.1.6 Math.PI
円周と直径の比率 π のNumber値で、おおよそ 3.1415926535897932。
このプロパティの属性は { [[Writable]]:
21.3.1.7 Math.SQRT1_2
½ の平方根のNumber値で、おおよそ 0.7071067811865476。
このプロパティの属性は { [[Writable]]:
Math.SQRT1_2 の値は Math.SQRT2 の値のおおよその逆数です。
21.3.1.8 Math.SQRT2
2 の平方根のNumber値で、おおよそ 1.4142135623730951。
このプロパティの属性は { [[Writable]]:
21.3.1.9 Math [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
21.3.2 Mathオブジェクトの関数プロパティ
acos, acosh, asin, asinh, atan, atanh, atan2, cbrt, cos, cosh, exp, expm1, hypot, log, log1p, log2, log10, pow, random, sin, sinh, tan, tanh の関数の動作はここで正確には指定されていません。特定の引数値に対しては境界ケースとして特定の結果が要求されます。他の引数値に対しては、これらの関数はよく知られた数学関数の結果の近似値を計算することを意図しており、近似アルゴリズムの選択には一定の裁量が認められています。一般的な意図として、実装者はそのハードウェアプラットフォーム上でCプログラマーが利用可能な数学ライブラリをECMAScriptで使用できるべきです。
アルゴリズムの選択は実装に委ねられますが、実装ではSun Microsystems の自由に配布可能な数学ライブラリ fdlibm（http://www.netlib.org/fdlibm）に含まれる
21.3.2.1 Math.abs ( x )
この関数は x の絶対値を返します。結果は x と同じ大きさですが、符号は正です。
呼び出されたとき、次の手順を実行します：
- n を ?
ToNumber (x) とする。 - n が
NaN の場合、NaN を返す。 - n が
-0 𝔽 の場合、+0 𝔽 を返す。 - n が
-∞ 𝔽 の場合、+∞ 𝔽 を返す。 - n <
-0 𝔽 の場合、-n を返す。 - n を返す。
21.3.2.2 Math.acos ( x )
この関数は x の逆余弦を返します。結果はラジアンで表され、
呼び出されたとき、次の手順を実行します：
21.3.2.3 Math.acosh ( x )
この関数は x の逆双曲線余弦を返します。
呼び出されたとき、次の手順を実行します：
21.3.2.4 Math.asin ( x )
この関数は x の逆正弦を返します。結果はラジアンで表され、
呼び出されたとき、次の手順を実行します：
21.3.2.5 Math.cbrt ( x )
この関数は x の立方根を返します。
呼び出されたとき、次の手順を実行します：
21.3.2.6 Math.ceil ( x )
この関数は x 以上で -∞ に最も近い整数Number値を返します。x が既に整数Numberの場合、結果は x です。
呼び出されたとき、次の手順を実行します：
- n を ?
ToNumber (x) とする。 - n が有限でないか、または
+0 𝔽 または-0 𝔽 の場合、n を返す。 - n <
-0 𝔽 かつ n >-1 𝔽 の場合、-0 𝔽 を返す。 - n が整数Numberの場合、n を返す。
- n 以上で -∞ に最も近い整数Number値を返す。
Math.ceil(x) の値は -Math.floor(-x) の値と同じです。
21.3.2.7 Math.clz32 ( x )
呼び出されたとき、次の手順を実行します：
n が
21.3.2.8 Math.cos ( x )
この関数は x の余弦を返します。引数はラジアンで表されます。
呼び出されたとき、次の手順を実行します：
21.3.2.9 Math.cosh ( x )
この関数は x の双曲線余弦を返します。
呼び出されたとき、次の手順を実行します：
Math.cosh(x) の値は (Math.exp(x) + Math.exp(-x)) / 2 の値と同じです。
21.3.2.10 Math.exp ( x )
この関数は x の指数関数 (e の x 乗、ここで e は自然対数の底) を返します。
呼び出されたとき、次の手順を実行します：
21.3.2.11 Math.expm1 ( x )
この関数は x の指数関数 (e の x 乗) から1を引いた結果を返します。x の値が0に近い場合でも正確に計算されます。
呼び出されたとき、次の手順を実行します：
21.3.2.12 Math.log10 ( x )
この関数は x の常用対数を返します。
呼び出されたとき、次の手順を実行します：
21.3.2.13 Math.log2 ( x )
この関数は x の二進対数を返します。
呼び出されたとき、次の手順を実行します：
21.3.2.14 Math.max ( ...args )
0個以上の引数が与えられた場合、それぞれの引数に対して
呼び出されたとき、次の手順を実行します：
- coerced を新しい空リストとする。
- args の各要素 arg について、次を行う：
- n を ?
ToNumber (arg) とする。 - n を coerced に追加する。
- n を ?
- highest を
-∞ 𝔽 とする。 - coerced の各要素 number について、次を行う：
- number が
NaN の場合、NaN を返す。 - number が
+0 𝔽 かつ highest が-0 𝔽 の場合、highest を+0 𝔽 に設定する。 - number > highest の場合、highest を number に設定する。
- number が
- highest を返す。
最大値を決定する比較は
この関数の
21.3.2.15 Math.min ( ...args )
0個以上の引数が与えられた場合、それぞれの引数に対して
呼び出されたとき、次の手順を実行します：
- coerced を新しい空リストとする。
- args の各要素 arg について、次を行う：
- n を ?
ToNumber (arg) とする。 - n を coerced に追加する。
- n を ?
- lowest を
+∞ 𝔽 とする。 - coerced の各要素 number について、次を行う：
- number が
NaN の場合、NaN を返す。 - number が
-0 𝔽 かつ lowest が+0 𝔽 の場合、lowest を-0 𝔽 に設定する。 - number < lowest の場合、lowest を number に設定する。
- number が
- lowest を返す。
最小値を決定する比較は
この関数の
21.3.2.16 Math.pow ( base, exponent )
呼び出されたとき、次の手順を実行します：
- base を ?
ToNumber (base) とする。 - exponent を ?
ToNumber (exponent) とする。 Number::exponentiate (base, exponent) を返す。
21.3.2.17 Math.random ( )
この関数は正の符号を持つNumber値を返します。値は
異なる Math.random 関数は、連続呼び出しから得られる値の列が異なる必要があります。
21.3.2.18 Math.round ( x )
この関数は x に最も近い整数のNumber値を返します。二つの整数が同じ距離にある場合、+∞ に近い方を返します。x が既に整数の場合、結果は x です。
呼び出されたとき、次の手順を実行します：
- n を ?
ToNumber (x) とする。 - n が有限でない、または整数Numberの場合、n を返す。
- n <
0.5 𝔽 かつ n >+0 𝔽 の場合、+0 𝔽 を返す。 - n <
-0 𝔽 かつ n ≥-0.5 𝔽 の場合、-0 𝔽 を返す。 - n に最も近い整数Number値を返す。距離が同じ場合は +∞ に近い方を返す。
Math.round(3.5) は 4 を返し、Math.round(-3.5) は -3 を返します。
Math.round(x) の値は常に Math.floor(x + 0.5) と同じではありません。x が Math.round(x) は Math.floor(x + 0.5) は x + 0.5 を計算する際の丸めにより、Math.round(x) が Math.floor(x + 0.5) と異なる場合もあります。
21.3.2.19 Math.sign ( x )
この関数は x の符号を返します。正、負、またはゼロを示します。
呼び出されたとき、次の手順を実行します：
- n を ?
ToNumber (x) とする。 - n が
NaN 、+0 𝔽、または-0 𝔽 の場合、n を返す。 - n <
-0 𝔽 の場合、-1 𝔽 を返す。 1 𝔽 を返す。
21.3.2.20 Math.sin ( x )
この関数は x の正弦を返します。引数はラジアンで表されます。
呼び出されたとき、次の手順を実行します：
21.3.2.21 Math.sinh ( x )
この関数は x の双曲線正弦を返します。
呼び出されたとき、次の手順を実行します：
Math.sinh(x) の値は (Math.exp(x) - Math.exp(-x)) / 2 の値と同じです。
21.3.2.22 Math.sqrt ( x )
この関数は x の平方根を返します。
呼び出されたとき、次の手順を実行します：
21.3.2.23 Math.sumPrecise ( items )
Numberのイテラブルが与えられた場合、この関数は各値を合計し、その合計を返します。もし任意の値がNumberでない場合は
呼び出されたとき、次の手順を実行します：
- ?
RequireObjectCoercible (items) を実行する。 - iteratorRecord を ?
GetIterator (items,sync ) とする。 - state を
minus-zero とする。 - sum を 0 とする。
- count を 0 とする。
- next を
not-started とする。 - next が
done でない間繰り返す：- next を ?
IteratorStepValue (iteratorRecord) とする。 - next が
done でない場合、次を行う：- count ≥ 253 - 1 の場合、次を行う：
NOTE : このステップは実際には到達しないことが期待され、実装が入力を「合理的なサイズ」と見なすために含まれる。- error を
ThrowCompletion (新しいRangeError オブジェクト) とする。 - ?
IteratorClose (iteratorRecord, error) を返す。
- next が Number でない場合、次を行う：
- error を
ThrowCompletion (新しいTypeError オブジェクト) とする。 - ?
IteratorClose (iteratorRecord, error) を返す。
- error を
- n を next とする。
- state が
not-a-number でない場合、次を行う：- n が
NaN の場合、state をnot-a-number に設定する。 - n が
+∞ 𝔽 の場合：- state が
minus-infinity の場合、state をnot-a-number に設定する。 - それ以外の場合、state を
plus-infinity に設定する。
- state が
- n が
-∞ 𝔽 の場合：- state が
plus-infinity の場合、state をnot-a-number に設定する。 - それ以外の場合、state を
minus-infinity に設定する。
- state が
- n が
-0 𝔽 でなく、state がminus-zero またはfinite の場合：- state を
finite に設定する。 - sum を sum +
ℝ (n) に設定する。
- state を
- n が
- count を count + 1 とする。
- count ≥ 253 - 1 の場合、次を行う：
- next を ?
- state が
not-a-number の場合、NaN を返す。 - state が
plus-infinity の場合、+∞ 𝔽 を返す。 - state が
minus-infinity の場合、−∞ 𝔽 を返す。 - state が
minus-zero の場合、−0 𝔽 を返す。 𝔽 (sum) を返す。
sum の値は任意精度算術を使わずにさまざまなアルゴリズムで計算可能です。その一つは Jonathan Richard Shewchuk による「Grow-Expansion」アルゴリズムです。最近のアルゴリズムとしては "Fast exact summation using small and large superaccumulators" があり、コードは https://gitlab.com/radfordneal/xsum で利用可能です。
21.3.2.24 Math.tan ( x )
この関数は x の正接を返します。引数はラジアンで表されます。
呼び出されたとき、次の手順を実行します：
21.3.2.25 Math.tanh ( x )
この関数は x の双曲線正接を返します。
呼び出されたとき、次の手順を実行します：
Math.tanh(x) の値は (Math.exp(x) - Math.exp(-x)) / (Math.exp(x) + Math.exp(-x)) の値と同じです。
21.3.2.26 Math.trunc ( x )
この関数は x の整数部分を返します。小数部分は切り捨てられます。x が既に整数の場合、結果は x です。
呼び出されたとき、次の手順を実行します：
- n を ?
ToNumber (x) とする。 - n が有限でないか、または
+0 𝔽 または-0 𝔽 の場合、n を返す。 - n <
1 𝔽 かつ n >+0 𝔽 の場合、+0 𝔽 を返す。 - n <
-0 𝔽 かつ n >-1 𝔽 の場合、-0 𝔽 を返す。 - n に最も近い整数Number値を返す（+0方向）。
21.4 Dateオブジェクト
21.4.1 Dateオブジェクトの概要および抽象操作の定義
以下の抽象操作は
21.4.1.1 時刻値と時刻範囲
ECMAScriptにおける時刻の測定はPOSIXにおける時刻の測定に類似しており、特に、先発グレゴリオ暦、1970年1月1日UTCの始まりの午前0時を エポック とすること、およびすべての日を正確に86,400秒（それぞれが1000ミリ秒の長さ）から成るものとして数えることによって定義される点を共有します。
ECMAScriptの 時刻値 はNumberであり、ミリ秒精度で時点を表す有限の整数Number、または特定の時点を表さない
時刻値はUTCのうるう秒を考慮しません。正のうるう秒内の時点を表す時刻値は存在せず、負のうるう秒によってUTCの時間線から取り除かれた時点を表す時刻値は存在します。しかし、時刻値の定義は、それでもUTCとの区分的な整合をもたらし、不連続はうるう秒境界でのみ発生し、うるう秒以外では差はゼロです。
Numberは -9,007,199,254,740,992 から 9,007,199,254,740,992 までのすべての整数を正確に表すことができます（
1970年1月1日UTCの始まりの午前0時ちょうどは、時刻値
先発グレゴリオ暦では、うるう年は、4で割り切れ、かつ400で割り切れるか100で割り切れない年に厳密に該当します。
先発グレゴリオ暦の400年周期には97個のうるう年が含まれます。これにより、1年あたり平均365.2425日、すなわち31,556,952,000ミリ秒になります。したがって、Numberがミリ秒精度で正確に表すことのできる最大範囲は、1970年を基準としておおよそ -285,426 年から 285,426 年です。この節で指定される時刻値によってサポートされるより小さい範囲は、1970年を基準としておおよそ -273,790 年から 273,790 年です。
21.4.1.2 時刻関連の定数
これらの定数は、以下の節のアルゴリズムから参照されます。
21.4.1.3 Day ( t )
The
21.4.1.4 TimeWithinDay ( t )
The
21.4.1.5 DaysInYear ( y )
The
21.4.1.6 DayFromYear ( y )
The
- ry を
ℝ (y) とする。 NOTE : 以下のステップでは、numYears1、numYears4、numYears100、および numYears400 は、それぞれエポック から年 y の開始までの間に発生する、1、4、100、および400で割り切れる年数を表す。その数は、y がエポック より前の場合には負になる。- numYears1 を (ry - 1970) とする。
- numYears4 を
floor ((ry - 1969) / 4) とする。 - numYears100 を
floor ((ry - 1901) / 100) とする。 - numYears400 を
floor ((ry - 1601) / 400) とする。 𝔽 (365 × numYears1 + numYears4 - numYears100 + numYears400) を返す。
21.4.1.7 TimeFromYear ( y )
The
msPerDay ×DayFromYear (y) を返す。
21.4.1.8 YearFromTime ( t )
The
TimeFromYear (y) ≤ t となる最大の整数Number y（+∞ に最も近いもの）を返す。
21.4.1.9 DayWithinYear ( t )
The
Day (t) -DayFromYear (YearFromTime (t)) を返す。
21.4.1.10 InLeapYear ( t )
The
DaysInYear (YearFromTime (t)) が366 𝔽 の場合、1 𝔽 を返す。+0 𝔽 を返す。
21.4.1.11 MonthFromTime ( t )
The
- inLeapYear を
InLeapYear (t) とする。 - dayWithinYear を
DayWithinYear (t) とする。 - dayWithinYear <
31 𝔽 の場合、+0 𝔽 を返す。 - dayWithinYear <
59 𝔽 + inLeapYear の場合、1 𝔽 を返す。 - dayWithinYear <
90 𝔽 + inLeapYear の場合、2 𝔽 を返す。 - dayWithinYear <
120 𝔽 + inLeapYear の場合、3 𝔽 を返す。 - dayWithinYear <
151 𝔽 + inLeapYear の場合、4 𝔽 を返す。 - dayWithinYear <
181 𝔽 + inLeapYear の場合、5 𝔽 を返す。 - dayWithinYear <
212 𝔽 + inLeapYear の場合、6 𝔽 を返す。 - dayWithinYear <
243 𝔽 + inLeapYear の場合、7 𝔽 を返す。 - dayWithinYear <
273 𝔽 + inLeapYear の場合、8 𝔽 を返す。 - dayWithinYear <
304 𝔽 + inLeapYear の場合、9 𝔽 を返す。 - dayWithinYear <
334 𝔽 + inLeapYear の場合、10 𝔽 を返す。 Assert : dayWithinYear <365 𝔽 + inLeapYear。11 𝔽 を返す。
21.4.1.12 DateFromTime ( t )
The
- inLeapYear を
InLeapYear (t) とする。 - dayWithinYear を
DayWithinYear (t) とする。 - month を
MonthFromTime (t) とする。 - month が
+0 𝔽 の場合、dayWithinYear +1 𝔽 を返す。 - month が
1 𝔽 の場合、dayWithinYear -30 𝔽 を返す。 - month が
2 𝔽 の場合、dayWithinYear -58 𝔽 - inLeapYear を返す。 - month が
3 𝔽 の場合、dayWithinYear -89 𝔽 - inLeapYear を返す。 - month が
4 𝔽 の場合、dayWithinYear -119 𝔽 - inLeapYear を返す。 - month が
5 𝔽 の場合、dayWithinYear -150 𝔽 - inLeapYear を返す。 - month が
6 𝔽 の場合、dayWithinYear -180 𝔽 - inLeapYear を返す。 - month が
7 𝔽 の場合、dayWithinYear -211 𝔽 - inLeapYear を返す。 - month が
8 𝔽 の場合、dayWithinYear -242 𝔽 - inLeapYear を返す。 - month が
9 𝔽 の場合、dayWithinYear -272 𝔽 - inLeapYear を返す。 - month が
10 𝔽 の場合、dayWithinYear -303 𝔽 - inLeapYear を返す。 Assert : month は11 𝔽 である。- dayWithinYear -
333 𝔽 - inLeapYear を返す。
21.4.1.13 WeekDay ( t )
The
21.4.1.14 HourFromTime ( t )
The
21.4.1.15 MinFromTime ( t )
The
𝔽 (floor (ℝ (t /msPerMinute ))modulo MinutesPerHour ) を返す。
21.4.1.16 SecFromTime ( t )
The
𝔽 (floor (ℝ (t /msPerSecond ))modulo SecondsPerMinute ) を返す。
21.4.1.17 msFromTime ( t )
The
𝔽 (ℝ (t)modulo ℝ (msPerSecond )) を返す。
21.4.1.18 GetUTCEpochNanoseconds ( year, month, day, hour, minute, second, millisecond, microsecond, nanosecond )
The
21.4.1.19 時間帯識別子
ECMAScriptにおける時間帯は 時間帯識別子 によって表されます。これは、0x0000から0x007Fまでの包含区間内のコード単位のみで構成されるStringです。
ECMAScript実装がサポートする時間帯は、
一次時間帯識別子 は、利用可能な名前付き時間帯の推奨識別子です。 非一次時間帯識別子 は、一次時間帯識別子ではない、利用可能な名前付き時間帯の識別子です。 利用可能な名前付き時間帯識別子 は、一次時間帯識別子または非一次時間帯識別子のいずれかです。 各利用可能な名前付き時間帯識別子は、ちょうど1つの利用可能な名前付き時間帯に関連付けられます。 各利用可能な名前付き時間帯は、ちょうど1つの一次時間帯識別子と、0個以上の非一次時間帯識別子に関連付けられます。
ECMAScript実装は、識別子
ECMA-402 Internationalization API仕様に記述される時間帯の要件に従う実装は、time zone aware と呼ばれます。
時間帯対応実装は、IANA Time Zone DatabaseのZone名および
21.4.1.20 GetNamedTimeZoneEpochNanoseconds ( timeZoneIdentifier, year, month, day, hour, minute, second, millisecond, microsecond, nanosecond )
The
入力が負の時間帯遷移（たとえば夏時間の終了時、または時間帯規則の変更により時間帯オフセットが減少した場合）によって複数回発生するローカル時刻を表す場合、返される
いかなる時間帯についてもローカルな政治的規則を含まないECMAScript実装で使用される、GetNamedTimeZoneEpochNanosecondsの既定の実装は、呼び出されたとき次の手順を実行します：
Assert : timeZoneIdentifier は"UTC" である。- epochNanoseconds を
GetUTCEpochNanoseconds (year, month, day, hour, minute, second, millisecond, microsecond, nanosecond) とする。 - « epochNanoseconds » を返す。
時間帯対応実装には（また他のすべての実装にも推奨として）、IANA Time Zone Database https://www.iana.org/time-zones/ の時間帯情報を使用することが要求されます。
America/New_Yorkにおける2017年11月5日午前1時30分は2回繰り返されるため、GetNamedTimeZoneEpochNanoseconds(
America/New_Yorkにおける2017年3月12日午前2時30分は存在しないため、GetNamedTimeZoneEpochNanoseconds(
21.4.1.21 GetNamedTimeZoneOffsetNanoseconds ( timeZoneIdentifier, epochNanoseconds )
The
返される整数は、timeZoneIdentifier によって識別される名前付き時間帯のUTCからのオフセットを、epochNanoseconds に対応する
いかなる時間帯についてもローカルな政治的規則を含まないECMAScript実装で使用される、GetNamedTimeZoneOffsetNanosecondsの既定の実装は、呼び出されたとき次の手順を実行します：
Assert : timeZoneIdentifier は"UTC" である。- 0 を返す。
時間帯オフセット値は正または負の場合があります。
21.4.1.22 Time Zone Identifier Record
Time Zone Identifier Record は、
Time Zone Identifier Recordは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Identifier]] | String | 実装によってサポートされる |
| [[PrimaryIdentifier]] | String | [[Identifier]] が解決される |
[[Identifier]] が
21.4.1.23 AvailableNamedTimeZoneIdentifiers ( )
The
ECMA-402 Internationalization APIを実装するすべての実装を含む時間帯対応実装は、ECMA-402仕様で指定されるとおりにAvailableNamedTimeZoneIdentifiers抽象操作を実装しなければなりません。 時間帯対応でない実装では、AvailableNamedTimeZoneIdentifiersは呼び出されたとき次の手順を実行します：
- 実装がいかなる時間帯についてもローカルな政治的規則を含まない場合、次を行う：
- «
Time Zone Identifier Record { [[Identifier]]:"UTC" , [[PrimaryIdentifier]]:"UTC" } » を返す。
- «
- identifiers を、字句的コード単位順にソートされた、一意な
利用可能な名前付き時間帯識別子 のList とする。 - result を新しい空の
List とする。 - identifiers の各要素 identifier について、次を行う：
- primary を identifier とする。
- identifier がこの実装における
非一次時間帯識別子 であり、かつ identifier が"UTC" でない場合、次を行う： - record を
Time Zone Identifier Record { [[Identifier]]: identifier, [[PrimaryIdentifier]]: primary } とする。 - record を result に追加する。
Assert : result は、r.[[Identifier]] が"UTC" であり r.[[PrimaryIdentifier]] が"UTC" であるTime Zone Identifier Record r を含む。- result を返す。
21.4.1.24 SystemTimeZoneIdentifier ( )
The
実装がDateオブジェクトのメソッドで一般的に提供する機能水準を確保するため、SystemTimeZoneIdentifierは、そのようなものが存在する場合、ホスト環境の時間帯設定に対応するIANA時間帯名を返すことが推奨されます。
たとえば、ホスト環境が、ユーザーが時間帯として米国東部時間を選択したシステム上のブラウザーである場合、SystemTimeZoneIdentifierは
21.4.1.25 LocalTime ( t )
The
- systemTimeZoneIdentifier を
SystemTimeZoneIdentifier () とする。 IsTimeZoneOffsetString (systemTimeZoneIdentifier) がtrue の場合、次を行う：- offsetNs を
ParseTimeZoneOffsetString (systemTimeZoneIdentifier) とする。
- offsetNs を
- それ以外の場合、
- offsetNs を
GetNamedTimeZoneOffsetNanoseconds (systemTimeZoneIdentifier,ℤ (ℝ (t) × 106)) とする。
- offsetNs を
- offsetMs を
truncate (offsetNs / 106) とする。 - t +
𝔽 (offsetMs) を返す。
ローカル時刻 t に関する政治的規則が実装内で利用可能でない場合、
時間帯対応実装には（また他のすべての実装にも推奨として）、IANA Time Zone Database https://www.iana.org/time-zones/ の時間帯情報を使用することが要求されます。
21.4.1.26 UTC ( t )
The
- t が有限でない場合、
NaN を返す。 - systemTimeZoneIdentifier を
SystemTimeZoneIdentifier () とする。 IsTimeZoneOffsetString (systemTimeZoneIdentifier) がtrue の場合、次を行う：- offsetNs を
ParseTimeZoneOffsetString (systemTimeZoneIdentifier) とする。
- offsetNs を
- それ以外の場合、
- possibleInstants を
GetNamedTimeZoneEpochNanoseconds (systemTimeZoneIdentifier,ℝ (YearFromTime (t)),ℝ (MonthFromTime (t)) + 1,ℝ (DateFromTime (t)),ℝ (HourFromTime (t)),ℝ (MinFromTime (t)),ℝ (SecFromTime (t)),ℝ (msFromTime (t)), 0, 0) とする。 NOTE : 以下のステップは、t が負の時間帯遷移（たとえば夏時間の終了時、または時間帯規則の変更により時間帯オフセットが減少した場合）で複数回繰り返されるローカル時刻、または正の時間帯遷移（たとえば夏時間の開始時、または時間帯規則の変更により時間帯オフセットが増加した場合）でスキップされたローカル時刻を表す場合に、t が遷移前の時間帯オフセットを使用して解釈されることを保証する。- possibleInstants が空でない場合、次を行う：
- disambiguatedInstant を possibleInstants[0] とする。
- それ以外の場合、
NOTE : t は正の時間帯遷移（たとえば夏時間の開始または時間帯規則の変更によりUTCオフセットが増加すること）でスキップされたローカル時刻を表す。- possibleInstantsBefore を
GetNamedTimeZoneEpochNanoseconds (systemTimeZoneIdentifier,ℝ (YearFromTime (tBefore)),ℝ (MonthFromTime (tBefore)) + 1,ℝ (DateFromTime (tBefore)),ℝ (HourFromTime (tBefore)),ℝ (MinFromTime (tBefore)),ℝ (SecFromTime (tBefore)),ℝ (msFromTime (tBefore)), 0, 0) とする。ここで tBefore は、possibleInstantsBefore が空でないような t 未満の最大の整数Number（すなわち、tBefore は遷移前の最後のローカル時刻を表す）である。 - disambiguatedInstant を possibleInstantsBefore の最後の要素とする。
- offsetNs を
GetNamedTimeZoneOffsetNanoseconds (systemTimeZoneIdentifier, disambiguatedInstant) とする。
- possibleInstants を
- offsetMs を
truncate (offsetNs / 106) とする。 - t -
𝔽 (offsetMs) を返す。
入力 t は名目上は
ローカル時刻 t に関する政治的規則が実装内で利用可能でない場合、
時間帯対応実装には（また他のすべての実装にも推奨として）、IANA Time Zone Database https://www.iana.org/time-zones/ の時間帯情報を使用することが要求されます。
America/New_Yorkにおける2017年11月5日午前1時30分は2回繰り返されます（秋の後退）が、UTC-05の午前1時30分ではなく、UTC-04の午前1時30分として解釈されなければなりません。
UTC(
America/New_Yorkにおける2017年3月12日午前2時30分は存在しませんが、UTC-05の午前2時30分（UTC-04の午前3時30分に相当）として解釈されなければなりません。
UTC(
21.4.1.27 MakeTime ( hour, min, sec, ms )
The
- hour が有限でない、min が有限でない、sec が有限でない、または ms が有限でない場合、
NaN を返す。 - h を
𝔽 (!ToIntegerOrInfinity (hour)) とする。 - m を
𝔽 (!ToIntegerOrInfinity (min)) とする。 - s を
𝔽 (!ToIntegerOrInfinity (sec)) とする。 - milli を
𝔽 (!ToIntegerOrInfinity (ms)) とする。 - ((h ×
msPerHour + m ×msPerMinute ) + s ×msPerSecond ) + milli を返す。
MakeTimeにおける算術は浮動小数点算術であり、結合的ではないため、演算は正しい順序で実行されなければなりません。
21.4.1.28 MakeDay ( year, month, date )
The
- year が有限でない、month が有限でない、または date が有限でない場合、
NaN を返す。 - y を
𝔽 (!ToIntegerOrInfinity (year)) とする。 - m を
𝔽 (!ToIntegerOrInfinity (month)) とする。 - dt を
𝔽 (!ToIntegerOrInfinity (date)) とする。 - ym を y +
𝔽 (floor (ℝ (m) / 12)) とする。 - ym が有限でない場合、
NaN を返す。 - mn を
𝔽 (ℝ (m)modulo 12) とする。 YearFromTime (t) が ym、MonthFromTime (t) が mn、DateFromTime (t) が1 𝔽 であるような有限時刻値 t を見つける。ただし、これが不可能である場合（何らかの引数が範囲外であるため）、NaN を返す。Day (t) + dt -1 𝔽 を返す。
21.4.1.29 MakeDate ( day, time )
The
- day が有限でない、または time が有限でない場合、
NaN を返す。 - tv を day ×
msPerDay + time とする。 - tv が有限でない場合、
NaN を返す。 - tv を返す。
21.4.1.30 MakeFullYear ( year )
The
- year が
NaN 、+∞ 𝔽、または-∞ 𝔽 のいずれかである場合、NaN を返す。 - truncated を !
ToIntegerOrInfinity (year) とする。 - truncated が0から99までの包含区間内にある場合、
1900 𝔽 +𝔽 (truncated) を返す。 𝔽 (truncated) を返す。
21.4.1.31 TimeClip ( time )
The
- time が有限でない場合、
NaN を返す。 abs (ℝ (time)) > 8.64 × 1015 の場合、NaN を返す。𝔽 (!ToIntegerOrInfinity (time)) を返す。
21.4.1.32 日時文字列形式
ECMAScriptは、ISO 8601暦日拡張形式を単純化したものに基づく、日時の文字列交換形式を定義します。その形式は次のとおりです：YYYY-MM-DDTHH:mm:ss.sssZ
各要素は次のとおりです：
YYYY
|
先発グレゴリオ暦における年であり、0000から9999までの4桁の10進数字、または |
-
|
|
MM
|
年の月であり、01（1月）から12（12月）までの2桁の10進数字として表されます。 |
DD
|
月の日であり、01から31までの2桁の10進数字として表されます。 |
T
|
|
HH
|
午前0時から経過した完全な時の数であり、00から24までの2桁の10進数字として表されます。 |
:
|
|
mm
|
その時の開始からの完全な分の数であり、00から59までの2桁の10進数字として表されます。 |
ss
|
その分の開始からの完全な秒の数であり、00から59までの2桁の10進数字として表されます。 |
.
|
|
sss
|
その秒の開始からの完全なミリ秒の数であり、3桁の10進数字として表されます。 |
Z
|
UTCオフセット表現であり、HH:mm が続くもの（それぞれUTCより進んだ、または遅れたローカル時刻を示すための |
この形式には、日付のみの形式が含まれます：
YYYY
YYYY-MM
YYYY-MM-DD
また、上記の日付のみの形式のいずれかに、以下の時刻形式のいずれかを直後に続け、任意でUTCオフセット表現を付加した「日時」形式も含まれます：
THH:mm
THH:mm:ss
THH:mm:ss.sss
範囲外または不適合な要素を含む文字列は、この形式の有効なインスタンスではありません。
すべての日は午前0時で始まり午前0時で終わるため、00:00 と 24:00 の2つの表記は、1つの日付に関連付けられる2つの午前0時を区別するために利用できます。これは、次の2つの表記がまったく同じ時点を指すことを意味します：1995-02-04T24:00 と 1995-02-05T00:00。後者の形式を「暦日の終わり」と解釈することはISO 8601と整合しますが、同仕様はこれを時間間隔の記述用に予約しており、単一時点の表現内では許可していません。
CET、ESTなどの民用時間帯の略称を規定する国際標準は存在せず、同じ略称が非常に異なる2つの時間帯に使用されることさえあります。このため、ISO 8601およびこの形式はいずれも、時間帯オフセットの数値表現を指定しています。
21.4.1.32.1 拡張年
1970年1月1日から前後おおよそ273,790年にわたる完全なDate.parse
拡張年を持つdate-
| -271821-04-20T00:00:00Z | 紀元前271822年 |
| -000001-01-01T00:00:00Z | 紀元前2年 |
| +000000-01-01T00:00:00Z | 紀元前1年 |
| +000001-01-01T00:00:00Z | 紀元1年 |
| +001970-01-01T00:00:00Z | 西暦1970年 |
| +002009-12-15T00:00:00Z | 西暦2009年 |
| +275760-09-13T00:00:00Z | 西暦275760年 |
21.4.1.33 時間帯オフセット文字列形式
ECMAScriptは、ISO 8601に由来するUTCオフセットの文字列交換形式を定義します。 その形式は次の文法で記述されます。
構文
21.4.1.33.1 IsTimeZoneOffsetString ( offsetString )
The
21.4.1.33.2 ParseTimeZoneOffsetString ( offsetString )
The
- parseResult を
ParseText (offsetString,UTCOffset ) とする。 Assert : parseResult はエラーのList ではない。Assert : parseResult はASCIISign Parse Node を含む。- parsedSign を、parseResult 内に含まれる
ASCIISign Parse Node に一致したソーステキストとする。 - parsedSign が単一のコードポイント U+002D (HYPHEN-MINUS) である場合、次を行う：
- sign を -1 とする。
- それ以外の場合、
- sign を 1 とする。
NOTE : 以下のStringToNumber の適用は精度を失わない。解析された各値は十分に短い10進数字列であることが保証されているためである。Assert : parseResult はHour Parse Node を含む。- parsedHours を、parseResult 内に含まれる
Hour Parse Node に一致したソーステキストとする。 - hours を
ℝ (StringToNumber (CodePointsToString (parsedHours))) とする。 - parseResult が
MinuteSecond Parse Node を含まない場合、次を行う：- minutes を 0 とする。
- それ以外の場合、
- parsedMinutes を、parseResult 内に含まれる最初の
MinuteSecond Parse Node に一致したソーステキストとする。 - minutes を
ℝ (StringToNumber (CodePointsToString (parsedMinutes))) とする。
- parsedMinutes を、parseResult 内に含まれる最初の
- parseResult が2つの
MinuteSecond Parse Node を含まない場合、次を行う：- seconds を 0 とする。
- それ以外の場合、
- parsedSeconds を、parseResult 内に含まれる2番目の
MinuteSecond Parse Node に一致したソーステキストとする。 - seconds を
ℝ (StringToNumber (CodePointsToString (parsedSeconds))) とする。
- parsedSeconds を、parseResult 内に含まれる2番目の
- parseResult が
TemporalDecimalFraction Parse Node を含まない場合、次を行う：- nanoseconds を 0 とする。
- それ以外の場合、
- parsedFraction を、parseResult 内に含まれる
TemporalDecimalFraction Parse Node に一致したソーステキストとする。 - fraction を
CodePointsToString (parsedFraction) と"000000000" の文字列連結とする。 - nanosecondsString を fraction の1から10までの部分文字列とする。
- nanoseconds を
ℝ (StringToNumber (nanosecondsString)) とする。
- parsedFraction を、parseResult 内に含まれる
- sign × (((hours × 60 + minutes) × 60 + seconds) × 109 + nanoseconds) を返す。
21.4.2 Dateコンストラクター
Dateコンストラクターは以下の通りです：
- %Date%である。
グローバルオブジェクト の"Date" プロパティの初期値である。- コンストラクターとして呼び出されたとき、新しいDateを作成して初期化する。
- コンストラクターとしてではなく関数として呼び出されたとき、現在時刻（UTC）を表すStringを返す。
- 引数の数および型に基づいて動作が異なる関数である。
- クラス定義の
extends節の値として使用できる。指定されたDateの動作を継承することを意図するサブクラスコンストラクターは、[[DateValue]]内部スロットを持つサブクラスインスタンスを作成して初期化するために、Dateコンストラクターへのsuper呼び出しを含めなければならない。
21.4.2.1 Date ( ...values )
この関数は呼び出されたとき、次の手順を実行します：
- NewTarget が
undefined の場合、次を行う：- now を現在時刻を識別する
時刻値 （UTC）とする。 ToDateString (now) を返す。
- now を現在時刻を識別する
- numberOfArgs を values 内の要素数とする。
- numberOfArgs = 0 の場合、次を行う：
- dv を現在時刻を識別する
時刻値 （UTC）とする。
- dv を現在時刻を識別する
- そうでなく numberOfArgs = 1 の場合、次を行う：
- value を values[0] とする。
- value がObjectであり、value が [[DateValue]] 内部スロットを持つ場合、次を行う：
- tv を value.[[DateValue]] とする。
- それ以外の場合、
- v を ?
ToPrimitive (value) とする。 - v がStringの場合、次を行う：
- それ以外の場合、
- 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 Dateコンストラクターのプロパティ
Dateコンストラクターは以下の通りです：
- [[Prototype]]内部スロットを持ち、その値は
%Function.prototype% である。 - 値が
7 𝔽 である"length" プロパティを持つ。 - 以下のプロパティを持つ：
21.4.3.1 Date.now ( )
この関数は、それが呼び出された時点のUTC日付および時刻を示す
21.4.3.2 Date.parse ( string )
この関数は引数に
Stringが MMまたはDD要素が欠けている場合は、HH、mm、またはss要素が欠けている場合は、sss要素が欠けている場合は、
xが、ECMAScriptの特定の実装においてミリ秒量がゼロである任意のDateである場合、参照されるすべてのプロパティが初期値を持つなら、その実装において以下のすべての式は同じ数値を生成するべきです：
x.valueOf()
Date.parse(x.toString())
Date.parse(x.toUTCString())
Date.parse(x.toISOString())しかし、次の式
Date.parse(x.toLocaleString())は、前の3つの式と同じNumber値を生成することは要求されません。また一般に、この関数が生成する値は、Date Time String Format（toStringまたはtoUTCStringメソッドによって生成され得ない任意のString値が与えられた場合、実装定義です。
21.4.3.3 Date.prototype
Date.prototypeの初期値は
このプロパティの属性は { [[Writable]]:
21.4.3.4 Date.UTC ( year [ , month [ , date [ , hours [ , minutes [ , seconds [ , ms ] ] ] ] ] ] )
この関数は呼び出されたとき、次の手順を実行します：
- y を ?
ToNumber (year) とする。 - month が存在する場合、m を ?
ToNumber (month) とする。そうでない場合、m を+0 𝔽 とする。 - date が存在する場合、dt を ?
ToNumber (date) とする。そうでない場合、dt を1 𝔽 とする。 - hours が存在する場合、h を ?
ToNumber (hours) とする。そうでない場合、h を+0 𝔽 とする。 - minutes が存在する場合、min を ?
ToNumber (minutes) とする。そうでない場合、min を+0 𝔽 とする。 - seconds が存在する場合、s を ?
ToNumber (seconds) とする。そうでない場合、s を+0 𝔽 とする。 - ms が存在する場合、milli を ?
ToNumber (ms) とする。そうでない場合、milli を+0 𝔽 とする。 - yr を
MakeFullYear (y) とする。 TimeClip (MakeDate (MakeDay (yr, m, dt),MakeTime (h, min, s, milli))) を返す。
この関数の
この関数はDateコンストラクターと2つの点で異なります。Dateを作成するのではなくNumberとして
21.4.4 Dateプロトタイプオブジェクトのプロパティ
Dateプロトタイプオブジェクトは以下の通りです：
- %Date.prototype%である。
- それ自体が通常のオブジェクトである。
- Dateインスタンスではなく、[[DateValue]]内部スロットを持たない。
- [[Prototype]]内部スロットを持ち、その値は
%Object.prototype% である。
明示的に別途定義されている場合を除き、以下で定義されるDateプロトタイプオブジェクトのメソッドは汎用ではなく、それらに渡される
21.4.4.1 Date.prototype.constructor
Date.prototype.constructorの初期値は
21.4.4.2 Date.prototype.getDate ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN の場合、NaN を返す。 DateFromTime (LocalTime (t)) を返す。
21.4.4.3 Date.prototype.getDay ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN の場合、NaN を返す。 WeekDay (LocalTime (t)) を返す。
21.4.4.4 Date.prototype.getFullYear ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN の場合、NaN を返す。 YearFromTime (LocalTime (t)) を返す。
21.4.4.5 Date.prototype.getHours ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN の場合、NaN を返す。 HourFromTime (LocalTime (t)) を返す。
21.4.4.6 Date.prototype.getMilliseconds ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN の場合、NaN を返す。 msFromTime (LocalTime (t)) を返す。
21.4.4.7 Date.prototype.getMinutes ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN の場合、NaN を返す。 MinFromTime (LocalTime (t)) を返す。
21.4.4.8 Date.prototype.getMonth ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN の場合、NaN を返す。 MonthFromTime (LocalTime (t)) を返す。
21.4.4.9 Date.prototype.getSeconds ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN の場合、NaN を返す。 SecFromTime (LocalTime (t)) を返す。
21.4.4.10 Date.prototype.getTime ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - dateObject.[[DateValue]] を返す。
21.4.4.11 Date.prototype.getTimezoneOffset ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN の場合、NaN を返す。 - (t -
LocalTime (t)) /msPerMinute を返す。
21.4.4.12 Date.prototype.getUTCDate ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN の場合、NaN を返す。 DateFromTime (t) を返す。
21.4.4.13 Date.prototype.getUTCDay ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN の場合、NaN を返す。 WeekDay (t) を返す。
21.4.4.14 Date.prototype.getUTCFullYear ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN の場合、NaN を返す。 YearFromTime (t) を返す。
21.4.4.15 Date.prototype.getUTCHours ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN の場合、NaN を返す。 HourFromTime (t) を返す。
21.4.4.16 Date.prototype.getUTCMilliseconds ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN の場合、NaN を返す。 msFromTime (t) を返す。
21.4.4.17 Date.prototype.getUTCMinutes ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN の場合、NaN を返す。 MinFromTime (t) を返す。
21.4.4.18 Date.prototype.getUTCMonth ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN の場合、NaN を返す。 MonthFromTime (t) を返す。
21.4.4.19 Date.prototype.getUTCSeconds ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN の場合、NaN を返す。 SecFromTime (t) を返す。
21.4.4.20 Date.prototype.setDate ( date )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- dt を ?
ToNumber (date) とする。 - t が
NaN の場合、NaN を返す。 - t を
LocalTime (t) に設定する。 - newDate を
MakeDate (MakeDay (YearFromTime (t),MonthFromTime (t), dt),TimeWithinDay (t)) とする。 - u を
TimeClip (UTC (newDate)) とする。 - dateObject.[[DateValue]] を u に設定する。
- u を返す。
21.4.4.21 Date.prototype.setFullYear ( year [ , month [ , date ] ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- y を ?
ToNumber (year) とする。 - t が
NaN の場合、t を+0 𝔽 に設定する。そうでない場合、t をLocalTime (t) に設定する。 - month が存在する場合、m を ?
ToNumber (month) とする。そうでない場合、m をMonthFromTime (t) とする。 - date が存在する場合、dt を ?
ToNumber (date) とする。そうでない場合、dt をDateFromTime (t) とする。 - newDate を
MakeDate (MakeDay (y, m, dt),TimeWithinDay (t)) とする。 - u を
TimeClip (UTC (newDate)) とする。 - dateObject.[[DateValue]] を u に設定する。
- u を返す。
このメソッドの
month が存在しない場合、このメソッドは month が値 getMonth() とともに存在したかのように動作します。date が存在しない場合、date が値 getDate() とともに存在したかのように動作します。
21.4.4.22 Date.prototype.setHours ( hour [ , min [ , sec [ , ms ] ] ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- h を ?
ToNumber (hour) とする。 - min が存在する場合、m を ?
ToNumber (min) とする。 - sec が存在する場合、s を ?
ToNumber (sec) とする。 - ms が存在する場合、milli を ?
ToNumber (ms) とする。 - t が
NaN の場合、NaN を返す。 - t を
LocalTime (t) に設定する。 - min が存在しない場合、m を
MinFromTime (t) とする。 - sec が存在しない場合、s を
SecFromTime (t) とする。 - ms が存在しない場合、milli を
msFromTime (t) とする。 - date を
MakeDate (Day (t),MakeTime (h, m, s, milli)) とする。 - u を
TimeClip (UTC (date)) とする。 - dateObject.[[DateValue]] を u に設定する。
- u を返す。
このメソッドの
min が存在しない場合、このメソッドは min が値 getMinutes() とともに存在したかのように動作します。sec が存在しない場合、sec が値 getSeconds() とともに存在したかのように動作します。ms が存在しない場合、ms が値 getMilliseconds() とともに存在したかのように動作します。
21.4.4.23 Date.prototype.setMilliseconds ( ms )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- ms を ?
ToNumber (ms) に設定する。 - t が
NaN の場合、NaN を返す。 - t を
LocalTime (t) に設定する。 - time を
MakeTime (HourFromTime (t),MinFromTime (t),SecFromTime (t), ms) とする。 - u を
TimeClip (UTC (MakeDate (Day (t), time))) とする。 - dateObject.[[DateValue]] を u に設定する。
- u を返す。
21.4.4.24 Date.prototype.setMinutes ( min [ , sec [ , ms ] ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- m を ?
ToNumber (min) とする。 - sec が存在する場合、s を ?
ToNumber (sec) とする。 - ms が存在する場合、milli を ?
ToNumber (ms) とする。 - t が
NaN の場合、NaN を返す。 - t を
LocalTime (t) に設定する。 - sec が存在しない場合、s を
SecFromTime (t) とする。 - ms が存在しない場合、milli を
msFromTime (t) とする。 - date を
MakeDate (Day (t),MakeTime (HourFromTime (t), m, s, milli)) とする。 - u を
TimeClip (UTC (date)) とする。 - dateObject.[[DateValue]] を u に設定する。
- u を返す。
このメソッドの
sec が存在しない場合、このメソッドは sec が値 getSeconds() とともに存在したかのように動作します。ms が存在しない場合、これは ms が値 getMilliseconds() とともに存在したかのように動作します。
21.4.4.25 Date.prototype.setMonth ( month [ , date ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- m を ?
ToNumber (month) とする。 - date が存在する場合、dt を ?
ToNumber (date) とする。 - t が
NaN の場合、NaN を返す。 - t を
LocalTime (t) に設定する。 - date が存在しない場合、dt を
DateFromTime (t) とする。 - newDate を
MakeDate (MakeDay (YearFromTime (t), m, dt),TimeWithinDay (t)) とする。 - u を
TimeClip (UTC (newDate)) とする。 - dateObject.[[DateValue]] を u に設定する。
- u を返す。
このメソッドの
date が存在しない場合、このメソッドは date が値 getDate() とともに存在したかのように動作します。
21.4.4.26 Date.prototype.setSeconds ( sec [ , ms ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- s を ?
ToNumber (sec) とする。 - ms が存在する場合、milli を ?
ToNumber (ms) とする。 - t が
NaN の場合、NaN を返す。 - t を
LocalTime (t) に設定する。 - ms が存在しない場合、milli を
msFromTime (t) とする。 - date を
MakeDate (Day (t),MakeTime (HourFromTime (t),MinFromTime (t), s, milli)) とする。 - u を
TimeClip (UTC (date)) とする。 - dateObject.[[DateValue]] を u に設定する。
- u を返す。
このメソッドの
ms が存在しない場合、このメソッドは ms が値 getMilliseconds() とともに存在したかのように動作します。
21.4.4.27 Date.prototype.setTime ( time )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を ?
ToNumber (time) とする。 - v を
TimeClip (t) とする。 - dateObject.[[DateValue]] を v に設定する。
- v を返す。
21.4.4.28 Date.prototype.setUTCDate ( date )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- dt を ?
ToNumber (date) とする。 - t が
NaN の場合、NaN を返す。 - newDate を
MakeDate (MakeDay (YearFromTime (t),MonthFromTime (t), dt),TimeWithinDay (t)) とする。 - v を
TimeClip (newDate) とする。 - dateObject.[[DateValue]] を v に設定する。
- v を返す。
21.4.4.29 Date.prototype.setUTCFullYear ( year [ , month [ , date ] ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN の場合、t を+0 𝔽 に設定する。 - y を ?
ToNumber (year) とする。 - month が存在する場合、m を ?
ToNumber (month) とする。そうでない場合、m をMonthFromTime (t) とする。 - date が存在する場合、dt を ?
ToNumber (date) とする。そうでない場合、dt をDateFromTime (t) とする。 - newDate を
MakeDate (MakeDay (y, m, dt),TimeWithinDay (t)) とする。 - v を
TimeClip (newDate) とする。 - dateObject.[[DateValue]] を v に設定する。
- v を返す。
このメソッドの
month が存在しない場合、このメソッドは month が値 getUTCMonth() とともに存在したかのように動作します。date が存在しない場合、date が値 getUTCDate() とともに存在したかのように動作します。
21.4.4.30 Date.prototype.setUTCHours ( hour [ , min [ , sec [ , ms ] ] ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- h を ?
ToNumber (hour) とする。 - min が存在する場合、m を ?
ToNumber (min) とする。 - sec が存在する場合、s を ?
ToNumber (sec) とする。 - ms が存在する場合、milli を ?
ToNumber (ms) とする。 - t が
NaN の場合、NaN を返す。 - min が存在しない場合、m を
MinFromTime (t) とする。 - sec が存在しない場合、s を
SecFromTime (t) とする。 - ms が存在しない場合、milli を
msFromTime (t) とする。 - date を
MakeDate (Day (t),MakeTime (h, m, s, milli)) とする。 - v を
TimeClip (date) とする。 - dateObject.[[DateValue]] を v に設定する。
- v を返す。
このメソッドの
min が存在しない場合、このメソッドは min が値 getUTCMinutes() とともに存在したかのように動作します。sec が存在しない場合、sec が値 getUTCSeconds() とともに存在したかのように動作します。ms が存在しない場合、ms が値 getUTCMilliseconds() とともに存在したかのように動作します。
21.4.4.31 Date.prototype.setUTCMilliseconds ( ms )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- ms を ?
ToNumber (ms) に設定する。 - t が
NaN の場合、NaN を返す。 - time を
MakeTime (HourFromTime (t),MinFromTime (t),SecFromTime (t), ms) とする。 - v を
TimeClip (MakeDate (Day (t), time)) とする。 - dateObject.[[DateValue]] を v に設定する。
- v を返す。
21.4.4.32 Date.prototype.setUTCMinutes ( min [ , sec [ , ms ] ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- m を ?
ToNumber (min) とする。 - sec が存在する場合、s を ?
ToNumber (sec) とする。 - ms が存在する場合、milli を ?
ToNumber (ms) とする。 - t が
NaN の場合、NaN を返す。 - sec が存在しない場合、s を
SecFromTime (t) とする。 - ms が存在しない場合、milli を
msFromTime (t) とする。 - date を
MakeDate (Day (t),MakeTime (HourFromTime (t), m, s, milli)) とする。 - v を
TimeClip (date) とする。 - dateObject.[[DateValue]] を v に設定する。
- v を返す。
このメソッドの
sec が存在しない場合、このメソッドは sec が値 getUTCSeconds() とともに存在したかのように動作します。ms が存在しない場合、ms がgetUTCMilliseconds()によって返される値とともに存在したかのように動作します。
21.4.4.33 Date.prototype.setUTCMonth ( month [ , date ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- m を ?
ToNumber (month) とする。 - date が存在する場合、dt を ?
ToNumber (date) とする。 - t が
NaN の場合、NaN を返す。 - date が存在しない場合、dt を
DateFromTime (t) とする。 - newDate を
MakeDate (MakeDay (YearFromTime (t), m, dt),TimeWithinDay (t)) とする。 - v を
TimeClip (newDate) とする。 - dateObject.[[DateValue]] を v に設定する。
- v を返す。
このメソッドの
date が存在しない場合、このメソッドは date が値 getUTCDate() とともに存在したかのように動作します。
21.4.4.34 Date.prototype.setUTCSeconds ( sec [ , ms ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- s を ?
ToNumber (sec) とする。 - ms が存在する場合、milli を ?
ToNumber (ms) とする。 - t が
NaN の場合、NaN を返す。 - ms が存在しない場合、milli を
msFromTime (t) とする。 - date を
MakeDate (Day (t),MakeTime (HourFromTime (t),MinFromTime (t), s, milli)) とする。 - v を
TimeClip (date) とする。 - dateObject.[[DateValue]] を v に設定する。
- v を返す。
このメソッドの
ms が存在しない場合、このメソッドは ms が値 getUTCMilliseconds() とともに存在したかのように動作します。
21.4.4.35 Date.prototype.toDateString ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - tv を dateObject.[[DateValue]] とする。
- tv が
NaN の場合、"Invalid Date" を返す。 - t を
LocalTime (tv) とする。 DateString (t) を返す。
21.4.4.36 Date.prototype.toISOString ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - tv を dateObject.[[DateValue]] とする。
- tv が
NaN の場合、RangeError 例外をスローする。 Assert : tv は整数Numberである。- tv が
Date Time String Format で表現できない年に対応する場合、RangeError 例外をスローする。 - UTC時間スケール上で、すべての形式要素およびUTCオフセット表現
"Z" を含む、Date Time String Format における tv のString表現を返す。
21.4.4.37 Date.prototype.toJSON ( key )
このメソッドは、JSON.stringify（
呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - tv を ?
ToPrimitive (obj,number ) とする。 - tv がNumberであり、かつ tv が有限でない場合、
null を返す。 - ?
Invoke (obj,"toISOString" ) を返す。
引数は無視されます。
このメソッドは意図的に汎用です。そのtoISOStringメソッドを持つことは要求されます。
21.4.4.38 Date.prototype.toLocaleDateString ( [ reserved1 [ , reserved2 ] ] )
ECMA-402 Internationalization APIを含むECMAScript実装は、このメソッドをECMA-402仕様で指定されるとおりに実装しなければなりません。ECMAScript実装がECMA-402 APIを含まない場合、このメソッドについて以下の仕様が使用されます：
このメソッドはString値を返します。Stringの内容は実装定義ですが、ホスト環境の現在のロケールの慣習に対応する便利で人間が読める形式で、現在の時間帯におけるDateの「日付」部分を表すことを意図しています。
このメソッドの任意パラメーターの意味はECMA-402仕様で定義されます。ECMA-402サポートを含まない実装は、これらのパラメーター位置を他の目的に使用してはなりません。
21.4.4.39 Date.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
ECMA-402 Internationalization APIを含むECMAScript実装は、このメソッドをECMA-402仕様で指定されるとおりに実装しなければなりません。ECMAScript実装がECMA-402 APIを含まない場合、このメソッドについて以下の仕様が使用されます：
このメソッドはString値を返します。Stringの内容は実装定義ですが、ホスト環境の現在のロケールの慣習に対応する便利で人間が読める形式で、現在の時間帯におけるDateを表すことを意図しています。
このメソッドの任意パラメーターの意味はECMA-402仕様で定義されます。ECMA-402サポートを含まない実装は、これらのパラメーター位置を他の目的に使用してはなりません。
21.4.4.40 Date.prototype.toLocaleTimeString ( [ reserved1 [ , reserved2 ] ] )
ECMA-402 Internationalization APIを含むECMAScript実装は、このメソッドをECMA-402仕様で指定されるとおりに実装しなければなりません。ECMAScript実装がECMA-402 APIを含まない場合、このメソッドについて以下の仕様が使用されます：
このメソッドはString値を返します。Stringの内容は実装定義ですが、ホスト環境の現在のロケールの慣習に対応する便利で人間が読める形式で、現在の時間帯におけるDateの「時刻」部分を表すことを意図しています。
このメソッドの任意パラメーターの意味はECMA-402仕様で定義されます。ECMA-402サポートを含まない実装は、これらのパラメーター位置を他の目的に使用してはなりません。
21.4.4.41 Date.prototype.toString ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - tv を dateObject.[[DateValue]] とする。
ToDateString (tv) を返す。
d.[[DateValue]] が1000で割り切れる任意のDate dについて、Date.parse(d.toString()) の結果 = d.valueOf() です。
このメソッドは汎用ではありません。その
21.4.4.41.1 TimeString ( tv )
The
- hour を
ToZeroPaddedDecimalString (ℝ (HourFromTime (tv)), 2) とする。 - minute を
ToZeroPaddedDecimalString (ℝ (MinFromTime (tv)), 2) とする。 - second を
ToZeroPaddedDecimalString (ℝ (SecFromTime (tv)), 2) とする。 - hour、
":" 、minute、":" 、second、コード単位0x0020（SPACE）、および"GMT" の文字列連結を返す。
21.4.4.41.2 DateString ( tv )
The
- weekday を、Number
WeekDay (tv) を持つTable 60 内のエントリのNameとする。 - month を、Number
MonthFromTime (tv) を持つTable 61 内のエントリのNameとする。 - day を
ToZeroPaddedDecimalString (ℝ (DateFromTime (tv)), 2) とする。 - yv を
YearFromTime (tv) とする。 - yv が
+0 𝔽 であるか、または yv >+0 𝔽 の場合、yearSign を空のStringとする。そうでない場合、yearSign を"-" とする。 - paddedYear を
ToZeroPaddedDecimalString (abs (ℝ (yv)), 4) とする。 - weekday、コード単位0x0020（SPACE）、month、コード単位0x0020（SPACE）、day、コード単位0x0020（SPACE）、yearSign、および paddedYear の文字列連結を返す。
| Number | Name |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Number | Name |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
21.4.4.41.3 TimeZoneString ( tv )
The
- systemTimeZoneIdentifier を
SystemTimeZoneIdentifier () とする。 IsTimeZoneOffsetString (systemTimeZoneIdentifier) がtrue の場合、次を行う：- offsetNs を
ParseTimeZoneOffsetString (systemTimeZoneIdentifier) とする。
- offsetNs を
- それ以外の場合、
- offsetNs を
GetNamedTimeZoneOffsetNanoseconds (systemTimeZoneIdentifier,ℤ (ℝ (tv) × 106)) とする。
- offsetNs を
- offset を
𝔽 (truncate (offsetNs / 106)) とする。 - offset が
+0 𝔽 であるか、または offset >+0 𝔽 の場合、次を行う：- offsetSign を
"+" とする。 - absOffset を offset とする。
- offsetSign を
- それ以外の場合、
- offsetSign を
"-" とする。 - absOffset を -offset とする。
- offsetSign を
- offsetMin を
ToZeroPaddedDecimalString (ℝ (MinFromTime (absOffset)), 2) とする。 - offsetHour を
ToZeroPaddedDecimalString (ℝ (HourFromTime (absOffset)), 2) とする。 - tzName を、空のString、またはコード単位0x0020（SPACE）、コード単位0x0028（LEFT PARENTHESIS）、実装定義の時間帯名、およびコード単位0x0029（RIGHT PARENTHESIS）の文字列連結のいずれかである実装定義の文字列とする。
- offsetSign、offsetHour、offsetMin、および tzName の文字列連結を返す。
21.4.4.41.4 ToDateString ( tv )
The
- tv が
NaN の場合、"Invalid Date" を返す。 - t を
LocalTime (tv) とする。 DateString (t)、コード単位0x0020（SPACE）、TimeString (t)、およびTimeZoneString (tv) の文字列連結を返す。
21.4.4.42 Date.prototype.toTimeString ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - tv を dateObject.[[DateValue]] とする。
- tv が
NaN の場合、"Invalid Date" を返す。 - t を
LocalTime (tv) とする。 TimeString (t) とTimeZoneString (tv) の文字列連結を返す。
21.4.4.43 Date.prototype.toUTCString ( )
このメソッドは、
呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - tv を dateObject.[[DateValue]] とする。
- tv が
NaN の場合、"Invalid Date" を返す。 - weekday を、Number
WeekDay (tv) を持つTable 60 内のエントリのNameとする。 - month を、Number
MonthFromTime (tv) を持つTable 61 内のエントリのNameとする。 - day を
ToZeroPaddedDecimalString (ℝ (DateFromTime (tv)), 2) とする。 - yv を
YearFromTime (tv) とする。 - yv が
+0 𝔽 であるか、または yv >+0 𝔽 の場合、yearSign を空のStringとする。そうでない場合、yearSign を"-" とする。 - paddedYear を
ToZeroPaddedDecimalString (abs (ℝ (yv)), 4) とする。 - weekday、
"," 、コード単位0x0020（SPACE）、day、コード単位0x0020（SPACE）、month、コード単位0x0020（SPACE）、yearSign、paddedYear、コード単位0x0020（SPACE）、およびTimeString (tv) の文字列連結を返す。
21.4.4.44 Date.prototype.valueOf ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- dateObject を
this 値とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - dateObject.[[DateValue]] を返す。
21.4.4.45 Date.prototype [ %Symbol.toPrimitive% ] ( hint )
このメソッドは、Dateをプリミティブ値に変換するためにECMAScript言語演算子によって呼び出されます。hint に許される値は
呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - obj がObjectでない場合、
TypeError 例外をスローする。 - hint が
"string" または"default" のいずれかである場合、次を行う：- tryFirst を
string とする。
- tryFirst を
- そうでなく hint が
"number" である場合、次を行う：- tryFirst を
number とする。
- tryFirst を
- それ以外の場合、
TypeError 例外をスローする。
- ?
OrdinaryToPrimitive (obj, tryFirst) を返す。
このプロパティの属性は { [[Writable]]:
このメソッドの
21.4.5 Dateインスタンスのプロパティ
Dateインスタンスは、
22 テキスト処理
22.1 Stringオブジェクト
22.1.1 Stringコンストラクター
Stringコンストラクターは以下の通りです：
- %String%である。
グローバルオブジェクト の"String" プロパティの初期値である。- コンストラクターとして呼び出されたとき、新しいStringオブジェクトを作成して初期化する。
- コンストラクターとしてではなく関数として呼び出されたとき、型変換を実行する。
- クラス定義の
extends節の値として使用できる。指定されたStringの動作を継承することを意図するサブクラスコンストラクターは、[[StringData]]内部スロットを持つサブクラスインスタンスを作成して初期化するために、Stringコンストラクターへのsuper呼び出しを含めなければならない。
22.1.1.1 String ( value )
この関数は呼び出されたとき、次の手順を実行します：
- value が存在しない場合、次を行う：
- str を空のStringとする。
- それ以外の場合、
- NewTarget が
undefined であり、かつ value がSymbolである場合、SymbolDescriptiveString (value) を返す。 - str を ?
ToString (value) とする。
- NewTarget が
- NewTarget が
undefined の場合、str を返す。 StringCreate (str, ?GetPrototypeFromConstructor (NewTarget,"%String.prototype%" )) を返す。
22.1.2 Stringコンストラクターのプロパティ
Stringコンストラクターは以下の通りです：
- [[Prototype]]内部スロットを持ち、その値は
%Function.prototype% である。 - 以下のプロパティを持つ：
22.1.2.1 String.fromCharCode ( ...codeUnits )
この関数は、restパラメーター codeUnits を形成する任意個数の引数で呼び出すことができます。
呼び出されたとき、次の手順を実行します：
この関数の
22.1.2.2 String.fromCodePoint ( ...codePoints )
この関数は、restパラメーター codePoints を形成する任意個数の引数で呼び出すことができます。
呼び出されたとき、次の手順を実行します：
- result を空のStringとする。
- codePoints の各要素 next について、次を行う：
- nextCP を ?
ToNumber (next) とする。 - nextCP が整数Numberでない場合、
RangeError 例外をスローする。 ℝ (nextCP) < 0 またはℝ (nextCP) > 0x10FFFF の場合、RangeError 例外をスローする。- result を result と
UTF16EncodeCodePoint (ℝ (nextCP)) の文字列連結に設定する。
- nextCP を ?
Assert : codePoints が空の場合、result は空のStringである。- result を返す。
この関数の
22.1.2.3 String.prototype
String.prototypeの初期値は
このプロパティの属性は { [[Writable]]:
22.1.2.4 String.raw ( template, ...substitutions )
この関数は可変個数の引数で呼び出すことができます。第1引数は template であり、残りの引数は
呼び出されたとき、次の手順を実行します：
- substitutionCount を substitutions 内の要素数とする。
- cooked を ?
ToObject (template) とする。 - literals を ?
ToObject (?Get (cooked,"raw" )) とする。 - literalCount を ?
LengthOfArrayLike (literals) とする。 - literalCount ≤ 0 の場合、空のStringを返す。
- result を空のStringとする。
- nextIndex を 0 とする。
- 繰り返す：
- nextLiteralVal を ?
Get (literals, !ToString (𝔽 (nextIndex))) とする。 - nextLiteral を ?
ToString (nextLiteralVal) とする。 - result を result と nextLiteral の文字列連結に設定する。
- nextIndex + 1 = literalCount の場合、result を返す。
- nextIndex < substitutionCount の場合、次を行う：
- nextSubVal を substitutions[nextIndex] とする。
- nextSub を ?
ToString (nextSubVal) とする。 - result を result と nextSub の文字列連結に設定する。
- nextIndex を nextIndex + 1 に設定する。
- nextLiteralVal を ?
この関数はTagged Template（
22.1.3 Stringプロトタイプオブジェクトのプロパティ
Stringプロトタイプオブジェクトは以下の通りです：
- %String.prototype%である。
- String
exotic object であり、そのようなオブジェクトに指定された内部メソッドを持つ。 - [[StringData]]内部スロットを持ち、その値は空のStringである。
- 初期値が
+0 𝔽 であり、属性が { [[Writable]]:false , [[Enumerable]]:false , [[Configurable]]:false } である"length" プロパティを持つ。 - [[Prototype]]内部スロットを持ち、その値は
%Object.prototype% である。
明示的に別途述べられている場合を除き、以下で定義されるStringプロトタイプオブジェクトのメソッドは汎用ではなく、それらに渡される
22.1.3.1 String.prototype.at ( index )
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - str を ?
ToString (thisValue) とする。 - len を str の長さとする。
- relativeIndex を ?
ToIntegerOrInfinity (index) とする。 - relativeIndex ≥ 0 の場合、次を行う：
- k を relativeIndex とする。
- それ以外の場合、
- k を len + relativeIndex とする。
- k < 0 または k ≥ len の場合、
undefined を返す。 - str の k から k + 1 までの部分文字列を返す。
22.1.3.2 String.prototype.charAt ( pos )
このメソッドは、このオブジェクトをStringに変換した結果のString値内のインデックス pos にあるコード単位を含む、単一要素のStringを返します。そのインデックスに要素が存在しない場合、結果は空のStringです。結果はString値であり、Stringオブジェクトではありません。
posが整数Numberである場合、x.charAt(pos)の結果はx.substring(pos, pos + 1)の結果と等価です。
このメソッドは呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - str を ?
ToString (thisValue) とする。 - position を ?
ToIntegerOrInfinity (pos) とする。 - size を str の長さとする。
- position < 0 または position ≥ size の場合、空のStringを返す。
- str の position から position + 1 までの部分文字列を返す。
このメソッドは意図的に汎用です。その
22.1.3.3 String.prototype.charCodeAt ( pos )
このメソッドは、このオブジェクトをStringに変換した結果のString内のインデックス pos にあるコード単位の数値であるNumber（216未満の非負の整数Number）を返します。そのインデックスに要素が存在しない場合、結果は
このメソッドは呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - str を ?
ToString (thisValue) とする。 - position を ?
ToIntegerOrInfinity (pos) とする。 - size を str の長さとする。
- position < 0 または position ≥ size の場合、
NaN を返す。 - String str 内のインデックス position にあるコード単位の数値に対応するNumber値を返す。
このメソッドは意図的に汎用です。その
22.1.3.4 String.prototype.codePointAt ( pos )
このメソッドは、このオブジェクトをStringに変換した結果のString内のインデックス pos にある文字列要素から始まるUTF-16符号化コードポイント（
このメソッドは呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - str を ?
ToString (thisValue) とする。 - position を ?
ToIntegerOrInfinity (pos) とする。 - size を str の長さとする。
- position < 0 または position ≥ size の場合、
undefined を返す。 - cp を
CodePointAt (str, position) とする。 𝔽 (cp.[[CodePoint]]) を返す。
このメソッドは意図的に汎用です。その
22.1.3.5 String.prototype.concat ( ...args )
このメソッドが呼び出されたとき、
このメソッドは呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - str を ?
ToString (thisValue) とする。 - result を str とする。
- args の各要素 next について、次を行う：
- nextString を ?
ToString (next) とする。 - result を result と nextString の文字列連結に設定する。
- nextString を ?
- result を返す。
このメソッドの
このメソッドは意図的に汎用です。その
22.1.3.6 String.prototype.constructor
String.prototype.constructorの初期値は
22.1.3.7 String.prototype.endsWith ( searchString [ , endPosition ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - str を ?
ToString (thisValue) とする。 - isRegExp を ?
IsRegExp (searchString) とする。 - isRegExp が
true の場合、TypeError 例外をスローする。 - searchStr を ?
ToString (searchString) とする。 - len を str の長さとする。
- endPosition が
undefined の場合、pos を len とする。そうでない場合、pos を ?ToIntegerOrInfinity (endPosition) とする。 - end を pos を 0 と len の間にクランプした結果とする。
- searchLength を searchStr の長さとする。
- searchLength = 0 の場合、
true を返す。 - start を end - searchLength とする。
- start < 0 の場合、
false を返す。 - substring を str の start から end までの部分文字列とする。
- substring が searchStr である場合、
true を返す。 false を返す。
第1引数がRegExpである場合に例外をスローすることは、将来の版がそのような引数値を許す拡張を定義できるようにするために指定されています。
このメソッドは意図的に汎用です。その
22.1.3.8 String.prototype.includes ( searchString [ , position ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - str を ?
ToString (thisValue) とする。 - isRegExp を ?
IsRegExp (searchString) とする。 - isRegExp が
true の場合、TypeError 例外をスローする。 - searchStr を ?
ToString (searchString) とする。 - pos を ?
ToIntegerOrInfinity (position) とする。 Assert : position がundefined の場合、pos は 0 である。- len を str の長さとする。
- start を pos を 0 と len の間にクランプした結果とする。
- index を
StringIndexOf (str, searchStr, start) とする。 - index が
not-found の場合、false を返す。 true を返す。
searchString が、このオブジェクトをStringに変換した結果の
第1引数がRegExpである場合に例外をスローすることは、将来の版がそのような引数値を許す拡張を定義できるようにするために指定されています。
このメソッドは意図的に汎用です。その
22.1.3.9 String.prototype.indexOf ( searchString [ , position ] )
searchString が、このオブジェクトをStringに変換した結果の
このメソッドは呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - str を ?
ToString (thisValue) とする。 - searchStr を ?
ToString (searchString) とする。 - pos を ?
ToIntegerOrInfinity (position) とする。 Assert : position がundefined の場合、pos は 0 である。- len を str の長さとする。
- start を pos を 0 と len の間にクランプした結果とする。
- result を
StringIndexOf (str, searchStr, start) とする。 - result が
not-found の場合、-1 𝔽 を返す。 𝔽 (result) を返す。
このメソッドは意図的に汎用です。その
22.1.3.10 String.prototype.isWellFormed ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - str を ?
ToString (thisValue) とする。 IsStringWellFormedUnicode (str) を返す。
22.1.3.11 String.prototype.lastIndexOf ( searchString [ , position ] )
searchString が、このオブジェクトをStringに変換した結果の
このメソッドは呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - str を ?
ToString (thisValue) とする。 - searchStr を ?
ToString (searchString) とする。 - numPos を ?
ToNumber (position) とする。 Assert : position がundefined の場合、numPos はNaN である。- numPos が
NaN の場合、pos を +∞ とする。そうでない場合、pos を !ToIntegerOrInfinity (numPos) とする。 - len を str の長さとする。
- searchLen を searchStr の長さとする。
- len < searchLen の場合、
-1 𝔽 を返す。 - start を pos を 0 と len - searchLen の間にクランプした結果とする。
- result を
StringLastIndexOf (str, searchStr, start) とする。 - result が
not-found の場合、-1 𝔽 を返す。 𝔽 (result) を返す。
このメソッドは意図的に汎用です。その
22.1.3.12 String.prototype.localeCompare ( that [ , reserved1 [ , reserved2 ] ] )
ECMA-402 Internationalization APIを含むECMAScript実装は、このメソッドをECMA-402仕様で指定されるとおりに実装しなければなりません。ECMAScript実装がECMA-402 APIを含まない場合、このメソッドについて以下の仕様が使用されます：
このメソッドは、
比較を実行する前に、このメソッドはStringを準備するために次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - str を ?
ToString (thisValue) とする。 - thatValue を ?
ToString (that) とする。
このメソッドの任意の第2および第3パラメーターの意味はECMA-402仕様で定義されます。ECMA-402サポートを含まない実装は、それらのパラメーター位置に他の解釈を割り当ててはなりません。
実際の戻り値は、追加情報をエンコードすることを許すために実装定義ですが、このメソッドは、2つの引数のメソッドとして考えた場合、すべてのStringの集合上の全順序を定義する
このメソッド自体は、Array.prototype.sortへの引数として直接適していません。後者は2つの引数の関数を要求するためです。
このメソッドは、ECMAScript環境がホスト環境から利用できる任意の言語依存および/またはロケール依存の比較機能に依存してもよく、ホスト環境の現在のロケールの慣習に従って比較することを意図しています。しかし、比較能力に関係なく、このメソッドはUnicode Standardに従う正準等価性を認識して尊重しなければなりません。たとえば、以下の比較はすべて
// Å ANGSTROM SIGN vs.
// Å LATIN CAPITAL LETTER A + COMBINING RING ABOVE
"\u212B".localeCompare("A\u030A")
// Ω OHM SIGN vs.
// Ω GREEK CAPITAL LETTER OMEGA
"\u2126".localeCompare("\u03A9")
// ṩ LATIN SMALL LETTER S WITH DOT BELOW AND DOT ABOVE vs.
// ṩ LATIN SMALL LETTER S + COMBINING DOT ABOVE + COMBINING DOT BELOW
"\u1E69".localeCompare("s\u0307\u0323")
// ḍ̇ LATIN SMALL LETTER D WITH DOT ABOVE + COMBINING DOT BELOW vs.
// ḍ̇ LATIN SMALL LETTER D WITH DOT BELOW + COMBINING DOT ABOVE
"\u1E0B\u0323".localeCompare("\u1E0D\u0307")
// 가 HANGUL CHOSEONG KIYEOK + HANGUL JUNGSEONG A vs.
// 가 HANGUL SYLLABLE GA
"\u1100\u1161".localeCompare("\uAC00")正準等価性の定義および議論については、Unicode Standardの第2章および第3章、ならびに Unicode Standard Annex #15, Unicode Normalization Forms および Unicode Technical Note #5, Canonical Equivalence in Applications を参照してください。また、Unicode Technical Standard #10, Unicode Collation Algorithm も参照してください。
このメソッドは、Unicode Standard第3章3.7節で定義されるUnicode互換等価性または互換分解を尊重しないことが推奨されます。
このメソッドは意図的に汎用です。その
22.1.3.13 String.prototype.match ( regexpOrPattern )
このメソッドは呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - regexpOrPattern がObjectである場合、次を行う：
- matcher を ?
GetMethod (regexpOrPattern,%Symbol.match% ) とする。 - matcher が
undefined でない場合、次を行う：- ?
Call (matcher, regexpOrPattern, « thisValue ») を返す。
- ?
- matcher を ?
- str を ?
ToString (thisValue) とする。 - regexp を ?
RegExpCreate (regexpOrPattern,undefined ) とする。 - ?
Invoke (regexp,%Symbol.match% , « str ») を返す。
このメソッドは意図的に汎用です。その
22.1.3.14 String.prototype.matchAll ( regexpOrPattern )
このメソッドは、
呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - regexpOrPattern がObjectである場合、次を行う：
- isRegExp を ?
IsRegExp (regexpOrPattern) とする。 - isRegExp が
true の場合、次を行う：- flags を ?
Get (regexpOrPattern,"flags" ) とする。 - ?
RequireObjectCoercible (flags) を実行する。 - ?
ToString (flags) が"g" を含まない場合、TypeError 例外をスローする。
- flags を ?
- matcher を ?
GetMethod (regexpOrPattern,%Symbol.matchAll% ) とする。 - matcher が
undefined でない場合、次を行う：- ?
Call (matcher, regexpOrPattern, « thisValue ») を返す。
- ?
- isRegExp を ?
- str を ?
ToString (thisValue) とする。 - regexp を ?
RegExpCreate (regexpOrPattern,"g" ) とする。 - ?
Invoke (regexp,%Symbol.matchAll% , « str ») を返す。
String.prototype.splitと同様に、String.prototype.matchAllは通常、入力を変更せずに動作するように設計されています。22.1.3.15 String.prototype.normalize ( [ form ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - str を ?
ToString (thisValue) とする。 - form が
undefined の場合、f を"NFC" とする。 - それ以外の場合、f を ?
ToString (form) とする。 - f が
"NFC" 、"NFD" 、"NFKC" 、または"NFKD" のいずれでもない場合、RangeError 例外をスローする。 - ns を、最新のUnicode Standard, Normalization Forms で指定されるように、str を f によって名付けられる正規化形式へ正規化した結果であるString値とする。
- ns を返す。
このメソッドは意図的に汎用です。その
22.1.3.16 String.prototype.padEnd ( maxLength [ , fillString ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - ?
StringPaddingBuiltinsImpl (thisValue, maxLength, fillString,end ) を返す。
22.1.3.17 String.prototype.padStart ( maxLength [ , fillString ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - ?
StringPaddingBuiltinsImpl (thisValue, maxLength, fillString,start ) を返す。
22.1.3.17.1 StringPaddingBuiltinsImpl ( thisValue, maxLength, fillString, placement )
The
- str を ?
ToString (thisValue) とする。 - intMaxLength を
ℝ (?ToLength (maxLength)) とする。 - stringLength を str の長さとする。
- intMaxLength ≤ stringLength の場合、str を返す。
- fillString が
undefined の場合、fillString をコード単位0x0020（SPACE）のみから成るString値に設定する。 - それ以外の場合、fillString を ?
ToString (fillString) に設定する。 StringPad (str, intMaxLength, fillString, placement) を返す。
22.1.3.17.2 StringPad ( str, maxLength, fillString, placement )
The
- stringLength を str の長さとする。
- maxLength ≤ stringLength の場合、str を返す。
- fillString が空のStringである場合、str を返す。
- fillLen を maxLength - stringLength とする。
- truncatedStringFiller を、fillString の反復連結を長さ fillLen に切り詰めたString値とする。
- placement が
start である場合、truncatedStringFiller と str の文字列連結を返す。 - str と truncatedStringFiller の文字列連結を返す。
引数 maxLength は、str の長さより小さくならないようにクランプされます。
引数 fillString の既定値は
22.1.3.17.3 ToZeroPaddedDecimalString ( n, minLength )
The
- str を、10進数として形式化された n のString表現とする。
StringPad (str, minLength,"0" ,start ) を返す。
22.1.3.18 String.prototype.repeat ( count )
このメソッドは呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - str を ?
ToString (thisValue) とする。 - n を ?
ToIntegerOrInfinity (count) とする。 - n < 0 または n = +∞ の場合、
RangeError 例外をスローする。 - n = 0 の場合、空のStringを返す。
- str の n 個のコピーを連結して作られるString値を返す。
このメソッドは、
このメソッドは意図的に汎用です。その
22.1.3.19 String.prototype.replace ( searchValue, replaceValue )
このメソッドは呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - searchValue がObjectである場合、次を行う：
- replacer を ?
GetMethod (searchValue,%Symbol.replace% ) とする。 - replacer が
undefined でない場合、次を行う：- ?
Call (replacer, searchValue, « thisValue, replaceValue ») を返す。
- ?
- replacer を ?
- string を ?
ToString (thisValue) とする。 - searchString を ?
ToString (searchValue) とする。 - functionalReplace を
IsCallable (replaceValue) とする。 - functionalReplace が
false の場合、次を行う：- replaceValue を ?
ToString (replaceValue) に設定する。
- replaceValue を ?
- searchLength を searchString の長さとする。
- position を
StringIndexOf (string, searchString, 0) とする。 - position が
not-found の場合、string を返す。 - preceding を string の 0 から position までの部分文字列とする。
- following を string の position + searchLength からの部分文字列とする。
- functionalReplace が
true の場合、次を行う： - それ以外の場合、
Assert : replaceValue はStringである。- captures を新しい空の
List とする。 - replacement を !
GetSubstitution (searchString, string, position, captures,undefined , replaceValue) とする。
- preceding、replacement、および following の文字列連結を返す。
このメソッドは意図的に汎用です。その
22.1.3.19.1 GetSubstitution ( matched, str, position, captures, namedCaptures, replacementTemplate )
The
- stringLength を str の長さとする。
Assert : position ≤ stringLength。- result を空のStringとする。
- templateRemainder を replacementTemplate とする。
- templateRemainder が空のStringでない間、繰り返す：
NOTE : 以下のステップは ref（templateRemainder の接頭辞）を分離し、refReplacement（その置換）を決定し、その置換を result に追加する。- templateRemainder が
"$$" で始まる場合、次を行う：- ref を
"$$" とする。 - refReplacement を
"$" とする。
- ref を
- そうでなく templateRemainder が
"$`" で始まる場合、次を行う：- ref を
"$`" とする。 - refReplacement を str の 0 から position までの部分文字列とする。
- ref を
- そうでなく templateRemainder が
"$&" で始まる場合、次を行う：- ref を
"$&" とする。 - refReplacement を matched とする。
- ref を
- そうでなく templateRemainder が
"$'" （0x0024（DOLLAR SIGN）の後に0x0027（APOSTROPHE）が続く）で始まる場合、次を行う：- ref を
"$'" とする。 - matchLength を matched の長さとする。
- tailPos を position + matchLength とする。
- refReplacement を str の
min (tailPos, stringLength) からの部分文字列とする。 NOTE : tailPos が stringLength を超える可能性があるのは、この抽象操作が、"exec" プロパティが組み込みの %RegExp.prototype.exec% ではないオブジェクト上で%RegExp.prototype% の組み込み%Symbol.replace% メソッドの呼び出しによって起動された場合だけである。
- ref を
- そうでなく templateRemainder が
"$" に続けて1つ以上の10進数字で始まる場合、次を行う：- templateRemainder が
"$" に続けて2つ以上の10進数字で始まる場合、digitCount を 2 とする。そうでない場合、digitCount を 1 とする。 - digits を templateRemainder の 1 から 1 + digitCount までの部分文字列とする。
- index を
ℝ (StringToNumber (digits)) とする。 Assert : 0 ≤ index ≤ 99。- captureLen を captures 内の要素数とする。
- index > captureLen かつ digitCount = 2 の場合、次を行う：
NOTE : 2桁の置換パターンがキャプチャグループ数を超えるインデックスを指定する場合、それは1桁の置換パターンに続くリテラル数字として扱われる。- digitCount を 1 に設定する。
- digits を digits の 0 から 1 までの部分文字列に設定する。
- index を
ℝ (StringToNumber (digits)) に設定する。
- ref を templateRemainder の 0 から 1 + digitCount までの部分文字列とする。
- 1 ≤ index ≤ captureLen の場合、次を行う：
- capture を captures[index - 1] とする。
- capture が
undefined の場合、次を行う：- refReplacement を空のStringとする。
- それ以外の場合、
- refReplacement を capture とする。
- それ以外の場合、
- refReplacement を ref とする。
- templateRemainder が
- そうでなく templateRemainder が
"$<" で始まる場合、次を行う：- gtPos を
StringIndexOf (templateRemainder,">" , 0) とする。 - gtPos が
not-found であるか、または namedCaptures がundefined である場合、次を行う：- ref を
"$<" とする。 - refReplacement を ref とする。
- ref を
- それ以外の場合、
- gtPos を
- それ以外の場合、
- ref を templateRemainder の 0 から 1 までの部分文字列とする。
- refReplacement を ref とする。
- refLength を ref の長さとする。
- templateRemainder を templateRemainder の refLength からの部分文字列に設定する。
- result を result と refReplacement の文字列連結に設定する。
- result を返す。
22.1.3.20 String.prototype.replaceAll ( searchValue, replaceValue )
このメソッドは呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - searchValue がObjectである場合、次を行う：
- isRegExp を ?
IsRegExp (searchValue) とする。 - isRegExp が
true の場合、次を行う：- flags を ?
Get (searchValue,"flags" ) とする。 - ?
RequireObjectCoercible (flags) を実行する。 - ?
ToString (flags) が"g" を含まない場合、TypeError 例外をスローする。
- flags を ?
- replacer を ?
GetMethod (searchValue,%Symbol.replace% ) とする。 - replacer が
undefined でない場合、次を行う：- ?
Call (replacer, searchValue, « thisValue, replaceValue ») を返す。
- ?
- isRegExp を ?
- string を ?
ToString (thisValue) とする。 - searchString を ?
ToString (searchValue) とする。 - functionalReplace を
IsCallable (replaceValue) とする。 - functionalReplace が
false の場合、次を行う：- replaceValue を ?
ToString (replaceValue) に設定する。
- replaceValue を ?
- searchLength を searchString の長さとする。
- advanceBy を
max (1, searchLength) とする。 - matchPositions を新しい空の
List とする。 - position を
StringIndexOf (string, searchString, 0) とする。 - position が
not-found でない間、繰り返す：- position を matchPositions に追加する。
- position を
StringIndexOf (string, searchString, position + advanceBy) に設定する。
- endOfLastMatch を 0 とする。
- result を空のStringとする。
- matchPositions の各要素 matchPosition について、次を行う：
- preserved を string の endOfLastMatch から matchPosition までの部分文字列とする。
- functionalReplace が
true の場合、次を行う： - それ以外の場合、
Assert : replaceValue はStringである。- captures を新しい空の
List とする。 - replacement を !
GetSubstitution (searchString, string, matchPosition, captures,undefined , replaceValue) とする。
- result を result、preserved、および replacement の文字列連結に設定する。
- endOfLastMatch を matchPosition + searchLength に設定する。
- endOfLastMatch < string の長さ の場合、次を行う：
- result を result と string の endOfLastMatch からの部分文字列の文字列連結に設定する。
- result を返す。
22.1.3.21 String.prototype.search ( regexpOrPattern )
このメソッドは呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - regexpOrPattern がObjectである場合、次を行う：
- searcher を ?
GetMethod (regexpOrPattern,%Symbol.search% ) とする。 - searcher が
undefined でない場合、次を行う：- ?
Call (searcher, regexpOrPattern, « thisValue ») を返す。
- ?
- searcher を ?
- string を ?
ToString (thisValue) とする。 - regexp を ?
RegExpCreate (regexpOrPattern,undefined ) とする。 - ?
Invoke (regexp,%Symbol.search% , « string ») を返す。
このメソッドは意図的に汎用です。その
22.1.3.22 String.prototype.slice ( start, end )
このメソッドは、このオブジェクトをStringに変換した結果の
呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - str を ?
ToString (thisValue) とする。 - len を str の長さとする。
- intStart を ?
ToIntegerOrInfinity (start) とする。 - intStart = -∞ の場合、from を 0 とする。
- そうでなく intStart < 0 の場合、from を
max (len + intStart, 0) とする。 - それ以外の場合、from を
min (intStart, len) とする。 - end が
undefined の場合、intEnd を len とする。そうでない場合、intEnd を ?ToIntegerOrInfinity (end) とする。 - intEnd = -∞ の場合、to を 0 とする。
- そうでなく intEnd < 0 の場合、to を
max (len + intEnd, 0) とする。 - それ以外の場合、to を
min (intEnd, len) とする。 - from ≥ to の場合、空のStringを返す。
- str の from から to までの部分文字列を返す。
このメソッドは意図的に汎用です。その
22.1.3.23 String.prototype.split ( separator, limit )
このメソッドは、このオブジェクトをStringに変換した結果の部分文字列を格納したArrayを返します。部分文字列は、separator の出現を左から右に検索することによって決定されます。これらの出現は、返される配列内のどのStringの一部でもありませんが、String値を分割する役割を果たします。separator の値は任意の長さのStringであってもよく、または
呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - separator がObjectである場合、次を行う：
- splitter を ?
GetMethod (separator,%Symbol.split% ) とする。 - splitter が
undefined でない場合、次を行う：- ?
Call (splitter, separator, « thisValue, limit ») を返す。
- ?
- splitter を ?
- str を ?
ToString (thisValue) とする。 - limit が
undefined の場合、lim を 232 - 1 とする。そうでない場合、lim をℝ (?ToUint32 (limit)) とする。 - separatorStr を ?
ToString (separator) とする。 - lim = 0 の場合、次を行う：
CreateArrayFromList (« ») を返す。
- separator が
undefined の場合、次を行う：CreateArrayFromList (« str ») を返す。
- separatorLength を separatorStr の長さとする。
- separatorLength = 0 の場合、次を行う：
- strLen を str の長さとする。
- outLen を lim を 0 と strLen の間にクランプした結果とする。
- head を str の 0 から outLen までの部分文字列とする。
- codeUnits を、head の要素であるコード単位の列から成る
List とする。 CreateArrayFromList (codeUnits) を返す。
- str が空のStringである場合、
CreateArrayFromList (« str ») を返す。 - substrings を新しい空の
List とする。 - searchStart を 0 とする。
- matchIndex を
StringIndexOf (str, separatorStr, 0) とする。 - matchIndex が
not-found でない間、繰り返す：- substring を str の searchStart から matchIndex までの部分文字列とする。
- substring を substrings に追加する。
- substrings 内の要素数が lim である場合、
CreateArrayFromList (substrings) を返す。 - searchStart を matchIndex + separatorLength に設定する。
- matchIndex を
StringIndexOf (str, separatorStr, searchStart) に設定する。
- substring を str の searchStart からの部分文字列とする。
- substring を substrings に追加する。
CreateArrayFromList (substrings) を返す。
separator の値は空のStringであってもかまいません。この場合、separator は入力Stringの先頭または末尾の空の
separator が
このメソッドは意図的に汎用です。その
22.1.3.24 String.prototype.startsWith ( searchString [ , position ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - str を ?
ToString (thisValue) とする。 - isRegExp を ?
IsRegExp (searchString) とする。 - isRegExp が
true の場合、TypeError 例外をスローする。 - searchStr を ?
ToString (searchString) とする。 - len を str の長さとする。
- position が
undefined の場合、pos を 0 とする。そうでない場合、pos を ?ToIntegerOrInfinity (position) とする。 - start を pos を 0 と len の間にクランプした結果とする。
- searchLength を searchStr の長さとする。
- searchLength = 0 の場合、
true を返す。 - end を start + searchLength とする。
- end > len の場合、
false を返す。 - substring を str の start から end までの部分文字列とする。
- substring が searchStr である場合、
true を返す。 false を返す。
第1引数がRegExpである場合に例外をスローすることは、将来の版がそのような引数値を許す拡張を定義できるようにするために指定されています。
このメソッドは意図的に汎用です。その
22.1.3.25 String.prototype.substring ( start, end )
このメソッドは、このオブジェクトをStringに変換した結果の
いずれかの引数が
start が end より厳密に大きい場合、それらは交換されます。
呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - str を ?
ToString (thisValue) とする。 - len を str の長さとする。
- intStart を ?
ToIntegerOrInfinity (start) とする。 - end が
undefined の場合、intEnd を len とする。そうでない場合、intEnd を ?ToIntegerOrInfinity (end) とする。 - finalStart を intStart を 0 と len の間にクランプした結果とする。
- finalEnd を intEnd を 0 と len の間にクランプした結果とする。
- from を
min (finalStart, finalEnd) とする。 - to を
max (finalStart, finalEnd) とする。 - str の from から to までの部分文字列を返す。
このメソッドは意図的に汎用です。その
22.1.3.26 String.prototype.toLocaleLowerCase ( [ reserved1 [ , reserved2 ] ] )
ECMA-402 Internationalization APIを含むECMAScript実装は、このメソッドをECMA-402仕様で指定されるとおりに実装しなければなりません。ECMAScript実装がECMA-402 APIを含まない場合、このメソッドについて以下の仕様が使用されます：
このメソッドは、
これはtoLowerCaseとまったく同じように動作しますが、ホスト環境の現在のロケールの慣習に対応するロケール依存の結果を生成することを意図している点が異なります。その言語の規則が通常のUnicode大文字小文字マッピングと衝突する少数の場合（トルコ語など）にのみ差異があります。
このメソッドの任意パラメーターの意味はECMA-402仕様で定義されます。ECMA-402サポートを含まない実装は、これらのパラメーター位置を他の目的に使用してはなりません。
このメソッドは意図的に汎用です。その
22.1.3.27 String.prototype.toLocaleUpperCase ( [ reserved1 [ , reserved2 ] ] )
ECMA-402 Internationalization APIを含むECMAScript実装は、このメソッドをECMA-402仕様で指定されるとおりに実装しなければなりません。ECMAScript実装がECMA-402 APIを含まない場合、このメソッドについて以下の仕様が使用されます：
このメソッドは、
これはtoUpperCaseとまったく同じように動作しますが、ホスト環境の現在のロケールの慣習に対応するロケール依存の結果を生成することを意図している点が異なります。その言語の規則が通常のUnicode大文字小文字マッピングと衝突する少数の場合（トルコ語など）にのみ差異があります。
このメソッドの任意パラメーターの意味はECMA-402仕様で定義されます。ECMA-402サポートを含まない実装は、これらのパラメーター位置を他の目的に使用してはなりません。
このメソッドは意図的に汎用です。その
22.1.3.28 String.prototype.toLowerCase ( )
このメソッドは、
呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - str を ?
ToString (thisValue) とする。 - sText を
StringToCodePoints (str) とする。 - lowerText を、Unicode Default Case Conversionアルゴリズムに従う toLowercase(sText) とする。
- lowercaseString を
CodePointsToString (lowerText) とする。 - lowercaseString を返す。
結果は、Unicode Character Databaseにおけるロケール非依存の大文字小文字マッピングに従って導かれなければなりません（これには、ファイル UnicodeData.txt だけでなく、それに付随するファイル SpecialCasing.txt 内のすべてのロケール非依存マッピングも明示的に含まれます）。
一部のコードポイントの大文字小文字マッピングは複数のコードポイントを生成する場合があります。この場合、結果のStringは元のStringと同じ長さでないことがあります。toUpperCaseとtoLowerCaseはいずれも文脈依存の動作を持つため、これらのメソッドは対称的ではありません。言い換えると、s.toUpperCase().toLowerCase()は必ずしもs.toLowerCase()と等しいとは限りません。
このメソッドは意図的に汎用です。その
22.1.3.29 String.prototype.toString ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- ?
ThisStringValue (this 値) を返す。
Stringオブジェクトの場合、このメソッドはたまたまvalueOfメソッドと同じものを返します。
22.1.3.30 String.prototype.toUpperCase ( )
このメソッドは、
これはString.prototype.toLowerCaseとまったく同じように動作しますが、StringがUnicode Default Case ConversionのtoUppercaseアルゴリズムを使用してマップされる点が異なります。
このメソッドは意図的に汎用です。その
22.1.3.31 String.prototype.toWellFormed ( )
このメソッドは、このオブジェクトのString表現を返します。その際、サロゲートペアの一部でないすべての先行サロゲートおよび後続サロゲートはU+FFFD（REPLACEMENT CHARACTER）に置き換えられます。
呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
RequireObjectCoercible (thisValue) を実行する。 - str を ?
ToString (thisValue) とする。 - strLen を str の長さとする。
- k を 0 とする。
- result を空のStringとする。
- k < strLen の間、繰り返す：
- cp を
CodePointAt (str, k) とする。 - cp.[[IsUnpairedSurrogate]] が
true の場合、次を行う：- result を result と 0xFFFD（REPLACEMENT CHARACTER）の文字列連結に設定する。
- それ以外の場合、
- result を result と
UTF16EncodeCodePoint (cp.[[CodePoint]]) の文字列連結に設定する。
- result を result と
- k を k + cp.[[CodeUnitCount]] に設定する。
- cp を
- result を返す。
22.1.3.32 String.prototype.trim ( )
このメソッドは、
呼び出されたとき、次の手順を実行します：
- thisValue を
this 値とする。 - ?
TrimString (thisValue,start+end ) を返す。
このメソッドは意図的に汎用です。その
22.1.3.32.1 TrimString ( string, where )
The
- ?
RequireObjectCoercible (string) を実行する。 - str を ?
ToString (string) とする。 - where が
start である場合、次を行う：- trimmedString を、先頭の空白を取り除いた str のコピーであるString値とする。
- そうでなく where が
end である場合、次を行う：- trimmedString を、末尾の空白を取り除いた str のコピーであるString値とする。
- それ以外の場合、
Assert : where はstart+end である。- trimmedString を、先頭と末尾の両方の空白を取り除いた str のコピーであるString値とする。
- trimmedString を返す。
空白の定義は
22.1.3.33 String.prototype.trimEnd ( )
このメソッドは、
呼び出されたとき、次の手順を実行します：
- str を
this 値とする。 - ?
TrimString (str,end ) を返す。
このメソッドは意図的に汎用です。その
22.1.3.34 String.prototype.trimStart ( )
このメソッドは、
呼び出されたとき、次の手順を実行します：
- str を
this 値とする。 - ?
TrimString (str,start ) を返す。
このメソッドは意図的に汎用です。その
22.1.3.35 String.prototype.valueOf ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- ?
ThisStringValue (this 値) を返す。
22.1.3.35.1 ThisStringValue ( value )
The
- value がStringである場合、value を返す。
- value がObjectであり、value が [[StringData]] 内部スロットを持つ場合、次を行う：
- str を value.[[StringData]] とする。
Assert : str はStringである。- str を返す。
TypeError 例外をスローする。
22.1.3.36 String.prototype [ %Symbol.iterator% ] ( )
このメソッドは、String値のコードポイントを反復し、各コードポイントをString値として返すイテレーターオブジェクトを返します。
呼び出されたとき、次の手順を実行します：
- str を
this 値とする。 - ?
RequireObjectCoercible (str) を実行する。 - str を ?
ToString (str) に設定する。 - closure を、パラメーターを持たず、str を捕捉し、呼び出されたときに次の手順を実行する新しい
Abstract Closure とする：- len を str の長さとする。
- position を 0 とする。
- position < len の間、繰り返す：
- cp を
CodePointAt (str, position) とする。 - nextIndex を position + cp.[[CodeUnitCount]] とする。
- resultString を str の position から nextIndex までの部分文字列とする。
- position を nextIndex に設定する。
- ?
GeneratorYield (CreateIteratorResultObject (resultString,false )) を実行する。
- cp を
NormalCompletion (unused ) を返す。
CreateIteratorFromClosure (closure,"%StringIteratorPrototype%" ,%StringIteratorPrototype% ) を返す。
このメソッドの
22.1.4 Stringインスタンスのプロパティ
StringインスタンスはString
Stringインスタンスは
22.1.4.1 length
このStringオブジェクトによって表されるString値内の要素数。
Stringオブジェクトが初期化されると、このプロパティは変化しません。その属性は { [[Writable]]:
22.1.5 String Iteratorオブジェクト
String Iterator は、ある特定のStringインスタンスオブジェクトに対する特定の反復を表すオブジェクトです。String Iteratorオブジェクトには名前付きコンストラクターはありません。代わりに、String IteratorオブジェクトはStringインスタンスオブジェクトの特定のメソッドを呼び出すことによって作成されます。
22.1.5.1 %StringIteratorPrototype%オブジェクト
%StringIteratorPrototype%オブジェクトは以下の通りです：
- すべての
String Iterator オブジェクトによって継承されるプロパティを持つ。 - 通常のオブジェクトである。
- [[Prototype]]内部スロットを持ち、その値は
%Iterator.prototype% である。 - 以下のプロパティを持つ：
22.1.5.1.1 %StringIteratorPrototype%.next ( )
- ?
GeneratorResume (this value,empty ,"%StringIteratorPrototype%" ) を返す。
22.1.5.1.2 %StringIteratorPrototype% [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
22.2 RegExp（正規表現）オブジェクト
RegExpオブジェクトは、正規表現および関連するフラグを含みます。
正規表現の形式および機能は、Perl 5プログラミング言語における正規表現機能をモデルとしています。
22.2.1 パターン
RegExpコンストラクターは、入力パターンStringに以下の文法を適用します。文法がStringを
構文
関連付けられる u \u \u u
ここでの最初の2行はCharacterClassと等価です。
この節のいくつかの生成式には、
22.2.1.1 Static Semantics: 早期エラー
この節は
-
CountLeftCapturingParensWithin (Pattern ) ≥ 232 - 1 の場合、Syntax Errorです。 -
Pattern が2つの異なるGroupSpecifier x および y を含み、x のCapturingGroupName が y のCapturingGroupName であり、かつMightBothParticipate (x, y) がtrue である場合、Syntax Errorです。
-
最初の
DecimalDigits のMVが2番目のDecimalDigits のMVより厳密に大きい場合、Syntax Errorです。
-
RegularExpressionModifiers に一致したソーステキストが同じコードポイントを複数回含む場合、Syntax Errorです。
-
最初の
RegularExpressionModifiers に一致したソーステキストと、2番目のRegularExpressionModifiers に一致したソーステキストの両方が空である場合、Syntax Errorです。 -
最初の
RegularExpressionModifiers に一致したソーステキストが同じコードポイントを複数回含む場合、Syntax Errorです。 -
2番目の
RegularExpressionModifiers に一致したソーステキストが同じコードポイントを複数回含む場合、Syntax Errorです。 -
最初の
RegularExpressionModifiers に一致したソーステキスト内の任意のコードポイントが、2番目のRegularExpressionModifiers に一致したソーステキストにも含まれる場合、Syntax Errorです。
-
GroupSpecifiersThatMatch (GroupName ) が空である場合、Syntax Errorです。
-
DecimalEscape のCapturingGroupNumber が、AtomEscape を含むPattern のCountLeftCapturingParensWithin より厳密に大きい場合、Syntax Errorです。
-
最初の
ClassAtom のIsCharacterClass がtrue であるか、2番目のClassAtom のIsCharacterClass がtrue である場合、Syntax Errorです。 -
最初の
ClassAtom のIsCharacterClass がfalse 、2番目のClassAtom のIsCharacterClass がfalse 、かつ最初のClassAtom のCharacterValue が2番目のClassAtom のCharacterValue より厳密に大きい場合、Syntax Errorです。
-
ClassAtomNoDash のIsCharacterClass がtrue であるか、ClassAtom のIsCharacterClass がtrue である場合、Syntax Errorです。 -
ClassAtomNoDash のIsCharacterClass がfalse 、ClassAtom のIsCharacterClass がfalse 、かつClassAtomNoDash のCharacterValue がClassAtom のCharacterValue より厳密に大きい場合、Syntax Errorです。
-
RegExpUnicodeEscapeSequence のCharacterValue が、IdentifierStartChar 字句文法生成式によって一致される何らかのコードポイントの数値でない場合、Syntax Errorです。
-
RegExpIdentifierStart のRegExpIdentifierCodePoint がUnicodeIDStart 字句文法生成式によって一致されない場合、Syntax Errorです。
-
RegExpUnicodeEscapeSequence のCharacterValue が、IdentifierPartChar 字句文法生成式によって一致される何らかのコードポイントの数値でない場合、Syntax Errorです。
-
RegExpIdentifierPart のRegExpIdentifierCodePoint がUnicodeIDContinue 字句文法生成式によって一致されない場合、Syntax Errorです。
-
UnicodePropertyName に一致したソーステキストが、Table 64 の「Property name and aliases 」列に列挙されているUnicodeプロパティ名 またはプロパティ別名でない場合、Syntax Errorです。 -
UnicodePropertyValue に一致したソーステキストが、UnicodePropertyName に一致したソーステキストによって与えられるUnicodeプロパティまたはプロパティ別名について、PropertyValueAliases.txtに列挙されているプロパティ値またはプロパティ値別名でない場合、Syntax Errorです。
-
LoneUnicodePropertyNameOrValue に一致したソーステキストが、PropertyValueAliases.txtに列挙されているGeneral_Category（gc）プロパティのUnicodeプロパティ値またはプロパティ値別名でも、Table 65 の「Property name and aliases 」列に列挙されている二値プロパティまたは二値プロパティ別名でも、Table 66 の「Property name 」列に列挙されている文字列の二値プロパティでもない場合、Syntax Errorです。 -
囲んでいる
Pattern が [UnicodeSetsMode] パラメーターを持たず、かつLoneUnicodePropertyNameOrValue に一致したソーステキストがTable 66 の「Property name 」列に列挙されている文字列の二値プロパティである場合、Syntax Errorです。
-
UnicodePropertyValueExpression のMayContainStrings がtrue である場合、Syntax Errorです。
-
ClassContents のMayContainStrings がtrue である場合、Syntax Errorです。
-
ClassContents のMayContainStrings がtrue である場合、Syntax Errorです。
-
最初の
ClassSetCharacter のCharacterValue が2番目のClassSetCharacter のCharacterValue より厳密に大きい場合、Syntax Errorです。
22.2.1.2 Static Semantics: CountLeftCapturingParensWithin ( node )
The ( 終端記号に一致する任意の ( パターン文字です。
この節は
It performs the following steps when called:
Assert : node はRegExp Pattern文法 内の生成式のインスタンスである。- node 内に含まれる
Atom :: ( GroupSpecifier opt Disjunction ) Parse Node の数を返す。
22.2.1.3 Static Semantics: CountLeftCapturingParensBefore ( node )
The
この節は
It performs the following steps when called:
Assert : node はRegExp Pattern文法 内の生成式のインスタンスである。- pattern を node を含む
Pattern とする。 - pattern 内に含まれ、node より前に出現するか、または node を含む
Atom :: ( GroupSpecifier opt Disjunction ) Parse Node の数を返す。
22.2.1.4 Static Semantics: MightBothParticipate ( x, y )
The
Assert : x と y は同じ囲みPattern を持つ。- 囲んでいる
Pattern がDisjunction :: Alternative | Disjunction Parse Node を含み、x がAlternative 内に含まれ y が派生したDisjunction 内に含まれるか、または x が派生したDisjunction 内に含まれ y がAlternative 内に含まれる場合、false を返す。 true を返す。
22.2.1.5 Static Semantics: CapturingGroupNumber
The
この節は
It is defined piecewise over the following productions:
NonZeroDigit のMVを返す。
- n を
DecimalDigits 内のコードポイント数とする。 - （
NonZeroDigit のMV × 10n にDecimalDigits のMVを加えたもの）を返す。
「
22.2.1.6 Static Semantics: IsCharacterClass
The
この節は
It is defined piecewise over the following productions:
false を返す。
true を返す。
22.2.1.7 Static Semantics: CharacterValue
The
この節は
It is defined piecewise over the following productions:
- U+002D（HYPHEN-MINUS）の数値を返す。
- ch を
SourceCharacter に一致したコードポイントとする。 - ch の数値を返す。
- U+0008（BACKSPACE）の数値を返す。
- U+002D（HYPHEN-MINUS）の数値を返す。
Table 62 に従う数値を返す。
| ControlEscape | 数値 | コードポイント | Unicode名 | 記号 |
|---|---|---|---|---|
t
|
9 |
U+0009
|
CHARACTER TABULATION | <HT> |
n
|
10 |
U+000A
|
LINE FEED (LF) | <LF> |
v
|
11 |
U+000B
|
LINE TABULATION | <VT> |
f
|
12 |
U+000C
|
FORM FEED (FF) | <FF> |
r
|
13 |
U+000D
|
CARRIAGE RETURN (CR) | <CR> |
- ch を
AsciiLetter に一致したコードポイントとする。 - i を ch の数値とする。
- i を32で割った余りを返す。
- U+0000（NULL）の数値を返す。
\0 は <NUL> 文字を表し、10進数字を後続させることはできません。
HexEscapeSequence のMVを返す。
- lead を
HexLeadSurrogate のCharacterValue とする。 - trail を
HexTrailSurrogate のCharacterValue とする。 - cp を
UTF16SurrogatePairToCodePoint (lead, trail) とする。 - cp の数値を返す。
Hex4Digits のMVを返す。
CodePoint のMVを返す。
Hex4Digits のMVを返す。
- ch を
IdentityEscape に一致したコードポイントとする。 - ch の数値を返す。
- ch を
SourceCharacter に一致したコードポイントとする。 - ch の数値を返す。
- ch を
ClassSetReservedPunctuator に一致したコードポイントとする。 - ch の数値を返す。
- U+0008（BACKSPACE）の数値を返す。
22.2.1.8 Static Semantics: MayContainStrings
The
false を返す。
LoneUnicodePropertyNameOrValue に一致したソーステキストがTable 66 の「Property name 」列に列挙されている文字列の二値プロパティである場合、true を返す。false を返す。
ClassUnion が存在する場合、ClassUnion のMayContainStrings を返す。false を返す。
ClassSetOperand のMayContainStrings がtrue である場合、true を返す。ClassUnion が存在する場合、ClassUnion のMayContainStrings を返す。false を返す。
- 最初の
ClassSetOperand のMayContainStrings がfalse である場合、false を返す。 - 2番目の
ClassSetOperand のMayContainStrings がfalse である場合、false を返す。 true を返す。
ClassIntersection のMayContainStrings がfalse である場合、false を返す。ClassSetOperand のMayContainStrings がfalse である場合、false を返す。true を返す。
- 最初の
ClassSetOperand のMayContainStrings を返す。
ClassString のMayContainStrings がtrue である場合、true を返す。ClassStringDisjunctionContents のMayContainStrings を返す。
true を返す。
NonEmptyClassString が存在する場合、true を返す。false を返す。
22.2.1.9 Static Semantics: GroupSpecifiersThatMatch ( thisGroupName )
The
- name を thisGroupName の
CapturingGroupName とする。 - pattern を thisGroupName を含む
Pattern とする。 - result を新しい空の
List とする。 - pattern が含む各
GroupSpecifier gs について、次を行う：- gs の
CapturingGroupName が name である場合、次を行う：- gs を result に追加する。
- gs の
- result を返す。
22.2.1.10 Static Semantics: CapturingGroupName
The
- idTextUnescaped を
RegExpIdentifierName のRegExpIdentifierCodePoints とする。 CodePointsToString (idTextUnescaped) を返す。
22.2.1.11 Static Semantics: RegExpIdentifierCodePoints
The
- cp を
RegExpIdentifierStart のRegExpIdentifierCodePoint とする。 - « cp » を返す。
- cps を派生した
RegExpIdentifierName のRegExpIdentifierCodePoints とする。 - cp を
RegExpIdentifierPart のRegExpIdentifierCodePoint とする。 - cps と « cp » のリスト連結を返す。
22.2.1.12 Static Semantics: RegExpIdentifierCodePoint
The
IdentifierStartChar に一致したコードポイントを返す。
IdentifierPartChar に一致したコードポイントを返す。
- 数値が
RegExpUnicodeEscapeSequence のCharacterValue であるコードポイントを返す。
- lead を、数値が
UnicodeLeadSurrogate に一致したコードポイントの数値であるコード単位とする。 - trail を、数値が
UnicodeTrailSurrogate に一致したコードポイントの数値であるコード単位とする。 UTF16SurrogatePairToCodePoint (lead, trail) を返す。
22.2.2 パターン意味論
正規表現パターンは、以下で説明されるプロセスを用いて
u も v も含まない場合、BMPパターンです。それ以外の場合はUnicodeパターンです。BMPパターンは、Basic Multilingual Planeの範囲内のUnicodeコードポイントである16ビット値の列から成るものとして解釈されるStringに対してマッチします。Unicodeパターンは、UTF-16を用いて符号化されたUnicodeコードポイントから成るものとして解釈されるStringに対してマッチします。BMPパターンの動作を説明する文脈では、“character”は単一の16ビットUnicode BMPコードポイントを意味します。Unicodeパターンの動作を説明する文脈では、“character”はUTF-16符号化コードポイント（
例えば、単一の非BMP文字 U+1D11E（MUSICAL SYMBOL G CLEF）としてソーステキスト内に表現されたパターンを考えます。Unicodeパターンとして解釈される場合、それは単一のコードポイント U+1D11E から成る単一要素（character）の
パターンはECMAScript String値としてRegExpコンストラクターに渡され、その中では非BMP文字はUTF-16で符号化されています。例えば、String値として表現された単一文字MUSICAL SYMBOL G CLEFパターンは、要素がコード単位 0xD834 および 0xDD1E である長さ2のStringです。したがって、2つのパターン文字から成るBMPパターンとして処理するためには、その文字列をさらに変換する必要はありません。しかし、Unicodeパターンとして処理するには、唯一の要素が単一のパターン文字、すなわちコードポイント U+1D11E である
実装は実際にこのようなUTF-16への、またはUTF-16からの変換を行わない場合がありますが、この仕様の意味論は、パターンマッチングの結果がそのような変換が行われたかのようであることを要求します。
22.2.2.1 表記
以下の説明では、次の内部データ構造を使用します：
-
CharSetElement は、次の2つの実体のいずれかです：
-
regexpRecord.[[UnicodeSets]] が
false の場合、CharSetElementは上記のパターン意味論における意味でのcharacterです。 -
regexpRecord.[[UnicodeSets]] が
true の場合、CharSetElementは、上記のパターン意味論における意味でのcharacterを要素とする列です。これには、空列、1つのcharacterから成る列、および複数のcharacterから成る列が含まれます。便宜上、この種類のCharSetElementを扱う際、個々のcharacterは1つのcharacterから成る列と相互に置き換えて扱われます。
-
regexpRecord.[[UnicodeSets]] が
- CharSet は、CharSetElementの数学的集合です。
-
CaptureRange は、キャプチャに含まれるcharacterの範囲を表す
Record { [[StartIndex]], [[EndIndex]] } です。ここで、[[StartIndex]]は input 内の範囲の開始インデックス（包含）を表す整数であり、[[EndIndex]]は input 内の範囲の終了インデックス（排他）を表す整数です。任意のCaptureRange について、これらのインデックスは [[StartIndex]] ≤ [[EndIndex]] という不変条件を満たさなければなりません。 -
MatchState は
Record { [[Input]], [[EndIndex]], [[Captures]] } であり、[[Input]]はマッチ対象のStringを表すcharacterのList 、[[EndIndex]]は整数、[[Captures]]はパターン内の各左キャプチャ括弧 に1つずつ対応する値のList です。MatchState は、正規表現マッチングアルゴリズムにおける部分的なマッチ状態を表すために使用されます。[[EndIndex]]は、パターンによってこれまでにマッチされた最後の入力characterのインデックスに1を加えたものです。一方、[[Captures]]はキャプチャ括弧の結果を保持します。[[Captures]]の n番目 の要素は、n番目 のキャプチャ括弧集合によってキャプチャされたcharacterの範囲を表すCaptureRange 、または n番目 のキャプチャ括弧集合にまだ到達していない場合はundefined です。バックトラッキングにより、マッチング処理中の任意の時点で多数のMatchState が使用される場合があります。 -
MatcherContinuation は、1つの
MatchState 引数を取り、MatchState またはfailure のいずれかを返すAbstract Closure です。MatcherContinuation は、MatchState 引数によって与えられた中間状態から開始して、パターンの残りの部分（クロージャーの捕捉値によって指定される）を input に対してマッチさせようとします。マッチに成功した場合、MatcherContinuation は到達した最終的なMatchState を返します。マッチに失敗した場合、MatcherContinuation はfailure を返します。 -
Matcher は、
MatchState とMatcherContinuation という2つの引数を取り、MatchState またはfailure のいずれかを返すAbstract Closure です。Matcher は、パターンの中間部分パターン（クロージャーの捕捉値によって指定される）を、MatchState 引数によって与えられた中間状態から開始して、MatchState の[[Input]]に対してマッチさせようとします。MatcherContinuation 引数は、パターンの残りをマッチさせるクロージャーであるべきです。パターンの部分パターンをマッチさせて新しいMatchState を得た後、Matcher はその新しいMatchState に対してMatcherContinuation を呼び出し、パターンの残りもマッチできるかどうかをテストします。可能であれば、Matcher はMatcherContinuation が返したMatchState を返します。不可能であれば、Matcher は選択点で異なる選択を試み、成功するかすべての可能性が尽きるまでMatcherContinuation を繰り返し呼び出す場合があります。
22.2.2.1.1 RegExp Record
RegExp Record は、コンパイル中および場合によってはマッチング中に必要となるRegExpに関する情報を格納するために使用される
これは以下のフィールドを持ちます：
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[IgnoreCase]] | Boolean | RegExpのフラグに |
| [[Multiline]] | Boolean | RegExpのフラグに |
| [[DotAll]] | Boolean | RegExpのフラグに |
| [[Unicode]] | Boolean | RegExpのフラグに |
| [[UnicodeSets]] | Boolean | RegExpのフラグに |
| [[CapturingGroupsCount]] | 非負整数 | RegExpのパターン内の |
22.2.2.2 Runtime Semantics: CompilePattern
The
- m を、引数 regexpRecord および
forward でのDisjunction のCompileSubpattern とする。 - regexpRecord と m を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (input, index) を持つ新しい
Abstract Closure を返す：Assert : input はcharacterのList である。Assert : 0 ≤ index ≤ input 内の要素数。- c を、何も捕捉せず、呼び出されたときに次の手順を実行する、パラメーター (y) を持つ新しい
MatcherContinuation とする：Assert : y はMatchState である。- y を返す。
- cap を、1から regexpRecord.[[CapturingGroupsCount]] までで添字付けされた、regexpRecord.[[CapturingGroupsCount]] 個の
undefined 値から成るList とする。 - x を
MatchState { [[Input]]: input, [[EndIndex]]: index, [[Captures]]: cap } とする。 - m(x, c) を返す。
Patternは
22.2.2.3 Runtime Semantics: CompileSubpattern
The
この節は
It is defined piecewise over the following productions:
- m1 を、引数 regexpRecord および direction での
Alternative のCompileSubpattern とする。 - m2 を、引数 regexpRecord および direction での
Disjunction のCompileSubpattern とする。 MatchTwoAlternatives (m1, m2) を返す。
| 正規表現演算子は2つの選択肢を分離します。パターンはまず左の | によってスキップされたパターン部分内のキャプチャ括弧は、Stringではなく
/a|ab/.exec("abc")は
/((a)|(ab))((c)|(bc))/.exec("abc")は次の配列を返し、
["abc", "a", "a", undefined, "bc", undefined, "bc"]次の配列は返しません。
["abc", "ab", undefined, "ab", "c", "c", undefined]2つの選択肢が試される順序は、direction の値に依存しません。
EmptyMatcher () を返す。
- m1 を、引数 regexpRecord および direction での
Alternative のCompileSubpattern とする。 - m2 を、引数 regexpRecord および direction での
Term のCompileSubpattern とする。 MatchSequence (m1, m2, direction) を返す。
連続する
- 引数 regexpRecord での
Assertion のCompileAssertion を返す。
結果の
- 引数 regexpRecord および direction での
Atom のCompileAtom を返す。
- m を、引数 regexpRecord および direction での
Atom のCompileAtom とする。 - q を
Quantifier のCompileQuantifier とする。 Assert : q.[[Min]] ≤ q.[[Max]]。- parenIndex を
CountLeftCapturingParensBefore (Term ) とする。 - parenCount を
CountLeftCapturingParensWithin (Atom ) とする。 - m、q、parenIndex、および parenCount を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (x, c) を持つ新しい
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
- max = 0 の場合、continue(matchState) を返す。
- d を、m、min、max、greedy、matchState、continue、parenIndex、および parenCount を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (y) を持つ新しい
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) を返す。
- cap を matchState.[[Captures]] のコピーとする。
- parenIndex + 1 から parenIndex + parenCount までの包含区間内の各整数 k について、cap[k] を
undefined に設定する。 - input を matchState.[[Input]] とする。
- e を matchState.[[EndIndex]] とする。
- xr を
MatchState { [[Input]]: input, [[EndIndex]]: e, [[Captures]]: cap } とする。 - min ≠ 0 の場合、m(xr, d) を返す。
- greedy が
false の場合、次を行う：- z を continue(matchState) とする。
- z が
failure でない場合、z を返す。 - m(xr, d) を返す。
- z を m(xr, d) とする。
- z が
failure でない場合、z を返す。 - continue(matchState) を返す。
次を比較してください：
/a[a-z]{2,4}/.exec("abcdefghi")これは
/a[a-z]{2,4}?/.exec("abcdefghi")これは
また次も考えてください：
/(aa|aabaac|ba|b|c)*/.exec("aabaac")これは、上記の選択点の順序により、次の配列を返し、
["aaba", "ba"]次のいずれも返しません：
["aabaac", "aabaac"]
["aabaac", "c"]上記の選択点の順序は、2つの数（単項表記で表される）の最大公約数を計算する正規表現を書くために使用できます。次の例は10と15のgcdを計算します：
"aaaaaaaaaa,aaaaaaaaaaaaaaa".replace(/^(a+)\1*,\1+$/, "$1")これは単項表記でgcd
RepeatMatcherのステップ
/(z)((a+)?(b+)?(c))*/.exec("zaacbbbcac")これは次の配列を返し、
["zaacbbbcac", "z", "ac", "a", undefined, "c"]次の配列は返しません。
["zaacbbbcac", "z", "ac", "a", "bbb", "c"]なぜなら、最外側の * の各反復が、量化された
22.2.2.3.2 EmptyMatcher ( )
The
- 何も捕捉せず、呼び出されたときに次の手順を実行する、パラメーター (matchState, continue) を持つ新しい
Matcher を返す：Assert : matchState はMatchState である。Assert : continue はMatcherContinuation である。- continue(matchState) を返す。
22.2.2.3.3 MatchTwoAlternatives ( m1, m2 )
The
- m1 と m2 を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (matchState, continue) を持つ新しい
Matcher を返す：Assert : matchState はMatchState である。Assert : continue はMatcherContinuation である。- r を m1(matchState, continue) とする。
- r が
failure でない場合、r を返す。 - m2(matchState, continue) を返す。
22.2.2.3.4 MatchSequence ( m1, m2, direction )
The
- direction が
forward の場合、次を行う：- m1 と m2 を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (matchState, continue) を持つ新しい
Matcher を返す：Assert : matchState はMatchState である。Assert : continue はMatcherContinuation である。- d を、continue と m2 を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (y) を持つ新しい
MatcherContinuation とする：Assert : y はMatchState である。- m2(y, continue) を返す。
- m1(matchState, d) を返す。
- m1 と m2 を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (matchState, continue) を持つ新しい
Assert : direction はbackward である。- m1 と m2 を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (matchState, continue) を持つ新しい
Matcher を返す：Assert : matchState はMatchState である。Assert : continue はMatcherContinuation である。- d を、continue と m1 を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (y) を持つ新しい
MatcherContinuation とする：Assert : y はMatchState である。- m1(y, continue) を返す。
- m2(matchState, d) を返す。
22.2.2.4 Runtime Semantics: CompileAssertion
The
この節は
It is defined piecewise over the following productions:
- regexpRecord を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (matchState, continue) を持つ新しい
Matcher を返す：Assert : matchState はMatchState である。Assert : continue はMatcherContinuation である。- input を matchState.[[Input]] とする。
- e を matchState.[[EndIndex]] とする。
- e = 0 であるか、または regexpRecord.[[Multiline]] が
true でありcharacter input[e - 1] がLineTerminator によってマッチされる場合、次を行う：- continue(matchState) を返す。
failure を返す。
パターンで y フラグが使用されている場合でも、^ は常に input の先頭、または（regexpRecord.[[Multiline]] が
- regexpRecord を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (matchState, continue) を持つ新しい
Matcher を返す：Assert : matchState はMatchState である。Assert : continue はMatcherContinuation である。- input を matchState.[[Input]] とする。
- e を matchState.[[EndIndex]] とする。
- inputLength を input 内の要素数とする。
- e = inputLength であるか、または regexpRecord.[[Multiline]] が
true でありcharacter input[e] がLineTerminator によってマッチされる場合、次を行う：- continue(matchState) を返す。
failure を返す。
- regexpRecord を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (matchState, continue) を持つ新しい
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 を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (matchState, continue) を持つ新しい
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 を、引数 regexpRecord および
forward でのDisjunction のCompileSubpattern とする。 - m を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (matchState, continue) を持つ新しい
Matcher を返す：Assert : matchState はMatchState である。Assert : continue はMatcherContinuation である。- d を、何も捕捉せず、呼び出されたときに次の手順を実行する、パラメーター (y) を持つ新しい
MatcherContinuation とする：Assert : y はMatchState である。- y を返す。
- r を m(matchState, d) とする。
- r が
failure である場合、failure を返す。 Assert : r はMatchState である。- cap を r.[[Captures]] とする。
- input を matchState.[[Input]] とする。
- xe を matchState.[[EndIndex]] とする。
- z を
MatchState { [[Input]]: input, [[EndIndex]]: xe, [[Captures]]: cap } とする。 - continue(z) を返す。
形式 (?= ) はゼロ幅の肯定先読みを指定します。これが成功するためには、(?= 形式へのバックトラッキングはありません（この通常とは異なる挙動はPerlから継承されています）。これは、
例えば、
/(?=(a+))/.exec("baaabac")は最初の b の直後の空Stringにマッチし、そのため次の配列を返します：
["", "aaa"]先読みへのバックトラッキングが存在しないことを示すため、次を考えてください：
/(?=(a+))a*b\1/.exec("baaabac")この式は次を返し、
["aba", "a"]次は返しません：
["aaaba", "a"]- m を、引数 regexpRecord および
forward でのDisjunction のCompileSubpattern とする。 - m を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (matchState, continue) を持つ新しい
Matcher を返す：Assert : matchState はMatchState である。Assert : continue はMatcherContinuation である。- d を、何も捕捉せず、呼び出されたときに次の手順を実行する、パラメーター (y) を持つ新しい
MatcherContinuation とする：Assert : y はMatchState である。- y を返す。
- r を m(matchState, d) とする。
- r が
failure でない場合、failure を返す。 - continue(matchState) を返す。
形式 (?! ) はゼロ幅の否定先読みを指定します。これが成功するためには、
/(.*?)a(?!(a+)b\2c)\2(.*)/.exec("baaabaac")は、正の数 n 個の a、b、別の n 個の a（最初の \2 で指定される）、および c が直後に続かない a を探します。2番目の \2 は否定先読みの外側にあるため、
["baaabaac", "ba", undefined, "abaac"]- m を、引数 regexpRecord および
backward でのDisjunction のCompileSubpattern とする。 - m を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (matchState, continue) を持つ新しい
Matcher を返す：Assert : matchState はMatchState である。Assert : continue はMatcherContinuation である。- d を、何も捕捉せず、呼び出されたときに次の手順を実行する、パラメーター (y) を持つ新しい
MatcherContinuation とする：Assert : y はMatchState である。- y を返す。
- r を m(matchState, d) とする。
- r が
failure である場合、failure を返す。 Assert : r はMatchState である。- cap を r.[[Captures]] とする。
- input を matchState.[[Input]] とする。
- xe を matchState.[[EndIndex]] とする。
- z を
MatchState { [[Input]]: input, [[EndIndex]]: xe, [[Captures]]: cap } とする。 - continue(z) を返す。
- m を、引数 regexpRecord および
backward でのDisjunction のCompileSubpattern とする。 - m を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (matchState, continue) を持つ新しい
Matcher を返す：Assert : matchState はMatchState である。Assert : continue はMatcherContinuation である。- d を、何も捕捉せず、呼び出されたときに次の手順を実行する、パラメーター (y) を持つ新しい
MatcherContinuation とする：Assert : y はMatchState である。- y を返す。
- r を m(matchState, d) とする。
- r が
failure でない場合、failure を返す。 - continue(matchState) を返す。
22.2.2.4.1 IsWordChar ( regexpRecord, input, e )
The
- inputLength を input 内の要素数とする。
- e = -1 または e = inputLength の場合、
false を返す。 - c をcharacter input[e] とする。
WordCharacters (regexpRecord) が c を含む場合、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 を最初の
DecimalDigits のMVとする。 - j を2番目の
DecimalDigits のMVとする。 Record { [[Min]]: i, [[Max]]: j } を返す。
22.2.2.7 Runtime Semantics: CompileAtom
The
この節は
It is defined piecewise over the following productions:
- ch を
PatternCharacter に一致したcharacterとする。 - charSet をcharacter ch を含む1要素の
CharSet とする。 CharacterSetMatcher (regexpRecord, charSet,false , direction) を返す。
- charSet を
AllCharacters (regexpRecord) とする。 - regexpRecord.[[DotAll]] が
true でない場合、次を行う：LineTerminator 生成式の右辺のコードポイントに対応するすべてのcharacterを charSet から除去する。
CharacterSetMatcher (regexpRecord, charSet,false , direction) を返す。
- cc を、引数 regexpRecord での
CharacterClass のCompileCharacterClass とする。 - cs を cc.[[CharSet]] とする。
- regexpRecord.[[UnicodeSets]] が
false であるか、または cs のすべてのCharSetElement が単一のcharacterから成る場合（cs が空の場合を含む）、CharacterSetMatcher (regexpRecord, cs, cc.[[Invert]], direction) を返す。 Assert : cc.[[Invert]] はfalse である。- lm を空の
Matcher のList とする。 - 複数のcharacterを含む cs 内の各
CharSetElement s について、長さの降順に反復して、次を行う：- cs2 を s の最後のコードポイントを含む1要素の
CharSet とする。 - m2 を
CharacterSetMatcher (regexpRecord, cs2,false , direction) とする。 - s 内の各コードポイント c1 について、その最後から2番目のコードポイントから後方に反復して、次を行う：
- cs1 を c1 を含む1要素の
CharSet とする。 - m1 を
CharacterSetMatcher (regexpRecord, cs1,false , direction) とする。 - m2 を
MatchSequence (m1, m2, direction) に設定する。
- cs1 を c1 を含む1要素の
- m2 を lm に追加する。
- cs2 を s の最後のコードポイントを含む1要素の
- singles を、単一のcharacterから成る cs のすべての
CharSetElement を含むCharSet とする。 CharacterSetMatcher (regexpRecord, singles,false , direction) を lm に追加する。- cs が空のcharacter列を含む場合、
EmptyMatcher () を lm に追加する。 - m2 を lm 内の最後の
Matcher とする。 - lm の各
Matcher m1 について、その最後から2番目の要素から後方に反復して、次を行う：- m2 を
MatchTwoAlternatives (m1, m2) に設定する。
- m2 を
- m2 を返す。
- m を、引数 regexpRecord および direction での
Disjunction のCompileSubpattern とする。 - parenIndex を
CountLeftCapturingParensBefore (Atom ) とする。 - direction、m、および parenIndex を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (x, c) を持つ新しい
Matcher を返す：Assert : x はMatchState である。Assert : c はMatcherContinuation である。- d を、x、c、direction、および parenIndex を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (y) を持つ新しい
MatcherContinuation とする：Assert : y はMatchState である。- cap を y.[[Captures]] のコピーとする。
- 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 } とする。
- cap[parenIndex + 1] を r に設定する。
- z を
MatchState { [[Input]]: input, [[EndIndex]]: ye, [[Captures]]: cap } とする。 - c(z) を返す。
- m(x, d) を返す。
( ) 形式の括弧は、\ の後に0でない10進数が続くもの）、置換String内の参照、または正規表現マッチング(?: ) 形式を使用します。
- addModifiers を
RegularExpressionModifiers に一致したソーステキストとする。 - removeModifiers を空のStringとする。
- modifiedRer を
UpdateModifiers (regexpRecord,CodePointsToString (addModifiers), removeModifiers) とする。 - 引数 modifiedRer および direction での
Disjunction のCompileSubpattern を返す。
- addModifiers を最初の
RegularExpressionModifiers に一致したソーステキストとする。 - removeModifiers を2番目の
RegularExpressionModifiers に一致したソーステキストとする。 - modifiedRer を
UpdateModifiers (regexpRecord,CodePointsToString (addModifiers),CodePointsToString (removeModifiers)) とする。 - 引数 modifiedRer および direction での
Disjunction のCompileSubpattern を返す。
- n を
DecimalEscape のCapturingGroupNumber とする。 Assert : n ≤ regexpRecord.[[CapturingGroupsCount]]。BackreferenceMatcher (regexpRecord, « n », direction) を返す。
\ の後に0でない10進数 n が続く形式のエスケープ列は、n番目 のキャプチャ括弧集合の結果（
- cv を
CharacterEscape のCharacterValue とする。 - ch をcharacter valueが cv であるcharacterとする。
- charSet をcharacter ch を含む1要素の
CharSet とする。 CharacterSetMatcher (regexpRecord, charSet,false , direction) を返す。
- cs を、引数 regexpRecord での
CharacterClassEscape のCompileToCharSet とする。 - regexpRecord.[[UnicodeSets]] が
false であるか、または cs のすべてのCharSetElement が単一のcharacterから成る場合（cs が空の場合を含む）、CharacterSetMatcher (regexpRecord, cs,false , direction) を返す。 - lm を空の
Matcher のList とする。 - 複数のcharacterを含む cs 内の各
CharSetElement s について、長さの降順に反復して、次を行う：- cs2 を s の最後のコードポイントを含む1要素の
CharSet とする。 - m2 を
CharacterSetMatcher (regexpRecord, cs2,false , direction) とする。 - s 内の各コードポイント c1 について、その最後から2番目のコードポイントから後方に反復して、次を行う：
- cs1 を c1 を含む1要素の
CharSet とする。 - m1 を
CharacterSetMatcher (regexpRecord, cs1,false , direction) とする。 - m2 を
MatchSequence (m1, m2, direction) に設定する。
- cs1 を c1 を含む1要素の
- m2 を lm に追加する。
- cs2 を s の最後のコードポイントを含む1要素の
- singles を、単一のcharacterから成る cs のすべての
CharSetElement を含むCharSet とする。 CharacterSetMatcher (regexpRecord, singles,false , direction) を lm に追加する。- cs が空のcharacter列を含む場合、
EmptyMatcher () を lm に追加する。 - m2 を lm 内の最後の
Matcher とする。 - lm の各
Matcher m1 について、その最後から2番目の要素から後方に反復して、次を行う：- m2 を
MatchTwoAlternatives (m1, m2) に設定する。
- m2 を
- m2 を返す。
- matchingGroupSpecifiers を
GroupSpecifiersThatMatch (GroupName ) とする。 - parenIndices を新しい空の
List とする。 - matchingGroupSpecifiers の各
GroupSpecifier groupSpecifier について、次を行う：- parenIndex を
CountLeftCapturingParensBefore (groupSpecifier) とする。 - parenIndex を parenIndices に追加する。
- parenIndex を
BackreferenceMatcher (regexpRecord, parenIndices, direction) を返す。
22.2.2.7.1 CharacterSetMatcher ( regexpRecord, charSet, invert, direction )
The
- regexpRecord.[[UnicodeSets]] が
true の場合、次を行う：Assert : invert はfalse である。Assert : charSet のすべてのCharSetElement は単一のcharacterから成る。
- regexpRecord、charSet、invert、および direction を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (x, c) を持つ新しい
Matcher を返す：Assert : x はMatchState である。Assert : c はMatcherContinuation である。- input を x.[[Input]] とする。
- endIndex を x.[[EndIndex]] とする。
- direction が
forward の場合、f を endIndex + 1 とする。 - それ以外の場合、f を endIndex - 1 とする。
- inputLength を input 内の要素数とする。
- f < 0 または f > inputLength の場合、
failure を返す。 - index を
min (endIndex, f) とする。 - ch をcharacter input[index] とする。
- cc を
Canonicalize (regexpRecord, ch) とする。 Canonicalize (regexpRecord, a) が cc であるような、ちょうど1つのcharacter a を含むCharSetElement が charSet 内に存在する場合、found をtrue とする。そうでない場合、found をfalse とする。- invert が
false かつ found がfalse の場合、failure を返す。 - invert が
true かつ found がtrue の場合、failure を返す。 - cap を x.[[Captures]] とする。
- y を
MatchState { [[Input]]: input, [[EndIndex]]: f, [[Captures]]: cap } とする。 - c(y) を返す。
22.2.2.7.2 BackreferenceMatcher ( regexpRecord, ns, direction )
The
- regexpRecord、ns、および direction を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (x, c) を持つ新しい
Matcher を返す：Assert : x はMatchState である。Assert : c はMatcherContinuation である。- input を x.[[Input]] とする。
- cap を x.[[Captures]] とする。
- r を
undefined とする。 - ns の各整数 n について、次を行う：
- cap[n] が
undefined でない場合、次を行う：Assert : r はundefined である。- r を cap[n] に設定する。
- cap[n] が
- r が
undefined である場合、c(x) を返す。 - endIndex を x.[[EndIndex]] とする。
- rs を r.[[StartIndex]] とする。
- re を r.[[EndIndex]] とする。
- len を re - rs とする。
- direction が
forward の場合、f を endIndex + len とする。 - それ以外の場合、f を endIndex - len とする。
- inputLength を input 内の要素数とする。
- f < 0 または f > inputLength の場合、
failure を返す。 - g を
min (endIndex, f) とする。 - 0（包含）から len（排他）までの区間内に、
Canonicalize (regexpRecord, input[rs + i]) がCanonicalize (regexpRecord, input[g + i]) でないような整数 i が存在する場合、failure を返す。 - y を
MatchState { [[Input]]: input, [[EndIndex]]: f, [[Captures]]: cap } とする。 - c(y) を返す。
22.2.2.7.3 Canonicalize ( regexpRecord, ch )
The
HasEitherUnicodeFlag (regexpRecord) がtrue かつ regexpRecord.[[IgnoreCase]] がtrue の場合、次を行う：- Unicode Character Databaseのファイル
CaseFolding.txtが ch に対するsimpleまたはcommon case foldingマッピングを提供する場合、そのマッピングを ch に適用した結果を返す。 - ch を返す。
- Unicode Character Databaseのファイル
- regexpRecord.[[IgnoreCase]] が
false の場合、ch を返す。 Assert : ch はUTF-16コード単位である。- cp を、数値が ch の数値であるコードポイントとする。
- u を、Unicode Default Case Conversionアルゴリズムに従う toUppercase(« cp ») とする。
- uStr を
CodePointsToString (u) とする。 - uStr の長さが 1 でない場合、ch を返す。
- cu を uStr の単一コード単位要素とする。
- ch の数値が 128 以上で、かつ cu の数値が 128 未満の場合、ch を返す。
- cu を返す。
ß（U+00DF LATIN SMALL LETTER SHARP S）を ss または SS へ写像しません。ただし、Basic Latinブロック外のコードポイントをその内部のコードポイントへ写像する場合があります。例えば、ſ（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されます。これらのコードポイントを含むStringは、/[a-z]/ui のような正規表現によってマッチされます。
Ω（U+2126 OHM SIGN）はtoUppercaseではそれ自身へ写像されますが、toCasefoldでは Ω（U+03A9 GREEK CAPITAL LETTER OMEGA）とともに ω（U+03C9 GREEK SMALL LETTER OMEGA）へ写像されます。そのため /[ω]/ui および /[\u03A9]/ui にはマッチしますが、/[ω]/i または /[\u03A9]/i にはマッチしません。また、Basic Latinブロック外のコードポイントはその内部のコードポイントへ写像されないため、/[a-z]/i にマッチしません。
22.2.2.7.4 UpdateModifiers ( regexpRecord, add, remove )
The
Assert : add と remove は共通の要素を持たない。- ignoreCase を regexpRecord.[[IgnoreCase]] とする。
- multiline を regexpRecord.[[Multiline]] とする。
- dotAll を regexpRecord.[[DotAll]] とする。
- unicode を regexpRecord.[[Unicode]] とする。
- unicodeSets を regexpRecord.[[UnicodeSets]] とする。
- capturingGroupsCount を regexpRecord.[[CapturingGroupsCount]] とする。
- remove が
"i" を含む場合、ignoreCase をfalse に設定する。 - そうでなく add が
"i" を含む場合、ignoreCase をtrue に設定する。 - remove が
"m" を含む場合、multiline をfalse に設定する。 - そうでなく add が
"m" を含む場合、multiline をtrue に設定する。 - remove が
"s" を含む場合、dotAll をfalse に設定する。 - そうでなく add が
"s" を含む場合、dotAll をtrue に設定する。 RegExp Record { [[IgnoreCase]]: ignoreCase, [[Multiline]]: multiline, [[DotAll]]: dotAll, [[Unicode]]: unicode, [[UnicodeSets]]: unicodeSets, [[CapturingGroupsCount]]: capturingGroupsCount } を返す。
22.2.2.8 Runtime Semantics: CompileCharacterClass
The
- charSet を、引数 regexpRecord での
ClassContents のCompileToCharSet とする。 Record { [[CharSet]]: charSet, [[Invert]]:false } を返す。
- charSet を、引数 regexpRecord での
ClassContents のCompileToCharSet とする。 - regexpRecord.[[UnicodeSets]] が
true の場合、次を行う：Record { [[CharSet]]:CharacterComplement (regexpRecord, charSet), [[Invert]]:false } を返す。
Record { [[CharSet]]: charSet, [[Invert]]:true } を返す。
22.2.2.9 Runtime Semantics: CompileToCharSet
The
この節は
It is defined piecewise over the following productions:
- 空の
CharSet を返す。
- charSet を、引数 regexpRecord での
ClassAtom のCompileToCharSet とする。 - otherSet を、引数 regexpRecord での
NonemptyClassRangesNoDash のCompileToCharSet とする。 CharSet charSet と otherSet の和集合を返す。
- charSet を、引数 regexpRecord での最初の
ClassAtom のCompileToCharSet とする。 - otherSet を、引数 regexpRecord での2番目の
ClassAtom のCompileToCharSet とする。 - remainingSet を、引数 regexpRecord での
ClassContents のCompileToCharSet とする。 - rangeSet を
CharacterRange (charSet, otherSet) とする。 - rangeSet と remainingSet の和集合を返す。
- charSet を、引数 regexpRecord での
ClassAtomNoDash のCompileToCharSet とする。 - otherSet を、引数 regexpRecord での
NonemptyClassRangesNoDash のCompileToCharSet とする。 CharSet charSet と otherSet の和集合を返す。
- charSet を、引数 regexpRecord での
ClassAtomNoDash のCompileToCharSet とする。 - otherSet を、引数 regexpRecord での
ClassAtom のCompileToCharSet とする。 - remainingSet を、引数 regexpRecord での
ClassContents のCompileToCharSet とする。 - rangeSet を
CharacterRange (charSet, otherSet) とする。 - rangeSet と remainingSet の和集合を返す。
パターンが大小文字を無視する場合でも、範囲の両端の大小文字は、どのcharacterがその範囲に属するかを決定する際に重要です。したがって、例えばパターン /[E-F]/i は文字 E、F、e、および f のみにマッチしますが、パターン /[E-f]/i はUnicode Basic Latinブロック内のすべての大文字および小文字に加え、記号 [, \, ], ^, _, および ` にもマッチします。
- characterはリテラルとして扱われることも、範囲を示すこともできます。
- 単一のcharacter
-U+002D（HYPHEN-MINUS）を含むCharSet を返す。
SourceCharacter に一致したcharacterを含むCharSet を返す。
- cv をこの
ClassEscape のCharacterValue とする。 - c をcharacter valueが cv であるcharacterとする。
- 単一のcharacter c を含む
CharSet を返す。
\b、\B、および後方参照を除き、正規表現の他の部分で許される任意のエスケープ列を使用できます。\b はバックスペースcharacterを意味し、\B および後方参照はエラーを発生させます。
- character
0、1、2、3、4、5、6、7、8、および9を含む10要素のCharSet を返す。
- charSet を
CharacterClassEscape :: d CharSet とする。 CharacterComplement (regexpRecord, charSet) を返す。
WhiteSpace またはLineTerminator 生成式の右辺のコードポイントに対応するすべてのcharacterを含むCharSet を返す。
- charSet を
CharacterClassEscape :: s CharSet とする。 CharacterComplement (regexpRecord, charSet) を返す。
MaybeSimpleCaseFolding (regexpRecord,WordCharacters (regexpRecord)) を返す。
- charSet を
CharacterClassEscape :: w CharSet とする。 CharacterComplement (regexpRecord, charSet) を返す。
- 引数 regexpRecord での
UnicodePropertyValueExpression のCompileToCharSet を返す。
- charSet を、引数 regexpRecord での
UnicodePropertyValueExpression のCompileToCharSet とする。 Assert : charSet は単一コードポイントのみを含む。CharacterComplement (regexpRecord, charSet) を返す。
- ps を
UnicodePropertyName に一致したソーステキストとする。 - p を
UnicodeMatchProperty (regexpRecord, ps) とする。 Assert : p はTable 64 の「Property name and aliases 」列に列挙されているUnicodeプロパティ名 またはプロパティ別名である。- vs を
UnicodePropertyValue に一致したソーステキストとする。 - v を
UnicodeMatchPropertyValue (p, vs) とする。 - charSet を、character database定義が値 v を持つプロパティ p を含む、すべてのUnicodeコードポイントを含む
CharSet とする。 MaybeSimpleCaseFolding (regexpRecord, charSet) を返す。
- s を
LoneUnicodePropertyNameOrValue に一致したソーステキストとする。 UnicodeMatchPropertyValue (General_Category, s) が、PropertyValueAliases.txtに列挙されているGeneral_Category（gc）プロパティのUnicodeプロパティ値またはプロパティ値別名である場合、次を行う：- character database定義が値 s を持つプロパティ“General_Category”を含む、すべてのUnicodeコードポイントを含む
CharSet を返す。
- character database定義が値 s を持つプロパティ“General_Category”を含む、すべてのUnicodeコードポイントを含む
- p を
UnicodeMatchProperty (regexpRecord, s) とする。 Assert : p は、Table 65 の「Property name and aliases 」列に列挙されている二値Unicodeプロパティまたは二値プロパティ別名、またはTable 66 の「Property name 」列に列挙されている文字列の二値Unicodeプロパティである。- charSet を、character database定義が値“True”を持つプロパティ p を含む、すべての
CharSetElement を含むCharSet とする。 MaybeSimpleCaseFolding (regexpRecord, charSet) を返す。
- charSet を、引数 regexpRecord での
ClassSetRange のCompileToCharSet とする。 ClassUnion が存在する場合、次を行う：- otherSet を、引数 regexpRecord での
ClassUnion のCompileToCharSet とする。 CharSet charSet と otherSet の和集合を返す。
- otherSet を、引数 regexpRecord での
- charSet を返す。
- charSet を、引数 regexpRecord での
ClassSetOperand のCompileToCharSet とする。 ClassUnion が存在する場合、次を行う：- otherSet を、引数 regexpRecord での
ClassUnion のCompileToCharSet とする。 CharSet charSet と otherSet の和集合を返す。
- otherSet を、引数 regexpRecord での
- charSet を返す。
- charSet を、引数 regexpRecord での最初の
ClassSetOperand のCompileToCharSet とする。 - otherSet を、引数 regexpRecord での2番目の
ClassSetOperand のCompileToCharSet とする。 CharSet charSet と otherSet の共通部分を返す。
- charSet を、引数 regexpRecord での
ClassIntersection のCompileToCharSet とする。 - otherSet を、引数 regexpRecord での
ClassSetOperand のCompileToCharSet とする。 CharSet charSet と otherSet の共通部分を返す。
- charSet を、引数 regexpRecord での最初の
ClassSetOperand のCompileToCharSet とする。 - otherSet を、引数 regexpRecord での2番目の
ClassSetOperand のCompileToCharSet とする。 - charSet の
CharSetElement のうち、otherSet のCharSetElement でもあるものを除いたCharSet を返す。
- charSet を、引数 regexpRecord での
ClassSubtraction のCompileToCharSet とする。 - otherSet を、引数 regexpRecord での
ClassSetOperand のCompileToCharSet とする。 - charSet の
CharSetElement のうち、otherSet のCharSetElement でもあるものを除いたCharSet を返す。
- charSet を、引数 regexpRecord での最初の
ClassSetCharacter のCompileToCharSet とする。 - otherSet を、引数 regexpRecord での2番目の
ClassSetCharacter のCompileToCharSet とする。 MaybeSimpleCaseFolding (regexpRecord,CharacterRange (charSet, otherSet)) を返す。
結果はしばしば2つ以上の範囲から成ります。UnicodeSetsが
- charSet を、引数 regexpRecord での
ClassSetCharacter のCompileToCharSet とする。 MaybeSimpleCaseFolding (regexpRecord, charSet) を返す。
- charSet を、引数 regexpRecord での
ClassStringDisjunction のCompileToCharSet とする。 MaybeSimpleCaseFolding (regexpRecord, charSet) を返す。
- 引数 regexpRecord での
NestedClass のCompileToCharSet を返す。
- 引数 regexpRecord での
ClassContents のCompileToCharSet を返す。
- charSet を、引数 regexpRecord での
ClassContents のCompileToCharSet とする。 CharacterComplement (regexpRecord, charSet) を返す。
- 引数 regexpRecord での
CharacterClassEscape のCompileToCharSet を返す。
- 引数 regexpRecord での
ClassStringDisjunctionContents のCompileToCharSet を返す。
- s を、引数 regexpRecord での
ClassString のCompileClassSetString とする。 - 1つの文字列 s を含む
CharSet を返す。
- s を、引数 regexpRecord での
ClassString のCompileClassSetString とする。 - charSet を1つの文字列 s を含む
CharSet とする。 - otherSet を、引数 regexpRecord での
ClassStringDisjunctionContents のCompileToCharSet とする。 CharSet charSet と otherSet の和集合を返す。
- cv をこの
ClassSetCharacter のCharacterValue とする。 - c をcharacter valueが cv であるcharacterとする。
- 単一のcharacter c を含む
CharSet を返す。
- 単一のcharacter U+0008（BACKSPACE）を含む
CharSet を返す。
22.2.2.9.1 CharacterRange ( charSet, otherSet )
The
22.2.2.9.2 HasEitherUnicodeFlag ( regexpRecord )
The
- regexpRecord.[[Unicode]] が
true または regexpRecord.[[UnicodeSets]] がtrue の場合、true を返す。 false を返す。
22.2.2.9.3 WordCharacters ( regexpRecord )
The \b、\B、\w、および \W の目的において「単語character」と見なされるcharacterを含む
- basicWordChars をASCII単語character内のすべてのcharacterを含む
CharSet とする。 - extraWordChars を、basicWordChars 内に含まれないが
Canonicalize (regexpRecord, c) が basicWordChars 内にあるような、すべてのcharacter c を含むCharSet とする。 Assert :HasEitherUnicodeFlag (regexpRecord) がtrue かつ regexpRecord.[[IgnoreCase]] がtrue でない限り、extraWordChars は空である。- basicWordChars と extraWordChars の和集合を返す。
22.2.2.9.4 AllCharacters ( regexpRecord )
The
- regexpRecord.[[UnicodeSets]] が
true かつ regexpRecord.[[IgnoreCase]] がtrue の場合、次を行う：- Simple Case Folding マッピングを持たない（すなわち
scf (c)=c である）すべてのUnicodeコードポイント c を含むCharSet を返す。
- Simple Case Folding マッピングを持たない（すなわち
HasEitherUnicodeFlag (regexpRecord) がtrue の場合、次を行う：- すべてのコードポイント値を含む
CharSet を返す。
- すべてのコードポイント値を含む
- すべてのコード単位値を含む
CharSet を返す。
22.2.2.9.5 MaybeSimpleCaseFolding ( regexpRecord, charSet )
The CaseFolding.txt にある Simple Case Folding（
- regexpRecord.[[UnicodeSets]] が
false または regexpRecord.[[IgnoreCase]] がfalse の場合、charSet を返す。 - otherSet を新しい空の
CharSet とする。 - charSet の各
CharSetElement s について、次を行う：- t を空のcharacter列とする。
- s 内の各単一コードポイント cp について、次を行う：
scf (cp) を t に追加する。
- t を otherSet に追加する。
- otherSet を返す。
22.2.2.9.6 CharacterComplement ( regexpRecord, complement )
The
- charSet を
AllCharacters (regexpRecord) とする。 - charSet の
CharSetElement のうち、complement のCharSetElement でもあるものを除いたCharSet を返す。
22.2.2.9.7 UnicodeMatchProperty ( regexpRecord, p )
The
- regexpRecord.[[UnicodeSets]] が
true であり、かつ p がTable 66 の「Property name 」列に列挙されているUnicodeプロパティ名 である場合、次を行う：- Unicodeコードポイントの
List p を返す。
- Unicodeコードポイントの
Assert : p はTable 64 またはTable 65 の「Property name and aliases 」列に列挙されているUnicodeプロパティ名 またはプロパティ別名である。- c を、対応する行の「
Canonical property name 」列に与えられている、p の正準プロパティ名 とする。 - Unicodeコードポイントの
List c を返す。
実装は、
例えば、Script_Extensions（scx（プロパティ別名）は有効ですが、script_extensions または Scx は有効ではありません。
列挙されたプロパティは、UTS18 RL1.2 が要求するものの上位集合を形成します。
これらの表内のエントリの綴り（大文字小文字を含む）は、Unicode Character Databaseのファイル PropertyAliases.txt で使用される綴りと一致します。そのファイル内の正確な綴りは安定であることが保証されています。
General_Category |
General_Category |
gc |
|
Script |
Script |
sc |
|
Script_Extensions |
Script_Extensions |
scx |
ASCII |
ASCII |
ASCII_Hex_Digit |
ASCII_Hex_Digit |
AHex |
|
Alphabetic |
Alphabetic |
Alpha |
|
Any |
Any |
Assigned |
Assigned |
Bidi_Control |
Bidi_Control |
Bidi_C |
|
Bidi_Mirrored |
Bidi_Mirrored |
Bidi_M |
|
Case_Ignorable |
Case_Ignorable |
CI |
|
Cased |
Cased |
Changes_When_Casefolded |
Changes_When_Casefolded |
CWCF |
|
Changes_When_Casemapped |
Changes_When_Casemapped |
CWCM |
|
Changes_When_Lowercased |
Changes_When_Lowercased |
CWL |
|
Changes_When_NFKC_Casefolded |
Changes_When_NFKC_Casefolded |
CWKCF |
|
Changes_When_Titlecased |
Changes_When_Titlecased |
CWT |
|
Changes_When_Uppercased |
Changes_When_Uppercased |
CWU |
|
Dash |
Dash |
Default_Ignorable_Code_Point |
Default_Ignorable_Code_Point |
DI |
|
Deprecated |
Deprecated |
Dep |
|
Diacritic |
Diacritic |
Dia |
|
Emoji |
Emoji |
Emoji_Component |
Emoji_Component |
EComp |
|
Emoji_Modifier |
Emoji_Modifier |
EMod |
|
Emoji_Modifier_Base |
Emoji_Modifier_Base |
EBase |
|
Emoji_Presentation |
Emoji_Presentation |
EPres |
|
Extended_Pictographic |
Extended_Pictographic |
ExtPict |
|
Extender |
Extender |
Ext |
|
Grapheme_Base |
Grapheme_Base |
Gr_Base |
|
Grapheme_Extend |
Grapheme_Extend |
Gr_Ext |
|
Hex_Digit |
Hex_Digit |
Hex |
|
IDS_Binary_Operator |
IDS_Binary_Operator |
IDSB |
|
IDS_Trinary_Operator |
IDS_Trinary_Operator |
IDST |
|
ID_Continue |
ID_Continue |
IDC |
|
ID_Start |
ID_Start |
IDS |
|
Ideographic |
Ideographic |
Ideo |
|
Join_Control |
Join_Control |
Join_C |
|
Logical_Order_Exception |
Logical_Order_Exception |
LOE |
|
Lowercase |
Lowercase |
Lower |
|
Math |
Math |
Noncharacter_Code_Point |
Noncharacter_Code_Point |
NChar |
|
Pattern_Syntax |
Pattern_Syntax |
Pat_Syn |
|
Pattern_White_Space |
Pattern_White_Space |
Pat_WS |
|
Quotation_Mark |
Quotation_Mark |
QMark |
|
Radical |
Radical |
Regional_Indicator |
Regional_Indicator |
RI |
|
Sentence_Terminal |
Sentence_Terminal |
STerm |
|
Soft_Dotted |
Soft_Dotted |
SD |
|
Terminal_Punctuation |
Terminal_Punctuation |
Term |
|
Unified_Ideograph |
Unified_Ideograph |
UIdeo |
|
Uppercase |
Uppercase |
Upper |
|
Variation_Selector |
Variation_Selector |
VS |
|
White_Space |
White_Space |
space |
|
XID_Continue |
XID_Continue |
XIDC |
|
XID_Start |
XID_Start |
XIDS |
Basic_Emoji |
Emoji_Keycap_Sequence |
RGI_Emoji_Modifier_Sequence |
RGI_Emoji_Flag_Sequence |
RGI_Emoji_Tag_Sequence |
RGI_Emoji_ZWJ_Sequence |
RGI_Emoji |
22.2.2.9.8 UnicodeMatchPropertyValue ( p, v )
The
Assert : p はTable 64 の「Canonical property name 」列に列挙されている正準で別名でないUnicodeプロパティ名 である。Assert : v はPropertyValueAliases.txtに列挙されているUnicodeプロパティ p のプロパティ値またはプロパティ値別名である。- value を、対応する行の「Canonical property value」列に与えられている v の正準プロパティ値とする。
- Unicodeコードポイントの
List value を返す。
実装は、PropertyValueAliases.txt に列挙されているUnicodeプロパティ値およびプロパティ値別名をサポートしなければなりません。相互運用性を確保するため、実装は他のプロパティ値またはプロパティ値別名をサポートしてはなりません。
例えば、Xpeo および Old_Persian は有効な Script_Extensions 値ですが、xpeo および Old Persian は有効ではありません。
このアルゴリズムは、UAX44に列挙されているシンボリック値のマッチング規則とは異なります。大文字小文字、Is 接頭辞はサポートされません。
22.2.2.10 Runtime Semantics: CompileClassSetString
The
- 空のcharacter列を返す。
- 引数 regexpRecord での
NonEmptyClassString のCompileClassSetString を返す。
- cs を、引数 regexpRecord での
ClassSetCharacter のCompileToCharSet とする。 - s1 を、cs の単一の
CharSetElement であるcharacter列とする。 NonEmptyClassString が存在する場合、次を行う：- s2 を、引数 regexpRecord での
NonEmptyClassString のCompileClassSetString とする。 - s1 と s2 の連結を返す。
- s2 を、引数 regexpRecord での
- s1 を返す。
22.2.3 RegExp作成のための抽象操作
22.2.3.1 RegExpCreate ( pattern, flags )
The
- obj を !
RegExpAlloc (%RegExp% ) とする。 - ?
RegExpInitialize (obj, pattern, flags) を返す。
22.2.3.2 RegExpAlloc ( newTarget )
The
- 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
- pattern が
undefined の場合、pattern を空のStringに設定する。 - そうでない場合、pattern を ?
ToString (pattern) に設定する。 - flags が
undefined の場合、flags を空のStringに設定する。 - そうでない場合、flags を ?
ToString (flags) に設定する。 - flags が
"d" 、"g" 、"i" 、"m" 、"s" 、"u" 、"v" 、または"y" 以外のコード単位を含む場合、SyntaxError 例外をスローする。 - flags が同じコード単位を複数回含む場合、
SyntaxError 例外をスローする。 - flags が
"i" を含む場合、i をtrue とする。そうでない場合、i をfalse とする。 - flags が
"m" を含む場合、m をtrue とする。そうでない場合、m をfalse とする。 - flags が
"s" を含む場合、s をtrue とする。そうでない場合、s をfalse とする。 - flags が
"u" を含む場合、u をtrue とする。そうでない場合、u をfalse とする。 - flags が
"v" を含む場合、v をtrue とする。そうでない場合、v をfalse とする。 - u が
true または v がtrue の場合、次を行う：- patternText を
StringToCodePoints (pattern) とする。
- patternText を
- それ以外の場合、
- patternText を、pattern の各16ビット要素をUnicode BMPコードポイントとして解釈した結果とする。要素にはUTF-16復号は適用されない。
- parseResult を
ParsePattern (patternText, u, v) とする。 - parseResult が
SyntaxError オブジェクトの空でないList である場合、SyntaxError 例外をスローする。 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]] を、引数 regexpRecord での parseResult の
CompilePattern に設定する。 - ?
Set (obj,"lastIndex" ,+0 𝔽,true ) を実行する。 - obj を返す。
22.2.3.4 Static Semantics: ParsePattern ( patternText, u, v )
The
この節は
It performs the following steps when called:
- v が
true かつ u がtrue の場合、次を行う：- parseResult を1つ以上の
SyntaxError オブジェクトを含むList とする。
- parseResult を1つ以上の
- そうでなく v が
true の場合、次を行う： - そうでなく u が
true の場合、次を行う： - それ以外の場合、
- parseResult を返す。
22.2.4 RegExpコンストラクター
RegExpコンストラクターは以下の通りです：
- %RegExp%である。
グローバルオブジェクト の"RegExp" プロパティの初期値である。- コンストラクターとして呼び出されたとき、新しいRegExpオブジェクトを作成して初期化する。
- コンストラクターとしてではなく関数として呼び出されたとき、新しいRegExpオブジェクト、または唯一の引数がRegExpオブジェクトである場合はその引数自体のいずれかを返す。
- クラス定義の
extends節の値として使用できる。指定されたRegExpの動作を継承することを意図するサブクラスコンストラクターは、必要な内部スロットを持つサブクラスインスタンスを作成して初期化するために、RegExpコンストラクターへのsuper呼び出しを含めなければならない。
22.2.4.1 RegExp ( patternOrRegexp, flags )
この関数は呼び出されたとき、次の手順を実行します：
- patternIsRegExp を ?
IsRegExp (patternOrRegexp) とする。 - NewTarget が
undefined の場合、次を行う： - それ以外の場合、
- newTarget を NewTarget とする。
- patternOrRegexp がObjectであり、かつ patternOrRegexp が [[RegExpMatcher]] 内部スロットを持つ場合、次を行う：
- patternSource を patternOrRegexp.[[OriginalSource]] とする。
- flags が
undefined の場合、flags を patternOrRegexp.[[OriginalFlags]] に設定する。
- そうでなく patternIsRegExp が
true の場合、次を行う： - それ以外の場合、
- patternSource を patternOrRegexp とする。
- obj を ?
RegExpAlloc (newTarget) とする。 - ?
RegExpInitialize (obj, patternSource, flags) を返す。
patternが
22.2.5 RegExpコンストラクターのプロパティ
RegExpコンストラクターは以下の通りです：
- [[Prototype]]内部スロットを持ち、その値は
%Function.prototype% である。 - 以下のプロパティを持つ：
22.2.5.1 RegExp.escape ( str )
この関数は、正規表現
呼び出されたとき、次の手順を実行します：
- str がStringでない場合、
TypeError 例外をスローする。 - escaped を空のStringとする。
- cpList を
StringToCodePoints (str) とする。 - cpList の各コードポイント cp について、次を行う：
- escaped が空のStringであり、かつ cp が
DecimalDigit またはAsciiLetter のいずれかに一致する場合、次を行う：NOTE : 先頭の数字をエスケープすると、出力が\0characterエスケープまたは\1のようなDecimalEscape の後に使用され得るパターンテキストに対応し、それでも先行するエスケープ列の拡張として解釈されるのではなく str にマッチすることが保証される。先頭のASCII文字をエスケープすることは、\cの後の文脈について同じことを行う。- numericValue を cp の数値とする。
- hex を
Number::toString (𝔽 (numericValue), 16) とする。 Assert : hex の長さは2である。- escaped を、コード単位0x005C（REVERSE SOLIDUS）、
"x" 、および hex の文字列連結に設定する。
- それ以外の場合、
- escaped を escaped と
EncodeForRegExpEscape (cp) の文字列連結に設定する。
- escaped を escaped と
- escaped が空のStringであり、かつ cp が
- escaped を返す。
名前は似ていますが、RegExp.escapeは同様の動作を行いません。前者は文字列として表現するためにパターンをエスケープし、この関数はパターン内で表現するために文字列をエスケープします。
22.2.5.1.1 EncodeForRegExpEscape ( cp )
The
- cp が
SyntaxCharacter に一致するか、または cp が U+002F（SOLIDUS）である場合、次を行う：- 0x005C（REVERSE SOLIDUS）と
UTF16EncodeCodePoint (cp) の文字列連結を返す。
- 0x005C（REVERSE SOLIDUS）と
- cp が
Table 62 の「Code Point」列に列挙されているコードポイントである場合、次を行う：- 0x005C（REVERSE SOLIDUS）と、cp を含む「Code Point」列の行の「ControlEscape」列内の文字列の文字列連結を返す。
- otherPunctuators を
",-=<>#&!%:;@~'`" とコード単位0x0022（QUOTATION MARK）の文字列連結とする。 - toEscape を
StringToCodePoints (otherPunctuators) とする。 - toEscape が cp を含むか、cp が
WhiteSpace またはLineTerminator のいずれかに一致するか、または cp が先行サロゲートまたは後続サロゲートと同じ数値を持つ場合、次を行う：- cpNum を cp の数値とする。
- cpNum ≤ 0xFF の場合、次を行う：
- hex を
Number::toString (𝔽 (cpNum), 16) とする。 - コード単位0x005C（REVERSE SOLIDUS）、
"x" 、およびStringPad (hex, 2,"0" ,start ) の文字列連結を返す。
- hex を
- escaped を空のStringとする。
- codeUnits を
UTF16EncodeCodePoint (cp) とする。 - codeUnits の各コード単位 cu について、次を行う：
- escaped を escaped と
UnicodeEscape (cu) の文字列連結に設定する。
- escaped を escaped と
- escaped を返す。
UTF16EncodeCodePoint (cp) を返す。
22.2.5.2 RegExp.prototype
RegExp.prototypeの初期値は
このプロパティの属性は { [[Writable]]:
22.2.5.3 get RegExp [ %Symbol.species% ]
RegExp[%Symbol.species%]は、setアクセサー関数が
this 値を返す。
この関数の
RegExpプロトタイプメソッドは通常、その
22.2.6 RegExpプロトタイプオブジェクトのプロパティ
RegExpプロトタイプオブジェクトは以下の通りです：
- %RegExp.prototype%である。
- 通常のオブジェクトである。
- RegExpインスタンスではなく、[[RegExpMatcher]]内部スロットまたはRegExpインスタンスオブジェクトの他の内部スロットを持たない。
- [[Prototype]]内部スロットを持ち、その値は
%Object.prototype% である。
RegExpプロトタイプオブジェクトは独自の
22.2.6.1 RegExp.prototype.constructor
RegExp.prototype.constructorの初期値は
22.2.6.2 RegExp.prototype.exec ( string )
このメソッドは string から正規表現パターンの出現を検索し、マッチ結果を含むArrayを返します。または string がマッチしなかった場合は
呼び出されたとき、次の手順を実行します：
- regexp を
this 値とする。 - ?
RequireInternalSlot (regexp, [[RegExpMatcher]]) を実行する。 - str を ?
ToString (string) とする。 - ?
RegExpBuiltinExec (regexp, str) を返す。
22.2.6.3 get RegExp.prototype.dotAll
RegExp.prototype.dotAllは、setアクセサー関数が
- regexp を
this 値とする。 - cu をコード単位0x0073（LATIN SMALL LETTER S）とする。
- ?
RegExpHasFlag (regexp, cu) を返す。
22.2.6.4 get RegExp.prototype.flags
RegExp.prototype.flagsは、setアクセサー関数が
- regexp を
this 値とする。 - regexp がObjectでない場合、
TypeError 例外をスローする。 - codeUnits を新しい空の
List とする。 - hasIndices を
ToBoolean (?Get (regexp,"hasIndices" )) とする。 - hasIndices が
true の場合、コード単位0x0064（LATIN SMALL LETTER D）を codeUnits に追加する。 - global を
ToBoolean (?Get (regexp,"global" )) とする。 - global が
true の場合、コード単位0x0067（LATIN SMALL LETTER G）を codeUnits に追加する。 - ignoreCase を
ToBoolean (?Get (regexp,"ignoreCase" )) とする。 - ignoreCase が
true の場合、コード単位0x0069（LATIN SMALL LETTER I）を codeUnits に追加する。 - multiline を
ToBoolean (?Get (regexp,"multiline" )) とする。 - multiline が
true の場合、コード単位0x006D（LATIN SMALL LETTER M）を codeUnits に追加する。 - dotAll を
ToBoolean (?Get (regexp,"dotAll" )) とする。 - dotAll が
true の場合、コード単位0x0073（LATIN SMALL LETTER S）を codeUnits に追加する。 - unicode を
ToBoolean (?Get (regexp,"unicode" )) とする。 - unicode が
true の場合、コード単位0x0075（LATIN SMALL LETTER U）を codeUnits に追加する。 - unicodeSets を
ToBoolean (?Get (regexp,"unicodeSets" )) とする。 - unicodeSets が
true の場合、コード単位0x0076（LATIN SMALL LETTER V）を codeUnits に追加する。 - sticky を
ToBoolean (?Get (regexp,"sticky" )) とする。 - sticky が
true の場合、コード単位0x0079（LATIN SMALL LETTER Y）を codeUnits に追加する。 List codeUnits の要素をコード単位とするString値を返す。codeUnits が要素を持たない場合、空のStringが返される。
22.2.6.4.1 RegExpHasFlag ( regexp, codeUnit )
The
- regexp がObjectでない場合、
TypeError 例外をスローする。 - regexp が [[OriginalFlags]] 内部スロットを持たない場合、次を行う：
SameValue (regexp,%RegExp.prototype% ) がtrue の場合、undefined を返す。TypeError 例外をスローする。
- flags を regexp.[[OriginalFlags]] とする。
- flags が codeUnit を含む場合、
true を返す。 false を返す。
22.2.6.5 get RegExp.prototype.global
RegExp.prototype.globalは、setアクセサー関数が
- regexp を
this 値とする。 - cu をコード単位0x0067（LATIN SMALL LETTER G）とする。
- ?
RegExpHasFlag (regexp, cu) を返す。
22.2.6.6 get RegExp.prototype.hasIndices
RegExp.prototype.hasIndicesは、setアクセサー関数が
- regexp を
this 値とする。 - cu をコード単位0x0064（LATIN SMALL LETTER D）とする。
- ?
RegExpHasFlag (regexp, cu) を返す。
22.2.6.7 get RegExp.prototype.ignoreCase
RegExp.prototype.ignoreCaseは、setアクセサー関数が
- regexp を
this 値とする。 - cu をコード単位0x0069（LATIN SMALL LETTER I）とする。
- ?
RegExpHasFlag (regexp, cu) を返す。
22.2.6.8 RegExp.prototype [ %Symbol.match% ] ( string )
このメソッドは呼び出されたとき、次の手順を実行します：
- regexp を
this 値とする。 - regexp がObjectでない場合、
TypeError 例外をスローする。 - str を ?
ToString (string) とする。 - flags を ?
ToString (?Get (regexp,"flags" )) とする。 - flags が
"g" を含まない場合、?RegExpExec (regexp, str) を返す。 - flags が
"u" を含むか、または flags が"v" を含む場合、fullUnicode をtrue とする。そうでない場合、fullUnicode をfalse とする。 - ?
Set (regexp,"lastIndex" ,+0 𝔽,true ) を実行する。 - array を !
ArrayCreate (0) とする。 - matchCount を 0 とする。
- 繰り返す：
- result を ?
RegExpExec (regexp, str) とする。 - result が
null の場合、次を行う：- matchCount = 0 の場合、
null を返す。 - array を返す。
- matchCount = 0 の場合、
- matchStr を ?
ToString (?Get (result,"0" )) とする。 - !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (matchCount)), matchStr) を実行する。 - matchStr が空のStringである場合、次を行う：
- matchCount を matchCount + 1 に設定する。
- result を ?
このメソッドの
22.2.6.9 RegExp.prototype [ %Symbol.matchAll% ] ( string )
このメソッドは呼び出されたとき、次の手順を実行します：
- regexp を
this 値とする。 - regexp がObjectでない場合、
TypeError 例外をスローする。 - str を ?
ToString (string) とする。 - speciesConstructor を ?
SpeciesConstructor (regexp,%RegExp% ) とする。 - flags を ?
ToString (?Get (regexp,"flags" )) とする。 - matcher を ?
Construct (speciesConstructor, « 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, str, global, fullUnicode) を返す。
このメソッドの
22.2.6.10 get RegExp.prototype.multiline
RegExp.prototype.multilineは、setアクセサー関数が
- regexp を
this 値とする。 - cu をコード単位0x006D（LATIN SMALL LETTER M）とする。
- ?
RegExpHasFlag (regexp, cu) を返す。
22.2.6.11 RegExp.prototype [ %Symbol.replace% ] ( string, replaceValue )
このメソッドは呼び出されたとき、次の手順を実行します：
- regexp を
this 値とする。 - regexp がObjectでない場合、
TypeError 例外をスローする。 - str を ?
ToString (string) とする。 - lengthS を str の長さとする。
- 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, str) とする。 - result が
null の場合、次を行う：- done を
true に設定する。
- done を
- それ以外の場合、
- result を ?
- accumulatedResult を空のStringとする。
- nextSourcePosition を 0 とする。
- results の各要素 result について、次を行う：
- resultLength を ?
LengthOfArrayLike (result) とする。 - nCaptures を
max (resultLength - 1, 0) とする。 - matched を ?
ToString (?Get (result,"0" )) とする。 - matchLength を matched の長さとする。
- position を ?
ToIntegerOrInfinity (?Get (result,"index" )) とする。 - position を、0と lengthS の間にクランプした結果に設定する。
- captures を新しい空の
List とする。 - captureNumber を 1 とする。
- captureNumber ≤ nCaptures の間、繰り返す：
- capN を ?
Get (result, !ToString (𝔽 (captureNumber))) とする。 - capN が
undefined でない場合、次を行う：- capN を ?
ToString (capN) に設定する。
- capN を ?
- capN を captures に追加する。
NOTE : captureNumber = 1 の場合、直前のステップは最初の要素を captures（インデックス0）に入れる。より一般には、captureNumber番目 のキャプチャ（captureNumber番目 のキャプチャ括弧集合によってキャプチャされた文字）は captures[captureNumber - 1] にある。- captureNumber を captureNumber + 1 に設定する。
- capN を ?
- namedCaptures を ?
Get (result,"groups" ) とする。 - functionalReplace が
true の場合、次を行う： - それ以外の場合、
- namedCaptures が
undefined でない場合、次を行う：- namedCaptures を ?
ToObject (namedCaptures) に設定する。
- namedCaptures を ?
- replacementString を ?
GetSubstitution (matched, str, position, captures, namedCaptures, replaceValue) とする。
- namedCaptures が
- position ≥ nextSourcePosition の場合、次を行う：
NOTE : position は通常、後方へ移動すべきではない。もしそうなる場合、それはRegExpサブクラスの不適切な挙動、またはアクセストリガーの副作用を用いて regexp のglobalフラグまたは他の特性を変更したことを示している。そのような場合、対応する置換は無視される。- accumulatedResult を、accumulatedResult、str の nextSourcePosition から position までの部分文字列、および replacementString の文字列連結に設定する。
- nextSourcePosition を position + matchLength に設定する。
- resultLength を ?
- nextSourcePosition ≥ lengthS の場合、accumulatedResult を返す。
- accumulatedResult と str の nextSourcePosition からの部分文字列の文字列連結を返す。
このメソッドの
22.2.6.12 RegExp.prototype [ %Symbol.search% ] ( string )
このメソッドは呼び出されたとき、次の手順を実行します：
- regexp を
this 値とする。 - regexp がObjectでない場合、
TypeError 例外をスローする。 - str を ?
ToString (string) とする。 - previousLastIndex を ?
Get (regexp,"lastIndex" ) とする。 - previousLastIndex が
+0 𝔽 でない場合、次を行う：- ?
Set (regexp,"lastIndex" ,+0 𝔽,true ) を実行する。
- ?
- result を ?
RegExpExec (regexp, str) とする。 - currentLastIndex を ?
Get (regexp,"lastIndex" ) とする。 SameValue (currentLastIndex, previousLastIndex) がfalse の場合、次を行う：- ?
Set (regexp,"lastIndex" , previousLastIndex,true ) を実行する。
- ?
- result が
null の場合、-1 𝔽 を返す。 - ?
Get (result,"index" ) を返す。
このメソッドの
このRegExpオブジェクトの
22.2.6.13 get RegExp.prototype.source
RegExp.prototype.sourceは、setアクセサー関数が
- regexp を
this 値とする。 - regexp がObjectでない場合、
TypeError 例外をスローする。 - regexp が [[OriginalSource]] 内部スロットを持たない場合、次を行う：
SameValue (regexp,%RegExp.prototype% ) がtrue の場合、"(?:)" を返す。TypeError 例外をスローする。
Assert : regexp は [[OriginalFlags]] 内部スロットを持つ。- src を regexp.[[OriginalSource]] とする。
- flags を regexp.[[OriginalFlags]] とする。
EscapeRegExpPattern (src, flags) を返す。
22.2.6.13.1 EscapeRegExpPattern ( pattern, flags )
The
- flags が
"v" を含む場合、次を行う：- patternSymbol を
Pattern とする。[+UnicodeMode, +UnicodeSetsMode]
- patternSymbol を
- そうでなく flags が
"u" を含む場合、次を行う：- patternSymbol を
Pattern とする。[+UnicodeMode, ~UnicodeSetsMode]
- patternSymbol を
- それ以外の場合、
- patternSymbol を
Pattern とする。[~UnicodeMode, ~UnicodeSetsMode]
- patternSymbol を
- escapedPattern を、UTF-16符号化Unicodeコードポイント（
6.1.4 ）として解釈された pattern と等価な patternSymbol 形式のStringとし、その中で特定のコードポイントは以下で説明されるようにエスケープされているものとする。escapedPattern は pattern と異なっても異ならなくてもよい。ただし、escapedPattern を patternSymbol として評価することで生じるAbstract Closure は、構築されたオブジェクトの[[RegExpMatcher]]内部スロットによって与えられるAbstract Closure と同一に動作しなければならない。同じ pattern および flags の値を用いたこの抽象操作への複数回の呼び出しは、同一の結果を生成しなければならない。 - パターン内に出現するコードポイント
/または任意のLineTerminator は、"\"/ 、escapedPattern、"/" 、および flags の文字列連結が、（適切な字句文脈で）構築された正規表現と同一に動作するRegularExpressionLiteral として解析できることを保証するために、必要に応じて escapedPattern 内でエスケープされなければならない。例えば、pattern が"/" である場合、escapedPattern は"\/" または"\u002F" などであり得るが、"/" ではあり得ない。なぜなら、flags が後続する///はRegularExpressionLiteral ではなくSingleLineComment として解析されるためである。pattern が空のStringである場合、この仕様は escapedPattern を"(?:)" とすることで満たすことができる。 - escapedPattern を返す。
名前は似ていますが、RegExp.escapeとEscapeRegExpPatternは同様の動作を行いません。前者はパターン内で表現するために文字列をエスケープし、この関数は文字列として表現するためにパターンをエスケープします。
22.2.6.14 RegExp.prototype [ %Symbol.split% ] ( string, limit )
このメソッドは、string をStringに変換した結果の部分文字列を格納したArrayを返します。部分文字列は、
/a*?/[Symbol.split]("ab") は配列 ["a", "b"] に評価される一方、/a*/[Symbol.split]("ab") は配列 ["","b"] に評価されます。）
string が空のStringである（または空のStringに変換される）場合、結果は正規表現が空のStringにマッチできるかどうかに依存します。マッチできる場合、結果配列は要素を含みません。そうでない場合、結果配列は1つの要素を含み、それは空のStringです。
正規表現がキャプチャ括弧を含む場合、separator がマッチするたびに、キャプチャ括弧の結果（任意の
/<(\/)?([^<>]+)>/[Symbol.split]("A<B>bold</B>and<CODE>coded</CODE>")は次の配列に評価されます：
["A", undefined, "B", "bold", "/", "B", "and", undefined, "CODE", "coded", "/", "CODE", ""]limit が
このメソッドは呼び出されたとき、次の手順を実行します：
- regexp を
this 値とする。 - regexp がObjectでない場合、
TypeError 例外をスローする。 - str を ?
ToString (string) とする。 - speciesConstructor を ?
SpeciesConstructor (regexp,%RegExp% ) とする。 - flags を ?
ToString (?Get (regexp,"flags" )) とする。 - flags が
"u" を含むか、または flags が"v" を含む場合、unicodeMatching をtrue とする。 - それ以外の場合、unicodeMatching を
false とする。 - flags が
"y" を含む場合、newFlags を flags とする。 - それ以外の場合、newFlags を flags と
"y" の文字列連結とする。 - splitter を ?
Construct (speciesConstructor, « regexp, newFlags ») とする。 - array を !
ArrayCreate (0) とする。 - lengthA を 0 とする。
- limit が
undefined の場合、lim を 232 - 1 とする。そうでない場合、lim をℝ (?ToUint32 (limit)) とする。 - lim = 0 の場合、array を返す。
- str が空のStringである場合、次を行う：
- matchResult を ?
RegExpExec (splitter, str) とする。 - matchResult が
null でない場合、array を返す。 - !
CreateDataPropertyOrThrow (array,"0" , str) を実行する。 - array を返す。
- matchResult を ?
- size を str の長さとする。
- lastMatchEnd を 0 とする。
- searchIndex を lastMatchEnd とする。
- searchIndex < size の間、繰り返す：
- ?
Set (splitter,"lastIndex" ,𝔽 (searchIndex),true ) を実行する。 - matchResult を ?
RegExpExec (splitter, str) とする。 - matchResult が
null の場合、次を行う：- searchIndex を
AdvanceStringIndex (str, searchIndex, unicodeMatching) に設定する。
- searchIndex を
- それ以外の場合、
- matchEnd を
ℝ (?ToLength (?Get (splitter,"lastIndex" ))) とする。 - matchEnd を
min (matchEnd, size) に設定する。 - matchEnd = lastMatchEnd の場合、次を行う：
- searchIndex を
AdvanceStringIndex (str, searchIndex, unicodeMatching) に設定する。
- searchIndex を
- それ以外の場合、
- substring を str の lastMatchEnd から searchIndex までの部分文字列とする。
- !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (lengthA)), substring) を実行する。 - lengthA を lengthA + 1 に設定する。
- lengthA = lim の場合、array を返す。
- lastMatchEnd を matchEnd に設定する。
- numberOfCaptures を ?
LengthOfArrayLike (matchResult) とする。 - numberOfCaptures を
max (numberOfCaptures - 1, 0) に設定する。 - captureIndex を 1 とする。
- captureIndex ≤ numberOfCaptures の間、繰り返す：
- searchIndex を lastMatchEnd に設定する。
- matchEnd を
- ?
- substring を str の lastMatchEnd から size までの部分文字列とする。
- !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (lengthA)), substring) を実行する。 - array を返す。
このメソッドの
このメソッドは、このRegExpオブジェクトの
22.2.6.15 get RegExp.prototype.sticky
RegExp.prototype.stickyは、setアクセサー関数が
- regexp を
this 値とする。 - cu をコード単位0x0079（LATIN SMALL LETTER Y）とする。
- ?
RegExpHasFlag (regexp, cu) を返す。
22.2.6.16 RegExp.prototype.test ( str )
このメソッドは呼び出されたとき、次の手順を実行します：
- regexp を
this 値とする。 - regexp がObjectでない場合、
TypeError 例外をスローする。 - string を ?
ToString (str) とする。 - match を ?
RegExpExec (regexp, string) とする。 - match が
null の場合、false を返す。 true を返す。
22.2.6.17 RegExp.prototype.toString ( )
返されるStringは、このオブジェクトと同じ動作を持つ別のRegExpオブジェクトに評価される
22.2.6.18 get RegExp.prototype.unicode
RegExp.prototype.unicodeは、setアクセサー関数が
- regexp を
this 値とする。 - cu をコード単位0x0075（LATIN SMALL LETTER U）とする。
- ?
RegExpHasFlag (regexp, cu) を返す。
22.2.6.19 get RegExp.prototype.unicodeSets
RegExp.prototype.unicodeSetsは、setアクセサー関数が
- regexp を
this 値とする。 - cu をコード単位0x0076（LATIN SMALL LETTER V）とする。
- ?
RegExpHasFlag (regexp, cu) を返す。
22.2.7 RegExpマッチングのための抽象操作
22.2.7.1 RegExpExec ( regexp, str )
The
- exec を ?
Get (regexp,"exec" ) とする。 IsCallable (exec) がtrue の場合、次を行う：- result を ?
Call (exec, regexp, « str ») とする。 - result がObjectでなく、かつ result が
null でない場合、TypeError 例外をスローする。 - result を返す。
- result を ?
- ?
RequireInternalSlot (regexp, [[RegExpMatcher]]) を実行する。 - ?
RegExpBuiltinExec (regexp, str) を返す。
呼び出し可能な
22.2.7.2 RegExpBuiltinExec ( regexp, str )
The
- length を str の長さとする。
- 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 (str) とする。そうでない場合、input を、str の要素であるコード単位を要素とするList とする。 NOTE : input の各要素はcharacterと見なされる。- matchSucceeded が
false の間、繰り返す：- lastIndex > length の場合、次を行う：
- global が
true または sticky がtrue の場合、次を行う：- ?
Set (regexp,"lastIndex" ,+0 𝔽,true ) を実行する。
- ?
null を返す。
- global が
- inputIndex を、str の要素 lastIndex から得られたcharacterの input 内のインデックスとする。
- r を matcher(input, inputIndex) とする。
- r が
failure の場合、次を行う：- sticky が
true の場合、次を行う：- ?
Set (regexp,"lastIndex" ,+0 𝔽,true ) を実行する。 null を返す。
- ?
- lastIndex を
AdvanceStringIndex (str, lastIndex, fullUnicode) に設定する。
- sticky が
- それ以外の場合、
Assert : r はMatchState である。- matchSucceeded を
true に設定する。
- lastIndex > length の場合、次を行う：
- endIndex を r.[[EndIndex]] とする。
- fullUnicode が
true の場合、endIndex をGetStringIndex (str, endIndex) に設定する。 - global が
true または sticky がtrue の場合、次を行う： - n を r.[[Captures]] 内の要素数とする。
Assert : n = regexp.[[RegExpRecord]].[[CapturingGroupsCount]]。Assert : n < 232 - 1。- array を !
ArrayCreate (n + 1) とする。 Assert : array の"length" プロパティの数学的値は n + 1 である。- !
CreateDataPropertyOrThrow (array,"index" ,𝔽 (lastIndex)) を実行する。 - !
CreateDataPropertyOrThrow (array,"input" , str) を実行する。 - match を
Match Record { [[StartIndex]]: lastIndex, [[EndIndex]]: endIndex } とする。 - indices を新しい空の
List とする。 - groupNames を新しい空の
List とする。 - match を indices に追加する。
- matchedSubstr を
GetMatchString (str, match) とする。 - !
CreateDataPropertyOrThrow (array,"0" , matchedSubstr) を実行する。 - regexp が任意の
GroupName を含む場合、次を行う：- groups を
OrdinaryObjectCreate (null ) とする。 - hasGroups を
true とする。
- groups を
- それ以外の場合、
- groups を
undefined とする。 - hasGroups を
false とする。
- groups を
- !
CreateDataPropertyOrThrow (array,"groups" , groups) を実行する。 - matchedGroupNames を新しい空の
List とする。 - 1 ≤ i ≤ n である各整数 i について、昇順に、次を行う：
- captureI を r.[[Captures]] の i番目 の要素とする。
- captureI が
undefined の場合、次を行う：- capturedValue を
undefined とする。 undefined を indices に追加する。
- capturedValue を
- それ以外の場合、
- captureStart を captureI.[[StartIndex]] とする。
- captureEnd を captureI.[[EndIndex]] とする。
- fullUnicode が
true の場合、次を行う：- captureStart を
GetStringIndex (str, captureStart) に設定する。 - captureEnd を
GetStringIndex (str, captureEnd) に設定する。
- captureStart を
- capture を
Match Record { [[StartIndex]]: captureStart, [[EndIndex]]: captureEnd } とする。 - capturedValue を
GetMatchString (str, capture) とする。 - capture を indices に追加する。
- !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (i)), capturedValue) を実行する。 - regexp の i番目 のキャプチャが
GroupName で定義されていた場合、次を行う：- s をその
GroupName のCapturingGroupName とする。 - matchedGroupNames が s を含む場合、次を行う：
Assert : capturedValue はundefined である。undefined を groupNames に追加する。
- それ以外の場合、
- capturedValue が
undefined でない場合、s を matchedGroupNames に追加する。 NOTE : s という名前のグループが複数ある場合、この時点で groups はすでに s プロパティを持っている可能性がある。しかし、groups はすべてのプロパティが書き込み可能なデータプロパティである通常のオブジェクトであるため、CreateDataPropertyOrThrow の呼び出しはそれでも成功することが保証される。- !
CreateDataPropertyOrThrow (groups, s, capturedValue) を実行する。 - s を groupNames に追加する。
- capturedValue が
- s をその
- それ以外の場合、
undefined を groupNames に追加する。
- hasIndices が
true の場合、次を行う：- indicesArray を
MakeMatchIndicesIndexPairArray (str, indices, groupNames, hasGroups) とする。 - !
CreateDataPropertyOrThrow (array,"indices" , indicesArray) を実行する。
- indicesArray を
- array を返す。
22.2.7.3 AdvanceStringIndex ( str, index, unicode )
The
Assert : index ≤ 253 - 1。- unicode が
false の場合、index + 1 を返す。 - length を str の長さとする。
- index + 1 ≥ length の場合、index + 1 を返す。
- cp を
CodePointAt (str, index) とする。 - index + cp.[[CodeUnitCount]] を返す。
22.2.7.4 GetStringIndex ( str, codePointIndex )
The
- str が空のStringである場合、0を返す。
- len を str の長さとする。
- codeUnitCount を0とする。
- codePointCount を0とする。
- codeUnitCount < len の間、繰り返す：
- codePointCount = codePointIndex の場合、codeUnitCount を返す。
- cp を
CodePointAt (str, codeUnitCount) とする。 - codeUnitCount を codeUnitCount + cp.[[CodeUnitCount]] に設定する。
- codePointCount を codePointCount + 1 に設定する。
- len を返す。
22.2.7.5 Match Record
Match Record は、正規表現マッチまたはキャプチャの開始インデックスと終了インデックスをカプセル化するために使用される
Match Recordは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[StartIndex]] | 非負整数 | マッチが始まる（包含）文字列の先頭からのコード単位数。 |
| [[EndIndex]] | [[StartIndex]]以上の整数 | マッチが終わる（排他）文字列の先頭からのコード単位数。 |
22.2.7.6 GetMatchString ( str, match )
The
Assert : match.[[StartIndex]] ≤ match.[[EndIndex]] ≤ str の長さ。- str の match.[[StartIndex]] から match.[[EndIndex]] までの部分文字列を返す。
22.2.7.7 GetMatchIndexPair ( str, match )
The
Assert : match.[[StartIndex]] ≤ match.[[EndIndex]] ≤ str の長さ。CreateArrayFromList («𝔽 (match.[[StartIndex]]),𝔽 (match.[[EndIndex]]) ») を返す。
22.2.7.8 MakeMatchIndicesIndexPairArray ( str, indices, groupNames, hasGroups )
The
- n を indices 内の要素数とする。
Assert : n < 232 - 1。Assert : groupNames は n - 1 個の要素を持つ。NOTE : groupNamesList は、indices[1]から始まる indicesList と整列した要素を含む。- array を !
ArrayCreate (n) とする。 - hasGroups が
true の場合、次を行う：- groups を
OrdinaryObjectCreate (null ) とする。
- groups を
- それ以外の場合、
- groups を
undefined とする。
- groups を
- !
CreateDataPropertyOrThrow (array,"groups" , groups) を実行する。 - 0 ≤ i < n である各整数 i について、昇順に、次を行う：
- matchIndices を indices[i] とする。
- matchIndices が
undefined でない場合、次を行う：- matchIndexPair を
GetMatchIndexPair (str, matchIndices) とする。
- matchIndexPair を
- それ以外の場合、
- matchIndexPair を
undefined とする。
- matchIndexPair を
- !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (i)), matchIndexPair) を実行する。 - i > 0 の場合、次を行う：
- name を groupNames[i - 1] とする。
- name が
undefined でない場合、次を行う：Assert : groups はundefined でない。NOTE : name という名前のグループが複数ある場合、この時点で groups はすでに name プロパティを持っている可能性がある。しかし、groups はすべてのプロパティが書き込み可能なデータプロパティである通常のオブジェクトであるため、CreateDataPropertyOrThrow の呼び出しはそれでも成功することが保証される。- !
CreateDataPropertyOrThrow (groups, name, matchIndexPair) を実行する。
- array を返す。
22.2.8 RegExpインスタンスのプロパティ
RegExpインスタンスは、
ECMAScript 2015より前は、RegExpインスタンスは独自のデータプロパティRegExp.prototypeのアクセサープロパティとして指定されています。
RegExpインスタンスは、以下のプロパティも持ちます：
22.2.8.1 lastIndex
22.2.9 RegExp String Iteratorオブジェクト
RegExp String Iterator は、ある特定のStringインスタンスオブジェクトに対して、ある特定のRegExpインスタンスオブジェクトとマッチさせながら行う特定の反復を表すオブジェクトです。RegExp String Iteratorオブジェクトには名前付きコンストラクターはありません。代わりに、RegExp String IteratorオブジェクトはRegExpインスタンスオブジェクトの特定のメソッドを呼び出すことによって作成されます。
22.2.9.1 CreateRegExpStringIterator ( regexp, str, global, fullUnicode )
The
- iterator を
OrdinaryObjectCreate (%RegExpStringIteratorPrototype% , « [[IteratingRegExp]], [[IteratedString]], [[Global]], [[Unicode]], [[Done]] ») とする。 - iterator.[[IteratingRegExp]] を regexp に設定する。
- iterator.[[IteratedString]] を str に設定する。
- iterator.[[Global]] を global に設定する。
- iterator.[[Unicode]] を fullUnicode に設定する。
- iterator.[[Done]] を
false に設定する。 - iterator を返す。
22.2.9.2 %RegExpStringIteratorPrototype%オブジェクト
%RegExpStringIteratorPrototype%オブジェクトは以下の通りです：
- すべての
RegExp String Iterator オブジェクトによって継承されるプロパティを持つ。 - 通常のオブジェクトである。
- [[Prototype]]内部スロットを持ち、その値は
%Iterator.prototype% である。 - 以下のプロパティを持つ：
22.2.9.2.1 %RegExpStringIteratorPrototype%.next ( )
- iteratorObj を
this 値とする。 - iteratorObj がObjectでない場合、
TypeError 例外をスローする。 - iteratorObj が
RegExp String Iterator オブジェクトインスタンスのすべての内部スロット（22.2.9.3 を参照）を持たない場合、TypeError 例外をスローする。 - iteratorObj.[[Done]] が
true の場合、次を行う：CreateIteratorResultObject (undefined ,true ) を返す。
- regexp を iteratorObj.[[IteratingRegExp]] とする。
- str を iteratorObj.[[IteratedString]] とする。
- global を iteratorObj.[[Global]] とする。
- fullUnicode を iteratorObj.[[Unicode]] とする。
- match を ?
RegExpExec (regexp, str) とする。 - match が
null の場合、次を行う：- iteratorObj.[[Done]] を
true に設定する。 CreateIteratorResultObject (undefined ,true ) を返す。
- iteratorObj.[[Done]] を
- global が
false の場合、次を行う：- iteratorObj.[[Done]] を
true に設定する。 CreateIteratorResultObject (match,false ) を返す。
- iteratorObj.[[Done]] を
- matchStr を ?
ToString (?Get (match,"0" )) とする。 - matchStr が空のStringである場合、次を行う：
CreateIteratorResultObject (match,false ) を返す。
22.2.9.2.2 %RegExpStringIteratorPrototype% [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
22.2.9.3 RegExp String Iteratorインスタンスのプロパティ
| 内部スロット | 型 | 説明 |
|---|---|---|
| [[IteratingRegExp]] | Object | 反復に使用される正規表現。 |
| [[IteratedString]] | String | 反復対象のString値。 |
| [[Global]] | Boolean | [[IteratingRegExp]] がglobalであるかどうかを示します。 |
| [[Unicode]] | Boolean | [[IteratingRegExp]] がUnicodeモードであるかどうかを示します。 |
| [[Done]] | Boolean | 反復が完了したかどうかを示します。 |
23 インデックス付きコレクション
23.1 Arrayオブジェクト
Arrayは、あるクラスのプロパティ名を特別に扱う
23.1.1 Arrayコンストラクター
Arrayコンストラクターは以下の通りです：
- %Array%である。
グローバルオブジェクト の"Array" プロパティの初期値である。- コンストラクターとして呼び出されたとき、新しいArrayを作成して初期化する。
- コンストラクターとしてではなく関数として呼び出されたときも、新しいArrayを作成して初期化する。したがって、関数呼び出し
Array(…)は、同じ引数を持つオブジェクト作成式new Array(…)と等価である。 - 引数の数と型に基づいて動作が異なる関数である。
- クラス定義の
extends節の値として使用できる。exotic Arrayの動作を継承することを意図するサブクラスコンストラクターは、Arrayexotic object であるサブクラスインスタンスを初期化するために、Arrayコンストラクターへのsuper呼び出しを含めなければならない。ただし、Array.prototypeメソッドの大部分は汎用メソッドであり、そのthis 値がArrayexotic object であることに依存しない。
23.1.1.1 Array ( ...values )
この関数は呼び出されたとき、次の手順を実行します：
- NewTarget が
undefined の場合、newTarget を実行中の関数オブジェクトとする。そうでない場合、newTarget を NewTarget とする。 - proto を ?
GetPrototypeFromConstructor (newTarget,"%Array.prototype%" ) とする。 - numberOfArgs を values 内の要素数とする。
- numberOfArgs = 0 の場合、!
ArrayCreate (0, proto) を返す。 - numberOfArgs = 1 の場合、次を行う：
- len を values[0] とする。
- array を !
ArrayCreate (0, proto) とする。 - len がNumberでない場合、次を行う：
- !
CreateDataPropertyOrThrow (array,"0" , len) を実行する。 - intLen を
1 𝔽 とする。
- !
- それ以外の場合、
- intLen を !
ToUint32 (len) とする。 SameValueZero (intLen, len) がfalse の場合、RangeError 例外をスローする。
- intLen を !
- !
Set (array,"length" , intLen,true ) を実行する。 - array を返す。
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" プロパティの数学的値は numberOfArgs である。- array を返す。
23.1.2 Arrayコンストラクターのプロパティ
Arrayコンストラクターは以下の通りです：
- [[Prototype]]内部スロットを持ち、その値は
%Function.prototype% である。 - 値が
1 𝔽 である"length" プロパティを持つ。 - 以下のプロパティを持つ：
23.1.2.1 Array.from ( items [ , mapper [ , thisArg ] ] )
この関数は呼び出されたとき、次の手順を実行します：
- constructor を
this 値とする。 - mapper が
undefined の場合、次を行う：- mapping を
false とする。
- mapping を
- それ以外の場合、
IsCallable (mapper) がfalse の場合、TypeError 例外をスローする。- mapping を
true とする。
- usingIterator を ?
GetMethod (items,%Symbol.iterator% ) とする。 - usingIterator が
undefined でない場合、次を行う：IsConstructor (constructor) がtrue の場合、次を行う：- array を ?
Construct (constructor) とする。
- array を ?
- それ以外の場合、
- array を !
ArrayCreate (0) とする。
- array を !
- iteratorRecord を ?
GetIteratorFromMethod (items, usingIterator) とする。 - k を 0 とする。
- 繰り返す：
- k ≥ 253 - 1 の場合、次を行う：
- error を
ThrowCompletion (新しく作成されたTypeError オブジェクト) とする。 - ?
IteratorClose (iteratorRecord, error) を返す。
- error を
- propertyKey を !
ToString (𝔽 (k)) とする。 - next を ?
IteratorStepValue (iteratorRecord) とする。 - next が
done の場合、次を行う： - mapping が
true の場合、次を行う：- mappedValue を
Completion (Call (mapper, thisArg, « next,𝔽 (k) »)) とする。 IfAbruptCloseIterator (mappedValue, iteratorRecord)。
- mappedValue を
- それ以外の場合、
- mappedValue を next とする。
- defineStatus を
Completion (CreateDataPropertyOrThrow (array, propertyKey, mappedValue)) とする。 IfAbruptCloseIterator (defineStatus, iteratorRecord)。- k を k + 1 に設定する。
- k ≥ 253 - 1 の場合、次を行う：
NOTE : items はiterable ではないため、array-like object であると仮定する。- arrayLike を !
ToObject (items) とする。 - len を ?
LengthOfArrayLike (arrayLike) とする。 IsConstructor (constructor) がtrue の場合、次を行う：- それ以外の場合、
- array を ?
ArrayCreate (len) とする。
- array を ?
- k を 0 とする。
- k < len の間、繰り返す：
- ?
Set (array,"length" ,𝔽 (len),true ) を実行する。 - array を返す。
このメソッドは意図的に汎用のファクトリメソッドです。その
23.1.2.2 Array.fromAsync ( items [ , mapper [ , thisArg ] ] )
このasync関数は呼び出されたとき、次の手順を実行します：
- constructor を
this 値とする。 - mapping を
false とする。 - mapper が
undefined でない場合、次を行う：IsCallable (mapper) がfalse の場合、TypeError 例外をスローする。- mapping を
true に設定する。
- iteratorRecord を
undefined とする。 - usingAsyncIterator を ?
GetMethod (items,%Symbol.asyncIterator% ) とする。 - usingAsyncIterator が
undefined の場合、次を行う：- usingSyncIterator を ?
GetMethod (items,%Symbol.iterator% ) とする。 - usingSyncIterator が
undefined でない場合、次を行う：- iteratorRecord を
CreateAsyncFromSyncIterator (?GetIteratorFromMethod (items, usingSyncIterator)) に設定する。
- iteratorRecord を
- usingSyncIterator を ?
- それ以外の場合、
- iteratorRecord を ?
GetIteratorFromMethod (items, usingAsyncIterator) に設定する。
- iteratorRecord を ?
- iteratorRecord が
undefined でない場合、次を行う：IsConstructor (constructor) がtrue の場合、次を行う：- array を ?
Construct (constructor) とする。
- array を ?
- それ以外の場合、
- array を !
ArrayCreate (0) とする。
- array を !
- k を 0 とする。
- 繰り返す：
- k ≥ 253 - 1 の場合、次を行う：
- error を
ThrowCompletion (新しく作成されたTypeError オブジェクト) とする。 - ?
AsyncIteratorClose (iteratorRecord, error) を返す。
- error を
- propertyKey を !
ToString (𝔽 (k)) とする。 - nextResult を ?
Call (iteratorRecord.[[NextMethod]], iteratorRecord.[[Iterator]]) とする。 - nextResult を ?
Await (nextResult) に設定する。 - nextResult がObjectでない場合、
TypeError 例外をスローする。 - done を ?
IteratorComplete (nextResult) とする。 - done が
true の場合、次を行う： - nextValue を ?
IteratorValue (nextResult) とする。 - mapping が
true の場合、次を行う：- mappedValue を
Completion (Call (mapper, thisArg, « nextValue,𝔽 (k) »)) とする。 IfAbruptCloseAsyncIterator (mappedValue, iteratorRecord)。- mappedValue を
Completion (Await (mappedValue)) に設定する。 IfAbruptCloseAsyncIterator (mappedValue, iteratorRecord)。
- mappedValue を
- それ以外の場合、
- mappedValue を nextValue とする。
- defineStatus を
Completion (CreateDataPropertyOrThrow (array, propertyKey, mappedValue)) とする。 IfAbruptCloseAsyncIterator (defineStatus, iteratorRecord)。- k を k + 1 に設定する。
- k ≥ 253 - 1 の場合、次を行う：
- それ以外の場合、
NOTE : items はasync iterable でもiterable でもないため、array-like object であると仮定する。- arrayLike を !
ToObject (items) とする。 - len を ?
LengthOfArrayLike (arrayLike) とする。 IsConstructor (constructor) がtrue の場合、次を行う：- それ以外の場合、
- array を ?
ArrayCreate (len) とする。
- array を ?
- k を 0 とする。
- k < len の間、繰り返す：
- 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" ,𝔽 (len),true ) を実行する。 - array を返す。
このメソッドは意図的に汎用のファクトリメソッドです。その
23.1.2.3 Array.isArray ( arg )
この関数は呼び出されたとき、次の手順を実行します：
- ?
IsArray (arg) を返す。
23.1.2.4 Array.of ( ...items )
このメソッドは呼び出されたとき、次の手順を実行します：
- len を items 内の要素数とする。
- lenNumber を
𝔽 (len) とする。 - constructor を
this 値とする。 IsConstructor (constructor) がtrue の場合、次を行う：- array を ?
Construct (constructor, « lenNumber ») とする。
- array を ?
- それ以外の場合、
- array を ?
ArrayCreate (len) とする。
- array を ?
- k を 0 とする。
- k < len の間、繰り返す：
- kValue を items[k] とする。
- propertyKey を !
ToString (𝔽 (k)) とする。 - ?
CreateDataPropertyOrThrow (array, propertyKey, kValue) を実行する。 - k を k + 1 に設定する。
- ?
Set (array,"length" , lenNumber,true ) を実行する。 - array を返す。
このメソッドは意図的に汎用のファクトリメソッドです。その
23.1.2.5 Array.prototype
Array.prototypeの値は
このプロパティの属性は { [[Writable]]:
23.1.2.6 get Array [ %Symbol.species% ]
Array[%Symbol.species%]は、setアクセサー関数が
this 値を返す。
この関数の
Arrayプロトタイプメソッドは通常、その
23.1.3 Arrayプロトタイプオブジェクトのプロパティ
Arrayプロトタイプオブジェクトは以下の通りです：
- %Array.prototype%である。
- Array
exotic object であり、そのようなオブジェクトに指定された内部メソッドを持つ。 - 初期値が
+0 𝔽 であり、属性が { [[Writable]]:true , [[Enumerable]]:false , [[Configurable]]:false } である"length" プロパティを持つ。 - [[Prototype]]内部スロットを持ち、その値は
%Object.prototype% である。
Arrayプロトタイプオブジェクトは、ECMAScript 2015仕様より前に作成されたECMAScriptコードとの互換性を確保するため、Array
23.1.3.1 Array.prototype.at ( index )
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 - relativeIndex を ?
ToIntegerOrInfinity (index) とする。 - relativeIndex ≥ 0 の場合、次を行う：
- k を relativeIndex とする。
- それ以外の場合、
- k を len + relativeIndex とする。
- k < 0 または k ≥ len の場合、
undefined を返す。 - ?
Get (obj, !ToString (𝔽 (k))) を返す。
23.1.3.2 Array.prototype.concat ( ...items )
このメソッドは、そのオブジェクトの配列要素に続いて各引数の配列要素を含む配列を返します。
呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - array を ?
ArraySpeciesCreate (obj, 0) とする。 - nextIndex を 0 とする。
- obj を items の先頭に追加する。
- items の各要素 item について、次を行う：
- spreadable を ?
IsConcatSpreadable (item) とする。 - spreadable が
true の場合、次を行う：- len を ?
LengthOfArrayLike (item) とする。 - nextIndex + len > 253 - 1 の場合、
TypeError 例外をスローする。 - sourceIndex を 0 とする。
- sourceIndex < len の間、繰り返す：
- 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 を !
- len を ?
- それ以外の場合、
NOTE : item は展開されるのではなく、単一の項目として追加される。- nextIndex ≥ 253 - 1 の場合、
TypeError 例外をスローする。 - ?
CreateDataPropertyOrThrow (array, !ToString (𝔽 (nextIndex)), item) を実行する。 - nextIndex を nextIndex + 1 に設定する。
- spreadable を ?
- ?
Set (array,"length" ,𝔽 (nextIndex),true ) を実行する。 - array を返す。
このメソッドの
ステップ
このメソッドは意図的に汎用です。その
23.1.3.2.1 IsConcatSpreadable ( obj )
The
- obj がObjectでない場合、
false を返す。 - spreadable を ?
Get (obj,%Symbol.isConcatSpreadable% ) とする。 - spreadable が
undefined でない場合、ToBoolean (spreadable) を返す。 - ?
IsArray (obj) を返す。
23.1.3.3 Array.prototype.constructor
Array.prototype.constructorの初期値は
23.1.3.4 Array.prototype.copyWithin ( target, start [ , end ] )
end 引数は省略可能です。指定されない場合、
target が負である場合、それは
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 - relativeTarget を ?
ToIntegerOrInfinity (target) とする。 - relativeTarget = -∞ の場合、to を 0 とする。
- そうでなく relativeTarget < 0 の場合、to を
max (len + relativeTarget, 0) とする。 - それ以外の場合、to を
min (relativeTarget, len) とする。 - relativeStart を ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞ の場合、from を 0 とする。
- そうでなく relativeStart < 0 の場合、from を
max (len + relativeStart, 0) とする。 - それ以外の場合、from を
min (relativeStart, len) とする。 - end が
undefined の場合、relativeEnd を len とする。そうでない場合、relativeEnd を ?ToIntegerOrInfinity (end) とする。 - relativeEnd = -∞ の場合、final を 0 とする。
- そうでなく relativeEnd < 0 の場合、final を
max (len + relativeEnd, 0) とする。 - それ以外の場合、final を
min (relativeEnd, len) とする。 - count を
min (final - from, len - to) とする。 - from < to かつ to < from + count の場合、次を行う：
- direction を -1 とする。
- from を from + count - 1 に設定する。
- to を to + count - 1 に設定する。
- それ以外の場合、
- direction を 1 とする。
- count > 0 の間、繰り返す：
- fromKey を !
ToString (𝔽 (from)) とする。 - toKey を !
ToString (𝔽 (to)) とする。 - fromPresent を ?
HasProperty (obj, fromKey) とする。 - fromPresent が
true の場合、次を行う： - それ以外の場合、
Assert : fromPresent はfalse である。- ?
DeletePropertyOrThrow (obj, toKey) を実行する。
- from を from + direction に設定する。
- to を to + direction に設定する。
- count を count - 1 に設定する。
- fromKey を !
- obj を返す。
このメソッドは意図的に汎用です。その
23.1.3.5 Array.prototype.entries ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 CreateArrayIterator (obj,key+value ) を返す。
23.1.3.6 Array.prototype.every ( callback [ , thisArg ] )
callback は3つの引数を受け取り、Boolean値に強制変換可能な値を返す関数であるべきです。everyは、callback が everyはただちに everyは
thisArg パラメーターが指定された場合、それは callback の各呼び出しの
callback は3つの引数、すなわち要素の値、要素のインデックス、および走査されているオブジェクトで呼び出されます。
everyは、それが呼び出されたオブジェクトを直接変更しませんが、callback の呼び出しによってそのオブジェクトが変更される可能性があります。
everyによって処理される要素の範囲は、callback の最初の呼び出しの前に設定されます。everyの呼び出しが開始された後に配列へ追加された要素は、callback によって訪問されません。配列の既存要素が変更された場合、callback に渡される値は、everyがその要素を訪問した時点の値になります。everyの呼び出しが開始された後、訪問される前に削除された要素は訪問されません。everyは数学における「すべての」量化子のように動作します。特に、空の配列に対しては
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 IsCallable (callback) がfalse の場合、TypeError 例外をスローする。- k を 0 とする。
- k < len の間、繰り返す：
true を返す。
このメソッドは意図的に汎用です。その
23.1.3.7 Array.prototype.fill ( value [ , start [ , end ] ] )
start 引数は省略可能です。指定されない場合、
end 引数は省略可能です。指定されない場合、
start が負である場合、それは
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 - relativeStart を ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞ の場合、k を 0 とする。
- そうでなく relativeStart < 0 の場合、k を
max (len + relativeStart, 0) とする。 - それ以外の場合、k を
min (relativeStart, len) とする。 - end が
undefined の場合、relativeEnd を len とする。そうでない場合、relativeEnd を ?ToIntegerOrInfinity (end) とする。 - relativeEnd = -∞ の場合、final を 0 とする。
- そうでなく relativeEnd < 0 の場合、final を
max (len + relativeEnd, 0) とする。 - それ以外の場合、final を
min (relativeEnd, len) とする。 - k < final の間、繰り返す：
- obj を返す。
このメソッドは意図的に汎用です。その
23.1.3.8 Array.prototype.filter ( callback [ , thisArg ] )
callback は3つの引数を受け取り、Boolean値に強制変換可能な値を返す関数であるべきです。filterは、配列内の各要素について昇順に callback を1回ずつ呼び出し、callback が
thisArg パラメーターが指定された場合、それは callback の各呼び出しの
callback は3つの引数、すなわち要素の値、要素のインデックス、および走査されているオブジェクトで呼び出されます。
filterは、それが呼び出されたオブジェクトを直接変更しませんが、callback の呼び出しによってそのオブジェクトが変更される可能性があります。
filterによって処理される要素の範囲は、callback の最初の呼び出しの前に設定されます。filterの呼び出しが開始された後に配列へ追加された要素は、callback によって訪問されません。配列の既存要素が変更された場合、callback に渡される値は、filterがその要素を訪問した時点の値になります。filterの呼び出しが開始された後、訪問される前に削除された要素は訪問されません。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 IsCallable (callback) がfalse の場合、TypeError 例外をスローする。- array を ?
ArraySpeciesCreate (obj, 0) とする。 - k を 0 とする。
- to を 0 とする。
- k < len の間、繰り返す：
- propertyKey を !
ToString (𝔽 (k)) とする。 - kPresent を ?
HasProperty (obj, propertyKey) とする。 - kPresent が
true の場合、次を行う： - k を k + 1 に設定する。
- propertyKey を !
- array を返す。
このメソッドは意図的に汎用です。その
23.1.3.9 Array.prototype.find ( predicate [ , thisArg ] )
このメソッドは、predicate が findはただちにその要素値を返します。そうでない場合、findは
追加情報については
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 - findRec を ?
FindViaPredicate (obj, len,ascending , predicate, thisArg) とする。 - findRec.[[Value]] を返す。
このメソッドは意図的に汎用です。その
23.1.3.10 Array.prototype.findIndex ( predicate [ , thisArg ] )
このメソッドは、predicate が findIndexはただちにその要素値のインデックスを返します。そうでない場合、findIndexは -1 を返します。
追加情報については
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 - findRec を ?
FindViaPredicate (obj, len,ascending , predicate, thisArg) とする。 - findRec.[[Index]] を返す。
このメソッドは意図的に汎用です。その
23.1.3.11 Array.prototype.findLast ( predicate [ , thisArg ] )
このメソッドは、predicate が findLastはただちにその要素値を返します。そうでない場合、findLastは
追加情報については
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 - findRec を ?
FindViaPredicate (obj, len,descending , predicate, thisArg) とする。 - findRec.[[Value]] を返す。
このメソッドは意図的に汎用です。その
23.1.3.12 Array.prototype.findLastIndex ( predicate [ , thisArg ] )
このメソッドは、predicate が findLastIndexはただちにその要素値のインデックスを返します。そうでない場合、findLastIndexは -1 を返します。
追加情報については
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 - findRec を ?
FindViaPredicate (obj, len,descending , predicate, thisArg) とする。 - findRec.[[Index]] を返す。
このメソッドは意図的に汎用です。その
23.1.3.12.1 FindViaPredicate ( obj, len, direction, predicate, thisArg )
The
obj は
predicate は関数であるべきです。配列の要素について呼び出されるとき、要素の値、要素のインデックス、および走査されているオブジェクトの3つの引数が渡されます。その戻り値はBoolean値に強制変換されます。
thisArg は predicate の各呼び出しの
この操作は、それが呼び出されたオブジェクトを直接変更しませんが、predicate の呼び出しによってそのオブジェクトが変更される可能性があります。
処理される要素の範囲は、走査が開始される直前、predicate の最初の呼び出しの前に設定されます。この後に配列へ追加された要素は、predicate によって訪問されません。配列の既存要素が変更された場合、predicate に渡される値は、この操作がその要素を訪問した時点の値になります。走査開始後、訪問される前に削除された要素もなお訪問され、プロトタイプから検索されるか、または
It performs the following steps when called:
IsCallable (predicate) がfalse の場合、TypeError 例外をスローする。- direction が
ascending である場合、次を行う：- indices を、0（包含）から len（排他）までの区間内の整数を昇順に並べた
List とする。
- indices を、0（包含）から len（排他）までの区間内の整数を昇順に並べた
- それ以外の場合、
- indices を、0（包含）から len（排他）までの区間内の整数を降順に並べた
List とする。
- indices を、0（包含）から len（排他）までの区間内の整数を降順に並べた
- indices の各整数 k について、次を行う：
Record { [[Index]]:-1 𝔽, [[Value]]:undefined } を返す。
23.1.3.13 Array.prototype.flat ( [ depth ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - sourceLen を ?
LengthOfArrayLike (obj) とする。 - depthNum を 1 とする。
- depth が
undefined でない場合、次を行う：- depthNum を ?
ToIntegerOrInfinity (depth) に設定する。 - depthNum < 0 の場合、depthNum を 0 に設定する。
- depthNum を ?
- array を ?
ArraySpeciesCreate (obj, 0) とする。 - ?
FlattenIntoArray (array, obj, sourceLen, 0, depthNum) を実行する。 - array を返す。
23.1.3.13.1 FlattenIntoArray ( target, source, sourceLen, start, depth [ , mapperFunction [ , thisArg ] ] )
The
Assert : mapperFunction が存在する場合、IsCallable (mapperFunction) はtrue であり、thisArg が存在し、depth は 1 である。- targetIndex を start とする。
- sourceIndex を
+0 𝔽 とする。 ℝ (sourceIndex) < sourceLen の間、繰り返す：- propertyKey を !
ToString (sourceIndex) とする。 - exists を ?
HasProperty (source, propertyKey) とする。 - exists が
true の場合、次を行う：- element を ?
Get (source, propertyKey) とする。 - mapperFunction が存在する場合、次を行う：
- element を ?
Call (mapperFunction, thisArg, « element, sourceIndex, source ») に設定する。
- element を ?
- shouldFlatten を
false とする。 - depth > 0 の場合、次を行う：
- shouldFlatten を ?
IsArray (element) に設定する。
- shouldFlatten を ?
- shouldFlatten が
true の場合、次を行う：- depth = +∞ の場合、newDepth を +∞ とする。
- それ以外の場合、newDepth を depth - 1 とする。
- elementLen を ?
LengthOfArrayLike (element) とする。 - targetIndex を ?
FlattenIntoArray (target, element, elementLen, targetIndex, newDepth) に設定する。
- それ以外の場合、
- targetIndex ≥ 253 - 1 の場合、
TypeError 例外をスローする。 - ?
CreateDataPropertyOrThrow (target, !ToString (𝔽 (targetIndex)), element) を実行する。 - targetIndex を targetIndex + 1 に設定する。
- targetIndex ≥ 253 - 1 の場合、
- element を ?
- sourceIndex を sourceIndex +
1 𝔽 に設定する。
- propertyKey を !
- targetIndex を返す。
23.1.3.14 Array.prototype.flatMap ( mapperFunction [ , thisArg ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - sourceLen を ?
LengthOfArrayLike (obj) とする。 IsCallable (mapperFunction) がfalse の場合、TypeError 例外をスローする。- array を ?
ArraySpeciesCreate (obj, 0) とする。 - ?
FlattenIntoArray (array, obj, sourceLen, 0, 1, mapperFunction, thisArg) を実行する。 - array を返す。
23.1.3.15 Array.prototype.forEach ( callback [ , thisArg ] )
callback は3つの引数を受け取る関数であるべきです。forEachは、配列内に存在する各要素について昇順に callback を1回ずつ呼び出します。callback は実際に存在する配列要素についてのみ呼び出されます。配列の欠損要素については呼び出されません。
thisArg パラメーターが指定された場合、それは callback の各呼び出しの
callback は3つの引数、すなわち要素の値、要素のインデックス、および走査されているオブジェクトで呼び出されます。
forEachは、それが呼び出されたオブジェクトを直接変更しませんが、callback の呼び出しによってそのオブジェクトが変更される可能性があります。
forEachによって処理される要素の範囲は、callback の最初の呼び出しの前に設定されます。forEachの呼び出しが開始された後に配列へ追加された要素は、callback によって訪問されません。配列の既存要素が変更された場合、callback に渡される値は、forEachがその要素を訪問した時点の値になります。forEachの呼び出しが開始された後、訪問される前に削除された要素は訪問されません。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 IsCallable (callback) がfalse の場合、TypeError 例外をスローする。- k を 0 とする。
- k < len の間、繰り返す：
undefined を返す。
このメソッドは意図的に汎用です。その
23.1.3.16 Array.prototype.includes ( searchElement [ , fromIndex ] )
このメソッドは
省略可能な第2引数 fromIndex の既定値は
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 - len = 0 の場合、
false を返す。 - startIndex を ?
ToIntegerOrInfinity (fromIndex) とする。 Assert : fromIndex がundefined の場合、startIndex は 0 である。- startIndex = +∞ の場合、
false を返す。 - startIndex = -∞ の場合、startIndex を 0 に設定する。
- startIndex ≥ 0 の場合、次を行う：
- k を startIndex とする。
- それ以外の場合、
- k を len + startIndex とする。
- k < 0 の場合、k を 0 に設定する。
- k < len の間、繰り返す：
- elementK を ?
Get (obj, !ToString (𝔽 (k))) とする。 SameValueZero (searchElement, elementK) がtrue の場合、true を返す。- k を k + 1 に設定する。
- elementK を ?
false を返す。
このメソッドは意図的に汎用です。その
このメソッドは、類似するindexOfメソッドと意図的に2つの点で異なります。第1に、
23.1.3.17 Array.prototype.indexOf ( searchElement [ , fromIndex ] )
このメソッドは
省略可能な第2引数 fromIndex の既定値は
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 - len = 0 の場合、
-1 𝔽 を返す。 - startIndex を ?
ToIntegerOrInfinity (fromIndex) とする。 Assert : fromIndex がundefined の場合、startIndex は 0 である。- startIndex = +∞ の場合、
-1 𝔽 を返す。 - startIndex = -∞ の場合、startIndex を 0 に設定する。
- startIndex ≥ 0 の場合、次を行う：
- k を startIndex とする。
- それ以外の場合、
- k を len + startIndex とする。
- k < 0 の場合、k を 0 に設定する。
- k < len の間、繰り返す：
- propertyKey を !
ToString (𝔽 (k)) とする。 - kPresent を ?
HasProperty (obj, propertyKey) とする。 - kPresent が
true の場合、次を行う：- elementK を ?
Get (obj, propertyKey) とする。 IsStrictlyEqual (searchElement, elementK) がtrue の場合、𝔽 (k) を返す。
- elementK を ?
- k を k + 1 に設定する。
- propertyKey を !
-1 𝔽 を返す。
このメソッドは意図的に汎用です。その
23.1.3.18 Array.prototype.join ( separator )
このメソッドは、配列の要素をStringに変換し、その後、separator の出現で区切られたこれらのStringを連結します。セパレーターが指定されない場合、単一のカンマがセパレーターとして使用されます。
呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 - separator が
undefined の場合、sep を"," とする。 - それ以外の場合、sep を ?
ToString (separator) とする。 - result を空のStringとする。
- k を 0 とする。
- k < len の間、繰り返す：
- result を返す。
このメソッドは意図的に汎用です。その
23.1.3.19 Array.prototype.keys ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 CreateArrayIterator (obj,key ) を返す。
23.1.3.20 Array.prototype.lastIndexOf ( searchElement [ , fromIndex ] )
このメソッドは
省略可能な第2引数 fromIndex の既定値は、配列の長さから1を引いた値です（すなわち、配列全体が検索されます）。それが配列の長さ以上である場合、配列全体が検索されます。それが
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 - len = 0 の場合、
-1 𝔽 を返す。 - fromIndex が存在する場合、startIndex を ?
ToIntegerOrInfinity (fromIndex) とする。そうでない場合、startIndex を len - 1 とする。 - startIndex = -∞ の場合、
-1 𝔽 を返す。 - startIndex ≥ 0 の場合、次を行う：
- k を
min (startIndex, len - 1) とする。
- k を
- それ以外の場合、
- k を len + startIndex とする。
- k ≥ 0 の間、繰り返す：
- propertyKey を !
ToString (𝔽 (k)) とする。 - kPresent を ?
HasProperty (obj, propertyKey) とする。 - kPresent が
true の場合、次を行う：- elementK を ?
Get (obj, propertyKey) とする。 IsStrictlyEqual (searchElement, elementK) がtrue の場合、𝔽 (k) を返す。
- elementK を ?
- k を k - 1 に設定する。
- propertyKey を !
-1 𝔽 を返す。
このメソッドは意図的に汎用です。その
23.1.3.21 Array.prototype.map ( callback [ , thisArg ] )
callback は3つの引数を受け取る関数であるべきです。mapは配列内の各要素について昇順に callback を1回ずつ呼び出し、その結果から新しいArrayを構築します。callback は実際に存在する配列要素についてのみ呼び出されます。配列の欠損要素については呼び出されません。
thisArg パラメーターが指定された場合、それは callback の各呼び出しの
callback は3つの引数、すなわち要素の値、要素のインデックス、および走査されているオブジェクトで呼び出されます。
mapは、それが呼び出されたオブジェクトを直接変更しませんが、callback の呼び出しによってそのオブジェクトが変更される可能性があります。
mapによって処理される要素の範囲は、callback の最初の呼び出しの前に設定されます。mapの呼び出しが開始された後に配列へ追加された要素は、callback によって訪問されません。配列の既存要素が変更された場合、callback に渡される値は、mapがその要素を訪問した時点の値になります。mapの呼び出しが開始された後、訪問される前に削除された要素は訪問されません。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 IsCallable (callback) がfalse の場合、TypeError 例外をスローする。- array を ?
ArraySpeciesCreate (obj, len) とする。 - k を 0 とする。
- k < len の間、繰り返す：
- propertyKey を !
ToString (𝔽 (k)) とする。 - kPresent を ?
HasProperty (obj, propertyKey) とする。 - kPresent が
true の場合、次を行う：- kValue を ?
Get (obj, propertyKey) とする。 - mappedValue を ?
Call (callback, thisArg, « kValue,𝔽 (k), obj ») とする。 - ?
CreateDataPropertyOrThrow (array, propertyKey, mappedValue) を実行する。
- kValue を ?
- k を k + 1 に設定する。
- propertyKey を !
- array を返す。
このメソッドは意図的に汎用です。その
23.1.3.22 Array.prototype.pop ( )
このメソッドは配列の最後の要素を削除し、それを返します。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 - len = 0 の場合、次を行う：
- ?
Set (obj,"length" ,+0 𝔽,true ) を実行する。 undefined を返す。
- ?
Assert : len > 0。- newLen を
𝔽 (len - 1) とする。 - index を !
ToString (newLen) とする。 - element を ?
Get (obj, index) とする。 - ?
DeletePropertyOrThrow (obj, index) を実行する。 - ?
Set (obj,"length" , newLen,true ) を実行する。 - element を返す。
このメソッドは意図的に汎用です。その
23.1.3.23 Array.prototype.push ( ...items )
このメソッドは、引数をそれらが現れる順序で配列の末尾に追加します。これは配列の新しい長さを返します。
このメソッドは呼び出されたとき、次の手順を実行します：
このメソッドの
このメソッドは意図的に汎用です。その
23.1.3.24 Array.prototype.reduce ( callback [ , initialValue ] )
callback は4つの引数を取る関数でなければならない。reduce は、配列内に存在する各要素について昇順で callback を1回ずつ呼び出す。ただし、initialValue が提供されていない場合は最初の要素をスキップする。
callback は4つの引数、すなわち previousValue（callback の前回の呼び出しからの値）、currentValue（現在の要素の値）、currentIndex、および走査されているオブジェクトで呼び出されます。callbackが初めて呼び出されるとき、previousValue と currentValue は2つの値のいずれかになります。reduceの呼び出しで initialValue が供給された場合、previousValue は initialValue となり、currentValue は配列の最初の値となります。initialValue が供給されなかった場合、previousValue は配列の最初の値となり、currentValue は2番目の値となります。配列が要素を含まず、initialValue が提供されていない場合、
reduceは、それが呼び出されたオブジェクトを直接変更しませんが、callback の呼び出しによってそのオブジェクトが変更される可能性があります。
reduceによって処理される要素の範囲は、callback の最初の呼び出しの前に設定されます。reduceの呼び出しが開始された後に配列へ追加された要素は、callback によって訪問されません。配列の既存要素が変更された場合、callback に渡される値は、reduceがその要素を訪問した時点の値になります。reduceの呼び出しが開始された後、訪問される前に削除された要素は訪問されません。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 IsCallable (callback) がfalse の場合、TypeError 例外をスローする。- len = 0 かつ initialValue が存在しない場合、
TypeError 例外をスローする。 - k を 0 とする。
- accumulator を
undefined とする。 - initialValue が存在する場合、次を行う：
- accumulator を initialValue に設定する。
- それ以外の場合、
- kPresent を
false とする。 - kPresent が
false かつ k < len の間、繰り返す：- propertyKey を !
ToString (𝔽 (k)) とする。 - kPresent を ?
HasProperty (obj, propertyKey) に設定する。 - kPresent が
true の場合、次を行う：- accumulator を ?
Get (obj, propertyKey) に設定する。
- accumulator を ?
- k を k + 1 に設定する。
- propertyKey を !
- kPresent が
false の場合、TypeError 例外をスローする。
- kPresent を
- k < len の間、繰り返す：
- accumulator を返す。
このメソッドは意図的に汎用です。その
23.1.3.25 Array.prototype.reduceRight ( callback [ , initialValue ] )
callback は4つの引数を取る関数でなければならない。reduceRight は、配列内に存在する各要素について降順で callback を1回ずつ呼び出す。ただし、initialValue が提供されていない場合は最初の呼び出しをスキップする。
callback は4つの引数、すなわち previousValue（callback の前回の呼び出しからの値）、currentValue（現在の要素の値）、currentIndex、および走査されているオブジェクトで呼び出されます。関数が初めて呼び出されるとき、previousValue と currentValue は2つの値のいずれかになります。reduceRightの呼び出しで initialValue が供給された場合、previousValue は initialValue となり、currentValue は配列の最後の値となります。initialValue が供給されなかった場合、previousValue は配列の最後の値となり、currentValue は最後から2番目の値となります。配列が要素を含まず、initialValue が提供されていない場合、
reduceRightは、それが呼び出されたオブジェクトを直接変更しませんが、callback の呼び出しによってそのオブジェクトが変更される可能性があります。
reduceRightによって処理される要素の範囲は、callback の最初の呼び出しの前に設定されます。reduceRightの呼び出しが開始された後に配列へ追加された要素は、callback によって訪問されません。配列の既存要素が callback によって変更された場合、callback に渡される値は、reduceRightがその要素を訪問した時点の値になります。reduceRightの呼び出しが開始された後、訪問される前に削除された要素は訪問されません。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 IsCallable (callback) がfalse の場合、TypeError 例外をスローする。- len = 0 かつ initialValue が存在しない場合、
TypeError 例外をスローする。 - k を len - 1 とする。
- accumulator を
undefined とする。 - initialValue が存在する場合、次を行う：
- accumulator を initialValue に設定する。
- それ以外の場合、
- kPresent を
false とする。 - kPresent が
false かつ k ≥ 0 の間、繰り返す：- propertyKey を !
ToString (𝔽 (k)) とする。 - kPresent を ?
HasProperty (obj, propertyKey) に設定する。 - kPresent が
true の場合、次を行う：- accumulator を ?
Get (obj, propertyKey) に設定する。
- accumulator を ?
- k を k - 1 に設定する。
- propertyKey を !
- kPresent が
false の場合、TypeError 例外をスローする。
- kPresent を
- k ≥ 0 の間、繰り返す：
- accumulator を返す。
このメソッドは意図的に汎用です。その
23.1.3.26 Array.prototype.reverse ( )
このメソッドは配列の要素を並べ替え、その順序を逆にします。これは反転された配列を返します。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 - middle を
floor (len / 2) とする。 - lower を 0 とする。
- lower ≠ middle の間、繰り返す：
- upper を len - 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 を返す。
このメソッドは意図的に汎用です。その
23.1.3.27 Array.prototype.shift ( )
このメソッドは配列の最初の要素を削除し、それを返します。
呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 - len = 0 の場合、次を行う：
- ?
Set (obj,"length" ,+0 𝔽,true ) を実行する。 undefined を返す。
- ?
- first を ?
Get (obj,"0" ) とする。 - k を 1 とする。
- k < len の間、繰り返す：
- 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 (𝔽 (len - 1))) を実行する。 - ?
Set (obj,"length" ,𝔽 (len - 1),true ) を実行する。 - first を返す。
このメソッドは意図的に汎用です。その
23.1.3.28 Array.prototype.slice ( start, end )
このメソッドは、要素 start から要素 end の直前まで（または end が
呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 - relativeStart を ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞ の場合、k を 0 とする。
- そうでなく relativeStart < 0 の場合、k を
max (len + relativeStart, 0) とする。 - それ以外の場合、k を
min (relativeStart, len) とする。 - end が
undefined の場合、relativeEnd を len とする。そうでない場合、relativeEnd を ?ToIntegerOrInfinity (end) とする。 - relativeEnd = -∞ の場合、final を 0 とする。
- そうでなく relativeEnd < 0 の場合、final を
max (len + relativeEnd, 0) とする。 - それ以外の場合、final を
min (relativeEnd, len) とする。 - count を
max (final - k, 0) とする。 - array を ?
ArraySpeciesCreate (obj, count) とする。 - resultIndex を 0 とする。
- k < final の間、繰り返す：
- propertyKey を !
ToString (𝔽 (k)) とする。 - kPresent を ?
HasProperty (obj, propertyKey) とする。 - kPresent が
true の場合、次を行う：- kValue を ?
Get (obj, propertyKey) とする。 - ?
CreateDataPropertyOrThrow (array, !ToString (𝔽 (resultIndex)), kValue) を実行する。
- kValue を ?
- k を k + 1 に設定する。
- resultIndex を resultIndex + 1 に設定する。
- propertyKey を !
- ?
Set (array,"length" ,𝔽 (resultIndex),true ) を実行する。 - array を返す。
ステップ
このメソッドは意図的に汎用です。その
23.1.3.29 Array.prototype.some ( callback [ , thisArg ] )
callback は3つの引数を受け取り、Boolean値に強制変換可能な値を返す関数であるべきです。someは、callback が someはただちに someは
thisArg パラメーターが指定された場合、それは callback の各呼び出しの
callback は3つの引数、すなわち要素の値、要素のインデックス、および走査されているオブジェクトで呼び出されます。
someは、それが呼び出されたオブジェクトを直接変更しませんが、callback の呼び出しによってそのオブジェクトが変更される可能性があります。
someによって処理される要素の範囲は、callback の最初の呼び出しの前に設定されます。someの呼び出しが開始された後に配列へ追加された要素は、callback によって訪問されません。配列の既存要素が変更された場合、callback に渡される値は、someがその要素を訪問した時点の値になります。someの呼び出しが開始された後、訪問される前に削除された要素は訪問されません。someは数学における「存在する」量化子のように動作します。特に、空の配列に対しては
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 IsCallable (callback) がfalse の場合、TypeError 例外をスローする。- k を 0 とする。
- k < len の間、繰り返す：
false を返す。
このメソッドは意図的に汎用です。その
23.1.3.30 Array.prototype.sort ( comparator )
このメソッドは、この配列の要素をソートします。comparator が
呼び出されたとき、次の手順を実行します：
- comparator が
undefined でなく、かつIsCallable (comparator) がfalse の場合、TypeError 例外をスローする。 - obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 - sortCompare を、comparator を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (x, y) を持つ新しい
Abstract Closure とする：- ?
CompareArrayElements (x, y, comparator) を返す。
- ?
- sortedList を ?
SortIndexedProperties (obj, len, sortCompare,skip-holes ) とする。 - itemCount を sortedList 内の要素数とする。
- j を 0 とする。
- j < itemCount の間、繰り返す：
NOTE : ステップ5 におけるSortIndexedProperties の呼び出しはskip-holes を使用する。残りのインデックスは、検出されソートから除外された穴の数を保持するために削除される。- j < len の間、繰り返す：
- ?
DeletePropertyOrThrow (obj, !ToString (𝔽 (j))) を実行する。 - j を j + 1 に設定する。
- ?
- obj を返す。
存在しないプロパティ値は常に
このメソッドは意図的に汎用です。その
23.1.3.30.1 SortIndexedProperties ( obj, len, sortCompare, holes )
The
- items を新しい空の
List とする。 - k を 0 とする。
- k < len の間、繰り返す：
- 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 に追加する。
- kValue を ?
- k を k + 1 に設定する。
- propertyKey を !
- 実装定義の sortCompare への呼び出し の列を使用して items をソートする。そのような呼び出しのいずれかが急な完了を返す場合、sortCompare へのそれ以降の呼び出しを実行する前に停止し、その
Completion Record を返す。 - items を返す。
ソート順は、上記アルゴリズムのステップ
-
itemCount 未満の非負整数のある数学的置換 π が存在し、itemCount 未満のすべての非負整数 j について、要素
old[j] がnew[π(j)] とまったく同一でなければならない。 -
さらに、itemCount 未満のすべての非負整数 j および k について、
ℝ (sortCompare(old[j], old[k])) < 0π(j) < π(k) でなければならない。 -
かつ、j < k < itemCount であるすべての非負整数 j および k について、
ℝ (sortCompare(old[j], old[k])) = 0π(j) < π(k) でなければならない。すなわち、ソートは安定である。
ここで、表記
-
comparator(a, b) の呼び出しは、2つの引数として特定の値の組 a と b が与えられたとき、常に同じ値 v を返す。さらに、v はNumberであり、v は
NaN でない。これは、与えられた a と b の組について、a <C b、a =C b、および a >C b のちょうど1つがtrueになることを意味することに注意。 - comparator(a, b) の呼び出しは、obj または obj のプロトタイプチェーン上のどのオブジェクトも変更しない。
- a =C a（反射律）
- a =C b ならば、b =C a（対称律）
- a =C b かつ b =C c ならば、a =C c（=C の推移律）
- a <C b かつ b <C c ならば、a <C c（<C の推移律）
- a >C b かつ b >C c ならば、a >C c（>C の推移律）
上記の条件は、comparator が集合 values を同値類に分割し、これらの同値類が全順序付けされることを確保するために必要十分です。
23.1.3.30.2 CompareArrayElements ( x, y, comparator )
The
- 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 )
このメソッドは、整数インデックス start から始まる配列の deleteCount 個の要素を削除し、それらを items の要素で置き換えます。これは削除された要素（存在する場合）を含むArrayを返します。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 - relativeStart を ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞ の場合、actualStart を 0 とする。
- そうでなく relativeStart < 0 の場合、actualStart を
max (len + relativeStart, 0) とする。 - それ以外の場合、actualStart を
min (relativeStart, len) とする。 - itemCount を items 内の要素数とする。
- start が存在しない場合、次を行う：
- actualDeleteCount を 0 とする。
- そうでなく deleteCount が存在しない場合、次を行う：
- actualDeleteCount を len - actualStart とする。
- それ以外の場合、
- dc を ?
ToIntegerOrInfinity (deleteCount) とする。 - actualDeleteCount を、dc を0と len - actualStart の間にクランプした結果とする。
- dc を ?
- len + itemCount - actualDeleteCount > 253 - 1 の場合、
TypeError 例外をスローする。 - deletedArray を ?
ArraySpeciesCreate (obj, actualDeleteCount) とする。 - k を 0 とする。
- k < actualDeleteCount の間、繰り返す：
- from を !
ToString (𝔽 (actualStart + k)) とする。 - ?
HasProperty (obj, from) がtrue の場合、次を行う：- fromValue を ?
Get (obj, from) とする。 - ?
CreateDataPropertyOrThrow (deletedArray, !ToString (𝔽 (k)), fromValue) を実行する。
- fromValue を ?
- k を k + 1 に設定する。
- from を !
- ?
Set (deletedArray,"length" ,𝔽 (actualDeleteCount),true ) を実行する。 - itemCount < actualDeleteCount の場合、次を行う：
- k を actualStart に設定する。
- k < (len - actualDeleteCount) の間、繰り返す：
- from を !
ToString (𝔽 (k + actualDeleteCount)) とする。 - to を !
ToString (𝔽 (k + itemCount)) とする。 - ?
HasProperty (obj, from) がtrue の場合、次を行う： - それ以外の場合、
- ?
DeletePropertyOrThrow (obj, to) を実行する。
- ?
- k を k + 1 に設定する。
- from を !
- k を len に設定する。
- k > (len - actualDeleteCount + itemCount) の間、繰り返す：
- ?
DeletePropertyOrThrow (obj, !ToString (𝔽 (k - 1))) を実行する。 - k を k - 1 に設定する。
- ?
- そうでなく itemCount > actualDeleteCount の場合、次を行う：
- k を (len - 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" ,𝔽 (len - actualDeleteCount + itemCount),true ) を実行する。 - deletedArray を返す。
このメソッドは意図的に汎用です。その
23.1.3.32 Array.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
ECMA-402 Internationalization APIを含むECMAScript実装は、このメソッドをECMA-402仕様で指定されるとおりに実装しなければなりません。ECMAScript実装がECMA-402 APIを含まない場合、このメソッドについて以下の仕様が使用されます。
ECMA-402の第1版には、このメソッドの代替仕様は含まれていませんでした。
このメソッドの任意パラメーターの意味はECMA-402仕様で定義されます。ECMA-402サポートを含まない実装は、これらのパラメーター位置を他の目的に使用してはなりません。
このメソッドは呼び出されたとき、次の手順を実行します：
- array を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (array) とする。 - separator を、ホスト環境の現在のロケールに適した実装定義のリストセパレーターString値（例えば
", " ）とする。 - result を空のStringとする。
- k を 0 とする。
- k < len の間、繰り返す：
- result を返す。
このメソッドは、配列の要素をそれぞれのtoLocaleStringメソッドを使用してStringに変換し、その後、実装定義のロケール依存セパレーターStringの出現で区切ってこれらのStringを連結します。このメソッドはtoStringに類似していますが、ホスト環境の現在のロケールの慣習に対応するロケール依存の結果を生成することを意図している点が異なります。
このメソッドは意図的に汎用です。その
23.1.3.33 Array.prototype.toReversed ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 - array を ?
ArrayCreate (len) とする。 - k を 0 とする。
- k < len の間、繰り返す：
- array を返す。
23.1.3.34 Array.prototype.toSorted ( comparator )
このメソッドは呼び出されたとき、次の手順を実行します：
- comparator が
undefined でなく、かつIsCallable (comparator) がfalse の場合、TypeError 例外をスローする。 - obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 - array を ?
ArrayCreate (len) とする。 - sortCompare を、comparator を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (x, y) を持つ新しい
Abstract Closure とする：- ?
CompareArrayElements (x, y, comparator) を返す。
- ?
- sortedList を ?
SortIndexedProperties (obj, len, sortCompare,read-through-holes ) とする。 - j を 0 とする。
- j < len の間、繰り返す：
- !
CreateDataPropertyOrThrow (array, !ToString (𝔽 (j)), sortedList[j]) を実行する。 - j を j + 1 に設定する。
- !
- array を返す。
23.1.3.35 Array.prototype.toSpliced ( start, skipCount, ...items )
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 - relativeStart を ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞ の場合、actualStart を 0 とする。
- そうでなく relativeStart < 0 の場合、actualStart を
max (len + relativeStart, 0) とする。 - それ以外の場合、actualStart を
min (relativeStart, len) とする。 - insertCount を items 内の要素数とする。
- start が存在しない場合、次を行う：
- actualSkipCount を 0 とする。
- そうでなく skipCount が存在しない場合、次を行う：
- actualSkipCount を len - actualStart とする。
- それ以外の場合、
- sc を ?
ToIntegerOrInfinity (skipCount) とする。 - actualSkipCount を、sc を0と len - actualStart の間にクランプした結果とする。
- sc を ?
- newLen を len + insertCount - actualSkipCount とする。
- newLen > 253 - 1 の場合、
TypeError 例外をスローする。 - newArray を ?
ArrayCreate (newLen) とする。 - 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 < newLen の間、繰り返す：
- newArray を返す。
23.1.3.36 Array.prototype.toString ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- array を ?
ToObject (this 値) とする。 - func を ?
Get (array,"join" ) とする。 IsCallable (func) がfalse の場合、func を組み込み関数 %Object.prototype.toString% に設定する。- ?
Call (func, array) を返す。
このメソッドは意図的に汎用です。その
23.1.3.37 Array.prototype.unshift ( ...items )
このメソッドは、引数リストに現れる順序と同じ順序で配列内に配置されるように、引数を配列の先頭に追加します。
呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 - argCount を items 内の要素数とする。
- argCount > 0 の場合、次を行う：
- len + argCount > 253 - 1 の場合、
TypeError 例外をスローする。 - k を len とする。
- 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 について、次を行う：
- len + argCount > 253 - 1 の場合、
- ?
Set (obj,"length" ,𝔽 (len + argCount),true ) を実行する。 𝔽 (len + argCount) を返す。
このメソッドの
このメソッドは意図的に汎用です。その
23.1.3.38 Array.prototype.values ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 CreateArrayIterator (obj,value ) を返す。
23.1.3.39 Array.prototype.with ( index, value )
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を ?
ToObject (this 値) とする。 - len を ?
LengthOfArrayLike (obj) とする。 - relativeIndex を ?
ToIntegerOrInfinity (index) とする。 - relativeIndex ≥ 0 の場合、actualIndex を relativeIndex とする。
- それ以外の場合、actualIndex を len + relativeIndex とする。
- actualIndex ≥ len または actualIndex < 0 の場合、
RangeError 例外をスローする。 - array を ?
ArrayCreate (len) とする。 - k を 0 とする。
- k < len の間、繰り返す：
- propertyKey を !
ToString (𝔽 (k)) とする。 - k = actualIndex の場合、fromValue を value とする。
- それ以外の場合、fromValue を ?
Get (obj, propertyKey) とする。 - !
CreateDataPropertyOrThrow (array, propertyKey, fromValue) を実行する。 - k を k + 1 に設定する。
- propertyKey を !
- array を返す。
23.1.3.40 Array.prototype [ %Symbol.iterator% ] ( )
23.1.3.41 Array.prototype [ %Symbol.unscopables% ]
- unscopableList を
OrdinaryObjectCreate (null ) とする。 - !
CreateDataPropertyOrThrow (unscopableList,"at" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"copyWithin" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"entries" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"fill" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"find" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"findIndex" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"findLast" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"findLastIndex" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"flat" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"flatMap" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"includes" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"keys" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"toReversed" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"toSorted" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"toSpliced" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (unscopableList,"values" ,true ) を実行する。 - unscopableList を返す。
このプロパティの属性は { [[Writable]]:
このオブジェクトの独自プロパティ名は、ECMAScript 2015仕様より前にArray.prototypeの標準プロパティとして含まれていなかったプロパティ名です。これらの名前は、Arrayである束縛オブジェクトを持つwith文によって隠蔽される外側のスコープ内の束縛として既存のコードがこれらの名前の1つを使用している可能性があるため、with文の束縛目的では無視されます。
23.1.4 Arrayインスタンスのプロパティ
ArrayインスタンスはArray
Arrayインスタンスは
23.1.4.1 length
Arrayインスタンスの
23.1.5 Array Iteratorオブジェクト
Array Iterator は、ある特定のArrayインスタンスオブジェクトに対する特定の反復を表すオブジェクトです。Array Iteratorオブジェクトには名前付きコンストラクターはありません。代わりに、Array IteratorオブジェクトはArrayインスタンスオブジェクトの特定のメソッドを呼び出すことによって作成されます。
23.1.5.1 CreateArrayIterator ( array, kind )
The
- iterator を
OrdinaryObjectCreate (%ArrayIteratorPrototype% , « [[IteratedArrayLike]], [[ArrayLikeNextIndex]], [[ArrayLikeIterationKind]] ») とする。 - iterator.[[IteratedArrayLike]] を array に設定する。
- iterator.[[ArrayLikeNextIndex]] を 0 に設定する。
- iterator.[[ArrayLikeIterationKind]] を kind に設定する。
- iterator を返す。
23.1.5.2 %ArrayIteratorPrototype%オブジェクト
%ArrayIteratorPrototype%オブジェクトは以下の通りです：
- すべての
Array Iterator オブジェクトによって継承されるプロパティを持つ。 - 通常のオブジェクトである。
- [[Prototype]]内部スロットを持ち、その値は
%Iterator.prototype% である。 - 以下のプロパティを持つ：
23.1.5.2.1 %ArrayIteratorPrototype%.next ( )
- iteratorObj を
this 値とする。 - iteratorObj がObjectでない場合、
TypeError 例外をスローする。 - iteratorObj が
Array Iterator インスタンスのすべての内部スロット（23.1.5.3 ）を持たない場合、TypeError 例外をスローする。 - array を iteratorObj.[[IteratedArrayLike]] とする。
- array が
undefined の場合、CreateIteratorResultObject (undefined ,true ) を返す。 - index を iteratorObj.[[ArrayLikeNextIndex]] とする。
- kind を iteratorObj.[[ArrayLikeIterationKind]] とする。
- array が [[TypedArrayName]] 内部スロットを持つ場合、次を行う：
- taRecord を
MakeTypedArrayWithBufferWitnessRecord (array,seq-cst ) とする。 IsTypedArrayOutOfBounds (taRecord) がtrue の場合、TypeError 例外をスローする。- len を
TypedArrayLength (taRecord) とする。
- taRecord を
- それ以外の場合、
- len を ?
LengthOfArrayLike (array) とする。
- len を ?
- index ≥ len の場合、次を行う：
- 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% ]
このプロパティの属性は { [[Writable]]:
23.1.5.3 Array Iteratorインスタンスのプロパティ
| 内部スロット | 型 | 説明 |
|---|---|---|
| [[IteratedArrayLike]] |
Objectまたは |
反復されている |
| [[ArrayLikeNextIndex]] | 非負整数 | このイテレーターによって次に調べられる要素の整数インデックス。 |
| [[ArrayLikeIterationKind]] |
|
反復の各要素について返されるものを識別する値。 |
23.2 TypedArrayオブジェクト
TypedArray は、基底となるバイナリデータバッファ（
| コンストラクター名およびIntrinsic | 要素型 | 要素サイズ | 変換操作 | 説明 |
|---|---|---|---|---|
|
Int8Array %Int8Array% |
|
1 |
|
8ビット2の補数符号付き整数 |
|
Uint8Array %Uint8Array% |
|
1 |
|
8ビット符号なし整数 |
|
Uint8ClampedArray %Uint8ClampedArray% |
|
1 |
|
8ビット符号なし整数（クランプ変換） |
|
Int16Array %Int16Array% |
|
2 |
|
16ビット2の補数符号付き整数 |
|
Uint16Array %Uint16Array% |
|
2 |
|
16ビット符号なし整数 |
|
Int32Array %Int32Array% |
|
4 |
|
32ビット2の補数符号付き整数 |
|
Uint32Array %Uint32Array% |
|
4 |
|
32ビット符号なし整数 |
|
BigInt64Array %BigInt64Array% |
|
8 |
|
64ビット2の補数符号付き整数 |
|
BigUint64Array %BigUint64Array% |
|
8 |
|
64ビット符号なし整数 |
|
Float16Array %Float16Array% |
|
2 | 16ビットIEEE浮動小数点 | |
|
Float32Array %Float32Array% |
|
4 | 32ビットIEEE浮動小数点 | |
|
Float64Array %Float64Array% |
|
8 | 64ビットIEEE浮動小数点 |
以下の定義では、TypedArray への参照は、上の表の適切なコンストラクター名に置き換えられるべきです。
23.2.1 %TypedArray% Intrinsicオブジェクト
%TypedArray% intrinsicオブジェクトは以下の通りです：
- すべての TypedArray コンストラクターオブジェクトが継承するコンストラクター関数オブジェクトである。
- 対応するプロトタイプオブジェクトとともに、すべての TypedArray コンストラクターおよびそのインスタンスによって継承される共通プロパティを提供する。
- グローバル名を持たず、
グローバルオブジェクト のプロパティとして現れない。 - 各種 TypedArray コンストラクターの抽象スーパークラスとして機能する。
- 抽象クラスコンストラクターであるため、呼び出されるとエラーをスローする。TypedArray コンストラクターはこれに対する
super呼び出しを実行しない。
23.2.1.1 %TypedArray% ( )
この関数は呼び出されたとき、次の手順を実行します：
TypeError 例外をスローする。
この関数の
23.2.2 %TypedArray% Intrinsicオブジェクトのプロパティ
- [[Prototype]]内部スロットを持ち、その値は
%Function.prototype% である。 - 値が
"TypedArray" である"name" プロパティを持つ。 - 以下のプロパティを持つ：
23.2.2.1 %TypedArray%.from ( source [ , mapper [ , thisArg ] ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- constructor を
this 値とする。 IsConstructor (constructor) がfalse の場合、TypeError 例外をスローする。- mapper が
undefined の場合、次を行う：- mapping を
false とする。
- mapping を
- それ以外の場合、
IsCallable (mapper) がfalse の場合、TypeError 例外をスローする。- mapping を
true とする。
- usingIterator を ?
GetMethod (source,%Symbol.iterator% ) とする。 - usingIterator が
undefined でない場合、次を行う：- values を ?
IteratorToList (?GetIteratorFromMethod (source, usingIterator)) とする。 - len を values 内の要素数とする。
- targetObj を ?
TypedArrayCreateFromConstructor (constructor, «𝔽 (len) ») とする。 - k を 0 とする。
- k < len の間、繰り返す：
Assert : values は今や空のList である。- targetObj を返す。
- values を ?
NOTE : source はiterable object でないため、すでにarray-like object であると仮定する。- arrayLike を !
ToObject (source) とする。 - len を ?
LengthOfArrayLike (arrayLike) とする。 - targetObj を ?
TypedArrayCreateFromConstructor (constructor, «𝔽 (len) ») とする。 - k を 0 とする。
- k < len の間、繰り返す：
- targetObj を返す。
23.2.2.2 %TypedArray%.of ( ...items )
このメソッドは呼び出されたとき、次の手順を実行します：
- len を items 内の要素数とする。
- constructor を
this 値とする。 IsConstructor (constructor) がfalse の場合、TypeError 例外をスローする。- newObj を ?
TypedArrayCreateFromConstructor (constructor, «𝔽 (len) ») とする。 - k を 0 とする。
- k < len の間、繰り返す：
- newObj を返す。
23.2.2.3 %TypedArray%.prototype
.prototypeの初期値は
このプロパティの属性は { [[Writable]]:
23.2.2.4 get %TypedArray% [ %Symbol.species% ]
[%Symbol.species%]は、setアクセサー関数が
this 値を返す。
この関数の
23.2.3 %TypedArray%プロトタイプオブジェクトのプロパティ
%TypedArray%プロトタイプオブジェクトは以下の通りです：
- [[Prototype]]内部スロットを持ち、その値は
%Object.prototype% である。 - %TypedArray.prototype%である。
- 通常のオブジェクトである。
- [[ViewedArrayBuffer]]、または TypedArray インスタンスオブジェクトに固有のその他の内部スロットを持たない。
23.2.3.1 %TypedArray%.prototype.at ( index )
- obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - relativeIndex を ?
ToIntegerOrInfinity (index) とする。 - relativeIndex ≥ 0 の場合、次を行う：
- k を relativeIndex とする。
- それ以外の場合、
- k を len + relativeIndex とする。
- k < 0 または k ≥ len の場合、
undefined を返す。 - !
Get (obj, !ToString (𝔽 (k))) を返す。
23.2.3.2 get %TypedArray%.prototype.buffer
.prototype.bufferは、setアクセサー関数が
- obj を
this 値とする。 - ?
RequireInternalSlot (obj, [[TypedArrayName]]) を実行する。 Assert : obj は [[ViewedArrayBuffer]] 内部スロットを持つ。- buffer を obj.[[ViewedArrayBuffer]] とする。
- buffer を返す。
23.2.3.3 get %TypedArray%.prototype.byteLength
.prototype.byteLengthは、setアクセサー関数が
- obj を
this 値とする。 - ?
RequireInternalSlot (obj, [[TypedArrayName]]) を実行する。 Assert : obj は [[ViewedArrayBuffer]] 内部スロットを持つ。- taRecord を
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst ) とする。 IsTypedArrayOutOfBounds (taRecord) がtrue の場合、+0 𝔽 を返す。- size を
TypedArrayByteLength (taRecord) とする。 𝔽 (size) を返す。
23.2.3.4 get %TypedArray%.prototype.byteOffset
.prototype.byteOffsetは、setアクセサー関数が
- obj を
this 値とする。 - ?
RequireInternalSlot (obj, [[TypedArrayName]]) を実行する。 Assert : obj は [[ViewedArrayBuffer]] 内部スロットを持つ。- taRecord を
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst ) とする。 IsTypedArrayOutOfBounds (taRecord) がtrue の場合、+0 𝔽 を返す。- offset を obj.[[ByteOffset]] とする。
𝔽 (offset) を返す。
23.2.3.5 %TypedArray%.prototype.constructor
.prototype.constructorの初期値は
23.2.3.6 %TypedArray%.prototype.copyWithin ( target, start [ , end ] )
このメソッドの引数の解釈および使用方法は、Array.prototype.copyWithin と同じです。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - relativeTarget を ?
ToIntegerOrInfinity (target) とする。 - relativeTarget = -∞ の場合、targetIndex を 0 とする。
- そうでなく relativeTarget < 0 の場合、targetIndex を
max (len + relativeTarget, 0) とする。 - それ以外の場合、targetIndex を
min (relativeTarget, len) とする。 - relativeStart を ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞ の場合、startIndex を 0 とする。
- そうでなく relativeStart < 0 の場合、startIndex を
max (len + relativeStart, 0) とする。 - それ以外の場合、startIndex を
min (relativeStart, len) とする。 - end が
undefined の場合、relativeEnd を len とする。そうでない場合、relativeEnd を ?ToIntegerOrInfinity (end) とする。 - relativeEnd = -∞ の場合、endIndex を 0 とする。
- そうでなく relativeEnd < 0 の場合、endIndex を
max (len + relativeEnd, 0) とする。 - それ以外の場合、endIndex を
min (relativeEnd, len) とする。 - count を
min (endIndex - startIndex, len - targetIndex) とする。 - count > 0 の場合、次を行う：
NOTE : コピーは、ソースデータのビットレベル符号化を保持する方法で実行されなければならない。- buffer を obj.[[ViewedArrayBuffer]] とする。
- taRecord を
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst ) に設定する。 IsTypedArrayOutOfBounds (taRecord) がtrue の場合、TypeError 例外をスローする。- len を
TypedArrayLength (taRecord) に設定する。 NOTE : 上記の手順の副作用により obj のサイズが縮小されている可能性がある。その場合、コピーは依然として適用可能な最長の接頭辞で進めるべきである。- count を
min (count, len - startIndex, len - targetIndex) に設定する。 - elementSize を
TypedArrayElementSize (obj) とする。 - byteOffset を obj.[[ByteOffset]] とする。
- toByteIndex を (targetIndex × elementSize) + byteOffset とする。
- fromByteIndex を (startIndex × elementSize) + byteOffset とする。
- countBytes を count × elementSize とする。
- fromByteIndex < toByteIndex かつ toByteIndex < fromByteIndex + countBytes の場合、次を行う：
- direction を -1 とする。
- fromByteIndex を fromByteIndex + countBytes - 1 に設定する。
- toByteIndex を toByteIndex + countBytes - 1 に設定する。
- それ以外の場合、
- direction を 1 とする。
- countBytes > 0 の間、繰り返す：
- value を
GetValueFromBuffer (buffer, fromByteIndex,uint8 ,true ,unordered ) とする。 SetValueInBuffer (buffer, toByteIndex,uint8 , value,true ,unordered ) を実行する。- fromByteIndex を fromByteIndex + direction に設定する。
- toByteIndex を toByteIndex + direction に設定する。
- countBytes を countBytes - 1 に設定する。
- value を
- obj を返す。
23.2.3.7 %TypedArray%.prototype.entries ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - ?
ValidateTypedArray (obj,seq-cst ) を実行する。 CreateArrayIterator (obj,key+value ) を返す。
23.2.3.8 %TypedArray%.prototype.every ( callback [ , thisArg ] )
このメソッドの引数の解釈および使用方法は、Array.prototype.every と同じです。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 IsCallable (callback) がfalse の場合、TypeError 例外をスローする。- k を 0 とする。
- k < len の間、繰り返す：
true を返す。
このメソッドは汎用ではありません。
23.2.3.9 %TypedArray%.prototype.fill ( value [ , start [ , end ] ] )
このメソッドの引数の解釈および使用方法は、Array.prototype.fill と同じです。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - obj.[[ContentType]] が
bigint である場合、value を ?ToBigInt (value) に設定する。 - それ以外の場合、value を ?
ToNumber (value) に設定する。 - relativeStart を ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞ の場合、startIndex を 0 とする。
- そうでなく relativeStart < 0 の場合、startIndex を
max (len + relativeStart, 0) とする。 - それ以外の場合、startIndex を
min (relativeStart, len) とする。 - end が
undefined の場合、relativeEnd を len とする。そうでない場合、relativeEnd を ?ToIntegerOrInfinity (end) とする。 - relativeEnd = -∞ の場合、endIndex を 0 とする。
- そうでなく relativeEnd < 0 の場合、endIndex を
max (len + relativeEnd, 0) とする。 - それ以外の場合、endIndex を
min (relativeEnd, len) とする。 - taRecord を
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst ) に設定する。 IsTypedArrayOutOfBounds (taRecord) がtrue の場合、TypeError 例外をスローする。- len を
TypedArrayLength (taRecord) に設定する。 - endIndex を
min (endIndex, len) に設定する。 - k を startIndex とする。
- k < endIndex の間、繰り返す：
- obj を返す。
23.2.3.10 %TypedArray%.prototype.filter ( callback [ , thisArg ] )
このメソッドの引数の解釈および使用方法は、Array.prototype.filter と同じです。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 IsCallable (callback) がfalse の場合、TypeError 例外をスローする。- kept を新しい空の
List とする。 - captured を 0 とする。
- k を 0 とする。
- k < len の間、繰り返す：
- resultTypedArray を ?
TypedArraySpeciesCreate (obj, «𝔽 (captured) ») とする。 - n を 0 とする。
- kept の各要素 e について、次を行う：
- resultTypedArray を返す。
このメソッドは汎用ではありません。
23.2.3.11 %TypedArray%.prototype.find ( predicate [ , thisArg ] )
このメソッドの引数の解釈および使用方法は、Array.prototype.find と同じです。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - findRec を ?
FindViaPredicate (obj, len,ascending , predicate, thisArg) とする。 - findRec.[[Value]] を返す。
このメソッドは汎用ではありません。
23.2.3.12 %TypedArray%.prototype.findIndex ( predicate [ , thisArg ] )
このメソッドの引数の解釈および使用方法は、Array.prototype.findIndex と同じです。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - findRec を ?
FindViaPredicate (obj, len,ascending , predicate, thisArg) とする。 - findRec.[[Index]] を返す。
このメソッドは汎用ではありません。
23.2.3.13 %TypedArray%.prototype.findLast ( predicate [ , thisArg ] )
このメソッドの引数の解釈および使用方法は、Array.prototype.findLast と同じです。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - findRec を ?
FindViaPredicate (obj, len,descending , predicate, thisArg) とする。 - findRec.[[Value]] を返す。
このメソッドは汎用ではありません。
23.2.3.14 %TypedArray%.prototype.findLastIndex ( predicate [ , thisArg ] )
このメソッドの引数の解釈および使用方法は、Array.prototype.findLastIndex と同じです。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - findRec を ?
FindViaPredicate (obj, len,descending , predicate, thisArg) とする。 - findRec.[[Index]] を返す。
このメソッドは汎用ではありません。
23.2.3.15 %TypedArray%.prototype.forEach ( callback [ , thisArg ] )
このメソッドの引数の解釈および使用方法は、Array.prototype.forEach と同じです。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 IsCallable (callback) がfalse の場合、TypeError 例外をスローする。- k を 0 とする。
- k < len の間、繰り返す：
undefined を返す。
このメソッドは汎用ではありません。
23.2.3.16 %TypedArray%.prototype.includes ( searchElement [ , fromIndex ] )
このメソッドの引数の解釈および使用方法は、Array.prototype.includes と同じです。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - len = 0 の場合、
false を返す。 - n を ?
ToIntegerOrInfinity (fromIndex) とする。 Assert : fromIndex がundefined の場合、n は 0 である。- n = +∞ の場合、
false を返す。 - n = -∞ の場合、n を 0 に設定する。
- n ≥ 0 の場合、次を行う：
- k を n とする。
- それ以外の場合、
- k を len + n とする。
- k < 0 の場合、k を 0 に設定する。
- k < len の間、繰り返す：
- elementK を !
Get (obj, !ToString (𝔽 (k))) とする。 SameValueZero (searchElement, elementK) がtrue の場合、true を返す。- k を k + 1 に設定する。
- elementK を !
false を返す。
このメソッドは汎用ではありません。
23.2.3.17 %TypedArray%.prototype.indexOf ( searchElement [ , fromIndex ] )
このメソッドの引数の解釈および使用方法は、Array.prototype.indexOf と同じです。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - len = 0 の場合、
-1 𝔽 を返す。 - n を ?
ToIntegerOrInfinity (fromIndex) とする。 Assert : fromIndex がundefined の場合、n は 0 である。- n = +∞ の場合、
-1 𝔽 を返す。 - n = -∞ の場合、n を 0 に設定する。
- n ≥ 0 の場合、次を行う：
- k を n とする。
- それ以外の場合、
- k を len + n とする。
- k < 0 の場合、k を 0 に設定する。
- k < len の間、繰り返す：
- propertyKey を !
ToString (𝔽 (k)) とする。 - kPresent を !
HasProperty (obj, propertyKey) とする。 - kPresent が
true の場合、次を行う：- elementK を !
Get (obj, propertyKey) とする。 IsStrictlyEqual (searchElement, elementK) がtrue の場合、𝔽 (k) を返す。
- elementK を !
- k を k + 1 に設定する。
- propertyKey を !
-1 𝔽 を返す。
このメソッドは汎用ではありません。
23.2.3.18 %TypedArray%.prototype.join ( separator )
このメソッドの引数の解釈および使用方法は、Array.prototype.join と同じです。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - separator が
undefined の場合、sep を"," とする。 - それ以外の場合、sep を ?
ToString (separator) とする。 - result を空のStringとする。
- k を 0 とする。
- k < len の間、繰り返す：
- result を返す。
このメソッドは汎用ではありません。
23.2.3.19 %TypedArray%.prototype.keys ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - ?
ValidateTypedArray (obj,seq-cst ) を実行する。 CreateArrayIterator (obj,key ) を返す。
23.2.3.20 %TypedArray%.prototype.lastIndexOf ( searchElement [ , fromIndex ] )
このメソッドの引数の解釈および使用方法は、Array.prototype.lastIndexOf と同じです。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - len = 0 の場合、
-1 𝔽 を返す。 - fromIndex が存在する場合、n を ?
ToIntegerOrInfinity (fromIndex) とする。そうでない場合、n を len - 1 とする。 - n = -∞ の場合、
-1 𝔽 を返す。 - n ≥ 0 の場合、次を行う：
- k を
min (n, len - 1) とする。
- k を
- それ以外の場合、
- k を len + n とする。
- k ≥ 0 の間、繰り返す：
- propertyKey を !
ToString (𝔽 (k)) とする。 - kPresent を !
HasProperty (obj, propertyKey) とする。 - kPresent が
true の場合、次を行う：- elementK を !
Get (obj, propertyKey) とする。 IsStrictlyEqual (searchElement, elementK) がtrue の場合、𝔽 (k) を返す。
- elementK を !
- k を k - 1 に設定する。
- propertyKey を !
-1 𝔽 を返す。
このメソッドは汎用ではありません。
23.2.3.21 get %TypedArray%.prototype.length
.prototype.lengthは、setアクセサー関数が
- obj を
this 値とする。 - ?
RequireInternalSlot (obj, [[TypedArrayName]]) を実行する。 Assert : obj は [[ViewedArrayBuffer]] および [[ArrayLength]] 内部スロットを持つ。- taRecord を
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst ) とする。 IsTypedArrayOutOfBounds (taRecord) がtrue の場合、+0 𝔽 を返す。- length を
TypedArrayLength (taRecord) とする。 𝔽 (length) を返す。
この関数は汎用ではありません。
23.2.3.22 %TypedArray%.prototype.map ( callback [ , thisArg ] )
このメソッドの引数の解釈および使用方法は、Array.prototype.map と同じです。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 IsCallable (callback) がfalse の場合、TypeError 例外をスローする。- resultTypedArray を ?
TypedArraySpeciesCreate (obj, «𝔽 (len) ») とする。 - k を 0 とする。
- k < len の間、繰り返す：
- resultTypedArray を返す。
このメソッドは汎用ではありません。
23.2.3.23 %TypedArray%.prototype.reduce ( callback [ , initialValue ] )
このメソッドの引数の解釈および使用方法は、Array.prototype.reduce と同じです。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 IsCallable (callback) がfalse の場合、TypeError 例外をスローする。- len = 0 かつ initialValue が存在しない場合、
TypeError 例外をスローする。 - k を 0 とする。
- accumulator を
undefined とする。 - initialValue が存在する場合、次を行う：
- accumulator を initialValue に設定する。
- それ以外の場合、
- k < len の間、繰り返す：
- accumulator を返す。
このメソッドは汎用ではありません。
23.2.3.24 %TypedArray%.prototype.reduceRight ( callback [ , initialValue ] )
このメソッドの引数の解釈および使用方法は、Array.prototype.reduceRight と同じです。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 IsCallable (callback) がfalse の場合、TypeError 例外をスローする。- len = 0 かつ initialValue が存在しない場合、
TypeError 例外をスローする。 - k を len - 1 とする。
- accumulator を
undefined とする。 - initialValue が存在する場合、次を行う：
- accumulator を initialValue に設定する。
- それ以外の場合、
- k ≥ 0 の間、繰り返す：
- accumulator を返す。
このメソッドは汎用ではありません。
23.2.3.25 %TypedArray%.prototype.reverse ( )
このメソッドの引数の解釈および使用方法は、Array.prototype.reverse と同じです。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - middle を
floor (len / 2) とする。 - lower を 0 とする。
- lower ≠ middle の間、繰り返す：
- obj を返す。
このメソッドは汎用ではありません。
23.2.3.26 %TypedArray%.prototype.set ( source [ , offset ] )
このメソッドは、この TypedArray 内に複数の値を設定し、その値を source から読み取ります。詳細は source の型に基づいて異なります。省略可能な offset 値は、この TypedArray 内で値が書き込まれる最初の要素インデックスを示します。省略された場合、0であると仮定されます。
呼び出されたとき、次の手順を実行します：
- target を
this 値とする。 - ?
RequireInternalSlot (target, [[TypedArrayName]]) を実行する。 Assert : target は [[ViewedArrayBuffer]] 内部スロットを持つ。- targetOffset を ?
ToIntegerOrInfinity (offset) とする。 - targetOffset < 0 の場合、
RangeError 例外をスローする。 - source が [[TypedArrayName]] 内部スロットを持つObjectである場合、次を行う：
- ?
SetTypedArrayFromTypedArray (target, targetOffset, source) を実行する。
- ?
- それ以外の場合、
- ?
SetTypedArrayFromArrayLike (target, targetOffset, source) を実行する。
- ?
undefined を返す。
このメソッドは汎用ではありません。
23.2.3.26.1 SetTypedArrayFromArrayLike ( target, targetOffset, source )
The
- targetRecord を
MakeTypedArrayWithBufferWitnessRecord (target,seq-cst ) とする。 IsTypedArrayOutOfBounds (targetRecord) がtrue の場合、TypeError 例外をスローする。- targetLength を
TypedArrayLength (targetRecord) とする。 - src を ?
ToObject (source) とする。 - srcLength を ?
LengthOfArrayLike (src) とする。 - targetOffset = +∞ の場合、
RangeError 例外をスローする。 - srcLength + targetOffset > targetLength の場合、
RangeError 例外をスローする。 - k を 0 とする。
- k < srcLength の間、繰り返す：
- propertyKey を !
ToString (𝔽 (k)) とする。 - value を ?
Get (src, propertyKey) とする。 - targetIndex を
𝔽 (targetOffset + k) とする。 - ?
TypedArraySetElement (target, targetIndex, value) を実行する。 - k を k + 1 に設定する。
- propertyKey を !
unused を返す。
23.2.3.26.2 SetTypedArrayFromTypedArray ( target, targetOffset, source )
The
- targetBuffer を target.[[ViewedArrayBuffer]] とする。
- targetRecord を
MakeTypedArrayWithBufferWitnessRecord (target,seq-cst ) とする。 IsTypedArrayOutOfBounds (targetRecord) がtrue の場合、TypeError 例外をスローする。- targetLength を
TypedArrayLength (targetRecord) とする。 - srcBuffer を source.[[ViewedArrayBuffer]] とする。
- srcRecord を
MakeTypedArrayWithBufferWitnessRecord (source,seq-cst ) とする。 IsTypedArrayOutOfBounds (srcRecord) がtrue の場合、TypeError 例外をスローする。- srcLength を
TypedArrayLength (srcRecord) とする。 - targetType を
TypedArrayElementType (target) とする。 - targetElementSize を
TypedArrayElementSize (target) とする。 - targetByteOffset を target.[[ByteOffset]] とする。
- srcType を
TypedArrayElementType (source) とする。 - srcElementSize を
TypedArrayElementSize (source) とする。 - srcByteOffset を source.[[ByteOffset]] とする。
- targetOffset = +∞ の場合、
RangeError 例外をスローする。 - srcLength + targetOffset > targetLength の場合、
RangeError 例外をスローする。 - target.[[ContentType]] が source.[[ContentType]] でない場合、
TypeError 例外をスローする。 IsSharedArrayBuffer (srcBuffer) がtrue 、IsSharedArrayBuffer (targetBuffer) がtrue 、かつ srcBuffer.[[ArrayBufferData]] が targetBuffer.[[ArrayBufferData]] である場合、sameSharedArrayBuffer をtrue とする。そうでない場合、sameSharedArrayBuffer をfalse とする。SameValue (srcBuffer, targetBuffer) がtrue 、または sameSharedArrayBuffer がtrue の場合、次を行う：- srcByteLength を
TypedArrayByteLength (srcRecord) とする。 - srcBuffer を ?
CloneArrayBuffer (srcBuffer, srcByteOffset, srcByteLength) に設定する。 - srcByteIndex を 0 とする。
- srcByteLength を
- それ以外の場合、
- srcByteIndex を srcByteOffset とする。
- targetByteIndex を (targetOffset × targetElementSize) + targetByteOffset とする。
- limit を targetByteIndex + (targetElementSize × srcLength) とする。
- srcType が targetType である場合、次を行う：
NOTE : 転送は、ソースデータのビットレベル符号化を保持する方法で実行されなければならない。- targetByteIndex < limit の間、繰り返す：
- value を
GetValueFromBuffer (srcBuffer, srcByteIndex,uint8 ,true ,unordered ) とする。 SetValueInBuffer (targetBuffer, targetByteIndex,uint8 , value,true ,unordered ) を実行する。- srcByteIndex を srcByteIndex + 1 に設定する。
- targetByteIndex を targetByteIndex + 1 に設定する。
- value を
- それ以外の場合、
- targetByteIndex < limit の間、繰り返す：
- value を
GetValueFromBuffer (srcBuffer, srcByteIndex, srcType,true ,unordered ) とする。 SetValueInBuffer (targetBuffer, targetByteIndex, targetType, value,true ,unordered ) を実行する。- srcByteIndex を srcByteIndex + srcElementSize に設定する。
- targetByteIndex を targetByteIndex + targetElementSize に設定する。
- value を
- targetByteIndex < limit の間、繰り返す：
unused を返す。
23.2.3.27 %TypedArray%.prototype.slice ( start, end )
このメソッドの引数の解釈および使用方法は、Array.prototype.slice と同じです。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - srcArrayLength を
TypedArrayLength (taRecord) とする。 - relativeStart を ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞ の場合、startIndex を 0 とする。
- そうでなく relativeStart < 0 の場合、startIndex を
max (srcArrayLength + relativeStart, 0) とする。 - それ以外の場合、startIndex を
min (relativeStart, srcArrayLength) とする。 - end が
undefined の場合、relativeEnd を srcArrayLength とする。そうでない場合、relativeEnd を ?ToIntegerOrInfinity (end) とする。 - relativeEnd = -∞ の場合、endIndex を 0 とする。
- そうでなく relativeEnd < 0 の場合、endIndex を
max (srcArrayLength + relativeEnd, 0) とする。 - それ以外の場合、endIndex を
min (relativeEnd, srcArrayLength) とする。 - countBytes を
max (endIndex - startIndex, 0) とする。 - resultArray を ?
TypedArraySpeciesCreate (obj, «𝔽 (countBytes) ») とする。 - countBytes > 0 の場合、次を行う：
- taRecord を
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst ) に設定する。 IsTypedArrayOutOfBounds (taRecord) がtrue の場合、TypeError 例外をスローする。- endIndex を
min (endIndex,TypedArrayLength (taRecord)) に設定する。 - countBytes を
max (endIndex - startIndex, 0) に設定する。 - srcType を
TypedArrayElementType (obj) とする。 - targetType を
TypedArrayElementType (resultArray) とする。 - srcType が targetType である場合、次を行う：
NOTE : 転送は、ソースデータのビットレベル符号化を保持する方法で実行されなければならない。- srcBuffer を obj.[[ViewedArrayBuffer]] とする。
- targetBuffer を resultArray.[[ViewedArrayBuffer]] とする。
- elementSize を
TypedArrayElementSize (obj) とする。 - srcByteOffset を obj.[[ByteOffset]] とする。
- srcByteIndex を (startIndex × elementSize) + srcByteOffset とする。
- targetByteIndex を resultArray.[[ByteOffset]] とする。
- endByteIndex を targetByteIndex + (countBytes × elementSize) とする。
- targetByteIndex < endByteIndex の間、繰り返す：
- value を
GetValueFromBuffer (srcBuffer, srcByteIndex,uint8 ,true ,unordered ) とする。 SetValueInBuffer (targetBuffer, targetByteIndex,uint8 , value,true ,unordered ) を実行する。- srcByteIndex を srcByteIndex + 1 に設定する。
- targetByteIndex を targetByteIndex + 1 に設定する。
- value を
- それ以外の場合、
- taRecord を
- resultArray を返す。
このメソッドは汎用ではありません。
23.2.3.28 %TypedArray%.prototype.some ( callback [ , thisArg ] )
このメソッドの引数の解釈および使用方法は、Array.prototype.some と同じです。
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 IsCallable (callback) がfalse の場合、TypeError 例外をスローする。- k を 0 とする。
- k < len の間、繰り返す：
false を返す。
このメソッドは汎用ではありません。
23.2.3.29 %TypedArray%.prototype.sort ( comparator )
これは、以下に記述される場合を除き、Array.prototype.sort の要件と同じ要件を実装する個別のメソッドです。このメソッドの実装は、
このメソッドは汎用ではありません。
呼び出されたとき、次の手順を実行します：
- comparator が
undefined でなく、かつIsCallable (comparator) がfalse の場合、TypeError 例外をスローする。 - obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 NOTE : 次のclosureは、23.1.3.30 で使用される文字列比較ではなく数値比較を実行する。- sortCompare を、comparator を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (x, y) を持つ新しい
Abstract Closure とする：- ?
CompareTypedArrayElements (x, y, comparator) を返す。
- ?
- sortedList を ?
SortIndexedProperties (obj, len, sortCompare,read-through-holes ) とする。 - j を 0 とする。
- j < len の間、繰り返す：
- obj を返す。
23.2.3.30 %TypedArray%.prototype.subarray ( start, end )
このメソッドは、この TypedArray の要素型を要素型とし、この TypedArray のArrayBufferをArrayBufferとする新しい TypedArray を返し、start（包含）から end（排他）までの区間内の要素を参照します。start または end のいずれかが負である場合、それは先頭からではなく、配列の末尾からのインデックスを参照します。
呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - ?
RequireInternalSlot (obj, [[TypedArrayName]]) を実行する。 Assert : obj は [[ViewedArrayBuffer]] 内部スロットを持つ。- buffer を obj.[[ViewedArrayBuffer]] とする。
- srcRecord を
MakeTypedArrayWithBufferWitnessRecord (obj,seq-cst ) とする。 IsTypedArrayOutOfBounds (srcRecord) がtrue の場合、次を行う：- srcLength を 0 とする。
- それ以外の場合、
- srcLength を
TypedArrayLength (srcRecord) とする。
- srcLength を
- relativeStart を ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞ の場合、startIndex を 0 とする。
- そうでなく relativeStart < 0 の場合、startIndex を
max (srcLength + relativeStart, 0) とする。 - それ以外の場合、startIndex を
min (relativeStart, srcLength) とする。 - elementSize を
TypedArrayElementSize (obj) とする。 - srcByteOffset を obj.[[ByteOffset]] とする。
- beginByteOffset を srcByteOffset + (startIndex × elementSize) とする。
- obj.[[ArrayLength]] が
auto かつ end がundefined の場合、次を行う：- argumentsList を « buffer,
𝔽 (beginByteOffset) » とする。
- argumentsList を « buffer,
- それ以外の場合、
- end が
undefined の場合、relativeEnd を srcLength とする。そうでない場合、relativeEnd を ?ToIntegerOrInfinity (end) とする。 - relativeEnd = -∞ の場合、endIndex を 0 とする。
- そうでなく relativeEnd < 0 の場合、endIndex を
max (srcLength + relativeEnd, 0) とする。 - それ以外の場合、endIndex を
min (relativeEnd, srcLength) とする。 - newLength を
max (endIndex - startIndex, 0) とする。 - argumentsList を « buffer,
𝔽 (beginByteOffset),𝔽 (newLength) » とする。
- end が
- ?
TypedArraySpeciesCreate (obj, argumentsList) を返す。
このメソッドは汎用ではありません。
23.2.3.31 %TypedArray%.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
これは、Array.prototype.toLocaleString と同じアルゴリズムを実装する個別のメソッドですが、
このメソッドは汎用ではありません。アルゴリズムを評価する前に、
ECMAScript実装がECMA-402 Internationalization APIを含む場合、このメソッドはECMA-402仕様内の Array.prototype.toLocaleString のアルゴリズムに基づきます。
23.2.3.32 %TypedArray%.prototype.toReversed ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - resultArray を ?
TypedArrayCreateSameType (obj, len) とする。 - k を 0 とする。
- k < len の間、繰り返す：
- resultArray を返す。
23.2.3.33 %TypedArray%.prototype.toSorted ( comparator )
このメソッドは呼び出されたとき、次の手順を実行します：
- comparator が
undefined でなく、かつIsCallable (comparator) がfalse の場合、TypeError 例外をスローする。 - obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - resultArray を ?
TypedArrayCreateSameType (obj, len) とする。 NOTE : 次のclosureは、23.1.3.34 で使用される文字列比較ではなく数値比較を実行する。- sortCompare を、comparator を捕捉し、呼び出されたときに次の手順を実行する、パラメーター (x, y) を持つ新しい
Abstract Closure とする：- ?
CompareTypedArrayElements (x, y, comparator) を返す。
- ?
- sortedList を ?
SortIndexedProperties (obj, len, sortCompare,read-through-holes ) とする。 - j を 0 とする。
- j < len の間、繰り返す：
- resultArray を返す。
23.2.3.34 %TypedArray%.prototype.toString ( )
23.2.3.35 %TypedArray%.prototype.values ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - ?
ValidateTypedArray (obj,seq-cst ) を実行する。 CreateArrayIterator (obj,value ) を返す。
23.2.3.36 %TypedArray%.prototype.with ( index, value )
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - taRecord を ?
ValidateTypedArray (obj,seq-cst ) とする。 - len を
TypedArrayLength (taRecord) とする。 - relativeIndex を ?
ToIntegerOrInfinity (index) とする。 - relativeIndex ≥ 0 の場合、actualIndex を relativeIndex とする。
- それ以外の場合、actualIndex を len + relativeIndex とする。
- obj.[[ContentType]] が
bigint である場合、numericValue を ?ToBigInt (value) とする。 - それ以外の場合、numericValue を ?
ToNumber (value) とする。 IsValidIntegerIndex (obj,𝔽 (actualIndex)) がfalse の場合、RangeError 例外をスローする。- resultArray を ?
TypedArrayCreateSameType (obj, len) とする。 - k を 0 とする。
- k < len の間、繰り返す：
- resultArray を返す。
23.2.3.37 %TypedArray%.prototype [ %Symbol.iterator% ] ( )
23.2.3.38 get %TypedArray%.prototype [ %Symbol.toStringTag% ]
.prototype[%Symbol.toStringTag%]は、setアクセサー関数が
- obj を
this 値とする。 - obj がObjectでない場合、
undefined を返す。 - obj が [[TypedArrayName]] 内部スロットを持たない場合、
undefined を返す。 - name を obj.[[TypedArrayName]] とする。
Assert : name はStringである。- name を返す。
このプロパティの属性は { [[Enumerable]]:
この関数の
23.2.4 TypedArrayオブジェクトのための抽象操作
23.2.4.1 TypedArrayCreateFromConstructor ( constructor, argumentList )
The
- newTypedArray を ?
Construct (constructor, argumentList) とする。 - taRecord を ?
ValidateTypedArray (newTypedArray,seq-cst ) とする。 Assert : newTypedArray はTypedArray インスタンスのプロパティ で言及されるすべての内部スロットを持つ。- argumentList 内の要素数が1であり、argumentList[0] がNumberである場合、次を行う：
IsTypedArrayOutOfBounds (taRecord) がtrue の場合、TypeError 例外をスローする。- length を
TypedArrayLength (taRecord) とする。 - length <
ℝ (argumentList[0]) の場合、TypeError 例外をスローする。
- newTypedArray を返す。
23.2.4.2 TypedArrayCreateSameType ( exemplar, length )
The
- constructor を、
Table 70 内のコンストラクター名 exemplar.[[TypedArrayName]] に関連付けられたintrinsicオブジェクトとする。 - result を ?
TypedArrayCreateFromConstructor (constructor, «𝔽 (length) ») とする。 Assert : result は [[TypedArrayName]] および [[ContentType]] 内部スロットを持つ。Assert : result.[[ContentType]] は exemplar.[[ContentType]] である。- result を返す。
23.2.4.3 TypedArraySpeciesCreate ( exemplar, argumentList )
The
- defaultConstructor を、
Table 70 内のコンストラクター名 exemplar.[[TypedArrayName]] に関連付けられたintrinsicオブジェクトとする。 - constructor を ?
SpeciesConstructor (exemplar, defaultConstructor) とする。 - result を ?
TypedArrayCreateFromConstructor (constructor, argumentList) とする。 - result.[[ContentType]] が exemplar.[[ContentType]] でない場合、
TypeError 例外をスローする。 - result を返す。
23.2.4.4 ValidateTypedArray ( obj, order )
The
- ?
RequireInternalSlot (obj, [[TypedArrayName]]) を実行する。 Assert : obj は [[ViewedArrayBuffer]] 内部スロットを持つ。- taRecord を
MakeTypedArrayWithBufferWitnessRecord (obj, order) とする。 IsTypedArrayOutOfBounds (taRecord) がtrue の場合、TypeError 例外をスローする。- taRecord を返す。
23.2.4.5 TypedArrayElementSize ( obj )
The
- obj.[[TypedArrayName]] について
Table 70 に指定されたElement Size値を返す。
23.2.4.6 TypedArrayElementType ( obj )
The
- obj.[[TypedArrayName]] について
Table 70 に指定されたElement Type値を返す。
23.2.4.7 CompareTypedArrayElements ( x, y, comparator )
The
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 TypedArray コンストラクター
各 TypedArray コンストラクターは以下の通りです：
- 下記に説明される構造を持つintrinsicオブジェクトであり、特に注記がない限り、
Table 70 において TypedArray の代わりにコンストラクター名として使用される名前のみが異なる。 - 引数の数と型に基づいて動作が異なる関数である。TypedArray の呼び出しの実際の動作は、それに渡される引数の数および種類に依存する。
- 関数として呼び出されることを意図しておらず、そのように呼び出された場合は例外をスローする。
- クラス定義の
extends節の値として使用できる。指定された TypedArray の動作を継承することを意図するサブクラスコンストラクターは、%TypedArray% .prototype組み込みメソッドをサポートするために必要な内部状態を持つサブクラスインスタンスを作成して初期化するために、TypedArray コンストラクターへのsuper呼び出しを含めなければならない。
23.2.5.1 TypedArray ( ...args )
各 TypedArray コンストラクターは呼び出されたとき、次の手順を実行します：
- NewTarget が
undefined の場合、TypeError 例外をスローする。 - constructorName を、このTypedArrayコンストラクターについて
Table 70 に指定されたConstructor Name値のString値とする。 - proto を
"%TypedArray.prototype%"とする。 - numberOfArgs を args 内の要素数とする。
- numberOfArgs = 0 の場合、?
AllocateTypedArray (constructorName, NewTarget, proto, 0) を返す。 - firstArgument を args[0] とする。
- firstArgument がObjectである場合、次を行う：
- obj を ?
AllocateTypedArray (constructorName, NewTarget, proto) とする。 - firstArgument が [[TypedArrayName]] 内部スロットを持つ場合、次を行う：
- ?
InitializeTypedArrayFromTypedArray (obj, firstArgument) を実行する。
- ?
- そうでなく firstArgument が [[ArrayBufferData]] 内部スロットを持つ場合、次を行う：
- numberOfArgs > 1 の場合、byteOffset を args[1] とする。そうでない場合、byteOffset を
undefined とする。 - numberOfArgs > 2 の場合、length を args[2] とする。そうでない場合、length を
undefined とする。 - ?
InitializeTypedArrayFromArrayBuffer (obj, firstArgument, byteOffset, length) を実行する。
- numberOfArgs > 1 の場合、byteOffset を args[1] とする。そうでない場合、byteOffset を
- それ以外の場合、
Assert : firstArgument はObjectであり、firstArgument は [[TypedArrayName]] または [[ArrayBufferData]] 内部スロットのいずれも持たない。- usingIterator を ?
GetMethod (firstArgument,%Symbol.iterator% ) とする。 - usingIterator が
undefined でない場合、次を行う：- values を ?
IteratorToList (?GetIteratorFromMethod (firstArgument, usingIterator)) とする。 - ?
InitializeTypedArrayFromList (obj, values) を実行する。
- values を ?
- それ以外の場合、
NOTE : firstArgument はiterable object ではないため、すでにarray-like object であると仮定する。- ?
InitializeTypedArrayFromArrayLike (obj, firstArgument) を実行する。
- obj を返す。
- obj を ?
Assert : firstArgument はObjectでない。- elementLength を ?
ToIndex (firstArgument) とする。 - ?
AllocateTypedArray (constructorName, NewTarget, proto, elementLength) を返す。
23.2.5.1.1 AllocateTypedArray ( constructorName, newTarget, defaultProto [ , length ] )
The
- proto を ?
GetPrototypeFromConstructor (newTarget, defaultProto) とする。 - obj を
TypedArrayCreate (proto) とする。 Assert : obj.[[ViewedArrayBuffer]] はundefined である。- obj.[[TypedArrayName]] を constructorName に設定する。
- constructorName が
"BigInt64Array" または"BigUint64Array" のいずれかである場合、obj.[[ContentType]] をbigint に設定する。 - それ以外の場合、obj.[[ContentType]] を
number に設定する。 - length が存在しない場合、次を行う：
- obj.[[ByteLength]] を 0 に設定する。
- obj.[[ByteOffset]] を 0 に設定する。
- obj.[[ArrayLength]] を 0 に設定する。
- それ以外の場合、
- ?
AllocateTypedArrayBuffer (obj, length) を実行する。
- ?
- obj を返す。
23.2.5.1.2 InitializeTypedArrayFromTypedArray ( obj, srcArray )
The
- srcData を srcArray.[[ViewedArrayBuffer]] とする。
- elementType を
TypedArrayElementType (obj) とする。 - elementSize を
TypedArrayElementSize (obj) とする。 - srcType を
TypedArrayElementType (srcArray) とする。 - srcElementSize を
TypedArrayElementSize (srcArray) とする。 - srcByteOffset を srcArray.[[ByteOffset]] とする。
- srcRecord を
MakeTypedArrayWithBufferWitnessRecord (srcArray,seq-cst ) とする。 IsTypedArrayOutOfBounds (srcRecord) がtrue の場合、TypeError 例外をスローする。- elementLength を
TypedArrayLength (srcRecord) とする。 - byteLength を elementSize × elementLength とする。
- elementType が srcType である場合、次を行う：
- data を ?
CloneArrayBuffer (srcData, srcByteOffset, byteLength) とする。
- data を ?
- それ以外の場合、
- data を ?
AllocateArrayBuffer (%ArrayBuffer% , byteLength) とする。 - srcArray.[[ContentType]] が obj.[[ContentType]] でない場合、
TypeError 例外をスローする。 - srcByteIndex を srcByteOffset とする。
- targetByteIndex を 0 とする。
- count を elementLength とする。
- count > 0 の間、繰り返す：
- value を
GetValueFromBuffer (srcData, srcByteIndex, srcType,true ,unordered ) とする。 SetValueInBuffer (data, targetByteIndex, elementType, value,true ,unordered ) を実行する。- srcByteIndex を srcByteIndex + srcElementSize に設定する。
- targetByteIndex を targetByteIndex + elementSize に設定する。
- count を count - 1 に設定する。
- value を
- data を ?
- obj.[[ViewedArrayBuffer]] を data に設定する。
- obj.[[ByteLength]] を byteLength に設定する。
- obj.[[ByteOffset]] を 0 に設定する。
- obj.[[ArrayLength]] を elementLength に設定する。
unused を返す。
23.2.5.1.3 InitializeTypedArrayFromArrayBuffer ( obj, buffer, byteOffset, length )
The
- elementSize を
TypedArrayElementSize (obj) とする。 - offset を ?
ToIndex (byteOffset) とする。 - offset
modulo elementSize ≠ 0 の場合、RangeError 例外をスローする。 - bufferIsFixedLength を
IsFixedLengthArrayBuffer (buffer) とする。 - length が
undefined でない場合、次を行う：- newLength を ?
ToIndex (length) とする。
- newLength を ?
IsDetachedBuffer (buffer) がtrue の場合、TypeError 例外をスローする。- bufferByteLength を
ArrayBufferByteLength (buffer,seq-cst ) とする。 - length が
undefined かつ bufferIsFixedLength がfalse の場合、次を行う：- offset > bufferByteLength の場合、
RangeError 例外をスローする。 - obj.[[ByteLength]] を
auto に設定する。 - obj.[[ArrayLength]] を
auto に設定する。
- offset > bufferByteLength の場合、
- それ以外の場合、
- length が
undefined の場合、次を行う：- bufferByteLength
modulo elementSize ≠ 0 の場合、RangeError 例外をスローする。 - newByteLength を bufferByteLength - offset とする。
- newByteLength < 0 の場合、
RangeError 例外をスローする。
- bufferByteLength
- それ以外の場合、
- newByteLength を newLength × elementSize とする。
- offset + newByteLength > bufferByteLength の場合、
RangeError 例外をスローする。
- obj.[[ByteLength]] を newByteLength に設定する。
- obj.[[ArrayLength]] を newByteLength / elementSize に設定する。
- length が
- obj.[[ViewedArrayBuffer]] を buffer に設定する。
- obj.[[ByteOffset]] を offset に設定する。
unused を返す。
23.2.5.1.4 InitializeTypedArrayFromList ( obj, values )
The
23.2.5.1.5 InitializeTypedArrayFromArrayLike ( obj, arrayLike )
The
- len を ?
LengthOfArrayLike (arrayLike) とする。 - ?
AllocateTypedArrayBuffer (obj, len) を実行する。 - k を 0 とする。
- k < len の間、繰り返す：
unused を返す。
23.2.5.1.6 AllocateTypedArrayBuffer ( obj, length )
The
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 TypedArray コンストラクターのプロパティ
各 TypedArray コンストラクターは以下の通りです：
- [[Prototype]]内部スロットを持ち、その値は
%TypedArray% である。 - 値が
3 𝔽 である"length" プロパティを持つ。 - 値が
Table 70 でそれについて指定されたコンストラクター名のString値である"name" プロパティを持つ。 - 以下のプロパティを持つ：
23.2.6.1 TypedArray.BYTES_PER_ELEMENT
TypedArray.BYTES_PER_ELEMENTの値は、
このプロパティの属性は { [[Writable]]:
23.2.6.2 TypedArray.prototype
TypedArray.prototypeの初期値は、対応する TypedArray プロトタイプintrinsicオブジェクト（
このプロパティの属性は { [[Writable]]:
23.2.7 TypedArray プロトタイプオブジェクトのプロパティ
各 TypedArray プロトタイプオブジェクトは以下の通りです：
- [[Prototype]]内部スロットを持ち、その値は
%TypedArray.prototype% である。 - 通常のオブジェクトである。
- [[ViewedArrayBuffer]]、または TypedArray インスタンスオブジェクトに固有のその他の内部スロットを持たない。
23.2.7.1 TypedArray.prototype.BYTES_PER_ELEMENT
TypedArray.prototype.BYTES_PER_ELEMENTの値は、
このプロパティの属性は { [[Writable]]:
23.2.7.2 TypedArray.prototype.constructor
所与の TypedArray コンストラクターのプロトタイプの
23.2.8 TypedArray インスタンスのプロパティ
TypedArray インスタンスは
23.3 Uint8Arrayオブジェクト
Uint8Arrayは、上記で説明された特定の種類の TypedArray です。さらに、Uint8Arrayコンストラクター上（
23.3.1 Uint8Arrayコンストラクターの追加プロパティ
23.3.1.1 Uint8Array.fromBase64 ( string [ , options ] )
- string がStringでない場合、
TypeError 例外をスローする。 - opts を ?
GetOptionsObject (options) とする。 - alphabet を ?
Get (opts,"alphabet" ) とする。 - alphabet が
undefined の場合、alphabet を"base64" に設定する。 - alphabet が
"base64" と"base64url" のいずれでもない場合、TypeError 例外をスローする。 - lastChunkHandling を ?
Get (opts,"lastChunkHandling" ) とする。 - lastChunkHandling が
undefined の場合、lastChunkHandling を"loose" に設定する。 - lastChunkHandling が
"loose" 、"strict" 、または"stop-before-partial" のいずれでもない場合、TypeError 例外をスローする。 - result を
FromBase64 (string, alphabet, lastChunkHandling) とする。 - result.[[Error]] が
none でない場合、次を行う：- result.[[Error]] をスローする。
- resultLength を result.[[Bytes]] 内の要素数とする。
- ta を ?
AllocateTypedArray ("Uint8Array" ,%Uint8Array% ,"%Uint8Array.prototype%" , resultLength) とする。 Assert : ta.[[ViewedArrayBuffer]].[[ArrayBufferByteLength]] は result.[[Bytes]] 内の要素数である。- ta.[[ViewedArrayBuffer]].[[ArrayBufferData]] の各インデックスの値を、result.[[Bytes]] の対応するインデックスの値に設定する。
- ta を返す。
23.3.1.2 Uint8Array.fromHex ( string )
- string がStringでない場合、
TypeError 例外をスローする。 - result を
FromHex (string) とする。 - result.[[Error]] が
none でない場合、次を行う：- result.[[Error]] をスローする。
- resultLength を result.[[Bytes]] 内の要素数とする。
- ta を ?
AllocateTypedArray ("Uint8Array" ,%Uint8Array% ,"%Uint8Array.prototype%" , resultLength) とする。 Assert : ta.[[ViewedArrayBuffer]].[[ArrayBufferByteLength]] は result.[[Bytes]] 内の要素数である。- ta.[[ViewedArrayBuffer]].[[ArrayBufferData]] の各インデックスの値を、result.[[Bytes]] の対応するインデックスの値に設定する。
- ta を返す。
23.3.2 Uint8Arrayプロトタイプオブジェクトの追加プロパティ
23.3.2.1 Uint8Array.prototype.setFromBase64 ( string [ , options ] )
- into を
this 値とする。 - ?
ValidateUint8Array (into) を実行する。 - string がStringでない場合、
TypeError 例外をスローする。 - opts を ?
GetOptionsObject (options) とする。 - alphabet を ?
Get (opts,"alphabet" ) とする。 - alphabet が
undefined の場合、alphabet を"base64" に設定する。 - alphabet が
"base64" と"base64url" のいずれでもない場合、TypeError 例外をスローする。 - lastChunkHandling を ?
Get (opts,"lastChunkHandling" ) とする。 - lastChunkHandling が
undefined の場合、lastChunkHandling を"loose" に設定する。 - lastChunkHandling が
"loose" 、"strict" 、または"stop-before-partial" のいずれでもない場合、TypeError 例外をスローする。 - taRecord を
MakeTypedArrayWithBufferWitnessRecord (into,seq-cst ) とする。 IsTypedArrayOutOfBounds (taRecord) がtrue の場合、TypeError 例外をスローする。- byteLength を
TypedArrayLength (taRecord) とする。 - result を
FromBase64 (string, alphabet, lastChunkHandling, byteLength) とする。 - bytes を result.[[Bytes]] とする。
- written を bytes 内の要素数とする。
NOTE :FromBase64 はユーザーコードを起動しないため、into を支えるArrayBufferがデタッチまたは縮小されていることはあり得ない。Assert : written ≤ byteLength。SetUint8ArrayBytes (into, bytes) を実行する。- result.[[Error]] が
none でない場合、次を行う：- result.[[Error]] をスローする。
- resultObject を
OrdinaryObjectCreate (%Object.prototype% ) とする。 - !
CreateDataPropertyOrThrow (resultObject,"read" ,𝔽 (result.[[Read]])) を実行する。 - !
CreateDataPropertyOrThrow (resultObject,"written" ,𝔽 (written)) を実行する。 - resultObject を返す。
23.3.2.2 Uint8Array.prototype.setFromHex ( string )
- into を
this 値とする。 - ?
ValidateUint8Array (into) を実行する。 - string がStringでない場合、
TypeError 例外をスローする。 - taRecord を
MakeTypedArrayWithBufferWitnessRecord (into,seq-cst ) とする。 IsTypedArrayOutOfBounds (taRecord) がtrue の場合、TypeError 例外をスローする。- byteLength を
TypedArrayLength (taRecord) とする。 - result を
FromHex (string, byteLength) とする。 - bytes を result.[[Bytes]] とする。
- written を bytes 内の要素数とする。
NOTE :FromHex はユーザーコードを起動しないため、into を支えるArrayBufferがデタッチまたは縮小されていることはあり得ない。Assert : written ≤ byteLength。SetUint8ArrayBytes (into, bytes) を実行する。- result.[[Error]] が
none でない場合、次を行う：- result.[[Error]] をスローする。
- resultObject を
OrdinaryObjectCreate (%Object.prototype% ) とする。 - !
CreateDataPropertyOrThrow (resultObject,"read" ,𝔽 (result.[[Read]])) を実行する。 - !
CreateDataPropertyOrThrow (resultObject,"written" ,𝔽 (written)) を実行する。 - resultObject を返す。
23.3.2.3 Uint8Array.prototype.toBase64 ( [ options ] )
- obj を
this 値とする。 - ?
ValidateUint8Array (obj) を実行する。 - opts を ?
GetOptionsObject (options) とする。 - alphabet を ?
Get (opts,"alphabet" ) とする。 - alphabet が
undefined の場合、alphabet を"base64" に設定する。 - alphabet が
"base64" と"base64url" のいずれでもない場合、TypeError 例外をスローする。 - omitPadding を
ToBoolean (?Get (opts,"omitPadding" )) とない場合、TypeError 例外をスローする。 - omitPadding を
ToBoolean (?Get (opts, *する。 - toEncode を ?
GetUint8ArrayBytes (obj) とする。 - alphabet が
"base64" である場合、次を行う：- outAscii を、RFC 4648 のsection 4に指定されるbase64符号化に従って toEncode を符号化した結果として得られるコードポイント列とする。パディングは omitPadding が
false である場合に限り含まれる。
- outAscii を、RFC 4648 のsection 4に指定されるbase64符号化に従って toEncode を符号化した結果として得られるコードポイント列とする。パディングは omitPadding が
- それ以外の場合、
CodePointsToString (outAscii) を返す。
23.3.2.4 Uint8Array.prototype.toHex ( )
- obj を
this 値とする。 - ?
ValidateUint8Array (obj) を実行する。 - toEncode を ?
GetUint8ArrayBytes (obj) とする。 - out を空のStringとする。
- toEncode の各byte byte について、次を行う：
- hex を
Number::toString (𝔽 (byte), 16) とする。 - hex を
StringPad (hex, 2,"0" ,start ) に設定する。 - out を out と hex の文字列連結に設定する。
- hex を
- out を返す。
23.3.3 Uint8Arrayオブジェクトのための抽象操作
23.3.3.1 ValidateUint8Array ( ta )
The
- ?
RequireInternalSlot (ta, [[TypedArrayName]]) を実行する。 - ta.[[TypedArrayName]] が
"Uint8Array" でない場合、TypeError 例外をスローする。 unused を返す。
23.3.3.2 GetUint8ArrayBytes ( ta )
The
- buffer を ta.[[ViewedArrayBuffer]] とする。
- taRecord を
MakeTypedArrayWithBufferWitnessRecord (ta,seq-cst ) とする。 IsTypedArrayOutOfBounds (taRecord) がtrue の場合、TypeError 例外をスローする。- len を
TypedArrayLength (taRecord) とする。 - byteOffset を ta.[[ByteOffset]] とする。
- bytes を新しい空の
List とする。 - index を 0 とする。
- index < len の間、繰り返す：
- byteIndex を byteOffset + index とする。
- byte を
ℝ (GetValueFromBuffer (buffer, byteIndex,uint8 ,true ,unordered )) とする。 - byte を bytes に追加する。
- index を index + 1 に設定する。
- bytes を返す。
23.3.3.3 SetUint8ArrayBytes ( into, bytes )
The
- offset を into.[[ByteOffset]] とする。
- len を bytes 内の要素数とする。
- index を 0 とする。
- index < len の間、繰り返す：
- 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
- length を string の長さとする。
- index < length の間、繰り返す：
- char を string 内のインデックス index にあるコード単位とする。
- char が 0x0009 (TAB)、0x000A (LF)、0x000C (FF)、0x000D (CR)、または 0x0020 (SPACE) のいずれでもない場合、次を行う：
- index を返す。
- index を index + 1 に設定する。
- index を返す。
23.3.3.5 DecodeFinalBase64Chunk ( chunk, throwOnExtraBits )
The
- chunkLength を chunk の長さとする。
- chunkLength = 2 の場合、次を行う：
- chunk を chunk と
"AA" の文字列連結に設定する。
- chunk を chunk と
- それ以外の場合、
Assert : chunkLength は 3 である。- chunk を chunk と
"A" の文字列連結に設定する。
- bytes を
DecodeFullLengthBase64Chunk (chunk) とする。 - chunkLength = 2 の場合、次を行う：
- throwOnExtraBits が
true かつ bytes[1] ≠ 0 の場合、SyntaxError 例外をスローする。 - « bytes[0] » を返す。
- throwOnExtraBits が
- throwOnExtraBits が
true かつ bytes[2] ≠ 0 の場合、SyntaxError 例外をスローする。 - « bytes[0], bytes[1] » を返す。
23.3.3.6 DecodeFullLengthBase64Chunk ( chunk )
The
標準base64アルファベットは
23.3.3.7 FromBase64 ( string, alphabet, lastChunkHandling [ , maxLength ] )
The
- maxLength が存在しない場合、次を行う：
- maxLength を 253 - 1 に設定する。
NOTE : 入力はStringであるため、Stringの長さは253 - 1文字に制限され、出力は入力が持つ文字数を超えるバイトを必要としないので、この制限に到達することは決してない。しかし、有限値を使用することは編集上便利である。
NOTE : 下のアルゴリズムにおける検証と復号の順序は観察可能ではない。実装は、最も効率的な任意の順序でそれらを実行することが推奨され、検証と復号を交互に行ってもよい。- maxLength = 0 の場合、次を行う：
Record { [[Read]]: 0, [[Bytes]]: « », [[Error]]:none } を返す。
- read を 0 とする。
- bytes を新しい空の
List とする。 - chunk を空のStringとする。
- chunkLength を 0 とする。
- index を 0 とする。
- length を string の長さとする。
- 繰り返す：
- index を
SkipAsciiWhitespace (string, index) に設定する。 - index = length の場合、次を行う：
- chunkLength > 0 の場合、次を行う：
- lastChunkHandling が
"stop-before-partial" である場合、次を行う：Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]:none } を返す。
- lastChunkHandling が
"strict" である場合、次を行う：- error を新しく作成された
SyntaxError オブジェクトとする。 Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error } を返す。
- error を新しく作成された
Assert : lastChunkHandling は"loose" である。- chunkLength = 1 の場合、次を行う：
- error を新しく作成された
SyntaxError オブジェクトとする。 Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error } を返す。
- error を新しく作成された
- bytes を bytes と !
DecodeFinalBase64Chunk (chunk,false ) のリスト連結に設定する。
- lastChunkHandling が
Record { [[Read]]: length, [[Bytes]]: bytes, [[Error]]:none } を返す。
- chunkLength > 0 の場合、次を行う：
- char を string の index から index + 1 までの部分文字列とする。
- index を index + 1 に設定する。
- char が
"=" である場合、次を行う：- chunkLength < 2 の場合、次を行う：
- error を新しく作成された
SyntaxError オブジェクトとする。 Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error } を返す。
- error を新しく作成された
- index を
SkipAsciiWhitespace (string, index) に設定する。 - chunkLength = 2 の場合、次を行う：
- index = length の場合、次を行う：
- char を string の index から index + 1 までの部分文字列に設定する。
- char が
"=" である場合、次を行う：- index を
SkipAsciiWhitespace (string, index + 1) に設定する。
- index を
- index < length の場合、次を行う：
- error を新しく作成された
SyntaxError オブジェクトとする。 Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error } を返す。
- error を新しく作成された
- lastChunkHandling が
"strict" である場合、throwOnExtraBits をtrue とする。そうでない場合、throwOnExtraBits をfalse とする。 - decodeResult を
Completion (DecodeFinalBase64Chunk (chunk, throwOnExtraBits)) とする。 - decodeResult が急な完了である場合、次を行う：
- error を decodeResult.[[Value]] とする。
Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error } を返す。
- bytes を bytes と ! decodeResult のリスト連結に設定する。
Record { [[Read]]: length, [[Bytes]]: bytes, [[Error]]:none } を返す。
- chunkLength < 2 の場合、次を行う：
- alphabet が
"base64url" である場合、次を行う：- char が
"+" または"/" のいずれかである場合、次を行う：- error を新しく作成された
SyntaxError オブジェクトとする。 Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error } を返す。
- error を新しく作成された
- そうでなく char が
"-" である場合、次を行う：- char を
"+" に設定する。
- char を
- そうでなく char が
"_" である場合、次を行う：- char を
"/" に設定する。
- char を
- char が
- char の唯一のコード単位が
標準base64アルファベット の要素でない場合、次を行う：- error を新しく作成された
SyntaxError オブジェクトとする。 Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error } を返す。
- error を新しく作成された
- remaining を maxLength - bytes 内の要素数とする。
- remaining = 1 かつ chunkLength = 2 の場合、または remaining = 2 かつ chunkLength = 3 の場合、次を行う：
Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]:none } を返す。
- chunk を chunk と char の文字列連結に設定する。
- chunkLength を chunk の長さに設定する。
- chunkLength = 4 の場合、次を行う：
- bytes を bytes と
DecodeFullLengthBase64Chunk (chunk) のリスト連結に設定する。 - chunk を空のStringに設定する。
- chunkLength を 0 に設定する。
- read を index に設定する。
- bytes 内の要素数 = maxLength の場合、次を行う：
Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]:none } を返す。
- bytes を bytes と
- index を
23.3.3.8 FromHex ( string [ , maxLength ] )
The
- maxLength が存在しない場合、maxLength を 253 - 1 に設定する。
- length を string の長さとする。
- bytes を新しい空の
List とする。 - read を 0 とする。
- length
modulo 2 ≠ 0 の場合、次を行う：- error を新しく作成された
SyntaxError オブジェクトとする。 Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error } を返す。
- error を新しく作成された
- read < length かつ bytes 内の要素数 < maxLength の間、繰り返す：
- hexits を string の read から read + 2 までの部分文字列とする。
- hexits が
"0123456789abcdefABCDEF" 内にないコード単位を含む場合、次を行う：- error を新しく作成された
SyntaxError オブジェクトとする。 Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]: error } を返す。
- error を新しく作成された
- read を read + 2 に設定する。
- byte を、値10から15の数字に
A からF およびa からf の文字を使用する16進表記で hexits によって表される整数値とする。 - byte を bytes に追加する。
Record { [[Read]]: read, [[Bytes]]: bytes, [[Error]]:none } を返す。
24 キー付きコレクション
24.1 Mapオブジェクト
Mapはキー/値ペアのコレクションであり、キーと値はいずれも任意のECMAScript言語値であってよいです。異なるキー値は、Mapのコレクション内の1つのキー/値ペアにのみ出現できます。異なるキー値は、
Mapは、平均してコレクション内の要素数に対してサブリニアなアクセス時間を提供するハッシュテーブルまたはその他の機構を使用して実装されなければなりません。この仕様で使用されるデータ構造は、Mapに要求される観察可能な意味論を記述することのみを意図しています。実行可能な実装モデルであることは意図していません。
24.1.1 Mapコンストラクター
Mapコンストラクターは以下の通りです：
- %Map%である。
グローバルオブジェクト の"Map" プロパティの初期値である。- コンストラクターとして呼び出されたとき、新しいMapを作成して初期化する。
- 関数として呼び出されることを意図しておらず、そのように呼び出された場合は例外をスローする。
- クラス定義の
extends節の値として使用できる。指定されたMapの動作を継承することを意図するサブクラスコンストラクターは、Map.prototype組み込みメソッドをサポートするために必要な内部状態を持つサブクラスインスタンスを作成して初期化するために、Mapコンストラクターへのsuper呼び出しを含めなければならない。
24.1.1.1 Map ( [ iterable ] )
この関数は呼び出されたとき、次の手順を実行します：
- NewTarget が
undefined の場合、TypeError 例外をスローする。 - map を ?
OrdinaryCreateFromConstructor (NewTarget,"%Map.prototype%" , « [[MapData]] ») とする。 - map.[[MapData]] を新しい空の
List に設定する。 - iterable が
undefined またはnull のいずれかである場合、map を返す。 - adder を ?
Get (map,"set" ) とする。 IsCallable (adder) がfalse の場合、TypeError 例外をスローする。- ?
AddEntriesFromIterable (map, iterable, adder) を返す。
パラメーター iterable が存在する場合、それは、Mapキーとして使用される値を第1要素とし、そのキーに関連付ける値を第2要素とする2要素の
24.1.1.2 AddEntriesFromIterable ( target, iterable, adder )
The
- iteratorRecord を ?
GetIterator (iterable,sync ) とする。 - 繰り返す：
- next を ?
IteratorStepValue (iteratorRecord) とする。 - next が
done の場合、target を返す。 - next がObjectでない場合、次を行う：
- error を
ThrowCompletion (新しく作成されたTypeError オブジェクト) とする。 - ?
IteratorClose (iteratorRecord, error) を返す。
- error を
- key を
Completion (Get (next,"0" )) とする。 IfAbruptCloseIterator (key, iteratorRecord)。- value を
Completion (Get (next,"1" )) とする。 IfAbruptCloseIterator (value, iteratorRecord)。- status を
Completion (Call (adder, target, « key, value »)) とする。 IfAbruptCloseIterator (status, iteratorRecord)。
- next を ?
パラメーター iterable は、Mapキーとして使用される値を第1要素とし、そのキーに関連付ける値を第2要素とする2要素の
24.1.2 Mapコンストラクターのプロパティ
Mapコンストラクターは以下の通りです：
- [[Prototype]]内部スロットを持ち、その値は
%Function.prototype% である。 - 以下のプロパティを持つ：
24.1.2.1 Map.groupBy ( items, callback )
callback は2つの引数を受け取る関数であるべきです。groupByは、items 内の各要素について昇順に callback を1回ずつ呼び出し、新しいMapを構築します。callback によって返される各値は、Map内のキーとして使用されます。そのような各キーについて、結果のMapは、そのキーをキーとし、そのキーを返した callback のすべての要素を含む配列を値とするエントリーを持ちます。
callback は2つの引数、すなわち要素の値と要素のインデックスで呼び出されます。
groupByの戻り値はMapです。
この関数は呼び出されたとき、次の手順を実行します：
24.1.2.2 Map.prototype
Map.prototypeの初期値は
このプロパティの属性は { [[Writable]]:
24.1.2.3 get Map [ %Symbol.species% ]
Map[%Symbol.species%]は、setアクセサー関数が
this 値を返す。
この関数の
派生コレクションオブジェクトを作成するメソッドは、派生オブジェクトを作成するために使用するコンストラクターを決定するため、
24.1.3 Mapプロトタイプオブジェクトのプロパティ
Mapプロトタイプオブジェクトは以下の通りです：
- %Map.prototype%である。
- [[Prototype]]内部スロットを持ち、その値は
%Object.prototype% である。 - 通常のオブジェクトである。
- [[MapData]]内部スロットを持たない。
24.1.3.1 Map.prototype.clear ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- map を
this 値とする。 - ?
RequireInternalSlot (map, [[MapData]]) を実行する。 - map.[[MapData]] の各
Record { [[Key]], [[Value]] } entry について、次を行う：- entry.[[Key]] を
empty に設定する。 - entry.[[Value]] を
empty に設定する。
- entry.[[Key]] を
undefined を返す。
既存の[[MapData]]
24.1.3.2 Map.prototype.constructor
Map.prototype.constructorの初期値は
24.1.3.3 Map.prototype.delete ( key )
このメソッドは呼び出されたとき、次の手順を実行します：
- map を
this 値とする。 - ?
RequireInternalSlot (map, [[MapData]]) を実行する。 - key を
CanonicalizeKeyedCollectionKey (key) に設定する。 - map.[[MapData]] の各
Record { [[Key]], [[Value]] } entry について、次を行う：- entry.[[Key]] が
empty でなく、SameValue (entry.[[Key]], key) がtrue である場合、次を行う：- entry.[[Key]] を
empty に設定する。 - entry.[[Value]] を
empty に設定する。 true を返す。
- entry.[[Key]] を
- entry.[[Key]] が
false を返す。
値
24.1.3.4 Map.prototype.entries ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- map を
this 値とする。 - ?
CreateMapIterator (map,key+value ) を返す。
24.1.3.5 Map.prototype.forEach ( callback [ , thisArg ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- map を
this 値とする。 - ?
RequireInternalSlot (map, [[MapData]]) を実行する。 IsCallable (callback) がfalse の場合、TypeError 例外をスローする。- entries を map.[[MapData]] とする。
- numEntries を entries 内の要素数とする。
- index を 0 とする。
- index < numEntries の間、繰り返す：
undefined を返す。
callback は3つの引数を受け取る関数であるべきです。forEachは、Mapに存在する各キー/値ペアについて、キーの挿入順に callback を1回ずつ呼び出します。callback は実際に存在するMapのキーについてのみ呼び出され、Mapから削除されたキーについては呼び出されません。
thisArg パラメーターが提供された場合、それは callback の各呼び出しの
callback は3つの引数、すなわち項目の値、項目のキー、および走査されているMapで呼び出されます。
forEachは、それが呼び出されたオブジェクトを直接変更しませんが、callback の呼び出しによってそのオブジェクトが変更される可能性があります。Mapの[[MapData]]の各エントリーは1回だけ訪問されます。forEachの呼び出しが開始された後に追加された新しいキーは訪問されます。キーは、訪問された後に削除され、forEachの呼び出しが完了する前に再び追加された場合、再訪問されます。forEachの呼び出しが開始された後、訪問される前に削除されたキーは、forEachの呼び出しが完了する前にそのキーが再び追加されない限り、訪問されません。
24.1.3.6 Map.prototype.get ( key )
このメソッドは呼び出されたとき、次の手順を実行します：
- map を
this 値とする。 - ?
RequireInternalSlot (map, [[MapData]]) を実行する。 - key を
CanonicalizeKeyedCollectionKey (key) に設定する。 - map.[[MapData]] の各
Record { [[Key]], [[Value]] } entry について、次を行う：- entry.[[Key]] が
empty でなく、SameValue (entry.[[Key]], key) がtrue である場合、entry.[[Value]] を返す。
- entry.[[Key]] が
undefined を返す。
24.1.3.7 Map.prototype.getOrInsert ( key, value )
このメソッドは呼び出されたとき、次の手順を実行します：
- map を
this 値とする。 - ?
RequireInternalSlot (map, [[MapData]]) を実行する。 - key を
CanonicalizeKeyedCollectionKey (key) に設定する。 - map.[[MapData]] の各
Record { [[Key]], [[Value]] } entry について、次を行う：- entry.[[Key]] が
empty でなく、SameValue (entry.[[Key]], key) がtrue である場合、entry.[[Value]] を返す。
- entry.[[Key]] が
- entry を
Record { [[Key]]: key, [[Value]]: value } とする。 - entry を map.[[MapData]] に追加する。
- value を返す。
24.1.3.8 Map.prototype.getOrInsertComputed ( key, callback )
このメソッドは呼び出されたとき、次の手順を実行します：
- map を
this 値とする。 - ?
RequireInternalSlot (map, [[MapData]]) を実行する。 IsCallable (callback) がfalse の場合、TypeError 例外をスローする。- key を
CanonicalizeKeyedCollectionKey (key) に設定する。 - map.[[MapData]] の各
Record { [[Key]], [[Value]] } entry について、次を行う：- entry.[[Key]] が
empty でなく、SameValue (entry.[[Key]], key) がtrue である場合、entry.[[Value]] を返す。
- entry.[[Key]] が
- value を ?
Call (callback,undefined , « key ») とする。 NOTE : callback の実行中にMapが変更されている可能性がある。- map.[[MapData]] の各
Record { [[Key]], [[Value]] } entry について、次を行う：- entry.[[Key]] が
empty でなく、SameValue (entry.[[Key]], key) がtrue である場合、次を行う：- entry.[[Value]] を value に設定する。
- value を返す。
- entry.[[Key]] が
- entry を
Record { [[Key]]: key, [[Value]]: value } とする。 - entry を map.[[MapData]] に追加する。
- value を返す。
24.1.3.9 Map.prototype.has ( key )
このメソッドは呼び出されたとき、次の手順を実行します：
- map を
this 値とする。 - ?
RequireInternalSlot (map, [[MapData]]) を実行する。 - key を
CanonicalizeKeyedCollectionKey (key) に設定する。 - map.[[MapData]] の各
Record { [[Key]], [[Value]] } entry について、次を行う：- entry.[[Key]] が
empty でなく、SameValue (entry.[[Key]], key) がtrue である場合、true を返す。
- entry.[[Key]] が
false を返す。
24.1.3.10 Map.prototype.keys ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- map を
this 値とする。 - ?
CreateMapIterator (map,key ) を返す。
24.1.3.11 Map.prototype.set ( key, value )
このメソッドは呼び出されたとき、次の手順を実行します：
- map を
this 値とする。 - ?
RequireInternalSlot (map, [[MapData]]) を実行する。 - key を
CanonicalizeKeyedCollectionKey (key) に設定する。 - map.[[MapData]] の各
Record { [[Key]], [[Value]] } entry について、次を行う：- entry.[[Key]] が
empty でなく、SameValue (entry.[[Key]], key) がtrue である場合、次を行う：- entry.[[Value]] を value に設定する。
- map を返す。
- entry.[[Key]] が
- entry を
Record { [[Key]]: key, [[Value]]: value } とする。 - entry を map.[[MapData]] に追加する。
- map を返す。
24.1.3.12 get Map.prototype.size
Map.prototype.sizeは、setアクセサー関数が
- map を
this 値とする。 - ?
RequireInternalSlot (map, [[MapData]]) を実行する。 - count を 0 とする。
- map.[[MapData]] の各
Record { [[Key]], [[Value]] } entry について、次を行う：- entry.[[Key]] が
empty でない場合、count を count + 1 に設定する。
- entry.[[Key]] が
𝔽 (count) を返す。
24.1.3.13 Map.prototype.values ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- map を
this 値とする。 - ?
CreateMapIterator (map,value ) を返す。
24.1.3.14 Map.prototype [ %Symbol.iterator% ] ( )
24.1.3.15 Map.prototype [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
24.1.4 Mapインスタンスのプロパティ
Mapインスタンスは、
24.1.5 Map Iteratorオブジェクト
Map Iteratorは、ある特定のMapインスタンスオブジェクトに対する特定の反復を表すオブジェクトです。Map Iteratorオブジェクトには名前付きコンストラクターはありません。代わりに、Map IteratorオブジェクトはMapインスタンスオブジェクトの特定のメソッドを呼び出すことによって作成されます。
24.1.5.1 CreateMapIterator ( map, kind )
The
- ?
RequireInternalSlot (map, [[MapData]]) を実行する。 - closure を、map と kind を捕捉し、呼び出されたときに次の手順を実行する、パラメーターを持たない新しい
Abstract Closure とする：- entries を map.[[MapData]] とする。
- index を 0 とする。
- numEntries を entries 内の要素数とする。
- index < numEntries の間、繰り返す：
- 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 :GeneratorYield によってこの抽象操作の実行が一時停止されている間に、entries 内の要素数が増加している可能性がある。- numEntries を entries 内の要素数に設定する。
- kind が
NormalCompletion (unused ) を返す。
CreateIteratorFromClosure (closure,"%MapIteratorPrototype%" ,%MapIteratorPrototype% ) を返す。
24.1.5.2 %MapIteratorPrototype%オブジェクト
%MapIteratorPrototype%オブジェクトは以下の通りです：
- すべての
Map Iterator オブジェクトによって継承されるプロパティを持つ。 - 通常のオブジェクトである。
- [[Prototype]]内部スロットを持ち、その値は
%Iterator.prototype% である。 - 以下のプロパティを持つ：
24.1.5.2.1 %MapIteratorPrototype%.next ( )
- ?
GeneratorResume (this value,empty ,"%MapIteratorPrototype%" ) を返す。
24.1.5.2.2 %MapIteratorPrototype% [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
24.2 Setオブジェクト
SetオブジェクトはECMAScript言語値のコレクションです。Setは、各異なる値を高々1回だけ含むことができます。異なる値は、
Setオブジェクトは、平均してコレクション内の要素数に対してサブリニアなアクセス時間を提供するハッシュテーブルまたはその他の機構を使用して実装されなければなりません。この仕様で使用されるデータ構造は、Setオブジェクトに要求される観察可能な意味論を記述することのみを意図しています。実行可能な実装モデルであることは意図していません。
24.2.1 Setオブジェクトのための抽象操作
24.2.1.1 Set Record
Set Recordは、Setまたは類似オブジェクトのインターフェースをカプセル化するために使用される
Set Recordは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[SetObject]] | Object | Setまたは類似オブジェクト。 |
| [[Size]] | 非負整数または +∞ | オブジェクトの報告されるサイズ。 |
| [[Has]] | 関数オブジェクト |
オブジェクトのhasメソッド。
|
| [[Keys]] | 関数オブジェクト |
オブジェクトのkeysメソッド。
|
24.2.1.2 GetSetRecord ( obj )
The
- obj がObjectでない場合、
TypeError 例外をスローする。 - rawSize を ?
Get (obj,"size" ) とする。 - numSize を ?
ToNumber (rawSize) とする。 NOTE : rawSize がundefined である場合、numSize はNaN になる。- numSize が
NaN の場合、TypeError 例外をスローする。 - intSize を !
ToIntegerOrInfinity (numSize) とする。 - intSize < 0 の場合、
RangeError 例外をスローする。 - has を ?
Get (obj,"has" ) とする。 IsCallable (has) がfalse の場合、TypeError 例外をスローする。- keys を ?
Get (obj,"keys" ) とする。 IsCallable (keys) がfalse の場合、TypeError 例外をスローする。- 新しい
Set Record { [[SetObject]]: obj, [[Size]]: intSize, [[Has]]: has, [[Keys]]: keys } を返す。
24.2.1.3 SetDataHas ( setData, value )
The
SetDataIndex (setData, value) がnot-found である場合、false を返す。true を返す。
24.2.1.4 SetDataIndex ( setData, value )
The
- value を
CanonicalizeKeyedCollectionKey (value) に設定する。 - size を setData 内の要素数とする。
- index を 0 とする。
- index < size の間、繰り返す：
- e を setData[index] とする。
- e が
empty でなく、e が value である場合、次を行う：- index を返す。
- index を index + 1 に設定する。
not-found を返す。
24.2.1.5 SetDataSize ( setData )
The
- count を 0 とする。
- setData の各要素 e について、次を行う：
- e が
empty でない場合、count を count + 1 に設定する。
- e が
- count を返す。
24.2.2 Setコンストラクター
Setコンストラクターは以下の通りです：
- %Set%である。
グローバルオブジェクト の"Set" プロパティの初期値である。- コンストラクターとして呼び出されたとき、新しい
Setオブジェクト を作成して初期化する。 - 関数として呼び出されることを意図しておらず、そのように呼び出された場合は例外をスローする。
- クラス定義の
extends節の値として使用できる。指定されたSetの動作を継承することを意図するサブクラスコンストラクターは、Set.prototype組み込みメソッドをサポートするために必要な内部状態を持つサブクラスインスタンスを作成して初期化するために、Setコンストラクターへのsuper呼び出しを含めなければならない。
24.2.2.1 Set ( [ iterable ] )
この関数は呼び出されたとき、次の手順を実行します：
- NewTarget が
undefined の場合、TypeError 例外をスローする。 - set を ?
OrdinaryCreateFromConstructor (NewTarget,"%Set.prototype%" , « [[SetData]] ») とする。 - set.[[SetData]] を新しい空の
List に設定する。 - iterable が
undefined またはnull のいずれかである場合、set を返す。 - adder を ?
Get (set,"add" ) とする。 IsCallable (adder) がfalse の場合、TypeError 例外をスローする。- iteratorRecord を ?
GetIterator (iterable,sync ) とする。 - 繰り返す：
- next を ?
IteratorStepValue (iteratorRecord) とする。 - next が
done の場合、set を返す。 - status を
Completion (Call (adder, set, « next »)) とする。 IfAbruptCloseIterator (status, iteratorRecord)。
- next を ?
24.2.3 Setコンストラクターのプロパティ
Setコンストラクターは以下の通りです：
- [[Prototype]]内部スロットを持ち、その値は
%Function.prototype% である。 - 以下のプロパティを持つ：
24.2.3.1 Set.prototype
Set.prototypeの初期値は
このプロパティの属性は { [[Writable]]:
24.2.3.2 get Set [ %Symbol.species% ]
Set[%Symbol.species%]は、setアクセサー関数が
this 値を返す。
この関数の
派生コレクションオブジェクトを作成するメソッドは、派生オブジェクトを作成するために使用するコンストラクターを決定するため、
24.2.4 Setプロトタイプオブジェクトのプロパティ
Setプロトタイプオブジェクトは以下の通りです：
- %Set.prototype%である。
- [[Prototype]]内部スロットを持ち、その値は
%Object.prototype% である。 - 通常のオブジェクトである。
- [[SetData]]内部スロットを持たない。
24.2.4.1 Set.prototype.add ( value )
このメソッドは呼び出されたとき、次の手順を実行します：
- set を
this 値とする。 - ?
RequireInternalSlot (set, [[SetData]]) を実行する。 - value を
CanonicalizeKeyedCollectionKey (value) に設定する。 - set.[[SetData]] の各要素 entry について、次を行う：
- entry が
empty でなく、SameValue (entry, value) がtrue である場合、次を行う：- set を返す。
- entry が
- value を set.[[SetData]] に追加する。
- set を返す。
24.2.4.2 Set.prototype.clear ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- set を
this 値とする。 - ?
RequireInternalSlot (set, [[SetData]]) を実行する。 - set.[[SetData]] の各要素 entry について、次を行う：
- 値が entry である set.[[SetData]] の要素を、値が
empty である要素で置き換える。
- 値が entry である set.[[SetData]] の要素を、値が
undefined を返す。
既存の[[SetData]]
24.2.4.3 Set.prototype.constructor
Set.prototype.constructorの初期値は
24.2.4.4 Set.prototype.delete ( value )
このメソッドは呼び出されたとき、次の手順を実行します：
- set を
this 値とする。 - ?
RequireInternalSlot (set, [[SetData]]) を実行する。 - value を
CanonicalizeKeyedCollectionKey (value) に設定する。 - set.[[SetData]] の各要素 entry について、次を行う：
- entry が
empty でなく、SameValue (entry, value) がtrue である場合、次を行う：- 値が entry である set.[[SetData]] の要素を、値が
empty である要素で置き換える。 true を返す。
- 値が entry である set.[[SetData]] の要素を、値が
- entry が
false を返す。
値
24.2.4.5 Set.prototype.difference ( other )
このメソッドは呼び出されたとき、次の手順を実行します：
- set を
this 値とする。 - ?
RequireInternalSlot (set, [[SetData]]) を実行する。 - otherRec を ?
GetSetRecord (other) とする。 - resultSetData を set.[[SetData]] のコピーとする。
SetDataSize (set.[[SetData]]) ≤ otherRec.[[Size]] の場合、次を行う：- thisSize を set.[[SetData]] 内の要素数とする。
- index を 0 とする。
- index < thisSize の間、繰り返す：
- それ以外の場合、
- keysIter を ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]]) とする。 - next を
not-started とする。 - next が
done でない間、繰り返す：- next を ?
IteratorStepValue (keysIter) に設定する。 - next が
done でない場合、次を行う：- next を
CanonicalizeKeyedCollectionKey (next) に設定する。 - valueIndex を
SetDataIndex (resultSetData, next) とする。 - valueIndex が
not-found でない場合、次を行う：- resultSetData[valueIndex] を
empty に設定する。
- resultSetData[valueIndex] を
- next を
- next を ?
- keysIter を ?
- result を
OrdinaryObjectCreate (%Set.prototype% , « [[SetData]] ») とする。 - result.[[SetData]] を resultSetData に設定する。
- result を返す。
24.2.4.6 Set.prototype.entries ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- set を
this 値とする。 - ?
CreateSetIterator (set,key+value ) を返す。
反復目的では、Setは各エントリーがキーと値に同じ値を持つMapに似て見えます。
24.2.4.7 Set.prototype.forEach ( callback [ , thisArg ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- set を
this 値とする。 - ?
RequireInternalSlot (set, [[SetData]]) を実行する。 IsCallable (callback) がfalse の場合、TypeError 例外をスローする。- entries を set.[[SetData]] とする。
- numEntries を entries 内の要素数とする。
- index を 0 とする。
- index < numEntries の間、繰り返す：
undefined を返す。
callback は3つの引数を受け取る関数であるべきです。forEachは、
thisArg パラメーターが提供された場合、それは callback の各呼び出しの
callback は3つの引数で呼び出されます。最初の2つの引数はSetに含まれる値です。同じ値が両方の引数に渡されます。走査されている
callback が3つの引数で呼び出されるのは、MapおよびArrayのforEachメソッドで使用されるコールバック関数と整合させるためです。Setでは、各項目値はキーでも値でもあるとみなされます。
forEachは、それが呼び出されたオブジェクトを直接変更しませんが、callback の呼び出しによってそのオブジェクトが変更される可能性があります。
各値は通常1回だけ訪問されます。ただし、値は訪問された後に削除され、forEachの呼び出しが完了する前に再び追加された場合、再訪問されます。forEachの呼び出しが開始された後、訪問される前に削除された値は、forEachの呼び出しが完了する前にその値が再び追加されない限り、訪問されません。forEachの呼び出しが開始された後に追加された新しい値は訪問されます。
24.2.4.8 Set.prototype.has ( value )
このメソッドは呼び出されたとき、次の手順を実行します：
- set を
this 値とする。 - ?
RequireInternalSlot (set, [[SetData]]) を実行する。 - value を
CanonicalizeKeyedCollectionKey (value) に設定する。 - set.[[SetData]] の各要素 entry について、次を行う：
- entry が
empty でなく、SameValue (entry, value) がtrue である場合、true を返す。
- entry が
false を返す。
24.2.4.9 Set.prototype.intersection ( other )
このメソッドは呼び出されたとき、次の手順を実行します：
- set を
this 値とする。 - ?
RequireInternalSlot (set, [[SetData]]) を実行する。 - otherRec を ?
GetSetRecord (other) とする。 - resultSetData を新しい空の
List とする。 SetDataSize (set.[[SetData]]) ≤ otherRec.[[Size]] の場合、次を行う：- thisSize を set.[[SetData]] 内の要素数とする。
- index を 0 とする。
- index < thisSize の間、繰り返す：
- entry を set.[[SetData]][index] とする。
- index を index + 1 に設定する。
- entry が
empty でない場合、次を行う：- inOther を
ToBoolean (?Call (otherRec.[[Has]], otherRec.[[SetObject]], « entry »)) とする。 - inOther が
true である場合、次を行う：NOTE : otherRec.[[Has]] への以前の呼び出しが set.[[SetData]] の要素を削除して再追加する可能性があり、それによりこの反復中に同じ要素が2回訪問されることがある。SetDataHas (resultSetData, entry) がfalse である場合、次を行う：- entry を resultSetData に追加する。
NOTE : otherRec.[[Has]] の実行中に set.[[SetData]] 内の要素数が増加している可能性がある。- thisSize を set.[[SetData]] 内の要素数に設定する。
- inOther を
- それ以外の場合、
- keysIter を ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]]) とする。 - next を
not-started とする。 - next が
done でない間、繰り返す：- next を ?
IteratorStepValue (keysIter) に設定する。 - next が
done でない場合、次を行う：- next を
CanonicalizeKeyedCollectionKey (next) に設定する。 - inThis を
SetDataHas (set.[[SetData]], next) とする。 - inThis が
true である場合、次を行う：NOTE : other は任意のオブジェクトであるため、その"keys" イテレーターが同じ値を複数回生成する可能性がある。SetDataHas (resultSetData, next) がfalse である場合、次を行う：- next を resultSetData に追加する。
- next を
- next を ?
- keysIter を ?
- result を
OrdinaryObjectCreate (%Set.prototype% , « [[SetData]] ») とする。 - result.[[SetData]] を resultSetData に設定する。
- result を返す。
24.2.4.10 Set.prototype.isDisjointFrom ( other )
このメソッドは呼び出されたとき、次の手順を実行します：
- set を
this 値とする。 - ?
RequireInternalSlot (set, [[SetData]]) を実行する。 - otherRec を ?
GetSetRecord (other) とする。 SetDataSize (set.[[SetData]]) ≤ otherRec.[[Size]] の場合、次を行う：- thisSize を set.[[SetData]] 内の要素数とする。
- index を 0 とする。
- index < thisSize の間、繰り返す：
- entry を set.[[SetData]][index] とする。
- index を index + 1 に設定する。
- entry が
empty でない場合、次を行う：
- それ以外の場合、
- keysIter を ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]]) とする。 - next を
not-started とする。 - next が
done でない間、繰り返す：- next を ?
IteratorStepValue (keysIter) に設定する。 - next が
done でない場合、次を行う：SetDataHas (set.[[SetData]], next) がtrue である場合、次を行う：- ?
IteratorClose (keysIter,NormalCompletion (unused )) を実行する。 false を返す。
- ?
- next を ?
- keysIter を ?
true を返す。
24.2.4.11 Set.prototype.isSubsetOf ( other )
このメソッドは呼び出されたとき、次の手順を実行します：
- set を
this 値とする。 - ?
RequireInternalSlot (set, [[SetData]]) を実行する。 - otherRec を ?
GetSetRecord (other) とする。 SetDataSize (set.[[SetData]]) > otherRec.[[Size]] の場合、false を返す。- thisSize を set.[[SetData]] 内の要素数とする。
- index を 0 とする。
- index < thisSize の間、繰り返す：
- entry を set.[[SetData]][index] とする。
- index を index + 1 に設定する。
- entry が
empty でない場合、次を行う：
true を返す。
24.2.4.12 Set.prototype.isSupersetOf ( other )
このメソッドは呼び出されたとき、次の手順を実行します：
- set を
this 値とする。 - ?
RequireInternalSlot (set, [[SetData]]) を実行する。 - otherRec を ?
GetSetRecord (other) とする。 SetDataSize (set.[[SetData]]) < otherRec.[[Size]] の場合、false を返す。- keysIter を ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]]) とする。 - next を
not-started とする。 - next が
done でない間、繰り返す：- next を ?
IteratorStepValue (keysIter) に設定する。 - next が
done でない場合、次を行う：SetDataHas (set.[[SetData]], next) がfalse である場合、次を行う：- ?
IteratorClose (keysIter,NormalCompletion (unused )) を実行する。 false を返す。
- ?
- next を ?
true を返す。
24.2.4.13 Set.prototype.keys ( )
反復目的では、Setは各エントリーがキーと値に同じ値を持つMapに似て見えます。
24.2.4.14 get Set.prototype.size
Set.prototype.sizeは、setアクセサー関数が
- set を
this 値とする。 - ?
RequireInternalSlot (set, [[SetData]]) を実行する。 - size を
SetDataSize (set.[[SetData]]) とする。 𝔽 (size) を返す。
24.2.4.15 Set.prototype.symmetricDifference ( other )
このメソッドは呼び出されたとき、次の手順を実行します：
- set を
this 値とする。 - ?
RequireInternalSlot (set, [[SetData]]) を実行する。 - otherRec を ?
GetSetRecord (other) とする。 - keysIter を ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]]) とする。 - resultSetData を set.[[SetData]] のコピーとする。
- next を
not-started とする。 - next が
done でない間、繰り返す：- next を ?
IteratorStepValue (keysIter) に設定する。 - next が
done でない場合、次を行う：- next を
CanonicalizeKeyedCollectionKey (next) に設定する。 - resultIndex を
SetDataIndex (resultSetData, next) とする。 - resultIndex が
not-found である場合、alreadyInResult をfalse とする。そうでない場合、alreadyInResult をtrue とする。 SetDataHas (set.[[SetData]], next) がtrue である場合、次を行う：- alreadyInResult が
true である場合、resultSetData[resultIndex] をempty に設定する。
- alreadyInResult が
- それ以外の場合、
- alreadyInResult が
false である場合、next を resultSetData に追加する。
- alreadyInResult が
- next を
- next を ?
- result を
OrdinaryObjectCreate (%Set.prototype% , « [[SetData]] ») とする。 - result.[[SetData]] を resultSetData に設定する。
- result を返す。
24.2.4.16 Set.prototype.union ( other )
このメソッドは呼び出されたとき、次の手順を実行します：
- set を
this 値とする。 - ?
RequireInternalSlot (set, [[SetData]]) を実行する。 - otherRec を ?
GetSetRecord (other) とする。 - keysIter を ?
GetIteratorFromMethod (otherRec.[[SetObject]], otherRec.[[Keys]]) とする。 - resultSetData を set.[[SetData]] のコピーとする。
- next を
not-started とする。 - next が
done でない間、繰り返す：- next を ?
IteratorStepValue (keysIter) に設定する。 - next が
done でない場合、次を行う：- next を
CanonicalizeKeyedCollectionKey (next) に設定する。 SetDataHas (resultSetData, next) がfalse である場合、次を行う：- next を resultSetData に追加する。
- next を
- next を ?
- result を
OrdinaryObjectCreate (%Set.prototype% , « [[SetData]] ») とする。 - result.[[SetData]] を resultSetData に設定する。
- result を返す。
24.2.4.17 Set.prototype.values ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- set を
this 値とする。 - ?
CreateSetIterator (set,value ) を返す。
24.2.4.18 Set.prototype [ %Symbol.iterator% ] ( )
24.2.4.19 Set.prototype [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
24.2.5 Setインスタンスのプロパティ
Setインスタンスは、
24.2.6 Set Iteratorオブジェクト
Set Iteratorは、下記で定義される構造を持つ通常のオブジェクトであり、ある特定のSetインスタンスオブジェクトに対する特定の反復を表します。Set Iteratorオブジェクトには名前付きコンストラクターはありません。代わりに、Set IteratorオブジェクトはSetインスタンスオブジェクトの特定のメソッドを呼び出すことによって作成されます。
24.2.6.1 CreateSetIterator ( set, kind )
The
- ?
RequireInternalSlot (set, [[SetData]]) を実行する。 - closure を、set と kind を捕捉し、呼び出されたときに次の手順を実行する、パラメーターを持たない新しい
Abstract Closure とする：- index を 0 とする。
- entries を set.[[SetData]] とする。
- numEntries を entries 内の要素数とする。
- index < numEntries の間、繰り返す：
- 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 :GeneratorYield によってこの抽象操作の実行が一時停止されている間に、entries 内の要素数が増加している可能性がある。- numEntries を entries 内の要素数に設定する。
- kind が
NormalCompletion (unused ) を返す。
CreateIteratorFromClosure (closure,"%SetIteratorPrototype%" ,%SetIteratorPrototype% ) を返す。
24.2.6.2 %SetIteratorPrototype%オブジェクト
%SetIteratorPrototype%オブジェクトは以下の通りです：
- すべての
Set Iterator オブジェクトによって継承されるプロパティを持つ。 - 通常のオブジェクトである。
- [[Prototype]]内部スロットを持ち、その値は
%Iterator.prototype% である。 - 以下のプロパティを持つ：
24.2.6.2.1 %SetIteratorPrototype%.next ( )
- ?
GeneratorResume (this value,empty ,"%SetIteratorPrototype%" ) を返す。
24.2.6.2.2 %SetIteratorPrototype% [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
24.3 WeakMapオブジェクト
WeakMapは、キーがオブジェクトおよび/またはシンボルであり、値が任意のECMAScript言語値であってよいキー/値ペアのコレクションです。WeakMapは、特定のキーを持つキー/値ペアを含むかどうかを問い合わせることができますが、それがキーとして保持する値を列挙する機構は提供されません。特定の条件では、
実装は、WeakMapのキー/値ペアがアクセス不能になった時点から、そのキー/値ペアがWeakMapから削除される時点までの間に、任意に決定された遅延を課してもよいです。この遅延がECMAScriptプログラムから観察可能であった場合、それはプログラム実行に影響し得る不確定性の源となります。そのため、ECMAScript実装は、観察者が観察対象のキーを提示することを要求しない方法でWeakMapのキーを観察する手段を提供してはなりません。
WeakMapは、平均してコレクション内のキー/値ペア数に対してサブリニアなアクセス時間を提供するハッシュテーブルまたはその他の機構を使用して実装されなければなりません。この仕様で使用されるデータ構造は、WeakMapに要求される観察可能な意味論を記述することのみを意図しています。実行可能な実装モデルであることは意図していません。
WeakMapおよびWeakSetは、WeakMapまたはWeakSetインスタンスが存在しない場合にはそのオブジェクトまたはシンボルがアクセス不能になり、実装のガベージコレクション機構によるリソース回収の対象となるような状況で、メモリリソースを「リーク」しない方法で、オブジェクトまたはシンボルに状態を動的に関連付けるための機構を提供することを意図しています。この特性は、WeakMapまたはWeakSetインスタンスからキーへの、オブジェクト/シンボルごとの反転マッピングを使用することで達成できます。あるいは、各WeakMapまたはWeakSetインスタンスが内部的にそのキーおよび値データを格納してもよいですが、この方法ではWeakMapまたはWeakSetの実装とガベージコレクターの間の調整が必要です。以下の参照文献は、WeakMapおよびWeakSetの実装に有用である可能性のある機構を記述しています：
Barry Hayes. 1997. Ephemerons: a new finalization mechanism. In Proceedings of the 12th ACM SIGPLAN conference on Object-oriented programming, systems, languages, and applications (OOPSLA '97), A. Michael Berman (Ed.). ACM, New York, NY, USA, 176-183, http://doi.acm.org/10.1145/263698.263733.
Alexandra Barros, Roberto Ierusalimschy, Eliminating Cycles in Weak Tables. Journal of Universal Computer Science - J.UCS, vol. 14, no. 21, pp. 3481-3497, 2008, http://www.jucs.org/jucs_14_21/eliminating_cycles_in_weak
24.3.1 WeakMapコンストラクター
WeakMapコンストラクターは以下の通りです：
- %WeakMap%である。
グローバルオブジェクト の"WeakMap" プロパティの初期値である。- コンストラクターとして呼び出されたとき、新しいWeakMapを作成して初期化する。
- 関数として呼び出されることを意図しておらず、そのように呼び出された場合は例外をスローする。
- クラス定義の
extends節の値として使用できる。指定されたWeakMapの動作を継承することを意図するサブクラスコンストラクターは、WeakMap.prototype組み込みメソッドをサポートするために必要な内部状態を持つサブクラスインスタンスを作成して初期化するために、WeakMapコンストラクターへのsuper呼び出しを含めなければならない。
24.3.1.1 WeakMap ( [ iterable ] )
この関数は呼び出されたとき、次の手順を実行します：
- NewTarget が
undefined の場合、TypeError 例外をスローする。 - map を ?
OrdinaryCreateFromConstructor (NewTarget,"%WeakMap.prototype%" , « [[WeakMapData]] ») とする。 - map.[[WeakMapData]] を新しい空の
List に設定する。 - iterable が
undefined またはnull のいずれかである場合、map を返す。 - adder を ?
Get (map,"set" ) とする。 IsCallable (adder) がfalse の場合、TypeError 例外をスローする。- ?
AddEntriesFromIterable (map, iterable, adder) を返す。
パラメーター iterable が存在する場合、それは、WeakMapキーとして使用される値を第1要素とし、そのキーに関連付ける値を第2要素とする2要素の
24.3.2 WeakMapコンストラクターのプロパティ
WeakMapコンストラクターは以下の通りです：
- [[Prototype]]内部スロットを持ち、その値は
%Function.prototype% である。 - 以下のプロパティを持つ：
24.3.2.1 WeakMap.prototype
WeakMap.prototypeの初期値は
このプロパティの属性は { [[Writable]]:
24.3.3 WeakMapプロトタイプオブジェクトのプロパティ
WeakMapプロトタイプオブジェクトは以下の通りです：
- %WeakMap.prototype%である。
- [[Prototype]]内部スロットを持ち、その値は
%Object.prototype% である。 - 通常のオブジェクトである。
- [[WeakMapData]]内部スロットを持たない。
24.3.3.1 WeakMap.prototype.constructor
WeakMap.prototype.constructorの初期値は
24.3.3.2 WeakMap.prototype.delete ( key )
このメソッドは呼び出されたとき、次の手順を実行します：
- weakMap を
this 値とする。 - ?
RequireInternalSlot (weakMap, [[WeakMapData]]) を実行する。 CanBeHeldWeakly (key) がfalse の場合、false を返す。- weakMap.[[WeakMapData]] の各
Record { [[Key]], [[Value]] } entry について、次を行う：- entry.[[Key]] が
empty でなく、SameValue (entry.[[Key]], key) がtrue である場合、次を行う：- entry.[[Key]] を
empty に設定する。 - entry.[[Value]] を
empty に設定する。 true を返す。
- entry.[[Key]] を
- entry.[[Key]] が
false を返す。
値
24.3.3.3 WeakMap.prototype.get ( key )
このメソッドは呼び出されたとき、次の手順を実行します：
- weakMap を
this 値とする。 - ?
RequireInternalSlot (weakMap, [[WeakMapData]]) を実行する。 CanBeHeldWeakly (key) がfalse の場合、undefined を返す。- weakMap.[[WeakMapData]] の各
Record { [[Key]], [[Value]] } entry について、次を行う：- entry.[[Key]] が
empty でなく、SameValue (entry.[[Key]], key) がtrue である場合、entry.[[Value]] を返す。
- entry.[[Key]] が
undefined を返す。
24.3.3.4 WeakMap.prototype.getOrInsert ( key, value )
このメソッドは呼び出されたとき、次の手順を実行します：
- weakMap を
this 値とする。 - ?
RequireInternalSlot (weakMap, [[WeakMapData]]) を実行する。 CanBeHeldWeakly (key) がfalse の場合、TypeError 例外をスローする。- weakMap.[[WeakMapData]] の各
Record { [[Key]], [[Value]] } entry について、次を行う：- entry.[[Key]] が
empty でなく、SameValue (entry.[[Key]], key) がtrue である場合、entry.[[Value]] を返す。
- entry.[[Key]] が
- entry を
Record { [[Key]]: key, [[Value]]: value } とする。 - entry を weakMap.[[WeakMapData]] に追加する。
- value を返す。
24.3.3.5 WeakMap.prototype.getOrInsertComputed ( key, callback )
このメソッドは呼び出されたとき、次の手順を実行します：
- weakMap を
this 値とする。 - ?
RequireInternalSlot (weakMap, [[WeakMapData]]) を実行する。 CanBeHeldWeakly (key) がfalse の場合、TypeError 例外をスローする。IsCallable (callback) がfalse の場合、TypeError 例外をスローする。- weakMap.[[WeakMapData]] の各
Record { [[Key]], [[Value]] } entry について、次を行う：- entry.[[Key]] が
empty でなく、SameValue (entry.[[Key]], key) がtrue である場合、entry.[[Value]] を返す。
- entry.[[Key]] が
- value を ?
Call (callback,undefined , « key ») とする。 NOTE : callback の実行中にWeakMapが変更されている可能性がある。- weakMap.[[WeakMapData]] の各
Record { [[Key]], [[Value]] } entry について、次を行う：- entry.[[Key]] が
empty でなく、SameValue (entry.[[Key]], key) がtrue である場合、次を行う：- entry.[[Value]] を value に設定する。
- value を返す。
- entry.[[Key]] が
- entry を
Record { [[Key]]: key, [[Value]]: value } とする。 - entry を weakMap.[[WeakMapData]] に追加する。
- value を返す。
24.3.3.6 WeakMap.prototype.has ( key )
このメソッドは呼び出されたとき、次の手順を実行します：
- weakMap を
this 値とする。 - ?
RequireInternalSlot (weakMap, [[WeakMapData]]) を実行する。 CanBeHeldWeakly (key) がfalse の場合、false を返す。- weakMap.[[WeakMapData]] の各
Record { [[Key]], [[Value]] } entry について、次を行う：- entry.[[Key]] が
empty でなく、SameValue (entry.[[Key]], key) がtrue である場合、true を返す。
- entry.[[Key]] が
false を返す。
24.3.3.7 WeakMap.prototype.set ( key, value )
このメソッドは呼び出されたとき、次の手順を実行します：
- weakMap を
this 値とする。 - ?
RequireInternalSlot (weakMap, [[WeakMapData]]) を実行する。 CanBeHeldWeakly (key) がfalse の場合、TypeError 例外をスローする。- weakMap.[[WeakMapData]] の各
Record { [[Key]], [[Value]] } entry について、次を行う：- entry.[[Key]] が
empty でなく、SameValue (entry.[[Key]], key) がtrue である場合、次を行う：- entry.[[Value]] を value に設定する。
- weakMap を返す。
- entry.[[Key]] が
- entry を
Record { [[Key]]: key, [[Value]]: value } とする。 - entry を weakMap.[[WeakMapData]] に追加する。
- weakMap を返す。
24.3.3.8 WeakMap.prototype [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
24.3.4 WeakMapインスタンスのプロパティ
WeakMapインスタンスは、
24.4 WeakSetオブジェクト
WeakSetはオブジェクトおよび/またはシンボルのコレクションです。異なるオブジェクトまたはシンボルは、WeakSetのコレクションの要素として一度だけ出現できます。WeakSetは、特定の値を含むかどうかを問い合わせることができますが、それが保持する値を列挙する機構は提供されません。特定の条件では、
実装は、WeakSetに含まれる値がアクセス不能になった時点から、その値がWeakSetから削除される時点までの間に、任意に決定された遅延を課してもよいです。この遅延がECMAScriptプログラムから観察可能であった場合、それはプログラム実行に影響し得る不確定性の源となります。そのため、ECMAScript実装は、観察者が観察対象の値を提示することを要求しない方法で、WeakSetが特定の値を含むかどうかを判定する手段を提供してはなりません。
WeakSetは、平均してコレクション内の要素数に対してサブリニアなアクセス時間を提供するハッシュテーブルまたはその他の機構を使用して実装されなければなりません。この仕様で使用されるデータ構造は、WeakSetに要求される観察可能な意味論を記述することのみを意図しています。実行可能な実装モデルであることは意図していません。
24.4.1 WeakSetコンストラクター
WeakSetコンストラクターは以下の通りです：
- %WeakSet%である。
グローバルオブジェクト の"WeakSet" プロパティの初期値である。- コンストラクターとして呼び出されたとき、新しいWeakSetを作成して初期化する。
- 関数として呼び出されることを意図しておらず、そのように呼び出された場合は例外をスローする。
- クラス定義の
extends節の値として使用できる。指定されたWeakSetの動作を継承することを意図するサブクラスコンストラクターは、WeakSet.prototype組み込みメソッドをサポートするために必要な内部状態を持つサブクラスインスタンスを作成して初期化するために、WeakSetコンストラクターへのsuper呼び出しを含めなければならない。
24.4.1.1 WeakSet ( [ iterable ] )
この関数は呼び出されたとき、次の手順を実行します：
- NewTarget が
undefined の場合、TypeError 例外をスローする。 - set を ?
OrdinaryCreateFromConstructor (NewTarget,"%WeakSet.prototype%" , « [[WeakSetData]] ») とする。 - set.[[WeakSetData]] を新しい空の
List に設定する。 - iterable が
undefined またはnull のいずれかである場合、set を返す。 - adder を ?
Get (set,"add" ) とする。 IsCallable (adder) がfalse の場合、TypeError 例外をスローする。- iteratorRecord を ?
GetIterator (iterable,sync ) とする。 - 繰り返す：
- next を ?
IteratorStepValue (iteratorRecord) とする。 - next が
done の場合、set を返す。 - status を
Completion (Call (adder, set, « next »)) とする。 IfAbruptCloseIterator (status, iteratorRecord)。
- next を ?
24.4.2 WeakSetコンストラクターのプロパティ
WeakSetコンストラクターは以下の通りです：
- [[Prototype]]内部スロットを持ち、その値は
%Function.prototype% である。 - 以下のプロパティを持つ：
24.4.2.1 WeakSet.prototype
WeakSet.prototypeの初期値は
このプロパティの属性は { [[Writable]]:
24.4.3 WeakSetプロトタイプオブジェクトのプロパティ
WeakSetプロトタイプオブジェクトは以下の通りです：
- %WeakSet.prototype%である。
- [[Prototype]]内部スロットを持ち、その値は
%Object.prototype% である。 - 通常のオブジェクトである。
- [[WeakSetData]]内部スロットを持たない。
24.4.3.1 WeakSet.prototype.add ( value )
このメソッドは呼び出されたとき、次の手順を実行します：
- weakSet を
this 値とする。 - ?
RequireInternalSlot (weakSet, [[WeakSetData]]) を実行する。 CanBeHeldWeakly (value) がfalse の場合、TypeError 例外をスローする。- weakSet.[[WeakSetData]] の各要素 entry について、次を行う：
- entry が
empty でなく、SameValue (entry, value) がtrue である場合、次を行う：- weakSet を返す。
- entry が
- value を weakSet.[[WeakSetData]] に追加する。
- weakSet を返す。
24.4.3.2 WeakSet.prototype.constructor
WeakSet.prototype.constructorの初期値は
24.4.3.3 WeakSet.prototype.delete ( value )
このメソッドは呼び出されたとき、次の手順を実行します：
- weakSet を
this 値とする。 - ?
RequireInternalSlot (weakSet, [[WeakSetData]]) を実行する。 CanBeHeldWeakly (value) がfalse の場合、false を返す。- weakSet.[[WeakSetData]] の各要素 entry について、次を行う：
- entry が
empty でなく、SameValue (entry, value) がtrue である場合、次を行う：- 値が entry である weakSet.[[WeakSetData]] の要素を、値が
empty である要素で置き換える。 true を返す。
- 値が entry である weakSet.[[WeakSetData]] の要素を、値が
- entry が
false を返す。
値
24.4.3.4 WeakSet.prototype.has ( value )
このメソッドは呼び出されたとき、次の手順を実行します：
- weakSet を
this 値とする。 - ?
RequireInternalSlot (weakSet, [[WeakSetData]]) を実行する。 CanBeHeldWeakly (value) がfalse の場合、false を返す。- weakSet.[[WeakSetData]] の各要素 entry について、次を行う：
- entry が
empty でなく、SameValue (entry, value) がtrue である場合、true を返す。
- entry が
false を返す。
24.4.3.5 WeakSet.prototype [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
24.4.4 WeakSetインスタンスのプロパティ
WeakSetインスタンスは、
24.5 キー付きコレクションのための抽象操作
24.5.1 CanonicalizeKeyedCollectionKey ( key )
The
- key が
-0 𝔽 の場合、+0 𝔽 を返す。 - key を返す。
25 構造化データ
25.1 ArrayBufferオブジェクト
25.1.1 表記
この節、
read-modify-write変更関数とは、2つのバイト値の
- すべてのアルゴリズム手順を原子的に実行する。
- 個々のアルゴリズム手順は観察可能でない。
read-modify-write変更関数のアルゴリズム手順が純粋な数学的関数を構成することの検証を助けるため、次の編集上の慣例が推奨されます：
- パラメーターおよび捕捉された値を除き、直接にも、呼び出された抽象操作および
Abstract Closure を介して推移的にも、いかなる言語値または仕様値にもアクセスしない。 Completion Record を返す抽象操作およびAbstract Closure を、直接にも推移的にも呼び出さない。Completion Record を返さない。
25.1.2 固定長およびサイズ変更可能なArrayBufferオブジェクト
固定長ArrayBufferとは、作成後にバイト長を変更できないArrayBufferです。
サイズ変更可能なArrayBufferとは、作成後に
作成されるArrayBufferオブジェクトの種類は、
25.1.3 ArrayBufferオブジェクトのための抽象操作
25.1.3.1 AllocateArrayBuffer ( constructor, byteLength [ , maxByteLength ] )
The
- 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 (constructor,"%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
IsGrowableSharedArrayBuffer (arrayBuffer) がtrue の場合、- bufferByteLengthBlock を arrayBuffer.[[ArrayBufferByteLengthData]] とする。
- rawLength を
GetRawBytesFromSharedBlock (bufferByteLengthBlock, 0,biguint64 ,true , order) とする。 - agentRecord を周囲のエージェントの
Agent Record とする。 - isLittleEndian を agentRecord.[[LittleEndian]] とする。
ℝ (RawBytesToNumeric (biguint64 , rawLength, isLittleEndian)) を返す。
Assert :IsDetachedBuffer (arrayBuffer) はfalse である。- arrayBuffer.[[ArrayBufferByteLength]] を返す。
25.1.3.3 ArrayBufferCopyAndDetach ( arrayBuffer, newLength, preserveResizability )
The
- ?
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) を実行する。NOTE : 新しいData Block の作成も古いData Block からのコピーも観察可能ではありません。実装はこのメソッドをゼロコピー移動またはreallocとして実装してもよいです。- !
DetachArrayBuffer (arrayBuffer) を実行する。 - newBuffer を返す。
25.1.3.4 IsDetachedBuffer ( arrayBuffer )
The
- arrayBuffer.[[ArrayBufferData]] が
null の場合、true を返す。 false を返す。
25.1.3.5 DetachArrayBuffer ( arrayBuffer [ , key ] )
The
Assert :IsSharedArrayBuffer (arrayBuffer) はfalse である。- key が存在しない場合、key を
undefined に設定する。 - arrayBuffer.[[ArrayBufferDetachKey]] が key でない場合、
TypeError 例外をスローする。 - arrayBuffer.[[ArrayBufferData]] を
null に設定する。 - arrayBuffer.[[ArrayBufferByteLength]] を0に設定する。
unused を返す。
ArrayBufferインスタンスをデタッチすると、そのバッキングストアとして使用される
25.1.3.6 CloneArrayBuffer ( srcBuffer, srcByteOffset, srcLength )
The
Assert :IsDetachedBuffer (srcBuffer) はfalse である。- targetBuffer を ?
AllocateArrayBuffer (%ArrayBuffer% , srcLength) とする。 - srcBlock を srcBuffer.[[ArrayBufferData]] とする。
- targetBlock を targetBuffer.[[ArrayBufferData]] とする。
CopyDataBlockBytes (targetBlock, 0, srcBlock, srcByteOffset, srcLength) を実行する。- targetBuffer を返す。
25.1.3.7 GetArrayBufferMaxByteLengthOption ( options )
The
25.1.3.8 HostResizeArrayBuffer ( buffer, newByteLength )
The
HostResizeArrayBufferの実装は、次の要件に適合しなければなりません：
- この抽象操作は buffer をデタッチしない。
- この抽象操作が
handled で正常完了する場合、buffer.[[ArrayBufferByteLength]] は newByteLength である。
HostResizeArrayBufferの既定の実装は
25.1.3.9 IsFixedLengthArrayBuffer ( arrayBuffer )
The
- arrayBuffer が [[ArrayBufferMaxByteLength]] 内部スロットを持つ場合、
false を返す。 true を返す。
25.1.3.10 IsUnsignedElementType ( type )
The
- type が
uint8 、uint8clamped 、uint16 、uint32 、またはbiguint64 のいずれかである場合、true を返す。 false を返す。
25.1.3.11 IsUnclampedIntegerElementType ( type )
The
- type が
int8 、uint8 、int16 、uint16 、int32 、またはuint32 のいずれかである場合、true を返す。 false を返す。
25.1.3.12 IsBigIntElementType ( type )
The
- type が
biguint64 またはbigint64 のいずれかである場合、true を返す。 false を返す。
25.1.3.13 IsNoTearConfiguration ( type, order )
The
IsUnclampedIntegerElementType (type) がtrue の場合、true を返す。IsBigIntElementType (type) がtrue であり、order がinit でもunordered でもない場合、true を返す。false を返す。
25.1.3.14 RawBytesToNumeric ( type, rawBytes, isLittleEndian )
The
- elementSize を
Table 70 のElement Type type に対して指定されたElement Size値とする。 - isLittleEndian が
false の場合、rawBytes の要素の順序を反転する。 - type が
float16 の場合、- value を、rawBytes のバイト要素を連結し、
IEEE 754-2019 binary16値のリトルエンディアンビット文字列エンコーディングとして解釈したものとする。 - value がNaNである場合、
NaN を返す。 - value に対応するNumber値を返す。
- value を、rawBytes のバイト要素を連結し、
- type が
float32 の場合、- value を、rawBytes のバイト要素を連結し、
IEEE 754-2019 binary32値のリトルエンディアンビット文字列エンコーディングとして解釈したものとする。 - value がNaNである場合、
NaN を返す。 - value に対応するNumber値を返す。
- value を、rawBytes のバイト要素を連結し、
- type が
float64 の場合、- value を、rawBytes のバイト要素を連結し、
IEEE 754-2019 binary64値のリトルエンディアンビット文字列エンコーディングとして解釈したものとする。 - value がNaNである場合、
NaN を返す。 - value に対応するNumber値を返す。
- value を、rawBytes のバイト要素を連結し、
IsUnsignedElementType (type) がtrue の場合、- intValue を、rawBytes のバイト要素を連結し、符号なしリトルエンディアン2進数のビット文字列エンコーディングとして解釈したものとする。
- そうでなければ、
- intValue を、rawBytes のバイト要素を連結し、ビット長 elementSize × 8 の2進リトルエンディアン2の補数のビット文字列エンコーディングとして解釈したものとする。
IsBigIntElementType (type) がtrue の場合、intValue に対応するBigInt値を返す。- intValue に対応するNumber値を返す。
25.1.3.15 GetRawBytesFromSharedBlock ( block, byteIndex, type, isTypedArray, order )
The
- elementSize を
Table 70 のElement Type type に対して指定された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 とする。 NOTE : 実装では、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
Assert :IsDetachedBuffer (arrayBuffer) はfalse である。Assert : arrayBuffer 内の byteIndex から始まる十分なバイトがあり、type の値を表せる。- block を arrayBuffer.[[ArrayBufferData]] とする。
- elementSize を
Table 70 のElement Type type に対して指定されたElement Size値とする。 IsSharedArrayBuffer (arrayBuffer) がtrue の場合、Assert : block はShared Data Block である。- rawValue を
GetRawBytesFromSharedBlock (block, byteIndex, type, isTypedArray, order) とする。
- そうでなければ、
- rawValue を、byteIndex（含む）から byteIndex + elementSize（含まない）までの区間のインデックスにある block からのバイトを要素とする
List とする。
- rawValue を、byteIndex（含む）から byteIndex + elementSize（含まない）までの区間のインデックスにある block からのバイトを要素とする
Assert : rawValue の要素数は elementSize である。- isLittleEndian が存在しない場合、
- agentRecord を周囲のエージェントの
Agent Record とする。 - isLittleEndian を agentRecord.[[LittleEndian]] に設定する。
- agentRecord を周囲のエージェントの
RawBytesToNumeric (type, rawValue, isLittleEndian) を返す。
25.1.3.17 NumericToRawBytes ( type, value, isLittleEndian )
The
- type が
float16 の場合、- rawBytes を、value をroundTiesToEvenモードを用いて
IEEE 754-2019 binary16形式に変換した結果である2バイトを要素とするList とする。バイトはリトルエンディアン順に並べられる。value がNaN の場合、rawBytes は実装が選択した任意のIEEE 754-2019 binary16形式のNaNエンコーディングに設定されてもよい。実装は、実装上区別可能な各NaN 値について常に同じエンコーディングを選択しなければならない。
- rawBytes を、value をroundTiesToEvenモードを用いて
- そうでなく type が
float32 の場合、- rawBytes を、value をroundTiesToEvenモードを用いて
IEEE 754-2019 binary32形式に変換した結果である4バイトを要素とするList とする。バイトはリトルエンディアン順に並べられる。value がNaN の場合、rawBytes は実装が選択した任意のIEEE 754-2019 binary32形式のNaNエンコーディングに設定されてもよい。実装は、実装上区別可能な各NaN 値について常に同じエンコーディングを選択しなければならない。
- rawBytes を、value をroundTiesToEvenモードを用いて
- そうでなく type が
float64 の場合、- rawBytes を、value の
IEEE 754-2019 binary64形式エンコーディングである8バイトを要素とするList とする。バイトはリトルエンディアン順に並べられる。value がNaN の場合、rawBytes は実装が選択した任意のIEEE 754-2019 binary64形式のNaNエンコーディングに設定されてもよい。実装は、実装上区別可能な各NaN 値について常に同じエンコーディングを選択しなければならない。
- rawBytes を、value の
- そうでなければ、
- n を
Table 70 のElement Type type に対して指定されたElement Size値とする。 - conversionOperation を、
Table 70 のElement Type type に対する“Conversion Operation”列で名付けられた抽象操作とする。 - intValue を
ℝ (! conversionOperation(value)) とする。 - intValue ≥ 0 の場合、
- rawBytes を、intValue の n バイト2進エンコーディングを要素とする
List とする。バイトはリトルエンディアン順に並べられる。
- rawBytes を、intValue の n バイト2進エンコーディングを要素とする
- そうでなければ、
- rawBytes を、intValue の n バイト2進2の補数エンコーディングを要素とする
List とする。バイトはリトルエンディアン順に並べられる。
- rawBytes を、intValue の n バイト2進2の補数エンコーディングを要素とする
- n を
- isLittleEndian が
false の場合、rawBytes の要素の順序を反転する。 - rawBytes を返す。
25.1.3.18 SetValueInBuffer ( arrayBuffer, byteIndex, type, value, isTypedArray, order [ , isLittleEndian ] )
The
Assert :IsDetachedBuffer (arrayBuffer) はfalse である。Assert : arrayBuffer 内の byteIndex から始まる十分なバイトがあり、type の値を表せる。Assert :IsBigIntElementType (type) がtrue である場合、value はBigIntである。そうでなければ、value はNumberである。- block を arrayBuffer.[[ArrayBufferData]] とする。
- elementSize を
Table 70 のElement Type type に対して指定された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
Assert :IsDetachedBuffer (arrayBuffer) はfalse である。Assert : arrayBuffer 内の byteIndex から始まる十分なバイトがあり、type の値を表せる。Assert :IsBigIntElementType (type) がtrue である場合、value はBigIntである。そうでなければ、value はNumberである。- block を arrayBuffer.[[ArrayBufferData]] とする。
- elementSize を
Table 70 のElement Type type に対して指定された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 とする。 NOTE : 実装では、rawBytesRead は基盤ハードウェア上のload-link、load-exclusive、またはread-modify-write命令のオペランドの結果です。この非決定性は、弱い一貫性を持つハードウェアの観察可能な動作を記述するためのメモリモデル の意味論上の規定です。- 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コンストラクター
ArrayBufferコンストラクターは：
- %ArrayBuffer%である。
グローバルオブジェクト の"ArrayBuffer" プロパティの初期値である。- コンストラクターとして呼び出されたとき、新しいArrayBufferを作成して初期化する。
- 関数として呼び出されることを意図しておらず、そのように呼び出された場合は例外をスローする。
- クラス定義の
extends節の値として使用できる。指定されたArrayBufferの振る舞いを継承しようとするサブクラスコンストラクターは、ArrayBuffer.prototype組み込みメソッドをサポートするために必要な内部状態を持つサブクラスインスタンスを作成して初期化するために、ArrayBufferコンストラクターへのsuper呼び出しを含めなければならない。
25.1.4.1 ArrayBuffer ( length [ , options ] )
この関数は呼び出されたとき、次の手順を実行します：
- NewTarget が
undefined の場合、TypeError 例外をスローする。 - byteLength を ?
ToIndex (length) とする。 - requestedMaxByteLength を ?
GetArrayBufferMaxByteLengthOption (options) とする。 - ?
AllocateArrayBuffer (NewTarget, byteLength, requestedMaxByteLength) を返す。
25.1.5 ArrayBufferコンストラクターのプロパティ
ArrayBufferコンストラクターは：
- [[Prototype]]内部スロットを持ち、その値は
%Function.prototype% である。 - 次のプロパティを持つ：
25.1.5.1 ArrayBuffer.isView ( arg )
この関数は呼び出されたとき、次の手順を実行します：
- arg がObjectでない場合、
false を返す。 - arg が [[ViewedArrayBuffer]] 内部スロットを持つ場合、
true を返す。 false を返す。
25.1.5.2 ArrayBuffer.prototype
ArrayBuffer.prototypeの初期値は
このプロパティの属性は { [[Writable]]:
25.1.5.3 get ArrayBuffer [ %Symbol.species% ]
ArrayBuffer[%Symbol.species%]は、setアクセサー関数が
this 値を返す。
この関数の
25.1.6 ArrayBufferプロトタイプオブジェクトのプロパティ
ArrayBufferプロトタイプオブジェクトは：
- %ArrayBuffer.prototype%である。
- [[Prototype]]内部スロットを持ち、その値は
%Object.prototype% である。 - 通常のオブジェクトである。
- [[ArrayBufferData]]または[[ArrayBufferByteLength]]内部スロットを持たない。
25.1.6.1 get ArrayBuffer.prototype.byteLength
ArrayBuffer.prototype.byteLengthは、setアクセサー関数が
- obj を
this 値とする。 - ?
RequireInternalSlot (obj, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (obj) がtrue の場合、TypeError 例外をスローする。IsDetachedBuffer (obj) がtrue の場合、+0 𝔽 を返す。- length を obj.[[ArrayBufferByteLength]] とする。
𝔽 (length) を返す。
25.1.6.2 ArrayBuffer.prototype.constructor
ArrayBuffer.prototype.constructorの初期値は
25.1.6.3 get ArrayBuffer.prototype.detached
ArrayBuffer.prototype.detachedは、setアクセサー関数が
- obj を
this 値とする。 - ?
RequireInternalSlot (obj, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (obj) がtrue の場合、TypeError 例外をスローする。IsDetachedBuffer (obj) を返す。
25.1.6.4 get ArrayBuffer.prototype.maxByteLength
ArrayBuffer.prototype.maxByteLengthは、setアクセサー関数が
- obj を
this 値とする。 - ?
RequireInternalSlot (obj, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (obj) がtrue の場合、TypeError 例外をスローする。IsDetachedBuffer (obj) がtrue の場合、+0 𝔽 を返す。IsFixedLengthArrayBuffer (obj) がtrue の場合、- length を obj.[[ArrayBufferByteLength]] とする。
- そうでなければ、
- length を obj.[[ArrayBufferMaxByteLength]] とする。
𝔽 (length) を返す。
25.1.6.5 get ArrayBuffer.prototype.resizable
ArrayBuffer.prototype.resizableは、setアクセサー関数が
- obj を
this 値とする。 - ?
RequireInternalSlot (obj, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (obj) がtrue の場合、TypeError 例外をスローする。IsFixedLengthArrayBuffer (obj) がfalse の場合、true を返す。false を返す。
25.1.6.6 ArrayBuffer.prototype.resize ( newLength )
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - ?
RequireInternalSlot (obj, [[ArrayBufferMaxByteLength]]) を実行する。 IsSharedArrayBuffer (obj) がtrue の場合、TypeError 例外をスローする。- newByteLength を ?
ToIndex (newLength) とする。 IsDetachedBuffer (obj) がtrue の場合、TypeError 例外をスローする。- newByteLength > obj.[[ArrayBufferMaxByteLength]] の場合、
RangeError 例外をスローする。 - hostHandled を ?
HostResizeArrayBuffer (obj, newByteLength) とする。 - hostHandled が
handled である場合、undefined を返す。 - oldBlock を obj.[[ArrayBufferData]] とする。
- newBlock を ?
CreateByteDataBlock (newByteLength) とする。 - copyLength を
min (newByteLength, obj.[[ArrayBufferByteLength]]) とする。 CopyDataBlockBytes (newBlock, 0, oldBlock, 0, copyLength) を実行する。NOTE : 新しいData Block の作成も古いData Block からのコピーも観察可能ではありません。実装はこのメソッドをインプレース拡張または縮小として実装してもよいです。- obj.[[ArrayBufferData]] を newBlock に設定する。
- obj.[[ArrayBufferByteLength]] を newByteLength に設定する。
undefined を返す。
25.1.6.7 ArrayBuffer.prototype.slice ( start, end )
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - ?
RequireInternalSlot (obj, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (obj) がtrue の場合、TypeError 例外をスローする。IsDetachedBuffer (obj) がtrue の場合、TypeError 例外をスローする。- len を obj.[[ArrayBufferByteLength]] とする。
- relativeStart を ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞ の場合、first を0とする。
- そうでなく relativeStart < 0 の場合、first を
max (len + relativeStart, 0) とする。 - そうでなければ、first を
min (relativeStart, len) とする。 - end が
undefined の場合、relativeEnd を len とする。そうでなければ、relativeEnd を ?ToIntegerOrInfinity (end) とする。 - relativeEnd = -∞ の場合、final を0とする。
- そうでなく relativeEnd < 0 の場合、final を
max (len + relativeEnd, 0) とする。 - そうでなければ、final を
min (relativeEnd, len) とする。 - newLen を
max (final - first, 0) とする。 - ctor を ?
SpeciesConstructor (obj,%ArrayBuffer% ) とする。 - new を ?
Construct (ctor, «𝔽 (newLen) ») とする。 - ?
RequireInternalSlot (new, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (new) がtrue の場合、TypeError 例外をスローする。IsDetachedBuffer (new) がtrue の場合、TypeError 例外をスローする。SameValue (new, obj) がtrue の場合、TypeError 例外をスローする。- new.[[ArrayBufferByteLength]] < newLen の場合、
TypeError 例外をスローする。 NOTE : 上記の手順の副作用によって、obj がデタッチまたはサイズ変更されている可能性があります。IsDetachedBuffer (obj) がtrue の場合、TypeError 例外をスローする。- fromBuf を obj.[[ArrayBufferData]] とする。
- toBuf を new.[[ArrayBufferData]] とする。
- currentLen を obj.[[ArrayBufferByteLength]] とする。
- first < currentLen の場合、
- count を
min (newLen, currentLen - first) とする。 CopyDataBlockBytes (toBuf, 0, fromBuf, first, count) を実行する。
- count を
- new を返す。
25.1.6.8 ArrayBuffer.prototype.transfer ( [ newLength ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - ?
ArrayBufferCopyAndDetach (obj, newLength,preserve-resizability ) を返す。
25.1.6.9 ArrayBuffer.prototype.transferToFixedLength ( [ newLength ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - ?
ArrayBufferCopyAndDetach (obj, newLength,fixed-length ) を返す。
25.1.6.10 ArrayBuffer.prototype [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
25.1.7 ArrayBufferインスタンスのプロパティ
ArrayBufferインスタンスは
[[ArrayBufferData]] が
[[ArrayBufferDetachKey]] が
25.1.8 サイズ変更可能なArrayBufferのガイドライン
以下は、
可能な場合、プログラムはその展開環境でテストすることを推奨します。利用可能な物理メモリ量はハードウェアデバイス間で大きく異なります。同様に、仮想メモリサブシステムも、ハードウェアデバイス間だけでなくオペレーティングシステム間でも大きく異なります。64ビットのデスクトップWebブラウザーでメモリ不足エラーなしに動作するアプリケーションが、32ビットのモバイルWebブラウザーではメモリ不足になる可能性があります。
特定の最大サイズで
以下は、
ホストがWebブラウザーのように多数のECMAScriptアプリケーションを同時に実行するマルチテナントであり、その実装が仮想メモリを予約することでインプレース拡張を実装することを選択する場合、32ビットおよび64ビットの実装の両方で、
MMUを持たない組込みデバイス上で動作するホストなど、ホストが仮想メモリを持たない場合、またはホストがコピーによるサイズ変更のみを実装する場合、
25.2 SharedArrayBufferオブジェクト
25.2.1 固定長および拡張可能なSharedArrayBufferオブジェクト
固定長SharedArrayBufferとは、作成後にバイト長を変更できないSharedArrayBufferです。
拡張可能なSharedArrayBufferとは、作成後に
作成されるSharedArrayBufferオブジェクトの種類は、
25.2.2 SharedArrayBufferオブジェクトのための抽象操作
25.2.2.1 AllocateSharedArrayBuffer ( constructor, byteLength [ , maxByteLength ] )
The
- 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 (constructor,"%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
- obj.[[ArrayBufferData]] が
Shared Data Block である場合、true を返す。 false を返す。
25.2.2.3 IsGrowableSharedArrayBuffer ( obj )
The
IsSharedArrayBuffer (obj) がtrue であり、obj が [[ArrayBufferByteLengthData]] 内部スロットを持つ場合、true を返す。false を返す。
25.2.2.4 HostGrowSharedArrayBuffer ( buffer, newByteLength )
The
HostGrowSharedArrayBufferの実装は、次の要件に適合しなければなりません：
- この抽象操作が
unhandled で正常完了しない場合で、newByteLength < buffer の現在のバイト長、または newByteLength > buffer.[[ArrayBufferMaxByteLength]] である場合、RangeError 例外をスローする。 - agentRecord を周囲のエージェントの
Agent Record とする。isLittleEndian を agentRecord.[[LittleEndian]] とする。この抽象操作がhandled で正常完了する場合、[[Order]] がseq-cst 、[[Payload]] がNumericToRawBytes (biguint64 , newByteLength, isLittleEndian)、[[Block]] が buffer.[[ArrayBufferByteLengthData]]、[[ByteIndex]] が0、[[ElementSize]] が8であるWriteSharedMemory またはReadModifyWriteSharedMemory イベントが、SharedArrayBuffer.prototype.grow ( newLength ) への競合 する呼び出しが「失われる」、すなわち黙って何もしない、ということがないように、周囲のエージェントの候補実行に追加される。
上記の第2要件は、buffer の現在のバイト長がどのように、またはいつ読み取られるかについて意図的に曖昧です。バイト長は基盤ハードウェア上の原子的read-modify-write操作によって更新されなければならないため、load-link/store-conditionalまたはload-exclusive/store-exclusive命令ペアを使用するアーキテクチャは、ペアとなる命令を命令ストリーム内で近接させたい場合があります。そのため、
これは、0 ≤ newByteLength ≤ buffer.[[ArrayBufferMaxByteLength]] が保証されている
HostGrowSharedArrayBufferの既定の実装は
25.2.3 SharedArrayBufferコンストラクター
SharedArrayBufferコンストラクターは：
- %SharedArrayBuffer%である。
- そのプロパティが存在する場合（下記参照）、
グローバルオブジェクト の"SharedArrayBuffer" プロパティの初期値である。 - コンストラクターとして呼び出されたとき、新しいSharedArrayBufferを作成して初期化する。
- 関数として呼び出されることを意図しておらず、そのように呼び出された場合は例外をスローする。
- クラス定義の
extends節の値として使用できる。指定されたSharedArrayBufferの振る舞いを継承しようとするサブクラスコンストラクターは、SharedArrayBuffer.prototype組み込みメソッドをサポートするために必要な内部状態を持つサブクラスインスタンスを作成して初期化するために、SharedArrayBufferコンストラクターへのsuper呼び出しを含めなければならない。
ホストがSharedArrayBufferへの並行アクセスを提供しない場合はいつでも、
ArrayBufferとは異なり、SharedArrayBufferはデタッチされることができず、その内部[[ArrayBufferData]]スロットは決して
25.2.3.1 SharedArrayBuffer ( length [ , options ] )
この関数は呼び出されたとき、次の手順を実行します：
- NewTarget が
undefined の場合、TypeError 例外をスローする。 - byteLength を ?
ToIndex (length) とする。 - requestedMaxByteLength を ?
GetArrayBufferMaxByteLengthOption (options) とする。 - ?
AllocateSharedArrayBuffer (NewTarget, byteLength, requestedMaxByteLength) を返す。
25.2.4 SharedArrayBufferコンストラクターのプロパティ
SharedArrayBufferコンストラクターは：
- [[Prototype]]内部スロットを持ち、その値は
%Function.prototype% である。 - 次のプロパティを持つ：
25.2.4.1 SharedArrayBuffer.prototype
SharedArrayBuffer.prototypeの初期値は
このプロパティの属性は { [[Writable]]:
25.2.4.2 get SharedArrayBuffer [ %Symbol.species% ]
SharedArrayBuffer[%Symbol.species%]は、setアクセサー関数が
this 値を返す。
この関数の
25.2.5 SharedArrayBufferプロトタイプオブジェクトのプロパティ
SharedArrayBufferプロトタイプオブジェクトは：
- %SharedArrayBuffer.prototype%である。
- [[Prototype]]内部スロットを持ち、その値は
%Object.prototype% である。 - 通常のオブジェクトである。
- [[ArrayBufferData]]または[[ArrayBufferByteLength]]内部スロットを持たない。
25.2.5.1 get SharedArrayBuffer.prototype.byteLength
SharedArrayBuffer.prototype.byteLengthは、setアクセサー関数が
- obj を
this 値とする。 - ?
RequireInternalSlot (obj, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (obj) がfalse の場合、TypeError 例外をスローする。- length を
ArrayBufferByteLength (obj,seq-cst ) とする。 𝔽 (length) を返す。
25.2.5.2 SharedArrayBuffer.prototype.constructor
SharedArrayBuffer.prototype.constructorの初期値は
25.2.5.3 SharedArrayBuffer.prototype.grow ( newLength )
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - ?
RequireInternalSlot (obj, [[ArrayBufferMaxByteLength]]) を実行する。 IsSharedArrayBuffer (obj) がfalse の場合、TypeError 例外をスローする。- newByteLength を ?
ToIndex (newLength) とする。 - hostHandled を ?
HostGrowSharedArrayBuffer (obj, newByteLength) とする。 - hostHandled が
handled である場合、undefined を返す。 - agentRecord を周囲のエージェントの
Agent Record とする。 - isLittleEndian を agentRecord.[[LittleEndian]] とする。
- byteLengthBlock を obj.[[ArrayBufferByteLengthData]] とする。
- currentByteLengthRawBytes を
GetRawBytesFromSharedBlock (byteLengthBlock, 0,biguint64 ,true ,seq-cst ) とする。 - newByteLengthRawBytes を
NumericToRawBytes (biguint64 ,ℤ (newByteLength), isLittleEndian) とする。 - 繰り返す：
NOTE : これは、同じバッファーの並列で競合 する拡張が全順序化され、失われず、黙って何もしないことがないようにするためのcompare-and-exchangeループです。このループは、競合 なしに拡張を試みることができた場合に終了します。- currentByteLength を
ℝ (RawBytesToNumeric (biguint64 , currentByteLengthRawBytes, isLittleEndian)) とする。 - newByteLength = currentByteLength の場合、
undefined を返す。 - newByteLength < currentByteLength または newByteLength > obj.[[ArrayBufferMaxByteLength]] の場合、
RangeError 例外をスローする。 - byteLengthDelta を newByteLength - currentByteLength とする。
- byteLengthDelta バイトからなる新しい
Shared Data Block 値を作成することが不可能な場合、RangeError 例外をスローする。 NOTE : ここでは新しいShared Data Block は構築も使用もされません。拡張可能なSharedArrayBuffer の観察可能な振る舞いは、構築時に最大サイズのShared Data Block を割り当てることで指定されており、この手順は、メモリ不足になった実装がRangeError をスローしなければならないという要件を捉えています。- readByteLengthRawBytes を
AtomicCompareExchangeInSharedBlock (byteLengthBlock, 0, 8, currentByteLengthRawBytes, newByteLengthRawBytes) とする。 ByteListEqual (readByteLengthRawBytes, currentByteLengthRawBytes) がtrue の場合、undefined を返す。- currentByteLengthRawBytes を readByteLengthRawBytes に設定する。
長さを更新するcompare-exchangeの偽の失敗は禁止されています。新しい長さの境界チェックが通過し、実装がメモリ不足でない場合、
SharedArrayBuffer.prototype.growへの並列呼び出しは全順序化されます。例えば、sab.grow(10)とsab.grow(20)という2つのsab.grow(10)の呼び出しは、sab.grow(20)が先に起きた場合でもsabを縮小することは決してなく、その場合は代わりにRangeErrorをスローします。
25.2.5.4 get SharedArrayBuffer.prototype.growable
SharedArrayBuffer.prototype.growableは、setアクセサー関数が
- obj を
this 値とする。 - ?
RequireInternalSlot (obj, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (obj) がfalse の場合、TypeError 例外をスローする。IsFixedLengthArrayBuffer (obj) がfalse の場合、true を返す。false を返す。
25.2.5.5 get SharedArrayBuffer.prototype.maxByteLength
SharedArrayBuffer.prototype.maxByteLengthは、setアクセサー関数が
- obj を
this 値とする。 - ?
RequireInternalSlot (obj, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (obj) がfalse の場合、TypeError 例外をスローする。IsFixedLengthArrayBuffer (obj) がtrue の場合、- length を obj.[[ArrayBufferByteLength]] とする。
- そうでなければ、
- length を obj.[[ArrayBufferMaxByteLength]] とする。
𝔽 (length) を返す。
25.2.5.6 SharedArrayBuffer.prototype.slice ( start, end )
このメソッドは呼び出されたとき、次の手順を実行します：
- obj を
this 値とする。 - ?
RequireInternalSlot (obj, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (obj) がfalse の場合、TypeError 例外をスローする。- len を
ArrayBufferByteLength (obj,seq-cst ) とする。 - relativeStart を ?
ToIntegerOrInfinity (start) とする。 - relativeStart = -∞ の場合、first を0とする。
- そうでなく relativeStart < 0 の場合、first を
max (len + relativeStart, 0) とする。 - そうでなければ、first を
min (relativeStart, len) とする。 - end が
undefined の場合、relativeEnd を len とする。そうでなければ、relativeEnd を ?ToIntegerOrInfinity (end) とする。 - relativeEnd = -∞ の場合、final を0とする。
- そうでなく relativeEnd < 0 の場合、final を
max (len + relativeEnd, 0) とする。 - そうでなければ、final を
min (relativeEnd, len) とする。 - newLen を
max (final - first, 0) とする。 - ctor を ?
SpeciesConstructor (obj,%SharedArrayBuffer% ) とする。 - new を ?
Construct (ctor, «𝔽 (newLen) ») とする。 - ?
RequireInternalSlot (new, [[ArrayBufferData]]) を実行する。 IsSharedArrayBuffer (new) がfalse の場合、TypeError 例外をスローする。- new.[[ArrayBufferData]] が obj.[[ArrayBufferData]] である場合、
TypeError 例外をスローする。 ArrayBufferByteLength (new,seq-cst ) < newLen の場合、TypeError 例外をスローする。- fromBuf を obj.[[ArrayBufferData]] とする。
- toBuf を new.[[ArrayBufferData]] とする。
CopyDataBlockBytes (toBuf, 0, fromBuf, first, newLen) を実行する。- new を返す。
25.2.5.7 SharedArrayBuffer.prototype [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
25.2.6 SharedArrayBufferインスタンスのプロパティ
SharedArrayBufferインスタンスは
SharedArrayBufferインスタンスは、ArrayBufferインスタンスと異なり、決してデタッチされません。
25.2.7 拡張可能なSharedArrayBufferのガイドライン
以下は、
可能な場合、プログラムはその展開環境でテストすることを推奨します。利用可能な物理メモリ量はハードウェアデバイス間で大きく異なります。同様に、仮想メモリサブシステムも、ハードウェアデバイス間だけでなくオペレーティングシステム間でも大きく異なります。64ビットのデスクトップWebブラウザーでメモリ不足エラーなしに動作するアプリケーションが、32ビットのモバイルWebブラウザーではメモリ不足になる可能性があります。
特定の最大サイズで
u8[idx] の境界チェックのための長さのロードは同期的ではありません。一般に、明示的な同期がない場合、あるプロパティアクセスが範囲内であることは、同じエージェント内の後続のプロパティアクセスも範囲内であることを意味しません。対照的に、SharedArrayBuffer、lengthおよびbyteLengthゲッターを介した長さの明示的なロードは同期的です。
以下は、
拡張操作は
拡張されたメモリは、並列で
MMUを持たない組込みデバイス上で動作するホストなど、仮想メモリを持たないホストで、
25.3 DataViewオブジェクト
25.3.1 DataViewオブジェクトのための抽象操作
25.3.1.1 DataView With Buffer Witness Record
DataView With Buffer Witness Recordとは、DataViewを、閲覧対象バッファーのキャッシュされたバイト長とともにカプセル化するために使用される
DataView With Buffer Witness Recordは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Object]] | DataView | バッファーのバイト長がロードされるDataViewオブジェクト。 |
| [[CachedBufferByteLength]] |
非負整数または |
|
25.3.1.2 MakeDataViewWithBufferWitnessRecord ( obj, order )
The
- 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
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
- view を viewRecord.[[Object]] とする。
- bufferByteLength を viewRecord.[[CachedBufferByteLength]] とする。
IsDetachedBuffer (view.[[ViewedArrayBuffer]]) がtrue の場合、Assert : bufferByteLength はdetached である。true を返す。
Assert : bufferByteLength は非負整数である。- byteOffsetStart を view.[[ByteOffset]] とする。
- view.[[ByteLength]] が
auto である場合、- byteOffsetEnd を bufferByteLength とする。
- そうでなければ、
- byteOffsetEnd を byteOffsetStart + view.[[ByteLength]] とする。
NOTE : [[ByteOffset]] が bufferByteLength である0長のDataViewは、範囲外とはみなされません。- byteOffsetStart > bufferByteLength または byteOffsetEnd > bufferByteLength の場合、
true を返す。 false を返す。
25.3.1.5 GetViewValue ( view, requestIndex, isLittleEndian, type )
The
- ?
RequireInternalSlot (view, [[DataView]]) を実行する。 Assert : view は [[ViewedArrayBuffer]] 内部スロットを持つ。- getIndex を ?
ToIndex (requestIndex) とする。 - isLittleEndian を
ToBoolean (isLittleEndian) に設定する。 - viewOffset を view.[[ByteOffset]] とする。
- viewRecord を
MakeDataViewWithBufferWitnessRecord (view,unordered ) とする。 NOTE : view のバッキングバッファーが拡張可能なSharedArrayBuffer である場合、境界チェックは同期操作ではありません。IsViewOutOfBounds (viewRecord) がtrue の場合、TypeError 例外をスローする。- viewSize を
GetViewByteLength (viewRecord) とする。 - elementSize を
Table 70 のElement Type type に対して指定されたElement Size値とする。 - getIndex + elementSize > viewSize の場合、
RangeError 例外をスローする。 - bufferIndex を getIndex + viewOffset とする。
GetValueFromBuffer (view.[[ViewedArrayBuffer]], bufferIndex, type,false ,unordered , isLittleEndian) を返す。
25.3.1.6 SetViewValue ( view, requestIndex, isLittleEndian, type, value )
The
- ?
RequireInternalSlot (view, [[DataView]]) を実行する。 Assert : view は [[ViewedArrayBuffer]] 内部スロットを持つ。- getIndex を ?
ToIndex (requestIndex) とする。 IsBigIntElementType (type) がtrue の場合、numberValue を ?ToBigInt (value) とする。- そうでなければ、numberValue を ?
ToNumber (value) とする。 - isLittleEndian を
ToBoolean (isLittleEndian) に設定する。 - viewOffset を view.[[ByteOffset]] とする。
- viewRecord を
MakeDataViewWithBufferWitnessRecord (view,unordered ) とする。 NOTE : view のバッキングバッファーが拡張可能なSharedArrayBuffer である場合、境界チェックは同期操作ではありません。IsViewOutOfBounds (viewRecord) がtrue の場合、TypeError 例外をスローする。- viewSize を
GetViewByteLength (viewRecord) とする。 - elementSize を
Table 70 のElement Type type に対して指定されたElement Size値とする。 - getIndex + elementSize > viewSize の場合、
RangeError 例外をスローする。 - bufferIndex を getIndex + viewOffset とする。
SetValueInBuffer (view.[[ViewedArrayBuffer]], bufferIndex, type, numberValue,false ,unordered , isLittleEndian) を実行する。undefined を返す。
25.3.2 DataViewコンストラクター
DataViewコンストラクターは：
- %DataView%である。
グローバルオブジェクト の"DataView" プロパティの初期値である。- コンストラクターとして呼び出されたとき、新しいDataViewを作成して初期化する。
- 関数として呼び出されることを意図しておらず、そのように呼び出された場合は例外をスローする。
- クラス定義の
extends節の値として使用できる。指定されたDataViewの振る舞いを継承しようとするサブクラスコンストラクターは、DataView.prototype組み込みメソッドをサポートするために必要な内部状態を持つサブクラスインスタンスを作成して初期化するために、DataViewコンストラクターへのsuper呼び出しを含めなければならない。
25.3.2.1 DataView ( buffer [ , byteOffset [ , byteLength ] ] )
この関数は呼び出されたとき、次の手順を実行します：
- NewTarget が
undefined の場合、TypeError 例外をスローする。 - ?
RequireInternalSlot (buffer, [[ArrayBufferData]]) を実行する。 - offset を ?
ToIndex (byteOffset) とする。 IsDetachedBuffer (buffer) がtrue の場合、TypeError 例外をスローする。- bufferByteLength を
ArrayBufferByteLength (buffer,seq-cst ) とする。 - offset > bufferByteLength の場合、
RangeError 例外をスローする。 - bufferIsFixedLength を
IsFixedLengthArrayBuffer (buffer) とする。 - byteLength が
undefined の場合、- bufferIsFixedLength が
true の場合、- viewByteLength を bufferByteLength - offset とする。
- そうでなければ、
- viewByteLength を
auto とする。
- viewByteLength を
- bufferIsFixedLength が
- そうでなければ、
- viewByteLength を ?
ToIndex (byteLength) とする。 - offset + viewByteLength > bufferByteLength の場合、
RangeError 例外をスローする。
- viewByteLength を ?
- obj を ?
OrdinaryCreateFromConstructor (NewTarget,"%DataView.prototype%" , « [[DataView]], [[ViewedArrayBuffer]], [[ByteLength]], [[ByteOffset]] ») とする。 IsDetachedBuffer (buffer) がtrue の場合、TypeError 例外をスローする。- bufferByteLength を
ArrayBufferByteLength (buffer,seq-cst ) に設定する。 - offset > bufferByteLength の場合、
RangeError 例外をスローする。 - byteLength が
undefined でない場合、- offset + viewByteLength > bufferByteLength の場合、
RangeError 例外をスローする。
- offset + viewByteLength > bufferByteLength の場合、
- obj.[[ViewedArrayBuffer]] を buffer に設定する。
- obj.[[ByteLength]] を viewByteLength に設定する。
- obj.[[ByteOffset]] を offset に設定する。
- obj を返す。
25.3.3 DataViewコンストラクターのプロパティ
DataViewコンストラクターは：
- [[Prototype]]内部スロットを持ち、その値は
%Function.prototype% である。 - 次のプロパティを持つ：
25.3.3.1 DataView.prototype
DataView.prototypeの初期値は
このプロパティの属性は { [[Writable]]:
25.3.4 DataViewプロトタイプオブジェクトのプロパティ
DataViewプロトタイプオブジェクトは：
- %DataView.prototype%である。
- [[Prototype]]内部スロットを持ち、その値は
%Object.prototype% である。 - 通常のオブジェクトである。
- [[DataView]]、[[ViewedArrayBuffer]]、[[ByteLength]]、または[[ByteOffset]]内部スロットを持たない。
25.3.4.1 get DataView.prototype.buffer
DataView.prototype.bufferは、setアクセサー関数が
- obj を
this 値とする。 - ?
RequireInternalSlot (obj, [[DataView]]) を実行する。 Assert : obj は [[ViewedArrayBuffer]] 内部スロットを持つ。- buffer を obj.[[ViewedArrayBuffer]] とする。
- buffer を返す。
25.3.4.2 get DataView.prototype.byteLength
DataView.prototype.byteLengthは、setアクセサー関数が
- obj を
this 値とする。 - ?
RequireInternalSlot (obj, [[DataView]]) を実行する。 Assert : obj は [[ViewedArrayBuffer]] 内部スロットを持つ。- viewRecord を
MakeDataViewWithBufferWitnessRecord (obj,seq-cst ) とする。 IsViewOutOfBounds (viewRecord) がtrue の場合、TypeError 例外をスローする。- size を
GetViewByteLength (viewRecord) とする。 𝔽 (size) を返す。
25.3.4.3 get DataView.prototype.byteOffset
DataView.prototype.byteOffsetは、setアクセサー関数が
- obj を
this 値とする。 - ?
RequireInternalSlot (obj, [[DataView]]) を実行する。 Assert : obj は [[ViewedArrayBuffer]] 内部スロットを持つ。- viewRecord を
MakeDataViewWithBufferWitnessRecord (obj,seq-cst ) とする。 IsViewOutOfBounds (viewRecord) がtrue の場合、TypeError 例外をスローする。- offset を obj.[[ByteOffset]] とする。
𝔽 (offset) を返す。
25.3.4.4 DataView.prototype.constructor
DataView.prototype.constructorの初期値は
25.3.4.5 DataView.prototype.getBigInt64 ( byteOffset [ , littleEndian ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- view を
this 値とする。 - ?
GetViewValue (view, byteOffset, littleEndian,bigint64 ) を返す。
25.3.4.6 DataView.prototype.getBigUint64 ( byteOffset [ , littleEndian ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- view を
this 値とする。 - ?
GetViewValue (view, byteOffset, littleEndian,biguint64 ) を返す。
25.3.4.7 DataView.prototype.getFloat16 ( byteOffset [ , littleEndian ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- view を
this 値とする。 - littleEndian が存在しない場合、littleEndian を
false に設定する。 - ?
GetViewValue (view, byteOffset, littleEndian,float16 ) を返す。
25.3.4.8 DataView.prototype.getFloat32 ( byteOffset [ , littleEndian ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- view を
this 値とする。 - littleEndian が存在しない場合、littleEndian を
false に設定する。 - ?
GetViewValue (view, byteOffset, littleEndian,float32 ) を返す。
25.3.4.9 DataView.prototype.getFloat64 ( byteOffset [ , littleEndian ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- view を
this 値とする。 - littleEndian が存在しない場合、littleEndian を
false に設定する。 - ?
GetViewValue (view, byteOffset, littleEndian,float64 ) を返す。
25.3.4.10 DataView.prototype.getInt8 ( byteOffset )
このメソッドは呼び出されたとき、次の手順を実行します：
- view を
this 値とする。 - ?
GetViewValue (view, byteOffset,true ,int8 ) を返す。
25.3.4.11 DataView.prototype.getInt16 ( byteOffset [ , littleEndian ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- view を
this 値とする。 - littleEndian が存在しない場合、littleEndian を
false に設定する。 - ?
GetViewValue (view, byteOffset, littleEndian,int16 ) を返す。
25.3.4.12 DataView.prototype.getInt32 ( byteOffset [ , littleEndian ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- view を
this 値とする。 - littleEndian が存在しない場合、littleEndian を
false に設定する。 - ?
GetViewValue (view, byteOffset, littleEndian,int32 ) を返す。
25.3.4.13 DataView.prototype.getUint8 ( byteOffset )
このメソッドは呼び出されたとき、次の手順を実行します：
- view を
this 値とする。 - ?
GetViewValue (view, byteOffset,true ,uint8 ) を返す。
25.3.4.14 DataView.prototype.getUint16 ( byteOffset [ , littleEndian ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- view を
this 値とする。 - littleEndian が存在しない場合、littleEndian を
false に設定する。 - ?
GetViewValue (view, byteOffset, littleEndian,uint16 ) を返す。
25.3.4.15 DataView.prototype.getUint32 ( byteOffset [ , littleEndian ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- view を
this 値とする。 - littleEndian が存在しない場合、littleEndian を
false に設定する。 - ?
GetViewValue (view, byteOffset, littleEndian,uint32 ) を返す。
25.3.4.16 DataView.prototype.setBigInt64 ( byteOffset, value [ , littleEndian ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- view を
this 値とする。 - ?
SetViewValue (view, byteOffset, littleEndian,bigint64 , value) を返す。
25.3.4.17 DataView.prototype.setBigUint64 ( byteOffset, value [ , littleEndian ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- view を
this 値とする。 - ?
SetViewValue (view, byteOffset, littleEndian,biguint64 , value) を返す。
25.3.4.18 DataView.prototype.setFloat16 ( byteOffset, value [ , littleEndian ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- view を
this 値とする。 - littleEndian が存在しない場合、littleEndian を
false に設定する。 - ?
SetViewValue (view, byteOffset, littleEndian,float16 , value) を返す。
25.3.4.19 DataView.prototype.setFloat32 ( byteOffset, value [ , littleEndian ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- view を
this 値とする。 - littleEndian が存在しない場合、littleEndian を
false に設定する。 - ?
SetViewValue (view, byteOffset, littleEndian,float32 , value) を返す。
25.3.4.20 DataView.prototype.setFloat64 ( byteOffset, value [ , littleEndian ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- view を
this 値とする。 - littleEndian が存在しない場合、littleEndian を
false に設定する。 - ?
SetViewValue (view, byteOffset, littleEndian,float64 , value) を返す。
25.3.4.21 DataView.prototype.setInt8 ( byteOffset, value )
このメソッドは呼び出されたとき、次の手順を実行します：
- view を
this 値とする。 - ?
SetViewValue (view, byteOffset,true ,int8 , value) を返す。
25.3.4.22 DataView.prototype.setInt16 ( byteOffset, value [ , littleEndian ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- view を
this 値とする。 - littleEndian が存在しない場合、littleEndian を
false に設定する。 - ?
SetViewValue (view, byteOffset, littleEndian,int16 , value) を返す。
25.3.4.23 DataView.prototype.setInt32 ( byteOffset, value [ , littleEndian ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- view を
this 値とする。 - littleEndian が存在しない場合、littleEndian を
false に設定する。 - ?
SetViewValue (view, byteOffset, littleEndian,int32 , value) を返す。
25.3.4.24 DataView.prototype.setUint8 ( byteOffset, value )
このメソッドは呼び出されたとき、次の手順を実行します：
- view を
this 値とする。 - ?
SetViewValue (view, byteOffset,true ,uint8 , value) を返す。
25.3.4.25 DataView.prototype.setUint16 ( byteOffset, value [ , littleEndian ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- view を
this 値とする。 - littleEndian が存在しない場合、littleEndian を
false に設定する。 - ?
SetViewValue (view, byteOffset, littleEndian,uint16 , value) を返す。
25.3.4.26 DataView.prototype.setUint32 ( byteOffset, value [ , littleEndian ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- view を
this 値とする。 - littleEndian が存在しない場合、littleEndian を
false に設定する。 - ?
SetViewValue (view, byteOffset, littleEndian,uint32 , value) を返す。
25.3.4.27 DataView.prototype [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
25.3.5 DataViewインスタンスのプロパティ
DataViewインスタンスは、
[[DataView]]内部スロットの値は、この仕様内では使用されません。その内部スロットが存在するという単純な事実が、DataViewコンストラクターを使用して作成されたオブジェクトを識別するために仕様内で使用されます。
25.4 Atomicsオブジェクト
Atomicsオブジェクトは：
- %Atomics%である。
グローバルオブジェクト の"Atomics" プロパティの初期値である。- 通常のオブジェクトである。
- [[Prototype]]内部スロットを持ち、その値は
%Object.prototype% である。 - [[Construct]]内部メソッドを持たない。
new演算子と共にコンストラクターとして使用できない。 - [[Call]]内部メソッドを持たない。関数として呼び出すことができない。
Atomicsオブジェクトは、共有メモリ配列セル上で不可分に（原子的に）動作する関数、およびエージェントがプリミティブイベントを待機しディスパッチできるようにする関数を提供します。規律をもって使用される場合、Atomics関数は、共有メモリを通じて通信するマルチエージェントプログラムが、並列CPU上であってもよく理解された順序で実行できるようにします。共有メモリ通信を支配する規則は、下記で定義される
ECMAScriptにおける共有メモリのプログラミングおよび実装のための参考ガイドラインについては、
25.4.1 Waiter Record
Waiter Recordとは、Atomics.waitまたはAtomics.waitAsyncへの特定の呼び出しを表すために使用される
Waiter Recordは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[AgentSignifier]] | エージェントsignifier |
Atomics.waitまたはAtomics.waitAsyncを呼び出したエージェント。
|
| [[PromiseCapability]] |
|
Atomics.waitAsyncへの呼び出しを表す場合は結果のpromise、そうでない場合は |
| [[TimeoutTime]] | 非負の拡張数学値 |
タイムアウトが引き起こされ得る最も早い時刻。 |
| [[Result]] |
|
呼び出しの戻り値。 |
25.4.2 WaiterList Record
WaiterList Recordは、Atomics.wait、Atomics.waitAsync、およびAtomics.notifyを介したエージェントの待機と通知を説明するために使用されます。
WaiterList Recordは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Waiters]] |
|
このWaiterListに関連付けられた位置で待機しているAtomics.waitまたはAtomics.waitAsyncへの呼び出し。
|
| [[MostRecentLeaveEvent]] |
|
その |
同じエージェントsignifierを持つ複数の
エージェントクラスターはWaiterList Recordのストアを持ちます。このストアは (block, i) によって索引付けされます。ここで block は
各WaiterList Recordは、評価中にそのWaiterList Recordへの排他的アクセスを制御するクリティカルセクションを持ちます。一度に1つのエージェントだけがWaiterList Recordのクリティカルセクションに入ることができます。WaiterList Recordのクリティカルセクションへの入退出は、抽象操作
25.4.3 Atomicsのための抽象操作
25.4.3.1 ValidateIntegerTypedArray ( typedArray, waitable )
The
- taRecord を ?
ValidateTypedArray (typedArray,unordered ) とする。 NOTE : typedArray のバッキングバッファーが拡張可能なSharedArrayBuffer である場合、境界チェックは同期操作ではありません。- waitable が
true の場合、- typedArray.[[TypedArrayName]] が
"Int32Array" と"BigInt64Array" のいずれでもない場合、TypeError 例外をスローする。
- typedArray.[[TypedArrayName]] が
- そうでなければ、
- type を
TypedArrayElementType (typedArray) とする。 IsUnclampedIntegerElementType (type) がfalse であり、IsBigIntElementType (type) がfalse である場合、TypeError 例外をスローする。
- type を
- taRecord を返す。
25.4.3.2 ValidateAtomicAccess ( taRecord, requestIndex )
The
- length を
TypedArrayLength (taRecord) とする。 - accessIndex を ?
ToIndex (requestIndex) とする。 Assert : accessIndex ≥ 0 である。- accessIndex ≥ length の場合、
RangeError 例外をスローする。 - typedArray を taRecord.[[Object]] とする。
- elementSize を
TypedArrayElementSize (typedArray) とする。 - offset を typedArray.[[ByteOffset]] とする。
- (accessIndex × elementSize) + offset を返す。
25.4.3.3 ValidateAtomicAccessOnIntegerTypedArray ( typedArray, requestIndex )
The
- taRecord を ?
ValidateIntegerTypedArray (typedArray,false ) とする。 - ?
ValidateAtomicAccess (taRecord, requestIndex) を返す。
25.4.3.4 RevalidateAtomicAccess ( typedArray, byteIndexInBuffer )
The
- taRecord を
MakeTypedArrayWithBufferWitnessRecord (typedArray,unordered ) とする。 NOTE : typedArray のバッキングバッファーが拡張可能なSharedArrayBuffer である場合、境界チェックは同期操作ではありません。IsTypedArrayOutOfBounds (taRecord) がtrue の場合、TypeError 例外をスローする。Assert : byteIndexInBuffer ≥ typedArray.[[ByteOffset]] である。- byteIndexInBuffer ≥ taRecord.[[CachedBufferByteLength]] の場合、
RangeError 例外をスローする。 unused を返す。
25.4.3.5 GetWaiterList ( block, i )
The
Assert : i および i + 3 は block のメモリ内の有効なバイトオフセットである。- ペア (block, i) によって参照される
WaiterList Record を返す。
25.4.3.6 EnterCriticalSection ( waiterList )
The
Assert : 周囲のエージェントはいかなるWaiterList Record のクリティカルセクション にもいない。- waiterList の
クリティカルセクション にエージェントがいなくなるまで待ち、その後 waiterList のクリティカルセクション に入る（他のエージェントが入ることを許さない）。 - waiterList.[[MostRecentLeaveEvent]] が
empty でない場合、NOTE : 少なくとも一度クリティカルセクション に入った waiterList は、LeaveCriticalSection によって設定されたSynchronize イベントを持ちます。- agentRecord を周囲のエージェントの
Agent Record とする。 - execution を agentRecord.[[CandidateExecution]] とする。
- eventsRecord を、execution.[[EventsRecords]] のうち [[AgentSignifier]] が
AgentSignifier () であるAgent Events Record とする。 - enterEvent を新しい
Synchronize イベントとする。 - enterEvent を eventsRecord.[[EventList]] に追加する。
- (waiterList.[[MostRecentLeaveEvent]], enterEvent) を eventsRecord.[[AgentSynchronizesWith]] に追加する。
unused を返す。
EnterCriticalSectionは、
25.4.3.7 LeaveCriticalSection ( waiterList )
The
Assert : 周囲のエージェントは waiterList のクリティカルセクション 内にいる。- agentRecord を周囲のエージェントの
Agent Record とする。 - execution を agentRecord.[[CandidateExecution]] とする。
- eventsRecord を、execution.[[EventsRecords]] のうち [[AgentSignifier]] が
AgentSignifier () であるAgent Events Record とする。 - leaveEvent を新しい
Synchronize イベントとする。 - leaveEvent を eventsRecord.[[EventList]] に追加する。
- waiterList.[[MostRecentLeaveEvent]] を leaveEvent に設定する。
- waiterList の
クリティカルセクション を出る。 unused を返す。
25.4.3.8 AddWaiter ( waiterList, waiterRecord )
The
Assert : 周囲のエージェントは waiterList のクリティカルセクション 内にいる。Assert : waiterList.[[Waiters]] 内には、[[PromiseCapability]]フィールドが waiterRecord.[[PromiseCapability]] であり、[[AgentSignifier]]フィールドが waiterRecord.[[AgentSignifier]] であるWaiter Record は存在しない。- waiterRecord を waiterList.[[Waiters]] に追加する。
unused を返す。
25.4.3.9 RemoveWaiter ( waiterList, waiterRecord )
The
Assert : 周囲のエージェントは waiterList のクリティカルセクション 内にいる。Assert : waiterList.[[Waiters]] は waiterRecord を含む。- waiterRecord を waiterList.[[Waiters]] から削除する。
unused を返す。
25.4.3.10 RemoveWaiters ( waiterList, count )
The
Assert : 周囲のエージェントは waiterList のクリティカルセクション 内にいる。- len を waiterList.[[Waiters]] 内の要素数とする。
- count を
min (count, len) に設定する。 - waiters を、waiterList.[[Waiters]] の最初の count 個の要素を要素とする
List とする。 - waiterList.[[Waiters]] の最初の count 個の要素を削除する。
- waiters を返す。
25.4.3.11 SuspendThisAgent ( waiterList, waiterRecord )
The
Assert : 周囲のエージェントは waiterList のクリティカルセクション 内にいる。Assert : waiterList.[[Waiters]] は waiterRecord を含む。- thisAgent を
AgentSignifier () とする。 Assert : waiterRecord.[[AgentSignifier]] は thisAgent である。Assert : waiterRecord.[[PromiseCapability]] はblocking である。Assert :AgentCanSuspend () はtrue である。LeaveCriticalSection (waiterList) を実行し、時刻が waiterRecord.[[TimeoutTime]] になるまで周囲のエージェントを一時停止する。この複合操作は、クリティカルセクション を出た後、一時停止が有効になる前に到着した通知が失われないような方法で実行される。周囲のエージェントは、タイムアウトによって、または別のエージェントが引数 waiterList および thisAgent でNotifyWaiter を呼び出すこと（すなわち、Atomics.notifyへの呼び出しを介して）によってのみ、一時停止から復帰できる。EnterCriticalSection (waiterList) を実行する。unused を返す。
25.4.3.12 NotifyWaiter ( waiterList, waiterRecord )
The
Assert : 周囲のエージェントは waiterList のクリティカルセクション 内にいる。- waiterRecord.[[PromiseCapability]] が
blocking の場合、- signifierが waiterRecord.[[AgentSignifier]] であるエージェントを一時停止から起こす。
NOTE : これにより、そのエージェントはSuspendThisAgent 内で実行を再開します。
- そうでなく
AgentSignifier () が waiterRecord.[[AgentSignifier]] である場合、- promiseCapability を waiterRecord.[[PromiseCapability]] とする。
- !
Call (promiseCapability.[[Resolve]],undefined , « waiterRecord.[[Result]] ») を実行する。
- そうでなければ、
EnqueueResolveInAgentJob (waiterRecord.[[AgentSignifier]], waiterRecord.[[PromiseCapability]], waiterRecord.[[Result]]) を実行する。
unused を返す。
エージェントは、別のエージェントのpromise capabilityに対して、それをホストに渡すことを超えるいかなる形でもアクセスしてはなりません。
25.4.3.13 EnqueueResolveInAgentJob ( agentSignifier, promiseCapability, resolution )
The
- resolveJob を、agentSignifier、promiseCapability、および resolution を捕捉し、呼び出されたときに次の手順を実行する、パラメーターを持たない新しい
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, typedArray, index, value, timeout )
The
- taRecord を ?
ValidateIntegerTypedArray (typedArray,true ) とする。 - buffer を taRecord.[[Object]].[[ViewedArrayBuffer]] とする。
IsSharedArrayBuffer (buffer) がfalse の場合、TypeError 例外をスローする。- byteIndexInBuffer を ?
ValidateAtomicAccess (taRecord, index) とする。 - arrayTypeName を typedArray.[[TypedArrayName]] とする。
- arrayTypeName が
"BigInt64Array" である場合、expected を ?ToBigInt64 (value) とする。 - そうでなければ、expected を ?
ToInt32 (value) とする。 - timeoutNumber を ?
ToNumber (timeout) とする。 - timeoutNumber が
NaN または+∞ 𝔽 のいずれかである場合、realTimeout を +∞ とする。 - そうでなく timeoutNumber が
-∞ 𝔽 である場合、realTimeout を0とする。 - そうでなければ、realTimeout を
max (ℝ (timeoutNumber), 0) とする。 - mode が
sync であり、AgentCanSuspend () がfalse である場合、TypeError 例外をスローする。 - block を buffer.[[ArrayBufferData]] とする。
- waiterList を
GetWaiterList (block, byteIndexInBuffer) とする。 - mode が
sync の場合、- promiseCapability を
blocking とする。 - resultObject を
undefined とする。
- promiseCapability を
- そうでなければ、
- promiseCapability を !
NewPromiseCapability (%Promise% ) とする。 - resultObject を
OrdinaryObjectCreate (%Object.prototype% ) とする。
- promiseCapability を !
EnterCriticalSection (waiterList) を実行する。- elementType を
TypedArrayElementType (typedArray) とする。 - witness を
GetValueFromBuffer (buffer, byteIndexInBuffer, elementType,true ,seq-cst ) とする。 - expected ≠ witness の場合、
LeaveCriticalSection (waiterList) を実行する。- mode が
sync の場合、"not-equal" を返す。 - !
CreateDataPropertyOrThrow (resultObject,"async" ,false ) を実行する。 - !
CreateDataPropertyOrThrow (resultObject,"value" ,"not-equal" ) を実行する。 - resultObject を返す。
- realTimeout = 0 かつ mode が
async である場合、NOTE : 同期即時タイムアウトには特別な処理はありません。非同期即時タイムアウトは、早く失敗し不要なPromiseジョブを避けるために特別な処理を持ちます。LeaveCriticalSection (waiterList) を実行する。- !
CreateDataPropertyOrThrow (resultObject,"async" ,false ) を実行する。 - !
CreateDataPropertyOrThrow (resultObject,"value" ,"timed-out" ) を実行する。 - resultObject を返す。
- thisAgent を
AgentSignifier () とする。 - now を現在時刻を識別する
時刻値 （UTC）とする。 - additionalTimeout を実装定義の非負数学値とする。
- timeoutTime を
ℝ (now) + realTimeout + additionalTimeout とする。 NOTE : realTimeout が +∞ の場合、timeoutTime も +∞ です。- waiterRecord を新しい
Waiter Record { [[AgentSignifier]]: thisAgent, [[PromiseCapability]]: promiseCapability, [[TimeoutTime]]: timeoutTime, [[Result]]:"ok" } とする。 AddWaiter (waiterList, waiterRecord) を実行する。- mode が
sync の場合、SuspendThisAgent (waiterList, waiterRecord) を実行する。
- そうでなく timeoutTime が有限である場合、
EnqueueAtomicsWaitAsyncTimeoutJob (waiterList, waiterRecord) を実行する。
LeaveCriticalSection (waiterList) を実行する。- mode が
sync の場合、waiterRecord.[[Result]] を返す。 - !
CreateDataPropertyOrThrow (resultObject,"async" ,true ) を実行する。 - !
CreateDataPropertyOrThrow (resultObject,"value" , promiseCapability.[[Promise]]) を実行する。 - resultObject を返す。
additionalTimeout は、電力消費の削減やタイミング攻撃を緩和するためのタイマー解像度の粗化など、必要に応じて実装がタイムアウトを延長することを可能にします。この値はDoWaitの呼び出しごとに異なってもよいです。
25.4.3.15 EnqueueAtomicsWaitAsyncTimeoutJob ( waiterList, waiterRecord )
The
- timeoutJob を、waiterList および waiterRecord を捕捉し、呼び出されたときに次の手順を実行する、パラメーターを持たない新しい
Job Abstract Closure とする：EnterCriticalSection (waiterList) を実行する。- waiterList.[[Waiters]] が waiterRecord を含む場合、
- timeOfJobExecution を現在時刻を識別する
時刻値 （UTC）とする。 Assert :ℝ (timeOfJobExecution) ≥ waiterRecord.[[TimeoutTime]] である（時刻値 の潜在的な非単調性を無視する）。- waiterRecord.[[Result]] を
"timed-out" に設定する。 RemoveWaiter (waiterList, waiterRecord) を実行する。NotifyWaiter (waiterList, waiterRecord) を実行する。
- timeOfJobExecution を現在時刻を識別する
LeaveCriticalSection (waiterList) を実行する。unused を返す。
- now を現在時刻を識別する
時刻値 （UTC）とする。 - currentRealm を現在の
Realm Record とする。 HostEnqueueTimeoutJob (timeoutJob, currentRealm,𝔽 (waiterRecord.[[TimeoutTime]]) - now) を実行する。unused を返す。
25.4.3.16 AtomicCompareExchangeInSharedBlock ( block, byteIndexInBuffer, elementSize, expectedBytes, replacementBytes )
The
- agentRecord を周囲のエージェントの
Agent Record とする。 - execution を agentRecord.[[CandidateExecution]] とする。
- eventsRecord を、execution.[[EventsRecords]] のうち [[AgentSignifier]] が
AgentSignifier () であるAgent Events Record とする。 - rawBytesRead を、要素が非決定的に選択されたバイト値である、長さ elementSize の
List とする。 NOTE : 実装では、rawBytesRead は基盤ハードウェア上のload-link、load-exclusive、またはread-modify-write命令のオペランドの結果です。この非決定性は、弱い一貫性を持つハードウェアの観察可能な振る舞いを記述するためのメモリモデル の意味論上の規定です。NOTE : 期待値と読み取られた値の比較は、期待値が読み取られた値と等しくない場合に不必要に強い同期を避けるため、read-modify-write変更関数 の外側で実行されます。ByteListEqual (rawBytesRead, expectedBytes) がtrue の場合、- second を、何も捕捉せず、呼び出されたときに次の手順を原子的に実行する、パラメーター (oldBytes, newBytes) を持つ新しい
read-modify-write変更関数 とする：- newBytes を返す。
- event を
ReadModifyWriteSharedMemory { [[Order]]:seq-cst , [[NoTear]]:true , [[Block]]: block, [[ByteIndex]]: byteIndexInBuffer, [[ElementSize]]: elementSize, [[Payload]]: replacementBytes, [[ModifyOp]]: second } とする。
- second を、何も捕捉せず、呼び出されたときに次の手順を原子的に実行する、パラメーター (oldBytes, newBytes) を持つ新しい
- そうでなければ、
- event を
ReadSharedMemory { [[Order]]:seq-cst , [[NoTear]]:true , [[Block]]: block, [[ByteIndex]]: byteIndexInBuffer, [[ElementSize]]: elementSize } とする。
- event を
- event を eventsRecord.[[EventList]] に追加する。
Chosen Value Record { [[Event]]: event, [[ChosenValue]]: rawBytesRead } を execution.[[ChosenValues]] に追加する。- rawBytesRead を返す。
25.4.3.17 AtomicReadModifyWrite ( typedArray, index, value, op )
The
- byteIndexInBuffer を ?
ValidateAtomicAccessOnIntegerTypedArray (typedArray, index) とする。 - typedArray.[[ContentType]] が
bigint である場合、coerced を ?ToBigInt (value) とする。 - そうでなければ、coerced を
𝔽 (?ToIntegerOrInfinity (value)) とする。 - ?
RevalidateAtomicAccess (typedArray, byteIndexInBuffer) を実行する。 - buffer を typedArray.[[ViewedArrayBuffer]] とする。
- elementType を
TypedArrayElementType (typedArray) とする。 GetModifySetValueInBuffer (buffer, byteIndexInBuffer, elementType, coerced, op) を返す。
25.4.3.18 ByteListBitwiseOp ( op, xBytes, yBytes )
The &、^、または |), xBytes (バイト値の
Assert : xBytes と yBytes は同じ数の要素を持つ。- result を新しい空の
List とする。 - i を0とする。
- xBytes の各要素 xByte について、次を行う：
- yByte を yBytes[i] とする。
- op が
&である場合、- resultByte を、xByte と yByte にビット単位AND演算を適用した結果とする。
- そうでなく op が
^である場合、- resultByte を、xByte と yByte にビット単位排他的OR（XOR）演算を適用した結果とする。
- そうでなければ、
Assert : op は|である。- resultByte を、xByte と yByte にビット単位包含OR演算を適用した結果とする。
- i を i + 1 に設定する。
- resultByte を result に追加する。
- result を返す。
25.4.3.19 ByteListEqual ( xBytes, yBytes )
The
- xBytes と yBytes が同じ数の要素を持たない場合、
false を返す。 - i を0とする。
- xBytes の各要素 xByte について、次を行う：
- yByte を yBytes[i] とする。
- xByte ≠ yByte の場合、
false を返す。 - i を i + 1 に設定する。
true を返す。
25.4.4 Atomics.add ( typedArray, index, value )
この関数は呼び出されたとき、次の手順を実行します：
- add を、typedArray を捕捉し、呼び出されたときに次の手順を原子的に実行する、パラメーター (xBytes, yBytes) を持つ新しい
read-modify-write変更関数 とする：- type を
TypedArrayElementType (typedArray) とする。 - agentRecord を周囲のエージェントの
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 は同じ数の要素を持つ。- sumBytes を返す。
- type を
- ?
AtomicReadModifyWrite (typedArray, index, value, add) を返す。
25.4.5 Atomics.and ( typedArray, index, value )
この関数は呼び出されたとき、次の手順を実行します：
- and を、何も捕捉せず、呼び出されたときに次の手順を原子的に実行する、パラメーター (xBytes, yBytes) を持つ新しい
read-modify-write変更関数 とする：ByteListBitwiseOp (&, xBytes, yBytes) を返す。
- ?
AtomicReadModifyWrite (typedArray, index, value, and) を返す。
25.4.6 Atomics.compareExchange ( typedArray, index, expectedValue, replacementValue )
この関数は呼び出されたとき、次の手順を実行します：
- byteIndexInBuffer を ?
ValidateAtomicAccessOnIntegerTypedArray (typedArray, index) とする。 - buffer を typedArray.[[ViewedArrayBuffer]] とする。
- block を buffer.[[ArrayBufferData]] とする。
- typedArray.[[ContentType]] が
bigint である場合、 - そうでなければ、
- expected を
𝔽 (?ToIntegerOrInfinity (expectedValue)) とする。 - replacement を
𝔽 (?ToIntegerOrInfinity (replacementValue)) とする。
- expected を
- ?
RevalidateAtomicAccess (typedArray, byteIndexInBuffer) を実行する。 - elementType を
TypedArrayElementType (typedArray) とする。 - elementSize を
TypedArrayElementSize (typedArray) とする。 - agentRecord を周囲のエージェントの
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 を、block[byteIndexInBuffer] から始まる elementSize バイトの列を要素とする、長さ elementSize の
List とする。 ByteListEqual (rawBytesRead, expectedBytes) がtrue の場合、- replacementBytes の個々のバイトを、block[byteIndexInBuffer] から始めて block に格納する。
- rawBytesRead を、block[byteIndexInBuffer] から始まる elementSize バイトの列を要素とする、長さ elementSize の
RawBytesToNumeric (elementType, rawBytesRead, isLittleEndian) を返す。
25.4.7 Atomics.exchange ( typedArray, index, value )
この関数は呼び出されたとき、次の手順を実行します：
- second を、何も捕捉せず、呼び出されたときに次の手順を原子的に実行する、パラメーター (oldBytes, newBytes) を持つ新しい
read-modify-write変更関数 とする：- newBytes を返す。
- ?
AtomicReadModifyWrite (typedArray, index, value, second) を返す。
25.4.8 Atomics.isLockFree ( size )
この関数は呼び出されたとき、次の手順を実行します：
- n を ?
ToIntegerOrInfinity (size) とする。 - agentRecord を周囲のエージェントの
Agent Record とする。 - n = 1 の場合、agentRecord.[[IsLockFree1]] を返す。
- n = 2 の場合、agentRecord.[[IsLockFree2]] を返す。
- n = 4 の場合、
true を返す。 - n = 8 の場合、agentRecord.[[IsLockFree8]] を返す。
false を返す。
この関数は最適化プリミティブです。その直感は、サイズ n バイトのデータ上の原子的プリミティブ（compareExchange、load、store、add、sub、and、or、xor、またはexchange）の原子的手順が、周囲のエージェントがそのデータを構成する n バイトの外側のロックを取得することなしに実行される場合、Atomics.isLockFree(n) は
Atomics.isLockFree(4) は、既知の関連ハードウェアすべてでサポート可能であるため、常に
この関数によって返される値にかかわらず、すべての原子的操作は原子的であることが保証されます。例えば、操作の途中で可視的な操作が発生すること（例えば「tearing」）は決してありません。
25.4.9 Atomics.load ( typedArray, index )
この関数は呼び出されたとき、次の手順を実行します：
- byteIndexInBuffer を ?
ValidateAtomicAccessOnIntegerTypedArray (typedArray, index) とする。 - ?
RevalidateAtomicAccess (typedArray, byteIndexInBuffer) を実行する。 - buffer を typedArray.[[ViewedArrayBuffer]] とする。
- elementType を
TypedArrayElementType (typedArray) とする。 GetValueFromBuffer (buffer, byteIndexInBuffer, elementType,true ,seq-cst ) を返す。
25.4.10 Atomics.or ( typedArray, index, value )
この関数は呼び出されたとき、次の手順を実行します：
- or を、何も捕捉せず、呼び出されたときに次の手順を原子的に実行する、パラメーター (xBytes, yBytes) を持つ新しい
read-modify-write変更関数 とする：ByteListBitwiseOp (|, xBytes, yBytes) を返す。
- ?
AtomicReadModifyWrite (typedArray, index, value, or) を返す。
25.4.11 Atomics.store ( typedArray, index, value )
この関数は呼び出されたとき、次の手順を実行します：
- byteIndexInBuffer を ?
ValidateAtomicAccessOnIntegerTypedArray (typedArray, index) とする。 - typedArray.[[ContentType]] が
bigint である場合、coerced を ?ToBigInt (value) とする。 - そうでなければ、coerced を
𝔽 (?ToIntegerOrInfinity (value)) とする。 - ?
RevalidateAtomicAccess (typedArray, byteIndexInBuffer) を実行する。 - buffer を typedArray.[[ViewedArrayBuffer]] とする。
- elementType を
TypedArrayElementType (typedArray) とする。 SetValueInBuffer (buffer, byteIndexInBuffer, elementType, coerced,true ,seq-cst ) を実行する。- coerced を返す。
25.4.12 Atomics.sub ( typedArray, index, value )
この関数は呼び出されたとき、次の手順を実行します：
- subtract を、typedArray を捕捉し、呼び出されたときに次の手順を原子的に実行する、パラメーター (xBytes, yBytes) を持つ新しい
read-modify-write変更関数 とする：- type を
TypedArrayElementType (typedArray) とする。 - 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 (typedArray, index, value, subtract) を返す。
25.4.13 Atomics.wait ( typedArray, index, value, timeout )
この関数は、周囲のエージェントを待機キューに入れて、通知されるか待機がタイムアウトするまで一時停止し、それらの場合を区別するStringを返します。
呼び出されたとき、次の手順を実行します：
- ?
DoWait (sync , typedArray, index, value, timeout) を返す。
25.4.14 Atomics.waitAsync ( typedArray, index, value, timeout )
この関数は、呼び出し元エージェントが通知されるかタイムアウトに到達したときに解決されるPromiseを返します。
呼び出されたとき、次の手順を実行します：
- ?
DoWait (async , typedArray, index, value, timeout) を返す。
25.4.15 Atomics.notify ( typedArray, index, count )
この関数は、待機キューで眠っているいくつかのエージェントに通知します。
呼び出されたとき、次の手順を実行します：
- taRecord を ?
ValidateIntegerTypedArray (typedArray,true ) とする。 - byteIndexInBuffer を ?
ValidateAtomicAccess (taRecord, index) とする。 - count が
undefined の場合、- count を +∞ に設定する。
- そうでなければ、
- intCount を ?
ToIntegerOrInfinity (count) とする。 - count を
max (intCount, 0) に設定する。
- intCount を ?
- buffer を typedArray.[[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) を実行する。- n を waiters 内の要素数とする。
𝔽 (n) を返す。
25.4.16 Atomics.xor ( typedArray, index, value )
この関数は呼び出されたとき、次の手順を実行します：
- xor を、何も捕捉せず、呼び出されたときに次の手順を原子的に実行する、パラメーター (xBytes, yBytes) を持つ新しい
read-modify-write変更関数 とする：ByteListBitwiseOp (^, xBytes, yBytes) を返す。
- ?
AtomicReadModifyWrite (typedArray, index, value, xor) を返す。
25.4.17 Atomics [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
25.5 JSONオブジェクト
JSONオブジェクトは：
- %JSON%である。
グローバルオブジェクト の"JSON" プロパティの初期値である。- 通常のオブジェクトである。
- JSONテキストを解析および構築するために使用される2つの関数、
parseとstringifyを含む。 - [[Prototype]]内部スロットを持ち、その値は
%Object.prototype% である。 - [[Construct]]内部メソッドを持たない。
new演算子と共にコンストラクターとして使用できない。 - [[Call]]内部メソッドを持たない。関数として呼び出すことができない。
JSONデータ交換形式はECMA-404で定義されています。この仕様で使用されるJSON交換形式は、ECMA-404によって記述されたものと正確に同じです。JSON.parseおよびJSON.stringifyの適合実装は、ECMA-404仕様で記述された正確な交換形式を、その形式に対するいかなる削除または拡張もなしにサポートしなければなりません。
25.5.1 JSON.isRawJSON ( obj )
この関数は呼び出されたとき、次の手順を実行します：
- obj がObjectであり、obj が [[IsRawJSON]] 内部スロットを持つ場合、
true を返す。 false を返す。
25.5.2 JSON.parse ( text [ , reviver ] )
この関数はJSONテキスト（JSON形式のString）を解析し、ECMAScript言語値を生成します。JSON形式は、ECMAScriptリテラル、Array Initializer、およびObject Initializerの構文に似た構文で、リテラル、配列、およびオブジェクトを表します。解析後、JSONオブジェクトはECMAScriptオブジェクトとして実現されます。JSON配列はECMAScript Arrayインスタンスとして実現されます。JSON文字列、数値、真偽値、およびnullは、ECMAScriptのString、Number、Boolean、および
任意の reviver パラメーターは、結果をフィルターし変換できる関数です。解析によって生成される各値について、reviver は3つの引数（関連付けられたプロパティキー、値、およびコンテキストオブジェクト）で呼び出されます。プロパティが変更されておらず、その値がプリミティブである場合、提供されるコンテキストオブジェクトは、対応する
- jsonString を ?
ToString (text) とする。 - parseResult を ?
ParseJSON (jsonString) とする。 - unfiltered を parseResult.[[Value]] とする。
IsCallable (reviver) がfalse の場合、unfiltered を返す。- root を
OrdinaryObjectCreate (%Object.prototype% ) とする。 - rootName を空のStringとする。
- !
CreateDataPropertyOrThrow (root, rootName, unfiltered) を実行する。 - snapshot を
CreateJSONParseRecord (parseResult.[[ParseNode]], rootName, unfiltered) とする。 - ?
InternalizeJSONProperty (root, rootName, reviver, snapshot) を返す。
この関数の
25.5.2.1 ParseJSON ( text )
The
StringToCodePoints (text) がECMA-404で指定される有効なJSONテキストでない場合、SyntaxError 例外をスローする。- scriptString を
"(" 、text、および");" の文字列連結とする。 - script を
ParseText (scriptString,Script ) とする。 NOTE :13.2.5.1 で定義される早期エラー規則は、上記のParseText の呼び出しについて特別な扱いを持ちます。Assert : script はParse Node である。- result を !
Evaluation of script とする。 NOTE :13.2.5.6 で定義されるPropertyDefinitionEvaluation 意味論は、上記の評価について特別な扱いを持ちます。Assert : result はString、Number、Boolean、ArrayLiteral またはObjectLiteral のいずれかによって定義されるObject、またはnull のいずれかである。Record { [[ParseNode]]: script, [[Value]]: result } を返す。
JSON.parseの適合実装がJSON文法を拡張することは許されません。実装が変更または拡張されたJSON交換形式をサポートしたい場合、別の解析関数を定義することによってそうしなければなりません。
有効なJSONテキストはECMAScriptの
しかし、
オブジェクト内に重複する名前Stringがある場合、字句的に先行する同じキーの値は上書きされます。
25.5.2.2 JSON Parse Record
JSON Parse Recordとは、JSONテキストから解析された値の初期状態を記述するために使用される
JSON Parse Recordは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[ParseNode]] | コンテキスト |
|
| [[Key]] | プロパティ名 | [[Value]]が関連付けられているプロパティ名。 |
| [[Value]] | ECMAScript言語値 | [[ParseNode]]の評価によって生成された値。 |
| [[Elements]] | [[Value]]がArrayである場合、これは[[Value]]の要素に対応する |
|
| [[Entries]] | [[Value]]が非Array Objectである場合、これは[[Value]]のエントリーに対応する |
25.5.2.3 CreateJSONParseRecord ( parseNode, key, val )
The
- typedValNode を
ShallowestContainedJSONValue (parseNode) とする。 Assert : typedValNode はempty でない。- elements を新しい空の
List とする。 - entries を新しい空の
List とする。 - val がObjectである場合、
- isArray を !
IsArray (val) とする。 - isArray が
true の場合、Assert : typedValNode はArrayLiteral Parse Node である。- contentNodes を typedValNode の
JSONArrayLiteralContentNodes とする。 - len を contentNodes 内の要素数とする。
- valLen を !
LengthOfArrayLike (val) とする。 Assert : valLen は len である。- index を0とする。
- index < len の間、繰り返す：
- propName を !
ToString (𝔽 (index)) とする。 - elementParseRecord を
CreateJSONParseRecord (contentNodes[index], propName, !Get (val, propName)) とする。 - elementParseRecord を elements に追加する。
- index を index + 1 に設定する。
- propName を !
- そうでなければ、
Assert : typedValNode はObjectLiteral Parse Node である。- propertyNodes を typedValNode の
PropertyDefinitionNodes とする。 NOTE : val はJSONテキストから生成され変更されていないため、そのすべてのプロパティキーはStringであり、網羅的に列挙されます。- keys を !
EnumerableOwnProperties (val,key ) とする。 - keys の各String propertyKey について、次を行う：
NOTE : 単一のオブジェクトに対して同じ名前の複数の名前/値ペアを指定するJSONテキスト（例えば{"a":"lost","a":"kept"}）の場合、結果のECMAScriptオブジェクトの対応するプロパティの値は、その名前を持つ最後のペアによって指定されます。- propertyDefinition を
empty とする。 - propertyNodes の各
Parse Node propertyNode について、次を行う：- propName を propertyNode の
PropName とする。 - propName が propertyKey である場合、propertyDefinition を propertyNode に設定する。
- propName を propertyNode の
Assert : propertyDefinition はPropertyDefinition : PropertyName : AssignmentExpression - propertyValueNode を propertyDefinition の
AssignmentExpression とする。 - entryParseRecord を
CreateJSONParseRecord (propertyValueNode, propertyKey, !Get (val, propertyKey)) とする。 - entryParseRecord を entries に追加する。
- isArray を !
- そうでなければ、
Assert : typedValNode はArrayLiteral Parse Node でもObjectLiteral Parse Node でもない。
JSON Parse Record { [[ParseNode]]: typedValNode, [[Key]]: key, [[Value]]: val, [[Elements]]: elements, [[Entries]]: entries } を返す。
25.5.2.4 InternalizeJSONProperty ( holder, name, reviver, parseRecord )
The
このアルゴリズムは、[[Delete]]または
呼び出されたとき、次の手順を実行します：
- val を ?
Get (holder, name) とする。 - context を
OrdinaryObjectCreate (%Object.prototype% ) とする。 - parseRecord が
JSON Parse Record であり、SameValue (parseRecord.[[Value]], val) がtrue である場合、- val がObjectでない場合、
- parseNode を parseRecord.[[ParseNode]] とする。
Assert : parseNode はArrayLiteral Parse Node でもObjectLiteral Parse Node でもない。- sourceText を parseNode に一致したソーステキストとする。
- !
CreateDataPropertyOrThrow (context,"source" ,CodePointsToString (sourceText)) を実行する。
- elementRecords を parseRecord.[[Elements]] とする。
- entryRecords を parseRecord.[[Entries]] とする。
- val がObjectでない場合、
- そうでなければ、
- val がObjectである場合、
- isArray を ?
IsArray (val) とする。 - isArray が
true の場合、- elementRecordsLen を elementRecords 内の要素数とする。
- len を ?
LengthOfArrayLike (val) とする。 - index を0とする。
- index < len の間、繰り返す：
- propertyKey を !
ToString (𝔽 (index)) とする。 - index < elementRecordsLen の場合、elementRecord を elementRecords[index] とする。そうでなければ、elementRecord を
empty とする。 - newElement を ?
InternalizeJSONProperty (val, propertyKey, reviver, elementRecord) とする。 - newElement が
undefined である場合、- ? val.[[Delete]](propertyKey) を実行する。
- そうでなければ、
- ?
CreateDataProperty (val, propertyKey, newElement) を実行する。
- ?
- index を index + 1 に設定する。
- propertyKey を !
- そうでなければ、
- keys を ?
EnumerableOwnProperties (val,key ) とする。 - keys の各String propertyKey について、次を行う：
- entryRecords の要素 entry であって entry.[[Key]] が propertyKey であるものが存在する場合、entryRecord を entry とする。そうでなければ、entryRecord を
empty とする。 - newElement を ?
InternalizeJSONProperty (val, propertyKey, reviver, entryRecord) とする。 - newElement が
undefined である場合、- ? val.[[Delete]](propertyKey) を実行する。
- そうでなければ、
- ?
CreateDataProperty (val, propertyKey, newElement) を実行する。
- ?
- entryRecords の要素 entry であって entry.[[Key]] が propertyKey であるものが存在する場合、entryRecord を entry とする。そうでなければ、entryRecord を
- keys を ?
- isArray を ?
- ?
Call (reviver, holder, « name, val, context ») を返す。
25.5.2.5 Static Semantics: ShallowestContainedJSONValue ( root )
The
- activeFunc をアクティブな関数オブジェクトとする。
Assert : activeFunc はJSON.parse組み込み関数オブジェクトである（JSON.parse を参照）。- types を «
NullLiteral ,BooleanLiteral ,NumericLiteral ,StringLiteral ,ArrayLiteral ,ObjectLiteral ,UnaryExpression » とする。 - unaryExpression を
empty とする。 - queue を « root » とする。
- queue が空でない間、繰り返す：
- candidate を queue の最初の要素とする。
- queue から最初の要素を削除する。
- queuedChildren を
false とする。 - types の各非終端記号 type について、次を行う：
- candidate が type のインスタンスである場合、
NOTE : JSON文法では、numberトークンは負の値を表す場合があります。ECMAScriptでは、否定は単項演算として表され、その中でUnaryExpression は-に続く派生UnaryExpression として解析されます。- type が
UnaryExpression である場合、- candidate の親が
UnaryExpression Parse Node でない場合、unaryExpression を candidate に設定する。
- candidate の親が
- そうでなく type が
NumericLiteral である場合、Assert : candidate は unaryExpression に含まれている。- unaryExpression を返す。
- そうでなければ、
- candidate を返す。
- queuedChildren が
false であり、candidate が非終端記号のインスタンスであり、かつ candidateContains type がtrue である場合、- children を、candidate の各子ノードを順に含む
List とする。 - queue を queue と children のリスト連結に設定する。
- queuedChildren を
true に設定する。
- children を、candidate の各子ノードを順に含む
- candidate が type のインスタンスである場合、
empty を返す。
25.5.2.6 Static Semantics: JSONArrayLiteralContentNodes
The
Assert :Elision は存在しない。ElementList が存在しない場合、新しい空のList を返す。ElementList のJSONArrayLiteralContentNodes を返す。
Assert :Elision は存在しない。- «
AssignmentExpression » を返す。
Assert :Elision は存在しない。- elements を派生
ElementList のJSONArrayLiteralContentNodes とする。 - elements と «
AssignmentExpression » のリスト連結を返す。
NOTE : ECMA-404で指定されるJSONテキストはSpreadElement を含みません。Assert : この手順に到達することは決してない。
25.5.3 JSON.rawJSON ( text )
この関数は、文字列、数値、真偽値、またはnull値の生のJSONテキストを表すオブジェクトを返します。
- jsonString を ?
ToString (text) とする。 - jsonString が空のStringである場合、
SyntaxError 例外をスローする。 - jsonString の最初のコード単位が、ASCII小文字コード単位（0x0061から0x007Aまで、両端を含む）、ASCII数字コード単位（0x0030から0x0039まで、両端を含む）、0x0022（QUOTATION MARK）、または0x002D（HYPHEN-MINUS）のいずれでもない場合、
SyntaxError 例外をスローする。 - jsonString の最後のコード単位が、ASCII小文字コード単位（0x0061から0x007Aまで、両端を含む）、ASCII数字コード単位（0x0030から0x0039まで、両端を含む）、または0x0022（QUOTATION MARK）のいずれでもない場合、
SyntaxError 例外をスローする。 - parseResult を ?
ParseJSON (jsonString) とする。 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 ] ] )
この関数は、ECMAScript言語値を表すUTF-16エンコードJSON形式のString、または
呼び出されたとき、次の手順を実行します：
- stack を新しい空の
List とする。 - indent を空のStringとする。
- propertyList を
undefined とする。 - replacerFunction を
undefined とする。 - replacer がObjectである場合、
IsCallable (replacer) がtrue の場合、- replacerFunction を replacer に設定する。
- そうでなければ、
- isArray を ?
IsArray (replacer) とする。 - isArray が
true の場合、- propertyList を新しい空の
List に設定する。 - len を ?
LengthOfArrayLike (replacer) とする。 - k を0とする。
- k < len の間、繰り返す：
- propertyKey を !
ToString (𝔽 (k)) とする。 - propertyValue を ?
Get (replacer, propertyKey) とする。 - item を
undefined とする。 - propertyValue がStringである場合、
- item を propertyValue に設定する。
- そうでなく propertyValue がNumberである場合、
- item を !
ToString (propertyValue) に設定する。
- item を !
- そうでなく propertyValue がObjectである場合、
- propertyValue が [[StringData]] または [[NumberData]] 内部スロットを持つ場合、item を ?
ToString (propertyValue) に設定する。
- propertyValue が [[StringData]] または [[NumberData]] 内部スロットを持つ場合、item を ?
- item が
undefined でなく、かつ propertyList が item を含まない場合、- item を propertyList に追加する。
- k を k + 1 に設定する。
- propertyKey を !
- propertyList を新しい空の
- isArray を ?
- space がObjectである場合、
- space がNumberである場合、
- spaceMV を !
ToIntegerOrInfinity (space) とする。 - spaceMV を
min (10, spaceMV) に設定する。 - spaceMV < 1 の場合、gap を空のStringとする。そうでなければ、gap をコード単位0x0020（SPACE）が spaceMV 個出現するString値とする。
- spaceMV を !
- そうでなく space がStringである場合、
- space の長さが10以下である場合、gap を space とする。そうでなければ、gap を space の0から10までの部分文字列とする。
- そうでなければ、
- gap を空のStringとする。
- wrapper を
OrdinaryObjectCreate (%Object.prototype% ) とする。 - !
CreateDataPropertyOrThrow (wrapper, 空のString, value) を実行する。 - state を
JSON Serialization Record { [[ReplacerFunction]]: replacerFunction, [[Stack]]: stack, [[Indent]]: indent, [[Gap]]: gap, [[PropertyList]]: propertyList } とする。 - ?
SerializeJSONProperty (state, 空のString, wrapper) を返す。
この関数の
JSON構造は任意の深さまで入れ子にできますが、非循環でなければなりません。value が循環構造である、または循環構造を含む場合、この関数は
a = [];
a[0] = a;
my_text = JSON.stringify(a); // これはTypeErrorをスローしなければならない。シンボリックなプリミティブ値は次のようにレンダリングされます：
-
null 値は、JSONテキストではString値"null" としてレンダリングされる。 -
undefined 値はレンダリングされない。 -
true 値は、JSONテキストではString値"true" としてレンダリングされる。 -
false 値は、JSONテキストではString値"false" としてレンダリングされる。
String値はQUOTATION MARK（"）コード単位で囲まれます。コード単位 " および \ は \ 接頭辞でエスケープされます。制御文字コード単位は、エスケープシーケンス \uHHHH、またはより短い形式である \b（BACKSPACE）、\f（FORM FEED）、\n（LINE FEED）、\r（CARRIAGE RETURN）、\t（CHARACTER TABULATION）に置き換えられます。
有限数は
JSON表現を持たない値（
オブジェクトは、U+007B（LEFT CURLY BRACKET）に続き、0個以上のプロパティをU+002C（COMMA）で区切り、U+007D（RIGHT CURLY BRACKET）で閉じたものとしてレンダリングされます。プロパティは、プロパティ名を表す引用符付きString、U+003A（COLON）、そして文字列化されたプロパティ値からなります。配列は、開始U+005B（LEFT SQUARE BRACKET）に続き、0個以上の値をU+002C（COMMA）で区切り、U+005D（RIGHT SQUARE BRACKET）で閉じたものとしてレンダリングされます。
25.5.4.1 JSON Serialization Record
JSON Serialization Recordとは、JSON形式への直列化を可能にするために使用される
JSON Serialization Recordは、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[ReplacerFunction]] | 関数オブジェクトまたは |
オブジェクトプロパティの置換値を供給できる関数（JSON.stringifyの replacer パラメーターから）。 |
| [[PropertyList]] | Stringの |
非配列オブジェクトを直列化するときに含めるプロパティ名（JSON.stringifyの replacer パラメーターから）。 |
| [[Gap]] | String | インデントの単位（JSON.stringifyの space パラメーターから）。 |
| [[Stack]] | Objectの |
直列化処理中である入れ子のオブジェクトの集合。循環構造を検出するために使用される。 |
| [[Indent]] | String | 現在のインデント。 |
25.5.4.2 SerializeJSONProperty ( state, key, holder )
The
- 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]] 内部スロットを持つ場合、
- value が [[NumberData]] 内部スロットを持つ場合、
- value を ?
ToNumber (value) に設定する。
- value を ?
- そうではなく、value が [[StringData]] 内部スロットを持つ場合、
- value を ?
ToString (value) に設定する。
- value を ?
- そうではなく、value が [[BooleanData]] 内部スロットを持つ場合、
- value を value.[[BooleanData]] に設定する。
- そうではなく、value が [[BigIntData]] 内部スロットを持つ場合、
- value を value.[[BigIntData]] に設定する。
- value が
null である場合、"null" を返す。 - value が
true である場合、"true" を返す。 - value が
false である場合、"false" を返す。 - value が String である場合、
QuoteJSONString (value) を返す。 - value が Number である場合、
- value が有限である場合、!
ToString (value) を返す。 "null" を返す。
- value が有限である場合、!
- value が BigInt である場合、
TypeError 例外を投げる。 - value が Object であり、
IsCallable (value) がfalse である場合、- isArray を ?
IsArray (value) とする。 - isArray が
true である場合、- ?
SerializeJSONArray (state, value) を返す。
- ?
- ?
SerializeJSONObject (state, value) を返す。
- isArray を ?
undefined を返す。
25.5.4.3 QuoteJSONString ( value )
The
- product を、コード単位0x0022（QUOTATION MARK）のみからなるString値とする。
StringToCodePoints (value) の各コードポイント cp について、次を行う：- cp が
Table 77 の“Code Point”列に列挙されている場合、- product を、product と、対応する行の“Escape Sequence”列で指定される cp のエスケープシーケンスとの文字列連結に設定する。
- そうでなく cp の数値が0x0020（SPACE）未満であるか、または cp が先行サロゲートまたは後続サロゲートと同じ数値を持つ場合、
- unit を、数値が cp の数値であるコード単位とする。
- product を、product と
UnicodeEscape (unit) の文字列連結に設定する。
- そうでなければ、
- product を、product と
UTF16EncodeCodePoint (cp) の文字列連結に設定する。
- product を、product と
- cp が
- product を、product とコード単位0x0022（QUOTATION MARK）の文字列連結に設定する。
- product を返す。
| コードポイント | Unicode文字名 | エスケープシーケンス |
|---|---|---|
| U+0008 | BACKSPACE |
\b
|
| U+0009 | CHARACTER TABULATION |
\t
|
| U+000A | LINE FEED (LF) |
\n
|
| U+000C | FORM FEED (FF) |
\f
|
| U+000D | CARRIAGE RETURN (CR) |
\r
|
| U+0022 | QUOTATION MARK |
\"
|
| U+005C | REVERSE SOLIDUS |
\\
|
25.5.4.4 UnicodeEscape ( constructor )
The
25.5.4.5 SerializeJSONObject ( state, value )
The
- state.[[Stack]] が value を含む場合、その構造は循環しているため、
TypeError 例外をスローする。 - value を state.[[Stack]] に追加する。
- stepBack を state.[[Indent]] とする。
- state.[[Indent]] を state.[[Indent]] と state.[[Gap]] の文字列連結に設定する。
- state.[[PropertyList]] が
undefined でない場合、- keys を state.[[PropertyList]] とする。
- そうでなければ、
- keys を ?
EnumerableOwnProperties (value,key ) とする。
- keys を ?
- partial を新しい空の
List とする。 - keys の各要素 propertyKey について、次を行う：
- strP を ?
SerializeJSONProperty (state, propertyKey, value) とする。 - strP が
undefined でない場合、- member を
QuoteJSONString (propertyKey) とする。 - member を member と
":" の文字列連結に設定する。 - state.[[Gap]] が空のStringでない場合、
- member を member とコード単位0x0020（SPACE）の文字列連結に設定する。
- member を member と strP の文字列連結に設定する。
- member を partial に追加する。
- member を
- strP を ?
- partial が空である場合、
- final を
"{}" とする。
- final を
- そうでなければ、
- state.[[Gap]] が空のStringである場合、
- properties を、partial のすべての要素Stringを連結し、隣接するStringの各ペアの間をコード単位0x002C（COMMA）で区切って形成されるString値とする。最初のStringの前にも最後のStringの後にもコンマは挿入されない。
- final を
"{" 、properties、および"}" の文字列連結とする。
- そうでなければ、
- separator を、コード単位0x002C（COMMA）、コード単位0x000A（LINE FEED）、および state.[[Indent]] の文字列連結とする。
- properties を、partial のすべての要素Stringを連結し、隣接するStringの各ペアの間を separator で区切って形成されるString値とする。separator Stringは、最初のStringの前にも最後のStringの後にも挿入されない。
- final を
"{" 、コード単位0x000A（LINE FEED）、state.[[Indent]]、properties、コード単位0x000A（LINE FEED）、stepBack、および"}" の文字列連結とする。
- state.[[Gap]] が空のStringである場合、
- state.[[Stack]] の最後の要素を削除する。
- state.[[Indent]] を stepBack に設定する。
- final を返す。
25.5.4.6 SerializeJSONArray ( state, value )
The
- state.[[Stack]] が value を含む場合、その構造は循環しているため、
TypeError 例外をスローする。 - value を state.[[Stack]] に追加する。
- stepBack を state.[[Indent]] とする。
- state.[[Indent]] を state.[[Indent]] と state.[[Gap]] の文字列連結に設定する。
- partial を新しい空の
List とする。 - len を ?
LengthOfArrayLike (value) とする。 - index を0とする。
- index < len の間、繰り返す：
- strP を ?
SerializeJSONProperty (state, !ToString (𝔽 (index)), value) とする。 - strP が
undefined である場合、"null" を partial に追加する。
- そうでなければ、
- strP を partial に追加する。
- index を index + 1 に設定する。
- strP を ?
- partial が空である場合、
- final を
"[]" とする。
- final を
- そうでなければ、
- state.[[Gap]] が空のStringである場合、
- properties を、partial のすべての要素Stringを連結し、隣接するStringの各ペアの間をコード単位0x002C（COMMA）で区切って形成されるString値とする。最初のStringの前にも最後のStringの後にもコンマは挿入されない。
- final を
"[" 、properties、および"]" の文字列連結とする。
- そうでなければ、
- separator を、コード単位0x002C（COMMA）、コード単位0x000A（LINE FEED）、および state.[[Indent]] の文字列連結とする。
- properties を、partial のすべての要素Stringを連結し、隣接するStringの各ペアの間を separator で区切って形成されるString値とする。separator Stringは、最初のStringの前にも最後のStringの後にも挿入されない。
- final を
"[" 、コード単位0x000A（LINE FEED）、state.[[Indent]]、properties、コード単位0x000A（LINE FEED）、stepBack、および"]" の文字列連結とする。
- state.[[Gap]] が空のStringである場合、
- state.[[Stack]] の最後の要素を削除する。
- state.[[Indent]] を stepBack に設定する。
- final を返す。
配列の表現には、array.length（含まない）までの区間内の要素のみが含まれます。キーが配列インデックスでないプロパティは文字列化から除外されます。配列は、開始LEFT SQUARE BRACKET、COMMAで区切られた要素、および終了RIGHT SQUARE BRACKETとして文字列化されます。
25.5.5 JSON [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
26 メモリ管理
26.1 WeakRefオブジェクト
26.1.1 WeakRefコンストラクター
WeakRefコンストラクターは：
- %WeakRef%である。
-
グローバルオブジェクト の"WeakRef" プロパティの初期値である。 - コンストラクターとして呼び出されたとき、新しいWeakRefを作成して初期化する。
- 関数として呼び出されることを意図しておらず、そのように呼び出された場合は例外をスローする。
-
クラス定義の
extends節の値として使用できる。指定されたWeakRefの振る舞いを継承しようとするサブクラスコンストラクターは、WeakRef.prototype組み込みメソッドをサポートするために必要な内部状態を持つサブクラスインスタンスを作成して初期化するために、WeakRefコンストラクターへのsuper呼び出しを含めなければならない。
26.1.1.1 WeakRef ( target )
この関数は呼び出されたとき、次の手順を実行します：
- NewTarget が
undefined の場合、TypeError 例外をスローする。 CanBeHeldWeakly (target) がfalse の場合、TypeError 例外をスローする。- weakRef を ?
OrdinaryCreateFromConstructor (NewTarget,"%WeakRef.prototype%" , « [[WeakRefTarget]] ») とする。 AddToKeptObjects (target) を実行する。- weakRef.[[WeakRefTarget]] を target に設定する。
- weakRef を返す。
26.1.2 WeakRefコンストラクターのプロパティ
-
[[Prototype]]内部スロットを持ち、その値は
%Function.prototype% である。 - 次のプロパティを持つ：
26.1.2.1 WeakRef.prototype
WeakRef.prototypeの初期値は
このプロパティの属性は { [[Writable]]:
26.1.3 WeakRefプロトタイプオブジェクトのプロパティ
WeakRefプロトタイプオブジェクトは：
- %WeakRef.prototype%である。
-
[[Prototype]]内部スロットを持ち、その値は
%Object.prototype% である。 - 通常のオブジェクトである。
- [[WeakRefTarget]]内部スロットを持たない。
26.1.3.1 WeakRef.prototype.constructor
WeakRef.prototype.constructorの初期値は
26.1.3.2 WeakRef.prototype.deref ( )
このメソッドは呼び出されたとき、次の手順を実行します：
- weakRef を
this 値とする。 - ?
RequireInternalSlot (weakRef, [[WeakRefTarget]]) を実行する。 WeakRefDeref (weakRef) を返す。
let target = { foo() {} };
let weakRef = new WeakRef(target);
// ... later ...
if (weakRef.deref()) {
weakRef.deref().foo();
}上記の例では、最初のderefが
26.1.3.3 WeakRef.prototype [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
26.1.4 WeakRef抽象操作
26.1.4.1 WeakRefDeref ( weakRef )
The
- target を weakRef.[[WeakRefTarget]] とする。
- target が
empty でない場合、AddToKeptObjects (target) を実行する。- target を返す。
undefined を返す。
この抽象操作は、livenessを簡潔に定義できるようにするためだけに、WeakRef.prototype.derefとは別に定義されています。
26.1.5 WeakRefインスタンスのプロパティ
26.2 FinalizationRegistryオブジェクト
26.2.1 FinalizationRegistryコンストラクター
FinalizationRegistryコンストラクターは：
- %FinalizationRegistry%である。
-
グローバルオブジェクト の"FinalizationRegistry" プロパティの初期値である。 - コンストラクターとして呼び出されたとき、新しいFinalizationRegistryを作成して初期化する。
- 関数として呼び出されることを意図しておらず、そのように呼び出された場合は例外をスローする。
-
クラス定義の
extends節の値として使用できる。指定されたFinalizationRegistryの振る舞いを継承しようとするサブクラスコンストラクターは、FinalizationRegistry.prototype組み込みメソッドをサポートするために必要な内部状態を持つサブクラスインスタンスを作成して初期化するために、FinalizationRegistryコンストラクターへのsuper呼び出しを含めなければならない。
26.2.1.1 FinalizationRegistry ( cleanupCallback )
この関数は呼び出されたとき、次の手順を実行します：
- NewTarget が
undefined の場合、TypeError 例外をスローする。 IsCallable (cleanupCallback) がfalse の場合、TypeError 例外をスローする。- finalizationRegistry を ?
OrdinaryCreateFromConstructor (NewTarget,"%FinalizationRegistry.prototype%" , « [[Realm]], [[CleanupCallback]], [[Cells]] ») とする。 - fn をアクティブな関数オブジェクトとする。
- finalizationRegistry.[[Realm]] を fn.[[Realm]] に設定する。
- finalizationRegistry.[[CleanupCallback]] を
HostMakeJobCallback (cleanupCallback) に設定する。 - finalizationRegistry.[[Cells]] を新しい空の
List に設定する。 - finalizationRegistry を返す。
26.2.2 FinalizationRegistryコンストラクターのプロパティ
-
[[Prototype]]内部スロットを持ち、その値は
%Function.prototype% である。 - 次のプロパティを持つ：
26.2.2.1 FinalizationRegistry.prototype
FinalizationRegistry.prototypeの初期値は
このプロパティの属性は { [[Writable]]:
26.2.3 FinalizationRegistryプロトタイプオブジェクトのプロパティ
FinalizationRegistryプロトタイプオブジェクトは：
- %FinalizationRegistry.prototype%である。
-
[[Prototype]]内部スロットを持ち、その値は
%Object.prototype% である。 - 通常のオブジェクトである。
- [[Cells]]および[[CleanupCallback]]内部スロットを持たない。
26.2.3.1 FinalizationRegistry.prototype.constructor
FinalizationRegistry.prototype.constructorの初期値は
26.2.3.2 FinalizationRegistry.prototype.register ( target, heldValue [ , unregisterToken ] )
このメソッドは呼び出されたとき、次の手順を実行します：
- finalizationRegistry を
this 値とする。 - ?
RequireInternalSlot (finalizationRegistry, [[Cells]]) を実行する。 CanBeHeldWeakly (target) がfalse の場合、TypeError 例外をスローする。SameValue (target, heldValue) がtrue の場合、TypeError 例外をスローする。CanBeHeldWeakly (unregisterToken) がfalse の場合、- unregisterToken が
undefined でない場合、TypeError 例外をスローする。 - unregisterToken を
empty に設定する。
- unregisterToken が
- cell を
Record { [[WeakRefTarget]]: target, [[HeldValue]]: heldValue, [[UnregisterToken]]: unregisterToken } とする。 - cell を finalizationRegistry.[[Cells]] に追加する。
undefined を返す。
26.2.3.3 FinalizationRegistry.prototype.unregister ( unregisterToken )
このメソッドは呼び出されたとき、次の手順を実行します：
- finalizationRegistry を
this 値とする。 - ?
RequireInternalSlot (finalizationRegistry, [[Cells]]) を実行する。 CanBeHeldWeakly (unregisterToken) がfalse の場合、TypeError 例外をスローする。- removed を
false とする。 - finalizationRegistry.[[Cells]] の各
Record { [[WeakRefTarget]], [[HeldValue]], [[UnregisterToken]] } cell について、次を行う：- cell.[[UnregisterToken]] が
empty でなく、SameValue (cell.[[UnregisterToken]], unregisterToken) がtrue である場合、- cell を finalizationRegistry.[[Cells]] から削除する。
- removed を
true に設定する。
- cell.[[UnregisterToken]] が
- removed を返す。
26.2.3.4 FinalizationRegistry.prototype [ %Symbol.toStringTag% ]
このプロパティの属性は { [[Writable]]:
26.2.4 FinalizationRegistryインスタンスのプロパティ
27 制御抽象オブジェクト
27.1 反復
27.1.1 共通反復インターフェイス
インターフェイスとは、関連付けられた値が特定の仕様に一致するプロパティキーの集合である。インターフェイスの仕様で記述されているすべてのプロパティを提供する任意のオブジェクトは、そのインターフェイスに適合する。インターフェイスは、個別のオブジェクトによって表されるものではない。任意のインターフェイスに適合する、別々に実装されたオブジェクトは多数存在し得る。個々のオブジェクトは複数のインターフェイスに適合し得る。
27.1.1.1 Iterable インターフェイス
iterable インターフェイスは、
| プロパティ | 値 | 要件 |
|---|---|---|
%Symbol.iterator%
|
|
返されるオブジェクトは |
27.1.1.2 Iterator インターフェイス
iterator インターフェイスを実装するオブジェクトは、
| プロパティ | 値 | 要件 |
|---|---|---|
|
|
IteratorResult オブジェクトを返す関数 |
返されるオブジェクトは next メソッドへの以前の呼び出しが、next メソッドへの以後のすべての呼び出しも、 |
next 関数に引数を渡してもよいが、その解釈と妥当性は対象の iterator に依存する。for-of 文および iterator のその他の一般的な利用者は引数を渡さないため、そのような方法で使用されることを想定する iterator オブジェクトは、引数なしで呼び出されることに対処できるようにしておかなければならない。
| プロパティ | 値 | 要件 |
|---|---|---|
|
|
IteratorResult オブジェクトを返す関数 |
返されるオブジェクトは next メソッド呼び出しを行う意図がないことを return メソッドの引数として渡された値を持つ |
|
|
IteratorResult オブジェクトを返す関数 |
返されるオブジェクトは throw することである。メソッドが throw しない場合、返される IteratorResult オブジェクトは通常、値が |
通常、これらのメソッドの呼び出し元は、それらを呼び出す前に存在を確認するべきである。for-of、yield*、および配列分割代入を含む特定の ECMAScript 言語機能は、存在確認を行った後にこれらのメソッドを呼び出す。
27.1.1.3 Async Iterable インターフェイス
async iterable インターフェイスは、
| プロパティ | 値 | 要件 |
|---|---|---|
%Symbol.asyncIterator% |
返されるオブジェクトは |
27.1.1.4 Async Iterator インターフェイス
async iterator インターフェイスを実装するオブジェクトは、
| プロパティ | 値 | 要件 |
|---|---|---|
| IteratorResult オブジェクトに対する promise を返す関数 |
返される promise は、履行されたとき、 さらに、履行値として機能する IteratorResult オブジェクトは、値が promise（または「thenable」）ではない |
next 関数に引数を渡してもよいが、その解釈と妥当性は対象の async iterator に依存する。for-await-of 文および async iterator のその他の一般的な利用者は引数を渡さないため、そのような方法で使用されることを想定する async iterator オブジェクトは、引数なしで呼び出されることに対処できるようにしておかなければならない。
| プロパティ | 値 | 要件 |
|---|---|---|
| IteratorResult オブジェクトに対する promise を返す関数 |
返される promise は、履行されたとき、 さらに、履行値として機能する IteratorResult オブジェクトは、値が promise（または「thenable」）ではない |
|
| IteratorResult オブジェクトに対する promise を返す関数 |
返される promise は、履行されたとき、 返される promise が履行された場合、IteratorResult オブジェクト履行値は通常、値が |
通常、これらのメソッドの呼び出し元は、それらを呼び出す前に存在を確認するべきである。for-await-of および yield* を含む特定の ECMAScript 言語機能は、存在確認を行った後にこれらのメソッドを呼び出す。
27.1.1.5 IteratorResult インターフェイス
IteratorResult インターフェイスは、
| プロパティ | 値 | 要件 |
|---|---|---|
|
|
Boolean |
これは next メソッド呼び出しの結果状態である。 |
|
|
|
done が |
27.1.2 Iterator Helper オブジェクト
Iterator Helper オブジェクトは、特定のソース
27.1.2.1 %IteratorHelperPrototype% オブジェクト
%IteratorHelperPrototype% オブジェクト：
- すべての
Iterator Helper オブジェクト によって継承されるプロパティを持つ。 - 通常のオブジェクトである。
- 値が
%Iterator.prototype% である [[Prototype]] 内部スロットを持つ。 - 次のプロパティを持つ：
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]] 内部スロットを持つ。- obj.[[GeneratorState]] が
suspended-start であるならば、- obj.[[GeneratorState]] を
completed に設定する。 NOTE : generator が completed 状態に入ると、それは二度とその状態を離れず、関連付けられた実行コンテキストは二度と再開されない。この時点で、obj に関連付けられた任意の実行状態は破棄できる。- ?
IteratorCloseAll (obj.[[UnderlyingIterators]],NormalCompletion (unused )) を実行する。 CreateIteratorResultObject (undefined ,true ) を返す。
- obj.[[GeneratorState]] を
- completion を
ReturnCompletion (undefined ) とする。 - ?
GeneratorResumeAbrupt (obj, completion,"Iterator Helper" ) を返す。
27.1.2.1.3 %IteratorHelperPrototype% [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
27.1.3 Iterator オブジェクト
27.1.3.1 Iterator コンストラクター
Iterator コンストラクター：
- %Iterator% である。
グローバルオブジェクト の"Iterator" プロパティの初期値である。- サブクラス化できるように設計されている。クラス定義の
extends 節の値として使用できる。
27.1.3.1.1 Iterator ( )
この関数は、呼び出されたとき次の手順を実行する：
- NewTarget が
undefined またはアクティブな関数オブジェクトのいずれかであれば、TypeError 例外を投げる。 - ?
OrdinaryCreateFromConstructor (NewTarget,"%Iterator.prototype%" ) を返す。
27.1.3.2 Iterator コンストラクターのプロパティ
- 値が
%Function.prototype% である [[Prototype]] 内部スロットを持つ。 - 次のプロパティを持つ：
27.1.3.2.1 Iterator.concat ( ...items )
- iterables を新しい空の
List とする。 - items の各要素 item について、次を行う：
- item が Object でなければ、
TypeError 例外を投げる。 - method を ?
GetMethod (item,%Symbol.iterator% ) とする。 - method が
undefined ならば、TypeError 例外を投げる。 Record { [[OpenMethod]]: method, [[Iterable]]: item } を iterables に追加する。
- item が Object でなければ、
- closure を、iterables をキャプチャし、呼び出されたときに次の手順を実行する、パラメータを持たない新しい
Abstract Closure とする：- iterables の各
Record iterable について、次を行う：- iter を ?
Call (iterable.[[OpenMethod]], iterable.[[Iterable]]) とする。 - iter が Object でなければ、
TypeError 例外を投げる。 - iteratorRecord を ?
GetIteratorDirect (iter) とする。 - innerAlive を
true とする。 - innerAlive が
true である間、繰り返す：- innerValue を ?
IteratorStepValue (iteratorRecord) とする。 - innerValue が
done であれば、- innerAlive を
false に設定する。
- innerAlive を
- そうでなければ、
- completion を
Completion (Yield (innerValue)) とする。 - completion が
abrupt completion であれば、- ?
IteratorClose (iteratorRecord, completion) を返す。
- ?
- completion を
- innerValue を ?
- iter を ?
ReturnCompletion (undefined ) を返す。
- iterables の各
- gen を
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterators]] ») とする。 - gen.[[UnderlyingIterators]] を新しい空の
List に設定する。 - gen を返す。
27.1.3.2.2 Iterator.from ( obj )
- iteratorRecord を ?
GetIteratorFlattenable (obj,iterate-string-primitives ) とする。 - hasInstance を ?
OrdinaryHasInstance (%Iterator% , iteratorRecord.[[Iterator]]) とする。 - hasInstance が
true ならば、- iteratorRecord.[[Iterator]] を返す。
- wrapper を
OrdinaryObjectCreate (%WrapForValidIteratorPrototype% , « [[Iterated]] ») とする。 - wrapper.[[Iterated]] を iteratorRecord に設定する。
- wrapper を返す。
27.1.3.2.2.1 %WrapForValidIteratorPrototype% オブジェクト
%WrapForValidIteratorPrototype% オブジェクト：
- 通常のオブジェクトである。
- 値が
%Iterator.prototype% である [[Prototype]] 内部スロットを持つ。
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 の初期値は
このプロパティは属性 { [[Writable]]:
27.1.3.3 Iterator プロトタイプオブジェクトのプロパティ
Iterator プロトタイプオブジェクト：
- %Iterator.prototype% である。
- 値が
%Object.prototype% である [[Prototype]] 内部スロットを持つ。 - 通常のオブジェクトである。
この仕様で定義され、
次の式は、ECMAScript コードが %Iterator.prototype% オブジェクトにアクセスできる方法の一つである：
Object.getPrototypeOf(Object.getPrototypeOf([][Symbol.iterator]()))27.1.3.3.1 Iterator.prototype.constructor
Iterator.prototype.constructor は、属性 { [[Enumerable]]:
27.1.3.3.1.1 get Iterator.prototype.constructor
[[Get]] 属性の値は、引数を必要としない built-in 関数である。呼び出されたとき、次の手順を実行する：
%Iterator% を返す。
27.1.3.3.1.2 set Iterator.prototype.constructor
[[Set]] 属性の値は、引数 v を取る built-in 関数である。呼び出されたとき、次の手順を実行する：
- ?
SetterThatIgnoresPrototypeProperties (this value,%Iterator.prototype% ,"constructor" , v) を実行する。 undefined を返す。
ほとんどの built-in プロトタイプ上の
27.1.3.3.2 Iterator.prototype.drop ( limit )
このメソッドは、呼び出されたとき次の手順を実行する：
- obj を
this value とする。 - obj が Object でなければ、
TypeError 例外を投げる。 - iterated を
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false } とする。 - numLimit を
Completion (ToNumber (limit)) とする。 IfAbruptCloseIterator (numLimit, iterated)。- numLimit が
NaN ならば、- error を
ThrowCompletion (新しく作成されたRangeError オブジェクト) とする。 - ?
IteratorClose (iterated, error) を返す。
- error を
- integerLimit を !
ToIntegerOrInfinity (numLimit) とする。 - integerLimit < 0 ならば、
- error を
ThrowCompletion (新しく作成されたRangeError オブジェクト) とする。 - ?
IteratorClose (iterated, error) を返す。
- error を
- iterated を ?
GetIteratorDirect (obj) に設定する。 - closure を、iterated と integerLimit をキャプチャし、呼び出されたときに次の手順を実行する、パラメータを持たない新しい
Abstract Closure とする：- remaining を integerLimit とする。
- remaining > 0 である間、繰り返す：
- remaining ≠ +∞ ならば、
- remaining を remaining - 1 に設定する。
- next を ?
IteratorStep (iterated) とする。 - next が
done ならば、ReturnCompletion (undefined ) を返す。
- remaining ≠ +∞ ならば、
- 繰り返す：
- value を ?
IteratorStepValue (iterated) とする。 - value が
done ならば、ReturnCompletion (undefined ) を返す。 - completion を
Completion (Yield (value)) とする。 IfAbruptCloseIterator (completion, iterated)。
- value を ?
- result を
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterators]] ») とする。 - result.[[UnderlyingIterators]] を « iterated » に設定する。
- result を返す。
27.1.3.3.3 Iterator.prototype.every ( predicate )
このメソッドは、呼び出されたとき次の手順を実行する：
- obj を
this value とする。 - obj が Object でなければ、
TypeError 例外を投げる。 - iterated を
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false } とする。 IsCallable (predicate) がfalse ならば、- error を
ThrowCompletion (新しく作成されたTypeError オブジェクト) とする。 - ?
IteratorClose (iterated, error) を返す。
- error を
- iterated を ?
GetIteratorDirect (obj) に設定する。 - counter を 0 とする。
- 繰り返す：
- value を ?
IteratorStepValue (iterated) とする。 - value が
done ならば、true を返す。 - result を
Completion (Call (predicate,undefined , « value,𝔽 (counter) »)) とする。 IfAbruptCloseIterator (result, iterated)。ToBoolean (result) がfalse ならば、?IteratorClose (iterated,NormalCompletion (false )) を返す。- counter を counter + 1 に設定する。
- value を ?
27.1.3.3.4 Iterator.prototype.filter ( predicate )
このメソッドは、呼び出されたとき次の手順を実行する：
- obj を
this value とする。 - obj が Object でなければ、
TypeError 例外を投げる。 - iterated を
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false } とする。 IsCallable (predicate) がfalse ならば、- error を
ThrowCompletion (新しく作成されたTypeError オブジェクト) とする。 - ?
IteratorClose (iterated, error) を返す。
- error を
- iterated を ?
GetIteratorDirect (obj) に設定する。 - closure を、iterated と predicate をキャプチャし、呼び出されたときに次の手順を実行する、パラメータを持たない新しい
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 )
このメソッドは、呼び出されたとき次の手順を実行する：
- obj を
this value とする。 - obj が Object でなければ、
TypeError 例外を投げる。 - iterated を
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false } とする。 IsCallable (predicate) がfalse ならば、- error を
ThrowCompletion (新しく作成されたTypeError オブジェクト) とする。 - ?
IteratorClose (iterated, error) を返す。
- error を
- iterated を ?
GetIteratorDirect (obj) に設定する。 - counter を 0 とする。
- 繰り返す：
- value を ?
IteratorStepValue (iterated) とする。 - value が
done ならば、undefined を返す。 - result を
Completion (Call (predicate,undefined , « value,𝔽 (counter) »)) とする。 IfAbruptCloseIterator (result, iterated)。ToBoolean (result) がtrue ならば、?IteratorClose (iterated,NormalCompletion (value)) を返す。- counter を counter + 1 に設定する。
- value を ?
27.1.3.3.6 Iterator.prototype.flatMap ( mapper )
このメソッドは、呼び出されたとき次の手順を実行する：
- obj を
this value とする。 - obj が Object でなければ、
TypeError 例外を投げる。 - iterated を
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false } とする。 IsCallable (mapper) がfalse ならば、- error を
ThrowCompletion (新しく作成されたTypeError オブジェクト) とする。 - ?
IteratorClose (iterated, error) を返す。
- error を
- iterated を ?
GetIteratorDirect (obj) に設定する。 - closure を、iterated と mapper をキャプチャし、呼び出されたときに次の手順を実行する、パラメータを持たない新しい
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 )
このメソッドは、呼び出されたとき次の手順を実行する：
- obj を
this value とする。 - obj が Object でなければ、
TypeError 例外を投げる。 - iterated を
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false } とする。 IsCallable (procedure) がfalse ならば、- error を
ThrowCompletion (新しく作成されたTypeError オブジェクト) とする。 - ?
IteratorClose (iterated, error) を返す。
- error を
- iterated を ?
GetIteratorDirect (obj) に設定する。 - counter を 0 とする。
- 繰り返す：
- value を ?
IteratorStepValue (iterated) とする。 - value が
done ならば、undefined を返す。 - result を
Completion (Call (procedure,undefined , « value,𝔽 (counter) »)) とする。 IfAbruptCloseIterator (result, iterated)。- counter を counter + 1 に設定する。
- value を ?
27.1.3.3.8 Iterator.prototype.map ( mapper )
このメソッドは、呼び出されたとき次の手順を実行する：
- obj を
this value とする。 - obj が Object でなければ、
TypeError 例外を投げる。 - iterated を
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false } とする。 IsCallable (mapper) がfalse ならば、- error を
ThrowCompletion (新しく作成されたTypeError オブジェクト) とする。 - ?
IteratorClose (iterated, error) を返す。
- error を
- iterated を ?
GetIteratorDirect (obj) に設定する。 - closure を、iterated と mapper をキャプチャし、呼び出されたときに次の手順を実行する、パラメータを持たない新しい
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 ] )
このメソッドは、呼び出されたとき次の手順を実行する：
- obj を
this value とする。 - obj が Object でなければ、
TypeError 例外を投げる。 - iterated を
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false } とする。 IsCallable (reducer) がfalse ならば、- error を
ThrowCompletion (新しく作成されたTypeError オブジェクト) とする。 - ?
IteratorClose (iterated, error) を返す。
- error を
- iterated を ?
GetIteratorDirect (obj) に設定する。 - initialValue が存在しないならば、
- accumulator を ?
IteratorStepValue (iterated) とする。 - accumulator が
done ならば、TypeError 例外を投げる。 - counter を 1 とする。
- accumulator を ?
- そうでなければ、
- accumulator を initialValue とする。
- counter を 0 とする。
- 繰り返す：
- value を ?
IteratorStepValue (iterated) とする。 - value が
done ならば、accumulator を返す。 - result を
Completion (Call (reducer,undefined , « accumulator, value,𝔽 (counter) »)) とする。 IfAbruptCloseIterator (result, iterated)。- accumulator を result に設定する。
- counter を counter + 1 に設定する。
- value を ?
27.1.3.3.10 Iterator.prototype.some ( predicate )
このメソッドは、呼び出されたとき次の手順を実行する：
- obj を
this value とする。 - obj が Object でなければ、
TypeError 例外を投げる。 - iterated を
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false } とする。 IsCallable (predicate) がfalse ならば、- error を
ThrowCompletion (新しく作成されたTypeError オブジェクト) とする。 - ?
IteratorClose (iterated, error) を返す。
- error を
- iterated を ?
GetIteratorDirect (obj) に設定する。 - counter を 0 とする。
- 繰り返す：
- value を ?
IteratorStepValue (iterated) とする。 - value が
done ならば、false を返す。 - result を
Completion (Call (predicate,undefined , « value,𝔽 (counter) »)) とする。 IfAbruptCloseIterator (result, iterated)。ToBoolean (result) がtrue ならば、?IteratorClose (iterated,NormalCompletion (true )) を返す。- counter を counter + 1 に設定する。
- value を ?
27.1.3.3.11 Iterator.prototype.take ( limit )
このメソッドは、呼び出されたとき次の手順を実行する：
- obj を
this value とする。 - obj が Object でなければ、
TypeError 例外を投げる。 - iterated を
Iterator Record { [[Iterator]]: obj, [[NextMethod]]:undefined , [[Done]]:false } とする。 - numLimit を
Completion (ToNumber (limit)) とする。 IfAbruptCloseIterator (numLimit, iterated)。- numLimit が
NaN ならば、- error を
ThrowCompletion (新しく作成されたRangeError オブジェクト) とする。 - ?
IteratorClose (iterated, error) を返す。
- error を
- integerLimit を !
ToIntegerOrInfinity (numLimit) とする。 - integerLimit < 0 ならば、
- error を
ThrowCompletion (新しく作成されたRangeError オブジェクト) とする。 - ?
IteratorClose (iterated, error) を返す。
- error を
- iterated を ?
GetIteratorDirect (obj) に設定する。 - closure を、iterated と integerLimit をキャプチャし、呼び出されたときに次の手順を実行する、パラメータを持たない新しい
Abstract Closure とする：- remaining を integerLimit とする。
- 繰り返す：
- remaining = 0 ならば、
- ?
IteratorClose (iterated,ReturnCompletion (undefined )) を返す。
- ?
- remaining ≠ +∞ ならば、
- remaining を remaining - 1 に設定する。
- value を ?
IteratorStepValue (iterated) とする。 - value が
done ならば、ReturnCompletion (undefined ) を返す。 - completion を
Completion (Yield (value)) とする。 IfAbruptCloseIterator (completion, iterated)。
- remaining = 0 ならば、
- result を
CreateIteratorFromClosure (closure,"Iterator Helper" ,%IteratorHelperPrototype% , « [[UnderlyingIterators]] ») とする。 - result.[[UnderlyingIterators]] を « iterated » に設定する。
- result を返す。
27.1.3.3.12 Iterator.prototype.toArray ( )
このメソッドは、呼び出されたとき次の手順を実行する：
- obj を
this value とする。 - obj が Object でなければ、
TypeError 例外を投げる。 - iterated を ?
GetIteratorDirect (obj) とする。 - items を新しい空の
List とする。 - 繰り返す：
- value を ?
IteratorStepValue (iterated) とする。 - value が
done ならば、CreateArrayFromList (items) を返す。 - value を items に追加する。
- value を ?
27.1.3.3.13 Iterator.prototype [ %Symbol.iterator% ] ( )
この関数は、呼び出されたとき次の手順を実行する：
this value を返す。
この関数の
27.1.3.3.14 Iterator.prototype [ %Symbol.toStringTag% ]
Iterator.prototype[%Symbol.toStringTag%] は、属性 { [[Enumerable]]:
27.1.3.3.14.1 get Iterator.prototype [ %Symbol.toStringTag% ]
[[Get]] 属性の値は、引数を必要としない built-in 関数である。呼び出されたとき、次の手順を実行する：
"Iterator" を返す。
27.1.3.3.14.2 set Iterator.prototype [ %Symbol.toStringTag% ]
[[Set]] 属性の値は、引数 v を取る built-in 関数である。呼び出されたとき、次の手順を実行する：
- ?
SetterThatIgnoresPrototypeProperties (this value,%Iterator.prototype% ,%Symbol.toStringTag% , v) を実行する。 undefined を返す。
ほとんどの built-in プロトタイプ上の
27.1.4 %AsyncIteratorPrototype% オブジェクト
%AsyncIteratorPrototype% オブジェクト：
- 値が
%Object.prototype% である [[Prototype]] 内部スロットを持つ。 - 通常のオブジェクトである。
この仕様で定義され、
27.1.4.1 %AsyncIteratorPrototype% [ %Symbol.asyncIterator% ] ( )
この関数は、呼び出されたとき次の手順を実行する：
this value を返す。
この関数の
27.1.5 Async-from-Sync Iterator オブジェクト
Async-from-Sync Iterator オブジェクトは、特定の同期
27.1.5.1 CreateAsyncFromSyncIterator ( syncIteratorRecord )
The
- asyncIterator を
OrdinaryObjectCreate (%AsyncFromSyncIteratorPrototype% , « [[SyncIteratorRecord]] ») とする。 - asyncIterator.[[SyncIteratorRecord]] を syncIteratorRecord に設定する。
- nextMethod を !
Get (asyncIterator,"next" ) とする。 - iteratorRecord を
Iterator Record { [[Iterator]]: asyncIterator, [[NextMethod]]: nextMethod, [[Done]]:false } とする。 - iteratorRecord を返す。
27.1.5.2 %AsyncFromSyncIteratorPrototype% オブジェクト
%AsyncFromSyncIteratorPrototype% オブジェクト：
- すべての
Async-from-Sync Iterator オブジェクト によって継承されるプロパティを持つ。 - 通常のオブジェクトである。
- 値が
%AsyncIteratorPrototype% である [[Prototype]] 内部スロットを持つ。 - ECMAScript コードから直接アクセスされることは決してない。
- 次のプロパティを持つ：
27.1.5.2.1 %AsyncFromSyncIteratorPrototype%.next ( [ value ] )
- obj を
this value とする。 Assert : obj は [[SyncIteratorRecord]] 内部スロットを持つ Object である。- promiseCapability を !
NewPromiseCapability (%Promise% ) とする。 - syncIteratorRecord を obj.[[SyncIteratorRecord]] とする。
- value が存在するならば、
- result を
Completion (IteratorNext (syncIteratorRecord, value)) とする。
- result を
- そうでなければ、
- result を
Completion (IteratorNext (syncIteratorRecord)) とする。
- result を
IfAbruptRejectPromise (result, promiseCapability)。AsyncFromSyncIteratorContinuation (result, promiseCapability, syncIteratorRecord,true ) を返す。
27.1.5.2.2 %AsyncFromSyncIteratorPrototype%.return ( [ value ] )
- obj を
this value とする。 Assert : obj は [[SyncIteratorRecord]] 内部スロットを持つ Object である。- promiseCapability を !
NewPromiseCapability (%Promise% ) とする。 - syncIteratorRecord を obj.[[SyncIteratorRecord]] とする。
- syncIterator を syncIteratorRecord.[[Iterator]] とする。
- return を
Completion (GetMethod (syncIterator,"return" )) とする。 IfAbruptRejectPromise (return, promiseCapability)。- return が
undefined ならば、- iteratorResult を
CreateIteratorResultObject (value,true ) とする。 - !
Call (promiseCapability.[[Resolve]],undefined , « iteratorResult ») を実行する。 - promiseCapability.[[Promise]] を返す。
- iteratorResult を
- value が存在するならば、
- result を
Completion (Call (return, syncIterator, « value »)) とする。
- result を
- そうでなければ、
- result を
Completion (Call (return, syncIterator)) とする。
- result を
IfAbruptRejectPromise (result, promiseCapability)。- result が Object でないならば、
- !
Call (promiseCapability.[[Reject]],undefined , « 新しく作成されたTypeError オブジェクト ») を実行する。 - promiseCapability.[[Promise]] を返す。
- !
AsyncFromSyncIteratorContinuation (result, promiseCapability, syncIteratorRecord,false ) を返す。
27.1.5.2.3 %AsyncFromSyncIteratorPrototype%.throw ( [ value ] )
- obj を
this value とする。 Assert : obj は [[SyncIteratorRecord]] 内部スロットを持つ Object である。- promiseCapability を !
NewPromiseCapability (%Promise% ) とする。 - syncIteratorRecord を obj.[[SyncIteratorRecord]] とする。
- syncIterator を syncIteratorRecord.[[Iterator]] とする。
- throw を
Completion (GetMethod (syncIterator,"throw" )) とする。 IfAbruptRejectPromise (throw, promiseCapability)。- throw が
undefined ならば、NOTE : syncIterator がthrowメソッドを持たない場合、capability を拒否する前にクリーンアップする機会を与えるためにそれを閉じる。- closeCompletion を
NormalCompletion (empty ) とする。 - result を
Completion (IteratorClose (syncIteratorRecord, closeCompletion)) とする。 IfAbruptRejectPromise (result, promiseCapability)。NOTE : 次の手順は、プロトコル違反があったこと、すなわち syncIterator がthrowメソッドを持たないことを示すためにTypeError を投げる。NOTE : syncIterator を閉じることが throw しない場合、その操作の結果は、たとえ拒否された promise を生成しても無視される。- !
Call (promiseCapability.[[Reject]],undefined , « 新しく作成されたTypeError オブジェクト ») を実行する。 - 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 , « 新しく作成されたTypeError オブジェクト ») を実行する。 - promiseCapability.[[Promise]] を返す。
- !
AsyncFromSyncIteratorContinuation (result, promiseCapability, syncIteratorRecord,true ) を返す。
27.1.5.3 Async-from-Sync Iterator インスタンスのプロパティ
Async-from-Sync
| 内部スロット | 型 | 説明 |
|---|---|---|
| [[SyncIteratorRecord]] |
|
適応されている元の同期 |
27.1.5.4 AsyncFromSyncIteratorContinuation ( result, promiseCapability, syncIteratorRecord, closeOnRejection )
The
NOTE : promiseCapability は intrinsic%Promise% から導出されるため、以下のIfAbruptRejectPromise の使用によって伴われる promiseCapability.[[Reject]] への呼び出しは throw しないことが保証される。- 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 を、done をキャプチャし、呼び出されたときに次の手順を実行する、パラメータ (v) を持つ新しい
Abstract Closure とする：CreateIteratorResultObject (v, done) を返す。
- onFulfilled を
CreateBuiltinFunction (unwrap, 1,"" , « ») とする。 NOTE : onFulfilled は、IteratorResult オブジェクトの"value" プロパティを処理する際、その値が promise である場合にその値を待機し、その結果を新しい「unwrapped」IteratorResult オブジェクトに再パッケージ化するために使用される。- done が
true または closeOnRejection がfalse ならば、- onRejected を
undefined とする。
- onRejected を
- そうでなければ、
- closeIterator を、syncIteratorRecord をキャプチャし、呼び出されたときに次の手順を実行する、パラメータ (error) を持つ新しい
Abstract Closure とする：- ?
IteratorClose (syncIteratorRecord,ThrowCompletion (error)) を返す。
- ?
- onRejected を
CreateBuiltinFunction (closeIterator, 1,"" , « ») とする。 NOTE : onRejected は、IteratorResult オブジェクトが生成するその"value" プロパティが拒否された promise である場合にIterator を閉じるために使用される。
- closeIterator を、syncIteratorRecord をキャプチャし、呼び出されたときに次の手順を実行する、パラメータ (error) を持つ新しい
PerformPromiseThen (valueWrapper, onFulfilled, onRejected, promiseCapability) を実行する。- promiseCapability.[[Promise]] を返す。
27.2 Promise オブジェクト
Promise は、遅延された（かつ非同期である可能性のある）計算の最終的な結果のプレースホルダーとして使用されるオブジェクトである。
任意の Promise は、相互に排他的な 3 つの状態、すなわち fulfilled、rejected、および pending のいずれかにある：
-
promise
pは、p.then(f, r)が関数fを呼び出すJob をただちにエンキューするならば fulfilled である。 -
promise
pは、p.then(f, r)が関数rを呼び出すJob をただちにエンキューするならば rejected である。 - promise は、fulfilled でも rejected でもないならば pending である。
promise は、pending でない場合、すなわち fulfilled または rejected のいずれかである場合、settled であると言われる。
promise は、settled であるか、または別の promise の状態に一致するように「locked in」されている場合、resolved である。resolved promise を resolve または reject しようとしても効果はない。promise は、resolved でなければ unresolved である。unresolved promise は常に pending 状態にある。resolved promise は pending、fulfilled、または rejected であり得る。
27.2.1 Promise 抽象操作
27.2.1.1 PromiseCapability Record
PromiseCapability Record は、Promise または promise-like オブジェクトを、その promise を resolve または reject できる関数とともにカプセル化するために使用される
PromiseCapability Record は、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Promise]] | Object | promise として使用できるオブジェクト。 |
| [[Resolve]] |
|
与えられた promise を resolve するために使用される関数。 |
| [[Reject]] |
|
与えられた promise を reject するために使用される関数。 |
27.2.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.2.1.2 PromiseReaction Record
PromiseReaction Record は、promise が与えられた値で resolved または rejected になったときにどのように反応すべきかに関する情報を格納するために使用される
PromiseReaction Record は、
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Capability]] |
|
このレコードが reaction handler を提供する promise の capability。 |
| [[Type]] |
|
[[Type]] は、[[Handler]] が |
| [[Handler]] |
|
入力値に適用されるべき関数であり、その戻り値が派生 promise に何が起こるかを支配する。[[Handler]] が |
27.2.1.3 CreateResolvingFunctions ( toResolve )
The
- promiseOrEmpty を
Record { [[Value]]: toResolve } とする。 - resolveSteps を、promiseOrEmpty をキャプチャし、呼び出されたときに次の手順を実行する、パラメータ (resolution) を持つ新しい
Abstract Closure とする：- promiseOrEmpty.[[Value]] が
empty であれば、undefined を返す。 - promise を promiseOrEmpty.[[Value]] とする。
- promiseOrEmpty.[[Value]] を
empty に設定する。 SameValue (resolution, promise) がtrue であれば、- selfResolutionError を新しく作成された
TypeError オブジェクトとする。 RejectPromise (promise, selfResolutionError) を実行する。undefined を返す。
- selfResolutionError を新しく作成された
- resolution が Object でないならば、
FulfillPromise (promise, resolution) を実行する。undefined を返す。
- then を
Completion (Get (resolution,"then" )) とする。 - then が
abrupt completion であるならば、RejectPromise (promise, then.[[Value]]) を実行する。undefined を返す。
- thenAction を then.[[Value]] とする。
IsCallable (thenAction) がfalse であれば、FulfillPromise (promise, resolution) を実行する。undefined を返す。
- thenJobCallback を
HostMakeJobCallback (thenAction) とする。 - job を
NewPromiseResolveThenableJob (promise, resolution, thenJobCallback) とする。 HostEnqueuePromiseJob (job.[[Job]], job.[[Realm]]) を実行する。undefined を返す。
- promiseOrEmpty.[[Value]] が
- resolve を
CreateBuiltinFunction (resolveSteps, 1,"" , « ») とする。 - rejectSteps を、promiseOrEmpty をキャプチャし、呼び出されたときに次の手順を実行する、パラメータ (reason) を持つ新しい
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.2.1.4 FulfillPromise ( promise, value )
The
Assert : promise.[[PromiseState]] はpending である。- reactions を promise.[[PromiseFulfillReactions]] とする。
- promise.[[PromiseResult]] を value に設定する。
- promise.[[PromiseFulfillReactions]] を
undefined に設定する。 - promise.[[PromiseRejectReactions]] を
undefined に設定する。 - promise.[[PromiseState]] を
fulfilled に設定する。 TriggerPromiseReactions (reactions, value) を実行する。unused を返す。
27.2.1.5 NewPromiseCapability ( constructor )
The resolve 関数と reject 関数を抽出しようとする。promise と resolve 関数および reject 関数は、新しい
IsConstructor (constructor) がfalse であれば、TypeError 例外を投げる。NOTE : constructor は、Promise コンストラクターのパラメータ規約をサポートするコンストラクター関数であると想定される（27.2.3.1 を参照）。- resolvingFunctions を
Record { [[Resolve]]:undefined , [[Reject]]:undefined } とする。 - executorClosure を、resolvingFunctions をキャプチャし、呼び出されたときに次の手順を実行する、パラメータ (resolve, reject) を持つ新しい
Abstract Closure とする：- resolvingFunctions.[[Resolve]] が
undefined でないならば、TypeError 例外を投げる。 - resolvingFunctions.[[Reject]] が
undefined でないならば、TypeError 例外を投げる。 - resolvingFunctions.[[Resolve]] を resolve に設定する。
- resolvingFunctions.[[Reject]] を reject に設定する。
NormalCompletion (undefined ) を返す。
- resolvingFunctions.[[Resolve]] が
- executor を
CreateBuiltinFunction (executorClosure, 2,"" , « ») とする。 - promise を ?
Construct (constructor, « executor ») とする。 IsCallable (resolvingFunctions.[[Resolve]]) がfalse であれば、TypeError 例外を投げる。IsCallable (resolvingFunctions.[[Reject]]) がfalse であれば、TypeError 例外を投げる。PromiseCapability Record { [[Promise]]: promise, [[Resolve]]: resolvingFunctions.[[Resolve]], [[Reject]]: resolvingFunctions.[[Reject]] } を返す。
この抽象操作は Promise のサブクラス化をサポートする。これは、渡された executor 関数引数を Promise コンストラクターと同じ方法で呼び出す任意のコンストラクターに対して generic であるためである。Promise コンストラクターの static メソッドを任意のサブクラスへ一般化するために使用される。
27.2.1.6 IsPromise ( value )
The
- value が Object でなければ、
false を返す。 - value が [[PromiseState]] 内部スロットを持たなければ、
false を返す。 true を返す。
27.2.1.7 RejectPromise ( promise, reason )
The
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.2.1.8 TriggerPromiseReactions ( reactions, argument )
The
- reactions の各要素 reaction について、次を行う：
- job を
NewPromiseReactionJob (reaction, argument) とする。 HostEnqueuePromiseJob (job.[[Job]], job.[[Realm]]) を実行する。
- job を
unused を返す。
27.2.1.9 HostPromiseRejectionTracker ( promise, operation )
The
HostPromiseRejectionTracker の既定の実装は、
HostPromiseRejectionTracker は 2 つのシナリオで呼び出される：
- promise が handler なしで rejected になったとき、operation 引数を
"reject" に設定して呼び出される。 - rejected promise に初めて handler が追加されたとき、operation 引数を
"handle" に設定して呼び出される。
HostPromiseRejectionTracker の典型的な実装は、unhandled rejection について開発者に通知しようとしつつ、以前のそのような通知が後から新しい handler の付加によって無効化された場合にも注意深く通知するかもしれない。
operation が
27.2.2 Promise Job
27.2.2.1 NewPromiseReactionJob ( reaction, argument )
The
- job を、reaction と argument をキャプチャし、呼び出されたときに次の手順を実行する、パラメータを持たない新しい
Job Abstract Closure とする：- promiseCapability を reaction.[[Capability]] とする。
- type を reaction.[[Type]] とする。
- handler を reaction.[[Handler]] とする。
- handler が
empty であれば、- type が
fulfill であれば、- handlerResult を
NormalCompletion (argument) とする。
- handlerResult を
- そうでなければ、
Assert : type はreject である。- handlerResult を
ThrowCompletion (argument) とする。
- type が
- そうでなければ、
- handlerResult を
Completion (HostCallJobCallback (handler,undefined , « argument »)) とする。
- 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 を現在の
Realm Record に設定する。 NOTE : handler がundefined でない限り、handlerRealm がnull になることはない。handler が revoked Proxy であり、ECMAScript コードが実行されない場合、handlerRealm はエラーオブジェクトを作成するために使用される。
- getHandlerRealmResult を
Record { [[Job]]: job, [[Realm]]: handlerRealm } を返す。
27.2.2.2 NewPromiseResolveThenableJob ( promiseToResolve, thenable, then )
The
- job を、promiseToResolve、thenable、および then をキャプチャし、呼び出されたときに次の手順を実行する、パラメータを持たない新しい
Job Abstract Closure とする：- resolvingFunctions を
CreateResolvingFunctions (promiseToResolve) とする。 - thenCallResult を
Completion (HostCallJobCallback (then, thenable, « resolvingFunctions.[[Resolve]], resolvingFunctions.[[Reject]] »)) とする。 - thenCallResult が
abrupt completion であるならば、- ?
Call (resolvingFunctions.[[Reject]],undefined , « thenCallResult.[[Value]] ») を返す。
- ?
- ! thenCallResult を返す。
- resolvingFunctions を
- getThenRealmResult を
Completion (GetFunctionRealm (then.[[Callback]])) とする。 - getThenRealmResult が
normal completion であるならば、thenRealm を getThenRealmResult.[[Value]] とする。 - そうでなければ、thenRealm を現在の
Realm Record とする。 NOTE : thenRealm がnull になることはない。then.[[Callback]] が revoked Proxy でありコードが実行されない場合、thenRealm はエラーオブジェクトを作成するために使用される。Record { [[Job]]: job, [[Realm]]: thenRealm } を返す。
27.2.3 Promise コンストラクター
Promise コンストラクター：
- %Promise% である。
グローバルオブジェクト の"Promise" プロパティの初期値である。- コンストラクターとして呼び出されたとき、新しい Promise を作成し初期化する。
- 関数として呼び出されることは意図されておらず、そのように呼び出された場合は例外を投げる。
- クラス定義の
extends節における値として使用してよい。指定された Promise の動作を継承することを意図するサブクラスコンストラクターは、PromiseおよびPromise.prototypeの built-in メソッドをサポートするために必要な内部状態を持つサブクラスインスタンスを作成し初期化するため、Promise コンストラクターへのsuper呼び出しを含まなければならない。
27.2.3.1 Promise ( executor )
この関数は、呼び出されたとき次の手順を実行する：
- NewTarget が
undefined であれば、TypeError 例外を投げる。 IsCallable (executor) がfalse であれば、TypeError 例外を投げる。- promise を ?
OrdinaryCreateFromConstructor (NewTarget,"%Promise.prototype%" , « [[PromiseState]], [[PromiseResult]], [[PromiseFulfillReactions]], [[PromiseRejectReactions]], [[PromiseIsHandled]] ») とする。 - promise.[[PromiseState]] を
pending に設定する。 - promise.[[PromiseResult]] を
empty に設定する。 - promise.[[PromiseFulfillReactions]] を新しい空の
List に設定する。 - promise.[[PromiseRejectReactions]] を新しい空の
List に設定する。 - promise.[[PromiseIsHandled]] を
false に設定する。 - resolvingFunctions を
CreateResolvingFunctions (promise) とする。 - completion を
Completion (Call (executor,undefined , « resolvingFunctions.[[Resolve]], resolvingFunctions.[[Reject]] »)) とする。 - completion が
abrupt completion であるならば、- ?
Call (resolvingFunctions.[[Reject]],undefined , « completion.[[Value]] ») を実行する。
- ?
- promise を返す。
executor 引数は
executor 関数に渡される resolve 関数は単一の引数を受け入れる。executor コードは、関連付けられた Promise を resolve したいことを示すために、最終的に resolve 関数を呼び出してよい。resolve 関数に渡される引数は、遅延動作の最終的な値を表し、実際の fulfillment 値、または fulfilled された場合にその値を提供する別の promise のいずれかであり得る。
executor 関数に渡される reject 関数は単一の引数を受け入れる。executor コードは、関連付けられた Promise が rejected であり、決して fulfilled されないことを示すために、最終的に reject 関数を呼び出してよい。reject 関数に渡される引数は promise の rejection 値として使用される。通常、それは Error オブジェクトである。
Promise コンストラクターによって executor 関数に渡される resolve 関数と reject 関数は、関連付けられた promise を実際に resolve および reject する能力を持つ。サブクラスは、resolve と reject に対してカスタマイズされた値を渡す異なるコンストラクター動作を持ち得る。
27.2.4 Promise コンストラクターのプロパティ
Promise コンストラクター：
- 値が
%Function.prototype% である [[Prototype]] 内部スロットを持つ。 - 次のプロパティを持つ：
27.2.4.1 Promise.all ( iterable )
この関数は、渡された promise の fulfillment 値の配列で fulfilled される新しい promise、または rejected になる最初の渡された promise の理由で rejected される新しい promise を返す。このアルゴリズムを実行する際、渡された
- constructor を
this value とする。 - promiseCapability を ?
NewPromiseCapability (constructor) とする。 - promiseResolve を
Completion (GetPromiseResolve (constructor)) とする。 IfAbruptRejectPromise (promiseResolve, promiseCapability)。- iteratorRecord を
Completion (GetIterator (iterable,sync )) とする。 IfAbruptRejectPromise (iteratorRecord, promiseCapability)。- result を
Completion (PerformPromiseAll (iteratorRecord, constructor, promiseCapability, promiseResolve)) とする。 - result が
abrupt completion であるならば、- iteratorRecord.[[Done]] が
false であれば、result をCompletion (IteratorClose (iteratorRecord, result)) に設定する。 IfAbruptRejectPromise (result, promiseCapability)。
- iteratorRecord.[[Done]] が
- ! result を返す。
この関数は、その
27.2.4.1.1 GetPromiseResolve ( promiseConstructor )
The
- promiseResolve を ?
Get (promiseConstructor,"resolve" ) とする。 IsCallable (promiseResolve) がfalse であれば、TypeError 例外を投げる。- promiseResolve を返す。
27.2.4.1.2 PerformPromiseAll ( iteratorRecord, constructor, resultCapability, promiseResolve )
The
- values を新しい空の
List とする。 NOTE : remainingElementsCount は、入力iterator が尽きる前に渡された callback を呼び出す不正な"then" が存在しても、resultCapability.[[Resolve]] が一度だけ呼び出されることを保証するため、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 に追加する。- nextPromise を ?
Call (promiseResolve, constructor, « next ») とする。 - fulfilledSteps を、values、resultCapability、および remainingElementsCount をキャプチャし、呼び出されたときに次の手順を実行する、パラメータ (value) を持つ新しい
Abstract Closure とする：- activeFunc をアクティブな関数オブジェクトとする。
- activeFunc.[[AlreadyCalled]] が
true であれば、undefined を返す。 - activeFunc.[[AlreadyCalled]] を
true に設定する。 - thisIndex を activeFunc.[[Index]] とする。
- values[thisIndex] を value に設定する。
- remainingElementsCount.[[Value]] を remainingElementsCount.[[Value]] - 1 に設定する。
- remainingElementsCount.[[Value]] = 0 であれば、
- valuesArray を
CreateArrayFromList (values) とする。 - ?
Call (resultCapability.[[Resolve]],undefined , « valuesArray ») を返す。
- valuesArray を
undefined を返す。
- 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.2.4.2 Promise.allSettled ( iterable )
この関数は、元のすべての promise が settled、すなわち fulfilled または rejected のいずれかになった後にのみ、promise 状態の snapshot の配列で fulfilled される promise を返す。このアルゴリズムを実行する際、渡された
- constructor を
this value とする。 - promiseCapability を ?
NewPromiseCapability (constructor) とする。 - promiseResolve を
Completion (GetPromiseResolve (constructor)) とする。 IfAbruptRejectPromise (promiseResolve, promiseCapability)。- iteratorRecord を
Completion (GetIterator (iterable,sync )) とする。 IfAbruptRejectPromise (iteratorRecord, promiseCapability)。- result を
Completion (PerformPromiseAllSettled (iteratorRecord, constructor, promiseCapability, promiseResolve)) とする。 - result が
abrupt completion であるならば、- iteratorRecord.[[Done]] が
false であれば、result をCompletion (IteratorClose (iteratorRecord, result)) に設定する。 IfAbruptRejectPromise (result, promiseCapability)。
- iteratorRecord.[[Done]] が
- ! result を返す。
この関数は、その
27.2.4.2.1 PerformPromiseAllSettled ( iteratorRecord, constructor, resultCapability, promiseResolve )
The
- values を新しい空の
List とする。 NOTE : remainingElementsCount は、入力iterator が尽きる前に渡された callback の一つを呼び出す不正な"then" が存在しても、resultCapability.[[Resolve]] が一度だけ呼び出されることを保証するため、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 に追加する。- nextPromise を ?
Call (promiseResolve, constructor, « next ») とする。 - alreadyCalled を
Record { [[Value]]:false } とする。 - fulfilledSteps を、values、resultCapability、および remainingElementsCount をキャプチャし、呼び出されたときに次の手順を実行する、パラメータ (value) を持つ新しい
Abstract Closure とする：- activeFunc をアクティブな関数オブジェクトとする。
- activeFunc.[[AlreadyCalled]].[[Value]] が
true であれば、undefined を返す。 - activeFunc.[[AlreadyCalled]].[[Value]] を
true に設定する。 - obj を
OrdinaryObjectCreate (%Object.prototype% ) とする。 - !
CreateDataPropertyOrThrow (obj,"status" ,"fulfilled" ) を実行する。 - !
CreateDataPropertyOrThrow (obj,"value" , value) を実行する。 - thisIndex を activeFunc.[[Index]] とする。
- values[thisIndex] を obj に設定する。
- remainingElementsCount.[[Value]] を remainingElementsCount.[[Value]] - 1 に設定する。
- remainingElementsCount.[[Value]] = 0 であれば、
- valuesArray を
CreateArrayFromList (values) とする。 - ?
Call (resultCapability.[[Resolve]],undefined , « valuesArray ») を返す。
- valuesArray を
undefined を返す。
- onFulfilled を
CreateBuiltinFunction (fulfilledSteps, 1,"" , « [[AlreadyCalled]], [[Index]] ») とする。 - onFulfilled.[[AlreadyCalled]] を alreadyCalled に設定する。
- onFulfilled.[[Index]] を index に設定する。
- rejectedSteps を、values、resultCapability、および remainingElementsCount をキャプチャし、呼び出されたときに次の手順を実行する、パラメータ (error) を持つ新しい
Abstract Closure とする：- activeFunc をアクティブな関数オブジェクトとする。
- activeFunc.[[AlreadyCalled]].[[Value]] が
true であれば、undefined を返す。 - activeFunc.[[AlreadyCalled]].[[Value]] を
true に設定する。 - obj を
OrdinaryObjectCreate (%Object.prototype% ) とする。 - !
CreateDataPropertyOrThrow (obj,"status" ,"rejected" ) を実行する。 - !
CreateDataPropertyOrThrow (obj,"reason" , error) を実行する。 - thisIndex を activeFunc.[[Index]] とする。
- values[thisIndex] を obj に設定する。
- remainingElementsCount.[[Value]] を remainingElementsCount.[[Value]] - 1 に設定する。
- remainingElementsCount.[[Value]] = 0 であれば、
- valuesArray を
CreateArrayFromList (values) とする。 - ?
Call (resultCapability.[[Resolve]],undefined , « valuesArray ») を返す。
- valuesArray を
undefined を返す。
- 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.2.4.3 Promise.any ( iterable )
この関数は、与えられた promise のうち最初に fulfilled されたものによって fulfilled される promise、または与えられた promise のすべてが rejected された場合に rejection 理由を保持する AggregateError で rejected される promise を返す。このアルゴリズムを実行する際、渡された
- constructor を
this value とする。 - promiseCapability を ?
NewPromiseCapability (constructor) とする。 - promiseResolve を
Completion (GetPromiseResolve (constructor)) とする。 IfAbruptRejectPromise (promiseResolve, promiseCapability)。- iteratorRecord を
Completion (GetIterator (iterable,sync )) とする。 IfAbruptRejectPromise (iteratorRecord, promiseCapability)。- result を
Completion (PerformPromiseAny (iteratorRecord, constructor, promiseCapability, promiseResolve)) とする。 - result が
abrupt completion であるならば、- iteratorRecord.[[Done]] が
false であれば、result をCompletion (IteratorClose (iteratorRecord, result)) に設定する。 IfAbruptRejectPromise (result, promiseCapability)。
- iteratorRecord.[[Done]] が
- ! result を返す。
この関数は、その Promise コンストラクターのパラメータ規約をサポートするコンストラクター関数であることを要求する。
27.2.4.3.1 PerformPromiseAny ( iteratorRecord, constructor, resultCapability, promiseResolve )
The
- errors を新しい空の
List とする。 NOTE : remainingElementsCount は、入力iterator が尽きる前に渡された callback を呼び出す不正な"then" が存在しても、resultCapability.[[Reject]] が一度だけ呼び出されることを保証するため、0 ではなく 1 から開始する。- remainingElementsCount を
Record { [[Value]]: 1 } とする。 - index を 0 とする。
- 繰り返す：
- next を ?
IteratorStepValue (iteratorRecord) とする。 - next が
done であれば、- remainingElementsCount.[[Value]] を remainingElementsCount.[[Value]] - 1 に設定する。
- remainingElementsCount.[[Value]] = 0 であれば、
- aggregateError を新しく作成された
AggregateError オブジェクトとする。 - !
DefinePropertyOrThrow (aggregateError,"errors" , PropertyDescriptor { [[Configurable]]:true , [[Enumerable]]:false , [[Writable]]:true , [[Value]]:CreateArrayFromList (errors) }) を実行する。 - ?
Call (resultCapability.[[Reject]],undefined , « aggregateError ») を実行する。
- aggregateError を新しく作成された
- resultCapability.[[Promise]] を返す。
undefined を errors に追加する。- nextPromise を ?
Call (promiseResolve, constructor, « next ») とする。 - rejectedSteps を、errors、resultCapability、および remainingElementsCount をキャプチャし、呼び出されたときに次の手順を実行する、パラメータ (error) を持つ新しい
Abstract Closure とする：- activeFunc をアクティブな関数オブジェクトとする。
- activeFunc.[[AlreadyCalled]] が
true であれば、undefined を返す。 - activeFunc.[[AlreadyCalled]] を
true に設定する。 - thisIndex を activeFunc.[[Index]] とする。
- errors[thisIndex] を error に設定する。
- remainingElementsCount.[[Value]] を remainingElementsCount.[[Value]] - 1 に設定する。
- remainingElementsCount.[[Value]] = 0 であれば、
- aggregateError を新しく作成された
AggregateError オブジェクトとする。 - !
DefinePropertyOrThrow (aggregateError,"errors" , PropertyDescriptor { [[Configurable]]:true , [[Enumerable]]:false , [[Writable]]:true , [[Value]]:CreateArrayFromList (errors) }) を実行する。 - ?
Call (resultCapability.[[Reject]],undefined , « aggregateError ») を返す。
- aggregateError を新しく作成された
undefined を返す。
- 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.2.4.4 Promise.prototype
Promise.prototype の初期値は
このプロパティは属性 { [[Writable]]:
27.2.4.5 Promise.race ( iterable )
この関数は、渡された promise のうち最初に settle する promise と同じ方法で settled される新しい promise を返す。このアルゴリズムを実行する際、渡された iterable のすべての要素を promise に resolve する。
- constructor を
this value とする。 - promiseCapability を ?
NewPromiseCapability (constructor) とする。 - promiseResolve を
Completion (GetPromiseResolve (constructor)) とする。 IfAbruptRejectPromise (promiseResolve, promiseCapability)。- iteratorRecord を
Completion (GetIterator (iterable,sync )) とする。 IfAbruptRejectPromise (iteratorRecord, promiseCapability)。- result を
Completion (PerformPromiseRace (iteratorRecord, constructor, promiseCapability, promiseResolve)) とする。 - result が
abrupt completion であるならば、- iteratorRecord.[[Done]] が
false であれば、result をCompletion (IteratorClose (iteratorRecord, result)) に設定する。 IfAbruptRejectPromise (result, promiseCapability)。
- iteratorRecord.[[Done]] が
- ! result を返す。
iterable 引数が値を生成しない場合、または iterable によって生成された promise のいずれも決して settle しない場合、このメソッドによって返される pending promise は決して settled にならない。
この関数は、その resolve メソッドを提供することも期待する。
27.2.4.5.1 PerformPromiseRace ( iteratorRecord, constructor, resultCapability, promiseResolve )
The
- 繰り返す：
- next を ?
IteratorStepValue (iteratorRecord) とする。 - next が
done であれば、- resultCapability.[[Promise]] を返す。
- nextPromise を ?
Call (promiseResolve, constructor, « next ») とする。 - ?
Invoke (nextPromise,"then" , « resultCapability.[[Resolve]], resultCapability.[[Reject]] ») を実行する。
- next を ?
27.2.4.6 Promise.reject ( reason )
この関数は、渡された引数で rejected された新しい promise を返す。
- constructor を
this value とする。 - promiseCapability を ?
NewPromiseCapability (constructor) とする。 - ?
Call (promiseCapability.[[Reject]],undefined , « reason ») を実行する。 - promiseCapability.[[Promise]] を返す。
この関数は、その
27.2.4.7 Promise.resolve ( resolution )
この関数は、渡された引数で resolved された新しい promise、または引数がこのコンストラクターによって生成された promise である場合はその引数自体を返す。
- constructor を
this value とする。 - constructor が Object でなければ、
TypeError 例外を投げる。 - ?
PromiseResolve (constructor, resolution) を返す。
この関数は、その
27.2.4.7.1 PromiseResolve ( constructor, resolution )
The
IsPromise (resolution) がtrue であれば、- promiseCapability を ?
NewPromiseCapability (constructor) とする。 - ?
Call (promiseCapability.[[Resolve]],undefined , « resolution ») を実行する。 - promiseCapability.[[Promise]] を返す。
27.2.4.8 Promise.try ( callback, ...args )
この関数は、呼び出されたとき次の手順を実行する：
- constructor を
this value とする。 - constructor が Object でなければ、
TypeError 例外を投げる。 - promiseCapability を ?
NewPromiseCapability (constructor) とする。 - status を
Completion (Call (callback,undefined , args)) とする。 - status が
abrupt completion であるならば、- ?
Call (promiseCapability.[[Reject]],undefined , « status.[[Value]] ») を実行する。
- ?
- そうでなければ、
- ?
Call (promiseCapability.[[Resolve]],undefined , « status.[[Value]] ») を実行する。
- ?
- promiseCapability.[[Promise]] を返す。
この関数は、その
27.2.4.9 Promise.withResolvers ( )
この関数は、新しい promise と、それに関連付けられた resolve 関数および reject 関数を合わせた 3 つのプロパティを持つオブジェクトを返す。
- constructor を
this value とする。 - promiseCapability を ?
NewPromiseCapability (constructor) とする。 - obj を
OrdinaryObjectCreate (%Object.prototype% ) とする。 - !
CreateDataPropertyOrThrow (obj,"promise" , promiseCapability.[[Promise]]) を実行する。 - !
CreateDataPropertyOrThrow (obj,"resolve" , promiseCapability.[[Resolve]]) を実行する。 - !
CreateDataPropertyOrThrow (obj,"reject" , promiseCapability.[[Reject]]) を実行する。 - obj を返す。
27.2.4.10 get Promise [ %Symbol.species% ]
Promise[%Symbol.species%] は set accessor 関数が
this value を返す。
この関数の
Promise プロトタイプメソッドは通常、派生オブジェクトを作成するために、その
27.2.5 Promise プロトタイプオブジェクトのプロパティ
Promise プロトタイプオブジェクト：
- %Promise.prototype% である。
- 値が
%Object.prototype% である [[Prototype]] 内部スロットを持つ。 - 通常のオブジェクトである。
- [[PromiseState]] 内部スロット、または Promise インスタンスのその他の内部スロットを持たない。
27.2.5.1 Promise.prototype.catch ( onRejected )
このメソッドは、呼び出されたとき次の手順を実行する：
- promise を
this value とする。 - ?
Invoke (promise,"then" , «undefined , onRejected ») を返す。
27.2.5.2 Promise.prototype.constructor
Promise.prototype.constructor の初期値は
27.2.5.3 Promise.prototype.finally ( onFinally )
このメソッドは、呼び出されたとき次の手順を実行する：
- promise を
this value とする。 - promise が Object でなければ、
TypeError 例外を投げる。 - constructor を ?
SpeciesConstructor (promise,%Promise% ) とする。 Assert :IsConstructor (constructor) はtrue である。IsCallable (onFinally) がfalse であれば、- thenFinally を onFinally とする。
- catchFinally を onFinally とする。
- そうでなければ、
- thenFinallyClosure を、onFinally と constructor をキャプチャし、呼び出されたときに次の手順を実行する、パラメータ (value) を持つ新しい
Abstract Closure とする：- result を ?
Call (onFinally,undefined ) とする。 - p を ?
PromiseResolve (constructor, result) とする。 - returnValue を、value をキャプチャし、呼び出されたときに次の手順を実行する、パラメータを持たない新しい
Abstract Closure とする：NormalCompletion (value) を返す。
- valueThunk を
CreateBuiltinFunction (returnValue, 0,"" , « ») とする。 - ?
Invoke (p,"then" , « valueThunk ») を返す。
- result を ?
- thenFinally を
CreateBuiltinFunction (thenFinallyClosure, 1,"" , « ») とする。 - catchFinallyClosure を、onFinally と constructor をキャプチャし、呼び出されたときに次の手順を実行する、パラメータ (reason) を持つ新しい
Abstract Closure とする：- result を ?
Call (onFinally,undefined ) とする。 - p を ?
PromiseResolve (constructor, result) とする。 - throwReason を、reason をキャプチャし、呼び出されたときに次の手順を実行する、パラメータを持たない新しい
Abstract Closure とする：- reason を投げる。
- thrower を
CreateBuiltinFunction (throwReason, 0,"" , « ») とする。 - ?
Invoke (p,"then" , « thrower ») を返す。
- result を ?
- catchFinally を
CreateBuiltinFunction (catchFinallyClosure, 1,"" , « ») とする。
- thenFinallyClosure を、onFinally と constructor をキャプチャし、呼び出されたときに次の手順を実行する、パラメータ (value) を持つ新しい
- ?
Invoke (promise,"then" , « thenFinally, catchFinally ») を返す。
27.2.5.4 Promise.prototype.then ( onFulfilled, onRejected )
このメソッドは、呼び出されたとき次の手順を実行する：
- promise を
this value とする。 IsPromise (promise) がfalse であれば、TypeError 例外を投げる。- constructor を ?
SpeciesConstructor (promise,%Promise% ) とする。 - resultCapability を ?
NewPromiseCapability (constructor) とする。 PerformPromiseThen (promise, onFulfilled, onRejected, resultCapability) を返す。
27.2.5.4.1 PerformPromiseThen ( promise, onFulfilled, onRejected [ , resultCapability ] )
The
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]] に追加する。
- rejectReaction を promise.[[PromiseRejectReactions]] に追加する。
- そうではなく 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.2.5.5 Promise.prototype [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
27.2.6 Promise インスタンスのプロパティ
Promise インスタンスは、
| 内部スロット | 型 | 説明 |
|---|---|---|
| [[PromiseState]] |
|
promise がその then メソッドへの入力呼び出しにどのように反応するかを支配する。
|
| [[PromiseResult]] |
|
promise が fulfilled または rejected された値（存在する場合）。[[PromiseState]] が |
| [[PromiseFulfillReactions]] |
|
promise が |
| [[PromiseRejectReactions]] |
|
promise が |
| [[PromiseIsHandled]] | Boolean | promise が fulfillment または rejection handler をこれまでに持ったことがあるかどうかを示す。unhandled rejection tracking で使用される。 |
27.3 GeneratorFunction オブジェクト
GeneratorFunction は、通常
27.3.1 GeneratorFunction コンストラクター
GeneratorFunction コンストラクター：
- %GeneratorFunction% である。
Functionのサブクラスである。- コンストラクターとしてではなく関数として呼び出されたとき、新しい GeneratorFunction を作成し初期化する。したがって、関数呼び出し
GeneratorFunction (…)は、同じ引数を持つオブジェクト作成式new GeneratorFunction (…)と等価である。 - クラス定義の
extends節の値として使用してよい。指定された GeneratorFunction の動作を継承することを意図するサブクラスコンストラクターは、built-in GeneratorFunction の動作に必要な内部スロットを持つサブクラスインスタンスを作成し初期化するため、GeneratorFunction コンストラクターへのsuper呼び出しを含まなければならない。generator function オブジェクトを定義するすべての ECMAScript 構文形式は、GeneratorFunction の直接インスタンスを作成する。GeneratorFunction サブクラスのインスタンスを作成する構文上の手段は存在しない。
27.3.1.1 GeneratorFunction ( ...parameterArgs, bodyArg )
最後の引数（存在する場合）は generator function の本体（実行可能コード）を指定し、それより前の任意の引数は仮引数を指定する。
この関数は、呼び出されたとき次の手順を実行する：
- activeFunc をアクティブな関数オブジェクトとする。
- bodyArg が存在しないならば、bodyArg を空の String に設定する。
- ?
CreateDynamicFunction (activeFunc, NewTarget,generator , parameterArgs, bodyArg) を返す。
27.3.2 GeneratorFunction コンストラクターのプロパティ
GeneratorFunction コンストラクター：
- Function コンストラクターから継承する標準 built-in 関数オブジェクトである。
- 値が
%Function% である [[Prototype]] 内部スロットを持つ。 - 値が
1 𝔽 である"length" プロパティを持つ。 - 値が
"GeneratorFunction" である"name" プロパティを持つ。 - 次のプロパティを持つ：
27.3.2.1 GeneratorFunction.prototype
GeneratorFunction.prototype の初期値は
このプロパティは属性 { [[Writable]]:
27.3.3 GeneratorFunction プロトタイプオブジェクトのプロパティ
GeneratorFunction プロトタイプオブジェクト：
- %GeneratorFunction.prototype% である（
Figure 6 を参照）。 - 通常のオブジェクトである。
- 関数オブジェクトではなく、[[ECMAScriptCode]] 内部スロット、または
Table 25 もしくはTable 89 に列挙されるその他の内部スロットを持たない。 - 値が
%Function.prototype% である [[Prototype]] 内部スロットを持つ。
27.3.3.1 GeneratorFunction.prototype.constructor
GeneratorFunction.prototype.constructor の初期値は
このプロパティは属性 { [[Writable]]:
27.3.3.2 GeneratorFunction.prototype.prototype
GeneratorFunction.prototype.prototype の初期値は
このプロパティは属性 { [[Writable]]:
27.3.3.3 GeneratorFunction.prototype [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
27.3.4 GeneratorFunction インスタンス
すべての GeneratorFunction インスタンスは ECMAScript 関数オブジェクトであり、
各 GeneratorFunction インスタンスは、次の own プロパティを持つ：
27.3.4.1 length
27.3.4.2 name
27.3.4.3 prototype
GeneratorFunction インスタンスが作成されるたびに、別の通常のオブジェクトも作成され、それが generator function の
このプロパティは属性 { [[Writable]]:
Function インスタンスとは異なり、GeneratorFunction の
27.4 AsyncGeneratorFunction オブジェクト
AsyncGeneratorFunction は、通常
27.4.1 AsyncGeneratorFunction コンストラクター
AsyncGeneratorFunction コンストラクター：
- %AsyncGeneratorFunction% である。
Functionのサブクラスである。- コンストラクターとしてではなく関数として呼び出されたとき、新しい AsyncGeneratorFunction を作成し初期化する。したがって、関数呼び出し
AsyncGeneratorFunction (...)は、同じ引数を持つオブジェクト作成式new AsyncGeneratorFunction (...)と等価である。 - クラス定義の
extends節の値として使用してよい。指定された AsyncGeneratorFunction の動作を継承することを意図するサブクラスコンストラクターは、built-in AsyncGeneratorFunction の動作に必要な内部スロットを持つサブクラスインスタンスを作成し初期化するため、AsyncGeneratorFunction コンストラクターへのsuper呼び出しを含まなければならない。async generator function オブジェクトを定義するすべての ECMAScript 構文形式は、AsyncGeneratorFunction の直接インスタンスを作成する。AsyncGeneratorFunction サブクラスのインスタンスを作成する構文上の手段は存在しない。
27.4.1.1 AsyncGeneratorFunction ( ...parameterArgs, bodyArg )
最後の引数（存在する場合）は async generator function の本体（実行可能コード）を指定し、それより前の任意の引数は仮引数を指定する。
この関数は、呼び出されたとき次の手順を実行する：
- activeFunc をアクティブな関数オブジェクトとする。
- bodyArg が存在しないならば、bodyArg を空の String に設定する。
- ?
CreateDynamicFunction (activeFunc, NewTarget,async-generator , parameterArgs, bodyArg) を返す。
27.4.2 AsyncGeneratorFunction コンストラクターのプロパティ
AsyncGeneratorFunction コンストラクター：
- Function コンストラクターから継承する標準 built-in 関数オブジェクトである。
- 値が
%Function% である [[Prototype]] 内部スロットを持つ。 - 値が
1 𝔽 である"length" プロパティを持つ。 - 値が
"AsyncGeneratorFunction" である"name" プロパティを持つ。 - 次のプロパティを持つ：
27.4.2.1 AsyncGeneratorFunction.prototype
AsyncGeneratorFunction.prototype の初期値は
このプロパティは属性 { [[Writable]]:
27.4.3 AsyncGeneratorFunction プロトタイプオブジェクトのプロパティ
AsyncGeneratorFunction プロトタイプオブジェクト：
- %AsyncGeneratorFunction.prototype% である。
- 通常のオブジェクトである。
- 関数オブジェクトではなく、[[ECMAScriptCode]] 内部スロット、または
Table 25 もしくはTable 90 に列挙されるその他の内部スロットを持たない。 - 値が
%Function.prototype% である [[Prototype]] 内部スロットを持つ。
27.4.3.1 AsyncGeneratorFunction.prototype.constructor
AsyncGeneratorFunction.prototype.constructor の初期値は
このプロパティは属性 { [[Writable]]:
27.4.3.2 AsyncGeneratorFunction.prototype.prototype
AsyncGeneratorFunction.prototype.prototype の初期値は
このプロパティは属性 { [[Writable]]:
27.4.3.3 AsyncGeneratorFunction.prototype [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
27.4.4 AsyncGeneratorFunction インスタンス
すべての AsyncGeneratorFunction インスタンスは ECMAScript 関数オブジェクトであり、
各 AsyncGeneratorFunction インスタンスは、次の own プロパティを持つ：
27.4.4.1 length
このプロパティは属性 { [[Writable]]:
27.4.4.2 name
27.4.4.3 prototype
AsyncGeneratorFunction インスタンスが作成されるたびに、別の通常のオブジェクトも作成され、それが async generator function の
このプロパティは属性 { [[Writable]]:
function インスタンスとは異なり、AsyncGeneratorFunction の
27.5 Generator オブジェクト
Generator は generator function を呼び出すことによって作成され、
Generator インスタンスは、そのインスタンスを作成した generator function の
27.5.1 %GeneratorPrototype% オブジェクト
%GeneratorPrototype% オブジェクト：
- %GeneratorFunction.prototype.prototype% である。
- 通常のオブジェクトである。
- Generator インスタンスではなく、[[GeneratorState]] 内部スロットを持たない。
- 値が
%Iterator.prototype% である [[Prototype]] 内部スロットを持つ。 - すべての Generator インスタンスによって間接的に継承されるプロパティを持つ。
27.5.1.1 %GeneratorPrototype%.constructor
.constructor の初期値は
このプロパティは属性 { [[Writable]]:
27.5.1.2 %GeneratorPrototype%.next ( value )
- ?
GeneratorResume (this value, value,empty ) を返す。
27.5.1.3 %GeneratorPrototype%.return ( value )
このメソッドは、呼び出されたとき次の手順を実行する：
- generator を
this value とする。 - completion を
ReturnCompletion (value) とする。 - ?
GeneratorResumeAbrupt (generator, completion,empty ) を返す。
27.5.1.4 %GeneratorPrototype%.throw ( exception )
このメソッドは、呼び出されたとき次の手順を実行する：
- generator を
this value とする。 - completion を
ThrowCompletion (exception) とする。 - ?
GeneratorResumeAbrupt (generator, completion,empty ) を返す。
27.5.1.5 %GeneratorPrototype% [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
27.5.2 Generator インスタンスのプロパティ
Generator インスタンスは、
| 内部スロット | 型 | 説明 |
|---|---|---|
| [[GeneratorState]] |
|
generator の現在の実行状態。 |
| [[GeneratorContext]] |
|
この generator のコードを実行するときに使用される実行コンテキスト。 |
| [[GeneratorBrand]] |
String または |
異なる種類の generator を区別するために使用される brand。 |
27.5.3 Generator 抽象操作
27.5.3.1 GeneratorStart ( generator, generatorBody )
The
Assert : generator.[[GeneratorState]] はsuspended-start である。- genContext を実行中の実行コンテキストとする。
- genContext の Generator コンポーネントを generator に設定する。
- closure を、generatorBody をキャプチャし、呼び出されたときに次の手順を実行する、パラメータを持たない新しい
Abstract Closure とする：- acGenContext を実行中の実行コンテキストとする。
- acGenerator を acGenContext の Generator コンポーネントとする。
- generatorBody が
Parse Node であるならば、- result を generatorBody の
Evaluation のCompletion とする。
- result を generatorBody の
- そうでなければ、
Assert : generatorBody はパラメータを持たないAbstract Closure である。- result を
Completion (generatorBody()) とする。
Assert : ここに戻ってきたならば、generator は例外を投げたか、暗黙的または明示的な return のいずれかを実行した。- acGenContext を実行コンテキストスタックから取り除き、実行コンテキストスタックの最上位にある実行コンテキストを実行中の実行コンテキストとして復元する。
- acGenerator.[[GeneratorState]] を
completed に設定する。 NOTE : generator がcompleted 状態に入ると、それは二度とその状態を離れず、関連付けられた実行コンテキストは二度と再開されない。この時点で、acGenerator に関連付けられた任意の実行状態は破棄できる。- result が
normal completion であるならば、- resultValue を
undefined とする。
- resultValue を
- そうではなく result が
return completion であるならば、- resultValue を result.[[Value]] とする。
- そうでなければ、
Assert : result はthrow completion である。- ? result を返す。
NormalCompletion (CreateIteratorResultObject (resultValue,true )) を返す。
- genContext のコード評価状態を、その実行コンテキストについて評価が再開されたときに、closure が引数なしで呼び出されるように設定する。
- generator.[[GeneratorContext]] を genContext に設定する。
unused を返す。
27.5.3.2 GeneratorValidate ( generator, generatorBrand )
The
- ?
RequireInternalSlot (generator, [[GeneratorState]]) を実行する。 - ?
RequireInternalSlot (generator, [[GeneratorBrand]]) を実行する。 - generator.[[GeneratorBrand]] が generatorBrand でないならば、
TypeError 例外を投げる。 Assert : generator は [[GeneratorContext]] 内部スロットを持つ。- state を generator.[[GeneratorState]] とする。
- state が
executing であるならば、TypeError 例外を投げる。 - state を返す。
27.5.3.3 GeneratorResume ( generator, value, generatorBrand )
The
- state を ?
GeneratorValidate (generator, generatorBrand) とする。 - state が
completed である場合、CreateIteratorResultObject (undefined ,true ) を返す。 Assert : state はsuspended-start またはsuspended-yield のいずれかである。- genContext を generator.[[GeneratorContext]] とする。
- generator.[[GeneratorState]] を
executing に設定する。 - ?
RunSuspendedContext (genContext,NormalCompletion (value)) を返す。
27.5.3.4 GeneratorResumeAbrupt ( generator, abruptCompletion, generatorBrand )
The
- state を ?
GeneratorValidate (generator, generatorBrand) とする。 - state が
suspended-start である場合、- generator.[[GeneratorState]] を
completed に設定する。 NOTE : ジェネレーターはいったんcompleted 状態に入ると、そこから離れることはなく、それに関連付けられた実行コンテキストが再開されることもない。この時点で、generator に関連付けられた任意の実行状態を破棄できる。- state を
completed に設定する。
- generator.[[GeneratorState]] を
- state が
completed である場合、- abruptCompletion が return 完了である場合、
CreateIteratorResultObject (abruptCompletion.[[Value]],true ) を返す。
- ? abruptCompletion を返す。
- abruptCompletion が return 完了である場合、
Assert : state はsuspended-yield である。- genContext を generator.[[GeneratorContext]] とする。
- generator.[[GeneratorState]] を
executing に設定する。 - ?
RunSuspendedContext (genContext, abruptCompletion) を返す。
27.5.3.5 GetGeneratorKind ( )
The
- genContext を実行中の実行コンテキストとする。
- genContext が Generator コンポーネントを持たないならば、
non-generator を返す。 - generator を genContext の Generator コンポーネントとする。
- generator が [[AsyncGeneratorState]] 内部スロットを持つならば、
async を返す。 sync を返す。
27.5.3.6 GeneratorYield ( iteratorResult )
The
- genContext を実行中の実行コンテキストとする。
Assert : genContext は generator の実行コンテキストである。- generator を genContext の Generator コンポーネントの値とする。
Assert :GetGeneratorKind () はsync である。- generator.[[GeneratorState]] を
suspended-yield に設定する。 - genContext を実行コンテキストスタックから取り除き、実行コンテキストスタックの最上位にある実行コンテキストを実行中の実行コンテキストとして復元する。
- callerContext を実行中の実行コンテキストとする。
NormalCompletion (iteratorResult) を渡して callerContext を再開する。genContext が再び再開された場合、resumptionValue をそれが再開されたCompletion Record とする。Assert : ここに制御が到達したならば、genContext は再び実行中の実行コンテキストである。- resumptionValue を返す。
27.5.3.7 Yield ( value )
The
- generatorKind を
GetGeneratorKind () とする。 - generatorKind が
async であるならば、?AsyncGeneratorYield (?Await (value)) を返す。 - ?
GeneratorYield (CreateIteratorResultObject (value,false )) を返す。
27.5.3.8 CreateIteratorFromClosure ( closure, generatorBrand, generatorPrototype [ , extraSlots ] )
The
NOTE : closure は、IteratorResult オブジェクトを yield するためにYield 操作の使用を含むことができる。- extraSlots が存在しないならば、extraSlots を新しい空の
List に設定する。 - internalSlotsList を extraSlots と « [[GeneratorState]], [[GeneratorContext]], [[GeneratorBrand]] » のリスト連結とする。
- generator を
OrdinaryObjectCreate (generatorPrototype, internalSlotsList) とする。 - generator.[[GeneratorBrand]] を generatorBrand に設定する。
- generator.[[GeneratorState]] を
suspended-start に設定する。 - callerContext を実行中の実行コンテキストとする。
- calleeContext を新しい実行コンテキストとする。
- calleeContext の Function を
null に設定する。 - calleeContext の
Realm を現在のRealm Record に設定する。 - calleeContext の ScriptOrModule を callerContext の ScriptOrModule に設定する。
- callerContext がまだ suspended でないならば、callerContext を suspend する。
- calleeContext を実行コンテキストスタックに push する。calleeContext はここで実行中の実行コンテキストとなる。
GeneratorStart (generator, closure) を実行する。- calleeContext を実行コンテキストスタックから取り除き、callerContext を実行中の実行コンテキストとして復元する。
- generator を返す。
27.6 AsyncGenerator オブジェクト
AsyncGenerator は async generator function を呼び出すことによって作成され、
AsyncGenerator インスタンスは、そのインスタンスを作成した async generator function の
27.6.1 %AsyncGeneratorPrototype% オブジェクト
%AsyncGeneratorPrototype% オブジェクト：
- %AsyncGeneratorFunction.prototype.prototype% である。
- 通常のオブジェクトである。
- AsyncGenerator インスタンスではなく、[[AsyncGeneratorState]] 内部スロットを持たない。
- 値が
%AsyncIteratorPrototype% である [[Prototype]] 内部スロットを持つ。 - すべての AsyncGenerator インスタンスによって間接的に継承されるプロパティを持つ。
27.6.1.1 %AsyncGeneratorPrototype%.constructor
.constructor の初期値は
このプロパティは属性 { [[Writable]]:
27.6.1.2 %AsyncGeneratorPrototype%.next ( value )
- generator を
this value とする。 - promiseCapability を !
NewPromiseCapability (%Promise% ) とする。 - result を
Completion (AsyncGeneratorValidate (generator,empty )) とする。 IfAbruptRejectPromise (result, promiseCapability)。- state を generator.[[AsyncGeneratorState]] とする。
- state が
completed であるならば、- iteratorResult を
CreateIteratorResultObject (undefined ,true ) とする。 - !
Call (promiseCapability.[[Resolve]],undefined , « iteratorResult ») を実行する。 - promiseCapability.[[Promise]] を返す。
- iteratorResult を
- completion を
NormalCompletion (value) とする。 AsyncGeneratorEnqueue (generator, completion, promiseCapability) を実行する。- state が
suspended-start またはsuspended-yield のいずれかであるならば、AsyncGeneratorResume (generator, completion) を実行する。
- そうでなければ、
Assert : state はexecuting またはdraining-queue のいずれかである。
- promiseCapability.[[Promise]] を返す。
27.6.1.3 %AsyncGeneratorPrototype%.return ( value )
- generator を
this value とする。 - promiseCapability を !
NewPromiseCapability (%Promise% ) とする。 - result を
Completion (AsyncGeneratorValidate (generator,empty )) とする。 IfAbruptRejectPromise (result, promiseCapability)。- completion を
ReturnCompletion (value) とする。 AsyncGeneratorEnqueue (generator, completion, promiseCapability) を実行する。- state を generator.[[AsyncGeneratorState]] とする。
- state が
suspended-start またはcompleted のいずれかであるならば、- generator.[[AsyncGeneratorState]] を
draining-queue に設定する。 AsyncGeneratorAwaitReturn (generator) を実行する。
- generator.[[AsyncGeneratorState]] を
- そうではなく state が
suspended-yield であるならば、AsyncGeneratorResume (generator, completion) を実行する。
- そうでなければ、
Assert : state はexecuting またはdraining-queue のいずれかである。
- promiseCapability.[[Promise]] を返す。
27.6.1.4 %AsyncGeneratorPrototype%.throw ( exception )
- generator を
this value とする。 - promiseCapability を !
NewPromiseCapability (%Promise% ) とする。 - result を
Completion (AsyncGeneratorValidate (generator,empty )) とする。 IfAbruptRejectPromise (result, promiseCapability)。- state を generator.[[AsyncGeneratorState]] とする。
- state が
suspended-start であるならば、- generator.[[AsyncGeneratorState]] を
completed に設定する。 - state を
completed に設定する。
- generator.[[AsyncGeneratorState]] を
- state が
completed であるならば、- !
Call (promiseCapability.[[Reject]],undefined , « exception ») を実行する。 - promiseCapability.[[Promise]] を返す。
- !
- completion を
ThrowCompletion (exception) とする。 AsyncGeneratorEnqueue (generator, completion, promiseCapability) を実行する。- state が
suspended-yield であるならば、AsyncGeneratorResume (generator, completion) を実行する。
- そうでなければ、
Assert : state はexecuting またはdraining-queue のいずれかである。
- promiseCapability.[[Promise]] を返す。
27.6.1.5 %AsyncGeneratorPrototype% [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
27.6.2 AsyncGenerator インスタンスのプロパティ
AsyncGenerator インスタンスは、以下に記述される内部スロットを持って最初に作成される：
| 内部スロット | 型 | 説明 |
|---|---|---|
| [[AsyncGeneratorState]] | async generator の現在の実行状態。 | |
| [[AsyncGeneratorContext]] | この async generator のコードを実行するときに使用される実行コンテキスト。 | |
| [[AsyncGeneratorQueue]] | async generator を再開する要求を表す |
|
| [[GeneratorBrand]] | String または |
異なる種類の async generator を区別するために使用される brand。 |
27.6.3 AsyncGenerator 抽象操作
27.6.3.1 AsyncGeneratorRequest Record
AsyncGeneratorRequest は、async generator がどのように再開されるべきかについての情報を格納するために使用され、対応する promise を fulfill または reject するための capability を含む
これは次のフィールドを持つ：
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Completion]] | async generator を再開するために使用されるべき |
|
| [[Capability]] | この要求に関連付けられた promise capability。 |
27.6.3.2 AsyncGeneratorStart ( generator, generatorBody )
The
Assert : generator.[[AsyncGeneratorState]] はsuspended-start である。- genContext を実行中の実行コンテキストとする。
- genContext の Generator コンポーネントを generator に設定する。
- closure を、generatorBody をキャプチャし、呼び出されたときに次の手順を実行する、パラメータを持たない新しい
Abstract Closure とする：- acGenContext を実行中の実行コンテキストとする。
- acGenerator を acGenContext の Generator コンポーネントとする。
- generatorBody が
Parse Node であるならば、- result を generatorBody の
Evaluation のCompletion とする。
- result を generatorBody の
- そうでなければ、
Assert : generatorBody はパラメータを持たないAbstract Closure である。- result を
Completion (generatorBody()) とする。
Assert : ここに戻ってきたならば、async generator は例外を投げたか、暗黙的または明示的な return のいずれかを実行した。- acGenContext を実行コンテキストスタックから取り除き、実行コンテキストスタックの最上位にある実行コンテキストを実行中の実行コンテキストとして復元する。
- acGenerator.[[AsyncGeneratorState]] を
draining-queue に設定する。 - result が
normal completion であるならば、result をNormalCompletion (undefined ) に設定する。 - result が
return completion であるならば、result をNormalCompletion (result.[[Value]]) に設定する。 AsyncGeneratorCompleteStep (acGenerator, result,true ) を実行する。AsyncGeneratorDrainQueue (acGenerator) を実行する。NormalCompletion (undefined ) を返す。
- genContext のコード評価状態を、その実行コンテキストについて評価が再開されたときに、closure が引数なしで呼び出されるように設定する。
- generator.[[AsyncGeneratorContext]] を genContext に設定する。
- generator.[[AsyncGeneratorQueue]] を新しい空の
List に設定する。 unused を返す。
27.6.3.3 AsyncGeneratorValidate ( generator, generatorBrand )
The
- ?
RequireInternalSlot (generator, [[AsyncGeneratorContext]]) を実行する。 - ?
RequireInternalSlot (generator, [[AsyncGeneratorState]]) を実行する。 - ?
RequireInternalSlot (generator, [[AsyncGeneratorQueue]]) を実行する。 - generator.[[GeneratorBrand]] が generatorBrand でないならば、
TypeError 例外を投げる。 unused を返す。
27.6.3.4 AsyncGeneratorEnqueue ( generator, completion, promiseCapability )
The
- request を
AsyncGeneratorRequest { [[Completion]]: completion, [[Capability]]: promiseCapability } とする。 - request を generator.[[AsyncGeneratorQueue]] に追加する。
unused を返す。
27.6.3.5 AsyncGeneratorCompleteStep ( generator, completion, done [ , realm ] )
The
Assert : generator.[[AsyncGeneratorQueue]] は空でない。- next を generator.[[AsyncGeneratorQueue]] の最初の要素とする。
- 最初の要素を generator.[[AsyncGeneratorQueue]] から取り除く。
- promiseCapability を next.[[Capability]] とする。
- value を completion.[[Value]] とする。
- completion が
throw completion であるならば、- !
Call (promiseCapability.[[Reject]],undefined , « value ») を実行する。
- !
- そうでなければ、
Assert : completion はnormal completion である。- realm が存在するならば、
- oldRealm を実行中の実行コンテキストの
Realm とする。 - 実行中の実行コンテキストの
Realm を realm に設定する。 - iteratorResult を
CreateIteratorResultObject (value, done) とする。 - 実行中の実行コンテキストの
Realm を oldRealm に設定する。
- oldRealm を実行中の実行コンテキストの
- そうでなければ、
- iteratorResult を
CreateIteratorResultObject (value, done) とする。
- iteratorResult を
- !
Call (promiseCapability.[[Resolve]],undefined , « iteratorResult ») を実行する。
unused を返す。
27.6.3.6 AsyncGeneratorResume ( generator, completion )
The
Assert : generator.[[AsyncGeneratorState]] はsuspended-start またはsuspended-yield のいずれかである。- genContext を generator.[[AsyncGeneratorContext]] とする。
- generator.[[AsyncGeneratorState]] を
executing に設定する。 - !
RunSuspendedContext (genContext, completion) を実行する。 unused を返す。
27.6.3.7 AsyncGeneratorUnwrapYieldResumption ( resumptionValue )
The
- resumptionValue が
return completion でないならば、? resumptionValue を返す。 - awaited を
Completion (Await (resumptionValue.[[Value]])) とする。 - awaited が
throw completion であるならば、? awaited を返す。 Assert : awaited はnormal completion である。ReturnCompletion (awaited.[[Value]]) を返す。
27.6.3.8 AsyncGeneratorYield ( value )
The
- genContext を実行中の実行コンテキストとする。
Assert : genContext は generator の実行コンテキストである。- generator を genContext の Generator コンポーネントの値とする。
Assert :GetGeneratorKind () はasync である。- completion を
NormalCompletion (value) とする。 Assert : 実行コンテキストスタックは少なくとも 2 つの要素を持つ。- previousContext を実行コンテキストスタックの上から 2 番目の要素とする。
- previousRealm を previousContext の
Realm とする。 AsyncGeneratorCompleteStep (generator, completion,false , previousRealm) を実行する。- queue を generator.[[AsyncGeneratorQueue]] とする。
- queue が空でないならば、
NOTE : 実行は generator を suspend せずに継続する。- toYield を queue の最初の要素とする。
- resumptionValue を
Completion (toYield.[[Completion]]) とする。 - ?
AsyncGeneratorUnwrapYieldResumption (resumptionValue) を返す。
- generator.[[AsyncGeneratorState]] を
suspended-yield に設定する。 - genContext を実行コンテキストスタックから取り除き、実行コンテキストスタックの最上位にある実行コンテキストを実行中の実行コンテキストとして復元する。
- callerContext を実行中の実行コンテキストとする。
undefined を渡して callerContext を再開する。genContext が再び再開された場合、resumptionValue をそれが再開されたCompletion Record とする。Assert : ここに制御が到達したならば、genContext は再び実行中の実行コンテキストである。- ?
AsyncGeneratorUnwrapYieldResumption (resumptionValue) を返す。
27.6.3.9 AsyncGeneratorAwaitReturn ( generator )
The
Assert : generator.[[AsyncGeneratorState]] はdraining-queue である。- queue を generator.[[AsyncGeneratorQueue]] とする。
Assert : queue は空でない。- next を queue の最初の要素とする。
- completion を
Completion (next.[[Completion]]) とする。 Assert : completion はreturn completion である。- promiseCompletion を
Completion (PromiseResolve (%Promise% , completion.[[Value]])) とする。 - promiseCompletion が
abrupt completion であるならば、AsyncGeneratorCompleteStep (generator, promiseCompletion,true ) を実行する。AsyncGeneratorDrainQueue (generator) を実行する。unused を返す。
Assert : promiseCompletion はnormal completion である。- promise を promiseCompletion.[[Value]] とする。
- fulfilledClosure を、generator をキャプチャし、呼び出されたときに次の手順を実行する、パラメータ (value) を持つ新しい
Abstract Closure とする：Assert : generator.[[AsyncGeneratorState]] はdraining-queue である。- result を
NormalCompletion (value) とする。 AsyncGeneratorCompleteStep (generator, result,true ) を実行する。AsyncGeneratorDrainQueue (generator) を実行する。NormalCompletion (undefined ) を返す。
- onFulfilled を
CreateBuiltinFunction (fulfilledClosure, 1,"" , « ») とする。 - rejectedClosure を、generator をキャプチャし、呼び出されたときに次の手順を実行する、パラメータ (reason) を持つ新しい
Abstract Closure とする：Assert : generator.[[AsyncGeneratorState]] はdraining-queue である。- result を
ThrowCompletion (reason) とする。 AsyncGeneratorCompleteStep (generator, result,true ) を実行する。AsyncGeneratorDrainQueue (generator) を実行する。NormalCompletion (undefined ) を返す。
- onRejected を
CreateBuiltinFunction (rejectedClosure, 1,"" , « ») とする。 PerformPromiseThen (promise, onFulfilled, onRejected) を実行する。unused を返す。
27.6.3.10 AsyncGeneratorDrainQueue ( generator )
The
Assert : generator.[[AsyncGeneratorState]] はdraining-queue である。- queue を generator.[[AsyncGeneratorQueue]] とする。
- queue が空でない間、繰り返す：
- next を queue の最初の要素とする。
- completion を
Completion (next.[[Completion]]) とする。 - completion が
return completion であるならば、AsyncGeneratorAwaitReturn (generator) を実行する。unused を返す。
- completion が
normal completion であるならば、- completion を
NormalCompletion (undefined ) に設定する。
- completion を
AsyncGeneratorCompleteStep (generator, completion,true ) を実行する。
- generator.[[AsyncGeneratorState]] を
completed に設定する。 unused を返す。
27.7 AsyncFunction オブジェクト
AsyncFunction は、通常
27.7.1 AsyncFunction コンストラクター
AsyncFunction コンストラクター：
- %AsyncFunction% である。
Functionのサブクラスである。- コンストラクターとしてではなく関数として呼び出されたとき、新しい AsyncFunction を作成し初期化する。したがって、関数呼び出し
AsyncFunction(…)は、同じ引数を持つオブジェクト作成式new AsyncFunction(…)と等価である。 - クラス定義の
extends節の値として使用してよい。指定された AsyncFunction の動作を継承することを意図するサブクラスコンストラクターは、built-in async function の動作に必要な内部スロットを持つサブクラスインスタンスを作成し初期化するため、AsyncFunction コンストラクターへのsuper呼び出しを含まなければならない。async function オブジェクトを定義するすべての ECMAScript 構文形式は、AsyncFunction の直接インスタンスを作成する。AsyncFunction サブクラスのインスタンスを作成する構文上の手段は存在しない。
27.7.1.1 AsyncFunction ( ...parameterArgs, bodyArg )
最後の引数（存在する場合）は async function の本体（実行可能コード）を指定する。それより前の任意の引数は仮引数を指定する。
この関数は、呼び出されたとき次の手順を実行する：
- activeFunc をアクティブな関数オブジェクトとする。
- bodyArg が存在しないならば、bodyArg を空の String に設定する。
- ?
CreateDynamicFunction (activeFunc, NewTarget,async , parameterArgs, bodyArg) を返す。
27.7.2 AsyncFunction コンストラクターのプロパティ
AsyncFunction コンストラクター：
- Function コンストラクターから継承する標準 built-in 関数オブジェクトである。
- 値が
%Function% である [[Prototype]] 内部スロットを持つ。 - 値が
1 𝔽 である"length" プロパティを持つ。 - 値が
"AsyncFunction" である"name" プロパティを持つ。 - 次のプロパティを持つ：
27.7.2.1 AsyncFunction.prototype
AsyncFunction.prototype の初期値は
このプロパティは属性 { [[Writable]]:
27.7.3 AsyncFunction プロトタイプオブジェクトのプロパティ
AsyncFunction プロトタイプオブジェクト：
- %AsyncFunction.prototype% である。
- 通常のオブジェクトである。
- 関数オブジェクトではなく、[[ECMAScriptCode]] 内部スロット、または
Table 25 に列挙されるその他の内部スロットを持たない。 - 値が
%Function.prototype% である [[Prototype]] 内部スロットを持つ。
27.7.3.1 AsyncFunction.prototype.constructor
AsyncFunction.prototype.constructor の初期値は
このプロパティは属性 { [[Writable]]:
27.7.3.2 AsyncFunction.prototype [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
27.7.4 AsyncFunction インスタンス
すべての AsyncFunction インスタンスは ECMAScript 関数オブジェクトであり、
各 AsyncFunction インスタンスは、次の own プロパティを持つ：
27.7.4.1 length
27.7.4.2 name
27.7.5 Async Functions 抽象操作
27.7.5.1 AsyncFunctionStart ( promiseCapability, asyncFunctionBody )
The
- runningContext を実行中の実行コンテキストとする。
- asyncContext を runningContext のコピーとする。
NOTE : 実行状態のコピーは、AsyncBlockStart がその実行を再開するために必要である。現在実行中のコンテキストを再開することは未定義である。AsyncBlockStart (promiseCapability, asyncFunctionBody, asyncContext) を実行する。unused を返す。
27.7.5.2 AsyncBlockStart ( promiseCapability, asyncBody, asyncContext )
The
- closure を、パラメーターを持たず、promiseCapability と asyncBody を捕捉する新しい抽象クロージャーとし、呼び出されたときに次の手順を実行するものとする:
- acAsyncContext を実行中の実行コンテキストとする。
- asyncBody が構文解析ノードである場合、
- result を
Completion (asyncBody の評価) とする。
- result を
- そうでない場合、
Assert : asyncBody はパラメーターを持たない抽象クロージャーである。- result を
Completion (asyncBody()) とする。
Assert : ここに戻ってきた場合、その async 関数は例外を投げたか、暗黙的または明示的な return を実行したかのいずれかであり、すべての await は完了している。- acAsyncContext を実行コンテキストスタックから取り除き、実行コンテキストスタックの先頭にある実行コンテキストを実行中の実行コンテキストとして復元する。
- result が正常完了である場合、
- !
Call (promiseCapability.[[Resolve]],undefined , «undefined ») を実行する。
- !
- そうでなく result が return 完了である場合、
- !
Call (promiseCapability.[[Resolve]],undefined , « result.[[Value]] ») を実行する。
- !
- そうでない場合、
NormalCompletion (unused ) を返す。
- asyncContext のコード評価状態を、当該実行コンテキストについて評価が再開されたときに closure が引数なしで呼び出されるように設定する。
- result を !
RunSuspendedContext (asyncContext,NormalCompletion (empty )) とする。 Assert : result はunused である。NOTE : result 値の可能な発生源はAwait 、または async 関数が何も await しない場合は上記のステップ1.i である。unused を返す。
27.7.5.3 Await ( value )
The
- asyncContext を実行中の実行コンテキストとする。
- promise を ?
PromiseResolve (%Promise% , value) とする。 - fulfilledClosure を、パラメーター (v) を持ち、asyncContext を捕捉する新しい抽象クロージャーとし、呼び出されたときに次の手順を実行するものとする:
Completion (RunSuspendedContext (asyncContext,NormalCompletion (v))) を実行する。NOTE :RunSuspendedContext によって返される完了レコードは意図的に無視される。NormalCompletion (undefined ) を返す。
- onFulfilled を
CreateBuiltinFunction (fulfilledClosure, 1,"" , « ») とする。 - rejectedClosure を、パラメーター (reason) を持ち、asyncContext を捕捉する新しい抽象クロージャーとし、呼び出されたときに次の手順を実行するものとする:
Completion (RunSuspendedContext (asyncContext,ThrowCompletion (reason))) を実行する。NOTE :RunSuspendedContext によって返される完了レコードは意図的に無視される。NormalCompletion (undefined ) を返す。
- onRejected を
CreateBuiltinFunction (rejectedClosure, 1,"" , « ») とする。 PerformPromiseThen (promise, onFulfilled, onRejected) を実行する。- asyncContext を実行コンテキストスタックから取り除き、実行コンテキストスタックの先頭にある実行コンテキストを実行中の実行コンテキストとして復元する。
- callerContext を実行中の実行コンテキストとする。
empty を渡して callerContext を再開する。asyncContext が再び再開されることがあれば、それが再開されるときの完了レコードを completion とする。Assert : 制御がここに到達した場合、asyncContext は再び実行中の実行コンテキストである。- completion を返す。
28 リフレクション
28.1 Reflect オブジェクト
Reflect オブジェクト：
- %Reflect% である。
グローバルオブジェクト の"Reflect" プロパティの初期値である。- 通常のオブジェクトである。
- 値が
%Object.prototype% である [[Prototype]] 内部スロットを持つ。 - 関数オブジェクトではない。
- [[Construct]] 内部メソッドを持たない。
new演算子でコンストラクターとして使用できない。 - [[Call]] 内部メソッドを持たない。関数として呼び出すことはできない。
28.1.1 Reflect.apply ( target, thisArgument, argumentsList )
この関数は、呼び出されたとき次の手順を実行する：
IsCallable (target) がfalse であれば、TypeError 例外を投げる。- args を ?
CreateListFromArrayLike (argumentsList) とする。 PrepareForTailCall () を実行する。- ?
Call (target, thisArgument, args) を返す。
28.1.2 Reflect.construct ( target, argumentsList [ , newTarget ] )
この関数は、呼び出されたとき次の手順を実行する：
IsConstructor (target) がfalse であれば、TypeError 例外を投げる。- newTarget が存在しないならば、newTarget を target に設定する。
- そうではなく
IsConstructor (newTarget) がfalse であれば、TypeError 例外を投げる。 - args を ?
CreateListFromArrayLike (argumentsList) とする。 - ?
Construct (target, args, newTarget) を返す。
28.1.3 Reflect.defineProperty ( target, propertyKey, attributes )
この関数は、呼び出されたとき次の手順を実行する：
- target が Object でなければ、
TypeError 例外を投げる。 - key を ?
ToPropertyKey (propertyKey) とする。 - desc を ?
ToPropertyDescriptor (attributes) とする。 - ? target.[[DefineOwnProperty]](key, desc) を返す。
28.1.4 Reflect.deleteProperty ( target, propertyKey )
この関数は、呼び出されたとき次の手順を実行する：
- target が Object でなければ、
TypeError 例外を投げる。 - key を ?
ToPropertyKey (propertyKey) とする。 - ? target.[[Delete]](key) を返す。
28.1.5 Reflect.get ( target, propertyKey [ , receiver ] )
この関数は、呼び出されたとき次の手順を実行する：
- target が Object でなければ、
TypeError 例外を投げる。 - key を ?
ToPropertyKey (propertyKey) とする。 - receiver が存在しないならば、
- receiver を target に設定する。
- ? target.[[Get]](key, receiver) を返す。
28.1.6 Reflect.getOwnPropertyDescriptor ( target, propertyKey )
この関数は、呼び出されたとき次の手順を実行する：
- target が Object でなければ、
TypeError 例外を投げる。 - key を ?
ToPropertyKey (propertyKey) とする。 - desc を ? target.[[GetOwnProperty]](key) とする。
FromPropertyDescriptor (desc) を返す。
28.1.7 Reflect.getPrototypeOf ( target )
この関数は、呼び出されたとき次の手順を実行する：
- target が Object でなければ、
TypeError 例外を投げる。 - ? target.[[GetPrototypeOf]]() を返す。
28.1.8 Reflect.has ( target, propertyKey )
この関数は、呼び出されたとき次の手順を実行する：
- target が Object でなければ、
TypeError 例外を投げる。 - key を ?
ToPropertyKey (propertyKey) とする。 - ? target.[[HasProperty]](key) を返す。
28.1.9 Reflect.isExtensible ( target )
この関数は、呼び出されたとき次の手順を実行する：
- target が Object でなければ、
TypeError 例外を投げる。 - ? target.[[IsExtensible]]() を返す。
28.1.10 Reflect.ownKeys ( target )
この関数は、呼び出されたとき次の手順を実行する：
- target が Object でなければ、
TypeError 例外を投げる。 - keys を ? target.[[OwnPropertyKeys]]() とする。
CreateArrayFromList (keys) を返す。
28.1.11 Reflect.preventExtensions ( target )
この関数は、呼び出されたとき次の手順を実行する：
- target が Object でなければ、
TypeError 例外を投げる。 - ? target.[[PreventExtensions]]() を返す。
28.1.12 Reflect.set ( target, propertyKey, value [ , receiver ] )
この関数は、呼び出されたとき次の手順を実行する：
- target が Object でなければ、
TypeError 例外を投げる。 - key を ?
ToPropertyKey (propertyKey) とする。 - receiver が存在しないならば、
- receiver を target に設定する。
- ? target.[[Set]](key, value, receiver) を返す。
28.1.13 Reflect.setPrototypeOf ( target, proto )
この関数は、呼び出されたとき次の手順を実行する：
- target が Object でなければ、
TypeError 例外を投げる。 - proto が Object でなく、かつ proto が
null でないならば、TypeError 例外を投げる。 - ? target.[[SetPrototypeOf]](proto) を返す。
28.1.14 Reflect [ %Symbol.toStringTag% ]
このプロパティは属性 { [[Writable]]:
28.2 Proxy オブジェクト
28.2.1 Proxy コンストラクター
Proxy コンストラクター：
- %Proxy% である。
グローバルオブジェクト の"Proxy" プロパティの初期値である。- コンストラクターとして呼び出されたとき、新しい Proxy オブジェクトを作成し初期化する。
- 関数として呼び出されることは意図されておらず、そのように呼び出された場合は例外を投げる。
28.2.1.1 Proxy ( target, handler )
この関数は、呼び出されたとき次の手順を実行する：
- NewTarget が
undefined であれば、TypeError 例外を投げる。 - ?
ProxyCreate (target, handler) を返す。
28.2.2 Proxy コンストラクターのプロパティ
Proxy コンストラクター：
- 値が
%Function.prototype% である [[Prototype]] 内部スロットを持つ。 - Proxy オブジェクトは初期化を必要とする [[Prototype]] 内部スロットを持たないため、
"prototype" プロパティを持たない。 - 次のプロパティを持つ：
28.2.2.1 Proxy.revocable ( target, handler )
この関数は、revocable Proxy オブジェクトを作成する。
呼び出されたとき、次の手順を実行する：
- proxy を ?
ProxyCreate (target, handler) とする。 - revokerClosure を、何もキャプチャせず、呼び出されたときに次の手順を実行する、パラメータを持たない新しい
Abstract Closure とする：- activeFunc をアクティブな関数オブジェクトとする。
- p を activeFunc.[[RevocableProxy]] とする。
- p が
null であれば、NormalCompletion (undefined ) を返す。 - activeFunc.[[RevocableProxy]] を
null に設定する。 Assert : p は Proxyexotic object である。- p.[[ProxyTarget]] を
null に設定する。 - p.[[ProxyHandler]] を
null に設定する。 NormalCompletion (undefined ) を返す。
- revoker を
CreateBuiltinFunction (revokerClosure, 0,"" , « [[RevocableProxy]] ») とする。 - revoker.[[RevocableProxy]] を proxy に設定する。
- result を
OrdinaryObjectCreate (%Object.prototype% ) とする。 - !
CreateDataPropertyOrThrow (result,"proxy" , proxy) を実行する。 - !
CreateDataPropertyOrThrow (result,"revoke" , revoker) を実行する。 - result を返す。
28.3 Module Namespace オブジェクト
Module Namespace Object は、モジュールの exported binding への実行時のプロパティベースのアクセスを提供する module namespace
28.3.1 %Symbol.toStringTag%
このプロパティは属性 { [[Writable]]:
29 メモリモデル
メモリ一貫性モデル、またはメモリモデルは、SharedArrayBuffer によって裏付けられた
メモリモデルは、評価中に SharedArrayBuffer 上の抽象操作または Atomics オブジェクト上のメソッドによって導入される
この節は、SharedArrayBuffer 上の抽象操作によって導入される
29.1 メモリモデルの基礎
共有メモリアクセス（読み取りおよび書き込み）は、以下で定義される 2 つのグループ、atomic access と data access に分けられる。atomic access は逐次一貫であり、すなわちエージェントクラスタ内のすべてのエージェントが合意するイベントの厳密な全順序が存在する。非 atomic access には、すべてのエージェントが合意する厳密な全順序は存在しない、すなわち unordered である。
release-acquire のような、逐次一貫より弱く unordered より強い順序付けはサポートされない。
Shared Data Block イベントは、ReadSharedMemory、WriteSharedMemory、または ReadModifyWriteSharedMemory
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Order]] | そのイベントについて |
|
| [[NoTear]] | Boolean | このイベントが、このイベントと等しい |
| [[Block]] | そのイベントが操作するブロック。 | |
| [[ByteIndex]] | 非負整数 | [[Block]] 内の読み取りのバイトアドレス。 |
| [[ElementSize]] | 非負整数 | 読み取りのサイズ。 |
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Order]] | そのイベントについて |
|
| [[NoTear]] | Boolean | このイベントが、このイベントと等しい |
| [[Block]] | そのイベントが操作するブロック。 | |
| [[ByteIndex]] | 非負整数 | [[Block]] 内の書き込みのバイトアドレス。 |
| [[ElementSize]] | 非負整数 | 書き込みのサイズ。 |
| [[Payload]] | バイト値の |
他のイベントによって読み取られるバイト値の |
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Order]] | read-modify-write イベントは常に逐次一貫である。 | |
| [[NoTear]] | read-modify-write イベントは tear しない。 | |
| [[Block]] | そのイベントが操作するブロック。 | |
| [[ByteIndex]] | 非負整数 | [[Block]] 内の read-modify-write のバイトアドレス。 |
| [[ElementSize]] | 非負整数 | read-modify-write のサイズ。 |
| [[Payload]] | バイト値の |
[[ModifyOp]] に渡されるバイト値の |
| [[ModifyOp]] | read-modify-write 変更関数 | 読み取られたバイト値の |
Shared Data Block イベントは、抽象操作または Atomics オブジェクト上のメソッドによって
Shared Data Block イベント e のメモリ範囲を、e.[[ByteIndex]]（含む）から e.[[ByteIndex]] + e.[[ElementSize]]（含まない）までの区間内のすべての整数の Set とする。2 つのイベントのメモリ範囲は、それらのイベントが同じ [[Block]]、[[ByteIndex]]、および [[ElementSize]] を持つとき等しい。2 つのイベントのメモリ範囲は、それらのイベントが同じ [[Block]] を持ち、範囲が等しくなく、かつそれらの共通部分が空でないとき重なっている。2 つのイベントのメモリ範囲は、それらのイベントが同じ [[Block]] を持たないか、またはそれらの範囲が等しくも重なってもいないとき、互いに素である。
考慮されるべき postMessage による）、エージェントの開始と停止、および共有メモリ以外のチャネルを介したエージェントクラスタ内での通信がある。特定の execution execution について、それらのイベントは
イベントは、以下で定義される関係によって
29.2 Agent Events Record
Agent Events Record は、次のフィールドを持つ
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[AgentSignifier]] | この順序付けを生じさせた評価を行ったエージェント。 | |
| [[EventList]] | イベントは評価中にこのリストへ追加される。 | |
| [[AgentSynchronizesWith]] | 操作的意味論によって導入される |
29.3 Chosen Value Record
Chosen Value Record は、次のフィールドを持つ
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[Event]] | この chosen value のために導入された |
|
| [[ChosenValue]] | バイト値の |
評価中に非決定的に選ばれたバイト。 |
29.4 Candidate Execution
エージェントクラスタの評価のcandidate execution は、次のフィールドを持つ
| フィールド名 | 値 | 意味 |
|---|---|---|
| [[EventsRecords]] | エージェントを、評価中に追加された |
|
| [[ChosenValues]] |
空の candidate execution は、そのフィールドが空の
29.5 メモリモデルのための抽象操作
29.5.1 EventSet ( execution )
The
- events を空の Set とする。
- execution.[[EventsRecords]] の各
Agent Events Record aer について、次を行う：- aer.[[EventList]] の各
Memory event event について、次を行う：- event を events に追加する。
- aer.[[EventList]] の各
- events を返す。
29.5.2 SharedDataBlockEventSet ( execution )
The
- events を空の Set とする。
EventSet (execution) の各Memory event event について、次を行う：- event が
Shared Data Block イベント ならば、event を events に追加する。
- event が
- events を返す。
29.5.3 HostEventSet ( execution )
The
EventSet (execution) の要素のうち、SharedDataBlockEventSet (execution) に含まれないすべての要素を含む新しい Set を返す。
29.5.4 ComposeWriteEventBytes ( execution, byteIndex, writes )
The
- byteLocation を byteIndex とする。
- bytesRead を新しい空の
List とする。 - writes の各要素 writeEvent について、次を行う：
Assert : writeEvent はそのメモリ範囲 内に byteLocation を持つ。- payloadIndex を byteLocation - writeEvent.[[ByteIndex]] とする。
- writeEvent が
WriteSharedMemory イベントであるならば、- byte を writeEvent.[[Payload]][payloadIndex] とする。
- そうでなければ、
Assert : writeEvent はReadModifyWriteSharedMemory イベントである。- bytes を
ValueOfReadEvent (execution, writeEvent) とする。 - bytesModified を writeEvent.[[ModifyOp]](bytes, writeEvent.[[Payload]]) とする。
- byte を bytesModified[payloadIndex] とする。
- byte を bytesRead に追加する。
- byteLocation を byteLocation + 1 に設定する。
- bytesRead を返す。
read-modify-write 変更 [[ModifyOp]] は、
この抽象操作は、
29.5.5 ValueOfReadEvent ( execution, readEvent )
The
- writes を execution における
reads-bytes-from (readEvent) とする。 Assert : writes は、長さが readEvent.[[ElementSize]] と等しいWriteSharedMemory またはReadModifyWriteSharedMemory イベントのList である。ComposeWriteEventBytes (execution, readEvent.[[ByteIndex]], writes) を返す。
29.6 Candidate Execution の関係
次の関係および数学的関数は、特定の
29.6.1 is-agent-order-before
- イベント eventA および eventB について、execution.[[EventsRecords]] 内にある
Agent Events Record aer が存在し、aer.[[EventList]] が eventA と eventB の両方を含み、かつ aer.[[EventList]] のList 順序において eventA が eventB より前である場合、execution において eventA は eventB より is-agent-order-before である。
各エージェントは、評価中にエージェントごとの厳密な全順序でイベントを導入する。これはそれらの厳密な全順序の和集合である。
29.6.2 reads-bytes-from
-
SharedDataBlockEventSet (execution) 内の各ReadSharedMemory またはReadModifyWriteSharedMemory イベント readEvent について、execution における reads-bytes-from(readEvent) は、長さが readEvent.[[ElementSize]] のList であり、その要素は、次のすべてが真であるようなWriteSharedMemory またはReadModifyWriteSharedMemory イベント writes である。- writes 内のインデックス i を持つ各イベント writeEvent は、その
メモリ範囲 内に readEvent.[[ByteIndex]] + i を持つ。 - result は writes 内にない。
- writes 内のインデックス i を持つ各イベント writeEvent は、その
29.6.3 reads-from
- イベント readEvent および writeEvent について、
SharedDataBlockEventSet (execution) が readEvent と writeEvent の両方を含み、かつ execution におけるreads-bytes-from (readEvent) が writeEvent を含む場合、execution において readEvent は writeEvent から reads-from する。
29.6.4 host-synchronizes-with
- execution において eventA が eventB と host-synchronizes-with するならば、
HostEventSet (execution) は eventA と eventB を含む。 - execution において host-synchronizes-with と
is-agent-order-before の和集合に cycle は存在しない。
この postMessage などの追加の同期機構を提供できる。
29.6.5 synchronizes-with
-
イベント readEvent および writeEvent について、execution において readEvent が writeEvent から
reads-from し、readEvent.[[Order]] がseq-cst であり、writeEvent.[[Order]] がseq-cst であり、かつ readEvent と writeEvent が等しいメモリ範囲 を持つ場合、execution において writeEvent は readEvent と synchronizes-with する。 -
execution.[[EventsRecords]] の各要素 eventsRecord について、次が真である。
- イベント eventA および eventB について、eventsRecord.[[AgentSynchronizesWith]] が (eventA, eventB) を含む場合、execution において eventA は eventB と synchronizes-with する。
- イベント eventA および eventB について、execution.[[HostSynchronizesWith]] が (eventA, eventB) を含む場合、execution において eventA は eventB と synchronizes-with する。
29.6.6 happens-before
-
イベント eventA および eventB について、次の条件のいずれかが真である場合、execution において eventA は eventB より happens-before である。
- execution において eventA が eventB より
is-agent-order-before である。 - execution において eventA が eventB と
synchronizes-with する。 SharedDataBlockEventSet (execution) が eventA と eventB の両方を含み、eventA.[[Order]] がinit であり、かつ eventA と eventB が重なっているメモリ範囲 を持つ。- execution において eventA が eventC より happens-before であり、かつ eventC が eventB より happens-before であるようなイベント eventC が存在する。
- execution において eventA が eventB より
happens-before は
29.7 Valid Execution の性質
29.7.1 Valid Chosen Reads
SharedDataBlockEventSet (execution) の各ReadSharedMemory またはReadModifyWriteSharedMemory イベント readEvent について、次を行う：- chosenValueRecord を、[[Event]] フィールドが readEvent である execution.[[ChosenValues]] の要素とする。
- chosenValue を chosenValueRecord.[[ChosenValue]] とする。
- readValue を
ValueOfReadEvent (execution, readEvent) とする。 - chosenLen を chosenValue 内の要素数とする。
- readLen を readValue 内の要素数とする。
- chosenLen ≠ readLen ならば、
false を返す。
- 0（含む）から chosenLen（含まない）までの区間内のある整数 i について chosenValue[i] ≠ readValue[i] であるならば、
false を返す。
true を返す。
29.7.2 Coherent Reads
SharedDataBlockEventSet (execution) の各ReadSharedMemory またはReadModifyWriteSharedMemory イベント readEvent について、次を行う：- writes を execution における
reads-bytes-from (readEvent) とする。 - byteLocation を readEvent.[[ByteIndex]] とする。
- writes の各要素 writeEvent について、次を行う：
- execution において readEvent が writeEvent より
happens-before であるならば、false を返す。
- byteLocation をその
メモリ範囲 内に持つWriteSharedMemory またはReadModifyWriteSharedMemory イベント value が存在し、execution において writeEvent が value よりhappens-before であり、かつ value が readEvent よりhappens-before であるならば、false を返す。
- byteLocation を byteLocation + 1 に設定する。
- execution において readEvent が writeEvent より
- writes を execution における
true を返す。
29.7.3 Tear Free Reads
SharedDataBlockEventSet (execution) の各ReadSharedMemory またはReadModifyWriteSharedMemory イベント readEvent について、次を行う：- readEvent.[[NoTear]] が
true であるならば、Assert : readEvent.[[ByteIndex]] を readEvent.[[ElementSize]] で割った余りは 0 である。- execution において readEvent が writeEvent から
reads-from し、かつ writeEvent.[[NoTear]] がtrue である各Memory event writeEvent について、次を行う：- readEvent と writeEvent が等しい
メモリ範囲 を持ち、かつ value と writeEvent が等しいメモリ範囲 を持ち、value.[[NoTear]] がtrue であり、writeEvent と value が同じShared Data Block イベント ではなく、かつ execution において readEvent が value からreads-from するようなMemory event value が存在するならば、false を返す。
- readEvent と writeEvent が等しい
- readEvent.[[NoTear]] が
true を返す。
直感的には、この要件は、
29.7.4 逐次一貫 Atomic
- イベント eventA および eventB について、execution において eventA が eventB より
happens-before である場合、execution において eventA は eventB より is-memory-order-before である。 -
execution において readEvent が writeEvent から
reads-from するようなイベント readEvent および writeEvent について、SharedDataBlockEventSet (execution) 内に、value.[[Order]] がseq-cst であり、execution において writeEvent が value より is-memory-order-before であり、value が readEvent より is-memory-order-before であり、かつ次の条件のいずれかが真であるようなWriteSharedMemory またはReadModifyWriteSharedMemory イベント value は存在しない。- execution において writeEvent が readEvent と
synchronizes-with し、かつ value と readEvent が等しいメモリ範囲 を持つ。 - execution において writeEvent が readEvent より
happens-before であり、かつ value が readEvent よりhappens-before であり、writeEvent.[[Order]] がseq-cst であり、かつ writeEvent と value が等しいメモリ範囲 を持つ。 - execution において writeEvent が readEvent より
happens-before であり、かつ writeEvent が value よりhappens-before であり、readEvent.[[Order]] がseq-cst であり、かつ value と readEvent が等しいメモリ範囲 を持つ。
Note 1 この節はさらに、等しい
メモリ範囲 上のseq-cst イベントを制約する。 - execution において writeEvent が readEvent と
-
SharedDataBlockEventSet (execution) 内の各WriteSharedMemory またはReadModifyWriteSharedMemory イベント writeEvent について、writeEvent.[[Order]] がseq-cst であるならば、等しいメモリ範囲 を持ち、かつ writeEvent より memory-order before であるReadSharedMemory またはReadModifyWriteSharedMemory イベントがSharedDataBlockEventSet (execution) 内に無限個存在する、ということはない。Note 2
is-memory-order-before は
29.7.5 Valid Executions
- ホストが execution に対して
host-synchronizes-with Relation を提供する。 - execution は
strict partial order であるhappens-before Relation を認める。 - execution は valid chosen reads を持つ。
- execution は coherent reads を持つ。
- execution は tear free reads を持つ。
- execution は sequentially consistent atomics を持つ。
すべてのプログラムは少なくとも 1 つの valid execution を持つ。
29.8 Races
execution execution および
- eventA と eventB が同じ
Shared Data Block イベント でないならば、- execution において eventA が eventB より
happens-before であり、かつ eventB が eventA よりhappens-before である、ということが成り立たないならば、- eventA が
WriteSharedMemory またはReadModifyWriteSharedMemory イベントのいずれかであり、eventB がWriteSharedMemory またはReadModifyWriteSharedMemory イベントのいずれかであり、かつ eventA と eventB が互いに素なメモリ範囲 を持たない場合、true を返す。
- execution において eventA が eventB から
reads-from する、または eventB が eventA からreads-from するならば、true を返す。
- eventA が
- execution において eventA が eventB より
false を返す。
29.9 Data Races
execution execution および
29.10 Data Race Freedom
execution execution は、
プログラムは、そのすべての execution が data race free である場合、data race free である。
29.11 共有メモリの指針
以下は、共有メモリを扱う ECMAScript プログラマーのための指針である。
プログラムを
より一般に、プログラムが
以下は、共有メモリを使用するプログラムに対するコンパイラ変換を書く ECMAScript 実装者のための指針である。
単一エージェント設定で有効なほとんどのプログラム変換を、マルチエージェント設定でも許可することが望ましい。これは、マルチエージェントプログラム内の各エージェントの性能が単一エージェント設定と同程度に良好であることを保証するためである。しばしば、これらの変換は判断が難しい。ここでは、（
agent-order slice を、単一のエージェントに関係する
共有メモリが存在しない場合に有効な agent-order slice の任意の変換は、次の例外を除き、共有メモリが存在する場合にも有効である。
-
Atomics are carved in stone：プログラム変換は、[[Order]] が
seq-cst であるShared Data Block イベント をis-agent-order-before Relation から取り除いたり、それらを互いに対して並べ替えたり、エージェント順序スライス内で [[Order]] がunordered であるイベントに対して並べ替えたりしてはならない。（実際には、並べ替えの禁止により、コンパイラはすべての
seq-cst 操作が同期であり、最終的なis-memory-order-before Relation に含まれると仮定せざるを得なくなる。これは、エージェント間プログラム解析がない場合には、通常いずれにせよ仮定しなければならないことである。また、メモリ順序への効果が不明な呼び出し先を持つすべての呼び出しがseq-cst 操作を含み得ると仮定することもコンパイラに強制する。） -
Reads must be stable：任意の与えられた共有メモリ読み取りは、1 回の execution において単一の値のみを観測しなければならない。
（例えば、プログラム内で意味論的に単一の読み取りであるものが複数回実行された場合、その後プログラムは読み取られた値のうち 1 つだけを観測することが許される。rematerialization と呼ばれる変換はこの規則に違反し得る。）
-
Writes must be stable：共有メモリへのすべての観測可能な書き込みは、execution におけるプログラム意味論から従わなければならない。
（例えば、変換は、より小さいデータを書き込むためにより大きなロケーション上の read-modify-write 操作を使用すること、プログラムが書き込めなかった値をメモリに書き込むこと、または読み取られたロケーションが読み取り後に別のエージェントによって上書きされ得た場合に、読み取ったばかりの値をそのロケーションへ書き戻すことなど、特定の観測可能な書き込みを導入してはならない。）
-
Possible read values must be non-empty：プログラム変換は、共有メモリ読み取りの possible read values を空にしてはならない。
（直感に反するが、この規則は、
read event によって読み取られる限りで write がメモリモデル において効力を持つため、実質的に write に対する変換を制限する。例えば、write は移動および併合され、時には 2 つのseq-cst 操作の間で並べ替えられることもあるが、その変換はあるロケーションを更新するすべての write を取り除いてはならず、何らかの write が保持されなければならない。）
有効なままである変換の例には、同じロケーションからの複数の非 atomic read のマージ、非 atomic read の並べ替え、投機的な非 atomic read の導入、同じロケーションへの複数の非 atomic write のマージ、異なるロケーションへの非 atomic write の並べ替え、および終了性に影響しても非 atomic read をループ外へ巻き上げることがある。一般に、エイリアスされた
以下は、共有メモリアクセスのための機械語コードを生成する ECMAScript 実装者のための指針である。
ARM または Power のLOCK プレフィックス付き命令、ARM 上の load-exclusive/store-exclusive 命令、および Power 上の load-link/store-conditional 命令にコンパイルされてよい。
具体的には、
- プログラム内のすべての atomic 操作は必要であると仮定される。
- Atomic 操作は、互いに対しても非 atomic 操作に対しても決して並べ替えられない。
- 関数は常に atomic 操作を実行するものと仮定される。
- Atomic 操作は、より大きなデータに対する read-modify-write 操作として実装されることはなく、プラットフォームが適切なサイズの atomic 操作を持たない場合は非 lock-free atomic として実装される。（すべてのプラットフォームが、重要なすべてのサイズの通常のメモリアクセス操作を持つことは既に仮定している。）
単純なコード生成では、次のパターンを使用する。
- 通常の load および store は、単一の load 命令および store 命令にコンパイルされる。
- Lock-free atomic load および store は、完全な（逐次一貫な）fence、通常の load または store、および完全な fence にコンパイルされる。
- Lock-free atomic read-modify-write access は、完全な fence、atomic read-modify-write 命令列、および完全な fence にコンパイルされる。
- 非 lock-free atomic は、spinlock acquire、完全な fence、一連の非 atomic load および store 命令、完全な fence、および spinlock release にコンパイルされる。
この写像は、ある
これらの基本パターンへの局所的な改善も、
- 冗長な fence を取り除く、明らかなプラットフォーム依存の改善がある。例えば、x86 では、lock-free atomic load および store の周囲の fence は、store 後の fence を除き常に省略でき、lock-free read-modify-write 命令には fence が不要である。これらはすべて
LOCKプレフィックス付き命令を使用するためである。多くのプラットフォームには複数の強度の fence があり、特定の文脈では逐次一貫性を壊すことなくより弱い fence を使用できる。 - ほとんどの現代的なプラットフォームは、ECMAScript atomics が要求するすべてのデータサイズについて lock-free atomics をサポートしている。非 lock-free atomic が必要な場合、atomic 操作本体を囲む fence は通常 lock および unlock 手順に畳み込める。非 lock-free atomics の最も単純な解決策は、SharedArrayBuffer ごとに単一の lock word を持つことである。
- より複雑なプラットフォーム依存の局所的改善もあり、それには何らかのコード解析が必要である。例えば、連続する 2 つの fence はしばしば単一の fence と同じ効果を持つため、2 つの atomic 操作が連続してコード生成される場合、それらの間を隔てる fence は 1 つだけでよい。x86 では、atomic store を隔てる単一の fence でさえ省略できる。store 後の fence は、その store を後続の load から分離するためにのみ必要であるためである。
Annex A (informative) 文法概要
A.1 字句文法
A.2 式
生成規則
のインスタンスを処理するとき、
生成規則
のインスタンスを処理するとき、
特定の状況で、生成規則
のインスタンスを処理するとき、
A.3 文
A.4 関数とクラス
生成規則
のインスタンスを処理するとき、
生成規則
のインスタンスを処理するとき、
A.5 スクリプトとモジュール
A.6 数値変換
A.7 タイムゾーンオフセット文字列形式
A.8 正規表現
関連付けられる u \u \u u
Annex B (normative) Web ブラウザー向けの追加 ECMAScript 機能
この附属書で定義される ECMAScript 言語の構文および意味論は、ECMAScript ホストが web ブラウザーである場合に要求される。この附属書の内容は規範的であるが、ECMAScript ホストが web ブラウザーでない場合は任意である。
この附属書で定義される機能の一部はこの附属書で指定され、一部はこの文書の本文で指定される。
機能が本文で指定される場合、それが文書に影響する各箇所は、色付きのボックス内の "
この附属書は、web ブラウザー ECMAScript ホストの様々なレガシー機能およびその他の特性を記述する。この附属書で指定されるすべての言語機能および振る舞いは、1 つ以上の望ましくない特性を持ち、レガシーな使用がなければこの仕様から削除されるものである。しかし、既存の多数の web ページがこれらの機能を使用しているため、web ブラウザーはそれらを引き続きサポートしなければならない。この附属書の仕様は、これらのレガシー機能の相互運用可能な実装に対する要件を定義する。
これらの機能は、コア ECMAScript 言語の一部とは見なされない。プログラマーは、新しい ECMAScript コードを書くときに、これらの機能および振る舞いを使用したり、それらの存在を仮定したりするべきではない。ECMAScript 実装は、その実装が web ブラウザーの一部であるか、web ブラウザーが遭遇するものと同じレガシー ECMAScript コードを実行する必要がある場合を除き、これらの機能を実装しないことが推奨される。
B.1 追加構文
B.1.1 HTML 風コメント
構文
行終端コードポイントを含む
B.1.2 正規表現パターン
この代替パターン文法および意味論は、BMP パターンの構文および意味論のみを変更する。次の文法拡張には、[UnicodeMode] パラメータでパラメータ化された生成規則が含まれる。しかし、これらの拡張はいずれも、ゴール記号に [UnicodeMode] パラメータが存在する状態で解析するときに認識される Unicode パターンの構文を変更しない。
構文
同じ左辺が [+UnicodeMode] ガードと [~UnicodeMode] ガードの両方で出現する場合、それは曖昧性解消の優先順位を制御するためである。
B.1.2.1 Static Semantics: Early Errors
- いずれかのソーステキストがこの生成規則に一致する場合、それは Syntax Error である。
さらに、次の生成規則に対する規則は、強調表示されたテキストの追加によって変更される：
-
最初の
ClassAtom のIsCharacterClass がtrue であるか、または 2 番目のClassAtom のIsCharacterClass がtrue であり、かつこの生成規則が [UnicodeMode] パラメータを持つ場合、それは Syntax Error である。 -
最初の
ClassAtom のIsCharacterClass がfalse 、2 番目のClassAtom のIsCharacterClass がfalse であり、かつ最初のClassAtom のCharacterValue が 2 番目のClassAtom のCharacterValue より厳密に大きい場合、それは Syntax Error である。
-
ClassAtomNoDash のIsCharacterClass がtrue であるか、またはClassAtom のIsCharacterClass がtrue であり、かつこの生成規則が [UnicodeMode] パラメータを持つ場合、それは Syntax Error である。 -
ClassAtomNoDash のIsCharacterClass がfalse 、ClassAtom のIsCharacterClass がfalse であり、かつClassAtomNoDash のCharacterValue がClassAtom のCharacterValue より厳密に大きい場合、それは 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) の数値を返す。
- ch を
ClassControlLetter に一致したコードポイントとする。 - i を ch の数値とする。
- i を 32 で割った余りを返す。
LegacyOctalEscapeSequence の MV を返す（12.9.4.3 を参照）。
B.1.2.5 Runtime Semantics: CompileSubpattern
B.1.2.6 Runtime Semantics: CompileAssertion
B.1.2.7 Runtime Semantics: CompileAtom
- charSet を単一文字
\U+005C (REVERSE SOLIDUS) を含むCharSet とする。 CharacterSetMatcher (regexpRecord, charSet,false , direction) を返す。
- ch を
ExtendedPatternCharacter によって表される文字とする。 - charSet を文字 ch を含む 1 要素の
CharSet とする。 CharacterSetMatcher (regexpRecord, charSet,false , direction) を返す。
B.1.2.8 Runtime Semantics: CompileToCharSet
次の 2 つの規則は、
- charSet を、引数 regexpRecord を伴う最初の
ClassAtom のCompileToCharSet とする。 - otherSet を、引数 regexpRecord を伴う 2 番目の
ClassAtom のCompileToCharSet とする。 - remainingSet を、引数 regexpRecord を伴う
ClassContents のCompileToCharSet とする。 - rangeSet を
CharacterRangeOrUnion (regexpRecord, charSet, otherSet) とする。 - rangeSet と remainingSet の和集合を返す。
- charSet を、引数 regexpRecord を伴う
ClassAtomNoDash のCompileToCharSet とする。 - otherSet を、引数 regexpRecord を伴う
ClassAtom のCompileToCharSet とする。 - remainingSet を、引数 regexpRecord を伴う
ClassContents のCompileToCharSet とする。 - rangeSet を
CharacterRangeOrUnion (regexpRecord, charSet, otherSet) とする。 - rangeSet と remainingSet の和集合を返す。
さらに、次の規則が
- cv をこの
ClassEscape のCharacterValue とする。 - c を文字値が cv である文字とする。
- 単一文字 c を含む
CharSet を返す。
- 単一文字
\U+005C (REVERSE SOLIDUS) を含むCharSet を返す。
\c からのみ到達でき、その後に許容可能な制御文字が続かない場合に限られる。B.1.2.8.1 CharacterRangeOrUnion ( regexpRecord, charSet, otherSet )
The
HasEitherUnicodeFlag (regexpRecord) がfalse であれば、CharacterRange (charSet, otherSet) を返す。
B.1.2.9 Static Semantics: ParsePattern ( patternText, u, v )
抽象操作
- v が
true かつ u がtrue ならば、- parseResult を、1 つ以上の
SyntaxError オブジェクトを含むList とする。
- parseResult を、1 つ以上の
- そうではなく v が
true ならば、 - そうではなく u が
true ならば、 - そうでなければ、
- parseResult を返す。
B.2 追加の組込みプロパティ
ECMAScript ホストが web ブラウザーである場合、標準組込みオブジェクトの次の追加プロパティが定義される。
B.2.1 グローバルオブジェクトの追加プロパティ
| Intrinsic 名 | グローバル名 | ECMAScript 言語との関連 |
|---|---|---|
|
|
escape
|
escape 関数（ |
|
|
unescape
|
unescape 関数（ |
B.2.1.1 escape ( string )
この関数は
数値が 0x00FF 以下のコード単位を置き換える場合、%xx 形式の 2 桁エスケープシーケンスが使用される。数値が 0x00FF より厳密に大きいコード単位を置き換える場合、%uxxxx 形式の 4 桁エスケープシーケンスが使用される。
これは %escape% intrinsic オブジェクトである。
呼び出されたとき、次の手順を実行する：
- string を ?
ToString (string) に設定する。 - len を string の長さとする。
- result を空の String とする。
- unescapedSet を ASCII word character と
"@*+-./" の文字列連結とする。 - k を 0 とする。
- k < len の間、繰り返す：
- codeUnit を string 内のインデックス k にあるコード単位とする。
- unescapedSet が codeUnit を含むならば、
- str を codeUnit とする。
- そうでなければ、
- result を result と str の文字列連結に設定する。
- k を k + 1 に設定する。
- result を返す。
このエンコーディングは RFC 1738 に記述されたエンコーディングに部分的に基づくが、この標準で指定されるエンコーディング全体は RFC 1738 の内容に関わらず上記で記述されている。このエンコーディングは、RFC 3986 によって RFC 1738 に加えられた変更を反映しない。
B.2.1.2 unescape ( string )
この関数はescape 関数によって導入され得る種類の各エスケープシーケンスが、それが表すコード単位に置き換えられた String 値の新しいバージョンを計算する。
これは %unescape% intrinsic オブジェクトである。
呼び出されたとき、次の手順を実行する：
- string を ?
ToString (string) に設定する。 - len を string の長さとする。
- result を空の String とする。
- k を 0 とする。
- k < len の間、繰り返す：
- codeUnit を string 内のインデックス k にあるコード単位とする。
- codeUnit がコード単位 0x0025 (PERCENT SIGN) であるならば、
- hexDigits を空の String とする。
- optionalAdvance を 0 とする。
- k + 5 < len であり、かつ string 内のインデックス k + 1 にあるコード単位がコード単位 0x0075 (LATIN SMALL LETTER U) であるならば、
- hexDigits を string の k + 2 から k + 6 までの部分文字列に設定する。
- optionalAdvance を 5 に設定する。
- そうではなく k + 3 ≤ len ならば、
- hexDigits を string の k + 1 から k + 3 までの部分文字列に設定する。
- optionalAdvance を 2 に設定する。
- parseResult を
ParseText (hexDigits,HexDigits ) とする。[~Sep] - parseResult が
Parse Node であるならば、- n を parseResult の MV とする。
- codeUnit を数値が n であるコード単位に設定する。
- k を k + optionalAdvance に設定する。
- result を result と codeUnit の文字列連結に設定する。
- k を k + 1 に設定する。
- result を返す。
B.2.2 String.prototype オブジェクトの追加プロパティ
B.2.2.1 String.prototype.substr ( start, length )
このメソッドは、
呼び出されたとき、次の手順を実行する：
- obj を
this value とする。 - ?
RequireObjectCoercible (obj) を実行する。 - str を ?
ToString (obj) とする。 - size を str の長さとする。
- intStart を ?
ToIntegerOrInfinity (start) とする。 - intStart = -∞ ならば、intStart を 0 に設定する。
- そうではなく intStart < 0 ならば、intStart を
max (size + intStart, 0) に設定する。 - そうでなければ、intStart を
min (intStart, size) に設定する。 - length が
undefined ならば intLength を size とする；そうでなければ intLength を ?ToIntegerOrInfinity (length) とする。 - intLength を、intLength を 0 と size の間にクランプした結果に設定する。
- intEnd を
min (intStart + intLength, size) とする。 - str の intStart から intEnd までの部分文字列を返す。
このメソッドは意図的に generic である。その
B.2.2.2 String.prototype.anchor ( name )
このメソッドは、呼び出されたとき次の手順を実行する：
- str を
this value とする。 - ?
CreateHTML (str,"a" ,"name" , name) を返す。
B.2.2.2.1 CreateHTML ( contents, tag, attribute, attrValue )
The
- ?
RequireObjectCoercible (contents) を実行する。 - contentsStr を ?
ToString (contents) とする。 - p1 を
"<" と tag の文字列連結とする。 - attribute が空の String でないならば、
- attrValueStr を ?
ToString (attrValue) とする。 - escapedAttrValue を、attrValueStr 内のコード単位 0x0022 (QUOTATION MARK) の各出現が 6 個のコード単位のシーケンス
""" に置き換えられていることを除き、attrValueStr と同じ String 値とする。 - p1 を次の文字列連結に設定する：
- p1
- コード単位 0x0020 (SPACE)
- attribute
- コード単位 0x003D (EQUALS SIGN)
- コード単位 0x0022 (QUOTATION MARK)
- escapedAttrValue
- コード単位 0x0022 (QUOTATION MARK)
- attrValueStr を ?
- p2 を p1 と
">" の文字列連結とする。 - p3 を p2 と contentsStr の文字列連結とする。
- p4 を p3、
"</" 、tag、および">" の文字列連結とする。 - p4 を返す。
B.2.2.3 String.prototype.big ( )
このメソッドは、呼び出されたとき次の手順を実行する：
- str を
this value とする。 - ?
CreateHTML (str,"big" ,"" ,"" ) を返す。
B.2.2.4 String.prototype.blink ( )
このメソッドは、呼び出されたとき次の手順を実行する：
- str を
this value とする。 - ?
CreateHTML (str,"blink" ,"" ,"" ) を返す。
B.2.2.5 String.prototype.bold ( )
このメソッドは、呼び出されたとき次の手順を実行する：
- str を
this value とする。 - ?
CreateHTML (str,"b" ,"" ,"" ) を返す。
B.2.2.6 String.prototype.fixed ( )
このメソッドは、呼び出されたとき次の手順を実行する：
- str を
this value とする。 - ?
CreateHTML (str,"tt" ,"" ,"" ) を返す。
B.2.2.7 String.prototype.fontcolor ( colour )
このメソッドは、呼び出されたとき次の手順を実行する：
- str を
this value とする。 - ?
CreateHTML (str,"font" ,"color" , colour) を返す。
B.2.2.8 String.prototype.fontsize ( size )
このメソッドは、呼び出されたとき次の手順を実行する：
- str を
this value とする。 - ?
CreateHTML (str,"font" ,"size" , size) を返す。
B.2.2.9 String.prototype.italics ( )
このメソッドは、呼び出されたとき次の手順を実行する：
- str を
this value とする。 - ?
CreateHTML (str,"i" ,"" ,"" ) を返す。
B.2.2.10 String.prototype.link ( url )
このメソッドは、呼び出されたとき次の手順を実行する：
- str を
this value とする。 - ?
CreateHTML (str,"a" ,"href" , url) を返す。
B.2.2.11 String.prototype.small ( )
このメソッドは、呼び出されたとき次の手順を実行する：
- str を
this value とする。 - ?
CreateHTML (str,"small" ,"" ,"" ) を返す。
B.2.2.12 String.prototype.strike ( )
このメソッドは、呼び出されたとき次の手順を実行する：
- str を
this value とする。 - ?
CreateHTML (str,"strike" ,"" ,"" ) を返す。
B.2.2.13 String.prototype.sub ( )
このメソッドは、呼び出されたとき次の手順を実行する：
- str を
this value とする。 - ?
CreateHTML (str,"sub" ,"" ,"" ) を返す。
B.2.2.14 String.prototype.sup ( )
このメソッドは、呼び出されたとき次の手順を実行する：
- str を
this value とする。 - ?
CreateHTML (str,"sup" ,"" ,"" ) を返す。
B.2.2.15 String.prototype.trimLeft ( )
B.2.2.16 String.prototype.trimRight ( )
B.2.3 Date.prototype オブジェクトの追加プロパティ
B.2.3.1 Date.prototype.getYear ( )
getFullYear メソッドは、“year 2000 problem” を回避するため、ほぼすべての目的で推奨される。
このメソッドは、呼び出されたとき次の手順を実行する：
- dateObject を
this value とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - t を dateObject.[[DateValue]] とする。
- t が
NaN であれば、NaN を返す。 YearFromTime (LocalTime (t)) -1900 𝔽 を返す。
B.2.3.2 Date.prototype.setYear ( year )
setFullYear メソッドは、“year 2000 problem” を回避するため、ほぼすべての目的で推奨される。
このメソッドは、呼び出されたとき次の手順を実行する：
- dateObject を
this value とする。 - ?
RequireInternalSlot (dateObject, [[DateValue]]) を実行する。 - time を dateObject.[[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)) とする。 - dateObject.[[DateValue]] を utcTimestamp に設定する。
- utcTimestamp を返す。
B.2.3.3 Date.prototype.toGMTString ( )
toUTCString メソッドが推奨される。このメソッドは主に古いコードとの互換性のために提供される。
B.2.4 RegExp.prototype オブジェクトの追加プロパティ
B.2.4.1 RegExp.prototype.compile ( pattern, flags )
このメソッドは、呼び出されたとき次の手順を実行する：
- obj を
this value とする。 - ?
RequireInternalSlot (obj, [[RegExpMatcher]]) を実行する。 - pattern が Object であり、pattern が [[RegExpMatcher]] 内部スロットを持つならば、
- flags が
undefined でないならば、TypeError 例外を投げる。 - flags を pattern.[[OriginalFlags]] に設定する。
- pattern を pattern.[[OriginalSource]] に設定する。
- flags が
- ?
RegExpInitialize (obj, pattern, flags) を返す。
このメソッドは
B.3 その他の追加機能
B.3.1 ラベル付き Function Declaration
ECMAScript 2015 より前は、
B.3.2 ブロックレベル Function Declaration の Web レガシー互換性意味論
ECMAScript 2015 より前は、ECMAScript 仕様は
-
関数が宣言され、単一のブロック内でのみ参照される。
-
BindingIdentifier が名前 f である 1 つ以上のFunctionDeclaration が、包含関数 g の関数コード 内に現れ、その宣言がBlock 内にネストされている。 -
var宣言でない f の他の宣言が、g の関数コード 内に存在しない。 -
IdentifierReference としての f のすべての出現が、f の宣言を含むBlock のStatementList 内にある。
-
-
関数が宣言され、単一の
Block 内で使用される可能性があるが、その同じBlock 内に含まれていない内側の関数定義によっても参照される。-
BindingIdentifier が名前 f である 1 つ以上のFunctionDeclaration が、包含関数 g の関数コード 内に現れ、その宣言がBlock 内にネストされている。 -
var宣言でない f の他の宣言が、g の関数コード 内に存在しない。 -
IdentifierReference としての f の出現が、f の宣言を含むBlock のStatementList 内に存在してよい。 -
g 内にネストされた別の関数 h 内に、
IdentifierReference としての f の出現が少なくとも 1 つ存在し、h 内からの f への参照を shadow する f の他の宣言が存在しない。 - h のすべての呼び出しは、f の宣言が評価された後に発生する。
-
-
関数が宣言され、単一のブロック内で使用される可能性があるが、後続のブロック内でも参照される。
-
BindingIdentifier が名前 f である 1 つ以上のFunctionDeclaration が、包含関数 g の関数コード 内に現れ、その宣言がBlock 内にネストされている。 -
var宣言でない f の他の宣言が、g の関数コード 内に存在しない。 -
IdentifierReference としての f の出現が、f の宣言を含むBlock のStatementList 内に存在してよい。 -
f の宣言を含む
Block に字句的に後続する g の関数コード 内に、IdentifierReference としての f の出現が少なくとも 1 つ存在する。
-
最初のユースケースは、ECMAScript 2015 によって提供される
2 番目および 3 番目のユースケースについて ECMAScript 2015 との相互運用性を得るには、節
ECMAScript 実装が診断警告メッセージを報告する機構を持つ場合、これらの互換性意味論が適用され、非互換性意味論との差異が観測可能に導入される
この機能は、次の箇所で特別な意味論を伴う：
14.2.1 におけるBlock : { StatementList } early error 規則の 1 つ14.12.1 におけるSwitchStatement : switch ( Expression ) CaseBlock early error 規則の 1 つFunctionDeclarationInstantiation 内の step32.a BlockDeclarationInstantiation 内の step3.a.ii.1 BlockDeclarationInstantiation 内の step3.b.iii GlobalDeclarationInstantiation 内の step12 EvalDeclarationInstantiation 内の step13
B.3.3 IfStatement の Statement 節内の FunctionDeclaration
次は、
この生成規則は、非 strict コードを解析するときにのみ適用される。この生成規則に一致したソーステキストは、
B.3.4 Catch ブロック内の VariableStatement
この機能では、var 宣言を含んでよい。これは、
実行時、そのような binding は VariableDeclarationEnvironment 内でインスタンス化される。それらは var 宣言の var binding ではなく対応する catch parameter に代入する。
この変更された振る舞いは、var および function 宣言にも適用される。この変更は、
B.3.5 ForIn 文ヘッド内の Initializer
次は、
この生成規則は、非 strict コードを解析するときにのみ適用される。
- 引数 labelSet を伴う
Statement のContainsDuplicateLabels を返す。
- 引数 labelSet を伴う
Statement のContainsUndefinedBreakTarget を返す。
- 引数 iterationSet および « » を伴う
Statement のContainsUndefinedContinueTarget を返す。
false を返す。
- names1 を
BindingIdentifier のBoundNames とする。 - names2 を
Statement のVarDeclaredNames とする。 - names1 と names2 のリスト連結を返す。
- declarations1 を «
BindingIdentifier » とする。 - declarations2 を
Statement のVarScopedDeclarations とする。 - declarations1 と declarations2 のリスト連結を返す。
- bindingId を
BindingIdentifier のStringValue とする。 - lhs を ?
ResolveBinding (bindingId) とする。 IsAnonymousFunctionDefinition (Initializer ) がtrue ならば、- value を、引数 bindingId を伴う
Initializer のNamedEvaluation とする。
- value を、引数 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]] 内部スロット
[[IsHTMLDDA]] 内部スロットは、typeof 演算子
[[IsHTMLDDA]] 内部スロットを持つオブジェクトは、この仕様によって作成されることは決してない。しかし、web ブラウザーの document.all オブジェクトは、web 互換性のために存在する、このスロットを持つ document.all を除き、これを持つものを作成するべきではない。
この機能は、次の箇所で特別な意味論を伴う：
ToBoolean 内の step3 IsLooselyEqual 内の step4 typeofの評価意味論内の step12
B.3.7 HostMakeJobCallback における非既定の振る舞い
B.3.8 HostEnsureCanAddPrivateElement における非既定の振る舞い
B.3.9 関数呼び出し代入ターゲットに対する実行時エラー
非 strict コードにおいて関数呼び出し（
代入ターゲットが = または ??=、&&=、||=）には適用されない。
Annex C (informative) ECMAScript の strict mode
strict mode の制限と例外
-
implements、interface、let、package、private、protected、public、static、およびyieldは、strict mode コード内では予約語である（12.7.2 ）。 -
適合する実装は、strict mode コードを処理するとき、生成規則
NumericLiteral :: LegacyOctalIntegerLiteral DecimalIntegerLiteral :: NonOctalDecimalIntegerLiteral -
適合する実装は、strict mode コードを処理するとき、生成規則
EscapeSequence :: LegacyOctalEscapeSequence EscapeSequence :: NonOctalDecimalEscapeSequence -
宣言されていない識別子、またはその他の解決不能な参照への代入は、
グローバルオブジェクト 内にプロパティを作成しない。strict mode コード内で単純代入が発生する場合、そのLeftHandSideExpression は解決不能な Reference に評価されてはならない。そうなった場合、ReferenceError 例外が投げられる（6.2.5.6 ）。LeftHandSideExpression はまた、属性値 { [[Writable]]:false } を持つデータプロパティ、属性値 { [[Set]]:undefined } を持つアクセサプロパティ、または [[Extensible]] 内部スロットがfalse であるオブジェクトの存在しないプロパティへの参照であってもならない。これらの場合、TypeError例外が投げられる（13.15 ）。 -
StringValue が"eval" または"arguments" であるIdentifierReference は、代入演算子のLeftHandSideExpression （13.15 ）、UpdateExpression （13.4 ）、Prefix Increment 演算子（13.4.4 ）または Prefix Decrement 演算子（13.4.5 ）によって演算されるUnaryExpression として現れてはならない。 -
strict 関数の Arguments オブジェクトは、アクセス時に
TypeError 例外を投げる構成不可のアクセサプロパティ"callee" を定義する（10.4.4.6 ）。 -
strict 関数の Arguments オブジェクトは、その
array-indexed プロパティ値を、対応する関数の仮引数 binding と動的に共有しない（10.4.4 ）。 -
strict 関数では、arguments オブジェクトが作成される場合、ローカル識別子
argumentsの arguments オブジェクトへの binding は immutable であり、したがって代入式のターゲットになってはならない（10.2.11 ）。 -
strict mode コード内で
BindingIdentifier のStringValue が"eval" または"arguments" のいずれかである場合、それはSyntaxError である（13.1.1 ）。 -
strict mode
eval コード は、eval の呼び出し元の variable environment に変数または関数をインスタンス化できない。代わりに、新しい variable environment が作成され、その環境がeval コード の宣言 binding インスタンス化に使用される（19.2.1 ）。 -
strict mode コード内で
this が評価される場合、this 値はオブジェクトに強制変換されない。this 値がundefined またはnull のいずれかであってもグローバルオブジェクト に変換されず、primitive 値もラッパーオブジェクトに変換されない。関数呼び出し（Function.prototype.applyおよびFunction.prototype.callを使用して行われる呼び出しを含む）を介して渡されたthis 値は、渡されたthis 値をオブジェクトに強制変換しない（10.2.1.2 、20.2.3.1 、20.2.3.3 ）。 -
strict mode コード内で
delete演算子が発生する場合、そのUnaryExpression が変数、関数引数、または関数名への直接参照であれば、SyntaxError が投げられる（13.5.1.1 ）。 -
strict mode コード内で
delete演算子が発生する場合、削除されるプロパティが属性 { [[Configurable]]:false } を持つか、またはその他の理由で削除できないならば、TypeError が投げられる（13.5.1.2 ）。 -
strict mode コードは
WithStatement を含んではならない。そのような文脈でWithStatement が出現することはSyntaxError である（14.11.1 ）。 -
strict mode コード内で
CatchParameter が発生し、CatchParameter のBoundNames がevalまたはargumentsのいずれかを含む場合、それはSyntaxError である（14.15.1 ）。 -
strict 関数の
FormalParameters 内に同じBindingIdentifier が複数回現れる場合、それはSyntaxError である。Function、Generator、または AsyncFunction コンストラクターを使用してそのような関数を作成しようとするとSyntaxError になる（15.2.1 、20.2.1.1.1 ）。 -
実装は、この仕様で定義される範囲を超えて、strict 関数内の関数インスタンスの
"caller" または"arguments" という名前のプロパティの意味を拡張してはならない。
Annex D (informative) ホスト階層化ポイント
D.1 Host Hook
D.2 Host-defined フィールド
Script
Module
Candidate Execution 上の [[HostSynchronizesWith]]：
[[IsHTMLDDA]]：
D.3 Host-defined オブジェクト
D.4 Job の実行
D.5 Exotic Object の内部メソッド
この仕様内で指定されていない任意の
D.6 組込みオブジェクトおよびメソッド
Annex E (informative) 互換性に影響する可能性のある ECMAScript 2015 における訂正および明確化
Date.prototype.toString が返す値を指定していなかった。ECMAScript 2015 は、結果を String 値
/ のエスケープのみを要求していた。
global フラグの設定された RegExp 値である場合について、String.prototype.match および String.prototype.replace の仕様が誤っていた。以前の仕様では、パターンの各マッチ試行について、lastIndex が変化しなかった場合、1 増加すべきであると述べていた。正しい振る舞いは、パターンが空の String にマッチした場合に限り、lastIndex が 1 増加すべきであるというものである。
Array.prototype.sort によってどのように解釈されるかを指定していなかった。ECMAScript 2015 は、そのような値は comparator から
Annex F (informative) 以前の版との非互換性を導入する追加および変更
Space_Separator（Zs）カテゴリにあり whitespace として扱われていた U+180E MONGOLIAN VOWEL SEPARATOR が、（Unicode 6.3.0 時点で）Format（Cf）カテゴリへ移動された。これは whitespace-sensitive なメソッドの振る舞いを変える。例えば、"\u180E".trim().length は以前の版では 0 であったが、ECMAScript 2016 以降では 1 である。さらに、ECMAScript 2017 は常に Unicode Standard の最新版を使用することを義務付けた。
let に続いてトークン [ で始まる
( トークンの直後にトークンシーケンス let [ が続く場合、その let は
let [ が続く場合、その let は
in キーワードに先行する
var 宣言を含むことは
var または FunctionDeclaration 宣言を eval を評価する場合、実行時
Object.freeze への引数がオブジェクトでない場合、それは own property を持たない non-extensible な
Object.getOwnPropertyDescriptor への引数がオブジェクトでない場合、
Object.getOwnPropertyNames への引数がオブジェクトでない場合、
Object.getPrototypeOf への引数がオブジェクトでない場合、
Object.isExtensible への引数がオブジェクトでない場合、それは own property を持たない non-extensible な
Object.isFrozen への引数がオブジェクトでない場合、それは own property を持たない non-extensible な
Object.isSealed への引数がオブジェクトでない場合、それは own property を持たない non-extensible な
Object.keys への引数がオブジェクトでない場合、
Object.preventExtensions への引数がオブジェクトでない場合、それは own property を持たない non-extensible な
Object.seal への引数がオブジェクトでない場合、それは own property を持たない non-extensible な
String.prototype.localeCompare 関数は Unicode Standard に従って正準等価である String を同一として扱わなければならない。以前の版では、実装は正準等価性を無視し、代わりにビット単位の比較を使用することが許可されていた。
String.prototype.trim メソッドは Unicode BMP の外に存在し得る white space コードポイントを認識するように定義されている。ただし、Unicode 7 時点ではそのようなコードポイントは定義されていない。以前の版では、そのようなコードポイントは white space として認識されなかった。
Atomics.wait との混同を防ぐため、Atomics.wake は Atomics.notify に名称変更された。
await によってエンキューされる then() 呼び出しと await 式との間の解決順序に観測可能な差異が生じる可能性があった。
参考文献
-
IEEE 754-2019：IEEE Standard for Floating-Point Arithmetic。Institute of Electrical and Electronic Engineers, New York (2019)
Note IEEE 754-2008 と IEEE 754-2019 の間には、ECMA-262 仕様に影響する規範的変更は存在しない。
- The Unicode Standard、<https://unicode.org/versions/latest> で入手可能
- Unicode Technical Note #5: Canonical Equivalence in Applications、<https://unicode.org/notes/tn5/> で入手可能
- Unicode Technical Standard #10: Unicode Collation Algorithm、<https://unicode.org/reports/tr10/> で入手可能
- Unicode Standard Annex #15, Unicode Normalization Forms、<https://unicode.org/reports/tr15/> で入手可能
- Unicode Standard Annex #18: Unicode Regular Expressions、<https://unicode.org/reports/tr18/> で入手可能
-
Unicode Standard Annex #24: Unicode
ScriptProperty、<https://unicode.org/reports/tr24/> で入手可能 - Unicode Standard Annex #31, Unicode Identifiers and Pattern Syntax、<https://unicode.org/reports/tr31/> で入手可能
- Unicode Standard Annex #44: Unicode Character Database、<https://unicode.org/reports/tr44/> で入手可能
- Unicode Technical Standard #51: Unicode Emoji、<https://unicode.org/reports/tr51/> で入手可能
- IANA Time Zone Database、<https://www.iana.org/time-zones> で入手可能
- ISO 8601:2004(E) Data elements and interchange formats — Information interchange — Representation of dates and times
- RFC 1738 “Uniform Resource Locators (URL)”、<https://tools.ietf.org/html/rfc1738> で入手可能
- RFC 2396 “Uniform Resource Identifiers (URI): Generic Syntax”、<https://tools.ietf.org/html/rfc2396> で入手可能
- RFC 3629 “UTF-8, a transformation format of ISO 10646”、<https://tools.ietf.org/html/rfc3629> で入手可能
- RFC 7231 “Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content”、<https://tools.ietf.org/html/rfc7231> で入手可能
奥付
この仕様は、GitHub 上で、Ecmarkup と呼ばれる plaintext ソース形式により執筆されている。Ecmarkup は HTML および Markdown の方言であり、Ecma 仕様を plaintext で執筆し、その仕様をこの文書の編集上の慣例に従う高機能な HTML レンダリングへ処理するためのフレームワークおよびツールセットを提供する。Ecmarkup は、構文を定義するための Grammarkdown や、アルゴリズム手順を執筆するための Ecmarkdown を含む、いくつかの他の形式および技術の上に構築され、それらを統合している。この仕様の PDF レンダリングは、CSS Paged Media 仕様を活用する印刷スタイルシートを使用して生成され、PrinceXML を使用して変換される。
この仕様の以前の版は Word を使用して執筆されていた。この版の基礎となった Ecmarkup ソーステキストは、ECMAScript 2015 Word 文書を自動変換ツールで Ecmarkup に変換することによって生成された。
Copyright & Software License
Ecma International
Rue du Rhone 114
CH-1204 Geneva
Tel: +41 22 849 6000
Fax: +41 22 849 6001
Web: https://ecma-international.org/
Copyright Notice
ALTERNATIVE COPYRIGHT NOTICE AND COPYRIGHT LICENSE
© 2026 Ecma International
By obtaining and/or copying this work, you (the licensee) agree that you have read, understood, and will comply with the following terms and conditions.
Permission under Ecma’s copyright to copy, modify, prepare derivative works of, and distribute this work, with or without modification, for any purpose and without fee or royalty is hereby granted, provided that you include the following on ALL copies of the work or portions thereof, including modifications:
(i) The full text of this COPYRIGHT NOTICE AND COPYRIGHT LICENSE in a location viewable to users of the redistributed or derivative work.
(ii) Any pre-existing intellectual property disclaimers, notices, or terms and conditions. If none exist, the Ecma alternative copyright notice should be included.
(iii) Notice of any changes or modifications, through a copyright statement on
the document such as “This document includes material copied from or
derived from ECMAScript® 2027 Language Specification 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.