Selenium

Browsing Context

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Japanese. Do you speak Japanese? Help us to translate it by sending us pull requests!

Commands

This section contains the APIs related to browsing context commands.

Open a new window

Creates a new browsing context in a new window.

Selenium v4.8

Browsing Context

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Japanese. Do you speak Japanese? Help us to translate it by sending us pull requests!

This section contains the APIs related to input commands.

Perform Actions

Selenium v4.17

Waiting with Expected Conditions

Mon, 01 Jan 0001 00:00:00 +0000

Expected Conditions are used with Explicit Waits. Instead of defining the block of code to be executed with a lambda, an expected conditions method can be created to represent common things that get waited on. Some methods take locators as arguments, others take elements as arguments.

These methods can include conditions such as:

element exists
element is stale
element is visible
text is visible
title contains specified value

Expected Conditions Documentation

WebDriver BiDi Network Features

Mon, 01 Jan 0001 00:00:00 +0000

The implementation of these features is being tracked here: #13993

Remember that to use WebDriver BiDi, you must enable it in Options. For more details, see Enabling BiDi

Authentication Handlers

Authentication handlers enable you to intercept authentication requests that occur during a network interaction. These handlers are useful for automating scenarios involving authentication prompts, such as Basic Auth or Digest Auth. They allow you to programmatically provide credentials or modify the authentication flow.

Network

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Japanese. Do you speak Japanese? Help us to translate it by sending us pull requests!

Commands

This section contains the APIs related to network commands.

Add network intercept

Selenium v4.18

Script

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Japanese. Do you speak Japanese? Help us to translate it by sending us pull requests!

Commands

This section contains the APIs related to script commands.

Call function in a browsing context

Selenium v4.15

デザインパターンと開発戦略

Mon, 01 Jan 0001 00:00:00 +0000

(以前の場所: https://github.com/SeleniumHQ/selenium/wiki/Bot-Style-Tests)

概要

時間の経過とともに、プロジェクトは多数のテストが積み上がる傾向があります。テストの総数が増えると、コードベースに変更を加えることが難しくなります。アプリケーションが正常に機能していても、1回の"単純な"変更で多数のテストが失敗する可能性があります。これらの問題が避けられない場合もありますが、問題が発生した場合は、できるだけ早く稼働を再開する必要があります。次のデザインパターンと戦略は、テストの作成と保守を容易にするためにWebDriverで以前に使用されています。それらもあなたにとって役に立つかもしれません。

DomainDrivenDesign：アプリのエンドユーザーの言語でテストを表現します。
PageObjects：WebアプリのUIの単純な抽象化
LoadableComponent：PageObjectsをコンポーネントとしてモデリングします。
BotStyleTests：PageObjectsが推奨するオブジェクトベースのアプローチではなく、コマンドベースのアプローチを使用してテストを自動化します。

ロード可能なコンポーネント

それは何ですか？

LoadableComponentは、PageObjectsの作成の負担を軽減することを目的としたベースクラスです。これは、ページがロードされることを保証する標準的な方法を提供し、ページのロードの失敗のデバッグを容易にするフックを提供することによってこれを行います。これを使用して、テストの定型コードの量を減らすことができます。これにより、テストの保守が面倒になります。

現在、Selenium 2の一部として出荷されるJavaの実装がありますが、使用されるアプローチは、どの言語でも実装できるほど単純です。

簡単な使用方法

モデル化するUIの例として、新しいissueのページをご覧ください。テスト作成者の観点から、これは新しい問題を提出できるサービスを提供します。基本的なページオブジェクト(このシンプルな版を EditIssueBasic と呼び、後で EditIssue という LoadableComponent に発展させます)は次のようになります。

Add Example

ブラウザーナビゲーション

Mon, 01 Jan 0001 00:00:00 +0000

ナビゲート

ブラウザーを起動した後に最初に行うことは、Webサイトを開くことです。これは1行で実現できます。

 //Convenient
 driver.get("https://selenium.dev");
 
 //Longer way
 driver.navigate().to("https://selenium.dev");

View Complete Code View on GitHub

driver.get("https://www.selenium.dev/selenium/web/index.html")

View Complete Code View on GitHub

 //Convenient
 driver.Url = "https://selenium.dev";
 //Longer
 driver.Navigate().GoToUrl("https://selenium.dev");

View Complete Code View on GitHub


 it 'navigates to a page' do
 driver.navigate.to 'https://www.selenium.dev/'

View Complete Code View on GitHub

 //Convenient
 await driver.get('https://www.selenium.dev');

 //Longer way
 await driver.navigate().to("https://www.selenium.dev/selenium/web/index.html");

View Complete Code View on GitHub

//Convenient
driver.get("https://selenium.dev")

//Longer way
driver.navigate().to("https://selenium.dev")

戻る

ブラウザーの戻るボタンを押す。

 //Back
 driver.navigate().back();

View Complete Code View on GitHub

driver.back()

View Complete Code View on GitHub

 //Back
  driver.Navigate().Back();

View Complete Code View on GitHub

 driver.navigate.to 'https://www.selenium.dev/'

View Complete Code View on GitHub

 //Back
 await driver.navigate().back();

View Complete Code View on GitHub

driver.navigate().back()

要素を探す

Mon, 01 Jan 0001 00:00:00 +0000

ロケーターは、ページ上の要素を識別する方法です。これは、検索要素メソッドに渡される引数です。

検出方法とは別にロケーターを宣言するタイミングと理由など、ロケーターに関するヒントについては、推奨されるテストプラクティスを確認してください。

要素選択の方法

WebDriverには標準のロケータが8種類あります。

ロケータ	詳細
class name	class名に値を含む要素を探す (複合クラス名は使えない)
css selector	CSSセレクタが一致する要素を探す
id	id属性が一致する要素を探す
name	name属性が一致する要素を探す
link text	a要素のテキストが一致する要素を探す
partial link text	a要素のテキストが部分一致する要素を探す
tag name	タグ名が一致する要素を探す
xpath	XPathと一致する要素を探す

Creating Locators

To work on a web element using Selenium, we need to first locate it on the web page. Selenium provides us above mentioned ways, using which we can locate element on the page. To understand and create locator we will use the following HTML snippet.

Selenium GridのCLI オプション

Mon, 01 Jan 0001 00:00:00 +0000

Grid の設定には、さまざまなセクションが用意されています。各セクションには、コマンドライン引数で設定可能なオプションがあります。コマンドライン引数で設定できます。

コンポーネントとセクションの対応は以下の通りです。

オプションが変更、または追加されたが文書化されていない場合、このドキュメントは古くなる可能性があることに注意してください。もしそのような状況を見つけたら、“構成ヘルプ”を確認し、ドキュメントを更新するプルリクエストを気軽に送ってください。

セクション

	スタンドアロン	ハブ	ノード	ディストリビューター	ルーター	セッション	新規セッションキュー
Distributor
Docker
Events
Logging
Network
Node
Router
Relay
Server
SessionQueue
Sessions

Distributor

オプション	型	値/例	概要
`--healthcheck-interval`	int	`120`	全てのノードに対してヘルスチェックを実行する頻度（秒）を指定します。これにより、サーバーは全てのノードに対して正常に ping を送信できるようになります。
`--distributor`	uri	`http://localhost:5553`	ディストリビューターの URL。
`--distributor-host`	string	`localhost`	ディストリビューターがリッスンするホスト名。
`--distributor-implementation`	string	`org.openqa.selenium.grid.distributor.local.LocalDistributor`	デフォルトでないディストリビューター実装の完全なクラス名。
`--distributor-port`	int	`5553`	ディストリビューターがリッスンするポート番号。
`--reject-unsupported-caps`	boolean	`false`	Grid がサポートしていない capabilities をリクエストされた時、ディストリビューターがリクエストを即座に今日できるようにします。これはオンデマンドでノードを立ち上げをしない Grid の設定に適しています。
`--slot-matcher`	string	`org.openqa.selenium.grid.data.DefaultSlotMatcher`	デフォルト以外で使用するスロットマッチャーの完全なクラス名。これはノードが特定のセッションをサポートできるかを判断するために使用されます。
`--slot-selector`	string	`org.openqa.selenium.grid.distributor.selector.DefaultSlotSelector`	デフォルト以外のスロットセレクターの完全なクラス名。これは、ノードがマッチした後ノード内のスロットを選択するために使用されます。
`--newsession-threadpool-size`	int	`24`	The Distributor uses a fixed-sized thread pool to create new sessions as it consumes new session requests from the queue. This allows configuring the size of the thread pool. The default value is no. of available processors * 3. Note: If the no. of threads is way greater than the available processors it will not always increase the performance. A high number of threads causes more context switching which is an expensive operation.
`--purge-nodes-interval`	int	`30`	How often, in seconds, will the Distributor purge Nodes that have been down for a while. This is calculated based on the heartbeat received from a particular node.

Docker

オプション	型	値/例	概要
`--docker-assets-path`	string	`/opt/selenium/assets`	アセットが保存される絶対パス。
`--docker-`	string[]	`selenium/standalone-firefox:latest '{"browserName": "firefox"}'`	イメージとステレオタイプの capabilities を対応付ける Docker 設定 (例 `-D selenium/standalone-firefox:latest ‘{“browserName”: “firefox”}’)
`--docker-devices`	string[]	`/dev/kvm:/dev/kvm`	コンテナに対してデバイスを公開します。各デバイスマッピングは、ホストとコンテナの両方のデバイスへのパスを、コロンで区切って保つ必要があります。例: /device/path/in/host:/device/path/in/container
`--docker-host`	string	`localhost`	Docker デーモンが動作しているホスト名。
`--docker-port`	int	`2375`	Docker デーモンが動作しているポート名。
`--docker-url`	string	`http://localhost:2375`	Docker デーモンに接続するための URL。
`--docker-video-image`	string	`selenium/video:latest`	ビデオレコーディングが有効になっているときに利用される Docker イメージ。
`--docker-host-config-keys`	string[]	`Dns DnsOptions DnsSearch ExtraHosts Binds`	Specify which docker host configuration keys should be passed to browser containers. Keys name can be found in the Docker API documentation, or by running `docker inspect` the node-docker container.

Events

オプション	型	値/例	概要
`--bind-bus`	boolean	`false`	接続をバインドするかコネクトするかを指定します。 true の場合、コンポーネントはイベントバスにバインドされます（イベントバスもコンポーネントによって起動されます、通常はディストリビューターとハブによって起動されます）。 false の場合、コンポーネントがイベントバスにコネクトします。
`--events-implementation`	string	`org.openqa.selenium.events.zeromq.ZeroMqEventBus`	デフォルトでないイベントバス実装の完全なクラス名。
`--publish-events`	string	`tcp://*:4442`	イベントをイベントバスに配信するための接続文字列。
`--subscribe-events`	string	`tcp://*:4443`	イベントをイベントバスから購読するための接続文字列。

Logging

オプション	型	値/例	概要
`--http-logs`	boolean	`false`	http ログを有効にします。http ログを記録するには、トレースを有効にする必要があります。
`--log-encoding`	string	`UTF-8`	ログのエンコーディング。
`--log`	string	Windows パスの例: `'\path\to\file\gridlog.log'` or `'C:\path\path\to\file\gridlog.log'` Linux/Unix/MacOS パスの例: `'/path/to/file/gridlog.log'`	ログを出力するファイル。OS のファイルパスと互換性があることを確認してください。
`--log-level`	string	`“INFO”`	ログレベル。デフォルトは INFO です。ログレベルはこちらを参照してください。 https://docs.oracle.com/en/java/javase/11/docs/api/java.logging/java/util/logging/Level.html
`--plain-logs`	boolean	`true`	プレーンなログを使用します。
`--structured-logs`	boolean	`false`	構造化ログを使用します。
`--tracing`	boolean	`true`	トレースを有効にします。
`--log-timestamp-format`	string	`HH:mm:ss.SSS`	ログのタイムスタンプ形式を設定できます。

Network

オプション	型	値/例	概要
`--relax-checks`	boolean	`false`	受信リクエストのオリジンヘッダーとコンテンツタイプに対する、厳格な W3C 準拠の検証をを緩和します。

Node

オプション	型	値/例	概要
`--detect-drivers`	boolean	`true`	現在のシステム上で利用可能なドライバーを自動で検出してノードに追加します。
`--driver-configuration`	string[]	`display-name="Firefox Nightly" max-sessions=2 webdriver-path="/usr/local/bin/geckodriver" stereotype="{\"browserName\": \"firefox\", \"browserVersion\": \"86\", \"moz:firefoxOptions\": {\"binary\":\"/Applications/Firefox Nightly.app/Contents/MacOS/firefox-bin\"}}"`	ノードがサポートするドライバーの一覧。可読性向上のため TOML ファイルで設定することを推奨します。
`--driver-factory`	string[]	`org.openqa.selenium.example.LynxDriverFactory '{"browserName": "lynx"}'`	完全修飾クラス名と、そのクラスが対応するブラウザの設定とのマッピング。
`--driver-implementation`	string[]	`"firefox"`	チェックされるドライバー。指定された場合、自動設定はスキップされます。
`--node-implementation`	string	`"org.openqa.selenium.grid.node.local.LocalNodeFactory"`	デフォルトでないノード実装の完全なクラス名。これはセッションのライフサイクルを管理するために使用されます。
`--grid-url`	string	`https://grid.example.com`	Grid 全体のパブリックな URL (通常ハブかルーターのアドレスです)。
`--heartbeat-period`	int	`60`	ノードが生存していることを知らせるため、ノードがディストリビューターに送るハードビートを、どのくらいの頻度（秒）で送るか。
`--max-sessions`	int	`8`	最大同時接続セッション数。デフォルトは利用可能なプロセッサーの数です。
`--override-max-sessions`	boolean	`false`	利用可能なプロセッサーの数は、推奨される最大セッション数（プロセッサーごとに 1 つのブラウザセッション）です。このフラグを true に設定すると、推奨される最大値を上書きすることができます。セッションの安定性と信頼性が損なわれ、ホストがリソースを使い果たす可能性があります。
`--register-cycle`	int	`10`	ノードがディストリビューターに初回登録を試みる頻度(秒)。
`--register-period`	int	`120`	ノードが初めてディストリビューターに初回登録を試みるのにかかる時間(秒)。この時間が経過すると、ノードは再登録を試みない。
`--session-timeout`	int	`300`	X をセッションタイムアウト(秒)としたとき、ノードは、過去 X 秒間に何の活動もなかったセッションを自動的に終了させます。これにより他のテストが利用できるようスロットを解放します。
`--vnc-env-var`	string[]	`SE_START_XVFB SE_START_VNC SE_START_NO_VNC`	VNC ストリームが利用可能かどうかを判断するために利用する環境変数。
`--no-vnc-port`	int	`7900`	VNC が利用可能な場合、ローカルの noVNC ストリームを取得できるポートを設定します。
`--drain-after-session-count`	int	`1`	X 個のセッションが実行された後に、ノードをドレインしてシャットダウンします。 Kubernetes のような環境で有用です。 0 より大きい値を指定すると、この機能が有効になります。
`--hub`	string	`http://localhost:4444`	ハブ・ノード構成におけるハブのアドレスを指定します。ホスト名か IP アドレスが指定できます。この場合、ハブは `http://hostname:4444` とみなされ、 `--grid-url` は同じものになります。 `--publish-events` は `tcp://hostname:4442` 、`--subscribe-events` は `tcp://hostname:4443` となります。 `hostname` にポート番号が含まれている場合は、それが `--grid-url` に使用されますが、イベントバスの URI は変更されません。これらのデフォルト値は、適切なフラグを設定することでオーバーライドすることができます。ホスト名にプロトコル(`https`のような)が含まれる場合もそれが利用されます。
`--enable-cdp`	boolean	`true`	Grid 内で CDP プロキシーを有効にします。もしネットワークが web socket を許可していない場合、Grid 管理者は CDP を無効にできます。デフォルトは true です。
`--enable-managed-downloads`	boolean	`false`	This causes the Node to auto manage files downloaded for a given session on the Node.
`--selenium-manager`	boolean	`false`	When drivers are not available on the current system, use Selenium Manager. False by default.
`--connection-limit-per-session`	int	`10`	Let X be the maximum number of websocket connections per session.This will ensure one session is not able to exhaust the connection limit of the host.

Relay

オプション	型	値/例	概要
`--service-url`	string	`http://localhost:4723`	Appium サーバーやクラウドサービスなど、WebDriver コマンドをサポートするサービスに接続するための URL です。
`--service-host`	string	`localhost`	WebDriver コマンドをサポートしてるサービスが稼働しているホスト名。
`--service-port`	int	`4723`	WebDriver コマンドをサポートしてるサービスが稼働しているポート番号。
`--service-status-endpoint`	string	`/status`	WebDriver サービスの状態を問い合わせるエンドポイント、オプショナルです。HTTP 200 レスポンスが期待されます。
`--service-protocol-version`	string	`HTTP/1.1`	Optional, enforce a specific protocol version in HttpClient when communicating with the endpoint service status
`--service-configuration`	string[]	`max-sessions=2 stereotype='{"browserName": "safari", "platformName": "iOS", "appium:platformVersion": "14.5"}}'`	呼び出しの中継先となるサービスの設定。可読性向上のため、TOML ファイルで設定することを推奨します。

Router

オプション	型	値/例	概要
`--password`	string	`myStrongPassword`	クライアントがサーバーに接続する際に使用するパスワード。このパスワードとユーザー名の両方が設定されていないと使用できません。
`--username`	string	`admin`	クライアントがサーバーに接続する際に使用するユーザー名。このユーザー名とパスワードの両方が設定されていないと使用できません。
`--sub-path`	string	`my_company/selenium_grid`	A sub-path that should be considered for all user facing routes on the Hub/Router/Standalone.
`--disable-ui`	boolean	`true`	Disable the Grid UI.

Server

オプション	型	値/例	概要
`--allow-cors`	boolean	`true`	Selenium サーバーが任意のホストからのウェブブラウザ接続を許可するかどうか。
`--host`	string	`localhost`	サーバーの IP もしくはホスト名、通常自動的に決定されます。
`--bind-host`	boolean	`true`	サーバがホストアドレス/ホスト名にバインドするか、あるいは到達可能な URL を知らせるためだけに使用するかを指定します。複雑なネットワーク構成で、サーバが現在の IP やホスト名ではなく、外部の IP やホスト名で自分自身を公開する場合に有用です (例: Docker コンテナ内)。
`--https-certificate`	path	`/path/to/cert.pem`	HTTPS のためのサーバー証明書。詳細は “java -jar selenium-server.jar info security” を実行してください。
`--https-private-key`	path	`/path/to/key.pkcs8`	HTTPS のための秘密鍵。詳細は “java -jar selenium-server.jar info security” を実行してください。
`--max-threads`	int	`24`	リスナースレッドの最大数。デフォルトは、有効なプロセッサーの * 3 です。
`--port`	int	`4444`	リッスンポート。このパラメータは異なるコンポーネントによって使用されるため、デフォルトはありません。例えば、ルータ/ハブ/スタンドアロンは 4444 を使用し、ノードは 5555 を使用します。

SessionQueue

オプション	型	値/例	概要
`--sessionqueue`	uri	`http://localhost:1237`	新規セッションキューサーバーのアドレス。
`-sessionqueue-host`	string	`localhost`	新規セッションキューがリッスンするホスト。
`--sessionqueue-port`	int	`1234`	新規セッションキューがリッスンするポート
`--session-request-timeout`	int	`300`	タイムアウト(秒)。新規セッションリクエストはキューに追加され、設定された時間以上キューに残っているリクエストはタイムアウトします。
`--session-retry-interval`	int	`5`	リトライ間隔(秒)。すべてのスロットがビジーな場合、新規セッションリクエストはこの時間の間隔をおいてからリトライされます。
`--maximum-response-delay`	int	`8`	How often, in seconds, will the the SessionQueue response in case there is no data, to reduce the http requests while polling for new session requests.

Sessions

オプション	型	値/例	概要
`--sessions`	uri	`http://localhost:1234`	セッションマップサーバーのアドレス。
`--sessions-host`	string	`localhost`	セッションマップサーバーがリッスンするホスト。
`--sessions-port`	int	`1234`	セッションマップサーバーがリッスンするポート。

設定例

上記のオプションはすべて、Grid コンポーネントを起動する際に使用することができます。 Grid の適切な設定を模索するのに利用してください。

Interacting with web elements

Mon, 01 Jan 0001 00:00:00 +0000

There are only 5 basic commands that can be executed on an element:

click (applies to any element)
send keys (only applies to text fields and keyboard interactable elements)
clear (only applies to text fields and content editable elements)
submit (only applies to form elements)
select (see Select List Elements)

Additional validations

These methods are designed to closely emulate a user’s experience, so, unlike the Actions API, it attempts to perform two things before attempting the specified action.

Internet Explorer Driver Internals

Mon, 01 Jan 0001 00:00:00 +0000

Client Code Into the Driver

We use the W3C WebDriver protocol to communicate with a local instance of an HTTP server. This greatly simplifies the implementation of the language-specific code, and minimizes the number of entry points into the C++ DLL that must be called using a native-code interop technology such as JNA, ctypes, pinvoke or DL.

Memory Management

The IE driver utilizes the Active Template Library (ATL) to take advantage of its implementation of smart pointers to COM objects. This makes reference counting and cleanup of COM objects much easier.

Chrome DevTools Logging Features

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Japanese. Do you speak Japanese? Help us to translate it by sending us pull requests!

While Selenium 4 provides direct access to the Chrome DevTools Protocol, these methods will eventually be removed when WebDriver BiDi implemented.

Console Logs

 ((HasLogEvents) driver).onLogEvent(consoleEvent(e -> messages.add(e.getMessages().get(0))));

View Complete Code View on GitHub

 async with driver.bidi_connection() as session:
 async with Log(driver, session).add_listener(Console.ALL) as messages:

View Complete Code View on GitHub

 using IJavaScriptEngine monitor = new JavaScriptEngine(driver);
 var messages = new List<string>();
 monitor.JavaScriptConsoleApiCalled += (_, e) =>
 {
 messages.Add(e.MessageContent);
 };
 await monitor.StartEventMonitoring();

View Complete Code View on GitHub

 driver.on_log_event(:console) { |log| logs << log.args.first }

View Complete Code View on GitHub

Implementation Missing

コマンドリスナー

Mon, 01 Jan 0001 00:00:00 +0000

特定の Selenium コマンドが送信されるたびに、カスタムアクションを実行できます。

Add Example

HTTPクライアントの設定

Mon, 01 Jan 0001 00:00:00 +0000

これにより、HTTPライブラリのさまざまなパラメーターを設定できます。

package dev.selenium.drivers;

import dev.selenium.BaseTest;

import org.openqa.selenium.remote.http.ClientConfig;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.openqa.selenium.chrome.ChromeOptions;
import org.openqa.selenium.remote.RemoteWebDriver;

import javax.net.ssl.SSLContext;
import javax.net.ssl.TrustManager;
import javax.net.ssl.TrustManagerFactory;
import javax.net.ssl.X509TrustManager;
import java.io.FileInputStream;
import java.net.URL;
import java.nio.file.Path;
import java.security.KeyStore;
import java.security.cert.CertificateFactory;
import java.security.cert.X509Certificate;
import java.time.Duration;

import org.openqa.selenium.UsernameAndPassword;

import static java.net.http.HttpClient.Version.HTTP_1_1;

public class HttpClientTest extends BaseTest {
 URL gridUrl;

 @BeforeEach
 public void startGrid() {
 gridUrl = startStandaloneGridAdvanced();
 }

 @Test
 public void remoteWebDriverWithClientConfig() throws Exception {
 ClientConfig clientConfig = ClientConfig.defaultConfig()
 .withRetries()
 .sslContext(createSSLContextWithCA(Path.of("src/test/resources/tls.crt").toAbsolutePath().toString()))
 .connectionTimeout(Duration.ofSeconds(300))
 .readTimeout(Duration.ofSeconds(3600))
 .authenticateAs(new UsernameAndPassword("admin", "myStrongPassword"))
 .version(HTTP_1_1.toString());
 ChromeOptions options = getDefaultChromeOptions();
 options.setEnableDownloads(true);
 driver = RemoteWebDriver.builder()
 .oneOf(options)
 .address(gridUrl)
 .config(clientConfig)
 .build();
 }

 @Test
 public void remoteWebDriverIgnoreSSL() throws Exception {
 ClientConfig clientConfig = ClientConfig.defaultConfig()
 .withRetries()
 .sslContext(createIgnoreSSLContext())
 .connectionTimeout(Duration.ofSeconds(300))
 .readTimeout(Duration.ofSeconds(3600))
 .authenticateAs(new UsernameAndPassword("admin", "myStrongPassword"))
 .version(HTTP_1_1.toString());
 ChromeOptions options = getDefaultChromeOptions();
 options.setEnableDownloads(true);
 driver = RemoteWebDriver.builder()
 .oneOf(options)
 .address(gridUrl)
 .config(clientConfig)
 .build();
 }

 @Test
 public void remoteWebDriverWithEmbedAuthUrl() throws Exception {
 ClientConfig clientConfig = ClientConfig.defaultConfig()
 .withRetries()
 .sslContext(createSSLContextWithCA(Path.of("src/test/resources/tls.crt").toAbsolutePath().toString()))
 .connectionTimeout(Duration.ofSeconds(300))
 .readTimeout(Duration.ofSeconds(3600))
 .version(HTTP_1_1.toString());
 ChromeOptions options = getDefaultChromeOptions();
 options.setEnableDownloads(true);
 driver = RemoteWebDriver.builder()
 .oneOf(options)
 .address(embedAuthToUrl(gridUrl, "admin", "myStrongPassword"))
 .config(clientConfig)
 .build();
 }

 private URL embedAuthToUrl(URL url, String username, String password) throws Exception {
 String userInfo = username + ":" + password;
 String urlWithAuth = url.getProtocol() + "://" + userInfo + "@" + url.getHost() + ":" + url.getPort() + url.getPath();
 return new URL(urlWithAuth);
 }

 public static SSLContext createSSLContextWithCA(String caCertPath) throws Exception {
 FileInputStream fis = new FileInputStream(caCertPath);
 CertificateFactory cf = CertificateFactory.getInstance("X.509");
 X509Certificate caCert = (X509Certificate) cf.generateCertificate(fis);
 KeyStore keyStore = KeyStore.getInstance(KeyStore.getDefaultType());
 keyStore.load(null, null);
 keyStore.setCertificateEntry("caCert", caCert);
 TrustManagerFactory tmf = TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm());
 tmf.init(keyStore);
 SSLContext sslContext = SSLContext.getInstance("TLS");
 sslContext.init(null, tmf.getTrustManagers(), null);
 return sslContext;
 }

 public static SSLContext createIgnoreSSLContext() throws Exception {
 TrustManager[] trustAllCerts = new TrustManager[]{
 new X509TrustManager() {
 public X509Certificate[] getAcceptedIssuers() {
 return null;
 }

 public void checkClientTrusted(X509Certificate[] certs, String authType) {
 }

 public void checkServerTrusted(X509Certificate[] certs, String authType) {
 }
 }
 };
 SSLContext sslContext = SSLContext.getInstance("TLS");
 sslContext.init(null, trustAllCerts, new java.security.SecureRandom());
 return sslContext;
 }
}

View on GitHub

import os
import pytest
import sys
from urllib3.util import Retry, Timeout
from selenium import webdriver
from selenium.webdriver.common.proxy import Proxy
from selenium.webdriver.common.proxy import ProxyType
from selenium.webdriver.remote.client_config import ClientConfig


@pytest.mark.skipif(sys.platform == "win32", reason="Gets stuck on Windows, passes locally")
def test_start_remote_with_client_config(grid_server):
 proxy = Proxy({"proxyType": ProxyType.AUTODETECT})
 retries = Retry(connect=2, read=2, redirect=2)
 timeout = Timeout(connect=300, read=3600)
 client_config = ClientConfig(remote_server_addr=grid_server,
 proxy=proxy,
 init_args_for_pool_manager={
 "init_args_for_pool_manager": {"retries": retries, "timeout": timeout}},
 ca_certs=_get_resource_path("tls.crt"),
 username="admin", password="myStrongPassword")
 options = get_default_chrome_options()
 driver = webdriver.Remote(command_executor=grid_server, options=options, client_config=client_config)
 driver.get("https://www.selenium.dev")
 driver.quit()


@pytest.mark.skipif(sys.platform == "win32", reason="Gets stuck on Windows, passes locally")
def test_start_remote_ignore_certs(grid_server):
 proxy = Proxy({"proxyType": ProxyType.AUTODETECT})
 client_config = ClientConfig(remote_server_addr=grid_server,
 proxy=proxy,
 timeout=3600,
 ignore_certificates=True,
 username="admin", password="myStrongPassword")
 options = get_default_chrome_options()
 driver = webdriver.Remote(command_executor=grid_server, options=options, client_config=client_config)
 driver.get("https://www.selenium.dev")
 driver.quit()


def _get_resource_path(file_name: str):
 if os.path.abspath("").endswith("tests"):
 path = os.path.abspath(f"resources/{file_name}")
 else:
 path = os.path.abspath(f"tests/resources/{file_name}")
 return path

def get_default_chrome_options():
 options = webdriver.ChromeOptions()
 options.add_argument("--no-sandbox")
 return options

View on GitHub

Add Example

Selenium Manager (Beta)

Mon, 01 Jan 0001 00:00:00 +0000

Motivation

TL;DR: Selenium Manager is the official driver manager of the Selenium project, and it is shipped out of the box with every Selenium release.

Selenium uses the native support implemented by each browser to carry out the automation process. For this reason, Selenium users need to place a component called driver (chromedriver, geckodriver, msedgedriver, etc.) between the script using the Selenium API and the browser. For many years, managing these drivers was a manual process for Selenium users. This way, they had to download the required driver for a browser (chromedriver for Chrome, geckodriver for Firefox, etc.) and place it in the PATH or export the driver path as a system property (Java, JavaScript, etc.). But this process was cumbersome and led to maintainability issues.

Toml オプション

Mon, 01 Jan 0001 00:00:00 +0000

CLI オプションに記載されている全てのオプションは TOML ファイルでも設定ができます。このページでは異なる Grid コンポーネントの設定例を紹介します。

概要

Selenium Grid はTOMLフォーマットの設定ファイルを使用します。設定ファイルはセクションで構成され、各セクションはオプションとその値が設定されています。

詳しい使い方はTOML ドキュメントを参照してください。パースエラーに遭遇した場合、TOML リンターを使って検証してください。

一般的な設定の構成は以下のパターンです:

[section1]
option1="value"

[section2]
option2=["value1","value2"]
option3=true

TOML ファイルで設定された Grid コンポーネントを起動するには以下のように起動できます:

java -jar selenium-server-<version>.jar <component> --config /path/to/file/<file-name>.toml

スタンドアロン

ポート 4449 で動作し、新規セッションリクエストのタイムアウトが 500 秒のスタンドアロンサーバー。

[server]
port = 4449

[sessionqueue]
session-request-timeout = 500

特定のブラウザとセッションの上限

Firefox と Chrome のみがデフォルトで有効になっているスタンドアロンサーバー、またはノード

[node]
drivers = ["chrome", "firefox"]
max-sessions = 3

ドライバーのカスタマイズと設定

Firefox Beta や Nightly のような、異なるブラウザのバージョンを持つことができるカスタマイズされたドライバを用いた、スタンドアロン、またはノード。

[node]
detect-drivers = false
[[node.driver-configuration]]
max-sessions = 100
display-name = "Firefox Nightly"
stereotype = "{\"browserName\": \"firefox\", \"browserVersion\": \"93\", \"platformName\": \"MAC\", \"moz:firefoxOptions\": {\"binary\": \"/Applications/Firefox Nightly.app/Contents/MacOS/firefox-bin\"}}"
[[node.driver-configuration]]
display-name = "Chrome Beta"
stereotype = "{\"browserName\": \"chrome\", \"browserVersion\": \"94\", \"platformName\": \"MAC\", \"goog:chromeOptions\": {\"binary\": \"/Applications/Google Chrome Beta.app/Contents/MacOS/Google Chrome Beta\"}}"
[[node.driver-configuration]]
display-name = "Chrome Dev"
stereotype = "{\"browserName\": \"chrome\", \"browserVersion\": \"95\", \"platformName\": \"MAC\", \"goog:chromeOptions\": {\"binary\": \"/Applications/Google Chrome Dev.app/Contents/MacOS/Google Chrome Dev\"}}"
webdriver-executable = '/path/to/chromedriver/95/chromedriver'

Docker を利用したスタンドアロン、またはノード

Docker コンテナでセッションを実行できるスタンドアロン、またはノードサーバー。ドライバを検出を無効にし、最大 2 つの同時セッションを持ちます。ステレオタイプは、Docker イメージにマッピングされる必要があり、 Docker デーモンが http/tcp で公開されている必要があります。また、devicesプロパティを用いて、ホスト上でアクセス可能なデバイスファイルを、コンテナで利用できるようにすることも可能です。 Docker デバイスをマッピングする詳しい方法はdocker を参照してください。

ドライバーサービスクラス

Mon, 01 Jan 0001 00:00:00 +0000

サービスクラスは、ドライバーの起動と停止を管理するためのものです。リモートWebDriverセッションでは使用できません。

サービスクラスを使用すると、ドライバーに関する情報（場所や使用するポートなど）を指定できます。また、コマンドラインに渡される引数を指定することもできます。便利な引数のほとんどは、ログに関連しています。

デフォルトサービスインスタンス

デフォルトサービスインスタンスを使用してドライバーを起動するには：

 ChromeDriverService service = new ChromeDriverService.Builder().build();
 driver = new ChromeDriver(service);

View Complete Code View on GitHub

Selenium v4.11

Chrome固有の機能

Mon, 01 Jan 0001 00:00:00 +0000

これらは、Google Chromeブラウザに特有の機能と機能です。デフォルトでは、Selenium 4はChrome v75以上と互換性があります。Chromeブラウザのバージョンとchromedriverのバージョンは、メジャーバージョンが一致する必要があることに注意してください。

Options

すべてのブラウザに共通する機能はオプションページに記載されています。

ChromeおよびChromiumに特有の機能は、Googleの Capabilities & ChromeOptionsのページにドキュメントされています。

基本的に定義されたオプションでChromeセッションを開始する場合は、次のようになります：

 ChromeOptions options = getDefaultChromeOptions();
 driver = new ChromeDriver(options);

View Complete Code View on GitHub

 options = webdriver.ChromeOptions()
 options.add_argument("--no-sandbox")
 driver = webdriver.Chrome(options=options)

View Complete Code View on GitHub

 var options = new ChromeOptions();
 driver = new ChromeDriver(options);

View Complete Code View on GitHub

 options = Selenium::WebDriver::Options.chrome
 @driver = Selenium::WebDriver.for :chrome, options: options

View Complete Code View on GitHub

 const Options = new Chrome.Options();
 let driver = new Builder()
 .forBrowser(Browser.CHROME)
 .setChromeOptions(Options)
 .build();

View Complete Code View on GitHub

Add Example

Customizing a Node

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Japanese. Do you speak Japanese? Help us to translate it by sending us pull requests!

How to customize a Node

There are times when we would like a Node to be customized to our needs.

For e.g., we may like to do some additional setup before a session begins execution and some clean-up after a session runs to completion.

Following steps can be followed for this:

Logging Selenium commands

Mon, 01 Jan 0001 00:00:00 +0000

Turning on logging is a valuable way to get extra information that might help you determine why you might be having a problem.

Getting a logger

Java logs are typically created per class. You can work with the default logger to work with all loggers. To filter out specific classes, see Filtering

Chrome DevTools Network Features

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Japanese. Do you speak Japanese? Help us to translate it by sending us pull requests!

While Selenium 4 provides direct access to the Chrome DevTools Protocol, these methods will eventually be removed when WebDriver BiDi implemented.

Basic authentication

Some applications make use of browser authentication to secure pages. It used to be common to handle them in the URL, but browsers stopped supporting this. With this code you can insert the credentials into the header when necessary

Web要素に関する情報

Mon, 01 Jan 0001 00:00:00 +0000

特定の要素についてクエリできる詳細情報がいくつかあります。

表示されているかどうか

This method is used to check if the connected Element is displayed on a webpage. Returns a Boolean value, True if the connected element is displayed in the current browsing context else returns false.

This functionality is mentioned in, but not defined by the w3c specification due to the impossibility of covering all potential conditions. As such, Selenium cannot expect drivers to implement this functionality directly, and now relies on executing a large JavaScript function directly. This function makes many approximations about an element’s nature and relationship in the tree to return a value.

Edge固有の機能

Mon, 01 Jan 0001 00:00:00 +0000

Microsoft EdgeはChromiumで実装されており、サポートされている最も古いバージョンはv79です。 Chromeと同様に、edgedriverのメジャーバージョン番号は、Edgeブラウザのメジャーバージョンと一致する必要があります。

Chromeページにあるすべての機能とオプションは、Edgeでも機能します。

オプション

すべてのブラウザに共通する機能はオプションページに記載されています。

Chromiumに特有の機能は、GoogleのCapabilities & ChromeOptionsページに文書化されています。

基本的な定義済みオプションを使用して Edgeセッションを開始すると、次のようになります。

View Complete Code View on GitHub

 options = webdriver.EdgeOptions()
 options.add_argument("--no-sandbox")
 driver = webdriver.Edge(options=options)

View Complete Code View on GitHub

 catch (IOException)
 {

View Complete Code View on GitHub

 options = Selenium::WebDriver::Options.edge
 options.args << '--no-sandbox'
 @driver = Selenium::WebDriver.for :edge, options: options

View Complete Code View on GitHub

 let options = new edge.Options().addArguments('--no-sandbox');
 driver = new Builder()
 .forBrowser(Browser.EDGE)
 .setEdgeOptions(options)
 .build();

View Complete Code View on GitHub

Add Example

External datastore

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Japanese. Do you speak Japanese? Help us to translate it by sending us pull requests!

Introduction

Selenium Grid allows you to persist information related to currently running sessions into an external data store. The external data store could be backed by your favourite database (or) Redis Cache system.

Pen actions

Mon, 01 Jan 0001 00:00:00 +0000

Chromium Only

A Pen is a type of pointer input that has most of the same behavior as a mouse, but can also have event properties unique to a stylus. Additionally, while a mouse has 5 buttons, a pen has 3 equivalent button states:

0 — Touch Contact (the default; equivalent to a left click)
2 — Barrel Button (equivalent to a right click)
5 — Eraser Button (currently unsupported by drivers)

Using a Pen

Selenium v4.2

ファイルのアップロード

Mon, 01 Jan 0001 00:00:00 +0000

Selenium はファイル選択ダイアログを操作できないため、ダイアログを開かずにファイルをアップロードする方法を提供しています。要素が type 属性に file を指定した input 要素であれば、 sendKeys メソッドを使用して、アップロードするファイルの完全なパスを送信できます。

 WebElement fileInput = driver.findElement(By.cssSelector("input[type=file]"));
 fileInput.sendKeys(uploadFile.getAbsolutePath());
 driver.findElement(By.id("file-submit")).click();

View Complete Code View on GitHub

 file_input = driver.find_element(By.CSS_SELECTOR, "input[type='file']")
 file_input.send_keys(upload_file)
 driver.find_element(By.ID, "file-submit").click()

View Complete Code View on GitHub

 IWebElement fileInput = driver.FindElement(By.CssSelector("input[type=file]"));
 fileInput.SendKeys(uploadFile);
 driver.FindElement(By.Id("file-submit")).Click();

View Complete Code View on GitHub

 file_input = driver.find_element(css: 'input[type=file]')
 file_input.send_keys(upload_file)
 driver.find_element(id: 'file-submit').click

View Complete Code View on GitHub

 await driver.get('https://the-internet.herokuapp.com/upload');
 // Upload snapshot

View Complete Code View on GitHub

Move Code

Firefox特有の機能

Mon, 01 Jan 0001 00:00:00 +0000

Selenium 4 には Firefox 78 以降が必要です。常に最新バージョンの geckodriver を使用することをお勧めします。

オプション

全ブラウザに共通のCapabilityについては、オプションページで説明しています。

Firefox に固有のCapabilityは、Mozilla のページの firefoxOptions にあります。

基本的な定義済みのオプションを使用して Firefox セッションを開始すると、以下のようになります。

 driver = new FirefoxDriver(options);
 }

View Complete Code View on GitHub

 options = webdriver.FirefoxOptions()
 driver = webdriver.Firefox(options=options)

View Complete Code View on GitHub

 public void BasicOptions()
 {

View Complete Code View on GitHub

 options = Selenium::WebDriver::Options.firefox
 @driver = Selenium::WebDriver.for :firefox, options: options

View Complete Code View on GitHub

 driver = new Builder()
 .forBrowser(Browser.FIREFOX)
 .setFirefoxOptions(options)
 .build();

View Complete Code View on GitHub

Add Example

Chrome DevTools Script Features

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Japanese. Do you speak Japanese? Help us to translate it by sending us pull requests!

While Selenium 4 provides direct access to the Chrome DevTools Protocol, these methods will eventually be removed when WebDriver BiDi implemented.

Script Pinning

 ScriptKey key = ((JavascriptExecutor) driver).pin("return arguments;");
 List<Object> arguments =
 (List<Object>) ((JavascriptExecutor) driver).executeScript(key, 1, true, element);

View Complete Code View on GitHub

Implementation Missing

Scroll wheel actions

Mon, 01 Jan 0001 00:00:00 +0000

Selenium v4.2

Chromium Only

There are 5 scenarios for scrolling on a page.

Scroll to element

This is the most common scenario. Unlike traditional click and send keys methods, the actions class does not automatically scroll the target element into view, so this method will need to be used if elements are not already inside the viewport.

Seleniumドキュメントのスタイルガイド

Mon, 01 Jan 0001 00:00:00 +0000

このドキュメントにコンテンツを追加する方法の詳細な手順については、コントリビューションのドキュメントを参照してください。

アラート

アラートは、特定のコンテンツが不足している場所をコントリビュータ候補に示すために追加されています。

{{< alert-content />}}

または

{{< alert-content >}}
必要な具体的なコンテンツに関する追加情報
{{< /alert-content >}}

これは次のように表示されます:

Content Help

Note: This section needs additional and/or updated content

必要な具体的なコンテンツに関する追加情報

Check our contribution guidelines if you’d like to help.

タイトルの大文字小文字

このドキュメントでは、短くするべき linkTitle にはタイトルケースを使用し、より長く説明的にできる title には文頭のみ大文字にする形式を使用します。例えば、linkTitle が Special Heading の場合、title は The importance of a special heading in documentation のようになります。

行の長さ

プレーンHTMLで書かれているドキュメントのソースを編集するときは、 1行の長さをおおよそ100文字に制限してください。

私たちの一部はこれをさらに進めて、 semantic linefeeds と呼ばれる手法を使っています。これは、一般には読まれないHTMLソースの行を、文章中の「自然な区切り」で分割する手法です。言い換えると、文を節と節の自然な区切りで分割します。各段落の行がすべて右端付近で終わるように調整する代わりに、考えの区切りがある場所であればどこにでも改行を入れられます。

IFrame と Frame の操作

Mon, 01 Jan 0001 00:00:00 +0000

Frameは、同じドメイン上の複数のドキュメントからサイトレイアウトを構築する非推奨の手段となりました。 HTML5以前のWebアプリを使用している場合を除き、frameを使用することはほとんどありません。 iFrameは、まったく異なるドメインからのドキュメントの挿入を許可し、今でも一般的に使用されています。

FrameまたはiFrameを使用する必要がある場合、Webdriverを使用して同じ方法で作業できます。 iFrame内のボタンがある場合を考えてみましょう。ブラウザー開発ツールを使用して要素を検査すると、次のように表示される場合があります。

<div id="modal">
 <iframe id="buttonframe" name="myframe" src="https://seleniumhq.github.io">
 <button>Click here</button>
 </iframe>
</div>

iFrameがなければ、次のようなボタンを使用してボタンをクリックします。

//This won't work
driver.findElement(By.tagName("button")).click();

 # This Wont work
driver.find_element(By.TAG_NAME, 'button').click()

//This won't work
driver.FindElement(By.TagName("button")).Click();

 # This won't work
driver.find_element(:tag_name,'button').click

// This won't work
await driver.findElement(By.css('button')).click();

//This won't work
driver.findElement(By.tagName("button")).click()

ただし、iFrameの外側にボタンがない場合は、代わりにno such elementエラーが発生する可能性があります。これは、Seleniumがトップレベルのドキュメントの要素のみを認識するために発生します。ボタンを操作するには、ウィンドウを切り替える方法と同様に、最初にFrameに切り替える必要があります。 WebDriverは、Frameに切り替える3つの方法を提供します。

IE特有の機能

Mon, 01 Jan 0001 00:00:00 +0000

As of June 2022, Selenium officially no longer supports standalone Internet Explorer. The Internet Explorer driver still supports running Microsoft Edge in “IE Compatibility Mode.”

Special considerations

The IE Driver is the only driver maintained by the Selenium Project directly. While binaries for both the 32-bit and 64-bit versions of Internet Explorer are available, there are some known limitations with the 64-bit driver. As such it is recommended to use the 32-bit driver.

ロケータをうまく扱うTips

Mon, 01 Jan 0001 00:00:00 +0000

サポートしているロケータについては要素を探すを参照してください。

一般に、HTMLのid属性が利用可能でユニークかつ一貫している場合、ページで要素を探す方法として適しています。 idは動作がとても速い傾向があり、複雑なDOMトラバースに伴う処理を省略できます。

ユニークなidが使えない場合、きれいに書かれたCSSセレクタが要素を探す方法として適しています。 XPathはCSSセレクタと同様に動作しますが、シンタックスは複雑で大抵の場合デバッグが困難です。 XPathはとても柔軟ですが、ブラウザベンダは性能テストを通常行っておらず、非常に動作が遅い傾向があります。

link textセレクタとpartial linkText セレクタはa要素でしか動作しないという欠点があります。加えて、これらはWebDriverの内部でquerySelectorAllの呼び出しに置き換えられます。

タグ名によるロケータは危険な方法になり得ます。大抵の場合ページ上には同じタグ名の要素が複数あります。タグ名は要素のコレクションを返す findElements(By) メソッドを使う時にもっとも役に立ちます。

ロケータは可能な限り簡潔に、読みやすい状態を保つことを推奨します。 WebDriverでDOM構造のトラバースを行うのは重い処理となります。検索の範囲を狭めた方がより良い結果を得られます。

ウィンドウとタブの操作

Mon, 01 Jan 0001 00:00:00 +0000

ウィンドウとタブ

ウィンドウハンドルの取得

WebDriverは、ウィンドウとタブを区別しません。サイトが新しいタブまたはウィンドウを開く場合、Seleniumはウィンドウハンドルを使って連動します。各ウィンドウには一意の識別子があり、これは単一のセッションで持続します。次のコードを使用して、現在のウィンドウのウィンドウハンドルを取得できます。

 // Navigate to Url
 driver.get("https://www.selenium.dev/selenium/web/window_switching_tests/page_with_frame.html");
 //fetch handle of this
 String currHandle=driver.getWindowHandle();
 assertNotNull(currHandle);

View Complete Code View on GitHub

 driver.get(url)
 current_handle = driver.current_window_handle
 assert current_handle is not None

View Complete Code View on GitHub

 // Navigate to Url
  driver.Url="https://www.selenium.dev/selenium/web/window_switching_tests/page_with_frame.html";
  //fetch handle of this
  String currHandle = driver.CurrentWindowHandle;
  Assert.IsNotNull(currHandle);

View Complete Code View on GitHub

driver.window_handle

await driver.getWindowHandle();

driver.windowHandle

ウィンドウまたはタブの切り替え

新しいウィンドウで開くリンクをクリックすると、新しいウィンドウまたはタブが画面にフォーカスされますが、WebDriverはオペレーティングシステムがアクティブと見なすウィンドウを認識しません。新しいウィンドウで作業するには、それに切り替える必要があります。開いているタブまたはウィンドウが2つしかなく、どちらのウィンドウから開始するかがわかっている場合、削除のプロセスによって、WebDriverが表示できる両方のウィンドウまたはタブをループし、元のウィンドウまたはタブに切り替えることができます。

最初のSeleniumスクリプトを書く

Mon, 01 Jan 0001 00:00:00 +0000

Seleniumをインストールし、すると、Seleniumコードを書く準備が整います。

8つの基本コンポーネント

Seleniumが行うことはすべて、ブラウザコマンドを送信して、何かを実行したり、情報の要求を送信したりすることです。 Seleniumで行うことのほとんどは、次の基本的なコマンドの組み合わせです。

[GitHub で完全な例を表示] へのリンクをクリックして、コンテキスト内のコードを表示します。

1. ドライバーインスタンスでセッションを開始します

セッションの開始の詳細については、次のドキュメントをお読みください driver sessions

 WebDriver driver = new ChromeDriver();

View Complete Code View on GitHub

driver = webdriver.Chrome()

View Complete Code View on GitHub

 IWebDriver driver = new ChromeDriver();

View Complete Code View on GitHub

driver = Selenium::WebDriver.for :chrome

View Complete Code View on GitHub

 driver = await new Builder().forBrowser(Browser.CHROME).build();

View Complete Code View on GitHub

 driver = ChromeDriver()

View Complete Code View on GitHub

2. Take action on browser

こちらの例では、ナビゲートしてウェブページに移動しています。

Selenium IDE

Mon, 01 Jan 0001 00:00:00 +0000

Seleniumの統合開発環境（Selenium IDE）は、各要素のコンテキストによって定義されたパラメーターを使用して、既存のSeleniumコマンドを使用してブラウザーでのユーザーのアクションを記録する、使いやすいブラウザー拡張機能です。これは、Seleniumの構文を学習するための優れた方法を提供します。 Google Chrome、Mozilla Firefox、およびMicrosoftEdgeで利用できます。

詳細については、充実しているSelenium IDE ドキュメントをご覧ください。

Safari特有の機能

Mon, 01 Jan 0001 00:00:00 +0000

Chromium および Firefox のドライバーとは異なり、safaridriver はオペレーティングシステムとともにインストールされています。 Safari で自動化を有効にするには、ターミナルで次のコマンドを実行します。

safaridriver --enable

オプション

すべてのブラウザに共通する機能は、オプションページで説明しています。

Safari 固有の機能については、Apple の About WebDriver for Safari のページを参照してください。

基本的な定義済みオプションで Safari セッションを開始する場合は、次のようになります。

 SafariOptions options = new SafariOptions();
 driver = new SafariDriver(options);

View Complete Code View on GitHub

 options = webdriver.SafariOptions()
 driver = webdriver.Safari(options=options)

View Complete Code View on GitHub

 var options = new SafariOptions();
 driver = new SafariDriver(options);

View Complete Code View on GitHub

 it 'basic options' do
 options = Selenium::WebDriver::Options.safari

View Complete Code View on GitHub

 let driver = new Builder()
 .forBrowser(Browser.SAFARI)
 .setSafariOptions(options)
 .build();

View Complete Code View on GitHub

val options = SafariOptions()
val driver = SafariDriver(options)

モバイル

iOS 上の Safari を自動化する場合は、Appium プロジェクトを参照してください。

Selenium4にアップグレードする方法

Mon, 01 Jan 0001 00:00:00 +0000

公式にサポートされている言語（Ruby、JavaScript、C＃、Python、およびJava）のいずれかを使用している場合、 Selenium4へのアップグレードは簡単なプロセスです。いくつかの問題が発生する可能性がある場合があるかもしれません。このガイドは、それらを整理するのに役立ちます。プロジェクトの依存関係をアップグレードする手順を実行し、バージョンのアップグレードによってもたらされる主な非推奨と変更を理解します。

これが、Selenium4にアップグレードするために実行する手順です。

テストコードの準備
依存関係のアップグレード
潜在的なエラーと非推奨メッセージ

注：Selenium 3.xバージョンの開発中に、W3CWebDriver標準のサポートが実装されました。この新しいプロトコルと従来のJSONワイヤープロトコルの両方がサポートされました。バージョン3.11の前後で、SeleniumコードはレベルW3C1仕様に準拠するようになりました。 Selenium 3の最新バージョンのW3C準拠のコードは、Selenium4で期待どおりに機能します。

テストコードの準備

Selenium 4は、レガシープロトコルのサポートを削除し、内部でデフォルトでW3CWebDriver標準を使用します。ほとんどの場合、この実装はエンドユーザーに影響を与えません。主な例外は、Capabilitiesと アクション クラスです。

Capabilities

テスト機能がW3Cに準拠するように構成されていない場合、セッションが開始されない可能性があります。 W3CWebDriverの標準機能のリストは次のとおりです。

browserName
browserVersion (version に変更)
platformName (platform に変更)
acceptInsecureCerts
pageLoadStrategy
proxy
timeouts
unhandledPromptBehavior

標準Capabilitiesの最新リストは、 W3C WebDriver にあります。

上記のリストに含まれていないCapabilitiesには、ベンダープレフィックスを含める必要があります。これは、ブラウザ固有のCapabilitiesとクラウドベンダー固有のCapabilitiesに適用されます。たとえば、クラウドベンダーがテストに build Capabilities と name Capabilitiesを使用している場合は、それらを cloud:options ブロックでラップする必要があります（適切なプレフィックスについては、クラウドベンダーに確認してください）。

Before

Move Code

Seleniumコードの整理と実行

Mon, 01 Jan 0001 00:00:00 +0000

一握り以上の 1 回限りのスクリプトを実行する場合は、コードを整理して操作できる必要があります。このページでは、Seleniumコードを使用して実際に生産的なことを行う方法についてのアイデアを提供します。

一般的な用途

ほとんどの人はSeleniumを使用してWebアプリケーションの自動テストを実行します。しかし、Seleniumはブラウザ自動化のあらゆるユースケースをサポートします。

反復タスク

おそらく、Webサイトにログインして何かをダウンロードするか、フォームを送信する必要があります。 Selenium スクリプトを作成して、あらかじめ設定された時間にサービスと共に実行できます。

Webスクレイピング

API がないサイトからデータを収集したいとお考えですか？ Selenium では可能ですが、Web サイトの利用規約をよく理解しておいてください。許可していないサイトもあり、Selenium をブロックするサイトさえあります。

テスティング

テストでSeleniumを実行するには、Seleniumが実行した操作に対してアサーションを行う必要があります。そのため、優れたアサーションライブラリが必要です。テストに構造を与える追加機能には、テストランナーを使用する必要があります。

IDEs

Seleniumコードの使用方法に関係なく、優れた統合開発環境がなければ、Seleniumコードの作成や実行はあまり効果的ではありません。一般的なオプションを次に示します…

Test Runner

テストにSeleniumを使用していない場合でも、高度なユースケースでは、テストランナーを使うとコードをより適切に整理できる場合があります。before/afterフックを使用し、処理をグループ単位または並列で実行できることは、非常に便利です。

テストランナーの選び方

さまざまなテストランナーが利用可能です。

このドキュメントのすべてのコード例は、テストランナーを使用するサンプルディレクトリに格納されているか、格納先を移行中です。すべてのコードが正しく更新されていることを確認するため、リリースのたびに実行されます。以下にテストランナーをリンクとともに示します。各リストの最初の項目は、このリポジトリとこのページのすべての例で使用されているものです。

JUnit - JavaベースのSeleniumテストで広く使用されているテストフレームワーク。
TestNG - 並列テスト実行やパラメーター化されたテストなどの追加機能を提供します。

pytest - そのシンプルさと強力なプラグインのおかげで、多くの人に好まれる選択肢です。
unittest - Python の標準ライブラリテストフレームワーク。

NUnit - .NET の一般的な単体テストフレームワーク。
MS Test - Microsoft 独自の単体テストフレームワーク。

RSpec - RubyでSeleniumテストを実行するために最も広く使用されているテストライブラリ。
Minitest - Ruby標準ライブラリに付属する軽量なテストフレームワークです。

Jest - 主にReactのテストフレームワークとして知られていますが、Seleniumのテストにも使用できます。
Mocha - Seleniumテストを実行するための最も一般的なJSライブラリ。

Kotest - Kotlin専用に設計された、柔軟で包括的なテストフレームワークです。
JUnit5 - 標準的なJavaテストフレームワークであり、Kotlinと完全に互換性があります。

インストール

これはSeleniumライブラリのインストールで必要な手順と非常によく似ています。このコードは、ドキュメント用のサンプルプロジェクトで使用しているものの例を示すだけです。

Grid アーキテクチャ

Mon, 01 Jan 0001 00:00:00 +0000

Grid は、Grid を運用するためのコンポーネントの集合体として設計されています。非常に複雑に見えるかもしれませんが、このドキュメントが混乱を解消する手助けとなることを期待します。

キーとなるコンポーネント

主要な Grid のコンポーネント:

イベントバス: 他のコンポーネント間で非同期で受信される可能性のあるメッセージを送信します。
新規セッションキュー: まだディストリビューターによってノードに割り当てられていない受信セッションの一覧を管理します。
ディストリビューター: Grid内でWebDriverセッションを実行する場所（"スロット"と呼ぶ）を管理し、新しいセッションリクエストを受け取りスロットに割り当てる役割を担います。
ノード: WebDriverセッションを実行します。各セッションはスロットに割り当てられ、各ノードは1つ以上のスロットを持っています。
セッションマップ: セッションID とセッションが実行されているノードのアドレスのマップを管理します。
ルーター: Gridのフロントエンドとして動作します。 Gridの中で唯一ウェブに公開してもよい部分です（ただし、公開しないことを強く推奨します）。受け取ったリクエストを新規セッションキューかセッションが実行されているノードどちらかに振り分けます。

グリッドについて説明する際に、覚えておくと便利な概念がいくつかあります:

スロット はセッションが実行されるところです。
各スロットは ステレオタイプ を持っています。これはディストリビューターがスロットを所有するノードに新規セッションリクエストを送信する前に、リクエストがマッチしなければならない最小限の capabilities のセットです。
Grid モデル はディストリビューターが Grid の状態を追跡する方法です。その名が示すように、これは時々実際と一致しないことがあります（ディストリビューターが開始したばかりだからかもしれません）。ディストリビューターが新規セッションのリクエストを素早くスロットに割り当てることができるように、各ノードに問い合わせるより優先して利用されます。

同期呼び出しと非同期呼び出し

Grid 内では主に 2 つの通信メカニズムが使われています。

同期で “REST 風” な、JSON を用いた HTTP リクエスト
イベントバスによって送信される非同期なイベント

どちらの仕組みを使うべきかどのように決めればよいでしょうか？結局のところ、Grid 全体をイベントベースにモデリングしたとしても、うまくいくでしょう。

答えは、もし実行されるアクションが同期である場合(例えばほとんどの WebDriver の呼び出しなど)、あるいはレスポンスを受け取れなかったときに問題になるような場合、 Grid は同期呼び出しを利用します。かわりにもし、関心のあるコンポーネントに情報をブロードキャストしたい場合、あるいはレスポンスを受け取れなくても問題にならない場合はイベントバスを使用することが望ましいです。

BiDirectional API (W3C compliant)

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Japanese. Do you speak Japanese? Help us to translate it by sending us pull requests!

This section contains the APIs related to logging.

Console logs

Listen to the console.log events and register callbacks to process the event.

Selenium v4.8

Virtual Authenticator

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Japanese. Do you speak Japanese? Help us to translate it by sending us pull requests!

Web applications can enable a public key-based authentication mechanism known as Web Authentication to authenticate users in a passwordless manner. Web Authentication defines APIs that allows a user to create a public-key credential and register it with an authenticator. An authenticator can be a hardware device or a software entity that stores user’s public-key credentials and retrieves them on request.

Selenium

Browsing Context

Commands

Open a new window

Browsing Context

Perform Actions

Waiting with Expected Conditions

WebDriver BiDi Network Features

Authentication Handlers

Network

Commands

Add network intercept

Script

Commands

Call function in a browsing context

デザインパターンと開発戦略

概要

ロード可能なコンポーネント

それは何ですか？

簡単な使用方法

ブラウザー ナビゲーション

ナビゲート

/examples/java/src/test/java/dev/selenium/interactions/NavigationTest.java

/examples/python/tests/interactions/test_navigation.py

/examples/dotnet/SeleniumDocs/Interactions/NavigationTest.cs

/examples/ruby/spec/interactions/navigation_spec.rb

/examples/javascript/test/interactions/navigation.spec.js

戻る

/examples/java/src/test/java/dev/selenium/interactions/NavigationTest.java

/examples/python/tests/interactions/test_navigation.py

/examples/dotnet/SeleniumDocs/Interactions/NavigationTest.cs

/examples/ruby/spec/interactions/navigation_spec.rb

/examples/javascript/test/interactions/navigation.spec.js

要素を探す

要素選択の方法

Creating Locators

Selenium GridのCLI オプション

セクション

Distributor

Docker

Events

Logging

Network

Node

Relay

Router

Server

SessionQueue

Sessions

設定例

Interacting with web elements

Additional validations

Internet Explorer Driver Internals

Client Code Into the Driver

Memory Management

Chrome DevTools Logging Features

Console Logs

/examples/java/src/test/java/dev/selenium/bidi/cdp/LoggingTest.java

/examples/python/tests/bidi/cdp/test_logs.py

/examples/dotnet/SeleniumDocs/BiDi/CDP/LoggingTest.cs

/examples/ruby/spec/bidi/cdp/logging_spec.rb

コマンドリスナー

HTTPクライアントの設定

Selenium Manager (Beta)

Motivation

Toml オプション

概要

スタンドアロン

特定のブラウザとセッションの上限

ドライバーのカスタマイズと設定

Docker を利用したスタンドアロン、またはノード

ドライバーサービスクラス

デフォルトサービスインスタンス

/examples/java/src/test/java/dev/selenium/drivers/ServiceTest.java

Chrome固有の機能

Options

/examples/java/src/test/java/dev/selenium/browsers/ChromeTest.java

/examples/python/tests/browsers/test_chrome.py

/examples/dotnet/SeleniumDocs/Browsers/ChromeTest.cs

/examples/ruby/spec/browsers/chrome_spec.rb

ブラウザーナビゲーション