База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

PropertyDescriptor.value — стойност на свойство за данни

Полето `value` съдържа запазената стойност на свойство за данни. Пропускането му във входния дескриптор не е равносилно на изричното задаване на `value: undefined`.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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 означава полето value на обект, който описва свойство за данни, а не свойство на глобален конструктор. То съответства на полето [[Value]] в спецификацията и може да съдържа всяка стойност в JavaScript, включително обект, функция или undefined. writable определя дали стойността може да се замени чрез присвояване; то не замразява съхранения обект.

При обикновен обект Object.defineProperty() използва undefined по подразбиране, ако създава свойство за данни без поле value. При промяна на съществуващо свойство за данни без смяна на вида му пропускането на value запазва старата стойност, а value: undefined указва тя да бъде заменена. Ако съществуващото свойство за данни не може нито да се конфигурира, нито да се презаписва, задаването на различна стойност според SameValue (сравнението, използвано от Object.is) предизвиква TypeError.

Дескрипторът на свойство с методи за достъп използва get и set вместо value и writable. Във входния дескриптор не може да се смесват полета от двете групи: дори { value: undefined, get: undefined } предизвиква TypeError. Наследените полета на входния дескриптор също се вземат предвид.

Object.getOwnPropertyDescriptor() връща undefined, ако няма собствено свойство с този ключ. Ако върне дескриптор, Object.hasOwn(descriptor, "value") различава свойство за данни със стойност undefined от свойство с методи за достъп. Дескрипторът не отразява текущите промени в свойството: промяната на descriptor.value не заменя стойността в целевия обект. Ако съхранената стойност е обект, дескрипторът сочи към същия обект, а не към копие.

Примери

{
  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));
}

Резултат

7
true: undefined
false: ready
7

Пропускането на `value` запазва `7`, а изричното `value: undefined` заменя стойността. Дескрипторът на `label` няма собствено поле `value`, въпреки че прочитането на `target.label` извиква getter и връща `ready`. Полученият по-рано дескриптор `before` все още съдържа `7`.

Свързани уроци

  • JavaScript · Урок 45 · Напреднало · Версия: 4

Източници