Intl.ListFormat.supportedLocalesOf()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

Phương thức tĩnh Intl.ListFormat.supportedLocalesOf() trả về một mảng chứa các ngôn ngữ được hỗ trợ trong định dạng danh sách mà không cần phải quay lại ngôn ngữ mặc định của runtime.

Cú pháp

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

Tham số

locales

Một chuỗi với BCP 47 language tag, hoặc một mảng các chuỗi như vậy. Để biết dạng chung và cách diễn giải đối số locales, xem mô tả tham số trên trang chính Intl.

options Optional

Một đối tượng có thể có thuộc tính sau:

localeMatcher: Thuật toán khớp ngôn ngữ cần sử dụng. Các giá trị có thể là "lookup" và "best fit"; mặc định là "best fit". Để biết thêm thông tin về tùy chọn này, xem trang Intl.

Giá trị trả về

Một mảng các chuỗi đại diện cho một tập hợp con của các thẻ ngôn ngữ đã cho được hỗ trợ trong định dạng danh sách mà không cần phải quay lại ngôn ngữ mặc định của runtime.

Giả sử một runtime hỗ trợ tiếng Indonesia và tiếng Đức nhưng không hỗ trợ tiếng Bali trong định dạng danh sách, supportedLocalesOf trả về các thẻ ngôn ngữ Indonesia và Đức không thay đổi, mặc dù đối chiếu pinyin không liên quan đến định dạng danh sách và không được dùng với tiếng Indonesia, và tiếng Đức chuyên biệt cho Indonesia khó có khả năng được hỗ trợ. Lưu ý việc chỉ định thuật toán "lookup" ở đây — trình khớp "best fit" có thể quyết định rằng tiếng Indonesia là phù hợp đủ cho tiếng Bali vì hầu hết người nói tiếng Bali cũng hiểu tiếng Indonesia, và do đó trả về thẻ ngôn ngữ Bali.

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"]