Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

RangeError

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'un nombre est passé 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().

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

Exemple

Utiliser RangeError

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
  }
}

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 2017 Draft (ECMA-262)
La définition de 'RangeError' dans cette spécification.
Projet  

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple (Oui) (Oui) (Oui) (Oui) (Oui)
Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple (Oui) (Oui) (Oui) (Oui) (Oui) (Oui)

Voir aussi

Étiquettes et contributeurs liés au document

Étiquettes : 
 Contributeurs à cette page : SphinxKnight
 Dernière mise à jour par : SphinxKnight,