# gt-next: General Translation Next.js SDK: isLocaleSupported
URL: https://generaltranslation.com/es/docs/next/api/helpers/is-locale-supported.mdx
---
title: isLocaleSupported
description: Referencia de la API para el método isLocaleSupported del lado del servidor
---

## Resumen general

La función `isLocaleSupported` comprueba si una configuración regional es válida y es compatible con la configuración actual de `gt-next` de tu aplicación.

Úsala cuando un parámetro de ruta u otra entrada de la solicitud deba rechazarse explícitamente, en lugar de usar silenciosamente la configuración regional predeterminada. Un patrón común es validar el segmento `[locale]` en una ruta dinámica y llamar a `notFound()` cuando el valor no sea compatible.

<Callout>
  `isLocaleSupported` es un método del lado del servidor y solo puede usarse en
  componentes del lado del servidor.
</Callout>

## Referencia

### Parámetros

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

| Nombre   | Descripción                                                                                                                                                                     |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `locale` | La configuración regional candidata que se debe validar. Se acepta cualquier valor; los valores que no sean de tipo `string` o los valores BCP 47 no válidos devuelven `false`. |

### Devuelve

Un `boolean` que vale `true` cuando la configuración regional se resuelve como una de las configuraciones regionales configuradas, y `false` en caso contrario.

También actúa como una guarda de tipos de TypeScript (`locale is string`), acotando el valor a `string` cuando devuelve `true`.

***

## Ejemplos

### Rechazo de parámetros de ruta no válidos

Valida el parámetro de ruta `[locale]` y llama a `notFound()` para los locales no compatibles, en lugar de depender del contenido alternativo de la configuración regional predeterminada.

```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>;
}
```

***

## Notas

* `isLocaleSupported` solo está disponible del lado del servidor.
* Sin esta comprobación, si la configuración regional solicitada no es válida o no es compatible, se usa la configuración regional predeterminada en lugar de generar un error. Consulta [`getLocale`](/docs/next/api/helpers/get-locale) para conocer este comportamiento de contenido alternativo.
* El conjunto de locales admitidos se configura en [`withGTConfig`](/docs/next/api/config/with-gt-config). Consulta también [`gt.config.json`](/docs/next/api/config/gt-config-json).

## Próximos pasos

* Consulta [`getLocale`](/docs/next/api/helpers/get-locale) para obtener la configuración regional actual del usuario.
* Aprende a configurar los locales admitidos con [`withGTConfig()`](/docs/next/api/config/with-gt-config).