chrome.browsingData

refresh date: 2026-09-25 robots: noindex

Deskripsi

Gunakan chrome.browsingData API untuk menghapus data penjelajahan dari profil lokal pengguna.

Izin

browsingData

Manifes

Anda harus mendeklarasikan izin "browsingData" di manifes ekstensi untuk menggunakan API ini.

{
  "name": "My extension",
  ...
  "permissions": [
    "browsingData",
  ],
  ...
}

Penggunaan

Kasus penggunaan paling sederhana untuk API ini adalah mekanisme berbasis waktu untuk menghapus data penjelajahan pengguna. Kode Anda harus memberikan stempel waktu yang menunjukkan tanggal historis setelah data penjelajahan pengguna harus dihapus. Stempel waktu ini diformat sebagai jumlah milidetik sejak epoch Unix (yang dapat diambil dari objek Date JavaScript melalui metode getTime).

Misalnya, untuk menghapus semua data penjelajahan pengguna dari minggu lalu, Anda dapat menulis kode seperti berikut:

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

Metode chrome.browsingData.remove memungkinkan Anda menghapus berbagai jenis data penjelajahan dengan satu panggilan, dan akan jauh lebih cepat daripada memanggil beberapa metode yang lebih spesifik. Namun, jika Anda hanya ingin menghapus satu jenis data penjelajahan tertentu (misalnya, cookie), metode yang lebih terperinci menawarkan alternatif yang dapat dibaca untuk panggilan yang diisi dengan JSON.

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

Jika pengguna menyinkronkan datanya, chrome.browsingData.remove dapat otomatis membuat ulang cookie untuk akun Sinkronisasi setelah menghapusnya. Hal ini untuk memastikan bahwa Sinkronisasi dapat terus berfungsi, sehingga data pada akhirnya dapat dihapus di server. Namun, chrome.browsingData.removeCookies yang lebih spesifik dapat digunakan untuk menghapus cookie untuk akun Sinkronisasi, dan Sinkronisasi akan dijeda dalam kasus ini.

Penting: Menghapus data penjelajahan melibatkan banyak pekerjaan berat di latar belakang, dan dapat memerlukan waktu puluhan detik untuk menyelesaikannya, bergantung pada profil pengguna. Anda harus menggunakan mekanisme callback untuk terus memberi tahu pengguna tentang status penghapusan.

Asal Tertentu

Untuk menghapus data untuk origin tertentu atau mengecualikan sekumpulan origin dari penghapusan, Anda dapat menggunakan parameter RemovalOptions.origins dan RemovalOptions.excludeOrigins. Kebijakan ini hanya dapat diterapkan ke cookie, cache, dan penyimpanan (CacheStorage, FileSystems, IndexedDB, LocalStorage, ServiceWorkers, dan WebSQL).

chrome.browsingData.remove({
  "origins": ["https://www.example.com"]
}, {
  "cacheStorage": true,
  "cookies": true,
  "fileSystems": true,
  "indexedDB": true,
  "localStorage": true,
  "serviceWorkers": true,
  "webSQL": true
}, callback);

Penting: Karena cookie memiliki cakupan yang lebih luas daripada jenis penyimpanan lainnya, menghapus cookie untuk origin akan menghapus semua cookie domain yang dapat didaftarkan. Misalnya, menghapus data untuk https://www.example.com juga akan menghapus cookie dengan domain .example.com.

Jenis Origin

Menambahkan properti originTypes ke objek opsi API memungkinkan Anda menentukan jenis origin yang akan terpengaruh. Saat ini, origin dibagi menjadi tiga kategori:

• unprotectedWeb mencakup kasus umum situs yang dikunjungi pengguna tanpa melakukan tindakan khusus. Jika Anda tidak menentukan originTypes, API akan secara default menghapus data dari origin web yang tidak dilindungi.
• protectedWeb mencakup origin web yang telah diinstal sebagai aplikasi yang dihosting. Misalnya, menginstal Angry Birds akan melindungi origin https://chrome.angrybirds.com, dan menghapusnya dari kategori unprotectedWeb. Berhati-hatilah saat memicu penghapusan data untuk origin ini: pastikan pengguna Anda mengetahui apa yang akan terjadi, karena tindakan ini akan menghapus data game mereka secara permanen. Tidak ada yang ingin merobohkan rumah babi kecil lebih sering daripada yang diperlukan.
• extension mencakup origin dalam skema chrome-extensions:. Sekali lagi, Anda harus sangat berhati-hati saat menghapus data ekstensi.

Kita dapat menyesuaikan contoh sebelumnya untuk hanya menghapus data dari situs yang dilindungi sebagai berikut:

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

Serius: Berhati-hatilah dengan protectedWeb dan extension. Ini adalah operasi destruktif yang akan membuat pengguna Anda mengirim email kemarahan jika mereka tidak diberi tahu dengan baik tentang apa yang akan terjadi saat ekstensi Anda menghapus data atas nama mereka.

Contoh

Untuk mencoba API ini, instal contoh browsingData API dari repositori chrome-extension-samples.

Jenis

DataTypeSet

Satu set jenis data. Jenis data yang tidak ada akan ditafsirkan sebagai false.

Properti

• appcache

  boolean opsional

  Tidak digunakan lagi sejak Chrome 152

  Dukungan untuk appcache telah dihapus. Jenis data ini akan diabaikan.

  Appcache situs.

• cache

  boolean opsional

  Cache browser.

• cacheStorage

  boolean opsional

  Chrome 72+

  Penyimpanan cache

• cookie

  boolean opsional

  Cookie browser.

• download

  boolean opsional

  Daftar download browser.

• fileSystems

  boolean opsional

  Sistem file situs.

• formData

  boolean opsional

  Data formulir yang disimpan browser.

• sejarah

  boolean opsional

  Histori browser.

• indexedDB

  boolean opsional

  Data IndexedDB situs.

• localStorage

  boolean opsional

  Data penyimpanan lokal situs.

• sandi

  boolean opsional

  Tidak digunakan lagi sejak Chrome 144

  Dukungan untuk penghapusan sandi melalui ekstensi telah dihapus. Jenis data ini akan diabaikan.

  Sandi tersimpan.

• pluginData

  boolean opsional

  Tidak digunakan lagi sejak Chrome 88

  Dukungan untuk Flash telah dihapus. Jenis data ini akan diabaikan.

  Data plugin.

• serverBoundCertificates

  boolean opsional

  Tidak digunakan lagi sejak Chrome 76

  Dukungan untuk sertifikat terikat server telah dihapus. Jenis data ini akan diabaikan.

  Sertifikat terikat server.

• serviceWorkers

  boolean opsional

  Service Worker.

• webSQL

  boolean opsional

  Tidak digunakan lagi sejak Chrome 152

  Dukungan untuk WebSQL telah dihapus. Jenis data ini akan diabaikan.

  Data WebSQL situs.

RemovalOptions

Opsi yang menentukan dengan tepat data apa yang akan dihapus.

Properti

• excludeOrigins

  string[] opsional

  Chrome 74+

  Jika ada, data untuk origin dalam daftar ini tidak akan dihapus. Tidak dapat digunakan bersama dengan origins. Hanya didukung untuk cookie, penyimpanan, dan cache. Cookie dikecualikan untuk seluruh domain yang dapat didaftarkan.

• originTypes

  objek opsional

  Objek yang propertinya menentukan jenis origin yang harus dihapus. Jika objek ini tidak ditentukan, objek ini akan ditetapkan secara default untuk hanya menghapus origin "tidak dilindungi". Pastikan Anda benar-benar ingin menghapus data aplikasi sebelum menambahkan 'protectedWeb' atau 'extensions'.

  • extension

    boolean opsional

    Ekstensi dan aplikasi dalam paket yang telah diinstal pengguna (berhati-hatilah!).

  • protectedWeb

    boolean opsional

    Situs yang telah diinstal sebagai aplikasi yang dihosting (hati-hati!).

  • unprotectedWeb

    boolean opsional

    Situs normal.

• origins

  [string, ...string[]] opsional

  Chrome 74+

  Jika ada, hanya data untuk origin dalam daftar ini yang akan dihapus. Hanya didukung untuk cookie, penyimpanan, dan cache. Cookie dihapus untuk seluruh domain yang dapat didaftarkan.

• sejak

  number opsional

  Hapus data yang diakumulasikan pada atau setelah tanggal ini, yang dinyatakan dalam milidetik sejak epoch (dapat diakses melalui metode getTime dari objek Date JavaScript). Jika tidak ada, setelan defaultnya adalah 0 (yang akan menghapus semua data penjelajahan).

Metode

remove()

Promise

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

Menghapus berbagai jenis data penjelajahan yang disimpan di profil pengguna.

Parameter

• opsi

  RemovalOptions

• dataToRemove

  DataTypeSet

  Kumpulan jenis data yang akan dihapus.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  () => void

Hasil

• Promise<void>

  Chrome 96+

  Me-resolve saat penghapusan telah selesai.

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

removeAppcache()

Promise Tidak digunakan lagi sejak Chrome 152

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

Dukungan untuk appcache telah dihapus. Fungsi ini tidak berpengaruh.

Menghapus data appcache situs.

Parameter

• opsi

  RemovalOptions

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  () => void

Hasil

• Promise<void>

  Chrome 96+

  Menyelesaikan saat data appcache situs telah dihapus.

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

removeCache()

Promise

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

Menghapus cache browser.

Parameter

• opsi

  RemovalOptions

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  () => void

Hasil

• Promise<void>

  Chrome 96+

  Menyelesaikan saat cache browser telah dihapus.

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

removeCacheStorage()

Promise Chrome 72+

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

Menghapus data penyimpanan cache situs.

Parameter

• opsi

  RemovalOptions

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  () => void

Hasil

• Promise<void>

  Chrome 96+

  Diselesaikan saat penyimpanan cache situs telah dihapus.

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

removeCookies()

Promise

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

Menghapus cookie browser dan sertifikat terikat server yang diubah dalam jangka waktu tertentu.

Parameter

• opsi

  RemovalOptions

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  () => void

Hasil

• Promise<void>

  Chrome 96+

  Diselesaikan saat cookie browser dan sertifikat yang terikat server telah dihapus.

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

removeDownloads()

Promise

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

Menghapus daftar file yang didownload di browser (bukan file yang didownload itu sendiri).

Parameter

• opsi

  RemovalOptions

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  () => void

Hasil

• Promise<void>

  Chrome 96+

  Menyelesaikan masalah saat daftar file yang didownload di browser telah dihapus.

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

removeFileSystems()

Promise

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

Menghapus data sistem file situs.

Parameter

• opsi

  RemovalOptions

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  () => void

Hasil

• Promise<void>

  Chrome 96+

  Menyelesaikan masalah saat sistem file situs telah dihapus.

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

removeFormData()

Promise

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

Menghapus data formulir yang disimpan browser (isi otomatis).

Parameter

• opsi

  RemovalOptions

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  () => void

Hasil

• Promise<void>

  Chrome 96+

  Menyelesaikan saat data formulir browser telah dihapus.

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

removeHistory()

Promise

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

Menghapus histori browser.

Parameter

• opsi

  RemovalOptions

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  () => void

Hasil

• Promise<void>

  Chrome 96+

  Me-resolve saat histori browser telah dihapus.

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

removeIndexedDB()

Promise

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

Menghapus data IndexedDB situs.

Parameter

• opsi

  RemovalOptions

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  () => void

Hasil

• Promise<void>

  Chrome 96+

  Menyelesaikan saat data IndexedDB situs telah dihapus.

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

removeLocalStorage()

Promise

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

Menghapus data penyimpanan lokal situs.

Parameter

• opsi

  RemovalOptions

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  () => void

Hasil

• Promise<void>

  Chrome 96+

  Diselesaikan saat penyimpanan lokal situs telah dihapus.

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

removePasswords()

Promise Tidak digunakan lagi sejak Chrome 144

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

Dukungan untuk penghapusan sandi melalui ekstensi telah dihapus. Fungsi ini tidak berpengaruh.

Menghapus sandi tersimpan di browser.

Parameter

• opsi

  RemovalOptions

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  () => void

Hasil

• Promise<void>

  Chrome 96+

  Me-resolve saat sandi browser telah dihapus.

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

removePluginData()

Promise Tidak digunakan lagi sejak Chrome 88

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

Dukungan untuk Flash telah dihapus. Fungsi ini tidak berpengaruh.

Menghapus data plugin.

Parameter

• opsi

  RemovalOptions

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  () => void

Hasil

• Promise<void>

  Chrome 96+

  Me-resolve saat data plugin telah dihapus.

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

removeServiceWorkers()

Promise Chrome 72+

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

Menghapus pekerja layanan situs.

Parameter

• opsi

  RemovalOptions

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  () => void

Hasil

• Promise<void>

  Chrome 96+

  Diselesaikan saat pekerja layanan situs telah dihapus.

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

removeWebSQL()

Promise Tidak digunakan lagi sejak Chrome 152

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

Dukungan untuk WebSQL telah dihapus. Fungsi ini tidak berpengaruh.

Menghapus data WebSQL situs.

Parameter

• opsi

  RemovalOptions

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  () => void

Hasil

• Promise<void>

  Chrome 96+

  Diselesaikan saat database WebSQL situs telah dihapus.

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

settings()

Promise

chrome.browsingData.settings(
  callback?: function,
): Promise<object>

Melaporkan jenis data yang saat ini dipilih di UI setelan 'Hapus data penjelajahan'. Catatan: beberapa jenis data yang disertakan dalam API ini tidak tersedia di UI setelan, dan beberapa setelan UI mengontrol lebih dari satu jenis data yang tercantum di sini.

Parameter

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (result: object) => void

  • hasil

    objek

    • dataRemovalPermitted

      DataTypeSet

      Semua jenis akan ada dalam hasil, dengan nilai true jika diizinkan untuk dihapus (misalnya, oleh kebijakan perusahaan) dan false jika tidak.

    • dataToRemove

      DataTypeSet

      Semua jenis akan ada dalam hasil, dengan nilai true jika keduanya dipilih untuk dihapus dan diizinkan untuk dihapus, jika tidak, false.

    • opsi

      RemovalOptions

Hasil

• Promise<object>

  Chrome 96+

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.