# gt-next: General Translation Next.js SDK: tx
URL: https://generaltranslation.com/es/docs/next/api/strings/tx.mdx
---
title: tx
description: Referencia de la API para la función tx de traducción de cadenas
---

## Descripción general

La función `tx` es una función del lado del servidor para traducir cadenas.

```jsx
await tx('Hello, world!'); // devuelve 'Hola, mundo!'
```

<Callout>
  **Traducción en runtime:**
  Las traducciones de `tx` se realizan en runtime.
  Esto significa que la traducción se realiza en tiempo real, por lo que puedes traducir contenido disponible en runtime.
</Callout>

## Referencia

### Parámetros

<TypeTable
  type={{
  "content": {
      type: 'string',
      optional: false,
  },
  "options?": {
      type: 'RuntimeTranslationOptions',
      optional: true,
      default: '{}',
  },
}}
/>

| Nombre    | Descripción                                                                                                                                                   |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `content` | La cadena que se debe traducir.                                                                                                                               |
| `options` | Opciones de traducción para personalizar el comportamiento de `tx`. Consulta [`RuntimeTranslationOptions`](/docs/next/api/types/runtime-translation-options). |

### Devuelve

Una promesa que se resuelve en una cadena con el contenido traducido, o con el contenido original si no hace falta traducirlo.

***

## Comportamiento

La función `tx` traduce cadenas en runtime.
Esto significa que las traducciones se realizan sobre la marcha, por lo que puedes traducir contenido que solo se conoce en runtime.
La desventaja es que hay que esperar a que se cargue una traducción bajo demanda, por lo que es significativamente más lento.

Nuestro consejo es que traduzcas todo lo que puedas en tiempo de compilación usando [`getGT`](/docs/next/api/strings/use-gt), [`useGT`](/docs/next/api/strings/use-gt) o [`<T>`](/docs/next/api/components/t),
y que solo uses traducciones bajo demanda, como `tx` y [`<Tx>`](/docs/next/api/components/tx), cuando sea necesario.

Asegúrate de seguir la [guía de despliegue aquí](/docs/next/tutorials/quickdeploy).

***

## Ejemplo

### Uso básico

Puedes usar `tx` para traducir cadenas.

```javascript title="src/components/translateGreeting.jsx" copy
import { tx } from 'gt-next/server';

export default async function translateGreeting() {
    return await tx("Hello, world!"); // [!code highlight]
}
```

### Añadir contexto

Puedes personalizar la traducción proporcionando un contexto que se tenga en cuenta al traducir.

```javascript title="TranslateWithOptions.jsx" copy
import { tx } from 'gt-next/server';

export default async function TranslateWithOptions() {
    return await tx("Hello, world!", {
      $context: 'Translate informally' // [!code highlight]
    });
}
```


### Uso de variables

Para pasar valores a tu cadena, debes (1) asignar un identificador y (2) hacer referencia a ese identificador en el objeto que se pasa.

```jsx title="translateWithVariables.js" copy
// [!code word:price]
import { tx } from 'gt-next/server';

export default async function translateWithVariables() {
  return await tx("The cost is {price, number, ::currency/USD}", {
    price: 29.99,
  });
}
```


### Especificar una configuración regional

Puedes especificar la configuración regional que se usará para la traducción.
De forma predeterminada, la configuración regional se establece según el idioma preferido del usuario.

```jsx title="translateWithLocale.js" copy
import { tx } from 'gt-next/server';

export default async function translateWithLocale() {
    return await tx("Hello, world!", { $locale: 'fr' }); // [!code highlight]
}
```

***


## Notas

* `tx` es de uso exclusivo del lado del servidor y no puede usarse en componentes del lado del cliente.
* Las traducciones con `tx` se realizan en runtime, es decir, se traducen en tiempo real. Esto es considerablemente más lento que las traducciones en tiempo de compilación.

## Siguientes pasos

* Consulta [`useGT`](/docs/next/api/strings/use-gt) y [`getGT`](/docs/next/api/strings/get-gt) para traducir cadenas antes del despliegue.
* Para traducir JSX, consulta [`<T>`](/docs/next/api/components/t) y [`<Tx>`](/docs/next/api/components/tx).
* Consulta [`RuntimeTranslationOptions`](/docs/next/api/types/runtime-translation-options) para más información sobre cómo personalizar las traducciones.