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

CKTIS / JavaScript

Object.setPrototypeOf — změna prototypu objektu

U běžného objektu úspěšné volání `Object.setPrototypeOf(obj, proto)` nastaví interní prototyp bez kopírování vlastností a vrátí tentýž objekt. `proto` musí být objekt nebo `null`. Pokud má `Proxy` rozšiřitelný cílový objekt, jeho zachytávací metoda `setPrototypeOf` může ohlásit úspěch, aniž by změnila prototyp cíle. Volání přesto vrátí původní `Proxy`.

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

Object.setPrototypeOf(obj, proto)

U běžného objektu úspěšné volání Object.setPrototypeOf(obj, proto) nastaví interní [[Prototype]] objektu obj na hodnotu proto. Zděděné vlastnosti se vyhledávají v řetězci prototypů, místo aby se kopírovaly do objektu. U běžného objektu, jako je ten v příkladu, zůstávají jeho vlastní vlastnosti beze změny. Pokud je obj objektem Proxy s rozšiřitelným cílovým objektem, může jeho zachytávací metoda setPrototypeOf ohlásit úspěch, aniž by změnila prototyp cíle. Volání přesto vrátí původní Proxy. Zachytávací metoda může během úspěšného volání také změnit vlastní vlastnosti cíle. Volání Object.setPrototypeOf není přiřazením do vlastnosti .prototype funkce.

proto musí být objekt nebo null; jakákoli jiná hodnota způsobí TypeError. Také předání null nebo undefined jako obj způsobí TypeError. Ostatní primitivní hodnoty se vrátí beze změny, ale až po ověření proto. U objektu úspěšné volání vrátí přesně obj.

Pokud se při změně prototypu běžného objektu zjistí cyklus, vyvolá se TypeError. Kontrola se však zastaví u prototypu, který nepoužívá běžnou implementaci interní metody [[GetPrototypeOf]], například u objektu Proxy. Cyklus procházející tímto objektem Proxy tak může zůstat nezjištěn, aniž by došlo k chybě TypeError. Pokus o změnu prototypu nerozšiřitelného běžného objektu vyvolá TypeError. U běžného objektu lze znovu nastavit stávající prototyp, i když objekt není rozšiřitelný. U objektu Proxy s nerozšiřitelným cílovým objektem však zachytávací metoda setPrototypeOf může operaci odmítnout, i když je požadovaný prototyp totožný s aktuálním prototypem cíle. Pokud tato metoda vrátí false, Object.setPrototypeOf vyvolá TypeError. Některé objekty, včetně Object.prototype, mají neměnný prototyp.

Změní-li se prototyp objektu na null, dosavadní řetězec dědičnosti se přeruší; objekt pak může ztratit přístup ke zděděným metodám. Pokud je prototyp známý při vytváření objektu, zvažte místo pozdější změny použití Object.create(proto). V příkladu se dědí role, zatímco name zůstává vlastní vlastností.

Pří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ýsledek

true
true
reader
name
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