chrome.browsingData

설명

권한

매니페스트

이 API를 사용하려면 확장 프로그램 매니페스트에서 'browsingData' 권한을 선언해야 합니다.

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

사용량

이 API의 가장 간단한 사용 사례는 사용자의 인터넷 사용 기록을 삭제하기 위한 시간 기반 메커니즘입니다. 코드는 사용자의 인터넷 사용 기록이 삭제되어야 하는 이전 날짜를 나타내는 타임스탬프를 제공해야 합니다. 이 타임스탬프는 Unix 에포크 (getTime 메서드를 통해 JavaScript Date 객체에서 가져올 수 있음) 이후의 밀리초 단위로 형식이 지정됩니다.

예를 들어 사용자의 지난 주 인터넷 사용 기록을 모두 삭제하려면 다음과 같이 코드를 작성할 수 있습니다.

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 메서드를 사용하면 한 번의 호출로 다양한 유형의 인터넷 사용 기록을 삭제할 수 있으며 더 구체적인 여러 메서드를 호출하는 것보다 훨씬 빠릅니다. 하지만 한 가지 특정 유형의 인터넷 사용 기록 (예: 쿠키)만 삭제하려는 경우 더 세분화된 메서드를 사용하면 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);

사용자가 데이터를 동기화하는 경우 chrome.browsingData.remove는 동기화 계정의 쿠키를 삭제한 후 자동으로 다시 빌드할 수 있습니다. 이는 동기화가 계속 작동하여 결국 서버에서 데이터가 삭제될 수 있게 하기 위함입니다. 그러나 동기화 계정의 쿠키를 삭제하는 데 더 구체적인 chrome.browsingData.removeCookies를 사용할 수 있으며 이 경우 동기화가 일시중지됩니다.

특정 출처

특정 출처의 데이터를 삭제하거나 출처 집합을 삭제 대상에서 제외하려면 RemovalOptions.origins 및 RemovalOptions.excludeOrigins 매개변수를 사용하면 됩니다. 쿠키, 캐시, 저장소 (CacheStorage, FileSystems, IndexedDB, LocalStorage, ServiceWorkers, WebSQL)에만 적용할 수 있습니다.

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

출처 유형

API의 옵션 객체에 originTypes 속성을 추가하면 적용해야 할 출처 유형을 지정할 수 있습니다. 현재 출처는 다음 세 가지 카테고리로 구분됩니다.

• unprotectedWeb는 사용자가 특별한 조치를 취하지 않고 방문하는 웹사이트의 일반적인 사례를 처리합니다. originTypes를 지정하지 않으면 API는 기본적으로 보호되지 않는 웹 출처에서 데이터를 삭제합니다.
• protectedWeb는 호스팅된 애플리케이션으로 설치된 웹 출처를 포함합니다. 예를 들어 Angry Birds를 설치하면 출처 https://chrome.angrybirds.com가 보호되고 unprotectedWeb 카테고리에서 삭제됩니다. 이러한 출처의 데이터 삭제를 트리거할 때는 주의해야 합니다. 게임 데이터가 삭제되므로 취소할 수 없는 결과를 사용자에게 알려야 합니다. 조그만 돼지 집을 필요 이상으로 자주 두드리고 싶어 하는 사람은 없습니다.
• extension는 chrome-extensions: 스키마 아래의 출처를 포함합니다. 다시 말하지만 확장 프로그램 데이터를 삭제하는 것은 매우 주의해야 합니다.

보호된 웹사이트의 데이터만 삭제하도록 이전 예를 조정하여 다음과 같이 할 수 있습니다.

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

예

이 API를 사용하려면 chrome-extension-samples 저장소의 browsingData API 예를 설치하세요.

chrome.browsingData.remove(
  options: RemovalOptions,
  dataToRemove: DataTypeSet,
  callback?: function,
)

chrome.browsingData.removeAppcache(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removeCache(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removeCacheStorage(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removeCookies(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removeDownloads(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removeFileSystems(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removeFormData(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removeHistory(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removeIndexedDB(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removeLocalStorage(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removePasswords(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removePluginData(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removeServiceWorkers(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.removeWebSQL(
  options: RemovalOptions,
  callback?: function,
)

chrome.browsingData.settings(
  callback?: function,
)