world countries capitals
v3.4.0
Всемирно-составные капиталы -это библиотека JavaScript , которая предоставляет доступ к статическим данным всех стран мира.
В настоящее время доступные данные для каждой страны:
Вы можете проверить все изменения в проекте на странице Releseses на GitHub или в ChangeLog.
Не стесняйтесь давать этот проект ️, если он вам помог! ?
↑ Вернуться в меню
Вот демо/примеры, созданные сообществом ❤
↑ Вернуться в меню
Установите с помощью NPM:
npm install world-countries-capitals
Установить с пряжей:
yarn add world-countries-capitals
↑ Вернуться в меню
Зависит от того, как вы решите установить этот пакет, может быть другой способ его использовать.
// 1. Load _wcc_ Package
const wcc = require ( 'world-countries-capitals' )
// 2. Use any _wcc_ Method
const randomCountryName = wcc . getRandomCountry ( )
// 3. Play with returned data
console . log ( randomCountryName ) // Possible output: 'poland'↑ Вернуться в меню
Тип определения каждой Country {Object} :
/**
* @typedef {Object} Country
* @property {String} country - Country name
* @property {String} capital - Capital city name
* @property {String} currency - Currency name
* @property {String[]} native_language - Array or native languages
* @property {String} famous_for - Comma separated favourites
* @property {String} phone_code - Phone prefix
* @property {String} flag - Flag image
* @property {String} drive_direction - Drive direction
* @property {String} alcohol_prohibition - Alcohol prohibition status
* @property {Object} area - Country size
* @property {Number} area.km2 - Country size in square kilometers
* @property {Number} area.mi2 - Country size in square miles
* @property {String} continent - Continent that country belong to
* @property {Object} iso - ISO 3166-1 standard codes
* @property {String} iso.numeric - 3-digit code
* @property {String} iso.alpha_2 - 2-letter code
* @property {String} iso.alpha_3 - 3-letter code
* @property {String} tld - Country code top-level domain
* @property {String} constitutional_form - Name of official political system
* @property {String[]} language_codes - Array of language codes
* @property {Boolean} is_landlocked - Is country surrounded by one or more countries
* @property {String[]} neighbors - Array of neighbor countries
*/ Образец Country {Object} :
{
country : 'poland' ,
capital : 'warsaw' ,
currency : 'zloty' ,
native_language : [ 'polish' ] ,
famous_for : 'pierogi and potatoes' ,
phone_code : '+48' ,
flag : 'https://flagpedia.net/data/flags/h80/pl.png' ,
drive_direction : 'right' ,
alcohol_prohibition : 'none' ,
area : {
km2 : 312696 ,
mi2 : 120733 ,
} ,
continent : 'eu' ,
iso : {
numeric : '616' ,
alpha_2 : 'pl' ,
alpha_3 : 'pol' ,
} ,
tld : '.pl' ,
constitutional_form : 'republic' ,
language_codes : [ 'pl-PL' ] ,
is_landlocked : false ,
neighbors : [ 'by' , 'cz' , 'de' , 'lt' , 'ru' , 'sk' , 'ua' ] ,
}↑ Вернуться в меню
После импорта пакета мировых соревнований-капиталов у вас есть доступ к методам, перечисленным ниже:
/*
* Get list of all country names
* @returns {String[]}
*/
wcc . getAllCountries ( ) /*
* Get all countries with details
* @returns {Country[]}
*/
wcc . getAllCountryDetails ( ) /*
* Get random country name
* @returns {String}
*/
wcc . getRandomCountry ( ) /*
* Get specific amount of random countries
* @param {Number} amount - amount of countries to get
* @returns {Country[]}
*/
wcc . getNRandomCountriesData ( amount )
// Example: wcc.getNRandomCountriesData(3) /*
* Get country details by its name
* @param {String} name - country name
* @returns {Country}
*/
wcc . getCountryDetailsByName ( name )
// Example: wcc.getCountryDetailsByName('poland') /*
* Get country details by its capital city
* @param {String} capital - name of capital city
* @returns {Country}
*/
wcc . getCountryDetailsByCapital ( capital )
// Example: wcc.getCountryDetailsByCapital('warsaw') /*
* Get all countries by specific language
* @param {String} language - language name
* @returns {Country[]}
*/
wcc . getCountriesByLanguage ( language )
// Example: wcc.getCountriesByLanguage('polish') /*
* Get all countries that are famous for specific thing
* @param {String} famousThing - thing that makes country famous for
* @returns {Country[]}
*/
wcc . getCountriesByFamousFor ( famousThing )
// Example: wcc.getCountriesByFamousFor('pierogi') /*
* Get all countries by specific drive direction
* @param {String} direction - drive direction (one of: 'left', 'right')
* @returns {Country[]}
*/
wcc . getCountriesByDriveDirection ( direction )
// Example: wcc.getCountriesByDriveDirection('left') /*
* Get all countries by alcohol prohibition type
* @param {String} type - prohibition type (one of: 'none', 'limited', 'regional', 'nationwide')
* @returns {Country[]}
*/
wcc . getCountriesByAlcoholProhibition ( type )
// Example: wcc.getCountriesByAlcoholProhibition('nationwide') /*
* Get all countries that are located on specific continent
* @param {String} code - 2-letter continent code (one of: 'AF', 'AN', 'AS', 'EU', 'NA', 'OC', 'SA')
* @returns {Country[]}
*/
wcc . getCountriesByContinent ( code )
// Example: wcc.getCountriesByContinent('eu') /*
* Get country found by one of _ISO 3166-1_ code type
* @param {String} isoType - ISO type (one of: 'numeric', 'alpha-2', 'alpha-3')
* @param {String} isoValue - ISO code of specific country that match to `isoType`
* @returns {Country}
*/
wcc . getCountryDetailsByISO ( isoType , isoValue )
// Example: wcc.getCountryDetailsByISO('numeric', '616') /*
* Get all countries by specific _ccTLD_
* @param {String} tld - name of the _country code top-level domain_ (including `.` character)
* @returns {Country[]}
*/
wcc . getCountriesByTLD ( tld )
// Example: wcc.getCountriesByTLD('.pl') /*
* Get all countries by specific constitutional form
* @param {String} form - name of country constitutional form
* @returns {Country[]}
*/
wcc . getCountriesByConstitutionalForm ( form )
// Example: wcc.getCountriesByConstitutionalForm('republic') /*
* Get all countries that are surrounded by one or more countries
* @param {Boolean} isLandLocked - is country landlocked
* @returns {Country[]}
*/
wcc . getCountriesByLandLock ( isLandLocked )
// Example: wcc.getCountriesByLandLock(true) /**
* Get list of neighbor countries
* @param {String} country - name (or one of ISO 3166-1 code) of country
* @returns {Country[]}
*/
wcc . getCountryNeighbors ( country )
// Example: wcc.getCountryNeighbors('poland')❗ Все параметры не чувствительны к случаю, поэтому, независимо от того, насколько аргумент выглядит, ответ останется прежним.
↑ Вернуться в меню
Взносы, проблемы и запросы на функции всегда приветствуются!
Не стесняйтесь проверять нашу страницу проблем, чтобы увидеть все открытые проблемы. Если это ваш первый раз, способствуя проекту с открытым исходным кодом , сначала ознакомьтесь с рекомендациями.
Вы также можете предложить новую функцию, создав проблему. Пожалуйста, дождитесь подтверждения, прежде чем работать над этим.
↑ Вернуться в меню
Если вы хотите увидеть всех, кто внес свой вклад в этот проект, просмотрите страницу взносов!
Спасибо всем, кто вносит свой вклад! ?
↑ Вернуться в меню
Copyright © 2020 Vikrant Bhat.
Этот проект лицензирован MIT.
↑ Вернуться в меню
