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

CKTIS / JavaScript

Set.prototype.has — vérifier la présence d’une valeur

Set.prototype.has vérifie si un ensemble contient une valeur donnée et renvoie true ou false. La méthode ne modifie pas l’ensemble ; les valeurs sont comparées selon SameValueZero et les objets selon leur identité.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

set.has(value)

Appelez Set.prototype.has sous la forme set.has(value), où set est un ensemble Set et value la valeur recherchée. La méthode renvoie true si la valeur appartient à l’ensemble, et false dans le cas contraire. Elle n’ajoute ni ne supprime d’éléments.

La comparaison suit la règle SameValueZero : aucune conversion de type n’a lieu, donc 1 et "1" sont différents. NaN correspond à NaN, et +0 et -0 sont considérés comme égaux. Les objets sont comparés selon leur identité, et non leur contenu : un nouvel objet ayant des propriétés identiques ne correspond pas à l’objet stocké.

Si l’argument est omis, la recherche porte sur undefined ; cela ne vérifie pas si l’ensemble est vide. La méthode exige comme récepteur un objet disposant des données internes d’un ensemble Set. L’appeler avec un objet ordinaire ou un tableau comme this déclenche une TypeError.

Dans l’exemple, item est la même référence que celle stockée dans l’ensemble, tandis que { id: 1 } crée un objet différent. Les deux derniers résultats sont donc respectivement true et false.

Exemples

const item = { id: 1 };
const values = new Set([1, NaN, -0, item]);

console.log(values.has(1));
console.log(values.has("1"));
console.log(values.has(NaN));
console.log(values.has(+0));
console.log(values.has(item));
console.log(values.has({ id: 1 }));

Résultat

true
false
true
true
true
false

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources