# gt-next: General Translation Next.js SDK: isLocaleSupported
URL: https://generaltranslation.com/it/docs/next/api/helpers/is-locale-supported.mdx
---
title: isLocaleSupported
description: Riferimento API del metodo lato server isLocaleSupported
---

## Panoramica

La funzione `isLocaleSupported` verifica se un'impostazione regionale è valida ed è supportata dalla configurazione gt-next corrente della tua app.

Usala quando un parametro di route o un altro input della richiesta deve essere rifiutato esplicitamente, invece di ripiegare silenziosamente sull'impostazione regionale predefinita. Un pattern comune consiste nel convalidare il segmento `[locale]` in una route dinamica e chiamare `notFound()` quando il valore non è supportato.

<Callout>
  `isLocaleSupported` è un metodo lato server e può essere usato solo nei
  componenti lato server.
</Callout>

## Riferimento

### Parametri

<TypeTable
  type={{
  "locale": {
      type: 'unknown',
      optional: false,
  },
}}
/>

| Nome     | Descrizione                                                                                                                                                      |
| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `locale` | L’impostazione regionale candidata da validare. È accettato qualsiasi valore; i valori che non sono stringhe o i valori BCP 47 non validi restituiscono `false`. |

### Restituisce

Un `boolean` che è `true` quando l&#39;impostazione regionale corrisponde a una delle locales configurate e `false` in caso contrario.

Funge anche da type guard di TypeScript (`locale is string`), restringendo il tipo del valore a `string` quando restituisce `true`.

***

## Esempi

### Rifiutare parametri di route non validi

Valida il parametro di route `[locale]` e chiama `notFound()` per le locales non supportate, invece di fare affidamento sul fallback della locale predefinita.

```tsx title="app/[locale]/page.tsx" copy
import { notFound } from 'next/navigation';
import { isLocaleSupported } from 'gt-next/server';

export default async function Page({
  params,
}: {
  params: Promise<{ locale: string }>;
}) {
  const { locale } = await params;

  if (!isLocaleSupported(locale)) {
    notFound(); // [!code highlight]
  }

  return <p>Locale: {locale}</p>;
}
```

***

## Note

* `isLocaleSupported` è disponibile solo lato server.
* Senza questo controllo, una locale della richiesta non valida o non supportata usa la locale predefinita invece di generare un errore. Consulta [`getLocale`](/docs/next/api/helpers/get-locale) per il comportamento di fallback.
* L&#39;insieme delle locales supportate è configurato in [`withGTConfig`](/docs/next/api/config/with-gt-config). Vedi anche [`gt.config.json`](/docs/next/api/config/gt-config-json).

## Passaggi successivi

* Consulta [`getLocale`](/docs/next/api/helpers/get-locale) per ottenere la locale corrente dell&#39;utente.
* Scopri come configurare le locales supportate con [`withGTConfig()`](/docs/next/api/config/with-gt-config).