CKTIS / JavaScript
Object.getPrototypeOf : prototype immédiat d’une valeur
Object.getPrototypeOf renvoie le prototype immédiat courant d’un objet, ou null pour un objet sans prototype.
Version : ECMAScript 5 onward; primitive coercion since ECMAScript 2015; example target: Node.js 24.22.2
Syntaxe
Object.getPrototypeOf(obj)Object.getPrototypeOf(obj) applique ToObject puis appelle la méthode interne [[GetPrototypeOf]]. Pour un objet, il renvoie la référence du prototype immédiat ou null ; il ne parcourt pas toute la chaîne et ne copie rien. Depuis ECMAScript 2015, les primitives sauf null et undefined sont encapsulées : une chaîne mène donc à String.prototype.
La méthode sert à inspecter l’héritage, reconnaître les dictionnaires Object.create(null) ou examiner les objets de classe. La référence décrit l’état lors de l’appel ; un Object.setPrototypeOf ultérieur peut changer le prochain résultat. Aucune propriété ordinaire ni aucun getter n’est lu.
La méthode existe depuis ECMAScript 5, où les primitives levaient TypeError. null et undefined le lèvent encore. Un Proxy peut exécuter son piège getPrototypeOf ; il doit renvoyer un objet ou null et, si la cible n’est pas extensible, son véritable prototype, sinon TypeError est levé.
Exemples
const proto = { kind: "record" };
const value = Object.create(proto);
const root = Object.create(null);
console.log(Object.getPrototypeOf(value) === proto, Object.getPrototypeOf(root));
console.log(Object.getPrototypeOf("x") === String.prototype);
const fixed = Object.preventExtensions({});
const proxy = new Proxy(fixed, { getPrototypeOf() { return null; } });
try { Object.getPrototypeOf(proxy); } catch (error) { console.log(error.name); }
try { Object.getPrototypeOf(null); } catch (error) { console.log(error.name); }Résultat
true null true TypeError TypeError
L’exemple lit un prototype ordinaire et nul, montre l’encapsulation de chaîne et deux cas TypeError.