Goal
- •Reproduce, debug, and fix Playwright E2E failures with minimal flakiness.
Inputs (ask only if missing)
- •Which spec to focus on (file name / test title / failing step).
- •Target build (Chrome/Firefox) if relevant.
Steps
- •Ensure build artifact exists (E2E前提)
- •
yarn build
- •
- •Run E2E
- •
yarn e2e
- •
- •If tests depend on a live stream URL
- •Prefer search results (e.g.
https://www.youtube.com/results?search_query=vtuber&sp=EgJAAQ%253D%253D) - •Pick a result with a "Live" badge; if it fails to open, fall back to the next one
- •Avoid hardcoding a single live URL (streams end and cause flaky tests)
- •Prefer search results (e.g.
- •If you need to focus on a single test/spec
- •Try passing Playwright args through yarn:
- •
yarn e2e -- <args>（例:yarn e2e -- e2e/foo.spec.ts）
- •
- •If pass-through is not supported, run Playwright directly (repoの慣習に合わせる)
- •Try passing Playwright args through yarn:
- •Gather debugging artifacts (when failing)
- •Prefer Playwright trace/screenshots/video if enabled in config
- •Re-run once to confirm determinism (no infinite retries)
- •Fix strategy (flakinessを増やさない)
- •Avoid sleep/timeouts; wait on explicit UI/state:
- •
await expect(locator).toBeVisible() - •
await expect(locator).toHaveText(...)
- •
- •Use stable selectors (role/text/testid など、プロジェクトの既存パターンに合わせる)
- •Network依存はfixturesで置き換える（可能なら）
- •Avoid sleep/timeouts; wait on explicit UI/state:
- •Validate
- •
yarn e2eが連続で通ることを確認（最低2回が理想）
- •
Notes
- •
e2e/fixtures.tsの拡張test/expectを使う前提。 - •非決定的挙動を増やす修正（ランダム待ち/過剰リトライ）は避ける。
- •ネイティブチャットの表示/操作可否は「拡張ON/OFFの前後」で必ず確認する。
Output format
- •Repro steps（実行したコマンド）
- •Live URL used（該当時）
- •Root cause（推定でなく根拠ベース）
- •Fix summary（どこをどう変えたか）
- •Verification（通ったコマンド）