Модуль Timers Node.js

Java FileВстроенные модули Node.js


Node.jstimersМодуль предоставляет ряд функций для выполнения кода через заданное время или повторно через заданные интервалы. Эти возможности очень полезны для реализации отложенного выполнения, периодических задач и управления тайм-аутами.

Хотяtimersэтот модуль является встроенным модулем Node.js, но его методы, такие какsetTimeout(), setInterval()иsetImmediate()доступны глобально без явного импорта.


Основные функции таймеров

setTimeout()

setTimeout()Функция используется для однократного выполнения функции обратного вызова через заданное количество миллисекунд.

Пример

// Вывести сообщение через 2 секунды
setTimeout(() => {
  console.log('Это сообщение будет отображено через 2 секунды');
}, 2000);

Описание параметра

  1. Функция обратного вызова: функция, которую нужно выполнить
  2. Время задержки: время в миллисекундах (1000 ms = 1 секунда)
  3. Необязательные параметры: дополнительные параметры, передаваемые функции обратного вызова

Пример

// Пример с дополнительными параметрами
setTimeout((name, age) => {
  console.log(`Привет, ${name}, вам ${age}лет`);
}, 1000, 'Zhang San', 25);

clearTimeout()

clearTimeout()Используется для отмены ранее установленногоsetTimeout()таймера.

Пример

const timerId = setTimeout(() => {
  console.log('Это сообщение не будет отображено');
}, 2000);

clearTimeout(timerId); // Отменить таймер

setInterval()

setInterval()Функция используется для многократного выполнения функции обратного вызова через заданные интервалы в миллисекундах.

Пример

// Выводить сообщение каждую 1 секунду
let counter = 0;
const intervalId = setInterval(() => {
  counter++;
  console.log(`Это ${counter}выполнение`);
  if (counter === 5) {
    clearInterval(intervalId); // Остановить таймер
  }
}, 1000);

clearInterval()

clearInterval()Используется для остановки ранее установленногоsetInterval()повторяющегося таймера.

Пример

const intervalId = setInterval(() => {
  console.log('Это сообщение будет выводиться повторно');
}, 1000);

// Остановить таймер через 5 секунд
setTimeout(() => {
  clearInterval(intervalId);
}, 5000);

setImmediate()

setImmediate()Функция используется для выполнения функции обратного вызова в конце текущего цикла событий.

Пример

console.log('Старт');

setImmediate(() => {
  console.log('Обратный вызов выполнен немедленно');
});

console.log('Конец');

// Порядок вывода:
// Начало
// Конец
Callback выполняется немедленно

clearImmediate()

clearImmediate()Используется для отмены ранее установленногоsetImmediate()немедленный обратный вызов.

Пример

const immediateId = setImmediate(() => {
  console.log('Это сообщение не будет отображено');
});

clearImmediate(immediateId);

Порядок выполнения таймеров

Понимание цикла событий Node.js очень важно для освоения порядка выполнения таймеров. Ниже представлен порядок выполнения таймеров:

  1. Синхронный код: Выполняется первым
  2. process.nextTick(): Выполняется в текущей фазе
  3. Обратные вызовы Promise: Очередь микрозадач
  4. setImmediate(): Выполняется после обратных вызовов ввода-вывода
  5. setTimeout() и setInterval(): Выполняются на фазе check

Пример

console.log('Старт');

setTimeout(() => console.log('setTimeout'), 0);
setImmediate(() => console.log('setImmediate'));
process.nextTick(() => console.log('nextTick'));
Promise.resolve().then(() => console.log('Promise'));

console.log('Конец');

// Типичный порядок вывода:
// Начало
// Конец
// nextTick
// Promise
// setTimeout
// setImmediate

Расширенное использование и примечания

Отмена таймеров

Все функции таймеров возвращаютTimeoutобъект, который можно использовать для отмены таймера. Вызов функции отмены безопасен, даже если таймер уже сработал.

Пример

const timeout = setTimeout(() => {}, 1000);
clearTimeout(timeout); // Безопасно вызывать, даже если таймер уже сработал

Точность таймеров

Таймеры Node.js не гарантируют точное время выполнения; они задают минимальное время ожидания. Загрузка системы и другие факторы могут влиять на фактическое время выполнения.

Утечки памяти

Забывание очисткиsetInterval()таймеры — распространённый источник утечек памяти. Обязательно очищайте таймеры, когда они больше не нужны.

Пример

// Неправильный подход — может вызвать утечку памяти
setInterval(() => {
  // Выполнить некоторую операцию
}, 1000);

// Правильный подход — очистить таймер в подходящий момент
const interval = setInterval(() => {
  // Выполнить некоторую операцию
  if (someCondition) {
    clearInterval(interval);
  }
}, 1000);

Рекурсивный setTimeout вместо setInterval

Для задач, которые требуют фиксированного интервала, но время выполнения которых каждый раз неопределённо, использование рекурсивногоsetTimeoutСравнениеsetIntervalявляется более надёжным.

Пример

function doSomething() {
  console.log('Выполнение задачи...');
 
  // Имитация неопределённого времени выполнения задачи
  const delay = Math.random() * 1000;
 
  setTimeout(doSomething, 1000 + delay);
}

setTimeout(doSomething, 1000);

Примеры практического применения

Реализация простого обратного отсчета

Пример

function countdown(seconds) {
  let current = seconds;
 
  console.log(`Обратный отсчет начинается: ${current}seconds`);
 
  const timer = setInterval(() => {
    current--;
   
    if (current <= 0) {
      clearInterval(timer);
      console.log('Обратный отсчет завершен!');
    } else {
      console.log(`Оставшееся время: ${current}seconds`);
    }
  }, 1000);
}

countdown(5);

Обработка тайм-аута запроса

Пример

function fetchWithTimeout(url, timeout = 5000) {
  return new Promise((resolve, reject) => {
    const timeoutId = setTimeout(() => {
      reject(new Error(`Тайм-аут запроса (${timeout}ms)`));
    }, timeout);
   
    fetch(url)
      .then(response => {
        clearTimeout(timeoutId);
        resolve(response);
      })
      .catch(error => {
        clearTimeout(timeoutId);
        reject(error);
      });
  });
}

// Пример использования
fetchWithTimeout('https://api.example.com/data')
  .then(data => console.log(data))
  .catch(error => console.error(error));

Освоив модуль Node.js,timersвы сможете эффективно управлять временем выполнения кода и реализовывать различные запланированные задачи и асинхронные потоки управления.

Java FileВстроенные модули Node.js

Другие расширения