Global

Members

(constant) createUser

Crée un nouvel utilisateur via l'API.

Source:

(constant) getUsers

Récupère la liste de tous les utilisateurs depuis l'API.

Source:

Methods

validateAge(birthDate) → {AgeValidationResult}

Valide l'âge d'une personne à partir de sa date de naissance.

Cette fonction effectue les vérifications suivantes:

  • Vérifie que la valeur n'est pas null ou undefined
  • Vérifie que le format est correct (Date ou string convertible)
  • Vérifie que la date n'est pas dans le futur
  • Calcule l'âge précis (gestion des années bissextiles et du 29 février)
  • Rejette strictement si l'âge est inférieur à 18 ans
Parameters:
Name Type Description
birthDate Date | string

Date de naissance à valider
Source:
Throws:

  • Lance une erreur avec code INVALID_DATE si la date est invalide

    Type
    ValidationError

  • Lance une erreur avec code DATE_IN_FUTURE si la date est future

    Type
    ValidationError

  • Lance une erreur avec code AGE_BELOW_MINIMUM si l'âge < 18 ans

    Type
    ValidationError
Returns:

Objet contenant le résultat de validation

Type
AgeValidationResult
Examples
// Cas valide
const result = validateAge(new Date('1990-05-15'));
console.log(result); // { isValid: true, age: 35, birthDate: Date }
// Cas invalide - Mineur
try {
  validateAge(new Date('2010-01-01'));
} catch (error) {
  console.log(error.code); // 'AGE_BELOW_MINIMUM'
}

validateEmail(email) → {EmailValidationResult}

Valide une adresse email selon le format standard.

Cette fonction effectue les vérifications suivantes:

  • Vérifie que la valeur n'est pas null ou undefined
  • Vérifie que le type est string
  • Vérifie que la chaîne n'est pas vide ou uniquement des espaces
  • Valide le format: partie_locale@domaine.extension

Format accepté:

  • Partie locale: lettres, chiffres, points (.), underscores (_), tirets (-)
  • Arobase: @ (obligatoire, un seul)
  • Domaine: lettres, chiffres, points (.), tirets (-)
  • Extension: au moins 2 lettres
Parameters:
Name Type Description
email string

Adresse email à valider
Source:
Throws:

Lance une erreur avec code INVALID_EMAIL_FORMAT si le format est invalide

Type
ValidationError
Returns:

Objet contenant le résultat de validation

Type
EmailValidationResult

validateIdentity(identity) → {IdentityValidationResult}

Valide un nom ou prénom avec protection XSS.

Cette fonction effectue les vérifications suivantes:

  • Vérifie que la valeur n'est pas null ou undefined
  • Vérifie que le type est string
  • Vérifie que la chaîne n'est pas vide ou uniquement des espaces
  • Détecte les tentatives d'injection XSS (caractères < ou >)
  • Valide le format: lettres (avec accents), tirets, apostrophes, espaces uniquement
  • Rejette les chiffres et caractères spéciaux

Caractères acceptés:

  • Lettres: a-z, A-Z
  • Accents: À-ÿ, caractères Unicode \u00C0-\u017F
  • Tirets: -
  • Apostrophes: '
  • Espaces
Parameters:
Name Type Description
identity string

Nom ou prénom à valider
Source:
Throws:

  • Lance une erreur avec code XSS_DETECTED si des balises HTML sont détectées

    Type
    ValidationError

  • Lance une erreur avec code INVALID_IDENTITY_FORMAT si le format est invalide

    Type
    ValidationError
Returns:

Objet contenant le résultat de validation

Type
IdentityValidationResult

validatePostalCode(postalCode) → {PostalCodeValidationResult}

Valide un code postal français (format: 5 chiffres exacts).

Cette fonction effectue les vérifications suivantes:

  • Vérifie que la valeur n'est pas null ou undefined
  • Vérifie que le type est string (rejette les nombres)
  • Vérifie que la chaîne n'est pas vide
  • Vérifie le format: exactement 5 chiffres (regex: /^\d{5}$/)
Parameters:
Name Type Description
postalCode string

Code postal à valider (doit être une string)
Source:
Throws:

Lance une erreur avec code INVALID_POSTAL_CODE_FORMAT si le format est invalide

Type
ValidationError
Returns:

Objet contenant le résultat de validation

Type
PostalCodeValidationResult

Type Definitions

AgeValidationResult

Résultat de la validation d'âge

Type:
  • Object
Properties:
Name Type Description
isValid boolean

Indique si l'âge est valide (toujours true si la fonction ne lève pas d'erreur)
age number

Âge calculé en années complètes
birthDate Date

Date de naissance validée
Source:

EmailValidationResult

Résultat de la validation d'email

Type:
  • Object
Properties:
Name Type Description
isValid boolean

Indique si l'email est valide (toujours true si la fonction ne lève pas d'erreur)
email string

Email validé
Source:

IdentityValidationResult

Résultat de la validation d'identité

Type:
  • Object
Properties:
Name Type Description
isValid boolean

Indique si l'identité est valide (toujours true si la fonction ne lève pas d'erreur)
identity string

Identité validée
Source:

PostalCodeValidationResult

Résultat de la validation de code postal

Type:
  • Object
Properties:
Name Type Description
isValid boolean

Indique si le code postal est valide (toujours true si la fonction ne lève pas d'erreur)
postalCode string

Code postal validé
Source: