Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

PropertyDescriptor.value — valeur d’une propriété de données

Le champ `value` contient la valeur stockée par une propriété de données. Omettre ce champ dans un descripteur ne revient pas à écrire `value: undefined`.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

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 désigne le champ value d’un objet qui décrit une propriété de données, et non une propriété d’un constructeur global. Il correspond au champ [[Value]] de la spécification et peut contenir toute valeur JavaScript, y compris un objet, une fonction ou undefined. writable indique si une affectation peut remplacer la valeur ; il ne gèle pas l’objet stocké.

Sur un objet ordinaire, Object.defineProperty() utilise undefined par défaut s’il crée une propriété de données sans champ value. Lors de la modification d’une propriété de données existante sans changer sa nature, omettre value conserve l’ancienne valeur, tandis que value: undefined demande son remplacement. Si la propriété de données existante n’est ni configurable ni modifiable par affectation, fournir une valeur différente au sens de SameValue (la comparaison utilisée par Object.is) lève une TypeError.

Un descripteur d’accesseur utilise get et set au lieu de value et writable. Le descripteur fourni ne peut pas mélanger les deux groupes : même { value: undefined, get: undefined } lève une TypeError. Les champs hérités par le descripteur fourni sont aussi pris en compte.

Object.getOwnPropertyDescriptor() renvoie undefined si aucune propriété propre ne correspond à la clé. Si un descripteur est renvoyé, Object.hasOwn(descriptor, "value") distingue une propriété de données contenant undefined d’une propriété d’accesseur. Le descripteur n’est pas lié dynamiquement à la propriété : modifier descriptor.value ne remplace pas la valeur sur l’objet cible. Si la valeur stockée est un objet, le descripteur fait référence au même objet, pas à une copie.

Exemples

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

Résultat

7
true: undefined
false: ready
7

Omettre `value` conserve `7` ; indiquer `value: undefined` remplace la valeur. Le descripteur de `label` n’a pas de champ propre `value`, bien que la lecture de `target.label` appelle le getter et renvoie `ready`. Le descripteur `before`, obtenu plus tôt, contient toujours `7`.

Leçons associées

  • JavaScript · Leçon 45 · Avancé · Version : 4

Sources