Creation:2026-01-21Last update:2026-01-21

    Dokumentacja middleware intlayer dla Express

    Middleware intlayer dla Express wykrywa lokalizację użytkownika i udostępnia funkcje tłumaczące przez obiekt res.locals. Umożliwia też korzystanie z funkcji t oraz getIntlayer w całej obsłudze żądań.

    Użycie

    ts
    import express from "express";import { intlayer } from "express-intlayer";const app = express();app.use(intlayer());app.get("/", (req, res) => {  const content = res.locals.t({    en: "Hello",    fr: "Bonjour",  });  res.send(content);});

    Opis

    Middleware wykonuje następujące zadania:

    1. Wykrywanie lokalizacji (locale): Sprawdza ciasteczka, nagłówki (np. Accept-Language) oraz parametry URL, aby określić lokalizację użytkownika.
    2. Ustawienie kontekstu: wypełnia res.locals następującymi wartościami:
      • locale: wykryta lokalizacja.
      • t: funkcja tłumacząca powiązana z wykrytą lokalizacją.
      • getIntlayer: funkcja pobierająca słowniki powiązane z wykrytą lokalizacją.
    3. Async Local Storage: ustawia kontekst umożliwiający użycie globalnych funkcji t i getIntlayer importowanych z express-intlayer w przebiegu żądania.