Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła