Modules

tabs.removeCSS()

Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.

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. The ID of the tab from which to remove the CSS. Defaults to the active tab of the current window.
details
An object describing the CSS to remove from the page. It contains the following properties:
 
allFramesFacultatif
boolean. If true, the code will be removed from all frames of the current page. If it is false, code is only removed from the top frame. Defaults to false.
codeFacultatif
string. CSS to remove, as a text string. This must exactly match a CSS string previously inserted into the page using tabs.insertCSS().
cssOriginFacultatif
string. This can take one of two values: "user", for CSS added as a user stylesheet, or "author" for CSS added as an author stylesheet. If this option was set previously by tabs.insertCSS(), then it must exactly match.
fileFacultatif
string. Path to a file containing the CSS to remove. This must exactly match a CSS file previously inserted into the page using tabs.insertCSS().
frameIdFacultatif
integer. The frame from which to remove the CSS. Defaults to 0 (the top-level frame).
matchAboutBlankFacultatif
boolean. If true, the CSS will be removed from embedded "about:blank" and "about:srcdoc" frames if your extension has access to their parent document. Defaults to false.

Valeur retournée

A Promise that will be fulfilled with no arguments when all the CSS has been removed. If any error occurs, the promise will be rejected with an error message.

Compatibilité du navigateur

ChromeEdgeFirefoxFirefox for AndroidOpera
Support simple Non Non4954 Non

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,