chrome.browsingData

Descrição

Permissões

Você precisa declarar a permissão "browsingData" no manifesto da extensão para usar essa API.

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

Conceitos e uso

O caso de uso mais simples para essa API é um mecanismo baseado em tempo para limpar os dados de navegação de um usuário. Seu código precisa fornecer um carimbo de data/hora que indique a data histórica após a qual os dados de navegação do usuário devem ser removidos. Esse carimbo de data/hora é formatado como o número de milissegundos desde a época do Unix, que pode ser recuperado de um objeto Date do JavaScript usando o método getTime().

Por exemplo, para limpar todos os dados de navegação de um usuário da última semana, você pode escrever um código da seguinte forma:

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

O método chrome.browsingData.remove() permite remover vários tipos de dados de navegação com uma única chamada e é muito mais rápido do que chamar vários métodos mais específicos. No entanto, se você quiser limpar apenas um tipo específico de dados de navegação (cookies, por exemplo), os métodos mais granulares oferecem uma alternativa legível a uma chamada preenchida com 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); 

Se o usuário estiver sincronizando os dados, o chrome.browsingData.remove() poderá recriar automaticamente o cookie para a conta de sincronização depois que ele for limpo. Isso garante que a Sincronização continue funcionando para que os dados possam ser excluídos do servidor. No entanto, o chrome.browsingData.removeCookies() mais específico pode ser usado para limpar o cookie da conta do Google Sincronização, e a Sincronização será pausada nesse caso.

Origens específicas

Para remover dados de uma origem específica ou excluir um conjunto de origens da exclusão, use os parâmetros RemovalOptions.origins e RemovalOptions.excludeOrigins. Elas só podem ser aplicadas a cookies, cache e armazenamento (CacheStorage, FileSystems, IndexedDB, LocalStorage, ServiceWorkers e WebSQL).

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

Tipos de origem

Ao adicionar uma propriedade originTypes ao objeto de opções das APIs, é possível especificar quais tipos de origens devem ser afetados. As origens são divididas em três categorias:

• unprotectedWeb abrange o caso geral de sites que os usuários visitam sem realizar nenhuma ação especial. Se você não especificar um originTypes, a API vai remover dados de origens da Web não protegidas por padrão.
• O protectedWeb abrange as origens da Web que foram instaladas como aplicativos hospedados. Por exemplo, a instalação de Angry Birds protege a origem https://chrome.angrybirds.com e a remove da categoria unprotectedWeb. Tenha cuidado ao acionar a exclusão de dados dessas origens: verifique se os usuários sabem o que vão receber, já que isso vai remover irrevogavelmente os dados do jogo. Ninguém quer derrubar casinhas de porcos minúsculas mais vezes do que o necessário.
• extension abrange origens no esquema chrome-extensions:. Remover dados de extensão é algo que você precisa fazer com muito cuidado.

Podemos ajustar o exemplo anterior para remover apenas dados de sites protegidos da seguinte maneira:

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

Exemplos

Para testar essa API, instale o exemplo da API browsingData do repositório chrome-extension-samples.

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>