# node: tx
URL: https://generaltranslation.com/it/docs/node/api/strings/tx.mdx
---
title: tx
description: riferimento API della funzione tx per la traduzione delle stringhe a runtime
---

## Panoramica

La funzione `tx` traduce le stringhe a runtime. A differenza di [`getGT`](/docs/node/api/get-gt), che risolve le traduzioni in fase di build, `tx` invia il contenuto per una traduzione su richiesta, quindi può tradurre stringhe note solo a runtime.

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

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

<Callout>
  **Traduzione Runtime:**
  `tx` esegue la traduzione on demand, quindi comporta una richiesta di rete e una latenza rispetto alla traduzione in fase di build.
  Usa [`getGT`](/docs/node/api/get-gt) per le stringhe note già in fase di build e `tx` solo quando il contenuto è dinamico o non è noto in anticipo.
</Callout>

## Riferimento

### Parametri

| Nome       | Tipo                                                                            | Descrizione                                                   |
| ---------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------- |
| `content`  | `string`                                                                        | La stringa da tradurre.                                       |
| `options?` | [`RuntimeTranslationOptions`](/docs/next/api/types/runtime-translation-options) | Opzioni per personalizzare il comportamento della traduzione. |

### Restituisce

`Promise<string>` — la stringa tradotta, oppure la stringa sorgente se non è necessaria alcuna traduzione.

***

## Esempi

### Utilizzo di base

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

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

### Con variabili

Poiché `tx` traduce le stringhe a runtime, inserisci le variabili direttamente nella stringa usando i template literal. Questo garantisce che i valori delle variabili siano inclusi nel contenuto inviato per la traduzione:

```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` non interpola i segnaposto `{variable}`.**
  A differenza di [`getGT`](/docs/node/api/get-gt), che usa il formato dei messaggi ICU (sintassi `{name}`), `tx` tratta la stringa come una stringa semplice.
  Usa i template literal di JavaScript (`` `Hello, ${name}` ``) per includere variabili.
</Callout>

### Con `$context`

Aggiungi `$context` per aiutare a disambiguare le traduzioni:

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

### Specificare l&#39;impostazione regionale

Sovrascrivi l&#39;impostazione regionale definita con [`withGT`](/docs/node/api/with-gt):

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

***

## Note

* `tx` è asincrono e restituisce una Promise. Usa sempre `await` sul risultato.
* Le traduzioni avvengono a runtime tramite una richiesta di rete, quindi c&#39;è un ritardo rispetto alle traduzioni eseguite in fase di build.
* `tx` **non** supporta l&#39;interpolazione ICU `{variable}`. Usa i template literal per inserire le variabili.
* Per le stringhe statiche con interpolazione di variabili ICU, usa [`getGT`](/docs/node/api/get-gt) o [`msg`](/docs/node/api/strings/msg) / [`getMessages`](/docs/node/api/get-messages).

## Passaggi successivi

* Vedi [`getGT`](/docs/node/api/get-gt) per la traduzione delle stringhe in fase di build.
* Vedi [`RuntimeTranslationOptions`](/docs/next/api/types/runtime-translation-options) per personalizzare il comportamento della traduzione.
* Vedi [Pattern di traduzione delle stringhe](/docs/node/guides/strings) per confrontare tutti gli approcci alla traduzione.