WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen