node-world

Utility to work with countries data.

npm install node-world
4 downloads in the last week
11 downloads in the last month

node-world

NPM

Utility to work with countries data.

Features

  • European countries (for now)
  • 4 languages for countries localized name (french, english, dutch and german)

Future

  • Add web interface to manage countries data
  • Add more countries
  • Add more languages
  • Add more data about each countries

Feel free to contribute.

Installation

$ npm install node-world

Quick Start

Load in the module

var World = require('node-world');

Retrieve country object

You can find a country by code, ISO 3166-1-alpha-2 or ISO 3166-1-alpha-3, and by name.

var country = World.findCountryByCode('SP'); // ISO 3166-1-alpha-2
var country = World.findCountryByCode('ESP'); // ISO 3166-1-alpha-3

var country = World.findCountryByName('Spain'); // Country name

Country methods

  • getAlpha2Code() : Retrieve ISO 3166-1-alpha-2.
SP
  • getAlpha3Code() : Retrieve ISO 3166-1-alpha-3.
ESP
  • getCodes() : Retrieve a JSON object which contains the 2 alpha codes.
{
    "alpha_2_code": "ES",
    "alpha_3_code": "ESP"
}
  • getName() : Retrieve international country name.
Spain
  • getLocalizedNames() : Retrieve localized names.
{
    "fr": "Espagne",
    "en": "Spain",
    "de": "Spanien",
    "nl": "Spanje"
}
  • getLocalizedNameIn( language ) : Retrieve a localized name by language. If the localized name does not exist this method will return the international country name.
Spain

Tests

$ npm run-script be-data
npm loves you