CKTIS / JavaScript
Object.setPrototypeOf — промяна на прототипа на обект
При обикновен обект успешно извикване на `Object.setPrototypeOf(obj, proto)` задава вътрешния му прототип, без да копира свойства, и връща същия обект. `proto` трябва да е обект или `null`. Ако `Proxy` има разширяем целеви обект, прихващащият му метод `setPrototypeOf` може да отчете успех, без да промени прототипа на целевия обект. Извикването все пак връща първоначалния `Proxy`.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
Object.setPrototypeOf(obj, proto)При обикновен обект успешно извикване на Object.setPrototypeOf(obj, proto) задава на вътрешния [[Prototype]] на obj стойността proto. Наследените свойства се търсят по веригата от прототипи, вместо да се копират в обекта. При обикновен обект като този в примера собствените му свойства остават непроменени. Ако obj е обект Proxy с разширяем целеви обект, прихващащият му метод setPrototypeOf може да отчете успех, без да промени прототипа на целевия обект. Извикването все пак връща първоначалния Proxy. Прихващащият метод може също да промени собствените свойства на целевия обект по време на успешно извикване. Извикването на Object.setPrototypeOf не е присвояване на стойност на свойството .prototype на функция.
proto трябва да е обект или null; всяка друга стойност причинява TypeError. Подаването на null или undefined като obj също причинява TypeError. Другите примитивни стойности се връщат непроменени, но едва след проверка на proto. При обект успешно извикване връща точно obj.
Ако при промяна на прототипа на обикновен обект бъде открит цикъл, се хвърля TypeError. Проверката обаче спира при прототип, който не използва обикновената реализация на вътрешния метод [[GetPrototypeOf]], например при обект Proxy. Затова цикъл, който минава през този Proxy, може да остане неоткрит, без да се хвърли TypeError. Опитът за промяна на прототипа на неразширяем обикновен обект причинява TypeError. На обикновен обект може отново да се зададе текущият му прототип, дори ако обектът е неразширяем. Ако обаче Proxy има неразширяем целеви обект, прихващащият му метод setPrototypeOf може да отхвърли операцията дори когато заявеният прототип е текущият прототип на целевия обект. Ако прихващащият метод върне false, Object.setPrototypeOf хвърля TypeError. Някои обекти, включително Object.prototype, имат неизменяем прототип.
Когато прототипът на обект бъде променен на null, предишната верига на наследяване се прекъсва; така обектът може да загуби достъп до наследени методи. Ако прототипът е известен при създаването на обекта, обмислете Object.create(proto) вместо последваща промяна. В примера role се наследява, а name остава собствено свойство.
Примери
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);Резултат
true true reader name true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.