chrome.browsingData

Açıklama

İzinler

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 (JavaScript Date nesnesinden getTime() yöntemi kullanılarak 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ının çerezini otomatik olarak yeniden oluşturabilir. Bu, senkronizasyonun çalışmaya devam etmesini sağlamak ve böylece 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.

Belirli kaynaklar

Belirli bir kaynağa ait 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);

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 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 işlemi de dikkatli olmanız gereken bir konudur.

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

Örnekler

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

chrome.browsingData.remove(
  options: RemovalOptions,
  dataToRemove: DataTypeSet,
): Promise<void>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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