E2Eテストとは — 信頼できる小さなテストスイート

// 不安定なテストを、修正できるまでリリースの確認から外す
test.fixme("注文履歴に確定した注文が表示される", async ({ page }) => {
  // ...シナリオはコードとして残し、実行だけを止める
});

// ❌ マークアップの詳細に依存している（スタイルや構造の変更で壊れる）
await page.locator(".btn-primary").click();
await page.locator("#order-list > div:nth-child(2) a").click();

// ✅ ユーザーと同じように、ロールとアクセシブルネームで特定する
await page.getByRole("button", { name: "注文を確定" }).click();
await page.getByRole("link", { name: "注文履歴" }).click();

// ❌ タイミングを推測している（負荷がかかると失敗し、それ以外では時間を無駄にする）
await page.waitForTimeout(3000);
expect(await page.locator(".order-row").count()).toBe(3);

// ✅ タイムアウトまで、状態が現れるのを自動で待つ
await expect(page.getByRole("row", { name: /注文番号/ })).toHaveCount(3);

// ❌ 別のテストが作った状態に依存している
// （単独実行・並列実行・順序の変更で失敗する）
test("前のテストの注文が表示される", async ({ page }) => {
  await signIn(page, sharedAccount);
  await expect(page.getByRole("row", { name: "注文 #1" })).toBeVisible();
});

// ✅ アカウントとデータを自分で用意し、どこでも実行できる
test("注文履歴に確定した注文が表示される", async ({ page }) => {
  const account = await prepareTestAccount();
  const order = await createTestOrder(account);
  await signIn(page, account);
  await page.getByRole("link", { name: "注文履歴" }).click();
  await expect(page.getByRole("row", { name: order.number })).toBeVisible();
});

// ❌ すべてのテストが本題の前にUIからログインする
test.beforeEach(async ({ page }) => {
  await page.goto("/login");
  // ...テストのたびに認証情報を入力する
});

// ✅ setupプロジェクトが権限ごとに一度だけログインし、状態を保存する
import { test as setup } from "@playwright/test";

setup(`authenticate as ${role}`, async ({ page }) => {
  await page.goto("/login");
  await page.getByLabel("メールアドレス").fill(user.email);
  await page.getByLabel("パスワード").fill(user.password);
  await page.getByRole("button", { name: "ログイン" }).click();
  await page.waitForURL("/dashboard");
  await page.context().storageState({ path: authFile(role) });
});

// ✅ テストは保存済みの状態を再利用し、ログイン済みで始まる
test.use({ storageState: authFile("admin") });

// 画面をデータとして定義する: パス・期待する見出し・許可された権限
const screens = [
  { path: "/reports", heading: "レポート", roles: ["admin", "manager"] },
  { path: "/settings/members", heading: "メンバー管理", roles: ["admin"] },
];

// 画面×権限のスモークテストを一覧から生成する
// （roleはこのスイートが実行する権限。specファイルごとに1つ固定する）
for (const { path, heading, roles } of screens) {
  test(`${heading} ${path}`, async ({ page }) => {
    await page.goto(path);
    const expected = roles.includes(role) ? heading : "ダッシュボード";
    await expect(
      page.getByRole("heading", { level: 1, name: expected })
    ).toBeVisible();
  });
}

// シナリオが必要とするデータをテスト支援APIで作成する
// （runIdはタイムスタンプなど、実行ごとに一意な識別子）
const org = await createTestOrg({ name: `e2e-signup-${runId}` });

// ❌ 配信にかかる時間を推測している（遅いと失敗し、速いと時間を無駄にする）
await page.waitForTimeout(15000);
const mail = await fetchLatestMail({ to: org.email });

// ✅ 上限付きのポーリングでメールの到達を待ってから読む
await expect
  .poll(() => fetchLatestMail({ to: org.email }), { timeout: 30_000 })
  .not.toBeNull();
const mail = await fetchLatestMail({ to: org.email });

test.skip(
  process.env.E2E_ENV === "production",
  "データを作成するシナリオは本番環境に対して実行しない"
);