browsingData.RemovalOptions

The browsingData.RemovalOptions type contains options to control certain aspects of browsing data removal.

It contains two properties, both optional:

  • since describes how far back in time to remove data
  • originTypes describes whether to remove data only from normal web pages, or also from hosted web apps and add-ons.

Type

Values of this type are objects. They contain the following properties:

since Optional
number. How far back in time to remove data, given in milliseconds since the UNIX epoch. Note that when removing the browser cache, the entire cache is always removed and this option is ignored. If the since property is omitted, it defaults to 0, which means "forever".
originTypes Optional

object. Used to control whether to remove data only from normal web pages, or also from hosted web apps and add-ons. If this option is omitted, only data from normal web pages ("unprotectedWeb") is removed. Before removing data from web apps or add-ons, be very careful to ensure that this is really what the user wants.

This object may contain any of the following properties:

unprotectedWeb Optional
boolean. If present and true, remove data from normal web pages.
protectedWeb Optional
boolean. If present and true, remove data from websites that have been installed as hosted apps.
extension Optional
boolean. If present and true, remove data from add-ons.

Browser compatibility

Chrome Edge Firefox Firefox for Android Opera
Basic support Yes No 53.0 No No

Compatibility notes

Firefox

  • The 'protectedWeb' and 'extension' values of 'originTypes' are not supported.

Acknowledgements

This API is based on Chromium's chrome.browsingData 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: wbamberg
 Last updated by: wbamberg,