---
title: Validateurs
slug: oip-next/v3/core/entity/validateurs
icon: {"lucideIcon":"📘"}
createdAt: 2025-10-13T13:36:10.000Z
---

## 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 :

```javascript
@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 ;&#x20;
- la **casse** d’une chaîne (minuscule ou majuscule) ;&#x20;
- une **adresse email** ;&#x20;
- un **code postal** ;&#x20;
- un **numéro de téléphone français** ;&#x20;
- un **numéro de téléphone international**.&#x20;

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

***

### Exemples d’utilisation

```javascript
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);
```
