# node: tx
URL: https://generaltranslation.com/es/docs/node/api/strings/tx.mdx
---
title: tx
description: Referencia de la API para la función tx de traducción de cadenas en tiempo de ejecución
---

## Descripción general

La función `tx` traduce cadenas en tiempo de ejecución. A diferencia de [`getGT`](/docs/node/api/get-gt), que resuelve traducciones en tiempo de construcción, `tx` envía el contenido para su traducción on-demand, por lo que puede traducir cadenas que solo se conocen en tiempo de ejecución.

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

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

<Callout>
  **Traducción en tiempo de ejecución:**
  `tx` realiza la traducción bajo demanda, lo que implica una solicitud de red y cierto retraso en comparación con la traducción en tiempo de construcción.
  Usa [`getGT`](/docs/node/api/get-gt) para las cadenas que se conocen en tiempo de construcción, y `tx` solo cuando el contenido es dinámico o no se conoce de antemano.
</Callout>

## Referencia

### Parámetros

| Nombre     | Tipo                                                                            | Descripción                                                    |
| ---------- | ------------------------------------------------------------------------------- | -------------------------------------------------------------- |
| `content`  | `string`                                                                        | La cadena que se va a traducir.                                |
| `options?` | [`RuntimeTranslationOptions`](/docs/next/api/types/runtime-translation-options) | Opciones para personalizar el comportamiento de la traducción. |

### Devuelve

`Promise<string>` — la cadena traducida o la cadena fuente si no es necesario traducirla.

***

## Ejemplos

### Uso básico

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

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

### Con variables

Dado que `tx` traduce cadenas en tiempo de ejecución, inserta las variables directamente en la cadena usando literales de plantilla. Esto garantiza que los valores de las variables se incluyan en el contenido enviado para su traducción:

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

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

<Callout type="warn">
  **`tx` no interpola los marcadores de posición `{variable}`.**
  A diferencia de [`getGT`](/docs/node/api/get-gt), que usa el formato de mensaje ICU (sintaxis `{name}`), `tx` trata la cadena como una cadena simple.
  Usa literales de plantilla de JavaScript (`` `Hello, ${name}` ``) para incluir variables.
</Callout>

### Con contexto

Agrega `$context` para desambiguar las traducciones:

```js title="handler.js"
const translated = await tx('Spring', {
  $context: 'the season, not a coil',
});
```

### Especificar una configuración regional

Anula la configuración regional establecida por [`withGT`](/docs/node/api/with-gt):

```js title="handler.js"
const translated = await tx('Hello, world!', { $locale: 'fr' });
```

***

## Notas

* `tx` es asíncrono y devuelve una promesa. Usa siempre `await` con el resultado.
* Las traducciones se resuelven en tiempo de ejecución mediante una solicitud de red, por lo que hay una pequeña demora en comparación con las traducciones en tiempo de construcción.
* `tx` **no** admite 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/api/get-gt) o [`msg`](/docs/node/api/strings/msg) / [`getMessages`](/docs/node/api/get-messages).

## Próximos pasos

* Consulta [`getGT`](/docs/node/api/get-gt) para la traducción de cadenas en tiempo de construcción.
* Consulta [`RuntimeTranslationOptions`](/docs/next/api/types/runtime-translation-options) para personalizar el comportamiento de la traducción.
* Consulta [Patrones de traducción de cadenas](/docs/node/guides/strings) para comparar los distintos enfoques de traducción.