# node: getTranslations
URL: https://generaltranslation.com/it/docs/node/api/get-translations.mdx
---
title: getTranslations
description: Riferimento API per la funzione getTranslations di traduzione del dizionario
---

## Panoramica

`getTranslations` restituisce una funzione di traduzione `t` che recupera le voci da un [dizionario](/docs/next/guides/dictionaries).
Usala per tradurre stringhe predefinite in base alla relativa chiave nel dizionario.

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

const t = await getTranslations();
t('greeting.hello'); // "Hello!"
```

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

## Riferimento

### Parametri

Nessuno.

### Restituisce

Una promise che si risolve in una funzione di traduzione `t`:

```ts
Promise<TFunctionType>
```

La funzione `t` accetta una chiave del dizionario e opzioni di interpolazione facoltative:

| Name       | Type                           | Description                                               |
| ---------- | ------------------------------ | --------------------------------------------------------- |
| `id`       | `string`                       | Il percorso separato da punti di una voce del dizionario. |
| `options?` | `DictionaryTranslationOptions` | Variabili per l&#39;interpolazione.                       |

**Restituisce:** `string` — il testo tradotto (o, in fallback, il testo nella lingua di origine).

Se la chiave non esiste nel dizionario sorgente, `t()` genera un errore.
Se la chiave esiste nel dizionario sorgente ma non ha una traduzione per l&#39;impostazione regionale corrente, `t()` restituisce il testo di origine.

### `t.obj()`

Restituisce l&#39;intero sottoalbero del dizionario come oggetto, anziché come una singola stringa.

```ts
t.obj(id: string): DictionaryObjectTranslation
```

| Nome | Tipo     | Descrizione                                                      |
| ---- | -------- | ---------------------------------------------------------------- |
| `id` | `string` | Il percorso, separato da punti, a un sottoalbero del dizionario. |

**Restituisce:** Un oggetto annidato che rispecchia la struttura del dizionario, con valori tradotti dove disponibili e fallback in lingua di origine negli altri casi.

***

## Configurazione

### Automatico (consigliato)

Crea un file `dictionary.json` nella cartella principale del progetto:

```json title="dictionary.json"
{
  "greeting": {
    "hello": "Hello!"
  },
  "user": {
    "welcome": "Welcome, {name}!"
  }
}
```

Quando esegui `npx gtx translate`, la CLI rileva automaticamente `dictionary.json` e lo traduce per le impostazioni regionali che hai configurato.

Quindi inizializza GT con il dizionario:

```ts
import { initializeGT } from 'gt-node';
import dictionary from './dictionary.json';

initializeGT({
  dictionary,
  defaultLocale: 'en-US',
  locales: ['en-US', 'es', 'fr'],
});
```

### Caricatore di dizionari personalizzato

Se gestisci i tuoi dizionari tradotti, passa una funzione `loadDictionary` a [`initializeGT`](/docs/node/api/initialize-gt):

```ts
import { initializeGT } from 'gt-node';
import dictionary from './dictionary.json';

initializeGT({
  dictionary,
  loadDictionary: async (locale) => {
    const dict = await import(`./locales/${locale}.json`);
    return dict.default;
  },
});
```

Le traduzioni caricate tramite `loadDictionary` hanno priorità rispetto a quelle generate da GT.

***

## Esempi

### Uso di base

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

const t = await getTranslations();
t('greeting.hello'); // "Hello!"
```

### Interpolazione di variabili

```ts
const t = await getTranslations();
t('user.welcome', { name: 'Alice' }); // "Benvenuta, Alice!"
```

### Ricerca di oggetti con `t.obj()`

```ts
const t = await getTranslations();

const errors = t.obj('errors');
// { notFound: "Pagina non trovata", unauthorized: "Accesso negato" }
```

***

## Note

* `getTranslations` è la controparte basata su un dizionario di [`getMessages`](/docs/node/api/get-messages), usato per le stringhe `msg()` inline.
* Per l&#39;equivalente in Next.js, vedi [`getTranslations` in gt-next](/docs/next/api/dictionary/get-translations).