Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
super
Baseline Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis mars 2016.
Le mot-clésuper est utilisé afin d'appeler ou d'accéder à des fonctions définies sur l'objet parent.
Les expressions de la formesuper.propriete etsuper[expr] sont valides pour n'importe quelledéfinition de méthode, que ce soit au sein d'uneclasse ou d'unlittéral objet.
Syntaxe
super([arguments]); // Le constructeur parent est appelésuper.functionOnParent([arguments]);Description
Lorsqu'il est utilisé dans un constructeur, le mot-clésuper est utilisé seul et doit apparaître avant le mot-cléthis. Ce mot-clé peut également être utilisé afin d'appeler des fonctions sur un objet parent.
Exemples
Utilisersuper avec les classes
Ce fragment de code est tiré decet exemple. Ici on utilisesuper() afin d'éviter la duplication des parties communes entre le constructeur deRectangle et deCarre.
class Rectangle { constructor(hauteur, largeur) { this.name = "Rectangle"; this.hauteur = hauteur; this.largeur = largeur; } coucou() { console.log("Coucou, je suis un " + this.name + "."); } get aire() { return this.hauteur * this.largeur; } set aire(valeur) { this.hauteur = Math.sqrt(valeur); this.largeur = Math.sqrt(valeur); }}class Carre extends Rectangle { constructor(longueur) { // Ici, on appelle le constructeur de Rectangle // qui est l'objet « parent » de Carré super(longueur, longueur); // Pour les classes dérivées, super() doit être appelé // avant d'utiliser 'this' sinon cela entraînera une // exception ReferenceError. this.name = "Carré"; }}Utiliser super pour appeler des méthodes statiques
Il est possible d'utiliser super pour invoquer des méthodesstatiques :
class Rectangle { constructor() {} static logNbCotes() { return "J'ai 4 côtés"; }}class Carre extends Rectangle { constructor() {} static logDescription() { return super.logNbCotes() + " qui sont tous égaux"; }}Carre.logDescription(); // "J'ai 4 côtés qui sont tous égaux"Supprimer des propriétés parentes lèvera une exception
Il n'est pas possible d'utiliser l'opérateurdelete sursuper.prop ousuper[expr] pour supprimer une propriété de la classe parente, cela renverra une exceptionReferenceError :
class Base { toto() {}}class Derivee extends Base { delete() { delete super.toto; // À ne pas faire }}new Derivee().delete();// ReferenceError : suppression invalide avec 'super'super.prop ne peut pas surcharger les propriétés non modifiables
Lorsque des propriétés sont définies sans accès en écriture (non-writable), par exemple avecObject.defineProperty(),super ne peut pas surcharger les valeurs de ces propriétés.
class X { constructor() { Object.defineProperty(this, "prop", { configurable: true, writable: false, value: 1, }); }}class Y extends X { constructor() { super(); } toto() { super.prop = 2; // Impossible de surcharger }}const y = new Y();y.toto(); // TypeError "prop" est en lecture seuleconsole.log(y.prop); // 1Utilisersuper.prop sur les littéraux objets
super peut également être utilisé avecla notation littérale. Dans l'exemple qui suit, deux objets définissent chacun une méthode. Le deuxième objet utilisesuper pour appeler la méthode du premier objet. Cela fonctionne grâce àObject.setPrototypeOf() avec lequel on définit que le prototype deobj2 estobj1. De cette façon, super peut parcourir la chaîne de prototypes et trouvermethode1 dansobj1.
const obj1 = { methode1() { console.log("méthode 1"); },};const obj2 = { methode2() { super.methode1(); },};Object.setPrototypeOf(obj2, obj1);obj2.methode2(); // affiche "méthode 1" dans la consoleSpécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-super-keyword |