RangeError

Об'єкт RangeError позначає помилку, що виникає, коли значення не входить у множину або діапазон дозволених значень.

Синтаксис

new RangeError([message[, fileName[, lineNumber]]])

Параметри

message Optional

Необов'язковий. Зрозумілий людині опис помилки.

fileName Optional 

Необов'язковий. Ім'я файлу, який містить код, що спричинив виняток.

lineNumber Optional 

Необов'язковий. Номер рядка в коді, що спричинив виняток.

Опис

Виняток RangeError викидається при спробі передати у якості аргумента функції значення, яке не входить у діапазон дозволених цією функцією значень.

Його можна зустріти, якщо:

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

Властивості

RangeError.prototype

Вможливлює додавання властивостей до об'єктів RangeError.

Методи

Сам RangeError не має власних методів, але успадковує деякі методи через ланцюжок прототипів.

Екземпляри RangeError

Властивості

Методи

Приклади

Використання 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) === false)
    {
        throw new RangeError("Аргумент має дорівнювати \"яблуко\", \"банан\", або \"морква\".")
    }
}

try
{
    check("капуста")
}
catch(error)
{
    if(error instanceof RangeError)
    {
        // Обробити помилку
    }
}

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

Сумісність з веб-переглядачами

Див. також

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