CKTIS / JavaScript
Map.prototype.entries: Iterator für Schlüssel-Wert-Paare
Die Methode entries liefert einen lebenden Iterator von [key, value]-Paaren in Einfügereihenfolge und ist die Standarditeration einer Map.
Version: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
map.entries()map.entries() erzeugt ein neues Map-Iteratorobjekt. Jedes erfolgreiche next() liefert ein frisches Array [key, value] mit zwei Elementen; seine Änderung verändert den Map-Eintrag nicht, enthaltene Objekte bleiben jedoch dieselben Referenzen. map[Symbol.iterator] ist dieselbe Funktion wie map.entries, daher erhalten for...of und Spread standardmäßig Paare.
Der Iterator ist faul und keine Momentaufnahme. Er hält die Einfügereihenfolge ein, überspringt vor dem Besuch gelöschte Einträge und kann vor Erreichen des Endes hinzugefügte Einträge sehen; eine aktualisierte, noch nicht besuchte Schlüssel-Wert-Zuordnung liefert den neuen Wert. Nach einem done: true wird der Iterator durch spätere Einträge nicht fortgesetzt.
Die Methode hat keine bedeutungsvollen Argumente und verlangt einen Empfänger mit internen Map-Daten; ein gewöhnliches Objekt, Set oder unbehandelter Proxy löst TypeError aus. Sie ist seit ECMAScript 2015 Standard. Wenn nur Schlüssel oder Werte benötigt werden, vermeiden keys() beziehungsweise values() die Paar-Arrays.
Beispiele
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);Ergebnis
["a",1] 1 ["c",3] false true true true