JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 172613
  • Score
    100M100P100Q191840F
  • License MIT

Normalize, canonicalize, and format BCP 47 tags

Package Exports

  • bcp-47-normalize

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (bcp-47-normalize) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

bcp-47-normalize

Build Coverage Downloads Size

Normalize, canonicalize, and format BCP 47 tags.

Install

npm:

npm install bcp-47-normalize

Use

var normalize = require('bcp-47-normalize')

var tags = [
  'de-de-1901',
  'en-gb',
  'en-us',
  'en-bu',
  'hy-arevmda',
  'nld-nl',
  'no-nyn',
  'pt-br',
  'pt-pt',
  'zh-hans-cn'
]

tags.forEach(function(tag) {
  console.log('%s -> %s', tag, normalize(tag))
})

Yields:

de-de-1901 -> de-1901
en-gb -> en-GB
en-us -> en
en-bu -> en-MM
hy-arevmda -> hyw
nld-nl -> nl
no-nyn -> nn
pt-br -> pt
pt-pt -> pt-PT
zh-hans-cn -> zh-CN

API

normalize(tag[, options])

Normalize the given BCP 47 tag according to Unicode CLDR suggestions.

options.forgiving

Passed to bcp-47 as options.forgiving.

options.warning

Passed to bcp-47 as options.warning.

One additional warning is given:

code reason
7 Deprecated region CURRENT, expected one of SUGGESTIONS

This warning is only given if the region cannot be automatically fixed (when regions split into multiple regions).

Returns

string — Normal, canonical, and pretty BCP 47 tag.

License

MIT © Titus Wormer