> Нужно ли добавлять Promise к выходному типу асинхронной функции в TypeScript (JavaScript)

Короткий ответ

Нет, явно добавлять Promise к выходному типу асинхронной функции в TypeScript не нужно. Если функция объявлена с модификатором async, TypeScript автоматически оборачивает возвращаемое значение в Promise. Указание Promise<Type> в аннотации типа избыточно, хотя и не является ошибкой. Достаточно указать тип возвращаемого значения без Promise, и компилятор сам добавит обёртку.

Подробное объяснение

Когда функция помечена как async, TypeScript гарантирует, что возвращаемое значение будет обёрнуто в Promise. Это поведение заложено в спецификации JavaScript и TypeScript. Если вы напишете:

TYPESCRIPT
async function fetchData(): Promise<User> { ... }

то Promise здесь избыточен, потому что async уже подразумевает возврат Promise. Более идиоматично писать:

TYPESCRIPT
async function fetchData(): User { ... }

TypeScript автоматически выведет тип Promise<User>. Однако есть нюансы:

• Если функция не async, но возвращает Promise, аннотация Promise<Type> необходима
• Для callback-функций и типов, передаваемых в качестве аргументов, Promise нужно указывать явно
• В интерфейсах и типах, описывающих сигнатуры функций, Promise также обязателен

На практике

В реальных проектах я рекомендую не указывать Promise для async функций - это делает код чище и снижает вероятность ошибок при рефакторинге. Если вы измените реализацию и уберёте async, TypeScript подскажет о несоответствии типов. Для не-async функций, возвращающих промисы, Promise обязателен.

Исключение: когда функция возвращает Promise<void>, можно опустить void и просто написать async function foo() - TypeScript выведет Promise<void>.

Пример кода

TYPESCRIPT
// Правильно: async + тип без Promise
async function getUser(id: string): User {
  const response = await fetch(`/api/users/${id}`);
  return response.json();
}

// Избыточно, но работает
async function getUserVerbose(id: string): Promise<User> {
  const response = await fetch(`/api/users/${id}`);
  return response.json();
}

// Для не-async функций Promise обязателен
function getData(): Promise<Data> {
  return fetch('/api/data').then(res => res.json());
}

// В интерфейсах Promise нужно указывать явно
interface Repository {
  find(id: string): Promise<Entity>;
}

Как отвечать на собеседовании

Начните с прямого ответа: "Нет, не нужно, async автоматически оборачивает результат в Promise". Затем объясните, почему это так, и приведите примеры правильного и неправильного использования. Упомяните, что для не-async функций и в интерфейсах Promise обязателен. Покажите понимание trade-off: явное указание Promise может быть полезно для документации, но в большинстве случаев избыточно.

Что проверяет интервьюер

Интервьюер оценивает:

• Понимание работы async/await и Promise в JavaScript
• Знание системы типов TypeScript и её поведения с async функциями
• Умение писать идиоматичный код без избыточных аннотаций
• Понимание разницы между runtime-поведением и статической типизацией

Типичные ошибки

• Указание Promise<Promise<Type>> - двойная обёртка, которая никогда не нужна
• Пропуск Promise в не-async функциях, возвращающих промисы
• Использование Promise в сигнатурах callback-функций, где ожидается обычное значение
• Путаница между async function и функцией, возвращающей Promise - это разные концепции, хотя результат одинаков