KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Reflect.isExtensible — controleren of een object uitbreidbaar is

Reflect.isExtensible(target) controleert of een object uitbreidbaar is. Bij een gewoon object betekent dit dat er nieuwe eigen eigenschappen aan kunnen worden toegevoegd. De methode geeft een boolean terug en gooit een TypeError bij primitieve waarden.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

Reflect.isExtensible(target)

Reflect.isExtensible(target) geeft true terug als een object uitbreidbaar is, en anders false. Bij een gewoon object betekent uitbreidbaarheid dat er nieuwe eigen eigenschappen aan kunnen worden toegevoegd. De methode leest deze toestand uit, maar verandert die zelf niet.

Object.preventExtensions(target) voorkomt dat er nieuwe eigen eigenschappen worden toegevoegd. Object.seal(target) en Object.freeze(target) maken objecten ook niet-uitbreidbaar, maar leggen extra beperkingen op. false betekent dus niet dat een object bevroren is: bestaande beschrijfbare eigenschappen kunnen nog steeds worden gewijzigd en configureerbare eigenschappen kunnen nog steeds worden verwijderd. Een gewoon object kan niet opnieuw uitbreidbaar worden gemaakt.

Het argument moet een object zijn; arrays en functies zijn ook objecten. Primitieve waarden, waaronder null en undefined, veroorzaken een TypeError. Dit is een belangrijk verschil met Object.isExtensible(target), dat voor primitieve waarden false teruggeeft in plaats van een fout te gooien.

De methode roept de interne bewerking [[IsExtensible]] aan. Bij een Proxy kan daardoor de isExtensible-trap worden aangeroepen. Ga er dus niet van uit dat de methode geen neveneffecten heeft. Na omzetting naar een boolean moet het resultaat van de trap overeenkomen met de werkelijke uitbreidbaarheid van het doelobject; anders treedt een TypeError op. Een ingetrokken proxy veroorzaakt ook een TypeError.

Voorbeelden

const item = { count: 1 };
console.log(Reflect.isExtensible(item));

Object.preventExtensions(item);
console.log(Reflect.isExtensible(item));
console.log(Reflect.set(item, "extra", 10));

item.count = 2;
console.log(item.count);

try {
  Reflect.isExtensible(42);
} catch (error) {
  console.log(error.name);
}

Resultaat

true
false
false
2
TypeError

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen