NonNullable<T> / ReturnType<T> / Parameters<T>

NonNullable<T> // T から null と undefined を除外
ReturnType<T> // 関数型 T の戻り値型
Parameters<T> // 関数型 T の引数型（タプル）
Awaited<T> // Promise<T> を再帰的に解決した型

// NonNullable
type MaybeString = string | null | undefined;
type DefiniteString = NonNullable<MaybeString>;
// => string

// ReturnType
function greet(name: string): string {
  return `Hello, ${name}`;
}
type GreetReturn = ReturnType<typeof greet>;
// => string

function fetchUser() {
  return { id: 1, name: '碇シンジ' };
}
type User = ReturnType<typeof fetchUser>;
// => { id: number; name: string }

// Parameters
function add(a: number, b: number): number {
  return a + b;
}
type AddParams = Parameters<typeof add>;
// => [a: number, b: number]

// Awaited
type Resolved = Awaited<Promise<string>>;
// => string

type DeepResolved = Awaited<Promise<Promise<number>>>;
// => number

これらのユーティリティ型は、外部ライブラリの関数など自分で型を定義できない場合に特に役立ちます。たとえば『ReturnType<typeof someLibraryFn>』とすることで、ライブラリ関数の戻り値型を自動的に取得できます。

『Parameters<T>』はタプル型を返すため、引数の一部だけを取り出す場合は『Parameters<typeof fn>[0]』のようにインデックスアクセスと組み合わせます。

『Awaited<T>』は非同期関数の戻り値型を取得する際に便利です。『async function』の戻り値は自動的に Promise に包まれるため、『ReturnType<typeof asyncFn>』だと Promise のままになります。そこで『Awaited<ReturnType<typeof asyncFn>>』とすることで、解決後の値の型を取得できます。