String.prototype.toLocaleUpperCase()
Метод toLocaleUpperCase()
повертає значення рядка, на якому викликається, переведене у верхній регістр із врахуванням будь-яких, специфічних для конкретної локалі, перетворень.
Спробуйте його в дії
Синтаксис
toLocaleUpperCase()
toLocaleUpperCase(locale)
toLocaleUpperCase([locale1, locale2, ...])
Параметри
locale
Необов'язковеПараметр
locale
позначає локаль, налаштування якої будуть використані для переведення рядка у верхній регістр, з урахуванням будь-яких, специфічних для локалі, перетворень. В разі, якщо було передано декілька локалей умасиві
, буде використано найкращу наявну локаль (англ.). Усталена локаль — це локаль середовища хост-системи.
Повернене значення
Новий рядок, що містить значення рядка, на якому було викликано метод, переведене у верхній регістр, з урахуванням будь-яких, специфічних для конкретної локалі, перетворень.
Винятки
- Викидається виняток
RangeError
("invalid language tag: xx_yy"), якщо передане в параметріlocale
значення не є дійсним позначенням мови. - Викидається виняток
TypeError
("invalid element in locales argument"), якщо елементи переданого масиву мають тип, відмінний від рядкового.
Опис
Метод toLocaleUpperCase()
повертає значення рядка, переведене у верхній регістр, з урахуванням будь-яких, специфічних для конкретної локалі, перетворень. Метод toLocaleUpperCase()
не впливає на значення початкового рядка. В більшості випадків він виведе такий самий результат, як і toUpperCase()
, проте для деяких локалей (зокрема турецької, чиї перетворення регістру не відповідають усталеним перетворенням, закріпленим в Unicode), результат може відрізнятись.
Також варто зауважити, що зміна регістру не завжди означає перетворення символів 1:1, деякі символи запросто можуть перетворитися на два (чи навіть більше) символів після переведення у верхній регістр. Тому довжина рядка з результатом може відрізнятись від довжини початкового рядка. Це також означає, що таке перетворення не є стабільним, тобто такий вираз може повернути false
:
x.toLocaleLowerCase() === x.toLocaleUpperCase().toLocaleLowerCase()
Приклади
Застосування toLocaleUpperCase()
'абетка'.toLocaleUpperCase(); // 'АБЕТКА'
'Gesäß'.toLocaleUpperCase(); // 'GESÄSS'
'i\u0307'.toLocaleUpperCase('lt-LT'); // 'I'
let locales = ['lt', 'LT', 'lt-LT', 'lt-u-co-phonebk', 'lt-x-lietuva'];
'i\u0307'.toLocaleUpperCase(locales); // 'I'
Специфікації
Сумісність із браузерами
desktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
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 |