console.log()

La méthode log() de l'objet Console affiche un message dans la console Web. Le message peut être une simple chaine (avec des valeurs optionnelles de substitution), ou peut être un ou plusieurs objets JavaScript.

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

Syntaxe

console.log(obj1 [, obj2, ..., objN]);
console.log(msg [, subst1, ..., substN]);

Paramètres

obj1 ... objN
une liste d'objets Javascript à afficher. Les représentations textuelles de chacun de ces objets seront affichées à la sortie dans l'ordre indiqué. Notez que si vous consignez des objets dans les dernières versions de Chrome et Firefox, ce que vous avez enregistré sur la console est une référence à l'objet, qui n'est pas nécessairement la «valeur» de l'objet au moment où vous appelez la console.log (), mais est la valeur de l'objet au moment où vous cliquez dessus.
msg
Une chaîne de caractères JavaScript contenant zéro ou plusieurs chaînes de substitution.
subst1 ... substN
Objets Javascript qui remplaceront les chaînes de subsitution éventuellement contenues dans msg. Cela offre plus de contrôle sur le format d'affichage.

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

Différence avec console.dir()

Vous pourriez vous demander quelle est la différence entre console.dir() et console.log().

Une autre différence utile dans Chrome existe lors de l'envoi d'éléments DOM vers la console.

À noter :

  • console.log affiche les éléments dans un arbre de type HTML,
  • console.dir affiche les éléments dans un arbre de type JSON.

Plus précisémentconsole.log fait un traitement spécial aux éléments DOM, alors que console.dir n'en fait pas. C'est souvent utile pour voir la représentation complète de l'objet JS DOM.

Il y a plus d'informations dans Chrome Console API reference sur ceci et d'autres fonctions.

Affichage d'objets

Évitez d'utiliser console.log(obj) mais préférez console.log(JSON.parse(JSON.stringify(obj))) afin d'être sûr de voir la valeur de l'objet au moment de l'affichage en console. Autrement, de nombreux navigateurs produisent un affichage interactif de l'objet qui se maintient à jour quand les propriétés de l'objet changent. Cela ne pourrait pas être ce que vous voulez et peut porter à confusion.

Spécification

Spécification État Commentaire
Console API
La définition de 'console.log()' dans cette spécification.
Standard évolutif Définition initiale

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi