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

## Обзор

Метод `isValidLocale` проверяет, имеет ли код локали корректный формат и распознаётся ли он как допустимая локаль BCP-47.
Он проверяет структуру локали, распознавание языка и корректность региона/скрипта с помощью API `Intl`, а также поддерживает пользовательские сопоставления локалей.

***

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

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

<TypeTable
  type={{
  "locale?": {
    type: 'string',
    optional: true,
    default: 'this.targetLocale',
  },
  "customMapping?": {
    type: 'CustomMapping',
    optional: true,
    default: 'this.customMapping',
  }
}}
/>

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

| Параметр        | Описание                                                                                                                                               |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `locale`        | Код локали BCP-47, который нужно проверить. Если не указан, используется `targetLocale` экземпляра                                                     |
| `customMapping` | Необязательное пользовательское сопоставление для проверки дополнительных допустимых локалей. Если не указано, используется `customMapping` экземпляра |

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

`boolean` — `true`, если локаль корректна, иначе `false`

### Выбрасываемые исключения

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

***

## Примеры

```typescript
const gt = new GT({
  sourceLocale: 'en',
  targetLocale: 'es'
});

const isValid = gt.isValidLocale('en-US');
console.log(isValid); // true

const isInvalid = gt.isValidLocale('invalid-locale');
console.log(isInvalid); // false
```

***


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

* Выполняет полную проверку локалей BCP-47 с помощью браузерных API `Intl`
* Пользовательские сопоставления локалей всегда считаются допустимыми (`true`) и обходят стандартную проверку
* Поддерживает языковые коды для частного использования (qaa-qtz)
* Возвращает `false` для некорректных или нераспознанных кодов локалей

## Что дальше

* **[Получение свойств локали с помощью getLocaleProperties](/docs/core/class/methods/locales/get-locale-properties)**
* **[Определение наиболее подходящей локали с помощью determineLocale](/docs/core/class/methods/locales/determine-locale)**
* **[Получение названий локалей с помощью getLocaleName](/docs/core/class/methods/locales/get-locale-name)**
* **[Подробнее о типе CustomMapping](/docs/core/types/custom-mapping)**