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
- 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