Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje