CKTIS / JavaScript
Map: una colección de pares clave-valor
Map almacena claves únicas de cualquier tipo junto con sus valores asociados. Permite leer y eliminar entradas, comprobar si existe una clave e iterar en el orden de inserció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
new Map()
new Map(iterable)
map.set(key, value)
map.get(key)
map.has(key)
map.delete(key)
map.clear()
map.size
for (const [key, value] of map) { /* ... */ }Map es una colección integrada de pares clave-valor. Tanto las claves como los valores pueden ser cualquier valor de JavaScript. Crea un mapa vacío con new Map() o pasa al constructor un objeto iterable que contenga pares [key, value]. Llamarlo sin new produce un TypeError.
set(key, value) añade o actualiza una entrada y devuelve el mapa. get(key) lee su valor; si la clave no existe, devuelve undefined. Como un valor almacenado también puede ser undefined, comprueba si existe con has(key). La propiedad size indica el número de entradas, delete(key) devuelve si se eliminó una entrada y clear() las elimina todas.
La comparación de claves sigue SameValueZero: NaN coincide con NaN, y +0 y -0 son la misma clave. Los objetos se comparan por identidad, no por su contenido. Por eso, dos objetos { id: 1 } creados por separado son claves distintas.
La iteración con for...of produce pares en el orden de inserción de las claves; keys(), values() y entries() devuelven los iteradores correspondientes. Actualizar un valor no cambia la posición de su entrada, pero eliminarla y volver a insertarla la mueve al final. Para añadir entradas, usa set(key, value), no map[key] = value. La asignación con corchetes se aplica a una propiedad del objeto, no a una entrada del mapa. Por ejemplo, en una instancia de Map sin modificar, map["size"] = value lanza un TypeError en modo estricto y se ignora fuera de él, porque la propiedad heredada size tiene un método de acceso de lectura, pero no uno de escritura.
Ejemplos
const key = { id: 1 };
const map = new Map([["first", 1], [key, 2]]);
map.set("first", 3);
map.set(NaN, 4);
map.set(NaN, 5);
console.log(map.size);
console.log(map.get(key));
console.log(map.has({ id: 1 }));
console.log(map.get(NaN));
console.log(JSON.stringify([...map.values()]));Resultado
3 2 false 5 [3,2,5]
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.