GT Class

setConfig

GT の setConfig メソッドのAPIリファレンス

概要

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 オブジェクトは、コンストラクタと同じプロパティをサポートします:

プロパティ任意説明
apiKeystring翻訳サービス用の本番環境 APIキー
devApiKeystring開発環境用 APIキー
projectIdstring一意のプロジェクト識別子
sourceLocalestring翻訳のデフォルトのソースロケール
targetLocalestring翻訳のデフォルトのターゲットロケール
localesstring[]対応ロケールコードの配列
baseUrlstringカスタム API ベースURL
customMappingCustomMappingカスタムのロケールコードマッピング

戻り値

void - メソッドはインスタンスの設定をその場で更新します。


この例では、対象のlocaleをSpanishからFrenchに切り替えます。

const gt = new GT({
  sourceLocale: 'en',
  targetLocale: 'es'
});

// フランス語に切り替え
gt.setConfig({
  targetLocale: 'fr'
});

注意事項

  • 設定の変更は、以降のメソッド呼び出しに即時反映されます
  • setConfig を呼び出しても、環境変数は再読み込みされません
  • カスタムマッピングは既存のマッピングを完全に置き換えます(マージされません)
  • 検証に失敗しても、インスタンスの設定は変更されません
  • このメソッドは同期的で、void を返します

次のステップ

このガイドはどうでしたか?

setConfig