browsingData

WebExtensions 을 통해 사용자가 브라우저를 사용하는 동안 축적된 데이터를 삭제할 수 있는 기능을 제공합니다.

browsingData API는 브라우징 데이터를 다음과 같은 타입으로 구분합니다:

  • 브라우저 캐시
  • 쿠키
  • 다운로드
  • 히스토리
  • 플러그인 데이터
  • 저장된 폼 데이터
  • 저장된 비밀번호saved passwords

You can use the browsingData.remove() (en-US) function to remove any combination of these types. There are also dedicated functions to remove each particular type of data, such as removePasswords() (en-US), removeHistory() (en-US) and so on.

All the browsingData.remove[X]() functions take a browsingData.RemovalOptions (en-US) object, which you can use to control two further aspects of data removal:

  • how far back in time to remove data
  • whether to remove data only from normal web pages, or also from hosted web apps and add-ons. Note that this option is not yet supported in Firefox.

Finally, this API gives you a browsingData.settings() (en-US) function that gives you the current value of the settings for the browser's built-in "Clear History" feature.

To use this API you must have the "browsingData" API permission.

Types

browsingData.DataTypeSet (en-US)
Object used to specify the type of data to remove: for example, history, downloads, passwords, and so on.
browsingData.RemovalOptions (en-US)
Object used to specify how far back in time to remove data, and whether to remove data added through normal web browsing, by hosted apps, or by add-ons.

Methods

browsingData.remove() (en-US)
Removes browsing data for the data types specified.
browsingData.removeCache() (en-US)
Clears the browser's cache.
browsingData.removeCookies() (en-US)
Removes cookies.
browsingData.removeDownloads() (en-US)
Removes the list of downloaded files.
browsingData.removeFormData() (en-US)
Clears saved form data.
browsingData.removeHistory() (en-US)
Clears the browser's history.
browsingData.removePasswords() (en-US)
Clears saved passwords.
browsingData.removePluginData() (en-US)
Clears data associated with plugins.
browsingData.settings() (en-US)
Gets the current value of settings in the browser's "Clear History" feature.

Browser compatibility

BCD tables only load in the browser

Example extensions

Acknowledgements

This API is based on Chromium's chrome.browsingData API.

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.