Skip to content

string ​

Construit un parser pour les chaînes de caractères. DDataParser.string() garantit que l'entrée est bien une chaîne (avec support optionnel de la coercition), applique les checkers fournis et retourne un Either typé contenant soit la valeur validée, soit un DataParserError détaillé.

Exemple interactif ​

Paramètres ​

  • errorMessage : message personnalisé injecté dans chaque issue lorsque l'entrée n'est pas une chaîne.
  • checkers : tableau de checkers (checkerStringMin, checkerStringMax, checkerStringRegex, checkerEmail, checkerUrl, checkerUuid, checkerRefine, etc.) exécutés après la validation de base.
  • coerce : true pour transformer les entrées non-string (nombres, booleans, objets avec toString) avant de lancer les checkers. Par défaut false.

Contrat checker ​

Les checkers suivent un contrat de type : un checker est compatible si son type d'entrée correspond à la sortie du parser.

Certains checkers string affinent le type de sortie. Par exemple, checkerEmail() resserre string vers `${string}@${string}.${string}`, et un checkerRefine(...) avec type predicate peut resserrer la sortie vers votre propre sous-type de chaîne.

Valeur de retour ​

Un DataParserString disposant de parse, asyncParse, exec, asyncExec, addChecker et clone. schema.parse(data) renvoie DEither.success<Output> lorsque toutes les validations passent, ou DEither.error<DataParserError> avec les chemins (path), les messages et les valeurs rejetées.

Others exemples ​

Checkers personnalisés ​

Mode étendu ​

Voir aussi ​

  • boolean — parser pour les valeurs booléennes
  • coerce.* — variantes spécialisées pour normaliser les entrées avant validation stricte

Diffusé sous licence MIT.