Constructeur 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.

Le constructeur RangeError() permet de créer une erreur lorsqu'une valeur n'appartient pas à l'intervalle ou à l'ensemble des valeurs autorisées.

Syntaxe

js
new RangeError();
new RangeError(message);
new RangeError(message, nomFichier);
new RangeError(message, nomFichier, numeroLigne);

Parameters

message Facultatif

Une description, lisible et compréhensible par un humain, de l'erreur.

nomFichier Facultatif

Le nom du fichier qui contient le code ayant provoqué l'exception.

numeroLigne Facultatif

Le numéro de la ligne dans le fichier de code ayant provoqué l'exception.

Exemples

Utiliser RangeError (pour des valeurs numériques)

js
function verifier(n) {
  if (!(n >= -500 && n <= 500)) {
    throw new RangeError("L'argument doit être compris entre -500 et 500.");
  }
}

try {
  verifier(2000);
} catch (error) {
  if (error instanceof RangeError) {
    // Gérer l'erreur
  }
}

Utiliser RangeError (pour des valeurs non-numériques)

js
function verifier(valeur) {
  if (["pomme", "banane", "carotte"].includes(valeur) === false) {
    throw new RangeError(
      "L'argument doit valeur 'pomme', 'banane', ou 'carotte'.",
    );
  }
}

try {
  verifier("chou");
} catch (error) {
  if (error instanceof RangeError) {
    // Gérer l'erreur
  }
}

Spécifications

Specification
ECMAScript® 2025 Language Specification
# sec-nativeerror-constructors

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi