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