Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje