From 6772831200d14c2436aea2d0c837f40dbf12156f Mon Sep 17 00:00:00 2001 From: SphinxKnight Date: Sun, 26 Sep 2021 13:11:47 +0200 Subject: Prepare Web API section for Markdown conversion (#2464) * Remove summary classes and ids * Remove unecessary hidden * Remove useless span filled with useless attributes / ids * Remove useless font * Remove notranslate * Remove id in other elements than headings * Remove name attributes * Remove 
 for JS w/ language-js class

* Remove 
 for HTML w/ language-html class

* Remove 
 for other lang w/ language-* class

* Rm highlighted line in code samples

* fix links, internal, external, absolute URLs

* missing file from last commit

* Fix styles errors apart from table + some classes

* Fix notes and warnings (+ some other :x)

* fix typo during merge which broke a doc

* aand forgot a conflict

* fix remaining classes of errors except dls and images

* Fix dls

* Fix images (deki/mozillademos) and remaining style issues

* Remove script tag from svg file

* Remove script tag from svg fileS

* Compress SVG files for CI
---
 files/fr/web/api/console/index.html | 82 +++++++++++++++++++------------------
 1 file changed, 42 insertions(+), 40 deletions(-)

(limited to 'files/fr/web/api/console/index.html')

diff --git a/files/fr/web/api/console/index.html b/files/fr/web/api/console/index.html
index 822d90a5da..3fea02614b 100644
--- a/files/fr/web/api/console/index.html
+++ b/files/fr/web/api/console/index.html
@@ -11,11 +11,11 @@ translation_of: Web/API/Console
 ---
 
{{APIRef("Console API")}}

 
-
L'objet console donne accès à la console de débogage du navigateur (par exemple., la Console Web dans Firefox). Les spécificités de fonctionnement varient d'un navigateur à l'autre, mais il y a tout de même un ensemble de fonctionnalités qui sont fournies de base.

+
L'objet console donne accès à la console de débogage du navigateur (par exemple., la Console Web dans Firefox). Les spécificités de fonctionnement varient d'un navigateur à l'autre, mais il y a tout de même un ensemble de fonctionnalités qui sont fournies de base.

 
-
La console est accessible de n'importe quel objet global, {{domxref("Window")}} du cadre de navigation, {{domxref("WorkerGlobalScope")}} et ses variantes spécifiques pour les workers. Elle est exposée comme {{domxref ("Window.console")}} et peut être référencée simplement comme console. Par exemple :

+
La console est accessible de n'importe quel objet global, {{domxref("Window")}} du cadre de navigation, {{domxref("WorkerGlobalScope")}} et ses variantes spécifiques pour les workers. Elle est exposée comme {{domxref ("Window.console")}} et peut être référencée simplement comme console. Par exemple :

 
-
console.log("Failed to open the specified link")

+
console.log("Failed to open the specified link")

 
 
Cette page documente les {{anch("Methods", "méthodes")}} disponibles pour l'objet console et donne quelques {{anch("Usage", "exemples d'utilisation")}}.

 
@@ -35,7 +35,7 @@ translation_of: Web/API/Console
 
 
 

-
Note : À partir de Chromium 58, cette méthode n'apparaît que dans les consoles de navigateur Chromium lorsque le niveau "Verbose" est sélectionné.

+
Note : À partir de Chromium 58, cette méthode n'apparaît que dans les consoles de navigateur Chromium lorsque le niveau "Verbose" est sélectionné.

 

 
 

@@ -46,41 +46,41 @@ translation_of: Web/API/Console
  
Affiche si possible une représentation d'éléments XML/HTML d'un objet spécifié. Sinon, c'est une vue de l'objet JavaScript.

  
  
{{domxref("Console.error()")}}

- 
Affiche un message d'erreur. Vous pouvez utiliser les caractères de substitution et des arguments supplémentaires avec cette méthode.

+ 
Affiche un message d'erreur. Vous pouvez utiliser les caractères de substitution et des arguments supplémentaires avec cette méthode.

  
{{domxref("Console._exception()")}} {{Non-standard_inline}} {{deprecated_inline}}

  
Un alias d'error();

  
{{domxref("Console.group()")}}

- 
Crée un nouveau groupe en ligne, correspondant à un nouveau niveau d'indentation. Contrairement à group(). Pour revenir au niveau précédent, appeler groupEnd().

+ 
Crée un nouveau groupe en ligne, correspondant à un nouveau niveau d'indentation. Contrairement à group(). Pour revenir au niveau précédent, appeler groupEnd().

  
{{domxref("Console.groupCollapsed()")}}

- 
Crée un nouveau groupe en ligne, correspondant à un nouveau niveau d'indentation. Contrairement à group() , cela commence avec le groupe en ligne effondré, nécessitant l'utilisation d'un bouton de divulgation pour l'agrandir. Pour revenir au niveau précédent, appeler groupEnd().

+ 
Crée un nouveau groupe en ligne, correspondant à un nouveau niveau d'indentation. Contrairement à group() , cela commence avec le groupe en ligne effondré, nécessitant l'utilisation d'un bouton de divulgation pour l'agrandir. Pour revenir au niveau précédent, appeler groupEnd().

  
{{domxref("Console.groupEnd()")}}

- 
Quitte le groupe d'indentation courant.

+ 
Quitte le groupe d'indentation courant.

  
{{domxref("Console.info()")}}

- 
Affiche un message d'information. Vous pouvez utiliser les caractères de substitution et des arguments supplémentaires avec cette méthode.

+ 
Affiche un message d'information. Vous pouvez utiliser les caractères de substitution et des arguments supplémentaires avec cette méthode.

  
{{domxref("Console.log()")}}

- 
Permet d'afficher des messages dans la console. Vous pouvez utiliser les caractères de substitution et des arguments supplémentaires avec cette méthode.

+ 
Permet d'afficher des messages dans la console. Vous pouvez utiliser les caractères de substitution et des arguments supplémentaires avec cette méthode.

  
{{domxref("Console.profile()")}} {{Non-standard_inline}}

- 
démarre le profilage du navigateur (par exemple, l'outil performances de Firefox). Vous pouvez spécifier un nom en option pour ce profil.

+ 
démarre le profilage du navigateur (par exemple, l'outil performances de Firefox). Vous pouvez spécifier un nom en option pour ce profil.

  
{{domxref("Console.profileEnd()")}} {{Non-standard_inline}}

- 
Arrête le profilage. Vous pouvez voir le résultat de ce dernier dans l'outil « performance » du navigateur (par exemple, l'outil performance Firefox).

+ 
Arrête le profilage. Vous pouvez voir le résultat de ce dernier dans l'outil « performance » du navigateur (par exemple, l'outil performance Firefox).

  
{{domxref("Console.table()")}}

  
Affiche des données tabulaires comme un tableau.

  
{{domxref("Console.time()")}}

- 
Démarre un chronomètre que l'on peut nommer en le spécifiant en tant que paramètre. Jusqu'à 10 000 chronomètres simultanés peuvent tourner sur une page.

+ 
Démarre un chronomètre que l'on peut nommer en le spécifiant en tant que paramètre. Jusqu'à 10 000 chronomètres simultanés peuvent tourner sur une page.

  
{{domxref("Console.timeEnd()")}}

- 
Arrête le chronomètre spécifié et affiche le temps écoulé en millisecondes depuis son démarrage.

+ 
Arrête le chronomètre spécifié et affiche le temps écoulé en millisecondes depuis son démarrage.

  
{{domxref("Console.timeStamp()")}} {{Non-standard_inline}}

- 
Ajoute un marqueur dans la Timeline du navigateur ou l'outil Waterfall.

+ 
Ajoute un marqueur dans la Timeline du navigateur ou l'outil Waterfall.

  
{{domxref("Console.trace()")}}

- 
Affiche une trace d'appels.

+ 
Affiche une trace d'appels.

  
{{domxref("Console.warn()")}}

- 
Affiche un message d'avertissement. Vous pouvez utiliser les caractères de substitution et des arguments supplémentaires avec cette méthode.

+ 
Affiche un message d'avertissement. Vous pouvez utiliser les caractères de substitution et des arguments supplémentaires avec cette méthode.

 

 
 
-
Exemples d'utilisation

+
Exemples d'utilisation

 
-
Afficher du texte dans la console

+
Afficher du texte dans la console

 
 
La fonction la plus utilisée de la console est d'afficher du texte ou autres données. Il y a quatre sortes d'affichages que vous pouvez générer, en utilisant les méthodes {{domxref("console.log()")}}, {{domxref("console.info()")}}, {{domxref("console.warn()")}}, et {{domxref("console.error()")}}. Chacune de ces méthodes génére un affichage différent dans la console, et vous pouvez utiliser les fonctions de filtrage du navigateur pour voir uniquement les types de sortie qui vous intéressent.

 
@@ -115,7 +115,7 @@ console.info("My first car was a", car, ". The object is: ", someObject);

 
 
Gecko 9.0 {{geckoRelease("9.0")}} a amené le support des caractères de substitution. Lorsque l'on passe en argument une chaîne à l'une des méthodes qui acceptent des chaînes de caractère, on peut utiliser ces caractères de substitution :

 
-
+

@@ -127,7 +127,7 @@ console.info("My first car was a", car, ". The object is: ", someObject);
-   
+   
@@ -160,23 +160,23 @@ console.info("My first car was a", car, ". The object is: ", someObject);
Vous pouvez utiliser l'instruction "%c" pour appliquer du style CSS à l'affichage de la console :

 
-
console.log("This is %cMy stylish message", "color: yellow; font-style: italic; background-color: blue;padding: 2px");

-
-

+
console.log("This is %cMy stylish message", "color: yellow; font-style: italic; background-color: blue;padding: 2px");

 
-
 

+

-
 Note : Un certain nombre de propriétés CSS sont supportées par ce style; vous devriez expérimenter et voir lesquels s'avèrent utiles.

+
Note : Un certain nombre de propriétés CSS sont supportées par ce style; vous devriez expérimenter et voir lesquels s'avèrent utiles.

 
{{h3_gecko_minversion("Using groups in the console", "9.0")}}
Vous pouvez utiliser des groupes imbriqués pour vous aider à vous repérer dans l'affichage. Pour créer un nouveau bloc, appelez console.group(). La méthode console.groupCollapsed() est similaire, mais elle crée un bloc qui sera réduit.

 
-
Note  : "Collapsed groups" ne sont pas supportés pour l'instant dans Gecko; La méthode groupCollapsed() est la même que group() en ce moment.

+

+  
Note : "Collapsed groups" ne sont pas supportés pour l'instant dans Gecko; La méthode groupCollapsed() est la même que group() en ce moment.

+

 
-
Pour quitter le groupe dans lequel on est, appeler console.groupEnd(). Par exemple, examinez ce code :

+
Pour quitter le groupe dans lequel on est, appeler console.groupEnd(). Par exemple, examinez ce code :
console.log("This is the outer level");
 console.group();
@@ -192,7 +192,7 @@ console.debug("Back to the outer level");
 
 
L'affichage ressemblera à ceci :

 
-
nesting.png

+
Démonstration de groupes imbriqués dans la console Firefox

 
 
{{h3_gecko_minversion("Timers", "10.0")}}

 
@@ -207,11 +207,13 @@ console.timeEnd("answer time");
 
 
affichera le temps pour l'utilisateur dont il a eu besoin pour faire disparaitre la fenêtre d'alerte :

 
-
timerresult.png

+

 
 
Notez que le nom du chronomètre est affiché deux fois, à son départ et quand il se termine.

 
-
Note: Il est important de noter que si vous vous servez de ceci pour enregistrer les durées du traffic réseau, le chronomètre renverra le temps total d'échanges, alors que les durées affichées dans l'onglet network représente seulement la durée à la réception du header. Si vous avez activer l'enregistrement de réponse du body, le temps listé pour la réponse du header et du body devrait correspondre à ce qu'affiche la sortie de la console.

+

+  
Note: Il est important de noter que si vous vous servez de ceci pour enregistrer les durées du traffic réseau, le chronomètre renverra le temps total d'échanges, alors que les durées affichées dans l'onglet network représente seulement la durée à la réception du header. Si vous avez activer l'enregistrement de réponse du body, le temps listé pour la réponse du header et du body devrait correspondre à ce qu'affiche la sortie de la console.

+

 
 
Traces d'appel

 
@@ -229,9 +231,9 @@ function foo() {
 
 
L'affichage dans la console ressemblera à ceci :

 
-

+

 
-
Spécification

+
Spécification

 
 

  
   

    caractère de substitution
   

   

    %d or %iAffiche un entier. Le formatage des nombres est supporté, par exemple console.log ("Foo% .2d", 1.1) affichera le nombre sous forme de deux chiffres significatifs avec un 0 : Foo 01Affiche un entier. Le formatage des nombres est supporté, par exemple console.log ("Foo% .2d", 1.1) affichera le nombre sous forme de deux chiffres significatifs avec un 0 : Foo 01
   

   

    %s
 
 
 
 
 
 
 
 
 
 

@@ -251,18 +253,18 @@ function foo() {
 
Notes
    
- 
  • Au moins dans Firefox, si une page définit un objet console, cet objet remplace celui créé dans Firefox.
    • 
- 
  • Antérieur à {{Gecko ("12.0")}}, les méthodes de l'objet console ne fonctionnent que lorsque la console Web est ouverte. À partir de {{Gecko ("12.0")}}, la sortie est mise en cache jusqu'à ce que la console Web soit ouverte, puis affichée à ce moment-là.
    • 
- 
  • Il est à noter que l'objet de console intégré de Firefox est compatible avec celui fourni par Firebug.
    • 
+ 
  • Au moins dans Firefox, si une page définit un objet console, cet objet remplace celui créé dans Firefox.
    • 
+ 
  • Antérieur à {{Gecko ("12.0")}}, les méthodes de l'objet console ne fonctionnent que lorsque la console Web est ouverte. À partir de {{Gecko ("12.0")}}, la sortie est mise en cache jusqu'à ce que la console Web soit ouverte, puis affichée à ce moment-là.
    • 
+ 
  • Il est à noter que l'objet de console intégré de Firefox est compatible avec celui fourni par Firebug.
    • 
 
Voir aussi
Autres implémentations

-- 
cgit v1.2.3-54-g00ecf