browsingData.RemovalOptions

Der Typ browsingData.RemovalOptions enthält Optionen, um bestimmte Aspekte der Entfernung von Browserdaten zu steuern.

Typ

Werte dieses Typs sind Objekte. Sie enthalten die folgenden Eigenschaften:

cookieStoreId Optional

string. Diese Eigenschaft gilt nur für Cookies und indexedDB-Elemente. Die Entfernung ist auf Elemente beschränkt, die zu einem bestimmten Cookie-Store gehören, wie durch die ID angegeben. Weitere Informationen finden Sie unter Arbeiten mit kontextuellen Identitäten.

Hinweis: In Firefox Nightly wird auch die Entfernung von localStorage-Elementen durch cookieStoreId unterstützt.

excludeOrigin Optional

array von string. Liste von Ursprüngen, die von der Entfernung ausgeschlossen werden sollen. Kann nicht zusammen mit origins verwendet werden. Nur für Cookies, Speicher und Cache unterstützt. Cookies werden für die gesamte registrierbare Domain ausgeschlossen.

hostnames Optional

array von string. Diese Eigenschaft gilt für Cookies, indexedDB-, lokaler Speicher- und Service-Worker-Registrierungs-Elemente. Nur Cookie-, indexedDB-, lokaler Speicher- und Service-Worker-Registrierungs-Elemente entfernen, die diesen Hostnamen zugeordnet sind.

Hier muss nur ein Hostname ohne Protokoll angegeben werden (zum Beispiel, "google.com" statt "https://google.com"). Sie können die URL-Schnittstelle verwenden, um eine rohe URL zu parsen und den Hostnamen abzurufen. Elemente, die mit Subdomains eines gegebenen Hostnamens verbunden sind, werden nicht entfernt: Sie müssen Subdomains explizit auflisten.

origin Optional

array von string. Liste der Ursprünge, für die Daten entfernt werden sollen. Kann nicht zusammen mit excludeOrigins verwendet werden. Nur für Cookies, Speicher und Cache unterstützt. Cookies werden für die gesamte registrierbare Domain gelöscht.

originTypes Optional

object. Wird verwendet, um zu steuern, ob Daten nur von normalen Webseiten entfernt werden oder auch von gehosteten Web-Apps und Erweiterungen. Wenn diese Option weggelassen wird, werden nur Daten von normalen Webseiten (unprotectedWeb) entfernt. Bevor Sie Daten von Web-Apps oder Erweiterungen entfernen, seien Sie sehr vorsichtig und stellen Sie sicher, dass dies wirklich das ist, was der Benutzer will.

Dieses Objekt kann eine der folgenden Eigenschaften enthalten:

unprotectedWeb Optional

boolean. Wenn vorhanden und true, Daten von normalen Webseiten entfernen.

protectedWeb Optional

boolean. Wenn vorhanden und true, Daten von Webseiten entfernen, die als gehostete Apps installiert wurden.

extension Optional

boolean. Wenn vorhanden und true, Daten von Erweiterungen entfernen.

since Optional

number. Wie weit in die Vergangenheit sollen Daten entfernt werden, angegeben in Millisekunden seit der UNIX-Epoche. Beachten Sie, dass beim Entfernen des Browser-Caches immer der gesamte Cache entfernt wird und diese Option ignoriert wird. Wenn die since-Eigenschaft weggelassen wird, ist der Standardwert 0, was "für immer" bedeutet.

Browser-Kompatibilität

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