# node: initializeGT
URL: https://generaltranslation.com/es/docs/node/api/initialize-gt.mdx
---
title: initializeGT
description: Referencia de la API para la función de configuración initializeGT
---

## Descripción general

La función `initializeGT` configura General Translation para usarse en un runtime de Node.js.
Debe llamarse una vez antes de usar cualquier función de traducción.

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

initializeGT({
  defaultLocale: 'en-US',
  locales: ['en-US', 'es', 'fr'],
  projectId: 'your-project-id',
});
```

<Callout type="warn">
  **Configuración obligatoria:**
  Debes llamar a `initializeGT` antes de usar `withGT`, `getGT`, `getMessages` o cualquier otra función de traducción.
  Hazlo una sola vez durante la inicialización del servidor (por ejemplo, al principio del archivo de entrada).
</Callout>

## Referencia

### Parámetros

<TypeTable
  type={{
"defaultLocale?": {
  type: 'string',
  optional: true,
  default: "'en-US'",
},
"locales?": {
  type: 'string[]',
  optional: true,
},
"projectId?": {
  type: 'string',
  optional: true,
},
"devApiKey?": {
  type: 'string',
  optional: true,
},
"cacheUrl?": {
  type: 'string | null',
  optional: true,
},
"runtimeUrl?": {
  type: 'string | null',
  optional: true,
},
"loadTranslations?": {
  type: 'TranslationsLoader',
  optional: true,
},
"customMapping?": {
  type: 'Record<string, string | Partial<LocaleProperties>>',
  optional: true,
},
"enableI18n?": {
  type: 'boolean',
  optional: true,
},
"cacheExpiryTime?": {
  type: 'number',
  optional: true,
},
}}
/>

### Descripción

| Prop               | Descripción                                                                                                                                           |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `defaultLocale`    | La configuración regional predeterminada de tu aplicación. El valor predeterminado es `'en-US'`.                                                      |
| `locales`          | Una lista de códigos de configuración regional compatibles con tu aplicación.                                                                         |
| `projectId`        | El ID de tu proyecto de General Translation, obligatorio para los servicios de traducción en la nube.                                                 |
| `devApiKey`        | Clave de API para traducciones bajo demanda en el entorno de desarrollo.                                                                              |
| `cacheUrl`         | URL del servicio de caché de GT. Establécela en `null` para desactivarla.                                                                             |
| `runtimeUrl`       | URL del servicio de traducción runtime de GT. Establécela en `null` para desactivarla.                                                                |
| `loadTranslations` | Una función personalizada para cargar traducciones desde tu propia fuente.                                                                            |
| `customMapping`    | Un mapeo de códigos de configuración regional personalizados a códigos de configuración regional estándar o propiedades de la configuración regional. |
| `enableI18n`       | Indica si se deben habilitar las funciones de i18n.                                                                                                   |
| `cacheExpiryTime`  | Tiempo en milisegundos antes de que caduquen las traducciones almacenadas en caché.                                                                   |

### Devuelve

`void`

***

## Ejemplos

### Configuración básica

```js title="server.js"
import { initializeGT } from 'gt-node';

initializeGT({
  defaultLocale: 'en-US',
  locales: ['en-US', 'es', 'fr', 'ja'],
  projectId: process.env.GT_PROJECT_ID,
});
```


### Con un cargador de traducciones personalizado

```js title="server.js"
import { initializeGT } from 'gt-node';

initializeGT({
  defaultLocale: 'en-US',
  locales: ['en-US', 'es'],
  loadTranslations: async (locale) => {
    const res = await fetch(`https://my-api.com/translations/${locale}`);
    return res.json();
  },
});
```

***


## Notas

* `initializeGT` debe llamarse **una sola vez** antes de usar cualquier función de traducción.
* Si usas los servicios en la nube de GT, proporciona `projectId`. En desarrollo, proporciona también `devApiKey`.
* La opción `loadTranslations` te permite usar tu propia fuente de traducciones en lugar de la CDN de GT.

## Siguientes pasos

* Consulta [`withGT`](/docs/node/api/with-gt) para proporcionar el contexto de configuración regional en cada solicitud.
* Consulta [`getGT`](/docs/node/api/get-gt) y [`getMessages`](/docs/node/api/get-messages) para traducir cadenas.