aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/javascript/reference/opérateurs/super/index.html
diff options
context:
space:
mode:
Diffstat (limited to 'files/fr/web/javascript/reference/opérateurs/super/index.html')
-rw-r--r--files/fr/web/javascript/reference/opérateurs/super/index.html184
1 files changed, 184 insertions, 0 deletions
diff --git a/files/fr/web/javascript/reference/opérateurs/super/index.html b/files/fr/web/javascript/reference/opérateurs/super/index.html
new file mode 100644
index 0000000000..05a40df1fc
--- /dev/null
+++ b/files/fr/web/javascript/reference/opérateurs/super/index.html
@@ -0,0 +1,184 @@
+---
+title: super
+slug: Web/JavaScript/Reference/Opérateurs/super
+tags:
+ - Classes
+ - ECMAScript 2015
+ - JavaScript
+ - Opérateur
+ - Reference
+translation_of: Web/JavaScript/Reference/Operators/super
+---
+<div>{{jsSidebar("Operators")}}</div>
+
+<p>Le mot-clé <code><strong>super</strong></code> est utilisé afin d'appeler ou d'accéder à des fonctions définies sur l'objet parent.</p>
+
+<p>Les expressions de la forme <code>super.propriété</code> et <code>super[expr]</code> sont valides pour n'importe quelle <a href="/fr/docs/Web/JavaScript/Reference/Fonctions/Définition_de_méthode">définition de méthode</a>, que ce soit au sein d'une <a href="/fr/docs/Web/JavaScript/Reference/Classes">classe</a> ou d'un <a href="/fr/docs/Web/JavaScript/Reference/Opérateurs/Initialisateur_objet">littéral objet</a>.</p>
+
+<h2 id="Syntaxe">Syntaxe</h2>
+
+<pre class="syntaxbox">super([arguments]); // Le constructeur parent est appelé
+super.functionOnParent([arguments]);</pre>
+
+<h2 id="Description">Description</h2>
+
+<p>Lorsqu'il est utilisé dans un constructeur, le mot-clé <code>super</code> est utilisé seul et doit apparaître avant le mot-clé <code>this</code>. Ce mot-clé peut également être utilisé afin d'appeler des fonctions sur un objet parent.</p>
+
+<h2 id="Exemples">Exemples</h2>
+
+<h3 id="Utiliser_super_avec_les_classes">Utiliser <code>super</code> avec les classes</h3>
+
+<p>Ce fragment de code est tiré de <a href="https://github.com/GoogleChrome/samples/blob/gh-pages/classes-es6/index.html">cet exemple</a> :</p>
+
+<pre class="brush: js">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 Carré 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é';
+ }
+}</pre>
+
+<h3 id="Utiliser_super_pour_appeler_des_méthodes_statiques">Utiliser super pour appeler des méthodes statiques</h3>
+
+<p>Il est possible d'utiliser super pour invoquer des méthodes <a href="/fr/docs/Web/JavaScript/Reference/Classes/static">statiques</a> :</p>
+
+<pre class="brush: js">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"
+</pre>
+
+<h3 id="Supprimer_des_propriétés_parentes_lèvera_une_exception">Supprimer des propriétés parentes lèvera une exception</h3>
+
+<p>Il n'est pas possible d'utiliser l'opérateur <code><a href="/fr/docs/Web/JavaScript/Reference/Op%C3%A9rateurs/L_op%C3%A9rateur_delete">delete</a></code> sur <code>super.prop</code> ou <code>super[expr]</code> pour supprimer une propriété de la classe parente, cela renverra une exception {{jsxref("ReferenceError")}} :</p>
+
+<pre class="brush: js">class Base {
+ constructor() {}
+ toto() {}
+}
+
+class Dérivée extends Base {
+ constructor() {}
+ delete() {
+ delete super.toto;
+ }
+}
+
+new Dérivée().delete();
+// ReferenceError : suppression invalide avec 'super'</pre>
+
+<h3 id="Super.prop_ne_peut_pas_surcharger_les_propriétés_non_modifiables"><code>Super.prop</code> ne peut pas surcharger les propriétés non modifiables</h3>
+
+<p>Lorsque des propriétés sont définies sans accès en écriture (<em>non-writable</em>), par exemple avec {{jsxref("Object.defineProperty")}}, <code>super</code> ne peut pas surcharger les valeurs de ces propriétés.</p>
+
+<pre class="brush: js">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
+ }
+}
+var y = new Y();
+y.toto(); // TypeError "prop" is read-only
+console.log(y.prop); // 1
+</pre>
+
+<h3 id="Utiliser_super.prop_sur_les_littéraux_objets">Utiliser <code>super.prop</code> sur les littéraux objets</h3>
+
+<p><code>super</code> peut également être utilisé avec la notation littérale. Dans l'exemple qui suit, deux objets définissent chacun une méthode. Le deuxième objet utilise <code>super</code> pour appeler la méthode du premier objet. Cela fonctionne grâce à {{jsxref("Object.setPrototypeOf()")}} avec lequel on définit que le prototype de <code>obj2</code> est <code>obj1</code>. De cette façon, super peut parcourir la chaîne de prototypes et trouver <code>méthode1</code> dans <code>obj1</code>.</p>
+
+<pre class="brush: js">var obj1 = {
+ méthode1() {
+ console.log("méthode 1");
+ }
+}
+
+var obj2 = {
+ méthode2() {
+ super.méthode1();
+ }
+}
+
+Object.setPrototypeOf(obj2, obj1);
+obj2.méthode2(); // affiche "méthode 1" dans la console
+</pre>
+
+<h2 id="Spécifications">Spécifications</h2>
+
+<table class="standard-table">
+ <thead>
+ <tr>
+ <th scope="col">Spécification</th>
+ <th scope="col">État</th>
+ <th scope="col">Commentaires</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>{{SpecName('ES2015', '#sec-super-keyword', 'super')}}</td>
+ <td>{{Spec2('ES2015')}}</td>
+ <td>Définition initiale.</td>
+ </tr>
+ <tr>
+ <td>{{SpecName('ESDraft', '#sec-super-keyword', 'super')}}</td>
+ <td>{{Spec2('ESDraft')}}</td>
+ <td></td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
+
+<div class="hidden">Ce tableau de compatibilité a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une <em>pull request</em> sur <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>.</div>
+
+<p>{{Compat("javascript.operators.super")}}</p>
+
+<h2 id="Voir_aussi">Voir aussi</h2>
+
+<ul>
+ <li><a href="/fr/docs/Web/JavaScript/Reference/Classes">Les classes</a></li>
+</ul>