WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Object.hasOwn: direkten Eigenschaftsbesitz prüfen

Object.hasOwn liefert true, wenn ein Schlüssel eine eigene Eigenschaft des Objekts ist, unabhängig von Wert und Aufzählbarkeit.

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

Syntax

Object.hasOwn(obj, prop)

Object.hasOwn(obj, prop) führt zuerst ToObject(obj) aus und wandelt prop mit ToPropertyKey um; String- und Symbolschlüssel funktionieren. Der Boolean sagt, ob der Deskriptor direkt zum Objekt gehört. Geerbte Eigenschaften werden ignoriert, und ein vorhandener Wert undefined wird nicht mit einer fehlenden Eigenschaft verwechselt.

Der Test umfasst Daten- und Accessoreigenschaften, auch nicht aufzählbare. Bei gewöhnlichen Objekten liest er keinen Wert und ruft keinen Getter auf. Er ist sicherer als obj.hasOwnProperty(prop), wenn das Objekt Null-Prototyp hat oder hasOwnProperty überschreibt. in und Reflect.has durchsuchen dagegen die Prototypkette.

Die Methode existiert seit ECMAScript 2022. null und undefined werfen TypeError; andere Primitive werden verpackt, sodass etwa Stringindex 1 in "abc" eigen sein kann. Schlüsselkonvertierung kann Code ausführen und werfen. Bei Proxy läuft die getOwnPropertyDescriptor-Falle; Ausnahme oder Invariantenverletzung kann TypeError erzeugen.

Beispiele

const token = Symbol("token");
const proto = { inherited: 1 };
const record = Object.create(proto);
Object.defineProperty(record, "hidden", { value: 2 });
record[token] = undefined;

console.log(Object.hasOwn(record, "hidden"), Object.hasOwn(record, "inherited"));
console.log(Object.hasOwn(record, token), Object.hasOwn(record, "missing"));
console.log(Object.hasOwn("abc", 1));
try { Object.hasOwn(null, "x"); } catch (error) { console.log(error.name); }

Ergebnis

true false
true false
true
TypeError

Das Beispiel unterscheidet eigene, geerbte, Symbol-, fehlende und verpackte Stringindex-Eigenschaften.

Quellen