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
Източници
- 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