# gt-next: General Translation Next.js SDK: createNextMiddleware
URL: https://generaltranslation.com/ja/docs/next/api/middleware/create-next-middleware.mdx
---
title: createNextMiddleware
description: createNextMiddleware() メソッドの API リファレンス
---

## 概要

`createNextMiddleware` は、Next.js で使用するミドルウェア関数を作成するユーティリティ関数です。
これを使うと、Next.js アプリケーションでロケールごとに異なるルートを追加できます。

たとえば、フランス語のユーザーは `/fr/landing` に、英語のユーザーは `/en/landing` に振り分けられます。

このミドルウェアの使い方について詳しくは、[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,
  },
}}
/>

### 説明

| Prop                  | 説明                                                                         |
| --------------------- | -------------------------------------------------------------------------- |
| `pathConfig`          | アプリケーションのロケールごとのパスを指定する入れ子のオブジェクトです。                                      |
| `localeRouting`       | i18n ルーティングを有効または無効にするフラグです。                                               |
| `prefixDefaultLocale` | デフォルト ロケールのロケールプレフィックスを削除するかどうかを指定するフラグです。 (例：`/en/about` -&gt; `/about`)  |
| `ignoreSourceMaps`    | ソースマップを無視するかどうかを指定するフラグです。                                                 |

***

## 例

### 基本的な使い方

この関数とパスマッチャーをプロキシファイルに追加するだけで、ロケールルーティングを有効にできます。

```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` オプションで、ロケールごとのパスを指定できます。

```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` 関数は、Next.js で使用するプロキシ/ミドルウェア関数を作成するユーティリティ関数です。これをプロジェクトルートの `proxy.ts` に配置します。

## 次のステップ