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

CKTIS / JavaScript

Set.prototype.entries() — итератор на двойки от стойности

Set.prototype.entries() връща итератор на двойки [value, value] в реда на добавяне. Първата позиция не е индекс: Set не съхранява отделни ключове. Итераторът може да се обходи с next(), for...of или синтаксиса spread.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

set.entries()

Set.prototype.entries() не приема аргументи и връща нов итератор. Всеки върнат елемент е нов масив с два елемента [value, value]. Двете позиции съдържат една и съща стойност; при обект те препращат към същия обект, а не към копия. Този формат съответства на двойките, връщани от Map.prototype.entries(), но Set няма отделни ключове или индекси.

Елементите се обхождат в реда на добавяне. set.values() и итерацията по подразбиране върху set връщат отделни стойности, докато set.entries() връща двойки. Методът изисква получател с вътрешни данни на Set; извикването му върху обикновен обект предизвиква TypeError.

Итераторът не е моментна снимка: той пропуска елементи, изтрити преди обхождането им, и може да включи елементи, добавени преди края на итерацията. Четенето изчерпва итератора; след изчерпването последващите извиквания на next() имат done: true. Самият метод не променя множеството.

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

Примери

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

Резултат

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

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

Източници