history.deleteUrl()

Entfernt alle Besuche der angegebenen URL aus dem Browserverlauf.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

js
let deletingUrl = browser.history.deleteUrl(
  details         // object
)

Parameter

details

object. Objekt, das die URL enthält, deren Besuche entfernt werden sollen.

url

string. Die URL, deren Besuche entfernt werden sollen.

Rückgabewert

Ein Promise wird ohne Parameter erfüllt, wenn die Besuche entfernt wurden.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

Entfernen Sie alle Besuche von "https://example.org/" aus dem Verlauf und überprüfen Sie dann, dass diese URL nicht mehr von history.search() zurückgegeben wird:

js
let urlToRemove = "https://example.org/";

function onGot(results) {
  if (!results.length) {
    console.log(`${urlToRemove} was removed`);
  } else {
    console.log(`${urlToRemove} was not removed`);
  }
}

function onRemoved() {
  let searching = browser.history.search({
    text: urlToRemove,
    startTime: 0,
  });

  searching.then(onGot);
}

let deletingUrl = browser.history.deleteUrl({ url: urlToRemove });

deletingUrl.then(onRemoved);

Entfernen Sie die zuletzt besuchte Seite aus dem Verlauf mit einem Listener für history.onVisitRemoved, um die URL der entfernten Seite zu protokollieren:

js
function onRemoved(removeInfo) {
  if (removeInfo.urls.length) {
    console.log(`Removed: ${removeInfo.urls[0]}`);
  }
}

browser.history.onVisitRemoved.addListener(onRemoved);

function onGot(results) {
  if (results.length) {
    console.log(`Removing: ${results[0].url}`);
    browser.history.deleteUrl({ url: results[0].url });
  }
}

let searching = browser.history.search({
  text: "",
  startTime: 0,
  maxResults: 1,
});

searching.then(onGot);

Beispielerweiterungen

Hinweis: Diese API basiert auf der chrome.history API von Chromium. Diese Dokumentation stammt aus history.json im Chromium-Code.