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

title: isSupersetLocale
description: Comprueba si una configuración regional puede representar otra configuración regional más específica. Referencia de la API de isSupersetLocale.

---

Comprueba si una configuración regional es un superconjunto de otra dentro de la jerarquía BCP-47, en una instancia de [GT](/docs/platform/core/reference/gt-class/constructor). Una configuración regional superconjunto es más general y puede servir como contenido alternativo para configuraciones regionales más específicas. General Translation usa esto para determinar las cadenas de contenido alternativo de las configuraciones regionales.

## Descripción general [#overview]

Llama a `isSupersetLocale` en una instancia de [`GT`](/docs/platform/core/reference/gt-class/constructor) con una posible configuración regional superconjunto y una posible configuración regional más específica. Devuelve `true` cuando la primera es un superconjunto de la segunda.

```typescript
const gt = new GT();

console.log(gt.isSupersetLocale('en', 'en-US')); // true
console.log(gt.isSupersetLocale('en-US', 'en')); // false
```

Firma:

```typescript
isSupersetLocale(superLocale: string, subLocale: string): boolean
```

*Nota: `isSupersetLocale` se ejecuta localmente y no requiere una clave de API. Para hacer comparaciones sin una instancia de `GT`, consulta la versión independiente de [`isSupersetLocale`](/docs/platform/core/reference/utility-functions/locales/is-superset-locale).*

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

* **Jerarquía BCP-47.** Usa la jerarquía de configuraciones regionales de BCP-47 para compararlas.
* **Reflexiva.** Una configuración regional siempre es un superconjunto de sí misma.
* **Idiomas base.** Los idiomas base son superconjuntos de sus variantes regionales, pero una variante regional no es un superconjunto de su idioma base.
* **Idiomas diferentes.** Devuelve `false` cuando se trata de idiomas completamente distintos.

## Parámetros [#parameters]

| Parámetro                      | Descripción                                                     | Tipo     | Opcional | Predeterminado |
| ------------------------------ | --------------------------------------------------------------- | -------- | -------- | -------------- |
| [`superLocale`](#super-locale) | La configuración regional que se comprobará como superconjunto. | `string` | No       | —              |
| [`subLocale`](#sub-locale)     | La configuración regional que se comprobará como subconjunto.   | `string` | No       | —              |

### `superLocale` [#super-locale]

**Tipo** `string` · **Obligatorio**

La configuración regional que se comprobará como el superconjunto (la configuración regional más general).

### `subLocale` [#sub-locale]

**Tipo** `string` · **Obligatorio**

La configuración regional que se comprobará como subconjunto, es decir, la configuración regional más específica.

## Devuelve [#returns]

**Tipo** `boolean`

`true` si `superLocale` es un superconjunto de `subLocale`; en caso contrario, `false`.

## Ejemplos [#examples]

```typescript
const gt = new GT();

// El idioma base es un superconjunto de la variante regional
console.log(gt.isSupersetLocale('en', 'en-US')); // true
console.log(gt.isSupersetLocale('es', 'es-ES')); // true
console.log(gt.isSupersetLocale('zh', 'zh-CN')); // true

// La variante regional NO es un superconjunto del idioma base
console.log(gt.isSupersetLocale('en-US', 'en')); // false
console.log(gt.isSupersetLocale('es-ES', 'es')); // false

// Mismas configuraciones regionales
console.log(gt.isSupersetLocale('en-US', 'en-US')); // true

// Idiomas distintos
console.log(gt.isSupersetLocale('en', 'es-ES')); // false
```

## Notas [#notes]

* Usa la jerarquía de configuraciones regionales de BCP-47 para hacer la comparación.
* Una configuración regional siempre es un superconjunto de sí misma.
* Los idiomas base son superconjuntos de sus variantes regionales.
* Devuelve `false` para idiomas completamente distintos.