management.getPermissionWarningsByManifest()

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

给定manifest.json文件的内容,此函数会返回由此附加组件产生的权限警告,这些警告是一个字符串数组。

此 API不需要“management”API 权限

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

语法

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

参数

manifestString

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

返回值

一个Promise,它将以字符串数组的形式兑现,每个字符串都包含权限警告的文本。

示例

记录给定 manifest 文件的权限警告

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