Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

throw — vyvolání výjimky

Příkaz throw vyvolá výjimku a přeruší běžné vykonávání. Klauzule catch může převzít vyhozenou hodnotu; mezi throw a jeho výrazem nesmí být konec řádku.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

throw expression;

throw je vyhrazené klíčové slovo, které začíná příkaz, nikoli výraz. Příkaz throw expression; vyhodnotí výraz a vyvolá jeho výslednou hodnotu jako výjimku. Vyvolat lze libovolnou hodnotu JavaScriptu; u chyb je vhodné použít objekt Error se zprávou.

Výjimka přeruší běžné vykonávání a šíří se přes synchronní volání funkcí až k obklopujícímu catch. Bez obslužné části zůstane nezachycená. Pokud se výjimka uvnitř funkce async nezachytí, příslib vrácený touto funkcí se zamítne. Samotné obalení volání konstrukcí try/catch toto zamítnutí nezachytí. Chceš-li ho zachytit v catch, použij na příslib await uvnitř bloku try.

Bloky finally se vykonají při opouštění chráněných bloků; return nebo další throw v finally může nahradit předchozí výjimku.

Výraz je povinný: samotné throw; je neplatné. Mezi throw a začátkem výrazu nesmí být konec řádku — automatické vkládání středníků to nenapraví. Chceš-li znovu vyvolat zachycenou výjimku, použij throw error; uvnitř catch (error).

Příklady

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

Výsledek

Expected a positive number

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje