Поделиться через


Объект "Error"

Обновлен: Ноябрь 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.

t9zk6eay.alert_caution(ru-ru,VS.90).gifВнимание!

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

t9zk6eay.alert_note(ru-ru,VS.90).gifПримечание.

Объект 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)
}

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

Error: No question
42
No question

Свойства и методы

Свойства и методы объекта "Error"

Требования

Версия 5

См. также

Ссылки

Оператор new

Оператор throw

Оператор try...catch...finally

Оператор var

Page