ホーム 全セッション S01

開始コードが誤りを実行前に検出できない原因

3 / 10 目安 1分

ページ一覧

課題: 誤った呼び出しを、現在のコードが実行前に検出できない理由を確認します。

業務イベントごとに予約の状態を変える関数を、この Session では遷移関数と呼びます。この Session の開始コード(examples/session-01)は、状態の名前を格納する項目 kind で 6 つの状態を分け、状態ごとの遷移関数を持ちます。

遷移関数には、requireKind で例外(処理を中断してエラーを知らせる仕組み)を投げる検証があります。残る問題は、コードの誤りを検出できるのが実行したときだけであることです。startExamination の引数の型が Appointment であり、どの状態の予約も受け取るためです。この Session の目的は、誤った状態の予約を渡すコードの誤りを型検査のときに検出することで、ゴールは、遷移関数の引数を、受け取れる状態の型に絞ることです。

S01 の開始コード examples/session-01/src/domain/appointment/transitions.ts
export const startExamination = (
  appointment: Appointment,
  veterinarianId: string,
  examinationStartedAt: string,
): Appointment => {
  requireKind(appointment, ["CheckedIn"]);
  return ({ ...appointment, kind: "InExamination", veterinarianId, examinationStartedAt }) as Appointment;
};

startExamination の入口 引数の型は Appointment。6つの状態をすべて受け取ります。

  1. 予約済み Scheduled 型検査: 受け取る 実行: × 例外
  2. 来院済み CheckedIn 型検査: 受け取る 実行: ✓ 診察中になる
  3. 診察中 InExamination 型検査: 受け取る 実行: × 例外
  4. 会計待ち AwaitingPayment 型検査: 受け取る 実行: × 例外
  5. 会計済み Paid 型検査: 受け取る 実行: × 例外
  6. キャンセル Canceled 型検査: 受け取る 実行: × 例外
  1. 予約済みの予約も、引数の型 Appointment は受け取ります。型検査は報告しません。実行すると、requireKind が例外を投げます。requireKind は、kind が許可された状態でなければ例外を投げる関数です。

  2. 来院済みの予約は、診察を開始してよい状態です。型検査も、実行時の requireKind も通ります。

  3. 診察中、会計待ち、会計済み、キャンセルの予約も、引数の型 Appointment は受け取ります。型検査は報告せず、実行すると requireKind が例外を投げます。

  4. 型検査は、6つの状態をすべて受け取ります。許可されない状態の予約を渡すコードの誤りを検出できるのは、実行したときだけです。