chrome.browsingData

refresh date: 2026-09-25 robots: noindex

Descrição

Use a API chrome.browsingData para remover dados de navegação do perfil local de um usuário.

Permissões

browsingData

Manifesto

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

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

Uso

O caso de uso mais simples dessa 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 recuperada de um objeto JavaScript Date 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 como este:

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 de limpar o cookie. 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

Adicionar uma propriedade originTypes ao objeto de opções da API permite especificar quais tipos de origens devem ser afetados. No momento, 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.
  • 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: informe aos usuários o que eles vão receber, já que isso vai remover de forma irrevogável os dados do jogo. Ninguém quer derrubar casinhas de porcos 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 (link em inglês).

Tipos

DataTypeSet

Um conjunto de tipos de dados. Os tipos de dados ausentes são interpretados como false.

Propriedades

  • appcache

    booleano opcional

    Descontinuado desde o Chrome 152

    O suporte para appcache foi removido. Esse tipo de dado será ignorado.

    Appcaches de sites.

  • cache

    booleano opcional

    O cache do navegador.

  • cacheStorage

    booleano opcional

    Chrome 72 ou mais recente

    Armazenamento em cache

  • cookies

    booleano opcional

    Os cookies do navegador.

  • downloads

    booleano opcional

    A lista de downloads do navegador.

  • fileSystems

    booleano opcional

    Sistemas de arquivos de sites.

  • formData

    booleano opcional

    Os dados de formulário armazenados pelo navegador.

  • histórico

    booleano opcional

    O histórico do navegador.

  • indexedDB

    booleano opcional

    Dados do IndexedDB dos sites.

  • localStorage

    booleano opcional

    Dados de armazenamento local dos sites.

  • senhas

    booleano opcional

    Descontinuado desde o Chrome 144

    O suporte à exclusão de senhas por extensões foi removido. Esse tipo de dado será ignorado.

    Senhas armazenadas.

  • pluginData

    booleano opcional

    Descontinuado desde o Chrome 88

    O suporte para Flash foi removido. Esse tipo de dado será ignorado.

    Dados de plug-ins.

  • serverBoundCertificates

    booleano opcional

    Descontinuado desde o Chrome 76

    O suporte para certificados vinculados ao servidor foi removido. Esse tipo de dado será ignorado.

    Certificados vinculados ao servidor.

  • serviceWorkers

    booleano opcional

    Service workers.

  • webSQL

    booleano opcional

    Descontinuado desde o Chrome 152

    O suporte para WebSQL foi removido. Esse tipo de dado será ignorado.

    Dados WebSQL de sites.

RemovalOptions

Opções que determinam exatamente quais dados serão removidos.

Propriedades

  • excludeOrigins

    string[] opcional

    Chrome 74 ou mais recente

    Quando presente, os dados de origens nessa lista são excluídos da exclusão. Não pode ser usado com origins. Compatível apenas com cookies, armazenamento e cache. Os cookies são excluídos de todo o domínio registrável.

  • originTypes

    objeto opcional

    Um objeto cujas propriedades especificam quais tipos de origem precisam ser limpos. Se esse objeto não for especificado, o padrão será limpar apenas origens "não protegidas". Confirme se você realmente quer remover os dados do aplicativo antes de adicionar "protectedWeb" ou "extensions".

    • extensão

      booleano opcional

      Extensões e aplicativos empacotados instalados por um usuário (tome _muito_ cuidado!).

    • protectedWeb

      booleano opcional

      Sites instalados como aplicativos hospedados (tome cuidado!).

    • unprotectedWeb

      booleano opcional

      Sites normais.

  • origens

    [string, ...string[]] opcional

    Chrome 74 ou mais recente

    Quando presente, somente os dados das origens nessa lista são excluídos. Compatível apenas com cookies, armazenamento e cache. Os cookies são apagados de todo o domínio registrável.

  • desde

    número optional

    Remove os dados acumulados na data ou após ela, representados em milissegundos desde o período (acessíveis pelo método getTime do objeto JavaScript Date). Se estiver ausente, o padrão será 0, o que remove todos os dados de navegação.

Métodos

remove()

Promessa 
chrome.browsingData.remove(
  options: RemovalOptions,
  dataToRemove: DataTypeSet,
  callback?: function,
): Promise<void>

Limpa vários tipos de dados de navegação armazenados no perfil de um usuário.

Parâmetros

  • opções

    RemovalOptions

  • dataToRemove

    DataTypeSet

    O conjunto de tipos de dados a serem removidos.

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou mais recente

    É resolvida quando a exclusão é concluída.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

removeAppcache()

Promise Descontinuado desde o Chrome 152
chrome.browsingData.removeAppcache(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

O suporte para appcache foi removido. Essa função não tem efeito.

Limpa os dados do appcache dos sites.

Parâmetros

  • opções

    RemovalOptions

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou mais recente

    Resolvido quando os dados do appcache dos sites são limpos.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

removeCache()

Promessa 
chrome.browsingData.removeCache(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Limpa o cache do navegador.

Parâmetros

  • opções

    RemovalOptions

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou mais recente

    Resolvido quando o cache do navegador é limpo.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

removeCacheStorage()

Promise Chrome 72 ou mais recente 
chrome.browsingData.removeCacheStorage(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Limpa os dados de armazenamento em cache dos sites.

Parâmetros

  • opções

    RemovalOptions

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou mais recente

    Resolvido quando o armazenamento em cache dos sites é limpo.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

removeCookies()

Promessa 
chrome.browsingData.removeCookies(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Limpa os cookies do navegador e os certificados vinculados ao servidor modificados em um período específico.

Parâmetros

  • opções

    RemovalOptions

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou mais recente

    É resolvida quando os cookies do navegador e os certificados vinculados ao servidor são limpos.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

removeDownloads()

Promessa 
chrome.browsingData.removeDownloads(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Limpa a lista de arquivos baixados do navegador, não os arquivos baixados em si.

Parâmetros

  • opções

    RemovalOptions

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou mais recente

    É resolvida quando a lista de arquivos baixados do navegador é limpa.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

removeFileSystems()

Promessa 
chrome.browsingData.removeFileSystems(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Limpa os dados do sistema de arquivos dos sites.

Parâmetros

  • opções

    RemovalOptions

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou mais recente

    É resolvida quando os sistemas de arquivos dos sites são limpos.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

removeFormData()

Promessa 
chrome.browsingData.removeFormData(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Limpa os dados de formulário armazenados no navegador (preenchimento automático).

Parâmetros

  • opções

    RemovalOptions

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou mais recente

    Resolvido quando os dados do formulário do navegador são limpos.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

removeHistory()

Promessa 
chrome.browsingData.removeHistory(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Limpa o histórico do navegador.

Parâmetros

  • opções

    RemovalOptions

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou mais recente

    É resolvida quando o histórico do navegador é limpo.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

removeIndexedDB()

Promessa 
chrome.browsingData.removeIndexedDB(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Limpa os dados do IndexedDB dos sites.

Parâmetros

  • opções

    RemovalOptions

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou mais recente

    Resolvido quando os dados IndexedDB dos sites são limpos.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

removeLocalStorage()

Promessa 
chrome.browsingData.removeLocalStorage(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Limpa os dados de armazenamento local dos sites.

Parâmetros

  • opções

    RemovalOptions

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou mais recente

    Resolvido quando o armazenamento local dos sites é limpo.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

removePasswords()

Promise Descontinuado desde o Chrome 144
chrome.browsingData.removePasswords(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

O suporte à exclusão de senhas por extensões foi removido. Essa função não tem efeito.

Limpa as senhas armazenadas no navegador.

Parâmetros

  • opções

    RemovalOptions

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou mais recente

    É resolvida quando as senhas do navegador são limpas.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

removePluginData()

Promise Descontinuado desde o Chrome 88
chrome.browsingData.removePluginData(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

O suporte para Flash foi removido. Essa função não tem efeito.

Limpa os dados dos plug-ins.

Parâmetros

  • opções

    RemovalOptions

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou mais recente

    Resolvido quando os dados dos plug-ins foram limpos.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

removeServiceWorkers()

Promise Chrome 72 ou mais recente 
chrome.browsingData.removeServiceWorkers(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Limpa os service workers dos sites.

Parâmetros

  • opções

    RemovalOptions

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou mais recente

    Resolvido quando os service workers dos sites são limpos.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

removeWebSQL()

Promise Descontinuado desde o Chrome 152
chrome.browsingData.removeWebSQL(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

O suporte para WebSQL foi removido. Essa função não tem efeito.

Limpa os dados WebSQL dos sites.

Parâmetros

  • opções

    RemovalOptions

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou mais recente

    Resolvido quando os bancos de dados WebSQL dos sites são limpos.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

settings()

Promessa 
chrome.browsingData.settings(
  callback?: function,
): Promise<object>

Informa quais tipos de dados estão selecionados na interface de configurações "Limpar dados de navegação". Observação: alguns dos tipos de dados incluídos nessa API não estão disponíveis na interface de configurações, e algumas configurações da interface controlam mais de um tipo de dado listado aqui.

Parâmetros

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (result: object) => void

    • resultado

      objeto

      • dataRemovalPermitted

        DataTypeSet

        Todos os tipos estarão presentes no resultado, com valores de true se puderem ser removidos (por exemplo, por uma política empresarial) e false se não puderem.

      • dataToRemove

        DataTypeSet

        Todos os tipos estarão presentes no resultado, com valores de true se ambos forem selecionados para remoção e permitidos para remoção. Caso contrário, false.

      • opções

        RemovalOptions

Retorna

  • Promise<object>

    Chrome 96 ou mais recente

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.