Update console and children

files/fr/web/api/console/assert_static/index.md

@@ -1,38 +1,63 @@
 ---
-title: Console.assert()
+title: "console : méthode statique assert()"
 slug: Web/API/console/assert_static
-original_slug: Web/API/console/assert
+l10n:
+  sourceCommit: 022399901bdc60df947ee15e11a49be029e290d0
 ---
 
 {{APIRef("Console API")}}
 
-Affiche un message d'erreur dans la console si l'assertion est fausse. Si l'assertion est vraie, rien ne se produit.
+La méthode **`console.assert()`** permet d'écrire un message d'erreur dans la console si l'assertion passée en argument est fausse. Si l'assertion est bien vérifiée, rien ne se passe.
 
 {{AvailableInWorkers}}
 
-> **Note :** _La méthode `console.assert()` est implémentée différement dans les vieilles version de Node.js que dans celle disponible dans les navigateurs._
->
-> Plus précisément, dans les navigateurs, appeler `console.assert()` avec une condition fausse affichera le `message` dans la console sans interrompre l'éxecution du code suivant. Dans les versions inférieure à la v10 de Node.js, cependant, une assertion fausse lèvera une exception `AssertionError`. Cette différence de comportement a été corrigée par la v10 de Node et `console.assert()` se comporte maintenant de la même façon dans Node et dans les navigateurs.
-
 ## Syntaxe
 
-```js
-console.assert(assertion, obj1 [, obj2, ..., objN]);
-console.assert(assertion, msg [, subst1, ..., substN]);
+```js-nolint
+assert(assertion, obj1)
+assert(assertion, obj1, obj2)
+assert(assertion, obj1, obj2, /* …, */ objN)
+
+assert(assertion, msg)
+assert(assertion, msg, subst1)
+assert(assertion, msg, subst1, /* …, */ substN)
 ```
 
 ### Paramètres
 
 - `assertion`
-  - : N'importe quelle expression booléenne. Si l'assertion est fausse, le message s'affichera dans la console.
-- `obj1` ... `objN`
-  - : Une liste d'objets javascript à afficher. La représentation textuelle de chacun de ces objets est ajoutée à la suite de la précédente dans l'ordre donné et est ensuite affichée.
+  - : Une expression booléenne. Si l'assertion est fausse, le message est affiché dans la console.
+- `obj1` … `objN`
+  - : Une liste d'objets JavaScript à afficher. Les représentations en chaînes de caractères de ces objets sont concaténés dans l'ordre et affichés dans la console.
 - `msg`
-  - : Une chaîne de caractères javascript contenant zéro ou plus chaîne(s) de caractères de substitution.
-- `subst1` ... `substN`
-  - : L'objet javascript avec lequel remplacer les chaînes de substitution dans `msg`. Ceci vous offre plus de contrôle sur ce qui est affiché.
+  - : Une chaîne de caractères JavaScript qui contient zéro ou plusieurs chaînes de substitution.
+- `subst1` … `substN`
+  - : Des objets JavaScript avec lesquels remplacer les chaînes de substitution dans `msg`. Ce paramètre permet un contrôle supplémentaire sur le format de ce qui est affiché.
+
+### Valeur de retour
+
+Aucune ([`undefined`](/fr/docs/Web/JavaScript/Reference/Global_Objects/undefined)).
+
+## Exemples
 
-Allez voir [Afficher du texte dans la console](/fr/docs/Web/API/console#Outputting_text_to_the_console) dans la documentation de {{domxref("console")}} pour plus de détails.
+Dans l'exemple suivant, on illustre comment utiliser un objet comme deuxième argument :
+
+```js
+const messageErreur = "le nombre n'est pas pair";
+for (let nombre = 2; nombre <= 5; nombre++) {
+  console.log(`le nombre est ${nombre}`);
+  console.assert(nombre % 2 === 0, "%o", { nombre, messageErreur });
+}
+// Ce qui est affiché dans la console :
+// le nombre est 2
+// le nombre est 3
+// Assertion failed: {nombre: 3, messageErreur: "le nombre n'est pas pair"}
+// le nombre est 4
+// le nombre est 5
+// Assertion failed: {nombre: 5, messageErreur: "le nombre n'est pas pair"}
+```
+
+Voir [la page sur les chaînes de caractères de substitution avec `console`](/fr/docs/Web/API/console#utiliser_les_caractères_de_substitution) pour plus de détails.
 
 ## Spécifications
 
@@ -41,10 +66,3 @@ Allez voir [Afficher du texte dans la console](/fr/docs/Web/API/console#Outputti
 ## Compatibilité des navigateurs
 
 {{Compat}}
-
-## Voir aussi
-
-- [WHATWG Console Standard: console.assert](https://console.spec.whatwg.org/#assert-condition-data)
-- [Opera Dragonfly documentation: Console](http://www.opera.com/dragonfly/documentation/console/)
-- [MSDN: Using the F12 Tools Console to View Errors and Status](http://msdn.microsoft.com/library/gg589530)
-- [Chrome Developer Tools: Using the Console](https://developer.chrome.com/devtools/docs/console#assertions)

files/fr/web/api/console/clear_static/index.md

@@ -1,33 +1,32 @@
 ---
-title: clear()
+title: "console : méthode statique clear()"
 slug: Web/API/console/clear_static
-original_slug: Web/API/console/clear
+l10n:
+  sourceCommit: 022399901bdc60df947ee15e11a49be029e290d0
 ---
 
 {{APIRef("Console API")}}
 
-Vide la console.
-
-Tous les messages de la console seront supprimés et remplacés par un message de confirmation ("Console was cleared").
-
-À noter: sur Google Chrome, `console.clear()` n'a aucun effet si l'utilisateur a coché "Preserve log upon navigation" dans les [paramètres de l'inspecteur](https://developer.chrome.com/devtools/docs/settings#preserve-log%20upon%20navigation).
+La méthode **`console.clear()`** vide l'affichage de la console, si celle-ci le permet. Une console graphique, comme celle utilisée par les navigateurs, autorisera ce vidage, tandis qu'une console affichée dans un terminal (comme celle de Node.js), ne prendra pas en charge ce comportement et la méthode n'aura pas d'effet (et ne déclenchera pas d'erreur non plus).
 
 ## Syntaxe
 
-```js
-console.clear();
+```js-nolint
+clear()
 ```
 
+### Paramètres
+
+Aucune.
+
+### Valeur de retour
+
+Aucune ([`undefined`](/fr/docs/Web/JavaScript/Reference/Global_Objects/undefined)).
+
 ## Spécifications
 
 {{Specifications}}
 
 ## Compatibilité des navigateurs
 
 {{Compat}}
-
-## Voir aussi
-
-- [Opera Dragonfly documentation: Console](http://www.opera.com/dragonfly/documentation/console/)
-- [MSDN: Using the F12 Tools Console to View Errors and Status](http://msdn.microsoft.com/library/gg589530)
-- [Chrome Developer Tools: Using the Console](https://developer.chrome.com/devtools/docs/console#assertions)

files/fr/web/api/console/count_static/index.md

@@ -1,83 +1,91 @@
 ---
-title: Console.count()
+title: "console : méthode statique count()"
 slug: Web/API/console/count_static
-original_slug: Web/API/console/count
+l10n:
+  sourceCommit: 022399901bdc60df947ee15e11a49be029e290d0
 ---
 
 {{APIRef("Console API")}}
 
-Affiche dans la console le nombre de fois où la fonction `count()` a été appelée. Cette fonction accepte l'argument optionnel `label`.
+La méthode **`console.count()`** affiche le nombre de fois que `count()` a été appelée (le compteur pouvat être identifié par l'argument passé à la méthode).
 
 {{AvailableInWorkers}}
 
-Si un `label` est passé en paramètre, la fonction affiche le nombre de fois où la fonction `count()` a été appelée pour ce `label` spécifiquempent.
+## Syntaxe
+
+```js-nolint
+count()
+count(libelle)
+```
+
+### Paramètres
+
+- `libelle` {{Optional_Inline}}
+  - : Une chaîne de caractères. Si cet argument est fourni, `count()` affiche le nombre de fois qu'elle a été appelée avec ce libellé. Si cet argument est absent, `count()` se comporte comme si elle avait été appelée avec le libellé `"default"`.
 
-Si aucun `label` est passé en paramètre, la fonction affiche le nombre de fois où la fonction `count()` a été appelée jusqu'à présent.
+### Valeur de retour
 
-Ci-dessous, un exemple d'utilisation :
+Aucune ([`undefined`](/fr/docs/Web/JavaScript/Reference/Global_Objects/undefined)).
+
+## Exemples
+
+Prneons le code suivant :
 
 ```js
-function greet() {
+let personne = "";
+
+function salutation() {
   console.count();
-  return "hi " + user;
+  return `Coucou ${personne}`;
 }
 
-var user = "bob";
-greet();
-user = "alice";
-greet();
-greet();
+personne = "bob";
+salutation();
+personne = "alice";
+salutation();
+salutation();
 console.count();
 ```
 
-La console affichera les lignes suivantes :
+L'affichage dans la console ressemblera à :
 
-```
-"<no label>: 1"
-"<no label>: 2"
-"<no label>: 3"
-"<no label>: 1"
+```plain
+"default: 1"
+"default: 2"
+"default: 3"
+"default: 4"
 ```
 
-A noter, la dernière ligne inscrite dans la console fait référence à l'appel de la fonction `count()` de la ligne 11 qui est traité comme un événement indépendant.
+On voit que le libellé affiché est `default`, car aucun libellé explicite n'a été fourni à `count()`.
 
-Si la variable `user` est passée à la fonction comme paramètre `label`, le code ci-dessous génèrera un nouveau compteur lorsque la variable `user` sera modifiée :
+Si on passe la variable `personne` comme argument pour le premier appel à `count()`, puis la chaîne de caractères `"alice"` lors du second appel&nbsp;:
 
 ```js
-function greet() {
-  console.count(user);
-  return "hi " + user;
+let personne = "";
+
+function salutation() {
+  console.count(personne);
+  return `Coucou ${personne}`;
 }
 
-var user = "bob";
-greet();
-user = "alice";
-greet();
-greet();
+personne = "bob";
+salutation();
+personne = "alice";
+salutation();
+salutation();
 console.count("alice");
 ```
 
-La console affichera les lignes suivantes :
+On obtiendra ce résultat&nbsp;:
 
-```
+```plain
 "bob: 1"
 "alice: 1"
 "alice: 2"
 "alice: 3"
 ```
 
-Nous obtenons maintenant deux compteurs distinct basés sur un libellé différent. L'appel de la fonction `count()` avec "alice" à la ligne 11 n'est pas considéré comme un événement indépendant car le compteur existe déjà.
-
-## Syntaxe
-
-```js
-console.count([label]);
-```
-
-## Paramètres
-
-- `label`
-  - : Une chaîne de caractères. Si ce paramètre est renseigné, `count()` affiche le nombre de fois que la fonction a été appelée jusqu'à présent avec ce libellé. S'il est omis, `count()` affiche le nombre de fois que la fonction a été appelée sur cette ligne.
+Et on peut ici compter le nombre d'appels en fonction du libellé passé en argument.
 
 ## Spécifications