Módulo Timers de Node.js

Java FileMódulos integrados 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

// Imprimir el mensaje después de 2 segundos
setTimeout(() => {
  console.log('Este mensaje se mostrará después de 2 segundos');
}, 2000);

Descripción de parámetros

  1. Función de callback: la función a ejecutar
  2. Tiempo de retraso (delay): tiempo en milisegundos (1000 milisegundos = 1 segundo)
  3. Parámetros opcionales: parámetros adicionales que se pasan a la función de callback

Ejemplo

// Ejemplo con parámetros adicionales
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

const timerId = setTimeout(() => {
  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

// Imprimir un mensaje cada 1 segundo
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

const intervalId = setInterval(() => {
  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

console.log('Inicio');

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

const immediateId = setImmediate(() => {
  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:

  1. Código síncrono: se ejecuta primero
  2. process.nextTick(): se ejecuta inmediatamente después de que finalice la fase actual
  3. Callbacks de Promise: cola de microtareas
  4. setImmediate(): se ejecuta después de los callbacks de I/O
  5. setTimeout() y setInterval(): se ejecutan en la fase de verificación (check)

Ejemplo

console.log('Inicio');

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

const timeout = setTimeout(() => {}, 1000);
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

// Forma incorrecta: puede provocar fugas de memoria
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

function doSomething() {
  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

function countdown(seconds) {
  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

function fetchWithTimeout(url, timeout = 5000) {
  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.

Java FileMódulos integrados de Node.js

Otras extensiones