CKTIS / JavaScript
AbortController: cancelar operaciones fetch
AbortController comunica una solicitud de cancelación mediante `signal`. `fetch` construye un objeto `Request` antes de comprobar la señal. Si no puede construirlo, su promesa se rechaza con el error correspondiente (por ejemplo, un `TypeError` si la URL no es válida), aunque la señal ya esté cancelada. Si `fetch` detecta la cancelación mientras su promesa sigue pendiente, la rechaza con el motivo de la cancelación. Si la promesa ya se ha cumplido con un objeto `Response`, la cancelación no cambia su estado, pero puede interrumpir la lectura en curso del cuerpo de la respuesta.
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;
controller.abort(reason);
fetch(input, { signal });AbortController es una API Web, no forma parte de una edición concreta de ECMAScript. AbortController.signal se refiere a la propiedad de instancia controller.signal; AbortController.abort se refiere al método de instancia controller.abort(reason), no a un método estático.
Pasa signal a fetch. abort(reason) indica la cancelación; el motivo predeterminado es una DOMException llamada AbortError. Una señal no se puede restablecer: una nueva operación que requiera cancelación independiente necesita un controlador nuevo.
Si fetch construye correctamente un objeto Request y detecta que la señal ya está cancelada, rechaza la promesa con el motivo de la cancelación. La cancelación también puede interrumpir la lectura del cuerpo de la respuesta, pero no deshace el trabajo que ya haya realizado el servidor. Gestiona el rechazo en lugar de ignorar los errores.
El ejemplo cancela antes de fetch, evitando así las carreras temporales. Comprueba la disponibilidad en el navegador de destino; que el repositorio incluya Node 24 no demuestra que haya compatibilidad con navegadores.
Ejemplos
(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);
}
})();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.