# 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 de la función tx para traducir cadena
---

## Resumen

La función `tx` se ejecuta del lado del servidor y sirve para traducir cadenas.

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

<Callout>
  **Traducción en tiempo de ejecución:**
  Las traducciones `tx` se realizan en tiempo de ejecución.
  Esto significa que la traducción se realiza en tiempo real, por lo que puedes traducir contenido disponible en tiempo de ejecución.
</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 es necesaria ninguna traducción.

***

## Comportamiento

La función `tx` traduce cadena en tiempo de ejecución.
Esto significa que las traducciones se realizan en tiempo real, por lo que puedes traducir contenido que solo se conoce en tiempo de ejecución.
La contrapartida es que debes esperar a que se cargue una traducción bajo demanda, 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: 'Traducir de forma informal' // [!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 una configuración regional que se usará para la traducción.
Por defecto, 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 tiempo de ejecución, 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 cadena antes de desplegar.
* 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 obtener más información sobre cómo personalizar las traducciones.