# General Translation Platform: isSameDialect
URL: https://generaltranslation.com/fr/docs/platform/core/reference/gt-class-methods/locales/is-same-dialect.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Vérifie si deux paramètres régionaux correspondent au même dialecte. Référence de l’API isSameDialect.

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).

## Sitemap

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