CKTIS / JavaScript
Reflect.preventExtensions — zabránění rozšiřování objektu
Reflect.preventExtensions(target) zabrání přidávání nových vlastních vlastností objektu a vrátí logickou hodnotu. Existující vlastnosti tím nezmrazí a stále může vyvolat výjimky.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Reflect.preventExtensions(target)Reflect.preventExtensions(target) vyvolá interní operaci objektu [[PreventExtensions]]. Pokud operace uspěje, vrátí true, v opačném případě false. Argument musí být objekt; primitivní hodnota včetně null způsobí TypeError. Výjimky z interní operace se předávají dál — logická návratová hodnota neznamená, že výjimky nemohou nastat.
U běžného objektu úspěch trvale zabrání přidávání nových vlastních vlastností, včetně vlastností s klíčem typu Symbol. Opakované volání vrátí true. Nelze také změnit prototyp na jiný. Existující vlastnosti lze dál upravovat nebo mazat, pokud to dovolují jejich deskriptory; vnořené objekty se nemění.
Tato metoda není ekvivalentem Object.seal ani Object.freeze: nemění atributy configurable ani writable. Object.preventExtensions při úspěchu vrátí svůj argument a při návratu false z operace vyvolá TypeError; primitivní hodnoty vrací beze změny. Reflect.preventExtensions místo toho zpřístupňuje logický výsledek a primitivní hodnoty odmítá.
Objekt Proxy může operaci zachytit pomocí pasti preventExtensions. Past ji může odmítnout vrácením false, ale pokud oznámí úspěch, zatímco cílový objekt zůstane rozšiřitelný, způsobí to TypeError. V příkladu Reflect.set ukazuje neúspěšný pokus o přidání vlastnosti bez závislosti na přísném režimu.
Pří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ýsledek
true false false 2 true false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.