Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

AbortSignal — señal de cancelación

AbortSignal transmite una solicitud de cancelación a fetch; AbortController inicia la cancelación, mientras que la señal expone su estado.

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

Sintaxis

const controller = new AbortController();
const signal = controller.signal;
fetch(url, { signal });
controller.abort(reason);

AbortSignal transmite una solicitud de cancelación a una operación compatible. Obtenla mediante controller.signal de un AbortController y pásala a fetch como { signal }. El controlador inicia la cancelación, no la señal.

Después de la cancelación, signal.aborted vale true. Si la promesa devuelta por fetch sigue pendiente, la cancelación hace que se rechace con el motivo de cancelación. Si la promesa ya se ha cumplido con un objeto Response, la cancelación no puede hacer que se rechace retroactivamente, pero aún puede interrumpir la lectura del cuerpo de la respuesta. Esto no revierte las acciones del servidor.

El ejemplo cancela antes de llamar a fetch, por lo que el resultado no depende de la red. Es una API web, no una característica de ECMAScript; la presencia de Node 24 en el repositorio no demuestra que los navegadores la admitan.

Ejemplos

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();

Resultado

true
true

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes