re:re:actable
Урок 122 минуты чтения

Что такое Promise и его состояния

На этой странице
Кратко

Promise — объект, представляющий результат асинхронной операции, который будет известен позже. У промиса три состояния: pending (ожидание), fulfilled (выполнен успешно) и rejected (отклонен с ошибкой). Промис «выполнен» (settled), когда он перешел из pending в fulfilled или rejected; после этого его состояние больше не меняется. resolve(value) переводит промис в fulfilled, reject(reason) — в rejected.

Вопрос

Что такое Promise? Какие состояния у промиса и когда он считается выполненным? Чем resolve отличается от reject?

Создание

const delay = (ms) =>
  new Promise((resolve) => {
    setTimeout(resolve, ms);
  });
 
const loadImage = (src) =>
  new Promise((resolve, reject) => {
    const img = new Image();
    img.onload = () => resolve(img);
    img.onerror = () => reject(new Error(`Не удалось загрузить ${src}`));
    img.src = src;
  });

Функция-исполнитель (executor) вызывается синхронно, сразу при создании промиса.

Состояния

              resolve(value)
pending ───────────────────────► fulfilled (value)
   │
   └──────────────────────────► rejected (reason)
              reject(error) или throw
СостояниеЗначениеКогда
pending—операция еще идет
fulfilledрезультатвызван resolve
rejectedпричина (обычно Error)вызван reject или брошена ошибка в executor

Settled — общее название для fulfilled и rejected. Термин resolved означает «судьба промиса решена»: промис мог быть разрешен другим промисом и всё еще ждать его.

Неизменность

new Promise((resolve, reject) => {
  resolve("первый");
  resolve("второй");   // игнорируется
  reject(new Error()); // игнорируется
});

После перехода в settled состояние повторные вызовы ничего не делают.

resolve и reject

resolve(value)reject(reason)
Состояниеfulfilled (или «перенимает» состояние промиса-аргумента)rejected
Обработчикthen(onFulfilled)catch, then(_, onRejected)
Аргументлюбое значение или промисобычно Error
const outer = new Promise((resolve) => resolve(Promise.reject(new Error("внутри"))));
outer.catch((e) => console.log(e.message)); // "внутри" — resolve с отклоненным промисом

Готовые промисы

Promise.resolve(42);          // уже fulfilled
Promise.reject(new Error());  // уже rejected
const { promise, resolve, reject } = Promise.withResolvers(); // ES2024

Что важно помнить

  • Ошибка, брошенная внутри executor, автоматически отклоняет промис.
  • Асинхронная ошибка внутри executor (в setTimeout) не отклонит промис — вызывайте reject явно.
  • Отклоненный промис без обработчика вызывает unhandledrejection.
  • Узнать состояние промиса синхронно нельзя — только через обработчики (в DevTools оно видно).
  • Промис не отменяется: отмену делают через AbortController.

Мини-шпаргалка

  • Promise — будущий результат асинхронной операции.
  • Состояния: pending → fulfilled | rejected.
  • Settled — завершен, состояние больше не меняется.
  • resolve — успех, reject — ошибка.
  • Executor выполняется синхронно.

Документация

MDN: Promise, MDN: Использование промисов, learn.javascript.ru: Промисы.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам