CKTIS / JavaScript
Map.prototype.entries: iterátor dvojíc kľúč–hodnota
Metóda entries vráti živý iterátor dvojíc [key, value] v poradí vloženia a predstavuje predvolenú iteráciu Map.
Verzia: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
map.entries()map.entries() vytvorí nový objekt iterátora Map. Každé úspešné next() vráti nové dvojprvkové pole [key, value]; zmena tohto poľa nezmení položku Map, hoci obsiahnuté objekty zostávajú rovnakými odkazmi. map[Symbol.iterator] je rovnaká funkcia ako map.entries, takže for...of a spread štandardne dostávajú dvojice.
Iterátor je lenivý, nie snímka. Zachováva poradie vloženia, preskakuje položky odstránené pred návštevou a môže vidieť položky pridané pred dosiahnutím konca; aktualizácia ešte nenavštíveného kľúča poskytne novú hodnotu. Keď next() vráti done: true, neskoršie pridanie iterátor neobnoví.
Metóda nemá významné argumenty a vyžaduje prijímač s internými údajmi Map; bežný objekt, Set alebo neošetrený Proxy vyvolá TypeError. Je štandardná od ECMAScript 2015. Ak treba iba kľúče či hodnoty, keys() alebo values() sa vyhnú poliam dvojíc.
Príklady
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);Výsledok
["a",1] 1 ["c",3] false true true true