A estrutura de dados Map nos possibilita armazenar seus elementos no formato chave-valor. Tanto a chave quanto o valor podem ser objetos ou tipos primitivos.

Map não aceita elementos repetidos e a ordem dos elementos é mantida na inserção. Seus elementos não podem ser acessados utilizando o indexador [] como em vetores e strings.

Para declararmos um objeto Map utilizamos seu construtor padrão que irá criar um Map sem elementos em seu conteúdo.

Sintaxe

let nome_variavel = new Map();

Exemplo 1

let mmap = new Map();
console.log(mmap);

Saída

map(0) {}

Uma outra forma de instanciar um Map é utilizando seu construtor que recebe um array como argumento. Esse argumento é convertido para um Map.

Sintaxe

let nome_variavel = new Map(array);

Exemplo 2

array = [[0,"fulano"],[1,"ciclano"],[2,"beltrano"]];
console.log(array);
let mmap = new Map(array);
console.log(mmap);

Saída

[ [ 0, 'fulano' ], [ 1, 'ciclano' ], [ 2, 'beltrano' ] ]
Map(3) { 0 => 'fulano', 1 => 'ciclano', 2 => 'beltrano' }

Como um objeto em JS é composto de chaves e valores, podemos instanciar um Map a partir de um objeto. Para isso, vamos precisar da classe Object que possui o método entries que converte um objeto para um array de chave/valor.

Sintaxe

Object.entries(object);

Exemplo 3

obj = {
  "nome": "fulano",
  "idade": 999
};

console.log(obj);
array = Object.entries(obj);
console.log(array);
let mmap = new Map(array);
console.log(mmap);

Saída

{ nome: 'fulano', idade: 999 }
[ [ 'nome', 'fulano' ], [ 'idade', 999 ] ]
Map(2) { 'nome' => 'fulano', 'idade' => 999 }

Para termos conhecimento do número de elementos contidos em um Map, utilizamos a sua propriedade/atributo size, como visto abaixo:

Sintaxe

nome_map.size;

Exemplo 4

array = [[0,"fulano"],[1,"ciclano"],[2,"beltrano"]];
let mmap = new Map(array);
console.log(mmap.size);

Saída

3

Para iteirarmos os elementos contidos em um Map, utilizamos o comando for-of para recuperarmos as chaves/valores do Map.

Exemplo 5

array = [[0,"fulano"],[1,"ciclano"],[2,"beltrano"]];
let mmap = new Map(array);

for( let [ch,vl] of mmap)
  console.log(ch,vl);

Saída

uma
string
qualquer

A classe Map em JavaScript possui vários métodos que nos auxiliam na manipulação desse tipo de dados como adição, remoção e outros. Clique em Visitar referente ao método desejado para navegar até a sua explicação.

1. 18/08/2025 - revisão 3 - Ajustes: pontuais, sintaxe e nome de métodos em tab. 1
2. 25/09/2024 - revisão 2 - ajustes gramaticais pontuais e outros
3. 06/10/2023 - revisão 1 - Correção navegação, layout e erros gramaticais
4. 31/05/2023 - versão inicial