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

CKTIS / JavaScript

Clés calculées des méthodes dans les littéraux d’objet

Dans un littéral d’objet, `[expr](...) { ... }` définit une méthode dont la clé est déterminée par une expression. Cette clé est une chaîne ou un symbole.

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

Syntaxe

const obj = { [expression](parameter) { /* method body */ } };
obj[key](argument);

Dans un littéral d’objet, [expr](...) { ... } définit une méthode sous la clé déterminée par l’expression expr. Sans crochets, key() { ... } utilise toujours la clé littérale "key", quelle que soit la valeur d’une variable du même nom.

L’expression est évaluée à chaque évaluation du littéral, et non à chaque appel de la méthode. Pour obtenir la clé, JavaScript convertit le résultat en valeur primitive si nécessaire, conserve un symbole tel quel et convertit toute autre valeur primitive en chaîne. Par exemple, 1 devient "1". Si l’évaluation ou la conversion lève une exception, la création de l’objet s’interrompt. Modifier ensuite une variable utilisée pour calculer la clé ne renomme pas la propriété existante.

Dans obj[key](...), les crochets servent à accéder à la propriété. Appelée sous cette forme, la méthode a obj pour valeur de this. Si l’accès donne une valeur non appelable, par exemple si la propriété est absente, l’appel lève une exception TypeError.

Une méthode ordinaire ainsi définie est une propriété propre et énumérable de l’objet. Si deux définitions de méthodes ordinaires dans le même littéral produisent la même clé, la seconde remplace la première. Des listes de paramètres différentes ne créent pas de surcharges.

Exemples

const key = "say" + "Hi";
const loud = Symbol("loud");
const obj = {
  label: "Ada",
  [key]() {
    return "Hi, " + this.label;
  },
  [loud]() {
    return this.label.toUpperCase();
  },
};

console.log(obj[key]());
console.log(obj[loud]());

Résultat

Hi, Ada
ADA

`[key]` définit une méthode sous la clé de type chaîne `"sayHi"`, tandis que `[loud]` utilise une valeur de type `Symbol`. Les deux appels lisent `label` sur `obj` par l’intermédiaire de `this`.

Leçons associées

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

Sources