Utility FunctionsLocales
standardizeLocale
Riferimento API alla funzione standardizeLocale
Panoramica
La funzione standardizeLocale normalizza un codice locale BCP‑47 per garantire formattazione e maiuscole/minuscole corrette, senza richiedere un'istanza della classe GT.
import { standardizeLocale } from 'generaltranslation';
// Corregge i problemi di formattazione più comuni
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'
// Le locale già standardizzate passano senza modifiche
console.log(standardizeLocale('es-ES')); // 'es-ES'Riferimenti
Parametri
Prop
Type
Restituisce
string - Codice locale BCP-47 normalizzato oppure stringa vuota se non valido
Esempi
Elaborazione dell’input dell’utente
import { standardizeLocale, isValidLocale } from 'generaltranslation';
function processUserInput(input: string) {
const standardized = standardizeLocale(input.trim());
const isValid = isValidLocale(standardized);
return {
original: input,
standardized,
isValid
};
}
// Test di vari input
const inputs = ['en_us', 'FR-ca', 'invalid', 'zh-CN'];
inputs.forEach(input => {
console.log(processUserInput(input));
});Note
- Converte gli underscore in trattini
- Normalizza le maiuscole/minuscole (lingua in minuscolo, regione in maiuscolo)
- Restituisce una stringa vuota per formati non validi
- Essenziale per normalizzare gli input di locale da varie fonti
- Nessuna dipendenza esterna: pura manipolazione di stringhe
Passaggi successivi
- Usa il metodo di classe GT
standardizeLocale - Valida con
isValidLocale
Come valuti questa guida?