# node: getGT
URL: https://generaltranslation.com/it/docs/node/api/get-gt.mdx
---
title: getGT
description: Riferimento API per la funzione getGT per la traduzione delle stringhe
---

## Panoramica

La funzione `getGT` è una funzione asincrona che restituisce una funzione di traduzione per tradurre le stringhe.
Recupera le traduzioni registrate in fase di build dal compilatore GT.

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

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

<Callout>
  **Contesto della richiesta obbligatorio:**
  `getGT` deve essere chiamato all&#39;interno di un callback [`withGT`](/docs/node/api/with-gt) affinché sappia quale impostazione regionale usare.
</Callout>


## Guida di riferimento

### Parametri

Nessuno.

### Restituisce

Una promise che restituisce una funzione di traduzione `gt`:

```ts
Promise<(content: string, options?: InlineTranslationOptions) => string>
```

| Nome       | Tipo                       | Descrizione                                                    |
| ---------- | -------------------------- | -------------------------------------------------------------- |
| `content`  | `string`                   | La stringa da tradurre.                                        |
| `options?` | `InlineTranslationOptions` | Opzioni di traduzione facoltative (variabili, contesto, ecc.). |

La funzione `gt` restituisce la stringa tradotta oppure, se non viene trovata alcuna traduzione, la stringa originale.


#### `InlineTranslationOptions`

| Prop         | Type     | Descrizione                                                                     |
| ------------ | -------- | ------------------------------------------------------------------------------- |
| `$context?`  | `string` | Contesto aggiuntivo per disambiguare le traduzioni.                             |
| `$id?`       | `string` | Un ID personalizzato per la voce di traduzione.                                 |
| `$maxChars?` | `number` | Numero massimo di caratteri per la traduzione.                                  |
| Other keys   | `any`    | Valori delle variabili da interpolare nella stringa usando la sintassi `{key}`. |

***

## Esempi

### Traduzione semplice

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

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


### Con variabili

Usa la sintassi `{variableName}` nella stringa e passa i valori nell&#39;oggetto delle opzioni:

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

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


### Con il formato dei messaggi ICU

`gt-node` supporta il formato dei messaggi ICU per opzioni di formattazione avanzate:

```js title="handler.js"
const gt = await getGT();
const balance = gt(
  'Your balance: {amount, number, ::currency/USD}',
  { amount: 1234.56 }
);
```

***


## Note

* `getGT` restituisce una funzione di traduzione **fase di build**. Le stringhe vengono tradotte durante il processo di CD prima del deployment.
* In fase di sviluppo, le traduzioni avvengono su richiesta (richiede una API key di sviluppo).
* Se non viene trovata alcuna traduzione, come fallback viene restituita la stringa originale.

## Passi successivi

* Vedi [`getMessages`](/docs/node/api/get-messages) per recuperare i messaggi preregistrati.
* Vedi [`withGT`](/docs/node/api/with-gt) per configurare il contesto dell&#39;impostazione regionale.