Translation of failfast.md

Author: forresst

sections/errorhandling/failfast.french.md

@@ -1,14 +1,14 @@
-# Fail fast, validate arguments using a dedicated library
+# Échouez rapidement, valider les arguments à l'aide d'une bibliothèque dédiée
 
-### One Paragraph Explainer
+### Un paragraphe d'explication
 
-We all know how checking arguments and failing fast is important to avoid hidden bugs (see anti-pattern code example below). If not, read about explicit programming and defensive programming. In reality, we tend to avoid it due to the annoyance of coding it (e.g. think of validating hierarchical JSON object with fields like email and dates) – libraries like Joi and Validator turn this tedious task into a breeze.
+Nous savons tous combien il est important de vérifier les arguments et d'échouer rapidement pour éviter les bogues cachés (voir le contre exemple de code ci-dessous). Si ce n'est pas le cas, renseignez-vous sur la programmation explicite et la programmation défensive. En réalité, nous avons tendance à l'éviter en raison de la pénibilité de son codage (par exemple, pensez à valider un objet JSON hiérarchique avec des champs comme l'email et les dates) - des bibliothèques comme Joi et Validator transforment cette tâche fastidieuse en un jeu d'enfant.
 
-### Wikipedia: Defensive Programming
+### Wikipedia : la programmation défensive
 
-Defensive programming is an approach to improve software and source code, in terms of General quality – reducing the number of software bugs and problems. Making the source code comprehensible – the source code should be readable and understandable so it is approved in a code audit. Making the software behave in a predictable manner despite unexpected inputs or user actions.
+La programmation défensive est une approche pour améliorer les logiciels et le code source, en termes de qualité générale - en réduisant le nombre de bogues et de problèmes logiciels. Rendre le code source compréhensible - le code source doit être lisible et compréhensible afin qu'il soit approuvé lors d'un audit de code. Faire en sorte que le logiciel se comporte de manière prévisible malgré des entrées ou des actions utilisateur inattendues.
 
-### Code example: validating complex JSON input using ‘Joi’
+### Exemple de code : validation d'une entrée JSON complexe à l'aide de « Joi »
 
 ```javascript
 var memberSchema = Joi.object().keys({
@@ -18,50 +18,50 @@ var memberSchema = Joi.object().keys({
 });
 
 function addNewMember(newMember) {
- // assertions come first
- Joi.assert(newMember, memberSchema); //throws if validation fails
- // other logic here
+ // les vérifications sont faites en premier
+ Joi.assert(newMember, memberSchema); // lève une exception si la validation échoue
+ // d'autres logiques ici
 }
 ```
 
 
 
-### Anti-pattern: no validation yields nasty bugs
+### Contre exemple de code : aucune validation ne donne de méchants bogues
 
 <details>
 <summary><strong>Javascript</strong></summary>
 
 ```javascript
-// if the discount is positive let's then redirect the user to print his discount coupons
+// si discount est positif, redirige l'utilisateur pour imprimer ses coupons de réduction
 function redirectToPrintDiscount(httpResponse, member, discount) {
     if (discount != 0) {
         httpResponse.redirect(`/discountPrintView/${member.id}`);
     }
 }
 
 redirectToPrintDiscount(httpResponse, someMember);
-// forgot to pass the parameter discount, why the heck was the user redirected to the discount screen?
+// J'ai oublié de passer le paramètre discount, pourquoi diable l'utilisateur a-t-il été redirigé vers l'écran de remise ?
 ```
 </details>
 
 <details>
 <summary><strong>Typescript</strong></summary>
 
 ```typescript
-// if the discount is positive let's then redirect the user to print his discount coupons
+// si discount est positif, redirige l'utilisateur pour imprimer ses coupons de réduction
 function redirectToPrintDiscount(httpResponse: Response, member: Member, discount: number) {
   if (discount != 0) {
     httpResponse.redirect(`/discountPrintView/${member.id}`);
   }
 }
 
 redirectToPrintDiscount(httpResponse, someMember, -12);
-// We passed a negative parameter discount, why the heck was the user redirected to the discount screen?
+// Nous avons passé un paramètre discount négatif, pourquoi diable l'utilisateur a-t-il été redirigé vers l'écran de remise ?
 ```
 </details>
 
-### Blog Quote: "You should throw these errors immediately"
+### Citation de blog : « Vous devriez rejeter ces erreurs immédiatement »
 
- From the blog: Joyent
+ Extrait du blog de Joyent
 
- > A degenerate case is where someone calls an asynchronous function but doesn’t pass a callback. You should throw these errors immediately since the program is broken and the best chance of debugging it involves getting at least a stack trace and ideally a core file at the point of the error. To do this, we recommend validating the types of all arguments at the start of the function.
+ > Un cas de dégénération est celui où quelqu'un appelle une fonction asynchrone mais ne passe pas de fonction de rappel. Vous devriez rejeter ces erreurs immédiatement car le programme est cassé et la meilleure chance de le déboguer implique d'obtenir au moins une trace de pile et idéalement un fichier core au niveau de l'erreur. Pour ce faire, nous vous recommandons de valider les types de tous les arguments au début de la fonction.