String.prototype.toLocaleUpperCase()

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

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

Синтаксис

toLocaleUpperCase()
toLocaleUpperCase(locales)

Параметри

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

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

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

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

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

Опис

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

Також варто зауважити, що зміна регістру не завжди означає перетворення символів 1:1, деякі символи запросто можуть перетворитися на два (чи навіть більше) символів після переведення у верхній регістр. Тому довжина рядка з результатом може відрізнятись від довжини початкового рядка. Це також означає, що таке перетворення не є стабільним, тобто такий вираз може повернути false: x.toLocaleLowerCase() === x.toLocaleUpperCase().toLocaleLowerCase()

Приклади

Застосування toLocaleUpperCase()

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

"Gesäß".toLocaleUpperCase(); // 'GESÄSS'

"i\u0307".toLocaleUpperCase("lt-LT"); // 'I'

const locales = ["lt", "LT", "lt-LT", "lt-u-co-phonebk", "lt-x-lietuva"];
"i\u0307".toLocaleUpperCase(locales); // 'I'

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

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

desktop mobile server
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on iOS Samsung Internet Deno Node.js
toLocaleUpperCase
Chrome Full support 1
Edge Full support 12
Firefox Full support 1
Internet Explorer Full support 5.5
Opera Full support 4
Safari Full support 1.3
WebView Android Full support 1
Chrome Android Full support 18
Firefox for Android Full support 4
Opera Android Full support 10.1
Safari on iOS Full support 1
Samsung Internet Full support 1.0
Deno Full support 1.0
Node.js Full support 0.10.0
locale
Chrome Full support 58
Edge Full support 12
Firefox Full support 55
Internet Explorer Full support 6
Opera Full support 45
Safari Full support 10
WebView Android Full support 58
Chrome Android Full support 58
Firefox for Android Full support 55
Opera Android Full support 42
Safari on iOS Full support 10
Samsung Internet Full support 7.0
Deno Full support 1.8
Node.js Full support 13.0.0

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