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

CKTIS / JavaScript

Map.prototype.entries: iterator parov ključ–vrednost

Metoda entries vrne živ iterator parov [key, value] v vrstnem redu vstavljanja in je privzeta iteracija Map.

Različica: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaksa

map.entries()

map.entries() ustvari nov objekt iteratorja Map. Vsak uspešen next() vrne sveže dvoelementno polje [key, value]; spreminjanje tega polja ne spremeni vnosa Map, čeprav vsebovani objekti ostanejo isti sklici. map[Symbol.iterator] je ista funkcija kot map.entries, zato for...of in spread privzeto prejmeta pare.

Iterator je len in ni posnetek. Ohranja vrstni red vstavljanja, preskoči vnose, izbrisane pred obiskom, ter lahko vidi vnose, dodane pred doseženim koncem; posodobitev še neobiskanega ključa vrne novo vrednost. Ko next() enkrat vrne done: true, poznejši dodatki iteratorja ne nadaljujejo.

Metoda nima pomenljivih argumentov in zahteva prejemnika z notranjimi podatki Map; navaden objekt, Set ali neobravnavan Proxy sproži TypeError. Standardna je od ECMAScript 2015. Kadar so potrebni le ključi ali vrednosti, keys() oziroma values() preprečita ustvarjanje polj parov.

Primeri

const map = new Map([["a", 1], ["b", 2]]);
const entries = map.entries();
const first = entries.next().value;
console.log(JSON.stringify(first));
first[1] = 99;
console.log(map.get("a"));

map.delete("b");
map.set("c", 3);
const second = entries.next();
console.log(JSON.stringify(second.value), second.done);
console.log(entries.next().done);

map.set("d", 4);
console.log(entries.next().done);
console.log(map[Symbol.iterator] === map.entries);

Rezultat

["a",1]
1
["c",3] false
true
true
true

Viri