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

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é du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
Support simpleChrome Support complet OuiEdge Aucun support NonFirefox Support complet 55Opera Support complet OuiFirefox Android Support complet 55

Légende

Support complet  
Support complet
Aucun support  
Aucun support

Exemples

// 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

Remerciements :

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.

Étiquettes et contributeurs liés au document

Contributeurs à cette page : hellosct1
Dernière mise à jour par : hellosct1,