# gt-node: General Translation Node.js SDK: Détection du paramètre régional de la requête
URL: https://generaltranslation.com/fr/docs/node/guides/detecting-locale.mdx
---

title: Détection du paramètre régional de la requête
description: Comment déterminer et associer un paramètre régional à chaque requête avec General Translation dans gt-node.
related:
  links:
    - /docs/node/guides/translating-strings
    - /docs/node/guides/configuring
    - /docs/node/guides/storing-translations

---

Chaque appel de traduction dans `gt-node` s’exécute selon le paramètre régional de la requête en cours. Vous déterminez ce paramètre régional à partir de la requête et l’associez avec [`withGT`](/docs/node/reference/functions/with-gt), afin que toutes les fonctions de traduction appelées ensuite l’utilisent.

## Lier un paramètre régional à `withGT` [#with-gt]

Encapsulez le traitement de la requête dans `withGT(locale, fn)`. Le paramètre régional est ainsi conservé pendant toute la durée de la requête, afin que [`getGT`](/docs/node/reference/functions/get-gt), [`getMessages`](/docs/node/reference/functions/get-messages), [`tx`](/docs/node/reference/functions/tx) et [`getLocale`](/docs/node/reference/functions/get-locale) l’utilisent pour leur résolution.

```ts
import { withGT } from 'gt-node';

app.use((req, res, next) => withGT(resolveLocale(req), () => next()));
```

*Remarque : l’appel d’une fonction de traduction ou de paramètre régional en dehors d’un contexte `withGT` déclenche une erreur en développement ; en production, il se rabat sur le paramètre régional par défaut.*

## Détecter via `Accept-Language` [#accept-language]

Utilisez [`getRequestLocale`](/docs/node/reference/functions/get-request-locale) pour sélectionner le paramètre régional pris en charge le plus approprié à partir de l’en-tête `Accept-Language` de la requête, avec repli sur le paramètre régional par défaut.

```ts
import { withGT, getRequestLocale } from 'gt-node';

app.use((req, res, next) => withGT(getRequestLocale(req), () => next()));
```

## Détecter à partir de vos propres signaux [#custom]

Pour respecter un choix explicite de l’utilisateur, déterminez vous-même le paramètre régional — par exemple à partir d’un cookie ou d’un segment d’URL — puis utilisez `getRequestLocale` comme solution de repli. Passez le résultat à `withGT`.

```ts
function resolveLocale(req) {
  return req.cookies?.locale || getRequestLocale(req);
}

app.use((req, res, next) => withGT(resolveLocale(req), () => next()));
```

`withGT` fait correspondre la valeur que vous transmettez à vos `locales` configurés ; ainsi, un paramètre régional non pris en charge revient au paramètre par défaut. Lisez le paramètre régional actif à n’importe quel endroit d’une requête avec [`getLocale`](/docs/node/reference/functions/get-locale).
## Next steps

- /docs/node/guides/translating-strings
- /docs/node/guides/configuring
- /docs/node/guides/storing-translations