Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Constructeur RangeError()

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 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® 2026 Language Specification
# sec-nativeerror-constructors

Compatibilité des navigateurs

Voir aussi