Skip to content

Commit

Permalink
fr: Format /web/javascript using Prettier (part 9) (#14648)
Browse files Browse the repository at this point in the history
  • Loading branch information
queengooborg committed Jul 28, 2023
1 parent d413f21 commit 670eb49
Show file tree
Hide file tree
Showing 100 changed files with 637 additions and 603 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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_)
Expand All @@ -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);
}
```

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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;
Expand All @@ -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);
}
```
Expand All @@ -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()`
Expand All @@ -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`.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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"
```

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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
Expand All @@ -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);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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'
```

Expand All @@ -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, "");
};
}
```
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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 ";
Expand All @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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 !"
}
})();
```

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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
Expand Down
Loading

0 comments on commit 670eb49

Please sign in to comment.