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

CAPTCHA（キャプチャ）

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

CAPTCHA（キャプチャ）は、 Completely Automated Public Turing test to tell Computers and Humans Apart （コンピューターと人間を区別するための完全に自動化された公開チューリングテスト）の略で、自動化を防ぐように明示的に設計されているため、試さないでください！ CAPTCHAチェックを回避するための2つの主要な戦略があります。

テスト環境でCAPTCHAを無効にします
テストがCAPTCHAをバイパスできるようにするフックを追加します

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 Logging Features

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

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

Console Message Handlers

Record or take actions on console.log events.

Add Handler

Implementation Missing

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

WebDriver BiDi Script Features

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

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

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

Script Pinning

Execute Script

DOM Mutation Handlers

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

WebDriverを使ってテストスイートを構築するには、多くの異なるコンポーネントを理解し、効率的に使用する必要があります。ソフトウェアのすべてがそうであるように、人によっては同じ概念に異なる用語を使用します。以下は、本説明での用語の使用方法の内訳です。

用語

API: アプリケーションプログラミングインターフェイス。これはWebDriverを操作するために使用する"コマンド"をまとめたものです。
ライブラリ: APIとそれらを実装する必要なコードを含むコードモジュール。ライブラリは各言語バインディング向けのものです。例 .jar files for Java, .dll files for .NET, など.
ドライバー: 実際のブラウザを制御します。ほとんどのドライバーはブラウザベンダー自身が作成します。ドライバーは一般的にブラウザ自体を備えたシステムで実行される実行可能モジュールであり、テストスイートを実行するシステムにはありません。（ただし、それらは同じシステムであっても構いません。）注: 一部の人々はドライバーをプロキシと呼んでいます。
フレームワーク: WebDriverスイートのサポートとして使用する追加ライブラリ。これらのフレームワークは、JUnitやNUnitなどのテストフレームワークです。また、CucumberまたはRobot Frameworkといった自然言語機能をサポートするフレームワークでもあります。フレームワークは、テスト対象のシステムの操作や構成、データ作成、テストオラクルなどに記述、利用されます。

部品構成

最低限、WebDriverはドライバーを経由してブラウザーと通信します。コミュニケーションは双方向です：WebDriverは、ドライバーを経由してブラウザーにコマンドを渡し、同じルートを経由して情報を受け取ります。

ドライバーは、ChromeDriver for GoogleのChrome/Chromium、MozillaのFirefox用GeckoDriverなどブラウザー固有のものです。ドライバーはブラウザと同じシステムで動きます。これは、テスト自体を実行するところが同じシステムである場合とそうでない場合があります。

上記の簡単な例は直接通信です。ブラウザへのコミュニケーションは、Selenium ServerまたはRemoteWebDriverを経由した リモート 通信もできます。RemoteWebDriverは、ドライバーおよびブラウザと同じシステムで実行されます。

リモート通信は、ホストシステム上のドライバーと順に通信するSelenium ServerまたはSelenium Gridを使用して行うこともできます。

どのフレームワークに適しているか

WebDriverには1つのジョブしかありません:　上記の任意のメソッドを経由してブラウザと通信します。WebDriverはテストに関することを知りません:　WebDriverは物事を比較する方法、成功または失敗を確認する方法を知りません、そして、レポートや Given/When/Then 文法に関しても確実に知りません。

ここで、さまざまなフレームワークが登場します。最低限必要なのは言語バインディングに一致するテストフレームワーク、例えば NUnit for .NET, JUnitfor Java, RSpec for Ruby などです。

テストフレームワークは、WebDriverおよびテストの関連手順の実行を担当します。それは下記図に似ていると考えることができます。

上図でCucumberなどの自然言語のフレームワーク/ツールがテストフレームワークボックスの一部として存在する場合があります、またはテストフレームワークを独自の実装で完全に密閉する場合があります。

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

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のページをご覧ください。テスト作成者の観点から、これは新しい問題を提出できるサービスを提供します。基本的なページオブジェクトは次のようになります。

package com.example.webdriver;

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;

public class EditIssue {

 private final WebDriver driver;

 public EditIssue(WebDriver driver) {
 this.driver = driver;
 }

 public void setTitle(String title) {
 WebElement field = driver.findElement(By.id("issue_title")));
 clearAndType(field, title);
 }

 public void setBody(String body) {
 WebElement field = driver.findElement(By.id("issue_body"));
 clearAndType(field, body);
 }

 public void setHowToReproduce(String howToReproduce) {
 WebElement field = driver.findElement(By.id("issue_form_repro-command"));
 clearAndType(field, howToReproduce);
 }

 public void setLogOutput(String logOutput) {
 WebElement field = driver.findElement(By.id("issue_form_logs"));
 clearAndType(field, logOutput);
 }

 public void setOperatingSystem(String operatingSystem) {
 WebElement field = driver.findElement(By.id("issue_form_operating-system"));
 clearAndType(field, operatingSystem);
 }

 public void setSeleniumVersion(String seleniumVersion) {
 WebElement field = driver.findElement(By.id("issue_form_selenium-version"));
 clearAndType(field, logOutput);
 }

 public void setBrowserVersion(String browserVersion) {
 WebElement field = driver.findElement(By.id("issue_form_browser-versions"));
 clearAndType(field, browserVersion);
 }

 public void setDriverVersion(String driverVersion) {
 WebElement field = driver.findElement(By.id("issue_form_browser-driver-versions"));
 clearAndType(field, driverVersion);
 }

 public void setUsingGrid(String usingGrid) {
 WebElement field = driver.findElement(By.id("issue_form_selenium-grid-version"));
 clearAndType(field, usingGrid);
 }

 public IssueList submit() {
 driver.findElement(By.cssSelector("button[type='submit']")).click();
 return new IssueList(driver);
 }

 private void clearAndType(WebElement field, String text) {
 field.clear();
 field.sendKeys(text);
 }
}

これをLoadableComponentに変換するには、これを基本型として設定するだけです。

テスト自動化について

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

まず、本当にブラウザを使用する必要があるかどうかを自問することから始めます。ある時点で複雑なWebアプリケーションで作業している場合、おそらくブラウザを開いて実際にテストする必要があるでしょう。

ただし、Seleniumテストなどの機能的なエンドユーザーテストの実行には費用がかかります。さらに、それらは通常、効果的に実行するために適切なインフラストラクチャを配置する必要があります。単体テストなどのより軽量なテストアプローチを使用して、または下位レベルのアプローチを使用して、テストすることを実行できるかどうかを常に自問するのは良いルールです。

Webブラウザーのテストビジネスに参加していることを確認し、Selenium環境でテストの記述を開始できるようになったら、通常は3つのステップを組み合わせて実行します。

データを設定する
個別の一連のアクションを実行する
結果を評価する

これらの手順はできるだけ短くしてください。ほとんどの場合、1つまたは2つの操作で十分です。ブラウザの自動化は"不安定"であるという評判がありますが、実際には、ユーザーが頻繁に多くを求めることが多いためです。後の章では、特にブラウザーとWebDriver間の競合状態を克服する方法に関する、テストでの断続的な問題を軽減するために使用できる手法に戻ります。

テストを短くして、代替手段がまったくない場合にのみWebブラウザーを使用することで、不安定さを最小限にして多くのテストを実行できます。

Seleniumテストの明確な利点は、ユーザーの観点から、バックエンドからフロントエンドまで、アプリケーションのすべてのコンポーネントをテストする固有の機能です。つまり、機能テストは実行に費用がかかる可能性がありますが、同時にビジネスに不可欠な大規模な部分も含まれます。

テスト要件

前述のように、Seleniumテストの実行には費用がかかる場合があります。どの程度までテストを実行しているブラウザーに依存しますが、歴史的にブラウザーの動作は非常に多様であるため、多くの場合、複数のブラウザーに対するクロステストの目標として述べられてきました。

Seleniumを使用すると、複数のオペレーティングシステム上の複数のブラウザーに対して同じ命令を実行できますが、すべての可能なブラウザー、それらの異なるバージョン、およびそれらが実行される多くのオペレーティングシステムの列挙はすぐに重要な作業になります。

例から始めましょう

ラリーは、ユーザーがカスタムユニコーンを注文できるWebサイトを作成しました。

一般的なワークフロー（“ハッピーパス"と呼ぶ）は次のようなものです。

アカウントを作成する
ユニコーンを設定する
ショッピングカートにユニコーンを追加します
チェックアウトしてお支払い
ユニコーンについてフィードバックを送る

これらのすべての操作を実行するために1つの壮大なSeleniumスクリプトを作成するのは魅力的です。 その誘惑に抵抗しましょう！ そうすると、
a）時間がかかる
b）ページレンダリングのタイミングの問題に関する一般的な問題が発生する
c）失敗した場合、簡潔で"一目瞭然"にならない、何がうまくいかなかったかを診断する方法がない
というテストになります。

このシナリオをテストするための好ましい戦略は、一連の独立した迅速なテストに分割することです。各テストには、1つの"理由"が存在します。

2番目のステップであるユニコーンの構成をテストしたいと思います。次のアクションを実行します。

アカウントを作成する
ユニコーンを設定する

これらの手順の残りをスキップしていることに注意してください。この手順を完了した後、他の小さな個別のテストケースで残りのワークフローをテストします。

開始するには、アカウントを作成する必要があります。ここには、いくつかの選択があります。

既存のアカウントを使用しますか？
新しいアカウントを作成しますか？
設定を開始する前に考慮する必要があるそのようなユーザーの特別なプロパティはありますか？

この質問への回答方法に関係なく、テストの"データのセットアップ"部分の一部にすると解決します。ラリーが、ユーザー（またはだれでも）がユーザーアカウントを作成および更新できるAPIを公開している場合は、それを使用してこの質問に回答してください。可能であれば、資格情報を使用してログインできるユーザーが"手元に"いる場合にのみブラウザを起動します。

各ワークフローの各テストがユーザーアカウントの作成から始まる場合、各テストの実行に何秒も追加されます。 APIの呼び出しとデータベースとの対話は、ブラウザを開いたり、適切なページに移動したり、フォームをクリックして送信されるのを待つなどの高価なプロセスを必要としない、迅速な"ヘッドレス"操作です。

理想的には、1行のコードでこのセットアップフェーズに対処できます。これは、ブラウザーが起動する前に実行されます。

// Create a user who has read-only permissions--they can configure a unicorn,
// but they do not have payment information set up, nor do they have
// administrative privileges. At the time the user is created, its email
// address and password are randomly generated--you don't even need to
// know them.
User user = UserFactory.createCommonUser(); //This method is defined elsewhere.

// Log in as this user.
// Logging in on this site takes you to your personal "My Account" page, so the
// AccountPage object is returned by the loginAs method, allowing you to then
// perform actions from the AccountPage.
AccountPage accountPage = loginAs(user.getEmail(), user.getPassword());

# Create a user who has read-only permissions--they can configure a unicorn,
# but they do not have payment information set up, nor do they have
# administrative privileges. At the time the user is created, its email
# address and password are randomly generated--you don't even need to
# know them.
user = user_factory.create_common_user() #This method is defined elsewhere.

# Log in as this user.
# Logging in on this site takes you to your personal "My Account" page, so the
# AccountPage object is returned by the loginAs method, allowing you to then
# perform actions from the AccountPage.
account_page = login_as(user.get_email(), user.get_password())

// Create a user who has read-only permissions--they can configure a unicorn,
// but they do not have payment information set up, nor do they have
// administrative privileges. At the time the user is created, its email
// address and password are randomly generated--you don't even need to
// know them.
User user = UserFactory.CreateCommonUser(); //This method is defined elsewhere.

// Log in as this user.
// Logging in on this site takes you to your personal "My Account" page, so the
// AccountPage object is returned by the loginAs method, allowing you to then
// perform actions from the AccountPage.
AccountPage accountPage = LoginAs(user.Email, user.Password);

# Create a user who has read-only permissions--they can configure a unicorn,
# but they do not have payment information set up, nor do they have
# administrative privileges. At the time the user is created, its email
# address and password are randomly generated--you don't even need to
# know them.
user = UserFactory.create_common_user #This method is defined elsewhere.

# Log in as this user.
# Logging in on this site takes you to your personal "My Account" page, so the
# AccountPage object is returned by the loginAs method, allowing you to then
# perform actions from the AccountPage.
account_page = login_as(user.email, user.password)

// Create a user who has read-only permissions--they can configure a unicorn,
// but they do not have payment information set up, nor do they have
// administrative privileges. At the time the user is created, its email
// address and password are randomly generated--you don't even need to
// know them.
var user = userFactory.createCommonUser(); //This method is defined elsewhere.

// Log in as this user.
// Logging in on this site takes you to your personal "My Account" page, so the
// AccountPage object is returned by the loginAs method, allowing you to then
// perform actions from the AccountPage.
var accountPage = loginAs(user.email, user.password);

// Create a user who has read-only permissions--they can configure a unicorn,
// but they do not have payment information set up, nor do they have
// administrative privileges. At the time the user is created, its email
// address and password are randomly generated--you don't even need to
// know them.
val user = UserFactory.createCommonUser() //This method is defined elsewhere.

// Log in as this user.
// Logging in on this site takes you to your personal "My Account" page, so the
// AccountPage object is returned by the loginAs method, allowing you to then
// perform actions from the AccountPage.
val accountPage = loginAs(user.getEmail(), user.getPassword())

ご想像のとおり、 UserFactory を拡張して createAdminUser() や createUserWithPayment() などのメソッドを提供できます。重要なのは、これらの2行のコードは、このテストの最終目的であるユニコーンの構成からあなたをそらすものではないということです。

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

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

Selenium Grid

Grid は、さまざまなブラウザとオペレーティングシステムの組み合わせでテストを実行することにより、テストのスケーリングと分散を支援します。

可観測性

可観測性(Observability) には、トレース、メトリクス、ログの 3 つの柱があります。 Selenium Grid 4 は完全分散型に設計されているため、可観測性を確保することで内部を理解し、デバッグすることが容易になります。

分散トレーシング

1 つのリクエストやトランザクションは、複数のサービスやコンポーネントにまたがります。トレースは、各サービスがリクエストを実行する際に、リクエストのライフサイクルをトラックします。これは、エラーシナリオのデバッグに有用です。トレースで使用される用語は次のとおりです:

トレース トレースでは、複数のサービスを通じてリクエストの出発点から最終地点までを追跡することができます。このリクエストの旅は、デバッグ、エンドツーエンドフローの監視、障害の特定に役立ちます。トレースは、エンドツーエンドのリクエストフローを描きます。各トレースは識別子としてユニークな ID を持っています。

スパン

各トレースは、スパンと呼ばれる時間で区切られたオペレーションで構成されています。スパンには開始時刻と終了時刻があり、サービスによって実行される操作を表します。スパンの粒度は実装方法に依存します。各スパンは一意の識別子を持ちます。トレース内のすべてのスパンは、同じトレース ID を持ちます。

スパン属性 スパン属性は各スパンの付加的な情報を提供するキーと値のペアです。

イベント イベントは、スパン内のタイムスタンプ付きログです。既存のスパンに追加のコンテキストを提供します。イベントには、イベント属性としてキーと値のペアも含まれます。

イベントロギング

アプリケーションのデバッグには、ロギングが欠かせません。ログの記録は多くの場合、人間が読める形式で行われます。しかし、機械がログを検索・分析するためには、明確に定義されたフォーマットである必要があります。構造化ロギングは、固定フォーマットで一貫してログを記録する一般的な方法です。一般的には次のようなフィールドが含まれます。

タイムスタンプ
ログレベル
ロガークラス
ログメッセージ (これはさらに、ログが記録された操作に関するフィールドに分解されます)

ログとイベントは密接に関連しています。イベントは、1 つの処理を行うための情報を全てカプセル化します。ログは基本的にイベントのサブセットです。重要なのは、どちらもデバッグを支援することです。詳細については、以下のリソースを参照してください。

Grid の可観測性

Selenium サーバーは OpenTelemetry を使ってトレースできるようになっています。サーバへのすべてのリクエストは、最初から最後までトレースされます。各トレースは、リクエストがサーバ内で実行されるときの一連のスパンから構成されます。 Selenium サーバのスパンのほとんどは、2 つのイベントから構成されています。

構成ヘルプ

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

ヘルプコマンドは、現在のコード実装に基づいて情報を表示します。したがって、ドキュメントが更新されない場合に備えて、正確な情報を提供します。それは、新しいバージョンのグリッド 4 の構成について学習する最も簡単な方法です。

Info コマンド

info コマンドは、次のトピックに関する詳細なドキュメントを提供します。

Selenium の構成
セキュリティ
セッションマップの設定
トレース

構成ヘルプ

クイック設定のヘルプと概要は、以下を実行することで提供されます。

java -jar selenium-server-<version>.jar info config

セキュリティ

安全な通信とノード登録のためのグリッドサーバーの設定の詳細を取得するには、以下を実行します。

java -jar selenium-server-<version>.jar info security

セッションマップの設定

デフォルトでは、グリッドはローカルセッションマップを使用してセッション情報を保存します。グリッドは、Redis や JDBC-SQL がサポートするデータベースなどの追加のストレージオプションをサポートしています。別のセッションストレージをセットアップするには、次のコマンドを使用してセットアップ手順を取得します。

java -jar selenium-server-<version>.jar info sessionmap

OpenTelemetry と Jaeger を使用したトレースの設定

デフォルトでは、トレースは有効になっています。トレースをエクスポートして Jaeger 経由で視覚化するには、次のコマンドを使用して手順を実行します。

java -jar selenium-server-<version>.jar info tracing

SeleniumGrid コマンドを一覧表示する

java -jar selenium-server-<version>.jar --config-help

使用可能なすべてのコマンドとそれぞれの説明が表示されます。

コンポーネントヘルプコマンド

Selenium ロールの後に–help config オプションを渡して、コンポーネント固有の構成情報を取得します。

スタンドアロン

java -jar selenium-server-<version>.jar standalone --help

ハブ

java -jar selenium-server-<version>.jar hub --help

セッション

java -jar selenium-server-<version>.jar sessions --help

新規セッションキュー

java -jar selenium-server-<version>.jar sessionqueue --help

ディストリビューター

java -jar selenium-server-<version>.jar distributor --help

ルーター

java -jar selenium-server-<version>.jar router --help

ノード

java -jar selenium-server-<version>.jar node --help

著作権と帰属

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!

Seleniumのドキュメント

このドキュメントをできるだけ完全かつ正確にするためにあらゆる努力が払われましたが、保証または適合性は暗示されていません。提供される情報は「現状のまま」です。著者および出版社は、本書に含まれる情報から生じる損失または損害に関して、いかなる個人または団体に対しても責任も責任も負わないものとします。ここに含まれる情報の使用に関して、特許責任は一切負いません。

帰属

Thanks to:

Selenium メイン Repository

@shs96c 5354 commits

@barancev 3352 commits

@jimevans 2478 commits

@titusfortner 1733 commits

@jleyba 1464 commits

@diemol 1378 commits

@jarib 1299 commits

@AutomatedTester 1227 commits

@dfabulich 1175 commits

@illicitonion 1162 commits

@p0deje 663 commits

@lukeis 599 commits

@pujagani 554 commits

@eranmes 473 commits

@bonigarcia 349 commits

@mdub 326 commits

@nvborisenko 316 commits

@andreastt 289 commits

@selenium-ci 258 commits

@krosenvold 225 commits

@joerg1985 224 commits

@harsha509 218 commits

@hugs 205 commits

@symonk 203 commits

@davehunt 200 commits

@hbchai 191 commits

@lmtierney 179 commits

@MichaelTamm 156 commits

@cgoldberg 153 commits

@freynaud 138 commits

@samitbadle 137 commits

@RenderMichael 137 commits

@nirvdrum 133 commits

@sevaseva 115 commits

@renovate[bot] 110 commits

@gigix 109 commits

@juangj 108 commits

@VietND96 97 commits

@aslakhellesoy 94 commits

@alex-savchuk 90 commits

@dependabot[bot] 84 commits

@navin772 84 commits

@andrashatvani 66 commits

@iampopovich 64 commits

@ajayk 63 commits

@Delta456 57 commits

@sandeepsuryaprasad 50 commits

@twalpole 49 commits

@asashour 48 commits

@aguspe 47 commits

@mikemelia 46 commits

@tebeka 44 commits

@asolntsev 43 commits

@luke-hill 43 commits

@mk868 42 commits

@raju249 42 commits

@santiycr 41 commits

@valfirst 40 commits

@mach6 36 commits

@ddavison 32 commits

@joshbruning 30 commits

@TamsilAmani 29 commits

@mikebroberts 28 commits

@JohnChen0 27 commits

@krmahadevan 25 commits

@shbenzer 23 commits

@alb-i986 22 commits

@bret 20 commits

@corevo 20 commits

@Stuk 19 commits

@rbri 16 commits

@manuelsblanco 16 commits

@bwalderman 15 commits

@bayandin 12 commits

@carlosgcampos 12 commits

@jayakumarc 12 commits

@potapovDim 12 commits

@rpallavisharma 11 commits

@43081j 11 commits

@detro 10 commits

@sbabcoc 10 commits

@josephg 10 commits

@RustyNail 9 commits

@hoefling 9 commits

@mdmintz 9 commits

@lauromoura 9 commits

@isaulv 9 commits

@whimboo 9 commits

@redsquirrel 9 commits

@mmerrell 8 commits

@dratler 7 commits

@User253489 7 commits

@dev-velo 7 commits

@DrMarcII 7 commits

@llaskin 7 commits

@SinghHrmn 7 commits

@glibas 7 commits

@Earlopain 7 commits

@dima-groupon 6 commits

@jameshilliard 6 commits

Selenium IDE

@corevo 2445 commits

@toddtarsi 397 commits

@baimao8437 88 commits

@coinzdude 57 commits

@Jongkeun 51 commits

@petermouse 36 commits

@zavelevsky 34 commits

@dependabot[bot] 29 commits

@LinYunWen 28 commits

@xdennisx 15 commits

@AutomatedTester 15 commits

@smildlzj 12 commits

@raju249 12 commits

@diemol 7 commits

@matewilk 6 commits

@manoj9788 3 commits

@Rowdster 3 commits

@fernandozw 3 commits

@mattonem 3 commits

@zewa666 3 commits

@shs96c 3 commits

@toshiya 2 commits

@Meir017 2 commits

@lukeis 2 commits

@giuliohome 2 commits

@cclauss 2 commits

@Angus3280 2 commits

@peter-lyons-kehl 1 commits

@newgenrpa 1 commits

@bolasblack 1 commits

@vivrichards600 1 commits

@swes1117 1 commits

@Delta456 1 commits

@harsha509 1 commits

@samitbadle 1 commits

@sotayamashita 1 commits

@p2635 1 commits

@marknoble 1 commits

@furkan7258 1 commits

@dvd900 1 commits

@cliftonHPE 1 commits

@atkulp 1 commits

@aplorenzen 1 commits

@amitzur 1 commits

@AlexGarrity 1 commits

Docker Selenium

@VietND96 563 commits

@diemol 538 commits

@selenium-ci 275 commits

@renovate[bot] 194 commits

@ddavison 134 commits

@mtscout6 53 commits

@kayabendroth 50 commits

@dependabot[bot] 42 commits

@elgalu 24 commits

@luisfcorreia 15 commits

@jamesmortensen 12 commits

@amardeep2006 9 commits

@WillAbides 8 commits

@jsa34 7 commits

@MacCracken 5 commits

@marten-cz 5 commits

@KyriosGN0 4 commits

@garagepoort 4 commits

@metajiji 4 commits

@Doofus100500 4 commits

@manoj9788 4 commits

@ZainabSalameh 4 commits

@niQo 4 commits

@testphreak 4 commits

@chenrui333 4 commits

@jeff-jk 3 commits

@pabloFuente 3 commits

@alexgibson 3 commits

@tnguyen14 3 commits

@abaldwin-op 3 commits

@Remi-p 3 commits

@mtcolman 3 commits

@msvticket 3 commits

@maxmanuylov 2 commits

@mhnaeem 2 commits

@naveensrinivasan 2 commits

@phensley 2 commits

@Trigtrig 2 commits

@anthonybaldwin 2 commits

@ryneeverett 2 commits

@wheleph 2 commits

@Opvolger 2 commits

@budtmo 2 commits

@SurelyMario 2 commits

@schmunk42 2 commits

@evertones 2 commits

@kmala 2 commits

@adriangonciarz 2 commits

@ilpianista 2 commits

@anwaramoon 2 commits

@baflQA 2 commits

@brunobritorj 2 commits

@chuckg 2 commits

@davehunt 2 commits

@den-is 2 commits

@glibas 2 commits

@DrFaust92 2 commits

@efranken 2 commits

@ehbello 2 commits

@joaoluizjoaquim 2 commits

@Earlopain 2 commits

@mathieu-pousse 2 commits

@DimmKirr 2 commits

@therealdjryan 2 commits

@VinodAnandan 1 commits

@victor-catalyst 1 commits

@slhck 1 commits

@trungprivate 1 commits

@wesmcouch 1 commits

@torstenwalter 1 commits

@cvakiitho 1 commits

@williamlac 1 commits

@schmetzyannick 1 commits

@yo-ga 1 commits

@nefelim4ag 1 commits

@thomas-parikka-milliman 1 commits

@ThomasMeschke 1 commits

@tuxiqae 1 commits

@cablespaghetti 1 commits

@scottturley 1 commits

@StegSchreck 1 commits

@sethuster 1 commits

@smccarthy 1 commits

@smccarthy-godaddy 1 commits

@simonardejr 1 commits

@StenAL 1 commits

@serlank 1 commits

@srguglielmo 1 commits

@stigkj 1 commits

@subanithak 1 commits

@sylbn 1 commits

@tadashi0713 1 commits

@Thab310 1 commits

@gitter-badger 1 commits

@graingert 1 commits

@z3k-io 1 commits

@mirkotschaeni 1 commits

@mkrei 1 commits

@neben 1 commits

@neilnaveen 1 commits

Selenium Website & Docs

@harsha509 859 commits

@diemol 852 commits

@selenium-ci 323 commits

@renovate[bot] 308 commits

@titusfortner 245 commits

@alaahong 128 commits

@rpallavisharma 92 commits

@pujagani 78 commits

@kzhirata 47 commits

@shbenzer 41 commits

@bonigarcia 41 commits

@dependabot[bot] 34 commits

@boris779 32 commits

@VietND96 30 commits

@AutomatedTester 30 commits

@alenros 28 commits

@github-actions[bot] 27 commits

@aguspe 27 commits

@AlexAndradeNet 25 commits

@manoj9788 22 commits

@Delta456 22 commits

@jmartinezpoq 18 commits

@navin772 17 commits

@ivanrodjr 17 commits

@luisfcorreia 15 commits

@shs96c 14 commits

@nvborisenko 14 commits

@sindhudiddi 12 commits

@cgoldberg 11 commits

@hiroksarker 10 commits

@nwintop 8 commits

@testbot206 7 commits

@krmahadevan 7 commits

@tetration 7 commits

@yvsvarma 6 commits

@fufu930 6 commits

@liushilive 6 commits

@Greavox 6 commits

@connerT 6 commits

@Catalin-Negru 5 commits

@davieduardo94 5 commits

@smilinrobin 5 commits

@lvninety 5 commits

@hyanx 5 commits

@beinghumantester 5 commits

@TamsilAmani 5 commits

@noritaka1166 5 commits

@nainappa 5 commits

@kathyrollo 5 commits

@jasonren0403 5 commits

@Dor-bl 5 commits

@nevinaydin 4 commits

@ant9112 4 commits

@peter-kinzelman 4 commits

@manghita 4 commits

@kjayachandra2000 4 commits

@harshitBhardwaj97 4 commits

@wcmcgee 4 commits

@angelovstanton 4 commits

@barancev 4 commits

@Tolerblanc 3 commits

@BlazerYoo 3 commits

@twinstae 3 commits

@cambiph 3 commits

@TestOpsCloudchen 3 commits

@raju249 3 commits

@rajeevbarde 3 commits

@Madh93 3 commits

@mmerrell 3 commits

@zipperer 3 commits

@Crank4 3 commits

@Arc-Jung 3 commits

@ArCiGo 3 commits

@gnatcatcher-bg 3 commits

@effeix 3 commits

@jags14385 3 commits

@jamesmortensen 3 commits

@j3soon 3 commits

@rahuljhakant 2 commits

@sangcnguyen 2 commits

@sbabcoc 2 commits

@SparshKesari 2 commits

@urig 2 commits

@sridhar-5 2 commits

@YevgeniyShunevych 2 commits

@YoshikiIto 2 commits

@digitalvoice-nz 2 commits

@eaccmk 2 commits

@ilhanoztozlu 2 commits

@Ggggonglei 2 commits

@sangheon4353 2 commits

@selectorshubsanjay 2 commits

@SripriyaPKulkarni 2 commits

@GavinHaydy 2 commits

@imba-tjd 2 commits

@k19810703 2 commits

@0420syj 2 commits

@TheTestLynx 2 commits

@olleolleolle 2 commits

@urban-adeininger 2 commits

Previous Selenium Website

@lukeis 417 commits

@shs96c 87 commits

@pgrandje 79 commits

@barancev 63 commits

@lightbody 59 commits

@ajayk 40 commits

@tarun3kumar 40 commits

@ddavison 36 commits

@davehunt 26 commits

@manoj9788 24 commits

@peter-lyons-kehl 22 commits

@samitbadle 21 commits

@lmtierney 21 commits

@santiycr 19 commits

@illicitonion 17 commits

@pnewhook 14 commits

@AutomatedTester 12 commits

@juangj 11 commits

@rasmusbergpalm 11 commits

@lukeis-sfdc 10 commits

@andreastt 7 commits

@hugs 6 commits

@corevo 5 commits

@titusfortner 5 commits

@PaulKC 5 commits

@MichaelTamm 5 commits

@llaskin 5 commits

@jimevans 5 commits

@jarib 5 commits

@diemol 3 commits

@abhijain2618 2 commits

@labkey-tchad 2 commits

@paul-hammant 2 commits

@mikemelia 2 commits

@julianharty 2 commits

@hazmeister 2 commits

@eranmes 2 commits

@darrincherry 2 commits

@javabrett 2 commits

@alex-savchuk 2 commits

@oleksandr-lobunets 2 commits

@asashour 2 commits

@yasinguzel 1 commits

@Vimal-N 1 commits

@SteveDesmond-ca 1 commits

@harrissAvalon 1 commits

@smatei 1 commits

@QuinnWilton 1 commits

@roydekleijn 1 commits

@rbri 1 commits

@oifland 1 commits

@ohadschn 1 commits

@NickAb 1 commits

@tobecrazy 1 commits

@Zearin 1 commits

@beckendorff 1 commits

@daveOrleans 1 commits

@androiddriver 1 commits

@mauk81 1 commits

@prab2112 1 commits

@refactoror 1 commits

@rogerdc 1 commits

@tibord 1 commits

@ygmarchi 1 commits

@agabrys 1 commits

@azawawi 1 commits

@alb-i986 1 commits

@hollingsworthd 1 commits

@dylans 1 commits

@EmidioStani 1 commits

@FagnerMartinsBrack 1 commits

@Xaeroxe 1 commits

@JamesZoft 1 commits

@jleyba 1 commits

@JustAGuyTryingToCodeSomething 1 commits

@kdamball 1 commits

@laurinkeithdavis 1 commits

@klamping 1 commits

@krmahadevan 1 commits

@krosenvold 1 commits

@mmerrell 1 commits

@grawk 1 commits

@mcavigelli 1 commits

@michaelwowro 1 commits

@muralidharand 1 commits

@meeroslaph 1 commits

Previous Documentation Rewrite Project

@andreastt 197 commits

@selenium-ci 105 commits

@diemol 54 commits

@hazmeister 30 commits

@santiycr 27 commits

@AlexAndradeNet 25 commits

@lukeis 21 commits

@harsha509 17 commits

@ddavison 16 commits

@djangofan 12 commits

@orieken 12 commits

@manoj9788 12 commits

@davehunt 12 commits

@liushilive 8 commits

@User253489 7 commits

@shs96c 6 commits

@imba-tjd 6 commits

@jimholmes 6 commits

@vijay44 5 commits

@cambiph 5 commits

@manghita 4 commits

@NickOppersdorff 4 commits

@rivlinp 4 commits

@sheg 4 commits

@bizob2828 4 commits

@TheTestLynx 3 commits

@Ardesco 3 commits

@detro 3 commits

@paul-barton 2 commits

@mmerrell 2 commits

@ilhanoztozlu 2 commits

@hoanluu 2 commits

@sri85 2 commits

@miekof 2 commits

@palotas 2 commits

@lmtierney 2 commits

@Bredda 2 commits

@boris779 2 commits

@rakib-amin 1 commits

@NRezek 1 commits

@nikai3d 1 commits

@OndraM 1 commits

@sourabhkt 1 commits

@whhone 1 commits

@yarix 1 commits

@ZbigniewZabost 1 commits

@agmen 1 commits

@hking-shutterfly 1 commits

@jimevans 1 commits

@948462448 1 commits

@marilyn 1 commits

@riccione 1 commits

@tungla 1 commits

@zeljkofilipin 1 commits

@MilanMasek 1 commits

@misiekofski 1 commits

@michael-coleman 1 commits

@MartinDelille 1 commits

@austenjt 1 commits

@nicegraham 1 commits

@bongosway 1 commits

@donhuvy 1 commits

@dennybiasiolli 1 commits

@chamiz 1 commits

@bhardin 1 commits

@abotalov 1 commits

@AJ-72 1 commits

@p0deje 1 commits

@alenros 1 commits

@adithyab94 1 commits

Seleniumドキュメントプロジェクトで使用されるサードパーティソフトウェア

Software	Version	License
Hugo	v0.110.0	Apache 2.0
Docsy	—	Apache 2.0

ライセンス

Seleniumプロジェクトから作成されたすべてのコードとドキュメントは、 Apache 2.0ライセンスに基づいてライセンスされており、 Software Freedom Conservancy に著作権があります。

要素を探す

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 の適切な設定を模索するのに利用してください。

GraphQLクエリのサポート

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

GraphQLは、APIのクエリ言語であり、既存のデータでこれらのクエリを実行するためのランタイムです。これにより、ユーザーは必要なものだけを正確に要求することができます。

列挙型(Enum)

列挙型は、フィールドの可能な値のセットを表します。

たとえば、 Node オブジェクトには status というフィールドがあります。 UP 、 DRAINING 、または UNAVAILABLE の可能性があるため、状態は、列挙型（具体的には、Status タイプ）です。

スカラー

スカラーはプリミティブ値です： Int 、 Float 、 String 、 Boolean 、または ID 。

GraphQL APIを呼び出すときは、スカラーのみを返すまでネストされたサブフィールドを指定する必要があります。

スキーマの構造

グリッドスキーマの構造は次のとおりです。

{
 session(id: "<session-id>") : {
 id,
 capabilities,
 startTime,
 uri,
 nodeId,
 nodeUri,
 sessionDurationMillis
 slot : {
 id,
 stereotype,
 lastStarted
 }
 }
 grid: {
 uri,
 totalSlots,
 nodeCount,
 maxSession,
 sessionCount,
 version,
 sessionQueueSize
 }
 sessionsInfo: {
 sessionQueueRequests,
 sessions: [
 {
 id,
 capabilities,
 startTime,
 uri,
 nodeId,
 nodeUri,
 sessionDurationMillis
 slot : {
 id,
 stereotype,
 lastStarted
 }
 }
 ]
 }
 nodesInfo: {
 nodes : [
 {
 id,
 uri,
 status,
 maxSession,
 slotCount,
 sessions: [
 {
 id,
 capabilities,
 startTime,
 uri,
 nodeId,
 nodeUri,
 sessionDurationMillis
 slot : {
 id,
 stereotype,
 lastStarted
 }
 }
 ],
 sessionCount,
 stereotypes,
 version,
 osInfo: {
 arch,
 name,
 version
 }
 }
 ]
 }
}

GraphQLで照会する

GraphQLをクエリする最良の方法は、 curl リクエストを使用することです。 GraphQLを使用すると、必要なデータのみをフェッチできます。それ以上でもそれ以下でもありません。

Grid 3

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

Grid 4

Selenium Grid は、SeleniumテストがコマンドをリモートWebブラウザーインスタンスにルーティングできるようにする賢いプロキシサーバーです。その目的は、複数のマシンで並行してテストを実行する簡単な方法を提供することです。

Selenium Gridでは、1つのサーバーが、JSON形式のテストコマンドを1つ以上の登録済みのグリッドノードにルーティングするハブとして機能します。テストはハブに接続して、リモートブラウザーインスタンスへのアクセスを取得します。ハブには、アクセスを提供する登録済みサーバーのリストがあり、これらのインスタンスを制御できます。

Selenium Gridを使用すると、複数のマシンで並行してテストを実行し、さまざまなブラウザーバージョンとブラウザー構成を（個々のテストではなく）一元的に管理できます。

Selenium Gridは特効薬ではありません。一般的な委譲および配布の問題のサブセットを解決しますが、たとえばインフラストラクチャを管理せず、特定のニーズに適さない場合があります。

Gridを始める

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

クイックスタート

事前条件
- Java 11 もしくはそれ以上がインストールされていること
- ブラウザーがインストールされていること
- ブラウザードライバー
  - Selenium Manager will configure the drivers automatically if you add --selenium-manager true.
  - PATH が通っているインストール済みのもの
- 最新の Selenium Server jar ファイルをダウンロードしていること
Grid の起動
- java -jar selenium-server-<version>.jar standalone
あなたの WebDriver テストの対象を http://localhost:4444 に向ける
(必要があれば) ブラウザでhttp://localhost:4444を開いて実行中のテストや利用可能な capabilities を確認する。

さらにオプションを知りたい場合は以降のセクションに進んでください。

Grid コンポーネントロール

Grid は 6 つの異なるコンポーネントで構成され、様々な方法でデプロイすることができます。

必要に応じて、それぞれ個別に起動する（分散）か、ハブ&ノードのグループに分けるか、全てを一つのマシンで起動する（スタンドアロン）かを選べます。

スタンドアロン

スタンドアロンは全ての Gridコンポーネントを 1 つに連結します。 スタンドアロンモードはシングルプロセスで動き、Grid の全機能を利用することができます。 スタンドアロンは単一のマシン上でのみ動かすことができます。

スタンドアロンは Selenium Grid を起動する最も簡単な方法でもあります。デフォルトではサーバーはhttp://localhost:4444 で RemoteWebDriver リクエストをリッスンします。サーバーはデフォルトでシステムパス上の利用可能なドライバーを検出します。

java -jar selenium-server-<version>.jar standalone

スタンドアロンで Grid のを起動したら、WebDriver テストの対象をhttp://localhost:4444に向けてください。

HTMLランナー

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

Selenium HTMLランナー を使用すると、コマンドラインからテストスイートを実行できます。テストスイートは、Selenium IDEまたは互換性ツールからのHTMLエクスポートです。

共通情報

geckodriver / firefox / selenium-html-runnerのリリースの組み合わせが重要です。どこかにソフトウェア互換性マトリックスがあるかもしれません。
selenium-html-runnerはテストスイートのみを実行します（テストケースではなく、Monitis Transaction Monitorからのエクスポートなど）。必ずこれを順守してください。
DISPLAYのないLinuxユーザーの場合-仮想ディスプレイでhtml-runnerを起動する必要があります（xvfbを検索）。

Linux環境の例

次のソフトウェアパッケージをインストール/ダウンロードします。

[user@localhost ~]$ cat /etc/redhat-release
CentOS Linux release 7.4.1708 (Core)

[user@localhost ~]$ rpm -qa | egrep -i "xvfb|java-1.8|firefox"
xorg-x11-server-Xvfb-1.19.3-11.el7.x86_64
firefox-52.4.0-1.el7.centos.x86_64
java-1.8.0-openjdk-1.8.0.151-1.b12.el7_4.x86_64
java-1.8.0-openjdk-headless-1.8.0.151-1.b12.el7_4.x86_64

テストスイートの例

[user@localhost ~]$ cat testsuite.html
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
 <meta content="text/html; charset=UTF-8" http-equiv="content-type" />
 <title>Test Suite</title>
</head>
<body>
<table id="suiteTable" cellpadding="1" cellspacing="1" border="1" class="selenium"><tbody>
<tr><td><b>Test Suite</b></td></tr>
<tr><td><a href="YOUR-TEST-SCENARIO.html">YOUR-TEST-SCENARIO</a></td></tr>
</tbody></table>
</body>
</html>

selenium-html-runnerをヘッドレスで実行する方法

さて、最も重要な部分、selenium-html-runnerの実行方法の例！経験によってソフトウェアの組み合わせ、- geckodriver / FF / html-runnerリリースによって異なる場合があります。

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 minimzes 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.

JavaScript アラート、プロンプトおよび確認

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

WebDriverは、JavaScriptが提供する3種類のネイティブポップアップメッセージを操作するためのAPIを提供します。これらのポップアップはブラウザーによってスタイルが設定され、カスタマイズが制限されています。

アラート

これらの最も単純なものはアラートと呼ばれ、カスタムメッセージと、ほとんどのブラウザーでOKのラベルが付いたアラートを非表示にする単一のボタンを表示します。ほとんどのブラウザーでは閉じるボタンを押すことで閉じることもできますが、これは常にOKボタンと同じことを行います。アラートの例を参照してください。

WebDriverはポップアップからテキストを取得し、これらのアラートを受け入れるか、または閉じることができます。


import static org.junit.jupiter.api.Assertions.assertEquals;

public class AlertsTest extends BaseTest {

 @BeforeEach

View Complete Code View on GitHub

 element = driver.find_element(By.LINK_TEXT, "See an example alert")
 element.click()

 wait = WebDriverWait(driver, timeout=2)
 alert = wait.until(lambda d : d.switch_to.alert)
 text = alert.text
 alert.accept()

View Complete Code View on GitHub

//Click the link to activate the alert
driver.FindElement(By.LinkText("See an example alert")).Click();

//Wait for the alert to be displayed and store it in a variable
IAlert alert = wait.Until(ExpectedConditions.AlertIsPresent());

//Store the alert text in a variable
string text = alert.Text;

//Press the OK button
alert.Accept();

 # Store the alert reference in a variable
 alert = driver.switch_to.alert

 # Get the text of the alert
 alert.text

 # Press on Cancel button
 alert.dismiss

View Complete Code View on GitHub

 let alert = await driver.switchTo().alert();
 let alertText = await alert.getText();
 await alert.accept();

View Complete Code View on GitHub

//Click the link to activate the alert
driver.findElement(By.linkText("See an example alert")).click()

//Wait for the alert to be displayed and store it in a variable
val alert = wait.until(ExpectedConditions.alertIsPresent())

//Store the alert text in a variable
val text = alert.getText()

//Press the OK button
alert.accept()

確認

確認ダイアログボックスはアラートに似ていますが、ユーザーがメッセージをキャンセルすることも選択できる点が異なります。サンプルを確認してください。

Keyboard actions

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

There are only 2 actions that can be accomplished with a keyboard: pressing down on a key, and releasing a pressed key. In addition to supporting ASCII characters, each keyboard key has a representation that can be pressed or released in designated sequences.

Keys

In addition to the keys represented by regular unicode, unicode values have been assigned to other keyboard keys for use with Selenium. Each language has its own way to reference these keys; the full list can be found here.

Command Listeners

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

These allow you to execute custom actions in every time specific Selenium commands are sent

Add Example

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

RCからWebDriverへの移行

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

Selenium WebDriverに移行する方法

Selenium 2を採用する際によくある質問は、「既存のテストセットに新しいテストを追加するときに正しいことは何ですか？」ということです。フレームワークを初めて使用するユーザーは、新しいWebDriver APIを使用してテストを作成することから始めることができます。しかし、既存のテストスイートを既に持っているユーザーはどうでしょうか？このガイドは、既存のテストを新しいAPIに移行し、WebDriverが提供する新機能を使用してすべての新しいテストを作成する方法を示すことを目的としています。

ここで紹介する方法は、1回の大規模なプッシュですべてをやり直す必要のない、WebDriver APIへの断片的な移行について説明しています。これは、既存のテストの移行により多くの時間を割り当てることができることを意味します。これにより、どこに労力を費やすかを決定しやすくなります。

このガイドは、移行を行うための最良のサポートがあるため、Javaを使用して書かれています。他の言語用のより優れたツールを提供するため、このガイドはそれらの言語を含むように拡張されます。

WebDriverに移行する理由

一連のテストをあるAPIから別のAPIに移動するには、多大な労力が必要です。なぜあなたとあなたのチームはこの動きを検討するのですか？ WebDriverを使用するためにSeleniumテストを移行することを検討する必要があるいくつかの理由を以下に示します。

小さくコンパクトなAPI。 WebDriverのAPIは、元のSelenium RC APIよりもオブジェクト指向です。これにより、作業が容易になります。
ユーザー操作のより良いエミュレーション。可能な場合、WebDriverはWebページと対話するためにネイティブイベントを使用します。これは、ユーザーがサイトやアプリを操作する方法をより厳密に模倣しています。さらに、WebDriverは、サイトとの複雑な相互作用をモデル化できる高度なユーザーインタラクションAPIを提供します。
ブラウザーベンダーによるサポート。 Opera、Mozilla、GoogleはすべてWebDriverの開発に積極的に参加しており、それぞれにフレームワークの改善に取り組んでいるエンジニアがいます。多くの場合、これはWebDriverのサポートがブラウザー自体に組み込まれていることを意味します。テストは可能な限り高速で安定して実行されます。

はじめる前に

移行プロセスを可能な限り簡単にするために、すべてのテストが最新のSeleniumリリースで正しく実行されることを確認してください。これは当たり前のように聞こえるかもしれませんが、言ってもらうのが最善です！

はじめに

移行を開始する最初の手順は、Seleniumのインスタンスの取得方法を変更することです。 Selenium RCを使用する場合、これは次のように行われます。

Selenium selenium = new DefaultSelenium("localhost", 4444, "*firefox", "http://www.yoursite.com");
selenium.start();

これは次のように置き換える必要があります。

WebDriver driver = new FirefoxDriver();
Selenium selenium = new WebDriverBackedSelenium(driver, "http://www.yoursite.com");

次のステップ

テストがエラーなしで実行されたら、次の段階は実際のテストコードを移行してWebDriver APIを使用することです。コードがどれだけ適切に抽象化されているかによって、これは短いプロセスまたは長いプロセスになります。どちらの場合でも、アプローチは同じであり、簡単に要約できます。編集するときに新しいAPIを使用するようにコードを変更します。

基になるWebDriver実装をSeleniumインスタンスから抽出する必要がある場合は、WrapsDriverにキャストするだけです。

WebDriver driver = ((WrapsDriver) selenium).getWrappedDriver();

これにより、通常どおりSeleniumインスタンスの受け渡しを続けることができますが、必要に応じてWebDriverインスタンスのラップを解除できます。

Selenium RC (Selenium 1)

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

紹介

Selenium RCは長い間メインのSeleniumプロジェクトでしたが、WebDriver/Seleniumを併合したより強力なツールであるSelenium 2が登場しました。 Selenium 1はもうサポートされていないことを強調する価値があります。

Selenium RCの仕組み

はじめに、Selenium RCのコンポーネントがどのように動作するか、およびテストスクリプトの実行でそれぞれが果たす役割について説明します。

RCコンポーネント

SeleniumRCコンポーネントは、以下のとおりです。

ブラウザを起動および終了し、テストプログラムから渡されたSeleneseコマンドを解釈および実行し、ブラウザとAUTの間で渡されるHTTPメッセージをインターセプトおよび検証するSeleniumサーバー
各プログラミング言語とSelenium RC Server間のインターフェイスを提供するクライアントライブラリ

これは簡略化されたアーキテクチャ図です。

この図は、クライアントライブラリが実行される各Seleniumコマンドを渡すサーバーと通信することを示しています。次に、サーバーはSelenium-Core JavaScriptコマンドを使用してSeleniumコマンドをブラウザーに渡します。ブラウザは、JavaScriptインタープリターを使用して、Seleniumコマンドを実行します。これにより、テストスクリプトで指定したSeleneseアクションまたは検証が実行されます。

Seleniumサーバー

Seleniumサーバーは、テストプログラムからSeleniumコマンドを受信して解釈し、それらのテストの実行結果をプログラムに報告します。

RCサーバーはSelenium Coreをバンドルし、ブラウザーに自動的に挿入します。これは、テストプログラムがブラウザを開いたときに発生します（クライアントライブラリのAPI関数を使用）。 Selenium-CoreはJavaScriptプログラムです。実際には、ブラウザの組み込みJavaScriptインタープリターを使用してSeleneseコマンドを解釈および実行するJavaScript関数のセットです。

サーバーは、単純なHTTP GET/POSTリクエストを使用して、テストプログラムからSeleneseコマンドを受け取ります。これは、HTTPリクエストを送信できるプログラミング言語を使用して、ブラウザーでのSeleniumテストを自動化できることを意味します。

クライアントライブラリ

クライアントライブラリは、独自の設計のプログラムからSeleniumコマンドを実行できるプログラミングサポートを提供します。サポートされる言語ごとに異なるクライアントライブラリがあります。 Seleniumクライアントライブラリは、プログラミングインターフェイス（API）、つまり、独自のプログラムからSeleniumコマンドを実行する一連の関数を提供します。各インターフェイス内には、各Seleneseコマンドをサポートするプログラミング関数があります。

クライアントライブラリは、Seleneseコマンドを受け取り、それをSeleniumサーバーに渡して、特定のアクションまたはテスト対象アプリケーション（AUT）に対するテストを処理します。クライアントライブラリは、そのコマンドの結果も受け取り、プログラムに返します。プログラムは結果を受け取ってプログラム変数に保存し、成功または失敗として報告するか、予期しないエラーの場合は修正アクションを実行できます。

したがって、テストプログラムを作成するには、クライアントライブラリAPIを使用して一連のSeleniumコマンドを実行するプログラムを作成するだけです。また、オプションで、Selenium-IDEでSeleneseテストスクリプトを既に作成している場合は、Selenium RCコードを生成できます。 Selenium-IDEは、（エクスポートメニュー項目を使用して）SeleniumコマンドをクライアントドライバーのAPI関数呼び出しに変換できます。 Selenium-IDEからRCコードをエクスポートする詳細については、Selenium-IDEの章を参照してください。

インストール

インストールというのは、Seleniumの誤った呼び名です。 Seleniumには、選択したプログラミング言語で利用可能な一連のライブラリがあります。ダウンロードページからダウンロードできます。

使用する言語を選択したら、次のことを行う必要があります。

Selenium RCサーバーをインストールします。
言語固有のクライアントドライバーを使用してプログラミングプロジェクトをセットアップします。

Seleniumサーバーのインストール

Selenium RCサーバーは単なるJava jarファイル（selenium-server-standalone-<version-number>.jar）であり、特別なインストールは不要です。 zipファイルをダウンロードして、目的のディレクトリにサーバーを展開するだけで十分です。

Seleniumサーバーを実行する

テストを開始する前に、サーバーを起動する必要があります。 Selenium RCのサーバーがあるディレクトリに移動し、コマンドラインコンソールから次を実行します。

 java -jar selenium-server-standalone-<version-number>.jar

これは、上記のコマンドを含むバッチまたはシェル実行可能ファイル（Windowsでは.bat、Linuxでは.sh）を作成することで簡素化できます。次に、デスクトップ上でその実行可能ファイルへのショートカットを作成し、アイコンをダブルクリックしてサーバーを起動します。

サーバーを実行するには、Javaをインストールし、PATH環境変数をコンソールから実行するように正しく構成する必要があります。コンソールで次を実行すると、Javaが正しくインストールされていることを確認できます。

Seleniumのサイトとドキュメントに貢献する

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

Seleniumは大きなソフトウェアプロジェクトであり、そのサイトとドキュメントは、物事の仕組みを理解し、その可能性を活用する効果的な方法を学ぶための鍵となります。

このプロジェクトには、Seleniumのサイトとドキュメントの両方が含まれています。これは、Seleniumを効果的に使用する方法、Seleniumに参加する方法、およびSeleniumに貢献する方法に関する最新情報を提供するための継続的な取り組みです（特定のリリースを対象としていません）。

サイトおよびドキュメントへの貢献は、以下のセクションで説明されているプロセスに従います。

Seleniumプロジェクトは、皆様からのコントリビューションを歓迎します。お手伝いをいただくには、いくつかの方法があります:

イシュー報告

新しい問題を報告したり、既存の問題についてコメントしたりするときは、議論がSeleniumソフトウェア、そのサイトおよび/またはドキュメントに関する具体的な技術問題に関連していることを確認してください。

Seleniumのすべてのコンポーネントは、時間の経過とともに非常に速く変化するため、ドキュメントが古くなる可能性があります。このようなケースを見つけた場合には、遠慮なくイシューを作成してください。また、ドキュメントを最新の状態に更新する方法をご存知でしたら、関連する変更を含むプルリクエストを送ってしてください。

見つかったものが問題であるかどうかわからない場合、https://selenium.dev/supportに記載されているコミュニケーション手段にて質問してください。

何を手伝うか

例の作成

追加が必要な例には、次のマークが付いています:

Add Example

すべてのコード例をCIで実行できるようにし、サイト上のすべてのコードをコピー＆ペーストして実行できることを確認したいと考えています。そのため、コードをexamplesディレクトリの適切な場所に配置します。ドキュメントの各ページは各言語のテストファイルに関連しており、命名規則に従う必要があります。例えば、このページ（https://www.selenium.dev/documentation/webdriver/browsers/chrome/）の例は以下のファイルに追加されています:

"/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"
"/examples/javascript/test/browser/chromeSpecificCaps.spec.js"

各例はそれぞれ独自のテストが必要です。理想的には、各テストにはコードが意図したとおりに動作することを確認するアサーションが含まれています。コードを適切なファイル内の独自のテストにコピーしたら、Markdownファイルで参照する必要があります。

例えば、Rubyのtabは次のようになります:

 {{< tab header="Ruby" >}}
 {{< gh-codeblock path="/examples/ruby/spec/browsers/chrome_spec.rb#L8-L9" >}}
 {{< /tab >}}

末尾の行番号は、実際に表示される項目を表すコードの行のみを表します。ユーザーがより多くのコンテキストを必要とする場合、GitHubページへのリンクをクリックすると完全なコンテキストが表示されます。

ページにテストを追加する場合は、Markdownファイル内の他のすべての行番号が正しいことを確認してください。ページの先頭にテストを追加すると、そのファイルの行番号を持つドキュメント内のすべての参照が更新されます。

Code examples may need a relevant website or web page to demonstrate the scenario. To ensure examples consistently work, it is recommended to use the test web pages available at https://www.selenium.dev/selenium/web/.

ブラウザーオプション

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

Selenium 3 では、Capabilitiesは Desired Capabilities クラスを使用してセッションで定義していました。 Selenium 4 以降、ブラウザオプションクラスを使用する必要があります。リモートドライバーセッションの場合、使用するブラウザーを決めるため、ブラウザーオプションインスタンスが必要です。

これらのオプションは、Capabilities の w3c仕様で説明しています。

各ブラウザには、w3c仕様で定義しているものに加えて定義可能なカスタムオプションがあります。

browserName

オプションクラスのインスタンスを使用すると、ブラウザ名はデフォルトで設定されます。

	ChromeOptions chromeOptions = getDefaultChromeOptions();
	String name = chromeOptions.getBrowserName();

View Complete Code View on GitHub

 options = get_default_chrome_options()
 assert options.capabilities['browserName'] == 'chrome'

View Complete Code View on GitHub

Add Example

テストの種類

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

受け入れテスト

このタイプのテストは、機能またはシステムが顧客の期待と要件を満たしているかどうかを判断するために行われます。このタイプのテストには通常、顧客の協力またはフィードバックが関与します。下記質問に答えることで確認することができます。

正しい 製品を作っていますか？

Webアプリケーションの場合、ユーザーの予想される動作をシミュレートすることで、このテストの自動化をSeleniumで直接実行できます。このシミュレーションは、このドキュメントで説明されているように、記録/再生によって、またはサポートされているさまざまな言語によって実行できます。注：受け入れテストは 機能テスト のサブタイプであり、一部の人はこれにも言及する場合があります。

機能テスト

このタイプのテストは、機能またはシステムが問題なく正常に機能するかどうかを判断するために行われます。システムをさまざまなレベルでチェックして、すべてのシナリオがカバーされていること、およびシステムが実行すべきことを実行していることを確認します。下記質問に答えることで確認することができます。

製品を 正しく 作っていますか？

これは通常以下を含みます。テストがエラーなし（404、例外…）、使用可能な方法（正しいリダイレクト）で機能する、利用しやすく、仕様に一致します（上記の 受け入れテスト を参照）。

Webアプリケーションの場合、期待されるリターンをシミュレートすることにより、このテストの自動化をSeleniumで直接実行できます。このシミュレーションは、このドキュメントで説明されているように、記録/再生またはサポートされているさまざまな言語で実行できます。

パフォーマンステスト

その名前が示すように、パフォーマンステストは、アプリケーションのパフォーマンスを測定するために行われます。

パフォーマンステストには2つの主なサブタイプがあります。

ロードテスト

ロードテストは、定義されたさまざまな負荷（通常、特定の数のユーザーが同時に接続されている場合）でアプリケーションがどの程度機能するかを確認するために行われます。

For example, Testing that the site can handle numerous orders/users at once.

ストレステスト

ストレステストは、ストレス下（またはサポートされている最大負荷以上）でアプリケーションがどの程度機能するかを確認するために行われます。

For example, Testing that your ecommerce site can handle Black Friday

一般に、パフォーマンステストは、Seleniumで書かれたテストを実行して、さまざまなユーザーがWebアプリの特定の機能を押して、意味のある測定値を取得することをシミュレートして実行されます。

これは通常、メトリックを取得する他のツールによって行われます。そのようなツールの1つが JMeter です。

Webアプリケーションの場合、測定する詳細には、スループット、待ち時間、データ損失、個々のコンポーネントの読み込み時間などが含まれます…

注1：すべてのブラウザには、開発者のツールセクションにパフォーマンスタブがあります（F12キーを押すとアクセス可能）

注2：これは一般に機能/機能ごとではなくシステムごとに測定されるため、 非機能テスト のサブタイプです。

ファイルダウンロード

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

Seleniumの管理下にあるブラウザーでリンクをクリックしてダウンロードを開始することは可能ですが、APIはダウンロードの進行状況を公開しないため、ダウンロードしたファイルのテストには理想的ではありません。これは、ファイルのダウンロードは、Webプラットフォームとのユーザーインタラクションをエミュレートする重要な側面とは見なされないためです。代わりに、Selenium（および必要なCookie）を使用してリンクを見つけ、 curl などのHTTPリクエストライブラリに渡します。

HtmlUnitドライバーは、 AttachmentHandler インターフェイスを実装することで、入力ストリームとして添付ファイルにアクセスすることによって、添付ファイルをダウンロードできます。 AttachmentHandlerは、HtmlUnit に追加できます。

Seleniumライブラリのインストール

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

最初にあなたの自動化プロジェクトにSeleniumのバインディングをインストールする必要があります。インストールの方法は選択した言語によって異なります。

言語別の要件

サポートされている最小のJavaバージョンを表示するここ.

Java用のSeleniumライブラリのインストールは、ビルドツールを使用して行います。

Maven

プロジェクトの ‘pom.xml’ ファイルで依存関係を指定します:

 <groupId>org.seleniumhq.selenium</groupId>
 <artifactId>selenium-java</artifactId>
 <version>${selenium.version}</version>
 </dependency>

View Complete Code View on GitHub

Gradle

プロジェクトの ‘build.gradle’ ファイル内の依存関係を ’testImplementation’ として指定します:

Web要素の検索

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

Seleniumを使用する最も基本的な側面の1つは、操作する要素の参照を取得することです。 Seleniumは、要素を一意に識別するための多数の組み込みロケーター戦略を提供します。非常に高度なシナリオでロケーターを使用する方法はたくさんあります。このドキュメントの目的のために、このHTMLスニペットについて考えてみましょう。

<ol id="vegetables">
 <li class="potatoes">…
 <li class="onions">…
 <li class="tomatoes"><span>Tomato is a Vegetable</span>…
</ol>
<ul id="fruits">
 <li class="bananas">…
 <li class="apples">…
 <li class="tomatoes"><span>Tomato is a Fruit</span>…
</ul>

最初に一致する要素

多くのロケーターは、ページ上の複数の要素と一致します。単数の find elementメソッドは、指定されたコンテキスト内で最初に見つかった要素への参照を返します。

DOM全体の評価

ドライバーインスタンスで要素の検索メソッドが呼び出されると、提供されたロケーターと一致するDOMの最初の要素への参照が返されます。この値は保存して、将来の要素アクションに使用できます。上記のHTMLの例では、クラス名が “tomatoes” の要素が2つあるため、このメソッドは “vegetables” リストの要素を返します。

WebElement vegetable = driver.findElement(By.className("tomatoes"));

vegetable = driver.find_element(By.CLASS_NAME, "tomatoes")

var vegetable = driver.FindElement(By.ClassName("tomatoes"));

 driver.find_element(class: 'tomatoes')

View Complete Code View on GitHub

const vegetable = await driver.findElement(By.className('tomatoes'));

val vegetable: WebElement = driver.findElement(By.className("tomatoes"))

DOMのサブセットの評価

DOM全体で一意のロケーターを見つけるのではなく、検索を別の検索された要素のスコープに絞り込むと便利なことがよくあります。上記の例では、クラス名が “トマト” の2つの要素があり、2番目の要素の参照を取得するのは少し困難です。

Selenium 詳細

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

Selenium 詳細

Selenium にはさまざまな機能がありますが、その核となるのは、ブラウザーのインスタンスをリモートで制御し、ユーザーとブラウザーのやりとりをエミュレートするために利用できる最高の技術を使用する、 Webブラウザー自動化のためのツールセットです。

Seleniumを使用すると、ユーザーはエンドユーザーが実行する一般的なアクティビティをシミュレートできます。フィールドにテキストを入力し、ドロップダウン値とチェックボックスを選択し、ドキュメント内のリンクをクリックします。また、マウスの移動、任意の JavaScript の実行など、他の多くのコントロールも提供します。

主にWebサイトのフロントエンドのテストに使用されますが、その中核として、Seleniumは、ユーザーがブラウザーを代理で操作する ライブラリ です。インターフェースはアプリケーションに遍在しており、目的に合わせて他のライブラリとの構成を促進します。

すべてを支配する 1 つのインターフェース

プロジェクトの指針となる原則の1つは、すべての (主要な) ブラウザーテクノロジに共通のインターフェイスをサポートすることです。 Webブラウザーは非常に複雑で、高度に設計されたアプリケーションであり、まったく異なる方法で操作を実行しますが、実行中は同じように見えることがよくあります。テキストは同じフォントで表示されますが、画像は同じ場所に表示され、リンク先は同じです。水面下で起こっていることは、昼と夜と同じくらい異なります。 Selenium はこれらの違いを “抽象化” し、コードを書いている人からその詳細や複雑さを隠蔽します。これにより、数行のコードを記述して複雑なワークフローを実行できますが、これらの同じ行は、Firefox、Internet Explorer、Chrome、およびその他のサポートされているすべてのブラウザーで実行されます。

ツールとサポート

Seleniumの必要最小限な設計アプローチは、より大きなアプリケーションのコンポーネントとして含まれる汎用性を提供します。 Seleniumの包括的なプロジェクトの下で提供される周辺インフラストラクチャは、ブラウザーのgridをまとめるためのツールを提供し、さまざまなブラウザーやさまざまなマシンの複数のオペレーティングシステムでテストを実行できるようにします。

サーバールームやデータセンター内の一連のコンピューターがすべて同時にブラウザーを起動して、サイトのリンク、フォーム、テーブルにアクセスし、1日24時間アプリケーションをテストしていると想像してください。最も一般的な言語用に提供されているシンプルなプログラミングインターフェイスを介して、これらのテストは並行して休むことなく実行され、エラーが発生するとレポートが返されます。

ブラウザーを制御するだけでなく、そのようなgridを簡単に拡張および展開できるようにするためのツールとドキュメントをユーザーに提供することで、これを実現するお手伝いをするのが目的です。

誰がSeleniumを利用するのか

世界で最も重要な企業の多くは、ブラウザベースのテストに Seleniumを採用しており、多くの場合、他の独自ツールを使用した長年にわたる取り組みに取って代わりました。人気が高まるにつれて、その要件と課題も倍増しています。

ウェブがより複雑になり、新しいテクノロジーがウェブサイトに追加されるにつれて、可能な限りそれらに遅れずについていくことがこのプロジェクトの使命です。オープンソースプロジェクトであるため、このサポートは多くのボランティアからの惜しみない時間の寄付によって提供されます。

このプロジェクトのもう1つの使命は、より多くのボランティアがこの取り組みに参加することを奨励し、強力なコミュニティを構築して、プロジェクトが新しいテクノロジに対応し続け、機能テスト自動化の主要なプラットフォームであり続けることができるようにすることです。

Grid エンドポイント

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

Grid

Grid ステータス

Grid ステータスは Grid の現在の状態を提供します。登録されている全てのノードの詳細で構成されます。各ノードのステータスには、ノードの稼働状況、セッション、およびスロットに関する情報が含まれます。

curl --request GET 'http://localhost:4444/status'

セッションの削除

セッションを削除すると、WebDriver セッションが終了し、ドライバがアクティブなセッションマップから削除されます。削除されたセッション ID を使用するリクエストや、ドライバのインスタンスを再利用しようとすると、エラーとなります。

curl --request DELETE 'http://localhost:4444/session/<session-id>'

Which URL should I use?

スタンドアロンモードでは、Grid URL はスタンドアロンサーバーのアドレスになります。

ハブ&ノードモードでは、Grid URL はハブのアドレスになります。

完全分散モードでは、Grid URL はルーターのアドレスになります。

上記すべてのモードのデフォルトの URL は http://localhost:4444 です。

ディストリビューター

ノード削除

ノードを Grid から削除するには、以下の curl コマンドを使用します。このコマンドは、そのノード上で実行中のセッションを停止させるものではありません。ノードは明示的に強制終了されない限り、そのまま動作し続けます。ディストリビューターはそのノードを認識しなくなるため、マッチする新しいセッションのリクエストははその Node に転送されません。

スタンドアロンモードでは、ディストリビューターの URL はスタンドアロンサーバーのアドレスとなります。

ハブ&ノードモードでは、ディストリビューターの URL はハブのアドレスになります。

curl --request DELETE 'http://localhost:4444/se/grid/distributor/node/<node-id>' --header 'X-REGISTRATION-SECRET: <secret> '

完全分散モードでは、ディストリビューター URL はディストリビューターのアドレスになります。

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

HTTPレスポンスコード

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

Selenium RCの一部のブラウザー構成では、Seleniumはブラウザーと自動化されているサイトの間のプロキシとして機能しました。これは、Seleniumを通過したすべてのブラウザートラフィックをキャプチャまたは操作できることを意味していました。 captureNetworkTraffic() メソッドは、HTTPレスポンスコードを含むブラウザーと自動化されているサイト間のすべてのネットワークトラフィックをキャプチャすることを目的としています。

Selenium WebDriverは、ブラウザーの自動化に対するまったく異なるアプローチであり、ユーザーのように振る舞うことを好むため、WebDriverを使用してテストを記述する方法で表現します。自動化された機能テストでは、ステータスコードの確認はテストの失敗の特に重要な詳細ではありません。それに先行する手順がより重要です。

ブラウザーは常にHTTPステータスコードを表します。たとえば、404または500エラーページを想像してください。これらのエラーページの1つに遭遇したときに"早く失敗"する簡単な方法は、ページが読み込まれるたびにページタイトルまたは信頼できるポイント（たとえば <h1> タグ）のコンテンツをチェックすることです。ページオブジェクトモデルを使用している場合、このチェックをクラスコンストラクターまたはページの読み込みが予想される同様のポイントに含めることができます。場合によっては、HTTPコードがブラウザーのエラーページに表示されることもあります。 WebDriverを使用してこれを読み取り、デバッグ出力を改善できます。

Webページ自体を確認することは、WebDriverの理想的なプラクティスに沿っており、WebDriverのユーザーのWebサイトの見え方を表現し、主張します。

HTTPステータスコードをキャプチャするための高度なソリューションは、プロキシを使用してSelenium RCの動作を複製することです。 WebDriver APIは、ブラウザーのプロキシを設定する機能を提供します。 Webサーバーとの間で送受信されるリクエストのコンテンツをプログラムで操作できるプロキシがいくつかあります。プロキシを使用すると、リダイレクトレスポンスコードへの応答方法を決めることができます。さらに、すべてのブラウザーがWebDriverでレスポンスコードを利用できるようにするわけではないため、プロキシを使用することを選択すると、すべてのブラウザーで機能するソリューションが得られます。

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

ページオブジェクトモデル

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

Note: this page has merged contents from multiple sources, including the Selenium wiki

Overview

Within your web app’s UI, there are areas where your tests interact with. A Page Object only models these as objects within the test code. This reduces the amount of duplicated code and means that if the UI changes, the fix needs only to be applied in one place.

Page Object Model is a Design Pattern that has become popular in test automation for enhancing test maintenance and reducing code duplication. A page object is an object-oriented class that serves as an interface to a page of your AUT. The tests then use the methods of this page object class whenever they need to interact with the UI of that page. The benefit is that if the UI changes for the page, the tests themselves don’t need to change, only the code within the page object needs to change. Subsequently, all changes to support that new UI are located in one place.

色を扱う

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

テストの一部として何かの色を検証したい場合があります。問題は、ウェブ上の色の定義が一定ではないことです。色のHEX表現を色のRGB表現と比較する簡単な方法、または色のRGBA表現を色のHSLA表現と比較する簡単な方法があったらいいのではないでしょうか？

心配しないでください。解決策があります。: Color クラスです！

まず、クラスをインポートする必要があります。

import org.openqa.selenium.support.Color;

from selenium.webdriver.support.color import Color

// This feature is not implemented - Help us by sending a pr to implement this feature

include Selenium::WebDriver::Support

// This feature is not implemented - Help us by sending a pr to implement this feature

import org.openqa.selenium.support.Color

これで、カラーオブジェクトの作成を開始できます。すべての色オブジェクトは、色の文字列表現から作成する必要があります。サポートされている色表現は、以下のとおりです。

Chrome固有の機能

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

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

Options

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

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

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

 System.clearProperty(ChromeDriverService.CHROME_DRIVER_LOG_LEVEL_PROPERTY);
 }

View Complete Code View on GitHub

 options = get_default_chrome_options()
 driver = webdriver.Chrome(options=options)

View Complete Code View on GitHub

 {
 var options = new ChromeOptions();

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:

Unable to Locate Driver Error

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

Historically, this is the most common error beginning Selenium users get when trying to run code for the first time:

The path to the driver executable must be set by the webdriver.chrome.driver system property; for more information, see https://chromedriver.chromium.org/. The latest version can be downloaded from https://chromedriver.chromium.org/downloads

The executable chromedriver needs to be available in the path.

The file geckodriver does not exist. The driver can be downloaded at https://github.com/mozilla/geckodriver/releases"

Unable to locate the chromedriver executable;

Likely cause

Through WebDriver, Selenium supports all major browsers. In order to drive the requested browser, Selenium needs to send commands to it via an executable driver. This error means the necessary driver could not be found by any of the means Selenium attempts to use.

Gmail、Eメール、Facebookログイン

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

複数の理由から、WebDriverを使用してGmailやFacebookなどのサイトにログインすることはお勧めしません。これらのサイトの使用条件（アカウントがシャットダウンされるリスクがある）に違反することは別として、それは遅く、信頼性がありません。

理想的なプラクティスは、メールプロバイダーが提供するAPIを使用すること、またはFacebookの場合、テストアカウントや友人などを作成するためのAPIを公開する開発者ツールサービスを使用することです。 APIの使用は少し大変な作業のように思えるかもしれませんが、速度、信頼性、および安定性に見返りがあります。また、APIが変更されることはほとんどありませんが、WebページとHTMLロケーターは頻繁に変更され、テストフレームワークを更新する必要があります。

テストの任意の時点でWebDriverを使用してサードパーティのサイトにログインすると、テストが長くなるため、テストが失敗するリスクが高くなります。一般的な経験則として、テストが長くなるほど脆弱で信頼性が低くなります。

W3C準拠のWebDriver実装は、サービス拒否攻撃を軽減できるように、navigatorオブジェクトにWebDriverプロパティで注釈を付けます。

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

Mouse actions

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

There are only 3 actions that can be accomplished with a mouse: pressing down on a button, releasing a pressed button, and moving the mouse. Selenium provides convenience methods that combine these actions in the most common ways.

Click and hold

This method combines moving the mouse to the center of an element with pressing the left mouse button. This is useful for focusing a specific element:

 WebElement clickable = driver.findElement(By.id("clickable"));
 new Actions(driver)
 .clickAndHold(clickable)
 .perform();

View Complete Code View on GitHub

 clickable = driver.find_element(By.ID, "clickable")
 ActionChains(driver) \
 .click_and_hold(clickable) \
 .perform()

View Complete Code View on GitHub

 IWebElement clickable = driver.FindElement(By.Id("clickable"));
 new Actions(driver)
 .ClickAndHold(clickable)
 .Perform();

View Complete Code View on GitHub

 clickable = driver.find_element(id: 'clickable')
 driver.action
 .click_and_hold(clickable)
 .perform

View Complete Code View on GitHub

 let clickable = driver.findElement(By.id("clickable"));
 const actions = driver.actions({async: true});
 await actions.move({origin: clickable}).press().perform();

View Complete Code View on GitHub

 .clickAndHold(clickable)
 .perform()

 Assertions.assertEquals("focused", driver.findElement(By.id("click-status")).getText())

View Complete Code View on GitHub

Click and release

This method combines moving to the center of an element with pressing and releasing the left mouse button. This is otherwise known as “clicking”:

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

いつGridを使用すべきか

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

Grid をいつ使うべきでしょうか？

複数のブラウザー、異なるタイプまたは異なるバージョンのブラウザー、あるいは異なる OS 上でで実行されているブラウザーに対して並列でテストを実行したい場合
テストスイートの実行時間を減らしたい場合

Selenium Grid はノードと呼ばれる複数のマシンを使用して並列でテストスイートを実行します。大規模な長時間実行されるテストでは数分から数時間、あるいは数日単位での短縮が可能です。つまり、あなたのテスト対象のアプリケーションのテスト結果を得るまでの時間を短縮します。

Grid は複数の異なるブラウザーに対してテストを実行でき、また同じブラウザーインスタンスに対して複数のテストを実行することも可能です。たとえば 6 つのノードで構成された Grid があるとします。最初のマシンは FireFox の最新バージョン、2 つめは FireFox の最新から一つ前のバージョン、 3 つめは最新の Chrome、そして残りは Mac Mini で最新の Safari を使って 3 つのテストを並行して実行することができます。

実行時間は簡単な式で表すことができます:

テストの数 * 平均テスト時間 / ノード数 = 合計実行時間

 15 * 45s / 1 = 11m 15s // Grid なし
 15 * 45s / 5 = 2m 15s // 5 ノードの Grid
 15 * 45s / 15 = 45s // 15 ノードの Grid
 100 * 120s / 15 = 13m 20s // Grid なしの場合3時間以上かかります

テストスイートが実行されると Grid はテストで設定されたブラウザに対して実行するテストを割り当てます。

クッキーの使用

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

Cookieは、Webサイトから送信され、コンピューターに保存される小さなデータです。 Cookieは、主にユーザーを認識し、保存されている情報を読み込むために使用されます。

WebDriver APIは、組み込みメソッドでCookieと対話するメソッドを提供します。

クッキーの追加

現在のブラウジングコンテキストにCookieを追加するために使用されます。 Cookieの追加では、一連の定義済みのシリアル化可能なJSONオブジェクトのみを受け入れます。受け入れられたJSONキー値のリストへのリンクはこちらにあります。

まず、Cookieが有効になるドメインにいる必要があります。サイトとの対話を開始する前にCookieを事前設定しようとしていて、ホームページが大きい場合/代替の読み込みに時間がかかる場合は、サイトで小さいページを見つけることです。（通常、たとえば http://example.com/some404page のような、404ページは小さいです。）


 WebDriver driver = new ChromeDriver();

View Complete Code View on GitHub

 driver = webdriver.Chrome()
 driver.get("http://www.example.com")

 # Adds the cookie into current browser context
 driver.add_cookie({"name": "key", "value": "value"})

View Complete Code View on GitHub

 driver.Url="https://www.selenium.dev/selenium/web/blank.html";
 // Add cookie into current browser context
 driver.Manage().Cookies.AddCookie(new Cookie("key", "value"));

View Complete Code View on GitHub

 driver.navigate.to 'https://www.selenium.dev/selenium/web/blank.html'
 # Add cookie into current browser context
 driver.manage.add_cookie(name: 'key', value: 'value')

View Complete Code View on GitHub

 await driver.get('https://www.selenium.dev/selenium/web/blank.html');

View Complete Code View on GitHub

import org.openqa.selenium.Cookie
import org.openqa.selenium.chrome.ChromeDriver

fun main() {
 val driver = ChromeDriver()
 try {
 driver.get("https://example.com")

 // Adds the cookie into current browser context
 driver.manage().addCookie(Cookie("key", "value"))
 } finally {
 driver.quit()
 }
}

命名されたクッキーの取得

関連付けられているすべてのCookieの中で、Cookie名と一致するシリアル化されたCookieデータを返します。

ドメイン固有言語（DSL）

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

ドメイン固有言語（DSL）は、問題を解決するための表現手段をユーザーに提供するシステムです。それによって、ユーザーは、プログラマーの言葉でなく、自分の言葉でシステムとやりとりすることができます。

通常、ユーザーはサイトの外観を気にしません。装飾、アニメーション、グラフィックスは気にしません。彼らはあなたのシステムを使用して、新しい従業員を最小限の難しさでプロセスに押し込みたいと考えています。彼らはアラスカへの旅行を予約したい。ユニコーンを設定して割引価格で購入したいのです。テスターとしてのあなたの仕事は、この考え方を"とらえる"ことにできるだけ近づくことです。それを念頭に置いて、テストスクリプト（ユーザーの唯一のプレリリースの代理人）がユーザーを"代弁し"、表現するように、作業中のアプリケーションの"モデリング"に取り掛かります。

Seleniumでは、DSLは通常、APIをシンプルで読みやすいように記述したメソッドで表されます。開発者と利害関係者（ユーザー、製品所有者、ビジネスインテリジェンススペシャリストなど）との伝達が可能になります。

利点

Readable: ビジネス関係者はそれを理解できます。
Writable: 書きやすく、不要な重複を避けます。
Extensible: 機能は（合理的に）契約と既存の機能を壊すことなく追加できます。
Maintainable: 実装の詳細をテストケースから除外することにより、AUT* の変更に対して十分に隔離されます。

Java

Javaの妥当なDSLメソッドの例を次に示します。簡潔にするために、driverオブジェクトが事前に定義されており、メソッドで使用可能であることを前提としています。

/**
 * Takes a username and password, fills out the fields, and clicks "login".
 * @return An instance of the AccountPage
 */
public AccountPage loginAsUser(String username, String password) {
 WebElement loginField = driver.findElement(By.id("loginField"));
 loginField.clear();
 loginField.sendKeys(username);

 // Fill out the password field. The locator we're using is "By.id", and we should
 // have it defined elsewhere in the class.
 WebElement passwordField = driver.findElement(By.id("password"));
 passwordField.clear();
 passwordField.sendKeys(password);

 // Click the login button, which happens to have the id "submit".
 driver.findElement(By.id("submit")).click();

 // Create and return a new instance of the AccountPage (via the built-in Selenium
 // PageFactory).
 return PageFactory.newInstance(AccountPage.class);
}

このメソッドは、テストコードから入力フィールド、ボタン、クリック、さらにはページの概念を完全に抽象化します。このアプローチを使用すると、テスターはこのメソッドを呼び出すだけで済みます。これにより、メンテナンスの利点が得られます。ログインフィールドが変更された場合、テストではなく、このメソッドを変更するだけで済みます。

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.

独自のグリッドを設定する

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

Selenium Gridを使用するには、ノード用の独自のインフラストラクチャを維持する必要があります。これは面倒で時間のかかる作業になる可能性があるため、多くの組織はこのインフラストラクチャを提供するためにAmazon EC2やGoogle ComputeなどのIaaSプロバイダーを使用しています。

他の選択肢として、クラウドのサービスとしてSelenium Gridを提供するSauce LabsやTesting Botなどのプロバイダーの使うこともできます。独自のハードウェアでノードを実行することも確かに可能です。この章では、独自のノードインフラストラクチャを備えた独自のグリッドを実行するオプションについて詳しく説明します。

クイックスタート

この例では、Selenium 2グリッドハブを起動し、WebDriverノードとSelenium 1 RCレガシーノードの両方を登録する方法を示します。また、Javaからグリッドを呼び出す方法も示します。ここでは、ハブとノードが同じマシンで実行されていますが、もちろん、selenium-server-standaloneを複数のマシンにコピーできます。

selenium-server-standaloneパッケージには、グリッドの実行に必要なハブ、WebDriver、およびレガシーRCが含まれています。 ant はもう必要ありません。 selenium-server-standalone.jarは https://selenium.dev/downloads/ からダウンロードできます。

ステップ1：ハブを開始する

ハブは、テストリクエストを受信し、それらを適切なノードに配布する中心点です。配布は機能ベースで行われます。つまり、一連の機能を必要とするテストは、その機能セットまたは機能のサブセットを提供するノードにのみ配布されます。

テストのDesiredCapabilitiesは、 任意の を意味するため、ハブはDesiredCapabilitiesの設定に完全に一致するノードを見つけることを保証できません。

コマンドプロンプトを開き、selenium-server-standalone.jarファイルをコピーしたディレクトリに移動します。ハブを起動するには、-role hubフラグをスタンドアロンサーバーに渡します。

java -jar selenium-server-standalone.jar -role hub

ハブはデフォルトでポート4444をリッスンします。ブラウザーウィンドウを開いて http://localhost:4444/grid/console に移動すると、ハブのステータスを表示できます。

デフォルトのポートを変更するには、コマンドを実行するときにリッスンするポートを表す整数を持つオプションの -port フラグを追加できます。また、JSON構成ファイル（以下を参照）に表示される他のすべてのオプションは、可能なコマンドラインフラグです。

確かに上記の簡単なコマンドだけでうまくいくことができますが、より高度な構成が必要な場合は、JSON形式の構成ファイルを指定して、開始時にハブを構成することもできます。 JSON形式の構成ファイルを指定して開始時にハブを構成する方法は以下のとおりです。

java -jar selenium-server-standalone.jar -role hub -hubConfig hubConfig.json -debug

以下に、 hubConfig.json ファイルの例を示します。ステップ2でノード構成ファイルを提供する方法について詳しく説明します。

{
 "_comment" : "Configuration for Hub - hubConfig.json",
 "host": ip,
 "maxSession": 5,
 "port": 4444,
 "cleanupCycle": 5000,
 "timeout": 300000,
 "newSessionWaitTimeout": -1,
 "servlets": [],
 "prioritizer": null,
 "capabilityMatcher": "org.openqa.grid.internal.utils.DefaultCapabilityMatcher",
 "throwOnCapabilityNotPresent": true,
 "nodePolling": 180000,
 "platform": "WINDOWS"}

ステップ2：ノードを起動する

新しいWebDriver機能を備えたグリッドを実行するか、Selenium 1 RC機能を備えたグリッドを実行するか、または両方を同時に実行するかに関係なく、同じ selenium-server-standalone.jar ファイルを使用してノードを起動します。

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 = get_default_edge_options()

View Complete Code View on GitHub

 {
 var options = new EdgeOptions();

View Complete Code View on GitHub

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

View Complete Code View on GitHub

 let options = new edge.Options();
 driver = new Builder()
 .forBrowser(Browser.EDGE)
 .setEdgeOptions(options)
 .build();

View Complete Code View on GitHub

Add Example

Selenium

Browsing Context

Commands

Open a new window

Browsing Context

Perform Actions

CAPTCHA（キャプチャ）

Waiting with Expected Conditions

WebDriver BiDi Logging Features

Console Message Handlers

Add Handler

WebDriver BiDi Network Features

Authentication Handlers

Network

Commands

Add network intercept

WebDriver BiDi Script Features

Script Pinning

Execute Script

DOM Mutation Handlers

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

可観測性

目次

Selenium Grid

可観測性

分散トレーシング

イベントロギング

Grid の可観測性

構成ヘルプ

Info コマンド

構成ヘルプ

セキュリティ

セッションマップの設定

OpenTelemetry と Jaeger を使用したトレースの設定

SeleniumGrid コマンドを一覧表示する

コンポーネントヘルプコマンド

スタンドアロン

ハブ

セッション

新規セッションキュー

ディストリビューター

ルーター

ノード

著作権と帰属

Seleniumのドキュメント

帰属

Thanks to:

Selenium メイン Repository

Selenium IDE

Docker Selenium

Selenium Website & Docs

Previous Selenium Website

Previous Documentation Rewrite Project

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