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

CKTIS / JavaScript

static — éléments statiques de classe

`static` définit des champs, des méthodes et des accesseurs qui appartiennent à la classe elle-même, et non à ses instances. Un bloc `static { ... }` effectue l’initialisation lors de la création de la classe, sans appeler `new`.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

class Name {
  static field = value;
  static method() { /* ... */ }
  static get property() { /* ... */ }
  static set property(value) { /* ... */ }
  static { /* initialization */ }
}

Placée avant un champ, une méthode ou un accesseur (get ou set), l’expression static définit un élément sur l’objet constructeur de la classe, et non sur son prototype ou ses instances. Utilisez Counter.next(), pas new Counter().next(). static ne signifie pas constant : un champ statique modifiable peut changer. Les éléments statiques peuvent aussi être privés, avec un nom commençant par #.

Les initialiseurs de champs statiques et les blocs static { ... } s’exécutent dans l’ordre du code lors de l’évaluation de la définition de classe, et non à chaque new. Dans un tel initialiseur ou bloc, this désigne la classe en cours de définition. Un bloc possède sa propre portée et ne peut pas utiliser directement await ou yield.

Les éléments statiques publics sont hérités par les sous-classes via la chaîne de prototypes des constructeurs. Dans une méthode appelée comme Child.method(), this vaut Child. Les éléments statiques privés ne sont pas installés sur les sous-classes ; une méthode héritée qui lit this.#field peut donc déclencher une TypeError.

En mode strict, static ne peut pas être un identifiant de variable, mais peut être un nom de propriété. Dans une classe, static() {} déclare une méthode d’instance nommée static, et non une méthode statique. Les méthodes statiques datent d’ECMAScript 2015 ; les champs statiques et les blocs d’initialisation datent d’ECMAScript 2022. La prise en charge dans un navigateur donné doit être vérifiée séparément ; la version de Node utilisée dans un dépôt ne permet pas de l’établir.

Exemples

class Counter {
  static value = 2;

  static {
    this.value *= 3;
  }

  static next() {
    return ++this.value;
  }
}

console.log(Counter.value);
console.log(Counter.next());
console.log(typeof new Counter().next);

Résultat

6
7
undefined

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources