country-phonenumber
TypeScript icon, indicating that this package has built-in type declarations

0.2.1 • Public • Published

codecov

Country phone number parser

this library uses awesome-phonenumber and allows to get the country name after parsing the phone number.

Basic usage

import { phoneNumberParser } from 'country-phonenumber'

const pn = phoneNumberParser( '+237694124344' );
pn.isValid( );  // -> true
pn.isMobile( ); // -> true
pn.canBeInternationallyDialled( ); // -> true
pn.getNumber( );                   // -> '+237699999999'
pn.getNumber( 'e164' );            // -> '+237699999999' (default)
pn.getNumber( 'international' );   // -> '+237 6 99 99 99 99'
pn.getNumber( 'national' );        // -> '6 99 99 99 99'
pn.getNumber( 'rfc3966' );         // -> 'tel:+237-6-99-99-99-99'
pn.getNumber( 'significant' );     // -> '699999999'
pn.getRegionCode( );               // -> 'CM'
pn.getCountryCode( );              // -> 237
pn.getRegionName( );               // -> Cameroon

pn.toJSON( );                  // -> json blob, so that:
JSON.stringify( pn, null, 4 ); // -> This:
// {
//     "canBeInternationallyDialled": true,
//     "number": {
//         "input": "0707123456",
//         "international": "+46 70 712 34 56",
//         "national": "070-712 34 56",
//         "e164": "+46707123456",
//         "rfc3966": "tel:+46-70-712-34-56",
//         "significant": "707123456"
//     },
//     "regionCode": "SE",
//     "valid": true,
//     "possible": true,
//     "type": "mobile",
//     "possibility": "is-possible"
// }

The method getRegionName returns the country name.

Get object country name and phone prefix by country code

import { getCountryByCode } from "country-phonenumber";

console.log(getCountryByCode('FR')); 

// { name: "France", phone: 33 }

Get object country name and code by phone prefix

import { getCountryByPhone } from "country-phonenumber";

console.log(getCountryByPhone(237)); 

// { name: "Cameroon", code: "CM" }

Package Sidebar

Install

npm i country-phonenumber

Weekly Downloads

4

Version

0.2.1

License

MIT

Unpacked Size

27.3 kB

Total Files

8

Last publish

Collaborators

  • skineur