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/escritura usando 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 a validar. Si no se proporciona, se usa el targetLocale de la instancia
customMappingAsignación personalizada opcional para comprobar locales adicionales válidos. Si no se proporciona, se usa el customMapping de la instancia

Devuelve

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

Lanza

  • Error - Si no se proporciona un locale y la instancia no tiene un 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 completa de BCP-47 para locales usando las APIs Intl 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 con formato incorrecto o no reconocidos

Próximos pasos

¿Qué te parece esta guía?