Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Object.setPrototypeOf — zmiana prototypu obiektu

W przypadku zwykłego obiektu udane wywołanie `Object.setPrototypeOf(obj, proto)` ustawia jego wewnętrzny prototyp bez kopiowania właściwości i zwraca ten sam obiekt. `proto` musi być obiektem albo `null`. Jeśli `obj` jest obiektem `Proxy` z rozszerzalnym obiektem docelowym, jego pułapka `setPrototypeOf` może zgłosić powodzenie bez zmiany prototypu obiektu docelowego. Wywołanie zwraca wtedy ten sam obiekt `Proxy`.

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

Object.setPrototypeOf(obj, proto)

W przypadku zwykłego obiektu udane wywołanie Object.setPrototypeOf(obj, proto) ustawia wewnętrzny [[Prototype]] obiektu obj na proto. Dziedziczone właściwości są wyszukiwane w łańcuchu prototypów, a nie kopiowane do obiektu. Właściwości własne zwykłego obiektu, takiego jak w przykładzie, pozostają niezmienione. Jeśli obj jest obiektem Proxy z rozszerzalnym obiektem docelowym, jego pułapka setPrototypeOf może zgłosić powodzenie bez zmiany prototypu obiektu docelowego. Wywołanie zwraca wtedy ten sam obiekt Proxy. Pułapka może też w trakcie udanego wywołania zmienić właściwości własne obiektu docelowego. Wywołanie Object.setPrototypeOf nie jest przypisaniem do właściwości .prototype funkcji.

proto musi być obiektem albo null; inna wartość powoduje TypeError. null i undefined jako obj również powodują TypeError. Pozostałe wartości pierwotne są zwracane bez zmian, ale dopiero po sprawdzeniu poprawności proto. Dla obiektu udane wywołanie zwraca dokładnie obj.

Przy zmianie prototypu zwykłego obiektu wykrycie cyklu powoduje TypeError. Sprawdzanie kończy się jednak na prototypie, który nie używa zwykłej implementacji wewnętrznej metody [[GetPrototypeOf]], na przykład na obiekcie Proxy. Cykl przebiegający przez taki obiekt Proxy może więc pozostać niewykryty i nie spowodować TypeError. Próba zmiany prototypu zwykłego obiektu nierozszerzalnego powoduje TypeError. Ustawienie dotychczasowego prototypu zwykłego obiektu jest dozwolone nawet wtedy, gdy obiekt jest nierozszerzalny. Natomiast w przypadku obiektu Proxy z nierozszerzalnym obiektem docelowym pułapka setPrototypeOf może odrzucić operację nawet wtedy, gdy żądany prototyp jest bieżącym prototypem obiektu docelowego. Jeśli pułapka zwróci false, Object.setPrototypeOf zgłosi TypeError. Niektóre obiekty, w tym Object.prototype, mają niezmienny prototyp.

Gdy prototyp obiektu zostanie zmieniony na null, dotychczasowy łańcuch dziedziczenia zostaje odłączony; obiekt może wtedy utracić dostęp do odziedziczonych metod. Jeśli prototyp jest znany przy tworzeniu obiektu, rozważ Object.create(proto) zamiast późniejszej zmiany. W przykładzie role jest dziedziczone, natomiast name pozostaje właściwością własną.

Przykłady

const proto = { role: "reader" };
const user = { name: "Ada" };
const result = Object.setPrototypeOf(user, proto);

console.log(result === user);
console.log(Object.getPrototypeOf(user) === proto);
console.log(user.role);
console.log(Object.getOwnPropertyNames(user).join(","));

Object.setPrototypeOf(user, null);
console.log(user.role === undefined);

Wynik

true
true
reader
name
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła