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

js
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 :

js
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

Compatibilité des navigateurs

BCD tables only load in the browser

Note :

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.