이 페이지는 Cloud Translation API를 통해 번역되었습니다.

chrome.browsingData

설명

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

권한

browsingData

매니페스트

'browsingData'를 선언해야 합니다. 확장 프로그램 매니페스트의 권한이 있어야 이 API를 사용할 수 있습니다.

{
  "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인 쿠키도 삭제합니다.

출처 유형

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

드림

주의: 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<object>

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

프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.