Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Object.isExtensible: či objekt prijíma nové vlastnosti

Object.isExtensible vracia boolean určujúci, či možno objektu stále pridávať nové vlastné vlastnosti.

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

Syntax

Object.isExtensible(obj)

Object.isExtensible(obj) zavolá internú metódu objektu [[IsExtensible]] a vráti jej boolean. Nový bežný objekt je rozšíriteľný. Object.preventExtensions, Object.seal a Object.freeze zmenia stav na false; pri bežnom objekte ho už nemožno obnoviť.

Nerozšíriteľnosť blokuje nové vlastné vlastnosti, sama však nezmrazí existujúce. Existujúca zapisovateľná vlastnosť môže ďalej meniť hodnotu a konfigurovateľná môže byť odstránená alebo zmenená podľa pravidiel deskriptora. false preto neznamená to isté ako Object.isSealed ani Object.isFrozen.

Metóda existuje od ECMAScript 5; od ECMAScript 2015 každá primitívna hodnota jednoducho vráti false namiesto výnimky. Proxy môže spustiť pascu isExtensible, ktorej výsledok sa prevedie na boolean. Musí zodpovedať skutočnému stavu cieľa, inak vznikne TypeError; výnimka pasce sa tiež šíri.

Prí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ýsledok

true false
2 false
false
TypeError

Príklad porovnáva otvorený a uzavretý objekt, mení existujúcu hodnotu, odmietne novú vlastnosť a overí invariant Proxy.

Zdroje