MENU

問い合わせ


    【Next.jsで作るオンライン予約サービス 第10回】テストを自動化する(VitestとPlaywrightで予約の通しを確かめる)

    (2026年10月29日 追記:記事どおりに再現できるよう、必要なコードと手順を追加しました)

    予約サービスは、機能を足すたびに「前に作った部分が壊れていないか」が心配になります。第9回までで、予約・決済・メール・管理画面ができました。毎回すべてを手で操作して確かめるのは、もう現実的ではありません。この回では、画面を自動で操作するテスト(Playwright)を足して、「会議室を選ぶ → 予約する → 支払い通知で確定する」という流れを、コマンド1つで確かめられるようにします。

    「開発会社から『テストも作りました』と言われるけれど、何をどこまで確かめてくれているのか、正直よく分からない…」

    先に結論です。テストは「部品ごとの確認」と「通しの確認」の2階建てで考えるのが基本です。部品ごとの確認(単体テスト)は速くて数を作れますが、画面のつながりの不具合は見つけられません。通しの確認(e2eテスト=end to end、入口から出口まで)は遅いので、本当に壊れてはいけない流れ(今回なら「予約から確定まで」)だけに絞ります。そして、テストが「いつ・誰の手で・どの環境で」実行されるのかまで決めておくと、発注者も品質を確かめやすくなります。

    前回の第9回では、管理者だけが入れる管理画面を作りました。詳しくは次の記事で解説しています。

    今回は、ここまで作った機能をまとめて自動で確かめます。

    目次

    この回で作るもの:予約の通しテストと自動実行の設定

    使ったバージョンは Next.js 16・Playwright 1 系・Vitest 5 で、この回で足すファイルの全文と、既存のファイルへの変更点は、各項目に載せています。

    作るもの役割主なファイル
    単体テスト(既存・Vitest)料金計算・日付・署名の検証・DB の制約など、部品ごとの確認。107件tests/
    通しテスト(新規・Playwright)ブラウザを自動で操作し、予約から確定までを確認。4本e2e/reservation.spec.ts
    偽の Stripe本物の決済サービスに通信せず、決済ページの作成にだけ答える小さなサーバーe2e/fake-stripe.ts
    自動実行の設定変更のたびに上記をまとめて実行する(GitHub Actions のひな形).github/workflows/ci.yml

    何をテストし、何をテストしないか

    Playwright は、実際のブラウザ(Chromium など)を自動で動かしてクリックや入力をするツールです。Next.js の公式ドキュメントでも、e2eテストの方法の一つとして紹介されています。

    📰 出典:Next.js Docs「Setting up Playwright with Next.js」

    ただ、何でも通しテストにすると、遅くて壊れやすいテストが増えます。この連載では次のように分けました。

    確かめたいこと向いているテスト理由
    料金の計算・キャンセル規定・日付の扱い単体テスト画面なしで速く、細かい境界値まで確かめられる
    二重予約を DB が止めるか単体テスト(DB 接続あり)10件同時に予約して1件だけ成功することを直接確かめる
    一覧から予約し、確定するまでの流れ通しテスト画面・Server Action・DB・Webhook のつなぎ目の不具合は、通さないと見つからない
    権限(未ログイン・一般会員・管理者)通しテスト実際の Cookie とページの組み合わせで確かめる
    本物の Stripe の決済画面テストしない他社のサービスで、画面が変わると壊れる。Stripe のテストモードで人が確認する

    通しテストを動かす準備

    まず Playwright を入れ、テストで使うブラウザ(Chromium)を取得します。Linux で必要なライブラリが足りない場合は、npx playwright install --with-deps chromium を使います。

    npm i -D @playwright/test@1
    npx playwright install chromium

    package.json の scripts に、通しテストと、検査をまとめて流すコマンドを足します(+ が追加、- が削除)

    --- a/package.json
    +++ b/package.json
    @@ -12,7 +12,9 @@
         "test": "vitest run",
         "db:generate": "drizzle-kit generate",
         "db:migrate": "drizzle-kit migrate",
    -    "db:seed": "node scripts/seed.ts"
    +    "db:seed": "node scripts/seed.ts",
    +    "test:e2e": "playwright test",
    +    "test:all": "npm run lint && npm run typecheck && npm test"
       },
       "dependencies": {
         "drizzle-orm": "^0.45.4",

    テストの結果(スクリーンショットや記録)は Git に入れないので、.gitignore に足します(+ が追加、- が削除)

    --- a/.gitignore
    +++ b/.gitignore
    @@ -4,3 +4,5 @@ node_modules/
     .env.local
     next-env.d.ts
     *.tsbuildinfo
    +test-results/
    +playwright-report/

    専用のデータベースで動かす

    通しテストはデータを書き換えます。開発中のデータを消さないよう、テスト専用のデータベース(yoyaku_e2e)を使い、名前に e2e が入っていない DB では動かないようにしました。

    テスト専用のデータベースを作ります。第0回の Docker Compose のデータベースの中に、もう1つ作る形です。表は、テストの開始時に drizzle-kit migrate で自動的に作られます。

    docker compose exec db createdb -U yoyaku yoyaku_e2e
    // e2e/global-setup.ts
    import { execSync } from "node:child_process";
    import { createDb } from "../lib/db.ts";
    import { reservations, sessions, stripeEvents, users } from "../lib/schema.ts";
    import { sampleSpaces } from "../lib/seed-data.ts";
    import { spaces } from "../lib/schema.ts";
    import { e2eEnv } from "../playwright.config.ts";
    
    // テストの前に、データベースを毎回同じ状態に戻す
    export default async function globalSetup() {
      Object.assign(process.env, e2eEnv);
      // 本番や開発用の DB を誤って消さないよう、名前に e2e を含む DB 以外では動かさない
      if (!new URL(e2eEnv.DATABASE_URL).pathname.includes("e2e")) {
        throw new Error(`E2E_DATABASE_URL の DB 名に e2e が含まれていません: ${e2eEnv.DATABASE_URL}`);
      }
      execSync("npx drizzle-kit migrate", { stdio: "ignore", env: process.env });
    
      const { db, client } = createDb();
      await db.delete(reservations);
      await db.delete(sessions);
      await db.delete(users);
      await db.delete(stripeEvents);
      for (const space of sampleSpaces) {
        await db.insert(spaces).values(space).onConflictDoUpdate({ target: spaces.slug, set: space });
      }
      await client.end();
    }

    テストの前に毎回、予約・会員・通知の記録を空にしてサンプルのスペースを入れ直します。「前の実行のデータが残っていて通ったり落ちたりする」状態を避けるためです。

    偽の Stripe を用意する

    決済ページは Stripe が作るので、そのままでは通しテストに本物の鍵とインターネットが必要になります。そこで、決済ページの作成に答えるだけの小さなサーバーを用意しました。

    // e2e/fake-stripe.ts
    // 自動テスト専用の「偽の Stripe」。本物の Stripe に通信せず、決済ページの作成だけに答える。
    // 起動: node e2e/fake-stripe.ts(PORT で待ち受けポートを変えられる)
    import { createServer } from "node:http";
    
    const port = Number(process.env.PORT ?? 4010);
    let seq = 0;
    
    createServer((req, res) => {
      let body = "";
      req.on("data", (chunk) => (body += chunk));
      req.on("end", () => {
        res.setHeader("content-type", "application/json");
        if (req.method === "POST" && req.url === "/v1/checkout/sessions") {
          const id = `cs_test_e2e_${Date.now()}_${++seq}`;
          res.end(JSON.stringify({ id, object: "checkout.session", url: `http://localhost:${port}/pay/${id}` }));
        } else if (req.method === "GET" && req.url?.startsWith("/pay/")) {
          res.setHeader("content-type", "text/html; charset=utf-8");
          res.end("<h1>偽の決済ページ(テスト用)</h1>");
        } else {
          res.statusCode = 404;
          res.end(JSON.stringify({ error: { message: `偽の Stripe は ${req.method} ${req.url} に対応していません` } }));
        }
      });
    }).listen(port, () => console.log(`fake stripe: http://localhost:${port}`));

    アプリ側は、環境変数 STRIPE_API_BASE があるときだけ Stripe の宛先を差し替えます。本番では設定しません。

    lib/payment.ts に次の変更を加えます(+ が追加、- が削除)。

    --- a/lib/payment.ts
    +++ b/lib/payment.ts
    @@ -19,7 +19,11 @@ export function getStripe(): Stripe {
       const key = process.env.STRIPE_SECRET_KEY;
       if (!key) throw new PaymentNotConfiguredError();
       if (!cached) {
    -    cached = new Stripe(key);
    +    // STRIPE_API_BASE は自動テスト(e2e)専用。偽の Stripe サーバーに向けるときだけ設定する(本番では設定しない)
    +    const base = process.env.STRIPE_API_BASE ? new URL(process.env.STRIPE_API_BASE) : undefined;
    +    cached = base
    +      ? new Stripe(key, { host: base.hostname, port: base.port, protocol: base.protocol.replace(":", "") as "http" | "https" })
    +      : new Stripe(key);
       }
       return cached;
     }

    アプリを起動する設定

    playwright.config.ts の webServer に、偽の Stripe とアプリ本体の起動を書いておくと、テストの前に自動で立ち上がり、終わると止まります。アプリは開発用ではなく、npm run build 済みの本番と同じ形で起動します。

    // playwright.config.ts
    import { defineConfig } from "@playwright/test";
    
    // e2e は専用のデータベースで動かす(開発用のデータを消さないため)。作り方は README か記事の手順を参照
    const databaseUrl = process.env.E2E_DATABASE_URL ?? "postgres://yoyaku:yoyaku@localhost:5432/yoyaku_e2e";
    const appPort = 3100;
    const stripePort = 4010;
    
    export const e2eEnv = {
      DATABASE_URL: databaseUrl,
      STRIPE_SECRET_KEY: "sk_test_e2e_dummy",
      STRIPE_API_BASE: `http://localhost:${stripePort}`,
      STRIPE_WEBHOOK_SECRET: "whsec_e2e_secret",
      APP_URL: `http://localhost:${appPort}`,
      ADMIN_EMAILS: "admin@example.com",
    };
    
    export default defineConfig({
      testDir: "./e2e",
      testMatch: "**/*.spec.ts",
      fullyParallel: false, // 同じ DB・同じスペースの枠を使うので、順番に実行する
      workers: 1,
      retries: process.env.CI ? 1 : 0,
      reporter: process.env.CI ? [["github"], ["html", { open: "never" }]] : "list",
      globalSetup: "./e2e/global-setup.ts",
      use: {
        baseURL: `http://localhost:${appPort}`,
        trace: "retain-on-failure", // 失敗したときだけ操作の記録を残す
        screenshot: "only-on-failure",
        launchOptions: process.env.PW_CHROMIUM_PATH ? { executablePath: process.env.PW_CHROMIUM_PATH } : {},
      },
      webServer: [
        { command: "node e2e/fake-stripe.ts", url: `http://localhost:${stripePort}/pay/ping`, env: { PORT: String(stripePort) }, reuseExistingServer: !process.env.CI },
        // 事前に npm run build 済みの本番ビルドを起動する(本番と同じ動きを確かめるため)
        { command: `npx next start -p ${appPort}`, url: `http://localhost:${appPort}/api/health`, env: e2eEnv, reuseExistingServer: !process.env.CI, timeout: 60_000 },
      ],
    });

    📰 出典:Playwright Docs「Web server」

    予約の通しテストを書く

    最初のテストは、利用者が行う操作をそのまま書き下したものです。

    // e2e/reservation.spec.ts
    import { expect, test } from "@playwright/test";
    import { clickNextDay, loginAs, sendPaidWebhook } from "./helpers.ts";
    
    // 予約の通し確認:一覧 → 詳細 → 空き枠 → 入力 → 決済ページ → 支払い通知 → 確定
    test("会議室を選んで予約を申し込み、支払い通知で確定する", async ({ page }) => {
      await page.goto("/spaces");
      await page.getByRole("link", { name: /渋谷ミーティングルームA/ }).click();
      await expect(page.getByRole("heading", { name: "渋谷ミーティングルームA" })).toBeVisible();
    
      // 3日先の10時の枠を選ぶ(日付は固定せず、実行日からの相対にする)
      await clickNextDay(page, 3);
      await page.getByRole("link", { name: /^10:00〜 空き/ }).click();
    
      // 何も入れずに送ると、項目ごとのエラーが出て、決済には進まない
      await page.getByRole("button", { name: "この内容で予約する" }).click();
      // ※ getByRole("alert") だけだと、Next.js が常に置いている画面遷移の読み上げ用の要素に当たってしまう。メッセージの文面で指定する
      await expect(page.getByText("お名前を入力してください")).toBeVisible();
      await expect(page).toHaveURL(/\/reserve\?/);
    
      await page.getByLabel("お名前").fill("テスト花子");
      await page.getByLabel("メールアドレス").fill("hanako@example.com");
      await page.getByLabel("利用時間").selectOption("2");
      await page.getByLabel(/利用人数/).fill("3");
      await page.getByRole("button", { name: "この内容で予約する" }).click();
    
      // 偽の Stripe の決済ページへ移る(本物の Stripe には通信していない)
      await expect(page).toHaveURL(/localhost:4010\/pay\/cs_test_e2e_/);
    
      // 支払い通知が届く前は、まだ確定していない
      const done = (id: number) => `/spaces/shibuya-a/reserve/done?id=${id}`;
      const { reservationId, body } = await sendPaidWebhook(page, "hanako@example.com");
      expect(body.outcome).toBe("confirmed");
      await page.goto(done(reservationId));
      await expect(page.getByRole("heading", { name: "予約が確定しています" })).toBeVisible();
    
      // 同じ通知がもう一度届いても、二重には処理されない
      expect((await sendPaidWebhook(page, "hanako@example.com")).body.outcome).toBe("duplicate");
    });
    
    test("すでに予約が入った時間は、画面でも直接のURLでも予約できない", async ({ page }) => {
      await page.goto("/spaces/shibuya-a");
      await clickNextDay(page, 3);
      // 前のテストで 10:00〜12:00 が押さえられている
      await expect(page.getByText("10:00〜 予約済み")).toBeVisible();
      await expect(page.getByText("11:00〜 予約済み")).toBeVisible();
      await expect(page.getByRole("link", { name: /^10:00〜/ })).toHaveCount(0);
    
      // 画面にリンクが無くても、URL を直接開いて送信された場合はサーバー側で断る
      const url = new URL(page.url());
      const date = url.searchParams.get("date");
      await page.goto(`/spaces/shibuya-a/reserve?date=${date}&hour=11`);
      await page.getByLabel("お名前").fill("別のお客様");
      await page.getByLabel("メールアドレス").fill("other@example.com");
      await page.getByRole("button", { name: "この内容で予約する" }).click();
      await expect(page.getByText("選んだ時間にすでに予約が入っています")).toBeVisible();
    });
    
    test("未ログインはログイン画面へ戻され、ログイン後は予約履歴を開ける", async ({ page, context }) => {
      await page.goto("/reservations");
      await expect(page).toHaveURL(/\/login/); // 未ログインはログイン画面へ戻される
    
      await loginAs(context, "hanako@example.com");
      await page.goto("/reservations");
      await expect(page.getByText("hanako@example.com でログイン中")).toBeVisible();
    });
    
    test("管理画面は管理者だけが開ける", async ({ browser }) => {
      const general = await browser.newContext();
      await loginAs(general, "general@example.com");
      const generalPage = await general.newPage();
      expect((await generalPage.goto("/admin"))?.status()).toBe(404); // 管理画面があること自体を見せない
    
      const admin = await browser.newContext();
      await loginAs(admin, "admin@example.com");
      const adminPage = await admin.newPage();
      await adminPage.goto("/admin");
      await expect(adminPage.getByRole("heading", { name: "予約管理" })).toBeVisible();
      await general.close();
      await admin.close();
    });

    要素は CSS のクラス名ではなく、getByRole(役割)や getByLabel(ラベル)で探しています。見た目の変更に強く、利用者が見ている画面に近い探し方になるためです。

    📰 出典:Playwright Docs「Best Practices」

    支払い通知は、署名つきで自分で送る

    実際の支払い通知は Stripe のサーバーから届きます。テストでは、第7回で作った署名の検証を通る通知を、テスト側で作って送ります。

    // e2e/helpers.ts
    import { expect, type BrowserContext, type Page } from "@playwright/test";
    import { eq } from "drizzle-orm";
    import Stripe from "stripe";
    import { SESSION_DAYS, addDays, generateToken, hashToken } from "../lib/auth-token.ts";
    import { createDb } from "../lib/db.ts";
    import { reservations, sessions, users } from "../lib/schema.ts";
    import { e2eEnv } from "../playwright.config.ts";
    
    const stripe = new Stripe("sk_test_e2e_dummy"); // 署名を作るためだけに使う。通信はしない
    
    // テストから DB を直接のぞく(画面に出ない値の確認や、準備に使う)
    export async function withDb<T>(fn: (db: ReturnType<typeof createDb>["db"]) => Promise<T>): Promise<T> {
      process.env.DATABASE_URL = e2eEnv.DATABASE_URL;
      const { db, client } = createDb();
      try {
        return await fn(db);
      } finally {
        await client.end();
      }
    }
    
    // メールのリンクを開く手順は別の自動テスト(vitest)で確かめ済みなので、e2e ではログイン済みの状態(セッションと Cookie)を直接作る。
    // lib/auth.ts は next/headers を読み込むため、Next.js の外で動くテストからは使わず、DB に直接書く
    export async function loginAs(context: BrowserContext, email: string) {
      const token = await withDb(async (db) => {
        await db.insert(users).values({ email }).onConflictDoNothing({ target: users.email });
        const [user] = await db.select().from(users).where(eq(users.email, email)).limit(1);
        const token = generateToken();
        await db.insert(sessions).values({ tokenHash: hashToken(token), userId: user.id, expiresAt: addDays(new Date(), SESSION_DAYS) });
        return token;
      });
      await context.addCookies([{ name: "yoyaku_session", value: token, url: e2eEnv.APP_URL }]);
    }
    
    // Stripe から「支払いが済んだ」という通知が届いたことにして、署名つきで Webhook を呼ぶ
    export async function sendPaidWebhook(page: Page, email: string) {
      const [r] = await withDb((db) => db.select().from(reservations).where(eq(reservations.contactEmail, email)));
      const payload = JSON.stringify({
        id: `evt_e2e_${r.id}`,
        object: "event",
        type: "checkout.session.completed",
        data: { object: { id: r.stripeSessionId, object: "checkout.session", client_reference_id: String(r.id), payment_status: "paid", amount_total: r.totalYen, payment_intent: `pi_e2e_${r.id}` } },
      });
      const signature = stripe.webhooks.generateTestHeaderString({ payload, secret: e2eEnv.STRIPE_WEBHOOK_SECRET });
      const res = await page.request.post("/api/stripe/webhook", { data: payload, headers: { "stripe-signature": signature, "content-type": "application/json" } });
      expect(res.status()).toBe(200);
      return { reservationId: r.id, body: await res.json() };
    }
    
    // 空き状況の「次の日 →」を times 回押す。押すたびに、画面に出ている日付が変わるのを待ってから次を押す。
    // 待たずに続けて押すと、画面が切り替わる前の古いリンクを押してしまい、進む日数がずれることがある
    export async function clickNextDay(page: Page, times: number) {
      const shown = page.getByRole("navigation", { name: "日付の切り替え" }).locator("strong");
      for (let i = 0; i < times; i++) {
        const before = await shown.innerText();
        await page.getByRole("link", { name: "次の日 →" }).click();
        await expect(shown).not.toHaveText(before);
      }
    }

    署名を省いて通すのではなく、本番と同じ署名の検証を通しているのがポイントです。続けて、確定後の画面に「予約が確定しています」が出ること、同じ通知をもう一度送ると duplicate(処理済み)になることを確かめています。

    二重予約・権限のテスト

    残りの3本は次のとおりです。

    • 押さえ済みの時間は、カレンダーに「予約済み」と出てリンクにならない。URL を直接開いて送信しても、サーバー側で「すでに予約が入っています」と断る
    • 未ログインで /reservations を開くとログイン画面へ戻される
    • 一般会員が /admin を開くと 404、管理者なら「予約管理」が開く

    ログイン済みの状態は、メールのリンクをたどらず、DB にセッションを書いて Cookie を渡して作っています。メールのリンクの動作は単体テストで確かめ済みなので、通しテストでは省いて速く・安定させる方針です。

    動かして分かったつまずき3つ

    実際に動かして、次の3つで引っかかりました。どれも「テストを書き始めると必ず出会う」類のものです。

    1. getByRole("alert") が別の要素に当たる

    最初は、エラー表示の確認を page.getByRole("alert").first() と書いていました。ところがこのテストは、項目が空のまま送信した直後に、次の入力が消える形で失敗しました。原因は、Next.js が画面遷移を読み上げるために常に置いている alert 役割の要素に当たり、エラーの表示を待たずに次の操作へ進んでいたためです。フォームの処理が終わる前に入力した内容が、処理後のフォームの再描画で消えていました。メッセージの文面(「お名前を入力してください」)で待つように直して解消しました。

    テストの失敗は、アプリの不具合とは限らず、「待ち方」の問題であることが多いという典型例です。

    2. DB が無い環境で単体テストが落ちる

    「DATABASE_URL が無いときは DB のテストを飛ばす」と書いていたのに、DB 無しで npm test を実行すると5ファイルが失敗しました。describe.skipIf(...) の中身は、飛ばす場合でも定義のために一度実行され、その中で DB に接続しようとして例外になっていたためです。飛ばす条件のときは接続しない入れ物を返すヘルパーを用意しました。

    // tests/helpers/db.ts
    import { createDb } from "@/lib/db";
    
    // describe.skipIf の中身は、飛ばす場合でも「定義のために」一度実行される。
    // DATABASE_URL が無いとき createDb() が例外になるので、DB 無しの環境では接続せず空の入れ物を返す
    // (この場合 describe ごと飛ばされるので、db に触れるテストは動かない)
    export function createTestDb(): ReturnType<typeof createDb> {
      return process.env.DATABASE_URL ? createDb() : ({} as ReturnType<typeof createDb>);
    }

    直した結果、DB 無しでは62件が通って45件が飛ばされ、DB ありでは107件がすべて通ります。「飛ばす」と書いたテストが本当に飛ぶかは、実際にその環境で実行しないと分かりません。

    DB につなぐ5つのテストで、接続の作り方をこのヘルパーに置き換えます。どのファイルも変更は同じ形です。

    tests/double-booking.test.ts に次の変更を加えます(+ が追加、- が削除)。

    --- a/tests/double-booking.test.ts
    +++ b/tests/double-booking.test.ts
    @@ -2,7 +2,7 @@
     // 実行例: DATABASE_URL=postgres://yoyaku:yoyaku@localhost:5432/yoyaku npm test
     import { eq } from "drizzle-orm";
     import { afterAll, beforeAll, describe, expect, it } from "vitest";
    -import { createDb } from "@/lib/db";
    +import { createTestDb } from "./helpers/db";
     import { insertReservation, isExclusionViolation } from "@/lib/reservations";
     import { reservations, spaces } from "@/lib/schema";
     import { jstDateTime } from "@/lib/slots";
    @@ -14,7 +14,7 @@ const range = (startHour: number, hours: number) => ({
     });
     
     describe.skipIf(!process.env.DATABASE_URL)("二重予約の防止(DB 制約)", () => {
    -  const { db, client } = createDb();
    +  const { db, client } = createTestDb();
       let spaceId = 0;
     
       beforeAll(async () => {

    tests/auth.test.ts に次の変更を加えます(+ が追加、- が削除)。

    --- a/tests/auth.test.ts
    +++ b/tests/auth.test.ts
    @@ -3,7 +3,7 @@ import { eq, inArray } from "drizzle-orm";
     import { afterAll, describe, expect, it } from "vitest";
     import { consumeLoginToken, createLoginToken, createSession, findOrCreateUser, findUserBySession } from "@/lib/auth";
     import { addDays, addMinutes } from "@/lib/auth-token";
    -import { createDb } from "@/lib/db";
    +import { createTestDb } from "./helpers/db";
     import { insertReservation, listReservationsForUser } from "@/lib/reservations";
     import { loginTokens, reservations, spaces, users } from "@/lib/schema";
     import { jstDateTime } from "@/lib/slots";
    @@ -11,7 +11,7 @@ import { jstDateTime } from "@/lib/slots";
     const emails = ["auth-a@example.com", "auth-b@example.com", "auth-limit@example.com", "auth-race@example.com"];
     
     describe.skipIf(!process.env.DATABASE_URL)("メールリンク認証(DB)", () => {
    -  const { db, client } = createDb();
    +  const { db, client } = createTestDb();
     
       afterAll(async () => {
         await db.delete(loginTokens).where(inArray(loginTokens.email, emails));

    tests/hold.test.ts に次の変更を加えます(+ が追加、- が削除)。

    --- a/tests/hold.test.ts
    +++ b/tests/hold.test.ts
    @@ -2,7 +2,7 @@
     import { eq } from "drizzle-orm";
     import { afterAll, beforeAll, describe, expect, it } from "vitest";
     import { listReservedRanges } from "@/lib/availability";
    -import { createDb } from "@/lib/db";
    +import { createTestDb } from "./helpers/db";
     import { HOLD_MINUTES } from "@/lib/payment";
     import { attachCheckoutSession, expireStaleHolds, insertReservation, releasePendingReservation } from "@/lib/reservations";
     import { reservations, spaces } from "@/lib/schema";
    @@ -14,7 +14,7 @@ const t0 = new Date("2026-12-01T00:00:00Z");
     const minutesLater = (m: number) => new Date(t0.getTime() + m * 60_000);
     
     describe.skipIf(!process.env.DATABASE_URL)("仮予約の期限(DB)", () => {
    -  const { db, client } = createDb();
    +  const { db, client } = createTestDb();
       let spaceId = 0;
     
       beforeAll(async () => {

    tests/webhook.test.ts に次の変更を加えます(+ が追加、- が削除)。

    --- a/tests/webhook.test.ts
    +++ b/tests/webhook.test.ts
    @@ -2,7 +2,7 @@
     import { eq } from "drizzle-orm";
     import Stripe from "stripe";
     import { afterAll, beforeAll, describe, expect, it } from "vitest";
    -import { createDb } from "@/lib/db";
    +import { createTestDb } from "./helpers/db";
     import { HOLD_MINUTES } from "@/lib/payment";
     import { attachCheckoutSession, expireStaleHolds, insertReservation } from "@/lib/reservations";
     import { reservations, spaces, stripeEvents } from "@/lib/schema";
    @@ -56,7 +56,7 @@ function sessionEvent(type: string, session: { id: string; reservationId: number
     }
     
     describe.skipIf(!process.env.DATABASE_URL)("支払い通知の処理(DB)", () => {
    -  const { db, client } = createDb();
    +  const { db, client } = createTestDb();
       let spaceId = 0;
     
       beforeAll(async () => {

    tests/cancel.test.ts に次の変更を加えます(+ が追加、- が削除)。

    --- a/tests/cancel.test.ts
    +++ b/tests/cancel.test.ts
    @@ -2,7 +2,7 @@
     import { eq } from "drizzle-orm";
     import { afterAll, beforeAll, describe, expect, it, vi } from "vitest";
     import { cancelReservation } from "@/lib/cancel";
    -import { createDb } from "@/lib/db";
    +import { createTestDb } from "./helpers/db";
     import { resendMissingConfirmations, sendConfirmationMail } from "@/lib/notify";
     import { reservations, spaces, users } from "@/lib/schema";
     import { jstDateTime } from "@/lib/slots";
    @@ -10,7 +10,7 @@ import { jstDateTime } from "@/lib/slots";
     const now = new Date("2026-12-01T00:00:00Z");
     
     describe.skipIf(!process.env.DATABASE_URL)("キャンセルと返金・確認メール(DB)", () => {
    -  const { db, client } = createDb();
    +  const { db, client } = createTestDb();
       let spaceId = 0;
       let userId = 0;
       let otherUserId = 0;

    3. テストからアプリの部品を読み込むと動かないことがある

    通しテストのログイン処理で、アプリの lib/auth.ts をそのまま読み込もうとしたところ、Next.js 専用の読み込み(next/headers)がテスト側の実行環境で解決できず、起動時にエラーになりました。テスト側では Next.js に依存する部品を使わず、DB に直接書くようにしました。アプリの部品をテストで使い回せるかは、その部品が何に依存しているかで決まります。

    4. 「次の日 →」を続けて押すと、進む日数がずれる

    (2026年10月29日 追記)記事の手順を空のフォルダから再現したところ、2本目のテストがときどき失敗しました。for 文で「次の日 →」を3回続けて押すと、画面の切り替えが終わる前に古い画面のリンクを押してしまい、1本目と2本目で開く日がずれることがあったためです。押すたびに、画面に出ている日付が変わるのを待つヘルパー clickNextDay を足して直しました(上の e2e/helpers.ts と e2e/reservation.spec.ts は修正後のものです)。修正後は、続けて6回実行してすべて通過しました。

    自動で実行する:変更のたびにテストが走る仕組み

    テストは、誰かが思い出して実行するものだと、そのうち実行されなくなります。変更を GitHub に出すたびに自動で実行されるよう、GitHub Actions の設定のひな形を用意しました。

    # .github/workflows/ci.yml
    # 手元で通るテストを、変更のたびに自動で実行する(GitHub Actions)。
    # このファイルは連載のサンプル。実際に動かすときは、リポジトリ直下の .github/workflows/ に置く
    name: ci
    on:
      pull_request:
      push:
        branches: [main]
    
    jobs:
      test:
        runs-on: ubuntu-latest
        timeout-minutes: 15
        services:
          postgres:
            image: postgres:16
            env:
              POSTGRES_USER: yoyaku
              POSTGRES_PASSWORD: yoyaku
              POSTGRES_DB: yoyaku_e2e
            ports: ["5432:5432"]
            options: >-
              --health-cmd "pg_isready -U yoyaku" --health-interval 5s --health-timeout 3s --health-retries 10
        env:
          DATABASE_URL: postgres://yoyaku:yoyaku@localhost:5432/yoyaku_e2e
        steps:
          - uses: actions/checkout@v4
          - uses: actions/setup-node@v4
            with:
              node-version: 22
              cache: npm
          - run: npm ci
          - run: npm run lint
          - run: npm run typecheck
          - run: npx drizzle-kit migrate
          - run: npm test # 単体テスト+DB につないだテスト
          - run: npx playwright install --with-deps chromium
          - run: npm run build
          - run: npm run test:e2e # 本番ビルドを起動して、ブラウザで予約の通しを確認
          - uses: actions/upload-artifact@v4
            if: failure()
            with:
              name: playwright-report
              path: |
                playwright-report/
                test-results/

    通しテストが失敗したときは、画面のスクリーンショットと操作の記録(トレース)を保存するようにしてあります。トレースは Playwright のトレースビューアで開くと、各操作の前後の画面を順にたどれます。

    📰 出典:Playwright Docs「Trace viewer」

    手元では、次の順で実行します。通しテストは npm run build で作った本番ビルドを起動して確かめるので、ビルドを先に行います。

    docker compose up -d   # データベースを起動(起動済みなら不要)
    export DATABASE_URL=postgres://yoyaku:yoyaku@localhost:5432/yoyaku
    npm run test:all            # lint・型チェック・単体テスト
    npm run build
    npm run test:e2e

    動作確認の結果と、確認できていないこと

    項目結果
    lint・型チェック通過
    単体テスト(DB あり)107件通過
    通しテスト4本通過(続けて2回実行して、どちらも通過。2026年10月29日の再確認では、上の「4.」の修正後に続けて6回通過)
    GitHub Actions での実行未確認(この環境では実行していません。設定ファイルは手元のコマンド列に合わせたひな形です)
    本物の Stripe・メール送信未確認(通しテストは偽の Stripe を使っています)
    Docker での起動未確認(この環境では Docker が使えません)

    なお、検証した環境の都合で、ビルドには Turbopack を使わない next build --webpack を使いました。通常の環境では npm run build で動く想定です。

    発注者向けメモ:「テストあり」と言われたら確かめること

    テストは、品質を目に見える形にできる数少ない成果物です。依頼するときは、次を確認してください。

    • ☐ テストが何件あり、何を確かめているのかを一覧で見せてもらえる
    • ☐ 部品ごとの確認と、通しの確認の両方がある(片方だけではない)
    • ☐ テストが自動で実行される仕組み(CI)があり、結果を発注者も見られる
    • ☐ 決済・メールなど外部サービスの部分を、何で代用し、何が未確認かが明記されている
    • ☐ テストを書く工数が見積もりに入っている(後から足すと割高になりやすい)
    • ☐ 納品物にテストのコードと、実行方法の説明が含まれている

    開発会社への質問例です。

    • 「予約から支払い・確定まで、どの範囲を自動テストで確かめていますか。人が手で確かめる部分はどこですか」
    • 「テストは変更のたびに自動で実行されますか。失敗したときは誰に通知されますか」
    • 「決済やメールのテストは、本物のサービスと偽物のどちらで行いますか。本物でしか確かめられないことは何ですか」
    • 「テストが落ちたまま公開する、ということは起こり得ますか。公開の条件を教えてください」

    テストの工数は「機能の数」だけでなく、外部サービス(決済・メール・外部API)の数と環境(ブラウザ・端末)の数で増えます。スマホの実機や複数のブラウザで確かめたい場合は、最初に範囲を決めておくと、見積もりのずれを小さくできます。

    まとめと次回予告

    この回では、Playwright で予約から確定までの通しテストを作り、偽の Stripe と署名つきの支払い通知で、外部サービスなしでも流れを確かめられるようにしました。あわせて、DB 無しで単体テストが落ちる不具合を直し、変更のたびにテストを自動実行するための設定のひな形を用意しました。

    次回の第11回(最終回)では、このサービスを Vercel に公開します。環境変数、データベースの接続、公開前のチェック、そして運用で気をつけることをまとめます。

    この連載の記事一覧

    この記事は連載「Next.jsで作るオンライン予約サービス」の1回です。連載のほかの回は次のとおりです(連載の一覧ページ)。

    システム制作・運用・保守のお問い合わせはこちら


      よかったらシェアしてね!
      • URLをコピーしました!
      • URLをコピーしました!

      この記事を書いた人

      株式会社THIRD HERO代表取締役 朝野貴朗
      Webシステム開発を中心に、toC向けサービスサイトの運営、ツール開発などを行ってまいりました。

      コメント

      目次