browsingData.removeCookies()

Limpa os cookies do navegador.

Você pode usar o parâmetro removalOptions, em que é um objeto browsingData.RemovalOptions (en-US), para:

  • limpar apenas os cookies criados em determinado tempo.
  • controlar se limpar os cookies apenas de uma página web normal ou limpa os cookies de um app e extensões hospedados.

Esta é uma função assíncrona que retorna uma Promise.

Sintaxe

js
let removing = browser.browsingData.removeCookies(
  removalOptions, // objeto RemovalOptions
);

Parâmetros

removalOptions

object. Um objeto browsingData.RemovalOptions (en-US), que pode ser usado para limpar apenas cookies criados depois de determinado tempo, e limpa os cookies apenas de uma página web normal ou limpa os cookies de apps e extensões hospedados.

Valor retornado

Uma Promise que será realizada sem argumentos quando a remoção for finalizada. Se ocorrer qualquer erro, a promise será rejeitada com uma mensagem de erro.

Exemplos

Remove cookies criados na última semana:

js
function onRemoved() {
  console.log("removido");
}

function onError(error) {
  console.error(error);
}

function weekInMilliseconds() {
  return 1000 * 60 * 60 * 24 * 7;
}

let oneWeekAgo = new Date().getTime() - weekInMilliseconds();

browser.browsingData
  .removeCookies({ since: oneWeekAgo })
  .then(onRemoved, onError);

Remove todos os cookies:

Warning: Usar a API para remover todos os cookies irá, simultâneamente, limpar todos os objetos local storage (incluindo aqueles de outras extensões)

Se você quer limpar todos os cookies sem alterar as informações do local storage, use browser.cookies para percorrer and remover os conteúdos de todos os cookies armazenados

js
function onRemoved() {
  console.log("removido");
}

function onError(error) {
  console.error(error);
}

browser.browsingData.removeCookies({}).then(onRemoved, onError);

Compatibilidade com navegadores

BCD tables only load in the browser

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

A compatibilidade dos dados do Microsoft Edge é fornecida pela Microsoft Corporation e é incluída aqui sob a licença Creative Commons Attribution 3.0 United States.