# generaltranslation: General Translation Core SDK: isValidLocale
URL: https://generaltranslation.com/fr/docs/core/class/methods/locales/is-valid-locale.mdx
---
title: isValidLocale
description: Référence API de la méthode GT isValidLocale
---

## Vue d’ensemble

La méthode `isValidLocale` valide si un code de langue est correctement formaté et reconnu comme un paramètre régional BCP-47 valide.
Elle vérifie la structure du paramètre régional, la reconnaissance de la langue ainsi que la validité de la région et du script à l’aide des API `Intl`, avec prise en charge de mappages de paramètres régionaux personnalisés.

***

## Référence

### Paramètres

<TypeTable
  type={{
  "locale?": {
    type: 'string',
    optional: true,
    default: 'this.targetLocale',
  },
  "customMapping?": {
    type: 'CustomMapping',
    optional: true,
    default: 'this.customMapping',
  }
}}
/>

### Description des paramètres

| Paramètre       | Description                                                                                                                                                                               |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `locale`        | Code de langue BCP-47 à valider. S&#39;il n&#39;est pas fourni, le `targetLocale` de l&#39;instance est utilisé.                                                                          |
| `customMapping` | Mappage personnalisé facultatif permettant de vérifier des paramètres régionaux valides supplémentaires. S&#39;il n&#39;est pas fourni, le `customMapping` de l&#39;instance est utilisé. |

### Retourne

`boolean` - `true` si le paramètre régional est valide, `false` sinon

### Lève

* `Error` - Si aucun paramètre régional n’est fourni et qu’aucun `targetLocale` n’est configuré pour l’instance

***

## Exemples

```typescript
const gt = new GT({
  sourceLocale: 'en',
  targetLocale: 'es'
});

const isValid = gt.isValidLocale('en-US');
console.log(isValid); // true

const isInvalid = gt.isValidLocale('invalid-locale');
console.log(isInvalid); // false
```

***


## Remarques

* Effectue une validation complète des paramètres régionaux BCP-47 à l’aide des API `Intl` du navigateur
* Les paramètres régionaux avec mappage personnalisé sont toujours considérés comme valides (contournent la validation standard)
* Prend en charge les codes de langue à usage privé (`qaa-qtz`)
* Renvoie `false` pour les codes de langue mal formés ou non reconnus

## Étapes suivantes

* **[Obtenir les propriétés du paramètre régional avec getLocaleProperties](/docs/core/class/methods/locales/get-locale-properties)**
* **[Déterminer le paramètre régional le plus approprié avec determineLocale](/docs/core/class/methods/locales/determine-locale)**
* **[Obtenir les noms des paramètres régionaux avec getLocaleName](/docs/core/class/methods/locales/get-locale-name)**
* **[En savoir plus sur le type CustomMapping](/docs/core/types/custom-mapping)**