Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Map — kolekcia dvojíc kľúč – hodnota

Map uchováva jedinečné kľúče ľubovoľného typu spolu s priradenými hodnotami. Umožňuje čítať a odstraňovať položky, overovať prítomnosť kľúča a iterovať v poradí vloženia.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

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 je vstavaná kolekcia dvojíc kľúč – hodnota. Kľúče aj hodnoty môžu byť ľubovoľné hodnoty JavaScriptu. Prázdnu mapu vytvorte pomocou new Map() alebo konštruktoru odovzdajte iterovateľný objekt obsahujúci dvojice [key, value]. Volanie bez new vyvolá TypeError.

set(key, value) pridá položku alebo ju aktualizuje a vráti mapu. get(key) prečíta jej hodnotu; chýbajúci kľúč vráti undefined. Keďže aj uložená hodnota môže byť undefined, prítomnosť overte pomocou has(key). Vlastnosť size udáva počet položiek, delete(key) vráti informáciu, či sa položka odstránila, a clear() odstráni všetky položky.

Porovnávanie kľúčov sa riadi pravidlom SameValueZero: NaN zodpovedá NaN a +0 a -0 sú rovnaký kľúč. Objekty sa porovnávajú podľa identity, nie podľa obsahu. Dva samostatne vytvorené objekty { id: 1 } sú preto rôzne kľúče.

Iterácia pomocou for...of poskytuje dvojice v poradí vloženia kľúčov; keys(), values() a entries() vracajú príslušné iterátory. Aktualizácia hodnoty pozíciu položky nezmení, ale odstránenie a opätovné vloženie ju presunie na koniec. Na pridávanie položiek používajte set(key, value), nie map[key] = value. Priradenie pomocou hranatých zátvoriek sa týka vlastnosti objektu, nie položky mapy. Napríklad priradenie map["size"] = value pri nezmenenej inštancii Map vyvolá v prísnom režime TypeError a mimo neho sa ignoruje, pretože zdedená vlastnosť size má getter, ale nemá setter.

Príklady

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()]));

Výsledok

3
2
false
5
[3,2,5]

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje