CKTIS / JavaScript
AbortController — прекратяване на операции fetch
AbortController предава заявка за прекратяване чрез `signal`. `fetch` създава обект `Request`, преди да провери сигнала. Ако създаването на обекта е неуспешно, върнатият promise се отхвърля със съответната грешка (например `TypeError` при невалиден URL), дори ако сигналът вече е прекратен. Ако `fetch` установи прекратяването, докато promise все още е в състояние на изчакване, го отхвърля с причината за прекратяването. Ако promise вече е изпълнен с обект `Response`, прекратяването не променя състоянието му, но може да прекъсне четенето на тялото на отговора, ако то все още е в ход.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
const controller = new AbortController();
const signal = controller.signal;
controller.abort(reason);
fetch(input, { signal });AbortController е Web API, а не част от конкретно издание на ECMAScript. AbortController.signal обозначава свойството на екземпляра controller.signal; AbortController.abort обозначава метода на екземпляра controller.abort(reason), а не статичен метод.
Подай signal на fetch. abort(reason) сигнализира прекратяване; причината по подразбиране е DOMException с име AbortError. Сигналът не може да се нулира: за нова операция, която трябва да може да се прекратява независимо, е необходим нов контролер.
Ако fetch създаде успешно обект Request и установи, че сигналът вече е прекратен, отхвърля върнатия promise с причината за прекратяването. Прекратяването може също да прекъсне четенето на тялото на отговора, но не отменя вече извършената работа на сървъра. Обработвай отхвърлянето, вместо да пренебрегваш грешките.
Примерът прекратява операцията преди fetch, като така избягва състезанията във времето. Провери наличността в целевия браузър; наличието на Node 24 в хранилището не доказва поддръжка в браузърите.
Примери
(async () => {
const controller = new AbortController();
const reason = new Error("Cancelled");
controller.abort(reason);
try {
await fetch("data:text/plain,hello", {
signal: controller.signal
});
console.log("unexpected success");
} catch (error) {
console.log(controller.signal.aborted);
console.log(error === reason);
}
})();Резултат
true true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.