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

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.

Zdroje