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

CKTIS / JavaScript

Set.prototype.values() — iterador dos valores de um conjunto

O método values() devolve um novo iterador sobre os valores de um Set pela ordem de inserção. Não cria um array nem uma cópia do conjunto; cada leitura avança o iterador e as alterações ao conjunto podem afetar o percurso restante.

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.values()

Chame Set.prototype.values() como set.values(), sem argumentos. Devolve um novo iterador sobre os valores pela ordem de inserção, não um array. A chamada, por si só, não altera o conjunto. Voltar a adicionar um valor existente não cria um duplicado nem altera a sua posição.

O método next() do iterador devolve um objeto com as propriedades value e done. Quando o iterador se esgota, estas são, respetivamente, undefined e true; as chamadas seguintes não reiniciam o percurso. Para fazer um novo percurso, é necessário voltar a chamar set.values(). O iterador suporta for...of e [...iterator], que consome os elementos restantes.

O iterador não é uma captura instantânea: ignora os valores eliminados antes de serem visitados e pode visitar os valores adicionados antes de o percurso terminar. Eliminar um valor e adicioná-lo novamente coloca-o no fim; por isso, pode ser visitado outra vez se a ocorrência anterior já tiver sido lida. Evite adições descontroladas durante a iteração.

Por predefinição, Set.prototype.keys e Set.prototype[Symbol.iterator] referenciam a mesma função que Set.prototype.values. Em contrapartida, entries() devolve pares [value, value]. values() requer um recetor com dados internos de Set; chamá-lo num objeto comum ou num array provoca um TypeError.

Exemplos

const set = new Set(["a", "b", "a"]);
const iterator = set.values();

console.log(JSON.stringify(iterator.next()));
console.log(JSON.stringify([...iterator]));
console.log(JSON.stringify(iterator.next()));
console.log(JSON.stringify([...set.values()]));

Resultado

{"value":"a","done":false}
["b"]
{"done":true}
["a","b"]

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