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

CKTIS / JavaScript

TypeError — грешка при недопустима операция

TypeError е вграден тип грешка в JavaScript, който често показва операция, несъвместима с типа на дадена стойност. Можете да го прихванете или изрично да го генерирате при проверка на аргументите на функция.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

new TypeError(message)
TypeError(message)
throw new TypeError(message)

TypeError е вграден конструктор за грешки, които наследяват Error, а не интерфейс на Web API. Обикновено сигнализира за операция, която дадена стойност не поддържа, например извикване на стойност, която не е функция. Спецификацията го използва и когато никой друг вграден тип грешка не описва подходящо причината за неуспеха.

При успешно изпълнение както new TypeError(message), така и извикването на TypeError(message) без new връщат нов обект на грешка, вместо да го хвърлят като изключение. За да хвърлите изрично получения обект, използвайте throw. Аргументът message не е задължителен, но преобразуването му в низ може да предизвика изключение, преди да бъде върнат обект на грешка. Например new TypeError(Symbol()) хвърля изключение TypeError без изричен оператор throw.

Собствените ви функции могат да генерират TypeError, когато аргумент не отговаря на изискване за тип. За стойност с правилния тип, но извън допустимия диапазон, обикновено е по-подходящ RangeError. В примера catch прихваща очакваната грешка и хвърля отново останалите.

Не основавайте логиката си на точния текст на съобщенията, генерирани от JavaScript машината: формулировката им не е стандартизирана. Примерът задава собствено съобщение, затова очакваният изход е стабилен. Проверката instanceof TypeError е подходяща в рамките на същия realm, но може да не сработи при грешки от друг realm, например от отделен iframe.

Примери

function shout(value) {
  if (typeof value !== "string") {
    throw new TypeError("Expected a string");
  }
  return value.toUpperCase();
}

try {
  shout(42);
} catch (error) {
  if (!(error instanceof TypeError)) {
    throw error;
  }
  console.log(error.name + ": " + error.message);
}

Резултат

TypeError: Expected a string

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници