NavigatorUAData
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Note: This feature is available in Web Workers.
Giao diện NavigatorUAData của User-Agent Client Hints API trả về thông tin về trình duyệt và hệ điều hành của người dùng.
Một đối tượng của giao diện này được trả về bằng cách gọi Navigator.userAgentData hoặc WorkerNavigator.userAgentData. Do đó, giao diện này không có hàm khởi tạo.
Note:
Các thuật ngữ high entropy và low entropy đề cập đến lượng thông tin mà các giá trị này tiết lộ về trình duyệt. Các giá trị được trả về dưới dạng thuộc tính được coi là low entropy, khó có khả năng nhận dạng người dùng. NavigatorUAData.getHighEntropyValues() có thể được dùng để yêu cầu các giá trị high entropy bổ sung, có thể tiết lộ thêm thông tin nhận dạng. Do đó, các giá trị này được truy xuất qua Promise, cho phép thời gian để trình duyệt yêu cầu quyền người dùng, hoặc thực hiện các kiểm tra khác.
Thuộc tính phiên bản
-
Trả về mảng thông tin thương hiệu chứa tên và phiên bản trình duyệt.
-
Trả về
truenếu user-agent đang chạy trên thiết bị di động. -
Trả về thương hiệu nền tảng mà user-agent đang chạy trên.
Phương thức phiên bản
-
Trả về một
Promisegiải quyết với đối tượng từ điển chứa thông tin low entropy và thông tin high entropy được yêu cầu về trình duyệt. -
Một serializer trả về biểu diễn JSON của các thuộc tính low entropy của đối tượng
NavigatorUAData.
Ví dụ
Lấy thương hiệu
Ví dụ dưới đây in giá trị của NavigatorUAData.brands ra console.
console.log(navigator.userAgentData.brands);
Trả về giá trị high entropy
Trong ví dụ sau, một số gợi ý được yêu cầu bằng phương thức NavigatorUAData.getHighEntropyValues(). Khi promise giải quyết, thông tin này được in ra console.
navigator.userAgentData
.getHighEntropyValues([
"architecture",
"model",
"platform",
"platformVersion",
"fullVersionList",
])
.then((ua) => {
console.log(ua);
});
Thông số kỹ thuật
| Specification |
|---|
| User-Agent Client Hints # navigatoruadata |