Autor:
    Aymeric PINEAU
    Data utworzenia:2026-08-24Ostatnia aktualizacja:2026-08-24

    Pakiet elysia-intlayer

    Pakiet elysia-intlayer udostępnia wtyczkę dla aplikacji Elysia do obsługi internationalization (i18n). Wykrywa locale użytkownika i wstrzykuje obiekt intlayer do kontekstu route.

    Instalacja

    bash
    npm install intlayer elysia-intlayer
    elysia jest peer dependency (>=1.0.0). Elysia jest przeznaczony dla runtime Bun.

    Eksporty

    Wtyczka

    Import:

    ts
    import { intlayer } from "elysia-intlayer";
    Funkcja Opis Powiązana dokumentacja
    intlayer Wtyczka Elysia integrująca Intlayer z Twoją aplikacją Elysia. Obsługuje wykrywanie locale ze storage (cookies, headers), a następnie z Accept-Language, wstrzykuje obiekt intlayer udostępniający locale, t, getIntlayer i getDictionary do kontekstu route oraz konfiguruje kontekst żądania AsyncLocalStorage. intlayer

    Funkcje

    Import:

    ts
    import { t, getIntlayer, getDictionary } from "elysia-intlayer";
    Funkcja Opis Powiązana dokumentacja
    t Globalna funkcja tłumaczenia pobierająca treść dla bieżącego locale w Elysia. Używa AsyncLocalStorage, aby uzyskać dostęp do kontekstu żądania skonfigurowanego przez wtyczkę intlayer, a poza nim wraca do domyślnego locale. Dostępna również przez intlayer.t. translation
    getIntlayer Pobiera słownik po kluczu z wygenerowanej deklaracji i zwraca jego treść dla bieżącego locale. Zoptymalizowana wersja getDictionary. Używa AsyncLocalStorage, aby uzyskać dostęp do kontekstu żądania. Dostępna również przez intlayer.getIntlayer. -
    getDictionary Przetwarza obiekty słowników i zwraca treść dla bieżącego locale. Przetwarza tłumaczenia t(), enumeracje, markdown, HTML itd. Używa AsyncLocalStorage, aby uzyskać dostęp do kontekstu żądania. Dostępna również przez intlayer.getDictionary. -

    Typy

    Import:

    ts
    import type { IntlayerContext, TranslateFunction } from "elysia-intlayer";
    Typ Opis
    IntlayerContext Kształt obiektu intlayer wstrzykiwanego do każdego kontekstu route: locale, locale_storage, locale_detected, defaultLocale, t, getIntlayer, getDictionary.
    TranslateFunction Sygnatura funkcji tłumaczenia, przekształcającej locale map w treść odpowiadającą locale bieżącego żądania.

    Użycie

    src/index.ts
    import { Elysia } from "elysia";
import { getDictionary, getIntlayer, intlayer, t } from "elysia-intlayer";
import dictionaryExample from "./index.content";

const app = new Elysia()
  // Załaduj wtyczkę internacjonalizacji
  .use(intlayer())
  // Odczytaj locale i helpery z kontekstu trasy
  .get("/", ({ intlayer }) => ({
    locale: intlayer!.locale,
    greeting: intlayer!.t({
      pl: "Cześć",
      en: "Hello",
      fr: "Bonjour",
      es: "Hola",
    }),
    content: intlayer!.getIntlayer("index").exampleOfContent,
  }))
  // Albo użyj samodzielnych helperów, powiązanych z bieżącym żądaniem
  .get("/t_example", () =>
    t({
      pl: "Przykład zwróconej treści w języku polskim",
      en: "Example of returned content in English",
      fr: "Exemple de contenu renvoyé en français",
      es: "Ejemplo de contenido devuelto en español",
    })
  )
  .get("/getIntlayer_example", () => getIntlayer("index").exampleOfContent)
  .get(
    "/getDictionary_example",
    () => getDictionary(dictionaryExample).exampleOfContent
  )
  .listen(3000);

console.log(
  `🦊 Elysia is running at ${app.server?.hostname}:${app.server?.port}`
);
    Plugin rejestruje swój kontekst poprzez globalny derive, który Elysia typuje jako Partial<{ intlayer: IntlayerContext }>. W czasie działania wartość jest zawsze obecna dla tras zarejestrowanych po .use(intlayer()), dlatego użyj non-null assertion (intlayer!.locale) — lub optional chaining — aby zadowolić TypeScript w trybie strict.

    Powiązana dokumentacja

    intlayerintlayer