CKTIS / JavaScript
Object.getPrototypeOf: bezpośredni prototyp wartości
Object.getPrototypeOf zwraca bieżący bezpośredni prototyp obiektu albo null dla obiektu bez prototypu.
Wersja: ECMAScript 5 onward; primitive coercion since ECMAScript 2015; example target: Node.js 24.22.2
Składnia
Object.getPrototypeOf(obj)Object.getPrototypeOf(obj) wykonuje ToObject i wywołuje wewnętrzne [[GetPrototypeOf]]. Dla obiektu zwraca referencję do jego bezpośredniego prototypu albo null; nie przeszukuje całego łańcucha i nie kopiuje prototypu. Od ECMAScript 2015 wartości pierwotne inne niż null i undefined są opakowywane, więc tekst wskazuje na String.prototype.
Praktycznie metoda służy do rozpoznawania dziedziczenia, obiektów z Object.create(null) i prototypów utworzonych przez klasy. Zwrócona referencja opisuje stan w chwili wywołania; późniejsze Object.setPrototypeOf może zmienić wynik. Odczyt nie pobiera zwykłych właściwości ani nie uruchamia ich getterów.
Metoda istnieje od ECMAScript 5, lecz wtedy argument pierwotny powodował TypeError. Obecnie null i undefined nadal rzucają TypeError. Proxy może uruchomić pułapkę getPrototypeOf; musi ona zwrócić obiekt lub null, a dla nieekstensywnego celu wynik musi być identyczny z rzeczywistym prototypem celu, inaczej powstaje TypeError.
Przykłady
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); }Wynik
true null true TypeError TypeError
Przykład odczytuje zwykły i nullowy prototyp, pokazuje opakowanie tekstu oraz dwa przypadki TypeError.