Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Map.prototype.entries: iterátor dvojic klíč–hodnota

Metoda entries vrátí živý iterátor dvojic [key, value] v pořadí vložení a představuje výchozí iteraci Map.

Verze: ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntaxe

map.entries()

map.entries() vytvoří nový objekt iterátoru Map. Každé úspěšné next() vrátí nové dvouprvkové pole [key, value]; změna tohoto pole nezmění položku Map, i když obsažené objekty zůstávají stejnými odkazy. map[Symbol.iterator] je stejná funkce jako map.entries, takže for...of a spread standardně dostávají dvojice.

Iterátor je líný, nikoli snímek. Zachovává pořadí vložení, přeskakuje položky odstraněné před návštěvou a může vidět položky přidané před dosažením konce; aktualizace dosud nenavštíveného klíče poskytne novou hodnotu. Jakmile next() vrátí done: true, pozdější přidání iterátor neobnoví.

Metoda nemá významné argumenty a vyžaduje příjemce s interními daty Map; běžný objekt, Set nebo neošetřený Proxy vyvolá TypeError. Je standardní od ECMAScript 2015. Jsou-li potřeba jen klíče či hodnoty, keys() nebo values() se vyhnou polím dvojic.

Pří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ýsledek

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

Zdroje