# node: getLocale
URL: https://generaltranslation.com/it/docs/node/api/get-locale.mdx
---
title: getLocale
description: Riferimento API della funzione getLocale
---

## Panoramica

La funzione `getLocale` restituisce l'impostazione regionale corrente per il contesto della richiesta in corso.

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

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

<Callout>
  **Contesto della richiesta obbligatorio:**
  `getLocale` deve essere chiamato all&#39;interno di una callback [`withGT`](/docs/node/api/with-gt) affinché sappia quale impostazione regionale usare.
</Callout>


## Riferimento

### Parametri

Nessuno.

### Restituisce

`string` — Il [codice locale](/docs/core/locales) BCP 47 attuale (ad es. `'en-US'`).

***

## Esempi

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

***


## Passaggi successivi

* Consulta [`getLocales`](/docs/node/api/get-locales) per l&#39;elenco completo delle impostazioni regionali supportate.
* Consulta [`getLocaleProperties`](/docs/node/api/get-locale-properties) per i metadati dell&#39;impostazione regionale.