CKTIS / JavaScript
Set.prototype.entries() — iterator parov vrednosti
Set.prototype.entries() vrne iterator parov [value, value] v vrstnem redu dodajanja. Prvi položaj ni indeks: Set ne shranjuje ločenih ključev. Iterator lahko berete z next(), for...of ali sintakso spread.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
set.entries()Set.prototype.entries() ne sprejema argumentov in vrne nov iterator. Vsak vrnjeni element je novo polje z dvema elementoma [value, value]. Oba položaja vsebujeta isto vrednost; pri objektu se sklicujeta na isti objekt in ne na kopiji. Ta oblika ustreza parom, ki jih vrne Map.prototype.entries(), vendar Set nima ločenih ključev ali indeksov.
Elementi se obravnavajo v vrstnem redu dodajanja. set.values() in privzeto iteriranje po set vračata posamezne vrednosti, medtem ko set.entries() vrača pare. Metoda zahteva sprejemnik z notranjimi podatki Set; klic na običajnem objektu povzroči TypeError.
Iterator ni posnetek stanja: preskoči elemente, odstranjene pred obiskom, in lahko vključi elemente, dodane pred koncem iteriranja. Branje porablja iterator; po izčrpanju imajo nadaljnji klici next() vrednost done: true. Metoda sama množice ne spremeni.
V primeru ponovljeni "red" ne ustvari dodatnega elementa množice. Prvi klic next() pridobi par za "red", [...iterator] pa zbere samo preostali par za "blue".
Primeri
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);Rezultat
["red","red"] [["blue","blue"]] true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.