CKTIS / JavaScript
AbortController — annullare le operazioni fetch
AbortController comunica una richiesta di annullamento tramite `signal`. `fetch` costruisce un oggetto `Request` prima di controllare il segnale. Se la costruzione fallisce, la promise viene rifiutata con l’errore corrispondente (ad esempio un `TypeError` se l’URL non è valido), anche se il segnale è già stato annullato. Se `fetch` rileva l’annullamento mentre la promise è ancora in sospeso, la rifiuta con il motivo dell’annullamento. Se la promise è già stata completata con successo con un oggetto `Response`, l’annullamento non ne cambia lo stato, ma può interrompere la lettura in corso del corpo della risposta.
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;
controller.abort(reason);
fetch(input, { signal });AbortController è una Web API e non fa parte di una specifica edizione di ECMAScript. AbortController.signal indica la proprietà di istanza controller.signal; AbortController.abort indica il metodo di istanza controller.abort(reason), non un metodo statico.
Passa signal a fetch. abort(reason) segnala l’annullamento; il motivo predefinito è una DOMException denominata AbortError. Un segnale non può essere reimpostato: una nuova operazione che richiede un annullamento indipendente necessita di un nuovo controller.
Se fetch costruisce correttamente un oggetto Request e rileva che il segnale è già stato annullato, rifiuta la promise con il motivo dell’annullamento. L’annullamento può anche interrompere la lettura del corpo della risposta, ma non annulla il lavoro già svolto dal server. Gestisci il rifiuto invece di ignorare gli errori.
L’esempio annulla prima di fetch, evitando così le condizioni di gara legate ai tempi. Verifica la disponibilità nel browser di destinazione; la presenza di Node 24 nel repository non dimostra il supporto dei browser.
Esempi
(async () => {
const controller = new AbortController();
const reason = new Error("Cancelled");
controller.abort(reason);
try {
await fetch("data:text/plain,hello", {
signal: controller.signal
});
console.log("unexpected success");
} catch (error) {
console.log(controller.signal.aborted);
console.log(error === reason);
}
})();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.