Permissions:revoke() 方法

备注: 此特性在 Web Worker 中可用。

已弃用: 不再推荐使用该特性。虽然一些浏览器仍然支持它,但也许已从相关的 web 标准中移除,也许正准备移除或出于兼容性而保留。请尽量不要使用该特性,并更新现有的代码;参见本页面底部的兼容性表格以指导你作出决定。请注意,该特性随时可能无法正常工作。

Permissions 接口的 revoke() 方法可将当前设置的权限还原为默认状态,即通常的 prompt 状态。该方法在全局 Permissions 对象 navigator.permissions 上调用。

语法

js
revoke(descriptor)

参数

descriptor

一个基于 PermissionDescriptor 字典的对象,用于设置由逗号分隔的键——值对列表组成的操作选项。可用的选项有:

name

要查询其权限的 API 的名称。每个浏览器支持不同的值集。你可以查阅 Firefox 的值Chromium 的值WebKit 的值

userVisibleOnly

(仅限推送,Firefox 不支持——请参阅下面的浏览器兼容性部分)表示是否要为每条信息显示通知,还是能够发送静默推送通知。默认为 false

sysex(仅限 MIDI)

表示是否需要接收系统专用消息。默认为 false

备注: 从 Firefox 44 开始,NotificationsPush 的权限已经合并。如果权限已授予(例如由用户在相关权限对话框中授予),navigator.permissions.query() 将为 notificationspush 返回 true

备注: persistent-storage 权限允许使用持久盒(即持久存储)进行存储,如 Storage API 所述。

返回值

一个 Promise,其会在调用兑现处理器时传入指示请求的结果的 PermissionStatus 对象。

异常

TypeError

以某种方式检索 PermissionDescriptor 信息失败,或该权限不存在或当前不支持(如 midi,或带有 userVisibleOnlypush)。

示例

应用程序可使用此函数请求撤销自己的地理位置 API 权限。

js
function revokePermission() {
  navigator.permissions.revoke({ name: "geolocation" }).then((result) => {
    report(result.state);
  });
}

规范

BCD tables only load in the browser

浏览器兼容性

BCD tables only load in the browser