PublicKeyCredential: phương thức tĩnh isUserVerifyingPlatformAuthenticatorAvailable()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Phương thức tĩnh isUserVerifyingPlatformAuthenticatorAvailable() của giao diện PublicKeyCredential trả về một Promise được giải quyết thành true nếu có thiết bị xác thực nền tảng xác minh người dùng.
Thiết bị xác thực nền tảng xác minh người dùng là một loại thiết bị xác thực đa yếu tố là một phần của thiết bị client (thường không thể tháo rời) và yêu cầu hành động từ người dùng để nhận dạng họ. Các thiết bị xác thực nền tảng xác minh người dùng phổ biến bao gồm:
- Touch ID hoặc Face ID (macOS và iOS)
- Windows Hello (Windows)
- Mở khóa thiết bị (vân tay, khuôn mặt, mã PIN, v.v.) trên Android
Note:
Phương thức này chỉ có thể được sử dụng trong ngữ cảnh cấp cao nhất và sẽ không có sẵn trong một <iframe> chẳng hạn.
Cú pháp
PublicKeyCredential.isUserVerifyingPlatformAuthenticatorAvailable()
Tham số
Không có.
Giá trị trả về
Một Promise được giải quyết thành giá trị boolean cho biết có hay không có thiết bị xác thực nền tảng xác minh người dùng.
Note: Trong các phiên bản đầu của đặc tả, boolean cũng truyền đạt sự đồng ý của người dùng để tiết lộ rằng thiết bị xác thực như vậy tồn tại.
Ngoại lệ
Promise được trả về có thể bị từ chối với các giá trị sau:
SecurityErrorDOMException-
Miền RP không hợp lệ.
Ví dụ
PublicKeyCredential.isUserVerifyingPlatformAuthenticatorAvailable()
.then((available) => {
if (available) {
// We can proceed with the creation of a PublicKeyCredential
// with this authenticator
} else {
// Use another kind of authenticator or a classical login/password
// workflow
}
})
.catch((err) => {
// Something went wrong
console.error(err);
});
Thông số kỹ thuật
| Specification |
|---|
| Web Authentication: An API for accessing Public Key Credentials - Level 3> # dom-publickeycredential-isuserverifyingplatformauthenticatoravailable> |