--- title: permissions.remove() slug: Mozilla/Add-ons/WebExtensions/API/permissions/remove tags: - API - Add-ons - Method - Permissions - Reference - WebExtensions - remove translation_of: Mozilla/Add-ons/WebExtensions/API/permissions/remove ---
{{AddonSidebar()}}

Demander d'abandonner les permissions listées dans l'objet {{WebExtAPIRef("permissions.Permissions")}}.

L'argument Permissions peut contenir soit une propriété  origins ,qui est un tableau de permissions d'hôte , ou une propriété permissions, qui est un tableau de permissions d'API, ou les deux. Les permissions  doivent provenir de l'ensemble des permissions définies dans la clé optional_permissions du manifest.json.

Il s'agit d'une fonction asynchrone qui renvoie une Promesse.

Syntaxe

var removing = browser.permissions.remove(
  permissions                // Permissions object
)

Paramètres

permissions
Un objet {{WebExtAPIRef("permissions.Permissions")}}.

Valeur retournée

Une Promesse qui sera remplie avec true si les permissions répertoriées dans l'argument permissions ont été supprimées, ou false dans le cas contraire.

Browser compatibility

{{Compat("webextensions.api.permissions.remove")}}

Exemples

Ce code ajoute un gestionnaire de clic qui supprime une permission donnée.

const permissionToRemove = {
  permissions: ["history"]
}

function remove() {
  console.log("removing");
  browser.permissions.remove(permissionToRemove).then(result => {
    console.log(result);
  });
}

document.querySelector("#remove").addEventListener("click", remove);

{{WebExtExamples}}

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.