Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła