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

title: getLocale
description: Lee la configuración regional activa de la solicitud actual en General Translation gt-node. Referencia de la API de getLocale.

---

Devuelve la configuración regional actual del contexto de solicitud activo. Llámalo dentro de un ámbito de [`withGT`](/docs/node/reference/functions/with-gt) para leer la configuración regional asociada a la solicitud.

## Descripción general [#overview]

Llama a `getLocale` sin argumentos para obtener el código de configuración regional BCP 47 activo.

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

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

Firma:

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

*Nota: `getLocale` debe llamarse dentro de un callback de [`withGT`](/docs/node/reference/functions/with-gt) para que sepa qué configuración regional debe usar.*

## Cómo funciona [#how-it-works]

* **Con alcance por solicitud.** Lee la configuración regional asociada por la llamada circundante a [`withGT`](/docs/node/reference/functions/with-gt).
* **Sincrónica.** Devuelve el resultado de inmediato y no requiere `await`.

## Parámetros [#parameters]

`getLocale` no acepta parámetros.

## Devuelve [#returns]

**Tipo** `string`

El código BCP 47 de la configuración regional actual (por ejemplo, `'en-US'`).

## Ejemplos [#examples]

```ts title="handler.js"
// Uso básico
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();
  });
});
```