CKTIS / JavaScript
`console.log()` y `console.error()`: niveles de registro y excepciones
Usa `console.log()` para diagnósticos habituales y `console.error()` para mensajes de nivel de error. Registrar un error no equivale a lanzar una excepción.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
console.log(...values)
console.log(format, ...substitutions)
console.error(...values)
console.error(format, ...substitutions)console.log/error es una abreviatura para dos métodos del espacio de nombres global console, no una sintaxis de llamada. console.log() escribe un mensaje de diagnóstico normal y console.error() escribe un mensaje de nivel de error. Ambos pertenecen a la API Console que proporciona el entorno de ejecución, no a ECMAScript 2024.
Ambos métodos aceptan valores como argumentos separados o una cadena de formato como primer argumento. Los marcadores como %s consumen los argumentos siguientes en orden. Los valores sobrantes se muestran después del texto formateado. Si la llamada termina normalmente, ambos métodos devuelven undefined.
console.error() puede recibir un objeto Error, pero no lo requiere. Informar de un error no equivale a lanzar ni a capturar una excepción. Si la llamada termina normalmente, la ejecución continúa. Aun así, una llamada de registro puede lanzar una excepción: por ejemplo, en Node.js, una función de inspección personalizada invocada al formatear un objeto puede lanzar una excepción. Usa throw para lanzar una excepción explícitamente.
Los filtros pueden ocultar mensajes. La presentación y la posible aparición de un rastro de pila dependen del entorno. Al expandir un objeto más tarde, podrían verse cambios posteriores a la llamada en lugar de su estado en ese momento. La consola no garantiza el almacenamiento persistente. No registres contraseñas, tokens ni datos personales.
Ejemplos
{
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
El primer mensaje muestra la sustitución de `%s`. La ausencia del campo `port` genera un mensaje de nivel de error, pero el mensaje final `Execution continued` muestra que la ejecución continúa. En este ejemplo, la instancia de `Console` de Node.js envía los mensajes de ambos niveles a la salida estándar (`stdout`).
Lecciones relacionadas
- JavaScript · Lección 42 · Avanzado · Versión: 4
Fuentes
- 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