# General Translation Platform: isValidLocale
URL: https://generaltranslation.com/es/docs/platform/core/reference/gt-class-methods/locales/is-valid-locale.mdx
---

title: isValidLocale
description: Comprueba si un valor es un código de configuración regional válido. Referencia de API para isValidLocale.

---

Valida que un código de configuración regional tenga el formato correcto y se reconozca como una configuración regional BCP-47 válida en una instancia de [GT](/docs/platform/core/reference/gt-class/constructor). General Translation comprueba la estructura de la configuración regional, el reconocimiento del idioma y la validez de la región y del script mediante las API de `Intl`, con soporte para mapeos personalizados de configuraciones regionales.

## Descripción general [#overview]

Llama a `isValidLocale` en una instancia de [`GT`](/docs/platform/core/reference/gt-class/constructor) con un código de configuración regional opcional. Si se omite, se usa el `targetLocale` de la instancia.

```typescript
const gt = new GT({ sourceLocale: 'en', targetLocale: 'es' });

console.log(gt.isValidLocale('en-US')); // true
console.log(gt.isValidLocale('invalid-locale')); // false
```

Firma:

```typescript
isValidLocale(
  locale?: string,
  customMapping?: CustomMapping
): boolean
```

*Nota: `isValidLocale` se ejecuta localmente con las API de `Intl` y no requiere una API Key. Usa `targetLocale` y `customMapping` de la instancia cuando se omiten esos argumentos. Para validar sin una instancia de `GT`, consulta la versión independiente de [`isValidLocale`](/docs/platform/core/reference/utility-functions/locales/is-valid-locale).*

## Cómo funciona [#how-it-works]

* **Validación de BCP-47.** Realiza una validación exhaustiva de configuraciones regionales BCP-47 mediante las API `Intl` del navegador.
* **Resolución de mapeos personalizados.** Los locales que aparecen como claves en un [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) se resuelven a su `code` canónico, y ese código canónico se valida después con las comprobaciones estándar de `Intl`; una configuración regional con mapeo personalizado no es automáticamente válida.
* **Códigos de uso privado.** Admite códigos de idioma de uso privado (`qaa`–`qtz`).
* **Configuración regional de respaldo.** Cuando se omite `locale`, se usa el `targetLocale` de la instancia.
* **Configuración regional ausente.** Lanza un `Error` si no se proporciona ninguna configuración regional y la instancia no tiene ningún `targetLocale` configurado.

## Parámetros [#parameters]

| Parámetro                          | Descripción                                                           | Tipo                                                                  | Opcional | Predeterminado       |
| ---------------------------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------- | -------- | -------------------- |
| [`locale`](#locale)                | Código de configuración regional BCP-47 que se debe validar.          | `string`                                                              | Sí       | `this.targetLocale`  |
| [`customMapping`](#custom-mapping) | Mapeo personalizado para comprobar locales válidos adicionales. | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Sí       | `this.customMapping` |

### `locale` [#locale]

**Tipo** `string` · **Opcional** · **Predeterminado** `this.targetLocale`

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` [#custom-mapping]

**Tipo** [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) · **Opcional** · **Predeterminado** `this.customMapping`

Mapeo personalizado para comprobar si hay locales válidos adicionales. Si no se proporciona, se usa el `customMapping` de la instancia.

## Devuelve [#returns]

**Tipo** `boolean`

`true` si la configuración regional es válida; `false` en caso contrario. Lanza un `Error` si no se proporciona una configuración regional y la instancia no tiene `targetLocale` configurado.

## Ejemplos [#examples]

```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 [#notes]

* Realiza una validación exhaustiva de la configuración regional BCP-47 mediante las API `Intl` del navegador.
* Las claves de mapeo personalizado se resuelven a su `code` canónico, que luego se valida con las comprobaciones estándar de `Intl` (no se consideran válidas automáticamente).
* Admite códigos de idioma de uso privado (`qaa`–`qtz`).
* Devuelve `false` para códigos de configuración regional malformados o no reconocidos.