GT ClassMethodsLocales

isValidLocale

Riferimento API per il metodo GT isValidLocale

Panoramica

Il metodo isValidLocale verifica se un codice locale è formattato correttamente ed è riconosciuto come valido secondo lo standard BCP‑47. Controlla la struttura del locale, il riconoscimento della lingua e la validità di regione/script utilizzando le API Intl, con supporto per mappature personalizzate dei locali.


Riferimenti

Parametri

Prop

Type

Descrizione dei parametri

ParametroDescrizione
localeCodice locale BCP‑47 da validare. Se non specificato, usa il targetLocale dell'istanza
customMappingMappatura personalizzata opzionale per includere ulteriori locali validi. Se non specificata, usa la customMapping dell'istanza

Restituisce

boolean - true se il locale è valido, false altrimenti

Eccezioni

  • Error - Se non viene specificata una locale e l'istanza non ha un targetLocale configurato

Esempi

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

const isValid = gt.isValidLocale('en-US');
console.log(isValid); // true

const isInvalid = gt.isValidLocale('invalid-locale');
console.log(isInvalid); // false

Note

  • Esegue una convalida completa dei locali BCP‑47 utilizzando le API Intl del browser
  • I mapping di locali personalizzati risultano sempre validi (ignorano la convalida standard)
  • Supporta i codici di lingua a uso privato (qaa‑qtz)
  • Restituisce false per codici locale non validi o non riconosciuti

Prossimi passi

Come valuti questa guida?

isValidLocale