Présentation

La méthode isValidLocale vérifie si un code de locale est correctement formaté et reconnu comme un locale BCP‑47 valide. Elle contrôle la structure du locale, la reconnaissance de la langue et la validité des sous‑balises régionales/script à l’aide des API Intl, avec prise en charge de mappages de locales personnalisés.

Références

Paramètres

Description des paramètres

Renvoie

boolean - true si le locale est valide, false sinon

Exceptions

• Error - Si aucune locale n’est fournie et qu’aucun targetLocale n’est configuré pour l’instance

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 mappages de locales personnalisés sont toujours considérés comme valides (contournent la validation standard)
• Prend en charge les codes de langue à usage privé (qaa-qtz)
• Retourne false pour les codes de locale mal formés ou non reconnus

Prochaines étapes

• Récupérer les propriétés de locale avec getLocaleProperties
• Déterminer la meilleure locale avec determineLocale
• Récupérer les noms de locale avec getLocaleName
• En savoir plus sur le type CustomMapping