Является ли функция Date.now чистой?

Анализ чистоты функции Date.now()

Определение чистой функции

Прежде всего, важно вспомнить критерии чистой функции:

1. Возвращает одинаковый результат для одинаковых аргументов
2. Не имеет побочных эффектов (не изменяет внешнее состояние, не зависит от него)
3. Не зависит от внешнего состояния или глобальных переменных

Характеристики Date.now()

Date.now() – это статический метод объекта Date, который возвращает количество миллисекунд, прошедших с 1 января 1970 года 00:00:00 UTC (Unix epoch). Его ключевая особенность:

// Пример использования
const timestamp = Date.now();
console.log(timestamp); // Вывод: 1721234567890 (пример текущего времени)

Аргументы и возвращаемое значение

• Не принимает аргументов – вызывается без параметров.
• Возвращает число – текущее время в миллисекундах.

Почему Date.now() не является чистой функцией

1. Несоответствие критерию одинакового результата

При каждом вызове функция возвращает разное значение, поскольку время постоянно меняется. Это прямо противоречит первому критерию чистой функции.

const firstCall = Date.now();
const secondCall = Date.now();

console.log(firstCall === secondCall); // Всегда false (если не вызваны одновременно)

2. Зависимость от внешнего состояния

Функция полностью зависит от системного времени, которое является внешним, изменяющимся состоянием. Это нарушает третий критерий.

3. Побочные эффекты

Хотя Date.now() не изменяет явно глобальные переменные или состояние, её вызов может считаться побочным эффектом в контексте тестирования и воспроизводимости, поскольку результат непредсказуем и зависит от среды выполнения.

Практические последствия нечистоты Date.now()

Для тестирования

Тестирование кода с Date.now() требует специальных подходов:

// Проблема в тестах
function generateId() {
  return `item_${Date.now()}`;
}

// Решение: мокать Date.now в тестах
// Используем Jest для примера
jest.spyOn(Date, 'now').mockReturnValue(1625097600000);

Для воспроизводимости и логирования

• Логи с временными метками будут разными при каждом запуске программы.
• Анализ багов сложнее, если они зависят от конкретного времени выполнения.

Как работать с временем в чистых функциях

Если требуется чистая функциональность с временными данными, используют следующие подходы:

1. Инкапсуляция зависимости

Принимать время как аргумент:

// Чистая функция
function formatDate(timestamp) {
  return new Date(timestamp).toISOString();
}

// Использование
const currentTime = Date.now(); // Нечистый вызов
const formatted = formatDate(currentTime); // Чистая обработка

2. Использование фабрик или зависимостей

Создавать функции, которые принимают источник времени:

function createTimeLogger(getTimeFn) {
  return function logEvent(event) {
    return {
      event,
      timestamp: getTimeFn(),
    };
  };
}

// В производственном коде
const logger = createTimeLogger(Date.now);

// В тестах
const testLogger = createTimeLogger(() => 1625097600000);

Заключение

Date.now() – не чистая функция из-за своей зависимости от постоянно изменяющегося системного времени, что приводит к разным результатам при каждом вызове. Это делает её неподходящей для строго функционального программирования, где требуются предсказуемые и воспроизводимые результаты. Однако в реальных приложениях её используют для получения текущего времени, применяя специальные техники (моки, инкапсуляцию) для обеспечения тестируемости и надёжности кода. При разработке важно понимать это ограничение и отделять чистые операции (форматирование, вычисления) от нечистых (получение текущего времени, случайных чисел, пользовательского ввода).