@yimnai-dev/country-validator is a javascript library that helps in working with basic data about world countries such as names, country code, dial code and continent.

installation

npm install @yimnai-dev/country-validator --save OR pnpm install @yimnai-dev/country-validator OR yarn install@yimnai-dev/country-validator

GITHUB

• country-validator

API Reference

Get all countries

  getAllCountries(limit)

| Parameter | Type | Description | | :-------- | :------- | :------------------------- | | limit | number | Optional. The number of countries you want to get. The absence of a limit will return all countries |

Get sorted countries

  sortCountries({name, code, dial_code, continent}, limit)

The absence of any of the parameters listed above will simply return a sorted list of all countries. You can limit the number of countries with the limit parameter. You do not need to pass all of the object parameters as any of them can be used to query the countries

| Parameter | Type | Description | | :-------- | :------- | :-------------------------------- | | name | string | Optional | | code | string | Optional | | dial_code | string | Optional | | continent | string | Optional |

Get Countries of a continent

   getCountriesOfContinent(continent, limit)

Takes a continent and a limit and returns all countries that satisfy that condition. | Parameter | Type | Description | | :-------- | :------- | :-------------------------------- | | continent | string | Required | | limit | number | Required |

Get the continent of a particular country

   getContinentOfCountry({name, dial_code, code})

Passing either the name, dial_code or code of a country will return its continent if it exists. At least one of the parameters must be passed for it to work as intended | Parameter | Type | Description | | :-------- | :------- | :-------------------------------- | | name | string | Optional | | dial_code | string | Optional | | code | string | Optional |

Verify if particular country is in passed continent

   verifyIfCountryInContinent({name, dial_code, code}, continent)

Passing either the name, dial_code or code of a country and the continent against which you are testing it will return a boolean value indicating whether or not the country is in that particular continent. At least one of the parameters must be passed for it to work as intended | Parameter | Type | Description | | :-------- | :------- | :-------------------------------- | | name | string | Optional | | dial_code | string | Optional | | code | string | Optional | | continent | string | Required |

Get information about a particular country

   getCountryInfo({name, dial_code, code})

Passing either the name, dial_code or code of a country will return an object containing the basic information about that country | Parameter | Type | Description | | :-------- | :------- | :-------------------------------- | | name | string | Optional | | dial_code | string | Optional | | code | string | Optional |

Get the name of a country

   getCountryName({dial_code, code})

Passing either the dial_code or code of a country will return the name of the country if it exists. At least one parameter must be passed. | Parameter | Type | Description | | :-------- | :------- | :-------------------------------- | | dial_code | string | Optional | | code | string | Optional |

Get the country code of a country

   getCountryCode({dial_code, name})

Passing either the dial_code or name of a country will return the country Code of the country if it exists. At least one parameter must be passed. | Parameter | Type | Description | | :-------- | :------- | :-------------------------------- | | dial_code | string | Optional | | name | string | Optional |

Get the dial code of a country

   getCountryDialCode({name, code})

Passing either the name or code of a country will return the Dial Dial Code of the country if it exists. At least one parameter must be passed. | Parameter | Type | Description | | :-------- | :------- | :-------------------------------- | | name | string | Optional | | code | string | Optional |

Verify if a country exists

   verifyCountryExistence(country: string)

Passing the name of the country will return a boolean indicating whether or not the country exists or not. | Parameter | Type | Description | | :-------- | :------- | :-------------------------------- | | country | string | Required |

Get list of states in country

   getCountryStates(countryObj: NameOrCodeOrDialCode)

Passing any of these parameters will return an array of all the states in the country. Passing none of them will return undefined. | Parameter | Type | Description | | :-------- | :------- | :-------------------------------- | | name | string | Optional | | code | string | Optional | | dial_code | string | Optional |

Make sure to enter the full name of a country when checking with a name parameter. Also, empty objects will be returned if nothing could be found.

Appendix

This library was put together by Yimnai Nerus. If you want to contribute, you can always fork the project to do so. Constructive feedback and criticism is highly valued. Thank you for using our library.

Authors

• @yimnai-dev

🚀 About Me

Web developer and software engineer