Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Set.prototype.keys() — iterator wartości zbioru

Set.prototype.keys() zwraca nowy iterator wartości zbioru w kolejności dodawania. Nie zwraca indeksów ani tablicy: w Set klucze i wartości oznaczają te same elementy.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

set.keys()

set.keys() nie wymaga argumentów i zwraca nowy iterator wartości zbioru w kolejności dodawania. Set nie ma osobnych kluczy ani indeksów. W niezmodyfikowanej bibliotece standardowej Set.prototype.keys i Set.prototype.values wskazują tę samą funkcję; nazwa keys zapewnia spójność z interfejsem Map.

Iterator nie jest tablicą. Wywołanie next() przesuwa go o jeden element, a [...iterator] zbiera pozostałe elementy do tablicy. Po wyczerpaniu iteratora next() zwraca wynik z done: true. Ponowne wywołanie set.keys() tworzy niezależny iterator.

Iterator nie jest migawką zbioru: element usunięty przed odwiedzeniem zostaje pominięty, a element dodany przed zakończeniem iteracji może zostać odwiedzony. Wywołanie metody z this, które nie ma wewnętrznych danych Set, zgłasza TypeError.

W przykładzie powtórzone "red" nie tworzy drugiego elementu. Pierwsze next() pobiera "red", więc rozwinięcie iteratora zawiera już tylko "blue".

Przykłady

const colors = new Set(["red", "blue", "red"]);
const iterator = colors.keys();

console.log(Set.prototype.keys === Set.prototype.values);
console.log(iterator.next().value);
console.log([...iterator].join(","));
console.log(iterator.next().done);

Wynik

true
red
blue
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła