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

はじめに

WebdriverIOドキュメントへようこそ。このドキュメントは、素早く始めるのに役立ちます。問題が発生した場合は、Discord サポートサーバーで助けを求めたり、Twitterで連絡することもできます。

情報

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

公式YouTubeチャンネル 🎥

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

WebdriverIOセットアップを開始する​

既存または新しいプロジェクトにWebdriverIO Starter Toolkitを使用して完全なWebdriverIOセットアップを追加するには、次のコマンドを実行します：

既存のプロジェクトのルートディレクトリにいる場合は、次のように実行します：

npm init wdio@latest .

または、新しいプロジェクトを作成したい場合：

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

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

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

npm init wdio@latest . -- --yes

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

CLIパッケージを以下のように手動でプロジェクトに追加することもできます：

npm i --save-dev @wdio/cli
npx wdio --version # 例えば `8.13.10` などを表示します

# 設定ウィザードを実行
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を直接インストールしてパッケージとして使用することもできます。例えば、ウェブサイトのスクリーンショットを生成する場合：

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

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

テストを記録する​

WebdriverIOは、画面上でのテストアクションを記録し、WebdriverIOテストスクリプトを自動生成するためのツールを提供しています。詳細はChrome DevTools Recorderを使用したテスト記録をご覧ください。

システム要件​

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

  • 最も古いアクティブなLTSバージョンであるv18.20.0以上をインストールしてください
  • 公式にサポートされているのは、現在LTSリリースであるか、将来LTSリリースになるバージョンのみです

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

Welcome! How can I help?

WebdriverIO AI Copilot