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

テストの生成

はじめに​

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

学習内容

Codegenの実行​

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

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

テストの記録​

codegenを実行し、ブラウザでアクションを実行します。Playwrightは、ユーザー操作のコードを生成します。Codegenはレンダリングされたページを見て、ロール、テキスト、テストIDのロケーターを優先して、推奨されるロケーターを特定します。ジェネレーターがロケーターに一致する複数の要素を識別した場合、ロケーターを改善して堅牢にし、ターゲット要素を一意に識別するようにします。これにより、ロケーターによるテストの失敗や不安定さを排除・削減します。

テストジェネレーターを使用すると、以下を記録できます。

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

recording a test

​

ページの操作が終了したら、'record'ボタンを押して記録を停止し、'copy'ボタンを使用して生成されたコードをエディターにコピーします。

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

テストの生成についてさらに詳しく知るには、Codegenに関する詳細ガイドを参照してください。

ロケーターの生成​

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

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

picking a locator

エミュレーション​

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

次へ​