browsingData.settings()

Syntax

let getSettings = browser.browsingData.settings()

Parameters

None.

Return value

A Promise that will be fulfilled with an object containing the settings information. This object has three properties:

options

browsingData.RemovalOptions. A RemovalOptions object describing the removal options currently selected.

dataToRemove

browsingData.DataTypeSet. This will contain a property for every data type that can be toggled in the browser's UI. Each property will have a value of true if that type is selected for removal and false otherwise.

dataRemovalPermitted

browsingData.DataTypeSet. This will contain a property for every data type that can be toggled in the browser's UI. Each will have a value of true if the administrator of the device has allowed the user to remove that type, and false otherwise.

If any error occurs, the promise will be rejected with an error message.

Examples

Log current settings:

function onGotSettings(settings) {
  console.log(settings.options);
  console.log(settings.dataToRemove);
  console.log(settings.dataRemovalPermitted);
}
function onError(error) {
  console.error(error);
}
browser.browsingData.settings().then(onGotSettings, onError);

Browser compatibility