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

title: resolveAliasLocale
description: Résout l'alias d'un paramètre régional en code de langue utilisé par un mapping personnalisé, sans instance GT. Référence de l'API pour resolveAliasLocale.

---

[`resolveAliasLocale`](/docs/platform/core/reference/gt-class-methods/locales/resolve-alias-locale) est une fonction utilitaire autonome de la bibliothèque Core de General Translation qui reconvertit un code de langue canonique vers son code de langue alias lorsqu'un mapping personnalisé est configuré.

## Vue d’ensemble [#overview]

Importez `resolveAliasLocale` directement depuis `generaltranslation` et appelez-la avec un code de langue et un mapping personnalisé. Cela ne nécessite ni clé API ni instance de [GT](/docs/platform/core/reference/gt-class/constructor). Pour l’équivalent sous forme de méthode d’instance, utilisez plutôt la méthode [`resolveAliasLocale`](/docs/platform/core/reference/gt-class-methods/locales/resolve-alias-locale) sur une instance de [`GT`](/docs/platform/core/reference/gt-class/constructor).

```typescript
import { resolveAliasLocale } from 'generaltranslation';

const customMapping = {
  'simplified-chinese': { code: 'zh-CN', name: 'Simplified Chinese' },
  'traditional-chinese': { code: 'zh-TW', name: 'Traditional Chinese' },
};

console.log(resolveAliasLocale('zh-CN', customMapping)); // 'simplified-chinese'
```

Signature :

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

## Fonctionnement [#how-it-works]

* **Recherche inversée.** Convertit un code de langue canonique en l’alias présenté à l’utilisateur défini dans [`customMapping`](/docs/platform/core/reference/types/custom-mapping).
* **Par défaut.** Renvoie le paramètre régional d’origine si aucun alias correspondant n’existe dans le mapping.
* **Sans état.** N’a aucun effet de bord.

## Paramètres [#parameters]

| Paramètre                          | Description                                                  | Type                                                                  | Facultatif | Par défaut |
| ---------------------------------- | ------------------------------------------------------------ | --------------------------------------------------------------------- | ---------- | ---------- |
| [`locale`](#locale)                | Le code de langue canonique auquel l’alias doit être résolu. | `string`                                                              | Non        | —          |
| [`customMapping`](#custom-mapping) | Le mapping personnalisé utilisé pour résoudre l’alias.       | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Oui        | —          |

### `locale` [#locale]

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

Le code de langue canonique auquel un alias doit être résolu.

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

**Type** [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) · **Facultatif**

Le mapping personnalisé utilisé pour résoudre l’alias. En l’absence de mappage, le paramètre régional en entrée est renvoyé tel quel.

## Renvoie [#returns]

**Type** `string`

Le code de langue de l’alias si une correspondance existe, sinon le paramètre régional d’origine.

## Exemples [#examples]

```typescript
import { resolveAliasLocale } from 'generaltranslation';

const customMapping = {
  'simplified-chinese': { code: 'zh-CN', name: 'Simplified Chinese' },
  'traditional-chinese': { code: 'zh-TW', name: 'Traditional Chinese' },
};

// Résoudre le paramètre régional canonique en alias
console.log(resolveAliasLocale('zh-CN', customMapping)); // 'simplified-chinese'
console.log(resolveAliasLocale('zh-TW', customMapping)); // 'traditional-chinese'

// Un paramètre régional sans correspondance retourne l'original
console.log(resolveAliasLocale('es-ES', customMapping)); // 'es-ES'
```

## Notes [#notes]

* Convertit les codes de langue canoniques en alias plus faciles à comprendre pour les utilisateurs.
* Renvoie le paramètre régional d’origine s’il n’existe aucun mapping.
* Essentiel pour afficher des noms de paramètres régionaux visibles par l’utilisateur.
* Fonctionne avec des mappings personnalisés de paramètres régionaux.
* Fonction sans état — aucun effet de bord.