WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

`console.log()` und `console.error()`: Meldungsstufen und Ausnahmen

`console.log()` dient für gewöhnliche Diagnosemeldungen, `console.error()` für Meldungen der Fehlerstufe. Eine Fehlermeldung zu protokollieren ist nicht dasselbe, wie eine Ausnahme auszulösen.

Version: 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 steht kurz für zwei Methoden im globalen Namensraum console und ist keine Aufrufsyntax. console.log() gibt eine gewöhnliche Diagnosemeldung aus, console.error() eine Meldung der Fehlerstufe. Beide gehören zur Console API der Laufzeitumgebung, nicht zu ECMAScript 2024.

Beide Methoden nehmen Werte als einzelne Argumente oder eine Formatzeichenfolge als erstes Argument entgegen. Platzhalter wie %s verwenden die nachfolgenden Argumente der Reihe nach. Übrige Werte erscheinen nach dem formatierten Text. Bei normaler Rückkehr geben beide Methoden undefined zurück.

console.error() kann ein Error-Objekt entgegennehmen, benötigt aber keines. Einen Fehler zu melden ist nicht dasselbe, wie eine Ausnahme auszulösen oder abzufangen. Kehrt der Aufruf normal zurück, läuft die Ausführung weiter. Beim Protokollieren kann dennoch eine Ausnahme auftreten: In Node.js kann beispielsweise eine benutzerdefinierte Inspektionsfunktion, die beim Formatieren eines Objekts aufgerufen wird, eine Ausnahme auslösen. Verwende throw, um ausdrücklich eine Ausnahme auszulösen.

Filter können Meldungen ausblenden. Darstellung und Anzeige eines Stacktrace hängen von der Laufzeitumgebung ab. Wenn du ein Objekt später aufklappst, siehst du möglicherweise nachträgliche Änderungen statt des Zustands zum Zeitpunkt des Aufrufs. Die Konsole garantiert keine dauerhafte Speicherung. Protokolliere keine Passwörter, Tokens oder personenbezogenen Daten.

Beispiele

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

Ergebnis

Checking config
Missing field: port
Execution continued

Die erste Meldung zeigt, wie `%s` ersetzt wird. Das fehlende Feld `port` führt zu einer Meldung der Fehlerstufe. Die abschließende Meldung `Execution continued` zeigt, dass die Ausführung weiterläuft. Die Node.js-Instanz von `Console` leitet in diesem Beispiel beide Meldungsstufen an die Standardausgabe (`stdout`) weiter.

Zugehörige Lektionen

  • JavaScript · Lektion 42 · Fortgeschritten · Version: 4

Quellen