Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

RangeError — hodnota mimo povolený rozsah

RangeError je vstavaný chybový typ ECMAScriptu, ktorý označuje hodnotu mimo povolenej množiny alebo rozsahu. Umožňuje signalizovať neplatné argumenty a spracovať takéto výnimky pomocou try...catch.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

new RangeError(message)
RangeError(message)
throw new RangeError(message)

RangeError je vstavaný chybový typ ECMAScriptu, ktorého inštancie dedia z Error. Označuje hodnotu mimo povolenej množiny alebo rozsahu; nemusí ísť iba o prekročenie číselnej hranice. Nie je to rozhranie Web API.

new RangeError(message) vytvorí chybový objekt s voliteľnou správou. Aj volanie RangeError(message) bez new vytvorí nový objekt. Samotné vytvorenie chyby nepreruší vykonávanie: výnimku vyvolaj pomocou throw new RangeError(message).

Niektoré operácie túto chybu vyvolávajú automaticky. Napríklad new Array(-1) odmietne zápornú dĺžku. Pri jedinom argumente typu Number vyžaduje konštruktor Array celočíselnú dĺžku od 0 do 2 ** 32 - 1 vrátane. Čítanie prvku za koncom bežného poľa samo osebe RangeError nevyvolá.

Očakávanú výnimku spracuj pomocou try...catch a nesúvisiace chyby vyvolaj znova. V príklade instanceof RangeError kontroluje typ v rámci toho istého realm; objekty z iného realm, napríklad z rámca, touto kontrolou nemusia prejsť. Neporovnávaj chybové správy generované enginom: ich znenie nie je prenositeľnou zárukou.

Príklady

try {
  new Array(-1);
} catch (error) {
  if (!(error instanceof RangeError)) throw error;
  console.log(error.name);
  console.log(error instanceof Error);
}

Výsledok

RangeError
true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje