diff options
author | SphinxKnight <SphinxKnight@users.noreply.github.com> | 2021-10-22 18:52:51 +0200 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-10-22 18:52:51 +0200 |
commit | 571bb09aa84e6409adaf5bf93fa4b790c9961f23 (patch) | |
tree | d51499d8ae7563e29839bd2f6f2178305b82c5e9 /files/fr | |
parent | 23e0fef8ff0c21c54abfae27f31c267ae83a0312 (diff) | |
download | translated-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.md | 87 | ||||
-rw-r--r-- | files/fr/web/javascript/reference/global_objects/rangeerror/rangeerror/index.md | 84 |
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 : -### 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) |