# General Translation Platform: resolveAliasLocale
URL: https://generaltranslation.com/it/docs/platform/core/reference/gt-class-methods/locales/resolve-alias-locale.mdx
---

title: resolveAliasLocale
description: Converte un alias di impostazione regionale nel codice locale usato da una mappatura personalizzata. Riferimento API per resolveAliasLocale.

---

Su un'istanza di [GT](/docs/platform/core/reference/gt-class/constructor), riconverte un codice locale canonico nel suo codice locale alias originale quando è configurata una mappatura personalizzata. Questo è l'inverso di [`resolveCanonicalLocale`](/docs/platform/core/reference/gt-class-methods/locales/resolve-canonical-locale). General Translation usa gli alias per consentirti di esporre i tuoi codici locale, mappandoli internamente a codici BCP-47 standard.

## Panoramica [#overview]

Chiama `resolveAliasLocale` su un'istanza di [`GT`](/docs/platform/core/reference/gt-class/constructor) con un codice locale canonico. Restituisce l'alias configurato, se presente; altrimenti restituisce invariato l'impostazione regionale di input.

```typescript
const gt = new GT({
  sourceLocale: 'en',
  customMapping: {
    cn: { code: 'zh', name: 'Mandarin' },
  },
});

const alias = gt.resolveAliasLocale('zh');
console.log(alias); // "cn"
```

Firma:

```typescript
resolveAliasLocale(
  locale: string,
  customMapping?: CustomMapping
): string
```

*Nota: `resolveAliasLocale` viene eseguita localmente e non richiede una chiave API. Usa il `customMapping` dell'istanza quando `customMapping` viene omesso. Per la risoluzione senza un'istanza `GT`, consulta la versione autonoma di [`resolveAliasLocale`](/docs/platform/core/reference/utility-functions/locales/resolve-alias-locale).*

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

* **Ricerca inversa.** Recupera l'alias configurato per un'impostazione regionale canonica in [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping).
* **Pass-through.** Restituisce l'impostazione regionale di input invariata quando è già un alias o quando non esiste alcuna mappatura di alias.
* **Fallback della mappatura.** Quando `customMapping` viene omesso, viene usato il `customMapping` dell'istanza.

## Parametri [#parameters]

| Parametro                          | Descrizione                                                            | Tipo                                                                  | Facoltativo | Predefinito          |
| ---------------------------------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------- | ----------- | -------------------- |
| [`locale`](#locale)                | Il codice locale canonico da risolvere al relativo alias.              | `string`                                                              | No          | —                    |
| [`customMapping`](#custom-mapping) | Mappatura personalizzata da usare al posto del mapping dell'istanza. | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Sì          | `this.customMapping` |

### `locale` [#locale]

**Tipo** `stringa` · **Obbligatorio**

Il codice locale canonico a cui ricondurre il relativo alias.

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

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

Mappatura personalizzata da utilizzare al posto di quella dell'istanza.

## Restituisce [#returns]

**Tipo** `string`

L'alias configurato per un'impostazione regionale canonica, oppure l'impostazione regionale di input invariata se è già un alias o se non esiste alcuna mappatura degli alias.

## Esempi [#examples]

```typescript
const gt = new GT({
  sourceLocale: 'en',
  customMapping: {
    cn: { code: 'zh', name: 'Mandarin' },
  },
});

// Risolve l'impostazione regionale canonica nell'alias
const alias = gt.resolveAliasLocale('zh');
console.log(alias); // "cn"

// L'impostazione regionale senza mapping restituisce il valore originale
const unchanged = gt.resolveAliasLocale('es');
console.log(unchanged); // "es"
```

## Note [#notes]

* Restituisce il codice locale alias originale quando esiste una mappatura personalizzata.
* Restituisce l'impostazione regionale di input senza modifiche se non viene trovato alcun mapping.