Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

AbortSignal — signal za otkazivanje

AbortSignal prenosi zahtjev za otkazivanje funkciji fetch; AbortController pokreće otkazivanje, a signal izlaže njegovo stanje.

Verzija: 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 prenosi zahtjev za otkazivanje operaciji koja ga podržava. Dohvati ga putem controller.signal iz objekta AbortController i proslijedi ga funkciji fetch kao { signal }. Otkazivanje pokreće kontroler, a ne signal.

Nakon otkazivanja, signal.aborted ima vrijednost true. Ako je obećanje koje vraća fetch još na čekanju, otkazivanjem se odbija uz razlog otkazivanja. Ako je obećanje već ispunjeno objektom Response, otkazivanje ne može uzrokovati njegovo naknadno odbijanje, ali još može prekinuti čitanje tijela odgovora. Time se ne poništavaju radnje na poslužitelju.

Primjer otkazuje prije poziva funkcije fetch, pa rezultat ne ovisi o mreži. Riječ je o Web API-ju, a ne o značajci ECMAScripta; prisutnost Nodea 24 u repozitoriju ne potvrđuje podršku u preglednicima.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori