CKTIS / JavaScript
Obsługa błędów i wyjątków
Obsługa błędów pozwala reagować na wyjątki bez mieszania ich ze zwykłym wynikiem funkcji. Poznaj throw, try, catch i finally oraz różnicę między wyjątkiem synchronicznym a odrzuceniem Promise.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
throw new Error(message);
try {
operation();
} catch (error) {
handle(error);
} finally {
cleanup();
}Wyjątek przerywa bieżącą ścieżkę wykonania. throw może zgłosić dowolną wartość, ale używaj obiektów Error lub ich podtypów: mają właściwości name i message. TypeError opisuje nieodpowiedni typ lub niedozwoloną operację, a RangeError — wartość poza dozwolonym zakresem. Samo new Error(message) tworzy obiekt, lecz go nie zgłasza.
try obejmuje operacje, które mogą zgłosić wyjątek; catch (error) odbiera zgłoszoną wartość, także z funkcji wywołanej synchronicznie. Wykonanie nie wraca do przerwanej instrukcji. Obsługuj tylko błędy, na które potrafisz zareagować; pozostałe zgłaszaj ponownie przez throw error. Błąd składni uniemożliwiający parsowanie tego samego skryptu nie zostanie przechwycony przez jego catch.
finally wykonuje się, gdy sterowanie opuszcza try lub catch, również przy return albo wyjątku. Służy do sprzątania. Unikaj w nim return i throw, ponieważ mogą zastąpić wcześniejszy wynik lub wyjątek. Zapis try wymaga catch, finally lub obu.
Synchroniczny try nie przechwytuje późniejszego odrzucenia Promise tylko dlatego, że utworzono go wewnątrz bloku. Użyj await w try wewnątrz funkcji async albo dołącz .catch(handler). Przykład używa podstawowych mechanizmów wyjątków dostępnych od ECMAScript 3; Promise pochodzi z ECMAScript 2015, a async/await z ECMAScript 2017. Nie wymaga Web APIs poza środowiskowym console.log; sama wersja Node.js nie potwierdza obsługi przeglądarek.
Przykłady
function requirePositive(value) {
if (!(value > 0)) {
throw new RangeError("value must be positive");
}
return value;
}
try {
console.log(requirePositive(-1));
} catch (error) {
if (!(error instanceof RangeError)) {
throw error;
}
console.log(error.name + ": " + error.message);
} finally {
console.log("finished");
}Wynik
RangeError: value must be positive finished
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.