Descrizione
Utilizza l'API chrome.browsingData
per rimuovere i dati di navigazione dal profilo locale di un utente.
Autorizzazioni
browsingData
Per utilizzare questa API, devi dichiarare l'autorizzazione "browsingData"
nel manifest dell'estensione.
{
"name": "My extension",
...
"permissions": [
"browsingData",
],
...
}
Concetti e 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 indica la data storica dopo la quale i dati di navigazione dell'utente dovrebbero essere rimossi. Questo timestamp viene formattato come il numero di millisecondi dall'epoca Unix (che può essere recuperato da un oggetto Date
JavaScript utilizzando il metodo getTime()
).
Ad esempio, per cancellare tutti i dati di navigazione di un utente dell'ultima settimana, potresti 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()
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. Se, tuttavia, 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 compilata con 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 sta sincronizzando i propri dati, chrome.browsingData.remove()
potrebbe ricreare automaticamente il cookie
per l'account di sincronizzazione dopo averlo cancellato. Questo serve a garantire che la sincronizzazione possa continuare a funzionare, in modo che i dati possano essere eliminati sul server. Tuttavia, è possibile utilizzare chrome.browsingData.removeCookies()
più specifico per cancellare il cookie per l'account di sincronizzazione e la sincronizzazione verrà messa in pausa in questo caso.
Origini specifiche
Per rimuovere i dati di 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 opzioni delle API consente di specificare i tipi di
origini da applicare. Le origini sono suddivise in tre categorie:
unprotectedWeb
tratta il caso generale dei siti web visitati dagli utenti senza intraprendere alcuna azione speciale. Se non specifichi un valoreoriginTypes
, l'API rimuove per impostazione predefinita i dati da origini web non protette.protectedWeb
copre le origini web che sono state installate come applicazioni ospitate. L'installazione di Angry Birds, ad esempio, protegge l'originehttps://chrome.angrybirds.com
e la rimuove dalla categoriaunprotectedWeb
. Fai attenzione quando attivi l'eliminazione dei dati per queste origini: assicurati che i tuoi utenti sappiano cosa stanno ricevendo, poiché i loro dati di gioco verranno rimossi irrevocabilmente. Nessuno vuole abbattere le casette di maiali più spesso del necessario.extension
copre le origini secondo lo schemachrome-extensions:
. Anche in questo caso, rimuovere i dati delle estensioni è un aspetto a cui occorre prestare molta attenzione.
Potremmo modificare l'esempio precedente in modo da 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 dell'APIbrowsingData dal repository chrome-extension-samples.
Tipi
DataTypeSet
Un insieme di tipi di dati. I tipi di dati mancanti vengono interpretati come false
.
Proprietà
-
appcache
booleano facoltativo
Cache di app dei siti web.
-
cache
booleano facoltativo
La cache del browser.
-
cacheStorage
booleano facoltativo
Chrome 72 e versioni successiveSpazio di archiviazione cache
-
cookie
booleano facoltativo
I cookie del browser.
-
download
booleano facoltativo
L'elenco di download del browser.
-
fileSystems
booleano facoltativo
I file system dei siti web.
-
formData
booleano facoltativo
I dati dei moduli memorizzati nel browser.
-
storia
booleano facoltativo
La cronologia del browser.
-
indexedDB
booleano facoltativo
Dati IndexedDB dei siti web.
-
localStorage
booleano facoltativo
Dati di archiviazione locale dei siti web.
-
password
booleano facoltativo
Password memorizzate.
-
pluginData
booleano facoltativo
Ritirato da Chrome 88Il supporto per Flash è stato rimosso. Questo tipo di dati verrà ignorato.
Dati dei plug-in.
-
serverBoundCertificates
booleano facoltativo
Ritirato da Chrome 76Il supporto per i certificati collegati al server è stato rimosso. Questo tipo di dati verrà ignorato.
Certificati legati al server.
-
serviceWorkers
booleano facoltativo
Service worker.
-
webSQL
booleano facoltativo
Dati WebSQL dei siti web.
RemovalOptions
Opzioni che determinano esattamente quali dati verranno rimossi.
Proprietà
-
excludeOrigins
string[] facoltativo
Chrome 74 e versioni successiveSe presenti, i dati per le origini in questo elenco sono esclusi dall'eliminazione. Non può essere utilizzato insieme a
origins
. Supportata solo per cookie, spazio di archiviazione e cache. I cookie sono esclusi per l'intero dominio registrabile. -
originTypes
oggetto facoltativo
Un oggetto le cui proprietà specificano i tipi di origine che devono essere cancellati. Se questo oggetto non è specificato, per impostazione predefinita cancella solo le origini "non protette". Assicurati di voler rimuovere davvero i dati dell'applicazione prima di aggiungere "protectionWeb" o "estensioni".
-
estensione
booleano facoltativo
Estensioni e applicazioni in pacchetto installate da un utente (presta _really_ attenzione!).
-
protectedWeb
booleano facoltativo
Siti web che sono stati installati come applicazioni in hosting (fai attenzione!).
-
unprotectedWeb
booleano facoltativo
Siti web normali.
-
-
origini
[string, ...string[]] optional
Chrome 74 e versioni successiveSe presenti, vengono eliminati solo i dati relativi alle origini di questo elenco. Supportata solo per cookie, spazio di archiviazione e cache. I cookie vengono cancellati per l'intero dominio registrabile.
-
dal
numero facoltativo
Rimuovi i dati accumulati a partire da questa data, rappresentati in millisecondi a partire dall'epoca (accessibile tramite il metodo
getTime
dell'oggetto JavaScriptDate
). Se non è presente, il valore predefinito è 0 (che rimuove tutti i dati di navigazione).
Metodi
remove()
chrome.browsingData.remove(
options: RemovalOptions,
dataToRemove: DataTypeSet,
callback?: function,
)
Cancella i vari tipi di dati di navigazione memorizzati nel profilo di un utente.
Parametri
-
opzioni del modello.
-
dataToRemove
L'insieme dei tipi di dati da rimuovere.
-
callback
funzione facoltativa
Il parametro
callback
ha un aspetto simile al seguente:() => void
Valori restituiti
-
Promise<void>
Chrome 96 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.
removeAppcache()
chrome.browsingData.removeAppcache(
options: RemovalOptions,
callback?: function,
)
Cancella i dati della cache delle app dei siti web.
Parametri
-
opzioni del modello.
-
callback
funzione facoltativa
Il parametro
callback
ha un aspetto simile al seguente:() => void
Valori restituiti
-
Promise<void>
Chrome 96 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.
removeCache()
chrome.browsingData.removeCache(
options: RemovalOptions,
callback?: function,
)
Svuota la cache del browser.
Parametri
-
opzioni del modello.
-
callback
funzione facoltativa
Il parametro
callback
ha un aspetto simile al seguente:() => void
Valori restituiti
-
Promise<void>
Chrome 96 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.
removeCacheStorage()
chrome.browsingData.removeCacheStorage(
options: RemovalOptions,
callback?: function,
)
Cancella i dati di archiviazione della cache dei siti web.
Parametri
-
opzioni del modello.
-
callback
funzione facoltativa
Il parametro
callback
ha un aspetto simile al seguente:() => void
Valori restituiti
-
Promise<void>
Chrome 96 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.
removeCookies()
chrome.browsingData.removeCookies(
options: RemovalOptions,
callback?: function,
)
Cancella i cookie del browser e i certificati legati al server modificati entro un determinato periodo di tempo.
Parametri
-
opzioni del modello.
-
callback
funzione facoltativa
Il parametro
callback
ha un aspetto simile al seguente:() => void
Valori restituiti
-
Promise<void>
Chrome 96 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.
removeDownloads()
chrome.browsingData.removeDownloads(
options: RemovalOptions,
callback?: function,
)
Cancella l'elenco dei file scaricati nel browser (non i file scaricati stessi).
Parametri
-
opzioni del modello.
-
callback
funzione facoltativa
Il parametro
callback
ha un aspetto simile al seguente:() => void
Valori restituiti
-
Promise<void>
Chrome 96 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.
removeFileSystems()
chrome.browsingData.removeFileSystems(
options: RemovalOptions,
callback?: function,
)
Cancella i dati del file system dei siti web.
Parametri
-
opzioni del modello.
-
callback
funzione facoltativa
Il parametro
callback
ha un aspetto simile al seguente:() => void
Valori restituiti
-
Promise<void>
Chrome 96 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.
removeFormData()
chrome.browsingData.removeFormData(
options: RemovalOptions,
callback?: function,
)
Cancella i dati dei moduli memorizzati nel browser (compilazione automatica).
Parametri
-
opzioni del modello.
-
callback
funzione facoltativa
Il parametro
callback
ha un aspetto simile al seguente:() => void
Valori restituiti
-
Promise<void>
Chrome 96 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.
removeHistory()
chrome.browsingData.removeHistory(
options: RemovalOptions,
callback?: function,
)
Consente di cancellare la cronologia del browser.
Parametri
-
opzioni del modello.
-
callback
funzione facoltativa
Il parametro
callback
ha un aspetto simile al seguente:() => void
Valori restituiti
-
Promise<void>
Chrome 96 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.
removeIndexedDB()
chrome.browsingData.removeIndexedDB(
options: RemovalOptions,
callback?: function,
)
Cancella i dati IndexedDB dei siti web.
Parametri
-
opzioni del modello.
-
callback
funzione facoltativa
Il parametro
callback
ha un aspetto simile al seguente:() => void
Valori restituiti
-
Promise<void>
Chrome 96 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.
removeLocalStorage()
chrome.browsingData.removeLocalStorage(
options: RemovalOptions,
callback?: function,
)
Cancella i dati di archiviazione locale dei siti web.
Parametri
-
opzioni del modello.
-
callback
funzione facoltativa
Il parametro
callback
ha un aspetto simile al seguente:() => void
Valori restituiti
-
Promise<void>
Chrome 96 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.
removePasswords()
chrome.browsingData.removePasswords(
options: RemovalOptions,
callback?: function,
)
Cancella le password memorizzate nel browser.
Parametri
-
opzioni del modello.
-
callback
funzione facoltativa
Il parametro
callback
ha un aspetto simile al seguente:() => void
Valori restituiti
-
Promise<void>
Chrome 96 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.
removePluginData()
chrome.browsingData.removePluginData(
options: RemovalOptions,
callback?: function,
)
Il supporto per Flash è stato rimosso. Questa funzione non ha alcun effetto.
Cancella i dati dei plug-in.
Parametri
-
opzioni del modello.
-
callback
funzione facoltativa
Il parametro
callback
ha un aspetto simile al seguente:() => void
Valori restituiti
-
Promise<void>
Chrome 96 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.
removeServiceWorkers()
chrome.browsingData.removeServiceWorkers(
options: RemovalOptions,
callback?: function,
)
Cancella i service worker dei siti web.
Parametri
-
opzioni del modello.
-
callback
funzione facoltativa
Il parametro
callback
ha un aspetto simile al seguente:() => void
Valori restituiti
-
Promise<void>
Chrome 96 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.
removeWebSQL()
chrome.browsingData.removeWebSQL(
options: RemovalOptions,
callback?: function,
)
Cancella i dati WebSQL dei siti web.
Parametri
-
opzioni del modello.
-
callback
funzione facoltativa
Il parametro
callback
ha un aspetto simile al seguente:() => void
Valori restituiti
-
Promise<void>
Chrome 96 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.
settings()
chrome.browsingData.settings(
callback?: function,
)
Consente di segnalare i tipi di dati attualmente selezionati nell'interfaccia utente delle impostazioni "Cancella dati di navigazione". Nota: alcuni tipi di dati inclusi in questa API non sono disponibili nell'interfaccia utente delle impostazioni e alcune impostazioni controllano più di un tipo di dati elencato qui.
Parametri
-
callback
funzione facoltativa
Il parametro
callback
ha un aspetto simile al seguente:(result: object) => void
-
risultato
oggetto
-
dataRemovalPermitted
Nel risultato saranno presenti tutti i tipi, con valori
true
se è consentita la rimozione (ad es. in base ai criteri aziendali) efalse
in caso contrario. -
dataToRemove
Nel risultato saranno presenti tutti i tipi, con valori
true
se entrambi sono selezionati per la rimozione e possono essere rimossi, altrimentifalse
. -
opzioni del modello.
-
-
Valori restituiti
-
Promise<object>
Chrome 96 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.