Permissions: phương thức revoke()
Note: This feature is available in Web Workers.
Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
Phương thức revoke() của giao diện Permissions hoàn nguyên một quyền hiện đang được đặt về trạng thái mặc định của nó, thường là prompt.
Phương thức này được gọi trên đối tượng toàn cục Permissions navigator.permissions.
Phương thức này bị xóa khỏi thông số kỹ thuật Permissions API chính vì trường hợp sử dụng của nó không rõ ràng. Các quyền được quản lý bởi trình duyệt và mô hình quyền hiện tại không liên quan đến việc nhà phát triển trang web có thể yêu cầu hoặc thu hồi quyền theo cách chương trình. Các trình duyệt đã cung cấp API này đằng sau các preferences nhưng nó không thể đạt đến các tiêu chuẩn.
Cú pháp
revoke(permissionDescriptor)
Tham số
permissionDescriptor-
Một đối tượng đặt các tùy chọn cho thao tác
revoke. Các tùy chọn có sẵn cho descriptor này phụ thuộc vào loại quyền.Tất cả các quyền đều có tên:
Giá trị trả về
Một Promise gọi trình xử lý hoàn thành của nó với một đối tượng PermissionStatus chỉ ra kết quả của yêu cầu.
Ngoại lệ
TypeError-
Việc lấy thông tin
PermissionDescriptorthất bại theo cách nào đó, hoặc quyền không tồn tại hoặc hiện không được hỗ trợ (ví dụ:midi, hoặcpushvớiuserVisibleOnly).
Ví dụ
Hàm này có thể được sử dụng bởi ứng dụng để yêu cầu thu hồi quyền Geolocation API của chính nó.
function revokePermission() {
navigator.permissions.revoke({ name: "geolocation" }).then((result) => {
report(result.state);
});
}
Thông số kỹ thuật
| Specification |
|---|
| Relinquishing Permissions # dom-permissions-revoke |