GT ClassMethodsLocales

isValidLocale

Référence de l’API pour la méthode GT isValidLocale

Vue d’ensemble

La méthode isValidLocale valide si un code de locale est correctement formaté et reconnu comme un locale BCP‑47 valide. Elle vérifie la structure de la locale, la reconnaissance de la langue et la validité des régions/scripts à l’aide des API Intl, avec prise en charge des correspondances de locales personnalisées.


Références

Paramètres

Prop

Type

Description des paramètres

ParamètreDescription
localeCode de locale BCP-47 à valider. S’il n’est pas fourni, utilise le targetLocale de l’instance
customMappingMappage personnalisé optionnel pour vérifier des locales supplémentaires valides. S’il n’est pas fourni, utilise le customMapping de l’instance

Renvoie

boolean - true si le locale est valide, false sinon

Lève

  • Error - Si aucune locale n’est fournie et que l’instance n’a pas de targetLocale configurée

Exemples

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

Notes

  • Effectue une validation complète des locales BCP‑47 à l’aide des API Intl du navigateur
  • Les correspondances de locales personnalisées sont toujours considérées comme valides (contournent la validation standard)
  • Prend en charge les codes de langue à usage privé (qaa–qtz)
  • Renvoie false pour les codes de locale malformés ou non reconnus

Prochaines étapes

Comment trouvez-vous ce guide ?