База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Set.prototype.keys() — итератор на стойностите в множество

Set.prototype.keys() връща нов итератор върху стойностите на множеството в реда на добавяне. Не връща индекси или масив: в 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.keys()

set.keys() не изисква аргументи и връща нов итератор върху стойностите на множеството в реда на добавяне. Set няма отделни ключове или индекси. В непроменената стандартна библиотека Set.prototype.keys и Set.prototype.values сочат към една и съща функция; името keys осигурява съгласуваност с интерфейса Map.

Итераторът не е масив. Извикването на next() го придвижва с един елемент, а [...iterator] събира оставащите му елементи в масив. Когато итераторът се изчерпи, next() връща резултат с done: true. Повторното извикване на set.keys() създава независим итератор.

Итераторът не е моментна снимка: елемент, изтрит преди да бъде посетен, се пропуска, а елемент, добавен преди края на итерацията, може да бъде посетен. Извикването на метода със стойност this, на която липсват вътрешните данни на Set, хвърля TypeError.

В примера повторението на "red" не създава втори елемент. Първото извикване на next() получава "red", така че при разгръщането на итератора остава само "blue".

Примери

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);

Резултат

true
red
blue
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници