💪 Try as hard as possible to detect the client's language tag ('locale') in node or the browser. Browserify and Webpack friendly!


Keywords
locale, country, code, language, l10n, i18n, browser, lcid, lang, local, enus, en-US, en-GB, engb, en, eng, 5646, rfc, region, rfc5646, bcp47, bcp, bcp-47, dev-deps, internationalization, iso-3166-1, localization, rfc-5646, unicode
License
MIT
Install
npm install locale2@2.3.1

Documentation

locale2 Build Status

Version Downloads Deps DevDeps

Try as hard as possible to detect the client's language tag ("locale") in node or the browser. Browserify and Webpack friendly!

About Language Tags, Locale, RFC-5646 and BCP-47

In 2009, IETF published RFC-5646, "Tags for Identifying Languages," in which "...describes the structure, content, construction, and semantics of language tags for use in cases where it is desirable to indicate the language used in an information object."

A language tag is composed from a sequence of one or more "subtags", each of which refines or narrows the range of language identified by the overall tag. Subtags, in turn, are a sequence of alphanumeric characters (letters and digits), distinguished and separated from other subtags in a tag by a hyphen ("-", [Unicode] U+002D).

References:

  1. RFC-5646
  2. BCP-47

Unit tested and browser tested with BrowserStack

BrowserStack

Tested successfully on:

✓ IE 8 ✓ IE 9 ✓ IE 10 ✓ IE 11 ✓ IE 12 (Edge)

✓ Safari 5.1+

✓ Opera (Presto, Webkit, Blink)

✓ Firefox

✓ Chrome

Node support

$ babel-node
> import locale2 from 'locale2'
> locale2
en-US
>

...and pairs well with iso3166-1!

var iso3166 = require('iso3166-1')
var locale2 = require('locale2')
> iso3166.from(locale2).to3()
USA
>

Install

npm install --no-optional
npm test

Development

Browser testing (currently private)

npm run test:bs
npm run test:bs:local

Try it now

view on requirebin

License

License