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

テストの生成

はじめに

Playwright には、すぐに使えるテスト生成機能が付属しており、テストをすぐに始めるための優れた方法です。 これは、テストしたいウェブサイトを操作するブラウザウィンドウと、テストの記録、テストのコピー、テストのクリア、およびテストの言語の変更が可能な Playwright Inspector ウィンドウの 2 つのウィンドウを開きます。

学習内容

Codegen の実行

codegen コマンドを使用してテストジェネレーターを実行し、その後にテストを生成したいウェブサイトの URL を続けます。 URL はオプションであり、URL なしでコマンドを実行し、代わりにブラウザウィンドウに URL を直接追加することも常に可能です。

pwsh bin/Debug/net8.0/playwright.ps1 codegen demo.playwright.dev/todomvc

テストの記録

codegen を実行し、ブラウザでアクションを実行します。 Playwright は、ユーザーインタラクションのコードを生成します。 Codegen は、レンダリングされたページを見て、推奨されるロケーターを把握し、role、text、および test id ロケーターを優先します。 ジェネレーターがロケーターに一致する複数の要素を識別した場合、ロケーターを改善して、ターゲット要素を回復力があり一意に識別できるようにし、その結果、ロケーターが原因でテストの失敗や不安定さを排除および軽減します。

テストジェネレーターで記録できるもの

  • ページを操作するだけで、クリックや入力などのアクション
  • ツールバーのアイコンの 1 つをクリックし、ページ上の要素をクリックしてアサートすることで、アサーションを実行できます。 次のものを選択できます
    • 'assert visibility' は、要素が表示されていることをアサートします
    • 'assert text' は、要素に特定のテキストが含まれていることをアサートします
    • 'assert value' は、要素に特定の値があることをアサートします

recording a test

ページとのインタラクションが完了したら、'record' ボタンを押して記録を停止し、'copy' ボタンを使用して生成されたコードをエディターにコピーします。

'clear' ボタンを使用してコードをクリアし、記録を再度開始します。 完了したら、Playwright インスペクターウィンドウを閉じるか、ターミナルコマンドを停止します。

テストの生成の詳細については、Codegen に関する詳細ガイドをご覧ください。

ロケーターの生成

テストジェネレーターでロケーターを生成できます。

  • 'Record' ボタンを押して記録を停止すると、'Pick Locator' ボタンが表示されます。
  • 'Pick Locator' ボタンをクリックし、ブラウザウィンドウ内の要素にカーソルを合わせると、各要素の下にロケーターが強調表示されます。
  • ロケーターを選択するには、特定したい要素をクリックすると、そのロケーターのコードが [Pick Locator] ボタンの横のロケータープレイグラウンドに表示されます。
  • 次に、ロケータープレイグラウンドでロケーターを編集して微調整し、一致する要素がブラウザウィンドウで強調表示されるのを確認できます。
  • コピーボタンを使用してロケーターをコピーし、コードに貼り付けます。

picking a locator

エミュレーション

エミュレーションを使用してテストを生成することもできます。これにより、特定のビューポート、デバイス、配色、および地理位置情報、言語、またはタイムゾーンをエミュレートするためのテストを生成できます。 テストジェネレーターは、認証された状態を維持しながらテストを生成することもできます。 詳細については、テストジェネレーターガイドをご覧ください。

次のステップ