GT ClassMethodsLocales

isValidLocale

Referencia de API del método isValidLocale de GT

Descripción general

El método isValidLocale valida si un código de configuración regional está correctamente formateado y reconocido como un locale BCP-47 válido. Verifica la estructura del locale, el reconocimiento del idioma y la validez de la región/script utilizando las API de Intl, con soporte para asignaciones personalizadas de locales.


Referencias

Parámetros

Prop

Type

Descripción de parámetros

ParámetroDescripción
localeCódigo de configuración regional BCP-47 que se va a validar. Si no se proporciona, utiliza el targetLocale de la instancia
customMappingMapeo personalizado opcional para comprobar locales adicionales válidos. Si no se proporciona, utiliza el customMapping de la instancia

Devuelve

boolean - true si el locale es válido; false en caso contrario

Excepciones

  • Error - Si no se proporciona ningún locale y la instancia no tiene targetLocale configurado

Ejemplos

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

Notas

  • Realiza una validación integral de locales BCP-47 usando las Intl APIs del navegador
  • Los mapeos personalizados de locales siempre se validan como true (omiten la validación estándar)
  • Admite códigos de idioma de uso privado (qaa-qtz)
  • Devuelve false para códigos de configuración regional malformados o no reconocidos

Próximos pasos

¿Qué te ha parecido esta guía?

isValidLocale