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
。