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

CKTIS / JavaScript

Object.isExtensible: zda objekt přijímá nové vlastnosti

Object.isExtensible vrací boolean určující, zda lze objektu stále přidávat nové vlastní vlastnosti.

Verze: ECMAScript 5 onward; primitives return false since ECMAScript 2015; example target: Node.js 24.22.2

Syntaxe

Object.isExtensible(obj)

Object.isExtensible(obj) zavolá interní metodu objektu [[IsExtensible]] a vrátí její boolean. Nový běžný objekt je rozšiřitelný. Object.preventExtensions, Object.seal a Object.freeze změní stav na false; u běžného objektu jej už nelze obnovit.

Nerozšiřitelnost blokuje nové vlastní vlastnosti, sama však nezmrazí existující. Stávající zapisovatelná vlastnost může dál měnit hodnotu a konfigurovatelná může být odstraněna nebo změněna podle pravidel deskriptoru. false proto neznamená totéž co Object.isSealed ani Object.isFrozen.

Metoda existuje od ECMAScript 5; od ECMAScript 2015 každá primitivní hodnota jednoduše vrátí false místo výjimky. Proxy může spustit past isExtensible, jejíž výsledek se převede na boolean. Musí odpovídat skutečnému stavu cíle, jinak vznikne TypeError; výjimka pasti se také šíří.

Příklady

const open = { value: 1 };
const closed = Object.preventExtensions({ value: 1 });

console.log(Object.isExtensible(open), Object.isExtensible(closed));
closed.value = 2;
console.log(closed.value, Reflect.defineProperty(closed, "extra", { value: 3 }));
console.log(Object.isExtensible(7));

const proxy = new Proxy(closed, { isExtensible() { return true; } });
try { Object.isExtensible(proxy); } catch (error) { console.log(error.name); }

Výsledek

true false
2 false
false
TypeError

Příklad porovnává otevřený a uzavřený objekt, mění existující hodnotu, odmítne novou vlastnost a ověří invariant Proxy.

Zdroje