CKTIS / JavaScript
Reflect.setPrototypeOf — ustawianie prototypu obiektu
Reflect.setPrototypeOf(target, proto) próbuje ustawić prototyp obiektu i zwraca wynik logiczny. Odróżnia odmowę zmiany od błędnych argumentów, które powodują TypeError.
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.setPrototypeOf(target, proto)Reflect.setPrototypeOf(target, proto) wywołuje wewnętrzną operację [[SetPrototypeOf]] obiektu target. Prototyp służy do wyszukiwania odziedziczonych właściwości; metoda nie kopiuje ich do obiektu. proto musi być obiektem lub null, które oznacza brak prototypu. Nie jest to zmiana właściwości .prototype funkcji.
Wynik true oznacza powodzenie, także gdy wskazany prototyp jest już ustawiony. Wynik false oznacza odmowę. Dla zwykłego obiektu zmiana na inny prototyp po Object.preventExtensions(target) zwraca false. Ponowne ustawienie tego samego prototypu pozostaje dozwolone nawet dla obiektu nierozszerzalnego. Podczas sprawdzania cyklu dla zwykłego obiektu operacja zwraca false, jeśli przechodzenie wzdłuż łańcucha od proto doprowadzi do target. Sprawdzanie zatrzymuje się jednak na obiekcie, który nie używa zwykłej wewnętrznej metody [[GetPrototypeOf]]. Obecność obiektu Proxy w łańcuchu może więc pozwolić na powstanie cyklu, nawet gdy target jest zwykłym obiektem.
Wynik logiczny nie gwarantuje braku wyjątków: prymitywny target lub niedozwolony proto powoduje TypeError. Błędy operacji wewnętrznej, w tym błędy pułapki Proxy, są propagowane. Natomiast Object.setPrototypeOf dla obiektowego target zwraca obiekt po powodzeniu i rzuca TypeError, gdy operacja wewnętrzna zwróci false.
Przykład pokazuje dziedziczenie bez kopiowania oraz różnicę między pozostawieniem prototypu a jego zmianą po zablokowaniu rozszerzania. Specyfikacja języka nie jest tabelą zgodności przeglądarek; samo użycie Node 24 w repozytorium nie potwierdza obsługi w przeglądarce.
Przykłady
const proto = { label: "shared" };
const item = {};
console.log(Reflect.setPrototypeOf(item, proto));
console.log(item.label);
console.log(Object.hasOwn(item, "label"));
Object.preventExtensions(item);
console.log(Reflect.setPrototypeOf(item, proto));
console.log(Reflect.setPrototypeOf(item, null));
console.log(Object.getPrototypeOf(item) === proto);Wynik
true shared false true false true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.