Skip to content

Commit

Permalink
fr: Convert noteblocks to GFM Alerts (part 18) (#22691)
Browse files Browse the repository at this point in the history
This PR converts the noteblocks for the French locale to GFM Alerts syntax, using a [conversion script](https://github.com/queengooborg/mdn-toolkit/blob/main/upgrade-noteblock.js). This is part 18. Note: manual adjustments have also been made to correct some issues, including capitalization, syntax, duplicated keywords and more.
  • Loading branch information
queengooborg authored Jul 30, 2024
1 parent 714b185 commit 84d0ecd
Show file tree
Hide file tree
Showing 100 changed files with 364 additions and 183 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -205,7 +205,8 @@ let url = "http://xxx.domaine.com";
console.log(/[^.]+/.exec(url)[0].substr(7)); // affiche 'xxx'
```

> **Note :** Cet exemple est uniquement illustratif. Pour analyser une URL, mieux vaudra utiliser les outils adaptés et notamment [l'API URL](/fr/docs/Web/API/URL_API).
> [!NOTE]
> Cet exemple est uniquement illustratif. Pour analyser une URL, mieux vaudra utiliser les outils adaptés et notamment [l'API URL](/fr/docs/Web/API/URL_API).
## Spécifications

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,8 @@ monSet.has(valeur);

Un booléen : `true` s'il existe un élément avec la valeur donnée au sein du `Set`, `false` sinon.

> **Note :** L'existence d'un élément avec la valeur testée est vérifiée avec [l'algorithme d'égalité des valeurs nulles (`sameValueZero`)](/fr/docs/Web/JavaScript/Les_différents_tests_d_égalité#Égalité_de_valeurs_nulles).
> [!NOTE]
> L'existence d'un élément avec la valeur testée est vérifiée avec [l'algorithme d'égalité des valeurs nulles (`sameValueZero`)](/fr/docs/Web/JavaScript/Les_différents_tests_d_égalité#Égalité_de_valeurs_nulles).
## Exemples

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,8 @@ slug: Web/JavaScript/Reference/Global_Objects/String/big

La méthode **`big()`** crée un élément HTML {{HTMLElement("big")}} qui affichera la chaine de caractères avec une taille de police importante.

> **Note :** L'élément `<big>` a été retiré de [HTML5](/fr/docs/Web/Guide/HTML/HTML5) et ne doit pas être utilisé. À la place, les développeurs web doivent utiliser les propriétés [CSS](/fr/docs/Web/CSS).
> [!NOTE]
> L'élément `<big>` a été retiré de [HTML5](/fr/docs/Web/Guide/HTML/HTML5) et ne doit pas être utilisé. À la place, les développeurs web doivent utiliser les propriétés [CSS](/fr/docs/Web/CSS).
## Syntaxe

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,8 @@ slug: Web/JavaScript/Reference/Global_Objects/String/blink

La méthode **`blink()`** crée un élément HTML `<blink>` qui affiche la chaine de caractères en clignotant.

> **Attention :** Les textes clignotants sont fortement déconseillés par de nombreux standards d'accessibilité. L'élément `<blink>` est lui-même non standard et obsolète !
> [!WARNING]
> Les textes clignotants sont fortement déconseillés par de nombreux standards d'accessibilité. L'élément `<blink>` est lui-même non standard et obsolète !
## Syntaxe

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,8 @@ slug: Web/JavaScript/Reference/Global_Objects/String/fontcolor

La méthode **`fontcolor()`** permet de créer un élément {{HTMLElement("font")}} qui permet d'afficher la chaine de caractères dans une fonte utilisant la couleur donnée.

> **Note :** L'élément \<font> a été retiré dans [HTML5](/fr/docs/Web/Guide/HTML/HTML5) et ne devrait plus être utilisé. Les propriétés [CSS](/fr/docs/Web/CSS) permettent de modifier les aspects de mise en forme et doivent donc être utilisées à la place.
> [!NOTE]
> L'élément \<font> a été retiré dans [HTML5](/fr/docs/Web/Guide/HTML/HTML5) et ne devrait plus être utilisé. Les propriétés [CSS](/fr/docs/Web/CSS) permettent de modifier les aspects de mise en forme et doivent donc être utilisées à la place.
## Syntaxe

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,8 @@ slug: Web/JavaScript/Reference/Global_Objects/String/fontsize

La propriété **`fontsize()`** permet de créer un élément HTML {{HTMLElement("font")}} qui permet d'afficher la chaîne de caractères dans une fonte de taille donnée.

> **Note :** L'élément \<font> a été retiré dans [HTML5](/fr/docs/Web/Guide/HTML/HTML5) et ne devrait plus être utilisé. Les propriétés [CSS](/fr/docs/Web/CSS) permettent de modifier les aspects de mise en forme et doivent donc être utilisées à la place.
> [!NOTE]
> L'élément \<font> a été retiré dans [HTML5](/fr/docs/Web/Guide/HTML/HTML5) et ne devrait plus être utilisé. Les propriétés [CSS](/fr/docs/Web/CSS) permettent de modifier les aspects de mise en forme et doivent donc être utilisées à la place.
## Syntaxe

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -258,7 +258,8 @@ d'être passée à la ligne parce que sinon

## Méthodes de conversion HTML

> **Attention :** Ces méthodes sont dépréciées et ne doivent plus être utilisées.
> [!WARNING]
> Ces méthodes sont dépréciées et ne doivent plus être utilisées.
>
> Elles ont des possibilités limitées et ne concernent qu'une petite sous-partie des éléments et attributs HTML disponibles.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,8 @@ La méthode **`indexOf()`** renvoie l'indice de la première occurence de la val

{{EmbedInteractiveExample("pages/js/string-indexof.html")}}

> **Note :** Pour la méthode associée aux tableaux, voir la page {{jsxref("Array.prototype.indexOf()")}}.
> [!NOTE]
> Pour la méthode associée aux tableaux, voir la page {{jsxref("Array.prototype.indexOf()")}}.
## Syntaxe

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,8 @@ Cette méthode renvoie&nbsp;:
- un nombre positif si elle se situe après
- 0 si les deux chaînes sont équivalentes selon cet ordre.

> **Attention :** Il ne faut pas tester uniquement les valeurs -1 et 1.
> [!WARNING]
> Il ne faut pas tester uniquement les valeurs -1 et 1.
>
> En effet les valeurs entières utilisées peuvent varier en fonction des navigateurs et de leurs versions. En effet, la spécification indique uniquement le signe de la valeur à fournir. Par exemple, certains navigateurs pourront renvoyer -2 ou 2 (voire d'autres valeurs).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -165,7 +165,8 @@ console.log(nouvChn); // Twas the night before Christmas...

Cela affiche 'Twas the night before Christmas...'.

> **Note :** Voir [ce guide](/fr/docs/Web/JavaScript/Guide/Expressions_régulières) pour plus d'explications concernant les expressions régulières.
> [!NOTE]
> Voir [ce guide](/fr/docs/Web/JavaScript/Guide/Expressions_régulières) pour plus d'explications concernant les expressions régulières.
### Utilisation de `global` et `ignore` avec `replace()`

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,8 @@ La chaîne de caractères initiale restera inchangée.
const newStr = str.replaceAll(regexp|substr, newSubstr|function)
```

> **Note :** Quand on utilise une expression rationnelle, il est nécessaire d'utiliser le marqueur global ("g"); autrement, l'exception `TypeError`: _"replaceAll must be called with a global RegExp"_ sera levée.
> [!NOTE]
> Quand on utilise une expression rationnelle, il est nécessaire d'utiliser le marqueur global ("g"); autrement, l'exception `TypeError`: _"replaceAll must be called with a global RegExp"_ sera levée.

### Paramètres

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,8 @@ str.split([separator[, limit]])
- Si `separator` apparaît au début (ou à la fin) de la chaîne, il a quand même l'effet de division. Le résultat est une chaîne vide (c'est-à-dire de longueur nulle), qui apparaît à la première (ou dernière) position du tableau retourné.
- Si `separator` est une chaîne vide (`""`), la chaîne `str` est convertie en un tableau de chacun de ses "caractères" UTF-16.

> **Attention :** Lorsque une chaîne vide (`""`) est utilisée comme séparateur, la chaîne n'est **pas** divisée par des _caractères perçus par l'utilisateur_ ([grappes de graphèmes](https://unicode.org/reports/tr29/#Grapheme_Cluster_Boundaries)) ou des caractères unicodes (codepoints), mais par des unités de code UTF-16. Cela détruit les [paires de substituts](http://unicode.org/faq/utf_bom.html#utf16-2). Voir [« Comment obtenir une chaîne de caractères vers un tableau de caractères en JavaScript ? » sur StackOverflow](https://stackoverflow.com/a/34717402).
> [!WARNING]
> Lorsque une chaîne vide (`""`) est utilisée comme séparateur, la chaîne n'est **pas** divisée par des _caractères perçus par l'utilisateur_ ([grappes de graphèmes](https://unicode.org/reports/tr29/#Grapheme_Cluster_Boundaries)) ou des caractères unicodes (codepoints), mais par des unités de code UTF-16. Cela détruit les [paires de substituts](http://unicode.org/faq/utf_bom.html#utf16-2). Voir [« Comment obtenir une chaîne de caractères vers un tableau de caractères en JavaScript ? » sur StackOverflow](https://stackoverflow.com/a/34717402).
- `limit` Facultatif

Expand Down Expand Up @@ -164,7 +165,8 @@ Ce script affichera :

### Inverser une chaîne en utilisant `split()`

> **Attention :** Ce n'est pas une façon robuste d'inverser une chaîne :
> [!WARNING]
> Ce n'est pas une façon robuste d'inverser une chaîne :
>
> ```js example-bad
> const str = "asdfghjkl";
Expand All @@ -182,7 +184,7 @@ Ce script affichera :
> // => "́emuśer"
> ```
>
> **Bonus :** utiliser l'opérateur [`===`](/fr/docs/Web/JavaScript/Reference/Operators) pour tester si la chaîne d'origine est un palindrome.
> **Bonus :** Utiliser l'opérateur [`===`](/fr/docs/Web/JavaScript/Reference/Operators) pour tester si la chaîne d'origine est un palindrome.

## Spécifications

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,8 @@ slug: Web/JavaScript/Reference/Global_Objects/String/substr

{{JSRef}}

> **Attention :** Bien que `String.prototype.substr(…)` ne soit pas strictement obsolète (au sens où elle n'a pas été retirée des standards), elle est définie au sein de [l'Annexe B](https://www.ecma-international.org/ecma-262/9.0/index.html#sec-additional-ecmascript-features-for-web-browsers) du standard ECMA-262 qui définit l'ensemble des fonctionnalités historiques qui doivent être évitées autant que possible. On utilisera la méthode {{jsxref("String.prototype.substring()")}} à la place.
> [!WARNING]
> Bien que `String.prototype.substr(…)` ne soit pas strictement obsolète (au sens où elle n'a pas été retirée des standards), elle est définie au sein de [l'Annexe B](https://www.ecma-international.org/ecma-262/9.0/index.html#sec-additional-ecmascript-features-for-web-browsers) du standard ECMA-262 qui définit l'ensemble des fonctionnalités historiques qui doivent être évitées autant que possible. On utilisera la méthode {{jsxref("String.prototype.substring()")}} à la place.
La méthode **`substr()`** retourne la partie d'une chaîne de caractères comprise entre l'indice de départ et un certain nombre de caractères après celui-ci.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,8 @@ var fauxTableau = {
x.concat(fauxTableau); // [1, 2, 3, "coucou", "monde"]
```

> **Note :** La propriété `length` indique ici le nombre de propriétés à ajouter au tableau.
> [!NOTE]
> La propriété `length` indique ici le nombre de propriétés à ajouter au tableau.
## Spécifications

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,8 @@ Dans les navigateurs modernes (JavaScript 1.8.5 / Firefox 4+), d'après la spéc

Une variable pour laquelle aucune valeur n'a été assignée sera de type `undefined`. Une méthode ou instruction renvoie également `undefined` si la variable à évaluer n'a pas de valeur assignée. Une fonction renvoie `undefined` si aucune valeur n'a été [renvoyée](/fr/docs/Web/JavaScript/Reference/Statements/return).

> **Attention :** Puisque `undefined` n'est pas un [mot réservé du langage JavaScript](/fr/docs/Web/JavaScript/Reference/Lexical_grammar#mots-clés), il peut être utilisé comme [identifiant](/fr/docs/Glossary/Identifier) (nom de variable) dans toute portée autre que la portée globale. Ceci est une très mauvaise idée pour la lisibilité du code et sa maintenabilité.
> [!WARNING]
> Puisque `undefined` n'est pas un [mot réservé du langage JavaScript](/fr/docs/Web/JavaScript/Reference/Lexical_grammar#mots-clés), il peut être utilisé comme [identifiant](/fr/docs/Glossary/Identifier) (nom de variable) dans toute portée autre que la portée globale. Ceci est une très mauvaise idée pour la lisibilité du code et sa maintenabilité.
>
> ```js example-bad
> // À NE PAS FAIRE
Expand Down Expand Up @@ -57,7 +58,8 @@ if (x === undefined) {
}
```
> **Note :** L'opérateur d'égalité stricte doit être utilisé ici plutôt que l'opérateur _d'égalité simple_. En effet, `x == undefined` vérifie également si `x` vaut `null`, tandis que l'égalité stricte ne le fait pas. `null` n'est pas équivalent à `undefined`.
> [!NOTE]
> L'opérateur d'égalité stricte doit être utilisé ici plutôt que l'opérateur _d'égalité simple_. En effet, `x == undefined` vérifie également si `x` vaut `null`, tandis que l'égalité stricte ne le fait pas. `null` n'est pas équivalent à `undefined`.
>
> Voir la page sur les [opérateurs de comparaison](/fr/docs/Web/JavaScript/Reference/Operators) pour plus de détails.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,8 @@ slug: Web/JavaScript/Reference/Global_Objects/unescape

{{jsSidebar("Objects")}}

> **Attention :** Bien que `unescape(…)` ne soit pas strictement obsolète (au sens où elle n'a pas été retirée des standards), elle est définie au sein de [l'Annexe B](https://www.ecma-international.org/ecma-262/9.0/index.html#sec-additional-ecmascript-features-for-web-browsers) du standard ECMA-262 qui commence par :
> [!WARNING]
> Bien que `unescape(…)` ne soit pas strictement obsolète (au sens où elle n'a pas été retirée des standards), elle est définie au sein de [l'Annexe B](https://www.ecma-international.org/ecma-262/9.0/index.html#sec-additional-ecmascript-features-for-web-browsers) du standard ECMA-262 qui commence par :
>
> > … L'ensemble des fonctionnalités et comportements définis dans cette annexe possède une ou plusieurs caractéristiques indésirables. En l'absence d'une utilisation historique, ces fonctionnalités seraient retirés de la spécification. …
> > … Les développeurs ne devraient pas utiliser ces fonctionnalités et comportements ou présupposer qu'elles existent lors de l'écriture de nouveau code ECMAScript. …
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,8 @@ Un objet **`WeakRef`** permet de tenir une référence faible vers un autre obje

Un objet `WeakRef` contient une référence faible vers un objet, appelé _cible_ ou _référent_. Une _référence faible_ vers un objet est une référence qui n'empêche pas l'objet d'être récupéré par le ramasse-miettes. À l'inverse, une référence normale (aussi qualifiée de _forte_) implique de conserver un objet en mémoire. Lorsqu'un objet n'a plus de référence forte envers lui, le ramasse-miettes du moteur JavaScript peut détruire l'objet et récupérer la mémoire correspondante. Une fois que cela est fait, on ne peut plus accéder à l'objet depuis une référence faible.

> **Note :** Voir la section [À éviter si possible](#à_éviter_si_possible) ci-après. Une utilisation correcte et pertinente de `WeakRef` nécessite une réflexion appuyée. C'est un objet qu'il conviendra d'éviter si possible.
> [!NOTE]
> Voir la section [À éviter si possible](#à_éviter_si_possible) ci-après. Une utilisation correcte et pertinente de `WeakRef` nécessite une réflexion appuyée. C'est un objet qu'il conviendra d'éviter si possible.
## Constructeur

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,8 @@ Les principales différences avec l'objet [`Set`](/fr/docs/Web/JavaScript/Refere
- Contrairement aux `Sets`, les `WeakSets` sont des **ensembles uniquement constitués d'objets** et ne peuvent pas contenir des valeurs de n'importe quel type.
- L'objet `WeakSet` est _faible_&nbsp;: les références vers les objets de l'ensemble sont des références faibles. Si aucune autre référence vers l'objet n'est présente en dehors du `WeakSet`, l'objet pourra alors être nettoyé par le ramasse-miette.

> **Note :** Cela signifie également qu'on ne peut pas lister les objets contenus à un instant donné dans l'ensemble. Les objets `WeakSets` ne sont pas énumérables.
> [!NOTE]
> Cela signifie également qu'on ne peut pas lister les objets contenus à un instant donné dans l'ensemble. Les objets `WeakSets` ne sont pas énumérables.
### Cas d'usage&nbsp;: détecter les références circulaires

Expand Down
3 changes: 2 additions & 1 deletion files/fr/web/javascript/reference/lexical_grammar/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -119,7 +119,8 @@ console.log("Coucou le monde");

Les commentaires d'environnements sont conçus pour fonctionner comme [les _shebangs_ qu'on peut trouver sous Unix](<https://en.wikipedia.org/wiki/Shebang_(Unix)>) et indiquent l'interpréteur à utiliser pour exécuter le script ou le module.

> **Attention :** Bien qu'utiliser un [BOM](https://fr.wikipedia.org/wiki/Indicateur_d%27ordre_des_octets) avant le _hashbang_ fonctionne dans un navigateur, cela n'est pas conseillé. En effet, un BOM empêchera le bon fonctionnement sous Unix/Linux. Utilisez un encodage UTF-8 sans BOM si vous souhaitez exécuter vos scripts depuis une invite de commande.
> [!WARNING]
> Bien qu'utiliser un [BOM](https://fr.wikipedia.org/wiki/Indicateur_d%27ordre_des_octets) avant le _hashbang_ fonctionne dans un navigateur, cela n'est pas conseillé. En effet, un BOM empêchera le bon fonctionnement sous Unix/Linux. Utilisez un encodage UTF-8 sans BOM si vous souhaitez exécuter vos scripts depuis une invite de commande.
Si vous souhaitez placer un commentaire en début de fichier sans indiquer d'environnement d'exécution spécifique, on pourra utiliser le commentaire classique avec `//`.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,8 @@ slug: Web/JavaScript/Reference/Operators/async_function

Le mot-clé **`async function`** peut être utilisé pour définir une fonction asynchrone au sein d'une expression.

> **Note :** Il est aussi possible de définir une fonction asynchrone en utilisant une [instruction `async function`](/fr/docs/Web/JavaScript/Reference/Instructions/async_function).
> [!NOTE]
> Il est aussi possible de définir une fonction asynchrone en utilisant une [instruction `async function`](/fr/docs/Web/JavaScript/Reference/Instructions/async_function).
## Syntaxe

Expand All @@ -26,7 +27,8 @@ async function [name]([param1[, param2[, …, paramN]]]) {
- `instructions`
- : Les instructions qui composent le corps de la fonction.

> **Note :** À partir d'ES2015 (ES6), il est aussi possible d'utiliser des [fonctions fléchées](/fr/docs/Web/JavaScript/Reference/Fonctions/Fonctions_fléchées) pour les expressions de fonction asynchrone.
> [!NOTE]
> À partir d'ES2015 (ES6), il est aussi possible d'utiliser des [fonctions fléchées](/fr/docs/Web/JavaScript/Reference/Fonctions/Fonctions_fléchées) pour les expressions de fonction asynchrone.
## Description

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -218,7 +218,8 @@ let a, b;
({ a, b } = { a: 1, b: 2 });
```

> **Note :** Les parenthèses `( ... )` utilisées autour de l'instruction sont nécessaires pour que la partie gauche soit bien interprétée comme un objet littéral et non comme un bloc. Il est également nécessaire d'avoir un point-virgule avant les parenthèses de l'instruction car sinon, ces parenthèses peuvent être interprétées comme un appel de fonction.
> [!NOTE]
> Les parenthèses `( ... )` utilisées autour de l'instruction sont nécessaires pour que la partie gauche soit bien interprétée comme un objet littéral et non comme un bloc. Il est également nécessaire d'avoir un point-virgule avant les parenthèses de l'instruction car sinon, ces parenthèses peuvent être interprétées comme un appel de fonction.
### Affecter avec un nom différent

Expand Down Expand Up @@ -294,7 +295,8 @@ dessinGrapheES2015({
});
```

> **Note :** Dans la signature de la fonction `dessinGrapheES2015` ci avant, la valeur décomposée à gauche utilise un objet vide comme opérande droit (`{size = 'big', coords = { x: 0, y: 0 }, radius = 25} = {}`). On aurait également pu écrire la fonction sans cet objet vide mais, dans ce cas, il aurait fallu au moins un argument pour utiliser la fonction. Avec cette « forme », `dessinGrapheES2015()` pourra être appelée sans paramètre.
> [!NOTE]
> Dans la signature de la fonction `dessinGrapheES2015` ci avant, la valeur décomposée à gauche utilise un objet vide comme opérande droit (`{size = 'big', coords = { x: 0, y: 0 }, radius = 25} = {}`). On aurait également pu écrire la fonction sans cet objet vide mais, dans ce cas, il aurait fallu au moins un argument pour utiliser la fonction. Avec cette « forme », `dessinGrapheES2015()` pourra être appelée sans paramètre.
### Décomposition imbriquée avec objets et tableaux

Expand Down
Loading

0 comments on commit 84d0ecd

Please sign in to comment.