JavaScript метод toLocaleUpperCase()

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

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

Обращаю Ваше внимание, что немногие языки, например, такой как турецкий язык, имеют специфические соответствия регистров, поэтому данный метод toLocaleUpperCase() обычно возвращает то же значение, что и метод toUpperCase().

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

Метод toLocaleUpperCase()	Chrome	Firefox	Opera	Safari	IExplorer	Edge
Базовая поддержка	Да	Да	Да	Да	Да	Да
Параметр locales (ES 2017 Draft)	?	55.0	?	?	?	?

JavaScript синтаксис:

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

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

Версия JavaScript

ECMAScript 3rd Edition (Реализовано в JavaScript 1.2)

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

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

Параметр

Описание

locales

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

Исключения

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

Пример использования

var str = "crocodile", // инициализируем строковые переменные
    str2 =  "1a2b3c"; 

str.toLocaleUpperCase(); // возвращаемое значение "CROCODILE"
str.toLocaleUpperCase( "en-US" ); // возвращаемое значение "crocodile"

str2.toLocaleUpperCase(); // возвращаемое значение "1A2B3C"
str2.toLocaleUpperCase( "en-US" ); // возвращаемое значение "1A2B3C"

str2.toLocaleUpperCase( "2" ); // RangeError
str2.toLocaleUpperCase( ["ru-RU", "en-US"] ); // возвращаемое значение "1A2B3C"
str2.toLocaleUpperCase( ["ru-RU", 2] ); // TypeError

JavaScript String