Object.prototype.hasOwnProperty()

prop

Der String Name oder Symbol der zu testenden Eigenschaft.

Gibt true zurück, wenn das Objekt die angegebene Eigenschaft als eigene Eigenschaft hat; andernfalls false.

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

Die Methode kann auf den meisten JavaScript-Objekten aufgerufen werden, da die meisten Objekte von Object abstammen und daher dessen Methoden erben. Zum Beispiel ist Array ein Object, sodass Sie die hasOwnProperty() Methode verwenden können, um zu prüfen, ob ein Index existiert:

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

Die Methode wird in Objekten, in denen sie neu implementiert wird, oder bei null-Prototyp-Objekten (da diese nicht von Object.prototype erben) nicht verfügbar sein. Beispiele für diese Fälle werden unten angegeben.

Der folgende Code zeigt, wie bestimmt werden kann, ob das example Objekt eine Eigenschaft namens prop enthält.

const example = {};
example.hasOwnProperty("prop"); // false

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

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

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

Das folgende Beispiel unterscheidet zwischen direkten Eigenschaften und Eigenschaften, die über die Prototypen-Kette geerbt werden:

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

// `hasOwnProperty` will only return true for direct properties:
example.hasOwnProperty("prop"); // true
example.hasOwnProperty("toString"); // false
example.hasOwnProperty("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

Das folgende Beispiel zeigt, wie über die aufzählbaren Eigenschaften eines Objekts iteriert wird, ohne auf geerbte Eigenschaften zuzugreifen.

const buz = {
  fog: "stack",
};

for (const name in buz) {
  if (buz.hasOwnProperty(name)) {
    console.log(`this is fog (${name}) for sure. Value: ${buz[name]}`);
  } else {
    console.log(name); // toString or something else
  }
}

Beachten Sie, dass die for...in Schleife nur über aufzählbare Elemente iteriert: Das Fehlen von nicht aufzählbaren Eigenschaften im Durchlauf impliziert nicht, dass hasOwnProperty selbst strikt auf aufzählbare Elemente beschränkt ist. Sie können über nicht aufzählbare Eigenschaften mit Object.getOwnPropertyNames() iterieren.

JavaScript schützt den Eigenschaftsnamen hasOwnProperty nicht; ein Objekt, das eine Eigenschaft mit diesem Namen hat, kann falsche Ergebnisse zurückgeben:

const foo = {
  hasOwnProperty() {
    return false;
  },
  bar: "Here be dragons",
};

foo.hasOwnProperty("bar"); // re-implementation always returns false

Der empfohlene Weg, dieses Problem zu umgehen, besteht darin, stattdessen Object.hasOwn() zu verwenden (in Browsern, die dies unterstützen). Andere Alternativen beinhalten die Verwendung einer externen hasOwnProperty:

const foo = { bar: "Here be dragons" };

// Use Object.hasOwn() method - recommended
Object.hasOwn(foo, "bar"); // true

// Use the hasOwnProperty property from the Object prototype
Object.prototype.hasOwnProperty.call(foo, "bar"); // true

// Use another Object's hasOwnProperty
// and call it with 'this' set to foo
({}).hasOwnProperty.call(foo, "bar"); // true

Beachten Sie, dass in den ersten beiden Fällen keine neuen Objekte erstellt werden.

null-Prototyp-Objekte erben nicht von Object.prototype, wodurch hasOwnProperty() nicht zugänglich ist.

const foo = Object.create(null);
foo.prop = "exists";
foo.hasOwnProperty("prop"); // Uncaught TypeError: foo.hasOwnProperty is not a function

Die Lösungen in diesem Fall sind dieselben wie im vorherigen Abschnitt: Verwenden Sie nach Möglichkeit Object.hasOwn(), andernfalls verwenden Sie die hasOwnProperty() eines externen Objekts.

• Object.hasOwn()
• Aufzählbarkeit und Besitz von Eigenschaften
• Object.getOwnPropertyNames()
• for...in
• in
• Vererbung und die Prototypen-Kette