Validateurs

4 min

Validateurs

Un validateur permet de contrôler la validité des données transmises à un setter.

Le module OIP Core fournit un utilitaire dédié à la gestion de ces validateurs. Cet utilitaire est représenté par l’objet Validator, importable depuis le module :

@fasstech/oip-core/entities/helpers/validator

L’objet Validator expose notamment la fonction validate(), utilisée pour exécuter les règles de validation définies.

Validateurs disponibles

Les validateurs intégrés permettent de vérifier notamment :

la longueur d’une chaîne de caractères ;

la casse d’une chaîne (minuscule ou majuscule) ;

une adresse email ;

un code postal ;

un numéro de téléphone français ;

un numéro de téléphone international.

Des validateurs personnalisés peuvent également être définis, et plusieurs validateurs peuvent être combinés.

Exemples d’utilisation

import { Validator } from '@fasstech/oip-core/entities/helpers/validator';

// 5 caractères exactement
Validator({ exactLength: 5 }).validate(value);

// Au plus 5 caractères
Validator({ maxLength: 5 }).validate(value);

// Au moins 1 caractère
Validator({ minLength: 1 }).validate(value);

// Minuscule
Validator({ type: 'lowerCase' }).validate(value);

// Majuscule
Validator({ type: 'upperCase' }).validate(value);

// Adresse email
Validator({ type: 'mail' }).validate(value);

// Code postal
Validator({ type: 'postal' }).validate(value);

// Numéro de téléphone en France
Validator({ type: 'localPhone' }).validate(value);

// Numéro de téléphone à l’international
Validator({ type: 'internationalPhone' }).validate(value);

// Validateur personnalisé
Validator({ type: (value) => value === 'foobar' }).validate(value);

// Combinaison de validateurs
Validator({ type: ['mail', (value) => value.endsWith('fasst.io')] }).validate(value);
Validator({ maxLength: 8, type: (value) => value.startsWith('foo') }).validate(value);