chrome.browsingData

Açıklama

Bir kullanıcının yerel profilindeki 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. 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 kullanılarak 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 seçenekleri nesnesine originTypes özelliği eklemek, etkilenecek kaynak türlerini belirtmenizi sağlar. Kaynaklar üç kategoriye ayrılır:

  • unprotectedWeb, kullanıcıların herhangi bir özel işlem yapmadan ziyaret ettiği web sitelerinin genel durumunu kapsar. Bir originTypes 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 ve unprotectedWeb kategorisinden kaldırır. Bu kaynaklardaki verilerin silinmesini tetiklerken dikkatli olun: Kullanıcılarınızın bu hizmetten ne yararlandıklarını 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ümler

    Bu 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ümler

    Mevcut 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 nesnesinin getTime 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()

Söz 
chrome.browsingData.remove(
  options: RemovalOptions,
  dataToRemove: DataTypeSet,
  callback?: function,
)

Bir kullanıcının profilinde depolanan çeşitli tarama verilerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • dataToRemove

    DataTypeSet

    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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için 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()

Söz 
chrome.browsingData.removeAppcache(
  options: RemovalOptions,
  callback?: function,
)

Web sitelerinin appcache verilerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • 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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için 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()

Söz 
chrome.browsingData.removeCache(
  options: RemovalOptions,
  callback?: function,
)

Tarayıcının önbelleğini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • 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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için 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()

Promise Chrome 72 ve sonraki sürümler 
chrome.browsingData.removeCacheStorage(
  options: RemovalOptions,
  callback?: function,
)

Web sitelerinin önbellek depolama verilerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • 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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için 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()

Söz 
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

    RemovalOptions

  • 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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için 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()

Söz 
chrome.browsingData.removeDownloads(
  options: RemovalOptions,
  callback?: function,
)

Tarayıcının indirilen dosyalar listesini temizler (indirilen dosyaların kendisi değil).

Parametreler

  • seçenekler

    RemovalOptions

  • 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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için 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()

Söz 
chrome.browsingData.removeFileSystems(
  options: RemovalOptions,
  callback?: function,
)

Web sitelerinin dosya sistemi verilerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • 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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için 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()

Söz 
chrome.browsingData.removeFormData(
  options: RemovalOptions,
  callback?: function,
)

Tarayıcının depolanan form verilerini temizler (otomatik doldurma).

Parametreler

  • seçenekler

    RemovalOptions

  • 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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için 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()

Söz 
chrome.browsingData.removeHistory(
  options: RemovalOptions,
  callback?: function,
)

Tarayıcının geçmişini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • 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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için 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()

Söz 
chrome.browsingData.removeIndexedDB(
  options: RemovalOptions,
  callback?: function,
)

Web sitelerinin IndexedDB verilerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • 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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için 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()

Söz 
chrome.browsingData.removeLocalStorage(
  options: RemovalOptions,
  callback?: function,
)

Web sitelerinin yerel depolama verilerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • 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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için 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()

Söz 
chrome.browsingData.removePasswords(
  options: RemovalOptions,
  callback?: function,
)

Tarayıcının depolanan şifrelerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • 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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için 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()

Taahhüt Chrome 88'den bu yana kullanımdan kaldırılmıştır
chrome.browsingData.removePluginData(
  options: RemovalOptions,
  callback?: function,
)

Flash desteği kaldırıldı. Bu işlevin etkisi yoktur.

Eklentilerin verilerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • 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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için 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()

Promise Chrome 72 ve sonraki sürümler 
chrome.browsingData.removeServiceWorkers(
  options: RemovalOptions,
  callback?: function,
)

Web sitelerinin hizmet çalışanlarını temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • 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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için 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()

Söz 
chrome.browsingData.removeWebSQL(
  options: RemovalOptions,
  callback?: function,
)

Web sitelerinin WebSQL verilerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • 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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için 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()

Söz 
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

        DataTypeSet

        Kaldırılmasına izin verilirse (ör. kurumsal politikaya göre), tüm türler sonuçta true değerleriyle, izin verilmiyorsa false değerleriyle birlikte sonuçta gösterilir.

      • dataToRemove

        DataTypeSet

        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 takdirde false olur.

      • seçenekler

        RemovalOptions

İlerlemeler

  • Promise<object>

    Chrome 96 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için 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.