history.deleteAll()

{{AddonSidebar}} 

Deletes all visits from the browser’s history.

This function triggers {{WebExtAPIRef("history.onVisitRemoved")}}  just once, with allHistory set to true and an empty urls argument.

This is an asynchronous function that returns a Promise.

Syntax

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

{{Compat}} 

Examples

Delete all history when the user clicks a browser action:

function onDeleteAll() {
  console.log("Deleted all history");
}

function deleteAllHistory() {
  let deletingAll = browser.history.deleteAll();
  deletingAll.then(onDeleteAll);
}

deleteAllHistory();

{{WebExtExamples}} 

[!NOTE] This API is based on Chromium’s chrome.history API. This documentation is derived from history.json in the Chromium code.