Açıklama
Kullanıcının yerel profilinden tarama verilerini kaldırmak için chrome.browsingData
API'yi kullanın.
İzinler
browsingData
Bu API'yi kullanmak için uzantı manifestinde "browsingData"
iznini beyan etmeniz gerekir.
{
"name": "My extension",
...
"permissions": [
"browsingData",
],
...
}
Kavramlar ve kullanım
Bu API'nin en basit kullanım alanı, kullanıcıların tarama verilerini temizlemek için zamana dayalı bir mekanizmadır.
Kodunuzda, kullanıcının tarama verilerinin kaldırılması gereken geçmiş tarihi belirten bir zaman damgası bulunmalıdır. Bu zaman damgası, Unix döneminin başlangıcından bu yana geçen milisaniye sayısı olarak biçimlendirilir (bu zaman damgası, getTime()
yöntemi kullanılarak bir JavaScript Date
nesnesinden alınabilir).
Örneğin, bir kullanıcının geçen haftaya ait tüm tarama verilerini temizlemek için aşağıdaki gibi bir kod yazabilirsiniz:
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);
chrome.browsingData.remove()
yöntemi, tek bir çağrıyla çeşitli tarama verilerini kaldırmanızı sağlar. Bu yöntem, birden fazla spesifik yöntemi çağırmaktan çok daha hızlıdır. Bununla birlikte, yalnızca belirli bir tarama verisi türünü (ör. çerezler) temizlemek istiyorsanız daha ayrıntılı yöntemler, JSON ile dolu bir çağrıya okunabilir bir alternatif sunar.
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);
Kullanıcı verilerini senkronize ediyorsa chrome.browsingData.remove()
, çerez temizlendikten sonra Senkronizasyon hesabı için çerezi otomatik olarak yeniden oluşturabilir. Bu işlem, Senkronizasyonun çalışmaya devam etmesini ve böylece verilerin sunucudan silinmesini sağlar. Ancak, Senkronizasyon hesabının çerezini temizlemek için daha spesifik olan chrome.browsingData.removeCookies()
kullanılabilir ve bu durumda Senkronizasyon duraklatılır.
Belirli kaynaklar
Belirli bir kaynağa ait verileri kaldırmak veya bir kaynak grubunu silme işleminden hariç tutmak için RemovalOptions.origins
ve RemovalOptions.excludeOrigins
parametrelerini kullanabilirsiniz. Yalnızca çerezlere, önbelleğe ve depolama alanına (CacheStorage, FileSystems, IndexedDB, LocalStorage, ServiceWorkers ve WebSQL) uygulanabilir.
chrome.browsingData.remove({
"origins": ["https://www.example.com"]
}, {
"cacheStorage": true,
"cookies": true,
"fileSystems": true,
"indexedDB": true,
"localStorage": true,
"serviceWorkers": true,
"webSQL": true
}, callback);
Kaynak türleri
APIs options nesnesine bir originTypes
özelliği eklemek, hangi kaynak türlerinin etkilenmesi gerektiğini belirtmenize olanak tanır. Kaynaklar üç kategoriye ayrılır:
unprotectedWeb
, kullanıcıların herhangi bir özel işlem yapmadan ziyaret ettiği web siteleriyle ilgili genel durumu kapsar. BiroriginTypes
belirtmezseniz API varsayılan olarak korumasız web kaynaklarından verileri kaldırır.protectedWeb
, barındırılan uygulamalar olarak yüklenmiş web kaynaklarını kapsar. Örneğin, Angry Birds yüklendiğindehttps://chrome.angrybirds.com
kaynağı korunur veunprotectedWeb
kategorisinden kaldırılır. Bu kaynaklardan elde edilen verilerin silinmesini tetiklerken dikkatli olun: Oyun verilerinin geri alınamayacak şekilde kaldırılmasına neden olacağından, kullanıcılarınızın sunulanları bildiklerinden emin olun. Kimse küçük domuz evlerini sık sık yıkmak istemez.extension
,chrome-extensions:
şeması kapsamındaki kaynakları kapsar. Uzantı verilerini kaldırırken yine çok dikkat etmeniz gerekir.
Önceki örneği, korunan web sitelerinden yalnızca verileri kaldıracak şekilde aşağıdaki şekilde düzenleyebiliriz:
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);
Örnekler
Bu API'yi denemek için chrome-extension-samples deposundan browsingData API örneğini yükleyin.
Türler
DataTypeSet
Bir dizi veri türü. Eksik veri türleri false
olarak yorumlanır.
Özellikler
-
uygulama önbelleği
boole isteğe bağlı
Web sitelerinin appcache'leri.
-
önbellek
boole isteğe bağlı
Tarayıcının önbelleği.
-
cacheStorage
boole isteğe bağlı
Chrome 72 ve sonraki sürümlerÖnbellek depolama alanı
-
Cloud Console dışındaki Google Cloud sitelerindeki
boole isteğe bağlı
Tarayıcının çerezleri.
-
indirilenler
boole isteğe bağlı
Tarayıcının indirme listesi.
-
fileSystems
boole isteğe bağlı
Web sitelerinin dosya sistemleri.
-
formData
boole isteğe bağlı
Tarayıcının depolanan form verileri.
-
geçmiş
boole isteğe bağlı
Tarayıcı geçmişi.
-
indexedDB
boole isteğe bağlı
Web sitelerinin IndexedDB verileri.
-
localStorage
boole isteğe bağlı
Web sitelerinin yerel depolama verileri.
-
şifreler
boole isteğe bağlı
Saklanan şifreler.
-
pluginData
boole isteğe bağlı
Chrome 88'den itibaren kullanımdan kaldırıldıFlash desteği kaldırılmıştır. Bu veri türü yoksayılır.
Eklentilerle ilgili veriler.
-
serverBoundCertificates
boole isteğe bağlı
Chrome 76 sürümünden itibaren kullanımdan kaldırıldıSunucuya bağlı sertifikalar için destek kaldırıldı. Bu veri türü yoksayılır.
Sunucuya bağlı sertifikalar.
-
serviceWorkers
boole isteğe bağlı
Service Workers'ı seçin.
-
webSQL
boole isteğe bağlı
Web sitelerinin WebSQL verileri.
RemovalOptions
Tam olarak hangi verilerin kaldırılacağını belirleyen seçenekler.
Özellikler
-
excludeOrigins
string[] isteğe bağlı
Chrome 74 ve sonraki sürümlerMevcut olduğunda bu listedeki kaynaklara ait veriler silme işleminden hariç tutulur.
origins
ile birlikte kullanılamaz. Yalnızca çerezler, depolama alanı ve önbellek için desteklenir. Çerezler, kaydedilebilir alan adının tamamı için hariç tutulur. -
originTypes
isteğe bağlı
Özellikleri, hangi kaynak türlerinin temizlenmesi gerektiğini belirten nesnedir. Bu nesne belirtilmezse varsayılan olarak yalnızca "korumasız" kaynakları temizler. "ProtectedWeb" veya "extensions" eklemeden önce uygulama verilerini gerçekten kaldırmak istediğinizden emin olun.
-
uzantı
boole isteğe bağlı
Bir kullanıcının yüklediği uzantılar ve paket uygulamalar (_gerçekten_ dikkatli olun!).
-
protectedWeb
boole isteğe bağlı
Barındırılan uygulamalar olarak yüklenmiş web siteleri (dikkatli olun!).
-
unprotectedWeb
boole isteğe bağlı
Normal web siteleri.
-
-
başlangıç noktaları
string[] isteğe bağlı
Chrome 74 ve sonraki sürümlerMevcut olduğunda yalnızca bu listedeki kaynaklara ait veriler silinir. Yalnızca çerezler, depolama alanı ve önbellek için desteklenir. Kaydedilebilir alanın tamamı için çerezler temizlenir.
-
şu tarihten beri:
numara isteğe bağlı
Bu tarihte veya daha sonra biriken verileri kaldırın. Dönemden itibaren milisaniye cinsinden gösterilir (JavaScript
Date
nesnesiningetTime
yöntemiyle erişilebilir). Yoksa varsayılan olarak 0 değerine ayarlanır (bu durumda tüm tarama verileri kaldırılır).
Yöntemler
remove()
chrome.browsingData.remove(
options: RemovalOptions,
dataToRemove: DataTypeSet,
callback?: function,
)
Bir kullanıcının profilinde depolanan çeşitli türlerdeki tarama verilerini temizler.
Parametreler
-
seçenekler
-
dataToRemove
Kaldırılacak veri türü grubu.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:()=>void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
removeAppcache()
chrome.browsingData.removeAppcache(
options: RemovalOptions,
callback?: function,
)
Web sitelerinin appcache verilerini temizler.
Parametreler
-
seçenekler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:()=>void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
removeCache()
chrome.browsingData.removeCache(
options: RemovalOptions,
callback?: function,
)
Tarayıcının önbelleğini temizler.
Parametreler
-
seçenekler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:()=>void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
removeCacheStorage()
chrome.browsingData.removeCacheStorage(
options: RemovalOptions,
callback?: function,
)
Web sitelerinin önbellek depolama verilerini temizler.
Parametreler
-
seçenekler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:()=>void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
removeCookies()
chrome.browsingData.removeCookies(
options: RemovalOptions,
callback?: function,
)
Tarayıcının çerezlerini ve belirli bir zaman aralığı içinde değiştirilen sunucuya bağlı sertifikaları temizler.
Parametreler
-
seçenekler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:()=>void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
removeDownloads()
chrome.browsingData.removeDownloads(
options: RemovalOptions,
callback?: function,
)
Tarayıcının indirilen dosya listesini temizler (indirilen dosyaların kendisini değil).
Parametreler
-
seçenekler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:()=>void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
removeFileSystems()
chrome.browsingData.removeFileSystems(
options: RemovalOptions,
callback?: function,
)
Web sitelerinin dosya sistemi verilerini temizler.
Parametreler
-
seçenekler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:()=>void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
removeFormData()
chrome.browsingData.removeFormData(
options: RemovalOptions,
callback?: function,
)
Tarayıcının depolanan form verilerini (otomatik doldurma) temizler.
Parametreler
-
seçenekler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:()=>void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
removeHistory()
chrome.browsingData.removeHistory(
options: RemovalOptions,
callback?: function,
)
Tarayıcı geçmişini temizler.
Parametreler
-
seçenekler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:()=>void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
removeIndexedDB()
chrome.browsingData.removeIndexedDB(
options: RemovalOptions,
callback?: function,
)
Web sitelerinin IndexedDB verilerini temizler.
Parametreler
-
seçenekler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:()=>void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
removeLocalStorage()
chrome.browsingData.removeLocalStorage(
options: RemovalOptions,
callback?: function,
)
Web sitelerinin yerel depolama verilerini temizler.
Parametreler
-
seçenekler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:()=>void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
removePasswords()
chrome.browsingData.removePasswords(
options: RemovalOptions,
callback?: function,
)
Tarayıcının depolanmış şifrelerini temizler.
Parametreler
-
seçenekler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:()=>void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
removePluginData()
chrome.browsingData.removePluginData(
options: RemovalOptions,
callback?: function,
)
Flash desteği kaldırılmıştır. Bu işlevin hiçbir etkisi yoktur.
Eklentilerin verilerini temizler.
Parametreler
-
seçenekler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:()=>void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
removeServiceWorkers()
chrome.browsingData.removeServiceWorkers(
options: RemovalOptions,
callback?: function,
)
Web sitelerinin hizmet çalışanlarını temizler.
Parametreler
-
seçenekler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:()=>void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
removeWebSQL()
chrome.browsingData.removeWebSQL(
options: RemovalOptions,
callback?: function,
)
Web sitelerinin WebSQL verilerini temizler.
Parametreler
-
seçenekler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:()=>void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
settings()
chrome.browsingData.settings(
callback?: function,
)
"Tarama verilerini temizle" ayarları kullanıcı arayüzünde hangi veri türlerinin seçili olduğunu bildirir. Not: Bu API'de yer alan bazı veri türleri ayarlar kullanıcı arayüzünde kullanılamaz ve bazı kullanıcı arayüzü ayarları, burada listelenen birden fazla veri türünü kontrol eder.
Parametreler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(result: object)=>void
-
sonuç
nesne
-
dataRemovalPermitted
Tüm türler sonuçta, kaldırılmasına izin veriliyorsa
true
ve izin verilmiyorsafalse
değerleriyle görüntülenir. -
dataToRemove
Tüm türler sonuçta, her ikisi de kaldırılmak üzere seçilir ve kaldırılmasına izin verilirse
true
değerleriyle görüntülenir; aksi takdirdefalse
. -
seçenekler
-
-
İlerlemeler
-
Promise<object>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.