chrome.browsingData

Açıklama

Bir kullanıcının yerel profilindeki 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. Kodunuz, kullanıcının tarama verilerinin kaldırılması gerekir. Bu zaman damgası, Unix epoch (getTime() yöntemi kullanılarak JavaScript Date nesnesinden alınabilir).

Örneğin, bir kullanıcının geçen haftaya ait tüm tarama verilerini temizlemek için kodu şöyle olur:

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, farklı türde tarama verilerini bir daha spesifik yöntemlerin çağrılarından çok daha hızlıdır. Ancak, yalnızca belirli bir türdeki tarama verilerini (ör. çerezler) temizlemek istiyorsanız daha ayrıntılı yöntemleri, JSON ile dolu bir çağrıya göre 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() çerezi otomatik olarak yeniden oluşturabilir senkronizasyon hesabını temizledikten sonra kurtarın. Bu, Senkronizasyonun çalışmaya devam etmesini ve böylece veriler sonunda sunucudan silinebilir. Ancak ne kadar spesifik chrome.browsingData.removeCookies(), Senkronizasyon hesabı ve Senkronizasyon için çerezi temizlemek üzere kullanılabilir duraklatılacak.

Belirli kaynaklar

Belirli bir kaynağa ait verileri kaldırmak veya bir kaynak grubunu silme işleminden hariç tutmak için şu komutu kullanabilirsiniz: RemovalOptions.origins ve RemovalOptions.excludeOrigins parametreleri. Yalnızca çerezler, önbellek ve depolama (CacheStorage, FileSystems, IndexedDB, LocalStorage, ServiceWorkers ve WebSQL) girin.

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 seçenekleri nesnesine bir originTypes özelliği eklemek, bundan etkilenmeyecek. Kaynaklar üç kategoriye ayrılır:

  • unprotectedWeb, kullanıcıların herhangi bir özel işlem yapmadan ziyaret ettiği web sitelerinin genel durumunu kapsar. eyleme dökülebilir. Bir originTypes belirtmezseniz API varsayılan olarak verileri korumasız olanlardan kaldırır yardımcı olur.
  • protectedWeb, barındırılan uygulamalar olarak yüklenen web kaynaklarını kapsar. Örneğin, Angry Birds'ü yüklemek, https://chrome.angrybirds.com kaynağını korur ve bu etiketi unprotectedWeb kategorisinden kaldırır. Şunların silinmesini tetiklerken dikkatli olun: bu kaynaklara ilişkin veriler: kullanıcılarınızın ne elde edeceklerini bildiğinden emin olun. Bu işlem geri alınamaz. oyun verilerini siler. Kimse ufak domuz evlerini gereğinden fazla boydan yok etmek istemez.
  • extension, chrome-extensions: şeması kapsamındaki kaynakları kapsar. Uzantı verilerini kaldırmak, çok dikkatli olmanız gerekir.

Önceki örneği, yalnızca korunan web sitelerindeki verileri aşağıdaki şekilde kaldıracak ş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 bölümünden browsingData API örneğini yükleyin. depodur.

Türler

DataTypeSet

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

Özellikler

  • uygulama önbelleği

    boole isteğe bağlı

    Web sitelerinin appcaches.

  • ö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 'nı inceleyin.

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

    Saklanan şifreler.

  • pluginData

    boole isteğe bağlı

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

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

    Eklentiler dışı verilerdir.

  • serverBoundCertificates

    boole isteğe bağlı

    Chrome 76'dan bu yana desteği sonlandırıldı

    Sunucuya bağlı sertifikalar desteği kaldırıldı. Bu veri türü yoksayılır.

    Sunucuya bağlı sertifikalar.

  • serviceWorkers

    boole isteğe bağlı

    Service Worker'lar.

  • 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 'nı inceleyin.

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

  • originTypes

    nesne isteğe bağlı

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

    • uzantı

      boole isteğe bağlı

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

  • kaynaklar

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

    Chrome 74 ve sonraki sürümler 'nı inceleyin.

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

  • şu tarihten beri:

    sayı isteğe bağlı

    Dönemden bu yana milisaniye cinsinden temsil edilen, bu tarihte veya sonrasında biriken verileri kaldırın (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 'nı inceleyin.
chrome.browsingData.remove(
  options: RemovalOptions,
  dataToRemove: DataTypeSet,
  callback?: function,
)

Bir kullanıcının profilinde depolanan çeşitli tarama verilerini temizler.

Parametreler

  • seçenekler
  • dataToRemove

    Kaldırılacak veri türleri kümesi.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 96 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

removeAppcache()

Söz 'nı inceleyin.
chrome.browsingData.removeAppcache(
  options: RemovalOptions,
  callback?: function,
)

Web sitelerini temizler önbellek verileri.

Parametreler

  • seçenekler
  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 96 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

removeCache()

Söz 'nı inceleyin.
chrome.browsingData.removeCache(
  options: RemovalOptions,
  callback?: function,
)

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

Parametreler

  • seçenekler
  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 96 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

removeCacheStorage()

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

Web sitelerini temizler verileri önbelleğe alır.

Parametreler

  • seçenekler
  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 96 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

removeCookies()

Söz 'nı inceleyin.
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

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 96 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

removeDownloads()

Söz 'nı inceleyin.
chrome.browsingData.removeDownloads(
  options: RemovalOptions,
  callback?: function,
)

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

Parametreler

  • seçenekler
  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 96 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

removeFileSystems()

Söz 'nı inceleyin.
chrome.browsingData.removeFileSystems(
  options: RemovalOptions,
  callback?: function,
)

Web sitelerini temizler dosya sistemi verileri.

Parametreler

  • seçenekler
  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 96 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

removeFormData()

Söz 'nı inceleyin.
chrome.browsingData.removeFormData(
  options: RemovalOptions,
  callback?: function,
)

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

Parametreler

  • seçenekler
  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 96 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

removeHistory()

Söz 'nı inceleyin.
chrome.browsingData.removeHistory(
  options: RemovalOptions,
  callback?: function,
)

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

Parametreler

  • seçenekler
  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 96 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

removeIndexedDB()

Söz 'nı inceleyin.
chrome.browsingData.removeIndexedDB(
  options: RemovalOptions,
  callback?: function,
)

Web sitelerini temizler IndexedDB verileri.

Parametreler

  • seçenekler
  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 96 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

removeLocalStorage()

Söz 'nı inceleyin.
chrome.browsingData.removeLocalStorage(
  options: RemovalOptions,
  callback?: function,
)

Web sitelerini temizler yerel depolama verileri.

Parametreler

  • seçenekler
  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 96 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

removePasswords()

Söz 'nı inceleyin.
chrome.browsingData.removePasswords(
  options: RemovalOptions,
  callback?: function,
)

Tarayıcının depolanan şifrelerini temizler.

Parametreler

  • seçenekler
  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 96 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

removePluginData()

Söz Chrome 88'den beri desteği sonlandırıldı
chrome.browsingData.removePluginData(
  options: RemovalOptions,
  callback?: function,
)

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

Eklentileri temizler dışı verilerdir.

Parametreler

  • seçenekler
  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 96 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

removeServiceWorkers()

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

Web sitelerini temizler hizmet çalışanları.

Parametreler

  • seçenekler
  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 96 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

removeWebSQL()

Söz 'nı inceleyin.
chrome.browsingData.removeWebSQL(
  options: RemovalOptions,
  callback?: function,
)

Web sitelerini temizler WebSQL verileri.

Parametreler

  • seçenekler
  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 96 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

settings()

Söz 'nı inceleyin.
chrome.browsingData.settings(
  callback?: function,
)

"Tarama verilerini temizle"de hangi veri türlerinin seçili olduğunu raporlar kullanıcı arayüzü. 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.

Parametreler

  • geri çağırma

    işlev isteğe bağlı

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

    (result: object) => void

    • sonuç

      nesne

      • dataRemovalPermitted

        Kaldırılmasına izin verilirse (ör. kurumsal politikaya göre), tüm türler sonuçta true değerleriyle, izin verilmiyorsa false değerleriyle birlikte sonuçta gösterilir.

      • dataToRemove

        Her ikisi de kaldırılmak üzere seçilir ve kaldırılmasına izin verilirse tüm türler true değerleriyle sonuçta yer alır. Aksi takdirde false olur.

      • seçenekler

İadeler

  • Promise&lt;object&gt;

    Chrome 96 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.