intlayer Express Middleware Dokumentation

Die intlayer-Middleware für Express erkennt die Locale des Benutzers und stellt Übersetzungsfunktionen über das Objekt res.locals zur Verfügung. Sie ermöglicht außerdem die Verwendung der Funktionen t und getIntlayer in Ihren Request-Handlern.

Verwendung

import express from "express";
import { intlayer } from "express-intlayer";

const app = express();

app.use(intlayer());

app.get("/", (req, res) => {
  const content = res.locals.t({
    de: "Hallo",
    en: "Hello",
    fr: "Bonjour",
  });

  res.send(content);
});

Beschreibung

Die Middleware führt die folgenden Aufgaben aus:

1. Locale-Erkennung: Sie prüft Cookies, Header (wie Accept-Language) und URL-Parameter, um die Locale des Benutzers zu bestimmen.
2. Kontextaufbau: Sie füllt res.locals mit:
   • locale: Die erkannte Locale.
   • t: Eine an die erkannte Locale gebundene Übersetzungsfunktion.
   • getIntlayer: Eine Funktion, um an die erkannte Locale gebundene Wörterbücher abzurufen.
3. Async Local Storage: Es richtet einen Kontext ein, der die Verwendung der globalen Funktionen t und getIntlayer, die aus express-intlayer importiert werden, innerhalb des Request-Flows ermöglicht.