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