chrome.browsingData

refresh date: 2026-09-25 robots: noindex

Descrizione

Utilizza l'API chrome.browsingData per rimuovere i dati di navigazione dal profilo locale di un utente.

Autorizzazioni

browsingData

Manifest

Per utilizzare questa API, devi dichiarare l'autorizzazione "browsingData" nel manifest dell'estensione.

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

Utilizzo

Il caso d'uso più semplice per questa API è un meccanismo basato sul tempo per cancellare i dati di navigazione di un utente. Il codice deve fornire un timestamp che indichi la data storica dopo la quale i dati di navigazione dell'utente devono essere rimossi. Questo timestamp è formattato come il numero di millisecondi dall'epoca di Unix (che può essere recuperato da un oggetto JavaScript Date tramite il metodo getTime).

Ad esempio, per cancellare tutti i dati di navigazione di un utente dell'ultima settimana, puoi scrivere il codice come segue:

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

Il metodo chrome.browsingData.remove ti consente di rimuovere vari tipi di dati di navigazione con una singola chiamata e sarà molto più veloce rispetto alla chiamata di più metodi più specifici. Tuttavia, se vuoi cancellare solo un tipo specifico di dati di navigazione (ad esempio i cookie), i metodi più granulari offrono un'alternativa leggibile a una chiamata piena di 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 l'utente sincronizza i propri dati, chrome.browsingData.remove potrebbe ricreare automaticamente il cookie per l'account di sincronizzazione dopo averlo cancellato. In questo modo, la sincronizzazione può continuare a funzionare e i dati possono essere eliminati sul server. Tuttavia, l'attributo più specifico chrome.browsingData.removeCookies può essere utilizzato per cancellare il cookie per l'account di sincronizzazione e, in questo caso, la sincronizzazione verrà messa in pausa.

Origini specifiche

Per rimuovere i dati per un'origine specifica o per escludere un insieme di origini dall'eliminazione, puoi utilizzare i parametri RemovalOptions.origins e RemovalOptions.excludeOrigins. Possono essere applicate solo a cookie, cache e spazio di archiviazione (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);

Tipi di origine

L'aggiunta di una proprietà originTypes all'oggetto options dell'API consente di specificare i tipi di origini che devono essere interessati. Al momento, le origini sono suddivise in tre categorie:

  • unprotectedWeb copre il caso generale dei siti web che gli utenti visitano senza intraprendere alcuna azione speciale. Se non specifichi un originTypes, l'API rimuove per impostazione predefinita i dati dalle origini web non protette.
  • protectedWeb copre le origini web che sono state installate come applicazioni in hosting. Ad esempio, l'installazione di Angry Birds protegge l'origine https://chrome.angrybirds.com e la rimuove dalla categoria unprotectedWeb. Fai attenzione quando attivi l'eliminazione dei dati per queste origini: assicurati che gli utenti sappiano cosa stanno facendo, poiché i loro dati di gioco verranno rimossi irrevocabilmente. Nessuno vuole abbattere le casette dei maialini più spesso del necessario.
  • extension copre le origini nello schema chrome-extensions:. Anche la rimozione dei dati delle estensioni è un'operazione da eseguire con molta attenzione.

Potremmo modificare l'esempio precedente per rimuovere solo i dati dai siti web protetti nel seguente modo:

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

Esempi

Per provare questa API, installa l'esempio di API browsingData dal repository chrome-extension-samples.

Tipi

DataTypeSet

Un insieme di tipi di dati. I tipi di dati mancanti vengono interpretati come false.

Proprietà

  • appcache

    boolean facoltativo

    Ritirato da Chrome 152

    Il supporto per appcache è stato rimosso. Questo tipo di dati verrà ignorato.

    Appcache dei siti web.

  • cache

    boolean facoltativo

    La cache del browser.

  • cacheStorage

    boolean facoltativo

    Chrome 72 e versioni successive

    Spazio di archiviazione cache

  • cookie

    boolean facoltativo

    I cookie del browser.

  • download

    boolean facoltativo

    L'elenco dei download del browser.

  • fileSystems

    boolean facoltativo

    File system dei siti web.

  • formData

    boolean facoltativo

    I dati dei moduli memorizzati nel browser.

  • storia

    boolean facoltativo

    La cronologia del browser.

  • indexedDB

    boolean facoltativo

    Dati IndexedDB dei siti web.

  • localStorage

    boolean facoltativo

    Dati di archiviazione locale dei siti web.

  • password

    boolean facoltativo

    Ritirato da Chrome 144

    Il supporto per l'eliminazione delle password tramite estensioni è stato rimosso. Questo tipo di dati verrà ignorato.

    Password memorizzate.

  • pluginData

    boolean facoltativo

    Ritirato da Chrome 88

    Il supporto di Flash è stato rimosso. Questo tipo di dati verrà ignorato.

    Dati dei plug-in.

  • serverBoundCertificates

    boolean facoltativo

    Ritirato da Chrome 76

    Il supporto dei certificati associati al server è stato rimosso. Questo tipo di dati verrà ignorato.

    Certificati associati al server.

  • serviceWorkers

    boolean facoltativo

    Service worker.

  • webSQL

    boolean facoltativo

    Ritirato da Chrome 152

    Il supporto per WebSQL è stato rimosso. Questo tipo di dati verrà ignorato.

    Dati WebSQL dei siti web.

RemovalOptions

Opzioni che determinano esattamente quali dati verranno rimossi.

Proprietà

  • excludeOrigins

    string[] facoltativo

    Chrome 74 e versioni successive

    Se presenti, i dati delle origini in questo elenco vengono esclusi dall'eliminazione. Non può essere utilizzato insieme a origins. Supportato solo per cookie, spazio di archiviazione e cache. I cookie sono esclusi per l'intero dominio registrabile.

  • originTypes

    object facoltativo

    Un oggetto le cui proprietà specificano i tipi di origine da cancellare. Se questo oggetto non è specificato, per impostazione predefinita vengono cancellate solo le origini "non protette". Assicurati di voler davvero rimuovere i dati dell'applicazione prima di aggiungere "protectedWeb" o "extensions".

    • estensione

      boolean facoltativo

      Estensioni e applicazioni pacchettizzate installate da un utente (fai _molta_ attenzione).

    • protectedWeb

      boolean facoltativo

      Siti web installati come applicazioni in hosting (fai attenzione).

    • unprotectedWeb

      boolean facoltativo

      Siti web normali.

  • origins

    [string, …string[]] facoltativo

    Chrome 74 e versioni successive

    Se presente, vengono eliminati solo i dati relativi alle origini in questo elenco. Supportato solo per cookie, spazio di archiviazione e cache. I cookie vengono cancellati per l'intero dominio registrabile.

  • da

    number optional

    Rimuovi i dati accumulati a partire da questa data, rappresentata in millisecondi dall'epoca (accessibile tramite il metodo getTime dell'oggetto JavaScript Date). Se non è presente, il valore predefinito è 0 (che rimuove tutti i dati di navigazione).

Metodi

remove()

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

Cancella vari tipi di dati di navigazione memorizzati nel profilo di un utente.

Parametri

  • opzioni

    RemovalOptions

  • dataToRemove

    DataTypeSet

    L'insieme di tipi di dati da rimuovere.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Viene risolta al termine dell'eliminazione.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

removeAppcache()

Promise Ritirato da Chrome 152
chrome.browsingData.removeAppcache(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Il supporto per appcache è stato rimosso. Questa funzione non ha alcun effetto.

Cancella i dati della cache dell'app dei siti web.

Parametri

  • opzioni

    RemovalOptions

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Si risolve quando i dati della cache dell'app dei siti web vengono cancellati.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

removeCache()

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

Svuota la cache del browser.

Parametri

  • opzioni

    RemovalOptions

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Si risolve quando la cache del browser viene svuotata.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

removeCacheStorage()

Promise Chrome 72 e versioni successive 
chrome.browsingData.removeCacheStorage(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Cancella i dati di archiviazione della cache dei siti web.

Parametri

  • opzioni

    RemovalOptions

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Si risolve quando lo spazio di archiviazione della cache dei siti web viene svuotato.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

removeCookies()

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

Cancella i cookie del browser e i certificati associati al server modificati entro un determinato periodo di tempo.

Parametri

  • opzioni

    RemovalOptions

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Si risolve quando i cookie del browser e i certificati associati al server vengono cancellati.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

removeDownloads()

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

Cancella l'elenco dei file scaricati del browser (non i file scaricati stessi).

Parametri

  • opzioni

    RemovalOptions

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Si risolve quando l'elenco dei file scaricati del browser viene cancellato.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

removeFileSystems()

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

Cancella i dati del file system dei siti web.

Parametri

  • opzioni

    RemovalOptions

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Si risolve quando i file system dei siti web vengono cancellati.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

removeFormData()

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

Cancella i dati dei moduli memorizzati nel browser (compilazione automatica).

Parametri

  • opzioni

    RemovalOptions

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Si risolve quando i dati dei moduli del browser sono stati cancellati.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

removeHistory()

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

Cancella la cronologia del browser.

Parametri

  • opzioni

    RemovalOptions

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Si risolve quando la cronologia del browser viene cancellata.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

removeIndexedDB()

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

Cancella i dati IndexedDB dei siti web.

Parametri

  • opzioni

    RemovalOptions

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Si risolve quando i dati IndexedDB dei siti web vengono cancellati.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

removeLocalStorage()

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

Cancella i dati di archiviazione locale dei siti web.

Parametri

  • opzioni

    RemovalOptions

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Si risolve quando lo spazio di archiviazione locale dei siti web viene cancellato.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

removePasswords()

Promise Ritirato da Chrome 144
chrome.browsingData.removePasswords(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Il supporto per l'eliminazione delle password tramite estensioni è stato rimosso. Questa funzione non ha alcun effetto.

Cancella le password memorizzate nel browser.

Parametri

  • opzioni

    RemovalOptions

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Si risolve quando le password del browser sono state cancellate.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

removePluginData()

Promise Ritirato da Chrome 88
chrome.browsingData.removePluginData(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Il supporto di Flash è stato rimosso. Questa funzione non ha alcun effetto.

Cancella i dati dei plug-in.

Parametri

  • opzioni

    RemovalOptions

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Si risolve quando i dati dei plug-in sono stati cancellati.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

removeServiceWorkers()

Promise Chrome 72 e versioni successive 
chrome.browsingData.removeServiceWorkers(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Cancella i service worker dei siti web.

Parametri

  • opzioni

    RemovalOptions

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Si risolve quando i service worker dei siti web sono stati cancellati.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

removeWebSQL()

Promise Ritirato da Chrome 152
chrome.browsingData.removeWebSQL(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Il supporto per WebSQL è stato rimosso. Questa funzione non ha alcun effetto.

Cancella i dati WebSQL dei siti web.

Parametri

  • opzioni

    RemovalOptions

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Si risolve quando i database WebSQL dei siti web sono stati cancellati.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

settings()

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

Segnala i tipi di dati attualmente selezionati nella UI delle impostazioni "Cancella dati di navigazione". Nota: alcuni dei tipi di dati inclusi in questa API non sono disponibili nell'interfaccia utente delle impostazioni e alcune impostazioni dell'interfaccia utente controllano più di un tipo di dati elencato qui.

Parametri

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (result: object) => void

    • risultato

      oggetto

      • dataRemovalPermitted

        DataTypeSet

        Tutti i tipi saranno presenti nel risultato, con valori di true se è consentito rimuoverli (ad esempio, in base alle policy aziendali) e false in caso contrario.

      • dataToRemove

        DataTypeSet

        Tutti i tipi saranno presenti nel risultato, con valori true se sono selezionati per la rimozione e se la rimozione è consentita, altrimenti false.

      • opzioni

        RemovalOptions

Resi

  • Promise<object>

    Chrome 96 e versioni successive

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.