Reflect.setPrototypeOf()
Baseline
Widely available
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 statique Reflect.setPrototypeOf() est semblable à la méthode Object.setPrototypeOf() (exception faite de la valeur de retour). Elle permet de définir le prototype (c'est-à-dire la propriété interne [[Prototype]]) d'un objet donné avec un autre objet ou null. Cette méthode renvoie true si l'opération a réussi et false sinon.
Exemple interactif
const object1 = {};
console.log(Reflect.setPrototypeOf(object1, Object.prototype));
// Expected output: true
console.log(Reflect.setPrototypeOf(object1, null));
// Expected output: true
const object2 = {};
console.log(Reflect.setPrototypeOf(Object.freeze(object2), null));
// Expected output: false
Syntaxe
Reflect.setPrototypeOf(cible, prototype);
Paramètres
Valeur de retour
Un booléen qui indique si le prototype a correctement été modifié.
Exceptions
Une erreur TypeError si cible n'est pas un Object ou si prototype n'est ni un objet ni null.
Description
La méthode Reflect.setPrototypeOf permet de modifier le prototype (qui est la valeur de la propriété interne [[Prototype]]) d'un objet donné.
Exemples
>Utiliser Reflect.setPrototypeOf()
Reflect.setPrototypeOf({}, Object.prototype); // true
// On peut modifier le [[Prototype]] d'un objet
// pour que celui-ci soit null.
Reflect.setPrototypeOf({}, null); // true
// La méthode renvoie false si la cible
// n'est pas extensible.
Reflect.setPrototypeOf(Object.freeze({}), null); // false
// La méthode renvoie false si l'affectation
// entraîne un cycle dans la chaîne de prototypes.
var target = {};
var proto = Object.create(target);
Reflect.setPrototypeOf(target, proto); // false
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification> # sec-reflect.setprototypeof> |