Object.prototype.isPrototypeOf()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Die isPrototypeOf() Methode von Object Instanzen prüft, ob dieses Objekt in der Prototypenkette eines anderen Objekts existiert.

Hinweis: isPrototypeOf() unterscheidet sich vom instanceof Operator. Im Ausdruck object instanceof AFunction wird die Prototypenkette von object gegen AFunction.prototype geprüft, nicht gegen AFunction selbst.

In diesem Artikel

Probieren Sie es aus

function Foo() {}
function Bar() {}

Bar.prototype = Object.create(Foo.prototype);

const bar = new Bar();

console.log(Foo.prototype.isPrototypeOf(bar));
// Expected output: true
console.log(Bar.prototype.isPrototypeOf(bar));
// Expected output: true

Syntax

isPrototypeOf(object)

Parameter

object

Das Objekt, dessen Prototypenkette durchsucht wird.

Rückgabewert

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

Ausnahmen

TypeError

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

Beschreibung

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

Beispiele

Verwendung von isPrototypeOf()

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

js
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 Prototypenkette abstammen; z. B. um sicherzustellen, dass bestimmte Methoden oder Eigenschaften auf diesem Objekt vorhanden sind.

Zum Beispiel, um Code auszuführen, der nur sicher ist, wenn ein baz Objekt Foo.prototype in seiner Prototypenkette hat, können Sie folgendes tun:

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

Allerdings impliziert die Existenz von Foo.prototype in baz's Prototypenkette nicht, dass baz mit Foo als Konstruktor erstellt wurde. Zum Beispiel könnte baz direkt mit Foo.prototype als sein Prototyp zugewiesen worden sein. In diesem Fall würde Ihr Code beim Lesen privater Felder von Foo von baz dennoch fehlschlagen:

js
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
}

Das Gleiche gilt für instanceof. Wenn Sie private Felder auf sichere Weise lesen müssen, bieten Sie stattdessen eine markengeprüfte Methode mit in an.

js
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));
}

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
Object
Konstruktor
1. Object()
Statische Methoden
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor
Vererbung
Object/Function
Statische Methoden
Statische Eigenschaften
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor