# gt-node: General Translation Node.js SDK: tx
URL: https://generaltranslation.com/it/docs/node/reference/functions/tx.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Traduce una stringa su richiesta a runtime con General Translation. Riferimento API per tx.

Traduce stringhe a runtime. A differenza di [`getGT`](/docs/node/reference/functions/get-gt), che recupera traduzioni build-time, `tx` invia il contenuto per la traduzione su richiesta, quindi può tradurre stringhe disponibili solo a runtime.

## Panoramica [#overview]

Usa `await` con `tx` all'interno di uno scope [`withGT`](/docs/node/reference/functions/with-gt), passando la stringa da tradurre. Restituisce la stringa tradotta.

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

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

Firma:

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

*Nota: `tx` esegue la traduzione su richiesta, il che comporta una richiesta di rete e un certo ritardo rispetto alla traduzione build-time. Usa [`getGT`](/docs/node/reference/functions/get-gt) per le stringhe note in fase di build e `tx` solo quando il contenuto è dinamico o non è noto in anticipo.*

## Come funziona [#how-it-works]

* **Traduzione a runtime.** Le traduzioni avvengono a runtime tramite una richiesta di rete in caso di cache miss, quindi c&#39;è un ritardo rispetto alla traduzione build-time. Riserva `tx` per i contenuti dinamici.
* **Nessuna interpolazione ICU.** A differenza di [`getGT`](/docs/node/reference/functions/get-gt), `tx` non interpola i segnaposto `{variable}` — tratta la stringa come testo semplice. Inserisci le variabili con i template literal di JavaScript, così i loro valori saranno inclusi nel contenuto inviato per la traduzione.
* **Fallback.** Restituisce la stringa originale se non è necessaria alcuna traduzione.

## Parametri [#parameters]

| Parametro             | Descrizione                                                   | Tipo                        | Facoltativo | Predefinito |
| --------------------- | ------------------------------------------------------------- | --------------------------- | ----------- | ----------- |
| [`content`](#content) | La stringa da tradurre.                                       | `string`                    | No          | —           |
| [`options`](#options) | Opzioni per personalizzare il comportamento della traduzione. | `RuntimeTranslationOptions` | Sì          | —           |

### `content` [#content]

**Tipo** `stringa` · **Obbligatorio**

La stringa da tradurre. Inserisci i valori dinamici con i template literal anziché con i segnaposto `{variable}`.

### `options` [#options]

**Tipo** `RuntimeTranslationOptions` · **Facoltativo**

Opzioni per personalizzare la traduzione a runtime:

* `$context?: string` — contesto aggiuntivo per aiutare a chiarire le traduzioni.
* `$locale?: string` — sovrascrive l&#39;impostazione regionale definita da [`withGT`](/docs/node/reference/functions/with-gt).
* `$maxChars?: number` — numero massimo intero positivo richiesto al servizio di traduzione. La stringa restituita viene troncata a questa lunghezza, se necessario.
* `$requiresReview?: boolean` — indica se la traduzione richiede l&#39;approvazione prima dell&#39;uso.

*Nota: `RuntimeTranslationOptions` è simile alle opzioni inline di [`getGT`](/docs/node/reference/functions/get-gt), ma senza `$id`; inoltre, per `$format` il valore predefinito è plain-string (non ICU) anziché ICU.*

## Restituisce [#returns]

**Tipo** `Promise<string>`

Si risolve con la stringa tradotta o, se non è necessaria alcuna traduzione, con la stringa originale.

## Esempi [#examples]

```ts title="handler.js"
// Utilizzo di base
import { withGT, tx } from 'gt-node';

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

```ts title="handler.js"
// Con variabili — incorpora i valori con template literal, non con {segnaposto}
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 contesto per disambiguare le traduzioni
const translated = await tx('Spring', {
  $context: 'the season, not a coil',
});
```

```ts title="handler.js"
// Specificare un'impostazione regionale — sovrascrive l'impostazione regionale di withGT
const translated = await tx('Hello, world!', { $locale: 'fr' });
```

## Note [#notes]

* `tx` è asincrono e restituisce una Promise. Esegui sempre `await` sul risultato.
* Le traduzioni avvengono a runtime tramite una richiesta di rete, quindi c&#39;è un ritardo rispetto alle traduzioni build-time.
* `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/reference/functions/get-gt) o [`msg`](/docs/node/reference/functions/msg) con [`getMessages`](/docs/node/reference/functions/get-messages).

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.