# General Translation Platform: getLocaleEmoji
URL: https://generaltranslation.com/fr/docs/platform/core/reference/gt-class-methods/locales/get-locale-emoji.mdx
---

title: getLocaleEmoji
description: Renvoie un émoji pour un paramètre régional ou une région. Référence API pour getLocaleEmoji.

---

Récupère un drapeau émoji ou un symbole pour un code de langue sur une instance de [GT](/docs/platform/core/reference/gt-class/constructor), selon sa région. General Translation renvoie des émojis de drapeaux de pays et de territoires, avec un contenu de secours pour les langues sans région spécifique, et prend en charge les émojis personnalisés via des mappings.

## Vue d’ensemble [#overview]

Appelez `getLocaleEmoji` sur une instance de [`GT`](/docs/platform/core/reference/gt-class/constructor) avec un code de langue facultatif. S’il n’est pas indiqué, le `targetLocale` de l’instance est utilisé.

```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)
```

Signature :

```typescript
getLocaleEmoji(locale?: string): string
```

*Remarque : `getLocaleEmoji` s’exécute localement et ne nécessite pas de clé API. Il utilise le `targetLocale` de l’instance lorsque `locale` est omis. Pour les recherches sans instance `GT`, consultez la version autonome de [`getLocaleEmoji`](/docs/platform/core/reference/utility-functions/locales/get-locale-emoji).*

## Fonctionnement [#how-it-works]

* **Sélection basée sur la région.** Utilise le code de région du paramètre régional (lorsqu’il est disponible) pour sélectionner un émoji de drapeau, constitué à partir des symboles indicateurs régionaux Unicode.
* **Priorité du custom mapping.** Les émojis définis dans un [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) priment sur la sélection basée sur la région.
* **Contenus de secours.** Renvoie un émoji spécifique à la langue pour certaines langues sans région, ainsi que l’émoji globe par défaut `🌍` pour les paramètres régionaux non reconnus ou non valides.
* **Paramètre régional manquant.** Génère une `Error` si aucun paramètre régional n’est fourni et que l’instance n’a pas de `targetLocale` configuré.

## Paramètres [#parameters]

| Paramètre           | Description                                                      | Type     | Facultatif | Par défaut          |
| ------------------- | ---------------------------------------------------------------- | -------- | ---------- | ------------------- |
| [`locale`](#locale) | Code de langue BCP-47 pour lequel obtenir l’émoji correspondant. | `string` | Oui        | `this.targetLocale` |

### `locale` [#locale]

**Type** `string` · **Facultatif** · **Par défaut** `this.targetLocale`

Code de langue BCP-47 pour lequel obtenir l’émoji. S’il n’est pas fourni, le `targetLocale` de l’instance est utilisé.

## Retourne [#returns]

**Type** `string`

Un drapeau émoji ou un symbole représentant le paramètre régional :

* Drapeau émoji de pays ou de territoire pour les paramètres régionaux avec région (par exemple, `🇺🇸`, `🇫🇷`, `🇯🇵`).
* Émoji spécifique à la langue pour certaines langues sans région.
* Émoji globe par défaut (`🌍`) pour les paramètres régionaux non reconnus.

Lève une `Error` si aucun paramètre régional n’est fourni et que l’instance n’a pas de `targetLocale` configuré.

## Exemples [#examples]

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

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

// Obtenir les émojis 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 [#notes]

* Renvoie des émojis de drapeau selon le code de région du paramètre régional, lorsqu’il est disponible.
* Les émojis du mappage personnalisé sont prioritaires par rapport à la sélection basée sur la région.
* Utilise les symboles indicateurs régionaux Unicode pour générer les drapeaux.
* Utilise `🌍` (globe) 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.