Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

`console.log()` i `console.error()`: poziom komunikatu a wyjątki

Używaj `console.log()` do zwykłych komunikatów diagnostycznych, a `console.error()` do komunikatów o błędach. Zapisanie komunikatu nie jest równoznaczne z rzuceniem wyjątku.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

console.log(...values)
console.log(format, ...substitutions)
console.error(...values)
console.error(format, ...substitutions)

console.log/error to skrót oznaczający dwie metody globalnej przestrzeni nazw console, a nie zapis ich wywołania. console.log() zapisuje zwykły komunikat diagnostyczny, a console.error() zapisuje komunikat na poziomie błędu. Obie metody udostępnia środowisko wykonawcze w ramach Console API; nie należą one do ECMAScript 2024.

Obie metody przyjmują wartości jako osobne argumenty albo napis formatujący jako pierwszy argument. Znaczniki takie jak %s wykorzystują kolejne argumenty po kolei; nadmiarowe wartości są wyświetlane po sformatowanym tekście. Jeśli wywołanie zakończy się normalnie, obie metody zwracają undefined.

console.error() może otrzymać obiekt Error, ale go nie wymaga. Zgłoszenie błędu w konsoli nie jest tym samym co rzucenie lub przechwycenie wyjątku. Jeśli wywołanie zakończy się normalnie, wykonanie jest kontynuowane. Samo logowanie może jednak rzucić wyjątek: na przykład w Node.js niestandardowa funkcja inspekcji wywołana podczas formatowania obiektu może rzucić wyjątek. Aby jawnie rzucić wyjątek, użyj throw.

Filtry mogą ukrywać komunikaty. Wygląd i ewentualna obecność śladu stosu zależą od środowiska. Obiekt rozwinięty później może pokazywać stan po modyfikacji, a nie z chwili wywołania. Konsola nie gwarantuje trwałego zapisu. Nie zapisuj w niej haseł, tokenów ani danych osobowych.

Przykłady

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

Wynik

Checking config
Missing field: port
Execution continued

Pierwszy komunikat pokazuje wynik podstawienia `%s`. Brak pola `port` powoduje zapis na poziomie błędu, ale końcowy komunikat `Execution continued` pokazuje, że wykonanie trwa dalej. Instancja `Console` w Node.js kieruje w tym przykładzie oba poziomy komunikatów na standardowe wyjście (`stdout`).

Powiązane lekcje

  • JavaScript · Lekcja 42 · Zaawansowany · Wersja: 4

Źródła