31 sierpnia 2026 r. usunęliśmy z Chrome Web Store rozszerzenia Manifest V2. Przenieś rozszerzenie na platformę Manifest V3, aby było znowu dostępne dla użytkowników.

Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

chrome.browsingData

refresh date: 2026-09-25 robots: noindex

Opis

Użyj interfejsu chrome.browsingData API, aby usunąć dane przeglądania z lokalnego profilu użytkownika.

Uprawnienia

browsingData

Plik manifestu

Aby korzystać z tego interfejsu API, musisz zadeklarować uprawnienie „browsingData” w pliku manifestu rozszerzenia.

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

Wykorzystanie

Najprostszym przypadkiem użycia tego interfejsu API jest mechanizm oparty na czasie, który służy do czyszczenia danych przeglądania użytkownika. Kod powinien zawierać sygnaturę czasową wskazującą datę historyczną, po której dane przeglądania użytkownika powinny zostać usunięte. Ta sygnatura czasowa jest sformatowana jako liczba milisekund od początku epoki uniksowej (którą można pobrać z obiektu JavaScript Date za pomocą metody getTime).

Aby na przykład wyczyścić wszystkie dane przeglądania użytkownika z ostatniego tygodnia, możesz napisać kod w ten sposób:

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

Metoda chrome.browsingData.remove umożliwia usunięcie różnych typów danych przeglądania za pomocą jednego wywołania i jest znacznie szybsza niż wywoływanie wielu bardziej szczegółowych metod. Jeśli jednak chcesz wyczyścić tylko określony typ danych przeglądania (np. pliki cookie), bardziej szczegółowe metody stanowią czytelną alternatywę dla wywołania wypełnionego kodem 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);

Jeśli użytkownik synchronizuje dane, chrome.browsingData.remove może automatycznie odbudować plik cookie na potrzeby konta synchronizacji po jego wyczyszczeniu. Dzięki temu synchronizacja będzie nadal działać, a dane będzie można ostatecznie usunąć z serwera. Bardziej szczegółowe polecenie chrome.browsingData.removeCookies może jednak służyć do usuwania plików cookie z konta synchronizacji, a synchronizacja zostanie w tym przypadku wstrzymana.

Określone pochodzenie

Aby usunąć dane z określonego źródła lub wykluczyć z usuwania zestaw źródeł, możesz użyć parametrów RemovalOptions.origins i RemovalOptions.excludeOrigins. Można je stosować tylko do plików cookie, pamięci podręcznej i pamięci (CacheStorage, FileSystems, IndexedDB, LocalStorage, ServiceWorkers i WebSQL).

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

Ważne: pliki cookie mają szerszy zakres niż inne typy pamięci, więc usunięcie plików cookie dla danej domeny spowoduje usunięcie wszystkich plików cookie domeny podlegającej rejestracji. Na przykład usunięcie danych z https://www.example.com spowoduje też usunięcie plików cookie z domeną .example.com.

Typy pochodzenia

Dodanie właściwości originTypes do obiektu opcji interfejsu API umożliwia określenie, których typów źródeł ma dotyczyć ta funkcja. Obecnie pochodzenia są podzielone na 3 kategorie:

unprotectedWeb obejmuje ogólny przypadek witryn, które użytkownicy odwiedzają bez podejmowania żadnych specjalnych działań. Jeśli nie określisz wartości originTypes, interfejs API domyślnie usunie dane z niechronionych źródeł internetowych.
protectedWeb obejmuje źródła internetowe, które zostały zainstalowane jako aplikacje hostowane. Na przykład zainstalowanie gry Angry Birds chroni źródło https://chrome.angrybirds.com i usuwa je z kategorii unprotectedWeb. Zachowaj ostrożność podczas wywoływania usuwania danych z tych źródeł: upewnij się, że użytkownicy wiedzą, co się stanie, ponieważ spowoduje to nieodwracalne usunięcie danych z gry. Nikt nie chce przewracać małych domków świnek częściej niż to konieczne.
extension obejmuje źródła w schemacie chrome-extensions:. Usuwanie danych rozszerzenia to czynność, którą należy wykonywać bardzo ostrożnie.

Poprzedni przykład możemy zmodyfikować tak, aby usuwać tylko dane z chronionych witryn:

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

Poważnie: uważaj na protectedWeb i extension. Są to operacje destrukcyjne, w przypadku których użytkownicy będą wysyłać e-maile z pretensjami, jeśli nie będą dobrze poinformowani o tym, czego mogą się spodziewać, gdy rozszerzenie usunie dane w ich imieniu.

Przykłady

Aby wypróbować ten interfejs API, zainstaluj przykład interfejsu browsingData API z repozytorium chrome-extension-samples.

Typy

DataTypeSet

Zbiór typów danych. Brakujące typy danych są interpretowane jako false.

Właściwości

appcache

wartość logiczna opcjonalna

Wycofane w Chrome 152

Usunęliśmy obsługę pamięci podręcznej aplikacji. Ten typ danych zostanie zignorowany.
pamięci podręczne aplikacji witryn,
Pamięć podręczna

wartość logiczna opcjonalna

pamięć podręczna przeglądarki;
cacheStorage

wartość logiczna opcjonalna

Chrome 72 lub nowsza

Pamięć podręczna
ciasteczka

wartość logiczna opcjonalna

pliki cookie przeglądarki;
pobrane

wartość logiczna opcjonalna

Lista pobierania w przeglądarce.
fileSystems

wartość logiczna opcjonalna

systemy plików witryn,
formData

wartość logiczna opcjonalna

Dane formularzy zapisane w przeglądarce.
historia

wartość logiczna opcjonalna

historia przeglądarki,
indexedDB

wartość logiczna opcjonalna

dane IndexedDB witryn,
localStorage

wartość logiczna opcjonalna

dane z pamięci lokalnej witryn,
hasła

wartość logiczna opcjonalna

Wycofane w Chrome 144

Usunęliśmy obsługę usuwania haseł za pomocą rozszerzeń. Ten typ danych zostanie zignorowany.
zapisane hasła,
pluginData

wartość logiczna opcjonalna

Wycofane w Chrome 88

Obsługa technologii Flash została usunięta. Ten typ danych zostanie zignorowany.
dane wtyczek,
serverBoundCertificates

wartość logiczna opcjonalna

Wycofane w Chrome 76

Obsługa certyfikatów powiązanych z serwerem została usunięta. Ten typ danych zostanie zignorowany.
Certyfikaty powiązane z serwerem.
serviceWorkers

wartość logiczna opcjonalna

Skrypty service worker.
webSQL

wartość logiczna opcjonalna

Wycofane w Chrome 152

Usługa WebSQL nie jest już obsługiwana. Ten typ danych zostanie zignorowany.
dane WebSQL witryn,

RemovalOptions

Opcje, które określają, jakie dane zostaną usunięte.

Właściwości

excludeOrigins

string[] opcjonalnie

Chrome 74 lub nowsza

Jeśli ta lista jest dostępna, dane dotyczące źródeł na niej wymienionych nie są usuwane. Nie można używać razem z urządzeniem origins. Obsługiwane tylko w przypadku plików cookie, pamięci i pamięci podręcznej. Pliki cookie są wykluczane w przypadku całej domeny, którą można zarejestrować.
originTypes

obiekt opcjonalny

Obiekt, którego właściwości określają, które typy pochodzenia powinny zostać wyczyszczone. Jeśli ten obiekt nie zostanie określony, domyślnie wyczyszczone zostaną tylko „niechronione” źródła. Zanim dodasz „protectedWeb” lub „extensions”, upewnij się, że na pewno chcesz usunąć dane aplikacji.
- rozszerzenie
  
  wartość logiczna opcjonalna
  
  rozszerzenia i aplikacje pakietowe zainstalowane przez użytkownika (zachowaj _szczególną_ ostrożność);
- protectedWeb
  
  wartość logiczna opcjonalna
  
  Witryny zainstalowane jako aplikacje hostowane (zachowaj ostrożność!).
- unprotectedWeb
  
  wartość logiczna opcjonalna
  
  zwykłe witryny,
pochodzenie,

[string, ...string[]] opcjonalnie

Chrome 74 lub nowsza

Jeśli jest obecna, usuwane są tylko dane dotyczące źródeł z tej listy. Obsługiwane tylko w przypadku plików cookie, pamięci i pamięci podręcznej. Pliki cookie są usuwane z całej domeny podlegającej rejestracji.
od

number opcjonalny

Usuń dane zgromadzone w tym dniu lub po nim (w milisekundach od początku epoki, dostępne za pomocą metody getTime obiektu JavaScript Date). Jeśli nie jest obecny, domyślnie przyjmuje wartość 0 (co spowoduje usunięcie wszystkich danych przeglądania).

Metody

remove()

Obietnica

chrome.browsingData.remove(
  options: RemovalOptions,
  dataToRemove: DataTypeSet,
  callback?: function,
): Promise<void>

Usuwa różne typy danych przeglądania przechowywane w profilu użytkownika.

Parametry

Opcje

RemovalOptions
dataToRemove

DataTypeSet

Zbiór typów danych do usunięcia.
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
() => void
```

Zwroty

Promise<void>

Chrome 96 lub nowsza

Zwraca wartość po zakończeniu usuwania.

Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

removeAppcache()

Promise Wycofano w Chrome 152

chrome.browsingData.removeAppcache(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Usunęliśmy obsługę pamięci podręcznej aplikacji. Ta funkcja nie ma żadnego wpływu.

Usuwa dane pamięci podręcznej aplikacji witryn.

Parametry

Opcje

RemovalOptions
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
() => void
```

Zwroty

Promise<void>

Chrome 96 lub nowsza

Zwraca wartość, gdy dane pamięci podręcznej aplikacji witryn zostaną wyczyszczone.

Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

removeCache()

Obietnica

chrome.browsingData.removeCache(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Czyści pamięć podręczną przeglądarki.

Parametry

Opcje

RemovalOptions
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
() => void
```

Zwroty

Promise<void>

Chrome 96 lub nowsza

Rozwiązuje się po wyczyszczeniu pamięci podręcznej przeglądarki.

Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

removeCacheStorage()

Promise Chrome 72 lub nowszy

chrome.browsingData.removeCacheStorage(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Usuwa dane z pamięci podręcznej witryn.

Parametry

Opcje

RemovalOptions
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
() => void
```

Zwroty

Promise<void>

Chrome 96 lub nowsza

Zostanie rozwiązany, gdy pamięć podręczna witryn zostanie wyczyszczona.

Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

removeCookies()

Obietnica

chrome.browsingData.removeCookies(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Usuwa pliki cookie przeglądarki i certyfikaty powiązane z serwerem, które zostały zmodyfikowane w określonym przedziale czasu.

Parametry

Opcje

RemovalOptions
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
() => void
```

Zwroty

Promise<void>

Chrome 96 lub nowsza

Rozwiązuje się, gdy pliki cookie przeglądarki i certyfikaty powiązane z serwerem zostaną wyczyszczone.

Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

removeDownloads()

Obietnica

chrome.browsingData.removeDownloads(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Czyści listę pobranych plików w przeglądarce (nie same pobrane pliki).

Parametry

Opcje

RemovalOptions
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
() => void
```

Zwroty

Promise<void>

Chrome 96 lub nowsza

Rozwiązuje problem, gdy lista pobranych plików w przeglądarce została wyczyszczona.

Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

removeFileSystems()

Obietnica

chrome.browsingData.removeFileSystems(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Usuwa dane systemu plików witryn.

Parametry

Opcje

RemovalOptions
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
() => void
```

Zwroty

Promise<void>

Chrome 96 lub nowsza

Rozwiązuje problem, gdy systemy plików witryn zostaną wyczyszczone.

Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

removeFormData()

Obietnica

chrome.browsingData.removeFormData(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Usuwa zapisane w przeglądarce dane formularzy (autouzupełnianie).

Parametry

Opcje

RemovalOptions
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
() => void
```

Zwroty

Promise<void>

Chrome 96 lub nowsza

Zwraca wartość, gdy dane formularza przeglądarki zostaną wyczyszczone.

Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

removeHistory()

Obietnica

chrome.browsingData.removeHistory(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Czyści historię przeglądarki.

Parametry

Opcje

RemovalOptions
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
() => void
```

Zwroty

Promise<void>

Chrome 96 lub nowsza

Zwraca wartość, gdy historia przeglądarki zostanie wyczyszczona.

Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

removeIndexedDB()

Obietnica

chrome.browsingData.removeIndexedDB(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Usuwa dane IndexedDB witryn.

Parametry

Opcje

RemovalOptions
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
() => void
```

Zwroty

Promise<void>

Chrome 96 lub nowsza

Zwraca wartość, gdy dane IndexedDB witryn zostaną wyczyszczone.

Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

removeLocalStorage()

Obietnica

chrome.browsingData.removeLocalStorage(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Usuwa dane z pamięci lokalnej witryn.

Parametry

Opcje

RemovalOptions
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
() => void
```

Zwroty

Promise<void>

Chrome 96 lub nowsza

Zwraca wartość, gdy pamięć lokalna witryn zostanie wyczyszczona.

Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

removePasswords()

Promise Wycofano w Chrome 144

chrome.browsingData.removePasswords(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Usunęliśmy obsługę usuwania haseł za pomocą rozszerzeń. Ta funkcja nie ma żadnego wpływu.

Usuwa zapisane hasła z przeglądarki.

Parametry

Opcje

RemovalOptions
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
() => void
```

Zwroty

Promise<void>

Chrome 96 lub nowsza

Zwraca wartość, gdy hasła w przeglądarce zostaną wyczyszczone.

Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

removePluginData()

Promise Wycofana w Chrome 88

chrome.browsingData.removePluginData(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Obsługa technologii Flash została usunięta. Ta funkcja nie ma żadnego wpływu.

Usuwa dane wtyczek.

Parametry

Opcje

RemovalOptions
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
() => void
```

Zwroty

Promise<void>

Chrome 96 lub nowsza

Zwraca wartość, gdy dane wtyczek zostaną wyczyszczone.

Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

removeServiceWorkers()

Promise Chrome 72 lub nowszy

chrome.browsingData.removeServiceWorkers(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Usuwa service workerów witryn.

Parametry

Opcje

RemovalOptions
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
() => void
```

Zwroty

Promise<void>

Chrome 96 lub nowsza

Rozwiązuje problem, gdy pracownicy usług witryn zostali wyczyszczeni.

Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

removeWebSQL()

Promise Wycofano w Chrome 152

chrome.browsingData.removeWebSQL(
  options: RemovalOptions,
  callback?: function,
): Promise<void>

Usługa WebSQL nie jest już obsługiwana. Ta funkcja nie ma żadnego wpływu.

Usuwa dane WebSQL witryn.

Parametry

Opcje

RemovalOptions
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
() => void
```

Zwroty

Promise<void>

Chrome 96 lub nowsza

Zwraca wartość, gdy bazy danych WebSQL witryn zostaną wyczyszczone.

Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

settings()

Obietnica

chrome.browsingData.settings(
  callback?: function,
): Promise<object>

Raportuje, jakie typy danych są obecnie wybrane w interfejsie ustawień „Wyczyść dane przeglądania”. Uwaga: niektóre typy danych uwzględnione w tym interfejsie API nie są dostępne w interfejsie ustawień, a niektóre ustawienia interfejsu użytkownika kontrolują więcej niż 1 typ danych wymieniony tutaj.

Parametry

callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
(result: object) => void
```
- wynik
  
  obiekt
  - dataRemovalPermitted
    
    DataTypeSet
    
    Wszystkie typy będą obecne w wyniku.Jeśli można je usunąć (np. zgodnie z zasadami przedsiębiorstwa), będą miały wartość true, a jeśli nie – false.
  - dataToRemove
    
    DataTypeSet
    
    W wyniku będą obecne wszystkie typy. Jeśli oba typy są wybrane do usunięcia i można je usunąć, będą miały wartość true, a w przeciwnym razie – false.
  - Opcje
    
    RemovalOptions

Zwroty

Promise<object>

Chrome 96 lub nowsza

Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

chrome.browsingData Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Opis

Uprawnienia

Plik manifestu

Wykorzystanie

Określone pochodzenie

Typy pochodzenia

Przykłady

Typy

DataTypeSet

Właściwości

RemovalOptions

Właściwości

Metody

remove()

Parametry

Zwroty

removeAppcache()

Parametry

Zwroty

removeCache()

Parametry

Zwroty

removeCacheStorage()

Parametry

Zwroty

removeCookies()

Parametry

Zwroty

removeDownloads()

Parametry

Zwroty

removeFileSystems()

Parametry

Zwroty

removeFormData()

Parametry

Zwroty

removeHistory()

Parametry

Zwroty

removeIndexedDB()

Parametry

Zwroty

removeLocalStorage()

Parametry

Zwroty

removePasswords()

Parametry

Zwroty

removePluginData()

Parametry

Zwroty

removeServiceWorkers()

Parametry

Zwroty

removeWebSQL()

Parametry

Zwroty

settings()

Parametry

Zwroty

chrome.browsingData