Définir une méthode - JavaScript | MDN

Basculer la barre latérale

Thème

Automatique
Clair
Sombre

Français

Se souvenir de la langue En savoir plus

Définir une méthode

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2015.

Avec ECMAScript 2015 (ES6), il est possible d'utiliser une notation plus courte pour définir des méthodes au sein des littéraux objets. On peut ainsi définir plus rapidement une fonction qui sera utilisée comme méthode.

Dans cet article

Exemple interactif

const obj = {
  foo() {
    return "bar";
  },
};

console.log(obj.foo());
// Expected output: "bar"

Syntaxe

js
var obj = {
  property( parameters… ) {},
  *generator( parameters… ) {},
  async property( parameters… ) {},
  async* generator( parameters… ) {},

  // avec les noms calculés :
  [property]( parameters… ) {},
  *[generator]( parameters… ) {},
  async [property]( parameters… ) {},

  // avec la syntaxe pour les accesseurs
  // mutateurs :
  get property() {},
  set property(value) {}
};

Description

La notation raccourcie est semblable à la syntaxe introduite par ECMAScript 5 pour les accesseurs et mutateurs.

Le code suivant :

js
var obj = {
  toto: function () {
    /* du code */
  },
  truc: function () {
    /* du code */
  },
};

Peut désormais être raccourci en :

js
var obj = {
  toto() {
    /* du code */
  },
  truc() {
    /* du code */
  },
};

Notation raccourcie pour les générateurs

Les générateurs sont des méthodes et peuvent donc être définis en utilisant la notation raccourci. Lorsqu'on les utilise :

L'astérisque de la notation raccourcie doit être située avant le nom de la propriété pour le générateur. Autrement dit, * g(){} fonctionnera mais g*(){} ne fonctionnera pas.
Les définitions des méthodes qui ne sont pas des générateurs ne peuvent pas contenir le mot-clé yield. Cela signifie que l'ancienne syntaxe pour les générateurs ne fonctionnera pas et déclenchera une exception SyntaxError. Il faut toujours utiliser yield avec l'astérisque (*).

js
// Notation utilisant une propriété nommée (avant-ES2015)
var obj2 = {
  g: function* () {
    var index = 0;
    while (true) yield index++;
  },
};

// La même définition, en utilisant la notation raccourcie
var obj2 = {
  *g() {
    var index = 0;
    while (true) yield index++;
  },
};

var it = obj2.g();
console.log(it.next().value); // 0
console.log(it.next().value); // 1

Méthodes asynchrones avec notation raccourcie

Les méthodes asynchrones peuvent également être définies grâce à une syntaxe raccourcie.

js
// On utilise une propriété nommée
var obj3 = {
  f: async function () {
    await une_promesse;
  },
};

// Ici, on obtient le même résultat
// avec la notation raccourcie
var obj3 = {
  async f() {
    await une_promesse;
  },
};

Méthodes génératrices asynchrones

Les méthodes génératrices peuvent également être asynchrones (cf. async) :

js
var obj4 = {
  f: async function* () {
    yield 1;
    yield 2;
    yield 3;
  },
};

// Le code équivalent avec la
// notation raccourcie
var obj4 = {
  async *f() {
    yield 1;
    yield 2;
    yield 3;
  },
};

Les définitions de méthodes ne sont pas constructibles

Les définitions de méthodes ne sont pas des constructeurs et si on tente de les instancier, cela provoquera une exception TypeError.

js
var obj = {
  méthode() {},
};
new obj.méthode(); // TypeError: obj.méthode is not a constructor

var obj = {
  *g() {},
};
new obj.g(); // TypeError: obj.g is not a constructuer (changé avec ES2016)

Exemples

Cas de test

js
var obj = {
  a: "toto",
  b() {
    return this.a;
  },
};
console.log(obj.b()); // "toto"

Noms de propriétés calculés

Cette notation raccourcie peut également être utilisée avec des noms de propriétés calculés.

js
var bar = {
  toto0: function () {
    return 0;
  },
  toto1() {
    return 1;
  },
  ["toto" + 2]() {
    return 2;
  },
};

console.log(bar.toto0()); // 0
console.log(bar.toto1()); // 1
console.log(bar.toto2()); // 2

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 17 févr. 2025 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu