CKTIS / JavaScript
PropertyDescriptor.value — der Wert einer Dateneigenschaft
Das Feld `value` enthält den gespeicherten Wert einer Dateneigenschaft. Es wegzulassen ist nicht dasselbe, wie ausdrücklich `value: undefined` anzugeben.
Version: 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 bezeichnet das Feld value eines Objekts, das eine Dateneigenschaft beschreibt, nicht eine Eigenschaft eines globalen Konstruktors. Es entspricht dem Spezifikationsfeld [[Value]] und kann jeden JavaScript-Wert enthalten, auch ein Objekt, eine Funktion oder undefined. writable bestimmt, ob eine Zuweisung den Wert ersetzen kann; ein gespeichertes Objekt wird dadurch nicht eingefroren.
Bei einem gewöhnlichen Objekt verwendet Object.defineProperty() standardmäßig undefined, wenn es eine Dateneigenschaft ohne Feld value anlegt. Beim Ändern einer vorhandenen Dateneigenschaft ohne Wechsel der Eigenschaftsart bleibt der alte Wert erhalten, wenn value fehlt. value: undefined fordert dagegen einen Ersatz an. Ist die vorhandene Dateneigenschaft weder konfigurierbar noch beschreibbar, löst ein nach SameValue (dem Vergleich von Object.is) anderer Wert einen TypeError aus.
Ein Accessor-Deskriptor verwendet get und set statt value und writable. Felder beider Gruppen dürfen im übergebenen Deskriptor nicht gemischt werden: Schon { value: undefined, get: undefined } löst einen TypeError aus. Auch geerbte Felder des übergebenen Deskriptorobjekts zählen.
Object.getOwnPropertyDescriptor() gibt undefined zurück, wenn zum Schlüssel keine eigene Eigenschaft existiert. Wird ein Deskriptor zurückgegeben, unterscheidet Object.hasOwn(descriptor, "value") eine Dateneigenschaft mit dem Wert undefined von einer Accessor-Eigenschaft. Der Deskriptor ist keine Live-Ansicht: Eine Änderung an descriptor.value ersetzt den Wert am Zielobjekt nicht. Ist der gespeicherte Wert ein Objekt, verweist der Deskriptor auf dasselbe Objekt, nicht auf eine Kopie.
Beispiele
{
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));
}Ergebnis
7 true: undefined false: ready 7
Ohne `value` bleibt `7` erhalten; das ausdrückliche `value: undefined` ersetzt den Wert. Der Deskriptor zu `label` hat kein eigenes Feld `value`, obwohl das Lesen von `target.label` den Getter aufruft und `ready` liefert. Der zuvor abgerufene Deskriptor `before` enthält weiterhin `7`.
Zugehörige Lektionen
- JavaScript · Lektion 45 · Fortgeschritten · Version: 4