CKTIS / JavaScript
Object.isExtensible: of een object nieuwe eigenschappen accepteert
Object.isExtensible retourneert een boolean die aangeeft of nog nieuwe eigen eigenschappen aan een object kunnen worden toegevoegd.
Versie: ECMAScript 5 onward; primitives return false since ECMAScript 2015; example target: Node.js 24.22.2
Syntax
Object.isExtensible(obj)Object.isExtensible(obj) roept de interne methode [[IsExtensible]] van het object aan en retourneert de boolean. Een nieuw gewoon object is uitbreidbaar. Object.preventExtensions, Object.seal en Object.freeze zetten deze toestand op false; bij een gewoon object kan die niet worden hersteld.
Niet-uitbreidbaarheid blokkeert nieuwe eigen eigenschappen, maar bevriest bestaande niet vanzelf. Een bestaande schrijfbare eigenschap kan nog wijzigen en een configureerbare kan binnen haar descriptorregels worden verwijderd of aangepast. false is dus niet gelijk aan Object.isSealed of Object.isFrozen.
De methode bestaat sinds ECMAScript 5; sinds ECMAScript 2015 retourneert elke primitieve waarde gewoon false in plaats van te werpen. Een Proxy kan de isExtensible-trap uitvoeren, waarvan het resultaat boolean wordt. Dit moet overeenkomen met de werkelijke toestand van het doel, anders volgt TypeError; een trapexceptie wordt ook doorgegeven.
Voorbeelden
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); }Resultaat
true false 2 false false TypeError
Het voorbeeld vergelijkt open en gesloten objecten, wijzigt een bestaande waarde, weigert een nieuwe eigenschap en test een Proxy-invariant.