chrome.browsingData

Açıklama

Bir kullanıcının yerel profilinden göz atma verilerini kaldırmak için chrome.browsingData API'sini kullanın.

İzinler

browsingData

Manifest

Bu API'yi kullanmak için uzantı manifestinde "browsingData" iznini belirtmeniz gerekir.

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

Kullanım

Bu API'nin en basit kullanım alanı, kullanıcını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 bu yana geçen milisaniye sayısı olarak biçimlendirilir (JavaScript Date nesnesinden getTime yöntemiyle alınabilir).

Örneğin, bir kullanıcının son haftadaki 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ıza olanak tanır ve birden fazla daha spesifik yöntemi çağırmaktan çok daha hızlıdır. Ancak 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, temizlendikten sonra senkronizasyon hesabı için çerezi otomatik olarak yeniden oluşturabilir. Bu, senkronizasyonun çalışmaya devam etmesini sağlamak ve verilerin sunucuda sonunda silinebilmesi için gereklidir. Ancak daha spesifik olan chrome.browsingData.removeCookies, senkronizasyon hesabının çerezini temizlemek için kullanılabilir ve bu durumda senkronizasyon duraklatılır.

Belirli kaynaklar

Belirli bir kaynağa ait verileri kaldırmak veya bir dizi kaynağı silme işleminden hariç tutmak için RemovalOptions.origins ve RemovalOptions.excludeOrigins parametrelerini kullanabilirsiniz. Yalnızca çerezler, önbellek 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

API'nin seçenekler nesnesine bir originTypes özelliği ekleyerek hangi kaynak türlerinin etkilenmesi gerektiğini belirtebilirsiniz. Şu anda kaynaklar üç kategoriye ayrılmaktadı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 verileri korumasız web kaynaklarından kaldırır.
  • protectedWeb, barındırılan uygulamalar olarak yüklenen web kaynaklarını kapsar. Örneğin, Angry Birds'ü yüklemek, kaynağı https://chrome.angrybirds.com korur ve unprotectedWeb kategorisinden kaldırır. Lütfen bu kaynaklar için veri silme işlemini tetiklerken dikkatli olun. Kullanıcılarınızın ne elde ettiklerini bildiğinden emin olun. Aksi takdirde, oyun verileri geri döndürülemez şekilde kaldırılır. Kimse küçük domuz evlerini gerekenden daha sık yıkmak istemez.
  • extension, chrome-extensions: şeması kapsamındaki kaynakları kapsar. Uzantı verilerini kaldırma işlemi de dikkatli olmanız gereken bir konudur.

Önceki örneği, yalnızca korumalı web sitelerindeki verileri kaldıracak şekilde aşağıdaki gibi 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

  • appcache

    boolean isteğe bağlı

    Kullanımdan kaldırıldı

    appcache desteği kaldırıldı. Bu veri türü yoksayılır.

    Web sitelerinin uygulama önbellekleri.

  • önbellek

    boolean isteğe bağlı

    Tarayıcının önbelleği.

  • cacheStorage

    boolean isteğe bağlı

    Chrome 72 veya daha yeni bir sürüm

    Önbellek depolama alanı

  • Cloud Console dışındaki Google Cloud sitelerindeki

    boolean isteğe bağlı

    Tarayıcının çerezleri.

  • indirilenler

    boolean isteğe bağlı

    Tarayıcının indirme listesi.

  • fileSystems

    boolean isteğe bağlı

    Web sitelerinin dosya sistemleri.

  • formData

    boolean isteğe bağlı

    Tarayıcının depoladığı form verileri.

  • geçmiş

    boolean isteğe bağlı

    Tarayıcının geçmişi.

  • indexedDB

    boolean isteğe bağlı

    Web sitelerinin IndexedDB verileri.

  • localStorage

    boolean isteğe bağlı

    Web sitelerinin yerel depolama verileri.

  • şifreler

    boolean isteğe bağlı

    Chrome 144'ten beri kullanımdan kaldırıldı

    Uzantılar aracılığıyla şifre silme desteği kaldırıldı. Bu veri türü yoksayılır.

    Kayıtlı şifreler

  • pluginData

    boolean isteğe bağlı

    Chrome 88'den beri kullanımdan kaldırılmıştır.

    Flash desteği kaldırıldı. Bu veri türü yoksayılır.

    Eklentilerin verileri.

  • serverBoundCertificates

    boolean isteğe bağlı

    Chrome 76'dan beri 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

    boolean isteğe bağlı

    Hizmet Çalışanları

  • webSQL

    boolean isteğe bağlı

    Kullanımdan kaldırıldı

    WebSQL desteği kaldırıldı. Bu veri türü yoksayılır.

    Web sitelerinin WebSQL verileri.

RemovalOptions

Hangi verilerin tam olarak kaldırılacağını belirleyen seçenekler.

Özellikler

  • excludeOrigins

    string[] isteğe bağlı

    Chrome 74 veya daha yeni bir sürüm

    Bu liste mevcut olduğunda, listedeki kaynaklara ait veriler silme işlemine dahil edilmez. origins ile birlikte kullanılamaz. Yalnızca çerezler, depolama ve önbellek için desteklenir. Çerezler, kayıt edilebilir alanın tamamı için hariç tutulur.

  • originTypes

    object isteğe bağlı

    Özellikleri, hangi kaynak türlerinin temizlenmesi gerektiğini belirten bir nesne. Bu nesne belirtilmezse varsayılan olarak yalnızca "korumasız" kaynaklar temizlenir. "protectedWeb" veya "extensions" eklemeden önce uygulama verilerini gerçekten kaldırmak istediğinizden emin olun.

    • süresini uzatma

      boolean isteğe bağlı

      Kullanıcının yüklediği uzantılar ve paketlenmiş uygulamalar (Çok dikkatli olun!).

    • protectedWeb

      boolean isteğe bağlı

      Barındırılan uygulamalar olarak yüklenen web siteleri (dikkatli olun!).

    • unprotectedWeb

      boolean isteğe bağlı

      Normal web siteleri.

  • kökenler

    [string, ...string[]] isteğe bağlı

    Chrome 74 veya daha yeni bir sürüm

    Bu liste mevcut olduğunda yalnızca listedeki kaynaklara ait veriler silinir. Yalnızca çerezler, depolama ve önbellek için desteklenir. Çerezler, kayıt edilebilir alanın tamamı için temizlenir.

  • şu tarihten beri:

    number isteğe bağlı

    Bu tarihte veya sonrasında biriken verileri kaldırın. Bu veriler, epoch'tan bu yana geçen süre (milisaniye cinsinden) olarak gösterilir ve JavaScript Date nesnesinin getTime yöntemiyle erişilebilir. Yoksa varsayılan olarak 0'dır (bu da tüm tarama verilerini kaldırır).

Yöntemler

remove()

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

Kullanıcı profilinde depolanan çeşitli tarama verisi türlerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • dataToRemove

    DataTypeSet

    Kaldırılacak veri türleri grubu.

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Silme işlemi tamamlandığında çözülür.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

removeAppcache()

Promise Kullanımdan kaldırıldı
chrome.browsingData.removeAppcache(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

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

Web sitelerinin uygulama önbelleği verilerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Web sitelerinin uygulama önbelleği verileri temizlendiğinde çözülür.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

removeCache()

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

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

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Tarayıcının önbelleği temizlendiğinde çözülür.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

removeCacheStorage()

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

Web sitelerinin önbellek depolama verilerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Web sitelerinin önbellek depolama alanı temizlendiğinde çözülür.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

removeCookies()

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

Tarayıcının çerezlerini ve belirli bir zaman aralığında değiştirilen sunucuya bağlı sertifikaları temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Tarayıcının çerezleri ve sunucuya bağlı sertifikaları temizlendiğinde çözülür.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

removeDownloads()

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

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

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Tarayıcının indirilen dosyalar listesi temizlendiğinde çözülür.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

removeFileSystems()

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

Web sitelerinin dosya sistemi verilerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Web sitelerinin dosya sistemleri temizlendiğinde çözülür.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

removeFormData()

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

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

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Tarayıcının form verileri temizlendiğinde çözülür.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

removeHistory()

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

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

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Tarayıcının geçmişi temizlendiğinde çözülür.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

removeIndexedDB()

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

Web sitelerinin IndexedDB verilerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Web sitelerinin IndexedDB verileri temizlendiğinde çözülür.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

removeLocalStorage()

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

Web sitelerinin yerel depolama verilerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Web sitelerinin yerel depolama alanı temizlendiğinde çözülür.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

removePasswords()

Promise Chrome 144'ten beri kullanımdan kaldırıldı
chrome.browsingData.removePasswords(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Uzantılar aracılığıyla şifre silme desteği kaldırıldı. Bu işlevin bir etkisi yoktur.

Tarayıcının depoladığı şifreleri temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Tarayıcının şifreleri temizlendiğinde çözülür.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

removePluginData()

Promise Chrome 88'den beri kullanımdan kaldırılmıştır
chrome.browsingData.removePluginData(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

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

Eklentilerin verilerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Eklentilerin verileri temizlendiğinde çözülür.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

removeServiceWorkers()

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

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

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Web sitelerinin hizmet çalışanları temizlendiğinde çözülür.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

removeWebSQL()

Promise Kullanımdan kaldırıldı
chrome.browsingData.removeWebSQL(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

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

Web sitelerinin WebSQL verilerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Web sitelerinin WebSQL veritabanları temizlendiğinde çözülür.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

settings()

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

"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. Ayrıca, bazı kullanıcı arayüzü ayarları burada listelenen birden fazla veri türünü kontrol eder.

Parametreler

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (result: object) => void

    • sonuç

      nesne

      • dataRemovalPermitted

        DataTypeSet

        Tüm türler sonuçta yer alır.Kaldırılmasına izin veriliyorsa (ör. kurumsal politika tarafından) değerleri true, izin verilmiyorsa false olur.

      • dataToRemove

        DataTypeSet

        Her iki tür de kaldırılmak üzere seçilmişse ve kaldırılmasına izin verilmişse sonuçta true değerleriyle, aksi takdirde false değerleriyle yer alır.

      • seçenekler

        RemovalOptions

İadeler

  • Promise<object>

    Chrome 96 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.