Açıklama
Bir kullanıcının yerel profilindeki tarama verilerini kaldırmak için chrome.browsingData
API'yi kullanın.
İzinler
browsingData
Manifest
Bu API'yi kullanmak için uzantı manifestinde "browsingData" iznini beyan etmeniz gerekir.
{
"name": "My extension",
...
"permissions": [
"browsingData",
],
...
}
Kullanım
Bu API'nin en basit kullanım alanı, kullanıcıların tarama verilerini temizlemek için zamana dayalı bir mekanizmadır.
Kodunuz, kullanıcının tarama verilerinin kaldırılması gereken geçmiş tarihi belirten bir zaman damgası sağlamalıdır. Bu zaman damgası, Unix Epoch'tan (getTime
yöntemi aracılığıyla bir JavaScript Date
nesnesinden alınabilir) beri geçen milisaniye sayısı olarak biçimlendirilir.
Örneğin, bir kullanıcının geçen haftaya ait tüm tarama verilerini temizlemek için aşağıdaki gibi 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 veri türlerini kaldırmanıza olanak tanır ve birden fazla spesifik yöntemi çağırmaktan çok daha hızlıdır. Ancak, yalnızca belirli bir tür tarama verilerini (örneğin, çerezler) temizlemek istiyorsanız daha ayrıntılı yöntemler, JSON ile doldurulmuş bir çağrıya daha 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
, Senkronizasyon hesabı için çerezi temizledikten sonra otomatik olarak yeniden oluşturabilir. Bunun amacı, Senkronizasyonun çalışmaya devam edebilmesini ve böylece
verilerin sonunda sunucudan silinebilmesini sağlamaktır. Bununla birlikte, daha spesifik olan chrome.browsingData.removeCookies
, Senkronizasyon hesabına ait çerezi temizlemek için 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) uygulanabilirler.
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
API'nin seçenekler nesnesine originTypes
özelliği eklemek, etkilenecek kaynak türlerini belirtmenize olanak tanır. Şu anda, kaynaklar üç kategoriye ayrılmıştır:
unprotectedWeb
, kullanıcıların herhangi bir özel işlem yapmadan ziyaret ettiği web sitelerinin genel durumunu kapsar. BiroriginTypes
belirtmezseniz API varsayılan olarak, korumasız web kaynaklarından verileri kaldırır.protectedWeb
, barındırılan uygulamalar olarak yüklenen web kaynaklarını kapsar. Örneğin, Angry Birds'ü yüklemek,https://chrome.angrybirds.com
kaynağını korur veunprotectedWeb
kategorisinden kaldırır. Bu kaynaklardaki verilerin silinmesini tetiklerken lütfen dikkatli olun: Kullanıcılarınızın bu hizmetten ne elde ettiklerini bildiğinden emin olun. Bu işlem, oyun verilerinin geri alınamaz şekilde kaldırılmasına neden olur. Kimse ufak domuz evlerini gereğinden fazla boydan yok etmek istemez.extension
,chrome-extensions:
şeması kapsamındaki kaynakları kapsar. Uzantı verilerini kaldırmak da çok dikkatli olmanız gereken bir husustur.
Önceki örneği, yalnızca korunan web sitelerindeki verileri aşağıdaki şekilde kaldıracak ş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 veri türü kümesi. Eksik veri türleri false
olarak yorumlanır.
Özellikler
-
uygulama önbelleği
boole isteğe bağlı
Web sitelerinin uygulama önbellekleri.
-
ö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ının 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 beri desteği sonlandırıldıFlash desteği kaldırıldı. Bu veri türü yoksayılır.
Eklentilerin verileri.
-
serverBoundCertificates
boole isteğe bağlı
Chrome 76'dan bu yana desteği sonlandırıldıSunucuya bağlı sertifikalar desteği kaldırıldı. Bu veri türü yoksayılır.
Sunucuya bağlı sertifikalar.
-
serviceWorkers
boole isteğe bağlı
Service Worker'lar.
-
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ümlerBu listedeki kaynaklara ait veriler mevcut olduğunda silme işleminden hariç tutulur.
origins
ile birlikte kullanılamaz. Yalnızca çerezler, depolama alanı ve önbellek için desteklenir. Çerezler, kaydedilebilir alanın tamamında hariç tutulur. -
originTypes
nesne isteğe bağlı
Özellikleri, hangi kaynak türlerinin temizlenmesi gerektiğini belirten bir nesnedir. Bu nesne belirtilmezse varsayılan olarak yalnızca "korumasız" kaynaklar temizlenir. "Korunan Web" veya "uzantılar"ı eklemeden önce lütfen uygulama verilerini gerçekten kaldırmak istediğinizden emin olun.
-
uzantı
boole isteğe bağlı
Kullanıcının yüklediği uzantılar ve paket uygulamalar (çok 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.
-
-
kaynaklar
[string, ...string[]] optional
Chrome 74 ve sonraki sürümlerMevcut olduğunda yalnızca bu listedeki kaynakların verileri silinir. Yalnızca çerezler, depolama alanı ve önbellek için desteklenir. Çerezler, kaydedilebilir alanın tamamı için temizlenir.
-
şu tarihten beri:
sayı isteğe bağlı
Dönemden bu yana milisaniye cinsinden temsil edilen, bu tarihte veya sonrasında biriken verileri kaldırın (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 tarama verilerini temizler.
Parametreler
-
seçenekler
-
dataToRemove
Kaldırılacak veri türleri kümesi.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
removeAppcache()
chrome.browsingData.removeAppcache(
options: RemovalOptions,
callback?: function,
)
Web sitelerinin appcache verilerini temizler.
Parametreler
-
seçenekler
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
removeCache()
chrome.browsingData.removeCache(
options: RemovalOptions,
callback?: function,
)
Tarayıcının önbelleğini temizler.
Parametreler
-
seçenekler
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
removeCacheStorage()
chrome.browsingData.removeCacheStorage(
options: RemovalOptions,
callback?: function,
)
Web sitelerinin önbellek depolama verilerini temizler.
Parametreler
-
seçenekler
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
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
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
removeDownloads()
chrome.browsingData.removeDownloads(
options: RemovalOptions,
callback?: function,
)
Tarayıcının indirilen dosyalar listesini temizler (indirilen dosyaların kendisi değil).
Parametreler
-
seçenekler
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
removeFileSystems()
chrome.browsingData.removeFileSystems(
options: RemovalOptions,
callback?: function,
)
Web sitelerinin dosya sistemi verilerini temizler.
Parametreler
-
seçenekler
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
removeFormData()
chrome.browsingData.removeFormData(
options: RemovalOptions,
callback?: function,
)
Tarayıcının depolanan form verilerini temizler (otomatik doldurma).
Parametreler
-
seçenekler
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
removeHistory()
chrome.browsingData.removeHistory(
options: RemovalOptions,
callback?: function,
)
Tarayıcının geçmişini temizler.
Parametreler
-
seçenekler
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
removeIndexedDB()
chrome.browsingData.removeIndexedDB(
options: RemovalOptions,
callback?: function,
)
Web sitelerinin IndexedDB verilerini temizler.
Parametreler
-
seçenekler
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
removeLocalStorage()
chrome.browsingData.removeLocalStorage(
options: RemovalOptions,
callback?: function,
)
Web sitelerinin yerel depolama verilerini temizler.
Parametreler
-
seçenekler
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
removePasswords()
chrome.browsingData.removePasswords(
options: RemovalOptions,
callback?: function,
)
Tarayıcının depolanan şifrelerini temizler.
Parametreler
-
seçenekler
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
removePluginData()
chrome.browsingData.removePluginData(
options: RemovalOptions,
callback?: function,
)
Flash desteği kaldırıldı. Bu işlevin etkisi yoktur.
Eklentilerin verilerini temizler.
Parametreler
-
seçenekler
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
removeServiceWorkers()
chrome.browsingData.removeServiceWorkers(
options: RemovalOptions,
callback?: function,
)
Web sitelerinin hizmet çalışanlarını temizler.
Parametreler
-
seçenekler
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
removeWebSQL()
chrome.browsingData.removeWebSQL(
options: RemovalOptions,
callback?: function,
)
Web sitelerinin WebSQL verilerini temizler.
Parametreler
-
seçenekler
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
settings()
chrome.browsingData.settings(
callback?: function,
)
"Tarama verilerini temizle" ayarları kullanıcı arayüzünde o anda hangi veri türlerinin seçili olduğunu bildirir. Not: Bu API'ye dahil edilen veri türlerinden bazıları 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
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(result: object) => void
-
sonuç
nesne
-
dataRemovalPermitted
Kaldırılmasına izin verilirse (ör. kurumsal politikaya göre), tüm türler sonuçta
true
değerleriyle, izin verilmiyorsafalse
değerleriyle birlikte sonuçta gösterilir. -
dataToRemove
Her ikisi de kaldırılmak üzere seçilir ve kaldırılmasına izin verilirse tüm türler
true
değerleriyle sonuçta yer alır. Aksi takdirdefalse
olur. -
seçenekler
-
-
İlerlemeler
-
Promise<object>
Chrome 96 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.