permissions.remove()

请求放弃给定 permissions.Permissions 对象中列出的权限。

Permissions 参数可以包含 origins 属性(它是 主机权限 的数组),或 permissions 属性(它是 API 权限 的数组),或两者兼而有之。权限必须来自在 optional_permissions 清单 json 键中定义的权限集。

这是一个返回 Promise 的异步函数。

语法

js
let removing = browser.permissions.remove(
  permissions                // Permissions object
)

参数

权限

一个 permissions.Permissions 对象。

返回值

一个 Promise,如果 permissions 参数中列出的权限现在不再授予扩展,则其结果为 true,否则为 false

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

示例

此代码添加了一个点击处理程序,该处理程序删除给定的权限。

js
const permissionToRemove = {
  permissions: ["history"],
};

async function remove() {
  console.log("removing");
  const removed = await browser.permissions.remove(permissionToRemove);
  console.log(removed);
}

document.querySelector("#remove").addEventListener("click", remove);

扩展示例

注意:此 API 基于 Chromium 的 chrome.permissions API。