CKTIS / JavaScript
Map.prototype.keys: iterátor klíčů
Metoda keys vrátí živý iterátor klíčů Map v pořadí vložení bez kopírování přidružených hodnot.
Verze: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntaxe
map.keys()map.keys() vytvoří nový iterátor Map. Každé úspěšné next() vrátí další klíč v pořadí vložení; objektové klíče jsou stejné odkazy. Iterátor Map nemění a oddělená volání keys() mají nezávislé pozice.
Iterátor je líný, nikoli snímek. Přeskočí položku odstraněnou před návštěvou a může vidět položku přidanou před koncem. Změna hodnoty nevytvoří novou pozici. Po done: true jej pozdější přidání neobnoví. Klíč -0 se ukládá a vrací jako +0.
Metoda nemá významné argumenty a vyžaduje interní data Map; objekt, Set či neošetřený Proxy vyvolá TypeError. Standardní od ECMAScript 2015. Pro klíče i hodnoty použijte entries() nebo výchozí iteraci.
Příklady
const objectKey = {};
const map = new Map([[objectKey, 1], ["b", 2]]);
const keys = map.keys();
console.log(keys.next().value === objectKey);
map.delete("b");
map.set("c", 3);
const second = keys.next();
console.log(second.value, second.done);
console.log(keys.next().done);
map.set("d", 4);
console.log(keys.next().done);
const zeroKey = new Map([[-0, "zero"]]).keys().next().value;
console.log(Object.is(zeroKey, 0));
try { Map.prototype.keys.call({}); } catch (error) { console.log(error instanceof TypeError); }Výsledek
true c false true true true true