permissions.contains()

Vérifiez si l'extension a les permissions listées dans l'objet permissions.Permissions.

L'argument Permissions peut contenir une propriété origine, qui est un tableau de permissions hôtes, ou une propriété permissions , qui est un tableau de permissions API, ou les deux.

Il s'agit d'une fonction asynchrone qui renvoie une Promesse. La promesse est remplie avec true seulement si toute l'extension possède actuellement toutes les permissions données. Pour les permissions d'hôtes, si le modèle de permissions if the extension's permissions pattern-match the permissions listed in origins, then they are considered to match.

Syntaxe

js
var getContains = browser.permissions.contains(
  permissions, // Permissions object
);

Paramètres

permissions

Un objet permissions.Permissions .

Valeur renvoyée

Une Promesse qui sera remplie avec true si l'extension possède déjà toutes les permissions listées dans l'argument des permissions , ou false dans le cas contraire.

Compatibilité des navigateurs

Exemples

js
// Extension permissions are:
// "webRequest", "tabs", "*://*.mozilla.org/*"

var testPermissions1 = {
  origins: ["*://mozilla.org/"],
  permissions: ["tabs"],
};

browser.permissions.contains(testPermissions1).then((result) => {
  console.log(result); // true
});

var testPermissions2 = {
  origins: ["*://mozilla.org/"],
  permissions: ["tabs", "alarms"],
};

browser.permissions.contains(testPermissions2).then((result) => {
  console.log(result); // false, "alarms" doesn't match
});

var testPermissions3 = {
  origins: ["https://developer.mozilla.org/"],
  permissions: ["tabs", "webRequest"],
};

browser.permissions.contains(testPermissions3).then((result) => {
  console.log(result); // true: "https://developer.mozilla.org/"
}); // matches: "*://*.mozilla.org/*"

var testPermissions4 = {
  origins: ["https://example.org/"],
};

browser.permissions.contains(testPermissions4).then((result) => {
  console.log(result); // false, "https://example.org/"
}); // does not match

Example extensions

Note :

Cette API est basée sur l'API Chromium chrome.permissions.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.