# gt-node: General Translation Node.js SDK: Traduzione delle stringhe
URL: https://generaltranslation.com/it/docs/node/guides/translating-strings.mdx
---
title: Traduzione delle stringhe
description: Come tradurre le stringhe negli handler, i messaggi registrati e il contenuto dinamico con General Translation in gt-node.
related:
  links:
    - /docs/node/guides/detecting-locale
    - /docs/node/guides/storing-translations
    - /docs/node/guides/configuring

---

`gt-node` offre tre modi per tradurre una stringa. La scelta dipende da dove si trova la stringa e dal fatto che sia nota in anticipo oppure no.

*Nota: tutti e tre vengono eseguiti all'interno di un contesto [`withGT`](/docs/node/guides/detecting-locale), così possono conoscere l'impostazione regionale della richiesta.*

## Traduci le stringhe dell'handler con `getGT` [#get-gt]

Per le stringhe scritte direttamente in un handler, usa `await` con [`getGT`](/docs/node/reference/functions/get-gt) per ottenere una funzione di traduzione, quindi chiamala. Interpola i valori con i segnaposto ICU.

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

app.get('/api/greeting', async (req, res) => {
  const gt = await getGT();
  res.json({
    message: gt('Hello, world!'),
    welcome: gt('Welcome, {name}!', { name: 'Alice' }),
  });
});
```

Questa è la scelta predefinita per le stringhe una tantum. Aggiungi `$context` per disambiguare un termine.

## Riutilizza i messaggi registrati con `msg` [#msg]

Per le stringhe definite al di fuori di un handler — costanti condivise, messaggi di errore, enum — registrale con [`msg`](/docs/node/reference/functions/msg) nell'ambito del modulo, quindi recuperale con [`getMessages`](/docs/node/reference/functions/get-messages).

```ts
import { msg, getMessages } from 'gt-node';

const NOT_FOUND = msg('Resource not found.');

app.use(async (req, res) => {
  const m = await getMessages();
  res.status(404).json({ error: m(NOT_FOUND) });
});
```

## Traduci il contenuto dinamico con `tx` [#tx]

Per i contenuti che non sono noti in anticipo e non vengono pregenerati, usa [`tx`](/docs/node/reference/functions/tx) per tradurre a runtime. Effettua una richiesta di rete in caso di cache miss, quindi riservalo alle stringhe davvero dinamiche.

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

const translated = await tx(`Status: ${status}`);
```

*Nota: `tx` non usa segnaposto ICU: inserisci i valori con un template literal prima di chiamarlo.*

## Scegli un approccio [#choose]

* Stringhe one-off negli handler → `getGT`.
* Costanti ed errori condivisi → `msg` con `getMessages`.
* Contenuti dinamici e imprevedibili → `tx`.
* Testi centralizzati basati su chiavi → un dizionario con [`getTranslations`](/docs/node/reference/functions/get-translations).
## Next steps

- /docs/node/guides/detecting-locale
- /docs/node/guides/storing-translations
- /docs/node/guides/configuring