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 :
allFrames
Facultatif-
boolean
. sitrue
, le code sera supprimé de toutes les images de la page en cours. si c'estfalse
, le code est seulement retiré du cadre supérieur. Par défaut àfalse
. code
Facultatif-
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 utilisanttabs.insertCSS()
. cssOrigin
Facultatif-
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 partabs.insertCSS()
, elle doit correspondre exactement. file
Facultatif-
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 utilisanttabs.insertCSS()
. frameId
Facultatif-
integer
. Le cadre à partir duquel supprimer le CSS. La valeur par défaut est0
(l'image de niveau supérieur). matchAboutBlank
Facultatif-
boolean
. sitrue
, 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);
});
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.