Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje