chrome.browsingData

refresh date: 2026-09-25 robots: noindex

Açıklama

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

İzinler

browsingData

Manifest

Bu API'yi kullanmak için uzantı manifest dosyasında "browsingData" iznini beyan etmeniz 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 epoch'tan 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 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 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;
chrome.browsingData.removeCookies({
  "since": oneWeekAgo
}, callback);

Kullanıcı verilerini senkronize ediyorsa chrome.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 chrome.browsingData.removeCookies, Senkronizasyon hesabının çerezini temizlemek için kullanılabilir. 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

API'nin seçenekler nesnesine bir originTypes özelliği ekleyerek hangi kaynak türlerinin etkilenmesi gerektiğini belirtebilirsiniz. Şu anda kaynaklar üç kategoriye ayrılmıştı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 lütfen dikkatli olun: Oyun verileri geri alınamayacak şekilde kaldırılacağından kullanıcılarınızın ne elde edeceklerini bildiğinden emin olun. 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;
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 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+

    Ö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

    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

    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()

Taahhüt 
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

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96+

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

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

removeAppcache()

Promise Chrome 152'den itibaren desteği sonlandırıldı
chrome.browsingData.removeAppcache(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

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

Web sitelerinin AppCache verilerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96+

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

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

removeCache()

Taahhüt 
chrome.browsingData.removeCache(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

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

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96+

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

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

removeCacheStorage()

Promise Chrome 72+ 
chrome.browsingData.removeCacheStorage(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Web sitelerinin önbellek depolama verilerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96+

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

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

removeCookies()

Taahhüt 
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

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96+

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

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

removeDownloads()

Taahhüt 
chrome.browsingData.removeDownloads(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

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

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96+

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

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

removeFileSystems()

Taahhüt 
chrome.browsingData.removeFileSystems(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Web sitelerinin dosya sistemi verilerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96+

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

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

removeFormData()

Taahhüt 
chrome.browsingData.removeFormData(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

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

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96+

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

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

removeHistory()

Taahhüt 
chrome.browsingData.removeHistory(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

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

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96+

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

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

removeIndexedDB()

Taahhüt 
chrome.browsingData.removeIndexedDB(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Web sitelerinin IndexedDB verilerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96+

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

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

removeLocalStorage()

Taahhüt 
chrome.browsingData.removeLocalStorage(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Web sitelerinin yerel depolama verilerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96+

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

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

removePasswords()

Promise Chrome 144'ten itibaren desteği sonlandırıldı
chrome.browsingData.removePasswords(
  options: RemovalOptions,
  callback?: function,
): 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

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96+

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

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

removePluginData()

Promise Chrome 88'den itibaren desteği sonlandırıldı
chrome.browsingData.removePluginData(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

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

Eklentilerin verilerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96+

    Eklentilerin verileri temizlendiğinde çözümlenir.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

removeServiceWorkers()

Promise Chrome 72+ 
chrome.browsingData.removeServiceWorkers(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

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

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96+

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

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

removeWebSQL()

Promise Chrome 152'den itibaren desteği sonlandırıldı
chrome.browsingData.removeWebSQL(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

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

Web sitelerinin WebSQL verilerini temizler.

Parametreler

  • seçenekler

    RemovalOptions

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96+

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

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

settings()

Taahhüt 
chrome.browsingData.settings(
  callback?: function,
): 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.

Parametreler

  • callback

    function isteğe bağlı

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

    (result: object) => void

    • sonuç

      nesne

      • dataRemovalPermitted

        DataTypeSet

        Tüm türler, kaldırılmasına izin veriliyorsa (ör. kurumsal politika tarafından) true, izin verilmiyorsa false değerleriyle sonuçta yer alır.

      • dataToRemove

        DataTypeSet

        Tüm türler sonuçta yer alır. Hem kaldırılmak üzere seçilmiş hem de kaldırılmasına izin verilmişse true, aksi takdirde false değerini alır.

      • seçenekler

        RemovalOptions

İadeler

  • Promise<object>

    Chrome 96+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.