tabs.removeCSS()

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

Hinweis: Bei 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 wird der aktive Tab des aktuellen Fensters verwendet.

details

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

allFrames Optional

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

code Optional

string. Zu entfernendes CSS als Textzeichenfolge. Diese muss exakt einer CSS-Zeichenfolge entsprechen, die zuvor mit tabs.insertCSS() in die Seite eingefügt wurde.

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 exakt übereinstimmen.

file Optional

string. Pfad zu einer Datei, die das zu entfernende CSS enthält. Diese muss exakt einer CSS-Datei entsprechen, die zuvor mit tabs.insertCSS() in die Seite eingefügt wurde.

frameId Optional

integer. Der Frame, aus dem das CSS entfernt werden soll. Standardmäßig 0 (der 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 deren Elterndokument hat. Standardmäßig false.

Rückgabewert

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

Beispiele

Dieses Beispiel fügt CSS mit tabs.insertCSS hinzu und entfernt es dann wieder, wenn der Benutzer auf eine Browser-Aktion 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 der chrome.tabs API von Chromium. Diese Dokumentation ist abgeleitet von tabs.json im Chromium-Code.