L'objet RangeError
permet d'indiquer une erreur lorsqu'une valeur fournie n'appartient pas à l'intervalle autorisé.
Syntaxe
new RangeError([message[, nomFichier[, numLigne]]])
Paramètres
message
- Paramètre optionnel. Une description lisible (humainement) de l'erreur.
nomFichier
- Paramètre optionnel. Le nom du fichier contenant le code à l'origine de cette exception.
numLigne
- Paramètre optionnel. Le numéro de la ligne du code à l'origine de cette exception.
Description
Une exception RangeError
est levée lorsqu'une valeur est passée comme argument à une fonction qui n'accepte pas de valeurs dans cet intervalle. Par exemple, cela peut être le cas quand on souhaite créer un tableau avec une longueur illégale via Array
ou lorsqu'on passe des valeurs incorrectes aux méthodes Number.toExponential()
, Number.toFixed()
ou Number.toPrecision()
. Cette exception n'est pas limitée aux problèmes d'intervalles numériques et peuvent également se produire lorsqu'on passe une valeur non autorisée à String.prototype.normalize()
.
Propriétés
RangeError.prototype
- Cette propriété permet d'ajouter des propriétés à toutes les instances de
RangeError
.
Méthodes
L'objet global RangeError
ne contient pas de méthodes propres mais héritent de certaines méthodes via la chaîne de prototypes.
Instances de RangeError
Propriétés
Méthodes
Exemples
Utiliser RangeError
var MIN = 200; var MAX = 300; var vérifier = function( num ) { if( num < MIN || num > MAX ) { throw new RangeError( "Le paramètre doit être compris entre " + MIN + " et " + MAX ); } }; try { vérifier(500); } catch (e) { if (e instanceof RangeError ){ // On gère ce qui se passe en cas d'erreur } }
Utiliser RangeError
avec des valeurs non-numériques
function verifier(valeur){ if(["pomme", "banane", "carotte"].includes(valeur) === false){ throw new RangeError("L'argument n'est pas un fruit parmi pomme / banane ou carotte."); } } try { verifier("chou"); } catch(erreur) { if(erreur instanceof RangeError){ //On gère ce qui se passe en cas d'erreur } }
Spécifications
Spécification | État | Commentaires |
---|---|---|
ECMAScript 3rd Edition (ECMA-262) | Standard | Définition initiale. |
ECMAScript 5.1 (ECMA-262) La définition de 'RangeError' dans cette spécification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) La définition de 'RangeError' dans cette spécification. |
Standard | |
ECMAScript Latest Draft (ECMA-262) La définition de 'RangeError' dans cette spécification. |
Projet |
Compatibilité des navigateurs
Ordinateur | Mobile | Serveur | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
RangeError | Chrome Support complet 1 | Edge Support complet 12 | Firefox Support complet 1 | IE Support complet 5.5 | Opera Support complet Oui | Safari Support complet Oui | WebView Android Support complet 1 | Chrome Android Support complet 18 | Firefox Android Support complet 4 | Opera Android Support complet Oui | Safari iOS Support complet Oui | Samsung Internet Android Support complet 1.0 | nodejs Support complet Oui |
Légende
- Support complet
- Support complet