Что такое…

Что такое промис в JavaScript — и что значит Promise pending в консоли

Иллюстрация: вместо посылки тебе выдают бумажную расписку — посылка приедет позже

Ты попросил ИИ написать функцию, которая спрашивает модель и возвращает ответ. Запускаешь, выводишь результат — а в консоли:

Promise { <pending> }

Ни ошибки, ни текста. И вот тут почти все думают, что код сломался. Он не сломался. Ты просто получил расписку вместо посылки — и это ровно то, чем промис и является.

Промис — это расписка, а не ответ

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

Поэтому JavaScript делает хитрый ход. На запрос он сразу выдаёт тебе промис — объект-расписку со смыслом «ответа пока нет, но я обязуюсь его принести». Программа бежит дальше, а расписка лежит у тебя в руках.

Аналогия из жизни. Ты сдал куртку в гардероб и получил номерок. Номерок — это не куртка. Но по нему куртку выдадут, когда придёт время. Promise { <pending> } в консоли — это ты вывел на экран номерок и удивился, что он не пахнет курткой.

Это часть большой темы — асинхронности. Промис — её главный объект.

Три состояния

У расписки всего три состояния, и они читаются прямо в консоли:

  • pending — «жду». Запрос ушёл, ответа ещё нет.
  • fulfilled — «готово». Внутри лежит результат.
  • rejected — «не вышло». Внутри лежит ошибка: сеть отвалилась, ключ неверный, сервер ответил 500.

Переход происходит один раз и навсегда. Промис не может «передумать» и стать pending обратно.

await — это «выдайте по расписке»

Слово, которое чинит Promise { <pending> }, одно:

// было: в консоли расписка
const answer = askModel("Привет");
console.log(answer);          // Promise { <pending> }

// стало: в консоли ответ
const answer = await askModel("Привет");
console.log(answer);          // "Привет! Чем помочь?"

await говорит: «стой здесь, пока по расписке не выдадут содержимое». Функция, внутри которой ты пишешь await, должна быть помечена словом async.

Правило на всю жизнь: увидел в консоли Promise { <pending> } — ты забыл await. В девяти случаях из десяти это весь диагноз.

Ловушка, на которой спотыкаются все

Вот та, из-за которой люди реально теряют данные и не понимают почему. У тебя список из десяти вопросов, и ты хочешь получить десять ответов:

// НЕ работает так, как ты думаешь
const answers = questions.map(async (q) => await askModel(q));
console.log(answers);   // [Promise, Promise, Promise, ...]

map честно вернул массив — но массив расписок, а не ответов. Каждая функция внутри асинхронная, и map не умеет их ждать. Дальше ты сохраняешь это в файл и получаешь десять строк [object Promise].

Чинится одной строкой:

const answers = await Promise.all(
  questions.map((q) => askModel(q)),
);

Promise.all берёт пачку расписок и отдаёт пачку содержимого — когда придут все. Бонус: запросы уходят одновременно, а не по очереди. Десять запросов к модели по две секунды — это две секунды, а не двадцать.

У Promise.all есть одна черта, о которой лучше узнать заранее: он падает целиком, если упала хоть одна расписка. Отправил десять запросов к модели, один споткнулся об ограничение частоты — и ты потерял все десять ответов, включая девять успешных.

Когда это не то, что тебе нужно, есть брат-близнец:

const results = await Promise.allSettled(
  questions.map((q) => askModel(q)),
);
// [{ status: "fulfilled", value: "..." }, { status: "rejected", reason: ... }]

allSettled дожидается всех и честно рассказывает про каждую: эта получилась, эта нет. Девять ответов сохранишь, десятый повторишь.

Ещё одна мелочь, которая экономит вечер: forEach не умеет ждать вообще. Если внутри forEach стоит await, цикл честно пробежит до конца, ничего не дождавшись. Нужен обычный for...of — там await работает.

Где ты встретишь промисы каждый день

Практически везде, где твой код общается с внешним миром:

  • fetch(...) — любой запрос к API, включая запросы к моделям.
  • Чтение и запись файлов.
  • Запросы в базу данных.
  • Задержки, таймеры, загрузка картинок.

Отдельный случай — стриминг ответа модели. Там промис отдаёт не готовый текст, а поток, из которого куски приходят по мере генерации. Поэтому в чатах текст «печатается» на глазах.

Что забрать с собой

Промис — это обещание значения, а не само значение. Три состояния: ждём, готово, упало. await достаёт содержимое, async разрешает писать await, Promise.all разбирает пачку расписок разом.

И главное: Promise { <pending> } — не ошибка, а сообщение «ты вывел номерок». Слово await превращает номерок в куртку.

Промис — это то же самое, что async/await?

Нет. Промис — это объект, а async/await — удобный синтаксис для работы с ним. Раньше писали .then(...), теперь чаще await — но под капотом это один и тот же промис.

Почему await подчёркивается красным?

Скорее всего, ты пишешь await в обычной функции. Он работает только внутри функции с пометкой async (или на верхнем уровне модуля). Добавь async перед function — и подчёркивание уйдёт.

Что делать, если промис «упал»?

Оберни await в try / catch — в блок catch попадёт ошибка. Без этого падение улетит в консоль как «unhandled rejection», а пользователь увидит пустой экран вместо понятного сообщения.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →