Panoramica

Il metodo isSameDialect verifica se più codici locale BCP‑47 rappresentano lo stesso dialetto. Confronta le componenti lingua e regione dei codici locale per stabilire se rappresentano la stessa varietà linguistica.

Riferimenti

Parametri

Descrizione dei parametri

Restituisce

boolean - true se tutti i codici di locale forniti rappresentano lo stesso dialetto, false altrimenti

Eccezioni

Non vengono sollevate eccezioni. I codici di locale non validi vengono gestiti in modo appropriato e restituiscono false.

Comportamento

Logica di confronto dei dialetti

Il metodo utilizza la seguente logica per determinare l’equivalenza dei dialetti:

1. Normalizzare le locale - Standardizzare tutti i codici locale in input
2. Confrontare i codici della lingua - Tutte le locale devono avere la stessa lingua di base
3. Gestire la gerarchia delle regioni - Una lingua di base corrisponde alle sue varianti regionali
4. Corrispondenza esatta del dialetto - Le varianti regionali devono combaciare esattamente

Regole di gerarchia

• La lingua base ('en') corrisponde a qualsiasi variante regionale ('en-US', 'en-GB')
• Le varianti regionali corrispondono solo se esattamente uguali ('en-US' ≠ 'en-GB')
• Le varianti di script vengono considerate nel confronto quando 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'])
• Singola locale: isSameDialect('en-US') (restituisce sempre true)

Esempi

Confronto di base tra dialetti

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

// Stesso dialetto identico
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

• Utilizza codici di locale standardizzati per confronti accurati
• Accetta formati di input flessibili (stringhe, array, misti)

Prossimi passaggi

• Confronta le lingue con isSameLanguage
• Verifica la gerarchia delle localizzazioni con isSupersetLocale
• Convalida le localizzazioni con isValidLocale