課題1の準備として、Err に含める値へ kind(失敗の種類を表す項目)を付けます。
-
予約が見つからないとき、err に、失敗の種類を表す kind が "AppointmentNotFound" の値を格納します。この値には、どの予約かを表す appointmentId も付きます。
コード examples/session-04-solution/src/useCase/errors.ts:18-24export const ensureAppointmentFound = ( appointment: Appointment | undefined, appointmentId: AppointmentId, ): Result<Appointment, AppointmentNotFound> => appointment === undefined ? err({ kind: "AppointmentNotFound", appointmentId }) : ok(appointment);Err の中身
kind
"AppointmentNotFound"appointmentIdどの予約か -
状態不正のときは、err に、kind が "InvalidAppointmentState" の値を格納します。この値には、現在の状態 actual も付きます。
コード examples/session-04-solution/src/useCase/errors.ts:26-31export const ensureCheckedIn = ( appointment: Appointment, ): Result<CheckedIn, InvalidAppointmentState> => appointment.kind === "CheckedIn" ? ok(appointment) : err({ kind: "InvalidAppointmentState", actual: appointment.kind });Err の中身
kind
"InvalidAppointmentState"actual現在の状態(例: "Scheduled") -
kind を持つ2つの型を | で組み合わせると、診察開始の失敗の型 StartExaminationError になります。Result の2つ目の型に含まれるため、戻り値の型から、発生しうる失敗が読み取れます。
コード examples/session-04-solution/src/useCase/errors.ts:6-16export 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)AppointmentNotFoundInvalidAppointmentState
予約が見つからない失敗が AppointmentNotFound、状態不正が InvalidAppointmentState です。actual には予約の現在の状態が格納されます。2つを | で組み合わせた型(ユニオン型)が StartExaminationError で、診察開始の失敗の型です。kind の使い方は、S01 で確認した Discriminated Union と同じです。
図の2コマ目(状態不正の例)のコードにある ensureCheckedIn は、予約が受付済みかを判定する業務ロジックです。S00 では、業務ロジックを domain/ に実装すると説明しました。ただし、ensureCheckedIn は複数の useCase が共有しない判定であるため、useCase/errors.ts に置いています。
ここまでで、失敗に種類を付けて、戻り値の型に表せます。