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.

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

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.

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ément, console.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.

É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.

• Opera Dragonfly documentation: Console
• MSDN: Using the F12 Tools Console to View Errors and Status
• Firebug wiki: Console API - Firebug supports additional features in its console.log() implementation, such as styled logging.
• NodeJS: Console API