CKTIS / JavaScript
Map — колекция от двойки ключ–стойност
Map съхранява уникални ключове от всякакъв тип заедно със съответните им стойности. Позволява четене и изтриване на записи, проверка дали даден ключ съществува и обхождане в реда на добавяне.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
new Map()
new Map(iterable)
map.set(key, value)
map.get(key)
map.has(key)
map.delete(key)
map.clear()
map.size
for (const [key, value] of map) { /* ... */ }Map е вградена колекция от двойки ключ–стойност. Както ключовете, така и стойностите могат да бъдат произволни стойности в JavaScript. Създайте празна колекция с new Map() или подайте на конструктора итерируем обект с двойки [key, value]. Извикване без new поражда TypeError.
set(key, value) добавя или актуализира запис и връща колекцията. get(key) прочита стойността му; при липсващ ключ резултатът е undefined. Тъй като и съхранената стойност може да бъде undefined, проверявайте наличието с has(key). Свойството size дава броя на записите, delete(key) връща дали е бил изтрит запис, а clear() премахва всички записи.
Сравняването на ключове следва правилото SameValueZero: NaN съвпада с NaN, а +0 и -0 са един и същ ключ. Обектите се сравняват по идентичност, а не по съдържание. Затова два отделно създадени обекта { id: 1 } са различни ключове.
Итерирането с for...of извежда двойките в реда на добавяне на ключовете; keys(), values() и entries() връщат съответните итератори. Актуализирането на стойност не променя позицията на записа, но изтриването и повторното му добавяне го премества в края. За добавяне на записи използвайте set(key, value), а не map[key] = value. Присвояването с квадратни скоби се отнася до свойство на обекта, а не до запис в колекцията. Например при непроменен екземпляр на Map присвояването map["size"] = value поражда TypeError в строг режим, а извън него се игнорира, защото наследеното свойство size има метод за четене, но няма метод за задаване на стойност.
Примери
const key = { id: 1 };
const map = new Map([["first", 1], [key, 2]]);
map.set("first", 3);
map.set(NaN, 4);
map.set(NaN, 5);
console.log(map.size);
console.log(map.get(key));
console.log(map.has({ id: 1 }));
console.log(map.get(NaN));
console.log(JSON.stringify([...map.values()]));Резултат
3 2 false 5 [3,2,5]
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.