宣言ファイルは、別の場所にあるコードを記述します。コンパイラーに取り決めを与えますが、リモートのサービスがその取り決めに従うことを証明することはできません。古いJavaScriptのモジュールをラップしたり、解析したJSONを使ったりするときは、この区別を意識してください。宣言は呼び出し元が頼れる内容と一致しているべきで、実行時の検証はデータが届く境界で行います。
この演習では、インターフェースと型付きのラッパーを通じて宣言を練習し、その後、厳密なnullチェック、unknownのエラー、網羅的なユニオンを復習します。オプションのプロパティでは、値がない場合の扱いを決める必要があります。キャッチしたオブジェクトが自動的にErrorになるわけではありません。判別可能なユニオンを使うと、switchの分岐の抜けをコンパイル時のエラーにできます。コンパイラーのアサーションは意図的に無効な呼び出しを試し、実行時のチェックは有効な境界値が実装を通っても保たれることを確認します。