# node: initializeGT
URL: https://generaltranslation.com/ru/docs/node/api/initialize-gt.mdx
---
title: initializeGT
description: Справочник API по функции настройки initializeGT
---

## Обзор

Функция `initializeGT` настраивает General Translation для использования в среде выполнения Node.js.
Её нужно вызвать один раз, прежде чем использовать какие-либо функции перевода.

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

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

<Callout type="warn">
  **Обязательная настройка:**
  `initializeGT` необходимо вызвать перед использованием `withGT`, `getGT`, `getMessages` или любой другой функции перевода.
  Вызовите её один раз при инициализации сервера (например, в начале входного файла).
</Callout>

## Справочник

### Параметры

<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,
  },
}}
/>

### Описание

| Prop               | Описание                                                                                           |
| ------------------ | -------------------------------------------------------------------------------------------------- |
| `defaultLocale`    | Локаль приложения по умолчанию. Значение по умолчанию — `'en-US'`.                                 |
| `locales`          | Массив кодов локалей, поддерживаемых вашим приложением.                                            |
| `projectId`        | Идентификатор проекта General Translation. Обязателен для облачных сервисов перевода.              |
| `devApiKey`        | API-ключ для переводов по запросу в среде разработки.                                              |
| `cacheUrl`         | URL-адрес сервиса кэширования GT. Установите `null`, чтобы отключить.                              |
| `runtimeUrl`       | URL-адрес сервиса перевода GT во время выполнения. Установите `null`, чтобы отключить.             |
| `loadTranslations` | Пользовательская функция для загрузки переводов из собственного источника.                         |
| `customMapping`    | Сопоставление пользовательских кодов локалей со стандартными кодами локалей или свойствами локали. |
| `enableI18n`       | Следует ли включать функции i18n.                                                                  |
| `cacheExpiryTime`  | Время в миллисекундах до истечения срока действия кэшированных переводов.                          |

### Возвращает

`void`

***

## Примеры

### Базовая настройка

```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,
});
```


### С собственным загрузчиком переводов

```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();
  },
});
```

***


## Примечания

* `initializeGT` необходимо вызвать **один раз** перед использованием любых функций перевода.
* Если вы используете облачные сервисы GT, укажите `projectId`. Для разработки также укажите `devApiKey`.
* Параметр `loadTranslations` позволяет использовать собственный источник переводов вместо CDN GT.

## Что дальше

* См. [`withGT`](/docs/node/api/with-gt), чтобы передавать контекст локали для каждого запроса.
* См. [`getGT`](/docs/node/api/get-gt) и [`getMessages`](/docs/node/api/get-messages), чтобы переводить строки.