CKTIS / JavaScript
Reflect.getPrototypeOf — lire le prototype d’un objet
Reflect.getPrototypeOf(target) renvoie le prototype immédiat d’un objet ou null. L’argument doit être un objet : les valeurs primitives déclenchent une TypeError au lieu d’être converties en objet enveloppe comme avec Object.getPrototypeOf.
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.getPrototypeOf(target)Reflect.getPrototypeOf(target) appelle la méthode interne [[GetPrototypeOf]] de l’argument. Pour un objet ordinaire, elle lit son prototype immédiat sans parcourir toute la chaîne. Le résultat est un objet ou null, qui indique l’absence de prototype. Il ne s’agit pas de lire la propriété .prototype que peuvent posséder les fonctions.
L’argument target doit être un objet ; les fonctions sont également des objets. Toute valeur primitive, y compris null et undefined, déclenche une TypeError. Omettre l’argument déclenche aussi une TypeError, car sa valeur est alors undefined.
Pour les objets, Object.getPrototypeOf(target) utilise la même opération interne. La différence concerne les valeurs primitives : Object.getPrototypeOf les enveloppe dans des objets, mais rejette null et undefined. Ainsi, Object.getPrototypeOf("abc") renvoie String.prototype, tandis que Reflect.getPrototypeOf("abc") déclenche une exception.
Avec un Proxy, la lecture peut appeler le piège getPrototypeOf et n’est donc pas nécessairement sans effets de bord. Le piège doit renvoyer un objet ou null ; pour une cible non extensible, le résultat doit correspondre à son prototype réel. Enfreindre ces règles ou utiliser un proxy révoqué déclenche une TypeError ; les exceptions du piège sont propagées.
Exemples
const proto = { role: "base" };
const item = Object.create(proto);
console.log(Reflect.getPrototypeOf(item) === proto);
console.log(Reflect.getPrototypeOf(Object.create(null)) === null);
console.log(Object.getPrototypeOf("abc") === String.prototype);
try {
Reflect.getPrototypeOf("abc");
} catch (error) {
console.log(error instanceof TypeError);
}Résultat
true true true 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.