Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Set.prototype.keys() — un iterador de valores de un conjunto

Set.prototype.keys() devuelve un nuevo iterador sobre los valores de un conjunto en orden de inserción. No devuelve índices ni un array: en un Set, las claves y los valores se refieren a los mismos elementos.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

set.keys()

set.keys() no requiere argumentos y devuelve un nuevo iterador sobre los valores del conjunto en orden de inserción. Un Set no tiene claves ni índices independientes. En la biblioteca estándar sin modificar, Set.prototype.keys y Set.prototype.values hacen referencia a la misma función; el nombre keys mantiene la coherencia con la interfaz Map.

El iterador no es un array. Al llamar a next() se avanza un elemento, mientras que [...iterator] reúne sus elementos restantes en un array. Cuando se agota, next() devuelve un resultado con done: true. Volver a llamar a set.keys() crea un iterador independiente.

El iterador no es una instantánea: se omite un elemento eliminado antes de visitarlo, y puede visitarse un elemento añadido antes de que termine la iteración. Llamar al método con un valor this que no tenga los datos internos de Set lanza un TypeError.

En el ejemplo, la repetición de "red" no crea un segundo elemento. La primera llamada a next() obtiene "red", por lo que al expandir el iterador solo queda "blue".

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes