Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

browsingData.settings()

Browser verfügen über eine integrierte Funktion zum Löschen des Verlaufs, mit der Benutzer verschiedene Arten von Browserdaten löschen können. Über eine Benutzeroberfläche können sie auswählen, welche Datenarten entfernt werden sollen (z. B. Verlauf, Downloads, …) und wie weit zurückliegende Daten gelöscht werden sollen.

Diese Funktion gibt die aktuellen Werte dieser Einstellungen zurück.

Beachten Sie, dass nicht alle Datenarten immer über die Benutzeroberfläche gelöscht werden können und manche Optionen der Benutzeroberfläche mehreren Datenarten zugeordnet sein können.

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

Syntax

js
let getSettings = browser.browsingData.settings()

Parameter

Keine.

Rückgabewert

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

options

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

dataToRemove

browsingData.DataTypeSet. Enthält eine Eigenschaft für jede Datenart, die in der Benutzeroberfläche des Browsers ausgewählt oder abgewählt werden kann. Jede Eigenschaft hat den Wert true, wenn die betreffende Datenart zum Entfernen ausgewählt ist, andernfalls false.

dataRemovalPermitted

browsingData.DataTypeSet. Enthält eine Eigenschaft für jede Datenart, die in der Benutzeroberfläche des Browsers ausgewählt oder abgewählt werden kann. Jede Eigenschaft hat den Wert true, wenn der Administrator des Geräts dem Benutzer das Entfernen dieser Datenart erlaubt hat, andernfalls false.

Wenn ein Fehler auftritt, wird die Promise mit einer Fehlermeldung zurückgewiesen.

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

Browser-Kompatibilität

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