CKTIS / JavaScript
`console.log()` et `console.error()` : niveaux de journalisation et exceptions
Utilisez `console.log()` pour les diagnostics courants et `console.error()` pour les messages de niveau erreur. Journaliser une erreur ne revient pas à lever une exception.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
console.log(...values)
console.log(format, ...substitutions)
console.error(...values)
console.error(format, ...substitutions)console.log/error désigne deux méthodes de l’espace de noms global console ; ce n’est pas une syntaxe d’appel. console.log() écrit un message de diagnostic ordinaire, tandis que console.error() écrit un message de niveau erreur. Ces deux méthodes relèvent de l’API Console fournie par l’environnement d’exécution, et non d’ECMAScript 2024.
Les deux méthodes acceptent des valeurs comme arguments distincts ou une chaîne de format en premier argument. Les marqueurs comme %s utilisent les arguments suivants dans l’ordre. Les valeurs restantes s’affichent après le texte formaté. Lorsque l’appel se termine normalement, les deux méthodes renvoient undefined.
console.error() peut recevoir un objet Error, mais ce n’est pas obligatoire. Signaler une erreur ne revient pas à lever ou à intercepter une exception. Si l’appel se termine normalement, l’exécution se poursuit. Un appel de journalisation peut néanmoins lever une exception : dans Node.js, par exemple, une fonction d’inspection personnalisée appelée lors du formatage d’un objet peut lever une exception. Utilisez throw pour lever explicitement une exception.
Les filtres peuvent masquer des messages. La présentation et l’affichage éventuel d’une trace de pile dépendent de l’environnement. Un objet déplié plus tard peut refléter des modifications ultérieures plutôt que son état au moment de l’appel. La console ne garantit pas la conservation des messages. N’y inscrivez ni mots de passe, ni jetons, ni données personnelles.
Exemples
{
const { Console } = require("node:console");
const console = new Console({ stdout: process.stdout, stderr: process.stdout });
const config = {};
console.log("Checking %s", "config");
if (!("port" in config)) {
console.error("Missing field: %s", "port");
}
console.log("Execution continued");
}Résultat
Checking config Missing field: port Execution continued
Le premier message montre la substitution de `%s`. L’absence du champ `port` produit un message de niveau erreur, mais le dernier message, `Execution continued`, montre que l’exécution se poursuit. Dans cet exemple, l’instance de `Console` de Node.js envoie les messages des deux niveaux vers la sortie standard (`stdout`).
Leçons associées
- JavaScript · Leçon 42 · Avancé · Version : 4
Sources
- console: log() static method
- console: error() static method
- console — Outputting text to the console
- ECMAScript® 2024 Language Specification — Hosts and Implementations
- ECMAScript® 2024 Language Specification — The throw Statement
- WHATWG Console Standard
- Node.js v24 documentation — Console
- Node.js v24 documentation — util.inspect.custom