chrome.browsingData

설명

chrome.browsingData API를 사용하여 사용자의 로컬 프로필에서 인터넷 사용 기록을 삭제합니다.

권한

browsingData

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

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

개념 및 사용법

이 API의 가장 간단한 사용 사례는 사용자의 인터넷 사용 기록을 삭제하기 위한 시간 기반 메커니즘입니다. 코드는 사용자의 인터넷 사용 기록을 삭제해야 합니다. 이 타임스탬프는 유닉스 에포크 (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);

드림

중요: 쿠키는 다른 유형의 저장소보다 더 광범위하게 범위가 지정되므로 원본에서 등록 가능한 도메인의 모든 쿠키를 삭제합니다. 예를 들어 https://www.example.com에서 도메인이 .example.com인 쿠키도 삭제합니다.

출처 유형

originTypes 속성을 API 옵션 객체에 추가하면 영향을 미쳐야 합니다. 출처는 다음 세 가지 카테고리로 구분됩니다.

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

드림

경고: protectedWeb 및 extension 출처 유형에 주의하세요. 이것은 파괴적인 작전이며 사용자가 게임에서 예상할 수 있는 사항에 대해 잘 모르는 경우 확장 프로그램이 자동으로 데이터를 삭제합니다.

예

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

유형

DataTypeSet

데이터 유형 집합입니다. 누락된 데이터 유형은 false로 해석됩니다.

속성

• 앱 캐시

  불리언 선택사항

  웹사이트 합니다.

• 캐시

  불리언 선택사항

  브라우저의 캐시입니다.

• cacheStorage

  불리언 선택사항

  Chrome 72 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  캐시 스토리지

• 쿠키

  불리언 선택사항

  브라우저의 쿠키입니다.

• 다운로드

  불리언 선택사항

  브라우저의 다운로드 목록입니다.

• fileSystems

  불리언 선택사항

  웹사이트 파일 시스템입니다.

• formData

  불리언 선택사항

  브라우저에 저장된 양식 데이터입니다.

• 기록

  불리언 선택사항

  브라우저의 방문 기록입니다.

• indexedDB

  불리언 선택사항

  웹사이트 IndexedDB 데이터.

• localStorage

  불리언 선택사항

  웹사이트 저장할 수 있습니다

• 비밀번호

  불리언 선택사항

  저장된 비밀번호.

• pluginData

  불리언 선택사항

  <ph type="x-smartling-placeholder"></ph> Chrome 88 이후 지원 중단됨

  플래시 지원이 중단되었습니다. 이 데이터 유형은 무시됩니다.

  플러그인 데이터를 수집하는 데 사용됩니다

• serverBoundCertificates

  불리언 선택사항

  <ph type="x-smartling-placeholder"></ph> Chrome 76 이후 지원 중단됨

  서버 결합 인증서에 대한 지원이 삭제되었습니다. 이 데이터 유형은 무시됩니다.

  서버 결합 인증서

• serviceWorkers

  불리언 선택사항

  서비스 워커

• webSQL

  불리언 선택사항

  웹사이트 WebSQL 데이터

RemovalOptions

삭제할 데이터를 정확하게 결정하는 옵션입니다.

속성

• excludeOrigins

  string[] 선택사항

  Chrome 74 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  있는 경우 이 목록에 있는 출처의 데이터는 삭제에서 제외됩니다. origins과(와) 함께 사용할 수 없습니다. 쿠키, 저장용량, 캐시에 대해서만 지원됩니다. 등록 가능한 전체 도메인의 쿠키가 제외됩니다.

• originTypes

  객체(선택사항)

  속성으로 지워야 하는 출발지 유형을 지정하는 객체입니다. 이 객체를 지정하지 않으면 기본적으로 '보호되지 않음'만 삭제됩니다. 있습니다. 'ProtectedWeb'을 추가하기 전에 정말 애플리케이션 데이터를 삭제할 것인지 확인하세요. '확장 프로그램'이라고 합니다.

  • 확장 프로그램

    불리언 선택사항

    사용자가 설치한 확장 프로그램 및 패키지 애플리케이션은 _반드시_ 주의를 기울여야 합니다.

  • protectedWeb

    불리언 선택사항

    호스팅된 애플리케이션으로 설치된 웹사이트는 주의하세요.

  • unprotectedWeb

    불리언 선택사항

    일반 웹사이트

• origins

  [string, ...string[]] 선택사항

  Chrome 74 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  있는 경우 이 목록에 있는 출처의 데이터만 삭제됩니다. 쿠키, 저장용량, 캐시에 대해서만 지원됩니다. 등록 가능한 전체 도메인의 쿠키가 삭제되었습니다.

• 이후

  숫자 선택사항

  에포크 이후 밀리초로 표시되는 이 날짜 또는 그 이후에 누적된 데이터를 삭제합니다 (JavaScript Date 객체의 getTime 메서드를 통해 액세스 가능). 없는 경우 기본값은 0입니다 (모든 인터넷 사용 기록 삭제).

메서드

remove()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

사용자 프로필에 저장된 다양한 유형의 인터넷 사용 기록을 삭제합니다.

매개변수

• 옵션

  RemovalOptions

• dataToRemove

  DataTypeSet

  삭제할 데이터 유형 집합입니다.

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

removeAppcache()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

웹사이트 삭제 appcache 데이터입니다.

매개변수

• 옵션

  RemovalOptions

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

removeCache()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

브라우저의 캐시를 삭제합니다.

매개변수

• 옵션

  RemovalOptions

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

removeCacheStorage()

<ph type="x-smartling-placeholder"></ph> 프로미스 Chrome 72 이상

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

웹사이트 삭제 캐시하는 것이 좋습니다

매개변수

• 옵션

  RemovalOptions

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

removeCookies()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

특정 기간 내에 수정된 브라우저의 쿠키 및 서버 결합 인증서를 삭제합니다.

매개변수

• 옵션

  RemovalOptions

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

removeDownloads()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

다운로드한 파일 자체가 아닌 브라우저의 다운로드한 파일 목록을 삭제합니다.

매개변수

• 옵션

  RemovalOptions

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

removeFileSystems()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

웹사이트 삭제 파일 시스템 데이터입니다.

매개변수

• 옵션

  RemovalOptions

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

removeFormData()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

브라우저에 저장된 양식 데이터를 지웁니다 (자동 완성).

매개변수

• 옵션

  RemovalOptions

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

removeHistory()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

브라우저의 기록을 지웁니다.

매개변수

• 옵션

  RemovalOptions

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

removeIndexedDB()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

웹사이트 삭제 IndexedDB 데이터.

매개변수

• 옵션

  RemovalOptions

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

removeLocalStorage()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

웹사이트 삭제 저장할 수 있습니다

매개변수

• 옵션

  RemovalOptions

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

removePasswords()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

브라우저에 저장된 비밀번호를 삭제합니다.

매개변수

• 옵션

  RemovalOptions

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

removePluginData()

<ph type="x-smartling-placeholder"></ph> 프로미스 에서 확인하세요. Chrome 88 이후 지원 중단됨

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

플래시 지원이 중단되었습니다. 이 함수는 효과가 없습니다.

플러그인 삭제 데이터를 수집하는 데 사용됩니다

매개변수

• 옵션

  RemovalOptions

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

removeServiceWorkers()

<ph type="x-smartling-placeholder"></ph> 프로미스 Chrome 72 이상

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

웹사이트 삭제 서비스 워커를 지원합니다

매개변수

• 옵션

  RemovalOptions

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

removeWebSQL()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

웹사이트 삭제 WebSQL 데이터

매개변수

• 옵션

  RemovalOptions

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

settings()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

'인터넷 사용 기록 삭제'에서 현재 선택된 데이터 유형을 보고합니다. 설정 UI에 있습니다. 참고: 이 API에 포함된 데이터 유형 중 일부는 설정 UI에서 사용할 수 없으며, 일부 UI 설정은 여기에 나열된 두 개 이상의 데이터 유형을 제어합니다.

매개변수

• 콜백

  함수 선택사항

  callback 매개변수는 다음과 같습니다.

  (result: object) => void

  • 결과

    객체

    • dataRemovalPermitted

      DataTypeSet

      모든 유형이 결과에 표시되며, 삭제가 허용되는 경우 (예: 기업 정책에 의해) true, 허용되지 않는 경우 false의 값이 포함됩니다.

    • dataToRemove

      DataTypeSet

      모든 유형이 결과에 표시되며, 모두 삭제하도록 선택되고 삭제가 허용된 경우 true의 값이 있고, 그렇지 않은 경우에는 false입니다.

    • 옵션

      RemovalOptions

반환 값

• Promise&lt;object&gt;

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서 지원되지만 이전 버전과의 호환성입니다. 같은 함수 호출에서 두 가지를 모두 사용할 수는 없습니다. 이 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.