CKTIS / JavaScript
Set.prototype.values() — iterador de valores de un conjunto
El método values() devuelve un iterador nuevo sobre los valores de un Set en orden de inserción. No crea un array ni una copia del conjunto; cada lectura avanza el iterador, y los cambios en el conjunto pueden afectar al recorrido restante.
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.values()Llama a Set.prototype.values() como set.values(), sin argumentos. Devuelve un iterador nuevo sobre los valores en orden de inserción, no un array. La llamada en sí no cambia el conjunto. Volver a añadir un valor existente no crea un duplicado ni cambia su posición.
El método next() del iterador devuelve un objeto con las propiedades value y done. Cuando se agota el iterador, estas son undefined y true, respectivamente; las llamadas posteriores no reinician el recorrido. Para iniciar otro recorrido, hay que volver a llamar a set.values(). El iterador admite for...of y [...iterator], que consume los elementos que quedan.
El iterador no es una instantánea: omite los valores eliminados antes de que se visiten y puede visitar los que se añadan antes de que termine el recorrido. Eliminar un valor y volver a añadirlo lo coloca al final; por eso puede visitarse otra vez si su aparición anterior ya se había leído. Evita añadir elementos sin control durante la iteración.
De forma predeterminada, Set.prototype.keys y Set.prototype[Symbol.iterator] hacen referencia a la misma función que Set.prototype.values. En cambio, entries() devuelve pares [value, value]. values() requiere un receptor con datos internos de Set; llamarlo sobre un objeto ordinario o un array provoca un TypeError.
Ejemplos
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"]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.