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

CKTIS / JavaScript

Set.prototype.entries() — un iterador de pares de valores

Set.prototype.entries() devuelve un iterador de pares [value, value] en orden de inserción. La primera posición no es un índice: Set no almacena claves independientes. El iterador se puede recorrer con next(), for...of o la sintaxis de propagación.

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

Set.prototype.entries() no acepta argumentos y devuelve un iterador nuevo. Cada elemento producido es un array nuevo de dos elementos [value, value]. Ambas posiciones contienen el mismo valor; si es un objeto, hacen referencia al mismo objeto y no a copias. Este formato coincide con los pares que devuelve Map.prototype.entries(), pero un Set no tiene claves ni índices independientes.

Los elementos se recorren en orden de inserción. set.values() y la iteración predeterminada de set producen valores individuales, mientras que set.entries() produce pares. El método requiere un receptor con datos internos de Set; llamarlo sobre un objeto normal provoca un TypeError.

El iterador no es una instantánea: omite los elementos eliminados antes de que se recorran y puede incluir elementos añadidos antes de que termine la iteración. Leerlo lo consume; una vez agotado, las llamadas posteriores a next() tienen done: true. El método no modifica el set por sí mismo.

En el ejemplo, repetir "red" no crea otro elemento del set. La primera llamada a next() obtiene el par de "red", y [...iterator] recoge únicamente el par restante de "blue".

Ejemplos

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

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