Что такое…

Что такое Map в JavaScript — и почему объект тайком превращает твои ключи в текст

Иллюстрация: связка, где ключами служат монета, лист и чашка — каждый привязан к своему ящику

Смотри, какой фокус. Создаёшь пустой объект и кладёшь в него два значения — по ключу 1 и по ключу "1":

const box = {}
box[1] = "число"
box["1"] = "строка"
box   // { "1": "строка" }

Осталось одно. Объект молча превратил число 1 в текст "1" — и второе значение затёрло первое. Никакой ошибки. А если использовать как ключ другой объект, получится совсем смешно: ключом станет строка "[object Object]". Одна на все объекты сразу.

Для этого в JavaScript и есть Map.

Что такое Map

Map — это словарь: набор пар «ключ → значение». По ключу кладёшь, по ключу достаёшь. Как гардероб: сдал пальто, получил номерок, по номерку забрал.

const prices = new Map()
prices.set("кофе", 250)
prices.set("чай", 180)

prices.get("кофе")   // 250
prices.has("сок")    // false
prices.size          // 2

Главное отличие от объекта: ключом может быть что угодно, и Map его не переделывает. Число останется числом, строка — строкой. Даже объект может быть ключом — сам объект, а не его текстовая подпись.

const m = new Map()
m.set(1, "число")
m.set("1", "строка")
m.size   // 2 — оба на месте

Не путай с .map()

Вот где новички теряются. В JavaScript есть два разных «map», и у них общее только имя.

  • new Map() — коллекция, словарь. Хранит пары.
  • array.map(...) — метод массива. Превращает один список в другой: prices.map(p => p * 2). Про него — в статье цикл for или map.

Как отличить в коде от ИИ: если есть new Map или .set( и .get( — это словарь. Если .map( стоит после массива со стрелкой внутри — это преобразование списка.

Map или обычный объект

Объект тоже умеет хранить пары, и в большинстве кода от ИИ ты увидишь именно его. Когда же Map лучше?

Бери Map, если:

  • ключи — не строки: id-числа, объекты, даты;
  • ключи приходят от пользователя. Слово "constructor" или "__proto__" в объекте ведёт себя странно, в Map — как любое другое;
  • пары часто добавляются и удаляются. Map для этого и сделан, у него есть size и delete;
  • важен порядок. Map отдаёт пары ровно в том порядке, в каком ты их положил.

Оставь объект, если:

  • это описание одной вещи с заранее известными полями: { name, email, age };
  • данные надо отправить на сервер или сохранить. Об этом — ниже.

Главная ловушка: JSON

Map не переживает превращения в JSON. Никакой ошибки — просто пустота:

JSON.stringify(new Map([["кофе", 250]]))   // "{}"

Сохранил Map в localStorage, перезагрузил страницу — данных нет. Отправил на сервер — пришёл пустой объект. Это один из самых тихих багов, потому что до перезагрузки всё работает.

Чинится одной строчкой в каждую сторону:

// Map → объект, перед сохранением
const plain = Object.fromEntries(prices)

// объект → Map, после загрузки
const back = new Map(Object.entries(plain))

Если ключи не строки, сохраняй как массив пар: [...prices], а обратно — new Map(pairs).

Где ты его встретишь

В коде от ИИ Map чаще всего появляется в трёх ролях:

  • кэш: запомнить ответ сервера по id, чтобы не запрашивать повторно — cache.get(id);
  • подсчёт: сколько раз встретилось каждое слово — counts.set(word, (counts.get(word) ?? 0) + 1);
  • связь «объект → данные»: хранить что-то рядом с DOM-элементом или пользователем, не трогая сам объект.

Перебирается Map обычным for...of — сразу парами:

for (const [item, price] of prices) {
  console.log(item, price)
}

Как попросить ИИ

Модели по привычке берут объект даже там, где просится Map. Назови структуру прямо — и заодно предупреди про сохранение:

Слабый промптсделай кэш ответов сервера
Сильный промптСделай кэш ответов API через Map: ключ — id товара (число), значение — объект товара. Перед запросом проверяй cache.has(id). Если кэш надо сохранять в localStorage, превращай его в массив пар и обратно через new Map(pairs).

Слабый промпт даст объект с ключами-строками и, скорее всего, тихо потеряет кэш при сохранении. Сильный заранее закрывает обе ловушки из этой статьи.

Map быстрее объекта?

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

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

Set хранит просто значения без повторов — «есть или нет». Map хранит пары: к каждому ключу привязано значение.

Что в Python вместо Map?

Обычный dict. В отличие от объекта в JavaScript, он не превращает ключи в строки: 1 и "1" там разные ключи — ровно как в Map.

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

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

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

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

Все статьи →