Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes