CKTIS / JavaScript
Map — zbirka parov ključ–vrednost
Map shranjuje enolične ključe poljubne vrste skupaj s pripadajočimi vrednostmi. Omogoča branje in brisanje vnosov, preverjanje prisotnosti ključa ter iteracijo v vrstnem redu dodajanja.
Različica: 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 vgrajena zbirka parov ključ–vrednost. Tako ključi kot vrednosti so lahko poljubne vrednosti JavaScripta. Prazno mapo ustvarite z new Map() ali pa konstruktorju posredujte iterabilen objekt s pari [key, value]. Klic brez new sproži TypeError.
set(key, value) doda ali posodobi vnos in vrne mapo. get(key) prebere njegovo vrednost; če ključa ni, vrne undefined. Ker je tudi shranjena vrednost lahko undefined, prisotnost preverite z has(key). Lastnost size poda število vnosov, delete(key) pove, ali je bil vnos izbrisan, clear() pa odstrani vse vnose.
Primerjava ključev sledi pravilu SameValueZero: NaN se ujema z NaN, +0 in -0 pa sta isti ključ. Objekti se primerjajo po identiteti, ne po vsebini. Dva ločeno ustvarjena objekta { id: 1 } sta zato različna ključa.
Iteracija z for...of vrne pare v vrstnem redu dodajanja ključev; keys(), values() in entries() vrnejo ustrezne iteratorje. Posodobitev vrednosti ne spremeni mesta vnosa, izbris in ponovni vnos pa ga premakneta na konec. Za dodajanje vnosov uporabite set(key, value), ne map[key] = value. Prirejanje z oglatimi oklepaji se nanaša na lastnost objekta, ne na vnos v mapi. Na primer, pri nespremenjeni instanci Map prireditev map["size"] = value v strogem načinu sproži TypeError, zunaj strogega načina pa se prezre, ker ima podedovana lastnost size metodo za branje, ne pa tudi metode za nastavljanje.
Primeri
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]
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.