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

BCD tables only load in the browser

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.