# node: getTranslations
URL: https://generaltranslation.com/es/docs/node/api/get-translations.mdx
---
title: getTranslations
description: Referencia de la API de la función getTranslations para traducir diccionarios
---

## Descripción general

`getTranslations` devuelve una función de traducción `t` que obtiene entradas de un [diccionario](/docs/next/guides/dictionaries).
Úsala para traducir cadenas predefinidas por su clave del diccionario.

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

const t = await getTranslations();
t('greeting.hello'); // "¡Hola!"
```

<Callout>
  **Se requiere el contexto de la solicitud:**
  `getTranslations` debe llamarse dentro de un callback de [`withGT`](/docs/node/api/with-gt) para que sepa qué configuración regional debe usar.
</Callout>

## Referencia

### Parámetros

Ninguno.

### Devuelve

Una promesa que se resuelve con una función de traducción `t`:

```ts
Promise<TFunctionType>
```

La función `t` acepta una clave de diccionario y opciones de interpolación opcionales:

| Nombre     | Tipo                           | Descripción                                                |
| ---------- | ------------------------------ | ---------------------------------------------------------- |
| `id`       | `string`                       | La ruta separada por puntos a una entrada del diccionario. |
| `options?` | `DictionaryTranslationOptions` | Variables para la interpolación.                           |

**Devuelve:** `string` — el texto traducido (o el texto de origen como contenido alternativo).

Si la clave no existe en el diccionario de origen, `t()` genera un error.
Si la clave existe en el diccionario de origen pero no tiene traducción para la configuración regional actual, `t()` devuelve el texto de origen.

### `t.obj()`

Devuelve un subárbol completo del diccionario como un objeto en lugar de una sola cadena.

```ts
t.obj(id: string): DictionaryObjectTranslation
```

| Nombre | Tipo     | Descripción                                                |
| ------ | -------- | ---------------------------------------------------------- |
| `id`   | `string` | La ruta separada por puntos a un subárbol del diccionario. |

**Devuelve:** Un objeto anidado que sigue la estructura del diccionario, con valores traducidos cuando están disponibles y contenido alternativo en el idioma de origen en los demás casos.

***

## Configuración

### Automático (recomendado)

Crea un archivo `dictionary.json` en la raíz del proyecto:

```json title="dictionary.json"
{
  "greeting": {
    "hello": "Hello!"
  },
  "user": {
    "welcome": "Welcome, {name}!"
  }
}
```

Cuando ejecutas `npx gtx translate`, la CLI detecta automáticamente `dictionary.json` y lo traduce para las configuraciones regionales que hayas configurado.

Luego, inicializa GT con el diccionario:

```ts
import { initializeGT } from 'gt-node';
import dictionary from './dictionary.json';

initializeGT({
  dictionary,
  defaultLocale: 'en-US',
  locales: ['en-US', 'es', 'fr'],
});
```

### Cargador personalizado de diccionarios

Si gestionas tus propios diccionarios traducidos, pasa una función `loadDictionary` a [`initializeGT`](/docs/node/api/initialize-gt):

```ts
import { initializeGT } from 'gt-node';
import dictionary from './dictionary.json';

initializeGT({
  dictionary,
  loadDictionary: async (locale) => {
    const dict = await import(`./locales/${locale}.json`);
    return dict.default;
  },
});
```

Las traducciones cargadas con `loadDictionary` tienen prioridad sobre las traducciones generadas por GT.

***

## Ejemplos

### Uso básico

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

const t = await getTranslations();
t('greeting.hello'); // "Hello!"
```

### Interpolación de variables

```ts
const t = await getTranslations();
t('user.welcome', { name: 'Alice' }); // "Welcome, Alice!"
```

### Búsqueda de objetos con `t.obj()`

```ts
const t = await getTranslations();

const errors = t.obj('errors');
// { notFound: "Page not found", unauthorized: "Access denied" }
```

***

## Notas

* `getTranslations` es la contraparte basada en diccionarios de [`getMessages`](/docs/node/api/get-messages), que se usa para las cadenas `inline` de `msg()`.
* Para ver el equivalente en Next.js, consulta [`getTranslations` en gt-next](/docs/next/api/dictionary/get-translations).