re:re:actable
Урок 161 минута чтения

Что делает Promise.withResolvers()?

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

Promise.withResolvers() создает промис и сразу возвращает наружу его resolve и reject.

Вопрос

Для чего нужен Promise.withResolvers() и чем он отличается от new Promise()?

Определение

Promise.withResolvers() - статический метод, который возвращает объект:

const { promise, resolve, reject } = Promise.withResolvers();

Это удобно, когда промис нужно создать сейчас, а завершить его позже из другого места кода.

Эквивалент через new Promise

let resolve;
let reject;
 
const promise = new Promise((res, rej) => {
  resolve = res;
  reject = rej;
});

Promise.withResolvers() делает такой паттерн короче и безопаснее по форме.

Пример

const { promise, resolve, reject } = Promise.withResolvers();
 
button.addEventListener('click', () => {
  resolve('clicked');
});
 
promise.then(console.log);

Промис завершится, когда пользователь нажмет кнопку.

Когда использовать

  • адаптация callback API к Promise;
  • ожидание внешнего события;
  • создание очередей;
  • ручное управление завершением операции.

Важный нюанс

Не стоит использовать этот метод везде подряд. Для обычной асинхронной операции чаще достаточно async/await или обычного new Promise().

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

  • Promise.withResolvers() возвращает { promise, resolve, reject } без вложенного executor.
  • Удобен, когда промис разрешается из другого места: обработчика события, очереди, теста.
  • Метод из ES2024 — для старых окружений нужен полифил.
  • Не забывайте вызывать reject при ошибках, иначе промис зависнет навсегда.

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

const { promise, resolve, reject } = Promise.withResolvers();
 
resolve(value);
reject(error);

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

MDN: Promise.withResolvers().

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

Поиск

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