Playwright データ抽出と検証
データ抽出と検証は自動化テストの鍵であり、主に次のものを含みますページデータの取得、アサーション検証、スクリーンショットと録画、機能が正しいかどうかを検証できるだけでなく、デバッグや回帰テストに役立ちます。
要素情報の取得
テストではページ情報を読み取って検証する必要がよくあり、Playwright は豊富な API を提供しています。
1. テキスト内容の取得
例
// 単一要素のテキストを取得
const text = await page.textContent('#welcome');
console.log(text);
// 複数要素のテキストを取得
const items = await page.$$eval('.list-item', els => els.map(e => e.textContent));
console.log(items);
const text = await page.textContent('#welcome');
console.log(text);
// 複数要素のテキストを取得
const items = await page.$$eval('.list-item', els => els.map(e => e.textContent));
console.log(items);
2. 属性値の取得
const value = await page.getAttribute('#username', 'placeholder');
console.log(value); // "请输入用户名"
3. スタイル情報の取得
// 获取元素的 style 属性
const color = await page.$eval('#btn', el => getComputedStyle(el).color);
console.log(color);
4. 要素状態の確認
await page.isVisible('#dialog'); // 是否可见
await page.isHidden('#loading'); // 是否隐藏
await page.isEnabled('#submit'); // 是否可用
await page.isDisabled('#submit'); // 是否禁用
await page.isChecked('#agree'); // 复选框是否选中
アサーションと検証
Playwright は提供しています組み込みアサーションライブラリ(@playwright/test)、テストケースを書きやすくなります。
1. 組み込みアサーションメソッド
に@playwright/test中で、使用expectアサーションを行います。
例
import { test, expect } from '@playwright/test';
test('検証例', async ({ page }) => {
await page.goto('https://example.com');
// テキストアサーション
await expect(page.locator('h1')).toHaveText('Example Domain');
// 属性アサーション
await expect(page.locator('a')).toHaveAttribute('href', 'https://www.iana.org/domains/example');
// 可視性アサーション
await expect(page.locator('h1')).toBeVisible();
});
test('検証例', async ({ page }) => {
await page.goto('https://example.com');
// テキストアサーション
await expect(page.locator('h1')).toHaveText('Example Domain');
// 属性アサーション
await expect(page.locator('a')).toHaveAttribute('href', 'https://www.iana.org/domains/example');
// 可視性アサーション
await expect(page.locator('h1')).toBeVisible();
});
2. テキスト内容の検証
await expect(page.locator('#message')).toHaveText('登录成功');
await expect(page.locator('#username')).toHaveValue('testuser');
3. 要素状態の検証
await expect(page.locator('#submit')).toBeEnabled();
await expect(page.locator('#agree')).toBeChecked();
await expect(page.locator('#loading')).toBeHidden();
4. ページタイトルとURLの検証
await expect(page).toHaveTitle(/Playwright/);
await expect(page).toHaveURL('https://playwright.dev/');
スクリーンショットと録画
スクリーンショットと録画は、デバッグ、失敗ケースの分析、回帰テストで非常に役立ちます。
1. ページスクリーンショット
await page.screenshot({ path: 'screenshot.png', fullPage: true });
path: 保存パスfullPage: ページ全体をキャプチャするかどうか
2. 要素スクリーンショット
const element = page.locator('#logo');
await element.screenshot({ path: 'logo.png' });
3. ビデオ録画
作成時にcontext録画を有効にする:
const context = await browser.newContext({
recordVideo: { dir: 'videos/' }
});
const page = await context.newPage();
await page.goto('https://example.com');
await context.close(); // 关闭后保存视频
4. スクリーンショット比較(スナップショットテスト)
Playwright はスナップショット比較をサポートしており、回帰テストでよく使用されます。
import { test, expect } from '@playwright/test';
test('页面快照测试', async ({ page }) => {
await page.goto('https://playwright.dev');
expect(await page.screenshot()).toMatchSnapshot('homepage.png');
});
スクリーンショットを基準画像とhomepage.png比較して、UIの変化を検出します。
はい ✅ それでは、第6章:データ抽出と検証一つ補足する完全な実践例、そしてまとめるAPI対照表。これで実践もあり、すぐに表を参照できるようになります。
実践例 —— ログイン検証とスクリーンショットスナップショット
このケースには次のものが含まれます:情報抽出 + アサーション検証 + ページスクリーンショット。
例
// login-test.spec.js
import { test, expect } from '@playwright/test';
test('ユーザーログインと結果検証', async ({ page }) => {
// 1. ログインページを開く
await page.goto('https://example.com/login');
// 2. ユーザー名とパスワードを入力
await page.fill('#username', 'testuser');
await page.fill('#password', 'Password123');
// 3. ログインをクリック
await page.click('#submit');
// 4. 遷移を待ってタイトルを確認
await expect(page).toHaveTitle(/Dashboard/);
// 5. ウェルカムテキストを検証
await expect(page.locator('.welcome')).toHaveText('ようこそ、testuser');
// 6. ボタンの状態を確認
await expect(page.locator('#logout')).toBeVisible();
await expect(page.locator('#logout')).toBeEnabled();
// 7. ユーザーID属性を取得して検証
const userId = await page.getAttribute('#user-profile', 'data-id');
console.log('ユーザーID:', userId);
expect(userId).not.toBeNull();
// 8. ページスクリーンショット
await page.screenshot({ path: 'login-success.png', fullPage: true });
// 9. スナップショット比較(UI回帰テスト)
expect(await page.screenshot()).toMatchSnapshot('dashboard.png');
});
import { test, expect } from '@playwright/test';
test('ユーザーログインと結果検証', async ({ page }) => {
// 1. ログインページを開く
await page.goto('https://example.com/login');
// 2. ユーザー名とパスワードを入力
await page.fill('#username', 'testuser');
await page.fill('#password', 'Password123');
// 3. ログインをクリック
await page.click('#submit');
// 4. 遷移を待ってタイトルを確認
await expect(page).toHaveTitle(/Dashboard/);
// 5. ウェルカムテキストを検証
await expect(page.locator('.welcome')).toHaveText('ようこそ、testuser');
// 6. ボタンの状態を確認
await expect(page.locator('#logout')).toBeVisible();
await expect(page.locator('#logout')).toBeEnabled();
// 7. ユーザーID属性を取得して検証
const userId = await page.getAttribute('#user-profile', 'data-id');
console.log('ユーザーID:', userId);
expect(userId).not.toBeNull();
// 8. ページスクリーンショット
await page.screenshot({ path: 'login-success.png', fullPage: true });
// 9. スナップショット比較(UI回帰テスト)
expect(await page.screenshot()).toMatchSnapshot('dashboard.png');
});
このテストでは次のことを検証します:
- ページタイトルとウェルカムテキストが正しいかどうか
- 要素が可視かどうか / 使用可能かどうか
- ユーザー情報属性が存在するかどうか
- ページスクリーンショットとUIスナップショットの比較
よく使うAPI一覧表
以下はデータ抽出と検証関連APIの一覧表です。
| メソッド | 説明 | 例 |
|---|---|---|
page.textContent(selector) |
要素のテキスト内容を取得 | await page.textContent('#msg') |
page.innerText(selector) |
レンダリング後のプレーンテキストを取得 | await page.innerText('#msg') |
page.innerHTML(selector) |
要素のHTMLを取得 | await page.innerHTML('#content') |
page.getAttribute(selector, name) |
属性値を取得 | await page.getAttribute('#btn', 'class') |
page.$eval(selector, fn) |
要素上で関数を実行 | await page.$eval('#logo', el => el.tagName) |
page.$$eval(selector, fn) |
一括で関数を実行 | await page.$$eval('.item', els => els.length) |
page.isVisible(selector) |
可視かどうか | await page.isVisible('#dialog') |
page.isHidden(selector) |
非表示かどうか | await page.isHidden('#loading') |
page.isEnabled(selector) |
有効かどうか | await page.isEnabled('#submit') |
page.isDisabled(selector) |
無効かどうか | await page.isDisabled('#submit') |
page.isChecked(selector) |
選択されているかどうか | await page.isChecked('#agree') |
アサーションと検証(@playwright/test)
| メソッド | 説明 | 例 |
|---|---|---|
expect(locator).toHaveText(value) |
テキストを検証 | expect(page.locator('h1')).toHaveText('欢迎') |
expect(locator).toHaveValue(value) |
入力フィールドの値を検証 | expect(page.locator('#user')).toHaveValue('test') |
expect(locator).toHaveAttribute(name, value) |
属性を検証 | expect(page.locator('#btn')).toHaveAttribute('type', 'submit') |
expect(locator).toBeVisible() |
要素が可視 | expect(page.locator('#msg')).toBeVisible() |
expect(locator).toBeHidden() |
要素が非表示 | expect(page.locator('#loading')).toBeHidden() |
expect(locator).toBeEnabled() |
要素が有効 | expect(page.locator('#submit')).toBeEnabled() |
expect(locator).toBeDisabled() |
要素が無効 | expect(page.locator('#submit')).toBeDisabled() |
expect(locator).toBeChecked() |
要素が選択済み | expect(page.locator('#agree')).toBeChecked() |
expect(page).toHaveTitle(title) |
ページタイトルの検証 | expect(page).toHaveTitle(/Dashboard/) |
expect(page).toHaveURL(url) |
ページURLの検証 | expect(page).toHaveURL('https://example.com/dashboard') |
スクリーンショットと録画
| メソッド | 説明 | 例 |
|---|---|---|
page.screenshot(options) |
ページスクリーンショット | await page.screenshot({ path: 'page.png' }) |
locator.screenshot(options) |
要素スクリーンショット | await page.locator('#logo').screenshot({ path: 'logo.png' }) |
context = browser.newContext({ recordVideo }) |
ビデオ録画を有効にする | recordVideo: { dir: 'videos/' } |
expect(await page.screenshot()).toMatchSnapshot(name) |
スクリーンショット比較(スナップショットテスト) | expect(await page.screenshot()).toMatchSnapshot('home.png') |