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

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

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

Източници