Spec-Zone.ru › JavaScript

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 и способы предоставления данных.

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

  • Intl.NumberFormat

© 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

Spec-Zone.ru

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