NavigatorLogin: phương thức setStatus()
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Phương thức setStatus() của giao diện NavigatorLogin đặt trạng thái đăng nhập của nhà cung cấp danh tính liên kết (IdP), khi được gọi từ origin của IdP. Theo "trạng thái đăng nhập", chúng ta có nghĩa là "liệu có người dùng nào đăng nhập vào IdP trên trình duyệt hiện tại hay không". Phương thức này nên được gọi bởi trang IdP sau khi người dùng đăng nhập hoặc đăng xuất.
Trình duyệt lưu trữ trạng thái này cho từng IdP; FedCM API sau đó sử dụng nó để giảm số lượng yêu cầu gửi đến IdP (vì không cần lãng phí thời gian yêu cầu tài khoản khi không có người dùng nào đăng nhập vào IdP). Nó cũng giảm thiểu các cuộc tấn công timing tiềm ẩn.
Xem Cập nhật trạng thái đăng nhập bằng Login Status API để biết thêm thông tin về trạng thái đăng nhập FedCM.
Cú pháp
setStatus(status)
Tham số
status-
Một chuỗi đại diện cho trạng thái đăng nhập cần đặt cho IdP. Các giá trị có thể là:
"logged-in": IdP có ít nhất một tài khoản người dùng đã đăng nhập."logged-out": Tất cả tài khoản người dùng IdP hiện đang đăng xuất.
Giá trị trả về
Một Promise thực hiện với undefined.
Ngoại lệ
SecurityErrorDOMException-
Được ném nếu miền gọi không nằm trong khung mà toàn bộ phân cấp lồng nhau là same-origin. Dù được gọi từ khung chính, một
<iframe>lồng trong khung chính, hay một<iframe>khác lồng một hoặc nhiều cấp sâu hơn trong<iframe>đầu tiên, tất cả các cấp của phân cấp lồng nhau phải cùng origin để cuộc gọi thành công.
Ví dụ
/* Set logged-in status */
navigator.login.setStatus("logged-in");
/* Set logged-out status */
navigator.login.setStatus("logged-out");
Thông số kỹ thuật
| Thông số kỹ thuật |
|---|
| Login Status API # dom-navigatorlogin-setstatus |