ホーム 全セッション S04

確認の関数の戻り値の Result への変更

4 / 19 目安 1分

ページ一覧

事前知識(課題1の準備): 失敗の理由を型に表すために、確認の関数の戻り値を Result にします。

課題1の準備として、確認の関数(ensure...)の戻り値を Result にします。このページが変更する対象は確認の関数です。useCase の戻り値の変更は、「isErr の分岐の andThen と map への書き換え」のページで行います。

修正前 examples/session-04/src/useCase/errors.ts:4-13
export const ensureAppointmentFound = (
  appointment: Appointment | undefined,
  appointmentId: AppointmentId,
): Appointment => {
  if (appointment === undefined) {
    throw new Error(`Appointment ${appointmentId} was not found`);
  }

  return appointment;
};
修正後 examples/session-04-solution/src/useCase/errors.ts:1(import)と :18-24(ensureAppointmentFound)
import { err, ok, type Result } from "neverthrow";

export const ensureAppointmentFound = (
  appointment: Appointment | undefined,
  appointmentId: AppointmentId,
): Result<Appointment, AppointmentNotFound> =>
  appointment === undefined
    ? err({ kind: "AppointmentNotFound", appointmentId })
    : ok(appointment);

Result は、成功か失敗かを値として表す型です。S03 の Result と、neverthrow(Result 型を提供するライブラリ)の Result は、別の型です。S03 の Result(domain/shared/schemaResult.ts で定義)では、Err が値を持ちません。neverthrow の Err は、失敗の理由の値を持てます。S04 の useCase は neverthrow の Result を返し、route の入力の検査は S03 の Result のままです。

neverthrow の Result は Result<成功の型, 失敗の型> と表記します。成功は ok(値) が返す Ok、失敗は err(値) が返す Err です。修正前は、戻り値の型 Appointment から失敗を読み取れませんでした。修正後は、戻り値の型に失敗が現れます。AppointmentNotFound の定義は次のページで確認します。