# General Translation React SDKs (gt-react, gt-next, gt-react-native): getGT
URL: https://generaltranslation.com/ja/docs/react/tanstack-start/reference/functions/get-gt.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: General Translation を使用して、TanStack Start ランタイムでスタンドアロンの文字列を翻訳します。getGT の API リファレンス。

`getGT` 関数は、現在のサーバーリクエストまたはブラウザに対応する、文字列を同期的に翻訳する関数を非同期で返します。`gt-tanstack-start` からインポートします。

## 概要 [#overview]

```ts
import { getGT } from 'gt-tanstack-start';

const gt = await getGT();
const label = gt('Submit');
```

```ts
getGT(messages?: Message[]): Promise<GTFunctionType>
```

## パラメータ [#parameters]

| パラメータ      | 説明                                                                | 型           | 任意 | デフォルト |
| ---------- | ----------------------------------------------------------------- | ----------- | -- | ----- |
| `messages` | 開発時のホットリロード用に事前取得する、コンパイラが提供するメッセージです。ほとんどの呼び出し元では、このパラメータは省略します。 | `Message[]` | はい | —     |

## 仕組み [#how-it-works]

サーバーでは、`getGT` は [`gtMiddleware`](/docs/react/tanstack-start/reference/functions/gt-middleware) によって作成されたロケールと国際化設定を読み取ります。ブラウザーでは、[`initializeGT`](/docs/react/reference/config#initialize) によって初期化された条件ストアを読み取ります。翻訳を非同期で準備し、最終的にソース文字列を同期的に翻訳する関数を返します。

サーバー呼び出しは、有効なミドルウェア リクエストスコープ外では例外をスローします。

## 戻り値 [#returns]

**型** `Promise<(content: string, options?: GTTranslationOptions) => string>`

解決後の関数は、`$context`、`$id`、`$maxChars` などの補間変数と [`GTTranslationOptions`](/docs/react/reference/types/inline-translation-options) を受け取ります。

## 例 [#example]

```ts
import { createServerFn } from '@tanstack/react-start';
import { getGT } from 'gt-tanstack-start';

export const loadTitle = createServerFn({ method: 'GET' }).handler(async () => {
  const gt = await getGT();
  return gt('Account settings');
});
```

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.