12. オブジェクトの型

オブジェクトの型は、プロパティ名と型の組を波カッコで並べて書きます。{ name: string; age: number } のような形で、それぞれのプロパティがどんな型かを指定します。

オブジェクトに型を付けると、プロパティ名のタイプミスや、必要なプロパティの入れ忘れをコンパイラが検出してくれます。API のレスポンスや設定値など、実務のデータはほぼオブジェクトなので、最も出番の多い型の書き方です。

関数の引数にもそのまま書けます。「この関数は name と age を持つオブジェクトを受け取る」と宣言でき、呼び出し側が形の違うオブジェクトを渡すと即座にエラーになります。

▶ サンプルコードを実行してみよう(自由に書き換えてOK)

TypeScript

const user: { name: string; age: number } = {
  name: "Taro",
  age: 28,
};

console.log(user.name);
console.log(user.age);

// 引数の型としても書ける
function describe(target: { name: string; age: number }): string {
  return target.name + "(" + target.age + "歳)";
}
console.log(describe(user));
// console.log(user.nmae); // プロパティ名の打ち間違いはエラー

公式ドキュメントで詳しく ↗