Map. В чём особенность? Какие свойства и методы есть? Как перебрать?

const map = new Map();
map.set('ключ', 'значение');
map.set(1, 'число как ключ');
map.set(true, 'булево как ключ');
 
console.log(map.get('ключ')); // 'значение'
console.log(map.size); // 3

// Создание Map
const userMap = new Map();
 
// Добавление элементов
userMap.set('имя', 'Иван');
userMap.set('возраст', 25);
userMap.set(1, 'первый');
 
// Получение значений
console.log(userMap.get('имя'));    // 'Иван'
console.log(userMap.get(1));        // 'первый'
 
// Проверка наличия
console.log(userMap.has('имя'));    // true
console.log(userMap.has('город'));  // false
 
// Удаление
userMap.delete('возраст');
console.log(userMap.size); // 2

const map = new Map();
const funcKey = function() {};
const objKey = {};
const arrKey = [];
 
map.set(funcKey, 'функция как ключ');
map.set(objKey, 'объект как ключ');
map.set(arrKey, 'массив как ключ');
map.set(NaN, 'NaN тоже работает');
 
console.log(map.get(funcKey)); // 'функция как ключ'

const map = new Map([
  ['a', 1],
  ['b', 2],
  ['c', 3]
]);
 
console.log(map.size); // 3 (количество элементов)

const map = new Map();
 
// set(key, value) — добавляет пару ключ-значение
map.set('ключ', 'значение');
 
// get(key) — получает значение по ключу
const value = map.get('ключ');
 
// has(key) — проверяет наличие ключа
const exists = map.has('ключ');
 
// delete(key) — удаляет элемент по ключу
map.delete('ключ');
 
// clear() — очищает всю Map
map.clear();

const map = new Map([
  ['имя', 'Иван'],
  ['возраст', 25],
  ['город', 'Москва']
]);
 
// Перебор пар [ключ, значение]
for (const [key, value] of map) {
  console.log(key, value);
}
 
// Перебор только ключей
for (const key of map.keys()) {
  console.log(key);
}
 
// Перебор только значений
for (const value of map.values()) {
  console.log(value);
}

const map = new Map([
  ['a', 1],
  ['b', 2],
  ['c', 3]
]);
 
map.forEach((value, key) => {
  console.log(key, value);
});

// Объекты как ключи — только в Map!
const user1 = { id: 1, name: 'Иван' };
const user2 = { id: 2, name: 'Петр' };
 
const userRoles = new Map();
userRoles.set(user1, 'админ');
userRoles.set(user2, 'пользователь');

// Map сохраняет порядок добавления
const ordered = new Map();
ordered.set('третий', 3);
ordered.set('первый', 1);
ordered.set('второй', 2);
 
for (const [key, value] of ordered) {
  console.log(key, value); 
  // Вывод в порядке добавления, не алфавитном!
}

// ❌ Ошибка — попытка использовать объект как ключ в объекте
const obj = {};
const key = {};
// obj[key] = 'значение'; // key становится '[object Object]'
 
// ✅ Правильно — использовать Map для любых ключей
const map = new Map();
map.set(key, 'значение'); // работает как ожидается

// ❌ Ошибка — забыли new
// const map = Map(); // TypeError!
 
// ✅ Правильно
const map = new Map();