MDN will be in maintenance mode on Wednesday September 20th, starting at 10 AM Pacific / 5 PM UTC, for about 1 hour.

Add-ons

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 precendence (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

var 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:

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

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

Acknowledgements

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

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.

Document Tags and Contributors

 Contributors to this page: andrewtruongmoz, wbamberg, jwhitlock, bunnybooboo
 Last updated by: andrewtruongmoz,