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

CKTIS / JavaScript

Définitions de méthodes d’objet

La forme `name(a) {}` définit une méthode dans un littéral d’objet. Voyez comment l’appel fixe `this`, où `super` cherche la propriété et pourquoi `new` échoue.

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

Syntaxe

({
  name(a, b) {},
  [key](a) {},
  *generate() {},
  async load() {},
  async *stream() {},
  get value() {},
  set value(next) {},
})

Dans un littéral d’objet, name(a) {} crée une propriété de données propre dont la valeur est une fonction. Cette propriété est modifiable en écriture, énumérable et configurable. Séparez les définitions par des virgules. Dans [key](a) {}, l’expression key est évaluée lors de la création de l’objet pour déterminer la clé. Les méthodes d’instance publiques d’une classe ont une syntaxe similaire, mais sont des propriétés non énumérables du prototype de la classe.

Dans obj.name(), this vaut obj. Extraire la méthode ne la lie pas à l’objet : après const f = obj.name, lors d’un appel direct à f(), this vaut undefined si la méthode elle-même est en mode strict. Si la méthode n’est pas en mode strict, elle utilise à la place la valeur globale de this, même si le code appelant est en mode strict. Utilisez f.call(obj) pour préciser le récepteur. À l’inverse, name: () => {} stocke une fonction fléchée qui reprend le this de la portée englobante.

super.name() commence la recherche dans le prototype actuel de l’objet où la méthode a été définie et transmet le this courant. Copier la méthode ou utiliser call ne change pas l’objet dont le prototype sert à cette recherche. Contrairement à name: function () {} avec une fonction ordinaire, ni asynchrone ni génératrice, la forme concise permet l’accès à une propriété via super mais ne sert pas de constructeur : new obj.name() lève une TypeError.

*generate() renvoie un générateur, async load() une Promise et async *stream() un générateur asynchrone. get value() et set value(next) définissent des accesseurs plutôt que des propriétés de données contenant une fonction : la lecture appelle le getter, qui ne prend aucun paramètre, et l’affectation appelle le setter, qui en prend un.

Exemples

{
  const base = {
    score() {
      return this.points;
    },
  };

  const player = {
    __proto__: base,
    points: 10,
    ["score"](bonus) {
      return super.score() + bonus;
    },
  };

  console.log(player.score(2));
  console.log(player.score.call({ points: 20 }, 2));
  try {
    new player.score(2);
  } catch (error) {
    console.log(error instanceof TypeError);
  }
}

Résultat

12
22
true

`__proto__: base` fixe le prototype dans le littéral. Les deux appels trouvent `base.score` via `super`, mais lisent `points` sur des récepteurs différents, ce qui donne `12` et `22`. `true` indique que la tentative avec `new` lève une `TypeError`.

Leçons associées

  • JavaScript · Leçon 1 · Avancé · Version : 4
  • JavaScript · Leçon 4 · Avancé · Version : 4
  • JavaScript · Leçon 43 · Intermédiaire · Version : 3

Sources