メインコンテンツにスキップ

ドライバーバイナリ

WebDriverプロトコルに基づく自動化を実行するには、自動化コマンドを変換してブラウザで実行できるブラウザドライバーが必要です。

自動セットアップ​

WebdriverIO v8.14以降では、WebdriverIOがブラウザドライバーを自動的に処理するため、手動でダウンロードしてセットアップする必要はありません。テストしたいブラウザを指定するだけで、残りはWebdriverIOが行います。

自動化レベルのカスタマイズ​

WebdriverIOには3つの自動化レベルがあります：

1. @puppeteer/browsersを使用してブラウザをダウンロードしインストールする。

capabilities設定でbrowserName/browserVersionの組み合わせを指定すると、マシンに既存のインストールがあるかどうかに関係なく、WebdriverIOはリクエストされた組み合わせをダウンロードしてインストールします。browserVersionを省略すると、WebdriverIOは最初にlocate-appを使用して既存のインストールを見つけて使用しようとし、見つからない場合は現在の安定版ブラウザリリースをダウンロードしてインストールします。browserVersionの詳細については、こちらを参照してください。

注意

自動ブラウザセットアップはMicrosoft Edgeをサポートしていません。現在、Chrome、Chromium、Firefoxのみがサポートされています。

WebdriverIOによって自動検出できない場所にブラウザがインストールされている場合は、ブラウザバイナリを指定することができます。これにより自動ダウンロードとインストールが無効になります。

{
    capabilities: [
        {
            browserName: 'chrome', // または 'firefox' や 'chromium'
            'goog:chromeOptions': { // または 'moz:firefoxOptions' や 'wdio:chromedriverOptions'
                binary: '/path/to/chrome'
            },
        }
    ]
}

2. Chromedriver、Edgedriver、Geckodriverを使用してドライバーをダウンロードしインストールする。

設定でドライバーのbinaryが指定されていない限り、WebdriverIOは常にこれを行います：

{
    capabilities: [
        {
            browserName: 'chrome', // または 'firefox'、'msedge'、'safari'、'chromium'
            'wdio:chromedriverOptions': { // または 'wdio:geckodriverOptions'、'wdio:edgedriverOptions'
                binary: '/path/to/chromedriver' // または 'geckodriver'、'msedgedriver'
            }
        }
    ]
}
情報

WebdriverIOはSafariドライバーを自動的にダウンロードしません。それはすでにmacOSにインストールされているためです。

注意

ブラウザのbinaryを指定して対応するドライバーのbinaryを省略したり、その逆をしたりすることは避けてください。binary値の片方だけが指定されている場合、WebdriverIOはそれと互換性のあるブラウザ/ドライバーを使用またはダウンロードしようとします。ただし、一部のシナリオでは互換性のない組み合わせになる可能性があります。したがって、バージョンの非互換性による問題を避けるため、常に両方を指定することをお勧めします。

3. ドライバーの起動/停止。

デフォルトでは、WebdriverIOは未使用のポートを使用して自動的にドライバーを起動および停止します。以下の設定のいずれかを指定すると、この機能は無効になり、手動でドライバーを起動および停止する必要があります：

手動セットアップ​

以下では、各ドライバーを個別にセットアップする方法について説明します。すべてのドライバーのリストはawesome-selenium READMEで確認できます。

ヒント

モバイルやその他のUIプラットフォームをセットアップする場合は、Appium Setupガイドをご覧ください。

Chromedriver​

Chromeを自動化するには、プロジェクトウェブサイトから直接Chromedriverをダウンロードするか、NPMパッケージを通じてダウンロードできます：

npm install -g chromedriver

その後、次のように起動できます：

chromedriver --port=4444 --verbose

Geckodriver​

Firefoxを自動化するには、お使いの環境に合わせた最新バージョンのgeckodriverをダウンロードし、プロジェクトディレクトリに展開します：

npm install geckodriver

注意： 他のgeckodriverリリースはこちらで入手できます。ダウンロード後、次のようにドライバーを起動できます：

/path/to/binary/geckodriver --port 4444

Edgedriver​

Microsoft Edge用のドライバーはプロジェクトウェブサイトからダウンロードするか、NPMパッケージとして次のようにインストールできます：

npm install -g edgedriver
edgedriver --version # 出力: Microsoft Edge WebDriver 115.0.1901.203 (a5a2b1779bcfe71f081bc9104cca968d420a89ac)

Safaridriver​

SafaridriverはMacOSにプリインストールされており、次のように直接起動できます：

safaridriver -p 4444

Welcome! How can I help?

WebdriverIO AI Copilot