Dokumentacja middleware Astro onRequest

Middleware onRequest z modułu astro-intlayer/middleware określa lokalizację każdego przychodzącego zapytania HTTP i uzupełnia obiekt Astro.locals.intlayer.

Po zarejestrowaniu integracji intlayer() w pliku astro.config.mjs, to middleware jest wstrzykiwane automatycznie. Bezpośredni import jest wymagany tylko wtedy, gdy ręcznie komponujesz łańcuch middleware Astro za pomocą sequence(...).

Użycie

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

export const onRequest = sequence(intlayer, async (context, next) => {
  // Dostęp do ustalonej lokalizacji w niestandardowym middleware
  const { locale } = context.locals.intlayer;
  console.log(`Obsługa zapytania dla lokalizacji: ${locale}`);

  return next();
});

Opis

Middleware wykonuje następujące operacje:

1. Wykrywanie lokalizacji:
   • URL: Analizuje prefiks ścieżki URL lub parametr zapytania ?locale= (chyba że routing.mode ustawiono na no-prefix).
   • Ciasteczka / Nagłówki: Sprawdza utrwalone ciasteczka lokalizacji lub wartości niestandardowych nagłówków.
   • Accept-Language: Wykorzystuje preferencje językowe przeglądarki w przypadku braku wcześniejszych danych.
   • Dla stron wstępnie renderowanych (context.isPrerendered) lokalizacja jest pobierana ściśle z adresu URL, co zapobiega ostrzeżeniom podczas budowania Astro.
2. Wypełnianie kontekstu: Uzupełnia Astro.locals.intlayer o:
   • locale: Ustaloną lokalizację.
   • defaultLocale: Domyślną lokalizację rezerwową.
   • availableLocales: Tablicę skonfigurowanych lokalizacji.
3. Zakres AsyncLocalStorage: Obejmuje dalsze przetwarzanie zapytania zakresem AsyncLocalStorage, co pozwala funkcjom useIntlayer(), useDictionary() oraz useLocale() na dostęp do stanu zapytania bez przekazywania argumentów.

Typ IntlayerLocals

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

Powiązana dokumentacja

• Integracja intlayer
• Hook useIntlayer
• Hook useLocale