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
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
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
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.