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

Bu API'yi kullanmak için "browsingData" iznini uzantı manifestinde belirtmeniz 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 sıfır zamanından bu yana geçen milisaniye sayısı olarak biçimlendirilir (bu sayı, Date yöntemi kullanılarak bir JavaScript getTime() nesnesinden 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 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.

Önemli: Tarama verilerinin kaldırılması, arka planda önemli ölçüde işlem yapılmasını 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 bilgilendirmek için döndürülen sözü veya geri çağırmayı kullanmanız gerekir.

Belirli kaynaklar

Belirli bir kaynakla ilgili 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);

Önemli: Çerezler diğer depolama türlerinden daha geniş kapsamlı olduğundan bir kaynak için çerezleri sildiğinizde, kaydedilebilir alanın tüm çerezleri silinir. Örneğin, https://www.example.com alanına ait verileri sildiğinizde .example.com alanına sahip çerezler de silinir.

Kaynak türleri

API seçenekleri 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. 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. 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 konusunda da çok dikkatli olmanız gerekir.

Ö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);

Uyarı: protectedWeb ve extension kaynak türleri konusunda dikkatli olun. Bu işlemler, kullanıcılarınızın adına veri kaldırma işlemleri gerçekleştiren uzantınızın ne yapacağı konusunda yeterli bilgiye sahip değillerse onları şaşırtabilecek kalıcı işlemlerdir.

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

  Kullanımdan kaldırıldı

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

  Kaydedilen şifreler

• pluginData

  boolean isteğe bağlı

  Chrome 88'den beri kullanımdan kaldırıldı

  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

Tam olarak hangi verilerin 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, 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'dır (bu da tüm tarama verilerini kaldırır).

Yöntemler

remove()

chrome.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

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

removeAppcache()

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

Web sitelerinin uygulama önbelleği verilerini temizler.

Parametreler

• seçenekler

  RemovalOptions

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler

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

removeCache()

chrome.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

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

removeCacheStorage()

Chrome 72 veya daha yeni bir sürüm

chrome.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

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

removeCookies()

chrome.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

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

removeDownloads()

chrome.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

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

removeFileSystems()

chrome.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

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

removeFormData()

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

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

Parametreler

• seçenekler

  RemovalOptions

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler

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

removeHistory()

chrome.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

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

removeIndexedDB()

chrome.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

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

removeLocalStorage()

chrome.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

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

removePasswords()

Kullanımdan kaldırıldı

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

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler

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

removePluginData()

Chrome 88'den beri kullanımdan kaldırıldı

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

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

Eklentilerin verilerini temizler.

Parametreler

• seçenekler

  RemovalOptions

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler

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

removeServiceWorkers()

Chrome 72 veya daha yeni bir sürüm

chrome.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

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

removeWebSQL()

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

Web sitelerinin WebSQL verilerini temizler.

Parametreler

• seçenekler

  RemovalOptions

İadeler

• Promise<void>

  Chrome 96 ve sonraki sürümler

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

settings()

chrome.browsingData.settings(): 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.

İadeler

• Promise<object>

  Chrome 96 ve sonraki sürümler