Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje