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

title: isSupersetLocale
description: Verifica se un'impostazione regionale può rappresentarne un'altra più specifica. Riferimento API per isSupersetLocale.

---

Verifica se un'impostazione regionale è un sovrainsieme di un'altra nella gerarchia BCP-47, su un'istanza di [GT](/docs/platform/core/reference/gt-class/constructor). Un'impostazione regionale sovrainsieme è più generale e può fungere da fallback per impostazioni regionali più specifiche. General Translation usa questo concetto per determinare le catene di fallback delle impostazioni regionali.

## Panoramica [#overview]

Chiama `isSupersetLocale` su un'istanza di [`GT`](/docs/platform/core/reference/gt-class/constructor) con un'impostazione regionale candidata come sovrainsieme e un'altra candidata come sottoinsieme. Restituisce `true` quando la prima è un sovrainsieme della seconda.

```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` viene eseguito localmente e non richiede una chiave API. Per i confronti senza un'istanza `GT`, consulta la versione autonoma di [`isSupersetLocale`](/docs/platform/core/reference/utility-functions/locales/is-superset-locale).*

## Come funziona [#how-it-works]

* **Gerarchia BCP-47.** Usa la gerarchia delle impostazioni regionali BCP-47 per il confronto.
* **Riflessivo.** Un'impostazione regionale è sempre un sovrainsieme di sé stessa.
* **Lingue di base.** Le lingue di base sono sovrainsiemi delle rispettive varianti regionali, ma una variante regionale non è un sovrainsieme della lingua di base.
* **Lingue diverse.** Restituisce `false` per lingue completamente diverse.

## Parametri [#parameters]

| Parametro                      | Descrizione                                                   | Tipo     | Facoltativo | Predefinito |
| ------------------------------ | ------------------------------------------------------------- | -------- | ----------- | ----------- |
| [`superLocale`](#super-locale) | L'impostazione regionale da verificare come sovrainsieme. | `string` | No          | —           |
| [`subLocale`](#sub-locale)     | L'impostazione regionale da verificare come sottoinsieme. | `string` | No          | —           |

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

**Tipo** `string` · **Obbligatorio**

L'impostazione regionale da verificare come sovrainsieme (l'impostazione regionale più generale).

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

**Type** `string` · **Obbligatorio**

L'impostazione regionale da considerare come sottoinsieme (l'impostazione regionale più specifica).

## Restituisce [#returns]

**Tipo** `boolean`

`true` se `superLocale` è un sovrainsieme di `subLocale`, `false` altrimenti.

## Esempi [#examples]

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

// La lingua base è sovrainsieme della variante regionale
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 regionale NON è sovrainsieme della lingua base
console.log(gt.isSupersetLocale('en-US', 'en')); // false
console.log(gt.isSupersetLocale('es-ES', 'es')); // false

// Stesse impostazioni regionali
console.log(gt.isSupersetLocale('en-US', 'en-US')); // true

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

## Note [#notes]

* Usa la gerarchia delle impostazioni regionali BCP-47 per il confronto.
* Un'impostazione regionale è sempre un sovrainsieme di se stessa.
* Le lingue di base sono sovrainsiemi delle rispettive varianti regionali.
* Restituisce `false` per lingue completamente diverse.