# generaltranslation: General Translation Core SDK: requiresTranslation
URL: https://generaltranslation.com/ru/docs/core/class/methods/locales/requires-translation.mdx
---
title: requiresTranslation
description: Справка по API для метода GT requiresTranslation
---

## Обзор

Метод `requiresTranslation` определяет, требуется ли перевод, на основе исходной и целевой локалей.
Он проверяет, нужно ли переводить исходный контент, сравнивая коды локалей и учитывая список одобренных локалей.

***

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

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

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

### Описание параметров

| Параметр          | Описание                                                                                      |
| ----------------- | --------------------------------------------------------------------------------------------- |
| `sourceLocale`    | Код исходной локали. Если не указан, используется `sourceLocale` экземпляра                   |
| `targetLocale`    | Код целевой локали. Если не указан, используется `targetLocale` экземпляра                    |
| `approvedLocales` | Массив одобренных целевых локалей. Если не указан, используется массив `locales` экземпляра |
| `customMapping`   | Необязательное пользовательское сопоставление для определения локали                          |

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

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

### Вызывает исключение

* `Error` — если исходная локаль не указана и для экземпляра не настроен `sourceLocale`
* `Error` — если целевая локаль не указана и для экземпляра не настроен `targetLocale`

***

## Примеры

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

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

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

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

// Целевая локаль не входит в список одобренных локалей
console.log(gt.requiresTranslation('en-US', 'it-IT')); // false (it-IT не входит в список одобренных локалей)
```

***


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

* Учитывает семейства языков локалей, а не только точные совпадения
* Учитывает список одобренных локалей
* Возвращает `false`, если целевая локаль отсутствует в списке одобренных локалей (если он задан)

## Дальнейшие шаги

* Проверьте связи между локалями с помощью [`isSameLanguage`](/docs/core/class/methods/locales/is-same-language)
* Определите оптимальную локаль с помощью [`determineLocale`](/docs/core/class/methods/locales/determine-locale)
* Проверьте корректность локалей с помощью [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale)