包详细信息

iso-639-1

meikidd1.6mMIT3.1.5

ISO-639-1 codes

iso, iso-639, iso-639-1, language

自述文件

ISO-639-1

NPM Version Build Status Download Count

Simple interface for ISO-639-1 language codes

Installation

npm install iso-639-1

Usage

Node.js

const ISO6391 = require('iso-639-1');
console.log(ISO6391.getName('en')); // 'English'

ES Module

import ISO6391 from 'iso-639-1';
console.log(ISO6391.getName('en')); // 'English'

Browsers

HTML

<script type="text/javascript" src="./node_modules/iso-639-1/build/index.js"></script>

Visit global variable ISO6391 in js

console.log(ISO6391.getName('en')); // 'English'

Methods

getName(code)

  • @param code {string}
  • @return {string}

Lookup language english name by code

getAllNames()

  • @return {array}

Get array of all language english names

getNativeName(code)

  • @param code {string}
  • @return {string}

Lookup language native name by code

getAllNativeNames()

  • @return {array}

Get array of all language native names

getCode(name)

  • @param name {string}
  • @return {string}

Lookup code by english name or native name

getAllCodes()

  • @return {array}

Get array of all codes

validate(code)

  • @param code {string}
  • @return {boolean}

Check whether the given code is in the list of ISO-639-1

getLanguages(codes)

  • @param codes {array}
  • @return {array}

Get the array of the language objects by the given codes

Example

const ISO6391 = require('iso-639-1')

console.log(ISO6391.getName('zh')) // 'Chinese'
console.log(ISO6391.getNativeName('zh')) // '中文'

console.log(ISO6391.getAllNames()) // ['Afar','Abkhaz', ... ,'Zulu']
console.log(ISO6391.getAllNativeNames()) //['Afaraf','аҧсуа бызшәа', ... ,'isiZulu' ]

console.log(ISO6391.getCode('Chinese')) // 'zh'
console.log(ISO6391.getCode('中文')) // 'zh'

console.log(ISO6391.getAllCodes()) //['aa','ab',...,'zu']

console.log(ISO6391.validate('en')) // true
console.log(ISO6391.validate('xx')) // false

console.log(ISO6391.getLanguages(['en', 'zh']))
// [{code:'en',name:'English',nativeName:'English'},{code:'zh',name:'Chinese',nativeName:'中文'}]

更新日志

iso-639-1 Changelog

v3.1.5

  • ISO6391.validate() type predicate #87

v3.1.4

  • Fix native language name for Czech and Slovak #86

v3.1.3

  • Remove unnecessary diacritics #84

v3.1.2

  • Capitalize Faroese native #82

v3.1.1

  • Capitalize Danish native #80

v3.1.0

  • Fix type for getCode #74
  • Improve performance #72

v3.0.1

  • Fix error TS7016 #68

v3.0.0

  • Export ESM module #67

v2.1.15

  • Change parameters type "LanguageCode" to "string"

v2.1.14

  • Bump async from 2.6.0 to 2.6.4 #53
  • Add a type to list the langage codes in the TS definition file #55

v2.1.13

  • update Arabic native name #50

v2.1.12

  • remove 'bh' #51
  • fj native name changed to "vosa Vakaviti" #51
  • dv native name changed to "ދިވެހި" #51
  • lo native name changed to "ພາສາລາວ" #51
  • ms native name changed to "Bahasa Melayu" #51
  • lu native name changed to "Kiluba" #51
  • na native name changed to "Dorerin Naoero" #51
  • tk native name changed to "Türkmençe" #51

v2.1.11

  • Slovenian native name "slovenski jezik" -> "slovenščina" #49

v2.1.10

  • Polish native name "język polski" -> "Polski" #48

v2.1.9

  • Change hu native name "Magyar" -> "magyar" #40

v2.1.8

  • Change hr native name "hrvatski jezik" -> "Hrvatski"
  • Change sl English name "Slovene" -> "Slovenian"

v2.1.0

  • Correctly handle prototype property names passed as codes #20