# generaltranslation: General Translation Core SDK: isSameDialect
URL: https://generaltranslation.com/fr/docs/core/class/methods/locales/is-same-dialect.mdx
---
title: isSameDialect
description: Référence de l’API pour la méthode GT isSameDialect
---

## Vue d’ensemble

La méthode `isSameDialect` vérifie si plusieurs codes de langue BCP-47 correspondent au même dialecte.
Elle compare les éléments de langue et de région des codes de langue afin de déterminer s’ils renvoient à la même variété linguistique.

***

## Référence

### Paramètres

<TypeTable
  type={{
  "...locales": {
    type: '(string | string[])[]',
    optional: false,
  }
}}
/>

### Description des paramètres

| Paramètre    | Description                                                                                                                                                                          |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `...locales` | Nombre variable de codes de langue (chaînes de caractères) ou de tableaux de codes de langue à comparer. Tous les paramètres régionaux fournis doivent correspondre au même dialecte |

### Renvoie

`boolean` - `true` si tous les codes de langue fournis correspondent au même dialecte, `false` sinon

### Exceptions levées

Aucune exception n’est levée. Les codes de langue non valides sont gérés de manière fiable et renvoient `false`.

***

## Fonctionnement

### Logique de comparaison des dialectes

La méthode applique la logique suivante pour déterminer si des dialectes sont égaux :

1. **Normaliser les paramètres régionaux** - Standardise tous les codes de langue en entrée
2. **Comparer les codes de langue** - Tous les paramètres régionaux doivent partager 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

* La langue de base (`'en'`) correspond à n&#39;importe quelle variante régionale (`'en-US'`, `'en-GB'`)
* Les variantes régionales correspondent uniquement à une correspondance exacte (`'en-US'` ≠ `'en-GB'`)
* Les variantes de script sont prises en compte dans la comparaison lorsqu&#39;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 chaîne : `isSameDialect('en-US', 'en-GB')`
* Des tableaux de chaînes : `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`)

***

## Exemples

### Comparaison simple des dialectes

```typescript
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

* Utilise des codes de langue normalisés pour une comparaison précise
* Accepte des formats d’entrée flexibles (chaînes, tableaux ou mixtes)

## Étapes suivantes

* Comparer les langues avec [`isSameLanguage`](/docs/core/class/methods/locales/is-same-language)
* Vérifier la hiérarchie des paramètres régionaux avec [`isSupersetLocale`](/docs/core/class/methods/locales/is-superset-locale)
* Valider les paramètres régionaux avec [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale)