Документация middleware Astro onRequest

Middleware onRequest из astro-intlayer/middleware определяет локаль каждого входящего HTTP-запроса и заполняет Astro.locals.intlayer.

При регистрации интеграции intlayer() в astro.config.mjs это промежуточное ПО внедряется автоматически. Вам нужно импортировать его напрямую только в том случае, если вы вручную компонуете middleware Astro с помощью sequence(...).

Использование

import { onRequest as intlayer } from "astro-intlayer/middleware";
import { sequence } from "astro:middleware";

export const onRequest = sequence(intlayer, async (context, next) => {
  // Доступ к разрешенной локали в вашем пользовательском middleware
  const { locale } = context.locals.intlayer;
  console.log(`Обработка запроса для локали: ${locale}`);

  return next();
});

Описание

Middleware выполняет следующие действия:

1. Определение локали:
   • URL: Анализирует префикс пути URL или параметр поиска ?locale= (если routing.mode не установлен в no-prefix).
   • Куки / Заголовки: Проверяет сохраненные файлы cookie локали или пользовательские значения заголовков.
   • Accept-Language: Использует предпочтительный язык браузера в качестве резерва.
   • Для предрендеренных страниц (context.isPrerendered) локаль извлекается строго из URL, чтобы предотвратить предупреждения сборки Astro.
2. Заполнение контекста: Заполняет Astro.locals.intlayer следующими данными:
   • locale: Разрешенная локаль.
   • defaultLocale: Резервная локаль по умолчанию.
   • availableLocales: Массив настроенных локалей.
3. Область AsyncLocalStorage: Оборачивает обработку запроса в область AsyncLocalStorage, позволяя useIntlayer(), useDictionary() и useLocale() получать доступ к состоянию запроса без явной передачи аргументов.

Тип IntlayerLocals

export type IntlayerLocals = {
  locale: DeclaredLocales;
  defaultLocale: DeclaredLocales;
  availableLocales: DeclaredLocales[];
};

Связанная документация

• Интеграция intlayer
• Хук useIntlayer
• Хук useLocale