E2Eテストにおけるテストツールは大きく4つに分類できます。
- ナビゲーション
- ロケーター
- アクション
- アサーション(別名:マッチャー)
| 分類 | 役割 | 実装クラス |
| ナビゲーション | ページ遷移 | Page |
| ロケーター | ページ内の要素特定 | Page、Locator |
| アクション | ユーザー操作の再現 | Locator |
| アサーション | 結果確認 | LocatorAssertions、 PageAssertions |
1. ナビゲーション
ナビゲーションとはURLの操作です。
最も使うのが「goto()」メソッド。
awaitを付けると、ページの読み込みが完了し操作可能になるのを待ちます。
await page.goto('https://qakoremite.com/')2. ロケーター
ロケーターとは、ページ上の要素を見つける機能です。
書き方等はこちらを参考にしてください。
3. アクション
ユーザーの操作を再現するものです。
| 対応するロケーター | 使えるアクション | メソッド |
| テキストボックス | フォームをクリックする | press() |
| フォームに入力する | fill() | |
| フォームをからにする | clear() | |
| チェックボックス ラジオボタン | チェックを入れる | check() |
| チェクを外す | uncheck() | |
| セレクトボックスの選択 | 選択する | selectOption() |
| その他 | マウスをクリック | click() |
| フォーカス | focus() | |
| ファイルアップロード | setInputFiles() |
4. アサーション(別名:マッチャー)
選択された要素の状態が期待と一致しているかテストします。
Playwrightの公式ドキュメントでは「アサーション」となっていますが
Java Script界隈では「マッチャー」と呼ぶことが多いそうです。
まとめ
- ナビゲーション:URLに関するアクション
- ロケーター:ページ上の要素を見つける機能
- アクション:ユーザーの操作を再現するもの
- アサーション:結果確認
「ナビゲーション」でWEBサイトにアクセスし
「ロケーター」で操作するテキストボックスやボタンを探し出し
「アクション」でキーボード操作やファイル選択を行い
「アサーション(別名:マッチャー)」結果を確認する。
流れと用語をセットで覚えておきましょう。



