CKTIS / JavaScript
Map.prototype.keys: Schlüsseliterator
Die Methode keys liefert einen lebenden Iterator über Map-Schlüssel in Einfügereihenfolge, ohne die zugehörigen Werte zu kopieren.
Version: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
map.keys()map.keys() erzeugt einen neuen Map-Iterator. Jedes erfolgreiche next() liefert den nächsten Schlüssel in Einfügereihenfolge; Objektschlüssel bleiben dieselben Referenzen. Der Iterator verändert die Map nicht, getrennte keys()-Aufrufe haben unabhängige Positionen.
Der Iterator ist faul, keine Momentaufnahme. Er überspringt vor dem Besuch gelöschte Einträge und kann vor dem Ende hinzugefügte sehen. Eine Wertänderung erzeugt keine neue Position. Nach einem done: true wird der Iterator durch spätere Einträge nicht fortgesetzt. -0 wird als +0 gespeichert und geliefert.
Die Methode hat keine bedeutungsvollen Argumente und verlangt interne Map-Daten; Objekt, Set oder unbehandelter Proxy löst TypeError aus. Seit ECMAScript 2015 Standard. Für Schlüssel und Werte dient entries() oder die Standarditeration.
Beispiele
const objectKey = {};
const map = new Map([[objectKey, 1], ["b", 2]]);
const keys = map.keys();
console.log(keys.next().value === objectKey);
map.delete("b");
map.set("c", 3);
const second = keys.next();
console.log(second.value, second.done);
console.log(keys.next().done);
map.set("d", 4);
console.log(keys.next().done);
const zeroKey = new Map([[-0, "zero"]]).keys().next().value;
console.log(Object.is(zeroKey, 0));
try { Map.prototype.keys.call({}); } catch (error) { console.log(error instanceof TypeError); }Ergebnis
true c false true true true true