tabs.removeCSS()

Entfernt von einer Seite CSS, das zuvor durch einen Aufruf von tabs.insertCSS() eingefügt wurde.

Hinweis: Bei Verwendung von Manifest V3 oder höher, verwenden Sie scripting.insertCSS() und scripting.removeCSS() zum Einfügen und Entfernen von CSS.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

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

js
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

Browser-Kompatibilität

Hinweis: Diese API basiert auf Chromiums chrome.tabs API. Diese Dokumentation ist abgeleitet von tabs.json im Chromium-Code.