Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

Viri