Object.prototype.constructor

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die constructor Daten-Eigenschaft einer Object-Instanz gibt einen Verweis auf die Konstruktorfunktion zurück, die das Instanzobjekt erstellt hat. Beachten Sie, dass der Wert dieser Eigenschaft ein Verweis auf die Funktion selbst ist, nicht ein String, der den Namen der Funktion enthält.

Hinweis: Dies ist eine Eigenschaft von JavaScript-Objekten. Für die constructor-Methode in Klassen siehe die eigene Referenzseite.

Wert

Ein Verweis auf die Konstruktorfunktion, die das Instanzobjekt erstellt hat.

Eigenschaften von `Object.prototype.constructor`
Schreibbar	ja
Aufzählbar	nein
Konfigurierbar	ja

Hinweis: Diese Eigenschaft wird standardmäßig in der prototype-Eigenschaft jeder Konstruktorfunktion erstellt und wird von allen Objekten geerbt, die durch diesen Konstruktor erstellt werden.

Beschreibung

Jedes Objekt (mit Ausnahme von null Prototyp-Objekten) weist eine constructor-Eigenschaft auf seinem [[Prototype]] auf. Objekte, die mit Literalen erstellt werden, haben ebenfalls eine constructor-Eigenschaft, die auf den Konstruktionstyp dieses Objekts verweist — zum Beispiel erzeugen Array-Literale Array-Objekte, und Objektliterale erzeugen einfache Objekte.

const o1 = {};
o1.constructor === Object; // true

const o2 = new Object();
o2.constructor === Object; // true

const a1 = [];
a1.constructor === Array; // true

const a2 = new Array();
a2.constructor === Array; // true

const n = 3;
n.constructor === Number; // true

Beachten Sie, dass constructor normalerweise von der prototype-Eigenschaft des Konstruktors stammt. Wenn Sie eine längere Prototypen-Kette haben, können Sie normalerweise erwarten, dass jedes Objekt in der Kette eine constructor-Eigenschaft hat.

const o = new TypeError(); // Inheritance: TypeError -> Error -> Object
const proto = Object.getPrototypeOf;

Object.hasOwn(o, "constructor"); // false
proto(o).constructor === TypeError; // true
proto(proto(o)).constructor === Error; // true
proto(proto(proto(o))).constructor === Object; // true

Beispiele

Den Konstruktor eines Objekts anzeigen

Das folgende Beispiel erstellt einen Konstruktor (Tree) und ein Objekt dieses Typs (theTree). Das Beispiel zeigt dann die constructor-Eigenschaft für das Objekt theTree.

function Tree(name) {
  this.name = name;
}

const theTree = new Tree("Redwood");
console.log(`theTree.constructor is ${theTree.constructor}`);

Dieses Beispiel zeigt folgende Ausgabe:

theTree.constructor is function Tree(name) {
  this.name = name;
}

Zuweisung der Konstruktor-Eigenschaft zu einem Objekt

Man kann die constructor-Eigenschaft von Nicht-Primitiven zuweisen.

const arr = [];
arr.constructor = String;
arr.constructor === String; // true
arr instanceof String; // false
arr instanceof Array; // true

const foo = new Foo();
foo.constructor = "bar";
foo.constructor === "bar"; // true

// etc.

Dies überschreibt nicht die alte constructor-Eigenschaft — sie war ursprünglich im [[Prototype]] der Instanz vorhanden, nicht als eigene Eigenschaft.

const arr = [];
Object.hasOwn(arr, "constructor"); // false
Object.hasOwn(Object.getPrototypeOf(arr), "constructor"); // true

arr.constructor = String;
Object.hasOwn(arr, "constructor"); // true — the instance property shadows the one on its prototype

Aber selbst wenn Object.getPrototypeOf(a).constructor neu zugewiesen wird, ändert sich nicht das andere Verhalten des Objekts. Zum Beispiel wird das Verhalten von instanceof durch Symbol.hasInstance und nicht durch constructor gesteuert:

const arr = [];
arr.constructor = String;
arr instanceof String; // false
arr instanceof Array; // true

Es gibt nichts, was die constructor-Eigenschaft davor schützt, neu zugewiesen oder überschattet zu werden, daher sollte sie in der Regel vermieden werden, um den Typ einer Variablen zu ermitteln, zugunsten weniger anfälliger Methoden wie instanceof und Symbol.toStringTag für Objekte oder typeof für Primitive.

Ändern des Konstruktors des `prototype` einer Konstruktorfunktion

Jeder Konstruktor hat eine prototype-Eigenschaft, die bei Aufruf über den new-Operator zum [[Prototype]] der Instanz wird. ConstructorFunction.prototype.constructor wird daher, wie zuvor gezeigt, zu einer Eigenschaft auf dem [[Prototype]] der Instanz.

Wenn jedoch ConstructorFunction.prototype neu zugewiesen wird, geht die constructor-Eigenschaft verloren. Zum Beispiel ist folgendes eine gängige Methode, um ein Vererbungsmuster zu erstellen:

function Parent() {
  // …
}
Parent.prototype.parentMethod = function () {};

function Child() {
  Parent.call(this); // Make sure everything is initialized properly
}
// Pointing the [[Prototype]] of Child.prototype to Parent.prototype
Child.prototype = Object.create(Parent.prototype);

Der constructor von Instanzen von Child wird Parent sein, weil Child.prototype neu zugewiesen wurde.

Dies ist normalerweise keine große Sache — die Sprache liest fast nie die constructor-Eigenschaft eines Objekts. Die einzige Ausnahme ist die Verwendung von [Symbol.species] zum Erstellen neuer Instanzen einer Klasse, aber solche Fälle sind selten, und Sie sollten ohnehin die extends-Syntax verwenden, um eingebaute Klassen zu unterklassifizieren.

Das Sicherstellen, dass Child.prototype.constructor immer auf Child selbst verweist, ist jedoch entscheidend, wenn ein Anrufer constructor verwendet, um von einer Instanz auf die ursprüngliche Klasse zuzugreifen. Nehmen Sie folgenden Fall: Das Objekt hat die Methode create(), um sich selbst zu erstellen.

function Parent() {
  // …
}
function CreatedConstructor() {
  Parent.call(this);
}

CreatedConstructor.prototype = Object.create(Parent.prototype);

CreatedConstructor.prototype.create = function () {
  return new this.constructor();
};

new CreatedConstructor().create().create(); // TypeError: new CreatedConstructor().create().create is undefined, since constructor === Parent

Im obigen Beispiel wird eine Ausnahme ausgelöst, da der constructor auf Parent verweist. Um dies zu vermeiden, weisen Sie einfach den erforderlichen Konstruktor zu, den Sie verwenden werden.

function Parent() {
  // …
}
function CreatedConstructor() {
  // …
}

CreatedConstructor.prototype = Object.create(Parent.prototype, {
  // Return original constructor to Child
  constructor: {
    value: CreatedConstructor,
    enumerable: false, // Make it non-enumerable, so it won't appear in `for...in` loop
    writable: true,
    configurable: true,
  },
});

CreatedConstructor.prototype.create = function () {
  return new this.constructor();
};

new CreatedConstructor().create().create(); // it's pretty fine

Beachten Sie, dass es beim manuellen Hinzufügen der constructor-Eigenschaft wichtig ist, die Eigenschaft als nicht aufzählbar zu gestalten, damit constructor nicht in for...in-Schleifen besucht wird — so wie es normalerweise nicht ist.

Wenn der obige Code zu viel Boilerplate zu sein scheint, können Sie auch Object.setPrototypeOf() verwenden, um die Prototypen-Kette zu manipulieren.

function Parent() {
  // …
}
function CreatedConstructor() {
  // …
}

Object.setPrototypeOf(CreatedConstructor.prototype, Parent.prototype);

CreatedConstructor.prototype.create = function () {
  return new this.constructor();
};

new CreatedConstructor().create().create(); // still works without re-creating constructor property

Object.setPrototypeOf() hat potenzielle Leistungsnachteile, weil alle zuvor erstellten Objekte, die an der Prototypen-Kette beteiligt sind, neu kompiliert werden müssen; aber wenn der obige Initialisierungscode vor dem Erstellen von Parent oder CreatedConstructor geschieht, sollte der Effekt minimal sein.

Betrachten wir einen weiteren komplexeren Fall.

function ParentWithStatic() {}

ParentWithStatic.startPosition = { x: 0, y: 0 }; // Static member property
ParentWithStatic.getStartPosition = function () {
  return this.startPosition;
};

function Child(x, y) {
  this.position = { x, y };
}

Child.prototype = Object.create(ParentWithStatic.prototype, {
  // Return original constructor to Child
  constructor: {
    value: Child,
    enumerable: false,
    writable: true,
    configurable: true,
  },
});

Child.prototype.getOffsetByInitialPosition = function () {
  const position = this.position;
  // Using this.constructor, in hope that getStartPosition exists as a static method
  const startPosition = this.constructor.getStartPosition();

  return {
    offsetX: startPosition.x - position.x,
    offsetY: startPosition.y - position.y,
  };
};

new Child(1, 1).getOffsetByInitialPosition();
// Error: this.constructor.getStartPosition is undefined, since the
// constructor is Child, which doesn't have the getStartPosition static method

Damit dieses Beispiel richtig funktioniert, können wir die statischen Eigenschaften von Parent auf Child übertragen:

// …
Object.assign(Child, ParentWithStatic); // Notice that we assign it before we create() a prototype below
Child.prototype = Object.create(ParentWithStatic.prototype, {
  // Return original constructor to Child
  constructor: {
    value: Child,
    enumerable: false,
    writable: true,
    configurable: true,
  },
});
// …

Noch besser ist es jedoch, die Konstruktorfunktionen selbst einander erweitern zu lassen, wie es die extends-Syntax bei Klassen tut.

function ParentWithStatic() {}

ParentWithStatic.startPosition = { x: 0, y: 0 }; // Static member property
ParentWithStatic.getStartPosition = function () {
  return this.startPosition;
};

function Child(x, y) {
  this.position = { x, y };
}

// Properly create inheritance!
Object.setPrototypeOf(Child.prototype, ParentWithStatic.prototype);
Object.setPrototypeOf(Child, ParentWithStatic);

Child.prototype.getOffsetByInitialPosition = function () {
  const position = this.position;
  const startPosition = this.constructor.getStartPosition();

  return {
    offsetX: startPosition.x - position.x,
    offsetY: startPosition.y - position.y,
  };
};

console.log(new Child(1, 1).getOffsetByInitialPosition()); // { offsetX: -1, offsetY: -1 }

Auch hier kann die Verwendung von Object.setPrototypeOf() nachteilige Leistungseffekte haben. Stellen Sie daher sicher, dass dies unmittelbar nach der Konstruktor-Deklaration und vor der Erstellung von Instanzen geschieht — um zu vermeiden, dass Objekte "verunreinigt" werden.

Hinweis: Das manuelle Aktualisieren oder Setzen des Constructors kann zu unterschiedlichen und manchmal verwirrenden Konsequenzen führen. Um dies zu verhindern, definieren Sie einfach die Rolle des constructor in jedem spezifischen Fall. In den meisten Fällen wird constructor nicht verwendet und eine Neuzuweisung ist nicht erforderlich.

Spezifikationen

Specification
ECMAScript Language Specification # sec-object.prototype.constructor

Browser-Kompatibilität

BCD tables only load in the browser