Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

throw — zgłaszanie wyjątku

Instrukcja throw zgłasza wyjątek i przerywa zwykły tok wykonania. Wartość wyjątku może przechwycić catch; po throw nie wolno umieszczać końca wiersza przed wyrażeniem.

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

throw jest zastrzeżonym słowem kluczowym rozpoczynającym instrukcję, nie wyrażenie. Instrukcja throw expression; oblicza wyrażenie i zgłasza otrzymaną wartość jako wyjątek. Można zgłosić dowolną wartość JavaScript; w przypadku błędów warto używać obiektu Error z komunikatem.

Wyjątek przerywa zwykły tok wykonania i propaguje się przez synchroniczne wywołania funkcji do otaczającego catch. Bez obsługi pozostaje nieprzechwycony. Jeśli wyjątek nie zostanie przechwycony wewnątrz funkcji async, zwracana przez nią obietnica zostaje odrzucona. Samo objęcie wywołania tej funkcji konstrukcją try/catch nie przechwytuje odrzucenia. Aby je przechwycić w catch, użyj await na tej obietnicy wewnątrz bloku try.

Bloki finally wykonują się podczas wychodzenia z chronionych bloków; return lub kolejny throw w finally może zastąpić wcześniejszy wyjątek.

Wyrażenie jest obowiązkowe: samo throw; jest niepoprawne. Między throw a początkiem wyrażenia nie może wystąpić koniec wiersza — automatyczne wstawianie średników tego nie naprawi. Aby ponownie zgłosić przechwycony wyjątek, użyj throw error; wewnątrz catch (error).

Przykłady

function requirePositive(value) {
  if (typeof value !== "number" || !(value > 0)) {
    throw new Error("Expected a positive number");
  }
  return value;
}

try {
  requirePositive(0);
  console.log("Not reached");
} catch (error) {
  console.log(error.message);
}

Wynik

Expected a positive number

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła