CKTIS / JavaScript
PropertyDescriptor.value — de waarde van een data-eigenschap
Het veld `value` bevat de opgeslagen waarde van een data-eigenschap. Het veld weglaten in de invoerdescriptor is niet hetzelfde als `value: undefined` opgeven.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
Object.defineProperty(target, key, { value: newValue })
const descriptor = Object.getOwnPropertyDescriptor(target, key);
if (descriptor !== undefined && Object.hasOwn(descriptor, "value")) {
const storedValue = descriptor.value;
}PropertyDescriptor.value is het veld value van een object dat een data-eigenschap beschrijft, niet een eigenschap van een globale constructor. Het komt overeen met het specificatieveld [[Value]] en kan elke JavaScript-waarde bevatten, ook een object, een functie of undefined. writable bepaalt of een toewijzing de waarde kan vervangen; een opgeslagen object wordt er niet door bevroren.
Bij een gewoon object gebruikt Object.defineProperty() standaard undefined als het een data-eigenschap aanmaakt zonder veld value. Bij het wijzigen van een bestaande data-eigenschap zonder van soort te veranderen, blijft de oude waarde behouden als je value weglaat. Met value: undefined vraag je juist om vervanging. Is de bestaande data-eigenschap niet configureerbaar en niet schrijfbaar, dan leidt een andere waarde volgens SameValue (de vergelijking die Object.is gebruikt) tot een TypeError.
Een accessordescriptor gebruikt get en set in plaats van value en writable. Je mag de twee groepen velden niet combineren in de invoerdescriptor: zelfs { value: undefined, get: undefined } veroorzaakt een TypeError. Geërfde velden van de invoerdescriptor tellen ook mee.
Object.getOwnPropertyDescriptor() retourneert undefined als het object geen eigen eigenschap met die sleutel heeft. Krijg je wel een descriptor terug, dan onderscheidt Object.hasOwn(descriptor, "value") een data-eigenschap met de waarde undefined van een accessoreigenschap. De descriptor is geen liveweergave: descriptor.value wijzigen vervangt de waarde op het doelobject niet. Is de opgeslagen waarde een object, dan verwijst de descriptor naar datzelfde object, niet naar een kopie.
Voorbeelden
{
const target = { score: 7, get label() { return "ready"; } };
const before = Object.getOwnPropertyDescriptor(target, "score");
Object.defineProperty(target, "score", { enumerable: false });
console.log(String(target.score));
Object.defineProperty(target, "score", { value: undefined });
const data = Object.getOwnPropertyDescriptor(target, "score");
const accessor = Object.getOwnPropertyDescriptor(target, "label");
console.log(`${Object.hasOwn(data, "value")}: ${data.value}`);
console.log(`${Object.hasOwn(accessor, "value")}: ${target.label}`);
console.log(String(before.value));
}Resultaat
7 true: undefined false: ready 7
Zonder `value` blijft `7` behouden; met `value: undefined` wordt de waarde vervangen. De descriptor van `label` heeft geen eigen veld `value`, hoewel het lezen van `target.label` de getter aanroept en `ready` oplevert. De eerder opgehaalde descriptor `before` bevat nog steeds `7`.
Gerelateerde lessen
- JavaScript · Les 45 · Gevorderd · Versie: 4