chrome.browsingData

Beschrijving

Machtigingen

Manifest

U moet de machtiging 'browsingData' opgeven in het extensiemanifest om deze API te kunnen gebruiken.

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

Gebruik

Het eenvoudigste gebruik van deze API is een op tijd gebaseerd 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 is opgemaakt als het aantal milliseconden sinds het Unix-tijdperk (dat kan worden opgehaald uit een JavaScript Date object via de getTime methode).

Als u bijvoorbeeld alle browsegegevens van een gebruiker van de afgelopen week wilt wissen, kunt u als volgt 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 chrome.browsingData.remove -methode kunt u verschillende soorten browsegegevens verwijderen met één enkele oproep, en dit zal veel sneller zijn dan het aanroepen van meerdere specifiekere methoden. Als u echter slechts één specifiek type browsergegevens (cookies bijvoorbeeld) wilt wissen, bieden de meer gedetailleerde methoden een leesbaar alternatief voor een oproep gevuld 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 synchronisatieaccount automatisch opnieuw opbouwen nadat deze is gewist. Dit is om ervoor te zorgen dat Sync kan blijven werken, zodat de gegevens uiteindelijk op de server kunnen worden verwijderd. De meer specifieke chrome.browsingData.removeCookies kunnen echter worden gebruikt om de cookie voor het Sync-account te wissen, en de synchronisatie wordt in dit geval onderbroken.

Specifieke oorsprong

Als u gegevens voor een specifieke oorsprong wilt verwijderen of een reeks oorsprongen wilt uitsluiten van verwijdering, kunt u de parameters RemovalOptions.origins en RemovalOptions.excludeOrigins gebruiken. Ze 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);

Oorsprong typen

Door een eigenschap originTypes aan het optieobject van de API toe te voegen, kunt u opgeven welke typen oorsprong moeten worden uitgevoerd. Momenteel zijn de oorsprongen onderverdeeld in drie categorieën:

• unprotectedWeb bestrijkt het algemene geval van websites die gebruikers bezoeken zonder speciale actie te ondernemen. Als u geen originTypes opgeeft, verwijdert de API standaard gegevens van onbeveiligde weboorsprongen.
• protectedWeb dekt de webbronnen die zijn geïnstalleerd als gehoste applicaties. Het installeren van Angry Birds beschermt bijvoorbeeld de oorsprong https://chrome.angrybirds.com en verwijdert deze uit de unprotectedWeb webcategorie. Wees voorzichtig bij het activeren van het verwijderen van gegevens voor deze bronnen: zorg ervoor dat uw gebruikers weten wat ze krijgen, omdat hierdoor hun gamegegevens onherroepelijk worden verwijderd. Niemand wil kleine varkensstallen vaker omver gooien dan nodig is.
• extension omvat oorsprong onder het chrome-extensions: schema. Het verwijderen van extensiegegevens is wederom iets waar u heel voorzichtig mee moet zijn.

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

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 te proberen, installeert u het browseData API-voorbeeld uit de chrome-extension-samples- repository.

chrome.browsingData.remove(
  options: RemovalOptions,
  dataToRemove: DataTypeSet,
  callback?: function,
)

chrome.browsingData.removeAppcache(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removeCache(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removeCacheStorage(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removeCookies(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removeDownloads(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removeFileSystems(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removeFormData(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removeHistory(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removeIndexedDB(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removeLocalStorage(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removePasswords(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removePluginData(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removeServiceWorkers(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removeWebSQL(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.settings(
  callback?: function,
)