handler.construct()

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

Syntaxe

js
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 :

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.

js
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 :

js
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.

js
var p = new Proxy(
  {},
  {
    construct: function (target, argumentsList, newTarget) {
      return {};
    },
  },
);

new p(); // TypeError: p is not a constructor

Spécifications

Specification
ECMAScript Language Specification
# sec-proxy-object-internal-methods-and-internal-slots-construct-argumentslist-newtarget

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi