management.getPermissionWarningsByManifest()

当用户安装或升级附加组件时,浏览器可能会警告用户有关附加组件请求的任何特别强大的 权限。并非所有权限都会导致警告,并且此行为在浏览器之间没有标准化。

给定 manifest.json 文件的文本,此函数返回将为生成的附加组件提供的权限警告,作为字符串数组。

此 API 不需要“management” API 权限

这是一个异步函数,它返回一个 Promise

语法

js
let gettingWarnings = browser.management.getPermissionWarningsByManifest(
  manifestString      // string
)

参数

manifestString

string。包含清单文件的字符串。这必须是一个有效的清单:例如,它必须包含所有必需的清单键。

返回值

一个 Promise,它将使用字符串数组完成,每个字符串都包含权限警告的文本。

浏览器兼容性

BCD 表格仅在浏览器中加载

示例

记录给定清单文件的权限警告

js
let manifest = {
  manifest_version: 2,
  name: "test",
  version: "1.0",
  permissions: ["management", "<all_urls>"],
};

let manifestString = JSON.stringify(manifest);

function gotWarnings(warnings) {
  console.log(warnings);
}

function gotError(error) {
  console.log(`Error: ${error}`);
}

let gettingWarnings =
  browser.management.getPermissionWarningsByManifest(manifestString);
gettingWarnings.then(gotWarnings, gotError);

注意:此 API 基于 Chromium 的 chrome.management API。此文档源自 Chromium 代码中的 management.json