chrome.browsingData

Beschrijving

Gebruik de chrome.browsingData API om browsegegevens uit het lokale profiel van een gebruiker te verwijderen.

Machtigingen

browsingData

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

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

Concepten en 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 met behulp van 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 methode chrome.browsingData.remove() kunt u met één enkele aanroep verschillende soorten browsegegevens verwijderen. Deze methode is veel sneller 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. Het meer specifieke chrome.browsingData.removeCookies() kan echter worden gebruikt om de cookie voor het Sync-account te wissen, en in dit geval wordt de synchronisatie 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 soorten

Door een eigenschap originTypes aan het object APIs Options toe te voegen, kunt u opgeven welke typen oorsprong moeten worden uitgevoerd. Origins zijn 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, aangezien 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.

Soorten

DataTypeSet

Een set gegevenstypen. Ontbrekende gegevenstypen worden als false geïnterpreteerd.

Eigenschappen

  • app-cache

    Booleaans optioneel

    App-caches van websites.

  • cache

    Booleaans optioneel

    De cache van de browser.

  • cacheopslag

    Booleaans optioneel

    Chroom 72+

    Cache-opslag

  • koekjes

    Booleaans optioneel

    De cookies van de browser.

  • downloads

    Booleaans optioneel

    De downloadlijst van de browser.

  • bestandssystemen

    Booleaans optioneel

    Bestandssystemen van websites.

  • formulierGegevens

    Booleaans optioneel

    De opgeslagen formuliergegevens van de browser.

  • geschiedenis

    Booleaans optioneel

    De geschiedenis van de browser.

  • geïndexeerdeDB

    Booleaans optioneel

    GeïndexeerdeDB-gegevens van websites.

  • lokale opslag

    Booleaans optioneel

    Lokale opslaggegevens van websites.

  • wachtwoorden

    Booleaans optioneel

    Opgeslagen wachtwoorden.

  • plug-inGegevens

    Booleaans optioneel

    Verouderd sinds Chrome 88

    Ondersteuning voor Flash is verwijderd. Dit gegevenstype wordt genegeerd.

    Gegevens van plug-ins.

  • serverBoundCertificaten

    Booleaans optioneel

    Verouderd sinds Chrome 76

    Ondersteuning voor servergebonden certificaten is verwijderd. Dit gegevenstype wordt genegeerd.

    Servergebonden certificaten.

  • serviceWerknemers

    Booleaans optioneel

    Dienstverleners.

  • webSQL

    Booleaans optioneel

    WebSQL-gegevens van websites.

RemovalOptions

Opties die precies bepalen welke gegevens worden verwijderd.

Eigenschappen

  • oorsprong uitsluiten

    tekenreeks[] optioneel

    Chroom 74+

    Indien aanwezig, zijn gegevens over de herkomst in deze lijst uitgesloten van verwijdering. Kan niet samen met origins worden gebruikt. Alleen ondersteund voor cookies, opslag en cache. Cookies zijn uitgesloten voor het gehele registreerbare domein.

  • oorsprongTypen

    object optioneel

    Een object waarvan de eigenschappen specificeren welke oorsprongstypen moeten worden gewist. Als dit object niet is opgegeven, wordt standaard alleen de 'onbeveiligde' oorsprong gewist. Zorg ervoor dat u de applicatiegegevens echt wilt verwijderen voordat u 'protectedWeb' of 'extensions' toevoegt.

    • verlenging

      Booleaans optioneel

      Extensies en pakketapplicaties die een gebruiker heeft geïnstalleerd (wees _echt_ voorzichtig!).

    • beschermdWeb

      Booleaans optioneel

      Websites die zijn geïnstalleerd als gehoste applicatie (let op!).

    • onbeschermd web

      Booleaans optioneel

      Normale websites.

  • oorsprong

    [string, ...string[]] optioneel

    Chroom 74+

    Indien aanwezig worden alleen gegevens voor herkomsten in deze lijst verwijderd. Alleen ondersteund voor cookies, opslag en cache. Cookies worden gewist voor het hele registreerbare domein.

  • sinds

    nummer optioneel

    Verwijder gegevens die op of na deze datum zijn verzameld, weergegeven in milliseconden sinds het tijdperk (toegankelijk via de getTime methode van het JavaScript Date object). Indien afwezig, standaard ingesteld op 0 (waardoor alle browsegegevens worden verwijderd).

Methoden

remove()

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

Wist verschillende soorten browsegegevens die zijn opgeslagen in het profiel van een gebruiker.

Parameters

  • gegevensToRemove

    GegevensTypeSet

    De set gegevenstypen die moeten worden verwijderd.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

removeAppcache()

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

Wist de appcachegegevens van websites.

Parameters

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

removeCache()

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

Wist de cache van de browser.

Parameters

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

removeCacheStorage()

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

Wist de cacheopslaggegevens van websites.

Parameters

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

removeCookies()

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

Wist de cookies van de browser en servergebonden certificaten die binnen een bepaald tijdsbestek zijn gewijzigd.

Parameters

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

removeDownloads()

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

Wist de browserlijst met gedownloade bestanden ( niet de gedownloade bestanden zelf).

Parameters

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

removeFileSystems()

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

Wist de bestandssysteemgegevens van websites.

Parameters

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

removeFormData()

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

Wist de opgeslagen formuliergegevens van de browser (automatisch aanvullen).

Parameters

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

removeHistory()

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

Wist de geschiedenis van de browser.

Parameters

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

removeIndexedDB()

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

Wist de IndexedDB-gegevens van websites.

Parameters

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

removeLocalStorage()

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

Wist de lokale opslaggegevens van websites.

Parameters

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

removePasswords()

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

Wist de opgeslagen wachtwoorden van de browser.

Parameters

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

removePluginData()

Belofte Verouderd sinds Chrome 88
 
chrome.browsingData.removePluginData(
  options: RemovalOptions,
  callback?: function,
)

Ondersteuning voor Flash is verwijderd. Deze functie heeft geen effect.

Wist de gegevens van plug-ins.

Parameters

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

removeServiceWorkers()

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

Wist de servicemedewerkers van websites.

Parameters

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

removeWebSQL()

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

Wist de WebSQL-gegevens van websites.

Parameters

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

settings()

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

Rapporteert welke soorten gegevens momenteel zijn geselecteerd in de gebruikersinterface voor 'Browsegegevens wissen'. Opmerking: sommige gegevenstypen in deze API zijn niet beschikbaar in de instellingen-UI, en sommige UI-instellingen beheren meer dan één gegevenstype dat hier wordt vermeld.

Parameters

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: object) => void

    • resultaat

      voorwerp

      • gegevensVerwijderingToegestaan

        GegevensTypeSet

        Alle typen zullen aanwezig zijn in het resultaat, met de waarden true als ze mogen worden verwijderd (bijvoorbeeld door bedrijfsbeleid) en false als dat niet het geval is.

      • gegevensToRemove

        GegevensTypeSet

        Alle typen zijn aanwezig in het resultaat, met de waarden true als ze zowel zijn geselecteerd om te worden verwijderd als mogen worden verwijderd, en anders false .

Retouren

  • Beloof<object>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.