# vue: InitializeGTSPAOptions
URL: https://generaltranslation.com/it/docs/vue/reference/types/initialize-gt-spa-options.mdx
---
title: InitializeGTSPAOptions
description: Configura il singleton esclusivo del browser utilizzato per le traduzioni a livello di modulo precaricate. Riferimento API per InitializeGTSPAOptions.

---

Passa questo oggetto a [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa). Estende [`CreateGTOptions`](/docs/vue/reference/types/create-gt-options) con l'elenco delle impostazioni regionali e gli alias leggibili direttamente da `gt.config.json`.

## Panoramica [#overview]

```ts
type InitializeGTSPAOptions = CreateGTOptions & {
  customMapping?: CustomMapping;
  locales?: readonly string[];
};
```

| Opzione                                 | Descrizione                                                                                                                                                     | Tipo                                                                  | Facoltativo | Predefinito                    |
| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | ----------- | ------------------------------ |
| [`defaultLocale`](#defaultlocale)       | Impostazione regionale sorgente e di fallback.                                                                                                                  | `string`                                                              | Sì          | `en`                           |
| [`loadTranslations`](#loadtranslations) | Loader asincrono del catalogo delle impostazioni regionali di destinazione.                                                                                     | [`LoadTranslations`](/docs/vue/reference/types/load-translations)     | Sì          | Catalogo vuoto                 |
| [`locale`](#locale)                     | Impostazione regionale iniziale esplicita.                                                                                                                      | `string`                                                              | Sì          | Cookie, quindi `defaultLocale` |
| [`localeCookieName`](#localecookiename) | Cookie utilizzato per salvare la selezione dell'impostazione regionale.                                                                                     | `string`                                                              | Sì          | `generaltranslation.locale`    |
| [`customMapping`](#custommapping)       | Oggetto che associa i valori `code` usati per la corrispondenza delle impostazioni regionali e la risoluzione dell'impostazione regionale del formattatore. | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Sì          | Nessuno                        |
| [`locales`](#locales)                   | Impostazioni regionali di destinazione supportate da questa SPA.                                                                                                | `readonly string[]`                                                   | Sì          | Senza restrizioni              |

## Opzioni condivise [#shared-options]

### `defaultLocale`

**Tipo** `stringa` · **Facoltativo** · **Predefinito** `en`

L'impostazione regionale sorgente e di fallback. Viene inclusa automaticamente nell'insieme delle lingue supportate e utilizza il contenuto sorgente anziché richiamare il loader.

### `loadTranslations`

**Tipo** [`LoadTranslations`](/docs/vue/reference/types/load-translations) · **Facoltativo** · **Predefinito** catalogo vuoto

Carica un catalogo completo per la lingua di destinazione. L'inizializzazione della SPA attende il catalogo dell'impostazione regionale attiva prima di completarsi. In caso di rifiuto, viene registrato un messaggio diagnostico, l'inizializzazione viene rifiutata e una successiva chiamata di inizializzazione può riprovare.

### `locale`

**Tipo** `stringa` · **Facoltativo** · **Predefinito** cookie del browser, quindi `defaultLocale`

Impostazione regionale iniziale esplicita. Ha la precedenza sul cookie, viene risolta in base a `locales` e mantenuta. La pagina corrente blocca quindi l'impostazione regionale così risolta fino al ricaricamento del documento.

### `localeCookieName`

**Type** `stringa` · **Facoltativo** · **Predefinito** `generaltranslation.locale`

Specifica il cookie di sessione valido per l'intero percorso, letto durante il bootstrap e scritto prima del ricaricamento dell'impostazione regionale della SPA.

## Opzioni SPA [#spa-options]

### `customMapping`

**Tipo** `Record<string, string | Partial<LocaleProperties>>` · **Facoltativo** · **Predefinito** nessuno

Dichiara gli alias delle impostazioni regionali della configurazione di General Translation. La SPA utilizza un `code` valido in una mappatura di oggetti per la corrispondenza con le impostazioni regionali supportate e per l&#39;impostazione regionale del formatter utilizzata da contenuti avanzati e componenti formatter. I valori stringa e le altre proprietà presenti in una mappatura di oggetti non vengono letti da `gt-vue`.

I percorsi del loader ricevono comunque la grafia dalla voce `defaultLocale` o `locales` configurata che ha trovato corrispondenza.

### `locales`

**Tipo** `readonly string[]` · **Facoltativo** · **Predefinito** senza restrizioni

Impostazioni regionali di destinazione dichiarate dall&#39;applicazione. L&#39;inizializzatore rimuove i duplicati da `[defaultLocale, ...locales]`, confronta le richieste ignorando maiuscole e minuscole e tramite la risoluzione dell&#39;impostazione regionale canonica, e usa `defaultLocale` come fallback quando non corrisponde alcuna impostazione regionale configurata.

Quando questa opzione viene omessa, i codici locale diversi da quello predefinito non vengono rifiutati. Varianti di maiuscole e minuscole equivalenti o alias di `defaultLocale` vengono comunque risolti nella grafia predefinita configurata.

## Comportamento del singleton [#singleton]

Solo le opzioni del primo tentativo di inizializzazione determinano il runtime a livello di pagina. Le chiamate simultanee condividono quel tentativo. Una volta completato con successo, le chiamate successive restituiscono il plugin esistente e non applicano nuovi valori delle opzioni.

Se il primo tentativo viene rifiutato, la relativa voce singleton in corso viene rimossa e una chiamata successiva può riprovare con nuove opzioni.

## Esempio [#example]

```ts title="src/index.ts"
import { initializeGTSPA } from 'gt-vue';
import type { InitializeGTSPAOptions } from 'gt-vue';
import gtConfig from '../gt.config.json';
import loadTranslations from './loadTranslations';

const options: InitializeGTSPAOptions = {
  defaultLocale: gtConfig.defaultLocale,
  locales: gtConfig.locales,
  customMapping: gtConfig.customMapping,
  loadTranslations,
};

async function bootstrap() {
  const gt = await initializeGTSPA(options);
  const { mount } = await import('./main');
  mount(gt);
}

void bootstrap().catch((error: unknown) => {
  console.error(error);
});
```

Questa API è disponibile solo nel browser. Per il rendering sul server, usa [`CreateGTOptions`](/docs/vue/reference/types/create-gt-options) con [`createGT()`](/docs/vue/reference/functions/create-gt).