Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Map — kolekcija parova ključ–vrijednost

Map pohranjuje jedinstvene ključeve bilo koje vrste zajedno s pripadajućim vrijednostima. Omogućuje čitanje i brisanje stavki, provjeru postoji li ključ te iteraciju redoslijedom umetanja.

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

Sintaksa

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 ugrađena kolekcija parova ključ–vrijednost. I ključevi i vrijednosti mogu biti bilo koje JavaScript vrijednosti. Praznu mapu stvorite pomoću new Map() ili konstruktoru predajte iterabilni objekt koji sadrži parove [key, value]. Poziv bez new izaziva TypeError.

set(key, value) dodaje ili ažurira stavku i vraća mapu. get(key) čita njezinu vrijednost; za ključ koji ne postoji vraća se undefined. Budući da i pohranjena vrijednost može biti undefined, prisutnost provjerite pomoću has(key). Svojstvo size daje broj stavki, delete(key) vraća informaciju je li stavka uklonjena, a clear() uklanja sve stavke.

Usporedba ključeva slijedi pravilo SameValueZero: NaN odgovara vrijednosti NaN, a +0 i -0 isti su ključ. Objekti se uspoređuju prema identitetu, a ne prema sadržaju. Dva zasebno stvorena objekta { id: 1 } stoga su različiti ključevi.

Iteracija pomoću for...of daje parove redoslijedom umetanja ključeva; keys(), values() i entries() vraćaju odgovarajuće iteratore. Ažuriranje vrijednosti ne mijenja položaj stavke, ali njezino brisanje i ponovno umetanje premješta je na kraj. Za dodavanje stavki upotrijebite set(key, value), a ne map[key] = value. Dodjela s uglatim zagradama odnosi se na svojstvo objekta, a ne na stavku mape. Primjerice, na neizmijenjenoj instanci Map dodjela map["size"] = value u strogom načinu rada izaziva TypeError, a izvan njega se zanemaruje jer naslijeđeno svojstvo size ima metodu za čitanje, ali nema metodu za postavljanje vrijednosti.

Primjeri

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

Rezultat

3
2
false
5
[3,2,5]

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori