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

title: resolveAliasLocale
description: Resuelve un alias de configuración regional al código de configuración regional usado por un mapeo personalizado. Referencia de la API de resolveAliasLocale.

---

Resuelve un código canónico de configuración regional para devolver su código de alias de configuración regional original cuando hay un mapeo personalizado configurado, en una instancia de [GT](/docs/platform/core/reference/gt-class/constructor). Es lo inverso de [`resolveCanonicalLocale`](/docs/platform/core/reference/gt-class-methods/locales/resolve-canonical-locale). General Translation usa alias para que puedas exponer tus propios códigos de configuración regional mientras los asigna internamente a códigos BCP-47 estándar.

## Resumen general [#overview]

Llama a `resolveAliasLocale` en una instancia de [`GT`](/docs/platform/core/reference/gt-class/constructor) y pásale un código de configuración regional canónico. Devuelve el alias configurado cuando existe; de lo contrario, devuelve la configuración regional de entrada sin cambios.

```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` se ejecuta localmente y no requiere una API Key. Usa el `customMapping` de la instancia cuando se omite `customMapping`. Para resolverlo sin una instancia de `GT`, consulta la versión independiente de [`resolveAliasLocale`](/docs/platform/core/reference/utility-functions/locales/resolve-alias-locale).*

## Cómo funciona [#how-it-works]

* **Búsqueda inversa.** Busca el alias configurado para una configuración regional canónica en [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping).
* **Paso directo.** Devuelve la configuración regional de entrada sin cambios cuando ya es un alias o cuando no existe ningún mapeo de alias.
* **Valor de reserva del mapeo.** Cuando se omite `customMapping`, se usa el `customMapping` de la instancia.

## Parámetros [#parameters]

| Parámetro                          | Descripción                                                                       | Tipo                                                                  | Opcional | Predeterminado       |
| ---------------------------------- | --------------------------------------------------------------------------------- | --------------------------------------------------------------------- | -------- | -------------------- |
| [`locale`](#locale)                | El código de configuración regional canónico que se resuelve de nuevo a su alias. | `string`                                                              | No       | —                    |
| [`customMapping`](#custom-mapping) | Mapeo personalizado que se usará en lugar del mapeo de la instancia.              | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Sí       | `this.customMapping` |

### `locale` [#locale]

**Tipo** `string` · **Obligatorio**

El código de configuración regional canónico que se resuelve a su alias.

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

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

Mapeo personalizado para usar en lugar del mapeo de la instancia.

## Devuelve [#returns]

**Tipo** `string`

El alias configurado para una configuración regional canónica, o la configuración regional de entrada sin cambios si ya es un alias o no existe ningún mapeo de alias.

## Ejemplos [#examples]

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

// Resolver la configuración regional canónica de vuelta al alias
const alias = gt.resolveAliasLocale('zh');
console.log(alias); // "cn"

// La configuración regional sin mapeo devuelve el original
const unchanged = gt.resolveAliasLocale('es');
console.log(unchanged); // "es"
```

## Notas [#notes]

* Devuelve el código de configuración regional del alias original cuando existe un mapeo personalizado.
* Devuelve la configuración regional de entrada sin cambios si no se encuentra ningún mapeo.