54. ReturnType と Parameters

ReturnType<T> は関数型 T の戻り値の型を、Parameters<T> は引数の型をタプルとして取り出すユーティリティ型です。関数そのものから取り出す場合は、typeof と組み合わせて ReturnType<typeof createUser> のように書きます。

実務では「関数の戻り値の型に名前を付けていないが、別の場所でその型が必要」な場面で使います。戻り値の形を変えたとき、取り出した型も自動で追従するので、関数と型の二重管理がなくなります。

つまずきポイントは typeof の付け忘れです。ReturnType<createUser> と書くと「createUser は値であって型ではない」というエラーになります。<> の中に入れられるのは型だけなので、関数(値)からはまず typeof で型を取り出します。

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

TypeScript

function createUser(userName: string, age: number) {
  return { userName, age, active: true };
}

// 戻り値の型を取り出す(typeof を忘れずに)
type CreatedUser = ReturnType<typeof createUser>;
// 引数の型をタプルとして取り出す
type CreateUserArgs = Parameters<typeof createUser>;

const inputArgs: CreateUserArgs = ["Taro", 28];
const created: CreatedUser = createUser(...inputArgs);
console.log(created);
console.log(created.active);

サンプルコードで身につける(5本) →

学んだ概念を、素朴な例から実務寄りの例まで5つの具体例で確認します。

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