パラメータ化テストとタグ付け

1. なぜ「パラメータ化」と「タグ付け」が必要か

• パラメータ化テストは “入力データ × シナリオ” の掛け算をコードの重複なしに実現し、網羅性とメンテナンス性を両立させる手法です。

• タグ付けはテスト群にメタ情報を付与し、実行対象の絞り込みやレポートの分類を容易にします。CI/CD では「高速スモークだけ」「回帰だけ」のように切り替えられるため、総実行時間を短縮できます。

---

2. パラメータ化テスト（データドリブンテスト）

2.1 テストレベルのパラメータ化

ts
import { test, expect } from '@playwright/test';

[
  { name: 'Alice', expected: 'Hello, Alice!' },
  { name: 'Bob',   expected: 'Hello, Bob!'  },
  { name: 'Charlie', expected: 'Hello, Charlie!' },
].forEach(({ name, expected }) => {
  test(`greet ${name}`, async ({ page }) => {
    await page.goto(`/greet?name=${name}`);
    await expect(page.getByRole('heading')).toHaveText(expected);
  });
});

Playwright 公式は forEach ループの外側 に beforeEach/afterEach を配置することを推奨しています。フックをループ内部に書くと毎回実行され、テスト時間が増えるためです。playwright.dev

2.2 プロジェクトレベルのパラメータ化

ts
// playwright.config.ts
import { defineConfig } from '@playwright/test';
export default defineConfig({
  projects: [
    { name: 'alice',  use: { person: 'Alice'  } },
    { name: 'bob',    use: { person: 'Bob'    } },
  ],
});

npx playwright test で２プロジェクトが並列実行され、それぞれに person オプションが注入されます。playwright.dev

フィクスチャ拡張との組み合わせ

ts
import { test as base } from '@playwright/test';
export type Opts = { person: string };
export const test = base.extend<Opts>({
  person: ['John', { option: true }],
});

任意の値を fixture として受け取り、projects 側で上書きできます（多言語・多権限ユーザーなどに便利）。playwright.dev

2.3 ベストプラクティス

---

3. タグ付け（@smoke, @critical など）

3.1 付け方 ― 新旧２つのシンタックス

ts
// ◆推奨: オブジェクト形式（v1.42～）
test('ユーザー登録', { tag: ['@smoke', '@critical'] }, async ({ page }) => { … });

// ◆旧形式: タイトルに直接
test('ユーザー登録 @smoke @critical', async ({ page }) => { … });

Playwright 公式ブログでも新形式が推奨されています。dev.to

グループ全体に付与する場合：

ts
test.describe('レポート機能', { tag: '@report' }, () => { … });

playwright.dev

3.2 フィルタリング CLI

設定ファイルでも grep / grepInvert が使えるため、CI ブランチごとに異なるデフォルトフィルタを設けることができます。

3.3 タグの可視化

• HTML Reporter／VS Code 拡張／UI Mode のラベルとして表示され、失敗テストの絞り込みが容易

• testInfo.tags 経由で カスタムレポーターからも取得でき、好きなフォーマットで出力可能

3.4 ベストプラクティス

---

4. 組み合わせ活用例

---

5. まとめ

• パラメータ化テストは入力や環境の組合せをコードの重複なく網羅し、projects と fixture 拡張でさらに柔軟に。

• タグ付けは実行フィルタとレポート分類を担う“軽量メタデータ”。新シンタックス（オブジェクト形式）が推奨です。

• 両者を併用すると、**「膨大なシナリオを高速に、必要なときだけ」**というテスト戦略を Playwright だけで完結できます。

これらを取り入れることで、CI/CD パイプラインの実行時間短縮とテストの保守性向上を同時に実現できます。