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