CKTIS / JavaScript
AbortSignal — signal za preklic
AbortSignal posreduje zahtevo za preklic funkciji fetch; AbortController sproži preklic, signal pa razkriva njegovo stanje.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
const controller = new AbortController();
const signal = controller.signal;
fetch(url, { signal });
controller.abort(reason);AbortSignal posreduje zahtevo za preklic operaciji, ki jo podpira. Pridobi ga prek controller.signal iz AbortController in ga funkciji fetch posreduj kot { signal }. Preklic sproži krmilnik, ne signal.
Po preklicu je vrednost signal.aborted enaka true. Če je obljuba, ki jo vrne fetch, še na čakanju, se ob preklicu zavrne z razlogom za preklic. Če je bila obljuba že izpolnjena z objektom Response, je preklic ne more naknadno zavrniti, lahko pa še vedno prekine branje telesa odgovora. S tem se dejanja strežnika ne razveljavijo.
Primer signal prekliče pred klicem funkcije fetch, zato rezultat ni odvisen od omrežja. To je spletni API, ne funkcija ECMAScripta; prisotnost Node 24 v repozitoriju ne potrjuje podpore v brskalnikih.
Primeri
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();Rezultat
true true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.