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

## Vue d’ensemble

La méthode `getLocaleEmoji` récupère un drapeau ou un symbole emoji pour un code de langue en fonction de sa région.
Elle renvoie les émojis de drapeau appropriés pour les pays et territoires, avec des solutions de repli pour les langues sans région spécifique et la prise en charge d’émojis personnalisés via des correspondances.

```typescript
const gt = new GT({
  sourceLocale: 'en',
  targetLocale: 'fr-CA'
});

const emoji = gt.getLocaleEmoji('fr-CA');
console.log(emoji); // "🇨🇦" (drapeau canadien)

const usEmoji = gt.getLocaleEmoji('en-US');
console.log(usEmoji); // "🇺🇸" (drapeau américain)

const enEmoji = gt.getLocaleEmoji('en');
console.log(enEmoji); // "🇺🇸" (drapeau américain)
```

***


## Référence

### Paramètres

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

### Description des paramètres

| Paramètre | Description                                                                                                                                  |
| --------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `locale`  | Code de langue BCP-47 permettant d’obtenir l’emoji correspondant. S’il n’est pas fourni, la valeur `targetLocale` de l’instance est utilisée |

### Renvoie

`chaîne de caractères` - Emoji de drapeau ou symbole représentant le paramètre régional :

* Emoji de drapeau de pays ou de territoire pour les paramètres régionaux avec région (par ex. `🇺🇸`, `🇫🇷`, `🇯🇵`)
* Emoji propre à la langue pour certaines langues sans région
* Emoji de drapeau par défaut (`🏳️`) pour les paramètres régionaux non reconnus

### Lève une exception

* `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',
  targetLocale: 'es'
});

// Obtenir l'emoji pour le paramètre régional cible
console.log(gt.getLocaleEmoji()); // "🇪🇸" (uses targetLocale 'es')

// Obtenir les emojis pour différents paramètres régionaux
console.log(gt.getLocaleEmoji('en-US')); // "🇺🇸"
console.log(gt.getLocaleEmoji('fr-FR')); // "🇫🇷"
console.log(gt.getLocaleEmoji('de-DE')); // "🇩🇪"
console.log(gt.getLocaleEmoji('ja-JP')); // "🇯🇵"
console.log(gt.getLocaleEmoji('zh-CN')); // "🇨🇳"
```

***


## Remarques

* Renvoie des émojis de drapeau selon le code de région du paramètre régional, lorsqu&#39;il est disponible
* Les émojis de correspondance personnalisée sont prioritaires sur la sélection basée sur la région
* Utilise les symboles indicateurs régionaux Unicode pour générer les drapeaux
* Utilise `🏳️` (drapeau blanc) par défaut pour les paramètres régionaux non reconnus ou invalides
* Compatible avec tous les navigateurs modernes et systèmes d’exploitation prenant en charge les émojis Unicode

## Étapes suivantes

* Récupérez les propriétés d’un paramètre régional avec [`getLocaleProperties`](/docs/core/class/methods/locales/get-locale-properties)
* Récupérez le nom d’un paramètre régional avec [`getLocaleName`](/docs/core/class/methods/locales/get-locale-name)
* Validez les paramètres régionaux avec [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale)
* [En savoir plus sur le type CustomMapping](/docs/core/types/custom-mapping)