El objeto Map en JavaScript es una colección de pares clave-valor que permite guardar y manipular datos de manera eficiente y ordenada. A diferencia de los objetos y arrays convencionales, Map permite utilizar cualquier valor (ya sea un objeto, una función o un valor primitivo) como clave y no solamente strings o números, lo que amplía sus posibilidades de uso. Además, Map mantiene el orden de inserción de los elementos, facilitando la iteración de los elementos según su orden de inserción.

Creación de un objeto Map

Para crear un objeto Map se utiliza la palabra clave new junto con la clase Map:

const miMapa = new Map();

También es posible crear un Map e inicializarlo con pares clave-valor utilizando un array anidado como argumento:

const miMapa = new Map([
  ["clave1", "valor1"],
  ["clave2", "valor2"],
  ["clave3", "valor3"]
]);

Métodos y propiedades de un objeto Map

Map cuenta con varios métodos y propiedades útiles para trabajar con sus elementos.

• size: Propiedad que devuelve la cantidad de pares clave valor almacenados en el Map.

console.log(miMapa.size); // 3

• set(key, value): Método que añade un nuevo par clave-valor al Map. Si ya existe un elemento con la misma clave, su valor se actualizará con el nuevo valor proporcionado.

miMapa.set("clave4", "valor4");
console.log(miMapa.size); // 4

• get(key): Método que devuelve el valor asociado a la clave proporcionada. Si la clave no existe en el Map, devuelve undefined.

console.log(miMapa.get("clave2")); // "valor2"
console.log(miMapa.get("clave_inexistente")); // undefined

• has(key): Método que devuelve true si el Map contiene un elemento con la clave dada y false en caso contrario.

console.log(miMapa.has("clave3")); // true

• delete(key): Método que elimina el par clave-valor del Map según la clave proporcionada. Retorna true si se ha eliminado con éxito, y false si la clave no se encuentra en el Map.

miMapa.delete("clave1");
console.log(miMapa.has("clave1")); // false

• clear(): Método que elimina todos los pares clave-valor del Map.

miMapa.clear();
console.log(miMapa.size); // 0

Iteración de un objeto Map

Map ofrece varios métodos para iterar sus elementos de forma sencilla y eficiente.

• keys(): Método que devuelve un objeto iterable con las claves del Map en el orden de inserción.

for (const clave of miMapa.keys()) {
  console.log(clave);
}

// Salida:
// clave2
// clave3
// clave4

• values(): Método que devuelve un objeto iterable con los valores del Map en el orden de inserción.

for (const valor of miMapa.values()) {
  console.log(valor);
}

// Salida:
// valor2
// valor3
// valor4

• entries(): Método que devuelve un objeto iterable con arrays de pares [clave, valor] en el orden de inserción.

for (const entrada of miMapa.entries()) {
  console.log(entrada);
}

// Salida:
// ["clave2", "valor2"]
// ["clave3", "valor3"]
// ["clave4", "valor4"]

• forEach(callback[, thisArg]): Método que ejecuta una función callback para cada par clave-valor del Map, en el orden de inserción. Opcionalmente, se puede proporcionar el objeto thisArg para utilizarlo como this dentro del callback.

miMapa.forEach((valor, clave, mapa) => {
  console.log(`Clave: ${clave}, Valor: ${valor}`);
});

También es posible utilizar el operador for...of directamente en un objeto Map, lo cual es equivalente a utilizar el método entries():

for (const [clave, valor] of miMapa) {
  console.log(`Clave: ${clave}, Valor: ${valor}`);
}

En resumen, el objeto Map en JavaScript es una estructura de datos versátil y eficiente que permite almacenar y manipular pares clave-valor de manera ordenada, con múltiples métodos para iterar, agregar, actualizar y eliminar elementos de la colección de forma sencilla y clara.