new.target
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2016.
Die new.target
Meta-Eigenschaft ermöglicht es Ihnen zu erkennen, ob eine Funktion oder ein Konstruktor mit dem new
-Operator aufgerufen wurde. In Konstruktoren und Funktionen, die mit dem new
-Operator aufgerufen werden, gibt new.target
eine Referenz auf den Konstruktor oder die Funktion zurück, auf die new
angewendet wurde. Bei normalen Funktionsaufrufen ist new.target
undefined
.
Probieren Sie es aus
function Foo() {
if (!new.target) {
throw new TypeError("calling Foo constructor without new is invalid");
}
}
try {
Foo();
} catch (e) {
console.log(e);
// Expected output: TypeError: calling Foo constructor without new is invalid
}
Syntax
new.target
Wert
new.target
ist garantiert entweder eine konstruierbare Funktionswert oder undefined
.
- In Klassenkonstruktoren bezieht es sich auf die Klasse, auf die
new
angewendet wurde. Dies kann auch eine Unterklasse des aktuellen Konstruktors sein, da Unterklassen den Konstruktor der Oberklasse transitiv übersuper()
aufrufen. - In normalen Funktionen bezieht sich
new.target
auf die Funktion selbst, wenn die Funktion direkt mitnew
konstruiert wurde. Wird die Funktion ohnenew
aufgerufen, istnew.target
undefined
. Funktionen können als Basisklasse fürextends
verwendet werden. In diesem Fall kann sichnew.target
auf die Unterklasse beziehen. - Wenn ein Konstruktor (Klasse oder Funktion) über
Reflect.construct()
aufgerufen wird, bezieht sichnew.target
auf den Wert, der alsnewTarget
übergeben wurde (der standardmäßig auftarget
gesetzt ist). - In arrow functions wird
new.target
aus dem umgebenden Geltungsbereich geerbt. Wenn die Pfeilfunktion nicht innerhalb einer anderen Klasse oder Funktion definiert ist, die einnew.target
Binding hat, wird ein Syntaxfehler ausgelöst. - In statischen Initialisierungsblöcken ist
new.target
undefined
.
Beschreibung
Die new.target
-Syntax besteht aus dem Schlüsselwort new
, einem Punkt und dem Bezeichner target
. Da new
ein reserviertes Wort ist und kein Bezeichner, handelt es sich dabei nicht um einen Eigenschafts-Accessor, sondern um eine spezielle Ausdruckssyntax.
Die new.target
Meta-Eigenschaft ist in allen Funktions- oder Klassenkörpern verfügbar. Eine Verwendung von new.target
außerhalb von Funktionen oder Klassen führt zu einem Syntaxfehler.
Beispiele
new.target in Funktionsaufrufen
In normalen Funktionsaufrufen (im Gegensatz zu Konstruktorausrufen) ist new.target
undefined
. Dies ermöglicht es Ihnen, zu erkennen, ob eine Funktion mit new
als Konstruktor aufgerufen wurde.
function Foo() {
if (!new.target) {
throw new Error("Foo() must be called with new");
}
console.log("Foo instantiated with new");
}
new Foo(); // Logs "Foo instantiated with new"
Foo(); // Throws "Foo() must be called with new"
new.target in Konstruktoren
In Klassenkonstruktoren bezieht sich new.target
auf den Konstruktor, der direkt von new
aufgerufen wurde. Dies gilt auch, wenn der Konstruktor in einer Oberklasse liegt und von einem Unterklasse-Konstruktor delegiert wurde. new.target
zeigt auf die Klasse, auf die new
angewendet wurde. Wenn beispielsweise b
mit new B()
initialisiert wurde, wurde der Name B
ausgegeben; und ähnliches gilt für a
mit der Klasse A
.
class A {
constructor() {
console.log(new.target.name);
}
}
class B extends A {
constructor() {
super();
}
}
const a = new A(); // Logs "A"
const b = new B(); // Logs "B"
new.target mit Reflect.construct()
Vor Reflect.construct()
oder Klassen war es üblich, Vererbung zu implementieren, indem der Wert von this
übergeben wurde und der Basiskonstruktor diesen veränderte.
function Base() {
this.name = "Base";
}
function Extended() {
// Only way to make the Base() constructor work on the existing
// `this` value instead of a new object that `new` creates.
Base.call(this);
this.otherProperty = "Extended";
}
Object.setPrototypeOf(Extended.prototype, Base.prototype);
Object.setPrototypeOf(Extended, Base);
console.log(new Extended()); // Extended { name: 'Base', otherProperty: 'Extended' }
Allerdings rufen call()
und apply()
die Funktion tatsächlich auf, anstatt sie zu konstruktieren, sodass new.target
den Wert undefined
hat. Das bedeutet, dass, wenn Base()
prüft, ob es mit new
konstruiert wurde, ein Fehler ausgelöst wird oder es sich auf andere unerwartete Weise verhält. Beispielsweise können Sie Map
auf diese Weise nicht erweitern, da der Map()
-Konstruktor nicht ohne new
aufgerufen werden kann.
Alle eingebauten Konstruktoren konstruieren direkt die gesamte Prototypenkette der neuen Instanz durch das Auslesen von new.target.prototype
. Um sicherzustellen, dass (1) Base
mit new
konstruiert wird und (2) new.target
auf die Unterklasse statt auf Base
selbst zeigt, müssen wir Reflect.construct()
verwenden.
function BetterMap(entries) {
// Call the base class constructor, but setting `new.target` to the subclass,
// so that the instance created has the correct prototype chain.
return Reflect.construct(Map, [entries], BetterMap);
}
BetterMap.prototype.upsert = function (key, actions) {
if (this.has(key)) {
this.set(key, actions.update(this.get(key)));
} else {
this.set(key, actions.insert());
}
};
Object.setPrototypeOf(BetterMap.prototype, Map.prototype);
Object.setPrototypeOf(BetterMap, Map);
const map = new BetterMap([["a", 1]]);
map.upsert("a", {
update: (value) => value + 1,
insert: () => 1,
});
console.log(map.get("a")); // 2
Hinweis:
Tatsächlich ist es aufgrund des Fehlens von Reflect.construct()
nicht möglich, eingebettete Typen (wie das Unterklassen von Error) korrekt zu unterklassen, wenn man auf vor-ES6-Code zurückgreift.
Wenn Sie jedoch ES6-Code schreiben, verwenden Sie lieber Klassen und extends
, da dies lesbarer und weniger fehleranfällig ist.
class BetterMap extends Map {
// The constructor is omitted because it's just the default one
upsert(key, actions) {
if (this.has(key)) {
this.set(key, actions.update(this.get(key)));
} else {
this.set(key, actions.insert());
}
}
}
const map = new BetterMap([["a", 1]]);
map.upsert("a", {
update: (value) => value + 1,
insert: () => 1,
});
console.log(map.get("a")); // 2
Spezifikationen
Specification |
---|
ECMAScript® 2025 Language Specification # sec-built-in-function-objects |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
new.target |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support