tabs.removeCSS()

Supprime d'une page CSS précédemment injectée par un appel à 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 Facultatif
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 :
 
allFramesFacultatif
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.
codeFacultatif
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 tabs.insertCSS().
cssOriginFacultatif
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  tabs.insertCSS(), elle doit correspondre exactement.
fileFacultatif
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 tabs.insertCSS().
frameIdFacultatif
integer. Le cadre à partir duquel supprimer le CSS. La valeur par défaut est 0 (l'image de niveau supérieur).
matchAboutBlankFacultatif
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.

Compatibilité du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
Support simpleChrome Aucun support NonEdge Aucun support NonFirefox Support complet 49Opera Aucun support NonFirefox Android Support complet 54

Légende

Support complet  
Support complet
Aucun support  
Aucun support

Exemples

Cet exemple ajoute du code CSS en utilisant 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);
});

Example extensions

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.

Étiquettes et contributeurs liés au document

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