CKTIS / JavaScript
Reflect.setPrototypeOf — nastavenie prototypu objektu
Reflect.setPrototypeOf(target, proto) sa pokúsi nastaviť prototyp objektu a vráti logickú hodnotu. Odmietnutú zmenu tak možno odlíšiť od neplatných argumentov, ktoré spôsobia TypeError.
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
Reflect.setPrototypeOf(target, proto)Reflect.setPrototypeOf(target, proto) zavolá internú operáciu [[SetPrototypeOf]] objektu target. Prototyp slúži na vyhľadávanie zdedených vlastností; metóda ich do objektu nekopíruje. proto musí byť objekt alebo null, čo znamená, že objekt nemá prototyp. Tým sa nemení vlastnosť .prototype funkcie.
Výsledok true znamená úspech, aj keď je požadovaný prototyp už nastavený. Výsledok false znamená odmietnutie. Pri bežnom objekte vráti zmena na iný prototyp po zavolaní Object.preventExtensions(target) hodnotu false. Opätovné nastavenie rovnakého prototypu zostáva povolené aj pri objekte, ktorý nemožno rozširovať. Pri kontrole cyklu pri bežnom objekte operácia vráti false, ak pri prechode reťazcom od proto narazí na target. Kontrola sa však zastaví pri objekte, ktorý nepoužíva bežnú internú metódu [[GetPrototypeOf]]. Objekt Proxy v reťazci tak môže umožniť vznik cyklu, aj keď je target bežný objekt.
Logická návratová hodnota nezaručuje, že nedôjde k výnimke: primitívny target alebo neplatný proto spôsobí TypeError. Chyby internej operácie vrátane chýb pasce Proxy sa propagujú. Naopak, Object.setPrototypeOf pri objektovom target v prípade úspechu vráti objekt a vyvolá TypeError, ak interná operácia vráti false.
Príklad ukazuje dedenie bez kopírovania a rozdiel medzi zachovaním a zmenou prototypu po zakázaní rozširovania. Jazyková špecifikácia nie je tabuľka kompatibility prehliadačov; použitie Node 24 v repozitári nepotvrdzuje podporu v prehliadačoch.
Príklady
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);Výsledok
true shared false true false true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.