# vue: LoadTranslations
URL: https://generaltranslation.com/it/docs/vue/reference/types/load-translations.mdx
---
title: LoadTranslations
description: Carica il catalogo completo delle traduzioni per l'impostazione regionale richiesta. Riferimento API per LoadTranslations.

---

Passa questo callback a [`createGT()`](/docs/vue/reference/functions/create-gt) o [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa) quando i cataloghi di destinazione si trovano nei file dell'applicazione, in un database, in un'API o su un altro host.

## Panoramica [#overview]

```ts
type LoadTranslations = (
  locale: string
) => Promise<TranslationCatalog>;
```

Il plugin richiama il loader solo per le impostazioni regionali di destinazione non presenti nella cache. L&#39;impostazione regionale predefinita usa il testo sorgente e non richiama mai il loader.

## Parametri [#parameters]

| Parametro | Descrizione                                                    | Tipo     | Facoltativo | Predefinito |
| --------- | -------------------------------------------------------------- | -------- | ----------- | ----------- |
| `locale`  | Impostazione regionale di cui restituire il catalogo completo. | `string` | No          | —           |

Un normale plugin [`createGT()`](/docs/vue/reference/functions/create-gt) trasmette l&#39;impostazione regionale richiesta senza modificarla. Un plugin [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa) risolve innanzitutto l&#39;impostazione regionale rispetto a `locales` e `customMapping` configurati, mantenendo la grafia configurata nei percorsi dei file.

## Valore restituito [#returns]

**Tipo** `Promise<`[`TranslationCatalog`](/docs/vue/reference/types/translation-catalog)`>`

Si risolve con il catalogo completo indicizzato per hash per `locale`. Si risolve con `{}` quando non sono disponibili traduzioni e l&#39;applicazione deve usare il contenuto sorgente.

Non restituire `null`, `undefined` né un valore parziale con una shape diversa. Il tipo pubblico della callback richiede un oggetto catalogo.

## Comportamento di caricamento [#loading-behavior]

* Un risultato ottenuto correttamente viene memorizzato nella cache per l&#39;intera durata del plugin.
* I caricamenti simultanei della stessa impostazione regionale condividono la stessa promessa.
* `plugin.loadTranslations(locale)` precarica senza modificare l&#39;impostazione regionale attiva.
* `plugin.setLocale(locale)` reattivo carica le traduzioni prima di cambiare impostazione regionale.
* [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa) carica l&#39;impostazione regionale di destinazione iniziale prima che la relativa promessa venga risolta.
* L&#39;installazione di un plugin [`createGT()`](/docs/vue/reference/functions/create-gt) avvia in background il caricamento iniziale dell&#39;impostazione regionale di destinazione, consentendo di renderizzare prima il contenuto sorgente.

## Errori [#failures]

Quando il callback restituisce una rejection, `gt-vue` registra una diagnostica, rilancia lo stesso errore, rimuove la voce in corso e non memorizza il risultato nella cache. Una chiamata successiva può riprovare.

Di conseguenza, una chiamata imperativa a `loadTranslations()`, una modifica reattiva dell&#39;impostazione regionale o l&#39;inizializzazione della SPA restituiscono una rejection. Il caricamento in background avviato da `app.use(createGT(...))` intercetta la rejection dopo averla registrata, consentendo all&#39;applicazione di continuare a utilizzare il contenuto sorgente.

## Esempio [#example]

```ts title="src/loadTranslations.ts"
import type { LoadTranslations } from 'gt-vue';

const loadTranslations: LoadTranslations = async (locale) => {
  try {
    return (await import(`./_gt/${locale}.json`)).default;
  } catch (error) {
    console.error(`No translation catalog for ${locale}`, error);
    return {};
  }
};

export default loadTranslations;
```

Il loader riportato sopra tratta i file mancanti come un catalogo vuoto valido. Rimuovi `try`/`catch` se un catalogo mancante o non valido deve interrompere l&#39;inizializzazione.