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 sıfır zamanından 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ının çerezini otomatik olarak yeniden oluşturabilir. Bu, senkronizasyonun çalışmaya devam etmesini sağlamak ve böylece verilerin sunucuda silinmesini sağlamak 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 ç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

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. Bu işlem, kullanıcılarınızın oyun verilerini geri döndürülemez şekilde kaldıracağından, kullanıcılarınızın ne elde ettiklerini bildiğinden emin olun. 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ı

    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ı

    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ı

    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 listede yer alan kaynakların verileri, 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

    [dize, ...dize[]] 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, dönemden bu yana geçen milisaniye sayısı olarak gösterilir (JavaScript Date nesnesinin getTime yöntemiyle erişilebilir). Yoksa varsayılan olarak 0 değerine ayarlanı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

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

removeAppcache()

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

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

    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

    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

    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

    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 temizler (indirilen dosyaları değil).

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

    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

    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

    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

    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

    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

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

removePasswords()

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

Tarayıcının kayıtlı şifrelerini 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

    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

    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

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

removeWebSQL()

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

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

    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 şu anda 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

  • 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ğerler 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 veriliyorsa 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.