recursal/MDN huggingface dataset:
console : méthode statique trace()
==================================

La méthode **`console.trace()`** permet d'afficher la trace de la pile d'appels dans la console.

**Note:** Cette fonctionnalité est disponible via les Web Workers

**Note :** Dans certains navigateurs, `console.trace()` pourra également afficher la séquence des appels et des évènements asynchrones qui ont mené à l'appel courant de `console.trace()` et qui ne sont pas nécessairement dans la pile d'appels, pour aider à déterminer l'origine de la boucle d'évaluation courante.

Voir la section sur le traçage des piles d'appels dans la documentation de `console` pour plus de détails et d'exemples.

Syntaxe
-------


```js
trace()
trace(obj1, /\* …, \*/ objN)
```

### Paramètres

`obj1` … `objN` Facultatif

Zéro ou plusieurs objets à afficher dans la console avec la trace d'appels. Ces objets sont assemblés et formatés comme s'ils avaient été passés à `console.log()`.

### Valeur de retour

Aucune (`undefined`).

Exemples
--------


```js
function toto() {
  function truc() {
    console.trace();
  }
  truc();
}

toto();
```


Avec le fragment de code précédent, on aura la trace suivante dans la console :
```

truc
toto
<anonymous>
```

Spécifications
--------------

| Specification |
| --- |
| Console Standard # trace |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
console : méthode statique debug()
==================================

La méthode **`console.debug()`** affiche un message dans la console pour le débogage. Ce message sera uniquement affiché si la console est configurée pour afficher les messages de débogage. Dans la plupart des cas, le niveau de journalisation se paramètre via l'interface utilisateur de la console. Le niveau de journalisation pourra par exemple être `Débogage` ou `Verbeux`.

**Note:** Cette fonctionnalité est disponible via les Web Workers

Syntaxe
-------


```js
debug(obj1)
debug(obj1, /\* …, \*/ objN)
debug(msg)
debug(msg, subst1, /\* …, \*/ substN)
```

### Paramètres

`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 qui contient zéro ou plusieurs chaînes de substitution qui seront remplacées par `subst1` … `substN` dans l'ordre.

`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é. Voir la page sur les chaînes de caractères de substitution avec `console` pour plus de détails.

Voir Afficher du texte dans la console pour plus de détails.

### Valeur de retour

Aucune (`undefined`).

Spécifications
--------------

| Specification |
| --- |
| Console Standard # debug |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
console : méthode statique count()
==================================

La méthode **`console.count()`** affiche le nombre de fois que `count()` a été appelée (le compteur pouvant être identifié par l'argument passé à la méthode).

**Note:** Cette fonctionnalité est disponible via les Web Workers

Syntaxe
-------


```js
count()
count(libelle)
```

### Paramètres

`libelle` Facultatif

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"`.

### Valeur de retour

Aucune (`undefined`).

Exemples
--------

Prneons le code suivant :


```js
let personne = "";

function salutation() {
  console.count();
  return `Coucou ${personne}`;
}

personne = "bob";
salutation();
personne = "alice";
salutation();
salutation();
console.count();
```


L'affichage dans la console ressemblera à :
```

"default: 1"
"default: 2"
"default: 3"
"default: 4"
```


On voit que le libellé affiché est `default`, car aucun libellé explicite n'a été fourni à `count()`.

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 :


```js
let personne = "";

function salutation() {
  console.count(personne);
  return `Coucou ${personne}`;
}

personne = "bob";
salutation();
personne = "alice";
salutation();
salutation();
console.count("alice");
```


On obtiendra ce résultat :
```

"bob: 1"
"alice: 1"
"alice: 2"
"alice: 3"
```


Et on peut ici compter le nombre d'appels en fonction du libellé passé en argument.

Spécifications
--------------

| Specification |
| --- |
| Console Standard # count |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
console : méthode statique group()
==================================

La méthode **`console.group()`** crée un nouveau groupe dans le journal affiché dans la console. Les messages affichés ensuite seront indentés d'un niveau jusqu'à ce que `console.groupEnd()` soit appelée.

**Note:** Cette fonctionnalité est disponible via les Web Workers

Syntaxe
-------


```js
group()
group(libelle)
```

### Paramètres

`libelle` Facultatif

Un libellé pour identifier le groupe.

### Valeur de retour

Aucune (`undefined`).

Exemples
--------

Vous pouvez utiliser des groupes imbriqués pour organiser l'affichage dans la console et regrouper les messages associés. Pour créer un nouveau bloc imbriqué, on appellera `console.group()`. La méthode `console.groupCollapsed()` est similaire, mais produit un groupe replié par défaut (il faut cliquer sur le symbole de dépliage pour voir les messages).

Pour clôturer le groupe courant, on appellera `console.groupEnd()`. Par exemple, si on a écrit :


```js
console.log("Il s'agit du niveau extérieur");
console.group();
console.log("Niveau 2");
console.group();
console.log("Niveau 3");
console.warn("Un avertissement au niveau 3");
console.groupEnd();
console.log("Retour au niveau 2");
console.groupEnd();
console.log("Retour au niveau extérieur");
```


L'affichage dans la console ressemblera à ceci :

![Une capture d'écran des messages imbriqués dans la sortie de la console.](/fr/docs/Web/API/console/group_static/nesting.png)

Voir Utiliser les groupes dans la console pour plus de détails.

Spécifications
--------------

| Specification |
| --- |
| Console Standard # group |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `console.groupEnd()`
* `console.groupCollapsed()`
console : méthode statique assert()
===================================

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.

**Note:** Cette fonctionnalité est disponible via les Web Workers

Syntaxe
-------


```js
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`

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 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`).

Exemples
--------

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` pour plus de détails.

Spécifications
--------------

| Specification |
| --- |
| Console Standard # assert |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
console : méthode statique timeStamp()
======================================

**Non standard:** Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.

La méthode **`console.timeStamp()`** permet d'ajouter un marqueur de performance pour l'outil de mesure des performances du navigateur (Firefox, Chrome). Cela permet de dresser des corrélations entre un moment dans le code et d'autres évènements mesurés dans la chronologie (comme ceux relatifs à la disposition ou au rendu à l'écran).

Un argument optionnel permet de fournir un libellé pour le marqueur.

**Note:** Cette fonctionnalité est disponible via les Web Workers

Syntaxe
-------


```js
timeStamp(libelle)
```

### Paramètres

`libelle` Facultatif

Un libellé à utiliser pour le marqueur d'horodatage.

### Valeur de retour

Aucune (`undefined`).

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `console.time()`
* `console.timeLog()`
* `console.timeEnd()`
console : méthode statique error()
==================================

La méthode **`console.error()`** permet d'afficher un message d'erreur dans la console.

**Note:** Cette fonctionnalité est disponible via les Web Workers

Syntaxe
-------


```js
error(obj1)
error(obj1, /\* …, \*/ objN)
error(msg)
error(msg, subst1, /\* …, \*/ substN)
```

### Paramètres

`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 qui contient zéro ou plusieurs chaînes de substitution qui seront remplacées par `subst1` … `substN` dans l'ordre.

`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é. Voir la page sur les chaînes de caractères de substitution avec `console` pour plus de détails.

Voir Afficher du texte dans la console pour plus de détails.

### Valeur de retour

Aucune (`undefined`).

Spécifications
--------------

| Specification |
| --- |
| Console Standard # error |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* La documentation Edge sur `console.error()`
* La documentation Chrome sur `console.error()`
console : méthode statique groupEnd()
=====================================

La méthode **`console.groupEnd()`** clôture le groupe courant dans la console. Voir Utiliser les groupes dans la console pour plus de détails et d'exemples.

**Note:** Cette fonctionnalité est disponible via les Web Workers

Syntaxe
-------


```js
groupEnd()
```

### Paramètres

Aucun.

### Valeur de retour

Aucune (`undefined`).

Spécifications
--------------

| Specification |
| --- |
| Console Standard # groupend |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `console.group()`
* `console.groupCollapsed()`
console : méthode statique profileEnd()
=======================================

**Non standard:** Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.

La méthode **`console.profileEnd()`** arrête l'enregistrement d'un profil de performance précédemment initié avec un appel à `console.profile()`.

Un argument facultatif permet d'indiquer le nom du profil en question. Utiliser ce nom permet de cibler un profil donné pour l'arrêt de l'enregistrement lorsque plusieurs profils sont enregistrés.

* Si `console.profileEnd()` est utilisée avec un nom de profil et que celui-ci correspond à un profil en cours d'enregistrement, l'enregistrement de ce profil donné est arrêté.
* Si `console.profileEnd()` est utilisée avec un nom de profil qui ne correspond à aucun profil en cours d'enregistrement, rien ne se passe.
* Si `console.profileEnd()` est utilisée sans nom de profil, c'est le profil dont l'enregistrement a démarré en dernier qui est arrêté.

**Note:** Cette fonctionnalité est disponible via les Web Workers

Syntaxe
-------


```js
profileEnd(nomProfil)
```

### Paramètres

`nomProfil` Facultatif

Le nom à donner au profil.

### Valeur de retour

Aucune (`undefined`).

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `console.profile()`
console : méthode statique timeEnd()
====================================

La méthode **`console.timeEnd()`** arrête un chronomètre qui avait été démarré à l'aide de `console.time()`.

Voir la section sur les chronomètres de la documentation de `console` pour plus de détails et d'exemples.

**Note:** Cette fonctionnalité est disponible via les Web Workers

Syntaxe
-------


```js
timeEnd()
timeEnd(libelle)
```

### Paramètres

`libelle` Facultatif

Une chaîne de caractères qui représente le nom à donner au chronomètre. Lorsque le chronomètre associé est arrêté, la durée écoulée (exprimée en millisecondes) est affichée dans la console avec une indication que la mesure est terminée. Si cet argument est omis, le libellé `"default"` sera utilisé.

### Valeur de retour

Aucune (`undefined`).

Exemples
--------


```js
console.time("ma mesure de temps");
alert("Cliquez pour continuer");
console.timeLog("ma mesure de temps");
alert("Faire d'autres trucs…");
console.timeEnd("ma mesure de temps");
```


Avec le fragment de code ci-avant, on affichera le temps écoulé après que la personne a fermé la première fenêtre modale, puis le temps total pris pour fermer les deux fenêtres :

![L'affichage produit par le chronomètre dans la console de Firefox](/fr/docs/Web/API/console/timeend_static/timer_output.png)

On notera que le nom du chronomètre est affiché avec la durée lors de l'appel à `timeLog()`, puis lors de l'arrêt. Quand on appelle `timeEnd()`, on a en plus le message « chronomètre arrêté » qui précise que le chronomètre est terminé.

Spécifications
--------------

| Specification |
| --- |
| Console Standard # timeend |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `console.time()`
* `console.timeLog()`
console : méthode statique countReset()
=======================================

La méthode **`console.countReset()`** permet de réinitialiser le compteur utilisé avec `console.count()`.

**Note:** Cette fonctionnalité est disponible via les Web Workers

Syntaxe
-------


```js
countReset()
countReset(libelle)
```

### Paramètres

`libelle` Facultatif

Une chaîne de caractères. Si cet argument est fourni, `countReset()` remet à zéro le compteur associé à ce libellé. Si l'argument est absent, `countReset()` remet à zéro le compteur par défaut.

### Valeur de retour

Aucune (`undefined`).

Exemples
--------

Prenons le code suivant par exemple :


```js
let personne = "";

function salutations() {
  console.count();
  return `Coucou ${personne}`;
}

personne = "bob";
salutations();
personne = "alice";
salutations();
salutations();
console.count();
console.countReset();
```


La console affichera ce qui suit :
```

"default: 1"
"default: 2"
"default: 3"
"default: 4"
"default: 0"
```


On voit que l'appel à `console.counterReset()` réinitialise la valeur du compteur par défaut à 0.

Si on passe la variable `personne` en paramètre pour le libellé (ici d'abord avec `"bob"`, puis avec `"alice"`) :


```js
let personne = "";

function salutations() {
  console.count(personne);
  return `Coucou ${personne}`;
}

personne = "bob";
salutations();
personne = "alice";
salutations();
salutations();
console.countReset("bob");
console.count("alice");
```


On obtiendra le résultat suivant :
```

"bob: 1"
"alice: 1"
"alice: 2"
"bob: 0"
"alice: 3"
```


En réinitialisant la valeur du compteur `"bob"`, on ne modifie pas pour autant le compteur `"alice"`.

Spécifications
--------------

| Specification |
| --- |
| Console Standard # countreset |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
console : méthode statique warn()
=================================

La méthode **`console.warn()`** affiche un message d'avertissement dans la console.

**Note:** Cette fonctionnalité est disponible via les Web Workers

**Note :** Dans Chrome et Firefox, les avertissements sont indiqués par un triangle avec un point d'exclamation.

Syntaxe
-------


```js
warn(obj1)
warn(obj1, /\* …, \*/ objN)
warn(msg)
warn(msg, subst1, /\* …, \*/ substN)
```

### Paramètres

`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 qui contient zéro ou plusieurs chaînes de substitution qui seront remplacées par `subst1` … `substN` dans l'ordre.

`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é. Voir la page sur les chaînes de caractères de substitution avec `console` pour plus de détails.

Voir Afficher du texte dans la console pour plus de détails.

### Valeur de retour

Aucune (`undefined`).

Spécifications
--------------

| Specification |
| --- |
| Console Standard # warn |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Documentation Edge
* Documentation Node.JS sur l'API Console
* Documentation Chrome
console : méthode statique info()
=================================

La méthode **`console.info()`** affiche un message d'information dans la console. Le navigateur ou le moteur JavaScript pourra indiquer ce contenu avec une iconographie associée.

**Note:** Cette fonctionnalité est disponible via les Web Workers

Syntaxe
-------


```js
info(obj1)
info(obj1, /\* …, \*/ objN)
info(msg)
info(msg, subst1, /\* …, \*/ substN)
```

### Paramètres

`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 qui contient zéro ou plusieurs chaînes de substitution qui seront remplacées par `subst1` … `substN` dans l'ordre.

`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é. Voir la page sur les chaînes de caractères de substitution avec `console` pour plus de détails.

Voir Afficher du texte dans la console pour plus de détails.

### Valeur de retour

Aucune (`undefined`).

Spécifications
--------------

| Specification |
| --- |
| Console Standard # info |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
console : méthode statique dir()
================================

La méthode **`console.dir()`** affiche une liste interactive des propriétés de l'objet JavaScript passé en argument. L'affichage est une hiérarchie avec des flèches/triangles qui permettent de déplier/replier le contenu des propriétés et objets enfants.

Autrement dit, `console.dir()` permet de voir l'ensemble des propriétés d'un objet JavaScript dans la console et de manipuler les niveaux hiérarchiques.

**Note:** Cette fonctionnalité est disponible via les Web Workers

![console-dir.png](/fr/docs/Web/API/console/dir_static/console-dir.png)

Syntaxe
-------


```js
dir(objet)
```

### Paramètres

`objet`

Un objet JavaScript dont on souhaite afficher les propriétés.

### Valeur de retour

Aucune (`undefined`).

Spécifications
--------------

| Specification |
| --- |
| Console Standard # dir |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* La documentation Edge sur `console.dir()`
* La documentation Chrome sur `console.dir()`
console : méthode statique profile()
====================================

**Non standard:** Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.

La méthode **`console.profile()`** démarre l'enregistrement d'un profil de performance.

On peut fournir un argument indiquant le nom du profil, ce qui permet d'enregistrer plusieurs profils nommés en parallèle. Voir la documentation de `console.profileEnd()` pour plus d'informations sur cet argument.

Pour arrêter l'enregistrement du profil, on appellera `console.profileEnd()`.

**Note:** Cette fonctionnalité est disponible via les Web Workers

Syntaxe
-------


```js
profile(nomProfil)
```

### Paramètres

`nomProfil` Facultatif

Le nom à donner au profil.

### Valeur de retour

Aucune (`undefined`).

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `console.profileEnd()`