База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

`console.log()` и `console.error()`: нива на съобщенията и изключения

Използвай `console.log()` за обичайна диагностика, а `console.error()` за съобщения с ниво „грешка“. Записването на грешка не е равнозначно на хвърляне на изключение.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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

console.log/error е съкратено обозначение за два метода в глобалното пространство от имена console, а не синтаксис за извикване. console.log() записва обикновено диагностично съобщение, а console.error() записва съобщение с ниво „грешка“. И двата метода са част от Console API, предоставян от средата за изпълнение, а не от ECMAScript 2024.

И двата метода приемат стойности като отделни аргументи или форматиращ низ като първи аргумент. Маркерите като %s използват следващите аргументи по ред. Останалите стойности се показват след форматирания текст. Ако извикването завърши нормално, и двата метода връщат undefined.

console.error() може да приеме обект Error, но не го изисква. Съобщаването на грешка не е равнозначно на хвърляне или прихващане на изключение. Ако извикването завърши нормално, изпълнението продължава. При записване на съобщение все пак може да възникне изключение: например в Node.js потребителска функция за инспекция, извикана при форматиране на обект, може да хвърли изключение. За да хвърлиш изключение изрично, използвай throw.

Филтрите могат да скриват съобщения. Изгледът и евентуалното показване на стека на извикванията зависят от средата. Ако разгънеш обект по-късно, може да видиш промени след извикването вместо състоянието му при записването. Конзолата не гарантира трайно съхранение. Не записвай пароли, токени или лични данни.

Примери

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

Резултат

Checking config
Missing field: port
Execution continued

Първото съобщение показва заместването на `%s`. Липсващото поле `port` води до съобщение с ниво „грешка“, но последното съобщение `Execution continued` показва, че изпълнението продължава. В този пример екземплярът на `Console` в Node.js насочва съобщенията и от двете нива към стандартния изход (`stdout`).

Свързани уроци

  • JavaScript · Урок 42 · Напреднало · Версия: 4

Източници