JavaScript метод String.prototype.toLocaleLowerCase()

Определение и применение

JavaScript метод toLocaleLowerCase() преобразует строку в строчные буквы (нижний регистр) с учетом текущего языкового стандарта. Для того, чтобы преобразовать строку в заглавные буквы (верхний регистр) с учетом текущего языкового стандарта вы можете воспользоваться методом toLocaleUpperCase().

Преобразование регистра может изменить длину строки: например, "ß".toUpperCase() возвращает "SS".

Поддержка браузерами

Спецификации: ecma262, ecma402

Поддерживается во всех основных браузерах с 2015 года.

Показать браузеры
Совместимостьjavascript.builtins.String.toLocaleLowerCase
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
toLocaleLowerCase✓1✓12✓1✓4✓1.3✓18✓4✓10.1✓1✓1.0✓4.4✓1
locales parameter✓58✓12✓55✓45✓10✓58✓55✓43✓10✓7.0✓58✓10

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

JavaScript синтаксис

JavaScript
// используя текущий языковой стандарт
str.toLocaleLowerCase();

// используя указанный языковой стандарт
str.toLocaleLowerCase( locales );
str.toLocaleLowerCase( [locales, ..., locales]);

Спецификация

ECMAScript: String.prototype.toLocaleLowerCase() ECMA-402: String.prototype.toLocaleLowerCase()

Значения параметров

String: справочные сведения
Параметр Описание
locales Параметр должен быть строкой, содержащей языковой тег BCP 47, или массивом таких языковых тегов. Если параметр не указан или не определен, используется языковой стандарт среды выполнения JavaScript по умолчанию. Используется первый тег списка; согласование локалей с перебором запасных вариантов, как в конструкторах Intl, не выполняется. Необязательный параметр.
Языковой тег BCP 47 определяет язык и минимально содержит код основного языка. В своем наиболее распространенном виде он может содержать по порядку: код языка, код скрипта и код страны или региона, разделенные дефисами. Хотя тег не чувствителен к регистру, рекомендуется писать код скрипта с заглавной первой буквы, верхний регистр для кода страны и региона, а строчный регистр для всего остального.

Исключения

String: справочные сведения
Тип исключения Описание
RangeError Возникает в том случае, если параметр locales содержит недопустимый языковой тег.
TypeError Возникает в том случае, если параметр locales содержит массив, значение которого не соответствует строке или объекту.

Примеры, попробуйте сами

В примере «Нижний регистр и выбор локали» показан результат вызова метода.

Нижний регистр и выбор локали

Измените исходную строку или аргумент метода и сравните результат после запуска.

index.html
HTML
<!doctype html>
<html lang="ru">
  <head>
    <meta charset="UTF-8" />
    <title>Нижний регистр и выбор локали</title>
  </head>
  <body>
    <p>Результат выполнения выводится в консоль.</p>
  </body>
</html>
main.js
JavaScript
var str = 'CROCODILE', // инициализируем строковые переменные
    str2 = '1A2B3C'

try {
    console.log(str.toLocaleLowerCase())
} catch (error) {
    console.log(error.name + ': ' + error.message) // Показываем ошибку и продолжаем сравнение.
} // возвращаемое значение "crocodile"
try {
    console.log(str.toLocaleLowerCase('en-US'))
} catch (error) {
    console.log(error.name + ': ' + error.message) // Показываем ошибку и продолжаем сравнение.
} // возвращаемое значение "crocodile"

try {
    console.log(str2.toLocaleLowerCase())
} catch (error) {
    console.log(error.name + ': ' + error.message) // Показываем ошибку и продолжаем сравнение.
} // возвращаемое значение "1a2b3c"
try {
    console.log(str2.toLocaleLowerCase('en-US'))
} catch (error) {
    console.log(error.name + ': ' + error.message) // Показываем ошибку и продолжаем сравнение.
} // возвращаемое значение "1a2b3c"

try {
    console.log(str2.toLocaleLowerCase('2'))
} catch (error) {
    console.log(error.name + ': ' + error.message) // Показываем ошибку и продолжаем сравнение.
} // RangeError
try {
    console.log(str2.toLocaleLowerCase(['ru-RU', 'en-US']))
} catch (error) {
    console.log(error.name + ': ' + error.message) // Показываем ошибку и продолжаем сравнение.
} // возвращаемое значение "1a2b3c"
try {
    console.log(str2.toLocaleLowerCase(['ru-RU', 2]))
} catch (error) {
    console.log(error.name + ': ' + error.message) // Показываем ошибку и продолжаем сравнение.
} // TypeError

console.log('I'.toLocaleLowerCase('tr')) // ı