CKTIS / JavaScript
Map.prototype.keys: итератор на ключове
Методът keys връща жив итератор на ключовете на Map по реда на вмъкване, без да копира свързаните стойности.
Версия: ECMAScript 2015 onward; example target: Node.js 24.22.2
Синтаксис
map.keys()map.keys() създава нов итератор на Map. Всяко успешно next() връща следващия ключ по реда на вмъкване; обектните ключове са същите препратки. Итераторът не променя Map, а отделните извиквания имат независими позиции.
Итераторът е ленив, не е снимка. Прескача запис, изтрит преди посещението, и може да види запис, добавен преди края. Промяна на стойност не създава нова позиция. След done: true по-късни добавяния не го възобновяват. Ключ -0 се пази и връща като +0.
Методът няма значими аргументи и изисква вътрешни данни на Map; обект, Set или необработен Proxy хвърля TypeError. Стандартен от ECMAScript 2015. За ключове и стойности използвайте entries() или стандартната итерация.
Примери
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); }Резултат
true c false true true true true