# generaltranslation: General Translation Core SDK: determineLocale
URL: https://generaltranslation.com/es/docs/core/class/methods/locales/determine-locale.mdx
---
title: determineLocale
description: Referencia de la API del método determineLocale de GT
---

## Resumen

El método `determineLocale` determina la configuración regional que mejor coincida a partir de una lista de configuraciones regionales aprobadas según las preferencias del usuario.
Implementa la negociación de configuraciones regionales para encontrar la configuración regional más adecuada cuando no hay coincidencias exactas disponibles.

```typescript
const gt = new GT({
  sourceLocale: 'en-US',
  locales: ['en-US', 'es-ES', 'fr-FR', 'de-DE']
});

// Coincidencia exacta
console.log(gt.determineLocale('en-US')); // 'en-US'

// Alternativa de idioma
console.log(gt.determineLocale('en-GB')); // 'en-US' (variante de inglés más cercana)

// Múltiples preferencias
console.log(gt.determineLocale(['fr-CA', 'es-MX', 'en-US'])); // 'es-ES' (variante de español más cercana)

// Sin coincidencia
console.log(gt.determineLocale('it-IT')); // undefined
```

***


## Referencia

### Parámetros

<TypeTable
  type={{
  "locales": {
    type: 'string | string[]',
    optional: false,
  },
  "approvedLocales?": {
    type: 'string[]',
    optional: true,
    default: 'this.locales'
  },
  "customMapping?": {
    type: 'CustomMapping',
    optional: true,
    default: 'this.customMapping'
  }
}}
/>

### Devuelve

`string | undefined` - Configuración regional que mejor coincida, o undefined si no hay coincidencias

***

## Ejemplos

### Negociación de la configuración regional del usuario

```typescript
const gt = new GT({
  sourceLocale: 'en-US',
  locales: ['en-US', 'en-GB', 'es-ES', 'fr-FR']
});

// Simular el encabezado Accept-Language del navegador
const userPreferences = ['fr-CA', 'en-GB', 'en'];
const bestMatch = gt.determineLocale(userPreferences);
console.log(bestMatch); // 'fr-FR' según el orden de preferencia

```

***


## Notas

* Devuelve la primera coincidencia exacta entre las configuraciones regionales aprobadas
* Recurre a coincidencias por idioma cuando la región exacta no está disponible
* Respeta el orden de preferencia en el array de entrada
* Devuelve undefined cuando no encuentra ninguna coincidencia adecuada
* Es esencial para implementar la negociación de configuración regional en aplicaciones web

## Siguientes pasos

* Comprueba si se necesita traducción con [`requires-translation`](/docs/core/class/methods/locales/requires-translation)
* Compara idiomas con [`is-same-language`](/docs/core/class/methods/locales/is-same-language)