Работа с телефонными номерами в JavaScript

Когда вы собираете данные от пользователей, есть две ключевые проблемы; собирать эту информацию и проверять ее. Некоторые типы информации просты — например, чей-то возраст не может быть проще собрать и проверить. Имена не так просты, как звучат, но при условии, что вы учитываете крайние случаи и международные различия — например, отчества, одноименные или даже просто люди с дефисными фамилиями — вы не можете пойти слишком далеко не так (хотя множество приложений и услуги делают!). Адреса электронной почты, хотя теоретически их очень легко проверить, имеют свои проблемы, но, тем не менее, существует множество регулярных выражений, которые не совсем верны.

И тогда есть телефонные номера. Это сложно. Действительно трудно. В этой статье я расскажу о некоторых проблемах, связанных со сбором, проверкой и отображением телефонных номеров.

Почему телефонные номера разные

Возможно, вы думаете, что, поскольку телефонные номера, как правило, имеют довольно жесткий формат, такой как этот:

202-456-1111 

… что должно быть просто создать простое регулярное выражение для проверки их правильности. На самом деле, вот один:

 ^(\([0-9]{3}\)|[0-9]{3}-)[0-9]{3}-[0-9]{4}$ 

Ну, остановись прямо здесь. Для начала, вот только некоторые варианты приведенного выше числа, все из которых являются совершенно действительными:

 202 456 1111 (202) 456 1111 2024561111 1-202-456-1111 1-202-456-1111 x1234 1-202-456-1111 ext1234 1 (202) 456-1111 1.202.456.1111 1/202/456/1111 12024561111 +1 202 456 1111 

Исходя из этого, мы знаем, что apparoach с регулярными выражениями не так прост, как мы думали, но это только половина. Эти примеры только для номера в США. Конечно, если вы знаете, что номер, который вы собираете, будет для определенной страны, вы можете использовать регулярное выражение. В противном случае такой подход не поможет.

Давайте посмотрим на некоторые другие вопросы, касающиеся телефонных номеров, и почему они делают нашу работу еще сложнее.

Изменение номера

Все виды внешних факторов могут иметь значение для нумерации телефонов. Целые страны приходят и уходят, вводя новые префиксы стран. Новые классификации номеров вводят новые системы нумерации — премиум-тариф, местный тариф, бесплатный и т. Д. Когда у оператора заканчивается один набор номеров — как, к сожалению, премиум-тариф — он просто вводит новый префикс.

Некоторые изменения имеют огромное значение; например, в Соединенном Королевстве несколько лет назад вся региональная система нумерации претерпела радикальные изменения: практически в каждый код города добавлена ​​дополнительная цифра «1». Даже тогда в столице была немного другая система. Вероятно, прошло десять лет, прежде чем вывески были изменены по всей стране, чтобы отразить эти изменения.

Затем, конечно, произошел колоссальный и беспрецедентный рост мобильной связи. Количество требуемых телефонных номеров больше не ограничивалось количеством домохозяйств, но многократно. Продолжающаяся нагрузка на пул доступных номеров может только увеличить вероятность дальнейших изменений.

Международные телефонные коды

Часто важно захватить международный телефонный код номера. В некоторых случаях контекст может означать, что они не требуются. Например, если вы работаете в одной стране, и телефонные номера записаны для использования оператором-человеком, они могут вам не понадобиться. Но для чего-либо удаленно автоматизированного — например, для отправки SMS-сообщений — или для их эффективной проверки, вам нужно захватить префикс страны.

Библиотека стран содержит множество географической информации, которая включает в себя международные телефонные коды. Вот выдержка из countries.json из этой библиотеки:

 { "name": { "common": "Austria", "official": "Republic of Austria", // ... // }, // ... // "callingCode": ["43"], // ... // }, 

Как видите, это свидетельствует о том, что Австрия использует международный телефонный код 43.

Итак, как мы можем использовать эту информацию? Ну, используя магию Lodash (или Underscore), есть несколько способов, которыми мы можем запросить информацию, связанную с кодом набора номера.

 var _ = require('lodash') , data = require('world-countries') module.exports = { /** * Determines whether a given international dialing code is valid * * @param string code * @return bool */ isValid : function(code) { var codes = _.flatten(_.pluck(data, 'callingCode')); return _.contains(codes, code); } // ... } 

 /** * Gets a list of countries with the specified dialing code * * @param string code * @return array An array of two-character country codes */ getCountries : function(code) { var countryEntries = _.filter(data, function(country){ return (_.contains(country.callingCode, code)); }) return _.pluck(countryEntries, 'cca2'); } 

 /** * Gets the dialing codes for a given country * * @param string country The two-character country code * @return array An array of strings representing the dialing codes */ getCodes : function(country) { // Get the country entry var countryData = _.find(data, function(entry) { return (entry.cca2 == country); }); // Return the code(s) return countryData.callingCode; } 

 020 7925 0918 

 +44 20 7925 0918 

 0044 20 7925 0918 

 011 44 20 7925 0918 

 +12024561111 

 +442079250918 

 <input type="tel" name="number"> 

 <!-- area code and number --> <input type="tel" name="number"> <!-- country code, area code and number --> <input type="tel" name="country" size="4"> <input type="tel" name="area" size="6"> <input type="tel" name="number" size="8"> <!-- US-style --> (<input type="tel" size="3">) <input type="tel" size="3"> - <input type="tel" size="4"> 

 <input type="tel" name="number" pattern="^(?:\(\d{3}\)|\d{3})[- ]?\d{3}[- ]?\d{4}$"> 

 <input type="tel" id="number"> 

 $("#number").intlTelInput(); 

 npm install google-libphonenumber 

 bower install libphonenumber 

 var phoneUtil = require('google-libphonenumber').phoneUtil; 

 var tel = phoneUtil.parse('+12024561111'); 

 var phoneUtil = require('google-libphonenumber').phoneUtil , PNF = require('google-libphonenumber').PhoneNumberFormat , PNT = require('google-libphonenumber').PhoneNumberType; 

 var tel = phoneUtil.parse('+12024561111'); console.log(phoneUtil.format(tel, PNF.INTERNATIONAL)); console.log(phoneUtil.format(tel, PNF.NATIONAL)); console.log(phoneUtil.format(tel, PNF.E164)); 

 +1 202-456-1111 (202) 456-1111 +12024561111 

 var tel = phoneUtil.parse('2024561111'); 

 Error: Invalid country calling code 

 var tel = phoneUtil.parse('2024561111', 'US'); 

 var tel = phoneUtil.parse('202-456-1111', 'US'); var tel = phoneUtil.parse('(202) 456 1111', 'US'); 

 var tel = phoneUtil.parse('(0) 20 7925 0918', 'GB'); console.log(phoneUtil.format(tel, PNF.INTERNATIONAL)); console.log(phoneUtil.format(tel, PNF.NATIONAL)); console.log(phoneUtil.format(tel, PNF.E164)); 

 +44 20 7925 0918 020 7925 0918 +442079250918 

 console.log(phoneUtil.isValidNumber(phoneUtil.parse('+12024561111'))); // => outputs true console.log(phoneUtil.isValidNumber(phoneUtil.parse('202-456-1111', 'US'))); // => outputs true console.log(phoneUtil.isValidNumber(phoneUtil.parse('(0) 20 7925 0918', 'GB'))); // => outputs true 

 console.log(phoneUtil.isValidNumber(phoneUtil.parse('(0) 20 7925 0918'))); // => throws exception "Error: Invalid country calling code" console.log(phoneUtil.isValidNumber(phoneUtil.parse('2024561111'))); // => throws exception "Error: Invalid country calling code" 

 console.log(phoneUtil.isValidNumber(phoneUtil.parse('573 1234 1234', 'US'))); // => outputs false console.log(phoneUtil.isValidNumber(phoneUtil.parse('555-555-5555', 'US'))); // => outputs false (this is often used as a placeholder, but it's not a valid number) console.log(phoneUtil.isValidNumber(phoneUtil.parse('295-123-1234', 'US'))); // => outputs false (there is no 295 area code in the US) 

 console.log(phoneUtil.isValidNumber(phoneUtil.parse('NOT-A-NUMBER', 'US'))); // => throws exception "Error: The string supplied did not seem to be a phone number" 

 var tel = phoneUtil.parse('(0) 20 7925 0918', 'GB'); var type = phoneUtil.getNumberType(tel) 

 if (type === PNT.MOBILE) { console.log("It's a mobile number"); } else if (type === PNT.FIXED_LINE) { console.log("It's a fixed line"); } 

 if (type === PNT.MOBILE) { console.log("It's a mobile number"); } else if (type === PNT.FIXED_LINE) { console.log("It's a fixed line"); } else if (type === PNT.FIXED_LINE_OR_MOBILE) { console.log("Your guess is as good as mine"); } 

 // You'll need to install the Twilio library with "npm install twilio" var client = require('twilio')('YOUR-SID', 'YOUR-AUTH-TOKEN'); // Generate a random four-digit code var code = Math.floor(Math.random()*8999+1000); // Send the SMS client.sendMessage({ to: phoneUtil.format(tel, PNF.E164), // using libphonenumber to convert to E.164 from: 'YOUR-NUMBER', body: 'Your confirmation code is ' + code }, function(err, respons) { // ...do something }); 

 $("#number").intlTelInput( { utilsScript : '/bower_components/intl-tel-input/lib/libphonenumber/build/utils.js' } ); 

 <a href="tel:+12024561111">+1 202-456-1111</a> 

 <div itemscope itemtype="http://schema.org/LocalBusiness"> <h1 itemprop="name">Acme Corp, Inc.</h1> Phone: <span itemprop="telephone"><a href="tel:+12024561111">202-456-1111</a></span> </div>