Zum Inhalt springen
Server-Side i18n

Serverseitiges i18n für Hono, Express und Edge

Internationalisieren Sie Ihre API und Ihre serverseitig gerenderten Apps. Better I18N bietet Middleware für Hono, Express, Fastify und Edge-Runtimes mit automatischer Spracherkennung.

Setup

Set up in 3 steps

Install the package

Installieren Sie @better-i18n/server. Optional installieren Sie Hono oder Express, je nach Framework.

terminal
npm install @better-i18n/server
# Hono: npm install hono
# Express: npm install express

Create a singleton

Instanziieren Sie createServerI18n() einmal im Modul-Scope. Der TtlCache wird von allen Requests gemeinsam genutzt, kein CDN-Abruf pro Request.

i18n.ts
import { createServerI18n } from '@better-i18n/server';

export const i18n = createServerI18n({
  projectId: 'your-org/your-api',
  defaultLocale: 'en',
});

Register middleware

Binden Sie die Middleware für Ihr Framework ein. Die Middleware liest Accept-Language, löst die Sprache auf und injiziert t() in den Request-Kontext.

Example

Framework middleware

Wählen Sie Ihr Server-Framework — die Middleware-API ist bei Hono und den Node.js-Adaptern gleich.

app.ts
import { Hono } from 'hono';
import { betterI18n } from '@better-i18n/server/hono';
import { i18n } from './i18n';

type Variables = { locale: string; t: Translator };
const app = new Hono<{ Variables: Variables }>();

app.use('*', betterI18n(i18n));

app.get('/api/users/:id', (c) => {
  const t = c.get('t');
  return c.json({ error: t('errors.notFound') }, 404);
});
Capabilities

Warum Better I18N auf dem Server einsetzen?

Middleware nach Web-Standards — Hono, Cloudflare Workers, Deno Deploy
Node.js-Adapter — Express, Fastify und Koa über fromNodeHeaders()
Automatisches Accept-Language — Spracherkennung konform zu RFC 5646
Singleton-TtlCache — nach dem Warm-up keine CDN-Abrufe pro Request
Typsicheres t() — vollständige TypeScript-Inferenz für Übersetzungsschlüssel
Edge-ready — native Unterstützung für Cloudflare Workers

Other frameworks

Get started

Lokalisieren Sie Ihre API-Antworten noch heute

Liefern Sie übersetzte Fehlermeldungen, Benachrichtigungen und Inhalte aus Ihrem Backend, ohne Overhead.