Конструктор Error створює об'єкт помилки. Примірники об'єкта Error викидаються при виникненні помилок під час виконання. Об'єкт Error також може використовуватися в якості базового для призначених для користувача винятків. Дивіться нижче стандартні вбудовані типи помилок.
message Необов'язковий Людино-читане опис помилки. fileName Необов'язковий Значення властивості fileName створеного об'єкта Error. Заводський параметр ім'я файлу, що містить код, який викликав конструктор Error (). lineNumber Необов'язковий Значення властивості lineNumber створеного об'єкта Error. Заводський параметр номер рядка, що містить виклик конструктора Error ().
Під час виконанню коду помилки призводять до створення і викиданню нових об'єктів Error.
Дана сторінка документує використання об'єкта Error як самого по собі, так і при використанні в якості опції-конструктора. Список властивостей і методів, успадкування екземплярами об'єкта Error. дивіться в розділі Error.prototype.
Error.prototype Дозволяє додавати властивості в екземпляри об'єкта Error.
Глобальний об'єкт Error не містить власних методів, однак, він успадковує деякі методи з ланцюжка прототипів.
Примірники об'єкта Error
Всі екземпляри Error і екземпляри неуніверсальних помилок успадковуються від Error.prototype. Як і з усіма функціями-конструкторами, ви можете використовувати прототип конструктора для додавання властивостей і методів до всіх екземплярів, створюваним цим конструктором.
стандартні властивості
Error.prototype.constructor Визначає функцію, яка створює прототип примірника помилки. Error.prototype.message Повідомлення помилки. Error.prototype.name Назва помилки.
розширення вендорів
Чи не стандартно
Ця можливість не є стандартною і стандартизувати її поки ніхто не збирається. Не використовуйте її на сайтах, що дивляться в зовнішній світ: вона буде працювати не у всіх користувачів. Також можуть бути присутніми великі несумісності між реалізаціями і її поведінка може в майбутньому змінитися.
Error.prototype.fileName Шлях до файлу, в якому виникла ця помилка. Error.prototype.lineNumber Номер рядка в файлі, в якому виникла ця помилка. Error.prototype.columnNumber Номер колонки в рядку, на якій виникла ця помилка. Error.prototype.stack Стек викликів.
Error.prototype.toSource () Повертає рядок, що містить вихідний код зазначеного об'єкта Error; ви можете використовувати це значення для створення нового об'єкта. Перевизначає метод Object.prototype.toSource (). Error.prototype.toString () Повертає рядок, що представляє зазначений об'єкт. Перевизначає метод Object.prototype.toSource ().
Приклад: викидання звичайної помилки
Зазвичай, ви створюєте об'єкт Error з наміром порушити помилку за допомогою ключового слова throw. Ви можете обробити помилку за допомогою конструкції try. catch:
Приклад: обробка помилки конкрентних типу
Приклад: призначені для користувача типи помилок
Ви можете захотіти визначити свої власні типи помилок, успадковані від Error. що б мати возможноть писати throw new MyError () і використовувати instanceof MyError для перевірки виду помилки в обробнику винятків. Нижче продемонстровано загальний підхід до виконання цього завдання.
Попередження: зверніть увагу, що викидання MyError буде повідомляти неправильні номер рядка lineNumber і ім'я файлу fileName як мінімум, в Firefox.