# gt-node: General Translation Node.js SDK: getGT
URL: https://generaltranslation.com/it/docs/node/reference/functions/get-gt.mdx
---

title: getGT
description: Ottieni una funzione di General Translation per l'impostazione regionale della richiesta corrente, per tradurre stringhe inline. Riferimento API per getGT.

---

Una funzione asincrona che restituisce una funzione di traduzione per l'impostazione regionale della richiesta corrente. Recupera le traduzioni registrate in fase di build-time dal compiler di General Translation e, se non ne trova alcuna, usa la stringa sorgente.

## Panoramica [#overview]

Usa `await` con `getGT` all'interno di un contesto [`withGT`](/docs/node/reference/functions/with-gt) per ottenere una funzione sincrona `gt(message, options?)`, quindi usala per tradurre le stringhe.

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

const gt = await getGT();
const greeting = gt('Hello, world!');
```

Firma:

```ts
getGT(): Promise<GTFunctionType>

type GTFunctionType = (message: string, options?: GTTranslationOptions) => string;
```

*Nota: `getGT` deve essere chiamato all&#39;interno di un callback di [`withGT`](/docs/node/reference/functions/with-gt), così da sapere quale impostazione regionale usare. Accetta anche un argomento interno `_messages`, usato dal compiler per l&#39;hot reload durante lo sviluppo; non devi passarlo direttamente.*

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

* **Traduzioni build-time.** `getGT` restituisce una funzione di traduzione build-time. Le stringhe vengono tradotte durante il processo di CD prima della distribuzione, quindi in produzione le richieste usano traduzioni memorizzate nella cache senza dover effettuare un round trip di rete.
* **Sviluppo.** In sviluppo, le traduzioni avvengono su richiesta e richiedono una chiave API di sviluppo.
* **Fallback.** Se non viene trovata alcuna traduzione, viene restituita la stringa sorgente originale (interpolata).
* **Interpolazione.** Usa i segnaposto `{variableName}` nella stringa e passa i valori nell&#39;oggetto options. `gt-node` supporta [ICU message format](https://unicode-org.github.io/icu/userguide/format_parse/messages/) per la formattazione avanzata.

## Parametri [#parameters]

`getGT` non accetta parametri. La funzione `gt` restituita accetta:

| Parametro             | Descrizione                                          | Tipo                   | Facoltativo | Predefinito |
| --------------------- | ---------------------------------------------------- | ---------------------- | ----------- | ----------- |
| [`message`](#message) | La stringa da tradurre.                              | `string`               | No          | —           |
| [`options`](#options) | Variabili di interpolazione e opzioni di traduzione. | `GTTranslationOptions` | Sì          | `{}`        |

### `message` [#message]

**Tipo** `string` · **Obbligatorio**

La stringa da tradurre. Può contenere segnaposto `{variable}` per l’interpolazione ICU.

### `options` [#options]

**Tipo** `GTTranslationOptions` · **Facoltativo**

Opzioni di traduzione e variabili di interpolazione:

* `$context?: string` — contesto aggiuntivo per aiutare a disambiguare le traduzioni.
* `$id?: string` — un ID personalizzato per l&#39;entry di traduzione.
* `$locale?: string` — sovrascrive l&#39;impostazione regionale della richiesta per questa chiamata.
* `$format?: string` — il formato del messaggio. Il valore predefinito è `'ICU'`.
* `$maxChars?: number` — numero massimo di caratteri per la traduzione.
* `$requiresReview?: boolean` — indica se la traduzione deve essere approvata prima dell&#39;uso.
* Qualsiasi altra key viene trattata come un valore da interpolare nella stringa usando la sintassi `{key}`.

## Restituisce [#returns]

**Tipo** `Promise<GTFunctionType>`

Restituisce la funzione di traduzione `gt`. La chiamata a `gt(message, options?)` restituisce la stringa tradotta oppure, se non viene trovata alcuna traduzione, la stringa originale (interpolata).

## Esempi [#examples]

```ts title="handler.js"
// Traduzione semplice
import { withGT, getGT } from 'gt-node';

function handleRequest(locale) {
  return withGT(locale, async () => {
    const gt = await getGT();
    return gt('Hello, world!');
  });
}
```

```ts title="handler.js"
// Con variabili — usa {name} nella stringa e passa i valori nell'oggetto options
import { withGT, getGT } from 'gt-node';

function handleGreeting(locale, name) {
  return withGT(locale, async () => {
    const gt = await getGT();
    return gt('Hello, {name}!', { name });
  });
}
```

```ts title="handler.js"
// Con il formato ICU message format
const gt = await getGT();
const balance = gt(
  'Your balance: {amount, number, ::currency/USD}',
  { amount: 1234.56 }
);
```

## Note [#notes]

* `getGT` restituisce una funzione di traduzione build-time; le stringhe vengono tradotte durante il processo di CD prima della distribuzione.
* In sviluppo, le traduzioni avvengono on demand e richiedono una chiave API di sviluppo.
* Se non viene trovata alcuna traduzione, come fallback viene restituita la stringa originale.
* Per le stringhe note solo a runtime, usa [`tx`](/docs/node/reference/functions/tx); per le stringhe registrate a livello di modulo, usa [`msg`](/docs/node/reference/functions/msg) con [`getMessages`](/docs/node/reference/functions/get-messages).