O tipo de dado Map possui alguns métodos para nos auxiliar na manipulação de seus elementos. Nesta parte do tutorial, vamos estudar todos esses métodos.

O método clear é utilizado para excluir todos os elementos contidos em um Map. Esse método não recebe argumentos e não possui retorno.

Sintaxe

nome_variavel_map.clear()

Onde

-

Retorno

-

Exemplo 1

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

Saída

3
0

Com o método delete podemos excluir uma elemento em específico baseado em sua chave que é passada como argumento para o método.

Sintaxe

nome_variavel_map.delete(key)

Onde

key: chave do elemento para exclusão.

Retorno

Um booleano contendo true se elemento existe e foi removido, false caso contrário.

Exemplo 2

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

Saída

3
2

Utilizando o método entries podemos recuperar o iterador para os elementos contidos em um Map. Com esse iterador, podemos percorrer todos os elementos chave/valor de um Map.

Sintaxe

nome_variavel_map.entries()

Onde

-

Retorno

Iterador contendo chave/valor. 

Exemplo 3

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

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

Saída

0 fulano
1 ciclano
2 beltrano

O método forEach é utilizado para percorrermos todos os elementos de um Map. A diferença entre for-of e forEach é possibilidade de passarmos uma função/callback como argumento para o forEach.

Sintaxe

forEach(callbackFn)
forEach(callbackFn, thisArg)

Onde

callbackFn: função que será executada para cada elemento.
thisArg: argumento this passado para função

Exemplo 4

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

mmap.forEach((value,key) =>{
  console.log(key,value);
});

Saída

0 fulano
1 ciclano
2 beltrano

Com o método get podemos recuperar o valor de um elemento baseado em sua chave que é passada como argumento para o método.

Sintaxe

nome_variavel_map.get(key)

Onde

key: chave do elemento

Retorno

valor associado a keu ou undefined se chave não existir.

Exemplo 5

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

Saída

ciclano

Utilizando o método has podemos verificar se um elemento, cuja chave é passada como argumento, está contido ou existe em um Map. Esse método não recebe argumentos.

Sintaxe

nome_variavel_map.has(value)

Onde

key: chave do elemento verificado

Retorno

true se elemento existe, false caso contrário.

Exemplo 6

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

Saída

true

O método keys é utilizado para recuperar um iterador contendo todas as chaves dos elementos contidos em um Map. Esse método não recebe argumentos.

Sintaxe

nome_variavel_map.keys()

Onde

-

Retorno

Iterador para as chaves dos elementos de um Map. 

Exemplo 7

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

Saída

[Map Iterator] { '0', '1', '2' }

Com o método set podemos alterar ou adicionar um elemento a um Map passando um par chave/valor como argumento. Caso a chave exista, o elemento é atualizado, caso contrário, um novo elemento é adicionado.

Sintaxe

nome_variavel_map.set(key, value)

Onde

key: chave do elemento
value: valor do elemento

Retorno

Retorna nome_variavel_map

Exemplo 8

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

Saída

Map { '0' => 'fulano', '1' => 'ciclano' }
Map { '0' => 'fulano', '1' => 'ciclano', '2' => 'beltrano' }

Utilizando o método values podemos recuperar um iterador contendo apenas os valores associadas as chaves dos elementos contidos em um Map.

Sintaxe

nome_variavel_set.values()

Onde

-

Retorno

 Iterador para os elementos de um Map. 

Exemplo 9

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

for( let vl of mmap.values())
  console.log(vl);

Saída

"fulano" 
"ciclano" 

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