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. Dieses hat eine Benutzeroberfläche, die es dem Benutzer ermöglicht, auszuwählen, welche Art von Daten entfernt werden sollen (z. B. Verlauf, Downloads, …) und wie weit in die Vergangenheit die 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 entfernt werden können und einige UI-Optionen möglicherweise auf mehr als einen Datentyp abzielen.

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

Syntax

let getSettings = browser.browsingData.settings()

Parameter

Keine.

Rückgabewert

Ein Promise, das bei Erfüllung ein Objekt mit den Einstellungsinformationen enthält. Dieses Objekt hat drei Eigenschaften:

options: browsingData.RemovalOptions. Ein RemovalOptions-Objekt, das die aktuell ausgewählten Entfernungsoptionen 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 andernfalls false.
dataRemovalPermitted: 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 der Administrator des Geräts dem Benutzer erlaubt hat, diesen Typ zu entfernen, und andernfalls false.

Wenn ein Fehler auftritt, wird das Versprechen mit einer Fehlermeldung zurückgewiesen.

Browser-Kompatibilität

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

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