kstack-playwright

Playwright でブラウザテストを書くときの規約。理由を理解した上で適用すること。

VRT と E2E はディレクトリも config も分ける

VRT はスクリーンショットを assert するテストだけを置く。画面遷移や振る舞いを検証するテストは test/e2e のような別ディレクトリに置き、別の playwright config で実行する。

// Bad: test/vrt/sign-in.spec.ts に、スクリーンショットを撮らない遷移テストが混ざっている
test("ログイン後に callbackURL へ移動する", async ({ page }) => {
  await page.goto("/sign-in?callbackURL=https://app.example/");
  await page.getByRole("button", { name: "ログイン" }).click();
  await expect(page).toHaveURL("https://app.example/");
});

// Good: test/e2e/sign-in.spec.ts に置き、e2e 用の config で実行する