型アサーション
CoddyのJavaScriptジャーニー「Introduction To TypeScript」セクションの一部。レッスン 68/73。
TypeScriptには、値の正確な型を判断するための情報が十分にない場合があります。しかし、開発者であるあなたは、その値が実際には何であるかをよりよく知っています。型アサーションを使うと、TypeScriptに「信じてください。この値はこの特定の型です」と伝えることができます。
TypeScriptでは、型アサーションに2つの構文が用意されています。より一般的なのはas構文です。
let data: unknown = '{"name": "John", "age": 30}';
let user = data as string;山括弧構文を使うこともできますが、現代のTypeScriptではあまり一般的ではありません。
let data: unknown = '{"name": "John", "age": 30}';
let user = <string>data;オブジェクトでも同じことができます。値がunknownとして渡されたとき、期待する形をアサートしてから、そのプロパティを読み取れます。
let payload: unknown = { name: "John", age: 30 };
let user = payload as { name: string; age: number };
console.log(user.name);アサーションは、TypeScript が値について認識する内容を変えるだけです。実行時に何かを変換するわけではないため、その値が実際にその形を持つと分かっている場合にのみ、形状をアサートしてください。
チャレンジ
簡単外部APIのシミュレーションからデータを処理する関数を作成しましょう。unknown型の値を扱い、型アサーションを使ってプロパティに安全にアクセスします。
unknown型の変数apiResponseを作成し、次のJSON文字列を代入します。
{"userId": 42, "username": "alice_dev", "isActive": true}次の処理を行う、processUserDataという名前の関数を作成します。
unknown型のパラメーターdataを受け取る- 型アサーションを使い、
dataをstringとして扱う JSON.parse()を使ってJSON文字列を解析する- 別の型アサーションを使い、解析結果を
userId(number)、username(string)、isActive(boolean)の各プロパティを持つオブジェクトとして扱う - 書式化した文字列
"User [userId]: [username] (Active: [isActive])"を返す - 明示的な戻り値の型として
stringを指定する
追加のテストデータを作成します。
unknown型のsecondApiResponseを作成し、次のJSON文字列を設定する:{"userId": 15, "username": "bob_admin", "isActive": false}unknown型のthirdApiResponseを作成し、次のJSON文字列を設定する:{"userId": 99, "username": "charlie_user", "isActive": true}
関数をテストし、次の出力を表示します。
apiResponseを指定してprocessUserDataを呼び出し、結果を表示するsecondApiResponseを指定してprocessUserDataを呼び出し、結果を表示するthirdApiResponseを指定してprocessUserDataを呼び出し、結果を表示する
自分で試してみよう
// APIレスポンスの変数を作成する
const apiResponse: unknown = '{"userId": 42, "username": "alice_dev", "isActive": true}';
const secondApiResponse: unknown = '{"userId": 15, "username": "bob_admin", "isActive": false}';
const thirdApiResponse: unknown = '{"userId": 99, "username": "charlie_user", "isActive": true}';
// TODO: ここにprocessUserData関数を作成する
// 関数をテストし、結果を出力する
console.log(processUserData(apiResponse));
console.log(processUserData(secondApiResponse));
console.log(processUserData(thirdApiResponse));このレッスンには短いクイズがあります。レッスンを始めて解答し、進捗を記録しましょう。
Introduction To TypeScriptのすべてのレッスン
5型:エイリアス、ユニオン型、インターセクション型
プリミティブ型の型エイリアスユニオン型 ('|')ユニオン型の扱い方リテラル型インターセクション型 ('&')型エイリアスの組み合わせまとめ:高度な型の組み合わせ自分で練習してみよう: TypeScriptプレイグラウンド