CKTIS / JavaScript
Reflect.setPrototypeOf — nastavení prototypu objektu
Reflect.setPrototypeOf(target, proto) se pokusí nastavit prototyp objektu a vrátí logickou hodnotu. Odmítnutou změnu tak lze odlišit od neplatných argumentů, které způsobí TypeError.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Reflect.setPrototypeOf(target, proto)Reflect.setPrototypeOf(target, proto) zavolá interní operaci [[SetPrototypeOf]] objektu target. Prototyp slouží k vyhledávání zděděných vlastností; metoda je do objektu nekopíruje. proto musí být objekt nebo null, což znamená, že objekt nemá prototyp. Tím se nemění vlastnost .prototype funkce.
Výsledek true znamená úspěch, a to i tehdy, když je požadovaný prototyp už nastaven. Výsledek false znamená odmítnutí. U běžného objektu vrací změna na jiný prototyp po zavolání Object.preventExtensions(target) hodnotu false. Opětovné nastavení stejného prototypu zůstává povoleno i u objektu, který nelze rozšiřovat. Při kontrole cyklu u běžného objektu operace vrátí false, pokud při průchodu řetězcem od proto narazí na target. Kontrola se však zastaví u objektu, který nepoužívá běžnou interní metodu [[GetPrototypeOf]]. Objekt Proxy v řetězci tedy může umožnit vznik cyklu, i když je target běžný objekt.
Logická návratová hodnota nezaručuje, že nedojde k výjimce: primitivní target nebo neplatný proto způsobí TypeError. Chyby interní operace, včetně chyb pasti Proxy, se předávají dál. Naproti tomu Object.setPrototypeOf při objektovém target vrátí při úspěchu objekt a vyvolá TypeError, pokud interní operace vrátí false.
Příklad ukazuje dědění bez kopírování a rozdíl mezi zachováním a změnou prototypu po zakázání rozšiřování. Jazyková specifikace není tabulka kompatibility prohlížečů; použití Node 24 v repozitáři nepotvrzuje podporu v prohlížečích.
Pří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ýsledek
true shared false true false true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.