Документація плагіна intlayer для Elysia

Плагін intlayer для Elysia визначає локаль користувача та впроваджує об'єкт intlayer у контекст маршруту. Він також дозволяє використовувати глобальні функції перекладу в контексті запиту.

Використання

import { Elysia } from "elysia";
import { intlayer } from "elysia-intlayer";

const app = new Elysia().use(intlayer()).get("/", ({ intlayer }) =>
  intlayer!.t({
    uk: "Привіт",
    en: "Hello",
    fr: "Bonjour",
    es: "Hola",
  })
);

Плагін реєструє свій контекст через глобальний derive, який Elysia типізує як Partial<{ intlayer: IntlayerContext }>. Під час виконання значення завжди присутнє для маршрутів, зареєстрованих після .use(intlayer()), тож використовуйте non-null assertion (intlayer!.t), або optional chaining, щоб задовольнити TypeScript у режимі strict.

Ті самі хелпери доступні як окремі експорти, тож їх можна викликати без деструктуризації контексту маршруту:

import { Elysia } from "elysia";
import { intlayer, t } from "elysia-intlayer";

const app = new Elysia().use(intlayer()).get("/", () =>
  t({
    uk: "Привіт",
    en: "Hello",
    fr: "Bonjour",
    es: "Hola",
  })
);

Опис

Плагін виконує такі завдання:

1. Визначення локалі: Він зчитує локаль, явно встановлену клієнтом, зі storage (cookie, header), а потім повертається до локалі, узгодженої із заголовка Accept-Language.
2. Впровадження в контекст: Додає властивість intlayer до контексту маршруту Elysia (див. таблицю «Контекст маршруту» нижче).
3. Підготовка словників: Викликає prepareIntlayer під час створення плагіна, тож словники збираються під час старту застосунку.

Контекст маршруту

Якщо окремі хелпери викликати поза запитом, який обробляє плагін, вони повертаються до налаштованої локалі за замовчуванням.

Порядок визначення локалі

За замовчуванням плагін визначає локаль у такому порядку:

1. Cookie INTLAYER_LOCALE.
2. Заголовок x-intlayer-locale.
3. Узгодження через заголовок Accept-Language.
4. Налаштована defaultLocale.

# Узгоджено з `Accept-Language`
curl -H "Accept-Language: fr" http://localhost:3000/
# Bonjour

# Cookie має пріоритет над `Accept-Language`
curl -H "Accept-Language: fr" -H "Cookie: INTLAYER_LOCALE=es" http://localhost:3000/
# Hola

# Заголовок має пріоритет над `Accept-Language`
curl -H "Accept-Language: fr" -H "x-intlayer-locale: es" http://localhost:3000/
# Hola

Конфігурація

Плагін читає ваш файл intlayer.config.ts. Ви можете налаштувати cookie та header, які використовуються для визначення локалі:

import { Locales, type IntlayerConfig } from "intlayer";

const config: IntlayerConfig = {
  internationalization: {
    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
    defaultLocale: Locales.ENGLISH,
  },
  routing: {
    storage: [
      { type: "header", name: "my-locale-header" },
      { type: "cookie", name: "my-locale-cookie" },
    ],
  },
};

export default config;

Докладніше про конфігурацію дивіться в документації з конфігурації.

Пов'язана документація