CKTIS / JavaScript
RangeError — стойност извън допустимия диапазон
RangeError е вграден тип грешка в ECMAScript, който указва стойност извън допустимо множество или диапазон. С него могат да се сигнализират невалидни аргументи и такива изключения да се обработват с try...catch.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
new RangeError(message)
RangeError(message)
throw new RangeError(message)RangeError е вграден тип грешка в ECMAScript, чиито екземпляри наследяват Error. Той указва стойност извън допустимо множество или диапазон; това не означава непременно превишаване на числова граница. Не е интерфейс на Web API.
new RangeError(message) създава обект за грешка с незадължително съобщение. Извикването RangeError(message) без new също създава нов обект. Самото създаване на грешката не прекъсва изпълнението: използвай throw new RangeError(message), за да хвърлиш изключение.
Някои операции хвърлят тази грешка автоматично. Например new Array(-1) отхвърля отрицателна дължина. При един аргумент от тип Number конструкторът Array изисква целочислена дължина от 0 до 2 ** 32 - 1 включително. Четенето на елемент след края на обикновен масив само по себе си не хвърля RangeError.
Обработвай очакваното изключение с try...catch, а несвързаните грешки хвърляй отново. В примера instanceof RangeError проверява типа в рамките на същия realm; обекти от друг realm, например рамка, може да не преминат тази проверка. Не сравнявай съобщенията за грешки, генерирани от JavaScript машината: няма гаранция, че различните реализации ще използват една и съща формулировка.
Примери
try {
new Array(-1);
} catch (error) {
if (!(error instanceof RangeError)) throw error;
console.log(error.name);
console.log(error instanceof Error);
}Резултат
RangeError true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.