npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@sozialhelden/ietf-language-tags

v5.4.2

Published

Helps you working with IETF language tags as specified by BCP 47 / RFC 5646.

Downloads

11,790

Readme

ietf-language-tags 🇺🇳

Tools for working with IETF language tags as specified by BCP 47 / RFC 5646.

  • Aims to implement the full RFC spec
  • Validates given tag strings like zh-Hant-CN
  • Interprets complicated (but valid) tags like zh-yue-Latn-CN-pinyin-a-extend1-x-foobar-private1
  • Helps you with getting rid of redundant or deprecated tags
  • Optionally checks given tags against a local copy of the central IETF language tag registry so don't let unregistered subtags slip through

Terminology

The terminology of this library follows RFC5646. To quote the specification:

  • Tag refers to a complete language tag, such as sr-Latn-RS or az-Arab-IR.
  • Subtag refers to a specific section of a tag, delimited by a hyphen, such as the subtags zh, Hant, and CN in the tag zh-Hant-CN.
  • Code refers to values defined in external standards (and that are used as subtags in this document). For example, Hant is an ISO15924 script code that was used to define the Hant script subtag for use in a language tag.

How is this related to Unicode CLDR language tags and POSIX locales?

  • Unicode CLDR uses IETF language tags as basis standard and adds its own extensions - it allows using underscores in the tags, and specifies how to add information about cultural attributes like currencies, measurement units or collations. Most OSes, programming languages and browsers support the CLDR specifications. What's still missing in many CLDR libraries is correct support for matching user-preferred and app-supported language tags - while the Unicode CLDR specification lists 2 algorithms for matching that are more sophisticated than the proposed matching algorithm in IETF's RFC 4647, many libraries only implement the simplest one. Rafael Xavier de Souza from the CLDR.js project has an explanation of the issue.
  • POSIX locales are used in Unix-based systems to determine how apps should handle character sets and string formatting. Even after replacing their underscore separators with hyphen characters, they would not be valid as IETF language tags, and you shouldn't use them with this library without a proper conversion. For example, C is a valid POSIX locale, but not a valid IETF language tag.

Installation

npm install --save @sozialhelden/ietf-language-tags
#or
yarn add @sozialhelden/ietf-language-tags

Usage examples

  • Parse a given IETF language tag to get access to its parts:

    import { parseLanguageTag } from '@sozialhelden/ietf-language-tags';
    const tag = parseLanguageTag(
      'sl-rozaj-biske',
      // Set to `true` for returning `undefined` for invalid tags,
      // outputting errors to the console.
      // Set to `false` to throw an error if a given tag is invalid.
      // The library tries to give helpful feedback for typical errors in tags.
      true,
      // Allows you to use your own logging function. Supply `null` to suppress console output.
      console.log
    );

    This returns the language tag for Slovenian in its Resian / San Giorgio dialect of Resian variant:

    {
      "langtag": "sl-rozaj-biske",
      "language": "sl",
      "variants": ["rozaj", "biske"]
    }
  • Get all information about a given language tag, including descriptions and registry meta infos:

    const tagMetaInfo = getTag('zh-yue-Latn-CN-pinyin-a-extend1-x-foobar-private1');
      {
        extlang: {
          Added: '2009-07-29',
          Description: ['Yue Chinese', 'Cantonese'],
          Macrolanguage: 'zh',
          'Preferred-Value': 'yue',
          Prefix: ['zh'],
          Subtag: 'yue',
          Type: 'extlang',
        },
        parts: {
          extensions: {
            a: 'extend1',
          },
          extlang: 'yue',
          langtag: 'zh-yue-Latn-CN-pinyin-a-extend1-x-foobar-private1',
          language: 'zh-yue',
          privateuse: 'x-foobar-private1',
          region: 'CN',
          script: 'Latn',
          variants: ['pinyin'],
        },
        privateuse: 'x-foobar-private1',
        region: {
          Added: '2005-10-16',
          Description: ['China'],
          Subtag: 'CN',
          Type: 'region',
        },
        script: {
          Added: '2005-10-16',
          Description: ['Latin'],
          Subtag: 'Latn',
          Type: 'script',
        },
        variants: [
          {
            Added: '2008-10-14',
            Description: ['Pinyin romanization'],
            Prefix: ['zh-Latn', 'bo-Latn'],
            Subtag: 'pinyin',
            Type: 'variant',
          },
        ],
      }
  • Return a plain English description of a given tag

    describeIETFLanguageTag('zh-Hans'); // → 'Chinese, written in Han (Simplified variant) script'
    describeIETFLanguageTag('yue-HK'); // → 'Yue Chinese / Cantonese, as used in Hong Kong'
    describeIETFLanguageTag('es-419'); // → 'Spanish / Castilian, as used in Latin America and the Caribbean'
  • Beautify tags to make them more readable

    normalizeLanguageTagCasing('sGn-Be-fR'); // → 'sgn-BE-FR'
  • Get a language tag the IETF language tag registry prefers over the given tag

    getPreferredLanguageTag('zh-yue'); // → 'yue'
    getPreferredLanguageTag('i-klingon'); // → 'tlh'
  • Get a specific, single subtag from the IETF language tag registry:

    getSubTag('extlang', 'hsn');
    {
      Type: 'language',
      Subtag: 'hsn',
      Description: ['Xiang Chinese'],
      Added: '2009-07-29',
      Macrolanguage: 'zh'
    }
  • Match against a RegExp mimicking the RFC specs, without further semantic checks:

    const regexp = createRFC5646Regexp();
    const match = 'zh-yue-Latn-CN-pinyin-a-extend1-x-foobar-private1'.match(regexp);
    {
      region: "CN",
      script: "Latn",
      extlang: "yue",
      language: "zh-yue",
      variants: "-pinyin" // can contain one or more variants in one string
      extensions: "-a-extend1", // can contain one or more extensions in one string
      privateuse: "x-foobar-private1",
      privateuse2: undefined, // For tags that consist of nothing more than a private-use subtag
      langtag: "zh-yue-Latn-CN-pinyin-a-extend1-x-foobar-private1",
    }

Credits / License

Contributors to this package:

Thanks to Matthew Caruana Galizia for maintaining the language-subtag-registry NPM package, which this package is based on.

Update scripts copyright (c) 2013, Matthew Caruana Galizia and licensed under and MIT license.

The JSON database is licensed under the Open Data Commons Attribution License (ODC-BY).

Supported by

.