browsingData.removeHistory()

Limpa o histórico de páginas web que o usuário vistou (histórico de navegação)

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

  • limpar apenas os registros de páginas visitadas em determinado período.
  • controlar se limpa os registros apenas de uma página web normal ou se limpa os registros de um app e extensões hospedados.

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

Sintaxe

js
let removing = browser.browsingData.removeHistory(
  removalOptions            // objeto RemovalOptions
)

Parâmetros

removalOptions

object. Um objeto browsingData.RemovalOptions, que pode ser usado para limpar apenas os registros de páginas web visitadas após determinado tempo, e limpa os registros apenas de uma página web normal ou limpa os registros 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 registros de páginas visitadas 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
  .removeHistory({ since: oneWeekAgo })
  .then(onRemoved, onError);

Remove todos os registos de páginas visitadas:

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

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

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

Compatibilidade entre navegadores

BCD tables only load in the browser

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