CKTIS / JavaScript
Reflect.construct — invocar un constructor con una lista de argumentos
Reflect.construct invoca un constructor con argumentos leídos de un objeto. Su newTarget opcional permite separar el constructor que se ejecuta del valor de new.target y de la selección habitual del prototipo.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
Reflect.construct(target, argumentsList)
Reflect.construct(target, argumentsList, newTarget)Reflect.construct(target, argumentsList) realiza una construcción, no una llamada ordinaria a una función. También funciona con clases. A diferencia de Reflect.apply, no acepta un this existente.
argumentsList debe ser un objeto. Reflect.construct lee su propiedad length para determinar qué propiedades indexadas debe leer. Si no hay una propiedad length, la longitud se considera 0, por lo que, si target es un constructor, Reflect.construct(target, {}) lo invoca sin argumentos. En cambio, la sintaxis de expansión de new target(...argumentsList) obtiene los argumentos del iterador. Por ello, un array con un iterador personalizado puede pasar argumentos distintos al mismo constructor en las dos llamadas. Ser iterable no basta; un Set no proporciona sus elementos a Reflect.construct. Tanto target como cualquier newTarget proporcionado deben ser constructores: las funciones flecha no lo son. Los argumentos no válidos provocan un TypeError; las excepciones del constructor se propagan.
Si se omite newTarget, su valor predeterminado es target; pasar undefined explícitamente provoca un TypeError. Reflect.construct pasa newTarget a la operación interna [[Construct]] de target. Si target es una función constructora ordinaria, new.target tiene el valor de newTarget en el cuerpo de la función. En cambio, si target es un Proxy, su trampa construct puede ignorar newTarget e invocar el constructor subyacente con un valor distinto de new.target. Durante la creación ordinaria de un objeto, su prototipo procede de newTarget.prototype si ese valor es un objeto. Esto no ejecuta el cuerpo de newTarget. Si target devuelve explícitamente un objeto, este puede sustituir a la instancia creada.
En el ejemplo, Person establece los campos, pero el prototipo procede de Alternate. Por tanto, el resultado no es una instancia de Person. Esta es una funcionalidad del lenguaje ECMAScript, no una API web; la disponibilidad en determinados navegadores debe comprobarse por separado.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.