CKTIS / JavaScript
Object.setPrototypeOf — promjena prototipa objekta
Kod običnog objekta uspješan poziv `Object.setPrototypeOf(obj, proto)` postavlja unutarnji prototip bez kopiranja svojstava i vraća isti objekt. `proto` mora biti objekt ili `null`. Ako `Proxy` ima proširiv ciljni objekt, njegova metoda za presretanje `setPrototypeOf` može prijaviti uspjeh bez promjene prototipa ciljnog objekta. Poziv ipak vraća izvorni `Proxy`.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
Object.setPrototypeOf(obj, proto)Kod običnog objekta uspješan poziv Object.setPrototypeOf(obj, proto) postavlja unutarnji [[Prototype]] objekta obj na vrijednost proto. Naslijeđena svojstva traže se u lancu prototipova, a ne kopiraju se u objekt. Kod običnog objekta poput onoga u primjeru vlastita svojstva ostaju nepromijenjena. Ako je obj objekt Proxy s proširivim ciljnim objektom, njegova metoda za presretanje setPrototypeOf može prijaviti uspjeh bez promjene prototipa ciljnog objekta. Poziv ipak vraća izvorni Proxy. Metoda za presretanje može tijekom uspješnog poziva promijeniti i vlastita svojstva ciljnog objekta. Poziv Object.setPrototypeOf nije dodjela vrijednosti svojstvu .prototype funkcije.
proto mora biti objekt ili null; svaka druga vrijednost uzrokuje TypeError. I prosljeđivanje vrijednosti null ili undefined kao obj uzrokuje TypeError. Ostale primitivne vrijednosti vraćaju se nepromijenjene, ali tek nakon provjere proto. Za objekt uspješan poziv vraća upravo obj.
Ako se pri promjeni prototipa običnog objekta otkrije ciklus, dolazi do pogreške TypeError. Međutim, provjera se zaustavlja na prototipu koji ne koristi uobičajenu implementaciju unutarnje metode [[GetPrototypeOf]], primjerice na objektu Proxy. Zato ciklus koji prolazi kroz taj objekt Proxy može ostati neotkriven i ne uzrokovati TypeError. Pokušaj promjene prototipa neproširivog običnog objekta uzrokuje TypeError. Običnom se objektu može ponovno postaviti njegov trenutačni prototip čak i ako objekt nije proširiv. Ako pak Proxy ima neproširiv ciljni objekt, njegova metoda za presretanje setPrototypeOf može odbiti operaciju čak i ako je traženi prototip trenutačni prototip ciljnog objekta. Ako metoda za presretanje vrati false, Object.setPrototypeOf baca pogrešku TypeError. Neki objekti, uključujući Object.prototype, imaju nepromjenjiv prototip.
Kada se prototip objekta promijeni u null, prethodni lanac nasljeđivanja se prekida; objekt tada može izgubiti pristup naslijeđenim metodama. Ako je prototip poznat pri stvaranju objekta, razmotrite Object.create(proto) umjesto naknadne promjene. U primjeru se nasljeđuje role, dok name ostaje vlastito svojstvo.
Primjeri
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);Rezultat
true true reader name true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.