console : méthode statique log()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

js
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 avec console 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 :

js
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() :

js
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

Voir aussi