tabs.removeCSS()

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.

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);
});

Exemples d'extensions

• apply-css
• beastify

Compatibilité des navigateurs