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

CKTIS / JavaScript

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

Set.prototype.keys() devolve um novo iterador sobre os valores de um conjunto por ordem de inserção. Não devolve índices nem um array: num Set, as chaves e os valores referem-se aos mesmos elementos.

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

set.keys() não requer argumentos e devolve um novo iterador sobre os valores do conjunto por ordem de inserção. Um Set não tem chaves nem índices separados. Na biblioteca padrão não modificada, Set.prototype.keys e Set.prototype.values referem-se à mesma função; o nome keys mantém a consistência com a interface Map.

O iterador não é um array. Uma chamada a next() avança um elemento, enquanto [...iterator] reúne os elementos restantes num array. Quando se esgota, next() devolve um resultado com done: true. Voltar a chamar set.keys() cria um iterador independente.

O iterador não é uma captura instantânea: um elemento eliminado antes de ser visitado é ignorado, e um elemento adicionado antes de a iteração terminar pode ser visitado. Chamar o método com um valor this sem os dados internos de Set lança um TypeError.

No exemplo, a repetição de "red" não cria um segundo elemento. A primeira chamada a next() obtém "red", pelo que, ao expandir o iterador, só resta "blue".

Exemplos

const colors = new Set(["red", "blue", "red"]);
const iterator = colors.keys();

console.log(Set.prototype.keys === Set.prototype.values);
console.log(iterator.next().value);
console.log([...iterator].join(","));
console.log(iterator.next().done);

Resultado

true
red
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