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

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

---

Vérifie si un code de langue est correctement formaté et reconnu comme un paramètre régional BCP-47 valide sur une instance de [GT](/docs/platform/core/reference/gt-class/constructor). General Translation vérifie la structure du paramètre régional, la reconnaissance de la langue et la validité de la région et du script à l’aide des API `Intl`, avec prise en charge de mappings de paramètres régionaux personnalisés.

## Vue d’ensemble [#overview]

Appelez `isValidLocale` sur une instance de [`GT`](/docs/platform/core/reference/gt-class/constructor) avec un code de langue facultatif. Si aucun n’est fourni, la valeur `targetLocale` de l’instance est utilisée.

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

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

Signature :

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

*Remarque : `isValidLocale` s’exécute localement à l’aide des API `Intl` et ne nécessite pas de clé API. Il utilise le `targetLocale` et le `customMapping` de l’instance lorsque ces arguments sont omis. Pour valider sans instance `GT`, consultez la fonction autonome [`isValidLocale`](/docs/platform/core/reference/utility-functions/locales/is-valid-locale).*

## Comment cela fonctionne [#how-it-works]

* **Validation BCP-47.** Effectue une validation complète des paramètres régionaux BCP-47 à l’aide des API `Intl` du navigateur.
* **Résolution du mappage personnalisé.** Les paramètres régionaux qui sont des clés dans un [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) sont résolus en leur `code` canonique, puis ce code canonique est validé à l’aide des vérifications `Intl` standard — un paramètre régional avec mappage personnalisé n’est pas automatiquement valide.
* **Codes à usage privé.** Prend en charge les codes de langue à usage privé (`qaa`–`qtz`).
* **Contenu de secours pour le paramètre régional.** Lorsque `locale` est omis, le `targetLocale` de l’instance est utilisé.
* **Paramètre régional manquant.** Lève une `Error` si aucun paramètre régional n’est fourni et que l’instance n’a pas de `targetLocale` configuré.

## Paramètres [#parameters]

| Paramètre                          | Description                                                                                         | Type                                                                  | Facultatif | Par défaut           |
| ---------------------------------- | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | ---------- | -------------------- |
| [`locale`](#locale)                | Code de langue BCP-47 du paramètre régional à valider.                                              | `string`                                                              | Oui        | `this.targetLocale`  |
| [`customMapping`](#custom-mapping) | Mappage personnalisé à vérifier afin d’identifier des paramètres régionaux valides supplémentaires. | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Oui        | `this.customMapping` |

### `locale` [#locale]

**Type** `string` · **Facultatif** · **Par défaut** `this.targetLocale`

Code de langue BCP-47 à valider. S'il n'est pas fourni, la valeur `targetLocale` de l'instance est utilisée.

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

**Type** [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) · **Facultatif** · **Par défaut** `this.customMapping`

Mapping personnalisé permettant de vérifier des paramètres régionaux valides supplémentaires. S’il n’est pas fourni, le `customMapping` de l’instance est utilisé.

## Valeur de retour [#returns]

**Type** `boolean`

`true` si le paramètre régional est valide, `false` sinon. Lève une `Error` si aucun paramètre régional n’est fourni et qu’aucun `targetLocale` n’est configuré pour l’instance.

## Exemples [#examples]

```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 [#notes]

* Effectue une validation complète des paramètres régionaux BCP-47 à l’aide des API `Intl` du navigateur.
* Les clés de mappage personnalisé sont résolues vers leur `code` canonique, qui est ensuite validé à l’aide des vérifications standard de `Intl` (elles ne sont pas automatiquement valides).
* Prend en charge les codes de langue à usage privé (`qaa`–`qtz`).
* Renvoie `false` pour les codes de langue mal formés ou non reconnus.