関数の型

TypeScriptでは値の型を明示する必要があるため、関数の引数や戻り値にも型を付ける必要があります。ここでは、通常の関数・関数型・コールバック・void・非同期関数の順で、それぞれの型の書き方を扱います。

1. 引数と戻り値

関数の引数と戻り値に型を付けたいときは、引数の後ろに : 型名 を、戻り値は引数リストの後ろに : 型名 を書きます。書き方は以下のとおりです。

function 関数名(引数名: 型, 引数名: 型 /* ... */): 戻り値の型 {
  // 処理
}

次のコードは、2つの数値を受け取り、その合計を返す関数の例です。以下のコードで hello.ts を書き換えます。

function add(a: number, b: number): number {
  return a + b;
}

const result: number = add(3, 5);
console.log(result);

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

npx tsc hello.ts

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

node hello.js

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

8

add(3, 5) の戻り値である 8 が result に代入され、出力されました。

コードを解説します。

function add(a: number, b: number): number {

引数 a と b それぞれに : number を付けて型を指定しています。引数リストの後ろの : number は、この関数が返す値の型です。宣言と異なる型を返そうとすると、コンパイルエラーで検出できます。

戻り値の型は省略しても推論されますが、公開する関数では明示することでシグネチャが読みやすくなります。関数内部で誤って別の型を返してしまった場合も、宣言と食い違えばコンパイルエラーとして検出できます。

2. 関数型

引数として関数を受け取ったり、変数に関数を代入したりしたいときは、関数型で表現します。書き方は以下のとおりです。

(引数名: 型, /* ... */) => 戻り値の型

次のコードは、乗算関数を変数に代入し、その変数の型を関数型で先に決めておく例です。以下のコードで hello.ts を書き換えます。

const multiply: (x: number, y: number) => number = (x, y) => x * y;

console.log(multiply(3, 4));

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

npx tsc hello.ts

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

node hello.js

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

12

multiply(3, 4) の結果である 12 が出力されました。

コードを解説します。

const multiply: (x: number, y: number) => number = (x, y) => x * y;

multiply の型として (x: number, y: number) => number を宣言しています。左辺で関数型を先に決めているため、右辺のアロー関数側では引数の型を省略しても、それぞれ number として扱われます。

3. コールバック関数の型

配列の map や filter に渡すコールバック関数にも、同じ書式で型を付けられます。次のコードは、number[] の各要素を2倍にするコールバックに、引数と戻り値の型を明示した例です。以下のコードで hello.ts を書き換えます。

const numbers: number[] = [1, 2, 3, 4, 5];
const doubled: number[] = numbers.map((n: number): number => n * 2);

console.log(doubled);

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

npx tsc hello.ts

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

node hello.js

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

[ 2, 4, 6, 8, 10 ]

配列の各要素が2倍された [ 2, 4, 6, 8, 10 ] が出力され、doubled が number[] として得られています。

コードを解説します。

const doubled: number[] = numbers.map((n: number): number => n * 2);

(n: number): number => n * 2 の部分で、コールバックの引数 n を number として受け取り、戻り値も number であることを明示しています。map の戻り値も要素の型が number の配列になるため、doubled を number[] として受け取れます。

実際には map の型定義から n の型は number と推論されるため、以下のように引数と戻り値の型は省略しても補完・チェックは効きます。

const doubled = numbers.map((n) => n * 2);

void 型

戻り値を返さない関数の型として使いたいときは、void を指定します。書き方は以下のとおりです。

function 関数名(引数名: 型): void {
  // 戻り値を返さない処理
}

次のコードは、メッセージをコンソールに出力するだけで戻り値を返さない関数の例です。以下のコードで hello.ts を書き換えます。

function logMessage(message: string): void {
  console.log(message);
}

logMessage("処理を開始しました");

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

npx tsc hello.ts

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

node hello.js

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

処理を開始しました

logMessage("処理を開始しました") により、引数の文字列がそのまま出力されました。

コードを解説します。

function logMessage(message: string): void {
  console.log(message);
}

戻り値の型として void を指定しています。void は「戻り値を使わない」ことを示す型で、return 文を省略するか、値を伴わない return を書きます。呼び出し側で logMessage(...) の戻り値を変数に代入して使うようなコードは、型として想定されなくなります。

4. 非同期関数(Promise)

前章で学んだ非同期関数を型付きで表現したいときは、戻り値の型を Promise<T> で書きます。T にはPromiseが解決したときに返る値の型が入ります。書き方は以下のとおりです。

async function 関数名(引数名: 型): Promise<解決値の型> {
  // 非同期処理
  return 値;
}

次のコードは、指定したIDのユーザ情報をJSONPlaceholderから取得し、interface で data の型を絞り込んだ上で name を返す関数の例です。以下のコードで hello.ts を書き換えます。

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

async function fetchUserName(id: number): Promise<string> {
  const response = await fetch(`https://jsonplaceholder.typicode.com/users/${id}`);
  const data: User = await response.json();
  return data.name;
}

fetchUserName(1).then((name) => console.log(name));

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

npx tsc hello.ts

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

node hello.js

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

Leanne Graham

JSONPlaceholderが返した id: 1 のユーザ情報から、name プロパティが取り出されて出力されました。

コードを解説します。

async function fetchUserName(id: number): Promise<string> {

async を付けているため、この関数の戻り値は自動的にPromiseで包まれます。Promise<string> と明示することで、「解決したときに string を返す非同期関数である」ことが型で示されます。

const data: User = await response.json();

response.json() の戻り値は型定義上 Promise<any> になっているため、放っておくと data は any として扱われてしまいます。: User を書くことで「レスポンスは User の形である」と明示し、以降 data.name のようなアクセスに型チェックが効くようにしています。

fetchUserName の呼び出し側では then((name) => ...) の name が string として推論されるので、大文字化などの string 専用のメソッドを続けて呼び出しても補完が効きます。

📝 TypeScriptの型は実行時には検証されない
await response.json() の結果に : User と型を付けても、TypeScriptは実行時のデータ検証まではしません。APIが期待通りの形を返してくれるという前提での型付けなので、外部APIを使う場合はzodなどのバリデーションライブラリと組み合わせるのが一般的です。ここではまず、型注釈の書き方に慣れることを優先します。