CKTIS / JavaScript
RangeError — un valore fuori dall’intervallo consentito
RangeError è un tipo di errore integrato in ECMAScript che indica un valore al di fuori di un insieme o intervallo consentito. Consente di segnalare argomenti non validi e gestire queste eccezioni con try...catch.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
new RangeError(message)
RangeError(message)
throw new RangeError(message)RangeError è un tipo di errore integrato in ECMAScript le cui istanze ereditano da Error. Indica un valore al di fuori di un insieme o intervallo consentito; non è necessario che si tratti del superamento di un limite numerico. Non è un’interfaccia Web API.
new RangeError(message) crea un oggetto errore con un messaggio facoltativo. Anche la chiamata RangeError(message) senza new crea un nuovo oggetto. La sola creazione dell’errore non interrompe l’esecuzione: usa throw new RangeError(message) per lanciare un’eccezione.
Alcune operazioni lanciano automaticamente questo errore. Per esempio, new Array(-1) rifiuta una lunghezza negativa. Con un solo argomento di tipo Number, il costruttore Array richiede una lunghezza intera compresa tra 0 e 2 ** 32 - 1, estremi inclusi. La lettura di un elemento oltre la fine di un array ordinario non lancia di per sé un RangeError.
Gestisci l’eccezione prevista con try...catch e rilancia gli errori non correlati. Nell’esempio, instanceof RangeError verifica il tipo all’interno dello stesso realm; gli oggetti provenienti da un altro realm, come un frame, potrebbero non superare questo controllo. Non confrontare i messaggi di errore generati dal motore: la loro formulazione non è un contratto portabile.
Esempi
try {
new Array(-1);
} catch (error) {
if (!(error instanceof RangeError)) throw error;
console.log(error.name);
console.log(error instanceof Error);
}Risultato
RangeError true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.