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

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

---

[`isValidLocale`](/docs/platform/core/reference/gt-class-methods/locales/is-valid-locale) è una funzione di utilità autonoma della libreria Core di General Translation che verifica se una stringa è un codice locale BCP-47 valido. Esegue la verifica del formato senza richiedere un'istanza GT.

## Panoramica [#overview]

Importa `isValidLocale` direttamente da `generaltranslation` e chiamalo con un codice locale. Non richiede una chiave API né un'istanza di [GT](/docs/platform/core/reference/gt-class/constructor). Per l'equivalente che usa un'istanza, utilizza invece il metodo [`isValidLocale`](/docs/platform/core/reference/gt-class-methods/locales/is-valid-locale) su un'istanza di [`GT`](/docs/platform/core/reference/gt-class/constructor).

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

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

Firma:

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

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

* **Verifica del formato.** Convalida il formato del codice locale BCP-47. Si tratta di una semplice verifica del formato: non viene effettuata alcuna richiesta di rete.
* **Custom mapping.** Funziona con mapping personalizzati delle impostazioni regionali, quindi gli alias definiti in un [`customMapping`](/docs/platform/core/reference/types/custom-mapping) sono considerati validi.
* **Senza stato.** Adatto a librerie di utilità e alla validazione dell'input utente.

## Parametri [#parameters]

| Parametro                          | Descrizione                                                       | Tipo                                                                  | Facoltativo | Predefinito |
| ---------------------------------- | ----------------------------------------------------------------- | --------------------------------------------------------------------- | ----------- | ----------- |
| [`locale`](#locale)                | Il valore da validare.                                            | `string`                                                              | No          | —           |
| [`customMapping`](#custom-mapping) | Mappatura personalizzata da considerare durante la validazione. | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Sì          | —           |

### `locale` [#locale]

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

Il valore da validare come codice locale BCP-47.

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

**Tipo** [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) · **Facoltativo**

Una mappatura personalizzata facoltativa, i cui alias sono considerati validi.

## Restituisce [#returns]

**Tipo** `boolean`

`true` se il codice locale è valido, `false` in caso contrario.

## Esempi [#examples]

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

// Codici locale validi
console.log(isValidLocale('en-US')); // true
console.log(isValidLocale('zh-CN')); // true
console.log(isValidLocale('es')); // true

// Codici locale non validi
console.log(isValidLocale('invalid')); // false
console.log(isValidLocale('en_US')); // false (underscore invece del trattino)
console.log(isValidLocale('')); // false
```

## Note [#notes]

* Verifica il formato del codice locale BCP-47.
* Funziona con mapping personalizzati delle impostazioni regionali.
* Essenziale per la convalida dell'input utente.
* Nessuna richiesta di rete — solo verifica del formato.
* Funzione senza stato adatta alle librerie di utilità.