browser.browsingData

Açıklama

Kullanıcının yerel profilinden tarama verilerini kaldırmak için chrome.browsingData API'sini kullanın.

İzinler

browsingData

Bu API'yi kullanmak için uzantı manifest dosyasında "browsingData" iznini beyan etmeniz gerekir.

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

Kavramlar ve 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 (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;
browser.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);

browser.browsingData.remove() yöntemi, tek bir çağrıyla çeşitli tarama verisi türlerini kaldırmanıza olanak tanır ve daha spesifik birden fazla 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;
browser.browsingData.removeCookies({
  "since": oneWeekAgo
}, callback);

Kullanıcı verilerini senkronize ediyorsa browser.browsingData.remove(), senkronizasyon hesabının çerezini temizledikten sonra otomatik olarak yeniden oluşturabilir. Bu, senkronizasyonun çalışmaya devam edebilmesi ve verilerin sunucudan silinebilmesi için gereklidir. Ancak daha spesifik olan browser.browsingData.removeCookies(), Senkronizasyon hesabının çerezini temizlemek için kullanılabilir. Bu durumda senkronizasyon duraklatılır.

Önemli: Tarama verilerini kaldırma işlemi, arka planda yoğun bir çalışma gerektirir ve kullanıcının profiline bağlı olarak tamamlanması onlarca saniye sürebilir. Kullanıcılarınızı kaldırma işleminin durumu hakkında güncel tutmak için döndürülen promise'i veya geri çağırmayı kullanmanız gerekir.

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.

browser.browsingData.remove({
  "origins": ["https://www.example.com"]
}, {
  "cacheStorage": true,
  "cookies": true,
  "fileSystems": true,
  "indexedDB": true,
  "localStorage": true,
  "serviceWorkers": true,
  "webSQL": true
}, callback);

Önemli: Çerezler diğer depolama türlerine göre daha geniş kapsamlı olduğundan bir kaynağın çerezleri silindiğinde kaydedilebilir alanın tüm çerezleri silinir. Örneğin, https://www.example.com için verileri sildiğinizde .example.com alan adına sahip çerezler de silinir.

Kaynak türleri

API'lerin seçenekler nesnesine originTypes özelliği ekleyerek hangi kaynak türlerinin etkilenmesi gerektiğini belirtebilirsiniz. Kaynaklar üç kategoriye ayrılır:

• unprotectedWeb, kullanıcıların herhangi bir özel işlem yapmadan ziyaret ettiği web sitelerinin genel durumunu kapsar. originTypes belirtmezseniz API, varsayılan olarak korumasız web kaynaklarındaki verileri kaldırır.
• protectedWeb, barındırılan uygulama olarak yüklenen web kaynaklarını kapsar. Örneğin, Angry Birds'ü yüklediğinizde https://chrome.angrybirds.com kaynağı korunur ve unprotectedWeb kategorisinden kaldırılır. Bu kaynaklar için veri silme işlemini tetiklerken dikkatli olun: Kullanıcılarınızın neyle karşılaşacaklarını bildiklerinden emin olun. Bu işlem, oyun verilerini geri alınamayacak şekilde kaldırır. Kimse domuzcukların küçük evlerini gereğinden fazla yıkmak istemez.
• extension, chrome-extensions: şeması kapsamındaki kaynakları kapsar. Uzantı verilerini kaldırma konusunda da çok dikkatli olmanız gerekir.

Önceki örneği, yalnızca korunan 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;
browser.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);

Uyarı: protectedWeb ve extension kaynak türlerini kullanırken dikkatli olun. Bunlar, uzantınızın kullanıcılar adına veri kaldırdığında ne olacağı konusunda iyi bilgilendirilmemiş kullanıcılarınızı şaşırtabilecek yıkıcı işlemlerdir.

Örnekler

Bu API'yi denemek için chrome-extension-samples deposundan browsingData API örneğini yükleyin.

Türler

DataTypeSet

Bir veri türü grubu. Eksik veri türleri false olarak yorumlanır.

Özellikler

• appcache

  boole isteğe bağlı

  Chrome 152'den itibaren desteği sonlandırıldı

  Appcache desteği kaldırıldı. Bu veri türü yok sayılacak.

  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 Chrome 148'den itibaren browser.*

  Ö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ı

  Chrome 144'ten itibaren desteği sonlandırıldı

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

  Kayıtlı şifreler.

• pluginData

  boole isteğe bağlı

  Chrome 88'den itibaren desteği sonlandırıldı

  Flash desteği kaldırıldı. Bu veri türü yok sayılacak.

  Eklentilerin verileri.

• serverBoundCertificates

  boole isteğe bağlı

  Chrome 76'dan itibaren desteği sonlandırıldı

  Sunucuya bağlı sertifikalar için destek kaldırıldı. Bu veri türü yok sayılacak.

  Sunucuya bağlı sertifikalar.

• serviceWorkers

  boole isteğe bağlı

  Hizmet çalışanları.

• webSQL

  boole isteğe bağlı

  Chrome 152'den itibaren desteği sonlandırıldı

  WebSQL desteği kaldırıldı. Bu veri türü yok sayılacak.

  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 Chrome 148'den itibaren browser.*

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

• originTypes

  isteğe bağlı nesne

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

  • süresini uzatma

    boole isteğe bağlı

    Kullanıcının yüklediği uzantılar ve paketlenmiş uygulamalar (bu konuda _gerçekten_ dikkatli olun).

  • protectedWeb

    boole isteğe bağlı

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

  • unprotectedWeb

    boole isteğe bağlı

    Normal web siteleri.

• origins

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

  Chrome 74 ve sonraki sürümler Chrome 148'den itibaren browser.*

  Mevcut olduğunda yalnızca bu listedeki kaynaklara ait veriler silinir. Yalnızca çerezler, depolama alanı ve önbellek için desteklenir. Çerezler, kaydedilebilir alanın tamamı için temizlenir.

• şu tarihten beri:

  number isteğe bağlı

  Bu tarihte veya bu tarihten sonra toplanan verileri kaldırın. Bu tarih, epoch'tan bu yana geçen milisaniye cinsinden gösterilir (JavaScript Date nesnesinin getTime yöntemiyle erişilebilir). Belirtilmezse varsayılan olarak 0 değerine ayarlanır (bu durumda tüm tarama verileri kaldırılır).

Yöntemler

remove()

browser.browsingData.remove(
  options: RemovalOptions,
  dataToRemove: DataTypeSet,
): 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.

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

removeAppcache()

Chrome 152'den itibaren desteği sonlandırıldı

browser.browsingData.removeAppcache(
  options: RemovalOptions,
): Promise<void>

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

Web sitelerinin AppCache verilerini temizler.

Parametreler

• seçenekler

  RemovalOptions

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

  Web sitelerinin appcache verileri temizlendiğinde çözümlenir.

removeCache()

browser.browsingData.removeCache(
  options: RemovalOptions,
): Promise<void>

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

Parametreler

• seçenekler

  RemovalOptions

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

removeCacheStorage()

Chrome 72 ve sonraki sürümler Chrome 148'den itibaren browser.*

browser.browsingData.removeCacheStorage(
  options: RemovalOptions,
): Promise<void>

Web sitelerinin önbellek depolama verilerini temizler.

Parametreler

• seçenekler

  RemovalOptions

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

removeCookies()

browser.browsingData.removeCookies(
  options: RemovalOptions,
): 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

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

removeDownloads()

browser.browsingData.removeDownloads(
  options: RemovalOptions,
): Promise<void>

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

Parametreler

• seçenekler

  RemovalOptions

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

removeFileSystems()

browser.browsingData.removeFileSystems(
  options: RemovalOptions,
): Promise<void>

Web sitelerinin dosya sistemi verilerini temizler.

Parametreler

• seçenekler

  RemovalOptions

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

removeFormData()

browser.browsingData.removeFormData(
  options: RemovalOptions,
): Promise<void>

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

Parametreler

• seçenekler

  RemovalOptions

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

removeHistory()

browser.browsingData.removeHistory(
  options: RemovalOptions,
): Promise<void>

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

Parametreler

• seçenekler

  RemovalOptions

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

  Tarayıcı geçmişi temizlendiğinde çözümlenir.

removeIndexedDB()

browser.browsingData.removeIndexedDB(
  options: RemovalOptions,
): Promise<void>

Web sitelerinin IndexedDB verilerini temizler.

Parametreler

• seçenekler

  RemovalOptions

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

removeLocalStorage()

browser.browsingData.removeLocalStorage(
  options: RemovalOptions,
): Promise<void>

Web sitelerinin yerel depolama verilerini temizler.

Parametreler

• seçenekler

  RemovalOptions

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

removePasswords()

Chrome 144'ten itibaren desteği sonlandırıldı

browser.browsingData.removePasswords(
  options: RemovalOptions,
): Promise<void>

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

Tarayıcının kayıtlı şifrelerini temizler.

Parametreler

• seçenekler

  RemovalOptions

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

removePluginData()

Chrome 88'den itibaren desteği sonlandırıldı

browser.browsingData.removePluginData(
  options: RemovalOptions,
): Promise<void>

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

Eklentilerin verilerini temizler.

Parametreler

• seçenekler

  RemovalOptions

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

  Eklentilerin verileri temizlendiğinde çözümlenir.

removeServiceWorkers()

Chrome 72 ve sonraki sürümler Chrome 148'den itibaren browser.*

browser.browsingData.removeServiceWorkers(
  options: RemovalOptions,
): Promise<void>

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

Parametreler

• seçenekler

  RemovalOptions

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

removeWebSQL()

Chrome 152'den itibaren desteği sonlandırıldı

browser.browsingData.removeWebSQL(
  options: RemovalOptions,
): Promise<void>

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

Web sitelerinin WebSQL verilerini temizler.

Parametreler

• seçenekler

  RemovalOptions

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

settings()

browser.browsingData.settings(): Promise<object>

"Tarama verilerini temizle" ayarları kullanıcı arayüzünde o anda seçili olan veri türlerini 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.

İadeler

• Promise<object>

  Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*