# gt-node: General Translation Node.js SDK: getLocale
URL: https://generaltranslation.com/fr/docs/node/reference/functions/get-locale.mdx
---

title: getLocale
description: Lire le paramètre régional actif de la requête en cours dans General Translation gt-node. Référence de l’API de getLocale.

---

Renvoie le paramètre régional actuel du contexte de requête actif. Appelez cette fonction dans un niveau [`withGT`](/docs/node/reference/functions/with-gt) pour lire le paramètre régional associé à la requête.

## Aperçu [#overview]

Appelez `getLocale` sans argument pour obtenir le code de langue BCP 47 actif.

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

const locale = getLocale(); // 'en-US'
```

Signature :

```ts
getLocale(): string
```

*Remarque : `getLocale` doit être appelé à l’intérieur d’un callback [`withGT`](/docs/node/reference/functions/with-gt) afin que la fonction sache quel paramètre régional utiliser.*

## Fonctionnement [#how-it-works]

* **Liée à la requête.** Elle lit le paramètre régional associé à l’appel [`withGT`](/docs/node/reference/functions/with-gt) qui l’entoure.
* **Synchrone.** Elle renvoie immédiatement et ne nécessite pas d’`await`.

## Paramètres [#parameters]

`getLocale` ne prend aucun paramètre.

## Renvoie [#returns]

**Type** `string`

Le code de langue BCP 47 actuel (par exemple, `'en-US'`).

## Exemples [#examples]

```ts title="handler.js"
// Utilisation de base
import { withGT, getLocale } from 'gt-node';

app.use((req, res, next) => {
  const locale = req.headers['accept-language']?.split(',')[0] || 'en-US';
  withGT(locale, () => {
    console.log(getLocale()); // 'en-US'
    next();
  });
});
```