CKTIS / JavaScript
Reflect.isExtensible — kontrola rozšiřitelnosti objektu
Reflect.isExtensible(target) kontroluje, zda je objekt rozšiřitelný. U běžného objektu to znamená, že do něj lze přidávat nové vlastní vlastnosti. Metoda vrací logickou hodnotu a pro primitivní hodnoty vyvolá TypeError.
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.isExtensible(target)Reflect.isExtensible(target) vrací true, pokud je objekt rozšiřitelný, a false, pokud není. U běžného objektu rozšiřitelnost znamená, že do něj lze přidávat nové vlastní vlastnosti. Metoda tento stav zjišťuje, ale sama ho nemění.
Object.preventExtensions(target) zabrání přidávání nových vlastních vlastností. Také Object.seal(target) a Object.freeze(target) způsobí, že objekty nejsou rozšiřitelné, ale přidávají další omezení. Hodnota false tedy neznamená, že je objekt zmrazený: existující zapisovatelné vlastnosti lze stále měnit a konfigurovatelné vlastnosti lze stále mazat. Běžný objekt nelze znovu učinit rozšiřitelným.
Argument musí být objekt; i pole a funkce patří mezi objekty. Primitivní hodnoty včetně null a undefined způsobí TypeError. To je důležitý rozdíl oproti Object.isExtensible(target), která u primitivních hodnot vrací false místo vyvolání chyby.
Metoda volá interní operaci [[IsExtensible]]. U Proxy může vyvolat past isExtensible, proto nepředpokládejte, že volání nemá vedlejší účinky. Po převodu na logickou hodnotu musí výsledek pasti odpovídat skutečné rozšiřitelnosti cílového objektu; jinak dojde k chybě TypeError. Odvolaný proxy také způsobí TypeError.
Příklady
const item = { count: 1 };
console.log(Reflect.isExtensible(item));
Object.preventExtensions(item);
console.log(Reflect.isExtensible(item));
console.log(Reflect.set(item, "extra", 10));
item.count = 2;
console.log(item.count);
try {
Reflect.isExtensible(42);
} catch (error) {
console.log(error.name);
}Výsledek
true false false 2 TypeError
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.