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

title: isValidLocale
description: Verifica se un valore è un codice locale valido. Riferimento API per isValidLocale.

---

Verifica se un codice locale è formattato correttamente e riconosciuto come un'impostazione regionale BCP-47 valida in un'istanza di [GT](/docs/platform/core/reference/gt-class/constructor). General Translation controlla la struttura dell'impostazione regionale, il riconoscimento della lingua e la validità della regione/dello script tramite le API `Intl`, con supporto per mappature personalizzate delle impostazioni regionali.

## Panoramica [#overview]

Chiama `isValidLocale` su un'istanza di [`GT`](/docs/platform/core/reference/gt-class/constructor) con un codice locale facoltativo. Se viene omesso, viene usato il `targetLocale` dell'istanza.

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

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

Sintassi:

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

*Nota: `isValidLocale` viene eseguito localmente tramite le API `Intl` e non richiede una chiave API. Usa `targetLocale` e `customMapping` dell'istanza quando questi argomenti vengono omessi. Per la convalida senza un'istanza `GT`, consulta [`isValidLocale`](/docs/platform/core/reference/utility-functions/locales/is-valid-locale) autonomo.*

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

* **Convalida BCP-47.** Esegue una convalida completa delle impostazioni regionali BCP-47 tramite le API `Intl` del browser.
* **Risoluzione della mappatura personalizzata.** Le impostazioni regionali che corrispondono a chiavi in [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) vengono ricondotte al rispettivo `code` canonico, che viene poi convalidato con i controlli standard di `Intl`: un'impostazione regionale definita tramite mappatura personalizzata non è automaticamente valida.
* **Codici a uso privato.** Supporta i codici lingua a uso privato (`qaa`–`qtz`).
* **Impostazione regionale di fallback.** Quando `locale` viene omesso, viene usato il `targetLocale` dell'istanza.
* **Impostazione regionale mancante.** Genera un `Error` se non viene fornita alcuna impostazione regionale e l'istanza non ha alcun `targetLocale` configurato.

## Parametri [#parameters]

| Parametro                          | Descrizione                                                                                     | Tipo                                                                  | Facoltativo | Predefinito          |
| ---------------------------------- | ----------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | ----------- | -------------------- |
| [`locale`](#locale)                | Codice locale BCP-47 da validare.                                                               | `string`                                                              | Sì          | `this.targetLocale`  |
| [`customMapping`](#custom-mapping) | Mappatura personalizzata per verificare la presenza di ulteriori impostazioni regionali valide. | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Sì          | `this.customMapping` |

### `locale` [#locale]

**Type** `string` · **Facoltativo** · **Predefinito** `this.targetLocale`

Codice locale BCP-47 da validare. Se non specificato, viene usato `targetLocale` dell'istanza.

### `customMapping` [#custom-mapping]

**Type** [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) · **Facoltativo** · **Predefinito** `this.customMapping`

Mappatura personalizzata per verificare ulteriori impostazioni regionali valide. Se non viene fornita, usa il `customMapping` dell'istanza.

## Returns [#returns]

**Type** `boolean`

`true` se l'impostazione regionale è valida, `false` in caso contrario. Genera un `Error` se non viene fornita alcuna impostazione regionale e nell'istanza non è configurato alcun `targetLocale`.

## Esempi [#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
```

## Note [#notes]

* Esegue una convalida completa delle impostazioni regionali BCP-47 tramite le API `Intl` del browser.
* Le chiavi della mappatura personalizzata vengono risolte nel rispettivo `code` canonico, che viene poi convalidato con i controlli standard di `Intl` (non sono automaticamente valide).
* Supporta i codici lingua a uso privato (`qaa`–`qtz`).
* Restituisce `false` per i codici locale malformati o non riconosciuti.