CKTIS / JavaScript
Map.prototype.keys: iterator ključev
Metoda keys vrne živ iterator ključev Map v vrstnem redu vstavljanja brez kopiranja pripadajočih vrednosti.
Različica: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintaksa
map.keys()map.keys() ustvari nov iterator Map. Vsak uspešen next() vrne naslednji ključ v vrstnem redu vstavljanja; objektni ključi so isti sklici. Iterator Map ne spremeni, ločeni klici keys() pa imajo neodvisne položaje.
Iterator je len, ni posnetek. Preskoči vnos, izbrisan pred obiskom, in lahko vidi vnos, dodan pred koncem. Sprememba vrednosti ne ustvari novega položaja. Po done: true ga poznejši dodatki ne nadaljujejo. Ključ -0 se shrani in vrne kot +0.
Metoda nima pomenljivih argumentov in zahteva notranje podatke Map; objekt, Set ali neobravnavan Proxy sproži TypeError. Standardna od ECMAScript 2015. Za ključe in vrednosti uporabite entries() ali privzeto iteracijo.
Primeri
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); }Rezultat
true c false true true true true