База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Reflect.setPrototypeOf — задаване на прототипа на обект

Reflect.setPrototypeOf(target, proto) се опитва да зададе прототипа на обект и връща булева стойност. Така отказана промяна се различава от невалидни аргументи, които причиняват TypeError.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

Reflect.setPrototypeOf(target, proto)

Reflect.setPrototypeOf(target, proto) извиква вътрешната операция [[SetPrototypeOf]] на обекта target. Прототипът се използва за търсене на наследени свойства; методът не ги копира в обекта. proto трябва да е обект или null, което означава, че няма прототип. Това не променя свойството .prototype на функция.

Резултатът true означава успех, включително когато зададеният прототип вече е установен. Резултатът false означава отказ. При обикновен обект смяната с друг прототип след Object.preventExtensions(target) връща false. Повторното задаване на същия прототип остава позволено дори за обект, който не може да се разширява. При проверка за цикъл за обикновен обект операцията връща false, ако при обхождане на веригата от proto достигне до target. Проверката обаче спира, щом срещне обект, който не използва обикновения вътрешен метод [[GetPrototypeOf]]. Затова обект Proxy във веригата може да позволи образуването на цикъл, дори когато target е обикновен обект.

Булевият резултат не гарантира липса на изключения: примитивен target или невалиден proto причинява TypeError. Грешките от вътрешната операция, включително грешките от капан на Proxy, се предават нататък. За разлика от това, когато target е обект, Object.setPrototypeOf връща обекта при успех и хвърля TypeError, ако вътрешната операция върне false.

Примерът показва наследяване без копиране и разликата между запазване и промяна на прототипа след забрана на разширяването. Спецификацията на езика не е таблица за съвместимост с браузъри; използването на Node 24 в хранилище не доказва поддръжка в браузърите.

Примери

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);

Резултат

true
shared
false
true
false
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници