CKTIS / JavaScript
Object.hasOwn: direct eigendom van een eigenschap testen
Object.hasOwn retourneert true als een sleutel een eigen eigenschap van het object is, ongeacht waarde of opsombaarheid.
Versie: ECMAScript 2022 onward; example target: Node.js 24.22.2
Syntax
Object.hasOwn(obj, prop)Object.hasOwn(obj, prop) voert eerst ToObject(obj) uit en zet prop om met ToPropertyKey; string- en Symbol-sleutels werken. De boolean zegt of de descriptor direct bij het object hoort. Geërfde eigenschappen worden genegeerd en een bestaande waarde undefined wordt niet verward met afwezigheid.
De test omvat data- en accessoreigenschappen, ook niet-opsombare. Bij een gewoon object leest hij de waarde niet en roept geen getter aan. Hij is veiliger dan obj.hasOwnProperty(prop) bij een null-prototype of overschreven hasOwnProperty. in en Reflect.has doorzoeken juist de prototypeketen.
De methode bestaat sinds ECMAScript 2022. null en undefined geven TypeError; andere primitieve waarden worden geboxed, zodat index 1 van "abc" eigen kan zijn. Sleutelconversie kan code uitvoeren en werpen. Bij een Proxy loopt de getOwnPropertyDescriptor-trap; een exceptie of invariantenschending kan TypeError geven.
Voorbeelden
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); }Resultaat
true false true false true TypeError
Het voorbeeld onderscheidt eigen, geërfde, Symbol-, ontbrekende en geboxte stringindex-eigenschappen.