ホーム 全セッション S01

事前条件

発展 2 / 3 目安 時間外

ページ一覧

あとで読む: 型と実行時の検証が、事前条件をそれぞれいつ検証するかを比較します。

関数が呼び出し側に求める条件を、事前条件と呼びます。遷移関数では、受け取る予約が特定の状態であることが事前条件に該当します。たとえば startExamination は、kind が CheckedIn の予約を求めます。

事前条件を検証する2つの時点 上の帯は、型検査のときです。呼び出し側が startExamination を呼ぶ前に、引数の型 CheckedIn の検証があります。Paid 型の値はこの検証で報告されます。下の帯は、実行時です。HTTP リクエストを受ける関数(routes.ts)から startExamination へ進む間に、データベースから取得した予約 current の current.kind の検証があります。kind が Paid の値は、この検証で検出されます。kind が CheckedIn の予約は、検証を通って startExamination に渡されます。 型検査のとき(コードを実行する前) 呼び出し側 × ✓ 引数の型CheckedIn × ✓ startExamination × ✓ Paid 実行時 routes.ts × ✓ current.kindの検証 × ✓ startExamination × ✓ kind: Paid
  1. startExamination は、kind が CheckedIn の予約を求めます。これが、呼び出し側に求める事前条件です。事前条件を検証する時点は、型検査のときと実行時の2つです。

    S01 の完成コード examples/session-01-solution/src/domain/appointment/transitions.ts
    export const startExamination = (
      appointment: CheckedIn,
      veterinarianId: string,
      examinationStartedAt: string,
    ): InExamination =>
  2. S01 の完成コードでは、引数の型 CheckedIn が事前条件を表します。

    S01 の完成コード examples/session-01-solution/src/domain/appointment/transitions.ts
    export const startExamination = (
      appointment: CheckedIn,
      veterinarianId: string,
      examinationStartedAt: string,
    ): InExamination =>
  3. Paid は startExamination の引数の型に代入できないため、Paid 型の値を渡す呼び出しは、実行前の型検査で報告されます。

    S01 の完成コード examples/session-01-solution/test/regression/type-fixtures/paid-not-assignable-to-checked-in.ts
    declare const paid: Paid;
    
    // @ts-expect-error Paid は startExamination の引数の型に代入できません。
    startExamination(paid, clinicFixture.veterinarianId, clinicFixture.scheduledAt);
  4. 型は実行時には消えます。データベースから取得した値は、型検査が中身を検証していません。kind が Paid の値でも、型検査では報告されません。

    S01 の完成コード examples/session-01-solution/src/adaptor/primary/web/routes.ts
    if (current.kind !== "CheckedIn") throw new Error("Invalid appointment state");
  5. HTTP リクエストを受ける関数(routes.ts)は、データベースから取得した予約 current の kind を検証します。CheckedIn でなければ例外を投げ、startExamination を呼びません。不正な値は、実行時にこの検証で検出します。

    S01 の完成コード examples/session-01-solution/src/adaptor/primary/web/routes.ts
    if (current.kind !== "CheckedIn") throw new Error("Invalid appointment state");
  6. kind が CheckedIn の予約は、検証を通り、startExamination が実行されます。型は誤った呼び出しを実行前に検出し、実行時の検証は、型検査の対象外の値を実行時に検出します。

    S01 の完成コード examples/session-01-solution/src/domain/appointment/transitions.ts
    export const startExamination = (
      appointment: CheckedIn,
      veterinarianId: string,
      examinationStartedAt: string,
    ): InExamination =>