CKTIS / JavaScript
AbortSignal — signál zrušenia
AbortSignal odovzdáva požiadavku na zrušenie funkcii fetch; AbortController zrušenie iniciuje a signál sprístupňuje jeho stav.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const controller = new AbortController();
const signal = controller.signal;
fetch(url, { signal });
controller.abort(reason);AbortSignal odovzdáva požiadavku na zrušenie operácii, ktorá ju podporuje. Získajte ho cez controller.signal z objektu AbortController a odovzdajte ho funkcii fetch ako { signal }. Zrušenie iniciuje ovládač, nie signál.
Po zrušení má signal.aborted hodnotu true. Ak je prísľub vrátený funkciou fetch ešte v stave čakania, zrušenie spôsobí jeho zamietnutie s dôvodom zrušenia. Ak už bol prísľub splnený objektom Response, zrušenie nemôže spätne spôsobiť jeho zamietnutie, ale ešte môže prerušiť čítanie tela odpovede. Tým sa nezvrátia akcie na serveri.
Príklad zruší operáciu pred volaním fetch, takže výsledok nezávisí od siete. Ide o Web API, nie o funkciu ECMAScriptu; prítomnosť Node 24 v úložisku nepotvrdzuje podporu v prehliadačoch.
Príklady
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();Výsledok
true true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.