tests/ - E2E テスト

作成日: 2026-03-06 ／ 更新日: 2026-06-10

概要

Playwright による E2E テスト群。約 129 テストファイル (tests/ 124 + e2e/ 5) で、エディタ、認証、プレビュー、バトル、タイムライン、アセット管理、管理画面をカバーする。ローカル環境と Azure 環境の両方に対応。

ディレクトリ構成

tests/
├── fixtures/
│   └── urls.ts                     # 環境別 URL 定義 (URLS.NEXT, URLS.EDITOR, URLS.API, URLS.PREVIEW)
├── *.spec.ts                       # 124 テストファイル
e2e/
└── *.spec.ts                       # 5 テストファイル (マップ/フィルター/モバイル UI)

Playwright 設定ファイル

ルート直下は上記 3 つ。用途別の config は tests/configs/ に分かれている: playwright.local.config.ts（ローカル shared テスト）/ playwright.azure.config.ts・playwright.azure-full.config.ts（本番）/ playwright.docker.config.ts / playwright.mobile-guide.config.ts / playwright.recording.config.ts / playwright.showcase.config.ts。ほかに tests/block-coverage/ と apps/editor/ にも専用 config がある。

テスト一覧

認証テスト (3 ファイル)

エディタテスト (8 ファイル)

タイムラインテスト (5 ファイル)

バトルテスト (2 ファイル)

管理画面テスト (2 ファイル)

Azure テスト (4 ファイル)

KSC エディタテスト (2 ファイル)

その他テスト

e2e/ テスト (5 ファイル)

共通パターン

URL 定義

import { URLS } from './fixtures/urls';
// URLS.NEXT       = http://localhost:3000
// URLS.EDITOR     = http://localhost:5176
// URLS.KSC_EDITOR = http://localhost:5177
// URLS.API        = http://localhost:8080
// URLS.PREVIEW    = http://localhost:5175

ログインヘルパー

async function login(page: Page) {
  const res = await page.request.post(`${URLS.API}/api/auth/login`, {
    data: { email: 'user@example.com', password: '********' },
  });
  const { token, user } = await res.json();
  await page.addInitScript(({ token, userId }) => {
    localStorage.setItem('authToken', token);
    localStorage.setItem('currentUserId', userId);
  }, { token, userId: user.id });
  return { token, userId: user.id };
}

スクリーンショットヘルパー

const SS_DIR = path.join('screenshots', 'YYYY-MM-DD-テスト名');
function ss(filename: string): string {
  if (!fs.existsSync(SS_DIR)) fs.mkdirSync(SS_DIR, { recursive: true });
  return path.join(SS_DIR, filename);
}

テストルール

• expect で期待する状態を 1 つだけ明示する
• if で expect をスキップしない
• waitForTimeout でごまかさない（正しいセレクタ/条件を待つ）
• 失敗したら原因を調査してコードを修正する

テスト実行

# ローカル E2E
npx playwright test tests/editor-blocks.spec.ts

# Azure E2E（本番向け。ラッパースクリプト経由）
bash scripts/test/azure/run-all.sh

# e2e/ スナップショットテスト
npx playwright test --config=playwright.snapshots.config.ts

テスト結果 (2026-03-05 安定確認済み)