# 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
Docs index: https://generaltranslation.com/llms.txt
Description: Comment déterminer et associer un paramètre régional à chaque requête avec General Translation dans gt-node.

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.

## Associer 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) se résolvent par rapport à lui.

```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`](/docs/node/reference/functions/with-gt) déclenche une erreur en développement ; en production, il se replie 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, résolvez vous-même le paramètre régional — par exemple à partir d’un cookie ou d’un segment d’URL — puis repliez-vous sur [`getRequestLocale`](/docs/node/reference/functions/get-request-locale). Passez le résultat à [`withGT`](/docs/node/reference/functions/with-gt).

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

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

[`withGT`](/docs/node/reference/functions/with-gt) résout la valeur que vous transmettez par rapport à vos `locales` configurés ; ainsi, un paramètre régional non pris en charge se replie sur le 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

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.