Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje