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

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

---

[`isSupersetLocale`](/docs/platform/core/reference/gt-class-methods/locales/is-superset-locale) è una funzione di utilità standalone della libreria Core di General Translation che verifica se un'impostazione regionale è un sovrainsieme di un'altra nella gerarchia BCP-47, ossia se può rappresentare l'impostazione regionale più specifica.

## Panoramica [#overview]

Importa `isSupersetLocale` direttamente da `generaltranslation` e chiamalo passando un'impostazione regionale sovrainsieme e un'impostazione regionale sottoinsieme. Non richiede una chiave API né un'istanza di [GT](/docs/platform/core/reference/gt-class/constructor). Per l'equivalente basato su istanza, usa invece il metodo [`isSupersetLocale`](/docs/platform/core/reference/gt-class-methods/locales/is-superset-locale) su un'istanza di [`GT`](/docs/platform/core/reference/gt-class/constructor).

```typescript
import { isSupersetLocale } from 'generaltranslation';

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

Firma:

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

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

* **Controllo della gerarchia.** Usa la gerarchia delle impostazioni regionali BCP-47. `subLocale` è un sottoinsieme di `superLocale` se ne è un'estensione o se è identico a esso.
* **Lingue di base.** Una lingua di base è un sovrainsieme delle proprie varianti regionali, ma una variante regionale non è un sovrainsieme della propria lingua di base.
* **Riflessiva.** Un'impostazione regionale è sempre un sovrainsieme di sé stessa.

## Parametri [#parameters]

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

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

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

L'impostazione regionale da controllare come potenziale sovrainsieme.

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

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

L'impostazione regionale da verificare come possibile sottoinsieme.

## Restituisce [#returns]

**Tipo** `boolean`

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

## Esempi [#examples]

```typescript
import { isSupersetLocale } from 'generaltranslation';

// La lingua base è un sovrainsieme di una variante regionale
console.log(isSupersetLocale('en', 'en-US')); // true
console.log(isSupersetLocale('es', 'es-ES')); // true

// Una variante regionale NON è un sovrainsieme della lingua base
console.log(isSupersetLocale('en-US', 'en')); // false

// Un'impostazione regionale è sempre un sovrainsieme di se stessa
console.log(isSupersetLocale('en-US', 'en-US')); // true
```

## Note [#notes]

* Usa la gerarchia delle impostazioni regionali BCP-47.
* Le lingue di base sono sovrainsiemi delle varianti regionali.
* Un'impostazione regionale è sempre un sovrainsieme di se stessa.
* Essenziale per creare sistemi di fallback.