WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

in-Operator – Eigenschaften prüfen

Der `in`-Operator prüft anhand des Schlüssels, ob eine Eigenschaft vorhanden ist, nicht welchen Wert sie hat. Bei einem gewöhnlichen Objekt mit ausschließlich gewöhnlichen Objekten in der Prototypenkette berücksichtigt er eigene und geerbte Eigenschaften. Die `has`-Falle eines `Proxy` kann das Ergebnis ändern. Der rechte Operand muss ein Objekt sein; ein primitiver Wert führt zu einem `TypeError`.

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

propertyKey in object
#privateName in object

Sind das Objekt und alle Objekte in seiner Prototypenkette gewöhnliche Objekte, gibt propertyKey in object für eine eigene oder geerbte Eigenschaft true zurück, andernfalls false. Der linke Operand wird in einen Eigenschaftsschlüssel umgewandelt: einen String oder ein Symbol. Der rechte Operand muss ein Objekt sein; auch null, undefined und primitive Strings führen zu einem TypeError.

Die has-Falle eines Proxy kann die Prüfung des Eigenschaftsschlüssels abfangen, auch bei der Suche entlang der Prototypenkette. Sie kann beispielsweise einen Schlüssel als vorhanden melden, obwohl er weder im Zielobjekt noch in dessen Prototypen vorhanden ist, oder eine vorhandene konfigurierbare eigene Eigenschaft eines erweiterbaren Zielobjekts verbergen.

Das Vorhandensein bedeutet nicht, dass der Wert ungleich undefined ist: Eine Eigenschaft mit diesem Wert ist dennoch vorhanden. Um nur eigene Eigenschaften zu prüfen, verwende Object.hasOwn(object, propertyKey). Der in-Operator berücksichtigt auch nicht aufzählbare Eigenschaften; er ist keine for...in-Schleife.

Bei Arrays prüft in Indexschlüssel, nicht, ob ein Wert vorkommt. Eine durch delete entstandene Lücke ist kein eigenes Element, selbst wenn ihr Index kleiner als length ist. Wenn kein Proxy die Prüfung abfängt und die Suche den Schlüssel auch in der Prototypenkette nicht findet, lautet das Ergebnis false.

Die separate Syntax #privateName in object prüft, ob ein bestimmtes privates Element vorhanden ist, nicht eine Eigenschaft mit einem String-Schlüssel. Der private Name muss in einem umgebenden Klassengültigkeitsbereich deklariert sein; der rechte Operand muss weiterhin ein Objekt sein.

Beispiele

const parent = { inherited: 42 };
const item = Object.create(parent);
item.own = undefined;

console.log("own" in item);
console.log("inherited" in item);
console.log("missing" in item);
console.log(Object.hasOwn(item, "inherited"));

const values = [undefined];
console.log(0 in values);
delete values[0];
console.log(0 in values);

Ergebnis

true
true
false
false
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.

Quellen