CKTIS / JavaScript
AbortController i AbortSignal: zatraži otkazivanje i očitaj stanje
Proslijedi `controller.signal` operaciji koja podržava otkazivanje, zatraži ga pozivom `controller.abort()` i pomoću `signal.aborted` očitaj stanje signala, a ne ishod operacije.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
const controller = new AbortController();
const signal = controller.signal;
const aborted = signal.aborted;
// Two call forms; choose one for the first abort:
controller.abort();
controller.abort(reason);Stvori kontroler pomoću new AbortController() i zadrži ga u kodu koji odlučuje kada zatražiti otkazivanje. Svojstvo instance controller.signal dostupno je samo za čitanje i za taj kontroler uvijek vraća isti objekt AbortSignal. Proslijedi ga API-ju koji ga prihvaća, primjerice pozivom fetch(url, { signal }). Više operacija može dijeliti isti signal ako ih treba otkazati zajedno.
signal.aborted je Booleovo svojstvo samo za čitanje, a ne metoda. Početna mu je vrijednost false. Prvi poziv controller.abort() ili controller.abort(reason) sinkrono mijenja stanje signala u true i pokreće događaj abort prije nego što vrati undefined. signal.reason sadrži proslijeđenu vrijednost; ako izostaviš argument ili proslijediš undefined, sadrži DOMException naziva AbortError.
Kasniji pozivi ne zamjenjuju razlog i ne pokreću novi događaj. Signal se ne može vratiti u početno stanje: za novi ciklus otkazivanja stvori novi kontroler. Statička metoda AbortSignal.abort() radi drukčije: stvara novi, već otkazani signal umjesto da mijenja signal postojećeg kontrolera.
Otkazivanje zahtijeva suradnju operacije. aborted === true opisuje stanje signala: ne potvrđuje da se operacija zaustavila i ne poništava već obavljeni rad. U vlastitom API-ju koji se temelji na obećanjima provjeri signal prije početka, obradi naknadni događaj abort, odbij još neriješeno obećanje s vrijednošću signal.reason i ukloni slušatelja pri uobičajenom dovršetku. To su API-ji web-platforme, a ne dio ECMAScripta 2024; provjeri podršku u ciljnom izvršnom okruženju.
Primjeri
{
const controller = new AbortController();
const signal = controller.signal;
console.log(`before: ${signal.aborted}`);
signal.addEventListener("abort", () => {
console.log(`event: ${signal.aborted}`);
});
controller.abort("superseded");
controller.abort("ignored");
console.log(`after: ${signal.aborted}, ${signal.reason}`);
}Rezultat
before: false event: true after: true, superseded
Redak `event: true` pokazuje da je stanje već promijenjeno kad se izvrši slušatelj. Drugi poziv ne pokreće novi događaj i ne zamjenjuje razlog `superseded`.
Povezane lekcije
- JavaScript · Lekcija 4 · Napredno · Verzija: 4