CKTIS / JavaScript
Reflect.preventExtensions — предотвратяване на разширяването на обект
Reflect.preventExtensions(target) предотвратява добавянето на нови собствени свойства към обект и връща булева стойност. Не замразява съществуващите свойства и все още може да възникнат изключения.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
Reflect.preventExtensions(target)Reflect.preventExtensions(target) извиква вътрешната операция [[PreventExtensions]] на обекта. Връща true, ако операцията успее, или false, ако бъде отказана. Аргументът трябва да е обект; примитивна стойност, включително null, причинява TypeError. Изключенията от вътрешната операция се предават нататък — булевият резултат не означава, че изключения са невъзможни.
При обикновен обект успехът трайно предотвратява добавянето на нови собствени свойства, включително такива с ключове от тип Symbol. Повторно извикване връща true. Прототипът също не може да бъде сменен с друг. Съществуващите свойства все още могат да се променят или изтриват, ако техните дескриптори го позволяват; вложените обекти не се променят.
Това не е равностойно на Object.seal или Object.freeze: методът не променя атрибутите configurable или writable. Object.preventExtensions връща аргумента си при успех и предизвиква TypeError, когато операцията върне false; примитивните стойности връща непроменени. Вместо това Reflect.preventExtensions предоставя булевия резултат и отхвърля примитивни стойности.
Обект Proxy може да прихване операцията чрез капана preventExtensions. Капанът може да откаже, като върне false, но съобщаването за успех, докато целевият обект все още е разширяем, причинява TypeError. В примера Reflect.set показва неуспешен опит за добавяне на свойство, без да зависи от строгия режим.
Примери
const item = { count: 1 };
console.log(Reflect.preventExtensions(item));
console.log(Reflect.isExtensible(item));
console.log(Reflect.set(item, "extra", 10));
item.count = 2;
console.log(item.count);
console.log(Reflect.deleteProperty(item, "count"));
console.log(Reflect.has(item, "count"));Резултат
true false false 2 true false
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.