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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.