遷移関数は、現在時刻を関数の中で取得せず、examinationStartedAt のような引数で受け取ります。この Session の開始コードの遷移関数も、時刻を引数で受け取っています。図の修正後のコードは、この Session の完成形です。次の図は、時刻を引数で受け取る形にしている理由を示します。
時刻を引数で受け取ると、同じ入力から同じ結果になる
時刻を内部で取得する書き方 時刻を内部で取得する書き方時刻を引数で受け取る書き方まとめ 時刻を内部で取得する書き方の startExamination は、関数の中で new Date() を呼んで現在時刻を取得します。時刻は引数にないため、呼び出し側からは把握できません。
同じ予約と同じ獣医師 ID を渡しても、呼んだ時刻によって結果が変わります。呼ぶ時刻で結果が変わるため、テストで期待値を固定できません。
戻り値を返す以外に、関数の外の世界を参照したり変更したりすることを副作用と呼びます。副作用の例は、現在時刻の取得、乱数の生成、データベースへの保存、ログの出力です。
時刻を引数で受け取る書き方では、時刻を取得する処理が呼び出し側へ移り、関数の中から副作用がなくなります。
同じ引数なら、いつ呼んでも同じ結果を返します。副作用がなく、同じ入力から必ず同じ結果を返す関数を純粋関数と呼びます。テストでは時刻を固定して結果を比べられます。
副作用は呼び出し側にまとめ、状態遷移の判断は純粋関数に残します。データベースの読み取りと保存の役割は S05、時刻と ID の作り方と保存のまとめ方は S06 で扱います。
-
時刻を内部で取得する書き方 時刻を内部で取得する書き方の startExamination は、関数の中で new Date() を呼んで現在時刻を取得します。時刻は引数にないため、呼び出し側からは把握できません。
仮の書き方 startExamination(説明用。教材のコードにはありません) export const startExamination = (
appointment: CheckedIn,
veterinarianId: string,
): InExamination =>
({
...appointment,
kind: "InExamination",
veterinarianId,
examinationStartedAt: new Date().toISOString(),
}) as const satisfies InExamination;
-
時刻を内部で取得する書き方 同じ予約と同じ獣医師 ID を渡しても、呼んだ時刻によって結果が変わります。呼ぶ時刻で結果が変わるため、テストで期待値を固定できません。
仮の書き方 startExamination(説明用。教材のコードにはありません) export const startExamination = (
appointment: CheckedIn,
veterinarianId: string,
): InExamination =>
({
...appointment,
kind: "InExamination",
veterinarianId,
examinationStartedAt: new Date().toISOString(),
}) as const satisfies InExamination;
-
時刻を内部で取得する書き方 戻り値を返す以外に、関数の外の世界を参照したり変更したりすることを副作用と呼びます。副作用の例は、現在時刻の取得、乱数の生成、データベースへの保存、ログの出力です。
仮の書き方 startExamination(説明用。教材のコードにはありません) export const startExamination = (
appointment: CheckedIn,
veterinarianId: string,
): InExamination =>
({
...appointment,
kind: "InExamination",
veterinarianId,
examinationStartedAt: new Date().toISOString(),
}) as const satisfies InExamination;
-
時刻を引数で受け取る書き方 時刻を引数で受け取る書き方では、時刻を取得する処理が呼び出し側へ移り、関数の中から副作用がなくなります。
修正後 examples/session-01-solution/src/domain/appointment/transitions.ts:16-26 export const startExamination = (
appointment: CheckedIn,
veterinarianId: string,
examinationStartedAt: string,
): InExamination =>
({
...appointment,
kind: "InExamination",
veterinarianId,
examinationStartedAt,
}) as const satisfies InExamination;
-
時刻を引数で受け取る書き方 同じ引数なら、いつ呼んでも同じ結果を返します。副作用がなく、同じ入力から必ず同じ結果を返す関数を純粋関数と呼びます。テストでは時刻を固定して結果を比べられます。
修正後 examples/session-01-solution/src/domain/appointment/transitions.ts:16-26 export const startExamination = (
appointment: CheckedIn,
veterinarianId: string,
examinationStartedAt: string,
): InExamination =>
({
...appointment,
kind: "InExamination",
veterinarianId,
examinationStartedAt,
}) as const satisfies InExamination;
-
まとめ 副作用は呼び出し側にまとめ、状態遷移の判断は純粋関数に残します。データベースの読み取りと保存の役割は S05、時刻と ID の作り方と保存のまとめ方は S06 で扱います。
修正後 examples/session-01-solution/src/domain/appointment/transitions.ts:16-26 export const startExamination = (
appointment: CheckedIn,
veterinarianId: string,
examinationStartedAt: string,
): InExamination =>
({
...appointment,
kind: "InExamination",
veterinarianId,
examinationStartedAt,
}) as const satisfies InExamination;