Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Set.prototype.entries() — iterator par wartości

Set.prototype.entries() zwraca iterator par [value, value] w kolejności dodawania elementów. Pierwsza pozycja nie jest indeksem: Set nie przechowuje osobnych kluczy. Iterator można odczytywać przez next(), for...of lub operator rozwinięcia.

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.entries()

Set.prototype.entries() nie przyjmuje argumentów i zwraca nowy iterator. Każdy jego element jest nową dwuelementową tablicą [value, value]. Obie pozycje zawierają tę samą wartość; dla obiektu są to odwołania do tego samego obiektu, a nie kopie. Taki format odpowiada parom zwracanym przez Map.prototype.entries(), ale Set nie ma osobnych kluczy ani indeksów.

Elementy są odwiedzane w kolejności dodawania. set.values() oraz domyślna iteracja po set zwracają pojedyncze wartości, natomiast set.entries() zwraca pary. Metoda wymaga odbiorcy z wewnętrznymi danymi Set; wywołanie jej na zwykłym obiekcie powoduje TypeError.

Iterator nie jest migawką: pomija elementy usunięte przed ich odwiedzeniem i może uwzględnić elementy dodane przed zakończeniem iteracji. Odczyt zużywa iterator; po wyczerpaniu kolejne wywołania next() mają done: true. Metoda sama nie zmienia zbioru.

W przykładzie powtórzone "red" nie tworzy kolejnego elementu zbioru. Pierwsze next() pobiera parę dla "red", a [...iterator] zbiera tylko pozostałą parę dla "blue".

Przykłady

const set = new Set(["red", "blue", "red"]);
const iterator = set.entries();

console.log(JSON.stringify(iterator.next().value));
console.log(JSON.stringify([...iterator]));
console.log(iterator.next().done);

Wynik

["red","red"]
[["blue","blue"]]
true

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

Źródła