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

title: gtMiddleware
description: Crea uno stato dell'impostazione regionale relativo alla richiesta per le API server di General Translation in TanStack Start. Riferimento API per gtMiddleware.

---

L'export `gtMiddleware` è il middleware globale per le richieste di TanStack Start. Importalo da `gt-tanstack-start/server` e registralo prima di chiamare qualsiasi helper server relativo alla richiesta.

## Panoramica [#overview]

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

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

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

## Come funziona [#how-it-works]

* Risolve l'impostazione regionale, la regione e l'impostazione di internazionalizzazione dalla richiesta in ingresso e dalla configurazione di General Translation.
* Memorizza questi valori nello stato locale della richiesta per il rendering lato server, le route server e le funzioni server.
* Mantiene isolato lo stato della richiesta durante richieste server concorrenti.
* Salva in modo persistente l'impostazione regionale risolta nel cookie dell'impostazione regionale di General Translation.

Chiama [`initializeGT`](/docs/react/reference/config#initialize) da `gt-tanstack-start` prima che il middleware gestisca una richiesta. Il middleware solleva un'eccezione se l'inizializzazione non ha creato il relativo condition store.

## Helper del server [#server-helpers]

Il middleware rende disponibile lo stato della richiesta a:

* [`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)

Questi helper generano un errore se vengono chiamati al di fuori del contesto della richiesta attiva del middleware.