Spec-Zone.ru › JavaScript

Intl.Locale.prototype.caseFirst

Базовый уровень Широко доступен

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с сентября 2020 года.

Аксессорная собственность caseFirst экземпляров Intl.Locale возвращает, учитывается ли регистр при правилах сортировки данного языка.

Описание

Правила сортировки языка используются для определения порядка строк в этом языке. Некоторые языки учитывают регистр символа (ЗАГЛАВНЫЕ или строчные) в процессе сортировки. Это дополнительное правило может быть выражено в свойстве caseFirst объекта Intl.Locale. Свойство caseFirst может принимать 3 значения, описанные в таблице ниже.

Значение Описание
upper Заглавные буквы сортируются перед строчными.
lower Строчные буквы сортируются перед заглавными.
false Специальный порядок регистра отсутствует.

Значение свойства caseFirst устанавливается во время создания экземпляра, либо через ключ kf идентификатора языка, либо через опцию caseFirst конструктора Intl.Locale(). Последнее имеет приоритет, если оба присутствуют; если ни одно из них не присутствует, свойство принимает значение undefined.

Сеттер свойства caseFirst является undefined. Вы не можете изменить это свойство напрямую.

Примеры

Как и другие подтеги языка, значение caseFirst может быть добавлено в объект Intl.Locale через строку языка или аргумент объекта конфигурации для конструктора.

Добавление значения caseFirst через строку языка

В спецификации строк языка Unicode caseFirst является "расширяющим подтегом". Эти подтеги добавляют дополнительную информацию о языке и добавляются к идентификаторам языка с использованием ключа расширения -u. Чтобы добавить значение caseFirst к начальной строке идентификатора языка, переданной в конструктор Intl.Locale(), сначала добавьте ключ расширения -u, если он еще не существует. Затем добавьте расширение -kf, чтобы указать, что вы добавляете значение для caseFirst. Наконец, добавьте значение caseFirst.

const locale = new Intl.Locale("fr-Latn-FR-u-kf-upper");
console.log(locale.caseFirst); // "upper"

Добавление значения caseFirst через аргумент объекта конфигурации

Конструктор Intl.Locale() имеет необязательный аргумент объекта конфигурации, который может содержать любые типы расширений, включая caseFirst. Установите свойство caseFirst объекта конфигурации на желаемое значение caseFirst, а затем передайте его в конструктор.

const locale = new Intl.Locale("en-Latn-US", { caseFirst: "lower" });
console.log(locale.caseFirst); // "lower"

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

Спецификация
Спецификация интернационализации ECMAScript® 2027
# sec-Intl.Locale.prototype.caseFirst

Совместимость с браузерами

Настольные ПК Мобильные Сервер
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android WebView на iOS Bun Deno Node.js
caseFirst
74
79
75
62
14
74
79
53
14
11.0
74
14
1.0.0
1.8
12.0.0

См. также

  • Intl.Locale
  • Спецификация сортировки регистра Unicode

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/caseFirst

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API