Intl.ListFormat.supportedLocalesOf()

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

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

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

Синтаксис

Intl.ListFormat.supportedLocalesOf(locales)
Intl.ListFormat.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.ListFormat.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]

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

Спецификация
ECMAScript® 2027 Internationalization API Specification # sec-Intl.ListFormat.supportedLocalesOf

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

	Настольные					Мобильные							Серверные
	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`	72	79	78	60	14.1 Доступно только в macOS Big Sur (11) и выше.	72	79	51	14.5	11.0	72	14.5	1.0.3	1.8	13.0.0 12.0.0–13.0.0 До версии 13.0.0 по умолчанию доступны только данные локали для `en-US`. Чтобы сделать полные данные ICU (локали) доступными до версии 13, см. документацию Node.js по опции `--with-intl` и способам предоставления данных.

См. также

Intl.ListFormat

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