# General Translation Platform: getLocaleEmoji
URL: https://generaltranslation.com/es/docs/platform/core/reference/gt-class-methods/locales/get-locale-emoji.mdx
---
title: getLocaleEmoji
description: Devuelve un emoji representativo para una configuración regional o región. Referencia de la API para getLocaleEmoji.

---

Obtiene una emoji flag o un símbolo para un código de configuración regional en una instancia de [GT](/docs/platform/core/reference/gt-class/constructor), en función de su región. General Translation devuelve emojis de banderas de países y territorios, con contenido alternativo para idiomas sin una región específica y compatibilidad con emojis personalizados mediante mapeos.

## Descripción general [#overview]

Llama a `getLocaleEmoji` en una instancia de [`GT`](/docs/platform/core/reference/gt-class/constructor) con un código de configuración regional opcional. Si se omite, se usa el `targetLocale` de la instancia.

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

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

const usEmoji = gt.getLocaleEmoji('en-US');
console.log(usEmoji); // "🇺🇸" (bandera de EE. UU.)

const enEmoji = gt.getLocaleEmoji('en');
console.log(enEmoji); // "🇺🇸" (bandera de EE. UU.)
```

Firma:

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

*Nota: `getLocaleEmoji` se ejecuta localmente y no requiere una clave de API. Usa el `targetLocale` de la instancia cuando se omite `locale`. Para consultas sin una instancia de `GT`, consulta [`getLocaleEmoji`](/docs/platform/core/reference/utility-functions/locales/get-locale-emoji) en su versión independiente.*

## Cómo funciona [#how-it-works]

* **Selección basada en la región.** Usa el código de región del locale (cuando está disponible) para seleccionar un emoji de bandera, creado a partir de símbolos indicadores regionales de Unicode.
* **Prioridad de `CustomMapping`.** Los emojis definidos en un [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) tienen prioridad sobre la selección basada en la región.
* **Contenidos alternativos.** Devuelve un emoji específico del idioma para algunos idiomas sin regiones y el emoji de globo predeterminado `🌍` para locales no reconocidos o no válidos.
* **Configuración regional faltante.** Lanza un `Error` si no se proporciona ningún locale y la instancia no tiene `targetLocale` configurado.

## Parámetros [#parameters]

| Parámetro           | Descripción                                                               | Tipo     | Opcional | Predeterminado      |
| ------------------- | ------------------------------------------------------------------------- | -------- | -------- | ------------------- |
| [`locale`](#locale) | Código de configuración regional BCP-47 para el que se obtendrá el emoji. | `string` | Sí       | `this.targetLocale` |

### `locale` [#locale]

**Tipo** `string` · **Opcional** · **Predeterminado** `this.targetLocale`

Código de configuración regional BCP-47 para obtener el emoji correspondiente. Si no se proporciona, se usa el `targetLocale` de la instancia.

## Devuelve [#returns]

**Tipo** `string`

Un emoji de bandera o un símbolo que representa el locale:

* Emoji de bandera de país o territorio para locales con región (por ejemplo, `🇺🇸`, `🇫🇷`, `🇯🇵`).
* Emoji específico del idioma para algunos idiomas sin región.
* Emoji de globo predeterminado (`🌍`) para locales no reconocidos.

Lanza un `Error` si no se proporciona ningún locale y la instancia no tiene `targetLocale` configurado.

## Ejemplos [#examples]

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

// Obtener emoji para la configuración regional de destino
console.log(gt.getLocaleEmoji()); // "🇪🇸" (uses targetLocale 'es')

// Obtener emojis para diferentes locales
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')); // "🇨🇳"
```

## Notas [#notes]

* Devuelve emojis de banderas según el código de región de la configuración regional, cuando está disponible.
* Los emojis de Custom mapping tienen prioridad sobre la selección basada en la región.
* Usa símbolos indicadores regionales de Unicode para generar banderas.
* Usa `🌍` (globo terráqueo) de forma predeterminada para configuraciones regionales no reconocidas o no válidas.
* Es compatible con todos los navegadores modernos y sistemas operativos que admiten emojis Unicode.