country.

country. provides all kinds of data on countries. It offers the following information:

• ISO-3611-1/2/3 code
• International Olympic Committee Code (IOC)
• Spoken languages
• Used currencies
• Calling codes
• Country Flag as an Emoji
• Names in the following languages:

Code | Language ------------- | ------------- ar | Arabic cs | Czech de | German en | English et | Estonian fi | Finnish fr | French it | Italian nb | Norwegian Bokmål nn | Norwegian Nynorsk nl | Dutch pl | Polish pt | Portuguese ru | Russian sv | Swedish tr | Turkish zh | Chinese

This library also classifies countries into regions. The following regions are supported:

• Asia (Central + Southern + Southeast + East + Western)

• Central Asia

• Southern Asia

• Southeast Asia

• East Asia

• Western Asia

• Africa (Central + North + Southern + East + West)

• Central Africa

• North Africa

• Southern Africa

• East Africa

• West Africa

• Europe (Northern + Southern + Eastern + Western)

• Northern Europe

• Southern Europe

• Eastern Europe

• Western Europe

• America (Central + Northern + Southern)

• Central America

• Northern America

• South America

• Other

• Australia

• Melanesia

• Micronesia

• Polynesia

• Antartica

• Caribbean

Usage

Require country. in your project.

'use strict';
const country = require('countryinfo');

ISO 3166-1 codes

// ISO 3166-1 numeric identifiers from ...
country.iso1('DE');                 // ... ISO 3166-1 alpha-2
country.iso1('DEU');                // ... ISO 3166-1 alpha-3
country.iso1('Germany');            // ... country name
country.iso1('Deutschland', 'de');  // ... localized country name

// ISO 3166-1 alpha-2 identifiers from ...
country.iso2('276');                // ... ISO 3166-1 numeric
country.iso2('DEU');                // ... ISO 3166-1 alpha-3
country.iso2('Germany');            // ... country name
country.iso2('Deutschland', 'de');  // ... localized country name

// ISO 3166-1 alpha-3 identifiers from ...
country.iso3('276');                // ... ISO 3166-1 numeric
country.iso3('DE');                 // ... ISO 3166-1 alpha-2
country.iso3('Germany');            // ... country name
country.iso3('Deutschland', 'de');  // ... localized country name

IOC

// IOC identifiers from ...
country.ioc('276');                // ... ISO 3166-1 numeric
country.ioc('DE');                 // ... ISO 3166-1 alpha-2
country.ioc('DEU');                // ... ISO 3166-1 alpha-3
country.ioc('Germany');            // ... country name
country.ioc('Deutschland', 'de');  // ... localized country name

Languages

// Spoken languages from ...
country.languages('276');                // ... ISO 3166-1 numberic
country.languages('DE');                 // ... ISO 3166-1 alpha-2
country.languages('DEU');                // ... ISO 3166-1 alpha-3
country.languages('Germany');            // ... country name
country.languages('Deutschland', 'de');  // ... localized country name

Currencies

// Used currencies in country from ...
country.currencies('276');                // ... ISO 3166-1 numberic
country.currencies('DE');                 // ... ISO 3166-1 alpha-2
country.currencies('DEU');                // ... ISO 3166-1 alpha-3
country.currencies('Germany');            // ... country name
country.currencies('Deutschland', 'de');  // ... localized country name

Country data

// Complete data of country from ...
country.data('276');                // ... ISO 3166-1 numberic
country.data('DE');                 // ... ISO 3166-1 alpha-2
country.data('DEU');                // ... ISO 3166-1 alpha-3
country.data('Germany');            // ... country name
country.data('Deutschland', 'de');  // ... localized country name

Regions

// Region data
country.regions();                   // all regions
country.regionsData();               // all regions including data for all countries (ISO 3166-1 codes, IOC,...)
country.regions('europe');           // find region by identifier ...
country.regions('Central Asia');     // ... or by name
country.regionsData('europe');       // complete region data by identifier...
country.regionsData('Central Asia'); // ... or by name

Contribution & Data Sources

If you want to add additional country names to the list, feel free to do so in the /lib/data/names.json file. The structure should be clear.

{
	"DE": {                        // ISO 3166-1 alpha-2 identifier
		"en": ["Germany"],        // array of to be added names in the set locale
		"ar": [" ألمانيا"]
	}
}

To import the data into the library, run make in the root directory. This recreates the /lib/data/masterData.json file.

Data sources

• JSON dump of countrySynonyms
• i18n-iso-countries
• Currency Code Services – ISO 4217 Maintenance Agency
• country-data
• Locale::Codes (datasources also aknowledged there)

I don't need a JS library, I just need the data.

Run make in the root directory of the project and copy the /lib/data/masterData.json file. This file contains all the mentioned data.

Build / Test / Update

In package json:

• npm test - run tests
• npm run cleaner - update master data