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

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

Zdroje