Reflect.setPrototypeOf()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 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

Syntaxe

js
Reflect.setPrototypeOf(cible, prototype);

Paramètres

cible

L'objet cible dont on souhaite modifier le prototype.

prototype

Le nouveau prototype à appliquer à l'objet cible (ça peut être un objet ou null).

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()

js
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 Language Specification
# sec-reflect.setprototypeof

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi