chrome.browsingData

Beschrijving

Machtigingen

U moet de machtiging "browsingData" in het extensiemanifest declareren om deze API te gebruiken.

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

Begrippen en gebruik

De eenvoudigste use-case voor deze API is een tijdgebaseerd mechanisme voor het wissen van de browsegegevens van een gebruiker. Uw code moet een tijdstempel bevatten die de historische datum aangeeft waarna de browsegegevens van de gebruiker moeten worden verwijderd. Deze tijdstempel wordt geformatteerd als het aantal milliseconden sinds het Unix-tijdperk (dat kan worden opgehaald uit een JavaScript Date object met behulp van de getTime() -methode).

Als u bijvoorbeeld alle browsegegevens van een gebruiker van de afgelopen week wilt wissen, kunt u de volgende code schrijven:

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

Met de methode chrome.browsingData.remove() kunt u verschillende soorten browsegegevens met één aanroep verwijderen. Dit is veel sneller dan het aanroepen van meerdere, meer specifieke methoden. Als u echter slechts één specifiek type browsegegevens wilt wissen (bijvoorbeeld cookies), bieden de meer gedetailleerde methoden een leesbaar alternatief voor een aanroep met JSON.

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

Als de gebruiker zijn gegevens synchroniseert, kan chrome.browsingData.remove() de cookie voor het Sync-account automatisch opnieuw opbouwen nadat deze is gewist. Dit is om ervoor te zorgen dat Sync kan blijven werken, zodat de gegevens uiteindelijk van de server kunnen worden verwijderd. De meer specifieke optie chrome.browsingData.removeCookies() kan echter worden gebruikt om de cookie voor het Sync-account te wissen, waardoor Sync in dat geval wordt gepauzeerd.

Specifieke oorsprongen

Om gegevens voor een specifieke oorsprong te verwijderen of een set oorsprongen uit te sluiten van verwijdering, kunt u de parameters RemovalOptions.origins en RemovalOptions.excludeOrigins gebruiken. Deze kunnen alleen worden toegepast op cookies, cache en opslag (CacheStorage, FileSystems, IndexedDB, LocalStorage, ServiceWorkers en WebSQL).

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

Oorsprongstypen

Door een originTypes eigenschap toe te voegen aan het API-optiesobject, kunt u specificeren welke typen oorsprongen moeten worden beïnvloed. Oorsprongen worden onderverdeeld in drie categorieën:

• unprotectedWeb is van toepassing op websites die gebruikers bezoeken zonder speciale actie te ondernemen. Als u geen originTypes opgeeft, verwijdert de API standaard gegevens van onbeschermde webbronnen.
• protectedWeb dekt de webbronnen die als gehoste applicaties zijn geïnstalleerd. Het installeren van Angry Birds beschermt bijvoorbeeld de bron https://chrome.angrybirds.com en verwijdert deze uit de categorie unprotectedWeb . Wees voorzichtig bij het verwijderen van gegevens voor deze bronnen: zorg ervoor dat uw gebruikers weten wat ze krijgen, want hiermee worden hun gamegegevens onherroepelijk verwijderd. Niemand wil vaker dan nodig kleine varkenshokjes omverwerpen.
• extension behandelt oorsprongen onder het chrome-extensions: schema. Het verwijderen van extensiegegevens is wederom iets waar je heel voorzichtig mee moet zijn.

We kunnen het vorige voorbeeld aanpassen om alleen gegevens van beveiligde websites te verwijderen, als volgt:

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

Voorbeelden

Om deze API uit te proberen, installeert u het API-voorbeeld browseData uit de chrome-extension-samples- repository.

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>