contentScripts.RegisteredContentScript.unregister()

Unregisters the content scripts represented by this RegisteredContentScript object.

Syntax

js
registered.unregister()

Parameters

None.

Return value

None.

Browser compatibility

Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
unregister

Examples

This code toggles a registered content script on a browser action click:

js
let registered = null;

async function register() {
  registered = await browser.contentScripts.register({
    matches: ["*://*.org/*"],
    js: [
      {
        code: "document.body.innerHTML = '<h1>This page has been eaten<h1>'",
      },
    ],
    runAt: "document_idle",
  });
}

function toggle() {
  if (registered) {
    registered.unregister();
    registered = null;
  } else {
    register();
  }
}

browser.browserAction.onClicked.addListener(toggle);