ホーム 全セッション Final

ルールの適用範囲を広げたときの3件の指摘

7 / 10 目安 1.5分

ページ一覧

解決策: 課題2に答えます。Linter の指摘に対して、コードを修正するか、ルールを修正するか、理由を付けて残すかを判断します。

各 Session の模範の Linter ルールを、参照実装の src(168ファイル)に適用すると、指摘は app.ts の1件です。clock の実装 systemClock が new Date() を呼ぶ箇所です。診察開始以外のユースケースも守るため、S04 の throw のルールと S06 の new Date のルールを src/useCase 全体に適用します。clock の実装は対象外であるため、この時点の app.ts の1件は、対象外にします。new Date のルールは、広げすぎた場合に何が起きるかを確認するため、引数のある場合も検出する形で試します。適用範囲を src/useCase 全体に広げると、指摘は new Date の2件と throw の1件の計3件になります。各カードで対処を1つ選ぶと、結果が表示されます。合否はありません。

new Date(2件)

examples/final/src/useCase/logInUseCase.ts:84 と setUpInitialAdminUseCase.ts:77
new Date(Date.parse(occurredAt) + sessionDurationMs).toISOString()

選ぶと、ここにその対処の結果が表示されます。

コードを修正する(この教材の判断ではない)

指摘は消えますが、この行は受け取った時刻から計算しているだけで、現在時刻を取得していません。正しいコードを、誤検知に合わせて書き換えることになります。

ルールを修正する(この教材の判断)

ルールを、引数なしの new Date() だけを対象にする形に戻します。2件の指摘が消えます。現在時刻を取得する Date.now() は別のルールで検出されるため、検出できる範囲は減りません。

理由を付けて残す(この教材の判断ではない)

2件に理由のコメントが必要です。引数のある new Date を書くたびに同じコメントが増え、ルールの誤りをコード側で打ち消し続けます。

throw(1件)

examples/final/src/useCase/rejectExamResultPetMismatch.ts:3-9
export const rejectExamResultPetMismatch = (
  mismatch: ExamResultPetMismatch,
): never => {
  throw new TypeError(
    `Corrupt follow-up candidate: appointment ${mismatch.appointmentId} expects pet ${mismatch.expectedPetId} but its exam result has pet ${mismatch.actualPetId}`,
  );
};

選ぶと、ここにその対処の結果が表示されます。

コードを修正する(この教材の判断ではない)

throw を Err に変えると、利用者が選べる操作のない破損データを、業務の失敗として返すことになります。S06 では、このような障害を例外のまま渡しました。

ルールを修正する(この教材の判断ではない)

useCase の throw を対象外にすると、業務の失敗を throw する誤りも検出されなくなります。1件のために、ルール全体を弱めることになります。

理由を付けて残す(この教材の判断)

この throw は、保存済みのデータの破損を検出したときに投げます。Err にせず例外の境界へ渡すため、この行だけ、理由のコメントを付けてルールを無効にします。