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.