Plusプラン限定レッスン

TypeScriptの組み込み型③

このレッスンでは前回に引き続き、TypeScriptが標準で提供している組み込みのユーティリティー型を紹介します。 最終回となる今回は、Conditional Typesのinferを使って、関数の引数や戻り値の型を操作する型を学びます。

inferについてはやや高度な内容であるため、レッスン7では詳細を割愛しました。 機能そのものは複雑ですが、今回紹介するユーティリティー型自体は簡単に使えます。どのようなことができるのか確認していきまょう。

10. ReturnType

定義:

type ReturnType<T extends (...args: any) => any> = T extends (...args: any) => infer R ? R : any;

ReturnType<T>型は、型引数Tに任意の関数を与えることで、その関数の戻り値を得られる型です。

const quoteStr = (str: string): string => `"${str}"`;
type QuoteReturn = ReturnType<typeof quoteStr>;
// QuoteReturnは string型

ReturnTypeの定義は少々難解ですが、(...args: any) => anyが「任意の型の引数をとり、任意の型の戻り値を返す」関数を指しているとわかれば理解しやすいでしょう。この関数の戻り値型部分をinterで受け取って返すことで、「関数の戻り値型を得る型」を実現しています。

ReturnType<T>型の簡単な利用例としては、関数の戻り値型にあとから名前をつけるようなケースが考えられます。 次の例では、makeCat関数の戻り値に後からCatという型名をつけています。

// 戻り値に明確な型がついていない関数
const makeCat = (name: string) => {
  return {
    name,
    age: 0,
  };
};

// 戻り値の型に後から名前をつける
type Cat = ReturnType<typeof makeCat>;
const tama: Cat = makeCat("tama");

外部のライブラリや他の人の書いたプログラムを利用するときに活躍するかもしれません。

この続きはPlusプラン限定です