intlayerProxy

intlayerProxy — це плагін Vite, який реєструє проміжне програмне забезпечення (middleware) локалізації роутингу для будь-якого середовища: dev-сервера, preview-сервера та продакшен SSR (Nitro / TanStack Start).

Починаючи з Intlayer v9, intlayerProxy автоматично включається в основний плагін intlayer() і активований за замовчуванням за допомогою налаштування routing.enableProxy: true. Вам потрібно реєструвати його окремо лише в тому випадку, якщо вам потрібен низькорівневий контроль або якщо ви використовуєте його за межами стандартної конфігурації intlayer().

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

У складі intlayer() (рекомендовано, v9+)

Передайте параметри proxy в основний плагін замість окремої реєстрації intlayerProxy:

// vite.config.tsimport { defineConfig } from "vite";import { intlayer } from "vite-intlayer";export default defineConfig({  plugins: [    intlayer({      proxy: {        ignore: (req) => req.url?.startsWith("/api"),      },    }),  ],});

Окремо (за необхідності)

// vite.config.tsimport { defineConfig } from "vite";import { intlayer } from "vite-intlayer";export default defineConfig({  plugins: [intlayer()],});

Параметри

import type { IntlayerProxyPluginOptions } from "vite-intlayer";

Усі параметри є необов'язковими і передаються у вигляді єдиного об'єкта:

Приклад

intlayerProxy({  ignore: (req) => req.url?.startsWith("/api"),  configOptions: { configFile: "./config/intlayer.config.ts" },});

createIntlayerProxyHandler

createIntlayerProxyHandler створює незалежний від фреймворку Node.js middleware (req, res, next), який містить всю логіку локалізації роутингу. Це корисно в середовищах, де API плагінів Vite недоступний (наприклад, на звичайному сервері Node.js або в кастомному модулі Nitro).

import { createIntlayerProxyHandler } from "vite-intlayer";const handler = createIntlayerProxyHandler({  ignore: (req) => req.url?.startsWith("/api"),  configOptions: { configFile: "./config/intlayer.config.ts" },});// Express / Connectapp.use(handler);

Продакшен SSR (TanStack Start / Nitro через h3)

// server/middleware/intlayerProxy.tsimport { fromNodeMiddleware } from "h3";import { createIntlayerProxyHandler } from "vite-intlayer";export default fromNodeMiddleware(  createIntlayerProxyHandler({    ignore: (req) => req.url?.startsWith("/api"),  }));

Поведінка роутингу

Цей middleware дублює логіку роутингу з middleware next-intlayer і підтримує всі режими роутингу Intlayer.

Режими роутингу

Пріоритет визначення

1. Префікс шляху URL (наприклад, /uk/about → uk).
2. Значення в cookie / localStorage (intlayer-locale).
3. Заголовок Accept-Language.
4. defaultLocale з конфігурації.

Автоматичний обхід (Bypass)

Цей middleware завжди пропускає наступні запити безпосередньо без обробки локалі:

• Запити, що відповідають предикату ignore.
• /node_modules/**
• /@** — внутрішні запити Vite (@vite/, @fs/, @id/ тощо).
• /_** — внутрішні запити сервера (__vite_ping, __manifest тощо).
• Запити, шлях яких закінчується розширенням файлу (статичні файли). Якщо в шляху статичного файлу присутній мовний префікс (наприклад, /uk/logo.png), він видаляється, щоб файл міг бути відданий коректно.

Роутинг по доменах

Коли у вашій конфігурації Intlayer налаштовано параметр routing.domains, цей middleware обробляє роутинг мов між різними доменами:

• Запит для /zh/about на домені intlayer.org перенаправляється на https://intlayer.zh/about, коли domains.zh = "intlayer.zh".
• Запит до intlayer.zh/about внутрішньо переписується в /zh/about, щоб заповнився параметр маршруту [locale].

Захист від нескінченного редиректу

Цей middleware відстежує кількість перенаправлень для пари originalUrl → newUrl у рухомому 2-секундному вікні. Більше 10 перенаправлень у цьому вікні повертають помилку 500 із докладним описом замість нескінченного циклу.

Nitro / SSR у продакшені (автоматичне впровадження, v9+)

Коли intlayerProxy використовується як плагін Vite, він містить властивість .nitro. Плагін збірки nitro/vite зчитує цю властивість і поміщає її в nitroConfig.modules, завдяки чому intlayerNitroHandler реєструється як middleware сервера Nitro автоматично — для продакшен SSR не потрібне ручне налаштування.

Обробник Nitro використовує модель подій Web Fetch API h3 v2 (а не fromNodeMiddleware), тому він сумісний з усіма пресетами Nitro: Node, Bun, Deno, edge runtimes.

Застарілі аліаси