Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

AbortSignal.aborted — leggere lo stato di annullamento

AbortSignal.aborted è una proprietà di istanza di sola lettura. Restituisce true quando il segnale è stato annullato, oppure false in caso contrario. Permette di controllare lo stato corrente, ma non annulla un’operazione autonomamente.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

signal.aborted

AbortSignal.aborted è una proprietà di istanza di AbortSignal, leggibile come signal.aborted, senza parentesi. Restituisce un valore booleano: false se il segnale non è stato annullato, oppure true se è stato annullato. Non è né un metodo statico né una proprietà scrivibile.

Puoi ottenere un segnale tramite controller.signal, dove controller è un’istanza di AbortController. La chiamata a controller.abort() imposta lo stato di annullamento; una lettura successiva di signal.aborted restituisce true. Un segnale annullato non può tornare allo stato iniziale: usa un nuovo controller per una nuova operazione indipendente.

Leggere la proprietà non interrompe il lavoro, non genera un’eccezione e non registra notifiche. Un’operazione deve supportare il segnale fornito, oppure il tuo codice deve reagire al suo stato. false non significa che l’operazione sia riuscita. Per reagire a un annullamento successivo, usa l’evento abort; considera anche il caso in cui il segnale sia già stato annullato prima della registrazione del listener.

Questa è una Web API definita dallo standard DOM, non una funzionalità di una specifica edizione di ECMAScript. MDN indica che è ampiamente disponibile nei browser da aprile 2018, anche nei Web Workers. La presenza di Node 24 in un repository non dimostra il supporto nei browser di destinazione.

Esempi

const controller = new AbortController();
const signal = controller.signal;

console.log(signal.aborted);
controller.abort();
console.log(signal.aborted);

Risultato

false
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti