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.