Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti