String.prototype.toLocaleLowerCase() - JavaScript 编辑

toLocaleLowerCase()方法根据任何指定区域语言环境设置的大小写映射，返回调用字符串被转换为小写的格式。

语法

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

参数

locale 可选

参数 locale 指明要转换成小写格式的特定语言区域。 如果以一个数组 Array形式给出多个locales,  最合适的地区将被选出来应用（参见best available locale）。默认的locale是主机环境的当前区域(locale)设置。

返回值

根据任何特定于语言环境的案例映射规则将被调用字串转换成小写格式的一个新字符串。

Exceptions

• A RangeError ("invalid language tag: xx_yy") is thrown if a locale argument isn't a valid language tag.
• A TypeError ("invalid element in locales argument") is thrown if an array element isn't of type string.

描述

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

规范

Specification	Status	Comment
ECMAScript 3rd Edition (ECMA-262)	Standard	Initial definition. Implemented in JavaScript 1.2.
ECMAScript 5.1 (ECMA-262) String.prototype.toLocaleLowerCase	Standard
ECMAScript 2015 (6th Edition, ECMA-262) String.prototype.toLocaleLowerCase	Standard
ECMAScript Latest Draft (ECMA-262) String.prototype.toLocaleLowerCase	Draft
ECMAScript Internationalization API 4.0 (ECMA-402) String.prototype.toLocaleLowerCase	Draft	ES Intl 2017 added the localeparameter.

浏览器兼容性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

• Desktop
• Mobile

Feature	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari
Basic support	(Yes)	(Yes)	(Yes)	(Yes)	(Yes)

Feature	Android	Chrome for Android	Firefox Mobile (Gecko)	IE Mobile	Opera Mobile	Safari Mobile
Basic support	(Yes)	(Yes)	(Yes)	(Yes)	(Yes)	(Yes)

参阅

• String.prototype.toLocaleUpperCase()
• String.prototype.toLowerCase()
• String.prototype.toUpperCase()