Object.prototype.__proto__

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Warnung: Das Ändern des [[Prototype]] eines Objekts ist aufgrund der Optimierung von Eigenschaftszugriffen in modernen JavaScript-Engines derzeit in jedem Browser und jeder JavaScript-Engine eine sehr langsame Operation. Darüber hinaus sind die Effekte der Veränderung der Vererbung subtil und weitreichend und nicht auf die verbrachte Zeit in der Anweisung obj.__proto__ = ... beschränkt, sondern können sich auf jeden Code erstrecken, der Zugriff auf irgendein Objekt hat, dessen [[Prototype]] verändert wurde. Weitere Informationen finden Sie in JavaScript engine fundamentals: optimizing prototypes.

Hinweis: Die Verwendung von __proto__ ist umstritten und wird nicht empfohlen. Seine Existenz und das genaue Verhalten wurden nur als älteres Merkmal standardisiert, um die Web-Kompatibilität sicherzustellen, während es mehrere Sicherheitsprobleme und potenzielle Fehlerquellen aufweist. Für eine bessere Unterstützung verwenden Sie stattdessen Object.getPrototypeOf()/Reflect.getPrototypeOf() und Object.setPrototypeOf()/Reflect.setPrototypeOf().

Die __proto__ Accessor-Eigenschaft von Object-Instanzen legt den [[Prototype]] (entweder ein Objekt oder null) dieses Objekts offen.

Die __proto__-Eigenschaft kann auch in einer Objekt-Literal-Definition verwendet werden, um das Objekt-[[Prototype]] bei der Erstellung festzulegen, als Alternative zu Object.create(). Siehe: Objektinitialisierer / Literal-Syntax. Diese Syntax ist standardisiert und in Implementierungen optimiert und unterscheidet sich erheblich von Object.prototype.__proto__.

Syntax

js
obj.__proto__

Rückgabewert

Wird sie als Getter verwendet, gibt sie das [[Prototype]] des Objekts zurück.

Ausnahmen

TypeError

Wird ausgelöst, wenn versucht wird, das Prototype eines nicht erweiterbaren Objekts oder eines unveränderlichen specialesPrototype-Objekts wie Object.prototype oder window zu setzen.

Beschreibung

Die __proto__-Getter-Funktion legt den Wert des internen [[Prototype]] eines Objekts offen. Für Objekte, die mit einem Objekt-Literal erstellt werden (sofern Sie nicht die prototype setter Syntax verwenden), ist dieser Wert Object.prototype. Für Objekte, die mit Array-Literalen erstellt werden, ist dieser Wert Array.prototype. Für Funktionen ist dieser Wert Function.prototype. Sie können mehr über die Prototypen-Kette in Vererbung und die Prototypen-Kette lesen.

Der __proto__-Setter ermöglicht das Ändern des [[Prototype]] eines Objekts. Der angegebene Wert muss ein Objekt oder null sein. Jeder andere Wert wird nichts bewirken.

Im Gegensatz zu Object.getPrototypeOf() und Object.setPrototypeOf(), die immer als statische Eigenschaften auf Object verfügbar sind und immer die interne [[Prototype]]-Eigenschaft widerspiegeln, existiert die __proto__-Eigenschaft nicht immer als Eigenschaft auf allen Objekten und spiegelt daher [[Prototype]] nicht zuverlässig wider.

Die __proto__-Eigenschaft ist nur eine Accessor-Eigenschaft auf Object.prototype, die aus einer Getter- und einer Setter-Funktion besteht. Ein Eigenschaftszugriff auf __proto__, der letztendlich Object.prototype konsultiert, wird diese Eigenschaft finden, aber ein Zugriff, der Object.prototype nicht konsultiert, wird das nicht. Wenn eine andere __proto__-Eigenschaft gefunden wird, bevor Object.prototype konsultiert wird, wird diese Eigenschaft die auf Object.prototype gefundene verbergen.

Null-Prototyp-Objekte erben keine Eigenschaft von Object.prototype, einschließlich der __proto__-Accessor-Eigenschaft. Wenn Sie versuchen, __proto__ auf einem solchen Objekt zu lesen, ist der Wert immer undefined, unabhängig vom tatsächlichen [[Prototype]] des Objekts, und jede Zuweisung an __proto__ würde eine neue Eigenschaft namens __proto__ erstellen, anstatt das Prototype des Objekts zu setzen. Darüber hinaus kann __proto__ als eigene Eigenschaft auf jeder Objektinstanz über Object.defineProperty() ohne Auslösen des Setters neu definiert werden. In diesem Fall wird __proto__ nicht länger ein Accessor für [[Prototype]] sein. Deshalb sollten Sie immer Object.getPrototypeOf() und Object.setPrototypeOf() verwenden, um das [[Prototype]] eines Objekts zu setzen und zu bekommen.

Beispiele

Verwendung von __proto__

js
function Circle() {}
const shape = {};
const circle = new Circle();

// Set the object prototype.
// DEPRECATED. This is for example purposes only. DO NOT DO THIS in real code.
shape.__proto__ = circle;

// Get the object prototype
console.log(shape.__proto__ === Circle); // false
js
function ShapeA() {}
const ShapeB = {
  a() {
    console.log("aaa");
  },
};

ShapeA.prototype.__proto__ = ShapeB;
console.log(ShapeA.prototype.__proto__); // { a: [Function: a] }

const shapeA = new ShapeA();
shapeA.a(); // aaa
console.log(ShapeA.prototype === shapeA.__proto__); // true
js
function ShapeC() {}
const ShapeD = {
  a() {
    console.log("a");
  },
};

const shapeC = new ShapeC();
shapeC.__proto__ = ShapeD;
shapeC.a(); // a
console.log(ShapeC.prototype === shapeC.__proto__); // false
js
function Test() {}
Test.prototype.myName = function () {
  console.log("myName");
};

const test = new Test();
console.log(test.__proto__ === Test.prototype); // true
test.myName(); // myName

const obj = {};
obj.__proto__ = Test.prototype;
obj.myName(); // myName

Spezifikationen

Specification
ECMAScript® 2026 Language Specification
# sec-object.prototype.__proto__

Browser-Kompatibilität

Siehe auch