chrome.browsingData

Açıklama

Kullanıcının yerel profilinden 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. Kodunuzda, kullanıcının tarama verilerinin kaldırılması gereken geçmiş tarihi belirten bir zaman damgası bulunmalıdır. Bu zaman damgası, Unix döneminin başlangıcından bu yana geçen milisaniye sayısı olarak biçimlendirilir (bu zaman damgası, 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;
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ızı sağlar. Bu yöntem, birden fazla spesifik yöntemi çağırmaktan çok daha hızlıdır. Bununla birlikte, 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(), çerez temizlendikten sonra Senkronizasyon hesabı için çerezi otomatik olarak yeniden oluşturabilir. Bu işlem, Senkronizasyonun çalışmaya devam etmesini ve böylece verilerin sunucudan silinmesini sağlar. Ancak, Senkronizasyon hesabının çerezini temizlemek için daha spesifik olan chrome.browsingData.removeCookies() 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) 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

APIs options nesnesine bir originTypes özelliği eklemek, hangi kaynak türlerinin etkilenmesi gerektiğini belirtmenize olanak tanır. Kaynaklar üç kategoriye ayrılır:

  • unprotectedWeb, kullanıcıların herhangi bir özel işlem yapmadan ziyaret ettiği web siteleriyle ilgili genel durumu 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üklenmiş web kaynaklarını kapsar. Örneğin, Angry Birds yüklendiğinde https://chrome.angrybirds.com kaynağı korunur ve unprotectedWeb kategorisinden kaldırılır. Bu kaynaklardan elde edilen verilerin silinmesini tetiklerken dikkatli olun: Oyun verilerinin geri alınamayacak şekilde kaldırılmasına neden olacağından, kullanıcılarınızın sunulanları bildiklerinden emin olun. Kimse küçük domuz evlerini sık sık yıkmak istemez.
  • extension, chrome-extensions: şeması kapsamındaki kaynakları kapsar. Uzantı verilerini kaldırırken yine çok dikkat etmeniz gerekir.

Önceki örneği, korunan web sitelerinden yalnızca verileri kaldıracak şekilde aşağıdaki ş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 dizi veri türü. Eksik veri türleri false olarak yorumlanır.

Özellikler

  • uygulama önbelleği

    boole isteğe bağlı

    Web sitelerinin appcache'leri.

  • ö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ı 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 itibaren kullanımdan kaldırıldı

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

    Eklentilerle ilgili veriler.

  • serverBoundCertificates

    boole isteğe bağlı

    Chrome 76 sürümünden itibaren 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

    boole isteğe bağlı

    Service Workers'ı seçin.

  • 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

    Mevcut olduğunda bu listedeki kaynaklara ait veriler silme işleminden hariç tutulur. origins ile birlikte kullanılamaz. Yalnızca çerezler, depolama alanı ve önbellek için desteklenir. Çerezler, kaydedilebilir alan adının tamamı için hariç tutulur.

  • originTypes

    isteğe bağlı

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

    • uzantı

      boole isteğe bağlı

      Bir kullanıcının yüklediği uzantılar ve paket uygulamalar (_gerçekten_ 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.

  • başlangıç noktaları

    string[] isteğe bağlı

    Chrome 74 ve sonraki sürümler

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

  • şu tarihten beri:

    numara isteğe bağlı

    Bu tarihte veya daha sonra biriken verileri kaldırın. Dönemden itibaren milisaniye cinsinden gösterilir (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 türlerdeki tarama verilerini temizler.

Parametreler

  • seçenekler
  • dataToRemove

    Kaldırılacak veri türü grubu.

  • geri çağırma

    Functions (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 geriye dönük uyumluluk için geri çağırmalar 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
  • geri çağırma

    Functions (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 geriye dönük uyumluluk için geri çağırmalar 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
  • geri çağırma

    Functions (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 geriye dönük uyumluluk için geri çağırmalar 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()

Söz Chrome 72 ve sonraki sürümleri
chrome.browsingData.removeCacheStorage(
  options: RemovalOptions,
  callback?: function,
)

Web sitelerinin önbellek depolama verilerini temizler.

Parametreler

  • seçenekler
  • geri çağırma

    Functions (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 geriye dönük uyumluluk için geri çağırmalar 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
  • geri çağırma

    Functions (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 geriye dönük uyumluluk için geri çağırmalar 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 dosya listesini temizler (indirilen dosyaların kendisini değil).

Parametreler

  • seçenekler
  • geri çağırma

    Functions (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 geriye dönük uyumluluk için geri çağırmalar 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
  • geri çağırma

    Functions (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 geriye dönük uyumluluk için geri çağırmalar 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 (otomatik doldurma) temizler.

Parametreler

  • seçenekler
  • geri çağırma

    Functions (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 geriye dönük uyumluluk için geri çağırmalar 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ı geçmişini temizler.

Parametreler

  • seçenekler
  • geri çağırma

    Functions (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 geriye dönük uyumluluk için geri çağırmalar 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
  • geri çağırma

    Functions (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 geriye dönük uyumluluk için geri çağırmalar 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
  • geri çağırma

    Functions (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 geriye dönük uyumluluk için geri çağırmalar 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 depolanmış şifrelerini temizler.

Parametreler

  • seçenekler
  • geri çağırma

    Functions (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 geriye dönük uyumluluk için geri çağırmalar 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()

Söz Chrome 88'den itibaren kullanımdan kaldırıldı
chrome.browsingData.removePluginData(
  options: RemovalOptions,
  callback?: function,
)

Flash desteği kaldırılmıştır. Bu işlevin hiçbir etkisi yoktur.

Eklentilerin verilerini temizler.

Parametreler

  • seçenekler
  • geri çağırma

    Functions (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 geriye dönük uyumluluk için geri çağırmalar 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()

Söz Chrome 72 ve sonraki sürümleri
chrome.browsingData.removeServiceWorkers(
  options: RemovalOptions,
  callback?: function,
)

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

Parametreler

  • seçenekler
  • geri çağırma

    Functions (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 geriye dönük uyumluluk için geri çağırmalar 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
  • geri çağırma

    Functions (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 geriye dönük uyumluluk için geri çağırmalar 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 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

  • geri çağırma

    Functions (isteğe bağlı)

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

    (result: object) => void

    • sonuç

      nesne

      • dataRemovalPermitted

        Tüm türler sonuçta, kaldırılmasına izin veriliyorsa true ve izin verilmiyorsa false değerleriyle görüntülenir.

      • dataToRemove

        Tüm türler sonuçta, her ikisi de kaldırılmak üzere seçilir ve kaldırılmasına izin verilirse true değerleriyle görüntülenir; aksi takdirde false.

      • seçenekler

İlerlemeler

  • Promise<object>

    Chrome 96 ve sonraki sürümler

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