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

title: isSupersetLocale
description: Vérifie si un paramètre régional peut représenter un autre paramètre régional plus spécifique. Référence de l’API pour isSupersetLocale.

---

Sur une instance de [GT](/docs/platform/core/reference/gt-class/constructor), vérifie si un paramètre régional est un sur-ensemble d’un autre dans la hiérarchie BCP-47. Un paramètre régional sur-ensemble est plus général et peut servir de contenu de secours pour des paramètres régionaux plus spécifiques. General Translation utilise ce mécanisme pour établir les chaînes de contenu de secours entre paramètres régionaux.

## Vue d’ensemble [#overview]

Appelez `isSupersetLocale` sur une instance de [`GT`](/docs/platform/core/reference/gt-class/constructor) en lui passant un paramètre régional candidat comme sur-ensemble et un autre comme sous-ensemble. Elle renvoie `true` lorsque le premier est un sur-ensemble du second.

```typescript
const gt = new GT();

console.log(gt.isSupersetLocale('en', 'en-US')); // true
console.log(gt.isSupersetLocale('en-US', 'en')); // false
```

Signature :

```typescript
isSupersetLocale(superLocale: string, subLocale: string): boolean
```

*Remarque : `isSupersetLocale` s’exécute localement et ne nécessite pas de clé API. Pour effectuer des comparaisons sans instance `GT`, consultez la version autonome de [`isSupersetLocale`](/docs/platform/core/reference/utility-functions/locales/is-superset-locale).*

## Fonctionnement [#how-it-works]

* **Hiérarchie BCP-47.** Utilise la hiérarchie des paramètres régionaux BCP-47 pour effectuer la comparaison.
* **Réflexivité.** Un paramètre régional est toujours un sur-ensemble de lui-même.
* **Langues de base.** Les langues de base sont des sur-ensembles de leurs variantes régionales, mais une variante régionale n’est pas un sur-ensemble de sa langue de base.
* **Langues différentes.** Renvoie `false` si les langues sont complètement différentes.

## Paramètres [#parameters]

| Paramètre                      | Description                                                   | Type     | Facultatif | Par défaut |
| ------------------------------ | ------------------------------------------------------------- | -------- | ---------- | ---------- |
| [`superLocale`](#super-locale) | Le paramètre régional à vérifier comme sur-ensemble de référence. | `string` | Non        | —          |
| [`subLocale`](#sub-locale)     | Le paramètre régional à vérifier comme sous-ensemble.         | `string` | Non        | —          |

### `superLocale` [#super-locale]

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

Le paramètre régional à vérifier en tant que sur-ensemble (c’est-à-dire le paramètre régional le plus général).

### `subLocale` [#sub-locale]

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

Le paramètre régional à vérifier comme sous-ensemble (le paramètre régional le plus spécifique).

## Renvoie [#returns]

**Type** `boolean`

`true` si `superLocale` est un sur-ensemble de `subLocale`, `false` sinon.

## Exemples [#examples]

```typescript
const gt = new GT();

// La langue de base est un sur-ensemble de la variante régionale
console.log(gt.isSupersetLocale('en', 'en-US')); // true
console.log(gt.isSupersetLocale('es', 'es-ES')); // true
console.log(gt.isSupersetLocale('zh', 'zh-CN')); // true

// La variante régionale n'est PAS un sur-ensemble de la langue de base
console.log(gt.isSupersetLocale('en-US', 'en')); // false
console.log(gt.isSupersetLocale('es-ES', 'es')); // false

// Mêmes paramètres régionaux
console.log(gt.isSupersetLocale('en-US', 'en-US')); // true

// Langues différentes
console.log(gt.isSupersetLocale('en', 'es-ES')); // false
```

## Remarques [#notes]

* Utilise la hiérarchie BCP-47 des paramètres régionaux pour la comparaison.
* Un paramètre régional est toujours un sur-ensemble de lui-même.
* Les langues de base sont des sur-ensembles de leurs variantes régionales.
* Renvoie `false` pour des langues totalement différentes.