KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen