# General Translation Platform: isValidLocale
URL: https://generaltranslation.com/fr/docs/platform/core/reference/gt-class-methods/locales/is-valid-locale.mdx
Docs index: https://generaltranslation.com/llms.txt
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.

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.