console : méthode statique group()

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 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

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 :

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.