Intl.Locale.prototype.getCollations()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Phương thức getCollations() của các instance Intl.Locale trả về danh sách một hoặc nhiều kiểu sắp xếp cho locale này.

Note: Trong một số phiên bản của một số trình duyệt, phương thức này được triển khai dưới dạng thuộc tính truy cập có tên collations. Tuy nhiên, vì nó trả về một mảng mới mỗi lần truy cập, nó hiện được triển khai dưới dạng phương thức để tránh tình huống locale.collations === locale.collations trả về false. Kiểm tra bảng tương thích trình duyệt để biết thêm chi tiết.

Cú pháp

js
getCollations()

Tham số

Không có.

Giá trị trả về

Một mảng chuỗi đại diện cho tất cả các kiểu sắp xếp thường dùng cho Locale, được sắp xếp theo thứ tự bảng chữ cái, với các giá trị standardsearch luôn bị loại trừ. Nếu Locale đã có collation, thì mảng trả về chứa chính xác giá trị đó.

Để biết danh sách các kiểu sắp xếp được hỗ trợ, xem Intl.supportedValuesOf().

Ví dụ

Lấy danh sách kiểu sắp xếp được hỗ trợ

Nếu đối tượng Locale chưa có collation, getCollations() liệt kê tất cả các kiểu sắp xếp thường dùng cho Locale đã cho. Để xem ví dụ về cách đặt collation một cách rõ ràng, hãy xem ví dụ về collation.

js
const locale = new Intl.Locale("zh");
console.log(locale.getCollations()); // ["pinyin", "stroke", "zhuyin", "emoji", "eor"]

Đặc tả kỹ thuật

Specification
Intl Locale Info Proposal
# sec-Intl.Locale.prototype.getCollations

Tương thích trình duyệt

Xem thêm