intlayer Hono Middleware Dokumentation

Die intlayer-Middleware für Hono erkennt das Locale des Benutzers und füllt das Kontextobjekt mit Intlayer-Funktionen. Sie ermöglicht auch die Verwendung globaler Übersetzungsfunktionen innerhalb des Anforderungskontexts.

Verwendung

import { Hono } from "hono";
import { intlayer } from "hono-intlayer";

const app = new Hono();

app.use("*", intlayer());

app.get("/", async (c) => {
  const t = c.get("t");
  const content = t({
    en: "Hello",
    fr: "Bonjour",
  });

  return c.text(content);
});

Beschreibung

Die Middleware führt die folgenden Aufgaben aus:

1. Locale-Erkennung: Sie analysiert die Anfrage (Header, Cookies usw.), um das bevorzugte Locale des Benutzers zu bestimmen.
2. Kontext-Population: Sie fügt Intlayer-Daten zum Hono-Kontext hinzu, auf die über c.get() zugegriffen werden kann. Dies beinhaltet:
   • locale: Das erkannte Locale.
   • t: Eine Übersetzungsfunktion.
   • getIntlayer: Eine Funktion zum Abrufen von Wörterbüchern.
   • getDictionary: Eine Funktion zum Verarbeiten von Wörterbuchobjekten.
3. Kontext-Management: Sie verwendet cls-hooked, um einen asynchronen Kontext zu verwalten, der es globalen Intlayer-Funktionen (t, getIntlayer, getDictionary) ermöglicht, auf das anforderungsspezifische Locale zuzugreifen, ohne das Kontextobjekt zu übergeben.