CKTIS / JavaScript
Reflect.preventExtensions — zabránenie rozširovaniu objektu
Reflect.preventExtensions(target) zabráni pridávaniu nových vlastných vlastností objektu a vráti logickú hodnotu. Existujúce vlastnosti tým nezmrazí a stále môže vyvolať výnimky.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
Reflect.preventExtensions(target)Reflect.preventExtensions(target) vyvolá internú operáciu objektu [[PreventExtensions]]. Ak operácia uspeje, vráti true, inak false. Argument musí byť objekt; primitívna hodnota vrátane null spôsobí TypeError. Výnimky z internej operácie sa odovzdávajú ďalej — logická návratová hodnota neznamená, že výnimky nemôžu nastať.
Pri bežnom objekte úspech natrvalo zabráni pridávaniu nových vlastných vlastností vrátane vlastností s kľúčom typu Symbol. Opakované volanie vráti true. Prototyp tiež nemožno zmeniť na iný. Existujúce vlastnosti možno naďalej upravovať alebo odstraňovať, ak to ich deskriptory umožňujú; vnorené objekty sa nemenia.
Táto metóda nie je ekvivalentom Object.seal ani Object.freeze: nemení atribúty configurable ani writable. Object.preventExtensions pri úspechu vráti svoj argument a pri návrate false z operácie vyvolá TypeError; primitívne hodnoty vracia bez zmeny. Reflect.preventExtensions namiesto toho sprístupňuje logický výsledok a primitívne hodnoty odmieta.
Objekt Proxy môže operáciu zachytiť pomocou pasce preventExtensions. Pasca ju môže odmietnuť vrátením false, no ak oznámi úspech, zatiaľ čo cieľový objekt zostane rozšíriteľný, spôsobí to TypeError. V príklade Reflect.set ukazuje neúspešný pokus o pridanie vlastnosti bez závislosti od prísneho režimu.
Príklady
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"));Výsledok
true false false 2 true false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.