# General Translation Platform: resolveAliasLocale
URL: https://generaltranslation.com/es/docs/platform/core/reference/gt-class-methods/locales/resolve-alias-locale.mdx
Docs index: https://generaltranslation.com/llms.txt
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.

Devuelve el código de alias que expusiste para una configuración regional canónica 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.

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.