WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Object.getPrototypeOf: der direkte Prototyp eines Werts

Object.getPrototypeOf liefert den aktuellen direkten Prototyp eines Objekts oder null bei einem Objekt ohne Prototyp.

Version: ECMAScript 5 onward; primitive coercion since ECMAScript 2015; example target: Node.js 24.22.2

Syntax

Object.getPrototypeOf(obj)

Object.getPrototypeOf(obj) führt ToObject aus und ruft die interne Methode [[GetPrototypeOf]] auf. Für ein Objekt liefert es die Referenz auf den direkten Prototyp oder null; es durchläuft nicht die ganze Kette und kopiert nichts. Seit ECMAScript 2015 werden Primitive außer null und undefined verpackt, daher verweist ein String auf String.prototype.

Die Methode eignet sich zum Prüfen von Vererbung, von Object.create(null)-Wörterbüchern und von Klassenobjekten. Die Referenz beschreibt den Zustand beim Aufruf; ein späteres Object.setPrototypeOf kann das nächste Ergebnis ändern. Gewöhnliche Eigenschaften und ihre Getter werden dabei nicht gelesen.

Die Methode existiert seit ECMAScript 5; dort warfen primitive Argumente TypeError. null und undefined werfen weiterhin. Bei einem Proxy kann die getPrototypeOf-Falle laufen; sie muss Objekt oder null liefern und bei nicht erweiterbarem Ziel dessen wirklichen Prototyp melden, sonst entsteht TypeError.

Beispiele

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); }

Ergebnis

true null
true
TypeError
TypeError

Das Beispiel liest gewöhnlichen und Null-Prototyp, zeigt String-Boxing und zwei TypeError-Fälle.

Quellen