KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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

Bronnen