CKTIS / JavaScript
`console.log()` a `console.error()`: úrovně zpráv a výjimky
Pro běžnou diagnostiku používejte `console.log()`, pro zprávy na chybové úrovni `console.error()`. Zapsat chybu do konzole neznamená vyvolat výjimku.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
console.log(...values)
console.log(format, ...substitutions)
console.error(...values)
console.error(format, ...substitutions)console.log/error je zkratka pro dvě metody globálního jmenného prostoru console, nikoli syntaxe volání. console.log() zapisuje běžnou diagnostickou zprávu a console.error() zapisuje zprávu na chybové úrovni. Obě metody patří do Console API poskytovaného běhovým prostředím, nikoli do ECMAScriptu 2024.
Obě metody přijímají hodnoty jako samostatné argumenty nebo formátovací řetězec jako první argument. Zástupné značky jako %s používají následující argumenty v jejich pořadí. Zbývající hodnoty se zobrazí za formátovaným textem. Pokud volání skončí normálně, obě metody vracejí undefined.
console.error() může přijmout objekt Error, ale nevyžaduje ho. Nahlášení chyby není totéž co vyvolání nebo zachycení výjimky. Pokud volání skončí normálně, provádění kódu pokračuje. Při zápisu zprávy přesto může vzniknout výjimka: například v Node.js může výjimku vyvolat vlastní inspekční funkce zavolaná při formátování objektu. K explicitnímu vyvolání výjimky slouží throw.
Filtry mohou zprávy skrýt. Vzhled zpráv a případné zobrazení výpisu zásobníku volání závisejí na prostředí. Pokud objekt rozbalíte později, může ukazovat změny provedené po volání místo tehdejšího stavu. Konzole nezaručuje trvalé uložení. Nezapisujte hesla, tokeny ani osobní údaje.
Příklady
{
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");
}Výsledek
Checking config Missing field: port Execution continued
První zpráva ukazuje nahrazení `%s`. Chybějící pole `port` způsobí zápis na chybové úrovni, ale závěrečná zpráva `Execution continued` ukazuje, že provádění pokračuje. Instance `Console` v Node.js v tomto příkladu směruje zprávy obou úrovní na standardní výstup (`stdout`).
Související lekce
- JavaScript · Lekce 42 · Pokročilá · Verze: 4
Zdroje
- 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