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

title: isSameDialect
description: Verifica se due impostazioni regionali corrispondono allo stesso dialetto. Riferimento API per isSameDialect.

---

Verifica se più codici locale BCP-47 corrispondono allo stesso dialetto in un'istanza di [GT](/docs/platform/core/reference/gt-class/constructor). General Translation confronta i componenti della lingua e della regione dei codici locale per stabilire se corrispondono alla stessa varietà linguistica.

## Panoramica [#overview]

Chiama `isSameDialect` su un'istanza di [`GT`](/docs/platform/core/reference/gt-class/constructor) passando due o più codici locale (o array di codici). Restituisce `true` quando rappresentano tutti lo stesso dialetto.

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

Firma:

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

*Nota: `isSameDialect` viene eseguito localmente e non richiede una chiave API. I codici locale non validi vengono gestiti correttamente e restituiscono `false`. Per i confronti senza un'istanza `GT`, consulta [`isSameDialect`](/docs/platform/core/reference/utility-functions/locales/is-same-dialect) autonomo.*

## Come funziona [#how-it-works]

### Logica di confronto dei dialetti

Il metodo determina l'equivalenza dei dialetti come segue:

1. **Normalizza le impostazioni regionali** — standardizza tutti i codici locale in input.
2. **Confronta i codici lingua** — tutte le impostazioni regionali devono avere la stessa lingua di base.
3. **Gestisci la gerarchia delle regioni** — una lingua di base corrisponde alle relative varianti regionali.
4. **Corrispondenza esatta dei dialetti** — le varianti regionali devono corrispondere esattamente.

### Regole di gerarchia

* Una lingua di base (`'en'`) corrisponde a qualsiasi variante regionale (`'en-US'`, `'en-GB'`).
* Le varianti regionali corrispondono solo se coincidono esattamente (`'en-US'` ≠ `'en-GB'`).
* Le varianti di script vengono considerate nel confronto, se presenti.
* Lingue diverse non corrispondono mai (`'en'` ≠ `'es'`).

### Flessibilità dell'input

Il metodo accetta:

* Più parametri di tipo stringa: `isSameDialect('en-US', 'en-GB')`
* Array di stringhe: `isSameDialect(['en-US', 'en-GB'])`
* Formato misto: `isSameDialect('en-US', ['en-GB', 'en-CA'])`
* Una singola impostazione regionale: `isSameDialect('en-US')` (restituisce sempre `true`)

## Parametri [#parameters]

| Parametro             | Descrizione                                                                | Tipo                     | Facoltativo | Predefinito |
| --------------------- | -------------------------------------------------------------------------- | ------------------------ | ----------- | ----------- |
| [`locales`](#locales) | Numero variabile di codici locale o array di codici locale da confrontare. | `(string \| string[])[]` | No          | —           |

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

**Tipo** `(string | string[])[]` · **Obbligatorio**

Un numero variabile di codici locale (stringhe) o di array di codici locale da confrontare. Tutte le impostazioni regionali fornite devono rappresentare lo stesso dialetto.

## Restituisce [#returns]

**Tipo** `boolean`

`true` se tutti i codici locale forniti rappresentano lo stesso dialetto, `false` in caso contrario. Non viene generata alcuna eccezione; i codici locale non validi vengono gestiti correttamente e restituiscono `false`.

## Esempi [#examples]

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

// Dialetti esattamente uguali
console.log(gt.isSameDialect('en-US', 'en-US')); // true
console.log(gt.isSameDialect('zh-CN', 'zh-CN')); // true

// Dialetti diversi della stessa lingua
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

// Lingua base con varianti regionali
console.log(gt.isSameDialect('en', 'en-US')); // true
console.log(gt.isSameDialect('es', 'es-ES')); // true
console.log(gt.isSameDialect('zh', 'zh-CN')); // true

// Lingue diverse
console.log(gt.isSameDialect('en-US', 'es-ES')); // false
console.log(gt.isSameDialect('fr-FR', 'de-DE')); // false
```

## Note [#notes]

* Usa codici locale standardizzati per un confronto accurato.
* Accetta formati di input flessibili (stringhe, array, misti).