# generaltranslation: General Translation Core SDK: resolveCanonicalLocale
URL: https://generaltranslation.com/fr/docs/core/class/methods/locales/resolve-canonical-locale.mdx
---
title: resolveCanonicalLocale
description: Référence de l’API pour la méthode GT resolveCanonicalLocale
---

## Vue d’ensemble

Utilisée dans le cadre des alias de paramètres régionaux (par ex. `cn` -> `zh`), la méthode `resolveCanonicalLocale` convertit les codes d’alias de paramètres régionaux en codes de langue BCP-47 canoniques lorsqu’un mappage personnalisé est configuré.

***

## Référence

### Paramètres

<TypeTable
  type={{
  "locale?": {
    type: 'chaîne de caractères',
    optional: true,
    default: 'this.targetLocale'
  },
  "customMapping?": {
    type: 'CustomMapping',
    optional: true,
    default: 'this.customMapping'
  }
}}
/>

### Description des paramètres

| Paramètre       | Description                                                                                                                                                   |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `locale`        | Le code de langue de l’alias de paramètre régional à convertir en forme canonique. S’il n’est pas fourni, la valeur `targetLocale` de l’instance est utilisée |
| `customMapping` | Mappage personnalisé facultatif à utiliser à la place de celui de l’instance                                                                                  |

### Retourne

`chaîne de caractères` - Le code de langue BCP-47 canonique s’il existe une correspondance, sinon le code de langue d’origine

### Lève une erreur

* `Error` - Si aucun paramètre régional n’est fourni et que l’instance n’a pas de `targetLocale` configuré

***

## Exemples

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

// Convertir l'alias en paramètre régional canonique
const canonical = gt.resolveCanonicalLocale('cn');
console.log(canonical); // "zh"

// Les codes BCP-47 standard passent sans modification
const unchanged = gt.resolveCanonicalLocale('fr-FR');
console.log(unchanged); // "fr-FR"
```

***


## Remarques

* Convertit les alias de paramètre régional en codes de langue BCP-47 canoniques
* Retourne le paramètre régional d&#39;origine si aucun mappage personnalisé n&#39;existe
* Fonctionne avec la configuration `customMapping` du constructeur GT
* Aucune validation n&#39;est effectuée sur les codes de langue d&#39;entrée ou de sortie

## Étapes suivantes

* Résolvez de nouveau en alias avec [`resolveAliasLocale`](/docs/core/class/methods/locales/resolve-alias-locale)
* Validez les paramètres régionaux avec [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale)
* Normalisez le format des paramètres régionaux avec [`standardizeLocale`](/docs/core/class/methods/locales/standardize-locale)