# gt-next: General Translation Next.js SDK: loadDictionary
URL: https://generaltranslation.com/ru/docs/next/api/config/load-dictionary.mdx
---
title: loadDictionary
description: Справочная документация по API функции loadDictionary()
---

## Обзор

`loadDictionary` загружает JSON-файл переводов для указанной локали.

Эта функция предназначена для тех, кто хочет использовать `gt-next` как автономную библиотеку i18n.

Она в первую очередь используется при миграции существующих проектов с i18n на General Translation с сохранением текущих переводов.
Чтобы настроить это, следуйте [этому руководству](/docs/next/guides/migration).

Если существует несколько переводов, приоритет всегда имеют переводы из словарей, загруженных через `loadDictionary`.
`loadDictionary` поддерживает только JSON-файлы со строковыми переводами.

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

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

<TypeTable
  type={{
  "locale": {
      type: 'string',
      optional: false,
  },
}}
/>

### Описание

| Тип      | Описание                                      |
| -------- | --------------------------------------------- |
| `locale` | Локаль, для которой нужно загрузить переводы. |

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

`Promise<any>`, который возвращает словарь, сопоставляющий идентификаторы с переводами для указанной локали.

***

## Сетап

Обычно словарь загружается из директории `./public/locales`.

Определите `loadDictionary` как экспорт по умолчанию в файле `loadDictionary.js` или `loadDictionary.ts`, расположенном либо в директории `src/`, либо в корне проекта.
Убедитесь, что функция возвращает promise, который разрешается в объект с переводами для указанной локали.

```jsx title="src/loadDictionary.js"
export default async function loadDictionary(locale) {
  const translations = await import(`../public/locales/${locale}.json`);
  return translations.default;
}
```

<Callout>
  **Вопрос:** В чем разница между [`loadTranslations`](/docs/next/api/config/load-translations) и [`loadDictionary`](/docs/next/api/config/load-dictionary)?

  * [`loadTranslations`](/docs/next/api/config/load-translations) используется для настройки пользовательской логики загрузки переводов для вашего приложения.
    Например, переводы можно получать из CDN, базы данных или бандла приложения.
    Обычно это машинно сгенерированные переводы, которыми управляет CLI-инструмент, и редактировать их вручную не очень удобно.
  * [`loadDictionary`](/docs/next/api/config/load-dictionary) предназначен для реализаций `gt-next` как автономной библиотеки.
    Пользователи предоставляют собственные переводы, и инфраструктура перевода при этом не используется.
</Callout>

***


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

* `loadDictionary` используется для загрузки пользовательских переводов в вашем приложении.
* Словари, загруженные через `loadDictionary`, имеют приоритет над переводами, загруженными через [`loadTranslations`](/docs/next/api/config/load-translations).

## Что дальше

* Если вы хотите писать переводы самостоятельно, ознакомьтесь с разделом [пользовательские переводы](/docs/next/concepts/stand-alone).
* Подробнее о создании собственного загрузчика переводов см. в [`loadTranslations`](/docs/next/api/config/load-translations).