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

title: gtMiddleware
description: Crea un estado de configuración regional asociado a la solicitud para las API de servidor de General Translation en TanStack Start. Referencia de la API de gtMiddleware.

---

La exportación `gtMiddleware` es el middleware global de solicitudes de TanStack Start. Impórtalo desde `gt-tanstack-start` y regístralo antes de llamar a las funciones auxiliares de Runtime en el servidor.

## Resumen [#overview]

```ts title="src/start.ts"
import { createCsrfMiddleware, createStart } from '@tanstack/react-start';
import { gtMiddleware } from 'gt-tanstack-start';

const csrfMiddleware = createCsrfMiddleware({
  filter: ({ handlerType }) => handlerType === 'serverFn',
});

export const startInstance = createStart(() => ({
  requestMiddleware: [csrfMiddleware, gtMiddleware],
}));
```

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

* Resuelve la configuración regional, la región y la configuración de internacionalización a partir de la solicitud entrante y de tu configuración de General Translation.
* Cuando `localeRouting` está habilitado, da prioridad al primer segmento de ruta compatible por encima de la cookie de configuración regional y de la cabecera `Accept-Language`. La configuración regional predeterminada permanece sin prefijo.
* Respeta la ruta base de TanStack Router mediante `TSS_ROUTER_BASEPATH`.
* Almacena esos valores en un estado local por solicitud para el renderizado en el servidor, las rutas del servidor y las funciones del servidor.
* Mantiene aislado el estado de la solicitud durante las solicitudes concurrentes del servidor.
* Persiste la configuración regional resuelta en la cookie de configuración regional de General Translation.

Llama a [`initializeGT`](/docs/react/reference/config#initialize) desde `gt-tanstack-start` antes de que el middleware procese una solicitud. El middleware lanza una excepción si la inicialización no ha creado su almacén de condiciones.

## Funciones auxiliares del servidor [#server-helpers]

El middleware pone el estado de la solicitud a disposición de:

* [`getLocale`](/docs/react/tanstack-start/reference/functions/get-locale)
* [`getEnableI18n`](/docs/react/tanstack-start/reference/functions/get-enable-i18n)
* [`getGT`](/docs/react/tanstack-start/reference/functions/get-gt)
* [`getMessages`](/docs/react/tanstack-start/reference/functions/get-messages)
* [`getTranslations`](/docs/react/tanstack-start/reference/functions/get-translations)

Estas funciones auxiliares son isomórficas. Sus ramas del servidor lanzan una excepción si se llaman fuera del ámbito de la solicitud activa del middleware; sus ramas del cliente leen el almacén de condiciones del navegador inicializado por [`initializeGT`](/docs/react/reference/config#initialize).

## Historial de versiones [#version-history]

| Versión  | Cambios                                                                                                                                                            |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `11.1.5` | Se exportó `gtMiddleware` desde la condición de navegador del root para que los archivos de setup puedan usar la importación del root en compilaciones de cliente. |