re:re:actable
Урок 042 минуты чтения

Что такое module cache?

На этой странице
Кратко

Module cache - механизм, из-за которого модуль после первой загрузки обычно переиспользуется повторно. Это ускоряет работу и позволяет модулям хранить состояние, но может удивлять в тестах и при side effects.

Вопрос

Что такое module cache в Node.js и как он влияет на поведение модулей?

CommonJS cache

// counter.cjs
let count = 0;
 
module.exports.increment = () => {
  count += 1;
  return count;
};
const a = require('./counter.cjs');
const b = require('./counter.cjs');
 
console.log(a.increment()); // 1
console.log(b.increment()); // 2

a и b получают один и тот же экземпляр модуля.

Зачем нужен cache?

  • не выполнять один и тот же файл много раз;
  • ускорить загрузку;
  • позволить singleton-паттернам работать;
  • сохранить состояние модуля.

Side effects

Код на верхнем уровне модуля выполняется при первой загрузке.

console.log('module loaded');
 
export const value = 42;

Повторный импорт обычно не напечатает сообщение заново.

В тестах

Module cache может мешать, если тесты зависят от чистого состояния. Тогда лучше проектировать модули без скрытого состояния или явно создавать новые экземпляры через функции-фабрики.

Что важно помнить

  • Модуль выполняется один раз; повторный import или require возвращает тот же экземпляр.
  • Поэтому модуль удобен как singleton, но изменяемое состояние модуля общее для всего процесса.
  • В CommonJS кеш доступен через require.cache, в ESM программно очистить кеш нельзя.
  • Ключ кеша — разрешенный путь: разные пути к одному файлу дают разные экземпляры.

Мини-шпаргалка

  • Модуль обычно выполняется один раз.
  • Повторная загрузка возвращает cached exports.
  • Верхнеуровневые side effects выполняются при первой загрузке.
  • Cache полезен для производительности.
  • Скрытое состояние модуля усложняет тестирование.

Документация

Node.js: Modules — Caching.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам