mdn · SphinxKnight · Jul 28, 2023 · Jul 27, 2023
@@ -11,7 +11,7 @@ La méthode **`sub()`** crée un élément HTML {{HTMLElement("sub")}} qui entra
 ## Syntaxe
 
 ```js
-str.sub()
+str.sub();
 ```
 
 ### Valeur de retour

@@ -50,16 +50,16 @@ Pour `début` comme pour `longueur`, NaN est traité comme 0.
 ## Exemples
 
 ```js
-var uneChaine = 'Mozilla';
-
-console.log(uneChaine.substr(0, 1));   // 'M'
-console.log(uneChaine.substr(1, 0));   // ''
-console.log(uneChaine.substr(-1, 1));  // 'a'
-console.log(uneChaine.substr(1, -1));  // ''
-console.log(uneChaine.substr(-3));     // 'lla'
-console.log(uneChaine.substr(1));      // 'ozilla'
+var uneChaine = "Mozilla";
+
+console.log(uneChaine.substr(0, 1)); // 'M'
+console.log(uneChaine.substr(1, 0)); // ''
+console.log(uneChaine.substr(-1, 1)); // 'a'
+console.log(uneChaine.substr(1, -1)); // ''
+console.log(uneChaine.substr(-3)); // 'lla'
+console.log(uneChaine.substr(1)); // 'ozilla'
 console.log(uneChaine.substr(-20, 2)); // 'Mo'
-console.log(uneChaine.substr(20, 2));  // ''
+console.log(uneChaine.substr(20, 2)); // ''
 ```
 
 ## Prothèse d'émulation (_polyfill_)
@@ -68,23 +68,25 @@ JScript de Microsoft ne supporte pas les valeurs négatives pour l'indice de dé
 
 ```js
 // N'appliquer que lorsque la fonction est incomplète
-if ('ab'.substr(-1) != 'b') {
+if ("ab".substr(-1) != "b") {
   /**
    *  Obtenir la sous-chaîne d'une chaîne
    *  @param  {entier}  début     où démarrer la sous-chaîne
    *  @param  {entier}  longueur combien de caractères à retourner
    *  @return {chaîne}
    */
-  String.prototype.substr = function(substr) {
-    return function(début, longueur) {
+  String.prototype.substr = (function (substr) {
+    return function (début, longueur) {
       // Appel de la méthode originale
-      return substr.call(this,
+      return substr.call(
+        this,
         // Si on a un début négatif, calculer combien il vaut à partir du début de la chaîne
         // Ajuster le paramètre pour une valeur négative
         début < 0 ? this.length + début : début,
-        longueur)
-    }
-  }(String.prototype.substr);
+        longueur,
+      );
+    };
+  })(String.prototype.substr);
 }
 ```
 

@@ -48,20 +48,20 @@ Les exemples suivants utilisent la méthode `substring()` pour extraire et affic
 var uneChaîne = "Mozilla";
 
 // Affiche "Moz"
-console.log(uneChaîne.substring(0,3));
-console.log(uneChaîne.substring(3,0));
+console.log(uneChaîne.substring(0, 3));
+console.log(uneChaîne.substring(3, 0));
 
 // Affiche "lla"
-console.log(uneChaîne.substring(4,7));
+console.log(uneChaîne.substring(4, 7));
 console.log(uneChaîne.substring(4));
-console.log(uneChaîne.substring(7,4));
+console.log(uneChaîne.substring(7, 4));
 
 // Affiche "Mozill"
-console.log(uneChaîne.substring(0,6));
+console.log(uneChaîne.substring(0, 6));
 
 // Affiche "Mozilla"
-console.log(uneChaîne.substring(0,7));
-console.log(uneChaîne.substring(0,10));
+console.log(uneChaîne.substring(0, 7));
+console.log(uneChaîne.substring(0, 10));
 ```
 
 ### Remplacer une sous-chaîne dans une chaîne
@@ -70,10 +70,13 @@ L'exemple suivant remplace une partie d'une chaine. Elle remplace à la fois les
 
 ```js
 function replaceString(oldS, newS, fullS) {
-// On remplace oldS avec newS dans fullS
+  // On remplace oldS avec newS dans fullS
   for (var i = 0; i < fullS.length; i++) {
     if (fullS.substring(i, i + oldS.length) == oldS) {
-     fullS = fullS.substring(0, i) + newS + fullS.substring(i + oldS.length, fullS.length);
+      fullS =
+        fullS.substring(0, i) +
+        newS +
+        fullS.substring(i + oldS.length, fullS.length);
     }
   }
   return fullS;
@@ -85,7 +88,7 @@ replaceString("World", "Web", "Brave New World");
 Attention : ceci peut résulter en une boucle infinie si `oldS` est elle-même une sous-chaine de `newS` — par exemple, si on essaie de remplacer "World" par "OtherWorld". Une meilleure solution serait de remplacer les chaines de cette manière :
 
 ```js
-function replaceString(oldS, newS,fullS){
+function replaceString(oldS, newS, fullS) {
   return fullS.split(oldS).join(newS);
 }
 ```
@@ -100,8 +103,8 @@ Les arguments de la méthode `substring()` représentent les indices de début e
 
 ```js
 var texte = "Mozilla";
-console.log(texte.substring(2,5)); // => "zil"
-console.log(texte.substr(2,3)); // => "zil"
+console.log(texte.substring(2, 5)); // => "zil"
+console.log(texte.substr(2, 3)); // => "zil"
 ```
 
 ### Différences entre `substring()` et `slice()`
@@ -111,9 +114,9 @@ Les méthodes `substring()` et {{jsxref("String.slice", "slice()")}} sont très
 La méthode `substring()` échangera les deux arguments si `indiceA` est supérieur à `indiceB` et renverra donc une chaîne de caractères. La méthode {{jsxref("String.slice", "slice()")}} n'échange pas les arguments et renvoie donc une chaîne vide si le premier est supérieur au second :
 
 ```js
-var text = 'Mozilla';
+var text = "Mozilla";
 console.log(text.substring(5, 2)); // => "zil"
-console.log(text.slice(5, 2));     // => ""
+console.log(text.slice(5, 2)); // => ""
 ```
 
 Si l'un ou l'autre des arguments sont négatifs ou valent `NaN`, la méthode `substring()` les traitera comme s'ils valaient `0`.

@@ -11,7 +11,7 @@ La méthode **`sup()`** crée un élément HTML {{HTMLElement("sup")}} qui entra
 ## Syntaxe
 
 ```js
-str.sup()
+str.sup();
 ```
 
 ### Valeur de retour

@@ -43,8 +43,8 @@ On notera également que la conversion ne repose pas sur une correspondance un
 ## Exemples
 
 ```js
-"alphabet".toLocaleUpperCase();       // "ALPHABET"
-'Gesäß'.toLocaleUpperCase();          // 'GESÄSS'
+"alphabet".toLocaleUpperCase(); // "ALPHABET"
+"Gesäß".toLocaleUpperCase(); // 'GESÄSS'
 "i\u0307".toLocaleUpperCase("lt-LT"); // "I"
 ```
 

@@ -13,7 +13,7 @@ La méthode **`toLowerCase()`** retourne la chaîne de caractères courante en m
 ## Syntaxe
 
 ```js
-str.toLowerCase()
+str.toLowerCase();
 ```
 
 ### Valeur de retour
@@ -27,7 +27,7 @@ La méthode `toLowerCase()` renvoie la valeur de la chaîne convertie en minuscu
 ## Exemples
 
 ```js
-console.log( "ALPHABET".toLowerCase() ); // "alphabet"
+console.log("ALPHABET".toLowerCase()); // "alphabet"
 ```
 
 ## Spécifications

@@ -13,7 +13,7 @@ La méthode **`toString()`** renvoie une chaine de caractères représentant l'o
 ## Syntaxe
 
 ```js
-str.toString()
+str.toString();
 ```
 
 ### Valeur de retour

@@ -13,7 +13,7 @@ La méthode **`toUpperCase()`** retourne la valeur de la chaîne courante, conve
 ## Syntaxe
 
 ```js
-str.toUpperCase()
+str.toUpperCase();
 ```
 
 ### Valeur de retour
@@ -34,7 +34,7 @@ La méthode `toUpperCase()` retourne la valeur de la chaîne convertie en majusc
 ### Utiliser `toUpperCase()`
 
 ```js
-console.log( "alphabet".toUpperCase() ); // "ALPHABET"
+console.log("alphabet".toUpperCase()); // "ALPHABET"
 ```
 
 ### Convertir une valeur `this` en chaîne de caractères
@@ -43,9 +43,9 @@ Cette peut être utilisée pour convertir une valeur qui n'est pas une chaîne d
 
 ```js
 var obj = {
-  toString: function toString(){
-    return 'abcdef';
-  }
+  toString: function toString() {
+    return "abcdef";
+  },
 };
 var a = String.prototype.toUpperCase.call(obj);
 var b = String.prototype.toUpperCase.call(true);

@@ -13,7 +13,7 @@ La méthode **`trim()`** permet de retirer les blancs en début et fin de chaîn
 ## Syntaxe
 
 ```js
-str.trim()
+str.trim();
 ```
 
 ### Valeur de retour
@@ -29,12 +29,12 @@ La méthode `trim()` renvoie la chaîne sans blanc au début et à la fin. La m
 L'exemple qui suit affiche la chaîne `'toto'` :
 
 ```js
-var chaîneOriginale = '   toto  ';
+var chaîneOriginale = "   toto  ";
 console.log(chaîneOriginale.trim()); // 'toto'
 
 // Un autre exemple de .trim() qui enlève les espaces juste d'un côté
 
-var chaîneOriginale = 'toto    ';
+var chaîneOriginale = "toto    ";
 console.log(chaîneOriginale.trim()); // 'toto'
 ```
 
@@ -45,7 +45,7 @@ Si l'environnement utilisé ne possède pas cette méthode, il est possible de l
 ```js
 if (!String.prototype.trim) {
   String.prototype.trim = function () {
-    return this.replace(/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g, '');
+    return this.replace(/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g, "");
   };
 }
 ```

@@ -35,7 +35,7 @@ String.prototype.trimRight.name === "trimEnd";
 
 ## Exemples
 
-L'exemple qui suit illustre comment afficher la chaîne "   toto":
+L'exemple qui suit illustre comment afficher la chaîne " toto":
 
 ```js
 var str = "   toto  ";
@@ -44,7 +44,7 @@ console.log(str.length); // 9
 
 str = str.trimEnd();
 console.log(str.length); // 7
-console.log(str);        // "   toto"
+console.log(str); // "   toto"
 ```
 
 ## Spécifications

@@ -44,7 +44,7 @@ console.log(str.length); // 8
 
 str = str.trimStart();
 console.log(str.length); // 5
-console.log(str);        // "toto  "
+console.log(str); // "toto  "
 ```
 
 ## Spécifications

@@ -13,7 +13,7 @@ La méthode **`valueOf()`** renvoie la valeur primitive de l'objet {{jsxref("Str
 ## Syntaxe
 
 ```js
-str.valueOf()
+str.valueOf();
 ```
 
 ### Valeur de retour

@@ -22,20 +22,20 @@ Il est possible de définir son propre itérable en définissant la propriété
 
 ```js
 const myAsyncIterable = new Object();
-myAsyncIterable[Symbol.asyncIterator] = async function*() {
-    yield "coucou";
-    yield "l'itération";
-    yield "asynchrone !";
+myAsyncIterable[Symbol.asyncIterator] = async function* () {
+  yield "coucou";
+  yield "l'itération";
+  yield "asynchrone !";
 };
 
 (async () => {
-    for await (const x of myAsyncIterable) {
-        console.log(x);
-        // expected output:
-        //    "coucou"
-        //    "l'itération"
-        //    "asynchrone !"
-    }
+  for await (const x of myAsyncIterable) {
+    console.log(x);
+    // expected output:
+    //    "coucou"
+    //    "l'itération"
+    //    "asynchrone !"
+  }
 })();
 ```
 

@@ -13,9 +13,9 @@ La propriété en lecture seule **`description`** est une chaîne de caractères
 ## Syntaxe
 
 ```js
-Symbol('maDescription').description;
+Symbol("maDescription").description;
 Symbol.iterator.description;
-Symbol.for('toto').description;
+Symbol.for("toto").description;
 ```
 
 ## Description
@@ -25,18 +25,18 @@ Les objets {{jsxref("Symbol")}} peuvent être créés avec une description facul
 ## Exemples
 
 ```js
-Symbol('desc').toString();   // "Symbol(desc)"
-Symbol('desc').description;  // "desc"
-Symbol('').description;      // ""
-Symbol().description;        // undefined
+Symbol("desc").toString(); // "Symbol(desc)"
+Symbol("desc").description; // "desc"
+Symbol("").description; // ""
+Symbol().description; // undefined
 
 // symboles connus
-Symbol.iterator.toString();  // "Symbol(Symbol.iterator)"
+Symbol.iterator.toString(); // "Symbol(Symbol.iterator)"
 Symbol.iterator.description; // "Symbol.iterator"
 
 // symboles globaux
-Symbol.for('toto').toString();  // "Symbol(toto)"
-Symbol.for('toto').description; // "toto"
+Symbol.for("toto").toString(); // "Symbol(toto)"
+Symbol.for("toto").description; // "toto"
 ```
 
 ## Spécifications