# node: getLocale
URL: https://generaltranslation.com/fr/docs/node/api/get-locale.mdx
---
title: getLocale
description: Référence de l’API de la fonction getLocale
---

## Vue d’ensemble

La fonction `getLocale` renvoie le paramètre régional actuel pour le contexte de la requête en cours.

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

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

<Callout>
  **Contexte de requête requis :**
  `getLocale` doit être appelé dans un callback [`withGT`](/docs/node/api/with-gt) pour pouvoir déterminer quel paramètre régional utiliser.
</Callout>


## Référence

### Paramètres

Aucun.

### Renvoie

`string` — Le [code de langue](/docs/core/locales) BCP 47 actuel (par ex. `'en-US'`).

***

## Exemples

### Utilisation de base

```js title="handler.js"
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();
  });
});
```

***


## Étapes suivantes

* Consultez [`getLocales`](/docs/node/api/get-locales) pour voir la liste complète des paramètres régionaux pris en charge.
* Consultez [`getLocaleProperties`](/docs/node/api/get-locale-properties) pour les métadonnées des paramètres régionaux.