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

CKTIS / JavaScript

Map.prototype.entries: iterador de pares clave–valor

El método entries devuelve un iterador vivo de pares [key, value] en orden de inserción y es la iteración predeterminada de Map.

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

Sintaxis

map.entries()

map.entries() crea un objeto iterador de Map nuevo. Cada next() correcto devuelve un array nuevo de dos elementos [key, value]; modificar ese array no cambia la entrada de Map, aunque los objetos contenidos siguen siendo las mismas referencias. map[Symbol.iterator] es la misma función que map.entries, por lo que for...of y spread reciben pares de forma predeterminada.

El iterador es perezoso, no una instantánea. Conserva el orden de inserción, omite entradas eliminadas antes de visitarlas y puede ver entradas añadidas antes de llegar al final; actualizar una clave aún no visitada produce el valor nuevo. Cuando next() ya devolvió done: true, las adiciones posteriores no reanudan ese iterador.

El método no acepta argumentos significativos y exige un receptor con datos internos de Map; usarlo con un objeto, Set o Proxy no gestionado lanza TypeError. Es estándar desde ECMAScript 2015. Si solo se necesitan claves o valores, keys() o values() evitan crear arrays de pares.

Ejemplos

const map = new Map([["a", 1], ["b", 2]]);
const entries = map.entries();
const first = entries.next().value;
console.log(JSON.stringify(first));
first[1] = 99;
console.log(map.get("a"));

map.delete("b");
map.set("c", 3);
const second = entries.next();
console.log(JSON.stringify(second.value), second.done);
console.log(entries.next().done);

map.set("d", 4);
console.log(entries.next().done);
console.log(map[Symbol.iterator] === map.entries);

Resultado

["a",1]
1
["c",3] false
true
true
true

Fuentes