# generaltranslation: General Translation Core SDK: determineLocale
URL: https://generaltranslation.com/ru/docs/core/functions/locales/determine-locale.mdx
---
title: determineLocale
description: Справка по API для функции determineLocale
---

## Обзор

Функция `determineLocale` определяет наиболее подходящую локаль из разрешённых локалей на основе предпочтений пользователя без необходимости создавать экземпляр класса GT.

***

## Справочник

### Параметры

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

### Возвращает

`string | undefined` — Наиболее подходящая локаль либо undefined, если совпадений не найдено

***

## Примеры

### Согласование содержимого

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

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

// Точное совпадение
console.log(determineLocale('en-US', approvedLocales)); // 'en-US'

// Резервный вариант языка
console.log(determineLocale('en-GB', approvedLocales)); // 'en-US'

// Несколько предпочтений
console.log(determineLocale(['fr-CA', 'es-MX'], approvedLocales)); // 'es-ES'

// Нет совпадений
console.log(determineLocale('it-IT', approvedLocales)); // undefined
```

***


## Примечания

* Реализует интеллектуальный подбор локали
* Возвращает первое точное совпадение или совпадение по языку из списка допустимых локалей
* Учитывает порядок предпочтений во входном массиве
* Возвращает undefined, если совпадений не найдено
* Крайне важна для подбора локали в веб-приложении

## Следующие шаги

* Используйте метод класса GT [`determineLocale`](/docs/core/class/methods/locales/determine-locale)
* Проверьте, требуется ли перевод, с помощью [`requiresTranslation`](/docs/core/functions/locales/requires-translation)