# node: getRequestLocale
URL: https://generaltranslation.com/es/docs/node/api/get-request-locale.mdx
---
title: getRequestLocale
description: Referencia de la API de la función getRequestLocale
---

## Descripción general

La función `getRequestLocale` extrae la configuración regional preferida de la cabecera `Accept-Language` de una solicitud y la compara con las configuraciones regionales definidas en tu proyecto.

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

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

<Callout>
  **Requiere inicialización:**
  Llama a [`initializeGT`](/docs/node/api/initialize-gt) antes de usar `getRequestLocale` para que sepa qué configuraciones regionales se admiten.
</Callout>

## Referencia

### Parámetros

<TypeTable
  type={{
  "request": {
    type: 'RequestLike',
    description: 'Un objeto con una propiedad headers que contiene las cabeceras de la solicitud. Funciona con Express, Fastify y cualquier framework que exponga las cabeceras como Record<string, string | string[] | undefined>.',
    optional: false,
  },
}}
/>

### Devuelve

`cadena` — El [código de configuración regional](/docs/core/locales) BCP 47 que mejor coincida entre las configuraciones regionales que hayas configurado, o `defaultLocale` si no se encuentra ninguna coincidencia.

***

## Ejemplos

### middleware de 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());
}
```

### Combinar con otras estrategias

Usa `getRequestLocale` como respaldo cuando no se haya establecido ninguna preferencia explícita:

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

***

## Siguientes pasos

* Consulta [`getLocale`](/docs/node/api/get-locale) para obtener la configuración regional dentro de un contexto `withGT`.
* Consulta la guía [Detección de configuración regional y middleware](/docs/node/guides/middleware) para ver los patrones completos de middleware.