> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# usePasswordValidation

```tsx theme={null}
usePasswordValidation(
  password: string,
  options?: { includeInErrors?: boolean },
): PasswordValidationResult
```

<ParamField body="usePasswordValidation" type={<span><a href="/fr-CA/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/PasswordValidationResult">PasswordValidationResult</a></span>}>
  Ce hook React valide un mot de passe en fonction de la politique de mot de passe Auth0 actuelle du locataire
  et renvoie un résultat structuré indiquant si le mot de passe respecte chaque règle.

  Au besoin, il peut envoyer les résultats de validation au gestionnaire d’erreurs global afin que
  les composants d’erreur du formulaire se mettent à jour automatiquement.

  ### Principales fonctionnalités

  * **Validation tenant compte de la politique** — vérifie le mot de passe en fonction des règles de la politique de mot de passe Auth0 configurée pour le locataire.
  * **Intégration au gestionnaire d’erreurs** — transmet facultativement les échecs de validation aux composants d’erreur du formulaire, automatiquement.

  ## Paramètres

  <ParamField body="password" type="string">
    Le mot de passe à valider.
  </ParamField>

  <ParamField body="options" type="{ includeInErrors?: boolean }">
    Configuration facultative du hook.

    <Expandable title="propriétés">
      <ParamField body="includeInErrors" type="boolean">
        Si `true`, les erreurs de validation sont stockées dans le gestionnaire d’erreurs global sous le champ `password`. La valeur par défaut est `false`.
      </ParamField>
    </Expandable>
  </ParamField>

  ## Renvoie

  [`PasswordValidationResult`](/fr-CA/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/PasswordValidationResult)

  Un objet [PasswordValidationResult](/fr-CA/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/PasswordValidationResult) contenant :

  * `isValid` — `true` si le mot de passe respecte toutes les règles configurées.
  * `results` — un tableau de résultats pour chaque règle, avec `code`, `label`, `status` et `isValid`.

  ## Écrans pris en charge

  * `signup`
  * `signup-password`
  * `reset-password`

  ```tsx Example theme={null}
  import { usePasswordValidation } from '@auth0/auth0-acul-react/signup';

  const { isValid, results} = usePasswordValidation(password, { includeInErrors: true });

  if (!isValid) {
    console.log(results);
  }
  ```

  ## Remarques

  * Appelez `usePasswordValidation` au niveau supérieur de votre composant; ne l’appelez pas de façon conditionnelle ni dans des gestionnaires d’événements.
  * Le chemin d’importation doit correspondre à l’écran — utilisez `signup`, `signup-password` ou `reset-password`, selon le cas.
</ParamField>