教材のコード(Result への変更前)の関数は、依存(deps)を受け取ると、入力(input)を受け取る関数を返す形で実装されています。解答のコードも deps の形は同じで、演習のテストは、この形で deps を渡します。
deps の中身の出どころ
- 本物の保存先(データベース)
- テスト用の Store
-
startExamination は、最初に依存(deps)を受け取る関数です。deps は、予約を取得する resolver と、予約を保存する store をまとめた値です。
export const startExamination = (deps: Dependencies) => (input: StartExaminationInput): InExamination => { const appointment = ensureAppointmentFound( deps.resolver.resolveById(input.appointmentId), input.appointmentId, ); const checkedIn = ensureCheckedIn(appointment); const next = transitionToInExamination( checkedIn, input.veterinarianId, input.examinationStartedAt, ); deps.store.save(next); return next; };examples/session-04/src/useCase/startExamination.ts:14-30 -
deps を渡しても診察は始まらず、入力を受け取る関数が返されます。この関数が、予約ID、獣医師ID、開始時刻を受け取ります。
export const startExamination = (deps: Dependencies) => (input: StartExaminationInput): InExamination => { const appointment = ensureAppointmentFound( deps.resolver.resolveById(input.appointmentId), input.appointmentId, ); const checkedIn = ensureCheckedIn(appointment); const next = transitionToInExamination( checkedIn, input.veterinarianId, input.examinationStartedAt, ); deps.store.save(next); return next; };examples/session-04/src/useCase/startExamination.ts:14-30 -
input を受け取ると本体が実行されます。本体は、外部とやり取りする処理を deps.resolver と deps.store の呼び出しでだけ実行します。
export const startExamination = (deps: Dependencies) => (input: StartExaminationInput): InExamination => { const appointment = ensureAppointmentFound( deps.resolver.resolveById(input.appointmentId), input.appointmentId, ); const checkedIn = ensureCheckedIn(appointment); const next = transitionToInExamination( checkedIn, input.veterinarianId, input.examinationStartedAt, ); deps.store.save(next); return next; };examples/session-04/src/useCase/startExamination.ts:14-30 -
route は、本物の保存先 store を resolver と store の両方として渡し、続けて input を渡します。S04 の route は、リクエストのたびにこの形で渡します。
startExamination({ resolver: store, store, })({ ...input, examinationStartedAt: "2026-08-30T06:30:00.000Z", });examples/session-04/src/adaptor/primary/web/routes.ts:80-86 -
演習のテストは、固定の予約を返す resolver と、保存された予約を配列 saved に格納する store を渡します。この関数 fakeDependencies は、演習の mine/harness.ts にあります。
export const fakeDependencies = ( options: Readonly<{ resolved: Appointment | undefined; saveError?: Error }>, ) => { const saved: InExamination[] = []; const dependencies: Dependencies = { resolver: { resolveById: () => options.resolved }, store: { save: (appointment) => { saved.push(appointment); if (options.saveError !== undefined) { throw options.saveError; } }, }, }; return { dependencies, saved };examples/session-04-solution/exercises/guard/mine/harness.ts:28-43 -
(deps, input) を1度に受け取る形と比べます。この形は、呼ぶたびに deps も渡します。2回に分ける形は、start を作れば、以後は input だけで呼び出せます。演習のテストは、2回に分ける形で deps を渡します。
1度に受け取る:
(deps, input)startExamination(deps, inputA); startExamination(deps, inputB);呼ぶたびに deps も渡す
2回に分ける:
(deps)(input)const start = startExamination(deps); start(inputA); start(inputB);deps を渡すのは1回。以後は input だけ
(deps) => (input) => の形を読めると、演習のテストで、本物の代わりのオブジェクトを deps として渡し、useCase を呼び出せます。