# generaltranslation: General Translation Core SDK: isValidLocale
URL: https://generaltranslation.com/es/docs/core/class/methods/locales/is-valid-locale.mdx
---
title: isValidLocale
description: Referencia de la API para el método isValidLocale de GT
---

## Resumen

El método `isValidLocale` valida si un código de configuración regional tiene un formato correcto y se reconoce como una configuración regional válida según BCP-47.
Comprueba la estructura de la configuración regional, el reconocimiento del idioma y la validez de la región y del sistema de escritura mediante las API de `Intl`, con compatibilidad con asignaciones personalizadas de configuraciones regionales.

***

## Referencia

### Parámetros

<TypeTable
  type={{
  "locale?": {
    type: 'string',
    optional: true,
    default: 'this.targetLocale',
  },
  "customMapping?": {
    type: 'CustomMapping',
    optional: true,
    default: 'this.customMapping',
  }
}}
/>

### Descripción de los parámetros

| Parámetro       | Descripción                                                                                                                                                      |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `locale`        | Código de configuración regional BCP-47 que se va a validar. Si no se proporciona, se usa el `targetLocale` de la instancia                                      |
| `customMapping` | Asignación personalizada opcional para comprobar configuraciones regionales válidas adicionales. Si no se proporciona, se usa el `customMapping` de la instancia |

### Devuelve

`boolean`: `true` si la configuración regional es válida; `false` en caso contrario

### Lanza

* `Error` - Si no se proporciona ninguna configuración regional y la instancia no tiene configurado `targetLocale`

***

## Ejemplos

```typescript
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 exhaustiva de configuraciones regionales BCP-47 mediante las APIs `Intl` del navegador
* Las locales con asignación personalizada 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

* **[Obtén las propiedades de la configuración regional con getLocaleProperties](/docs/core/class/methods/locales/get-locale-properties)**
* **[Determina la mejor configuración regional con determineLocale](/docs/core/class/methods/locales/determine-locale)**
* **[Obtén los nombres de las configuraciones regionales con getLocaleName](/docs/core/class/methods/locales/get-locale-name)**
* **[Más información sobre el tipo CustomMapping](/docs/core/types/custom-mapping)**