instanceof

Der instanceof Operator pr├╝ft, ob ein Objekt die prototype Eigenschaft einer Konstruktorfunktion in seiner Prototypenkette besitzt.

Syntax

object instanceof constructor

Parameter

object
Das zu pr├╝fende Objekt.
constructor
Gegen die zu testende Funktion.

Beschreibung

Der instanceof Operator pr├╝ft die Anwesenheit des constructor.prototype in der Prototypenkette eines Objekts.

// Konstruktoren definieren
function C(){}
function D(){}

var o = new C();

// true, weil: Object.getPrototypeOf(o) === C.prototype
o instanceof C;

// false, weil D.prototype nirgends in o's Prototypenkette ist
o instanceof D;

o instanceof Object; // true, weil:
C.prototype instanceof Object // true

C.prototype = {};
var o2 = new C();

o2 instanceof C; // true

// false, weil C.prototype nirgends in
// o's Prototypenkette ist
o instanceof C;

D.prototype = new C(); // Einsatz von Vererbung
var o3 = new D();
o3 instanceof D; // true
o3 instanceof C; // true

Zu beachten ist, dass sich das Ergebnis des instanceof Tests ├Ąndern kann, wenn die prototype Eigenschaft eines Konstruktors ge├Ąndert wird und auch, wenn ein Objektprototyp mit Object.setPrototypeOf ge├Ąndert wird. Es ist auch m├Âglich die nicht standardisierte Pseudoeigenschaft __proto__ zu nutzen.

instanceof und verschiedene Kontexte (z. B. Frames oder Windows)

Verschiedene Scopes haben verschiedene Ausf├╝hrungsumgebungen. Das bedeutet, sie haben verschiedene Standardobjekte (verschiedene globale Objekte, verschiedene Konstruktoren, etc.). Das kann zu unerwarteten Resultaten f├╝hrt. Zum Beispiel gibt [] instanceof window.frames[0].Array false zur├╝ck, weil Array.prototype !== window.frames[0].Array ist und Arrays vom Ersteren erben.

Auf den ersten Blick ergibt das nicht viel Sinn, f├Ąngt man jedoch an Objekte zwischen verschiedenen Frames oder Windows zwischen Kontexten auszutauschen, w├Ąre das valide und ein gro├čes Problem. Zum Beispiel kann man mit sicher testen ob ein Objekt ein Array ist, indem man Array.isArray(myObj) benutzt.

Zur Pr├╝fung ob ein Node ein SVGElement ist kann myNode instanceof myNode.ownerDocument.defaultView.SVGElement genutzt werden.

Hinweis for Mozilla Entwickler:
In Code mit XPCOM, hat instanceof einen speziellen Effekt: obj instanceof xpcomInterface (z. B. Components.interfaces.nsIFile) ruft obj.QueryInterface(xpcomInterface) auf und gibt true zur├╝ck, wenn QueryInterface erfolgreich war. Ein Seiteneffekt ist, dass Eigenschaften von xpcomInterface auf obj aufgerufen werden k├Ânnen, wenn erfolgreich mit instanceof getestet wurde. Im Gegensatz zu JavaScripts Standardobjekten, funktioniert obj instanceof xpcomInterface wie erwartet, auch wenn obj aus ein anderen Scope stammt.

Beispiele

Demonstration, dass String und Date vom Typ Object sind und Ausnahmef├Ąlle

Der folgende Quelltext nutzt instanceof, um zu demonstrieren, dass String und Date Objekte von Typ Object sind (sie sind von Object abgeleitet).

Immer, wenn ein Objekt durch die Objekt Literal Notation erstellt wird, ist das eine Ausnahme: Auch wenn der Prototype undefined ist, ergibt instanceof Object true.

var simpleStr = "This is a simple string";
var myString  = new String();
var newStr    = new String("String created with constructor");
var myDate    = new Date();
var myObj     = {};
var myNonObj  = Object.create(null);

simpleStr instanceof String; // gibt false zur├╝ck; kontrolliert die Prototypenkette und findet undefined
myString  instanceof String; // gibt true zur├╝ck
newStr    instanceof String; // gibt true zur├╝ck
myString  instanceof Object; // gibt true zur├╝ck

myObj    instanceof Object;    // gibt true zur├╝ck, trotz eines undefined Prototypen
({})     instanceof Object;    // gibt true zur├╝ck, gleicher Fall wie oben
myNonObj instanceof Object;    // gibt false zur├╝ck, ein Weg ein Objekt zu erstellen, welches keine Instanz von Object ist

myString instanceof Date;   // gibt false zur├╝ck

myDate instanceof Date;     // gibt true zur├╝ck
myDate instanceof Object;   // gibt true zur├╝ck
myDate instanceof String;   // gibt false zur├╝ck

Demonstration, dass mycar vom Typ Car und vom Typ Object ist

Der folgende Quelltext erstellt ein Objekttyp Car und einen Instanz dieses Typen, mycar. Der instanceof Operator demonstriert, dass das mycar Objekt vom Typ Car und Object ist.

function Car(make, model, year) {
  this.make = make;
  this.model = model;
  this.year = year;
}
var mycar = new Car("Honda", "Accord", 1998);
var a = mycar instanceof Car;    // gibt true zur├╝ck
var b = mycar instanceof Object; // gibt true zur├╝ck

Spezifikationen

Browserkompatibilit├Ąt

BCD tables only load in the browser

Siehe auch