CKTIS / JavaScript
Set.prototype.values() — итератор на стойностите в множество
Методът values() връща нов итератор върху стойностите на Set в реда на добавянето им. Той не създава масив или копие на множеството; всяко прочитане придвижва итератора, а промените в множеството могат да повлияят на оставащото обхождане.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
set.values()Извикайте Set.prototype.values() без аргументи като set.values(). Методът връща нов итератор върху стойностите в реда на добавянето им, а не масив. Самото извикване не променя множеството. Повторното добавяне на вече съществуваща стойност не създава дубликат и не променя позицията ѝ.
Методът next() на итератора връща обект със свойствата value и done. След изчерпване на итератора стойностите им са съответно undefined и true; следващите извиквания не започват обхождането отначало. За ново обхождане е необходимо отново да извикате set.values(). Итераторът поддържа for...of и [...iterator], които консумират оставащите му елементи.
Итераторът не е моментна снимка: пропуска стойностите, изтрити преди да бъдат достигнати, и може да обходи стойности, добавени преди края на обхождането. Изтриването и повторното добавяне на стойност я поставя в края; така тя може да бъде обходена отново, ако предишното ѝ появяване вече е било прочетено. Избягвайте неконтролирано добавяне по време на итерация.
По подразбиране Set.prototype.keys и Set.prototype[Symbol.iterator] сочат към същата функция като Set.prototype.values. За разлика от тях entries() връща двойки [value, value]. values() изисква получател с вътрешни данни на Set; извикването му върху обикновен обект или масив предизвиква TypeError.
Примери
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()]));Резултат
{"value":"a","done":false}
["b"]
{"done":true}
["a","b"]Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.