Что такое…

Что такое WeakMap в JavaScript — и почему кэш на Map тихо съедает память

Иллюстрация: гардероб, где пальто забрали, а номерок сам рассыпается в пыль

Ты сделал одностраничное приложение. Чтобы не считать одно и то же дважды, завёл кэш: для каждой карточки на экране запоминаешь её размеры.

const cache = new Map()

function getSize(card) {
  if (!cache.has(card)) cache.set(card, card.getBoundingClientRect())
  return cache.get(card)
}

Работает быстро. Пользователь листает ленту час — и вкладка начинает тормозить. Карточки давно удалены со страницы. Но память они не отпускают. Их держит твой кэш.

Это классическая утечка памяти. И у JavaScript есть для неё готовое лекарство — WeakMap.

Что такое WeakMap простыми словами

WeakMap — это словарь «ключ → значение», который не мешает сборщику мусора убрать ключ.

Сначала про сборщик мусора. JavaScript сам чистит память. Если на объект больше никто не ссылается, его можно выбросить. Обычный Map — это ссылка. Пока объект лежит ключом в Map, он «кому-то нужен». Значит, выбрасывать нельзя.

WeakMap держит ключ слабо. Он как бы говорит: «я помню это значение, пока объект жив, но жить ему не помогаю». Карточку удалили из DOM, других ссылок нет — сборщик её уберёт. Запись в WeakMap исчезнет вместе с ней.

Аналогия — гардероб. Обычный Map — гардеробщик, который не отдаёт пальто, пока висит номерок. WeakMap — номерок сам рассыпается, как только пальто забрали.

Как им пользоваться

API почти как у Map, только короче:

const sizes = new WeakMap()

sizes.set(card, { width: 300 })
sizes.get(card)      // { width: 300 }
sizes.has(card)      // true
sizes.delete(card)

Пример с кэшем исправляется заменой одного слова: new Map() → new WeakMap(). Всё остальное работает так же. Только теперь удалённые карточки не застревают в памяти.

Чего WeakMap не умеет — и почему

Тут начинаются сюрпризы. У WeakMap нет:

  • .size — сколько там записей, узнать нельзя;
  • .keys(), .values(), for...of — перебрать нельзя;
  • .clear() — очистить разом нельзя.

Это не недоделка. Сборщик мусора работает когда захочет. Если бы WeakMap можно было перебрать, результат зависел бы от того, успел он пройти или нет. Сегодня 10 записей, через секунду 7, на другом компьютере 9. Чтобы код не зависел от этой лотереи, перебор просто убрали.

Второй сюрприз — ключом может быть только объект:

new WeakMap().set('user-1', data)
// TypeError: Invalid value used as weak map key

Строка, число, true — нельзя. Строку 'user-1' нельзя «удалить из памяти»: её можно в любой момент написать заново. С 2023 года ключом может быть ещё и символ, созданный через Symbol(). А вот Symbol.for() — нет, он живёт вечно в глобальном реестре.

Отсюда важное следствие. Кэш ответов сервера по URL на WeakMap не сделаешь — URL это строка. Для такого нужен обычный Map с ограничением размера. Например, удаляй самую старую запись, когда их больше сотни. Подробнее о стратегиях — в статье про кэширование.

Когда WeakMap — правильный выбор

Правило простое. Нужно приклеить данные к чужому объекту и не отвечать за его жизнь? Это работа для WeakMap. Например:

  • Кэш вычислений по объекту. Размеры DOM-элемента, разобранный конфиг, отфильтрованный список для конкретного массива.
  • Мемоизация по аргументу-объекту. Функция получает объект и долго что-то считает. WeakMap запомнит ответ, пока объект жив. С обычным Map ты копил бы все объекты, которые когда-либо видел.
  • Скрытые данные объекта. Библиотека хранит служебное состояние для твоих объектов и не добавляет в них лишних полей. Так эмулировали приватные поля классов, пока не появился #field.
  • Пометка «уже обработано». Для этого есть брат — WeakSet: тот же принцип, только без значений. seen.add(node), seen.has(node).

А вот если ты сам создаёшь ключи и сам решаешь, когда их удалять, бери обычный Map. Его можно перебрать, посчитать и очистить.

Как проверить, что утечка была

Открой DevTools → Memory → Heap snapshot. Полистай приложение, сделай второй снимок. В фильтре набери Detached. Это элементы, которых нет на странице, но которые кто-то держит в памяти. Число растёт — ищи Map, массив или подписку, которые их хранят.

Одна оговорка. Не пытайся «увидеть» работу WeakMap в консоли. Сборщик мусора приходит не сразу и не по команде. Запись может пожить ещё минуту — это нормально.

Чем WeakMap отличается от Map?

Map держит ключи в памяти и умеет size, перебор и clear. WeakMap принимает ключами только объекты, не держит их и ничего не перебирает. Зато не создаёт утечек.

Можно ли использовать WeakMap как кэш запросов?

Только если ключ — объект, например объект запроса или компонента. Кэш по URL или id — это строки. Для них нужен Map с лимитом записей или готовая библиотека кэширования.

Что такое WeakRef?

Это слабая ссылка на один объект: ref.deref() вернёт объект или undefined, если его уже убрали. Инструмент редкий и капризный. В обычном приложении почти всегда хватает WeakMap.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →