browsingData.settings()

Browser verfügen über eine integrierte Funktion "Chronik löschen", die es dem Benutzer ermöglicht, verschiedene Arten von Browserdaten zu löschen. Diese Funktion bietet eine Benutzeroberfläche, die es dem Benutzer ermöglicht auszuwählen, welche Art von Daten entfernt werden soll (z. B. Verlauf, Downloads, …) und wie weit zurück die Daten entfernt werden sollen.

Diese Funktion gibt den aktuellen Wert dieser Einstellungen zurück.

Beachten Sie, dass nicht immer alle Datentypen über die Benutzeroberfläche entfernt werden können und einige UI-Optionen möglicherweise zu mehr als einem Datentyp gehören.

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

Syntax

js
let getSettings = browser.browsingData.settings()

Parameter

Keine.

Rückgabewert

Ein Promise, das mit einem Objekt erfüllt wird, das die Einstellungen enthält. Dieses Objekt hat drei Eigenschaften:

options

browsingData.RemovalOptions. Ein RemovalOptions-Objekt, das die aktuell ausgewählten Entfernen-Optionen beschreibt.

dataToRemove

browsingData.DataTypeSet. Dies enthält eine Eigenschaft für jeden Datentyp, der in der Benutzeroberfläche des Browsers umgeschaltet werden kann. Jede Eigenschaft hat den Wert true, wenn dieser Typ zur Entfernung ausgewählt ist, und false, andernfalls.

dataRemovalPermitted

browsingData.DataTypeSet. Dies enthält eine Eigenschaft für jeden Datentyp, der in der Benutzeroberfläche des Browsers umgeschaltet werden kann. Jede Eigenschaft hat den Wert true, wenn der Administrator des Geräts dem Benutzer erlaubt hat, diesen Typ zu entfernen, und false andernfalls.

Wenn ein Fehler auftritt, wird das Promise mit einer Fehlermeldung abgelehnt.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

Aktuelle Einstellungen protokollieren:

js
function onGotSettings(settings) {
  console.log(settings.options);
  console.log(settings.dataToRemove);
  console.log(settings.dataRemovalPermitted);
}

function onError(error) {
  console.error(error);
}

browser.browsingData.settings().then(onGotSettings, onError);

Hinweis: Diese API basiert auf der chrome.browsingData API von Chromium.