CKTIS / JavaScript
Map-Iteratoren: next(), value und done
Gehe einen Map-Iterator mit `next()` schrittweise durch. Mit `done` unterscheidest du einen gespeicherten Wert `undefined` vom Ende der Iteration.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const iterator = map.entries(); // or map.keys(), map.values(), map[Symbol.iterator]()
const { value, done } = iterator.next();Mit iterator.next() führst du einen Schritt aus. Die Methode gehört zum Iterator, nicht zur Map, und gibt ein Ergebnisobjekt mit value und done zurück. Das Lesen von result.value bewegt den Iterator nicht weiter, ein weiterer Aufruf von next() dagegen schon. Speichere das Ergebnis, wenn du beide Eigenschaften desselben Schritts brauchst. Ein Aufruf der separat gespeicherten Methode next ohne das richtige this löst einen TypeError aus.
map.keys() liefert Schlüssel, map.values() gespeicherte Werte. map.entries() und map[Symbol.iterator]() liefern bei jedem erfolgreichen Schritt ein neues Array [key, value] mit zwei Elementen als result.value. Alle Varianten durchlaufen die Einträge in Einfügereihenfolge. Prüfe done, nicht value: Bei done: false wurde ein Element geliefert, auch wenn value gleich undefined ist. Ein erschöpfter Map-Iterator gibt { value: undefined, done: true } zurück.
Der Iterator ist keine Momentaufnahme: Er kann Einträge erfassen, die vor dem Ende der Iteration hinzugefügt werden. Sobald er done: true zurückgegeben hat, setzt er die Iteration nicht mehr fort. Erzeuge einen neuen Iterator, um von vorne anzufangen. So verhält sich die eingebaute Map in ECMAScript 2024; die Unterstützung hängt von der Laufzeitumgebung ab.
Beispiele
{
const map = new Map([["a", undefined], ["b", 7]]);
const iterator = map.values();
function logStep({ value, done }) {
console.log(`done=${done}, value=${value}`);
}
logStep(iterator.next());
logStep(iterator.next());
logStep(iterator.next());
map.set("c", 9);
logStep(iterator.next());
console.log(JSON.stringify(map.entries().next().value));
}Ergebnis
done=false, value=undefined done=false, value=7 done=true, value=undefined done=true, value=undefined ["a",null]
Der erste Schritt liefert ein gespeichertes `undefined`, der dritte meldet das Ende. Das Hinzufügen von `"c"` reaktiviert den Iterator nicht. Ein neuer Eintragsiterator beginnt bei `"a"`. In der letzten Zeile stellt `JSON.stringify()` das Array-Element `undefined` als `null` dar, ohne die Map zu verändern.
Zugehörige Lektionen
- JavaScript · Lektion 7 · Fortgeschritten · Version: 4
Quellen
- ECMAScript 2024 Language Specification — Map Iterator Objects
- ECMAScript Language Specification — Properties of the Map Prototype Object
- ECMAScript Language Specification — Map Iterator Objects
- ECMAScript 2024 Language Specification — GeneratorResume
- ECMAScript 2024 Language Specification — GeneratorValidate