Regex pour les numéros de téléphone : formats américains, E.164, et quand s'arrêter

Demandez leur numéro à dix personnes, et vous le recevrez sous dix formes : 555-123-4567, (555) 123-4567, 555.123.4567, +1 555 123 4567, 5551234567. C'est pourtant le même numéro.

Une regex de téléphone doit accepter les formes que les gens tapent vraiment, tout en repérant les erreurs évidentes. Cet article construit un motif pour les numéros américains pièce par pièce, aborde ensuite le format international, et termine par ce qu'une regex ne sait pas faire. Tous les exemples sont interactifs : modifiez les motifs et regardez les lignes changer.

01Commencer par les chiffres

Un numéro américain, c'est un indicatif régional de 3 chiffres, un central de 3 chiffres et un numéro de ligne de 4 chiffres. La version la plus stricte n'accepte qu'un seul format :

C'est très bien si vous contrôlez le masque de saisie. Si les gens tapent librement, c'est trop strict.

02Autoriser les séparateurs courants

Remplacez chaque tiret par [-. ]? : un tiret, un point ou un espace, et le ? le rend facultatif pour que les chiffres seuls passent aussi.

Un effet de bord : chaque séparateur est choisi indépendamment, donc 555-123.4567 passe aussi. C'est généralement sans gravité. Si vous voulez que les deux séparateurs soient identiques, capturez le premier et répétez-le avec une référence arrière (backreference ; plus de détails dans notre guide des références arrière) :

03Des parenthèses autour de l'indicatif

La correction tentante pour (555) 123-4567 consiste à rendre chaque parenthèse facultative avec \(? et \)?. Cela accepte des saisies déséquilibrées :

L'alternance règle le problème. Soit l'indicatif est entre parenthèses (avec un espace facultatif après), soit il est nu (avec un séparateur facultatif après) :

04Le +1 facultatif

L'indicatif des États-Unis est 1, écrit +1, 1 ou carrément omis. Placez-le dans un groupe facultatif au début :

Voilà un motif solide pour un formulaire réservé aux États-Unis.

05Resserrer avec les règles des indicatifs

Les vrais indicatifs régionaux américains et les codes de central (les trois chiffres du milieu) ne commencent jamais par 0 ou 1. Remplacer \d{3} par [2-9]\d{2} à ces deux endroits rejette le faux numéro classique :

Que cela en vaille la peine dépend de vos utilisateurs. Cela attrape quelques fautes de frappe, mais rend aussi le motif plus difficile à lire.

06Les numéros internationaux : E.164

Hors des États-Unis, les formats varient trop pour un seul motif. Plutôt que d'essayer, la plupart des systèmes stockent les numéros au format E.164, la norme internationale : un +, l'indicatif du pays, puis le numéro, sans espaces ni ponctuation, et 15 chiffres au maximum. Les indicatifs de pays ne commencent jamais par 0.

L'approche habituelle consiste à laisser les gens taper leur numéro comme ils veulent, retirer la ponctuation, puis vérifier le résultat. Une regex est parfaite pour l'étape de nettoyage :

En Python, cela donne re.sub(r"[\s().-]", "", number). En JavaScript, number.replace(/[\s().-]/g, "").

07Ce qu'une regex ne peut pas vous dire

^\+[1-9]\d{1,14}$ vérifie la forme. Il ne peut pas vous dire :

• si l'indicatif du pays existe (+999 n'en est pas un, et le motif l'accepte),
• si la longueur est correcte pour ce pays (les numéros britanniques et allemands n'ont pas la même longueur, et certains pays mélangent les longueurs),
• si le numéro est un mobile, un fixe ou non attribué,
• si quelqu'un décroche.

Pour une vraie validation, utilisez libphonenumber, la bibliothèque de numéros de téléphone de Google. Elle connaît le plan de numérotation de chaque pays, et elle est portée dans la plupart des langages : phonenumbers en Python et libphonenumber-js en JavaScript. Elle formate aussi les numéros pour l'affichage et les convertit en E.164 pour le stockage :

import phonenumbers

n = phonenumbers.parse("(212) 555-0199", "US")
phonenumbers.format_number(n, phonenumbers.PhoneNumberFormat.E164)  # '+12125550199'
phonenumbers.is_possible_number(n)  # True: the length fits the US plan

Et comme pour les adresses e-mail, la seule façon de prouver qu'un numéro fonctionne, c'est d'y envoyer un code.

08À vous de jouer

Voici un plateau de numéros de téléphone aux formats variés. Inutile de vérifier chaque format séparément. Chaque monstre contient dix chiffres d'affilée (ponctuation mise à part), ce qu'aucun innocent ne fait :

09Récapitulatif

• Pour une saisie américaine uniquement, ^(\+?1[-. ]?)?(\(\d{3}\) ?|\d{3}[-. ]?)\d{3}[-. ]?\d{4}$ couvre les formats courants.
• Utilisez l'alternance, pas deux parenthèses facultatives, pour que ( et ) aillent par paire.
• Pour les numéros internationaux, retirez la ponctuation avec [\s().-] et stockez en E.164.
• Vérifiez la forme avec ^\+[1-9]\d{1,14}$, et utilisez libphonenumber quand l'enjeu est réel.
• Envoyez un code si vous devez savoir que le numéro existe vraiment.

10Continuez à vous entraîner

• Le parcours Validateurs du monde réel de l'Académie couvre les codes postaux, les dates, les heures, les e-mails et bien plus, une chasse à la fois.
• La section du guide sur les motifs courants propose d'autres exemples interactifs.
• Essayez la chasse du jour, ou attaquez les plateaux plus anciens dans les archives.