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

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

---

[`getLocaleEmoji`](/docs/platform/core/reference/gt-class-methods/locales/get-locale-emoji) est une fonction utilitaire autonome de la bibliothèque Core de General Translation qui renvoie un drapeau ou un symbole émoji pour un code de langue. Elle sélectionne un drapeau de pays ou de territoire en fonction de la région du paramètre régional, avec prise en charge de mappings d’émojis personnalisés.

## Vue d’ensemble [#overview]

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

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

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

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

Signature :

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

## Fonctionnement [#how-it-works]

* **Sélection basée sur la région.** Utilise la région du paramètre régional (lorsqu'elle est présente) pour sélectionner un émoji de drapeau à l'aide des symboles indicateurs régionaux Unicode. Utilise des émojis par défaut pour certaines langues.
* **Priorité du `customMapping`.** Les émojis définis dans un [`customMapping`](/docs/platform/core/reference/types/custom-mapping) sont prioritaires par rapport à la sélection basée sur la région.
* **Contenu de secours.** Renvoie un émoji globe par défaut (`🌍`) pour les paramètres régionaux non reconnus.

## Paramètres [#parameters]

| Paramètre                          | Description                                                               | Type                                                                  | Facultatif | Par défaut |
| ---------------------------------- | ------------------------------------------------------------------------- | --------------------------------------------------------------------- | ---------- | ---------- |
| [`locale`](#locale)                | Code de langue BCP-47 pour lequel obtenir l’émoji.                        | `string`                                                              | Non        | —          |
| [`customMapping`](#custom-mapping) | Mappage personnalisé pour les codes de langue et les surcharges d’émojis. | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Oui        | —          |

### `locale` [#locale]

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

Le code de langue BCP-47 dont vous souhaitez obtenir l’émoji.

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

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

Mappage personnalisé facultatif pour les codes de langue et les redéfinitions d’émoji.

## Valeur renvoyée [#returns]

**Type** `string`

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

* Un émoji de drapeau de pays ou de territoire pour les paramètres régionaux avec région (par exemple, `🇺🇸`, `🇫🇷`, `🇯🇵`).
* Un émoji personnalisé, s’il est défini dans le mapping.
* L’émoji globe par défaut (`🌍`) pour les paramètres régionaux non reconnus.

## Exemples [#examples]

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

// Drapeaux de pays courants
console.log(getLocaleEmoji('en-US')); // "🇺🇸"
console.log(getLocaleEmoji('fr-FR')); // "🇫🇷"
console.log(getLocaleEmoji('de-DE')); // "🇩🇪"
console.log(getLocaleEmoji('ja-JP')); // "🇯🇵"
console.log(getLocaleEmoji('zh-CN')); // "🇨🇳"

// Régions avec plusieurs langues
console.log(getLocaleEmoji('en-CA')); // "🇨🇦"
console.log(getLocaleEmoji('fr-CA')); // "🇨🇦"
console.log(getLocaleEmoji('de-CH')); // "🇨🇭"
console.log(getLocaleEmoji('fr-CH')); // "🇨🇭"
```

## Remarques [#notes]

* Renvoie des émojis de drapeau à l’aide de symboles indicateurs régionaux Unicode.
* Les émojis définis par un mappage personnalisé sont prioritaires par rapport à la sélection basée sur la région.
* Prend en charge tous les codes de région ISO 3166-1 alpha-2 pour une couverture complète.