setConfig
Справочник API по методу GT setConfig
Обзор
Метод setConfig обновляет конфигурацию существующего экземпляра GT.
Это позволяет изменять учетные данные API, локали и другие настройки после создания экземпляра.
const gt = new GT();
gt.setConfig({
apiKey: 'your-new-api-key',
projectId: 'your-project-id',
sourceLocale: 'en',
targetLocale: 'es'
});Метод setConfig проверит все переданные коды локалей и объединит их с существующей конфигурацией, указанной в конструкторе.
Справочные материалы
Параметры
Prop
Type
Объект GTConstructorParams поддерживает те же свойства, что и конструктор:
| Свойство | Тип | Необязательно | Описание |
|---|---|---|---|
apiKey | string | ✓ | Продукционный API‑ключ для сервиса переводов |
devApiKey | string | ✓ | API‑ключ для разработки |
projectId | string | ✓ | Уникальный идентификатор проекта |
sourceLocale | string | ✓ | Исходная локаль по умолчанию для переводов |
targetLocale | string | ✓ | Целевая локаль по умолчанию для переводов |
locales | string[] | ✓ | Массив поддерживаемых кодов локалей |
baseUrl | string | ✓ | Пользовательский базовый URL API |
customMapping | CustomMapping | ✓ | Пользовательские соответствия кодов локалей |
Возвращает
void — метод обновляет конфигурацию экземпляра напрямую (in-place).
Пример
В этом примере мы меняем целевую локаль с испанской на французскую.
const gt = new GT({
sourceLocale: 'en',
targetLocale: 'fr'
});
// Switch to French
gt.setConfig({
targetLocale: 'fr'
});Примечания
- Изменения конфигурации сразу применяются к последующим вызовам методов
- Переменные окружения не перечитываются при вызове
setConfig - Пользовательские сопоставления полностью заменяют существующие (не объединяются)
- В случае ошибок валидации конфигурация экземпляра не изменяется
- Метод синхронный и возвращает
void
Дальнейшие шаги
Насколько полезно это руководство?