KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen