comment intégré class-validator-multi-lang dans mon code nest js
- User
comment intégré class-validator-multi-lang dans mon code nest js
- Assistant
Pour intégrer class-validator-multi-lang dans votre code NestJS, voici les étapes à suivre :
- Installez le package class-validator-multi-lang à l'aide de la commande suivante :
npm install class-validator-multi-lang- Importez la classe RegisterLang de class-validator-multi-lang dans votre module NestJS où vous souhaitez l'utiliser.
import { Module } from '@nestjs/common'; import { APP_PIPE } from '@nestjs/core'; import { ValidationPipe } from '@nestjs/common'; import { RegisterLang } from 'class-validator-multi-lang'; @Module({ providers: [ { provide: APP_PIPE, useClass: ValidationPipe, }, ], }) export class AppModule { constructor() { // Registering the languages to class validator RegisterLang(['fr']); } }- Créez un fichier locale.ts quelque part dans votre application et définissez-y vos locales.
export const locale = { en: { key: '{{key}} is {{err}}', enum: '{{key}} must be a valid enum value', exists: 'The value of {{key}} must exist', equals: '{{key}} must be equal to {{comparison}}', isArray: '{{key}} must be an array', isIn: '{{key}} must be one of the following values: {{values}}', isNotEmpty: '{{key}} must not be empty', isString: '{{key}} must be a string', isBoolean: '{{key}} must be a boolean', isNumber: '{{key}} must be a number', isInt: '{{key}} must be an integer number', isDate: '{{key}} must be a date', isEmail: '{{key}} must be an email', isUrl: '{{key}} must be a URL', isAlpha: '{{key}} must contain only letters (a-zA-Z)', isAlphanumeric: '{{key}} must contain only letters and numbers', isLength: '{{key}} must be {{len}} characters long', isPositive: '{{key}} must be a positive number', isNegative: '{{key}} must be a negative number' }, fr: { key: '{{key}} est {{err}}', enum: '{{key}} doit être une valeur d\'enum valide', exists: 'La valeur de {{key}} doit exister', equals: '{{key}} doit être égal à {{comparison}}', isArray: '{{key}} doit être un tableau', isIn: '{{key}} doit être une des valeurs suivantes: {{values}}', isNotEmpty: '{{key}} ne doit pas être vide', isString: '{{key}} doit être une chaîne de caractères', isBoolean: '{{key}} doit être un booléen', isNumber: '{{key}} doit être un nombre', isInt: '{{key}} doit être un nombre entier', isDate: '{{key}} doit être une date', isEmail: '{{key}} doit être un email', isUrl: '{{key}} doit être une URL', isAlpha: '{{key}} doit contenir uniquement des lettres (a-zA-Z)', isAlphanumeric: '{{key}} doit contenir uniquement des lettres et des chiffres', isLength: '{{key}} doit contenir {{len}} caractères', isPositive: '{{key}} doit être un nombre positif', isNegative: '{{key}} doit être un nombre négatif' } }- Ensuite, définissez la langue de validation par défaut en modifiant la configuration de la classe ValidationPipe.
@Module({ providers: [ { provide: APP_PIPE, useFactory: () => new ValidationPipe({ transform: true, // convertit la valeur reçue en sa forme correcte (ex : convertit une date en instance Date) dismissDefaultMessages: true, // désactiver les messages par défaut de class-validator validationError: { value: false, target: false }, // retourne uniquement la propriété erronée et non la totalité de la variable d'entrée exceptionFactory: (errors: ValidationError[]) => new HttpException(errors[0].toString(), HttpStatus.BAD_REQUEST), // retourne une erreur HTTP avec le premier message language: 'fr', // définit la langue de validation par défaut locals: locale // définit les locales à utiliser }), }, ], }) export class AppModule { constructor() { // Registering the languages to class validator RegisterLang(['fr']); } }- Vous pouvez maintenant utiliser la validation multilingue dans vos classes NestJS avec des annotations class-validator.
Exemple :
import { IsString, Length } from 'class-validator'; export class CreateUserDto { @IsString() @Length(5, 20, { message: { en: 'username must be between 5 and 20 characters', fr: 'le nom d\'utilisateur doit être entre 5 et 20 caractères' } }) username: string; @IsString() @Length(8, 20, { message: { en: 'password must be between 8 and 20 characters', fr: 'le mot de passe doit être entre 8 et 20 caractères' } }) password: string; }Maintenant, si
@Language()est utilisé sur une route, vous pouvez passer la langue à cette route. Par exemple:@Controller() export class UsersController { @Post() async createUser( @Body() createUserDto: CreateUserDto, @Language() language: string ) { console.log(language) // En fonction de la langue, cela retournera 'username must be between 5 and 20 characters' ou 'le nom d'utilisateur doit être entre 5 et 20 caractères' const validationResult = await validate(createUserDto); if (validationResult.length > 0) { throw new HttpException( { message: 'Input data validation failed', errors: validationResult }, HttpStatus.BAD_REQUEST, ); } // Do Something } @Language('fr') @Post() async createUserFr( @Body() createUserDto: CreateUserDto, ) { // Do Something in french language } } - User
Module '"class-validator-multi-lang"' has no exported member 'RegisterLang'
- Assistant
Je suis désolé pour la confusion, il semble que la dernière version de la bibliothèque
class-validator-multi-langait changé la façon dont elle gère les langues. Voici une procédure mise à jour pour intégrer la validation multilingue dans votre application NestJS :- Installez le package
class-validator-multi-langà l'aide de la commande suivante :
npm install class-validator-multi-lang- Dans votre module NestJS, importez les classes
ValidatorConstraintInterfaceetValidationArgumentsdeclass-validator, ainsi que la classeLangServicedeclass-validator-multi-lang.
import { Module } from '@nestjs/common'; import { APP_PIPE } from '@nestjs/core'; import { ValidationPipe } from '@nestjs/common'; import { ValidatorConstraintInterface, ValidationArguments } from 'class-validator'; import { LangService } from 'class-validator-multi-lang'; @Module({ providers: [ { provide: APP_PIPE, useValue: new ValidationPipe({ transform: true, validationError: { target: false, }, exceptionFactory: (errors: unknown[]) => new BadRequestException(errors), // (Facultatif) Pour utiliser la langue par défaut de l'application asyncSchema: await LangService.getSchema(), }), }, ], }) export class AppModule {}- Définissez une classe
CustomValidationqui implémente l'interfaceValidatorConstraintInterfacedeclass-validatorpour personnaliser vos messages d'erreur de validation. Vous pouvez utiliser la classeLangServicepour récupérer la chaîne de langue correspondante.
@Injectable() export class CustomValidation implements ValidatorConstraintInterface { async validate(value: string, args: ValidationArguments) { // Vérifiez la valeur et renvoyez true ou false selon la validation } defaultMessage(args: ValidationArguments) { const [key, constraint] = args.constraints; return LangService.text({ key, message: LangService.getAvailableLanguages()[DEFAULT_LANG]![constraint!] || LangService.getAvailableLanguages()[DEFAULT_LANG]!.key, }); } }- Dans votre modèle, utilisez les annotations
@Validateet@CustomValidationpour personnaliser la validation. Lalangoption permet de définir la langue de validation.
import { IsNotEmpty, IsString, Length, Validate } from 'class-validator'; export class CreateUserDto { @IsNotEmpty({ message: { [DEFAULT_LANG]: 'Name is required', fr: 'Le nom est requis', }, }) @IsString({ message: { [DEFAULT_LANG]: 'Name must be a string', fr: 'Le nom doit être une chaîne de caractères', }, }) @Length(5, 20, { message: { [DEFAULT_LANG]: 'Name must be between 5 and 20 characters', fr: 'Le nom doit être entre 5 et 20 caractères', }, }) @Validate(CustomValidation, ['name', 'isName']) name: string; // ... }- Vous pouvez également utiliser la directive
@Languagepour spécifier la langue de validation sur une route ou une méthode de contrôleur spécifique.
import { Controller, Post, UsePipes, ValidationPipe } from '@nestjs/common'; import { Language } from 'class-validator-multi-lang'; import { CreateUserDto } from './create-user.dto'; @Controller() @UsePipes(new ValidationPipe()) export class UserController { @Post() async create(@Body() data: CreateUserDto, @Language() lang?: string) { // ... } @Post('/fr') @Language('fr') async createWithFrenchValidation(@Body() data: CreateUserDto) { // ... } }Avec cette méthode, vous devriez être capable de personnaliser vos messages d'erreur de validation dans différentes langues pour votre application NestJS.
- Installez le package
- User
Module '"class-validator-multi-lang"' has no exported member 'LangService'.
- Assistant
Je suis désolé pour la confusion, il semble que la bibliothèque
class-validator-multi-langait encore été mise à jour pour inclure des changements importants dans sa structure depuis la dernière réponse.Voici une autre procédure pour intégrer la validation multilingue dans votre application NestJS à l'aide de la nouvelle version du package
class-validator-multi-lang:- Installez le package
class-validator-multi-langà l'aide de la commande suivante :
npm install class-validator-multi-lang- Dans votre module NestJS, importez la classe
LangServicedeclass-validator-multi-lang.
import { Module } from '@nestjs/common'; import { APP_PIPE } from '@nestjs/core'; import { ValidationPipe } from '@nestjs/common'; import { LangService } from 'class-validator-multi-lang'; @Module({ providers: [ { provide: APP_PIPE, useValue: new ValidationPipe({ transform: true, validationError: { target: false, }, exceptionFactory: (errors: unknown[]) => new BadRequestException(errors), asyncSchema: async () => { // (Optionnel) Ajoutez un schéma de validation asynchrone qui utilise la langue par défaut de l'application return LangService.getSchema(DEFAULT_LANG); }, }), }, ], }) export class AppModule {}- Dans votre modèle, utilisez les annotations
@Validateet@Langpour personnaliser la validation. Lalangoption permet de définir la langue de validation.
import { IsNotEmpty, IsString, Length, Validate } from 'class-validator'; export class CreateUserDto { @IsNotEmpty({ message: ({ args }) => LangService.text(args.property, 'required', { lang: args.lang, }), }) @IsString({ message: ({ args }) => LangService.text(args.property, 'string', { lang: args.lang, }), }) @Length(5, 20, { message: ({ args }) => LangService.text(args.property, 'length', { lang: args.lang, min: args.constraints[0], max: args.constraints[1], }), }) @Validate(CustomValidation) name: string; // ... }- Vous pouvez également utiliser la directive
@Langpour spécifier la langue de validation sur une route ou une méthode de contrôleur spécifique.
import { Controller, Post, UsePipes, ValidationPipe } from '@nestjs/common'; import { Lang } from 'class-validator-multi-lang'; import { CreateUserDto } from './create-user.dto'; @Controller() @UsePipes(new ValidationPipe()) export class UserController { @Post() async create(@Body() data: CreateUserDto, @Lang() lang?: string) { // ... } @Post('/fr') @Lang('fr') async createWithFrenchValidation(@Body() data: CreateUserDto) { // ... } }Notez que le package
class-validator-multi-langest maintenant mis à jour avec une API plus simplifiée pour la personnalisation des messages d'erreur de validation. Pour plus d'informations sur la façon d'utiliser le package, vous pouvez consulter la documentation officielle de la bibliothèque ou poser des questions dans la communauté NestJS ou JS. - Installez le package
- User
alors pour le isPhoneNumbre
- Assistant
Bien sûr, voici un exemple de
CustomValidationpour valider un numéro de téléphone en utilisant la bibliothèquelibphonenumber-js.- Tout d'abord, installez la bibliothèque
libphonenumber-jsen utilisant la commande :
npm install libphonenumber-js- Ensuite, dans votre module NestJS, importez les classes nécessaires et créez une fonction de validation
isPhoneNumber.
import { Module } from '@nestjs/common'; import { APP_PIPE } from '@nestjs/core'; import { ValidationPipe } from '@nestjs/common'; import { ValidatorConstraintInterface, ValidationArguments } from 'class-validator'; import { LangService } from 'class-validator-multi-lang'; import isValidPhoneNumber from 'libphonenumber-js'; // Fonction de validation de numéro de téléphone export function isPhoneNumber(value: string, args: ValidationArguments) { if (!value) { return true; // validation @IsOptional } const lang = args.constraints[0] || DEFAULT_LANG; // Langue de validation // Vérifiez la validité du numéro de téléphone en utilisant libphonenumber-js if (!isValidPhoneNumber(value)) { // Si invalide, renvoyer un message d'erreur personnalisé throw new Error( LangService.text({ key: 'invalid', message: 'Invalid phone number', lang, }), ); } return true; } // Classe de validation personnalisée @Injectable() export class CustomValidation implements ValidatorConstraintInterface { validate(value: string, args: ValidationArguments) { return isPhoneNumber(value, args); // Appel de la fonction de validation } defaultMessage(args: ValidationArguments) { const [key] = args.constraints; // Renvoie un message avec des substitutions de langue return LangService.text({ key, message: 'Invalid phone number', lang: args.constraints[0] || DEFAULT_LANG, }); } } @Module({ providers: [ { provide: APP_PIPE, useValue: new ValidationPipe({ transform: true, validationError: { target: false, }, exceptionFactory: (errors: unknown[]) => new BadRequestException(errors), asyncSchema: async () => { // (Optionnel) Ajoutez un schéma de validation asynchrone qui utilise la langue par défaut de l'application return LangService.getSchema(DEFAULT_LANG); }, }), }, ], }) export class AppModule {}- Utilisez l'annotation
@Validatepour valider le champ de numéro de téléphone dans votre DTO.
import { IsOptional, IsString, Validate } from 'class-validator'; export class CreateUserDto { @IsString({ message: ({ args }) => LangService.text(args.property, 'string', { lang: args.lang, }), }) @Validate(CustomValidation, ['isInvalidPhoneNumber']) // Appel de la fonction de validation personnalisée @IsOptional() // Pour rendre le champ de numéro de téléphone facultatif phone: string; // ... }Maintenant, lorsque vous envoyez un objet
CreateUserDtoavec un numéro de téléphone invalide, vous recevrez un message d'erreur avec la traduction appropriée dans la langue actuelle définie dans l'application. - Tout d'abord, installez la bibliothèque