handler.construct()

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 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).

Dans cet article

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

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

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.

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

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 17 févr. 2025 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu

Objets natifs standards
Proxy/handler
Méthodes d'instance
Héritage
Object/Function
Méthodes statiques
Propriétés statiques
Méthodes d'instance
Propriétés d'instance
1. Object.prototype.__proto__
2. Object.prototype.constructor
Pages similaires
Proxy

handler.construct()

Dans cet article

Exemple interactif

Syntaxe

Paramètres

Valeur de retour

Description

Interceptions

Invariants

Exemples

Spécifications

Compatibilité des navigateurs

Voir aussi

Aider à améliorer MDN