WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Reflect.getPrototypeOf — das Prototyp-Objekt auslesen

Reflect.getPrototypeOf(target) gibt das unmittelbare Prototyp-Objekt eines Objekts oder null zurück. Als Argument ist ein Objekt erforderlich: Primitive Werte lösen einen TypeError aus, statt wie bei Object.getPrototypeOf in ein Wrapper-Objekt umgewandelt zu werden.

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

Syntax

Reflect.getPrototypeOf(target)

Reflect.getPrototypeOf(target) ruft die interne Methode [[GetPrototypeOf]] des Arguments auf. Bei einem gewöhnlichen Objekt liest sie dessen unmittelbares Prototyp-Objekt aus, ohne die gesamte Kette zu durchsuchen. Das Ergebnis ist ein Objekt oder null, wenn kein Prototyp vorhanden ist. Dabei wird nicht die Eigenschaft .prototype ausgelesen, die Funktionen haben können.

Das Argument target muss ein Objekt sein; Funktionen sind ebenfalls Objekte. Jeder primitive Wert, einschließlich null und undefined, löst einen TypeError aus. Auch ein ausgelassenes Argument führt zu einem TypeError, da sein Wert dann undefined ist.

Bei Objekten verwendet Object.getPrototypeOf(target) dieselbe interne Operation. Der Unterschied betrifft primitive Werte: Object.getPrototypeOf verpackt sie in Objekte, lehnt aber null und undefined ab. Daher gibt Object.getPrototypeOf("abc") String.prototype zurück, während Reflect.getPrototypeOf("abc") eine Ausnahme auslöst.

Bei einem Proxy kann der Abruf die getPrototypeOf-Falle aufrufen und ist daher nicht unbedingt frei von Seiteneffekten. Die Falle muss ein Objekt oder null zurückgeben; bei einem nicht erweiterbaren Zielobjekt muss das Ergebnis dessen tatsächlichem Prototyp entsprechen. Werden diese Regeln verletzt oder ein widerrufener Proxy verwendet, tritt ein TypeError auf; Ausnahmen aus der Falle werden weitergegeben.

Beispiele

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

Ergebnis

true
true
true
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen