Deze pagina is vertaald door de Cloud Translation API.

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

Belangrijk: aangezien cookies een breder bereik hebben dan andere soorten opslag, worden bij het verwijderen van cookies voor een oorsprong alle cookies van het registreerbare domein verwijderd. Als u bijvoorbeeld gegevens voor https://www.example.com verwijdert, worden ook cookies met het domein .example.com verwijderd.

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

Waarschuwing: wees voorzichtig met de oorsprongstypen protectedWeb en extension . Dit zijn destructieve bewerkingen die uw gebruikers kunnen verrassen als ze niet goed geïnformeerd zijn over wat ze kunnen verwachten als uw extensie namens hen gegevens verwijdert.

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

opties
Verwijderingsopties
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

opties
Verwijderingsopties
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

opties
Verwijderingsopties
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

opties
Verwijderingsopties
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

opties
Verwijderingsopties
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

opties
Verwijderingsopties
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

opties
Verwijderingsopties
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

opties
Verwijderingsopties
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

opties
Verwijderingsopties
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

opties
Verwijderingsopties
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

opties
Verwijderingsopties
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

opties
Verwijderingsopties
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

opties
Verwijderingsopties
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

opties
Verwijderingsopties
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

opties
Verwijderingsopties
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 .
  - opties
    Verwijderingsopties

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.