Menu
CoddyTech

型アサーション

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 が値について認識する内容を変えるだけです。実行時に何かを変換するわけではないため、その値が実際にその形を持つと分かっている場合にのみ、形状をアサートしてください。

challenge icon

チャレンジ

簡単

外部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));
quiz icon腕試し

このレッスンには短いクイズがあります。レッスンを始めて解答し、進捗を記録しましょう。

Introduction To TypeScriptのすべてのレッスン

自分で練習してみよう: TypeScriptプレイグラウンド