Какой утилитарный тип извлекает тип значения из Promise?

В TypeScript утилитарный тип Awaited<T> предназначен для извлечения типа значения, которое возвращает промис. Он был добавлен в версии 4.5 и решает задачу, с которой разработчики часто сталкивались при работе с асинхронными функциями: как получить тип результата, не выполняя саму функцию.

Как это работает

Если у вас есть тип Promise<string>, то Awaited<Promise<string>> вернёт string. Тип рекурсивно разворачивает вложенные промисы: Awaited<Promise<Promise<number>>> также даст number. Это соответствует поведению оператора await в рантайме.

Пример использования

async function fetchUser(): Promise<{ id: number; name: string }> {
  return { id: 1, name: 'Alice' };
}

type User = Awaited<ReturnType<typeof fetchUser>>;
// User = { id: number; name: string }

// Без Awaited пришлось бы писать вручную:
type UserManual = ReturnType<typeof fetchUser> extends Promise<infer U> ? U : never;

Где применяется

• Типизация результатов асинхронных функций без их вызова.
• Работа с обёртками над промисами, например, в библиотеках.
• Извлечение типа из Promise.all или других комбинаторов.

Итог: используйте Awaited, когда нужно получить тип значения, возвращаемого промисом, особенно в связке с ReturnType для асинхронных функций — это делает код чище и безопаснее.