handler.setPrototypeOf()

La méthode handler.setPrototypeOf() est une trappe pour intercepter Object.setPrototypeOf().

Syntaxe

var p = new Proxy(cible, {
  setPrototypeOf: function(cible, prototype) {
  }
});

Paramètres

Les paramètres suivants sont passés à la méthode setPrototypeOf. this est lié au gestionnaire.

cible
L'objet cible.
prototype
Le nouveau prototype de l'objet ou null.

Valeur de retour

La méthode setPrototypeOf renvoie true si la propriété interne [[Prototype]] a bien été modifiée et false sinon.

Description

La méthode handler.setPrototypeOf est une trappe utilisée pour intercepter les opérations de Object.setPrototypeOf().

Interceptions

Cette trappe permet d'intercepter :

Invariants

Si les invariants suivants ne sont pas respectés, le proxy renverra une exception TypeError :

  • Si cible n'est pas extensible, le param√®tre prototype doit √™tre le m√™me valeur que Object.getPrototypeOf(cible).

Exemples

Si on souhaite interdire la définition d'un nouveau prototype pour un objet, on peut utiliser une méthode setPrototypeOf qui renvoie false ou qui génère une exception.

Avec cette premi√®re approche, toute op√©ration qui voudra modifier le prototype g√©n√®rera une exception. On aura par exemple Object.setPrototypeOf() qui cr√©era et l√®vera l'exception TypeError. Si la modification est effectu√©e par une op√©ration qui ne g√©n√®re pas d'exception en cas d'√©chec (comme  Reflect.setPrototypeOf()), aucune exception ne sera g√©n√©r√©e.

var handlerReturnsFalse = {
    setPrototypeOf(target, newProto) {
        return false;
    }
};

var newProto = {}, target = {};

var p1 = new Proxy(target, handlerReturnsFalse);
Object.setPrototypeOf(p1, newProto);
// lève une TypeError
Reflect.setPrototypeOf(p1, newProto);
// renvoie false

Avec cette seconde approche, toute tentative de modification génèrera une exception. On utilisera celle-ci lorsqu'on souhaite qu'une erreur se produisent, y compris pour les opérations qui ne génèrent habituellement pas d'exception ou si on souhaite générer une exception sur mesure.

var handlerThrows = {
    setPrototypeOf(target, newProto) {
        throw new Error("erreur custom");
    }
};

var newProto = {}, target = {};

var p2 = new Proxy(target, handlerThrows);
Object.setPrototypeOf(p2, newProto);
// lève une exception new Error("erreur custom")
Reflect.setPrototypeOf(p2, newProto);
// lève une exception new Error("erreur custom")

Spécifications

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi