Browser (JA)
3.1.1 ブラウザ
ブラウザ - Selenium 駆動のウェブブラウザを自動化します（v5 以降）。技術と設定ステップの概要は、別の document. コマンドは以下のアクションをサポートします：
“browser_open” 選択されたウェブブラウザを開き、指定されたウェブページをロードします。ブラウザはローカルでもリモートでもかまいません（Selenium Grid、6.3以降でサポート）。バージョン 8 以降、コマンドは新しいタブやウィンドウを開くこともできます。
“browser_find” 指定された条件でウェブページの要素（HTML タグ）を検索し、オプションのアクション（クリック、タイプ、サブミット、クリア）を適用します。
"browser_switch" は、タブやウィンドウを切り替えたり、それらを記述する変数を更新したりします。v8からサポートされています。
“browser_close” タブ、ウィンドウ、あるいはブラウザ全体を閉じ、 Selenium セッションを終了します。
リリース 8 から、ほとんどのブラウザコマンド操作は、利用可能なタブとウィンドウを記述する変数のセットを次のように入力します。追加パラメータなしで "Browser switch" を実行することで、強制的に更新することもできます：
変数名 | 変数名 |
|---|---|
_BROWSER_WINDOW_COUNT | 利用可能なウィンドウ/タブの数。 |
_BROWSER_WINDOW_NUMBER | 現在のウィンドウの通常番号。 |
_BROWSER_WINDOW_ID | 現在のウィンドウ/タブID。Selenium によって各ウィンドウまたはタブに割り当てられたユニークな文字列です。 |
_BROWSER_WINDOW_ID<n> | n番目のウィンドウの ID。'n'は1から _BROWSER_WINDOW_COUNT で指定されたウィンドウ数です。 |
_BROWSER_WINDOW_TITLE | 現在のウィンドウ/タブのタイトル。 |
_BROWSER_WINDOW_TITLE<n> | n番目のウィンドウのタイトル。 'n'は1から_BROWSER_WINDOW_COUNT で指定されたウィンドウ数です。 |
_BROWSER_WINDOW_URL | 現在のウィンドウ/タブの URL。 |
_BROWSER_WINDOW_URL<n> | n番目のウィンドウのURLで、'n'は1から_BROWSER_WINDOW_COUNT で指定されたウィンドウ数です。 |
SYNOPSIS
ローカルブラウザ：
Browser open browser=<browser_code> [url=<web_page>] [args=<CLI_arguments>] [opt-<name>=<value>]
リモート・ブラウザ：
Browser open browserName=<browser_code> hub=<hub_address> [url=<;web_page>]
すでに開いているブラウザで新しい URL を開く：
Browser open url=<webpage> [target=<self|window|tab>]
*赤色は必須パラメータ
オプション
browser=<browser_code>
- ブラウザのコードネーム。現在サポートされている値は以下の通りです：
"ie" - Microsoft Internet Explorer
"edge" - Microsoft Edge
"firefox" - Firefox (Gecko)
“chrome" - Google Chrome
"safari" - Safari（Mac OS X）
"chromium" - プラグインのインストールが必要 Chromium Web Driver プラグインがインストールされている必要があります (v7.0+)
url=<ウェブページ>
- 読み込むウェブページ。例："https://www.t-plan.com"。
args=<CLI_引数>
- ブラウザの種類によってサポートされている場合、ブラウザプロセスに渡される CLI 引数。v7.0 からサポートされています。詳細は seleniumの説明を参照してください。
opt-<名前>=<値>
- ブラウザの種類がサポートしている場合に、ブラウザプロセスに渡されるプリファレンス値。v7.0 からサポートされています。例えば、Chromeは "download.default_directory" 環境設定を使ってデフォルトのダウンロードディレクトリを設定します。ダウンロードを C:\MyStuff にリダイレクトするには、opt-download.default_directory="C:\MyStuff" を 使用してください。
hub=<ハブアドレス>
- Selenium Grid の ハブアドレス。
ブラウザ名=%26lt;ブラウザ名
- ハブが認識するブラウザ名。
ターゲット=%26lt;自分自身|ウィンドウ|タブ
- 指定したウェブページを開く場所。"self" (現在のウィンドウで開く)、"window" または "tab" (新しいウィンドウ/タブで開く) のいずれか。デフォルト値は "self"。v8 以降でサポートされています。
Browser find [timeout=<time_interval>] [elaction=<action>] [elnumber=<element_number>] [eltext=<text>] [elindex=<dropdown_item_index>] [elvalue=<dropdown_item_value>] [continue=<true|false>] [<attributes>]
オプション
timeout=<time_value>
- 要素を探し続けるオプションの時間。有効な time_values.
タイムアウトが指定されていない場合、コマンドは要素を一度だけ探します。
タイムアウトが指定され、それが0より大きい場合、コマンドは時間が経過するか要素が見つかるまで要素を探し続けます。
elaction=<アクション>
- 結果の要素に適用するオプションのアクション。検索によって複数の要素が生成された場合、elnumberパラメータを使用してターゲット要素を選択することができます。サポートされるアクションは以下の通りです：
"click" - 要素をクリックします。リンクやボタンなどのクリック可能な要素にのみ適用されます。
“type" -eltextパラメータで指定したテキストを入力します。text要素にのみ適用されます。
"clear" - 要素のテキストをクリアします。text要素にのみ適用されます。
"submit" - フォームを送信します。
"select" - 表示テキスト（eltext）、項目インデックス（elindex）、または "option" HTMLタグの "value " 属性で指定された値（elvalue）のいずれかによって、ドロップダウン項目を選択します。
elnumber=<要素番号>
- elaction で指定されたアクションで対象とする要素の序数。デフォルト値は1です(最初の要素を使用します)。要素数が elnumber より小さい場合、コマンドはエラーを投げます。
eltext=<テキスト>
- elaction アクションが "type" の場合、パラメータはtext要素に入力するテキストを指定します。アクションが "select" の場合、パラメータは選択されるドロップダウンの可視テキストを指定するために使用されます。 elaction=type パラメータとともに使用する必要があります。
elindex=<dropdown_item_index>
- 選択するドロップダウン項目のインデックス。インデックスは0から始まります。”select" HTML タグで表されるドロップダウン要素にのみ適用可能。
elvalue=<ドロップダウン項目の値>
- 検索・選択されるドロップダウン項目の値。option "HTMLタグの "value "属性で指定します。ドロップダウン要素（"select "HTML タグ）にのみ適用可能。
continue=<true|false>
- 失敗した場合の処理方法を指定します。要素が見つからず、このパラメータが指定されていないか false の 場合、コマンドはスクリプトを終了します。このパラメータがtrueの場合、スクリプトの続行が許可され、コマンドは0以外の終了コードを返します。
<属性>
- 次のような name=value ペアの形式の属性 (検索条件) のリスト：
"xpath=<xpath_expression>" XPath式による検索を行います。このオプションを使用する場合、他の属性を指定することはできません。
"css=<css_selector> CSS セレクタで検索します。このオプションを使用する場合、他の属性を指定することはできません。
"id=<element_id>" 要素IDで検索します。
"class=<class(es)>" CSS クラス、または要素が属するクラスの空白区切りのリスト。
"tagname=<tag_name>" ”a", "div", "img" などの HTML タグ名。
"text=<text>"正確な要素テキスト。
"parttext=<partial_text>"-". テキストが指定された部分テキストを含む要素を検索します。要素のテキストは親要素に継承されるため、これらの基準は一意ではないことに注意してください。例えば、ページ全体のテキストを取得するには、"HTML" または "body" タグを検索します。
"link=<link_text>" 指定されたテキストのリンクを検索する。
"partlink=<partial_link_text>" テキストが指定された文字列を含むリンクを検索する。
Selenium がサポートするパラメータに加えて、コマンドは任意の HTML タグの属性とその値を受け入れます。たとえば、フォームのボタンを名前で識別するにはname=%26lt;name%26gt; を使います。
HTML 属性の概要については Mozilla dev docs を 参照してください。属性のサポートはブラウザによって異なり、認識できないものもあります。
ブラウザスイッチ[id=%26lt;window_ID%26gt;] [title=%26lt;title_or_part%26gt;] [number=%26lt;window_number%26gt;] [url=%26lt;URL_or_part%26gt;] [continue=%26lt;true|false%26gt;] です。
- タイトル、URL、番号、ウィンドウIDのいずれか1つのパラメータで指定されたタブまたはウィンドウに切り替えます。識別パラメータが指定されない場合、コマンドは browser_vars.
OPTIONS
id=<ウィンドウID>
- ウィンドウ/タブID。Seleniumが各タブやウィンドウに割り当てる一意の文字列です。利用可能なIDは browser_vars.
title=<title_or_part>
- ウィンドウ/タブのタイトルまたはその一部。利用可能なタイトルの一覧は browser_varsを参照してください。タイトルの検索では大文字と小文字が区別されます。例えば、「Google」というタイトルのタブがある場合、title="Goo "を使ってそのタブに切り替えることができます。指定したタイトルに一致するタブが複数ある場合は、最初に見つかったタブが選択されます。一致するタブが見つからない場合、"continue=true "パラメータが指定されない限り、コマンドはスクリプトを終了します。
number=<ウィンドウ番号>
- 1(1)から始まるウィンドウ/タブの序数。ウィンドウの順番はSeleniumによって決定され、通常は作成された順番を反映します。現在利用可能なウィンドウの数は_BROWSER_WINDOW_COUNTによって反映されます。 browser_vars. 利用可能なウィンドウの数が要求された数より少ない場合、"continue=true" パラメータが指定されない限り、コマンドはスクリプトを終了します。
url=<URL_or_part>
- ウィンドウ/タブのURLまたはその一部。利用可能なURLの一覧は browser_vars を参照してください。検索では大文字と小文字が区別されます。例えば、"https://www.google.com "のタブがある場合、url="google "を使って切り替えることができます。指定したタイトルに一致するタブが複数ある場合は、最初に見つかったものが選択されます。一致するタブが見つからない場合、"continue=true "パラメータが指定されない限り、コマンドはスクリプトを終了します。
continue=<true|false>
- 失敗時の処理方法を指定する。ターゲットウィンドウまたはタブが見つからず、このパラメータが指定されていないか、falseの 場合、コマンドはスクリプトを終了します。このパラメータがtrueの場合、スクリプトの続行が許可され、コマンドは0以外の終了コードを返します。
Browser close
*赤色は必須パラメータを示します。
オプション
scope=<タブ|すべて>
- 閉じるスコープ。all" はデフォルトで、ブラウザ全体 (すべてのタブとウィンドウ) を閉じ、Selenium 接続を終了します。tab "の値は、現在のタブまたはウィンドウだけを閉じ、残りのタブまたはウィンドウがない場合にのみ接続を終了します。
例
Browser open browser=edge url=https://www.t-plan.com