RangeError

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

Описание

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

Это может произойти, когда:

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

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

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

Конструктор

RangeError()

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

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

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

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

RangeError.prototype.constructor

Функция-конструктор, создавшая объект-экземпляр. Для экземпляров RangeError начальное значение — это конструктор RangeError.

RangeError.prototype.name

Представляет имя типа ошибки. Для RangeError.prototype.name начальное значение — "RangeError".

Методы экземпляра

Наследует методы экземпляра от родительского Error.

Примеры

Использование RangeError (для числовых значений)

function check(n) {
  if (!(n >= -500 && n <= 500)) {
    throw new RangeError("The argument must be between -500 and 500.");
  }
}

try {
  check(2000);
} catch (error) {
  if (error instanceof RangeError) {
    // Handle the error
  }
}

Использование RangeError (для нечисловых значений)

function check(value) {
  if (!["apple", "banana", "carrot"].includes(value)) {
    throw new RangeError(
      'The argument must be an "apple", "banana", or "carrot".',
    );
  }
}

try {
  check("cabbage");
} catch (error) {
  if (error instanceof RangeError) {
    // Handle the error
  }
}

Спецификации

Совместимость с браузерами

Смотрите также

• Error
• Array
• Number.prototype.toExponential()
• Number.prototype.toFixed()
• Number.prototype.toPrecision()
• String.prototype.normalize()