RangeError

Description

Une exception RangeError est leve lorsqu'une valeur est passe comme argument une fonction qui n'accepte pas de valeurs dans cet intervalle.

Par exemple, cela peut tre le cas quand :

• on passe une valeur qui n'est pas une des valeurs autorises pour String.prototype.normalize(), ou
• on souhaite crer un tableau avec une longueur illgale via Array ou
• lorsqu'on passe des valeurs incorrectes aux mthodes Number.toExponential(), Number.toFixed() ou Number.toPrecision().

Constructeur

RangeError()

Cre un nouvel objet RangeError.

Proprits des instances

RangeError.prototype.message

Un message d'erreur. Bien qu'ECMA-262 spcifie que RangeError devrait fournir sa propre proprit message, pour SpiderMonkey, celle-ci est hrite de Error.prototype.message.

RangeError.prototype.name

Le nom d'erreur. Hrit de Error.

RangeError.prototype.fileName

Le chemin vers le fichier qui a dclench cette erreur. Hrite de Error.

RangeError.prototype.lineNumber

Le numro de la ligne dans le fichier qui a dclench cette erreur. Hrite de Error.

RangeError.prototype.columnNumber

Le numro de la colonne dans la ligne du fichier qui a dclench cette erreur. Hrite de Error.

RangeError.prototype.stack

La trace de la pile d'appel. Hrite de Error.

Exemples

Utiliser RangeError

const MIN = 200;
const MAX = 300;
function verifier(num) {
  if (num < MIN || num > MAX) {
    throw new RangeError(
      "Le paramtre doit tre compris entre " + MIN + " et " + MAX,
    );
  }
}

try {
  verifier(500);
} catch (e) {
  if (e instanceof RangeError) {
    // On gre ce qui se passe en cas d'erreur
  }
}

Utiliser RangeError avec des valeurs non-numriques

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 gre ce qui se passe en cas d'erreur
  }
}

Spcifications

Compatibilit des navigateurs

Voir aussi

• Error
• Array
• Number.toExponential()
• Number.toFixed()
• Number.toPrecision()
• String.prototype.normalize()