String.prototype.toLocaleLowerCase()

Метод toLocaleLowerCase() (до нижнього регістру згідно з локаллю) значень String повертає свій рядок, переведений у нижній регістр із врахуванням будь-яких перетворень, специфічних для конкретної локалі.

Спробуйте його в дії

Синтаксис

toLocaleLowerCase()
toLocaleLowerCase(locales)

Параметри

locales Необов'язкове

Рядок з тегом мови BCP 47, або масив таких рядків. Позначає локаль, налаштування якої будуть використані для переведення рядка в нижній регістр, з урахуванням будь-яких, специфічних для локалі, перетворень. Загальну форму та тлумачення аргументу locales дивіться в описі цього параметра на головній сторінці Intl.

На відміну від інших методів, що використовують аргумент locales, toLocaleLowerCase() не дозволяє зіставлення локалей. Таким чином, перевіривши валідність аргументу locales, цей метод завжди використовує першу локаль у списку (або усталену локаль, якщо цей список порожній), навіть тоді, коли ця локаль не підтримується реалізацією.

Повернене значення

Новий рядок, що містить значення рядка, на якому було викликано метод, переведене в нижній регістр, з урахуванням будь-яких, специфічних для конкретної локалі, перетворень.

Опис

Метод toLocaleLowerCase() повертає значення рядка, переведене в нижній регістр, з урахуванням будь-яких, специфічних для конкретної локалі, перетворень. Метод toLocaleLowerCase() не впливає на значення початкового рядка. В більшості випадків він виведе такий самий результат, як і toLowerCase(), проте для деяких локалей (зокрема турецької, чиї перетворення регістру не відповідають усталеним перетворенням, закріпленим в Unicode), результат може відрізнятись.

Приклади

Застосування методу toLocaleLowerCase()

"АБЕТКА".toLocaleLowerCase(); // 'абетка'

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

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

Специфікації

Сумісність із браузерами

Дивіться також

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