console : méthode statique log()
La méthode console.log()
permet d'afficher un message dans la console. Le message peut être une chaîne de caractères (avec d'éventuelles valeurs de substitution) ou un ou plusieurs objets JavaScript.
Note: Cette fonctionnalité est disponible via les Web Workers.
Syntaxe
log(obj1)
log(obj1, /* …, */ objN)
log(msg)
log(msg, subst1, /* …, */ substN)
Paramètres
obj1
…objN
-
Une liste d'objets JavaScript à afficher. Les objets sont affichés dans l'ordre des arguments. Attention, pour certains navigateurs, ce qui est affiché dans la console est une référence à l'objet et pas nécessairement la valeur de l'objet au moment où
console.log()
est appelé (mais la valeur de l'objet au moment où la console est ouverte). msg
-
Une chaîne de caractères JavaScript qui contient zéro ou plusieurs chaînes de substitution qui seront remplacées par
subst1
…substN
dans l'ordre. subst1
…substN
-
Des objets JavaScript avec lesquels remplacer les chaînes de substitution dans
msg
. Ce paramètre permet un contrôle supplémentaire sur le format de ce qui est affiché. Voir la page sur les chaînes de caractères de substitution avecconsole
pour plus de détails.
Voir Afficher du texte dans la console pour plus de détails.
Valeur de retour
Aucune (undefined
).
Journaliser des objets
Les informations relatives aux objets sont récupérées lorsque c'est nécessaire. Cela signifie que le message dans la console affiche le contenu de l'objet au moment où on l'observe depuis la console, et pas le contenu de l'objet au moment où la méthode a été appelée. Par exemple, avec :
const obj = {};
console.log(obj);
obj.prop = 123;
On verra {}
affiché comme résultat. Mais si on déplie le détail de l'objet, on verra alors prop: 123
.
Si vous modifiez l'objet et que vous ne voulez pas que les informations journalisées dans la console soient mises à jour, il faudra réaliser un clone profond de l'objet avant de le journaliser. Une méthode courante pour ce faire consiste à utiliser JSON.stringify()
puis JSON.parse()
:
console.log(JSON.parse(JSON.stringify(obj)));
D'autres méthodes, comme structuredClone()
, peuvent fonctionner dans les navigateurs et seront plus efficaces pour cloner différents types d'objet.
Spécifications
Specification |
---|
Console Standard # log |
Compatibilité des navigateurs
BCD tables only load in the browser