型検査を通過した不正な値は、as による型アサーションなどで実行されることがあります。追加漏れの型エラーも、CI で失敗にしなければ実行できます。このようなコードの誤りによる不正な値を、実行時に検出した場所で例外を発生させて処理を中断する考え方を、fail-fast と呼びます。
- 型検査
- 実行
- 画面
「不明」を返す場合
通過通過通過
× 画面に「不明」と表示される。人が発見する
assertNever を呼ぶ場合
検出 検出 画面へ渡されない
✓ 追加漏れを型検査で検出する
✓ 型エラーを無視して実行した場合は、検出した場所で例外になる
HTTP の入力のように外部から渡される値
型の保証がない
S03 で境界の検査を扱う
examples/session-02/src/domain/appointment/statusLabel.ts:3-20(抜粋) export const toStatusLabel = (appointment: Readonly<{ kind: string }>): string => {
switch (appointment.kind) {
…
default:
return "不明";
}
}; examples/session-02-solution/src/domain/appointment/statusLabel.ts:7-24(抜粋) export const toStatusLabel = (appointment: Appointment): string => {
switch (appointment.kind) {
…
default:
return assertNever(appointment);
}
}; -
defaultが「不明」を返すと、値は実行時に検出されないまま画面に表示されます。誤りを発見するのは、画面を見た人です。 -
assertNeverを呼ぶ分岐は、追加漏れを型検査で検出します。引数の型がneverであるため、caseが漏れている状態を渡すと、型エラーになります。 -
型エラーを無視して実行した場合や、型検査を通過した不正な値は、
assertNeverのthrowで例外になります。例外はそこで処理を中断して不正な値が画面へ渡されるのを防止し、開発者は例外のメッセージに含まれる未対応の値から原因を調査できます。 -
HTTP の入力のように外部から渡される値には、型の保証がありません。外部入力の不正はコードの誤りではなく、発生を想定できる失敗であるため、fail-fast とは分けて扱います。S03 では、外部入力を境界で検査して内側へ渡さない構成を扱います。利用者への応答は S03 では解決しません。