CKTIS / JavaScript
Reflect.getPrototypeOf — odczyt prototypu obiektu
Reflect.getPrototypeOf(target) zwraca bezpośredni prototyp obiektu albo null. Wymaga obiektu: dla wartości prymitywnych zgłasza TypeError zamiast wykonywać konwersję opakowującą, którą stosuje Object.getPrototypeOf.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
Reflect.getPrototypeOf(target)Reflect.getPrototypeOf(target) wywołuje wewnętrzną metodę [[GetPrototypeOf]] argumentu. Dla zwykłego obiektu odczytuje jego bezpośredni prototyp, nie przeszukując całego łańcucha. Wynikiem jest obiekt albo null, oznaczający brak prototypu. Nie jest to odczyt właściwości .prototype, którą mogą mieć funkcje.
Argument target musi być obiektem; funkcje również są obiektami. Każda wartość prymitywna, w tym null i undefined, powoduje TypeError. Pominięcie argumentu także powoduje TypeError, ponieważ jego wartością jest wtedy undefined.
Dla obiektów Object.getPrototypeOf(target) korzysta z tej samej operacji wewnętrznej. Różnica dotyczy wartości prymitywnych: Object.getPrototypeOf opakowuje je w obiekty, z wyjątkiem null i undefined, które odrzuca. Dlatego Object.getPrototypeOf("abc") zwraca String.prototype, natomiast Reflect.getPrototypeOf("abc") zgłasza wyjątek.
W przypadku Proxy odczyt może uruchomić pułapkę getPrototypeOf, więc nie musi być pozbawiony efektów ubocznych. Pułapka musi zwrócić obiekt albo null; dla nieekstensywnego obiektu docelowego wynik musi odpowiadać jego rzeczywistemu prototypowi. Naruszenie tych reguł lub użycie unieważnionego proxy powoduje TypeError; wyjątki z pułapki są przekazywane dalej.
Przykłady
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);
}Wynik
true true true true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.