Object.prototype.isPrototypeOf()

object

Das Objekt, dessen Prototyp-Kette durchsucht wird.

Ein Boolean-Wert, der angibt, ob das aufrufende Objekt (this) in der Prototyp-Kette von object liegt. Gibt direkt false zurück, wenn object kein Objekt ist (d. h. ein primitiver Wert).

TypeError

Wird ausgelöst, wenn this null oder undefined ist (da es nicht in ein Objekt umgewandelt werden kann).

Alle Objekte, die von Object.prototype erben (das heißt alle außer Objekten mit null-Prototyp), erben die isPrototypeOf()-Methode. Diese Methode ermöglicht es Ihnen zu überprüfen, ob das Objekt innerhalb der Prototyp-Kette eines anderen Objekts existiert. Wenn das als Parameter übergebene object kein Objekt ist (d. h. ein primitiver Wert), gibt die Methode sofort false zurück. Andernfalls wird der this-Wert in ein Objekt umgewandelt, und die Prototyp-Kette von object wird nach dem this-Wert durchsucht, bis das Ende der Kette erreicht ist oder der this-Wert gefunden wird.

Dieses Beispiel zeigt, dass Baz.prototype, Bar.prototype, Foo.prototype und Object.prototype in der Prototyp-Kette für das Objekt baz existieren:

class Foo {}
class Bar extends Foo {}
class Baz extends Bar {}

const foo = new Foo();
const bar = new Bar();
const baz = new Baz();

// prototype chains:
// foo: Foo --> Object
// bar: Bar --> Foo --> Object
// baz: Baz --> Bar --> Foo --> Object
console.log(Baz.prototype.isPrototypeOf(baz)); // true
console.log(Baz.prototype.isPrototypeOf(bar)); // false
console.log(Baz.prototype.isPrototypeOf(foo)); // false
console.log(Bar.prototype.isPrototypeOf(baz)); // true
console.log(Bar.prototype.isPrototypeOf(foo)); // false
console.log(Foo.prototype.isPrototypeOf(baz)); // true
console.log(Foo.prototype.isPrototypeOf(bar)); // true
console.log(Object.prototype.isPrototypeOf(baz)); // true

Die isPrototypeOf()-Methode — zusammen mit dem instanceof-Operator — ist besonders nützlich, wenn Sie Code haben, der nur mit Objekten funktioniert, die von einer bestimmten Prototyp-Kette abstammen; z. B. um sicherzustellen, dass bestimmte Methoden oder Eigenschaften auf diesem Objekt vorhanden sind.

Zum Beispiel, um Code auszuführen, der nur sicher ausgeführt werden kann, wenn ein baz-Objekt Foo.prototype in seiner Prototyp-Kette hat, können Sie dies tun:

if (Foo.prototype.isPrototypeOf(baz)) {
  // do something safe
}

Jedoch impliziert das Vorhandensein von Foo.prototype in der Prototyp-Kette von baz nicht, dass baz mit dem Konstruktor Foo erstellt wurde. Zum Beispiel könnte baz direkt mit Foo.prototype als Prototyp zugewiesen worden sein. In diesem Fall würde Ihr Code, der private Felder von Foo von baz liest, trotzdem fehlschlagen:

class Foo {
  #value = "foo";
  static getValue(x) {
    return x.#value;
  }
}

const baz = { __proto__: Foo.prototype };

if (Foo.prototype.isPrototypeOf(baz)) {
  console.log(Foo.getValue(baz)); // TypeError: Cannot read private member #value from an object whose class did not declare it
}

Dasselbe gilt für instanceof. Wenn Sie private Felder auf sichere Weise lesen müssen, bieten Sie eine gebrandete Prüfungsmethode mit in an.

class Foo {
  #value = "foo";
  static getValue(x) {
    return x.#value;
  }
  static isFoo(x) {
    return #value in x;
  }
}

const baz = { __proto__: Foo.prototype };

if (Foo.isFoo(baz)) {
  // Doesn't run, because baz is not a Foo
  console.log(Foo.getValue(baz));
}

• instanceof
• Object.getPrototypeOf()
• Object.setPrototypeOf()
• Vererbung und die Prototyp-Kette