CKTIS / JavaScript
PropertyDescriptor.value — wartość właściwości danych
Pole `value` przechowuje wartość właściwości danych. Brak tego pola w deskryptorze wejściowym nie oznacza tego samego co jawne `value: undefined`.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
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 to pole value obiektu opisującego właściwość danych, a nie właściwość globalnego konstruktora. Odpowiada polu [[Value]] w specyfikacji i może zawierać dowolną wartość JavaScript, także obiekt, funkcję lub undefined. writable określa, czy przypisanie może zastąpić wartość; nie zamraża zapisanego obiektu.
Dla zwykłego obiektu Object.defineProperty() domyślnie zapisuje undefined, jeśli tworzysz właściwość danych bez pola value. Jeśli zmieniasz istniejącą właściwość danych bez zmiany jej typu, pominięcie value zachowuje dotychczasową wartość, a value: undefined żąda jej zastąpienia. Gdy istniejąca właściwość danych ma jednocześnie configurable: false i writable: false, podanie wartości innej według SameValue (porównania używanego przez Object.is) powoduje TypeError.
Deskryptor akcesorowy używa get i set zamiast value i writable. W deskryptorze wejściowym nie można łączyć pól z obu grup: nawet { value: undefined, get: undefined } powoduje TypeError. Uwzględniane są także pola odziedziczone przez obiekt deskryptora wejściowego.
Object.getOwnPropertyDescriptor() zwraca undefined, jeśli nie ma właściwości własnej o danym kluczu. Jeśli zwróci deskryptor, Object.hasOwn(descriptor, "value") odróżnia właściwość danych zawierającą undefined od właściwości akcesorowej. Deskryptor nie jest powiązany na żywo z właściwością: zmiana descriptor.value nie zastępuje wartości na obiekcie docelowym. Jeśli zapisana wartość jest obiektem, deskryptor wskazuje ten sam obiekt, a nie jego kopię.
Przykłady
{
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));
}Wynik
7 true: undefined false: ready 7
Pominięcie `value` zachowuje `7`, a jawne `value: undefined` zastępuje tę wartość. Deskryptor `label` nie zawiera własnego pola `value`, choć odczyt `target.label` wywołuje getter i zwraca `ready`. Wcześniej pobrany deskryptor `before` nadal zawiera `7`.
Powiązane lekcje
- JavaScript · Lekcja 45 · Zaawansowany · Wersja: 4