# General Translation Platform: isSameDialect
URL: https://generaltranslation.com/fr/docs/platform/core/reference/gt-class-methods/locales/is-same-dialect.mdx
---

title: isSameDialect
description: Vérifie si deux locales correspondent au même dialecte. Référence de l’API isSameDialect.

---

Vérifie si plusieurs codes de langue BCP-47 correspondent au même dialecte dans une instance [GT](/docs/platform/core/reference/gt-class/constructor). General Translation compare les composants de langue et de région des codes de langue pour déterminer s’ils correspondent à la même variété linguistique.

## Vue d’ensemble [#overview]

Appelez `isSameDialect` sur une instance de [`GT`](/docs/platform/core/reference/gt-class/constructor) en lui passant deux codes de langue ou plus (ou des tableaux de codes). La méthode renvoie `true` s’ils correspondent tous au même dialecte.

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

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

Signature :

```typescript
isSameDialect(...locales: (string | string[])[]): boolean
```

*Remarque : `isSameDialect` s’exécute localement et ne nécessite pas de clé API. Les codes de langue invalides sont traités correctement et renvoient `false`. Pour effectuer des comparaisons sans instance `GT`, consultez la version autonome de [`isSameDialect`](/docs/platform/core/reference/utility-functions/locales/is-same-dialect).*

## Fonctionnement [#how-it-works]

### Logique de comparaison des dialectes

La méthode détermine l’égalité des dialectes comme suit :

1. **Normaliser les locales** — standardise tous les codes de locale fournis en entrée.
2. **Comparer les codes de langue** — tous les locales doivent avoir la même langue de base.
3. **Gérer la hiérarchie des régions** — une langue de base correspond à ses variantes régionales.
4. **Correspondance exacte des dialectes** — les variantes régionales doivent correspondre exactement.

### Règles de hiérarchie

* Une langue de base (`'en'`) correspond à n’importe quelle variante régionale (`'en-US'`, `'en-GB'`).
* Les variantes régionales ne correspondent qu’à une correspondance exacte (`'en-US'` ≠ `'en-GB'`).
* Les variantes d’écriture sont prises en compte dans la comparaison lorsqu’elles sont présentes.
* Des langues différentes ne correspondent jamais (`'en'` ≠ `'es'`).

### Flexibilité des entrées

La méthode accepte :

* Plusieurs paramètres de type `string` : `isSameDialect('en-US', 'en-GB')`
* Des tableaux de chaînes de caractères : `isSameDialect(['en-US', 'en-GB'])`
* Un format mixte : `isSameDialect('en-US', ['en-GB', 'en-CA'])`
* Un seul paramètre régional : `isSameDialect('en-US')` (renvoie toujours `true`)

## Paramètres [#parameters]

| Paramètre             | Description                                                                           | Type                     | Facultatif | Par défaut |
| --------------------- | ------------------------------------------------------------------------------------- | ------------------------ | ---------- | ---------- |
| [`locales`](#locales) | Un nombre variable de codes de langue, ou de tableaux de codes de langue, à comparer. | `(string \| string[])[]` | Non        | —          |

### `...locales` [#locales]

**Type** `(string | string[])[]` · **Obligatoire**

Un nombre variable de codes de langue (chaînes de caractères) ou de tableaux de codes de langue à comparer. Tous les locales fournis doivent correspondre au même dialecte.

## Renvoie [#returns]

**Type** `boolean`

`true` si tous les codes de langue fournis correspondent au même dialecte, `false` sinon. Aucune exception n’est levée ; les codes de langue invalides sont traités correctement et renvoient `false`.

## Exemples [#examples]

```typescript
// Comparaison de dialectes de base
const gt = new GT({ sourceLocale: 'en-US', targetLocale: 'es-ES' });

// Dialectes exactement identiques
console.log(gt.isSameDialect('en-US', 'en-US')); // true
console.log(gt.isSameDialect('zh-CN', 'zh-CN')); // true

// Dialectes différents d'une même langue
console.log(gt.isSameDialect('en-US', 'en-GB')); // false
console.log(gt.isSameDialect('es-ES', 'es-MX')); // false
console.log(gt.isSameDialect('pt-PT', 'pt-BR')); // false

// Langue de base avec variantes régionales
console.log(gt.isSameDialect('en', 'en-US')); // true
console.log(gt.isSameDialect('es', 'es-ES')); // true
console.log(gt.isSameDialect('zh', 'zh-CN')); // true

// Langues différentes
console.log(gt.isSameDialect('en-US', 'es-ES')); // false
console.log(gt.isSameDialect('fr-FR', 'de-DE')); // false
```

## Notes [#notes]

* Utilise des codes de langue normalisés pour des comparaisons précises.
* Accepte des formats d’entrée souples (chaînes de caractères, tableaux ou mixtes).