RangeError

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨июль 2015 г.⁩.

* Some parts of this feature may have varying levels of support.

ОбъектRangeError представляет ошибку, возникающую, когда значение не входит в множество или диапазон допустимых значений.

Описание

RangeError возникает при попытке передать в качестве аргумента функции значение, которое не входит в диапазон допустимых значений.

Это может происходить в разных случаях:

при передаче значения, которое не является одной из допустимых строк, вString.prototype.normalize(),
при попытке создать массив недопустимой длины с помощью конструктораArray,
при передаче недопустимых значений в такие методы, какNumber.prototype.toExponential(),Number.prototype.toFixed() илиNumber.prototype.toPrecision().

RangeError являетсясериализуемым объектом, поэтому он может быть клонирован с помощьюstructuredClone() или передан междуворкерами с использованиемpostMessage().

RangeError является подклассомError.

Конструктор

RangeError(): Создаёт новый объектRangeError.

Свойства экземпляра

Также наследует свойства экземпляра своего родителяError.

Эти свойства определены вRangeError.prototype и есть у всех экземпляровRangeError.

RangeError.prototype.constructor: Функция-конструктор, создающая экземпляр объекта. Для экземпляровRangeError начальным значением является конструкторRangeError.
RangeError.prototype.name: Представляет название типа ошибки. Начальным значениемRangeError.prototype.name является"RangeError".

function check(n) {  if (!(n >= -500 && n <= 500)) {    throw new RangeError("Аргумент должен быть в диапазоне между -500 и 500.");  }}try {  check(2000);} catch (error) {  if (error instanceof RangeError) {    // Обработка ошибки  }}

Использование`RangeError` для нецифровых значений

function check(value) {  if (!["яблоко", "банан", "морковь"].includes(value)) {    throw new RangeError(      'Аргумент должен иметь значение "яблоко", "банан" или "морковь".',    );  }}try {  check("капуста");} catch (error) {  if (error instanceof RangeError) {    // Обработка ошибки  }}