初級

必須プロパティの書き忘れエラーの原因と直し方

interfaceで定義した必須プロパティを、オブジェクトリテラルで指定し忘れたときに出るエラーです。1つでも足りないプロパティがあれば、その型の値として代入できません。

エラーメッセージの読み方

main.ts(5,7): error TS2741: Property 'age' is missing in type '{ name: string; }' but required in type 'User'.

main.ts

ファイル名

5

行番号

7

列番号 — この位置でtscが検査に失敗しました

TS2741

エラーコード — 検索するとTypeScriptの解説が見つかります

Property 'age' is missing in type '{ name: string; }' but required in type 'User'.

内容 — 期待していたもの、または受け付けられなかったもの

このエラーが出る典型パターン

 1  interface User {
 2    name: string;
 3    age: number;
 4  }
 5  const u: User = { name: "Al" }         ;
                               ^
 6  console.log(u.age);

 1  interface Point {
 2    x: number;
 3    y: number;
 4  }
 5  const p: Point = { x: 1 }      ;
                            ^
 6  console.log(p.y);

 1  interface Item {
 2    name: string;
 3    price: number;
 4  }
 5  const item: Item = { price: 500 }             ;
                                    ^
 6  console.log(item.price);

 1  interface Car {
 2    brand: string;
 3    year: number;
 4  }
 5  const c: Car = { brand: "Toyota" }            ;
                                  ^
 6  console.log(c.year);

 1  interface Pair {
 2    a: number;
 3    b: number;
 4  }
 5  const p: Pair = { a: 1 }      ;
                           ^
 6  console.log(p.b);

よくある誤解

「一部のプロパティだけ先に埋めて、あとから追加すればいい」という感覚はTypeScriptのオブジェクトリテラルには通用しません。型に必須と宣言されたプロパティは、作成の時点ですべて揃っている必要があります。

実務での勘所

本当に段階的にプロパティを埋めていきたい場合は、Partial<T>というユーティリティ型を使う手があります。Partial<User>は、Userの全プロパティを省略可能にした別の型で、これを使えば「まだ全部揃っていない途中の状態」を型として正直に表現できます。全プロパティが揃った後で、あらためてUser型として扱いたい場合は、型アサーションや検証関数を通すことで意図を明示します。「全部揃っていないなら、揃っていないことを型で表す」という考え方が、TypeScriptらしい解決策です。

演習をはじめる

関連するエラー

• is not assignable to type の原因と直し方変数への代入・関数の戻り値・プロパティへの代入など、宣言した型と違う型の値を渡そうとしたときにtscが検出するエラーです。
• 未定義プロパティを書いたエラーの原因と直し方interfaceに定義されていないプロパティを、オブジェクトリテラルに書いてしまったときに出るエラーです。
• Property does not exist on type の原因と直し方型に定義されていないプロパティ名でアクセスしようとしたときに出るエラーです。