tabs.removeCSS()

Syntax

let removing = browser.tabs.removeCSS(
  tabId,           // optional integer
  details          // object
)

Parameter

tabId Optional

integer. Die ID des Tabs, von dem das CSS entfernt werden soll. Standardmäßig der aktive Tab des aktuellen Fensters.

details

Ein Objekt, das das zu entfernende CSS beschreibt. Es enthält die folgenden Eigenschaften:

allFrames Optional

boolean. Wenn true, wird der Code aus allen Frames der aktuellen Seite entfernt. Wenn false, wird der Code nur aus dem obersten Frame entfernt. Standardwert ist false.

code Optional

string. Zu entfernendes CSS als Textzeichenkette. Dies muss genau mit einer zuvor mit tabs.insertCSS() in die Seite eingefügten CSS-Zeichenkette übereinstimmen.

cssOrigin Optional

string. Dies kann einen von zwei Werten annehmen: "user" für CSS, das als Benutzer-Stylesheet hinzugefügt wurde, oder "author" für CSS, das als Autoren-Stylesheet hinzugefügt wurde. Wenn diese Option zuvor durch tabs.insertCSS() gesetzt wurde, muss sie genau übereinstimmen.

file Optional

string. Pfad zu einer Datei, die das zu entfernende CSS enthält. Dies muss genau mit einer zuvor mit tabs.insertCSS() in die Seite eingefügten CSS-Datei übereinstimmen.

frameId Optional

integer. Der Frame, aus dem das CSS entfernt werden soll. Standardwert ist 0 (der oberste Frame).

matchAboutBlank Optional

boolean. Wenn true, wird das CSS aus eingebetteten "about:blank" und "about:srcdoc"-Frames entfernt, wenn Ihre Erweiterung Zugriff auf deren übergeordnetes Dokument hat. Standardwert ist false.

Rückgabewert

Ein Promise, das ohne Argumente erfüllt wird, wenn das gesamte CSS entfernt wurde. Wenn ein Fehler auftritt, wird das Promise mit einer Fehlermeldung abgelehnt.

Beispiele

Dieses Beispiel fügt mithilfe von tabs.insertCSS etwas CSS hinzu und entfernt es wieder, wenn der Benutzer auf eine Browseraktion klickt:

let css = "body { border: 20px dotted pink; }";

function onError(error) {
  console.log(`Error: ${error}`);
}

let insertingCSS = browser.tabs.insertCSS(2, { code: css });
insertingCSS.then(null, onError);

browser.browserAction.onClicked.addListener(() => {
  let removing = browser.tabs.removeCSS(2, { code: css });
  removing.then(null, onError);
});

Beispielerweiterungen

• apply-css
• beastify

Browser-Kompatibilität