Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

`console.log()` e `console.error()`: livelli di log ed eccezioni

Usa `console.log()` per i normali messaggi di diagnostica e `console.error()` per i messaggi di livello errore. Registrare un errore non equivale a lanciare un’eccezione.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

console.log(...values)
console.log(format, ...substitutions)
console.error(...values)
console.error(format, ...substitutions)

console.log/error indica due metodi dello spazio dei nomi globale console: non è una sintassi di chiamata. console.log() scrive un normale messaggio di diagnostica, mentre console.error() scrive un messaggio di livello errore. Entrambi fanno parte della Console API fornita dall’ambiente di esecuzione, non di ECMAScript 2024.

Entrambi i metodi accettano valori come argomenti separati oppure una stringa di formato come primo argomento. I segnaposto come %s usano gli argomenti successivi nell’ordine in cui compaiono. I valori in più vengono mostrati dopo il testo formattato. Se la chiamata termina normalmente, entrambi i metodi restituiscono undefined.

console.error() può ricevere un oggetto Error, ma non lo richiede. Segnalare un errore non equivale a lanciare o intercettare un’eccezione. Se la chiamata termina normalmente, l’esecuzione prosegue. Una chiamata di log può comunque lanciare un’eccezione: in Node.js, per esempio, una funzione di ispezione personalizzata invocata durante la formattazione di un oggetto può lanciare un’eccezione. Per lanciare esplicitamente un’eccezione, usa throw.

I filtri possono nascondere i messaggi. L’aspetto e l’eventuale presenza di una traccia dello stack dipendono dall’ambiente. Espandendo un oggetto in seguito, potresti vedere modifiche successive alla chiamata anziché lo stato al momento della registrazione. La console non garantisce la conservazione dei messaggi. Non registrare password, token o dati personali.

Esempi

{
  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");
}

Risultato

Checking config
Missing field: port
Execution continued

Il primo messaggio mostra la sostituzione di `%s`. L’assenza del campo `port` produce un messaggio di livello errore, ma il messaggio finale `Execution continued` mostra che l’esecuzione prosegue. In questo esempio, l’istanza di `Console` di Node.js invia i messaggi di entrambi i livelli allo standard output (`stdout`).

Lezioni correlate

  • JavaScript · Lezione 42 · Avanzato · Versione: 4

Fonti