KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Map.prototype.entries: iterator voor sleutel-waardeparen

De methode entries geeft een levende iterator van [key, value]-paren in invoegvolgorde terug en is de standaarditeratie van Map.

Versie: ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntax

map.entries()

map.entries() maakt een nieuw Map-iteratorobject. Elke geslaagde next() geeft een nieuwe tweedelige array [key, value]; wijziging van die array verandert het Map-item niet, hoewel objecten erin dezelfde referenties blijven. map[Symbol.iterator] is dezelfde functie als map.entries, dus for...of en spread ontvangen standaard paren.

De iterator is lui en geen momentopname. Hij bewaart invoegvolgorde, slaat vóór bezoek verwijderde items over en kan vóór het einde toegevoegde items zien; bijwerking van een nog niet bezochte sleutel levert de nieuwe waarde. Zodra next() done: true heeft gegeven, hervatten latere toevoegingen die iterator niet.

De methode heeft geen betekenisvolle argumenten en vereist een ontvanger met interne Map-gegevens; een gewoon object, Set of onbehandelde Proxy werpt TypeError. Ze is standaard sinds ECMAScript 2015. Gebruik keys() of values() wanneer alleen dat onderdeel nodig is, zodat paar-arrays worden vermeden.

Voorbeelden

const map = new Map([["a", 1], ["b", 2]]);
const entries = map.entries();
const first = entries.next().value;
console.log(JSON.stringify(first));
first[1] = 99;
console.log(map.get("a"));

map.delete("b");
map.set("c", 3);
const second = entries.next();
console.log(JSON.stringify(second.value), second.done);
console.log(entries.next().done);

map.set("d", 4);
console.log(entries.next().done);
console.log(map[Symbol.iterator] === map.entries);

Resultaat

["a",1]
1
["c",3] false
true
true
true

Bronnen