CKTIS / JavaScript
Map.prototype.keys: iterator kluczy
Metoda keys zwraca żywy iterator kluczy Map w kolejności wstawiania, bez kopiowania odpowiadających im wartości.
Wersja: ECMAScript 2015 onward; example target: Node.js 24.22.2
Składnia
map.keys()map.keys() tworzy nowy iterator Map. Każde udane next() zwraca następny klucz w kolejności wstawiania; klucze-obiekty są tymi samymi referencjami, nie klonami. Iterator nie zmienia Map, a wielokrotne wywołania keys() tworzą niezależne pozycje iteracji.
Iterator jest leniwy, a nie migawkowy. Pomija wpis usunięty przed odwiedzeniem i może zobaczyć wpis dodany przed osiągnięciem końca. Aktualizacja wartości istniejącego klucza nie tworzy nowej pozycji. Po pierwszym wyniku done: true późniejsze dodatki nie wznawiają zakończonego iteratora. Klucz -0 jest przechowywany i zwracany jako +0.
Metoda nie przyjmuje znaczących argumentów i wymaga odbiorcy z wewnętrznymi danymi Map; zwykły obiekt, Set albo nieobsłużony Proxy powoduje TypeError. Jest standardowa od ECMAScript 2015. Gdy potrzebne są także wartości, użyj entries() lub domyślnej iteracji Map.
Przykłady
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); }Wynik
true c false true true true true