tabs.removeCSS()

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

Hinweis: Bei der Verwendung von Manifest V3 oder höher verwenden Sie scripting.insertCSS() und scripting.removeCSS(), um CSS einzufügen und zu entfernen.

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, aus dem das CSS entfernt werden soll. Standardmäßig ist dies der aktive Tab des aktuellen Fensters.

details

Ein Objekt, das das zu entfernende CSS auf der Seite beschreibt. Es enthält folgende Eigenschaften:

allFrames Optional

boolean. Wenn true, wird der Code aus allen Frames der aktuellen Seite entfernt. Ist es false, wird der Code nur aus dem Hauptframe entfernt. Standardmäßig false.

code Optional

string. Das zu entfernende CSS, als Textzeichenfolge. Dies muss genau mit einer zuvor auf der Seite eingefügten CSS-Zeichenfolge übereinstimmen, die mit tabs.insertCSS() eingefügt wurde.

cssOrigin Optional

string. Dies kann einen der zwei Werte 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 mit 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 auf der Seite eingefügten CSS-Datei übereinstimmen, die mit tabs.insertCSS() eingefügt wurde.

frameId Optional

integer. Das Frame, aus dem das CSS entfernt werden soll. Standardmäßig 0 (das oberste Frame).

matchAboutBlank Optional

boolean. Wenn true, wird das CSS auch aus eingebetteten "about:blank"- und "about:srcdoc"-Frames entfernt, wenn Ihre Erweiterung Zugriff auf das übergeordnete Dokument hat. Standardmäßig 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 etwas CSS hinzu, indem tabs.insertCSS verwendet wird, und entfernt es dann 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);
});

Beispiel-Erweiterungen

Browser-Kompatibilität

BCD tables only load in the browser

Hinweis: Diese API basiert auf der chrome.tabs API von Chromium. Diese Dokumentation stammt aus tabs.json im Chromium-Code.