ForHosting KIT · Outils pour développeurs

Expliquez une regex en langage clair

Voyez ce que fait chaque morceau d’une expression régulière : l’expression d’adresse e-mail d’exemple se découpe en 16 parties expliquées avec 3 groupes capturants, le premier nommé user, chacune avec sa position et une description claire. Gratuit dans votre navigateur.

  • Gratuit
  • Fonctionne dans votre navigateur
  • Sans inscription
  • Vos données restent sur votre appareil
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt
Si vous saisissez
Indicateurs
i
Vous obtenez
Parfum
ECMAScript
Groupes de capture
3

Une expression régulière peut tenir sur une seule ligne tout en dissimulant plusieurs règles indépendantes. Cet outil valide un motif ECMAScript, le parcourt de gauche à droite et identifie groupes, quantificateurs, classes de caractères, ancres, échappements, alternatives, jokers et texte littéral. Chaque composant comporte sa position, sa profondeur d’imbrication et une explication claire, afin que vous puissiez relire, apprendre, documenter et déboguer le motif sans le modifier ni l’exécuter sur des données privées.

Lisez l’explication dans l’ordre du motif

Commencez par le tableau des composants, qui respecte exactement l’ordre du motif de gauche à droite. Chaque entrée indique un type, conserve le token d’origine et fournit un indice commençant à zéro ainsi que sa longueur. Ces positions relient une explication aux caractères précis d’une longue expression, sans devoir deviner quelle parenthèse ou quel point d’interrogation est concerné.

La profondeur situe le token dans les groupes imbriqués. Les entrées de début et de fin rendent la structure des groupes explicite, tandis que chaque groupe capturant reçoit son numéro selon l’ordre d’ouverture. Les captures nommées conservent également leur nom.

Lorsque cela est possible, les segments littéraux contigus restent réunis afin que le texte ordinaire demeure lisible. Parcourez d’abord les entrées dans l’ordre, puis utilisez les décomptes pour repérer les constructions qui méritent une analyse approfondie.

Comprenez les groupes, classes et répétitions

Les groupes structurent l’expression et peuvent capturer du texte en vue d’une réutilisation. Une parenthèse simple ouvre une capture numérotée, la séquence point d’interrogation et deux-points ouvre un groupe non capturant, et les captures nommées affichent le nom déclaré. Les anticipations et les rétrospections sont distinguées, car elles vérifient le texte environnant sans le consommer.

Une classe de caractères correspond à un caractère de sa liste ; les classes négatives sont signalées et les plages simples, telles que A à Z, sont résumées. Les échappements courants décrivent les chiffres, caractères de mot, espaces, limites, références arrière, propriétés Unicode et caractères codés. Les quantificateurs s’appliquent conceptuellement à l’élément précédent : l’astérisque signifie zéro ou plusieurs, le signe plus un ou plusieurs, le point d’interrogation rend l’élément facultatif, et les accolades indiquent une répétition exacte, minimale ou bornée.

Un point d’interrogation final rend la répétition paresseuse, ce que l’explication précise clairement.

Validez la syntaxe et reconnaissez le dialecte

Le motif est validé avec le moteur d’expressions régulières ECMAScript avant qu’une explication soit renvoyée. Cette étape est essentielle, car les dialectes diffèrent : une syntaxe issue de PCRE, Python, Java ou . NET peut avoir un autre sens en JavaScript, voire être entièrement refusée.

Envoyez le corps de l’expression sans barres obliques de délimitation et placez les indicateurs JavaScript facultatifs dans le champ flags. La validation confirme que l’expression peut être compilée ; elle ne prouve pas qu’elle reconnaît les données métier souhaitées, qu’elle reste performante pour toute entrée ou qu’elle évite un retour arrière excessif. Servez-vous de l’explication pour examiner la structure, puis testez des exemples représentatifs qui doivent correspondre ou non.

L’algorithme étant déterministe, sans réseau et sans texte cible, le même motif et les mêmes indicateurs donnent toujours la même explication structurée.

Relire une expression héritée

Transformez un motif dense provenant d’un ancien code en une liste ordonnée de constructions compréhensibles avant de le modifier.

Documenter les règles de validation

Produisez des notes structurées sur les groupes, caractères autorisés, ancres et répétitions employés par un formulaire ou un service.

Apprendre la syntaxe des regex

Comparez les tokens d’origine à des explications concises et à leurs positions dans la source en étudiant ECMAScript.

Quel dialecte d’expression régulière est expliqué ?

L’outil valide et explique les expressions régulières ECMAScript, c’est-à-dire la syntaxe de RegExp en JavaScript.

L’outil teste-t-il le motif sur mon texte ?

Non. Il explique uniquement la syntaxe et ne demande aucun texte cible. Utilisez séparément un testeur de regex.

Reconnaît-il les groupes capturants nommés et numérotés ?

Oui. Les captures sont numérotées dans leur ordre d’ouverture et les groupes nommés conservent leur nom déclaré.

Faut-il inclure les barres obliques autour de l’expression ?

Non. Saisissez seulement le corps de l’expression, sans les barres, et indiquez les options à part, par exemple i pour ignorer la casse. Les options invalides ou répétées sont refusées avec un message clair.

Que signifie un point d’interrogation après une répétition ?

Il rend la répétition paresseuse : elle préfère le moins de répétitions possible, et l’explication le précise. Seul, juste après un élément, le point d’interrogation rend simplement cet élément facultatif.

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

POSThttps://api.kit.forhosting.com/dev2/regex-explain

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

curl -X POST https://api.kit.forhosting.com/dev2/regex-explain \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pattern":"^(?<user>[A-Za-z0-9._%+-]+)@([A-Za-z0-9.-]+)\\.([A-Za-z]{2,})$"}'
{
  "pattern": "^(?<user>[A-Za-z0-9._%+-]+)@([A-Za-z0-9.-]+)\\.([A-Za-z]{2,})$"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev2.regex_explain",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

max_pattern_chars2000
HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Lisez l’explication dans l’ordre du motif

Le résumé donne un décompte rapide et component_counts facilite la documentation automatisée ou les rapports de contrôle.

Validez la syntaxe et reconnaissez le dialecte

Une syntaxe incorrecte, un indicateur non pris en charge ou un indicateur répété produit une erreur typée invalid_input, jamais une explication partielle ou trompeuse.

Faut-il inclure les barres obliques de délimitation ?

Non. Envoyez uniquement le corps dans pattern et placez les indicateurs tels que i ou m dans le champ flags.

Que se passe-t-il si la regex est incorrecte ?

La requête renvoie une erreur invalid_input qui décrit le problème de compilation, sans explication partielle.

Quel est le coût d’une requête API ?

Le tarif de base de l’API est de $0.002 par requête. La même logique déterministe fonctionne aussi dans le navigateur.

Consulter la documentation complète du KIT →