Что такое промис в 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 коротких урока на телефоне.





