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

CKTIS / JavaScript

Map.prototype.keys: iterador de claves

El método keys devuelve un iterador vivo de claves de Map en orden de inserción sin copiar sus valores asociados.

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

Sintaxis

map.keys()

map.keys() crea un iterador de Map nuevo. Cada next() correcto devuelve la siguiente clave en orden de inserción; las claves objeto son las mismas referencias. El iterador no modifica el Map y llamadas distintas a keys() conservan posiciones independientes.

El iterador es perezoso, no una instantánea. Omite una entrada eliminada antes de visitarla y puede ver una añadida antes del final. Actualizar el valor de una clave no crea otra posición. Después de devolver done: true, adiciones posteriores no lo reanudan. Una clave -0 se guarda y devuelve como +0.

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 obtener también valores, use entries() o la iteración predeterminada.

Ejemplos

const objectKey = {};
const map = new Map([[objectKey, 1], ["b", 2]]);
const keys = map.keys();
console.log(keys.next().value === objectKey);
map.delete("b");
map.set("c", 3);
const second = keys.next();
console.log(second.value, second.done);
console.log(keys.next().done);
map.set("d", 4);
console.log(keys.next().done);
const zeroKey = new Map([[-0, "zero"]]).keys().next().value;
console.log(Object.is(zeroKey, 0));
try { Map.prototype.keys.call({}); } catch (error) { console.log(error instanceof TypeError); }

Resultado

true
c false
true
true
true
true

Fuentes