# 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
---
title: getGT
description: General Translation を使用して、TanStack Start のサーバー関数でスタンドアロンの文字列を翻訳します。getGT の API リファレンス。

---

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

## 概要 [#overview]

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

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) によって作成されたロケールと国際化設定を読み取ります。翻訳を非同期で準備し、最終的にソース文字列を同期的に翻訳する関数を返します。

この関数は、有効なミドルウェア リクエストスコープ外で呼び出されると例外をスローします。

## 戻り値 [#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/server';

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