# General Translation React SDKs (gt-react, gt-next, gt-react-native): getTranslations
URL: https://generaltranslation.com/ja/docs/react/tanstack-start/reference/functions/get-translations.mdx
---

title: getTranslations
description: General Translation を使用して、TanStack Start のサーバー関数で辞書の翻訳を読み取る方法です。getTranslations の API リファレンス。

---

`getTranslations` 関数は、現在のサーバーリクエストに対応する辞書の参照関数を返します。`gt-tanstack-start/server` からインポートします。

## 概要 [#overview]

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

const t = await getTranslations('account');
const heading = t('heading');
```

```ts
getTranslations(rootId?: string): Promise<DictionaryTranslationFunction>
```

## パラメータ [#parameters]

| パラメータ    | 説明                               | 型        | 任意 | デフォルト |
| -------- | -------------------------------- | -------- | -- | ----- |
| `rootId` | 各 辞書 の id に適用されるプレフィックス。 | `string` | はい | —     |

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

`getTranslations` は、[`gtMiddleware`](/docs/react/tanstack-start/reference/functions/gt-middleware) によって作成されたロケールと国際化設定を読み取ります。任意の `rootId` を指定すると、すべての参照が 1 つの 辞書 path 配下にスコープされます。

この関数は、有効なミドルウェアのリクエストスコープ外で呼び出すと例外を送出します。存在しない 辞書 id を参照した場合も例外を送出します。

## 戻り値 [#returns]

**型** `Promise<(id: string, options?: DictionaryTranslationOptions) => string>`

解決後の関数は [`DictionaryTranslationOptions`](/docs/react/reference/types/dictionary-translation-options) を受け取り、ネストされた辞書オブジェクト用に `.obj(id)` も利用できます。

## 例 [#example]

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

export const loadHeading = createServerFn({ method: 'GET' }).handler(
  async () => {
    const t = await getTranslations('account');
    return t('heading');
  }
);
```