Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Object.setPrototypeOf — spreminjanje prototipa objekta

Pri običajnem objektu uspešen klic `Object.setPrototypeOf(obj, proto)` nastavi notranji prototip brez kopiranja lastnosti in vrne isti objekt. `proto` mora biti objekt ali `null`. Če ima `Proxy` razširljiv ciljni objekt, lahko njegova prestrezna metoda `setPrototypeOf` sporoči uspeh, ne da bi spremenila prototip ciljnega objekta. Klic kljub temu vrne prvotni `Proxy`.

Različica: 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)

Pri običajnem objektu uspešen klic Object.setPrototypeOf(obj, proto) nastavi notranji [[Prototype]] objekta obj na vrednost proto. Podedovane lastnosti se iščejo po verigi prototipov, namesto da bi se kopirale v objekt. Pri običajnem objektu, kakršen je v primeru, ostanejo lastne lastnosti nespremenjene. Če je obj objekt Proxy z razširljivim ciljnim objektom, lahko njegova prestrezna metoda setPrototypeOf sporoči uspeh, ne da bi spremenila prototip ciljnega objekta. Klic kljub temu vrne prvotni Proxy. Prestrezna metoda lahko med uspešnim klicem tudi spremeni lastne lastnosti ciljnega objekta. Klic Object.setPrototypeOf ne pomeni prirejanja vrednosti lastnosti .prototype funkcije.

proto mora biti objekt ali null; katera koli druga vrednost povzroči TypeError. Tudi null ali undefined kot obj povzroči TypeError. Druge primitivne vrednosti se vrnejo nespremenjene, vendar šele po preverjanju proto. Pri objektu uspešen klic vrne natanko obj.

Če se pri spreminjanju prototipa običajnega objekta zazna cikel, pride do napake TypeError. Preverjanje pa se ustavi pri prototipu, ki ne uporablja običajne implementacije notranje metode [[GetPrototypeOf]], na primer pri objektu Proxy. Cikel, ki poteka prek tega objekta Proxy, lahko zato ostane nezaznan in ne povzroči napake TypeError. Poskus spreminjanja prototipa nerazširljivega običajnega objekta povzroči TypeError. Pri običajnem objektu je mogoče znova nastaviti trenutni prototip, tudi če objekt ni razširljiv. Če pa ima Proxy nerazširljiv ciljni objekt, lahko njegova prestrezna metoda setPrototypeOf zavrne operacijo, tudi če je zahtevani prototip trenutni prototip ciljnega objekta. Če prestrezna metoda vrne false, Object.setPrototypeOf sproži napako TypeError. Nekateri objekti, vključno z Object.prototype, imajo nespremenljiv prototip.

Ko se prototip objekta spremeni v null, se prejšnja veriga dedovanja prekine; objekt lahko zato izgubi dostop do podedovanih metod. Če je prototip znan ob ustvarjanju objekta, razmislite o uporabi Object.create(proto) namesto poznejše spremembe. V primeru je role podedovan, name pa ostane lastna lastnost.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri