Collection of i18n utilities

✅️  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

# Using npm
npm install @intlify/utils

# Using yarn
yarn add @intlify/utils

# Using pnpm
pnpm add @intlify/utils

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

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 install @intlify/utils

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>

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

// something todo
// ...

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

• isLocale
• toLocale
• parseAcceptLanguage
• validateLangTag
• normalizeLanguageName

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

• getNavigatorLocales
• getNavigatorLocale

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

• 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)

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

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.

MIT