Utility FunctionsLocales
standardizeLocale
Référence de l’API pour la fonction standardizeLocale
Aperçu
La fonction standardizeLocale normalise un code de locale BCP-47 afin d’assurer le bon formatage et la casse, sans nécessiter d’instance de la classe GT.
import { standardizeLocale } from 'generaltranslation';
// Corrige les problèmes de formatage courants
console.log(standardizeLocale('en_us')); // 'en-US'
console.log(standardizeLocale('zh_cn')); // 'zh-CN'
console.log(standardizeLocale('EN-gb')); // 'en-GB'
console.log(standardizeLocale('fr-ca')); // 'fr-CA'
// Les locales déjà normalisées sont transmises telles quelles
console.log(standardizeLocale('es-ES')); // 'es-ES'Références
Paramètres
Prop
Type
Renvoie
string - Code de locale BCP-47 normalisé ou chaîne vide si non valide
Exemples
Traitement des entrées utilisateur
import { standardizeLocale, isValidLocale } from 'generaltranslation';
function processUserInput(input: string) {
const standardized = standardizeLocale(input.trim());
const isValid = isValidLocale(standardized);
return {
original: input,
standardized,
isValid
};
}
// Tester différents exemples d’entrée
const inputs = ['en_us', 'FR-ca', 'invalid', 'zh-CN'];
inputs.forEach(input => {
console.log(processUserInput(input));
});Notes
- Convertit les underscores en tirets
- Normalise la casse (langue en minuscules, région en majuscules)
- Renvoie une chaîne vide pour les formats invalides
- Indispensable pour normaliser l’entrée de locale provenant de diverses sources
- Aucune dépendance externe — manipulation de chaînes pure
Prochaines étapes
- Utilisez la méthode de la classe GT
standardizeLocale - Validez avec
isValidLocale
Que pensez-vous de ce guide ?