# generaltranslation: General Translation Core SDK: isValidLocale
URL: https://generaltranslation.com/fr/docs/core/functions/locales/is-valid-locale.mdx
---
title: isValidLocale
description: Référence de l’API de la fonction isValidLocale
---

## Vue d’ensemble

La fonction `isValidLocale` vérifie si une chaîne donnée correspond à un code de langue BCP-47 valide. Elle effectue une validation complète du format sans nécessiter d’instance de la classe GT.

***

## Référence

### Paramètres

<TypeTable
  type={{
  "locale": {
    type: 'string',
    optional: false,
  },
  "customMapping?": {
    type: 'CustomMapping',
    optional: true,
  }
}}
/>

### Renvoie

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

***

## Exemples

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

* Valide le format des codes de langue BCP-47
* Prend en charge des mappages 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

## Étapes suivantes

* Utilisez la méthode de classe GT [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale)
* Standardisez le format avec [`standardizeLocale`](/docs/core/functions/locales/standardize-locale)