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

title: tx
description: Traduce una cadena on-demand en tiempo de ejecución con General Translation. Referencia de la API para tx.

---

Traduce cadenas en tiempo de ejecución. A diferencia de [`getGT`](/docs/node/reference/functions/get-gt), que resuelve traducciones de tiempo de compilación, `tx` envía contenido para traducción on-demand, por lo que puede traducir cadenas que solo se conocen en tiempo de ejecución.

## Descripción general [#overview]

Usa `await` con `tx` dentro de un scope de [`withGT`](/docs/node/reference/functions/with-gt) con la cadena que quieras traducir. El resultado es la cadena traducida.

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

const translated = await tx('Hello, world!');
```

Firma:

```ts
tx(content: string, options?: RuntimeTranslationOptions): Promise<string>
```

*Nota: `tx` realiza la traducción on-demand, lo que implica una solicitud de red y cierta demora frente a la traducción en tiempo de compilación. Usa [`getGT`](/docs/node/reference/functions/get-gt) para cadenas conocidas en tiempo de compilación, y `tx` solo cuando el contenido sea dinámico o no se conozca de antemano.*

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

* **Traducción en tiempo de ejecución.** Las traducciones se realizan en tiempo de ejecución mediante una solicitud de red cuando se produce un fallo de caché, por lo que hay un retraso en comparación con la traducción en tiempo de compilación. Reserva `tx` para contenido dinámico.
* **Sin interpolación de ICU.** A diferencia de [`getGT`](/docs/node/reference/functions/get-gt), `tx` no interpola los marcadores de posición `{variable}`; trata la cadena como texto plano. Inserta variables con literales de plantilla de JavaScript para que sus valores se incluyan en el contenido enviado a traducir.
* **Contenido alternativo.** Devuelve la cadena original si no se necesita traducción.

## Parámetros [#parameters]

| Parámetro             | Descripción                                                    | Tipo                        | Opcional | Predeterminado |
| --------------------- | -------------------------------------------------------------- | --------------------------- | -------- | -------------- |
| [`content`](#content) | La cadena que se va a traducir.                                | `string`                    | No       | —              |
| [`options`](#options) | Opciones para personalizar el comportamiento de la traducción. | `RuntimeTranslationOptions` | Sí       | —              |

### `content` [#content]

**Tipo** `string` · **Obligatorio**

La cadena que se traducirá. Usa literales de plantilla para insertar valores dinámicos en lugar de marcadores de posición `{variable}`.

### `options` [#options]

**Tipo** `RuntimeTranslationOptions` · **Opcional**

Opciones para personalizar la traducción en tiempo de ejecución:

* `$context?: string` — contexto adicional para ayudar a desambiguar la traducción.
* `$locale?: string` — reemplaza la configuración regional establecida por [`withGT`](/docs/node/reference/functions/with-gt).
* `$maxChars?: number` — número máximo de caracteres de la traducción.
* `$requiresReview?: boolean` — indica si la traducción requiere aprobación antes de usarse.

*Nota: `RuntimeTranslationOptions` es como las options inline de [`getGT`](/docs/node/reference/functions/get-gt), pero sin `$id`, y su `$format` usa `plain-string` (no ICU) de forma predeterminada en lugar de ICU.*

## Devuelve [#returns]

**Tipo** `Promise<string>`

Se resuelve con la cadena traducida o, si no es necesaria ninguna traducción, con la cadena original.

## Ejemplos [#examples]

```ts title="handler.js"
// Uso básico
import { withGT, tx } from 'gt-node';

function handleRequest(locale) {
  return withGT(locale, async () => {
    return await tx('Processing complete');
  });
}
```

```ts title="handler.js"
// Con variables — incrusta valores con literales de plantilla, no con {marcadores de posición}
import { withGT, tx } from 'gt-node';

function handleStatus(locale, status) {
  return withGT(locale, async () => {
    return await tx(`Current status: ${status}`);
  });
}
```

```ts title="handler.js"
// Con contexto para desambiguar las traducciones
const translated = await tx('Spring', {
  $context: 'the season, not a coil',
});
```

```ts title="handler.js"
// Especificar una configuración regional — anula la configuración regional de withGT
const translated = await tx('Hello, world!', { $locale: 'fr' });
```

## Notas [#notes]

* `tx` es asíncrono y devuelve una promesa. Haz siempre `await` del resultado.
* Las traducciones se realizan en tiempo de ejecución mediante una solicitud de red, por lo que hay un retraso en comparación con las traducciones en tiempo de compilación.
* `tx` no admite la interpolación de ICU `{variable}`. Usa literales de plantilla para insertar variables.
* Para cadenas estáticas con interpolación de variables de ICU, usa [`getGT`](/docs/node/reference/functions/get-gt) o [`msg`](/docs/node/reference/functions/msg) con [`getMessages`](/docs/node/reference/functions/get-messages).