# generaltranslation: General Translation Core SDK: isValidLocale
URL: https://generaltranslation.com/ja/docs/core/class/methods/locales/is-valid-locale.mdx
---
title: isValidLocale
description: GT の isValidLocale メソッドの API リファレンス
---

## 概要

`isValidLocale` メソッドは、ロケールコードの形式が正しく、有効な BCP-47 ロケールとして認識されるかどうかを検証します。
カスタムのロケールマッピングに対応した `Intl` API を使用して、ロケールの構造、言語としての認識可否、地域やスクリプトの妥当性を確認します。

***

## リファレンス

### パラメーター

<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
```

***


## 注記

* ブラウザの Intl API を使用して、BCP-47 ロケールを包括的に検証します
* カスタムマッピングされた ロケール は常に true として扱われます (標準の検証はスキップされます) 
* private-use 言語コード (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)**