# node: getRequestLocale
URL: https://generaltranslation.com/fr/docs/node/api/get-request-locale.mdx
---
title: getRequestLocale
description: Référence API pour la fonction getRequestLocale
---

## Vue d’ensemble

La fonction `getRequestLocale` extrait le paramètre régional préféré à partir de l’en-tête `Accept-Language` d’une requête et le met en correspondance avec les paramètres régionaux configurés.

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

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

<Callout>
  **Nécessite une initialisation :**
  Appelez [`initializeGT`](/docs/node/api/initialize-gt) avant d&#39;utiliser `getRequestLocale` pour qu&#39;elle connaisse les paramètres régionaux pris en charge.
</Callout>

## Référence

### Paramètres

<TypeTable
  type={{
  "request": {
    type: 'RequestLike',
    description: 'Objet avec une propriété headers contenant les en-têtes de la requête. Compatible avec Express, Fastify et tout framework qui expose les en-têtes sous la forme de Record<string, string | string[] | undefined>.',
    optional: false,
  },
}}
/>

### Renvoie

`chaîne de caractères` — Le [code de langue](/docs/core/locales) BCP 47 correspondant le mieux à vos paramètres régionaux configurés, ou `defaultLocale` si aucune correspondance n’est trouvée.

***

## Exemples

### Middleware 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());
}
```

### Combiner avec d’autres stratégies

Utilisez `getRequestLocale` comme contenu de remplacement lorsqu’aucune préférence explicite n’est définie :

```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());
}
```

***

## Étapes suivantes

* Consultez [`getLocale`](/docs/node/api/get-locale) pour obtenir le paramètre régional au sein d’un contexte `withGT`.
* Consultez le guide [Détection du paramètre régional et middleware](/docs/node/guides/middleware) pour découvrir toutes les approches de middleware.