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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
settings

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Has more compatibility info.

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.