CKTIS / JavaScript
Set.prototype.has — prüfen, ob ein Wert enthalten ist
Set.prototype.has prüft, ob eine Menge einen bestimmten Wert enthält, und gibt true oder false zurück. Die Menge wird nicht verändert; Werte werden nach SameValueZero und Objekte nach ihrer Identität verglichen.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
set.has(value)Set.prototype.has wird als set.has(value) aufgerufen, wobei set eine Set-Menge und value der gesuchte Wert ist. Die Methode gibt true zurück, wenn der Wert in der Menge enthalten ist, andernfalls false. Sie fügt keine Elemente hinzu und entfernt auch keine.
Der Vergleich folgt der Regel SameValueZero: Es findet keine Typumwandlung statt, daher sind 1 und "1" verschieden. NaN stimmt mit NaN überein, und +0 und -0 gelten als gleich. Objekte werden anhand ihrer Identität und nicht anhand ihres Inhalts verglichen: Ein neues Objekt mit denselben Eigenschaften stimmt nicht mit dem gespeicherten Objekt überein.
Wird das Argument weggelassen, wird nach undefined gesucht; es wird nicht geprüft, ob die Menge leer ist. Die Methode benötigt als Empfänger ein Objekt mit den internen Daten einer Set-Menge. Wird sie mit einem gewöhnlichen Objekt oder einem Array als this aufgerufen, wird ein TypeError ausgelöst.
Im Beispiel ist item dieselbe Referenz, die in der Menge gespeichert wurde. { id: 1 } erstellt dagegen ein anderes Objekt. Die letzten beiden Ergebnisse sind daher true beziehungsweise false.
Beispiele
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 }));Ergebnis
true false true true true false
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.