ホーム 全セッション S04

Result で返す業務の失敗

12 / 19 目安 1分

ページ一覧

解決策(課題2): どの失敗を Result で返すかを、利用者の操作で決めます。

課題2の前半です。予約が見つからない失敗と状態不正は、利用者が次の操作を選べます。予約を探し直す、現在の状態を確認する、のどちらかです。この Session では、このような失敗を業務の失敗と呼び、Err で返します。

  1. 獣医師が、存在しない予約IDで診察開始のリクエストを送ります。resolver.resolveById は予約を取得できず、undefined を返します。

  2. ensureAppointmentFound は例外を投げず、AppointmentNotFound を Err として返します。

  3. 結果が Err であるため、後続の andThen と map は呼ばれません。状態遷移も保存も実行されません。

  4. startExamination は Err を値として返します。戻り値の型 Result<InExamination, StartExaminationError> に、この失敗が含まれています。

  5. route の match が失敗側で Err を受け取り、失敗の種類に対応する画面のお知らせを選択します。獣医師は予約を探し直せます。

startExamination破線の枠: Err の値として返る経路

ensureAppointmentFound(
  deps.resolver.resolveById(input.appointmentId),
  input.appointmentId,
)
  .andThen(ensureCheckedIn)
  .map((appointment) =>
    transitionToInExamination(
      appointment,
      input.veterinarianId,
      input.examinationStartedAt,
    ),
  )
  .map((appointment) => {
    deps.store.save(appointment);
    return appointment;
  });
Err を返す

route の match → 画面のお知らせ

return result.match(
  () => context.redirect("/", 303),
  (error) =>
    context.redirect(
      `/?notice=${toStartExaminationNoticeCode(error)}`,
      303,
    ),
);

AppointmentNotFound 「予約が見つかりません」

startExamination の引用元: examples/session-04-solution/src/useCase/startExamination.ts:29-44route の match は、解答のコードから、S06 で扱う副作用と競合の分岐を省略した形です。解答のコードの route: examples/session-04-solution/src/adaptor/primary/web/routes.ts:130-137

Err で返すと、失敗が戻り値の型に現れ、工程の順序が上から読め、呼び出し側が失敗の種類を漏れなく扱えます。