CKTIS / JavaScript
Reflect.construct — invocar um construtor com uma lista de argumentos
Reflect.construct invoca um construtor com argumentos lidos de um objeto. O newTarget opcional permite separar o construtor executado do valor de new.target e da escolha habitual do protótipo.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
Reflect.construct(target, argumentsList)
Reflect.construct(target, argumentsList, newTarget)Reflect.construct(target, argumentsList) realiza uma construção, não uma chamada normal de função. Também funciona com classes. Ao contrário de Reflect.apply, não aceita um this já existente.
argumentsList tem de ser um objeto. Reflect.construct lê a propriedade length desse objeto para determinar quais as propriedades indexadas a ler. Se não existir uma propriedade length, considera-se que o comprimento é 0. Assim, se target for um construtor, Reflect.construct(target, {}) invoca-o sem argumentos. Já a sintaxe de expansão em new target(...argumentsList) obtém os argumentos a partir do iterador. Por isso, um array com um iterador personalizado pode passar argumentos diferentes ao mesmo construtor nas duas chamadas. Ser iterável não é suficiente; um Set não disponibiliza os seus elementos a Reflect.construct. Tanto target como qualquer newTarget fornecido têm de ser construtores — as funções seta não o são. Argumentos inválidos causam um TypeError; as exceções do construtor são propagadas.
Se newTarget for omitido, o valor predefinido é target; passar explicitamente undefined causa um TypeError. Reflect.construct passa newTarget à operação interna [[Construct]] de target. Se target for uma função construtora normal, new.target tem o valor de newTarget no corpo da função. Se, porém, target for um Proxy, o seu método de interceção construct pode ignorar newTarget e invocar o construtor subjacente com um valor diferente de new.target. Durante a criação normal de um objeto, o seu protótipo provém de newTarget.prototype, se esse valor for um objeto. Isto não executa o corpo de newTarget. Se target devolver explicitamente um objeto, esse objeto pode substituir a instância criada.
No exemplo, Person define os campos, mas o protótipo provém de Alternate. Por isso, o resultado não é uma instância de Person. Esta é uma funcionalidade da linguagem ECMAScript, não uma Web API; a disponibilidade em determinados browsers tem de ser verificada separadamente.
Exemplos
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);Resultado
Ada true true false
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.