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

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

---

[`isSupersetLocale`](/docs/platform/core/reference/gt-class-methods/locales/is-superset-locale) est une fonction utilitaire autonome de la bibliothèque principale de General Translation qui vérifie si un paramètre régional est un sur-ensemble d’un autre dans la hiérarchie BCP-47 — c’est-à-dire s’il peut représenter le paramètre régional plus spécifique.

## Vue d’ensemble [#overview]

Importez `isSupersetLocale` directement depuis `generaltranslation` et appelez-la avec un paramètre régional sur-ensemble et un paramètre régional sous-ensemble. Elle ne nécessite ni clé d’API ni instance de [GT](/docs/platform/core/reference/gt-class/constructor). Pour l’équivalent basé sur une instance, utilisez plutôt la méthode [`isSupersetLocale`](/docs/platform/core/reference/gt-class-methods/locales/is-superset-locale) sur une instance de [`GT`](/docs/platform/core/reference/gt-class/constructor).

```typescript
import { isSupersetLocale } from 'generaltranslation';

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

Signature :

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

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

* **Vérification de la hiérarchie.** Utilise la hiérarchie des paramètres régionaux BCP-47. `subLocale` est un sous-ensemble de `superLocale` s’il en est une extension ou s’il lui est identique.
* **Langues de base.** Une langue de base est un surensemble de ses variantes régionales, mais une variante régionale n’est pas un surensemble de sa langue de base.
* **Réflexivité.** Un paramètre régional est toujours un surensemble de lui-même.

## Paramètres [#parameters]

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

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

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

Le paramètre régional à vérifier en tant que sur-ensemble potentiel.

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

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

Le paramètre régional à vérifier en tant que sous-ensemble potentiel.

## Renvoie [#returns]

**Type** `boolean`

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

## Exemples [#examples]

```typescript
import { isSupersetLocale } from 'generaltranslation';

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

// Une variante régionale n'est PAS un sur-ensemble d'une langue de base
console.log(isSupersetLocale('en-US', 'en')); // false

// Un paramètre régional est toujours un sur-ensemble de lui-même
console.log(isSupersetLocale('en-US', 'en-US')); // true
```

## Notes [#notes]

* Utilise la hiérarchie des paramètres régionaux BCP-47.
* Les langues de base sont des sur-ensembles des variantes régionales.
* Un paramètre régional est toujours un sur-ensemble de lui-même.
* Essentiel pour créer des systèmes de contenu de secours.