Habilita extensões a limpar os dados que estão acumulados enquando o usuário navega.

Na API browsingData, os dados de navegação são divididos em tipos:

  • cache do browser
  • cookies
  • downloads
  • histórico
  • armazenamento local
  • dados de plugin
  • dados de formulários salvos
  • senhas salvas

Você pode usar a função browsingData.remove() para remover qualquer combinação desses tipos. Há também funções específicas para remover cada tipo de data em particular, como por exemplo removePasswords(), removeHistory() e assim por diante.

Todas funções browsingData.remove[X]() pegam o objeto browsingData.RemovalOptions que você usa para controlar outros dois aspectos da remoção de dados:

  • quão antigos são os dados para a remoção
  • se é para remover dados de páginas normais, ou também para hospedar aplicativos web ou add-ons. Observe que esta opção ainda não é suportada no Firefox.

Finalmente, a API browsingData.settings() fornece uma função que retorna o atual valor das configurações da funcionalidade "Limpar Histórico".

Para usar esta API você deve ter a permissão de API "browsingData".

Tipos

browsingData.DataTypeSet
Objeto usado para especificar o tipo de dado para remoção: por exemplo, histórico, downloads, senhas e assim por diante.
browsingData.RemovalOptions
Objeto usado para especificar o quanto tempo para remoção de dados, e se remover dados adicionados em uma navegação web normal, por aplicativos hospedados ou por add-ons.

Methods

browsingData.remove()
Remove os dados de navegação especificado pelo seu tipo.
browsingData.removeCache()
Limpa o cache do navegador.
browsingData.removeCookies()
Remove os cookies.
browsingData.removeDownloads()
Remove a lista de arquivos baixados.
browsingData.removeFormData()
Limpa os dados de um formulário salvo.
browsingData.removeHistory()
Limpa o histórico do navegador.
browsingData.removeLocalStorage()
Limpa qualquer local storage criado por websites.
browsingData.removePasswords()
Limpa passwords salvos.
browsingData.removePluginData()
Limpa os dados associados com plugins.
browsingData.settings()
Obtém o valor atual de configuração da funcionalidade "Limpar Histórico" do navegador.

Compatibilidade de browser

ChromeEdgeFirefoxFirefox for AndroidOpera
DataTypeSet.cache Yes No5356 Yes
DataTypeSet.cookies Yes No5356 Yes
DataTypeSet.downloads Yes No5356 Yes
DataTypeSet.fileSystems Yes No No No Yes
DataTypeSet.formData Yes No5356 Yes
DataTypeSet.history Yes No5356 Yes
DataTypeSet.indexedDB Yes No57 No Yes
DataTypeSet.localStorage Yes No57 No Yes
DataTypeSet.passwords Yes No53 No Yes
DataTypeSet.pluginData Yes No53 No Yes
DataTypeSet.serverBoundCertificates Yes No No No Yes
DataTypeSet.serviceWorkers Yes No53 No Yes
RemovalOptions.hostnames No No56 No No
RemovalOptions.originTypes Yes No No No Yes
RemovalOptions.since Yes No531561 Yes
remove Yes No532572 Yes
removeCache Yes No533573 Yes
removeCookies Yes No5356 Yes
removeDownloads Yes No5357 Yes
removeFormData Yes No5357 Yes
removeHistory Yes No534 No5 Yes
removeLocalStorage Yes No573 No6 Yes
removePasswords Yes No53 No7 Yes
removePluginData Yes No53 No Yes
settings Yes No5356 Yes

1. since is not supported with the following data types: cache, indexedDB, localStorage, and serviceWorkers.

2. Specifying dataTypes.history will also remove download history and service workers.

3. removalOptions.since is not supported.

4. This function also removes download history and service workers.

5. See bug 1363010. browser.history.remove(options, {history:true}) can be used instead.

6. The method is defined but returns a rejected promise.

7. See bug 1363012.

Example extensions

Agradecimentos

Esta API é baseada na API chrome.browsingData do Chromium.

Os dados de compatibilidade do Microsoft Edge compatibility são fornecidos pela Microsoft Corporation e aqui estão inclusos sob a Creative Commons Attribution 3.0 United States License.

Etiquetas do documento e colaboradores

Colaboradores desta página: thiagopelizoni
Última atualização por: thiagopelizoni,