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

CKTIS / JavaScript

Error: základní objekt výjimky

Error vytvoří základní chybový objekt s volitelnou zprávou a příčinou určený k vyhazování a řetězení selhání.

Verze: ECMAScript 1 onward; cause option from ECMAScript 2022; example target: Node.js 24.22.2

Syntaxe

Error(message?, options?); new Error(message?, options?)

new Error(message?, options?) vytvoří chybový objekt; volání Error(...) bez new má stejný účinek. Není-li message undefined, převede se na řetězec a uloží jako vlastní neenumerovatelná vlastnost message. Zděděná vlastnost name má výchozí hodnotu "Error".

Je-li options objekt s vlastností cause, její hodnota se bez převodu zkopíruje do vlastní neenumerovatelné vlastnosti cause. Tím zůstane původní výjimka při doplnění kontextu zachována. Převod zprávy nebo getter cause může vyhodit. Error lze dědit a instanceof Error rozpozná běžné instance.

stack je užitečné, ale nestandardní rozšíření hostitele a jeho formát není přenositelný. Pro vlastní kategorie používejte podtřídy, ne parsování message. Error existuje od ECMAScript 1; volba cause je standardní od ECMAScript 2022.

Příklady

function loadConfig() {
  try {
    JSON.parse("{");
  } catch (cause) {
    throw new Error("Could not load config", {cause});
  }
}

try {
  loadConfig();
} catch (error) {
  console.log(error.name, error.message);
  console.log(error.cause instanceof SyntaxError);
  console.log(Object.keys(error).join(",") || "(none)");
}
console.log(Error("plain") instanceof Error);

Výsledek

Error Could not load config
true
(none)
true

Zdroje