CKTIS / JavaScript
Map — een sleutel-waardeverzameling
Map bewaart unieke sleutels van elk type met de bijbehorende waarden. Je kunt er items mee lezen en verwijderen, controleren of een sleutel aanwezig is en itereren in de volgorde waarin sleutels zijn toegevoegd.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
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 is een ingebouwde verzameling van sleutel-waardeparen. Zowel sleutels als waarden kunnen elke JavaScript-waarde zijn. Maak een lege map met new Map() of geef de constructor een itereerbaar object met [key, value]-paren. Aanroepen zonder new veroorzaakt een TypeError.
set(key, value) voegt een item toe of werkt het bij en retourneert de map. get(key) leest de waarde; bij een ontbrekende sleutel is het resultaat undefined. Omdat een opgeslagen waarde ook undefined kan zijn, controleer je de aanwezigheid met has(key). De eigenschap size geeft het aantal items aan, delete(key) geeft aan of een item is verwijderd en clear() verwijdert alle items.
Sleutelvergelijking volgt SameValueZero: NaN komt overeen met NaN, en +0 en -0 zijn dezelfde sleutel. Objecten worden vergeleken op identiteit, niet op inhoud. Twee afzonderlijk gemaakte objecten { id: 1 } zijn daarom verschillende sleutels.
Itereren met for...of levert paren op in de volgorde waarin de sleutels zijn toegevoegd; keys(), values() en entries() retourneren de bijbehorende iterators. Een waarde bijwerken verplaatst het item niet, maar verwijderen en opnieuw invoegen verplaatst het naar het einde. Gebruik set(key, value) om items toe te voegen, niet map[key] = value. Een toewijzing met vierkante haken is gericht op een objecteigenschap, niet op een item in de map. Zo veroorzaakt map["size"] = value bij een ongewijzigde Map-instantie een TypeError in de strikte modus en wordt de toewijzing daarbuiten genegeerd, omdat de overgeërfde eigenschap size wel een getter maar geen setter heeft.
Voorbeelden
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()]));Resultaat
3 2 false 5 [3,2,5]
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.