Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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