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

title: resolveAliasLocale
description: Résout un alias de paramètre régional en code de langue utilisé par un mapping personnalisé. Référence de l’API de resolveAliasLocale.

---

Sur une instance [GT](/docs/platform/core/reference/gt-class/constructor), résout un code de langue canonique en son alias de paramètre régional d’origine lorsqu’un mapping personnalisé est configuré. Il s’agit de l’inverse de [`resolveCanonicalLocale`](/docs/platform/core/reference/gt-class-methods/locales/resolve-canonical-locale). General Translation utilise des alias pour vous permettre d’exposer vos propres codes de langue tout en les associant en interne à des codes BCP-47 standard.

## Vue d’ensemble [#overview]

Appelez `resolveAliasLocale` sur une instance de [`GT`](/docs/platform/core/reference/gt-class/constructor) avec un code de langue canonique. La méthode renvoie l’alias configuré s’il existe ; sinon, elle renvoie le paramètre régional d’entrée tel quel.

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

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

Signature :

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

*Remarque : `resolveAliasLocale` s’exécute localement et ne nécessite pas de clé API. Cette fonction utilise le `customMapping` de l’instance lorsque `customMapping` est omis. Pour une résolution sans instance `GT`, consultez la version autonome de [`resolveAliasLocale`](/docs/platform/core/reference/utility-functions/locales/resolve-alias-locale).*

## Fonctionnement [#how-it-works]

* **Recherche inversée.** Recherche l'alias configuré pour un code de langue canonique dans [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping).
* **Transmission telle quelle.** Renvoie le paramètre régional d'entrée inchangé lorsqu'il s'agit déjà d'un alias ou qu'aucun mapping d'alias n'existe.
* **Mapping par défaut.** Lorsque `customMapping` est omis, le `customMapping` de l'instance est utilisé.

## Paramètres [#parameters]

| Paramètre                          | Description                                                            | Type                                                                  | Facultatif | Par défaut           |
| ---------------------------------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------- | ---------- | -------------------- |
| [`locale`](#locale)                | Le code de langue canonique pour retrouver son alias.                  | `string`                                                              | Non        | —                    |
| [`customMapping`](#custom-mapping) | Mapping personnalisé à utiliser à la place de celui de l'instance. | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Oui        | `this.customMapping` |

### `locale` [#locale]

**Type** `string` · **Obligatoire**

Le code de langue canonique à faire correspondre à son alias.

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

**Type** [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) · **Facultatif** · **Par défaut** `this.customMapping`

Mapping personnalisé à utiliser à la place de celui de l’instance.

## Returns [#returns]

**Type** `string`

L’alias configuré pour un paramètre régional canonique, ou le paramètre régional d’entrée inchangé s’il s’agit déjà d’un alias ou s’il n’existe aucune correspondance d’alias.

## Exemples [#examples]

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

// Résoudre le code de langue canonique en alias
const alias = gt.resolveAliasLocale('zh');
console.log(alias); // "cn"

// Un paramètre régional sans correspondance retourne l'original
const unchanged = gt.resolveAliasLocale('es');
console.log(unchanged); // "es"
```

## Remarques [#notes]

* Retourne le code de langue alias d’origine lorsqu’un mapping personnalisé existe.
* Retourne le paramètre régional d’entrée tel quel si aucun mapping n’est trouvé.