Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Object.setPrototypeOf — zmena prototypu objektu

Pri bežnom objekte úspešné volanie `Object.setPrototypeOf(obj, proto)` nastaví interný prototyp bez kopírovania vlastností a vráti ten istý objekt. `proto` musí byť objekt alebo `null`. Ak má `Proxy` rozšíriteľný cieľový objekt, jeho zachytávacia metóda `setPrototypeOf` môže oznámiť úspech bez zmeny prototypu cieľa. Volanie aj vtedy vráti pôvodný `Proxy`.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

Object.setPrototypeOf(obj, proto)

Pri bežnom objekte úspešné volanie Object.setPrototypeOf(obj, proto) nastaví interný [[Prototype]] objektu obj na hodnotu proto. Zdedené vlastnosti sa vyhľadávajú v reťazci prototypov namiesto toho, aby sa kopírovali do objektu. Pri bežnom objekte, aký je v príklade, zostávajú jeho vlastné vlastnosti nezmenené. Ak je obj objektom Proxy s rozšíriteľným cieľovým objektom, jeho zachytávacia metóda setPrototypeOf môže oznámiť úspech bez zmeny prototypu cieľa. Volanie aj vtedy vráti pôvodný Proxy. Zachytávacia metóda môže počas úspešného volania aj zmeniť vlastné vlastnosti cieľa. Volanie Object.setPrototypeOf nie je priradením do vlastnosti .prototype funkcie.

proto musí byť objekt alebo null; akákoľvek iná hodnota spôsobí TypeError. Aj odovzdanie null alebo undefined ako obj spôsobí TypeError. Ostatné primitívne hodnoty sa vrátia nezmenené, ale až po overení proto. Pri objekte úspešné volanie vráti presne obj.

Ak sa pri zmene prototypu bežného objektu zistí cyklus, vyvolá sa TypeError. Kontrola sa však zastaví pri prototype, ktorý nepoužíva bežnú implementáciu internej metódy [[GetPrototypeOf]], napríklad pri objekte Proxy. Cyklus prechádzajúci týmto objektom Proxy tak môže zostať nezistený bez toho, aby vyvolal TypeError. Pokus o zmenu prototypu nerozšíriteľného bežného objektu vyvolá TypeError. Pri bežnom objekte možno znova nastaviť jeho aktuálny prototyp, aj keď objekt nie je rozšíriteľný. Pri objekte Proxy s nerozšíriteľným cieľovým objektom však zachytávacia metóda setPrototypeOf môže operáciu odmietnuť, aj keď je požadovaný prototyp totožný s aktuálnym prototypom cieľa. Ak táto metóda vráti false, Object.setPrototypeOf vyvolá TypeError. Niektoré objekty vrátane Object.prototype majú nemenný prototyp.

Keď sa prototyp objektu zmení na null, predchádzajúci reťazec dedenia sa preruší; objekt tak môže stratiť prístup k zdedeným metódam. Ak je prototyp známy pri vytváraní objektu, zvážte použitie Object.create(proto) namiesto jeho neskoršej zmeny. V príklade sa dedí role, zatiaľ čo name zostáva vlastnou vlastnosťou.

Príklady

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);

Výsledok

true
true
reader
name
true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje