Intl.NumberFormat.supportedLocalesOf()
Базовый уровень Широко доступно
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и в различных версиях браузеров. Она доступна во всех браузерах с сентября 2017 года.
Статический метод Intl.NumberFormat.supportedLocalesOf() возвращает массив, содержащий те из предоставленных локалей, которые поддерживаются при форматировании чисел без необходимости переключаться на локаль по умолчанию среды выполнения.
Попробовать
const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };
console.log(Intl.NumberFormat.supportedLocalesOf(locales, options));
// Expected output: Array ["id-u-co-pinyin", "de-ID"]
// (Note: the exact output may be browser-dependent)
Синтаксис
Intl.NumberFormat.supportedLocalesOf(locales) Intl.NumberFormat.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.NumberFormat.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]
Спецификации
| Спецификация |
|---|
| ECMAScript® 2027 Internationalization API Specification # sec-intl.numberformat.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 и способы предоставления данных. |
Смотрите также
© 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/NumberFormat/supportedLocalesOf