# gt-next: General Translation Next.js SDK: createNextMiddleware
URL: https://generaltranslation.com/ru/docs/next/api/middleware/create-next-middleware.mdx
---
title: createNextMiddleware
description: Справочная документация по методу createNextMiddleware()
---

## Обзор

`createNextMiddleware` — это вспомогательная функция, которая создаёт middleware для использования в Next.js.
Она позволяет добавить отдельный маршрут для каждой локали в вашем приложении Next.js.

Например, франкоязычный пользователь будет перенаправлен на `/fr/landing`, а англоязычный — на `/en/landing`.

Подробнее об использовании этого middleware см. в [руководстве по маршрутизации i18n](/docs/next/guides/middleware).

## Справочник

### Пропсы

<TypeTable
  type={{
  "pathConfig": {
      type: 'PathConfig',
      optional: true,
      default: '{}',
  },
  "localeRouting": {
      type: 'boolean',
      optional: true,
      default: true,
  },
  "prefixDefaultLocale": {
      description: 'Флаг, который включает или отключает удаление префикса локали для локали по умолчанию.',
      type: 'boolean',
      optional: true,
      default: false,
  },
  "ignoreSourceMaps": {
      description: 'Флаг, который включает или отключает игнорирование карт исходного кода.',
      type: 'boolean',
      optional: true,
      default: true,
  },
}}
/>

### Описание

| Свойство              | Описание                                                                                                                   |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `pathConfig`          | Вложенный объект, который задаёт локализованные пути для вашего приложения.                                                |
| `localeRouting`       | Флаг для включения или отключения маршрутизации i18n.                                                                      |
| `prefixDefaultLocale` | Флаг для включения или отключения удаления префикса локали для локали по умолчанию. (например, `/en/about` -&gt; `/about`) |
| `ignoreSourceMaps`    | Флаг для включения или отключения игнорирования карт исходного кода.                                                       |

***

## Пример

### Базовое использование

Просто добавьте эту функцию и сопоставитель путей в файл proxy, чтобы включить маршрутизацию по локалям.

```js title="proxy.ts" copy
import { createNextMiddleware } from 'gt-next/middleware'

export default createNextMiddleware();

export const config = {
  matcher: [
    /*
      * Совпадать со всеми путями запросов, кроме начинающихся с:
      * - api (маршруты API)
      * - _next (внутренние файлы)
      * - статические файлы
      */
    "/((?!api|static|.*\\..*|_next).*)",
  ],
}
```

### Локализованные пути

Вы можете задать локализованные пути с помощью параметра `pathConfig` в файле proxy.

```js title="proxy.ts" copy
export default createNextMiddleware({
  pathConfig: {
    "/about": "/about",
    "/airplanes": {
      "zh": "/飞机",
    }
  },
});
```

См. [руководство по маршрутизации i18n](/docs/next/guides/middleware), где подробно описано, как это работает.

### Удалить префикс локали по умолчанию

Префикс локали по умолчанию можно удалить, установив для параметра `prefixDefaultLocale` значение `false`.

```js title="proxy.ts" copy
export default createNextMiddleware({
  prefixDefaultLocale: true,
});
```

Если это значение равно `true`, каждый путь должен иметь префикс локали.
Если установить значение `false` (значение по умолчанию), из пути будет удаляться только локаль по умолчанию.

***

## Примечания

* `createNextMiddleware` — вспомогательная функция, которая создает proxy/middleware для Next.js. Разместите ее в `proxy.ts` в root вашего проекта.

## Следующие шаги