Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri