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.