CKTIS / JavaScript
AbortSignal — сигнал за отмяна
AbortSignal предава заявка за отмяна на fetch; AbortController инициира отмяната, а сигналът предоставя нейното състояние.
Версия: 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;
fetch(url, { signal });
controller.abort(reason);AbortSignal предава заявка за отмяна на операция, която я поддържа. Получете го чрез controller.signal от AbortController и го подайте на fetch като { signal }. Отмяната се инициира от контролера, а не от сигнала.
След отмяна signal.aborted е със стойност true. Ако върнатият от fetch Promise все още е в изчакване, при отмяна той се отхвърля с причината за отмяната. Ако Promise вече е изпълнен с обект Response, отмяната не може да доведе до отхвърлянето му със задна дата, но все още може да прекъсне четенето на тялото на отговора. Това не отменя действията на сървъра.
Примерът отменя сигнала преди извикването на fetch, така че резултатът не зависи от мрежата. Това е Web API, а не функция на ECMAScript; наличието на Node 24 в хранилището не доказва поддръжка в браузърите.
Примери
async function main() {
const controller = new AbortController();
const signal = controller.signal;
const reason = new Error("Stopped");
controller.abort(reason);
try {
await fetch("data:text/plain,hello", { signal });
} catch (error) {
console.log(signal.aborted);
console.log(error === reason);
}
}
main();Резултат
true true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.