CKTIS / JavaScript
Reflect.setPrototypeOf — définir le prototype d’un objet
Reflect.setPrototypeOf(target, proto) tente de définir le prototype d’un objet et renvoie un booléen. Cela permet de distinguer un changement refusé d’arguments invalides, qui provoquent une TypeError.
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
Reflect.setPrototypeOf(target, proto)Reflect.setPrototypeOf(target, proto) appelle l’opération interne [[SetPrototypeOf]] de l’objet target. Le prototype sert à rechercher les propriétés héritées ; la méthode ne les copie pas dans l’objet. proto doit être un objet ou null, qui signifie l’absence de prototype. Cela ne modifie pas la propriété .prototype d’une fonction.
Le résultat true indique une réussite, y compris lorsque le prototype demandé est déjà défini. Le résultat false indique un refus. Pour un objet ordinaire, le passage à un autre prototype après Object.preventExtensions(target) renvoie false. Redéfinir le même prototype reste autorisé, même pour un objet non extensible. Lors de la recherche d’un cycle pour un objet ordinaire, l’opération renvoie false si le parcours de la chaîne à partir de proto atteint target. La recherche s’arrête toutefois dès qu’elle rencontre un objet qui n’utilise pas la méthode interne ordinaire [[GetPrototypeOf]]. La présence d’un Proxy dans la chaîne peut donc permettre la formation d’un cycle, même si target est un objet ordinaire.
Un résultat booléen ne garantit pas l’absence d’exceptions : un target primitif ou un proto invalide provoque une TypeError. Les erreurs de l’opération interne, y compris celles d’un piège Proxy, sont propagées. En revanche, avec un target objet, Object.setPrototypeOf renvoie l’objet en cas de réussite et lance une TypeError lorsque l’opération interne renvoie false.
L’exemple montre l’héritage sans copie et la différence entre conserver et modifier le prototype après avoir empêché les extensions. La spécification du langage n’est pas un tableau de compatibilité des navigateurs ; utiliser Node 24 dans un dépôt ne prouve pas la prise en charge par les navigateurs.
Exemples
const proto = { label: "shared" };
const item = {};
console.log(Reflect.setPrototypeOf(item, proto));
console.log(item.label);
console.log(Object.hasOwn(item, "label"));
Object.preventExtensions(item);
console.log(Reflect.setPrototypeOf(item, proto));
console.log(Reflect.setPrototypeOf(item, null));
console.log(Object.getPrototypeOf(item) === proto);Résultat
true shared false true false 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.