Treceți la conținut
JavaScript i18n

Internationalizarea JavaScript: Internationalizare integrată în browser cu API-ul Intl

JavaScript include API-ul Intl ca standard integrat pentru formatarea numerelor, a datelor și a listelor, precum și pentru gestionarea regulilor de pluralizare în diferite setări regionale. Nu sunt necesare biblioteci externe. API-ul este compatibil cu toate browserele moderne și cu Node.js, oferind din start funcții de comparare a șirurilor de caractere adaptate la setările regionale, segmentare și formatare a timpului relativ.

Setup

Add i18n to plain JavaScript in three steps

There is no JavaScript-specific package to install: @better-i18n/core is the plain-JavaScript client every other SDK here wraps.

Install the client

One dependency-free package. It runs in browsers, Node, Deno, Bun and Cloudflare Workers.

terminalbash
npm install @better-i18n/core

# Zero dependencies. Runs in browsers, Node, Deno,
# Bun and Cloudflare Workers.

Create the client once

Instantiate at module scope so the 60-second in-memory cache is shared instead of rebuilt on every call.

i18n.jsjs
import { createI18nCore } from '@better-i18n/core'

export const i18n = createI18nCore({
  projectId: 'your-org/your-project', // Settings → General → Project ID
  defaultLocale: 'en',
})

Read a message

getMessages returns a plain nested object, so a four-line lookup helper is the whole runtime you need.

main.jsjs
import { i18n } from './i18n.js'

const messages = await i18n.getMessages('en')

// getMessages resolves to { namespace: { key: value } }
const t = (path) =>
  path.split('.').reduce((node, part) => node?.[part], messages) ?? path

document.querySelector('h1').textContent = t('home.title')

// Locales come from the project manifest, not a hardcoded array
const languages = await i18n.getLanguages()

How it works

Where a JavaScript string comes from

No build step and no bundled locale files: the client resolves a locale at runtime and the edge answers it.

Read path — every locale load

Your JavaScript app

Reads from the plain object getMessages() already returned.

0 network calls per render

@better-i18n/core

getMessages(locale) — served from the in-memory cache if it is warm.

60s TTL · 0 deps

CDN edge

Cloudflare worker answers from the nearest edge cache.

max-age=60 · always 200

R2 object store

The published translation files the sync worker wrote.

source of truth

Fallback chain — tried in order when a hop fails

1In-memory TTL cache
2CDN fetch, with timeout and one retry
3Persistent storage, if configured
4staticData bundled with the app
5Throw — after everything above missed

Write path — dashboard to app

AI or translator

Proposal reviewed in the dashboard, glossary enforced.

MCP · dashboard · CLI

Publish

Sync worker writes the locale files to R2.

better-i18n publish

CDN purge

Fire-and-forget purge of the affected keys and the manifest.

non-critical by design

Live in the app

The next getMessages() past the TTL returns the new copy.

~60s worst case

0dependencies in core
60scache TTL, client and edge
200CDN status, even on failure
5fallback layers before an error
Two ways

With the client, or with fetch

The client adds caching, retries and the fallback chain. If you would rather own that yourself, the CDN is a plain JSON endpoint.

locale.js
import { i18n } from './i18n.js'
import { normalizeLocale } from '@better-i18n/core'

let current = 'en'
let messages = await i18n.getMessages(current)

export async function setLocale(next) {
  // The CDN stores locales lowercased: pt-BR → pt-br
  current = normalizeLocale(next)
  messages = await i18n.getMessages(current)
  document.documentElement.lang = current
  render()
}
Formatting

API-ul JavaScript Intl în practică

Formatați valute, date și numerale ordinale folosind constructori Intl nativi cu ieșire specifică locale-ului în orice browser modern sau runtime Node.js.

format.jsjs
// Using the built-in Intl API
const formatter = new Intl.NumberFormat('de-DE', {
  style: 'currency',
  currency: 'EUR',
});
console.log(formatter.format(1234.56)); // "1.234,56 €"

// Date formatting
const date = new Intl.DateTimeFormat('ja-JP', {
  year: 'numeric',
  month: 'long',
  day: 'numeric',
});
console.log(date.format(new Date())); // "2026年3月2日"

// Pluralization
const plural = new Intl.PluralRules('en');
const suffixes = { one: 'st', two: 'nd', few: 'rd', other: 'th' };
function ordinal(n) {
  return `${n}${suffixes[plural.select(n)]}`;
}
Capabilities

Funcționalitățile API-ului Intl din JavaScript

API Intl integrat, fără dependențe externe, pentru operațiuni de bază i18n
Intl.NumberFormat pentru formatarea monedei, procentelor și unităților în funcție de locale
Intl.DateTimeFormat pentru modele de afișare a datei și orei specifice setării locale
Reguli internaționale de pluralizare pentru numerele ordinale și cardinale în peste 100 de setări regionale
Sintaxa ICU MessageFormat pentru mesaje complexe cu plurale, selecții și imbricare
Intl.RelativeTimeFormat pentru date relative lizibile (ex.: „acum 3 zile")
Intl.ListFormat pentru liste de conjuncții și disjuncții adaptate la setările locale
Intl.Collator pentru sortarea și compararea șirurilor sensibile la locale
Segmentator internațional pentru detectarea limitelor cuvintelor, propozițiilor și grafemelor

Explorați alte ghiduri privind cadrele de referință

Get started

Începeți astăzi localizarea JavaScript

Gestionați traducerile JavaScript cu fluxuri de lucru alimentate de AI, sincronizare CLI și livrare CDN sub 50ms.