CKTIS / JavaScript
Set.prototype.entries() — um iterador de pares de valores
Set.prototype.entries() devolve um iterador de pares [value, value] por ordem de inserção. A primeira posição não é um índice: Set não armazena chaves separadas. O iterador pode ser percorrido com next(), for...of ou a sintaxe spread.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
set.entries()Set.prototype.entries() não recebe argumentos e devolve um novo iterador. Cada elemento produzido é um novo array de dois elementos [value, value]. Ambas as posições contêm o mesmo valor; se for um objeto, referem-se ao mesmo objeto e não a cópias. Este formato corresponde aos pares devolvidos por Map.prototype.entries(), mas um Set não tem chaves nem índices separados.
Os elementos são visitados por ordem de inserção. set.values() e a iteração predefinida sobre set produzem valores individuais, enquanto set.entries() produz pares. O método requer um recetor com dados internos de Set; se for chamado num objeto normal, é lançado um TypeError.
O iterador não é uma captura instantânea: ignora elementos eliminados antes de serem visitados e pode incluir elementos adicionados antes de a iteração terminar. A leitura consome o iterador; depois de esgotado, as chamadas seguintes a next() têm done: true. O método não altera o set por si só.
No exemplo, repetir "red" não cria outro elemento do set. A primeira chamada a next() obtém o par de "red", e [...iterator] reúne apenas o par restante de "blue".
Exemplos
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);Resultado
["red","red"] [["blue","blue"]] true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.