Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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