# generaltranslation: General Translation Core SDK: isValidLocale
URL: https://generaltranslation.com/it/docs/core/class/methods/locales/is-valid-locale.mdx
---
title: isValidLocale
description: Documentazione di riferimento dell’API per il metodo isValidLocale di GT
---

## Panoramica

Il metodo `isValidLocale` verifica se un codice impostazione regionale è formattato correttamente e riconosciuto come una impostazione regionale BCP-47 valida.
Controlla la struttura dell'impostazione regionale, il riconoscimento della lingua e la validità di area geografica/script utilizzando le API `Intl`, con supporto per mappature personalizzate delle impostazioni regionali.

***

## Riferimento

### Parametri

<TypeTable
  type={{
  "locale?": {
    type: 'string',
    optional: true,
    default: 'this.targetLocale',
  },
  "customMapping?": {
    type: 'CustomMapping',
    optional: true,
    default: 'this.customMapping',
  }
}}
/>

### Descrizione dei parametri

| Parametro       | Descrizione                                                                                                                                                 |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `locale`        | Codice locale BCP-47 da convalidare. Se non specificato, utilizza il `targetLocale` dell&#39;istanza                                                        |
| `customMapping` | Mapping personalizzato facoltativo per verificare ulteriori impostazioni regionali valide. Se non specificato, utilizza il `customMapping` dell&#39;istanza |

### Valore restituito

`boolean`: `true` se l&#39;impostazione regionale è valida, `false` altrimenti

### Eccezioni

* `Error` - Se non viene specificata alcuna impostazione regionale e per l&#39;istanza non è configurato `targetLocale`

***

## Esempi

```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

* Esegue una convalida completa delle impostazioni regionali BCP-47 usando le API browser `Intl`
* Le impostazioni regionali con mapping personalizzato sono sempre considerate valide (`true`) e bypassano la convalida standard
* Supporta i codici lingua per uso privato (qaa-qtz)
* Restituisce `false` per i codici locale non validi o non riconosciuti

## Passaggi successivi

* **[Ottieni le proprietà dell&#39;impostazione regionale con getLocaleProperties](/docs/core/class/methods/locales/get-locale-properties)**
* **[Determina l&#39;impostazione regionale più adatta con determineLocale](/docs/core/class/methods/locales/determine-locale)**
* **[Ottieni i nomi delle impostazioni regionali con getLocaleName](/docs/core/class/methods/locales/get-locale-name)**
* **[Scopri il tipo CustomMapping](/docs/core/types/custom-mapping)**