CKTIS / JavaScript
RangeError — hodnota mimo povolený rozsah
RangeError je vestavěný chybový typ ECMAScriptu, který označuje hodnotu mimo povolenou množinu nebo rozsah. Umožňuje signalizovat neplatné argumenty a zpracovávat tyto výjimky pomocí try...catch.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new RangeError(message)
RangeError(message)
throw new RangeError(message)RangeError je vestavěný chybový typ ECMAScriptu, jehož instance dědí z Error. Označuje hodnotu mimo povolenou množinu nebo rozsah; nemusí jít pouze o překročení číselné hranice. Nejde o rozhraní Web API.
new RangeError(message) vytvoří chybový objekt s volitelnou zprávou. Také volání RangeError(message) bez new vytvoří nový objekt. Samotné vytvoření chyby provádění nepřeruší: výjimku vyvoláš pomocí throw new RangeError(message).
Některé operace tuto chybu vyvolávají automaticky. Například new Array(-1) odmítne zápornou délku. Při jediném argumentu typu Number vyžaduje konstruktor Array celočíselnou délku od 0 do 2 ** 32 - 1 včetně. Čtení prvku za koncem běžného pole samo o sobě RangeError nevyvolá.
Očekávanou výjimku zpracuj pomocí try...catch a nesouvisející chyby vyvolej znovu. V příkladu instanceof RangeError kontroluje typ v rámci stejného realm; objekty z jiného realm, například z rámce, touto kontrolou nemusí projít. Neporovnávej chybové zprávy generované enginem: jejich znění není přenositelnou zárukou.
Příklady
try {
new Array(-1);
} catch (error) {
if (!(error instanceof RangeError)) throw error;
console.log(error.name);
console.log(error instanceof Error);
}Výsledek
RangeError true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.