Info on ISO 639-3
npm install iso-639-3[![Build][build-badge]][build]
[![Coverage][coverage-badge]][coverage]
[![Downloads][downloads-badge]][downloads]
[![Size][size-badge]][size]
Info on ISO 639-3.
* What is this?
* When should I use this?
* Install
* Use
* API
* iso6393
* iso6393To1
* iso6393To2B
* iso6393To2T
* Types
* Compatibility
* Security
* Related
* Contribute
* License
This package contains info on [ISO 639-3][iso].
ISO 639-3 is a set of codes that defines three letter identifiers for all known
human languages, whether living, extinct, ancient, historic, or constructed.
You can use this package any time you have to deal with languages or ISO 639-3
in particular.
This package is [ESM only][esm].
In Node.js (version 12.20+, 14.14+, or 16.0+), install with [npm][]:
``sh`
npm install iso-639-3
In Deno with [Skypack][]:
`js`
import {iso6393} from 'https://cdn.skypack.dev/iso-639-3@3?dts'
In browsers with [Skypack][]:
`html`
`js
import {iso6393} from 'iso-639-3'
console.log(iso6393.slice(1820, 1830))
`
Yields:
`js`
[
{name: 'En', type: 'living', scope: 'individual', iso6393: 'enc'},
{name: 'Ende', type: 'living', scope: 'individual', iso6393: 'end'},
{name: 'Forest Enets', type: 'living', scope: 'individual', iso6393: 'enf'},
{
name: 'English',
type: 'living',
scope: 'individual',
iso6393: 'eng',
iso6392B: 'eng',
iso6392T: 'eng',
iso6391: 'en'
},
{name: 'Tundra Enets', type: 'living', scope: 'individual', iso6393: 'enh'},
{name: 'Enlhet', type: 'living', scope: 'individual', iso6393: 'enl'},
{
name: 'Middle English (1100-1500)',
type: 'historical',
scope: 'individual',
iso6393: 'enm',
iso6392B: 'enm',
iso6392T: 'enm'
},
{name: 'Engenni', type: 'living', scope: 'individual', iso6393: 'enn'},
{name: 'Enggano', type: 'living', scope: 'individual', iso6393: 'eno'},
{name: 'Enga', type: 'living', scope: 'individual', iso6393: 'enq'}
]
This package exports the following identifiers: iso6393, iso6393To1,iso6393To2B, and iso6393To2T.
There is no default export.
List of [Language][language]s (Array).
#### Language
Object representing a language:
* name (string)'English'
— name (example: )type
* (string)Type
— [][type] (example: 'living')scope
* (string)Scope
— [][scope] (example: 'individual')iso6393
* (string)'eng'
— ISO 639-3 code (example: )iso6392B
* (string?)'eng'
— ISO 639-2 (bibliographic) code (example: )iso6392T
* (string?)'eng'
— ISO 639-2 (terminologic) code (example: )iso6391
* (string?) — ISO 639-1 code'en'
— ISO 639-1 code (example: )
#### Type
Category of a language:
* 'living'nhi
— currently spoken language
(example: for Zacatlán-Ahuacatlán-Tepetzintla Nahuatl)'historical'
* ofs
— extinct language distinct from modern languages that descended from it
(example: for Old Frisian)'extinct'
* rbp
— language that went extinct recently
(example: for Barababaraba)'ancient'
* got
— language that went extinct long ago
(example: for Gothic)'constructed'
* epo
— artificial languages, excluding programming languages
(example: for Esperanto)'special'
* und
— non-language codes
(example: for Undetermined)
#### Scope
Scope of a language:
* 'individual'eng
— normal, single language
(example: for English)'macrolanguage'
* ara
— one-to-many grouping of languages, because older ISO 639s included them
(example: for Arabic)'special'
* und
— non-language codes
(example: for Undetermined)
Map of ISO 639-3 codes to ISO 639-1 codes (Record).
Map of ISO 639-3 codes to bibliographic ISO 639-2 codes
(Record).
Map of ISO 639-3 codes to terminologic ISO 639-2 codes
(Record).
This package is fully typed with [TypeScript][].
This package is at least compatible with all maintained versions of Node.js.
As of now, that is Node.js 12.20+, 14.14+, and 16.0+.
It also works in Deno and modern browsers.
This package is safe.
* bcp-47
— Parse and serialize BCP 47 language tags
* bcp-47-match
— Match BCP 47 language tags with language ranges per RFC 4647
* bcp-47-normalize
— Normalize, canonicalize, and format BCP 47 tags
* iso-3166
— ISO 3166 codes
* iso-639-2
— ISO 639-2 codes
* iso-15924
— ISO 15924 codes
* un-m49`
— UN M49 codes
Yes please!
See [How to Contribute to Open Source][contribute].
[MIT][license] © [Titus Wormer][author]
[build-badge]: https://github.com/wooorm/iso-639-3/workflows/main/badge.svg
[build]: https://github.com/wooorm/iso-639-3/actions
[coverage-badge]: https://img.shields.io/codecov/c/github/wooorm/iso-639-3.svg
[coverage]: https://codecov.io/github/wooorm/iso-639-3
[downloads-badge]: https://img.shields.io/npm/dm/iso-639-3.svg
[downloads]: https://www.npmjs.com/package/iso-639-3
[size-badge]: https://img.shields.io/bundlephobia/minzip/iso-639-3.svg
[size]: https://bundlephobia.com/result?p=iso-639-3
[npm]: https://docs.npmjs.com/cli/install
[skypack]: https://www.skypack.dev
[license]: license
[author]: https://wooorm.com
[esm]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
[typescript]: https://www.typescriptlang.org
[contribute]: https://opensource.guide/how-to-contribute/
[iso]: https://iso639-3.sil.org
[language]: #language
[type]: #type
[scope]: #scope