WebDriver BiDi

並列に実行されているアルゴリズム algorithm が、イベントの集合 events および resume id を awaits するとき:

1. algorithm の実行を一時停止する。

2. 表明: wait queue は resume id を含まない。

3. wait queue[resume id] を (events, algorithm) に設定する。

与えられた name、 id および parameters で resume するには:

1. wait queue が id を含まない場合、戻る。

2. (events, algorithm) を wait queue[id] とする

3. events 内の各 event について:

   1. event が name と等しい場合:

      1. wait queue から id を削除する。

      2. algorithm 内のステップの実行を、 一時停止された地点から再開し、name および parameters を await の結果として渡す。

         これがイベントループ上の他のどのタスクよりも先に 実行されることを保証するために、microtasks のようなものを 持つべきだろうか?

注: このアルゴリズムは、与えられた navigable についての WebDriver configuration に、 navigables 内の値を確認し、次に user contexts 内、最後に global 内を確認することでアクセスできるようにする。 設定されていない場合は unset を返す。

WebDriver configuration configuration の、 navigable navigable に対する get WebDriver configuration value は:

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

2. configuration の navigables が top-level traversable を含む場合:

   1. navigable configuration value を configuration の navigables[top-level traversable] とする。

   2. navigable configuration value が unset でない場合、 navigable configuration value を返す。

3. user context を navigable の associated user context とする。

4. configuration の user contexts が user context を含む場合:

   1. user context configuration value を configuration の user contexts[user context] とする。

   2. user context configuration value が unset でない場合、 user context configuration value を返す。

5. configuration の global を返す。

注: これは WebDriver configuration を target ごとに格納するための汎用アルゴリズムであり、target は navigable、user context のいずれか、または target が null もしくは省略された場合はグローバルに格納できる。

WebDriver configuration configuration の value value を、任意の target に store するには。これは navigable、 user context、または提供されない場合は null である:

1. target が null である場合、configuration の global を value に設定する。

2. target が user context である場合、configuration の user contexts[target] を value に設定する。

3. target が navigable である場合、configuration の navigables[target] を value に設定する。

注: この汎用アルゴリズムは、 command parameters 内の "userContexts" および "contexts" の存在に応じて、WebDriver configuration の value を global、user contexts、または navigables に格納する。これらの パラメーター は相互に排他的である。どちらも提供されない場合、設定はグローバルに格納される。

与えられた command parameters について、WebDriver configuration configuration の value value を store WebDriver configuration するには:

1. command parameters が "userContexts" を含み、かつ command parameters が "contexts" を含む場合、error を、error code invalid argument とともに返す。

2. affected navigables を空の set とする。

3. command parameters が "contexts" を含む場合:

   1. navigables を、command parameters["contexts"] で get valid top-level traversables by ids することを試みた結果とする。

   2. navigables の各 navigable について:

      1. navigable を affected navigables に追加する。

      2. configuration の value を navigable に store する。

4. そうでなく、command parameters が "userContexts" を含む場合:

   1. user contexts を、command parameters["userContexts"] で get valid user contexts することを試みた結果とする。

   2. user contexts の各 user context について:

      1. user context である associated user context を持つ、すべての top-level traversables のリスト内の 各 top-level traversable について反復する:

         1. top-level traversable を affected navigables に追加する。

      2. configuration の value を user context に store する。

5. そうでなければ:

   1. すべての top-level traversables の各 top-level traversable について反復し、top-level traversable を affected navigables に追加する。

   2. configuration の value をStore する。

6. affected navigables を返す。

Command = {
    id: js-uint,
    CommandData,
    Extensible,
    }

    CommandData = (
    BrowserCommand //
    BrowsingContextCommand //
    EmulationCommand //
    InputCommand //
    NetworkCommand //
    ScriptCommand //
    SessionCommand //
    StorageCommand //
    WebExtensionCommand
    )

    EmptyParams = {
    Extensible
    }

Message = (
  CommandResponse /
  ErrorResponse /
  Event
)

CommandResponse = {
  type: "success",
  id: js-uint,
  result: ResultData,
  Extensible
}

ErrorResponse = {
  type: "error",
  id: js-uint / null,
  error: ErrorCode,
  message: text,
  ? stacktrace: text,
  Extensible
}

ResultData = (
  BrowserResult /
  BrowsingContextResult /
  EmulationResult /
  InputResult /
  NetworkResult /
  ScriptResult /
  SessionResult /
  StorageResult /
  WebExtensionResult
)

EmptyResult = {
  Extensible
}

Event = {
  type: "event",
  EventData,
  Extensible
}

EventData = (
  BrowsingContextEvent //
  InputEvent //
  LogEvent //
  NetworkEvent //
  ScriptEvent
)

Extensible = (*text => any)

js-int = -9007199254740991..9007199254740991
js-uint = 0..9007199254740991

active BiDi sessions のリストは、次で与えられる:

1. BiDi sessions を新しい list とする。

2. active sessions 内の各 session について:

   1. session が BiDi session である場合、session を BiDi sessions に追加する。

3. BiDi sessions を返す。

ErrorCode = "invalid argument" /
            "invalid selector" /
            "invalid session id" /
            "invalid web extension" /
            "move target out of bounds" /
            "no such alert" /
            "no such network collector" /
            "no such element" /
            "no such frame" /
            "no such handle" /
            "no such history entry" /
            "no such intercept" /
            "no such network data" /
            "no such node" /
            "no such request" /
            "no such screencast" /
            "no such script" /
            "no such storage partition" /
            "no such user context" /
            "no such web extension" /
            "session not created" /
            "unable to capture screen" /
            "unable to close browser" /
            "unable to set cookie" /
            "unable to set file input" /
            "unavailable network data" /
            "underspecified storage partition" /
            "unknown command" /
            "unknown error" /
            "unsupported operation"

event name および navigables が与えられたときの set of sessions for which an event is enabled は次である:

1. sessions を新しい set とする。

2. active BiDi sessions 内の各 session について:

   1. session、event name および navigables で event is enabled である場合、 session を sessions に追加する。

3. sessions を返す。

session、 event name および navigables が与えられたとき、event is enabled であるかどうかを判定するには:

注: shared worker は複数のコンテキストに関連付けられ得るため、 navigables は set である。

1. top-level traversables を、navigables で get top-level traversables したものとする。

2. session の subscriptions 内の各 subscription について:

   1. subscription の event names が event name を含まない場合、continue する。

   2. subscription が global である場合、true を返す。

   3. user context ids が空でない場合:

      1. top-level traversables 内の各 navigable について反復する:

         1. subscription の user context ids が、 navigable の associated user context の user context id を含む場合、 true を返す。

   4. そうでなければ:

      1. subscription top-level traversables を、subscription の top-level traversable ids で get navigables by ids したものとする。

      2. top-level traversables と subscription top-level traversables の積集合が空でない場合、true を返す。

3. false を返す。

event name および session が与えられたときの set of top-level traversables for which an event is enabled は次である:

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

2. session の subscriptions 内の各 subscription について:

   1. subscription の event names が event name を含まない場合、 continue する。

   2. subscription が global である場合:

      1. remote end の top-level traversables 内の各 traversable について:

         1. traversable を result に追加する。

      2. Break する。

   3. そうでなく、user context ids が空でない場合:

      1. remote end の top-level traversables 内の各 traversable について:

         1. subscription の user context ids が traversable の associated user context の user context id を含む場合、 traversable を result に追加する。

   4. そうでなければ:

      1. top-level traversables を、subscription の top-level traversable ids で get navigables by ids したものとする。

      2. top-level traversables の各項目を result に追加する。

3. result を返す。

与えられた name で obtain a set of event names するには:

1. events を空の set とする。

2. name が U+002E（ピリオド）を含む場合:

   1. name がイベントに対する event name である場合、name を events に追加し、 data events とともに success を返す。

   2. error code invalid argument を持つ error を返す

3. そうでなければ、name はモジュール内のすべてのイベントを表すものとして解釈される。 name が module name でない場合、error code invalid argument を持つ error を返す。

4. 名前 name を持つモジュール内の各 event に対する event name を events に追加する。

5. data events とともに success を返す。

セッション session が与えられたとき、WebSocket リソース名を構築するには、次を実行する：

1. session が null なら、"/session" を返す

2. 文字列 "/session/" と session の セッション ID とを連結した結果を返す。

WebSocket リスナー listener および セッション session が与えられたとき、WebSocket URL を構築するには、 次を実行する：

1. resource name を、session により WebSocket リソース名を構築する 結果とする。

2. host を listener の host に、port を listener の port に、path を resource name に設定して構築された WebSocket URI を返す。これは、 listener の secure flag が設定されている場合は wss-URI 構成に従い、そうでなければ ws-URL 構成に従う。

resource name が与えられたとき、WebSocket リソースのセッション ID を取得するには、次を実行する：

1. resource name がバイト文字列 "/session/" で始まらない場合、null を返す。

2. session id を、resource name 内の "/session/" 接頭辞に続くバイト列とする。

3. session id が UUID の文字列表現でない場合、null を返す。

4. session id を返す。

セッション session が与えられたとき、WebSocket 接続のリッスンを開始するには、次を実行する：

1. リモートエンドが再利用したい既存の WebSocket リスナーが アクティブリスナー内にある場合、 listener をその リスナーとする。そうでなければ、listener を、実装定義の host、port、 secure flag、および空の WebSocket リソースのリストを持つ新しい WebSocket リスナーとする。

2. resource name を、session により WebSocket リソース名を構築する 結果とする。

3. resource name を listener の WebSocket リソースのリストに 追加する。

4. listener を リモートエンドの アクティブリスナーに 追加する。

5. listener を返す。

WebSocket connection connection、型 type およびデータ data が与えられたとき、 handle an incoming message するには:

1. type が text でない場合、connection、 null、および invalid argument が与えられたものとして send an error response し、最後に 戻る。

2. Assert: data は scalar value string である。そうでなければ、WebSocket の UTF-8 符号化データ内のエラー処理 が、すでに WebSocket connection を失敗させているためである。

   UTF-8 エラーにどの status code が使用されるかを定義しているものはないように思われる。

3. connection と associated with connection している BiDi Session が存在する場合、 session をそのセッションとする。そうでなく、connection が WebSocket connections not associated with a session 内にある場合、session を null とする。そうでなければ、戻る。

4. parsed を、data が与えられたものとして JSON を Infra values に構文解析する結果とする。 これが例外を投げる場合、connection、 null、および invalid argument が与えられたものとして send an error response し、 最後に戻る。

5. session が null でなく、かつ active sessions 内にない場合、戻る。

6. parsed を remote end definition に対して照合する。 これが 一致になる場合:

   1. matched を、一致したデータを表す map とする。

   2. Assert: matched は "id"、"method"、および "params" を含む。

   3. command id を matched["id"] とする。

   4. method を matched["method"] とする

   5. command を、command name method を持つ command とする。

   6. session が null であり、かつ command が static command でない場合、 connection、command id、および invalid session id が与えられたものとして send an error response し、戻る。

   7. 次のステップを並列に実行する:

      1. result を、 session および command parameters matched["params"] が与えられたものとして、 command に対する remote end steps を実行した結果とする。

      2. result が error である場合、 connection、command id、および result の error code が与えられたものとして send an error response し、最後に 戻る。

      3. value を result の data とする。

      4. Assert: value は、command name method を持つ command に対応する result type の定義に一致する。

      5. method が "session.new" である場合、session を active sessions のリスト内の、その session ID が value の "sessionId" プロパティと等しいエントリーとし、connection を session の session WebSocket connections に追加し、 connection を WebSocket connections not associated with a session から削除する。

      6. response を、local end definition 内の CommandResponse 生成規則に一致する新しい map とする。 id フィールドは command id に設定され、value フィールドは value に設定される。

      7. serialized を、response が与えられたものとして serialize an infra value to JSON bytes した結果とする。

      8. serialized からなる WebSocket メッセージを送信する。 これは connection 上で行う。

7. そうでなければ:

   1. command id を null とする。

   2. parsed が map であり、かつ parsed["id"] が存在し、0 以上の integer である場合、command id をその integer に設定する。

   3. error code を invalid argument とする。

   4. parsed が map であり、かつ parsed["method"] が存在し、 string であるが、parsed["method"] が set of all command names 内にない場合、 error code を unknown command に設定する。

   5. connection、command id、および error code が与えられたものとして Send an error response する。

settings object settings が与えられたとき、get related navigables するには:

1. related navigables を空の set とする。

2. settings の relevant global object が Window である場合:

   1. navigable を、relevant global object の associated Document の node navigable とする。

   2. navigable が null でない場合、navigable を related navigables に追加する。

3. そうでなく、settings によって指定される global object が WorkerGlobalScope である場合、 global object の owner set 内の各 owner について:

   1. navigable を null とする。

   2. owner が Document である場合、navigable を owner の node navigable に設定する。

   3. navigable が null でない場合、navigable を related navigables に追加する。

4. related navigables を返す。

context ids の list navigable ids が与えられたとき、get navigables by ids するには:

1. result を空の set とする。

2. navigable ids 内の各 navigable id について:

   1. navigable を、id navigable id を持つ navigable が存在する場合はその navigable、そうでなければ null とする。

   2. navigable が null でない場合、 navigable を result に追加する。

3. result を返す。

list of navigables navigables が与えられたとき、get top-level traversables するには:

1. result を空の set とする。

2. navigables 内の各 navigable について:

   1. navigable の top-level traversable を result に追加する。

3. result を返す。

context ids の list navigable ids が与えられたとき、get valid navigables by ids するには:

1. result を空の set とする。

2. navigable ids 内の各 navigable id について:

   1. navigable を、navigable id で get a navigable することを試みた結果とする。

   2. navigable を result に追加する。

3. data result とともに success を返す。

context ids の list navigable ids が与えられたとき、 get valid top-level traversables by ids するには:

1. result を空の set とする。

2. navigable ids 内の各 navigable id について:

   1. navigable を、navigable id で get a navigable することを試みた結果とする。

   2. navigable が top-level traversable でない場合、 error を、error code invalid argument とともに返す。

   3. navigable を result に追加する。

3. data result とともに success を返す。

session および body が与えられたとき、 emit an event するには:

1. Assert: body は Event 生成規則に一致する。

2. serialized を、body が与えられたものとして serialize an infra value to JSON bytes した結果とする。

3. session の session WebSocket connections 内の各 connection について反復する:

   1. serialized からなる WebSocket メッセージを送信する。 これは connection 上で行う。

WebSocket connection connection、command id、および error code が与えられたとき、 send an error response するには:

1. error data を、local end definition 内の ErrorResponse 生成規則に一致する新しい map とする。 id フィールドは command id に設定され、error フィールドは error code に設定され、 message フィールドは、発生したエラーの人間可読な定義を含む 実装定義の文字列に設定され、stacktrace フィールドは任意で、 エラーが発生した時点のアクティブなスタックフレームのスタックトレース報告を含む 実装定義の文字列に設定される。

2. response を、error data が与えられたものとして serialize an infra value to JSON bytes した結果とする。

   注: command id は null になり得る。その場合、 id フィールドも null に設定され、 response から省略されるわけではない。

3. response からなる WebSocket メッセージを送信する。 これは connection 上で行う。

WebSocket connection connection が与えられたとき、handle a connection closing するには:

1. connection と associated with connection している BiDi session が存在する場合:

   1. session を、connection と associated with connection している BiDi session とする。

   2. connection を session の session WebSocket connections から削除する。

2. そうでなく、WebSocket connections not associated with a session が connection を含む場合、connection をその set から削除する。

注記: これはいかなる セッションも終了しない。

UA が望む場合に listener を閉じられるようにするため、session の終了にフックする必要がある。

session が与えられたとき、close the WebSocket connections するには:

1. session の session WebSocket connections 内の各 connection について:

   1. connection で WebSocket の終了ハンドシェイクを開始する。

      注: これにより、connection に対して handle a connection closing のステップが実行されることになり、connection に関連付けられたリソースが クリーンアップされる。

この仕様によって定義される WebDriver new session algorithm は、 パラメーター session、capabilities、および flags を取り、次である:

1. flags が "bidi" を含む場合、戻る。

2. webSocketUrl を、capabilities から "webSocketUrl" という名前のプロパティを取得する結果とする。

3. webSocketUrl が undefined である場合、戻る。

4. Assert: webSocketUrl は true である。

5. listener を、session が与えられたものとして start listening for a WebSocket connection した結果とする。

6. webSocketUrl を、listener および session で construct a WebSocket URL した結果に設定する。

7. capabilities 上の "webSocketUrl" という名前のプロパティを webSocketUrl に設定する。

8. session の BiDi flag を true に設定する。

9. "bidi" を flags に追加する。

実装は、HTTP Session ではない BiDi Session を クライアントが確立できるようにもするべきである。この場合、WebSocket サーバーへの URL は 帯域外で伝達される。これを許可する実装は supports BiDi-only sessions する。そのような実装が WebDriver セッションを開始する要求を 受け入れる準備ができた時点で、次を行わなければならない:

1. null が与えられたものとして Start listening for a WebSocket connection する。

name および navigable が与えられたとき、 get or create a sandbox realm するには:

1. name が空文字列である場合、error を error code invalid argument とともに返す。

2. window を navigable の active window とする。

3. sandbox map が window を含まない場合、sandbox map[window] を新しい map に設定する。

4. sandboxes を sandbox map[window] とする。

5. sandboxes が name を含まない場合、 sandboxes[name] を navigable で create a sandbox realm したものに設定する。

6. data sandboxes[name] とともに success を返す。

window で create a sandbox realm するには:

sandbox realm の作成を定義する。これは window をラップする SandboxWindowProxy を返すことになる。

target realm が与えられたとき、get a sandbox name するには:

1. realms maps を、sandbox map の値を取得するものとする。

2. realms maps 内の各 realms map について:

   1. realms map 内の各 name → realm について:

      1. realm が target realm である場合、name を返す。

3. null を返す。

unwrapped object を取得するには:

1. object が SandboxProxy または SandboxWindowProxy である間、object をその wrapped object に設定する。

2. object を返す。

remove user context subscriptions するには:

1. active sessions 内の各 session について:

   1. subscriptions to remove を set とする。

   2. session の subscriptions 内の各 subscription について:

      1. subscription の user context ids が、 navigable の associated user context の user context id を含む場合;

         1. navigable の associated user context の user context id を、 subscription の user context ids から削除する。

         2. subscription の user context ids が 空である場合:

            1. subscription を subscriptions to remove に追加する。

   3. subscriptions to remove を session の subscriptions から削除する。

user context id が与えられたとき、 get user context するには:

1. set of user contexts 内の各 user context について:

2. user context の user context id が user context id と等しい場合:

   1. user context を返す。

3. null を返す。

user context ids が与えられたとき、get valid user contexts するには:

1. result を空の set とする。

2. user context ids の各 user context id について:

   1. user context を、user context id で get user context したものに設定する。

   2. user context が null である場合、error を error code no such user context とともに返す。

   3. user context を result に追加する。

3. result を返す。

SessionCommand = (
    session.End //
    session.New //
    session.Status //
    session.Subscribe //
    session.Unsubscribe
    )

SessionResult = (
    session.EndResult /
    session.NewResult /
    session.StatusResult /
    session.SubscribeResult /
    session.UnsubscribeResult
    )

session が与えられたとき、 end the session するには:

1. session を active sessions から削除する。

2. active sessions が 空である場合、 webdriver-active flag を false に設定する。

session が与えられたとき、cleanup the session するには:

1. session で Close the WebSocket connections する。

2. set of user contexts 内の各 user context について:

   1. session の user context to accept insecure certificates override map[user context] を削除する。

   2. session の user context to proxy configuration map[user context] を削除する。

3. session の blocked request map 内の各 request id → (request, phase, response) について:

   1. "continue request"、request id および (response, "incomplete") で Resume する。

4. session の network collectors 内の各 collector について:

   1. collector id を collector の collector とする。

   2. collected network data 内の各 collected data について、collected data および collector id で remove collector from data する。

5. session の スクリーンキャスト 記録マップ内の各screencast recordingについて：

   1. screencast recordingを与えて、スクリーンキャスト記録を停止する。

   2. screencast recordingを除去する、スクリーンキャスト記録マップから。

6. active sessions が 空である場合、 cleanup remote end state する。

7. 実装固有のクリーンアップステップを実行する。

cleanup remote end state するには。

1. before request sent map をクリアする。

2. default cache behavior を "default" に設定する。

3. navigable cache behavior map をクリアする。

4. 現在の remote end 設定で通常有効にされる 実装固有のリソースキャッシュを有効にするための、実装定義のステップを実行する。

session.CapabilitiesRequest = {
  ? alwaysMatch: session.CapabilityRequest,
  ? firstMatch: [*session.CapabilityRequest]
}

session.CapabilityRequest = {
  ? acceptInsecureCerts: bool,
  ? browserName: text,
  ? browserVersion: text,
  ? platformName: text,
  ? proxy: session.ProxyConfiguration,
  ? unhandledPromptBehavior: session.UserPromptHandler,
  Extensible
}

"webSocketUrl" ケイパビリティの 追加ケイパビリティのデシリアライズ アルゴリズムは、 パラメーター value を指定すると、次のようになります。

1. value がブール値でない場合、エラーを コード 無効な引数で返します。

2. データ value を伴う成功を返します。

"webSocketUrl" ケイパビリティの 一致したケイパビリティのシリアライズ アルゴリズムは、 パラメーター value を指定すると、次のようになります。

1. value が false の場合、データ null を伴う成功 を返します。

2. データ true を伴う成功を返します。

session.CapabilityResponse = {
  acceptInsecureCerts: bool,
  browserName: text,
  browserVersion: text,
  platformName: text,
  setWindowRect: bool,
  userAgent: text,
  ? proxy: session.ProxyConfiguration,
  ? unhandledPromptBehavior: session.UserPromptHandler,
  ? webSocketUrl: text,
  Extensible
}

session.ProxyConfiguration = {
   session.AutodetectProxyConfiguration //
   session.DirectProxyConfiguration //
   session.ManualProxyConfiguration //
   session.PacProxyConfiguration //
   session.SystemProxyConfiguration
}

session.AutodetectProxyConfiguration = (
   proxyType: "autodetect",
   Extensible
)

session.DirectProxyConfiguration = (
   proxyType: "direct",
   Extensible
)

session.ManualProxyConfiguration = (
   proxyType: "manual",
   ? httpProxy: text,
   ? sslProxy: text,
   ? session.SocksProxyConfiguration,
   ? noProxy: [*text],
   Extensible
)

session.SocksProxyConfiguration = (
   socksProxy: text,
   socksVersion: 0..255,
)

session.PacProxyConfiguration = (
   proxyType: "pac",
   proxyAutoconfigUrl: text,
   Extensible
)

session.SystemProxyConfiguration = (
   proxyType: "system",
   Extensible
)

session.UserPromptHandler = {
  ? alert: session.UserPromptHandlerType,
  ? beforeUnload: session.UserPromptHandlerType,
  ? confirm: session.UserPromptHandlerType,
  ? default: session.UserPromptHandlerType,
  ? file: session.UserPromptHandlerType,
  ? prompt: session.UserPromptHandlerType,
}

session.UserPromptHandlerType = "accept" / "dismiss" / "ignore";

session.Subscription = text

session.SubscribeParameters = {
  events: [+text],
  ? contexts: [+browsingContext.BrowsingContext],
  ? userContexts: [+browser.UserContext],
}

session.UnsubscribeByIDRequest = {
  subscriptions: [+session.Subscription],
}

session.UnsubscribeByAttributesRequest = {
  events: [+text],
}

session および command parameters が与えられたときの remote end steps は次である:

1. body を、次のプロパティを持つ新しい map とする:

   "ready"

   remote end の readiness state。

   "message"

   remote end の readiness state を説明する実装定義の文字列。

2. data body とともに success を返す

session および command parameters が与えられたときの remote end steps は次である:

1. session が null でない場合、error code session not created を持つ error を返す。

2. 実装が何らかの理由で新しいセッションを開始できない場合、 error code session not created を持つ error を返す。

3. flags を、"bidi" を含む set とする。

4. capabilities json を、command parameters および flags で process capabilities することを試みた結果とする。

5. capabilities を、capabilities json で convert a JSON-derived JavaScript value to an Infra value したものとする。

6. session を、capabilities および flags で create a session することを試みた結果とする。

7. session の BiDi flag を true に設定する。

   注: このセッションの connection は、 呼び出し元によって現在の connection に設定される。

8. body を、session.NewResult 生成規則に一致する 新しい map とし、sessionId フィールドを session の session ID に設定し、 capabilities フィールドを capabilities に設定する。

9. data body とともに success を返す。

session および command parameters が与えられたときの remote end steps は次である:

1. session で End the session する。

2. data null とともに success を返し、並列に次の ステップを実行する:

   1. このコマンドへのレスポンスで Send a WebSocket message ステップが呼び出されるまで待つ。

      これは かなり不正確な表現だが、意図としては接続の シャットダウンを開始する前にコマンドへのレスポンスを送信する、ということが明確であることを期待している。

   2. session で Cleanup the session する。

session および command parameters を伴う remote end steps は次である:

1. event names を空の set とする。

2. command parameters["events"] 内の各エントリー name について、 event names を、event names と、 name で obtain a set of event names することを 試みた結果との union とする。

3. input user context ids を、command parameters[userContexts] で create a set したものとする。

4. input context ids を、command parameters[contexts] で create a set したものとする。

5. input user context ids が空でなく、かつ input context ids が空でない場合、 error を error code invalid argument とともに返す。

6. subscription navigables を set とする。

7. top-level traversable context ids を set とする。

8. input context ids が空でない場合:

   1. navigables を、 input context ids で get valid navigables by ids することを 試みた結果とする。

   2. subscription navigables を、navigables で get top-level traversables したものに設定する。

   3. subscription navigables 内の各 navigable について:

      1. navigable の navigable id を top-level traversable context ids に追加する。

9. そうでなく、input user context ids が空でない場合:

   1. input user context ids の各 user context id について反復する:

      1. user context を、user context id で get user context したものとする。

      2. user context が null である場合、error を error code no such user context とともに返す。

      3. user context である associated user context を持つ、すべての top-level traversables のリスト内の 各 top-level traversable について反復する:

         1. top-level traversable を subscription navigables に追加する。

10. そうでなければ、subscription navigables を、remote end 内のすべての top-level traversables の set に設定する。

11. subscription を、 subscription id が UUID の文字列表現に設定され、 event names が event names に設定され、 top-level traversable ids が top-level traversable context ids に設定され、 user context ids が input user context ids に設定された subscription とする。

12. subscribe step events を新しい map とする。

13. event names 内の各 event name について:

    1. event name event name を持つ event が remote end subscribe steps を定義していない場合、 continue する。

    2. existing navigables を、session および event name で set of top-level traversables for which an event is enabled したものとする。

    3. subscribe step events[event name] を、 subscription navigables と existing navigables の difference に設定する。

14. subscription を session の subscriptions に追加する。

15. subscription の subscription id を session の known subscription ids に追加する。

16. subscribe step events を、キー event name one および event name two を持つ 2 つのエントリーが与えられたときの次の less than アルゴリズムを用いて昇順に並べ替える:

    1. event one を、名前 event name one を持つ event とする

    2. event two を、名前 event name two を持つ event とする

    3. event one の subscribe priority が event two の subscribe priority より小さい場合は true を返し、そうでなければ false を返す。

17. subscription が global である場合、include global を true とし、 そうでなければ include global を false とする。

18. subscribe step events 内の各 event name → navigables について:

    1. event name event name を持つ event について、 session、navigables および include global が与えられたものとして remote end subscribe steps を実行する。

19. body を、session.SubscribeResult 生成規則に一致する 新しい map とし、 subscription フィールドを subscription の subscription id に設定する。

20. data body とともに success を返す。

session および command parameters を伴う remote end steps は次である:

1. command parameters が "subscriptions" を含まない場合:

   注: この条件は、 command parameters が session.UnsubscribeByAttributesRequest 生成規則に一致することを意味する。

   1. event names を空の set とする。

   2. command parameters["events"] 内の各エントリー name について、 event names を、 event names と、name で obtain a set of event names することを 試みた結果との union とする。

   3. new subscriptions を list とする。

   4. matched events を set とする。

   5. session の subscriptions の各 subscription について:

      1. subscription の event names と event names のintersection が空の set である場合:

         1. subscription を new subscriptions に追加する。

         2. Continue する。

      2. subscription が global でない場合:

         1. subscription を new subscriptions に追加する。

         2. Continue する。

      3. subscription event names を、subscription の event names のclone とする。

      4. event names の各 event name について:

         1. subscription event names が event name を含む場合:

            1. event name を matched events に追加する。

            2. event name を subscription event names から削除する。

      5. subscription event names が空でない場合:

         1. cloned subscription を、 subscription id が subscription の subscription id に設定され、 event names が subscription event names を含む新しい set に設定された subscription とする。

         2. cloned subscription を new subscriptions に追加する。

   6. もし matched events と 等しい関係に event names がない場合、次を返す： エラー（エラーコード invalid argument）。

   7. session の subscriptions を new subscriptions に設定する。

2. そうでなければ:

   1. subscriptions を、command parameters[subscriptions] で create a set したものとする。

   2. unknown subscription ids を、subscriptions と session の known subscription ids の間の difference とする。

   3. unknown subscription ids が空でない場合:

      1. error を error code invalid argument とともに返す。

   4. subscriptions to remove を空の set とする。

   5. session の subscriptions 内の各 subscription について:

      1. subscriptions が subscription の subscription id を含む場合:

         1. subscription を subscriptions to remove に追加する。

   6. session の known subscription ids を、 session の known subscription ids と subscriptions の間の difference に設定する。

   7. subscriptions to remove 内の各項目を session の subscriptions から削除する。

3. data null とともに success を返す。

BrowserCommand = (
    browser.Close //
    browser.CreateUserContext //
    browser.GetClientWindows //
    browser.GetUserContexts //
    browser.RemoveUserContext //
    browser.SetClientWindowState //
    browser.SetDownloadBehavior
    )

BrowserResult = (
    browser.CloseResult /
    browser.CreateUserContextResult /
    browser.GetClientWindowsResult /
    browser.GetUserContextsResult /
    browser.RemoveUserContextResult /
    browser.SetClientWindowStateResult /
    browser.SetDownloadBehaviorResult
    )

window が与えられたとき、get the client window state するには:

1. documents を空の list とする。

2. visible documents を空の list とする。

3. 各 top-level traversable traversable について:

   1. traversable の client window が window でない場合、 continue する。

   2. document を traversable の active document とする。

   3. document を documents に追加する。

   4. document の visibility state が "visible" である場合、 document を visible documents に追加する。

4. visible documents 内の各 document について:

   1. document の fullscreen element が null でない場合、 "fullscreen" を返す。

5. visible documents が空であるが documents が 空でない場合、または window がその他の OS 固有の 最小化状態にある場合、"minimized" を返す。

   注: これは通常、必ずしもそうとは限らないが、 window の width および height が 0 に等しいことを意味する。

6. window が OS 固有の最大化状態にある場合、 "maximized" を返す。

   注: これは通常、必ずしもそうとは限らないが、 window の width が web-exposed screen area の幅に等しく、 window の height が web-exposed screen area の高さに等しいことを意味する。

7. "normal" を返す。

window および state が与えられたとき、set the client window state するには:

1. current state を、window で get the client window state したものとする。

2. current state が "fullscreen"、"maximized"、または "minimized" であり、かつ state と等しい場合、data null とともに success を返す。

3. 次の条件と関連するステップのリストにおいて、 関連する条件が true である最初のステップ集合を実行する:

   "fullscreen"

   fullscreen is supported でない場合、error を error code unsupported operation とともに返す。

   "normal"

   window について restore client window is supported でない場合、error を error code unsupported operation とともに返す。

   "maximize"

   window について maximize client window is supported でない場合、error を error code unsupported operation とともに返す。

   "minimize"

   window について minimize client window is supported でない場合、error を error code unsupported operation とともに返す。

4. documents を空の list とする。

5. 各 top-level traversable traversable について:

   1. traversable に関連付けられた client window が window でない場合、 continue する。

   2. document を traversable の active document とする。

   3. document を documents に追加する。

6. documents が空である場合、 error を error code no such client window とともに返す。

7. current state が "fullscreen" である場合:

   1. documents 内の各 document について:

      1. document で Fully exit fullscreen する。

         注: これは、 fullscreen でない window 内の文書に対しては何もしない。

8. current state が "maximized" または "minimized" である場合:

   1. window で Restore the client window する。

9. state の値について分岐する:

   "fullscreen"

   1. documents 内の各 document について:

      1. document の visibility state が "visible" である場合、 document の document element で fullscreen an element する。

      2. Break する。

   "maximize"

   1. window で Maximize the client window する。

   "minimize"

   1. window で Minimize the client window する。

10. data null とともに success を返す。

browser.ClientWindow = text;

browser.ClientWindowInfo = {
  active: bool,
  clientWindow: browser.ClientWindow,
  height: js-uint,
  state: "fullscreen" / "maximized" / "minimized" / "normal",
  width: js-uint,
  x: js-int,
  y: js-int,
}

client window が与えられたとき、 get the client window info するには:

1. client window id を、client window の client window id とする。

2. state を、client window で get the client window state したものとする。

3. client window がオペレーティングシステムから送られるキーボード入力を 受け取ることができる場合、active を true とし、そうでなければ active を false とする。

   注: これは、client window である client window を持つ top-level traversable が system focus を持つことを意味する場合もあれば、 ブラウザー自体のユーザーインターフェイスが現在フォーカスを持つことを意味する場合もある。

4. client window info を、 browser.ClientWindowsInfo 生成規則に一致する map とし、 clientWindow フィールドを client window id に、state フィールドを state に、x フィールドを client window の x-coordinate に、y フィールドを client window の y-coordinate に、width フィールドを client window の width に、height フィールドを client window の height に、active フィールドを active に設定したものとする。

5. client window info を返す

browser.UserContext = text;

browser.UserContextInfo = {
    userContext: browser.UserContext
    }

session および command parameters を伴う remote end steps は次である:

1. session で End the session する。

2. active sessions が空でない場合、 実装は unable to close browser の error code を持つ error を返してもよく、その後 次のステップを並列に実行する:

   1. このコマンドへのレスポンスで Send a WebSocket message ステップが呼び出されるまで待つ。

   2. session で Cleanup the session する。

   注: ブラウザーが複数の自動化 セッションを持つ場合の挙動は、現在未指定である。任意のセッションが ブラウザーを閉じられるのか、最後に開かれたセッションだけが実際に ブラウザーを閉じられるのか、あるいは最初に開始されたセッションだけが可能なのかもしれない。この挙動は、 この仕様の将来のバージョンで完全に指定されるかもしれない。

3. active sessions 内の各 active session について:

   1. active session で End the session する。

   2. active session で Cleanup the session する

4. data null とともに success を返し、次のステップを並列に実行する。

   1. このコマンドへのレスポンスで Send a WebSocket message ステップが呼び出されるまで待つ。

   2. session で Cleanup the session する。

   3. top-level traversables を、どれでも Close する。ただし prompting to unload しない。

   4. 自動化下の remote end に関連付けられたリソースを クリーンアップするための実装定義のステップを実行する。

      注: たとえばこれには、自動化下のブラウザーに関連付けられた OS レベルのプロセスを正常にシャットダウンすること、remote end が自動化下にある間に作成した ユーザープロファイルデータなどの一時状態を削除すること、または WebSocket Listener をシャットダウンすることが 含まれ得る。ブラウザーおよびオペレーティングシステムの違いにより、 local ends がここで依存できる正確な不変条件を 詳細に指定することはできない。

session および command parameters を伴う remote end steps は次である:

1. user context を新しい user context とする。

2. command parameters が "acceptInsecureCerts" を含む場合:

   注: "acceptInsecureCerts" が 設定されている場合、それは accept insecure TLS flag の挙動を上書きする。

   1. acceptInsecureCerts を command parameters["acceptInsecureCerts"] とする:

   2. acceptInsecureCerts が true であり、endpoint node が insecure TLS connections の受け入れをサポートしていない場合、 unsupported operation の error code を持つ error を返す。

   3. session の user context to accept insecure certificates override map[user context] を acceptInsecureCerts に設定する。

3. command parameters が "unhandledPromptBehavior" を含む場合、 unhandled prompt behavior overrides map[user context] を command parameters["unhandledPromptBehavior"] に設定する。

4. command parameters が "proxy" を含む場合:

   1. proxy configuration を command parameters["proxy"] とする。

   2. remote end が user context ごとに proxy settings を構成できない場合、 または proxy configuration で proxy を構成できない場合、 unsupported operation の error code を持つ error を返す。

   3. session の user context to proxy configuration map[user context] を proxy configuration に設定する。

5. user context を set of user contexts に追加する。

6. user context info を、 browser.UserContextInfo 生成規則に一致する map とし、 userContext フィールドを user context の user context id に設定したものとする。

7. data user context info とともに success を返す。

remote end steps は次である:

1. client window ids を空の set とする。

2. client windows を空の list とする。

3. 各 top-level traversable traversable について:

   1. client window を、traversable に関連付けられた client window とする

   2. client window id を、client window の client window id とする。

   3. client window ids が client window id を含む場合、continue する。

   4. client window id を client window ids に追加する。

   5. client window info を、client window で get the client window info したものとする。

   6. client window info を client windows に追加する。

4. result を、 browser.GetClientWindowsResult 生成規則に一致する map とし、 clientWindows フィールドを client windows に設定したものとする。

5. data result とともに success を返す。

remote end steps は次である:

1. user contexts を空の list とする。

2. set of user contexts 内の各 user context について:

   1. user context info を、 browser.UserContextInfo 生成規則に一致する map とし、 userContext フィールドを user context の user context id に設定したものとする。

   2. user context info を user contexts に追加する。

3. result を、 browser.GetUserContextsResult 生成規則に一致する map とし、 userContexts フィールドを user contexts に設定したものとする。

4. data result とともに success を返す。

command parameters を伴う remote end steps は次である:

1. user context id を command parameters["userContext"] とする。

2. user context id が "default" である場合、error を error code invalid argument とともに返す。

3. user context を、user context id で get user context したものに設定する。

4. user context が null である場合、error を error code no such user context とともに返す。

5. 各 top-level traversable navigable について:

   1. navigable の associated user context が user context である場合:

      1. navigable を閉じる。ただし prompting to unload しない。

6. user context を set of user contexts から削除する。

7. data null とともに success を返す。

session および command parameters を伴う remote end steps は次である:

1. 実装が client window state の設定をまったくサポートしていない場合、 unsupported operation の error code を持つ error を返す。

2. command parameters["clientWindow"] の client window id を持つ client window が存在する場合、client window をその client window とする。 そうでなければ、no such client window の error code を持つ error を返す。

3. client window および command parameters["state"] で set the client window state することを試みる。

4. command parameters["state"] が "normal" である場合:

   1. command parameters が "x" を含み、かつ実装が client windows の位置指定をサポートする場合、client window の x-coordinate を、 command parameters["x"] に可能な限り近い値に設定する。

   2. command parameters が "y" を含み、かつ実装が client windows の位置指定をサポートする場合、client window の y-coordinate を、 command parameters["y"] に可能な限り近い値に設定する。

   3. command parameters が "width" を含み、かつ実装が client windows のリサイズをサポートする場合、 client window の width を command parameters["width"] に可能な限り近い値に設定する。

   4. command parameters が "width" を含み、かつ実装が client windows のリサイズをサポートする場合、 client window の width を command parameters["width"] に可能な限り近い値に設定する。

5. client window info を、client window で get the client window info したものとする。

6. data client window info とともに success を返す。

注: 単純化のため、これはすべての client window 操作を 同期的なものとしてモデル化している。したがって、返される client window の寸法は、 window が新しい状態に到達した後のものになることが期待される。

navigable が与えられたとき、 get download behavior するには:

1. user context を navigable の associated user context とする。

2. download behavior の user context download behavior が user context を含む場合、download behavior の user context download behavior[user context] を返す。

3. download behavior の default download behavior を返す。

session および command parameters を伴う remote end steps は次である:

1. command parameters["downloadBehavior"] が null である場合、 download behavior を null とする。

2. そうでなければ:

   1. command parameters["downloadBehavior"]["type"] が "allowed" である場合、allowed を true とし、そうでなければ allowed を false とする。

   2. command parameters["downloadBehavior"] が "destinationFolder" を含む場合、destinationFolder を command parameters["downloadBehavior"]["destinationFolder"] とし、 そうでなければ destinationFolder を null とする。

   3. download behavior を、allowed が allowed に設定され、 destinationFolder が destinationFolder に設定された download behavior struct とする。

3. 実装が要求された download behavior をサポートしていない場合、 error を error code unsupported operation とともに返す。

4. command parameters の userContexts フィールドが存在する場合:

   1. user contexts を、 command parameters["userContexts"] で get valid user contexts することを試みた結果とする。

   2. user contexts の各 user context について:

      1. download behavior が null である場合、user context を download behavior の user context download behavior から削除する。

      2. そうでなければ、download behavior の user context download behavior[user context] を download behavior に設定する。

5. そうでなければ、download behavior の default download behavior を download behavior に設定する。

6. data null とともに success を返す。

BrowsingContextCommand = (
  browsingContext.Activate //
  browsingContext.CaptureScreenshot //
  browsingContext.Close //
  browsingContext.Create //
  browsingContext.GetTree //
  browsingContext.HandleUserPrompt //
  browsingContext.LocateNodes //
  browsingContext.Navigate //
  browsingContext.Print //
  browsingContext.Reload //
  browsingContext.SetBypassCSP //
  browsingContext.SetViewport //
  browsingContext.StartScreencast //
  browsingContext.StopScreencast //
  browsingContext.TraverseHistory
)

BrowsingContextResult = (
  browsingContext.ActivateResult /
  browsingContext.CaptureScreenshotResult /
  browsingContext.CloseResult /
  browsingContext.CreateResult /
  browsingContext.GetTreeResult /
  browsingContext.HandleUserPromptResult /
  browsingContext.LocateNodesResult /
  browsingContext.NavigateResult /
  browsingContext.PrintResult /
  browsingContext.ReloadResult /
  browsingContext.SetBypassCSPResult /
  browsingContext.SetViewportResult /
  browsingContext.StartScreencastResult /
  browsingContext.StopScreencastResult /
  browsingContext.TraverseHistoryResult
)

BrowsingContextEvent = (
  browsingContext.ContextCreated //
  browsingContext.ContextDestroyed //
  browsingContext.DomContentLoaded //
  browsingContext.DownloadEnd //
  browsingContext.DownloadWillBegin //
  browsingContext.FragmentNavigated //
  browsingContext.HistoryUpdated //
  browsingContext.Load //
  browsingContext.NavigationAborted //
  browsingContext.NavigationCommitted //
  browsingContext.NavigationFailed //
  browsingContext.NavigationStarted //
  browsingContext.UserPromptClosed //
  browsingContext.UserPromptOpened
)

スクリーンキャスト記録 recording と mime type が与えられたとき、スクリーンキャスト記録を開始するには：

1. 以下の手順を並列に実行する：

   1. mime typeを用いてrecordingのstreamの符号化を開始し、 符号化済みデータの連続するチャンクをバイト シーケンスとして生成する。 recordingのstateが "recording" である間、 実装定義の間隔で新しいチャンクを生成する。

   2. recordingについて生成された各チャンク bytes について、以下の手順を実行する：

      1. bytesをrecordingのpathにあるファイルに追加する。 これが失敗した場合：

         1. recordingのwriteErrorを、 書き込み失敗を説明する実装定義の文字列に設定する。

         2. recordingが与えられたとして、スクリーンキャスト記録を停止する。

スクリーンキャスト記録 recording が与えられたとき、スクリーンキャスト記録を停止するには：

1. recordingのstateが "recording" でないなら、 戻る。

2. recordingのstateを "stopping" に設定する。

3. recordingについて新しいチャンクを生成することを停止し、残っている符号化済み データを最終チャンクとしてフラッシュし（スクリーンキャスト 記録を開始するの場合と同様に処理される）、 recordingのstreamからのキャプチャを停止し、 その 映像トラックと、存在する場合はその 音声トラックを解放し、その後 recordingの stateを "stopped" に設定する。

4. recordingのstateが "stopped" になるまで待つ。

browsingContext.BrowsingContext = text;

navigable id が与えられたとき、 get a navigable するには:

1. navigable id が null である場合、data null とともに success を返す。

2. navigable id navigable id を持つ navigable が存在しない場合、 no such frame の error code を持つ error を返す

3. navigable を、id navigable id を持つ navigable とする。

4. data navigable とともに success を返す。

browsingContext.InfoList = [*browsingContext.Info]

browsingContext.BaseInfo = (
  children: browsingContext.InfoList / null,
  clientWindow: browser.ClientWindow,
  context: browsingContext.BrowsingContext,
  originalOpener: browsingContext.BrowsingContext / null,
  url: text,
  userContext: browser.UserContext,
  ? parent: browsingContext.BrowsingContext / null,
)

browsingContext.Info = {
  browsingContext.BaseInfo
}

navigable が与えられたとき、 get the child navigables するには:

TODO: これが文書順のリストを返すようにする

1. child navigables を、navigable の child navigable であるすべての navigables を含む set とする。

2. child navigables を返す。

navigable、 max depth および include parent id が与えられたとき、 get the navigable info するには:

1. navigable id を、navigable の navigable id とする。

2. parent navigable を navigable の parent とする。

3. parent navigable が null でない場合、parent id を parent navigable の navigable id とする。 そうでなければ、 parent id を null とする。

4. document を navigable の active document とする。

5. url を、document の URL が与えられたものとして URL serializer を実行した結果とする。

   注: これは URL の fragment component を含む。

6. child infos を null とする。

7. max depth が null である、または max depth が 0 より大きい場合:

   1. child navigables を、navigable が与えられたものとして get the child navigables したものとする。

   2. max depth が null でない場合、child depth を max depth - 1 とし、そうでなければ null とする。

   3. child infos を空の list に設定する。

   4. child navigables の各 child navigable について:

      1. info を、 child navigable、child depth および false が与えられたものとして get the navigable info した結果とする。

      2. info を child infos に追加する

8. user context を navigable の associated user context とする。

9. navigable の original opener が null でない場合、 opener id を navigable の original opener の navigable id とし、 そうでなければ null とする。

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

11. client window id を、top-level traversable に関連付けられた client window の client window id とする。

12. navigable info を、 browsingContext.Info 生成規則に一致する map とし、context フィールドを navigable id に、include parent id が true である場合は parent フィールドを parent id に設定し、そうでなければ未設定とし、 url フィールドを url に、userContext フィールドを user context の user context id に、originalOpener フィールドを opener id に、children フィールドを child infos に、 clientWindow フィールドを client window id に設定したものとする。

13. navigable info を返す。

navigable、request、wait condition、および任意で history handling（デフォルト: "default"）と ignore cache（デフォルト: false）が 与えられたとき、await a navigation するには:

1. navigation id を、真のランダムまたは擬似ランダムな数値に基づく UUID の文字列表現とする。

2. navigable を resource request で navigate し、source Document として navigable の active document を用い、 navigation id navigation id および history handling behavior history handling を用いる。ignore cache が true である場合、 そのナビゲーションは HTTP cache からリソースを読み込んではならない。

   ignore cache flag がどのように機能するかを適切に指定する必要がある。これは、リソースの最初の読み込みだけが cache をバイパスするのか （すなわち、最初に cache をクリアして通常どおり進むのと同様であるか）、 または HTML parser によって直接読み込まれないリソース （例: scripts または stylesheets によって開始される読み込み）も cache をバイパスするのかを考慮する必要がある。

3. (event received, navigation status) を、 «"navigation started", "navigation failed", "fragment navigated"» および navigation id が与えられたものとして await したものとする。

4. Assert: navigation status の id は navigation id である。

5. navigation status の status が "complete" である場合:

   1. body を、 browsingContext.NavigateResult 生成規則に一致する map とし、 navigation フィールドを navigation id に、url フィールドを navigation status の url が与えられたものとして URL serializer を実行した結果に設定したものとする。

   2. data body とともに success を返す。

   注: これは、そのナビゲーションが fragment の変更だけを 引き起こした場合である。

6. navigation status の status が "canceled" である場合、 unknown error の error code を持つ error を返す。

   TODO: ここでエラーを扱うにはこれが正しい方法か?

7. Assert: navigation status の status は "pending" であり、navigation id は null でない。

8. wait condition が "committed" である場合、event name を "committed" とする。

9. そうでなく、wait condition が "interactive" である場合、event name を "domContentLoaded" とする。

10. そうでなければ、event name を "load" とする。

11. (event received, status) を、 «event name, "download started", "navigation aborted", "navigation failed"» および navigation id が与えられたものとして await したものとする。

12. event received が "navigation failed" である場合、 unknown error の error code を持つ error を返す。

    ここでの error により、何が失敗し、なぜ失敗したのかについて十分な情報を 表面化できているか? どの error code が望ましいか? local ends が実装定義の文字列を 解析して、実際に何が問題だったのかを把握しようとする問題は生じるか?

13. body を、 browsingContext.NavigateResult 生成規則に一致する map とし、 navigation フィールドを status の id に、 url フィールドを status の url が与えられたものとして URL serializer を実行した結果に設定したものとする。

14. data body とともに success を返す。

browsingContext.Locator = (
   browsingContext.AccessibilityLocator /
   browsingContext.CssLocator /
   browsingContext.ContextLocator /
   browsingContext.InnerTextLocator /
   browsingContext.XPathLocator
)

browsingContext.AccessibilityLocator = {
   type: "accessibility",
   value: {
    ? name: text,
    ? role: text,
   }
}

browsingContext.CssLocator = {
   type: "css",
   value: text
}

browsingContext.ContextLocator = {
  type: "context",
  value: {
    context: browsingContext.BrowsingContext,
  }
}

browsingContext.InnerTextLocator = {
   type: "innerText",
   value: text,
   ? ignoreCase: bool
   ? matchType: "full" / "partial",
   ? maxDepth: js-uint,
}

browsingContext.XPathLocator = {
   type: "xpath",
   value: text
}

browsingContext.Navigation = text;

browsingContext.Download = text;

browsingContext.BaseNavigationInfo = (
  context: browsingContext.BrowsingContext,
  navigation: browsingContext.Navigation / null,
  timestamp: js-uint,
  url: text,
  ? userContext: browser.UserContext,
)

browsingContext.NavigationInfo = {
  browsingContext.BaseNavigationInfo
}

navigable navigable および navigation status navigation status が与えられたとき、 get the navigation info するには:

1. navigable id を、navigable の navigable id とする。

2. navigation id を navigation status の id とする。

3. timestamp を、UTC での現在の日付および時刻を表す time value とする。

4. url を navigation status の url とする。

5. user context id を、navigable の associated user context の user context id とする。

6. browsingContext.NavigationInfo 生成規則に一致する map を返す。 context フィールドは navigable id に、navigation フィールドは navigation id に、timestamp フィールドは timestamp に、 url フィールドは url が与えられたものとして URL serializer を実行した結果に、 userContext フィールドは user context id に設定される。

browsingContext.ReadinessState = "none" / "interactive" / "complete"

browsingContext.UserPromptType = "alert" / "beforeunload" / "confirm" / "prompt";

command parameters を伴う remote end steps は次である:

1. navigable id を command parameters["context"] フィールドの値とする。

2. navigable を、navigable id で get a navigable することを試みた結果とする。

3. navigable が top-level traversable でない場合、 invalid argument の error code を持つ error を返す。

4. navigable で activate a navigable した結果を返す。

navigable が与えられたとき、 activate a navigable するには:

1. navigable の system visibility state が visible になるように、実装固有のステップを実行する。 これが不可能である場合、error code unsupported operation を持つ error を返す。

   注: これは、現在 visible である navigables を hidden にする副作用を持ち得る。

   注: これは、window を最小化解除すること、または system visibility state の変更に関連するその他の副作用により、 基礎となる OS 状態を変更し得る。

2. navigable がフォーカスされていない場合、navigable に system focus を設定するための実装固有のステップを実行する。

   注: これは、他の仕様で義務付けられている場合を除き、 focused area of the document を変更しない。

3. data null とともに success を返す。

rect が与えられたとき、 normalize rect するには:

注: これは、結果の rect が正の width dimension および height dimension を持つことを保証する。

1. x を rect の x coordinate とする。

2. y を rect の y coordinate とする。

3. width を rect の width dimension とする。

4. height を rect の height dimension とする。

5. width が 0 未満である場合、x を x + width に設定し、 その後 width を -width に設定する。

6. height が 0 未満である場合、y を y + height に設定し、 その後 height を -height に設定する。

7. x coordinate x、y coordinate y、width dimension width および height dimension height を持つ新しい DOMRectReadOnly を返す。

rect1 および rect2 が与えられたとき、 rectangle intersection するには

1. rect1 を、rect1 で normalize rect したものとする。

2. rect2 を、rect2 で normalize rect したものとする。

3. x1_0 を rect1 の x coordinate とする。

4. x2_0 を rect2 の x coordinate とする。

5. x1_1 を、rect1 の x coordinate に rect1 の width dimension を加えたものとする。

6. x2_1 を、rect2 の x coordinate に rect2 の width dimension を加えたものとする。

7. x_0 を «x1_0, x2_0» の最大要素とする。

8. x_1 を «x1_1, x2_1» の最小要素とする。

9. y1_0 を rect1 の y coordinate とする。

10. y2_0 を rect2 の y coordinate とする。

11. y1_1 を、rect1 の y coordinate に rect1 の height dimension を加えたものとする。

12. y2_1 を、rect2 の y coordinate に rect2 の height dimension を加えたものとする。

13. y_0 を «y1_0, y2_0» の最大要素とする。

14. y_1 を «y1_1, y2_1» の最小要素とする。

15. x_1 が x_0 未満である場合、width を 0 とする。そうでなければ width を x_1 - x_0 とする。

16. y_1 が y_0 未満である場合、height を 0 とする。そうでなければ height を y_1 - y_0 とする。

17. x coordinate x_0、y coordinate y_0、width dimension width および height dimension height を持つ新しい DOMRectReadOnly を返す。

数値を丸めるには、 numberを与えて、次の手順を実行する：

1. numberが有限でないか、またはnumberが整数の Numberである場合、numberを返す。

2. number < 0.5𝔽かつnumber > +0𝔽である場合、+0𝔽を返す。

3. number < -0𝔽かつn ≥ -0.5𝔽である場合、-0𝔽を返す。

4. numberに最も近い整数のNumberを返す。同距離の場合は、 +∞に近いNumberを優先する。

document、rect、image sizeが与えられたとき、文書を canvas にレンダリングするには、次の手順を実行する。

1. ratioを、documentの デフォルトビューを与えて デバイスピクセル比を決定することによって得られる値とする。

2. framebuffer widthを、rectの幅の寸法に ratioを乗じた値とし、デバイスピクセル単位でrectの幅と一致するようにする。

3. framebuffer heightを、rectの高さの寸法に ratioを乗じた値とし、デバイスピクセル単位でrectの高さと一致するようにする。

4. scaleを 1 とする。

5. image sizeが null でない場合:

   1. max widthを、存在する場合はimage sizeのmaxWidthフィールド、 そうでない場合は null とする。

   2. max heightを、存在する場合はimage sizeのmaxHeightフィールド、 そうでない場合は null とする。

   3. max widthが null でなく、max widthをframebuffer widthで除算した値 がscaleより小さい場合、scaleをmax widthを framebuffer widthで除算した値に設定する。

   4. max heightが null でなく、max heightを framebuffer heightで除算した値がscaleより小さい場合、scaleをmax heightを framebuffer heightで除算した値に設定する。

6. scaleが 1 より小さい場合:

   1. scale widthを、framebuffer widthに scaleを乗じた値を与えて数値を丸めることによって得られる値とする。

   2. scale heightを、framebuffer heightに scaleを乗じた値を与えて数値を丸めることによって得られる値とする。

   3. paint widthを 1 とscale widthの最大値とする。

   4. paint heightを 1 とscale heightの最大値とする。

7. そうでない場合:

   1. paint widthをframebuffer widthとする。

   2. paint heightをframebuffer heightとする。

8. canvasを、widthが paint width、heightが paint heightである新しいHTMLCanvasElement とする。

9. canvas contextを、canvasと null を用いて2D コンテキスト作成アルゴリズム を実行した結果とする。

10. canvasのコンテキストモードを2Dに設定する。

11. source xをrectのx 座標にratioを乗じた値とし、 また source yをrectのy 座標にratioを乗じた値とする。

12. source rectangleを、その四隅が次の 4 点である矩形とする。 (source x, source y)、(source x + framebuffer width, source y)、 (source x + framebuffer width, source y + framebuffer height)、および (source x, source y + framebuffer height)。

13. destination rectangleを、その四隅が次の 4 点である矩形とする。 (0, 0)、(paint width, 0)、(paint width, paint height)、 および (0, paint height)。

14. source rectangleで指定された documentのフレームバッファの領域を、destination rectangleで指定された canvas contextの出力ビットマップの領域に描画することと等価な、実装固有の手順を完了する。

    destination rectangleの寸法がsource rectangleより小さい場合、 destination rectangle内のある点に描画される値は、 documentのフレームバッファのデータをフィルタリングすることによって計算される。ユーザーエージェントは 任意のフィルタリングアルゴリズム（たとえば、バイリニア補間または最近傍法）を使用してよい。 フィルタリングアルゴリズムがフレームバッファの外側にあるピクセル値を必要とする場合、 代わりに最も近い端のピクセルの値を使用しなければならない。（つまり、フィルターは "clamp-to-edge" 動作を使用する。） フィルタリングアルゴリズムがsource rectangleの外側 かつフレームバッファの内側にあるピクセル値を必要とする場合、フレームバッファの値を使用しなければならない。

15. canvasを返す。

キャンバスをBase64 としてエンコードするには、canvasおよびformatを与えて、次の手順を実行する：

1. formatがnullでない場合、typeをformatのtypeフィールド、 qualityをformatのqualityフィールドとする。

2. それ以外の場合、typeを"image/png"とし、qualityをundefinedとする。

3. fileを、canvasについて typeおよびqualityを用いたファイルとしてのビットマップのシリアル化とする。

4. encoded stringを、fileの寛容なBase64エンコードとする。

5. データencoded stringを伴う成功を返す。

原点の 矩形を取得するには、documentおよびoriginを与えて、次の手順を実行する：

1. originが"viewport"である場合：

   1. viewportを、documentの視覚ビューポートとする。

   2. viewport rectを、x座標が viewportのページ左端、y座標が viewportのページ上端、幅の寸法が viewportの幅、そして高さの寸法がviewportの 高さであるDOMRectReadOnlyとする。

   3. データviewport rectを伴う成功を返す。

2. 表明：originは"document"である。

3. document elementを、documentの文書要素とする。

4. document rectを、x座標が0、y座標が0、幅の寸法がdocument elementのスクロール高さ、 そして高さの寸法がdocument elementのスクロール幅であるDOMRectReadOnlyとする。

5. データdocument rectを伴う成功を返す。

command parameters を伴う remote end steps は次である:

1. navigable id を command parameters の context フィールドの値とする。

2. prompt unload を command parameters の promptUnload フィールドの値とする。

3. navigable を、navigable id で get a navigable することを試みた結果とする。

4. Assert: navigable は null でない。

5. navigable が top-level traversable でない場合、 invalid argument の error code を持つ error を返す。

6. prompt unload が true である場合:

   1. navigable を閉じる。

7. そうでなければ:

   1. Close navigable without prompting to unload.

8. data null とともに success を返す。

最後の top-level traversable を閉じるときの挙動について、 未解決の議論がある。ブラウザーを閉じること、セッションを閉じること、またはこれを実装に委ねることが 期待され得る。[w3c/webdriver-bidi Issue #170]

command parameters を伴う remote end steps は次である:

1. typeを、command parametersのtypeフィールドの値とする。

2. reference navigable idを、存在する場合はcommand parametersの referenceContextフィールドの値、そうでなければ null とする。

3. reference navigable idが null でない場合、reference navigableを、 reference navigable idで試行してnavigable を取得する結果とする。 そうでなければ、reference navigableを null とする。

4. reference navigableが null でなく、かつトップレベル辿可能でない場合、 エラーを、エラー コードinvalid argumentで返す。

5. 実装が何らかの理由で新しいトップレベル辿可能を作成できない場合、 エラーを、エラー コードunsupported operationで返す。

6. user contextを、reference navigableが null である場合は既定のユーザーコンテキスト、 そうでなければreference navigableの関連付けられたユーザー コンテキストとする。

7. user context idを、存在する場合はcommand parametersの userContextフィールドの値、そうでなければ null とする。

8. user context idが null でない場合、user contextを、 user context idで試行してユーザーコンテキストを取得する結果に設定する。

9. user contextが null である場合、エラーを、エラーコードそのようなユーザー コンテキストはないで返す。

10. 実装が何らかの理由で、トップレベル辿可能を 関連付けられたユーザーコンテキスト user context とともに新しく作成できない場合、 エラーを、エラー コードunsupported operationで返す。

11. traversable を、null、空文字列、 null、および false を指定して 新しいトップレベル traversable を作成する 手順を試行した結果とし、新しく作成された 関連付けられたユーザーコンテキスト を トップレベル traversable の user context に設定する。 新しい トップレベル traversable がどの OS ウィンドウに作成されるかは、 type および reference navigable に依存する：

    • typeが "tab" であり、実装が同じ OS ウィンドウ内の複数のトップレベル辿可能をサポートする場合：

      • 新しいトップレベル辿可能は、 既存の OS ウィンドウがあれば、それを再利用するべきである。

      • reference navigableが null でない場合、新しいトップレベル辿可能は、 reference navigableを含むウィンドウがあれば、それを再利用するべきである。OS ウィンドウ内の トップレベル辿可能たちに明確な順序がある場合、 新しいトップレベル辿可能は、その順序において reference navigableのトップレベル辿可能の直後にあるべきである。

    • typeが "window" であり、実装が別々の OS ウィンドウ内の複数のトップレベル辿可能をサポートする場合、作成された トップレベル辿可能は新しい OS ウィンドウ内にあるべきである。

    • そうでなければ、トップレベル辿可能がユーザーにどのように提示されるかの詳細は、 実装定義である。

12. command parametersのbackgroundフィールドの値が false である場合：

    1. activate resultを、新しく作成されたnavigableでnavigable を有効化する結果とする。

    2. activate resultがエラーである場合、 activate resultを返す。

    注記： backgroundが true である場合、作成された navigable に対してフォーカス手順を呼び出してはならない。

13. bodyを、contextフィールドがtraversableのnavigable IDに設定され、 userContextプロパティがtraversableの 関連付けられたユーザーコンテキストのユーザー コンテキスト IDに設定された、 browsingContext.CreateResult 生成規則に一致するマップとする。

14. 成功をデータ body とともに返す。

session および command parameters を伴う remote end steps は次である:

1. root id を、command parameters に root フィールドが存在する場合は その値とし、そうでなければ null とする。

2. max depth を、command parameters に maxDepth フィールドが存在する場合はその値とし、そうでなければ null とする。

3. navigables を空の list とする。

4. root id が null でない場合、 root id が与えられたものとして get a navigable することを試みた結果を navigables に追加する。 そうでなければ、すべての top-level traversables を navigables に追加する。

5. navigables infos を空の list とする。

6. navigables の各 navigable について:

   1. info を、 navigable、max depth、および true が与えられたものとして get the navigable info した結果とする。

   2. info を navigables infos に追加する

7. body を、browsingContext.GetTreeResult 生成規則に一致する map とし、contexts フィールドを navigables infos に設定したものとする。

8. data body とともに success を返す。

session および command parameters を伴う remote end steps は次である:

1. navigable id を command parameters の context フィールドの値とする。

2. navigable を、navigable id で get a navigable することを試みた結果とする。

3. accept を、 command parameters に accept フィールドが存在する場合はその値とし、 そうでなければ true とする。

4. userText を、 command parameters に userText フィールドが存在する場合はその値とし、 そうでなければ空文字列とする。

5. navigable が現在、alert の呼び出しによる simple dialog を表示している場合、 prompt を acknowledge する。

   そうでなく、navigable が現在 confirm の呼び出しによる simple dialog を表示している場合、 accept が true なら肯定的に応答し、 accept が false なら否定的に応答する。

   そうでなく、navigable が現在 prompt の呼び出しによる simple dialog を表示している場合、 accept が true なら文字列値 userText で応答し、accept が false なら中止する。

   そうでなく、navigable が現在 prompt to unload steps の一部として prompt を表示している場合、 accept が true なら navigation を確認し、そうでなければ navigation を拒否する。

   そうでなければ、no such alert の error code を持つ error を返す。

6. data null とともに success を返す。

与えられた navigable、context nodes、 selector、maximum returned node count、および session で locate nodes using CSS するには:

1. returned nodes を空の list とする。

2. parse result を、selector が与えられたものとして parse a selector した結果とする。

3. parse result が failure である場合、invalid selector の error code を持つ error を返す。

4. context nodes の各 context node について:

   1. elements を、 parse result および navigable の active document の root を用い、 scoping root context node を用いて match a selector against a tree した結果とする。

   2. elements 内の各 element について:

      1. element を returned nodes に追加する。

      2. maximum returned node count が null でなく、かつ returned nodes の size が maximum returned node count に等しい場合、 data returned nodes とともに success を返す。

5. data returned nodes とともに success を返す。

navigable が与えられたとき、 locate the container element するには:

1. returned nodes を空の list とする。

2. navigable の container が null でない場合、 navigable の container を returned nodes に追加する。

3. returned nodes を返す。

与えられた navigable、context nodes、 selector、および maximum returned node count で locate nodes using XPath するには:

注: XPath 仕様が保守されていない状態であるため、 このアルゴリズムは XPath DOM APIs への呼び出しを行うかのように記述されている。 しかしこれは、ECMAScript runtime を経由せずに、基礎となるアルゴリズムへ直接アクセスする 仕様内部の呼び出しと等価であると理解されるべきである。

1. returned nodes を空の list とする。

2. context nodes の各 context node について:

   1. evaluate result を、navigable の active document 上で、引数 selector、 context node、null、 ORDERED_NODE_SNAPSHOT_TYPE、 および null を用いて evaluate を呼び出した結果とする。 これが "SyntaxError" DOMException を投げる場合、 invalid selector の error code を持つ error を返す; そうでなく、これが他の例外を投げる場合、unknown error の error code を持つ error を返す。

   2. index を 0 とする。

   3. length を、evaluate result から snapshotLength プロパティを 取得した結果とする。

   4. index が length 未満である間、繰り返す:

      1. node を、evaluate result を this とし、index を引数として snapshotItem を呼び出した結果とする。

      2. node を returned nodes に追加する。

      3. maximum returned node count が null でなく、かつ returned nodes の size が maximum returned node count に等しい場合、 data returned nodes とともに success を返す。

      4. index を index + 1 に設定する。

3. data returned nodes とともに success を返す。

与えられた context nodes、selector、max depth、 match type、ignore case、および maximum returned node count で locate nodes using inner text するには:

1. selector が空文字列である場合、 invalid selector の error code を持つ error を返す。

2. returned nodes を空の list とする。

3. ignore case が false である場合、search text を selector とする。そうでなければ、 search text を、Unicode Default Case Conversion algorithm に従って、 selector で toUppercase した結果とする。

4. context nodes 内の各 context node について:

   1. context node が Document または DocumentFragment を実装している場合:

      注: document または document fragment をたどるとき、document と document.documentElement で検索結果が等価になるように、 max depth は意図的に減らされない。

      1. child nodes を空の list とする。

      2. context node の children 内の各 node child について。

         1. child を child nodes に追加する。

      3. child nodes、selector、max depth、 match type、ignore case、および maximum returned node count で locate nodes using inner text することを試みた結果で returned nodes を拡張する。

   2. context node が HTMLElement を実装していない場合、continue する。

   3. node inner text を、 context node を this 値として innerText getter steps を呼び出した結果とする。

   4. ignore case が false である場合、node text を node inner text とする。そうでなければ、 node text を、Unicode Default Case Conversion algorithm に従って、 node inner text で toUppercase した結果とする。

   5. search text が node text の code point substring である場合、 次のステップを実行する:

      1. child nodes を空の list とし、 context node の children 内の各 node child について:

         1. child を child nodes に追加する。

      2. child nodes の size が 0 に等しい、または max depth が 0 に等しい場合、 次のステップを実行する:

         1. match type が "full" であり、node text が search text である場合、 context node を returned nodes に追加する。

         2. そうでなく、match type が "partial" である場合、 context node を returned nodes に追加する。

      3. そうでなければ、次のステップを実行する:

         1. max depth が null である場合、child max depth を null とし、 そうでなければ max depth - 1 とする。

         2. child node matches を、 child nodes、selector、child max depth、match type、 ignore case、および maximum returned node count で locate nodes using inner text した結果とする。

         3. child node matches の size が 0 に等しく、かつ match type が "partial" である場合、context node を returned nodes に追加する。そうでなければ、 child node matches で returned nodes を 拡張する。

5. maximum returned node count が null でない場合、returned nodes 内で index が maximum returned node count 以上であるすべての entries を削除する。

6. data returned nodes とともに success を返す。

与えられた context nodes、selector、 maximum returned node count、および returned nodes で collect nodes using accessibility attributes するには:

1. returned nodes が null である場合:

   1. returned nodes を空の list に設定する。

2. context nodes 内の各 context node について:

   1. match を true とする。

   2. context node が Element を実装している場合:

      1. selector が "role" を含む場合:

         1. role を context node の computed role とする。

         2. selector["role"] が role でない場合:

            1. match を false に設定する。

      2. selector が "name" を含む場合:

         1. name を context node の accessible name とする。

         2. selector["name"] が name でない場合:

            1. match を false に設定する。

   3. そうでなければ、match を false に設定する。

   4. match が true である場合:

      1. maximum returned node count が null でなく、かつ returned nodes の size が maximum returned node count に等しい場合、 break する。

      2. context node を returned nodes に追加する。

   5. child nodes を空の list とし、 context node の children 内の各 node child について:

      1. child が Element を実装している場合、 child を child nodes に追加する。

   6. child nodes、 selector、maximum returned node count、および returned nodes で collect nodes using accessibility attributes することを試みる。

3. returned nodes を返す。

与えられた context nodes、selector、および maximum returned node count で locate nodes using accessibility attributes するには:

1. selector が "role" を含まず、 かつ selector が "name" を含まない場合、 invalid selector の error code を持つ error を返す。

2. context nodes、 selector、maximum returned node count、および null で collect nodes using accessibility attributes した結果を返す。

session および command parameters を伴う remote end steps は次である:

1. navigable id を command parameters["context"] とする。

2. navigable を、navigable id で get a navigable することを試みた結果とする。

3. Assert: navigable は null でない。

4. realm を、 navigable の navigable id および null で get a realm from a navigable することを試みた結果とする。

5. locator を command parameters["locator"] とする。

6. command parameters が "startNodes" を含む場合、 start nodes parameter を command parameters["startNodes"] とする。 そうでなければ、start nodes parameter を null とする。

7. command parameters が "maxNodeCount" を含む場合、 maximum returned node count を command parameters["maxNodeCount"] とする。 そうでなければ、maximum returned node count を null とする。

8. context nodes を空の list とする。

9. start nodes parameter が null である場合、navigable の active document を context nodes に追加する。 そうでなければ、start nodes parameter 内の各 serialized start node について:

   1. start node を、 serialized start node、realm、および session が与えられたものとして deserialize shared reference することを試みた結果とする。

   2. start node を context nodes に追加する。

10. context nodes の size が 0 より大きいことを Assert する。

11. type を locator["type"] とする。

12. 次の条件と関連するステップのリストにおいて、関連する条件が true である最初の ステップセットを実行する:

    type が文字列 "css" である

    1. selector を locator["value"] とする。

    2. result nodes を、navigable、context nodes、 selector、および maximum returned nodes が与えられたものとして locate nodes using css することを試みた結果とする。

    type が文字列 "xpath" である

    1. selector を locator["value"] とする。

    2. result nodes を、navigable、context nodes、 selector、および maximum returned nodes が与えられたものとして locate nodes using xpath することを試みた結果とする。

    type が文字列 "innerText" である

    1. selector を locator["value"] とする。

    2. locator が maxDepth を含む場合、max depth を locator["maxDepth"] とする。そうでなければ、max depth を null とする。

    3. locator が ignoreCase を含む場合、 ignore case を locator["ignoreCase"] とする。そうでなければ、ignore case を false とする。

    4. locator が matchType を含む場合、 match type を locator["matchType"] とする。そうでなければ、match type を "full" とする。

    5. result nodes を、 context nodes、selector、max depth、 match type、 ignore case および maximum returned node count が与えられたものとして locate nodes using inner text することを試みた結果とする。

    type が文字列 "accessibility" である

    1. selector を locator["value"] とする。

    2. result nodes を、 context nodes、selector、および maximum returned node count が与えられたものとして locate nodes using accessibility attributes したものとする。

    type が文字列 "context" である

    1. start nodes parameter が null でない場合、 error code "invalid argument" を持つ error を返す。

    2. selector を locator["value"] とする。

    3. context id を selector["context"] とする。

    4. child navigable を、 context id で get a navigable することを試みた結果とする。

    5. child navigable の parent が navigable でない場合、 error code "invalid argument" を持つ error を返す。

    6. result nodes を、child navigable が与えられたものとして locate the container element したものとする。

    7. Assert: result nodes 内の各 node について、 node の node navigable は navigable である。

13. Assert: maximum returned node count は null である、または result nodes の size は maximum returned node count 以下である。

14. command parameters が "serializationOptions" を含む場合、 serialization options を command parameters["serializationOptions"] とする。 そうでなければ、serialization options を、 フィールドを既定値に設定した script.SerializationOptions 生成規則に一致する map とする。

15. result ownership を "none" とする。

16. serialized nodes を空の list とする。

17. result nodes 内の各 result node について:

    1. serialized node を、 result node、serialization options、result ownership、 serialization internal map としての新しい map、 realm および session で serialize as a remote value した結果とする。

    2. serialized node を serialized nodes に追加する。

18. result を、 browsingContext.LocateNodesResult 生成規則に一致する map とし、nodes フィールドを serialized nodes に設定したものとする。

19. data result とともに success を返す。

session および command parameters を伴う remote end steps は次である:

1. navigable id を command parameters の context フィールドの値とする。

2. navigable を、navigable id で get a navigable することを試みた結果とする。

3. Assert: navigable は null でない。

4. wait condition を "committed" とする。

5. command parameters が wait を含み、 かつ command parameters[wait] が "none" でない場合、 wait condition を command parameters[wait] に設定する。

6. url を command parameters の url フィールドの値とする。

7. document を navigable の active document とする。

8. base を document の base URL とする。

9. url record を、base URL base で url に URL parser を適用した結果とする。

10. url record が failure である場合、invalid argument の error code を持つ error を返す。

11. request を、URL が url record である新しい request とする。

12. navigable、 request および wait condition で await a navigation した結果を返す。

sessionおよびcommand parametersを伴うリモートエンド手順は次のとおりである：

1. navigable idを、command parametersのcontextフィールドの値とする。

2. navigableを、navigable idで試行してnavigable を取得する 結果とする。

3. 実装が何らかの理由でnavigableのページ分割された表現を提供できない場合、 エラーを、エラーコード unsupported operationで返す。

4. marginを、存在する場合はcommand parametersのmarginフィールドの値、そうでなければ フィールドが既定値に設定された browsingContext.PrintMarginParametersに一致する マップとする。

5. page sizeを、存在する場合はcommand parametersのpageフィールドの値、そうでなければ フィールドが既定値に設定された browsingContext.PrintPageParametersに一致する マップとする。

注記： 最小ページサイズは 1 ポイントであり、これは 絶対長に従うと (2.54 / 72) cm である。

1. page rangesを、存在する場合は command parametersのpageRangesフィールドの値、そうでなければ空のリストとする。

2. documentを、navigableのアクティブ文書とする。

3. documentに対するアニメーションフレームコールバックを実行する アルゴリズムの次の呼び出しの直後に：

   これは、より明示的な方法で レンダリング更新アルゴリズムに統合される べきである。 [w3c/webdriver-bidi 課題 #1131]

   1. pdf dataを、UA 固有の手順を実行してdocumentの ページ分割された表現を生成した結果とする。このとき、CSS のメディア型は printに設定され、PDF として符号化され、以下の用紙設定を用いる：

      プロパティ	値
      幅（cm）	command parameters["orientation"] が "portrait" である場合はpage size["width"]、 そうでなければpage size["height"]
      高さ（cm）	command parameters["orientation"] が "portrait" である場合はpage size["height"]、 そうでなければpage size["width"]
      上余白（cm）	margin["top"]
      下余白（cm）	margin["bottom"]
      左余白（cm）	margin["left"]
      右余白（cm）	margin["right"]

      加えて、UA は以下の整形ヒントを適用するべきである：

      command parameters["scale"] が 1と等しくない場合：

      コンテンツのサイズをcommand parameters["scale"] 倍でズームする

      command parameters["background"] が false である場合：

      背景画像の出力を抑制する

      command parameters["shrinkToFit"] が true である場合：

      コンテンツ内で指定されたページ幅を上書きし、ページ幅に合わせてコンテンツのサイズを変更する

   2. page rangesが空でない場合、 pagesを、page rangesおよびpdf dataに含まれるページ数で 試行してページ範囲をパースする結果とし、その後、1 から始まるインデックスが pagesに含まれないページをpdf dataから除去する。

   3. encoding resultを、pdf dataに対して Base64 Encodeを呼び出した結果とする。

   4. encoded dataを、encoding resultの data とする。

   5. bodyを、dataフィールドがencoded dataに設定された browsingContext.PrintResult生成規則に一致する マップとする。

   6. 成功をデータ body とともに返す。

command parameters を伴う remote end steps は次である:

1. navigable id を command parameters の context フィールドの値とする。

2. navigable を、navigable id で get a navigable することを試みた結果とする。

3. Assert: navigable は null でない。

4. ignore cache を、command parameters に ignoreCache フィールドが存在する場合はその値とし、 そうでなければ false とする。

5. wait condition を "committed" とする。

6. command parameters が wait を含み、 かつ command parameters[wait] が "none" でない場合、 wait condition を command parameters[wait] に設定する。

7. document を navigable の active document とする。

8. url を document の URL とする。

9. request を、URL が url である新しい request とする。

10. navigable、 request、wait condition、history handling "reload"、および ignore cache ignore cache で await a navigation した結果を返す。