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

CKTIS / JavaScript

Map.prototype.values: iterador de valores

El método values devuelve un iterador vivo de valores de Map en el orden de inserción de sus claves.

Versión: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaxis

map.values()

map.values() crea un iterador de Map nuevo. Cada next() correcto devuelve el valor de la entrada siguiente. Los objetos son las mismas referencias y valores iguales bajo claves distintas se devuelven por separado; no hay deduplicación.

El iterador es perezoso, no una instantánea. Omite entradas eliminadas antes de visitarlas, una actualización previa produce el valor nuevo y una adición antes del final puede verse. Actualizar una clave ya visitada no la repite. Tras done: true, adiciones posteriores no lo reanudan.

El método no admite argumentos significativos y exige datos internos de Map; objeto, Set o Proxy no gestionado lanza TypeError. Es estándar desde ECMAScript 2015. Para conservar la relación con claves, use entries().

Ejemplos

const shared = {};
const map = new Map([["a", shared], ["b", 2], ["c", 2]]);
const values = map.values();
console.log(values.next().value === shared);
map.set("b", 20);
map.delete("c");
map.set("d", 4);
console.log(values.next().value);
console.log(values.next().value);
console.log(values.next().done);
map.set("e", 5);
console.log(values.next().done);
console.log([...new Map([["x", 1], ["y", 1]]).values()].join(","));
try { Map.prototype.values.call({}); } catch (error) { console.log(error instanceof TypeError); }

Resultado

true
20
4
true
true
1,1
true

Fuentes