chrome.browsingData

Beschreibung

Berechtigungen

Sie müssen die Berechtigung "browsingData" im Erweiterungsmanifest deklarieren, um diese API zu verwenden.

{
  "name": "My extension",
  ...
  "permissions": [
    "browsingData",
  ],
  ...
}

Konzepte und Verwendung

Der einfachste Anwendungsfall für diese API ist ein zeitbasierter Mechanismus zum Löschen der Browserdaten eines Nutzers. Ihr Code sollte einen Zeitstempel enthalten, der das Datum angibt, nach dem die Browserdaten des Nutzers entfernt werden sollen. Dieser Zeitstempel wird als Anzahl der Millisekunden seit der Unix-Epoche formatiert. Er kann aus einem JavaScript-Date-Objekt mit der Methode getTime() abgerufen werden.

Wenn Sie beispielsweise alle Browserdaten eines Nutzers aus der letzten Woche löschen möchten, können Sie folgenden Code schreiben:

var callback = function () {
  // Do something clever here once data has been removed.
};

var millisecondsPerWeek = 1000 * 60 * 60 * 24 * 7;
var oneWeekAgo = (new Date()).getTime() - millisecondsPerWeek;
chrome.browsingData.remove({
  "since": oneWeekAgo
}, {
  "appcache": true,
  "cache": true,
  "cacheStorage": true,
  "cookies": true,
  "downloads": true,
  "fileSystems": true,
  "formData": true,
  "history": true,
  "indexedDB": true,
  "localStorage": true,
  "passwords": true,
  "serviceWorkers": true,
  "webSQL": true
}, callback);

Mit der Methode chrome.browsingData.remove() können Sie verschiedene Arten von Browserdaten mit einem einzigen Aufruf entfernen. Das ist viel schneller als der Aufruf mehrerer spezifischerer Methoden. Wenn Sie jedoch nur einen bestimmten Typ von Browserdaten löschen möchten (z. B. Cookies), bieten die detaillierteren Methoden eine lesbare Alternative zu einem mit JSON gefüllten Aufruf.

var callback = function () {
  // Do something clever here once data has been removed.
};

var millisecondsPerWeek = 1000 * 60 * 60 * 24 * 7;
var oneWeekAgo = (new Date()).getTime() - millisecondsPerWeek;
chrome.browsingData.removeCookies({
  "since": oneWeekAgo
}, callback);

Wenn der Nutzer seine Daten synchronisiert, kann chrome.browsingData.remove() das Cookie für das Synchronisierungskonto nach dem Löschen automatisch neu erstellen. So soll sichergestellt werden, dass die Synchronisierung weiterhin funktioniert und die Daten schließlich auf dem Server gelöscht werden können. Mit dem spezifischeren chrome.browsingData.removeCookies() kann jedoch der Cookie für das Synchronisierungskonto gelöscht werden. In diesem Fall wird die Synchronisierung pausiert.

Bestimmte Ursprünge

Wenn Sie Daten für einen bestimmten Ursprung entfernen oder eine Reihe von Ursprüngen vom Löschen ausschließen möchten, können Sie die Parameter RemovalOptions.origins und RemovalOptions.excludeOrigins verwenden. Sie können nur auf Cookies, Cache und Speicher (CacheStorage, FileSystems, IndexedDB, LocalStorage, ServiceWorkers und WebSQL) angewendet werden.

chrome.browsingData.remove({
  "origins": ["https://www.example.com"]
}, {
  "cacheStorage": true,
  "cookies": true,
  "fileSystems": true,
  "indexedDB": true,
  "localStorage": true,
  "serviceWorkers": true,
  "webSQL": true
}, callback);

Ursprungstypen

Wenn Sie dem API-Optionenobjekt ein originTypes-Attribut hinzufügen, können Sie angeben, welche Arten von Ursprüngen betroffen sein sollen. Die Herkunft wird in drei Kategorien unterteilt:

• unprotectedWeb deckt den allgemeinen Fall von Websites ab, die Nutzer besuchen, ohne dass sie eine spezielle Aktion ausführen. Wenn Sie keine originTypes angeben, werden standardmäßig Daten aus nicht geschützten Web-Origins entfernt.
• protectedWeb umfasst die Webursprünge, die als gehostete Anwendungen installiert wurden. Wenn Sie beispielsweise Angry Birds installieren, wird der Ursprung https://chrome.angrybirds.com geschützt und aus der Kategorie unprotectedWeb entfernt. Sei vorsichtig, wenn du das Löschen von Daten für diese Ursprünge auslöst. Informiere deine Nutzer darüber, dass ihre Spieldaten dadurch unwiderruflich entfernt werden. Niemand möchte kleine Häuser von Schweinen öfter als nötig umwerfen.
• extension deckt Ursprünge unter dem chrome-extensions:-Schema ab. Das Entfernen von Erweiterungsdaten sollte mit großer Vorsicht erfolgen.

Wir können das vorherige Beispiel so anpassen, dass nur Daten von geschützten Websites entfernt werden:

var callback = function () {
  // Do something clever here once data has been removed.
};

var millisecondsPerWeek = 1000 * 60 * 60 * 24 * 7;
var oneWeekAgo = (new Date()).getTime() - millisecondsPerWeek;
chrome.browsingData.remove({
  "since": oneWeekAgo,
  "originTypes": {
    "protectedWeb": true
  }
}, {
  "appcache": true,
  "cache": true,
  "cacheStorage": true,
  "cookies": true,
  "downloads": true,
  "fileSystems": true,
  "formData": true,
  "history": true,
  "indexedDB": true,
  "localStorage": true,
  "passwords": true,
  "serviceWorkers": true,
  "webSQL": true
}, callback);

Beispiele

Wenn Sie diese API ausprobieren möchten, installieren Sie das browsingData API-Beispiel aus dem Repository chrome-extension-samples.

chrome.browsingData.remove(
  options: RemovalOptions,
  dataToRemove: DataTypeSet,
): Promise<void>

chrome.browsingData.removeAppcache(
  options: RemovalOptions,
): Promise<void>

chrome.browsingData.removeCache(
  options: RemovalOptions,
): Promise<void>

chrome.browsingData.removeCacheStorage(
  options: RemovalOptions,
): Promise<void>

chrome.browsingData.removeCookies(
  options: RemovalOptions,
): Promise<void>

chrome.browsingData.removeDownloads(
  options: RemovalOptions,
): Promise<void>

chrome.browsingData.removeFileSystems(
  options: RemovalOptions,
): Promise<void>

chrome.browsingData.removeFormData(
  options: RemovalOptions,
): Promise<void>

chrome.browsingData.removeHistory(
  options: RemovalOptions,
): Promise<void>

chrome.browsingData.removeIndexedDB(
  options: RemovalOptions,
): Promise<void>

chrome.browsingData.removeLocalStorage(
  options: RemovalOptions,
): Promise<void>

chrome.browsingData.removePasswords(
  options: RemovalOptions,
): Promise<void>

chrome.browsingData.removePluginData(
  options: RemovalOptions,
): Promise<void>

chrome.browsingData.removeServiceWorkers(
  options: RemovalOptions,
): Promise<void>

chrome.browsingData.removeWebSQL(
  options: RemovalOptions,
): Promise<void>

chrome.browsingData.settings(): Promise<object>