CKTIS / JavaScript
RangeError — vrijednost izvan dopuštenog raspona
RangeError je ugrađena vrsta pogreške ECMAScripta koja označava vrijednost izvan dopuštenog skupa ili raspona. Omogućuje signaliziranje nevaljanih argumenata i obradu takvih iznimki pomoću try...catch.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
new RangeError(message)
RangeError(message)
throw new RangeError(message)RangeError je ugrađena vrsta pogreške ECMAScripta čije instance nasljeđuju od Error. Označava vrijednost izvan dopuštenog skupa ili raspona; to ne mora značiti samo prekoračenje brojčane granice. Nije riječ o sučelju Web API-ja.
new RangeError(message) stvara objekt pogreške s neobaveznom porukom. I poziv RangeError(message) bez new stvara novi objekt. Samo stvaranje pogreške ne prekida izvođenje: za bacanje iznimke upotrijebi throw new RangeError(message).
Neke operacije automatski bacaju ovu pogrešku. Primjerice, new Array(-1) odbija negativnu duljinu. Uz jedan argument vrste Number, konstruktor Array zahtijeva cjelobrojnu duljinu od 0 do uključivo 2 ** 32 - 1. Čitanje elementa iza kraja običnog polja samo po sebi ne baca RangeError.
Očekivanu iznimku obradi pomoću try...catch, a nepovezane pogreške baci ponovno. U primjeru instanceof RangeError provjerava vrstu unutar istog realm; objekti iz drugog realm, primjerice iz okvira, možda neće proći tu provjeru. Nemoj uspoređivati poruke o pogreškama koje generira engine: njihov tekst nije prenosiv ugovor.
Primjeri
try {
new Array(-1);
} catch (error) {
if (!(error instanceof RangeError)) throw error;
console.log(error.name);
console.log(error instanceof Error);
}Rezultat
RangeError true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.