ホーム 全セッション S05

1つの関数に実装したキャンセル処理

2 / 14 目安 1分

ページ一覧

課題: 発生しうる失敗が型から読み取れず、条件の検証が時刻の取得や保存と混在するため、検証をテストできません。

次の図は、S04 の方法を適用する前のキャンセルを1つの関数に実装した、説明用の仮の例です。業務ルールは「診察開始前のみキャンセルできる」ですが、この例は会計済みしか検証しないため、診察中の予約もキャンセルできます。

  1. import { db } from "./db";
    const cancelAppointment = async (
      appointment: Appointment,
      cancellationReason: string,
    ) => {
      if (cancellationReason === "") {
        throw new Error("empty reason");
      }
      const now = new Date();
      if (appointment.kind === "Paid") {
        throw new Error("already paid");
      }
      await db.update(appointment.appointmentId, {
        kind: "Canceled",
        cancellationReason,
        canceledAt: now.toISOString(),
      });
    };

    説明用の仮の例

    • 条件の検証 理由が空か、会計済みかを検証し、条件を満たさない場合は throw する
    • 時刻の取得 new Date() で現在の時刻を取得する
    • 保存 モジュールから import した db へ書き込む

    1つの関数の中に、条件の検証、時刻の取得、保存が交互に並んでいます。順に色を付けて確認します。

  2. import { db } from "./db";
    const cancelAppointment = async (
      appointment: Appointment,
      cancellationReason: string,
    ) => {
      if (cancellationReason === "") {
        throw new Error("empty reason");
      }
      const now = new Date();
      if (appointment.kind === "Paid") {
        throw new Error("already paid");
      }
      await db.update(appointment.appointmentId, {
        kind: "Canceled",
        cancellationReason,
        canceledAt: now.toISOString(),
      });
    };

    説明用の仮の例

    • 条件の検証 理由が空か、会計済みかを検証し、条件を満たさない場合は throw する
    • 時刻の取得 new Date() で現在の時刻を取得する
    • 保存 モジュールから import した db へ書き込む

    条件の検証です。理由が空の場合と、予約が会計済みの場合に、throw で関数の処理を中断します。

  3. import { db } from "./db";
    const cancelAppointment = async (
      appointment: Appointment,
      cancellationReason: string,
    ) => {
      if (cancellationReason === "") {
        throw new Error("empty reason");
      }
      const now = new Date();
      if (appointment.kind === "Paid") {
        throw new Error("already paid");
      }
      await db.update(appointment.appointmentId, {
        kind: "Canceled",
        cancellationReason,
        canceledAt: now.toISOString(),
      });
    };

    説明用の仮の例

    • 条件の検証 理由が空か、会計済みかを検証し、条件を満たさない場合は throw する
    • 時刻の取得 new Date() で現在の時刻を取得する
    • 保存 モジュールから import した db へ書き込む

    時刻の取得です。条件の検証の途中で、現在の時刻を取得しています。

  4. import { db } from "./db";
    const cancelAppointment = async (
      appointment: Appointment,
      cancellationReason: string,
    ) => {
      if (cancellationReason === "") {
        throw new Error("empty reason");
      }
      const now = new Date();
      if (appointment.kind === "Paid") {
        throw new Error("already paid");
      }
      await db.update(appointment.appointmentId, {
        kind: "Canceled",
        cancellationReason,
        canceledAt: now.toISOString(),
      });
    };

    説明用の仮の例

    • 条件の検証 理由が空か、会計済みかを検証し、条件を満たさない場合は throw する
    • 時刻の取得 new Date() で現在の時刻を取得する
    • 保存 モジュールから import した db へ書き込む

    保存です。検証の後に、背景で見た3項目(kind、cancellationReason、canceledAt)をデータベースへ書き込みます。

  5. import { db } from "./db";
    const cancelAppointment = async (
      appointment: Appointment,
      cancellationReason: string,
    ) => {
      if (cancellationReason === "") {
        throw new Error("empty reason");
      }
      const now = new Date();
      if (appointment.kind === "Paid") {
        throw new Error("already paid");
      }
      await db.update(appointment.appointmentId, {
        kind: "Canceled",
        cancellationReason,
        canceledAt: now.toISOString(),
      });
    };

    説明用の仮の例

    • 発生しうる失敗が、関数の型から読み取れない 呼び出し側は、すべての失敗を扱えたかを検証できません。
    • 条件の検証が時刻の取得や保存と混在するため、データベースの準備と時刻の固定なしでは検証をテストできない db はモジュールから import され、new Date() は現在の時刻を返すため、呼び出し側は差し替えられません。

    3つが 1 つの関数に混在するため、次の2つの問題が発生します。

  1. 課題1(図の ①): 失敗を例外で投げるため、失敗が型から読み取れません。S04 の方法を適用して解決します。
  2. 課題2(図の ②): 条件の検証と時刻の取得やデータベースへの保存の分け方に関する新しい課題です。条件の検証が時刻の取得やデータベースへの保存と混在し、データベースの準備と時刻の固定なしでは検証をテストできません。診察中の予約を通す誤りも、確認を1つ削除する将来の変更も、テストで検出できません。