devsite/node_modules/bcp-47-normalize
2024-07-07 18:49:38 -07:00
..
lib more 2024-07-07 18:49:38 -07:00
index.js more 2024-07-07 18:49:38 -07:00
license more 2024-07-07 18:49:38 -07:00
package.json more 2024-07-07 18:49:38 -07:00
readme.md more 2024-07-07 18:49:38 -07:00

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