Отмена промисов: AbortController и AbortSignal
На этой странице
Промис нельзя отменить: он лишь представляет результат уже запущенной операции. Отменяют саму операцию через AbortController: его signal передают в fetch, addEventListener и собственные функции, а вызов controller.abort() прерывает их — fetch отклоняется с DOMException с именем AbortError. Для таймаутов есть AbortSignal.timeout(ms), для объединения сигналов — AbortSignal.any([...]).
Вопрос
Можно ли отменить выполнение промиса? Что делают AbortController и AbortSignal и как ими пользоваться?
Почему промис не отменяется
const p = fetch("/api/report");
// у p нет метода cancel — промис только «ждет» результатДаже если результат больше не нужен (пользователь ушел со страницы, ввел новый запрос), операция продолжится. Можно проигнорировать результат флагом, но запрос всё равно потратит трафик.
AbortController
const controller = new AbortController();
fetch("/api/search?q=чайник", { signal: controller.signal })
.then((r) => r.json())
.then(render)
.catch((error) => {
if (error.name === "AbortError") return; // отмена — не ошибка для пользователя
showError(error);
});
controller.abort(); // запрос прерванcontroller.signal— объектAbortSignal, который передают в операцию;controller.abort(reason?)— отменить,signal.abortedстанетtrue,signal.reason— причина;- один сигнал можно передать в несколько операций и отменить их разом;
- контроллер одноразовый: после
abortнужен новый.
Типичные сценарии
// поиск: отменять предыдущий запрос при новом вводе
let current;
input.addEventListener("input", async (event) => {
current?.abort();
current = new AbortController();
try {
const res = await fetch(`/api/search?q=${encodeURIComponent(event.target.value)}`, {
signal: current.signal,
});
render(await res.json());
} catch (error) {
if (error.name !== "AbortError") throw error;
}
});
// React: отмена при размонтировании
useEffect(() => {
const controller = new AbortController();
fetch(`/api/users/${id}`, { signal: controller.signal })
.then((r) => r.json())
.then(setUser)
.catch((e) => e.name !== "AbortError" && setError(e));
return () => controller.abort();
}, [id]);
// таймаут
await fetch("/api/slow", { signal: AbortSignal.timeout(5000) }); // TimeoutError через 5 с
// таймаут ИЛИ ручная отмена
const signal = AbortSignal.any([controller.signal, AbortSignal.timeout(5000)]);
// удаление нескольких обработчиков одним вызовом
window.addEventListener("resize", onResize, { signal: controller.signal });
window.addEventListener("scroll", onScroll, { signal: controller.signal });
controller.abort(); // оба обработчика удаленыПоддержка сигнала в своей функции
function delay(ms, { signal } = {}) {
return new Promise((resolve, reject) => {
if (signal?.aborted) return reject(signal.reason);
const id = setTimeout(resolve, ms);
signal?.addEventListener("abort", () => {
clearTimeout(id);
reject(signal.reason);
}, { once: true });
});
}Что важно помнить
- Отмена запроса не гарантирует, что сервер не выполнил операцию: для
POSTотмена на клиенте не откатывает изменения на сервере. AbortSignal.timeoutотклоняет сTimeoutError, а неAbortError— проверяйте оба имени.- TanStack Query и axios поддерживают
signalи отменяют запросы автоматически. - В Node.js
AbortControllerподдерживаютfetch,fs,timers/promises,child_process.
Мини-шпаргалка
- Промис не отменяется — отменяется операция.
const c = new AbortController(),fetch(url, { signal: c.signal }),c.abort().- Отмена →
AbortError, не показывать пользователю. AbortSignal.timeout(ms)— таймаут,AbortSignal.any()— объединение.- Сигнал в
addEventListenerудаляет обработчики.
Документация
MDN: AbortController, MDN: AbortSignal, learn.javascript.ru: Fetch: прерывание запроса.