制御フレーム API

controlledframe 要素 element が、非 null の 閲覧コンテキストを持つ文書に 挿入されたとき、 次の手順を実行する:

1. element の src が空でない場合:

   1. element を与えて controlledframe を初期化する。

controlledframe 要素 element が文書から 削除されたとき、 次の手順を実行する:

1. element の 埋め込まれた navigableを与えて、 トップレベル traversable を破棄する。

2. element の 埋め込まれた navigableを null に設定する。

controlledframe 要素 element を 初期化するには、 次の手順を実行する:

1. element の 埋め込まれた navigableが null であることを 表明する。

2. group を新しい 閲覧コンテキストグループとする。

3. document を、element の ノード文書、element、 および group を与えて、 新しい閲覧コンテキストと 文書を作成することの第 2 戻り値とする。

4. documentState を新しい 文書状態とし、その 文書 は document である。

5. traversable を新しい traversable navigable とする。

6. documentState を与えて、traversable navigable を初期化する。

7. traversable の controlledFrameEmbedderParent を element に設定する。

8. element の 埋め込まれた navigableを traversable に設定する。

9. initialHistoryEntry を traversable の アクティブセッション履歴エントリとする。

10. initialHistoryEntry の step を 0 に設定する。

11. initialHistoryEntry を traversable の セッション履歴エントリに 付加する。

    これらの手順は、 新しい navigable 内の History.length を初期化するために必要である。これは HTML Standard に存在する issue である。

12. element の contentWindow を document の WindowProxy に設定する。

13. element および element の src を与えて、controlledframe をナビゲートする。

controlledframe 要素 element を、USVString urlString を与えて ナビゲートするには、 次の手順を実行する:

1. urlString が 絶対 URL 文字列でない場合、戻る。

2. url を、urlString および element の ノード文書を与えて URL を構文解析する結果とする。

3. historyHandling を "auto" とする。

4. element の 埋め込まれた navigable の アクティブ文書が 完全に読み込まれていない場合、historyHandling を "replace" に設定する。

5. element の 埋め込まれた navigableを url に ナビゲートする。その際、element の ノード文書を使用し、NavigationHistoryBehavior として historyHandling を用いる。

HTMLControlledFrameElement() コンストラクタ手順は次の通りである:

1. this の request を、新しい WebRequest に設定する。

2. this の contextMenus を、新しい ContextMenus に設定する。

controlledframe controlledframe、promise promise、および省略可能な value を与えて、 埋め込み元 promise を解決するには、 次の手順を実行する:

1. controlledframe の 関連グローバルオブジェクトの DOM 操作タスクソースに グローバルタスクをキューに入れ、 promise を value で 解決する。

   注: controlledframe の 関連グローバルオブジェクトは 埋め込み元の Window オブジェクトである。

controlledframe controlledframe、promise promise、および省略可能な value を与えて、 埋め込み元 promise を拒否するには、 次の手順を実行する:

1. controlledframe の 関連グローバルオブジェクトの DOM 操作タスクソースに グローバルタスクをキューに入れ、 promise を value で 拒否する。

   注: controlledframe の 関連グローバルオブジェクトは 埋め込み元の Window オブジェクトである。

URL url が pattern である URLPattern に一致するとは、 次の手順が true を返すことである:

1. result を、pattern および url を与えて match した結果とする。

2. result が null の場合、false を返す。

3. true を返す。

partition IDL 属性 setter 手順は次の通りである:

1. this の 埋め込まれた navigable が null でない場合:

   1. "NotSupportedError" DOMException を投げる。

2. this の partition を与えられた値に設定する。

src IDL 属性 setter 手順は次の通りである:

1. this が文書 ツリー内にない場合、戻る。

2. this の 埋め込まれた navigable が null の場合:

   1. this を与えて、 controlledframe を初期化する。

3. それ以外の場合:

   1. this および与えられた値を与えて、 controlledframe をナビゲートする。

controlledframe controlledframe と整数 delta を与えて、 埋め込まれた navigable の履歴を delta traverse するには、 次の手順を実行する:

1. resultPromise を新しい promise とする。

2. resultPromise を返し、残りの手順を 並列に実行する。

3. embeddedNavigable を controlledframe の 埋め込まれた navigable とする。

4. embeddedNavigable が null の場合、 controlledframe、resultPromise、および false を与えて 埋め込み元 promise を解決し、 これらの手順を中止する。

5. embeddedNavigable の アクティブ文書が完全にアクティブでない場合、 controlledframe、resultPromise、 および false を与えて 埋め込み元 promise を解決し、 これらの手順を中止する。

6. 次のセッション履歴探索手順を embeddedNavigable に 付加する:

   1. allSteps を、embeddedNavigable について 使用済みのすべての履歴ステップを取得する結果とする。

   2. currentStepIndex を、allSteps 内における embeddedNavigable の 現在のセッション履歴ステップのインデックスとする。

   3. targetStepIndex を currentStepIndex + delta とする。

   4. allSteps[targetStepIndex] が 存在しない場合、 controlledframe、resultPromise、 および false を与えて 埋め込み元 promise を解決し、 これらの手順を中止する。

   5. result を、allSteps[targetStepIndex] を embeddedNavigable に適用する traverse history step を適用する結果とし、 その際 ユーザーナビゲーション関与として "none" を与える。

   6. result が "applied" と等しくない場合、 controlledframe、resultPromise、および false を与えて 埋め込み元 promise を解決する。

   7. それ以外の場合、controlledframe、 resultPromise、および true を与えて 埋め込み元 promise を解決する。

canGoBack() メソッド手順は次の通りである:

1. result を新しい promise とする。

2. controlledframe を this とする。

3. embeddedNavigable を controlledframe の 埋め込まれた navigable とする。

4. embeddedNavigable が null の場合、result を false で 解決し、 result を返す。

5. embeddedNavigable の ノード文書の 関連グローバルオブジェクトの ナビゲーションおよび探索タスクソースに グローバルタスクをキューに入れ、 次の手順を実行させる:

   1. canGoBack を、embeddedNavigable の 現在のセッション履歴ステップが > 0 の場合は true、そうでない場合は false とする。

   2. controlledframe、result、 および canGoBack を与えて 埋め込み元 promise を解決する。

6. result を返す。

canGoForward() メソッド手順は次の通りである:

1. result を新しい promise とする。

2. controlledframe を this とする。

3. embeddedNavigable を controlledframe の 埋め込まれた navigable とする。

4. embeddedNavigable が null の場合、result を false で 解決し、 result を返す。

5. embeddedNavigable の ノード文書の 関連グローバルオブジェクトの ナビゲーションおよび探索タスクソースに グローバルタスクをキューに入れ、 次の手順を実行させる:

   1. step を embeddedNavigable の 現在のセッション履歴ステップとする。

   2. steps を、embeddedNavigable を与えて 使用済みのすべての履歴ステップを取得する 結果とする。

   3. canGoForward を、step + 1 < steps の サイズの場合は true、 そうでない場合は false とする。

   4. controlledframe、result、 および canGoForward を与えて 埋め込み元 promise を解決する。

6. result を返す。

back() メソッド手順は 次の通りである:

1. this および -1 を与えて、 埋め込まれた navigable の履歴を delta traverse する結果を返す。

forward() メソッド手順 は次の通りである:

1. this および 1 を与えて、 埋め込まれた navigable の履歴を delta traverse する結果を返す。

go(relativeIndex) メソッド手順は次の通りである:

1. this および relativeIndex を与えて、 埋め込まれた navigable の履歴を delta traverse する結果を返す。

reload() 手順は次の通りである:

1. embeddedNavigable を this の 埋め込まれた navigable とする。

2. embeddedNavigable が null の場合、戻る。

3. embeddedNavigable の ノード文書の 関連グローバルオブジェクトの ナビゲーションおよび探索タスクソースに グローバルタスクをキューに入れ、 "none" の ユーザーナビゲーション関与を与えて embeddedNavigable を 再読み込みさせる。

stop() 手順は次の通りである:

1. embeddedNavigable を this の 埋め込まれた navigable とする。

2. embeddedNavigable が null の場合、戻る。

3. embeddedNavigable の ノード文書の 関連グローバルオブジェクトの ナビゲーションおよび探索タスクソースに グローバルタスクをキューに入れ、 embeddedNavigable の 読み込みを停止させる。

// One of |code| or |file| must be specified but not both.
dictionary InjectDetails {
  DOMString code;
  USVString file;
};

dictionary InjectionItems {
  DOMString code;
  sequence<USVString> files;
};

enum RunAt {
  "document-start",
  "document-end",
  "document-idle",
};

dictionary ContentScriptDetails {
  required DOMString name;
  InjectionItems js;
  InjectionItems css;
  required sequence<(URLPattern or URLPatternInput)> urlPatterns;
  sequence<(URLPattern or URLPatternInput)> excludeURLPatterns;
  boolean allFrames;
  boolean matchAboutBlank;
  RunAt runAt;
};

controlledframe controlledframe、USVString urlString、boolean isCss、 long index、および long、 boolean、 DOMString を取るアルゴリズム completionSteps を与えて、 注入項目を取得するには、 次の手順を実行する:

注: ここでは クラシックスクリプトを取得するは使用できない。取得では controlledframe の 関連設定オブジェクトを使用する必要があるが、 クラシックスクリプトは、埋め込まれた navigable の アクティブ文書の 関連設定オブジェクトを使用して実行されるためである。

1. urlString が妥当な URL 文字列でない場合:

   1. 0、false、および "" を与えて completionSteps を実行する。

   2. 戻る。

2. request を、次のフィールドを持つ新しい request とする:

   URL

   urlString および controlledframe の ノード文書を与えて URL を構文解析する結果。

   method

   "GET"

   destination

   isCss が true の場合は "style"、 それ以外の場合は "script"

   client

   controlledframe の関連設定オブジェクト

   mode

   "cors"

3. request を取得し、processResponseConsumeBody を、 response response と、null、failure、または バイト列 contents を与えられた次の手順に設定する:

   1. response のstatus が 200 でない、または contents が null または failure である場合、0、false、および "" を与えて completionSteps を実行する

   2. それ以外の場合、index、true、および contents を与えて completionSteps を実行する。

controlledframe controlledframe および ContentScriptDetails details を与えて、 検証して ContentScriptDetails を解決するには、 次の手順を実行する:

1. result を新しい promise とする。

2. details["js"] および details["css"] が両方とも定義されている、または両方とも undefined である場合、result を TypeError で拒否し、それを返す。

3. details["urlPatterns"] が空である場合、 result を TypeError で拒否し、それを返す。

4. isCss を、details["css"] が定義されている場合は true、 それ以外の場合は false に等しい boolean とする。

5. isCss が true であり、かつ details["runAt"] が "document-start" と等しくない場合、result を TypeError で拒否し、それを返す。

6. injectionItems を、isCss が true の場合は details["css"]、 それ以外の場合は details["js"] とする。

7. injectionItems["code"] および injectionItems["files"] が両方とも定義されている、または両方とも undefined である場合、result を TypeError で拒否し、それを返す。

8. result を返し、残りの手順を 並列に実行する。

9. config を、次の値を持つ新しい content script config とする:

   pendingFetchCount

   0

   urlPatterns

   «»

   excludeURLPatterns

   «»

   allFrames

   details["allFrames"] が定義されている場合はそれ、そうでない場合は false

   matchAboutBlank

   details["matchAboutBlank"] が定義されている場合はそれ、 そうでない場合は false

   runAt

   details["runAt"] が定義されている場合はそれ、そうでない場合は document-idle

10. details["urlPatterns"] 内の各 urlPattern について 反復する:

    1. urlPattern が URLPattern である場合、urlPattern を config の urlPatterns に 付加する。

    2. それ以外の場合、urlPattern を与えて 新しい URLPattern を作成し、 config の urlPatterns に 付加する。

11. details["excludeURLPatterns"] が定義されている場合:

    1. details["excludeURLPatterns"] 内の各 urlPattern について 反復する:

       1. urlPattern が URLPattern である場合、 urlPattern を config の excludeURLPatterns に 付加する。

       2. それ以外の場合、 urlPattern を与えて 新しい URLPattern を作成し、config の excludeURLPatterns に 付加する。

12. completionSteps を、long index、boolean success、および DOMString source を取る次のアルゴリズムとする:

    1. success が false の場合、controlledframe、 result、および TypeError を与えて 埋め込み元 promise を拒否し、 これらの手順を中止する。

    2. isCss の場合:

       1. config の css[index] を source に設定する。

    3. それ以外の場合:

       1. config の js[index] を source に設定する。

    4. config の pendingFetchCount をデクリメントする。

    5. config の pendingFetchCount が 0 より 大きい場合、戻る。

    6. controlledframe の content script map[details[name]] を config に設定する。

    7. controlledframe および result を与えて 埋め込み元 promise を解決する。

13. injectionItems["code"] が定義されている場合:

    1. 0、true、および injectionItems ["code"] を与えて completionSteps を実行する。

14. それ以外の場合:

    1. injectionItems["files"] が空である場合、 controlledframe、result、 および TypeError を与えて 埋め込み元 promise を拒否し、 これらの手順を中止する。

    2. injectionItems ["files"] の各 urlString について 反復する:

       1. controlledframe、 urlString、isCss、config の pendingFetchCount、 および completionSteps を与えて、注入項目を取得するを実行する。

       2. config の pendingFetchCount をインクリメントする。

content script config config、URL url、および boolean isTopLevel を与えて、content script config が文書に適用されるかどうかを判定するには、 次の手順を実行する:

1. isTopLevel が false であり、かつ config の allFrames が false である場合、 false を返す。

2. url が about:blank に一致する、かつ config の matchAboutBlank が false である場合、false を返す。

3. urlString を、url を 直列化する結果とする。

4. match を false とする。

5. config の urlPatterns の各 pattern について 反復する:

   1. urlString が pattern である URLPattern に一致する場合、 match を true に設定する。

6. config の excludeURLPatterns の各 pattern について 反復する:

   1. urlString が pattern である URLPattern に一致する場合、 match を false に設定する。

7. match を返す。

Document document および RunAt currentPhase を与えて、 コンテンツスクリプトを文書に注入するには、 次の手順を実行する:

1. embeddedNavigable を、document の node navigable の traversable navigable とする。

2. embeddedNavigable が null、またはその controlledFrameEmbedderParent が null である場合、 戻る。

3. controlledframe を embeddedNavigable の controlledFrameEmbedderParent とする。

4. url を document の URL とする。

5. isTopLevel を、document の node navigable の parent が null である場合は true、 それ以外の場合は false とする。

6. controlledframe の content script map の各 config について反復する:

   1. config、url、および isTopLevel を与えて、content script config が 文書に適用されるかどうかを判定した結果が false と等しい場合、 続行する。

   2. currentPhase が document-start と等しく、かつ config の css が空でない場合:

      1. config の css の各 styleSource について 反復し、document および styleSource を与えて スタイルシートを文書に注入するを実行する。

   3. それ以外で、currentPhase が config の runAt と等しい場合:

      1. config の js の各 scriptSource について 反復し、document、scriptSource、および空の アルゴリズムを与えて スクリプトを文書に注入するを実行する。

Document document および DOMString styleSource を与えて、 スタイルシートを文書に注入するには、 次の手順を実行する:

1. styleSheet を新しい CSS スタイルシートオブジェクトとする。

2. styleSheet および styleSource を与えて CSSStyleSheet の規則を同期的に置換する。

3. document のグローバルオブジェクトの DOM 操作タスクソースに グローバルタスクをキューに入れ、 document および styleSheet を与えて CSS スタイルシートを追加する。

Document document、 DOMString scriptSource、および 完了レコードを取るアルゴリズム completionSteps を与えて、 スクリプトを 文書に注入するには、次の手順を実行する:

注: document.currentScript は、 scriptSource の実行中に意図的に設定されない。

1. script を、scriptSource、document の 関連設定オブジェクト、document の URL、および 既定のスクリプト取得オプションを与えて クラシックスクリプトを作成する結果とする。

2. document の グローバルオブジェクトの DOM 操作タスクソースに グローバルタスクをキューに入れ、 次の手順を実行させる:

   1. completionRecord を、 script を与えて クラシックスクリプトを実行する結果とする。

   2. controlledframe を、document の node navigable の traversable navigable の controlledFrameEmbedderParent とする。

   3. controlledframe の 関連グローバルオブジェクトの DOM 操作タスクソースに グローバルタスクをキューに入れ、 completionRecord を用いて completionSteps を実行させる。

addContentScripts(contentScriptList) メソッド手順は次の通りである:

1. contentScriptList が空である場合、 TypeError で拒否された 新しい promise を返す。

2. promises を空の リストとする。

3. contentScriptList 内の各 contentScript について 反復する:

   1. promise を、contentScript を与えて ContentScriptDetails を検証して解決するを呼び出した結果とする。

   2. promise を promises に 付加する。

4. promises を与えて すべての promise を待つための promise を取得する結果を返す。

removeContentScripts(scriptNameList) メソッド手順は次の通りである:

1. result を新しい promise とする。

2. controlledframe を this とする。

3. result を返し、残りの手順を 並列に実行する。

4. scriptNameList が undefined の場合:

   1. controlledframe の content script map を クリアする。

5. それ以外の場合、scriptNameList の各 name について 反復する:

   1. controlledframe の content script map[name] を 削除する。

6. controlledframe および result を与えて 埋め込み元 promise を解決する。

executeScript(details) メソッド手順は次の通りである:

1. result を新しい promise とする。

2. controlledframe を this とする。

3. result を返し、残りの手順を 並列に実行する。

4. controlledframe の 埋め込まれた navigable が null である場合、 controlledframe、result、および TypeError を与えて 埋め込み元 promise を拒否し、 これらの手順を中止する。

5. details["code"] および details"[file"] が両方とも定義されている、または両方とも undefined である場合、controlledframe、 result、および TypeError を与えて 埋め込み元 promise を拒否し、 これらの手順を中止する。

6. executionSteps を、long および DOMString または boolean scriptString を取る次のアルゴリズムとする:

   1. scriptString が DOMString でない場合、controlledframe、result、および TypeError を与えて 埋め込み元 promise を拒否し、 これらの手順を中止する。

   2. document を、controlledframe の 埋め込まれた navigable の アクティブ文書とする。

   3. document、scriptString、 および 完了レコード completionRecord を受け取る次のアルゴリズムを与えて、 スクリプトを文書に注入する:

      1. completionRecord が通常完了である場合:

         1. controlledframe、 result、および completionRecord.[[Value]] を与えて 埋め込み元 promise を解決する。

      2. それ以外の場合:

         1. controlledframe、 result、および completionRecord.[[Value]] を与えて 埋め込み元 promise を拒否する。

7. details["code"] が定義されている場合、0 および details["code"] を与えて executionSteps を実行する。

8. それ以外の場合、controlledframe、 details["file"]、 false、0、および executionSteps を与えて 注入項目を取得する。

insertCSS(details) メソッド手順は次の通りである:

1. result を新しい promise とする。

2. controlledframe を this とする。

3. result を返し、残りの手順を 並列に実行する。

4. controlledframe の 埋め込まれた navigable が null である場合、 controlledframe、result、および TypeError を与えて 埋め込み元 promise を拒否し、 これらの手順を中止する。

5. details["code"] および details["file"] が両方とも定義されている、または両方とも undefined である場合、controlledframe、 result、および TypeError を与えて 埋め込み元 promise を拒否し、 これらの手順を中止する。

6. executionSteps を、long、 boolean success、および DOMString styleString を取る次のアルゴリズムとする:

   1. success が false の場合、controlledframe、 result、および TypeError を与えて 埋め込み元 promise を拒否し、 これらの手順を中止する。

   2. document を、controlledframe の 埋め込まれた navigable の アクティブ文書とする。

   3. document および styleString を与えて スタイルシートを文書に注入する。

   4. controlledframe および result を与えて 埋め込み元 promise を解決する。

7. details["code"] が定義されている場合、0、true、および details["code"] を与えて executionSteps を実行する。

8. それ以外の場合、controlledframe、 details["file"]、 false、0、および executionSteps を与えて 注入項目を取得する。

dictionary ClearDataOptions {
  long since;
};

dictionary ClearDataTypeSet {
  boolean cache;
  boolean cookies;
  boolean fileSystems;
  boolean indexedDB;
  boolean localStorage;
  boolean persistentCookies;
  boolean sessionCookies;
};

ストレージバケット bucket、 ストレージ識別子 identifier、および long since を与えて、 ストレージボトルを空にするには、次の手順を実行する:

注: 可能であれば、ユーザーエージェントは、 since 以後に最後に使用されたデータのみを削除すべきである。since は epoch からのミリ秒単位のタイムスタンプを表す。 すべてのユーザーエージェントが、すべての 閲覧データについて書き込み時刻またはアクセス時刻を追跡しているわけではない。 実装は可能な限り since を尊重すべきであるが、この API はその利用可能性を保証しない。

1. bottle を bucket[identifier] とする。

2. bottle の map を クリアする。

3. bottle の proxy map reference set を新しい 集合に設定する。

clearData(options, types) メソッド手順は次の通りである:

1. resultPromise を新しい promise とする。

2. controlledframe を this とする。

3. resultPromise を返し、残りの手順を 並列に実行する。

4. clearSince を 0 とする。

5. options["since"] が定義されている場合、clearSince を options|["since"] に設定する。

6. embeddingOrigin を、controlledframe の 関連設定オブジェクトの トップレベルオリジンとする。

7. partition を controlledframe の partition とする。

8. ユーザーエージェントの storage shed の各 storageKey → shelf について 反復する:

   1. storageKey の embedding origin が embeddingOrigin と等しくない、または storageKey の partition が partition と等しくない場合、 続行する。

   2. bucket を shelf["default"] とする。

   3. types["fileSystems"] が true である場合:

      1. bucket、"fileSystem"、および clearSince を与えて ストレージボトルを空にする。

   4. types["indexedDB"] が true である場合:

      1. bucket、"indexedDB"、および clearSince を与えて ストレージボトルを空にする。

   5. types["localStorage"] が true である場合:

      1. bucket、"localStorage"、および clearSince を与えて ストレージボトルを空にする。

9. types["cookies"]、 types["persistentCookies"]、 または types["sessionCookies"] が true である場合:

   [COOKIES] 仕様は、 storage key のような仕組みによる cookies のパーティション化をサポートしていない。次の手順はすべての cookies を クリアするが、意図としては、この Controlled Frame の現在の partition を持つ Controlled Frame 内のコンテンツによって作成された cookies のみを削除することである。

   1. ユーザーエージェントの cookie store 内の各 cookie について 反復する:

      1. cookie の persistent-flag が設定されている場合:

         1. types["cookies"] および types["persistentCookies"] が false である場合、 続行する。

      2. それ以外の場合:

         1. types["cookies"] および types["sessionCookies"] が false である場合、 続行する。

      3. cookie の last-access-time が epoch からのミリ秒として表された値が clearSince より小さい場合、続行する。

      4. cookie をユーザーエージェントの cookie store から削除する。

10. types["cache"] が true である場合:

    1. ユーザーエージェントが管理する各 storageKey → cache について反復する: [HTTP-CACHING]

       1. storageKey の embedding origin が embeddingOrigin と等しくない、または storageKey の partition が partition と等しくない場合、続行する。

       2. cache をクリアする。

11. controlledframe および resultPromise を与えて 埋め込み元 promise を解決する。

getAudioState() メソッド手順は次の通りである:

1. resultPromise を新しい promise とする。

2. controlledframe を this とする。

3. resultPromise を返し、残りの手順を 並列に実行する。

4. controlledframe の 埋め込まれた navigable が null である場合、 controlledframe、resultPromise、および TypeError を与えて 埋め込み元 promise を拒否し、 これらの手順を中止する。

5. playingAudio を、controlledframe の 埋め込まれた navigable 内の、入れ子のフレームを含む任意のコンテンツが 現在オーディオを再生している場合は true、 そうでない場合は false とする。

6. controlledframe、resultPromise、 および playingAudio を与えて 埋め込み元 promise を解決する。

isAudioMuted() メソッド手順は次の通りである:

1. resultPromise を新しい promise とする。

2. controlledframe を this とする。

3. resultPromise を返し、残りの手順を 並列に実行する。

4. controlledframe の 埋め込まれた navigable が null である場合、 controlledframe、resultPromise、および TypeError を与えて 埋め込み元 promise を拒否し、 これらの手順を中止する。

5. controlledframe、resultPromise、 および controlledframe の 埋め込まれた navigable の muted フラグを与えて 埋め込み元 promise を解決する。

setAudioMuted(mute) メソッド手順は次の通りである:

1. this の 埋め込まれた navigable が null である場合、 TypeError を投げる。

2. this の 埋め込まれた navigable の muted フラグを mute に設定する。

enum ZoomMode {
  "per-origin",
  "per-view",
  "disabled"
};

HTMLControlledFrameElement e を与えて、 per-origin ズームレベルを取得するには、次の手順を実行する:

1. result を、初期値が 1.0f に設定された float とする。

2. key を、e の 埋め込まれた navigable の アクティブ文書の 現在の設定オブジェクトに関連付けられた 環境を与えて Controlled Frame storage key を取得する結果とする。

3. Controlled Frame zoom map[key] が 存在する場合、result を、キー key を与えて Controlled Frame zoom map の 値を取得する結果に設定する。

4. result を返す。

HTMLControlledFrameElement e および float zoomLevel を与えて、 per-origin ズームレベルを設定するには、次の手順を実行する:

1. key を、e の 埋め込まれた navigable の アクティブ文書の 現在の設定オブジェクトに関連付けられた 環境を与えて Controlled Frame storage key を取得する結果とする。

2. キー key と値 zoomLevel を与えて、Controlled Frame zoom map の 値を設定する。

HTMLControlledFrameElement e を与えて、 現在の文書が per-origin ズーム レベルを持つかどうかを判定するには、次の手順を実行する:

1. key を、e の 埋め込まれた navigable の アクティブ文書の 現在の設定オブジェクトに関連付けられた 環境を与えて Controlled Frame storage key を取得する結果とする。

2. Controlled Frame zoom map[key] が 存在する場合、true を返す。

3. false を返す。

getZoomMode() メソッド 手順は次の通りである:

1. p を 新しい promise とする。

2. controlledframe を this とする。

3. p を返し、残りの手順を 並列に実行する。

4. controlledframe、p、および controlledframe の zoomMode を与えて 埋め込み元 promise を解決する。

setZoomMode(zoomMode) メソッド手順は次の通りである:

1. p を 新しい promise とする。

2. controlledframe を this とする。

3. p を返し、残りの手順を 並列に実行する。

4. currentZoomMode を、controlledframe を与えて getZoomMode した結果とする。

5. currentZoomMode が zoomMode と等しい場合、 controlledframe および p を与えて 埋め込み元 promise を解決する。

6. controlledframe の zoomMode を zoomMode に設定する。

7. zoomMode が per-origin である場合:

   1. controlledframe を与えて、現在の文書が per-origin ズームレベルを持つが true である場合:

      1. oldZoomFactor を controlledframe の currentZoom とする。

      2. controlledframe の currentZoom を、 controlledframe を与えて per-origin ズームレベルを取得する結果に設定する。

      3. oldZoomFactor が controlledframe の currentZoom と等しくない場合:

         1. controlledframe の currentZoom を与えて、 controlledframe の埋め込まれた文書に ズームレベルを適用する。

         2. controlledframe、oldZoomFactor、 controlledframe の currentZoom を用いて "zoomchange" イベントを発火する。

8. zoomMode が disabled である場合:

   1. oldZoomFactor を controlledframe の currentZoom とする。

   2. controlledframe の currentZoom を 1.0f に設定する。

   3. oldZoomFactor が controlledframe の currentZoom と等しくない場合:

      1. controlledframe の currentZoom を与えて、 controlledframe の埋め込まれた文書に ズームレベルを適用する。

      2. controlledframe、oldZoomFactor、 controlledframe の currentZoom を用いて "zoomchange" イベントを発火する。

9. controlledframe および p を与えて 埋め込み元 promise を解決する。

getZoom() メソッド手順 は次の通りである:

1. p を 新しい promise とする。

2. controlledframe を this とする。

3. p を返し、残りの手順を 並列に実行する。

4. embeddedNavigable を controlledframe の 埋め込まれた navigable とする。

5. embeddedNavigable が null である場合、 controlledframe、p、および TypeError を与えて 埋め込み元 promise を拒否し、 これらの手順を中止する。

6. controlledframe、p、および controlledframe の currentZoom を与えて 埋め込み元 promise を解決する。

setZoom(zoomFactor) メソッド 手順は次の通りである:

1. p を 新しい promise とする。

2. controlledframe を this とする。

3. p を返し、残りの手順を 並列に実行する。

4. embeddedNavigable を controlledframe の 埋め込まれた navigable とする。

5. embeddedNavigable が null である場合、 controlledframe、p、および TypeError を与えて 埋め込み元 promise を拒否し、 これらの手順を中止する。

6. controlledframe の ZoomMode が disabled である場合:

   1. controlledframe、p、および TypeError を与えて 埋め込み元 promise を拒否し、 これらの手順を中止する。

7. controlledframe の ZoomMode が per-origin である場合:

   1. oldZoomFactor を controlledframe の currentZoom とする。

   2. controlledframe および zoomFactor を与えて per-origin ズームレベルを設定する。

   3. ユーザーエージェントの 閲覧コンテキストグループ集合内の各 閲覧コンテキストグループ group について 反復する:

      1. group 内の各 トップレベル閲覧コンテキスト browsingContext について 反復する:

         1. embeddedDocument を browsingContext の アクティブ文書とする。

         2. embedder を embeddedDocument の node navigable の controlledFrameEmbedderParent とする。

         3. embedder が null である場合、続行する。

         4. match を、次の条件がすべて true である場合は true とする:

            • embedder の ZoomMode が per-origin である

            • embedder の partition が controlledframe の partition と等しい

            • embeddedDocument の オリジン が controlledframe の 埋め込まれた navigable の アクティブ文書の オリジン と等しい

            • embedder の currentZoom が zoomFactor と等しくない

         5. match が true である場合:

            1. embedder の currentZoom を zoomFactor に設定する。

            2. zoomFactor を与えて embeddedDocument に ズームレベルを適用する。

            3. embedder、 oldZoomFactor、および zoomFactor を用いて "zoomchange" イベントを発火する。

8. controlledframe の ZoomMode が per-view である場合:

   1. oldZoomFactor を controlledframe の currentZoom とする。

   2. controlledframe の currentZoom を zoomFactor に設定する。

   3. oldZoomFactor が controlledframe の currentZoom と等しくない場合:

      1. controlledframe の currentZoom を与えて controlledframe の埋め込まれた文書に ズームレベルを適用する。

      2. controlledframe、 oldZoomFactor、controlledframe の currentZoom を用いて "zoomchange" イベントを発火する。

9. controlledframe および p を与えて 埋め込み元 promise を解決する。

// One of |code| or |file| must be specified but not both.
dictionary ImageDetails {
  DOMString format;
  DOMString quality;
};

captureVisibleRegion(options) メソッド手順は次の通りである:

1. resultPromise を新しい promise とする。

2. controlledframe を this とする。

3. resultPromise を返し、残りの手順を 並列に実行する。

4. controlledframe の 埋め込まれた navigable が null である場合、 controlledframe、resultPromise、および TypeError を与えて 埋め込み元 promise を拒否し、 これらの手順を中止する。

5. optionsFormat を既定で "JPEG" とする。

6. optionsQuality を既定で 100 とする。

7. options にフィールド "format" がある場合:

   1. optionsFormat を options["format"] とする。

8. optionsFormat が認識されない形式である場合、 controlledframe、resultPromise、および TypeError を与えて埋め込み元 promise を拒否し、これらの手順を中止する。

9. options にフィールド "quality" がある場合:

   1. optionsQuality を options["quality"] とする。

10. optionsQuality が整数でない、または 0 以上 100 以下でない場合、 controlledframe、 resultPromise、および TypeError を与えて埋め込み元 promise を拒否し、 これらの手順を中止する。

11. imageData を、埋め込まれたコンテンツの可視領域を示す画像であり、 optionsFormat で、品質 optionsQuality でエンコードされたものとする。

    注: サポートされる画像形式の集合は 実装定義であるが、少なくとも "JPEG" および "PNG" をサポートすることが推奨される。

12. controlledframe、resultPromise、 および imageData を含む data: URL を与えて 埋め込み元 promise を解決する。

print() メソッド手順は次の通りである:

1. this の 埋め込まれた navigable が null である場合、 TypeError を投げる。

2. 埋め込まれたコンテンツに対してブラウザのページ印刷機能を開始する。

[Exposed=Window, IsolatedContext]
interface ConsoleMessage {
  readonly attribute long level;
  readonly attribute DOMString message;
};

[Exposed=Window, IsolatedContext]
interface ConsoleMessageEvent : Event {
  constructor(DOMString type, optional ConsoleMessageEventInit eventInitDict = {});
  readonly attribute ConsoleMessage consoleMessage;
};

dictionary ConsoleMessageEventInit: EventInit {
  ConsoleMessage? consoleMessage;
};

controlledframe 要素 target、long logLevel、および DOMString message を与えて、 ConsoleMessageEvent を発火する には、次の手順を実行する:

1. consoleMessage を新しい ConsoleMessage オブジェクトとする。

2. consoleMessage の次のフィールドを設定する:

   level

   logLevel。

   message

   message。

3. e の consoleMessage を consoleMessage に設定する。

4. target の 関連グローバルオブジェクトの DOM 操作タスクソースに グローバルタスクをキューに入れ、target に e をdispatch させる。

enum DialogType {
  "alert",
  "confirm",
  "prompt"
};

[Exposed=Window, IsolatedContext]
interface DialogController {
  undefined okay(optional DOMString response);
  undefined cancel();
};

[Exposed=Window, IsolatedContext]
interface DialogMessage {
  readonly attribute DialogType messageType;
  readonly attribute DOMString messageText;
  readonly attribute DialogController dialog;
};

[Exposed=Window, IsolatedContext]
interface DialogEvent : Event {
  constructor(DOMString type, optional DialogEventInit eventInitDict = {});
  readonly attribute DialogMessage dialogMessage;
};

dictionary DialogEventInit: EventInit {
  DialogMessage? dialogMessage;
};

controlledframe 要素 target、simple-dialogs 型 dialogType、および メッセージ message を与えて、 DialogEvent を発火する には、次の手順を実行する:

1. e["dialogMessage"]["dialog"]["accept"] が false と等しいことを表明する。

2. dialogMessage を新しい DialogMessage オブジェクトとする。

3. dialog を新しい DialogController オブジェクトとする。

4. dialogMessage の次のフィールドを設定する:

   messageType

   dialogType。

   messageText

   message。

   dialog

   dialog。

5. e の dialogMessage を dialogMessage に設定する。

6. complete を false とする。

7. target の 関連グローバルオブジェクトの DOM 操作タスクソースに グローバルタスクをキューに入れ、 次の手順を実行させる:

   1. target に e をdispatch する。

   2. complete を true に設定する。

8. complete が true になるまで同期的に待つ。

   注: ここでブロックするのは意図的である。 "dialog" イベントによって表される alert、confirm、および prompt ダイアログはメインスレッドをブロックし、ここで呼び出すイベント ハンドラーが戻り値に影響し得るためである。

9. e["dialogMessage"]["dialog"]["accept"] および e["dialogMessage"]["dialog"]["response"] を返す。

enum WindowOpenDisposition {
  "ignore",
  "save_to_disk",
  "current_tab",
  "new_background_tab",
  "new_foreground_tab",
  "new_window",
  "new_popup"
};

[Exposed=Window, IsolatedContext]
interface NewWindowController {
  undefined attach(HTMLControlledFrameElement newControlledFrame);
  undefined discard();
};

[Exposed=Window, IsolatedContext]
interface NewWindow {
  readonly attribute NewWindowController window;
  readonly attribute USVString targetUrl;
  readonly attribute DOMString name;
  readonly attribute WindowOpenDisposition windowOpenDisposition;
};

[Exposed=Window, IsolatedContext]
interface NewWindowEvent : Event {
  constructor(DOMString type, optional NewWindowEventInit eventInitDict = {});
  readonly attribute NewWindow newWindow;
};

dictionary NewWindowEventInit: EventInit {
  NewWindow? newWindow;
};

controlledframe 要素 controlledFrame、USVString url、 DOMString target、navigable targetNavigable、および WindowOpenDisposition windowOpenDisposition を与えて、 NewWindowEvent を発火する には、次の手順を実行する:

1. controller を新しい NewWindowController オブジェクトとする。

2. controller の target navigable を targetNavigable に設定する。

3. newWindow を新しい NewWindow オブジェクトとする。

4. newWindow の次のフィールドを設定する:

   window

   controller

   targetUrl

   url

   name

   target。

   windowOpenDisposition

   windowOpenDisposition

5. e の newWindow を newWindow に設定する。

6. controlledFrame の 関連グローバルオブジェクトの DOM 操作タスクソースに グローバルタスクをキューに入れ、 controlledFrame に e をdispatch させる。

enum PermissionType {
  "media",
  "geolocation",
  "pointerLock",
  "download",
  "filesystem",
  "fullscreen",
  "hid",
};

[Exposed=Window, IsolatedContext]
interface PermissionRequestControllerBase {
  undefined allow();
  undefined cancel();
};

[Exposed=Window, IsolatedContext]
interface MediaPermissionRequestController: PermissionRequestControllerBase {
  readonly attribute USVString url;
};

[Exposed=Window, IsolatedContext]
interface GeolocationPermissionRequestController: PermissionRequestControllerBase {
  readonly attribute USVString url;
};

[Exposed=Window, IsolatedContext]
interface PointerLockPermissionRequestController: PermissionRequestControllerBase {
  readonly attribute boolean lastUnlockedBySelf;
  readonly attribute boolean userGesture;
  readonly attribute USVString url;
};

[Exposed=Window, IsolatedContext]
interface DownloadPermissionRequestController : PermissionRequestControllerBase {
  readonly attribute DOMString requestMethod;
  readonly attribute USVString url;
};

[Exposed=Window, IsolatedContext]
interface FileSystemPermissionRequestController : PermissionRequestControllerBase {
  readonly attribute USVString url;
};

[Exposed=Window, IsolatedContext]
interface FullscreenPermissionRequestController : PermissionRequestControllerBase {
  readonly attribute USVString origin;
};

[Exposed=Window, IsolatedContext]
interface HidPermissionRequestController : PermissionRequestControllerBase {
  readonly attribute USVString url;
};

[Exposed=Window, IsolatedContext]
interface PermissionRequest {
  readonly attribute PermissionType permission;
  readonly attribute PermissionRequestControllerBase request;
};

[Exposed=Window, IsolatedContext]
interface PermissionRequestEvent : Event {
  constructor(DOMString type, optional PermissionRequestEventInit eventInitDict = {});
  readonly attribute PermissionRequest permissionRequest;
};

dictionary PermissionRequestEventInit: EventInit {
  PermissionRequest? permissionRequest;
};

文書 embeddedDocument、 controlledframe 要素 target、DOMString type、USVString url、 省略可能な辞書 options、および boolean を取るアルゴリズム completionSteps を与えて、 PermissionRequestEvent を発火する には、次の手順を実行する:

1. permissionRequest を新しい PermissionRequest オブジェクトとする。

2. type が "media" である場合:

   1. requestController を、次の属性を持つ新しい MediaPermissionRequestController とする:

      url

      url

3. type が "geolocation" である場合:

   1. requestController を、次の属性を持つ新しい GeolocationPermissionRequestController とする:

      url

      url

4. type が "pointerLock" である場合:

   1. requestController を、次の属性を持つ新しい PointerLockPermissionRequestController とする:

      lastUnlockedBySelf

      options["lastUnlockedBySelf"]

      userGesture

      options["userGesture"]

      url

      url

5. type が "download" である場合:

   1. requestController を、次の属性を持つ新しい DownloadPermissionRequestController とする:

      requestMethod

      options["requestMethod"]

      url

      url

6. type が "filesystem" である場合:

   1. requestController を、次の属性を持つ新しい FileSystemPermissionRequestController とする:

      url

      url

7. type が "fullscreen" である場合:

   1. requestController を、次の属性を持つ新しい FullscreenPermissionRequestController とする:

      origin

      url のオリジン

8. type が "hid" である場合:

   1. requestController を、次の属性を持つ新しい HidPermissionRequestController とする:

      url

      url

9. permissionRequest の次のフィールドを設定する:

   request

   requestController

   permission

   type。

10. e の permissionRequest を permissionRequest に設定する。

11. target の 関連グローバルオブジェクトの DOM 操作タスクソースに グローバルタスクをキューに入れ、 次の手順を実行させる:

    1. target に e をdispatch する。

    2. embeddedDocument の 関連グローバルオブジェクトの DOM 操作タスクソースに グローバルタスクをキューに入れ、 e["permissionRequest"]["permission"]["allow"] を用いて completionSteps を実行させる。

[Exposed=Window, IsolatedContext]
interface SizeChange {
  readonly attribute unsigned long oldWidth;
  readonly attribute unsigned long oldHeight;
  readonly attribute unsigned long newWidth;
  readonly attribute unsigned long newHeight;
};

[Exposed=Window, IsolatedContext]
interface SizeChangedEvent : Event {
  constructor(DOMString type, optional SizeChangedEventInit eventInitDict = {});
  readonly attribute SizeChange sizeChange;
};

dictionary SizeChangedEventInit: EventInit {
  SizeChange? sizeChange;
};

controlledframe 要素 target、4 つの非負数 oldWidth、oldHeight、 newWidth、newHeight を与えて、 SizeChangedEvent e を発火するには:

1. sizeChange を新しい SizeChange オブジェクトとする。

2. sizeChange の次のフィールドを設定する:

   oldWidth

   oldWidth。

   oldHeight

   oldHeight。

   newWidth

   newWidth。

   newHeight

   newHeight。

3. e の sizeChange を sizeChange に設定する。

4. target の 関連グローバルオブジェクトの DOM 操作タスクソースに グローバルタスクをキューに入れ、 target に e をdispatch させる。

[Exposed=Window, IsolatedContext]
interface ZoomChange {
  readonly attribute float oldZoomFactor;
  readonly attribute float newZoomFactor;
};

[Exposed=Window, IsolatedContext]
interface ZoomChangeEvent : Event {
  constructor(DOMString type, optional ZoomChangeEventInit eventInitDict = {});
  readonly attribute ZoomChange zoomChange;
};

dictionary ZoomChangeEventInit: EventInit {
  ZoomChange? zoomChange;
};

controlledframe 要素 target、2 つの float 数 oldZoomFactor、newZoomFactor を与えて、 ZoomChangeEvent を発火する には:

1. zoomChange を新しい ZoomChange オブジェクトとする。

2. zoomChange の次のフィールドを設定する:

   oldZoomFactor

   oldZoomFactor。

   newZoomFactor

   newZoomFactor。

3. e の zoomChange を zoomChange に設定する。

4. target の 関連グローバルオブジェクトの DOM 操作タスクソースに グローバルタスクをキューに入れ、 target に e をdispatch させる。

[Exposed=Window, IsolatedContext]
interface ContentLoadEvent : Event {
  constructor(DOMString type, optional EventInit eventInitDict = {});
};

controlledframe 要素 target を与えて、 ContentLoadEvent を発火する には、次の手順を実行する:

1. target の 関連グローバルオブジェクトの DOM 操作タスクソースに グローバルタスクをキューに入れ、 target に e をdispatch させる。

[Exposed=Window, IsolatedContext]
interface LoadInfo {
  readonly attribute USVString url;
  readonly attribute boolean isTopLevel;
};

[Exposed=Window, IsolatedContext]
interface LoadAbortInfo : LoadInfo{
  readonly attribute long code;
  readonly attribute DOMString reason;
};

[Exposed=Window, IsolatedContext]
interface LoadRedirectInfo{
  readonly attribute USVString oldUrl;
  readonly attribute USVString newUrl;
  readonly attribute boolean isTopLevel;
};

[Exposed=Window, IsolatedContext]
interface LoadAbortEvent : Event {
  constructor(DOMString type, optional LoadAbortEventInit eventInitDict = {});
  readonly attribute LoadAbortInfo loadAbortInfo;
};

dictionary LoadAbortEventInit: EventInit {
  LoadAbortInfo? loadAbortInfo;
};

LoadAbortEvent e を発火するには、 controlledframe 要素 target、USVString url、boolean isTopLevel、 long code、および DOMString reason が与えられたとき、次の手順を実行する:

1. info を、次の属性を持つ新しい LoadAbortInfo とする:

   url

   url

   isTopLevel

   isTopLevel

   code

   code

   reason

   reason

2. e の loadAbortInfo を info に設定する。

3. target の 関連グローバルオブジェクトの DOM 操作タスクソースに グローバルタスクをキューに入れ、 target に e をdispatch させる。

[Exposed=Window, IsolatedContext]
interface LoadCommitEvent : Event {
  constructor(DOMString type, optional LoadCommitEventInit eventInitDict = {});
  readonly attribute LoadInfo loadInfo;
};

dictionary LoadCommitEventInit: EventInit {
  LoadInfo? loadInfo;
};

LoadCommitEvent e を発火するには、 controlledframe 要素 target、USVString url、および boolean isTopLevel が与えられたとき、次の手順を実行する:

1. info を、次の属性を持つ新しい LoadInfo とする:

   url

   url

   isTopLevel

   isTopLevel

2. e の loadInfo を info に設定する。

3. target の 関連グローバルオブジェクトの DOM 操作タスクソースに グローバルタスクをキューに入れ、 target に e をdispatch させる。

[Exposed=Window, IsolatedContext]
interface LoadStartEvent : Event {
  constructor(DOMString type, optional LoadStartEventInit eventInitDict = {});
  readonly attribute LoadInfo loadInfo;
};

dictionary LoadStartEventInit: EventInit {
  LoadInfo? loadInfo;
};

LoadStartEvent e を発火するには、 controlledframe 要素 target、USVString url、および boolean isTopLevel が与えられたとき、次の手順を実行する:

1. info を、次の属性を持つ新しい LoadInfo とする:

   url

   url

   isTopLevel

   isTopLevel

2. e の loadInfo を info に設定する。

3. target の 関連グローバルオブジェクトの DOM 操作タスクソースに グローバルタスクをキューに入れ、 target に e をdispatch させる。

[Exposed=Window, IsolatedContext]
interface LoadStopEvent : Event {
  constructor(DOMString type, optional LoadStopEventInit eventInitDict = {});
};

dictionary LoadStopEventInit: EventInit {
};

controlledframe 要素 target が与えられたとき、 LoadStopEvent を発火する には、次の手順を実行する:

1. target の 関連グローバルオブジェクトの DOM 操作タスクソースに グローバルタスクをキューに入れ、 target に e をdispatch させる。

[Exposed=Window, IsolatedContext]
interface LoadRedirectEvent : Event {
  constructor(DOMString type, optional LoadRedirectEventInit eventInitDict = {});
  readonly attribute LoadRedirectInfo loadRedirectInfo;
};

dictionary LoadRedirectEventInit: EventInit {
  LoadRedirectInfo? loadRedirectInfo;
};

controlledframe 要素 target、URL oldUrl、 URL newUrl、および boolean isTopLevel が与えられたとき、 LoadRedirectEvent を発火する には、次の手順を実行する:

1. info を、次の属性を持つ新しい LoadInfo とする:

   oldUrl

   oldUrl を与えて URL を直列化する結果

   newUrl

   newUrl を与えて URL を直列化する結果

   isTopLevel

   isTopLevel

2. e の loadRedirectInfo を info に設定する。

3. target の 関連グローバルオブジェクトの DOM 操作タスクソースに グローバルタスクをキューに入れ、 target に e をdispatch させる。

Document document が、 DOMString permission、省略可能な辞書 options、および boolean を取るアルゴリズム completionSteps を与えられて、 permission を使用することを埋め込み元に許可されている かどうかを判定するには、次の手順を実行する:

1. controlledFrameEmbedderParent を、document の node navigable の controlledFrameEmbedderParent とする。

2. controlledFrameEmbedderParent が HTMLControlledFrameElement でない場合、true を返す。

3. document、 controlledFrameEmbedderParent、permission、document の URL、options、および completionSteps を用いて "permissionrequest" イベントを発火する。

environment environment を与えて、network partition key を決定するには:

4. topLevelOrigin を与えて site を取得する結果を topLevelSite とする。

5. secondKey を null または実装定義の値 とする。

6. controlledFrameEmbedderParent を、environment を与えて environment の controlledFrameEmbedderParent を取得する結果とする。
7. controlledFrameEmbedderParent が null でない場合、secondKey を、 controlledFrameEmbedderParent の 関連設定オブジェクトの トップレベルオリジンと、 controlledFrameEmbedderParent の partition からなる タプルに設定する。

8. (topLevelSite, secondKey) を返す。

environment environment を与えて、 non-storage purposes のための storage key を取得するには、 次の手順を実行する:

1. environment が環境設定オブジェクトである場合は environment の origin を、 それ以外の場合は environment の creation URL の origin を、 origin とする。

2. origin からなる タプルを返す。
3. topLevelOrigin および partition を null とする。
4. controlledFrameEmbedderParent を、environment を与えて environment の controlledFrameEmbedderParent を取得する結果とする。
5. controlledFrameEmbedderParent が null でない場合:
   1. topLevelOrigin を、 controlledFrameEmbedderParent の 関連設定オブジェクトの トップレベルオリジンに設定する。
   2. partition を controlledFrameEmbedderParent の partition に設定する。
6. topLevelOrigin、partition、 および origin からなる タプルを返す。

environment environment を与えて、 environment の controlledFrameEmbedderParent を取得するには、 次の手順を実行する:

1. environment が環境設定オブジェクトであり、その グローバルオブジェクトが Window オブジェクトである場合:

   このアルゴリズムは、 Shared Worker または Service Worker では機能しない。なぜなら controlledFrameEmbedderParent は navigable 上でのみ定義されており、 非 Window の environment から navigable へ到達することが常に可能とは限らないためである。

   1. navigable を、environment の グローバルオブジェクトの navigable とする。

   2. top を navigable の top-level traversable とする。

   3. top の controlledFrameEmbedderParent が null でない場合、top の controlledFrameEmbedderParent を返す。

2. null を返す。

enum ResourceType {
  "main-frame",
  "sub-frame",
  "stylesheet",
  "script",
  "image",
  "font",
  "object",
  "xmlhttprequest",
  "ping",
  "csp-report",
  "media",
  "websocket",
  "other",
};

enum RequestedHeaders {
  "none",
  "cors",
  "all",
};

enum ConnectionState {
  "broken", "insecure", "secure"
};

dictionary Fingerprint {
  required DOMString sha256;
};

dictionary CertificateInfo {
  required Fingerprint fingerprint;
  Uint8Array rawDER;
};

dictionary SecurityInfo {
  required sequence<CertificateInfo> certificates;
  required ConnectionState state;
};

dictionary WebRequestInterceptorOptions {
  required sequence<(URLPattern or URLPatternInput)> urlPatterns;
  sequence<ResourceType> resourceTypes = [];
  boolean blocking = false;
  boolean includeRequestBody = false;
  RequestedHeaders includeHeaders = "none";
  boolean securityInfo = false;
  boolean securityInfoRawDer = false;
};

[Exposed=Window, IsolatedContext]
interface WebRequest {
  WebRequestInterceptor createWebRequestInterceptor(
      WebRequestInterceptorOptions options);
};

[Exposed=Window, IsolatedContext]
interface WebRequestInterceptor : EventTarget {
  attribute EventHandler onauthrequired;
  attribute EventHandler onbeforeredirect;
  attribute EventHandler onbeforerequest;
  attribute EventHandler onbeforesendheaders;
  attribute EventHandler oncompleted;
  attribute EventHandler onerroroccurred;
  attribute EventHandler onheadersreceived;
  attribute EventHandler onsendheaders;
  attribute EventHandler onresponsestarted;
};

enum DocumentLifecycle {
  "prerender",
  "active",
  "cached",
  "pending-deletion",
};

enum FrameType {
  "outermost-frame",
  "fenced-frame",
  "sub-frame",
};

[Exposed=Window, IsolatedContext]
interface UploadData {
  readonly attribute ArrayBuffer? bytes;
  readonly attribute DOMString? file;
};

[Exposed=Window, IsolatedContext]
interface RequestBody {
  readonly attribute DOMString? error;
  readonly attribute any formData;
  readonly attribute FrozenArray<UploadData>? raw;
};

[Exposed=Window, IsolatedContext]
interface WebRequestRequest {
  readonly attribute DOMString method;
  readonly attribute DOMString id;
  readonly attribute ResourceType type;
  readonly attribute USVString url;
  readonly attribute USVString? initiator;
  readonly attribute Headers? headers;
  readonly attribute RequestBody? body;
};

[Exposed=Window, IsolatedContext]
interface AuthChallenger {
  readonly attribute DOMString host;
  readonly attribute long port;
};

[Exposed=Window, IsolatedContext]
interface WebRequestAuthDetails {
  readonly attribute AuthChallenger challenger;
  readonly attribute boolean isProxy;
  readonly attribute DOMString scheme;
  readonly attribute DOMString? realm;
};

[Exposed=Window, IsolatedContext]
interface WebRequestResponse {
  readonly attribute long statusCode;
  readonly attribute DOMString statusLine;
  readonly attribute boolean fromCache;
  readonly attribute Headers? headers;
  readonly attribute DOMString? ip;
  readonly attribute USVString? redirectURL;
  readonly attribute WebRequestAuthDetails? auth;
};

[Exposed=Window, IsolatedContext]
interface WebRequestEvent : Event {
  readonly attribute WebRequestRequest request;
  readonly attribute long frameId;
  readonly attribute FrameType? frameType;
  readonly attribute DOMString? documentId;
  readonly attribute DocumentLifecycle? documentLifecycle;
  readonly attribute DOMString? parentDocumentId;
  readonly attribute long? parentFrameId;
};

dictionary WebRequestAuthCredentials {
  required DOMString username;
  required DOMString password;
};

dictionary WebRequestAuthOptions {
  AbortSignal signal;
};

[Exposed=Window, IsolatedContext]
interface WebRequestAuthRequiredEvent : WebRequestEvent {
  readonly attribute WebRequestResponse response;

  undefined setCredentials(
    Promise<WebRequestAuthCredentials> credentials,
    optional WebRequestAuthOptions options = {});
};

[Exposed=Window, IsolatedContext]
interface WebRequestBeforeRedirectEvent : WebRequestEvent {
  readonly attribute WebRequestResponse response;
};

[Exposed=Window, IsolatedContext]
interface WebRequestBeforeRequestEvent : WebRequestEvent {
  undefined redirect(USVString redirectURL);
};

[Exposed=Window, IsolatedContext]
interface WebRequestBeforeSendHeadersEvent : WebRequestEvent {
  undefined setRequestHeaders((Headers or HeadersInit) requestHeaders);
};

[Exposed=Window, IsolatedContext]
interface WebRequestCompletedEvent : WebRequestEvent {
  readonly attribute WebRequestResponse response;
};

[Exposed=Window, IsolatedContext]
interface WebRequestErrorOccurredEvent : WebRequestEvent {
  readonly attribute DOMString error;
};

[Exposed=Window, IsolatedContext]
interface WebRequestHeadersReceivedEvent : WebRequestEvent {
  readonly attribute WebRequestResponse response;
  readonly attribute SecurityInfo? securityInfo;

  undefined redirect(USVString redirectURL);
  undefined setResponseHeaders((Headers or HeadersInit) responseHeaders);
};

[Exposed=Window, IsolatedContext]
interface WebRequestResponseStartedEvent : WebRequestEvent {
  readonly attribute WebRequestResponse response;
};

[Exposed=Window, IsolatedContext]
interface WebRequestSendHeadersEvent : WebRequestEvent {};

createWebRequestInterceptor(options) メソッド手順は次の通りである:

1. interceptor を新しい WebRequestInterceptor オブジェクトとする。

2. interceptor に次のフィールドを設定する:

   resourceTypes

   options["resourceTypes"]

   blocking

   options["blocking"]

   includeRequestBody

   options["includeRequestBody"]

   includeHeaders

   options["includeHeaders"]

   securityInfo

   options["securityInfo"]

   securityInfoRawDer

   options["securityInfoRawDer"]

3. options["urlPatterns"] 内の各 urlPattern について 反復する:

   1. urlPattern が URLPattern である場合、urlPattern を interceptor の urlPatterns に 追加する。

   2. それ以外の場合、urlPattern を与えて新しい URLPattern を作成し、それを interceptor の urlPatterns に 追加する。

4. interceptor を this の interceptors に 追加する。

5. interceptor を返す。

request request について、 適用可能な WebRequestInterceptor を取得するには、次の手順を実行する:

1. client を request の client とする。

2. client が null である場合、空のリストおよび false を返す。

3. window を、client を与えて 環境設定オブジェクトの所有 Window を取得した結果とする。

4. window が null である場合、空のリストおよび false を返す。

5. navigable を window の navigable とする。

6. navigable またはその controlledFrameEmbedderParent が null である場合、空のリスト および false を返す。

7. controlledFrame を navigable の controlledFrameEmbedderParent とする。

8. applicableInterceptors を空のリストとする。

9. controlledFrame の request の interceptors 内の各 interceptor について:

   1. request が interceptor によって intercepted されるべきでない場合、続行する。

   2. interceptor を applicableInterceptors に 追加する。

10. applicableInterceptors を返す。

request request が WebRequestInterceptor によって intercepted されるべきかを判定するには、 次の手順を実行する:

1. types を interceptor の resourceTypes とする。

2. types が空でなく、 かつ request を与えて request の ResourceType を取得する結果を types が含まない場合、false を返す。

3. urlPatterns を interceptor の urlPatterns とする。

4. urlPatterns 内の各 urlPattern について:

   1. request の URL が urlPattern を与えて URLPattern に一致する 場合、true を返す。

5. false を返す。

環境設定オブジェクト environment が 与えられたとき、 環境設定オブジェクトの所有 Window を取得するには、次の手順を実行する:

1. global を environment の グローバルオブジェクトとする。

2. global が Window オブジェクトである場合、global を返す。

3. global が DedicatedWorkerGlobalScope オブジェクトである場合:

   1. owner を global とする。

   2. owner が DedicatedWorkerGlobalScope オブジェクトである間:

      1. owner を owner の owner set[0] とする。

   3. owner が Document オブジェクトである場合、owner の 関連グローバルオブジェクト を返す。

4. null を返す。

WebRequestAuthRequiredEvent の setCredentials(credentials, options) メソッド手順は次の通りである:

1. this の authCredentials を credentials に設定する。

2. this の options を options に設定する。

WebRequestAuthRequiredEvent の preventDefault() メソッド手順は、this の cancel を true に設定することである。

WebRequestBeforeRequestEvent の redirect(redirectURL) メソッド手順は、this の redirectURL を redirectURL に設定することである。

WebRequestBeforeRequestEvent の preventDefault() メソッド手順は、this の cancel を true に設定することである。

WebRequestBeforeSendHeadersEvent の setRequestHeaders(requestHeaders) メソッド手順は、this の requestHeaders を requestHeaders に設定することである。

WebRequestBeforeSendHeadersEvent の preventDefault() メソッド手順は、this の cancel を true に設定することである。

WebRequestHeadersReceivedEvent の redirect(redirectURL) メソッド手順は、this の redirectURL を redirectURL に設定することである。

WebRequestHeadersReceivedEvent の setResponseHeaders(responseHeaders) メソッド手順は、this の responseHeaders を responseHeaders に設定することである。

WebRequestHeadersReceivedEvent の preventDefault() メソッド手順は、this の cancel を true に設定することである。

request request を与えて beforeRequest イベントを処理するには、 次の手順を実行する:

1. interceptors を、request の 適用可能な WebRequestInterceptors を取得した結果とする。

2. result を WebRequestEvent result とする。

3. pendingHandlerCount を 0 とする。

4. controlledFrameEmbedderGlobal を、 request の client を与えて environment の controlledFrameEmbedderParent を取得する結果の 関連グローバルオブジェクトとする。

5. controlledFrameEmbedderGlobal が null である場合、戻る。

6. interceptors 内の各 interceptor について:

   1. interceptor の blocking が true の場合、 pendingHandlerCount をインクリメントする。

   2. controlledFrameEmbedderGlobal の DOM 操作タスクソースに グローバルタスクをキューに入れ、次の手順を実行させる:

      1. event を、 beforerequest という名前の 新しい WebRequestBeforeRequestEvent とする。

      2. event、request、および "none" を与えて WebRequestEvent に値を設定する。

      3. interceptor の includeRequestBody が true であり、かつ request の body が null でない場合:

         1. requestBody を新しい RequestBody とする。

         2. body を request の body とする。

            TODO: body の stream が存在する場合、それを直列化する。

         3. body の source で分岐する:

            byte sequence

            直列化された body の source と等しい bytes を持つ 新しい UploadData を requestBody の raw に 追加する。

            Blob

            直列化された body の source と等しい bytes を持つ 新しい UploadData を requestBody の raw に 追加する。

            FormData

            1. formData を «[]» とする。

            2. body の source の entry list 内の各 entry について 反復する:

               1. entry[1] で分岐する:

               File

               entry[1] の name と等しい file を持つ 新しい UploadData を requestBody の raw に 追加する。

               USVString

               1. formData[entry[0]] が存在しない場合、 formData[entry[0]] を空の リスト に設定する。

               2. entry[1] を formData[entry[0]] に 追加する。

            3. requestBody の formData を formData に設定する。

         4. event の request の body を requestBody に設定する。

      4. event を interceptor に dispatch する。

      5. event の cancel が true である場合、 result の cancel を true に設定する。

      6. event の redirectURL が null でなく、かつ result の redirectURL が "" である場合、 result の redirectURL を event の redirectURL に設定する。

      7. interceptor の blocking が true である場合、 pendingHandlerCount をデクリメントする。

7. pendingHandlerCount > 0 である場合、 pendingHandlerCount が 0 と等しくなるまで 並列に待機し、その後 グローバルタスクをキューに入れ、 それらの手順が並列に移行する前にどのように実行されていたかに応じて、 request の client の グローバルオブジェクトの ネットワーキングタスクソース、またはこれらの手順が 最初に呼び出された 並列コンテキストのいずれかで、 このアルゴリズムの残りの手順を続行させる。

8. result を返す。