ホーム 全セッション S04

依存と入力を分けて受け取る関数

14 / 19 目安 1分

ページ一覧

解決策(課題3の準備): 演習のテストで、本物の代わりのオブジェクトを渡す deps を読みます。

教材のコード(Result への変更前)の関数は、依存(deps)を受け取ると、入力(input)を受け取る関数を返す形で実装されています。解答のコードも deps の形は同じで、演習のテストは、この形で deps を渡します。

startExamination input 待ちの関数 本体 依存 deps resolver store ✓ 入力 input 予約ID 獣医師ID 開始時刻 ✓

deps の中身の出どころ

  • 本物の保存先(データベース)
  • テスト用の Store
  1. 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
  2. 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
  3. 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
  4. 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
  5. 演習のテストは、固定の予約を返す 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
  6. (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 を呼び出せます。