Object.hasOwn()

obj

Die JavaScript-Objektinstanz, die getestet werden soll.

prop

Der String-Name oder das Symbol der zu testenden Eigenschaft.

true, wenn das angegebene Objekt die angegebene Eigenschaft direkt definiert hat. Andernfalls false.

Die Methode Object.hasOwn() gibt true zurück, wenn die angegebene Eigenschaft eine direkte Eigenschaft des Objekts ist — auch wenn der Eigenschaftswert null oder undefined ist. Die Methode gibt false zurück, wenn die Eigenschaft geerbt wird oder überhaupt nicht deklariert wurde. Im Gegensatz zum in-Operator überprüft diese Methode nicht die angegebene Eigenschaft in der Prototypen-Kette des Objekts.

Es wird empfohlen, diese Methode über Object.prototype.hasOwnProperty() zu verwenden, da sie für null-Prototyp-Objekte und mit Objekten funktioniert, die die geerbte hasOwnProperty()-Methode überschrieben haben. Während es möglich ist, diese Probleme zu umgehen, indem man Object.prototype.hasOwnProperty() auf einem anderen Objekt aufruft (wie Object.prototype.hasOwnProperty.call(obj, prop)), ist Object.hasOwn() intuitiver und prägnanter.

Der folgende Code zeigt, wie man feststellen kann, ob das example-Objekt eine Eigenschaft namens prop enthält.

const example = {};
Object.hasOwn(example, "prop"); // false - 'prop' has not been defined

example.prop = "exists";
Object.hasOwn(example, "prop"); // true - 'prop' has been defined

example.prop = null;
Object.hasOwn(example, "prop"); // true - own property exists with value of null

example.prop = undefined;
Object.hasOwn(example, "prop"); // true - own property exists with value of undefined

Das folgende Beispiel unterscheidet zwischen direkten Eigenschaften und Eigenschaften, die durch die Prototypen-Kette geerbt wurden:

const example = {};
example.prop = "exists";

// `hasOwn` will only return true for direct properties:
Object.hasOwn(example, "prop"); // true
Object.hasOwn(example, "toString"); // false
Object.hasOwn(example, "hasOwnProperty"); // false

// The `in` operator will return true for direct or inherited properties:
"prop" in example; // true
"toString" in example; // true
"hasOwnProperty" in example; // true

Um über die aufzählbaren Eigenschaften eines Objekts zu iterieren, sollten Sie folgendes verwenden:

const example = { foo: true, bar: true };
for (const name of Object.keys(example)) {
  // …
}

Aber wenn Sie for...in verwenden müssen, können Sie Object.hasOwn() verwenden, um die geerbten Eigenschaften zu überspringen:

const example = { foo: true, bar: true };
for (const name in example) {
  if (Object.hasOwn(example, name)) {
    // …
  }
}

Die Elemente eines Array sind als direkte Eigenschaften definiert, sodass Sie die hasOwn()-Methode verwenden können, um zu überprüfen, ob ein bestimmter Index existiert:

const fruits = ["Apple", "Banana", "Watermelon", "Orange"];
Object.hasOwn(fruits, 3); // true ('Orange')
Object.hasOwn(fruits, 4); // false - not defined

Dieser Abschnitt zeigt, dass Object.hasOwn() immun gegen die Probleme ist, die hasOwnProperty() beeinflussen. Erstens, es kann mit Objekten verwendet werden, die hasOwnProperty() neu implementiert haben. Im folgenden Beispiel meldet die neu implementierte hasOwnProperty()-Methode für jede Eigenschaft false, aber das Verhalten von Object.hasOwn() bleibt unbeeinflusst:

const foo = {
  hasOwnProperty() {
    return false;
  },
  bar: "The dragons be out of office",
};

console.log(foo.hasOwnProperty("bar")); // false

console.log(Object.hasOwn(foo, "bar")); // true

Es kann auch mit null-Prototyp-Objekten verwendet werden. Diese erben nicht von Object.prototype, und daher ist hasOwnProperty() nicht zugänglich.

const foo = Object.create(null);
foo.prop = "exists";

console.log(foo.hasOwnProperty("prop"));
// Uncaught TypeError: foo.hasOwnProperty is not a function

console.log(Object.hasOwn(foo, "prop")); // true

• Polyfill von Object.hasOwn in core-js
• Polyfill von es-shims Object.hasOwn
• Object.prototype.hasOwnProperty()
• Aufzählbarkeit und Eigentum von Eigenschaften
• Object.getOwnPropertyNames()
• for...in
• in
• Vererbung und die Prototypen-Kette