# gt-next: General Translation Next.js SDK: isLocaleSupported
URL: https://generaltranslation.com/fr/docs/next/api/helpers/is-locale-supported.mdx
---
title: isLocaleSupported
description: Référence de l’API pour la méthode isLocaleSupported côté serveur
---

## Vue d’ensemble

La fonction `isLocaleSupported` vérifie si un paramètre régional est valide et pris en charge par la configuration gt-next actuelle de votre application.

Utilisez-la lorsqu’un paramètre de route ou une autre donnée de la requête doit être explicitement rejeté, plutôt que de basculer silencieusement vers le paramètre régional par défaut. Un cas fréquent consiste à valider le segment `[locale]` dans une route dynamique et à appeler `notFound()` lorsque la valeur n’est pas prise en charge.

<Callout>
  `isLocaleSupported` est une méthode côté serveur et ne peut être utilisée que dans des
  composants côté serveur.
</Callout>

## Référence

### Paramètres

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

| Nom      | Description                                                                                                                                                        |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `locale` | Le paramètre régional candidat à valider. Toute valeur est acceptée ; les valeurs qui ne sont pas des chaînes ou les valeurs BCP 47 non valides renvoient `false`. |

### Retourne

Un `boolean` qui vaut `true` lorsque le paramètre régional correspond à l’un des paramètres régionaux configurés, et `false` sinon.

Cette fonction sert également de prédicat de type TypeScript (`locale is string`) et restreint la valeur à `string` lorsqu’elle retourne `true`.

***

## Exemples

### Rejeter les paramètres de route invalides

Validez le paramètre de route `[locale]` et appelez `notFound()` pour les paramètres régionaux non pris en charge, au lieu de vous reposer sur le contenu de secours du paramètre régional par défaut.

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

***

## Notes

* `isLocaleSupported` est disponible uniquement côté serveur.
* Sans cette vérification, un paramètre régional de requête invalide ou non pris en charge revient au paramètre régional par défaut au lieu de lever une erreur. Consultez [`getLocale`](/docs/next/api/helpers/get-locale) pour en savoir plus sur ce contenu de secours.
* L’ensemble des paramètres régionaux pris en charge est configuré dans [`withGTConfig`](/docs/next/api/config/with-gt-config). Voir aussi [`gt.config.json`](/docs/next/api/config/gt-config-json).

## Étapes suivantes

* Consultez [`getLocale`](/docs/next/api/helpers/get-locale) pour obtenir le paramètre régional actuel de l’utilisateur.
* Découvrez comment configurer les paramètres régionaux pris en charge avec [`withGTConfig()`](/docs/next/api/config/with-gt-config).