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

CKTIS / JavaScript

Map.prototype.keys: iterátor kľúčov

Metóda keys vráti živý iterátor kľúčov Map v poradí vloženia bez kopírovania priradených hodnôt.

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

Syntax

map.keys()

map.keys() vytvorí nový iterátor Map. Každé úspešné next() vráti ďalší kľúč v poradí vloženia; objektové kľúče sú rovnaké odkazy. Iterátor Map nemení a oddelené volania keys() majú nezávislé pozície.

Iterátor je lenivý, nie snímka. Preskočí položku odstránenú pred návštevou a môže vidieť položku pridanú pred koncom. Zmena hodnoty nevytvorí novú pozíciu. Po done: true ho neskoršie pridanie neobnoví. Kľúč -0 sa ukladá a vracia ako +0.

Metóda nemá významné argumenty a vyžaduje interné údaje Map; objekt, Set či neošetrený Proxy vyvolá TypeError. Štandardná od ECMAScript 2015. Pre kľúče aj hodnoty použite entries() alebo predvolenú iteráciu.

Prí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ýsledok

true
c false
true
true
true
true

Zdroje