ホーム 全セッション S04

失敗の種類の定義

5 / 19 目安 0.5分

ページ一覧

事前知識(課題1の準備): Err に含める失敗に、種類を付けます。

課題1の準備として、Err に含める値へ kind(失敗の種類を表す項目)を付けます。

  1. 予約が見つからないとき、err に、失敗の種類を表す kind が "AppointmentNotFound" の値を格納します。この値には、どの予約かを表す appointmentId も付きます。

    コードexamples/session-04-solution/src/useCase/errors.ts:18-24
    export const ensureAppointmentFound = (
      appointment: Appointment | undefined,
      appointmentId: AppointmentId,
    ): Result<Appointment, AppointmentNotFound> =>
      appointment === undefined
        ? err({ kind: "AppointmentNotFound", appointmentId })
        : ok(appointment);

    Err の中身

    kind"AppointmentNotFound"

    appointmentIdどの予約か

  2. 状態不正のときは、err に、kind が "InvalidAppointmentState" の値を格納します。この値には、現在の状態 actual も付きます。

    コードexamples/session-04-solution/src/useCase/errors.ts:26-31
    export const ensureCheckedIn = (
      appointment: Appointment,
    ): Result<CheckedIn, InvalidAppointmentState> =>
      appointment.kind === "CheckedIn"
        ? ok(appointment)
        : err({ kind: "InvalidAppointmentState", actual: appointment.kind });

    Err の中身

    kind"InvalidAppointmentState"

    actual現在の状態(例: "Scheduled")

  3. kind を持つ2つの型を | で組み合わせると、診察開始の失敗の型 StartExaminationError になります。Result の2つ目の型に含まれるため、戻り値の型から、発生しうる失敗が読み取れます。

    コードexamples/session-04-solution/src/useCase/errors.ts:6-16
    export type AppointmentNotFound = Readonly<{
      kind: "AppointmentNotFound";
      appointmentId: AppointmentId;
    }>;
    
    export type InvalidAppointmentState = Readonly<{
      kind: "InvalidAppointmentState";
      actual: Appointment["kind"];
    }>;
    
    export type StartExaminationError = AppointmentNotFound | InvalidAppointmentState;

    Result<InExamination, StartExaminationError>

    成功の値InExamination
    失敗の値(kind)

    AppointmentNotFound

    InvalidAppointmentState

予約が見つからない失敗が AppointmentNotFound、状態不正が InvalidAppointmentState です。actual には予約の現在の状態が格納されます。2つを | で組み合わせた型(ユニオン型)が StartExaminationError で、診察開始の失敗の型です。kind の使い方は、S01 で確認した Discriminated Union と同じです。

図の2コマ目(状態不正の例)のコードにある ensureCheckedIn は、予約が受付済みかを判定する業務ロジックです。S00 では、業務ロジックを domain/ に実装すると説明しました。ただし、ensureCheckedIn は複数の useCase が共有しない判定であるため、useCase/errors.ts に置いています。

ここまでで、失敗に種類を付けて、戻り値の型に表せます。