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
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
. Wenntrue
, wird der Code aus allen Frames der aktuellen Seite entfernt. Wennfalse
, wird der Code nur aus dem obersten Frame entfernt. Standardwert istfalse
. code
Optional-
string
. Zu entfernendes CSS als Textzeichenkette. Dies muss genau mit einer zuvor mittabs.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 durchtabs.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 mittabs.insertCSS()
in die Seite eingefügten CSS-Datei übereinstimmen. frameId
Optional-
integer
. Der Frame, aus dem das CSS entfernt werden soll. Standardwert ist0
(der oberste Frame). matchAboutBlank
Optional-
boolean
. Wenntrue
, wird das CSS aus eingebetteten "about:blank" und "about:srcdoc"-Frames entfernt, wenn Ihre Erweiterung Zugriff auf deren übergeordnetes Dokument hat. Standardwert istfalse
.
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
Browser-Kompatibilität
Hinweis:
Diese API basiert auf Chromiums chrome.tabs
API. Diese Dokumentation ist abgeleitet von tabs.json
im Chromium-Code.