Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje