Intl.Collator.supportedLocalesOf()

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

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

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

Попробуйте

const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };

console.log(Intl.Collator.supportedLocalesOf(locales, options));
// Expected output: Array ["id-u-co-pinyin", "de-ID"]
// (Note: the exact output may be browser-dependent)

Синтаксис

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

Параметры

locales

Строка с языковым тегом BCP 47 или массив таких строк. Общая форма и интерпретация аргумента locales описаны в разделе параметров на основной странице Intl.

options Необязательно

Объект, который может иметь следующее свойство:

localeMatcher: Алгоритм сопоставления локалей для использования. Возможные значения: "lookup" и "best fit"; по умолчанию "best fit". Информацию об этой опции см. на странице Intl.

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

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

Примеры

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

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

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

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

Спецификация
ECMAScript® 2027 Internationalization API Specification # sec-intl.collator.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`	24	12	29	15	10	25	56	14	10	1.5	4.4	10	1.0.0	1.8	13.0.0 0.12.0–13.0.0 До версии 13.0.0 по умолчанию доступны только данные локалей для `en-US`. Чтобы сделать полные данные ICU (локалей) доступными до версии 13, см. документацию Node.js по опции `--with-intl` и как предоставить данные.

См. также

Intl.Collator

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