CKTIS / JavaScript
RangeError — vrednost zunaj dovoljenega obsega
RangeError je vgrajena vrsta napake ECMAScript, ki označuje vrednost zunaj dovoljene množice ali obsega. Z njo lahko označimo neveljavne argumente in te izjeme obravnavamo z try...catch.
Različica: 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 vgrajena vrsta napake ECMAScript, katere primerki dedujejo od Error. Označuje vrednost zunaj dovoljene množice ali obsega; ni nujno, da gre samo za prekoračitev številske meje. Ne gre za vmesnik Web API.
new RangeError(message) ustvari objekt napake z izbirnim sporočilom. Tudi klic RangeError(message) brez new ustvari nov objekt. Samo ustvarjanje napake ne prekine izvajanja: izjemo sprožiš z throw new RangeError(message).
Nekatere operacije to napako sprožijo samodejno. Na primer, new Array(-1) zavrne negativno dolžino. Pri enem argumentu vrste Number konstruktor Array zahteva celoštevilsko dolžino od 0 do vključno 2 ** 32 - 1. Branje elementa za koncem običajnega polja samo po sebi ne sproži napake RangeError.
Pričakovano izjemo obravnavaj z try...catch, nepovezane napake pa sproži znova. V primeru instanceof RangeError preveri vrsto znotraj istega realm; objekti iz drugega realm, na primer iz okvirja, tega preizkusa morda ne opravijo. Ne primerjaj sporočil o napakah, ki jih ustvari pogon: ni zagotovljeno, da bo njihovo besedilo enako v vseh implementacijah.
Primeri
try {
new Array(-1);
} catch (error) {
if (!(error instanceof RangeError)) throw error;
console.log(error.name);
console.log(error instanceof Error);
}Rezultat
RangeError true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.