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

title: resolveCanonicalLocale
description: Resuelve un alias de configuración regional a su código de configuración regional canónico en una instancia de GT. Referencia de la API de resolveCanonicalLocale.

---

Resuelve un alias de configuración regional al código de configuración regional BCP-47 canónico que se usa internamente en una instancia de [GT](/docs/platform/core/reference/gt-class/constructor). Esto es lo inverso de [`resolveAliasLocale`](/docs/platform/core/reference/gt-class-methods/locales/resolve-alias-locale). General Translation usa un mapeo personalizado para que puedas exponer tus propios códigos de configuración regional mientras traduces y aplicas formato internamente con códigos estándar.

## Descripción general [#overview]

Llama a `resolveCanonicalLocale` en una instancia de [`GT`](/docs/platform/core/reference/gt-class/constructor) con un código de configuración regional. Devuelve la configuración regional canónica si el código es un alias configurado; 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 canonical = gt.resolveCanonicalLocale('cn');
console.log(canonical); // "zh"
```

Firma:

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

*Nota: `resolveCanonicalLocale` se ejecuta localmente y no requiere una clave de API. Usa la configuración regional de destino de la instancia y `customMapping` cuando se omiten los argumentos. Para resolverla sin una instancia de `GT`, consulta [`resolveCanonicalLocale`](/docs/platform/core/reference/utility-functions/locales/resolve-canonical-locale) independiente.*

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

* **Búsqueda hacia adelante.** Busca la configuración regional canónica de un alias en [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping).
* **Transferencia sin cambios.** Devuelve la configuración regional de entrada sin modificar cuando no tiene un mapeo canónico.
* **Contenido alternativo de la instancia.** Cuando se omite `locale`, se usa la configuración regional de destino de la instancia; cuando se omite `customMapping`, se usa el `customMapping` de la instancia.
* **Lanza un error** cuando no hay ninguna configuración regional disponible (ni un argumento ni la configuración regional de destino de la instancia).

## Parámetros [#parameters]

| Parámetro                          | Descripción                                                                        | Tipo                                                                  | Opcional | Predeterminado       |
| ---------------------------------- | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------- | -------- | -------------------- |
| [`locale`](#locale)                | El código alias de configuración regional que debe resolverse a su forma canónica. | `string`                                                              | Sí       | `this.targetLocale`  |
| [`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` · **Opcional** · **Predeterminado** `this.targetLocale`

El código alias de configuración regional que se debe resolver. Si se omite, se usa la configuración regional de destino de la instancia.

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

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

Mapeo personalizado que se usará en lugar del mapeo de la instancia.

## Devuelve [#returns]

**Tipo** `string`

La configuración regional canónica del alias, o la configuración regional de entrada sin cambios si no existe un mapeo canónico.

## Ejemplos [#examples]

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

// Resolver alias a configuración regional canónica
console.log(gt.resolveCanonicalLocale('cn')); // "zh"

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

## Notas [#notes]

* Es lo inverso de [`resolveAliasLocale`](/docs/platform/core/reference/gt-class-methods/locales/resolve-alias-locale).
* Devuelve la configuración regional de entrada sin cambios si no se encuentra ningún mapeo canónico.