Spec-Zone.ru › JavaScript

Intl.PluralRules.supportedLocalesOf()

Базовая поддержка Широко доступна

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

Статический метод Intl.PluralRules.supportedLocalesOf() возвращает массив, содержащий те из предоставленных локалей, которые поддерживаются правилами множественного числа без необходимости возвращаться к локали по умолчанию, используемой средой выполнения.

Попробовать

const locales = ["en-US", "ban", "ar-OM", "de-DE"];
const options = { localeMatcher: "lookup" };

console.log(Intl.PluralRules.supportedLocalesOf(locales, options));
// Expected output: Array ["en-US", "ar-OM", "de-DE"]

Синтаксис

Intl.PluralRules.supportedLocalesOf(locales)
Intl.PluralRules.supportedLocalesOf(locales, options)

Параметры

locales
Строка с тегом языка BCP 47 или массив таких строк. Общую форму и интерпретацию аргумента locales смотрите в описании параметра на главной странице Intl.
options Необязательно
Объект, который может иметь следующее свойство:
localeMatcher
Алгоритм сопоставления локалей для использования. Возможные значения: "lookup" и "best fit"; по умолчанию используется "best fit". Информацию об этой опции смотрите на странице Intl.

Возвращаемое значение

Массив строк, представляющий подмножество заданных тегов локалей, которые поддерживаются правилами множественного числа без необходимости возвращаться к локали по умолчанию, используемой средой выполнения.

Примеры

Использование supportedLocalesOf()

Предполагая, что среда выполнения поддерживает индонезийский и немецкий языки, но не балийский, в правилах множественного числа, supportedLocalesOf возвращает теги индонезийского и немецкого языков без изменений, даже несмотря на то, что сопоставление pinyin не имеет отношения к правилам множественного числа и не используется с индонезийским языком, а специализированный немецкий для Индонезии вряд ли будет поддерживаться. Обратите внимание на спецификацию алгоритма "lookup" здесь — сопоставитель "best fit" может решить, что индонезийский язык является адекватным соответствием для балийского, поскольку большинство носителей балийского языка также понимают индонезийский, и, следовательно, также вернуть тег балийского языка.

const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };
console.log(Intl.PluralRules.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]

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

Спецификация
ECMAScript® 2027 Internationalization API Specification
# sec-intl.pluralrules.supportedlocalesof

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

Desktop Mobile Server
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on iOS Samsung Internet WebView Android WebView on iOS Bun Deno Node.js
supportedLocalesOf
63
18
58
50
13
63
58
46
13
8.0
63
13
1.0.0
1.8
10.0.0До версии 13.0.0 по умолчанию доступны только данные локали для en-US. Более подробную информацию смотрите в конструкторе PluralRules().

Смотрите также

  • Intl.PluralRules

© 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/PluralRules/supportedLocalesOf

Spec-Zone.ru

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