handler.setPrototypeOf()

Exemple interactif

const handler1 = {
  setPrototypeOf(monster1, monsterProto) {
    monster1.geneticallyModified = true;
    return false;
  },
};

const monsterProto = {};
const monster1 = {
  geneticallyModified: false,
};

const proxy1 = new Proxy(monster1, handler1);
// Object.setPrototypeOf(proxy1, monsterProto); // Throws a TypeError

console.log(Reflect.setPrototypeOf(proxy1, monsterProto));
// Expected output: false

console.log(monster1.geneticallyModified);
// Expected output: true

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 :

• Object.setPrototypeOf()
• Reflect.setPrototypeOf()

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

Voir aussi

• Proxy
• handler
• Object.setPrototypeOf()
• Reflect.setPrototypeOf()