# gt-node: General Translation Node.js SDK: getGT
URL: https://generaltranslation.com/es/docs/node/reference/functions/get-gt.mdx
---

title: getGT
description: Obtén una función de General Translation para la configuración regional actual de la solicitud y traducir cadenas inline. Referencia de la API de getGT.

---

Una función asíncrona que devuelve una función de traducción para la configuración regional de la solicitud actual. Resuelve las traducciones registradas en tiempo de compilación por el compilador de General Translation y, si no encuentra ninguna, recurre a la cadena de origen.

## Resumen [#overview]

Usa `await` con `getGT` dentro del ámbito de [`withGT`](/docs/node/reference/functions/with-gt) para obtener una función sincrónica `gt(message, options?)` y luego traducir cadenas con ella.

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

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

Firma:

```ts
getGT(): Promise<GTFunctionType>

type GTFunctionType = (message: string, options?: GTTranslationOptions) => string;
```

*Nota: `getGT` debe llamarse dentro de un callback de [`withGT`](/docs/node/reference/functions/with-gt) para que sepa qué configuración regional usar. También acepta un argumento interno `_messages` que el compilador usa para la recarga en caliente durante el desarrollo; no debes pasarlo directamente.*

## Cómo funciona [#how-it-works]

* **Traducciones en tiempo de compilación.** `getGT` devuelve una función de traducción en tiempo de compilación. Las cadenas se traducen durante el proceso de CD antes del despliegue, por lo que las solicitudes en producción usan traducciones en caché sin tener que hacer un viaje de ida y vuelta por la red.
* **Desarrollo.** En desarrollo, las traducciones se realizan a demanda y requieren una clave de API de desarrollo.
* **Contenido alternativo.** Si no se encuentra ninguna traducción, se devuelve la cadena fuente original (interpolada).
* **Interpolación.** Usa marcadores de posición `{variableName}` en la cadena y pasa los valores en el objeto de opciones. `gt-node` admite [formato de mensajes ICU](https://unicode-org.github.io/icu/userguide/format_parse/messages/) para formato avanzado.

## Parámetros [#parameters]

`getGT` no recibe parámetros. La función `gt` devuelta recibe:

| Parámetro             | Descripción                                          | Tipo                   | Opcional | Predeterminado |
| --------------------- | ---------------------------------------------------- | ---------------------- | -------- | -------------- |
| [`message`](#message) | La cadena que se va a traducir.                      | `string`               | No       | —              |
| [`options`](#options) | Variables de interpolación y opciones de traducción. | `GTTranslationOptions` | Sí       | `{}`           |

### `message` [#message]

**Tipo** `string` · **obligatorio**

La cadena que se traducirá. Puede contener marcadores de posición `{variable}` para la interpolación de ICU.

### `options` [#options]

**Tipo** `GTTranslationOptions` · **Opcional**

Opciones de traducción y variables de interpolación:

* `$context?: string` — contexto adicional para ayudar a desambiguar las traducciones.
* `$id?: string` — un ID personalizado para la entrada de traducción.
* `$locale?: string` — sobrescribe la configuración regional de la solicitud para esta llamada.
* `$format?: string` — el formato del mensaje. El valor predeterminado es `'ICU'`.
* `$maxChars?: number` — número máximo de caracteres para la traducción.
* `$requiresReview?: boolean` — si la traducción requiere aprobación antes de usarse.
* Cualquier otra clave se trata como un valor para interpolar en la cadena mediante la sintaxis `{key}`.

## Devuelve [#returns]

**Tipo** `Promise<GTFunctionType>`

Se resuelve con la función de traducción `gt`. Al llamar a `gt(message, options?)`, devuelve la cadena traducida o la cadena original (interpolada) si no se encuentra ninguna traducción.

## Ejemplos [#examples]

```ts title="handler.js"
// Traducción simple
import { withGT, getGT } from 'gt-node';

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

```ts title="handler.js"
// Con variables — usa {name} en la cadena y pasa los valores en el options object
import { withGT, getGT } from 'gt-node';

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

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

## Notas [#notes]

* `getGT` devuelve una función de traducción en tiempo de compilación; las cadenas se traducen durante el proceso de CD antes del despliegue.
* En desarrollo, las traducciones se realizan cuando se solicitan y requieren una Dev API key.
* Si no se encuentra ninguna traducción, se devuelve la cadena original como contenido alternativo.
* Para cadenas que solo se conocen en tiempo de ejecución, usa [`tx`](/docs/node/reference/functions/tx); para cadenas registradas en el ámbito del módulo, usa [`msg`](/docs/node/reference/functions/msg) con [`getMessages`](/docs/node/reference/functions/get-messages).