CKTIS / JavaScript
AbortSignal — segnale di annullamento
AbortSignal trasmette una richiesta di annullamento a fetch; AbortController avvia l’annullamento, mentre il segnale ne espone lo stato.
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
const controller = new AbortController();
const signal = controller.signal;
fetch(url, { signal });
controller.abort(reason);AbortSignal trasmette una richiesta di annullamento a un’operazione che la supporta. Ottienilo tramite controller.signal da un AbortController e passalo a fetch come { signal }. È il controller, non il segnale, ad avviare l’annullamento.
Dopo l’annullamento, signal.aborted vale true. Se la Promise restituita da fetch è ancora in sospeso, l’annullamento fa sì che venga rifiutata con il motivo dell’annullamento. Se la Promise è già stata soddisfatta con un oggetto Response, l’annullamento non può farla rifiutare a posteriori, ma può ancora interrompere la lettura del corpo della risposta. Questo non annulla le azioni del server.
L’esempio annulla prima di chiamare fetch, così il risultato non dipende dalla rete. Questa è una Web API, non una funzionalità ECMAScript; la presenza di Node 24 nel repository non dimostra il supporto nei browser.
Esempi
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();Risultato
true 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.