console : méthode statique group()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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.

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

Voir aussi