Controlador y señal
Hay dos piezas:
- El controlador (
AbortController) es el botón de cancelar: tiene el métodoabort(). - La señal (
controller.signal) es lo que se le pasa a la operación. Avisa cuando se cancela.
const control = new AbortController();
const { signal } = control;
signal.addEventListener("abort", () => {
console.log("se canceló:", signal.reason);
});
console.log(signal.aborted); // false
control.abort("ya no hace falta");
console.log(signal.aborted); // true
Quien cancela no necesita saber nada de la operación; la operación no necesita saber quién cancela. Solo comparten la señal.
Cancelar un fetch
fetch acepta una señal. Si se cancela, la promesa se rechaza con un error de nombre AbortError:
const control = new AbortController();
fetch("/api/buscar?q=java", { signal: control.signal })
.then((r) => r.json())
.then((datos) => mostrar(datos))
.catch((e) => {
if (e.name === "AbortError") return; // cancelada a propósito: no es un error
mostrarError(e);
});
// El usuario siguió escribiendo: esta búsqueda ya no sirve
control.abort();
Distinguir AbortError del resto es importante: una cancelación intencional no debería mostrarse como un fallo.
Límites de tiempo y señales combinadas
AbortSignal.timeout(ms) crea una señal que se cancela sola. AbortSignal.any([…]) combina varias: se cancela en cuanto lo hace cualquiera.
const usuario = new AbortController();
const señal = AbortSignal.any([
usuario.signal, // el botón «cancelar»
AbortSignal.timeout(100), // o 100 ms, lo que pase primero
]);
señal.addEventListener("abort", () => {
console.log("cancelada por:", señal.reason.name);
});
Si la señal se canceló por tiempo, el motivo es un error de nombre TimeoutError; si fue por abort() sin argumento, AbortError.
Tus propias funciones cancelables
Cualquier función asíncrona puede respetar una señal. El contrato es siempre el mismo:
- Si la señal ya está cancelada, rechazar enseguida.
- Escuchar el evento
abort. - Al cancelarse, liberar lo que se estaba usando (temporizadores, conexiones) y rechazar con
signal.reason.
function esperar(ms, signal) {
return new Promise((ok, mal) => {
if (signal?.aborted) return mal(signal.reason);
const id = setTimeout(ok, ms);
signal?.addEventListener("abort", () => {
clearTimeout(id);
mal(signal.reason);
}, { once: true });
});
}
try {
await esperar(1000, AbortSignal.timeout(50));
} catch (e) {
console.log("detenida:", e.name);
}
Resumen
AbortControllercancela; susignalse le pasa a la operación.fetch(url, { signal })se rechaza conAbortErroral cancelarse: no lo trates como un fallo.AbortSignal.timeout(ms)cancela por tiempo (TimeoutError);AbortSignal.anycombina señales.- Una función cancelable comprueba
signal.aborted, escuchaabort, libera recursos y rechaza consignal.reason. - Un controlador por operación: una señal cancelada lo está para siempre.
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Detener lo que ya empezó
Resuelto
Elige una respuesta en cada pregunta.
¿Cómo se usa un
AbortController?¿Qué hace
AbortSignal.timeout(3000)?¿Para qué sirve
AbortSignal.any([s1, s2])?¿Se puede reutilizar un controlador después de llamar a
abort()?
Ordena la salida: Señales y motivos
Resuelto
Una señal que se cancela dos veces. Ordena lo que aparecería en la consola.
1const control = new AbortController();2const { signal } = control;3 4signal.addEventListener("abort", () => console.log("aviso:", signal.reason));5 6console.log("¿cancelada?", signal.aborted);7control.abort("el usuario cerró la ventana");8console.log("¿cancelada?", signal.aborted);9control.abort("otra vez");10console.log("motivo:", signal.reason);Consola, de arriba abajo
- ¿cancelada? true
- ¿cancelada? false
- motivo: el usuario cerró la ventana
- aviso: el usuario cerró la ventana
El evento abort se dispara en el momento de llamar a abort(), antes de la línea siguiente. Cancelar dos veces no hace nada: la señal ya estaba cancelada y conserva el primer motivo.
Detective: Un controlador reutilizado
Resuelto
Una búsqueda nueva se cancela antes de empezar. Encuentra la línea y elige el arreglo.
Consola
nueva búsqueda…
busqueda.js:3
if (signal.aborted) return mal(signal.reason);
^
AbortError: This operation was abortedPaso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?
Laboratorio: Una espera cancelable
Resuelto
Escribe esperar(ms, signal): una espera que se puede cancelar.
$ node programa.js
Lo que debe cumplir
- Imprime
cancelado, a los 30 ms y no a los 500 (pendiente) - Sin cancelación, se cumple a tiempo (pendiente)
- Con una señal ya cancelada, rechaza enseguida (pendiente)
Una solución
1function esperar(ms, signal) {2 return new Promise((ok, mal) => {3 if (signal.aborted) return mal(signal.reason);4 const id = setTimeout(ok, ms);5 signal.addEventListener("abort", () => {6 clearTimeout(id);7 mal(signal.reason);8 }, { once: true });9 });10}11 12const control = new AbortController();13setTimeout(() => control.abort(new Error("cancelado")), 30);14 15try {16 await esperar(500, control.signal);17 console.log("terminó");18} catch (e) {19 console.log(e.message);20}Es el contrato de toda función cancelable, el mismo que cumple fetch: comprobar si ya está cancelada, escuchar el evento abort, liberar lo que estaba usando (aquí, el temporizador) y rechazar con el motivo.