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

## Resumen

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 compilación por el compilador de GT.

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

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

<Callout>
  **Se requiere el 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 devuelve una 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` | ID personalizado para la entrada de traducción.                                  |
| `$maxChars?` | `number` | Número máximo de caracteres de la traducción.                                    |
| Otras claves | `any`    | Valores de variables para interpolarlos en la cadena usando la sintaxis `{key}`. |

***

## Ejemplos

### Traducción sencilla

```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 de opciones:

```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 aplicar formato avanzado:

```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 compilación**. Las cadenas se traducen durante el proceso de CD antes de desplegar.
* En desarrollo, las traducciones se realizan bajo demanda (requiere una clave API de desarrollo).
* Si no se encuentra ninguna traducción, se devuelve la cadena original como alternativa.

## Próximos pasos

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