7 juillet 2023

Propriétés et méthodes statiques

Nous pouvons aussi assigner une méthode à la fonction de classe elle-même, pas à son "prototype". De telles méthodes sont appelées statique.

Dans une classe, elles sont précédées du mot clé static, comme ceci :

class User {
  static staticMethod() {
    alert(this === User);
  }
}

User.staticMethod(); // true

Cela revient en fait à l’affecter directement à une propriété :

class User { }

User.staticMethod = function() {
  alert(this === User);
};

User.staticMethod(); // true

La valeur de this dans l’appel User.staticMethod() est le constructeur de la classe User lui-même (la règle “objet avant le point”).

Généralement, les méthodes statiques sont utilisées pour implémenter des fonctions appartenant à la classe, mais pas à un objet particulier de celle-ci.

Par exemple, nous avons des objets Article et avons besoin d’une fonction pour les comparer.

Une solution naturelle serait d’ajouter la méthode Article.compare, comme ceci :

class Article {
  constructor(title, date) {
    this.title = title;
    this.date = date;
  }

  static compare(articleA, articleB) {
    return articleA.date - articleB.date;
  }
}

// usage
let articles = [
  new Article("HTML", new Date(2019, 1, 1)),
  new Article("CSS", new Date(2019, 0, 1)),
  new Article("JavaScript", new Date(2019, 11, 1))
];

articles.sort(Article.compare);

alert( articles[0].title ); // CSS

Ici, Article.compare est “au dessus” des articles, comme un moyen de les comparer. Ce n’est pas une méthode d’article, mais plutôt de toute la classe.

Un autre exemple serait une méthode dite “d’usine”.

Disons que nous avons besoin de plusieurs façons de créer un article :

  1. Créez avec des paramètres donnés (title, date, etc.).
  2. Créez un article vide avec la date du jour.
  3. … ou d’une certaine manière.

Le premier moyen peut être implémenté par le constructeur. Et pour le second, nous pouvons créer une méthode statique de la classe.

Comme Article.createTodays() ici :

class Article {
  constructor(title, date) {
    this.title = title;
    this.date = date;
  }

  static createTodays() {
    // rappelez vous, this = Article
    return new this("Today's digest", new Date());
  }
}

let article = Article.createTodays();

alert( article.title ); // Today's digest

Maintenant, chaque fois que nous avons besoin de créer le résumé d’aujourd’hui, nous pouvons appeler Article.createTodays(). Encore une fois, ce n’est pas une méthode d’article, mais une méthode de toute la classe.

Les méthodes statiques sont également utilisées dans les classes liées à la base de données pour rechercher/enregistrer/supprimer des entrées dans la base de données, comme ceci :

// en supposant que Article est une classe spéciale pour la gestion d'articles
// méthode statique pour supprimer l'article :
Article.remove({id: 12345});
Les méthodes statiques ne sont pas disponibles pour les objets individuels

Les méthodes statiques peuvent être appelées sur des classes, pas sur des objets individuels.

Par exemple, ce genre de code ne fonctionnera pas :

// ...
article.createTodays(); // Error: article.createTodays is not a function

Propriétés statiques

Un ajout récent
Ceci est un ajout récent au language. Les exemples fonctionnent dans le récent Chrome.

Les propriétés statiques sont également possibles, elles ressemblent aux propriétés de classe ordinaires, mais précédées de static :

class Article {
  static publisher = "Ilya Kantor";
}

alert( Article.publisher ); // Ilya Kantor

C’est la même chose qu’une assignation directe à Article :

Article.publisher = "Ilya Kantor";

Héritage de méthodes et de propriétés statiques

Les propriétés et méthodes statiques sont héritées.

Par exemple, Animal.compare et Animal.planet dans le code ci-dessous sont hérités et accessibles par Rabbit.compare et Rabbit.planet :

class Animal {
  static planet = "Earth";

  constructor(name, speed) {
    this.speed = speed;
    this.name = name;
  }

  run(speed = 0) {
    this.speed += speed;
    alert(`${this.name} runs with speed ${this.speed}.`);
  }

  static compare(animalA, animalB) {
    return animalA.speed - animalB.speed;
  }

}

// Hérite de Animal
class Rabbit extends Animal {
  hide() {
    alert(`${this.name} hides!`);
  }
}

let rabbits = [
  new Rabbit("White Rabbit", 10),
  new Rabbit("Black Rabbit", 5)
];

rabbits.sort(Rabbit.compare);

rabbits[0].run(); // Black Rabbit runs with speed 5.

alert(Rabbit.planet); // Earth

Maintenant, lorsque nous appellerons Rabbit.compare, le Animal.compare hérité sera appelé.

Comment cela fonctionne-t-il ? Encore une fois, en utilisant des prototypes. Comme vous l’avez peut-être déjà deviné, extends donne à Rabbit la référence de [[Prototype]] à Animal.

Ainsi, Rabbit extends Animal crée deux références [[Prototype]] :

  1. La fonction Rabbit hérite de façon prototypique de la fonction Animal.
  2. Rabbit.prototype hérite de façon prototypique de Animal.prototype.

En conséquence, l’héritage fonctionne à la fois pour les méthodes régulières et statiques.

Vérifions cela par code :

class Animal {}
class Rabbit extends Animal {}

// pour les méthodes statiques
alert(Rabbit.__proto__ === Animal); // true

// pour les méthodes régulières
alert(Rabbit.prototype.__proto__ === Animal.prototype); // true

Résumé

Les méthodes statiques sont utilisées pour les fonctionnalités appartenant à la classe “dans son ensemble”. Cela ne concerne pas une instance de classe concrète.

Par exemple, une méthode de comparaison Article.compare(article1, article2) ou une méthode d’usine Article.createTodays().

Ils sont étiquetés par le mot static dans la déclaration de classe.

Les propriétés statiques sont utilisées lorsque nous souhaitons stocker des données au niveau de la classe, également non liées à une instance.

La syntaxe est la suivante :

class MyClass {
  static property = ...;

  static method() {
    ...
  }
}

Techniquement, la déclaration statique revient à assigner à la classe elle-même :

MyClass.property = ...
MyClass.method = ...

Les propriétés et méthodes statiques sont héritées.

Pour class B extends A, le prototype de la classe B pointe lui-même à A : B.[[Prototype]] = A. Donc, si un champ n’est pas trouvé dans B, la recherche continue dans A.

Exercices

importance: 3

Comme nous le savons, tous les objets héritent normalement de Object.prototype et ont accès à des méthodes d’objet “génériques” comme hasOwnProperty etc.

Par exemple :

class Rabbit {
  constructor(name) {
    this.name = name;
  }
}

let rabbit = new Rabbit("Rab");

// la méthode hasOwnProperty provient de Object.prototype
alert( rabbit.hasOwnProperty('name') ); // true

Mais si nous l’épelons explicitement comme suit : "class Rabbit extends Object", le résultat serait alors différent d´un simple "class Rabbit" ?

Quelle est la différence ?

Voici un exemple d’un tel code (cela ne fonctionne pas – pourquoi ? Réparez le ?) :

class Rabbit extends Object {
  constructor(name) {
    this.name = name;
  }
}

let rabbit = new Rabbit("Rab");

alert( rabbit.hasOwnProperty('name') ); // Error

Voyons d’abord pourquoi ce dernier code ne fonctionne pas.

La raison devient évidente si nous essayons de l’exécuter. Un constructeur de classe héritant doit appeler super(). Sinon "this" ne sera pas “défini”.

Alors, voici la solution :

class Rabbit extends Object {
  constructor(name) {
    super(); // besoin d'appeler le constructeur parent lors de l'héritage
    this.name = name;
  }
}

let rabbit = new Rabbit("Rab");

alert( rabbit.hasOwnProperty('name') ); // true

Mais ce n’est pas tout.

Même après le correctif, il existe toujours une différence importante entre "class Rabbit extends Object" et class Rabbit.

Comme on le sait, la syntaxe “extends” configure deux prototypes :

  1. Entre le "prototype" des fonctions du constructeur (pour les méthodes).
  2. Entre les fonctions constructeur elles-mêmes (pour les méthodes statiques).

Dans notre cas, pour class Rabbit extends Object, cela signifie :

class Rabbit extends Object {}

alert( Rabbit.prototype.__proto__ === Object.prototype ); // (1) true
alert( Rabbit.__proto__ === Object ); // (2) true

Donc Rabbit donne maintenant accès aux méthodes statiques de Object via Rabbit, comme ceci :

class Rabbit extends Object {}

// normalement nous appelons Object.getOwnPropertyNames
alert ( Rabbit.getOwnPropertyNames({a: 1, b: 2})); // a,b

Mais si nous n’avons pas extends Object, alors Rabbit.__proto__ n’est pas défini sur Object.

Voici la démo :

class Rabbit {}

alert( Rabbit.prototype.__proto__ === Object.prototype ); // (1) true
alert( Rabbit.__proto__ === Object ); // (2) false (!)
alert( Rabbit.__proto__ === Function.prototype ); // comme toute fonction par défaut

// error, no such function in Rabbit
alert ( Rabbit.getOwnPropertyNames({a: 1, b: 2})); // Error

Donc, Rabbit ne donne pas accès aux méthodes statiques de Object dans ce cas.

En passant, Function.prototype a des méthodes de fonction “génériques”, comme call, bind, etc. Elles sont finalement disponibles dans les deux cas, car pour le constructeur Object intégré, Object.__proto__ === Function.prototype.

Voici l’image :

Donc, pour faire court, il y a deux différences :

class Rabbit class Rabbit extends Object
doit appeler super() dans le constructeur
Rabbit.__proto__ === Function.prototype Rabbit.__proto__ === Object
Carte du tutoriel

Commentaires

lire ceci avant de commenter…
  • Si vous avez des améliorations à suggérer, merci de soumettre une issue GitHub ou une pull request au lieu de commenter.
  • Si vous ne comprenez pas quelque chose dans l'article, merci de préciser.
  • Pour insérer quelques bouts de code, utilisez la balise <code>, pour plusieurs lignes – enveloppez-les avec la balise <pre>, pour plus de 10 lignes - utilisez une sandbox (plnkr, jsbin, codepen…)