# generaltranslation: General Translation Core SDK: determineLocale
URL: https://generaltranslation.com/fr/docs/core/class/methods/locales/determine-locale.mdx
---
title: determineLocale
description: Référence API de la méthode determineLocale de GT
---

## Vue d’ensemble

La méthode `determineLocale` détermine le paramètre régional le plus adapté parmi une liste de paramètres régionaux approuvés, en fonction des préférences de l’utilisateur.
Elle met en œuvre une négociation des paramètres régionaux afin de trouver le paramètre régional le plus approprié lorsqu’aucune correspondance exacte n’est disponible.

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

// Correspondance exacte
console.log(gt.determineLocale('en-US')); // 'en-US'

// Repli linguistique
console.log(gt.determineLocale('en-GB')); // 'en-US' (variante anglaise la plus proche)

// Préférences multiples
console.log(gt.determineLocale(['fr-CA', 'es-MX', 'en-US'])); // 'es-ES' (variante espagnole la plus proche)

// Aucune correspondance
console.log(gt.determineLocale('it-IT')); // undefined
```

***


## Référence

### Paramètres

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

### Renvoie

`string | undefined` - paramètre régional le plus adapté, ou `undefined` si aucune correspondance n’est trouvée

***

## Exemples

### Négociation du paramètre régional de l’utilisateur

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

// Simuler l'en-tête Accept-Language du navigateur
const userPreferences = ['fr-CA', 'en-GB', 'en'];
const bestMatch = gt.determineLocale(userPreferences);
console.log(bestMatch); // 'fr-FR' selon l'ordre de préférence

```

***


## Remarques

* Renvoie la première correspondance exacte parmi les paramètres régionaux approuvés
* Se rabat sur des correspondances de langue lorsqu&#39;aucune région exacte n&#39;est disponible
* Respecte l&#39;ordre de préférence du tableau d&#39;entrée
* Renvoie `undefined` lorsqu&#39;aucune correspondance appropriée n&#39;est trouvée
* Indispensable pour mettre en œuvre la négociation des paramètres régionaux dans les applications web

## Étapes suivantes

* Vérifiez les besoins de traduction avec [`requires-translation`](/docs/core/class/methods/locales/requires-translation)
* Comparez les langues avec [`is-same-language`](/docs/core/class/methods/locales/is-same-language)