単体テストの設計

良い単体テストの構造: Arrange-Act-Assert

単体テストは準備(Arrange)・実行(Act)・検証(Assert)の 3ステップで構成すると読みやすくなります。1つのテストで1つの振る舞いだけを検証することも重要です。

import { describe, it, expect } from "vitest";
import { calculateShippingFee } from "./shipping";

describe("calculateShippingFee", () => {
  it("合計金額が5000円以上なら送料は0円になる", () => {
    // Arrange: 準備
    const orderTotal = 5000;

    // Act: 実行
    const fee = calculateShippingFee(orderTotal);

    // Assert: 検証
    expect(fee).toBe(0);
  });

  it("合計金額が5000円未満なら送料は500円になる", () => {
    const orderTotal = 4999;
    const fee = calculateShippingFee(orderTotal);
    expect(fee).toBe(500);
  });
});

テストしやすいコードの条件

テストが書きにくい場合、多くはテスト対象のコード自体に問題があります。 「テストしやすさ」は良い設計のバロメーターでもあります。

// before: 現在時刻・グローバル状態に依存していてテストしづらい
function isDiscountActive() {
  const now = new Date(); // テストのたびに結果が変わる
  return now.getHours() >= 20;
}

// after: 依存を引数として渡せるようにする(依存性の注入)
function isDiscountActive(currentDate: Date): boolean {
  return currentDate.getHours() >= 20;
}

// テストコード: 好きな時刻を注入できるので決定的にテストできる
it("20時以降は割引が有効になる", () => {
  const eveningDate = new Date("2026-01-01T20:00:00");
  expect(isDiscountActive(eveningDate)).toBe(true);
});

現在時刻・乱数・グローバル変数のような「隠れた入力」を関数の引数として明示することで、 テストコードから自由にコントロールできるようになります。

境界値・異常系を意識する

正常系のハッピーパスだけでなく、境界値やエラーケースをテストすることで、 本番で起きがちな「想定外」を事前に潰せます。