hy-assessment-e2e
HY评估专用端到端测试技能。支持Supabase认证、候选人管理、分析功能测试。支持存储状态持久化、fixtures.ts模式。
📖 中文导读:HY评估专用端到端测试技能。支持Supabase认证、候选人管理、分析功能测试。支持存储状态持久化、fixtures.ts模式。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: hy-assessment-e2e description: HY Assessment専用E2Eテストスキル。Supabase認証、候補者管理、分析機能のテスト支援。storage state永続化、fixtures.tsパターン対応
HY Assessment E2E Testing
Project Configuration
| 設定項目 | 値 |
|---|---|
| Base URL | http://localhost:3000 (dev) / process.env.BASE_URL |
| Test Directory | e2e/ |
| Auth File | e2e/.auth/user.json |
| Fixtures | e2e/fixtures.ts |
| Config | playwright.config.ts |
Authentication Setup
storage stateを使用した認証永続化:
// e2e/auth.setup.ts
import { test as setup } from '@playwright/test';
setup('authenticate', async ({ page }) => {
await page.goto('/login');
await page.fill('[data-testid="login-email"]', process.env.E2E_TEST_EMAIL);
await page.fill('[data-testid="login-password"]', process.env.E2E_TEST_PASSWORD);
await page.click('[data-testid="login-submit"]');
await page.waitForURL('**/admin**');
await page.context().storageState({ path: 'e2e/.auth/user.json' });
});
Key Selectors
e2e/fixtures.tsから抽出したセレクタ:
export const SELECTORS = {
// Navigation
navDashboard: '[data-testid="nav-dashboard"]',
navCandidates: '[data-testid="nav-candidates"]',
navCompare: '[data-testid="nav-compare"]',
navReports: '[data-testid="nav-reports"]',
navTemplates: '[data-testid="nav-templates"]',
navPrompts: '[data-testid="nav-prompts"]',
navSettings: '[data-testid="nav-settings"]',
// Login
loginEmail: '[data-testid="login-email"]',
loginPassword: '[data-testid="login-password"]',
loginSubmit: '[data-testid="login-submit"]',
loginError: '[data-testid="login-error"]',
// Candidates
addCandidateButton: '[data-testid="add-candidate-button"]',
candidateName: '[data-testid="candidate-name"]',
candidateEmail: '[data-testid="candidate-email"]',
candidateSubmit: '[data-testid="candidate-submit"]',
candidateCancel: '[data-testid="candidate-cancel"]',
selectAllButton: '[data-testid="select-all-button"]',
compareButton: '[data-testid="compare-button"]',
// Compare
comparePositionFilter: '[data-testid="compare-position-filter"]',
compareSelectAllButton: '[data-testid="compare-select-all-button"]',
// Prompts
promptCreateButton: '[data-testid="prompt-create-button"]',
};
Helper Functions
e2e/fixtures.tsで定義されたヘルパー:
// Toast通知を待機
await waitForToast(page);
// ナビゲーションとクリックを同時実行
await clickAndWaitForNavigation(page, SELECTORS.navCandidates);
// リトライ付きログイン
await login(page, 3);
// 新規候補者フォームへ遷移
await navigateToNewCandidateForm(page);
Test Naming Convention
番号プレフィックスで実行順序を制御:
e2e/
├── auth.setup.ts # 認証セットアップ(最初に実行)
├── 01-auth.spec.ts # 認証テスト
├── 02-candidates.spec.ts # 候補者管理
├── 03-analysis.spec.ts # 分析機能
├── 04-compare.spec.ts # 比較機能
├── 05-reports.spec.ts # レポート機能
├── 06-settings.spec.ts # 設定機能
├── 07-navigation.spec.ts # ナビゲーション
└── fixtures.ts # 共通フィクスチャ
CI Integration
Environment Variables
E2E_TEST_EMAIL # テスト用メールアドレス
E2E_TEST_PASSWORD # テスト用パスワード
BASE_URL # テスト対象URL
VERCEL_AUTOMATION_BYPASS_SECRET # Vercel保護バイパス
Playwright Config
// playwright.config.ts
export default defineConfig({
projects: [
{ name: 'setup', testMatch: /auth\.setup\.ts/ },
{ name: 'auth-tests', testMatch: /01-auth\.spec\.ts/ },
{
name: 'chromium',
testIgnore: /01-auth\.spec\.ts/,
use: { storageState: 'e2e/.auth/user.json' },
dependencies: ['setup'],
},
],
});
Common Test Patterns
候補者追加テスト
test('should add new candidate', async ({ page }) => {
await navigateToNewCandidateForm(page);
await page.fill(SELECTORS.candidateName, 'テスト太郎');
await page.fill(SELECTORS.candidateEmail, `test-${Date.now()}@example.com`);
await page.click(SELECTORS.candidateSubmit);
await waitForToast(page);
await expect(page).toHaveURL(/\/admin\/candidates$/);
});
認証テスト
test('should redirect unauthenticated user to login', async ({ page }) => {
// storage stateを使用しない
await page.goto('/admin/candidates');
await expect(page).toHaveURL(/\/login/);
});
test('should login with valid credentials', async ({ page }) => {
await login(page);
await expect(page).toHaveURL(/\/admin/);
});
ナビゲーションテスト
test('should navigate to all main pages', async ({ page }) => {
const routes = [
{ selector: SELECTORS.navCandidates, url: /\/admin\/candidates/ },
{ selector: SELECTORS.navCompare, url: /\/admin\/compare/ },
{ selector: SELECTORS.navReports, url: /\/admin\/reports/ },
];
for (const route of routes) {
await clickAndWaitForNavigation(page, route.selector);
await expect(page).toHaveURL(route.url);
}
});
Debugging Tips
- UI Mode:
npm run test:e2e:uiでブラウザ付き実行 - Headed:
npx playwright test --headedでブラウザ表示 - Debug:
npx playwright test --debugでステップ実行 - Trace: 失敗時に
playwright-report/でトレース確認