Funktion: prototype

Die prototype Daten-Eigenschaft einer Function-Instanz wird verwendet, wenn die Funktion als Konstruktor mit dem new-Operator verwendet wird. Sie wird zum Prototyp des neuen Objekts.

Hinweis: Nicht alle Function-Objekte haben die prototype-Eigenschaft — siehe Beschreibung.

Wert

Ein Objekt.

Eigenschaften von Funktion: prototype
Schreibbarja
Aufzählbarnein
Konfigurierbarnein

Hinweis: Klassen sind eine Art von Funktion, daher trifft die meiste Beschreibung hier auch auf die prototype-Eigenschaft von Klassen zu. Der einzige wesentliche Unterschied ist, dass die prototype-Eigenschaft einer Klasse nicht beschreibbar ist.

Beschreibung

Wenn eine Funktion mit new aufgerufen wird, wird die prototype-Eigenschaft des Konstruktors zum Prototyp des resultierenden Objekts.

js
function Ctor() {}
const inst = new Ctor();
console.log(Object.getPrototypeOf(inst) === Ctor.prototype); // true

Sie können Vererbung und die Prototypkette lesen, um mehr über die Interaktionen zwischen der prototype-Eigenschaft einer Konstruktorfunktion und dem Prototyp des resultierenden Objekts zu erfahren.

Eine Funktion, die eine prototype-Eigenschaft hat, ist nicht ausreichend, um als Konstruktor in Frage zu kommen. Generatorfunktionen haben eine prototype-Eigenschaft, können aber nicht mit new aufgerufen werden:

js
async function* asyncGeneratorFunction() {}
function* generatorFunction() {}

Stattdessen wird die prototype-Eigenschaft von Generatorfunktionen verwendet, wenn sie ohne new aufgerufen werden. Die prototype-Eigenschaft wird zum Prototyp des zurückgegebenen Generator-Objekts.

Zusätzlich können einige Funktionen eine prototype-Eigenschaft haben, werfen jedoch bedingungslos einen Fehler, wenn sie mit new aufgerufen werden. Zum Beispiel werfen die Funktionen Symbol() und BigInt() einen Fehler, wenn sie mit new aufgerufen werden, da Symbol.prototype und BigInt.prototype nur Methoden für die primitiven Werte bereitstellen sollen, aber die Wrapper-Objekte nicht direkt konstruiert werden sollten.

Die folgenden Funktionen haben keine prototype-Eigenschaft und sind daher nicht als Konstruktoren geeignet, selbst wenn später manuell eine prototype-Eigenschaft zugewiesen wird:

js
const method = { foo() {} }.foo;
const arrowFunction = () => {};
async function asyncFunction() {}

Die folgenden sind gültige Konstruktoren, die eine prototype-Eigenschaft haben:

js
class Class {}
function fn() {}

Eine gebundene Funktion hat keine prototype-Eigenschaft, kann aber konstruktiv sein. Wenn sie konstruiert wird, wird stattdessen die Ziel-Funktion konstruiert, und wenn die Ziel-Funktion konstruktiv ist, würde sie eine normale Instanz zurückgeben.

js
const boundFunction = function () {}.bind(null);

Die prototype-Eigenschaft einer Funktion ist standardmäßig ein einfaches Objekt mit einer Eigenschaft: constructor, die ein Verweis auf die Funktion selbst ist. Die constructor-Eigenschaft ist beschreibbar, nicht aufzählbar und konfigurierbar.

Wenn der prototype einer Funktion mit etwas anderem als einem Object neu zugewiesen wird, würde beim Aufruf der Funktion mit new der Prototyp des zurückgegebenen Objekts stattdessen Object.prototype sein. (Mit anderen Worten, new ignoriert die prototype-Eigenschaft und konstruiert ein einfaches Objekt.)

js
function Ctor() {}
Ctor.prototype = 3;
console.log(Object.getPrototypeOf(new Ctor()) === Object.prototype); // true

Beispiele

Veränderung des Prototyps aller Instanzen durch Mutation der Prototyp-Eigenschaft

js
function Ctor() {}
const p1 = new Ctor();
const p2 = new Ctor();
Ctor.prototype.prop = 1;
console.log(p1.prop); // 1
console.log(p2.prop); // 1

Hinzufügen einer Nicht-Methoden-Eigenschaft zur Prototyp-Eigenschaft einer Klasse

Klassenfelder fügen jeder Instanz Eigenschaften hinzu. Klassenmethoden deklarieren Funktions-Eigenschaften auf dem Prototyp. Es gibt jedoch keine Möglichkeit, eine Nicht-Funktions-Eigenschaft zum Prototyp hinzuzufügen. Falls Sie statische Daten zwischen allen Instanzen teilen möchten (zum Beispiel ist Error.prototype.name zwischen allen Fehlerinstanzen gleich), können Sie diese manuell der prototype-Eigenschaft einer Klasse zuweisen.

js
class Dog {
  constructor(name) {
    this.name = name;
  }
}

Dog.prototype.species = "dog";

console.log(new Dog("Jack").species); // "dog"

Dies kann eleganter gestaltet werden durch die Verwendung von statischen Initialisierungsblöcken, die aufgerufen werden, wenn die Klasse initialisiert wird.

js
class Dog {
  static {
    Dog.prototype.species = "dog";
  }
  constructor(name) {
    this.name = name;
  }
}

console.log(new Dog("Jack").species); // "dog"

Spezifikationen

Specification
ECMAScript® 2026 Language Specification
# sec-function-instances-prototype

Siehe auch