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

## Descripción general

La función `getGT` es una función asíncrona que devuelve una función de traducción para traducir cadenas.
Resuelve las traducciones registradas en tiempo de construcción por el compilador de GT.

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

const gt = await getGT();
const greeting = gt('Hello, world!');
```

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


## Referencia

### Parámetros

Ninguno.

### Devuelve

Una promesa que se resuelve en la función de traducción `gt`:

```ts
Promise<(content: string, options?: InlineTranslationOptions) => string>
```

| Nombre     | Tipo                       | Descripción                                                    |
| ---------- | -------------------------- | -------------------------------------------------------------- |
| `content`  | `string`                   | La cadena que se traducirá.                                    |
| `options?` | `InlineTranslationOptions` | Opciones de traducción opcionales (variables, contexto, etc.). |

La función `gt` devuelve la cadena traducida o la cadena original si no se encuentra ninguna traducción.


#### `InlineTranslationOptions`

| Prop         | Type     | Descripción                                                                     |
| ------------ | -------- | ------------------------------------------------------------------------------- |
| `$context?`  | `string` | Contexto adicional para desambiguar las traducciones.                           |
| `$id?`       | `string` | Un ID personalizado para la entrada de traducción.                              |
| `$maxChars?` | `number` | Número máximo de caracteres de la traducción.                                   |
| Other keys   | `any`    | Valores de variables para interpolar en la cadena mediante la sintaxis `{key}`. |

***

## Ejemplos

### Traducción simple

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

function handleRequest(locale: string) {
  return withGT(locale, async () => {
    const gt = await getGT();
    return gt('Hello, world!');
  });
}
```


### Con variables

Usa la sintaxis `{variableName}` en la cadena y pasa los valores en el objeto `options`:

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

function handleGreeting(locale: string, name: string) {
  return withGT(locale, async () => {
    const gt = await getGT();
    return gt('Hello, {name}!', { name });
  });
}
```


### Con el formato de mensajes ICU

`gt-node` admite el formato de mensajes ICU para opciones de formato avanzadas:

```js title="handler.js"
const gt = await getGT();
const balance = gt(
  'Your balance: {amount, number, ::currency/USD}',
  { amount: 1234.56 }
);
```

***


## Notas

* `getGT` devuelve una función de traducción de **tiempo de construcción**. Las cadenas se traducen durante el proceso de CD, antes del despliegue.
* En desarrollo, las traducciones se realizan bajo demanda (requiere una clave de la API de Dev).
* Si no se encuentra ninguna traducción, se devuelve la cadena original como respaldo.

## Próximos pasos

* Consulta [`getMessages`](/docs/node/api/get-messages) para resolver mensajes registrados previamente.
* Consulta [`withGT`](/docs/node/api/with-gt) para configurar el contexto de la configuración regional.