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) { // Обработка ошибки } }