次の図は、S04 の方法を適用する前のキャンセルを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つの関数の中に、条件の検証、時刻の取得、保存が交互に並んでいます。順に色を付けて確認します。
-
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 で関数の処理を中断します。
-
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 へ書き込む
時刻の取得です。条件の検証の途中で、現在の時刻を取得しています。
-
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)をデータベースへ書き込みます。
-
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(図の ①): 失敗を例外で投げるため、失敗が型から読み取れません。S04 の方法を適用して解決します。
- 課題2(図の ②): 条件の検証と時刻の取得やデータベースへの保存の分け方に関する新しい課題です。条件の検証が時刻の取得やデータベースへの保存と混在し、データベースの準備と時刻の固定なしでは検証をテストできません。診察中の予約を通す誤りも、確認を1つ削除する将来の変更も、テストで検出できません。