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

CKTIS / JavaScript

Object.prototype, descripteurs de propriété et accesseurs

Distinguez l’emplacement d’une propriété dans la chaîne de prototypes de son comportement : elle peut stocker une valeur ou faire intervenir un accesseur.

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

Syntaxe

Object.prototype
Object.getPrototypeOf(obj)
Object.hasOwn(obj, key)
Object.getOwnPropertyDescriptor(obj, key)
Object.defineProperty(obj, key, { value: 1, writable: true, enumerable: true, configurable: true })
Object.defineProperty(obj, key, { get() { return this._value; }, set(value) { this._value = value; }, configurable: true })

Object.prototype est l’objet partagé au bout de nombreuses chaînes de prototypes, dont celle de {}. Son propre prototype vaut null. Un objet créé avec Object.create(null) n’en hérite pas. Pour examiner le prototype direct, utilisez Object.getPrototypeOf(obj) plutôt que l’ancien accesseur __proto__, qui peut être absent ou masqué. Évitez d’ajouter des propriétés de votre application à Object.prototype : d’autres objets pourraient en hériter.

Un descripteur décrit les attributs d’une propriété. Une propriété de données stocke une value ; writable indique si une affectation peut la modifier. Une propriété d’accès possède à la place get et set, chacun étant une fonction ou undefined. Les deux types ont enumerable (qui influe par exemple sur la présence d’une clé textuelle propre dans Object.keys) et configurable (qui contrôle la suppression et restreint la modification des attributs). Une propriété d’accès est un type de propriété, pas une alternative au descripteur.

Pour les objets ordinaires, la lecture cherche d’abord parmi les propriétés propres, puis dans la chaîne de prototypes. Une propriété de données renvoie sa valeur stockée ; pour obj.key, un getter est appelé avec l’objet d’origine comme this. Sans getter, la lecture renvoie undefined. Affecter une valeur à une propriété d’accès héritée appelle son setter avec le même this ; affecter une valeur à une propriété de données héritée et modifiable crée une propriété propre si l’objet est extensible. Sans setter ou avec writable: false, l’affectation est bloquée : elle lève TypeError en mode strict et laisse la propriété inchangée sinon.

Object.hasOwn(obj, key) ne vérifie que les propriétés propres ; key in obj tient aussi compte des propriétés héritées. Object.getOwnPropertyDescriptor(obj, key) renvoie un objet distinct décrivant une propriété propre, ou undefined si elle est absente. Sur un objet ordinaire, cette méthode n’appelle pas le getter de la propriété examinée. Modifier les champs du descripteur renvoyé ne modifie pas la propriété.

Object.defineProperty(obj, key, descriptor) définit ou met à jour une propriété propre sans appeler de setter hérité. Pour une nouvelle propriété, les indicateurs omis writable (pour les données), enumerable et configurable valent false par défaut ; lors d’une mise à jour sans changement de type, les attributs omis conservent leurs valeurs. Combiner value ou writable avec get ou set, ou tenter une redéfinition interdite, lève TypeError même hors du mode strict.

Exemples

(() => {
  'use strict';
  const proto = {
    points: 2,
    get score() { return this.points * 2; },
    set score(value) { this.points = value / 2; }
  };
  const player = Object.create(proto);
  const accessor = Object.getOwnPropertyDescriptor(proto, 'score');
  console.log(`${'score' in player} ${Object.hasOwn(player, 'score')} ${typeof accessor.get}`);

  player.score = 12;
  console.log(`${player.score} ${player.points} ${proto.points}`);

  Object.defineProperty(player, 'score', { value: 99 });
  const data = Object.getOwnPropertyDescriptor(player, 'score');
  console.log(`${player.score} ${player.points} ${data.writable} ${data.enumerable} ${data.configurable}`);
})();

Résultat

true false function
12 6 2
99 6 false false false

Le setter `score` écrit dans la propriété propre `player.points` sans modifier `proto.points`. Ensuite, `Object.defineProperty` masque la propriété d’accès par une propriété de données propre, sans appeler le setter.

Leçons associées

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

Sources