База знанияИзпитен център
BGБългарски
Избери език13

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]

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници