Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Map.prototype.has : tester une clé

has renvoie un booléen indiquant si une Map contient une entrée pour la clé fournie.

Version : ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntaxe

map.has(key)

map.has(key) ne convertit pas la clé et ne modifie pas la Map. Elle renvoie true même si la valeur stockée est undefined, sinon false.

SameValueZero compare les clés : NaN correspond à NaN, -0 à +0, et les objets seulement par référence identique. has distingue donc l’absence d’un get valant undefined.

Un receveur incompatible lève TypeError. Standard depuis ECMAScript 2015 ; le test ne lit ni ne copie la valeur.

Exemples

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); }

Résultat

true false
true true
undefined true
true

Sources