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
- 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