関数が呼び出し側に求める条件を、事前条件と呼びます。遷移関数では、受け取る予約が特定の状態であることが事前条件に該当します。たとえば startExamination は、kind が CheckedIn の予約を求めます。
-
startExamination は、kind が CheckedIn の予約を求めます。これが、呼び出し側に求める事前条件です。事前条件を検証する時点は、型検査のときと実行時の2つです。
S01 の完成コード examples/session-01-solution/src/domain/appointment/transitions.tsexport const startExamination = ( appointment: CheckedIn, veterinarianId: string, examinationStartedAt: string, ): InExamination => -
S01 の完成コードでは、引数の型 CheckedIn が事前条件を表します。
S01 の完成コード examples/session-01-solution/src/domain/appointment/transitions.tsexport const startExamination = ( appointment: CheckedIn, veterinarianId: string, examinationStartedAt: string, ): InExamination => -
Paid は startExamination の引数の型に代入できないため、Paid 型の値を渡す呼び出しは、実行前の型検査で報告されます。
S01 の完成コード examples/session-01-solution/test/regression/type-fixtures/paid-not-assignable-to-checked-in.tsdeclare const paid: Paid; // @ts-expect-error Paid は startExamination の引数の型に代入できません。 startExamination(paid, clinicFixture.veterinarianId, clinicFixture.scheduledAt); -
型は実行時には消えます。データベースから取得した値は、型検査が中身を検証していません。kind が Paid の値でも、型検査では報告されません。
S01 の完成コード examples/session-01-solution/src/adaptor/primary/web/routes.tsif (current.kind !== "CheckedIn") throw new Error("Invalid appointment state"); -
HTTP リクエストを受ける関数(routes.ts)は、データベースから取得した予約 current の kind を検証します。CheckedIn でなければ例外を投げ、startExamination を呼びません。不正な値は、実行時にこの検証で検出します。
S01 の完成コード examples/session-01-solution/src/adaptor/primary/web/routes.tsif (current.kind !== "CheckedIn") throw new Error("Invalid appointment state"); -
kind が CheckedIn の予約は、検証を通り、startExamination が実行されます。型は誤った呼び出しを実行前に検出し、実行時の検証は、型検査の対象外の値を実行時に検出します。
S01 の完成コード examples/session-01-solution/src/domain/appointment/transitions.tsexport const startExamination = ( appointment: CheckedIn, veterinarianId: string, examinationStartedAt: string, ): InExamination =>