Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Object.setPrototypeOf — modifier le prototype d’un objet

Pour un objet ordinaire, un appel réussi à `Object.setPrototypeOf(obj, proto)` définit son prototype interne sans copier de propriétés et renvoie le même objet. `proto` doit être un objet ou `null`. Si la cible d’un `Proxy` est extensible, son intercepteur `setPrototypeOf` peut signaler un succès sans modifier le prototype de la cible. L’appel renvoie tout de même le `Proxy` d’origine.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

Object.setPrototypeOf(obj, proto)

Pour un objet ordinaire, un appel réussi à Object.setPrototypeOf(obj, proto) donne au [[Prototype]] interne de obj la valeur proto. Les propriétés héritées sont recherchées dans la chaîne de prototypes, et non copiées dans l’objet. Pour un objet ordinaire comme celui de l’exemple, les propriétés propres restent inchangées. Si obj est un Proxy dont la cible est extensible, son intercepteur setPrototypeOf peut signaler un succès sans modifier le prototype de la cible. L’appel renvoie tout de même le Proxy d’origine. L’intercepteur peut aussi modifier les propriétés propres de la cible au cours d’un appel qui réussit. Un appel à Object.setPrototypeOf n’est pas une affectation à la propriété .prototype d’une fonction.

proto doit être un objet ou null ; toute autre valeur provoque une TypeError. Passer null ou undefined comme obj provoque également une TypeError. Les autres valeurs primitives sont renvoyées sans modification, mais seulement après validation de proto. Pour un objet, un appel réussi renvoie exactement obj.

Lors de la modification du prototype d’un objet ordinaire, la détection d’un cycle provoque une TypeError. La vérification s’arrête toutefois à un prototype qui n’utilise pas l’implémentation ordinaire de la méthode interne [[GetPrototypeOf]], comme un Proxy. Un cycle passant par ce Proxy peut donc ne pas être détecté et ne pas provoquer de TypeError. Tenter de modifier le prototype d’un objet ordinaire non extensible provoque une TypeError. Pour un objet ordinaire, redéfinir le prototype à sa valeur actuelle est autorisé même si l’objet n’est pas extensible. En revanche, si la cible d’un Proxy n’est pas extensible, son intercepteur setPrototypeOf peut refuser l’opération même si le prototype demandé est le prototype actuel de la cible. Si l’intercepteur renvoie false, Object.setPrototypeOf lève une TypeError. Certains objets, dont Object.prototype, ont un prototype immuable.

Lorsque le prototype d’un objet est remplacé par null, l’ancienne chaîne d’héritage est rompue ; l’objet peut alors perdre l’accès aux méthodes héritées. Si le prototype est connu lors de la création de l’objet, envisagez Object.create(proto) plutôt que de le modifier ensuite. Dans l’exemple, role est hérité tandis que name reste une propriété propre.

Exemples

const proto = { role: "reader" };
const user = { name: "Ada" };
const result = Object.setPrototypeOf(user, proto);

console.log(result === user);
console.log(Object.getPrototypeOf(user) === proto);
console.log(user.role);
console.log(Object.getOwnPropertyNames(user).join(","));

Object.setPrototypeOf(user, null);
console.log(user.role === undefined);

Résultat

true
true
reader
name
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources