Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti