CKTIS / JavaScript
Reflect.construct — wywołanie konstruktora z listą argumentów
Reflect.construct uruchamia konstruktor z argumentami pobranymi z obiektu. Opcjonalny newTarget pozwala oddzielić wykonywany konstruktor od wartości new.target i zwykłego wyboru prototypu.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
Reflect.construct(target, argumentsList)
Reflect.construct(target, argumentsList, newTarget)Reflect.construct(target, argumentsList) wykonuje operację konstruowania, a nie zwykłe wywołanie funkcji. Działa także z klasami. W przeciwieństwie do Reflect.apply nie przyjmuje istniejącego this.
argumentsList musi być obiektem. Reflect.construct odczytuje jego length i na tej podstawie ustala, które właściwości indeksowane odczytać. Brak length jest traktowany jak długość równa 0, więc jeśli target jest konstruktorem, Reflect.construct(target, {}) wywoła go bez argumentów. Natomiast składnia rozwijania w new target(...argumentsList) pobiera argumenty z iteratora. Dlatego tablica z niestandardowym iteratorem może przekazać temu samemu konstruktorowi inne argumenty w tych dwóch wywołaniach. Sama iterowalność nie wystarcza; Set nie przekazuje swoich elementów przez Reflect.construct. Zarówno target, jak i podany newTarget muszą być konstruktorami — funkcje strzałkowe nimi nie są. Nieprawidłowe argumenty powodują TypeError; wyjątki konstruktora są przekazywane dalej.
Pominięty newTarget domyślnie oznacza target; jawne undefined powoduje TypeError. Reflect.construct przekazuje newTarget do wewnętrznej operacji [[Construct]] obiektu target. Jeśli target jest zwykłą funkcją konstruktorową, w jej ciele new.target ma wartość newTarget. Jeśli jednak target jest obiektem Proxy, jego pułapka construct może zignorować newTarget i uruchomić opakowany konstruktor z inną wartością new.target. Przy zwykłym tworzeniu obiektu jego prototyp pochodzi z newTarget.prototype, jeśli jest to obiekt. Ciało newTarget nie jest przez to wykonywane. Jeśli target jawnie zwróci obiekt, może on zastąpić utworzoną instancję.
W przykładzie Person ustawia pola, ale prototyp pochodzi z Alternate. Dlatego wynik nie jest instancją Person. Jest to mechanizm języka ECMAScript, nie Web API; dostępność w konkretnych przeglądarkach wymaga osobnego sprawdzenia.
Przykłady
function Person(name) {
this.name = name;
this.usedAlternate = new.target === Alternate;
}
function Alternate() {
throw new Error("Must not run");
}
const person = Reflect.construct(Person, ["Ada"], Alternate);
console.log(person.name);
console.log(person.usedAlternate);
console.log(Object.getPrototypeOf(person) === Alternate.prototype);
console.log(person instanceof Person);Wynik
Ada true true false
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.