CKTIS / JavaScript
Map — kolekcja par klucz–wartość
Map przechowuje unikalne klucze dowolnego typu oraz przypisane im wartości. Pozwala odczytywać i usuwać wpisy, sprawdzać obecność klucza oraz iterować w kolejności dodawania.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
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 to wbudowana kolekcja par klucz–wartość. Kluczem i wartością może być dowolna wartość JavaScript. Utwórz pustą mapę przez new Map() albo przekaż do konstruktora obiekt iterowalny zawierający pary [key, value]. Wywołanie bez new zgłasza TypeError.
set(key, value) dodaje lub aktualizuje wpis i zwraca mapę. get(key) odczytuje wartość; brak klucza daje undefined. Ponieważ zapisaną wartością też może być undefined, obecność sprawdzaj przez has(key). Właściwość size podaje liczbę wpisów, delete(key) zwraca informację, czy usunięto wpis, a clear() usuwa wszystkie wpisy.
Porównywanie kluczy odpowiada regule SameValueZero: NaN pasuje do NaN, a +0 i -0 są tym samym kluczem. Obiekty są porównywane według tożsamości, nie zawartości. Dlatego dwa osobno utworzone obiekty { id: 1 } są różnymi kluczami.
Iteracja przez for...of zwraca pary w kolejności dodawania kluczy; keys(), values() i entries() zwracają odpowiednie iteratory. Aktualizacja wartości nie zmienia pozycji wpisu, ale usunięcie i ponowne dodanie przenosi go na koniec. Do dodawania wpisów używaj set(key, value), a nie map[key] = value. Przypisanie z użyciem nawiasów kwadratowych dotyczy właściwości obiektu, a nie wpisu mapy. Na przykład przypisanie map["size"] = value na niezmodyfikowanej instancji Map zgłasza TypeError w trybie ścisłym, a poza nim jest ignorowane, ponieważ odziedziczona właściwość size ma getter, ale nie ma settera.
Przykłady
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()]));Wynik
3 2 false 5 [3,2,5]
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.