Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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