Scaricare i siti web che utilizzano libphonenumber

Informazioni su libphonenumber

Nulla in un numero di telefono è semplice come sembra. La lunghezza, il prefisso, il fatto che un intervallo sia mobile o fisso e il fatto che uno zero iniziale sopravviva quando il numero attraversa un confine sono tutte decisioni che un’autorità di regolamentazione ha preso e può revocare. La libreria libphonenumber esiste per questo motivo, e perché i numeri di telefono sono uno dei pochi tipi di dati comuni in cui una validazione ingenua è sicuramente sbagliata. Pubblicata da Google con licenza Apache 2.0 e scritta in origine in Java nel 2009, la libreria analizza, valida e formatta i numeri secondo il piano di numerazione di ogni paese che ne ha uno.

La proprietà importante è che la libreria è fatta soprattutto di metadati. La logica di parsing è ridotta e stabile, e il grosso di ogni versione è una tabella che descrive quali prefissi esistono, quali lunghezze sono ammesse, quali intervalli sono mobili e a quale paese appartiene un numero. I piani di numerazione cambiano di continuo. Le autorità di regolamentazione aprono nuovi intervalli mobili, ritirano vecchi prefissi e allungano i numeri degli abbonati, quindi una copia della libreria invecchia in un modo specifico e misurabile. Una build obsoleta non va in crash. Una build obsoleta rifiuta silenziosamente clienti reali i cui numeri sono stati assegnati dopo la pubblicazione di quella copia, un errore che non compare mai in un log e si manifesta solo come un problema di conversione che l’azienda non riesce a spiegare.

I dati di versione rendono visibile l’invecchiamento, ed è per questo che la voce vale più di una semplice verifica del nome. Sul campo distinguiamo 99 versioni diverse, e la versione 1.12.41 ricorre in gran parte della popolazione. La dispersione delle versioni è di fatto una mappa di quanto sia diventata obsoleta la validazione dei numeri di telefono sul web, perché la versione che qualcuno ha inserito nel bundle è quella che il suo modulo di registrazione esegue ancora, e i bundle vengono ricostruiti solo quando qualcos’altro impone una ricostruzione.

Per leggere correttamente la popolazione serve un’avvertenza importante. La libreria è una dipendenza e non un servizio, e nella maggior parte dei contesti in cui conta gira sul server, all’interno di pipeline di registrazione, piattaforme di dati dei clienti e sistemi di messaggistica che nessun crawler può vedere. Ciò che rileviamo è la porzione lato browser, il porting incluso in una pagina perché un modulo possa validare i dati prima dell’invio. A ottobre 2026 questa porzione copre 103.712 siti, e la reale base installata, considerando tutti i linguaggi e gli ambienti di esecuzione, è molto più ampia e non è osservabile dall’esterno.

La geografia si legge allo stesso modo e merita la stessa cautela. Dei siti rilevati, 98.359 si trovano negli Stati Uniti, e il mix di domini è orientato verso l’estensione .com. La concentrazione geografica dei rilevamenti dice di più su quale mercato integra l’inserimento di numeri internazionali nei propri moduli, e su dove sono ospitati quei siti, che su dove si faccia davvero affidamento sulla libreria, perché la validazione transfrontaliera interessa le aziende che vendono oltre confine, e aziende del genere non sono distribuite in modo uniforme.

Una ricerca per singolo dominio dice se un modulo valida correttamente i numeri. L’elenco risponde a domande che esistono solo in forma aggregata: quali parti del web usano metadati di numerazione obsoleti e rifiuterebbero un numero mobile appena assegnato, con quale rapidità un determinato settore ricostruisce i propri bundle front end, quali siti fanno abbastanza affari a livello internazionale da porsi anche solo il problema, e quali fornitori di piattaforme congelano una singola versione nel prodotto che rivendono a migliaia di commercianti. Per un operatore di comunicazioni, un team antifrode, un fornitore di moduli o chiunque misuri su larga scala l’aggiornamento delle dipendenze, la dispersione delle versioni sull’intera popolazione è il risultato, e nessun singolo sito può produrlo.