3状態を型で表す
通信には3つの結末がある
第2章で、商品一覧を API から取れるようになりました。動くには動きますが、いまの画面には足りないものがあります。
TypeScript (JSX)
const [items, setItems] = useState<Item[]>([]);この形だと、読み込んでいる途中も、通信に失敗したときも、本当に0件のときも、使う人には全部「空っぽの一覧」に見えます。3つの違う出来事が、1つの見た目につぶれています。
旗を足すと組み合わせが増える
よくある直し方は、旗になる state を足すことです。
TypeScript (JSX)
const [items, setItems] = useState<Item[]>([]);
const [loading, setLoading] = useState(true);
const [error, setError] = useState("");これでも一応は書けます。ただ、この3つは別々に動くので「読み込み中なのにエラー文も出ている」「成功しているのに前のエラーが残っている」といった、ありえない組み合わせまで表せてしまいます。旗が増えるほど、書き忘れた組み合わせが画面に出ます。
1つのユニオン型にまとめる
取りうる姿が3つなら、その3つをそのまま型に書きます。たとえば fleama の商品の配送では、梱包中・発送済み・返品を次のように分けられます。
TypeScript (JSX)
type ShipmentState =
| { status: "packing" }
| { status: "shipped"; trackingNumber: string }
| { status: "returned"; reason: string };TypeScript入門で出てきた判別可能なユニオン型です。共通の目印 (ここでは status) で枝を見分けます。3つのうちどれか1つにしかなれないので、ありえない組み合わせはそもそも書けません。
枝の中でしか中身を読めない
TypeScript (JSX)
{shipment.status === "packing" && <p>梱包しています</p>}
{shipment.status === "shipped" && <p>追跡番号 {shipment.trackingNumber}</p>}
{shipment.status === "returned" && <p>返品理由 {shipment.reason}</p>}この例では trackingNumber が読めるのは shipped の枝だけです。商品一覧の LoadState でも同じで、state.items が読めるのは success の枝の中だけです。読み込み中に items を触るコードは、書いた時点で赤くなります。状態の抜け漏れを、目で見て気を付けるのではなく型で潰すのがこの回の要点です。
演習
通信を始めたら loading、届いたら success、失敗したら error に更新する処理は、ひな形に用意してあります。ignore の判定も用意済みです。今回は LoadState の3つの枝を自分で定義し、その目印を使って読み込み中・失敗・商品一覧を出し分けます。
ヒント
まだ開いていません
付箋は 3 枚。下の段ほど答えに近づきます
ヒント 2
ヒント 3答えに近い