# node: getRequestLocale
URL: https://generaltranslation.com/ja/docs/node/api/get-request-locale.mdx
---
title: getRequestLocale
description: getRequestLocale 関数の API リファレンス
---

## 概要

`getRequestLocale` 関数は、リクエストの `Accept-Language` ヘッダーから優先ロケールを取得し、設定済みの locales と照合します。

```js
import { getRequestLocale } from 'gt-node';

const locale = getRequestLocale(req); // 'fr'
```

<Callout>
  **初期化が必要です:**
  `getRequestLocale` を使用する前に [`initializeGT`](/docs/node/api/initialize-gt) を呼び出し、サポート対象の locales を認識できるようにしてください。
</Callout>

## リファレンス

### パラメータ

<TypeTable
  type={{
  "request": {
    type: 'RequestLike',
    description: 'リクエストヘッダーを含む headers プロパティを持つオブジェクト。Express、Fastify、およびヘッダーを Record<string, string | string[] | undefined> として提供する任意のフレームワークで利用できます。',
    optional: false,
  },
}}
/>

### 戻り値

`string` — 設定された locales の中から最も適合する BCP 47 の[ロケールコード](/docs/core/locales) を返します。一致するものが見つからない場合は `defaultLocale` を返します。

***

## 例

### Express ミドルウェア

```js title="middleware/locale.js"
import { withGT, getRequestLocale } from 'gt-node';

export function localeMiddleware(req, res, next) {
  const locale = getRequestLocale(req);
  withGT(locale, () => next());
}
```

### 他の戦略と組み合わせる

明示的な設定がない場合は、フォールバックとして `getRequestLocale` を使用してください。

```js title="middleware/locale.js"
import { withGT, getRequestLocale } from 'gt-node';

export function localeMiddleware(req, res, next) {
  const locale =
    req.query.lang ||
    req.cookies?.locale ||
    getRequestLocale(req);

  withGT(locale, () => next());
}
```

***

## 次のステップ

* `withGT` コンテキスト内でロケールを読み取る方法については、[`getLocale`](/docs/node/api/get-locale) を参照してください。
* ミドルウェアの実装パターン全体については、[Locale Detection &amp; Middleware](/docs/node/guides/middleware) ガイドを参照してください。