CKTIS / JavaScript
Set.prototype.values() — iterator wartości zbioru
Metoda values() zwraca nowy iterator wartości zbioru Set w kolejności ich dodania. Nie tworzy tablicy ani kopii zbioru; kolejne odczyty zużywają iterator, a zmiany zbioru mogą wpływać na dalsze przechodzenie.
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.values()Set.prototype.values() wywołuje się jako set.values(), bez argumentów. Zwraca nowy iterator wartości w kolejności ich dodania, a nie tablicę. Samo wywołanie nie zmienia zbioru. Powtórne dodanie istniejącej wartości nie tworzy duplikatu ani nie zmienia jej pozycji.
Metoda iteratora next() zwraca obiekt z właściwościami value i done. Po wyczerpaniu iteratora są to odpowiednio undefined i true; kolejne wywołania nie rozpoczynają przechodzenia od nowa. Nowy przebieg wymaga nowego wywołania set.values(). Iterator obsługuje for...of oraz składnię [...iterator], która zużywa jego pozostałe elementy.
Iterator nie jest migawką: pomija wartości usunięte przed ich odwiedzeniem i może odwiedzić wartości dodane przed zakończeniem przechodzenia. Usunięcie i ponowne dodanie wartości umieszcza ją na końcu; może więc zostać odwiedzona ponownie, jeśli wcześniejsze wystąpienie już odczytano. Unikaj niekontrolowanego dodawania elementów podczas iteracji.
Standardowo Set.prototype.keys i Set.prototype[Symbol.iterator] wskazują tę samą funkcję co Set.prototype.values. Natomiast entries() zwraca pary [value, value]. values() wymaga odbiorcy z wewnętrznymi danymi Set; wywołanie na zwykłym obiekcie lub tablicy powoduje TypeError.
Przykłady
const set = new Set(["a", "b", "a"]);
const iterator = set.values();
console.log(JSON.stringify(iterator.next()));
console.log(JSON.stringify([...iterator]));
console.log(JSON.stringify(iterator.next()));
console.log(JSON.stringify([...set.values()]));Wynik
{"value":"a","done":false}
["b"]
{"done":true}
["a","b"]Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.