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

title: getTranslations
description: Lee traducciones del diccionario en el runtime de TanStack Start con General Translation. Referencia de la API de getTranslations.

---

La función `getTranslations` devuelve una función de búsqueda en el diccionario para la solicitud actual del servidor o navegador. Impórtala desde `gt-tanstack-start`.

## Descripción general [#overview]

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

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

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

## Parámetros [#parameters]

| Parámetro | Descripción                                        | Tipo     | Opcional | Predeterminado |
| --------- | -------------------------------------------------- | -------- | -------- | -------------- |
| `rootId`  | Prefijo que se aplica a cada `id` del diccionario. | `string` | Sí       | —              |

## Cómo funciona [#how-it-works]

En el servidor, `getTranslations` lee la configuración regional y la configuración de internacionalización creada por [`gtMiddleware`](/docs/react/tanstack-start/reference/functions/gt-middleware). En el navegador, lee el almacén de condiciones inicializado por [`initializeGT`](/docs/react/reference/config#initialize). El `rootId` opcional limita cada búsqueda a una única ruta del diccionario.

Las llamadas del servidor lanzan una excepción fuera del alcance de una solicitud activa del middleware. Buscar un id del diccionario desconocido también lanza una excepción.

## Devuelve [#returns]

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

La función resultante acepta [`DictionaryTranslationOptions`](/docs/react/reference/types/dictionary-translation-options) y expone `.obj(id)` para objetos de diccionario anidados.

## Ejemplo [#example]

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

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