Объект "Error"

Статья
11/05/2008

Обновлен: Ноябрь 2007

Содержит сведения об ошибках. Существует две формы конструктора Error.

function Error([description : String ])
function Error([number : Number [, description : String ]])

Аргументы

number
Необязательный. Числовое значение, присвоенное ошибке и указывающее значение свойства number. Нуль, если аргумент не указывается.
description
Необязательный. Краткая строка, описывающая ошибку. В ней указывается начальное значение свойств description и message. Пустая строка, если аргумент не указывается.

Заметки

Объекты Error можно создавать явным образом с помощью показанного выше конструктора. К объекту Error можно также добавлять свойства для расширения его возможностей. Объект Error также создается при каждом возникновении ошибки во время выполнения для ее описания.

Объект "Error", как правило создается с помощью оператора throw, и ожидается, что он будет перехвачен оператором try...catch. Оператор throw можно использовать для передачи данных любого типа в качестве ошибки; оператор throw не создает неявно объект Error. Однако благодаря вызову объекта Error блок catch может обрабатывать ошибки JScript времени выполнения и пользовательские ошибки одинаковым образом.

Объект Error содержит четыре встроенных свойства: описание ошибки (свойства description и message), номер ошибки (свойство number) и имя ошибки (свойство name). Свойства description и message ссылаются на одно и то же сообщение; свойство description обеспечивает обратную совместимость, а свойство message соответствует стандарту ECMA.

Номер ошибки представляет собой 32-разрядное значение. Старшие 16 разрядов представляют код устройства, а младшие разряды являются фактическим кодом ошибки. Чтобы прочитать фактический код ошибки, используйте оператор & (побитового И) для объединения свойства "number" с шестнадцатеричным числом 0xFFFF.

Внимание!
Попытка использования объекта Error языка JScript на странице ASP.NET может привести к непредвиденным результатам. Причиной этого является неоднозначность, которая может возникнуть между объектом Error JScript и событием Error страницы ASP.NET. Для обработки ошибок на страницах ASP.NET используйте вместо объекта Error класс System.Exception.

Попытка использования объекта Error языка JScript на странице ASP.NET может привести к непредвиденным результатам. Причиной этого является неоднозначность, которая может возникнуть между объектом Error JScript и событием Error страницы ASP.NET. Для обработки ошибок на страницах ASP.NET используйте вместо объекта Error класс System.Exception.

Примечание.
Объект Error предоставляется только в языке JScript. Поскольку он не является производным от типа .NET Framework, его нельзя использовать в других языках, совместимых со спецификацией CLS. Поэтому при объявлении типов параметров и возвращаемых значений CLS-совместимых методов, обязательно используйте вместо объекта Error тип данных System.Exception. Однако объект Error можно использовать для определения типов идентификаторов, которые не являются параметрами или возвращаемыми значениями. Дополнительные сведения см. в разделе Написание CLS-совместимого кода.

Объект Error предоставляется только в языке JScript. Поскольку он не является производным от типа .NET Framework, его нельзя использовать в других языках, совместимых со спецификацией CLS. Поэтому при объявлении типов параметров и возвращаемых значений CLS-совместимых методов, обязательно используйте вместо объекта Error тип данных System.Exception. Однако объект Error можно использовать для определения типов идентификаторов, которые не являются параметрами или возвращаемыми значениями. Дополнительные сведения см. в разделе Написание CLS-совместимого кода.

Пример

В следующем примере показано использование объекта Error.

try {
   // Throw an error.
   throw new Error(42,"No question");
} catch(e) {
   print(e)
// Extract the error code from the error number.
   print(e.number & 0xFFFF)
   print(e.description)
}

В результате выполнения данного кода выводятся следующие данные: