CKTIS / JavaScript
Map.prototype.keys: sleuteliterator
De methode keys geeft een levende iterator over Map-sleutels in invoegvolgorde terug zonder bijbehorende waarden te kopiëren.
Versie: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
map.keys()map.keys() maakt een nieuwe Map-iterator. Elke geslaagde next() geeft de volgende sleutel in invoegvolgorde; objectsleutels blijven dezelfde referenties. De iterator wijzigt de Map niet en afzonderlijke keys()-aanroepen hebben onafhankelijke posities.
De iterator is lui, geen momentopname. Hij slaat een vóór bezoek verwijderd item over en kan een vóór het einde toegevoegd item zien. Een waardewijziging maakt geen nieuwe positie. Na done: true hervatten latere toevoegingen hem niet. Sleutel -0 wordt als +0 opgeslagen en teruggegeven.
De methode heeft geen betekenisvolle argumenten en vereist interne Map-gegevens; object, Set of onbehandelde Proxy werpt TypeError. Standaard sinds ECMAScript 2015. Gebruik entries() of standaarditeratie als ook waarden nodig zijn.
Voorbeelden
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); }Resultaat
true c false true true true true