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

variavel_map.clear()

Onde

-

Retorno

-

Exemplo 1

let array:any = [["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 um elemento em específico baseado em sua chave que é passada como argumento.

Sintaxe

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

let array:any = [["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.

Sintaxe

variavel_map.entries()

Onde

-

Retorno

Iterador contendo chave/valor. 

Exemplo 3

let array:any = [[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 que será executada para todo os elementos do Map.

Sintaxe

variavel_map.forEach(callbackFn)
variavel_map.forEach( callbackFn, thisArg)

Onde

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

Exemplo 4

let array:any = [["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

variavel_map.get( key )

Onde

key: chave do elemento

Retorno

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

Exemplo 5

let array:any = [["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 não contido em um Map.

Sintaxe

variavel_map.has( key )

Onde

key: chave do elemento verificado

Retorno

true se elemento existe, false caso contrário.

Exemplo 6

let array:any = [["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 de um Map.

Sintaxe

variavel_map.keys()

Onde

-

Retorno

Iterador para as chaves dos elementos de um Set. 

Exemplo 7

let array:any = [["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. Um par chave/valor é passado como argumento. Caso a chave exista, o elemento é atualizado, caso contrário, um novo elemento é adicionado.

Sintaxe

variavel_map.set(key, value)

Onde

key: chave do elemento
value: valor do elemento

Retorno

Retorna nome_variavel_map

Exemplo 8

let array:any = [["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 contidas em um Map.

Sintaxe

variavel_map.values()

Onde

-

Retorno

 Iterador para os elementos de um Map. 

Exemplo 9

let mmap = new Map<string,number>([
    ["chv1",1],
    ["chv2",2]
]);

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

Saída

1
2

1. 29/08/2025 - revisão 2 - Ajustes: pontuais e sintaxes
2. 14/09/2024 - revisão 1 - Ajustes gramaticais; css em tabela de métodos;
3. 29/02/2024 - versão inicial