browsingData.settings()

Browser verfügen über eine integrierte Funktion "Verlauf löschen", die es dem Benutzer ermöglicht, verschiedene Arten von Browserdaten zu löschen. Diese Funktion bietet eine Benutzeroberfläche, mit der der Benutzer auswählen kann, welche Art von Daten gelöscht werden sollen (z. B. Verlauf, Downloads, …) und wie weit in die Vergangenheit Daten entfernt werden sollen.

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

Beachten Sie, dass nicht alle Datentypen immer über die Benutzeroberfläche entfernbar sind und einige Benutzeroberflächenoptionen möglicherweise mehr als einem Datentyp zugeordnet sind.

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

Syntax

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 derzeit ausgewählten Entfernungsmöglichkeiten beschreibt.
dataToRemove: browsingData.DataTypeSet. Dies wird eine Eigenschaft für jeden Datentyp enthalten, 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 ansonsten.
dataRemovalPermitted: browsingData.DataTypeSet. Dies wird eine Eigenschaft für jeden Datentyp enthalten, der in der Benutzeroberfläche des Browsers umgeschaltet werden kann. Jede hat den Wert true, wenn der Administrator des Geräts dem Benutzer erlaubt hat, diesen Typ zu entfernen, und false ansonsten.

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

Beispiele

Aktuelle Einstellungen protokollieren:

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);

Browser-Kompatibilität

Hinweis: Diese API basiert auf Chromiums chrome.browsingData API.