CKTIS / JavaScript
Reflect.construct — appeler un constructeur avec une liste d’arguments
Reflect.construct appelle un constructeur avec des arguments lus dans un objet. Son paramètre facultatif newTarget permet de distinguer le constructeur exécuté de la valeur de new.target et du choix habituel du prototype.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Reflect.construct(target, argumentsList)
Reflect.construct(target, argumentsList, newTarget)Reflect.construct(target, argumentsList) effectue une construction, et non un appel de fonction ordinaire. La méthode fonctionne aussi avec les classes. Contrairement à Reflect.apply, elle n’accepte pas de valeur this préexistante.
argumentsList doit être un objet. Reflect.construct lit sa propriété length pour déterminer quelles propriétés indexées lire. En l’absence de length, la longueur est considérée comme égale à 0. Ainsi, si target est un constructeur, Reflect.construct(target, {}) l’appelle sans argument. En revanche, la syntaxe de décomposition dans new target(...argumentsList) tire les arguments de l’itérateur. Un tableau doté d’un itérateur personnalisé peut donc transmettre des arguments différents au même constructeur selon l’appel utilisé. Le fait d’être itérable ne suffit pas ; un Set ne fournit pas ses éléments à Reflect.construct. target et tout newTarget fourni doivent être des constructeurs — les fonctions fléchées ne le sont pas. Des arguments non valides provoquent un TypeError ; les exceptions du constructeur sont propagées.
Si newTarget est omis, sa valeur par défaut est target ; passer explicitement undefined provoque un TypeError. Reflect.construct transmet newTarget à l’opération interne [[Construct]] de target. Si target est une fonction constructeur ordinaire, new.target vaut newTarget dans le corps de cette fonction. Si target est un Proxy, en revanche, son intercepteur construct peut ignorer newTarget et appeler le constructeur sous-jacent avec une autre valeur de new.target. Lors de la création ordinaire d’un objet, son prototype provient de newTarget.prototype si cette valeur est un objet. Cela n’exécute pas le corps de newTarget. Si target renvoie explicitement un objet, celui-ci peut remplacer l’instance créée.
Dans l’exemple, Person définit les champs, mais le prototype provient de Alternate. Le résultat n’est donc pas une instance de Person. Il s’agit d’une fonctionnalité du langage ECMAScript, et non d’une API Web ; sa disponibilité dans des navigateurs particuliers doit être vérifiée séparément.
Exemples
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);Résultat
Ada true true false
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.