# node: withGT
URL: https://generaltranslation.com/es/docs/node/api/with-gt.mdx
---
title: withGT
description: Referencia de la API del wrapper de solicitudes withGT
---

## Descripción general

La función `withGT` envuelve una función callback para proporcionar el contexto de configuración regional a las funciones de traducción.
En un servidor Node.js, cada solicitud suele atender a un usuario distinto con una configuración regional diferente.
`withGT` establece la configuración regional para todas las funciones de traducción que se llamen dentro de la callback.

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

app.get('/api/greeting', (req, res) => {
  withGT(req.locale, () => {
    // Las funciones de traducción aquí dentro usan req.locale
  });
});
```

<Callout>
  **Contexto de la solicitud:**
  `withGT` usa almacenamiento local asíncrono internamente para asociar la configuración regional a la solicitud actual.
  Todas las llamadas a `getGT` y `getMessages` dentro del callback usarán la configuración regional proporcionada.
</Callout>


## Referencia

### Parámetros

<TypeTable
  type={{
  "locale": {
    type: 'string',
    optional: false,
  },
  "fn": {
    type: '() => T',
    optional: false,
  },
}}
/>

### Descripción

| Param    | Descripción                                                                                                                                   |
| -------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `locale` | Un [código de configuración regional](/docs/core/locales) (p. ej., `'es'`, `'fr-CA'`) que se usará para las traducciones dentro del callback. |
| `fn`     | Una función callback que se ejecuta con el contexto de configuración regional especificado. Puede ser síncrona o asíncrona.                   |

### Devuelve

`T` — el valor de retorno de la función callback `fn`.

***

## Ejemplos

### Middleware de Express

```js title="server.js"
import express from 'express';
import { initializeGT, withGT, getGT } from 'gt-node';

initializeGT({
  defaultLocale: 'en-US',
  locales: ['en-US', 'es', 'fr'],
  projectId: process.env.GT_PROJECT_ID,
});

const app = express();

app.use((req, res, next) => {
  const locale = req.headers['accept-language']?.split(',')[0] || 'en-US';
  withGT(locale, () => {
    next();
  });
});

app.get('/api/greeting', async (req, res) => {
  const gt = await getGT();
  res.json({ message: gt('Hello, world!') });
});
```


### Encapsular un manejador asíncrono

```js title="handler.js"
import { withGT, getGT } from 'gt-node';

export async function handleRequest(locale: string) {
  return withGT(locale, async () => {
    const gt = await getGT();
    return gt('Welcome to our app!');
  });
}
```

***


## Notas

* `initializeGT` debe llamarse antes de usar `withGT`. De lo contrario, se producirá un error.
* El contexto de la configuración regional se limita al callback y no se propaga a otras solicitudes simultáneas.
* `withGT` funciona tanto con callbacks síncronos como asíncronos.

## Siguientes pasos

* Consulta [`initializeGT`](/docs/node/api/initialize-gt) para la configuración inicial.
* Consulta [`getGT`](/docs/node/api/get-gt) para traducir cadenas en el contexto de una solicitud.