Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje