@intilfy/utils

Collection of i18n utilities

🌟 Features

✅️ Modern: ES Modules first and respect Web Standard and ECMAScript Internationalization APIs

✅️ Compatible: support CommonJS and various JS environments

✅️️ Minimal: Small and fully tree-shakable

✅️️ Type Strong: Written in TypeScript, with full JSdoc

💿 Installation

🐢 Node.js

# Using npm
npm install @intlify/utils

# Using yarn
yarn add @intlify/utils

# Using pnpm
pnpm add @intlify/utils

Using Edge Releases

If you are directly using @intlify/utils as a dependency:

{
  "dependencies": {
    "@intlify/utils": "npm:@intlify/utils-edge@latest"
  }
}

Note: Make sure to recreate lockfile and node_modules after reinstall to avoid hoisting issues.

🦕 Deno

You can install via import.

in your code:

/**
 * you can install via other CDN URL such as skypack,
 * or, you can also use import maps
 * https://docs.deno.com/runtime/manual/basics/import_maps
 */
import { ... } from 'https://deno.land/x/intlify_utils/mod.ts'

// something todo
// ...

🥟 Bun

bun install @intlify/utils

🌍 Browser

in your HTML:

<script type="module">
/**
 * you can install via other CDN URL such as skypack,
 * or, you can also use import maps
 */
import { isLocale } from 'https://esm.sh/@intlify/utils'

// something todo
// ...
</script>

Using Edge Releases

import { isLocale } from 'https://esm.sh/@intlify/utils-edge'

// something todo
// ...

🍭 Playground

You can play the below examples:

🐢 Node.js: npm run play:node
🦕 Deno: npm run play:deno
🥟 Bun: npm run play:bun
🌍 Browser: npm run play:browser

🔨 Utilities

Common

isLocale
toLocale
parseAcceptLanguage
validateLangTag
normalizeLanguageName

You can do import { ... } from '@intlify/utils' the above utilities

Navigator

getNavigatorLocales
getNavigatorLocale

You can do import { ... } from '@intlify/utils' the above utilities

Note

for Node.js You need to do import { ... } from '@intlify/utils/node'

HTTP

getHeaderLanguages
getHeaderLanguage
getHeaderLocales
getHeaderLocale
getCookieLocale
setCookieLocale
getPathLocale
getQueryLocale
tryHeaderLocales
tryHeaderLocale
tryCookieLocale
tryPathLocale
tryQueryLocale

The about utilities functions accept Web APIs such as Request and Response that is supported by JS environments (such as Deno, Bun, and Browser)

Specialized environments

If you will use Node.js and H3, You can do import { ... } from '@intlify/utils/{ENV}' the above utilities.

The namespace {ENV} is one of the following:

node: accept IncomingMessage and Outgoing by Node.js http module
h3: accept H3Event by HTTP framework h3
hono: accept Context by edge-side web framework hono

🙌 Contributing guidelines

If you are interested in contributing to @intlify/utils, I highly recommend checking out the contributing guidelines here. You’ll find all the relevant information such as how to make a PR, how to setup development) etc., there.

©️ License

MIT