Урок 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);Документация
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.