# generaltranslation: General Translation Core SDK: requiresTranslation
URL: https://generaltranslation.com/ru/docs/core/functions/locales/requires-translation.mdx
---
title: requiresTranslation
description: Справочник по API функции requiresTranslation
---

## Обзор

Функция `requiresTranslation` определяет, нужен ли перевод между исходной и целевой локалями без экземпляра класса GT.

***

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

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

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

### Возвращаемое значение

`boolean` — `true`, если перевод требуется, иначе — `false`

***

## Примеры

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

// Разные языки требуют перевода
console.log(requiresTranslation('en-US', 'es-ES')); // true
console.log(requiresTranslation('en-US', 'fr-FR')); // true

// Одинаковые языки не требуют перевода
console.log(requiresTranslation('en-US', 'en-US')); // false
console.log(requiresTranslation('en-US', 'en-GB')); // false

// С фильтром утверждённых локалей
const approved = ['en-US', 'es-ES', 'fr-FR'];
console.log(requiresTranslation('en-US', 'it-IT', approved)); // false (не разрешено)
console.log(requiresTranslation('en-US', 'es-ES', approved)); // true (разрешено и отличается)
```

***


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

* Соблюдает ограничения утверждённых локалей
* Возвращает false, если целевая локаль отсутствует в списке утверждённых
* Учитывает пользовательские сопоставления локалей

## Что дальше

* Используйте метод класса GT [`requiresTranslation`](/docs/core/class/methods/locales/requires-translation)
* Сравнивайте языки с помощью [`isSameLanguage`](/docs/core/functions/locales/is-same-language)