Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła