RangeError

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

L'objet RangeError permet d'indiquer une erreur lorsqu'une valeur fournie n'appartient pas à l'intervalle ou à l'ensemble de valeurs autorisées.

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 :

Constructeur

RangeError()

Crée un nouvel objet RangeError.

Propriétés des instances

RangeError.prototype.message

Un message d'erreur. Bien qu'ECMA-262 spécifie que RangeError devrait fournir sa propre propriété message, pour SpiderMonkey, celle-ci est héritée de Error.prototype.message.

RangeError.prototype.name

Le nom d'erreur. Hérité de Error.

RangeError.prototype.fileName

Le chemin vers le fichier qui a déclenché cette erreur. Héritée de Error.

RangeError.prototype.lineNumber

Le numéro de la ligne dans le fichier qui a déclenché cette erreur. Héritée de Error.

RangeError.prototype.columnNumber

Le numéro de la colonne dans la ligne du fichier qui a déclenché cette erreur. Héritée de Error.

RangeError.prototype.stack

La trace de la pile d'appel. Héritée de Error.

Exemples

Utiliser RangeError

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

try {
  verifier(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

js
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

Specification
ECMAScript® 2025 Language Specification
# sec-native-error-types-used-in-this-standard-rangeerror

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
RangeError
RangeError() constructor
RangeError is serializable

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

Voir aussi