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.removeLocalStorage() (en-US)

Clears any local storage created by websites.

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.

브라우저 호환성

BCD tables only load in the browser

Example extensions

Note: 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.

// Copyright 2015 The Chromium Authors. All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
// met:
//
//    * Redistributions of source code must retain the above copyright
// notice, this list of conditions and the following disclaimer.
//    * Redistributions in binary form must reproduce the above
// copyright notice, this list of conditions and the following disclaimer
// in the documentation and/or other materials provided with the
// distribution.
//    * Neither the name of Google Inc. nor the names of its
// contributors may be used to endorse or promote products derived from
// this software without specific prior written permission.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.