scripting.removeCSS()

Syntax

await browser.scripting.removeCSS(
  details       // object
)

Parameter

details

Ein Objekt, das beschreibt, welches CSS entfernt werden soll und von wo. Es enthält die folgenden Eigenschaften:

css Optional

string. Eine Zeichenfolge mit dem einzufügenden CSS. Entweder css oder files muss angegeben werden und mit dem über scripting.insertCSS() eingefügten Stylesheet übereinstimmen.

files Optional

array von string. Der Pfad einer einzufügenden CSS-Datei, relativ zum Stammverzeichnis der Erweiterung. Entweder files oder css muss angegeben werden und mit dem über scripting.insertCSS() eingefügten Stylesheet übereinstimmen.

origin Optional

string. Der Ursprung des Stylesheets beim Einfügen, entweder USER oder AUTHOR. Der Standardwert ist AUTHOR. Er muss mit dem Ursprung des über scripting.insertCSS() eingefügten Stylesheets übereinstimmen.

target

scripting.InjectionTarget. Angaben zum Ziel, aus dem das CSS entfernt werden soll.

Rückgabewert

Ein Promise, das ohne Argumente erfüllt wird, wenn das gesamte CSS entfernt wurde. Wenn ein Fehler auftritt, wird das Promise zurückgewiesen. Versuche, nicht vorhandene Stylesheets zu entfernen, werden ignoriert.

Beispiele

Dieses Beispiel fügt mit scripting.insertCSS CSS hinzu und entfernt es wieder, wenn der Benutzer auf eine Browser-Aktion klickt:

// Assuming some style has been injected previously with the following code:
//
// await browser.scripting.insertCSS({
//   target: {
//     tabId: tab.id,
//   },
//   css: "* { background: #c0ffee }",
// });
//
// We can remove it when a user clicked an extension button like this:
browser.action.onClicked.addListener(async (tab) => {
  try {
    await browser.scripting.removeCSS({
      target: {
        tabId: tab.id,
      },
      css: "* { background: #c0ffee }",
    });
  } catch (err) {
    console.error(`failed to remove CSS: ${err}`);
  }
});

Beispielerweiterungen

• beastify

Browser-Kompatibilität