CKTIS / JavaScript
Reflect.construct — извикване на конструктор със списък от аргументи
Reflect.construct извиква конструктор с аргументи, прочетени от обект. Незадължителният параметър newTarget позволява изпълняваният конструктор да се определи отделно от стойността на new.target и обичайния избор на прототип.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
Reflect.construct(target, argumentsList)
Reflect.construct(target, argumentsList, newTarget)Reflect.construct(target, argumentsList) извършва конструиране, а не обикновено извикване на функция. Работи и с класове. За разлика от Reflect.apply, не приема вече съществуващ this.
argumentsList трябва да бъде обект. Reflect.construct прочита свойството му length, за да определи кои индексирани свойства да прочете. Ако свойството length липсва, дължината се приема за 0. Затова, ако target е конструктор, Reflect.construct(target, {}) го извиква без аргументи. За разлика от това синтаксисът за разгъване в new target(...argumentsList) взема аргументите от итератора. Затова масив с персонализиран итератор може да подаде различни аргументи на един и същ конструктор при двете извиквания. Само итерируемост не е достатъчна; Set не предоставя елементите си на Reflect.construct. И target, и подаденият newTarget трябва да са конструктори — стрелковите функции не са. Невалидните аргументи причиняват TypeError; изключенията от конструктора се предават нататък.
Ако newTarget бъде пропуснат, стойността му по подразбиране е target; изричното подаване на undefined причинява TypeError. Reflect.construct предава newTarget на вътрешната операция [[Construct]] на target. Ако target е обикновена конструкторна функция, в тялото ѝ new.target има стойността на newTarget. Ако обаче target е обект Proxy, неговият прихващащ метод construct може да пренебрегне newTarget и да извика обвития конструктор с друга стойност на new.target. При обичайното създаване на обект неговият прототип идва от newTarget.prototype, ако тази стойност е обект. Това не изпълнява тялото на newTarget. Ако target изрично върне обект, той може да замени създадения екземпляр.
В примера Person задава полетата, но прототипът идва от Alternate. Затова резултатът не е екземпляр на Person. Това е възможност на езика ECMAScript, а не Web API; наличността в конкретни браузъри трябва да се провери отделно.
Примери
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);Резултат
Ada true true false
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.