Intl.getCanonicalLocales()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2017.
Phương thức tĩnh Intl.getCanonicalLocales() trả về một mảng chứa các tên locale chuẩn hóa. Các phần tử trùng lặp sẽ bị bỏ qua và các phần tử sẽ được kiểm tra là các language tag hợp lệ về mặt cấu trúc.
Try it
console.log(Intl.getCanonicalLocales("EN-US"));
// Expected output: Array ["en-US"]
console.log(Intl.getCanonicalLocales(["EN-US", "Fr"]));
// Expected output: Array ["en-US", "fr"]
try {
Intl.getCanonicalLocales("EN_US");
} catch (err) {
console.log(err.toString());
// Expected output: RangeError: invalid language tag: "EN_US"
}
Cú pháp
js
Intl.getCanonicalLocales(locales)
Tham số
Giá trị trả về
Một mảng chứa các tên locale chuẩn hóa.
Ví dụ
Sử dụng getCanonicalLocales
js
Intl.getCanonicalLocales("EN-US"); // ["en-US"]
Intl.getCanonicalLocales(["EN-US", "Fr"]); // ["en-US", "fr"]
Intl.getCanonicalLocales("EN_US");
// RangeError: invalid language tag: "EN_US"
Đặc tả kỹ thuật
| Specification |
|---|
| ECMAScript® 2026 Internationalization API Specification # sec-intl.getcanonicallocales |