CKTIS / JavaScript
RangeError — une valeur en dehors de la plage autorisée
RangeError est un type d’erreur intégré à ECMAScript qui indique une valeur en dehors d’un ensemble ou d’une plage autorisés. Il permet de signaler des arguments invalides et de traiter ces exceptions avec try...catch.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new RangeError(message)
RangeError(message)
throw new RangeError(message)RangeError est un type d’erreur intégré à ECMAScript dont les instances héritent de Error. Il indique une valeur en dehors d’un ensemble ou d’une plage autorisés ; cela ne signifie pas nécessairement le dépassement d’une limite numérique. Ce n’est pas une interface d’API Web.
new RangeError(message) crée un objet d’erreur avec un message facultatif. L’appel RangeError(message) sans new crée également un nouvel objet. La création de l’erreur, à elle seule, n’interrompt pas l’exécution : utilisez throw new RangeError(message) pour lancer une exception.
Certaines opérations lancent automatiquement cette erreur. Par exemple, new Array(-1) refuse une longueur négative. Avec un seul argument de type Number, le constructeur Array exige une longueur entière comprise entre 0 et 2 ** 32 - 1, bornes incluses. Lire un élément au-delà de la fin d’un tableau ordinaire ne lance pas, à lui seul, de RangeError.
Traitez l’exception attendue avec try...catch et relancez les erreurs sans rapport. Dans l’exemple, instanceof RangeError vérifie le type dans le même realm ; les objets provenant d’un autre realm, comme une frame, peuvent échouer à ce test. Ne comparez pas les messages d’erreur générés par le moteur : leur formulation ne constitue pas un contrat portable.
Exemples
try {
new Array(-1);
} catch (error) {
if (!(error instanceof RangeError)) throw error;
console.log(error.name);
console.log(error instanceof Error);
}Résultat
RangeError true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.