bc-countries

A convenient Javascript countries utilities (e.g: dial codes, country codes, names)

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
bc-countries
2.0.07 years ago7 years agoMinified + gzip package size for bc-countries in KB

Readme

bc-countries Build Status
A convenient Javascript countries utilities (e.g: dial codes, country codes, names)

Installation

Bower

bower install --save bc-countries

var bcCountries = window.bcCountries;

NPM

npm install --save bc-countries

var bcCountries = require('bc-countries');

Other (not recommended)

Just copy the dist

Usage

Main functions

A country is an object with keys (dialCode, iso2Code, name). Functions that take digits, throw unless digits is a string of digits.
  1. getCountryByIso2Code(iso2Code): returns the country with iso2 code code if exists, null otherwise.
  2. getIso2CodeByDigits(digits): returns the iso2 code, given that digits starts with that country dial code, an empty string otherwise.
  3. getDialCodeByDigits(digits): returns the dial code, given that digits starts with that country dial code, an empty string otherwise.
  4. getAllCountries(): returns all countries.

You can find the full documentation here.