Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Map.prototype.has: verificar uma chave

has devolve um booleano que indica se um Map contém uma entrada para a chave fornecida.

Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaxe

map.has(key)

map.has(key) não converte a chave nem altera o Map. Devolve true mesmo se o valor guardado for undefined, caso contrário false.

SameValueZero compara chaves: NaN corresponde a NaN, -0 a +0 e objetos só por referência idêntica. Assim has distingue ausência de get que devolve undefined.

Um recetor incompatível lança TypeError. Padrão desde ECMAScript 2015; o teste não lê nem copia o valor.

Exemplos

const key = {};
const map = new Map([[key, undefined], [NaN, "nan"], [-0, "zero"]]);
console.log(map.has(key), map.has({}));
console.log(map.has(NaN), map.has(+0));
console.log(map.get(key), map.has(key));
try { Map.prototype.has.call({}, "x"); } catch (error) { console.log(error instanceof TypeError); }

Resultado

true false
true true
undefined true
true

Fontes