# generaltranslation: General Translation Core SDK: determineLocale
URL: https://generaltranslation.com/it/docs/core/functions/locales/determine-locale.mdx
---
title: determineLocale
description: Riferimento API della funzione determineLocale
---

## Panoramica

La funzione `determineLocale` individua l'impostazione regionale più adatta tra quelle approvate in base alle preferenze dell'utente, senza richiedere un'istanza della classe GT.

***

## Riferimento

### Parametri

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

### Restituisce

`string | undefined` - Impostazione regionale che corrisponde meglio oppure undefined se non viene trovata alcuna corrispondenza

***

## Esempi

### Negoziazione del contenuto

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

const approvedLocales = ['en-US', 'es-ES', 'fr-FR', 'de-DE'];

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

// Fallback linguistico
console.log(determineLocale('en-GB', approvedLocales)); // 'en-US'

// Preferenze multiple
console.log(determineLocale(['fr-CA', 'es-MX'], approvedLocales)); // 'es-ES'

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

***


## Note

* Implementa una negoziazione intelligente dell&#39;impostazione regionale
* Restituisce la prima corrispondenza esatta o di lingua dall&#39;elenco approvato
* Rispetta l&#39;ordine di preferenza nell&#39;array di input
* Restituisce `undefined` quando non trova alcuna corrispondenza
* Essenziale per la negoziazione dell&#39;impostazione regionale nelle applicazioni web

## Passaggi successivi

* Usa il metodo [`determineLocale`](/docs/core/class/methods/locales/determine-locale) della classe GT
* Verifica se è necessaria la traduzione con [`requiresTranslation`](/docs/core/functions/locales/requires-translation)