browsingData.removeLocalStorage()

Clears any local storage and session storage created by websites and extensions.

You can use the removalOptions parameter, which is a browsingData.RemovalOptions object, to:

  • clear local and session storage values created after a given time.
  • control whether to clear localStorage and sessionStorage values created by web pages or web pages extensions.

Syntax

js
let removing = browser.browsingData.removeLocalStorage(
  removalOptions            // RemovalOptions object
)

Parameters

removalOptions

object. A browsingData.RemovalOptions object, which can be used to clear localStorage and sessionStorage values stored after a given time, and control whether to clear localStorage and sessionStorage objects created by web pages, or web pages and extensions.

Return value

A Promise that is fulfilled with no arguments when the removal has finished. If any error occurs, the promise is rejected with an error message.

Examples

Remove all local storage:

js
function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

browser.browsingData.removeLocalStorage({}).then(onRemoved, onError);

Browser compatibility

desktop mobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
removeLocalStorage
Chrome – Full support
Chrome 19 (Release date: 2012-05-15)
footnote Full support
Edge – Full support
Edge 79 (Release date: 2020-01-15)
footnote Full support
Firefox – Full support
Firefox 57 (Release date: 2017-11-14)
footnote
footnote Also removes sessionStorage from Firefox 146.
Opera – Full support
Opera 15 (Release date: 2013-07-02)
footnote Full support
Safari – No support
Safari
footnote No support
Firefox for Android – Full support
Firefox for Android 85 (Release date: 2021-01-26)
footnote
footnote Also removes sessionStorage from Firefox 146.
Safari on iOS – No support
Safari on iOS
footnote No support
removalOptions
Chrome – Full support
Chrome 19 (Release date: 2012-05-15)
footnote Full support
Edge – Full support
Edge 79 (Release date: 2020-01-15)
footnote Full support
Firefox – Full support
Firefox 58 (Release date: 2018-01-23)
footnote Full support
Opera – Full support
Opera 15 (Release date: 2013-07-02)
footnote Full support
Safari – No support
Safari
footnote No support
Firefox for Android – Full support
Firefox for Android 85 (Release date: 2021-01-26)
footnote Full support
Safari on iOS – No support
Safari on iOS
footnote No support
removalOptions.hostnames
Chrome – No support
Chrome
footnote No support
Edge – No support
Edge
footnote No support
Firefox – Full support
Firefox 58 (Release date: 2018-01-23)
footnote Full support
Opera – No support
Opera
footnote No support
Safari – No support
Safari
footnote No support
Firefox for Android – Full support
Firefox for Android 85 (Release date: 2021-01-26)
footnote Full support
Safari on iOS – No support
Safari on iOS
footnote No support
removalOptions.since
Chrome – Full support
Chrome 19 (Release date: 2012-05-15)
footnote Full support
Edge – Full support
Edge 79 (Release date: 2020-01-15)
footnote Full support
Firefox – No support
Firefox
footnote No support
Opera – Full support
Opera 15 (Release date: 2013-07-02)
footnote Full support
Safari – No support
Safari
footnote No support
Firefox for Android – No support
Firefox for Android
footnote No support
Safari on iOS – No support
Safari on iOS
footnote No support

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

Note: This API is based on Chromium's chrome.browsingData API.