iso-3166-country-list

2-letter country codes to English and vice-versa

Usage no npm install needed!

<script type="module">
  import iso3166CountryList from 'https://cdn.skypack.dev/iso-3166-country-list';
</script>

README

ISO 3166 country list

This package will still be maintained, but no new features will be added and data may be out of date. I recommend i18n-iso-countries instead.

Maps ISO 3166 codes to English country names and vice versa. I built this because I couldn't find something that did exactly what I wanted and worked in the browser.

In the browser:

<script src="country-list.js"></script>
<script>
  countryList.name("DE"); // 'Germany'
</script>

In Node/Browserify/Webpack, run npm install iso-3166-country-list:

var countryList = require("iso-3166-country-list");
countryList.code("Germany"); // 'DE'

Here are some usage examples:

countryList.name("DE"); // 'Germany'
countryList.code("Germany"); // 'DE'

countryList.name("de"); // 'Germany'
countryList.code("germany"); // 'DE'

countryList.codes; // ['AF', 'AX', 'AL', ...]
countryList.names; // ['Afghanistan', 'Åland Islands', 'Albania', ...]
countryList;
/*
  [
    { code: 'AF', name: 'Afghanistan' },
    { code: 'AX', name: 'Åland Islands' },
    { code: 'AL', name: 'Albania' },
    ...
  ]
*/

countryList.name("something-unknown"); // undefined
countryList.code("something-unknown"); // undefined