# generaltranslation: General Translation Core SDK: determineLocale
URL: https://generaltranslation.com/it/docs/core/class/methods/locales/determine-locale.mdx
---
title: determineLocale
description: Riferimento dell’API per il metodo determineLocale di GT
---

## Panoramica

Il metodo `determineLocale` determina l’impostazione regionale che corrisponde meglio da un elenco di impostazioni regionali approvate, in base alle preferenze dell’utente.
Implementa la negoziazione dell’impostazione regionale per trovare quella più adatta quando non sono disponibili corrispondenze esatte.

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

// Corrispondenza esatta
console.log(gt.determineLocale('en-US')); // 'en-US'

// Fallback linguistico
console.log(gt.determineLocale('en-GB')); // 'en-US' (variante inglese più vicina)

// Preferenze multiple
console.log(gt.determineLocale(['fr-CA', 'es-MX', 'en-US'])); // 'es-ES' (variante spagnola più vicina)

// Nessuna corrispondenza
console.log(gt.determineLocale('it-IT')); // undefined
```

***


## Riferimento

### Parametri

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

### Restituisce

`string | undefined` - Impostazione regionale con la migliore corrispondenza oppure undefined se non viene trovata alcuna corrispondenza

***

## Esempi

### Negoziazione dell&#39;impostazione regionale utente

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

// Simula l'intestazione Accept-Language del browser
const userPreferences = ['fr-CA', 'en-GB', 'en'];
const bestMatch = gt.determineLocale(userPreferences);
console.log(bestMatch); // 'fr-FR' in base all'ordine di preferenza

```

***


## Note

* Restituisce la prima corrispondenza esatta tra le impostazioni regionali approvate
* Ripiega sulle corrispondenze di lingua quando la regione esatta non è disponibile
* Rispetta l&#39;ordine di preferenza nell&#39;array di input
* Restituisce undefined quando non trova alcuna corrispondenza adatta
* Fondamentale per implementare la negoziazione dell&#39;impostazione regionale nelle applicazioni web

## Passaggi successivi

* Verifica se è necessaria una traduzione con [`requires-translation`](/docs/core/class/methods/locales/requires-translation)
* Confronta le lingue con [`is-same-language`](/docs/core/class/methods/locales/is-same-language)