Removes all items from the storage area.
This is an asynchronous function that returns a Promise.
StorageArea.clear()
Syntax
let clearing = browser.storage.<storageType>.clear()
<storageType> will be one of the writable storage types — storage.sync or storage.local.
Parameters
None.
Return value
A Promise that will be fulfilled with no arguments if the operation succeeded. If the operation failed, the promise will be rejected with an error message.
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
clear |
Yes | 14 | 45 | ? | 33 | 14 | ? | ? | 48 | ? | 15 | ? |
Examples
function onCleared() {
console.log("OK");
}
function onError(e) {
console.log(e);
}
let clearStorage = browser.storage.local.clear();
clearStorage.then(onCleared, onError);
Note: This API is based on Chromium's chrome.storage API. This documentation is derived from storage.json in the Chromium code.
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/clear