ホーム 全セッション S01

純粋関数

発展 1 / 3 目安 時間外

ページ一覧

あとで読む: 遷移関数が現在時刻を引数で受け取る理由と、副作用と純粋関数の意味を学びます。

遷移関数は、現在時刻を関数の中で取得せず、examinationStartedAt のような引数で受け取ります。この Session の開始コードの遷移関数も、時刻を引数で受け取っています。図の修正後のコードは、この Session の完成形です。次の図は、時刻を引数で受け取る形にしている理由を示します。

時刻を引数で受け取ると、同じ入力から同じ結果になる
  1. 時刻を内部で取得する書き方 startExaminationnew Date()現在時刻を取得する副作用なし予約CheckedIn獣医師 IDstring時刻string出力InExamination関数副作用あり関数の外の世界現在時刻を取得するデータベースへ保存ログを出力する10:00 に呼ぶ同じ予約と獣医師 ID1回目に呼ぶ同じ予約と獣医師 ID同じ時刻 10:00startExaminationstartExaminationInExaminationexaminationStartedAt:"10:00""10:00"10:05 に呼ぶ同じ予約と獣医師 ID2回目に呼ぶ同じ予約と獣医師 ID同じ時刻 10:00startExaminationstartExaminationInExaminationexaminationStartedAt:"10:05""10:00"≠=呼び出し側時刻を取得するデータベースに保存するstartExamination純粋な遷移関数(状態遷移の判断)

    時刻を内部で取得する書き方の startExamination は、関数の中で new Date() を呼んで現在時刻を取得します。時刻は引数にないため、呼び出し側からは把握できません。

    仮の書き方 startExamination(説明用。教材のコードにはありません)
    export const startExamination = (
      appointment: CheckedIn,
      veterinarianId: string,
    ): InExamination =>
      ({
        ...appointment,
        kind: "InExamination",
        veterinarianId,
        examinationStartedAt: new Date().toISOString(),
      }) as const satisfies InExamination;
  2. 時刻を内部で取得する書き方 startExaminationnew Date()現在時刻を取得する副作用なし予約CheckedIn獣医師 IDstring時刻string出力InExamination関数副作用あり関数の外の世界現在時刻を取得するデータベースへ保存ログを出力する10:00 に呼ぶ同じ予約と獣医師 ID1回目に呼ぶ同じ予約と獣医師 ID同じ時刻 10:00startExaminationstartExaminationInExaminationexaminationStartedAt:"10:00""10:00"10:05 に呼ぶ同じ予約と獣医師 ID2回目に呼ぶ同じ予約と獣医師 ID同じ時刻 10:00startExaminationstartExaminationInExaminationexaminationStartedAt:"10:05""10:00"≠=呼び出し側時刻を取得するデータベースに保存するstartExamination純粋な遷移関数(状態遷移の判断)

    同じ予約と同じ獣医師 ID を渡しても、呼んだ時刻によって結果が変わります。呼ぶ時刻で結果が変わるため、テストで期待値を固定できません。

    仮の書き方 startExamination(説明用。教材のコードにはありません)
    export const startExamination = (
      appointment: CheckedIn,
      veterinarianId: string,
    ): InExamination =>
      ({
        ...appointment,
        kind: "InExamination",
        veterinarianId,
        examinationStartedAt: new Date().toISOString(),
      }) as const satisfies InExamination;
  3. 時刻を内部で取得する書き方 startExaminationnew Date()現在時刻を取得する副作用なし予約CheckedIn獣医師 IDstring時刻string出力InExamination関数副作用あり関数の外の世界現在時刻を取得するデータベースへ保存ログを出力する10:00 に呼ぶ同じ予約と獣医師 ID1回目に呼ぶ同じ予約と獣医師 ID同じ時刻 10:00startExaminationstartExaminationInExaminationexaminationStartedAt:"10:00""10:00"10:05 に呼ぶ同じ予約と獣医師 ID2回目に呼ぶ同じ予約と獣医師 ID同じ時刻 10:00startExaminationstartExaminationInExaminationexaminationStartedAt:"10:05""10:00"≠=呼び出し側時刻を取得するデータベースに保存するstartExamination純粋な遷移関数(状態遷移の判断)

    戻り値を返す以外に、関数の外の世界を参照したり変更したりすることを副作用と呼びます。副作用の例は、現在時刻の取得、乱数の生成、データベースへの保存、ログの出力です。

    仮の書き方 startExamination(説明用。教材のコードにはありません)
    export const startExamination = (
      appointment: CheckedIn,
      veterinarianId: string,
    ): InExamination =>
      ({
        ...appointment,
        kind: "InExamination",
        veterinarianId,
        examinationStartedAt: new Date().toISOString(),
      }) as const satisfies InExamination;
  4. 時刻を引数で受け取る書き方 startExaminationnew Date()現在時刻を取得する副作用なし予約CheckedIn獣医師 IDstring時刻string出力InExamination関数副作用あり関数の外の世界現在時刻を取得するデータベースへ保存ログを出力する10:00 に呼ぶ同じ予約と獣医師 ID1回目に呼ぶ同じ予約と獣医師 ID同じ時刻 10:00startExaminationstartExaminationInExaminationexaminationStartedAt:"10:00""10:00"10:05 に呼ぶ同じ予約と獣医師 ID2回目に呼ぶ同じ予約と獣医師 ID同じ時刻 10:00startExaminationstartExaminationInExaminationexaminationStartedAt:"10:05""10:00"≠=呼び出し側時刻を取得するデータベースに保存するstartExamination純粋な遷移関数(状態遷移の判断)

    時刻を引数で受け取る書き方では、時刻を取得する処理が呼び出し側へ移り、関数の中から副作用がなくなります。

    修正後 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;
  5. 時刻を引数で受け取る書き方 startExaminationnew Date()現在時刻を取得する副作用なし予約CheckedIn獣医師 IDstring時刻string出力InExamination関数副作用あり関数の外の世界現在時刻を取得するデータベースへ保存ログを出力する10:00 に呼ぶ同じ予約と獣医師 ID1回目に呼ぶ同じ予約と獣医師 ID同じ時刻 10:00startExaminationstartExaminationInExaminationexaminationStartedAt:"10:00""10:00"10:05 に呼ぶ同じ予約と獣医師 ID2回目に呼ぶ同じ予約と獣医師 ID同じ時刻 10:00startExaminationstartExaminationInExaminationexaminationStartedAt:"10:05""10:00"≠=呼び出し側時刻を取得するデータベースに保存するstartExamination純粋な遷移関数(状態遷移の判断)

    同じ引数なら、いつ呼んでも同じ結果を返します。副作用がなく、同じ入力から必ず同じ結果を返す関数を純粋関数と呼びます。テストでは時刻を固定して結果を比べられます。

    修正後 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;
  6. まとめ startExaminationnew Date()現在時刻を取得する副作用なし予約CheckedIn獣医師 IDstring時刻string出力InExamination関数副作用あり関数の外の世界現在時刻を取得するデータベースへ保存ログを出力する10:00 に呼ぶ同じ予約と獣医師 ID1回目に呼ぶ同じ予約と獣医師 ID同じ時刻 10:00startExaminationstartExaminationInExaminationexaminationStartedAt:"10:00""10:00"10:05 に呼ぶ同じ予約と獣医師 ID2回目に呼ぶ同じ予約と獣医師 ID同じ時刻 10:00startExaminationstartExaminationInExaminationexaminationStartedAt:"10:05""10:00"≠=呼び出し側時刻を取得するデータベースに保存するstartExamination純粋な遷移関数(状態遷移の判断)

    副作用は呼び出し側にまとめ、状態遷移の判断は純粋関数に残します。データベースの読み取りと保存の役割は 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;