CKTIS / JavaScript
Reflect.defineProperty — eigenschappen definiëren met een booleaans resultaat
Reflect.defineProperty definieert of wijzigt met een descriptor een eigen eigenschap van een object. De methode retourneert true of false, maar garandeert geen uitvoering zonder uitzonderingen.
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.defineProperty(target, propertyKey, attributes)Reflect.defineProperty(target, propertyKey, attributes) definieert of wijzigt een eigen eigenschap van target. De sleutel wordt omgezet naar een tekenreeks of symbool, en attributes is een descriptorobject. De methode retourneert true als de bewerking slaagt, of false als de regels van het object deze afwijzen.
Een gegevensdescriptor gebruikt value en writable; een accessor-descriptor gebruikt get en set. Beide kunnen enumerable en configurable bevatten. Gegevensvelden mogen niet worden gecombineerd met accessorvelden. Bij het aanmaken van een eigenschap op een gewoon object zijn weggelaten vlaggen standaard false en is een weggelaten gegevenswaarde standaard undefined. Bij een gewoon object blijven weggelaten velden ongewijzigd als een bestaande eigenschap wordt aangepast zonder van type te veranderen. Een configureerbare eigenschap kan worden omgezet van een gegevenseigenschap naar een accessor-eigenschap of omgekeerd. Als enumerable en configurable bij die omzetting worden weggelaten, behouden ze hun eerdere waarden. Als je bijvoorbeeld een configureerbare gegevenseigenschap omzet in een accessor-eigenschap door alleen get op te geven, vervallen value en writable en krijgt het weggelaten veld set de waarde undefined.
De defineProperty-trap van een Proxy ontvangt een descriptorobject waarin weggelaten velden nog steeds ontbreken. De trap kan op het doelobject van de Proxy een eigenschap met andere attributen aanmaken, zolang de invarianten van de Proxy worden gerespecteerd.
Anders dan Object.defineProperty, dat het object retourneert en een TypeError genereert als een definitie wordt afgewezen, retourneert deze methode een booleaans resultaat. De methode is echter niet vrij van uitzonderingen: een target dat geen object is, een ongeldige descriptor of een uitzondering tijdens het omzetten van de sleutel kan de aanroep onderbreken. Ook de defineProperty-trap van een Proxy kan een uitzondering genereren.
Bij een gewoon object retourneert het toevoegen van een eigenschap aan een niet-uitbreidbaar object of een verboden wijziging van een niet-configureerbare eigenschap false. In het voorbeeld kan de tweede definitie id niet wijzigen, omdat writable en configurable false zijn; de waarde blijft 7.
Voorbeelden
const item = {};
console.log(Reflect.defineProperty(item, "id", {
value: 7,
enumerable: true,
writable: false,
configurable: false
}));
console.log(Reflect.defineProperty(item, "id", { value: 8 }));
console.log(item.id);
console.log(Object.keys(item).join(","));Resultaat
true false 7 id
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.