# General Translation Platform: isValidLocale
URL: https://generaltranslation.com/fr/docs/platform/core/reference/utility-functions/locales/is-valid-locale.mdx
---

title: isValidLocale
description: Vérifie si une valeur est un code de langue valide sans instance GT. Référence de l’API pour isValidLocale.

---

[`isValidLocale`](/docs/platform/core/reference/gt-class-methods/locales/is-valid-locale) est une fonction utilitaire autonome de la bibliothèque Core de General Translation qui vérifie si une chaîne est un code de langue BCP-47 valide. Elle valide le format sans nécessiter d’instance GT.

## Aperçu [#overview]

Importez `isValidLocale` directement depuis `generaltranslation` et appelez-la avec un code de langue. Cela ne nécessite ni clé API ni instance de [GT](/docs/platform/core/reference/gt-class/constructor). Pour l’équivalent sur instance, utilisez plutôt la méthode [`isValidLocale`](/docs/platform/core/reference/gt-class-methods/locales/is-valid-locale) d’une instance de [`GT`](/docs/platform/core/reference/gt-class/constructor).

```typescript
import { isValidLocale } from 'generaltranslation';

console.log(isValidLocale('en-US')); // true
console.log(isValidLocale('invalid')); // false
```

Signature :

```typescript
isValidLocale(locale: string, customMapping?: CustomMapping): boolean
```

## Fonctionnement [#how-it-works]

* **Validation du format.** Valide le format du code de langue BCP-47. Il s’agit d’une simple validation de format — aucune requête réseau n’est effectuée.
* **Custom mapping.** Fonctionne avec des mappings personnalisés de paramètres régionaux, de sorte que les alias définis dans un [`customMapping`](/docs/platform/core/reference/types/custom-mapping) sont considérés comme valides.
* **Sans état.** Convient aux bibliothèques utilitaires et à la validation des saisies utilisateur.

## Paramètres [#parameters]

| Paramètre                          | Description                                                     | Type                                                                  | Facultatif | Par défaut |
| ---------------------------------- | --------------------------------------------------------------- | --------------------------------------------------------------------- | ---------- | ---------- |
| [`locale`](#locale)                | La valeur à valider.                                            | `string`                                                              | Non        | —          |
| [`customMapping`](#custom-mapping) | Mapping personnalisé à prendre en compte lors de la validation. | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Oui        | —          |

### `locale` [#locale]

**Type** `string` · **Obligatoire**

Valeur à valider comme code de langue BCP-47.

### `customMapping` [#custom-mapping]

**Type** [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) · **Facultatif**

Un mapping personnalisé facultatif dont les alias sont considérés comme valides.

## Retourne [#returns]

**Type** `boolean`

`true` si le code de langue est valide, `false` sinon.

## Exemples [#examples]

```typescript
import { isValidLocale } from 'generaltranslation';

// Codes de langue valides
console.log(isValidLocale('en-US')); // true
console.log(isValidLocale('zh-CN')); // true
console.log(isValidLocale('es')); // true

// Codes de langue invalides
console.log(isValidLocale('invalid')); // false
console.log(isValidLocale('en_US')); // false (tiret bas au lieu d'un trait d'union)
console.log(isValidLocale('')); // false
```

## Remarques [#notes]

* Valide le format des codes de langue BCP-47.
* Fonctionne avec des mappings personnalisés de paramètres régionaux.
* Essentiel pour valider les saisies utilisateur.
* Aucune requête réseau — validation de format uniquement.
* Fonction sans état adaptée aux bibliothèques utilitaires.