テストの生成
はじめに
Playwrightにはテストをすぐに生成する機能が搭載されており、テストを素早く始めるのに最適な方法です。ブラウザウィンドウ (テストしたいウェブサイトを操作する場所) とPlaywrightインスペクターウィンドウ (テストの記録、コピー、クリア、言語の変更ができる場所) の2つのウィンドウが開きます。
学習内容
Codegenの実行
テストを生成したいウェブサイトのURLの後に`codegen`コマンドを使用してテストジェネレーターを実行します。URLはオプションであり、URLなしでコマンドを実行し、後からブラウザウィンドウに直接URLを追加することもできます。
mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="codegen demo.playwright.dev/todomvc"
テストの記録
`codegen`を実行し、ブラウザでアクションを実行します。Playwrightはユーザーインタラクションのコードを生成します。`Codegen`はレンダリングされたページを解析し、役割、テキスト、テストIDロケーターを優先して推奨されるロケーターを特定します。ジェネレーターがロケーターに一致する複数の要素を識別した場合、ロケーターを改善して、堅牢性を高め、ターゲット要素を一意に識別できるようにします。これにより、ロケーターに起因するテストの失敗や不安定性を排除・軽減します。
テストジェネレーターを使用すると、以下を記録できます。
- ページを操作するだけで、クリックや入力などのアクション
- ツールバーのアイコンの1つをクリックし、次にページ上の要素をクリックしてアサーションを行うことで、アサーションを記録できます。以下を選択できます：
- `'assert visibility'` (要素が表示されていることをアサート)
- `'assert text'` (要素に特定のテキストが含まれていることをアサート)
- `'assert value'` (要素に特定の値があることをアサート)
ページ操作を終えたら、`'record'`ボタンを押して記録を停止し、`'copy'`ボタンを使用して生成されたコードをエディターにコピーします。
`'clear'`ボタンを使用してコードをクリアし、再度記録を開始します。終了したら、Playwrightインスペクターウィンドウを閉じるか、ターミナルコマンドを停止します。
テストの生成についてさらに詳しく知るには、Codegenの詳細ガイドを参照してください。
ロケーターの生成
テストジェネレーターを使用してロケーターを生成できます。
- `'Record'`ボタンを押して記録を停止すると、`'Pick Locator'`ボタンが表示されます。
- `'Pick Locator'`ボタンをクリックし、次にブラウザウィンドウ内の要素にカーソルを合わせると、各要素の下にロケーターがハイライト表示されます。
- ロケーターを選択するには、目的の要素をクリックすると、そのロケーターのコードがPick Locatorボタンの横にあるロケータープレイグラウンドに表示されます。
- その後、ロケータープレイグラウンドでロケーターを編集して微調整し、一致する要素がブラウザウィンドウでハイライト表示されるのを確認できます。
- コピーボタンを使用してロケーターをコピーし、コードに貼り付けます。
エミュレーション
エミュレーションを使用してテストを生成することもでき、特定のビューポート、デバイス、カラースキーム用のテストを生成したり、ジオロケーション、言語、タイムゾーンをエミュレートしたりできます。テストジェネレーターは、認証された状態を維持しながらテストを生成することも可能です。テストジェネレーターガイドで詳細を確認してください。