aboutsummaryrefslogtreecommitdiff
path: root/files/fr
diff options
context:
space:
mode:
authorSphinxKnight <SphinxKnight@users.noreply.github.com>2021-10-22 18:52:51 +0200
committerGitHub <noreply@github.com>2021-10-22 18:52:51 +0200
commit571bb09aa84e6409adaf5bf93fa4b790c9961f23 (patch)
treed51499d8ae7563e29839bd2f6f2178305b82c5e9 /files/fr
parent23e0fef8ff0c21c54abfae27f31c267ae83a0312 (diff)
downloadtranslated-content-571bb09aa84e6409adaf5bf93fa4b790c9961f23.tar.gz
translated-content-571bb09aa84e6409adaf5bf93fa4b790c9961f23.tar.bz2
translated-content-571bb09aa84e6409adaf5bf93fa4b790c9961f23.zip
Fixes #2722 by updating existing page and adding constructor page (#2728)
Diffstat (limited to 'files/fr')
-rw-r--r--files/fr/web/javascript/reference/global_objects/rangeerror/index.md87
-rw-r--r--files/fr/web/javascript/reference/global_objects/rangeerror/rangeerror/index.md84
2 files changed, 119 insertions, 52 deletions
diff --git a/files/fr/web/javascript/reference/global_objects/rangeerror/index.md b/files/fr/web/javascript/reference/global_objects/rangeerror/index.md
index 6716e5b2f9..abe7dd92ad 100644
--- a/files/fr/web/javascript/reference/global_objects/rangeerror/index.md
+++ b/files/fr/web/javascript/reference/global_objects/rangeerror/index.md
@@ -1,69 +1,58 @@
---
title: RangeError
slug: Web/JavaScript/Reference/Global_Objects/RangeError
-tags:
- - Error
- - JavaScript
- - RangeError
- - Reference
translation_of: Web/JavaScript/Reference/Global_Objects/RangeError
original_slug: Web/JavaScript/Reference/Objets_globaux/RangeError
+browser-compat: javascript.builtins.RangeError
---
{{JSRef}}
-L'objet **`RangeError`** permet d'indiquer une erreur lorsqu'une valeur fournie n'appartient pas à l'intervalle autorisé.
-
-## Syntaxe
-
- new RangeError([message[, nomFichier[, numLigne]]])
-
-### Paramètres
-
-- `message`
- - : Paramètre optionnel. Une description lisible (humainement) de l'erreur.
-- `nomFichier` {{non-standard_inline}}
- - : Paramètre optionnel. Le nom du fichier contenant le code à l'origine de cette exception.
-- `numLigne `{{non-standard_inline}}
- - : Paramètre optionnel. Le numéro de la ligne du code à l'origine de cette exception.
+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 on souhaite créer un tableau avec une longueur illégale via {{jsxref("Array")}} ou lorsqu'on passe des valeurs incorrectes aux méthodes {{jsxref("Number.toExponential()")}}, {{jsxref("Number.toFixed()")}} ou {{jsxref("Number.toPrecision()")}}. Cette exception n'est pas limitée aux problèmes d'intervalles numériques et peuvent également se produire lorsqu'on passe une valeur non autorisée à {{jsxref("String.prototype.normalize()")}}.
-
-## Propriétés
-
-- {{jsxref("RangeError.prototype")}}
- - : Cette propriété permet d'ajouter des propriétés à toutes les instances de `RangeError`.
-
-## Méthodes
-
-L'objet global `RangeError` ne contient pas de méthodes propres mais héritent de certaines méthodes via la chaîne de prototypes.
+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.
-## Instances de `RangeError`
+Par exemple, cela peut être le cas quand&nbsp;:
-### Propriétés
+- on passe une valeur qui n'est pas une des valeurs autorisées pour [`String.prototype.normalize()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/String/normalize), ou
+- on souhaite créer un tableau avec une longueur illégale via [`Array`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Array) ou
+- lorsqu'on passe des valeurs incorrectes aux méthodes [`Number.toExponential()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Number/toExponential), [`Number.toFixed()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Number/toFixed) ou [`Number.toPrecision()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Number/toPrecision).
-{{ page('/fr/docs/Web/JavaScript/Reference/Objets_globaux/Object/RangeError/prototype','Properties') }}
+## Constructeur
-### Méthodes
+- [`RangeError()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/RangeError/RangeError)
+ - : Crée un nouvel objet `RangeError`.
-{{ page('/fr/docs/Web/JavaScript/Reference/Objets_globaux/Object/RangeError/prototype','Methods') }}
+## Propriétés des instances
+- [`RangeError.prototype.message`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Error/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`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Error/message).
+- [`RangeError.prototype.name`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Error/name)
+ - : Le nom d'erreur. Hérité de [`Error`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Error).
+- [`RangeError.prototype.fileName`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Error/fileName)
+ - : Le chemin vers le fichier qui a déclenché cette erreur. Héritée de [`Error`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Error).
+- [`RangeError.prototype.lineNumber`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Error/lineNumber)
+ - : Le numéro de la ligne dans le fichier qui a déclenché cette erreur. Héritée de [`Error`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Error).
+- [`RangeError.prototype.columnNumber`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Error/columnNumber)
+ - : Le numéro de la colonne dans la ligne du fichier qui a déclenché cette erreur. Héritée de [`Error`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Error).
+- [`RangeError.prototype.stack`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Error/Stack)
+ - : La trace de la pile d'appel. Héritée de [`Error`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Error).
## Exemples
### Utiliser `RangeError`
```js
-var MIN = 200;
-var MAX = 300;
-var vérifier = function( num ) {
+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 {
- vérifier(500);
+ verifier(500);
}
catch (e) {
if (e instanceof RangeError ){
@@ -93,23 +82,17 @@ catch(erreur) {
## Spécifications
-| Spécification | État | Commentaires |
-| -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | -------------------- |
-| {{SpecName('ES3')}} | {{Spec2('ES3')}} | Définition initiale. |
-| {{SpecName('ES5.1', '#sec-15.11.6.2', 'RangeError')}} | {{Spec2('ES5.1')}} |   |
-| {{SpecName('ES6', '#sec-native-error-types-used-in-this-standard-rangeerror', 'RangeError')}} | {{Spec2('ES6')}} |   |
-| {{SpecName('ESDraft', '#sec-native-error-types-used-in-this-standard-rangeerror', 'RangeError')}} | {{Spec2('ESDraft')}} |   |
+{{Specifications}}
## Compatibilité des navigateurs
-{{Compat("javascript.builtins.RangeError")}}
+{{Compat}}
## Voir aussi
-- {{jsxref("Error")}}
-- {{jsxref("Array")}}
-- {{jsxref("RangeError.prototype")}}
-- {{jsxref("Number.toExponential()")}}
-- {{jsxref("Number.toFixed()")}}
-- {{jsxref("Number.toPrecision()")}}
-- {{jsxref("String.prototype.normalize()")}}
+- [`Error`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Error)
+- [`Array`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Array)
+- [`Number.toExponential()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Number/toExponential)
+- [`Number.toFixed()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Number/toFixed)
+- [`Number.toPrecision()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Number/toPrecision)
+- [`String.prototype.normalize()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/String/normalize)
diff --git a/files/fr/web/javascript/reference/global_objects/rangeerror/rangeerror/index.md b/files/fr/web/javascript/reference/global_objects/rangeerror/rangeerror/index.md
new file mode 100644
index 0000000000..8c934c2e4e
--- /dev/null
+++ b/files/fr/web/javascript/reference/global_objects/rangeerror/rangeerror/index.md
@@ -0,0 +1,84 @@
+---
+title: Constructeur RangeError()
+slug: Web/JavaScript/Reference/Global_Objects/RangeError/RangeError
+translation_of: Web/JavaScript/Reference/Global_Objects/RangeError/RangeError
+browser-compat: javascript.builtins.RangeError.RangeError
+---
+{{JSRef}}
+
+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` {{optional_inline}}
+ - : Une description, lisible et compréhensible par un humain, de l'erreur.
+- `nomFichier` {{optional_inline}}
+ - : Le nom du fichier qui contient le code ayant provoqué l'exception.
+- `numeroLigne` {{optional_inline}}
+ - : 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
+
+{{Specifications}}
+
+## Compatibilité des navigateurs
+
+{{Compat}}
+
+## Voir aussi
+
+- [`Error`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Error)
+- [`Array`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Array)
+- [`Number.toExponential()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Number/toExponential)
+- [`Number.toFixed()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Number/toFixed)
+- [`Number.toPrecision()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Number/toPrecision)
+- [`String.prototype.normalize()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/String/normalize)