# General Translation Changelog: gt-node 0.2.0: Traducción del lado del servidor para Node.js
URL: https://generaltranslation.com/es/blog/gt-node_v0_2_0.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 
Authors: Ernest McCarter
Published: 2026-02-17

## Resumen

**IMPORTANTE** Esta biblioteca sigue siendo experimental y puede estar sujeta a cambios importantes.

`gt-node` lleva General Translation al JavaScript del lado del servidor. Funciona en **Node.js**, **Bun** y **Deno**.

Al establecer un contexto por solicitud mediante `AsyncLocalStorage`, `gt-node` te permite importar funciones de traducción directamente desde la biblioteca:

```js
const gt = await getGT();
```

Esto sigue la misma API que nuestras otras bibliotecas, como `gt-next`, cuando se trabaja con funciones asíncronas.

***


## Qué se incluye

* **[`initializeGT()`](/docs/node/reference/functions/initialize-gt)** — Configura el singleton de i18n. Llámalo una sola vez al iniciar el servidor.
* **`withGT(locale, fn)`** — Envuelve un controlador de solicitudes para definir el ámbito de la configuración regional. Todas las llamadas de traducción dentro del callback usan la configuración regional proporcionada. Todas las rutas deben envolverse en [`withGT`](/docs/node/reference/functions/with-gt).
* **[`getGT()`](/docs/node/reference/functions/get-gt)** — Devuelve una función de traducción para cadenas inline. Admite interpolación de variables y el formato de mensajes ICU.

***

## Guía rápida (Express)

### Instalar

```bash
npm install gt-node
```


### Inicializa

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


### Añade el middleware de configuración regional

Extrae la configuración regional de los encabezados de la solicitud (o de las cookies, los parámetros de consulta; según cómo tu app determine la configuración regional) y envuelve cada solicitud con [`withGT`](/docs/node/reference/functions/with-gt):

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

### Traduce

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

app.listen(3000);
```


### Traduce y despliega

```bash
npx gt translate --publish
```

Eso es todo. El compilador de GT detecta las cadenas en tiempo de compilación, las traduce durante el CD y las resuelve en cada solicitud en tiempo de ejecución.

***

## De cara al futuro

`gt-node` y `gt-tanstack-start` son las dos primeras bibliotecas creadas sobre la arquitectura singleton de `gt-i18n`. Se espera que más adaptadores para frameworks sigan el mismo patrón.

Déjanos tus comentarios en [Discord](https://discord.gg/SjQwPjZaGa) o [GitHub](https://github.com/generaltranslation/gt/issues).

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.