Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła