world countries capitals
v3.4.0
世界 - 符合人物是JavaScript库，可访问世界上所有国家的静态数据。
当前每个国家的可用数据是：
您可以在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')❗️所有参数都不是案例敏感的，因此无论参数外观如何，响应都将保持不变。
↑返回菜单
始终欢迎贡献，问题和功能请求！
随时查看我们的问题页面以查看所有开放问题。如果这是您第一次为开源项目做出贡献，请先查看贡献指南。
您还可以通过创建问题提出一个新功能。请在处理之前等待确认。
↑返回菜单
如果您想看到为该项目做出贡献的每个人，请查看贡献页面！
感谢所有贡献的人！ ？
↑返回菜单
版权所有©2020 Vikrant Bhat。
该项目已获得MIT许可。
↑返回菜单
