history.deleteAll()
Deletes all visits from the browser's history.
This function triggers history.onVisitRemoved
just once, with allHistory
set to true
and an empty urls
argument.
This is an asynchronous function that returns a Promise
.
Syntax
js
let deletingAll = browser.history.deleteAll()
Parameters
None.
Return value
A Promise
will be fulfilled with no parameters when all history has been deleted.
Browser compatibility
Report problems with this compatibility data on GitHubdesktop | mobile | ||||||
---|---|---|---|---|---|---|---|
deleteAll |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Examples
Delete all history when the user clicks a browser action:
js
function onDeleteAll() {
console.log("Deleted all history");
}
function deleteAllHistory() {
let deletingAll = browser.history.deleteAll();
deletingAll.then(onDeleteAll);
}
deleteAllHistory();
Note:
This API is based on Chromium's chrome.history
API. This documentation is derived from history.json
in the Chromium code.