# General Translation React SDKs (gt-react, gt-next): registerLocale
URL: https://generaltranslation.com/ja/docs/react/nextjs/reference/functions/register-locale.mdx
---

title: registerLocale
description: General Translation で Next.js App Router のサーバーコード用にロケールを登録します。registerLocale の API リファレンス。

---

`registerLocale` 関数は、現在の App Router のリクエストコンテキストにロケールを設定します。`next/root-params` が利用できない Route Handler や metadata image handler で使用してください。ハンドラーの例については、[リクエストのロケールを登録する](/docs/react/nextjs/registering-request-locales)を参照してください。

`registerLocale` はサーバー専用で、Pages Router では動作しません。

## 概要 [#overview]

リクエストハンドラー内では、他の `gt-next` サーバー関数より先に `registerLocale` を呼び出してください。

```tsx
import { registerLocale } from 'gt-next/server';

registerLocale('fr');
```

## パラメータ [#parameters]

| パラメータ    | 説明                  | 型        | 任意  | デフォルト |
| -------- | ------------------- | -------- | --- | ----- |
| `locale` | 現在のリクエスト用に登録するロケール。 | `string` | いいえ | —     |

サポートされていないロケール値は、General Translation のロケール設定に従ってフォールバックします。

## 戻り値 [#returns]

**型** `void`

## 例 [#example]

```tsx title="app/[locale]/opengraph-image.tsx"
import { ImageResponse } from 'next/og';
import { getGT, registerLocale } from 'gt-next/server';

export default async function Image({ params }) {
  const { locale } = await params;
  registerLocale(locale);

  const gt = await getGT();
  return new ImageResponse(<div>{gt('Welcome')}</div>);
}
```