handler.construct()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.
La méthode handler.construct()
est une trappe pour l'opérateur new
. Afin que l'opération new
puisse être valide sur le proxy correspondant, la cible utilisée doit avoir une méthode interne [[Construct]]
(autrement dit, l'instruction new cible
doit être valide).
Exemple interactif
function monster1(disposition) {
this.disposition = disposition;
}
const handler1 = {
construct(target, args) {
console.log(`Creating a ${target.name}`);
// Expected output: "Creating a monster1"
return new target(...args);
},
};
const proxy1 = new Proxy(monster1, handler1);
console.log(new proxy1("fierce").disposition);
// Expected output: "fierce"
Syntaxe
var p = new Proxy(cible, {
construct: function (cible, listeArguments, newTarget) {},
});
Paramètres
Les paramètres suivants sont passés à la méthode construct
. this
est ici lié au gestionnaire (handler).
cible
-
L'objet cible.
listeArguments
-
La liste des arguments passés au constructeur.
newTarget
-
Le constructeur originellement appelé.
Valeur de retour
La méthode construct
doit renvoyer un objet.
Description
La méthode handler.construct()
est une trappe pour l'opérateur new
.
Interceptions
Ce trappe intercepte les opérations suivantes :
new proxy(...args)
Reflect.construct()
Invariants
Si les invariants suivants ne sont pas respectés, le proxy renverra une exception TypeError
:
- Le résultat doit être un
Object
.
Exemples
Dans l'exemple qui suit, on piège l'opérateur new
.
var p = new Proxy(function () {}, {
construct: function (target, argumentsList) {
console.log("called: " + argumentsList.join(", "));
return { value: argumentsList[0] * 10 };
},
});
console.log(new p(1).value); // "appel sur : 1"
// 10
Dans cette version, on ne respecte pas la contrainte d'invariance :
var p = new Proxy(function () {}, {
construct: function (target, argumentsList) {
return 1;
},
});
new p(); // Une exception TypeError est levée
Dans le code qui suit, le proxy n'est pas correctement initialisé. La cible du proxy doit être un constructeur valide qui puisse être utilisé avec new
.
var p = new Proxy(
{},
{
construct: function (target, argumentsList, newTarget) {
return {};
},
},
);
new p(); // TypeError: p is not a constructor
Spécifications
Specification |
---|
ECMAScript® 2026 Language Specification # sec-proxy-object-internal-methods-and-internal-slots-construct-argumentslist-newtarget |
Compatibilité des navigateurs
Voir aussi
Proxy
handler
- L'opérateur
new
Reflect.construct()