CKTIS / JavaScript
Map — kolekce dvojic klíč–hodnota
Map uchovává jedinečné klíče libovolného typu spolu s přiřazenými hodnotami. Umožňuje číst a mazat položky, ověřovat přítomnost klíče a iterovat v pořadí vložení.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
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 vestavěná kolekce dvojic klíč–hodnota. Klíče i hodnoty mohou být libovolné hodnoty JavaScriptu. Prázdnou mapu vytvořte pomocí new Map() nebo konstruktoru předejte iterovatelný objekt obsahující dvojice [key, value]. Volání bez new vyvolá TypeError.
set(key, value) přidá položku nebo ji aktualizuje a vrátí mapu. get(key) přečte její hodnotu; chybějící klíč vrátí undefined. Protože i uložená hodnota může být undefined, přítomnost ověřujte pomocí has(key). Vlastnost size udává počet položek, delete(key) vrací informaci, zda byla položka odstraněna, a clear() odstraní všechny položky.
Porovnávání klíčů se řídí pravidlem SameValueZero: NaN odpovídá NaN a +0 a -0 jsou stejný klíč. Objekty se porovnávají podle identity, nikoli podle obsahu. Dva samostatně vytvořené objekty { id: 1 } jsou proto různé klíče.
Iterace pomocí for...of poskytuje dvojice v pořadí vložení klíčů; keys(), values() a entries() vracejí odpovídající iterátory. Aktualizace hodnoty pozici položky nezmění, ale odstranění a opětovné vložení ji přesune na konec. K přidávání položek používejte set(key, value), nikoli map[key] = value. Přiřazení pomocí hranatých závorek se týká vlastnosti objektu, nikoli položky mapy. Například přiřazení map["size"] = value u nezměněné instance Map v přísném režimu vyvolá TypeError a mimo něj se ignoruje, protože zděděná vlastnost size má getter, ale nemá setter.
Pří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ýsledek
3 2 false 5 [3,2,5]
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.