Validation des données en JavaScript (Node.js) : Joi, Yup, Zod

Validation des données en Node.js : Joi, Yup et Zod — choisir le bon outil

Dans le développement web moderne avec Node.js, la validation des données n'est pas seulement une bonne pratique, mais une nécessité. Sans elle, votre serveur risque de recevoir des données incorrectes, malveillantes ou simplement inattendues de la part du client. Cela peut entraîner des erreurs dans la logique de l'application, des vulnérabilités (injections SQL, XSS) et un fonctionnement instable. Dans cet article, nous allons examiner les trois bibliothèques les plus populaires pour la validation des données dans l'environnement Node.js : Joi, Yup et Zod. Vous découvrirez leurs caractéristiques, leurs avantages et apprendrez à les utiliser en pratique.

Pourquoi la validation côté serveur est-elle nécessaire ?

De nombreux développeurs se fient uniquement à la validation côté frontend (par exemple, avec les attributs HTML5). C'est une erreur. La validation côté client est facile à contourner (en désactivant JavaScript ou en envoyant une requête via Postman/curl). La validation côté serveur est la dernière ligne de défense. Elle garantit que seules les données conformes à des exigences strictes (type correct, longueur, format (email, URL), caractère obligatoire des champs, etc.) parviennent à votre logique métier et à votre base de données.

1. Joi — un vétéran éprouvé

Joi (souvent utilisé avec le framework Hapi.js, mais fonctionne parfaitement avec Express/Koa) est l'une des bibliothèques les plus puissantes et flexibles. Elle offre une API riche pour décrire des schémas et des messages d'erreur.

Installation :

npm install joi

Exemple d'utilisation de Joi pour la validation de l'inscription d'un utilisateur :

const Joi = require('joi');

const schema = Joi.object({    username: Joi.string()        .alphanum()        .min(3)        .max(30)        .required()        .messages({            'string.min': 'Le nom d'utilisateur doit comporter au moins {#limit} caractères',            'string.max': 'Le nom d'utilisateur doit comporter au maximum {#limit} caractères'        }),    password: Joi.string()        .pattern(new RegExp('^[a-zA-Z0-9]{3,30}$'))        .required(),    email: Joi.string()        .email({ minDomainSegments: 2, tlds: { allow: ['com', 'net', 'ru'] } })        .required(),    birth_year: Joi.number()        .integer()        .min(1900)        .max(2023)});

const validateUser = (data) => {    const { error, value } = schema.validate(data, { abortEarly: false });    if (error) {        // Retourner toutes les erreurs        return { valid: false, errors: error.details.map(d => d.message) };    }    return { valid: true, data: value };};

// Exemple d'appelconst result = validateUser({    username: 'jo',    password: '123',    email: 'test@test',    birth_year: 1800});console.log(result.errors);// Sortie : ['Le nom d'utilisateur doit comporter au moins 3 caractères', '"password" length must be at least 3 characters long', '"email" must be a valid email', '"birth_year" must be less than or equal to 2023']

Avantages de Joi :

• Nombre considérable de validateurs intégrés (email, URL, UUID, carte de crédit, téléphone, etc.).
• Prise en charge de la validation conditionnelle (when, switch).
• Excellents messages d'erreur avec possibilité de traduction et de personnalisation.
• Documentation détaillée.

Inconvénients :

• Taille de la bibliothèque (environ 60 Ko en version compressée).
• L'API peut sembler lourde pour des schémas simples.
• Intégration complexe avec TypeScript (nécessite des types supplémentaires).

2. Yup — simplicité et composition

Yup a été initialement créé pour la validation de formulaires sur React (en combinaison avec Formik), mais fonctionne parfaitement côté serveur. Son principal avantage est une syntaxe concise et lisible, rappelant les schémas mongoose.

Installation :

npm install yup

Exemple de validation d'un tableau d'objets avec Yup :

const yup = require('yup');

cons