CKTIS / JavaScript
`console.log()` a `console.error()`: úrovne správ a výnimky
Na bežnú diagnostiku používajte `console.log()`, na správy na chybovej úrovni `console.error()`. Zápis chyby do konzoly nie je to isté ako vyvolanie výnimky.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
console.log(...values)
console.log(format, ...substitutions)
console.error(...values)
console.error(format, ...substitutions)console.log/error je skratka pre dve metódy globálneho menného priestoru console, nie syntax volania. console.log() zapíše bežnú diagnostickú správu, kým console.error() zapíše správu na chybovej úrovni. Obe metódy patria do Console API, ktoré poskytuje prostredie vykonávania, nie do ECMAScriptu 2024.
Obe metódy prijímajú hodnoty ako samostatné argumenty alebo formátovací reťazec ako prvý argument. Zástupné značky ako %s používajú nasledujúce argumenty v poradí. Zvyšné hodnoty sa zobrazia za formátovaným textom. Ak sa volanie skončí normálne, obe metódy vrátia undefined.
console.error() môže prijať objekt Error, ale nevyžaduje ho. Oznámenie chyby nie je to isté ako vyvolanie alebo zachytenie výnimky. Ak sa volanie skončí normálne, vykonávanie pokračuje. Pri zápise správy však môže vzniknúť výnimka: napríklad v Node.js ju môže vyvolať vlastná inšpekčná funkcia zavolaná pri formátovaní objektu. Na explicitné vyvolanie výnimky použite throw.
Filtre môžu správy skryť. Vzhľad a prípadné zobrazenie výpisu zásobníka volaní závisia od prostredia. Ak objekt rozbalíte neskôr, môžete vidieť zmeny vykonané po volaní namiesto stavu v čase zápisu. Konzola nezaručuje trvalé uloženie. Nezapisujte heslá, tokeny ani osobné údaje.
Prí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ýsledok
Checking config Missing field: port Execution continued
Prvá správa ukazuje nahradenie `%s`. Chýbajúce pole `port` spôsobí zápis na chybovej úrovni, ale záverečná správa `Execution continued` ukazuje, že vykonávanie pokračuje. Inštancia `Console` v Node.js v tomto príklade smeruje správy oboch úrovní na štandardný výstup (`stdout`).
Súvisiace lekcie
- JavaScript · Lekcia 42 · Pokročilá · Verzia: 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