База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Error: основен обект за изключение

Error създава основния обект за грешка с незадължителни съобщение и причина, предназначен за хвърляне и свързване на неуспехи.

Версия: ECMAScript 1 onward; cause option from ECMAScript 2022; example target: Node.js 24.22.2

Синтаксис

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

new Error(message?, options?) създава обект за грешка; извикването Error(...) без new има същия ефект. Ако message не е undefined, се преобразува в string и се записва като собствено неизброимо свойство message. Наследеното свойство name по подразбиране е "Error".

Ако options е обект със свойство cause, стойността му се копира без преобразуване в собствено неизброимо свойство cause. Така първоначалното изключение се запазва при добавяне на контекст. Преобразуването на съобщението или getter-ът cause може да хвърли. Error може да се наследява, а instanceof Error разпознава обикновени инстанции.

stack е полезно, но нестандартно разширение на host и форматът му не е преносим. За собствени категории използвайте подкласове, не анализ на message. Error съществува от ECMAScript 1; опцията cause е стандартна от ECMAScript 2022.

Примери

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

Резултат

Error Could not load config
true
(none)
true

Източници