CKTIS / JavaScript
`console.log()` e `console.error()`: níveis de registo e exceções
Usa `console.log()` para diagnósticos correntes e `console.error()` para mensagens de nível de erro. Registar um erro não é o mesmo que lançar uma exceção.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
console.log(...values)
console.log(format, ...substitutions)
console.error(...values)
console.error(format, ...substitutions)console.log/error é uma forma abreviada de referir dois métodos do espaço de nomes global console, não uma sintaxe de chamada. console.log() regista uma mensagem de diagnóstico comum e console.error() regista uma mensagem de nível de erro. Ambos fazem parte da API Console fornecida pelo ambiente de execução, não do ECMAScript 2024.
Os dois métodos aceitam valores como argumentos separados ou uma cadeia de formatação como primeiro argumento. Marcadores como %s usam os argumentos seguintes pela ordem em que aparecem. Os valores restantes são apresentados a seguir ao texto formatado. Se a chamada terminar normalmente, ambos os métodos devolvem undefined.
console.error() pode receber um objeto Error, mas não precisa dele. Comunicar um erro não é o mesmo que lançar ou capturar uma exceção. Se a chamada terminar normalmente, a execução prossegue. Ainda assim, uma chamada de registo pode lançar uma exceção: por exemplo, em Node.js, uma função de inspeção personalizada chamada ao formatar um objeto pode lançar uma exceção. Usa throw para lançar explicitamente uma exceção.
Os filtros podem ocultar mensagens. A apresentação e a eventual indicação da sequência de chamadas dependem do ambiente. Ao expandires um objeto mais tarde, podes ver alterações posteriores à chamada em vez do seu estado no momento do registo. A consola não garante o armazenamento persistente. Não registes palavras-passe, tokens ou dados pessoais.
Exemplos
{
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");
}Resultado
Checking config Missing field: port Execution continued
A primeira mensagem mostra a substituição de `%s`. A falta do campo `port` dá origem a uma mensagem de nível de erro, mas a mensagem final `Execution continued` mostra que a execução prossegue. Neste exemplo, a instância de `Console` do Node.js envia as mensagens de ambos os níveis para a saída padrão (`stdout`).
Lições relacionadas
- JavaScript · Lição 42 · Avançado · Versão: 4
Fontes
- 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