型注釈と型定義

TypeScriptの中心となるのが型注釈(type annotation)です。変数や関数の引数・戻り値に対して、: 型名 の形で「この値はどんな型を持つか」を宣言します。ここでは、基本のプリミティブ型と型推論から始め、配列型・any / unknown、そして interface / type によるオブジェクトの型定義まで順に扱います。

1. プリミティブ型

JavaScriptで扱う基本的な値には、以下の3種類のプリミティブ型があります。以降のセクションで、それぞれの型に型注釈を付ける書き方を1つずつ確認します。

  • number: 数値(整数と浮動小数点数の区別はない)
  • string: 文字列
  • boolean: 真偽値(true または false)

1.1 number

数値を型付きの変数として扱いたいときは、number 型で型注釈を書きます。書き方は以下のとおりです。

const 変数名: number = 数値;

次のコードは、number 型の変数を宣言して出力する例です。以下のコードで hello.ts を書き換えます。

const age: number = 30;
console.log(age);

以下のコマンドでコンパイルします。

npx tsc hello.ts

続いて、生成された hello.js を実行します。

node hello.js

以下のような実行結果が表示されます。

30

代入した 30 がそのまま出力されました。

コードを解説します。

const age: number = 30;

変数名 age の直後に : number と型注釈を書き、number 型の値である 30 を代入しています。以降、age は number として扱われ、string 型の値を代入しようとするとコンパイル時にエラーになります。

1.2 string

文字列を型付きの変数として扱いたいときは、string 型で型注釈を書きます。書き方は以下のとおりです。

const 変数名: string = "文字列";

次のコードは、string 型の変数を宣言して出力する例です。以下のコードで hello.ts を書き換えます。

const name: string = "田中太郎";
console.log(name);

以下のコマンドでコンパイルします。

npx tsc hello.ts

続いて、生成された hello.js を実行します。

node hello.js

以下のような実行結果が表示されます。

田中太郎

代入した "田中太郎" がそのまま出力されました。

コードを解説します。

const name: string = "田中太郎";

name に : string と型注釈を書き、文字列 "田中太郎" を代入しています。ダブルクォート・シングルクォート・バッククォートのいずれで囲んでも string として扱われます。

1.3 boolean

真偽値を型付きの変数として扱いたいときは、boolean 型で型注釈を書きます。書き方は以下のとおりです。

const 変数名: boolean = true;

次のコードは、boolean 型の変数を宣言して出力する例です。以下のコードで hello.ts を書き換えます。

const isActive: boolean = true;
console.log(isActive);

以下のコマンドでコンパイルします。

npx tsc hello.ts

続いて、生成された hello.js を実行します。

node hello.js

以下のような実行結果が表示されます。

true

代入した true がそのまま出力されました。

コードを解説します。

const isActive: boolean = true;

isActive に : boolean と型注釈を書き、true を代入しています。boolean は true と false の2値のみを取ります。

2. 型推論

変数に型を事前に定義せずに、代入した値から型を自動で判定してくれる仕組みを、型推論(type inference)と呼びます。TypeScriptでは、宣言と同時に値を代入する場合には代入値から型が推論されるため、: 型名 の記述を省略できます。

次のコードは、型注釈を書かずに宣言した変数に対して、後から違う型の値を代入しようとする例です。以下のコードで hello.ts を書き換えます。

let age = 30;
age = "三十歳";

age は 30 を代入した時点で number として推論されるため、以下のコマンドでコンパイルすると、後から文字列を代入しようとしている行でエラーが表示されます。

npx tsc hello.ts
Type 'string' is not assignable to type 'number'.

Type 'string' is not assignable to type 'number'. のエラーが表示されれば、型注釈を省略した変数でも、推論された型と違う型の値を代入しようとした時点で TypeScript がコンパイル時にエラーとして検出できていることが動作確認できます。

コードを解説します。

let age = 30;

型注釈を書いていませんが、代入値が 30 なので age は number 型として推論されます。以降 age は number として扱われます。

age = "三十歳";

number 型として扱われる変数に文字列を代入しようとしたため、コンパイル時にエラーになります。型推論を使う場合でも、後からの再代入は最初に推論された型で縛られる点に注意します。

3. 配列型

配列に型を付けたいときは、型名[] の形で「要素の型」を指定します。書き方は以下のとおりです。

const 変数名: 要素の型[] = [要素, 要素, /* ... */];

次のコードは、number の配列と string の配列を宣言して出力する例です。以下のコードで hello.ts を書き換えます。

const scores: number[] = [80, 90, 75];
const fruits: string[] = ["apple", "banana", "orange"];

console.log(scores);
console.log(fruits);

以下のコマンドでコンパイルします。

npx tsc hello.ts

続いて、生成された hello.js を実行します。

node hello.js

以下のような実行結果が表示されます。

[ 80, 90, 75 ]
[ 'apple', 'banana', 'orange' ]

scores と fruits が、それぞれ number と string の配列として出力されました。

コードを解説します。

const scores: number[] = [80, 90, 75];

要素の型 number に [] を付け、number[] として配列全体の型を宣言しています。配列に別の型の要素を追加しようとするとコンパイルエラーになります。

const fruits: string[] = ["apple", "banana", "orange"];

要素の型 string に [] を付けた string[] として宣言しています。書き方の形は number[] とまったく同じで、要素の型だけを差し替えます。

Array<型名> というジェネリクスの形でも同じ意味になります。単純な要素型のときは 型名[] が一般的です。

const scores: Array<number> = [80, 90, 75];

配列に違う型の要素を混ぜようとすると、コンパイル時にエラーになります。以下のコードで hello.ts を書き換えます。

const scores: number[] = [80, 90, "満点"];

以下のコマンドでコンパイルすると、エラーが表示されます。

npx tsc hello.ts
Type 'string' is not assignable to type 'number'.

Type 'string' is not assignable to type 'number'. のエラーが表示されれば、配列に宣言した要素型と違う型の値を混ぜたときにコンパイルエラーが出ることが動作確認できます。

any と unknown

TypeScriptには、型を厳密に決められない値を扱うための any と unknown という2つの型があります。用途が似ているようでいて安全性がまったく違うので、それぞれの動きを分けて確認します。

any

型チェックを一時的に無効化したい値には、any を使います。JavaScriptで書かれた既存コードを段階的にTypeScript化する場面など、型を書ききれない箇所のために用意されている型で、あらゆる値を代入でき、プロパティアクセスや演算のチェックも行われません。書き方は以下のとおりです。

let 変数名: any = 値;

次のコードは、any で宣言した変数に別々の型の値を代入し、危険なプロパティアクセスをしても静的解析ではエラーにならない例です。以下のコードで hello.ts を書き換えます。

let value: any = 10;
value = "文字列でもOK";
value = { key: "オブジェクトでもOK" };
value.foo.bar.baz;

以下のコマンドでコンパイルします。コンパイル時にはエラーになりません。

npx tsc hello.ts

続いて、生成された hello.js を実行します。

node hello.js

以下のような実行時エラーが表示されます。

TypeError: Cannot read properties of undefined (reading 'bar')

value.foo.bar.baz のような明らかに危険なアクセスもコンパイル時にはエラーにならず、実際に実行したときに初めて TypeError として現れます。これでは型を導入した意味がありません。

コードを解説します。

let value: any = 10;
value = "文字列でもOK";
value = { key: "オブジェクトでもOK" };

any はあらゆる型を許容するため、number → string → オブジェクトと再代入しても静的解析はエラーになりません。

value.foo.bar.baz;

value は現在オブジェクトですが、foo プロパティを定義していないので実行時に TypeError になります。にもかかわらず、any に対するプロパティアクセスは一切チェックされないため、コンパイル時には問題が検出されません。

unknown

型を厳密に決められないが型安全は維持したいときは、unknown を使います。どんな値でも代入できますが、そのままではプロパティアクセスや演算ができず、typeof や instanceof による型ガードでチェックしてからでないと使えません。書き方は以下のとおりです。

function 関数名(引数名: unknown) {
  if (typeof 引数名 === "型名") {
    // このブロック内では、引数名は指定した型として扱える
  }
}

次のコードは、unknown として受け取った値の型を絞り込んでから、文字列専用のメソッドを呼び出す例です。以下のコードで hello.ts を書き換えます。

function printLength(value: unknown) {
  if (typeof value === "string") {
    console.log(value.length);
  } else {
    console.log("文字列ではありません");
  }
}

printLength("hello");
printLength(123);

以下のコマンドでコンパイルします。

npx tsc hello.ts

続いて、生成された hello.js を実行します。

node hello.js

以下のような実行結果が表示されます。

5
文字列ではありません

"hello" は string として文字数の 5 が返り、123 は文字列ではないメッセージが返りました。

コードを解説します。

function printLength(value: unknown) {

引数 value を unknown として受け取っています。この時点では value.length のようなプロパティアクセスはコンパイル時にエラーとして扱われ、直接使えません。

if (typeof value === "string") {
  console.log(value.length);
}

typeof value === "string" が true の分岐内では、TypeScriptは value を string として扱ってくれます。そのため、string にしかない .length プロパティを安全に使えます。

unknown を経由することで、「値の中身が判明する前に間違った操作をしてしまう」ミスをコンパイル時に防げます。この分岐の仕組み自体は「ユニオン型と型ガード」節でより詳しく扱います。

📝 any を避ける理由
any を許容してしまうと、その値が別の関数に渡された先でもチェックが行われず、型安全が波及的に失われます。どうしても型を書けない値は unknown で受け取り、使う直前に型ガードで絞り込むのが安全です。

interface による定義

オブジェクトの形(どんなプロパティを持ち、それぞれがどんな型か)に名前を付けて再利用したいときは、interface を使います。書き方は以下のとおりです。

interface インターフェース名 {
  プロパティ名: 型;
  // ...
}

次のコードは、User の interface を定義し、その型に沿ったオブジェクトを作る例です。以下のコードで hello.ts を書き換えます。

interface User {
  id: number;
  name: string;
  email: string;
}

const user: User = {
  id: 1,
  name: "田中太郎",
  email: "tanaka@example.com",
};

console.log(user);

以下のコマンドでコンパイルします。

npx tsc hello.ts

続いて、生成された hello.js を実行します。

node hello.js

以下のような実行結果が表示されます。

{ id: 1, name: '田中太郎', email: 'tanaka@example.com' }

interface に沿った形のオブジェクトが user に代入され、そのまま出力されました。

コードを解説します。

interface User {
  id: number;
  name: string;
  email: string;
}

User という名前で、id(number)・name(string)・email(string)の3つのプロパティを持つオブジェクトの型を定義しています。プロパティ名の直後に : を書き、続けてその値の型を並べます。

const user: User = {
  id: 1,
  name: "田中太郎",
  email: "tanaka@example.com",
};

変数 user の型として User を指定しています。代入するオブジェクトは、User で定義したプロパティをすべて備えている必要があります。

プロパティが足りなかったり、余計なプロパティが含まれていたりすると、コンパイル時にエラーとして検出されます。以下のコードで hello.ts を書き換えます。

interface User {
  id: number;
  name: string;
  email: string;
}

const user: User = {
  id: 1,
  name: "田中太郎",
};

以下のコマンドでコンパイルすると、エラーが表示されます。

npx tsc hello.ts
Property 'email' is missing in type '{ id: number; name: string; }' but required in type 'User'.

Property 'email' is missing 〜 のエラーが表示されれば、interface で宣言した必須プロパティが欠けているオブジェクトを、TypeScriptがコンパイル時に検出できていることが動作確認できます。

type による定義

オブジェクトの形に別名を付けたいときは、type でも表現できます。書き方は以下のとおりです。

type 型名 = {
  プロパティ名: 型;
  // ...
};

次のコードは、User を type で定義し、interface と同じように使う例です。以下のコードで hello.ts を書き換えます。

type User = {
  id: number;
  name: string;
  email: string;
};

const user: User = {
  id: 1,
  name: "田中太郎",
  email: "tanaka@example.com",
};

console.log(user);

以下のコマンドでコンパイルします。

npx tsc hello.ts

続いて、生成された hello.js を実行します。

node hello.js

以下のような実行結果が表示されます。

{ id: 1, name: '田中太郎', email: 'tanaka@example.com' }

interface を type に差し替えても、オブジェクトの形の定義としてはまったく同じ結果になります。

コードを解説します。

type User = {
  id: number;
  name: string;
  email: string;
};

type は「任意の型に別名を付ける構文」で、右辺にオブジェクトの形を直接書けます。オブジェクトの形の定義としては interface と互換ですが、type のほうはユニオン型(string | number など)やプリミティブ型の別名にも使える点が異なります。

interface と type の主な違いは以下のとおりです。

観点 interface type
オブジェクトの形の定義 自然に書ける 自然に書ける
ユニオン型(string | number など) 使えない 使える
同名の宣言をマージ できる(宣言のマージ) できない

多くのプロジェクトでは、「オブジェクトの形を表すときは interface、ユニオン型やプリミティブの別名は type」と使い分けるのが慣例です。type に統一しているプロジェクトも多く、どちらでも大きな支障はありません。

4. オプショナルプロパティ

一部のプロパティを省略可能にしたいときは、プロパティ名の後ろに ? を付けます。書き方は以下のとおりです。

interface インターフェース名 {
  必須プロパティ名: 型;
  省略可プロパティ名?: 型;
}

次のコードは、email を省略可能にした User を定義し、email あり・なしの両方でオブジェクトを作る例です。以下のコードで hello.ts を書き換えます。

interface User {
  id: number;
  name: string;
  email?: string;
}

const userA: User = { id: 1, name: "田中太郎" };
const userB: User = { id: 2, name: "鈴木花子", email: "hanako@example.com" };

console.log(userA);
console.log(userB);

以下のコマンドでコンパイルします。

npx tsc hello.ts

続いて、生成された hello.js を実行します。

node hello.js

以下のような実行結果が表示されます。

{ id: 1, name: '田中太郎' }
{ id: 2, name: '鈴木花子', email: 'hanako@example.com' }

email を省略した userA もエラーにならず、email を含めた userB と並行して代入できました。

コードを解説します。

interface User {
  id: number;
  name: string;
  email?: string;
}

email?: string と書くことで「あれば string、無くてもよい」プロパティになります。省略された場合、そのプロパティは undefined として扱われるため、参照時は存在チェックが必要になります。

readonly

宣言後に値を書き換えられないプロパティを表現したいときは、readonly を付けます。書き方は以下のとおりです。

interface インターフェース名 {
  readonly プロパティ名: 型;
}

次のコードは、id を readonly として定義したあとに書き換えようとする例です。以下のコードで hello.ts を書き換えます。

interface User {
  readonly id: number;
  name: string;
}

const user: User = { id: 1, name: "田中太郎" };
user.id = 2;

以下のコマンドでコンパイルすると、エラーが表示されます。

npx tsc hello.ts
Cannot assign to 'id' because it is a read-only property.

Cannot assign to 'id' because it is a read-only property. のエラーが表示されれば、readonly を付けたプロパティに代入しようとした時点で TypeScript がコンパイル時にエラーとして検出できていることが動作確認できます。

コードを解説します。

interface User {
  readonly id: number;
  name: string;
}

readonly を付けたプロパティは、オブジェクトを作るときに一度だけ値を代入できます。以降の再代入はコンパイル時に禁止されるため、識別子(id)のように「後から書き換わってほしくない値」に付けます。

5. ネストしたオブジェクト

オブジェクトのプロパティがさらにオブジェクトになる場合も、同じように interface で型を定義していきます。次のコードは、User の中に住所を表す Address をネストさせた例です。以下のコードで hello.ts を書き換えます。

interface Address {
  city: string;
  zipCode: string;
}

interface User {
  id: number;
  name: string;
  address: Address;
}

const user: User = {
  id: 1,
  name: "田中太郎",
  address: {
    city: "東京都",
    zipCode: "100-0001",
  },
};

console.log(user);

以下のコマンドでコンパイルします。

npx tsc hello.ts

続いて、生成された hello.js を実行します。

node hello.js

以下のような実行結果が表示されます。

{ id: 1, name: '田中太郎', address: { city: '東京都', zipCode: '100-0001' } }

user.address に Address の形のオブジェクトがネストされ、そのまま出力されました。

コードを解説します。

interface Address {
  city: string;
  zipCode: string;
}

Address を独立した interface として定義しています。名前を付けておくことで、他の interface のプロパティとしても再利用できます。

interface User {
  id: number;
  name: string;
  address: Address;
}

User の address プロパティの型として Address を指定しています。ネストしたオブジェクトも、Address のような名前付きの型に切り出すことで意図が読み取りやすくなります。