Об'єкт TypeError
позначає помилку, що виникає при використанні значення невідповідного типу.
Синтаксис
new TypeError([message[, fileName[, lineNumber]]])
Параметри
message
- Необов'язковий. Зрозумілий людині опис помилки.
fileName
- Необов'язковий. Ім'я файлу, код з якого спричинив виняток.
lineNumber
- Необов'язковий. Номер рядка в коді, що спричинив виняток.
Опис
TypeError
викидається, коли:
- операнд або аргумент, що передається у функцію, несумісний з типом, який очікується цим оператором чи функцією, або
- при спробі змінити значення, яке не можна змінювати, або
- при спробі використати значення невідповідним чином.
Властивості
TypeError.prototype
- Дозволяє додавати властивості до об'єктів
TypeError
.
Методи
Сам TypeError
не має власних методів, але успадковує деякі методи через ланцюжок прототипів.
Екземпляри TypeError
Властивості
TypeError.prototype.constructor
- Визначає функцію, яка створила прототип об'єкта.
TypeError.prototype.message
- Повідомлення помилки. Хоча ECMA-262 зазначає, що
TypeError
повинен мати власну властивістьmessage
, у SpiderMonkey, він успадковуєError.prototype.message
. TypeError.prototype.name
- Ім'я помилки. Успадковано від
Error
. TypeError.prototype.fileName
- Шлях до файлу, що спричинив помилку. Успаковано від
Error
. TypeError.prototype.lineNumber
- Номер рядка файлу, в якому виникла помилка. Успаковано від
Error
. TypeError.prototype.columnNumber
- Номер стовпця у рядку, де виникла помилка. Успаковано від
Error
. TypeError.prototype.stack
- Трасування стеку. Успаковано від
Error
.
Методи
Приклади
Перехоплення TypeError
try {
null.f();
} catch (e) {
console.log(e instanceof TypeError) // true
console.log(e.message) // "null has no properties"
console.log(e.name) // "TypeError"
console.log(e.fileName) // "Scratchpad/1"
console.log(e.lineNumber) // 2
console.log(e.columnNumber) // 2
console.log(e.stack) // "@Scratchpad/2:2:3\n"
}
Створення TypeError
try {
throw new TypeError('Привіт', "someFile.js", 10);
} catch (e) {
console.log(e instanceof TypeError) // true
console.log(e.message) // "Привіт"
console.log(e.name) // "TypeError"
console.log(e.fileName) // "someFile.js"
console.log(e.lineNumber) // 10
console.log(e.columnNumber) // 0
console.log(e.stack) // "@Scratchpad/2:2:9\n"
}
Специфікації
Сумісність з веб-переглядачами
BCD tables only load in the browser