# node: getRequestLocale
URL: https://generaltranslation.com/it/docs/node/api/get-request-locale.mdx
---
title: getRequestLocale
description: Riferimento API per la funzione getRequestLocale
---

## Panoramica

La funzione `getRequestLocale` ricava l'impostazione regionale preferita dall'header `Accept-Language` di una richiesta e la confronta con le impostazioni regionali configurate.

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

const locale = getRequestLocale(req); // 'fr'
```

<Callout>
  **Richiede l&#39;inizializzazione:**
  Chiama [`initializeGT`](/docs/node/api/initialize-gt) prima di usare `getRequestLocale`, così saprà quali impostazioni regionali sono supportate.
</Callout>

## Riferimento

### Parametri

<TypeTable
  type={{
  "request": {
    type: 'RequestLike',
    description: 'Un oggetto con una proprietà headers che contiene le intestazioni della richiesta. Compatibile con Express, Fastify e qualsiasi framework che esponga le intestazioni come Record<string, string | string[] | undefined>.',
    optional: false,
  },
}}
/>

### Valore restituito

`string` — Il [codice locale](/docs/core/locales) BCP 47 che corrisponde meglio tra quelli configurati, oppure `defaultLocale` se non viene trovata alcuna corrispondenza.

***

## Esempi

### middleware Express

```js title="middleware/locale.js"
import { withGT, getRequestLocale } from 'gt-node';

export function localeMiddleware(req, res, next) {
  const locale = getRequestLocale(req);
  withGT(locale, () => next());
}
```

### In combinazione con altre strategie

Usa `getRequestLocale` come fallback quando non è impostata alcuna preferenza esplicita:

```js title="middleware/locale.js"
import { withGT, getRequestLocale } from 'gt-node';

export function localeMiddleware(req, res, next) {
  const locale =
    req.query.lang ||
    req.cookies?.locale ||
    getRequestLocale(req);

  withGT(locale, () => next());
}
```

***

## Passaggi successivi

* Consulta [`getLocale`](/docs/node/api/get-locale) per leggere l&#39;impostazione regionale nel contesto `withGT`.
* Consulta la guida [Rilevamento dell&#39;impostazione regionale e middleware](/docs/node/guides/middleware) per una panoramica completa dei pattern middleware.