Módulo Timers de Node.js
El módulo de Node.jstimersproporciona una serie de funciones para ejecutar código después de un tiempo específico o en intervalos determinados. Estas funciones son muy útiles para implementar ejecución diferida, tareas periódicas y control de tiempos de espera.
Aunquetimersel módulo es un módulo central de Node.js, sus métodos comosetTimeout(), setInterval()ysetImmediate()están disponibles de forma global, sin necesidad de importación explícita.
Funciones principales de temporizadores
setTimeout()
setTimeout()La función se utiliza para ejecutar la función de callback una sola vez después del número de milisegundos especificado.
Ejemplo
setTimeout(() => {
console.log('Este mensaje se mostrará después de 2 segundos');
}, 2000);
Descripción de parámetros
- Función de callback: la función a ejecutar
- Tiempo de retraso (delay): tiempo en milisegundos (1000 milisegundos = 1 segundo)
- Parámetros opcionales: parámetros adicionales que se pasan a la función de callback
Ejemplo
setTimeout((name, age) => {
console.log(`Hola, ${name}, tienes ${age}años`);
}, 1000, 'Zhang San', 25);
clearTimeout()
clearTimeout()Se utiliza para cancelar el temporizador previamente establecido mediantesetTimeout()el cual se configuró.
Ejemplo
console.log('Este mensaje no se mostrará');
}, 2000);
clearTimeout(timerId); // Cancelar el temporizador
setInterval()
setInterval()La función se utiliza para ejecutar la función de callback repetidamente cada intervalo de milisegundos especificado.
Ejemplo
let counter = 0;
const intervalId = setInterval(() => {
counter++;
console.log(`Esta es la ${counter}ª ejecución`);
if (counter === 5) {
clearInterval(intervalId); // Detener el temporizador
}
}, 1000);
clearInterval()
clearInterval()Se utiliza para detener el temporizador repetitivo previamente establecido mediantesetInterval()el cual se configuró.
Ejemplo
console.log('Este mensaje se mostrará repetidamente');
}, 1000);
// Detener el temporizador después de 5 segundos
setTimeout(() => {
clearInterval(intervalId);
}, 5000);
setImmediate()
setImmediate()La función se utiliza para ejecutar la función de callback al final del bucle de eventos actual.
Ejemplo
setImmediate(() => {
console.log('Ejecutar callback inmediatamente');
});
console.log('Fin');
// Orden de salida:
// Inicio
// Fin
// Ejecutar callback inmediatamente
clearImmediate()
clearImmediate()Se utiliza para cancelar el callback de ejecución inmediata previamente establecido mediantesetImmediate()el cual se configuró.
Ejemplo
console.log('Este mensaje no se mostrará');
});
clearImmediate(immediateId);
Orden de ejecución de los temporizadores
Comprender el bucle de eventos de Node.js es muy importante para dominar el orden de ejecución de los temporizadores. A continuación se muestra el orden de ejecución de varios temporizadores:
- Código síncrono: se ejecuta primero
- process.nextTick(): se ejecuta inmediatamente después de que finalice la fase actual
- Callbacks de Promise: cola de microtareas
- setImmediate(): se ejecuta después de los callbacks de I/O
- setTimeout() y setInterval(): se ejecutan en la fase de verificación (check)
Ejemplo
setTimeout(() => console.log('setTimeout'), 0);
setImmediate(() => console.log('setImmediate'));
process.nextTick(() => console.log('nextTick'));
Promise.resolve().then(() => console.log('Promise'));
console.log('Fin');
// Orden de salida típico:
// Inicio
// Fin
// nextTick
// Promise
// setTimeout
// setImmediate
Uso avanzado y consideraciones
Cancelación de temporizadores
Todas las funciones de temporizador devuelven unTimeoutobjeto, que se puede utilizar para cancelar el temporizador. Incluso si el temporizador ya se ha ejecutado, llamar a la función de cancelación es seguro.
Ejemplo
clearTimeout(timeout); // Llamada segura, incluso si el temporizador ya se ha ejecutado
Precisión de los temporizadores
Los temporizadores de Node.js no garantizan un tiempo de ejecución exacto; representan el tiempo de espera "mínimo". La carga del sistema y otros factores pueden afectar el tiempo de ejecución real.
Fugas de memoria
Olvidarse de limpiarsetInterval()los temporizadores es una causa común de fugas de memoria. Asegúrate de limpiar los temporizadores cuando no sean necesarios.
Ejemplo
setInterval(() => {
// Realizar algunas operaciones
}, 1000);
// Forma correcta: limpiar el temporizador en el momento adecuado
const interval = setInterval(() => {
// Realizar algunas operaciones
if (someCondition) {
clearInterval(interval);
}
}, 1000);
setTimeout recursivo como alternativa a setInterval
Para tareas que requieren un intervalo fijo pero cuyo tiempo de ejecución es incierto, usar setTimeout recursivosetTimeoutCompararsetIntervales más fiable.
Ejemplo
console.log('Ejecutando tarea...');
// Simular que el tiempo de ejecución de la tarea es incierto
const delay = Math.random() * 1000;
setTimeout(doSomething, 1000 + delay);
}
setTimeout(doSomething, 1000);
Ejemplos de aplicación práctica
Implementar una cuenta regresiva simple
Ejemplo
let current = seconds;
console.log(`La cuenta regresiva comienza: ${current}segundos`);
const timer = setInterval(() => {
current--;
if (current <= 0) {
clearInterval(timer);
console.log('¡Cuenta regresiva finalizada!');
} else {
console.log(`Tiempo restante: ${current}segundos`);
}
}, 1000);
}
countdown(5);
Manejo de tiempo de espera de solicitudes (request timeout)
Ejemplo
return new Promise((resolve, reject) => {
const timeoutId = setTimeout(() => {
reject(new Error(`La solicitud agotó el tiempo de espera (${timeout}ms)`));
}, timeout);
fetch(url)
.then(response => {
clearTimeout(timeoutId);
resolve(response);
})
.catch(error => {
clearTimeout(timeoutId);
reject(error);
});
});
}
// Ejemplo de uso
fetchWithTimeout('https://api.example.com/data')
.then(data => console.log(data))
.catch(error => console.error(error));
Al dominar eltimersmódulo de Node.js, puedes controlar eficazmente el momento de ejecución del código, implementar diversas tareas programadas y flujos de control asíncronos.
Módulos integrados de Node.js