String.prototype.toLocaleLowerCase()

toLocaleLowerCase() メソッドは、呼び出した文字列の値を、ロケールに依存した対応付けに基づいて小文字にに変換して返します。

構文

str.toLocaleLowerCase()
str.toLocaleLowerCase(locale)
str.toLocaleLowerCase([locale, locale, ...])

引数

locale Optional
locale 引数は、ロケールに依存した対応に基づいた小文字への変換に使用されるロケールを示します。複数のロケールが Array で与えられた場合は、利用可能な最良のロケールが使用されます。既定のロケールはホスト環境の現在のロケールです。

返値

呼び出した文字列をロケールに依存した対応に基づいて小文字に変換したものを表す新しい文字列です。

例外

  • A RangeError ("invalid language tag: xx_yy") は locale 引数が妥当な言語タグでない場合に発生します。
  • A TypeError ("invalid element in locales argument") は、配列の要素が文字列型でなかった場合に発生します。

解説

toLocaleLowerCase() メソッドは、ロケール固有の大文字小文字の対応付けに従って小文字に変換された文字列の値を返します。 toLocaleLowerCase() はその文字列自体に影響を与えません。ほとんどの場合は toLowerCase() と同じ結果が得られますが、トルコ語のように大文字小文字のマッピングが Unicode 既定の大文字小文字のマッピングに従っていないロケールの場合は、異なる結果が得られる可能性があります。

toLocaleLowerCase() の使用

'ALPHABET'.toLocaleLowerCase(); // 'alphabet'

'\u0130'.toLocaleLowerCase('tr') === 'i';    // true
'\u0130'.toLocaleLowerCase('en-US') === 'i'; // false

let locales = ['tr', 'TR', 'tr-TR', 'tr-u-co-search', 'tr-x-turkish'];
'\u0130'.toLocaleLowerCase(locales) === 'i'; // true

仕様書

ブラウザーの互換性

BCD tables only load in the browser

関連情報