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

スタートガイド

WebdriverIOのドキュメントへようこそ。すぐに使い始めることができます。問題が発生した場合は、Discordサポートサーバーでヘルプと回答を見つけることができます。または、Twitterで私に連絡することもできます。

情報

これはWebdriverIOの最新バージョン（>=8.x）のドキュメントです。古いバージョンをまだ使用している場合は、過去のドキュメントWebサイトをご覧ください。

公式YouTubeチャンネル 🎥

WebdriverIOに関するその他の動画は、公式YouTubeチャンネルでご覧いただけます。チャンネル登録をお忘れなく！

WebdriverIOセットアップの開始​

WebdriverIOスターターツールキットを使用して、既存または新規のプロジェクトにWebdriverIOのフルセットアップを追加するには、次のコマンドを実行します。

既存のプロジェクトのルートディレクトリにいる場合は、次のコマンドを実行します。

npm init wdio@latest .

または、新しいプロジェクトを作成する場合は、次のコマンドを実行します。

npm init wdio@latest ./path/to/new/project

この単一のコマンドは、WebdriverIO CLIツールをダウンロードし、テストスイートの設定に役立つ設定ウィザードを実行します。

ウィザードは、セットアップをガイドする一連の質問をプロンプト表示します。 --yesパラメータを渡すと、ページオブジェクトパターンを使用してChromeでMochaを使用するデフォルト設定を選択できます。

npm init wdio@latest . -- --yes

CLIを手動でインストールする​

CLIパッケージは、次のコマンドを使用してプロジェクトに手動で追加することもできます。

npm i --save-dev @wdio/cli
npx wdio --version # prints e.g. `8.13.10`

# run configuration wizard
npx wdio config

テストを実行する​

runコマンドを使用して、作成したWebdriverIO設定ファイルを指定することで、テストスイートを開始できます。

npx wdio run ./wdio.conf.js

特定のテストファイルを実行する場合は、--specパラメータを追加できます。

npx wdio run ./wdio.conf.js --spec example.e2e.js

または、設定ファイルでスイートを定義し、スイートで定義されたテストファイルのみを実行します。

npx wdio run ./wdio.conf.js --suite exampleSuiteName

スクリプトで実行する​

Node.JSスクリプト内でWebdriverIOをスタンドアロンモードの自動化エンジンとして使用する場合、WebdriverIOを直接インストールしてパッケージとして使用することもできます。たとえば、Webサイトのスクリーンショットを生成するには、次の手順を実行します。

getting-started/run-in-script.js
loading...

注：すべてのWebdriverIOコマンドは非同期であり、async/awaitを使用して適切に処理する必要があります。

テストを記録する​

WebdriverIOは、画面上のテストアクションを記録し、WebdriverIOテストスクリプトを自動的に生成することで、開始を支援するツールを提供します。詳細については、Chrome DevToolsレコーダーでテストを記録するを参照してください。

システム要件​

Node.jsがインストールされている必要があります。

  • v18.20.0以降をインストールしてください。これは、最も古いアクティブなLTSバージョンです。
  • LTSリリースであるか、LTSリリースになる予定のリリースのみが正式にサポートされています。

Nodeが現在システムにインストールされていない場合は、NVMまたはVoltaなどのツールを使用して、複数のアクティブなNode.jsバージョンの管理を支援することをお勧めします。NVMは一般的な選択肢ですが、Voltaも良い代替手段です。

ようこそ！何かお困りですか？

WebdriverIO AI Copilot