CKTIS / JavaScript
AbortSignal — signál zrušení
AbortSignal předává požadavek na zrušení funkci fetch; AbortController zrušení zahajuje a signál zpřístupňuje jeho stav.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const controller = new AbortController();
const signal = controller.signal;
fetch(url, { signal });
controller.abort(reason);AbortSignal předává požadavek na zrušení operaci, která jej podporuje. Získejte jej přes controller.signal z objektu AbortController a předejte jej funkci fetch jako { signal }. Zrušení zahajuje řadič, nikoli signál.
Po zrušení má signal.aborted hodnotu true. Pokud je příslib vrácený funkcí fetch stále ve stavu čekání, zrušení způsobí jeho zamítnutí s důvodem zrušení. Pokud už byl příslib splněn objektem Response, zrušení ho nemůže zpětně zamítnout, ale stále může přerušit čtení těla odpovědi. Akce na serveru se tím nevrátí zpět.
Příklad zruší operaci před voláním fetch, takže výsledek nezávisí na síti. Jde o Web API, nikoli o funkci ECMAScriptu; přítomnost Node 24 v repozitáři nepotvrzuje podporu v prohlížečích.
Pří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ýsledek
true true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.