# vue: InitializeGTSPAOptions
URL: https://generaltranslation.com/es/docs/vue/reference/types/initialize-gt-spa-options.mdx
---

title: InitializeGTSPAOptions
description: Configura el singleton exclusivo del navegador para las traducciones precargadas a nivel de módulo. Referencia de la API de InitializeGTSPAOptions.

---

Pasa este objeto a [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa). Amplía [`CreateGTOptions`](/docs/vue/reference/types/create-gt-options) con la lista de configuraciones regionales y los alias que pueden leerse directamente de `gt.config.json`.

## Descripción general [#overview]

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

| Opción                                  | Descripción                                                                                                                                              | Tipo                                                                  | Opcional | Predeterminado                   |
| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | -------- | -------------------------------- |
| [`defaultLocale`](#defaultlocale)       | Configuración regional de origen y de contenido alternativo.                                                                                              | `string`                                                              | Sí       | `en`                             |
| [`loadTranslations`](#loadtranslations) | Cargador asíncrono del catálogo de destino.                                                                                                              | [`LoadTranslations`](/docs/vue/reference/types/load-translations)     | Sí       | Catálogo vacío                   |
| [`locale`](#locale)                     | Configuración regional inicial explícita.                                                                                                                | `string`                                                              | Sí       | Cookie; después, `defaultLocale` |
| [`localeCookieName`](#localecookiename) | Cookie utilizada para conservar la selección de configuración regional.                                                                                  | `string`                                                              | Sí       | `generaltranslation.locale`      |
| [`customMapping`](#custommapping)       | Objeto que asigna valores `code` usados para la coincidencia de configuraciones regionales y la resolución de la configuración regional del formateador. | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Sí       | Ninguno                          |
| [`locales`](#locales)                   | Configuraciones regionales de destino compatibles con esta SPA.                                                                                          | `readonly string[]`                                                   | Sí       | Sin restricciones                |

## Opciones compartidas [#shared-options]

### `defaultLocale`

**Tipo** `string` · **Opcional** · **Predeterminado** `en`

La configuración regional de origen y de contenido alternativo. Se incluye automáticamente en el conjunto de configuraciones regionales compatibles y usa el contenido de origen en lugar de llamar al cargador.

### `loadTranslations`

**Tipo** [`LoadTranslations`](/docs/vue/reference/types/load-translations) · **Opcional** · **Predeterminado** catálogo de destino vacío

Carga un catálogo de destino completo. La inicialización de la SPA espera a que se cargue el catálogo de la configuración regional activa antes de resolverse. Si se rechaza, se registra un diagnóstico, se rechaza la inicialización y una llamada de inicialización posterior puede volver a intentarlo.

### `locale`

**Tipo** `string` · **Opcional** · **Predeterminado**: cookie del navegador; después, `defaultLocale`

Configuración regional inicial explícita. Tiene prioridad sobre la cookie, se resuelve según `locales` y se conserva. La página actual fija esa configuración regional resuelta hasta que se recarga el documento.

### `localeCookieName`

**Tipo** `string` · **Opcional** · **Predeterminado** `generaltranslation.locale`

Especifica la cookie de sesión para toda la ruta, que se lee durante la inicialización y se escribe antes de recargar la configuración regional de la SPA.

## Opciones de SPA [#spa-options]

### `customMapping`

**Tipo** `Record<string, string | Partial<LocaleProperties>>` · **Opcional** · **Predeterminado** ninguno

Declara alias de configuración regional de tu configuración de General Translation. La SPA usa un `code` válido en un mapeo de objetos para la coincidencia con configuraciones regionales compatibles y como configuración regional del formateador que usan el contenido enriquecido y los componentes de formateador. `gt-vue` no lee los valores de cadena ni otras propiedades de un mapeo de objetos.

Las rutas del cargador siguen recibiendo la grafía de la entrada configurada de `defaultLocale` o `locales` que coincidió.

### `locales`

**Tipo** `readonly string[]` · **Opcional** · **Predeterminado** sin restricciones

Configuraciones regionales de destino declaradas por la aplicación. El inicializador elimina los duplicados de `[defaultLocale, ...locales]`, compara las solicitudes sin distinguir mayúsculas de minúsculas y mediante la resolución de configuración regional canónica, y usa `defaultLocale` como alternativa cuando no hay ninguna configuración regional configurada que coincida.

Cuando se omite esta opción, no se rechazan los códigos de configuración regional distintos del predeterminado. Las variantes en el uso de mayúsculas y minúsculas o los alias de `defaultLocale` se siguen resolviendo con la grafía predeterminada configurada.

## Comportamiento de singleton [#singleton]

Solo las opciones del primer intento de inicialización crean el runtime para toda la página. Las llamadas simultáneas comparten ese intento. Una vez que tiene éxito, las llamadas posteriores devuelven el plugin existente y no aplican los nuevos valores de las opciones.

Si el primer intento falla, se elimina su entrada de singleton en curso y una llamada posterior puede volver a intentarlo con nuevas opciones.

## Ejemplo [#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);
});
```

Esta API es exclusiva del navegador. Para el renderizado del lado del servidor, usa [`CreateGTOptions`](/docs/vue/reference/types/create-gt-options) con [`createGT()`](/docs/vue/reference/functions/create-gt).