clear()

Use BrowserSetting.clear() to clear any changes the extension has made to the browser setting. The browser setting will revert to its previous value.

The extension will also give up control of the setting, allowing an extension with lower precedence (that is, an extension that was installed before this one) to modify the setting. See BrowserSetting.set() to learn more about controlling settings.

This is an asynchronous function that returns a Promise. If clearing the value failed, the promise resolves to false. If clearing the value succeeded it resolves to true.

Syntax

js
let clearing = setting.clear(
  details     // object
)

Parameters

details

An empty object.

Return value

A Promise that will be fulfilled with a boolean: true if the setting was cleared, false otherwise.

Browser compatibility

See types.BrowserSetting.

Example

Clear the webRTCIPHandlingPolicy setting:

js
function onCleared(result) {
  if (result) {
    console.log("Setting was cleared");
  } else {
    console.log("Setting was not cleared");
  }
}

let clearing = browser.privacy.network.webRTCIPHandlingPolicy.clear({});
clearing.then(onCleared);

Note:

This API is based on Chromium's chrome.types API.