WebDriver

この仕様のさまざまな部分は、段階的なアルゴリズムとして書かれている。 これらのアルゴリズムの詳細には規範的な意味はない。 実装は、この仕様と等価な出力を生成する任意の実装戦略を 自由に採用してよい。 特に、この文書のアルゴリズムは性能ではなく 読みやすさに最適化されている。

値を返すアルゴリズムが失敗可能である場合、 それらは success または error のいずれかを 返すものとして書かれる。 success 値は、返される値を包含する関連付けられた data フィールドを持つ。 一方、error 値は、関連付けられたエラーコードを持つ。

失敗可能なアルゴリズムを呼び出すとき、 構文 “Let result be the result of trying to call algorithm” は、 次と等価である。

1. temp を、algorithm を呼び出した結果とする。

2. temp が error である場合は temp を返す。 そうでなければ、result を temp の data フィールドとする。

object から name を持つ プロパティを 取得することの結果は、 object 上で Object.[[GetOwnProperty]](name) を 呼び出した結果と同じであると定義される。

object から引数 name および default を用いて デフォルト付きでプロパティを取得することの結果は、 object 上で Object.[[GetOwnProperty]](name) を呼び出した結果が undefined 以外の値であればその結果と同じであり、 そうでなければ default であると定義される。

object 上で引数 name および value を用いて プロパティを設定することは、 object 上で Object.[[Put]](name, value) を呼び出すことと 同じであると定義される。

JSON Object 型の object による JSON 直列化の結果は、 stringify(object) を呼び出した結果として定義される。

text による JSON 逆直列化の結果は、 parse(text) を呼び出した結果として 定義される。

WebDriver プロトコルはコマンドに編成される。 この仕様で定義されたメソッドおよびテンプレートを持つ各 HTTP リクエストは、 単一のコマンドを表す。 したがって各コマンドは単一のHTTP レスポンスを生成する。

コマンドに応答して、 リモートエンドは、 リモートエンド手順として知られる 一連の動作を実行する。 これらは、リモートエンドが特定の コマンドを受信したときに行う動作の列を提供する。

リモートエンドは、 クライアントからリクエストを読み取りレスポンスを書き込む HTTP サーバーであり、 通常は TCP ソケット越しに行われる。 この仕様の目的上、特定のローカルエンドとリモートエンドの間のデータ伝送は、 接続によってモデル化される。 リモートエンドは、その接続に対して バイトを書き込むこと、および バイトを読み取ることができる。 ただし、この接続がどのように機能し、 どのように確立されるかについての正確な詳細は範囲外である。

接続が確立された後、 リモートエンドは 次の手順を実行しなければならない：

1. While 接続が閉じられていない間：

   1. データから完全なHTTP リクエストを構築できるまで、 接続から バイトを読み取る。 request を、[RFC7230] の要件に従って、受信したデータから構築された リクエストとする。 完全なHTTP リクエストを 構築できない場合、 リモートエンドは、 接続を閉じるか、 ステータスコード 500 の HTTP レスポンスを返すか、または error を エラー コード unknown error で返さなければならない。

   2. request match を、request の メソッドおよび URL を引数として リクエストを照合するアルゴリズムの結果とする。

   3. request match が error 型である場合、 request match のエラーコードで エラーを送信し、 continue する。

      そうでなければ、command および URL variables を request match のデータとする。

   4. session を null とする。

   5. URL variables が "session id" を 含む場合：

      注記

      この条件は、New Session および Status コマンドと、特定のセッション上で 動作しない任意の拡張コマンドを除外することを 意図している。

      1. session id を URL variables["session id"] とする。

      2. アクティブセッションのリスト内の 各 active session について：

         1. active session のセッション IDが session id と等しい場合、session を active session とし、break する。

      3. session が null である場合、 エラーコード invalid session id で エラーを送信し、 その後 continue する。

   6. リモートエンドの リクエスト キューに、次の手順を実行するタスクを キューに入れる：

      1. セッションが、アクティブ セッションのリストにもはや含まれていない場合、エラーを送信し、その エラーコードを invalid session id として、return する。

      2. parameters を null とする。

      3. request のメソッドが POST である場合：

         1. parse result を、request の 本文を引数として JSON として解析することの 結果とする。この処理が例外を投げた場合、 エラーコード invalid argument を持つ error を返し、 この全体アルゴリズムのステップ 1 に戻る。

         2. parse result が Object でない場合、 エラーコード invalid argument で エラーを送信し、 この全体アルゴリズムのステップ 1 に戻る。

            そうでなければ、parameters を parse result とする。

      4. navigate result を、session を用いて ナビゲーションの完了を 待つことの結果とする。

      5. navigate result が error である場合、 navigate result のエラー コードに等しいエラーコードで エラーを送信し、 return する。

      6. response result を、command について session、URL variables、および parameters を用いて リモートエンド 手順を実行することにより得られる戻り値とする。

      7. response result が error である場合、 response result のエラーコードに等しい エラーコードで エラーを送信し、 return する。

      8. Assert: response result は success である。

      9. response data を response result の data とする。

      10. ステータス 200 および response data で レスポンスを送信する。

error code および任意の error data 辞書を用いて エラーを 送信することが要求された場合、 リモートエンドは次の手順を実行しなければならない：

1. status および name を、 error code に対する エラーレスポンスデータとする。

2. message を、エラーの理由についての人間可読な説明を含む 実装定義の文字列とする。

3. stacktrace を、エラーが発生した時点でのアクティブなスタックフレームの スタックトレース報告を含む実装定義の文字列とする。

   body を、次のプロパティで初期化された新しい JSON Object とする：

   "error"

   name

   "message"

   message

   "stacktrace"

   stacktrace

4. error data 辞書が何らかのエントリを含む場合、 body 上の "data" フィールドを、 その辞書で埋められた新しい JSON Object に設定する。

5. status および body を引数として レスポンスを送信する。

引数 status および data を用いて レスポンスを送信する ことが要求された場合、 リモートエンドは次の手順を実行しなければならない：

1. response を新しいレスポンスとする。

2. response の HTTP ステータスを status に設定し、 ステータスメッセージを ステータスコード レジストリにおける status の説明に対応する文字列に設定する。

3. 次の値を用いて、response のヘッダーを 名前および 値で 設定する：

   Content-Type

   "application/json; charset=utf-8"

   Cache-Control

   "no-cache"

4. response の本文を、 キー "value" が data に設定された JSON Object の JSON 直列化を UTF-8 エンコードしたものとする。

5. response bytes を、[RFC7230] の規則に従って response を直列化した結果のバイト列とする。

6. response bytes を 接続へ 書き込む。

リクエストルーティングとは、 HTTP リクエストから、 そのリクエストが表すコマンドを実装するために必要な 一連の手順へ至る過程である。

リモートエンドは、関連付けられた URL 接頭辞を持つ。 これは、そのリモートエンド上の すべての WebDriver 定義 URL に対する接頭辞として用いられる。 これは undefined または path-absolute URL の いずれかでなければならない。

method および URL が与えられたときに リクエストを 照合するためには、 次の手順を実行しなければならない：

1. endpoints を、 エンドポイント表内の各行を含むリストとする。

2. URL 接頭辞とエントリの URI テンプレートを連結したものが、 URL のパスと等しい有効な展開を持たない endpoints 内の各エントリを削除する。

3. endpoints にエントリが存在しない場合、 エラーコード unknown command を持つ error を返す。

4. method 列が method と等しくない endpoints 内の各エントリを削除する。

5. endpoints にエントリが存在しない場合、 エラーコード unknown method を持つ error を返す。

6. この時点で endpoints 内にはちょうど 1 つのエントリが存在する。 entry をこのエントリとする。

7. URI template を、URL 接頭辞と entry の URI template の連結とする。

8. command を entry の コマンドとする。

9. URL variables を、URI template 内に定義された各変数について 1 つの エントリを持つ マップとする。 そのエントリ名はテンプレート変数名に等しく、 エントリ値は、URI template を展開して URL のパスに一致させるために必要な 変数値である。

10. command および URL variables をデータとして持つ success を返す。

次のエンドポイント表は、 各エンドポイント ノードコマンドに対する メソッド および URI テンプレートを列挙する。 拡張コマンドは、この表に暗黙的に 追加される。

エラーは、 WebDriver プロトコルにおいて、 4xx または 5xx 範囲のHTTP ステータスを持つ HTTP レスポンスと、 エラーの詳細を含む JSON 本文によって表される。 本文は JSON Object であり、 "value" という名前のフィールドを持つ。 その値は、3 つ、場合によっては 4 つのフィールドを持つオブジェクトである：

• "error"。エラーコードを 示す文字列を含む。
• "message"。発生したエラーの種類についての人間可読な説明を持つ、 実装定義の文字列を含む。
• "stacktrace"。エラーが発生した時点でのアクティブなスタックフレームの スタックトレース報告を持つ実装定義の文字列を含む。
• 任意で "data"。これは、エラーの診断に役立つ追加の エラーデータを持つ JSON Object である。

次の表は、各エラーコード、 それに関連付けられたHTTP ステータス、 JSON error コード、 およびエラーの非規範的な説明を列挙する。 特定のエラーコードに対する エラー レスポンスデータは、 そのエラーコードに 対応する行の HTTP Status 列および JSON Error Code 列の値である。

エラーデータ 辞書は、error オブジェクトに任意で含めることができる、 文字列キーから JSON 直列化可能な値への対応付けである。

この節で定義される用語を用いて、他者は標準プロトコルと シームレスに統合される追加コマンドを定義してよい。 これにより、ベンダーは自らのユーザーエージェントに固有の機能を 公開でき、また他の Web 標準は新しいプラットフォーム機能を自動化するための コマンドを定義できる。

この方法で定義されるコマンドは 拡張 コマンドと呼ばれ、 他のコマンドと異なる振る舞いはしない。 それぞれが専用の HTTP エンドポイントと一組の リモートエンド手順を持つ。

各拡張コマンドは、 関連付けられた 拡張コマンド URI テンプレートを持つ。 これは URI Template 文字列であり、 そのコマンドが行うことにある程度似ているべきである。 この値は、HTTP メソッドおよび拡張コマンドとともに、 エンドポイント表に追加され、 したがって他の組み込みコマンドと同じ リクエストルーティングの 規則に従う。

他の実装との潜在的なリソース競合を避けるため、 ベンダー固有の拡張 コマンド URI テンプレートは、ベンダーおよび UA を一意に識別する 1 つ以上のパスセグメントで始まらなければならない。 ベンダーは、[CSS21] で概説されているように、特に ベンダーキーワードに関する 4.1.2.2 節において、 追加文字なしのベンダー接頭辞をこのパス要素の名前として用い、 ベンダーが選択した UA 識別子を含めることが推奨される。

他の仕様は、追加 WebDriver ケイパビリティを定義してよい。 定義される各ケイパビリティは、 ":"（コロン）文字を含まない文字列である ケイパビリティ名と、 JSON 型を持つ単一の引数 value を取り、 逆直列化されたケイパビリティ値を包む success または error の いずれかを返す一連の手順である 追加ケイパビリティ逆直列化 アルゴリズムを持たなければならない。

追加 WebDriver ケイパビリティは、 一致ケイパビリティ直列化アルゴリズムを 定義してもよい。 これは、ケイパビリティが現在の実装によって一致するかどうかを判定し、 ユーザーに返す任意の算出値を提供するために用いられる一連の手順である。 この一連の手順は、対応する 追加 ケイパビリティ逆直列化アルゴリズムの出力である 単一の引数 value を取り、 ケイパビリティが一致しないことを示す null、または ケイパビリティが一致する場合は非 null の JSON 直列化可能な値を返す。

他の仕様は、WebDriver 新規セッションアルゴリズムを定義してもよい。 これは新しいセッションが作成された直後、かつ 新規セッションレスポンスが リモートエンドに送信される前に呼び出される。 これらのアルゴリズムは、確立される WebDriver セッションを表す session と、 リモートエンドに返される ケイパビリティオブジェクトである capabilities を用いて呼び出される。 そのようなアルゴリズムが、同じ仕様によって定義された 追加 WebDriver ケイパビリティである名前を持つ ケイパビリティオブジェクト内の任意のエントリを変更することは許可される。

リモートエンドは、 構成を提供するため、またはその他のベンダー固有の必要を満たすために用いられる 追加のケイパビリティである 拡張ケイパビリティを 導入してもよい。 拡張ケイパビリティのキーは、 実装固有の名前空間を示す ":"（コロン）文字を 含まなければならない。 値は任意の JSON 型でよい。

拡張コマンドと同様に、 拡張ケイパビリティ名前空間を示すために用いられるキーは、 [CSS21] に列挙されている ベンダーキーワードに 基づき、文字列内の最初の ":" 文字に先行することが推奨される。

プロキシ 構成ケイパビリティは、 主たるケイパビリティ内にネストされた JSON Objectである。 実装は追加のプロキシ構成オプションを定義してよいが、 以下に列挙されるものの意味論を変更してはならない。

scheme に対する ホストおよび 任意のポートは、 妥当なホスト、任意でそれに続くコロンおよび妥当な ポートであると定義される。 ホストは 資格情報を含むことができる。 ポートが省略され、かつ scheme が既定ポートを持つ場合、 これは暗黙のポートである。そうでなければ、ポートは未定義のままとなる。

"direct" のproxyTypeは、 ブラウザーがプロキシを一切使用すべきでないことを示す。

"system" のproxyTypeは、 ブラウザーが基盤となるオペレーティングシステムに構成された 各種プロキシを使用すべきであることを示す。

"autodetect" のproxyTypeは、 使用するプロキシが実装固有の方法で検出されるべきであることを示す。

引数 parameter を プロキシとして逆直列化するための リモートエンド手順は次の通りである：

1. parameter が JSON Object でない場合、 エラーコード invalid argument を持つ error を返す。

2. proxy を、新しい空の プロキシ構成オブジェクトとする。

3. parameter 内の列挙可能な各自前プロパティについて、 次の副手順を実行する：

   1. key をプロパティの名前とする。

   2. value を、parameter から name という名前の プロパティを 取得することの結果とする。

   3. プロキシ構成表内に key に一致する key が存在しない場合、 エラーコード invalid argument を持つerrorを返す。

   4. value がその key に対する valid values のいずれでもない場合、 エラー コード invalid argument を持つ errorを返す。

   5. proxy 上で プロパティを設定し、 key を value にする。

4. proxy が "proxyType" に対する 自前プロパティを持たない場合、 エラー コード invalid argument を持つ errorを返す。

5. proxy から "proxyType" という名前の プロパティを取得することの結果が "pac" と等しく、かつ proxy が "proxyAutoconfigUrl" に対する 自前プロパティを持たない場合、 エラーコード invalid argument を持つ errorを返す。

6. proxy が "socksProxy" に対する 自前プロパティを持ち、かつ "socksVersion" に対する自前プロパティを 持たない場合、 エラー コード invalid argument を持つ errorを返す。

7. proxy をデータとして持つ success を返す。

プロキシ 構成オブジェクトは、 その自前プロパティのうち プロキシ構成内のキーに一致する各ものが、 そのキーに対する妥当性基準を満たす JSON Objectである。

parameters およびセッション 構成フラグ flags が与えられたときに ケイパビリティを 処理するには、エンドポイントノードは 次の手順を実行しなければならない：

1. capabilities request を、parameters から "capabilities" という プロパティを 取得することの結果とする。

   1. capabilities request が JSON Objectでない場合、 エラー コード invalid argument を持つ errorを返す。

2. required capabilities を、capabilities request から "alwaysMatch" という プロパティを 取得することの結果とする。

   1. required capabilities が undefined である場合、 その値を空の JSON Objectに設定する。

   2. required capabilities を、 required capabilities および flag を引数として ケイパビリティを検証することを tryingした結果とする。

3. all first match capabilities を、capabilities request から "firstMatch" という プロパティを 取得することの結果とする。

   1. all first match capabilities が undefined である場合、 その値を、空の JSON Object 1 つをエントリとして持つ Listに設定する。

   2. all first match capabilities が、 1 つ以上のエントリを持つ Listでない場合、 エラーコード invalid argument を持つ errorを返す。

4. validated first match capabilities を空の Listとする。

5. all first match capabilities 内のインデックス付きプロパティに対応する 各 first match capabilities について：

   1. validated capabilities を、 first match capabilities および flags を引数として ケイパビリティを検証することを tryingした結果とする。

   2. validated capabilities を validated first match capabilities に付加する。

6. merged capabilities を空の Listとする。

7. validated first match capabilities 内のインデックス付きプロパティに対応する 各 first match capabilities について：

   1. merged を、 required capabilities および first match capabilities を引数として ケイパビリティを マージすることを tryingした結果とする。

   2. merged を merged capabilities に付加する。

8. merged capabilities 内のインデックス付きプロパティに対応する 各 capabilities について：

   1. matched capabilities を、 capabilities を引数として ケイパビリティを 照合することを tryingした結果とする。

   2. matched capabilities が null でない場合、 matched capabilities をデータとして持つ success を返す。

9. null をデータとして持つ success を返す。

引数 capabilities を用いて ケイパビリティを検証することが要求された場合：

1. capabilities が JSON Object でない場合、 エラーコード invalid argument を持つ errorを返す。

2. result を空の JSON Objectとする。

3. capabilities 内の列挙可能な各自前プロパティについて、 次の副手順を実行する：

   1. name をプロパティの名前とする。

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

   3. 最初に一致する条件の副手順を実行する：

      value is null

      deserialized を null に 設定する。

      name equals "acceptInsecureCerts"

      value が boolean でない場合、 エラーコード invalid argument を持つerrorを返す。そうでなければ、 deserialized を value に設定する。

      name equals "browserName"

      name equals "browserVersion"

      name equals "platformName"

      value が string でない場合、 エラーコード invalid argument を持つerrorを返す。そうでなければ、 deserialized を value に設定する。

      name equals "pageLoadStrategy"

      deserialized を、引数 value を用いて ページ 読み込み戦略として逆直列化することを tryingした 結果とする。

      name equals "proxy"

      deserialized を、引数 value を用いて プロキシとして 逆直列化することを tryingした結果とする。

      name equals "strictFileInteractability"

      value が boolean でない場合、 エラーコード invalid argument を持つerrorを返す。そうでなければ、 deserialized を value に設定する

      name equals "timeouts"

      deserialized を、value を用いて タイムアウト構成として 逆直列化することを tryingした結果とする。

      name equals "unhandledPromptBehavior"

      deserialized を、引数 value を用いて 未処理プロンプトの 振る舞いとして逆直列化することを tryingした結果とする。

      name is the name of an 追加 WebDriver ケイパビリティ

      deserialized を、 name に対応する拡張ケイパビリティについて、 引数 value を用いて 追加 ケイパビリティ逆直列化 アルゴリズムを実行することを tryingした結果とする。

      name is the key of an 拡張ケイパビリティ

      name が実装に知られている場合、 deserialized を、value を実装固有の方法で 逆直列化することをtryingした 結果とする。 そうでなければ、deserialized を value に設定する。

      The リモートエンド is an エンドポイントノード

      エラーコード invalid argument を持つ errorを返す。

   4. deserialized が null でない場合、 result 上で、名前 name および値 deserialized を持つ プロパティを設定する。

4. result をデータとして持つ success を返す。

JSON Object 引数 primary および secondary を用いて ケイパビリティを マージする場合、 エンドポイントノードは次の手順を実行しなければならない：

1. result を新しい JSON Objectとする。

2. primary 内の列挙可能な各自前プロパティについて、 次の副手順を実行する：

   1. name をプロパティの名前とする。

   2. value を、primary から name という名前の プロパティを 取得することの結果とする。

   3. result 上で、名前 name および値 value を持つ プロパティを設定する。

3. secondary が undefined である場合、 result を返す。

4. secondary 内の列挙可能な各自前プロパティについて、 次の副手順を実行する：

   1. name をプロパティの名前とする。

   2. value を、secondary から name という名前の プロパティを 取得することの結果とする。

   3. primary value を、 primary から name という プロパティを取得することの結果とする。

   4. primary value が undefined でない場合、 エラー コード invalid argument を持つ errorを返す。

   5. result 上で、名前 name および値 value を持つ プロパティを設定する。

5. result を返す。

JSON Object capabilities および セッション 構成フラグ flags が与えられたときに ケイパビリティを照合する場合、 エンドポイントノードは 次の手順を実行しなければならない：

1. matched capabilities を、次のエントリを持つ JSON Objectとする：

   "browserName"

   ユーザーエージェント名のASCII 小文字化を stringとして表したもの。

   "browserVersion"

   ユーザーエージェントバージョンをstringとして表したもの。

   "platformName"

   現在のプラットフォーム名のASCII 小文字化を stringとして表したもの。

   "acceptInsecureCerts"

   初期値が false に設定されたBooleanであり、 セッションがナビゲーションにおいて、 信頼されていない TLS 証明書または自己署名 TLS 証明書を 暗黙的に信頼しないことを示す。

   "strictFileInteractability"

   初期値が false に設定されたBooleanであり、 相互作用可能性チェックが <input type=file> に適用されることを示す。

   "setWindowRect"

   リモートエンドが、 すべてのサイズ変更および 位置指定コマンドをサポートするかどうかを示す Boolean。

   "userAgent"

   既定の User-Agent 値を含む String。

2. flags が "http" を含む場合、 次のエントリを matched capabilities に追加する：

   "strictFileInteractability"

   初期値が false に設定されたBooleanであり、 相互作用可能性チェックが <input type=file> に適用されることを示す。

3. 任意で、拡張ケイパビリティを matched capabilities にエントリとして追加する。 これらの値は省略されてもよく、すべての 拡張ケイパビリティを追加する要件はない。

   注記

4. capabilities の自前プロパティに対応する 各 name および value について：

   1. match value を value と等しくする。

   2. 最初に一致する name の副手順を実行する：

      "browserName"

      value が matched capabilities 内の "browserName" エントリと等しい文字列でない場合、 nullをデータとして持つ successを返す。

      注記

      リモートエンドは、 browserName を正しく決定するために ブラウザープロセスを開始する必要がある可能性がある。 これを行う前に、軽量なチェックを行うことが望ましい。

      "browserVersion"

      value を、 実装定義の比較アルゴリズムを用いて matched capabilities 内の "browserVersion" エントリと 比較する。 この比較は、"<", "<=", ">", および ">=" 演算子を用いてバージョンに制約を置く value を受け入れるためのものである。

      2 つの値が一致しない場合、 nullをデータとして持つ successを返す。

      注記

      バージョン比較は実装詳細として残されている。 各ユーザーエージェントは、ユーザーエージェントバージョンを符号化する 方法が衝突する可能性が高く、これらの方式を標準化することは この標準の範囲外だからである。

      注記

      リモートエンドは、 browserVersion を正しく決定するために ブラウザープロセスを開始する必要がある可能性がある。 これを行う前に、軽量なチェックを行うことが望ましい。

      "platformName"

      value が matched capabilities 内の "platformName" エントリと等しい文字列でない場合、 nullをデータとして持つ successを返す。

      注記

      次のプラットフォーム名は、よく理解された意味論とともに 一般的に使用されているものであり、 プラットフォーム名について ケイパビリティを 照合する際には、よく知られたオペレーティング システムの妥当な同義語として尊重することで、 最大の相互運用性を達成できる：

      キー	システム
      "linux"	Linux カーネルに基づく任意のサーバーまたはデスクトップシステム。
      "mac"	Apple の macOS の任意のバージョン。
      "windows"	デスクトップ版およびモバイル版を含む、Microsoft Windows の任意のバージョン。

      この一覧は網羅的ではない。

      New Session から ケイパビリティを返すとき、 より具体的な platformName を返すことは妥当であり、 これによりユーザーは、WebDriver 実装が実行されている オペレーティングシステムを正しく識別できる。

      "acceptInsecureCerts"

      安全でない TLS を受け入れるフラグが 設定されており、かつ value と等しくない場合、 nullをデータとして持つ successを返す。

      注記

      エンドポイントノードが 安全でない TLS 証明書をサポートしておらず、 これが最終的に一致が行われない理由である場合、 この情報をローカルエンドに 提供することは有用である。

      "proxy"

      プロキシ構成を持つ フラグが設定されている場合、または value 内に定義された プロキシ構成がエンドポイントノードの 実装固有の妥当性チェックを通過しないものである場合、 nullをデータとして持つ successを返す。

      注記

      ローカルエンドは、 このケイパビリティが尊重され、構成されたプロキシが用いられることを 期待する場合にのみ、このケイパビリティを送信するであろう。 意図としては、これが不可能である場合、新しいセッションは 確立されない。

      "unhandledPromptBehavior"

      value を用いて ユーザープロンプトハンドラーが 一致するかをチェックすることが false である場合、 nullをデータとして持つ successを返す。

      それ以外

      • name が、一致 ケイパビリティ直列化アルゴリズムを定義する 追加 WebDriver ケイパビリティの名前である場合、 match value を、 引数 value および flags を用いて ケイパビリティ name について 一致 ケイパビリティ直列化アルゴリズムを実行した結果とする。

      • そうでなければ、name が 拡張ケイパビリティのキーである場合、 match value を、name と value について 照合する実装固有の手順を tryingした結果とする。一致が成功しない場合、 nullをデータとして持つ successを返す。

   3. match value が null でない場合、 matched capabilities 上で、名前 name および 値 match value を持つ プロパティを設定する。

5. matched capabilities をデータとして持つ success を返す。

セッションごとの状態に加えて、リモートエンドが エンドポイントノードである場合、すべてのセッションにわたってグローバルな追加の状態も持つ。

エンドポイントノードは、関連付けられた 安全でない TLS を受け入れるフラグを持ち、これは信頼されていない TLS 証明書または自己署名 TLS 証明書が信頼済みとして扱われるかどうかを示す。このフラグの既定値は、 エンドポイントが安全でない TLS 接続の受け入れをサポートしない場合は false、そうでなければ未設定である。

エンドポイントノードは、関連付けられた プロキシ 設定を持つフラグを持ち、これはプロキシがすでに 設定されているかどうかを示す。このフラグの既定値は、エンドポイントが プロキシ設定をサポートしない場合は true、そうでなければ false である。

セッションを 作成するには、JSON Object capabilites と、セッション設定 フラグ flags が与えられたものとして：

1. session id を、UUID を生成した結果とする。

2. session を、session ID が session id で、HTTP フラグ が flags に "http" が含まれることである新しいセッションとする。

3. proxy を、capabilities から "proxy" プロパティを取得した結果とし、最初に一致する文の サブステップを実行する：

   proxy が プロキシ設定 オブジェクトである場合

   抽出された proxy 設定を使用してユーザーエージェントのプロキシを設定するため、 実装定義の手順を行う。定義されたプロキシを設定できない場合は、 エラーを エラーコード session not created 付きで返す。そうでなければ、 プロキシ設定を持つフラグを true に設定する。

   そうでなければ

   capabilities のプロパティを、名前 "proxy"、値が新しい JSON Object であるものとして設定する。

4. capabilites に "acceptInsecureCerts" という名前のプロパティがある場合、エンドポイント ノードの 安全でない TLS を受け入れるフラグを、 capabilities から "acceptInsecureCerts" という名前のプロパティを取得した結果に設定する。

5. user prompt handler capability を、capabilities から "unhandledPromptBehavior" プロパティを取得した結果とする。

6. user prompt handler capability が undefined でない場合、user prompt handler capability を用いてユーザープロンプト ハンドラーを更新する。

7. serialized user prompt handler を、ユーザープロンプトハンドラーをシリアル化したものとする。

8. capabilities 上に、名前 "unhandledPromptBehavior"、値 serialized user prompt handler のプロパティを設定する。

9. flags が "http" を含む場合：

   1. strategy を、capabilities から プロパティ "pageLoadStrategy" を取得した結果とする。

      strategy が 文字列である場合、セッションの ページ読み込み 戦略を strategy に設定する。そうでなければ、 ページ読み込み戦略を normal に設定し、capabilities のプロパティを、名前 "pageLoadStrategy"、値 "normal" として設定する。

   2. strictFileInteractability を、 capabilities からプロパティ "strictFileInteractability" を取得した結果とする。strictFileInteractability が真偽値である場合、セッションの 厳密なファイル 操作可能性を strictFileInteractability に設定する。

   3. timeouts を、capabilities から プロパティ "timeouts" を取得した結果とする。 timeouts が undefined でない場合、 session の セッションタイムアウト を timeouts に設定する。

   4. capabilities 上に、名前 "timeouts"、値が session の セッションタイムアウトを用いて タイムアウト設定をシリアル化したものであるプロパティを設定する。

10. capabilities 内の任意の拡張 capabilityを 実装定義の方法で処理する。

11. 外部仕様で定義された任意のWebDriver 新規セッションアルゴリズムを、 引数 session、 capabilities、および flags で実行する。

12. session を アクティブセッションに追加する。

13. flags に "http" が含まれる場合、 session を アクティブ HTTP セッションに追加する。

14. webdriver-active フラグを true に設定する。

セッションを 閉じるには、session が与えられたものとして、 リモートエンドは次の手順を行わなければならない：

1. session の HTTP フラグが設定されている場合、 session を アクティブ HTTP セッションから削除する。

2. session を アクティブセッションから削除する。

3. リモートエンドの 種類に基づいて、次のサブステップを実行する：

   リモートエンドがエンドポイント ノードである場合

   1. アクティブセッションのリストが 空である場合：

      1. webdriver-active フラグ を false に設定する

      2. ユーザー プロンプトハンドラーを null に設定する。

      3. 安全でない TLS を受け入れるフラグを未設定にする。

      4. プロキシ 設定を持つフラグを、その 既定値にリセットする。

      5. 任意で、すべてのトップレベル 閲覧コンテキストを、 アンロードを促すことなく閉じる。

   リモートエンドが中間ノードである場合

   1. 関連付けられたセッションを閉じる。これにより エラーが発生した場合は、この アルゴリズムの残りを完了してから、そのエラーを返す。

4. 実装固有のクリーンアップ手順を実行する。

5. 上記のいずれかの手順でエラーが発生した場合は、 そのエラーを返し、そうでなければ データ null を伴う成功を返す。

セッションを閉じると、関連付けられたブラウザープロセスが kill される可能性がある。 実装固有のクリーンアップ手順は、 接続が早期に閉じられないように、レスポンスがクライアントに返送された 後に実行されるものと仮定される。

New Session コマンドは、 エンドポイントノードで新しい WebDriver セッションを作成する。 作成に失敗した場合、session not created エラーが返される。

リモートエンドが中継 ノードである場合、 ケイパビリティ処理 アルゴリズムの結果を用いて、 新規セッションリクエストを適切な エンドポイントノードへルーティングしてよい。 中継ノードは、この処理を補助するために 拡張ケイパビリティを自由に定義できる。 ただし、これらの特定のケイパビリティは エンドポイントノードへ転送してはならない。

中継ノードが、ユーザーエージェント機能とは 無関係な追加情報を必要とする場合、 この情報は要求されたケイパビリティの一部としてではなく、 トップレベルパラメーターとして渡すことが推奨される。 中継ノードは、カスタムの トップレベルパラメーター（すなわち非ケイパビリティ）を後続の リモートエンドノードへ 転送しなければならない。

session、URL variables および parameters が与えられたときの リモートエンド手順は次の通りである：

1. 実装がエンドポイントノードであり、 アクティブ HTTP セッションの リストが空でない場合、またはそれ以外で 実装が追加のセッションを開始できない場合、 エラーコード session not createdを持つerrorを返す。

2. リモートエンドが中間 ノードである場合、 実装定義の手順を行い、その結果として、 エラーを エラーコード session not created 付きで返すか、 またはこのアルゴリズムの残りに従ってリモートエンドが返すものと同型のデータを伴う 成功を返すかのいずれかとする。 エラーが返されない場合、中間 ノードは、後続のコマンドでこの関連付けられたセッションへ コマンドを転送できるように、上流ノードで作成されたセッションへの参照を、関連付けられた セッションとして保持しなければならない。

   注記

   これがどのように行われるかは完全に実装次第であるが、 通常は sessionId、ならびに 上流 リモートエンドの URLおよび URL 接頭辞を追跡する必要がある。

3. flags を、"http" を含む集合とする。

4. capabilities を、 parameters および flags を用いて ケイパビリティを処理することを tryingした結果とする。

5. capabilities がnullである場合、 エラーコード session not createdを持つ errorを返す。

6. session を、capabilities および flags を用いて セッションを 作成することの結果とする。

7. body を、次で初期化された JSON Objectとする：

   "sessionId"

   sessionのセッション ID。

   "capabilities"

   capabilities

8. sessionの現在のトップレベル 閲覧 コンテキストを、エンドポイントノードの トップレベル 閲覧コンテキストのいずれかに設定する。 システム フォーカスを持つトップレベル閲覧 コンテキストを優先し、そうでなければ、 可視性 状態が visibleである任意の トップレベル閲覧 コンテキストを優先する。

   注記

   WebDriver 実装は通常、 完全に新しいブラウザーインスタンスを開始するが、 この仕様にはその要件はない（また、WebDriver が Web ブラウザーのみを自動化するためだけに使われるという要件もない）。 実装は、例えば現在フォーカスを持つウィンドウを選択することにより、 既存のブラウザーインスタンスを使用することを選択してもよい。

9. リクエストキューを新しい キューに設定する。

10. body をデータとして持つ successを返す。

session、URL variables および parameters が与えられたときの リモートエンド手順は次の通りである：

1. session がアクティブ HTTP セッションである場合、 session を用いて セッションを閉じることを tryする。

2. nullをデータとして持つ successを返す。

実装は任意で、 追加のメタ情報を本文の一部として含めてもよいが、 トップレベルプロパティ ready および message は予約されており、上書きしてはならない。

session、URL variables および parameters が与えられたときの リモートエンド手順は次の通りである：

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

   "ready"

   リモートエンドの 準備完了状態。

   "message"

   リモートエンドの 準備完了状態を説明する、 実装定義の文字列。

2. body をデータとして持つ successを返す。

session、URL variables および parameters が与えられたときの リモートエンド手順は次の通りである：

1. timeouts を、セッションの タイムアウト 設定を用いてタイムアウト 設定をシリアル化したものとする

2. データ timeouts を伴う成功を返す。

session、URL variables および parameters が与えられたときの リモートエンド手順は次の通りである：

1. timeouts を、 parameters を用いて タイムアウト構成として 逆直列化することを tryingした結果とする。

2. session のタイムアウト構成を timeouts に設定する。

3. nullをデータとして持つ success を返す。

リモートエンドの安全でない TLS を受け入れるフラグが true である場合、通常であればユーザーエージェントに中止させ、 セキュリティ警告を表示させる証明書エラーは、要求された アドレスへのナビゲーションを妨げてはならない。

session、URL variables および parameters が与えられたときの リモートエンド手順は次の通りである：

1. URL を、parameters から "url" という名前の プロパティを取得することの結果とする。

2. session の現在のトップレベル 閲覧 コンテキストがもはや開かれていない場合、 エラーコード no such windowを持つ errorを返す。

3. URL が絶対 URLでなく、 またはフラグメント付き絶対 URLでなく、または ローカルスキームでもない場合、 エラー コード invalid argumentを持つ errorを返す。

4. session を用いて 任意のユーザープロンプトを処理することを Tryする。

5. timeout を、セッションの セッション タイムアウトの ページ読み込みタイムアウトとする。

6. current URL を、session の現在の トップレベル閲覧コンテキストのアクティブ文書の URLとする。

7. current URL と URL が同じ 絶対 URLを持たず、かつ timeout が null でない場合：

   1. timer を新しいタイマーに設定する。

   2. timer および timeout を用いて タイマーを開始する。

8. これらの手順を実行するが、timer の タイムアウト発火フラグが設定されたときに 中止する：

   1. session の現在の トップレベル 閲覧コンテキストを URL へ ナビゲートする。

   2. URL が file を除いて special であり、 current URL と URL が同じ 絶対 URLを持たない場合：

      1. session および timer を用いて ナビゲーションの 完了を待つことを Tryする。

      2. ナビゲーション後チェックを 実行することをTryする。

   3. session および現在のトップレベル閲覧 コンテキストを用いて 現在の閲覧 コンテキストを設定する。

   4. session の現在のトップレベル閲覧 コンテキストが、 time が 1 秒以下の refresh state pragma directive を含む間、次の手順を実行する：

      1. current URL を、session の 現在のトップレベル 閲覧コンテキストのアクティブ 文書のURLに設定する。

      2. リフレッシュタイムアウトが経過し、 session の現在のトップレベル 閲覧コンテキストの新しいナビゲートが開始されるまで待つ。

      3. URL を、session の 現在のトップレベル 閲覧コンテキストのアクティブ 文書の進行中のナビゲーションの宛先 URL に設定する。

      4. URL が file を除いて special であり、 current URL と URL が同じ 絶対 URLを持たない場合：

         1. session および timer を用いて ナビゲーションの 完了を待つことを Tryする。

         2. ナビゲーション後 チェックを実行することを Tryする。

9. 中止された場合、 エラー コード timeoutを持つ errorを返す。

10. nullをデータとして持つ successを返す。

session、URL variables および parameters が与えられたときの リモートエンド手順は次の通りである：

1. session の現在の トップレベル閲覧 コンテキストがもはや開かれていない場合、 エラーコード no such windowを持つ errorを返す。

2. session を用いて 任意のユーザープロンプトを処理することを Tryする。

3. URL を、session の 現在の トップレベル閲覧コンテキストの アクティブ文書のURLの 直列化とする。

4. URL をデータとして持つ successを返す。

session、URL variables および parameters が与えられたときの リモートエンド手順は次の通りである：

1. session の現在の トップレベル閲覧 コンテキストがもはや開かれていない場合、 エラーコード no such windowを持つ errorを返す。

2. session を用いて 任意のユーザープロンプトを処理することを Tryする。

3. timeout を、session の セッション タイムアウトのページ読み込みタイムアウトとする。

4. timer を新しいタイマーとする。

5. timeout が null でない場合：

   1. timer および timeout を用いて タイマーを開始する。

6. session の現在の閲覧 コンテキストについて、 差分で履歴を辿る –1 を実行する。

7. 前の手順の完了により pageHide イベント発火が生じた場合、 pageShow イベントが発火するか、 timer のタイムアウト発火フラグが 設定されるまで、いずれか早い方まで待つ。

8. timer のタイムアウト発火フラグが設定されている場合：

   1. 任意のユーザープロンプトを処理する。

   2. エラー コード timeoutを持つ errorを返す。

9. nullをデータとして持つ successを返す。

session、URL variables および parameters が与えられたときの リモートエンド手順は次の通りである：

1. session の現在の トップレベル閲覧 コンテキストがもはや開かれていない場合、 エラーコード no such windowを持つ errorを返す。

2. session を用いて 任意のユーザープロンプトを処理することを Tryする。

3. timeout を、session の セッション タイムアウトのページ読み込みタイムアウトとする。

4. timer を新しいタイマーとする。

5. timeout が null でない場合：

   1. timer および timeout を用いてタイマーを開始する。

6. session の現在の閲覧 コンテキストについて、 差分で履歴を辿る 1 を実行する。

7. 前の手順の完了により pageHide イベントの発火が生じた場合、 pageShow イベントが発火するか、 timer のタイムアウト発火フラグが設定されるまで、 いずれか早い方まで待つ。

8. timer のタイムアウト発火フラグが設定されている場合：

   1. 任意のユーザープロンプトを処理する。

   2. エラー コード timeoutを持つ errorを返す。

9. nullをデータとして持つ successを返す。

session、URL variables および parameters が与えられたときの リモートエンド手順は次の通りである：

1. session の現在の トップレベル閲覧 コンテキストがもはや開かれていない場合、 エラーコード no such windowを持つ errorを返す。

2. session を用いて 任意のユーザープロンプトを処理することを Tryする。

3. session の現在の トップレベル閲覧 コンテキストのアクティブ文書について、 上書きされた再読み込みを開始する。

4. URL が file を除いて special である場合：

   1. session を用いて ナビゲーションの完了を 待つことを Tryする。

   2. ナビゲーション後チェックを 実行することを Tryする。

5. session および session の現在の トップレベル閲覧コンテキストを用いて 現在の閲覧コンテキストを設定する。

6. nullをデータとして持つ successを返す。

session、URL variables および parameters が与えられたときの リモートエンド手順は次の通りである：

1. session の現在の トップレベル閲覧 コンテキストがもはや開かれていない場合、 エラーコード no such windowを持つ errorを返す。

2. session を用いて 任意のユーザープロンプトを処理することを Tryする。

3. title を、 session の現在の トップレベル閲覧 コンテキストのアクティブ文書のtitleとする。

4. title をデータとして持つ successを返す。

session、URL variables および parameters が与えられたときの リモートエンド手順は次の通りである：

1. session の現在の トップレベル閲覧 コンテキストがもはや開かれていない場合、 エラーコード no such windowを持つ errorを返す。

2. session の現在のトップレベル閲覧 コンテキストに関連付けられた ウィンドウハンドルを データとして持つsuccessを返す。

session、URL variables および parameters が与えられたときの リモートエンド手順は次の通りである：

1. session の現在の トップレベル閲覧 コンテキストがもはや開かれていない場合、errorを エラーコード no such windowとともに返す。

2. session を用いて 任意のユーザープロンプトを処理することを 試行する。

3. session の現在の トップレベル 閲覧コンテキストを 閉じる。

4. 開いているトップレベル閲覧コンテキストが もうない場合、 セッションを閉じることを 試みる。

5. session、URL variables および parameters を用いて、 ウィンドウハンドル群を取得 コマンドの リモートエンド手順を 実行した結果を返す。

session、URL variables および parameters が与えられたときの リモートエンド手順は次の通りである：

1. handle を、parameters から "handle" プロパティを取得することの結果とする。

2. handle がundefinedである場合、 errorを エラーコード invalid argumentとともに返す。

3. 別のトップレベル閲覧コンテキストへの フォーカスを妨げるアクティブなユーザープロンプトが存在する場合、 errorを エラーコード unexpected alert openとともに返す。

4. handle が、あるトップレベル閲覧コンテキストに 関連付けられたウィンドウ ハンドルと等しい場合、 context をその閲覧コンテキストとし、 session および context を用いて 現在の トップレベル閲覧コンテキストを設定する。

   そうでなければ、errorを エラーコード no such windowとともに返す。

5. OS レベルのフォーカスを変更することなく、ユーザーが session の現在の閲覧コンテキストを 相互作用のために選択したことから生じる、任意の実装固有の状態を更新する。

6. nullをデータとして持つ successを返す。

ウィンドウハンドルが返される順序は任意である。

session、URL variables および parameters が与えられたときの リモートエンド手順は次の通りである：

1. handles をListとする。

2. リモートエンド内の各 トップレベル閲覧コンテキストについて、 関連付けられたウィンドウハンドルを handles に push する。

3. handles をデータとして持つsuccessを返す。

新しいトップレベル閲覧コンテキストを作成する。

session、URL variables および parameters が与えられたときの リモートエンド手順は次の通りである：

1. 実装が新しいトップレベル 閲覧コンテキストの作成をサポートしない場合、errorを エラーコード unsupported operationとともに返す。

2. session の現在の トップレベル閲覧 コンテキストがもはや開かれていない場合、errorを エラーコード no such windowとともに返す。

3. session を用いて 任意のユーザープロンプトを処理することを 試行する。

4. type hint を、parameters から "type" プロパティを取得することの結果とする。

5. URL を "about:blank" に設定し、 target を空 文字列に設定し、features を "noopener" に設定し、 ユーザーエージェントを新しい閲覧コンテキストを作成するよう構成して、 window open stepsを実行することにより、 新しいトップレベル閲覧コンテキストを作成する。 これは、作成された閲覧 コンテキストに対してフォーカス手順を呼び出さずに 行われなければならない。type hint が "tab" という値を持ち、 かつ実装が同じ OS ウィンドウ内に複数の閲覧コンテキストをサポートする場合、 新しい閲覧コンテキストは session の現在の閲覧 コンテキストと OS ウィンドウを共有するべきである。type hint が "window" であり、かつ実装が別々の OS ウィンドウに複数の 閲覧コンテキストをサポートする場合、作成された閲覧 コンテキストは新しい OS ウィンドウ内にあるべきである。その他すべての場合において、 閲覧コンテキストがユーザーにどのように提示されるかの詳細は 実装定義である。

6. handle を、 新しく作成された window に関連付けられたウィンドウハンドルとする。

7. 新しく作成された window が session の現在の閲覧 コンテキストと OS レベルのウィンドウを共有する場合、 type を "tab" とし、そうでなければ "window" とする。

8. result を、次で初期化された新しい JSON Objectとする：

   "handle"

   handle の値。

   "type"

   type の値。

9. result をデータとして持つsuccessを返す。

1. id を、parameters から "id" プロパティを取得することの結果とする。

2. id がnullでも、 Number オブジェクトでも、 ウェブ要素を表す Objectでもない場合、 errorを エラーコード invalid argumentとともに返す。

3. 最初に一致する条件の副手順を実行する：

   id はnullである

   1. session の現在のトップレベル 閲覧 コンテキストがもはや開かれていない場合、 errorを エラーコード no such windowとともに返す。

   2. session を用いて 任意のユーザープロンプトを処理することを 試行する。

   3. session および session の 現在の トップレベル閲覧コンテキストを用いて、 現在の 閲覧コンテキストを設定する。

   id は Number オブジェクトである

   1. id が 0 未満、または 2¹⁶ – 1 より大きい場合、 errorを エラーコード invalid argumentとともに返す。

   2. session の現在の閲覧コンテキストが もはや 開かれていない場合、errorを エラーコード no such windowとともに返す。

   3. session を用いて 任意のユーザープロンプトを処理することを 試行する。

   4. window を、session の 現在の閲覧コンテキストの アクティブ文書の 関連付けられた windowとする。

   5. id が window の サポートされる プロパティインデックスでない場合、 errorを エラーコード no such frameとともに返す。

   6. child window を、 window.[[GetOwnProperty]] (id) を呼び出すことにより取得された WindowProxyオブジェクトとする。

   7. session および child window の 閲覧コンテキストを用いて 現在の 閲覧コンテキストを設定する。

   id はウェブ要素を 表す

   1. session の現在の閲覧コンテキストが もはや 開かれていない場合、errorを エラーコード no such windowとともに返す。

   2. session を用いて 任意のユーザープロンプトを処理することを 試行する。

   3. element を、 session および id を用いて 既知の要素を取得することを 試みることの結果とする。

   4. element が frame または iframe 要素でない場合、 errorを エラーコード no such frameとともに返す。

   5. session および element のコンテンツ ナビゲート可能のアクティブ 閲覧コンテキストを用いて、 現在の 閲覧コンテキストを設定する。

4. OS レベルのフォーカスを変更することなく、ユーザーが session の現在の閲覧コンテキストを 相互作用のために選択したことから生じる、任意の実装固有の状態を更新する。

5. nullをデータとして持つ successを返す。

session、URL variables および parameters が与えられたときの リモートエンド手順は次の通りである：

1. session の現在の閲覧 コンテキストが、すでに トップレベル閲覧コンテキストである場合：

   1. session の現在の閲覧 コンテキスト がもはや開かれていない場合、errorを エラー コード no such windowとともに返す。

   2. nullをデータとして持つ successを返す。

2. session の現在の親 閲覧コンテキスト がもはや開かれていない場合、errorを エラー コード no such windowとともに返す。

3. session を用いて 任意のユーザープロンプトを処理することを 試行する。

4. セッションの現在の親閲覧コンテキストが nullでない場合、session と現在の親 閲覧コンテキストで現在の閲覧コンテキストを設定する。

5. OS レベルのフォーカスを変更することなく、ユーザーが session の現在の閲覧コンテキストを 相互作用のために選択したことから生じる、任意の実装固有の状態を更新する。

6. nullをデータとして持つ successを返す。

WebDriver は、session の現在のトップレベル 閲覧コンテキストを含むオペレーティングシステムウィンドウと相互作用するための コマンドを提供する。 異なるオペレーティングシステムのウィンドウマネージャーは異なる能力を提供するため、 この節のすべてのコマンドがすべてのリモートエンドで サポートされるわけではない。 これらのコマンドのサポートは、ウィンドウ 寸法指定/位置指定ケイパビリティにより決定される。 コマンドがサポートされない場合、 unsupported operation errorが返される。

トップレベル閲覧コンテキストは、 関連付けられたウィンドウ状態を持つ。 これは、その OS ウィジェットウィンドウがどの可視性状態にあるかを記述する。 これは次の状態のいずれかになり得る：

何らかの理由により、トップレベル閲覧コンテキストの OS ウィンドウがいずれかのウィンドウ状態に入れない場合、 またはこの概念が現在のシステムに適用できない場合、既定状態は normalでなければならない。

WindowProxy window に対する WindowRect オブジェクトは、次のプロパティで初期化された Objectである：

"x"

window のscreenX属性。

"y"

window のscreenY属性。

"width"

windows のouterWidth属性。

"height"

window のouterHeight属性。

関連付けられたトップレベル閲覧コンテキストを持つ オペレーティングシステムレベルのウィンドウが与えられたとき、 ウィンドウを 最大化するには、 オペレーティングシステムレベルのウィンドウを 最大化ウィンドウ状態へ遷移させるための 実装固有の手順を実行する。 ウィンドウマネージャーがウィンドウのサイズ変更をサポートするが、 ウィンドウ最大化の概念を持たない場合、 ウィンドウ寸法は現在のスクリーンについて ウィンドウマネージャーが許可する最大利用可能サイズまで増加されなければならない。 ウィンドウが遷移を完了したとき、または実装定義のタイムアウト内に返す。

関連付けられたトップレベル閲覧コンテキストを持つ オペレーティングシステムレベルのウィンドウが与えられたとき、 ウィンドウを アイコン化するには、 オペレーティングシステムレベルのウィンドウを 最小化ウィンドウ状態へ遷移させるための 実装固有の手順を実行する。 トップレベル閲覧コンテキストのアクティブ文書の 可視性状態が hidden状態に到達するか、 操作がタイムアウトするまで、この操作から返ってはならない。

関連付けられたトップレベル閲覧コンテキストを持つ オペレーティングシステムレベルのウィンドウが与えられたとき、 ウィンドウを 復元するには、 ウィンドウを可視スクリーンへ復元または再表示するための 実装固有の手順を実行する。 トップレベル閲覧コンテキストのアクティブ文書の 可視性状態が visible状態に到達するか、 操作がタイムアウトするまで、この操作から返ってはならない。

要素が ポインターアクションを用いて相互作用できるかどうかを判定するために、 WebDriver はヒットテストを実行して、 その相互作用が要求された要素に到達できるかどうかを見つける。

相互作用可能な要素は、 ポインター相互作用可能またはキーボード相互作用可能のいずれかである 要素である。

ポインター相互作用可能な要素は、 ビューポート内にあるその矩形の 中心点で見つかる 描画順序により定義される最初の 要素として定義される。 ただし、レンダリングされたスクロールバーのサイズは除外する。

キーボード相互作用可能な要素は、 フォーカス可能領域を持つ 任意の要素、 body 要素、 または文書要素である。

要素のビュー内中心 点は、 その要素の getClientRects() の 最初のDOMRectと 初期ビューポートとの交差である矩形の 原点位置である。 これは次のように計算できる：

1. rectangle を、 element上で getClientRects()を 呼び出すことにより返される DOMRectコレクションの 最初のオブジェクトとする。

2. left を max(0, min(x 座標, x 座標 + 幅 寸法)) とする。

3. right を min(innerWidth, max(x 座標, x 座標 + 幅 寸法)) とする。

4. top を max(0, min(y 座標, y 座標 + 高さ 寸法)) とする。

5. bottom を min(innerHeight, max(y 座標, y 座標 + 高さ 寸法)) とする。

6. x を floor((left + right) ÷ 2.0) とする。

7. y を floor((top + bottom) ÷ 2.0) とする。

8. (x, y) の組を返す。

要素 element は、次の手順が true を返す場合、 無効である：

1. element がoption要素である、または element がoptgroup要素である場合：

   1. element の各包含祖先 ancestor について：

      1. ancestor がoptgroup要素である、または ancestor がselect 要素であり、かつ ancestor が実際に無効である場合、true を返す。

   2. false を返す。

2. element が実際に無効であるかどうかを返す。

要素は、その ポインターイベントが無効でない という仮定の下で、自身のポインター相互作用可能な描画 ツリーのメンバーである場合、 ビュー内にある。

要素は、その 中心点における ポインター相互作用可能な描画ツリーが空である場合、 またはこのツリー内の最初の要素が自身の 包含子孫でない場合、 遮蔽されている。

要素 element の ポインター操作可能ペイントツリー は次のように生成される：

1. element が、session の 現在の閲覧 コンテキストの アクティブな文書と 同じツリー内にない 場合、空のシーケンスを返す。

2. rectangles を、 element 上で getClientRects() を呼び出すことによって返される DOMRect シーケンスとする。

3. rectangles の長さが 0 の場合、 空のシーケンスを返す。

4. center point を、element の ビュー内中心点 とする。

5. 座標 center point が与えられたものとして、 point からの要素 を返す。

シャドウルートは、 シャドウルートが プロトコルを介して、 リモートエンドとローカルエンドの間で転送されるときに、 それを識別するために用いられる抽象化である。

シャドウ ルート識別子は、文字列定数 "shadow-6066-11e4-a52e-4f735466cecf" である。

ECMAScript Object は、 シャドウルート識別子の 自前プロパティを持つ場合、 シャドウルートを表す。

session および reference が与えられたとき、 既知の シャドウルートを取得するには：

1. session、 session の現在の閲覧コンテキスト、 および reference を用いて ノード参照が既知であるでない場合、 errorを エラーコード no such shadow rootとともに返す。
2. node を、 session、session の現在の閲覧 コンテキスト、および reference を用いて ノードを取得することの結果とする。
3. node が null でなく、かつ node が ShadowRootを実装しない場合、 errorを エラーコード no such shadow rootとともに返す。
4. node が null、または node が切り離されている場合、 errorを エラーコード detached shadow rootとともに返す。
5. node をデータとして持つsuccessを返す。

session および shadow root が与えられたとき、 シャドウルート参照を取得または作成するには：

1. 表明：element はShadowRootを実装する。
2. session、session の現在の 閲覧コンテキスト、および element を用いて ノード 参照を取得または作成することを 試みることの結果を返す。

session および shadow root に対するシャドウルート参照オブジェクトは、次により与えられる：

1. identifier をシャドウルート識別子とする。

2. reference を、session および shadow root を用いて シャドウルート参照を 取得または作成することの結果とする。

3. 名前 identifier および値 reference のプロパティで 初期化された JSON Objectを返す。

シャドウ ルートを表す JSON Object object により シャドウルートを逆直列化することが要求された場合：

1. object がシャドウルート識別子の 自前プロパティを持たない場合、 errorを エラーコード invalid argumentとともに返す。

2. reference を、 object から シャドウルート識別子プロパティを 取得することの結果とする。

3. reference がStringでない場合、 errorを エラーコード invalid argumentとともに返す。

4. shadow を、 session および reference を用いて 既知の シャドウルートを取得することを 試みることの結果とする。

5. shadow をデータとして持つsuccessを返す。

シャドウルートは、 そのノード文書がアクティブ文書でない場合、 またはそのホストとして参照される要素ノードが 古い場合、 切り離されている。

要素を検索、 要素群を検索、 要素から要素を検索、 要素から要素群を検索、 シャドウルートから要素を検索、 およびシャドウルートから要素群を検索コマンドは、 個々の要素および要素のコレクションの検索を可能にする。 要素取得検索は、与えられたセレクターの式に一致する 文書のノードを前順走査することにより実行される。

session、start node、using および value が与えられ、 検索することが 要求された場合、リモート エンドは次の手順を実行しなければならない：

1. location strategy を using と等しくする。

2. selector を value と等しくする。

3. timeout を session の セッションタイムアウトの暗黙的待機タイムアウトとする。

4. timer を新しいタイマーとする。

5. timeout が null でない場合：

   1. timer および timeout を用いて タイマーを開始する。

6. elements returned を空のListとする。

7. elements returned が空であり、 timer のタイムアウト発火フラグが 設定されていない間：

   1. elements returned を、引数 start node および selector を用いて、 関連する要素位置特定戦略を呼び出すことを 試みることの結果に設定する。

   2. 要素位置特定戦略の実行中に DOMException、SyntaxError、 XPathException、またはその他のエラーが 発生した場合、 invalid selector errorを返す。

8. result を空のListとする。

9. elements returned 内の各 element について、 session および element に対する ウェブ要素参照オブジェクトを result に追加する。

10. result をデータとして持つsuccessを返す。

session および element が与えられたとき、 絶対位置を計算するには：

1. rect を、 getBoundingClientRect()を 呼び出すことにより返される値とする。

2. window を、session の 現在の トップレベル閲覧コンテキストの 関連付けられた window とする。

3. x を （window のscrollX + rect のx 座標）とする。

4. y を （window のscrollY + rect のy 座標）とする。

5. 組 (x, y) を返す。

ノードが、別のノード other と 同じツリー内にないかどうかを判定するには、 次の副手順を実行する：

1. そのノードのノード文書が other のノード文書でない場合、 true を返す。

2. そのノードの compareDocumentPosition()を、 other を引数として呼び出した結果が DOCUMENT_POSITION_DISCONNECTED (1) である場合 true を返し、 そうでなければ false を返す。

element の コンテナーは次である：

有効な要素コンテキスト内の option 要素

有効な要素コンテキスト内の optgroup 要素

element の 要素 コンテキストであり、 これは次により決定される：

1. datalist parent を、 element から逆順にツリーを走査して最初に到達する datalist 要素、 またはツリーの根に到達した場合はundefinedとする。

2. select parent を、 element から逆順にツリーを走査して最初に到達する select 要素、 またはツリーの根に到達した場合はundefinedとする。

3. datalist parent がundefinedである場合、 要素コンテキストは select parent である。 そうでなければ、要素コンテキストは datalist parent である。

無効な要素コンテキスト内の option 要素

その要素はコンテナーを持たない。

その他の場合

コンテナーは要素自身である。

要素相互作用コマンドは、 フォームコントロールを操作するための高水準の命令セットを提供する。 Actionsとは異なり、 これらは暗黙に要素をビュー内へスクロールし、 それが相互作用可能な要素であることを検査する。

一部のリセット可能要素は、それら自身の消去 アルゴリズムを定義する。 それらに関連付けられたリセットアルゴリズムとは異なり、 これらのアルゴリズムの一部としてフォームコントロールに加えられる変更は、 ユーザーにより引き起こされた変更として数えられる （したがって、例えば input イベントの発火を引き起こす）。 独自の消去アルゴリズムを定義しない 要素に対して消去アルゴリズムが呼び出されるとき、 代わりにそのリセットアルゴリズムが呼び出されなければならない。

input 要素に対する消去アルゴリズムは、 ダーティ値フラグおよびダーティ checkedness フラグを false に戻し、 要素の値を 空文字列に設定し、 要素が checked 内容属性を持つ場合は要素のcheckednessを true に設定し、 持たない場合は false に設定し、 選択されたファイルのリストを空にし、 その後、 type 属性の現在の状態が 値サニタイズアルゴリズムを定義する 場合に限りそれを呼び出すことである。

textarea 要素に対する消去アルゴリズムは、 ダーティ値フラグを false に戻し、 要素の生の値を空文字列に設定することである。

output 要素に対する消去アルゴリズムは、要素の 値モードフラグを default に設定し、 その後、要素のtextContent IDL 属性を 空文字列に設定する（したがって要素の子ノードを消去する）ことである。