--- title: tabs.removeCSS() slug: Mozilla/Add-ons/WebExtensions/API/tabs/removeCSS tags: - API - Add-ons - Extensions - Mehod - Non-standard - Reference - WebExtensions - removeCSS - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/removeCSS ---
{{AddonSidebar()}}

Supprime d'une page CSS précédemment injectée par un appel à {{WebExtAPIRef("tabs.insertCSS()")}}.

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

var removing = browser.tabs.removeCSS(
  tabId,           // optional integer
  details          // object
)

Paramètres

tabId {{optional_inline}}
integer. L'ID de l'onglet à partir duquel supprimer le CSS. Par défaut à l'onglet actif de la fenêtre en cours.
details
Un objet décrivant le CSS à retirer de la page. Il contient les propriétés suivantes :
allFrames{{optional_inline}}
boolean. si true, le code sera supprimé de toutes les images de la page en cours. si c'est false, le code est seulement retiré du cadre supérieur. Par défaut à false.
code{{optional_inline}}
string. CSS à supprimer, en tant que chaîne de texte. Cela doit correspondre exactement à une chaîne CSS précédemment insérée dans la page en utilisant {{WebExtAPIRef("tabs.insertCSS()")}}.
cssOrigin{{optional_inline}}
string. Cela peut prendre l'une des deux valeurs suivantes : "user", pour CSS ajouté en tant que feuille de style utilisateur, ou "author" pour CSS ajouté en tant que feuille de style auteur. Si cette option a été définie précédemment par  {{WebExtAPIRef("tabs.insertCSS()")}}, elle doit correspondre exactement.
file{{optional_inline}}
string. Chemin d'accès à un fichier contenant le CSS à supprimer. Cela doit correspondre exactement à un fichier CSS préalablement inséré dans la page en utilisant {{WebExtAPIRef("tabs.insertCSS()")}}.
frameId{{optional_inline}}
integer. Le cadre à partir duquel supprimer le CSS. La valeur par défaut est 0 (l'image de niveau supérieur).
matchAboutBlank{{optional_inline}}
boolean. si true, le CSS sera supprimé des cadres "about:blank" et "about:srcdoc" intégrés si votre extension a accès à leur document parent. Par défaut à false.

Valeur retournée

Une Promise qui sera remplie sans arguments lorsque tous les CSS ont été supprimés. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

Exemples

Cet exemple ajoute du code CSS en utilisant {{WebExtAPIRef("tabs.insertCSS")}}, puis le supprime à nouveau lorsque l'utilisateur clique sur une action du navigateur :

var css = "body { border: 20px dotted pink; }";

function onError(error) {
  console.log(`Error: ${error}`);
}

var insertingCSS = browser.tabs.insertCSS(2, {code: css});
insertingCSS.then(null, onError);

browser.browserAction.onClicked.addListener(() => {
  var removing = browser.tabs.removeCSS(2, {code: css});
  removing.then(null, onError);
});

{{WebExtExamples}}

Compatibilité du navigateur

{{Compat("webextensions.api.tabs.removeCSS")}}

Remerciements :

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.json dans le code de Chromium code.

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.